@mohasinac/appkit 4.58.0 → 4.60.0

package/dist/features/shell/SectionForm.js

@@ -4,9 +4,11 @@ import { useCallback, useContext, useEffect, useMemo, useRef, useState } from "r
 import { Button } from "../../ui/components/Button.js";
 import { CollapsibleSection } from "../../ui/components/CollapsibleSection.js";
 import { Badge } from "../../ui/components/Badge.js";
-import { Div, Row, Span, Stack } from "../../ui/index.js";
+import { Div, Nav, Row, Span, Stack } from "../../ui/index.js";
 import { FormShellContext } from "../../ui/forms/FormShell.js";
+import { LabelPlacementContext, } from "../../ui/forms/FieldLabel.js";
 import { useFormBottomActions } from "../layout/hooks/useFormBottomActions.js";
+import { useIsDesktop } from "../layout/useIsDesktop.js";
 import { useSectionState } from "../account/hooks/useCollapsedSections.js";
 import { FormSchemaContext } from "./FormShell.js";
 import { EASE_OUT_MS } from "../../tokens/motion.js";
@@ -38,7 +40,32 @@ export function useSectionFormNav(sections, values, opts) {
         return orderSections(visible);
     }, [sections, values]);
     const sectionIds = useMemo(() => ordered.map((s) => s.id), [ordered]);
-    const defaultOpen = useMemo(() => ordered.filter((s) => s.required).map((s) => s.id), [ordered]);
+    /*
+     * 🛑 `undefined` WHEN NOTHING IS REQUIRED, not an empty array.
+     *
+     * This returned the required section ids unconditionally, and
+     * `useSectionState` documents `[]` as meaning "all collapsed" — its
+     * first-section-open default only applies when `defaultOpen` is absent. So a
+     * form whose sections are all optional opened with EVERY section collapsed:
+     * a stack of grey strips and a Save button, with no content on screen.
+     *
+     * `/admin/site` is the worst case and is what the audit screenshotted. It
+     * builds each of its 19 tabs through `SettingsTabForm`, which declares one
+     * section and marks nothing required — so picking any tab showed the
+     * tab's name on a collapsed bar above ~450px of empty white. A settings
+     * page that renders none of its settings.
+     *
+     * Falling back to `undefined` hands the decision to the hook, whose default
+     * is "first section open". For a single-section form that means open, which
+     * is the only sensible state: collapsing exists to navigate AMONG sections,
+     * and a lone section has nothing to navigate.
+     *
+     * A form that genuinely wants everything shut can still pass its own state.
+     */
+    const defaultOpen = useMemo(() => {
+        const required = ordered.filter((s) => s.required).map((s) => s.id);
+        return required.length > 0 ? required : undefined;
+    }, [ordered]);
     /*
      * The open set is `useSectionState`, not a local `useState` — which is what
      * makes "expand section 3, reload, find it still expanded" true. `scope: ""`
@@ -307,6 +334,14 @@ export function SectionForm({ sections, values, onChange, onSubmit, submitLabel
         destructiveAction,
         enabled: bottomBar && !hideActions,
     });
+    /*
+     * The bar above and the in-flow row at the end of this form are ONE
+     * decision about where the primary action lives, so they are decided
+     * together here rather than each guessing. `BottomActions` unmounts on
+     * desktop via this same hook; the row is its complement. See the row.
+     */
+    const isDesktop = useIsDesktop();
+    const showInlineActions = isDesktop || !bottomBar;
     const toggle = useCallback((id) => {
         /*
          * A DIRECT click on the header always wins. `forceOpenIds` exists to
@@ -329,7 +364,67 @@ export function SectionForm({ sections, values, onChange, onSubmit, submitLabel
             return 0;
         return section.fields.filter((f) => Object.keys(fieldErrors).some((k) => k === f || k.startsWith(`${f}.`))).length;
     }, [fieldErrors]);
-    return (_jsxs(Stack, { gap: "md", children: [ordered.map((section) => {
+    /*
+     * ── THE SECTION RAIL ────────────────────────────────────────────────────
+     *
+     * 🛑 EVERY EDITOR IN THIS APP WAS ONE NARROW COLUMN AT EVERY WIDTH. This
+     * component had no `lg:` branch anywhere, so on a 2560px display the
+     * category editor rendered four stacked accordions and `SellerProductShell`
+     * eight — ~44 controls in a single column with the whole right half of the
+     * screen empty, and the only way to reach section six was to scroll past
+     * five you were not editing.
+     *
+     * The rail is a RENDERER OVER STATE THAT ALREADY EXISTED: `ordered`,
+     * `openIds`, `errorCountFor` and the module-level `scrollToSection` are all
+     * here for the submit handler's "jump to the first invalid section"
+     * behaviour. Nothing new is stored, so the rail and the panels cannot
+     * disagree about which section is open.
+     *
+     * 🛑 FIELDS ARE NOT REFLOWED INTO TWO COLUMNS, and that is deliberate. A
+     * two-column field grid reorders tab sequence against reading order, and a
+     * form where Tab jumps right-then-left is worse than a long one. Sections
+     * side by side is safe; fields inside a section are not.
+     *
+     * 🛑 Below three sections it does not render. A two-section form has
+     * nothing to navigate — the same reasoning `useSectionFormNav` already
+     * applies to a lone section ("collapsing exists to navigate AMONG
+     * sections").
+     */
+    const showRail = ordered.length >= 3;
+    /*
+     * `sticky` under the measured header, and it publishes NO height: per the
+     * three-tier rule a sticky element CONSUMES the tier and never joins it.
+     * `hidden lg:block` because below `lg` there is no horizontal room and the
+     * accordion headers are already the navigation.
+     *
+     * The offset is a `top-[calc(…)]` UTILITY rather than an inline style — the
+     * sticky convention this repo already uses, and `audit-inline-styles` is
+     * strict-zero with its marker among the 24 banned ones. Scrolling is the
+     * `overflow` PROP, not a raw `overflow-y-auto`, which `audit-inline-styles`
+     * also blocks on an appkit primitive.
+     *
+     * 🛑 This comment lives ABOVE the statement because a `{/* … *␣/}` block
+     * inside the ternary's parentheses is EXPRESSION position, where JSX
+     * comment syntax does not parse. That is the fourth time today; the rule is
+     * simply that JSX comments belong in CHILDREN position and nowhere else.
+     */
+    const rail = showRail ? (_jsx(Div, { overflow: "auto", className: "hidden lg:block w-56 flex-shrink-0 sticky self-start top-[calc(var(--header-height,3.5rem)+1rem)] max-h-[calc(100vh-var(--header-height,3.5rem)-2rem)]", children: _jsx(Nav, { "aria-label": "Form sections", children: _jsx(Stack, { gap: "px", children: ordered.map((section) => {
+                    const errorCount = errorCountFor(section);
+                    const isOpen = section.required === true ||
+                        openIds.includes(section.id) ||
+                        forceOpenIds.includes(section.id);
+                    return (_jsxs(Button, { type: "button", 
+                        /* `ghost`, not `bare` — UI_BUTTON has no `bare` variant. */
+                        variant: "ghost", size: "sm", justify: "between", gap: "sm", className: `w-full text-left ${isOpen ? "appkit-section-rail__item--active" : ""}`, "aria-current": isOpen ? "true" : undefined, onClick: () => {
+                            if (!openIds.includes(section.id)) {
+                                setOpenIds(expandMode === "single"
+                                    ? [section.id]
+                                    : [...openIds, section.id]);
+                            }
+                            scrollToSection(section.id);
+                        }, children: [_jsx(Span, { size: "sm", color: isOpen ? "primary" : "muted", children: section.label }), errorCount > 0 && (_jsx(Span, { size: "xs", color: "error", weight: "semibold", children: errorCount }))] }, section.id));
+                }) }) }) })) : null;
+    const panels = (_jsxs(Stack, { gap: "md", children: [ordered.map((section) => {
                 const isRequired = section.required === true;
                 /*
                  * A required section is always open — it holds the fields without
@@ -357,13 +452,33 @@ export function SectionForm({ sections, values, onChange, onSubmit, submitLabel
                     /* Only after the user has tried to save — see `submitAttempted` above. */
                     submitAttempted && errorCount > 0
                         ? () => (_jsxs(Badge, { variant: "danger", children: [errorCount, " ", errorCount === 1 ? "issue" : "issues"] }))
-                        : undefined, children: section.render({
-                        values,
-                        onChange: handleFieldChange,
-                        errors: submitAttempted ? fieldErrors : EMPTY_ERRORS,
-                    }) }, section.id));
-            }), !hideActions && (
+                        : undefined, children: _jsx(LabelPlacementContext.Provider, { value: section.labelPlacement ?? "above", children: section.render({
+                            values,
+                            onChange: handleFieldChange,
+                            errors: submitAttempted ? fieldErrors : EMPTY_ERRORS,
+                        }) }) }, section.id));
+            }), !hideActions && showInlineActions && (
             /*
+             * 🛑 DESKTOP ONLY — the exact complement of the pinned bar.
+             *
+             * This row and `useFormBottomActions`' bar both render a Save, and
+             * the comment below explains why the row exists: the bar is mobile
+             * only, so desktop needed one. What neither accounted for is that on
+             * MOBILE both appear — the row at the end of the form and the fixed
+             * bar over it. That is the audit's duplicate-CTA finding, and its
+             * mobile checkout screenshot: two stacked CTAs ~60px apart with the
+             * in-flow one clipped by the bar sitting on top of it.
+             *
+             * Gated on `useIsDesktop()` — the SAME hook `BottomActions` uses to
+             * decide it should unmount — rather than a `lg:` class, so the two
+             * cannot disagree about where the boundary is. A class would also
+             * leave this row in the DOM, where it still takes focus and still
+             * answers a query, which is how it was counted as a second button on
+             * desktop in the first place.
+             *
+             * `|| !bottomBar` keeps a caller that opted out of the bar from
+             * losing its only submit control on mobile.
+             *
              * `justify="between"` so a destructive action sits opposite Save
              * rather than beside it. With no destructive action the empty <Div>
              * still holds the left edge, keeping Save right-aligned.
@@ -374,5 +489,14 @@ export function SectionForm({ sections, values, onChange, onSubmit, submitLabel
              * `store/categories/new`, which had one before.
              */
             _jsxs(Row, { justify: "between", align: "center", paddingY: "y-sm", gap: "sm", wrap: true, children: [_jsx(Div, { children: destructiveAction && (_jsx(Button, { variant: "danger", type: "button", onClick: destructiveAction.onClick, disabled: destructiveAction.disabled || isLoading, children: destructiveAction.label })) }), _jsxs(Row, { gap: "sm", children: [onCancel && (_jsx(Button, { variant: "ghost", type: "button", onClick: onCancel, disabled: isLoading, children: cancelLabel })), _jsx(Button, { variant: "primary", type: "submit", onClick: handleSubmit, isLoading: isLoading, disabled: isLoading, children: submitLabel })] })] }))] }));
