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

package/dist/migrator/project-writer.d.ts

@@ -0,0 +1,34 @@
+/** A file of the generated project, relative to the project root. */
+export interface ProjectFile {
+    readonly relPath: string;
+    readonly content: string;
+}
+/** One line group of `src/app.ts`: a registered module, or the TODO for a skipped entity. */
+export type AppEntry = {
+    readonly type: 'module';
+    /** Module path under `src/` without extension (e.g. `jigs/Orders/view-order`). */
+    readonly modulePath: string;
+} | {
+    readonly type: 'todo';
+    readonly gapId: string;
+    readonly reason: string;
+    readonly relPath: string;
+};
+/**
+ * Renders `src/app.ts`: imports every module in register order, creates the
+ * ApplicationBuilder from the index `application` input and calls each `register`.
+ */
+export declare function renderAppTs(options: {
+    readonly entries: readonly AppEntry[];
+}): string;
+/**
+ * Renders the project files around the migrated modules: `package.json` (exact
+ * `@jigx/core-sdk` pin, `@types/node`), `tsconfig.json` (`types: ["node"]`), `.gitignore`
+ * and `src/app.ts`.
+ */
+export declare function renderProjectFiles(options: {
+    readonly applicationName: string;
+    readonly coreSdkVersion: string;
+    readonly entries: readonly AppEntry[];
+}): readonly ProjectFile[];
+//# sourceMappingURL=project-writer.d.ts.map

package/dist/migrator/project-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-writer.d.ts","sourceRoot":"","sources":["../../src/migrator/project-writer.ts"],"names":[],"mappings":"AAKA,qEAAqE;AACrE,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB;AAED,6FAA6F;AAC7F,MAAM,MAAM,QAAQ,GAChB;IACE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;IACvB,kFAAkF;IAClF,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC5B,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB,CAAA;AAYL;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE;IAAE,QAAQ,CAAC,OAAO,EAAE,SAAS,QAAQ,EAAE,CAAA;CAAE,GAAG,MAAM,CA+BtF;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE;IAC1C,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;IAChC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,OAAO,EAAE,SAAS,QAAQ,EAAE,CAAA;CACtC,GAAG,SAAS,WAAW,EAAE,CAWzB"}

package/dist/migrator/project-writer.js

@@ -0,0 +1,65 @@
+import { gitignore, packageJson, tsconfigJson } from '../scaffolder/index.js';
+import { todoComment } from './module-writer.js';
+import { ENTITY_KINDS } from './read-solution.js';
+import { str } from './ts-printer.js';
+const INDEX_MODULE_PATH = 'index';
+function pascalCase(text) {
+    return text
+        .split(/[^A-Za-z0-9]+/)
+        .filter((part) => part.length > 0)
+        .map((part) => `${part.charAt(0).toUpperCase()}${part.slice(1)}`)
+        .join('');
+}
+/**
+ * Renders `src/app.ts`: imports every module in register order, creates the
+ * ApplicationBuilder from the index `application` input and calls each `register`.
+ */
+export function renderAppTs(options) {
+    const used = new Set();
+    const imports = [];
+    const calls = [];
+    for (const entry of options.entries) {
+        if (entry.type === 'todo') {
+            calls.push(todoComment({ gapId: entry.gapId, reason: `${entry.relPath}: ${entry.reason}` }));
+            continue;
+        }
+        const isIndex = entry.modulePath === INDEX_MODULE_PATH;
+        const base = `register${pascalCase(entry.modulePath)}`;
+        let identifier = base;
+        for (let suffix = 2; used.has(identifier); suffix++)
+            identifier = `${base}${suffix}`;
+        used.add(identifier);
+        const specifier = str(`./${entry.modulePath}.js`);
+        imports.push(isIndex
+            ? `import ${identifier}, { application } from ${specifier}`
+            : `import ${identifier} from ${specifier}`);
+        calls.push(`${identifier}(app)`);
+    }
+    return [
+        `// Generated by jigx migrate. Register order: ${ENTITY_KINDS.join(', ')}.`,
+        `import { ApplicationBuilder } from '@jigx/core-sdk'`,
+        ...imports,
+        '',
+        'export const app = new ApplicationBuilder(application)',
+        ...calls,
+        '',
+    ].join('\n');
+}
+/**
+ * Renders the project files around the migrated modules: `package.json` (exact
+ * `@jigx/core-sdk` pin, `@types/node`), `tsconfig.json` (`types: ["node"]`), `.gitignore`
+ * and `src/app.ts`.
+ */
+export function renderProjectFiles(options) {
+    const { applicationName, coreSdkVersion, entries } = options;
+    return [
+        {
+            relPath: 'package.json',
+            content: packageJson({ applicationName, coreSdkVersion, nodeTypes: true }),
+        },
+        { relPath: 'tsconfig.json', content: tsconfigJson({ nodeTypes: true }) },
+        { relPath: '.gitignore', content: gitignore() },
+        { relPath: 'src/app.ts', content: renderAppTs({ entries }) },
+    ];
+}
+//# sourceMappingURL=project-writer.js.map

