acrylblends 0.6.0 → 0.6.2

package/README.md

@@ -22,7 +22,7 @@ One <code>Request</code> in, one <code>Response</code> out: routing, middleware,
 import { Acryl } from 'acrylblends'
 
 const app = new Acryl()
-app.get('/', (c) => c.text('Hello Acryl!'))
+app.get('/', (c) => c.text('Acryl!'))
 
 export default app
 ```
@@ -68,7 +68,7 @@ import { Acryl } from 'acrylblends'
 
 const app = new Acryl()
 
-app.get('/', (c) => c.text('Hello Acryl!'))
+app.get('/', (c) => c.text('Acryl!'))
 
 export default app
 ```
@@ -202,7 +202,7 @@ Export the app's type, and `acrylblends/client` calls its routes with typed path
 // api.ts
 import { Acryl } from 'acrylblends'
 
-const app = new Acryl().get('/api/hello', (c) => c.json({ message: 'Hello Acryl!' }))
+const app = new Acryl().get('/api/hello', (c) => c.json({ message: 'Acryl!' }))
 export type AppType = typeof app
 export default app
 ```
@@ -231,7 +231,7 @@ import app from './index.ts'
 test('GET / says hello', async () => {
   const response = await app.request('/')
   assert.equal(response.status, 200)
-  assert.equal(await response.text(), 'Hello Acryl!')
+  assert.equal(await response.text(), 'Acryl!')
 })
 ```
 
