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

package/dist/lib/invoice-email-outcome.js

@@ -0,0 +1,43 @@
+/**
+ * The sentence for one of the seven reasons an invoice e-mail did not go out
+ * (issue #103 named them, issue #149 put them on the wire).
+ */
+export function invoiceEmailNotSentReason(reason, t) {
+    return t(`invoices.emailNotSent.${reason}`);
+}
+/**
+ * What to tell the operator who asked for a re-send, and whether it is good
+ * news. Both invoice surfaces reported `invoices.emailSent` unconditionally,
+ * over a response body that could already say the message had been suppressed.
+ */
+export function sendInvoiceEmailMessage(result, t) {
+    if (result.ok)
+        return { ok: true, message: t('invoices.emailSent') };
+    return {
+        ok: false,
+        message: t('invoices.emailNotSentNotice', {
+            reason: invoiceEmailNotSentReason(result.reason, t),
+        }),
+    };
+}
+/**
+ * What to tell the operator after "issue invoice", given what became of the
+ * notification.
+ *
+ * All three answers are distinct, and the middle one matters most: send-on-issue
+ * being switched off is a configured choice, so it reads as a plain "issued"
+ * rather than as a message that failed. A missing `email` field — an older
+ * server, or a response shape a caller did not read — falls back to the same
+ * plain confirmation, which is what the screen said before it could do better.
+ */
+export function issueInvoiceNotice(outcome, t) {
+    if (outcome?.status === 'sent')
+        return t('orderDetail.issueInvoice.doneEmailSent');
+    if (outcome?.status === 'not_sent') {
+        return t('orderDetail.issueInvoice.doneEmailNotSent', {
+            reason: invoiceEmailNotSentReason(outcome.reason, t),
+        });
+    }
+    return t('orderDetail.issueInvoice.done');
+}
+//# sourceMappingURL=invoice-email-outcome.js.map

package/dist/lib/invoice-email-outcome.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoice-email-outcome.js","sourceRoot":"","sources":["../../src/lib/invoice-email-outcome.ts"],"names":[],"mappings":"AAkCA;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CAAC,MAAiC,EAAE,CAAY;IACvF,OAAO,CAAC,CAAC,yBAAyB,MAAM,EAAE,CAAC,CAAC;AAC9C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CACrC,MAA8B,EAC9B,CAAY;IAEZ,IAAI,MAAM,CAAC,EAAE;QAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,oBAAoB,CAAC,EAAE,CAAC;IACrE,OAAO;QACL,EAAE,EAAE,KAAK;QACT,OAAO,EAAE,CAAC,CAAC,6BAA6B,EAAE;YACxC,MAAM,EAAE,yBAAyB,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;SACpD,CAAC;KACH,CAAC;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB,CAChC,OAA6C,EAC7C,CAAY;IAEZ,IAAI,OAAO,EAAE,MAAM,KAAK,MAAM;QAAE,OAAO,CAAC,CAAC,wCAAwC,CAAC,CAAC;IACnF,IAAI,OAAO,EAAE,MAAM,KAAK,UAAU,EAAE,CAAC;QACnC,OAAO,CAAC,CAAC,2CAA2C,EAAE;YACpD,MAAM,EAAE,yBAAyB,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;SACrD,CAAC,CAAC;IACL,CAAC;IACD,OAAO,CAAC,CAAC,+BAA+B,CAAC,CAAC;AAC5C,CAAC"}

package/dist/lib/module-presence/ModulePresenceProvider.d.ts

