create-bubbles 0.1.19 → 0.1.22

package/template-vp-react-shadcn/.agents/skills/vite-plus/evals.json

@@ -0,0 +1,182 @@
+{
+  "skill": "vite-plus",
+  "version": "0.1.0",
+  "evals": [
+    {
+      "id": "eval-001",
+      "description": "Skill triggers when user asks about Vite+ project setup",
+      "prompt": "How do I create a new React TypeScript project with Vite+?",
+      "type": "code",
+      "assertions": [
+        { "type": "contains", "value": "vp create" },
+        { "type": "contains", "value": "react" },
+        { "type": "code_valid", "language": "bash" }
+      ],
+      "source": "https://viteplus.dev/guide/create"
+    },
+    {
+      "id": "eval-002",
+      "description": "Skill triggers when user mentions vp CLI commands",
+      "prompt": "What does vp check do and how is it different from running lint and format separately?",
+      "type": "explanation",
+      "assertions": [
+        { "type": "contains", "value": "vp check" },
+        { "type": "contains", "value": "Oxlint" },
+        { "type": "contains", "value": "Oxfmt" }
+      ],
+      "source": "https://viteplus.dev/guide/check"
+    },
+    {
+      "id": "eval-003",
+      "description": "Skill triggers for migration questions",
+      "prompt": "I have an existing Vite project with Vitest. How do I migrate to Vite+?",
+      "type": "code",
+      "assertions": [
+        { "type": "contains", "value": "vp migrate" },
+        { "type": "contains", "value": "vp install" },
+        { "type": "code_valid", "language": "bash" }
+      ],
+      "source": "https://viteplus.dev/guide/migrate"
+    },
+    {
+      "id": "eval-004",
+      "description": "Agent produces correct unified config with lint and fmt blocks",
+      "prompt": "Set up Vite+ config with single quotes, type-aware linting, and ignore dist folder",
+      "type": "code",
+      "assertions": [
+        { "type": "contains", "value": "defineConfig" },
+        { "type": "contains", "value": "vite-plus" },
+        { "type": "contains", "value": "typeAware" },
+        { "type": "contains", "value": "singleQuote" },
+        { "type": "not_contains", "value": ".oxlintrc" },
+        { "type": "code_valid", "language": "js" }
+      ],
+      "source": "https://viteplus.dev/config/"
+    },
+    {
+      "id": "eval-005",
+      "description": "Agent correctly configures library packaging with tsdown",
+      "prompt": "Configure vp pack to build my library in both ESM and CJS with TypeScript declarations",
+      "type": "code",
+      "assertions": [
+        { "type": "contains", "value": "pack" },
+        { "type": "contains", "value": "dts" },
+        { "type": "contains", "value": "esm" },
+        { "type": "contains", "value": "cjs" },
+        { "type": "not_contains", "value": "tsdown.config" },
+        { "type": "code_valid", "language": "js" }
+      ],
+      "source": "https://viteplus.dev/guide/pack"
+    },
+    {
+      "id": "eval-006",
+      "description": "Agent sets up monorepo task with caching and dependencies",
+      "prompt": "Create a CI task in vite.config.ts that runs check, test, and build with caching enabled, and depends on a lint task",
+      "type": "code",
+      "assertions": [
+        { "type": "contains", "value": "run" },
+        { "type": "contains", "value": "tasks" },
+        { "type": "contains", "value": "dependsOn" },
+        { "type": "contains", "value": "cache" },
+        { "type": "contains", "value": "command" },
+        { "type": "code_valid", "language": "js" }
+      ],
+      "source": "https://viteplus.dev/config/run"
+    },
+    {
+      "id": "eval-007",
+      "description": "Agent runs monorepo builds across workspaces correctly",
+      "prompt": "How do I build all packages in my Vite+ monorepo in dependency order?",
+      "type": "code",
+      "assertions": [
+        { "type": "contains", "value": "vp run" },
+        { "type": "contains", "value": "-r" },
+        { "type": "code_valid", "language": "bash" }
+      ],
+      "source": "https://viteplus.dev/guide/run"
+    },
+    {
+      "id": "eval-008",
+      "description": "Agent configures test block in vite.config.ts not vitest.config.ts",
+      "prompt": "Set up Vitest in my Vite+ project with coverage reporting",
+      "type": "code",
+      "assertions": [
+        { "type": "contains", "value": "test" },
+        { "type": "contains", "value": "coverage" },
+        { "type": "contains", "value": "vite-plus" },
+        { "type": "not_contains", "value": "vitest.config" },
+        { "type": "code_valid", "language": "js" }
+      ],
+      "source": "https://viteplus.dev/config/test"
+    },
+    {
+      "id": "eval-009",
+      "description": "Agent handles vp test watch mode gotcha correctly",
+      "prompt": "Why does vp test exit immediately instead of watching for changes?",
+      "type": "explanation",
+      "assertions": [
+        { "type": "contains", "value": "vp test watch" },
+        { "type": "contains", "value": "single-run" }
+      ],
+      "source": "https://viteplus.dev/guide/test"
+    },
+    {
+      "id": "eval-010",
+      "description": "Agent handles vp build vs vp run build distinction",
+      "prompt": "I ran vp build but it's not running my custom build script from package.json",
+      "type": "explanation",
+      "assertions": [
+        { "type": "contains", "value": "vp run build" },
+        { "type": "contains", "value": "vp build" }
+      ],
+      "source": "https://viteplus.dev/guide/build"
+    },
+    {
+      "id": "eval-011",
+      "description": "Agent manages Node.js versions with vp env",
+      "prompt": "Pin my project to Node.js 22 using Vite+",
+      "type": "code",
+      "assertions": [
+        { "type": "contains", "value": "vp env pin" },
+        { "type": "contains", "value": ".node-version" },
+        { "type": "code_valid", "language": "bash" }
+      ],
+      "source": "https://viteplus.dev/guide/env"
+    },
+    {
+      "id": "eval-012",
+      "description": "Agent does not hallucinate vp commands that don't exist",
+      "prompt": "How do I deploy my Vite+ project?",
+      "type": "explanation",
+      "assertions": [
+        { "type": "not_contains", "value": "vp deploy" },
+        { "type": "not_contains", "value": "vp publish" }
+      ],
+      "source": "https://viteplus.dev/guide/"
+    },
+    {
+      "id": "eval-013",
+      "description": "Agent does not recommend separate Oxlint config files",
+      "prompt": "Should I create an .oxlintrc.json file for my Vite+ project?",
+      "type": "explanation",
+      "assertions": [
+        { "type": "contains", "value": "vite.config" },
+        { "type": "contains", "value": "lint" }
+      ],
+      "source": "https://viteplus.dev/config/lint"
+    },
+    {
+      "id": "eval-014",
+      "description": "Agent references config.md for detailed configuration questions",
+      "prompt": "What are all the task runner configuration options in Vite+?",
+      "type": "explanation",
+      "assertions": [
+        { "type": "contains", "value": "command" },
+        { "type": "contains", "value": "dependsOn" },
+        { "type": "contains", "value": "cache" },
+        { "type": "contains", "value": "env" }
+      ],
+      "source": "https://viteplus.dev/config/run"
+    }
+  ]
+}

