@ykdz/template 0.0.1 → 0.0.3

package/dist/src/editor-customization.d.ts

@@ -0,0 +1,13 @@
+export type EditorCustomizationCapability = "oxc-format-lint" | "rust-tooling" | "tailwind" | "vue" | "vitest";
+export type EditorCustomization = {
+    readonly extensions: readonly string[];
+    readonly settings: Record<string, unknown>;
+};
+export type EditorCustomizationOptions = {
+    readonly oxcConfigPaths?: "nested" | {
+        readonly lint?: string;
+        readonly formatter?: string;
+    };
+};
+export declare function editorCustomizationForCapabilities(capabilities: readonly EditorCustomizationCapability[], options?: EditorCustomizationOptions): EditorCustomization;
+//# sourceMappingURL=editor-customization.d.ts.map

package/dist/src/editor-customization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor-customization.d.ts","sourceRoot":"","sources":["../../src/editor-customization.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,6BAA6B,GACrC,iBAAiB,GACjB,cAAc,GACd,UAAU,GACV,KAAK,GACL,QAAQ,CAAC;AAEb,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC5C,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACvC,QAAQ,CAAC,cAAc,CAAC,EACpB,QAAQ,GACR;QACE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;KAC7B,CAAC;CACP,CAAC;AA0GF,wBAAgB,kCAAkC,CAChD,YAAY,EAAE,SAAS,6BAA6B,EAAE,EACtD,OAAO,CAAC,EAAE,0BAA0B,GACnC,mBAAmB,CAwBrB"}

package/dist/src/editor-customization.js

@@ -0,0 +1,101 @@
+const capabilityOrder = [
+    "oxc-format-lint",
+    "vue",
+    "tailwind",
+    "rust-tooling",
+    "vitest",
+];
+const oxcFormatterSettings = {
+    "editor.defaultFormatter": "oxc.oxc-vscode",
+};
+const defaultOxcConfigPaths = {
+    formatter: "./oxfmt.config.ts",
+    lint: "./oxlint.config.ts",
+};
+function oxcConfigPathSettings(configPaths) {
+    if (configPaths === "nested") {
+        return {};
+    }
+    const paths = {
+        ...defaultOxcConfigPaths,
+        ...configPaths,
+    };
+    return {
+        "oxc.configPath": paths.lint,
+        "oxc.fmt.configPath": paths.formatter,
+    };
+}
+function oxcProjection(options) {
+    return {
+        extensions: ["oxc.oxc-vscode"],
+        settings: {
+            "editor.codeActionsOnSave": {
+                "source.format.oxc": "always",
+                "source.fixAll.oxc": "always",
+            },
+            ...oxcFormatterSettings,
+            "editor.formatOnPaste": true,
+            "editor.formatOnSave": true,
+            "editor.formatOnSaveMode": "file",
+            "oxc.enable": true,
+            ...oxcConfigPathSettings(options?.oxcConfigPaths),
+            "[javascript]": oxcFormatterSettings,
+            "[json]": oxcFormatterSettings,
+            "[markdown]": oxcFormatterSettings,
+            "[typescript]": oxcFormatterSettings,
+        },
+    };
+}
+const capabilityProjections = {
+    "oxc-format-lint": oxcProjection(),
+    "rust-tooling": {
+        extensions: ["rust-lang.rust-analyzer", "tamasfe.even-better-toml"],
+        settings: {
+            "rust-analyzer.cargo.features": "all",
+            "rust-analyzer.check.command": "clippy",
+            "rust-analyzer.procMacro.enable": true,
+            "[rust]": {
+                "editor.defaultFormatter": "rust-lang.rust-analyzer",
+            },
+            "[toml]": {
+                "editor.defaultFormatter": "tamasfe.even-better-toml",
+            },
+        },
+    },
+    tailwind: {
+        extensions: ["bradlc.vscode-tailwindcss"],
+        settings: {},
+    },
+    vue: {
+        extensions: ["Vue.volar"],
+        settings: {},
+    },
+    vitest: {
+        extensions: ["vitest.explorer"],
+        settings: {},
+    },
+};
+function mergeSettings(base, patch) {
+    return { ...base, ...patch };
+}
+export function editorCustomizationForCapabilities(capabilities, options) {
+    const selected = new Set(capabilities);
+    const extensions = new Set();
+    let settings = {};
+    for (const capability of capabilityOrder) {
+        if (!selected.has(capability)) {
+            continue;
+        }
+        const projection = capability === "oxc-format-lint"
+            ? oxcProjection(options)
+            : capabilityProjections[capability];
+        for (const extension of projection.extensions) {
+            extensions.add(extension);
+        }
+        settings = mergeSettings(settings, projection.settings);
+    }
+    return {
+        extensions: [...extensions],
+        settings,
+    };
+}

