@empire-builder-kit/nx 1.0.0-beta.10

package/src/foundation/requirements.js

@@ -0,0 +1,141 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.foundationRequirementSchema = exports.STANDARD_FOUNDATION_CAPABILITIES = exports.STANDARD_FOUNDATION_CONTRACT_VERSION = void 0;
+exports.isStandardFoundationCapability = isStandardFoundationCapability;
+exports.validateFoundationRequirement = validateFoundationRequirement;
+exports.validateFoundationCompatibility = validateFoundationCompatibility;
+const validation_js_1 = require("../validation.js");
+const semver_1 = require("semver");
+exports.STANDARD_FOUNDATION_CONTRACT_VERSION = 1;
+exports.STANDARD_FOUNDATION_CAPABILITIES = [
+    'network',
+    'routing',
+    'container-compute',
+    'postgres',
+    'identity',
+    'events',
+    'observability',
+    'configuration',
+    'deployment',
+];
+const capabilitySet = new Set(exports.STANDARD_FOUNDATION_CAPABILITIES);
+function isStandardFoundationCapability(value) {
+    return typeof value === 'string' && capabilitySet.has(value);
+}
+function validateFoundationRequirement(value, path = 'foundation') {
+    const issues = [];
+    if (!(0, validation_js_1.isRecord)(value)) {
+        return {
+            valid: false,
+            issues: [{ message: 'must be an object', path }],
+        };
+    }
+    if (typeof value.contract !== 'string' ||
+        value.contract.trim() === '' ||
+        (0, semver_1.validRange)(value.contract) === null) {
+        issues.push({
+            message: 'must be a valid semantic-version range',
+            path: `${path}.contract`,
+        });
+    }
+    if (!Array.isArray(value.capabilities)) {
+        issues.push({ message: 'must be an array', path: `${path}.capabilities` });
+    }
+    else {
+        const seen = new Set();
+        value.capabilities.forEach((capability, index) => {
+            if (!isStandardFoundationCapability(capability)) {
+                issues.push({
+                    message: `must be one of ${exports.STANDARD_FOUNDATION_CAPABILITIES.join(', ')}`,
+                    path: `${path}.capabilities[${index}]`,
+                });
+                return;
+            }
+            if (seen.has(capability)) {
+                issues.push({
+                    message: 'must not contain duplicate capabilities',
+                    path: `${path}.capabilities[${index}]`,
+                });
+            }
+            seen.add(capability);
+        });
+    }
+    return (0, validation_js_1.validationResult)(value, issues);
+}
+function validateFoundationCompatibility(requirement, foundation) {
+    const issues = [];
+    const requirementResult = validateFoundationRequirement(requirement);
+    if (!requirementResult.valid) {
+        issues.push(...requirementResult.issues);
+    }
+    if (!(0, validation_js_1.isRecord)(foundation)) {
+        return {
+            valid: false,
+            issues: [
+                ...issues,
+                { message: 'must be an object', path: 'foundationDescriptor' },
+            ],
+        };
+    }
+    if (typeof foundation.contractVersion !== 'string' ||
+        (0, semver_1.valid)(foundation.contractVersion) === null) {
+        issues.push({
+            message: 'must be an exact semantic version',
+            path: 'foundationDescriptor.contractVersion',
+        });
+    }
+    if (!Array.isArray(foundation.capabilities)) {
+        issues.push({
+            message: 'must be an array',
+            path: 'foundationDescriptor.capabilities',
+        });
+    }
+    else {
+        foundation.capabilities.forEach((capability, index) => {
+            if (!isStandardFoundationCapability(capability)) {
+                issues.push({
+                    message: `must be one of ${exports.STANDARD_FOUNDATION_CAPABILITIES.join(', ')}`,
+                    path: `foundationDescriptor.capabilities[${index}]`,
+                });
+            }
+        });
+    }
+    if (requirementResult.valid &&
+        typeof foundation.contractVersion === 'string' &&
+        (0, semver_1.valid)(foundation.contractVersion) !== null &&
+        !(0, semver_1.satisfies)(foundation.contractVersion, requirementResult.value.contract)) {
+        issues.push({
+            message: `version ${foundation.contractVersion} does not satisfy ${requirementResult.value.contract}`,
+            path: 'foundationDescriptor.contractVersion',
+        });
+    }
+    if (requirementResult.valid && Array.isArray(foundation.capabilities)) {
+        const available = new Set(foundation.capabilities);
+        for (const capability of requirementResult.value.capabilities) {
+            if (!available.has(capability)) {
+                issues.push({
+                    message: `required capability ${capability} is missing`,
+                    path: 'foundationDescriptor.capabilities',
+                });
+            }
+        }
+    }
+    return (0, validation_js_1.validationResult)(foundation, issues);
+}
+exports.foundationRequirementSchema = {
+    $id: 'https://empirebuilderkit.dev/schemas/foundation-requirement-v1.json',
+    $schema: 'https://json-schema.org/draft/2020-12/schema',
+    additionalProperties: false,
+    properties: {
+        capabilities: {
+            items: { enum: [...exports.STANDARD_FOUNDATION_CAPABILITIES], type: 'string' },
+            type: 'array',
+            uniqueItems: true,
+        },
+        contract: { minLength: 1, type: 'string' },
+    },
+    required: ['contract', 'capabilities'],
+    title: 'Empire Builder Kit Standard Foundation Requirement v1',
+    type: 'object',
+};
+//# sourceMappingURL=requirements.js.map

