@kywi-software/core 0.1.0

package/dist/layout/renderer.js

@@ -0,0 +1,121 @@
+'use client';
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { createContext, useContext } from 'react';
+import { isLayoutSection } from './types.js';
+import { BUILT_IN_MODULE_COMPONENTS } from './modules.js';
+import { resolveSectionStyle } from './theme-css.js';
+const PersonalizationContext = createContext(null);
+const ComponentResolverContext = createContext(null);
+// ── Layout Context ──────────────────────────────────────────────────────────
+const LayoutContext = createContext(null);
+export function KywiLayout({ layout, children, componentResolver, personalization }) {
+    let inner = _jsx(LayoutContext.Provider, { value: layout, children: children });
+    if (personalization) {
+        inner = _jsx(PersonalizationContext.Provider, { value: personalization, children: inner });
+    }
+    if (componentResolver) {
+        return (_jsx(ComponentResolverContext.Provider, { value: componentResolver, children: inner }));
+    }
+    return _jsx(_Fragment, { children: inner });
+}
+export function KywiRegion({ name, fallback }) {
+    const layout = useContext(LayoutContext);
+    const sections = layout?.regions[name];
+    if (!sections || sections.length === 0) {
+        return _jsx("div", { className: `kywi-region kywi-region-${name}`, "data-kywi-region": name, children: fallback });
+    }
+    return (_jsx("div", { className: `kywi-region kywi-region-${name}`, "data-kywi-region": name, children: sections.map(node => isLayoutSection(node)
+            ? _jsx(SectionRenderer, { section: node }, node.id)
+            : _jsx(VariantContainerRenderer, { container: node }, node.id)) }));
+}
+// ── Variant Container (audience + A/B experiment) ────────────────────────────
+/**
+ * Choose which VariantEntry a container renders for the current visitor.
+ * Precedence: a matched audience variant always wins (coexistence with A/B);
+ * otherwise, in A/B mode, a locked winner or the visitor's experiment
+ * assignment selects the arm. Returns null to render the Default sections.
+ */
+function selectVariantEntry(container, state) {
+    // Audience precedence — a personalized variant beats the A/B split.
+    if (state?.resolvedAudienceId) {
+        const byAudience = container.variants.find(v => v.audienceId === state.resolvedAudienceId);
+        if (byAudience)
+            return byAudience;
+    }
+    if (container.mode === 'ab_test') {
+        // A completed experiment routes all traffic to its winner.
+        if (container.winnerId) {
+            return container.variants.find(v => v.audienceId === container.winnerId) ?? null;
+        }
+        // Otherwise use the server-resolved experiment assignment for this visitor.
+        if (container.experimentId && state) {
+            const key = state.experimentAssignments[container.experimentId];
+            if (key)
+                return container.variants.find(v => v.audienceId === key) ?? null;
+        }
+    }
+    return null;
+}
+function VariantContainerRenderer({ container }) {
+    const state = useContext(PersonalizationContext);
+    const selected = selectVariantEntry(container, state);
+    const sections = selected ? selected.sections : container.defaultSections;
+    const variantKey = selected ? selected.audienceId : 'default';
+    return (_jsx("div", { className: "kywi-variant-container", "data-variant-container-id": container.id, "data-variant": variantKey, ...(container.experimentId ? { 'data-experiment': container.experimentId } : {}), children: sections.map(section => _jsx(SectionRenderer, { section: section }, section.id)) }));
+}
+function SectionRenderer({ section }) {
+    // Resolve the section's style map: base token references become inline
+    // var(--kywi-*) declarations; `key@breakpoint` and `hidden@breakpoint` keys
+    // become a scoped responsive stylesheet targeting this section by id.
+    const selector = `[data-section-id="${section.id}"]`;
+    const { base, responsiveCss } = resolveSectionStyle(section.style, selector);
+    return (_jsxs("div", { className: "kywi-section", "data-kywi-section": "", "data-section-id": section.id, style: Object.keys(base).length > 0 ? base : undefined, children: [responsiveCss && _jsx("style", { dangerouslySetInnerHTML: { __html: responsiveCss } }), _jsx("div", { className: "kywi-section-columns", children: section.columns.map(col => _jsx(ColumnRenderer, { column: col }, col.id)) })] }));
+}
+function ColumnRenderer({ column }) {
+    return (_jsx("div", { className: `kywi-column kywi-col-${column.width}`, "data-kywi-column": "", "data-kywi-col-width": column.width, "data-column-id": column.id, children: column.nodes.map(node => _jsx(ModuleRenderer, { node: node }, node.id)) }));
+}
+/**
+ * The documented semantic hooks a module wrapper carries so a front-end
+ * developer can target it by attribute/BEM class without reading markup:
+ * `data-kywi-module="{type}"`, class `kywi-module--{type}`, plus per-type
+ * refinements (`data-level` for headings, `data-variant` for buttons/badges).
+ */
+function moduleSemanticAttrs(type, props) {
+    const attrs = { 'data-kywi-module': type };
+    if (type === 'heading') {
+        const raw = String(props['level'] ?? '2');
+        const level = raw.replace(/^h/i, '');
+        if (level)
+            attrs['data-level'] = level;
+    }
+    if ((type === 'button' || type === 'badge') && props['variant'] != null) {
+        attrs['data-variant'] = String(props['variant']);
+    }
+    return attrs;
+}
+function ModuleRenderer({ node }) {
+    const resolver = useContext(ComponentResolverContext);
+    // If this node references a component, resolve its props at render time
+    if (node.componentId && resolver) {
+        const resolved = resolver(node.componentId);
+        if (resolved) {
+            const mergedProps = { ...resolved.props, ...node.props };
+            const mergedStyle = { ...resolved.style, ...node.style };
+            const Component = BUILT_IN_MODULE_COMPONENTS[resolved.moduleType];
+            if (!Component) {
+                return _jsxs("div", { className: "kywi-module kywi-module-unknown", "data-module-type": resolved.moduleType, children: ["Unknown module: ", resolved.moduleType] });
+            }
+            return (_jsx("div", { className: `kywi-module-wrapper kywi-module--${resolved.moduleType}`, "data-instance-id": node.instanceId, "data-component-id": node.componentId, ...moduleSemanticAttrs(resolved.moduleType, mergedProps), children: _jsx(Component, { props: mergedProps, style: mergedStyle }) }));
+        }
+        // Component not found — fall through to render with node's own props
+    }
+    const Component = BUILT_IN_MODULE_COMPONENTS[node.type];
+    if (!Component) {
+        return _jsxs("div", { className: "kywi-module kywi-module-unknown", "data-module-type": node.type, children: ["Unknown module: ", node.type] });
+    }
+    return (_jsx("div", { className: `kywi-module-wrapper kywi-module--${node.type}`, "data-instance-id": node.instanceId, ...moduleSemanticAttrs(node.type, node.props), children: _jsx(Component, { props: node.props, style: node.style }) }));
+}
+export function AudienceMetaTags({ audienceId, experimentId, variantId, visitorId }) {
+    return (_jsxs(_Fragment, { children: [audienceId && _jsx("meta", { name: "kywi:audience-id", content: audienceId }), experimentId && _jsx("meta", { name: "kywi:experiment-id", content: experimentId }), variantId && _jsx("meta", { name: "kywi:variant-id", content: variantId }), _jsx("meta", { name: "kywi:visitor-id", content: visitorId })] }));
+}
+//# sourceMappingURL=renderer.js.map

