@kywi-software/core 0.14.0 → 0.15.0

package/dist/layout/legacy-variant-container.d.ts

@@ -0,0 +1,123 @@
+/**
+ * legacy-variant-container.ts — the pure conversion behind
+ * `kywi upgrade:variant-containers` (kywi-cms#172).
+ *
+ * The deprecated `variantContainer` MODULE (`registry.ts`, `deprecated: true`)
+ * ships every arm's HTML to the browser and swaps them client-side with
+ * `patchVariantContainers` from `@kywi-software/js`. Its successor, the
+ * `ModuleVariantContainer` COLUMN NODE (`types.ts`), resolves server-side and
+ * edits in place. This module turns the first into the second.
+ *
+ * It is pure and lives in core rather than in the CLI for two reasons: it is the
+ * only part of the migration worth unit-testing exhaustively, and the same
+ * conversion has to run over two different stores — `kywi_content.layout` and
+ * the blueprint `kywi_section_templates.definition` — which are both plain
+ * `LayoutDocument`s. The CLI is only the driver.
+ *
+ * NOTHING here touches the database, the filesystem, or the clock.
+ */
+import { type LayoutDocument, type ModuleNode, type ModuleVariantContainer } from './types.js';
+/** The deprecated registry name. Not a `ModuleVariantContainer`'s `type`. */
+export declare const LEGACY_VARIANT_CONTAINER_TYPE = "variantContainer";
+/** The module type a migrated HTML arm becomes (owner decision D1(a)). */
+export declare const LEGACY_ARM_MODULE_TYPE = "richText";
+/** Where in a document a legacy placement sits. */
+export type LegacyPlacementScope = 'regions' | 'pageVariant' | 'abExperiment';
+/**
+ * One legacy `variantContainer` module found in a document, with everything the
+ * CLI report prints about it — and, when it cannot be migrated, why.
+ */
+export interface LegacyVariantContainerPlacement {
+    moduleId: string;
+    instanceId: string;
+    scope: LegacyPlacementScope;
+    /** The page-variant / experiment-variant id, or null for the main regions. */
+    scopeId: string | null;
+    region: string;
+    sectionId: string;
+    columnId: string;
+    /** Position within `column.nodes` — the slot the container replaces 1:1. */
+    index: number;
+    mode: 'personalization' | 'ab_test';
+    armCount: number;
+    /** Arms whose `audienceId` is empty: real content bound to no audience. */
+    unboundArms: number;
+    /** Default arm + every arm's HTML, in bytes. */
+    htmlBytes: number;
+    /** Non-null when the placement was reported but deliberately left alone. */
+    refusal: string | null;
+}
+export interface LegacyMigrationOptions {
+    /** Id minter; injected so tests can assert exact ids. */
+    newId?: () => string;
+    /**
+     * Restrict the migration to these legacy module ids — the CLI's `--node`,
+     * which exists because the issue asks for per-placement, owner-invoked
+     * migration. Placements outside the selection are neither converted nor
+     * reported. Omit to take every placement in the document.
+     */
+    moduleIds?: readonly string[];
+}
+export interface LegacyMigrationResult {
+    /** The migrated document. Structurally shared with the input where nothing changed. */
+    document: LayoutDocument;
+    /** Every placement considered, converted or refused, in document order. */
+    placements: LegacyVariantContainerPlacement[];
+    converted: number;
+    /** False when `document` is the input unchanged — nothing to write. */
+    changed: boolean;
+}
+/**
+ * One legacy `variantContainer` module → one `ModuleVariantContainer`.
+ *
+ * The container takes a FRESH id: it is a different node kind, and reusing the
+ * module's id would collide with the Default arm, which keeps it. The Default
+ * arm inherits the legacy module's `id`, `instanceId` and `style` — that arm is
+ * the one that rendered by default, so `data-instance-id`, any pinned selector
+ * and any hand-written style targeting the block all survive one level.
+ *
+ * `props.skeleton` is dropped: the target resolves server-side, so there is no
+ * client swap left to hide behind a placeholder.
+ *
+ * Callers should refuse a node carrying a `componentId` before reaching here —
+ * see {@link migrateLegacyVariantContainers}.
+ */
+export declare function convertLegacyVariantContainer(node: ModuleNode, options?: {
+    newId?: () => string;
+}): ModuleVariantContainer;
+/**
+ * Convert every legacy `variantContainer` module in a document.
+ *
+ * Pure: the input is never mutated, and the returned document shares every
+ * untouched branch with it, so `result.document === input` (by identity of its
+ * parts) wherever nothing changed. `changed` says whether there is anything to
+ * write at all.
+ *
+ * IDEMPOTENT BY CONSTRUCTION: the output holds no node satisfying
+ * `isModuleNode(n) && n.type === 'variantContainer'`, so a second run finds
+ * nothing. Re-running after a changeset publishes re-introduces the shape is the
+ * documented remedy, and it costs nothing when there is nothing to do.
+ *
+ * The three region maps walked — `regions`, `pageVariants[].regions` and
+ * `abExperiments[].variants[].regions` — are exactly the three
+ * `collectComponentInstances` walks, for the same reason: content stored in any
+ * of them is content that can render.
+ */
+export declare function migrateLegacyVariantContainers(document: LayoutDocument | null | undefined, options?: LegacyMigrationOptions): LegacyMigrationResult;
+/**
+ * Every legacy `variantContainer` module a document holds, with the refusal
+ * reason for any that cannot be migrated.
+ *
+ * A projection of {@link migrateLegacyVariantContainers} rather than a second
+ * walk, so "what would be migrated" and "what is migrated" can never drift.
+ */
+export declare function findLegacyVariantContainers(document: LayoutDocument | null | undefined): LegacyVariantContainerPlacement[];
+/**
+ * Does this document hold a legacy placement at all?
+ *
+ * The cheap structural confirm behind the CLI's `layout::text like
+ * '%"variantContainer"%'` candidate query, which over-selects: the same string
+ * is the section-level `VariantContainer`'s `type`.
+ */
+export declare function hasLegacyVariantContainer(document: LayoutDocument | null | undefined): boolean;
+//# sourceMappingURL=legacy-variant-container.d.ts.map

