@endora-commerce/mod-orders 0.0.0-stage → 0.100.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Endora sp. z o.o. and the Endora Commerce contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,67 @@
-# Temporary Holding Version
+<!-- Generated by `pnpm --filter backend run manifests:generate`. Delete this line to take the file over; a README without it is never regenerated. -->
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# @endora-commerce/mod-orders
+
+Order placement, lifecycle, and history.
+
+## What this is
+
+An **Endora Commerce module package**. Its module id is `orders` — the identity of record in the platform's registries, in its migrations and in its setting, permission and translation codes.
+
+A module is not imported by application code. The platform discovers the extension packages an instance has installed, reads the manifest on the root subpath and composes the module from it, so installing this package and starting the instance is the whole integration.
+
+## Entry points
+
+| Import | Contents |
+| --- | --- |
+| `@endora-commerce/mod-orders` | the module manifest — its id, version, dependencies, settings and activation |
+| `@endora-commerce/mod-orders/admin` | the Admin UI contribution: the screens, navigation and palette actions it adds |
+| `@endora-commerce/mod-orders/backend` | the composition root the platform calls, with the entities, services, routes and workers it registers |
+| `@endora-commerce/mod-orders/migrations` | the module’s own schema migrations, in the order the platform runs them |
+| `@endora-commerce/mod-orders/ports` | type-only — the port interfaces other modules resolve this one through |
+| `@endora-commerce/mod-orders/tailwind.css` | the Tailwind source declaration for the admin code above |
+
+## Depends on
+
+Everything below is a **peer** dependency, so the application resolves exactly one copy of each — two copies of a host or of React are a runtime failure rather than a type error. An entry marked *optional* is needed only by the layers that use it.
+
+**Endora packages**
+
+- `@endora-commerce/admin-kit` — *optional*
+- `@endora-commerce/contracts`
+- `@endora-commerce/email-components`
+- `@endora-commerce/mod-carts`
+- `@endora-commerce/mod-credit-limits`
+- `@endora-commerce/mod-inventory`
+- `@endora-commerce/mod-invoices`
+- `@endora-commerce/mod-promotions`
+- `@endora-commerce/platform`
+
+**Third-party**
+
+- `@mikro-orm/core` ^6
+- `@mikro-orm/migrations` ^6
+- `@mikro-orm/postgresql` ^6
+- `fastify` ^5
+- `ioredis` ^5
+- `lucide-react` ^1 — *optional*
+- `react` ^19 — *optional*
+- `react-router-dom` ^7 — *optional*
+- `zod` ^4
+
+## What the tarball carries
+
+- `dist/` — the compiled JavaScript and its type declarations
+- `i18n/` — the translation bundles this package ships (`en`, `pl`), loaded by the platform
+- `docs/` — the package’s own pages in the Endora Commerce documentation site
+- `tailwind.css` — the Tailwind source declaration
+
+## Install
+
+```bash
+pnpm add @endora-commerce/mod-orders
+```
+
+## Licence
+
+MIT — the text is in `LICENSE`, beside this file.

package/dist/admin/components/OrderSavedViews.d.ts

@@ -0,0 +1,23 @@
+import { type ReactNode } from 'react';
+export interface SavedViewState {
+    filters: Record<string, unknown>;
+    sort: {
+        field: string;
+        dir: 'asc' | 'desc';
+    };
+    /** Column-picker selection; `null`/absent ⇒ the list falls back to defaults. */
+    visibleColumns?: string[] | null;
+}
+interface Props {
+    current: SavedViewState;
+    onLoad: (view: SavedViewState) => void;
+    onError: (message: string) => void;
+}
+/**
+ * Feature 038 (US2) — saved orders-list views. Lists the caller's own views
+ * plus shared ones, loads a view's filters/sort, and saves/deletes views
+ * (optionally shared with everyone who can access the list).
+ */
+export declare function OrderSavedViews({ current, onLoad, onError }: Props): ReactNode;
+export {};
+//# sourceMappingURL=OrderSavedViews.d.ts.map

package/dist/admin/components/OrderSavedViews.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OrderSavedViews.d.ts","sourceRoot":"","sources":["../../../src/admin/components/OrderSavedViews.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAoC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAMzE,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,KAAK,GAAG,MAAM,CAAA;KAAE,CAAC;IAC7C,gFAAgF;IAChF,cAAc,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;CAClC;AAQD,UAAU,KAAK;IACb,OAAO,EAAE,cAAc,CAAC;IACxB,MAAM,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,IAAI,CAAC;IACvC,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACpC;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,KAAK,GAAG,SAAS,CAsF9E"}

package/dist/admin/components/OrderSavedViews.js

