@vectoriox/iox-ui 5.4.1 → 5.5.0

package/actions-core/index.d.ts

@@ -82,5 +82,25 @@ interface ActionAvailabilityContext {
 }
 declare function resolveActionAvailability(descriptor: ActionDescriptor, ctx?: ActionAvailabilityContext): ActionAvailability;
 
-export { FORM_SUBMIT_ACTION_DESCRIPTORS, addableActions, resolveActionAvailability };
+/**
+ * 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
+ * picks actions BY NAME from this catalog and can never invent behaviour).
+ *
+ * Shipped rows (motion/visibility/context/swiper) are listed so the catalog is the WHOLE truth;
+ * their `kind`/`builderBehaviour` make the long-standing implicit rules explicit — the canvas is
+ * a live runtime (feedback_builder_live_runtime), navigate must SIMULATE, services are INERT.
+ * `signIn`/`startCheckout` ship greyed with the honest reason (D-A5): no visitor identity, no
+ * payments — a subsystem and a product, not dropdown entries.
+ */
+declare const ELEMENT_ACTION_DESCRIPTORS: readonly ActionDescriptor[];
+/** Picker order — most-used groups first, services last (they are the shop window, not the shop). */
+declare const ELEMENT_ACTION_GROUP_ORDER: readonly string[];
+/** The catalog, grouped and ordered for the picker — one derivation, no hand-kept second list. */
+declare function groupedElementActions(): ReadonlyArray<{
+    group: string;
+    actions: ActionDescriptor[];
+}>;
+
+export { ELEMENT_ACTION_DESCRIPTORS, ELEMENT_ACTION_GROUP_ORDER, FORM_SUBMIT_ACTION_DESCRIPTORS, addableActions, groupedElementActions, resolveActionAvailability };
 export type { ActionAvailability, ActionAvailabilityContext, ActionAvailabilityState, ActionDescriptor, ActionGroup, ActionKind, ActionParamSpec, ActionTargetSpec, BuilderBehaviour };

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

@@ -38,6 +38,72 @@ function resolveActionAvailability(descriptor, ctx = {}) {
     return { state: 'available' };
 }
 