package/dist/layout/renderer.js.map

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

package/dist/layout/theme-css.d.ts

@@ -0,0 +1,52 @@
+import type { ThemeTokens } from '../config/types.js';
+/** Token category → the middle segment of its CSS custom-property name. */
+export declare const CATEGORY_VAR_PREFIX: Record<string, string>;
+/**
+ * Named responsive breakpoints → the media-query condition applied for that
+ * breakpoint. `mobile` is a max-width (small-screen only); the rest are
+ * min-width (that size and up). Numeric-ish aliases (sm/md/lg/xl) coexist with
+ * the semantic names (mobile/tablet/desktop) so token and section authors can
+ * use either vocabulary.
+ */
+export declare const KYWI_BREAKPOINTS: Record<string, string>;
+/** Split a `key@breakpoint` token/style key into its base and optional breakpoint. */
+export declare function splitBreakpointKey(key: string): {
+    base: string;
+    breakpoint?: string;
+};
+/** The `--kywi-*` custom-property name for a token category + key. */
+export declare function tokenVarName(category: string, key: string): string;
+/**
+ * Flatten a theme's tokens into a `{ '--kywi-…': value }` map, taking only the
+ * base (non-breakpoint) keys. Breakpoint overrides are emitted separately by
+ * `themeTokenStyleBlock`.
+ */
+export declare function tokensToKywiVars(tokens: ThemeTokens | undefined): Record<string, string>;
+/**
+ * Produce the full `:root` (or scoped) style block for a theme's tokens,
+ * including `@media` overrides for any `key@breakpoint` tokens. Returns '' when
+ * the theme defines no tokens.
+ */
+export declare function themeTokenStyleBlock(tokens: ThemeTokens | undefined, selector?: string): string;
+/**
+ * Resolve a single style value. A token reference of the form `category.key`
+ * (e.g. `spacing.lg`, `colors.primary`) becomes `var(--kywi-…)`; anything else —
+ * a raw value like `37px`, or a custom value — is returned unchanged. This keeps
+ * token references portable: the pixel value lives once in the theme.
+ */
+export declare function resolveStyleValue(value: string): string;
+export interface ResolvedSectionStyle {
+    /** Inline style object (camelCase props, token refs resolved to var()). */
+    base: Record<string, string>;
+    /** Scoped responsive CSS (`@media … { <selector> { … } }`), or '' if none. */
+    responsiveCss: string;
+}
+/**
+ * Resolve a section's `style` map into an inline base style plus a scoped
+ * responsive stylesheet. Breakpoint keys (`paddingTop@tablet`) become `@media`
+ * rules targeting `selector`; the special `hidden` key (base or `hidden@bp`)
+ * maps to `display: none` (truthy) / `display: revert` (falsy) for responsive
+ * visibility. Token references in any value are resolved to `var(--kywi-*)`.
+ */
+export declare function resolveSectionStyle(style: Record<string, string> | undefined, selector: string): ResolvedSectionStyle;
+//# sourceMappingURL=theme-css.d.ts.map

