@k8o/create 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) k8o
+
+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/README.md

@@ -0,0 +1,72 @@
+# @k8o/create
+
+k8o's project generator for [Vite+](https://viteplus.dev). One command spins up
+a new repo with the conventions already wired in — supply-chain rules, oxlint /
+oxfmt via [`@k8o/oxc-config`](https://github.com/k35o/oxc-config), Changesets,
+GitHub Actions CI/release, mise, and Renovate.
+
+## Usage
+
+```sh
+vp create @k8o          # interactive: pick library / web, enter a name
+vp create @k8o -- --kind library --name @k8o/foo --description "..."
+vp create @k8o -- --kind web --name @k8o/foo
+```
+
+`vp create @k8o` resolves this package (`@k8o/create`) and runs its generator.
+
+## Kinds
+
+| `--kind`  | Emits                                                                            |
+| --------- | -------------------------------------------------------------------------------- |
+| `library` | Single-package library: `src` + `tests`, `vp pack` → ESM + `.d.mts`.             |
+| `web`     | Monorepo: `packages/<name>` React lib + `apps/playground`, on @k8o/arte-odyssey. |
+
+Both generated repos pass `check` (fmt + lint + types), `test`, and `build`
+out of the box.
+
+### What every generated repo gets
+
+- **Supply-chain rules** — `pnpm-workspace.yaml` with `blockExoticSubdeps`,
+  `minimumReleaseAge`, `strictDepBuilds`, `verifyDepsBeforeRun`, `saveExact`,
+  `autoInstallPeers: false`.
+- **Lint / format** — `@k8o/oxc-config` presets via `vp check`.
+- **Versioning** — Changesets + a `release.yml` that publishes to npm with
+  provenance using the `K35O_BOT` GitHub App.
+- **CI** — `ci.yml` (lint / types / tests / changeset) on a composite
+  mise-based install action.
+- **Toolchain** — pinned `mise.toml`, `renovate.json` extending
+  `github>k35o/renovate-config`.
+
+## Layout
+
+```
+bin/index.ts       # Bingo runTemplateCLI entry
+src/
+  template.ts      # createTemplate: { kind, name, description } → dispatch
+  library.ts       # produceLibrary()
+  web.ts           # produceWeb()
+  shared.ts        # base files shared by both kinds (single source)
+tests/produce.test.ts
+```
+
+Each kind is built by a `produce()` that returns the file tree. The shared base
+files (security config, CI, license, mise, …) live once in `src/shared.ts` and
+are imported by both — change a convention in one place and both kinds follow.
+
+## Adding a kind
+
+Add a value to the `kind` enum in [`src/template.ts`](src/template.ts), write a
+`produce*()` in a new `src/<kind>.ts` reusing `src/shared.ts`, and dispatch to
+it. No new package to publish.
+
+## Develop
+
+```sh
+pnpm install
+pnpm check       # fmt + lint
+pnpm typecheck
+pnpm test        # generator smoke tests
+pnpm dev -- --kind library --name @k8o/scratch --directory /tmp/scratch --offline
+pnpm changeset   # describe a change before merging
+```

package/bin/index.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+
+import { runTemplateCLI } from 'bingo';
+
+import template from '../src/template.ts';
+
+process.exitCode = await runTemplateCLI(template);

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@k8o/create",
+  "version": "0.1.0",
+  "description": "k8o's Vite+ project generator — run `vp create @k8o`.",
+  "keywords": [
+    "bingo-template",
+    "create",
+    "k8o",
+    "template",
+    "vite-plus-generator"
+  ],
+  "homepage": "https://github.com/k35o/templates#readme",
+  "bugs": "https://github.com/k35o/templates/issues",
+  "license": "MIT",
+  "author": "k8o (https://github.com/k35o)",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/k35o/templates.git"
+  },
+  "files": [
+    "bin",
+    "src",
+    "README.md",
+    "LICENSE"
+  ],
+  "type": "module",
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "dependencies": {
+    "bingo": "0.7.0",
+    "zod": "3.25.76"
+  },
+  "devDependencies": {
+    "@changesets/changelog-github": "0.7.0",
+    "@changesets/cli": "2.31.0",
+    "@k8o/oxc-config": "0.1.3",
+    "@types/node": "24.12.4",
+    "typescript": "6.0.3",
+    "vite-plus": "0.1.23"
+  },
+  "engines": {
+    "node": ">=24.13.0"
+  },
+  "scripts": {
+    "test": "vp test",
+    "dev": "node bin/index.ts",
+    "check": "vp check",
+    "check:write": "vp check --fix",
+    "typecheck": "tsc --noEmit",
+    "changeset": "changeset",
+    "version": "changeset version",
+    "release": "changeset publish",
+    "ready": "vp fmt && vp lint && vp test"
+  },
+  "bin": {
+    "create": "./bin/index.ts"
+  }
+}