package/dist/migrator/project-writer.js.map

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

package/dist/migrator/prune.d.ts

@@ -0,0 +1,58 @@
+import { type ComparableApplication } from './normalize.js';
+import { type LegacyEntry } from './read-solution.js';
+import { type GapLocation, type NodePathSegment } from './report.js';
+export interface PruneOptions {
+    readonly entries: readonly LegacyEntry[];
+    /** Skipped locations; an empty path removes the whole entity. */
+    readonly gaps: ReadonlyArray<{
+        readonly location: GapLocation;
+    }>;
+}
+type Path = readonly NodePathSegment[];
+/**
+ * Removes skipped subtrees from one legacy value that sits at `path` inside its entity,
+ * then the lists and `options` the skips emptied. Gap paths are entity paths (like
+ * `GapRecord.location.path`).
+ */
+export declare function pruneAt(options: {
+    readonly value: unknown;
+    readonly path: Path;
+    readonly gaps: ReadonlyArray<{
+        readonly path: Path;
+    }>;
+}): unknown;
+/**
+ * Built counterpart of `pruneAt`: removes from the built value the lists and `options`
+ * that pruning `legacy` empties, when they are empty in the build too.
+ */
+export declare function pruneBuiltAt(options: {
+    readonly built: unknown;
+    readonly legacy: unknown;
+    readonly path: Path;
+    readonly gaps: ReadonlyArray<{
+        readonly path: Path;
+    }>;
+}): unknown;
+/**
+ * Removes skipped nodes from legacy entries ("pruned legacy").
+ *
+ * A gap with an empty path drops its entity; any other path drops that subtree, then
+ * the lists and `options` the skips emptied (see `emptiedPaths`). Array items are
+ * removed, not nulled, so the remaining siblings keep their order. Paths refer to the
+ * original (unpruned) entity.
+ */
+export declare function prune(options: PruneOptions): readonly LegacyEntry[];
+/**
+ * Built counterpart of `prune`: removes from each built entity the lists and `options`
+ * its skips emptied, and from the built index its skipped top-level keys (a skipped
+ * constructor key such as `title` or `category` still appears with its SDK default).
+ */
+export declare function pruneBuilt(options: {
+    readonly built: ComparableApplication;
+    readonly entries: readonly LegacyEntry[];
+    readonly gaps: ReadonlyArray<{
+        readonly location: GapLocation;
+    }>;
+}): ComparableApplication;
+export {};
+//# sourceMappingURL=prune.d.ts.map

package/dist/migrator/prune.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prune.d.ts","sourceRoot":"","sources":["../../src/migrator/prune.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,qBAAqB,EAAiB,MAAM,gBAAgB,CAAA;AAC1E,OAAO,EAAkB,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAA;AACrE,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,eAAe,EAAE,MAAM,aAAa,CAAA;AAEpE,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,CAAA;IACxC,iEAAiE;IACjE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;QAAE,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAA;KAAE,CAAC,CAAA;CACjE;AAED,KAAK,IAAI,GAAG,SAAS,eAAe,EAAE,CAAA;AA0HtC;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE;IAC/B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;QAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAA;KAAE,CAAC,CAAA;CACtD,GAAG,OAAO,CAKV;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE;IACpC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;QAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAA;KAAE,CAAC,CAAA;CACtD,GAAG,OAAO,CAIV;AAcD;;;;;;;GAOG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,SAAS,WAAW,EAAE,CAgBnE;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE;IAClC,QAAQ,CAAC,KAAK,EAAE,qBAAqB,CAAA;IACrC,QAAQ,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,CAAA;IACxC,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;QAAE,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAA;KAAE,CAAC,CAAA;CACjE,GAAG,qBAAqB,CAkBxB"}

