@aglyn/plugins-commerce 1.0.0-beta.143

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

@@ -0,0 +1,300 @@
+/**
+ * @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 { _ as _extends } from "@swc/helpers/_/_extends";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { CardDisplay } from "@aglyn/shared-ui-jsx";
+import { useSnackbar } from "@aglyn/shared-ui-snackstack";
+import { Button, FormControlLabel, MenuItem, Stack, Switch, TextField, Typography } from "@mui/material";
+import { doc, setDoc } from "firebase/firestore";
+import { useCallback, useState } from "react";
+import { useFirestore } from "@aglyn/tenant-feature-instance";
+import { useFirestoreDoc, writeGuardedBySeed } from "@aglyn/tenant-feature-instance";
+import { hostPublicOrigin, pluginDocsHelp } from "@aglyn/aglyn";
+/**
+ * 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 function StoreSettingsCard(props) {
+    var _ref, _ref1, _ref2, _ref3, _ref4, _ref5, _current_pdpScreenId, _current_collectionScreenId, _current_currency, _current_termsUrl, _current_receiptFooter;
+    const { hostId } = props;
+    const firestore = useFirestore();
+    const { enqueueSnackbar } = useSnackbar();
+    const { data: store, status: storeStatus, /**
+     * The settings doc this form is seeded from is unconfirmed by the server
+     * (AGL-1358). `current` is `draft ?? {…store}` and the save writes all
+     * six keys, so `merge: true` protects only the tax and shipping maps that
+     * belong to other cards — never this card's own fields. Against a cached
+     * read, changing the currency rewrites `guestCheckout`, and the two
+     * template ids fall back to `|| null`, which is how a storefront's
+     * product and collection URLs start returning 404.
+     */ fromCache: storeFromCache } = useFirestoreDoc(()=>doc(firestore, 'hosts', hostId, 'settings', 'store'), [
+        firestore,
+        hostId
+    ]);
+    const { data: host } = useFirestoreDoc(()=>doc(firestore, 'hosts', hostId), [
+        firestore,
+        hostId
+    ]);
+    const [draft, setDraft] = useState(null);
+    const current = draft != null ? draft : {
+        pdpScreenId: (_ref = store == null ? void 0 : store.pdpScreenId) != null ? _ref : '',
+        collectionScreenId: (_ref1 = store == null ? void 0 : store.collectionScreenId) != null ? _ref1 : '',
+        currency: (_ref2 = store == null ? void 0 : store.currency) != null ? _ref2 : 'USD',
+        guestCheckout: (store == null ? void 0 : store.guestCheckout) !== false,
+        termsUrl: (_ref3 = store == null ? void 0 : store.termsUrl) != null ? _ref3 : '',
+        receiptFooter: (_ref4 = store == null ? void 0 : store.receiptFooter) != null ? _ref4 : ''
+    };
+    const update = (patch)=>setDraft(_extends({}, current, patch));
+    /**
+   * Google Merchant Center feed address (AGL-2249).
+   *
+   * `server/feed.ts` has served this since AGL-299, and the only place the
+   * URL was ever written down was that file's own docblock — so the feature
+   * was built, deployed, and undiscoverable. A feed nobody can find is a
+   * shopping channel nobody switches on.
+   *
+   * Through `hostPublicOrigin` rather than a hand-built string, because a
+   * store on a custom domain must be told ITS name: the feed's `<link>`
+   * elements are built from the request host, so submitting the `.aglyn.app`
+   * address for a site that serves on `shop.example.com` would put the wrong
+   * domain on every item in Merchant Center.
+   *
+   * Undefined until the host doc lands, and undefined forever for a host with
+   * neither a cname nor a subdomain — `hostPublicOrigin` returns undefined
+   * rather than a half-built URL, and a copyable half-URL is worse than none.
+   */ const feedUrl = host ? (()=>{
+        const origin = hostPublicOrigin(host);
+        return origin ? `${origin}/api/commerce/feed?hostId=${hostId}` : undefined;
+    })() : undefined;
+    // Host screen directory: {screenId: path} (AGL-292 template pick).
+    const screenEntries = Object.entries((_ref5 = host == null ? void 0 : host.screens) != null ? _ref5 : {}).sort(([, a], [, b])=>String(a).localeCompare(String(b)));
+    const handleSave = useCallback(async ()=>{
+        /**
+     * Refuse a save whose seed the server never confirmed (AGL-1358).
+     *
+     * There is no create path to exempt, and that is deliberate rather than
+     * an oversight: unlike a new row at a fresh uid, this writes a FIXED
+     * document path, so the all-defaults `current` produced when the cache
+     * has never seen this doc is not the harmless blank a fresh uid would
+     * be. It would put `USD`, guest checkout on and two null template ids
+     * over whatever the server really holds.
+     *
+     * The guard WRAPS the write — an early return is a shape you can keep
+     * while losing the protection.
+     */ const verdict = await writeGuardedBySeed({
+            subject: 'store settings',
+            unreadable: storeStatus === 'error',
+            fromCache: storeFromCache
+        }, async ()=>{
+            var _current_currency;
+            await setDoc(doc(firestore, 'hosts', hostId, 'settings', 'store'), {
+                pdpScreenId: current.pdpScreenId || null,
+                collectionScreenId: current.collectionScreenId || null,
+                currency: (_current_currency = current.currency) != null ? _current_currency : 'USD',
+                guestCheckout: current.guestCheckout !== false,
+                termsUrl: current.termsUrl || null,
+                receiptFooter: current.receiptFooter || null
+            }, {
+                merge: true
+            });
+        });
+        // Before `setDraft(null)`, so a refusal keeps every typed value on
+        // screen. A save that silently does nothing sends the user back to
+        // retype a form that will be refused again just as quietly.
+        if (!verdict.ok) {
+            return void enqueueSnackbar(verdict.message, {
+                variant: 'warning',
+                persist: false
+            });
+        }
+        setDraft(null);
+        enqueueSnackbar('Store settings saved', {
+            variant: 'success',
+            persist: false
+        });
+    }, [
+        current,
+        firestore,
+        hostId,
+        enqueueSnackbar,
+        storeStatus,
+        storeFromCache
+    ]);
+    return /*#__PURE__*/ _jsx(CardDisplay, {
+        header: 'Store settings',
+        help: pluginDocsHelp('commerce'),
+        contentGutterX: true,
+        contentGutterY: true,
+        children: /*#__PURE__*/ _jsxs(Stack, {
+            spacing: 1.5,
+            children: [
+                /*#__PURE__*/ _jsxs(TextField, {
+                    label: "Product page template",
+                    value: (_current_pdpScreenId = current.pdpScreenId) != null ? _current_pdpScreenId : '',
+                    onChange: (event)=>update({
+                            pdpScreenId: event.target.value
+                        }),
+                    size: "small",
+                    select: true,
+                    helperText: 'Screen rendered at /products/{slug} — design it in the ' + 'besigner with the Product detail block and {{product.*}} tokens.',
+                    children: [
+                        /*#__PURE__*/ _jsx(MenuItem, {
+                            value: "",
+                            children: 'None (product URLs 404)'
+                        }),
+                        screenEntries.map(([screenId, path])=>/*#__PURE__*/ _jsx(MenuItem, {
+                                value: screenId,
+                                children: `/${path === '/' ? '' : path}`
+                            }, screenId))
+                    ]
+                }),
+                /*#__PURE__*/ _jsxs(TextField, {
+                    label: "Collection page template",
+                    value: (_current_collectionScreenId = current.collectionScreenId) != null ? _current_collectionScreenId : '',
+                    onChange: (event)=>update({
+                            collectionScreenId: event.target.value
+                        }),
+                    size: "small",
+                    select: true,
+                    helperText: 'Screen rendered at /collections/{slug} — drop a Product grid ' + 'with source "A collection" and {{collection.*}} tokens.',
+                    children: [
+                        /*#__PURE__*/ _jsx(MenuItem, {
+                            value: "",
+                            children: 'None (collection URLs 404)'
+                        }),
+                        screenEntries.map(([screenId, path])=>/*#__PURE__*/ _jsx(MenuItem, {
+                                value: screenId,
+                                children: `/${path === '/' ? '' : path}`
+                            }, screenId))
+                    ]
+                }),
+                /*#__PURE__*/ _jsx(TextField, {
+                    label: "Currency",
+                    value: (_current_currency = current.currency) != null ? _current_currency : 'USD',
+                    onChange: (event)=>update({
+                            currency: event.target.value
+                        }),
+                    size: "small",
+                    select: true,
+                    sx: {
+                        maxWidth: 200
+                    },
+                    helperText: "Charges settle in USD; more currencies are coming",
+                    children: /*#__PURE__*/ _jsx(MenuItem, {
+                        value: "USD",
+                        children: 'USD ($)'
+                    })
+                }),
+                /*#__PURE__*/ _jsx(FormControlLabel, {
+                    control: /*#__PURE__*/ _jsx(Switch, {
+                        size: "small",
+                        checked: current.guestCheckout !== false,
+                        onChange: (event)=>update({
+                                guestCheckout: event.target.checked
+                            })
+                    }),
+                    label: "Allow guest checkout (no account required)"
+                }),
+                /*#__PURE__*/ _jsx(TextField, {
+                    label: "Terms URL",
+                    value: (_current_termsUrl = current.termsUrl) != null ? _current_termsUrl : '',
+                    onChange: (event)=>update({
+                            termsUrl: event.target.value
+                        }),
+                    size: "small",
+                    placeholder: "/terms",
+                    helperText: "Linked from checkout when set"
+                }),
+                /*#__PURE__*/ _jsx(TextField, {
+                    label: "Receipt footer",
+                    value: (_current_receiptFooter = current.receiptFooter) != null ? _current_receiptFooter : '',
+                    onChange: (event)=>update({
+                            receiptFooter: event.target.value
+                        }),
+                    size: "small",
+                    multiline: true,
+                    minRows: 2,
+                    placeholder: "Thanks for supporting our shop!"
+                }),
+                /*#__PURE__*/ _jsx(Typography, {
+                    variant: "caption",
+                    color: "text.secondary",
+                    children: 'Password protection and maintenance mode live under Site ' + 'Protection.'
+                }),
+                /*#__PURE__*/ _jsx(Button, {
+                    variant: "contained",
+                    color: "primary",
+                    size: "small",
+                    disabled: !draft,
+                    onClick: handleSave,
+                    sx: {
+                        alignSelf: 'flex-start'
+                    },
+                    children: 'Save store settings'
+                }),
+                /*#__PURE__*/ _jsxs(Stack, {
+                    spacing: 0.5,
+                    children: [
+                        /*#__PURE__*/ _jsx(Typography, {
+                            variant: "subtitle2",
+                            children: 'Product feed'
+                        }),
+                        feedUrl ? /*#__PURE__*/ _jsxs(_Fragment, {
+                            children: [
+                                /*#__PURE__*/ _jsx(TextField, {
+                                    label: "Google Merchant Center feed URL",
+                                    value: feedUrl,
+                                    size: "small",
+                                    slotProps: {
+                                        input: {
+                                            readOnly: true
+                                        }
+                                    },
+                                    onFocus: (event)=>event.target.select(),
+                                    helperText: 'Paste this into Merchant Center → Products → Feeds as a ' + 'scheduled fetch. It lists every active product with price ' + 'and availability, and refreshes itself.'
+                                }),
+                                /*#__PURE__*/ _jsx(Button, {
+                                    size: "small",
+                                    sx: {
+                                        alignSelf: 'flex-start'
+                                    },
+                                    onClick: ()=>{
+                                        var _navigator_clipboard;
+                                        void ((_navigator_clipboard = navigator.clipboard) == null ? void 0 : _navigator_clipboard.writeText(feedUrl).then(()=>enqueueSnackbar('Feed URL copied', {
+                                                variant: 'success',
+                                                persist: false
+                                            })));
+                                    },
+                                    children: 'Copy feed URL'
+                                })
+                            ]
+                        }) : /*#__PURE__*/ _jsx(Typography, {
+                            variant: "body2",
+                            color: "text.secondary",
+                            children: 'Publish this site to a subdomain or custom domain to get its ' + 'Google Merchant Center feed URL.'
+                        })
+                    ]
+                })
+            ]
+        })
+    });
+}
+StoreSettingsCard.displayName = 'StoreSettingsCard';
+export default StoreSettingsCard;
+
+//# sourceMappingURL=store-settings-card.component.js.map