package/dist/layout/legacy-variant-container.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy-variant-container.d.ts","sourceRoot":"","sources":["../../src/layout/legacy-variant-container.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAIL,KAAK,cAAc,EAEnB,KAAK,UAAU,EACf,KAAK,sBAAsB,EAG5B,MAAM,YAAY,CAAA;AAOnB,6EAA6E;AAC7E,eAAO,MAAM,6BAA6B,qBAAqB,CAAA;AAE/D,0EAA0E;AAC1E,eAAO,MAAM,sBAAsB,aAAa,CAAA;AAEhD,mDAAmD;AACnD,MAAM,MAAM,oBAAoB,GAAG,SAAS,GAAG,aAAa,GAAG,cAAc,CAAA;AAE7E;;;GAGG;AACH,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,oBAAoB,CAAA;IAC3B,8EAA8E;IAC9E,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,4EAA4E;IAC5E,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,iBAAiB,GAAG,SAAS,CAAA;IACnC,QAAQ,EAAE,MAAM,CAAA;IAChB,2EAA2E;IAC3E,WAAW,EAAE,MAAM,CAAA;IACnB,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAA;IACjB,4EAA4E;IAC5E,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CACvB;AAED,MAAM,WAAW,sBAAsB;IACrC,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,MAAM,CAAA;IACpB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAC9B;AAED,MAAM,WAAW,qBAAqB;IACpC,uFAAuF;IACvF,QAAQ,EAAE,cAAc,CAAA;IACxB,2EAA2E;IAC3E,UAAU,EAAE,+BAA+B,EAAE,CAAA;IAC7C,SAAS,EAAE,MAAM,CAAA;IACjB,uEAAuE;IACvE,OAAO,EAAE,OAAO,CAAA;CACjB;AAiHD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,UAAU,EAChB,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,MAAM,CAAA;CAAO,GACrC,sBAAsB,CA+BxB;AAuKD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,cAAc,GAAG,IAAI,GAAG,SAAS,EAC3C,OAAO,GAAE,sBAA2B,GACnC,qBAAqB,CAsEvB;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,cAAc,GAAG,IAAI,GAAG,SAAS,GAC1C,+BAA+B,EAAE,CAEnC;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,cAAc,GAAG,IAAI,GAAG,SAAS,GAC1C,OAAO,CAET"}