@@ -0,0 +1,68 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useCallback, useEffect, useState } from 'react';
+import { Save, Trash2 } from 'lucide-react';
+import { ApiError, apiClient } from '@endora-commerce/admin-kit/lib';
+import { Button, Select } from '@endora-commerce/admin-kit/ui';
+import { useTranslation } from '@endora-commerce/admin-kit/i18n';
+/**
+ * Feature 038 (US2) — saved orders-list views. Lists the caller's own views
+ * plus shared ones, loads a view's filters/sort, and saves/deletes views
+ * (optionally shared with everyone who can access the list).
+ */
+export function OrderSavedViews({ current, onLoad, onError }) {
+    const t = useTranslation('core');
+    const [views, setViews] = useState([]);
+    const [selectedId, setSelectedId] = useState('');
+    const load = useCallback(async () => {
+        try {
+            const res = await apiClient.get('/api/v1/admin/orders/list-views');
+            setViews(res.data);
+        }
+        catch (err) {
+            onError(err instanceof ApiError ? err.envelope.error.message : 'Failed to load views.');
+        }
+    }, [onError]);
+    useEffect(() => {
+        void load();
+    }, [load]);
+    const handleLoad = (id) => {
+        setSelectedId(id);
+        const view = views.find((v) => v.id === id);
+        if (view) {
+            onLoad({ filters: view.filters, sort: view.sort, visibleColumns: view.visibleColumns ?? null });
+        }
+    };
+    const save = async () => {
+        const name = window.prompt(t('orders.views.namePrompt'));
+        if (!name)
+            return;
+        const shared = window.confirm(t('orders.views.sharedPrompt'));
+        try {
+            await apiClient.post('/api/v1/admin/orders/list-views', {
+                name,
+                shared,
+                filters: current.filters,
+                sort: current.sort,
+                visibleColumns: current.visibleColumns ?? null,
+            });
+            await load();
+        }
+        catch (err) {
+            onError(err instanceof ApiError ? err.envelope.error.message : 'Failed to save view.');
+        }
+    };
+    const remove = async () => {
+        if (!selectedId)
+            return;
+        try {
+            await apiClient.delete(`/api/v1/admin/orders/list-views/${selectedId}`);
+            setSelectedId('');
+            await load();
+        }
+        catch (err) {
+            onError(err instanceof ApiError ? err.envelope.error.message : 'Failed to delete view.');
+        }
+    };
+    return (_jsxs("div", { className: "flex items-center gap-2", children: [_jsxs(Select, { id: "saved-views", "aria-label": t('orders.views.label'), value: selectedId, onChange: (e) => handleLoad(e.target.value), children: [_jsx("option", { value: "", children: t('orders.views.none') }), views.map((v) => (_jsxs("option", { value: v.id, children: [v.name, v.shared ? ' ★' : ''] }, v.id)))] }), _jsx(Button, { type: "button", variant: "outline", size: "sm", "aria-label": "save-view", onClick: () => void save(), children: _jsx(Save, {}) }), _jsx(Button, { type: "button", variant: "ghost", size: "sm", "aria-label": "delete-view", disabled: !selectedId, onClick: () => void remove(), children: _jsx(Trash2, {}) })] }));
+}
+//# sourceMappingURL=OrderSavedViews.js.map

package/dist/admin/components/OrderSavedViews.js.map

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

package/dist/admin/components/OrderShipmentsTab.d.ts

@@ -0,0 +1,36 @@
+import { type ReactNode } from 'react';
+/**
+ * Delivery tab — lists the shipment generation attempts tied to an order
+ * (`GET /api/v1/admin/orders/:id/shipments`). A new attempt is appended on
+ * each retry, so the most recent attempt has the highest `attemptNo`.
+ *
+ * ## What P7d took out of it (feature 091, §10.4)
+ *
+ * Two carriers' affordances, which this file rendered itself. `inpost` was
+ * named three ways — a `useSurfaceVisibility` gate, a `useTranslation`
+ * namespace and a `providerDetails.provider` comparison — the first two being
+ * the pair of `foreign-module-ids` keys this conversion retires. The other
+ * carrier was named by its two **delivery-method codes** rather than by its
+ * module id, so no ledger and no check ever saw it; its three buttons carried
+ * no permission gate at all while the routes behind them enforce a read and a
+ * write code. Neither carrier's name is written in this file any more, in any
+ * spelling — `OrderShipmentsTab.carrier-zones.test.tsx` asserts that, so the
+ * codes are deliberately not quoted here either.
+ *
+ * Both carriers left together, which is what `api/carrier-documents-client.ts`
+ * ruled in its own header before it was deleted with them: *"both carriers are
+ * one shipment tab reaching two adapters … a repair naming one is a repair that
+ * has not understood the shape"*.
+ *
+ * Two zones stand in their place. `order.shipment.row.actions` is mounted once
+ * per attempt and carries that attempt's `providerCode` and `status`;
+ * `order.shipments.tab.actions` is mounted once in the footer bar and carries
+ * the order's delivery-method code and its latest attempt. What this file keeps
+ * knowing is that a shipment row may have an action and that the tab has a
+ * footer bar; what it stops knowing is which carrier fills either.
+ */
+export declare function OrderShipmentsTab(props: {
+    orderId: string;
+    deliveryMethodCode: string;
+}): ReactNode;
+//# sourceMappingURL=OrderShipmentsTab.d.ts.map

package/dist/admin/components/OrderShipmentsTab.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OrderShipmentsTab.d.ts","sourceRoot":"","sources":["../../../src/admin/components/OrderShipmentsTab.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA6C,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAyDlF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB,EAAE,MAAM,CAAC;CAC5B,GAAG,SAAS,CAmMZ"}

