@fayz-ai/storefront 0.9.0 → 0.10.0

package/dist/components/product/ProductSlider.d.ts

@@ -0,0 +1,169 @@
+import React from 'react';
+import type { BlockNode } from '@fayz-ai/core';
+import { type CatalogFacetEntry } from '../../data/facets';
+export interface ProductSliderProps {
+    title: string;
+    subtitle?: string;
+    eyebrow?: string;
+    filter?: 'sale' | 'new' | 'all';
+    categoryName?: string;
+    collection?: string;
+    /**
+     * Arbitrary `product.metadata` refinements, the same model the catalogue
+     * page uses. A rail for a store's own discovery axis needs no SDK change.
+     * Authored as rows (`[{ key: 'purpose', value: 'presentear' }]`) or as a map
+     * in hand-written config; both normalise.
+     */
+    facets?: Record<string, string> | readonly CatalogFacetEntry[];
+    limit?: number;
+    cta?: string;
+    href?: string;
+    className?: string;
+    /** The block node, when rendered from a tree — carries instance `data` overrides. */
+    node?: BlockNode;
+}
+export declare function ProductSlider({ title, subtitle, eyebrow, filter, categoryName, collection, facets, limit, cta, href, className, node, }: ProductSliderProps): React.JSX.Element | null;
+export declare const productSliderBlockMeta: {
+    label: string;
+    description: string;
+    settings: ({
+        id: string;
+        type: "text";
+        label: string;
+        required: true;
+        help?: undefined;
+        options?: undefined;
+        default?: undefined;
+        of?: undefined;
+        min?: undefined;
+        max?: undefined;
+    } | {
+        id: string;
+        type: "text";
+        label: string;
+        help: string;
+        required?: undefined;
+        options?: undefined;
+        default?: undefined;
+        of?: undefined;
+        min?: undefined;
+        max?: undefined;
+    } | {
+        id: string;
+        type: "select";
+        label: string;
+        help: string;
+        options: {
+            value: string;
+            label: string;
+        }[];
+        default: string;
+        required?: undefined;
+        of?: undefined;
+        min?: undefined;
+        max?: undefined;
+    } | {
+        id: string;
+        type: "category";
+        label: string;
+        help: string;
+        required?: undefined;
+        options?: undefined;
+        default?: undefined;
+        of?: undefined;
+        min?: undefined;
+        max?: undefined;
+    } | {
+        id: string;
+        type: "list";
+        label: string;
+        help: string;
+        of: {
+            id: string;
+            type: "text";
+            label: string;
+            help: string;
+            required: true;
+        }[];
+        required?: undefined;
+        options?: undefined;
+        default?: undefined;
+        min?: undefined;
+        max?: undefined;
+    } | {
+        id: string;
+        type: "number";
+        label: string;
+        help: string;
+        min: number;
+        max: number;
+        default: number;
+        required?: undefined;
+        options?: undefined;
+        of?: undefined;
+    } | {
+        id: string;
+        type: "text";
+        label: string;
+        help: string;
+        default: string;
+        required?: undefined;
+        options?: undefined;
+        of?: undefined;
+        min?: undefined;
+        max?: undefined;
+    } | {
+        id: string;
+        type: "url";
+        label: string;
+        help: string;
+        required?: undefined;
+        options?: undefined;
+        default?: undefined;
+        of?: undefined;
+        min?: undefined;
+        max?: undefined;
+    })[];
+    presets: ({
+        name: string;
+        props: {
+            eyebrow: string;
+            title: string;
+            subtitle: string;
+            filter: string;
+            limit: number;
+            cta: string;
+        };
+    } | {
+        name: string;
+        props: {
+            title: string;
+            filter: string;
+            limit: number;
+            cta: string;
+            eyebrow?: undefined;
+            subtitle?: undefined;
+        };
+    })[];
+    enabledOn: string[];
+    data: {
+        products: {
+            loader: string;
+            params: {
+                filter: {
+                    $prop: string;
+                };
+                category: {
+                    $prop: string;
+                };
+                collection: {
+                    $prop: string;
+                };
+                limit: {
+                    $prop: string;
+                };
+            };
+        };
+    };
+};
+//# sourceMappingURL=ProductSlider.d.ts.map