+/**
+ * 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
+ * picks actions BY NAME from this catalog and can never invent behaviour).
+ *
+ * Shipped rows (motion/visibility/context/swiper) are listed so the catalog is the WHOLE truth;
+ * their `kind`/`builderBehaviour` make the long-standing implicit rules explicit — the canvas is
+ * a live runtime (feedback_builder_live_runtime), navigate must SIMULATE, services are INERT.
+ * `signIn`/`startCheckout` ship greyed with the honest reason (D-A5): no visitor identity, no
+ * payments — a subsystem and a product, not dropdown entries.
+ */
+const ELEMENT_ACTION_DESCRIPTORS = Object.freeze([
+    // ── Motion (shipped WAAPI actions — timing row applies) ──────────────────
+    { type: 'fadeIn', labelKey: 'builder.actions.fadeIn', kind: 'animated', group: 'motion', builderBehaviour: 'run' },
+    { type: 'fadeOut', labelKey: 'builder.actions.fadeOut', kind: 'animated', group: 'motion', builderBehaviour: 'run' },
+    { type: 'moveUp', labelKey: 'builder.actions.moveUp', kind: 'animated', group: 'motion', builderBehaviour: 'run' },
+    { type: 'moveDown', labelKey: 'builder.actions.moveDown', kind: 'animated', group: 'motion', builderBehaviour: 'run' },
+    { type: 'moveLeft', labelKey: 'builder.actions.moveLeft', kind: 'animated', group: 'motion', builderBehaviour: 'run' },
+    { type: 'moveRight', labelKey: 'builder.actions.moveRight', kind: 'animated', group: 'motion', builderBehaviour: 'run' },
+    { type: 'scaleIn', labelKey: 'builder.actions.scaleIn', kind: 'animated', group: 'motion', builderBehaviour: 'run' },
+    { type: 'scaleOut', labelKey: 'builder.actions.scaleOut', kind: 'animated', group: 'motion', builderBehaviour: 'run' },
+    { type: 'rotate', labelKey: 'builder.actions.rotate', kind: 'animated', group: 'motion', builderBehaviour: 'run',
+        params: [{ name: 'degrees', type: 'number', label: 'Degrees' }] },
+    // ── Visibility (shipped) ─────────────────────────────────────────────────
+    { type: 'show', labelKey: 'builder.actions.show', kind: 'instant', group: 'visibility', builderBehaviour: 'run' },
+    { type: 'hide', labelKey: 'builder.actions.hide', kind: 'instant', group: 'visibility', builderBehaviour: 'run' },
+    { type: 'toggleVisibility', labelKey: 'builder.actions.toggleVisibility', kind: 'instant', group: 'visibility', builderBehaviour: 'run' },
+    // ── Navigate (A1 — Tier A) ───────────────────────────────────────────────
+    { type: 'navigate', labelKey: 'builder.actions.navigate', kind: 'instant', group: 'navigate', builderBehaviour: 'simulate',
+        params: [
+            { name: 'navigateTo', type: 'string', label: 'Destination' }, // 'page' | 'url' | 'back'
+            { name: 'page', type: 'page', label: 'Page' },
+            { name: 'url', type: 'string', label: 'URL' },
+        ] },
+    { type: 'scrollTo', labelKey: 'builder.actions.scrollTo', kind: 'instant', group: 'navigate', builderBehaviour: 'run',
+        target: { required: false } },
+    // ── Dialog (A1 — needs the Dialog component, A1b) ───────────────────────
+    { type: 'openDialog', labelKey: 'builder.actions.openDialog', kind: 'instant', group: 'dialog', builderBehaviour: 'run',
+        target: { required: true, types: ['Dialog'] } },
+    { type: 'closeDialog', labelKey: 'builder.actions.closeDialog', kind: 'instant', group: 'dialog', builderBehaviour: 'run',
+        target: { required: true, types: ['Dialog'] } },
+    { type: 'toggleDialog', labelKey: 'builder.actions.toggleDialog', kind: 'instant', group: 'dialog', builderBehaviour: 'run',
+        target: { required: true, types: ['Dialog'] } },
+    // ── Form (A1 — Tier A; the submit transport is the forms module's, I7 of its plan) ──
+    { type: 'submitForm', labelKey: 'builder.actions.submitForm', kind: 'instant', group: 'form', builderBehaviour: 'run',
+        target: { required: true, types: ['Form'] } },
+    // ── Data (shipped context actions + the one trivial newcomer) ───────────
+    { type: 'setContext', labelKey: 'builder.actions.setContext', kind: 'instant', group: 'data', builderBehaviour: 'run' },
+    { type: 'clearContext', labelKey: 'builder.actions.clearContext', kind: 'instant', group: 'data', builderBehaviour: 'run' },
+    { type: 'copyToClipboard', labelKey: 'builder.actions.copyToClipboard', kind: 'instant', group: 'data', builderBehaviour: 'run',
+        params: [{ name: 'text', type: 'string', label: 'Text' }] },
+    // ── Services (D-A5: visible, greyed, with the reason — never hidden, never live) ──
+    { type: 'signIn', labelKey: 'builder.actions.signIn', kind: 'server', group: 'service', builderBehaviour: 'inert',
+        planned: true, entitlement: 'visitorIdentity' },
+    { type: 'startCheckout', labelKey: 'builder.actions.startCheckout', kind: 'server', group: 'service', builderBehaviour: 'inert',
+        planned: true, connector: 'payment', entitlement: 'commerce' },
+]);
+/** Picker order — most-used groups first, services last (they are the shop window, not the shop). */
+const ELEMENT_ACTION_GROUP_ORDER = Object.freeze(['motion', 'visibility', 'navigate', 'dialog', 'form', 'data', 'service']);
+/** The catalog, grouped and ordered for the picker — one derivation, no hand-kept second list. */
+function groupedElementActions() {
+    return ELEMENT_ACTION_GROUP_ORDER
+        .map(group => ({ group, actions: ELEMENT_ACTION_DESCRIPTORS.filter(d => d.group === group) }))
+        .filter(g => g.actions.length > 0);
+}
+
 /**
  * @vectoriox/iox-ui/actions-core — the shared, FRAMEWORK-FREE action vocabulary.
  *
@@ -53,5 +119,5 @@ function resolveActionAvailability(descriptor, ctx = {}) {
  * Generated bundle index. Do not edit.
  */
 
-export { FORM_SUBMIT_ACTION_DESCRIPTORS, addableActions, resolveActionAvailability };
+export { ELEMENT_ACTION_DESCRIPTORS, ELEMENT_ACTION_GROUP_ORDER, FORM_SUBMIT_ACTION_DESCRIPTORS, addableActions, groupedElementActions, resolveActionAvailability };
 //# sourceMappingURL=vectoriox-iox-ui-actions-core.mjs.map

