@endora-commerce/admin-kit 0.0.0-stage → 0.100.0

package/dist/i18n/TranslationProvider.js

@@ -0,0 +1,130 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+// React Context provider for the Admin UI i18n runtime — feature 019.
+//
+// Holds the current language and the merged bundle for that language.
+// Re-renders the entire tree without sign-out when the language flips
+// (FR-005, SC-002). Boot-time fetch is on-demand: the provider issues
+// a single `getBundles(language)` call when its `language` prop changes
+// and caches the response in state.
+//
+// Missing translations log a `console.warn` in development only
+// (research §R8); production stays silent. Each distinct subject is reported
+// once per module registry — see `reportedSubjects` below for why a per-render
+// repeat is a CI defect and not a nuisance.
+import { createContext, useCallback, useContext, useEffect, useMemo, useRef, useState, } from 'react';
+import { getBundles } from './language-storage.js';
+import { resolve } from './resolver.js';
+const TranslationContext = createContext(null);
+/**
+ * Subjects the two development diagnostics below have already reported.
+ *
+ * Both of them state a fact about a *subject* — this language's bundle cannot be
+ * fetched; this key is not in it — and both sit on a path that runs again for
+ * reasons that have nothing to do with whether the fact changed. `t()` is called
+ * during render, so a missing key is re-discovered on every render of every
+ * component that reads it; the boot effect runs once per provider mount, so a
+ * failing endpoint is re-discovered once per mount. Neither repetition is wrong
+ * and neither is news.
+ *
+ * It was measured as a CI defect rather than a nuisance. Master pipeline 14265's
+ * `test:frontend` (job 55801) failed and the reason was unobtainable: the trace
+ * ends in `Job's log exceeded limit of 4194304 bytes`, vitest prints its failure
+ * summary last, and the summary was past the cut. One green run of that job's
+ * command is **5 509 606 bytes**, of which 3 537 037 (64.2%) are 38 201
+ * missing-key lines carrying 920 distinct keys, and a further 1 406 522 (25.5%)
+ * are 673 copies of one fetch failure, each with a ten-frame stack.
+ * `admin/test/kit/kit-i18n-diagnostic-volume.test.tsx` holds the census and the
+ * two mechanisms.
+ *
+ * The first occurrence keeps its full form, stack included — that is the
+ * diagnostic, and one copy of it costs nothing. What is dropped is an exact
+ * repeat, and deliberately without a running count: "`core.appShell.nav.home` is
+ * missing" is the entire signal, and "it is missing 1 065 times" is a fact about
+ * how often the tree re-rendered.
+ *
+ * Module scope, so the memory is one module registry: one page load in a browser,
+ * one test file under vitest. That is the right granularity in both — the log
+ * still attributes the key to the file that surfaced it — and it needs no reset
+ * hook, which a React provider has nowhere to put. The set is bounded by the
+ * number of distinct keys the application names.
+ */
+const reportedSubjects = new Set();
+/** Report `args` unless this `subject` has already been reported in this registry. */
+function warnOncePerSubject(subject, ...args) {
+    if (reportedSubjects.has(subject))
+        return;
+    reportedSubjects.add(subject);
+    console.warn(...args);
+}
+export function TranslationProvider(props) {
+    const { language, initialBundle, initialFallbackBundle, children } = props;
+    const [bundle, setBundle] = useState(initialBundle ?? {});
+    const [fallbackBundle, setFallbackBundle] = useState(initialFallbackBundle);
+    const lastFetchedRef = useRef(initialBundle ? language : null);
+    // Fetch the requested-language bundle whenever the language prop flips
+    // (or on first mount when no initialBundle was supplied).
+    useEffect(() => {
+        if (lastFetchedRef.current === language)
+            return;
+        let cancelled = false;
+        void (async () => {
+            try {
+                const res = await getBundles(language);
+                if (cancelled)
+                    return;
+                setBundle(res.bundles);
+                lastFetchedRef.current = language;
+                // Pre-fetch EN once for cross-language fallback (FR-013) — only
+                // when the user has chosen a non-English language and we don't
+                // already have it.
+                if (language !== 'en' && !fallbackBundle) {
+                    const fb = await getBundles('en');
+                    if (!cancelled)
+                        setFallbackBundle(fb.bundles);
+                }
+            }
+            catch (err) {
+                // Logging only; the provider keeps the prior bundle so the UI
+                // stays usable. The toast is the consumer's responsibility.
+                if (import.meta.env.DEV) {
+                    // The subject is the language whose bundle could not be fetched, so a
+                    // second language failing is still reported; the same one failing on
+                    // the next mount is not.
+                    warnOncePerSubject(`bundle-fetch:${language}`, '[i18n] bundle fetch failed', err);
+                }
+            }
+        })();
+        return () => {
+            cancelled = true;
+        };
+    }, [language, fallbackBundle]);
+    const t = useCallback((scope, key, params) => {
+        const result = resolve({
+            scope,
+            key,
+            language,
+            bundle,
+            ...(fallbackBundle !== undefined ? { fallbackBundle } : {}),
+            ...(params ? { params } : {}),
+        });
+        if (import.meta.env.DEV && result.outcome !== 'requested') {
+            const target = result.outcome === 'en' ? 'en' : 'placeholder';
+            // The subject is the key in this language, and the outcome is part of it:
+            // a key that stops resolving from `en` and starts resolving to a
+            // placeholder is a different fact, and says so.
+            warnOncePerSubject(`missing:${language}:${scope}.${key}:${target}`, `[i18n] missing ${language}: ${scope}.${key} → fell back to ${target}`);
+        }
+        return result.value;
+    }, [language, bundle, fallbackBundle]);
+    const value = useMemo(() => ({ language, bundle, fallbackBundle, t }), [language, bundle, fallbackBundle, t]);
+    return (_jsx(TranslationContext.Provider, { value: value, children: children }));
+}
+/** Internal accessor — `useTranslation` is the public-facing wrapper. */
+export function useTranslationContext() {
+    const ctx = useContext(TranslationContext);
+    if (!ctx) {
+        throw new Error('[i18n] useTranslation called outside <TranslationProvider>; wrap your app tree first.');
+    }
+    return ctx;
+}
+//# sourceMappingURL=TranslationProvider.js.map