package/src/library.ts

@@ -0,0 +1,328 @@
+import {
+  changesetConfig,
+  CHANGESET_README,
+  coords,
+  type GenerateOptions,
+  GITIGNORE,
+  INSTALL_ACTION,
+  LICENSE,
+  MISE_TOML,
+  NPMRC,
+  RELEASE_YML,
+} from './shared.ts';
+
+// Single-package repo: pnpm-workspace.yaml carries the supply-chain rules only.
+const PNPM_WORKSPACE = `blockExoticSubdeps: true
+
+minimumReleaseAge: 10080
+minimumReleaseAgeExclude:
+  - '@k8o/*'
+
+strictDepBuilds: true
+
+allowBuilds:
+  esbuild: false
+
+verifyDepsBeforeRun: install
+
+saveExact: true
+autoInstallPeers: false
+`;
+
+const TSCONFIG = `{
+  "compilerOptions": {
+    "target": "ESNext",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "moduleDetection": "force",
+    "customConditions": ["source"],
+    "lib": ["ES2023"],
+    "strict": true,
+    "noUncheckedIndexedAccess": true,
+    "exactOptionalPropertyTypes": true,
+    "noImplicitOverride": true,
+    "noImplicitReturns": true,
+    "noFallthroughCasesInSwitch": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "allowImportingTsExtensions": true,
+    "isolatedModules": true,
+    "verbatimModuleSyntax": true,
+    "skipLibCheck": true,
+    "declaration": true,
+    "noEmit": true,
+    "resolveJsonModule": true,
+    "esModuleInterop": true,
+    "forceConsistentCasingInFileNames": true,
+    "types": ["node", "vite-plus/test/globals"]
+  },
+  "include": ["src/**/*", "tests/**/*", "vite.config.ts"]
+}
+`;
+
+const VITE_CONFIG = `import { fmt, test, typescript } from '@k8o/oxc-config';
+import { defineConfig } from 'vite-plus';
+
+export default defineConfig({
+  fmt: {
+    ...fmt,
+    ignorePatterns: ['CHANGELOG.md'],
+  },
+  lint: {
+    extends: [typescript],
+    ignorePatterns: ['CHANGELOG.md'],
+    options: {
+      typeAware: true,
+    },
+    overrides: [
+      {
+        files: ['tests/**/*.test.ts'],
+        plugins: [...(test.plugins ?? [])],
+        rules: test.rules ?? {},
+      },
+    ],
+  },
+  pack: {
+    entry: ['src/index.ts'],
+    format: 'esm',
+    dts: true,
+    outDir: 'dist',
+    unbundle: true,
+  },
+  test: {
+    globals: true,
+    include: ['tests/**/*.test.ts'],
+  },
+  staged: {
+    '*.{js,ts,cjs,mjs,jsx,tsx,json,jsonc}': 'vp check --fix',
+  },
+});
+`;
+
+const CI_YML = `name: CI
+
+on:
+  pull_request:
+
+permissions:
+  contents: read
+
+jobs:
+  check:
+    name: Lint / Format / Types
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - name: Checkout branch
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+        with:
+          persist-credentials: false
+
+      - name: Install
+        uses: ./.github/composite-actions/install
+
+      - name: Build
+        run: pnpm build
+
+      - name: Run check (fmt + lint + typecheck)
+        run: pnpm check
+
+  tests:
+    name: Tests
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - name: Checkout branch
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+        with:
+          persist-credentials: false
+
+      - name: Install
+        uses: ./.github/composite-actions/install
+
+      - name: Run tests
+        run: pnpm test
+
+  changeset:
+    name: Changeset
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - name: Checkout branch
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+        with:
+          fetch-depth: 0
+          persist-credentials: false
+
+      - name: Install
+        uses: ./.github/composite-actions/install
+
+      - name: Verify a changeset is present
+        run: pnpm exec changeset status --since=origin/main
+`;
+
+const RENOVATE = `{
+  "$schema": "https://docs.renovatebot.com/renovate-schema.json",
+  "extends": ["github>k35o/renovate-config"],
+  "mise": {
+    "enabled": true,
+    "managerFilePatterns": ["/^mise\\\\.toml$/"]
+  },
+  "prConcurrentLimit": 10,
+  "packageRules": [
+    {
+      "matchPackageNames": ["/^@changesets/"],
+      "groupName": "changesets dependencies"
+    },
+    {
+      "matchPackageNames": ["/^pnpm$/"],
+      "groupName": "pnpm dependencies"
+    },
+    {
+      "matchPackageNames": ["/^node$/"],
+      "groupName": "node dependencies"
+    },
+    {
+      "matchPackageNames": ["changesets/action"],
+      "enabled": false
+    }
+  ]
+}
+`;
+
+const SRC_INDEX = `export const hello = (name: string): string => \`Hello, \${name}!\`;
+`;
+
+const TEST_INDEX = `import { hello } from '../src/index.ts';
+
+test('hello greets by name', () => {
+  expect(hello('world')).toBe('Hello, world!');
+});
+`;
+
+export const produceLibrary = (options: GenerateOptions) => {
+  const { repo } = coords(options.name);
+  const description = options.description ?? '';
+
+  const packageJson = {
+    name: options.name,
+    version: '0.0.0',
+    description,
+    keywords: [] as string[],
+    homepage: `https://github.com/${repo}#readme`,
+    bugs: `https://github.com/${repo}/issues`,
+    license: 'MIT',
+    author: 'k8o (https://github.com/k35o)',
+    repository: {
+      type: 'git',
+      url: `git+https://github.com/${repo}.git`,
+    },
+    files: ['dist', 'README.md', 'LICENSE', 'CHANGELOG.md'],
+    type: 'module',
+    sideEffects: false,
+    exports: {
+      '.': {
+        import: {
+          types: './dist/index.d.mts',
+          default: './dist/index.mjs',
+        },
+      },
+      './package.json': './package.json',
+    },
+    publishConfig: {
+      access: 'public',
+      provenance: true,
+    },
+    scripts: {
+      build: 'vp pack',
+      test: 'vp test',
+      lint: 'vp lint',
+      fmt: 'vp fmt',
+      check: 'vp check',
+      'check:write': 'vp check --fix',
+      typecheck: 'tsc --noEmit',
+      changeset: 'changeset',
+      version: 'changeset version',
+      release: 'pnpm build && changeset publish',
+      prepublishOnly: 'pnpm build',
+    },
+    devDependencies: {
+      '@changesets/changelog-github': '0.7.0',
+      '@changesets/cli': '2.31.0',
+      '@k8o/oxc-config': '0.1.3',
+      '@types/node': '24.12.4',
+      typescript: '6.0.3',
+      'vite-plus': '0.1.23',
+    },
+    engines: {
+      node: '>=24.13.0',
+    },
+    packageManager: 'pnpm@11.5.1',
+  };
+
+  const readme = `# ${options.name}
+
+${description}
+
+## Install
+
+\`\`\`sh
+pnpm add ${options.name}
+\`\`\`
+
+## Develop
+
+\`\`\`sh
+pnpm install
+pnpm check     # fmt + lint + typecheck
+pnpm test
+pnpm build     # vp pack -> dist/
+\`\`\`
+
+## Release
+
+Versioned and published with [Changesets](https://github.com/changesets/changesets).
+
+\`\`\`sh
+pnpm changeset   # describe the change
+\`\`\`
+
+Merging to \`main\` lets the release workflow open a version PR and publish to npm.
+`;
+
+  return {
+    files: {
+      'package.json': `${JSON.stringify(packageJson, null, 2)}\n`,
+      'pnpm-workspace.yaml': PNPM_WORKSPACE,
+      '.npmrc': NPMRC,
+      '.gitignore': GITIGNORE,
+      'mise.toml': MISE_TOML,
+      'tsconfig.json': TSCONFIG,
+      'vite.config.ts': VITE_CONFIG,
+      'renovate.json': RENOVATE,
+      LICENSE,
+      'README.md': readme,
+      '.changeset': {
+        'config.json': changesetConfig(repo),
+        'README.md': CHANGESET_README,
+      },
+      '.github': {
+        'composite-actions': {
+          install: {
+            'action.yml': INSTALL_ACTION,
+          },
+        },
+        workflows: {
+          'ci.yml': CI_YML,
+          'release.yml': RELEASE_YML,
+        },
+      },
+      src: {
+        'index.ts': SRC_INDEX,
+      },
+      tests: {
+        'index.test.ts': TEST_INDEX,
+      },
+    },
+  };
+};

