@lexsis/storefront-components 1.0.0

package/dist/theme/resolve.d.ts

@@ -0,0 +1,12 @@
+import type { SpacingKey, BorderRadiusKey, TypeScaleKey } from "./tokens";
+/**
+ * Resolves a token value: if `value` is a named key in `map`, returns the
+ * mapped px/rem value. Otherwise returns `value` as-is (custom passthrough).
+ * Supports positive, negative, rem, %, calc, and any raw CSS value.
+ */
+export declare function resolveToken<T extends Record<string, string>>(map: T, value: string | undefined, fallback?: string): string;
+export declare const resolveSpace: (value: SpacingKey | string | undefined, fallback?: string) => string;
+export declare const resolveRadius: (value: BorderRadiusKey | string | undefined, fallback?: string) => string;
+export declare const resolveTypeSize: (value: TypeScaleKey | string | undefined, fallback?: string) => string;
+export declare const resolveTypeLineHeight: (value: TypeScaleKey | string | undefined, fallback?: string) => string;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/theme/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/theme/resolve.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE1E;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC3D,GAAG,EAAE,CAAC,EACN,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,CAGR;AAED,eAAO,MAAM,YAAY,GACvB,OAAO,UAAU,GAAG,MAAM,GAAG,SAAS,EACtC,WAAW,MAAM,KAChB,MAA2F,CAAC;AAE/F,eAAO,MAAM,aAAa,GACxB,OAAO,eAAe,GAAG,MAAM,GAAG,SAAS,EAC3C,WAAW,MAAM,KAChB,MAAiG,CAAC;AAErG,eAAO,MAAM,eAAe,GAC1B,OAAO,YAAY,GAAG,MAAM,GAAG,SAAS,EACxC,WAAW,MAAM,KAChB,MAIF,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAChC,OAAO,YAAY,GAAG,MAAM,GAAG,SAAS,EACxC,WAAW,MAAM,KAChB,MAIF,CAAC"}

package/dist/theme/resolve.js

@@ -0,0 +1,26 @@
+import { SPACING_SCALE, BORDER_RADIUS_SCALE, TYPE_SCALE } from "./tokens";
+/**
+ * Resolves a token value: if `value` is a named key in `map`, returns the
+ * mapped px/rem value. Otherwise returns `value` as-is (custom passthrough).
+ * Supports positive, negative, rem, %, calc, and any raw CSS value.
+ */
+export function resolveToken(map, value, fallback) {
+    if (value === undefined || value === null)
+        return fallback ?? "";
+    return map[value] ?? value;
+}
+export const resolveSpace = (value, fallback) => resolveToken(SPACING_SCALE, value, fallback);
+export const resolveRadius = (value, fallback) => resolveToken(BORDER_RADIUS_SCALE, value, fallback);
+export const resolveTypeSize = (value, fallback) => {
+    if (value === undefined || value === null)
+        return fallback ?? "";
+    const entry = TYPE_SCALE[value];
+    return entry ? entry.size : value;
+};
+export const resolveTypeLineHeight = (value, fallback) => {
+    if (value === undefined || value === null)
+        return fallback ?? "";
+    const entry = TYPE_SCALE[value];
+    return entry ? entry.lh : value;
+};
+//# sourceMappingURL=resolve.js.map

package/dist/theme/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../src/theme/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAG1E;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAC1B,GAAM,EACN,KAAyB,EACzB,QAAiB;IAEjB,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,QAAQ,IAAI,EAAE,CAAC;IACjE,OAAQ,GAA8B,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC;AACzD,CAAC;AAED,MAAM,CAAC,MAAM,YAAY,GAAG,CAC1B,KAAsC,EACtC,QAAiB,EACT,EAAE,CAAC,YAAY,CAAC,aAAkD,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;AAE/F,MAAM,CAAC,MAAM,aAAa,GAAG,CAC3B,KAA2C,EAC3C,QAAiB,EACT,EAAE,CAAC,YAAY,CAAC,mBAAwD,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;AAErG,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,KAAwC,EACxC,QAAiB,EACT,EAAE;IACV,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,QAAQ,IAAI,EAAE,CAAC;IACjE,MAAM,KAAK,GAAI,UAA2D,CAAC,KAAK,CAAC,CAAC;IAClF,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC;AACpC,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAG,CACnC,KAAwC,EACxC,QAAiB,EACT,EAAE;IACV,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,QAAQ,IAAI,EAAE,CAAC;IACjE,MAAM,KAAK,GAAI,UAA2D,CAAC,KAAK,CAAC,CAAC;IAClF,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;AAClC,CAAC,CAAC"}