package/dist/i18n/TranslationProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TranslationProvider.js","sourceRoot":"","sources":["../../src/i18n/TranslationProvider.tsx"],"names":[],"mappings":"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"}

package/dist/i18n/app-language-context.d.ts

@@ -0,0 +1,8 @@
+import type { SupportedAdminLanguage } from './types.js';
+export interface AppLanguageContextValue {
+    language: SupportedAdminLanguage;
+    setLanguage(next: SupportedAdminLanguage): void;
+}
+export declare const AppLanguageContext: import("react").Context<AppLanguageContextValue | null>;
+export declare function useAppLanguage(): AppLanguageContextValue;
+//# sourceMappingURL=app-language-context.d.ts.map

package/dist/i18n/app-language-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-language-context.d.ts","sourceRoot":"","sources":["../../src/i18n/app-language-context.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEzD,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,sBAAsB,CAAC;IACjC,WAAW,CAAC,IAAI,EAAE,sBAAsB,GAAG,IAAI,CAAC;CACjD;AAED,eAAO,MAAM,kBAAkB,yDAE9B,CAAC;AAEF,wBAAgB,cAAc,IAAI,uBAAuB,CAQxD"}

package/dist/i18n/app-language-context.js

@@ -0,0 +1,13 @@
+// Tiny context shared between App and ProfilePage so the user's
+// language selector in Profile flips the whole admin tree without
+// going through React-Query / global state. Feature 019.
+import { createContext, useContext } from 'react';
+export const AppLanguageContext = createContext(null);
+export function useAppLanguage() {
+    const ctx = useContext(AppLanguageContext);
+    if (!ctx) {
+        throw new Error('useAppLanguage must be used inside <AppLanguageContext.Provider>; check App.tsx wiring.');
+    }
+    return ctx;
+}
+//# sourceMappingURL=app-language-context.js.map

package/dist/i18n/app-language-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-language-context.js","sourceRoot":"","sources":["../../src/i18n/app-language-context.tsx"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,kEAAkE;AAClE,yDAAyD;AAEzD,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAQlD,MAAM,CAAC,MAAM,kBAAkB,GAAG,aAAa,CAC7C,IAAI,CACL,CAAC;AAEF,MAAM,UAAU,cAAc;IAC5B,MAAM,GAAG,GAAG,UAAU,CAAC,kBAAkB,CAAC,CAAC;IAC3C,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CACb,yFAAyF,CAC1F,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/i18n/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * `@endora-commerce/admin-kit/i18n` — Translation: the provider, the language context and `useTranslation`.
+ *
+ * The membership is **derived, never designed**
+ * (`specs/091-module-owned-admin-surfaces/contracts/admin-kit-surface.md` §1): every
+ * `from '…'` specifier in the admin's module directories that resolves inside the admin
+ * source root and outside the importing file's own module directory, plus the transitive
+ * closure of those files, which is what has to live in one place for there to be one copy.
+ *
+ * The barrel is **explicit and holds no `export *`** (R2): a short published set reports
+ * more findings than a complete one, and its obvious repair is to widen the barrel
+ * silently. `check:admin-surface` refuses one and exits 2.
+ *
+ * Every binding here is the **only** copy in the process. `admin/src` keeps a re-export
+ * shim at each old path, so a `@/…` specifier and this subpath name one module record —
+ * proved by reference equality in `admin/test/kit/admin-kit-shims.test.ts`, not by a
+ * structural comparison, which a second React context would pass.
+ */
+export { TranslationProvider, useTranslationContext } from './TranslationProvider.js';
+export type { TranslationProviderProps } from './TranslationProvider.js';
+export { AppLanguageContext, useAppLanguage } from './app-language-context.js';
+export type { AppLanguageContextValue } from './app-language-context.js';
+export { interpolate } from './interpolate.js';
+export { getBundles, reloadBundles, setPreferredLanguage } from './language-storage.js';
+export { resolve } from './resolver.js';
+export type { ResolveArgs, ResolveResult } from './resolver.js';
+export type { Bundle, GetBundlesResponse, ResolveOutcome, ScopedBundle, SupportedAdminLanguage, TranslationBundleEntries } from './types.js';
+export { useTranslation } from './useTranslation.js';
+//# 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":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACtF,YAAY,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC/E,YAAY,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AACxF,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAChE,YAAY,EAAE,MAAM,EAAE,kBAAkB,EAAE,cAAc,EAAE,YAAY,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAC7I,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/i18n/index.js