package/src/foundation/requirements.js.map

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

package/src/foundation/stages.d.ts

@@ -0,0 +1,14 @@
+export declare const FOUNDATION_STAGES: readonly ["development", "staging", "production"];
+export type FoundationStage = (typeof FOUNDATION_STAGES)[number];
+export interface FoundationStageResolution {
+    consumerStage: string;
+    foundationStage: FoundationStage;
+    mapped: boolean;
+}
+export declare function requireStage(value: string, label?: string): string;
+export declare function isFoundationStage(stage: string): stage is FoundationStage;
+export declare function requireFoundationStage(stage: string): FoundationStage;
+export declare function resolveFoundationStages(options: {
+    consumerStage: string;
+    foundationStage?: string;
+}): FoundationStageResolution;

package/src/foundation/stages.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FOUNDATION_STAGES = void 0;
+exports.requireStage = requireStage;
+exports.isFoundationStage = isFoundationStage;
+exports.requireFoundationStage = requireFoundationStage;
+exports.resolveFoundationStages = resolveFoundationStages;
+exports.FOUNDATION_STAGES = [
+    'development',
+    'staging',
+    'production',
+];
+const FOUNDATION_STAGE_SET = new Set(exports.FOUNDATION_STAGES);
+function requireStage(value, label = 'Stage') {
+    const normalized = value.trim();
+    if (!/^[a-z0-9][a-z0-9-]*$/.test(normalized)) {
+        throw new Error(`${label} must use lowercase letters, numbers, and hyphens.`);
+    }
+    return normalized;
+}
+function isFoundationStage(stage) {
+    return FOUNDATION_STAGE_SET.has(stage);
+}
+function requireFoundationStage(stage) {
+    const normalized = requireStage(stage, 'Foundation stage');
+    if (!isFoundationStage(normalized)) {
+        throw new Error(`Foundation stage ${normalized} is not canonical. Use development, staging, or production.`);
+    }
+    return normalized;
+}
+function resolveFoundationStages(options) {
+    const consumerStage = requireStage(options.consumerStage, 'Consumer stage');
+    const expectedFoundationStage = isFoundationStage(consumerStage)
+        ? consumerStage
+        : 'development';
+    const foundationStage = options.foundationStage?.trim()
+        ? requireFoundationStage(options.foundationStage)
+        : expectedFoundationStage;
+    if (foundationStage !== expectedFoundationStage) {
+        if (isFoundationStage(consumerStage)) {
+            throw new Error(`Consumer stage ${consumerStage} must use Foundation stage ${consumerStage}.`);
+        }
+        throw new Error(`Personal or preview consumer stage ${consumerStage} may use only the development Foundation.`);
+    }
+    return {
+        consumerStage,
+        foundationStage,
+        mapped: consumerStage !== foundationStage,
+    };
+}
+//# sourceMappingURL=stages.js.map

