@syntrologie/adapt-product 2.28.0 → 2.29.0

package/dist/widgets/ProductGridLit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ProductGridLit.d.ts","sourceRoot":"","sources":["../../src/widgets/ProductGridLit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,UAAU,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AAErE,OAAO,EAAE,KAAK,SAAS,EAAc,MAAM,WAAW,CAAC;AAGvD,qBAAa,cAAe,SAAQ,UAAU;;IAC5C,OAAgB,UAAU;;;;;;;;;;MAIxB;IAEF,KAAK,EAAE,SAAS,GAAG,SAAS,CAAa;IACzC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAM;IAClE,eAAe,UAAS;IAIf,gBAAgB;IAIhB,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAM/C,oBAAoB,IAAI,IAAI;IA6B5B,MAAM,IAAI,cAAc,GAAG,OAAO,OAAO;CA0BnD"}
+{"version":3,"file":"ProductGridLit.d.ts","sourceRoot":"","sources":["../../src/widgets/ProductGridLit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,UAAU,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AAErE,OAAO,EAAE,KAAK,SAAS,EAAc,MAAM,WAAW,CAAC;AAGvD,qBAAa,cAAe,SAAQ,UAAU;;IAC5C,OAAgB,UAAU;;;;;;;;;;MAIxB;IAEF,KAAK,EAAE,SAAS,GAAG,SAAS,CAAa;IACzC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAM;IAClE,eAAe,UAAS;IAIf,gBAAgB;IAIhB,iBAAiB,IAAI,IAAI;IASzB,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAM/C,oBAAoB,IAAI,IAAI;IA6B5B,MAAM,IAAI,cAAc,GAAG,OAAO,OAAO;CA0BnD"}

package/dist/widgets/ProductHeroLit.d.ts

@@ -20,6 +20,7 @@ export declare class ProductHeroLit extends LitElement {
     }>;
     validationError: boolean;
     createRenderRoot(): this;
+    connectedCallback(): void;
     willUpdate(changed: Map<string, unknown>): void;
     disconnectedCallback(): void;
     render(): TemplateResult | typeof nothing;

package/dist/widgets/ProductHeroLit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ProductHeroLit.d.ts","sourceRoot":"","sources":["../../src/widgets/ProductHeroLit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,UAAU,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AAGrE,OAAO,EAAE,KAAK,SAAS,EAAc,MAAM,WAAW,CAAC;AAEvD,qBAAa,cAAe,SAAQ,UAAU;;IAC5C,OAAgB,UAAU;;;;;;;;;;MAIxB;IAEF,KAAK,EAAE,SAAS,GAAG,SAAS,CAAa;IACzC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAM;IAClE,eAAe,UAAS;IAIf,gBAAgB;IAIhB,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAM/C,oBAAoB,IAAI,IAAI;IA6B5B,MAAM,IAAI,cAAc,GAAG,OAAO,OAAO;CAuEnD"}
+{"version":3,"file":"ProductHeroLit.d.ts","sourceRoot":"","sources":["../../src/widgets/ProductHeroLit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,UAAU,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AAGrE,OAAO,EAAE,KAAK,SAAS,EAAc,MAAM,WAAW,CAAC;AAEvD,qBAAa,cAAe,SAAQ,UAAU;;IAC5C,OAAgB,UAAU;;;;;;;;;;MAIxB;IAEF,KAAK,EAAE,SAAS,GAAG,SAAS,CAAa;IACzC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAM;IAClE,eAAe,UAAS;IAIf,gBAAgB;IAIhB,iBAAiB,IAAI,IAAI;IASzB,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAM/C,oBAAoB,IAAI,IAAI;IA6B5B,MAAM,IAAI,cAAc,GAAG,OAAO,OAAO;CAuEnD"}

package/dist/widgets/ProductRecoCarouselLit.d.ts

@@ -0,0 +1,24 @@
+import { LitElement, nothing, type TemplateResult } from 'lit';
+import { type RecoProps } from '../schema';
+import { type RenderHealthProbe } from './renderHealthReporter';
+export declare class ProductRecoCarouselLit extends LitElement {
+    #private;
+    static properties: {
+        props: {
+            attribute: boolean;
+        };
+        _parsed: {
+            state: boolean;
+        };
+    };
+    static readonly _testing: {
+        healthProbe: (host: ProductRecoCarouselLit) => RenderHealthProbe | null;
+    };
+    props: RecoProps | undefined;
+    private _parsed;
+    constructor();
+    createRenderRoot(): this;
+    willUpdate(changed: Map<string, unknown>): void;
+    render(): TemplateResult | typeof nothing;
+}
+//# sourceMappingURL=ProductRecoCarouselLit.d.ts.map

package/dist/widgets/ProductRecoCarouselLit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProductRecoCarouselLit.d.ts","sourceRoot":"","sources":["../../src/widgets/ProductRecoCarouselLit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,UAAU,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AAErE,OAAO,EAAE,KAAK,SAAS,EAAc,MAAM,WAAW,CAAC;AACvD,OAAO,EAA0B,KAAK,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAExF,qBAAa,sBAAuB,SAAQ,UAAU;;IACpD,OAAgB,UAAU;;;;;;;MAA6D;IACvF,MAAM,CAAC,QAAQ,CAAC,QAAQ;4BACF,sBAAsB,KAAG,iBAAiB,GAAG,IAAI;MACrE;IACM,KAAK,EAAE,SAAS,GAAG,SAAS,CAAC;IACrC,QAAgB,OAAO,CAAwB;;IAyBtC,gBAAgB;IAGhB,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC;IAMxC,MAAM,IAAI,cAAc,GAAG,OAAO,OAAO;CAwBnD"}

package/dist/widgets/SyntroPdpLit.d.ts

@@ -0,0 +1,366 @@
+import { LitElement, type PropertyValues } from 'lit';
+import { type PdpPlanTaskClient } from '../decision/pdp-compose';
+import './PdpSectionHeaderLit';
+import './PdpOtherProductsCarouselLit.js';
+import './PdpOtherProductsGridLit.js';
+export interface VisitorAttribution {
+    referrer: string;
+    referring_domain: string;
+    initial_url: string;
+    initial_pathname: string;
+    utm_source: string;
+    utm_medium: string;
+    utm_campaign: string;
+    utm_content: string;
+    utm_term: string;
+}
+export interface VisitorGeo {
+    country: string;
+    country_code: string;
+    region: string;
+    city: string;
+    is_eu: boolean;
+}
+export interface VisitorDevice {
+    user_agent: string;
+    locale: string;
+    viewport_w: number | null;
+    viewport_h: number | null;
+    screen_w: number | null;
+    screen_h: number | null;
+    dpr: number | null;
+    is_touch: boolean;
+}
+export interface VisitorSignals {
+    attribution: VisitorAttribution;
+    geo: VisitorGeo;
+    device: VisitorDevice;
+    session_metrics: Record<string, string | number | boolean>;
+    extras: Record<string, string | number | boolean>;
+}
+export interface MountedInstance {
+    instance_id: string;
+    element_type: 'tile' | 'action' | 'item';
+    template_id: string;
+    placement: {
+        type: 'slot';
+        slot: string;
+    } | {
+        type: string;
+        [key: string]: unknown;
+    };
+    content: Record<string, unknown>;
+    state: string;
+    mounted_by: {
+        agent_id: string;
+        turn_id: string;
+    };
+    mounted_at: string;
+    version: number;
+}
+export interface MutationEnvelope {
+    type: 'syntro.element.mutation';
+    schema_version: 'v0';
+    mutations: Array<{
+        op: 'mount';
+        instance: MountedInstance;
+    }>;
+}
+export type { PdpModuleHeaderClient, PdpPlanEnvelope, PdpPlanTaskClient, } from '../decision/pdp-compose';
+export interface RuntimeContext {
+    page: {
+        locale?: string;
+        routeId?: string;
+        title?: string;
+        url: string;
+    };
+    session: {
+        pageHistory?: Array<{
+            ts: number;
+            url: string;
+        }>;
+        sessionId?: string;
+        startTs: number;
+    };
+    surface: {
+        device: string;
+        host: string;
+        mode: string;
+        type: string;
+    };
+    viewport: {
+        height: number;
+        width: number;
+    };
+}
+export interface SmartCanvasRuntime {
+    apps?: {
+        has?(appId: string): boolean;
+    };
+    telemetry?: {
+        track?(eventName: string, props?: Record<string, unknown>): void;
+    };
+}
+interface SynOSGlobal {
+    runtime?: {
+        context: {
+            get(): RuntimeContext;
+        };
+        sessionMetrics?: {
+            getAll(): Record<string, number>;
+        };
+        telemetry?: {
+            getDistinctId?(): string | undefined;
+            getSessionId?(): string | undefined;
+            getSegmentFlags?(): Record<string, boolean> | undefined;
+            getAllFeatureFlags?(): Record<string, boolean | string> | undefined;
+        };
+    };
+    /** On-demand scoring (the runtime's thin `score` primitive). */
+    score?: (spec: unknown) => Promise<string>;
+    /** Batched two-axis scoring through one backend model call. */
+    scoreMulti?: (specs: unknown[]) => Promise<string[]>;
+    /**
+     * Authenticated transport to the runtime-backend (the runtime owns auth; the
+     * adaptive owns which endpoint + payload). Used for the live module endpoint.
+     */
+    authedFetch?: (path: string, init?: RequestInit) => Promise<Response>;
+}
+interface PdpExplainMetric {
+    value: string;
+    label: string;
+    /** Forensic one-liner shown in the "What we measured" drawer. */
+    hint?: string;
+}
+interface PdpExplain {
+    archetypeLabel: string;
+    archetypeDesc: string;
+    decisionLabel: string | null;
+    decisionDesc: string | null;
+    summary: string;
+    /** Hero row — punchy, scannable. */
+    metrics: PdpExplainMetric[];
+    /** Full forensic dossier — revealed in the "What we measured" drawer. */
+    dossier: PdpExplainMetric[];
+}
+/** Title-case a slug: "aging-cognitive" → "Aging Cognitive". */
+declare function _titleCase(slug: string): string;
+/**
+ * Build the "why box" content from the two model outputs + the visitor's REAL
+ * session signals. Every metric is either a true measurement (signals analyzed,
+ * scroll depth, time engaged, pages, models run, latency) or an opaque signature
+ * (the behavioral fingerprint). NO invented population statistics ("similar
+ * visitors matched", "top N%") — those are the only refutable kind, because they
+ * assert something about OTHER people we can't show. Everything here is provable
+ * from this visitor's own session.
+ *
+ * Tier 1 (here): SDK-local real metrics. Tier 2 (backend) will fold in the
+ * event-stream forensics (interaction rhythm, engagement entropy, friction
+ * signals, cursor travel) computed from `recent_observations`.
+ */
+declare function buildExplain(opts: {
+    archetype: string;
+    description: string;
+    decisionArchetype: string;
+    decisionDescription: string;
+    summary: string;
+    signals: Record<string, unknown>;
+    latencyMs: number;
+}): PdpExplain;
+declare function gatherDevice(context: RuntimeContext | undefined): VisitorDevice;
+/**
+ * UTM + referrer + initial URL — read from PostHog person properties
+ * (where the SDK writes them via setPersonPropertiesOnce).
+ *
+ * TODO: swap to `runtime.telemetry.getProperty(name)` once that getter lands.
+ */
+declare function gatherAttribution(): VisitorAttribution;
+/**
+ * Geo — read from the localStorage cache the SDK writes at bootstrap time
+ * (key `syntro_geo`).
+ *
+ * TODO: swap to `runtime.context.get().geo` once the SDK exposes that field.
+ */
+declare function gatherGeo(): VisitorGeo;
+declare function gatherSessionMetrics(runtime: SynOSGlobal['runtime']): Record<string, string | number | boolean>;
+declare function gatherExtras(runtime: SynOSGlobal['runtime'], context: RuntimeContext | undefined): Record<string, string | number | boolean>;
+declare function readChatExcerpt(): string;
+/**
+ * Collect every personalization signal the SDK has access to client-side.
+ * Never throws — missing signals degrade to empty values.
+ */
+export declare function gatherVisitorSignals(): VisitorSignals;
+export type TemplateToTagKey = string;
+export declare const TEMPLATE_TO_TAG: Record<TemplateToTagKey, string>;
+/**
+ * Resolve the custom element tag to mount for a given plan task instance.
+ *
+ * Resolution order:
+ * 1. `"<kind>/<variant>"` if `variant` is non-null
+ * 2. `"<kind>"` (base) — covers unknown-variant fallback
+ * 3. `null` if the kind itself is unknown
+ */
+export declare function resolveTagForMount(inst: PdpPlanTaskClient): string | null;
+/**
+ * Test seam — exposes private module-scope functions for unit testing only.
+ * Do NOT use outside of test files.
+ */
+export declare const _testing: {
+    buildExplain: typeof buildExplain;
+    gatherAttribution: typeof gatherAttribution;
+    gatherDevice: typeof gatherDevice;
+    gatherExtras: typeof gatherExtras;
+    gatherGeo: typeof gatherGeo;
+    gatherSessionMetrics: typeof gatherSessionMetrics;
+    gatherVisitorSignals: typeof gatherVisitorSignals;
+    readChatExcerpt: typeof readChatExcerpt;
+    resolveTagForMount: typeof resolveTagForMount;
+    TEMPLATE_TO_TAG: Record<string, string>;
+    titleCase: typeof _titleCase;
+};
+/**
+ * <syntro-pdp> — the dynamic personalized PDP surface.
+ *
+ * Config-first flow: gathers visitor signals from the SDK runtime, scores the
+ * visitor's archetype, mounts the host-supplied config presets, and generates
+ * the remaining live slots via the runtime container's /api/pdp/module and
+ * /api/pdp/dossier endpoints. Customer code mounts this one element; everything
+ * else is internal to the SDK.
+ *
+ * Attributes (kebab-case, set by host markup):
+ *   - product-id (required)
+ *   - product-name (required)
+ *   - product-blurb (optional)
+ *
+ * Properties (set by mountable, not host markup):
+ *   - runtimeRef: SmartCanvasRuntime — passed by the AppLoader through
+ *     the existing widget-mountable mechanism.
+ */
+export declare class SyntroPdpLit extends LitElement {
+    static properties: {
+        productId: {
+            type: StringConstructor;
+            attribute: string;
+        };
+        productName: {
+            type: StringConstructor;
+            attribute: string;
+        };
+        productBlurb: {
+            type: StringConstructor;
+            attribute: string;
+        };
+        runtimeRef: {
+            attribute: boolean;
+        };
+        _decisionState: {
+            state: boolean;
+        };
+    };
+    productId: string;
+    productName: string;
+    productBlurb: string;
+    /**
+     * SDK runtime. Null until the mountable wires it in. We only render
+     * the personalized surface once runtimeRef is present AND the
+     * activation gate passes.
+     */
+    runtimeRef: SmartCanvasRuntime | null;
+    /** Canonical decision and render state. */
+    private _decisionState;
+    private _composeStartedAt;
+    private _lastArchetype;
+    private _mountDurations;
+    /**
+     * Native takeover state (FEAT-1784346204). `_nativeSlots` holds the slot ids
+     * whose native host section exists OUTSIDE this element — the render loop
+     * skips those so the element never renders a duplicate qa/peer-feed section.
+     * `_nativeHandles` tracks each active swap so it can be restored (before a
+     * re-swap, and on disconnect).
+     */
+    private _nativeSlots;
+    private _nativeHandles;
+    /**
+     * The scored axes from the current config pass — the SAME values
+     * `_fireFromConfig` resolved (sport-archetype preset key + decision archetype).
+     * Captured at scoring time so they are already on the element when mounts
+     * apply, which is BEFORE `_fireFromConfig` returns. Both default to 'unknown'.
+     */
+    private _resolvedArchetype;
+    private _resolvedDecision;
+    private _effectExecutor;
+    private _dispatchDecision;
+    private _onDossierToggle;
+    createRenderRoot(): this;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    willUpdate(changed: PropertyValues): void;
+    /**
+     * Probe the document for native host sections (`data-syntro-slot="qa"` /
+     * `"peer-feed"`) that live OUTSIDE this element, and record their slot ids.
+     * The render loop skips these slots; the mount path swaps into them.
+     */
+    private _refreshNativeSlots;
+    /**
+     * A visitor is personalized unless BOTH scored axes declined to 'unknown'.
+     * A fully-unknown visitor keeps the host's default native content untouched.
+     */
+    private _isPersonalizedVisitor;
+    updated(_changed: PropertyValues): void;
+    /** The host page's above-the-fold mount for the page-wide why box, if any. */
+    private _whyPortalEl;
+    private _syncDecisionRuntime;
+    private _syncDecisionPortal;
+    /**
+     * Emit a telemetry event via the runtime's track API.
+     * Wrapped in try/catch so a broken telemetry integration never crashes the
+     * compose flow. Always includes `source: 'sdk'` in props.
+     */
+    private _track;
+    private _captureDecisionTelemetry;
+    private _warnDecision;
+    private _clearDecisionPortal;
+    private _cleanupDecisionEffects;
+    private _startDecisionCompose;
+    /** Mount each instance into its slot. Shared by config and compose. */
+    private _applyMounts;
+    /** Render from config: score the archetype → mount the preset set-values. */
+    private _fireFromConfig;
+    /**
+     * The demo "why box": surfaces the archetype + behavior-summary model outputs
+     * and a row of impressive personalization metrics at the very top of the PDP
+     * (below the host banner).
+     *
+     * The NARRATIVE MUST LEAD THE PAGE: a placeholder renders the instant the
+     * compose flow starts streaming (before the archetype/summary land), then
+     * fills IN PLACE when the decision explanation arrives. Previously it rendered nothing until
+     * both models scored, so on a live load it popped in AFTER modules had already
+     * mounted — the reasoning banner trailed the content instead of leading it.
+     * Renders nothing only before streaming begins (pre-plan) or once done with no
+     * explanation (nothing to say).
+     */
+    private _renderWhyBox;
+    /**
+     * The narrative placeholder: the same quiet "How Syntrologie decided" line as
+     * the real why box (so it reads as "the reasoning is loading", not a different
+     * element), with a shimmer bar where the archetype + summary will land.
+     * Carries the same `data-syntro-pdp-why` marker plus `data-syntro-pdp-why-loading`,
+     * so the swap to the filled box is a state change, not a first appearance.
+     */
+    private _renderWhyBoxLoading;
+    render(): import("lit-html").TemplateResult<1>;
+    /**
+     * Self-contained skeleton (shimmer) CSS. Rendered inside the component
+     * during the pre-plan / streaming phase. The global section-layout +
+     * per-slot accent rules live in the head-injected `SECTION_LAYOUT_CSS`
+     * (see `ensureSectionLayoutStyles`), not here, so they're emitted once
+     * per document rather than once per `<syntro-pdp>` instance.
+     */
+    private static readonly _skeletonStyles;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'syntro-pdp': SyntroPdpLit;
+    }
+}
+//# sourceMappingURL=SyntroPdpLit.d.ts.map

package/dist/widgets/SyntroPdpLit.d.ts.map

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

package/dist/widgets/VariantPanelLit.d.ts

@@ -0,0 +1,98 @@
+import { LitElement } from 'lit';
+import type { VariantPayload } from '../platformAdapter';
+export declare class VariantPanelLit extends LitElement {
+    #private;
+    static properties: {
+        payload: {
+            attribute: boolean;
+        };
+        productTitle: {
+            type: StringConstructor;
+        };
+        productImage: {
+            attribute: boolean;
+        };
+        state: {
+            type: StringConstructor;
+        };
+        error: {
+            type: StringConstructor;
+        };
+        _selection: {
+            state: boolean;
+        };
+        _touched: {
+            state: boolean;
+        };
+        _expandedAxes: {
+            state: boolean;
+        };
+        _axisFilter: {
+            state: boolean;
+        };
+    };
+    payload: VariantPayload | null;
+    productTitle: string;
+    /** Product-level hero image, passed from the card. Shown on the back face and
+     *  used as the fallback when the selected variant carries no featured_image. */
+    productImage: {
+        src: string;
+        alt?: string;
+    } | null;
+    state: 'idle' | 'loading' | 'error';
+    error: string | null;
+    /** @internal */
+    _selection: Record<string, string>;
+    /** @internal */
+    _touched: Set<string>;
+    /** @internal — Tier-C axes currently showing their listbox. */
+    _expandedAxes: Set<string>;
+    /** @internal — Tier-C per-axis filter text. */
+    _axisFilter: Record<string, string>;
+    constructor();
+    createRenderRoot(): this;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    private _onKeydown;
+    private _findMatchingVariant;
+    private _isValueDisabled;
+    private _hasAnyOOSForAttribute;
+    private _onPillClick;
+    private _onBack;
+    private _onAdd;
+    private _onRetry;
+    /** The hero image URL to show: the matched variant's featured_image when the
+     *  current selection resolves to a variant that has one, else the product
+     *  image. Null when neither exists. */
+    private _heroSrc;
+    private _ctaEnabled;
+    render(): import("lit-html").TemplateResult<1>;
+    private _renderAttributeRow;
+    static readonly SEGMENTED_MAX_OPTIONS = 3;
+    /** Density Tier B: a wrap row past this many options becomes a one-row
+     *  horizontal scroll track (edge-faded, snap) instead of eating the bounded
+     *  panel's height with wrapped rows. */
+    static readonly SCROLL_MIN_OPTIONS = 9;
+    /** Density Tier C: past this many options the axis collapses into a
+     *  select-style trigger + scrollable listbox. ONLY the offending axis
+     *  collapses — sibling axes keep their own tier (per Parker, 2026-07-23). */
+    static readonly COLLAPSE_MIN_OPTIONS = 17;
+    /** Inside a Tier-C listbox, a type-ahead filter appears past this count. */
+    static readonly FILTER_MIN_OPTIONS = 25;
+    private _isScrollTier;
+    private _renderPillRow;
+    private _renderSwatchRow;
+    private _toggleAxis;
+    private _onCollapsedSelect;
+    private _onAxisFilterInput;
+    /** Density Tier C — select-style trigger + bounded scrollable listbox.
+     *  ONLY this axis collapses; siblings keep their own tier. Filter appears
+     *  past FILTER_MIN_OPTIONS. Out-of-stock options stay visible, disabled. */
+    private _renderCollapsedAxis;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'syntro-variant-panel': VariantPanelLit;
+    }
+}
+//# sourceMappingURL=VariantPanelLit.d.ts.map

