@jigx/sdk-tools 1.2.0-next.3 → 1.2.0-next.4

package/dist/migrator/nodes/action-definition.d.ts

@@ -0,0 +1,11 @@
+import { type EntityConversion } from '../converters/index.js';
+import { type LegacyEntry } from '../read-solution.js';
+/**
+ * `actions/<id>.jigx` → `app.addAction({ actionId })`, `definition.addParameter(…)` per
+ * parameter and the root action through the node engine.
+ *
+ * A root action that does not verify skips the whole entity with the root's gap: an
+ * action definition cannot build without its action.
+ */
+export declare function convertAction(entry: LegacyEntry): EntityConversion;
+//# sourceMappingURL=action-definition.d.ts.map

package/dist/migrator/nodes/action-definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-definition.d.ts","sourceRoot":"","sources":["../../../src/migrator/nodes/action-definition.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAE9D,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAetD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,WAAW,GAAG,gBAAgB,CAwDlE"}

package/dist/migrator/nodes/action-definition.js

@@ -0,0 +1,75 @@
+import { ApplicationBuilder, toJaActionParameterDefinition } from '@jigx/core-sdk';
+import { isPlainObject } from '../normalize.js';
+import { lit, str } from '../ts-printer.js';
+import { attachNode } from './attach.js';
+import { emitPlan, Gen } from './codegen.js';
+import { isNode } from './node-shape.js';
+import { PROBE_APP_NAME, replay } from './probe.js';
+const DEFINITION_KEYS = ['actionId', 'action', 'parameters'];
+const UNSUPPORTED = {
+    type: 'skip',
+    gapId: 'actions:unsupported-shape',
+    reason: 'a global action needs an action node, optional parameters and nothing else',
+};
+/**
+ * `actions/<id>.jigx` → `app.addAction({ actionId })`, `definition.addParameter(…)` per
+ * parameter and the root action through the node engine.
+ *
+ * A root action that does not verify skips the whole entity with the root's gap: an
+ * action definition cannot build without its action.
+ */
+export function convertAction(entry) {
+    const { id, entity } = entry;
+    if (!isPlainObject(entity))
+        return UNSUPPORTED;
+    const { actionId, action, parameters } = entity;
+    const shapeOk = Object.keys(entity).every((key) => DEFINITION_KEYS.includes(key)) &&
+        (actionId === undefined || actionId === id) &&
+        isNode(action) &&
+        (parameters === undefined ||
+            (isPlainObject(parameters) && Object.values(parameters).every((p) => isPlainObject(p))));
+    if (!shapeOk || !isNode(action))
+        return UNSUPPORTED;
+    const result = attachNode({
+        parentFactory: () => new ApplicationBuilder({ name: PROBE_APP_NAME }).addAction({ actionId: id }),
+        parentType: 'action-definition',
+        parentChildRoot: 'root',
+        slot: 'action',
+        list: false,
+        path: ['action'],
+        node: action,
+    });
+    if (result.type === 'skip') {
+        return {
+            type: 'skip',
+            gapId: result.gap.gapId,
+            nodeType: result.gap.nodeType,
+            reason: result.gap.reason,
+        };
+    }
+    const definitions = Object.entries(isPlainObject(parameters) ? parameters : {});
+    const gen = new Gen();
+    gen.push(`const definition = app.addAction({ actionId: ${str(id)} })`);
+    for (const [name, parameter] of definitions) {
+        gen.push(`definition.addParameter(${str(name)}, ${lit(parameter, gen.indent)})`);
+    }
+    const { plan } = result;
+    emitPlan({ plan, parentExpr: 'definition', gen });
+    return {
+        type: 'statements',
+        gaps: result.gaps,
+        statements: [
+            {
+                code: gen.code(),
+                run: (app) => {
+                    const definition = app.addAction({ actionId: id });
+                    for (const [name, value] of definitions) {
+                        definition.addParameter(name, toJaActionParameterDefinition(structuredClone(value)));
+                    }
+                    replay({ parent: definition, plan });
+                },
+            },
+        ],
+    };
+}
+//# sourceMappingURL=action-definition.js.map