package/dist/migrator/prune.js

@@ -0,0 +1,171 @@
+import { isPlainObject } from './normalize.js';
+import { INDEX_REL_PATH } from './read-solution.js';
+function pathKey(path) {
+    return JSON.stringify(path);
+}
+function pruneValue(options) {
+    const { value, path, skipped } = options;
+    if (Array.isArray(value)) {
+        const out = [];
+        value.forEach((item, index) => {
+            const childPath = [...path, index];
+            if (!skipped.has(pathKey(childPath))) {
+                out.push(pruneValue({ value: item, path: childPath, skipped }));
+            }
+        });
+        return out;
+    }
+    if (isPlainObject(value)) {
+        const out = {};
+        for (const [name, item] of Object.entries(value)) {
+            const childPath = [...path, name];
+            if (!skipped.has(pathKey(childPath))) {
+                out[name] = pruneValue({ value: item, path: childPath, skipped });
+            }
+        }
+        return out;
+    }
+    return value;
+}
+/**
+ * Paths the skips empty: a list whose items are all skipped, and an `options` object
+ * whose remaining keys are all such lists (or none). Builders create a slot on its first
+ * entry, so these are absent in the build and empty in the pruned legacy.
+ *
+ * Returned in pruned coordinates: list indices shift when siblings are removed.
+ */
+function emptiedPaths(options) {
+    const { value, original, pruned, skipped } = options;
+    if (Array.isArray(value)) {
+        const out = [];
+        let next = 0;
+        value.forEach((item, index) => {
+            const at = [...original, index];
+            if (skipped.has(pathKey(at)))
+                return;
+            out.push(...emptiedPaths({ value: item, original: at, pruned: [...pruned, next], skipped }));
+            next++;
+        });
+        return value.length > 0 && next === 0 ? [pruned] : out;
+    }
+    if (isPlainObject(value)) {
+        const out = [];
+        const kept = [];
+        for (const [name, item] of Object.entries(value)) {
+            const at = [...original, name];
+            if (skipped.has(pathKey(at)))
+                continue;
+            kept.push(name);
+            out.push(...emptiedPaths({ value: item, original: at, pruned: [...pruned, name], skipped }));
+        }
+        const emptiedHere = new Set(out.filter((path) => path.length === pruned.length + 1).map((path) => pathKey(path)));
+        const optionsEmptied = pruned.at(-1) === 'options' &&
+            Object.keys(value).length > 0 &&
+            kept.every((name) => emptiedHere.has(pathKey([...pruned, name])));
+        return optionsEmptied ? [...out, pruned] : out;
+    }
+    return [];
+}
+/** Removes the values at `drop` when they are an empty list or object; everything else stays. */
+function withoutEmptyAt(options) {
+    const { value, path, drop } = options;
+    if (Array.isArray(value)) {
+        return value.map((item, index) => withoutEmptyAt({ value: item, path: [...path, index], drop }));
+    }
+    if (isPlainObject(value)) {
+        const out = {};
+        for (const [name, item] of Object.entries(value)) {
+            const at = [...path, name];
+            const kept = withoutEmptyAt({ value: item, path: at, drop });
+            const empty = (Array.isArray(kept) || isPlainObject(kept)) && Object.keys(kept).length === 0;
+            if (empty && drop.has(pathKey(at)))
+                continue;
+            out[name] = kept;
+        }
+        return out;
+    }
+    return value;
+}
+function emptiedSet(options) {
+    const { value, path, skipped } = options;
+    return new Set(emptiedPaths({ value, original: path, pruned: path, skipped }).map((emptied) => pathKey(emptied)));
+}
+/**
+ * Removes skipped subtrees from one legacy value that sits at `path` inside its entity,
+ * then the lists and `options` the skips emptied. Gap paths are entity paths (like
+ * `GapRecord.location.path`).
+ */
+export function pruneAt(options) {
+    const { value, path, gaps } = options;
+    const skipped = new Set(gaps.map((gap) => pathKey(gap.path)));
+    const pruned = pruneValue({ value, path, skipped });
+    return withoutEmptyAt({ value: pruned, path, drop: emptiedSet({ value, path, skipped }) });
+}
+/**
+ * Built counterpart of `pruneAt`: removes from the built value the lists and `options`
+ * that pruning `legacy` empties, when they are empty in the build too.
+ */
+export function pruneBuiltAt(options) {
+    const { built, legacy, path, gaps } = options;
+    const skipped = new Set(gaps.map((gap) => pathKey(gap.path)));
+    return withoutEmptyAt({ value: built, path, drop: emptiedSet({ value: legacy, path, skipped }) });
+}
+function skippedByRelPath(gaps) {
+    const byRelPath = new Map();
+    for (const { location } of gaps) {
+        const paths = byRelPath.get(location.relPath) ?? new Set();
+        paths.add(pathKey(location.path));
+        byRelPath.set(location.relPath, paths);
+    }
+    return byRelPath;
+}
+/**
+ * Removes skipped nodes from legacy entries ("pruned legacy").
+ *
+ * A gap with an empty path drops its entity; any other path drops that subtree, then
+ * the lists and `options` the skips emptied (see `emptiedPaths`). Array items are
+ * removed, not nulled, so the remaining siblings keep their order. Paths refer to the
+ * original (unpruned) entity.
+ */
+export function prune(options) {
+    const { entries, gaps } = options;
+    const byRelPath = skippedByRelPath(gaps);
+    const out = [];
+    for (const entry of entries) {
+        const skipped = byRelPath.get(entry.relPath);
+        if (!skipped) {
+            out.push(entry);
+            continue;
+        }
+        if (skipped.has(pathKey([])))
+            continue;
+        const pruned = pruneValue({ value: entry.entity, path: [], skipped });
+        const drop = emptiedSet({ value: entry.entity, path: [], skipped });
+        out.push({ ...entry, entity: withoutEmptyAt({ value: pruned, path: [], drop }) });
+    }
+    return out;
+}
+/**
+ * Built counterpart of `prune`: removes from each built entity the lists and `options`
+ * its skips emptied, and from the built index its skipped top-level keys (a skipped
+ * constructor key such as `title` or `category` still appears with its SDK default).
+ */
+export function pruneBuilt(options) {
+    const { built, entries, gaps } = options;
+    const byRelPath = skippedByRelPath(gaps);
+    let out = built;
+    for (const entry of entries) {
+        const skipped = byRelPath.get(entry.relPath);
+        const builtEntity = out[entry.kind]?.[entry.id];
+        if (!skipped || builtEntity === undefined)
+            continue;
+        const drop = emptiedSet({ value: entry.entity, path: [], skipped });
+        let kept = withoutEmptyAt({ value: builtEntity, path: [], drop });
+        if (entry.relPath === INDEX_REL_PATH && isPlainObject(kept)) {
+            kept = Object.fromEntries(Object.entries(kept).filter(([name]) => !skipped.has(pathKey([name]))));
+        }
+        out = { ...out, [entry.kind]: { ...out[entry.kind], [entry.id]: kept } };
+    }
+    return out;
+}
+//# sourceMappingURL=prune.js.map