package/dist/theme/tokens.d.ts

@@ -0,0 +1,147 @@
+export declare const SPACING_SCALE: {
+    readonly "1": "4px";
+    readonly "2": "8px";
+    readonly "3": "12px";
+    readonly "4": "16px";
+    readonly "5": "20px";
+    readonly "6": "24px";
+    readonly "8": "32px";
+    readonly "10": "40px";
+    readonly "12": "48px";
+    readonly "16": "64px";
+    readonly "20": "80px";
+    readonly xs: "4px";
+    readonly sm: "8px";
+    readonly md: "16px";
+    readonly lg: "24px";
+    readonly xl: "32px";
+    readonly "2xl": "48px";
+    readonly "3xl": "64px";
+};
+export type SpacingKey = keyof typeof SPACING_SCALE;
+export declare const TYPE_SCALE: {
+    readonly xs: {
+        readonly size: "0.75rem";
+        readonly lh: "1rem";
+    };
+    readonly sm: {
+        readonly size: "0.875rem";
+        readonly lh: "1.25rem";
+    };
+    readonly base: {
+        readonly size: "1rem";
+        readonly lh: "1.5rem";
+    };
+    readonly lg: {
+        readonly size: "1.125rem";
+        readonly lh: "1.75rem";
+    };
+    readonly xl: {
+        readonly size: "1.25rem";
+        readonly lh: "1.75rem";
+    };
+    readonly "2xl": {
+        readonly size: "1.5rem";
+        readonly lh: "2rem";
+    };
+    readonly "3xl": {
+        readonly size: "1.875rem";
+        readonly lh: "2.25rem";
+    };
+    readonly "4xl": {
+        readonly size: "2.25rem";
+        readonly lh: "2.5rem";
+    };
+    readonly "5xl": {
+        readonly size: "3rem";
+        readonly lh: "1";
+    };
+    readonly "6xl": {
+        readonly size: "3.75rem";
+        readonly lh: "1";
+    };
+    readonly "7xl": {
+        readonly size: "4.5rem";
+        readonly lh: "1";
+    };
+    readonly "8xl": {
+        readonly size: "6rem";
+        readonly lh: "1";
+    };
+};
+export type TypeScaleKey = keyof typeof TYPE_SCALE;
+export declare const BORDER_RADIUS_SCALE: {
+    readonly none: "0px";
+    readonly xs: "2px";
+    readonly sm: "4px";
+    readonly md: "8px";
+    readonly lg: "12px";
+    readonly xl: "16px";
+    readonly "2xl": "24px";
+    readonly "3xl": "32px";
+    readonly full: "9999px";
+};
+export type BorderRadiusKey = keyof typeof BORDER_RADIUS_SCALE;
+export declare const SHADOW_MAP: {
+    readonly none: "none";
+    readonly sm: "0 1px 3px rgba(0,0,0,0.08), 0 1px 2px rgba(0,0,0,0.06)";
+    readonly md: "0 4px 12px rgba(0,0,0,0.08), 0 2px 4px rgba(0,0,0,0.06)";
+    readonly lg: "0 12px 40px rgba(0,0,0,0.12), 0 4px 12px rgba(0,0,0,0.08)";
+};
+export declare const TRANSITION_MAP: {
+    readonly fast: "150ms";
+    readonly normal: "300ms";
+    readonly slow: "500ms";
+};
+export declare const DURATION_MAP: {
+    readonly fast: "0.3s";
+    readonly normal: "0.6s";
+    readonly slow: "1s";
+};
+export declare const MAX_WIDTH_MAP: {
+    readonly sm: "640px";
+    readonly md: "768px";
+    readonly lg: "1024px";
+    readonly xl: "1280px";
+    readonly full: "100%";
+};
+export declare const Z_INDEX: {
+    readonly base: 0;
+    readonly sticky: 100;
+    readonly nav: 200;
+    readonly modal: 300;
+    readonly toast: 400;
+    readonly tooltip: 500;
+};
+export declare const SECTION_GAP_MAP: {
+    readonly none: "0";
+    readonly tight: "1rem";
+    readonly normal: "2rem";
+    readonly relaxed: "4rem";
+    readonly generous: "6rem";
+};
+export declare const OVERLAY_SCALE: {
+    readonly light: "rgba(0,0,0,0.25)";
+    readonly medium: "rgba(0,0,0,0.45)";
+    readonly heavy: "rgba(0,0,0,0.65)";
+};
+export type OverlayStrength = keyof typeof OVERLAY_SCALE;
+export declare const BLUR_SCALE: {
+    readonly sm: "4px";
+    readonly md: "8px";
+    readonly lg: "20px";
+    readonly xl: "40px";
+    readonly "2xl": "80px";
+};
+export declare const LETTER_SPACING_SCALE: {
+    readonly tight: "-0.03em";
+    readonly normal: "0em";
+    readonly loose: "0.05em";
+    readonly extended: "0.15em";
+};
+export declare const OPACITY_SCALE: {
+    readonly low: "0.25";
+    readonly medium: "0.45";
+    readonly high: "0.65";
+};
+//# sourceMappingURL=tokens.d.ts.map