package/dist/widgets/VariantPanelLit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VariantPanelLit.d.ts","sourceRoot":"","sources":["../../src/widgets/VariantPanelLit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,UAAU,EAAW,MAAM,KAAK,CAAC;AAChD,OAAO,KAAK,EAAyB,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAoQhF,qBAAa,eAAgB,SAAQ,UAAU;;IAC7C,OAAgB,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAUxB;IAEF,OAAO,EAAE,cAAc,GAAG,IAAI,CAAQ;IACtC,YAAY,SAAM;IAClB;oFACgF;IAChF,YAAY,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAQ;IAC1D,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAU;IAC7C,KAAK,EAAE,MAAM,GAAG,IAAI,CAAQ;IAE5B,gBAAgB;IAChB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAM;IACxC,gBAAgB;IAChB,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAa;IAClC,+DAA+D;IAC/D,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,CAAa;IACvC,+CAA+C;IAC/C,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAM;;IAuBhC,gBAAgB;IAIhB,iBAAiB,IAAI,IAAI;IAQzB,oBAAoB,IAAI,IAAI;IAKrC,OAAO,CAAC,UAAU,CAIhB;IAEF,OAAO,CAAC,oBAAoB;IAS5B,OAAO,CAAC,gBAAgB;IAexB,OAAO,CAAC,sBAAsB;IAI9B,OAAO,CAAC,YAAY;IAapB,OAAO,CAAC,OAAO;IAIf,OAAO,CAAC,MAAM;IAYd,OAAO,CAAC,QAAQ;IAIhB;;2CAEuC;IACvC,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,WAAW;IAOV,MAAM;IAwGf,OAAO,CAAC,mBAAmB;IAsB3B,MAAM,CAAC,QAAQ,CAAC,qBAAqB,KAAK;IAC1C;;4CAEwC;IACxC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,KAAK;IACvC;;iFAE6E;IAC7E,MAAM,CAAC,QAAQ,CAAC,oBAAoB,MAAM;IAC1C,4EAA4E;IAC5E,MAAM,CAAC,QAAQ,CAAC,kBAAkB,MAAM;IAExC,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,cAAc;IAuBtB,OAAO,CAAC,gBAAgB;IA4BxB,OAAO,CAAC,WAAW;IAcnB,OAAO,CAAC,kBAAkB;IAc1B,OAAO,CAAC,kBAAkB;IAI1B;;gFAE4E;IAC5E,OAAO,CAAC,oBAAoB;CAsF7B;AAID,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,sBAAsB,EAAE,eAAe,CAAC;KACzC;CACF"}

