@projitect/blueprint-vitest 0.0.0-stage → 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kapil Easwar
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/package.json

@@ -0,0 +1,48 @@
+{
+    "name": "@projitect/blueprint-vitest",
+    "version": "1.0.1",
+    "description": "Vitest scaffolding blueprint for projitect — owns vitest.config.ts, package.json scripts/devDeps, and the .gitignore coverage entry.",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/projitect/projitect.git",
+        "directory": "packages/blueprint-vitest"
+    },
+    "license": "MIT",
+    "type": "module",
+    "exports": {
+        ".": {
+            "types": "./dist/src/index.d.ts",
+            "import": "./dist/src/index.js"
+        }
+    },
+    "files": [
+        "dist",
+        "src",
+        "!**/*.tsbuildinfo"
+    ],
+    "scripts": {
+        "build": "tsc --build",
+        "build:clean": "tsc --build --clean",
+        "tc": "tsc --build"
+    },
+    "devDependencies": {
+        "@projitect/blueprint": "workspace:*",
+        "@projitect/core": "workspace:*",
+        "@projitect/test-kit": "workspace:*",
+        "effect": "4.0.0-rc.111",
+        "typescript": "5.9.3"
+    },
+    "peerDependencies": {
+        "@projitect/blueprint": "workspace:*",
+        "@projitect/core": "workspace:*",
+        "effect": "4.0.0-rc.111"
+    },
+    "engines": {
+        "node": ">=22.12.0"
+    },
+    "projitect": {
+        "type": "blueprint",
+        "import": "import { vitest } from \"@projitect/blueprint-vitest\"",
+        "call": "vitest()"
+    }
+}

package/dist/src/index.d.ts

@@ -0,0 +1,49 @@
+/**
+ * @projitect/blueprint-vitest
+ *
+ * One composite blueprint that wires vitest into a project:
+ *
+ *  1. Adds `vitest` and (optionally) `@vitest/coverage-v8` to `package.json`'s `devDependencies`,
+ *     plus `test` / `test:watch` scripts. Merge mode — non-conflicting with whatever else lives
+ *     in `package.json`.
+ *  2. Owns `vitest.config.ts` with sensible defaults (NodeNext-friendly, v8 coverage). Owned
+ *     mode — projitect rewrites this file from scratch on every `remodel` so the user can't
+ *     accidentally drift it. If the user wants project-specific overrides, they should compose
+ *     this blueprint with their own `ownFile` blueprint at a different path.
+ *  3. Adds `coverage/` to `.gitignore`. Region mode — coexists with whatever else is in the file
+ *     (including other projitect blueprints like `@projitect/blueprint-gitignore`).
+ *
+ * This is the smallest framework blueprint we ship after gitignore. It validates merge mode +
+ * owned mode + region mode in one move, and it's the first time the projitect blueprint won't
+ * be the *only* merge-mode consumer in a real project.
+ */
+import type { Blueprint } from "@projitect/core";
+/**
+ * Options for the vitest blueprint. All optional; defaults give a working setup.
+ */
+export interface VitestOptions {
+    /**
+     * Coverage provider. Defaults to `"v8"`. Set to `null` to skip the coverage devDep and the
+     * `.gitignore` coverage entry (you'll get vitest without coverage configured).
+     */
+    readonly coverage?: "v8" | null;
+    /**
+     * Override the script name for the one-shot test runner. Defaults to `"test"`.
+     * The watch variant is always `<scriptName>:watch`.
+     */
+    readonly scriptName?: string;
+    /**
+     * Test environment. Defaults to `"node"` (matches vitest's default). Set to `"jsdom"` if you
+     * want DOM globals — you'll also need to install `jsdom` separately; this blueprint does not
+     * add it because not every consumer needs it.
+     */
+    readonly environment?: "node" | "jsdom";
+}
+/**
+ * Build the composite vitest blueprint. The returned `Blueprint` emits three to four operations
+ * depending on options; the planner / lockfile track each separately so the user gets fine-
+ * grained drift reporting (e.g. "package.json merge drift on devDependencies.vitest" rather than
+ * a vague "blueprint drift").
+ */
+export declare const vitest: (options?: VitestOptions) => Blueprint.Blueprint;
+//# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAWhD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,GAAG,IAAI,CAAA;IAC/B;;;OAGG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CACxC;AAED;;;;;GAKG;AACH,eAAO,MAAM,MAAM,GAAI,UAAS,aAAkB,KAAG,SAAS,CAAC,SA+E9D,CAAA"}

package/dist/src/index.js

