@vectoriox/iox-ui 5.1.0 → 5.3.0

package/forms-core/index.d.ts

@@ -1,3 +1,5 @@
+export { FORM_SUBMIT_ACTION_DESCRIPTORS as ACTION_DESCRIPTORS, ActionDescriptor, addableActions } from '@vectoriox/iox-ui/actions-core';
+
 /** What the visitor actually types into. Chosen by a trait; it also implies a validation rule. */
 declare enum ControlType {
     Text = "text",
@@ -291,21 +293,6 @@ declare const PATTERN_PRESET_OPTIONS: readonly {
     value: PatternPreset;
     labelKey: string;
 }[];
-/** Destinations an author can add to a form, for the After-submit list. */
-interface ActionDescriptor {
-    type: string;
-    labelKey: string;
-    /** Always present and not removable. */
-    locked?: boolean;
-    /** Not offered yet — shown greyed with a "coming soon" note rather than hidden, so the roadmap
-     *  is visible rather than the feature looking absent. */
-    planned?: boolean;
-}
-declare const ACTION_DESCRIPTORS: readonly ActionDescriptor[];
-/** Destinations that can still be added — each at most once, and never a planned one. */
-declare function addableActions(existing?: readonly {
-    type: string;
-}[]): ActionDescriptor[];
 
 /**
  * The submit transport CONTRACT — what a host must provide to make a form actually send.
@@ -372,5 +359,5 @@ declare function withAntiSpamFields(values: Record<string, any>, renderedAt: num
  */
 declare function interpretSubmitResponse(body: any): SubmitResponse;
 
-export { ACTION_DESCRIPTORS, ControlType, DEFAULT_EN_MESSAGES, FIELD_NODE_TYPE, FORM_ERROR_KEYS, FORM_NODE_TYPE, FeedbackTiming, HONEYPOT_FIELD, IMPLIED_PATTERN, INITIAL_FORM_STATE, MESSAGE_NAMESPACE, MULTI_VALUE_CONTROLS, PATTERN_MESSAGE_KEYS, PATTERN_PRESETS, PATTERN_PRESET_OPTIONS, PatternPreset, RENDERED_AT_FIELD, RULE_DESCRIPTORS, RULE_MESSAGE_KEYS, RuleName, RuleParamKind, STORE_ACTION, addableActions, addableRules, applyServerErrors, collectFieldNodes, collectFormSpec, deriveFieldName, firstInvalidField, interpretSubmitResponse, onFieldBlur, onFieldChange, onSubmitAttempt, resetFormState, rulesFor, shouldShowError, submitEndpointPath, uniqueFieldName, validateField, validateForm, withAntiSpamFields };
-export type { ActionDescriptor, FieldError, FieldOption, FieldOptionSource, FieldResult, FieldSpec, FormNodeLike, FormResult, FormRuntimeState, FormSpec, FormTransport, RuleDescriptor, SubmitAction, SubmitRequest, SubmitResponse, ValidationRule };
+export { ControlType, DEFAULT_EN_MESSAGES, FIELD_NODE_TYPE, FORM_ERROR_KEYS, FORM_NODE_TYPE, FeedbackTiming, HONEYPOT_FIELD, IMPLIED_PATTERN, INITIAL_FORM_STATE, MESSAGE_NAMESPACE, MULTI_VALUE_CONTROLS, PATTERN_MESSAGE_KEYS, PATTERN_PRESETS, PATTERN_PRESET_OPTIONS, PatternPreset, RENDERED_AT_FIELD, RULE_DESCRIPTORS, RULE_MESSAGE_KEYS, RuleName, RuleParamKind, STORE_ACTION, addableRules, applyServerErrors, collectFieldNodes, collectFormSpec, deriveFieldName, firstInvalidField, interpretSubmitResponse, onFieldBlur, onFieldChange, onSubmitAttempt, resetFormState, rulesFor, shouldShowError, submitEndpointPath, uniqueFieldName, validateField, validateForm, withAntiSpamFields };
+export type { FieldError, FieldOption, FieldOptionSource, FieldResult, FieldSpec, FormNodeLike, FormResult, FormRuntimeState, FormSpec, FormTransport, RuleDescriptor, SubmitAction, SubmitRequest, SubmitResponse, ValidationRule };

package/index.d.ts

@@ -1549,6 +1549,66 @@ declare function compileTokenCss(tokens: ReadonlyArray<DesignTokenLike> | null |
     dark: string;
 };
 
+/**
+ * Flavors (flavors-and-theming-plan.md, F1): the design language a studio launches with,
+ * expressed as data. THE invariant — a flavor never writes a literal into a node; it writes
+ * tokens, and element defaults that REFERENCE tokens. To that end a pack's `defaults` map
+ * holds TOKEN NAMES, not CSS values: the resolver builds `var(--iox-<name>, <packValue>)`,
+ * so smuggling a literal in is impossible by construction, and the validator only has to
+ * check that every referenced token exists.
+ *
+ * The fallback is the bootstrap: until F2 seeds the org's `designtokens` rows, no `--iox-*`
+ * var is defined anywhere, and `var(--iox-radius-control, 4px)` must still paint identically
+ * in the builder canvas and the SSR page. Once tokens ARE seeded (or re-themed), the var wins
+ * over the fallback everywhere — which is exactly the §3 propagation story.
+ */
+interface FlavorTokenDef {
+    name: string;
+    value: string;
+    /** Dark-scheme override, seeded into DesignToken.values.dark at F2. */
+    values?: {
+        dark?: string;
+    };
+    type?: 'color' | 'spacing' | 'size' | 'font' | 'other';
+    /** Tokens-panel grouping (flavors plan §10 C5). */
+    group?: 'colour' | 'type' | 'space' | 'radius' | 'shadow' | 'motion';
+}
+interface FlavorPack {
+    id: string;
+    /** Bumped when the pack's values change; seeding stamps `flavor:<id>@<version>` as DesignToken.source. */
+    version: number;
+    label: string;
+    blurb: string;
+    tokens: FlavorTokenDef[];
+    /** type → styleTrait → TOKEN NAME (never a CSS value — see the module header). */
+    defaults: Record<string, Record<string, string>>;
+}
+/** trait → `var(--iox-<token>, <packValue>)` for one node type. Unknown type → {}. */
+declare function resolveFlavorDefaults(type: string, pack: FlavorPack | null | undefined): Record<string, string>;
+/**
+ * The ENGINE's half of the cascade: kebab `prop: var(…)` declarations for every pack default
+ * the node's persisted styleProps does NOT set. Appended beside renderDefaultDeclarations —
+ * same guard-on-undefined discipline, so a node saved post-F1 (var already serialised via the
+ * builder's trait defaults) is untouched, and a legacy node picks the pack default up at
+ * render time. Node styleProps always wins.
+ */
+declare function flavorDefaultDeclarations(type: string, styleProps: Record<string, any> | null | undefined, pack: FlavorPack | null | undefined): string[];
+/**
+ * The CI gate (flavors plan §10 C4): a pack may only name types and traits that exist in the
+ * live component registry, and tokens it defines itself. Returns human-readable errors; a
+ * consumer spec feeds it the REAL registry and asserts [].
+ */
+declare function validateFlavorPack(pack: FlavorPack, knownTraitsByType: Record<string, ReadonlySet<string> | string[]>): string[];
+/**
+ * Swiss — the default pack (flavors plan §8: "the flavor that can never embarrass anyone").
+ * Deliberately SMALL at F1: radius + control padding on the clickables, surface radius on Card.
+ * Colour, type and motion arrive with the brand step (F2) — a colour default here would repaint
+ * legacy pages before anyone chose anything.
+ */
+declare const SWISS_FLAVOR: FlavorPack;
+/** What both renderers use until F2 lets an org choose. */
+declare const DEFAULT_FLAVOR: FlavorPack;
+
 /**
  * page-style — the ONE compiler that turns a page's style settings into CSS.
  *
@@ -2718,5 +2778,5 @@ declare class GalleryLoop {
     private emit;
 }
 
-export { AOSService, BREAKPOINTS, Breakpoint, BreakpointQueryKind, BuilderButtonComponent, BuilderDividerComponent, BuilderHeadingComponent, BuilderIconComponent, BuilderImageComponent, BuilderLinkComponent, BuilderSpacerComponent, ButtonBlockComponent, CONTEXT_ACTION_TYPES, CardComponent, ClientGalleryComponent, ClientListComponent, ClientListItemComponent, ClientRepeaterComponent, ClientSliderContainerComponent, ClientSliderSlideComponent, ComponentInstanceRegistryService, ContainerComponent, ContextStore, 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, DeclarationContext, FormRenderState, FormRuntimeService, GALLERY_EFFECTS, GALLERY_EFFECT_DESCRIPTORS, GalleryLoop, IOX_BUILDER_EVENTS, IOX_FORM_MESSAGES, IOX_FORM_NAVIGATOR, IOX_FORM_TRANSPORT, IS_PREVIEW, IoxAnimateContainer, IoxAosDirective, IoxAosModule, IoxBuilderComponentsModule, IoxComponentRegistryService, IoxFieldComponent, IoxFormComponent, IoxFormErrorComponent, IoxFormSuccessComponent, IoxPageComponent, IoxPageModule, IoxSubmitButtonComponent, IoxUiModule, LinkedContainerComponent, PAGE_TRANSITION_CATEGORIES, PAGE_TRANSITION_PRESETS, PART_CLASS_NAMES, PIPE_DESCRIPTORS, PIPE_REGISTRY, PageScrollProvider, RESERVED_ALIAS_PREFIX, SUPPRESSED_STYLE_PROPS_BY_TYPE, SWIPER_RESPONSIVE_TRAITS, SectionComponent, TRANSITION_FEELS, TextBlockComponent, VALIDATION_STATES, VALIDATION_STATE_CLASS, VIRTUAL_TRAIT_GROUPS, VIRTUAL_TRAIT_KEYS, ViewPositionDirective, ViewPositionModule, activeActions, applyBindingPipes, applyFeel, breakpointDef, breakpointForWidth, breakpointQueryFor, buildDataSourceFilter, buildPartSelector, buildRelatedFilter, buildSwiperBreakpoints, buildTargetedStateSelector, buildTransitionTimeline, cascadeChain, clearInputOverride, clearOverride, collectContextSlotKeys, collectReferencedAliases, compileDeclarations, compilePageStyle, compileTokenCss, composeVirtualTraits, computeRelative, contextActionEffect, contextSlotKeys, countOverrides, dataSourcePlanToRequest, declaredInputNames, defaultMessageResolver, deriveSeoFromContent, describeSeoFields, effectiveTransitionId, excludeSelf, feelFor, getByPath, getSeoValue, initialSlotValues, isActionEnabled, isContextAction, isInputOverriddenAt, isOverriddenAt, isReservedAlias, isValidSlotKey, legacyEnterToTransition, matchRouteParams, mediaQueryFor, mergeSwiperBreakpoints, nearestCommonAncestorId, nodeCssId, nodeUsesContext, normalizeCollectionResult, normalizeGalleryImage, normalizeIconClass, parentBreakpoint, parseUrlList, partClassName, planDataSource, planResponsiveRules, referencedDataSources, referencedDataSourcesDeep, renderDefaultDeclarations, resetSeoField, resolveBoundValue, resolveContextValue, resolveDerivedInto, resolveGalleryEffect, resolveGalleryUrls, resolveInputChain, resolveInputs, resolvePageTransition, resolvePath, resolveRelativeInto, resolveRepeaterItems, resolveSeo, resolveSiblings, resolveSingleItemId, resolveStateStyles, resolveStyleProps, resolveValueChain, rewriteViewportUnits, safeSetInput, setInputOverride, setOverride, setSeoAuto, setSeoBinding, setSeoOverride, setSeoValue, stateNamesIn, stripSuppressedProps, styleKeyToKebab, tokensToDarkVarMap, tokensToVarMap, variableAliases, variableItemsFrom, withContextSlots, wrapInBreakpointQuery, wrapInMediaQuery };
-export type { BoundValueSpec, BreakpointDef, BuildRelatedFilterOptions, ContextActionEffect, ContextActionLike, ContextItemRef, ContextSlotDefault, ContextValueSpec, ContextWriteScope, DataSourceDomain, DataSourceEndpoints, DataSourceMode, DataSourcePlan, DataSourceQueryFilter, DataSourceRequest, DataSourceRequestSpec, DataSourceRouteFilter, DataSourceSpec, DesignTokenLike, FormMessageResolver, GalleryBoundSource, GalleryDurations, GalleryEffect, GalleryEffectDescriptor, GalleryImage, GalleryLoopOptions, GalleryLoopScheduler, GalleryLoopState, GallerySlideState, IBuilderEventEmitter, InputMap, IoxContextSlot, IoxPipe, OverrideBreakpoint, 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, ToggleableAction, TransitionFeel, TransitionPhase, TransitionTimelineInput, ValueSource, VirtualTraitGroup };
+export { AOSService, BREAKPOINTS, Breakpoint, BreakpointQueryKind, BuilderButtonComponent, BuilderDividerComponent, BuilderHeadingComponent, BuilderIconComponent, BuilderImageComponent, BuilderLinkComponent, BuilderSpacerComponent, ButtonBlockComponent, CONTEXT_ACTION_TYPES, CardComponent, ClientGalleryComponent, ClientListComponent, ClientListItemComponent, ClientRepeaterComponent, ClientSliderContainerComponent, ClientSliderSlideComponent, ComponentInstanceRegistryService, ContainerComponent, ContextStore, DEFAULT_FLAVOR, 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, DeclarationContext, FormRenderState, FormRuntimeService, GALLERY_EFFECTS, GALLERY_EFFECT_DESCRIPTORS, GalleryLoop, IOX_BUILDER_EVENTS, IOX_FORM_MESSAGES, IOX_FORM_NAVIGATOR, IOX_FORM_TRANSPORT, IS_PREVIEW, IoxAnimateContainer, IoxAosDirective, IoxAosModule, IoxBuilderComponentsModule, IoxComponentRegistryService, IoxFieldComponent, IoxFormComponent, IoxFormErrorComponent, IoxFormSuccessComponent, IoxPageComponent, IoxPageModule, IoxSubmitButtonComponent, IoxUiModule, LinkedContainerComponent, PAGE_TRANSITION_CATEGORIES, PAGE_TRANSITION_PRESETS, PART_CLASS_NAMES, PIPE_DESCRIPTORS, PIPE_REGISTRY, PageScrollProvider, RESERVED_ALIAS_PREFIX, SUPPRESSED_STYLE_PROPS_BY_TYPE, SWIPER_RESPONSIVE_TRAITS, SWISS_FLAVOR, SectionComponent, TRANSITION_FEELS, TextBlockComponent, VALIDATION_STATES, VALIDATION_STATE_CLASS, VIRTUAL_TRAIT_GROUPS, VIRTUAL_TRAIT_KEYS, ViewPositionDirective, ViewPositionModule, activeActions, applyBindingPipes, applyFeel, breakpointDef, breakpointForWidth, breakpointQueryFor, buildDataSourceFilter, buildPartSelector, buildRelatedFilter, buildSwiperBreakpoints, buildTargetedStateSelector, buildTransitionTimeline, cascadeChain, clearInputOverride, clearOverride, collectContextSlotKeys, collectReferencedAliases, compileDeclarations, compilePageStyle, compileTokenCss, composeVirtualTraits, computeRelative, contextActionEffect, contextSlotKeys, countOverrides, dataSourcePlanToRequest, declaredInputNames, defaultMessageResolver, deriveSeoFromContent, describeSeoFields, effectiveTransitionId, excludeSelf, feelFor, flavorDefaultDeclarations, getByPath, getSeoValue, initialSlotValues, isActionEnabled, isContextAction, isInputOverriddenAt, isOverriddenAt, isReservedAlias, isValidSlotKey, legacyEnterToTransition, matchRouteParams, mediaQueryFor, mergeSwiperBreakpoints, nearestCommonAncestorId, nodeCssId, nodeUsesContext, normalizeCollectionResult, normalizeGalleryImage, normalizeIconClass, parentBreakpoint, parseUrlList, partClassName, planDataSource, planResponsiveRules, referencedDataSources, referencedDataSourcesDeep, renderDefaultDeclarations, resetSeoField, resolveBoundValue, resolveContextValue, resolveDerivedInto, resolveFlavorDefaults, resolveGalleryEffect, resolveGalleryUrls, resolveInputChain, resolveInputs, resolvePageTransition, resolvePath, resolveRelativeInto, resolveRepeaterItems, resolveSeo, resolveSiblings, resolveSingleItemId, resolveStateStyles, resolveStyleProps, resolveValueChain, rewriteViewportUnits, safeSetInput, setInputOverride, setOverride, setSeoAuto, setSeoBinding, setSeoOverride, setSeoValue, stateNamesIn, stripSuppressedProps, styleKeyToKebab, tokensToDarkVarMap, tokensToVarMap, validateFlavorPack, variableAliases, variableItemsFrom, withContextSlots, wrapInBreakpointQuery, wrapInMediaQuery };
+export type { BoundValueSpec, BreakpointDef, BuildRelatedFilterOptions, ContextActionEffect, ContextActionLike, ContextItemRef, ContextSlotDefault, ContextValueSpec, ContextWriteScope, DataSourceDomain, DataSourceEndpoints, DataSourceMode, DataSourcePlan, DataSourceQueryFilter, DataSourceRequest, DataSourceRequestSpec, DataSourceRouteFilter, DataSourceSpec, DesignTokenLike, FlavorPack, FlavorTokenDef, FormMessageResolver, GalleryBoundSource, GalleryDurations, GalleryEffect, GalleryEffectDescriptor, GalleryImage, GalleryLoopOptions, GalleryLoopScheduler, GalleryLoopState, GallerySlideState, IBuilderEventEmitter, InputMap, IoxContextSlot, IoxPipe, OverrideBreakpoint, 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, ToggleableAction, TransitionFeel, TransitionPhase, TransitionTimelineInput, ValueSource, VirtualTraitGroup };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vectoriox/iox-ui",
-  "version": "5.1.0",
+  "version": "5.3.0",
   "peerDependencies": {
     "@angular/common": ">=20.0.0",
     "@angular/core": ">=20.0.0",
@@ -19,6 +19,10 @@
       "types": "./index.d.ts",
       "default": "./fesm2022/vectoriox-iox-ui.mjs"
     },
+    "./actions-core": {
+      "types": "./actions-core/index.d.ts",
+      "default": "./fesm2022/vectoriox-iox-ui-actions-core.mjs"
+    },
     "./forms-core": {
       "types": "./forms-core/index.d.ts",
       "default": "./fesm2022/vectoriox-iox-ui-forms-core.mjs"

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

@@ -0,0 +1,79 @@
+/**
+ * The ONE descriptor shape for everything an author can put in an ordered action list —
+ * a form's after-submit steps today, element behaviour actions (A1) next. Promoted out of
+ * `forms-core` because a button action importing from the forms module would be a lie; the
+ * forms catalog lives here now and `forms-core` re-exports it unchanged.
+ * See iox-ai-guidance `architecture/builder/actions-framework-plan.md` §4 (A0).
+ */
+
+/** How a step executes — decides which editor fields appear (timing only for `animated`). */
+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' | 'service';
+
+/**
+ * What a step does inside the live builder canvas (the canvas RUNS interactions):
+ * `run` for real (open the dialog), `simulate` announce-only (navigate), `inert` with a
+ * "runs on the live site" note (anything server-side or costing money).
+ */
+export type BuilderBehaviour = 'run' | 'simulate' | 'inert';
+
+/** A configurable parameter, same shape ComponentMethodDef.params already uses. */
+export interface ActionParamSpec {
+    name: string;
+    type: 'number' | 'string' | 'boolean' | 'page' | 'node' | 'form';
+    label: string;
+}
+
+/** Does this action point at another node — and may it be any node or only certain types? */
+export interface ActionTargetSpec {
+    required: boolean;
+    types?: string[];
+}
+
+/**
+ * One row of an action catalog. Every field beyond `type`/`labelKey` is optional so the
+ * pre-A0 forms descriptors remain valid verbatim.
+ */
+export interface ActionDescriptor {
+    type: string;
+    labelKey: string;
+    kind?: ActionKind;
+    group?: ActionGroup;
+    builderBehaviour?: BuilderBehaviour;
+    target?: ActionTargetSpec;
+    params?: ActionParamSpec[];
+    /** The connector that must be configured & healthy before this action is offerable. */
+    connector?: string;
+    /** Plan-entitlement key (AI plan D5). Absent = never gated by plan. */
+    entitlement?: string;
+    /** Always present in the list and not removable (forms: `store`). */
+    locked?: boolean;
+    /** Not offered yet — shown greyed with a "coming soon" note, so the roadmap is visible. */
+    planned?: boolean;
+}
+
+/**
+ * The FORM after-submit catalog (moved verbatim from forms-core; `forms-core` re-exports it
+ * under its old name `ACTION_DESCRIPTORS`). A1's element catalog is a SEPARATE constant —
+ * the two lists share this shape, never one bucket.
+ */
+export const FORM_SUBMIT_ACTION_DESCRIPTORS: readonly ActionDescriptor[] = Object.freeze([
+    { type: 'store',      labelKey: 'forms.actions.store',      locked: true,  kind: 'server',  group: 'data',     builderBehaviour: 'inert' },
+    { type: 'email',      labelKey: 'forms.actions.email',                     kind: 'server',  group: 'service',  builderBehaviour: 'inert', connector: 'mailer' },
+    { type: 'redirect',   labelKey: 'forms.actions.redirect',                  kind: 'instant', group: 'navigate', builderBehaviour: 'simulate' },
+    { type: 'createItem', labelKey: 'forms.actions.createItem', planned: true, kind: 'server',  group: 'data',     builderBehaviour: 'inert' },
+    { type: 'webhook',    labelKey: 'forms.actions.webhook',    planned: true, kind: 'server',  group: 'service',  builderBehaviour: 'inert' },
+    { type: 'autoReply',  labelKey: 'forms.actions.autoReply',  planned: true, kind: 'server',  group: 'service',  builderBehaviour: 'inert', connector: 'mailer' },
+]);
+
+/** Steps that can still be added to a list — each at most once, and never a planned one. */
+export function addableActions(
+    existing: readonly { type: string }[] = [],
+    catalog: readonly ActionDescriptor[] = FORM_SUBMIT_ACTION_DESCRIPTORS,
+): ActionDescriptor[] {
+    const used = new Set(existing.map(action => action.type));
+    return catalog.filter(action => !action.locked && !action.planned && !used.has(action.type));
+}

package/src/actions-core/availability.ts

@@ -0,0 +1,46 @@
+import { ActionDescriptor } from './action.model';
+
+/**
+ * K4 of the actions plan: four different reasons a catalog row is unavailable, four different
+ * sentences — *coming soon* · *always on* · *connect X first* · *upgrade*. One resolver feeds
+ * the picker AND the AI composer's validation, so they can never disagree.
+ */
+export type ActionAvailabilityState =
+    | 'available'
+    | 'planned'              // not built yet — greyed, "coming soon"
+    | 'locked'               // always present, not addable/removable
+    | 'connector-missing'    // the named connector is not configured/healthy
+    | 'entitlement-missing'; // the plan does not include it
+
+export interface ActionAvailability {
+    state: ActionAvailabilityState;
+    /** Set when state is connector-missing / entitlement-missing — what to name in the message. */
+    connector?: string;
+    entitlement?: string;
+}
+
+export interface ActionAvailabilityContext {
+    /** Connector health by name. An absent map, or an absent key, means "not known" → allowed. */
+    connectors?: Partial<Record<string, boolean>>;
+    /**
+     * Plan entitlements by key. `Plan.entitlements` does not exist yet anywhere (the known gap),
+     * so an ABSENT map means "no gating" and every entitlement passes — the hook is live the day
+     * the control plane starts sending them.
+     */
+    entitlements?: Partial<Record<string, boolean>>;
+}
+
+export function resolveActionAvailability(
+    descriptor: ActionDescriptor,
+    ctx: ActionAvailabilityContext = {},
+): ActionAvailability {
+    if (descriptor.planned) return { state: 'planned' };
+    if (descriptor.locked) return { state: 'locked' };
+    if (descriptor.connector && ctx.connectors && ctx.connectors[descriptor.connector] === false) {
+        return { state: 'connector-missing', connector: descriptor.connector };
+    }
+    if (descriptor.entitlement && ctx.entitlements && ctx.entitlements[descriptor.entitlement] === false) {
+        return { state: 'entitlement-missing', entitlement: descriptor.entitlement };
+    }
+    return { state: 'available' };
+}

package/src/actions-core/public-api.ts

@@ -0,0 +1,12 @@
+/**
+ * @vectoriox/iox-ui/actions-core — the shared, FRAMEWORK-FREE action vocabulary.
+ *
+ * One `ActionDescriptor` shape for every ordered action list in the product: the forms
+ * after-submit steps (whose catalog moved here; `forms-core` re-exports it unchanged) and
+ * the element behaviour actions of A1. Framework-free for the same reason as `forms-core`
+ * and `seo-core`: `iox-cms` consumes it under plain Node.
+ * ⚠️ Consumers wire the usual trio — ng-package raw-ts assets, jest moduleNameMapper, and
+ * tsconfig paths — or `nest start` dies with ERR_REQUIRE_ESM while jest and build pass.
+ */
+export * from './action.model';
+export * from './availability';

package/src/forms-core/rule-catalog.ts

@@ -108,28 +108,9 @@ export const PATTERN_PRESET_OPTIONS: readonly { value: PatternPreset; labelKey:
     { value: PatternPreset.Slug, labelKey: 'forms.rules.preset.slug' },
 ]);
 