package/dist/layout/legacy-variant-container.js

@@ -0,0 +1,397 @@
+/**
+ * legacy-variant-container.ts — the pure conversion behind
+ * `kywi upgrade:variant-containers` (kywi-cms#172).
+ *
+ * The deprecated `variantContainer` MODULE (`registry.ts`, `deprecated: true`)
+ * ships every arm's HTML to the browser and swaps them client-side with
+ * `patchVariantContainers` from `@kywi-software/js`. Its successor, the
+ * `ModuleVariantContainer` COLUMN NODE (`types.ts`), resolves server-side and
+ * edits in place. This module turns the first into the second.
+ *
+ * It is pure and lives in core rather than in the CLI for two reasons: it is the
+ * only part of the migration worth unit-testing exhaustively, and the same
+ * conversion has to run over two different stores — `kywi_content.layout` and
+ * the blueprint `kywi_section_templates.definition` — which are both plain
+ * `LayoutDocument`s. The CLI is only the driver.
+ *
+ * NOTHING here touches the database, the filesystem, or the clock.
+ */
+import { isModuleNode, } from './types.js';
+// The editor's id minter, imported rather than re-declared so a migrated node
+// is keyed exactly as an author-created one. `generate-id.ts` is deliberately
+// dependency-free (see its header), so reaching it from here pulls nothing
+// client-only into the layout graph.
+import { generateId } from '../admin/layout-editor/generate-id.js';
+/** The deprecated registry name. Not a `ModuleVariantContainer`'s `type`. */
+export const LEGACY_VARIANT_CONTAINER_TYPE = 'variantContainer';
+/** The module type a migrated HTML arm becomes (owner decision D1(a)). */
+export const LEGACY_ARM_MODULE_TYPE = 'richText';
+// ── Refusals ─────────────────────────────────────────────────────────────────
+//
+// A refused placement is REPORTED and left exactly as it is. Both refusals below
+// exist because converting would be worse than not converting.
+/**
+ * `validateLayoutDocument` rejects a `moduleVariantContainer` inside a
+ * SECTION-level `VariantContainer` arm outright — containers never nest. So a
+ * conversion there does not produce a slightly-worse document, it produces one
+ * that fails validation, which skips (and so blocks) the whole page. Refusing
+ * the one placement keeps the rest of the document migratable.
+ */
+const REFUSAL_NESTED = 'sits inside a section-level variantContainer arm — module containers never nest; ' +
+    'move it out of the personalized band first';
+/**
+ * A module carrying a `componentId` takes its props FROM the component
+ * definition, not from the node (`ModuleNode.componentId`). Converting from the
+ * node's own props would therefore silently produce a container with no arms,
+ * and dropping the link would detach an instance the author never asked to
+ * detach. Migrating the definition is a separate job.
+ */
+const REFUSAL_LINKED = 'is linked to a saved component — its arms live in the component definition; ' +
+    'detach the instance first';
+/**
+ * `variants` as stored: an array, or a JSON string of one.
+ *
+ * Both spellings are real — `parseVariants` in `variant-container-config.tsx`
+ * accepts either, so both reached the database. A malformed string is no arms,
+ * never a throw: this runs over stored data that no schema ever guarded, and a
+ * parse error must not take a whole migration run down.
+ */
+function readArms(raw) {
+    let list = [];
+    if (Array.isArray(raw))
+        list = raw;
+    else if (typeof raw === 'string' && raw.trim()) {
+        try {
+            const parsed = JSON.parse(raw);
+            if (Array.isArray(parsed))
+                list = parsed;
+        }
+        catch {
+            list = [];
+        }
+    }
+    return list.map((entry) => {
+        const arm = (entry ?? {});
+        // The legacy weight is a PERCENT (0-100, "Weight %" in the props rail); the
+        // target's is a fraction of 1, the same units the section-level container
+        // and `validateArmWeights` use. Anything non-numeric is not a weight at all,
+        // so the field is omitted rather than coerced to a misleading 0.
+        const rawWeight = arm.weight;
+        const numeric = typeof rawWeight === 'number' ? rawWeight : Number(rawWeight);
+        return {
+            audienceId: String(arm.audienceId ?? ''),
+            label: String(arm.label ?? ''),
+            content: String(arm.content ?? ''),
+            weight: rawWeight === undefined || rawWeight === null || rawWeight === '' || !Number.isFinite(numeric)
+                ? undefined
+                : numeric / 100,
+        };
+    });
+}
+function readMode(raw) {
+    // Mirrors the renderer's own coercion: anything that is not exactly 'ab_test'
+    // rendered as personalization, so anything else migrates as personalization.
+    return raw === 'ab_test' ? 'ab_test' : 'personalization';
+}
+function byteLength(text) {
+    return new TextEncoder().encode(text).length;
+}
+// ── Conversion ───────────────────────────────────────────────────────────────
+/**
+ * An HTML arm as a module.
+ *
+ * `richText` and not `html` (owner decision D1(a)): both run the same
+ * `sanitizeHtml` over their input, so the markup inside the arm is unchanged,
+ * but `richText` is not in `ADMIN_ONLY_MODULE_TYPES` — so the migration
+ * introduces nothing privileged and needs no role — and the arm stays
+ * inline-editable afterwards, which is most of the point of migrating.
+ */
+function armModule(html, newId, identity) {
+    return {
+        id: identity?.id ?? newId(),
+        type: LEGACY_ARM_MODULE_TYPE,
+        instanceId: identity?.instanceId ?? newId(),
+        props: { content: html },
+        style: { ...(identity?.style ?? {}) },
+    };
+}
+/**
+ * One legacy `variantContainer` module → one `ModuleVariantContainer`.
+ *
+ * The container takes a FRESH id: it is a different node kind, and reusing the
+ * module's id would collide with the Default arm, which keeps it. The Default
+ * arm inherits the legacy module's `id`, `instanceId` and `style` — that arm is
+ * the one that rendered by default, so `data-instance-id`, any pinned selector
+ * and any hand-written style targeting the block all survive one level.
+ *
+ * `props.skeleton` is dropped: the target resolves server-side, so there is no
+ * client swap left to hide behind a placeholder.
+ *
+ * Callers should refuse a node carrying a `componentId` before reaching here —
+ * see {@link migrateLegacyVariantContainers}.
+ */
+export function convertLegacyVariantContainer(node, options = {}) {
+    const newId = options.newId ?? generateId;
+    const props = node.props ?? {};
+    const mode = readMode(props.mode);
+    const variants = readArms(props.variants).map((arm) => ({
+        id: newId(),
+        label: arm.label,
+        // Kept even when empty. `''` is the single legal spelling of an unbound
+        // draft arm (`ModuleVariantEntry`); the legacy renderer filtered these out,
+        // so surfacing them is strictly additive — the content was always there,
+        // it just had nowhere to show.
+        audienceId: arm.audienceId,
+        ...(arm.weight === undefined ? {} : { weight: arm.weight }),
+        module: armModule(arm.content, newId),
+    }));
+    return {
+        id: newId(),
+        type: 'moduleVariantContainer',
+        mode,
+        // Never inherited — the legacy module has no experiment binding at all, and
+        // `validateModuleVariantContainerNode` requires one in ab_test mode.
+        ...(mode === 'ab_test' ? { experimentId: newId() } : {}),
+        defaultModule: armModule(String(props.defaultContent ?? ''), newId, {
+            id: node.id,
+            instanceId: node.instanceId,
+            style: node.style ?? {},
+        }),
+        variants,
+    };
+}
+// ── Walking ──────────────────────────────────────────────────────────────────
+/** Is this column node a legacy `variantContainer` MODULE? */
+function isLegacyNode(node) {
+    // Structural, via `isModuleNode`: the section-level `VariantContainer` shares
+    // the literal type string, and a bare `type ===` would catch it. A region node
+    // is never reached by a COLUMN walk, so this is belt and braces — but the two
+    // shapes having one name is exactly the trap worth guarding twice.
+    return isModuleNode(node) && node.type === LEGACY_VARIANT_CONTAINER_TYPE;
+}
+function describe(node, ctx, column, section, index, refusal) {
+    const props = node.props ?? {};
+    const arms = readArms(props.variants);
+    return {
+        moduleId: node.id,
+        instanceId: node.instanceId,
+        scope: ctx.scope,
+        scopeId: ctx.scopeId,
+        region: ctx.region,
+        sectionId: section.id,
+        columnId: column.id,
+        index,
+        mode: readMode(props.mode),
+        armCount: arms.length,
+        unboundArms: arms.filter((arm) => arm.audienceId === '').length,
+        htmlBytes: byteLength(String(props.defaultContent ?? '')) +
+            arms.reduce((sum, arm) => sum + byteLength(arm.content), 0),
+        refusal,
+    };
+}
+/** Returns the column unchanged when it holds nothing to migrate. */
+function walkColumn(column, section, ctx, walker) {
+    // `nodes` is guarded because this runs over STORED documents that never went
+    // through `validateLayoutDocument` — the same reason `columnModules` guards it.
+    const nodes = column.nodes ?? [];
+    let next = null;
+    for (let index = 0; index < nodes.length; index++) {
+        const node = nodes[index];
+        if (!isLegacyNode(node))
+            continue;
+        if (walker.selected && !walker.selected.has(node.id))
+            continue;
+        const refusal = ctx.nested
+            ? REFUSAL_NESTED
+            : node.componentId
+                ? REFUSAL_LINKED
+                : null;
+        walker.placements.push(describe(node, ctx, column, section, index, refusal));
+        if (refusal)
+            continue;
+        next ??= [...nodes];
+        next[index] = convertLegacyVariantContainer(node, { newId: walker.newId });
+        walker.converted++;
+    }
+    return next ? { ...column, nodes: next } : column;
+}
+function walkSection(section, ctx, walker) {
+    const columns = section.columns ?? [];
+    let next = null;
+    for (let i = 0; i < columns.length; i++) {
+        const column = columns[i];
+        const migrated = walkColumn(column, section, ctx, walker);
+        if (migrated === column)
+            continue;
+        next ??= [...columns];
+        next[i] = migrated;
+    }
+    return next ? { ...section, columns: next } : section;
+}
+function walkSections(sections, ctx, walker) {
+    let next = null;
+    for (let i = 0; i < sections.length; i++) {
+        const section = sections[i];
+        const migrated = walkSection(section, ctx, walker);
+        if (migrated === section)
+            continue;
+        next ??= [...sections];
+        next[i] = migrated;
+    }
+    return next ?? sections;
+}
+function walkRegionNode(node, ctx, walker) {
+    if (node.type === 'section')
+        return walkSection(node, ctx, walker);
+    if (node.type !== 'variantContainer')
+        return node;
+    // A section-level container. Its arm sections are walked so a legacy module
+    // hiding in one is still REPORTED — but with `nested`, so it is refused rather
+    // than converted into a document that can no longer be saved.
+    const nestedCtx = { ...ctx, nested: true };
+    const defaultSections = walkSections(node.defaultSections ?? [], nestedCtx, walker);
+    let variants = node.variants ?? [];
+    let variantsNext = null;
+    for (let i = 0; i < variants.length; i++) {
+        const variant = variants[i];
+        const sections = walkSections(variant.sections ?? [], nestedCtx, walker);
+        if (sections === variant.sections)
+            continue;
+        variantsNext ??= [...variants];
+        variantsNext[i] = { ...variant, sections };
+    }
+    variants = variantsNext ?? variants;
+    if (defaultSections === node.defaultSections && variants === node.variants)
+        return node;
+    return { ...node, defaultSections, variants };
+}
+function walkRegions(regions, scope, scopeId, walker) {
+    if (!regions)
+        return regions;
+    let next = null;
+    for (const [region, nodes] of Object.entries(regions)) {
+        const ctx = { scope, scopeId, region, nested: false };
+        const list = nodes ?? [];
+        let listNext = null;
+        for (let i = 0; i < list.length; i++) {
+            const node = list[i];
+            const migrated = walkRegionNode(node, ctx, walker);
+            if (migrated === node)
+                continue;
+            listNext ??= [...list];
+            listNext[i] = migrated;
+        }
+        if (!listNext)
+            continue;
+        next ??= { ...regions };
+        next[region] = listNext;
+    }
+    return next ?? regions;
+}
+/**
+ * Convert every legacy `variantContainer` module in a document.
+ *
+ * Pure: the input is never mutated, and the returned document shares every
+ * untouched branch with it, so `result.document === input` (by identity of its
+ * parts) wherever nothing changed. `changed` says whether there is anything to
+ * write at all.
+ *
+ * IDEMPOTENT BY CONSTRUCTION: the output holds no node satisfying
+ * `isModuleNode(n) && n.type === 'variantContainer'`, so a second run finds
+ * nothing. Re-running after a changeset publishes re-introduces the shape is the
+ * documented remedy, and it costs nothing when there is nothing to do.
+ *
+ * The three region maps walked — `regions`, `pageVariants[].regions` and
+ * `abExperiments[].variants[].regions` — are exactly the three
+ * `collectComponentInstances` walks, for the same reason: content stored in any
+ * of them is content that can render.
+ */
+export function migrateLegacyVariantContainers(document, options = {}) {
+    const empty = {
+        document: document ?? { regions: {} },
+        placements: [],
+        converted: 0,
+        changed: false,
+    };
+    if (!document || typeof document !== 'object')
+        return empty;
+    const walker = {
+        newId: options.newId ?? generateId,
+        selected: options.moduleIds ? new Set(options.moduleIds) : null,
+        placements: [],
+        converted: 0,
+    };
+    const regions = walkRegions(document.regions, 'regions', null, walker) ?? {};
+    let pageVariants = document.pageVariants;
+    if (pageVariants) {
+        let next = null;
+        for (let i = 0; i < pageVariants.length; i++) {
+            const variant = pageVariants[i];
+            const migrated = walkRegions(variant.regions, 'pageVariant', variant.id, walker);
+            if (migrated === variant.regions)
+                continue;
+            next ??= [...pageVariants];
+            next[i] = { ...variant, regions: migrated ?? {} };
+        }
+        pageVariants = next ?? pageVariants;
+    }
+    let abExperiments = document.abExperiments;
+    if (abExperiments) {
+        let next = null;
+        for (let i = 0; i < abExperiments.length; i++) {
+            const experiment = abExperiments[i];
+            const armVariants = experiment.variants ?? [];
+            let armsNext = null;
+            for (let j = 0; j < armVariants.length; j++) {
+                const arm = armVariants[j];
+                const migrated = walkRegions(arm.regions, 'abExperiment', arm.id, walker);
+                if (migrated === arm.regions)
+                    continue;
+                armsNext ??= [...armVariants];
+                armsNext[j] = { ...arm, regions: migrated ?? {} };
+            }
+            if (!armsNext)
+                continue;
+            next ??= [...abExperiments];
+            next[i] = { ...experiment, variants: armsNext };
+        }
+        abExperiments = next ?? abExperiments;
+    }
+    const changed = regions !== document.regions ||
+        pageVariants !== document.pageVariants ||
+        abExperiments !== document.abExperiments;
+    return {
+        document: changed
+            ? {
+                ...document,
+                regions,
+                ...(pageVariants ? { pageVariants } : {}),
+                ...(abExperiments ? { abExperiments } : {}),
+            }
+            : document,
+        placements: walker.placements,
+        converted: walker.converted,
+        changed,
+    };
+}
+/**
+ * Every legacy `variantContainer` module a document holds, with the refusal
+ * reason for any that cannot be migrated.
+ *
+ * A projection of {@link migrateLegacyVariantContainers} rather than a second
+ * walk, so "what would be migrated" and "what is migrated" can never drift.
+ */
+export function findLegacyVariantContainers(document) {
+    return migrateLegacyVariantContainers(document).placements;
+}
+/**
+ * Does this document hold a legacy placement at all?
+ *
+ * The cheap structural confirm behind the CLI's `layout::text like
+ * '%"variantContainer"%'` candidate query, which over-selects: the same string
+ * is the section-level `VariantContainer`'s `type`.
+ */
+export function hasLegacyVariantContainer(document) {
+    return findLegacyVariantContainers(document).length > 0;
+}
+//# sourceMappingURL=legacy-variant-container.js.map