package/dist/theme/tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../src/theme/tokens.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;CAoBhB,CAAC;AAEX,MAAM,MAAM,UAAU,GAAG,MAAM,OAAO,aAAa,CAAC;AAIpD,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAab,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,MAAM,OAAO,UAAU,CAAC;AAGnD,eAAO,MAAM,mBAAmB;;;;;;;;;;CAUtB,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,MAAM,OAAO,mBAAmB,CAAC;AAE/D,eAAO,MAAM,UAAU;;;;;CAKb,CAAC;AAEX,eAAO,MAAM,cAAc;;;;CAIjB,CAAC;AAEX,eAAO,MAAM,YAAY;;;;CAIf,CAAC;AAEX,eAAO,MAAM,aAAa;;;;;;CAMhB,CAAC;AAEX,eAAO,MAAM,OAAO;;;;;;;CAOV,CAAC;AAEX,eAAO,MAAM,eAAe;;;;;;CAMlB,CAAC;AAEX,eAAO,MAAM,aAAa;;;;CAIhB,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,MAAM,OAAO,aAAa,CAAC;AAEzD,eAAO,MAAM,UAAU;;;;;;CAMb,CAAC;AAEX,eAAO,MAAM,oBAAoB;;;;;CAKvB,CAAC;AAEX,eAAO,MAAM,aAAa;;;;CAIhB,CAAC"}

package/dist/theme/tokens.js