@@ -0,0 +1,129 @@
+/**
+ * @projitect/blueprint-vitest
+ *
+ * One composite blueprint that wires vitest into a project:
+ *
+ *  1. Adds `vitest` and (optionally) `@vitest/coverage-v8` to `package.json`'s `devDependencies`,
+ *     plus `test` / `test:watch` scripts. Merge mode — non-conflicting with whatever else lives
+ *     in `package.json`.
+ *  2. Owns `vitest.config.ts` with sensible defaults (NodeNext-friendly, v8 coverage). Owned
+ *     mode — projitect rewrites this file from scratch on every `remodel` so the user can't
+ *     accidentally drift it. If the user wants project-specific overrides, they should compose
+ *     this blueprint with their own `ownFile` blueprint at a different path.
+ *  3. Adds `coverage/` to `.gitignore`. Region mode — coexists with whatever else is in the file
+ *     (including other projitect blueprints like `@projitect/blueprint-gitignore`).
+ *
+ * This is the smallest framework blueprint we ship after gitignore. It validates merge mode +
+ * owned mode + region mode in one move, and it's the first time the projitect blueprint won't
+ * be the *only* merge-mode consumer in a real project.
+ */
+import { Effect } from "effect";
+import { regionFile, jsonMerge, ownFile } from "@projitect/blueprint";
+import { ChangeSet as CS } from "@projitect/core";
+import manifest from "../package.json" with { type: "json" };
+// Read the version from the package manifest (emitted next to `dist/src`) so a release bump
+// reaches `.pjt.lock` without a hand-edited constant. JSON import keeps this runtime-pure.
+const PACKAGE_VERSION = manifest.version;
+const VITEST_DEP_RANGE = "^4.0.0";
+const COVERAGE_V8_DEP_RANGE = "^4.0.0";
+/**
+ * Build the composite vitest blueprint. The returned `Blueprint` emits three to four operations
+ * depending on options; the planner / lockfile track each separately so the user gets fine-
+ * grained drift reporting (e.g. "package.json merge drift on devDependencies.vitest" rather than
+ * a vague "blueprint drift").
+ */
+export const vitest = (options = {}) => {
+    const coverage = options.coverage === undefined ? "v8" : options.coverage;
+    const scriptName = options.scriptName ?? "test";
+    const watchScript = `${scriptName}:watch`;
+    const environment = options.environment ?? "node";
+    const id = "pjt:vitest";
+    // We compose four constructor blueprints inline rather than handing four separate Blueprint
+    // entries to the user — that way `pjt add @projitect/blueprint-vitest` adds one call line, and
+    // every drift / removal is attributed to `pjt:vitest`. The composite plan just `Effect.all`s
+    // their `plan` Effects and concatenates the resulting ChangeSets.
+    const packageJsonMerge = jsonMerge({
+        id,
+        version: PACKAGE_VERSION,
+        description: "vitest devDependencies and test scripts",
+        path: "package.json",
+        ownedKeys: [
+            `scripts.${scriptName}`,
+            `scripts.${watchScript}`,
+            "devDependencies.vitest",
+            ...(coverage === "v8" ? ["devDependencies.@vitest/coverage-v8"] : []),
+        ],
+        value: {
+            scripts: {
+                [scriptName]: "vitest run",
+                [watchScript]: "vitest",
+            },
+            devDependencies: {
+                vitest: VITEST_DEP_RANGE,
+                ...(coverage === "v8" && { "@vitest/coverage-v8": COVERAGE_V8_DEP_RANGE }),
+            },
+        },
+    });
+    const vitestConfig = ownFile({
+        id,
+        version: PACKAGE_VERSION,
+        description: "vitest configuration",
+        path: "vitest.config.ts",
+        content: renderVitestConfig({ coverage, environment }),
+    });
+    const gitignoreCoverage = coverage === "v8"
+        ? regionFile({
+            id,
+            version: PACKAGE_VERSION,
+            description: "ignore vitest coverage output",
+            path: ".gitignore",
+            commentPrefix: "#",
+            content: "coverage/\n",
+        })
+        : null;
+    const composite = {
+        id,
+        version: PACKAGE_VERSION,
+        description: "vitest scaffolding (config + scripts + devDeps + coverage gitignore)",
+        permissions: [
+            { kind: "read", glob: "package.json" },
+            { kind: "write", glob: "package.json" },
+            { kind: "write", glob: "vitest.config.ts" },
+            { kind: "read", glob: ".gitignore" },
+            { kind: "write", glob: ".gitignore" },
+        ],
+        plan: Effect.gen(function* () {
+            const parts = [
+                packageJsonMerge,
+                vitestConfig,
+                ...(gitignoreCoverage === null ? [] : [gitignoreCoverage]),
+            ];
+            const changeSets = yield* Effect.forEach(parts, (b) => b.plan);
+            return CS.Reducer.combineAll(changeSets);
+        }),
+    };
+    return composite;
+};
+const renderVitestConfig = (params) => {
+    const lines = [
+        'import { defineConfig } from "vitest/config"',
+        "",
+        "/**",
+        " * vitest configuration scaffolded by `@projitect/blueprint-vitest`.",
+        " *",
+        " * Owned mode — projitect rewrites this file on every `pjt remodel`. If you need overrides,",
+        " * compose another `ownFile` blueprint at a different path (e.g. `vitest.config.local.ts`)",
+        " * and merge it into this config via vitest's own `mergeConfig` helper at runtime.",
+        " */",
+        "export default defineConfig({",
+        "  test: {",
+        `    environment: "${params.environment}",`,
+        "    passWithNoTests: true,",
+    ];
+    if (params.coverage === "v8") {
+        lines.push("    coverage: {", '      provider: "v8",', '      reporter: ["text", "html"],', "    },");
+    }
+    lines.push("  },", "})", "");
+    return lines.join("\n");
+};
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

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