package/dist/admin/components/OrderShipmentsTab.js

@@ -0,0 +1,158 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useCallback, useEffect, useMemo, useState } from 'react';
+import { PackageX } from 'lucide-react';
+import { ApiError, apiClient, formatDateTime, useSurfaceVisibility } from '@endora-commerce/admin-kit/lib';
+import { Alert, AlertDescription, AlertTitle, Badge, Button, Table, TableBody, TableCell, TableHead, TableHeader, TableRow, Section } from '@endora-commerce/admin-kit/ui';
+import { useTranslation } from '@endora-commerce/admin-kit/i18n';
+import { AdminZone, selectZoneContributions, useAdminContributions } from '@endora-commerce/admin-kit/zones';
+const STATUS_VARIANT = {
+    pending: 'warning',
+    // Its own variant, not `warning`: a `pending` shipment is waiting for a
+    // carrier that knows about it, and a `pending_manual` one is waiting for a
+    // person. Two rows that read the same are the defect this state exists to
+    // remove (issue #250).
+    pending_manual: 'destructive',
+    success: 'success',
+    failure: 'destructive',
+};
+/** The most recent attempt — the only one an operator can still act on. */
+function latestAttempt(rows) {
+    return rows.reduce((best, row) => (best === undefined || row.attemptNo > best.attemptNo ? row : best), undefined);
+}
+/**
+ * Which carrier opened this attempt, from the adapter's own envelope.
+ *
+ * A **provider code**, not a module id: it is a string the adapter deposited,
+ * and it is `null` for an attempt no carrier ever answered — the fail-closed
+ * value, which no contribution's `match` agrees with.
+ */
+function providerCodeOf(row) {
+    const provider = row.providerDetails?.['provider'];
+    return typeof provider === 'string' ? provider : null;
+}
+/**
+ * Delivery tab — lists the shipment generation attempts tied to an order
+ * (`GET /api/v1/admin/orders/:id/shipments`). A new attempt is appended on
+ * each retry, so the most recent attempt has the highest `attemptNo`.
+ *
+ * ## What P7d took out of it (feature 091, §10.4)
+ *
+ * Two carriers' affordances, which this file rendered itself. `inpost` was
+ * named three ways — a `useSurfaceVisibility` gate, a `useTranslation`
+ * namespace and a `providerDetails.provider` comparison — the first two being
+ * the pair of `foreign-module-ids` keys this conversion retires. The other
+ * carrier was named by its two **delivery-method codes** rather than by its
+ * module id, so no ledger and no check ever saw it; its three buttons carried
+ * no permission gate at all while the routes behind them enforce a read and a
+ * write code. Neither carrier's name is written in this file any more, in any
+ * spelling — `OrderShipmentsTab.carrier-zones.test.tsx` asserts that, so the
+ * codes are deliberately not quoted here either.
+ *
+ * Both carriers left together, which is what `api/carrier-documents-client.ts`
+ * ruled in its own header before it was deleted with them: *"both carriers are
+ * one shipment tab reaching two adapters … a repair naming one is a repair that
+ * has not understood the shape"*.
+ *
+ * Two zones stand in their place. `order.shipment.row.actions` is mounted once
+ * per attempt and carries that attempt's `providerCode` and `status`;
+ * `order.shipments.tab.actions` is mounted once in the footer bar and carries
+ * the order's delivery-method code and its latest attempt. What this file keeps
+ * knowing is that a shipment row may have an action and that the tab has a
+ * footer bar; what it stops knowing is which carrier fills either.
+ */
+export function OrderShipmentsTab(props) {
+    const t = useTranslation('core');
+    const [rows, setRows] = useState([]);
+    const [loading, setLoading] = useState(true);
+    const [loadError, setLoadError] = useState(false);
+    const [actionError, setActionError] = useState(null);
+    const [regenerating, setRegenerating] = useState(false);
+    const [reloadToken, setReloadToken] = useState(0);
+    /**
+     * Whether the attempts table needs its action column at all.
+     *
+     * `useAdminZone` is a hook, so it cannot be asked once per row;
+     * `selectZoneContributions` is the pure function that hook is a `useMemo`
+     * over, and the kit publishes it for exactly this. Asking it per row is the
+     * honest question — *"will any row show an action"* — and strictly narrower
+     * than the answer this file gave before, which was one carrier's presence
+     * and permission with no reference to the rows at all.
+     */
+    const contributions = useAdminContributions();
+    const isVisible = useSurfaceVisibility();
+    const showRowActions = useMemo(() => rows.some((row) => selectZoneContributions(contributions, 'order.shipment.row.actions', {
+        orderId: props.orderId,
+        shipmentId: row.id,
+        deliveryMethodCode: props.deliveryMethodCode,
+        providerCode: providerCodeOf(row),
+        status: row.status,
+    }, isVisible).length > 0), [rows, contributions, isVisible, props.orderId, props.deliveryMethodCode]);
+    useEffect(() => {
+        let alive = true;
+        setLoading(true);
+        setLoadError(false);
+        void apiClient
+            .get(`/api/v1/admin/orders/${props.orderId}/shipments`)
+            .then((res) => {
+            if (alive)
+                setRows(res.data);
+        })
+            .catch(() => {
+            if (!alive)
+                return;
+            setLoadError(true);
+            setRows([]);
+        })
+            .finally(() => {
+            if (alive)
+                setLoading(false);
+        });
+        return () => {
+            alive = false;
+        };
+    }, [props.orderId, reloadToken]);
+    /**
+     * The recovery path, and it is the *generate* endpoint rather than the retry
+     * one on purpose: opening a retry attempt does not contact the carrier, and
+     * a second row nobody asked for would be the same silence again. Generating
+     * appends a new attempt and asks the adapter, which is exactly what has to
+     * happen once the operator has switched the module back on.
+     */
+    const generateAgain = useCallback(() => {
+        setRegenerating(true);
+        setActionError(null);
+        void apiClient
+            .post(`/api/v1/admin/orders/${props.orderId}/shipments`, {})
+            .then(() => {
+            setReloadToken((token) => token + 1);
+        })
+            .catch((err) => {
+            setActionError(err instanceof ApiError
+                ? err.envelope.error.message
+                : t('orderDetail.shipments.generate.error'));
+        })
+            .finally(() => {
+            setRegenerating(false);
+        });
+    }, [props.orderId, t]);
+    const stalled = latestAttempt(rows)?.status === 'pending_manual' ? latestAttempt(rows) : undefined;
+    const latest = latestAttempt(rows);
+    const canGenerate = rows.length === 0 || latest?.status === 'failure' || latest?.status === 'pending_manual';
+    return (_jsx(Section, { title: t('orderDetail.shipments.title'), children: loading ? (_jsx("p", { className: "text-sm text-muted-foreground", children: t('common.state.loading') })) : loadError ? (_jsx("p", { className: "text-sm text-destructive", children: t('common.state.error') })) : (_jsxs(_Fragment, { children: [actionError ? (_jsx(Alert, { variant: "destructive", className: "mb-4", children: _jsx(AlertDescription, { children: actionError }) })) : null, rows.length === 0 ? (_jsx("p", { className: "mb-4 text-sm text-muted-foreground", children: t('orderDetail.shipments.empty') })) : null, stalled ? (_jsxs(Alert, { variant: "destructive", className: "mb-4", children: [_jsx(PackageX, { "aria-hidden": "true" }), _jsx(AlertTitle, { children: t('orderDetail.shipments.carrierNotContacted.title') }), _jsxs(AlertDescription, { children: [_jsx("p", { children: t('orderDetail.shipments.carrierNotContacted.body') }), stalled.failureReason ? (_jsx("p", { className: "mt-1 text-xs opacity-80", children: stalled.failureReason })) : null] })] })) : null, rows.length > 0 ? (_jsxs(Table, { children: [_jsx(TableHeader, { children: _jsxs(TableRow, { children: [_jsx(TableHead, { children: t('orderDetail.shipments.columns.attempt') }), _jsx(TableHead, { children: t('orderDetail.shipments.columns.status') }), _jsx(TableHead, { children: t('orderDetail.shipments.columns.tracking') }), _jsx(TableHead, { children: t('orderDetail.shipments.columns.createdAt') }), _jsx(TableHead, { children: t('orderDetail.shipments.columns.failure') }), showRowActions ? _jsx(TableHead, {}) : null] }) }), _jsx(TableBody, { children: rows.map((s) => (_jsxs(TableRow, { children: [_jsxs(TableCell, { children: ["#", s.attemptNo] }), _jsx(TableCell, { children: _jsx(Badge, { variant: STATUS_VARIANT[s.status], children: t(`orderDetail.shipments.status.${s.status}`) }) }), _jsx(TableCell, { className: "font-mono text-xs", children: s.externalReference ?? '—' }), _jsx(TableCell, { children: formatDateTime(s.createdAt) }), _jsx(TableCell, { className: "text-destructive", children: s.failureReason ?? '' }), showRowActions ? (_jsx(TableCell, { children: _jsx(AdminZone, { name: "order.shipment.row.actions", props: {
+                                                orderId: props.orderId,
+                                                shipmentId: s.id,
+                                                deliveryMethodCode: props.deliveryMethodCode,
+                                                providerCode: providerCodeOf(s),
+                                                status: s.status,
+                                            } }) })) : null] }, s.id))) })] })) : null, _jsxs("div", { className: "mt-4 flex flex-wrap gap-2", children: [canGenerate ? (_jsx(Button, { size: "sm", disabled: regenerating, onClick: generateAgain, children: regenerating
+                                ? t('orderDetail.shipments.generate.busy')
+                                : rows.length === 0
+                                    ? t('orderDetail.shipments.generate')
+                                    : t('orderDetail.shipments.generate.again') })) : null, _jsx(AdminZone, { name: "order.shipments.tab.actions", props: {
+                                orderId: props.orderId,
+                                deliveryMethodCode: props.deliveryMethodCode,
+                                latestShipmentId: latest?.id ?? null,
+                                latestStatus: latest?.status ?? null,
+                            } })] })] })) }));
+}
+//# sourceMappingURL=OrderShipmentsTab.js.map