package/dist/migrator/prune.js.map

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

package/dist/migrator/read-solution.d.ts

@@ -0,0 +1,38 @@
+/** Legacy folder kinds holding one `.jigx` entity per file. */
+export type FolderKind = 'databases' | 'functions' | 'datasources' | 'actions' | 'components' | 'jigs' | 'translations' | 'assets';
+/** Every entity kind of a legacy solution: the root `index.jigx`, the folder kinds and expression scripts. */
+export type EntityKind = 'index' | FolderKind | 'scripts';
+/** Register order of the generated `src/app.ts`; also the order of `readSolution` entries. */
+export declare const ENTITY_KINDS: readonly EntityKind[];
+export declare const FOLDER_KINDS: readonly FolderKind[];
+/** One legacy entity: a `.jigx` file, the root `index.jigx`, or one `scripts/expressions/*.js` file. */
+export interface LegacyEntry {
+    readonly kind: EntityKind;
+    /** Path relative to the solution dir, `/`-separated (e.g. `jigs/Orders/view-order.jigx`). */
+    readonly relPath: string;
+    /** File id: basename without `.jigx`; `index` for the root; the file name (with `.js`) for scripts. */
+    readonly id: string;
+    /** Parsed YAML value; the file content (string) for scripts. */
+    readonly entity: unknown;
+}
+export interface LegacySolution {
+    readonly entries: readonly LegacyEntry[];
+    /** Files that are not migrated (non-`.jigx` files in kind folders, non-script files, unknown root files). */
+    readonly ignored: readonly string[];
+}
+export interface ReadSolutionOptions {
+    readonly solutionDir: string;
+}
+/** relPath of the root index entity. */
+export declare const INDEX_REL_PATH = "index.jigx";
+/** Code-unit string order (locale independent, matches `Array.prototype.sort`). */
+export declare function compareText(a: string, b: string): number;
+/**
+ * Reads a legacy Jigx solution folder.
+ *
+ * Walks every kind folder recursively (nested subfolders keep their relPath),
+ * parses each `.jigx` file strictly and rejects duplicate ids within a kind.
+ * Only `scripts/expressions/*.js` are read as scripts; other files are listed as ignored.
+ */
+export declare function readSolution(options: ReadSolutionOptions): Promise<LegacySolution>;
+//# sourceMappingURL=read-solution.d.ts.map