package/dist/components/product/ProductSlider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProductSlider.d.ts","sourceRoot":"","sources":["../../../src/components/product/ProductSlider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAiB,MAAM,OAAO,CAAA;AACrC,OAAO,KAAK,EAAE,SAAS,EAAgB,MAAM,eAAe,CAAA;AAU5D,OAAO,EAAc,KAAK,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAEtE,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,KAAK,CAAA;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,iBAAiB,EAAE,CAAA;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,qFAAqF;IACrF,IAAI,CAAC,EAAE,SAAS,CAAA;CACjB;AAED,wBAAgB,aAAa,CAAC,EAC5B,KAAK,EACL,QAAQ,EACR,OAAO,EACP,MAAc,EACd,YAAY,EACZ,UAAU,EACV,MAAM,EACN,KAAU,EACV,GAAgB,EAChB,IAAI,EACJ,SAAc,EACd,IAAI,GACL,EAAE,kBAAkB,4BAqFpB;AAED,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsGU,CAAA"}

package/dist/components/product/ProductSpecs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProductSpecs.d.ts","sourceRoot":"","sources":["../../../src/components/product/ProductSpecs.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAqDlD;sDACsD;AACtD,wBAAgB,YAAY,CAAC,EAAE,OAAO,EAAE,EAAE;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,4BAmC7D"}

package/dist/components/product/RelatedProducts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RelatedProducts.d.ts","sourceRoot":"","sources":["../../../src/components/product/RelatedProducts.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,KAAK,EAAuB,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAOvE;;0EAE0E;AAC1E,wBAAgB,eAAe,CAAC,EAAE,OAAO,EAAE,EAAE;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,4BA8BhE"}

package/dist/{auth.d.ts → data/auth.d.ts}

@@ -1,6 +1,15 @@
 import type { AuthAdapter } from '@fayz-ai/core';
 import { type AuthPluginOptions } from '@fayz-ai/plugin-auth';
 export type StorefrontAuthAdapter = AuthAdapter | 'mock' | 'supabase' | (string & {});
