@vectoriox/iox-ui 5.35.0 → 5.37.0

package/fesm2022/vectoriox-iox-ui-composite-core.mjs

@@ -1,5 +1,17 @@
 import { readOwnedTrait, writeOwnedTrait, elementStyleById, switchElementStyle, LinkType, setColorScheme, COLOR_SCHEME_TRAIT } from '@vectoriox/iox-ui/design-core';
 
+/** A recipe part: a NEW node (`create`) playing `role` under `label`, with the layout `base` styles its recipe
+ *  gives it — its LOOK is its element style. Shared by every recipe (Accordion, Disclosure). */
+function makeCompositePart(create, spec, role, label, base) {
+    const node = create(spec);
+    if (role)
+        node.role = role;
+    if (label)
+        node.label = label;
+    if (base)
+        writeStyles(node, base);
+    return node;
+}
 const usesTraits = (node) => Array.isArray(node.traits);
 /** A content trait's value — `traits[].default` on a builder node, `props[name]` on a saved one. */
 function readProp(node, name) {
@@ -105,6 +117,1182 @@ function removeFromComposite(root, node) {
     return true;
 }
 
+/**
+ * The open/close composites' kinds and roles (CC2 Accordion, CC2.1 Disclosure — composite plan T9 / T21). ONE
+ * family: a Disclosure is a one-item accordion whose ROOT is its item, so both run the same state machine, the
+ * same attribute planners and the same runtime (`accordion-runtime.ts`). Every consumer that treats "an item",
+ * "a header" or "a panel" alike asks these predicates, never a role literal.
+ */
+var CompositeKind;
+(function (CompositeKind) {
+    CompositeKind["Accordion"] = "accordion";
+    CompositeKind["Disclosure"] = "disclosure";
+})(CompositeKind || (CompositeKind = {}));
+var AccordionRole;
+(function (AccordionRole) {
+    AccordionRole["Accordion"] = "accordion";
+    AccordionRole["Item"] = "accordion.item";
+    AccordionRole["Trigger"] = "accordion.trigger";
+    AccordionRole["Icon"] = "accordion.icon";
+    AccordionRole["Panel"] = "accordion.panel";
+})(AccordionRole || (AccordionRole = {}));
+/**
+ * DISCLOSURE ("Read more") — one trigger, one panel. The root IS its item (it carries the item key and
+ * `data-iox-on`); the trigger holds two words, the one shown while closed (`more`) and the one shown while open
+ * (`less`), swapped by the Item open state — never by script.
+ */
+var DisclosureRole;
+(function (DisclosureRole) {
+    DisclosureRole["Disclosure"] = "disclosure";
+    DisclosureRole["Trigger"] = "disclosure.trigger";
+    DisclosureRole["More"] = "disclosure.more";
+    DisclosureRole["Less"] = "disclosure.less";
+    DisclosureRole["Icon"] = "disclosure.icon";
+    DisclosureRole["Panel"] = "disclosure.panel";
+})(DisclosureRole || (DisclosureRole = {}));
+const COMPOSITE_KIND_ROLES = {
+    [CompositeKind.Accordion]: { root: AccordionRole.Accordion, item: AccordionRole.Item, trigger: AccordionRole.Trigger, panel: AccordionRole.Panel, icon: AccordionRole.Icon },
+    [CompositeKind.Disclosure]: { root: DisclosureRole.Disclosure, item: DisclosureRole.Disclosure, trigger: DisclosureRole.Trigger, panel: DisclosureRole.Panel, icon: DisclosureRole.Icon },
+};
+const KINDS = Object.values(CompositeKind);
+const rolesOf = (pick) => new Set(KINDS.map(k => COMPOSITE_KIND_ROLES[k][pick]));
+const ROOT_ROLES = rolesOf('root');
+const ITEM_ROLES = rolesOf('item');
+const TRIGGER_ROLES = rolesOf('trigger');
+const PANEL_ROLES = rolesOf('panel');
+/** The kind a role belongs to (`disclosure.panel` → Disclosure), or null for any other role. */
+function compositeKindOfRole(role) {
+    const head = role?.split('.')[0];
+    return KINDS.includes(head ?? '') ? head : null;
+}
+/** A root that runs the open/close runtime (an Accordion or a Disclosure). */
+function isCompositeRoot(node) {
+    return !!node?.role && ROOT_ROLES.has(node.role);
+}
+/** An ITEM — an accordion's item, or a disclosure (its own item). */
+function isCompositeItem(node) {
+    return !!node?.role && ITEM_ROLES.has(node.role);
+}
+/** A trigger — rendered as a `<button>` that opens its item, never a link. */
+function isCompositeTrigger(node) {
+    return !!node?.role && TRIGGER_ROLES.has(node.role);
+}
+/** A panel — rendered inside the track + region the one hiding rule collapses. */
+function isCompositePanel(node) {
+    return !!node?.role && PANEL_ROLES.has(node.role);
+}
+function isDisclosureRoot(node) {
+    return node?.role === DisclosureRole.Disclosure;
+}
+/** True for any part of a disclosure (its root included). */
+function isDisclosurePart(node) {
+    return compositeKindOfRole(node?.role) === CompositeKind.Disclosure;
+}
+/** The composite root a node belongs to: the nearest ancestor (or the node itself) that is one. `path` = the
+ *  node's ancestors, root first. */
+function compositeRootOf(node, path) {
+    if (isCompositeRoot(node))
+        return node;
+    for (let i = path.length - 1; i >= 0; i--)
+        if (isCompositeRoot(path[i]))
+            return path[i];
+    return null;
+}
+/** The item a node sits in — the nearest item of either kind (itself when it is one) — or null. An accordion
+ *  root ends the walk (its items are below it). */
+function compositeItemOf(node, path) {
+    if (isCompositeItem(node))
+        return node;
+    for (let i = path.length - 1; i >= 0; i--) {
+        if (isCompositeItem(path[i]))
+            return path[i];
+        if (isCompositeRoot(path[i]))
+            return null;
+    }
+    return null;
+}
+
+/**
+ * ACCORDION (CC2 — composite K1; complex-components boards 3, 4 and 9, APPROVED 2026-10-20). Not a
+ * component: a recipe of ordinary nodes, each part carrying a role, so every part is selectable on the
+ * canvas, in the layer tree and the breadcrumb, and wears its own element style (R2).
+ *
+ *   Container `box`                      role accordion      traits multiple · defaultOn   (Manual)
+ *     — or a Repeater bound to a list    role accordion      ONE template item             (From content, R3)
+ *   └─ Container `accordion-item`        role accordion.item      itemKey k1 … (Manual) · the row's id (From content)
+ *       ├─ LinkedContainer `accordion-trigger`  role accordion.trigger   → <hN><button> (the question's level)
+ *       │   ├─ Heading `h3`               the question (rendered as phrasing inside the button)
+ *       │   └─ Icon `icon`                role accordion.icon      Item open → rotate
+ *       └─ Container `accordion-panel`    role accordion.panel     inside a hidden="until-found" region
+ *           └─ Text `body`                the answer
+ *
+ * The behaviour is BUILT IN (composite plan D1 = B): which items are open is one state machine
+ * (`nextAccordionState`), the ARIA and DOM state one planner (`accordionItemState` and the attribute
+ * functions), the keyboard one key map — read by the builder canvas, both engine paths and the composer.
+ */
+/** The behaviour options a composite root stores as ordinary TRAITS (composite plan §3). */
+var CompositeBehaviourTrait;
+(function (CompositeBehaviourTrait) {
+    /** Several items may be open at once ("Allow several open"). */
+    CompositeBehaviourTrait["Multiple"] = "multiple";
+    /** Which items open by default: first · none · all. */
+    CompositeBehaviourTrait["DefaultOn"] = "defaultOn";
+})(CompositeBehaviourTrait || (CompositeBehaviourTrait = {}));
+var AccordionDefaultOn;
+(function (AccordionDefaultOn) {
+    AccordionDefaultOn["First"] = "first";
+    AccordionDefaultOn["None"] = "none";
+    AccordionDefaultOn["All"] = "all";
+})(AccordionDefaultOn || (AccordionDefaultOn = {}));
+const ACCORDION_DEFAULT_ONS = [AccordionDefaultOn.First, AccordionDefaultOn.None, AccordionDefaultOn.All];
+/** Behaviour ▸ Icon — a preset over the items' icons, never a stored trait (detected from the icons). */
+var AccordionIcon;
+(function (AccordionIcon) {
+    AccordionIcon["Chevron"] = "chevron";
+    AccordionIcon["Plus"] = "plus";
+    AccordionIcon["None"] = "none";
+})(AccordionIcon || (AccordionIcon = {}));
+const ACCORDION_ICONS = [AccordionIcon.Chevron, AccordionIcon.Plus, AccordionIcon.None];
+/** Each icon's glyph and how far it turns when its item opens (board 4: a chevron flips, a plus becomes ×). */
+const ACCORDION_ICON_GLYPH = {
+    [AccordionIcon.Chevron]: { iconClass: 'ph ph-caret-down', turn: '180deg' },
+    [AccordionIcon.Plus]: { iconClass: 'ph ph-plus', turn: '45deg' },
+};
+/** The item-open style state (a part INSIDE an item, styled by its item being open — board 9 "Item open"). */
+const ITEM_OPEN_STATE = 'trigger-on';
+/** A part that IS on (an item, its header, its panel — board 9 "Open"). */
+const ON_STATE = 'on';
+/** Items from content default to twenty rows (board 9 Q13). */
+const ACCORDION_CONTENT_LIMIT = 20;
+/** The words a fresh accordion starts with — generic, the author's to replace (as Card v2's are). */
+const ACCORDION_WORDS = [
+    { question: 'Write the first question people ask', answer: 'Answer it plainly, in two or three short sentences.' },
+    { question: 'Write the second question', answer: 'Answer it plainly, in two or three short sentences.' },
+    { question: 'Write the third question', answer: 'Answer it plainly, in two or three short sentences.' },
+];
+const ACCORDION_NEW_ITEM_WORDS = { question: 'Write a new question', answer: 'Answer it plainly, in two or three short sentences.' };
+var Type$2;
+(function (Type) {
+    Type["Container"] = "Container";
+    Type["LinkedContainer"] = "LinkedContainer";
+    Type["Heading"] = "Heading";
+    Type["Text"] = "Text";
+    Type["Icon"] = "Icon";
+    Type["Repeater"] = "Repeater";
+})(Type$2 || (Type$2 = {}));
+var Style$2;
+(function (Style) {
+    Style["Root"] = "box";
+    Style["Item"] = "accordion-item";
+    Style["Trigger"] = "accordion-trigger";
+    Style["Question"] = "h3";
+    Style["Icon"] = "icon";
+    Style["Panel"] = "accordion-panel";
+    Style["Answer"] = "body";
+})(Style$2 || (Style$2 = {}));
+const ZERO_BOX$2 = '0px 0px 0px 0px';
+const HEADING_LEVELS = ['h2', 'h3', 'h4', 'h5', 'h6'];
+const DEFAULT_LEVEL = 'h3';
+/** A linked trait the header must never carry: it is a button, not a link. */
+const LINK_TYPE$1 = 'linkType';
+/** What each part holds in the recipe — layout only; its LOOK is its element style. */
+const PART_BASE$1 = {
+    // The items are a column a token apart (`accordion-gap`: 0 for a divider list, 12px for cards).
+    [AccordionRole.Accordion]: { display: 'flex', flexDirection: 'column', gap: 'var(--iox-accordion-gap)', width: '100%', minHeight: 'auto', height: 'auto' },
+    [AccordionRole.Item]: { display: 'block', width: '100%', minHeight: 'auto', height: 'auto' },
+    // The header is the whole row: the question takes the line, the icon sits at its end (board 4).
+    [AccordionRole.Trigger]: { display: 'flex', alignItems: 'center', justifyContent: 'space-between', gap: '16px', width: '100%', minHeight: 'auto', height: 'auto', textAlign: 'start', cursor: 'pointer' },
+    [AccordionRole.Icon]: { flexShrink: '0', fontSize: '22px', transitionDuration: 'var(--iox-dur-base)', transitionTimingFunction: 'var(--iox-ease-standard)' },
+    [AccordionRole.Panel]: { display: 'block', width: '100%', minHeight: 'auto', height: 'auto' },
+};
+/** The question INHERITS the header's ink (board 4's wears table: the Question reads no colour token), so the
+ *  header's hover ink reaches the words; and it sits in the row with no margin of its own. */
+const QUESTION_BASE = { color: 'inherit', margin: ZERO_BOX$2, flexGrow: '1', minWidth: '0px' };
+const ANSWER_BASE = { margin: ZERO_BOX$2, padding: ZERO_BOX$2, minHeight: 'auto' };
+function make$2(create, key, type, role, style, props = {}, label) {
+    return makeCompositePart(create, { key, type, props, elementStyle: style }, role, label, role ? PART_BASE$1[role] : undefined);
+}
+/** The icon of an item (an accordion's, or a disclosure's — `role`); its Item-open state (the turn) is driven by
+ *  ITS item (`stateTriggers`). ONE builder for both kinds. */
+function buildCompositeIcon(create, key, icon, itemId, role = AccordionRole.Icon) {
+    const glyph = ACCORDION_ICON_GLYPH[icon];
+    const node = makeCompositePart(create, { key, type: Type$2.Icon, props: { iconClass: glyph.iconClass }, elementStyle: Style$2.Icon }, role, 'Icon', PART_BASE$1[AccordionRole.Icon]);
+    node.stateStyles = { ...(node.stateStyles ?? {}), [ITEM_OPEN_STATE]: { rotate: glyph.turn } };
+    if (itemId)
+        node.stateTriggers = { ...(node.stateTriggers ?? {}), [ITEM_OPEN_STATE]: itemId };
+    return node;
+}
+/** One item: header (question + icon) and panel (answer). `key` makes every part's recipe key unique. */
+function buildAccordionItem(create, words, itemKey, icon = AccordionIcon.Chevron) {
+    const item = make$2(create, `${itemKey}`, Type$2.Container, AccordionRole.Item, Style$2.Item, {}, 'Item');
+    item.itemKey = itemKey;
+    const trigger = make$2(create, `${itemKey}-trigger`, Type$2.LinkedContainer, AccordionRole.Trigger, Style$2.Trigger, {}, 'Header');
+    const question = make$2(create, `${itemKey}-question`, Type$2.Heading, null, Style$2.Question, { content: words.question, level: DEFAULT_LEVEL }, 'Heading');
+    writeStyles(question, QUESTION_BASE);
+    trigger.children = [question, ...(icon === AccordionIcon.None ? [] : [buildCompositeIcon(create, `${itemKey}-icon`, icon, item.id)])];
+    const panel = make$2(create, `${itemKey}-panel`, Type$2.Container, AccordionRole.Panel, Style$2.Panel, {}, 'Panel');
+    const answer = make$2(create, `${itemKey}-answer`, Type$2.Text, null, Style$2.Answer, { content: words.answer, tag: 'p' }, 'Text');
+    writeStyles(answer, ANSWER_BASE);
+    panel.children = [answer];
+    item.children = [trigger, panel];
+    return item;
+}
+/** A fresh Accordion: three items, one open at a time, the first open by default (board 4). */
+function buildAccordionRecipe(create, options = {}) {
+    const root = make$2(create, 'accordion', Type$2.Container, AccordionRole.Accordion, Style$2.Root, {}, 'Accordion');
+    writeProp(root, CompositeBehaviourTrait.Multiple, options.multiple ?? false);
+    writeProp(root, CompositeBehaviourTrait.DefaultOn, options.defaultOn ?? AccordionDefaultOn.First);
+    const words = options.items ?? ACCORDION_WORDS;
+    root.children = words.map((w, i) => buildAccordionItem(create, w, `k${i + 1}`, options.icon ?? AccordionIcon.Chevron));
+    return root;
+}
+// ── reading a tree ──────────────────────────────────────────────────────────────────────────────
+function isAccordionRoot(node) {
+    return node?.role === AccordionRole.Accordion;
+}
+/** True for any part of an accordion (its root included). */
+function isAccordionPart(node) {
+    return !!node?.role && (node.role === AccordionRole.Accordion || node.role.startsWith(`${AccordionRole.Accordion}.`));
+}
+/** The accordion a node belongs to: the nearest ancestor (or the node itself) playing `accordion`.
+ *  `path` = the node's ancestors, root first. */
+function accordionRootOf(node, path) {
+    if (isAccordionRoot(node))
+        return node;
+    for (let i = path.length - 1; i >= 0; i--)
+        if (isAccordionRoot(path[i]))
+            return path[i];
+    return null;
+}
+/** The item a node sits in (the node itself when it is one), or null. */
+function accordionItemOf(node, path) {
+    if (node.role === AccordionRole.Item)
+        return node;
+    for (let i = path.length - 1; i >= 0; i--) {
+        if (path[i].role === AccordionRole.Item)
+            return path[i];
+        if (isAccordionRoot(path[i]))
+            return null;
+    }
+    return null;
+}
+/** True when the root takes its items from content (a Repeater bound to a list, R3). */
+function isAccordionFromContent(root) {
+    return !!root && root.type === Type$2.Repeater;
+}
+/** The root's items in order — every item (Manual), or the one template item (From content). */
+function accordionItems(root) {
+    return (root.children ?? []).filter(c => c.role === AccordionRole.Item);
+}
+const asBool = (v) => v === true || v === 'true';
+/** The root's behaviour (an unset trait reads its default: one at a time, the first open). */
+function accordionBehaviour(root) {
+    const raw = root ? readProp(root, CompositeBehaviourTrait.DefaultOn) : undefined;
+    const defaultOn = ACCORDION_DEFAULT_ONS.includes(raw) ? raw : AccordionDefaultOn.First;
+    return { multiple: root ? asBool(readProp(root, CompositeBehaviourTrait.Multiple)) : false, defaultOn };
+}
+/** Behaviour ▸ Allow several open / Open by default. False when the node has no such trait. */
+function setAccordionBehaviour(root, patch) {
+    let ok = true;
+    if (patch.multiple !== undefined)
+        ok = writeProp(root, CompositeBehaviourTrait.Multiple, patch.multiple) && ok;
+    if (patch.defaultOn !== undefined)
+        ok = writeProp(root, CompositeBehaviourTrait.DefaultOn, patch.defaultOn) && ok;
+    return ok;
+}
+/** The roles of the kind an item belongs to (an accordion item, or a disclosure — its own item). */
+function kindRolesOf(node) {
+    return COMPOSITE_KIND_ROLES[compositeKindOfRole(node.role) ?? CompositeKind.Accordion];
+}
+/** The header of an item (either kind). */
+function accordionTriggerOf(item) {
+    return findByRole(item, kindRolesOf(item).trigger);
+}
+/** The panel of an item (either kind). */
+function accordionPanelOf(item) {
+    return findByRole(item, kindRolesOf(item).panel);
+}
+/** A root's items — an accordion's (`accordionItems`), or a disclosure, which is its own one item. */
+function compositeItems(root) {
+    return compositeKindOfRole(root.role) === CompositeKind.Disclosure ? [root] : accordionItems(root);
+}
+/** The question: the first Heading inside the header — a disclosure's toggle holds no heading, so its first word
+ *  (the Text shown while closed, "Read more"). */
+function accordionQuestionOf(item) {
+    const trigger = accordionTriggerOf(item);
+    let hit;
+    let text;
+    if (trigger)
+        walkComposite(trigger, n => {
+            if (!hit && n.type === Type$2.Heading)
+                hit = n;
+            if (!text && n.type === Type$2.Text)
+                text = n;
+        });
+    return hit ?? text;
+}
+/** The answer: the first Text inside the panel. */
+function accordionAnswerOf(item) {
+    const panel = accordionPanelOf(item);
+    let hit;
+    if (panel)
+        walkComposite(panel, n => { if (!hit && n.type === Type$2.Text)
+            hit = n; });
+    return hit;
+}
+const stripTags = (v) => String(v ?? '').replace(/<[^>]*>/g, '').trim();
+/** An item's name in the Items list and the layer tree: its question's words. */
+function accordionItemLabel(item) {
+    const q = accordionQuestionOf(item);
+    return q ? stripTags(readProp(q, 'content')) : '';
+}
+/** Items ▸ rename: the question's words. */
+function renameAccordionItem(item, question) {
+    const q = accordionQuestionOf(item);
+    return !!q && writeProp(q, 'content', question);
+}
+/** The heading level the header's wrapper renders (`<h3><button>`): its question's level. */
+function accordionHeadingLevel(trigger) {
+    let level;
+    const visit = (n) => {
+        if (level !== undefined)
+            return;
+        if (n.type === Type$2.Heading) {
+            level = readProp(n, 'level');
+            return;
+        }
+        for (const c of n.children ?? [])
+            visit(c);
+    };
+    for (const c of trigger?.children ?? [])
+        visit(c);
+    return HEADING_LEVELS.includes(level) ? level : DEFAULT_LEVEL;
+}
+// ── editing (Items list, selection toolbar, Behaviour ▸ Icon) ──────────────────────────────────
+/** A key no item of `root` holds yet (`k4`…). */
+function nextItemKey(root) {
+    const taken = new Set(accordionItems(root).map(i => i.itemKey).filter(Boolean));
+    let n = taken.size + 1;
+    while (taken.has(`k${n}`))
+        n++;
+    return `k${n}`;
+}
+/** Items ▸ Add item (and the toolbar's "Add item"): a fresh item after `after` (or at the end), wearing the
+ *  accordion's current icon. Returns the new item. */
+function addAccordionItem(root, create, after, words = ACCORDION_NEW_ITEM_WORDS) {
+    const key = nextItemKey(root);
+    const item = buildAccordionItem(create, words, key, detectAccordionIcon(root));
+    const children = [...(root.children ?? [])];
+    const at = after ? children.indexOf(after) : -1;
+    children.splice(at < 0 ? children.length : at + 1, 0, item);
+    root.children = children;
+    return item;
+}
+/** Items ▸ drag to reorder: move an item to `toIndex` among the items. False when it is not an item of `root`. */
+function moveAccordionItem(root, item, toIndex) {
+    const children = [...(root.children ?? [])];
+    const from = children.indexOf(item);
+    if (from < 0 || item.role !== AccordionRole.Item)
+        return false;
+    children.splice(from, 1);
+    const items = children.filter(c => c.role === AccordionRole.Item);
+    const anchor = items[Math.max(0, Math.min(toIndex, items.length))];
+    const at = anchor ? children.indexOf(anchor) : children.length;
+    children.splice(at, 0, item);
+    root.children = children;
+    return true;
+}
+var AccordionEditRefusal;
+(function (AccordionEditRefusal) {
+    /** An accordion keeps at least one item (composite plan T11). */
+    AccordionEditRefusal["LastItem"] = "last-item";
+})(AccordionEditRefusal || (AccordionEditRefusal = {}));
+/** Why removing `item` from `root` is refused, or null. */
+function accordionRemovalRefusal(root, item) {
+    if (!root || item?.role !== AccordionRole.Item)
+        return null;
+    return accordionItems(root).length <= 1 ? AccordionEditRefusal.LastItem : null;
+}
+/** The icon the composite's items wear now (the first item's; None when it has no icon). Either kind. */
+function detectAccordionIcon(root) {
+    const first = compositeItems(root)[0];
+    const icon = first ? findByRole(first, kindRolesOf(root).icon) : undefined;
+    if (!icon)
+        return first ? AccordionIcon.None : AccordionIcon.Chevron;
+    const cls = String(readProp(icon, 'iconClass') ?? '');
+    return cls.includes(ACCORDION_ICON_GLYPH[AccordionIcon.Plus].iconClass.split(' ')[1]) ? AccordionIcon.Plus : AccordionIcon.Chevron;
+}
+/**
+ * Behaviour ▸ Icon: every item's header shows the chevron, the plus, or no icon. A switch between glyphs
+ * keeps the icon NODE (its styles and interactions) and changes its glyph and turn; None removes it, and a
+ * glyph after None stamps it back from the recipe. Returns how many items changed.
+ */
+function setAccordionIcon(root, icon, create) {
+    let changed = 0;
+    const iconRole = kindRolesOf(root).icon;
+    for (const item of compositeItems(root)) {
+        const trigger = accordionTriggerOf(item);
+        if (!trigger)
+            continue;
+        const existing = findByRole(trigger, iconRole);
+        if (icon === AccordionIcon.None) {
+            if (existing && removeFromComposite(trigger, existing))
+                changed++;
+            continue;
+        }
+        const glyph = ACCORDION_ICON_GLYPH[icon];
+        if (existing) {
+            writeProp(existing, 'iconClass', glyph.iconClass);
+            existing.stateStyles = { ...(existing.stateStyles ?? {}), [ITEM_OPEN_STATE]: { ...(existing.stateStyles?.[ITEM_OPEN_STATE] ?? {}), rotate: glyph.turn } };
+            changed++;
+        }
+        else if (create) {
+            trigger.children = [...(trigger.children ?? []), buildCompositeIcon(create, `${item.itemKey ?? 'item'}-icon`, icon, item.id, iconRole)];
+            changed++;
+        }
+    }
+    return changed;
+}
+/** The node id every `trigger-on` state inside an item points at: its ITEM (`stateTriggers['trigger-on']`). */
+function itemOpenTriggerIds(root) {
+    for (const item of accordionItems(root)) {
+        if (!item.id)
+            continue;
+        walkComposite(item, n => {
+            if (n === item || !n.stateStyles?.[ITEM_OPEN_STATE])
+                return;
+            n.stateTriggers = { ...(n.stateTriggers ?? {}), [ITEM_OPEN_STATE]: item.id };
+        });
+    }
+}
+// ── state machine ───────────────────────────────────────────────────────────────────────────────
+/** The keys open on first render: the first item, none, or all (From content: resolved against the rows). */
+function initialAccordionOpen(keys, defaultOn) {
+    if (defaultOn === AccordionDefaultOn.None || !keys.length)
+        return new Set();
+    if (defaultOn === AccordionDefaultOn.All)
+        return new Set(keys);
+    return new Set([keys[0]]);
+}
+/** The open keys after toggling `key`: one at a time closes the others; several leaves them. */
+function nextAccordionState(open, key, behaviour) {
+    if (open.has(key)) {
+        const next = new Set(open);
+        next.delete(key);
+        return next;
+    }
+    return behaviour.multiple ? new Set([...open, key]) : new Set([key]);
+}
+/** The open keys after OPENING `key` (find-in-page, selecting into a closed panel, the `openItem` action). */
+function openAccordionItem(open, key, behaviour) {
+    return open.has(key) ? new Set(open) : nextAccordionState(open, key, behaviour);
+}
+/** The open keys after CLOSING `key` (the `closeItem` action). */
+function closeAccordionItem(open, key) {
+    const next = new Set(open);
+    next.delete(key);
+    return next;
+}
+var AccordionKeyAction;
+(function (AccordionKeyAction) {
+    AccordionKeyAction["Next"] = "next";
+    AccordionKeyAction["Previous"] = "previous";
+    AccordionKeyAction["First"] = "first";
+    AccordionKeyAction["Last"] = "last";
+})(AccordionKeyAction || (AccordionKeyAction = {}));
+/** The APG accordion's keys on a header: ↓ ↑ move (and wrap), Home / End jump. Enter and Space are the
+ *  button's own. */
+const KEY_ACTIONS = {
+    ArrowDown: AccordionKeyAction.Next,
+    ArrowUp: AccordionKeyAction.Previous,
+    Home: AccordionKeyAction.First,
+    End: AccordionKeyAction.Last,
+};
+function accordionKeyAction(key) {
+    return KEY_ACTIONS[key] ?? null;
+}
+/** The header index `action` moves focus to, from `current` among `count` headers (↓ ↑ wrap). */
+function accordionFocusIndex(action, current, count) {
+    if (count <= 0)
+        return -1;
+    switch (action) {
+        case AccordionKeyAction.Next: return (current + 1) % count;
+        case AccordionKeyAction.Previous: return (current - 1 + count) % count;
+        case AccordionKeyAction.First: return 0;
+        case AccordionKeyAction.Last: return count - 1;
+    }
+}
+// ── identity, ids and attributes (both renderers, SSR included) ────────────────────────────────
+/** A key safe in an element id. */
+function domSafeKey(raw) {
+    return String(raw ?? '').replace(/[^A-Za-z0-9_-]/g, '-');
+}
+/** A content row's identity: its own id (never its index — a reorder in the CMS must never pair a header with
+ *  another row's panel, R3); the index only for a row that has none. */
+function rowItemKey(row, index) {
+    const r = row;
+    const id = r && typeof r === 'object' ? (r._id ?? r.id) : undefined;
+    return id !== undefined && id !== null && id !== '' ? domSafeKey(id) : `row-${index}`;
+}
+const DOM_ID_PREFIX = {
+    [CompositeKind.Accordion]: 'iox-acc',
+    [CompositeKind.Disclosure]: 'iox-dis',
+};
+/** The ARIA pairing ids of an item: unique per composite (its SCOPE id — `compositeScopeId`) and per item (its key). */
+function accordionDomIds(rootId, itemKey, kind = CompositeKind.Accordion) {
+    const base = `${DOM_ID_PREFIX[kind]}-${domSafeKey(rootId)}-${domSafeKey(itemKey)}`;
+    return { trigger: `${base}-h`, panel: `${base}-p` };
+}
+/**
+ * The id a rendered composite's ARIA ids are built from: its node id, and — when it sits inside repeated rows —
+ * every enclosing row's identity, outermost first (vectoriox/iox-ui#20: an accordion repeated per card used to
+ * pair every row's header with the FIRST row's panel). The engine folds each row's `rowItemKey`; the builder
+ * canvas its preview row's index. Unrepeated, it is the node id unchanged.
+ */
+function compositeScopeId(rootId, rowKeys = []) {
+    return rowKeys.length ? [rootId, ...rowKeys.map(domSafeKey)].join('-') : rootId;
+}
+function accordionScope(rootId, behaviour, keys, kind = CompositeKind.Accordion) {
+    return { kind, rootId, behaviour, keys, open: initialAccordionOpen(keys, behaviour.defaultOn) };
+}
+function accordionItemState(scope, index) {
+    const key = scope.keys[index] ?? `item-${index}`;
+    return { kind: scope.kind, key, index, on: scope.open.has(key), ids: accordionDomIds(scope.rootId, key, scope.kind) };
+}
+/** `data-iox-on` — the ONE attribute every "on" style keys on (Open, Item open). */
+const ON_ATTRIBUTE = 'data-iox-on';
+const ITEM_KEY_ATTRIBUTE = 'data-iox-item-key';
+const COMPOSITE_ATTRIBUTE = 'data-iox-composite';
+const MULTIPLE_ATTRIBUTE = 'data-iox-multiple';
+const DEFAULT_ON_ATTRIBUTE = 'data-iox-default-on';
+/** The scope id the ARIA ids are built from (`compositeScopeId`), written by the engine so the runtime re-stamps
+ *  exactly the ids the server rendered. */
+const SCOPE_ATTRIBUTE = 'data-iox-scope';
+/** The value a closed panel's region carries: find-in-page can still reveal it (D9, board 4). */
+const UNTIL_FOUND = 'until-found';
+/** The structural classes the renderers write around an accordion's parts (no node owns them). */
+var AccordionClass;
+(function (AccordionClass) {
+    AccordionClass["Heading"] = "iox-accordion-heading";
+    AccordionClass["Button"] = "iox-accordion-button";
+    AccordionClass["Track"] = "iox-accordion-track";
+    AccordionClass["Region"] = "iox-accordion-region";
+})(AccordionClass || (AccordionClass = {}));
+function accordionRootAttributes(behaviour, kind = CompositeKind.Accordion, scopeId) {
+    return {
+        [COMPOSITE_ATTRIBUTE]: kind,
+        [DEFAULT_ON_ATTRIBUTE]: behaviour.defaultOn,
+        ...(behaviour.multiple && kind === CompositeKind.Accordion ? { [MULTIPLE_ATTRIBUTE]: '' } : {}),
+        ...(scopeId ? { [SCOPE_ATTRIBUTE]: scopeId } : {}),
+    };
+}
+function accordionItemAttributes(state) {
+    return { [ITEM_KEY_ATTRIBUTE]: state.key, ...(state.on ? { [ON_ATTRIBUTE]: '' } : {}) };
+}
+function accordionTriggerAttributes(state) {
+    return {
+        type: 'button',
+        id: state.ids.trigger,
+        'aria-expanded': state.on ? 'true' : 'false',
+        'aria-controls': state.ids.panel,
+        ...(state.on ? { [ON_ATTRIBUTE]: '' } : {}),
+    };
+}
+/** The track wrapping a panel: its row collapses to 0 while closed (the ONE hiding rule, iox-design.css). */
+function accordionTrackAttributes(state) {
+    return state.on ? { [ON_ATTRIBUTE]: '' } : {};
+}
+/** The region the panel sits in: `hidden="until-found"` while closed, so its words stay in the page. An accordion's
+ *  is a labelled `region` (APG accordion); a disclosure's is a plain block (APG disclosure: the button names it). */
+function accordionRegionAttributes(state) {
+    const labelled = hasLabelledRegion(state.kind);
+    return {
+        ...(labelled ? { role: 'region' } : {}),
+        id: state.ids.panel,
+        ...(labelled ? { 'aria-labelledby': state.ids.trigger } : {}),
+        ...(state.on ? {} : { hidden: UNTIL_FOUND }),
+    };
+}
+/** True when a region of this kind is a labelled `role=region`. */
+function hasLabelledRegion(kind) {
+    return kind === CompositeKind.Accordion;
+}
+function accordionPanelAttributes(state) {
+    return state.on ? { [ON_ATTRIBUTE]: '' } : {};
+}
+/** `attrs` as an HTML attribute string (` a="b" c`), values escaped by `esc`. */
+function serializeDomAttributes(attrs, esc) {
+    return Object.entries(attrs).map(([k, v]) => (v === '' ? ` ${k}` : ` ${k}="${esc(v)}"`)).join('');
+}
+const SHORT_TEXT = new Set(['text']);
+const LONG_TEXT = new Set(['textarea', 'richText', 'editor']);
+/** R3 (board 9 Q19): switching to From content binds the question to the first short-text field and the
+ *  answer to the first long-text field. ONE rule for the builder's switch and the composer. */
+function pickAccordionAutoBinds(fields) {
+    const isString = (f) => !f.type || f.type === 'string';
+    const question = fields.find(f => isString(f) && SHORT_TEXT.has(String(f.controller ?? 'text')))?.name ?? null;
+    const answer = fields.find(f => isString(f) && LONG_TEXT.has(String(f.controller ?? '')) && f.name !== question)?.name ?? null;
+    return { question, answer };
+}
+/** The bound props of the question and the answer (each a content trait). */
+const ACCORDION_BIND_PROP = 'content';
+/**
+ * Manual → From content (board 9 "Items: Manual · From content"): the root becomes `repeater` (a Repeater node
+ * the caller created with the same id, role, label, element style and styles — a type change is the
+ * consumer's), the FIRST item becomes the one template (its parts, styles and interactions kept; its key
+ * dropped — a row's key is its id) and the others are removed. Returns the removed items.
+ */
+function accordionToContent(root, repeater) {
+    const items = accordionItems(root);
+    const [template, ...rest] = items;
+    if (template)
+        delete template.itemKey;
+    repeater.role = AccordionRole.Accordion;
+    repeater.children = template ? [template] : [];
+    writeProp(repeater, CompositeBehaviourTrait.Multiple, accordionBehaviour(root).multiple);
+    writeProp(repeater, CompositeBehaviourTrait.DefaultOn, accordionBehaviour(root).defaultOn);
+    return rest;
+}
+/**
+ * From content → Manual: the rows come in as static items — each a copy of the template (`cloneItem`, which
+ * gives the copy fresh ids) whose bound words are written in as its own and whose bindings are dropped.
+ * `container` is the manual root the caller created. Returns the new items.
+ */
+function accordionToManual(root, container, rows, cloneItem, resolve) {
+    const template = accordionItems(root)[0];
+    container.role = AccordionRole.Accordion;
+    writeProp(container, CompositeBehaviourTrait.Multiple, accordionBehaviour(root).multiple);
+    writeProp(container, CompositeBehaviourTrait.DefaultOn, accordionBehaviour(root).defaultOn);
+    const items = template ? rows.map((row, i) => {
+        const item = cloneItem(template);
+        item.itemKey = `k${i + 1}`;
+        walkComposite(item, n => {
+            const bindings = n.bindings ?? [];
+            for (const b of bindings) {
+                const value = resolve(row, b);
+                if (value !== undefined && value !== null)
+                    writeProp(n, b.prop, value);
+            }
+            if (bindings.length)
+                n.bindings = [];
+        });
+        return item;
+    }) : [];
+    container.children = items;
+    return items;
+}
+/** The style a part holds for `name` (both node shapes) — exported for the consumers' detectors. */
+function accordionPartStyle(node, name) {
+    return readOwnedTrait(node, { trait: name });
+}
+
+/**
+ * The Accordion's RUNTIME (CC2) — ONE copy, DOM only, for the builder canvas and the live site (both engine
+ * paths render the same markup). It reads the markup the renderers write (iox-design.css + accordion.ts's
+ * attribute planners), so the server's first paint and every later state agree:
+ *
+ *   [root]  data-iox-composite="accordion"  data-iox-default-on  [data-iox-multiple]  [data-iox-scope]  (the node's
+ *           own element — its role class may sit on a wrapper host, as the engine's component-path Repeater draws it)
+ *     .iox-role-accordion-item  data-iox-item-key  [data-iox-on]
+ *       hN.iox-accordion-heading > button.iox-accordion-button  id  aria-expanded  aria-controls
+ *       .iox-accordion-track [data-iox-on] > .iox-accordion-region  role=region  [hidden=until-found]
+ *         .iox-role-accordion-panel
+ *
+ * The DISCLOSURE (CC2.1) runs on this same runtime: `data-iox-composite="disclosure"` on a root that IS its one
+ * item (it carries the key and `data-iox-on`), its button straight inside it (no heading), its panel in the same
+ * track + region (a plain block — no `role=region`), and no arrow keys (one button).
+ *
+ * It owns: a click on a header toggles its item; ↓ ↑ Home End move between the headers of THIS accordion
+ * (a nested one keeps its own); find-in-page (`beforematch`) opens the item that holds the match; a closed
+ * panel gets `hidden="until-found"` after its track has collapsed (at once under reduced motion). Every
+ * change dispatches `iox-item-on` / `iox-item-off` on the item, the `itemOn` / `itemOff` interaction
+ * triggers. The open set is LIVE ∪ FORCED: the builder forces items open (a selection inside a closed panel,
+ * "All open"); the live site forces nothing.
+ */
+const ITEM_ON_EVENT = 'iox-item-on';
+const ITEM_OFF_EVENT = 'iox-item-off';
+const KIND_ROOT = (kind) => `[${COMPOSITE_ATTRIBUTE}="${kind}"]`;
+const ROOT_SELECTOR = Object.values(CompositeKind).map(KIND_ROOT).join(', ');
+/** An accordion's items are its `.iox-role-accordion-item` children; a disclosure is its own item. */
+const ACCORDION_ITEM_SELECTOR = '.iox-role-accordion-item';
+const ITEM_SELECTOR = `${ACCORDION_ITEM_SELECTOR}, ${KIND_ROOT(CompositeKind.Disclosure)}`;
+const PANEL_SELECTOR = '.iox-role-accordion-panel, .iox-role-disclosure-panel';
+const BUTTON_SELECTOR = `.${AccordionClass.Button}`;
+const TRACK_SELECTOR = `.${AccordionClass.Track}`;
+const REGION_SELECTOR = `.${AccordionClass.Region}`;
+/** How long a closing track may take before its region is hidden (dur-base is 200–320ms in every pack). */
+const MAX_CLOSE_MS = 600;
+const REDUCED_MOTION = '(prefers-reduced-motion: reduce)';
+/** The composite (accordion or disclosure) an element belongs to (the element itself when it is a root). */
+function closestAccordion(el) {
+    return el?.closest?.(ROOT_SELECTOR) ?? null;
+}
+/** The item an element sits in (itself when it is one) — an accordion item, or a disclosure. */
+function closestAccordionItem(el) {
+    return el?.closest?.(ITEM_SELECTOR) ?? null;
+}
+const kindOf = (root) => root.getAttribute(COMPOSITE_ATTRIBUTE) === CompositeKind.Disclosure ? CompositeKind.Disclosure : CompositeKind.Accordion;
+/** The composite root whose items an item belongs to: a disclosure is its own root. */
+function rootOfItem(item) {
+    return kindOf(item) === CompositeKind.Disclosure && item.matches(KIND_ROOT(CompositeKind.Disclosure)) ? item : closestAccordion(item.parentElement);
+}
+/** Subscribe to an item turning on / off — what the `itemOn` / `itemOff` interaction triggers listen to. The
+ *  item is the element's own item (the element itself when it is one). Returns the unsubscribe. */
+function onAccordionItemState(el, on, handler) {
+    const item = closestAccordionItem(el);
+    if (!item)
+        return () => undefined;
+    const type = on ? ITEM_ON_EVENT : ITEM_OFF_EVENT;
+    item.addEventListener(type, handler);
+    return () => item.removeEventListener(type, handler);
+}
+/** True when the element's item is open now. */
+function isAccordionItemOn(el) {
+    return !!closestAccordionItem(el)?.hasAttribute(ON_ATTRIBUTE);
+}
+const nodeIdOf = (el) => {
+    for (const c of Array.from(el.classList))
+        if (c.startsWith('iox-node-'))
+            return c.slice('iox-node-'.length);
+    return '';
+};
+function behaviourOf(root) {
+    const raw = root.getAttribute(DEFAULT_ON_ATTRIBUTE);
+    return {
+        multiple: root.hasAttribute(MULTIPLE_ATTRIBUTE),
+        defaultOn: ACCORDION_DEFAULT_ONS.includes(raw) ? raw : AccordionDefaultOn.First,
+    };
+}
+function setAttr(el, name, value) {
+    if (!el)
+        return;
+    if (value === null) {
+        if (el.hasAttribute(name))
+            el.removeAttribute(name);
+    }
+    else if (el.getAttribute(name) !== value)
+        el.setAttribute(name, value);
+}
+class AccordionRuntime {
+    constructor(root, options = {}) {
+        this.root = root;
+        this.options = options;
+        this.shown = new Set();
+        this.closing = new Map();
+        this.observer = null;
+        this.stampQueued = false;
+        /** The builder attaches a root before its items render: the saved default is applied once they do. */
+        this.awaitingItems = false;
+        this.onClick = (event) => {
+            const button = event.target?.closest?.(BUTTON_SELECTOR);
+            if (!button || closestAccordion(button) !== this.root)
+                return;
+            const item = closestAccordionItem(button);
+            if (!item)
+                return;
+            event.preventDefault();
+            this.toggle(this.keyOf(item));
+        };
+        this.onKeydown = (event) => {
+            // A disclosure has one button: Enter / Space are the button's own, and there is nowhere to move.
+            if (this.kind !== CompositeKind.Accordion)
+                return;
+            const e = event;
+            const action = accordionKeyAction(e.key);
+            const button = e.target?.closest?.(BUTTON_SELECTOR);
+            if (!action || !button || closestAccordion(button) !== this.root)
+                return;
+            const buttons = this.buttons();
+            const at = buttons.indexOf(button);
+            const target = buttons[accordionFocusIndex(action, at, buttons.length)];
+            if (!target)
+                return;
+            e.preventDefault();
+            target.focus();
+        };
+        this.onBeforeMatch = (event) => {
+            const region = event.target?.closest?.(REGION_SELECTOR);
+            const item = closestAccordionItem(region);
+            const items = this.items();
+            if (!item || !items.includes(item))
+                return;
+            this.open(this.keyOf(item, items));
+        };
+        this.kind = options.kind ?? kindOf(root);
+        this.behaviourValue = options.behaviour ?? behaviourOf(root);
+        root.setAttribute(COMPOSITE_ATTRIBUTE, this.kind);
+        RUNTIMES.set(root, this);
+        // The server rendered the first state; with no server state the root's default decides.
+        // (The builder passes the behaviour and starts from the saved default; on the live site the server
+        // stamped every item's key and state, and that is the truth.)
+        const items = this.items();
+        const serverStamped = !options.behaviour && items.some(i => i.hasAttribute(ITEM_KEY_ATTRIBUTE));
+        this.live = serverStamped
+            ? new Set(items.filter(i => i.hasAttribute(ON_ATTRIBUTE)).map(i => this.keyOf(i, items)))
+            : initialAccordionOpen(items.map(i => this.keyOf(i, items)), this.behaviourValue.defaultOn);
+        this.awaitingItems = !serverStamped && !items.length;
+        this.shown = new Set(this.live);
+        // Capture: on the builder canvas every part's own listener stops the click (it selects that part), and
+        // the header must still toggle — the canvas is a live runtime.
+        root.addEventListener('click', this.onClick, true);
+        root.addEventListener('keydown', this.onKeydown);
+        root.addEventListener('beforematch', this.onBeforeMatch, true);
+        if (options.observe && typeof MutationObserver !== 'undefined') {
+            this.observer = new MutationObserver(() => this.queueStamp());
+            this.observer.observe(root, { childList: true, subtree: true });
+        }
+        this.stamp(true);
+    }
+    get behaviour() {
+        return this.behaviourValue;
+    }
+    /** The behaviour changed in the panel: re-read, and start from the new default. */
+    setBehaviour(behaviour) {
+        const changedDefault = behaviour.defaultOn !== this.behaviourValue.defaultOn;
+        this.behaviourValue = behaviour;
+        if (behaviour.multiple)
+            this.root.setAttribute(MULTIPLE_ATTRIBUTE, '');
+        else
+            this.root.removeAttribute(MULTIPLE_ATTRIBUTE);
+        this.root.setAttribute(DEFAULT_ON_ATTRIBUTE, behaviour.defaultOn);
+        if (changedDefault)
+            this.resetLive();
+        else
+            this.stamp();
+    }
+    /** THIS composite's items, in document order (a nested composite's items are its own); a disclosure's is itself. */
+    items() {
+        if (this.kind === CompositeKind.Disclosure)
+            return [this.root];
+        return Array.from(this.root.querySelectorAll(ACCORDION_ITEM_SELECTOR)).filter(i => closestAccordion(i.parentElement) === this.root);
+    }
+    /** The open keys the live state holds (before anything forced). */
+    get liveKeys() {
+        return this.live;
+    }
+    /** The keys showing open right now. */
+    get openKeys() {
+        return this.shown;
+    }
+    keyOf(item, items = this.items()) {
+        return item.getAttribute(ITEM_KEY_ATTRIBUTE) || `item-${items.indexOf(item)}`;
+    }
+    toggle(key) {
+        this.live = nextAccordionState(this.live, key, this.behaviourValue);
+        this.stamp();
+    }
+    open(key) {
+        this.live = openAccordionItem(this.live, key, this.behaviourValue);
+        this.stamp();
+    }
+    close(key) {
+        this.live = closeAccordionItem(this.live, key);
+        this.stamp();
+    }
+    /** Run an item action (`openItem` / `closeItem` / `toggleItem`, T14) on `key`. True when it shows open after. */
+    run(action, key) {
+        if (action === CompositeItemAction.Open)
+            this.open(key);
+        else if (action === CompositeItemAction.Close)
+            this.close(key);
+        else
+            this.toggle(key);
+        return this.shown.has(key);
+    }
+    /** Back to the saved default ("Showing on canvas ▸ As saved"). */
+    resetLive() {
+        const items = this.items();
+        this.live = initialAccordionOpen(items.map(i => this.keyOf(i, items)), this.behaviourValue.defaultOn);
+        this.stamp();
+    }
+    /** The forced set changed (builder design state): show it. */
+    refresh() {
+        this.stamp();
+    }
+    destroy() {
+        if (RUNTIMES.get(this.root) === this)
+            RUNTIMES.delete(this.root);
+        this.root.removeEventListener('click', this.onClick, true);
+        this.root.removeEventListener('keydown', this.onKeydown);
+        this.root.removeEventListener('beforematch', this.onBeforeMatch, true);
+        this.observer?.disconnect();
+        this.observer = null;
+        for (const t of this.closing.values())
+            clearTimeout(t);
+        this.closing.clear();
+    }
+    queueStamp() {
+        if (this.stampQueued)
+            return;
+        this.stampQueued = true;
+        const run = () => { this.stampQueued = false; this.stamp(); };
+        if (typeof queueMicrotask === 'function')
+            queueMicrotask(run);
+        else
+            Promise.resolve().then(run);
+    }
+    reduced() {
+        if (this.options.reducedMotion)
+            return this.options.reducedMotion();
+        try {
+            return typeof matchMedia === 'function' && matchMedia(REDUCED_MOTION).matches;
+        }
+        catch {
+            return false;
+        }
+    }
+    /** Write every item's state into its markup; announce what changed. */
+    stamp(first = false) {
+        // Our own writes must not wake the observer (they are attributes; it watches the child lists only).
+        const items = this.items();
+        if (this.awaitingItems && items.length) {
+            this.awaitingItems = false;
+            this.live = initialAccordionOpen(items.map(i => this.keyOf(i, items)), this.behaviourValue.defaultOn);
+            first = true;
+        }
+        const forced = this.options.forced?.() ?? new Set();
+        const own = this.options.rootId;
+        const rootId = (typeof own === 'function' ? own() : own) ?? this.root.getAttribute(SCOPE_ATTRIBUTE) ?? nodeIdOf(this.root);
+        const next = new Set();
+        items.forEach((item, index) => {
+            const key = this.keyOf(item, items);
+            const on = this.live.has(key) || forced.has(key);
+            if (on)
+                next.add(key);
+            this.stampItem(item, key, index, on, rootId, first);
+        });
+        const was = first ? new Set() : this.shown;
+        this.shown = next;
+        // On the first stamp an item open by default HAS opened: its `itemOn` listeners attached so far hear it
+        // (the builder renders an item's parts, and attaches their interactions, before its root's runtime; the
+        // live engine attaches the runtime first and its interactions run an already-open item's at once).
+        for (const item of items) {
+            const key = this.keyOf(item, items);
+            if (next.has(key) && !was.has(key))
+                dispatch(item, ITEM_ON_EVENT);
+            else if (!next.has(key) && was.has(key))
+                dispatch(item, ITEM_OFF_EVENT);
+        }
+    }
+    stampItem(item, key, index, on, rootId, first) {
+        const ids = accordionDomIds(rootId, key, this.kind);
+        if (!item.hasAttribute(ITEM_KEY_ATTRIBUTE))
+            item.setAttribute(ITEM_KEY_ATTRIBUTE, key);
+        setAttr(item, ON_ATTRIBUTE, on ? '' : null);
+        const button = this.own(item, BUTTON_SELECTOR);
+        const track = this.own(item, TRACK_SELECTOR);
+        const region = this.own(item, REGION_SELECTOR);
+        const panel = this.own(item, PANEL_SELECTOR);
+        setAttr(button, 'type', 'button');
+        setAttr(button, 'id', ids.trigger);
+        setAttr(button, 'aria-expanded', on ? 'true' : 'false');
+        setAttr(button, 'aria-controls', ids.panel);
+        setAttr(button, ON_ATTRIBUTE, on ? '' : null);
+        setAttr(track, ON_ATTRIBUTE, on ? '' : null);
+        setAttr(panel, ON_ATTRIBUTE, on ? '' : null);
+        const labelled = hasLabelledRegion(this.kind);
+        setAttr(region, 'role', labelled ? 'region' : null);
+        setAttr(region, 'id', ids.panel);
+        setAttr(region, 'aria-labelledby', labelled ? ids.trigger : null);
+        if (!region)
+            return;
+        const pending = this.closing.get(key);
+        if (on) {
+            if (pending) {
+                clearTimeout(pending);
+                this.closing.delete(key);
+            }
+            setAttr(region, 'hidden', null);
+            return;
+        }
+        if (region.hasAttribute('hidden') || pending)
+            return;
+        // Closing: the track collapses first (its transition), THEN the region is hidden — hiding it at once
+        // would collapse it with no motion. At first paint, or under reduced motion, it is hidden at once.
+        if (first || this.reduced()) {
+            setAttr(region, 'hidden', UNTIL_FOUND);
+            return;
+        }
+        const hide = () => {
+            this.closing.delete(key);
+            if (!item.hasAttribute(ON_ATTRIBUTE))
+                setAttr(region, 'hidden', UNTIL_FOUND);
+        };
+        this.closing.set(key, setTimeout(hide, this.closeDelay(track)));
+    }
+    closeDelay(track) {
+        try {
+            const view = track?.ownerDocument?.defaultView;
+            const raw = track && view ? view.getComputedStyle(track).transitionDuration : '';
+            const ms = Math.max(0, ...String(raw).split(',').map(s => (s.trim().endsWith('ms') ? parseFloat(s) : parseFloat(s) * 1000)).filter(n => !isNaN(n)));
+            return Math.min(MAX_CLOSE_MS, ms + 20);
+        }
+        catch {
+            return 0;
+        }
+    }
+    /** The element `selector` matches inside `item` that belongs to it, not to an item nested in it. */
+    own(item, selector) {
+        return Array.from(item.querySelectorAll(selector)).find(el => closestAccordionItem(el) === item) ?? null;
+    }
+    buttons() {
+        return this.items().map(i => this.own(i, BUTTON_SELECTOR)).filter((b) => !!b);
+    }
+}
+function dispatch(el, type) {
+    const Ctor = globalThis.CustomEvent;
+    if (Ctor)
+        el.dispatchEvent(new Ctor(type, { bubbles: false }));
+}
+/** Attach the runtime to one rendered composite root, unless it already runs one. Returns the NEW runtime, or
+ *  null when the root already had one (so a caller destroys only what it created). */
+function attachAccordionAt(root, options = {}) {
+    if (RUNTIMES.has(root))
+        return null;
+    return new AccordionRuntime(root, options);
+}
+/** Attach the runtime to every accordion under `container` that has none yet. Returns the new runtimes. */
+function attachAccordions(container, options = {}) {
+    const out = [];
+    container.querySelectorAll(ROOT_SELECTOR).forEach(root => {
+        const runtime = attachAccordionAt(root, options);
+        if (runtime)
+            out.push(runtime);
+    });
+    return out;
+}
+/** Detach a runtime `attachAccordions` created. */
+function detachAccordion(runtime) {
+    runtime.destroy();
+}
+/** Every live runtime by its root — the canvas's and the site's alike (a runtime registers itself and leaves on
+ *  destroy), so an item action finds the runtime of whatever item it targets. */
+const RUNTIMES = new WeakMap();
+const ROW_INDEX_ATTRIBUTE = 'data-iox-row-idx';
+/** The repeated rows an element sits in, outermost first — each row's index as its row wrappers stamp it
+ *  (`data-iox-row-idx`: the builder's Repeater rows, the engine's component path). The builder folds them into a
+ *  composite's scope id (`compositeScopeId`, vectoriox/iox-ui#20); the element itself is not counted. */
+function compositeRowKeys(el) {
+    const keys = [];
+    for (let at = el?.parentElement?.closest?.(`[${ROW_INDEX_ATTRIBUTE}]`); at; at = at.parentElement?.closest(`[${ROW_INDEX_ATTRIBUTE}]`)) {
+        keys.unshift(at.getAttribute(ROW_INDEX_ATTRIBUTE) ?? '');
+    }
+    return keys;
+}
+/** The runtime running a composite root, or null. */
+function accordionRuntimeOf(root) {
+    return (root && RUNTIMES.get(root)) || null;
+}
+// ── T14: open / close / toggle an item from anywhere ─────────────────────────────────────────────
+/** What an item action does to its target item (actions-core `openItem` / `closeItem` / `toggleItem`). */
+var CompositeItemAction;
+(function (CompositeItemAction) {
+    CompositeItemAction["Open"] = "open";
+    CompositeItemAction["Close"] = "close";
+    CompositeItemAction["Toggle"] = "toggle";
+})(CompositeItemAction || (CompositeItemAction = {}));
+/**
+ * Run an item action on the element of an ITEM (an accordion item, or a disclosure) — the `openItem` /
+ * `closeItem` / `toggleItem` interaction actions, on the canvas and on the live site through this one function.
+ * Returns whether the item shows open afterwards, or null when `el` is in no running composite.
+ */
+function runCompositeItemAction(el, action) {
+    const item = closestAccordionItem(el);
+    const runtime = item ? accordionRuntimeOf(rootOfItem(item)) : null;
+    if (!item || !runtime)
+        return null;
+    return runtime.run(action, runtime.keyOf(item));
+}
+/** How much of an opened item must already be on screen for the action NOT to scroll to it (its header row). */
+const VISIBLE_HEAD_PX = 48;
+/** True when an item an action just opened is out of view and the page should scroll to it (T14: "opens that item
+ *  and scrolls to it") — never when its head is already on screen, so a button beside it does not jolt the page. */
+function shouldScrollToItem(top, viewportHeight) {
+    return top < 0 || top + VISIBLE_HEAD_PX > viewportHeight;
+}
+
+/** The words a fresh disclosure starts with — generic, the author's to replace. */
+const DISCLOSURE_WORDS = {
+    more: 'Read more',
+    less: 'Read less',
+    body: 'Write the rest of the story here. It stays out of the way until someone asks for it.',
+};
+/** A disclosure's one item key — its root IS its item. */
+const DISCLOSURE_ITEM_KEY = 'k1';
+var Type$1;
+(function (Type) {
+    Type["Container"] = "Container";
+    Type["LinkedContainer"] = "LinkedContainer";
+    Type["Text"] = "Text";
+})(Type$1 || (Type$1 = {}));
+var Style$1;
+(function (Style) {
+    Style["Root"] = "box";
+    Style["Trigger"] = "accordion-trigger";
+    Style["Word"] = "body";
+    Style["Panel"] = "accordion-panel";
+    Style["Body"] = "body";
+})(Style$1 || (Style$1 = {}));
+const ZERO_BOX$1 = '0px 0px 0px 0px';
+const HIDDEN = 'none';
+const INHERIT = 'inherit';
+/** A word is a flex item of the toggle — `block` (never `inline`: the compiler drops a value equal to the CSS initial,
+ *  and the Text's own default would come back in its place). */
+const SHOWN = 'block';
+/** What each part holds — layout only; its LOOK is its element style. The trigger sizes to its words (a button in
+ *  the flow, not a full-width header row — `fit-content` keeps it from stretching) and the panel spans the root. The
+ *  trigger is `flex`, not `inline-flex`: it is a flex item of the root, which blockifies it on the site anyway. */
+const PART_BASE = {
+    [DisclosureRole.Disclosure]: { display: 'flex', flexDirection: 'column', width: '100%', minHeight: 'auto', height: 'auto' },
+    // The toggle reads the text around it (the page's body type, through the root) — a LinkedContainer is born with
+    // its own literal font, which an accordion's heading masks and a disclosure's words would show.
+    [DisclosureRole.Trigger]: {
+        display: 'flex', alignItems: 'center', gap: '8px', width: 'fit-content', minHeight: 'auto', height: 'auto', textAlign: 'start', cursor: 'pointer',
+        fontFamily: INHERIT, fontSize: INHERIT, fontWeight: INHERIT, lineHeight: INHERIT,
+    },
+    // A word is just its words: none of a Text's own box (its type's 10px padding, its full width) — the toggle's
+    // padding is the click target.
+    [DisclosureRole.More]: { display: SHOWN, margin: ZERO_BOX$1, padding: ZERO_BOX$1, width: 'auto' },
+    [DisclosureRole.Less]: { display: HIDDEN, margin: ZERO_BOX$1, padding: ZERO_BOX$1, width: 'auto' },
+    [DisclosureRole.Panel]: { display: 'block', width: '100%', minHeight: 'auto', height: 'auto' },
+};
+const BODY_BASE = { margin: ZERO_BOX$1, padding: ZERO_BOX$1, minHeight: 'auto' };
+function make$1(create, key, type, role, style, props, label) {
+    return makeCompositePart(create, { key, type, props, elementStyle: style }, role, label, role ? PART_BASE[role] : undefined);
+}
+/** One of the trigger's two words: shown while the disclosure is closed (`more`) or open (`less`). */
+function buildWord(create, role, words, rootId) {
+    const node = make$1(create, role === DisclosureRole.More ? 'more' : 'less', Type$1.Text, role, Style$1.Word, { content: words, tag: 'span' }, 'Text');
+    node.stateStyles = { ...(node.stateStyles ?? {}), [ITEM_OPEN_STATE]: { display: role === DisclosureRole.More ? HIDDEN : SHOWN } };
+    if (rootId)
+        node.stateTriggers = { ...(node.stateTriggers ?? {}), [ITEM_OPEN_STATE]: rootId };
+    return node;
+}
+/** A fresh Disclosure: "Read more" opens the text below and reads "Read less" while it is open; closed by default. */
+function buildDisclosureRecipe(create, options = {}) {
+    const words = { ...DISCLOSURE_WORDS, ...(options.words ?? {}) };
+    const root = make$1(create, 'disclosure', Type$1.Container, DisclosureRole.Disclosure, Style$1.Root, {}, 'Disclosure');
+    root.itemKey = DISCLOSURE_ITEM_KEY;
+    writeProp(root, CompositeBehaviourTrait.DefaultOn, options.open ? AccordionDefaultOn.First : AccordionDefaultOn.None);
+    const icon = options.icon ?? AccordionIcon.Chevron;
+    const trigger = make$1(create, 'trigger', Type$1.LinkedContainer, DisclosureRole.Trigger, Style$1.Trigger, {}, 'Toggle');
+    trigger.children = [
+        buildWord(create, DisclosureRole.More, words.more, root.id),
+        buildWord(create, DisclosureRole.Less, words.less, root.id),
+        ...(icon === AccordionIcon.None ? [] : [buildCompositeIcon(create, 'icon', icon, root.id, DisclosureRole.Icon)]),
+    ];
+    const panel = make$1(create, 'panel', Type$1.Container, DisclosureRole.Panel, Style$1.Panel, {}, 'Panel');
+    const body = make$1(create, 'body', Type$1.Text, null, Style$1.Body, { content: words.body, tag: 'p' }, 'Text');
+    writeStyles(body, BODY_BASE);
+    panel.children = [body];
+    root.children = [trigger, panel];
+    return root;
+}
+/** Behaviour ▸ Open by default (a disclosure: on or off). */
+function disclosureOpenByDefault(root) {
+    return accordionBehaviour(root).defaultOn !== AccordionDefaultOn.None;
+}
+
 /**
  * BADGE + CHIP (composite T25; complex-components board 8). A Badge is a Container wearing
  * `badge-<tone>` › Icon + Text; its TONE is its element style, so Badge ▸ Tone writes the style and
@@ -656,6 +1844,19 @@ const COMPOSITE_ROLE_SPECS = {
     [CardRole.Title]: { parent: CardRole.Content, locked: true },
     [CardRole.Text]: { parent: CardRole.Content, part: CardPart.Text },
     [CardRole.Actions]: { parent: CardRole.Content, part: CardPart.Actions },
+    // CC2 — an item always keeps its header and its panel; the icon is Behaviour ▸ Icon's.
+    [AccordionRole.Accordion]: { parent: null },
+    [AccordionRole.Item]: { parent: AccordionRole.Accordion },
+    [AccordionRole.Trigger]: { parent: AccordionRole.Item, locked: true },
+    [AccordionRole.Panel]: { parent: AccordionRole.Item, locked: true },
+    [AccordionRole.Icon]: { parent: AccordionRole.Trigger },
+    // CC2.1 — a disclosure always keeps its toggle and its panel; the words and the icon are the author's.
+    [DisclosureRole.Disclosure]: { parent: null },
+    [DisclosureRole.Trigger]: { parent: DisclosureRole.Disclosure, locked: true },
+    [DisclosureRole.Panel]: { parent: DisclosureRole.Disclosure, locked: true },
+    [DisclosureRole.More]: { parent: DisclosureRole.Trigger },
+    [DisclosureRole.Less]: { parent: DisclosureRole.Trigger },
+    [DisclosureRole.Icon]: { parent: DisclosureRole.Trigger },
 };
 var StructureEdit;
 (function (StructureEdit) {
@@ -693,7 +1894,9 @@ function isLockedPart(node) {
  * @vectoriox/iox-ui/composite-core — composites built from the builder's own parts (composite-components
  * plan §3a). FRAMEWORK-FREE: the builder, the SSR engine and iox-cms (generation-core's composer, the site
  * build) read the same recipes, roles and structure rules. Card v2 + Badge / Chip (T23 / T25) are the
- * first; Accordion and Tabs join with their own phases.
+ * first; the Accordion (CC2) adds the first composite RUNTIME (accordion-runtime.ts — DOM only, no
+ * framework), which the Disclosure (CC2.1) runs too — a one-item accordion whose root is its item; Tabs join with
+ * their own phase.
  * ⚠️ Consumers wire the usual trio — ng-package raw-ts assets, jest moduleNameMapper, tsconfig paths.
  */
 
@@ -701,5 +1904,5 @@ function isLockedPart(node) {
  * Generated bundle index. Do not edit.
  */
 
-export { BADGE_TONES, BADGE_TONE_ICONS, BadgeTone, CARD_LAYOUTS, CARD_LAYOUT_CUSTOM, CARD_PARTS, CARD_PART_ROLE, CARD_STACK_BREAKPOINT, CARD_WORDS, CHIP_ICON, CHIP_STYLE, COMPOSITE_ROLE_SPECS, CardLayout, CardPart, CardRole, PILL_LABEL_STYLE, StructureEdit, StructureRefusal, applyCardLayout, badgeStyleId, badgeToneOf, buildBadge, buildCardRecipe, buildChip, cardPartsOf, cardRootOf, cardTitleOf, clearLayerStyles, detectCardLayout, findByRole, isCardLinked, isCardRoot, isLockedPart, isPillNode, parentInComposite, readLayerStyle, readProp, readStyle, removeFromComposite, setBadgeTone, setCardLinked, setCardPart, structureRefusal, walkComposite, writeLayerStyles, writeProp, writeStyles };
+export { ACCORDION_BIND_PROP, ACCORDION_CONTENT_LIMIT, ACCORDION_DEFAULT_ONS, ACCORDION_ICONS, ACCORDION_ICON_GLYPH, ACCORDION_NEW_ITEM_WORDS, ACCORDION_WORDS, AccordionClass, AccordionDefaultOn, AccordionEditRefusal, AccordionIcon, AccordionKeyAction, AccordionRole, AccordionRuntime, BADGE_TONES, BADGE_TONE_ICONS, BadgeTone, CARD_LAYOUTS, CARD_LAYOUT_CUSTOM, CARD_PARTS, CARD_PART_ROLE, CARD_STACK_BREAKPOINT, CARD_WORDS, CHIP_ICON, CHIP_STYLE, COMPOSITE_ATTRIBUTE, COMPOSITE_KIND_ROLES, COMPOSITE_ROLE_SPECS, CardLayout, CardPart, CardRole, CompositeBehaviourTrait, CompositeItemAction, CompositeKind, DEFAULT_ON_ATTRIBUTE, DISCLOSURE_ITEM_KEY, DISCLOSURE_WORDS, DisclosureRole, ITEM_KEY_ATTRIBUTE, ITEM_OFF_EVENT, ITEM_ON_EVENT, ITEM_OPEN_STATE, MULTIPLE_ATTRIBUTE, ON_ATTRIBUTE, ON_STATE, PILL_LABEL_STYLE, SCOPE_ATTRIBUTE, StructureEdit, StructureRefusal, UNTIL_FOUND, accordionAnswerOf, accordionBehaviour, accordionDomIds, accordionFocusIndex, accordionHeadingLevel, accordionItemAttributes, accordionItemLabel, accordionItemOf, accordionItemState, accordionItems, accordionKeyAction, accordionPanelAttributes, accordionPanelOf, accordionPartStyle, accordionQuestionOf, accordionRegionAttributes, accordionRemovalRefusal, accordionRootAttributes, accordionRootOf, accordionRuntimeOf, accordionScope, accordionToContent, accordionToManual, accordionTrackAttributes, accordionTriggerAttributes, accordionTriggerOf, addAccordionItem, applyCardLayout, attachAccordionAt, attachAccordions, badgeStyleId, badgeToneOf, buildAccordionItem, buildAccordionRecipe, buildBadge, buildCardRecipe, buildChip, buildCompositeIcon, buildDisclosureRecipe, cardPartsOf, cardRootOf, cardTitleOf, clearLayerStyles, closeAccordionItem, closestAccordion, closestAccordionItem, compositeItemOf, compositeItems, compositeKindOfRole, compositeRootOf, compositeRowKeys, compositeScopeId, detachAccordion, detectAccordionIcon, detectCardLayout, disclosureOpenByDefault, domSafeKey, findByRole, hasLabelledRegion, initialAccordionOpen, isAccordionFromContent, isAccordionItemOn, isAccordionPart, isAccordionRoot, isCardLinked, isCardRoot, isCompositeItem, isCompositePanel, isCompositeRoot, isCompositeTrigger, isDisclosurePart, isDisclosureRoot, isLockedPart, isPillNode, itemOpenTriggerIds, makeCompositePart, moveAccordionItem, nextAccordionState, nextItemKey, onAccordionItemState, openAccordionItem, parentInComposite, pickAccordionAutoBinds, readLayerStyle, readProp, readStyle, removeFromComposite, renameAccordionItem, rowItemKey, runCompositeItemAction, serializeDomAttributes, setAccordionBehaviour, setAccordionIcon, setBadgeTone, setCardLinked, setCardPart, shouldScrollToItem, structureRefusal, walkComposite, writeLayerStyles, writeProp, writeStyles };
 //# sourceMappingURL=vectoriox-iox-ui-composite-core.mjs.map