@ykdz/template 0.0.1 → 0.0.3

package/dist/templates/rust-bin/projection.js

@@ -0,0 +1,282 @@
+import { existsSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { devcontainerNodeFeature } from "../../src/devcontainer.js";
+import { editorCustomizationForCapabilities } from "../../src/editor-customization.js";
+import { renderFixCommand, renderRootCheckCommand, } from "../../src/module-graph.js";
+import { projectCheckWorkflow, projectDependabotConfig, } from "../../src/project-github.js";
+import { renderNewProject } from "../../src/renderer.js";
+const generatedBy = {
+    packageName: "@ykdz/template",
+    version: "0.0.0",
+    command: "template init --preset rust-bin",
+};
+export const rustBinPresetMetadata = {
+    name: "rust-bin",
+    title: "Rust binary",
+    description: "Single-package Rust native binary with rustfmt, clippy, and cargo tests.",
+    generation: "supported",
+    supportedPackageManagers: ["pnpm"],
+    supportedProjectKinds: ["single-package"],
+    features: [
+        "root-check",
+        "fix-command",
+        "devcontainer",
+        "github-actions",
+        "dependabot",
+        "rustfmt-clippy",
+        "cargo-test",
+    ],
+};
+const dependencyMaintenancePolicy = {
+    ecosystems: ["npm", "cargo", "github-actions"],
+    interval: "weekly",
+};
+const rustPackageBoundary = {
+    kind: "package-boundary",
+    path: ".",
+};
+function cargoPackageNameFromProjectName(projectName) {
+    const slug = projectName
+        .normalize("NFKD")
+        .replace(/[\u0300-\u036f]/g, "")
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+    return slug || "rust-bin";
+}
+export function planRustBinChecks() {
+    return {
+        components: [
+            { kind: "rustfmt-check", owner: rustPackageBoundary },
+            { kind: "cargo-clippy", owner: rustPackageBoundary },
+            { kind: "cargo-test", owner: rustPackageBoundary },
+        ],
+        environmentNeeds: [],
+    };
+}
+export function planRustBinFixes() {
+    return {
+        components: [{ kind: "rustfmt-write", owner: rustPackageBoundary }],
+    };
+}
+export function rustBinBlueprint() {
+    return {
+        schemaVersion: 1,
+        preset: "rust-bin",
+        packageManager: "pnpm",
+        projectKind: "single-package",
+        features: [...rustBinPresetMetadata.features],
+    };
+}
+export function projectRustBinPackageScripts() {
+    return {
+        check: renderRootCheckCommand(planRustBinChecks()),
+        fix: renderFixCommand(planRustBinFixes()),
+    };
+}
+function cargoToml(projectName) {
+    return [
+        "[package]",
+        `name = "${projectName}"`,
+        'version = "0.1.0"',
+        'edition = "2024"',
+        "",
+        "[dependencies]",
+        "",
+        "[lints]",
+        "workspace = true",
+        "",
+        "[workspace]",
+        'members = ["."]',
+        'resolver = "3"',
+        "",
+        "[workspace.lints.rust]",
+        'unsafe_code = "forbid"',
+        "",
+        "[workspace.lints.clippy]",
+        'all = "deny"',
+        'pedantic = "deny"',
+        'nursery = "deny"',
+        "",
+        "[profile.release]",
+        'strip = "symbols"',
+        'lto = "thin"',
+        "codegen-units = 1",
+        "",
+    ].join("\n");
+}
+function cargoLock(projectName) {
+    return [
+        "# This file is automatically @generated by Cargo.",
+        "# It is not intended for manual editing.",
+        "version = 4",
+        "",
+        "[[package]]",
+        `name = "${projectName}"`,
+        'version = "0.1.0"',
+        "",
+    ].join("\n");
+}
+function packageJson(context, projectName, packageScripts) {
+    return {
+        name: projectName,
+        version: "0.0.0",
+        private: true,
+        scripts: packageScripts,
+        engines: {
+            node: context.toolchain.nodeLtsMajor.value,
+        },
+        packageManager: context.toolchain.packageManagerPin.value,
+    };
+}
+function generationRecord(context) {
+    return {
+        ...generatedBy,
+        toolchain: {
+            nodeLtsMajor: context.toolchain.nodeLtsMajor.value,
+            packageManagerPin: context.toolchain.packageManagerPin.value,
+            source: context.toolchain.source,
+        },
+    };
+}
+function operationsForRustBin(context, projectName, packageScripts, checkPlan) {
+    const editorCustomization = editorCustomizationForCapabilities([
+        "rust-tooling",
+    ]);
+    return [
+        {
+            kind: "writeJson",
+            to: "package.json",
+            value: packageJson(context, projectName, packageScripts),
+        },
+        {
+            kind: "writeText",
+            to: "pnpm-workspace.yaml",
+            text: ["packages:", "  - .", ""].join("\n"),
+        },
+        {
+            kind: "writeText",
+            to: "Cargo.toml",
+            text: cargoToml(projectName),
+        },
+        {
+            kind: "writeText",
+            to: "Cargo.lock",
+            text: cargoLock(projectName),
+        },
+        {
+            kind: "writeText",
+            to: "rustfmt.toml",
+            text: ['edition = "2024"', "max_width = 100", ""].join("\n"),
+        },
+        {
+            kind: "writeText",
+            to: ".gitignore",
+            text: ["target", ".env", ""].join("\n"),
+        },
+        {
+            kind: "copyFile",
+            from: "src/main.rs",
+            to: "src/main.rs",
+        },
+        {
+            kind: "writeJson",
+            to: ".project-kit/blueprint.json",
+            value: rustBinBlueprint(),
+        },
+        {
+            kind: "writeJson",
+            to: ".project-kit/generated-by.json",
+            value: generationRecord(context),
+        },
+        {
+            kind: "writeJson",
+            to: ".devcontainer/devcontainer.json",
+            value: {
+                name: `${projectName} Rust development`,
+                image: "mcr.microsoft.com/devcontainers/rust:1",
+                features: devcontainerNodeFeature({
+                    nodeVersion: context.toolchain.nodeLtsMajor.value,
+                    packageManagerPin: context.toolchain.packageManagerPin.value,
+                }),
+                mounts: [
+                    "source=${localWorkspaceFolderBasename}-cargo-registry,target=/usr/local/cargo/registry,type=volume",
+                    "source=${localWorkspaceFolderBasename}-cargo-git,target=/usr/local/cargo/git,type=volume",
+                    "source=${localWorkspaceFolderBasename}-target,target=${containerWorkspaceFolder}/target,type=volume",
+                ],
+                customizations: {
+                    vscode: {
+                        extensions: editorCustomization.extensions,
+                        settings: editorCustomization.settings,
+                    },
+                },
+            },
+        },
+        {
+            kind: "writeJson",
+            to: ".vscode/extensions.json",
+            value: {
+                recommendations: editorCustomization.extensions,
+            },
+        },
+        {
+            kind: "writeJson",
+            to: ".vscode/settings.json",
+            value: editorCustomization.settings,
+        },
+        {
+            kind: "writeText",
+            to: ".github/workflows/check.yml",
+            text: projectCheckWorkflow({
+                checkPlan,
+                environmentPreparation: { rustToolchain: true },
+            }),
+        },
+        {
+            kind: "writeText",
+            to: ".github/dependabot.yml",
+            text: projectDependabotConfig(dependencyMaintenancePolicy),
+        },
+    ];
+}
+function templateSourceRoot() {
+    const projectionDir = path.dirname(fileURLToPath(import.meta.url));
+    const publishedTemplateRoot = path.join(projectionDir, "..", "..", "..", "templates", "rust-bin");
+    return existsSync(path.join(publishedTemplateRoot, "src", "main.rs"))
+        ? publishedTemplateRoot
+        : projectionDir;
+}
+export const rustBinPresetProjection = {
+    metadata: rustBinPresetMetadata,
+    blueprint: rustBinBlueprint,
+    project(context) {
+        const checkPlan = planRustBinChecks();
+        const fixPlan = planRustBinFixes();
+        const packageScripts = projectRustBinPackageScripts();
+        const projectName = cargoPackageNameFromProjectName(context.projectName.value);
+        return {
+            sourceRoot: templateSourceRoot(),
+            operations: operationsForRustBin(context, projectName, packageScripts, checkPlan),
+            checkPlan,
+            fixPlan,
+            dependencyMaintenancePolicy,
+            packageScripts,
+            capabilities: {
+                rootCheck: true,
+                fixCommand: true,
+                githubActions: true,
+                dependabot: true,
+                devcontainer: true,
+            },
+        };
+    },
+    async render({ targetDir, plan }) {
+        await renderNewProject({
+            sourceRoot: plan.sourceRoot,
+            sourceRoots: plan.sourceRoots,
+            targetRoot: targetDir,
+            operations: [...plan.operations],
+        });
+    },
+};

package/dist/templates/ts-lib/projection.d.ts

@@ -0,0 +1,7 @@
+import type { BuiltInPreset, ProjectBlueprint } from "../../src/declarations.js";
+import type { PresetProjection } from "../../src/preset-projection.js";
+export declare const tsLibPresetMetadata: BuiltInPreset;
+export declare function tsLibBlueprint(): ProjectBlueprint;
+export declare function projectTsLibPackageScripts(): Record<string, string>;
+export declare const tsLibPresetProjection: PresetProjection;
+//# sourceMappingURL=projection.d.ts.map

package/dist/templates/ts-lib/projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection.d.ts","sourceRoot":"","sources":["../../../templates/ts-lib/projection.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,aAAa,EACb,gBAAgB,EACjB,MAAM,2BAA2B,CAAC;AAYnC,OAAO,KAAK,EAGV,gBAAgB,EAEjB,MAAM,gCAAgC,CAAC;AAcxC,eAAO,MAAM,mBAAmB,EAAE,aAiBjC,CAAC;AAgCF,wBAAgB,cAAc,IAAI,gBAAgB,CAQjD;AAED,wBAAgB,0BAA0B,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAcnE;AA0SD,eAAO,MAAM,qBAAqB,EAAE,gBA4CnC,CAAC"}

package/dist/templates/ts-lib/projection.js

@@ -0,0 +1,372 @@
+import { existsSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { renderGeneratedPnpmWorkspaceYaml } from "../../src/dependency-catalog.js";
+import { nodePnpmDevcontainer } from "../../src/devcontainer.js";
+import { editorCustomizationForCapabilities } from "../../src/editor-customization.js";
+import { renderFixCommand, renderRootCheckCommand, } from "../../src/module-graph.js";
+import { projectCheckWorkflow, projectDependabotConfig, } from "../../src/project-github.js";
+import { renderNewProject } from "../../src/renderer.js";
+const generatedBy = {
+    packageName: "@ykdz/template",
+    version: "0.0.0",
+    command: "template init --preset ts-lib",
+};
+export const tsLibPresetMetadata = {
+    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",
+    ],
+};
+const dependencyMaintenancePolicy = {
+    ecosystems: ["npm", "github-actions"],
+    interval: "weekly",
+};
+const tsLibPackageBoundary = {
+    kind: "package-boundary",
+    path: ".",
+};
+function planTsLibChecks() {
+    return {
+        components: [
+            { kind: "typescript-typecheck", owner: tsLibPackageBoundary },
+            { kind: "oxc-lint", owner: tsLibPackageBoundary },
+            { kind: "oxc-format-check", owner: tsLibPackageBoundary },
+        ],
+        environmentNeeds: [],
+    };
+}
+function planTsLibFixes() {
+    return {
+        components: [
+            { kind: "oxc-format-write", owner: tsLibPackageBoundary },
+            { kind: "oxc-lint-fix", owner: tsLibPackageBoundary },
+        ],
+    };
+}
+export function tsLibBlueprint() {
+    return {
+        schemaVersion: 1,
+        preset: "ts-lib",
+        packageManager: "pnpm",
+        projectKind: "single-package",
+        features: [...tsLibPresetMetadata.features],
+    };
+}
+export function projectTsLibPackageScripts() {
+    const checkPlan = planTsLibChecks();
+    const fixPlan = planTsLibFixes();
+    return {
+        build: "tsc -p tsconfig.json && tsc-alias -p tsconfig.json",
+        check: renderRootCheckCommand(checkPlan),
+        fix: renderFixCommand(fixPlan),
+        "format:check": "oxfmt --check .",
+        "format:write": "oxfmt --write .",
+        lint: "oxlint . --deny-warnings",
+        "lint:fix": "oxlint . --fix --deny-warnings",
+        typecheck: "tsc -p tsconfig.json --noEmit",
+    };
+}
+function packageJson(context, packageScripts) {
+    return {
+        name: context.projectName.value,
+        version: "0.0.0",
+        private: true,
+        files: ["dist"],
+        type: "module",
+        exports: {
+            ".": {
+                default: "./dist/index.js",
+                types: "./dist/index.d.ts",
+            },
+        },
+        scripts: packageScripts,
+        devDependencies: {
+            "@types/node": "catalog:",
+            oxfmt: "catalog:",
+            oxlint: "catalog:",
+            "tsc-alias": "catalog:",
+            typescript: "catalog:",
+        },
+        engines: {
+            node: context.toolchain.nodeLtsMajor.value,
+        },
+        packageManager: context.toolchain.packageManagerPin.value,
+    };
+}
+function generationRecord(context) {
+    return {
+        ...generatedBy,
+        toolchain: {
+            nodeLtsMajor: context.toolchain.nodeLtsMajor.value,
+            packageManagerPin: context.toolchain.packageManagerPin.value,
+            source: context.toolchain.source,
+        },
+    };
+}
+function operationsForTsLib(context, packageScripts, checkPlan) {
+    const editorCustomization = editorCustomizationForCapabilities([
+        "oxc-format-lint",
+    ]);
+    return [
+        {
+            kind: "writeJson",
+            to: "package.json",
+            value: packageJson(context, packageScripts),
+            multilineArrays: ["files"],
+        },
+        {
+            kind: "writeText",
+            to: "pnpm-workspace.yaml",
+            text: renderGeneratedPnpmWorkspaceYaml({
+                dependencies: [
+                    "@types/node",
+                    "oxfmt",
+                    "oxlint",
+                    "tsc-alias",
+                    "typescript",
+                ],
+            }),
+        },
+        {
+            kind: "writeJson",
+            to: "tsconfig.json",
+            value: {
+                compilerOptions: {
+                    declaration: true,
+                    declarationMap: true,
+                    module: "NodeNext",
+                    moduleResolution: "NodeNext",
+                    noEmitOnError: true,
+                    outDir: "dist",
+                    paths: {
+                        "@/*": ["./src/*"],
+                    },
+                    rootDir: "src",
+                    skipLibCheck: false,
+                    strict: true,
+                    target: "ES2022",
+                    types: ["node"],
+                },
+                include: ["src/**/*.ts"],
+            },
+        },
+        {
+            kind: "copyFile",
+            sourceRoot: "sharedOxc",
+            from: "node/oxlint.config.ts",
+            to: "oxlint.config.ts",
+        },
+        {
+            kind: "copyFile",
+            sourceRoot: "sharedOxc",
+            from: "oxfmt.config.ts",
+            to: "oxfmt.config.ts",
+        },
+        {
+            kind: "writeText",
+            to: ".gitignore",
+            text: ["node_modules", "dist", ".env", ""].join("\n"),
+        },
+        {
+            kind: "copyFile",
+            from: "src/index.ts",
+            to: "src/index.ts",
+        },
+        {
+            kind: "writeJson",
+            to: ".project-kit/blueprint.json",
+            value: tsLibBlueprint(),
+        },
+        {
+            kind: "writeJson",
+            to: ".project-kit/generated-by.json",
+            value: generationRecord(context),
+        },
+        {
+            kind: "writeJson",
+            to: ".devcontainer/devcontainer.json",
+            value: nodePnpmDevcontainer({
+                name: `${context.projectName.value} development`,
+                nodeVersion: context.toolchain.nodeLtsMajor.value,
+                packageManagerPin: context.toolchain.packageManagerPin.value,
+                extensions: editorCustomization.extensions,
+                settings: editorCustomization.settings,
+            }),
+        },
+        {
+            kind: "writeJson",
+            to: ".vscode/extensions.json",
+            value: {
+                recommendations: editorCustomization.extensions,
+            },
+            multilineArrays: ["recommendations"],
+        },
+        {
+            kind: "writeJson",
+            to: ".vscode/settings.json",
+            value: editorCustomization.settings,
+        },
+        {
+            kind: "writeText",
+            to: ".github/workflows/check.yml",
+            text: projectCheckWorkflow({ checkPlan }),
+        },
+        {
+            kind: "writeText",
+            to: ".github/dependabot.yml",
+            text: projectDependabotConfig(dependencyMaintenancePolicy),
+        },
+    ];
+}
+function packageAdditionOperations(packagePath, packageName, nodeVersion) {
+    return [
+        {
+            kind: "writeJson",
+            to: `${packagePath}/package.json`,
+            value: {
+                name: packageName,
+                version: "0.0.0",
+                private: true,
+                files: ["dist"],
+                type: "module",
+                exports: {
+                    ".": {
+                        default: "./dist/index.js",
+                        types: "./dist/index.d.ts",
+                    },
+                },
+                scripts: projectTsLibPackageScripts(),
+                devDependencies: {
+                    "@types/node": "catalog:",
+                    oxfmt: "catalog:",
+                    oxlint: "catalog:",
+                    "tsc-alias": "catalog:",
+                    typescript: "catalog:",
+                },
+                engines: {
+                    node: nodeVersion,
+                },
+            },
+            multilineArrays: ["files"],
+        },
+        {
+            kind: "writeJson",
+            to: `${packagePath}/tsconfig.json`,
+            value: {
+                compilerOptions: {
+                    composite: true,
+                    declaration: true,
+                    declarationMap: true,
+                    module: "NodeNext",
+                    moduleResolution: "NodeNext",
+                    noEmitOnError: true,
+                    outDir: "dist",
+                    paths: {
+                        "@/*": ["./src/*"],
+                    },
+                    rootDir: "src",
+                    skipLibCheck: false,
+                    strict: true,
+                    target: "ES2022",
+                    types: ["node"],
+                },
+                include: ["src/**/*.ts"],
+            },
+        },
+        {
+            kind: "copyFile",
+            sourceRoot: "sharedOxc",
+            from: "node/oxlint.config.ts",
+            to: `${packagePath}/oxlint.config.ts`,
+        },
+        {
+            kind: "copyFile",
+            sourceRoot: "sharedOxc",
+            from: "oxfmt.config.ts",
+            to: `${packagePath}/oxfmt.config.ts`,
+        },
+        {
+            kind: "copyFile",
+            from: "src/index.ts",
+            to: `${packagePath}/src/index.ts`,
+        },
+    ];
+}
+function packageAdditionPlan(packageLeafName, packageName, nodeVersion) {
+    const packagePath = `packages/${packageLeafName}`;
+    return {
+        packagePath,
+        workspacePackageGlob: "packages/*",
+        rootTsconfigReferences: [`./${packagePath}/tsconfig.json`],
+        sourceRoot: templateSourceRoot(),
+        sourceRoots: { sharedOxc: sharedOxcSourceRoot() },
+        operations: packageAdditionOperations(packagePath, packageName, nodeVersion),
+    };
+}
+function templateSourceRoot() {
+    const projectionDir = path.dirname(fileURLToPath(import.meta.url));
+    const publishedTemplateRoot = path.join(projectionDir, "..", "..", "..", "templates", "ts-lib");
+    return existsSync(path.join(publishedTemplateRoot, "src", "index.ts"))
+        ? publishedTemplateRoot
+        : projectionDir;
+}
+function sharedOxcSourceRoot() {
+    const projectionDir = path.dirname(fileURLToPath(import.meta.url));
+    const publishedSharedRoot = path.join(projectionDir, "..", "..", "..", "templates", "shared", "oxc");
+    return existsSync(path.join(publishedSharedRoot, "oxfmt.config.ts"))
+        ? publishedSharedRoot
+        : path.join(projectionDir, "..", "shared", "oxc");
+}
+export const tsLibPresetProjection = {
+    metadata: tsLibPresetMetadata,
+    capabilities: {
+        packageAddition: {
+            planPackageAddition({ packageLeafName, packageName, nodeVersion, }) {
+                return packageAdditionPlan(packageLeafName, packageName, nodeVersion);
+            },
+        },
+    },
+    blueprint: tsLibBlueprint,
+    project(context) {
+        const checkPlan = planTsLibChecks();
+        const fixPlan = planTsLibFixes();
+        const packageScripts = projectTsLibPackageScripts();
+        return {
+            sourceRoot: templateSourceRoot(),
+            sourceRoots: { sharedOxc: sharedOxcSourceRoot() },
+            operations: operationsForTsLib(context, packageScripts, checkPlan),
+            checkPlan,
+            fixPlan,
+            dependencyMaintenancePolicy,
+            packageScripts,
+            capabilities: {
+                rootCheck: true,
+                fixCommand: true,
+                githubActions: true,
+                dependabot: true,
+                devcontainer: true,
+            },
+        };
+    },
+    async render({ targetDir, plan }) {
+        await renderNewProject({
+            sourceRoot: plan.sourceRoot,
+            sourceRoots: plan.sourceRoots,
+            targetRoot: targetDir,
+            operations: [...plan.operations],
+        });
+    },
+};

package/dist/templates/vue-app/projection.d.ts

@@ -0,0 +1,7 @@
+import type { BuiltInPreset, ProjectBlueprint } from "../../src/declarations.js";
+import type { PresetProjection } from "../../src/preset-projection.js";
+export declare const vueAppPresetMetadata: BuiltInPreset;
+export declare function vueAppBlueprint(): ProjectBlueprint;
+export declare function projectVueAppPackageScripts(): Record<string, string>;
+export declare const vueAppPresetProjection: PresetProjection;
+//# sourceMappingURL=projection.d.ts.map

package/dist/templates/vue-app/projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection.d.ts","sourceRoot":"","sources":["../../../templates/vue-app/projection.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,aAAa,EACb,gBAAgB,EACjB,MAAM,2BAA2B,CAAC;AAUnC,OAAO,KAAK,EAGV,gBAAgB,EAEjB,MAAM,gCAAgC,CAAC;AAexC,eAAO,MAAM,oBAAoB,EAAE,aAkBlC,CAAC;AAOF,wBAAgB,eAAe,IAAI,gBAAgB,CAQlD;AAED,wBAAgB,2BAA2B,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAepE;AAgjBD,eAAO,MAAM,sBAAsB,EAAE,gBAsCpC,CAAC"}