package/dist/migrator/nodes/action-definition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-definition.js","sourceRoot":"","sources":["../../../src/migrator/nodes/action-definition.ts"],"names":[],"mappings":"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"}

package/dist/migrator/nodes/app-events.d.ts

@@ -0,0 +1,29 @@
+import { ApplicationBuilder } from '@jigx/core-sdk';
+import { type NodeGap } from '../report.js';
+import { type Gen } from './codegen.js';
+/** Index keys whose action tree has a typed `ApplicationBuilder` event factory. */
+export declare const APP_EVENTS: readonly string[];
+export type AppEventConversion = {
+    readonly type: 'typed';
+    readonly code: string;
+    readonly run: (app: ApplicationBuilder) => void;
+    readonly gaps: readonly NodeGap[];
+} | {
+    readonly type: 'skip';
+    readonly gap: NodeGap;
+} | {
+    readonly type: 'not-node';
+};
+/**
+ * Index `onLoad`/`onFocus`/`onRefresh` → `app.<event>.<action>(…)` through the node engine,
+ * verified on a scratch ApplicationBuilder. `onAppActivated` and `onTableChanged` have no
+ * typed event and stay index-level gaps.
+ */
+export declare function convertAppEvent(options: {
+    readonly name: string;
+    readonly key: string;
+    readonly value: unknown;
+    /** Shares the variable counter of the index module. */
+    readonly gen: Gen;
+}): AppEventConversion;
+//# sourceMappingURL=app-events.d.ts.map

package/dist/migrator/nodes/app-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-events.d.ts","sourceRoot":"","sources":["../../../src/migrator/nodes/app-events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AACnD,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,cAAc,CAAA;AAE3C,OAAO,EAAY,KAAK,GAAG,EAAE,MAAM,cAAc,CAAA;AAIjD,mFAAmF;AACnF,eAAO,MAAM,UAAU,EAAE,SAAS,MAAM,EAAuC,CAAA;AAE/E,MAAM,MAAM,kBAAkB,GAC1B;IACE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,kBAAkB,KAAK,IAAI,CAAA;IAC/C,QAAQ,CAAC,IAAI,EAAE,SAAS,OAAO,EAAE,CAAA;CAClC,GACD;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAA;CAAE,GAChD;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;CAAE,CAAA;AAEjC;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;IACvB,uDAAuD;IACvD,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAA;CAClB,GAAG,kBAAkB,CAwBrB"}

package/dist/migrator/nodes/app-events.js

@@ -0,0 +1,40 @@
+import { ApplicationBuilder } from '@jigx/core-sdk';
+import { attachNode } from './attach.js';
+import { emitPlan } from './codegen.js';
+import { isNode } from './node-shape.js';
+import { replay } from './probe.js';
+/** Index keys whose action tree has a typed `ApplicationBuilder` event factory. */
+export const APP_EVENTS = ['onLoad', 'onFocus', 'onRefresh'];
+/**
+ * Index `onLoad`/`onFocus`/`onRefresh` → `app.<event>.<action>(…)` through the node engine,
+ * verified on a scratch ApplicationBuilder. `onAppActivated` and `onTableChanged` have no
+ * typed event and stay index-level gaps.
+ */
+export function convertAppEvent(options) {
+    const { name, key, value } = options;
+    if (!isNode(value))
+        return { type: 'not-node' };
+    const result = attachNode({
+        parentFactory: () => new ApplicationBuilder({ name }),
+        parentType: 'application',
+        parentChildRoot: 'root',
+        slot: key,
+        list: false,
+        path: [key],
+        node: value,
+    });
+    if (result.type === 'skip')
+        return result;
+    const gen = options.gen.fork();
+    const { plan } = result;
+    emitPlan({ plan, parentExpr: 'app', gen });
+    return {
+        type: 'typed',
+        code: gen.code(),
+        run: (app) => {
+            replay({ parent: app, plan });
+        },
+        gaps: result.gaps,
+    };
+}
+//# sourceMappingURL=app-events.js.map

