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

package/dist/migrator/report.js

@@ -0,0 +1,53 @@
+import { isPlainObject } from './normalize.js';
+import { compareText } from './read-solution.js';
+const NODE_TYPE = /^(?:component|action|jig|datasource|widget)\.[A-Za-z0-9-]+$/;
+/** A node is a plain object whose `type` is a typed node type (`component.*`, `action.*`, `jig.*`, …). */
+function isNode(value) {
+    return isPlainObject(value) && typeof value.type === 'string' && NODE_TYPE.test(value.type);
+}
+function countDescendantNodes(value) {
+    const children = Array.isArray(value)
+        ? value
+        : isPlainObject(value)
+            ? Object.values(value)
+            : [];
+    let count = 0;
+    for (const child of children) {
+        count += (isNode(child) ? 1 : 0) + countDescendantNodes(child);
+    }
+    return count;
+}
+/**
+ * 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 function countNodes(options) {
+    const { value, asRoot } = options;
+    return (asRoot || isNode(value) ? 1 : 0) + countDescendantNodes(value);
+}
+/** Stable gap order: by relPath, then path, then gapId. */
+export function sortGaps(gaps) {
+    return [...gaps].sort((a, b) => compareText(a.location.relPath, b.location.relPath) ||
+        compareText(JSON.stringify(a.location.path), JSON.stringify(b.location.path)) ||
+        compareText(a.gapId, b.gapId));
+}
+/**
+ * Groups gaps by `gapId`, largest first: by skipped nodes, then occurrences, then gapId.
+ * Returns at most `limit` entries (all when omitted).
+ */
+export function summarizeGaps(options) {
+    const { gaps, limit } = options;
+    const byId = new Map();
+    for (const { gapId, skippedNodes } of gaps) {
+        const totals = byId.get(gapId) ?? { occurrences: 0, skippedNodes: 0 };
+        totals.occurrences += 1;
+        totals.skippedNodes += skippedNodes;
+        byId.set(gapId, totals);
+    }
+    const summary = [...byId].map(([gapId, totals]) => ({ gapId, ...totals }));
+    summary.sort((a, b) => b.skippedNodes - a.skippedNodes ||
+        b.occurrences - a.occurrences ||
+        compareText(a.gapId, b.gapId));
+    return limit === undefined ? summary : summary.slice(0, limit);
+}
+//# sourceMappingURL=report.js.map

package/dist/migrator/report.js.map

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