package/dist/src/generation-context.d.ts

@@ -0,0 +1,24 @@
+import type { PackageManager, ProjectBlueprint } from "./declarations.js";
+import type { ResolvedToolchainVersions } from "./toolchain-resolution.js";
+export type ProjectName = {
+    readonly kind: "ProjectName";
+    readonly value: string;
+};
+export type GenerationPackageManager = {
+    readonly kind: "PackageManager";
+    readonly value: PackageManager;
+};
+export type GenerationContext = {
+    readonly projectName: ProjectName;
+    readonly preset: string;
+    readonly packageManager?: GenerationPackageManager;
+    readonly blueprint: ProjectBlueprint;
+    readonly toolchain: ResolvedToolchainVersions;
+};
+export type AssembleGenerationContextOptions = {
+    readonly targetDir: string;
+    readonly blueprint: ProjectBlueprint;
+    readonly toolchain: ResolvedToolchainVersions;
+};
+export declare function assembleGenerationContext(options: AssembleGenerationContextOptions): GenerationContext;
+//# sourceMappingURL=generation-context.d.ts.map

package/dist/src/generation-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generation-context.d.ts","sourceRoot":"","sources":["../../src/generation-context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1E,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAE3E,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,cAAc,CAAC,EAAE,wBAAwB,CAAC;IACnD,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,yBAAyB,CAAC;CAC/C,CAAC;AAEF,MAAM,MAAM,gCAAgC,GAAG;IAC7C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,yBAAyB,CAAC;CAC/C,CAAC;AAEF,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,gCAAgC,GACxC,iBAAiB,CAUnB"}

package/dist/src/generation-context.js

@@ -0,0 +1,12 @@
+import path from "node:path";
+export function assembleGenerationContext(options) {
+    return {
+        projectName: { kind: "ProjectName", value: path.basename(path.resolve(options.targetDir)) },
+        preset: options.blueprint.preset,
+        packageManager: options.blueprint.packageManager
+            ? { kind: "PackageManager", value: options.blueprint.packageManager }
+            : undefined,
+        blueprint: options.blueprint,
+        toolchain: options.toolchain,
+    };
+}

package/dist/src/module-graph.d.ts

@@ -0,0 +1,31 @@
+export type PackageBoundaryOwner = {
+    readonly kind: "package-boundary";
+    readonly path: "." | "apps/api" | "apps/web";
+};
+export type ComponentOwner = PackageBoundaryOwner;
+export type CheckComponentKind = "typescript-typecheck" | "oxc-lint" | "oxc-format-check" | "build" | "unit-test" | "e2e-test" | "turbo-check" | "rustfmt-check" | "cargo-clippy" | "cargo-test";
+export type FixComponentKind = "oxc-format-write" | "oxc-lint-fix" | "turbo-fix" | "rustfmt-write";
+export type CheckEnvironmentNeed = {
+    readonly kind: "playwright-browser-assets";
+    readonly browser: "chromium";
+    readonly owner: ComponentOwner;
+};
+export type CheckComponent = {
+    readonly kind: CheckComponentKind;
+    readonly owner: ComponentOwner;
+};
+export type FixComponent = {
+    readonly kind: FixComponentKind;
+    readonly owner: ComponentOwner;
+};
+export type CheckPlan = {
+    readonly components: CheckComponent[];
+    readonly environmentNeeds: CheckEnvironmentNeed[];
+};
+export type FixPlan = {
+    readonly components: FixComponent[];
+};
+export declare function renderRootCheckCommand(plan: CheckPlan): string;
+export declare function renderFixCommand(plan: FixPlan): string;
+export declare function renderPlaywrightBrowserInstallCommand(need: CheckEnvironmentNeed): string;
+//# sourceMappingURL=module-graph.d.ts.map

