impact-ui 4.0.1-alpha.21 → 4.0.1-alpha.22

package/dist/components/index.js

@@ -53,11 +53,13 @@ import { Select } from "./Select/index.js";
 import { MonthPicker } from "./MonthPicker/index.js";
 import { MonthRangePicker } from "./MonthRangePicker/index.js";
 import { KeyboardShortcuts } from "./KeyboardShortCuts/index.js";
+import { AGLocaleMap, BASE_LOCALE, LOCALE_REGISTRY, ourDictionaries } from "../locales/index.js";
 import { AppliedFilters } from "./FiltersStrip/AppliedFilters.js";
 import { CommentsContext, CommentsProvider, useComments } from "./CommentsPanel/CommentsContext.js";
 import { FilterDropDown } from "./FiltersStrip/FilterDropDown.js";
 import { FilterPanelHeader } from "./FilterPanel/FilterPanelHeader.js";
 import { FilterSlider } from "./FiltersStrip/FilterSlider.js";
+import { I18nContext, I18nProvider } from "../i18n/I18nContext.js";
 import { MenuHeaderInfo } from "./Menu/MenuHeaderInfo.js";
 import { PanelFooter } from "./FilterPanel/PanelFooter.js";
 import { PanelSidebar } from "./FilterPanel/PanelSidebar.js";
@@ -67,18 +69,24 @@ import { ShortcutModal } from "./KeyboardShortCuts/ShortcutModal.js";
 import { ShortcutScope } from "./Shortcuts/ShortcutScope.js";
 import { ShortcutsConfigContext } from "./Shortcuts/ShortcutsConfigContext.js";
 import { ShortcutsProvider } from "./Shortcuts/ShortcutsProvider.js";
+import { buildMessages, translate } from "../i18n/translate.js";
+import { default as default3 } from "../locales/en-US.json.js";
 import { formatShortcutDisplay } from "../utils/shortcuts/format.js";
 import { isMac } from "../utils/shortcuts/platform.js";
 import { normalizeKey } from "../utils/shortcuts/match.js";
 import { normalizeShortcutString, parseShortcutString } from "../utils/shortcuts/parse.js";
+import { useI18n } from "../i18n/useI18n.js";
 import { useShortcut } from "./Shortcuts/useShortcut.js";
 import { useShortcutScope } from "./Shortcuts/useShortcutScope.js";