package/dist/widgets/ensureStylesInRoot.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Inject a `<style>` into the element's OWN root node — the shadow root that
+ * contains it when the widget is mounted inside another element's shadow tree
+ * (e.g. a canvas's `<sc-mount>`), or `document.head` when it lives in the light
+ * DOM (chat trail, a host PDP page).
+ *
+ * Why this exists: these product widgets render in light DOM (`createRenderRoot`
+ * returns `this`) and style themselves with an injected stylesheet. When a
+ * canvas mounts the widget inside `<sc-mount>`, the widget subtree lands inside
+ * `sc-mount`'s SHADOW root. A stylesheet appended to `document.head` does NOT
+ * cross that shadow boundary, so the widget rendered with default browser
+ * styling and none of its own CSS. Injecting into `getRootNode()` puts the
+ * stylesheet in the same tree as the element, so it applies on every surface.
+ * Only CSS custom-property VALUES cross shadow boundaries — which is why the
+ * host canvas themes the widget via `--sc-*` tokens while the layout/appearance
+ * CSS must travel with the widget itself.
+ *
+ * Idempotent per root: guarded by the style id so repeated mounts into the same
+ * root inject once; distinct roots (multiple mounts) each get their own copy.
+ */
+export declare function ensureStylesInRoot(el: Element, id: string, css: string): void;
+//# sourceMappingURL=ensureStylesInRoot.d.ts.map

package/dist/widgets/ensureStylesInRoot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensureStylesInRoot.d.ts","sourceRoot":"","sources":["../../src/widgets/ensureStylesInRoot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAS7E"}

package/dist/widgets/entrance.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Entrance-animation settle helper — GPU/compositing hazard fix.
+ *
+ * The PDP widgets play a fade/slide entrance on mount. The old authoring
+ * rested the animated element at `opacity: 0` and relied on
+ * `animation: … forwards` to bring it to `opacity: 1`. When the browser
+ * DROPS or SUPPRESSES that animation — battery-saver mode, an over-budget
+ * compositor, a backgrounded tab that never runs the keyframes — the element
+ * stays at `opacity: 0` forever: a permanently blank PDP section. (Same class
+ * of bug as the ProductCard/FAQ flip resting at rotateY(180).)
+ *
+ * The fix keeps the entrance PIXEL-IDENTICAL but inverts the resting state:
+ *   - base rule: `opacity: 1` (content is always visible at rest);
+ *   - a transient `.is-entering` class (applied on the container at mount)
+ *     re-introduces `opacity: 0` + the exact same keyframes with `both` fill
+ *     so the pre-delay invisibility is preserved;
+ *   - `@media (prefers-reduced-motion: reduce)` neutralises `.is-entering`
+ *     (content immediately visible, no animation).
+ *
+ * This helper arms the REMOVAL of `.is-entering` once the entrance has run:
+ *   - fast path: the container's OWN `animationend` (only when `fastPath` is
+ *     set — i.e. the container's own keyframes are the last to finish; widgets
+ *     with longer-running staggered children leave this off and lean on the
+ *     belt so the class is never pulled mid-stagger);
+ *   - belt: a `setTimeout` sized to the longest keyframe
+ *     (delay + duration + margin) that ALWAYS fires, even if `animationend`
+ *     never does.
+ *
+ * Removing the class is a visual no-op: the base state is `opacity: 1` and the
+ * `both` fill holds the final keyframe until the moment the class drops.
+ *
+ * @returns a disposer that clears the belt timer + listener (call on disconnect).
+ */
+export declare function armEntranceSettle(onSettle: () => void, container: HTMLElement | null, settleMs: number, fastPath?: boolean): () => void;
+//# sourceMappingURL=entrance.d.ts.map