package/dist/src/module-graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-graph.d.ts","sourceRoot":"","sources":["../../src/module-graph.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,QAAQ,CAAC,IAAI,EAAE,GAAG,GAAG,UAAU,GAAG,UAAU,CAAC;CAC9C,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,oBAAoB,CAAC;AAElD,MAAM,MAAM,kBAAkB,GAC1B,sBAAsB,GACtB,UAAU,GACV,kBAAkB,GAClB,OAAO,GACP,WAAW,GACX,UAAU,GACV,aAAa,GACb,eAAe,GACf,cAAc,GACd,YAAY,CAAC;AAEjB,MAAM,MAAM,gBAAgB,GACxB,kBAAkB,GAClB,cAAc,GACd,WAAW,GACX,eAAe,CAAC;AAEpB,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,CAAC,IAAI,EAAE,2BAA2B,CAAC;IAC3C,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB,QAAQ,CAAC,UAAU,EAAE,cAAc,EAAE,CAAC;IACtC,QAAQ,CAAC,gBAAgB,EAAE,oBAAoB,EAAE,CAAC;CACnD,CAAC;AAEF,MAAM,MAAM,OAAO,GAAG;IACpB,QAAQ,CAAC,UAAU,EAAE,YAAY,EAAE,CAAC;CACrC,CAAC;AAwCF,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAE9D;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAEtD;AAED,wBAAgB,qCAAqC,CACnD,IAAI,EAAE,oBAAoB,GACzB,MAAM,CAMR"}

package/dist/src/module-graph.js

@@ -0,0 +1,48 @@
+function renderCheckComponentCommand(component) {
+    switch (component.kind) {
+        case "typescript-typecheck":
+            return "pnpm run typecheck";
+        case "oxc-lint":
+            return "pnpm run lint";
+        case "oxc-format-check":
+            return "pnpm run format:check";
+        case "build":
+            return "pnpm run build";
+        case "unit-test":
+            return "pnpm run test";
+        case "e2e-test":
+            return "pnpm run test:e2e";
+        case "turbo-check":
+            return "turbo run check";
+        case "rustfmt-check":
+            return "cargo fmt --all -- --check";
+        case "cargo-clippy":
+            return "cargo clippy --workspace --all-targets -- -D warnings";
+        case "cargo-test":
+            return "cargo test --workspace";
+    }
+}
+function renderFixComponentCommand(component) {
+    switch (component.kind) {
+        case "oxc-format-write":
+            return "pnpm run format:write";
+        case "oxc-lint-fix":
+            return "pnpm run lint:fix";
+        case "turbo-fix":
+            return "turbo run fix";
+        case "rustfmt-write":
+            return "cargo fmt --all";
+    }
+}
+export function renderRootCheckCommand(plan) {
+    return plan.components.map(renderCheckComponentCommand).join(" && ");
+}
+export function renderFixCommand(plan) {
+    return plan.components.map(renderFixComponentCommand).join(" && ");
+}
+export function renderPlaywrightBrowserInstallCommand(need) {
+    if (need.owner.path === "apps/web") {
+        return `pnpm --filter ./apps/web exec playwright install ${need.browser}`;
+    }
+    return `pnpm exec playwright install ${need.browser}`;
+}

package/dist/src/next-step-instructions.d.ts

@@ -0,0 +1,21 @@
+import type { PresetProjectionPlan } from "./preset-projection.js";
+export type NextStepInstruction = {
+    readonly id: string;
+    readonly label: string;
+    readonly kind: "navigation" | "command";
+    readonly command: string;
+    readonly args: readonly string[];
+    readonly cwd: string;
+    readonly display: string;
+    readonly machineVerifiable: boolean;
+};
+export type NextStepInstructionPlan = {
+    readonly targetDir: string;
+    readonly steps: readonly NextStepInstruction[];
+};
+export type PlanNextStepInstructionsOptions = {
+    readonly targetDir: string;
+    readonly projectionPlan: PresetProjectionPlan;
+};
+export declare function planNextStepInstructions(options: PlanNextStepInstructionsOptions): NextStepInstructionPlan;
+//# sourceMappingURL=next-step-instructions.d.ts.map