package/fesm2022/vectoriox-iox-ui-actions-core.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"vectoriox-iox-ui-actions-core.mjs","sources":["../../../projects/iox-ui/src/actions-core/action.model.ts","../../../projects/iox-ui/src/actions-core/availability.ts","../../../projects/iox-ui/src/actions-core/public-api.ts","../../../projects/iox-ui/src/actions-core/vectoriox-iox-ui-actions-core.ts"],"sourcesContent":["/**\n * The ONE descriptor shape for everything an author can put in an ordered action list —\n * a form's after-submit steps today, element behaviour actions (A1) next. Promoted out of\n * `forms-core` because a button action importing from the forms module would be a lie; the\n * forms catalog lives here now and `forms-core` re-exports it unchanged.\n * See iox-ai-guidance `architecture/builder/actions-framework-plan.md` §4 (A0).\n */\n\n/** How a step executes — decides which editor fields appear (timing only for `animated`). */\nexport type ActionKind = 'animated' | 'instant' | 'server';\n\n/** Picker grouping. Flat lists die at ~10 entries; the group is data, never a second list. */\nexport type ActionGroup =\n    | 'motion' | 'visibility' | 'navigate' | 'dialog' | 'form' | 'data' | 'service';\n\n/**\n * What a step does inside the live builder canvas (the canvas RUNS interactions):\n * `run` for real (open the dialog), `simulate` announce-only (navigate), `inert` with a\n * \"runs on the live site\" note (anything server-side or costing money).\n */\nexport type BuilderBehaviour = 'run' | 'simulate' | 'inert';\n\n/** A configurable parameter, same shape ComponentMethodDef.params already uses. */\nexport interface ActionParamSpec {\n    name: string;\n    type: 'number' | 'string' | 'boolean' | 'page' | 'node' | 'form';\n    label: string;\n}\n\n/** Does this action point at another node — and may it be any node or only certain types? */\nexport interface ActionTargetSpec {\n    required: boolean;\n    types?: string[];\n}\n\n/**\n * One row of an action catalog. Every field beyond `type`/`labelKey` is optional so the\n * pre-A0 forms descriptors remain valid verbatim.\n */\nexport interface ActionDescriptor {\n    type: string;\n    labelKey: string;\n    kind?: ActionKind;\n    group?: ActionGroup;\n    builderBehaviour?: BuilderBehaviour;\n    target?: ActionTargetSpec;\n    params?: ActionParamSpec[];\n    /** The connector that must be configured & healthy before this action is offerable. */\n    connector?: string;\n    /** Plan-entitlement key (AI plan D5). Absent = never gated by plan. */\n    entitlement?: string;\n    /** Always present in the list and not removable (forms: `store`). */\n    locked?: boolean;\n    /** Not offered yet — shown greyed with a \"coming soon\" note, so the roadmap is visible. */\n    planned?: boolean;\n}\n\n/**\n * The FORM after-submit catalog (moved verbatim from forms-core; `forms-core` re-exports it\n * under its old name `ACTION_DESCRIPTORS`). A1's element catalog is a SEPARATE constant —\n * the two lists share this shape, never one bucket.\n */\nexport const FORM_SUBMIT_ACTION_DESCRIPTORS: readonly ActionDescriptor[] = Object.freeze([\n    { type: 'store',      labelKey: 'forms.actions.store',      locked: true,  kind: 'server',  group: 'data',     builderBehaviour: 'inert' },\n    { type: 'email',      labelKey: 'forms.actions.email',                     kind: 'server',  group: 'service',  builderBehaviour: 'inert', connector: 'mailer' },\n    { type: 'redirect',   labelKey: 'forms.actions.redirect',                  kind: 'instant', group: 'navigate', builderBehaviour: 'simulate' },\n    { type: 'createItem', labelKey: 'forms.actions.createItem', planned: true, kind: 'server',  group: 'data',     builderBehaviour: 'inert' },\n    { type: 'webhook',    labelKey: 'forms.actions.webhook',    planned: true, kind: 'server',  group: 'service',  builderBehaviour: 'inert' },\n    { type: 'autoReply',  labelKey: 'forms.actions.autoReply',  planned: true, kind: 'server',  group: 'service',  builderBehaviour: 'inert', connector: 'mailer' },\n]);\n\n/** Steps that can still be added to a list — each at most once, and never a planned one. */\nexport function addableActions(\n    existing: readonly { type: string }[] = [],\n    catalog: readonly ActionDescriptor[] = FORM_SUBMIT_ACTION_DESCRIPTORS,\n): ActionDescriptor[] {\n    const used = new Set(existing.map(action => action.type));\n    return catalog.filter(action => !action.locked && !action.planned && !used.has(action.type));\n}\n","import { ActionDescriptor } from './action.model';\n\n/**\n * K4 of the actions plan: four different reasons a catalog row is unavailable, four different\n * sentences — *coming soon* · *always on* · *connect X first* · *upgrade*. One resolver feeds\n * the picker AND the AI composer's validation, so they can never disagree.\n */\nexport type ActionAvailabilityState =\n    | 'available'\n    | 'planned'              // not built yet — greyed, \"coming soon\"\n    | 'locked'               // always present, not addable/removable\n    | 'connector-missing'    // the named connector is not configured/healthy\n    | 'entitlement-missing'; // the plan does not include it\n\nexport interface ActionAvailability {\n    state: ActionAvailabilityState;\n    /** Set when state is connector-missing / entitlement-missing — what to name in the message. */\n    connector?: string;\n    entitlement?: string;\n}\n\nexport interface ActionAvailabilityContext {\n    /** Connector health by name. An absent map, or an absent key, means \"not known\" → allowed. */\n    connectors?: Partial<Record<string, boolean>>;\n    /**\n     * Plan entitlements by key. `Plan.entitlements` does not exist yet anywhere (the known gap),\n     * so an ABSENT map means \"no gating\" and every entitlement passes — the hook is live the day\n     * the control plane starts sending them.\n     */\n    entitlements?: Partial<Record<string, boolean>>;\n}\n\nexport function resolveActionAvailability(\n    descriptor: ActionDescriptor,\n    ctx: ActionAvailabilityContext = {},\n): ActionAvailability {\n    if (descriptor.planned) return { state: 'planned' };\n    if (descriptor.locked) return { state: 'locked' };\n    if (descriptor.connector && ctx.connectors && ctx.connectors[descriptor.connector] === false) {\n        return { state: 'connector-missing', connector: descriptor.connector };\n    }\n    if (descriptor.entitlement && ctx.entitlements && ctx.entitlements[descriptor.entitlement] === false) {\n        return { state: 'entitlement-missing', entitlement: descriptor.entitlement };\n    }\n    return { state: 'available' };\n}\n","/**\n * @vectoriox/iox-ui/actions-core — the shared, FRAMEWORK-FREE action vocabulary.\n *\n * One `ActionDescriptor` shape for every ordered action list in the product: the forms\n * after-submit steps (whose catalog moved here; `forms-core` re-exports it unchanged) and\n * the element behaviour actions of A1. Framework-free for the same reason as `forms-core`\n * and `seo-core`: `iox-cms` consumes it under plain Node.\n * ⚠️ Consumers wire the usual trio — ng-package raw-ts assets, jest moduleNameMapper, and\n * tsconfig paths — or `nest start` dies with ERR_REQUIRE_ESM while jest and build pass.\n */\nexport * from './action.model';\nexport * from './availability';\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":[],"mappings":"AAAA;;;;;;AAMG;AAmDH;;;;AAIG;AACI,MAAM,8BAA8B,GAAgC,MAAM,CAAC,MAAM,CAAC;IACrF,EAAE,IAAI,EAAE,OAAO,EAAO,QAAQ,EAAE,qBAAqB,EAAO,MAAM,EAAE,IAAI,EAAG,IAAI,EAAE,QAAQ,EAAG,KAAK,EAAE,MAAM,EAAM,gBAAgB,EAAE,OAAO,EAAE;IAC1I,EAAE,IAAI,EAAE,OAAO,EAAO,QAAQ,EAAE,qBAAqB,EAAsB,IAAI,EAAE,QAAQ,EAAG,KAAK,EAAE,SAAS,EAAG,gBAAgB,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE;AAC/J,IAAA,EAAE,IAAI,EAAE,UAAU,EAAI,QAAQ,EAAE,wBAAwB,EAAmB,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,UAAU,EAAE;IAC7I,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,0BAA0B,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAG,KAAK,EAAE,MAAM,EAAM,gBAAgB,EAAE,OAAO,EAAE;IAC1I,EAAE,IAAI,EAAE,SAAS,EAAK,QAAQ,EAAE,uBAAuB,EAAK,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAG,KAAK,EAAE,SAAS,EAAG,gBAAgB,EAAE,OAAO,EAAE;IAC1I,EAAE,IAAI,EAAE,WAAW,EAAG,QAAQ,EAAE,yBAAyB,EAAG,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAG,KAAK,EAAE,SAAS,EAAG,gBAAgB,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE;AAClK,CAAA;AAED;SACgB,cAAc,CAC1B,WAAwC,EAAE,EAC1C,UAAuC,8BAA8B,EAAA;AAErE,IAAA,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC;AACzD,IAAA,OAAO,OAAO,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AAChG;;SC9CgB,yBAAyB,CACrC,UAA4B,EAC5B,MAAiC,EAAE,EAAA;IAEnC,IAAI,UAAU,CAAC,OAAO;AAAE,QAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE;IACnD,IAAI,UAAU,CAAC,MAAM;AAAE,QAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE;AACjD,IAAA,IAAI,UAAU,CAAC,SAAS,IAAI,GAAG,CAAC,UAAU,IAAI,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,SAAS,CAAC,KAAK,KAAK,EAAE;QAC1F,OAAO,EAAE,KAAK,EAAE,mBAAmB,EAAE,SAAS,EAAE,UAAU,CAAC,SAAS,EAAE;IAC1E;AACA,IAAA,IAAI,UAAU,CAAC,WAAW,IAAI,GAAG,CAAC,YAAY,IAAI,GAAG,CAAC,YAAY,CAAC,UAAU,CAAC,WAAW,CAAC,KAAK,KAAK,EAAE;QAClG,OAAO,EAAE,KAAK,EAAE,qBAAqB,EAAE,WAAW,EAAE,UAAU,CAAC,WAAW,EAAE;IAChF;AACA,IAAA,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE;AACjC;;AC7CA;;;;;;;;;AASG;;ACTH;;AAEG;;;;"}
+{"version":3,"file":"vectoriox-iox-ui-actions-core.mjs","sources":["../../../projects/iox-ui/src/actions-core/action.model.ts","../../../projects/iox-ui/src/actions-core/availability.ts","../../../projects/iox-ui/src/actions-core/element-actions.ts","../../../projects/iox-ui/src/actions-core/public-api.ts","../../../projects/iox-ui/src/actions-core/vectoriox-iox-ui-actions-core.ts"],"sourcesContent":["/**\n * The ONE descriptor shape for everything an author can put in an ordered action list —\n * a form's after-submit steps today, element behaviour actions (A1) next. Promoted out of\n * `forms-core` because a button action importing from the forms module would be a lie; the\n * forms catalog lives here now and `forms-core` re-exports it unchanged.\n * See iox-ai-guidance `architecture/builder/actions-framework-plan.md` §4 (A0).\n */\n\n/** How a step executes — decides which editor fields appear (timing only for `animated`). */\nexport type ActionKind = 'animated' | 'instant' | 'server';\n\n/** Picker grouping. Flat lists die at ~10 entries; the group is data, never a second list. */\nexport type ActionGroup =\n    | 'motion' | 'visibility' | 'navigate' | 'dialog' | 'form' | 'data' | 'service';\n\n/**\n * What a step does inside the live builder canvas (the canvas RUNS interactions):\n * `run` for real (open the dialog), `simulate` announce-only (navigate), `inert` with a\n * \"runs on the live site\" note (anything server-side or costing money).\n */\nexport type BuilderBehaviour = 'run' | 'simulate' | 'inert';\n\n/** A configurable parameter, same shape ComponentMethodDef.params already uses. */\nexport interface ActionParamSpec {\n    name: string;\n    type: 'number' | 'string' | 'boolean' | 'page' | 'node' | 'form';\n    label: string;\n}\n\n/** Does this action point at another node — and may it be any node or only certain types? */\nexport interface ActionTargetSpec {\n    required: boolean;\n    types?: string[];\n}\n\n/**\n * One row of an action catalog. Every field beyond `type`/`labelKey` is optional so the\n * pre-A0 forms descriptors remain valid verbatim.\n */\nexport interface ActionDescriptor {\n    type: string;\n    labelKey: string;\n    kind?: ActionKind;\n    group?: ActionGroup;\n    builderBehaviour?: BuilderBehaviour;\n    target?: ActionTargetSpec;\n    params?: ActionParamSpec[];\n    /** The connector that must be configured & healthy before this action is offerable. */\n    connector?: string;\n    /** Plan-entitlement key (AI plan D5). Absent = never gated by plan. */\n    entitlement?: string;\n    /** Always present in the list and not removable (forms: `store`). */\n    locked?: boolean;\n    /** Not offered yet — shown greyed with a \"coming soon\" note, so the roadmap is visible. */\n    planned?: boolean;\n}\n\n/**\n * The FORM after-submit catalog (moved verbatim from forms-core; `forms-core` re-exports it\n * under its old name `ACTION_DESCRIPTORS`). A1's element catalog is a SEPARATE constant —\n * the two lists share this shape, never one bucket.\n */\nexport const FORM_SUBMIT_ACTION_DESCRIPTORS: readonly ActionDescriptor[] = Object.freeze([\n    { type: 'store',      labelKey: 'forms.actions.store',      locked: true,  kind: 'server',  group: 'data',     builderBehaviour: 'inert' },\n    { type: 'email',      labelKey: 'forms.actions.email',                     kind: 'server',  group: 'service',  builderBehaviour: 'inert', connector: 'mailer' },\n    { type: 'redirect',   labelKey: 'forms.actions.redirect',                  kind: 'instant', group: 'navigate', builderBehaviour: 'simulate' },\n    { type: 'createItem', labelKey: 'forms.actions.createItem', planned: true, kind: 'server',  group: 'data',     builderBehaviour: 'inert' },\n    { type: 'webhook',    labelKey: 'forms.actions.webhook',    planned: true, kind: 'server',  group: 'service',  builderBehaviour: 'inert' },\n    { type: 'autoReply',  labelKey: 'forms.actions.autoReply',  planned: true, kind: 'server',  group: 'service',  builderBehaviour: 'inert', connector: 'mailer' },\n]);\n\n/** Steps that can still be added to a list — each at most once, and never a planned one. */\nexport function addableActions(\n    existing: readonly { type: string }[] = [],\n    catalog: readonly ActionDescriptor[] = FORM_SUBMIT_ACTION_DESCRIPTORS,\n): ActionDescriptor[] {\n    const used = new Set(existing.map(action => action.type));\n    return catalog.filter(action => !action.locked && !action.planned && !used.has(action.type));\n}\n","import { ActionDescriptor } from './action.model';\n\n/**\n * K4 of the actions plan: four different reasons a catalog row is unavailable, four different\n * sentences — *coming soon* · *always on* · *connect X first* · *upgrade*. One resolver feeds\n * the picker AND the AI composer's validation, so they can never disagree.\n */\nexport type ActionAvailabilityState =\n    | 'available'\n    | 'planned'              // not built yet — greyed, \"coming soon\"\n    | 'locked'               // always present, not addable/removable\n    | 'connector-missing'    // the named connector is not configured/healthy\n    | 'entitlement-missing'; // the plan does not include it\n\nexport interface ActionAvailability {\n    state: ActionAvailabilityState;\n    /** Set when state is connector-missing / entitlement-missing — what to name in the message. */\n    connector?: string;\n    entitlement?: string;\n}\n\nexport interface ActionAvailabilityContext {\n    /** Connector health by name. An absent map, or an absent key, means \"not known\" → allowed. */\n    connectors?: Partial<Record<string, boolean>>;\n    /**\n     * Plan entitlements by key. `Plan.entitlements` does not exist yet anywhere (the known gap),\n     * so an ABSENT map means \"no gating\" and every entitlement passes — the hook is live the day\n     * the control plane starts sending them.\n     */\n    entitlements?: Partial<Record<string, boolean>>;\n}\n\nexport function resolveActionAvailability(\n    descriptor: ActionDescriptor,\n    ctx: ActionAvailabilityContext = {},\n): ActionAvailability {\n    if (descriptor.planned) return { state: 'planned' };\n    if (descriptor.locked) return { state: 'locked' };\n    if (descriptor.connector && ctx.connectors && ctx.connectors[descriptor.connector] === false) {\n        return { state: 'connector-missing', connector: descriptor.connector };\n    }\n    if (descriptor.entitlement && ctx.entitlements && ctx.entitlements[descriptor.entitlement] === false) {\n        return { state: 'entitlement-missing', entitlement: descriptor.entitlement };\n    }\n    return { state: 'available' };\n}\n","import { ActionDescriptor } from './action.model';\n\n/**\n * The ELEMENT action catalog (actions plan A1) — what a node can DO, as data. One list feeds the\n * grouped picker, the two interaction engines, and the AI composer's validation (§9: the model\n * picks actions BY NAME from this catalog and can never invent behaviour).\n *\n * Shipped rows (motion/visibility/context/swiper) are listed so the catalog is the WHOLE truth;\n * their `kind`/`builderBehaviour` make the long-standing implicit rules explicit — the canvas is\n * a live runtime (feedback_builder_live_runtime), navigate must SIMULATE, services are INERT.\n * `signIn`/`startCheckout` ship greyed with the honest reason (D-A5): no visitor identity, no\n * payments — a subsystem and a product, not dropdown entries.\n */\nexport const ELEMENT_ACTION_DESCRIPTORS: readonly ActionDescriptor[] = Object.freeze([\n    // ── Motion (shipped WAAPI actions — timing row applies) ──────────────────\n    { type: 'fadeIn',   labelKey: 'builder.actions.fadeIn',   kind: 'animated', group: 'motion', builderBehaviour: 'run' },\n    { type: 'fadeOut',  labelKey: 'builder.actions.fadeOut',  kind: 'animated', group: 'motion', builderBehaviour: 'run' },\n    { type: 'moveUp',   labelKey: 'builder.actions.moveUp',   kind: 'animated', group: 'motion', builderBehaviour: 'run' },\n    { type: 'moveDown', labelKey: 'builder.actions.moveDown', kind: 'animated', group: 'motion', builderBehaviour: 'run' },\n    { type: 'moveLeft', labelKey: 'builder.actions.moveLeft', kind: 'animated', group: 'motion', builderBehaviour: 'run' },\n    { type: 'moveRight',labelKey: 'builder.actions.moveRight',kind: 'animated', group: 'motion', builderBehaviour: 'run' },\n    { type: 'scaleIn',  labelKey: 'builder.actions.scaleIn',  kind: 'animated', group: 'motion', builderBehaviour: 'run' },\n    { type: 'scaleOut', labelKey: 'builder.actions.scaleOut', kind: 'animated', group: 'motion', builderBehaviour: 'run' },\n    { type: 'rotate',   labelKey: 'builder.actions.rotate',   kind: 'animated', group: 'motion', builderBehaviour: 'run',\n      params: [{ name: 'degrees', type: 'number', label: 'Degrees' }] },\n\n    // ── Visibility (shipped) ─────────────────────────────────────────────────\n    { type: 'show',             labelKey: 'builder.actions.show',             kind: 'instant', group: 'visibility', builderBehaviour: 'run' },\n    { type: 'hide',             labelKey: 'builder.actions.hide',             kind: 'instant', group: 'visibility', builderBehaviour: 'run' },\n    { type: 'toggleVisibility', labelKey: 'builder.actions.toggleVisibility', kind: 'instant', group: 'visibility', builderBehaviour: 'run' },\n\n    // ── Navigate (A1 — Tier A) ───────────────────────────────────────────────\n    { type: 'navigate', labelKey: 'builder.actions.navigate', kind: 'instant', group: 'navigate', builderBehaviour: 'simulate',\n      params: [\n          { name: 'navigateTo', type: 'string', label: 'Destination' },   // 'page' | 'url' | 'back'\n          { name: 'page',       type: 'page',   label: 'Page' },\n          { name: 'url',        type: 'string', label: 'URL' },\n      ] },\n    { type: 'scrollTo', labelKey: 'builder.actions.scrollTo', kind: 'instant', group: 'navigate', builderBehaviour: 'run',\n      target: { required: false } },\n\n    // ── Dialog (A1 — needs the Dialog component, A1b) ───────────────────────\n    { type: 'openDialog',   labelKey: 'builder.actions.openDialog',   kind: 'instant', group: 'dialog', builderBehaviour: 'run',\n      target: { required: true, types: ['Dialog'] } },\n    { type: 'closeDialog',  labelKey: 'builder.actions.closeDialog',  kind: 'instant', group: 'dialog', builderBehaviour: 'run',\n      target: { required: true, types: ['Dialog'] } },\n    { type: 'toggleDialog', labelKey: 'builder.actions.toggleDialog', kind: 'instant', group: 'dialog', builderBehaviour: 'run',\n      target: { required: true, types: ['Dialog'] } },\n\n    // ── Form (A1 — Tier A; the submit transport is the forms module's, I7 of its plan) ──\n    { type: 'submitForm', labelKey: 'builder.actions.submitForm', kind: 'instant', group: 'form', builderBehaviour: 'run',\n      target: { required: true, types: ['Form'] } },\n\n    // ── Data (shipped context actions + the one trivial newcomer) ───────────\n    { type: 'setContext',      labelKey: 'builder.actions.setContext',      kind: 'instant', group: 'data', builderBehaviour: 'run' },\n    { type: 'clearContext',    labelKey: 'builder.actions.clearContext',    kind: 'instant', group: 'data', builderBehaviour: 'run' },\n    { type: 'copyToClipboard', labelKey: 'builder.actions.copyToClipboard', kind: 'instant', group: 'data', builderBehaviour: 'run',\n      params: [{ name: 'text', type: 'string', label: 'Text' }] },\n\n    // ── Services (D-A5: visible, greyed, with the reason — never hidden, never live) ──\n    { type: 'signIn',        labelKey: 'builder.actions.signIn',        kind: 'server', group: 'service', builderBehaviour: 'inert',\n      planned: true, entitlement: 'visitorIdentity' },\n    { type: 'startCheckout', labelKey: 'builder.actions.startCheckout', kind: 'server', group: 'service', builderBehaviour: 'inert',\n      planned: true, connector: 'payment', entitlement: 'commerce' },\n]);\n\n/** Picker order — most-used groups first, services last (they are the shop window, not the shop). */\nexport const ELEMENT_ACTION_GROUP_ORDER: readonly string[] =\n    Object.freeze(['motion', 'visibility', 'navigate', 'dialog', 'form', 'data', 'service']);\n\n/** The catalog, grouped and ordered for the picker — one derivation, no hand-kept second list. */\nexport function groupedElementActions(): ReadonlyArray<{ group: string; actions: ActionDescriptor[] }> {\n    return ELEMENT_ACTION_GROUP_ORDER\n        .map(group => ({ group, actions: ELEMENT_ACTION_DESCRIPTORS.filter(d => d.group === group) }))\n        .filter(g => g.actions.length > 0);\n}\n","/**\n * @vectoriox/iox-ui/actions-core — the shared, FRAMEWORK-FREE action vocabulary.\n *\n * One `ActionDescriptor` shape for every ordered action list in the product: the forms\n * after-submit steps (whose catalog moved here; `forms-core` re-exports it unchanged) and\n * the element behaviour actions of A1. Framework-free for the same reason as `forms-core`\n * and `seo-core`: `iox-cms` consumes it under plain Node.\n * ⚠️ Consumers wire the usual trio — ng-package raw-ts assets, jest moduleNameMapper, and\n * tsconfig paths — or `nest start` dies with ERR_REQUIRE_ESM while jest and build pass.\n */\nexport * from './action.model';\nexport * from './availability';\nexport * from './element-actions';\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":[],"mappings":"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"}

package/package.json

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

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

@@ -0,0 +1,76 @@
+import { ActionDescriptor } from './action.model';
+
+/**
+ * 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
+ * picks actions BY NAME from this catalog and can never invent behaviour).
+ *
+ * Shipped rows (motion/visibility/context/swiper) are listed so the catalog is the WHOLE truth;
+ * their `kind`/`builderBehaviour` make the long-standing implicit rules explicit — the canvas is
+ * a live runtime (feedback_builder_live_runtime), navigate must SIMULATE, services are INERT.
+ * `signIn`/`startCheckout` ship greyed with the honest reason (D-A5): no visitor identity, no
+ * payments — a subsystem and a product, not dropdown entries.
+ */
+export const ELEMENT_ACTION_DESCRIPTORS: readonly ActionDescriptor[] = Object.freeze([
+    // ── Motion (shipped WAAPI actions — timing row applies) ──────────────────
+    { type: 'fadeIn',   labelKey: 'builder.actions.fadeIn',   kind: 'animated', group: 'motion', builderBehaviour: 'run' },
+    { type: 'fadeOut',  labelKey: 'builder.actions.fadeOut',  kind: 'animated', group: 'motion', builderBehaviour: 'run' },
+    { type: 'moveUp',   labelKey: 'builder.actions.moveUp',   kind: 'animated', group: 'motion', builderBehaviour: 'run' },
+    { type: 'moveDown', labelKey: 'builder.actions.moveDown', kind: 'animated', group: 'motion', builderBehaviour: 'run' },
+    { type: 'moveLeft', labelKey: 'builder.actions.moveLeft', kind: 'animated', group: 'motion', builderBehaviour: 'run' },
+    { type: 'moveRight',labelKey: 'builder.actions.moveRight',kind: 'animated', group: 'motion', builderBehaviour: 'run' },
+    { type: 'scaleIn',  labelKey: 'builder.actions.scaleIn',  kind: 'animated', group: 'motion', builderBehaviour: 'run' },
+    { type: 'scaleOut', labelKey: 'builder.actions.scaleOut', kind: 'animated', group: 'motion', builderBehaviour: 'run' },
+    { type: 'rotate',   labelKey: 'builder.actions.rotate',   kind: 'animated', group: 'motion', builderBehaviour: 'run',
+      params: [{ name: 'degrees', type: 'number', label: 'Degrees' }] },
+
+    // ── Visibility (shipped) ─────────────────────────────────────────────────
+    { type: 'show',             labelKey: 'builder.actions.show',             kind: 'instant', group: 'visibility', builderBehaviour: 'run' },
+    { type: 'hide',             labelKey: 'builder.actions.hide',             kind: 'instant', group: 'visibility', builderBehaviour: 'run' },
+    { type: 'toggleVisibility', labelKey: 'builder.actions.toggleVisibility', kind: 'instant', group: 'visibility', builderBehaviour: 'run' },
+
+    // ── Navigate (A1 — Tier A) ───────────────────────────────────────────────
+    { type: 'navigate', labelKey: 'builder.actions.navigate', kind: 'instant', group: 'navigate', builderBehaviour: 'simulate',
+      params: [
+          { name: 'navigateTo', type: 'string', label: 'Destination' },   // 'page' | 'url' | 'back'
+          { name: 'page',       type: 'page',   label: 'Page' },
+          { name: 'url',        type: 'string', label: 'URL' },
+      ] },
+    { type: 'scrollTo', labelKey: 'builder.actions.scrollTo', kind: 'instant', group: 'navigate', builderBehaviour: 'run',
+      target: { required: false } },
+
+    // ── Dialog (A1 — needs the Dialog component, A1b) ───────────────────────
+    { type: 'openDialog',   labelKey: 'builder.actions.openDialog',   kind: 'instant', group: 'dialog', builderBehaviour: 'run',
+      target: { required: true, types: ['Dialog'] } },
+    { type: 'closeDialog',  labelKey: 'builder.actions.closeDialog',  kind: 'instant', group: 'dialog', builderBehaviour: 'run',
+      target: { required: true, types: ['Dialog'] } },
+    { type: 'toggleDialog', labelKey: 'builder.actions.toggleDialog', kind: 'instant', group: 'dialog', builderBehaviour: 'run',
+      target: { required: true, types: ['Dialog'] } },
+
+    // ── Form (A1 — Tier A; the submit transport is the forms module's, I7 of its plan) ──
+    { type: 'submitForm', labelKey: 'builder.actions.submitForm', kind: 'instant', group: 'form', builderBehaviour: 'run',
+      target: { required: true, types: ['Form'] } },
+
+    // ── Data (shipped context actions + the one trivial newcomer) ───────────
+    { type: 'setContext',      labelKey: 'builder.actions.setContext',      kind: 'instant', group: 'data', builderBehaviour: 'run' },
+    { type: 'clearContext',    labelKey: 'builder.actions.clearContext',    kind: 'instant', group: 'data', builderBehaviour: 'run' },
+    { type: 'copyToClipboard', labelKey: 'builder.actions.copyToClipboard', kind: 'instant', group: 'data', builderBehaviour: 'run',
+      params: [{ name: 'text', type: 'string', label: 'Text' }] },
+
+    // ── Services (D-A5: visible, greyed, with the reason — never hidden, never live) ──
+    { type: 'signIn',        labelKey: 'builder.actions.signIn',        kind: 'server', group: 'service', builderBehaviour: 'inert',
+      planned: true, entitlement: 'visitorIdentity' },
+    { type: 'startCheckout', labelKey: 'builder.actions.startCheckout', kind: 'server', group: 'service', builderBehaviour: 'inert',
+      planned: true, connector: 'payment', entitlement: 'commerce' },
+]);
+
+/** 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', 'service']);
+
+/** The catalog, grouped and ordered for the picker — one derivation, no hand-kept second list. */
+export function groupedElementActions(): ReadonlyArray<{ group: string; actions: ActionDescriptor[] }> {
+    return ELEMENT_ACTION_GROUP_ORDER
+        .map(group => ({ group, actions: ELEMENT_ACTION_DESCRIPTORS.filter(d => d.group === group) }))
+        .filter(g => g.actions.length > 0);
+}

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

@@ -10,3 +10,4 @@
  */
 export * from './action.model';
 export * from './availability';
+export * from './element-actions';