package/dist/admin/components/OrderShipmentsTab.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OrderShipmentsTab.js","sourceRoot":"","sources":["../../../src/admin/components/OrderShipmentsTab.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAkB,MAAM,OAAO,CAAC;AAClF,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAExC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAC3G,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AAE3K,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,EAAE,SAAS,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAmB7G,MAAM,cAAc,GAAyD;IAC3E,OAAO,EAAE,SAAS;IAClB,wEAAwE;IACxE,2EAA2E;IAC3E,0EAA0E;IAC1E,uBAAuB;IACvB,cAAc,EAAE,aAAa;IAC7B,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,aAAa;CACvB,CAAC;AAEF,2EAA2E;AAC3E,SAAS,aAAa,CAAC,IAA4B;IACjD,OAAO,IAAI,CAAC,MAAM,CAChB,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,IAAI,KAAK,SAAS,IAAI,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAClF,SAAS,CACV,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,SAAS,cAAc,CAAC,GAAgB;IACtC,MAAM,QAAQ,GAAG,GAAG,CAAC,eAAe,EAAE,CAAC,UAAU,CAAC,CAAC;IACnD,OAAO,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;AACxD,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAGjC;IACC,MAAM,CAAC,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IACjC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAgB,EAAE,CAAC,CAAC;IACpD,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAClD,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,GAAG,QAAQ,CAAgB,IAAI,CAAC,CAAC;IACpE,MAAM,CAAC,YAAY,EAAE,eAAe,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IACxD,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAElD;;;;;;;;;OASG;IACH,MAAM,aAAa,GAAG,qBAAqB,EAAE,CAAC;IAC9C,MAAM,SAAS,GAAG,oBAAoB,EAAE,CAAC;IACzC,MAAM,cAAc,GAAG,OAAO,CAC5B,GAAG,EAAE,CACH,IAAI,CAAC,IAAI,CACP,CAAC,GAAG,EAAE,EAAE,CACN,uBAAuB,CACrB,aAAa,EACb,4BAA4B,EAC5B;QACE,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,UAAU,EAAE,GAAG,CAAC,EAAE;QAClB,kBAAkB,EAAE,KAAK,CAAC,kBAAkB;QAC5C,YAAY,EAAE,cAAc,CAAC,GAAG,CAAC;QACjC,MAAM,EAAE,GAAG,CAAC,MAAM;KACnB,EACD,SAAS,CACV,CAAC,MAAM,GAAG,CAAC,CACf,EACH,CAAC,IAAI,EAAE,aAAa,EAAE,SAAS,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,kBAAkB,CAAC,CAC1E,CAAC;IAEF,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,KAAK,GAAG,IAAI,CAAC;QACjB,UAAU,CAAC,IAAI,CAAC,CAAC;QACjB,YAAY,CAAC,KAAK,CAAC,CAAC;QACpB,KAAK,SAAS;aACX,GAAG,CAA0B,wBAAwB,KAAK,CAAC,OAAO,YAAY,CAAC;aAC/E,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE;YACZ,IAAI,KAAK;gBAAE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC/B,CAAC,CAAC;aACD,KAAK,CAAC,GAAG,EAAE;YACV,IAAI,CAAC,KAAK;gBAAE,OAAO;YACnB,YAAY,CAAC,IAAI,CAAC,CAAC;YACnB,OAAO,CAAC,EAAE,CAAC,CAAC;QACd,CAAC,CAAC;aACD,OAAO,CAAC,GAAG,EAAE;YACZ,IAAI,KAAK;gBAAE,UAAU,CAAC,KAAK,CAAC,CAAC;QAC/B,CAAC,CAAC,CAAC;QACL,OAAO,GAAS,EAAE;YAChB,KAAK,GAAG,KAAK,CAAC;QAChB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC;IAEjC;;;;;;OAMG;IACH,MAAM,aAAa,GAAG,WAAW,CAAC,GAAG,EAAE;QACrC,eAAe,CAAC,IAAI,CAAC,CAAC;QACtB,cAAc,CAAC,IAAI,CAAC,CAAC;QACrB,KAAK,SAAS;aACX,IAAI,CAAC,wBAAwB,KAAK,CAAC,OAAO,YAAY,EAAE,EAAE,CAAC;aAC3D,IAAI,CAAC,GAAG,EAAE;YACT,cAAc,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QACvC,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;YACtB,cAAc,CACZ,GAAG,YAAY,QAAQ;gBACrB,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO;gBAC5B,CAAC,CAAC,CAAC,CAAC,sCAAsC,CAAC,CAC9C,CAAC;QACJ,CAAC,CAAC;aACD,OAAO,CAAC,GAAG,EAAE;YACZ,eAAe,CAAC,KAAK,CAAC,CAAC;QACzB,CAAC,CAAC,CAAC;IACP,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;IAEvB,MAAM,OAAO,GACX,aAAa,CAAC,IAAI,CAAC,EAAE,MAAM,KAAK,gBAAgB,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACrF,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,WAAW,GACf,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,EAAE,MAAM,KAAK,SAAS,IAAI,MAAM,EAAE,MAAM,KAAK,gBAAgB,CAAC;IAE3F,OAAO,CACL,KAAC,OAAO,IAAC,KAAK,EAAE,CAAC,CAAC,6BAA6B,CAAC,YAC7C,OAAO,CAAC,CAAC,CAAC,CACT,YAAG,SAAS,EAAC,+BAA+B,YAAE,CAAC,CAAC,sBAAsB,CAAC,GAAK,CAC7E,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CACd,YAAG,SAAS,EAAC,0BAA0B,YAAE,CAAC,CAAC,oBAAoB,CAAC,GAAK,CACtE,CAAC,CAAC,CAAC,CACF,8BACG,WAAW,CAAC,CAAC,CAAC,CACb,KAAC,KAAK,IAAC,OAAO,EAAC,aAAa,EAAC,SAAS,EAAC,MAAM,YAC3C,KAAC,gBAAgB,cAAE,WAAW,GAAoB,GAC5C,CACT,CAAC,CAAC,CAAC,IAAI,EACP,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CACnB,YAAG,SAAS,EAAC,oCAAoC,YAAE,CAAC,CAAC,6BAA6B,CAAC,GAAK,CACzF,CAAC,CAAC,CAAC,IAAI,EACP,OAAO,CAAC,CAAC,CAAC,CACT,MAAC,KAAK,IAAC,OAAO,EAAC,aAAa,EAAC,SAAS,EAAC,MAAM,aAC3C,KAAC,QAAQ,mBAAa,MAAM,GAAG,EAC/B,KAAC,UAAU,cAAE,CAAC,CAAC,iDAAiD,CAAC,GAAc,EAC/E,MAAC,gBAAgB,eACf,sBAAI,CAAC,CAAC,gDAAgD,CAAC,GAAK,EAC3D,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CACvB,YAAG,SAAS,EAAC,yBAAyB,YAAE,OAAO,CAAC,aAAa,GAAK,CACnE,CAAC,CAAC,CAAC,IAAI,IACS,IACb,CACT,CAAC,CAAC,CAAC,IAAI,EACP,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CACjB,MAAC,KAAK,eACJ,KAAC,WAAW,cACV,MAAC,QAAQ,eACP,KAAC,SAAS,cAAE,CAAC,CAAC,uCAAuC,CAAC,GAAa,EACnE,KAAC,SAAS,cAAE,CAAC,CAAC,sCAAsC,CAAC,GAAa,EAClE,KAAC,SAAS,cAAE,CAAC,CAAC,wCAAwC,CAAC,GAAa,EACpE,KAAC,SAAS,cAAE,CAAC,CAAC,yCAAyC,CAAC,GAAa,EACrE,KAAC,SAAS,cAAE,CAAC,CAAC,uCAAuC,CAAC,GAAa,EAClE,cAAc,CAAC,CAAC,CAAC,KAAC,SAAS,KAAG,CAAC,CAAC,CAAC,IAAI,IAC7B,GACC,EACd,KAAC,SAAS,cACP,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CACf,MAAC,QAAQ,eACP,MAAC,SAAS,oBAAG,CAAC,CAAC,SAAS,IAAa,EACrC,KAAC,SAAS,cACR,KAAC,KAAK,IAAC,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC,YACrC,CAAC,CAAC,gCAAgC,CAAC,CAAC,MAAM,EAAE,CAAC,GACxC,GACE,EACZ,KAAC,SAAS,IAAC,SAAS,EAAC,mBAAmB,YAAE,CAAC,CAAC,iBAAiB,IAAI,GAAG,GAAa,EACjF,KAAC,SAAS,cAAE,cAAc,CAAC,CAAC,CAAC,SAAS,CAAC,GAAa,EACpD,KAAC,SAAS,IAAC,SAAS,EAAC,kBAAkB,YAAE,CAAC,CAAC,aAAa,IAAI,EAAE,GAAa,EAC1E,cAAc,CAAC,CAAC,CAAC,CAChB,KAAC,SAAS,cACR,KAAC,SAAS,IACR,IAAI,EAAC,4BAA4B,EACjC,KAAK,EAAE;gDACL,OAAO,EAAE,KAAK,CAAC,OAAO;gDACtB,UAAU,EAAE,CAAC,CAAC,EAAE;gDAChB,kBAAkB,EAAE,KAAK,CAAC,kBAAkB;gDAC5C,YAAY,EAAE,cAAc,CAAC,CAAC,CAAC;gDAC/B,MAAM,EAAE,CAAC,CAAC,MAAM;6CACjB,GACD,GACQ,CACb,CAAC,CAAC,CAAC,IAAI,KAvBK,CAAC,CAAC,EAAE,CAwBR,CACZ,CAAC,GACQ,IACN,CACT,CAAC,CAAC,CAAC,IAAI,EACR,eAAK,SAAS,EAAC,2BAA2B,aACvC,WAAW,CAAC,CAAC,CAAC,CACb,KAAC,MAAM,IAAC,IAAI,EAAC,IAAI,EAAC,QAAQ,EAAE,YAAY,EAAE,OAAO,EAAE,aAAa,YAC7D,YAAY;gCACX,CAAC,CAAC,CAAC,CAAC,qCAAqC,CAAC;gCAC1C,CAAC,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC;oCACjB,CAAC,CAAC,CAAC,CAAC,gCAAgC,CAAC;oCACrC,CAAC,CAAC,CAAC,CAAC,sCAAsC,CAAC,GACxC,CACV,CAAC,CAAC,CAAC,IAAI,EAKR,KAAC,SAAS,IACR,IAAI,EAAC,6BAA6B,EAClC,KAAK,EAAE;gCACL,OAAO,EAAE,KAAK,CAAC,OAAO;gCACtB,kBAAkB,EAAE,KAAK,CAAC,kBAAkB;gCAC5C,gBAAgB,EAAE,MAAM,EAAE,EAAE,IAAI,IAAI;gCACpC,YAAY,EAAE,MAAM,EAAE,MAAM,IAAI,IAAI;6BACrC,GACD,IACE,IACL,CACJ,GACO,CACX,CAAC;AACJ,CAAC"}