package/dist/migrator/nodes/app-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-events.js","sourceRoot":"","sources":["../../../src/migrator/nodes/app-events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AAEnD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,EAAE,QAAQ,EAAY,MAAM,cAAc,CAAA;AACjD,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAEnC,mFAAmF;AACnF,MAAM,CAAC,MAAM,UAAU,GAAsB,CAAC,QAAQ,EAAE,SAAS,EAAE,WAAW,CAAC,CAAA;AAY/E;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,OAM/B;IACC,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,OAAO,CAAA;IACpC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAA;IAC/C,MAAM,MAAM,GAAG,UAAU,CAAC;QACxB,aAAa,EAAE,GAAG,EAAE,CAAC,IAAI,kBAAkB,CAAC,EAAE,IAAI,EAAE,CAAC;QACrD,UAAU,EAAE,aAAa;QACzB,eAAe,EAAE,MAAM;QACvB,IAAI,EAAE,GAAG;QACT,IAAI,EAAE,KAAK;QACX,IAAI,EAAE,CAAC,GAAG,CAAC;QACX,IAAI,EAAE,KAAK;KACZ,CAAC,CAAA;IACF,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM;QAAE,OAAO,MAAM,CAAA;IACzC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,CAAA;IAC9B,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,CAAA;IACvB,QAAQ,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAA;IAC1C,OAAO;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE;QAChB,GAAG,EAAE,CAAC,GAAG,EAAE,EAAE;YACX,MAAM,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAA;QAC/B,CAAC;QACD,IAAI,EAAE,MAAM,CAAC,IAAI;KAClB,CAAA;AACH,CAAC"}

package/dist/migrator/nodes/attach.d.ts

@@ -0,0 +1,61 @@
+import { type NodeGap, type NodePathSegment } from '../report.js';
+import { type LegacyNode, type NodeSlot } from './node-shape.js';
+import { type Accessor, type ChildRoot, type NodePlan, type ParentFactory } from './probe.js';
+import { type Call, type Obj } from './rules/index.js';
+/** Where a node attaches: a scratch parent factory, the parent type and the slot. */
+export interface AttachTarget {
+    readonly parentFactory: ParentFactory;
+    /** Node type of the parent (`component.entity`, `jig.list`, `jig-actions`, `application`, …). */
+    readonly parentType: string;
+    readonly parentChildRoot: ChildRoot;
+    readonly slot: string;
+    readonly list: boolean;
+    /** Path of the node inside its entity. */
+    readonly path: readonly NodePathSegment[];
+}
+/**
+ * A node to attach: the node itself, or a pseudo node such as a bottom panel or a
+ * screen summary, already split into input, calls and child slots.
+ */
+export interface NodeSpec {
+    readonly nodeType: string;
+    /** Factory input; `undefined` calls the factory without parameters. */
+    readonly input: Obj | undefined;
+    readonly calls: readonly Call[];
+    readonly slots: readonly NodeSlot[];
+    /** Where this node's built output keeps its child slots. */
+    readonly childRoot: ChildRoot;
+    /** The legacy value the built node must equal (after pruning skipped children). */
+    readonly legacy: unknown;
+    /** Fixed accessor (pseudo nodes); looked up on the parent from the node type otherwise. */
+    readonly accessor?: Accessor;
+}
+export type AttachResult = {
+    readonly type: 'typed';
+    readonly plan: NodePlan;
+    readonly gaps: readonly NodeGap[];
+} | {
+    readonly type: 'skip';
+    readonly gap: NodeGap;
+};
+/**
+ * Attaches a split node (or pseudo node): converts its children first, against a scratch
+ * chain of its ancestors, then verifies the node with its typed children by probe and
+ * compares it with the legacy value pruned of exactly the skipped children. A list slot
+ * emptied by those skips counts as absent on both sides (see `pruneAt`).
+ *
+ * A node that does not verify is skipped with its whole subtree as one gap:
+ * `no-factory-<slot>`, `throws-<message>`, `option-<key>` (one differing option) or
+ * `output-differs`.
+ */
+export declare function attachSpec(options: AttachTarget & {
+    readonly spec: NodeSpec;
+}): AttachResult;
+/**
+ * Attaches one legacy component or action node to a parent slot (see `attachSpec`).
+ * A shape with no typed form is skipped as `shape`; a rule-rejected one as `type-rejects`.
+ */
+export declare function attachNode(options: AttachTarget & {
+    readonly node: LegacyNode;
+}): AttachResult;
+//# sourceMappingURL=attach.d.ts.map