+/** Thrown by signUpCustomer when the adapter reports a user but no live
+ *  session (Supabase's signal for "email confirmation required" — see
+ *  createSupabaseAuthAdapter's signUp, which returns accessToken: '' instead
+ *  of null/an error). Signup succeeded; the customer just isn't authenticated
+ *  yet, so we must not link/persist a session for them. */
+export declare class EmailConfirmationRequiredError extends Error {
+    readonly email: string;
+    constructor(email: string);
+}
 export interface StorefrontAuthConfig {
     adapter?: AuthPluginOptions['adapter'];
     provider?: AuthPluginOptions['provider'];

package/dist/data/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/data/auth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAY,MAAM,eAAe,CAAA;AAC1D,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,sBAAsB,CAAA;AAa7B,MAAM,MAAM,qBAAqB,GAAG,WAAW,GAAG,MAAM,GAAG,UAAU,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAA;AAErF;;;;2DAI2D;AAC3D,qBAAa,8BAA+B,SAAQ,KAAK;IACvD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;gBAEV,KAAK,EAAE,MAAM;CAK1B;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,CAAC,EAAE,iBAAiB,CAAC,SAAS,CAAC,CAAA;IACtC,QAAQ,CAAC,EAAE,iBAAiB,CAAC,UAAU,CAAC,CAAA;IACxC,MAAM,CAAC,EAAE,iBAAiB,CAAC,QAAQ,CAAC,CAAA;IACpC,QAAQ,CAAC,EAAE,iBAAiB,CAAC,UAAU,CAAC,CAAA;CACzC;AAsBD,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,qBAAqB,GAAG,oBAAoB,GAAG,SAAS,EACpE,QAAQ,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5D,WAAW,CAeb;AAuBD,0EAA0E;AAC1E,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAyC3D;AAED,wBAAgB,sBAAsB,IAAI,WAAW,CAGpD;AAgCD,MAAM,WAAW,uBAAuB;IACtC,sGAAsG;IACtG,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED;;;;GAIG;AACH,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,uBAAuB,GAC7B,OAAO,CAAC;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAgBjC;AAED,8EAA8E;AAC9E,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAE3F;AAED,mEAAmE;AACnE,wBAAsB,cAAc,CAClC,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAWjC;AAED,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAQrD"}

package/dist/data/facets.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Active refinements, keyed by the `product.metadata` field they match.
+ *
+ * A metadata value may be a scalar or an array; an array matches if it contains
+ * the wanted value, which is what makes multi-valued facets like
+ * `purpose: ['estudar', 'presentear']` work.
+ */
+export type CatalogFacets = Readonly<Record<string, string>>;
+/** Does a product satisfy every active facet? */
+export declare function matchesFacets(metadata: Record<string, unknown> | null | undefined, facets: CatalogFacets): boolean;
+/**
+ * One authored refinement, as a repeatable row.
+ *
+ * A `Record<string, string>` is the natural shape for the matcher and for a
+ * hand-written config, but it is not something an editor can render a form for
+ * or an agent can generate against — the block schema vocabulary has no map
+ * type, and declaring one as a shapeless `list` is a schema that lies (the
+ * strict `auditBlocks` bar rejects it). So the authored form is a list of
+ * pairs, and both forms normalise here.
+ */
+export interface CatalogFacetEntry {
+    key: string;
+    value: string;
+}
+/** Either authored form → the map the matcher and the loader use. */
+export declare function toFacetMap(input: CatalogFacets | readonly CatalogFacetEntry[] | undefined | null): CatalogFacets;
+/** Immutably set or drop one key. */
+export declare function withFacet(facets: CatalogFacets, key: string, value: string | null): CatalogFacets;
+/**
+ * Fold the named `collection` shorthand into the facet map.
+ *
+ * `collection` is the one axis with a name of its own — a block prop, a loader
+ * param and a query key all spell it out. It is still just a metadata
+ * refinement, so it is merged here rather than filtered separately: two code
+ * paths applying refinements is how a rail and the catalogue come to disagree
+ * about what "in this collection" means.
+ */
+export declare function mergeCollectionFacet(facets: CatalogFacets | readonly CatalogFacetEntry[] | undefined | null, collection: string | undefined | null): CatalogFacets;
+//# sourceMappingURL=facets.d.ts.map

package/dist/data/facets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"facets.d.ts","sourceRoot":"","sources":["../../src/data/facets.ts"],"names":[],"mappings":"AAcA;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;AAE5D,iDAAiD;AACjD,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,EACpD,MAAM,EAAE,aAAa,GACpB,OAAO,CAUT;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;CACd;AAED,qEAAqE;AACrE,wBAAgB,UAAU,CACxB,KAAK,EAAE,aAAa,GAAG,SAAS,iBAAiB,EAAE,GAAG,SAAS,GAAG,IAAI,GACrE,aAAa,CAQf;AAED,qCAAqC;AACrC,wBAAgB,SAAS,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,aAAa,CAQjG;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,aAAa,GAAG,SAAS,iBAAiB,EAAE,GAAG,SAAS,GAAG,IAAI,EACvE,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GACpC,aAAa,CAGf"}

package/dist/data/loaders.d.ts