package/dist/admin/components/OrdersBulkStatusDialog.d.ts

@@ -0,0 +1,24 @@
+import { type ReactNode } from 'react';
+interface StatusDef {
+    code: string;
+    name: Record<string, string>;
+}
+export interface BulkStatusSummary {
+    changed: number;
+    skipped: number;
+}
+interface Props {
+    open: boolean;
+    orderIds: string[];
+    statuses: StatusDef[];
+    onClose: () => void;
+    onDone: (summary: BulkStatusSummary) => void;
+}
+/**
+ * Feature 038 (US2) — bulk order status change. Applies the chosen target to
+ * every selected order; the server moves only the eligible ones and reports
+ * the rest as skipped (with reasons).
+ */
+export declare function OrdersBulkStatusDialog({ open, orderIds, statuses, onClose, onDone }: Props): ReactNode;
+export {};
+//# sourceMappingURL=OrdersBulkStatusDialog.d.ts.map

package/dist/admin/components/OrdersBulkStatusDialog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OrdersBulkStatusDialog.d.ts","sourceRoot":"","sources":["../../../src/admin/components/OrdersBulkStatusDialog.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAKjD,UAAU,SAAS;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,UAAU,KAAK;IACb,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,SAAS,EAAE,CAAC;IACtB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,MAAM,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,IAAI,CAAC;CAC9C;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,KAAK,GAAG,SAAS,CAmDtG"}