package/dist/src/next-step-instructions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"next-step-instructions.d.ts","sourceRoot":"","sources":["../../src/next-step-instructions.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAEnE,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,SAAS,mBAAmB,EAAE,CAAC;CAChD,CAAC;AAEF,MAAM,MAAM,+BAA+B,GAAG;IAC5C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,cAAc,EAAE,oBAAoB,CAAC;CAC/C,CAAC;AAqFF,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,+BAA+B,GACvC,uBAAuB,CAyBzB"}

package/dist/src/next-step-instructions.js

@@ -0,0 +1,89 @@
+import { renderPlaywrightBrowserInstallCommand } from "./module-graph.js";
+function rootCheckInstruction() {
+    return {
+        id: "run-root-check",
+        label: "Run Root Check",
+        kind: "command",
+        command: "pnpm",
+        args: ["run", "check"],
+        cwd: "",
+        display: "pnpm run check",
+        machineVerifiable: true,
+    };
+}
+function installDependenciesInstruction() {
+    return {
+        id: "install-dependencies",
+        label: "Install dependencies",
+        kind: "command",
+        command: "pnpm",
+        args: ["install"],
+        cwd: "",
+        display: "pnpm install",
+        machineVerifiable: true,
+    };
+}
+function fixInstruction() {
+    return {
+        id: "run-fix",
+        label: "Run Fix Command",
+        kind: "command",
+        command: "pnpm",
+        args: ["run", "fix"],
+        cwd: "",
+        display: "pnpm run fix",
+        machineVerifiable: true,
+    };
+}
+function checkEnvironmentInstructions(plan) {
+    return plan.checkPlan.environmentNeeds.map((need) => {
+        const display = renderPlaywrightBrowserInstallCommand(need);
+        const [command, ...args] = display.split(" ");
+        return {
+            id: need.owner.path === "apps/web"
+                ? "install-web-playwright-browsers"
+                : "install-playwright-browsers",
+            label: need.owner.path === "apps/web"
+                ? "Install Playwright browser assets for web workspace"
+                : "Install Playwright browser assets",
+            kind: "command",
+            command,
+            args,
+            cwd: "",
+            display,
+            machineVerifiable: true,
+        };
+    });
+}
+function projectionInstructions(plan) {
+    const steps = [installDependenciesInstruction()];
+    if (plan.capabilities.fixCommand) {
+        steps.push(fixInstruction());
+    }
+    steps.push(...checkEnvironmentInstructions(plan));
+    if (plan.capabilities.rootCheck) {
+        steps.push(rootCheckInstruction());
+    }
+    return steps;
+}
+export function planNextStepInstructions(options) {
+    const targetDir = options.targetDir;
+    const commandSteps = projectionInstructions(options.projectionPlan).map((step) => ({
+        ...step,
+        cwd: targetDir,
+    }));
+    const navigationStep = {
+        id: "enter-project",
+        label: "Enter Generated Repository",
+        kind: "navigation",
+        command: "cd",
+        args: [targetDir],
+        cwd: ".",
+        display: `cd ${targetDir}`,
+        machineVerifiable: false,
+    };
+    return Object.freeze({
+        targetDir,
+        steps: Object.freeze([navigationStep, ...commandSteps].map((step) => Object.freeze(step))),
+    });
+}

package/dist/src/package-addition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-addition.d.ts","sourceRoot":"","sources":["../../src/package-addition.ts"],"names":[],"mappings":"AAUA,MAAM,MAAM,iBAAiB,GAAG;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AA0PF,wBAAsB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CA+E1E"}

package/dist/src/package-addition.js