@@ -0,0 +1,25 @@
+/**
+ * `@endora-commerce/admin-kit/i18n` — Translation: the provider, the language context and `useTranslation`.
+ *
+ * The membership is **derived, never designed**
+ * (`specs/091-module-owned-admin-surfaces/contracts/admin-kit-surface.md` §1): every
+ * `from '…'` specifier in the admin's module directories that resolves inside the admin
+ * source root and outside the importing file's own module directory, plus the transitive
+ * closure of those files, which is what has to live in one place for there to be one copy.
+ *
+ * The barrel is **explicit and holds no `export *`** (R2): a short published set reports
+ * more findings than a complete one, and its obvious repair is to widen the barrel
+ * silently. `check:admin-surface` refuses one and exits 2.
+ *
+ * Every binding here is the **only** copy in the process. `admin/src` keeps a re-export
+ * shim at each old path, so a `@/…` specifier and this subpath name one module record —
+ * proved by reference equality in `admin/test/kit/admin-kit-shims.test.ts`, not by a
+ * structural comparison, which a second React context would pass.
+ */
+export { TranslationProvider, useTranslationContext } from './TranslationProvider.js';
+export { AppLanguageContext, useAppLanguage } from './app-language-context.js';
+export { interpolate } from './interpolate.js';
+export { getBundles, reloadBundles, setPreferredLanguage } from './language-storage.js';
+export { resolve } from './resolver.js';
+export { useTranslation } from './useTranslation.js';
+//# sourceMappingURL=index.js.map

package/dist/i18n/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/i18n/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAEtF,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAE/E,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AACxF,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAGxC,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/i18n/interpolate.d.ts

@@ -0,0 +1,2 @@
+export declare function interpolate(template: string, params?: Record<string, string | number>): string;
+//# sourceMappingURL=interpolate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"interpolate.d.ts","sourceRoot":"","sources":["../../src/i18n/interpolate.ts"],"names":[],"mappings":"AAKA,wBAAgB,WAAW,CACzB,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GACvC,MAAM,CAKR"}

package/dist/i18n/interpolate.js

@@ -0,0 +1,10 @@
+// `{name}`-style placeholder substitution — feature 019 / research §R2.
+//
+// Single-regex interpolation. Missing parameter names are left in place so
+// the gap is visible in the rendered UI rather than silently elided.
+export function interpolate(template, params) {
+    if (!params)
+        return template;
+    return template.replace(/\{(\w+)\}/g, (_match, name) => params[name] != null ? String(params[name]) : `{${name}}`);
+}
+//# sourceMappingURL=interpolate.js.map

package/dist/i18n/interpolate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interpolate.js","sourceRoot":"","sources":["../../src/i18n/interpolate.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,EAAE;AACF,2EAA2E;AAC3E,qEAAqE;AAErE,MAAM,UAAU,WAAW,CACzB,QAAgB,EAChB,MAAwC;IAExC,IAAI,CAAC,MAAM;QAAE,OAAO,QAAQ,CAAC;IAC7B,OAAO,QAAQ,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,MAAM,EAAE,IAAY,EAAE,EAAE,CAC7D,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,GAAG,CAC1D,CAAC;AACJ,CAAC"}

package/dist/i18n/language-storage.d.ts

@@ -0,0 +1,16 @@
+import type { GetBundlesResponse, SupportedAdminLanguage } from '@endora-commerce/contracts';
+export declare function getBundles(language: SupportedAdminLanguage): Promise<GetBundlesResponse>;
+/**
+ * Hot-reload translations: re-reads every module's on-disk i18n bundles into
+ * the DB (feature: i18n reload). The caller should refresh the page afterwards
+ * so the new strings are fetched.
+ */
+export declare function reloadBundles(): Promise<{
+    installed: number;
+    skipped: number;
+    failed: number;
+}>;
+export declare function setPreferredLanguage(preferredLanguage: SupportedAdminLanguage | null): Promise<{
+    preferredLanguage: SupportedAdminLanguage | null;
+}>;
+//# sourceMappingURL=language-storage.d.ts.map

