@vectoriox/iox-ui 5.35.0 → 5.37.0

package/generation-core/index.d.ts

@@ -87,7 +87,7 @@ declare const SPEC_SITE_PLAN_SHAPE: {
     readonly section: {
         readonly pattern: "string — a non-global pattern id";
         readonly "slots?": "{ [slot]: string } — the pattern's declared slots";
-        readonly "binding?": "string — the list source a pattern's $binding repeater iterates (exactly when it has one)";
+        readonly "binding?": "string — the list source a pattern's $binding repeater iterates (exactly when it has one); a $binding? pattern (faq.accordion) MAY take one — then its items come from that content";
         readonly "without?": "string[] — the pattern's optional parts to leave out";
     };
     readonly globals: {
@@ -813,6 +813,45 @@ declare const SPEC_SITE_PATTERNS: {
             }];
         };
     };
+    readonly "faq.accordion": {
+        readonly family: "faq";
+        readonly label: "FAQ — questions that open";
+        readonly node: {
+            readonly t: "Section";
+            readonly es: "section";
+            readonly c: readonly [{
+                readonly t: "Container";
+                readonly es: "box";
+                readonly lay: {
+                    readonly display: "flex";
+                    readonly flexDirection: "column";
+                    readonly gap: "14px";
+                    readonly maxWidth: "860px";
+                    readonly width: "100%";
+                    readonly margin: "0px auto 0px auto";
+                };
+                readonly c: readonly [{
+                    readonly t: "Text";
+                    readonly es: "eyebrow";
+                    readonly slot: "eyebrow";
+                    readonly ph: "copy";
+                    readonly text: "FAQ";
+                }, {
+                    readonly t: "Heading";
+                    readonly es: "h2";
+                    readonly level: "h2";
+                    readonly slot: "title";
+                    readonly ph: "copy";
+                    readonly text: "Questions people ask";
+                }, {
+                    readonly t: "Container";
+                    readonly recipe: "accordion";
+                    readonly src: "$binding?";
+                    readonly ph: "copy";
+                }];
+            }];
+        };
+    };
 };
 declare const SPEC_SITE_TEMPLATES: {
     readonly studio: {
@@ -1206,7 +1245,10 @@ interface PatternNode {
 }
 /** The composite-core recipes a pattern may stamp (`recipe`). */
 declare enum PatternRecipe {
-    Card = "card"
+    Card = "card",
+    /** CC2: the Accordion — Manual (three placeholder items), or From content when the section names a list
+     *  `binding` (`src: '$binding?'`): one template item bound to the type's question / answer fields. */
+    Accordion = "accordion"
 }
 /** A recipe node's `binds` keys → the part each binds (Card v2). */
 declare enum CardBindTarget {
@@ -1240,6 +1282,8 @@ declare enum PatternPlaceholder {
 declare enum PatternDirective {
     /** A Repeater's source: the section's `binding`. */
     Binding = "$binding",
+    /** The section MAY name a list `binding` (faq.accordion): with one, the recipe's items come from it. */
+    OptionalBinding = "$binding?",
     /** `each`: one plain node per page of the plan that is in the navigation (`inNav`), in plan order —
      *  words and routes written in, editable on the canvas (W1.1). */
     NavPages = "$navPages",
@@ -1266,6 +1310,8 @@ declare function patternSlots(pattern: SitePattern): string[];
 declare function patternOptionalParts(pattern: SitePattern): string[];
 /** True when the pattern has a Repeater iterating the section's `binding`. */
 declare function patternNeedsBinding(pattern: SitePattern): boolean;
+/** True when the pattern may take a section `binding` — it needs one, or names `$binding?` (CC2). */
+declare function patternTakesBinding(pattern: SitePattern): boolean;
 /** The scopes whose ITEM a pattern's bound Images take their alt text from (an Image that names no `alt`
  *  of its own): `item` (the row of a `$binding` Repeater — the section's list), `route` or `next`. Each
  *  needs a content type with a `previewTextField` (W1.1, Q7). */
@@ -1331,6 +1377,10 @@ interface SerializedNode {
     /** The part this node plays in a composite (composite-core: `card.title`; a navigation's `nav.drawer`,
      *  written by `planNavShape`). Additive; a node without one is a plain node. */
     role?: string;
+    /** An item's identity inside its composite (CC2: an Accordion item's `k1`…). Additive. */
+    itemKey?: string;
+    /** A targeted state's driving node (CC2: an icon's `trigger-on` → its item). */
+    stateTriggers?: Partial<Record<string, string>>;
     bindings: SerializedBinding[];
     interactions: unknown[];
     isGlobal?: boolean;
@@ -1657,5 +1707,5 @@ interface AddBarItemResult {
  */
 declare function addBarItem(globals: ReadonlyArray<SerializedNode>, options?: Pick<NavShapeOptions, 'newId'>): AddBarItemResult;
 
-export { BAR_ITEMS_MAX, BAR_ITEMS_MIN, BASELINE_ROLES, BaselineRole, BindScope, CardBindTarget, ComposeError, ComposeIssueCode, DANGLING_LINK_CODES, DEFAULT_PHONE_MENU_BREAKPOINT, FACT_KEYS, GlobalSlot, NAV_PART_LABELS, NAV_SHAPE_COPY, NEUTRAL_STYLE_PROPS, NODE_BASELINES, NavRole, NavShape, NavShapeError, PatternDirective, PatternGlobalPosition, PatternPlaceholder, PatternRecipe, PhoneMenuBreakpoint, PlaceholderKind, PlanDataSourceMode, PlanDataSourceType, RelativeOp, SAMPLE_IMAGE_REF, SITE_FACT_LABELS, SITE_PATTERNS, SITE_PLAN_VERSION, SITE_TEMPLATES, SPEC_SITE_FACTS, SPEC_SITE_PATTERNS, SPEC_SITE_PLAN_SHAPE, SPEC_SITE_TEMPLATES, STUDIO_TEMPLATE, SitePlanError, SitePlanIssueCode, SitePlanSourceKind, SiteTemplateError, SiteTemplateId, addBarItem, altSourceScopes, assertStyleSlots, assertValidSitePlan, barIconForRoute, composeSite, createSerializedNode, findNavRoot, navPages, navShapeBreakpoint, navShapeOf, nextSourceOf, nodeBindPaths, parseSampleImageRef, patternById, patternNeedsBinding, patternNodes, patternOptionalParts, patternScopes, patternSlots, planFromTemplate, planNavShape, releasedLayoutDefaults, requiredShapeKeys, routeParams, sampleImageRef, setStyleProps, shapeKeys, validateSitePlan, walkSerialized };
+export { BAR_ITEMS_MAX, BAR_ITEMS_MIN, BASELINE_ROLES, BaselineRole, BindScope, CardBindTarget, ComposeError, ComposeIssueCode, DANGLING_LINK_CODES, DEFAULT_PHONE_MENU_BREAKPOINT, FACT_KEYS, GlobalSlot, NAV_PART_LABELS, NAV_SHAPE_COPY, NEUTRAL_STYLE_PROPS, NODE_BASELINES, NavRole, NavShape, NavShapeError, PatternDirective, PatternGlobalPosition, PatternPlaceholder, PatternRecipe, PhoneMenuBreakpoint, PlaceholderKind, PlanDataSourceMode, PlanDataSourceType, RelativeOp, SAMPLE_IMAGE_REF, SITE_FACT_LABELS, SITE_PATTERNS, SITE_PLAN_VERSION, SITE_TEMPLATES, SPEC_SITE_FACTS, SPEC_SITE_PATTERNS, SPEC_SITE_PLAN_SHAPE, SPEC_SITE_TEMPLATES, STUDIO_TEMPLATE, SitePlanError, SitePlanIssueCode, SitePlanSourceKind, SiteTemplateError, SiteTemplateId, addBarItem, altSourceScopes, assertStyleSlots, assertValidSitePlan, barIconForRoute, composeSite, createSerializedNode, findNavRoot, navPages, navShapeBreakpoint, navShapeOf, nextSourceOf, nodeBindPaths, parseSampleImageRef, patternById, patternNeedsBinding, patternNodes, patternOptionalParts, patternScopes, patternSlots, patternTakesBinding, planFromTemplate, planNavShape, releasedLayoutDefaults, requiredShapeKeys, routeParams, sampleImageRef, setStyleProps, shapeKeys, validateSitePlan, walkSerialized };
 export type { AddBarItemResult, CmsDataSourcePlan, ComposeContext, ComposeIssue, ComposedDataSource, ComposedItem, ComposedPage, ComposedPlaceholder, ComposedRoute, ComposedSite, ContentFieldPlan, ContentSeedPlan, ContentTypePlan, CreateNodeOptions, DataSourcePlan, FactKey, NavPage, NavShapeOptions, NavShapeResult, NodeBaseline, PagePlan, PageSectionPlan, PatternNode, RelativeDataSourcePlan, SerializedBinding, SerializedNode, SerializedResponsive, SiteBusiness, SitePattern, SitePlan, SitePlanIssue, SitePlanSource, SitePlanValidation, SiteTemplate, TemplatePlanInput };

package/index.d.ts

@@ -379,7 +379,7 @@ declare class BuilderHeadingComponent implements OnInit {
     private isBound;
     private syncTraitToPanel;
     static ɵfac: i0.ɵɵFactoryDeclaration<BuilderHeadingComponent, [{ optional: true; }, null, { optional: true; }]>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<BuilderHeadingComponent, "h1[iox-heading],h2[iox-heading],h3[iox-heading],h4[iox-heading],h5[iox-heading],h6[iox-heading]", never, { "content": { "alias": "content"; "required": false; }; "level": { "alias": "level"; "required": false; }; "nodeId": { "alias": "nodeId"; "required": false; }; "node": { "alias": "node"; "required": false; }; "linkType": { "alias": "linkType"; "required": false; }; "url": { "alias": "url"; "required": false; }; "pageRoute": { "alias": "pageRoute"; "required": false; }; "target": { "alias": "target"; "required": false; }; }, {}, never, never, false, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<BuilderHeadingComponent, "h1[iox-heading],h2[iox-heading],h3[iox-heading],h4[iox-heading],h5[iox-heading],h6[iox-heading],span[iox-heading]", never, { "content": { "alias": "content"; "required": false; }; "level": { "alias": "level"; "required": false; }; "nodeId": { "alias": "nodeId"; "required": false; }; "node": { "alias": "node"; "required": false; }; "linkType": { "alias": "linkType"; "required": false; }; "url": { "alias": "url"; "required": false; }; "pageRoute": { "alias": "pageRoute"; "required": false; }; "target": { "alias": "target"; "required": false; }; }, {}, never, never, false, never>;
 }
 
 interface EditableNode {
@@ -447,7 +447,11 @@ declare class ContainerComponent {
     static ɵcmp: i0.ɵɵComponentDeclaration<ContainerComponent, "div[iox-container],section[iox-container],article[iox-container],header[iox-container],footer[iox-container],main[iox-container],nav[iox-container],ul[iox-container],ol[iox-container],li[iox-container]", never, { "nodeId": { "alias": "nodeId"; "required": false; }; }, {}, never, never, false, never>;
 }
 
-/** Directive-host linked container: the `<a>` IS the host — no wrapper, no inner/outer split. */
+/**
+ * Directive-host linked container: the `<a>` IS the host — no wrapper, no inner/outer split. An Accordion's
+ * HEADER (CC2, role `accordion.trigger`) is created on a `<button>` instead — a button that opens its item,
+ * never a link; the engine puts it inside the `<hN>` its question's level names.
+ */
 declare class LinkedContainerComponent implements OnInit, OnDestroy {
     private elRef;
     private isPreview;
@@ -461,9 +465,11 @@ declare class LinkedContainerComponent implements OnInit, OnDestroy {
     constructor(elRef: ElementRef<HTMLElement>, isPreview: boolean);
     ngOnInit(): void;
     ngOnDestroy(): void;
+    /** True when created on a <button> (an Accordion header) — it never navigates. */
+    get isButton(): boolean;
     get resolvedHref(): string;
     static ɵfac: i0.ɵɵFactoryDeclaration<LinkedContainerComponent, [null, { optional: true; }]>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<LinkedContainerComponent, "a[iox-linked-container]", never, { "nodeId": { "alias": "nodeId"; "required": false; }; "linkType": { "alias": "linkType"; "required": false; }; "url": { "alias": "url"; "required": false; }; "pageRoute": { "alias": "pageRoute"; "required": false; }; "target": { "alias": "target"; "required": false; }; }, {}, never, never, false, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<LinkedContainerComponent, "a[iox-linked-container],button[iox-linked-container]", never, { "nodeId": { "alias": "nodeId"; "required": false; }; "linkType": { "alias": "linkType"; "required": false; }; "url": { "alias": "url"; "required": false; }; "pageRoute": { "alias": "pageRoute"; "required": false; }; "target": { "alias": "target"; "required": false; }; }, {}, never, never, false, never>;
 }
 
 /**
@@ -1515,12 +1521,24 @@ declare function statePseudoClass(state: string): string;
  * so the look and the announcement are one fact.
  */
 declare enum ComponentState {
-    Current = "current"
-}
-/** The attribute selector each component state compiles to. */
+    Current = "current",
+    /** A composite part that IS on — an open accordion item, its header, its panel (board 9 "Open"). */
+    On = "on",
+    /** A part INSIDE an item, styled by its item being open (board 9 "Item open") — a TARGETED state: its
+     *  trigger is the item (`stateTriggers['trigger-on']`), compiled through `targetedStateSelector`. */
+    ItemOpen = "trigger-on"
+}
+/** The attribute selector each (non-targeted) component state compiles to. */
 declare const COMPONENT_STATE_SELECTOR: Readonly<Record<string, string>>;
-/** The component states a type offers in the Style panel's "Component state" group. */
-declare function componentStatesFor(type: string | null | undefined): ComponentState[];
+/** The composite roles that are themselves "on" when their item is open (they carry `data-iox-on`): an accordion's
+ *  item, header and panel; a disclosure (its own item), its toggle and its panel (CC2.1). The main entry does not
+ *  import composite-core, so the roles are spelled here — `style-compiler.spec` pins them to its enums. */
+declare const ON_STATE_ROLES: ReadonlyArray<string>;
+/**
+ * The component states a node offers in the Style panel's "Component state" group: Current page (a link),
+ * Open (an accordion's item, header or panel), Item open (any other part inside an item — `insideItem`).
+ */
+declare function componentStatesFor(type: string | null | undefined, role?: string | null, insideItem?: boolean): ComponentState[];
 /**
  * What follows `.iox-node-<id>` in a stored state's rule: `:hover`, `:focus-visible`, or a component
  * state's attribute selector (`[aria-current="page"]`). Shared by the builder canvas and both engine paths.
@@ -1697,6 +1715,20 @@ declare function nearestCommonAncestorId(root: readonly StyleTreeNode[], styledC
  * `scopeCssId` MUST be a value returned by `nearestCommonAncestorId` for the same pair.
  */
 declare function buildTargetedStateSelector(scopeCssId: string, triggerCssId: string, styledCssId: string, base: string): string;
+/**
+ * The same three topologies for any trigger SUFFIX — a pseudo-class (`:hover`) or an attribute the renderers
+ * write (`[data-iox-on]`, CC2's "Item open").
+ */
+declare function buildTargetedSuffixSelector(scopeCssId: string, triggerCssId: string, styledCssId: string, suffix: string): string;
+/**
+ * The targeted states and what follows the TRIGGER's class in each: `trigger-hover` — the chosen element is
+ * hovered; `trigger-on` — the chosen item is open (CC2: an Icon turns when ITS item opens; the trigger is the
+ * item, an ancestor, so the rule is `.item[data-iox-on] .icon`). Shared by the builder canvas and both
+ * engine paths.
+ */
+declare const TARGETED_STATE_SUFFIX: Readonly<Record<string, string>>;
+/** The selector body of a targeted state's rule, or null for a state that is not targeted. */
+declare function targetedStateSelector(state: string, scopeCssId: string, triggerCssId: string, styledCssId: string): string | null;
 
 /**
  * parts — the failure design (forms-and-inputs-plan.md Part 2, board 7). A compound component
@@ -2069,9 +2101,26 @@ interface DataSourceQueryFilter {
      *  fallback too. An empty default with no query-param value means the filter is DROPPED. */
     defaultValue?: string;
 }
+/** The order a query source returns its rows in (CC2, board 4 "Sort" — the data source popover). */
+declare enum DataSourceSortDir {
+    Asc = "asc",
+    Desc = "desc"
+}
+interface DataSourceSort {
+    /** A field of the content type (a dot path into a nested object is allowed). */
+    field?: string;
+    dir?: DataSourceSortDir | `${DataSourceSortDir}`;
+}
+/** The query parameter carrying the order: `sort=order` ascending, `sort=-order` descending. A CONTROL like
+ *  `limit`, not a field filter — the public controllers split it out (iox-cms `query-controls.ts`). */
+declare const SORT_PARAM = "sort";
+/** `sort`'s wire value, or null when the source sets no (valid) order. */
+declare function sortParamValue(sort: DataSourceSort | null | undefined): string | null;
 interface DataSourceRequestSpec {
     contentType?: string;
     limit?: number;
+    /** A query source's order (CC2). Absent = the backend's natural order, as before. */
+    sort?: DataSourceSort;
     filterByRouteParam?: DataSourceRouteFilter;
     filterByQueryParams?: DataSourceQueryFilter[];
 }
@@ -2106,6 +2155,7 @@ type DataSourcePlan = {
     resource: string;
     filter: Record<string, any>;
     limit?: number;
+    sort?: string;
     mode: DataSourceMode;
 } | {
     kind: 'external';
@@ -3167,5 +3217,5 @@ declare class GalleryLoop {
     private emit;
 }
 
-export { A11yAttribute, A11yTrait, ACCESSIBLE_NAME_TYPES, AOSService, ARIA_CURRENT_PAGE, BACKDROP_TWIN_KEY, BACKDROP_WHOLE_KEY, BREAKPOINTS, Breakpoint, BreakpointQueryKind, BuilderButtonComponent, BuilderDividerComponent, BuilderHeadingComponent, BuilderIconComponent, BuilderImageComponent, BuilderLinkComponent, BuilderSpacerComponent, ButtonBlockComponent, COMPONENT_STATE_SELECTOR, CONTAINER_HTML_TAGS, CONTEXT_ACTION_TYPES, CURRENT_LINK_TYPES, CardComponent, ClientGalleryComponent, ClientListComponent, ClientListItemComponent, ClientRepeaterComponent, ClientSliderContainerComponent, ClientSliderSlideComponent, ComponentInstanceRegistryService, ComponentState, ContainerComponent, ContextStore, DECORATIVE_TYPES, DEFAULT_GALLERY_SCHEDULER, DEFAULT_PAGE_TRANSITION, DEFAULT_PAGE_TRANSITION_DURATION, DEFAULT_PAGE_TRANSITION_EASING, DEFAULT_PAGE_TRANSITION_PERSPECTIVE, DEFAULT_PHOSPHOR_WEIGHT, DEFAULT_WIDTH_BY_TYPE, DIALOG_CLOSE_ABOVE_ATTRIBUTE, DIALOG_NODE_TYPE, DeclarationContext, ENTRANCE_ACTION_TYPES, EXIT_ACTION_TYPES, FormRenderState, FormRuntimeService, GALLERY_EFFECTS, GALLERY_EFFECT_DESCRIPTORS, GalleryLoop, HOVER_DEFAULT_TRANSITION, HOVER_STATES, INTERACTION_HIDDEN_ATTRIBUTE, IOX_BUILDER_EVENTS, IOX_FORM_MESSAGES, IOX_FORM_NAVIGATOR, IOX_FORM_TRANSPORT, IS_PREVIEW, IoxAnimateContainer, IoxAosDirective, IoxAosModule, IoxBuilderComponentsModule, IoxComponentRegistryService, IoxDialogComponent, IoxFieldComponent, IoxFormComponent, IoxFormErrorComponent, IoxFormSuccessComponent, IoxPageComponent, IoxPageModule, IoxSubmitButtonComponent, IoxUiModule, LEGACY_DIRECTION_KEY, LEGACY_HOVER_TRANSITION, LinkedContainerComponent, MANAGED_A11Y_ATTRIBUTES, MAX_LINES_KEY, PAGE_STYLE_TOKENS, PAGE_TOKEN_FALLBACKS, PAGE_TRANSITION_CATEGORIES, PAGE_TRANSITION_PRESETS, PART_CLASS_NAMES, PIPE_DESCRIPTORS, PIPE_REGISTRY, PageScrollProvider, PageStyleField, PageStyleSource, REDUCED_MOTION_QUERY, RESERVED_ALIAS_PREFIX, STATE_PSEUDO_CLASS, SUPPRESSED_STYLE_PROPS_BY_TYPE, SWIPER_A11Y_OPTIONS, SWIPER_RESPONSIVE_TRAITS, SectionComponent, SwiperModuleName, TEXT_ALIGN_KEY, TEXT_DIRECTION_KEY, TRANSITION_FEELS, TextAlign, TextBlockComponent, VALIDATION_STATES, VALIDATION_STATE_CLASS, VIRTUAL_TRAIT_GROUPS, VIRTUAL_TRAIT_KEYS, ViewPositionDirective, ViewPositionModule, VisibilityActionType, activeActions, applyBindingPipes, applyFeel, breakpointDef, breakpointForWidth, breakpointQueryFor, buildDataSourceFilter, buildInteractionKeyframes, buildPartSelector, buildRelatedFilter, buildSwiperBreakpoints, buildTargetedStateSelector, buildTransitionTimeline, cascadeChain, clearInputOverride, clearOverride, closeAboveMediaQuery, collectContextSlotKeys, collectReferencedAliases, compileDeclarations, compilePageStyle, componentStatesFor, composeVirtualTraits, computeRelative, containerHtmlTag, contextActionEffect, contextSlotKeys, countOverrides, dataSourcePlanToRequest, declaredInputNames, decomposeBackdropFilter, defaultHoverTransition, defaultMessageResolver, deriveSeoFromContent, describePageStyle, describeSeoFields, dialogCloseAboveMinWidth, effectiveActionType, effectiveTransitionId, entrancePreStateStyle, excludeSelf, feelFor, finalKeyframe, getByPath, getSeoValue, hasHoverState, hasOwnTransition, initialSlotValues, isActionEnabled, isContextAction, isCurrentLink, isExternalOrFragment, isGradientPaint, isInputOverriddenAt, isOverriddenAt, isReservedAlias, isValidSlotKey, isWholeBackdropSet, keyframePropertyName, keyframeStyleEntries, legacyEnterToTransition, matchRouteParams, mediaQueryFor, mergeSwiperBreakpoints, migrateLegacyDirection, migrateLegacyTextAlign, motionAllowed, nearestCommonAncestorId, needsAccessibleName, nodeA11yAttributes, nodeCssId, nodeTraitValue, nodeUsesContext, normalizeAppPath, normalizeCollectionResult, normalizeGalleryImage, normalizeIconClass, parentBreakpoint, parseUrlList, partClassName, planDataSource, planResponsiveRules, prefersReducedMotion, referencedDataSources, referencedDataSourcesDeep, renderDefaultDeclarations, resetPageStyleField, resetSeoField, resolveBoundValue, resolveContextValue, resolveDerivedInto, resolveGalleryEffect, resolveGalleryUrls, resolveInputChain, resolveInputs, resolvePageTransition, resolvePath, resolveRelativeInto, resolveRepeaterItems, resolveSeo, resolveSiblings, resolveSingleItemId, resolveStateStyles, resolveStyleProps, resolveToggleVisibility, resolveValueChain, rewriteViewportUnits, safeSetInput, serializeA11yAttributes, setInputOverride, setOverride, setSeoAuto, setSeoBinding, setSeoOverride, setSeoValue, stateNamesIn, statePseudoClass, stateSelectorSuffix, stripSuppressedProps, swiperAutoplayAllowed, swiperModuleNames, syncNodeA11yAttributes, variableAliases, variableItemsFrom, withContextSlots, withDefaultHoverTransition, wrapInBreakpointQuery, wrapInMediaQuery };
-export type { A11yNodeSource, BoundValueSpec, BreakpointDef, BuildRelatedFilterOptions, ContextActionEffect, ContextActionLike, ContextItemRef, ContextSlotDefault, ContextValueSpec, ContextWriteScope, CurrentLinkOptions, DataSourceDomain, DataSourceEndpoints, DataSourceMode, DataSourcePlan, DataSourceQueryFilter, DataSourceRequest, DataSourceRequestSpec, DataSourceRouteFilter, DataSourceSpec, FormMessageResolver, GalleryBoundSource, GalleryDurations, GalleryEffect, GalleryEffectDescriptor, GalleryImage, GalleryLoopOptions, GalleryLoopScheduler, GalleryLoopState, GallerySlideState, IBuilderEventEmitter, InputMap, InteractionKeyframe, IoxContextSlot, IoxPipe, MatchMediaHost, NodeA11yContext, OverrideBreakpoint, PageStyleFieldState, PageStyleOptions, PageStyleSettings, PageTransitionCategory, PageTransitionCategoryMeta, PageTransitionOptions, PageTransitionPreset, PipeArgSpec, PipeContext, PipeDescriptor, RelativeInputs, RelativeSourceKind, RelativeSourceSpec, ResolveSiblingsOptions, ResolvedPageTransition, ResponsiveLayer, ResponsiveOverrides, ResponsiveRuleSet, RouteContext, SeoDerivedContent, SeoFieldSource, SeoFieldState, SeoResolveContext, SetContextParams, SiblingsResult, StateStyleMap, StyleMap, StyleTreeNode, SwiperBreakpointMap, SwiperModuleFlags, ToggleableAction, TransitionFeel, TransitionPhase, TransitionTimelineInput, ValueSource, VirtualTraitGroup };
+export { A11yAttribute, A11yTrait, ACCESSIBLE_NAME_TYPES, AOSService, ARIA_CURRENT_PAGE, BACKDROP_TWIN_KEY, BACKDROP_WHOLE_KEY, BREAKPOINTS, Breakpoint, BreakpointQueryKind, BuilderButtonComponent, BuilderDividerComponent, BuilderHeadingComponent, BuilderIconComponent, BuilderImageComponent, BuilderLinkComponent, BuilderSpacerComponent, ButtonBlockComponent, COMPONENT_STATE_SELECTOR, CONTAINER_HTML_TAGS, CONTEXT_ACTION_TYPES, CURRENT_LINK_TYPES, CardComponent, ClientGalleryComponent, ClientListComponent, ClientListItemComponent, ClientRepeaterComponent, ClientSliderContainerComponent, ClientSliderSlideComponent, ComponentInstanceRegistryService, ComponentState, ContainerComponent, ContextStore, DECORATIVE_TYPES, DEFAULT_GALLERY_SCHEDULER, DEFAULT_PAGE_TRANSITION, DEFAULT_PAGE_TRANSITION_DURATION, DEFAULT_PAGE_TRANSITION_EASING, DEFAULT_PAGE_TRANSITION_PERSPECTIVE, DEFAULT_PHOSPHOR_WEIGHT, DEFAULT_WIDTH_BY_TYPE, DIALOG_CLOSE_ABOVE_ATTRIBUTE, DIALOG_NODE_TYPE, DataSourceSortDir, DeclarationContext, ENTRANCE_ACTION_TYPES, EXIT_ACTION_TYPES, FormRenderState, FormRuntimeService, GALLERY_EFFECTS, GALLERY_EFFECT_DESCRIPTORS, GalleryLoop, HOVER_DEFAULT_TRANSITION, HOVER_STATES, INTERACTION_HIDDEN_ATTRIBUTE, IOX_BUILDER_EVENTS, IOX_FORM_MESSAGES, IOX_FORM_NAVIGATOR, IOX_FORM_TRANSPORT, IS_PREVIEW, IoxAnimateContainer, IoxAosDirective, IoxAosModule, IoxBuilderComponentsModule, IoxComponentRegistryService, IoxDialogComponent, IoxFieldComponent, IoxFormComponent, IoxFormErrorComponent, IoxFormSuccessComponent, IoxPageComponent, IoxPageModule, IoxSubmitButtonComponent, IoxUiModule, LEGACY_DIRECTION_KEY, LEGACY_HOVER_TRANSITION, LinkedContainerComponent, MANAGED_A11Y_ATTRIBUTES, MAX_LINES_KEY, ON_STATE_ROLES, PAGE_STYLE_TOKENS, PAGE_TOKEN_FALLBACKS, PAGE_TRANSITION_CATEGORIES, PAGE_TRANSITION_PRESETS, PART_CLASS_NAMES, PIPE_DESCRIPTORS, PIPE_REGISTRY, PageScrollProvider, PageStyleField, PageStyleSource, REDUCED_MOTION_QUERY, RESERVED_ALIAS_PREFIX, SORT_PARAM, STATE_PSEUDO_CLASS, SUPPRESSED_STYLE_PROPS_BY_TYPE, SWIPER_A11Y_OPTIONS, SWIPER_RESPONSIVE_TRAITS, SectionComponent, SwiperModuleName, TARGETED_STATE_SUFFIX, TEXT_ALIGN_KEY, TEXT_DIRECTION_KEY, TRANSITION_FEELS, TextAlign, TextBlockComponent, VALIDATION_STATES, VALIDATION_STATE_CLASS, VIRTUAL_TRAIT_GROUPS, VIRTUAL_TRAIT_KEYS, ViewPositionDirective, ViewPositionModule, VisibilityActionType, activeActions, applyBindingPipes, applyFeel, breakpointDef, breakpointForWidth, breakpointQueryFor, buildDataSourceFilter, buildInteractionKeyframes, buildPartSelector, buildRelatedFilter, buildSwiperBreakpoints, buildTargetedStateSelector, buildTargetedSuffixSelector, buildTransitionTimeline, cascadeChain, clearInputOverride, clearOverride, closeAboveMediaQuery, collectContextSlotKeys, collectReferencedAliases, compileDeclarations, compilePageStyle, componentStatesFor, composeVirtualTraits, computeRelative, containerHtmlTag, contextActionEffect, contextSlotKeys, countOverrides, dataSourcePlanToRequest, declaredInputNames, decomposeBackdropFilter, defaultHoverTransition, defaultMessageResolver, deriveSeoFromContent, describePageStyle, describeSeoFields, dialogCloseAboveMinWidth, effectiveActionType, effectiveTransitionId, entrancePreStateStyle, excludeSelf, feelFor, finalKeyframe, getByPath, getSeoValue, hasHoverState, hasOwnTransition, initialSlotValues, isActionEnabled, isContextAction, isCurrentLink, isExternalOrFragment, isGradientPaint, isInputOverriddenAt, isOverriddenAt, isReservedAlias, isValidSlotKey, isWholeBackdropSet, keyframePropertyName, keyframeStyleEntries, legacyEnterToTransition, matchRouteParams, mediaQueryFor, mergeSwiperBreakpoints, migrateLegacyDirection, migrateLegacyTextAlign, motionAllowed, nearestCommonAncestorId, needsAccessibleName, nodeA11yAttributes, nodeCssId, nodeTraitValue, nodeUsesContext, normalizeAppPath, normalizeCollectionResult, normalizeGalleryImage, normalizeIconClass, parentBreakpoint, parseUrlList, partClassName, planDataSource, planResponsiveRules, prefersReducedMotion, referencedDataSources, referencedDataSourcesDeep, renderDefaultDeclarations, resetPageStyleField, resetSeoField, resolveBoundValue, resolveContextValue, resolveDerivedInto, resolveGalleryEffect, resolveGalleryUrls, resolveInputChain, resolveInputs, resolvePageTransition, resolvePath, resolveRelativeInto, resolveRepeaterItems, resolveSeo, resolveSiblings, resolveSingleItemId, resolveStateStyles, resolveStyleProps, resolveToggleVisibility, resolveValueChain, rewriteViewportUnits, safeSetInput, serializeA11yAttributes, setInputOverride, setOverride, setSeoAuto, setSeoBinding, setSeoOverride, setSeoValue, sortParamValue, stateNamesIn, statePseudoClass, stateSelectorSuffix, stripSuppressedProps, swiperAutoplayAllowed, swiperModuleNames, syncNodeA11yAttributes, targetedStateSelector, variableAliases, variableItemsFrom, withContextSlots, withDefaultHoverTransition, wrapInBreakpointQuery, wrapInMediaQuery };
+export type { A11yNodeSource, BoundValueSpec, BreakpointDef, BuildRelatedFilterOptions, ContextActionEffect, ContextActionLike, ContextItemRef, ContextSlotDefault, ContextValueSpec, ContextWriteScope, CurrentLinkOptions, DataSourceDomain, DataSourceEndpoints, DataSourceMode, DataSourcePlan, DataSourceQueryFilter, DataSourceRequest, DataSourceRequestSpec, DataSourceRouteFilter, DataSourceSort, DataSourceSpec, FormMessageResolver, GalleryBoundSource, GalleryDurations, GalleryEffect, GalleryEffectDescriptor, GalleryImage, GalleryLoopOptions, GalleryLoopScheduler, GalleryLoopState, GallerySlideState, IBuilderEventEmitter, InputMap, InteractionKeyframe, IoxContextSlot, IoxPipe, MatchMediaHost, NodeA11yContext, OverrideBreakpoint, PageStyleFieldState, PageStyleOptions, PageStyleSettings, PageTransitionCategory, PageTransitionCategoryMeta, PageTransitionOptions, PageTransitionPreset, PipeArgSpec, PipeContext, PipeDescriptor, RelativeInputs, RelativeSourceKind, RelativeSourceSpec, ResolveSiblingsOptions, ResolvedPageTransition, ResponsiveLayer, ResponsiveOverrides, ResponsiveRuleSet, RouteContext, SeoDerivedContent, SeoFieldSource, SeoFieldState, SeoResolveContext, SetContextParams, SiblingsResult, StateStyleMap, StyleMap, StyleTreeNode, SwiperBreakpointMap, SwiperModuleFlags, ToggleableAction, TransitionFeel, TransitionPhase, TransitionTimelineInput, ValueSource, VirtualTraitGroup };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vectoriox/iox-ui",
-  "version": "5.35.0",
+  "version": "5.37.0",
   "peerDependencies": {
     "@angular/common": ">=20.0.0",
     "@angular/core": ">=20.0.0",

package/src/actions-core/action.model.ts

@@ -11,7 +11,7 @@ export type ActionKind = 'animated' | 'instant' | 'server';
 
 /** Picker grouping. Flat lists die at ~10 entries; the group is data, never a second list. */
 export type ActionGroup =
-    | 'motion' | 'visibility' | 'navigate' | 'dialog' | 'form' | 'data' | 'consent' | 'service';
+    | 'motion' | 'visibility' | 'navigate' | 'dialog' | 'item' | 'form' | 'data' | 'consent' | 'service';
 
 /**
  * What a step does inside the live builder canvas (the canvas RUNS interactions):
@@ -29,10 +29,12 @@ export interface ActionParamSpec {
     options?: readonly { value: string; labelKey: string }[];
 }
 
-/** Does this action point at another node — and may it be any node or only certain types? */
+/** Does this action point at another node — and may it be any node, or only certain types / composite roles? */
 export interface ActionTargetSpec {
     required: boolean;
     types?: string[];
+    /** Only nodes playing one of these composite roles (`openItem` targets an accordion item or a disclosure). */
+    roles?: string[];
 }
 
 /**

package/src/actions-core/element-actions.ts

@@ -1,5 +1,10 @@
+import { AccordionRole, CompositeItemAction, DisclosureRole } from '@vectoriox/iox-ui/composite-core';
+
 import { ActionDescriptor } from './action.model';
 
+/** The items an item action may target: an accordion's item, or a disclosure (its own one item). */
+const ITEM_TARGET_ROLES = [AccordionRole.Item, DisclosureRole.Disclosure];
+
 /**
  * The ELEMENT action catalog (actions plan A1) — what a node can DO, as data. One list feeds the
  * grouped picker, the two interaction engines, and the AI composer's validation (§9: the model
@@ -47,6 +52,16 @@ export const ELEMENT_ACTION_DESCRIPTORS: readonly ActionDescriptor[] = Object.fr
     { type: 'toggleDialog', labelKey: 'builder.actions.toggleDialog', kind: 'instant', group: 'dialog', builderBehaviour: 'run',
       target: { required: true, types: ['Dialog'] } },
 
+    // ── Item (CC2.1 — composite T14): drive an accordion item or a disclosure from anywhere ("See shipping"
+    // opens FAQ item 3). The canvas RUNS them, like the dialog actions: it is the same runtime, and an item you
+    // cannot open from the button is a button you cannot design.
+    { type: 'openItem',   labelKey: 'builder.actions.openItem',   kind: 'instant', group: 'item', builderBehaviour: 'run',
+      target: { required: true, roles: ITEM_TARGET_ROLES } },
+    { type: 'closeItem',  labelKey: 'builder.actions.closeItem',  kind: 'instant', group: 'item', builderBehaviour: 'run',
+      target: { required: true, roles: ITEM_TARGET_ROLES } },
+    { type: 'toggleItem', labelKey: 'builder.actions.toggleItem', kind: 'instant', group: 'item', builderBehaviour: 'run',
+      target: { required: true, roles: ITEM_TARGET_ROLES } },
+
     // ── Form (A1 — Tier A; the submit transport is the forms module's, I7 of its plan) ──
     // simulate in the CANVAS: the builder's Form is a container twin with no real <form>,
     // so there is nothing honest to run — the live engine requestSubmit()s the real one.
@@ -112,6 +127,19 @@ export const SERVER_ELEMENT_ACTION_TYPES: ReadonlySet<string> =
 export const BEHAVIOUR_ACTION_TYPES: ReadonlySet<string> =
     new Set(['navigate', 'scrollTo', 'submitForm', 'copyToClipboard']);
 
+/** The item actions' dispatch set (T14) and what each does to its item — the engines branch on it beside
+ *  DIALOG/BEHAVIOUR, and composite-core `runCompositeItemAction` runs it on the target item's own runtime. */
+export const ITEM_ACTION_TYPES: Readonly<Record<string, CompositeItemAction>> = Object.freeze({
+    openItem: CompositeItemAction.Open,
+    closeItem: CompositeItemAction.Close,
+    toggleItem: CompositeItemAction.Toggle,
+});
+
+/** The item action an action type runs, or null when it is not one. */
+export function itemActionOf(type: string | null | undefined): CompositeItemAction | null {
+    return (type && ITEM_ACTION_TYPES[type]) || null;
+}
+
 /** The consent actions' dispatch set (C3) — the engines branch on it beside DIALOG/BEHAVIOUR.
  *  `openConsentPreferences` is dialog-opening by nature and included so ONE branch owns consent. */
 export const CONSENT_ACTION_TYPES: ReadonlySet<string> =
@@ -119,7 +147,7 @@ export const CONSENT_ACTION_TYPES: ReadonlySet<string> =
 
 /** Picker order — most-used groups first, services last (they are the shop window, not the shop). */
 export const ELEMENT_ACTION_GROUP_ORDER: readonly string[] =
-    Object.freeze(['motion', 'visibility', 'navigate', 'dialog', 'form', 'data', 'consent', 'service']);
+    Object.freeze(['motion', 'visibility', 'navigate', 'dialog', 'item', 'form', 'data', 'consent', 'service']);
 
 /** The catalog, grouped and ordered for the picker — one derivation, no hand-kept second list. */
 export function groupedElementActions(): ReadonlyArray<{ group: string; actions: ActionDescriptor[] }> {