@kanso-protocol/i18n 0.1.0

package/fesm2022/kanso-protocol-i18n.mjs

@@ -0,0 +1,166 @@
+import { InjectionToken, inject } from '@angular/core';
+
+/**
+ * BCP-47 locale tag used by every Kanso component that calls into Intl
+ * APIs (date / time / number formatting, weekday names, etc.).
+ *
+ * Default factory pulls from `navigator.language` if available, else
+ * falls back to `'en-US'`. Override at the app root:
+ *
+ *   providers: [{ provide: KP_LOCALE, useValue: 'fr-FR' }]
+ *
+ * Or per-feature via a child injector. Components inject this lazily —
+ * changing it at runtime requires re-rendering the affected components.
+ */
+const KP_LOCALE = new InjectionToken('KP_LOCALE', {
+    factory: () => typeof navigator !== 'undefined' && navigator.language
+        ? navigator.language
+        : 'en-US',
+});
+/**
+ * Built-in English strings. Components that read these go through
+ * `injectKpStrings()` so consumers can override per-app or per-locale.
+ */
+const KP_DEFAULT_STRINGS_EN = {
+    close: 'Close',
+    clear: 'Clear',
+    cancel: 'Cancel',
+    confirm: 'Confirm',
+    loading: 'Loading…',
+    noResults: 'No results found',
+    today: 'Today',
+    yesterday: 'Yesterday',
+    thisWeek: 'This week',
+    lastWeek: 'Last week',
+    thisMonth: 'This month',
+    lastMonth: 'Last month',
+    selectDate: 'Select date',
+    selectTime: 'Select time',
+    previousMonth: 'Previous month',
+    nextMonth: 'Next month',
+    dropzoneTitle: 'Drop files here or click to browse',
+    dropzoneRemove: (filename) => `Remove ${filename}`,
+    dropzoneUploaded: 'Uploaded',
+    searchPlaceholder: 'Search…',
+    commandPaletteHint: '⌘K',
+    commandPalettePlaceholder: 'Type a command or search…',
+};
+/**
+ * App-level override token. Provide a `Partial<KpLocaleStrings>` —
+ * unspecified keys fall through to the English defaults.
+ *
+ *   providers: [{
+ *     provide: KP_STRINGS,
+ *     useValue: {
+ *       close: 'Закрыть',
+ *       today: 'Сегодня',
+ *       commandPalettePlaceholder: 'Команда или поиск…',
+ *     },
+ *   }]
+ */
+const KP_STRINGS = new InjectionToken('KP_STRINGS', { factory: () => ({}) });
+/**
+ * Resolve the merged strings dictionary inside a component / directive
+ * factory. Reads both the override token and the defaults; consumers
+ * never have to remember to merge.
+ */
+function injectKpStrings() {
+    const overrides = inject(KP_STRINGS);
+    return { ...KP_DEFAULT_STRINGS_EN, ...overrides };
+}
+/** Convenience accessor with the same lifecycle constraints as `inject(KP_LOCALE)`. */
+function injectKpLocale() {
+    return inject(KP_LOCALE);
+}
+
+/**
+ * Thin wrappers over `Intl.DateTimeFormat` so components that take
+ * `KP_LOCALE` don't have to repeat the `new Intl.DateTimeFormat(...)`
+ * dance. Each helper caches the formatter per (locale, options) — the
+ * cache is keyed on a JSON-stringified options object since `Intl`
+ * options are small and structurally compared.
+ */
+const CACHE = new Map();
+function getFormatter(locale, options) {
+    const key = `${locale}::${JSON.stringify(options)}`;
+    let f = CACHE.get(key);
+    if (!f) {
+        f = new Intl.DateTimeFormat(locale, options);
+        CACHE.set(key, f);
+    }
+    return f;
+}
+/**
+ * Format a date in the consumer's locale.
+ *
+ *   kpFormatDate(d, 'fr-FR', { dateStyle: 'medium' })  // "5 mai 2026"
+ */
+function kpFormatDate(date, locale, options = { dateStyle: 'medium' }) {
+    return getFormatter(locale, options).format(date);
+}
+/**
+ * Format the time portion of a date.
+ *
+ *   kpFormatTime(d, 'en-US', { hour: 'numeric', minute: '2-digit' })  // "3:45 PM"
+ *   kpFormatTime(d, 'de-DE')                                          // "15:45"
+ */
+function kpFormatTime(date, locale, options = { timeStyle: 'short' }) {
+    return getFormatter(locale, options).format(date);
+}
+/**
+ * Localized month names. Reuses a single formatter; the calendar
+ * components walk all 12 months once on render.
+ *
+ *   kpMonthNames('en-US', 'long')   // ['January', 'February', ...]
+ *   kpMonthNames('ru-RU', 'short')  // ['янв.', 'февр.', ...]
+ */
+function kpMonthNames(locale, format = 'long') {
+    const fmt = getFormatter(locale, { month: format });
+    const out = [];
+    // Use day=1 of each month at year=2000 (safe — no month has fewer than 1 day,
+    // year is well after epoch + DST offsets don't shift the month).
+    for (let m = 0; m < 12; m++)
+        out.push(fmt.format(new Date(2000, m, 1)));
+    return out;
+}
+/**
+ * Localized weekday short labels in display order, starting from
+ * `firstDayOfWeek` (0 = Sunday, 1 = Monday).
+ *
+ *   kpWeekdayNames('en-US', 1, 'narrow')  // ['M', 'T', 'W', 'T', 'F', 'S', 'S']
+ *   kpWeekdayNames('en-US', 1, 'short')   // ['Mon', 'Tue', ...]
+ */
+function kpWeekdayNames(locale, firstDayOfWeek = 1, format = 'short') {
+    const fmt = getFormatter(locale, { weekday: format });
+    // Pick a reference week starting on Sunday 2017-01-01 (Sunday = 0).
+    const out = [];
+    for (let i = 0; i < 7; i++) {
+        const d = new Date(2017, 0, 1 + i);
+        out.push(fmt.format(d));
+    }
+    if (firstDayOfWeek === 1) {
+        return [...out.slice(1), out[0]];
+    }
+    return out;
+}
+/**
+ * AM/PM marker for a given hour in the consumer's locale, or empty
+ * string if the locale uses 24h format (most of the world).
+ *
+ *   kpDayPeriod(15, 'en-US') // 'PM'
+ *   kpDayPeriod(15, 'de-DE') // ''
+ */
+function kpDayPeriod(hour, locale) {
+    const fmt = getFormatter(locale, { hour: 'numeric', hour12: true });
+    // Format "3 PM" → match trailing letters
+    const formatted = fmt.format(new Date(2000, 0, 1, hour));
+    const m = formatted.match(/[A-Za-zА-Яа-я]+\.?$/);
+    return m ? m[0] : '';
+}
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { KP_DEFAULT_STRINGS_EN, KP_LOCALE, KP_STRINGS, injectKpLocale, injectKpStrings, kpDayPeriod, kpFormatDate, kpFormatTime, kpMonthNames, kpWeekdayNames };
+//# sourceMappingURL=kanso-protocol-i18n.mjs.map