@@ -0,0 +1,113 @@
+// Spacing scale — xs/sm/md/lg/xl/2xl (component-level use, not section padding)
+// Maps to --lx-space-* CSS vars
+export const SPACING_SCALE = {
+    "1": "4px",
+    "2": "8px",
+    "3": "12px",
+    "4": "16px",
+    "5": "20px",
+    "6": "24px",
+    "8": "32px",
+    "10": "40px",
+    "12": "48px",
+    "16": "64px",
+    "20": "80px",
+    // Named aliases
+    xs: "4px",
+    sm: "8px",
+    md: "16px",
+    lg: "24px",
+    xl: "32px",
+    "2xl": "48px",
+    "3xl": "64px",
+};
+// Typography scale — maps to --lx-text-* CSS vars
+// size = font-size, lh = line-height
+export const TYPE_SCALE = {
+    xs: { size: "0.75rem", lh: "1rem" },
+    sm: { size: "0.875rem", lh: "1.25rem" },
+    base: { size: "1rem", lh: "1.5rem" },
+    lg: { size: "1.125rem", lh: "1.75rem" },
+    xl: { size: "1.25rem", lh: "1.75rem" },
+    "2xl": { size: "1.5rem", lh: "2rem" },
+    "3xl": { size: "1.875rem", lh: "2.25rem" },
+    "4xl": { size: "2.25rem", lh: "2.5rem" },
+    "5xl": { size: "3rem", lh: "1" },
+    "6xl": { size: "3.75rem", lh: "1" },
+    "7xl": { size: "4.5rem", lh: "1" },
+    "8xl": { size: "6rem", lh: "1" },
+};
+// Border-radius scale — maps to --lx-radius-* CSS vars
+export const BORDER_RADIUS_SCALE = {
+    none: "0px",
+    xs: "2px",
+    sm: "4px",
+    md: "8px",
+    lg: "12px",
+    xl: "16px",
+    "2xl": "24px",
+    "3xl": "32px",
+    full: "9999px",
+};
+export const SHADOW_MAP = {
+    none: "none",
+    sm: "0 1px 3px rgba(0,0,0,0.08), 0 1px 2px rgba(0,0,0,0.06)",
+    md: "0 4px 12px rgba(0,0,0,0.08), 0 2px 4px rgba(0,0,0,0.06)",
+    lg: "0 12px 40px rgba(0,0,0,0.12), 0 4px 12px rgba(0,0,0,0.08)",
+};
+export const TRANSITION_MAP = {
+    fast: "150ms",
+    normal: "300ms",
+    slow: "500ms",
+};
+export const DURATION_MAP = {
+    fast: "0.3s",
+    normal: "0.6s",
+    slow: "1s",
+};
+export const MAX_WIDTH_MAP = {
+    sm: "640px",
+    md: "768px",
+    lg: "1024px",
+    xl: "1280px",
+    full: "100%",
+};
+export const Z_INDEX = {
+    base: 0,
+    sticky: 100,
+    nav: 200,
+    modal: 300,
+    toast: 400,
+    tooltip: 500,
+};
+export const SECTION_GAP_MAP = {
+    none: "0",
+    tight: "1rem",
+    normal: "2rem",
+    relaxed: "4rem",
+    generous: "6rem",
+};
+export const OVERLAY_SCALE = {
+    light: "rgba(0,0,0,0.25)",
+    medium: "rgba(0,0,0,0.45)",
+    heavy: "rgba(0,0,0,0.65)",
+};
+export const BLUR_SCALE = {
+    sm: "4px",
+    md: "8px",
+    lg: "20px",
+    xl: "40px",
+    "2xl": "80px",
+};
+export const LETTER_SPACING_SCALE = {
+    tight: "-0.03em",
+    normal: "0em",
+    loose: "0.05em",
+    extended: "0.15em",
+};
+export const OPACITY_SCALE = {
+    low: "0.25",
+    medium: "0.45",
+    high: "0.65",
+};
+//# sourceMappingURL=tokens.js.map