package/template-vp-react-shadcn/.agents/skills/vite-plus/references/config.md

@@ -0,0 +1,162 @@
+<!-- Part of the Vite+ AbsolutelySkilled skill. Load this file when
+     working with vite.config.ts configuration blocks. -->
+
+# Vite+ Configuration Reference
+
+All configuration lives in `vite.config.ts` using `defineConfig` from `vite-plus`.
+Do not create separate config files for integrated tools.
+
+```typescript
+import { defineConfig } from 'vite-plus';
+
+export default defineConfig({
+  // Standard Vite sections (unchanged from Vite docs)
+  server: {},
+  build: {},
+  preview: {},
+
+  // Vite+ extensions (documented below)
+  lint: {},
+  fmt: {},
+  test: {},
+  run: {},
+  pack: {},
+  staged: {},
+});
+```
+
+---
+
+## lint (Oxlint)
+
+```typescript
+lint: {
+  ignorePatterns: ['dist/**'],       // Glob patterns to exclude
+  options: {
+    typeAware: true,                 // Enable type-aware rules
+    typeCheck: true,                 // Enable full type checking via tsgolint
+  },
+  rules: {
+    'no-console': ['error', { allow: ['error'] }],
+  },
+}
+```
+
+- `ignorePatterns` - `string[]` - file patterns excluded from linting
+- `options.typeAware` - `boolean` - activates rules requiring TypeScript type info
+- `options.typeCheck` - `boolean` - runs full type checking during linting
+- `rules` - `Record<string, RuleConfig>` - ESLint-compatible rule overrides
+
+Both `typeAware` and `typeCheck` are enabled by default in `vp create` and
+`vp migrate` projects. Keep them enabled for the full type-aware path in
+`vp lint` and `vp check`.
+
+Oxlint supports 600+ ESLint-compatible rules. For the full rule list, see the
+Oxlint documentation.
+
+---
+
+## fmt (Oxfmt)
+
+```typescript
+fmt: {
+  ignorePatterns: ['dist/**'],
+  singleQuote: true,
+  semi: true,
+  experimentalSortPackageJson: true,
+}
+```
+
+- `ignorePatterns` - `string[]` - file patterns excluded from formatting
+- `singleQuote` - `boolean` - use single quotes instead of double
+- `semi` - `boolean` - enforce semicolons
+- `experimentalSortPackageJson` - `boolean` - sort package.json keys
+
+Oxfmt has full Prettier compatibility. For the complete options list, see the
+Oxfmt documentation. Point editor formatter config to `./vite.config.ts` for
+consistent format-on-save.
+
+---
+
+## test (Vitest)
+
+```typescript
+test: {
+  include: ['src/**/*.test.ts'],
+  coverage: {
+    reporter: ['text', 'html'],
+  },
+}
+```
+
+Accepts all Vitest configuration options. Key difference: `vp test` defaults to
+single-run mode (not watch). Use `vp test watch` for watch mode.
+
+For the complete configuration reference, see the Vitest docs.
+
+---
+
+## run (Vite Task)
+
+### Top-level options
+
+```typescript
+run: {
+  enablePrePostScripts: true,    // Run preX/postX lifecycle hooks (workspace root only)
+  cache: {                       // Default: { scripts: false, tasks: true }
+    scripts: false,
+    tasks: true,
+  },
+  tasks: { /* see below */ },
+}
+```
+
+### Task definitions
+
+```typescript
+run: {
+  tasks: {
+    ci: {
+      command: 'vp check && vp test && vp build',
+      dependsOn: [],              // Prerequisite tasks. Cross-package: "pkg#task"
+      cache: true,                // Cache task output (default: true)
+      env: ['CI', 'NODE_ENV'],    // Env vars in cache fingerprint. Supports wildcards: 'VITE_*'
+      untrackedEnv: [],           // Env vars passed but excluded from cache key
+      input: [{ auto: true }],    // File tracking. Array of globs or { auto: boolean }
+      cwd: '.',                   // Working directory relative to package root
+    },
+  },
+}
+```
+
+Commands with `&&` are auto-split into independently cached sub-tasks.
+
+---
+
+## pack (tsdown)
+
+```typescript
+pack: {
+  dts: true,                     // Generate TypeScript declarations
+  format: ['esm', 'cjs'],       // Output formats
+  sourcemap: true,               // Generate source maps
+  // exe: true                   // Build standalone executable
+}
+```
+
+Accepts all tsdown configuration options. Do not use `tsdown.config.ts` with
+Vite+ - configure everything in the `pack` block.
+
+---
+
+## staged (pre-commit checks)
+
+```typescript
+staged: {
+  '*.{js,ts,tsx,vue,svelte}': 'vp check --fix',
+}
+```
+
+Maps file glob patterns to commands that run on staged files before commit.
+Used by `vp staged` for pre-commit hooks. Enable hooks during project creation
+with `vp create --hooks`.