@@ -0,0 +1,56 @@
+import type { LoaderContext } from '@fayz-ai/core';
+import type { ShopProvider } from '@fayz-ai/shop/provider';
+import { type CatalogFacetEntry } from './facets';
+export type StorefrontLoaderContext = LoaderContext<ShopProvider>;
+export type ProductsSort = 'catalog' | 'newest' | 'price-asc' | 'price-desc' | 'name';
+export interface ProductsListParams extends Record<string, unknown> {
+    /** Quick filter, mirroring the products/productSlider block vocabulary:
+     *  'new' implies sort 'newest'; 'sale' implies onSale. */
+    filter?: 'all' | 'new' | 'sale';
+    /**
+     * Category id, category SLUG, or exact category name — resolved in that
+     * order (see {@link filterByCategory}). The slug form is what makes the M3
+     * `/category/:slug` page shape portable to a backend with opaque ids.
+     */
+    category?: string;
+    /**
+     * Matched against each product's `metadata.collection` tag. The named
+     * shorthand for `facets: { collection }` — both go through one matcher.
+     */
+    collection?: string;
+    /**
+     * Arbitrary refinements over `product.metadata`. This is the store's own
+     * discovery axis — `purpose`, `brand`, `room` — without the SDK knowing the
+     * axis exists. An array-valued metadata field matches if it contains the
+     * value. Accepts the authored row form or a plain map; both normalise.
+     */
+    facets?: Record<string, string> | readonly CatalogFacetEntry[];
+    search?: string;
+    sort?: ProductsSort;
+    limit?: number;
+    offset?: number;
+    inStock?: boolean;
+    onSale?: boolean;
+}
+export interface ProductBySlugParams extends Record<string, unknown> {
+    slug: string;
+}
+export interface EntityListParams extends Record<string, unknown> {
+    entity: string;
+    limit?: number;
+    offset?: number;
+    orderBy?: string;
+    order?: 'asc' | 'desc';
+}
+export interface EntityBySlugParams extends Record<string, unknown> {
+    entity: string;
+    slug: string;
+}
+export interface EntityFieldsParams extends Record<string, unknown> {
+    reference: string;
+    id: string;
+}
+/** Register the SDK loaders. Idempotent; called wherever blocks are registered,
+ *  because the SDK blocks declare their data needs against these ids. */
+export declare function registerStorefrontLoaders(): void;
+//# sourceMappingURL=loaders.d.ts.map

package/dist/data/loaders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loaders.d.ts","sourceRoot":"","sources":["../../src/data/loaders.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AAG1D,OAAO,EAAuC,KAAK,iBAAiB,EAAE,MAAM,UAAU,CAAA;AAetF,MAAM,MAAM,uBAAuB,GAAG,aAAa,CAAC,YAAY,CAAC,CAAA;AAEjE,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,QAAQ,GAAG,WAAW,GAAG,YAAY,GAAG,MAAM,CAAA;AAErF,MAAM,WAAW,kBAAmB,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACjE;8DAC0D;IAC1D,MAAM,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,CAAA;IAC/B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,iBAAiB,EAAE,CAAA;IAC9D,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,YAAY,CAAA;IACnB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAgFD,MAAM,WAAW,mBAAoB,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAClE,IAAI,EAAE,MAAM,CAAA;CACb;AA0CD,MAAM,WAAW,gBAAiB,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC/D,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,CAAA;CACvB;AAaD,MAAM,WAAW,kBAAmB,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACjE,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;CACb;AASD,MAAM,WAAW,kBAAmB,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACjE,SAAS,EAAE,MAAM,CAAA;IACjB,EAAE,EAAE,MAAM,CAAA;CACX;AAqBD;yEACyE;AACzE,wBAAgB,yBAAyB,IAAI,IAAI,CAsKhD"}

package/dist/data/order-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"order-status.d.ts","sourceRoot":"","sources":["../../src/data/order-status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAmB1D;kFACkF;AAClF,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,eAAe,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAGlG;AAED,wBAAgB,MAAM,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAEvD;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAE3D"}

package/dist/data/product-options.d.ts

@@ -0,0 +1,36 @@
+import type { Product, ProductVariant } from '@fayz-ai/shop/types';
+export interface ProductOptionGroup {
+    id: string;
+    label: string;
+    values: string[];
+}
+export type ProductOptionSelection = Record<string, string>;
+/** Test seam — re-arms the once-per-product overlay deprecation warning. */
+export declare function resetProductOptionsDeprecationWarnings(): void;
+/**
+ * The option axes the PDP picker renders, in order of authority:
+ *
+ * 1. `product.options` — the variant tables (0028), attached by the
+ *    products.bySlug loader. THE source since spine M5: these axes are the
+ *    ones the server prices and decrements against.
+ * 2. metadata options / sizes / colors — the retired productMetadata overlay,
+ *    kept rendering as an I10 deprecation shim (logged, documented). Display
+ *    only: nothing server-side has ever heard of these labels, which is
+ *    exactly why the overlay lost the job. Full deletion from the stores is
+ *    M9 (`catalog.ts` dies everywhere).
+ */
+export declare function getProductOptionGroups(product: Product): ProductOptionGroup[];
+/**
+ * The variant a selection denotes, or null when the product has no variants
+ * or the combination does not exist (a partial selection, or axes/values the
+ * variant table never had). Matching is exact over the variant's own options
+ * object — the same jsonb equality 0029 relies on server-side.
+ */
+export declare function resolveVariantForSelection(product: Product, selection?: ProductOptionSelection | null): ProductVariant | null;
+/** The price a selection sells for: the variant's own, or the product's when
+ *  the variant inherits (price null) or nothing matched. */
+export declare function selectionPrice(product: Product, selection?: ProductOptionSelection | null): number;
+export declare function normalizeProductOptionSelection(selection?: ProductOptionSelection | null): ProductOptionSelection;
+export declare function formatProductOptionSelection(selection?: ProductOptionSelection | null): string;
+export declare function productOptionSelectionKey(selection?: ProductOptionSelection | null): string;
+//# sourceMappingURL=product-options.d.ts.map