package/dist/migrator/nodes/attach.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attach.d.ts","sourceRoot":"","sources":["../../../src/migrator/nodes/attach.ts"],"names":[],"mappings":"AAGA,OAAO,EAAc,KAAK,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,cAAc,CAAA;AAE7E,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,QAAQ,EAAS,MAAM,iBAAiB,CAAA;AACvE,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,QAAQ,EACb,KAAK,aAAa,EAKnB,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,KAAK,IAAI,EAAoB,KAAK,GAAG,EAAkB,MAAM,kBAAkB,CAAA;AAExF,qFAAqF;AACrF,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAA;IACrC,iGAAiG;IACjG,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,eAAe,EAAE,SAAS,CAAA;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;IACtB,0CAA0C;IAC1C,QAAQ,CAAC,IAAI,EAAE,SAAS,eAAe,EAAE,CAAA;CAC1C;AAED;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,uEAAuE;IACvE,QAAQ,CAAC,KAAK,EAAE,GAAG,GAAG,SAAS,CAAA;IAC/B,QAAQ,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,CAAA;IAC/B,QAAQ,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAA;IACnC,4DAA4D;IAC5D,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAA;IAC7B,mFAAmF;IACnF,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,2FAA2F;IAC3F,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAA;CAC7B;AAED,MAAM,MAAM,YAAY,GACpB;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,OAAO,EAAE,CAAA;CAAE,GACtF;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAA;CAAE,CAAA;AA2EpD;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,YAAY,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,GAAG,YAAY,CA8E5F;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,YAAY,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;CAAE,GAAG,YAAY,CAsB9F"}

package/dist/migrator/nodes/attach.js