package/dist/migrator/ts-printer.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Prints a string literal.
+ *
+ * A string with a line feed (and no carriage return, which template literals
+ * normalize away) becomes a template literal with `\`, backtick and `${` escaped.
+ * Everything else becomes a single-quoted literal.
+ */
+export declare function str(value: string): string;
+/** Prints an object key: bare when it is an identifier, quoted otherwise; `__proto__` stays a data key. */
+export declare function key(name: string): string;
+/**
+ * Prints a JSON-like value (null, string, number, boolean, array, plain object) as a TS literal.
+ *
+ * Nested lines are indented relative to `indent`; the first line carries no indent.
+ * Object entries whose value is `undefined` are omitted.
+ * @throws Error when the value (or a nested value) is not JSON-like
+ */
+export declare function lit(value: unknown, indent?: string): string;
+//# sourceMappingURL=ts-printer.d.ts.map

package/dist/migrator/ts-printer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ts-printer.d.ts","sourceRoot":"","sources":["../../src/migrator/ts-printer.ts"],"names":[],"mappings":"AASA;;;;;;GAMG;AACH,wBAAgB,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAczC;AAED,2GAA2G;AAC3G,wBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGxC;AAMD;;;;;;GAMG;AACH,wBAAgB,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,SAAK,GAAG,MAAM,CAkBvD"}

package/dist/migrator/ts-printer.js

@@ -0,0 +1,70 @@
+// Prints JSON-like values as readable TypeScript literals.
+// Multi-line strings (SQL, JSONata) become template literals so they stay readable.
+const IDENTIFIER = /^[A-Za-z_$][A-Za-z0-9_$]*$/;
+function escapeControl(char) {
+    return `\\u${char.charCodeAt(0).toString(16).padStart(4, '0')}`;
+}
+/**
+ * Prints a string literal.
+ *
+ * A string with a line feed (and no carriage return, which template literals
+ * normalize away) becomes a template literal with `\`, backtick and `${` escaped.
+ * Everything else becomes a single-quoted literal.
+ */
+export function str(value) {
+    if (value.includes('\n') && !value.includes('\r')) {
+        const body = value.replace(/\\/g, '\\\\').replace(/`/g, '\\`').replace(/\$\{/g, '\\${');
+        return `\`${body}\``;
+    }
+    const body = value
+        .replace(/\\/g, '\\\\')
+        .replace(/'/g, "\\'")
+        .replace(/\n/g, '\\n')
+        .replace(/\r/g, '\\r')
+        .replace(/\t/g, '\\t')
+        // eslint-disable-next-line no-control-regex -- escapes the remaining C0 controls and DEL
+        .replace(/[\u0000-\u001f\u007f]/g, escapeControl);
+    return `'${body}'`;
+}
+/** Prints an object key: bare when it is an identifier, quoted otherwise; `__proto__` stays a data key. */
+export function key(name) {
+    if (name === '__proto__')
+        return `[${str(name)}]`;
+    return IDENTIFIER.test(name) ? name : str(name);
+}
+function isPlainObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/**
+ * Prints a JSON-like value (null, string, number, boolean, array, plain object) as a TS literal.
+ *
+ * Nested lines are indented relative to `indent`; the first line carries no indent.
+ * Object entries whose value is `undefined` are omitted.
+ * @throws Error when the value (or a nested value) is not JSON-like
+ */
+export function lit(value, indent = '') {
+    if (value === null)
+        return 'null';
+    if (typeof value === 'string')
+        return str(value);
+    if (typeof value === 'number')
+        return Object.is(value, -0) ? '-0' : String(value);
+    if (typeof value === 'boolean')
+        return String(value);
+    const inner = `${indent}  `;
+    if (Array.isArray(value)) {
+        if (value.length === 0)
+            return '[]';
+        const items = value.map((item) => `${inner}${lit(item, inner)},\n`).join('');
+        return `[\n${items}${indent}]`;
+    }
+    if (isPlainObject(value)) {
+        const entries = Object.entries(value).filter(([, item]) => item !== undefined);
+        if (entries.length === 0)
+            return '{}';
+        const items = entries.map(([name, item]) => `${inner}${key(name)}: ${lit(item, inner)},\n`);
+        return `{\n${items.join('')}${indent}}`;
+    }
+    throw new Error(`Cannot print ${typeof value} as a TypeScript literal`);
+}
+//# sourceMappingURL=ts-printer.js.map

package/dist/migrator/ts-printer.js.map

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

package/dist/migrator/verify-entity.d.ts

@@ -0,0 +1,21 @@
+import { type ComparableApplication } from './normalize.js';
+import { type EntityKind } from './read-solution.js';
+export interface VerifyEntityOptions {
+    readonly kind: EntityKind;
+    readonly id: string;
+    /** `toComparable(app.build())`. */
+    readonly built: ComparableApplication;
+    /** `toComparable(assembleLegacy(prune({ entries, gaps })))`: the pruned legacy. */
+    readonly legacy: ComparableApplication;
+}
+export interface VerifyEntityResult {
+    readonly equal: boolean;
+    /** Top-level keys whose values differ (both sides objects); empty otherwise. */
+    readonly differingKeys: readonly string[];
+}
+/**
+ * Compares one entity of the built Application with the same entity of the pruned legacy
+ * solution. Both sides are already normalized by `toComparable`.
+ */
+export declare function verifyEntity(options: VerifyEntityOptions): VerifyEntityResult;
+//# sourceMappingURL=verify-entity.d.ts.map

package/dist/migrator/verify-entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify-entity.d.ts","sourceRoot":"","sources":["../../src/migrator/verify-entity.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,qBAAqB,EAAiB,MAAM,gBAAgB,CAAA;AAC1E,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAEpD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,mCAAmC;IACnC,QAAQ,CAAC,KAAK,EAAE,qBAAqB,CAAA;IACrC,mFAAmF;IACnF,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAA;CACvC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;IACvB,gFAAgF;IAChF,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAA;CAC1C;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,kBAAkB,CAa7E"}

package/dist/migrator/verify-entity.js

@@ -0,0 +1,22 @@
+import { isDeepStrictEqual } from 'node:util';
+import { isPlainObject } from './normalize.js';
+/**
+ * Compares one entity of the built Application with the same entity of the pruned legacy
+ * solution. Both sides are already normalized by `toComparable`.
+ */
+export function verifyEntity(options) {
+    const { kind, id, built, legacy } = options;
+    const builtEntity = built[kind]?.[id];
+    const legacyEntity = legacy[kind]?.[id];
+    if (isDeepStrictEqual(builtEntity, legacyEntity))
+        return { equal: true, differingKeys: [] };
+    if (!isPlainObject(builtEntity) || !isPlainObject(legacyEntity)) {
+        return { equal: false, differingKeys: [] };
+    }
+    const names = [...new Set([...Object.keys(builtEntity), ...Object.keys(legacyEntity)])];
+    const differingKeys = names
+        .filter((name) => !isDeepStrictEqual(builtEntity[name], legacyEntity[name]))
+        .sort();
+    return { equal: false, differingKeys };
+}
+//# sourceMappingURL=verify-entity.js.map

package/dist/migrator/verify-entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify-entity.js","sourceRoot":"","sources":["../../src/migrator/verify-entity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAC7C,OAAO,EAA8B,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAkB1E;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,OAA4B;IACvD,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAA;IAC3C,MAAM,WAAW,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;IACrC,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;IACvC,IAAI,iBAAiB,CAAC,WAAW,EAAE,YAAY,CAAC;QAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,aAAa,EAAE,EAAE,EAAE,CAAA;IAC3F,IAAI,CAAC,aAAa,CAAC,WAAW,CAAC,IAAI,CAAC,aAAa,CAAC,YAAY,CAAC,EAAE,CAAC;QAChE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,EAAE,EAAE,CAAA;IAC5C,CAAC;IACD,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAA;IACvF,MAAM,aAAa,GAAG,KAAK;SACxB,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,iBAAiB,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;SAC3E,IAAI,EAAE,CAAA;IACT,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,CAAA;AACxC,CAAC"}

package/dist/scaffolder/index.d.ts

@@ -1,4 +1,5 @@
 export { scaffold, ScaffoldError } from './scaffold.js';
 export type { ScaffoldOptions, ScaffoldResult } from './scaffold.js';
+export { gitignore, packageJson, tsconfigJson } from './templates.js';
 export type { ApplicationType, TemplateInputs } from './templates.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/scaffolder/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/scaffolder/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AACvD,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AACpE,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/scaffolder/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AACvD,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AACpE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AACrE,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/scaffolder/index.js

@@ -1,2 +1,3 @@
 export { scaffold, ScaffoldError } from './scaffold.js';
+export { gitignore, packageJson, tsconfigJson } from './templates.js';
 //# sourceMappingURL=index.js.map

package/dist/scaffolder/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/scaffolder/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/scaffolder/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAEvD,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/scaffolder/templates.d.ts

@@ -4,8 +4,17 @@ export interface TemplateInputs {
     readonly type: ApplicationType;
 }
 export type ApplicationType = 'app' | 'data';
-export declare function packageJson(inputs: TemplateInputs): string;
-export declare function tsconfigJson(): string;
+/**
+ * Optional project template inputs. Omitted, the scaffolder output is unchanged.
+ */
+export interface ProjectTemplateOptions {
+    /** Pins `@jigx/core-sdk` to this exact version instead of the scaffolder range. */
+    readonly coreSdkVersion?: string;
+    /** Adds `@types/node` to `devDependencies` and `types: ["node"]` to tsconfig. */
+    readonly nodeTypes?: boolean;
+}
+export declare function packageJson(inputs: Pick<TemplateInputs, 'applicationName'> & ProjectTemplateOptions): string;
+export declare function tsconfigJson(options?: ProjectTemplateOptions): string;
 export declare function gitignore(): string;
 export declare function readme(inputs: TemplateInputs): string;
 export declare function claudeMd(): string;

package/dist/scaffolder/templates.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/scaffolder/templates.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;IAChC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAA;CAC/B;AAED,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,MAAM,CAAA;AAQ5C,wBAAgB,WAAW,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAqB1D;AAED,wBAAgB,YAAY,IAAI,MAAM,CAkBrC;AAED,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED,wBAAgB,MAAM,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAkCrD;AAED,wBAAgB,QAAQ,IAAI,MAAM,CAQjC;AAED,wBAAgB,KAAK,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CA2BpD"}
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/scaffolder/templates.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;IAChC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAA;CAC/B;AAED,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,MAAM,CAAA;AAQ5C;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,mFAAmF;IACnF,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAA;IAChC,iFAAiF;IACjF,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAC7B;AAID,wBAAgB,WAAW,CACzB,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,iBAAiB,CAAC,GAAG,sBAAsB,GACvE,MAAM,CAsBR;AAED,wBAAgB,YAAY,CAAC,OAAO,GAAE,sBAA2B,GAAG,MAAM,CAoBzE;AAED,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED,wBAAgB,MAAM,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAkCrD;AAED,wBAAgB,QAAQ,IAAI,MAAM,CAQjC;AAED,wBAAgB,KAAK,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CA2BpD"}

package/dist/scaffolder/templates.js

@@ -3,8 +3,9 @@
 // a release to `latest` (see release.yml) is what moves fresh scaffolds.
 // CLI/core-sdk version drift is accepted per ADR-0003.
 const coreSdkRange = '^1.0.0';
+const nodeTypesRange = '^22.0.0';
 export function packageJson(inputs) {
-    const { applicationName } = inputs;
+    const { applicationName, coreSdkVersion, nodeTypes = false } = inputs;
     const body = {
         name: applicationName,
         version: '0.0.0',
@@ -17,15 +18,17 @@ export function packageJson(inputs) {
             typecheck: 'tsc --build',
         },
         dependencies: {
-            '@jigx/core-sdk': coreSdkRange,
+            '@jigx/core-sdk': coreSdkVersion ?? coreSdkRange,
         },
         devDependencies: {
+            ...(nodeTypes ? { '@types/node': nodeTypesRange } : {}),
             typescript: '^5.9.3',
         },
     };
     return `${JSON.stringify(body, null, 2)}\n`;
 }
-export function tsconfigJson() {
+export function tsconfigJson(options = {}) {
+    const { nodeTypes = false } = options;
     const body = {
         compilerOptions: {
             target: 'es2024',
@@ -39,6 +42,7 @@ export function tsconfigJson() {
             noEmit: true,
             isolatedModules: true,
             forceConsistentCasingInFileNames: true,
+            ...(nodeTypes ? { types: ['node'] } : {}),
         },
         include: ['src/**/*.ts'],
     };

package/dist/scaffolder/templates.js.map

@@ -1 +1 @@
-{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../src/scaffolder/templates.ts"],"names":[],"mappings":"AAQA,wEAAwE;AACxE,+EAA+E;AAC/E,yEAAyE;AACzE,uDAAuD;AACvD,MAAM,YAAY,GAAG,QAAQ,CAAA;AAE7B,MAAM,UAAU,WAAW,CAAC,MAAsB;IAChD,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,CAAA;IAClC,MAAM,IAAI,GAAG;QACX,IAAI,EAAE,eAAe;QACrB,OAAO,EAAE,OAAO;QAChB,OAAO,EAAE,IAAI;QACb,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE;YACP,IAAI,EAAE,MAAM;SACb;QACD,OAAO,EAAE;YACP,SAAS,EAAE,aAAa;SACzB;QACD,YAAY,EAAE;YACZ,gBAAgB,EAAE,YAAY;SAC/B;QACD,eAAe,EAAE;YACf,UAAU,EAAE,QAAQ;SACrB;KACF,CAAA;IACD,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAA;AAC7C,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,MAAM,IAAI,GAAG;QACX,eAAe,EAAE;YACf,MAAM,EAAE,QAAQ;YAChB,MAAM,EAAE,UAAU;YAClB,gBAAgB,EAAE,UAAU;YAC5B,GAAG,EAAE,CAAC,QAAQ,CAAC;YACf,MAAM,EAAE,IAAI;YACZ,eAAe,EAAE,IAAI;YACrB,YAAY,EAAE,IAAI;YAClB,iBAAiB,EAAE,IAAI;YACvB,MAAM,EAAE,IAAI;YACZ,eAAe,EAAE,IAAI;YACrB,gCAAgC,EAAE,IAAI;SACvC;QACD,OAAO,EAAE,CAAC,aAAa,CAAC;KACzB,CAAA;IACD,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAA;AAC7C,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,OAAO,CAAC,eAAe,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACnD,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,MAAsB;IAC3C,MAAM,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,GAAG,MAAM,CAAA;IAC/C,OAAO,KAAK,KAAK;;;;wBAIK,eAAe;YAC3B,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;CA0Bf,CAAA;AACD,CAAC;AAED,MAAM,UAAU,QAAQ;IACtB,OAAO;;;;;;CAMR,CAAA;AACD,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,MAAsB;IAC1C,MAAM,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,GAAG,MAAM,CAAA;IAC/C,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;IAC1C,OAAO;;;WAGE,eAAe;WACf,YAAY;WACZ,IAAI;;;;;WAKJ,YAAY;;;;;;;;;;;;;CAatB,CAAA;AACD,CAAC"}
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../src/scaffolder/templates.ts"],"names":[],"mappings":"AAQA,wEAAwE;AACxE,+EAA+E;AAC/E,yEAAyE;AACzE,uDAAuD;AACvD,MAAM,YAAY,GAAG,QAAQ,CAAA;AAY7B,MAAM,cAAc,GAAG,SAAS,CAAA;AAEhC,MAAM,UAAU,WAAW,CACzB,MAAwE;IAExE,MAAM,EAAE,eAAe,EAAE,cAAc,EAAE,SAAS,GAAG,KAAK,EAAE,GAAG,MAAM,CAAA;IACrE,MAAM,IAAI,GAAG;QACX,IAAI,EAAE,eAAe;QACrB,OAAO,EAAE,OAAO;QAChB,OAAO,EAAE,IAAI;QACb,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE;YACP,IAAI,EAAE,MAAM;SACb;QACD,OAAO,EAAE;YACP,SAAS,EAAE,aAAa;SACzB;QACD,YAAY,EAAE;YACZ,gBAAgB,EAAE,cAAc,IAAI,YAAY;SACjD;QACD,eAAe,EAAE;YACf,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACvD,UAAU,EAAE,QAAQ;SACrB;KACF,CAAA;IACD,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAA;AAC7C,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAO,GAA2B,EAAE;IAC/D,MAAM,EAAE,SAAS,GAAG,KAAK,EAAE,GAAG,OAAO,CAAA;IACrC,MAAM,IAAI,GAAG;QACX,eAAe,EAAE;YACf,MAAM,EAAE,QAAQ;YAChB,MAAM,EAAE,UAAU;YAClB,gBAAgB,EAAE,UAAU;YAC5B,GAAG,EAAE,CAAC,QAAQ,CAAC;YACf,MAAM,EAAE,IAAI;YACZ,eAAe,EAAE,IAAI;YACrB,YAAY,EAAE,IAAI;YAClB,iBAAiB,EAAE,IAAI;YACvB,MAAM,EAAE,IAAI;YACZ,eAAe,EAAE,IAAI;YACrB,gCAAgC,EAAE,IAAI;YACtC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC1C;QACD,OAAO,EAAE,CAAC,aAAa,CAAC;KACzB,CAAA;IACD,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAA;AAC7C,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,OAAO,CAAC,eAAe,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACnD,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,MAAsB;IAC3C,MAAM,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,GAAG,MAAM,CAAA;IAC/C,OAAO,KAAK,KAAK;;;;wBAIK,eAAe;YAC3B,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;CA0Bf,CAAA;AACD,CAAC;AAED,MAAM,UAAU,QAAQ;IACtB,OAAO;;;;;;CAMR,CAAA;AACD,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,MAAsB;IAC1C,MAAM,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,GAAG,MAAM,CAAA;IAC/C,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;IAC1C,OAAO;;;WAGE,eAAe;WACf,YAAY;WACZ,IAAI;;;;;WAKJ,YAAY;;;;;;;;;;;;;CAatB,CAAA;AACD,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jigx/sdk-tools",
-  "version": "1.2.0-next.3",
+  "version": "1.2.0-next.5",
   "description": "Jigx SDK toolkit (jigx CLI) — scaffold, build, and publish Jigx Application projects",
   "license": "ISC",
   "type": "module",
@@ -59,6 +59,7 @@
   },
   "dependencies": {
     "@clack/prompts": "^0.11.0",
+    "@jigx/core-sdk": "1.2.0-next.12",
     "amazon-cognito-identity-js": "^6.3.20",
     "tsx": "^4.23.1",
     "yaml": "^2.9.0"