package/dist/i18n/language-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"language-storage.d.ts","sourceRoot":"","sources":["../../src/i18n/language-storage.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,kBAAkB,EAElB,sBAAsB,EACvB,MAAM,4BAA4B,CAAC;AAEpC,wBAAsB,UAAU,CAC9B,QAAQ,EAAE,sBAAsB,GAC/B,OAAO,CAAC,kBAAkB,CAAC,CAK7B;AAED;;;;GAIG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC,CAKD;AAED,wBAAsB,oBAAoB,CACxC,iBAAiB,EAAE,sBAAsB,GAAG,IAAI,GAC/C,OAAO,CAAC;IAAE,iBAAiB,EAAE,sBAAsB,GAAG,IAAI,CAAA;CAAE,CAAC,CAM/D"}

package/dist/i18n/language-storage.js

@@ -0,0 +1,26 @@
+// Typed I/O against the Admin UI i18n endpoints — feature 019 /
+// contracts/admin-http.md. No UI here; just the contract calls.
+//
+// Both endpoints return the project-standard `{ data: ... }` envelope
+// (packages/contracts/src/envelopes.ts) — these helpers unwrap it so
+// the SPA's TranslationProvider receives the bare payload.
+import { apiClient } from '../lib/api-client.js';
+export async function getBundles(language) {
+    const res = await apiClient.get(`/api/v1/admin/i18n/bundles?language=${encodeURIComponent(language)}`);
+    return res.data;
+}
+/**
+ * Hot-reload translations: re-reads every module's on-disk i18n bundles into
+ * the DB (feature: i18n reload). The caller should refresh the page afterwards
+ * so the new strings are fetched.
+ */
+export async function reloadBundles() {
+    const res = await apiClient.post('/api/v1/admin/i18n/reload', {});
+    return res.data;
+}
+export async function setPreferredLanguage(preferredLanguage) {
+    const body = { preferredLanguage };
+    const res = await apiClient.patch('/api/v1/admin/me/preferred-language', body);
+    return res.data;
+}
+//# sourceMappingURL=language-storage.js.map

package/dist/i18n/language-storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"language-storage.js","sourceRoot":"","sources":["../../src/i18n/language-storage.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,gEAAgE;AAChE,EAAE;AACF,sEAAsE;AACtE,qEAAqE;AACrE,2DAA2D;AAE3D,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAOjD,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,QAAgC;IAEhC,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,GAAG,CAC7B,uCAAuC,kBAAkB,CAAC,QAAQ,CAAC,EAAE,CACtE,CAAC;IACF,OAAO,GAAG,CAAC,IAAI,CAAC;AAClB,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa;IAKjC,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,IAAI,CAE7B,2BAA2B,EAAE,EAAE,CAAC,CAAC;IACpC,OAAO,GAAG,CAAC,IAAI,CAAC;AAClB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,iBAAgD;IAEhD,MAAM,IAAI,GAA+B,EAAE,iBAAiB,EAAE,CAAC;IAC/D,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,KAAK,CAE9B,qCAAqC,EAAE,IAAI,CAAC,CAAC;IAChD,OAAO,GAAG,CAAC,IAAI,CAAC;AAClB,CAAC"}

package/dist/i18n/resolver.d.ts

@@ -0,0 +1,19 @@
+import type { Bundle, ResolveOutcome, SupportedAdminLanguage } from './types.js';
+export interface ResolveArgs {
+    scope: string;
+    key: string;
+    language: SupportedAdminLanguage;
+    bundle: Bundle;
+    /** Optional EN bundle pre-fetched separately. When undefined, no
+     *  cross-language fallback is attempted (useful when the SPA already
+     *  fetched only the user's preferred bundle and is in a degraded
+     *  rendering state — see research §R7). */
+    fallbackBundle?: Bundle;
+    params?: Record<string, string | number>;
+}
+export interface ResolveResult {
+    value: string;
+    outcome: ResolveOutcome;
+}
+export declare function resolve(args: ResolveArgs): ResolveResult;
+//# sourceMappingURL=resolver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../src/i18n/resolver.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAIjF,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,sBAAsB,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf;;;+CAG2C;IAC3C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;CAC1C;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,cAAc,CAAC;CACzB;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,WAAW,GAAG,aAAa,CAaxD"}

package/dist/i18n/resolver.js

