refactor(docs): extract site workspace

.github/actions/setup/action.yml

@@ -6,6 +6,6 @@ runs: {
     uses: kjanat/runner@master,
     uses: denoland/setup-deno@v2,
     { uses: oven-sh/setup-bun@v2, with: { bun-version: latest } },
-    { uses: actions/setup-node@v6, with: { node-version: latest } },
+    { uses: actions/setup-node@v7, with: { node-version: latest } },
   ],
 }

.github/workflows/ci.yml

@@ -25,7 +25,7 @@ jobs:
     steps:
       - uses: actions/checkout@v7
       - uses: ./.github/actions/setup
-      - uses: actions/setup-node@v6
+      - uses: actions/setup-node@v7
         with: { node-version: "${{ matrix.node-version }}" }
       - run: runner install --frozen schema:emit
       - name: Test in parallel (Bun) (Node ${{ matrix.node-version }})

.github/workflows/publish-npm.yml

@@ -45,7 +45,7 @@ jobs:
     steps:
       - uses: actions/checkout@v7
         with: { sparse-checkout: ".node-version\npackage.json" }
-      - { uses: actions/setup-node@v6, with: { node-version-file: .node-version, registry-url: https://registry.npmjs.org/ } }
+      - { uses: actions/setup-node@v7, with: { node-version-file: .node-version, registry-url: https://registry.npmjs.org/ } }
       - { uses: actions/download-artifact@v8, with: { name: tarball } }
       - name: Publish to npm
         env:

.gitignore

@@ -228,9 +228,9 @@ $RECYCLE.BIN/
 /_*.ts
 /*example*.ts
 .codex
-/dreamcli.schema.json
 /.bucket/
 .playwright-mcp/
 __pycache__
 .*_cache
 /deno.lock
+/import_map.json

.importmap.ts

@@ -0,0 +1,23 @@
+#!/usr/bin/env bun
+import { writeImportMap } from 'importmapify';
+import pkg from '#package.json';
+
+const n = 'ansispeck';
+const version = pkg['dependencies'][n].replace(/^(?:npm:)?ansispeck@/, '');
+const ansispeck = `jsr:@kjanat/${n}@${version}`;
+
+const out = writeImportMap({
+	root: import.meta.dirname,
+	out: 'import_map.json',
+	additionalImports: {
+		ansispeck,
+		'#dreamcli/schema': './src/schema.ts',
+	},
+	scopes: {
+		'./tests/': {
+			'dreamcli/testkit': 'jsr:@kjanat/dreamcli@^3/testkit',
+		},
+	},
+});
+
+console.log('Wrote import map to', out);

.node-version

@@ -1 +1 @@
-v26.4.0
+v26.5.0

.zed/settings.json

@@ -31,7 +31,13 @@
 				"source.fixAll.biome": true,
 				"source.organizeImports.biome": true
 			},
-			"language_servers": ["typescript", "biome", "oxlint", "deno"]
+			"language_servers": [
+				"typescript-ls",
+				"biome",
+				"oxlint",
+				"deno",
+				"!typescript-language-server"
+			]
 		},
 		"TypeScript": {
 			"formatter": [
@@ -48,11 +54,27 @@
 				"source.fixAll.biome": true,
 				"source.organizeImports.biome": true
 			},
-			"language_servers": ["typescript", "biome", "oxlint", "deno", "vue-language-server"]
+			"language_servers": [
+				"typescript-ls",
+				"biome",
+				"oxlint",
+				"deno",
+				"vue-language-server",
+				"!typescript-language-server"
+			]
 		}
 	},
 	"lsp": {
-		"deno": { "settings": { "deno": { "enable": true } } },
+		"deno": {
+			"settings": {
+				"deno": {
+					"enable": true,
+					"enablePaths": ["./src", "./scripts/deno-smoke-test.ts"],
+					"config": "./deno.json",
+					"importMap": "./import_map.json"
+				}
+			}
+		},
 		"vtsls": {
 			"initialization_options": {
 				// https://github.com/yioneko/vtsls/blob/04c4d90fb4f18dff34d9282cdb7f508aab12cd95/packages/service/configuration.schema.json#L380

biome.jsonc

@@ -20,7 +20,7 @@
 		"ignoreUnknown": true,
 		"maxSize": 5000000
 	},
-	"formatter": { "enabled": false },
+	"formatter": { "enabled": false, "lineWidth": 100, "indentStyle": "tab" },
 	"linter": {
 		"enabled": true,
 		"rules": {
@@ -46,7 +46,8 @@
 		"formatter": {
 			"enabled": false,
 			"quoteStyle": "single",
-			"semicolons": "always"
+			"semicolons": "always",
+			"lineWidth": 100
 		}
 	},
 	"json": {

bunfig.toml

@@ -6,6 +6,7 @@ smol      = false
 [install]
 auto          = "auto"
 exact         = true
+linker        = "hoisted"
 lockfile.save = true
 
 [run]

deno.json

@@ -29,14 +29,7 @@
 			"command": "deno publish"
 		}
 	},
-	"imports": {
-		"ansispeck": "jsr:@kjanat/ansispeck@^0.2.0",
-		"#dreamcli": "./src/index.ts",
-		"#dreamcli/runtime": "./src/runtime.ts",
-		"#dreamcli/testkit": "./src/testkit.ts",
-		"#schema": "./dreamcli.schema.json",
-		"#internals/*": "./src/*"
-	},
+	"importMap": "./import_map.json",
 	"exports": {
 		".": "./src/index.ts",
 		"./runtime": "./src/runtime.ts",
@@ -64,6 +57,7 @@
 	"fmt": { "exclude": ["**"] },
 	"lint": { "rules": { "exclude": ["ban-types", "require-await"] } },
 	"nodeModulesDir": "manual",
+	"preferPackageJson": false,
 	"exclude": ["**/*.test.ts", "*.ts", "*cache/", "coverage/", "dist/", "scripts/", "**/*.tpl"],
 	"minimumDependencyAge": {
 		"exclude": [

docs/.vitepress/data/docs-contract.test.ts

@@ -3,8 +3,8 @@
  */
 
 import { readFile } from 'node:fs/promises';
+import { createTestPrompter, PROMPT_CANCEL, runCommand } from '@kjanat/dreamcli/testkit';
 import { describe, expect, it } from 'vitest';
-import { createTestPrompter, PROMPT_CANCEL, runCommand } from '#dreamcli/testkit';
 
 import {
 	activityCmd,

docs/.vitepress/twoslash/testing-fixtures.ts

@@ -1,4 +1,4 @@
-import { arg, command, flag } from '#dreamcli';
+import { arg, command, flag } from '@kjanat/dreamcli';
 
 export const greet = command('greet')
   .arg('name', arg.string())

docs/package.json

@@ -0,0 +1,28 @@
+{
+	"name": "@kjanat/dreamcli-docs",
+	"version": "0.0.0",
+	"private": true,
+	"type": "module",
+	"scripts": {
+		"build": "bun --bun vitepress build .",
+		"deploy": "wrangler deploy",
+		"dev": "bun --bun vitepress dev . --host --port ${PORT:-5173}",
+		"preview": "bun --bun vitepress preview .",
+		"upload": "wrangler versions upload"
+	},
+	"dependencies": {
+		"@kjanat/dreamcli": "file:.."
+	},
+	"devDependencies": {
+		"@shikijs/transformers": "^4.3.1",
+		"@shikijs/vitepress-twoslash": "^4.3.1",
+		"@types/node": "catalog:",
+		"floating-vue": "^5.2.2",
+		"mermaid": "^11.16.0",
+		"typedoc": "^0.28.20",
+		"typescript": "catalog:",
+		"vite": "^8.1.4",
+		"vitepress": "next",
+		"wrangler": "^4.110.0"
+	}
+}

docs/tsconfig.json

@@ -0,0 +1,8 @@
+{
+	"extends": "../tsconfig.json",
+	"compilerOptions": {
+		"types": ["node", "vite", "vitest"]
+	},
+	"include": ["./**/*.ts"],
+	"exclude": ["./.vitepress/cache", "./.vitepress/dist", "./node_modules"]
+}