package/dist/layout/theme-css.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-css.d.ts","sourceRoot":"","sources":["../../src/layout/theme-css.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAErD,2EAA2E;AAC3E,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAMtD,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAQnD,CAAA;AAYD,sFAAsF;AACtF,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,CAIrF;AAED,sEAAsE;AACtE,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAGlE;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAWxF;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,WAAW,GAAG,SAAS,EAAE,QAAQ,SAAU,GAAG,MAAM,CAuBhG;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMvD;AAED,MAAM,WAAW,oBAAoB;IACnC,2EAA2E;IAC3E,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC5B,8EAA8E;IAC9E,aAAa,EAAE,MAAM,CAAA;CACtB;AAeD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,EACzC,QAAQ,EAAE,MAAM,GACf,oBAAoB,CAmDtB"}

package/dist/layout/theme-css.js

@@ -0,0 +1,181 @@
+// ─── Theme → CSS pipeline ────────────────────────────────────────────────────
+//
+// Turns a theme's design tokens into `--kywi-*` CSS custom properties and
+// resolves layout token references (e.g. `spacing.lg`) to `var(--kywi-*)` so a
+// front-end developer can style every element via the documented token vars and
+// semantic hooks. Pure string helpers — no React, safe in any (server) context.
+import { tokensToStyleBlock } from '../audiences/theme-customization.js';
+/** Token category → the middle segment of its CSS custom-property name. */
+export const CATEGORY_VAR_PREFIX = {
+    colors: 'color',
+    spacing: 'spacing',
+    typography: 'font',
+    borderRadius: 'border-radius',
+    shadow: 'shadow',
+};
+/**
+ * Named responsive breakpoints → the media-query condition applied for that
+ * breakpoint. `mobile` is a max-width (small-screen only); the rest are
+ * min-width (that size and up). Numeric-ish aliases (sm/md/lg/xl) coexist with
+ * the semantic names (mobile/tablet/desktop) so token and section authors can
+ * use either vocabulary.
+ */
+export const KYWI_BREAKPOINTS = {
+    mobile: '(max-width: 767px)',
+    tablet: '(min-width: 768px)',
+    desktop: '(min-width: 1280px)',
+    sm: '(min-width: 640px)',
+    md: '(min-width: 768px)',
+    lg: '(min-width: 1024px)',
+    xl: '(min-width: 1280px)',
+};
+const TOKEN_CATEGORIES = new Set(Object.keys(CATEGORY_VAR_PREFIX));
+/** camelCase / snake_case → kebab-case (e.g. `familySans` → `family-sans`). */
+function kebab(input) {
+    return input
+        .replace(/([a-z0-9])([A-Z])/g, '$1-$2')
+        .replace(/_/g, '-')
+        .toLowerCase();
+}
+/** Split a `key@breakpoint` token/style key into its base and optional breakpoint. */
+export function splitBreakpointKey(key) {
+    const at = key.indexOf('@');
+    if (at === -1)
+        return { base: key };
+    return { base: key.slice(0, at), breakpoint: key.slice(at + 1) };
+}
+/** The `--kywi-*` custom-property name for a token category + key. */
+export function tokenVarName(category, key) {
+    const prefix = CATEGORY_VAR_PREFIX[category] ?? kebab(category);
+    return `--kywi-${prefix}-${kebab(key)}`;
+}
+/**
+ * Flatten a theme's tokens into a `{ '--kywi-…': value }` map, taking only the
+ * base (non-breakpoint) keys. Breakpoint overrides are emitted separately by
+ * `themeTokenStyleBlock`.
+ */
+export function tokensToKywiVars(tokens) {
+    const out = {};
+    if (!tokens)
+        return out;
+    for (const [category, entries] of Object.entries(tokens)) {
+        if (!entries)
+            continue;
+        for (const [key, value] of Object.entries(entries)) {
+            if (splitBreakpointKey(key).breakpoint)
+                continue;
+            out[tokenVarName(category, key)] = value;
+        }
+    }
+    return out;
+}
+/**
+ * Produce the full `:root` (or scoped) style block for a theme's tokens,
+ * including `@media` overrides for any `key@breakpoint` tokens. Returns '' when
+ * the theme defines no tokens.
+ */
+export function themeTokenStyleBlock(tokens, selector = ':root') {
+    if (!tokens)
+        return '';
+    const blocks = [];
+    const base = tokensToKywiVars(tokens);
+    if (Object.keys(base).length > 0) {
+        blocks.push(tokensToStyleBlock(base, selector));
+    }
+    const byBreakpoint = {};
+    for (const [category, entries] of Object.entries(tokens)) {
+        if (!entries)
+            continue;
+        for (const [key, value] of Object.entries(entries)) {
+            const { base: baseKey, breakpoint } = splitBreakpointKey(key);
+            if (!breakpoint || !KYWI_BREAKPOINTS[breakpoint])
+                continue;
+            (byBreakpoint[breakpoint] ??= {})[tokenVarName(category, baseKey)] = value;
+        }
+    }
+    for (const [breakpoint, vars] of Object.entries(byBreakpoint)) {
+        blocks.push(`@media ${KYWI_BREAKPOINTS[breakpoint]} {\n${tokensToStyleBlock(vars, selector)}\n}`);
+    }
+    return blocks.join('\n');
+}
+/**
+ * Resolve a single style value. A token reference of the form `category.key`
+ * (e.g. `spacing.lg`, `colors.primary`) becomes `var(--kywi-…)`; anything else —
+ * a raw value like `37px`, or a custom value — is returned unchanged. This keeps
+ * token references portable: the pixel value lives once in the theme.
+ */
+export function resolveStyleValue(value) {
+    const match = /^([a-zA-Z]+)\.([a-zA-Z0-9-]+)$/.exec(value);
+    if (match && TOKEN_CATEGORIES.has(match[1])) {
+        return `var(${tokenVarName(match[1], match[2])})`;
+    }
+    return value;
+}
+function cssPropName(key) {
+    return kebab(key);
+}
+/**
+ * Neutralize characters that could break out of a `<style>` element. Section
+ * styles are CMS-authored, but a stray `<`/`>` in a value must never terminate
+ * the style block into arbitrary HTML. Legitimate CSS values never need `<`/`>`.
+ */
+function sanitizeCssText(css) {
+    return css.replace(/[<>]/g, '');
+}
+/**
+ * Resolve a section's `style` map into an inline base style plus a scoped
+ * responsive stylesheet. Breakpoint keys (`paddingTop@tablet`) become `@media`
+ * rules targeting `selector`; the special `hidden` key (base or `hidden@bp`)
+ * maps to `display: none` (truthy) / `display: revert` (falsy) for responsive
+ * visibility. Token references in any value are resolved to `var(--kywi-*)`.
+ */
+export function resolveSectionStyle(style, selector) {
+    const baseValues = {};
+    const byBreakpoint = {};
+    for (const [key, rawValue] of Object.entries(style ?? {})) {
+        const { base: prop, breakpoint } = splitBreakpointKey(key);
+        let cssKey = prop;
+        let value;
+        if (prop === 'hidden') {
+            cssKey = 'display';
+            value = rawValue === 'true' || rawValue === '1' ? 'none' : 'revert';
+        }
+        else {
+            value = resolveStyleValue(rawValue);
+        }
+        if (!breakpoint)
+            baseValues[cssKey] = value;
+        else if (KYWI_BREAKPOINTS[breakpoint])
+            (byBreakpoint[breakpoint] ??= {})[cssKey] = value;
+    }
+    // A property that also has `@breakpoint` overrides cannot keep its base value
+    // inline: inline styles outrank every `@media` stylesheet rule, so the
+    // overrides would never take effect. Emit such base values as a non-media
+    // rule in the scoped stylesheet (before the `@media` rules) so the cascade
+    // resolves correctly; properties with no breakpoint override stay inline.
+    const overriddenProps = new Set();
+    for (const props of Object.values(byBreakpoint)) {
+        for (const cssKey of Object.keys(props))
+            overriddenProps.add(cssKey);
+    }
+    const inlineBase = {};
+    const stylesheetBase = {};
+    for (const [cssKey, value] of Object.entries(baseValues)) {
+        if (overriddenProps.has(cssKey))
+            stylesheetBase[cssKey] = value;
+        else
+            inlineBase[cssKey] = value;
+    }
+    const declBlock = (props) => Object.entries(props)
+        .map(([p, v]) => `    ${cssPropName(p)}: ${v};`)
+        .join('\n');
+    const rules = [];
+    if (Object.keys(stylesheetBase).length > 0) {
+        rules.push(`${selector} {\n${declBlock(stylesheetBase)}\n}`);
+    }
+    for (const [breakpoint, props] of Object.entries(byBreakpoint)) {
+        rules.push(`@media ${KYWI_BREAKPOINTS[breakpoint]} {\n  ${selector} {\n${declBlock(props)}\n  }\n}`);
+    }
+    return { base: inlineBase, responsiveCss: sanitizeCssText(rules.join('\n')) };
+}
+//# sourceMappingURL=theme-css.js.map