@@ -0,0 +1,23 @@
+// Pure i18n resolver — feature 019 / research §R7.
+//
+// Three-step fallback chain: requested-language entry → English entry →
+// `${scope}.${key}` placeholder. The `outcome` field lets callers
+// observe whether a fallback fired so the diagnostic surface
+// (TranslationProvider's dev-mode console.warn) can log it.
+import { interpolate } from './interpolate.js';
+const FALLBACK_LANGUAGE = 'en';
+export function resolve(args) {
+    const { scope, key, language, bundle, fallbackBundle, params } = args;
+    const requested = bundle[scope]?.[key];
+    if (requested != null) {
+        return { value: interpolate(requested, params), outcome: 'requested' };
+    }
+    if (language !== FALLBACK_LANGUAGE) {
+        const englishValue = fallbackBundle?.[scope]?.[key];
+        if (englishValue != null) {
+            return { value: interpolate(englishValue, params), outcome: 'en' };
+        }
+    }
+    return { value: `${scope}.${key}`, outcome: 'placeholder' };
+}
+//# sourceMappingURL=resolver.js.map

package/dist/i18n/resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.js","sourceRoot":"","sources":["../../src/i18n/resolver.ts"],"names":[],"mappings":"AAAA,mDAAmD;AACnD,EAAE;AACF,wEAAwE;AACxE,kEAAkE;AAClE,6DAA6D;AAC7D,4DAA4D;AAE5D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG/C,MAAM,iBAAiB,GAA2B,IAAI,CAAC;AAoBvD,MAAM,UAAU,OAAO,CAAC,IAAiB;IACvC,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACtE,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IACvC,IAAI,SAAS,IAAI,IAAI,EAAE,CAAC;QACtB,OAAO,EAAE,KAAK,EAAE,WAAW,CAAC,SAAS,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;IACzE,CAAC;IACD,IAAI,QAAQ,KAAK,iBAAiB,EAAE,CAAC;QACnC,MAAM,YAAY,GAAG,cAAc,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;QACpD,IAAI,YAAY,IAAI,IAAI,EAAE,CAAC;YACzB,OAAO,EAAE,KAAK,EAAE,WAAW,CAAC,YAAY,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QACrE,CAAC;IACH,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,GAAG,KAAK,IAAI,GAAG,EAAE,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC;AAC9D,CAAC"}

package/dist/i18n/types.d.ts

@@ -0,0 +1,12 @@
+import type { GetBundlesResponse, SupportedAdminLanguage, TranslationBundleEntries } from '@endora-commerce/contracts';
+export type { GetBundlesResponse, SupportedAdminLanguage, TranslationBundleEntries, };
+/** Per-module scoped bundle (one language). */
+export type ScopedBundle = TranslationBundleEntries;
+/**
+ * Merged bundle delivered to the SPA — `moduleId → entries` for the
+ * single language the user is currently viewing.
+ */
+export type Bundle = GetBundlesResponse['bundles'];
+/** Outcome of a single resolver lookup; lets callers observe the fallback chain. */
+export type ResolveOutcome = 'requested' | 'en' | 'placeholder';
+//# 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":"AAMA,OAAO,KAAK,EACV,kBAAkB,EAClB,sBAAsB,EACtB,wBAAwB,EACzB,MAAM,4BAA4B,CAAC;AAEpC,YAAY,EACV,kBAAkB,EAClB,sBAAsB,EACtB,wBAAwB,GACzB,CAAC;AAEF,+CAA+C;AAC/C,MAAM,MAAM,YAAY,GAAG,wBAAwB,CAAC;AAEpD;;;GAGG;AACH,MAAM,MAAM,MAAM,GAAG,kBAAkB,CAAC,SAAS,CAAC,CAAC;AAEnD,oFAAoF;AACpF,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,IAAI,GAAG,aAAa,CAAC"}

package/dist/i18n/types.js

@@ -0,0 +1,7 @@
+// Admin UI i18n runtime types — feature 019.
+//
+// Re-exports of the contract shapes plus admin-side type aliases. The
+// Bundle and ScopedBundle aliases are used by TranslationProvider and
+// the resolver respectively — see admin/src/i18n/resolver.ts.
+export {};
+//# sourceMappingURL=types.js.map

package/dist/i18n/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/i18n/types.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,EAAE;AACF,sEAAsE;AACtE,sEAAsE;AACtE,8DAA8D"}

package/dist/i18n/useTranslation.d.ts

@@ -0,0 +1,2 @@
+export declare function useTranslation(scope: string): (key: string, params?: Record<string, string | number>) => string;
+//# 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":"AAaA,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,SAGlC,MAAM,WAAW,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,KAAG,MAAM,CAIlE"}

package/dist/i18n/useTranslation.js

@@ -0,0 +1,16 @@
+// Public hook — feature 019.
+//
+// Returns a scope-bound `t(key, params?)` function. Pass the calling
+// module's id as the scope so keys are looked up against the right
+// bundle (research §R3, FR-009).
+//
+//   const t = useTranslation('settings');
+//   t('actions.save');                          // → "Save" / "Zapisz"
+//   t('notifications.saved', { name: 'foo' });  // → "Saved \"foo\"."
+import { useCallback } from 'react';
+import { useTranslationContext } from './TranslationProvider.js';
+export function useTranslation(scope) {
+    const { t } = useTranslationContext();
+    return useCallback((key, params) => t(scope, key, params), [t, scope]);
+}
+//# sourceMappingURL=useTranslation.js.map