package/package.json

@@ -1,6 +1,48 @@
 {
   "name": "@projitect/blueprint-vitest",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "1.0.1",
+  "description": "Vitest scaffolding blueprint for projitect — owns vitest.config.ts, package.json scripts/devDeps, and the .gitignore coverage entry.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/projitect/projitect.git",
+    "directory": "packages/blueprint-vitest"
+  },
+  "license": "MIT",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "import": "./dist/src/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "!**/*.tsbuildinfo"
+  ],
+  "devDependencies": {
+    "effect": "4.0.0-rc.111",
+    "typescript": "5.9.3",
+    "@projitect/blueprint": "1.0.1",
+    "@projitect/core": "1.0.1",
+    "@projitect/test-kit": "1.0.1"
+  },
+  "peerDependencies": {
+    "effect": "4.0.0-rc.111",
+    "@projitect/blueprint": "1.0.1",
+    "@projitect/core": "1.0.1"
+  },
+  "engines": {
+    "node": ">=22.12.0"
+  },
+  "projitect": {
+    "type": "blueprint",
+    "import": "import { vitest } from \"@projitect/blueprint-vitest\"",
+    "call": "vitest()"
+  },
+  "scripts": {
+    "build": "tsc --build",
+    "build:clean": "tsc --build --clean",
+    "tc": "tsc --build"
+  }
 }

package/src/index.ts

@@ -0,0 +1,174 @@
+/**
+ * @projitect/blueprint-vitest
+ *
+ * One composite blueprint that wires vitest into a project:
+ *
+ *  1. Adds `vitest` and (optionally) `@vitest/coverage-v8` to `package.json`'s `devDependencies`,
+ *     plus `test` / `test:watch` scripts. Merge mode — non-conflicting with whatever else lives
+ *     in `package.json`.
+ *  2. Owns `vitest.config.ts` with sensible defaults (NodeNext-friendly, v8 coverage). Owned
+ *     mode — projitect rewrites this file from scratch on every `remodel` so the user can't
+ *     accidentally drift it. If the user wants project-specific overrides, they should compose
+ *     this blueprint with their own `ownFile` blueprint at a different path.
+ *  3. Adds `coverage/` to `.gitignore`. Region mode — coexists with whatever else is in the file
+ *     (including other projitect blueprints like `@projitect/blueprint-gitignore`).
+ *
+ * This is the smallest framework blueprint we ship after gitignore. It validates merge mode +
+ * owned mode + region mode in one move, and it's the first time the projitect blueprint won't
+ * be the *only* merge-mode consumer in a real project.
+ */
+
+import { Effect } from "effect"
+import { regionFile, jsonMerge, ownFile } from "@projitect/blueprint"
+import type { Blueprint } from "@projitect/core"
+import { ChangeSet as CS } from "@projitect/core"
+import manifest from "../package.json" with { type: "json" }
+
+// Read the version from the package manifest (emitted next to `dist/src`) so a release bump
+// reaches `.pjt.lock` without a hand-edited constant. JSON import keeps this runtime-pure.
+const PACKAGE_VERSION = manifest.version
+
+const VITEST_DEP_RANGE = "^4.0.0"
+const COVERAGE_V8_DEP_RANGE = "^4.0.0"
+
+/**
+ * Options for the vitest blueprint. All optional; defaults give a working setup.
+ */
+export interface VitestOptions {
+  /**
+   * Coverage provider. Defaults to `"v8"`. Set to `null` to skip the coverage devDep and the
+   * `.gitignore` coverage entry (you'll get vitest without coverage configured).
+   */
+  readonly coverage?: "v8" | null
+  /**
+   * Override the script name for the one-shot test runner. Defaults to `"test"`.
+   * The watch variant is always `<scriptName>:watch`.
+   */
+  readonly scriptName?: string
+  /**
+   * Test environment. Defaults to `"node"` (matches vitest's default). Set to `"jsdom"` if you
+   * want DOM globals — you'll also need to install `jsdom` separately; this blueprint does not
+   * add it because not every consumer needs it.
+   */
+  readonly environment?: "node" | "jsdom"
+}
+
+/**
+ * Build the composite vitest blueprint. The returned `Blueprint` emits three to four operations
+ * depending on options; the planner / lockfile track each separately so the user gets fine-
+ * grained drift reporting (e.g. "package.json merge drift on devDependencies.vitest" rather than
+ * a vague "blueprint drift").
+ */
+export const vitest = (options: VitestOptions = {}): Blueprint.Blueprint => {
+  const coverage = options.coverage === undefined ? "v8" : options.coverage
+  const scriptName = options.scriptName ?? "test"
+  const watchScript = `${scriptName}:watch`
+  const environment = options.environment ?? "node"
+
+  const id = "pjt:vitest"
+
+  // We compose four constructor blueprints inline rather than handing four separate Blueprint
+  // entries to the user — that way `pjt add @projitect/blueprint-vitest` adds one call line, and
+  // every drift / removal is attributed to `pjt:vitest`. The composite plan just `Effect.all`s
+  // their `plan` Effects and concatenates the resulting ChangeSets.
+
+  const packageJsonMerge = jsonMerge({
+    id,
+    version: PACKAGE_VERSION,
+    description: "vitest devDependencies and test scripts",
+    path: "package.json",
+    ownedKeys: [
+      `scripts.${scriptName}`,
+      `scripts.${watchScript}`,
+      "devDependencies.vitest",
+      ...(coverage === "v8" ? ["devDependencies.@vitest/coverage-v8" as const] : []),
+    ],
+    value: {
+      scripts: {
+        [scriptName]: "vitest run",
+        [watchScript]: "vitest",
+      },
+      devDependencies: {
+        vitest: VITEST_DEP_RANGE,
+        ...(coverage === "v8" && { "@vitest/coverage-v8": COVERAGE_V8_DEP_RANGE }),
+      },
+    },
+  })
+
+  const vitestConfig = ownFile({
+    id,
+    version: PACKAGE_VERSION,
+    description: "vitest configuration",
+    path: "vitest.config.ts",
+    content: renderVitestConfig({ coverage, environment }),
+  })
+
+  const gitignoreCoverage =
+    coverage === "v8"
+      ? regionFile({
+          id,
+          version: PACKAGE_VERSION,
+          description: "ignore vitest coverage output",
+          path: ".gitignore",
+          commentPrefix: "#",
+          content: "coverage/\n",
+        })
+      : null
+
+  const composite: Blueprint.Blueprint = {
+    id,
+    version: PACKAGE_VERSION,
+    description: "vitest scaffolding (config + scripts + devDeps + coverage gitignore)",
+    permissions: [
+      { kind: "read", glob: "package.json" },
+      { kind: "write", glob: "package.json" },
+      { kind: "write", glob: "vitest.config.ts" },
+      { kind: "read", glob: ".gitignore" },
+      { kind: "write", glob: ".gitignore" },
+    ],
+    plan: Effect.gen(function* () {
+      const parts = [
+        packageJsonMerge,
+        vitestConfig,
+        ...(gitignoreCoverage === null ? [] : [gitignoreCoverage]),
+      ]
+      const changeSets = yield* Effect.forEach(parts, (b) => b.plan)
+      return CS.Reducer.combineAll(changeSets)
+    }),
+  }
+
+  return composite
+}
+
+const renderVitestConfig = (params: {
+  readonly coverage: "v8" | null
+  readonly environment: "node" | "jsdom"
+}): string => {
+  const lines: string[] = [
+    'import { defineConfig } from "vitest/config"',
+    "",
+    "/**",
+    " * vitest configuration scaffolded by `@projitect/blueprint-vitest`.",
+    " *",
+    " * Owned mode — projitect rewrites this file on every `pjt remodel`. If you need overrides,",
+    " * compose another `ownFile` blueprint at a different path (e.g. `vitest.config.local.ts`)",
+    " * and merge it into this config via vitest's own `mergeConfig` helper at runtime.",
+    " */",
+    "export default defineConfig({",
+    "  test: {",
+    `    environment: "${params.environment}",`,
+    "    passWithNoTests: true,",
+  ]
+
+  if (params.coverage === "v8") {
+    lines.push(
+      "    coverage: {",
+      '      provider: "v8",',
+      '      reporter: ["text", "html"],',
+      "    },",
+    )
+  }
+
+  lines.push("  },", "})", "")
+  return lines.join("\n")
+}

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.