package/dist/migrator/read-solution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-solution.d.ts","sourceRoot":"","sources":["../../src/migrator/read-solution.ts"],"names":[],"mappings":"AAKA,+DAA+D;AAC/D,MAAM,MAAM,UAAU,GAClB,WAAW,GACX,WAAW,GACX,aAAa,GACb,SAAS,GACT,YAAY,GACZ,MAAM,GACN,cAAc,GACd,QAAQ,CAAA;AAEZ,8GAA8G;AAC9G,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,CAAA;AAEzD,8FAA8F;AAC9F,eAAO,MAAM,YAAY,EAAE,SAAS,UAAU,EAW7C,CAAA;AAED,eAAO,MAAM,YAAY,EAAE,SAAS,UAAU,EAS7C,CAAA;AAED,wGAAwG;AACxG,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;IACzB,6FAA6F;IAC7F,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,uGAAuG;IACvG,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,gEAAgE;IAChE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,CAAA;IACxC,6GAA6G;IAC7G,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;CACpC;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;CAC7B;AAED,wCAAwC;AACxC,eAAO,MAAM,cAAc,eAAe,CAAA;AAyC1C,mFAAmF;AACnF,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAGxD;AAMD;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,CAAC,CAmExF"}

package/dist/migrator/read-solution.js