@@ -0,0 +1,174 @@
+import { isDeepStrictEqual } from 'node:util';
+import { isPlainObject } from '../normalize.js';
+import { pruneAt, pruneBuiltAt } from '../prune.js';
+import { countNodes } from '../report.js';
+import { firstLine, hasMethod, member, messageSlug, toJsonValue } from './builder-access.js';
+import { split } from './node-shape.js';
+import { probe, replay, } from './probe.js';
+import { methodCandidates, rejects, RULES } from './rules/index.js';
+function nodeGap(options) {
+    const { nodeType, reasonSlug, reason, legacy, path } = options;
+    return {
+        gapId: `${nodeType}:${reasonSlug}`,
+        nodeType,
+        reason,
+        skippedNodes: countNodes({ value: legacy, asRoot: true }),
+        path,
+    };
+}
+/** Finds the parent member that creates a child of `nodeType` in `slot`. */
+function findAccessor(options) {
+    const { parent, parentType, slot, nodeType, layout } = options;
+    const ruleHolder = RULES[parentType]?.holders?.[slot];
+    const holder = ruleHolder !== undefined && member(parent, ruleHolder) !== undefined
+        ? ruleHolder
+        : nodeType.startsWith('component.') && slot === 'children'
+            ? 'addControl'
+            : slot;
+    const factory = member(parent, holder);
+    if (typeof factory === 'function')
+        return { holder };
+    if (!isPlainObject(factory))
+        return undefined;
+    const method = methodCandidates({ type: nodeType, layout }).find((name) => hasMethod(factory, name));
+    return method === undefined ? undefined : { holder, method };
+}
+/** Keys (top-level, and under `options`) whose values differ between two built nodes. */
+function differingKeys(built, legacy) {
+    if (!isPlainObject(built) || !isPlainObject(legacy))
+        return [];
+    const differing = [];
+    const names = new Set([...Object.keys(built), ...Object.keys(legacy)]);
+    for (const name of names) {
+        if (name === 'options' && isPlainObject(built.options) && isPlainObject(legacy.options)) {
+            const builtOptions = built.options;
+            const legacyOptions = legacy.options;
+            const optionNames = new Set([...Object.keys(builtOptions), ...Object.keys(legacyOptions)]);
+            for (const option of optionNames) {
+                if (!isDeepStrictEqual(builtOptions[option], legacyOptions[option]))
+                    differing.push(option);
+            }
+        }
+        else if (!isDeepStrictEqual(built[name], legacy[name])) {
+            differing.push(name);
+        }
+    }
+    return differing;
+}
+function childPath(options) {
+    const { path, childRoot, slot, index } = options;
+    const base = childRoot === 'options' ? [...path, 'options', slot.key] : [...path, slot.key];
+    return slot.list ? [...base, index] : base;
+}
+/**
+ * Attaches a split node (or pseudo node): converts its children first, against a scratch
+ * chain of its ancestors, then verifies the node with its typed children by probe and
+ * compares it with the legacy value pruned of exactly the skipped children. A list slot
+ * emptied by those skips counts as absent on both sides (see `pruneAt`).
+ *
+ * A node that does not verify is skipped with its whole subtree as one gap:
+ * `no-factory-<slot>`, `throws-<message>`, `option-<key>` (one differing option) or
+ * `output-differs`.
+ */
+export function attachSpec(options) {
+    const { parentFactory, parentType, parentChildRoot, slot, list, path, spec } = options;
+    const { nodeType, legacy } = spec;
+    const skip = (reasonSlug, reason) => ({
+        type: 'skip',
+        gap: nodeGap({ nodeType, reasonSlug, reason, legacy, path }),
+    });
+    let accessor = spec.accessor;
+    if (accessor === undefined) {
+        let parent;
+        try {
+            parent = parentFactory();
+        }
+        catch {
+            return skip('parent-throws', 'the scratch parent cannot be created');
+        }
+        accessor = findAccessor({
+            parent,
+            parentType,
+            slot,
+            nodeType,
+            layout: isPlainObject(legacy) && isPlainObject(legacy.options) ? legacy.options.layout : undefined,
+        });
+    }
+    if (accessor === undefined) {
+        return skip(`no-factory-${slot}`, `${parentType} has no typed factory for ${nodeType} in "${slot}"`);
+    }
+    const shallow = { nodeType, accessor, input: spec.input, calls: spec.calls, slots: [] };
+    try {
+        replay({ parent: parentFactory(), plan: shallow });
+    }
+    catch (error) {
+        const line = firstLine(error);
+        return skip(`throws-${messageSlug(line)}`, `the typed call throws: ${line}`);
+    }
+    const selfFactory = () => replay({ parent: parentFactory(), plan: shallow, withChildren: false });
+    const gaps = [];
+    const slots = spec.slots.map((nodeSlot) => {
+        const items = nodeSlot.nodes.map((node, index) => {
+            const result = attachNode({
+                parentFactory: selfFactory,
+                parentType: nodeType,
+                parentChildRoot: spec.childRoot,
+                slot: nodeSlot.key,
+                list: nodeSlot.list,
+                path: childPath({ path, childRoot: spec.childRoot, slot: nodeSlot, index }),
+                node,
+            });
+            if (result.type === 'skip') {
+                gaps.push(result.gap);
+                return { type: 'skip', gap: result.gap };
+            }
+            gaps.push(...result.gaps);
+            return { type: 'typed', plan: result.plan };
+        });
+        return { key: nodeSlot.key, items };
+    });
+    const plan = { ...shallow, slots };
+    const probed = probe({ parentFactory, childRoot: parentChildRoot, slot, list, candidate: plan });
+    if (probed.type === 'error') {
+        return skip(`throws-${messageSlug(probed.message)}`, `the typed call throws: ${probed.message}`);
+    }
+    const built = pruneBuiltAt({ built: toJsonValue(probed.value), legacy, path, gaps });
+    const expected = toJsonValue(pruneAt({ value: legacy, path, gaps }));
+    if (isDeepStrictEqual(built, expected))
+        return { type: 'typed', plan, gaps };
+    const differing = differingKeys(built, expected);
+    const only = differing.length === 1 ? differing.at(0) : undefined;
+    if (only !== undefined) {
+        return skip(`option-${only}`, `the typed call builds a different "${only}"`);
+    }
+    return skip('output-differs', 'the typed call builds a different node');
+}
+/**
+ * Attaches one legacy component or action node to a parent slot (see `attachSpec`).
+ * A shape with no typed form is skipped as `shape`; a rule-rejected one as `type-rejects`.
+ */
+export function attachNode(options) {
+    const { node, path, parentType, slot } = options;
+    const parts = split(node);
+    const skipped = (reasonSlug, reason) => ({
+        type: 'skip',
+        gap: nodeGap({ nodeType: node.type, reasonSlug, reason, legacy: node, path }),
+    });
+    if (parts.type === 'shape')
+        return skipped('shape', 'the node shape has no typed form');
+    if (rejects({ type: node.type, input: parts.input, parentType, slot })) {
+        return skipped('type-rejects', `the SDK builds this shape but its types refuse it in "${slot}"`);
+    }
+    return attachSpec({
+        ...options,
+        spec: {
+            nodeType: node.type,
+            input: parts.input,
+            calls: parts.calls,
+            slots: parts.slots,
+            childRoot: 'options',
+            legacy: node,
+        },
+    });
+}
+//# sourceMappingURL=attach.js.map