-/** Destinations an author can add to a form, for the After-submit list. */
-export interface ActionDescriptor {
-    type: string;
-    labelKey: string;
-    /** Always present and not removable. */
-    locked?: boolean;
-    /** Not offered yet — shown greyed with a "coming soon" note rather than hidden, so the roadmap
-     *  is visible rather than the feature looking absent. */
-    planned?: boolean;
-}
-
-export const ACTION_DESCRIPTORS: readonly ActionDescriptor[] = Object.freeze([
-    { type: 'store', labelKey: 'forms.actions.store', locked: true },
-    { type: 'email', labelKey: 'forms.actions.email' },
-    { type: 'redirect', labelKey: 'forms.actions.redirect' },
-    { type: 'createItem', labelKey: 'forms.actions.createItem', planned: true },
-    { type: 'webhook', labelKey: 'forms.actions.webhook', planned: true },
-    { type: 'autoReply', labelKey: 'forms.actions.autoReply', planned: true },
-]);
-
-/** Destinations that can still be added — each at most once, and never a planned one. */
-export function addableActions(existing: readonly { type: string }[] = []): ActionDescriptor[] {
-    const used = new Set(existing.map(action => action.type));
-    return ACTION_DESCRIPTORS.filter(action => !action.locked && !action.planned && !used.has(action.type));
-}
+// ── MOVED to @vectoriox/iox-ui/actions-core (A0) ─────────────────────────────
+// The descriptor shape and the after-submit catalog are the ONE action vocabulary the whole
+// product shares; element actions (A1) consume the same shape. Re-exported here under the
+// original names so no forms consumer changes a line.
+export type { ActionDescriptor } from '@vectoriox/iox-ui/actions-core';
+export { FORM_SUBMIT_ACTION_DESCRIPTORS as ACTION_DESCRIPTORS, addableActions } from '@vectoriox/iox-ui/actions-core';