package/dist/admin/components/OrdersBulkStatusDialog.js

@@ -0,0 +1,36 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState } from 'react';
+import { ApiError, apiClient } from '@endora-commerce/admin-kit/lib';
+import { Button, Label, Select } from '@endora-commerce/admin-kit/ui';
+import { useTranslation } from '@endora-commerce/admin-kit/i18n';
+/**
+ * Feature 038 (US2) — bulk order status change. Applies the chosen target to
+ * every selected order; the server moves only the eligible ones and reports
+ * the rest as skipped (with reasons).
+ */
+export function OrdersBulkStatusDialog({ open, orderIds, statuses, onClose, onDone }) {
+    const t = useTranslation('core');
+    const [target, setTarget] = useState('');
+    const [busy, setBusy] = useState(false);
+    const [error, setError] = useState(null);
+    if (!open)
+        return null;
+    const apply = async () => {
+        if (!target)
+            return;
+        setBusy(true);
+        setError(null);
+        try {
+            const res = await apiClient.post('/api/v1/admin/orders/bulk/status', { orderIds, toStatusCode: target });
+            onDone({ changed: res.data.changed.length, skipped: res.data.skipped.length });
+        }
+        catch (err) {
+            setError(err instanceof ApiError ? err.envelope.error.message : t('orders.bulk.error'));
+        }
+        finally {
+            setBusy(false);
+        }
+    };
+    return (_jsx("div", { className: "fixed inset-0 z-50 flex items-center justify-center bg-black/40 p-4", role: "dialog", "aria-modal": "true", children: _jsxs("div", { className: "w-full max-w-md rounded-lg bg-background p-6 shadow-lg", children: [_jsx("h2", { className: "mb-4 text-lg font-semibold", children: t('orders.bulk.dialogTitle', { count: orderIds.length }) }), error ? _jsx("p", { className: "mb-3 text-sm text-destructive", children: error }) : null, _jsxs("div", { className: "space-y-2", children: [_jsx(Label, { htmlFor: "bulk-target", children: t('orders.bulk.targetStatus') }), _jsxs(Select, { id: "bulk-target", value: target, onChange: (e) => setTarget(e.target.value), children: [_jsx("option", { value: "", children: "\u2014" }), statuses.map((s) => (_jsx("option", { value: s.code, children: s.name['en'] ?? s.code }, s.code)))] })] }), _jsxs("div", { className: "mt-6 flex justify-end gap-2", children: [_jsx(Button, { variant: "outline", onClick: onClose, disabled: busy, children: t('common.action.cancel') }), _jsx(Button, { onClick: () => void apply(), disabled: !target || busy, children: t('orders.bulk.apply') })] })] }) }));
+}
+//# sourceMappingURL=OrdersBulkStatusDialog.js.map