package/dist/data/product-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"product-options.d.ts","sourceRoot":"","sources":["../../src/data/product-options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAElE,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,EAAE,CAAA;CACjB;AAED,MAAM,MAAM,sBAAsB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AAqB3D,4EAA4E;AAC5E,wBAAgB,sCAAsC,IAAI,IAAI,CAE7D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,kBAAkB,EAAE,CA6B7E;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,OAAO,EAChB,SAAS,CAAC,EAAE,sBAAsB,GAAG,IAAI,GACxC,cAAc,GAAG,IAAI,CAcvB;AAED;4DAC4D;AAC5D,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,sBAAsB,GAAG,IAAI,GAAG,MAAM,CAGlG;AAED,wBAAgB,+BAA+B,CAAC,SAAS,CAAC,EAAE,sBAAsB,GAAG,IAAI,GAAG,sBAAsB,CAOjH;AAED,wBAAgB,4BAA4B,CAAC,SAAS,CAAC,EAAE,sBAAsB,GAAG,IAAI,GAAG,MAAM,CAI9F;AAED,wBAAgB,yBAAyB,CAAC,SAAS,CAAC,EAAE,sBAAsB,GAAG,IAAI,GAAG,MAAM,CAI3F"}

package/dist/diagnostics/seo-audit.d.ts

@@ -0,0 +1,54 @@
+export type SeoFindingStatus = 'pass' | 'warn' | 'fail';
+export interface SeoFinding {
+    id: string;
+    label: string;
+    status: SeoFindingStatus;
+    /** What was actually found. */
+    detail: string;
+    /** Why it matters — the consequence, not the rule. */
+    why: string;
+    /** Weight in the score. Higher = more consequential. */
+    weight: number;
+}
+export interface SeoAuditInput {
+    /** In-app path, used to detect fragment addressing. */
+    path: string;
+    /** Full URL as the browser sees it, when available. */
+    url?: string;
+    title?: string | null;
+    meta: Array<{
+        name?: string;
+        property?: string;
+        content: string;
+    }>;
+    links: Array<{
+        rel: string;
+        href: string;
+    }>;
+    /** `@type` of every JSON-LD block on the page. */
+    jsonLdTypes: string[];
+    h1Count: number;
+    imageCount: number;
+    imagesMissingAlt: number;
+    /** Text length of the main content region — the body a crawler indexes. */
+    contentTextLength: number;
+    /** Number of loading placeholders still in the markup. */
+    skeletonCount: number;
+    /** HTTP status, when the caller knows it. */
+    statusCode?: number;
+}
+export interface SeoAuditResult {
+    /** 0–100, weighted by consequence. */
+    score: number;
+    grade: 'A' | 'B' | 'C' | 'D' | 'F';
+    findings: SeoFinding[];
+    passed: number;
+    total: number;
+}
+export declare function auditStorefrontSeo(input: SeoAuditInput): SeoAuditResult;
+/**
+ * Collect audit input from a live document. Browser-only by definition — the
+ * server-side counterpart builds the same shape from its SeoConfig.
+ */
+export declare function collectSeoAuditInput(doc: Document, path: string): SeoAuditInput;
+//# sourceMappingURL=seo-audit.d.ts.map