@@ -0,0 +1,49 @@
+import { type ReactNode } from 'react';
+import type { AdminModulePresenceResponse, ModulePresence } from '@endora-commerce/contracts';
+/**
+ * The effective enabled-set, fetched once and read by every admin surface —
+ * feature 073, FR-031.
+ *
+ * Constitution XVII: a module that is off contributes no sidebar entry, palette
+ * action, widget, tab or settings group. Both frontends resolve that from the
+ * server's projection; nothing here recombines the two axes, because `present`
+ * arrives precomputed. That is what makes "off means absent" one decision
+ * rather than several implementations that can disagree.
+ *
+ * Mirrors `AdminActionsProvider`: fetched on mount, refreshable on demand, no
+ * lifecycle pub/sub bridge on the admin side (there is none today). The one
+ * caller that changes presence — the activation control — calls `refresh()`
+ * itself, so an operator sees their own flip take effect immediately.
+ *
+ * **Fail-closed while unresolved.** Until the first response lands, `isPresent`
+ * answers `false` for a module it has not heard of, so a surface belonging to a
+ * switched-off module never flashes on screen before disappearing. The one
+ * exception is a failed fetch: an admin whose presence request errored would
+ * otherwise be left with an empty sidebar and no way to diagnose it, so a
+ * failure degrades to "show everything" and the gated routes 503 honestly.
+ */
+export interface ModulePresenceContextValue {
+    modules: ModulePresence[];
+    /** `true` when the module is effectively present, i.e. safe to advertise. */
+    isPresent: (moduleId: string) => boolean;
+    /** The full record, for a surface that must render the two axes differently. */
+    presenceOf: (moduleId: string) => ModulePresence | undefined;
+    /**
+     * The serving process is TTL-refreshing because its pub/sub link is
+     * unhealthy, so this projection may lag a flip made elsewhere. Only the
+     * platform screen renders it — every other surface would only be able to
+     * report the staleness, not do anything about it.
+     */
+    degraded: boolean;
+    isLoading: boolean;
+    error: Error | null;
+    refresh: () => Promise<void>;
+}
+export interface ModulePresenceProviderProps {
+    /** Optional pre-supplied projection; tests use this to skip the boot fetch. */
+    initial?: AdminModulePresenceResponse;
+    children: ReactNode;
+}
+export declare function ModulePresenceProvider(props: ModulePresenceProviderProps): ReactNode;
+export declare function useModulePresence(): ModulePresenceContextValue;
+//# sourceMappingURL=ModulePresenceProvider.d.ts.map

package/dist/lib/module-presence/ModulePresenceProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModulePresenceProvider.d.ts","sourceRoot":"","sources":["../../../src/lib/module-presence/ModulePresenceProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,EAAE,2BAA2B,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAG9F;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,6EAA6E;IAC7E,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC;IACzC,gFAAgF;IAChF,UAAU,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,cAAc,GAAG,SAAS,CAAC;IAC7D;;;;;OAKG;IACH,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAID,MAAM,WAAW,2BAA2B;IAC1C,+EAA+E;IAC/E,OAAO,CAAC,EAAE,2BAA2B,CAAC;IACtC,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,2BAA2B,GAAG,SAAS,CA8DpF;AAED,wBAAgB,iBAAiB,IAAI,0BAA0B,CAQ9D"}

package/dist/lib/module-presence/ModulePresenceProvider.js