package/dist/i18n/useTranslation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTranslation.js","sourceRoot":"","sources":["../../src/i18n/useTranslation.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,EAAE;AACF,qEAAqE;AACrE,mEAAmE;AACnE,iCAAiC;AACjC,EAAE;AACF,0CAA0C;AAC1C,uEAAuE;AACvE,sEAAsE;AAEtE,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AACpC,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAEjE,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,MAAM,EAAE,CAAC,EAAE,GAAG,qBAAqB,EAAE,CAAC;IACtC,OAAO,WAAW,CAChB,CAAC,GAAW,EAAE,MAAwC,EAAU,EAAE,CAChE,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,CAAC,EACvB,CAAC,CAAC,EAAE,KAAK,CAAC,CACX,CAAC;AACJ,CAAC"}

package/dist/lib/admin-actions/icon-map.d.ts

@@ -0,0 +1,3 @@
+import { type LucideIcon } from 'lucide-react';
+export declare function resolveIcon(name: string): LucideIcon;
+//# sourceMappingURL=icon-map.d.ts.map

package/dist/lib/admin-actions/icon-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"icon-map.d.ts","sourceRoot":"","sources":["../../../src/lib/admin-actions/icon-map.ts"],"names":[],"mappings":"AAAA,OAAO,EA0DL,KAAK,UAAU,EAChB,MAAM,cAAc,CAAC;AA4GtB,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAOpD"}

package/dist/lib/admin-actions/icon-map.js

@@ -0,0 +1,115 @@
+import { Activity, Archive, Bell, BookOpen, Box, Boxes, Building2, CircleDollarSign, ClipboardCheck, ClipboardList, CloudUpload, CreditCard, Download, Edit, Eraser, FilePlus, FileDown, FileText, FileUp, FolderPlus, Image as ImageIcon, Inbox, KeyRound, Languages, Layers, LayoutDashboard, LineChart, ListChecks, Menu, Newspaper, Package, PackageOpen, PanelLeft, PercentDiamond, PlugZap, Plus, PlusCircle, PlusSquare, Receipt, Rss, Scale, Search, Settings, ShieldCheck, ShoppingCart, Smartphone, Sparkles, Store, Tag, TrendingDown, Truck, Upload, UserPlus, Users, Video, Warehouse, Webhook, } from 'lucide-react';
+/**
+ * Map from the closed allowlist of icon names declared in
+ * `packages/contracts/src/admin-actions.ts` to their lucide-react
+ * components. Adding a new entry here requires the matching name to be
+ * added to `KnownIconNameSchema` in the same PR.
+ *
+ * If a string somehow reaches the admin that isn't in the allowlist
+ * (e.g., backend and admin bundles drifted across deploys), we render
+ * the `Sparkles` fallback rather than dropping the action — the action
+ * remains usable, only the icon is generic.
+ */
+const ICON_MAP = {
+    Plus,
+    PlugZap,
+    Sparkles,
+    Settings,
+    Search,
+    Boxes,
+    Layers,
+    Menu,
+    PlusCircle,
+    PlusSquare,
+    FilePlus,
+    FolderPlus,
+    Upload,
+    FileUp,
+    CloudUpload,
+    Download,
+    FileDown,
+    FileText,
+    BookOpen,
+    Rss,
+    Package,
+    Tag,
+    ShoppingCart,
+    Receipt,
+    CreditCard,
+    Users,
+    UserPlus,
+    Inbox,
+    ListChecks,
+    ClipboardList,
+    Image: ImageIcon,
+    Video,
+    LayoutDashboard,
+    PanelLeft,
+    KeyRound,
+    // Feature 080 (D-163.1) — the dashboard recent-activity renderings. They
+    // were lucide imports inside `modules/home/activity-render.ts`, the fourth
+    // hand-maintained action table that ruling retired; a module declares its
+    // icon by name now, so the name has to be in the platform's allowlist and
+    // resolve through this one map.
+    Edit,
+    Archive,
+    Box,
+    Truck,
+    CircleDollarSign,
+    Activity,
+    // Feature 091 (Phase 4, batch two) — `analytics` declares its sidebar icon by
+    // name now, and this is the map that turns the name back into the same glyph
+    // `AppShell.tsx` used to import directly.
+    LineChart,
+    // Feature 091 (Phase 4, batch four) — the same, for `admin_roles`' sidebar
+    // entry and palette action.
+    ShieldCheck,
+    // Feature 091 (Phase 4, batch six) — the same, for `pwa`' sidebar entry.
+    Smartphone,
+    // Feature 091 (Phase 4, the plan's batch 6) — the same, for `webhooks`' and
+    // `comparisons`' sidebar entries and palette actions. `api_keys` needed no
+    // entry: `KeyRound` is already above.
+    Webhook,
+    Scale,
+    // Feature 091 (Phase 4, the plan's batch 7) — the same, for `promotions`' two
+    // sidebar entries and two palette rows. The other three members of that batch
+    // needed no entry: `CreditCard`, `Users` and `Rss` are already above.
+    PercentDiamond,
+    // Feature 091 (Phase 4, batch 8) — the same, for `megamenu`'s sidebar entry.
+    // The batch's other five needed no entry: `Search`, `Receipt`, `Truck`,
+    // `CreditCard` and `Package` are already above.
+    Newspaper,
+    // Feature 091 (Phase 4, batch 10) — the same, for `dictionaries`' two sidebar
+    // entries and two palette actions and for `settings`' cache row. The batch's
+    // other rows needed no entry: `ListChecks`, `Settings` and `KeyRound` are
+    // already above.
+    Languages,
+    Eraser,
+    // Feature 091 (Phase 4, batch 13) — the same, for four of `inventory`'s five
+    // sidebar entries. The batch's other rows needed no entry: `Box`,
+    // `CircleDollarSign` and `PlugZap` are already above.
+    Warehouse,
+    TrendingDown,
+    Bell,
+    PackageOpen,
+    // Feature 091 (Phase 4, batch 14) — the same, for `organizations`' and
+    // `sales_channels`' sidebar entries and the two palette actions that replace
+    // their hand-written *Navigate* rows. `customers`' two rows needed no entry:
+    // `Users` is already above.
+    Building2,
+    Store,
+    // Feature 091 (Phase 4, batch 15) — the same, for `orders`' three sidebar
+    // entries. The batch's other seven rows needed no entry: `Package`, `Boxes`,
+    // `Tag`, `FileText` and `ListChecks` are already above.
+    ClipboardCheck,
+};
+export function resolveIcon(name) {
+    const known = ICON_MAP[name];
+    if (known)
+        return known;
+    if (import.meta.env.DEV) {
+        console.warn(`[admin-actions] unknown icon "${name}" — rendering fallback Sparkles.`);
+    }
+    return Sparkles;
+}
+//# sourceMappingURL=icon-map.js.map