package/src/shared.ts

@@ -0,0 +1,149 @@
+// ---------------------------------------------------------------------------
+// Shared k8o base files — identical across the `library` and `web` templates.
+// Template-specific files (pnpm-workspace, tsconfig, vite.config, CI, renovate)
+// live in ./library.ts and ./web.ts.
+// ---------------------------------------------------------------------------
+
+export type GenerateOptions = {
+  name: string;
+  description?: string | undefined;
+};
+
+/** Derive repo coordinates from a (possibly scoped) package name. */
+export const coords = (name: string): { bare: string; repo: string } => {
+  if (!/^(?:@[a-z0-9][a-z0-9._-]*\/)?[a-z0-9][a-z0-9._-]*$/u.test(name)) {
+    throw new Error(
+      `Invalid package name "${name}" — expected an (optionally @scoped) npm package name.`,
+    );
+  }
+  const bare = name.replace(/^@[^/]+\//u, '');
+  return { bare, repo: `k35o/${bare}` };
+};
+
+export const NPMRC = `registry=https://registry.npmjs.org/
+@k8o:registry=https://registry.npmjs.org/
+
+engine-strict=true
+`;
+
+export const GITIGNORE = `node_modules
+dist
+coverage
+*.log
+.DS_Store
+*.tsbuildinfo
+.env*
+*.local
+.vscode/*
+!.vscode/extensions.json
+settings.local.json
+`;
+
+export const MISE_TOML = `[tools]
+node = "24.16.0"
+pnpm = "11.5.1"
+`;
+
+export const INSTALL_ACTION = `name: Install
+description: Sets up mise and runs install
+
+runs:
+  using: composite
+  steps:
+    - name: Setup mise
+      uses: jdx/mise-action@1648a7812b9aeae629881980618f079932869151 # v4.0.1
+      with:
+        cache: true
+
+    - name: Install dependencies
+      shell: bash
+      run: pnpm install --frozen-lockfile
+`;
+
+export const RELEASE_YML = `name: Release
+
+on:
+  push:
+    branches:
+      - main
+
+concurrency:
+  group: \${{ github.workflow }}-\${{ github.ref }}
+
+permissions:
+  contents: write
+  id-token: write
+  pull-requests: write
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Generate token
+        id: generate-token
+        uses: actions/create-github-app-token@1b10c78c7865c340bc4f6099eb2f838309f1e8c3 # v3.1.1
+        with:
+          client-id: \${{ secrets.K35O_BOT_CLIENT_ID }}
+          private-key: \${{ secrets.K35O_BOT_PRIVATE_KEY }}
+
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+        with:
+          fetch-depth: 0
+          token: \${{ steps.generate-token.outputs.token }}
+
+      - name: Install
+        uses: ./.github/composite-actions/install
+
+      - name: Install latest npm
+        run: npm install -g npm@latest
+
+      - name: Create release Pull Request or publish to NPM
+        uses: changesets/action@6a0a831ff30acef54f2c6aa1cbbc1096b066edaf # v1.7.0
+        with:
+          publish: pnpm release
+        env:
+          GITHUB_TOKEN: \${{ steps.generate-token.outputs.token }}
+`;
+
+export const CHANGESET_README = `# Changesets
+
+Hello and welcome! This folder has been automatically generated by \`@changesets/cli\`, a build tool that works with multi-package repos, or single-package repos to help you version and publish your code. You can find the full documentation for it [in our repository](https://github.com/changesets/changesets).
+
+We have a quick list of common questions to get you started engaging with this project in [our documentation](https://github.com/changesets/changesets/blob/main/docs/common-questions.md).
+`;
+
+export const LICENSE = `MIT License
+
+Copyright (c) k8o
+
+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.
+`;
+
+export const changesetConfig = (repo: string): string => `{
+  "$schema": "https://unpkg.com/@changesets/config@3.1.1/schema.json",
+  "changelog": ["@changesets/changelog-github", { "repo": "${repo}" }],
+  "commit": false,
+  "fixed": [],
+  "linked": [],
+  "access": "public",
+  "baseBranch": "main",
+  "updateInternalDependencies": "patch",
+  "ignore": []
+}
+`;

package/src/template.ts

@@ -0,0 +1,33 @@
+import { createTemplate } from 'bingo';
+import { z } from 'zod';
+
+import pkgJson from '../package.json' with { type: 'json' };
+import { produceLibrary } from './library.ts';
+import { produceWeb } from './web.ts';
+
+export default createTemplate({
+  about: {
+    name: pkgJson.name,
+    description: pkgJson.description,
+  },
+
+  options: {
+    kind: z
+      .enum(['library', 'web'])
+      .describe('What to scaffold: a library or a web (React) package'),
+    name: z
+      .string()
+      .regex(
+        /^(?:@[a-z0-9][a-z0-9._-]*\/)?[a-z0-9][a-z0-9._-]*$/u,
+        'Must be a valid (optionally @scoped) npm package name',
+      )
+      .describe('Package name, e.g. @k8o/foo'),
+    description: z.string().optional().describe('One-line package description'),
+  },
+
+  produce({ options }) {
+    return options.kind === 'web'
+      ? produceWeb(options)
+      : produceLibrary(options);
+  },
+});

package/src/web.ts

@@ -0,0 +1,585 @@
+import {
+  changesetConfig,
+  CHANGESET_README,
+  coords,
+  type GenerateOptions,
+  GITIGNORE,
+  INSTALL_ACTION,
+  LICENSE,
+  MISE_TOML,
+  NPMRC,
+  RELEASE_YML,
+} from './shared.ts';
+
+const COMMITLINT = `export default { extends: ['@commitlint/config-conventional'] };
+`;
+
+// Monorepo: packages/* (publishable libs) + apps/* (private apps/examples).
+const PNPM_WORKSPACE = `packages:
+  - packages/*
+  - apps/*
+
+blockExoticSubdeps: true
+
+minimumReleaseAge: 10080
+minimumReleaseAgeExclude:
+  - '@k8o/*'
+
+strictDepBuilds: true
+
+allowBuilds:
+  esbuild: false
+
+verifyDepsBeforeRun: install
+
+saveExact: true
+autoInstallPeers: false
+
+catalog:
+  '@changesets/changelog-github': 0.7.0
+  '@changesets/cli': 2.31.0
+  '@commitlint/cli': 21.0.2
+  '@commitlint/config-conventional': 21.0.2
+  '@k8o/arte-odyssey': 10.1.0
+  '@k8o/oxc-config': 0.1.3
+  '@tailwindcss/vite': 4.3.0
+  '@types/node': 24.12.4
+  '@types/react': 19.2.15
+  '@types/react-dom': 19.2.3
+  '@vitejs/plugin-react': 6.0.2
+  react: 19.2.6
+  react-dom: 19.2.6
+  tailwindcss: 4.3.0
+  typescript: 6.0.3
+  vite: 8.0.14
+  vite-plus: 0.1.23
+`;
+
+// Root tsconfig for a React monorepo (DOM + JSX). Package tsconfigs extend it.
+const TSCONFIG = `{
+  "compilerOptions": {
+    "target": "ESNext",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "moduleDetection": "force",
+    "customConditions": ["source"],
+    "lib": ["DOM", "DOM.Iterable", "ESNext"],
+    "jsx": "react-jsx",
+    "strict": true,
+    "noUncheckedIndexedAccess": true,
+    "exactOptionalPropertyTypes": true,
+    "noImplicitOverride": true,
+    "noImplicitReturns": true,
+    "noFallthroughCasesInSwitch": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "allowImportingTsExtensions": true,
+    "isolatedModules": true,
+    "verbatimModuleSyntax": true,
+    "skipLibCheck": true,
+    "declaration": true,
+    "noEmit": true,
+    "resolveJsonModule": true,
+    "esModuleInterop": true,
+    "forceConsistentCasingInFileNames": true,
+    "types": ["node", "vite-plus/test/globals"]
+  }
+}
+`;
+
+// Root config drives fmt + lint for the whole monorepo.
+const ROOT_VITE_CONFIG = `import { fmt, react, test } from '@k8o/oxc-config';
+import { defineConfig } from 'vite-plus';
+
+export default defineConfig({
+  fmt: {
+    ...fmt,
+    ignorePatterns: ['CHANGELOG.md', '**/CHANGELOG.md'],
+  },
+  lint: {
+    extends: [react],
+    ignorePatterns: ['CHANGELOG.md', '**/CHANGELOG.md'],
+    options: {
+      typeAware: true,
+    },
+    settings: {
+      react: { version: '19.2.6' },
+    },
+    overrides: [
+      {
+        files: ['**/*.test.{ts,tsx}'],
+        plugins: [...(test.plugins ?? [])],
+        rules: test.rules ?? {},
+      },
+    ],
+  },
+  staged: {
+    '*.{js,ts,cjs,mjs,jsx,tsx,json,jsonc}': 'vp check --fix',
+  },
+});
+`;
+
+const CI_YML = `name: CI
+
+on:
+  pull_request:
+
+permissions:
+  contents: read
+
+jobs:
+  check:
+    name: Build / Lint / Types
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - name: Checkout branch
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+        with:
+          persist-credentials: false
+
+      - name: Install
+        uses: ./.github/composite-actions/install
+
+      - name: Build
+        run: pnpm build
+
+      - name: Run check (fmt + lint)
+        run: pnpm check
+
+      - name: Typecheck
+        run: pnpm typecheck
+
+  tests:
+    name: Tests
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - name: Checkout branch
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+        with:
+          persist-credentials: false
+
+      - name: Install
+        uses: ./.github/composite-actions/install
+
+      - name: Run tests
+        run: pnpm test
+
+  changeset:
+    name: Changeset
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - name: Checkout branch
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+        with:
+          fetch-depth: 0
+          persist-credentials: false
+
+      - name: Install
+        uses: ./.github/composite-actions/install
+
+      - name: Verify a changeset is present
+        run: pnpm exec changeset status --since=origin/main
+`;
+
+const RENOVATE = `{
+  "$schema": "https://docs.renovatebot.com/renovate-schema.json",
+  "extends": ["github>k35o/renovate-config"],
+  "mise": {
+    "enabled": true,
+    "managerFilePatterns": ["/^mise\\\\.toml$/"]
+  },
+  "prConcurrentLimit": 10,
+  "packageRules": [
+    {
+      "matchPackageNames": ["react", "react-dom", "/^@types/react/"],
+      "groupName": "react dependencies"
+    },
+    {
+      "matchPackageNames": ["/tailwind/"],
+      "groupName": "tailwind dependencies"
+    },
+    {
+      "matchPackageNames": ["/^@changesets/"],
+      "groupName": "changesets dependencies"
+    },
+    {
+      "matchPackageNames": ["/^@commitlint/"],
+      "groupName": "commitlint dependencies"
+    },
+    {
+      "matchPackageNames": ["/^pnpm$/"],
+      "groupName": "pnpm dependencies"
+    },
+    {
+      "matchPackageNames": ["/^node$/"],
+      "groupName": "node dependencies"
+    },
+    {
+      "matchPackageNames": ["changesets/action"],
+      "enabled": false
+    },
+    {
+      "matchDepTypes": ["peerDependencies"],
+      "enabled": false
+    }
+  ]
+}
+`;
+
+// --- packages/<pkg> : publishable React component library --------------------
+
+const PKG_TSCONFIG = `{
+  "extends": "../../tsconfig.json",
+  "include": ["src/**/*.ts", "src/**/*.tsx", "vite.config.ts"]
+}
+`;
+
+const PKG_VITE_CONFIG = `import react from '@vitejs/plugin-react';
+import { defineConfig } from 'vite-plus';
+
+export default defineConfig({
+  plugins: [react()],
+  pack: {
+    entry: ['src/**/*.{ts,tsx}', '!src/**/*.test.{ts,tsx}'],
+    format: 'esm',
+    dts: true,
+    outDir: 'dist',
+    unbundle: true,
+  },
+  test: {
+    globals: true,
+    include: ['src/**/*.test.{ts,tsx}'],
+  },
+  staged: {
+    '*': 'vp check --fix',
+  },
+});
+`;
+
+const PKG_CN = `export const cn = (
+  ...classes: Array<string | false | null | undefined>
+): string => classes.filter(Boolean).join(' ');
+`;
+
+const PKG_CN_TEST = `import { cn } from './cn.ts';
+
+test('cn joins truthy class names', () => {
+  expect(cn('a', false, 'b', null, undefined, 'c')).toBe('a b c');
+});
+`;
+
+const PKG_HELLO = `import { Button } from '@k8o/arte-odyssey';
+import type { FC } from 'react';
+
+export type HelloProps = {
+  /** Who to greet. */
+  name: string;
+};
+
+/**
+ * Sample component wrapping @k8o/arte-odyssey's Button.
+ * Render it inside <ArteOdysseyProvider> (see apps/playground).
+ */
+export const Hello: FC<HelloProps> = ({ name }) => (
+  <Button>Hello, {name}!</Button>
+);
+`;
+
+const PKG_INDEX = `export { cn } from './helpers/cn.ts';
+export { Hello } from './components/hello.tsx';
+export type { HelloProps } from './components/hello.tsx';
+`;
+
+// --- apps/playground : private Vite + React app using arte-odyssey -----------
+
+const APP_TSCONFIG = `{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "types": ["node", "vite/client"]
+  },
+  "include": ["src/**/*.ts", "src/**/*.tsx", "vite.config.ts"]
+}
+`;
+
+const APP_VITE_CONFIG = `import tailwindcss from '@tailwindcss/vite';
+import react from '@vitejs/plugin-react';
+import { defineConfig } from 'vite';
+
+export default defineConfig({
+  plugins: [react(), tailwindcss()],
+});
+`;
+
+const APP_INDEX_HTML = `<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>playground</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>
+`;
+
+const APP_MAIN = `import { StrictMode } from 'react';
+import { createRoot } from 'react-dom/client';
+
+import { App } from './app.tsx';
+
+import './styles.css';
+
+const root = document.querySelector('#root');
+if (root) {
+  createRoot(root).render(
+    <StrictMode>
+      <App />
+    </StrictMode>,
+  );
+}
+`;
+
+// The playground demonstrates the @k8o/arte-odyssey stack (provider + tailwind).
+// To preview your own package here, add it as a `workspace:*` dependency and
+// import it — its `source` export condition resolves to TS source in dev.
+const APP_APP = `import { ArteOdysseyProvider, Button } from '@k8o/arte-odyssey';
+
+export const App = () => (
+  <ArteOdysseyProvider>
+    <main className="grid min-h-dvh place-items-center gap-4 p-8">
+      <h1 className="text-2xl font-bold">@PKG_NAME@ playground</h1>
+      <Button>Hello, world!</Button>
+    </main>
+  </ArteOdysseyProvider>
+);
+`;
+
+const APP_STYLES = `@import 'tailwindcss';
+@import '@k8o/arte-odyssey/styles.css';
+`;
+
+const APP_VITE_ENV = `/// <reference types="vite/client" />
+`;
+
+export const produceWeb = (options: GenerateOptions) => {
+  const { bare, repo } = coords(options.name);
+  const description = options.description ?? '';
+
+  const rootPackageJson = {
+    name: bare,
+    version: '0.0.0',
+    private: true,
+    description,
+    license: 'MIT',
+    author: 'k8o (https://github.com/k35o)',
+    repository: {
+      type: 'git',
+      url: `git+https://github.com/${repo}.git`,
+    },
+    type: 'module',
+    scripts: {
+      build: "vp run --filter './packages/*' --filter './apps/*' build",
+      dev: 'vp run --filter ./apps/playground dev',
+      test: 'vp run -r test',
+      typecheck: 'vp run -r typecheck',
+      check: 'vp check',
+      'check:write': 'vp check --fix',
+      changeset: 'changeset',
+      version: 'changeset version',
+      release: 'pnpm build && changeset publish',
+      ready: 'vp fmt && vp lint && vp run -r test',
+    },
+    devDependencies: {
+      '@changesets/changelog-github': 'catalog:',
+      '@changesets/cli': 'catalog:',
+      '@commitlint/cli': 'catalog:',
+      '@commitlint/config-conventional': 'catalog:',
+      '@k8o/oxc-config': 'catalog:',
+      '@types/node': 'catalog:',
+      typescript: 'catalog:',
+      'vite-plus': 'catalog:',
+    },
+    engines: {
+      node: '>=24.13.0',
+    },
+    packageManager: 'pnpm@11.5.1',
+  };
+
+  const libPackageJson = {
+    name: options.name,
+    version: '0.0.0',
+    description,
+    keywords: [] as string[],
+    homepage: `https://github.com/${repo}#readme`,
+    bugs: `https://github.com/${repo}/issues`,
+    license: 'MIT',
+    author: 'k8o (https://github.com/k35o)',
+    repository: {
+      type: 'git',
+      url: `git+https://github.com/${repo}.git`,
+      directory: `packages/${bare}`,
+    },
+    files: ['dist'],
+    type: 'module',
+    sideEffects: false,
+    exports: {
+      '.': {
+        source: './src/index.ts',
+        import: {
+          types: './dist/index.d.mts',
+          default: './dist/index.mjs',
+        },
+      },
+      './package.json': './package.json',
+    },
+    publishConfig: {
+      access: 'public',
+      provenance: true,
+    },
+    scripts: {
+      build: 'vp pack',
+      test: 'vp test',
+      typecheck: 'tsc --noEmit',
+      check: 'vp check',
+      'check:write': 'vp check --fix',
+    },
+    devDependencies: {
+      '@k8o/arte-odyssey': 'catalog:',
+      '@types/react': 'catalog:',
+      '@types/react-dom': 'catalog:',
+      '@vitejs/plugin-react': 'catalog:',
+      react: 'catalog:',
+      'react-dom': 'catalog:',
+      'vite-plus': 'catalog:',
+    },
+    peerDependencies: {
+      '@k8o/arte-odyssey': '>=10',
+      react: '>=19',
+      'react-dom': '>=19',
+    },
+  };
+
+  const appPackageJson = {
+    name: 'playground',
+    version: '0.0.0',
+    private: true,
+    type: 'module',
+    scripts: {
+      dev: 'vite',
+      build: 'vite build',
+      preview: 'vite preview',
+      typecheck: 'tsc --noEmit',
+    },
+    dependencies: {
+      '@k8o/arte-odyssey': 'catalog:',
+      react: 'catalog:',
+      'react-dom': 'catalog:',
+    },
+    devDependencies: {
+      '@tailwindcss/vite': 'catalog:',
+      '@types/react': 'catalog:',
+      '@types/react-dom': 'catalog:',
+      '@vitejs/plugin-react': 'catalog:',
+      tailwindcss: 'catalog:',
+      typescript: 'catalog:',
+      vite: 'catalog:',
+    },
+  };
+
+  const readme = `# ${bare}
+
+${description}
+
+A React component library built on [@k8o/arte-odyssey](https://github.com/k35o/arte-odyssey).
+
+## Layout
+
+\`\`\`
+packages/${bare}   # the publishable library (${options.name})
+apps/playground    # local Vite app to preview it
+\`\`\`
+
+## Develop
+
+\`\`\`sh
+pnpm install
+pnpm dev        # run the playground app
+pnpm check      # fmt + lint
+pnpm typecheck
+pnpm test
+pnpm build      # build every package and app
+\`\`\`
+
+## Release
+
+Versioned and published with [Changesets](https://github.com/changesets/changesets).
+Merging to \`main\` lets the release workflow open a version PR and publish to npm.
+`;
+
+  return {
+    files: {
+      'package.json': `${JSON.stringify(rootPackageJson, null, 2)}\n`,
+      'pnpm-workspace.yaml': PNPM_WORKSPACE,
+      '.npmrc': NPMRC,
+      '.gitignore': GITIGNORE,
+      'mise.toml': MISE_TOML,
+      'tsconfig.json': TSCONFIG,
+      'vite.config.ts': ROOT_VITE_CONFIG,
+      'commitlint.config.js': COMMITLINT,
+      'renovate.json': RENOVATE,
+      LICENSE,
+      'README.md': readme,
+      '.changeset': {
+        'config.json': changesetConfig(repo),
+        'README.md': CHANGESET_README,
+      },
+      '.github': {
+        'composite-actions': {
+          install: {
+            'action.yml': INSTALL_ACTION,
+          },
+        },
+        workflows: {
+          'ci.yml': CI_YML,
+          'release.yml': RELEASE_YML,
+        },
+      },
+      packages: {
+        [bare]: {
+          'package.json': `${JSON.stringify(libPackageJson, null, 2)}\n`,
+          'tsconfig.json': PKG_TSCONFIG,
+          'vite.config.ts': PKG_VITE_CONFIG,
+          src: {
+            'index.ts': PKG_INDEX,
+            components: {
+              'hello.tsx': PKG_HELLO,
+            },
+            helpers: {
+              'cn.ts': PKG_CN,
+              'cn.test.ts': PKG_CN_TEST,
+            },
+          },
+        },
+      },
+      apps: {
+        playground: {
+          'package.json': `${JSON.stringify(appPackageJson, null, 2)}\n`,
+          'tsconfig.json': APP_TSCONFIG,
+          'vite.config.ts': APP_VITE_CONFIG,
+          'index.html': APP_INDEX_HTML,
+          src: {
+            'main.tsx': APP_MAIN,
+            'app.tsx': APP_APP.replaceAll('@PKG_NAME@', options.name),
+            'styles.css': APP_STYLES,
+            'vite-env.d.ts': APP_VITE_ENV,
+          },
+        },
+      },
+    },
+  };
+};