@@ -0,0 +1,73 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useCallback, useContext, useEffect, useMemo, useState, } from 'react';
+import { getModulePresence } from './api.js';
+const ModulePresenceContext = createContext(null);
+export function ModulePresenceProvider(props) {
+    const { initial, children } = props;
+    const [modules, setModules] = useState(initial?.modules ?? []);
+    const [degraded, setDegraded] = useState(initial?.degraded ?? false);
+    const [isLoading, setIsLoading] = useState(initial == null);
+    const [error, setError] = useState(null);
+    const [tick, setTick] = useState(0);
+    const refresh = useCallback(async () => {
+        setTick((n) => n + 1);
+    }, []);
+    useEffect(() => {
+        if (initial != null && tick === 0)
+            return;
+        let cancelled = false;
+        setIsLoading(true);
+        void (async () => {
+            try {
+                const res = await getModulePresence();
+                if (cancelled)
+                    return;
+                setModules(res.modules);
+                setDegraded(res.degraded);
+                setError(null);
+            }
+            catch (err) {
+                if (!cancelled)
+                    setError(err instanceof Error ? err : new Error(String(err)));
+                if (import.meta.env.DEV) {
+                    console.warn('[module-presence] fetch failed', err);
+                }
+            }
+            finally {
+                if (!cancelled)
+                    setIsLoading(false);
+            }
+        })();
+        return () => {
+            cancelled = true;
+        };
+        // `initial` is a boot-time prop; re-running on its identity would refetch
+        // on every parent render.
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [tick]);
+    const value = useMemo(() => {
+        const byId = new Map(modules.map((m) => [m.id, m]));
+        // A failed fetch leaves an operator with no projection at all. Hiding
+        // everything would be indistinguishable from a broken deployment, so this
+        // one case degrades open and lets the gated routes answer for themselves.
+        const unresolved = error !== null && modules.length === 0;
+        return {
+            modules,
+            isPresent: (moduleId) => byId.get(moduleId)?.present ?? unresolved,
+            presenceOf: (moduleId) => byId.get(moduleId),
+            degraded,
+            isLoading,
+            error,
+            refresh,
+        };
+    }, [modules, degraded, isLoading, error, refresh]);
+    return (_jsx(ModulePresenceContext.Provider, { value: value, children: children }));
+}
+export function useModulePresence() {
+    const ctx = useContext(ModulePresenceContext);
+    if (!ctx) {
+        throw new Error('[module-presence] useModulePresence called outside <ModulePresenceProvider>; wrap your app tree first.');
+    }
+    return ctx;
+}
+//# sourceMappingURL=ModulePresenceProvider.js.map

package/dist/lib/module-presence/ModulePresenceProvider.js.map

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

package/dist/lib/module-presence/api.d.ts

@@ -0,0 +1,15 @@
+import type { AdminModulePresenceResponse, ModuleActivationResponse } from '@endora-commerce/contracts';
+/**
+ * The effective enabled-set, as the server computed it — feature 073.
+ *
+ * Deliberately a bare fetch, mirroring the admin-actions client: the provider
+ * owns caching and refresh, and there is no React Query / SWR layer in this app.
+ */
+export declare function getModulePresence(): Promise<AdminModulePresenceResponse>;
+/**
+ * Flip one module's operator activation. The audited Command behind this
+ * endpoint is the only door: the ordinary settings write path refuses an
+ * activation code.
+ */
+export declare function setModuleActivation(moduleId: string, active: boolean): Promise<ModuleActivationResponse>;
+//# sourceMappingURL=api.d.ts.map

package/dist/lib/module-presence/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../src/lib/module-presence/api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,2BAA2B,EAC3B,wBAAwB,EACzB,MAAM,4BAA4B,CAAC;AASpC;;;;;GAKG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,2BAA2B,CAAC,CAE9E;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,wBAAwB,CAAC,CAKnC"}

package/dist/lib/module-presence/api.js

@@ -0,0 +1,25 @@
+// `../api-client.js`, not the `./lib` barrel the P2 components take it from.
+// That rule is about a collaborator a test outside the package substitutes, and
+// it cannot reach a file the barrel itself exports: measured in P3, a member
+// importing `../index.js` under a `vi.mock` factory that calls `importActual`
+// resolves to the **real** module — the stub is bypassed and the request goes
+// out for real. The seam for this provider is its `initial` prop instead.
+import { apiClient } from '../api-client.js';
+/**
+ * The effective enabled-set, as the server computed it — feature 073.
+ *
+ * Deliberately a bare fetch, mirroring the admin-actions client: the provider
+ * owns caching and refresh, and there is no React Query / SWR layer in this app.
+ */
+export async function getModulePresence() {
+    return apiClient.get('/api/v1/admin/module-presence');
+}
+/**
+ * Flip one module's operator activation. The audited Command behind this
+ * endpoint is the only door: the ordinary settings write path refuses an
+ * activation code.
+ */
+export async function setModuleActivation(moduleId, active) {
+    return apiClient.post(`/api/v1/admin/modules/${encodeURIComponent(moduleId)}/activation`, { active });
+}
+//# sourceMappingURL=api.js.map

package/dist/lib/module-presence/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../../src/lib/module-presence/api.ts"],"names":[],"mappings":"AAIA,6EAA6E;AAC7E,gFAAgF;AAChF,6EAA6E;AAC7E,8EAA8E;AAC9E,8EAA8E;AAC9E,0EAA0E;AAC1E,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB;IACrC,OAAO,SAAS,CAAC,GAAG,CAA8B,+BAA+B,CAAC,CAAC;AACrF,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,QAAgB,EAChB,MAAe;IAEf,OAAO,SAAS,CAAC,IAAI,CACnB,yBAAyB,kBAAkB,CAAC,QAAQ,CAAC,aAAa,EAClE,EAAE,MAAM,EAAE,CACX,CAAC;AACJ,CAAC"}

package/dist/lib/module-presence/index.d.ts

@@ -0,0 +1,3 @@
+export { ModulePresenceProvider, useModulePresence, type ModulePresenceContextValue, type ModulePresenceProviderProps, } from './ModulePresenceProvider.js';
+export { getModulePresence, setModuleActivation } from './api.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/module-presence/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/module-presence/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,KAAK,0BAA0B,EAC/B,KAAK,2BAA2B,GACjC,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC"}

package/dist/lib/module-presence/index.js

@@ -0,0 +1,3 @@
+export { ModulePresenceProvider, useModulePresence, } from './ModulePresenceProvider.js';
+export { getModulePresence, setModuleActivation } from './api.js';
+//# sourceMappingURL=index.js.map

package/dist/lib/module-presence/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/module-presence/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,iBAAiB,GAGlB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC"}

package/dist/lib/money.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Locale-aware money formatting for the admin panel.
+ *
+ * Amounts must render in the conventions of their currency's home country —
+ * e.g. PLN as `1234,56 zł` (comma decimal separator, `zł` suffix, `pl-PL`),
+ * USD as `$1,234.56` (`en-US`). Admin lists show records from many Sales
+ * Channels side by side, each carrying its own currency, so the locale is
+ * derived per amount from the currency itself rather than from the admin UI
+ * language. Pass an explicit `locale` to override (e.g. the channel's
+ * `defaultLanguage`).
+ */
+export declare function localeForCurrency(currency: string): string;
+/**
+ * Format a decimal money amount as a localized currency string.
+ *
+ * @param amount   decimal amount (not minor units), e.g. `1234.56`
+ * @param currency ISO-4217 code, e.g. `PLN`
+ * @param locale   optional BCP-47 locale; defaults to the currency's home
+ *                 locale so PLN renders as `1234,56 zł` regardless.
+ */
+export declare function formatMoney(amount: number, currency: string, locale?: string): string;
+//# sourceMappingURL=money.d.ts.map

package/dist/lib/money.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"money.d.ts","sourceRoot":"","sources":["../../src/lib/money.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAqBH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAQrF"}

package/dist/lib/money.js

@@ -0,0 +1,51 @@
+/**
+ * Locale-aware money formatting for the admin panel.
+ *
+ * Amounts must render in the conventions of their currency's home country —
+ * e.g. PLN as `1234,56 zł` (comma decimal separator, `zł` suffix, `pl-PL`),
+ * USD as `$1,234.56` (`en-US`). Admin lists show records from many Sales
+ * Channels side by side, each carrying its own currency, so the locale is
+ * derived per amount from the currency itself rather than from the admin UI
+ * language. Pass an explicit `locale` to override (e.g. the channel's
+ * `defaultLanguage`).
+ */
+/**
+ * Representative BCP-47 locale per ISO-4217 currency. Keeps the number and
+ * symbol conventions aligned with the currency's home country.
+ */
+const LOCALE_BY_CURRENCY = {
+    PLN: 'pl-PL',
+    EUR: 'de-DE',
+    USD: 'en-US',
+    GBP: 'en-GB',
+    CHF: 'de-CH',
+    CZK: 'cs-CZ',
+    SEK: 'sv-SE',
+    NOK: 'nb-NO',
+    DKK: 'da-DK',
+    HUF: 'hu-HU',
+    RON: 'ro-RO',
+    UAH: 'uk-UA',
+};
+export function localeForCurrency(currency) {
+    return LOCALE_BY_CURRENCY[currency.toUpperCase()] ?? 'en-US';
+}
+/**
+ * Format a decimal money amount as a localized currency string.
+ *
+ * @param amount   decimal amount (not minor units), e.g. `1234.56`
+ * @param currency ISO-4217 code, e.g. `PLN`
+ * @param locale   optional BCP-47 locale; defaults to the currency's home
+ *                 locale so PLN renders as `1234,56 zł` regardless.
+ */
+export function formatMoney(amount, currency, locale) {
+    const loc = locale && locale.trim() !== '' ? locale : localeForCurrency(currency);
+    try {
+        return new Intl.NumberFormat(loc, { style: 'currency', currency }).format(amount);
+    }
+    catch {
+        // Unknown/invalid currency code — fall back to a plain number + code.
+        return `${amount.toFixed(2)} ${currency}`;
+    }
+}
+//# sourceMappingURL=money.js.map

package/dist/lib/money.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"money.js","sourceRoot":"","sources":["../../src/lib/money.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;;GAGG;AACH,MAAM,kBAAkB,GAA2B;IACjD,GAAG,EAAE,OAAO;IACZ,GAAG,EAAE,OAAO;IACZ,GAAG,EAAE,OAAO;IACZ,GAAG,EAAE,OAAO;IACZ,GAAG,EAAE,OAAO;IACZ,GAAG,EAAE,OAAO;IACZ,GAAG,EAAE,OAAO;IACZ,GAAG,EAAE,OAAO;IACZ,GAAG,EAAE,OAAO;IACZ,GAAG,EAAE,OAAO;IACZ,GAAG,EAAE,OAAO;IACZ,GAAG,EAAE,OAAO;CACb,CAAC;AAEF,MAAM,UAAU,iBAAiB,CAAC,QAAgB;IAChD,OAAO,kBAAkB,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,IAAI,OAAO,CAAC;AAC/D,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CAAC,MAAc,EAAE,QAAgB,EAAE,MAAe;IAC3E,MAAM,GAAG,GAAG,MAAM,IAAI,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAClF,IAAI,CAAC;QACH,OAAO,IAAI,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACpF,CAAC;IAAC,MAAM,CAAC;QACP,sEAAsE;QACtE,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,QAAQ,EAAE,CAAC;IAC5C,CAAC;AACH,CAAC"}

package/dist/lib/page-size-options.d.ts

@@ -0,0 +1,15 @@
+/**
+ * The page sizes every paginated admin list offers.
+ *
+ * It is a module of its own because the **constant** is design-system and the
+ * **preference** is application state. `usePageSizePreference` reads the signed-in
+ * admin's id to key its `localStorage` entry, so it belongs to the admin application
+ * and stays there (see the package README, *What Phase 1b does not publish*);
+ * `PaginationFooter` only needs the list of numbers to render its dropdown. Splitting
+ * them is what lets the footer be published without dragging the session with it, and
+ * it keeps exactly one list: the admin's hook re-exports these names rather than
+ * declaring a second array the dropdown and the validation could disagree about.
+ */
+export declare const PAGE_SIZE_OPTIONS: readonly [5, 10, 20, 50, 100, 500];
+export type PageSizeOption = (typeof PAGE_SIZE_OPTIONS)[number];
+//# sourceMappingURL=page-size-options.d.ts.map

package/dist/lib/page-size-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-size-options.d.ts","sourceRoot":"","sources":["../../src/lib/page-size-options.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,iBAAiB,oCAAqC,CAAC;AAEpE,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/lib/page-size-options.js

@@ -0,0 +1,14 @@
+/**
+ * The page sizes every paginated admin list offers.
+ *
+ * It is a module of its own because the **constant** is design-system and the
+ * **preference** is application state. `usePageSizePreference` reads the signed-in
+ * admin's id to key its `localStorage` entry, so it belongs to the admin application
+ * and stays there (see the package README, *What Phase 1b does not publish*);
+ * `PaginationFooter` only needs the list of numbers to render its dropdown. Splitting
+ * them is what lets the footer be published without dragging the session with it, and
+ * it keeps exactly one list: the admin's hook re-exports these names rather than
+ * declaring a second array the dropdown and the validation could disagree about.
+ */
+export const PAGE_SIZE_OPTIONS = [5, 10, 20, 50, 100, 500];
+//# sourceMappingURL=page-size-options.js.map

package/dist/lib/page-size-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-size-options.js","sourceRoot":"","sources":["../../src/lib/page-size-options.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,CAAU,CAAC"}

package/dist/lib/status-color.d.ts

@@ -0,0 +1,32 @@
+/**
+ * A status badge's colours, computed from the hex an operator picked (feature
+ * 091, batch 8).
+ *
+ * Published out of `admin/src/modules/orders/orderStatusColor.ts`, which
+ * `returns` imported for the return workflow's own status badges —
+ * `backend/scripts/ledgers/cross-module-imports/returns.ts` recorded the reach
+ * and its retiring condition offered two exits, of which this is the first:
+ * *"the helper is generic and moves into the kit"*. It is: two pure functions
+ * over a hex string, with no `orders` vocabulary and no request.
+ *
+ * **Renamed, and the rename is the point.** `orderStatusBadgeStyle` in the kit
+ * would be a kit symbol named after a module, which is R6's rule wearing a
+ * different hat — `returns` calls it about return statuses and `orders` about
+ * order statuses, and the function cannot tell. The old spelling survives at
+ * the old path as a re-export shim, so `orders`' own four call sites are
+ * unchanged.
+ *
+ * `ORDER_STATUS_DEFAULT_COLOR` stays `@endora-commerce/contracts`' and is
+ * imported from there rather than re-exported here: it is the platform's
+ * fallback for an unset colour, both callers already compile that package, and
+ * a second name for one constant is two things that can disagree.
+ */
+import type { CSSProperties } from 'react';
+/**
+ * Black or white text for a given background hex, chosen by perceived
+ * luminance so the status label stays legible on any picked colour.
+ */
+export declare function readableTextColor(hex: string): string;
+/** Inline style for a status badge: solid background + auto-contrast text. */
+export declare function statusBadgeStyle(color: string | null | undefined): CSSProperties;
+//# sourceMappingURL=status-color.d.ts.map

package/dist/lib/status-color.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-color.d.ts","sourceRoot":"","sources":["../../src/lib/status-color.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAS3C;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAQrD;AAED,8EAA8E;AAC9E,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,aAAa,CAGhF"}

package/dist/lib/status-color.js

@@ -0,0 +1,24 @@
+import { ORDER_STATUS_DEFAULT_COLOR } from '@endora-commerce/contracts';
+const HEX = /^#[0-9a-fA-F]{6}$/;
+function normalizeHex(color) {
+    return color && HEX.test(color.trim()) ? color.trim() : ORDER_STATUS_DEFAULT_COLOR;
+}
+/**
+ * Black or white text for a given background hex, chosen by perceived
+ * luminance so the status label stays legible on any picked colour.
+ */
+export function readableTextColor(hex) {
+    const value = normalizeHex(hex).slice(1);
+    const int = Number.parseInt(value, 16);
+    const r = (int >> 16) & 0xff;
+    const g = (int >> 8) & 0xff;
+    const b = int & 0xff;
+    const luminance = (0.299 * r + 0.587 * g + 0.114 * b) / 255;
+    return luminance > 0.6 ? '#1f2937' : '#ffffff';
+}
+/** Inline style for a status badge: solid background + auto-contrast text. */
+export function statusBadgeStyle(color) {
+    const hex = normalizeHex(color);
+    return { backgroundColor: hex, color: readableTextColor(hex), borderColor: 'transparent' };
+}
+//# sourceMappingURL=status-color.js.map

package/dist/lib/status-color.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-color.js","sourceRoot":"","sources":["../../src/lib/status-color.ts"],"names":[],"mappings":"AAwBA,OAAO,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AAExE,MAAM,GAAG,GAAG,mBAAmB,CAAC;AAEhC,SAAS,YAAY,CAAC,KAAgC;IACpD,OAAO,KAAK,IAAI,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,0BAA0B,CAAC;AACrF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAW;IAC3C,MAAM,KAAK,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACzC,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACvC,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;IAC7B,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC;IAC5B,MAAM,CAAC,GAAG,GAAG,GAAG,IAAI,CAAC;IACrB,MAAM,SAAS,GAAG,CAAC,KAAK,GAAG,CAAC,GAAG,KAAK,GAAG,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC;IAC5D,OAAO,SAAS,GAAG,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;AACjD,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,gBAAgB,CAAC,KAAgC;IAC/D,MAAM,GAAG,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IAChC,OAAO,EAAE,eAAe,EAAE,GAAG,EAAE,KAAK,EAAE,iBAAiB,CAAC,GAAG,CAAC,EAAE,WAAW,EAAE,aAAa,EAAE,CAAC;AAC7F,CAAC"}

package/dist/lib/surface-visibility.d.ts

@@ -0,0 +1,70 @@
+/**
+ * One predicate for "may this operator see this destination at all", shared by
+ * every static index the admin renders: the sidebar, the ⌘K palette's Navigate
+ * group and the dashboard's quick actions.
+ *
+ * Issue #230. The three surfaces used to answer the question three times. The
+ * sidebar checked a permission and module presence, the palette checked only
+ * module presence — its item type had no field for a permission, so no amount
+ * of data could have gated it — and the quick-action card checked only module
+ * presence too. The result was a palette that advertised screens the operator's
+ * role cannot open, which Principle XVI item 2 forbids in as many words ("so
+ * the palette never advertises a 403").
+ *
+ * Keeping the predicate here rather than in `AppShell.tsx` is the anti-drift
+ * measure: `HomePage` cannot reach into a component module for it, so a copy is
+ * what it would otherwise have grown, and a copy is what drifts.
+ *
+ * Published by the kit since feature 091's P3, which is what extends that
+ * anti-drift argument to a module **package**: a packaged screen could name
+ * neither this file nor `useAuth`, so its only way to gate a control was to
+ * grow the copy this comment exists to prevent.
+ */
+/**
+ * A permission code, or a set of codes any one of which suffices.
+ *
+ * The array form exists because the routes have it: `/api/v1/admin/organizations`
+ * is gated by `requireAdminAny(['customers:read', 'customers:manage'])`
+ * (`packages/modules/organizations/src/backend/routes.admin.ts:169`). Naming only the
+ * first of those in the UI hides the screen from a role that holds the second —
+ * the failure mode this issue exists to remove, pointed the other way.
+ */
+export type PermissionRequirement = string | readonly string[];
+/**
+ * The gating half of a navigation entry, a palette entry or a quick action.
+ * Each surface's own item type carries its label, icon and route on top of it.
+ */
+export interface GatedSurface {
+    /**
+     * The module that owns the destination, or `null` for a surface the admin
+     * shell owns itself (the dashboard, `/platform/modules`). Feature 073 /
+     * FR-031: presence is resolved from the server's effective enabled-set.
+     */
+    readonly module?: string | null;
+    /**
+     * The permission the destination's own route enforces — read from the route,
+     * never copied from a neighbouring entry. Unset means the destination has no
+     * gate beyond being an authenticated admin.
+     */
+    readonly requiredPermission?: PermissionRequirement;
+}
+/** Whether `hasPermission` satisfies the requirement (any-of for the array form). */
+export declare function satisfiesPermission(requirement: PermissionRequirement | undefined, hasPermission: (code: string) => boolean): boolean;
+/**
+ * The full predicate: permission first, then module presence.
+ *
+ * Both axes **hide** rather than disable. For module presence that was already
+ * the rule (feature 073); extending it to permission is a deliberate choice and
+ * not merely the cheaper branch — see the comment on `PALETTE_ITEMS` in
+ * `AppShell.tsx` for the reasoning and its accessibility consequence.
+ */
+export declare function isSurfaceVisible(surface: GatedSurface, deps: {
+    hasPermission: (code: string) => boolean;
+    isModulePresent: (moduleId: string) => boolean;
+}): boolean;
+/**
+ * Hook form, so the three call sites are one expression each and cannot drift
+ * into three slightly different filters again.
+ */
+export declare function useSurfaceVisibility(): (surface: GatedSurface) => boolean;
+//# sourceMappingURL=surface-visibility.d.ts.map

package/dist/lib/surface-visibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface-visibility.d.ts","sourceRoot":"","sources":["../../src/lib/surface-visibility.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH;;;;;;;;GAQG;AACH,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;AAE/D;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC;;;;OAIG;IACH,QAAQ,CAAC,kBAAkB,CAAC,EAAE,qBAAqB,CAAC;CACrD;AAED,qFAAqF;AACrF,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,qBAAqB,GAAG,SAAS,EAC9C,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,GACvC,OAAO,CAOT;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,YAAY,EACrB,IAAI,EAAE;IACJ,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IACzC,eAAe,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC;CAChD,GACA,OAAO,CAKT;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,CAAC,OAAO,EAAE,YAAY,KAAK,OAAO,CAQzE"}

package/dist/lib/surface-visibility.js

@@ -0,0 +1,37 @@
+import { useCallback } from 'react';
+import { useAuth } from './auth.js';
+import { useModulePresence } from './module-presence/index.js';
+/** Whether `hasPermission` satisfies the requirement (any-of for the array form). */
+export function satisfiesPermission(requirement, hasPermission) {
+    if (requirement === undefined)
+        return true;
+    if (typeof requirement === 'string')
+        return hasPermission(requirement);
+    // An empty array would mean "no code can satisfy this", which is never what
+    // an author means; treat it as ungated rather than silently hiding a screen.
+    if (requirement.length === 0)
+        return true;
+    return requirement.some((code) => hasPermission(code));
+}
+/**
+ * The full predicate: permission first, then module presence.
+ *
+ * Both axes **hide** rather than disable. For module presence that was already
+ * the rule (feature 073); extending it to permission is a deliberate choice and
+ * not merely the cheaper branch — see the comment on `PALETTE_ITEMS` in
+ * `AppShell.tsx` for the reasoning and its accessibility consequence.
+ */
+export function isSurfaceVisible(surface, deps) {
+    return (satisfiesPermission(surface.requiredPermission, deps.hasPermission) &&
+        (surface.module == null || deps.isModulePresent(surface.module)));
+}
+/**
+ * Hook form, so the three call sites are one expression each and cannot drift
+ * into three slightly different filters again.
+ */
+export function useSurfaceVisibility() {
+    const { hasPermission } = useAuth();
+    const { isPresent } = useModulePresence();
+    return useCallback((surface) => isSurfaceVisible(surface, { hasPermission, isModulePresent: isPresent }), [hasPermission, isPresent]);
+}
+//# sourceMappingURL=surface-visibility.js.map

package/dist/lib/surface-visibility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface-visibility.js","sourceRoot":"","sources":["../../src/lib/surface-visibility.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAuD/D,qFAAqF;AACrF,MAAM,UAAU,mBAAmB,CACjC,WAA8C,EAC9C,aAAwC;IAExC,IAAI,WAAW,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAC3C,IAAI,OAAO,WAAW,KAAK,QAAQ;QAAE,OAAO,aAAa,CAAC,WAAW,CAAC,CAAC;IACvE,4EAA4E;IAC5E,6EAA6E;IAC7E,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1C,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC;AACzD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAC9B,OAAqB,EACrB,IAGC;IAED,OAAO,CACL,mBAAmB,CAAC,OAAO,CAAC,kBAAkB,EAAE,IAAI,CAAC,aAAa,CAAC;QACnE,CAAC,OAAO,CAAC,MAAM,IAAI,IAAI,IAAI,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CACjE,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB;IAClC,MAAM,EAAE,aAAa,EAAE,GAAG,OAAO,EAAE,CAAC;IACpC,MAAM,EAAE,SAAS,EAAE,GAAG,iBAAiB,EAAE,CAAC;IAC1C,OAAO,WAAW,CAChB,CAAC,OAAqB,EAAW,EAAE,CACjC,gBAAgB,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,eAAe,EAAE,SAAS,EAAE,CAAC,EAC1E,CAAC,aAAa,EAAE,SAAS,CAAC,CAC3B,CAAC;AACJ,CAAC"}

package/dist/lib/text-normalization.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Fold a string so two spellings of the same word compare equal.
+ *
+ * **This is a general text utility, not palette machinery.** It lived under
+ * `lib/admin-actions/` until issue #236, which under-sold it as one consumer's
+ * private helper and invited the next author to write their own: by then the
+ * page-builder drawer, the combobox and the multi-select had each grown a copy
+ * that looked right and was not. The admin has two kinds of caller, and both
+ * need the same fold:
+ *
+ *  - **search predicates** — the ⌘K palette, the page-builder drawer, the
+ *    combobox / multi-select pickers, the category tree filter. Fold both the
+ *    query and the haystack, then `includes`.
+ *  - **slug and code generators** — `PageEditor`, `BlockEditor`,
+ *    `BlogPostEditor`. Fold first, then collapse whatever is left to `-` / `_`.
+ *
+ * **The fold itself is not written here.** Since issue #240 it is
+ * `foldDiacritics` from `@endora-commerce/contracts` — the same implementation the backend
+ * writes `organizations.name_search` with. This file had grown its own copy of
+ * the map for the same reason the four private copies grew: the shared one was
+ * correct but named after a single caller (`normalizeOrganizationName`), so
+ * nobody looking for a diacritic fold found it. What is left here is the one
+ * thing that is genuinely the admin's policy: the trim.
+ *
+ * What `foldDiacritics` does, in order: decompose (NFD), strip the combining
+ * marks, map the letters NFD leaves standing (`Ł ł Ø ø Đ đ Ð ð Þ þ ß Æ æ Œ œ`),
+ * lowercase. Step three is the one the obvious
+ * `normalize('NFD').replace(/\p{Diacritic}/gu, '')` one-liner is missing, and
+ * without it the fold silently does nothing to every Polish word carrying an
+ * `ł` (`płatności`, `Nagłówek`).
+ *
+ * Then, here: **trim.** Surrounding whitespace is noise in every caller — a
+ * search query with a leading space matched nothing at all before this step
+ * existed (Postel's Law — accept what was typed), and a slug generator strips
+ * its own edge separators anyway. Trimming here means no caller has to
+ * remember; four of the six had not. The shared fold deliberately leaves
+ * whitespace alone, because what counts as one space differs by caller:
+ * `normalizeOrganizationName` also collapses internal runs, since it writes a
+ * column a `$like` reads.
+ *
+ * Edge cases worth knowing:
+ * - `ß` folds to `ss` and `æ`/`œ` to `ae`/`oe`. The private copy this file
+ *   carried until issue #240 left all three standing; adopting the shared map
+ *   changed 19 code points in total, 15 of them this way. The other four are
+ *   `Ħ ħ Ŧ ŧ` (Maltese, Northern Sami), which the private map folded to `h`/`t`
+ *   and the shared one leaves alone. They are **not** silently re-added here:
+ *   the shared map is the one the backend writes a persisted search column
+ *   with, so growing it re-folds new rows differently from old ones — a data
+ *   migration (issue #240's report names it), not a line in this file.
+ * - Matching behaves like a case-insensitive substring test, not full Unicode
+ *   case folding.
+ * - A whitespace-only string folds to the empty string, so callers that treat
+ *   an empty query as "match everything" get that for free.
+ */
+export declare function normalize(input: string): string;
+//# sourceMappingURL=text-normalization.d.ts.map

package/dist/lib/text-normalization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-normalization.d.ts","sourceRoot":"","sources":["../../src/lib/text-normalization.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/C"}