+    if (!rail)
+        return panels;
+    /*
+     * `min-w-0` on the panel column is load-bearing: a flex child defaults to
+     * `min-width: auto`, so one wide table or a long unbroken string inside a
+     * section would push the column past the container instead of wrapping, and
+     * the rail would be shoved off-screen.
+     */
+    return (_jsxs(Row, { gap: "lg", align: "start", children: [rail, _jsx(Div, { className: "min-w-0 flex-1", children: panels })] }));
 }
 export default SectionForm;

package/dist/features/shell/SectionForm.style.css

@@ -0,0 +1,54 @@
+/*
+ * The section rail — `SectionForm`'s `lg+` navigation column.
+ *
+ * 🛑 THIS FILE EXISTS BECAUSE `audit-dead-css-classes` CAUGHT ME INVENTING A
+ * CLASS WITH NO RULE. `appkit-section-rail__item--active` was written into the
+ * component and defined nowhere, so the active item would have been
+ * indistinguishable from the rest — a rail whose whole job is to say "you are
+ * here" saying nothing. Tailwind silently drops an unknown utility and a
+ * hand-written BEM class simply never matches, so neither failure announces
+ * itself; the audit is the only thing that does.
+ *
+ * ── WHY A CLASS RATHER THAN A VARIANT PROP ──────────────────────────────────
+ *
+ * Root Cause #21 says styling goes through variant props, and that is right
+ * for anything a primitive already models. This is the exception the rule
+ * allows: the active marker is a left border INSIDE the button's own box plus
+ * a tinted surface, and `Button` exposes neither a "selected" state nor a
+ * border-inline-start variant. Adding both to `Button` for one consumer would
+ * be the wider change.
+ *
+ * The ink is still carried by a prop (`<Span color="primary">` vs `"muted"`),
+ * so this file only draws the parts a variant cannot.
+ */
+
+.appkit-section-rail__item--active {
+  /*
+   * 🛑 A THEME-RELATIVE SURFACE, NOT A NAMED PALETTE TINT. Root Cause #79: a
+   * `bg-primary-50`-style tint is the same near-white fill in every theme, so
+   * under dark ink it is white-on-white. `--appkit-color-primary-surface` is
+   * declared per theme and inverts with it.
+   */
+  background: var(--appkit-color-primary-surface);
+
+  /*
+   * `border-inline-start`, not `border-left` — the app ships an RTL-capable
+   * locale set and the marker belongs on the reading-order edge.
+   *
+   * Inset via a transparent border on the inactive state would be cleaner, but
+   * `Button` owns its own padding; a box-shadow draws the bar without
+   * participating in layout, so the label does not shift by 2px when a section
+   * opens.
+   */
+  box-shadow: inset 2px 0 0 0 var(--appkit-color-primary);
+}
+
+/*
+ * 🛑 `:hover` must not out-rank the active state. Both configs set
+ * `important: true`, so a Tailwind hover utility on the Button would beat this
+ * file's normal declaration — which is why the active marker is a
+ * `box-shadow` (nothing sets that) and a `background` applied through a
+ * dedicated class rather than a utility that a hover variant could tie with.
+ * See Root Cause #106: for `!important`, un-layered CSS sorts LOWEST, so a
+ * plain file like this one can never win an importance tie.
+ */

