@ykdz/template 0.0.0

package/dist/declarations.js

@@ -0,0 +1,340 @@
+import * as v from "valibot";
+export const builtInPresets = [
+    {
+        name: "ts-lib",
+        title: "TypeScript library",
+        description: "Strict TypeScript package with pnpm catalog tooling.",
+        generation: "supported",
+        supportedPackageManagers: ["pnpm"],
+        supportedProjectKinds: ["single-package"],
+        features: [
+            "pnpm-catalog",
+            "oxc-format-lint",
+            "strict-typescript",
+            "root-check",
+            "fix-command",
+            "devcontainer",
+            "github-actions",
+            "dependabot"
+        ]
+    },
+    {
+        name: "hono-api",
+        title: "Hono API",
+        description: "Single-package Hono Node API with strict TypeScript tooling.",
+        generation: "supported",
+        supportedPackageManagers: ["pnpm"],
+        supportedProjectKinds: ["single-package"],
+        features: [
+            "pnpm-catalog",
+            "oxc-format-lint",
+            "strict-typescript",
+            "root-check",
+            "fix-command",
+            "devcontainer",
+            "github-actions",
+            "dependabot"
+        ]
+    },
+    {
+        name: "vue-app",
+        title: "Vue app",
+        description: "Single-package Vue app with Vite, Tailwind, Pinia, and test tooling.",
+        generation: "supported",
+        supportedPackageManagers: ["pnpm"],
+        supportedProjectKinds: ["single-package"],
+        features: [
+            "pnpm-catalog",
+            "oxc-format-lint",
+            "strict-typescript",
+            "root-check",
+            "fix-command",
+            "devcontainer",
+            "github-actions",
+            "dependabot"
+        ]
+    },
+    {
+        name: "vue-hono-app",
+        title: "Vue Hono app",
+        description: "Full-stack Vue and Hono workspace with Hono RPC typing.",
+        generation: "supported",
+        supportedPackageManagers: ["pnpm"],
+        supportedProjectKinds: ["multi-package"],
+        features: [
+            "pnpm-catalog",
+            "oxc-format-lint",
+            "strict-typescript",
+            "root-check",
+            "fix-command",
+            "devcontainer",
+            "github-actions",
+            "dependabot"
+        ]
+    },
+    {
+        name: "rust-bin",
+        title: "Rust binary",
+        description: "Single-package Rust native binary with rustfmt, clippy, and cargo tests.",
+        generation: "supported",
+        supportedPackageManagers: [],
+        supportedProjectKinds: ["single-package"],
+        features: [
+            "root-check",
+            "fix-command",
+            "devcontainer",
+            "github-actions",
+            "dependabot",
+            "rustfmt-clippy",
+            "cargo-test"
+        ]
+    },
+    {
+        name: "ts-app",
+        title: "TypeScript application",
+        description: "Future application preset metadata.",
+        generation: "future",
+        supportedPackageManagers: ["pnpm"],
+        supportedProjectKinds: ["single-package"],
+        features: []
+    },
+    {
+        name: "node-cli",
+        title: "Node.js CLI",
+        description: "Future command-line preset metadata.",
+        generation: "future",
+        supportedPackageManagers: ["pnpm"],
+        supportedProjectKinds: ["single-package"],
+        features: []
+    }
+];
+const featureNames = [
+    "pnpm-catalog",
+    "oxc-format-lint",
+    "strict-typescript",
+    "root-check",
+    "fix-command",
+    "devcontainer",
+    "github-actions",
+    "dependabot",
+    "rustfmt-clippy",
+    "cargo-test",
+    "native-binary-release"
+];
+export const presetFileJsonSchema = {
+    $schema: "https://json-schema.org/draft/2020-12/schema",
+    $id: "https://ykdz.dev/schemas/project-kit/preset-file.schema.json",
+    title: "Project Kit Preset File",
+    type: "object",
+    additionalProperties: false,
+    required: [
+        "schemaVersion",
+        "name",
+        "title",
+        "description",
+        "supportedPackageManagers",
+        "supportedProjectKinds",
+        "features"
+    ],
+    properties: {
+        schemaVersion: { const: 1 },
+        name: { type: "string", minLength: 1 },
+        title: { type: "string", minLength: 1 },
+        description: { type: "string", minLength: 1 },
+        supportedPackageManagers: {
+            type: "array",
+            items: { enum: ["pnpm"] },
+            uniqueItems: true
+        },
+        supportedProjectKinds: {
+            type: "array",
+            minItems: 1,
+            items: { enum: ["single-package", "multi-package"] },
+            uniqueItems: true
+        },
+        features: {
+            type: "array",
+            items: { enum: featureNames },
+            uniqueItems: true
+        }
+    }
+};
+export const blueprintJsonSchema = {
+    $schema: "https://json-schema.org/draft/2020-12/schema",
+    $id: "https://ykdz.dev/schemas/project-kit/blueprint.schema.json",
+    title: "Project Kit Blueprint",
+    type: "object",
+    additionalProperties: false,
+    required: ["schemaVersion", "preset", "projectKind", "features"],
+    properties: {
+        schemaVersion: { const: 1 },
+        preset: { type: "string", minLength: 1 },
+        packageManager: { enum: ["pnpm"] },
+        projectKind: { enum: ["single-package", "multi-package"] },
+        features: {
+            type: "array",
+            items: { enum: featureNames },
+            uniqueItems: true
+        },
+        packages: {
+            type: "array",
+            items: {
+                type: "object",
+                additionalProperties: false,
+                required: ["name", "path"],
+                properties: {
+                    name: { type: "string", minLength: 1 },
+                    path: { type: "string", minLength: 1 }
+                }
+            }
+        }
+    }
+};
+const nonEmptyString = v.pipe(v.string(), v.minLength(1));
+const packageManagerSchema = v.picklist(["pnpm"]);
+const projectKindSchema = v.picklist(["single-package", "multi-package"]);
+const featureNameSchema = v.picklist(featureNames);
+export const presetFileSchema = v.strictObject({
+    schemaVersion: v.literal(1),
+    name: nonEmptyString,
+    title: nonEmptyString,
+    description: nonEmptyString,
+    supportedPackageManagers: v.array(packageManagerSchema),
+    supportedProjectKinds: v.pipe(v.array(projectKindSchema), v.minLength(1)),
+    features: v.array(featureNameSchema)
+});
+export const projectBlueprintSchema = v.strictObject({
+    schemaVersion: v.literal(1),
+    preset: nonEmptyString,
+    packageManager: v.optional(packageManagerSchema),
+    projectKind: projectKindSchema,
+    features: v.array(featureNameSchema),
+    packages: v.optional(v.array(v.strictObject({
+        name: nonEmptyString,
+        path: nonEmptyString
+    })))
+});
+function formatIssuePath(issue) {
+    if (!issue.path || issue.path.length === 0) {
+        return "$";
+    }
+    return issue.path.reduce((path, item) => `${path}.${String(item.key)}`, "$");
+}
+function shapeIssues(issues) {
+    return issues.map((issue) => ({
+        path: formatIssuePath(issue),
+        message: issue.message
+    }));
+}
+function duplicateIssues(values, path) {
+    const seen = new Set();
+    const duplicates = new Set();
+    for (const value of values) {
+        if (seen.has(value)) {
+            duplicates.add(value);
+        }
+        seen.add(value);
+    }
+    return [...duplicates].map((value) => ({
+        path,
+        message: `Duplicate value: ${value}`
+    }));
+}
+function generationSupportIssue(preset, path) {
+    if (preset.generation === "supported") {
+        return undefined;
+    }
+    return {
+        path,
+        message: `Preset ${preset.name} is not supported for generation in this version`
+    };
+}
+export function validatePresetFile(input) {
+    const result = v.safeParse(presetFileSchema, input);
+    if (!result.success) {
+        return { ok: false, issues: shapeIssues(result.issues) };
+    }
+    const semanticIssues = [
+        ...duplicateIssues(result.output.supportedPackageManagers, "$.supportedPackageManagers"),
+        ...duplicateIssues(result.output.supportedProjectKinds, "$.supportedProjectKinds"),
+        ...duplicateIssues(result.output.features, "$.features")
+    ];
+    const builtInPreset = findBuiltInPreset(result.output.name);
+    const unsupportedGeneration = builtInPreset
+        ? generationSupportIssue(builtInPreset, "$.name")
+        : undefined;
+    if (unsupportedGeneration) {
+        semanticIssues.push(unsupportedGeneration);
+    }
+    if (semanticIssues.length > 0) {
+        return { ok: false, issues: semanticIssues };
+    }
+    return { ok: true, value: result.output };
+}
+export function findBuiltInPreset(name) {
+    return builtInPresets.find((preset) => preset.name === name);
+}
+export function validateProjectBlueprint(input) {
+    const result = v.safeParse(projectBlueprintSchema, input);
+    if (!result.success) {
+        return { ok: false, issues: shapeIssues(result.issues) };
+    }
+    const blueprint = result.output;
+    const preset = findBuiltInPreset(blueprint.preset);
+    const semanticIssues = [
+        ...duplicateIssues(blueprint.features, "$.features")
+    ];
+    if (!preset) {
+        semanticIssues.push({
+            path: "$.preset",
+            message: `Unknown built-in preset: ${blueprint.preset}`
+        });
+    }
+    else {
+        const unsupportedGeneration = generationSupportIssue(preset, "$.preset");
+        if (unsupportedGeneration) {
+            semanticIssues.push(unsupportedGeneration);
+        }
+        if (blueprint.packageManager &&
+            !preset.supportedPackageManagers.includes(blueprint.packageManager)) {
+            semanticIssues.push({
+                path: "$.packageManager",
+                message: `${blueprint.packageManager} is not supported by preset ${preset.name}`
+            });
+        }
+        if (!blueprint.packageManager && preset.supportedPackageManagers.length > 0) {
+            semanticIssues.push({
+                path: "$.packageManager",
+                message: `packageManager is required by preset ${preset.name}`
+            });
+        }
+        if (!preset.supportedProjectKinds.includes(blueprint.projectKind)) {
+            semanticIssues.push({
+                path: "$.projectKind",
+                message: `${blueprint.projectKind} is not supported by preset ${preset.name}`
+            });
+        }
+        const supportedFeatures = new Set(preset.features);
+        for (const feature of blueprint.features) {
+            if (!supportedFeatures.has(feature)) {
+                semanticIssues.push({
+                    path: "$.features",
+                    message: `${feature} is not supported by preset ${preset.name}`
+                });
+            }
+        }
+    }
+    if (blueprint.packages) {
+        if (blueprint.projectKind === "single-package" && blueprint.packages.length > 1) {
+            semanticIssues.push({
+                path: "$.packages",
+                message: "single-package blueprints support exactly one package"
+            });
+        }
+        semanticIssues.push(...duplicateIssues(blueprint.packages.map((projectPackage) => projectPackage.name), "$.packages.name"), ...duplicateIssues(blueprint.packages.map((projectPackage) => projectPackage.path), "$.packages.path"));
+    }
+    if (semanticIssues.length > 0) {
+        return { ok: false, issues: semanticIssues };
+    }
+    return { ok: true, value: blueprint };
+}