@@ -0,0 +1,144 @@
+import { readdir, readFile } from 'node:fs/promises';
+import path from 'node:path';
+import { parseDocument } from 'yaml';
+import { MigrateError } from './errors.js';
+/** Register order of the generated `src/app.ts`; also the order of `readSolution` entries. */
+export const ENTITY_KINDS = [
+    'index',
+    'databases',
+    'functions',
+    'datasources',
+    'actions',
+    'components',
+    'jigs',
+    'translations',
+    'assets',
+    'scripts',
+];
+export const FOLDER_KINDS = [
+    'databases',
+    'functions',
+    'datasources',
+    'actions',
+    'components',
+    'jigs',
+    'translations',
+    'assets',
+];
+/** relPath of the root index entity. */
+export const INDEX_REL_PATH = 'index.jigx';
+const INDEX_FILE = INDEX_REL_PATH;
+const SCRIPTS_DIR = 'scripts';
+const EXPRESSIONS_DIR = 'expressions';
+function isFolderKind(name) {
+    return FOLDER_KINDS.some((kind) => kind === name);
+}
+function toPosix(relPath) {
+    return relPath.split(path.sep).join('/');
+}
+/** Parses one `.jigx` file strictly: duplicate keys, multiple documents and syntax errors fail. */
+function parseJigx(options) {
+    const { relPath, source } = options;
+    const doc = parseDocument(source, { merge: true, uniqueKeys: true });
+    if (doc.errors.length > 0) {
+        const messages = doc.errors.map((error) => error.message.split('\n')[0]).join('; ');
+        throw new MigrateError(`Invalid YAML in ${relPath}: ${messages}`);
+    }
+    const value = doc.toJS();
+    if (value === null || value === undefined) {
+        throw new MigrateError(`Empty .jigx file: ${relPath}`);
+    }
+    return value;
+}
+async function listFiles(dir) {
+    try {
+        const entries = await readdir(dir, { recursive: true, withFileTypes: true });
+        return entries
+            .filter((entry) => entry.isFile() && !entry.name.startsWith('.'))
+            .map((entry) => path.relative(dir, path.join(entry.parentPath, entry.name)))
+            .sort();
+    }
+    catch (error) {
+        if (error instanceof Error && 'code' in error && error.code === 'ENOENT')
+            return [];
+        throw error;
+    }
+}
+/** Code-unit string order (locale independent, matches `Array.prototype.sort`). */
+export function compareText(a, b) {
+    if (a === b)
+        return 0;
+    return a < b ? -1 : 1;
+}
+function kindOrder(kind) {
+    return ENTITY_KINDS.indexOf(kind);
+}
+/**
+ * Reads a legacy Jigx solution folder.
+ *
+ * Walks every kind folder recursively (nested subfolders keep their relPath),
+ * parses each `.jigx` file strictly and rejects duplicate ids within a kind.
+ * Only `scripts/expressions/*.js` are read as scripts; other files are listed as ignored.
+ */
+export async function readSolution(options) {
+    const { solutionDir } = options;
+    const entries = [];
+    const ignored = [];
+    const rootEntries = await readdir(solutionDir, { withFileTypes: true }).catch((error) => {
+        if (error instanceof Error && 'code' in error && error.code === 'ENOENT') {
+            throw new MigrateError(`Solution dir not found: ${solutionDir}`);
+        }
+        throw error;
+    });
+    if (!rootEntries.some((entry) => entry.isFile() && entry.name === INDEX_FILE)) {
+        throw new MigrateError(`Missing ${INDEX_FILE} in ${solutionDir}`);
+    }
+    for (const rootEntry of rootEntries) {
+        const name = rootEntry.name;
+        if (name.startsWith('.') || name === INDEX_FILE)
+            continue;
+        if (rootEntry.isDirectory() && (isFolderKind(name) || name === SCRIPTS_DIR))
+            continue;
+        ignored.push(rootEntry.isDirectory() ? `${name}/` : name);
+    }
+    const indexSource = await readFile(path.join(solutionDir, INDEX_FILE), 'utf8');
+    entries.push({
+        kind: 'index',
+        relPath: INDEX_FILE,
+        id: 'index',
+        entity: parseJigx({ relPath: INDEX_FILE, source: indexSource }),
+    });
+    for (const kind of FOLDER_KINDS) {
+        const kindDir = path.join(solutionDir, kind);
+        const seen = new Map();
+        for (const file of await listFiles(kindDir)) {
+            const relPath = toPosix(path.join(kind, file));
+            if (!file.endsWith('.jigx')) {
+                ignored.push(relPath);
+                continue;
+            }
+            const id = path.basename(file, '.jigx');
+            const previous = seen.get(id);
+            if (previous !== undefined) {
+                throw new MigrateError(`Duplicate ${kind} id "${id}": ${previous} and ${relPath}`);
+            }
+            seen.set(id, relPath);
+            const source = await readFile(path.join(kindDir, file), 'utf8');
+            entries.push({ kind, relPath, id, entity: parseJigx({ relPath, source }) });
+        }
+    }
+    const scriptsDir = path.join(solutionDir, SCRIPTS_DIR);
+    for (const file of await listFiles(scriptsDir)) {
+        const relPath = toPosix(path.join(SCRIPTS_DIR, file));
+        const isExpressionScript = path.dirname(file) === EXPRESSIONS_DIR && path.extname(file) === '.js';
+        if (!isExpressionScript) {
+            ignored.push(relPath);
+            continue;
+        }
+        const source = await readFile(path.join(scriptsDir, file), 'utf8');
+        entries.push({ kind: 'scripts', relPath, id: path.basename(file), entity: source });
+    }
+    entries.sort((a, b) => kindOrder(a.kind) - kindOrder(b.kind) || compareText(a.relPath, b.relPath));
+    return { entries, ignored: ignored.sort() };
+}
+//# sourceMappingURL=read-solution.js.map

package/dist/migrator/read-solution.js.map

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

package/dist/migrator/report.d.ts