package/dist/features/shipments/components/AdminShipmentsView.js

@@ -3,7 +3,12 @@ import { jsx as _jsx } from "react/jsx-runtime";
 import { sieveFilter, SIEVE_OP } from "@mohasinac/appkit/client";
 import { sortBy } from "@mohasinac/appkit/client";
 import React from "react";
-import { FilterChipGroup, ListingLayout } from "../../../ui/index.js";
+import { FilterChipGroup, ListingLayout, TextLink } from "../../../ui/index.js";
+// 🛑 From the DEFINING module, not `@mohasinac/appkit/client` — this file is a
+// client component, but `ROUTES` is a runtime value and the `/client` entry is
+// where Root Cause #76's React #441 comes from when a server component touches
+// the same import. One spelling everywhere is cheaper than two rules.
+import { ROUTES } from "../../../next/routing/route-map.js";
 import { ADMIN_ENDPOINTS } from "../../../constants/api-endpoints.js";
 import { toRecordArray, toRelativeDate, toStringValue, } from "../../admin/hooks/useAdminListingData.js";
 import { DataListingView } from "../../admin/components/DataListingView.js";
@@ -75,6 +80,16 @@ export function AdminShipmentsView({ children, ...props }) {
             onClick: () => selection.clearSelection(),
         })),
         renderFilterPanel: ({ pendingFilters, setPendingFilters }) => (_jsx(FilterChipGroup, { label: "Status", tabs: STATUS_OPTIONS, value: pendingFilters.status ?? "", onChange: (id) => setPendingFilters((p) => ({ ...p, status: id })) })),
+        /*
+         * 🛑 THE ONLY LINK TO THE RECEIVE STATION.
+         *
+         * `ROUTES.ADMIN.SHIPMENT_RECEIVE` existed with ZERO consumers — a built
+         * page reachable only by typing its URL, which is Root Cause #37's shape
+         * and the reason ~25 working admin features sat unreachable. Receiving
+         * belongs on the row rather than in the nav because it is always about one
+         * shipment; a nav entry would have to ask which.
+         */
+        renderRowActions: (row) => (_jsx(TextLink, { href: String(ROUTES.ADMIN.SHIPMENT_RECEIVE(row.id)), children: "Receive" })),
         renderEditor: ({ editId, closePanel }) => (_jsx(AdminShipmentEditorView, { shipmentId: editId ?? undefined, onSaved: closePanel, embedded: true })),
         resolveEditorTitle: ({ isCreate }) => (isCreate ? "New Shipment" : "Edit Shipment"),
     };

package/dist/features/shipments/repository/shipment-items.repository.d.ts