package/dist/layout/theme-css.js.map

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

package/dist/layout/theme-registry.d.ts

@@ -0,0 +1,18 @@
+import type { ThemeConfig, RegionDefinition, ThemeTokens } from '../config/types.js';
+export interface ThemeRegistry {
+    register(theme: ThemeConfig): void;
+    resolveToken(tokenPath: string, themeName: string, breakpoint?: string): string;
+    getRegions(themeName: string): RegionDefinition[];
+    /**
+     * Whether custom (non-token) values are allowed for the theme. When
+     * `customAllowed` is per-category, returns true if *any* category allows it —
+     * kept for back-compat; prefer `isCustomAllowedFor` for governance decisions.
+     */
+    isCustomAllowed(themeName: string): boolean;
+    /** Whether custom values are allowed for a specific token category. */
+    isCustomAllowedFor(themeName: string, category: keyof ThemeTokens): boolean;
+    listThemes(): string[];
+    getTokenCategory(category: string, themeName: string): Record<string, string>;
+}
+export declare function createThemeRegistry(): ThemeRegistry;
+//# sourceMappingURL=theme-registry.d.ts.map

package/dist/layout/theme-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-registry.d.ts","sourceRoot":"","sources":["../../src/layout/theme-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAEpF,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAAA;IAClC,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAC/E,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAAA;IACjD;;;;OAIG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAA;IAC3C,uEAAuE;IACvE,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,WAAW,GAAG,OAAO,CAAA;IAC3E,UAAU,IAAI,MAAM,EAAE,CAAA;IACtB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC9E;AAED,wBAAgB,mBAAmB,IAAI,aAAa,CAoEnD"}