@@ -0,0 +1,188 @@
+import { mkdir, readFile, stat, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { findBuiltInPresetProjection } from "../templates/registry.js";
+import { validateProjectBlueprint, } from "./declarations.js";
+import { renderProject } from "./renderer.js";
+function projectNameFromBlueprint(blueprint) {
+    const firstPackage = blueprint.packages?.[0];
+    const match = firstPackage?.name.match(/^@([^/]+)\//);
+    if (!match) {
+        throw new Error("Cannot infer workspace package scope from the stored Project Blueprint");
+    }
+    return match[1];
+}
+function assertSafePackageLeaf(name) {
+    if (!/^[a-z0-9][a-z0-9-]*$/.test(name)) {
+        throw new Error("--name must be a lowercase package leaf name using letters, numbers, and hyphens");
+    }
+}
+async function readJson(filePath) {
+    return JSON.parse(await readFile(filePath, "utf8"));
+}
+async function writeJson(filePath, value) {
+    await writeFile(filePath, `${JSON.stringify(value, null, 2)}\n`, "utf8");
+}
+async function assertMissing(targetPath) {
+    try {
+        await stat(targetPath);
+    }
+    catch (error) {
+        if (isNodeError(error) && error.code === "ENOENT") {
+            return;
+        }
+        throw error;
+    }
+    throw new Error(`Package Addition would overwrite an existing path: ${targetPath}`);
+}
+function resolveGeneratedPath(root, relativePath) {
+    if (path.isAbsolute(relativePath)) {
+        throw new Error(`Package Addition paths must be relative: ${relativePath}`);
+    }
+    const resolvedRoot = path.resolve(root);
+    const resolvedPath = path.resolve(resolvedRoot, relativePath);
+    const insideRoot = resolvedPath === resolvedRoot ||
+        resolvedPath.startsWith(`${resolvedRoot}${path.sep}`);
+    if (!insideRoot) {
+        throw new Error(`Package Addition path escapes the Generated Repository: ${relativePath}`);
+    }
+    return resolvedPath;
+}
+function isNodeError(error) {
+    return error instanceof Error && "code" in error;
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+async function readGeneratedWorkspaceBlueprint(root) {
+    const blueprintPath = path.join(root, ".project-kit/blueprint.json");
+    const result = validateProjectBlueprint(await readJson(blueprintPath));
+    if (!result.ok) {
+        throw new Error("Package Addition requires a valid .project-kit/blueprint.json");
+    }
+    const blueprint = result.value;
+    if (blueprint.projectKind !== "multi-package") {
+        throw new Error("Package Addition only supports existing workspace Generated Repositories");
+    }
+    if (blueprint.packageManager !== "pnpm") {
+        throw new Error("Package Addition only supports pnpm workspace Generated Repositories");
+    }
+    if (!blueprint.packages || blueprint.packages.length === 0) {
+        throw new Error("Package Addition requires package definitions in the stored Project Blueprint");
+    }
+    await stat(path.join(root, "turbo.json"));
+    await stat(path.join(root, "pnpm-workspace.yaml"));
+    return blueprint;
+}
+async function readGeneratedRepositoryNodeVersion(root) {
+    const packageJson = await readJson(path.join(root, "package.json"));
+    if (!isRecord(packageJson) || !isRecord(packageJson.engines)) {
+        throw new Error("Package Addition requires root package.json to declare engines.node");
+    }
+    const nodeVersion = packageJson.engines.node;
+    if (typeof nodeVersion !== "string" || nodeVersion.length === 0) {
+        throw new Error("Package Addition requires root package.json to declare engines.node");
+    }
+    return nodeVersion;
+}
+function workspaceTextWithPackageGlob(text, glob) {
+    if (text.includes(`  - ${glob}`)) {
+        return text;
+    }
+    const nextText = text.replace(/^packages:\n/m, `packages:\n  - ${glob}\n`);
+    if (nextText === text) {
+        throw new Error("Cannot update pnpm workspace membership: missing packages section");
+    }
+    return nextText;
+}
+function assertRootTsconfig(input) {
+    if (!isRecord(input)) {
+        throw new Error("Cannot update root TypeScript project references: tsconfig.json must be an object");
+    }
+    const references = input.references;
+    if (references === undefined) {
+        return;
+    }
+    if (!Array.isArray(references)) {
+        throw new Error("Cannot update root TypeScript project references: references must be an array");
+    }
+    for (const reference of references) {
+        if (!isRecord(reference) || typeof reference.path !== "string") {
+            throw new Error("Cannot update root TypeScript project references: each reference must have a string path");
+        }
+    }
+}
+function rootTsconfigWithReferences(input, referencePaths) {
+    assertRootTsconfig(input);
+    const tsconfig = input;
+    const references = tsconfig.references ?? [];
+    for (const referencePath of referencePaths) {
+        if (!references.some((reference) => reference.path === referencePath)) {
+            references.push({ path: referencePath });
+        }
+    }
+    return { ...tsconfig, references };
+}
+function blueprintWithPackage(blueprint, packageName, packagePath) {
+    const nextBlueprint = {
+        ...blueprint,
+        packages: [
+            ...(blueprint.packages ?? []),
+            { name: packageName, path: packagePath },
+        ],
+    };
+    const result = validateProjectBlueprint(nextBlueprint);
+    if (!result.ok) {
+        throw new Error("Package Addition would write an invalid .project-kit/blueprint.json");
+    }
+    return result.value;
+}
+async function planRootUpdates(root, blueprint, packageName, packagePath, workspacePackageGlob, rootTsconfigReferences) {
+    const workspaceText = workspaceTextWithPackageGlob(await readFile(path.join(root, "pnpm-workspace.yaml"), "utf8"), workspacePackageGlob);
+    const rootTsconfig = rootTsconfigWithReferences(await readJson(path.join(root, "tsconfig.json")), rootTsconfigReferences);
+    return {
+        blueprint: blueprintWithPackage(blueprint, packageName, packagePath),
+        rootTsconfig,
+        workspaceText,
+    };
+}
+export async function addPackage(options) {
+    assertSafePackageLeaf(options.name);
+    const root = path.resolve(options.cwd);
+    const blueprint = await readGeneratedWorkspaceBlueprint(root);
+    const nodeVersion = await readGeneratedRepositoryNodeVersion(root);
+    const projectName = projectNameFromBlueprint(blueprint);
+    const packageName = `@${projectName}/${options.name}`;
+    const projection = findBuiltInPresetProjection(options.preset);
+    const packageAddition = projection?.capabilities?.packageAddition;
+    if (!projection) {
+        throw new Error(`Unknown preset for Package Addition: ${options.preset}`);
+    }
+    if (!packageAddition) {
+        throw new Error(`Package Addition is not supported by preset: ${options.preset}`);
+    }
+    const additionPlan = await packageAddition.planPackageAddition({
+        root,
+        blueprint,
+        packageLeafName: options.name,
+        packageName,
+        nodeVersion,
+    });
+    if (blueprint.packages?.some((pkg) => pkg.name === packageName || pkg.path === additionPlan.packagePath)) {
+        throw new Error(`Package Addition conflicts with an existing package definition: ${packageName}`);
+    }
+    await assertMissing(path.join(root, additionPlan.packagePath));
+    const rootUpdatePlan = await planRootUpdates(root, blueprint, packageName, additionPlan.packagePath, additionPlan.workspacePackageGlob, additionPlan.rootTsconfigReferences);
+    await mkdir(path.join(root, additionPlan.packagePath), { recursive: true });
+    await renderProject({
+        sourceRoot: additionPlan.sourceRoot,
+        sourceRoots: additionPlan.sourceRoots,
+        targetRoot: root,
+        operations: [...additionPlan.operations],
+    });
+    for (const textFile of additionPlan.textFiles ?? []) {
+        await writeFile(resolveGeneratedPath(root, textFile.path), textFile.text, "utf8");
+    }
+    await writeFile(path.join(root, "pnpm-workspace.yaml"), rootUpdatePlan.workspaceText, "utf8");
+    await writeJson(path.join(root, "tsconfig.json"), rootUpdatePlan.rootTsconfig);
+    await writeJson(path.join(root, ".project-kit/blueprint.json"), rootUpdatePlan.blueprint);
+}

package/dist/src/preset-projection.d.ts

@@ -0,0 +1,66 @@
+import type { BuiltInPreset, ProjectBlueprint } from "./declarations.js";
+import type { GenerationContext } from "./generation-context.js";
+import { type CheckPlan, type FixPlan } from "./module-graph.js";
+import { type NextStepInstruction } from "./next-step-instructions.js";
+import type { DependencyMaintenancePolicy } from "./project-github.js";
+import type { RenderOperation } from "./renderer.js";
+export type PresetPackageAdditionOptions = {
+    readonly root: string;
+    readonly blueprint: ProjectBlueprint;
+    readonly packageLeafName: string;
+    readonly packageName: string;
+    readonly nodeVersion: string;
+};
+export type PresetPackageAdditionPlan = {
+    readonly packagePath: string;
+    readonly workspacePackageGlob: string;
+    readonly rootTsconfigReferences: readonly string[];
+    readonly sourceRoot: string;
+    readonly sourceRoots?: Record<string, string>;
+    readonly operations: readonly RenderOperation[];
+    readonly textFiles?: readonly {
+        readonly path: string;
+        readonly text: string;
+    }[];
+};
+export type PresetPackageAdditionCapability = {
+    planPackageAddition(options: PresetPackageAdditionOptions): PresetPackageAdditionPlan | Promise<PresetPackageAdditionPlan>;
+};
+export type PresetProjectionPlan = {
+    readonly sourceRoot: string;
+    readonly sourceRoots?: Record<string, string>;
+    readonly operations: readonly RenderOperation[];
+    readonly checkPlan: CheckPlan;
+    readonly fixPlan: FixPlan;
+    readonly dependencyMaintenancePolicy: DependencyMaintenancePolicy;
+    readonly packageScripts: Record<string, string>;
+    readonly capabilities: {
+        readonly rootCheck: true;
+        readonly fixCommand: true;
+        readonly githubActions: true;
+        readonly dependabot: true;
+        readonly devcontainer: true;
+    };
+};
+export type PresetBlueprintOptions = {
+    readonly targetDir: string;
+    readonly scope?: string;
+};
+export type RenderPresetProjectionOptions = {
+    readonly targetDir: string;
+    readonly plan: PresetProjectionPlan;
+};
+export type PresetProjection = {
+    readonly metadata: BuiltInPreset;
+    readonly capabilities?: {
+        readonly packageAddition?: PresetPackageAdditionCapability;
+    };
+    blueprint(options: PresetBlueprintOptions): ProjectBlueprint;
+    project(context: GenerationContext): PresetProjectionPlan;
+    render(options: RenderPresetProjectionOptions): Promise<void>;
+};
+export declare function planNextStepInstructionsForProjection(options: {
+    readonly targetDir: string;
+    readonly plan: PresetProjectionPlan;
+}): readonly NextStepInstruction[];
+//# sourceMappingURL=preset-projection.d.ts.map

package/dist/src/preset-projection.d.ts.map

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

package/dist/src/preset-projection.js

@@ -0,0 +1,7 @@
+import { planNextStepInstructions, } from "./next-step-instructions.js";
+export function planNextStepInstructionsForProjection(options) {
+    return planNextStepInstructions({
+        targetDir: options.targetDir,
+        projectionPlan: options.plan,
+    }).steps;
+}

package/dist/src/project-github.d.ts

@@ -0,0 +1,29 @@
+import { type CheckPlan } from "./module-graph.js";
+export type CiCapability = {
+    readonly workflowName: "Check";
+    readonly jobName: "check";
+    readonly runner: "ubuntu-latest";
+};
+export type CiEnvironmentPreparation = {
+    readonly nodeFromPackageMetadata: boolean;
+    readonly rustToolchain: boolean;
+};
+export type PnpmTaskLayer = {
+    readonly installCommand: "pnpm install";
+    readonly checkCommand: "pnpm run check";
+};
+export type DependencyEcosystem = "npm" | "cargo" | "github-actions";
+export type DependencyMaintenancePolicy = {
+    readonly ecosystems: DependencyEcosystem[];
+    readonly interval: "weekly";
+};
+type ProjectCheckWorkflowOptions = {
+    readonly checkPlan: CheckPlan;
+    readonly capability?: CiCapability;
+    readonly environmentPreparation?: Partial<CiEnvironmentPreparation>;
+    readonly taskLayer?: PnpmTaskLayer;
+};
+export declare function projectCheckWorkflow(options: ProjectCheckWorkflowOptions): string;
+export declare function projectDependabotConfig(policy: DependencyMaintenancePolicy): string;
+export {};
+//# sourceMappingURL=project-github.d.ts.map