package/fesm2022/kanso-protocol-i18n.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"kanso-protocol-i18n.mjs","sources":["../../../../packages/i18n/src/tokens.ts","../../../../packages/i18n/src/intl.ts","../../../../packages/i18n/src/kanso-protocol-i18n.ts"],"sourcesContent":["import { InjectionToken, inject } from '@angular/core';\n\n/**\n * BCP-47 locale tag used by every Kanso component that calls into Intl\n * APIs (date / time / number formatting, weekday names, etc.).\n *\n * Default factory pulls from `navigator.language` if available, else\n * falls back to `'en-US'`. Override at the app root:\n *\n *   providers: [{ provide: KP_LOCALE, useValue: 'fr-FR' }]\n *\n * Or per-feature via a child injector. Components inject this lazily —\n * changing it at runtime requires re-rendering the affected components.\n */\nexport const KP_LOCALE = new InjectionToken<string>('KP_LOCALE', {\n  factory: () =>\n    typeof navigator !== 'undefined' && navigator.language\n      ? navigator.language\n      : 'en-US',\n});\n\n/**\n * Static UI strings that don't have an Intl equivalent — labels, ARIA\n * fallbacks, button text. Anything that DOES have an Intl form (month\n * names, day-period markers, time formats) is derived from `KP_LOCALE`\n * via the helpers in `intl.ts` instead of being listed here.\n *\n * Add a key here only after you've confirmed it's not derivable from\n * Intl. The goal is a small registry — large registries rot fast.\n */\nexport interface KpLocaleStrings {\n  // Generic chrome\n  close: string;\n  clear: string;\n  cancel: string;\n  confirm: string;\n  loading: string;\n  noResults: string;\n\n  // Date / time pickers — buttons + presets\n  today: string;\n  yesterday: string;\n  thisWeek: string;\n  lastWeek: string;\n  thisMonth: string;\n  lastMonth: string;\n  selectDate: string;\n  selectTime: string;\n  previousMonth: string;\n  nextMonth: string;\n\n  // File upload\n  dropzoneTitle: string;\n  dropzoneRemove: (filename: string) => string;\n  dropzoneUploaded: string;\n\n  // Search / command palette\n  searchPlaceholder: string;\n  commandPaletteHint: string;\n  commandPalettePlaceholder: string;\n}\n\n/**\n * Built-in English strings. Components that read these go through\n * `injectKpStrings()` so consumers can override per-app or per-locale.\n */\nexport const KP_DEFAULT_STRINGS_EN: KpLocaleStrings = {\n  close: 'Close',\n  clear: 'Clear',\n  cancel: 'Cancel',\n  confirm: 'Confirm',\n  loading: 'Loading…',\n  noResults: 'No results found',\n\n  today: 'Today',\n  yesterday: 'Yesterday',\n  thisWeek: 'This week',\n  lastWeek: 'Last week',\n  thisMonth: 'This month',\n  lastMonth: 'Last month',\n  selectDate: 'Select date',\n  selectTime: 'Select time',\n  previousMonth: 'Previous month',\n  nextMonth: 'Next month',\n\n  dropzoneTitle: 'Drop files here or click to browse',\n  dropzoneRemove: (filename) => `Remove ${filename}`,\n  dropzoneUploaded: 'Uploaded',\n\n  searchPlaceholder: 'Search…',\n  commandPaletteHint: '⌘K',\n  commandPalettePlaceholder: 'Type a command or search…',\n};\n\n/**\n * App-level override token. Provide a `Partial<KpLocaleStrings>` —\n * unspecified keys fall through to the English defaults.\n *\n *   providers: [{\n *     provide: KP_STRINGS,\n *     useValue: {\n *       close: 'Закрыть',\n *       today: 'Сегодня',\n *       commandPalettePlaceholder: 'Команда или поиск…',\n *     },\n *   }]\n */\nexport const KP_STRINGS = new InjectionToken<Partial<KpLocaleStrings>>(\n  'KP_STRINGS',\n  { factory: () => ({}) },\n);\n\n/**\n * Resolve the merged strings dictionary inside a component / directive\n * factory. Reads both the override token and the defaults; consumers\n * never have to remember to merge.\n */\nexport function injectKpStrings(): KpLocaleStrings {\n  const overrides = inject(KP_STRINGS);\n  return { ...KP_DEFAULT_STRINGS_EN, ...overrides };\n}\n\n/** Convenience accessor with the same lifecycle constraints as `inject(KP_LOCALE)`. */\nexport function injectKpLocale(): string {\n  return inject(KP_LOCALE);\n}\n","/**\n * Thin wrappers over `Intl.DateTimeFormat` so components that take\n * `KP_LOCALE` don't have to repeat the `new Intl.DateTimeFormat(...)`\n * dance. Each helper caches the formatter per (locale, options) — the\n * cache is keyed on a JSON-stringified options object since `Intl`\n * options are small and structurally compared.\n */\n\nconst CACHE = new Map<string, Intl.DateTimeFormat>();\n\nfunction getFormatter(locale: string, options: Intl.DateTimeFormatOptions): Intl.DateTimeFormat {\n  const key = `${locale}::${JSON.stringify(options)}`;\n  let f = CACHE.get(key);\n  if (!f) {\n    f = new Intl.DateTimeFormat(locale, options);\n    CACHE.set(key, f);\n  }\n  return f;\n}\n\n/**\n * Format a date in the consumer's locale.\n *\n *   kpFormatDate(d, 'fr-FR', { dateStyle: 'medium' })  // \"5 mai 2026\"\n */\nexport function kpFormatDate(\n  date: Date,\n  locale: string,\n  options: Intl.DateTimeFormatOptions = { dateStyle: 'medium' },\n): string {\n  return getFormatter(locale, options).format(date);\n}\n\n/**\n * Format the time portion of a date.\n *\n *   kpFormatTime(d, 'en-US', { hour: 'numeric', minute: '2-digit' })  // \"3:45 PM\"\n *   kpFormatTime(d, 'de-DE')                                          // \"15:45\"\n */\nexport function kpFormatTime(\n  date: Date,\n  locale: string,\n  options: Intl.DateTimeFormatOptions = { timeStyle: 'short' },\n): string {\n  return getFormatter(locale, options).format(date);\n}\n\n/**\n * Localized month names. Reuses a single formatter; the calendar\n * components walk all 12 months once on render.\n *\n *   kpMonthNames('en-US', 'long')   // ['January', 'February', ...]\n *   kpMonthNames('ru-RU', 'short')  // ['янв.', 'февр.', ...]\n */\nexport function kpMonthNames(\n  locale: string,\n  format: 'long' | 'short' | 'narrow' = 'long',\n): string[] {\n  const fmt = getFormatter(locale, { month: format });\n  const out: string[] = [];\n  // Use day=1 of each month at year=2000 (safe — no month has fewer than 1 day,\n  // year is well after epoch + DST offsets don't shift the month).\n  for (let m = 0; m < 12; m++) out.push(fmt.format(new Date(2000, m, 1)));\n  return out;\n}\n\n/**\n * Localized weekday short labels in display order, starting from\n * `firstDayOfWeek` (0 = Sunday, 1 = Monday).\n *\n *   kpWeekdayNames('en-US', 1, 'narrow')  // ['M', 'T', 'W', 'T', 'F', 'S', 'S']\n *   kpWeekdayNames('en-US', 1, 'short')   // ['Mon', 'Tue', ...]\n */\nexport function kpWeekdayNames(\n  locale: string,\n  firstDayOfWeek: 0 | 1 = 1,\n  format: 'long' | 'short' | 'narrow' = 'short',\n): string[] {\n  const fmt = getFormatter(locale, { weekday: format });\n  // Pick a reference week starting on Sunday 2017-01-01 (Sunday = 0).\n  const out: string[] = [];\n  for (let i = 0; i < 7; i++) {\n    const d = new Date(2017, 0, 1 + i);\n    out.push(fmt.format(d));\n  }\n  if (firstDayOfWeek === 1) {\n    return [...out.slice(1), out[0]];\n  }\n  return out;\n}\n\n/**\n * AM/PM marker for a given hour in the consumer's locale, or empty\n * string if the locale uses 24h format (most of the world).\n *\n *   kpDayPeriod(15, 'en-US') // 'PM'\n *   kpDayPeriod(15, 'de-DE') // ''\n */\nexport function kpDayPeriod(hour: number, locale: string): string {\n  const fmt = getFormatter(locale, { hour: 'numeric', hour12: true });\n  // Format \"3 PM\" → match trailing letters\n  const formatted = fmt.format(new Date(2000, 0, 1, hour));\n  const m = formatted.match(/[A-Za-zА-Яа-я]+\\.?$/);\n  return m ? m[0] : '';\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@kanso-protocol/i18n",
+  "version": "0.1.0",
+  "license": "MIT",
+  "peerDependencies": {
+    "@angular/core": "^18.0.0"
+  },
+  "description": "Kanso Protocol — i18n primitives (locale token + string registry + Intl helpers).",
+  "author": "GregNBlack",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/GregNBlack/kanso-protocol.git",
+    "directory": "packages/i18n"
+  },
+  "homepage": "https://gregnblack.github.io/kanso-protocol",
+  "bugs": "https://github.com/GregNBlack/kanso-protocol/issues",
+  "keywords": [
+    "design-system",
+    "angular",
+    "kanso",
+    "i18n",
+    "localization"
+  ],
+  "sideEffects": false,
+  "module": "fesm2022/kanso-protocol-i18n.mjs",
+  "typings": "types/kanso-protocol-i18n.d.ts",
+  "exports": {
+    "./package.json": {
+      "default": "./package.json"
+    },
+    ".": {
+      "types": "./types/kanso-protocol-i18n.d.ts",
+      "default": "./fesm2022/kanso-protocol-i18n.mjs"
+    }
+  },
+  "type": "module",
+  "dependencies": {
+    "tslib": "^2.3.0"
+  }
+}