package/dist/layout/theme-registry.js

@@ -0,0 +1,70 @@
+export function createThemeRegistry() {
+    const themes = new Map();
+    function getTheme(name) {
+        const theme = themes.get(name);
+        if (!theme)
+            throw new Error(`Unknown theme "${name}"`);
+        return theme;
+    }
+    return {
+        register(theme) {
+            themes.set(theme.name, theme);
+        },
+        resolveToken(tokenPath, themeName, breakpoint) {
+            const theme = getTheme(themeName);
+            const [category, key] = tokenPath.split('.');
+            if (!category || !key) {
+                throw new Error(`Invalid token path "${tokenPath}" — expected "category.key"`);
+            }
+            const tokens = theme.tokens;
+            if (!tokens)
+                throw new Error(`Unknown token "${tokenPath}" in theme "${themeName}" — no tokens defined`);
+            const categoryTokens = tokens[category];
+            if (!categoryTokens)
+                throw new Error(`Unknown token "${tokenPath}" in theme "${themeName}" — category "${category}" not found`);
+            if (breakpoint) {
+                const bpKey = `${key}@${breakpoint}`;
+                const bpValue = categoryTokens[bpKey];
+                if (bpValue !== undefined)
+                    return bpValue;
+            }
+            const value = categoryTokens[key];
+            if (value === undefined)
+                throw new Error(`Unknown token "${tokenPath}" in theme "${themeName}"`);
+            return value;
+        },
+        getRegions(themeName) {
+            return getTheme(themeName).regions;
+        },
+        isCustomAllowed(themeName) {
+            const ca = getTheme(themeName).customAllowed;
+            if (ca === undefined)
+                return true;
+            if (typeof ca === 'boolean')
+                return ca;
+            // Per-category object: custom is "allowed" in the loose sense if any
+            // category permits it.
+            return Object.values(ca).some(Boolean);
+        },
+        isCustomAllowedFor(themeName, category) {
+            const ca = getTheme(themeName).customAllowed;
+            if (ca === undefined)
+                return true;
+            if (typeof ca === 'boolean')
+                return ca;
+            // Providing an object opts into governance: an unlisted category is
+            // governed (custom values disallowed) unless explicitly set true.
+            return ca[category] ?? false;
+        },
+        listThemes() {
+            return [...themes.keys()];
+        },
+        getTokenCategory(category, themeName) {
+            const theme = getTheme(themeName);
+            if (!theme.tokens)
+                return {};
+            return theme.tokens[category] ?? {};
+        },
+    };
+}
+//# sourceMappingURL=theme-registry.js.map