package/src/foundation/stages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stages.js","sourceRoot":"","sources":["../../../../../packages/nx/src/foundation/stages.ts"],"names":[],"mappings":";;;AAgBA,oCAQC;AAED,8CAEC;AAED,wDAQC;AAED,0DA4BC;AApEY,QAAA,iBAAiB,GAAG;IAC/B,aAAa;IACb,SAAS;IACT,YAAY;CACJ,CAAC;AAUX,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAS,yBAAiB,CAAC,CAAC;AAEhE,SAAgB,YAAY,CAAC,KAAa,EAAE,KAAK,GAAG,OAAO;IACzD,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAChC,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,KAAK,CACb,GAAG,KAAK,oDAAoD,CAC7D,CAAC;IACJ,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,SAAgB,iBAAiB,CAAC,KAAa;IAC7C,OAAO,oBAAoB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AACzC,CAAC;AAED,SAAgB,sBAAsB,CAAC,KAAa;IAClD,MAAM,UAAU,GAAG,YAAY,CAAC,KAAK,EAAE,kBAAkB,CAAC,CAAC;IAC3D,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CACb,oBAAoB,UAAU,6DAA6D,CAC5F,CAAC;IACJ,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,SAAgB,uBAAuB,CAAC,OAGvC;IACC,MAAM,aAAa,GAAG,YAAY,CAAC,OAAO,CAAC,aAAa,EAAE,gBAAgB,CAAC,CAAC;IAC5E,MAAM,uBAAuB,GAAG,iBAAiB,CAAC,aAAa,CAAC;QAC9D,CAAC,CAAC,aAAa;QACf,CAAC,CAAC,aAAa,CAAC;IAClB,MAAM,eAAe,GAAG,OAAO,CAAC,eAAe,EAAE,IAAI,EAAE;QACrD,CAAC,CAAC,sBAAsB,CAAC,OAAO,CAAC,eAAe,CAAC;QACjD,CAAC,CAAC,uBAAuB,CAAC;IAE5B,IAAI,eAAe,KAAK,uBAAuB,EAAE,CAAC;QAChD,IAAI,iBAAiB,CAAC,aAAa,CAAC,EAAE,CAAC;YACrC,MAAM,IAAI,KAAK,CACb,kBAAkB,aAAa,8BAA8B,aAAa,GAAG,CAC9E,CAAC;QACJ,CAAC;QACD,MAAM,IAAI,KAAK,CACb,sCAAsC,aAAa,2CAA2C,CAC/F,CAAC;IACJ,CAAC;IAED,OAAO;QACL,aAAa;QACb,eAAe;QACf,MAAM,EAAE,aAAa,KAAK,eAAe;KAC1C,CAAC;AACJ,CAAC"}

package/src/generators/function/function.d.ts

@@ -0,0 +1,13 @@
+import { type Tree } from '@nx/devkit';
+import type { FunctionGeneratorSchema } from './schema.js';
+export interface FunctionFilePlan {
+    files: Readonly<Record<string, string>>;
+    paths: Array<{
+        mode?: 'managed' | 'seeded';
+        path: string;
+    }>;
+    register: string;
+}
+export declare function createFunctionFilePlan(slice: string, name: string): FunctionFilePlan;
+export declare function functionGenerator(tree: Tree, options: FunctionGeneratorSchema): Promise<void>;
+export default functionGenerator;