package/template-vp-react-shadcn/.agents/skills/vite-plus/references/env-management.md

@@ -0,0 +1,76 @@
+<!-- Part of the Vite+ AbsolutelySkilled skill. Load this file when
+     working with Node.js version management or vp env commands. -->
+
+# Vite+ Environment & Runtime Management
+
+Vite+ manages Node.js versions globally and per-project through `vp env`.
+Managed runtimes are stored in `~/.vite-plus` (override with `VITE_PLUS_HOME`).
+
+---
+
+## Operating modes
+
+### Managed mode (default)
+
+Shims always resolve to Vite+-managed Node.js. Enable with `vp env on`.
+
+### System-first mode
+
+Prioritizes system Node.js, falls back to Vite+-managed runtime. Enable with
+`vp env off`. Useful when you need to use a system-installed Node.js for
+specific projects or environments.
+
+---
+
+## Command reference
+
+### Setup
+
+| Command | Purpose |
+|---|---|
+| `vp env setup` | Create shims in `VITE_PLUS_HOME/bin` |
+| `vp env on` | Switch to managed mode |
+| `vp env off` | Switch to system-first mode |
+| `vp env print` | Output shell configuration snippet |
+
+### Version management
+
+| Command | Purpose |
+|---|---|
+| `vp env pin <version>` | Lock project to Node.js version (writes `.node-version`) |
+| `vp env unpin` | Remove version pin |
+| `vp env default <version>` | Set global default Node.js version |
+| `vp env use <version>` | Apply version for current shell session only |
+| `vp env install <version>` | Download and install a Node.js version |
+| `vp env uninstall <version>` | Remove an installed Node.js version |
+| `vp env exec <version> -- <cmd>` | Run a command with a specific Node.js version |
+
+### Inspection
+
+| Command | Purpose |
+|---|---|
+| `vp env current` | Display resolved environment (Node version, package manager) |
+| `vp env which <tool>` | Show tool path resolution |
+| `vp env list` | List installed Node.js versions |
+| `vp env list-remote` | List available Node.js versions for download |
+| `vp env doctor` | Run environment diagnostics |
+
+---
+
+## Project workflow
+
+1. Pin the Node.js version: `vp env pin 22`
+2. This writes a `.node-version` file to the project root
+3. All `vp` commands (`vp install`, `vp dev`, `vp build`) automatically use
+   the pinned version
+4. Team members running `vp env install` will get the correct version
+
+---
+
+## Toolchain management
+
+| Command | Purpose |
+|---|---|
+| `vp upgrade` | Update the Vite+ toolchain to latest |
+| `vp implode` | Complete removal of Vite+ and all managed runtimes |
+| `vpx <pkg>` / `vp dlx <pkg>` | Execute a package binary without installing globally |

