create-relkit 0.6.0 → 0.7.0

package/dist/source-edit.js

@@ -1,14 +1,28 @@
 import * as ts from "typescript";
-import { ADD_FAILURE_CODES, AddScaffoldError } from "./add-types.js";
 export { addSourceImport } from "./source-import-edit.js";
-/** Appends one export declaration after validating the source syntax. */
+/**
+ * Appends one export declaration after validating the source syntax.
+ * @param source - Authored source text inspected or transformed without execution.
+ * @param fileName - Source path used for declaration diagnostics.
+ * @param declaration - Complete export declaration source.
+ * @returns Original source when present, otherwise source with the validated export appended.
+ */
 export function addSourceExport(source, fileName, declaration) {
     if (source.includes(declaration))
         return source;
     parse(fileName, source);
     return `${source.trimEnd()}\n${declaration}\n`;
 }
-/** Inserts one property into a canonical factory object or one nested object property. */
+/**
+ * Inserts one property into a canonical factory object or one nested object property.
+ * @param source - Authored source text inspected or transformed without execution.
+ * @param fileName - Source path used for declaration diagnostics.
+ * @param factories - Supported final segments of factory call names.
+ * @param path - Nested static property names containing the target member.
+ * @param memberName - Static object member name being inserted.
+ * @param memberSource - Source of the object member to insert.
+ * @returns Source with the member inserted, or unchanged when an identical member already exists.
+ */
 export function addFactoryObjectMember(source, fileName, factories, path, memberName, memberSource) {
     const file = parse(fileName, source);
     const root = factoryObject(file, factories);
@@ -24,9 +38,25 @@ export function addFactoryObjectMember(source, fileName, factories, path, member
     const insertion = target.created ? `${target.name}: { ${memberSource} }` : memberSource;
     return insertMember(source, target.parent ?? target.object, insertion);
 }
+/**
+ * Parses the one supported factory object before editing its declarations.
+ * @param source - Authored source text inspected or transformed without execution.
+ * @param fileName - Source path used for declaration diagnostics.
+ * @param factories - Supported final segments of factory call names.
+ * @returns The uniquely matched factory's object-literal argument.
+ */
 export function readFactoryObject(source, fileName, factories) {
     return factoryObject(parse(fileName, source), factories);
 }
+/**
+ * Reads one literal string property from a supported factory call.
+ * @param source - Authored source text inspected or transformed without execution.
+ * @param fileName - Source path used for declaration diagnostics.
+ * @param factory - Supported factory call name.
+ * @param name - Authored name or declaration key.
+ * @param argumentIndex - Zero-based factory argument containing the static options object.
+ * @returns The literal string property, or undefined when absent or nonliteral.
+ */
 export function readFactoryStringProperty(source, fileName, factory, name, argumentIndex = 0) {
     const object = factoryObject(parse(fileName, source), [factory], argumentIndex);
     const item = property(object, name);
@@ -34,6 +64,11 @@ export function readFactoryStringProperty(source, fileName, factory, name, argum
         ? item.initializer.text
         : undefined;
 }
+/**
+ * Reads statically known property names without evaluating computed expressions.
+ * @param node - Optional property-name AST inspected for a static value.
+ * @returns The static identifier/string/number property text, or undefined for computed names.
+ */
 export function staticPropertyName(node) {
     if (node === undefined)
         return undefined;
@@ -42,95 +77,5 @@ export function staticPropertyName(node) {
     }
     return undefined;
 }
-function factoryObject(file, factories, argumentIndex = 0) {
-    const matches = [];
-    const visit = (node) => {
-        if (ts.isCallExpression(node) && factories.includes(lastSegment(node.expression))) {
-            const argument = unwrap(node.arguments[argumentIndex]);
-            if (!argument || !ts.isObjectLiteralExpression(argument))
-                unsupported(file.fileName);
-            matches.push(argument);
-        }
-        ts.forEachChild(node, visit);
-    };
-    visit(file);
-    if (matches.length !== 1)
-        unsupported(file.fileName);
-    return matches[0];
-}
-function descend(root, path, source, memberSource) {
-    let object = root;
-    for (const [index, name] of path.entries()) {
-        assertObject(object, source);
-        const found = property(object, name);
-        if (found === undefined) {
-            if (index !== path.length - 1)
-                unsupported("nested object");
-            return { object, parent: object, name, created: true };
-        }
-        if (!ts.isPropertyAssignment(found))
-            unsupported(name);
-        const value = unwrap(found.initializer);
-        if (!value || !ts.isObjectLiteralExpression(value))
-            unsupported(name);
-        object = value;
-    }
-    return { object, name: path.at(-1) ?? memberSource, created: false };
-}
-function insertMember(source, object, member) {
-    const close = object.getEnd() - 1;
-    const body = source.slice(object.getStart() + 1, close);
-    if (object.properties.length === 0) {
-        return `${source.slice(0, object.getStart() + 1)} ${member} ${source.slice(close)}`;
-    }
-    if (!body.includes("\n")) {
-        const last = object.properties.at(-1);
-        return `${source.slice(0, last.getEnd())}, ${member}${source.slice(last.getEnd())}`;
-    }
-    const last = object.properties.at(-1);
-    const between = source.slice(last.getEnd(), close);
-    const comma = between.trimStart().startsWith(",") ? "" : ",";
-    const lineStart = source.lastIndexOf("\n", close - 1) + 1;
-    const closeIndent = source.slice(lineStart, close);
-    return `${source.slice(0, last.getEnd())}${comma}${source.slice(last.getEnd(), close)}${closeIndent}  ${member},\n${closeIndent}${source.slice(close)}`;
-}
-function assertObject(object, source) {
-    for (const item of object.properties) {
-        if (ts.isSpreadAssignment(item) || staticPropertyName(item.name) === undefined) {
-            unsupported(source.slice(item.getStart(), item.getEnd()));
-        }
-    }
-}
-function property(object, name) {
-    return object.properties.find((item) => staticPropertyName(item.name) === name);
-}
-function parse(fileName, source) {
-    const file = ts.createSourceFile(fileName, source, ts.ScriptTarget.Latest, true, ts.ScriptKind.TS);
-    const diagnostics = file.parseDiagnostics;
-    if (diagnostics?.length)
-        unsupported(fileName);
-    return file;
-}
-function unwrap(value) {
-    let current = value;
-    while (current &&
-        (ts.isParenthesizedExpression(current) ||
-            ts.isAsExpression(current) ||
-            ts.isSatisfiesExpression(current)))
-        current = current.expression;
-    return current;
-}
-function lastSegment(expression) {
-    return ts.isIdentifier(expression)
-        ? expression.text
-        : ts.isPropertyAccessExpression(expression)
-            ? expression.name.text
-            : "";
-}
-function collision(fileName, path) {
-    throw new AddScaffoldError(ADD_FAILURE_CODES.collision, `${fileName} already declares ${path.join(".")}.`);
-}
-function unsupported(label) {
-    throw new AddScaffoldError(ADD_FAILURE_CODES.unsupportedSourceShape, `Cannot safely edit canonical object in ${label}.`);
-}
+import { factoryObject, descend, insertMember, assertObject, property, parse, collision, } from "./source-factory-edit.js";
 //# sourceMappingURL=source-edit.js.map

package/dist/source-edit.js.map

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

package/dist/source-factory-edit.d.ts

@@ -0,0 +1,78 @@
+import * as ts from "typescript";
+/**
+ * Requires exactly one factory call with a static object argument.
+ * @param file - TypeScript SourceFile AST.
+ * @param factories - Supported final segments of factory call names.
+ * @param argumentIndex - Zero-based factory argument containing its options object.
+ * @returns The unique object literal; ambiguous/nonliteral source raises the unsupported-source error.
+ */
+export declare function factoryObject(file: ts.SourceFile, factories: readonly string[], argumentIndex?: number): ts.ObjectLiteralExpression;
+/**
+ * Finds a nested literal object or plans its missing final member container.
+ * @param root - Root object-literal AST.
+ * @param path - Nested static property names to traverse.
+ * @param source - Authored source text inspected or transformed without execution.
+ * @param memberSource - Source of the object member to insert.
+ * @returns The existing target object or missing final-container projection needed for insertion.
+ */
+export declare function descend(root: ts.ObjectLiteralExpression, path: readonly string[], source: string, memberSource: string): {
+    readonly object: ts.ObjectLiteralExpression;
+    readonly parent?: ts.ObjectLiteralExpression;
+    readonly name: string;
+    readonly created: boolean;
+};
+/**
+ * Inserts a static object member without reprinting the source file.
+ * @param source - Authored source text inspected or transformed without execution.
+ * @param object - Object-literal AST whose properties are inspected.
+ * @param member - Source of the object member to insert.
+ * @returns Source with one member inserted while preserving surrounding formatting.
+ */
+export declare function insertMember(source: string, object: ts.ObjectLiteralExpression, member: string): string;
+/**
+ * Rejects object spreads and dynamic member names before source editing.
+ * @param object - Object-literal AST whose properties are inspected.
+ * @param source - Authored source text inspected or transformed without execution.
+ * @returns Completion after the existing contract has been applied.
+ */
+export declare function assertObject(object: ts.ObjectLiteralExpression, source: string): void;
+/**
+ * Finds one statically named property in an object literal.
+ * @param object - Object-literal AST whose direct properties are inspected.
+ * @param name - Static property name to match.
+ * @returns The matching property, or undefined when absent.
+ */
+export declare function property(object: ts.ObjectLiteralExpression, name: string): ts.ObjectLiteralElementLike | undefined;
+/**
+ * Parses TypeScript for source inspection without executing the application.
+ * @param fileName - Source path used in parser diagnostics.
+ * @param source - Authored TypeScript source text.
+ * @returns The SourceFile AST; parse errors raise the canonical unsupported-source error.
+ */
+export declare function parse(fileName: string, source: string): ts.SourceFile;
+/**
+ * Removes parentheses and TypeScript assertions from a source expression.
+ * @param value - AST expression whose static wrapper nodes are ignored.
+ * @returns The underlying expression, or undefined when no expression was supplied.
+ */
+export declare function unwrap(value: ts.Expression | undefined): ts.Expression | undefined;
+/**
+ * Reads the statically named final segment of a factory expression.
+ * @param expression - Factory expression whose final identifier is inspected.
+ * @returns The identifier or final property segment, otherwise an empty string.
+ */
+export declare function lastSegment(expression: ts.Expression): string;
+/**
+ * Rejects an object member that conflicts with the requested source insertion.
+ * @param fileName - Source path used for declaration diagnostics.
+ * @param path - Nested static property names identifying the conflicting member.
+ * @returns No value; throws AddScaffoldError with RELKIT_ADD_COLLISION.
+ */
+export declare function collision(fileName: string, path: readonly string[]): never;
+/**
+ * Rejects a canonical object that cannot be edited safely.
+ * @param label - Human-readable location included in validation diagnostics.
+ * @returns No value; the unchanged canonical public validation error is thrown.
+ */
+export declare function unsupported(label: string): never;
+//# sourceMappingURL=source-factory-edit.d.ts.map

package/dist/source-factory-edit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-factory-edit.d.ts","sourceRoot":"","sources":["../src/source-factory-edit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AAGjC;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,EAAE,CAAC,UAAU,EACnB,SAAS,EAAE,SAAS,MAAM,EAAE,EAC5B,aAAa,SAAI,GAChB,EAAE,CAAC,uBAAuB,CAa5B;AAED;;;;;;;GAOG;AACH,wBAAgB,OAAO,CACrB,IAAI,EAAE,EAAE,CAAC,uBAAuB,EAChC,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,GACnB;IACD,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,uBAAuB,CAAC;IAC5C,QAAQ,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,uBAAuB,CAAC;IAC7C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B,CAeA;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,EAAE,CAAC,uBAAuB,EAClC,MAAM,EAAE,MAAM,GACb,MAAM,CAgBR;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,EAAE,CAAC,uBAAuB,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAMrF;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CACtB,MAAM,EAAE,EAAE,CAAC,uBAAuB,EAClC,IAAI,EAAE,MAAM,GACX,EAAE,CAAC,wBAAwB,GAAG,SAAS,CAEzC;AAED;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,EAAE,CAAC,UAAU,CAarE;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC,UAAU,GAAG,SAAS,GAAG,EAAE,CAAC,UAAU,GAAG,SAAS,CAUlF;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,GAAG,MAAM,CAM7D;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,KAAK,CAK1E;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,CAKhD"}

package/dist/source-factory-edit.js

@@ -0,0 +1,156 @@
+import * as ts from "typescript";
+import { ADD_FAILURE_CODES, AddScaffoldError } from "./add-types.js";
+/**
+ * Requires exactly one factory call with a static object argument.
+ * @param file - TypeScript SourceFile AST.
+ * @param factories - Supported final segments of factory call names.
+ * @param argumentIndex - Zero-based factory argument containing its options object.
+ * @returns The unique object literal; ambiguous/nonliteral source raises the unsupported-source error.
+ */
+export function factoryObject(file, factories, argumentIndex = 0) {
+    const matches = [];
+    const visit = (node) => {
+        if (ts.isCallExpression(node) && factories.includes(lastSegment(node.expression))) {
+            const argument = unwrap(node.arguments[argumentIndex]);
+            if (!argument || !ts.isObjectLiteralExpression(argument))
+                unsupported(file.fileName);
+            matches.push(argument);
+        }
+        ts.forEachChild(node, visit);
+    };
+    visit(file);
+    if (matches.length !== 1)
+        unsupported(file.fileName);
+    return matches[0];
+}
+/**
+ * Finds a nested literal object or plans its missing final member container.
+ * @param root - Root object-literal AST.
+ * @param path - Nested static property names to traverse.
+ * @param source - Authored source text inspected or transformed without execution.
+ * @param memberSource - Source of the object member to insert.
+ * @returns The existing target object or missing final-container projection needed for insertion.
+ */
+export function descend(root, path, source, memberSource) {
+    let object = root;
+    for (const [index, name] of path.entries()) {
+        assertObject(object, source);
+        const found = property(object, name);
+        if (found === undefined) {
+            if (index !== path.length - 1)
+                unsupported("nested object");
+            return { object, parent: object, name, created: true };
+        }
+        if (!ts.isPropertyAssignment(found))
+            unsupported(name);
+        const value = unwrap(found.initializer);
+        if (!value || !ts.isObjectLiteralExpression(value))
+            unsupported(name);
+        object = value;
+    }
+    return { object, name: path.at(-1) ?? memberSource, created: false };
+}
+/**
+ * Inserts a static object member without reprinting the source file.
+ * @param source - Authored source text inspected or transformed without execution.
+ * @param object - Object-literal AST whose properties are inspected.
+ * @param member - Source of the object member to insert.
+ * @returns Source with one member inserted while preserving surrounding formatting.
+ */
+export function insertMember(source, object, member) {
+    const close = object.getEnd() - 1;
+    const body = source.slice(object.getStart() + 1, close);
+    if (object.properties.length === 0) {
+        return `${source.slice(0, object.getStart() + 1)} ${member} ${source.slice(close)}`;
+    }
+    if (!body.includes("\n")) {
+        const last = object.properties.at(-1);
+        return `${source.slice(0, last.getEnd())}, ${member}${source.slice(last.getEnd())}`;
+    }
+    const last = object.properties.at(-1);
+    const between = source.slice(last.getEnd(), close);
+    const comma = between.trimStart().startsWith(",") ? "" : ",";
+    const lineStart = source.lastIndexOf("\n", close - 1) + 1;
+    const closeIndent = source.slice(lineStart, close);
+    return `${source.slice(0, last.getEnd())}${comma}${source.slice(last.getEnd(), close)}${closeIndent}  ${member},\n${closeIndent}${source.slice(close)}`;
+}
+/**
+ * Rejects object spreads and dynamic member names before source editing.
+ * @param object - Object-literal AST whose properties are inspected.
+ * @param source - Authored source text inspected or transformed without execution.
+ * @returns Completion after the existing contract has been applied.
+ */
+export function assertObject(object, source) {
+    for (const item of object.properties) {
+        if (ts.isSpreadAssignment(item) || staticPropertyName(item.name) === undefined) {
+            unsupported(source.slice(item.getStart(), item.getEnd()));
+        }
+    }
+}
+/**
+ * Finds one statically named property in an object literal.
+ * @param object - Object-literal AST whose direct properties are inspected.
+ * @param name - Static property name to match.
+ * @returns The matching property, or undefined when absent.
+ */
+export function property(object, name) {
+    return object.properties.find((item) => staticPropertyName(item.name) === name);
+}
+/**
+ * Parses TypeScript for source inspection without executing the application.
+ * @param fileName - Source path used in parser diagnostics.
+ * @param source - Authored TypeScript source text.
+ * @returns The SourceFile AST; parse errors raise the canonical unsupported-source error.
+ */
+export function parse(fileName, source) {
+    const file = ts.createSourceFile(fileName, source, ts.ScriptTarget.Latest, true, ts.ScriptKind.TS);
+    const diagnostics = file.parseDiagnostics;
+    if (diagnostics?.length)
+        unsupported(fileName);
+    return file;
+}
+/**
+ * Removes parentheses and TypeScript assertions from a source expression.
+ * @param value - AST expression whose static wrapper nodes are ignored.
+ * @returns The underlying expression, or undefined when no expression was supplied.
+ */
+export function unwrap(value) {
+    let current = value;
+    while (current &&
+        (ts.isParenthesizedExpression(current) ||
+            ts.isAsExpression(current) ||
+            ts.isSatisfiesExpression(current)))
+        current = current.expression;
+    return current;
+}
+/**
+ * Reads the statically named final segment of a factory expression.
+ * @param expression - Factory expression whose final identifier is inspected.
+ * @returns The identifier or final property segment, otherwise an empty string.
+ */
+export function lastSegment(expression) {
+    return ts.isIdentifier(expression)
+        ? expression.text
+        : ts.isPropertyAccessExpression(expression)
+            ? expression.name.text
+            : "";
+}
+/**
+ * Rejects an object member that conflicts with the requested source insertion.
+ * @param fileName - Source path used for declaration diagnostics.
+ * @param path - Nested static property names identifying the conflicting member.
+ * @returns No value; throws AddScaffoldError with RELKIT_ADD_COLLISION.
+ */
+export function collision(fileName, path) {
+    throw new AddScaffoldError(ADD_FAILURE_CODES.collision, `${fileName} already declares ${path.join(".")}.`);
+}
+/**
+ * Rejects a canonical object that cannot be edited safely.
+ * @param label - Human-readable location included in validation diagnostics.
+ * @returns No value; the unchanged canonical public validation error is thrown.
+ */
+export function unsupported(label) {
+    throw new AddScaffoldError(ADD_FAILURE_CODES.unsupportedSourceShape, `Cannot safely edit canonical object in ${label}.`);
+}
+import { staticPropertyName } from "./source-edit.js";
+//# sourceMappingURL=source-factory-edit.js.map

package/dist/source-factory-edit.js.map

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

package/dist/source-import-edit.d.ts

@@ -1,3 +1,9 @@
-/** Adds or merges one import declaration without reprinting the source file. */
+/**
+ * Adds or merges one import declaration without reprinting the source file.
+ * @param source - Authored source text inspected or transformed without execution.
+ * @param fileName - Source path used for declaration diagnostics.
+ * @param declaration - Complete import declaration source.
+ * @returns Source with the requested import added or merged into its compatible existing declaration.
+ */
 export declare function addSourceImport(source: string, fileName: string, declaration: string): string;
 //# sourceMappingURL=source-import-edit.d.ts.map

package/dist/source-import-edit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"source-import-edit.d.ts","sourceRoot":"","sources":["../src/source-import-edit.ts"],"names":[],"mappings":"AAGA,gFAAgF;AAChF,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAmC7F"}
+{"version":3,"file":"source-import-edit.d.ts","sourceRoot":"","sources":["../src/source-import-edit.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAmC7F"}

package/dist/source-import-edit.js

@@ -1,6 +1,12 @@
 import * as ts from "typescript";
 import { ADD_FAILURE_CODES, AddScaffoldError } from "./add-types.js";
-/** Adds or merges one import declaration without reprinting the source file. */
+/**
+ * Adds or merges one import declaration without reprinting the source file.
+ * @param source - Authored source text inspected or transformed without execution.
+ * @param fileName - Source path used for declaration diagnostics.
+ * @param declaration - Complete import declaration source.
+ * @returns Source with the requested import added or merged into its compatible existing declaration.
+ */
 export function addSourceImport(source, fileName, declaration) {
     if (source.includes(declaration))
         return source;
@@ -34,6 +40,12 @@ export function addSourceImport(source, fileName, declaration) {
     }
     return append(source, file, declaration);
 }
+/**
+ * Parses TypeScript for source inspection without executing the application.
+ * @param fileName - Source path used in parser diagnostics.
+ * @param source - Authored TypeScript source text.
+ * @returns The SourceFile AST; parse errors raise the canonical unsupported-source error.
+ */
 function parse(fileName, source) {
     const file = ts.createSourceFile(fileName, source, ts.ScriptTarget.Latest, true, ts.ScriptKind.TS);
     const diagnostics = file.parseDiagnostics;
@@ -42,6 +54,13 @@ function parse(fileName, source) {
     }
     return file;
 }
+/**
+ * Appends a new import after existing import declarations.
+ * @param source - Authored source text inspected or transformed without execution.
+ * @param file - TypeScript SourceFile AST whose imports are inspected.
+ * @param declaration - Complete import declaration source.
+ * @returns Source with the import inserted after existing imports or before the first statement.
+ */
 function append(source, file, declaration) {
     const imports = file.statements.filter(ts.isImportDeclaration);
     const offset = imports.at(-1)?.getEnd() ?? 0;

package/dist/source-import-edit.js.map

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

package/dist/template-root.d.ts

@@ -1,5 +1,16 @@
-export declare function resolveTemplateRoot(context: {
-    readonly cwd?: string;
-    readonly templateRoot?: string;
-}): string;
+import { Effect } from "effect";
+import { GeneratorPaths } from "./generator-paths.js";
+import type { GenerateProjectContext } from "./generate-types.js";
+/**
+ * Finds explicit, packed or source-owned templates through read-only path authority.
+ * @param context - Caller-owned settings and cancellation.
+ * @returns The supported explicit, bundled or source-owned template root path.
+ */
+export declare const resolveTemplateRootEffect: (context: Pick<GenerateProjectContext, "cwd" | "templateRoot">) => Effect.Effect<string, import("./generator-errors.js").GeneratorIoError, GeneratorPaths>;
+/**
+ * Preserves synchronous template-root resolution without a hidden filesystem dependency.
+ * @param context - Caller-owned settings and cancellation.
+ * @returns The supported source or bundled template root path.
+ */
+export declare function resolveTemplateRoot(context: Pick<GenerateProjectContext, "cwd" | "templateRoot">): string;
 //# sourceMappingURL=template-root.d.ts.map

package/dist/template-root.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"template-root.d.ts","sourceRoot":"","sources":["../src/template-root.ts"],"names":[],"mappings":"AAIA,wBAAgB,mBAAmB,CAAC,OAAO,EAAE;IAC3C,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC,GAAG,MAAM,CAOT"}
+{"version":3,"file":"template-root.d.ts","sourceRoot":"","sources":["../src/template-root.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAElE;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,4JAWrC,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,IAAI,CAAC,sBAAsB,EAAE,KAAK,GAAG,cAAc,CAAC,GAC5D,MAAM,CAER"}

package/dist/template-root.js

@@ -1,15 +1,32 @@
-import { existsSync } from "node:fs";
+import { observeExecution } from "@relkit/contracts/operation";
 import { resolve } from "node:path";
 import { fileURLToPath } from "node:url";
-export function resolveTemplateRoot(context) {
+import { Effect } from "effect";
+import { GeneratorPaths } from "./generator-paths.js";
+import { runGeneratorSync } from "./generator-runtime.js";
+/**
+ * Finds explicit, packed or source-owned templates through read-only path authority.
+ * @param context - Caller-owned settings and cancellation.
+ * @returns The supported explicit, bundled or source-owned template root path.
+ */
+export const resolveTemplateRootEffect = Effect.fn("TemplateCatalog.root")(function* (context) {
     if (context.templateRoot !== undefined)
         return resolve(context.templateRoot);
+    const paths = yield* GeneratorPaths;
     const packaged = fileURLToPath(new URL("./templates/default/v1", import.meta.url));
-    if (existsSync(packaged))
+    if ((yield* paths.metadata(packaged)) !== undefined)
         return resolve(packaged);
     const source = fileURLToPath(new URL("../../../templates/default/v1", import.meta.url));
-    if (existsSync(source))
+    if ((yield* paths.metadata(source)) !== undefined)
         return resolve(source);
-    return resolve(context.cwd ?? process.cwd(), "templates/default/v1");
+    return resolve(context.cwd ?? (yield* paths.cwd()), "templates/default/v1");
+}, (effect) => observeExecution("generator", "TemplateCatalog.root", effect));
+/**
+ * Preserves synchronous template-root resolution without a hidden filesystem dependency.
+ * @param context - Caller-owned settings and cancellation.
+ * @returns The supported source or bundled template root path.
+ */
+export function resolveTemplateRoot(context) {
+    return runGeneratorSync(resolveTemplateRootEffect(context));
 }
 //# sourceMappingURL=template-root.js.map

package/dist/template-root.js.map

@@ -1 +1 @@
-{"version":3,"file":"template-root.js","sourceRoot":"","sources":["../src/template-root.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,UAAU,mBAAmB,CAAC,OAGnC;IACC,IAAI,OAAO,CAAC,YAAY,KAAK,SAAS;QAAE,OAAO,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAC7E,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,wBAAwB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACnF,IAAI,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnD,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,+BAA+B,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACxF,IAAI,UAAU,CAAC,MAAM,CAAC;QAAE,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/C,OAAO,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,EAAE,sBAAsB,CAAC,CAAC;AACvE,CAAC"}
+{"version":3,"file":"template-root.js","sourceRoot":"","sources":["../src/template-root.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAG1D;;;;GAIG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,MAAM,CAAC,EAAE,CAAC,sBAAsB,CAAC,CACxE,QAAQ,CAAC,EAAE,OAA6D;IACtE,IAAI,OAAO,CAAC,YAAY,KAAK,SAAS;QAAE,OAAO,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAC7E,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,cAAc,CAAC;IACpC,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,wBAAwB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACnF,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,KAAK,SAAS;QAAE,OAAO,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC9E,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,+BAA+B,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACxF,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,KAAK,SAAS;QAAE,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1E,OAAO,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,sBAAsB,CAAC,CAAC;AAC9E,CAAC,EACD,CAAC,MAAM,EAAE,EAAE,CAAC,gBAAgB,CAAC,WAAW,EAAE,sBAAsB,EAAE,MAAM,CAAC,CAC1E,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAA6D;IAE7D,OAAO,gBAAgB,CAAC,yBAAyB,CAAC,OAAO,CAAC,CAAC,CAAC;AAC9D,CAAC"}

package/dist/templates/default/README.md

@@ -8,6 +8,6 @@ scaffolder:
 - `agent` — the minimal example plus a read-only tool and agent descriptor.
 
 Each variant is self-contained and can be copied as a project root. It uses
-the current checked-in RelKit package version (`0.6.0`), Bun `1.3.10`, and
+the current checked-in RelKit package version (`0.7.0`), Bun `1.3.10`, and
 TypeScript `5.9.3`. The generator owns project-name substitution and later
 installation/Git behavior.

package/dist/templates/default/v1/agent/package.json

@@ -16,14 +16,14 @@
   },
   "dependencies": {
     "@langchain/langgraph": "1.4.14",
-    "@relkit/app": "0.6.0",
-    "@relkit/local": "0.6.0",
+    "@relkit/app": "0.7.0",
+    "@relkit/local": "0.7.0",
     "langchain": "1.5.10"
   },
   "devDependencies": {
     "@types/bun": "1.3.10",
-    "@relkit/cli": "0.6.0",
-    "@relkit/testing": "0.6.0",
+    "@relkit/cli": "0.7.0",
+    "@relkit/testing": "0.7.0",
     "typescript": "5.9.3"
   }
 }

package/dist/templates/default/v1/api/package.json

@@ -15,12 +15,12 @@
     "graph": "relkit graph print"
   },
   "dependencies": {
-    "@relkit/app": "0.6.0"
+    "@relkit/app": "0.7.0"
   },
   "devDependencies": {
     "@types/bun": "1.3.10",
-    "@relkit/cli": "0.6.0",
-    "@relkit/testing": "0.6.0",
+    "@relkit/cli": "0.7.0",
+    "@relkit/testing": "0.7.0",
     "typescript": "5.9.3"
   }
 }