package/src/generators/function/function.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createFunctionFilePlan = createFunctionFilePlan;
+exports.functionGenerator = functionGenerator;
+const devkit_1 = require("@nx/devkit");
+const node_path_1 = require("node:path");
+const index_js_1 = require("../../ownership/index.js");
+function requireName(value, label) {
+    const normalized = value.trim();
+    if (!/^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/.test(normalized)) {
+        throw new Error(`${label} must start with a lowercase letter and use only lowercase letters, numbers, and hyphens.`);
+    }
+    return normalized;
+}
+function pascal(value) {
+    return value
+        .split('-')
+        .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
+        .join('');
+}
+function replaceMarker(tree, path, marker, line) {
+    const source = tree.read(path, 'utf8');
+    if (source === null || !source.includes(marker)) {
+        throw new Error(`Product Slice composition marker ${marker} is missing from ${path}.`);
+    }
+    tree.write(path, source.replace(marker, `${line}\n${marker}`));
+}
+function createFunctionFilePlan(slice, name) {
+    const symbol = `${pascal(slice)}${pascal(name)}Function`;
+    const register = `register${symbol}`;
+    return {
+        files: {
+            [`api/${name}.ts`]: `import { createHttpJsonHandler } from '@empire-builder-kit/runtime';\n\nexport const handler = createHttpJsonHandler({\n  app: '${slice}',\n  operation: '${name}',\n  async handle({ context }) {\n    return { actor: context.actor?.id ?? null, function: '${name}', ok: true };\n  },\n});\n`,
+            [`api/${name}.spec.ts`]: `import { describe, expect, it } from 'vitest';\nimport { handler } from './${name}.js';\n\ndescribe('${name} function', () => {\n  it('returns its generated identity', async () => {\n    const response = await handler({ requestContext: { requestId: 'test-request' } });\n    expect(response.statusCode).toBe(200);\n    expect(JSON.parse(response.body).data).toMatchObject({ function: '${name}', ok: true });\n  });\n});\n`,
+            [`infra/functions/${name}.ts`]: `export function ${register}(api: any) {\n  api.route('ANY /functions/${name}', {\n    environment: { EBK_STAGE: $app.stage },\n    handler: 'api/${name}.handler',\n    logging: { format: 'json', retention: '1 month' },\n  });\n}\n`,
+        },
+        paths: [
+            { mode: 'seeded', path: `api/${name}.ts` },
+            { mode: 'seeded', path: `api/${name}.spec.ts` },
+            { path: `infra/functions/${name}.ts` },
+        ],
+        register,
+    };
+}
+async function functionGenerator(tree, options) {
+    const slice = requireName(options.slice, 'Product Slice name');
+    const name = requireName(options.name, 'Function name');
+    const sliceRoot = node_path_1.posix.join('packages', slice);
+    const handlerPath = node_path_1.posix.join(sliceRoot, 'api', `${name}.ts`);
+    const infraPath = node_path_1.posix.join(sliceRoot, 'infra/functions', `${name}.ts`);
+    const productPath = node_path_1.posix.join(sliceRoot, 'infra/product.ts');
+    if (!tree.exists(productPath))
+        throw new Error(`${slice} is not an EBK v1 Product Slice.`);
+    if (tree.exists(handlerPath) || tree.exists(infraPath)) {
+        throw new Error(`Function ${name} already exists in Product Slice ${slice}.`);
+    }
+    const plan = createFunctionFilePlan(slice, name);
+    for (const [path, contents] of Object.entries(plan.files)) {
+        tree.write(node_path_1.posix.join(sliceRoot, path), contents);
+    }
+    replaceMarker(tree, productPath, '// <ebk:composition-imports:end>', `import { ${plan.register} } from './functions/${name}.js';`);
+    replaceMarker(tree, productPath, '// <ebk:function-registrations:end>', `  ${plan.register}(api);`);
+    if (!options.skipFormat)
+        await (0, devkit_1.formatFiles)(tree);
+    (0, index_js_1.recordCompositionOwnership)(tree, {
+        paths: [...plan.paths, { path: 'infra/product.ts' }],
+        slice,
+    });
+}
+exports.default = functionGenerator;
+//# sourceMappingURL=function.js.map

package/src/generators/function/function.js.map

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

package/src/generators/function/schema.d.ts