@@ -271,10 +271,12 @@ See [Node.js](https://github.com/acryldev/acryl/blob/main/docs/framework/getting
 | `acrylblends/http-exception` | `HTTPException` |
 | `acrylblends/router/*` | the routers: `reg-exp-router`, `smart-router`, `trie-router`, `pattern-router`, `linear-router` ([routers](https://github.com/acryldev/acryl/blob/main/docs/framework/concepts/routers.md)) |
 | `acrylblends/utils/*` | the utilities the framework is built from |
+| `acrylblends/tiny`, `acrylblends/quick` | the presets: `Acryl` with another router (`PatternRouter`; `LinearRouter` and `TrieRouter`) ([presets](https://github.com/acryldev/acryl/blob/main/docs/framework/api/presets.md)) |
+| `acrylblends/cache`, `acrylblends/mount` | the cache middleware and mounting another framework's fetch handler |
+| `acrylblends/proxy`, `acrylblends/dev` | the proxy helper and the dev helpers (`showRoutes`, `inspectRoutes`, `getRouterName`) |
 | `acrylblends/node-server` | `serve`, `createAdaptorServer`, `getRequestListener`; with `node-server/serve-static` and `node-server/conninfo` |
 
-Every subpath is listed in the package's `exports`. JSX, SSG, the cache, mount, proxy and dev helpers and other runtimes' adapters are
-being ported. The docs mark them "not yet available" until they ship
+Every subpath is listed in the package's `exports`. JSX, SSG and other runtimes' adapters are being ported. The docs mark them "not yet available" until they ship
 ([FAQ](https://github.com/acryldev/acryl/blob/main/docs/framework/guides/faq.md)).
 
 To extend the context's typed variables, augment the root module:

package/dist/index.d.ts

@@ -84,6 +84,8 @@ interface LibraryPlugin {
   readonly devDependencies?: Readonly<Record<string, string>>;
   /** `package.json` scripts the plugin adds; a script the app already has is kept. */
   readonly scripts?: Readonly<Record<string, string>>;
+  /** Lines the app's `.gitignore` needs for this plugin (added when missing, if the app has a `.gitignore`). */
+  readonly gitignore?: readonly string[];
   /** How to mount it, shown after `acrylblends add`. */
   readonly mount?: string;
   /**

package/dist/index.js

@@ -214,6 +214,16 @@ function mergeTooling(appDir, tooling) {
 		scripts: addedScripts
 	};
 }
+/** Add the lines a plugin needs to the app's `.gitignore` when it has one and they are missing. Returns the lines added. */
+function appendGitignore(appDir, lines) {
+	const file = join(appDir, ".gitignore");
+	if (!lines || lines.length === 0 || !existsSync(file)) return [];
+	const current = readFileSync(file, "utf8");
+	const present = new Set(current.split("\n").map((line) => line.trim()));
+	const missing = lines.filter((line) => !present.has(line));
+	if (missing.length > 0) writeFileSync(file, `${current}${current.endsWith("\n") || current === "" ? "" : "\n"}${missing.join("\n")}\n`);
+	return missing;
+}
 /** The generated app's guide for a coding agent: the shared core, then the template's own part. `CLAUDE.md` is only an import of it. */
 function writeAgentFiles(sharedDir, templateDir, target, name) {
 	const core = readFileSync(join(sharedDir, "AGENTS.core.md"), "utf8");
@@ -427,7 +437,8 @@ async function add(options, io) {
 		const code = addExternal(resolve(io.cwd, folder), appDir, io);
 		if (code !== 0) return code;
 	}
-	const names = options.names.filter((name) => !external.includes(name));
+	const plain = !existsSync(join(appDir, "src", "plugins", "instance"));
+	const names = options.names.filter((name) => !external.includes(name)).map((name) => name === "desktop" && plain ? "desktop-web" : name);
 	if (names.length === 0) return 0;
 	const already = names.filter((name) => present(appDir, name));
 	if (already.length > 0) {
@@ -440,6 +451,7 @@ async function add(options, io) {
 		copyPlugin(plugin, appDir);
 		addedDependencies.push(...mergeDependencies(appDir, plugin.dependencies));
 		const tooling = mergeTooling(appDir, plugin);
+		appendGitignore(appDir, plugin.gitignore);
 		addedDependencies.push(...tooling.devDependencies);
 		if (tooling.scripts.length > 0) io.stdout.write(`new scripts: ${tooling.scripts.map((name) => `npm run ${name}`).join(", ")}\n`);
 	}

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["parse"],"sources":["../src/library.ts","../src/project.ts","../src/templates.ts","../src/init.ts","../src/add.ts","../src/io.ts","../src/cli.ts"],"sourcesContent":["import { cpSync, existsSync, readdirSync, readFileSync } from 'node:fs'\nimport { dirname, join, sep } from 'node:path'\nimport { fileURLToPath } from 'node:url'\n\n/** One entry of the plugin library: `plugins/<name>/plugin.json` in this repository. */\nexport interface LibraryPlugin {\n  readonly name: string\n  readonly description: string\n  /** Library plugins this one imports; they are copied with it. */\n  readonly requires: readonly string[]\n  /** npm packages an app needs at run time for this plugin. */\n  readonly dependencies: Readonly<Record<string, string>>\n  /** npm packages an app needs only to develop or run this plugin's tooling (for example `electron` for the desktop shell). */\n  readonly devDependencies?: Readonly<Record<string, string>>\n  /** `package.json` scripts the plugin adds; a script the app already has is kept. */\n  readonly scripts?: Readonly<Record<string, string>>\n  /** How to mount it, shown after `acrylblends add`. */\n  readonly mount?: string\n  /**\n   * Paths inside the plugin folder that are not copied into an app (for example a React hook an app without React cannot type-check, or colocated test\n   * files). A pattern is an exact path or a glob: `*` matches within one folder name, `**` across folders, `?` one character; `**` followed by a slash also matches no folder.\n   */\n  readonly omit?: readonly string[]\n}\n\n/** A glob as a regular expression: `*` within a name, `**` across folders, `**` plus a slash may match no folder, `?` one character. */\nfunction globToRegExp(glob: string): RegExp {\n  let source = ''\n  for (let i = 0; i < glob.length; i += 1) {\n    const c = glob[i] as string\n    if (c === '*' && glob[i + 1] === '*') {\n      if (glob[i + 2] === '/') {\n        source += '(?:.*/)?'\n        i += 2\n      } else {\n        source += '.*'\n        i += 1\n      }\n    } else if (c === '*') source += '[^/]*'\n    else if (c === '?') source += '[^/]'\n    else source += c.replace(/[.+^${}()|[\\]\\\\]/g, '\\\\$&')\n  }\n  return new RegExp(`^${source}$`)\n}\n\n/** Whether a path inside a plugin folder (relative, any separator) is named by one of its `omit` patterns. */\nexport function isOmitted(inside: string, patterns: readonly string[] | undefined): boolean {\n  if (!patterns || patterns.length === 0) return false\n  const path = inside.split(sep).join('/')\n  return patterns.some((pattern) =>\n    /[*?]/.test(pattern) ? globToRegExp(pattern).test(path) : pattern === path,\n  )\n}\n\n/** Files of a library plugin that stay in the repository: its manifest and its tests. */\nconst LIBRARY_ONLY = new Set(['plugin.json', 'test', 'tests'])\n\nexport class LibraryError extends Error {\n  override name = 'LibraryError'\n}\n\n/** The library folder (`plugins/` at the repository root): walk up from this module, in source or in the build. */\nexport function libraryRoot(): string {\n  let dir = dirname(fileURLToPath(import.meta.url))\n  for (;;) {\n    const candidate = join(dir, 'plugins')\n    if (existsSync(join(candidate, 'instance', 'plugin.json'))) return candidate\n    const parent = dirname(dir)\n    if (parent === dir)\n      throw new LibraryError('acrylblends cannot find its plugin library (plugins/)')\n    dir = parent\n  }\n}\n\n/** Every plugin in the library, by name. */\nexport function readLibrary(root: string = libraryRoot()): Map<string, LibraryPlugin> {\n  const plugins = new Map<string, LibraryPlugin>()\n  for (const entry of readdirSync(root, { withFileTypes: true })) {\n    const manifest = join(root, entry.name, 'plugin.json')\n    if (!entry.isDirectory() || !existsSync(manifest)) continue\n    const plugin = JSON.parse(readFileSync(manifest, 'utf8')) as LibraryPlugin\n    if (plugin.name !== entry.name)\n      throw new LibraryError(`plugins/${entry.name}/plugin.json names \"${plugin.name}\"`)\n    plugins.set(plugin.name, {\n      ...plugin,\n      requires: plugin.requires ?? [],\n      dependencies: plugin.dependencies ?? {},\n    })\n  }\n  return plugins\n}\n\n/** The plugins to copy for `names`: each one after everything it requires, no duplicates. */\nexport function closure(\n  names: readonly string[],\n  library: Map<string, LibraryPlugin>,\n): LibraryPlugin[] {\n  const ordered: LibraryPlugin[] = []\n  const visiting = new Set<string>()\n  const visit = (name: string, trail: string[]) => {\n    if (ordered.some((plugin) => plugin.name === name)) return\n    const plugin = library.get(name)\n    if (!plugin)\n      throw new LibraryError(\n        `no plugin \"${name}\" in the library${trail.length ? ` (required by ${trail.at(-1)})` : ''}`,\n      )\n    if (visiting.has(name))\n      throw new LibraryError(\n        `plugins require each other in a cycle: ${[...trail, name].join(' -> ')}`,\n      )\n    visiting.add(name)\n    for (const required of plugin.requires) visit(required, [...trail, name])\n    visiting.delete(name)\n    ordered.push(plugin)\n  }\n  for (const name of names) visit(name, [])\n  return ordered\n}\n\n/** Copy one library plugin's source into `<app>/src/plugins/<name>/`. Throws when that folder already exists. */\nexport function copyPlugin(\n  plugin: LibraryPlugin,\n  appDir: string,\n  root: string = libraryRoot(),\n): string {\n  const target = join(appDir, 'src', 'plugins', plugin.name)\n  if (existsSync(target))\n    throw new LibraryError(\n      `src/plugins/${plugin.name} already exists; remove it first to copy a fresh one`,\n    )\n  const source = join(root, plugin.name)\n  cpSync(source, target, {\n    recursive: true,\n    filter: (path) => {\n      const inside = path.slice(source.length + 1)\n      return (\n        !(dirname(path) === source && LIBRARY_ONLY.has(inside)) && !isOmitted(inside, plugin.omit)\n      )\n    },\n  })\n  return target\n}\n","import {\n  cpSync,\n  existsSync,\n  mkdirSync,\n  readdirSync,\n  readFileSync,\n  statSync,\n  writeFileSync,\n} from 'node:fs'\nimport { join } from 'node:path'\n\n/** Thrown when the target directory exists and is not empty. Nothing has been written. */\nexport class TargetNotEmptyError extends Error {\n  constructor(readonly target: string) {\n    super(\n      `refusing to write into \"${target}\": the directory is not empty. Choose an empty or new directory.`,\n    )\n    this.name = 'TargetNotEmptyError'\n  }\n}\n\n/** A project name npm accepts: lower case letters, digits and dashes, starting with a letter. */\nexport function isValidName(name: string): boolean {\n  return /^[a-z][a-z0-9-]*$/.test(name) && name.length <= 214\n}\n\n/** A valid default project name derived from a directory path. */\nexport function nameFrom(directory: string): string {\n  const base = directory.split(/[\\\\/]/).filter(Boolean).pop() ?? ''\n  const cleaned = base\n    .toLowerCase()\n    .replace(/[^a-z0-9-]+/g, '-')\n    .replace(/^[^a-z]+/, '')\n    .replace(/-+$/, '')\n  return cleaned || 'my-app'\n}\n\n/** Refuse a target that exists and is not an empty directory. A missing target is fine: it is created. */\nexport function assertTargetFree(target: string): void {\n  if (!existsSync(target)) return\n  if (!statSync(target).isDirectory() || readdirSync(target).length > 0)\n    throw new TargetNotEmptyError(target)\n}\n\n/**\n * Copy a template into `target`, replacing `__APP_NAME__` with `name`. Checks the target before writing anything.\n *\n * @returns the copied files, relative to `target`\n */\nexport function copyTemplate(source: string, target: string, name: string): string[] {\n  assertTargetFree(target)\n  mkdirSync(target, { recursive: true })\n  const written: string[] = []\n  const walk = (from: string, to: string, prefix: string) => {\n    for (const entry of readdirSync(from, { withFileTypes: true })) {\n      if (\n        entry.name === 'node_modules' ||\n        (prefix === '' &&\n          (entry.name === TEMPLATE_MANIFEST ||\n            entry.name === 'upstream.json' ||\n            entry.name === 'AGENTS.md'))\n      )\n        continue\n      const sourcePath = join(from, entry.name)\n      // npm and git treat a file named .gitignore specially, so templates keep it as `gitignore` (and `dockerignore`).\n      const targetName =\n        prefix === '' && (entry.name === 'gitignore' || entry.name === 'dockerignore')\n          ? `.${entry.name}`\n          : entry.name\n      const targetPath = join(to, targetName)\n      if (entry.isDirectory()) {\n        mkdirSync(targetPath, { recursive: true })\n        walk(sourcePath, targetPath, `${prefix}${entry.name}/`)\n        continue\n      }\n      const text = readFileSync(sourcePath, 'utf8')\n      if (text.includes('__APP_NAME__'))\n        writeFileSync(targetPath, text.replaceAll('__APP_NAME__', name))\n      else cpSync(sourcePath, targetPath)\n      written.push(`${prefix}${targetName}`)\n    }\n  }\n  walk(source, target, '')\n  return written\n}\n\n/** A template's own manifest, `template.json`: the library plugins it is built from. Never copied (nor is `upstream.json`, the record of what was synced from ACRYL, nor the template's `AGENTS.md`, which `writeAgentFiles` joins to the shared core). */\nexport const TEMPLATE_MANIFEST = 'template.json'\n\n/** The address a template's desktop window opens on, when it is not the root (`template.json`: `desktopPath`). */\nexport function readTemplateDesktopPath(templateDir: string): string | undefined {\n  const file = join(templateDir, TEMPLATE_MANIFEST)\n  if (!existsSync(file)) return undefined\n  return (JSON.parse(readFileSync(file, 'utf8')) as { desktopPath?: string }).desktopPath\n}\n\n/** Record where the desktop window opens in package.json (`acrylblends.desktopPath`), read by `src/plugins/desktop/main.ts`. */\nexport function writeDesktopPath(appDir: string, path: string): void {\n  const file = join(appDir, 'package.json')\n  const manifest = JSON.parse(readFileSync(file, 'utf8')) as {\n    acrylblends?: Record<string, unknown>\n  }\n  manifest.acrylblends = { ...manifest.acrylblends, desktopPath: path }\n  writeFileSync(file, `${JSON.stringify(manifest, null, 2)}\\n`)\n}\n\nexport function readTemplatePlugins(templateDir: string): string[] {\n  const file = join(templateDir, TEMPLATE_MANIFEST)\n  if (!existsSync(file)) return []\n  const { plugins } = JSON.parse(readFileSync(file, 'utf8')) as { plugins?: string[] }\n  return plugins ?? []\n}\n\n/** Add run-time dependencies to an app's package.json, keeping what is there and sorting the keys. Returns the names added. */\nexport function mergeDependencies(\n  appDir: string,\n  dependencies: Readonly<Record<string, string>>,\n): string[] {\n  const file = join(appDir, 'package.json')\n  const manifest = JSON.parse(readFileSync(file, 'utf8')) as {\n    dependencies?: Record<string, string>\n  }\n  const current = manifest.dependencies ?? {}\n  const added = Object.keys(dependencies).filter((name) => !(name in current))\n  const merged = { ...dependencies, ...current }\n  manifest.dependencies = Object.fromEntries(\n    Object.entries(merged).sort(([a], [b]) => a.localeCompare(b)),\n  )\n  writeFileSync(file, `${JSON.stringify(manifest, null, 2)}\\n`)\n  return added\n}\n\n/**\n * Add a plugin's development dependencies and scripts to an app's package.json: nothing the app already has is replaced. Returns the names of the development dependencies\n * and scripts added.\n */\nexport function mergeTooling(\n  appDir: string,\n  tooling: {\n    devDependencies?: Readonly<Record<string, string>> | undefined\n    scripts?: Readonly<Record<string, string>> | undefined\n  },\n): { devDependencies: string[]; scripts: string[] } {\n  const file = join(appDir, 'package.json')\n  const manifest = JSON.parse(readFileSync(file, 'utf8')) as {\n    devDependencies?: Record<string, string>\n    scripts?: Record<string, string>\n  }\n  const dev = manifest.devDependencies ?? {}\n  const scripts = manifest.scripts ?? {}\n  const addedDev = Object.keys(tooling.devDependencies ?? {}).filter((name) => !(name in dev))\n  const addedScripts = Object.keys(tooling.scripts ?? {}).filter((name) => !(name in scripts))\n  manifest.devDependencies = Object.fromEntries(\n    Object.entries({ ...tooling.devDependencies, ...dev }).sort(([a], [b]) => a.localeCompare(b)),\n  )\n  manifest.scripts = { ...tooling.scripts, ...scripts }\n  writeFileSync(file, `${JSON.stringify(manifest, null, 2)}\\n`)\n  return { devDependencies: addedDev, scripts: addedScripts }\n}\n\n/** The generated app's guide for a coding agent: the shared core, then the template's own part. `CLAUDE.md` is only an import of it. */\nexport function writeAgentFiles(\n  sharedDir: string,\n  templateDir: string,\n  target: string,\n  name: string,\n): string[] {\n  const core = readFileSync(join(sharedDir, 'AGENTS.core.md'), 'utf8')\n  const own = existsSync(join(templateDir, 'AGENTS.md'))\n    ? readFileSync(join(templateDir, 'AGENTS.md'), 'utf8')\n    : ''\n  writeFileSync(join(target, 'AGENTS.md'), `${core}${own}`.replaceAll('__APP_NAME__', name))\n  writeFileSync(join(target, 'CLAUDE.md'), '@AGENTS.md\\n')\n  return ['AGENTS.md', 'CLAUDE.md']\n}\n\n/**\n * Copy the framework's docs (a generated copy of ACRYL's `docs/framework`, already checked against its digest) into `<app>/docs/framework/`,\n * so a coding agent working in the app reads the API from the folder it is in. The generated-copy notes and the digest record stay behind.\n *\n * @returns the copied files, relative to `target`\n */\nexport function copyFrameworkDocs(source: string, target: string): string[] {\n  const written: string[] = []\n  const walk = (from: string, to: string, prefix: string) => {\n    for (const entry of readdirSync(from, { withFileTypes: true })) {\n      if (entry.name === 'upstream.json' || entry.name === 'UPSTREAM.md') continue\n      const sourcePath = join(from, entry.name)\n      const targetPath = join(to, entry.name)\n      if (entry.isDirectory()) {\n        mkdirSync(targetPath, { recursive: true })\n        walk(sourcePath, targetPath, `${prefix}${entry.name}/`)\n        continue\n      }\n      cpSync(sourcePath, targetPath)\n      written.push(`docs/framework/${prefix}${entry.name}`)\n    }\n  }\n  mkdirSync(join(target, 'docs', 'framework'), { recursive: true })\n  walk(source, join(target, 'docs', 'framework'), '')\n  return written\n}\n","import { existsSync } from 'node:fs'\nimport { dirname, join } from 'node:path'\nimport { fileURLToPath } from 'node:url'\n\n/** The templates: a blank Cordis app on the router, a todo list built only on the router and state, and the blank app with the offline agent. */\nexport const TEMPLATES = ['blank', 'todo', 'agent'] as const\nexport type Template = (typeof TEMPLATES)[number]\n\nexport function isTemplate(value: string): value is Template {\n  return (TEMPLATES as readonly string[]).includes(value)\n}\n\n/**\n * The `templates/` folder of this package. The module sits at different depths in source (`src/`) and in the build\n * (`dist/`), so walk up until a `templates` folder holds the `blank` template.\n */\nexport function templatesRoot(): string {\n  let dir = dirname(fileURLToPath(import.meta.url))\n  for (;;) {\n    const candidate = join(dir, 'templates')\n    if (existsSync(join(candidate, 'blank'))) return candidate\n    const parent = dirname(dir)\n    if (parent === dir) throw new Error('acrylblends cannot find its templates folder')\n    dir = parent\n  }\n}\n\n/** Absolute path of a template folder. */\nexport function templateDir(template: Template): string {\n  return join(templatesRoot(), template)\n}\n\n/** The text every generated app's `AGENTS.md` starts with (`shared/`, beside `templates/`). */\nexport function sharedDir(): string {\n  return join(dirname(templatesRoot()), 'shared')\n}\n\n/**\n * The framework's docs, as ACRYL wrote them: `docs/framework` of the repository, or the copy `prepack` puts inside the package. The module sits at\n * different depths in source and in the build, so walk up until a `docs/framework` folder holds the README.\n */\nexport function frameworkDocsRoot(): string {\n  let dir = dirname(fileURLToPath(import.meta.url))\n  for (;;) {\n    const candidate = join(dir, 'docs', 'framework')\n    if (existsSync(join(candidate, 'README.md'))) return candidate\n    const parent = dirname(dir)\n    if (parent === dir)\n      throw new Error('acrylblends cannot find the framework docs (docs/framework)')\n    dir = parent\n  }\n}\n","import { resolve } from 'node:path'\nimport { parseArgs } from 'node:util'\nimport type { Io } from './io'\nimport { closure, copyPlugin, readLibrary } from './library'\nimport {\n  copyFrameworkDocs,\n  copyTemplate,\n  isValidName,\n  mergeDependencies,\n  mergeTooling,\n  nameFrom,\n  readTemplateDesktopPath,\n  readTemplatePlugins,\n  TargetNotEmptyError,\n  writeAgentFiles,\n  writeDesktopPath,\n} from './project'\nimport {\n  frameworkDocsRoot,\n  isTemplate,\n  sharedDir,\n  TEMPLATES,\n  type Template,\n  templateDir,\n} from './templates'\n\n/** A command line mistake. The CLI prints it with the help text and exits 2. */\nexport class UsageError extends Error {\n  override name = 'UsageError'\n}\n\n/** What `init` was asked for. Anything left undefined is asked for on a terminal, or defaulted. */\nexport interface InitOptions {\n  directory: string | undefined\n  name: string | undefined\n  template: Template | undefined\n  install: boolean | undefined\n  /** Also add the desktop shell (`add desktop`): an Electron window on the app's own server. */\n  desktop: boolean\n  yes: boolean\n}\n\n/** Parse `init [dir] [--template t] [--agent|--no-agent] [--name n] [--install] [-y]`. `--agent` means `--template agent`, `--no-agent` means `--template blank`. */\nexport function parseInitOptions(argv: readonly string[]): InitOptions {\n  let parsed: ReturnType<typeof parse>\n  try {\n    parsed = parse(argv)\n  } catch (error) {\n    throw new UsageError((error as Error).message)\n  }\n  const { values, positionals } = parsed\n  if (positionals.length > 1) throw new UsageError('init takes at most one directory')\n  if (values.agent && values['no-agent'])\n    throw new UsageError('use --agent or --no-agent, not both')\n  if (values.template !== undefined && !isTemplate(values.template))\n    throw new UsageError(`unknown template \"${values.template}\" (${TEMPLATES.join(', ')})`)\n  const alias: Template | undefined = values.agent\n    ? 'agent'\n    : values['no-agent']\n      ? 'blank'\n      : undefined\n  if (values.template !== undefined && alias !== undefined && values.template !== alias)\n    throw new UsageError(\n      `--template ${values.template} contradicts --${alias === 'agent' ? 'agent' : 'no-agent'}`,\n    )\n  return {\n    directory: positionals[0],\n    name: values.name,\n    template: (values.template as Template | undefined) ?? alias,\n    install: values.install,\n    desktop: values.desktop === true,\n    yes: values.yes === true,\n  }\n}\n\nconst parse = (argv: readonly string[]) =>\n  parseArgs({\n    args: [...argv],\n    allowPositionals: true,\n    strict: true,\n    options: {\n      name: { type: 'string' },\n      template: { type: 'string' },\n      agent: { type: 'boolean' },\n      'no-agent': { type: 'boolean' },\n      install: { type: 'boolean' },\n      desktop: { type: 'boolean' },\n      yes: { type: 'boolean', short: 'y' },\n    },\n  })\n\nconst yes = (answer: string) => ['y', 'yes'].includes(answer.trim().toLowerCase())\n\nasync function askTemplate(ask: (question: string) => Promise<string>): Promise<Template> {\n  const answer = (await ask(`Template (${TEMPLATES.join(', ')}) [blank]: `)).trim().toLowerCase()\n  if (answer === '') return 'blank'\n  if (isTemplate(answer)) return answer\n  throw new UsageError(`unknown template \"${answer}\" (${TEMPLATES.join(', ')})`)\n}\n\n/** Scaffold a Cordis app. Returns the exit code: 0 done, 1 refused or failed. Never overwrites anything. */\nexport async function init(options: InitOptions, io: Io): Promise<number> {\n  const relative = options.directory ?? '.'\n  const directory = resolve(io.cwd, relative)\n  const ask = options.yes ? undefined : io.ask\n\n  let name = options.name ?? nameFrom(directory)\n  if (options.name === undefined && ask)\n    name = (await ask(`Project name (${name}): `)).trim() || name\n  if (!isValidName(name)) {\n    throw new UsageError(\n      `\"${name}\" is not a valid project name (lower case letters, digits and dashes, starting with a letter)`,\n    )\n  }\n  const template = options.template ?? (ask ? await askTemplate(ask) : 'blank')\n  const install =\n    options.install ?? (ask ? yes(await ask('Install dependencies with npm now? (y/N): ')) : false)\n\n  let files: string[]\n  try {\n    files = copyTemplate(templateDir(template), directory, name)\n    files.push(...writeAgentFiles(sharedDir(), templateDir(template), directory, name))\n    files.push(...copyFrameworkDocs(frameworkDocsRoot(), directory))\n  } catch (error) {\n    if (!(error instanceof TargetNotEmptyError)) throw error\n    io.stderr.write(`error: ${error.message}\\n`)\n    return 1\n  }\n  const plugins = closure(\n    [...readTemplatePlugins(templateDir(template)), ...(options.desktop ? ['desktop'] : [])],\n    readLibrary(),\n  )\n  for (const plugin of plugins) {\n    copyPlugin(plugin, directory)\n    mergeDependencies(directory, plugin.dependencies)\n    mergeTooling(directory, plugin)\n  }\n  const desktopPath = options.desktop ? readTemplateDesktopPath(templateDir(template)) : undefined\n  if (desktopPath !== undefined) writeDesktopPath(directory, desktopPath)\n  io.stdout.write(\n    `created ${name} (${template}) in ${directory}: ${files.length} files, plugins ${plugins.map((plugin) => plugin.name).join(', ')}\\n`,\n  )\n\n  if (install && (await io.install(directory)) !== 0) {\n    io.stderr.write('error: npm install failed; run it yourself in the new directory\\n')\n    return 1\n  }\n  const steps = [\n    relative === '.' ? '' : `  cd ${relative}\\n`,\n    install ? '' : '  npm install\\n',\n    '  npm run dev\\n  npm test\\n',\n  ]\n  io.stdout.write(`\\nNext:\\n${steps.join('')}`)\n  return 0\n}\n","import { cpSync, existsSync, readFileSync, statSync } from 'node:fs'\nimport { basename, join, resolve } from 'node:path'\nimport { parseArgs } from 'node:util'\nimport { UsageError } from './init'\nimport type { Io } from './io'\nimport { closure, copyPlugin, type LibraryPlugin, readLibrary } from './library'\nimport { mergeDependencies, mergeTooling } from './project'\n\nexport interface AddOptions {\n  readonly names: readonly string[]\n  readonly directory: string | undefined\n}\n\n/** Parse `add <plugin...> [--dir <app>]`. */\nexport function parseAddOptions(argv: readonly string[]): AddOptions {\n  let parsed: ReturnType<typeof parse>\n  try {\n    parsed = parse(argv)\n  } catch (error) {\n    throw new UsageError((error as Error).message)\n  }\n  if (parsed.positionals.length === 0)\n    throw new UsageError('add needs at least one plugin name (see \"acrylblends plugins\")')\n  return { names: parsed.positionals, directory: parsed.values.dir }\n}\n\nconst parse = (argv: readonly string[]) =>\n  parseArgs({\n    args: [...argv],\n    allowPositionals: true,\n    strict: true,\n    options: { dir: { type: 'string' } },\n  })\n\nconst present = (appDir: string, name: string) => existsSync(join(appDir, 'src', 'plugins', name))\n\n/**\n * Copy library plugins into an existing app, with the plugins they require, and add their npm packages to its package.json.\n * Refuses a plugin the app already has. Returns the exit code.\n */\nexport async function add(options: AddOptions, io: Io): Promise<number> {\n  const appDir = resolve(io.cwd, options.directory ?? '.')\n  if (!existsSync(join(appDir, 'package.json')) || !existsSync(join(appDir, 'src'))) {\n    io.stderr.write(\n      `error: ${appDir} is not an app (no package.json and src/); run \"acrylblends init\" first\\n`,\n    )\n    return 1\n  }\n  // A path is an external plugin folder; anything else is a library plugin name.\n  const external = options.names.filter((name) => /[\\\\/]/.test(name) || name.startsWith('.'))\n  for (const folder of external) {\n    const code = addExternal(resolve(io.cwd, folder), appDir, io)\n    if (code !== 0) return code\n  }\n  const names = options.names.filter((name) => !external.includes(name))\n  if (names.length === 0) return 0\n  const already = names.filter((name) => present(appDir, name))\n  if (already.length > 0) {\n    io.stderr.write(\n      `error: the app already has ${already.map((name) => `src/plugins/${name}`).join(', ')}\\n`,\n    )\n    return 1\n  }\n  const toCopy: LibraryPlugin[] = closure(names, readLibrary()).filter(\n    (plugin) => !present(appDir, plugin.name),\n  )\n  const addedDependencies: string[] = []\n  for (const plugin of toCopy) {\n    copyPlugin(plugin, appDir)\n    addedDependencies.push(...mergeDependencies(appDir, plugin.dependencies))\n    const tooling = mergeTooling(appDir, plugin)\n    addedDependencies.push(...tooling.devDependencies)\n    if (tooling.scripts.length > 0)\n      io.stdout.write(\n        `new scripts: ${tooling.scripts.map((name) => `npm run ${name}`).join(', ')}\\n`,\n      )\n  }\n  io.stdout.write(`added ${toCopy.map((plugin) => plugin.name).join(', ')} to ${appDir}\\n`)\n  if (addedDependencies.length > 0)\n    io.stdout.write(`new dependencies: ${addedDependencies.join(', ')} (run npm install)\\n`)\n  for (const plugin of toCopy.filter((plugin) => names.includes(plugin.name))) {\n    io.stdout.write(\n      `\\n${plugin.name}: ${plugin.mount ?? `import it from './plugins/${plugin.name}/index.ts' and mount it in src/app.ts`}\\n`,\n    )\n  }\n  return 0\n}\n\nconst PLUGIN_NAME = /^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/\n\n/**\n * Bring an external plugin folder (a package made with the builder's package_plugin, or any folder with an index.ts that exports a\n * Cordis plugin) into the app's `extensions/`, where the extensions plugin installs it like any other: checked, staged, started,\n * verified. Its runtime dependencies are not installed here; they are reported so the user adds them deliberately.\n */\nfunction addExternal(folder: string, appDir: string, io: Io): number {\n  if (!existsSync(folder) || !statSync(folder).isDirectory()) {\n    io.stderr.write(`error: ${folder} is not a folder\\n`)\n    return 1\n  }\n  if (!['index.ts', 'index.js', 'index.mjs'].some((entry) => existsSync(join(folder, entry)))) {\n    io.stderr.write(`error: ${folder} has no index.ts that exports a Cordis plugin\\n`)\n    return 1\n  }\n  const manifestFile = join(folder, 'package.json')\n  const manifest = existsSync(manifestFile)\n    ? (JSON.parse(readFileSync(manifestFile, 'utf8')) as {\n        name?: string\n        dependencies?: Record<string, string>\n      })\n    : {}\n  const name = (manifest.name ?? basename(folder)).replace(/^@[^/]+\\//, '')\n  if (!PLUGIN_NAME.test(name)) {\n    io.stderr.write(\n      `error: \"${name}\" is not a plugin name (lowercase letters, digits and dashes)\\n`,\n    )\n    return 1\n  }\n  const target = join(appDir, 'extensions', name)\n  if (existsSync(target)) {\n    io.stderr.write(`error: the app already has extensions/${name}\\n`)\n    return 1\n  }\n  cpSync(folder, target, {\n    recursive: true,\n    filter: (path) => !/[\\\\/](node_modules|\\.git)([\\\\/]|$)/.test(path.slice(folder.length)),\n  })\n  io.stdout.write(\n    `added external plugin ${name} to ${join(appDir, 'extensions')}; it installs at the next start\\n`,\n  )\n  const dependencies = Object.keys(manifest.dependencies ?? {})\n  if (dependencies.length > 0)\n    io.stdout.write(\n      `it uses ${dependencies.join(', ')}: add them to the app with npm install first\\n`,\n    )\n  return 0\n}\n\n/** `acrylblends plugins`: the library, one line per plugin. */\nexport function listPlugins(io: Io): number {\n  for (const plugin of readLibrary().values()) {\n    const requires = plugin.requires.length > 0 ? ` (requires ${plugin.requires.join(', ')})` : ''\n    io.stdout.write(`${plugin.name.padEnd(12)} ${plugin.description}${requires}\\n`)\n  }\n  return 0\n}\n","import { spawn } from 'node:child_process'\nimport { createInterface } from 'node:readline/promises'\n\n/** Everything the CLI touches outside the filesystem. Tests pass their own. */\nexport interface Io {\n  stdout: { write(text: string): unknown }\n  stderr: { write(text: string): unknown }\n  cwd: string\n  /** Ask one question; `undefined` when there is no terminal to ask on. */\n  ask: ((question: string) => Promise<string>) | undefined\n  /** Install dependencies in a directory; resolves to the exit code. */\n  install(directory: string): Promise<number>\n}\n\n/** The real terminal and `npm install`. */\nexport function processIo(): Io {\n  const interactive = Boolean(process.stdin.isTTY && process.stdout.isTTY)\n  return {\n    stdout: process.stdout,\n    stderr: process.stderr,\n    cwd: process.cwd(),\n    ask: interactive\n      ? async (question) => {\n          const rl = createInterface({ input: process.stdin, output: process.stdout })\n          try {\n            return await rl.question(question)\n          } finally {\n            rl.close()\n          }\n        }\n      : undefined,\n    install: (directory) =>\n      new Promise((done) => {\n        const child = spawn('npm', ['install'], {\n          cwd: directory,\n          stdio: 'inherit',\n          shell: process.platform === 'win32',\n        })\n        child.on('error', () => done(1))\n        child.on('exit', (code) => done(code ?? 1))\n      }),\n  }\n}\n","import { createRequire } from 'node:module'\nimport { add, listPlugins, parseAddOptions } from './add'\nimport { init, parseInitOptions, UsageError } from './init'\nimport { type Io, processIo } from './io'\n\n/** The version of this package. */\nexport const VERSION: string = (\n  createRequire(import.meta.url)('../package.json') as { version: string }\n).version\n\nexport const HELP = `acrylblends ${VERSION} - scaffold Cordis apps\n\nUsage:\n  acrylblends init [dir] [options]       Create a Cordis app in an empty or new directory\n  acrylblends add <plugin...> [--dir d]  Copy library plugins (and what they require) into an app;\n                                      a folder path brings an external plugin into its extensions/\n  acrylblends plugins                    List the plugin library\n\nOptions for init:\n  --template <name>      blank or agent (asked when not given); --agent means --template agent,\n                         --no-agent means --template blank\n  --name <name>          the project name (default: the directory name)\n  --desktop              also add the desktop shell: npm run desktop opens a window on the app\n  --install              run npm install after copying\n  -y, --yes              ask nothing; use defaults (the blank template, no install)\n\n  -h, --help             show this help\n  -v, --version          show the version\n`\n\n/**\n * Run the CLI and return the exit code: 0 done, 1 failed or refused, 2 a usage error. Never calls `process.exit`.\n */\nexport async function runCli(argv: readonly string[], io: Io = processIo()): Promise<number> {\n  const [command, ...args] = argv\n  try {\n    if (command === undefined || command === 'help' || command === '-h' || command === '--help') {\n      io.stdout.write(HELP)\n      return command === undefined ? 2 : 0\n    }\n    if (command === 'version' || command === '-v' || command === '--version') {\n      io.stdout.write(`${VERSION}\\n`)\n      return 0\n    }\n    if (command === 'init') return await init(parseInitOptions(args), io)\n    if (command === 'add') return await add(parseAddOptions(args), io)\n    if (command === 'plugins') return listPlugins(io)\n    throw new UsageError(`unknown command \"${command}\"`)\n  } catch (error) {\n    if (error instanceof UsageError) {\n      io.stderr.write(`error: ${error.message}\\n\\n${HELP}`)\n      return 2\n    }\n    io.stderr.write(`error: ${error instanceof Error ? error.message : String(error)}\\n`)\n    return 1\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":["parse"],"sources":["../src/library.ts","../src/project.ts","../src/templates.ts","../src/init.ts","../src/add.ts","../src/io.ts","../src/cli.ts"],"sourcesContent":["import { cpSync, existsSync, readdirSync, readFileSync } from 'node:fs'\nimport { dirname, join, sep } from 'node:path'\nimport { fileURLToPath } from 'node:url'\n\n/** One entry of the plugin library: `plugins/<name>/plugin.json` in this repository. */\nexport interface LibraryPlugin {\n  readonly name: string\n  readonly description: string\n  /** Library plugins this one imports; they are copied with it. */\n  readonly requires: readonly string[]\n  /** npm packages an app needs at run time for this plugin. */\n  readonly dependencies: Readonly<Record<string, string>>\n  /** npm packages an app needs only to develop or run this plugin's tooling (for example `electron` for the desktop shell). */\n  readonly devDependencies?: Readonly<Record<string, string>>\n  /** `package.json` scripts the plugin adds; a script the app already has is kept. */\n  readonly scripts?: Readonly<Record<string, string>>\n  /** Lines the app's `.gitignore` needs for this plugin (added when missing, if the app has a `.gitignore`). */\n  readonly gitignore?: readonly string[]\n  /** How to mount it, shown after `acrylblends add`. */\n  readonly mount?: string\n  /**\n   * Paths inside the plugin folder that are not copied into an app (for example a React hook an app without React cannot type-check, or colocated test\n   * files). A pattern is an exact path or a glob: `*` matches within one folder name, `**` across folders, `?` one character; `**` followed by a slash also matches no folder.\n   */\n  readonly omit?: readonly string[]\n}\n\n/** A glob as a regular expression: `*` within a name, `**` across folders, `**` plus a slash may match no folder, `?` one character. */\nfunction globToRegExp(glob: string): RegExp {\n  let source = ''\n  for (let i = 0; i < glob.length; i += 1) {\n    const c = glob[i] as string\n    if (c === '*' && glob[i + 1] === '*') {\n      if (glob[i + 2] === '/') {\n        source += '(?:.*/)?'\n        i += 2\n      } else {\n        source += '.*'\n        i += 1\n      }\n    } else if (c === '*') source += '[^/]*'\n    else if (c === '?') source += '[^/]'\n    else source += c.replace(/[.+^${}()|[\\]\\\\]/g, '\\\\$&')\n  }\n  return new RegExp(`^${source}$`)\n}\n\n/** Whether a path inside a plugin folder (relative, any separator) is named by one of its `omit` patterns. */\nexport function isOmitted(inside: string, patterns: readonly string[] | undefined): boolean {\n  if (!patterns || patterns.length === 0) return false\n  const path = inside.split(sep).join('/')\n  return patterns.some((pattern) =>\n    /[*?]/.test(pattern) ? globToRegExp(pattern).test(path) : pattern === path,\n  )\n}\n\n/** Files of a library plugin that stay in the repository: its manifest and its tests. */\nconst LIBRARY_ONLY = new Set(['plugin.json', 'test', 'tests'])\n\nexport class LibraryError extends Error {\n  override name = 'LibraryError'\n}\n\n/** The library folder (`plugins/` at the repository root): walk up from this module, in source or in the build. */\nexport function libraryRoot(): string {\n  let dir = dirname(fileURLToPath(import.meta.url))\n  for (;;) {\n    const candidate = join(dir, 'plugins')\n    if (existsSync(join(candidate, 'instance', 'plugin.json'))) return candidate\n    const parent = dirname(dir)\n    if (parent === dir)\n      throw new LibraryError('acrylblends cannot find its plugin library (plugins/)')\n    dir = parent\n  }\n}\n\n/** Every plugin in the library, by name. */\nexport function readLibrary(root: string = libraryRoot()): Map<string, LibraryPlugin> {\n  const plugins = new Map<string, LibraryPlugin>()\n  for (const entry of readdirSync(root, { withFileTypes: true })) {\n    const manifest = join(root, entry.name, 'plugin.json')\n    if (!entry.isDirectory() || !existsSync(manifest)) continue\n    const plugin = JSON.parse(readFileSync(manifest, 'utf8')) as LibraryPlugin\n    if (plugin.name !== entry.name)\n      throw new LibraryError(`plugins/${entry.name}/plugin.json names \"${plugin.name}\"`)\n    plugins.set(plugin.name, {\n      ...plugin,\n      requires: plugin.requires ?? [],\n      dependencies: plugin.dependencies ?? {},\n    })\n  }\n  return plugins\n}\n\n/** The plugins to copy for `names`: each one after everything it requires, no duplicates. */\nexport function closure(\n  names: readonly string[],\n  library: Map<string, LibraryPlugin>,\n): LibraryPlugin[] {\n  const ordered: LibraryPlugin[] = []\n  const visiting = new Set<string>()\n  const visit = (name: string, trail: string[]) => {\n    if (ordered.some((plugin) => plugin.name === name)) return\n    const plugin = library.get(name)\n    if (!plugin)\n      throw new LibraryError(\n        `no plugin \"${name}\" in the library${trail.length ? ` (required by ${trail.at(-1)})` : ''}`,\n      )\n    if (visiting.has(name))\n      throw new LibraryError(\n        `plugins require each other in a cycle: ${[...trail, name].join(' -> ')}`,\n      )\n    visiting.add(name)\n    for (const required of plugin.requires) visit(required, [...trail, name])\n    visiting.delete(name)\n    ordered.push(plugin)\n  }\n  for (const name of names) visit(name, [])\n  return ordered\n}\n\n/** Copy one library plugin's source into `<app>/src/plugins/<name>/`. Throws when that folder already exists. */\nexport function copyPlugin(\n  plugin: LibraryPlugin,\n  appDir: string,\n  root: string = libraryRoot(),\n): string {\n  const target = join(appDir, 'src', 'plugins', plugin.name)\n  if (existsSync(target))\n    throw new LibraryError(\n      `src/plugins/${plugin.name} already exists; remove it first to copy a fresh one`,\n    )\n  const source = join(root, plugin.name)\n  cpSync(source, target, {\n    recursive: true,\n    filter: (path) => {\n      const inside = path.slice(source.length + 1)\n      return (\n        !(dirname(path) === source && LIBRARY_ONLY.has(inside)) && !isOmitted(inside, plugin.omit)\n      )\n    },\n  })\n  return target\n}\n","import {\n  cpSync,\n  existsSync,\n  mkdirSync,\n  readdirSync,\n  readFileSync,\n  statSync,\n  writeFileSync,\n} from 'node:fs'\nimport { join } from 'node:path'\n\n/** Thrown when the target directory exists and is not empty. Nothing has been written. */\nexport class TargetNotEmptyError extends Error {\n  constructor(readonly target: string) {\n    super(\n      `refusing to write into \"${target}\": the directory is not empty. Choose an empty or new directory.`,\n    )\n    this.name = 'TargetNotEmptyError'\n  }\n}\n\n/** A project name npm accepts: lower case letters, digits and dashes, starting with a letter. */\nexport function isValidName(name: string): boolean {\n  return /^[a-z][a-z0-9-]*$/.test(name) && name.length <= 214\n}\n\n/** A valid default project name derived from a directory path. */\nexport function nameFrom(directory: string): string {\n  const base = directory.split(/[\\\\/]/).filter(Boolean).pop() ?? ''\n  const cleaned = base\n    .toLowerCase()\n    .replace(/[^a-z0-9-]+/g, '-')\n    .replace(/^[^a-z]+/, '')\n    .replace(/-+$/, '')\n  return cleaned || 'my-app'\n}\n\n/** Refuse a target that exists and is not an empty directory. A missing target is fine: it is created. */\nexport function assertTargetFree(target: string): void {\n  if (!existsSync(target)) return\n  if (!statSync(target).isDirectory() || readdirSync(target).length > 0)\n    throw new TargetNotEmptyError(target)\n}\n\n/**\n * Copy a template into `target`, replacing `__APP_NAME__` with `name`. Checks the target before writing anything.\n *\n * @returns the copied files, relative to `target`\n */\nexport function copyTemplate(source: string, target: string, name: string): string[] {\n  assertTargetFree(target)\n  mkdirSync(target, { recursive: true })\n  const written: string[] = []\n  const walk = (from: string, to: string, prefix: string) => {\n    for (const entry of readdirSync(from, { withFileTypes: true })) {\n      if (\n        entry.name === 'node_modules' ||\n        (prefix === '' &&\n          (entry.name === TEMPLATE_MANIFEST ||\n            entry.name === 'upstream.json' ||\n            entry.name === 'AGENTS.md'))\n      )\n        continue\n      const sourcePath = join(from, entry.name)\n      // npm and git treat a file named .gitignore specially, so templates keep it as `gitignore` (and `dockerignore`).\n      const targetName =\n        prefix === '' && (entry.name === 'gitignore' || entry.name === 'dockerignore')\n          ? `.${entry.name}`\n          : entry.name\n      const targetPath = join(to, targetName)\n      if (entry.isDirectory()) {\n        mkdirSync(targetPath, { recursive: true })\n        walk(sourcePath, targetPath, `${prefix}${entry.name}/`)\n        continue\n      }\n      const text = readFileSync(sourcePath, 'utf8')\n      if (text.includes('__APP_NAME__'))\n        writeFileSync(targetPath, text.replaceAll('__APP_NAME__', name))\n      else cpSync(sourcePath, targetPath)\n      written.push(`${prefix}${targetName}`)\n    }\n  }\n  walk(source, target, '')\n  return written\n}\n\n/** A template's own manifest, `template.json`: the library plugins it is built from. Never copied (nor is `upstream.json`, the record of what was synced from ACRYL, nor the template's `AGENTS.md`, which `writeAgentFiles` joins to the shared core). */\nexport const TEMPLATE_MANIFEST = 'template.json'\n\n/** The address a template's desktop window opens on, when it is not the root (`template.json`: `desktopPath`). */\nexport function readTemplateDesktopPath(templateDir: string): string | undefined {\n  const file = join(templateDir, TEMPLATE_MANIFEST)\n  if (!existsSync(file)) return undefined\n  return (JSON.parse(readFileSync(file, 'utf8')) as { desktopPath?: string }).desktopPath\n}\n\n/** Record where the desktop window opens in package.json (`acrylblends.desktopPath`), read by `src/plugins/desktop/main.ts`. */\nexport function writeDesktopPath(appDir: string, path: string): void {\n  const file = join(appDir, 'package.json')\n  const manifest = JSON.parse(readFileSync(file, 'utf8')) as {\n    acrylblends?: Record<string, unknown>\n  }\n  manifest.acrylblends = { ...manifest.acrylblends, desktopPath: path }\n  writeFileSync(file, `${JSON.stringify(manifest, null, 2)}\\n`)\n}\n\nexport function readTemplatePlugins(templateDir: string): string[] {\n  const file = join(templateDir, TEMPLATE_MANIFEST)\n  if (!existsSync(file)) return []\n  const { plugins } = JSON.parse(readFileSync(file, 'utf8')) as { plugins?: string[] }\n  return plugins ?? []\n}\n\n/** Add run-time dependencies to an app's package.json, keeping what is there and sorting the keys. Returns the names added. */\nexport function mergeDependencies(\n  appDir: string,\n  dependencies: Readonly<Record<string, string>>,\n): string[] {\n  const file = join(appDir, 'package.json')\n  const manifest = JSON.parse(readFileSync(file, 'utf8')) as {\n    dependencies?: Record<string, string>\n  }\n  const current = manifest.dependencies ?? {}\n  const added = Object.keys(dependencies).filter((name) => !(name in current))\n  const merged = { ...dependencies, ...current }\n  manifest.dependencies = Object.fromEntries(\n    Object.entries(merged).sort(([a], [b]) => a.localeCompare(b)),\n  )\n  writeFileSync(file, `${JSON.stringify(manifest, null, 2)}\\n`)\n  return added\n}\n\n/**\n * Add a plugin's development dependencies and scripts to an app's package.json: nothing the app already has is replaced. Returns the names of the development dependencies\n * and scripts added.\n */\nexport function mergeTooling(\n  appDir: string,\n  tooling: {\n    devDependencies?: Readonly<Record<string, string>> | undefined\n    scripts?: Readonly<Record<string, string>> | undefined\n  },\n): { devDependencies: string[]; scripts: string[] } {\n  const file = join(appDir, 'package.json')\n  const manifest = JSON.parse(readFileSync(file, 'utf8')) as {\n    devDependencies?: Record<string, string>\n    scripts?: Record<string, string>\n  }\n  const dev = manifest.devDependencies ?? {}\n  const scripts = manifest.scripts ?? {}\n  const addedDev = Object.keys(tooling.devDependencies ?? {}).filter((name) => !(name in dev))\n  const addedScripts = Object.keys(tooling.scripts ?? {}).filter((name) => !(name in scripts))\n  manifest.devDependencies = Object.fromEntries(\n    Object.entries({ ...tooling.devDependencies, ...dev }).sort(([a], [b]) => a.localeCompare(b)),\n  )\n  manifest.scripts = { ...tooling.scripts, ...scripts }\n  writeFileSync(file, `${JSON.stringify(manifest, null, 2)}\\n`)\n  return { devDependencies: addedDev, scripts: addedScripts }\n}\n\n/** Add the lines a plugin needs to the app's `.gitignore` when it has one and they are missing. Returns the lines added. */\nexport function appendGitignore(appDir: string, lines: readonly string[] | undefined): string[] {\n  const file = join(appDir, '.gitignore')\n  if (!lines || lines.length === 0 || !existsSync(file)) return []\n  const current = readFileSync(file, 'utf8')\n  const present = new Set(current.split('\\n').map((line) => line.trim()))\n  const missing = lines.filter((line) => !present.has(line))\n  if (missing.length > 0)\n    writeFileSync(\n      file,\n      `${current}${current.endsWith('\\n') || current === '' ? '' : '\\n'}${missing.join('\\n')}\\n`,\n    )\n  return missing\n}\n\n/** The generated app's guide for a coding agent: the shared core, then the template's own part. `CLAUDE.md` is only an import of it. */\nexport function writeAgentFiles(\n  sharedDir: string,\n  templateDir: string,\n  target: string,\n  name: string,\n): string[] {\n  const core = readFileSync(join(sharedDir, 'AGENTS.core.md'), 'utf8')\n  const own = existsSync(join(templateDir, 'AGENTS.md'))\n    ? readFileSync(join(templateDir, 'AGENTS.md'), 'utf8')\n    : ''\n  writeFileSync(join(target, 'AGENTS.md'), `${core}${own}`.replaceAll('__APP_NAME__', name))\n  writeFileSync(join(target, 'CLAUDE.md'), '@AGENTS.md\\n')\n  return ['AGENTS.md', 'CLAUDE.md']\n}\n\n/**\n * Copy the framework's docs (a generated copy of ACRYL's `docs/framework`, already checked against its digest) into `<app>/docs/framework/`,\n * so a coding agent working in the app reads the API from the folder it is in. The generated-copy notes and the digest record stay behind.\n *\n * @returns the copied files, relative to `target`\n */\nexport function copyFrameworkDocs(source: string, target: string): string[] {\n  const written: string[] = []\n  const walk = (from: string, to: string, prefix: string) => {\n    for (const entry of readdirSync(from, { withFileTypes: true })) {\n      if (entry.name === 'upstream.json' || entry.name === 'UPSTREAM.md') continue\n      const sourcePath = join(from, entry.name)\n      const targetPath = join(to, entry.name)\n      if (entry.isDirectory()) {\n        mkdirSync(targetPath, { recursive: true })\n        walk(sourcePath, targetPath, `${prefix}${entry.name}/`)\n        continue\n      }\n      cpSync(sourcePath, targetPath)\n      written.push(`docs/framework/${prefix}${entry.name}`)\n    }\n  }\n  mkdirSync(join(target, 'docs', 'framework'), { recursive: true })\n  walk(source, join(target, 'docs', 'framework'), '')\n  return written\n}\n","import { existsSync } from 'node:fs'\nimport { dirname, join } from 'node:path'\nimport { fileURLToPath } from 'node:url'\n\n/** The templates: a blank Cordis app on the router, a todo list built only on the router and state, and the blank app with the offline agent. */\nexport const TEMPLATES = ['blank', 'todo', 'agent'] as const\nexport type Template = (typeof TEMPLATES)[number]\n\nexport function isTemplate(value: string): value is Template {\n  return (TEMPLATES as readonly string[]).includes(value)\n}\n\n/**\n * The `templates/` folder of this package. The module sits at different depths in source (`src/`) and in the build\n * (`dist/`), so walk up until a `templates` folder holds the `blank` template.\n */\nexport function templatesRoot(): string {\n  let dir = dirname(fileURLToPath(import.meta.url))\n  for (;;) {\n    const candidate = join(dir, 'templates')\n    if (existsSync(join(candidate, 'blank'))) return candidate\n    const parent = dirname(dir)\n    if (parent === dir) throw new Error('acrylblends cannot find its templates folder')\n    dir = parent\n  }\n}\n\n/** Absolute path of a template folder. */\nexport function templateDir(template: Template): string {\n  return join(templatesRoot(), template)\n}\n\n/** The text every generated app's `AGENTS.md` starts with (`shared/`, beside `templates/`). */\nexport function sharedDir(): string {\n  return join(dirname(templatesRoot()), 'shared')\n}\n\n/**\n * The framework's docs, as ACRYL wrote them: `docs/framework` of the repository, or the copy `prepack` puts inside the package. The module sits at\n * different depths in source and in the build, so walk up until a `docs/framework` folder holds the README.\n */\nexport function frameworkDocsRoot(): string {\n  let dir = dirname(fileURLToPath(import.meta.url))\n  for (;;) {\n    const candidate = join(dir, 'docs', 'framework')\n    if (existsSync(join(candidate, 'README.md'))) return candidate\n    const parent = dirname(dir)\n    if (parent === dir)\n      throw new Error('acrylblends cannot find the framework docs (docs/framework)')\n    dir = parent\n  }\n}\n","import { resolve } from 'node:path'\nimport { parseArgs } from 'node:util'\nimport type { Io } from './io'\nimport { closure, copyPlugin, readLibrary } from './library'\nimport {\n  copyFrameworkDocs,\n  copyTemplate,\n  isValidName,\n  mergeDependencies,\n  mergeTooling,\n  nameFrom,\n  readTemplateDesktopPath,\n  readTemplatePlugins,\n  TargetNotEmptyError,\n  writeAgentFiles,\n  writeDesktopPath,\n} from './project'\nimport {\n  frameworkDocsRoot,\n  isTemplate,\n  sharedDir,\n  TEMPLATES,\n  type Template,\n  templateDir,\n} from './templates'\n\n/** A command line mistake. The CLI prints it with the help text and exits 2. */\nexport class UsageError extends Error {\n  override name = 'UsageError'\n}\n\n/** What `init` was asked for. Anything left undefined is asked for on a terminal, or defaulted. */\nexport interface InitOptions {\n  directory: string | undefined\n  name: string | undefined\n  template: Template | undefined\n  install: boolean | undefined\n  /** Also add the desktop shell (`add desktop`): an Electron window on the app's own server. */\n  desktop: boolean\n  yes: boolean\n}\n\n/** Parse `init [dir] [--template t] [--agent|--no-agent] [--name n] [--install] [-y]`. `--agent` means `--template agent`, `--no-agent` means `--template blank`. */\nexport function parseInitOptions(argv: readonly string[]): InitOptions {\n  let parsed: ReturnType<typeof parse>\n  try {\n    parsed = parse(argv)\n  } catch (error) {\n    throw new UsageError((error as Error).message)\n  }\n  const { values, positionals } = parsed\n  if (positionals.length > 1) throw new UsageError('init takes at most one directory')\n  if (values.agent && values['no-agent'])\n    throw new UsageError('use --agent or --no-agent, not both')\n  if (values.template !== undefined && !isTemplate(values.template))\n    throw new UsageError(`unknown template \"${values.template}\" (${TEMPLATES.join(', ')})`)\n  const alias: Template | undefined = values.agent\n    ? 'agent'\n    : values['no-agent']\n      ? 'blank'\n      : undefined\n  if (values.template !== undefined && alias !== undefined && values.template !== alias)\n    throw new UsageError(\n      `--template ${values.template} contradicts --${alias === 'agent' ? 'agent' : 'no-agent'}`,\n    )\n  return {\n    directory: positionals[0],\n    name: values.name,\n    template: (values.template as Template | undefined) ?? alias,\n    install: values.install,\n    desktop: values.desktop === true,\n    yes: values.yes === true,\n  }\n}\n\nconst parse = (argv: readonly string[]) =>\n  parseArgs({\n    args: [...argv],\n    allowPositionals: true,\n    strict: true,\n    options: {\n      name: { type: 'string' },\n      template: { type: 'string' },\n      agent: { type: 'boolean' },\n      'no-agent': { type: 'boolean' },\n      install: { type: 'boolean' },\n      desktop: { type: 'boolean' },\n      yes: { type: 'boolean', short: 'y' },\n    },\n  })\n\nconst yes = (answer: string) => ['y', 'yes'].includes(answer.trim().toLowerCase())\n\nasync function askTemplate(ask: (question: string) => Promise<string>): Promise<Template> {\n  const answer = (await ask(`Template (${TEMPLATES.join(', ')}) [blank]: `)).trim().toLowerCase()\n  if (answer === '') return 'blank'\n  if (isTemplate(answer)) return answer\n  throw new UsageError(`unknown template \"${answer}\" (${TEMPLATES.join(', ')})`)\n}\n\n/** Scaffold a Cordis app. Returns the exit code: 0 done, 1 refused or failed. Never overwrites anything. */\nexport async function init(options: InitOptions, io: Io): Promise<number> {\n  const relative = options.directory ?? '.'\n  const directory = resolve(io.cwd, relative)\n  const ask = options.yes ? undefined : io.ask\n\n  let name = options.name ?? nameFrom(directory)\n  if (options.name === undefined && ask)\n    name = (await ask(`Project name (${name}): `)).trim() || name\n  if (!isValidName(name)) {\n    throw new UsageError(\n      `\"${name}\" is not a valid project name (lower case letters, digits and dashes, starting with a letter)`,\n    )\n  }\n  const template = options.template ?? (ask ? await askTemplate(ask) : 'blank')\n  const install =\n    options.install ?? (ask ? yes(await ask('Install dependencies with npm now? (y/N): ')) : false)\n\n  let files: string[]\n  try {\n    files = copyTemplate(templateDir(template), directory, name)\n    files.push(...writeAgentFiles(sharedDir(), templateDir(template), directory, name))\n    files.push(...copyFrameworkDocs(frameworkDocsRoot(), directory))\n  } catch (error) {\n    if (!(error instanceof TargetNotEmptyError)) throw error\n    io.stderr.write(`error: ${error.message}\\n`)\n    return 1\n  }\n  const plugins = closure(\n    [...readTemplatePlugins(templateDir(template)), ...(options.desktop ? ['desktop'] : [])],\n    readLibrary(),\n  )\n  for (const plugin of plugins) {\n    copyPlugin(plugin, directory)\n    mergeDependencies(directory, plugin.dependencies)\n    mergeTooling(directory, plugin)\n  }\n  const desktopPath = options.desktop ? readTemplateDesktopPath(templateDir(template)) : undefined\n  if (desktopPath !== undefined) writeDesktopPath(directory, desktopPath)\n  io.stdout.write(\n    `created ${name} (${template}) in ${directory}: ${files.length} files, plugins ${plugins.map((plugin) => plugin.name).join(', ')}\\n`,\n  )\n\n  if (install && (await io.install(directory)) !== 0) {\n    io.stderr.write('error: npm install failed; run it yourself in the new directory\\n')\n    return 1\n  }\n  const steps = [\n    relative === '.' ? '' : `  cd ${relative}\\n`,\n    install ? '' : '  npm install\\n',\n    '  npm run dev\\n  npm test\\n',\n  ]\n  io.stdout.write(`\\nNext:\\n${steps.join('')}`)\n  return 0\n}\n","import { cpSync, existsSync, readFileSync, statSync } from 'node:fs'\nimport { basename, join, resolve } from 'node:path'\nimport { parseArgs } from 'node:util'\nimport { UsageError } from './init'\nimport type { Io } from './io'\nimport { closure, copyPlugin, type LibraryPlugin, readLibrary } from './library'\nimport { appendGitignore, mergeDependencies, mergeTooling } from './project'\n\nexport interface AddOptions {\n  readonly names: readonly string[]\n  readonly directory: string | undefined\n}\n\n/** Parse `add <plugin...> [--dir <app>]`. */\nexport function parseAddOptions(argv: readonly string[]): AddOptions {\n  let parsed: ReturnType<typeof parse>\n  try {\n    parsed = parse(argv)\n  } catch (error) {\n    throw new UsageError((error as Error).message)\n  }\n  if (parsed.positionals.length === 0)\n    throw new UsageError('add needs at least one plugin name (see \"acrylblends plugins\")')\n  return { names: parsed.positionals, directory: parsed.values.dir }\n}\n\nconst parse = (argv: readonly string[]) =>\n  parseArgs({\n    args: [...argv],\n    allowPositionals: true,\n    strict: true,\n    options: { dir: { type: 'string' } },\n  })\n\nconst present = (appDir: string, name: string) => existsSync(join(appDir, 'src', 'plugins', name))\n\n/**\n * Copy library plugins into an existing app, with the plugins they require, and add their npm packages to its package.json.\n * Refuses a plugin the app already has. Returns the exit code.\n */\nexport async function add(options: AddOptions, io: Io): Promise<number> {\n  const appDir = resolve(io.cwd, options.directory ?? '.')\n  if (!existsSync(join(appDir, 'package.json')) || !existsSync(join(appDir, 'src'))) {\n    io.stderr.write(\n      `error: ${appDir} is not an app (no package.json and src/); run \"acrylblends init\" first\\n`,\n    )\n    return 1\n  }\n  // A path is an external plugin folder; anything else is a library plugin name.\n  const external = options.names.filter((name) => /[\\\\/]/.test(name) || name.startsWith('.'))\n  for (const folder of external) {\n    const code = addExternal(resolve(io.cwd, folder), appDir, io)\n    if (code !== 0) return code\n  }\n  // The desktop shell has two forms: the Blend app (it needs the `instance` plugin) and a plain Acryl app (`export default app`); `desktop` means the one that fits.\n  const plain = !existsSync(join(appDir, 'src', 'plugins', 'instance'))\n  const names = options.names\n    .filter((name) => !external.includes(name))\n    .map((name) => (name === 'desktop' && plain ? 'desktop-web' : name))\n  if (names.length === 0) return 0\n  const already = names.filter((name) => present(appDir, name))\n  if (already.length > 0) {\n    io.stderr.write(\n      `error: the app already has ${already.map((name) => `src/plugins/${name}`).join(', ')}\\n`,\n    )\n    return 1\n  }\n  const toCopy: LibraryPlugin[] = closure(names, readLibrary()).filter(\n    (plugin) => !present(appDir, plugin.name),\n  )\n  const addedDependencies: string[] = []\n  for (const plugin of toCopy) {\n    copyPlugin(plugin, appDir)\n    addedDependencies.push(...mergeDependencies(appDir, plugin.dependencies))\n    const tooling = mergeTooling(appDir, plugin)\n    appendGitignore(appDir, plugin.gitignore)\n    addedDependencies.push(...tooling.devDependencies)\n    if (tooling.scripts.length > 0)\n      io.stdout.write(\n        `new scripts: ${tooling.scripts.map((name) => `npm run ${name}`).join(', ')}\\n`,\n      )\n  }\n  io.stdout.write(`added ${toCopy.map((plugin) => plugin.name).join(', ')} to ${appDir}\\n`)\n  if (addedDependencies.length > 0)\n    io.stdout.write(`new dependencies: ${addedDependencies.join(', ')} (run npm install)\\n`)\n  for (const plugin of toCopy.filter((plugin) => names.includes(plugin.name))) {\n    io.stdout.write(\n      `\\n${plugin.name}: ${plugin.mount ?? `import it from './plugins/${plugin.name}/index.ts' and mount it in src/app.ts`}\\n`,\n    )\n  }\n  return 0\n}\n\nconst PLUGIN_NAME = /^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/\n\n/**\n * Bring an external plugin folder (a package made with the builder's package_plugin, or any folder with an index.ts that exports a\n * Cordis plugin) into the app's `extensions/`, where the extensions plugin installs it like any other: checked, staged, started,\n * verified. Its runtime dependencies are not installed here; they are reported so the user adds them deliberately.\n */\nfunction addExternal(folder: string, appDir: string, io: Io): number {\n  if (!existsSync(folder) || !statSync(folder).isDirectory()) {\n    io.stderr.write(`error: ${folder} is not a folder\\n`)\n    return 1\n  }\n  if (!['index.ts', 'index.js', 'index.mjs'].some((entry) => existsSync(join(folder, entry)))) {\n    io.stderr.write(`error: ${folder} has no index.ts that exports a Cordis plugin\\n`)\n    return 1\n  }\n  const manifestFile = join(folder, 'package.json')\n  const manifest = existsSync(manifestFile)\n    ? (JSON.parse(readFileSync(manifestFile, 'utf8')) as {\n        name?: string\n        dependencies?: Record<string, string>\n      })\n    : {}\n  const name = (manifest.name ?? basename(folder)).replace(/^@[^/]+\\//, '')\n  if (!PLUGIN_NAME.test(name)) {\n    io.stderr.write(\n      `error: \"${name}\" is not a plugin name (lowercase letters, digits and dashes)\\n`,\n    )\n    return 1\n  }\n  const target = join(appDir, 'extensions', name)\n  if (existsSync(target)) {\n    io.stderr.write(`error: the app already has extensions/${name}\\n`)\n    return 1\n  }\n  cpSync(folder, target, {\n    recursive: true,\n    filter: (path) => !/[\\\\/](node_modules|\\.git)([\\\\/]|$)/.test(path.slice(folder.length)),\n  })\n  io.stdout.write(\n    `added external plugin ${name} to ${join(appDir, 'extensions')}; it installs at the next start\\n`,\n  )\n  const dependencies = Object.keys(manifest.dependencies ?? {})\n  if (dependencies.length > 0)\n    io.stdout.write(\n      `it uses ${dependencies.join(', ')}: add them to the app with npm install first\\n`,\n    )\n  return 0\n}\n\n/** `acrylblends plugins`: the library, one line per plugin. */\nexport function listPlugins(io: Io): number {\n  for (const plugin of readLibrary().values()) {\n    const requires = plugin.requires.length > 0 ? ` (requires ${plugin.requires.join(', ')})` : ''\n    io.stdout.write(`${plugin.name.padEnd(12)} ${plugin.description}${requires}\\n`)\n  }\n  return 0\n}\n","import { spawn } from 'node:child_process'\nimport { createInterface } from 'node:readline/promises'\n\n/** Everything the CLI touches outside the filesystem. Tests pass their own. */\nexport interface Io {\n  stdout: { write(text: string): unknown }\n  stderr: { write(text: string): unknown }\n  cwd: string\n  /** Ask one question; `undefined` when there is no terminal to ask on. */\n  ask: ((question: string) => Promise<string>) | undefined\n  /** Install dependencies in a directory; resolves to the exit code. */\n  install(directory: string): Promise<number>\n}\n\n/** The real terminal and `npm install`. */\nexport function processIo(): Io {\n  const interactive = Boolean(process.stdin.isTTY && process.stdout.isTTY)\n  return {\n    stdout: process.stdout,\n    stderr: process.stderr,\n    cwd: process.cwd(),\n    ask: interactive\n      ? async (question) => {\n          const rl = createInterface({ input: process.stdin, output: process.stdout })\n          try {\n            return await rl.question(question)\n          } finally {\n            rl.close()\n          }\n        }\n      : undefined,\n    install: (directory) =>\n      new Promise((done) => {\n        const child = spawn('npm', ['install'], {\n          cwd: directory,\n          stdio: 'inherit',\n          shell: process.platform === 'win32',\n        })\n        child.on('error', () => done(1))\n        child.on('exit', (code) => done(code ?? 1))\n      }),\n  }\n}\n","import { createRequire } from 'node:module'\nimport { add, listPlugins, parseAddOptions } from './add'\nimport { init, parseInitOptions, UsageError } from './init'\nimport { type Io, processIo } from './io'\n\n/** The version of this package. */\nexport const VERSION: string = (\n  createRequire(import.meta.url)('../package.json') as { version: string }\n).version\n\nexport const HELP = `acrylblends ${VERSION} - scaffold Cordis apps\n\nUsage:\n  acrylblends init [dir] [options]       Create a Cordis app in an empty or new directory\n  acrylblends add <plugin...> [--dir d]  Copy library plugins (and what they require) into an app;\n                                      a folder path brings an external plugin into its extensions/\n  acrylblends plugins                    List the plugin library\n\nOptions for init:\n  --template <name>      blank or agent (asked when not given); --agent means --template agent,\n                         --no-agent means --template blank\n  --name <name>          the project name (default: the directory name)\n  --desktop              also add the desktop shell: npm run desktop opens a window on the app\n  --install              run npm install after copying\n  -y, --yes              ask nothing; use defaults (the blank template, no install)\n\n  -h, --help             show this help\n  -v, --version          show the version\n`\n\n/**\n * Run the CLI and return the exit code: 0 done, 1 failed or refused, 2 a usage error. Never calls `process.exit`.\n */\nexport async function runCli(argv: readonly string[], io: Io = processIo()): Promise<number> {\n  const [command, ...args] = argv\n  try {\n    if (command === undefined || command === 'help' || command === '-h' || command === '--help') {\n      io.stdout.write(HELP)\n      return command === undefined ? 2 : 0\n    }\n    if (command === 'version' || command === '-v' || command === '--version') {\n      io.stdout.write(`${VERSION}\\n`)\n      return 0\n    }\n    if (command === 'init') return await init(parseInitOptions(args), io)\n    if (command === 'add') return await add(parseAddOptions(args), io)\n    if (command === 'plugins') return listPlugins(io)\n    throw new UsageError(`unknown command \"${command}\"`)\n  } catch (error) {\n    if (error instanceof UsageError) {\n      io.stderr.write(`error: ${error.message}\\n\\n${HELP}`)\n      return 2\n    }\n    io.stderr.write(`error: ${error instanceof Error ? error.message : String(error)}\\n`)\n    return 1\n  }\n}\n"],"mappings":"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"}

package/docs/framework/UPSTREAM.md

@@ -1,3 +1,3 @@
 # Generated copy
 
-This folder is a copy of `docs/framework` of acryldev/acryl at commit `5743482e4199ded676a77f594bce15fd4aa0ca2f`, made by `scripts/sync-framework.mjs`. Do not edit it here: change the text in ACRYL and sync again. `pnpm run verify:framework` fails when a page differs from the recorded digest.
+This folder is a copy of `docs/framework` of acryldev/acryl at commit `0174cb01625bfd32d0162ad56179c582f353321e`, made by `scripts/sync-framework.mjs`. Do not edit it here: change the text in ACRYL and sync again. `pnpm run verify:framework` fails when a page differs from the recorded digest.

package/docs/framework/api/presets.md

@@ -1,8 +1,5 @@
 # Presets
 
-> **Partly available.** The default router (`SmartRouter`), `RegExpRouter`, `TrieRouter`, `LinearRouter` and `PatternRouter` are available and are chosen with the `router` option of `new Acryl()` (see [Routers](../concepts/routers.md)). The presets `acrylblends/quick` and `acrylblends/tiny` are **not yet available**; their examples below are not checked by the docs tests.
-
-
 Acryl has several routers, each designed for a specific purpose.
 You can specify the router you want to use in the constructor of Acryl.
 

package/docs/framework/cordis/acryl-in-a-cordis-app.md

@@ -43,6 +43,9 @@ export function apply(ctx: Context): void {
 | `GET /todo/todos/42` | `{ "id": "42" }` |
 | `GET /todo/` | 404: `/todo` and `/todo/` are different paths (see below) |
 
+The app can come from `acryl-router` or from the published `acrylblends` package: `route` takes any app by its routes
+(`MountableApp`), so an `Acryl` imported from `acrylblends` mounts as it is, with its middleware and its own `onError`.
+
 ### `/todo/` is a 404 until you choose
 
 `/todo/` is the first thing people type, and by default it is not found: the router treats `/todo` and `/todo/` as two paths. Choose

package/docs/framework/getting-started/basic.md

@@ -63,7 +63,7 @@ import { Acryl } from 'acrylblends'
 const app = new Acryl()
 
 app.get('/', (c) => {
-  return c.text('Hello Acryl!')
+  return c.text('Acryl!')
 })
 
 export default app
@@ -83,7 +83,7 @@ const app = new Acryl()
 app.get('/api/hello', (c) => {
   return c.json({
     ok: true,
-    message: 'Hello Acryl!',
+    message: 'Acryl!',
   })
 })
 ```
@@ -162,7 +162,7 @@ app.use(
   '/admin/*',
   basicAuth({
     username: 'admin',
-    password: 'secret',
+    password: process.env.ADMIN_PASSWORD!,
   })
 )
 
@@ -181,7 +181,7 @@ An app is a function from `Request` to `Response`, so a test needs no server:
 import { Acryl } from 'acrylblends'
 
 const app = new Acryl()
-app.get('/', (c) => c.text('Hello Acryl!'))
+app.get('/', (c) => c.text('Acryl!'))
 
 const response = await app.request('/')
 console.log(response.status, await response.text())

package/docs/framework/guides/jsx.md

@@ -54,7 +54,7 @@ const Top: FC<{ messages: string[] }> = (props: {
 }) => {
   return (
     <Layout>
-      <h1>Hello Acryl!</h1>
+      <h1>Acryl!</h1>
       <ul>
         {props.messages.map((message) => {
           return <li>{message}!!</li>

package/docs/framework/guides/middleware.md

@@ -95,7 +95,7 @@ app.use(
   '/auth/*',
   basicAuth({
     username: 'acrylblends',
-    password: 'acoolproject',
+    password: process.env.BASIC_AUTH_PASSWORD!,
   })
 )
 ```

package/docs/framework/helpers/cookie.md

@@ -37,7 +37,7 @@ app.get('/cookie', (c) => {
 
 ```ts
 app.get('/signed-cookie', (c) => {
-  const secret = 'secret' // make sure it's a large enough string to be secure
+  const secret = process.env.COOKIE_SECRET! // a long random string, kept out of the source
 
   await setSignedCookie(c, 'cookie_name0', 'cookie_value', secret)
   const fortuneCookie = await getSignedCookie(

package/docs/framework/helpers/dev.md

@@ -1,8 +1,5 @@
 # Dev Helper
 
-> **Not yet available.** The dev helper (`acrylblends/dev`) is documented here so the page structure matches the rest of the framework, and is not part of acrylblends yet. The code on this page is not checked by the docs tests.
-
-
 Dev Helper provides useful methods you can use in development.
 
 ```ts

package/docs/framework/helpers/jwt.md

@@ -35,7 +35,7 @@ const payload = {
   role: 'admin',
   exp: Math.floor(Date.now() / 1000) + 60 * 5, // Token expires in 5 minutes
 }
-const secret = 'mySecretKey'
+const secret = process.env.JWT_SECRET!
 const token = await sign(payload, secret)
 ```
 

package/docs/framework/helpers/proxy.md

@@ -1,8 +1,5 @@
 # Proxy Helper
 
-> **Not yet available.** The proxy helper (`acrylblends/proxy`) is documented here so the page structure matches the rest of the framework, and is not part of acrylblends yet. The code on this page is not checked by the docs tests.
-
-
 Proxy Helper provides useful functions when using Acryl application as a (reverse) proxy.
 
 ## Import

package/docs/framework/middleware/builtin/basic-auth.md

@@ -21,7 +21,7 @@ app.use(
   '/auth/*',
   basicAuth({
     username: 'acrylblends',
-    password: 'acoolproject',
+    password: process.env.BASIC_AUTH_PASSWORD!,
   })
 )
 
@@ -41,7 +41,7 @@ app.get('/auth/page', (c) => {
 
 app.delete(
   '/auth/page',
-  basicAuth({ username: 'acrylblends', password: 'acoolproject' }),
+  basicAuth({ username: 'acrylblends', password: process.env.BASIC_AUTH_PASSWORD! }),
   (c) => {
     return c.text('Page deleted')
   }
@@ -100,7 +100,7 @@ app.use(
   '/auth/*',
   basicAuth({
     username: 'acrylblends',
-    password: 'acoolproject',
+    password: process.env.BASIC_AUTH_PASSWORD!,
     onAuthSuccess: (c, username) => {
       c.set('username', username)
     },
@@ -129,18 +129,18 @@ app.use(
   basicAuth(
     {
       username: 'acrylblends',
-      password: 'acoolproject',
+      password: process.env.BASIC_AUTH_PASSWORD!,
       // Define other params in the first object
       realm: 'www.example.com',
     },
     {
       username: 'acrylblends-admin',
-      password: 'super-secure',
+      password: process.env.ADMIN_PASSWORD!,
       // Cannot redefine other params here
     },
     {
       username: 'acrylblends-user-1',
-      password: 'a-secret',
+      password: process.env.USER_1_PASSWORD!,
       // Or here
     }
   )

package/docs/framework/middleware/builtin/cache.md

@@ -1,8 +1,5 @@
 # Cache Middleware
 
-> **Not yet available.** The cache middleware (`acrylblends/cache`) is documented here so the page structure matches the rest of the framework, and is not part of acrylblends yet. The code on this page is not checked by the docs tests.
-
-
 The Cache middleware uses the Web Standards' [Cache API](https://developer.mozilla.org/en-US/docs/Web/API/Cache).
 
 The Cache middleware currently supports Cloudflare Workers projects using custom domains and Deno projects using [Deno 1.26+](https://github.com/denoland/deno/releases/tag/v1.26.0). Also available with Deno Deploy.

package/docs/framework/middleware/builtin/combine.md

@@ -39,7 +39,7 @@ app.use(
   )
 )
 
-app.get('/', (c) => c.text('Hello Acryl!'))
+app.get('/', (c) => c.text('Acryl!'))
 ```
 
 ### some

package/docs/framework/middleware/builtin/ip-restriction.md

@@ -28,7 +28,7 @@ app.use(
   })
 )
 
-app.get('/', (c) => c.text('Hello Acryl!'))
+app.get('/', (c) => c.text('Acryl!'))
 ```
 
 Pass the `getConninfo` from the [ConnInfo helper](../../helpers/conninfo.md) appropriate for your environment as the first argument of `ipRestriction`. For a runtime whose adapter is not yet available there is no `getConnInfo` to pass yet.

package/docs/framework/middleware/builtin/logger.md

@@ -15,7 +15,7 @@ import { logger } from 'acrylblends/logger'
 const app = new Acryl()
 
 app.use(logger())
-app.get('/', (c) => c.text('Hello Acryl!'))
+app.get('/', (c) => c.text('Acryl!'))
 ```
 
 ## Logging Details

package/docs/framework/middleware/builtin/mount.md

@@ -1,8 +1,5 @@
 # Mount Middleware
 
-> **Not yet available.** The `acrylblends/mount` subpath (an app can still call `app.mount()`) is documented here so the page structure matches the rest of the framework, and is not part of acrylblends yet. The code on this page is not checked by the docs tests.
-
-
 The Mount Middleware lets you mount an application built with another framework into your Acryl application.
 
 ## Import

package/docs/framework/upstream.json

@@ -2,8 +2,8 @@
   "source": {
     "repo": "acryldev/acryl",
     "path": "docs/framework",
-    "commit": "5743482e4199ded676a77f594bce15fd4aa0ca2f"
+    "commit": "0174cb01625bfd32d0162ad56179c582f353321e"
   },
   "files": 87,
-  "digest": "sha256:31bf1c46fbe74d7d2664b3b935a18bd916b8cab1b9ee9c2b006b8a75617a04f6"
+  "digest": "sha256:be8b4bb2555dbc97ef94caa57f6b071f5c0f173f0711eecc2836a537a1a71681"
 }

package/lib/accepts.d.ts

@@ -1,4 +1,4 @@
-import { t as Context } from "./context-Bm7rI-oK.js";
+import { t as Context } from "./context-B5Y1lLha.js";
 import { t as AcceptHeader } from "./headers-tu2YYN8T.js";
 
 //#region ../../plugins/acryl-router/src/core/helper/accepts/accepts.d.ts

package/lib/acryl-base.d.ts

@@ -1,2 +1,2 @@
-import { $ as Acryl, et as AcrylOptions } from "./context-Bm7rI-oK.js";
+import { $ as Acryl, et as AcrylOptions } from "./context-B5Y1lLha.js";
 export { Acryl as AcrylBase, AcrylOptions };

package/lib/adapter.d.ts

@@ -1,4 +1,4 @@
-import { t as Context } from "./context-Bm7rI-oK.js";
+import { t as Context } from "./context-B5Y1lLha.js";
 
 //#region ../../plugins/acryl-router/src/core/helper/adapter/index.d.ts
 type Runtime = 'node' | 'deno' | 'bun' | 'workerd' | 'fastly' | 'edge-light' | 'other';

package/lib/{app-CmAYW1Al.d.ts → app-BdrVHBlJ.d.ts}

@@ -1,4 +1,4 @@
-import { $ as Acryl$1, J as Schema, _ as Env, et as AcrylOptions, h as BlankSchema, p as BlankEnv } from "./context-Bm7rI-oK.js";
+import { $ as Acryl$1, J as Schema, _ as Env, et as AcrylOptions, h as BlankSchema, p as BlankEnv } from "./context-B5Y1lLha.js";
 
 //#region ../../plugins/acryl-router/src/core/app.d.ts
 /**

package/lib/basic-auth.d.ts

@@ -1,4 +1,4 @@
-import { I as MiddlewareHandler, t as Context } from "./context-Bm7rI-oK.js";
+import { I as MiddlewareHandler, t as Context } from "./context-B5Y1lLha.js";
 
 //#region ../../plugins/acryl-router/src/core/middleware/basic-auth/index.d.ts
 type MessageFunction = (c: Context) => string | object | Promise<string | object>;

package/lib/bearer-auth.d.ts

@@ -1,4 +1,4 @@
-import { I as MiddlewareHandler, _ as Env, t as Context } from "./context-Bm7rI-oK.js";
+import { I as MiddlewareHandler, _ as Env, t as Context } from "./context-B5Y1lLha.js";
 
 //#region ../../plugins/acryl-router/src/core/middleware/bearer-auth/index.d.ts
 type MessageFunction = (c: Context) => string | object | Promise<string | object>;

package/lib/body-limit.d.ts

@@ -1,4 +1,4 @@
-import { I as MiddlewareHandler, t as Context } from "./context-Bm7rI-oK.js";
+import { I as MiddlewareHandler, t as Context } from "./context-B5Y1lLha.js";
 
 //#region ../../plugins/acryl-router/src/core/middleware/body-limit/index.d.ts
 type OnError = (c: Context) => Response | Promise<Response>;