@nextcloud/l10n - npm Package Versions

3.2.0 - 2025-02-13

ℹ️ Notes

The GettextBuilder.detectLocale method is deprecated and will be removed in the next major version. It is replaced with the detectLanguage method to make the method naming more consistent.

Added

• feat(date): fallback to Intl #831 (ShGKme)
• feat(gettext): Add detectLanguage method and deprecate detectLocale #850 (susnux)
• feat: Overload translate function to either allow number or placeholder as third arg #854 (susnux)

Fixed

• fix(types): type translation variable keys #807 (ShGKme)
• fix(isRTL): Correctly handle Urdu and Uzbek Afghan #855 (susnux)
• fix(registry): Prevent prototype polluting #860 (susnux)

Changed

• refactor(gettext): Drop node-gettext dependency and use our translation logic #851 (susnux)
• license: Add SPDX header #781 (AndyScherzinger)
• chore: Add missing trailing comma in vite config #852 (susnux)
• docs: Clarify readme about Nextcloud provided and custom translations #853 (susnux)
• docs: improve return type of getFirstDay() #784 (st3iny)
• docs: replace missing exports plugin to also document internal types #846 (susnux)
• ci: Update from org #795 (AndyScherzinger)
• ci: Update workflows from organization #847 (susnux)
• chore(deps): Bump dompurify and @types/dompurify
• chore(dev-deps): Update development dependencies

3.1.0 - 2024-05-07

Added

• Allow setting escape option per parameter replacing.
  For more security this should be used instead of disabling paramter escaping, see pull request #756

  // Example
  t(
  	'my-app',
  	'{a}{userInput}{a_end}',
  	{
  		a: {
  			value: '<a>',
  			escape: false,
  		},
  		userInput: somePossiblyInsecureValue, // This will be escaped
  		a_end: {
  			value: '</a>',
  			escape: false,
  		}
  	},
  )
  

3.0.1 - 2024-05-04

Fixed

• Ensure that built type definitions are bundled with the release and located in the correct directory

3.0.0 - 2024-05-02

Full Changelog

Breaking changes

Instead of also sanitizing the replacing variables, now only the result is sanitized, see pull request #648.

This will improve the performance if multiple placeholders are used and it allows this, while the string is still sanitized:

t(
	'See {linkstart}documentation{linkend}',
	{
		linkstart: '<a ...>',
		linkend: '</a>',
	},
	// No number
	undefined,
	{
		// Do not escape the result as we want the HTML anchor element
		escape: false,
	}
)

Added

• feat: export aliases t and n for translate and translatePlural

Fixed

• fix!: Only sanitize the result string when replacing variables

Changed

• Update NPM to latest LTS v10
• Migrate to vite for transpiling and vitest for testing
• chore: Added more tests for special cases on plural forms
• chore(deps): Bump tough-cookie to 4.1.3
• chore(deps): Bump postcss to 8.4.31
• chore(deps): Bump @nextcloud/typings to 1.8.0
• chore(deps): Bump dompurify to 3.1.1
• chore(deps): Bump @nextcloud/router to 3.0.1

2.2.0 - 2023-06-26

Full Changelog

Added

• isRTL was added to check whether a given, or the current, language is read right-to-left #639 (susnux)

Fixed

• Add typings to the package exports to fix build for Typescript projects using node16 or nodenext module resolution #633 (susnux)
• Update exported NextcloudWindowWithRegistry type for Nextcloud 27 #640 (susnux)
• Harden loadTranslations by handling edge cases where invalid data is retrieved #644 (susnux)

Changed

• Update node engines to next LTS (Node 20 + NPM 9)
• Dependency updates

2.1.0 - 2023-02-25

Full Changelog

Added

• unregister is now part of the public API #579 (susnux)

Fixed

• Export the Translations type and add missing documentation #566 (susnux)
• Fix singular translation in edge cases where plural strings are provided #570 (susnux)
• Make loading translations use async XMLHttpRequest #571 (susnux)
• Removed warning "no app translation was registered" #572 (ShGKme)

Changed

• Added tests and increased code coverage
• Dependency updates

2.0.1 - 2023-01-19

Full Changelog

Fixed

• fix(config): fix npmignore config #563 (skjnldsv)
• fix(config): fix tsconfig out dir typings #562 (skjnldsv)
• Fix standalone registration #556 (ShGKme)

Changed

• Dependency updates

2.0.0 - 2023-01-12

Full Changelog

Changed

From 2.0.0, this package is standalone and do not rely on window OC variables to function.

Fixed

• Provide all translation related functions #542 (susnux)
• Fix building and deploying documentation #546 (susnux)

1.6.0 - 2022-05-10

Changed

• Dependency updates
• Remove dependency on OC for getLocale and getLanguage