package/dist/hono-api.d.ts

@@ -0,0 +1,2 @@
+export declare function initHonoApiProject(targetDir: string): Promise<void>;
+//# sourceMappingURL=hono-api.d.ts.map

package/dist/hono-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hono-api.d.ts","sourceRoot":"","sources":["../src/hono-api.ts"],"names":[],"mappings":"AAwPA,wBAAsB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMzE"}

package/dist/hono-api.js

@@ -0,0 +1,247 @@
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { renderNewProject } from "./renderer.js";
+const features = [
+    "pnpm-catalog",
+    "oxc-format-lint",
+    "strict-typescript",
+    "root-check",
+    "fix-command",
+    "devcontainer",
+    "github-actions",
+    "dependabot"
+];
+const generatedBy = {
+    packageName: "@ykdz/template",
+    version: "0.0.0",
+    command: "template init --preset hono-api"
+};
+function projectNameFromDir(targetDir) {
+    return path.basename(path.resolve(targetDir));
+}
+function packageJson(projectName) {
+    return {
+        name: projectName,
+        version: "0.0.0",
+        private: true,
+        type: "module",
+        scripts: {
+            build: "tsc -p tsconfig.build.json && tsc-alias -p tsconfig.build.json",
+            check: "pnpm run format:check && pnpm run lint && pnpm run typecheck && pnpm run build && pnpm run test",
+            fix: "pnpm run format:write && pnpm run lint:fix",
+            "format:check": "oxfmt --check .",
+            "format:write": "oxfmt --write .",
+            lint: "oxlint . --deny-warnings",
+            "lint:fix": "oxlint . --fix --deny-warnings",
+            start: "node dist/server.js",
+            test: "vitest run",
+            typecheck: "tsc -p tsconfig.json --noEmit"
+        },
+        dependencies: {
+            "@hono/node-server": "catalog:",
+            hono: "catalog:"
+        },
+        devDependencies: {
+            "@types/node": "catalog:",
+            oxfmt: "catalog:",
+            oxlint: "catalog:",
+            "tsc-alias": "catalog:",
+            typescript: "catalog:",
+            vitest: "catalog:"
+        },
+        engines: {
+            node: ">=22.0.0"
+        },
+        packageManager: "pnpm@10.0.0"
+    };
+}
+function operationsForHonoApi(projectName) {
+    return [
+        {
+            kind: "writeJson",
+            to: "package.json",
+            value: packageJson(projectName)
+        },
+        {
+            kind: "writeText",
+            to: "pnpm-workspace.yaml",
+            text: [
+                "packages:",
+                "  - .",
+                "",
+                "catalog:",
+                '  "@hono/node-server": ^2.0.6',
+                '  "@types/node": ^24.0.0',
+                "  hono: ^4.12.27",
+                "  oxfmt: ^0.56.0",
+                "  oxlint: ^1.71.0",
+                "  tsc-alias: ^1.8.17",
+                "  typescript: ^5.8.0",
+                "  vitest: ^4.1.9",
+                ""
+            ].join("\n")
+        },
+        {
+            kind: "writeJson",
+            to: "tsconfig.json",
+            value: {
+                compilerOptions: {
+                    module: "NodeNext",
+                    moduleResolution: "NodeNext",
+                    noEmitOnError: true,
+                    paths: {
+                        "@/*": ["./src/*"]
+                    },
+                    skipLibCheck: false,
+                    strict: true,
+                    target: "ES2022",
+                    types: ["node", "vitest/globals"]
+                },
+                include: ["src/**/*.ts", "test/**/*.ts", "vitest.config.ts"]
+            }
+        },
+        {
+            kind: "writeJson",
+            to: "tsconfig.build.json",
+            value: {
+                extends: "./tsconfig.json",
+                compilerOptions: {
+                    outDir: "dist",
+                    rootDir: "src",
+                    types: ["node"]
+                },
+                include: ["src/**/*.ts"]
+            }
+        },
+        {
+            kind: "writeJson",
+            to: ".oxlintrc.json",
+            value: {
+                categories: {
+                    correctness: "error",
+                    suspicious: "error"
+                },
+                plugins: ["typescript", "oxc"]
+            }
+        },
+        {
+            kind: "writeJson",
+            to: ".oxfmtrc.json",
+            value: {
+                printWidth: 100,
+                singleQuote: false,
+                trailingComma: "none"
+            }
+        },
+        {
+            kind: "writeText",
+            to: ".gitignore",
+            text: ["node_modules", "dist", ".env", ""].join("\n")
+        },
+        {
+            kind: "copyFile",
+            from: "src/app.ts",
+            to: "src/app.ts"
+        },
+        {
+            kind: "copyFile",
+            from: "src/server.ts",
+            to: "src/server.ts"
+        },
+        {
+            kind: "copyFile",
+            from: "test/app.test.ts",
+            to: "test/app.test.ts"
+        },
+        {
+            kind: "copyFile",
+            from: "vitest.config.ts",
+            to: "vitest.config.ts"
+        },
+        {
+            kind: "writeJson",
+            to: ".project-kit/blueprint.json",
+            value: {
+                schemaVersion: 1,
+                preset: "hono-api",
+                packageManager: "pnpm",
+                projectKind: "single-package",
+                features
+            }
+        },
+        {
+            kind: "writeJson",
+            to: ".project-kit/generated-by.json",
+            value: generatedBy
+        },
+        {
+            kind: "writeJson",
+            to: ".devcontainer/devcontainer.json",
+            value: {
+                name: `${projectName} API development`,
+                image: "mcr.microsoft.com/devcontainers/typescript-node:22",
+                postCreateCommand: "corepack enable && pnpm install",
+                customizations: {
+                    vscode: {
+                        extensions: ["oxc.oxc-vscode"]
+                    }
+                }
+            }
+        },
+        {
+            kind: "writeText",
+            to: ".github/workflows/check.yml",
+            text: [
+                "name: Check",
+                "",
+                "on:",
+                "  pull_request:",
+                "  push:",
+                "    branches:",
+                "      - main",
+                "",
+                "jobs:",
+                "  check:",
+                "    runs-on: ubuntu-latest",
+                "    steps:",
+                "      - uses: actions/checkout@v4",
+                "      - uses: pnpm/action-setup@v4",
+                "        with:",
+                "          version: 10.0.0",
+                "      - uses: actions/setup-node@v4",
+                "        with:",
+                "          node-version: 22",
+                "      - run: pnpm install",
+                "      - run: pnpm run check",
+                ""
+            ].join("\n")
+        },
+        {
+            kind: "writeText",
+            to: ".github/dependabot.yml",
+            text: [
+                "version: 2",
+                "updates:",
+                "  - package-ecosystem: npm",
+                "    directory: /",
+                "    schedule:",
+                "      interval: weekly",
+                "  - package-ecosystem: github-actions",
+                "    directory: /",
+                "    schedule:",
+                "      interval: weekly",
+                ""
+            ].join("\n")
+        }
+    ];
+}
+function templateSourceRoot() {
+    return path.join(path.dirname(fileURLToPath(import.meta.url)), "..", "templates", "hono-api");
+}
+export async function initHonoApiProject(targetDir) {
+    await renderNewProject({
+        sourceRoot: templateSourceRoot(),
+        targetRoot: targetDir,
+        operations: operationsForHonoApi(projectNameFromDir(targetDir))
+    });
+}

package/dist/package-addition.d.ts

@@ -0,0 +1,7 @@
+export type AddPackageOptions = {
+    cwd: string;
+    preset: string;
+    name: string;
+};
+export declare function addPackage(options: AddPackageOptions): Promise<void>;
+//# sourceMappingURL=package-addition.d.ts.map

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

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