package/dist/widgets/entrance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entrance.d.ts","sourceRoot":"","sources":["../../src/widgets/entrance.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,IAAI,EACpB,SAAS,EAAE,WAAW,GAAG,IAAI,EAC7B,QAAQ,EAAE,MAAM,EAChB,QAAQ,UAAQ,GACf,MAAM,IAAI,CA8BZ"}

package/dist/widgets/renderHealth.d.ts

@@ -0,0 +1,57 @@
+/**
+ * renderHealth — runtime self-detection of clipping and blank render.
+ *
+ * A product card can look correct in tests yet clip text or paint blank on a
+ * real host (a narrow theme column, a font that measures wider, a broken image
+ * CDN). The battery walks the playground at build time; this module is its
+ * RUNTIME counterpart — after the card paints, it re-measures itself against the
+ * SAME policy and emits a PostHog signal when it finds an undeclared clip or a
+ * blank card. Field-RUM for "the card broke on a customer's page".
+ *
+ * NON-PII discipline: only element tag/class PATHS and pixel numbers ever leave
+ * the widget — never text content, never customer copy. The paths are the
+ * structural coordinates a dashboard needs to locate the offending node.
+ *
+ * Pattern-setter: this lives in a small shared module (not inline in
+ * ProductCardLit) so sibling widgets (comparison, grid, hero) can adopt the same
+ * self-detection with one import.
+ */
+/** A single undeclared-clip finding inside a card. */
+export interface ClipFinding {
+    /** Structural path to the offending node, e.g. `div.sc-product-card__specs>span`. NON-PII. */
+    path: string;
+    /** How many px the node overflows its clip box (text scrollWidth overflow, or
+     *  child escaping the card's own clip box). Rounded. */
+    over_px: number;
+    /** Why this counts as a clip. Absent for ordinary (Tier-3) undeclared clips.
+     *  `identity-truncated` marks a Tier-1 CRITICAL text node (product name,
+     *  price, CTA label, picker title — `[data-critical-text]`) that truncated
+     *  even with a declared ellipsis / clip-ok. Identity text must render in full,
+     *  so ANY horizontal overflow of a critical node is a defect. NON-PII. */
+    reason?: 'identity-truncated';
+}
+/** Result of a render-health measurement pass. */
+export interface RenderHealth {
+    /** Undeclared clips found inside the card (empty = clean). */
+    clips: ClipFinding[];
+    /** True when the card occupies real area but painted no text AND no complete
+     *  image (a blank card). */
+    blank: boolean;
+}
+/**
+ * Measure the render health of a card element. Pure DOM read — no side effects,
+ * no telemetry. Safe to call any time after paint. The caller (ProductCardLit)
+ * decides whether/when to emit.
+ *
+ * Policy mirrors tmp-live/battery.mjs:
+ *  - identity-truncated (Tier 1): a [data-critical-text] node (name, price, CTA
+ *    label, picker title) whose scrollWidth exceeds clientWidth by >1px — even
+ *    WITH an ellipsis or under [data-clip-ok]. Identity text must render in full.
+ *  - text-clip: an element with its own text whose scrollWidth exceeds
+ *    clientWidth by >1px and has no textOverflow:ellipsis, not under [data-clip-ok].
+ *  - element-clip: a text/media node escaping a HARD-clip ancestor by >1px,
+ *    where the ancestor is not scrollable, not a line-clamp box, not clip-ok.
+ *  - blank: the card has real area but no painted text and no complete image.
+ */
+export declare function measureRenderHealth(card: Element): RenderHealth;
+//# sourceMappingURL=renderHealth.d.ts.map

package/dist/widgets/renderHealth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderHealth.d.ts","sourceRoot":"","sources":["../../src/widgets/renderHealth.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,sDAAsD;AACtD,MAAM,WAAW,WAAW;IAC1B,8FAA8F;IAC9F,IAAI,EAAE,MAAM,CAAC;IACb;4DACwD;IACxD,OAAO,EAAE,MAAM,CAAC;IAChB;;;;8EAI0E;IAC1E,MAAM,CAAC,EAAE,oBAAoB,CAAC;CAC/B;AAED,kDAAkD;AAClD,MAAM,WAAW,YAAY;IAC3B,8DAA8D;IAC9D,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB;gCAC4B;IAC5B,KAAK,EAAE,OAAO,CAAC;CAChB;AAuDD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,YAAY,CA0F/D"}