package/dist/migrator/nodes/attach.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attach.js","sourceRoot":"","sources":["../../../src/migrator/nodes/attach.ts"],"names":[],"mappings":"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"}

package/dist/migrator/nodes/builder-access.d.ts

@@ -0,0 +1,16 @@
+/** Reads a public member of a builder or factory object; `undefined` when absent. */
+export declare function member(target: unknown, name: string): unknown;
+/**
+ * Calls a public method by dotted path (`leftElement.icon`) with `this` bound to its owner.
+ * @throws Error when the path does not end in a function
+ */
+export declare function invoke(target: unknown, path: string, args: readonly unknown[]): unknown;
+/** Whether `target` has a callable member at a dotted path. */
+export declare function hasMethod(target: unknown, path: string): boolean;
+/** JSON round trip: the form a built Application takes in `build/output.json`. */
+export declare function toJsonValue(value: unknown): unknown;
+/** One-line summary of an error: the first Zod issue, or the first line of its message. */
+export declare function firstLine(error: unknown): string;
+/** Short, stable gap-id slug of an error message: lower-case words joined by `-`, at most 40 chars. */
+export declare function messageSlug(message: string): string;
+//# sourceMappingURL=builder-access.d.ts.map

package/dist/migrator/nodes/builder-access.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder-access.d.ts","sourceRoot":"","sources":["../../../src/migrator/nodes/builder-access.ts"],"names":[],"mappings":"AAUA,qFAAqF;AACrF,wBAAgB,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAI7D;AAED;;;GAGG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,OAAO,EAAE,GAAG,OAAO,CASvF;AAED,+DAA+D;AAC/D,wBAAgB,SAAS,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAIhE;AAED,kFAAkF;AAClF,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAInD;AAeD,2FAA2F;AAC3F,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAGhD;AAED,uGAAuG;AACvG,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAcnD"}

package/dist/migrator/nodes/builder-access.js