package/dist/theme/tokens.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,154 @@
+export interface Theme {
+    palette: {
+        bg: string;
+        surface: string;
+        accent: string;
+        text: string;
+        highlight: string;
+        secondary?: string;
+        border?: string;
+        tickerBg?: string;
+        tickerText?: string;
+        success?: string;
+    };
+    fonts: {
+        display: string;
+        body: string;
+        displayWeight?: string;
+        displayUrl?: string;
+        bodyUrl?: string;
+    };
+    borderRadius: "none" | "sm" | "md" | "lg" | "full" | string;
+    spacing: "tight" | "normal" | "relaxed" | "generous" | string;
+    button?: {
+        bg?: string;
+        text?: string;
+        padding?: string;
+        shadow?: string;
+        radius?: string;
+    };
+    image?: {
+        radius?: string;
+        shadow?: "none" | "sm" | "md" | "lg";
+        opacity?: number;
+    };
+    card?: {
+        radius?: string;
+    };
+    effects?: {
+        shadow?: "none" | "sm" | "md" | "lg";
+        overlay?: string;
+        overlayStrength?: "light" | "medium" | "heavy";
+        blur?: "sm" | "md" | "lg" | "xl" | "2xl";
+        gradient?: {
+            from: string;
+            to: string;
+            angle?: number;
+        };
+    };
+    animation?: {
+        duration?: "fast" | "normal" | "slow";
+        reducedMotion?: boolean;
+    };
+    layout?: {
+        maxWidth?: string;
+        sectionGap?: string;
+        navHeight?: string;
+    };
+    typography?: {
+        sectionHeadingSize?: string;
+        sectionHeadingWeight?: string;
+        sectionHeadingTracking?: string;
+        itemHeadingSize?: string;
+        itemHeadingWeight?: string;
+        bodySize?: string;
+        bodyLineHeight?: string;
+        eyebrowSize?: string;
+        eyebrowTracking?: string;
+    };
+}
+export type ThemeMode = "light" | "dark";
+export interface ThemeConfig {
+    light: Theme;
+    dark: Theme;
+    defaultMode?: ThemeMode;
+}
+export interface KitAsset {
+    kind: string;
+    url: string;
+    placement_hint: string;
+}
+export interface Kit {
+    id: string;
+    assets: KitAsset[];
+}
+export interface Section {
+    id: string;
+    type: string;
+    variant: string;
+    content: Record<string, unknown>;
+    settings?: import("./schemas/content").SectionSettings;
+    element_styles?: Record<string, Record<string, string>>;
+    tokens?: Record<string, string>;
+    /** @deprecated Use `type` — kept for backward compat with stored v3 pages */
+    component?: string;
+}
+export interface StorefrontConfig {
+    storeDomain: string;
+    storefrontToken: string;
+    shopId: string;
+    currency?: string;
+}
+export interface ComponentTree {
+    version: number;
+    theme: Theme | ThemeConfig;
+    kit?: Kit;
+    generatedAssets?: Record<string, string>;
+    storefrontConfig?: StorefrontConfig;
+    sections: Section[];
+}
+export interface ComponentProps {
+    content: Record<string, unknown>;
+    variant: string;
+    theme: Theme;
+    kit?: Kit;
+    generatedAssets?: Record<string, string>;
+    elementStyles?: Record<string, Record<string, string>>;
+    settings?: import("./schemas/content").SectionSettings;
+}
+export interface VariantEntry {
+    component: React.LazyExoticComponent<React.ComponentType<ComponentProps>>;
+    requiredContent: string[];
+    optionalContent: string[];
+    fields?: Record<string, import("./schemas/content").ContentFieldSchema>;
+    supportedSettings?: Array<keyof import("./schemas/content").SectionSettings>;
+    defaultContent?: Record<string, unknown>;
+    /**
+     * Scopes variant swapping in the editor.
+     * Only variants sharing the same variantGroup can be swapped with each other.
+     * Variants with no variantGroup cannot be swapped at all.
+     * Extension: add new groups in registry.ts to create new swap buckets.
+     */
+    variantGroup?: string;
+    /**
+     * Documents which content fields contain media (image/video URLs).
+     * Key = content field name, value = human-readable label shown in editor.
+     * Used by the editor to surface upload/picker UI for the right fields.
+     * Extension: add entries here when adding new media fields to a variant.
+     */
+    mediaRequirements?: Record<string, string>;
+}
+export interface TypeEntry {
+    category: string;
+    defaultVariant: string;
+    variants: Record<string, VariantEntry>;
+}
+/** @deprecated Legacy flat entry format — kept for migration period */
+export interface RegistryEntry {
+    component: React.LazyExoticComponent<React.ComponentType<ComponentProps>>;
+    category: string;
+    variants: string[];
+    requiredContent: string[];
+    optionalContent: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,KAAK;IACpB,OAAO,EAAE;QACP,EAAE,EAAE,MAAM,CAAC;QACX,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,KAAK,EAAE;QACL,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;IAC5D,OAAO,EAAE,OAAO,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC;IAC9D,MAAM,CAAC,EAAE;QACP,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,KAAK,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACpF,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3B,OAAO,CAAC,EAAE;QACR,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;QACrC,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,eAAe,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;QAC/C,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK,CAAC;QACzC,QAAQ,CAAC,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,EAAE,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KACzD,CAAC;IACF,SAAS,CAAC,EAAE;QACV,QAAQ,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;QACtC,aAAa,CAAC,EAAE,OAAO,CAAC;KACzB,CAAC;IACF,MAAM,CAAC,EAAE;QACP,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,UAAU,CAAC,EAAE;QACX,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,oBAAoB,CAAC,EAAE,MAAM,CAAC;QAC9B,sBAAsB,CAAC,EAAE,MAAM,CAAC;QAChC,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAC;CACH;AAED,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;AAEzC,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,KAAK,CAAC;IACb,IAAI,EAAE,KAAK,CAAC;IACZ,WAAW,CAAC,EAAE,SAAS,CAAC;CACzB;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,GAAG;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,QAAQ,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,QAAQ,CAAC,EAAE,OAAO,mBAAmB,EAAE,eAAe,CAAC;IACvD,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,6EAA6E;IAC7E,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,KAAK,GAAG,WAAW,CAAC;IAC3B,GAAG,CAAC,EAAE,GAAG,CAAC;IACV,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,KAAK,CAAC;IACb,GAAG,CAAC,EAAE,GAAG,CAAC;IACV,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACvD,QAAQ,CAAC,EAAE,OAAO,mBAAmB,EAAE,eAAe,CAAC;CACxD;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,KAAK,CAAC,mBAAmB,CAAC,KAAK,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC,CAAC;IAC1E,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,mBAAmB,EAAE,kBAAkB,CAAC,CAAC;IACxE,iBAAiB,CAAC,EAAE,KAAK,CAAC,MAAM,OAAO,mBAAmB,EAAE,eAAe,CAAC,CAAC;IAC7E,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CACxC;AAED,uEAAuE;AACvE,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,KAAK,CAAC,mBAAmB,CAAC,KAAK,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC,CAAC;IAC1E,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/utils/elementStyles.d.ts

@@ -0,0 +1,4 @@
+import type { CSSProperties } from "react";
+export declare function elStyle(elementStyles: Record<string, Record<string, string>> | undefined, fieldKey: string): CSSProperties;
+export declare const slotStyle: typeof elStyle;
+//# sourceMappingURL=elementStyles.d.ts.map

package/dist/utils/elementStyles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"elementStyles.d.ts","sourceRoot":"","sources":["../../src/utils/elementStyles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAE3C,wBAAgB,OAAO,CACrB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,EACjE,QAAQ,EAAE,MAAM,GACf,aAAa,CAEf;AAGD,eAAO,MAAM,SAAS,gBAAU,CAAC"}

package/dist/utils/elementStyles.js

@@ -0,0 +1,6 @@
+export function elStyle(elementStyles, fieldKey) {
+    return (elementStyles?.[fieldKey] ?? {});
+}
+// alias
+export const slotStyle = elStyle;
+//# sourceMappingURL=elementStyles.js.map

package/dist/utils/elementStyles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"elementStyles.js","sourceRoot":"","sources":["../../src/utils/elementStyles.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,OAAO,CACrB,aAAiE,EACjE,QAAgB;IAEhB,OAAO,CAAC,aAAa,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAkB,CAAC;AAC5D,CAAC;AAED,QAAQ;AACR,MAAM,CAAC,MAAM,SAAS,GAAG,OAAO,CAAC"}

package/dist/utils/icon-map.d.ts

@@ -0,0 +1,128 @@
+/**
+ * E-commerce Icon Map
+ *
+ * Reference guide for blueprint authors. Use these icon names in your content
+ * by prefixing with "lucide:" (e.g., "lucide:shopping-cart").
+ *
+ * All icons are from lucide-react and tree-shakeable - only imported icons
+ * are included in the bundle.
+ *
+ * Supports multiple formats:
+ * - "lucide:icon-name" → Lucide React icon
+ * - "https://..." → SVG/image URL (custom icons from agent/CDN)
+ * - "<svg>...</svg>" → Inline SVG code
+ * - "🛒" → Emoji fallback
+ *
+ * @see https://lucide.dev for full icon catalog and previews
+ */
+export declare const RECOMMENDED_ICONS: {
+    readonly cart: "lucide:shopping-cart";
+    readonly bag: "lucide:shopping-bag";
+    readonly wishlist: "lucide:heart";
+    readonly quickView: "lucide:eye";
+    readonly zoomIn: "lucide:zoom-in";
+    readonly zoomOut: "lucide:zoom-out";
+    readonly fullscreen: "lucide:maximize";
+    readonly externalLink: "lucide:external-link";
+    readonly shield: "lucide:shield-check";
+    readonly shieldSimple: "lucide:shield";
+    readonly shipping: "lucide:truck";
+    readonly returns: "lucide:undo-2";
+    readonly verified: "lucide:badge-check";
+    readonly secure: "lucide:lock";
+    readonly securePayment: "lucide:lock-keyhole";
+    readonly award: "lucide:award";
+    readonly menu: "lucide:menu";
+    readonly search: "lucide:search";
+    readonly user: "lucide:user";
+    readonly userCircle: "lucide:user-circle";
+    readonly close: "lucide:x";
+    readonly chevronDown: "lucide:chevron-down";
+    readonly chevronUp: "lucide:chevron-up";
+    readonly chevronLeft: "lucide:chevron-left";
+    readonly chevronRight: "lucide:chevron-right";
+    readonly arrowRight: "lucide:arrow-right";
+    readonly arrowLeft: "lucide:arrow-left";
+    readonly instagram: "lucide:instagram";
+    readonly twitter: "lucide:twitter";
+    readonly facebook: "lucide:facebook";
+    readonly youtube: "lucide:youtube";
+    readonly linkedin: "lucide:linkedin";
+    readonly github: "lucide:github";
+    readonly hydration: "lucide:droplet";
+    readonly hydrationIntense: "lucide:droplets";
+    readonly brightening: "lucide:sparkles";
+    readonly natural: "lucide:leaf";
+    readonly spf: "lucide:sun";
+    readonly nightCare: "lucide:moon";
+    readonly botanical: "lucide:flower";
+    readonly organic: "lucide:sprout";
+    readonly science: "lucide:beaker";
+    readonly lab: "lucide:flask";
+    readonly formula: "lucide:dna";
+    readonly gentle: "lucide:heart";
+    readonly sensitive: "lucide:heart-pulse";
+    readonly add: "lucide:plus";
+    readonly remove: "lucide:minus";
+    readonly check: "lucide:check";
+    readonly checkCircle: "lucide:check-circle";
+    readonly rating: "lucide:star";
+    readonly share: "lucide:share-2";
+    readonly copy: "lucide:copy";
+    readonly download: "lucide:download";
+    readonly upload: "lucide:upload";
+    readonly refresh: "lucide:refresh";
+    readonly loading: "lucide:loader-2";
+    readonly clock: "lucide:clock";
+    readonly timer: "lucide:timer";
+    readonly calendar: "lucide:calendar";
+    readonly trending: "lucide:flame";
+    readonly flashSale: "lucide:zap";
+    readonly trendingUp: "lucide:trending-up";
+    readonly info: "lucide:info";
+    readonly alert: "lucide:alert-circle";
+    readonly warning: "lucide:alert-triangle";
+    readonly help: "lucide:help-circle";
+    readonly chat: "lucide:message-circle";
+    readonly email: "lucide:mail";
+    readonly phone: "lucide:phone";
+    readonly image: "lucide:image";
+    readonly video: "lucide:video";
+    readonly play: "lucide:play";
+    readonly pause: "lucide:pause";
+    readonly playCircle: "lucide:play-circle";
+    readonly testimonial: "lucide:quote";
+    readonly location: "lucide:map-pin";
+    readonly package: "lucide:package";
+    readonly delivered: "lucide:package-check";
+    readonly gift: "lucide:gift";
+    readonly sale: "lucide:tag";
+    readonly coupon: "lucide:ticket";
+    readonly payment: "lucide:credit-card";
+    readonly receipt: "lucide:receipt";
+    readonly discount: "lucide:percent";
+    readonly price: "lucide:circle-dollar-sign";
+};
+/**
+ * Icon categories for easier discovery
+ */
+export declare const ICON_CATEGORIES: {
+    readonly shopping: readonly ["cart", "bag", "wishlist", "quickView", "zoomIn", "zoomOut", "fullscreen"];
+    readonly trust: readonly ["shield", "shipping", "returns", "verified", "secure", "award"];
+    readonly navigation: readonly ["menu", "search", "user", "close", "chevronDown", "chevronUp", "arrowRight"];
+    readonly social: readonly ["instagram", "twitter", "facebook", "youtube", "linkedin", "github"];
+    readonly features: readonly ["hydration", "brightening", "natural", "spf", "nightCare", "botanical", "science"];
+    readonly actions: readonly ["add", "remove", "check", "rating", "share", "loading"];
+    readonly urgency: readonly ["clock", "timer", "trending", "flashSale"];
+    readonly info: readonly ["info", "alert", "warning", "help", "chat"];
+};
+/**
+ * Helper to get icon string by name
+ * @example getIcon("cart") → "lucide:shopping-cart"
+ */
+export declare function getIcon(name: keyof typeof RECOMMENDED_ICONS): string;
+/**
+ * Helper to check if an icon name exists
+ */
+export declare function hasIcon(name: string): name is keyof typeof RECOMMENDED_ICONS;
+//# sourceMappingURL=icon-map.d.ts.map

package/dist/utils/icon-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"icon-map.d.ts","sourceRoot":"","sources":["../../src/utils/icon-map.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4GpB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;CAiElB,CAAC;AAEX;;;GAGG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,OAAO,iBAAiB,GAAG,MAAM,CAEpE;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,MAAM,OAAO,iBAAiB,CAE5E"}