@aglyn/plugins-commerce 1.0.0-beta.143

package/src/lib/components/console/stock-movements-card.component.d.ts

@@ -0,0 +1,31 @@
+export interface StockMovementsCardProps {
+    hostId: string;
+}
+/**
+ * Stock movements (AGL-2341) — the adjustment history that had no history
+ * view.
+ *
+ * `hosts/{hostId}/inventoryAdjustments` has five writers: the products hub's
+ * "Adjust stock" dialog, the sale path in `billing-webhook.ts`, the POS in
+ * `pos-order.ts`, and the restock in `cancel-order.ts`. The hub's own comment
+ * calls the collection "adjustment history".
+ *
+ * Its only reader was arithmetic: `cancel-order.ts` projects `appliedDelta`
+ * off the `reason: 'sale'` rows to cap what a cancellation may put back. No
+ * surface displayed a single one of them. A merchant whose count disagreed
+ * with the shelf had no way to see what moved it, when, or why — and the one
+ * number that reconciles the discrepancy was written on every adjustment and
+ * unreachable.
+ *
+ * `delta` is what the merchant's history says moved; `appliedDelta` is what
+ * the count could actually give up when the floor in `adjustVariantInventory`
+ * absorbed part of it, which happens on a backorder product selling past
+ * zero. They differ rarely and they differ importantly — three sold out of a
+ * count of zero is exactly the state a merchant is trying to explain — so
+ * both are shown when they disagree and only `delta` when they do not.
+ */
+export declare function StockMovementsCard(props: StockMovementsCardProps): import("react").JSX.Element;
+export declare namespace StockMovementsCard {
+    var displayName: string;
+}
+export default StockMovementsCard;

package/src/lib/components/console/stock-movements-card.component.js

