@ykdz/template 0.0.7 → 0.0.8

package/{dist/src → node_modules/@ykdz/template-core/dist}/preset-source.js

@@ -1,11 +1,9 @@
 import { existsSync, readdirSync, readFileSync, realpathSync, statSync, } from "node:fs";
 import path from "node:path";
-import { fileURLToPath } from "node:url";
 import * as v from "valibot";
 import { loadTemplateDependencyCatalog, } from "./dependency-catalog.js";
 import { PackageAdditionSupport } from "./package-addition-support.js";
 import { normalizePresetProjectionDeclaration, projectionCapabilityIssues, } from "./projection-capabilities.js";
-import { packageTemplateRoot } from "./runtime-paths.js";
 const featureNames = [
     "pnpm-catalog",
     "oxc-format-lint",
@@ -402,34 +400,34 @@ function formatIssuePath(issue) {
     if (!issue.path || issue.path.length === 0) {
         return "$";
     }
-    return issue.path.reduce((path, item) => {
+    return issue.path.reduce((issuePath, item) => {
         if (typeof item.key === "number") {
-            return `${path}[${item.key}]`;
+            return `${issuePath}[${item.key}]`;
         }
-        return `${path}.${String(item.key)}`;
+        return `${issuePath}.${String(item.key)}`;
     }, "$");
 }
 function shapeIssues(issues) {
     return issues.map((issue) => {
-        const path = formatIssuePath(issue);
-        const missingPresetMetadata = path.match(/^\$\.presets\[\d+\]\.(.+)$/);
+        const validationPath = formatIssuePath(issue);
+        const missingPresetMetadata = validationPath.match(/^\$\.presets\[\d+\]\.(.+)$/);
         if (missingPresetMetadata && issue.message.includes("received undefined")) {
             return {
-                path,
+                path: validationPath,
                 message: `Preset metadata is missing required field: ${missingPresetMetadata[1]}`,
             };
         }
         if (issue.message.startsWith("Invalid key:") &&
-            /\.(body|content|text)$/.test(path)) {
-            const key = path.split(".").at(-1);
+            /\.(body|content|text)$/.test(validationPath)) {
+            const key = validationPath.split(".").at(-1);
             return {
-                path,
+                path: validationPath,
                 message: `Preset Source Manifests must reference Generated Repository file bodies by path, not inline ${key}`,
             };
         }
         return {
-            path,
-            message: path.match(/^\$\.presets\[\d+\]\.packageAdditionSupport$/)
+            path: validationPath,
+            message: validationPath.match(/^\$\.presets\[\d+\]\.packageAdditionSupport$/)
                 ? "Package Addition Support must be one of: supported, unsupported"
                 : issue.message,
         };
@@ -449,7 +447,7 @@ function duplicatePresetNameIssues(presets) {
         message: `Duplicate Preset name: ${name}`,
     }));
 }
-function duplicateValueIssues(values, path) {
+function duplicateValueIssues(values, validationPath) {
     const seen = new Set();
     const duplicates = new Set();
     for (const value of values) {
@@ -459,7 +457,7 @@ function duplicateValueIssues(values, path) {
         seen.add(value);
     }
     return [...duplicates].map((value) => ({
-        path,
+        path: validationPath,
         message: `Duplicate value: ${value}`,
     }));
 }
@@ -921,20 +919,6 @@ export function loadPresetSourceManifestFile(filePath) {
     }
     return result.value;
 }
-export function loadBuiltInPresetSourceManifest() {
-    const moduleDir = path.dirname(fileURLToPath(import.meta.url));
-    const filePath = packageTemplateRoot(moduleDir, "preset-source.json");
-    const result = validateBuiltInPresetSourceManifest(JSON.parse(readFileSync(filePath, "utf8")), { sourceRoot: path.dirname(filePath) });
-    if (!result.ok) {
-        throw new Error(`Built-in Preset Source Manifest is invalid:\n${result.issues
-            .map((issue) => `  - ${issue.path}: ${issue.message}`)
-            .join("\n")}`);
-    }
-    return result.value;
-}
 export function findPresetSourceManifestPreset(manifest, presetName) {
     return manifest.presets.find((preset) => preset.name === presetName);
 }
-export function findBuiltInPresetSourceManifestPreset(presetName) {
-    return findPresetSourceManifestPreset(loadBuiltInPresetSourceManifest(), presetName);
-}

package/{dist/src → node_modules/@ykdz/template-core/dist}/projection-capabilities.d.ts

@@ -46,6 +46,12 @@ export type ProjectionCapabilityDeclaration = WorkspaceLibraryPackageCapabilityD
 export type PresetProjectionDeclaration = {
     readonly capabilities: readonly ProjectionCapabilityDeclaration[];
 };
+export type ProjectionSourcePreset = "hono-api" | "rust-bin" | "ts-lib" | "vue-app" | "vue-hono-app";
+export type PresetProjectionSourceRoots = {
+    readonly preset: (sourcePreset: ProjectionSourcePreset) => string;
+    readonly sharedOxc: () => string;
+    readonly sharedDevcontainer: () => string;
+};
 export declare function validateProjectionCapabilities(input: unknown): ValidationResult<PresetProjectionDeclaration>;
 export declare function projectionCapabilityIssues(presets: readonly PresetSourceManifestPreset[]): ValidationIssue[];
 export declare function normalizePresetProjectionDeclaration(declaration: PresetProjectionDeclaration): PresetProjectionDeclaration;
@@ -53,15 +59,17 @@ export declare function interpretPresetProjectionDeclaration(options: {
     readonly preset: PresetSourceManifestPreset;
     readonly declaration: PresetProjectionDeclaration;
     readonly context: GenerationContext;
+    readonly sourceRoots: PresetProjectionSourceRoots;
 }): PresetProjectionPlan;
 export declare function blueprintForPresetSourcePreset(preset: PresetSourceManifestPreset, options?: PresetBlueprintOptions): ProjectBlueprint;
 export declare function projectPresetSourcePreset(options: {
     readonly preset: PresetSourceManifestPreset;
     readonly context: GenerationContext;
+    readonly sourceRoots: PresetProjectionSourceRoots;
 }): PresetProjectionPlan;
 export declare function planPresetSourcePackageAddition(options: {
     readonly preset: PresetSourceManifestPreset;
     readonly addition: PresetPackageAdditionOptions;
+    readonly sourceRoots: PresetProjectionSourceRoots;
 }): Promise<PresetPackageAdditionPlan>;
-export declare function defaultPackagePathForPresetSourcePackageAddition(preset: PresetSourceManifestPreset, packageLeafName: string): string;
-export declare function loadBuiltInPresetProjectionDeclaration(presetName: string): PresetProjectionDeclaration;
+export declare function defaultPackagePathForPresetSourcePackageAddition(preset: PresetSourceManifestPreset, packageLeafName: string, sourceRoots: PresetProjectionSourceRoots): string;

package/{dist/src → node_modules/@ykdz/template-core/dist}/projection-capabilities.js

@@ -1,13 +1,10 @@
-import { readFileSync } from "node:fs";
 import { readFile } from "node:fs/promises";
 import path from "node:path";
-import { fileURLToPath } from "node:url";
 import { collectGeneratedManifestCatalogDependencies, collectGeneratedManifestCatalogReferences, renderGeneratedPnpmWorkspaceYaml, } from "./dependency-catalog.js";
 import { browserTestToolLayer, checkedDockerfileFirstNodePnpmDevcontainer, dockerfileFirstRustPnpmDevcontainer, nodePnpmToolLayer, rustToolLayer, } from "./devcontainer.js";
 import { editorCustomizationForCapabilities, } from "./editor-customization.js";
 import { renderFixCommand, renderRootCheckCommand, } from "./module-graph.js";
 import { packageManifestExposureFields, planPackageLinks, } from "./package-linking.js";
-import { packageTemplateRoot } from "./runtime-paths.js";
 const projectionCapabilityKinds = [
     "workspace-library-package",
     "workspace-node-packages",
@@ -26,10 +23,6 @@ const workspacePackageBoundary = {
     kind: "package-boundary",
     path: ".",
 };
-const workspacePackageCollectionBoundary = {
-    kind: "package-boundary",
-    path: "packages/*",
-};
 const requiredPlanCapabilityProviders = [
     {
         flag: "rootCheck",
@@ -83,7 +76,7 @@ const capabilityInterpreters = {
         kind: "workspace-library-package",
         contribute({ capability, state }) {
             state.package = capability;
-            state.sourceRoot = templateSourceRoot(capability.packageSourcePreset);
+            state.sourceRoot = templateSourceRoot(state, capability.packageSourcePreset);
             state.packageDependencies.add("valibot");
             state.operationFactories.push(workspaceLibraryPackageOperations);
         },
@@ -92,7 +85,7 @@ const capabilityInterpreters = {
         kind: "workspace-node-packages",
         contribute({ capability, state }) {
             state.nodeWorkspace = capability;
-            state.sourceRoot = templateSourceRootForPreset(sourceRootPreset(capability));
+            state.sourceRoot = templateSourceRootForPreset(state, sourceRootPreset(capability));
             state.operationFactories.push(workspaceNodePackagesOperations);
             if (capability.packages.length > 1) {
                 state.rootScriptFragments.dev = "turbo run dev --parallel";
@@ -112,8 +105,9 @@ const capabilityInterpreters = {
         kind: "rust-binary-workspace",
         contribute({ capability, state }) {
             state.rustWorkspace = capability;
-            state.sourceRoot = templateSourceRootForPreset("rust-bin");
-            state.sourceRoots.sharedDevcontainer = sharedDevcontainerSourceRoot();
+            state.sourceRoot = templateSourceRootForPreset(state, "rust-bin");
+            state.sourceRoots.sharedDevcontainer =
+                state.projectionSourceRoots.sharedDevcontainer();
             state.rootCheckComponents.push({
                 kind: "turbo-package-check",
                 owner: workspaceGlobBoundary(capability.workspacePackageGlob),
@@ -186,7 +180,7 @@ const capabilityInterpreters = {
     "oxc-format-lint": {
         kind: "oxc-format-lint",
         contribute({ state }) {
-            state.sourceRoots.sharedOxc = sharedOxcSourceRoot();
+            state.sourceRoots.sharedOxc = state.projectionSourceRoots.sharedOxc();
             state.rootCheckComponents.unshift({
                 kind: "oxc-format-check",
                 owner: strictTypescriptRootBoundary,
@@ -234,7 +228,8 @@ const capabilityInterpreters = {
     "node-pnpm-devcontainer": {
         kind: "node-pnpm-devcontainer",
         contribute({ state }) {
-            state.sourceRoots.sharedDevcontainer = sharedDevcontainerSourceRoot();
+            state.sourceRoots.sharedDevcontainer =
+                state.projectionSourceRoots.sharedDevcontainer();
             state.flags.devcontainer = true;
             state.operationFactories.push(nodePnpmDevcontainerOperations);
         },
@@ -361,7 +356,7 @@ export function interpretPresetProjectionDeclaration(options) {
             .map((issue) => `  - ${issue.path}: ${issue.message}`)
             .join("\n")}`);
     }
-    const state = createProjectionCompositionState();
+    const state = createProjectionCompositionState(options.sourceRoots);
     for (const capability of validation.value.capabilities) {
         capabilityInterpreters[capability.kind].contribute({
             capability: capability,
@@ -437,13 +432,14 @@ export function projectPresetSourcePreset(options) {
         preset: options.preset,
         declaration: options.preset.projection,
         context: options.context,
+        sourceRoots: options.sourceRoots,
     });
 }
 export async function planPresetSourcePackageAddition(options) {
     if (options.preset.projection === undefined) {
         throw new Error(`Preset ${options.preset.name} declares Package Addition support but has no Projection Declaration`);
     }
-    const state = stateForProjectionDeclaration(options.preset.projection);
+    const state = stateForProjectionDeclaration(options.preset.projection, options.sourceRoots);
     const additionCapability = packageAdditionCapabilityForState(options.preset.name, state);
     return {
         packagePath: options.addition.packagePath,
@@ -451,7 +447,7 @@ export async function planPresetSourcePackageAddition(options) {
         workspaceMembershipGlob: `${packageCollectionFromPackagePath(options.addition.packagePath)}/*`,
         packageRole: additionCapability.packageRole,
         packageSourcePreset: additionCapability.packageSourcePreset,
-        sourceRoot: templateSourceRootForPreset(additionCapability.sourcePreset),
+        sourceRoot: templateSourceRootForPreset(state, additionCapability.sourcePreset),
         sourceRoots: state.sourceRoots,
         operations: [
             ...packageAdditionOperationsForCapability({
@@ -475,34 +471,17 @@ export async function planPresetSourcePackageAddition(options) {
         ],
     };
 }
-export function defaultPackagePathForPresetSourcePackageAddition(preset, packageLeafName) {
+export function defaultPackagePathForPresetSourcePackageAddition(preset, packageLeafName, sourceRoots) {
     if (preset.projection === undefined) {
         throw new Error(`Preset ${preset.name} declares Package Addition support but has no Projection Declaration`);
     }
-    const state = stateForProjectionDeclaration(preset.projection);
+    const state = stateForProjectionDeclaration(preset.projection, sourceRoots);
     const additionCapability = packageAdditionCapabilityForState(preset.name, state);
     return `${packageCollection(additionCapability.workspacePackageGlob)}/${packageLeafName}`;
 }
-export function loadBuiltInPresetProjectionDeclaration(presetName) {
-    const manifestPath = path.join(packageTemplateRoot(path.dirname(fileURLToPath(import.meta.url))), "preset-source.json");
-    const manifest = JSON.parse(readFileSync(manifestPath, "utf8"));
-    if (!isRecord(manifest) || !Array.isArray(manifest.presets)) {
-        throw new Error("Built-in Preset Source Manifest must declare presets");
-    }
-    const preset = manifest.presets.find((candidate) => isRecord(candidate) && candidate.name === presetName);
-    if (!isRecord(preset) || preset.projection === undefined) {
-        throw new Error(`Built-in Preset ${presetName} must declare a Projection Declaration`);
-    }
-    const result = validateProjectionCapabilities(preset.projection);
-    if (!result.ok) {
-        throw new Error(`Built-in Preset ${presetName} Projection Declaration is invalid:\n${result.issues
-            .map((issue) => `  - ${issue.path}: ${issue.message}`)
-            .join("\n")}`);
-    }
-    return result.value;
-}
-function createProjectionCompositionState() {
+function createProjectionCompositionState(sourceRoots) {
     return {
+        projectionSourceRoots: sourceRoots,
         sourceRoots: {},
         rootCheckComponents: [],
         rootCheckEnvironmentNeeds: [],
@@ -860,14 +839,14 @@ function blueprintPackagesForCapabilities(capabilities, packageScope, projectNam
         return [];
     });
 }
-function stateForProjectionDeclaration(declaration) {
+function stateForProjectionDeclaration(declaration, sourceRoots) {
     const validation = validateProjectionCapabilities(declaration);
     if (!validation.ok) {
         throw new Error(`Projection Declaration is invalid:\n${validation.issues
             .map((issue) => `  - ${issue.path}: ${issue.message}`)
             .join("\n")}`);
     }
-    const state = createProjectionCompositionState();
+    const state = createProjectionCompositionState(sourceRoots);
     for (const capability of validation.value.capabilities) {
         capabilityInterpreters[capability.kind].contribute({
             capability: capability,
@@ -2193,15 +2172,9 @@ function githubMaintenanceOperations() {
         },
     ];
 }
-function templateSourceRoot(sourcePreset) {
-    return templateSourceRootForPreset(sourcePreset);
-}
-function templateSourceRootForPreset(sourcePreset) {
-    return packageTemplateRoot(path.dirname(fileURLToPath(import.meta.url)), sourcePreset);
-}
-function sharedOxcSourceRoot() {
-    return packageTemplateRoot(path.dirname(fileURLToPath(import.meta.url)), "shared", "oxc");
+function templateSourceRoot(state, sourcePreset) {
+    return templateSourceRootForPreset(state, sourcePreset);
 }
-function sharedDevcontainerSourceRoot() {
-    return packageTemplateRoot(path.dirname(fileURLToPath(import.meta.url)), "shared", "devcontainer");
+function templateSourceRootForPreset(state, sourcePreset) {
+    return state.projectionSourceRoots.preset(sourcePreset);
 }

package/{dist/src → node_modules/@ykdz/template-core/dist}/renderer.js

@@ -380,7 +380,9 @@ async function copyGeneratedFile(from, to) {
     }
     catch (error) {
         if (isNodeError(error) && error.code === "EEXIST") {
-            throw new Error(`Refusing to overwrite existing file: ${to}`);
+            throw new Error(`Refusing to overwrite existing file: ${to}`, {
+                cause: error,
+            });
         }
         throw error;
     }
@@ -394,7 +396,9 @@ async function writeGeneratedFile(to, text, overwrite = false) {
     }
     catch (error) {
         if (isNodeError(error) && error.code === "EEXIST") {
-            throw new Error(`Refusing to overwrite existing file: ${to}`);
+            throw new Error(`Refusing to overwrite existing file: ${to}`, {
+                cause: error,
+            });
         }
         throw error;
     }
@@ -447,7 +451,9 @@ async function commitStagedProject(stagingRoot, targetRoot) {
                 // The target disappeared between the emptiness check and commit.
             }
             else if (isNodeError(error) && error.code === "ENOTEMPTY") {
-                throw new Error(`Target directory is not empty: ${targetRoot}`);
+                throw new Error(`Target directory is not empty: ${targetRoot}`, {
+                    cause: error,
+                });
             }
             else {
                 throw error;
@@ -460,7 +466,9 @@ async function commitStagedProject(stagingRoot, targetRoot) {
     catch (error) {
         if (isNodeError(error) &&
             ["EEXIST", "ENOTEMPTY", "ENOTDIR", "EISDIR"].includes(error.code ?? "")) {
-            throw new Error(`Refusing to overwrite existing target: ${targetRoot}`);
+            throw new Error(`Refusing to overwrite existing target: ${targetRoot}`, {
+                cause: error,
+            });
         }
         throw error;
     }

package/{dist/src → node_modules/@ykdz/template-core/dist}/runtime-paths.js

@@ -2,6 +2,8 @@ import { existsSync } from "node:fs";
 import path from "node:path";
 export function packageTemplateRoot(moduleDir, ...segments) {
     const candidates = [
+        path.join(moduleDir, "..", "..", "builtin-source", "templates", ...segments),
+        path.join(moduleDir, "..", "..", "template-builtin-source", "templates", ...segments),
         path.join(moduleDir, "..", "..", "templates", ...segments),
         path.join(moduleDir, "..", "templates", ...segments),
         path.join(moduleDir, "..", "..", "..", "templates", ...segments),

package/{dist/src → node_modules/@ykdz/template-core/dist}/toolchain-resolution.js

@@ -53,7 +53,7 @@ async function contractPhase(phase, operation) {
     }
     catch (error) {
         const message = error instanceof Error ? error.message : String(error);
-        throw new Error(`Online toolchain resolution contract failed during ${phase}: ${message}`, error instanceof Error ? { cause: error } : undefined);
+        throw new Error(`Online toolchain resolution contract failed during ${phase}: ${message}`, { cause: error });
     }
 }
 function fallbackResult(diagnostics) {

package/node_modules/@ykdz/template-core/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@ykdz/template-core",
+  "version": "0.0.8",
+  "private": true,
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "exports": {
+    "./*": {
+      "types": "./dist/*.d.ts",
+      "default": "./dist/*.js"
+    }
+  },
+  "scripts": {
+    "build": "rm -rf dist && tsc -p tsconfig.build.json && cp ../../pnpm-workspace.yaml dist/pnpm-workspace.yaml",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  },
+  "dependencies": {
+    "typescript": "catalog:",
+    "valibot": "catalog:"
+  },
+  "devDependencies": {
+    "@types/node": "catalog:",
+    "execa": "catalog:"
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ykdz/template",
-  "version": "0.0.7",
+  "version": "0.0.8",
   "private": false,
   "description": "Project template generator for YKDZ starter projects.",
   "keywords": [
@@ -18,17 +18,13 @@
     "url": "git+https://github.com/YKDZ/template.git"
   },
   "bin": {
-    "template": "dist/src/cli.js"
+    "template": "dist/cli.js"
   },
   "files": [
     "dist",
-    "pnpm-workspace.yaml",
-    "templates",
-    "!templates/registry.ts",
-    "!templates/projection-plans.ts",
-    "!templates/*/projection.ts",
-    "!templates/shared/oxc/tsconfig.json",
-    "!templates/**/node_modules"
+    "node_modules/@ykdz/template-core",
+    "node_modules/@ykdz/template-builtin-source",
+    "!**/node_modules/**/node_modules"
   ],
   "type": "module",
   "publishConfig": {
@@ -36,38 +32,22 @@
   },
   "dependencies": {
     "typescript": "^6.0.3",
-    "valibot": "^1.4.2"
+    "valibot": "^1.4.2",
+    "@ykdz/template-builtin-source": "0.0.8",
+    "@ykdz/template-core": "0.0.8"
   },
   "devDependencies": {
-    "@types/node": "^24.0.0",
-    "execa": "^9.6.1",
-    "oxfmt": "^0.57.0",
-    "oxlint": "^1.72.0",
-    "oxlint-tsgolint": "^0.24.0",
-    "tsx": "^4.22.4",
-    "vitest": "^4.1.9",
-    "yaml": "^2.9.0"
+    "@types/node": "^24.0.0"
   },
+  "bundledDependencies": [
+    "@ykdz/template-builtin-source",
+    "@ykdz/template-core"
+  ],
   "engines": {
     "node": ">=24.0.0"
   },
   "scripts": {
     "build": "rm -rf dist && tsc -p tsconfig.build.json",
-    "check": "pnpm run check:format && pnpm run typecheck && pnpm run test && pnpm run check:generated && pnpm run check:templates",
-    "check:format": "oxfmt --check --config templates/shared/oxc/oxfmt.config.ts --ignore-path .oxfmtignore .",
-    "check:fixtures": "tsx scripts/check-fixtures.ts",
-    "check:generated": "tsx scripts/check-generated.ts",
-    "check:templates": "pnpm run check:templates:shared-oxc && pnpm run check:templates:github-yaml && pnpm run check:templates:boundary && pnpm run check:templates:static-source",
-    "check:toolchain:online": "tsx scripts/check-online-toolchain-resolution-contract.ts",
-    "check:templates:boundary": "tsx scripts/check-template-boundary.ts",
-    "check:templates:github-yaml": "tsx scripts/check-template-github-yaml.ts",
-    "check:templates:shared-oxc": "pnpm run check:templates:shared-oxc:format && pnpm run check:templates:shared-oxc:lint && pnpm run check:templates:shared-oxc:typecheck",
-    "check:templates:shared-oxc:format": "oxfmt --check templates/shared/oxc",
-    "check:templates:shared-oxc:lint": "oxlint templates/shared/oxc --deny-warnings",
-    "check:templates:shared-oxc:typecheck": "tsc -p templates/shared/oxc/tsconfig.json --noEmit",
-    "check:templates:static-source": "rustfmt --check templates/rust-bin/src/main.rs",
-    "fix": "pnpm run build",
-    "typecheck": "tsc -p tsconfig.json --noEmit",
-    "test": "vitest run"
+    "typecheck": "tsc -p tsconfig.json --noEmit"
   }
 }

package/README.md

@@ -1,35 +0,0 @@
-# @ykdz/template
-
-Project template generator for YKDZ starter projects.
-
-## Usage
-
-```sh
-pnpm dlx @ykdz/template init my-project --preset ts-lib --yes
-```
-
-Available commands:
-
-```sh
-template init <dir> --preset <name> --yes
-template add package --preset <name> --name <name> [--path <package-path>]
-template presets
-template schema preset
-template schema blueprint
-template preset validate <path>
-template blueprint validate <path>
-```
-
-Supported presets are `ts-lib`, `hono-api`, `vue-app`, `vue-hono-app`, and
-`rust-bin`.
-
-## Publishing
-
-This package is intended to publish through npm Trusted Publishing from the
-GitHub Actions release workflow. Maintainers should complete
-[the Trusted Publishing checklist](docs/npm-trusted-publishing.md) before the
-first public release.
-
-## License
-
-MIT

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

@@ -1,8 +0,0 @@
-export type AddPackageOptions = {
-    cwd: string;
-    preset: string;
-    name: string;
-    path?: string;
-    linkFrom?: readonly string[];
-};
-export declare function addPackage(options: AddPackageOptions): Promise<void>;