@@ -0,0 +1,76 @@
+/** Path segment inside a legacy entity: an object key or an array index. */
+export type NodePathSegment = string | number;
+/** Where a skipped node sits: the legacy file and the path inside it (`[]` for the whole entity). */
+export interface GapLocation {
+    readonly relPath: string;
+    readonly path: readonly NodePathSegment[];
+}
+/**
+ * One skipped node, index key or entity.
+ *
+ * `gapId` is `<nodeType>:<reason-slug>` and links the report, the `// TODO(migrate)`
+ * comment, the gap registry and its expected-failure test.
+ */
+export interface GapRecord {
+    readonly gapId: string;
+    readonly nodeType: string;
+    readonly reason: string;
+    /** The skipped node and all its descendant nodes. */
+    readonly skippedNodes: number;
+    readonly location: GapLocation;
+}
+/** A skipped node inside an entity: a `GapRecord` whose location is relative to the entity. */
+export interface NodeGap {
+    readonly gapId: string;
+    readonly nodeType: string;
+    readonly reason: string;
+    /** The skipped node and all its descendant nodes. */
+    readonly skippedNodes: number;
+    /** Path of the skipped node inside its entity. */
+    readonly path: readonly NodePathSegment[];
+}
+export interface MigrationReport {
+    /** Exact `@jigx/core-sdk` version the migrator verified against (and the project pins). */
+    readonly coreSdkVersion: string;
+    readonly entities: {
+        readonly total: number;
+        readonly migrated: number;
+        readonly skipped: number;
+    };
+    /** `typed + skipped = total`. */
+    readonly nodes: {
+        readonly total: number;
+        readonly typed: number;
+        readonly skipped: number;
+    };
+    readonly gaps: readonly GapRecord[];
+    /** Solution files that are not migrated (relPaths). */
+    readonly ignored: readonly string[];
+}
+/**
+ * Counts the nodes in a value: nested nodes, plus the value itself when it is a node
+ * or when `asRoot` is set (an entity root always counts as one node).
+ */
+export declare function countNodes(options: {
+    readonly value: unknown;
+    readonly asRoot: boolean;
+}): number;
+/** Stable gap order: by relPath, then path, then gapId. */
+export declare function sortGaps(gaps: readonly GapRecord[]): readonly GapRecord[];
+/** Totals of one gap id across the report. */
+export interface GapSummary {
+    readonly gapId: string;
+    /** Gap records with this id. */
+    readonly occurrences: number;
+    /** Skipped nodes of all its records. */
+    readonly skippedNodes: number;
+}
+/**
+ * Groups gaps by `gapId`, largest first: by skipped nodes, then occurrences, then gapId.
+ * Returns at most `limit` entries (all when omitted).
+ */
+export declare function summarizeGaps(options: {
+    readonly gaps: readonly GapRecord[];
+    readonly limit?: number;
+}): readonly GapSummary[];
+//# sourceMappingURL=report.d.ts.map

package/dist/migrator/report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../src/migrator/report.ts"],"names":[],"mappings":"AAGA,4EAA4E;AAC5E,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,MAAM,CAAA;AAE7C,qGAAqG;AACrG,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,IAAI,EAAE,SAAS,eAAe,EAAE,CAAA;CAC1C;AAED;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,qDAAqD;IACrD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAA;CAC/B;AAED,+FAA+F;AAC/F,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,qDAAqD;IACrD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,kDAAkD;IAClD,QAAQ,CAAC,IAAI,EAAE,SAAS,eAAe,EAAE,CAAA;CAC1C;AAED,MAAM,WAAW,eAAe;IAC9B,2FAA2F;IAC3F,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,QAAQ,EAAE;QACjB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;QACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;QACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KACzB,CAAA;IACD,iCAAiC;IACjC,QAAQ,CAAC,KAAK,EAAE;QACd,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;QACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;QACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KACzB,CAAA;IACD,QAAQ,CAAC,IAAI,EAAE,SAAS,SAAS,EAAE,CAAA;IACnC,uDAAuD;IACvD,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;CACpC;AAsBD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE;IAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GAAG,MAAM,CAGjG;AAED,2DAA2D;AAC3D,wBAAgB,QAAQ,CAAC,IAAI,EAAE,SAAS,SAAS,EAAE,GAAG,SAAS,SAAS,EAAE,CAOzE;AAED,8CAA8C;AAC9C,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,gCAAgC;IAChC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,wCAAwC;IACxC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;CAC9B;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE;IACrC,QAAQ,CAAC,IAAI,EAAE,SAAS,SAAS,EAAE,CAAA;IACnC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CACxB,GAAG,SAAS,UAAU,EAAE,CAiBxB"}