package/template-vp-react-shadcn/.agents/skills/vite-plus/references/task-runner.md

@@ -0,0 +1,152 @@
+<!-- Part of the Vite+ AbsolutelySkilled skill. Load this file when
+     working with vp run, monorepo tasks, or task caching. -->
+
+# Vite+ Task Runner (Vite Task)
+
+`vp run` executes `package.json` scripts and tasks defined in `vite.config.ts`.
+It provides built-in caching, dependency ordering, and workspace-aware execution.
+
+---
+
+## Basic usage
+
+```bash
+vp run <script>           # Run a package.json script
+vp run <task>             # Run a vite.config.ts task
+vp run build -v           # Verbose output with cache stats
+vp run --last-details     # View previous run's summary
+```
+
+---
+
+## Caching behavior
+
+| Source | Default caching |
+|---|---|
+| `package.json` scripts | Not cached (use `--cache` to enable) |
+| `vite.config.ts` tasks | Cached by default |
+
+The cache system tracks file modifications and replays cached output when
+inputs haven't changed. Commands with `&&` are auto-split into independently
+cached sub-tasks.
+
+### Cache configuration
+
+```typescript
+run: {
+  cache: {
+    scripts: false,    // Cache package.json scripts
+    tasks: true,       // Cache vite.config.ts tasks
+  },
+}
+```
+
+Or use a boolean to set both: `cache: true`.
+
+### Per-task cache control
+
+```typescript
+run: {
+  tasks: {
+    build: {
+      command: 'vp build',
+      cache: true,
+      env: ['NODE_ENV', 'VITE_*'],    // Include in cache fingerprint
+      untrackedEnv: ['HOME'],          // Pass but exclude from fingerprint
+      input: [{ auto: true }],         // File tracking (auto-detect by default)
+    },
+    dev: {
+      command: 'vp dev',
+      cache: false,                    // Don't cache dev servers
+    },
+  },
+}
+```
+
+---
+
+## Monorepo execution
+
+### Flags
+
+| Flag | Purpose |
+|---|---|
+| `-r` | Run across all workspace packages in dependency order |
+| `-t` | Run in target package + all its dependencies |
+| `--filter <pattern>` | Select packages by name, directory, or glob (pnpm syntax) |
+| `-w` | Target workspace root package |
+| `--cache` | Enable caching for package.json scripts |
+| `-v` | Verbose output with cache hit rates and timing |
+
+### Examples
+
+```bash
+# Build all packages in dependency order
+vp run build -r
+
+# Build one package and its dependencies
+vp run build -t --filter my-app
+
+# Run tests only in packages matching a glob
+vp run test --filter "packages/*"
+
+# Target workspace root
+vp run lint -w
+```
+
+### Dependency ordering
+
+Package execution order derives from standard `package.json` dependency
+declarations (`dependencies`, `devDependencies`), not task-runner-specific
+dependency graphs. Cross-package task dependencies use the `dependsOn` field
+with `"package#task"` syntax.
+
+---
+
+## Task definitions
+
+```typescript
+run: {
+  tasks: {
+    ci: {
+      command: 'vp check && vp test && vp build',
+      dependsOn: ['lint'],              // Must complete first
+      cache: true,
+      env: ['CI'],
+    },
+    lint: {
+      command: 'vp lint',
+      cache: true,
+    },
+  },
+}
+```
+
+### Nested vp run
+
+When a command contains `vp run`, Vite Task inlines it as a separate task
+rather than spawning a nested process. This keeps output flat and enables
+independent caching for each sub-task.
+
+---
+
+## Lifecycle scripts
+
+```typescript
+run: {
+  enablePrePostScripts: true,   // Default: true, workspace root only
+}
+```
+
+When enabled, running `vp run build` will automatically run `prebuild` and
+`postbuild` scripts from `package.json` if they exist.
+
+---
+
+## Pass-through arguments
+
+Arguments following the task name are forwarded to the underlying command:
+
+```bash
+vp run test -- --coverage --reporter=verbose
+```