package/dist/layout/theme-registry.js.map

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

package/dist/layout/types.d.ts

@@ -0,0 +1,70 @@
+export interface ModuleNode {
+    id: string;
+    type: string;
+    instanceId: string;
+    props: Record<string, unknown>;
+    style: Record<string, string>;
+    componentId?: string;
+}
+export interface LayoutColumn {
+    id: string;
+    width: number;
+    nodes: ModuleNode[];
+}
+export interface LayoutSection {
+    id: string;
+    type: 'section';
+    style: Record<string, string>;
+    columns: LayoutColumn[];
+}
+export interface VariantEntry {
+    id: string;
+    audienceId: string;
+    label: string;
+    weight: number;
+    sections: LayoutSection[];
+}
+export interface VariantContainer {
+    id: string;
+    type: 'variantContainer';
+    mode: 'personalization' | 'ab_test';
+    experimentId?: string;
+    winnerId?: string;
+    defaultSections: LayoutSection[];
+    variants: VariantEntry[];
+}
+export type RegionNode = LayoutSection | VariantContainer;
+/** Narrow a RegionNode to a LayoutSection (as opposed to a VariantContainer). */
+export declare function isLayoutSection(node: RegionNode): node is LayoutSection;
+export interface PageVariant {
+    id: string;
+    audienceId: string;
+    regions: Record<string, RegionNode[]>;
+}
+export interface AbExperiment {
+    id: string;
+    name: string;
+    variants: Array<{
+        id: string;
+        weight: number;
+        regions: Record<string, RegionNode[]>;
+    }>;
+}
+export interface LayoutDocument {
+    regions: Record<string, RegionNode[]>;
+    pageVariants?: PageVariant[];
+    abExperiments?: AbExperiment[];
+}
+export type LayoutValidationResult = {
+    success: true;
+    data: LayoutDocument;
+} | {
+    success: false;
+    error: string;
+};
+/**
+ * Parse and validate a layout document.
+ * Checks that within every section, columns sum to exactly 12.
+ */
+export declare function validateLayoutDocument(input: unknown): LayoutValidationResult;
+//# sourceMappingURL=types.d.ts.map