package/src/lib/components/console/store-settings-card.component.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/plugins/commerce/src/lib/components/console/store-settings-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 { useSnackbar } from '@aglyn/shared-ui-snackstack'\nimport {\n  Button,\n  FormControlLabel,\n  MenuItem,\n  Stack,\n  Switch,\n  TextField,\n  Typography,\n} from '@mui/material'\nimport { doc, setDoc } from 'firebase/firestore'\nimport { useCallback, useState } from 'react'\nimport { useFirestore } from '@aglyn/tenant-feature-instance'\nimport {\n  useFirestoreDoc,\n  writeGuardedBySeed,\n} from '@aglyn/tenant-feature-instance'\nimport { hostPublicOrigin, pluginDocsHelp } from '@aglyn/aglyn'\n\nexport interface StoreSettingsCardProps {\n  hostId: string\n}\n\ninterface StoreSettings {\n  /** Screen rendered for /products/{slug} with product tokens (AGL-292). */\n  pdpScreenId?: string\n  /** Screen rendered for /collections/{slug} (AGL-298). */\n  collectionScreenId?: string\n  currency?: string\n  guestCheckout?: boolean\n  termsUrl?: string\n  receiptFooter?: string\n}\n\n/**\n * Store settings (AGL-295) on `hosts/{hostId}/settings/store`: the PDP\n * template screen (drives /products/{slug}), currency display, checkout\n * preferences, and receipt branding. Tax and shipping have their own\n * cards; store password/maintenance live in Site Protection.\n */\nexport function StoreSettingsCard(props: StoreSettingsCardProps) {\n  const { hostId } = props\n  const firestore = useFirestore()\n  const { enqueueSnackbar } = useSnackbar()\n  const {\n    data: store,\n    status: storeStatus,\n    /**\n     * The settings doc this form is seeded from is unconfirmed by the server\n     * (AGL-1358). `current` is `draft ?? {…store}` and the save writes all\n     * six keys, so `merge: true` protects only the tax and shipping maps that\n     * belong to other cards — never this card's own fields. Against a cached\n     * read, changing the currency rewrites `guestCheckout`, and the two\n     * template ids fall back to `|| null`, which is how a storefront's\n     * product and collection URLs start returning 404.\n     */\n    fromCache: storeFromCache,\n  } = useFirestoreDoc<any>(\n    () => doc(firestore, 'hosts', hostId, 'settings', 'store'),\n    [firestore, hostId],\n  )\n  const { data: host } = useFirestoreDoc<any>(\n    () => doc(firestore, 'hosts', hostId),\n    [firestore, hostId],\n  )\n  const [draft, setDraft] = useState<StoreSettings | null>(null)\n  const current: StoreSettings = draft ?? {\n    pdpScreenId: store?.pdpScreenId ?? '',\n    collectionScreenId: store?.collectionScreenId ?? '',\n    currency: store?.currency ?? 'USD',\n    guestCheckout: store?.guestCheckout !== false,\n    termsUrl: store?.termsUrl ?? '',\n    receiptFooter: store?.receiptFooter ?? '',\n  }\n  const update = (patch: Partial<StoreSettings>) =>\n    setDraft({ ...current, ...patch })\n\n  /**\n   * Google Merchant Center feed address (AGL-2249).\n   *\n   * `server/feed.ts` has served this since AGL-299, and the only place the\n   * URL was ever written down was that file's own docblock — so the feature\n   * was built, deployed, and undiscoverable. A feed nobody can find is a\n   * shopping channel nobody switches on.\n   *\n   * Through `hostPublicOrigin` rather than a hand-built string, because a\n   * store on a custom domain must be told ITS name: the feed's `<link>`\n   * elements are built from the request host, so submitting the `.aglyn.app`\n   * address for a site that serves on `shop.example.com` would put the wrong\n   * domain on every item in Merchant Center.\n   *\n   * Undefined until the host doc lands, and undefined forever for a host with\n   * neither a cname nor a subdomain — `hostPublicOrigin` returns undefined\n   * rather than a half-built URL, and a copyable half-URL is worse than none.\n   */\n  const feedUrl = host\n    ? (() => {\n        const origin = hostPublicOrigin(host)\n        return origin\n          ? `${origin}/api/commerce/feed?hostId=${hostId}`\n          : undefined\n      })()\n    : undefined\n\n  // Host screen directory: {screenId: path} (AGL-292 template pick).\n  const screenEntries = Object.entries(\n    (host?.screens ?? {}) as Record<string, string>,\n  ).sort(([, a], [, b]) => String(a).localeCompare(String(b)))\n\n  const handleSave = useCallback(async () => {\n    /**\n     * Refuse a save whose seed the server never confirmed (AGL-1358).\n     *\n     * There is no create path to exempt, and that is deliberate rather than\n     * an oversight: unlike a new row at a fresh uid, this writes a FIXED\n     * document path, so the all-defaults `current` produced when the cache\n     * has never seen this doc is not the harmless blank a fresh uid would\n     * be. It would put `USD`, guest checkout on and two null template ids\n     * over whatever the server really holds.\n     *\n     * The guard WRAPS the write — an early return is a shape you can keep\n     * while losing the protection.\n     */\n    const verdict = await writeGuardedBySeed(\n      {\n        subject: 'store settings',\n        unreadable: storeStatus === 'error',\n        fromCache: storeFromCache,\n      },\n      async () => {\n        await setDoc(\n          doc(firestore, 'hosts', hostId, 'settings', 'store'),\n          {\n            pdpScreenId: current.pdpScreenId || null,\n            collectionScreenId: current.collectionScreenId || null,\n            currency: current.currency ?? 'USD',\n            guestCheckout: current.guestCheckout !== false,\n            termsUrl: current.termsUrl || null,\n            receiptFooter: current.receiptFooter || null,\n          },\n          { merge: true },\n        )\n      },\n    )\n    // Before `setDraft(null)`, so a refusal keeps every typed value on\n    // screen. A save that silently does nothing sends the user back to\n    // retype a form that will be refused again just as quietly.\n    if (!verdict.ok) {\n      return void enqueueSnackbar(verdict.message, {\n        variant: 'warning',\n        persist: false,\n      })\n    }\n    setDraft(null)\n    enqueueSnackbar('Store settings saved', {\n      variant: 'success',\n      persist: false,\n    })\n  }, [current, firestore, hostId, enqueueSnackbar, storeStatus, storeFromCache])\n\n  return (\n    <CardDisplay\n      header={'Store settings'}\n      help={pluginDocsHelp('commerce')}\n      contentGutterX\n      contentGutterY\n    >\n      <Stack spacing={1.5}>\n        <TextField\n          label=\"Product page template\"\n          value={current.pdpScreenId ?? ''}\n          onChange={(event) => update({ pdpScreenId: event.target.value })}\n          size=\"small\"\n          select\n          helperText={\n            'Screen rendered at /products/{slug} — design it in the ' +\n            'besigner with the Product detail block and {{product.*}} tokens.'\n          }\n        >\n          <MenuItem value=\"\">{'None (product URLs 404)'}</MenuItem>\n          {screenEntries.map(([screenId, path]) => (\n            <MenuItem key={screenId} value={screenId}>\n              {`/${path === '/' ? '' : path}`}\n            </MenuItem>\n          ))}\n        </TextField>\n        <TextField\n          label=\"Collection page template\"\n          value={current.collectionScreenId ?? ''}\n          onChange={(event) =>\n            update({ collectionScreenId: event.target.value })\n          }\n          size=\"small\"\n          select\n          helperText={\n            'Screen rendered at /collections/{slug} — drop a Product grid ' +\n            'with source \"A collection\" and {{collection.*}} tokens.'\n          }\n        >\n          <MenuItem value=\"\">{'None (collection URLs 404)'}</MenuItem>\n          {screenEntries.map(([screenId, path]) => (\n            <MenuItem key={screenId} value={screenId}>\n              {`/${path === '/' ? '' : path}`}\n            </MenuItem>\n          ))}\n        </TextField>\n        <TextField\n          label=\"Currency\"\n          value={current.currency ?? 'USD'}\n          onChange={(event) => update({ currency: event.target.value })}\n          size=\"small\"\n          select\n          sx={{ maxWidth: 200 }}\n          helperText=\"Charges settle in USD; more currencies are coming\"\n        >\n          <MenuItem value=\"USD\">{'USD ($)'}</MenuItem>\n        </TextField>\n        <FormControlLabel\n          control={\n            <Switch\n              size=\"small\"\n              checked={current.guestCheckout !== false}\n              onChange={(event) =>\n                update({ guestCheckout: event.target.checked })\n              }\n            />\n          }\n          label=\"Allow guest checkout (no account required)\"\n        />\n        <TextField\n          label=\"Terms URL\"\n          value={current.termsUrl ?? ''}\n          onChange={(event) => update({ termsUrl: event.target.value })}\n          size=\"small\"\n          placeholder=\"/terms\"\n          helperText=\"Linked from checkout when set\"\n        />\n        <TextField\n          label=\"Receipt footer\"\n          value={current.receiptFooter ?? ''}\n          onChange={(event) => update({ receiptFooter: event.target.value })}\n          size=\"small\"\n          multiline\n          minRows={2}\n          placeholder=\"Thanks for supporting our shop!\"\n        />\n        <Typography variant=\"caption\" color=\"text.secondary\">\n          {'Password protection and maintenance mode live under Site ' +\n            'Protection.'}\n        </Typography>\n        <Button\n          variant=\"contained\"\n          color=\"primary\"\n          size=\"small\"\n          disabled={!draft}\n          onClick={handleSave}\n          sx={{ alignSelf: 'flex-start' }}\n        >\n          {'Save store settings'}\n        </Button>\n        <Stack spacing={0.5}>\n          <Typography variant=\"subtitle2\">{'Product feed'}</Typography>\n          {feedUrl ? (\n            <>\n              <TextField\n                label=\"Google Merchant Center feed URL\"\n                value={feedUrl}\n                size=\"small\"\n                slotProps={{ input: { readOnly: true } }}\n                onFocus={(event) => event.target.select()}\n                helperText={\n                  'Paste this into Merchant Center → Products → Feeds as a ' +\n                  'scheduled fetch. It lists every active product with price ' +\n                  'and availability, and refreshes itself.'\n                }\n              />\n              <Button\n                size=\"small\"\n                sx={{ alignSelf: 'flex-start' }}\n                onClick={() => {\n                  void navigator.clipboard?.writeText(feedUrl).then(() =>\n                    enqueueSnackbar('Feed URL copied', {\n                      variant: 'success',\n                      persist: false,\n                    }),\n                  )\n                }}\n              >\n                {'Copy feed URL'}\n              </Button>\n            </>\n          ) : (\n            <Typography variant=\"body2\" color=\"text.secondary\">\n              {'Publish this site to a subdomain or custom domain to get its ' +\n                'Google Merchant Center feed URL.'}\n            </Typography>\n          )}\n        </Stack>\n      </Stack>\n    </CardDisplay>\n  )\n}\nStoreSettingsCard.displayName = 'StoreSettingsCard'\n\nexport default StoreSettingsCard\n"],"names":["CardDisplay","useSnackbar","Button","FormControlLabel","MenuItem","Stack","Switch","TextField","Typography","doc","setDoc","useCallback","useState","useFirestore","useFirestoreDoc","writeGuardedBySeed","hostPublicOrigin","pluginDocsHelp","StoreSettingsCard","props","current","hostId","firestore","enqueueSnackbar","data","store","status","storeStatus","fromCache","storeFromCache","host","draft","setDraft","pdpScreenId","collectionScreenId","currency","guestCheckout","termsUrl","receiptFooter","update","patch","feedUrl","origin","undefined","screenEntries","Object","entries","screens","sort","a","b","String","localeCompare","handleSave","verdict","subject","unreadable","merge","ok","message","variant","persist","header","help","contentGutterX","contentGutterY","spacing","label","value","onChange","event","target","size","select","helperText","map","screenId","path","sx","maxWidth","control","checked","placeholder","multiline","minRows","color","disabled","onClick","alignSelf","slotProps","input","readOnly","onFocus","navigator","clipboard","writeText","then","displayName"],"mappings":"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"}

package/src/lib/components/console/storefront-tax-summary-card.component.d.ts

@@ -0,0 +1,73 @@
+/**
+ * @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.
+ */
+export interface StorefrontTaxSummaryCardProps {
+    hostId: string;
+}
+/**
+ * The sales tax this merchant's own storefront collected (AGL-2440).
+ *
+ * `storefrontTaxCollected` has recorded every taxed storefront sale since
+ * AGL-1904 and every reader of it was Aglyn's — the staff tax return, the DSAR
+ * export. The merchant, whose sales these are, could see one order's
+ * `totals.taxCents` at a time and nothing else. This card is that absence
+ * closed, and closing it is all it does.
+ *
+ * ## THE NUMBER, NOT THE LABEL
+ *
+ * This card presents the buckets SEPARATELY and prints no per-row verdict on
+ * who must remit which one.
+ *
+ * The copy may not say that Aglyn makes no determination: Aglyn IS a
+ * marketplace facilitator for storefront sales and the Terms publish that at
+ * §10.7 (AGL-1956), so such a line would contradict the company's own
+ * contract.
+ *
+ * Separate buckets and no per-row verdict still hold, because §10.7 is
+ * narrow: it binds Aglyn only where applicable law gives it a collection
+ * obligation for the transaction in question, which is a per-sale,
+ * per-jurisdiction test and not a fact about a merchant. So the copy still
+ * describes HOW each figure was computed — who calculated the rate, and
+ * against whose registration — and adds only what §10.7 itself says about the
+ * bucket Aglyn holds. There is still no "yours to remit" column and no total
+ * across the buckets. A merged "tax collected" figure would be the
+ * banned determination wearing a neutral name: it would sum tax Aglyn holds
+ * and remits with tax the merchant owes, the exact conflation the module warns
+ * about in bold — *the two store modes are DIFFERENT FACTS and must never be
+ * summed*. That is why the three groups never share a total row, and why the
+ * grand total in the header is a TRANSACTION COUNT rather than an amount.
+ *
+ * ## Why the caveats are on the card and not in a tooltip
+ *
+ * Both are properties of the DATA, not of the law, and both change what a
+ * merchant should do with the number: refunds are not yet reflected, so the
+ * figure over-states whenever they have refunded; and a row whose taxable base
+ * Stripe did not state is counted out loud rather than treated as a zero-base
+ * sale. A figure someone may file from cannot carry its completeness caveats
+ * behind a hover.
+ *
+ * ## Why it is route-backed and not a listener
+ *
+ * `storefrontTaxCollected` is denied to every client in the rules — the
+ * collection spans every merchant and a row carries a shopper's address. The
+ * server route applies the `hostId` boundary. Nothing here can read another
+ * merchant's sales because nothing here reads the collection at all.
+ */
+export declare function StorefrontTaxSummaryCard(props: StorefrontTaxSummaryCardProps): import("react").JSX.Element;
+export declare namespace StorefrontTaxSummaryCard {
+    var displayName: string;
+}
+export default StorefrontTaxSummaryCard;