+import { useTranslation } from "../i18n/useTranslation.js";
 export {
+  AGLocaleMap,
   Accordion,
   AccordionModern,
   Alert,
   AppliedFilters,
   Avatar,
+  BASE_LOCALE,
   Badge,
   BottomSheet,
   Breadcrumbs,
@@ -107,8 +115,11 @@ export {
   Header,
   HelperText,
   HomePage,
+  I18nContext,
+  I18nProvider,
   Input,
   KeyboardShortcuts,
+  LOCALE_REGISTRY,
   Loader,
   Menu,
   MenuHeaderInfo,
@@ -144,13 +155,19 @@ export {
   TextArea,
   Toast,
   Tooltip,
+  buildMessages,
+  default3 as enUS,
   formatShortcutDisplay,
   getAssetUrl,
   isMac,
   normalizeKey,
   normalizeShortcutString,
+  ourDictionaries,
   parseShortcutString,
+  translate,
   useComments,
+  useI18n,
   useShortcut,
-  useShortcutScope
+  useShortcutScope,
+  useTranslation
 };

package/dist/i18n/I18nContext.d.ts

@@ -0,0 +1,23 @@
+import { ReactNode } from 'react';
+import { I18nContextValue, Locale, LoadMessages } from './types';
+
+/**
+ * Context shape:
+ *   locale     - current active locale string (e.g. "en-US")
+ *   messages   - resolved 3-layer message map for the active locale
+ *   loading    - true while a locale switch is resolving loadMessages()
+ *   setLocale  - async (code) => void; switches the active locale
+ *   t          - (key, vars) => string; translation lookup + interpolation
+ */
+export declare const I18nContext: import('react').Context<I18nContextValue | null>;
+export interface I18nProviderProps {
+    /** initial active locale */
+    defaultLocale?: Locale;
+    /** (code) => messages | Promise<messages>; host overrides / extra languages */
+    loadMessages?: LoadMessages;
+    /** when true, `t()` returns the raw message key instead of the translation */
+    debugKeys?: boolean;
+    children: ReactNode;
+}
+export declare function I18nProvider({ defaultLocale, loadMessages, debugKeys, children, }: I18nProviderProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=I18nContext.d.ts.map

package/dist/i18n/I18nContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"I18nContext.d.ts","sourceRoot":"","sources":["../../src/i18n/I18nContext.tsx"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAEf,OAAO,uBAAuB,CAAC;AAI/B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,EAAE,YAAY,EAA2B,MAAM,SAAS,CAAC;AAE/F;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW,kDAA+C,CAAC;AAExE,MAAM,WAAW,iBAAiB;IAChC,4BAA4B;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,+EAA+E;IAC/E,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,8EAA8E;IAC9E,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,wBAAgB,YAAY,CAAC,EAC3B,aAA2B,EAC3B,YAAyB,EACzB,SAAiB,EACjB,QAAQ,GACT,EAAE,iBAAiB,2CA4DnB"}

package/dist/i18n/I18nContext.js

@@ -0,0 +1,58 @@
+import { jsx } from "react/jsx-runtime";
+import { createContext, useState, useRef, useEffect, useCallback, useMemo } from "react";
+import moment from "moment";
+import "../node_modules/moment/dist/locale/de.js";
+import { BASE_LOCALE } from "../locales/index.js";
+import { buildMessages, translate } from "./translate.js";
+const I18nContext = createContext(null);
+function I18nProvider({
+  defaultLocale = BASE_LOCALE,
+  loadMessages = () => ({}),
+  debugKeys = false,
+  children
+}) {
+  const [locale, setLocaleState] = useState(defaultLocale);
+  const [hostMessages, setHostMessages] = useState({});
+  const [loading, setLoading] = useState(false);
+  const requestIdRef = useRef(0);
+  const loadMessagesRef = useRef(loadMessages);
+  useEffect(() => {
+    loadMessagesRef.current = loadMessages;
+  }, [loadMessages]);
+  const setLocale = useCallback(async (code) => {
+    const requestId = ++requestIdRef.current;
+    setLoading(true);
+    try {
+      const host = await loadMessagesRef.current(code);
+      if (requestId !== requestIdRef.current) return;
+      setHostMessages(host);
+      setLocaleState(code);
+    } catch {
+      if (requestId !== requestIdRef.current) return;
+      setHostMessages({});
+      setLocaleState(code);
+    } finally {
+      if (requestId === requestIdRef.current) setLoading(false);
+    }
+  }, []);
+  useEffect(() => {
+    void setLocale(defaultLocale);
+  }, []);
+  useEffect(() => {
+    moment.locale(locale);
+  }, [locale]);
+  const messages = useMemo(() => buildMessages(locale, hostMessages), [locale, hostMessages]);
+  const t = useCallback(
+    (key, vars) => debugKeys ? key : translate(messages, key, vars),
+    [messages, debugKeys]
+  );
+  const value = useMemo(
+    () => ({ locale, messages, loading, setLocale, t, debugKeys }),
+    [locale, messages, loading, setLocale, t, debugKeys]
+  );
+  return /* @__PURE__ */ jsx(I18nContext.Provider, { value, children });
+}
+export {
+  I18nContext,
+  I18nProvider
+};

package/dist/i18n/index.d.ts

@@ -0,0 +1,9 @@
+export { I18nProvider, I18nContext } from './I18nContext';
+export type { I18nProviderProps } from './I18nContext';
+export { useI18n } from './useI18n';
+export { useTranslation } from './useTranslation';
+export { buildMessages, translate } from './translate';
+export { ourDictionaries, enUS, BASE_LOCALE, AGLocaleMap, LOCALE_REGISTRY } from '../locales';
+export type { LocaleRegistryEntry } from '../locales';
+export type { Locale, Messages, TranslateVars, TFunction, LoadMessages, I18nContextValue, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/i18n/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/i18n/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC1D,YAAY,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC9F,YAAY,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACtD,YAAY,EACV,MAAM,EACN,QAAQ,EACR,aAAa,EACb,SAAS,EACT,YAAY,EACZ,gBAAgB,GACjB,MAAM,SAAS,CAAC"}

package/dist/i18n/translate.d.ts

@@ -0,0 +1,15 @@
+import { Locale, Messages, TranslateVars } from './types';
+
+/**
+ * Build the effective message map for a locale using the 3-layer merge:
+ *   1. enUS                      -> guaranteed-complete base (never blank)
+ *   2. ourDictionaries[locale]   -> impact-ui's translation for this locale
+ *   3. hostMessages              -> consumer overrides / their own keys (win)
+ */
+export declare function buildMessages(locale: Locale, hostMessages?: Messages): Messages;
+/**
+ * Look up a key and interpolate {placeholder} tokens.
+ * Falls back to the key itself if it is missing (so nothing renders blank).
+ */
+export declare function translate(messages: Messages, key: string, vars?: TranslateVars): string;
+//# sourceMappingURL=translate.d.ts.map

package/dist/i18n/translate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"translate.d.ts","sourceRoot":"","sources":["../../src/i18n/translate.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE/D;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,GAAE,QAAa,GAAG,QAAQ,CAMnF;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,MAAM,CAQvF"}

package/dist/i18n/translate.js

@@ -0,0 +1,22 @@
+import { ourDictionaries, BASE_LOCALE } from "../locales/index.js";
+import enUS from "../locales/en-US.json.js";
+function buildMessages(locale, hostMessages = {}) {
+  return {
+    ...enUS,
+    ...ourDictionaries[locale] ?? ourDictionaries[BASE_LOCALE] ?? {},
+    ...hostMessages
+  };
+}
+function translate(messages, key, vars) {
+  let text = messages[key] ?? key;
+  if (vars) {
+    Object.keys(vars).forEach((name) => {
+      text = text.replace(new RegExp(`\\{${name}\\}`, "g"), String(vars[name]));
+    });
+  }
+  return text;
+}
+export {
+  buildMessages,
+  translate
+};

package/dist/i18n/types.d.ts

@@ -0,0 +1,18 @@
+export type Locale = string;
+export type Messages = Record<string, string>;
+export type TranslateVars = Record<string, string | number>;
+export type TFunction = (key: string, vars?: TranslateVars) => string;
+/**
+ * Host hook to supply consumer overrides / extra languages for a locale.
+ * May be sync or async.
+ */
+export type LoadMessages = (code: Locale) => Messages | Promise<Messages>;
+export interface I18nContextValue {
+    locale: Locale;
+    messages: Messages;
+    loading: boolean;
+    setLocale: (code: Locale) => Promise<void>;
+    t: TFunction;
+    debugKeys: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/i18n/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/i18n/types.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,MAAM,GAAG,MAAM,CAAC;AAE5B,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAE9C,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;AAE5D,MAAM,MAAM,SAAS,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,aAAa,KAAK,MAAM,CAAC;AAEtE;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;AAE1E,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,QAAQ,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,CAAC,EAAE,SAAS,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;CACpB"}

package/dist/i18n/useI18n.d.ts

@@ -0,0 +1,10 @@
+import { I18nContextValue } from './types';
+
+/**
+ * Access the full i18n context: { locale, messages, loading, setLocale, t }.
+ *
+ * Safe to use outside an I18nProvider: it degrades to the base locale
+ * so library components never crash when a consumer forgets the provider.
+ */
+export declare function useI18n(): I18nContextValue;
+//# sourceMappingURL=useI18n.d.ts.map

package/dist/i18n/useI18n.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useI18n.d.ts","sourceRoot":"","sources":["../../src/i18n/useI18n.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,gBAAgB,EAAiB,MAAM,SAAS,CAAC;AAE/D;;;;;GAKG;AACH,wBAAgB,OAAO,IAAI,gBAAgB,CAsB1C"}

package/dist/i18n/useI18n.js

@@ -0,0 +1,28 @@
+import { useContext } from "react";
+import { I18nContext } from "./I18nContext.js";
+import { buildMessages } from "./translate.js";
+import { BASE_LOCALE } from "../locales/index.js";
+function useI18n() {
+  const ctx = useContext(I18nContext);
+  if (ctx) return ctx;
+  const messages = buildMessages(BASE_LOCALE, {});
+  return {
+    locale: BASE_LOCALE,
+    messages,
+    loading: false,
+    setLocale: () => Promise.resolve(),
+    t: (key, vars) => {
+      let text = messages[key] ?? key;
+      if (vars) {
+        Object.keys(vars).forEach((name) => {
+          text = text.replace(new RegExp(`\\{${name}\\}`, "g"), String(vars[name]));
+        });
+      }
+      return text;
+    },
+    debugKeys: false
+  };
+}
+export {
+  useI18n
+};

package/dist/i18n/useTranslation.d.ts

@@ -0,0 +1,15 @@
+import { Locale, TFunction } from './types';
+
+/**
+ * Convenience hook for components that only need the translation function.
+ *
+ * Usage:
+ *   const { t } = useTranslation();
+ *   <Button>{t("common.apply")}</Button>
+ *   <span>{t("monthPicker.placeholder", { format: "MM/YYYY" })}</span>
+ */
+export declare function useTranslation(): {
+    t: TFunction;
+    locale: Locale;
+};
+//# sourceMappingURL=useTranslation.d.ts.map

package/dist/i18n/useTranslation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTranslation.d.ts","sourceRoot":"","sources":["../../src/i18n/useTranslation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEjD;;;;;;;GAOG;AACH,wBAAgB,cAAc,IAAI;IAAE,CAAC,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAGjE"}

package/dist/i18n/useTranslation.js

@@ -0,0 +1,8 @@
+import { useI18n } from "./useI18n.js";
+function useTranslation() {
+  const { t, locale } = useI18n();
+  return { t, locale };
+}
+export {
+  useTranslation
+};