package/dist/layout/legacy-variant-container.js.map

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

package/dist/layout/module-permissions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"module-permissions.d.ts","sourceRoot":"","sources":["../../src/layout/module-permissions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAyC,MAAM,YAAY,CAAA;AAIvF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,uBAAuB,EAAE,WAAW,CAAC,MAAM,CAAqB,CAAA;AAoF7E,6DAA6D;AAC7D,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;IACtC,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB;AAED,yEAAyE;AACzE,MAAM,MAAM,yBAAyB,GAAG,CACtC,WAAW,EAAE,MAAM,KAChB,2BAA2B,GAAG,IAAI,GAAG,SAAS,CAAA;AAKnD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,6BAA6B,CAC3C,SAAS,EAAE,2BAA2B,GAAG,IAAI,GAAG,SAAS,GACxD,cAAc,GAAG,IAAI,CA6CvB;AASD;;;;;;;;;;GAUG;AACH,wBAAgB,yCAAyC,CACvD,QAAQ,EAAE,2BAA2B,EACrC,MAAM,EAAE,2BAA2B,GAAG,IAAI,GAAG,SAAS,GACrD,MAAM,EAAE,CAIV;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,cAAc,GAAG,IAAI,GAAG,SAAS,EACzC,gBAAgB,CAAC,EAAE,yBAAyB,GAC3C,MAAM,EAAE,CAkBV"}
+{"version":3,"file":"module-permissions.d.ts","sourceRoot":"","sources":["../../src/layout/module-permissions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAyC,MAAM,YAAY,CAAA;AAIvF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,uBAAuB,EAAE,WAAW,CAAC,MAAM,CAAqB,CAAA;AAoF7E,6DAA6D;AAC7D,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;IACtC,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB;AAED,yEAAyE;AACzE,MAAM,MAAM,yBAAyB,GAAG,CACtC,WAAW,EAAE,MAAM,KAChB,2BAA2B,GAAG,IAAI,GAAG,SAAS,CAAA;AAKnD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,6BAA6B,CAC3C,SAAS,EAAE,2BAA2B,GAAG,IAAI,GAAG,SAAS,GACxD,cAAc,GAAG,IAAI,CAoEvB;AASD;;;;;;;;;;GAUG;AACH,wBAAgB,yCAAyC,CACvD,QAAQ,EAAE,2BAA2B,EACrC,MAAM,EAAE,2BAA2B,GAAG,IAAI,GAAG,SAAS,GACrD,MAAM,EAAE,CAIV;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,cAAc,GAAG,IAAI,GAAG,SAAS,EACzC,gBAAgB,CAAC,EAAE,yBAAyB,GAC3C,MAAM,EAAE,CAkBV"}

package/dist/layout/module-permissions.js

@@ -1,4 +1,4 @@
-import { columnModules, validateLayoutSection, validateVariantContainer } from './types.js';
+import { columnModules, validateLayoutSection, validateModuleVariantContainer, validateVariantContainer } from './types.js';
 import { diffComponentRefs } from './component-refs.js';
 /**
  * Module types that expose privileged capabilities (raw HTML injection) and must
@@ -145,6 +145,30 @@ export function componentDefinitionAsDocument(component) {
         const parsed = validateVariantContainer(definition);
         return parsed.success ? { regions: { [DEFINITION_REGION]: [parsed.data] } } : null;
     }
+    if (component.type === 'moduleVariantContainer') {
+        // The fourth kind (kywi-cms#170). A module container is a COLUMN node, so it
+        // becomes a one-section, one-column document — the shape it really lives in
+        // — and `iterModuleNodes` then reaches every arm's module through
+        // `columnModules`, exactly as it reaches a plain module beside one on a page.
+        // Without this branch a promoted `html` block inside a component definition
+        // would be invisible to the gate, which is precisely the laundering the gate
+        // exists to stop.
+        const parsed = validateModuleVariantContainer(definition);
+        if (!parsed.success)
+            return null;
+        return {
+            regions: {
+                [DEFINITION_REGION]: [
+                    {
+                        id: 'definition:section',
+                        type: 'section',
+                        style: {},
+                        columns: [{ id: 'definition:column', width: 12, nodes: [parsed.data] }],
+                    },
+                ],
+            },
+        };
+    }
     return null;
 }
 /** Every admin-only module type contained in a definition, ignoring identity. */

package/dist/layout/module-permissions.js.map

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

package/dist/layout/modules-extended.d.ts

@@ -66,7 +66,34 @@ export declare function NavigationModule({ props }: ModuleProps): React.JSX.Elem
 export declare function SearchModule({ props }: ModuleProps): import("react/jsx-runtime").JSX.Element;
 export declare function ComponentModule({ props }: ModuleProps): import("react/jsx-runtime").JSX.Element;
 export declare function FormModule({ props }: ModuleProps): import("react/jsx-runtime").JSX.Element;
-export declare function CookieConsentModule({ props }: ModuleProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * The consent banner. Its three buttons write the `kywi_consent` cookie through
+ * `setConsent()`, which is what every gated cookie write then reads
+ * (`audiences/consent.ts` owns the category map and the gate) — before
+ * kywi-cms#91 they were inert and the banner solicited a decision it discarded.
+ *
+ * Accept All / Reject All decide immediately. Customize reveals the per-category
+ * checkboxes (collapsed by default so the banner stays a one-line ask) and adds
+ * a Save Preferences button that records exactly what is ticked. `Essential` is
+ * checked and disabled throughout: necessary cookies are never gated, and the
+ * control says so rather than accepting a choice it would ignore.
+ *
+ * Rendering is decided AFTER mount, never during SSR: the server does not know
+ * this visitor's decision at render time, so the banner is always in the HTML
+ * and an effect resolves it. That keeps hydration deterministic and keeps the
+ * module cacheable.
+ *
+ * Which is why the markup ships HIDDEN, as `kywi-consent-pending`, and the
+ * effect unhides it only for a visitor with no decision on file. Rendering it
+ * visible and then removing it would flash a consent banner at every returning
+ * visitor on every page — soliciting a decision they already made, for the
+ * length of a paint. Better to reveal late than to ask twice.
+ *
+ * Inside the admin layout-editor canvas the banner always renders and its
+ * buttons record nothing — an editor placing the module must be able to see and
+ * arrange it, and clicking it there is not a visitor's consent.
+ */
+export declare function CookieConsentModule({ props }: ModuleProps): import("react/jsx-runtime").JSX.Element | null;
 /**
  * Module-level variantContainer. Renders every arm into the DOM — the Default
  * arm visible, audience arms hidden — each tagged with `data-kywi-variant`. The