package/dist/admin/components/OrdersBulkStatusDialog.js.map

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

package/dist/admin/components/StatusColorPicker.d.ts

@@ -0,0 +1,14 @@
+import { type ReactNode } from 'react';
+/**
+ * Order-status colour picker — a thin wrapper around the core
+ * {@link ColorPicker} that supplies the curated order-status preset palette.
+ * Kept as a named component so existing call sites stay unchanged.
+ */
+export declare function StatusColorPicker(props: {
+    value: string;
+    onChange: (hex: string) => void;
+    /** Accessible label for the trigger + custom input. */
+    label: string;
+    customLabel: string;
+}): ReactNode;
+//# sourceMappingURL=StatusColorPicker.d.ts.map

package/dist/admin/components/StatusColorPicker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StatusColorPicker.d.ts","sourceRoot":"","sources":["../../../src/admin/components/StatusColorPicker.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAIvC;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,uDAAuD;IACvD,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB,GAAG,SAAS,CAUZ"}

package/dist/admin/components/StatusColorPicker.js

@@ -0,0 +1,13 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import {} from 'react';
+import { ColorPicker } from '@endora-commerce/admin-kit/ui';
+import { ORDER_STATUS_COLOR_PRESETS } from '@endora-commerce/contracts';
+/**
+ * Order-status colour picker — a thin wrapper around the core
+ * {@link ColorPicker} that supplies the curated order-status preset palette.
+ * Kept as a named component so existing call sites stay unchanged.
+ */
+export function StatusColorPicker(props) {
+    return (_jsx(ColorPicker, { value: props.value, onChange: props.onChange, label: props.label, customLabel: props.customLabel, presets: ORDER_STATUS_COLOR_PRESETS }));
+}
+//# sourceMappingURL=StatusColorPicker.js.map