package/dist/lib/admin-actions/icon-map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"icon-map.js","sourceRoot":"","sources":["../../../src/lib/admin-actions/icon-map.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EACR,OAAO,EACP,IAAI,EACJ,QAAQ,EACR,GAAG,EACH,KAAK,EACL,SAAS,EACT,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,WAAW,EACX,UAAU,EACV,QAAQ,EACR,IAAI,EACJ,MAAM,EACN,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,MAAM,EACN,UAAU,EACV,KAAK,IAAI,SAAS,EAClB,KAAK,EACL,QAAQ,EACR,SAAS,EACT,MAAM,EACN,eAAe,EACf,SAAS,EACT,UAAU,EACV,IAAI,EACJ,SAAS,EACT,OAAO,EACP,WAAW,EACX,SAAS,EACT,cAAc,EACd,OAAO,EACP,IAAI,EACJ,UAAU,EACV,UAAU,EACV,OAAO,EACP,GAAG,EACH,KAAK,EACL,MAAM,EACN,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,UAAU,EACV,QAAQ,EACR,KAAK,EACL,GAAG,EACH,YAAY,EACZ,KAAK,EACL,MAAM,EACN,QAAQ,EACR,KAAK,EACL,KAAK,EACL,SAAS,EACT,OAAO,GAER,MAAM,cAAc,CAAC;AAGtB;;;;;;;;;;GAUG;AACH,MAAM,QAAQ,GAAsC;IAClD,IAAI;IACJ,OAAO;IACP,QAAQ;IACR,QAAQ;IACR,MAAM;IACN,KAAK;IACL,MAAM;IACN,IAAI;IACJ,UAAU;IACV,UAAU;IACV,QAAQ;IACR,UAAU;IACV,MAAM;IACN,MAAM;IACN,WAAW;IACX,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,GAAG;IACH,OAAO;IACP,GAAG;IACH,YAAY;IACZ,OAAO;IACP,UAAU;IACV,KAAK;IACL,QAAQ;IACR,KAAK;IACL,UAAU;IACV,aAAa;IACb,KAAK,EAAE,SAAS;IAChB,KAAK;IACL,eAAe;IACf,SAAS;IACT,QAAQ;IACR,yEAAyE;IACzE,2EAA2E;IAC3E,0EAA0E;IAC1E,0EAA0E;IAC1E,gCAAgC;IAChC,IAAI;IACJ,OAAO;IACP,GAAG;IACH,KAAK;IACL,gBAAgB;IAChB,QAAQ;IACR,8EAA8E;IAC9E,6EAA6E;IAC7E,0CAA0C;IAC1C,SAAS;IACT,2EAA2E;IAC3E,4BAA4B;IAC5B,WAAW;IACX,yEAAyE;IACzE,UAAU;IACV,4EAA4E;IAC5E,2EAA2E;IAC3E,sCAAsC;IACtC,OAAO;IACP,KAAK;IACL,8EAA8E;IAC9E,8EAA8E;IAC9E,sEAAsE;IACtE,cAAc;IACd,6EAA6E;IAC7E,wEAAwE;IACxE,gDAAgD;IAChD,SAAS;IACT,8EAA8E;IAC9E,6EAA6E;IAC7E,0EAA0E;IAC1E,iBAAiB;IACjB,SAAS;IACT,MAAM;IACN,6EAA6E;IAC7E,kEAAkE;IAClE,sDAAsD;IACtD,SAAS;IACT,YAAY;IACZ,IAAI;IACJ,WAAW;IACX,uEAAuE;IACvE,6EAA6E;IAC7E,6EAA6E;IAC7E,4BAA4B;IAC5B,SAAS;IACT,KAAK;IACL,0EAA0E;IAC1E,6EAA6E;IAC7E,wDAAwD;IACxD,cAAc;CACf,CAAC;AAEF,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAqB,CAAC,CAAC;IAC9C,IAAI,KAAK;QAAE,OAAO,KAAK,CAAC;IACxB,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;QACxB,OAAO,CAAC,IAAI,CAAC,iCAAiC,IAAI,kCAAkC,CAAC,CAAC;IACxF,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/lib/api-client.d.ts

@@ -0,0 +1,55 @@
+/**
+ * The admin's HTTP client — the fetch wrapper, the origin it talks to and the
+ * unauthorized-listener seam around both.
+ *
+ * The wrapper below was `@endora-commerce/api-client` until D-202. That
+ * package's own header called it *"the typed HTTP client shared by storefront
+ * and admin"*, and half of that sentence had never been true: no storefront
+ * file ever imported it, and this file was its only production consumer —
+ * 81 lines behind a package boundary, wrapped by the 30 lines that follow them.
+ * The ruling folded it in here rather than answer what the boundary was for.
+ *
+ * It stays deliberately thin: it carries cookies for session auth and an
+ * optional API key for integration-scope calls, applies the project's envelope
+ * conventions, and surfaces typed errors from `@endora-commerce/contracts`.
+ */
+import type { ErrorEnvelope } from '@endora-commerce/contracts';
+export interface ApiClientOptions {
+    baseUrl: string;
+    /** Optional API-key for server-to-server integrations. Overrides cookie auth when set. */
+    apiKey?: string;
+    /** Optional custom fetch implementation (useful in tests and server-side rendering). */
+    fetchFn?: typeof fetch;
+}
+export declare class ApiError extends Error {
+    readonly status: number;
+    readonly envelope: ErrorEnvelope;
+    constructor(status: number, envelope: ErrorEnvelope);
+}
+export interface ApiClient {
+    get<T>(path: string, init?: RequestInit): Promise<T>;
+    post<T>(path: string, body?: unknown, init?: RequestInit): Promise<T>;
+    put<T>(path: string, body?: unknown, init?: RequestInit): Promise<T>;
+    patch<T>(path: string, body?: unknown, init?: RequestInit): Promise<T>;
+    delete<T>(path: string, init?: RequestInit): Promise<T>;
+}
+export declare function createApiClient(options: ApiClientOptions): ApiClient;
+/**
+ * The API origin this admin talks to, and the **one** place the environment
+ * variable behind it is read.
+ *
+ * Published (feature 091) because a screen that builds a URL the fetch client
+ * cannot make for it — a `<a download>` href, a form action — needs the same
+ * origin, and a module package cannot read `import.meta.env` for itself
+ * without acquiring `vite/client` types and a second copy of this fallback.
+ * Vite replaces the expression `import.meta.env.VITE_API_BASE_URL` at build
+ * time, so it is written **verbatim** here: a cast or an indirection is a
+ * chance for that replacement to stop happening in a way no type-check can
+ * see.
+ */
+export declare const apiBaseUrl: string;
+type Listener = () => void;
+export declare function onUnauthorized(listener: Listener): () => void;
+export declare const apiClient: ApiClient;
+export {};
+//# sourceMappingURL=api-client.d.ts.map

package/dist/lib/api-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.d.ts","sourceRoot":"","sources":["../../src/lib/api-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAEhE,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,0FAA0F;IAC1F,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wFAAwF;IACxF,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;CACxB;AAED,qBAAa,QAAS,SAAQ,KAAK;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;gBACrB,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa;CAMpD;AAED,MAAM,WAAW,SAAS;IACxB,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACrD,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACtE,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACrE,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACvE,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CACzD;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,CA4CpE;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,UAAU,EAAE,MAC6D,CAAC;AAIvF,KAAK,QAAQ,GAAG,MAAM,IAAI,CAAC;AAG3B,wBAAgB,cAAc,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,IAAI,CAK7D;AAWD,eAAO,MAAM,SAAS,EAAE,SAMvB,CAAC"}