package/dist/diagnostics/seo-audit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seo-audit.d.ts","sourceRoot":"","sources":["../../src/diagnostics/seo-audit.ts"],"names":[],"mappings":"AAcA,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAA;AAEvD,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,gBAAgB,CAAA;IACxB,+BAA+B;IAC/B,MAAM,EAAE,MAAM,CAAA;IACd,sDAAsD;IACtD,GAAG,EAAE,MAAM,CAAA;IACX,wDAAwD;IACxD,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAA;IACZ,uDAAuD;IACvD,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,IAAI,EAAE,KAAK,CAAC;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAClE,KAAK,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAC3C,kDAAkD;IAClD,WAAW,EAAE,MAAM,EAAE,CAAA;IACrB,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,MAAM,CAAA;IAClB,gBAAgB,EAAE,MAAM,CAAA;IACxB,2EAA2E;IAC3E,iBAAiB,EAAE,MAAM,CAAA;IACzB,0DAA0D;IAC1D,aAAa,EAAE,MAAM,CAAA;IACrB,6CAA6C;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAA;IAClC,QAAQ,EAAE,UAAU,EAAE,CAAA;IACtB,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;CACd;AAaD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,aAAa,GAAG,cAAc,CAiJvE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,aAAa,CAmC/E"}

package/dist/diagnostics/seo-audit.js

@@ -0,0 +1,3 @@
+export { auditStorefrontSeo, collectSeoAuditInput } from '../chunk-6IXTENLB.js';
+//# sourceMappingURL=seo-audit.js.map
+//# sourceMappingURL=seo-audit.js.map

package/dist/diagnostics/seo-audit.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"seo-audit.js"}

package/dist/document/change.d.ts

@@ -0,0 +1,100 @@
+import type { StoreDocument, StoreSectionName } from './sections';
+import type { StoreValidationError, StoreValidationReport } from './validate';
+/** JSON values a change may write. */
+export type StoreChangeValue = unknown;
+export declare const STORE_CHANGE_OPS: readonly ["set", "remove", "insert", "move"];
+export type StoreChangeOp = (typeof STORE_CHANGE_OPS)[number];
+export interface StoreChange {
+    /**
+     * `set`    — write `value` at `path` (creating missing intermediate objects).
+     * `remove` — delete the key, or splice the array element, at `path`.
+     * `insert` — splice `value` into the array at `path`, at `index` (default: append).
+     * `move`   — relocate the array element at `path` to `index`.
+     */
+    op: StoreChangeOp;
+    /**
+     * Dotted document path, the same shape `validateStore` reports:
+     * `presentation.pages.home.blocks[2].props.title`. An array step may address
+     * a block by id instead of by position — `blocks[#hero]` — which is the only
+     * form that stays correct across a reorder.
+     */
+    path: string;
+    /** `set` / `insert`: the JSON value to write. */
+    value?: StoreChangeValue;
+    /** `insert` / `move`: destination index. `insert` defaults to append. */
+    index?: number;
+}
+export interface AppliedStoreChange {
+    op: StoreChangeOp;
+    path: string;
+    /** The path with every `[#id]` step resolved to the position it hit — what
+     *  actually moved, which is what a diff or an undo needs. */
+    resolvedPath: string;
+    /** The value that was there before, when there was one. */
+    before?: StoreChangeValue;
+    /** The value that is there now, when the op leaves one. */
+    after?: StoreChangeValue;
+}
+export interface ApplyChangeOptions {
+    /**
+     * Sections this caller may write. Defaults to every section EXCEPT `code`:
+     * a code entry is a handle name resolved out of the handle registry, so an
+     * agent inventing one produces a document that hydrates to a missing
+     * component. Pass it explicitly to move a route or drop an override.
+     */
+    sections?: readonly StoreSectionName[];
+    /**
+     * 'reject' (default) — a batch whose RESULT fails validation is discarded
+     * whole and `doc` is the untouched input. 'allow' returns the changed
+     * document with the report anyway, for a caller that is mid-way through a
+     * multi-step edit and will validate at the end.
+     */
+    onInvalid?: 'reject' | 'allow';
+}
+export interface StoreChangeResult {
+    /** True only when every change applied AND the result validates. */
+    ok: boolean;
+    /** The resulting document — the input, unchanged, when a rejected batch failed. */
+    doc: StoreDocument;
+    /** One entry per change, in order, for the changes that were applied. */
+    applied: AppliedStoreChange[];
+    /** Path/permission failures AND the resulting document's validation errors,
+     *  in one list, in the shape `validateStore` returns — so a caller has one
+     *  error vocabulary to correct on rather than two. */
+    errors: StoreValidationError[];
+    /** Validation of the resulting document. */
+    validation: StoreValidationReport;
+}
+/** Sections a change may write unless the caller says otherwise. */
+export declare const DEFAULT_WRITABLE_SECTIONS: readonly StoreSectionName[];
+type PathStep = {
+    kind: 'key';
+    key: string;
+} | {
+    kind: 'index';
+    index: number;
+} | {
+    kind: 'id';
+    id: string;
+};
+/**
+ * Parse `presentation.pages.home.blocks[#hero].props.title` into steps.
+ * Returns null for anything malformed — an unparseable path is a hard error,
+ * never a silently ignored change.
+ */
+export declare function parseStorePath(path: string): PathStep[] | null;
+/**
+ * Apply an ordered batch of changes to a Store Document.
+ *
+ * Transactional: the batch either applies whole and validates, or the input
+ * document comes back untouched with every reason listed.
+ *
+ *     applyChange(doc, { op: 'set', path: 'theme.colors.primary', value: '41 54% 55%' })
+ *     applyChange(doc, [
+ *       { op: 'insert', path: 'presentation.home.sections', index: 0, value: { type: 'seals' } },
+ *       { op: 'move',   path: 'presentation.home.sections[#hero]', index: 1 },
+ *     ])
+ */
+export declare function applyChange(input: StoreDocument | Record<string, unknown>, changes: StoreChange | readonly StoreChange[], options?: ApplyChangeOptions): StoreChangeResult;
+export {};
+//# sourceMappingURL=change.d.ts.map