@@ -0,0 +1,5 @@
+export interface FunctionGeneratorSchema {
+  name: string;
+  skipFormat?: boolean;
+  slice: string;
+}

package/src/generators/function/schema.json

@@ -0,0 +1,20 @@
+{
+  "$schema": "https://json-schema.org/schema",
+  "$id": "EmpireBuilderKitFunction",
+  "title": "Add an HTTP Lambda function to an EBK v1 Product Slice",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "name": {
+      "type": "string",
+      "$default": { "$source": "argv", "index": 0 }
+    },
+    "slice": {
+      "type": "string",
+      "description": "Owning Product Slice",
+      "x-prompt": "Which Product Slice owns this function?"
+    },
+    "skipFormat": { "type": "boolean", "default": false }
+  },
+  "required": ["name", "slice"]
+}

package/src/generators/job/job.d.ts

@@ -0,0 +1,4 @@
+import type { Tree } from '@nx/devkit';
+import type { WorkloadGeneratorSchema } from '../workload/schema.js';
+declare const _default: (tree: Tree, options: WorkloadGeneratorSchema) => Promise<void | import("@nx/devkit").GeneratorCallback>;
+export default _default;

package/src/generators/job/job.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const workload_js_1 = require("../workload/workload.js");
+exports.default = (tree, options) => (0, workload_js_1.workloadGenerator)(tree, options, 'job');
+//# sourceMappingURL=job.js.map

package/src/generators/job/job.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"job.js","sourceRoot":"","sources":["../../../../../../packages/nx/src/generators/job/job.ts"],"names":[],"mappings":";;AAEA,yDAA4D;AAE5D,kBAAe,CAAC,IAAU,EAAE,OAAgC,EAAE,EAAE,CAC9D,IAAA,+BAAiB,EAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC"}

package/src/generators/preset/generator.d.ts

@@ -0,0 +1,5 @@
+import type { Tree } from '@nx/devkit';
+import type { PresetGeneratorSchema } from './schema';
+export declare function frameworkPackageVersion(): string;
+export declare function presetGenerator(tree: Tree, options: PresetGeneratorSchema): Promise<void>;
+export default presetGenerator;

package/src/generators/preset/generator.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.frameworkPackageVersion = frameworkPackageVersion;
+exports.presetGenerator = presetGenerator;
+const prettier_1 = require("prettier");
+const index_js_1 = require("../../ownership/index.js");
+const workspace_files_1 = require("./workspace-files");
+function frameworkPackageVersion() {
+    const manifest = require('../../../package.json');
+    if (typeof manifest.version !== 'string') {
+        throw new Error('Unable to resolve the Empire Builder Kit package version.');
+    }
+    return manifest.version;
+}
+async function presetGenerator(tree, options) {
+    const renderedFiles = (0, workspace_files_1.renderWorkspaceFiles)({
+        frameworkVersion: options.frameworkVersion ?? frameworkPackageVersion(),
+        name: options.name,
+    });
+    const files = Object.fromEntries(await Promise.all(Object.entries(renderedFiles).map(async ([path, contents]) => {
+        try {
+            return [
+                path,
+                await (0, prettier_1.format)(contents, {
+                    filepath: path,
+                    singleQuote: true,
+                }),
+            ];
+        }
+        catch {
+            return [path, contents];
+        }
+    })));
+    for (const [path, contents] of Object.entries(files)) {
+        tree.write(path, contents);
+    }
+    (0, index_js_1.restampFoundationOwnership)(tree);
+    (0, index_js_1.restampWorkspaceOwnership)(tree);
+}
+exports.default = presetGenerator;
+//# sourceMappingURL=generator.js.map