@@ -0,0 +1,333 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ 'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { CardDisplay } from "@aglyn/shared-ui-jsx";
+import { ListPagination } from "@aglyn/shared-ui-jsx/components/list-pagination.component";
+import { TABLE_PAGE_SIZE_DEFAULT } from "@aglyn/shared-ui-jsx/const/table-pagination";
+import { ScrollTable } from "@aglyn/shared-ui-jsx/components/scroll-table.component";
+import { Alert, MenuItem, Stack, TableBody, TableCell, TableHead, TableRow, TextField, Typography } from "@mui/material";
+import { collection, limit, orderBy, query } from "firebase/firestore";
+import { useEffect, useMemo, useState } from "react";
+import { useFirestore, useFirestoreCollection } from "@aglyn/tenant-feature-instance";
+import { pluginDocsHelp } from "@aglyn/aglyn";
+/**
+ * How many rows the listener holds.
+ *
+ * Ordered by `atMs` descending, which is a SINGLE-FIELD index Firestore
+ * maintains automatically — no composite, so nothing here can drift from
+ * `cloud/firebase-firestore.indexes.json`. Filtering by product happens over
+ * this window rather than in the query for exactly that reason: an equality
+ * filter plus this ordering is a composite index, and an index that has to be
+ * deployed by hand is an index the feature ships without.
+ */ const WINDOW = 100;
+const movementsHelp = pluginDocsHelp('commerce', {
+    anchor: '#stock-movements',
+    title: 'Stock movements',
+    excerpt: 'Every change to a tracked count — sales, returns, cancellations and ' + 'hand adjustments — newest first, with the reason each one was made.'
+});
+/** The stored key is a closed set; these are what a merchant reads. */ const REASON_LABEL = {
+    sale: 'Sale',
+    refund: 'Refund return',
+    restock: 'Restock',
+    correction: 'Correction',
+    damage: 'Damaged',
+    cancellation: 'Order canceled'
+};
+/**
+ * Stock movements (AGL-2341) — the adjustment history that had no history
+ * view.
+ *
+ * `hosts/{hostId}/inventoryAdjustments` has five writers: the products hub's
+ * "Adjust stock" dialog, the sale path in `billing-webhook.ts`, the POS in
+ * `pos-order.ts`, and the restock in `cancel-order.ts`. The hub's own comment
+ * calls the collection "adjustment history".
+ *
+ * Its only reader was arithmetic: `cancel-order.ts` projects `appliedDelta`
+ * off the `reason: 'sale'` rows to cap what a cancellation may put back. No
+ * surface displayed a single one of them. A merchant whose count disagreed
+ * with the shelf had no way to see what moved it, when, or why — and the one
+ * number that reconciles the discrepancy was written on every adjustment and
+ * unreachable.
+ *
+ * `delta` is what the merchant's history says moved; `appliedDelta` is what
+ * the count could actually give up when the floor in `adjustVariantInventory`
+ * absorbed part of it, which happens on a backorder product selling past
+ * zero. They differ rarely and they differ importantly — three sold out of a
+ * count of zero is exactly the state a merchant is trying to explain — so
+ * both are shown when they disagree and only `delta` when they do not.
+ */ export function StockMovementsCard(props) {
+    var _ref;
+    const { hostId } = props;
+    const firestore = useFirestore();
+    const [productFilter, setProductFilter] = useState('all');
+    const [reasonFilter, setReasonFilter] = useState('all');
+    const { data: movementDocs } = useFirestoreCollection(()=>query(collection(firestore, 'hosts', hostId, 'inventoryAdjustments'), orderBy('atMs', 'desc'), /*
+         * `WINDOW + 1` is a PROBE (AGL-2501). One document beyond the ceiling
+         * turns "there are older movements than these" into a fact for the
+         * price of a single read. The comparison it replaces —
+         * `length >= WINDOW` — is wrong at exactly the count that equals the
+         * ceiling, which is the one ledger size where a merchant is told
+         * rows are missing and none are. The probe row is sliced off below
+         * and never rendered.
+         */ limit(WINDOW + 1)), [
+        firestore,
+        hostId
+    ], {
+        idField: '$id'
+    });
+    // Names, so a row reads as "Desk lamp" rather than a 20-character id. The
+    // products hub above runs this exact query, so the SDK shares one listener.
+    const { data: productDocs } = useFirestoreCollection(()=>query(collection(firestore, 'hosts', hostId, 'products'), limit(500)), [
+        firestore,
+        hostId
+    ], {
+        idField: '$id'
+    });
+    const productNames = useMemo(()=>{
+        const names = new Map();
+        for (const product of productDocs != null ? productDocs : []){
+            var _product_name;
+            names.set(product.$id, (_product_name = product.name) != null ? _product_name : product.$id);
+        }
+        return names;
+    }, [
+        productDocs
+    ]);
+    /** Read beyond the ceiling — so the ledger holds more than was read. */ const truncated = ((_ref = movementDocs == null ? void 0 : movementDocs.length) != null ? _ref : 0) > WINDOW;
+    /** The window itself, probe row removed. */ const windowRows = useMemo(()=>(movementDocs != null ? movementDocs : []).slice(0, WINDOW), [
+        movementDocs
+    ]);
+    const movements = useMemo(()=>[
+            ...windowRows
+        ]// The query already orders, but a cached snapshot can arrive before
+        // the server's and the sort is what makes "newest first" a promise
+        // rather than a hope.
+        .sort((a, b)=>{
+            var _b_atMs, _a_atMs;
+            return Number((_b_atMs = b.atMs) != null ? _b_atMs : 0) - Number((_a_atMs = a.atMs) != null ? _a_atMs : 0);
+        }).filter((row)=>productFilter === 'all' || row.productId === productFilter).filter((row)=>reasonFilter === 'all' || row.reason === reasonFilter), [
+        windowRows,
+        productFilter,
+        reasonFilter
+    ]);
+    /*
+   * The page is a SLICE of the window, and the window stays where it is.
+   *
+   * Paging the QUERY would be the cheaper read and the wrong control here,
+   * because both filters above run in the browser: on a ten-row server page
+   * "Damaged" would search ten movements instead of a hundred and answer "no
+   * stock movements" about a ledger full of them. Moving those filters to the
+   * server is what would earn a query-level page, and it cannot be done
+   * without composite indexes this feature would then ship without — see
+   * `WINDOW`. So the read is unchanged and the wall of a hundred rows becomes
+   * a footer over them.
+   */ const [page, setPage] = useState(0);
+    const [pageSize, setPageSize] = useState(TABLE_PAGE_SIZE_DEFAULT);
+    // A filter narrows the list under the reader's feet, and page four of the
+    // unfiltered ledger is not a position in the filtered one — MUI renders an
+    // out-of-range page as an empty table with no explanation, which reads as
+    // the filter having matched nothing.
+    useEffect(()=>setPage(0), [
+        productFilter,
+        reasonFilter
+    ]);
+    const shown = useMemo(()=>movements.slice(page * pageSize, page * pageSize + pageSize), [
+        movements,
+        page,
+        pageSize
+    ]);
+    /** Products that actually appear in the window — filtering to an empty
+   * option is a dead end, and the whole catalog is not the answer here. */ const filterableProducts = useMemo(()=>{
+        const ids = new Set();
+        for (const row of windowRows){
+            if (row.productId) ids.add(row.productId);
+        }
+        return [
+            ...ids
+        ].sort((a, b)=>{
+            var _productNames_get, _productNames_get1;
+            return ((_productNames_get = productNames.get(a)) != null ? _productNames_get : a).localeCompare((_productNames_get1 = productNames.get(b)) != null ? _productNames_get1 : b);
+        });
+    }, [
+        windowRows,
+        productNames
+    ]);
+    return /*#__PURE__*/ _jsx(CardDisplay, {
+        header: "Stock movements",
+        help: movementsHelp,
+        contentGutterX: true,
+        contentGutterY: true,
+        children: /*#__PURE__*/ _jsxs(Stack, {
+            spacing: 2,
+            children: [
+                /*#__PURE__*/ _jsxs(Stack, {
+                    direction: "row",
+                    spacing: 2,
+                    children: [
+                        /*#__PURE__*/ _jsxs(TextField, {
+                            label: "Product",
+                            size: "small",
+                            select: true,
+                            value: productFilter,
+                            onChange: (event)=>setProductFilter(event.target.value),
+                            sx: {
+                                minWidth: 200
+                            },
+                            children: [
+                                /*#__PURE__*/ _jsx(MenuItem, {
+                                    value: "all",
+                                    children: 'All products'
+                                }),
+                                filterableProducts.map((productId)=>{
+                                    var _productNames_get;
+                                    return /*#__PURE__*/ _jsx(MenuItem, {
+                                        value: productId,
+                                        children: (_productNames_get = productNames.get(productId)) != null ? _productNames_get : productId
+                                    }, productId);
+                                })
+                            ]
+                        }),
+                        /*#__PURE__*/ _jsxs(TextField, {
+                            label: "Reason",
+                            size: "small",
+                            select: true,
+                            value: reasonFilter,
+                            onChange: (event)=>setReasonFilter(event.target.value),
+                            sx: {
+                                minWidth: 180
+                            },
+                            children: [
+                                /*#__PURE__*/ _jsx(MenuItem, {
+                                    value: "all",
+                                    children: 'Every reason'
+                                }),
+                                Object.entries(REASON_LABEL).map(([value, label])=>/*#__PURE__*/ _jsx(MenuItem, {
+                                        value: value,
+                                        children: label
+                                    }, value))
+                            ]
+                        })
+                    ]
+                }),
+                movements.length === 0 ? /*#__PURE__*/ _jsx(Typography, {
+                    variant: "body2",
+                    color: "text.secondary",
+                    children: 'No stock movements recorded yet. Sales, returns, cancellations ' + 'and hand adjustments all land here.'
+                }) : /*#__PURE__*/ _jsxs(ScrollTable, {
+                    size: "small",
+                    children: [
+                        /*#__PURE__*/ _jsx(TableHead, {
+                            children: /*#__PURE__*/ _jsxs(TableRow, {
+                                children: [
+                                    /*#__PURE__*/ _jsx(TableCell, {
+                                        children: 'When'
+                                    }),
+                                    /*#__PURE__*/ _jsx(TableCell, {
+                                        children: 'Product'
+                                    }),
+                                    /*#__PURE__*/ _jsx(TableCell, {
+                                        align: "right",
+                                        children: 'Change'
+                                    }),
+                                    /*#__PURE__*/ _jsx(TableCell, {
+                                        children: 'Reason'
+                                    }),
+                                    /*#__PURE__*/ _jsx(TableCell, {
+                                        children: 'Source'
+                                    })
+                                ]
+                            })
+                        }),
+                        /*#__PURE__*/ _jsx(TableBody, {
+                            children: shown.map((row)=>{
+                                var _row_delta, _row_appliedDelta, _productNames_get, _REASON_LABEL_row_reason;
+                                const delta = Number((_row_delta = row.delta) != null ? _row_delta : 0);
+                                const applied = Number((_row_appliedDelta = row.appliedDelta) != null ? _row_appliedDelta : delta);
+                                return /*#__PURE__*/ _jsxs(TableRow, {
+                                    children: [
+                                        /*#__PURE__*/ _jsx(TableCell, {
+                                            children: row.atMs ? new Date(Number(row.atMs)).toLocaleString() : '—'
+                                        }),
+                                        /*#__PURE__*/ _jsxs(TableCell, {
+                                            children: [
+                                                (_productNames_get = productNames.get(row.productId)) != null ? _productNames_get : row.productId,
+                                                row.variantId ? /*#__PURE__*/ _jsx(Typography, {
+                                                    variant: "caption",
+                                                    color: "text.secondary",
+                                                    children: ` · ${row.variantId}`
+                                                }) : null
+                                            ]
+                                        }),
+                                        /*#__PURE__*/ _jsxs(TableCell, {
+                                            align: "right",
+                                            children: [
+                                                /*#__PURE__*/ _jsx(Typography, {
+                                                    variant: "body2",
+                                                    color: delta < 0 ? 'error.main' : 'success.main',
+                                                    component: "span",
+                                                    children: delta > 0 ? `+${delta}` : String(delta)
+                                                }),
+                                                applied !== delta ? /*#__PURE__*/ _jsx(Typography, {
+                                                    variant: "caption",
+                                                    color: "text.secondary",
+                                                    children: ` (${applied > 0 ? `+${applied}` : applied} applied)`
+                                                }) : null
+                                            ]
+                                        }),
+                                        /*#__PURE__*/ _jsx(TableCell, {
+                                            children: (_REASON_LABEL_row_reason = REASON_LABEL[row.reason]) != null ? _REASON_LABEL_row_reason : row.reason
+                                        }),
+                                        /*#__PURE__*/ _jsx(TableCell, {
+                                            children: /*#__PURE__*/ _jsx(Typography, {
+                                                variant: "caption",
+                                                color: "text.secondary",
+                                                children: [
+                                                    row.orderId ? `order ${row.orderId}` : null,
+                                                    row.locationId ? `at ${row.locationId}` : null
+                                                ].filter(Boolean).join(' · ') || '—'
+                                            })
+                                        })
+                                    ]
+                                }, row.$id);
+                            })
+                        })
+                    ]
+                }),
+                movements.length === 0 ? null : /*#__PURE__*/ _jsx(ListPagination, {
+                    page: page,
+                    pageSize: pageSize,
+                    rowCount: shown.length,
+                    // The movements matching the filters, which this card genuinely
+                    // holds. What it does not know is how many are older than the
+                    // window, and the notice below says so rather than letting the
+                    // count line imply a ledger total it cannot see.
+                    count: movements.length,
+                    onPageChange: setPage,
+                    onPageSizeChange: setPageSize
+                }),
+                truncated ? /*#__PURE__*/ _jsx(Alert, {
+                    severity: "info",
+                    children: `Paging the ${WINDOW} most recent movements. Older rows are ` + 'kept and reachable through a data export.'
+                }) : null
+            ]
+        })
+    });
+}
+StockMovementsCard.displayName = 'StockMovementsCard';
+export default StockMovementsCard;
+
+//# sourceMappingURL=stock-movements-card.component.js.map

