@vectoriox/iox-ui 5.4.1 → 5.5.1

package/index.d.ts

@@ -99,6 +99,10 @@ declare class PageScrollProvider {
     private lenis?;
     private rafId?;
     init(options?: ConstructorParameters<typeof Lenis>[0]): void;
+    /** Hard-stop page scroll (dialog open, A1b): wheel/touch frozen until start(). */
+    stop(): void;
+    /** Resume after stop() — the dialog's close path, incl. native Esc/backdrop closes. */
+    start(): void;
     scrollTo(y: number, options?: {
         duration?: number;
         immediate?: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vectoriox/iox-ui",
-  "version": "5.4.1",
+  "version": "5.5.1",
   "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';