package/types/kanso-protocol-i18n.d.ts

@@ -0,0 +1,123 @@
+import { InjectionToken } from '@angular/core';
+
+/**
+ * BCP-47 locale tag used by every Kanso component that calls into Intl
+ * APIs (date / time / number formatting, weekday names, etc.).
+ *
+ * Default factory pulls from `navigator.language` if available, else
+ * falls back to `'en-US'`. Override at the app root:
+ *
+ *   providers: [{ provide: KP_LOCALE, useValue: 'fr-FR' }]
+ *
+ * Or per-feature via a child injector. Components inject this lazily —
+ * changing it at runtime requires re-rendering the affected components.
+ */
+declare const KP_LOCALE: InjectionToken<string>;
+/**
+ * Static UI strings that don't have an Intl equivalent — labels, ARIA
+ * fallbacks, button text. Anything that DOES have an Intl form (month
+ * names, day-period markers, time formats) is derived from `KP_LOCALE`
+ * via the helpers in `intl.ts` instead of being listed here.
+ *
+ * Add a key here only after you've confirmed it's not derivable from
+ * Intl. The goal is a small registry — large registries rot fast.
+ */
+interface KpLocaleStrings {
+    close: string;
+    clear: string;
+    cancel: string;
+    confirm: string;
+    loading: string;
+    noResults: string;
+    today: string;
+    yesterday: string;
+    thisWeek: string;
+    lastWeek: string;
+    thisMonth: string;
+    lastMonth: string;
+    selectDate: string;
+    selectTime: string;
+    previousMonth: string;
+    nextMonth: string;
+    dropzoneTitle: string;
+    dropzoneRemove: (filename: string) => string;
+    dropzoneUploaded: string;
+    searchPlaceholder: string;
+    commandPaletteHint: string;
+    commandPalettePlaceholder: string;
+}
+/**
+ * Built-in English strings. Components that read these go through
+ * `injectKpStrings()` so consumers can override per-app or per-locale.
+ */
+declare const KP_DEFAULT_STRINGS_EN: KpLocaleStrings;
+/**
+ * App-level override token. Provide a `Partial<KpLocaleStrings>` —
+ * unspecified keys fall through to the English defaults.
+ *
+ *   providers: [{
+ *     provide: KP_STRINGS,
+ *     useValue: {
+ *       close: 'Закрыть',
+ *       today: 'Сегодня',
+ *       commandPalettePlaceholder: 'Команда или поиск…',
+ *     },
+ *   }]
+ */
+declare const KP_STRINGS: InjectionToken<Partial<KpLocaleStrings>>;
+/**
+ * Resolve the merged strings dictionary inside a component / directive
+ * factory. Reads both the override token and the defaults; consumers
+ * never have to remember to merge.
+ */
+declare function injectKpStrings(): KpLocaleStrings;
+/** Convenience accessor with the same lifecycle constraints as `inject(KP_LOCALE)`. */
+declare function injectKpLocale(): string;
+
+/**
+ * Thin wrappers over `Intl.DateTimeFormat` so components that take
+ * `KP_LOCALE` don't have to repeat the `new Intl.DateTimeFormat(...)`
+ * dance. Each helper caches the formatter per (locale, options) — the
+ * cache is keyed on a JSON-stringified options object since `Intl`
+ * options are small and structurally compared.
+ */
+/**
+ * Format a date in the consumer's locale.
+ *
+ *   kpFormatDate(d, 'fr-FR', { dateStyle: 'medium' })  // "5 mai 2026"
+ */
+declare function kpFormatDate(date: Date, locale: string, options?: Intl.DateTimeFormatOptions): string;
+/**
+ * Format the time portion of a date.
+ *
+ *   kpFormatTime(d, 'en-US', { hour: 'numeric', minute: '2-digit' })  // "3:45 PM"
+ *   kpFormatTime(d, 'de-DE')                                          // "15:45"
+ */
+declare function kpFormatTime(date: Date, locale: string, options?: Intl.DateTimeFormatOptions): string;
+/**
+ * Localized month names. Reuses a single formatter; the calendar
+ * components walk all 12 months once on render.
+ *
+ *   kpMonthNames('en-US', 'long')   // ['January', 'February', ...]
+ *   kpMonthNames('ru-RU', 'short')  // ['янв.', 'февр.', ...]
+ */
+declare function kpMonthNames(locale: string, format?: 'long' | 'short' | 'narrow'): string[];
+/**
+ * Localized weekday short labels in display order, starting from
+ * `firstDayOfWeek` (0 = Sunday, 1 = Monday).
+ *
+ *   kpWeekdayNames('en-US', 1, 'narrow')  // ['M', 'T', 'W', 'T', 'F', 'S', 'S']
+ *   kpWeekdayNames('en-US', 1, 'short')   // ['Mon', 'Tue', ...]
+ */
+declare function kpWeekdayNames(locale: string, firstDayOfWeek?: 0 | 1, format?: 'long' | 'short' | 'narrow'): string[];
+/**
+ * AM/PM marker for a given hour in the consumer's locale, or empty
+ * string if the locale uses 24h format (most of the world).
+ *
+ *   kpDayPeriod(15, 'en-US') // 'PM'
+ *   kpDayPeriod(15, 'de-DE') // ''
+ */
+declare function kpDayPeriod(hour: number, locale: string): string;
+
+export { KP_DEFAULT_STRINGS_EN, KP_LOCALE, KP_STRINGS, injectKpLocale, injectKpStrings, kpDayPeriod, kpFormatDate, kpFormatTime, kpMonthNames, kpWeekdayNames };
+export type { KpLocaleStrings };