package/src/generators/preset/generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.js","sourceRoot":"","sources":["../../../../../../packages/nx/src/generators/preset/generator.ts"],"names":[],"mappings":";;AASA,0DAQC;AAED,0CAgCC;AAlDD,uCAAoD;AAEpD,uDAGkC;AAClC,uDAAyD;AAEzD,SAAgB,uBAAuB;IACrC,MAAM,QAAQ,GAAG,OAAO,CAAC,uBAAuB,CAA0B,CAAC;IAC3E,IAAI,OAAO,QAAQ,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CACb,2DAA2D,CAC5D,CAAC;IACJ,CAAC;IACD,OAAO,QAAQ,CAAC,OAAO,CAAC;AAC1B,CAAC;AAEM,KAAK,UAAU,eAAe,CACnC,IAAU,EACV,OAA8B;IAE9B,MAAM,aAAa,GAAG,IAAA,sCAAoB,EAAC;QACzC,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,IAAI,uBAAuB,EAAE;QACvE,IAAI,EAAE,OAAO,CAAC,IAAI;KACnB,CAAC,CAAC;IACH,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,CAC9B,MAAM,OAAO,CAAC,GAAG,CACf,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,EAAE;QAC3D,IAAI,CAAC;YACH,OAAO;gBACL,IAAI;gBACJ,MAAM,IAAA,iBAAc,EAAC,QAAQ,EAAE;oBAC7B,QAAQ,EAAE,IAAI;oBACd,WAAW,EAAE,IAAI;iBAClB,CAAC;aACM,CAAC;QACb,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAU,CAAC;QACnC,CAAC;IACH,CAAC,CAAC,CACH,CACF,CAAC;IAEF,KAAK,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACrD,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC7B,CAAC;IAED,IAAA,qCAA0B,EAAC,IAAI,CAAC,CAAC;IACjC,IAAA,oCAAyB,EAAC,IAAI,CAAC,CAAC;AAClC,CAAC;AAED,kBAAe,eAAe,CAAC"}

package/src/generators/preset/schema.d.ts

@@ -0,0 +1,4 @@
+export interface PresetGeneratorSchema {
+  frameworkVersion?: string;
+  name: string;
+}

package/src/generators/preset/schema.json

@@ -0,0 +1,22 @@
+{
+  "$schema": "https://json-schema.org/schema",
+  "$id": "Preset",
+  "title": "Empire Builder Kit workspace preset",
+  "type": "object",
+  "properties": {
+    "name": {
+      "type": "string",
+      "description": "Workspace name.",
+      "$default": {
+        "$source": "argv",
+        "index": 0
+      },
+      "x-prompt": "What name would you like to use?"
+    },
+    "frameworkVersion": {
+      "type": "string",
+      "description": "Framework package version written to the generated workspace. Defaults to the preset package version."
+    }
+  },
+  "required": ["name"]
+}

package/src/generators/preset/workspace-files.d.ts

@@ -0,0 +1,18 @@
+import { type FoundationOwnershipRecord, type WorkspaceOwnershipRecord } from '../../ownership/index.js';
+export interface WorkspaceFileOptions {
+    frameworkVersion: string;
+    name: string;
+}
+export declare const WORKSPACE_PROJECT_MANAGED_JSON_POINTERS: readonly ["/name", "/$schema", "/projectType", "/tags", "/targets/deployment-plan", "/targets/dev", "/targets/dev-doctor", "/targets/dev-setup", "/targets/github-bootstrap", "/targets/install-git-hooks", "/targets/verify", "/targets/work-markers", "/targets/workspace-health"];
+export interface FoundationFilePlan {
+    files: Readonly<Record<string, string>>;
+    ownership: FoundationOwnershipRecord;
+}
+export interface WorkspaceRootFilePlan {
+    files: Readonly<Record<string, string>>;
+    ownership: WorkspaceOwnershipRecord;
+}
+export declare function renderWorkspaceFiles(options: WorkspaceFileOptions): Readonly<Record<string, string>>;
+export declare function renderWorkspaceRootFilePlan(options: WorkspaceFileOptions): WorkspaceRootFilePlan;
+export declare function renderFoundationFilePlan(options: WorkspaceFileOptions): FoundationFilePlan;
+export declare const WORKSPACE_PACKAGE_MANAGER_VERSION: "10.30.1";