package/dist/document/change.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"change.d.ts","sourceRoot":"","sources":["../../src/document/change.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAEjE,OAAO,KAAK,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA;AAmC7E,sCAAsC;AACtC,MAAM,MAAM,gBAAgB,GAAG,OAAO,CAAA;AAEtC,eAAO,MAAM,gBAAgB,8CAA+C,CAAA;AAC5E,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAA;AAE7D,MAAM,WAAW,WAAW;IAC1B;;;;;OAKG;IACH,EAAE,EAAE,aAAa,CAAA;IACjB;;;;;OAKG;IACH,IAAI,EAAE,MAAM,CAAA;IACZ,iDAAiD;IACjD,KAAK,CAAC,EAAE,gBAAgB,CAAA;IACxB,yEAAyE;IACzE,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,aAAa,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ;iEAC6D;IAC7D,YAAY,EAAE,MAAM,CAAA;IACpB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,gBAAgB,CAAA;IACzB,2DAA2D;IAC3D,KAAK,CAAC,EAAE,gBAAgB,CAAA;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAA;IACtC;;;;;OAKG;IACH,SAAS,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAA;CAC/B;AAED,MAAM,WAAW,iBAAiB;IAChC,oEAAoE;IACpE,EAAE,EAAE,OAAO,CAAA;IACX,mFAAmF;IACnF,GAAG,EAAE,aAAa,CAAA;IAClB,yEAAyE;IACzE,OAAO,EAAE,kBAAkB,EAAE,CAAA;IAC7B;;0DAEsD;IACtD,MAAM,EAAE,oBAAoB,EAAE,CAAA;IAC9B,4CAA4C;IAC5C,UAAU,EAAE,qBAAqB,CAAA;CAClC;AAED,oEAAoE;AACpE,eAAO,MAAM,yBAAyB,EAAE,SAAS,gBAAgB,EAEhE,CAAA;AAID,KAAK,QAAQ,GACT;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAC5B;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAA;AAgB9B;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,EAAE,GAAG,IAAI,CAwC9D;AA0HD;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9C,OAAO,EAAE,WAAW,GAAG,SAAS,WAAW,EAAE,EAC7C,OAAO,GAAE,kBAAuB,GAC/B,iBAAiB,CAmOnB"}