@@ -0,0 +1,81 @@
+// Reflective access to core-sdk builders by member name.
+//
+// The engine probes builders whose concrete type is only known at run time (the
+// legacy node type picks the factory), so it reads and calls their public members
+// by name. Results stay `unknown`; nothing here reaches into protected state.
+function isObjectLike(value) {
+    return (typeof value === 'object' && value !== null) || typeof value === 'function';
+}
+/** Reads a public member of a builder or factory object; `undefined` when absent. */
+export function member(target, name) {
+    if (!isObjectLike(target))
+        return undefined;
+    const value = Reflect.get(target, name);
+    return value;
+}
+/**
+ * Calls a public method by dotted path (`leftElement.icon`) with `this` bound to its owner.
+ * @throws Error when the path does not end in a function
+ */
+export function invoke(target, path, args) {
+    const segments = path.split('.');
+    const name = segments.pop() ?? '';
+    let owner = target;
+    for (const segment of segments)
+        owner = member(owner, segment);
+    const fn = member(owner, name);
+    if (typeof fn !== 'function')
+        throw new Error(`No method "${path}"`);
+    const result = Reflect.apply(fn, owner, args);
+    return result;
+}
+/** Whether `target` has a callable member at a dotted path. */
+export function hasMethod(target, path) {
+    let owner = target;
+    for (const segment of path.split('.'))
+        owner = member(owner, segment);
+    return typeof owner === 'function';
+}
+/** JSON round trip: the form a built Application takes in `build/output.json`. */
+export function toJsonValue(value) {
+    const text = JSON.stringify(value ?? null);
+    const parsed = JSON.parse(text);
+    return parsed;
+}
+/** Message of the first issue of a Zod error (its `message` is the JSON issue list). */
+function zodIssueMessage(message) {
+    if (!message.startsWith('['))
+        return undefined;
+    try {
+        const issues = JSON.parse(message);
+        const list = Array.isArray(issues) ? issues : [];
+        const text = member(list.at(0), 'message');
+        return typeof text === 'string' ? text : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** One-line summary of an error: the first Zod issue, or the first line of its message. */
+export function firstLine(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return zodIssueMessage(message) ?? message.split('\n').at(0) ?? message;
+}
+/** Short, stable gap-id slug of an error message: lower-case words joined by `-`, at most 40 chars. */
+export function messageSlug(message) {
+    const words = message
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, ' ')
+        .trim()
+        .split(' ')
+        .filter((word) => word.length > 0);
+    let out = '';
+    for (const word of words) {
+        const next = out ? `${out}-${word}` : word;
+        if (next.length > 40)
+            break;
+        out = next;
+    }
+    return out || 'error';
+}
+//# sourceMappingURL=builder-access.js.map

package/dist/migrator/nodes/builder-access.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder-access.js","sourceRoot":"","sources":["../../../src/migrator/nodes/builder-access.ts"],"names":[],"mappings":"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"}

package/dist/migrator/nodes/codegen.d.ts

@@ -0,0 +1,33 @@
+import { type NodePlan } from './probe.js';
+/**
+ * Generated-code buffer for one module: statement chunks plus variable naming
+ * (`c1`, `a2`, `panel3`, `summary4`). Forks share the variable counter, so chunks
+ * generated separately for one module never reuse a name.
+ */
+export declare class Gen {
+    readonly lines: string[];
+    readonly indent = "  ";
+    private readonly counter;
+    constructor(counter?: {
+        value: number;
+    });
+    /** Returns the next free variable name with the given prefix. */
+    nextVar(prefix: string): string;
+    /** Appends one statement chunk (continuation lines carry their own indent). */
+    push(chunk: string): void;
+    /** An empty buffer that shares this buffer's variable counter. */
+    fork(): Gen;
+    /** The chunks as one `register`-body statement: every chunk after the first gets the body indent. */
+    code(): string;
+}
+/**
+ * Prints a verified plan under `parentExpr`: the factory call with chained calls, then
+ * unchained calls and children on its variable. Skipped children become
+ * `// TODO(migrate)` comments in their legacy position.
+ */
+export declare function emitPlan(options: {
+    readonly plan: NodePlan;
+    readonly parentExpr: string;
+    readonly gen: Gen;
+}): void;
+//# sourceMappingURL=codegen.d.ts.map

package/dist/migrator/nodes/codegen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codegen.d.ts","sourceRoot":"","sources":["../../../src/migrator/nodes/codegen.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAA;AAK1C;;;;GAIG;AACH,qBAAa,GAAG;IACd,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,CAAK;IAC7B,QAAQ,CAAC,MAAM,QAAc;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmB;IAE3C,YAAY,OAAO,GAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAiB,EAEpD;IAED,iEAAiE;IACjE,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAG9B;IAED,+EAA+E;IAC/E,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAExB;IAED,kEAAkE;IAClE,IAAI,IAAI,GAAG,CAEV;IAED,qGAAqG;IACrG,IAAI,IAAI,MAAM,CAEb;CACF;AAUD;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE;IAChC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAA;CAClB,GAAG,IAAI,CA2BP"}