create-acrylblends 0.2.8 → 0.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +5 -4
- package/dist/index.d.ts +1 -3
- package/dist/index.js +20 -198
- package/dist/index.js.map +1 -1
- package/docs/framework/README.md +2 -2
- package/docs/framework/UPSTREAM.md +1 -1
- package/docs/framework/getting-started/basic.md +1 -2
- package/docs/framework/getting-started/desktop.md +1 -1
- package/docs/framework/guides/bring-your-own-tool.md +216 -0
- package/docs/framework/guides/create-acrylblends.md +5 -4
- package/docs/framework/guides/data.md +2 -1
- package/docs/framework/upstream.json +3 -3
- package/package.json +2 -3
- package/templates/bun/gitignore +0 -2
- package/templates/bun/package.json +0 -19
- package/templates/bun/src/index.ts +0 -7
- package/templates/bun/test/app.test.ts +0 -8
- package/templates/bun/tsconfig.json +0 -15
- package/templates/chat/gitignore +0 -7
- package/templates/chat/migrations/001-chat.sql +0 -12
- package/templates/chat/package.json +0 -26
- package/templates/chat/src/app.ts +0 -8
- package/templates/chat/src/chat-app.ts +0 -100
- package/templates/chat/src/client/chat.tsx +0 -115
- package/templates/chat/src/client/tsconfig.json +0 -15
- package/templates/chat/src/db.ts +0 -53
- package/templates/chat/src/index.ts +0 -27
- package/templates/chat/src/llm.ts +0 -42
- package/templates/chat/src/page.tsx +0 -38
- package/templates/chat/test/chat.test.ts +0 -165
- package/templates/chat/test/server.test.ts +0 -59
- package/templates/chat/tsconfig.json +0 -19
- package/templates/nodejs/gitignore +0 -3
- package/templates/nodejs/package.json +0 -23
- package/templates/nodejs/src/app.ts +0 -10
- package/templates/nodejs/src/client/counter.tsx +0 -12
- package/templates/nodejs/src/client/tsconfig.json +0 -15
- package/templates/nodejs/src/index.ts +0 -21
- package/templates/nodejs/src/page.tsx +0 -26
- package/templates/nodejs/src/routes.ts +0 -10
- package/templates/nodejs/test/app.test.ts +0 -40
- package/templates/nodejs/test/server.test.ts +0 -48
- package/templates/nodejs/tsconfig.json +0 -19
- package/templates/notes/gitignore +0 -7
- package/templates/notes/migrations/001-notes.sql +0 -18
- package/templates/notes/package.json +0 -26
- package/templates/notes/src/app.ts +0 -8
- package/templates/notes/src/auth.ts +0 -57
- package/templates/notes/src/client/counter.tsx +0 -21
- package/templates/notes/src/client/tsconfig.json +0 -15
- package/templates/notes/src/db.ts +0 -60
- package/templates/notes/src/index.ts +0 -27
- package/templates/notes/src/notes-app.ts +0 -205
- package/templates/notes/src/schema.ts +0 -38
- package/templates/notes/src/views.tsx +0 -134
- package/templates/notes/test/notes.test.ts +0 -252
- package/templates/notes/test/server.test.ts +0 -59
- package/templates/notes/tsconfig.json +0 -19
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","names":[],"sources":["../src/names.ts","../src/self-knowledge.ts","../src/source.ts","../src/spawn.ts","../src/index.ts"],"sourcesContent":["/**\n * The one place this package names the framework. The templates are written with `__PACKAGE__` and `__RANGE__` (the range is stamped at create time from the framework version this package carries, see `frameworkRange`), and the text of `AGENTS.md` with\n * `__PACKAGE__`, so a rename (for example to `acryl`) is a change here and in `scripts/lib/names.mjs`, which a test keeps equal.\n */\nexport const PACKAGE = 'acrylblends'\nexport const CLASS = 'Acryl'\nexport const CREATE = 'create-acrylblends'\n\n/** The file that makes a folder a template other people can create apps from (`${CREATE} <name> github:owner/repo`). */\nexport const TEMPLATE_MANIFEST = 'acryl.template.json'\n","import { mkdirSync, writeFileSync } from 'node:fs'\nimport { dirname, join } from 'node:path'\n\n/**\n * What an app tells the agent that works in it (spec 049, slice 11): `AGENTS.md` and `CLAUDE.md` (the same text), and one skill that points\n * to `docs/framework/`. The door is Cordis-only for now, so a plain app's text does not mention it. The files are written from this module only, so the three can never disagree.\n */\n\ntype Template = 'nodejs' | 'notes' | 'chat' | 'bun'\n\n/** Where an agent looks for a skill: Claude Code reads `.claude/skills`, Codex and others read `.agents/skills`. The text is the same. */\nexport const SKILL_FOLDERS = ['.claude/skills/app-guide', '.agents/skills/app-guide'] as const\n\n/** The defaults of an app made from this template, each with the one place that swaps it. */\nfunction defaultRows(template: Template, pkg: string): string[] {\n const rows: string[] = []\n if (template === 'notes' || template === 'chat')\n rows.push(\n `| Records | \\`db\\` port, SQLite (\\`${pkg}/db/sqlite\\`) | the opener, \\`src/db.ts\\`: call another provider there; no route, store or test changes |`,\n )\n rows.push(\n `| Small state | \\`kv\\` port, one JSON file (\\`${pkg}/kv/json\\`) | \\`${pkg}/kv/db\\` keeps it in the \\`db\\`; or a provider of your own; the opener is the only file that changes |`,\n )\n rows.push(\n template === 'bun'\n ? `| Server | Bun | \\`${pkg}/node-server\\` for Node, or the adapter of another runtime; \\`src/index.ts\\` is the only file that changes |`\n : `| Server | Node (\\`${pkg}/node-server\\`) | the adapter of another runtime (\\`${pkg}/bun\\`, ...); \\`src/index.ts\\` is the only file that changes |`,\n )\n rows.push(\n `| Window | the browser | \\`npx ${pkg} add desktop\\` adds an Electron window on the same server; the app's code never imports Electron |`,\n )\n if (template === 'nodejs' || template === 'notes' || template === 'chat')\n rows.push(\n `| Browser code | \\`clientModules\\`, no bundler | a bundler (Vite, esbuild) in front of \\`src/client\\`, wrapped in a plugin of its own |`,\n )\n return rows\n}\n\n/** The section every app carries: the framework is a set of defaults, never a rule. */\nexport function defaultsSection(template: Template, pkg: string): string {\n return `## Defaults you can swap\n\nThe framework is not rigid. Every choice is a plugin behind a port, and what the app starts with is only a fallback. Name the default before you change it,\nand swap it at the one place that opens it.\n\n| Choice | Default | To swap it |\n| --- | --- | --- |\n${defaultRows(template, pkg).join('\\n')}\n\n- **An outside tool** (a database server, a bundler, a router such as Vike) joins the app as a provider: a plugin in \\`plugins/<name>/\\` that implements a port and\n passes that port's conformance tests, then the opener names it. Postgres is such a provider and is not part of this package; add it when the app needs it.\n- **The dependency rule:** only the opener imports a provider; everything else takes the port as an argument. \\`${pkg} check-deps\\` enforces it.\n`\n}\n\n/** Where the plugins are, said once. */\nexport function pluginsSection(pkg: string): string {\n return `## Plugins\n\nThere is one plugin folder: \\`plugins/\\` at the root of the app. A plugin is a folder \\`plugins/<name>/\\` with an \\`index.ts\\`. \\`${pkg} add <name>\\` copies a library plugin\nthere; a plugin you or an agent write goes there too. Do not create \\`src/plugins/\\` or \\`extensions/\\`.\n`\n}\n\n/** The text of the one skill. It repeats nothing of the docs; it says where to look and how to work. */\nexport function skillText(name: string, template: Template, pkg: string): string {\n return `---\nname: app-guide\ndescription: How to change, run and check the ${name} app. Use it before adding a feature, a page, a route, a plugin or a dependency to this app, and before saying the work is done.\n---\n\n# Working in ${name}\n\n1. **Read first.** \\`AGENTS.md\\` in this folder says how the app is laid out. The framework's API is in \\`docs/framework/\\`: start at \\`docs/framework/README.md\\`, and\n \\`docs/framework/api/summary.md\\` is the one-page summary. Parts the docs mark \"not yet available\" are not in the package.\n2. **Make the change small.** A route is a function from \\`Request\\` to \\`Response\\`: test it with \\`await app.request('/path')\\`. ${template === 'notes' || template === 'chat' ? 'A change to the data is the next numbered file in `migrations/`; never edit one that has run.' : 'Keep new code in `src/` next to the code it extends.'}\n3. **One plugin folder.** A plugin lives in \\`plugins/<name>/\\` (\\`${pkg} add <name>\\` copies a library plugin there). There is no \\`src/plugins/\\` and no \\`extensions/\\`.\n4. **Defaults are swappable.** The database, the key-value store, the server and the window are plugins behind ports. The table \"Defaults you can swap\" in \\`AGENTS.md\\` names each default and the one file that changes it. Never reach around a port to a driver: \\`${pkg} check-deps\\` fails the check.\n5. **Look at the running app.** Start it with its dev script, open it in a browser, and check the page; the app has no door command yet, so do not look for one.\n6. **Done means checked.** \\`npm test\\` and \\`npm run check\\` pass, and the change shows in the running app after a restart. No secret goes in a file or in \\`git status\\`: keys come from environment variables.\n`\n}\n\n/** Write the same text to `AGENTS.md` and `CLAUDE.md`, and the skill to every folder an agent looks in. */\nexport function writeSelfKnowledge(target: string, agentsText: string, skill: string): string[] {\n const written = ['AGENTS.md', 'CLAUDE.md']\n writeFileSync(join(target, 'AGENTS.md'), agentsText)\n writeFileSync(join(target, 'CLAUDE.md'), agentsText)\n for (const folder of SKILL_FOLDERS) {\n const file = join(target, folder, 'SKILL.md')\n mkdirSync(dirname(file), { recursive: true })\n writeFileSync(file, skill)\n written.push(`${folder}/SKILL.md`)\n }\n return written\n}\n","/**\n * Templates from outside this package: `github:owner/repo[#ref]`, a scoped npm package (`@scope/name[@version]`) or a packed tarball on disk.\n * A source is only ever downloaded and unpacked: no git clone (hooks), no lifecycle script (`npm pack --ignore-scripts`), nothing of it is run.\n */\nimport { spawnSync } from 'node:child_process'\nimport {\n cpSync,\n existsSync,\n lstatSync,\n mkdirSync,\n readdirSync,\n readFileSync,\n rmSync,\n writeFileSync,\n} from 'node:fs'\nimport { join, resolve } from 'node:path'\nimport { PACKAGE, TEMPLATE_MANIFEST } from './names'\n\nexport type Source =\n | { kind: 'github'; owner: string; repo: string; ref: string | undefined }\n | { kind: 'npm'; spec: string }\n | { kind: 'tarball'; path: string }\n\n/** What a template says about itself in `acryl.template.json`. */\nexport interface Manifest {\n name: string\n description: string\n /** Library plugins the template needs, added with `acrylblends add`. */\n plugins: string[]\n}\n\n/** A source that cannot be used; the message says why and is shown as it is. */\nexport class SourceError extends Error {\n override name = 'SourceError'\n}\n\nexport const SOURCE_FORMS = `github:owner/repo[#ref], @scope/name[@version], or a packed .tgz file`\n\nconst LIMITS = { files: 5000, bytes: 50 * 1024 * 1024 }\n\n/** Recognise a source argument, or return `undefined` when it is not one (so the caller can report a usage error). */\nexport function parseSource(text: string, cwd: string): Source | undefined {\n const github = /^github:([A-Za-z0-9_.-]+)\\/([A-Za-z0-9_.-]+)(?:#([A-Za-z0-9_./-]+))?$/.exec(text)\n if (github) return { kind: 'github', owner: github[1]!, repo: github[2]!, ref: github[3] }\n if (text.startsWith('github:')) throw new SourceError(`\"${text}\" is not github:owner/repo[#ref]`)\n if (/^@[a-z0-9][a-z0-9._-]*\\/[a-z0-9][a-z0-9._-]*(@[A-Za-z0-9._-]+)?$/.test(text))\n return { kind: 'npm', spec: text }\n if (text.startsWith('@')) throw new SourceError(`\"${text}\" is not @scope/name[@version]`)\n if (/\\.(tgz|tar\\.gz)$/.test(text)) {\n const path = resolve(cwd, text)\n if (!existsSync(path)) throw new SourceError(`${path} does not exist`)\n return { kind: 'tarball', path }\n }\n return undefined\n}\n\n/** How the bytes of a source are obtained; real by default, replaced in tests. */\nexport interface Fetchers {\n /** The body at a URL (a GitHub tarball). */\n download(url: string): Promise<Uint8Array>\n /** `npm pack <spec> --ignore-scripts` into `dest`; the path of the tarball. */\n pack(spec: string, dest: string): string\n}\n\nexport const realFetchers: Fetchers = {\n async download(url) {\n const response = await fetch(url, { redirect: 'follow' })\n if (!response.ok) throw new SourceError(`${url} answered ${response.status}`)\n return new Uint8Array(await response.arrayBuffer())\n },\n pack(spec, dest) {\n const result = spawnSync(\n 'npm',\n ['pack', spec, '--ignore-scripts', '--json', '--pack-destination', dest],\n {\n encoding: 'utf8',\n shell: false,\n env: { ...process.env, npm_config_ignore_scripts: 'true' },\n },\n )\n if (result.status !== 0)\n throw new SourceError(\n `npm could not pack ${spec}: ${(result.stderr || result.stdout).trim().split('\\n').at(-1)}`,\n )\n const file = (JSON.parse(result.stdout) as { filename: string }[])[0]?.filename\n if (!file) throw new SourceError(`npm packed nothing for ${spec}`)\n return join(dest, file)\n },\n}\n\n/** Unpack a tarball into `dir`, dropping its single top folder; refuses links, paths that leave the folder, and archives that are too big. */\nfunction extract(tarball: string, dir: string): void {\n const list = spawnSync('tar', ['-tzf', tarball], {\n encoding: 'utf8',\n maxBuffer: 64 * 1024 * 1024,\n })\n if (list.status !== 0) throw new SourceError(`${tarball} is not a readable tar.gz archive`)\n const entries = list.stdout.split('\\n').filter(Boolean)\n if (entries.length > LIMITS.files)\n throw new SourceError(`the template has more than ${LIMITS.files} files`)\n for (const entry of entries)\n if (entry.startsWith('/') || entry.split('/').includes('..'))\n throw new SourceError(`the archive holds a path that leaves its folder: ${entry}`)\n mkdirSync(dir, { recursive: true })\n const run = spawnSync('tar', ['-xzf', tarball, '-C', dir, '--strip-components=1'], {\n encoding: 'utf8',\n })\n if (run.status !== 0) throw new SourceError(`could not unpack ${tarball}: ${run.stderr.trim()}`)\n let bytes = 0\n const walk = (folder: string) => {\n for (const entry of readdirSync(folder)) {\n const path = join(folder, entry)\n const info = lstatSync(path)\n if (info.isSymbolicLink())\n throw new SourceError(\n `the template holds a symbolic link (${path.slice(dir.length + 1)}); links are not allowed`,\n )\n if (info.isDirectory()) walk(path)\n else bytes += info.size\n }\n }\n walk(dir)\n if (bytes > LIMITS.bytes)\n throw new SourceError(`the template is larger than ${LIMITS.bytes / 1024 / 1024} MB`)\n}\n\n/** Download or pack a source and unpack it into `dir` (which must not exist yet). Nothing in it is run. */\nexport async function fetchSource(\n source: Source,\n dir: string,\n scratch: string,\n fetchers: Fetchers,\n): Promise<void> {\n mkdirSync(scratch, { recursive: true })\n let tarball: string\n if (source.kind === 'tarball') tarball = source.path\n else if (source.kind === 'npm') tarball = fetchers.pack(source.spec, scratch)\n else {\n tarball = join(scratch, 'source.tar.gz')\n writeFileSync(\n tarball,\n await fetchers.download(\n `https://codeload.github.com/${source.owner}/${source.repo}/tar.gz/${source.ref ?? 'HEAD'}`,\n ),\n )\n }\n extract(tarball, dir)\n}\n\n/** Read and check `acryl.template.json`; a source without it is not a template. */\nexport function readManifest(dir: string): Manifest {\n const file = join(dir, TEMPLATE_MANIFEST)\n if (!existsSync(file))\n throw new SourceError(\n `this source has no ${TEMPLATE_MANIFEST}, so it is not a template: add one with a name and a description (see the create-acrylblends guide)`,\n )\n let data: unknown\n try {\n data = JSON.parse(readFileSync(file, 'utf8'))\n } catch {\n throw new SourceError(`${TEMPLATE_MANIFEST} is not valid JSON`)\n }\n const m = data as Record<string, unknown>\n if (typeof m.name !== 'string' || m.name.trim() === '')\n throw new SourceError(`${TEMPLATE_MANIFEST} needs a \"name\"`)\n if (typeof m.description !== 'string')\n throw new SourceError(`${TEMPLATE_MANIFEST} needs a \"description\"`)\n const plugins = m.plugins ?? []\n if (\n !Array.isArray(plugins) ||\n plugins.some((p) => typeof p !== 'string' || !/^[a-z][a-z0-9-]*$/.test(p))\n )\n throw new SourceError(\n `\"plugins\" in ${TEMPLATE_MANIFEST} is a list of plugin names such as \"desktop\"`,\n )\n return { name: m.name, description: m.description, plugins: plugins as string[] }\n}\n\nconst SKIP = new Set(['.git', 'node_modules', TEMPLATE_MANIFEST])\n/** Lifecycle scripts npm runs on `npm install` in the app's own folder. */\nexport const LIFECYCLE = [\n 'preinstall',\n 'install',\n 'postinstall',\n 'prepublish',\n 'preprepare',\n 'prepare',\n 'postprepare',\n]\n\nconst isText = (buffer: Buffer) => !buffer.subarray(0, 8000).includes(0)\n\n/**\n * Copy the unpacked template into `target`, replacing the placeholders of the built-in templates, naming the app, and pointing a dependency on the framework at\n * the release this package carries. Returns the files written (relative paths) and the lifecycle scripts the app's package.json defines.\n */\nexport function writeTemplate(\n from: string,\n target: string,\n stamp: (text: string) => string,\n range: string,\n name: string,\n): { files: string[]; lifecycle: Record<string, string> } {\n const files: string[] = []\n const walk = (src: string, dst: string, prefix: string) => {\n mkdirSync(dst, { recursive: true })\n for (const entry of readdirSync(src, { withFileTypes: true })) {\n if (SKIP.has(entry.name)) continue\n const outName = prefix === '' && entry.name === 'gitignore' ? '.gitignore' : entry.name\n if (entry.isDirectory())\n walk(join(src, entry.name), join(dst, outName), `${prefix}${entry.name}/`)\n else {\n const buffer = readFileSync(join(src, entry.name))\n writeFileSync(join(dst, outName), isText(buffer) ? stamp(buffer.toString('utf8')) : buffer)\n files.push(`${prefix}${outName}`)\n }\n }\n }\n walk(from, target, '')\n const lifecycle: Record<string, string> = {}\n const pkgFile = join(target, 'package.json')\n if (existsSync(pkgFile)) {\n const pkg = JSON.parse(readFileSync(pkgFile, 'utf8')) as {\n name?: string\n scripts?: Record<string, string>\n dependencies?: Record<string, string>\n devDependencies?: Record<string, string>\n }\n pkg.name = name\n for (const group of [pkg.dependencies, pkg.devDependencies])\n if (group?.[PACKAGE] !== undefined) group[PACKAGE] = range\n writeFileSync(pkgFile, `${JSON.stringify(pkg, null, 2)}\\n`)\n for (const script of LIFECYCLE)\n if (typeof pkg.scripts?.[script] === 'string') lifecycle[script] = pkg.scripts[script]\n }\n return { files, lifecycle }\n}\n\n/** Remove a folder tree quietly. */\nexport const removeTree = (path: string) => rmSync(path, { recursive: true, force: true })\nexport { cpSync }\n","import { existsSync } from 'node:fs'\nimport { dirname, join } from 'node:path'\n\nexport interface Invocation {\n file: string\n args: string[]\n}\n\n/**\n * How to start a package manager without the shell option (Node warns about passing args to a shell, DEP0190, and a `.cmd` shim cannot be spawned directly).\n * Off Windows the command runs as it is. On Windows npm runs as `node npm-cli.js` (the one npm is running from, else the one beside `node`); any other\n * manager goes through `cmd.exe /d /s /c <name>.cmd`, whose arguments stay an array.\n */\nexport function packageManagerInvocation(\n command: string,\n args: readonly string[],\n platform: NodeJS.Platform = process.platform,\n env: NodeJS.ProcessEnv = process.env,\n exists: (path: string) => boolean = existsSync,\n execPath: string = process.execPath,\n): Invocation {\n if (platform !== 'win32') return { file: command, args: [...args] }\n if (command === 'npm') {\n const running = env.npm_execpath\n const cli =\n running !== undefined && /npm-cli\\.c?js$/.test(running)\n ? running\n : join(dirname(execPath), 'node_modules', 'npm', 'bin', 'npm-cli.js')\n if (exists(cli)) return { file: execPath, args: [cli, ...args] }\n }\n return { file: env.ComSpec ?? 'cmd.exe', args: ['/d', '/s', '/c', `${command}.cmd`, ...args] }\n}\n","import { spawn } from 'node:child_process'\nimport {\n copyFileSync,\n cpSync,\n existsSync,\n mkdirSync,\n mkdtempSync,\n readdirSync,\n readFileSync,\n writeFileSync,\n} from 'node:fs'\nimport { createRequire } from 'node:module'\nimport { tmpdir } from 'node:os'\nimport { basename, dirname, join, resolve } from 'node:path'\nimport { createInterface } from 'node:readline/promises'\nimport { fileURLToPath } from 'node:url'\nimport { parseArgs } from 'node:util'\nimport { findSecrets } from '@webboxes/app-persistence'\nimport { CLASS, CREATE, PACKAGE, TEMPLATE_MANIFEST } from './names'\nimport { defaultsSection, pluginsSection, skillText, writeSelfKnowledge } from './self-knowledge'\nimport {\n type Fetchers,\n fetchSource,\n LIFECYCLE,\n parseSource,\n readManifest,\n realFetchers,\n removeTree,\n SOURCE_FORMS,\n SourceError,\n writeTemplate,\n} from './source'\nimport { packageManagerInvocation } from './spawn'\n\nexport { CLASS, CREATE, PACKAGE, TEMPLATE_MANIFEST }\n\nexport const TEMPLATES = ['nodejs', 'notes', 'chat', 'bun', 'acryl-app'] as const\nexport type Template = (typeof TEMPLATES)[number]\nexport const PACKAGE_MANAGERS = ['npm', 'pnpm', 'yarn', 'bun'] as const\nexport type PackageManager = (typeof PACKAGE_MANAGERS)[number]\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 = `${CREATE} ${VERSION} - create an ${CLASS} app\n\nUsage:\n npm create ${PACKAGE}@latest [directory] [source] [-- options]\n\nA source makes the app from someone else's template (it is downloaded and unpacked, nothing in it runs):\n github:owner/repo[#ref] a GitHub repository, as a tarball (no clone)\n @scope/name[@version] an npm package (npm pack --ignore-scripts)\n ./template.tgz a packed template on disk\nA template is a folder with an ${TEMPLATE_MANIFEST} (name, description, plugins).\n\nOptions:\n --template <name> nodejs, notes, chat, bun (experimental), acryl-app (asked when not given)\n --install install the dependencies after creating the app (the lifecycle scripts it will run are listed first)\n --pm <manager> ${PACKAGE_MANAGERS.join(', ')} (default: the one that ran this command, else npm)\n -y, --yes ask nothing: template nodejs unless --template is given, directory ${PACKAGE}-app\n -h, --help show this help\n -v, --version show the version\n`\n\n/** A command line mistake. The command prints it with the help text and exits 2. */\nexport class UsageError extends Error {\n override name = 'UsageError'\n}\n\nexport interface Io {\n stdout: { write(text: string): unknown }\n stderr: { write(text: string): unknown }\n cwd: string\n env: Record<string, string | undefined>\n /** Ask one question; `undefined` when there is no terminal to ask on. */\n ask: ((question: string) => Promise<string>) | undefined\n /** Run a program, showing its output; resolves to the exit code. */\n run(command: string, args: string[], cwd: string): Promise<number>\n /** How a template source is fetched; the real network and npm by default. */\n fetchers?: Fetchers\n}\n\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 env: process.env,\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 run: (command, args, cwd) =>\n new Promise((done) => {\n const invocation = packageManagerInvocation(command, args)\n const child = spawn(invocation.file, invocation.args, { cwd, stdio: 'inherit' })\n child.on('error', () => done(1))\n child.on('exit', (code) => done(code ?? 1))\n }),\n }\n}\n\nexport interface CreateOptions {\n directory: string | undefined\n template: Template | undefined\n install: boolean\n pm: PackageManager | undefined\n yes: boolean\n /** `github:owner/repo[#ref]`, `@scope/name` or a packed `.tgz`: a template from outside this package. */\n source: string | undefined\n}\n\nexport function isTemplate(value: string): value is Template {\n return (TEMPLATES as readonly string[]).includes(value)\n}\n\nexport function parseCreateOptions(argv: readonly string[]): CreateOptions {\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 > 2)\n throw new UsageError('takes a directory and at most one template source')\n if (positionals[1] !== undefined && values.template !== undefined)\n throw new UsageError('give a template source or --template, not both')\n if (values.template !== undefined && !isTemplate(values.template))\n throw new UsageError(`unknown template \"${values.template}\" (${TEMPLATES.join(', ')})`)\n if (values.pm !== undefined && !(PACKAGE_MANAGERS as readonly string[]).includes(values.pm))\n throw new UsageError(`unknown package manager \"${values.pm}\" (${PACKAGE_MANAGERS.join(', ')})`)\n return {\n directory: positionals[0],\n template: values.template as Template | undefined,\n install: values.install === true,\n pm: values.pm as PackageManager | undefined,\n yes: values.yes === true,\n source: positionals[1],\n }\n}\n\nconst parse = (argv: readonly string[]) =>\n parseArgs({\n args: [...argv],\n allowPositionals: true,\n strict: true,\n options: {\n template: { type: 'string' },\n install: { type: 'boolean' },\n pm: { type: 'string' },\n yes: { type: 'boolean', short: 'y' },\n },\n })\n\n/** A valid package name from a directory name: lower case letters, digits and dashes. */\nexport function nameFrom(directory: string): string {\n const name = basename(resolve(directory))\n .toLowerCase()\n .replace(/[^a-z0-9-]+/g, '-')\n .replace(/^[^a-z]+/, '')\n .replace(/-+$/g, '')\n return name === '' ? 'acryl-app' : name\n}\n\nfunction walkUp(from: string, test: (dir: string) => string | undefined): string {\n let dir = from\n for (;;) {\n const found = test(dir)\n if (found) return found\n const parent = dirname(dir)\n if (parent === dir) throw new Error(`${CREATE} cannot find its files`)\n dir = parent\n }\n}\nconst here = dirname(fileURLToPath(import.meta.url))\nconst templatesRoot = () =>\n walkUp(here, (d) =>\n existsSync(join(d, 'templates', 'nodejs')) ? join(d, 'templates') : undefined,\n )\n/** The framework docs: the copy `prepack` puts in the package, or `docs/framework` of the repository. */\nconst docsRoot = () =>\n walkUp(here, (d) =>\n existsSync(join(d, 'docs', 'framework', 'README.md'))\n ? join(d, 'docs', 'framework')\n : undefined,\n )\n\n/**\n * The range a created app asks for: the framework version this package was released with, so a new app depends on the release that made it (and gets what that release's\n * commands can do), never an older one. A caret range, so it also takes the newer patch releases.\n */\nexport function frameworkRange(): string {\n const file = createRequire(import.meta.url).resolve(`${PACKAGE}/package.json`)\n return `^${(JSON.parse(readFileSync(file, 'utf8')) as { version: string }).version}`\n}\n\nexport function replacePlaceholders(text: string, name: string): string {\n return text\n .replaceAll('__APP_NAME__', name)\n .replaceAll('__PACKAGE__', PACKAGE)\n .replaceAll('__CLASS__', CLASS)\n .replaceAll('__RANGE__', frameworkRange())\n}\n\n/** The guide for a coding agent in a created app: where the API is, how to run it, what must pass. */\nexport function agentsText(template: Exclude<Template, 'acryl-app'>, name: string): string {\n const run = {\n nodejs: 'npm run dev',\n notes: 'npm run dev',\n chat: 'npm run dev',\n bun: 'bun run dev',\n }[template]\n const desktopNote =\n template === 'nodejs' || template === 'notes' || template === 'chat'\n ? `\\nTo run it as a desktop window: \\`npx ${PACKAGE} add desktop\\`, \\`npm install\\`, then \\`npm run desktop\\` (see \\`docs/framework/getting-started/desktop.md\\`).`\n : ''\n const test = {\n nodejs: 'npm test` and `npm run check',\n notes: 'npm test` and `npm run check',\n chat: 'npm test` and `npm run check',\n bun: 'bun test` and `bun run check',\n }[template]\n const jsxNote =\n template === 'nodejs' || template === 'notes' || template === 'chat'\n ? 'Write pages in `.tsx` (see `src/' +\n (template === 'notes' ? 'views.tsx' : 'page.tsx') +\n \"`): the scripts in `package.json` run Node.js with `--import acrylblends/node-server/register`, which compiles `.tsx` with this app's own `typescript`, and `tsconfig.json` sets `jsx: react-jsx` with `jsxImportSource: acrylblends/jsx`. Render a component with `.toString()` and return it with `c.html(...)`. A command that starts the app without those scripts (a bare `node src/index.ts`) cannot load a `.tsx` file. Without a build step you can write the call JSX compiles to instead: `jsx('h1', { class: 'title' }, 'Hello')` from `'acrylblends/jsx'`, children after the props. See `docs/framework/guides/jsx.md`.\"\n : \"Bun compiles `.tsx` itself: write pages in `.tsx`, render a component with `.toString()` and return it with `c.html(...)`. `jsx('h1', { class: 'title' }, 'Hello')` from `'acrylblends/jsx'` (children after the props) is the same thing without JSX syntax. See `docs/framework/guides/jsx.md`.\"\n const clientNote =\n template === 'nodejs'\n ? `- **Client components** (run in the browser) live in \\`src/client/\\`, which has its own \\`tsconfig.json\\` (DOM types, no Node types); \\`clientModules\\` in \\`src/app.ts\\` compiles them when the browser asks, and \\`npm run build\\` compiles them once for production. See \\`src/client/counter.tsx\\` and \\`docs/framework/guides/client-modules.md\\`.\\n`\n : ''\n const chatStructure =\n template === 'chat'\n ? `\n## Structure (a chat app: a streamed answer, history in a database)\n\n- **The dependency rule:** only \\`src/db.ts\\` (the \\`opener\\` in \\`package.json\\`) opens the database. Every other file takes a \\`Db\\` (\\`import type { Db } from '${PACKAGE}/db'\\`) as an argument and never imports \\`node:sqlite\\`, \\`pg\\`, another driver or \\`${PACKAGE}/db/sqlite\\`. \\`npm test\\` and \\`npm run check\\` run \\`${PACKAGE} check-deps\\`, which names the file and line of a violation; do not move the \\`opener\\` entry to silence it.\n- \\`src/llm.ts\\`: \\`Llm\\`, what the app needs from a model (messages in, pieces out, an aborted signal stops the work), and \\`openAiCompatible\\`, which calls an OpenAI-compatible chat completions API with \\`stream: true\\`. The base URL is \\`DEEPSEEK_BASE_URL\\` (default \\`https://api.deepseek.com\\`), the model \\`DEEPSEEK_MODEL\\` (default \\`deepseek-chat\\`), the key **only** the environment variable \\`DEEPSEEK_API_KEY\\`, read at the moment of the call: never write it to a file, a response or a log.\n- \\`src/db.ts\\`: \\`openChatDb()\\` (the \\`db\\` port on a SQLite file, \\`data/chat.sqlite\\` or \\`$CHAT_DB\\`, with \\`migrations/\\` applied on start; it returns \\`{ db, close }\\`) and \\`chatStore(db)\\`. The routes only call \\`chatStore\\`; keep SQL out of them. Every \\`db\\` call returns a promise: \\`await\\` it. The shape of the database is \\`migrations/NNN-name.sql\\`: to change it add the next numbered file and never edit one that has run. See \\`docs/framework/guides/data.md\\`.\n- \\`src/app.ts\\` opens the database (top-level \\`await\\`) and exports the app and \\`close\\`; \\`src/index.ts\\` serves it and closes the database on SIGTERM. \\`src/chat-app.ts\\`: \\`createApp(db, llm)\\`. \\`POST /api/chat\\` answers Server-Sent Events: \\`meta\\` (the conversation id), a \\`token\\` per piece, then \\`done\\` or \\`error\\`. The request's signal (\\`c.req.raw.signal\\`) goes to the model call, so a closed tab or the Stop button stops the request to the model; what had arrived is kept.\n- \\`src/client/chat.tsx\\`: the client component (own \\`tsconfig.json\\`, browser types): sends the message with \\`fetch\\`, reads the events as they arrive, shows the answer growing, and aborts on Stop. \\`clientModules\\` compiles it when the browser asks; \\`npm run build\\` compiles it once into \\`dist/client\\`. See \\`docs/framework/guides/client-modules.md\\`.\n- \\`test/chat.test.ts\\` tests every route with a mock \\`Llm\\` (never the network); keep it that way. \\`test/server.test.ts\\` starts the real server and stops it with a signal.\n- To try it with a real model: \\`DEEPSEEK_API_KEY=... npm run dev\\`.\n\n## Before you ship\n\nRead \\`docs/framework/getting-started/deploy.md\\`. In short: \\`npm ci --omit=dev\\`, \\`npm run build\\`, \\`NODE_ENV=production npm start\\`; the app listens on \\`127.0.0.1\\` (\\`HOST=0.0.0.0\\` only in a container); the SQLite file goes outside the code folder (\\`CHAT_DB=/var/lib/chat/chat.sqlite\\`) and is backed up; the model key is an environment variable of the service (a root-only environment file for systemd), never a file in the repository. Anyone who can reach the app can spend your key: put it behind a login or on a private network before it is public.\n`\n : ''\n const notesStructure =\n template === 'notes'\n ? `\n## Structure (a notes app: accounts, sessions, a database)\n\n- \\`src/db.ts\\`: \\`openNotesDb()\\` (the \\`db\\` port on a SQLite file, \\`data/notes.sqlite\\` or \\`$NOTES_DB\\`, with \\`migrations/\\` applied on start; it returns \\`{ db, close }\\`) and \\`notesStore(db)\\`, the queries for notes. Every \\`db\\` call returns a promise: \\`await\\` it. Use \\`?\\` bindings, never string-built SQL. See \\`docs/framework/guides/data.md\\`.\n- \\`migrations/\\`: the shape of the database, one numbered file per change (\\`001-notes.sql\\`). A file that has run is never edited; a change is the next file (\\`002-name.sql\\`).\n- **The dependency rule:** only \\`src/db.ts\\` (the \\`opener\\` in \\`package.json\\`) opens the database. Every other file takes a \\`Db\\` (\\`import type { Db } from '${PACKAGE}/db'\\`) as an argument and never imports \\`node:sqlite\\`, \\`pg\\`, another driver or \\`${PACKAGE}/db/sqlite\\`. \\`npm test\\` and \\`npm run check\\` run \\`${PACKAGE} check-deps\\`, which names the file and line of a violation; do not move the \\`opener\\` entry to silence it.\n- \\`src/auth.ts\\`: scrypt password hashes (\\`node:crypto\\`) and the \\`sessions\\` table; the cookie \\`sid\\` holds a random token.\n- \\`src/schema.ts\\`: the rules for a note and for credentials. The HTML forms and the JSON API both use \\`checkNote\\`.\n- \\`src/views.tsx\\`: the pages, as JSX components rendered to strings, and the small script for the instant filter.\n- \\`src/client/\\`: client components, with their own \\`tsconfig.json\\` (browser types). \\`counter.tsx\\` is the live character counter. \\`clientModules\\` in \\`notes-app.ts\\` compiles them when the browser asks; \\`npm run build\\` compiles them once into \\`dist/client\\` for production. See \\`docs/framework/guides/client-modules.md\\`.\n- \\`src/notes-app.ts\\`: \\`createApp(db)\\` (pages and forms, csrf on) and \\`createApi(db)\\` (the JSON API under \\`/api/notes\\`, chained so \\`testClient\\` is typed). \\`src/app.ts\\` opens the database (top-level \\`await\\`) and exports the app and \\`close\\`; \\`src/index.ts\\` serves it and closes the database on SIGTERM. Tests open \\`openNotesDb(':memory:')\\` and pass its \\`db\\` to \\`createApp\\`.\n- \\`test/notes.test.ts\\`: a test for every route. A form POST in a test needs \\`origin: 'http://localhost'\\` (csrf) and the \\`sid\\` cookie from sign up.\n- Forms answer an invalid input with status 400 and the same page with the messages; a successful POST redirects with 303.\n- To add a column or a table: write the next migration (\\`migrations/002-name.sql\\`), then change \\`notesStore\\`, \\`checkNote\\`, the form and the list in \\`views.tsx\\`, and the tests. Do not edit \\`001-notes.sql\\`.\n\n## Before you ship\n\nRead \\`docs/framework/getting-started/deploy.md\\`. In short:\n\n- Install with \\`npm ci --omit=dev\\`, run \\`npm run build\\` (it compiles \\`src/client\\` once; with \\`NODE_ENV=production\\` only \\`dist/client\\` is served), and start with \\`NODE_ENV=production npm start\\` (\\`typescript\\` stays a runtime dependency: it compiles the \\`.tsx\\` pages at start).\n- The app listens on \\`127.0.0.1\\`; set \\`HOST=0.0.0.0\\` only in a container. \\`PORT\\` chooses the port.\n- Put the SQLite file outside the code folder (\\`NOTES_DB=/var/lib/notes/notes.sqlite\\`) and back it up.\n- Behind an HTTPS reverse proxy set \\`TRUST_PROXY=1\\` and \\`PUBLIC_ORIGIN=https://your.site\\`, or the cookie is not \\`Secure\\` and csrf refuses form posts.\n- \\`npm test\\` includes a test that starts the server and stops it with SIGTERM; keep it passing if you change \\`src/index.ts\\`.\n`\n : ''\n return `# ${name}\n\nAn ${CLASS} app (${template}${template === 'bun' ? ', experimental' : ''}): handlers over the Web Standard \\`Request\\` and \\`Response\\`, from the \\`${PACKAGE}\\` package.\n\n## The framework's API is in \\`docs/framework/\\`\n\nStart at \\`docs/framework/README.md\\`; \\`api/summary.md\\` is the one-page summary. Import the class from \\`'${PACKAGE}'\\` and each middleware or helper from its own\nsubpath (\\`'${PACKAGE}/cors'\\`, \\`'${PACKAGE}/validator'\\`, ...). Parts marked \"not yet available\" in the docs are not in the package yet.\n\n## This app\n\nRun it with \\`${run}\\`. The routes are in \\`${template === 'bun' ? 'src/index.ts' : template === 'notes' ? 'src/notes-app.ts' : template === 'chat' ? 'src/chat-app.ts' : 'src/app.ts'}\\`; an app is a function from \\`Request\\` to \\`Response\\`,\nso test a route with \\`await app.request('/path')\\` and no server.${desktopNote}\n\n${notesStructure}${chatStructure}\n${defaultsSection(template, PACKAGE)}\n${pluginsSection(PACKAGE)}\n## Things that surprise people\n\n- A page mounted at \\`/x\\` answers \\`/x\\`, not \\`/x/\\` (trailing slashes are strict); \\`trimTrailingSlash()\\` redirects.\n- A \\`json\\` validator target reads the body only with a JSON \\`Content-Type\\`; a failure answers 400 with \\`{ error, issues: [{ message, path }] }\\`.\n- \\`throw new HTTPException(404, { message })\\` answers an error response (plain text).\n- \\`testClient(app)\\` from \\`'${PACKAGE}/testing'\\` types only routes chained on the \\`new ${CLASS}()\\` expression (\\`new ${CLASS}().get(...).post(...)\\`); headers such as a cookie go in the second argument of each call.\n- **JSX:** ${jsxNote}\n${clientNote}\n## Before you say you are done\n\n\\`${test}\\` pass.\n`\n}\n\nfunction copyDocs(target: string): void {\n const filter = (path: string) => !/(upstream\\.json|UPSTREAM\\.md)$/.test(path)\n mkdirSync(join(target, 'docs'), { recursive: true })\n cpSync(docsRoot(), join(target, 'docs', 'framework'), { recursive: true, filter })\n}\n\nfunction copyTemplate(\n template: Exclude<Template, 'acryl-app'>,\n target: string,\n name: string,\n): string[] {\n const written: string[] = []\n const walk = (from: string, to: string, prefix: string) => {\n mkdirSync(to, { recursive: true })\n for (const entry of readdirSync(from, { withFileTypes: true })) {\n const targetName = prefix === '' && entry.name === 'gitignore' ? '.gitignore' : entry.name\n if (entry.isDirectory())\n walk(join(from, entry.name), join(to, targetName), `${prefix}${entry.name}/`)\n else {\n writeFileSync(\n join(to, targetName),\n replacePlaceholders(readFileSync(join(from, entry.name), 'utf8'), name),\n )\n written.push(`${prefix}${targetName}`)\n }\n }\n }\n walk(join(templatesRoot(), template), target, '')\n written.push(\n ...writeSelfKnowledge(target, agentsText(template, name), skillText(name, template, PACKAGE)),\n )\n copyDocs(target)\n return written\n}\n\nconst isEmpty = (directory: string) => !existsSync(directory) || readdirSync(directory).length === 0\n\n/** The `acrylblends` command of the installed framework package, which creates the `acryl-app` template. */\nfunction acrylblendsBin(): string {\n const pkgFile = createRequire(import.meta.url).resolve(`${PACKAGE}/package.json`)\n const pkg = JSON.parse(readFileSync(pkgFile, 'utf8')) as { bin?: string | Record<string, string> }\n const bin = typeof pkg.bin === 'string' ? pkg.bin : pkg.bin?.[PACKAGE]\n if (!bin) throw new Error(`${PACKAGE} has no command to create an app with`)\n return join(dirname(pkgFile), bin)\n}\n\n/** The lifecycle scripts a template defines and the line that says when they run. */\nconst describeScripts = (scripts: Record<string, string>) =>\n Object.entries(scripts)\n .map(([key, value]) => ` ${key}: ${value}`)\n .join('\\n')\n\n/** Files whose text is checked for secrets: the template's own, not the framework docs copied in. */\nfunction textFiles(root: string): { path: string; text: string }[] {\n const found: { path: string; text: string }[] = []\n const walk = (dir: string, prefix: string) => {\n for (const entry of readdirSync(dir, { withFileTypes: true })) {\n if (\n entry.name === 'node_modules' ||\n entry.name === '.git' ||\n (prefix === '' && entry.name === 'docs')\n )\n continue\n if (entry.isDirectory()) walk(join(dir, entry.name), `${prefix}${entry.name}/`)\n else {\n const buffer = readFileSync(join(dir, entry.name))\n if (!buffer.subarray(0, 8000).includes(0))\n found.push({ path: `${prefix}${entry.name}`, text: buffer.toString('utf8') })\n }\n }\n }\n walk(root, '')\n return found\n}\n\n/**\n * Create an app from a template source (`github:`, `@scope/name`, a packed tarball). The source is fetched and unpacked into a scratch folder, checked\n * (manifest, secrets), and only then copied to the target; nothing in it is installed or run unless `--install`, which lists the scripts first.\n */\nasync function createFromSource(\n options: CreateOptions,\n target: string,\n directory: string,\n io: Io,\n): Promise<number> {\n if (!isEmpty(target)) {\n io.stderr.write(`error: ${target} is not empty; nothing was changed\\n`)\n return 1\n }\n const scratch = mkdtempSync(join(tmpdir(), 'create-acrylblends-'))\n try {\n const source = parseSource(options.source!, io.cwd)\n if (!source)\n throw new UsageError(`unknown template source \"${options.source}\" (${SOURCE_FORMS})`)\n const name = nameFrom(target)\n await fetchSource(\n source,\n join(scratch, 'source'),\n join(scratch, 'download'),\n io.fetchers ?? realFetchers,\n )\n const manifest = readManifest(join(scratch, 'source'))\n const staged = join(scratch, 'app')\n const { files, lifecycle } = writeTemplate(\n join(scratch, 'source'),\n staged,\n (text) => replacePlaceholders(text, name),\n frameworkRange(),\n name,\n )\n if (!existsSync(join(staged, 'AGENTS.md')))\n writeFileSync(\n join(staged, 'AGENTS.md'),\n `# ${name}\\n\\nAn ${CLASS} app made from the template \"${manifest.name}\": ${manifest.description}\\n\\nThe framework's API is in \\`docs/framework/\\` (start at \\`docs/framework/README.md\\`).\\n`,\n )\n if (!existsSync(join(staged, 'CLAUDE.md')))\n copyFileSync(join(staged, 'AGENTS.md'), join(staged, 'CLAUDE.md'))\n const found = findSecrets(textFiles(staged))\n if (found.length > 0) {\n io.stderr.write(\n `error: the template holds what looks like a secret, so nothing was created:\\n${found.map((f) => ` ${f.path}:${f.line} (${f.kind})`).join('\\n')}\\n`,\n )\n return 1\n }\n copyDocs(staged)\n cpSync(staged, target, { recursive: true })\n io.stdout.write(\n `created ${name} from ${manifest.name} (${manifest.description}) in ${target}: ${files.length} files, ${CLASS} docs in docs/framework\\n`,\n )\n if (manifest.plugins.length > 0)\n io.stdout.write(\n `it needs these plugins: ${manifest.plugins.join(', ')}; add them with: npx ${PACKAGE} add ${manifest.plugins.join(' ')}\\n`,\n )\n const pm: PackageManager =\n options.pm ??\n ((PACKAGE_MANAGERS as readonly string[]).find((m) =>\n (io.env.npm_config_user_agent ?? '').startsWith(`${m}/`),\n ) as PackageManager | undefined) ??\n 'npm'\n const hasScripts = Object.keys(lifecycle).length > 0\n if (options.install) {\n const pkg = JSON.parse(readFileSync(join(target, 'package.json'), 'utf8')) as {\n dependencies?: object\n devDependencies?: object\n }\n io.stdout.write(\n `running ${pm} install in ${directory}. This installs: ${[...Object.keys(pkg.dependencies ?? {}), ...Object.keys(pkg.devDependencies ?? {})].join(', ') || 'nothing'}` +\n `${hasScripts ? `\\nand runs the template's own lifecycle scripts:\\n${describeScripts(lifecycle)}` : ''}\\n` +\n `(the dependencies' install scripts run too unless your ${pm} is set to ignore them)\\n`,\n )\n if ((await io.run(pm, ['install'], target)) !== 0) {\n io.stderr.write(`error: ${pm} install failed; run it yourself in ${directory}\\n`)\n return 1\n }\n } else if (hasScripts) {\n io.stdout.write(\n `nothing was installed or run. The template defines ${LIFECYCLE.filter((k) => lifecycle[k]).join(', ')}, which ${pm} install would run:\\n${describeScripts(lifecycle)}\\nread them first, or pass --install to run them.\\n`,\n )\n }\n io.stdout.write(\n `\\nNext:\\n cd ${directory}\\n${options.install ? '' : ` ${pm} install\\n`} see the template's README or package.json scripts\\n`,\n )\n return 0\n } catch (error) {\n if (error instanceof SourceError) {\n io.stderr.write(`error: ${error.message}\\nnothing was changed\\n`)\n return 1\n }\n throw error\n } finally {\n removeTree(scratch)\n }\n}\n\n/** Create the app. Returns the exit code: 0 done, 1 refused or failed, 2 a usage error. Never calls `process.exit`. */\nexport async function runCreate(argv: readonly string[], io: Io = processIo()): Promise<number> {\n try {\n if (argv.includes('-h') || argv.includes('--help')) {\n io.stdout.write(HELP)\n return 0\n }\n if (argv.includes('-v') || argv.includes('--version')) {\n io.stdout.write(`${VERSION}\\n`)\n return 0\n }\n const options = parseCreateOptions(argv)\n const ask = options.yes ? undefined : io.ask\n const directory =\n options.directory ??\n (ask\n ? (await ask(`Project directory (${PACKAGE}-app): `)).trim() || `${PACKAGE}-app`\n : `${PACKAGE}-app`)\n const target = resolve(io.cwd, directory)\n if (options.source !== undefined) return await createFromSource(options, target, directory, io)\n const template: Template =\n options.template ??\n (ask\n ? await (async () => {\n const answer =\n (\n await ask(\n `Which template do you want to use? (nodejs, notes, chat, bun (experimental), acryl-app) [nodejs]: `,\n )\n ).trim() || 'nodejs'\n if (!isTemplate(answer))\n throw new UsageError(`unknown template \"${answer}\" (${TEMPLATES.join(', ')})`)\n return answer\n })()\n : 'nodejs')\n if (!isEmpty(target)) {\n io.stderr.write(`error: ${target} is not empty; nothing was changed\\n`)\n return 1\n }\n const name = nameFrom(target)\n if (template === 'acryl-app') {\n const code = await io.run(\n process.execPath,\n [acrylblendsBin(), 'init', target, '--template', 'agent', '--name', name, '--yes'],\n io.cwd,\n )\n if (code !== 0) return 1\n } else {\n const files = copyTemplate(template, target, name)\n io.stdout.write(\n `created ${name} (${template}) in ${target}: ${files.length} files, ${CLASS} docs in docs/framework\\n`,\n )\n }\n const pm: PackageManager =\n options.pm ??\n ((PACKAGE_MANAGERS as readonly string[]).find((m) =>\n (io.env.npm_config_user_agent ?? '').startsWith(`${m}/`),\n ) as PackageManager | undefined) ??\n 'npm'\n if (options.install) {\n if ((await io.run(pm, ['install'], target)) !== 0) {\n io.stderr.write(`error: ${pm} install failed; run it yourself in ${directory}\\n`)\n return 1\n }\n }\n const start = {\n nodejs: `${pm} run dev`,\n notes: `${pm} run dev`,\n chat: `${pm} run dev`,\n bun: 'bun run dev',\n 'acryl-app': `${pm} run dev`,\n }[template]\n io.stdout.write(\n `\\nNext:\\n cd ${directory}\\n${options.install ? '' : ` ${pm} install\\n`} ${start}\\n`,\n )\n return 0\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 as Error).message}\\n`)\n return 1\n }\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"index.js","names":[],"sources":["../src/names.ts","../src/source.ts","../src/spawn.ts","../src/index.ts"],"sourcesContent":["/**\n * The one place this package names the framework. The templates are written with `__PACKAGE__` and `__RANGE__` (the range is stamped at create time from the framework version this package carries, see `frameworkRange`), and the text of `AGENTS.md` with\n * `__PACKAGE__`, so a rename (for example to `acryl`) is a change here and in `scripts/lib/names.mjs`, which a test keeps equal.\n */\nexport const PACKAGE = 'acrylblends'\nexport const CLASS = 'Acryl'\nexport const CREATE = 'create-acrylblends'\n\n/** The file that makes a folder a template other people can create apps from (`${CREATE} <name> github:owner/repo`). */\nexport const TEMPLATE_MANIFEST = 'acryl.template.json'\n","/**\n * Templates from outside this package: `github:owner/repo[#ref]`, a scoped npm package (`@scope/name[@version]`) or a packed tarball on disk.\n * A source is only ever downloaded and unpacked: no git clone (hooks), no lifecycle script (`npm pack --ignore-scripts`), nothing of it is run.\n */\nimport { spawnSync } from 'node:child_process'\nimport {\n cpSync,\n existsSync,\n lstatSync,\n mkdirSync,\n readdirSync,\n readFileSync,\n rmSync,\n writeFileSync,\n} from 'node:fs'\nimport { join, resolve } from 'node:path'\nimport { PACKAGE, TEMPLATE_MANIFEST } from './names'\n\nexport type Source =\n | { kind: 'github'; owner: string; repo: string; ref: string | undefined }\n | { kind: 'npm'; spec: string }\n | { kind: 'tarball'; path: string }\n\n/** What a template says about itself in `acryl.template.json`. */\nexport interface Manifest {\n name: string\n description: string\n /** Library plugins the template needs, added with `acrylblends add`. */\n plugins: string[]\n}\n\n/** A source that cannot be used; the message says why and is shown as it is. */\nexport class SourceError extends Error {\n override name = 'SourceError'\n}\n\nexport const SOURCE_FORMS = `github:owner/repo[#ref], @scope/name[@version], or a packed .tgz file`\n\nconst LIMITS = { files: 5000, bytes: 50 * 1024 * 1024 }\n\n/** Recognise a source argument, or return `undefined` when it is not one (so the caller can report a usage error). */\nexport function parseSource(text: string, cwd: string): Source | undefined {\n const github = /^github:([A-Za-z0-9_.-]+)\\/([A-Za-z0-9_.-]+)(?:#([A-Za-z0-9_./-]+))?$/.exec(text)\n if (github) return { kind: 'github', owner: github[1]!, repo: github[2]!, ref: github[3] }\n if (text.startsWith('github:')) throw new SourceError(`\"${text}\" is not github:owner/repo[#ref]`)\n if (/^@[a-z0-9][a-z0-9._-]*\\/[a-z0-9][a-z0-9._-]*(@[A-Za-z0-9._-]+)?$/.test(text))\n return { kind: 'npm', spec: text }\n if (text.startsWith('@')) throw new SourceError(`\"${text}\" is not @scope/name[@version]`)\n if (/\\.(tgz|tar\\.gz)$/.test(text)) {\n const path = resolve(cwd, text)\n if (!existsSync(path)) throw new SourceError(`${path} does not exist`)\n return { kind: 'tarball', path }\n }\n return undefined\n}\n\n/** How the bytes of a source are obtained; real by default, replaced in tests. */\nexport interface Fetchers {\n /** The body at a URL (a GitHub tarball). */\n download(url: string): Promise<Uint8Array>\n /** `npm pack <spec> --ignore-scripts` into `dest`; the path of the tarball. */\n pack(spec: string, dest: string): string\n}\n\nexport const realFetchers: Fetchers = {\n async download(url) {\n const response = await fetch(url, { redirect: 'follow' })\n if (!response.ok) throw new SourceError(`${url} answered ${response.status}`)\n return new Uint8Array(await response.arrayBuffer())\n },\n pack(spec, dest) {\n const result = spawnSync(\n 'npm',\n ['pack', spec, '--ignore-scripts', '--json', '--pack-destination', dest],\n {\n encoding: 'utf8',\n shell: false,\n env: { ...process.env, npm_config_ignore_scripts: 'true' },\n },\n )\n if (result.status !== 0)\n throw new SourceError(\n `npm could not pack ${spec}: ${(result.stderr || result.stdout).trim().split('\\n').at(-1)}`,\n )\n const file = (JSON.parse(result.stdout) as { filename: string }[])[0]?.filename\n if (!file) throw new SourceError(`npm packed nothing for ${spec}`)\n return join(dest, file)\n },\n}\n\n/** Unpack a tarball into `dir`, dropping its single top folder; refuses links, paths that leave the folder, and archives that are too big. */\nfunction extract(tarball: string, dir: string): void {\n const list = spawnSync('tar', ['-tzf', tarball], {\n encoding: 'utf8',\n maxBuffer: 64 * 1024 * 1024,\n })\n if (list.status !== 0) throw new SourceError(`${tarball} is not a readable tar.gz archive`)\n const entries = list.stdout.split('\\n').filter(Boolean)\n if (entries.length > LIMITS.files)\n throw new SourceError(`the template has more than ${LIMITS.files} files`)\n for (const entry of entries)\n if (entry.startsWith('/') || entry.split('/').includes('..'))\n throw new SourceError(`the archive holds a path that leaves its folder: ${entry}`)\n mkdirSync(dir, { recursive: true })\n const run = spawnSync('tar', ['-xzf', tarball, '-C', dir, '--strip-components=1'], {\n encoding: 'utf8',\n })\n if (run.status !== 0) throw new SourceError(`could not unpack ${tarball}: ${run.stderr.trim()}`)\n let bytes = 0\n const walk = (folder: string) => {\n for (const entry of readdirSync(folder)) {\n const path = join(folder, entry)\n const info = lstatSync(path)\n if (info.isSymbolicLink())\n throw new SourceError(\n `the template holds a symbolic link (${path.slice(dir.length + 1)}); links are not allowed`,\n )\n if (info.isDirectory()) walk(path)\n else bytes += info.size\n }\n }\n walk(dir)\n if (bytes > LIMITS.bytes)\n throw new SourceError(`the template is larger than ${LIMITS.bytes / 1024 / 1024} MB`)\n}\n\n/** Download or pack a source and unpack it into `dir` (which must not exist yet). Nothing in it is run. */\nexport async function fetchSource(\n source: Source,\n dir: string,\n scratch: string,\n fetchers: Fetchers,\n): Promise<void> {\n mkdirSync(scratch, { recursive: true })\n let tarball: string\n if (source.kind === 'tarball') tarball = source.path\n else if (source.kind === 'npm') tarball = fetchers.pack(source.spec, scratch)\n else {\n tarball = join(scratch, 'source.tar.gz')\n writeFileSync(\n tarball,\n await fetchers.download(\n `https://codeload.github.com/${source.owner}/${source.repo}/tar.gz/${source.ref ?? 'HEAD'}`,\n ),\n )\n }\n extract(tarball, dir)\n}\n\n/** Read and check `acryl.template.json`; a source without it is not a template. */\nexport function readManifest(dir: string): Manifest {\n const file = join(dir, TEMPLATE_MANIFEST)\n if (!existsSync(file))\n throw new SourceError(\n `this source has no ${TEMPLATE_MANIFEST}, so it is not a template: add one with a name and a description (see the create-acrylblends guide)`,\n )\n let data: unknown\n try {\n data = JSON.parse(readFileSync(file, 'utf8'))\n } catch {\n throw new SourceError(`${TEMPLATE_MANIFEST} is not valid JSON`)\n }\n const m = data as Record<string, unknown>\n if (typeof m.name !== 'string' || m.name.trim() === '')\n throw new SourceError(`${TEMPLATE_MANIFEST} needs a \"name\"`)\n if (typeof m.description !== 'string')\n throw new SourceError(`${TEMPLATE_MANIFEST} needs a \"description\"`)\n const plugins = m.plugins ?? []\n if (\n !Array.isArray(plugins) ||\n plugins.some((p) => typeof p !== 'string' || !/^[a-z][a-z0-9-]*$/.test(p))\n )\n throw new SourceError(\n `\"plugins\" in ${TEMPLATE_MANIFEST} is a list of plugin names such as \"desktop\"`,\n )\n return { name: m.name, description: m.description, plugins: plugins as string[] }\n}\n\nconst SKIP = new Set(['.git', 'node_modules', TEMPLATE_MANIFEST])\n/** Lifecycle scripts npm runs on `npm install` in the app's own folder. */\nexport const LIFECYCLE = [\n 'preinstall',\n 'install',\n 'postinstall',\n 'prepublish',\n 'preprepare',\n 'prepare',\n 'postprepare',\n]\n\nconst isText = (buffer: Buffer) => !buffer.subarray(0, 8000).includes(0)\n\n/**\n * Copy the unpacked template into `target`, replacing the placeholders of the built-in templates, naming the app, and pointing a dependency on the framework at\n * the release this package carries. Returns the files written (relative paths) and the lifecycle scripts the app's package.json defines.\n */\nexport function writeTemplate(\n from: string,\n target: string,\n stamp: (text: string) => string,\n range: string,\n name: string,\n): { files: string[]; lifecycle: Record<string, string> } {\n const files: string[] = []\n const walk = (src: string, dst: string, prefix: string) => {\n mkdirSync(dst, { recursive: true })\n for (const entry of readdirSync(src, { withFileTypes: true })) {\n if (SKIP.has(entry.name)) continue\n const outName = prefix === '' && entry.name === 'gitignore' ? '.gitignore' : entry.name\n if (entry.isDirectory())\n walk(join(src, entry.name), join(dst, outName), `${prefix}${entry.name}/`)\n else {\n const buffer = readFileSync(join(src, entry.name))\n writeFileSync(join(dst, outName), isText(buffer) ? stamp(buffer.toString('utf8')) : buffer)\n files.push(`${prefix}${outName}`)\n }\n }\n }\n walk(from, target, '')\n const lifecycle: Record<string, string> = {}\n const pkgFile = join(target, 'package.json')\n if (existsSync(pkgFile)) {\n const pkg = JSON.parse(readFileSync(pkgFile, 'utf8')) as {\n name?: string\n scripts?: Record<string, string>\n dependencies?: Record<string, string>\n devDependencies?: Record<string, string>\n }\n pkg.name = name\n for (const group of [pkg.dependencies, pkg.devDependencies])\n if (group?.[PACKAGE] !== undefined) group[PACKAGE] = range\n writeFileSync(pkgFile, `${JSON.stringify(pkg, null, 2)}\\n`)\n for (const script of LIFECYCLE)\n if (typeof pkg.scripts?.[script] === 'string') lifecycle[script] = pkg.scripts[script]\n }\n return { files, lifecycle }\n}\n\n/** Remove a folder tree quietly. */\nexport const removeTree = (path: string) => rmSync(path, { recursive: true, force: true })\nexport { cpSync }\n","import { existsSync } from 'node:fs'\nimport { dirname, join } from 'node:path'\n\nexport interface Invocation {\n file: string\n args: string[]\n}\n\n/**\n * How to start a package manager without the shell option (Node warns about passing args to a shell, DEP0190, and a `.cmd` shim cannot be spawned directly).\n * Off Windows the command runs as it is. On Windows npm runs as `node npm-cli.js` (the one npm is running from, else the one beside `node`); any other\n * manager goes through `cmd.exe /d /s /c <name>.cmd`, whose arguments stay an array.\n */\nexport function packageManagerInvocation(\n command: string,\n args: readonly string[],\n platform: NodeJS.Platform = process.platform,\n env: NodeJS.ProcessEnv = process.env,\n exists: (path: string) => boolean = existsSync,\n execPath: string = process.execPath,\n): Invocation {\n if (platform !== 'win32') return { file: command, args: [...args] }\n if (command === 'npm') {\n const running = env.npm_execpath\n const cli =\n running !== undefined && /npm-cli\\.c?js$/.test(running)\n ? running\n : join(dirname(execPath), 'node_modules', 'npm', 'bin', 'npm-cli.js')\n if (exists(cli)) return { file: execPath, args: [cli, ...args] }\n }\n return { file: env.ComSpec ?? 'cmd.exe', args: ['/d', '/s', '/c', `${command}.cmd`, ...args] }\n}\n","import { spawn } from 'node:child_process'\nimport {\n copyFileSync,\n cpSync,\n existsSync,\n mkdirSync,\n mkdtempSync,\n readdirSync,\n readFileSync,\n writeFileSync,\n} from 'node:fs'\nimport { createRequire } from 'node:module'\nimport { tmpdir } from 'node:os'\nimport { basename, dirname, join, resolve } from 'node:path'\nimport { createInterface } from 'node:readline/promises'\nimport { fileURLToPath } from 'node:url'\nimport { parseArgs } from 'node:util'\nimport { findSecrets } from '@webboxes/app-persistence'\nimport { CLASS, CREATE, PACKAGE, TEMPLATE_MANIFEST } from './names'\nimport {\n type Fetchers,\n fetchSource,\n LIFECYCLE,\n parseSource,\n readManifest,\n realFetchers,\n removeTree,\n SOURCE_FORMS,\n SourceError,\n writeTemplate,\n} from './source'\nimport { packageManagerInvocation } from './spawn'\n\nexport { CLASS, CREATE, PACKAGE, TEMPLATE_MANIFEST }\n\nexport const TEMPLATES = ['nodejs', 'notes', 'chat', 'acryl-app'] as const\nexport type Template = (typeof TEMPLATES)[number]\nexport const PACKAGE_MANAGERS = ['npm', 'pnpm', 'yarn', 'bun'] as const\nexport type PackageManager = (typeof PACKAGE_MANAGERS)[number]\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 = `${CREATE} ${VERSION} - create an ${CLASS} app\n\nUsage:\n npm create ${PACKAGE}@latest [directory] [template | source] [-- options]\n\nA source makes the app from someone else's template (it is downloaded and unpacked, nothing in it runs):\n github:owner/repo[#ref] a GitHub repository, as a tarball (no clone)\n @scope/name[@version] an npm package (npm pack --ignore-scripts)\n ./template.tgz a packed template on disk\nA template is a folder with an ${TEMPLATE_MANIFEST} (name, description, plugins).\n\nOptions:\n --template <name> nodejs, notes, chat, acryl-app (asked when not given); a bare name after the directory means the same\n (npm create ${PACKAGE}@latest my-app notes). Every template is a Cordis app: blend.yaml, plugins/\n --install install the dependencies after creating the app (the lifecycle scripts it will run are listed first)\n --pm <manager> ${PACKAGE_MANAGERS.join(', ')} (default: the one that ran this command, else npm)\n -y, --yes ask nothing: template nodejs unless --template is given, directory ${PACKAGE}-app\n -h, --help show this help\n -v, --version show the version\n`\n\n/** A command line mistake. The command prints it with the help text and exits 2. */\nexport class UsageError extends Error {\n override name = 'UsageError'\n}\n\nexport interface Io {\n stdout: { write(text: string): unknown }\n stderr: { write(text: string): unknown }\n cwd: string\n env: Record<string, string | undefined>\n /** Ask one question; `undefined` when there is no terminal to ask on. */\n ask: ((question: string) => Promise<string>) | undefined\n /** Run a program, showing its output; resolves to the exit code. */\n run(command: string, args: string[], cwd: string): Promise<number>\n /** How a template source is fetched; the real network and npm by default. */\n fetchers?: Fetchers\n}\n\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 env: process.env,\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 run: (command, args, cwd) =>\n new Promise((done) => {\n const invocation = packageManagerInvocation(command, args)\n const child = spawn(invocation.file, invocation.args, { cwd, stdio: 'inherit' })\n child.on('error', () => done(1))\n child.on('exit', (code) => done(code ?? 1))\n }),\n }\n}\n\nexport interface CreateOptions {\n directory: string | undefined\n template: Template | undefined\n install: boolean\n pm: PackageManager | undefined\n yes: boolean\n /** `github:owner/repo[#ref]`, `@scope/name` or a packed `.tgz`: a template from outside this package. */\n source: string | undefined\n}\n\nexport function isTemplate(value: string): value is Template {\n return (TEMPLATES as readonly string[]).includes(value)\n}\n\nexport function parseCreateOptions(argv: readonly string[]): CreateOptions {\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 > 2)\n throw new UsageError('takes a directory and at most one template source')\n // A bare name that is a built-in template means --template: `create my-app notes`. Only github:, @scope/ and .tgz are sources.\n const bare =\n positionals[1] !== undefined && isTemplate(positionals[1]) ? positionals[1] : undefined\n if (positionals[1] !== undefined && values.template !== undefined)\n throw new UsageError('give a template (or a template source) or --template, not both')\n if (values.template !== undefined && !isTemplate(values.template))\n throw new UsageError(`unknown template \"${values.template}\" (${TEMPLATES.join(', ')})`)\n if (values.pm !== undefined && !(PACKAGE_MANAGERS as readonly string[]).includes(values.pm))\n throw new UsageError(`unknown package manager \"${values.pm}\" (${PACKAGE_MANAGERS.join(', ')})`)\n return {\n directory: positionals[0],\n template: (bare ?? values.template) as Template | undefined,\n install: values.install === true,\n pm: values.pm as PackageManager | undefined,\n yes: values.yes === true,\n source: bare === undefined ? positionals[1] : undefined,\n }\n}\n\nconst parse = (argv: readonly string[]) =>\n parseArgs({\n args: [...argv],\n allowPositionals: true,\n strict: true,\n options: {\n template: { type: 'string' },\n install: { type: 'boolean' },\n pm: { type: 'string' },\n yes: { type: 'boolean', short: 'y' },\n },\n })\n\n/** A valid package name from a directory name: lower case letters, digits and dashes. */\nexport function nameFrom(directory: string): string {\n const name = basename(resolve(directory))\n .toLowerCase()\n .replace(/[^a-z0-9-]+/g, '-')\n .replace(/^[^a-z]+/, '')\n .replace(/-+$/g, '')\n return name === '' ? 'acryl-app' : name\n}\n\nfunction walkUp(from: string, test: (dir: string) => string | undefined): string {\n let dir = from\n for (;;) {\n const found = test(dir)\n if (found) return found\n const parent = dirname(dir)\n if (parent === dir) throw new Error(`${CREATE} cannot find its files`)\n dir = parent\n }\n}\nconst here = dirname(fileURLToPath(import.meta.url))\n/** The framework docs: the copy `prepack` puts in the package, or `docs/framework` of the repository. */\nconst docsRoot = () =>\n walkUp(here, (d) =>\n existsSync(join(d, 'docs', 'framework', 'README.md'))\n ? join(d, 'docs', 'framework')\n : undefined,\n )\n\n/**\n * The range a created app asks for: the framework version this package was released with, so a new app depends on the release that made it (and gets what that release's\n * commands can do), never an older one. A caret range, so it also takes the newer patch releases.\n */\nexport function frameworkRange(): string {\n const file = createRequire(import.meta.url).resolve(`${PACKAGE}/package.json`)\n return `^${(JSON.parse(readFileSync(file, 'utf8')) as { version: string }).version}`\n}\n\nexport function replacePlaceholders(text: string, name: string): string {\n return text\n .replaceAll('__APP_NAME__', name)\n .replaceAll('__PACKAGE__', PACKAGE)\n .replaceAll('__CLASS__', CLASS)\n .replaceAll('__RANGE__', frameworkRange())\n}\n\nfunction copyDocs(target: string): void {\n const filter = (path: string) => !/(upstream\\.json|UPSTREAM\\.md)$/.test(path)\n mkdirSync(join(target, 'docs'), { recursive: true })\n cpSync(docsRoot(), join(target, 'docs', 'framework'), { recursive: true, filter })\n}\n\nconst isEmpty = (directory: string) => !existsSync(directory) || readdirSync(directory).length === 0\n\n/** The `acrylblends` command of the installed framework package, which creates every template. */\nfunction acrylblendsBin(): string {\n const pkgFile = createRequire(import.meta.url).resolve(`${PACKAGE}/package.json`)\n const pkg = JSON.parse(readFileSync(pkgFile, 'utf8')) as { bin?: string | Record<string, string> }\n const bin = typeof pkg.bin === 'string' ? pkg.bin : pkg.bin?.[PACKAGE]\n if (!bin) throw new Error(`${PACKAGE} has no command to create an app with`)\n return join(dirname(pkgFile), bin)\n}\n\n/** The lifecycle scripts a template defines and the line that says when they run. */\nconst describeScripts = (scripts: Record<string, string>) =>\n Object.entries(scripts)\n .map(([key, value]) => ` ${key}: ${value}`)\n .join('\\n')\n\n/** Files whose text is checked for secrets: the template's own, not the framework docs copied in. */\nfunction textFiles(root: string): { path: string; text: string }[] {\n const found: { path: string; text: string }[] = []\n const walk = (dir: string, prefix: string) => {\n for (const entry of readdirSync(dir, { withFileTypes: true })) {\n if (\n entry.name === 'node_modules' ||\n entry.name === '.git' ||\n (prefix === '' && entry.name === 'docs')\n )\n continue\n if (entry.isDirectory()) walk(join(dir, entry.name), `${prefix}${entry.name}/`)\n else {\n const buffer = readFileSync(join(dir, entry.name))\n if (!buffer.subarray(0, 8000).includes(0))\n found.push({ path: `${prefix}${entry.name}`, text: buffer.toString('utf8') })\n }\n }\n }\n walk(root, '')\n return found\n}\n\n/**\n * Create an app from a template source (`github:`, `@scope/name`, a packed tarball). The source is fetched and unpacked into a scratch folder, checked\n * (manifest, secrets), and only then copied to the target; nothing in it is installed or run unless `--install`, which lists the scripts first.\n */\nasync function createFromSource(\n options: CreateOptions,\n target: string,\n directory: string,\n io: Io,\n): Promise<number> {\n if (!isEmpty(target)) {\n io.stderr.write(`error: ${target} is not empty; nothing was changed\\n`)\n return 1\n }\n const scratch = mkdtempSync(join(tmpdir(), 'create-acrylblends-'))\n try {\n const source = parseSource(options.source!, io.cwd)\n if (!source)\n throw new UsageError(`unknown template source \"${options.source}\" (${SOURCE_FORMS})`)\n const name = nameFrom(target)\n await fetchSource(\n source,\n join(scratch, 'source'),\n join(scratch, 'download'),\n io.fetchers ?? realFetchers,\n )\n const manifest = readManifest(join(scratch, 'source'))\n const staged = join(scratch, 'app')\n const { files, lifecycle } = writeTemplate(\n join(scratch, 'source'),\n staged,\n (text) => replacePlaceholders(text, name),\n frameworkRange(),\n name,\n )\n if (!existsSync(join(staged, 'AGENTS.md')))\n writeFileSync(\n join(staged, 'AGENTS.md'),\n `# ${name}\\n\\nAn ${CLASS} app made from the template \"${manifest.name}\": ${manifest.description}\\n\\nThe framework's API is in \\`docs/framework/\\` (start at \\`docs/framework/README.md\\`).\\n`,\n )\n if (!existsSync(join(staged, 'CLAUDE.md')))\n copyFileSync(join(staged, 'AGENTS.md'), join(staged, 'CLAUDE.md'))\n const found = findSecrets(textFiles(staged))\n if (found.length > 0) {\n io.stderr.write(\n `error: the template holds what looks like a secret, so nothing was created:\\n${found.map((f) => ` ${f.path}:${f.line} (${f.kind})`).join('\\n')}\\n`,\n )\n return 1\n }\n copyDocs(staged)\n cpSync(staged, target, { recursive: true })\n io.stdout.write(\n `created ${name} from ${manifest.name} (${manifest.description}) in ${target}: ${files.length} files, ${CLASS} docs in docs/framework\\n`,\n )\n if (manifest.plugins.length > 0)\n io.stdout.write(\n `it needs these plugins: ${manifest.plugins.join(', ')}; add them with: npx ${PACKAGE} add ${manifest.plugins.join(' ')}\\n`,\n )\n const pm: PackageManager =\n options.pm ??\n ((PACKAGE_MANAGERS as readonly string[]).find((m) =>\n (io.env.npm_config_user_agent ?? '').startsWith(`${m}/`),\n ) as PackageManager | undefined) ??\n 'npm'\n const hasScripts = Object.keys(lifecycle).length > 0\n if (options.install) {\n const pkg = JSON.parse(readFileSync(join(target, 'package.json'), 'utf8')) as {\n dependencies?: object\n devDependencies?: object\n }\n io.stdout.write(\n `running ${pm} install in ${directory}. This installs: ${[...Object.keys(pkg.dependencies ?? {}), ...Object.keys(pkg.devDependencies ?? {})].join(', ') || 'nothing'}` +\n `${hasScripts ? `\\nand runs the template's own lifecycle scripts:\\n${describeScripts(lifecycle)}` : ''}\\n` +\n `(the dependencies' install scripts run too unless your ${pm} is set to ignore them)\\n`,\n )\n if ((await io.run(pm, ['install'], target)) !== 0) {\n io.stderr.write(`error: ${pm} install failed; run it yourself in ${directory}\\n`)\n return 1\n }\n } else if (hasScripts) {\n io.stdout.write(\n `nothing was installed or run. The template defines ${LIFECYCLE.filter((k) => lifecycle[k]).join(', ')}, which ${pm} install would run:\\n${describeScripts(lifecycle)}\\nread them first, or pass --install to run them.\\n`,\n )\n }\n io.stdout.write(\n `\\nNext:\\n cd ${directory}\\n${options.install ? '' : ` ${pm} install\\n`} see the template's README or package.json scripts\\n`,\n )\n return 0\n } catch (error) {\n if (error instanceof SourceError) {\n io.stderr.write(`error: ${error.message}\\nnothing was changed\\n`)\n return 1\n }\n throw error\n } finally {\n removeTree(scratch)\n }\n}\n\n/** Create the app. Returns the exit code: 0 done, 1 refused or failed, 2 a usage error. Never calls `process.exit`. */\nexport async function runCreate(argv: readonly string[], io: Io = processIo()): Promise<number> {\n try {\n if (argv.includes('-h') || argv.includes('--help')) {\n io.stdout.write(HELP)\n return 0\n }\n if (argv.includes('-v') || argv.includes('--version')) {\n io.stdout.write(`${VERSION}\\n`)\n return 0\n }\n const options = parseCreateOptions(argv)\n const ask = options.yes ? undefined : io.ask\n const directory =\n options.directory ??\n (ask\n ? (await ask(`Project directory (${PACKAGE}-app): `)).trim() || `${PACKAGE}-app`\n : `${PACKAGE}-app`)\n const target = resolve(io.cwd, directory)\n if (options.source !== undefined) return await createFromSource(options, target, directory, io)\n const template: Template =\n options.template ??\n (ask\n ? await (async () => {\n const answer =\n (\n await ask(\n `Which template do you want to use? (nodejs, notes, chat, acryl-app) [nodejs]: `,\n )\n ).trim() || 'nodejs'\n if (!isTemplate(answer))\n throw new UsageError(`unknown template \"${answer}\" (${TEMPLATES.join(', ')})`)\n return answer\n })()\n : 'nodejs')\n if (!isEmpty(target)) {\n io.stderr.write(`error: ${target} is not empty; nothing was changed\\n`)\n return 1\n }\n const name = nameFrom(target)\n // Every template is a Cordis app, made by the framework package's own `init` (blend.yaml, plugins/, AGENTS.md, CLAUDE.md, the skill, the docs).\n const code = await io.run(\n process.execPath,\n [\n acrylblendsBin(),\n 'init',\n target,\n '--template',\n template === 'acryl-app' ? 'agent' : template,\n '--name',\n name,\n '--yes',\n ],\n io.cwd,\n )\n if (code !== 0) return 1\n const pm: PackageManager =\n options.pm ??\n ((PACKAGE_MANAGERS as readonly string[]).find((m) =>\n (io.env.npm_config_user_agent ?? '').startsWith(`${m}/`),\n ) as PackageManager | undefined) ??\n 'npm'\n if (options.install) {\n if ((await io.run(pm, ['install'], target)) !== 0) {\n io.stderr.write(`error: ${pm} install failed; run it yourself in ${directory}\\n`)\n return 1\n }\n }\n const start = {\n nodejs: `${pm} run dev`,\n notes: `${pm} run dev`,\n chat: `${pm} run dev`,\n 'acryl-app': `${pm} run dev`,\n }[template]\n io.stdout.write(\n `\\nNext:\\n cd ${directory}\\n${options.install ? '' : ` ${pm} install\\n`} ${start}\\n`,\n )\n return 0\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 as Error).message}\\n`)\n return 1\n }\n}\n"],"mappings":"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"}
|
package/docs/framework/README.md
CHANGED
|
@@ -18,7 +18,7 @@ npm create acrylblends@latest my-app
|
|
|
18
18
|
```
|
|
19
19
|
|
|
20
20
|
Other package managers work the same way: `pnpm create acrylblends@latest`, `yarn create acrylblends`, `bun create acrylblends@latest`.
|
|
21
|
-
The starter asks which
|
|
21
|
+
Every template is a Cordis app (`blend.yaml`, plugins in `plugins/`). The starter asks which one you want (`nodejs`, `notes`, `chat`, or `acryl-app`, with an agent), and `npm create acrylblends@latest my-app notes` names it directly. See [Getting started](getting-started/basic.md).
|
|
22
22
|
|
|
23
23
|
## What is in the box
|
|
24
24
|
|
|
@@ -53,7 +53,7 @@ They are enabled as they are built.
|
|
|
53
53
|
| Run it on a hosting platform | [Other runtimes](getting-started/other-runtimes.md): [AWS Lambda](getting-started/aws-lambda.md), [Cloudflare Workers](getting-started/cloudflare-workers.md), [Vercel](getting-started/vercel.md), [Netlify](getting-started/netlify.md) |
|
|
54
54
|
| Look up a call | [API](api/index.md), [Routing](api/routing.md), [Context](api/context.md), [Request](api/request.md), [API summary](api/summary.md) |
|
|
55
55
|
| Understand the design | [Concepts](concepts/motivation.md) |
|
|
56
|
-
| Copy a pattern | [Guides](guides/best-practices.md), [Validation](guides/validation.md), [Testing](guides/testing.md), [Data, migrations and choosing a store](guides/data.md), [Forms, sessions and a database](guides/forms-and-sessions.md), [Client components without a bundler](guides/client-modules.md) |
|
|
56
|
+
| Copy a pattern | [Guides](guides/best-practices.md), [Validation](guides/validation.md), [Testing](guides/testing.md), [Data, migrations and choosing a store](guides/data.md), [Forms, sessions and a database](guides/forms-and-sessions.md), [Client components without a bundler](guides/client-modules.md), [Bring your own tool](guides/bring-your-own-tool.md) |
|
|
57
57
|
| Use Acryl inside a Cordis app | [Acryl in a Cordis app](cordis/acryl-in-a-cordis-app.md), [Plugin lifecycle](cordis/plugin-lifecycle.md), [Mounting](cordis/mounting.md) |
|
|
58
58
|
| Move from the 0.3 router calls | [Migration from 0.3](cordis/migration-from-0-3.md) |
|
|
59
59
|
| Move from the 0.4 names (`App`) | [Migration from 0.4](cordis/migration-from-0-4.md) |
|
|
@@ -1,3 +1,3 @@
|
|
|
1
1
|
# Generated copy
|
|
2
2
|
|
|
3
|
-
This folder is a copy of `docs/framework` of acryldev/acryl at commit `
|
|
3
|
+
This folder is a copy of `docs/framework` of acryldev/acryl at commit `20bdc263d6f0f8febbd967007bda4cf4a802efd2`, 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.
|
|
@@ -36,11 +36,10 @@ You are asked which template you want:
|
|
|
36
36
|
```
|
|
37
37
|
? Which template do you want to use?
|
|
38
38
|
❯ nodejs
|
|
39
|
-
bun (experimental)
|
|
40
39
|
acryl-app
|
|
41
40
|
```
|
|
42
41
|
|
|
43
|
-
|
|
42
|
+
Every template is a Cordis app: `blend.yaml` lists its plugins and every plugin is a folder in `plugins/`. `nodejs` is a web app with a page and a client component, `notes` and `chat` add a database, and `acryl-app` adds an agent that can extend it while it
|
|
44
43
|
runs (see [Acryl in a Cordis app](../cordis/acryl-in-a-cordis-app.md)). Pass `--template` to skip the question, see [create-acrylblends](../guides/create-acrylblends.md).
|
|
45
44
|
|
|
46
45
|
The template is created in `my-app`: go to it, install the dependencies and start the local server.
|
|
@@ -5,7 +5,7 @@ template) and a Blend app (the `acryl-app` template or `acrylblends init`). It r
|
|
|
5
5
|
|
|
6
6
|
## Add it
|
|
7
7
|
|
|
8
|
-
In an
|
|
8
|
+
In an app made by `npm create acrylblends@latest my-app nodejs` (or `notes`, `chat`):
|
|
9
9
|
|
|
10
10
|
```sh
|
|
11
11
|
cd my-app
|
|
@@ -0,0 +1,216 @@
|
|
|
1
|
+
# Bring your own tool: a provider of a port
|
|
2
|
+
|
|
3
|
+
Every choice in an app is a plugin behind a port, and what the app starts with is only a fallback. Any outside npm tool (a database, a store, a renderer, an auth library) joins the
|
|
4
|
+
app as another **provider** of the same port: a plugin that implements the port's interface on top of the tool and provides the service by its name. The code that uses the port
|
|
5
|
+
does not change. The port's **conformance suite** decides whether your provider is accepted, whoever wrote it. And because Cordis finds services by name, the app can swap the
|
|
6
|
+
provider **while it runs**: the plugins that use the port wait, and carry on when the new provider arrives. A person does it, or an agent working in the app folder, through the door.
|
|
7
|
+
|
|
8
|
+
This page does it once, from start to end, with a real tool: [lowdb](https://github.com/typicode/lowdb), a small JSON-file database, becomes a provider of the `kv` port ([Data](data.md#a-tiny-app-kv)).
|
|
9
|
+
Every step runs as written: the code on this page is extracted and run against a fresh app by `scripts/verify-byo-tool.mjs`.
|
|
10
|
+
|
|
11
|
+
You need an app with the `extensions` plugin, which installs plugins while the app runs: `npx acrylblends init my-app --template agent`, then `cd my-app` and `npm install`.
|
|
12
|
+
|
|
13
|
+
## 1. Bring the port, its suite and a way to run it
|
|
14
|
+
|
|
15
|
+
```sh
|
|
16
|
+
npx acrylblends add kv --suite
|
|
17
|
+
npm install
|
|
18
|
+
```
|
|
19
|
+
|
|
20
|
+
`add kv` copies the port (`plugins/acryl-kv`) and the JSON-file provider (`plugins/acryl-kv-json`) and gives your plugins the names `#acryl-kv` and `#acryl-kv-json` (entries in `package.json` "imports").
|
|
21
|
+
`--suite` also copies the port's conformance suite (`#acryl-kv/conformance`) and adds `vitest`, which runs it. The same works for the `db` port: `npx acrylblends add db --suite`.
|
|
22
|
+
|
|
23
|
+
## 2. Install the tool
|
|
24
|
+
|
|
25
|
+
```sh
|
|
26
|
+
npm install lowdb
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
## 3. Write the provider
|
|
30
|
+
|
|
31
|
+
A provider is a folder in `plugins/` with an `index.ts` that exports `name`, and `apply(ctx)` which provides the service. Keep the tool behind a plain function that returns the port's interface (`openKv`
|
|
32
|
+
here), so tests and plain code use it without Cordis, and let `apply` be a thin wrapper that provides it for as long as the plugin runs.
|
|
33
|
+
|
|
34
|
+
The port gives you the checks every provider must make alike (`checkKey`, `encodeValue`, `decodeValue`, `runChange`, `compareKeys`), so a bad call fails the same way on a file, on SQL and on your tool.
|
|
35
|
+
|
|
36
|
+
```ts no-check
|
|
37
|
+
// plugins/kv-lowdb/index.ts
|
|
38
|
+
import { join } from 'node:path'
|
|
39
|
+
import type { Context } from '@deepseek-ai/cordis'
|
|
40
|
+
import { checkKey, compareKeys, decodeValue, encodeValue, KV_SERVICE, runChange } from '#acryl-kv'
|
|
41
|
+
import type { Kv, KvOpened } from '#acryl-kv'
|
|
42
|
+
import { Low } from 'lowdb'
|
|
43
|
+
import { JSONFile } from 'lowdb/node'
|
|
44
|
+
|
|
45
|
+
/** The kv port on lowdb: one JSON file, written atomically by lowdb after every change. */
|
|
46
|
+
export async function openKv({ path }: { path: string }): Promise<KvOpened> {
|
|
47
|
+
const db = new Low<Record<string, unknown>>(new JSONFile(path), {})
|
|
48
|
+
await db.read()
|
|
49
|
+
// One call at a time, in order: that is what makes `update` atomic and lets `close` wait for the writes in flight.
|
|
50
|
+
let queue: Promise<unknown> = Promise.resolve()
|
|
51
|
+
let closed = false
|
|
52
|
+
const run = <T>(work: () => Promise<T>): Promise<T> => {
|
|
53
|
+
if (closed) return Promise.reject(new Error('the kv store is closed'))
|
|
54
|
+
const result = queue.then(work)
|
|
55
|
+
queue = result.catch(() => {})
|
|
56
|
+
return result
|
|
57
|
+
}
|
|
58
|
+
// A copy of the stored value, so changing what `get` returned changes nothing stored.
|
|
59
|
+
const copy = (key: string): unknown =>
|
|
60
|
+
key in db.data ? decodeValue(encodeValue(db.data[key])) : undefined
|
|
61
|
+
const kv: Kv = {
|
|
62
|
+
get: <T>(key: string) =>
|
|
63
|
+
run(async () => {
|
|
64
|
+
checkKey(key)
|
|
65
|
+
return copy(key) as T | undefined
|
|
66
|
+
}),
|
|
67
|
+
set: (key, value) =>
|
|
68
|
+
run(async () => {
|
|
69
|
+
checkKey(key)
|
|
70
|
+
db.data[key] = decodeValue(encodeValue(value))
|
|
71
|
+
await db.write()
|
|
72
|
+
}),
|
|
73
|
+
update: <T>(key: string, change: (current: T | undefined) => T) =>
|
|
74
|
+
run(async () => {
|
|
75
|
+
checkKey(key)
|
|
76
|
+
const next = runChange(change, copy(key) as T | undefined)
|
|
77
|
+
db.data[key] = decodeValue(encodeValue(next))
|
|
78
|
+
await db.write()
|
|
79
|
+
return copy(key) as T
|
|
80
|
+
}),
|
|
81
|
+
delete: (key) =>
|
|
82
|
+
run(async () => {
|
|
83
|
+
checkKey(key)
|
|
84
|
+
delete db.data[key]
|
|
85
|
+
await db.write()
|
|
86
|
+
}),
|
|
87
|
+
list: (prefix = '') =>
|
|
88
|
+
run(async () =>
|
|
89
|
+
Object.keys(db.data)
|
|
90
|
+
.filter((key) => key.startsWith(prefix))
|
|
91
|
+
.sort(compareKeys),
|
|
92
|
+
),
|
|
93
|
+
}
|
|
94
|
+
return {
|
|
95
|
+
kv,
|
|
96
|
+
async close() {
|
|
97
|
+
closed = true
|
|
98
|
+
await queue
|
|
99
|
+
},
|
|
100
|
+
}
|
|
101
|
+
}
|
|
102
|
+
|
|
103
|
+
export const name = 'kv-lowdb'
|
|
104
|
+
|
|
105
|
+
/** As a plugin: provide `kv` for as long as the plugin runs; the store closes after `kv` is withdrawn. */
|
|
106
|
+
export async function apply(ctx: Context, config: { path?: string } = {}): Promise<void> {
|
|
107
|
+
const file = config.path ?? join(ctx.appInstance.home, 'kv-lowdb.json')
|
|
108
|
+
await ctx.effect(async function* () {
|
|
109
|
+
const opened = await openKv({ path: file })
|
|
110
|
+
yield () => opened.close()
|
|
111
|
+
yield ctx.reflect.provide(KV_SERVICE, opened.kv)
|
|
112
|
+
}, `kv-lowdb: ${file}`)
|
|
113
|
+
}
|
|
114
|
+
```
|
|
115
|
+
|
|
116
|
+
(A block whose first line is a path comment is the file of that name.)
|
|
117
|
+
|
|
118
|
+
## 4. Pass the suite
|
|
119
|
+
|
|
120
|
+
The suite is the contract: it runs the same cases against every provider. A test gives it a fresh store for each case and a way to reopen the same storage.
|
|
121
|
+
|
|
122
|
+
```ts no-check
|
|
123
|
+
// test/kv-lowdb.spec.ts
|
|
124
|
+
import { mkdir, mkdtemp } from 'node:fs/promises'
|
|
125
|
+
import { join } from 'node:path'
|
|
126
|
+
import { describeKvConformance, type KvUnderTest } from '#acryl-kv/conformance'
|
|
127
|
+
import { openKv } from '../plugins/kv-lowdb/index.ts'
|
|
128
|
+
|
|
129
|
+
const underTest = async (path: string): Promise<KvUnderTest> => {
|
|
130
|
+
const opened = await openKv({ path })
|
|
131
|
+
return {
|
|
132
|
+
kv: opened.kv,
|
|
133
|
+
close: opened.close,
|
|
134
|
+
reopen: async () => {
|
|
135
|
+
await opened.close()
|
|
136
|
+
return underTest(path)
|
|
137
|
+
},
|
|
138
|
+
}
|
|
139
|
+
}
|
|
140
|
+
|
|
141
|
+
// A fresh file per case, in a folder of the project (a sandboxed agent may not write to the system temp folder).
|
|
142
|
+
describeKvConformance('kv-lowdb', async () => {
|
|
143
|
+
await mkdir('.acrylblends', { recursive: true })
|
|
144
|
+
return underTest(join(await mkdtemp(join('.acrylblends', 'kv-lowdb-')), 'kv.json'))
|
|
145
|
+
})
|
|
146
|
+
```
|
|
147
|
+
|
|
148
|
+
```sh
|
|
149
|
+
npx vitest run test/kv-lowdb.spec.ts
|
|
150
|
+
```
|
|
151
|
+
|
|
152
|
+
All the cases must pass. A failure names the rule that broke (`counts fifty concurrent updates to exactly fifty`, `keeps what was written across close and reopen`, ...): fix the provider, not the test.
|
|
153
|
+
|
|
154
|
+
## 5. Make the default swappable, and swap
|
|
155
|
+
|
|
156
|
+
A provider that the app's code mounts at start (a row of `blend.yaml`) is fixed until the next start. To swap while the app runs, install both the default and yours as plugins of the app. A one-line plugin
|
|
157
|
+
names the default:
|
|
158
|
+
|
|
159
|
+
```ts no-check
|
|
160
|
+
// plugins/kv/index.ts
|
|
161
|
+
export { apply, Config } from '#acryl-kv-json'
|
|
162
|
+
export const name = 'kv'
|
|
163
|
+
```
|
|
164
|
+
|
|
165
|
+
Start the app and open it in a browser (`npm run dev`). The door is the command `.acryl/bin/acryl` in the app folder:
|
|
166
|
+
|
|
167
|
+
```sh
|
|
168
|
+
.acryl/bin/acryl plugin add plugins/kv
|
|
169
|
+
```
|
|
170
|
+
|
|
171
|
+
Any plugin that declares `inject: ['kv']` now has a store. This one counts visits:
|
|
172
|
+
|
|
173
|
+
```ts no-check
|
|
174
|
+
// plugins/visits/index.ts
|
|
175
|
+
import type { Context } from '@deepseek-ai/cordis'
|
|
176
|
+
import { Acryl } from 'acrylblends'
|
|
177
|
+
import type {} from '#acryl-kv'
|
|
178
|
+
|
|
179
|
+
export const name = 'visits'
|
|
180
|
+
export const inject = ['router', 'kv']
|
|
181
|
+
|
|
182
|
+
/** GET /visits counts the visits in the kv store, whichever provider holds it. */
|
|
183
|
+
export function apply(ctx: Context): void {
|
|
184
|
+
ctx.router.route(
|
|
185
|
+
'/',
|
|
186
|
+
new Acryl().get('/visits', async (c) =>
|
|
187
|
+
c.json({ visits: await ctx.kv.update<number>('visits', (n) => (n ?? 0) + 1) }),
|
|
188
|
+
),
|
|
189
|
+
)
|
|
190
|
+
}
|
|
191
|
+
```
|
|
192
|
+
|
|
193
|
+
```sh
|
|
194
|
+
.acryl/bin/acryl plugin add plugins/visits
|
|
195
|
+
curl <the address npm run dev printed>/visits # {"visits":1}, then 2, then 3
|
|
196
|
+
```
|
|
197
|
+
|
|
198
|
+
Now swap. Two providers of one service cannot run together (the second is refused and nothing changes), so take the default out and put yours in:
|
|
199
|
+
|
|
200
|
+
```sh
|
|
201
|
+
.acryl/bin/acryl plugin remove kv
|
|
202
|
+
.acryl/bin/acryl plugin list # visits: pending, missing kv
|
|
203
|
+
.acryl/bin/acryl plugin add plugins/kv-lowdb
|
|
204
|
+
curl <the address>/visits # {"visits":1}: served again, by the same process
|
|
205
|
+
```
|
|
206
|
+
|
|
207
|
+
`visits` was never edited. While no provider existed its route was gone and its state was `pending`; the moment `kv-lowdb` provided `kv` it started again. The process did not restart, and the swap survives a
|
|
208
|
+
restart: the app remembers what was installed.
|
|
209
|
+
|
|
210
|
+
## What to know
|
|
211
|
+
|
|
212
|
+
- **Data does not move by itself.** The new store starts empty (the visits counted from 1 again). To carry it over, copy before you swap, in a script or a plugin: `copyKv(source, target)` from `#acryl-kv` copies one store into another.
|
|
213
|
+
- **A failed install changes nothing.** A provider that throws on start, or that cannot import something, is refused and the previous state stays. To go back: `plugin remove kv-lowdb`, then `plugin add plugins/kv`.
|
|
214
|
+
- **The suite checks the port, not your tool.** It cannot know that lowdb loses a write on a power cut. Read what the tool promises about durability before you trust it with more than a demo.
|
|
215
|
+
- **Other ports and tools work the same way.** `db`: `npx acrylblends add db --suite`, wrap a driver or an ORM behind `Db`, pass `describeDbConformance`. Keep the opener rule ([Data](data.md#why-the-database-is-opened-in-one-place)): only the file that mounts the provider imports the tool.
|
|
216
|
+
- **An agent can do all of it.** Give a coding agent in the app folder the page and one line: "wrap `<package>` as a provider of the `kv` port, pass its suite, and swap it in through the door". `AGENTS.md` in the app names the door.
|
|
@@ -7,13 +7,14 @@
|
|
|
7
7
|
|
|
8
8
|
| Template | What you get |
|
|
9
9
|
| --- | --- |
|
|
10
|
-
| `nodejs` |
|
|
10
|
+
| `nodejs` | a web app: routes, a server-rendered JSX page and a client component, mounted by the app's own plugin; run with Node.js 22.19 or newer |
|
|
11
11
|
| `notes` | a full-stack starter: accounts (scrypt, cookie session), notes in SQLite through the [`db` port](data.md) with numbered migrations, validated forms, search, a JSON API with a typed test client, csrf, a test for every route, a client-component counter |
|
|
12
12
|
| `chat` | an AI chat starter: the answer streams token by token from an OpenAI-compatible API (DeepSeek by default, key only from `DEEPSEEK_API_KEY`), a client component with a Stop button that also stops the request to the model, history in SQLite through the [`db` port](data.md), tests with a mock model |
|
|
13
|
-
| `bun` (experimental) | an Acryl application with `export default app`, run with `bun` |
|
|
14
13
|
| `acryl-app` | a Cordis app built from plugins, with an agent that can extend it while it runs (the same app `npx acrylblends init --template agent` creates) |
|
|
15
14
|
|
|
16
|
-
Every template
|
|
15
|
+
Every template is a Cordis app: `blend.yaml` lists the plugins that are mounted, every plugin is a folder in `plugins/`, and the app is started by `src/main.ts`. A bare template name after the directory is the same as `--template`: `npm create acrylblends@latest my-app notes`. `bun` is no longer a template; the framework still runs on Bun (see [Bun](../getting-started/bun.md)), but a new app is a Cordis app on Node.
|
|
16
|
+
|
|
17
|
+
Every template includes `AGENTS.md` and `CLAUDE.md` (the same text), one skill (`app-guide`) in `.claude/skills/` and `.agents/skills/`, and a copy of these docs in `docs/framework/`, so a coding agent working in the folder reads the
|
|
17
18
|
API from the folder.
|
|
18
19
|
|
|
19
20
|
## Passing arguments
|
|
@@ -50,7 +51,7 @@ bun create acrylblends@latest my-app --template nodejs
|
|
|
50
51
|
| :-- | :-- | :-- |
|
|
51
52
|
| `[directory]` | The folder to create. It must not exist or must be empty. Asked for when it is missing. | `my-app` |
|
|
52
53
|
| `[source]` | A template from outside the package: `github:owner/repo[#ref]`, `@scope/name[@version]` or a packed `.tgz` file. See [Templates from a repository or a package](#templates-from-a-repository-or-a-package). | `github:acme/starter` |
|
|
53
|
-
| `--template <template>` | One of `nodejs`, `notes`, `chat`, `
|
|
54
|
+
| `--template <template>` | One of `nodejs`, `notes`, `chat`, `acryl-app`. Skips the template question; a bare name after the directory means the same. | `--template notes` |
|
|
54
55
|
| `--install` | Install the dependencies with the package manager after creating the project. For a template from a source, the install scripts it will run are listed first. | `--install` |
|
|
55
56
|
| `--pm <packageManager>` | The package manager for `--install`: `npm`, `pnpm`, `yarn` or `bun`. Defaults to the one that started the initializer. | `--pm pnpm` |
|
|
56
57
|
| `--yes`, `-y` | Ask nothing: use `nodejs` unless `--template` is given, and the directory `acryl-app`. | `-y` |
|
|
@@ -10,6 +10,7 @@ interface; it is not part of `acrylblends` or the templates, and an app adds it
|
|
|
10
10
|
| The app | Use | State |
|
|
11
11
|
| --- | --- | --- |
|
|
12
12
|
| Normal web or desktop app, users, lists, orders | `db` with SQLite (the `notes` and `chat` templates) | available |
|
|
13
|
+
| SQLite is not enough, but no server | `db` with the optional `acryl-db-pglite` plugin: Postgres in the app's process, one folder in the app home | optional, not in `acrylblends` |
|
|
13
14
|
| Must use Postgres or Supabase | `db` with the optional `acryl-db-postgres` plugin | optional, not in `acrylblends` |
|
|
14
15
|
| Tiny, one person, a few screens | [`kv`](#a-tiny-app-kv), named JSON documents with no SQL | available |
|
|
15
16
|
|
|
@@ -190,7 +191,7 @@ await db.transaction(async (tx) => {
|
|
|
190
191
|
|
|
191
192
|
## Writing SQL that moves to Postgres
|
|
192
193
|
|
|
193
|
-
The optional Postgres
|
|
194
|
+
The optional Postgres plugins (`acryl-db-pglite` embedded, `acryl-db-postgres` on a server) serve the same interface. SQL that stays inside this list runs on both:
|
|
194
195
|
|
|
195
196
|
- Placeholders are `?` on every provider.
|
|
196
197
|
- Use `RETURNING` to get a new row, not a driver-specific "last id".
|
|
@@ -2,8 +2,8 @@
|
|
|
2
2
|
"source": {
|
|
3
3
|
"repo": "acryldev/acryl",
|
|
4
4
|
"path": "docs/framework",
|
|
5
|
-
"commit": "
|
|
5
|
+
"commit": "20bdc263d6f0f8febbd967007bda4cf4a802efd2"
|
|
6
6
|
},
|
|
7
|
-
"files":
|
|
8
|
-
"digest": "sha256:
|
|
7
|
+
"files": 100,
|
|
8
|
+
"digest": "sha256:ab5a055bc0bfb6c47ee6bb70c72ef6ec675ad070d790b58e601cd764591df788"
|
|
9
9
|
}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "create-acrylblends",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.3.0",
|
|
4
4
|
"description": "Create an Acryl app: npm create acrylblends@latest",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"type": "module",
|
|
@@ -19,7 +19,6 @@
|
|
|
19
19
|
"files": [
|
|
20
20
|
"bin",
|
|
21
21
|
"dist",
|
|
22
|
-
"templates",
|
|
23
22
|
"docs"
|
|
24
23
|
],
|
|
25
24
|
"engines": {
|
|
@@ -37,7 +36,7 @@
|
|
|
37
36
|
"scaffold"
|
|
38
37
|
],
|
|
39
38
|
"dependencies": {
|
|
40
|
-
"acrylblends": "^0.
|
|
39
|
+
"acrylblends": "^0.8.0",
|
|
41
40
|
"@webboxes/app-persistence": "0.1.1"
|
|
42
41
|
},
|
|
43
42
|
"publishConfig": {
|
package/templates/bun/gitignore
DELETED