package/dist/layout/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/layout/types.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC9B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,UAAU,EAAE,CAAA;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,SAAS,CAAA;IACf,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC7B,OAAO,EAAE,YAAY,EAAE,CAAA;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAA;IACV,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,aAAa,EAAE,CAAA;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,kBAAkB,CAAA;IACxB,IAAI,EAAE,iBAAiB,GAAG,SAAS,CAAA;IACnC,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,eAAe,EAAE,aAAa,EAAE,CAAA;IAChC,QAAQ,EAAE,YAAY,EAAE,CAAA;CACzB;AAED,MAAM,MAAM,UAAU,GAAG,aAAa,GAAG,gBAAgB,CAAA;AAEzD,iFAAiF;AACjF,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,IAAI,aAAa,CAEvE;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAA;IACV,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,CAAA;CACtC;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,KAAK,CAAC;QACd,EAAE,EAAE,MAAM,CAAA;QACV,MAAM,EAAE,MAAM,CAAA;QACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,CAAA;KACtC,CAAC,CAAA;CACH;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,CAAA;IACrC,YAAY,CAAC,EAAE,WAAW,EAAE,CAAA;IAC5B,aAAa,CAAC,EAAE,YAAY,EAAE,CAAA;CAC/B;AA8FD,MAAM,MAAM,sBAAsB,GAC9B;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,cAAc,CAAA;CAAE,GACvC;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAyDrC;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,sBAAsB,CAoC7E"}