@sentientui/core 0.20.1 → 0.21.0

package/dist/{index-DqALhS-k.d.cts → index-BheP9F8h.d.cts}

@@ -1,6 +1,135 @@
 import { b as SlotDeclInput } from './session-meta-BVvq5RBB.cjs';
 import { SlotResult } from '@sentientui/policy';
 
+/**
+ * Composition Blocks (spec: 2026-08-20-nocode-composition-variants-design.md §4).
+ *
+ * A bounded, TYPED component tree — never HTML — that a registry arm may carry
+ * (`published_config.arms[].blocks`). The vocabulary is the whitelist: every
+ * prop value is an enumerated token, validated server-side before publish
+ * (apps/api/src/domain/composition-blocks.ts) and rendered client-side through
+ * document.createElement + property assignment only. No innerHTML/outerHTML/
+ * insertAdjacentHTML exists anywhere on this path — the security property is
+ * preserved by never accepting HTML, not by sanitizing it, which is why there
+ * is no sanitizer to keep honest.
+ *
+ * Token lists live here (not in the API domain like SlotOps' mirrors) because
+ * three parties must agree byte-for-byte: the server validator, the snippet
+ * renderer, and eventually the React renderer (§11) — a drifted copy would let
+ * a published arm fail to render, which the fail-safe turns into an invisibly
+ * missing section, not an error.
+ */
+declare const BLOCK_GAPS: readonly ["none", "sm", "md", "lg"];
+declare const BLOCK_ALIGNS: readonly ["start", "center", "end", "stretch"];
+declare const BLOCK_JUSTIFIES: readonly ["start", "center", "end", "between"];
+declare const BLOCK_SIZES: readonly ["sm", "md", "lg"];
+declare const BLOCK_WEIGHTS: readonly ["normal", "medium", "bold"];
+declare const BLOCK_TONES: readonly ["default", "muted", "accent"];
+declare const BLOCK_EMPHASES: readonly ["primary", "secondary", "ghost"];
+declare const BLOCK_TEXT_ALIGNS: readonly ["left", "center", "right"];
+declare const BLOCK_RATIOS: readonly ["auto", "square", "landscape", "wide"];
+declare const BLOCK_FITS: readonly ["cover", "contain"];
+declare const BLOCK_GRID_COLUMNS: readonly [2, 3, 4];
+declare const BLOCK_HEADING_LEVELS: readonly [2, 3, 4];
+type BlockGap = (typeof BLOCK_GAPS)[number];
+type BlockAlign = (typeof BLOCK_ALIGNS)[number];
+type BlockJustify = (typeof BLOCK_JUSTIFIES)[number];
+type BlockSize = (typeof BLOCK_SIZES)[number];
+type BlockWeight = (typeof BLOCK_WEIGHTS)[number];
+type BlockTone = (typeof BLOCK_TONES)[number];
+type BlockEmphasis = (typeof BLOCK_EMPHASES)[number];
+type BlockTextAlign = (typeof BLOCK_TEXT_ALIGNS)[number];
+type BlockRatio = (typeof BLOCK_RATIOS)[number];
+type BlockFit = (typeof BLOCK_FITS)[number];
+/** Flex row/column container. */
+type StackBlock = {
+    type: 'stack';
+    direction: 'row' | 'column';
+    children: BlockNode[];
+    gap?: BlockGap;
+    align?: BlockAlign;
+    justify?: BlockJustify;
+    wrap?: boolean;
+};
+/** 2–4 equal-column grid container. */
+type GridBlock = {
+    type: 'grid';
+    columns: (typeof BLOCK_GRID_COLUMNS)[number];
+    children: BlockNode[];
+    gap?: BlockGap;
+    align?: BlockAlign;
+};
+/** Paragraph / label. */
+type TextBlock = {
+    type: 'text';
+    value: string;
+    size?: BlockSize;
+    weight?: BlockWeight;
+    tone?: BlockTone;
+    align?: BlockTextAlign;
+};
+/** h2–h4 — never h1 (the page owns its h1). */
+type HeadingBlock = {
+    type: 'heading';
+    value: string;
+    level: (typeof BLOCK_HEADING_LEVELS)[number];
+    size?: BlockSize;
+    align?: BlockTextAlign;
+};
+/** Link styled as a button. `tag` feeds agent legibility (agentDataByVariant). */
+type ButtonBlock = {
+    type: 'button';
+    label: string;
+    href: string;
+    emphasis?: BlockEmphasis;
+    size?: BlockSize;
+    tag?: string;
+};
+/** Inline text link. */
+type LinkBlock = {
+    type: 'link';
+    label: string;
+    href: string;
+    tag?: string;
+};
+/** Image. `alt` is required; empty only with an explicit `decorative: true`. */
+type ImageBlock = {
+    type: 'image';
+    src: string;
+    alt: string;
+    decorative?: boolean;
+    ratio?: BlockRatio;
+    fit?: BlockFit;
+};
+/** Eyebrow / pill. */
+type BadgeBlock = {
+    type: 'badge';
+    value: string;
+    tone?: BlockTone;
+};
+/** Vertical rhythm. */
+type SpacerBlock = {
+    type: 'spacer';
+    size: BlockSize;
+};
+type BlockNode = StackBlock | GridBlock | TextBlock | HeadingBlock | ButtonBlock | LinkBlock | ImageBlock | BadgeBlock | SpacerBlock;
+/** The derived site palette (spec §4 "Colour and type: derived, not chosen").
+ *  Sampled by the on-site editor from the live page's own buttons — computed
+ *  styles, so values are plain colors (rgb/hex), never var()/url() — validated
+ *  server-side, stored per project, and served with the decision so injected
+ *  blocks render in the merchant's own primary color and corner radius.
+ *  Absent → the renderer's neutral inherit-first defaults. */
+type SitePalette = {
+    primaryBg: string;
+    primaryText: string;
+    radius: string;
+};
+declare const MAX_BLOCK_NODES = 64;
+declare const MAX_BLOCK_DEPTH = 5;
+declare const MAX_BLOCK_CHILDREN = 12;
+declare const MAX_BLOCK_ARMS = 4;
+declare const MAX_BLOCK_TEXT_LEN = 500;
+
 /** Manages anonymous session identity with cookie + localStorage layers. */
 type SessionConfig = {
     cookieName?: string;
@@ -171,6 +300,11 @@ type SlotConfigEntry = {
     locator?: CompoundLocator;
     content?: string;
     ops?: SlotOps;
+    /** Composition Blocks per arm — ALL arms, not just the served one, because
+     *  Option-B rendering pre-paints every arm hidden and reveals the served one
+     *  (spec §6). Holdout sessions receive the baseline arm's tree only, so the
+     *  control group's DOM stays meaningful. Absent for non-composition slots. */
+    blocks?: Record<string, BlockNode>;
 };
 type DecisionSnapshot = {
     v: 1;
@@ -180,6 +314,10 @@ type DecisionSnapshot = {
     layoutOrder: string[] | null;
     savedAt: number;
     slotConfig?: Record<string, SlotConfigEntry>;
+    /** Derived site palette for Composition Block rendering — cached so the
+     *  pre-paint render already looks native (a palette that pops in post-decide
+     *  would be its own flash). */
+    palette?: SitePalette;
 };
 /** Returns null on missing, corrupt, or wrong-version data — never throws. */
 declare function readSnapshot(apiKey: string): DecisionSnapshot | null;
@@ -333,6 +471,7 @@ type DecideOutcome = {
     slotConfig?: Record<string, SlotConfigEntry>;
     goals?: GoalDefinition[];
     sectionMap?: SectionMapEntry[];
+    palette?: SitePalette;
 };
 type DecideInput = {
     sections?: string[];
@@ -455,4 +594,4 @@ declare function grantConsent(apiKey?: string): void;
  */
 declare function init(config: SentientConfig): SentientClient;
 
-export { type AssignResult as A, renderPrePaintScript as B, type ComponentGoalOptions as C, type DecideInput as D, type EventQueue as E, sanitizePageUrl as F, type GoalDefinition as G, writeSnapshot as H, LOCAL_MODE_BANNER as L, type MicroSignalEmitter as M, PROD_KEYLESS_ERROR as P, type QueueConfig as Q, SNAPSHOT_STORAGE_KEY_PREFIX as S, type WeightEntry as W, type Assignment as a, type AssignmentCache as b, type ComponentWeightEntry as c, type CompoundLocator as d, type DecideOutcome as e, type DecisionSnapshot as f, type EventType as g, type GoalOptions as h, type GraphClient as i, type GraphConfig as j, type GraphSnapshot as k, type MicroSignalType as l, type PageNode as m, type SectionMapEntry as n, type SentientClient as o, type SentientConfig as p, type SentientEvent as q, type SessionConfig as r, type SessionManager as s, type SlotConfigEntry as t, type SlotOps as u, attachMicroSignalDetectors as v, grantConsent as w, init as x, isDoNotTrackEnabled as y, readSnapshot as z };
+export { PROD_KEYLESS_ERROR as $, type AssignResult as A, BLOCK_ALIGNS as B, type ComponentGoalOptions as C, type ComponentWeightEntry as D, type CompoundLocator as E, type DecideInput as F, type DecideOutcome as G, type DecisionSnapshot as H, type EventQueue as I, type EventType as J, type GoalDefinition as K, type GoalOptions as L, type GraphClient as M, type GraphConfig as N, type GraphSnapshot as O, type GridBlock as P, type HeadingBlock as Q, type ImageBlock as R, LOCAL_MODE_BANNER as S, type LinkBlock as T, MAX_BLOCK_ARMS as U, MAX_BLOCK_CHILDREN as V, MAX_BLOCK_DEPTH as W, MAX_BLOCK_NODES as X, MAX_BLOCK_TEXT_LEN as Y, type MicroSignalEmitter as Z, type MicroSignalType as _, type Assignment as a, type PageNode as a0, type QueueConfig as a1, SNAPSHOT_STORAGE_KEY_PREFIX as a2, type SectionMapEntry as a3, type SentientClient as a4, type SentientConfig as a5, type SentientEvent as a6, type SessionConfig as a7, type SessionManager as a8, type SitePalette as a9, type SlotConfigEntry as aa, type SlotOps as ab, type SpacerBlock as ac, type StackBlock as ad, type TextBlock as ae, type WeightEntry as af, attachMicroSignalDetectors as ag, grantConsent as ah, init as ai, isDoNotTrackEnabled as aj, readSnapshot as ak, renderPrePaintScript as al, sanitizePageUrl as am, writeSnapshot as an, type AssignmentCache as b, BLOCK_EMPHASES as c, BLOCK_FITS as d, BLOCK_GAPS as e, BLOCK_GRID_COLUMNS as f, BLOCK_HEADING_LEVELS as g, BLOCK_JUSTIFIES as h, BLOCK_RATIOS as i, BLOCK_SIZES as j, BLOCK_TEXT_ALIGNS as k, BLOCK_TONES as l, BLOCK_WEIGHTS as m, type BadgeBlock as n, type BlockAlign as o, type BlockEmphasis as p, type BlockFit as q, type BlockGap as r, type BlockJustify as s, type BlockNode as t, type BlockRatio as u, type BlockSize as v, type BlockTextAlign as w, type BlockTone as x, type BlockWeight as y, type ButtonBlock as z };

package/dist/{index-og9t6fz3.d.ts → index-BvHshOSe.d.ts}

@@ -1,6 +1,135 @@
 import { b as SlotDeclInput } from './session-meta-BVvq5RBB.js';
 import { SlotResult } from '@sentientui/policy';
 
+/**
+ * Composition Blocks (spec: 2026-08-20-nocode-composition-variants-design.md §4).
+ *
+ * A bounded, TYPED component tree — never HTML — that a registry arm may carry
+ * (`published_config.arms[].blocks`). The vocabulary is the whitelist: every
+ * prop value is an enumerated token, validated server-side before publish
+ * (apps/api/src/domain/composition-blocks.ts) and rendered client-side through
+ * document.createElement + property assignment only. No innerHTML/outerHTML/
+ * insertAdjacentHTML exists anywhere on this path — the security property is
+ * preserved by never accepting HTML, not by sanitizing it, which is why there
+ * is no sanitizer to keep honest.
+ *
+ * Token lists live here (not in the API domain like SlotOps' mirrors) because
+ * three parties must agree byte-for-byte: the server validator, the snippet
+ * renderer, and eventually the React renderer (§11) — a drifted copy would let
+ * a published arm fail to render, which the fail-safe turns into an invisibly
+ * missing section, not an error.
+ */
+declare const BLOCK_GAPS: readonly ["none", "sm", "md", "lg"];
+declare const BLOCK_ALIGNS: readonly ["start", "center", "end", "stretch"];
+declare const BLOCK_JUSTIFIES: readonly ["start", "center", "end", "between"];
+declare const BLOCK_SIZES: readonly ["sm", "md", "lg"];
+declare const BLOCK_WEIGHTS: readonly ["normal", "medium", "bold"];
+declare const BLOCK_TONES: readonly ["default", "muted", "accent"];
+declare const BLOCK_EMPHASES: readonly ["primary", "secondary", "ghost"];
+declare const BLOCK_TEXT_ALIGNS: readonly ["left", "center", "right"];
+declare const BLOCK_RATIOS: readonly ["auto", "square", "landscape", "wide"];
+declare const BLOCK_FITS: readonly ["cover", "contain"];
+declare const BLOCK_GRID_COLUMNS: readonly [2, 3, 4];
+declare const BLOCK_HEADING_LEVELS: readonly [2, 3, 4];
+type BlockGap = (typeof BLOCK_GAPS)[number];
+type BlockAlign = (typeof BLOCK_ALIGNS)[number];
+type BlockJustify = (typeof BLOCK_JUSTIFIES)[number];
+type BlockSize = (typeof BLOCK_SIZES)[number];
+type BlockWeight = (typeof BLOCK_WEIGHTS)[number];
+type BlockTone = (typeof BLOCK_TONES)[number];
+type BlockEmphasis = (typeof BLOCK_EMPHASES)[number];
+type BlockTextAlign = (typeof BLOCK_TEXT_ALIGNS)[number];
+type BlockRatio = (typeof BLOCK_RATIOS)[number];
+type BlockFit = (typeof BLOCK_FITS)[number];
+/** Flex row/column container. */
+type StackBlock = {
+    type: 'stack';
+    direction: 'row' | 'column';
+    children: BlockNode[];
+    gap?: BlockGap;
+    align?: BlockAlign;
+    justify?: BlockJustify;
+    wrap?: boolean;
+};
+/** 2–4 equal-column grid container. */
+type GridBlock = {
+    type: 'grid';
+    columns: (typeof BLOCK_GRID_COLUMNS)[number];
+    children: BlockNode[];
+    gap?: BlockGap;
+    align?: BlockAlign;
+};
+/** Paragraph / label. */
+type TextBlock = {
+    type: 'text';
+    value: string;
+    size?: BlockSize;
+    weight?: BlockWeight;
+    tone?: BlockTone;
+    align?: BlockTextAlign;
+};
+/** h2–h4 — never h1 (the page owns its h1). */
+type HeadingBlock = {
+    type: 'heading';
+    value: string;
+    level: (typeof BLOCK_HEADING_LEVELS)[number];
+    size?: BlockSize;
+    align?: BlockTextAlign;
+};
+/** Link styled as a button. `tag` feeds agent legibility (agentDataByVariant). */
+type ButtonBlock = {
+    type: 'button';
+    label: string;
+    href: string;
+    emphasis?: BlockEmphasis;
+    size?: BlockSize;
+    tag?: string;
+};
+/** Inline text link. */
+type LinkBlock = {
+    type: 'link';
+    label: string;
+    href: string;
+    tag?: string;
+};
+/** Image. `alt` is required; empty only with an explicit `decorative: true`. */
+type ImageBlock = {
+    type: 'image';
+    src: string;
+    alt: string;
+    decorative?: boolean;
+    ratio?: BlockRatio;
+    fit?: BlockFit;
+};
+/** Eyebrow / pill. */
+type BadgeBlock = {
+    type: 'badge';
+    value: string;
+    tone?: BlockTone;
+};
+/** Vertical rhythm. */
+type SpacerBlock = {
+    type: 'spacer';
+    size: BlockSize;
+};
+type BlockNode = StackBlock | GridBlock | TextBlock | HeadingBlock | ButtonBlock | LinkBlock | ImageBlock | BadgeBlock | SpacerBlock;
+/** The derived site palette (spec §4 "Colour and type: derived, not chosen").
+ *  Sampled by the on-site editor from the live page's own buttons — computed
+ *  styles, so values are plain colors (rgb/hex), never var()/url() — validated
+ *  server-side, stored per project, and served with the decision so injected
+ *  blocks render in the merchant's own primary color and corner radius.
+ *  Absent → the renderer's neutral inherit-first defaults. */
+type SitePalette = {
+    primaryBg: string;
+    primaryText: string;
+    radius: string;
+};
+declare const MAX_BLOCK_NODES = 64;
+declare const MAX_BLOCK_DEPTH = 5;
+declare const MAX_BLOCK_CHILDREN = 12;
+declare const MAX_BLOCK_ARMS = 4;
+declare const MAX_BLOCK_TEXT_LEN = 500;
+
 /** Manages anonymous session identity with cookie + localStorage layers. */
 type SessionConfig = {
     cookieName?: string;
@@ -171,6 +300,11 @@ type SlotConfigEntry = {
     locator?: CompoundLocator;
     content?: string;
     ops?: SlotOps;
+    /** Composition Blocks per arm — ALL arms, not just the served one, because
+     *  Option-B rendering pre-paints every arm hidden and reveals the served one
+     *  (spec §6). Holdout sessions receive the baseline arm's tree only, so the
+     *  control group's DOM stays meaningful. Absent for non-composition slots. */
+    blocks?: Record<string, BlockNode>;
 };
 type DecisionSnapshot = {
     v: 1;
@@ -180,6 +314,10 @@ type DecisionSnapshot = {
     layoutOrder: string[] | null;
     savedAt: number;
     slotConfig?: Record<string, SlotConfigEntry>;
+    /** Derived site palette for Composition Block rendering — cached so the
+     *  pre-paint render already looks native (a palette that pops in post-decide
+     *  would be its own flash). */
+    palette?: SitePalette;
 };
 /** Returns null on missing, corrupt, or wrong-version data — never throws. */
 declare function readSnapshot(apiKey: string): DecisionSnapshot | null;
@@ -333,6 +471,7 @@ type DecideOutcome = {
     slotConfig?: Record<string, SlotConfigEntry>;
     goals?: GoalDefinition[];
     sectionMap?: SectionMapEntry[];
+    palette?: SitePalette;
 };
 type DecideInput = {
     sections?: string[];
@@ -455,4 +594,4 @@ declare function grantConsent(apiKey?: string): void;
  */
 declare function init(config: SentientConfig): SentientClient;
 
-export { type AssignResult as A, renderPrePaintScript as B, type ComponentGoalOptions as C, type DecideInput as D, type EventQueue as E, sanitizePageUrl as F, type GoalDefinition as G, writeSnapshot as H, LOCAL_MODE_BANNER as L, type MicroSignalEmitter as M, PROD_KEYLESS_ERROR as P, type QueueConfig as Q, SNAPSHOT_STORAGE_KEY_PREFIX as S, type WeightEntry as W, type Assignment as a, type AssignmentCache as b, type ComponentWeightEntry as c, type CompoundLocator as d, type DecideOutcome as e, type DecisionSnapshot as f, type EventType as g, type GoalOptions as h, type GraphClient as i, type GraphConfig as j, type GraphSnapshot as k, type MicroSignalType as l, type PageNode as m, type SectionMapEntry as n, type SentientClient as o, type SentientConfig as p, type SentientEvent as q, type SessionConfig as r, type SessionManager as s, type SlotConfigEntry as t, type SlotOps as u, attachMicroSignalDetectors as v, grantConsent as w, init as x, isDoNotTrackEnabled as y, readSnapshot as z };
+export { PROD_KEYLESS_ERROR as $, type AssignResult as A, BLOCK_ALIGNS as B, type ComponentGoalOptions as C, type ComponentWeightEntry as D, type CompoundLocator as E, type DecideInput as F, type DecideOutcome as G, type DecisionSnapshot as H, type EventQueue as I, type EventType as J, type GoalDefinition as K, type GoalOptions as L, type GraphClient as M, type GraphConfig as N, type GraphSnapshot as O, type GridBlock as P, type HeadingBlock as Q, type ImageBlock as R, LOCAL_MODE_BANNER as S, type LinkBlock as T, MAX_BLOCK_ARMS as U, MAX_BLOCK_CHILDREN as V, MAX_BLOCK_DEPTH as W, MAX_BLOCK_NODES as X, MAX_BLOCK_TEXT_LEN as Y, type MicroSignalEmitter as Z, type MicroSignalType as _, type Assignment as a, type PageNode as a0, type QueueConfig as a1, SNAPSHOT_STORAGE_KEY_PREFIX as a2, type SectionMapEntry as a3, type SentientClient as a4, type SentientConfig as a5, type SentientEvent as a6, type SessionConfig as a7, type SessionManager as a8, type SitePalette as a9, type SlotConfigEntry as aa, type SlotOps as ab, type SpacerBlock as ac, type StackBlock as ad, type TextBlock as ae, type WeightEntry as af, attachMicroSignalDetectors as ag, grantConsent as ah, init as ai, isDoNotTrackEnabled as aj, readSnapshot as ak, renderPrePaintScript as al, sanitizePageUrl as am, writeSnapshot as an, type AssignmentCache as b, BLOCK_EMPHASES as c, BLOCK_FITS as d, BLOCK_GAPS as e, BLOCK_GRID_COLUMNS as f, BLOCK_HEADING_LEVELS as g, BLOCK_JUSTIFIES as h, BLOCK_RATIOS as i, BLOCK_SIZES as j, BLOCK_TEXT_ALIGNS as k, BLOCK_TONES as l, BLOCK_WEIGHTS as m, type BadgeBlock as n, type BlockAlign as o, type BlockEmphasis as p, type BlockFit as q, type BlockGap as r, type BlockJustify as s, type BlockNode as t, type BlockRatio as u, type BlockSize as v, type BlockTextAlign as w, type BlockTone as x, type BlockWeight as y, type ButtonBlock as z };