package/dist/admin/components/StatusColorPicker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StatusColorPicker.js","sourceRoot":"","sources":["../../../src/admin/components/StatusColorPicker.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAkB,MAAM,OAAO,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AAExE;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAMjC;IACC,OAAO,CACL,KAAC,WAAW,IACV,KAAK,EAAE,KAAK,CAAC,KAAK,EAClB,QAAQ,EAAE,KAAK,CAAC,QAAQ,EACxB,KAAK,EAAE,KAAK,CAAC,KAAK,EAClB,WAAW,EAAE,KAAK,CAAC,WAAW,EAC9B,OAAO,EAAE,0BAA0B,GACnC,CACH,CAAC;AACJ,CAAC"}

package/dist/admin/index.d.ts

@@ -0,0 +1,49 @@
+/**
+ * `orders`' admin surface — four routes, three sidebar entries and one zone
+ * contribution (feature 091: P4d for the contribution, Phase 4 batch 15 for
+ * the rest;
+ * `specs/091-module-owned-admin-surfaces/contracts/admin-component-contribution.md`
+ * §6).
+ *
+ * **This entry said "no route and no sidebar entry here" until batch 15**, and
+ * that sentence is what a module looks like halfway through the drain: P4d
+ * declared the zone contribution while the screens were still `App.tsx`'s,
+ * because `check:admin-registrations` counts routes and nav entries and a zone
+ * is neither. The screens are here now, so the module is both ends of that
+ * property at once — a contributor to `order.entry.tabs` and the host of four
+ * other members.
+ *
+ * **The four it hosts.** `OrderDetail.tsx` mounts `order.detail.payment`,
+ * `OrderShipmentsTab.tsx` mounts `order.shipment.row.actions` once per attempt
+ * and `order.shipments.tab.actions` once per tab, and `OrderCreatePage.tsx`
+ * mounts `order.entry.tabs` — through the kit's `<RouteTabsZone>` rather than a
+ * bare `<AdminZone>`, because the strip counts what the hook already filtered
+ * and *"fewer than two tabs is not a choice"*. P7d and P4d published all four,
+ * and `payments`, `inpost` and `quick_order` contribute to them. A screen that
+ * moved into this package and lost a mount would leave those contributions
+ * rendering nowhere.
+ *
+ * **Zone and not a published component** for its own contribution, decided from
+ * the file P4d deleted (§9.3): `OrderEntryTabs()` took no props at all and
+ * answered the question *"which of these two modules is installed"* out of a
+ * third party's file. There is no signature to publish — the component was
+ * module knowledge, twice over — which is Z1 question 2 in its plainest form.
+ *
+ * **What it drains: nothing, and the zero is measured rather than assumed.**
+ * Before anything moved on this branch, this module owned no
+ * `backend/scripts/ledgers/cross-module-imports/` shard and was named as a
+ * target by none: batch 5 paid the two carrier-client reaches
+ * `OrderShipmentsTab.tsx` carried, and P7d retired the two `foreign-module-ids`
+ * entries that same file had in favour of the two zones it now mounts.
+ * `admin-surface.ts` is empty — P4d's own contribution drained one of its last
+ * two keys. `check:module-boundary` reads
+ * `cross-module reaches=7 (imports=3 sql=4) ledger-size=7 shards=4` on both
+ * sides of the move, and that agreement is the measurement rather than a
+ * silence.
+ *
+ * **This entry exports data and nothing else** (R2); every component is a
+ * dynamic-import factory (R6).
+ */
+import { type AdminContributions } from '@endora-commerce/admin-kit/contributions';
+export declare const contributions: AdminContributions;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/admin/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,0CAA0C,CAAC;AA2ClD,eAAO,MAAM,aAAa,EAAE,kBAoF3B,CAAC"}