package/src/lib/components/console/stock-movements-card.component.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/plugins/commerce/src/lib/components/console/stock-movements-card.component.tsx"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n'use client'\n\nimport { CardDisplay } from '@aglyn/shared-ui-jsx'\nimport { ListPagination } from '@aglyn/shared-ui-jsx/components/list-pagination.component'\nimport { TABLE_PAGE_SIZE_DEFAULT } from '@aglyn/shared-ui-jsx/const/table-pagination'\nimport { ScrollTable } from '@aglyn/shared-ui-jsx/components/scroll-table.component'\nimport {\n  Alert,\n  MenuItem,\n  Stack,\n  TableBody,\n  TableCell,\n  TableHead,\n  TableRow,\n  TextField,\n  Typography,\n} from '@mui/material'\nimport { collection, limit, orderBy, query } from 'firebase/firestore'\nimport { useEffect, useMemo, useState } from 'react'\nimport {\n  useFirestore,\n  useFirestoreCollection,\n} from '@aglyn/tenant-feature-instance'\nimport { pluginDocsHelp } from '@aglyn/aglyn'\nimport * as CommerceModel from '../../model'\n\nexport interface StockMovementsCardProps {\n  hostId: string\n}\n\n/**\n * How many rows the listener holds.\n *\n * Ordered by `atMs` descending, which is a SINGLE-FIELD index Firestore\n * maintains automatically — no composite, so nothing here can drift from\n * `cloud/firebase-firestore.indexes.json`. Filtering by product happens over\n * this window rather than in the query for exactly that reason: an equality\n * filter plus this ordering is a composite index, and an index that has to be\n * deployed by hand is an index the feature ships without.\n */\nconst WINDOW = 100\n\nconst movementsHelp = pluginDocsHelp('commerce', {\n  anchor: '#stock-movements',\n  title: 'Stock movements',\n  excerpt:\n    'Every change to a tracked count — sales, returns, cancellations and ' +\n    'hand adjustments — newest first, with the reason each one was made.',\n})\n\n/** The stored key is a closed set; these are what a merchant reads. */\nconst REASON_LABEL: Record<CommerceModel.InventoryAdjustmentReason, string> = {\n  sale: 'Sale',\n  refund: 'Refund return',\n  restock: 'Restock',\n  correction: 'Correction',\n  damage: 'Damaged',\n  cancellation: 'Order canceled',\n}\n\ntype MovementRow = CommerceModel.InventoryAdjustment & { $id: string }\n\n/**\n * Stock movements (AGL-2341) — the adjustment history that had no history\n * view.\n *\n * `hosts/{hostId}/inventoryAdjustments` has five writers: the products hub's\n * \"Adjust stock\" dialog, the sale path in `billing-webhook.ts`, the POS in\n * `pos-order.ts`, and the restock in `cancel-order.ts`. The hub's own comment\n * calls the collection \"adjustment history\".\n *\n * Its only reader was arithmetic: `cancel-order.ts` projects `appliedDelta`\n * off the `reason: 'sale'` rows to cap what a cancellation may put back. No\n * surface displayed a single one of them. A merchant whose count disagreed\n * with the shelf had no way to see what moved it, when, or why — and the one\n * number that reconciles the discrepancy was written on every adjustment and\n * unreachable.\n *\n * `delta` is what the merchant's history says moved; `appliedDelta` is what\n * the count could actually give up when the floor in `adjustVariantInventory`\n * absorbed part of it, which happens on a backorder product selling past\n * zero. They differ rarely and they differ importantly — three sold out of a\n * count of zero is exactly the state a merchant is trying to explain — so\n * both are shown when they disagree and only `delta` when they do not.\n */\nexport function StockMovementsCard(props: StockMovementsCardProps) {\n  const { hostId } = props\n  const firestore = useFirestore()\n  const [productFilter, setProductFilter] = useState('all')\n  const [reasonFilter, setReasonFilter] = useState('all')\n\n  const { data: movementDocs } = useFirestoreCollection<any>(\n    () =>\n      query(\n        collection(firestore, 'hosts', hostId, 'inventoryAdjustments'),\n        orderBy('atMs', 'desc'),\n        /*\n         * `WINDOW + 1` is a PROBE (AGL-2501). One document beyond the ceiling\n         * turns \"there are older movements than these\" into a fact for the\n         * price of a single read. The comparison it replaces —\n         * `length >= WINDOW` — is wrong at exactly the count that equals the\n         * ceiling, which is the one ledger size where a merchant is told\n         * rows are missing and none are. The probe row is sliced off below\n         * and never rendered.\n         */\n        limit(WINDOW + 1),\n      ),\n    [firestore, hostId],\n    { idField: '$id' },\n  )\n  // Names, so a row reads as \"Desk lamp\" rather than a 20-character id. The\n  // products hub above runs this exact query, so the SDK shares one listener.\n  const { data: productDocs } = useFirestoreCollection<any>(\n    () =>\n      query(collection(firestore, 'hosts', hostId, 'products'), limit(500)),\n    [firestore, hostId],\n    { idField: '$id' },\n  )\n\n  const productNames = useMemo(() => {\n    const names = new Map<string, string>()\n    for (const product of productDocs ?? []) {\n      names.set(product.$id, product.name ?? product.$id)\n    }\n    return names\n  }, [productDocs])\n\n  /** Read beyond the ceiling — so the ledger holds more than was read. */\n  const truncated = (movementDocs?.length ?? 0) > WINDOW\n  /** The window itself, probe row removed. */\n  const windowRows = useMemo(\n    () => ((movementDocs ?? []) as MovementRow[]).slice(0, WINDOW),\n    [movementDocs],\n  )\n\n  const movements: MovementRow[] = useMemo(\n    () =>\n      [...windowRows]\n        // The query already orders, but a cached snapshot can arrive before\n        // the server's and the sort is what makes \"newest first\" a promise\n        // rather than a hope.\n        .sort((a, b) => Number(b.atMs ?? 0) - Number(a.atMs ?? 0))\n        .filter(\n          (row) => productFilter === 'all' || row.productId === productFilter,\n        )\n        .filter((row) => reasonFilter === 'all' || row.reason === reasonFilter),\n    [windowRows, productFilter, reasonFilter],\n  )\n\n  /*\n   * The page is a SLICE of the window, and the window stays where it is.\n   *\n   * Paging the QUERY would be the cheaper read and the wrong control here,\n   * because both filters above run in the browser: on a ten-row server page\n   * \"Damaged\" would search ten movements instead of a hundred and answer \"no\n   * stock movements\" about a ledger full of them. Moving those filters to the\n   * server is what would earn a query-level page, and it cannot be done\n   * without composite indexes this feature would then ship without — see\n   * `WINDOW`. So the read is unchanged and the wall of a hundred rows becomes\n   * a footer over them.\n   */\n  const [page, setPage] = useState(0)\n  const [pageSize, setPageSize] = useState(TABLE_PAGE_SIZE_DEFAULT)\n  // A filter narrows the list under the reader's feet, and page four of the\n  // unfiltered ledger is not a position in the filtered one — MUI renders an\n  // out-of-range page as an empty table with no explanation, which reads as\n  // the filter having matched nothing.\n  useEffect(() => setPage(0), [productFilter, reasonFilter])\n  const shown = useMemo(\n    () => movements.slice(page * pageSize, page * pageSize + pageSize),\n    [movements, page, pageSize],\n  )\n\n  /** Products that actually appear in the window — filtering to an empty\n   * option is a dead end, and the whole catalog is not the answer here. */\n  const filterableProducts = useMemo(() => {\n    const ids = new Set<string>()\n    for (const row of windowRows) {\n      if (row.productId) ids.add(row.productId)\n    }\n    return [...ids].sort((a, b) =>\n      (productNames.get(a) ?? a).localeCompare(productNames.get(b) ?? b),\n    )\n  }, [windowRows, productNames])\n\n  return (\n    <CardDisplay header=\"Stock movements\" help={movementsHelp} contentGutterX contentGutterY>\n      <Stack spacing={2}>\n        <Stack direction=\"row\" spacing={2}>\n          <TextField\n            label=\"Product\"\n            size=\"small\"\n            select\n            value={productFilter}\n            onChange={(event) => setProductFilter(event.target.value)}\n            sx={{ minWidth: 200 }}\n          >\n            <MenuItem value=\"all\">{'All products'}</MenuItem>\n            {filterableProducts.map((productId) => (\n              <MenuItem key={productId} value={productId}>\n                {productNames.get(productId) ?? productId}\n              </MenuItem>\n            ))}\n          </TextField>\n          <TextField\n            label=\"Reason\"\n            size=\"small\"\n            select\n            value={reasonFilter}\n            onChange={(event) => setReasonFilter(event.target.value)}\n            sx={{ minWidth: 180 }}\n          >\n            <MenuItem value=\"all\">{'Every reason'}</MenuItem>\n            {Object.entries(REASON_LABEL).map(([value, label]) => (\n              <MenuItem key={value} value={value}>\n                {label}\n              </MenuItem>\n            ))}\n          </TextField>\n        </Stack>\n        {movements.length === 0 ? (\n          <Typography variant=\"body2\" color=\"text.secondary\">\n            {'No stock movements recorded yet. Sales, returns, cancellations ' +\n              'and hand adjustments all land here.'}\n          </Typography>\n        ) : (\n          <ScrollTable size=\"small\">\n            <TableHead>\n              <TableRow>\n                <TableCell>{'When'}</TableCell>\n                <TableCell>{'Product'}</TableCell>\n                <TableCell align=\"right\">{'Change'}</TableCell>\n                <TableCell>{'Reason'}</TableCell>\n                <TableCell>{'Source'}</TableCell>\n              </TableRow>\n            </TableHead>\n            <TableBody>\n              {shown.map((row) => {\n                const delta = Number(row.delta ?? 0)\n                const applied = Number(row.appliedDelta ?? delta)\n                return (\n                  <TableRow key={row.$id}>\n                    <TableCell>\n                      {row.atMs\n                        ? new Date(Number(row.atMs)).toLocaleString()\n                        : '—'}\n                    </TableCell>\n                    <TableCell>\n                      {productNames.get(row.productId) ?? row.productId}\n                      {row.variantId ? (\n                        <Typography variant=\"caption\" color=\"text.secondary\">\n                          {` · ${row.variantId}`}\n                        </Typography>\n                      ) : null}\n                    </TableCell>\n                    <TableCell align=\"right\">\n                      {/*\n                       * The sign is carried explicitly. \"3\" and \"-3\" are the\n                       * same width and opposite facts, and a merchant\n                       * scanning a column for the movement that broke their\n                       * count reads the sign before the number.\n                       */}\n                      <Typography\n                        variant=\"body2\"\n                        color={delta < 0 ? 'error.main' : 'success.main'}\n                        component=\"span\"\n                      >\n                        {delta > 0 ? `+${delta}` : String(delta)}\n                      </Typography>\n                      {applied !== delta ? (\n                        <Typography variant=\"caption\" color=\"text.secondary\">\n                          {` (${applied > 0 ? `+${applied}` : applied} applied)`}\n                        </Typography>\n                      ) : null}\n                    </TableCell>\n                    <TableCell>\n                      {REASON_LABEL[row.reason] ?? row.reason}\n                    </TableCell>\n                    <TableCell>\n                      <Typography variant=\"caption\" color=\"text.secondary\">\n                        {[\n                          row.orderId ? `order ${row.orderId}` : null,\n                          row.locationId ? `at ${row.locationId}` : null,\n                        ]\n                          .filter(Boolean)\n                          .join(' · ') || '—'}\n                      </Typography>\n                    </TableCell>\n                  </TableRow>\n                )\n              })}\n            </TableBody>\n          </ScrollTable>\n        )}\n        {movements.length === 0 ? null : (\n          <ListPagination\n            page={page}\n            pageSize={pageSize}\n            rowCount={shown.length}\n            // The movements matching the filters, which this card genuinely\n            // holds. What it does not know is how many are older than the\n            // window, and the notice below says so rather than letting the\n            // count line imply a ledger total it cannot see.\n            count={movements.length}\n            onPageChange={setPage}\n            onPageSizeChange={setPageSize}\n          />\n        )}\n        {truncated ? (\n          <Alert severity=\"info\">\n            {`Paging the ${WINDOW} most recent movements. Older rows are ` +\n              'kept and reachable through a data export.'}\n          </Alert>\n        ) : null}\n      </Stack>\n    </CardDisplay>\n  )\n}\nStockMovementsCard.displayName = 'StockMovementsCard'\n\nexport default StockMovementsCard\n"],"names":["CardDisplay","ListPagination","TABLE_PAGE_SIZE_DEFAULT","ScrollTable","Alert","MenuItem","Stack","TableBody","TableCell","TableHead","TableRow","TextField","Typography","collection","limit","orderBy","query","useEffect","useMemo","useState","useFirestore","useFirestoreCollection","pluginDocsHelp","WINDOW","movementsHelp","anchor","title","excerpt","REASON_LABEL","sale","refund","restock","correction","damage","cancellation","StockMovementsCard","props","hostId","firestore","productFilter","setProductFilter","reasonFilter","setReasonFilter","data","movementDocs","idField","productDocs","productNames","names","Map","product","set","$id","name","truncated","length","windowRows","slice","movements","sort","a","b","Number","atMs","filter","row","productId","reason","page","setPage","pageSize","setPageSize","shown","filterableProducts","ids","Set","add","get","localeCompare","header","help","contentGutterX","contentGutterY","spacing","direction","label","size","select","value","onChange","event","target","sx","minWidth","map","Object","entries","variant","color","align","delta","applied","appliedDelta","Date","toLocaleString","variantId","component","String","orderId","locationId","Boolean","join","rowCount","count","onPageChange","onPageSizeChange","severity","displayName"],"mappings":"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"}

package/src/lib/components/console/store-settings-card.component.d.ts

@@ -0,0 +1,14 @@
+export interface StoreSettingsCardProps {
+    hostId: string;
+}
+/**
+ * Store settings (AGL-295) on `hosts/{hostId}/settings/store`: the PDP
+ * template screen (drives /products/{slug}), currency display, checkout
+ * preferences, and receipt branding. Tax and shipping have their own
+ * cards; store password/maintenance live in Site Protection.
+ */
+export declare function StoreSettingsCard(props: StoreSettingsCardProps): import("react").JSX.Element;
+export declare namespace StoreSettingsCard {
+    var displayName: string;
+}
+export default StoreSettingsCard;