@@ -9,6 +9,15 @@ import { type ShipmentItem, type ShipmentItemCreateInput, type ShipmentItemUpdat
 export declare class ShipmentItemsRepository extends BaseRepository<ShipmentItem> {
     constructor();
     listByLot(lotId: string, model?: SieveModel): Promise<FirebaseSieveResult<ShipmentItem>>;
+    /**
+     * Every tracked item across a shipment's lots, in one query.
+     *
+     * The receive station needs this: an operator opening a crate works through
+     * the whole shipment, not one lot at a time, and walking the lots to fetch
+     * items per lot is an N+1 against Rule #6's ~3-round-trip budget for a page
+     * that already has a 50-row ceiling.
+     */
+    listByShipment(shipmentId: string, model?: SieveModel): Promise<FirebaseSieveResult<ShipmentItem>>;
     countByLot(lotId: string): Promise<number>;
     /** Cheap bounded existence check — any item in this lot still linked to a product? */
     hasLinkedItemsInLot(lotId: string): Promise<boolean>;

package/dist/features/shipments/repository/shipment-items.repository.js

@@ -15,6 +15,20 @@ export class ShipmentItemsRepository extends BaseRepository {
     async listByLot(lotId, model) {
         return this.sieveQuery({ ...(model ?? {}), filters: sieveAnd(sieveFilter("lotId", SIEVE_OP.EQ, lotId), model?.filters) }, ShipmentItemsRepository.SIEVE_FIELDS, { defaultPageSize: 50, maxPageSize: 100 });
     }
+    /**
+     * Every tracked item across a shipment's lots, in one query.
+     *
+     * The receive station needs this: an operator opening a crate works through
+     * the whole shipment, not one lot at a time, and walking the lots to fetch
+     * items per lot is an N+1 against Rule #6's ~3-round-trip budget for a page
+     * that already has a 50-row ceiling.
+     */
+    async listByShipment(shipmentId, model) {
+        return this.sieveQuery({
+            ...(model ?? {}),
+            filters: sieveAnd(sieveFilter("shipmentId", SIEVE_OP.EQ, shipmentId), model?.filters),
+        }, ShipmentItemsRepository.SIEVE_FIELDS, { defaultPageSize: 50, maxPageSize: 100 });
+    }
     async countByLot(lotId) {
         const snap = await this.getCollection().where(SHIPMENT_ITEM_FIELDS.LOT_ID, "==", lotId).count().get();
         return snap.data().count;

package/dist/features/site-settings/components/ActionPermissionsManager.js

@@ -57,7 +57,7 @@ const CATEGORY_COLORS = {
     "Messaging": "bg-cyan-100 text-cyan-800 dark:bg-cyan-900/30 dark:text-cyan-300",
     "Seller": "bg-warning-surface text-warning dark:bg-warning-surface dark:text-warning",
     "Orders": "bg-lime-100 text-lime-800 dark:bg-lime-900/30 dark:text-lime-300",
-    "Account": "bg-[var(--appkit-color-surface)] bg-[var(--appkit-color-surface-elevated)] text-[var(--appkit-color-text-muted)]",
+    "Account": "bg-[var(--appkit-color-surface-elevated)] text-[var(--appkit-color-text-muted)]",
 };
 const ALL_ACTION_IDS = Object.values(ACTION_ID);
 export function ActionPermissionsManager({ initialConfig, onUpdate }) {

package/dist/features/sticker-trace/components/StickerCommitPanel.js

@@ -87,7 +87,7 @@ export function StickerCommitPanel({ file, dimensions, onCommit, onCommitted, })
         }
     }, [file, dimensions, title, tier, onCommit, onCommitted]);
     if (!file) {
-        return (_jsx(Card, { variant: "default", children: _jsx(Text, { color: "muted", children: "Pick a scan and tune it above. Nothing is uploaded until you commit a run \u2014 the trace you are watching runs entirely in this tab." }) }));
+        return (_jsx(Card, { variant: "default", children: _jsx(Text, { color: "muted", children: "Pick a scan and tune it above to commit a run." }) }));
     }
     return (_jsx(Card, { variant: "default", children: _jsx(Form, { onSubmit: (e) => e.preventDefault(), children: _jsxs(Stack, { gap: "comfortable", children: [_jsx(Heading, { level: 3, children: "Commit this as a run" }), _jsxs(Text, { size: "sm", color: "muted", children: ["Uploads ", _jsx(Text, { as: "span", weight: "semibold", children: file.name }), " (", sizeMb, " MB) and traces it at full resolution on the server. The parameters you tuned above are the starting point; a run keeps its own copy, so later edits here never change what an earlier run recorded."] }), error ? _jsx(Alert, { variant: "error", children: error }) : null, _jsx(FieldInput, { name: "title", label: "Name this sheet", required: true, value: title, onChange: setTitle }), _jsx(Text, { size: "xs", color: "muted", children: "Required \u2014 nothing processes without one. Name it so you recognise it next to the others: \u201CDriger G, matte scan 600dpi\u201D." }), _jsx(FieldSelect, { name: "tier", label: "Tier", value: tier, options: TIERS.map((t) => ({ value: t, label: TIER_HELP[t].title })), onChange: (v) => setTier(v) }), _jsx(Text, { size: "xs", color: "muted", children: TIER_HELP[tier].body }), tier === "max" ? (_jsx(Alert, { variant: "warning", children: "Max is expensive in both time and quota, and its finer simplify can push a busy sheet past Design Space's node ceiling. Try precise first unless a halftone scan is merging two stickers." })) : null, !dimensions ? (_jsx(Text, { size: "xs", color: "muted", children: "Waiting for the scan to finish decoding\u2026" })) : null, _jsx(Button, { type: "submit", variant: "primary", isLoading: pending, disabled: !ready, onClick: submit, children: pending ? "Uploading and starting…" : "Upload and run" })] }) }) }));
 }

package/dist/features/store-extensions/schemas/report-review-form.d.ts

@@ -15,16 +15,16 @@ export declare const reportReviewFormSchema: z.ZodEffects<z.ZodObject<{
     status: z.ZodEnum<["under-review", "actioned", "dismissed"]>;
     resolution: z.ZodOptional<z.ZodString>;
 }, "strict", z.ZodTypeAny, {
-    status: "dismissed" | "under-review" | "actioned";
+    status: "under-review" | "actioned" | "dismissed";
     resolution?: string | undefined;
 }, {
-    status: "dismissed" | "under-review" | "actioned";
+    status: "under-review" | "actioned" | "dismissed";
     resolution?: string | undefined;
 }>, {
-    status: "dismissed" | "under-review" | "actioned";
+    status: "under-review" | "actioned" | "dismissed";
     resolution?: string | undefined;
 }, {
-    status: "dismissed" | "under-review" | "actioned";
+    status: "under-review" | "actioned" | "dismissed";
     resolution?: string | undefined;
 }>;
 export type ReportReviewFormValues = z.infer<typeof reportReviewFormSchema>;
@@ -33,15 +33,15 @@ export declare const reportReviewUpdateSchema: z.ZodEffects<z.ZodObject<{
     status: z.ZodEnum<["under-review", "actioned", "dismissed"]>;
     resolution: z.ZodOptional<z.ZodString>;
 }, "strict", z.ZodTypeAny, {
-    status: "dismissed" | "under-review" | "actioned";
+    status: "under-review" | "actioned" | "dismissed";
     resolution?: string | undefined;
 }, {
-    status: "dismissed" | "under-review" | "actioned";
+    status: "under-review" | "actioned" | "dismissed";
     resolution?: string | undefined;
 }>, {
-    status: "dismissed" | "under-review" | "actioned";
+    status: "under-review" | "actioned" | "dismissed";
     resolution?: string | undefined;
 }, {
-    status: "dismissed" | "under-review" | "actioned";
+    status: "under-review" | "actioned" | "dismissed";
     resolution?: string | undefined;
 }>;

package/dist/features/stores/components/StoreGuideHubView.js

@@ -77,7 +77,7 @@ export function StoreGuideHubView({ store }) {
     const storeName = store?.storeName ?? "Your Store";
     const steps = buildChecklist(store);
     const completedCount = steps.filter((s) => s.done).length;
-    return (_jsxs(Stack, { gap: "xl", padding: "b-2xl", children: [_jsx(Section, { overflow: "hidden", className: "border border-[var(--appkit-color-border)] bg-[var(--appkit-color-surface)]", rounded: "2xl", shadow: "sm", children: _jsxs(Div, { paddingX: "x-md-xl", paddingY: "y-xl", className: "[background:linear-gradient(135deg,var(--appkit-color-primary-700)_0%,var(--appkit-color-cobalt)_60%,var(--appkit-color-secondary-400)_100%)]", children: [_jsxs(Row, { className: "mb-3", align: "center", gap: "3", children: [_jsx(Row, { className: "flex-shrink-0 w-10 h-10", surface: "default", align: "center", justify: "center", rounded: "xl", children: _jsx(BookOpen, { className: "w-5 h-5 text-white" }) }), _jsx(Text, { color: "inverse", className: "/80 tracking-widest", size: "sm", weight: "semibold", transform: "uppercase", children: "Seller Guide" })] }), _jsx(Heading, { color: "inverse", level: 1, className: "mb-2", mdSize: "3xl", size: "2xl", weight: "bold", children: storeName }), _jsx(Text, { color: "inverse", className: "/80", size: "base", children: "Everything you need to know about selling on LetItRip." })] }) }), _jsxs(Div, { layout: "grid", gap: "8", className: "grid-cols-1 lg:grid-cols-3", children: [_jsxs(Stack, { className: "lg:col-span-2", gap: "md", children: [_jsx(Heading, { level: 2, className: "text-[var(--appkit-color-text)]", size: "lg", weight: "semibold", children: "Guides" }), _jsx(Grid, { cols: "cardsWide", gap: "md", children: GUIDE_CARDS.map(({ Icon, title, description, href }) => (_jsxs(TextLink, { variant: "bare", href: href, rounded: "xl", layout: "flex-col", gap: "md", paddingX: "lg", paddingY: "lg", shadow: "hover-md", className: "group border border-[var(--appkit-color-border)] bg-[var(--appkit-color-surface)] hover:border-[var(--appkit-color-primary)] transition-all", children: [_jsxs(Row, { align: "center", gap: "3", children: [_jsx(Row, { className: "flex-shrink-0 w-9 h-9 [background:linear-gradient(135deg,var(--appkit-color-primary-700)_0%,var(--appkit-color-cobalt)_100%)]", align: "center", justify: "center", rounded: "lg", children: _jsx(Icon, { className: "w-4 h-4 text-white" }) }), _jsx(Text, { className: "text-[var(--appkit-color-text)] group-hover:text-[var(--appkit-color-primary)] transition-colors", weight: "semibold", children: title })] }), _jsx(Text, { className: "text-[var(--appkit-color-text-muted)] leading-relaxed", size: "sm", children: description }), _jsx(Text, { className: "text-[var(--appkit-color-primary)] mt-auto", size: "xs", weight: "medium", children: "Read guide \u2192" })] }, title))) })] }), _jsxs(Stack, { gap: "md", children: [_jsx(Heading, { level: 2, className: "text-[var(--appkit-color-text)]", size: "lg", weight: "semibold", children: "Getting started" }), _jsxs(Div, { overflow: "hidden", className: "border border-[var(--appkit-color-border)] bg-[var(--appkit-color-surface)]", rounded: "xl", children: [_jsxs(Div, { className: "px-[1.25rem] pt-[1.25rem] border-b border-[var(--appkit-color-border)]", padding: "b-md", children: [_jsxs(Row, { className: "mb-2", align: "center", justify: "between", children: [_jsxs(Text, { className: "text-[var(--appkit-color-text)]", size: "sm", weight: "medium", children: [completedCount, " of ", steps.length, " complete"] }), _jsxs(Text, { className: "text-[var(--appkit-color-text-muted)]", size: "xs", children: [Math.round((completedCount / steps.length) * 100), "%"] })] }), _jsx(Progress, { value: completedCount, max: steps.length, size: "sm", variant: "gradient" })] }), _jsx(Div, { className: "divide-y divide-[var(--appkit-color-border)]", children: steps.map(({ label, done, href }) => (_jsxs(TextLink, { variant: "bare", href: done ? "#" : href, "aria-disabled": done, layout: "flex", align: "center", gap: "sm", paddingX: "lg", paddingY: "sm-tall", size: "sm", className: `transition-colors ${done
+    return (_jsxs(Stack, { gap: "xl", padding: "b-2xl", children: [_jsx(Section, { overflow: "hidden", className: "border border-[var(--appkit-color-border)] bg-[var(--appkit-color-surface)]", rounded: "2xl", shadow: "sm", children: _jsxs(Div, { paddingX: "x-md-xl", paddingY: "y-xl", className: "[background:linear-gradient(135deg,var(--appkit-color-primary-700)_0%,var(--appkit-color-cobalt)_60%,var(--appkit-color-secondary-400)_100%)]", children: [_jsxs(Row, { className: "mb-3", align: "center", gap: "3", children: [_jsx(Row, { className: "flex-shrink-0 w-10 h-10", surface: "default", align: "center", justify: "center", rounded: "xl", children: _jsx(BookOpen, { className: "w-5 h-5 text-white" }) }), _jsx(Text, { color: "inverse-muted", className: "tracking-widest", size: "sm", weight: "semibold", transform: "uppercase", children: "Seller Guide" })] }), _jsx(Heading, { color: "inverse", level: 1, className: "mb-2", mdSize: "3xl", size: "2xl", weight: "bold", children: storeName }), _jsx(Text, { color: "inverse-muted", size: "base", children: "Everything you need to know about selling on LetItRip." })] }) }), _jsxs(Div, { layout: "grid", gap: "8", className: "grid-cols-1 lg:grid-cols-3", children: [_jsxs(Stack, { className: "lg:col-span-2", gap: "md", children: [_jsx(Heading, { level: 2, className: "text-[var(--appkit-color-text)]", size: "lg", weight: "semibold", children: "Guides" }), _jsx(Grid, { cols: "cardsWide", gap: "md", children: GUIDE_CARDS.map(({ Icon, title, description, href }) => (_jsxs(TextLink, { variant: "bare", href: href, rounded: "xl", layout: "flex-col", gap: "md", paddingX: "lg", paddingY: "lg", shadow: "hover-md", className: "group border border-[var(--appkit-color-border)] bg-[var(--appkit-color-surface)] hover:border-[var(--appkit-color-primary)] transition-all", children: [_jsxs(Row, { align: "center", gap: "3", children: [_jsx(Row, { className: "flex-shrink-0 w-9 h-9 [background:linear-gradient(135deg,var(--appkit-color-primary-700)_0%,var(--appkit-color-cobalt)_100%)]", align: "center", justify: "center", rounded: "lg", children: _jsx(Icon, { className: "w-4 h-4 text-white" }) }), _jsx(Text, { className: "text-[var(--appkit-color-text)] group-hover:text-[var(--appkit-color-primary)] transition-colors", weight: "semibold", children: title })] }), _jsx(Text, { className: "text-[var(--appkit-color-text-muted)] leading-relaxed", size: "sm", children: description }), _jsx(Text, { className: "text-[var(--appkit-color-primary)] mt-auto", size: "xs", weight: "medium", children: "Read guide \u2192" })] }, title))) })] }), _jsxs(Stack, { gap: "md", children: [_jsx(Heading, { level: 2, className: "text-[var(--appkit-color-text)]", size: "lg", weight: "semibold", children: "Getting started" }), _jsxs(Div, { overflow: "hidden", className: "border border-[var(--appkit-color-border)] bg-[var(--appkit-color-surface)]", rounded: "xl", children: [_jsxs(Div, { className: "px-[1.25rem] pt-[1.25rem] border-b border-[var(--appkit-color-border)]", padding: "b-md", children: [_jsxs(Row, { className: "mb-2", align: "center", justify: "between", children: [_jsxs(Text, { className: "text-[var(--appkit-color-text)]", size: "sm", weight: "medium", children: [completedCount, " of ", steps.length, " complete"] }), _jsxs(Text, { className: "text-[var(--appkit-color-text-muted)]", size: "xs", children: [Math.round((completedCount / steps.length) * 100), "%"] })] }), _jsx(Progress, { value: completedCount, max: steps.length, size: "sm", variant: "gradient" })] }), _jsx(Div, { className: "divide-y divide-[var(--appkit-color-border)]", children: steps.map(({ label, done, href }) => (_jsxs(TextLink, { variant: "bare", href: done ? "#" : href, "aria-disabled": done, layout: "flex", align: "center", gap: "sm", paddingX: "lg", paddingY: "sm-tall", size: "sm", className: `transition-colors ${done
                                                 ? "cursor-default"
                                                 : "hover:bg-[var(--appkit-color-border)]/30"}`, children: [done ? (_jsx(CheckCircle2, { className: CLS_CHECK_ICON })) : (_jsx(Circle, { className: "w-5 h-5 flex-shrink-0 text-[var(--appkit-color-text-muted)]" })), _jsx(Text, { className: `leading-snug ${done
                                                         ? "line-through text-[var(--appkit-color-text-muted)]"

package/dist/features/stores/components/StoreHeader.js

@@ -14,7 +14,7 @@ const CLS_STARS = "inline-flex items-center gap-[var(--appkit-space-1)] text-war
 const CLS_FOLLOW_BTN = "rounded-lg border border-warning px-[var(--appkit-space-4)] py-[var(--appkit-space-2)] text-[length:var(--appkit-text-sm)] font-medium text-warning hover:bg-warning-surface transition-colors";
 const CLS_WARN_BANNER = "mt-3 rounded-lg bg-warning-surface dark:bg-warning-surface border border-warning dark:border-warning px-[var(--appkit-space-3)] py-[var(--appkit-space-2)] text-[length:var(--appkit-text-sm)] text-warning dark:text-warning";
 export function StoreHeader({ store, labels = {}, onFollow, className = "", trust, }) {
-    return (_jsxs(Section, { surface: "default", border: "bottom", className: className, children: [store.storeBannerURL && (_jsx(Div, { className: `relative h-40 md:h-56 ${__O.hidden} bg-[var(--appkit-color-surface)] bg-[var(--appkit-color-surface-elevated)]`, children: _jsx(MediaImage, { src: store.storeBannerURL, alt: `${store.storeName} banner`, size: "banner" }) })), _jsxs(Div, { paddingX: "x-page", className: "max-w-7xl mx-auto", padding: "y-md", children: [_jsxs(Row, { align: "end", gap: "md", children: [store.storeLogoURL ? (_jsx(Div, { className: "relative -mt-8 h-16 w-16 border-2 border-white", rounded: "xl", shadow: "sm", overflow: "hidden", children: _jsx(MediaImage, { src: store.storeLogoURL, alt: store.storeName, size: "avatar" }) })) : (_jsx(Div, { className: CLS_AVATAR, children: store.storeName[0]?.toUpperCase() })), _jsxs(Div, { className: "flex-1 min-w-0", children: [_jsxs(Row, { className: "mb-0.5", align: "center", gap: "sm", wrap: true, children: [_jsx(Heading, { level: 1, className: "text-[var(--appkit-color-text)]", size: "xl", weight: "bold", children: store.storeName }), store.averageRating != null && store.averageRating > 0 && (_jsxs(Span, { size: "sm", weight: "medium", className: CLS_STARS, children: ["\u2605 ", store.averageRating.toFixed(1)] })), trust && _jsx(SellerTrustBadge, { trust: trust }), _jsx(OwnerQuickActions, { resource: "STORE", placement: "detail", editHref: String(ROUTES.ADMIN.STORE_DETAIL(store.storeSlug)), recordLabel: store.storeName })] }), _jsxs(Row, { textSize: "xs", className: "text-[var(--appkit-color-text-muted)] mb-0.5", gap: "3", children: [store.category && _jsx(Span, { transform: "capitalize", children: store.category }), store.totalProducts != null && store.totalProducts > 0 && (_jsxs(Span, { children: [store.totalProducts, " ", labels.products ?? "products"] })), store.totalReviews != null && store.totalReviews > 0 && (_jsxs(Span, { children: [store.totalReviews, " ", labels.reviews ?? "reviews"] })), store.itemsSold != null && store.itemsSold > 0 && (_jsxs(Span, { children: [store.itemsSold, " ", labels.sold ?? "sold"] }))] }), store.storeDescription && (_jsx(RichText, { html: normalizeRichTextHtml(store.storeDescription), copyableCode: true, className: "mt-0.5" }))] }), _jsxs(Row, { gap: "sm", align: "center", className: "shrink-0", children: [_jsx(ShareButton, { title: store.storeName }), onFollow && (_jsx(Button, { type: "button", variant: "outline", size: "sm", onClick: () => onFollow(store.storeSlug), className: CLS_FOLLOW_BTN, children: labels.follow ?? "Follow" }))] })] }), store.isVacationMode && (_jsx(Text, { className: CLS_WARN_BANNER, children: store.vacationMessage ??
+    return (_jsxs(Section, { surface: "default", border: "bottom", className: className, children: [store.storeBannerURL && (_jsx(Div, { className: `relative h-40 md:h-56 ${__O.hidden} bg-[var(--appkit-color-surface)] bg-[var(--appkit-color-surface-elevated)]`, children: _jsx(MediaImage, { src: store.storeBannerURL, alt: `${store.storeName} banner`, size: "banner" }) })), _jsxs(Div, { paddingX: "x-page", className: "max-w-7xl mx-auto", padding: "y-md", children: [_jsxs(Row, { align: "end", gap: "md", children: [store.storeLogoURL ? (_jsx(Div, { className: "relative -mt-8 h-16 w-16 border-2 border-white", rounded: "xl", shadow: "sm", overflow: "hidden", children: _jsx(MediaImage, { src: store.storeLogoURL, alt: store.storeName, size: "avatar" }) })) : (_jsx(Div, { className: CLS_AVATAR, children: store.storeName[0]?.toUpperCase() })), _jsxs(Div, { className: "flex-1 min-w-0", children: [_jsxs(Row, { className: "mb-0.5", align: "center", gap: "sm", wrap: true, children: [_jsx(Heading, { level: 1, className: "text-[var(--appkit-color-text)]", size: "xl", weight: "bold", children: store.storeName }), store.averageRating != null && store.averageRating > 0 && (_jsxs(Span, { size: "sm", weight: "medium", className: CLS_STARS, children: ["\u2605 ", store.averageRating.toFixed(1)] })), trust && _jsx(SellerTrustBadge, { trust: trust })] }), _jsx(OwnerQuickActions, { resource: "STORE", placement: "detail", editHref: String(ROUTES.ADMIN.STORE_DETAIL(store.storeSlug)), recordLabel: store.storeName }), _jsxs(Row, { textSize: "xs", className: "text-[var(--appkit-color-text-muted)] mb-0.5", gap: "3", children: [store.category && _jsx(Span, { transform: "capitalize", children: store.category }), store.totalProducts != null && store.totalProducts > 0 && (_jsxs(Span, { children: [store.totalProducts, " ", labels.products ?? "products"] })), store.totalReviews != null && store.totalReviews > 0 && (_jsxs(Span, { children: [store.totalReviews, " ", labels.reviews ?? "reviews"] })), store.itemsSold != null && store.itemsSold > 0 && (_jsxs(Span, { children: [store.itemsSold, " ", labels.sold ?? "sold"] }))] }), store.storeDescription && (_jsx(RichText, { html: normalizeRichTextHtml(store.storeDescription), copyableCode: true, className: "mt-0.5" }))] }), _jsxs(Row, { gap: "sm", align: "center", className: "shrink-0", children: [_jsx(ShareButton, { title: store.storeName }), onFollow && (_jsx(Button, { type: "button", variant: "outline", size: "sm", onClick: () => onFollow(store.storeSlug), className: CLS_FOLLOW_BTN, children: labels.follow ?? "Follow" }))] })] }), store.isVacationMode && (_jsx(Text, { className: CLS_WARN_BANNER, children: store.vacationMessage ??
                             labels.vacationMode ??
                             "Store is on vacation mode" }))] })] }));
 }

package/dist/features/support/schemas/firestore.d.ts

@@ -28,6 +28,7 @@ export declare const TicketCategoryValues: {
     readonly GENERAL: "general";
     readonly STORE_CHANGE_REQUEST: "store_change_request";
     readonly ORDER_MODIFICATION_REQUEST: "order_modification_request";
+    readonly GRIEVANCE: "grievance";
     readonly UNBAN_REQUEST: "unban_request";
 };
 export type TicketCategory = (typeof TicketCategoryValues)[keyof typeof TicketCategoryValues];
@@ -49,7 +50,52 @@ export type TicketPriority = (typeof TicketPriorityValues)[keyof typeof TicketPr
 /** Statuses considered "active" for limit-enforcement purposes. */
 export declare const ACTIVE_TICKET_STATUSES: TicketStatus[];
 /** Order statuses that are eligible for a support ticket. */
-export declare const ELIGIBLE_ORDER_STATUSES_FOR_TICKET: readonly ["PENDING", "PROCESSING", "SHIPPED", "RETURN_REQUESTED"];
+/**
+ * 🛑 THIS CONSTANT IS DEAD — it has no consumer, and that CORRECTS D22.
+ *
+ * The plan records: *"`DELIVERED` is absent from
+ * `ELIGIBLE_ORDER_STATUSES_FOR_TICKET` — the status most money complaints arise
+ * in — as is `REFUNDED`"*, and concludes a buyer whose delivered order is wrong
+ * *"may be unable to attach a ticket to it"*.
+ *
+ * Measured: the only references anywhere are this declaration and its
+ * re-export from `appkit/src/index.ts`. **`createTicket` applies no order-status
+ * gate at all**, so nothing is excluded and no buyer is blocked. The list is
+ * also in UPPERCASE while `OrderStatus` is lowercase, so had anything compared
+ * against it directly it would have matched *nothing* and blocked EVERY order —
+ * the Root Cause #33 shape, latent.
+ *
+ * Left in place rather than deleted: it is exported from the public barrel, so
+ * removing it is a breaking change for a consumer, and `DELIVERED`/`REFUNDED`
+ * are added so that if anything ever does consume it, it is correct on the day
+ * it becomes live rather than wrong in the direction the plan feared.
+ *
+ * The plan's other D22 claims are also stale and worth recording:
+ * `resolvedAt`/`closedAt` DO have a writer (`support.repository.ts` stamps them
+ * on the transition into RESOLVED, fixed 2026-08-26), and no per-order ticket
+ * limit is enforced anywhere. What was genuinely missing is the CLOCK —
+ * `acknowledgedAt`, `dueAt`, `firstResponseAt`, `disputedAmount` — which Phase
+ * 10 adds above.
+ */
+export declare const ELIGIBLE_ORDER_STATUSES_FOR_TICKET: readonly ["PENDING", "PROCESSING", "SHIPPED", "RETURN_REQUESTED", "DELIVERED", "REFUNDED"];
+/**
+ * Statutory grievance periods, in hours. **Defaults, pending the owner.**
+ *
+ * 🛑 I am not asserting the real statutory numbers from memory. These are
+ * placeholders chosen to be *shorter* than any plausible statutory period, so
+ * the internal clock fires EARLY rather than late — a deadline we beat is
+ * harmless, one we miss is the thing the regime exists to punish.
+ *
+ * Nothing published reads these. The public `/grievance` page is untouched
+ * until the owner supplies a named officer and the actual periods (D17), at
+ * which point these become the `settingPath`-backed values.
+ */
+export declare const GRIEVANCE_PERIODS: {
+    /** Acknowledge receipt within this. */
+    readonly acknowledgeHours: 48;
+    /** Resolve within this. */
+    readonly resolveHours: number;
+};
 export type TicketMessage = {
     id: string;
     authorId: string;
@@ -151,6 +197,31 @@ export interface SupportTicketDocument extends BaseDocument {
      */
     resolvedAt?: Date;
     closedAt?: Date;
+    /** When we acknowledged receipt. Server-stamped at intake. */
+    acknowledgedAt?: Date;
+    /**
+     * The resolution deadline.
+     *
+     * 🛑 A hard date, like a chargeback's `respond_by` — not an SLA we invented
+     * for comfort. It is what makes "how long do tickets take" answerable for
+     * the first time, which is the evidence a grievance regime actually requires.
+     */
+    dueAt?: Date;
+    /**
+     * When a human first replied — distinct from `acknowledgedAt`, which is
+     * automatic. An acknowledgement is a receipt; a first response is a person.
+     * Conflating them would let an auto-reply satisfy a human obligation.
+     */
+    firstResponseAt?: Date;
+    /**
+     * The amount in dispute, in decimal rupees.
+     *
+     * Structured rather than left in the prose, because a money complaint whose
+     * amount an admin has to read out of a paragraph cannot be sorted, totalled
+     * or prioritised — and "which open grievances are worth the most" is the
+     * first question anyone asks of this queue.
+     */
+    disputedAmount?: number;
     /**
      * Who changed what, when, and why. See § "Status History" in CLAUDE.md.
      * Append-only, capped at STATUS_HISTORY_MAX, oldest evicted first.
@@ -177,7 +248,7 @@ export declare const SUPPORT_TICKET_TRACKED_FIELDS: readonly ["status", "priorit
  * (`assignedTo`) and never the name.
  */
 export declare const SUPPORT_TICKET_PII_FIELDS: readonly ["userEmail", "userDisplayName", "assignedToName"];
-export type SupportTicketCreateInput = Pick<SupportTicketPlain, "userId" | "userEmail" | "userDisplayName" | "category" | "subject" | "description" | "orderId" | "storeId">;
+export type SupportTicketCreateInput = Pick<SupportTicketPlain, "userId" | "userEmail" | "userDisplayName" | "category" | "subject" | "description" | "orderId" | "storeId" | "acknowledgedAt" | "dueAt" | "disputedAmount">;
 export type SupportTicketUpdateInput = Partial<Pick<SupportTicketPlain, "status" | "priority" | "assignedTo" | "assignedToName" | "internalNotes" | "relatedParties">>;
 export declare const SUPPORT_TICKET_COLLECTION: "supportTickets";
 export declare const SUPPORT_TICKET_ID_PREFIX: "ticket-";

package/dist/features/support/schemas/firestore.js

@@ -32,6 +32,16 @@ export const TicketCategoryValues = {
     // ST-3 — buyers/sellers request mutation of order line items
     // (wrong item shipped, partial fulfilment, bundle correction).
     ORDER_MODIFICATION_REQUEST: "order_modification_request",
+    /*
+     * Phase 10 — a formal grievance, with a statutory clock.
+     *
+     * 🛑 Its own category rather than `general` with a flag, because the
+     * category is what the admin queue filters by and what decides whether
+     * `dueAt` is set. A grievance filed as `general` is a grievance nobody can
+     * find, and the clock would be invisible — which is the whole failure this
+     * closes (D18: no form, no route, no record, only a `mailto:`).
+     */
+    GRIEVANCE: "grievance",
     // ST-5 — users appeal a soft-ban or hard-ban via this category.
     // Server bypasses the create_support_tickets soft-ban guard and the
     // active-ticket limit so the user always has an appeal channel.
@@ -57,12 +67,61 @@ export const ACTIVE_TICKET_STATUSES = [
     "waiting_on_user",
 ];
 /** Order statuses that are eligible for a support ticket. */
+/**
+ * 🛑 THIS CONSTANT IS DEAD — it has no consumer, and that CORRECTS D22.
+ *
+ * The plan records: *"`DELIVERED` is absent from
+ * `ELIGIBLE_ORDER_STATUSES_FOR_TICKET` — the status most money complaints arise
+ * in — as is `REFUNDED`"*, and concludes a buyer whose delivered order is wrong
+ * *"may be unable to attach a ticket to it"*.
+ *
+ * Measured: the only references anywhere are this declaration and its
+ * re-export from `appkit/src/index.ts`. **`createTicket` applies no order-status
+ * gate at all**, so nothing is excluded and no buyer is blocked. The list is
+ * also in UPPERCASE while `OrderStatus` is lowercase, so had anything compared
+ * against it directly it would have matched *nothing* and blocked EVERY order —
+ * the Root Cause #33 shape, latent.
+ *
+ * Left in place rather than deleted: it is exported from the public barrel, so
+ * removing it is a breaking change for a consumer, and `DELIVERED`/`REFUNDED`
+ * are added so that if anything ever does consume it, it is correct on the day
+ * it becomes live rather than wrong in the direction the plan feared.
+ *
+ * The plan's other D22 claims are also stale and worth recording:
+ * `resolvedAt`/`closedAt` DO have a writer (`support.repository.ts` stamps them
+ * on the transition into RESOLVED, fixed 2026-08-26), and no per-order ticket
+ * limit is enforced anywhere. What was genuinely missing is the CLOCK —
+ * `acknowledgedAt`, `dueAt`, `firstResponseAt`, `disputedAmount` — which Phase
+ * 10 adds above.
+ */
 export const ELIGIBLE_ORDER_STATUSES_FOR_TICKET = [
     "PENDING",
     "PROCESSING",
     "SHIPPED",
     "RETURN_REQUESTED",
+    // Added for correctness-if-ever-used: these are the statuses most money
+    // complaints arise in, and their absence is what D22 flagged.
+    "DELIVERED",
+    "REFUNDED",
 ];
+/**
+ * Statutory grievance periods, in hours. **Defaults, pending the owner.**
+ *
+ * 🛑 I am not asserting the real statutory numbers from memory. These are
+ * placeholders chosen to be *shorter* than any plausible statutory period, so
+ * the internal clock fires EARLY rather than late — a deadline we beat is
+ * harmless, one we miss is the thing the regime exists to punish.
+ *
+ * Nothing published reads these. The public `/grievance` page is untouched
+ * until the owner supplies a named officer and the actual periods (D17), at
+ * which point these become the `settingPath`-backed values.
+ */
+export const GRIEVANCE_PERIODS = {
+    /** Acknowledge receipt within this. */
+    acknowledgeHours: 48,
+    /** Resolve within this. */
+    resolveHours: 30 * 24,
+};
 /**
  * The fields whose changes earn a timeline entry.
  *