@prestack/thread-ui 0.0.2 → 0.1.0

package/dist/ui/screens.js

@@ -1,16 +1,8 @@
-var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
-    if (typeof path === "string" && /^\.\.?\//.test(path)) {
-        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
-            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
-        });
-    }
-    return path;
-};
-import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
-import { basename, dirname, join } from 'node:path';
+import { existsSync, readFileSync, writeFileSync } from "@prestack/thread/core/files";
+import { basename, join } from 'node:path';
 import { argv, stdout } from 'node:process';
-import { pathToFileURL } from 'node:url';
 import { exit, invoked } from "@prestack/thread/core/invoked";
+import { valuesIn } from "@prestack/thread/core/rows";
 import { findTree, inTree } from "@prestack/thread/core/tree";
 import { HOME, settled, undeclared } from "./compositions.js";
 import { PRESENTATIONS } from "./door.js";
@@ -81,14 +73,14 @@ export const ${name} = screen('${row.id}', {}, () => (
 export function seeds(rows, held) {
     return rows.filter((row) => !held(row.at)).map((row) => ({ path: row.at, content: starter(row) }));
 }
-async function run() {
+function run() {
     const tree = findTree();
     const at = inTree(tree, 'screens.ts');
     if (!existsSync(at)) {
         stdout.write(`thread: this tree has no ${tree.name}/${basename(at)}, so it declares no screen and there is nothing to seed or check.\n`);
         return 0;
     }
-    const held = (await import(__rewriteRelativeImportExtension(pathToFileURL(at).href)));
+    const held = valuesIn(readFileSync(at));
     if (held.SCREEN === undefined) {
         stdout.write(`thread: ${tree.name}/screens.ts exports no \`SCREEN\`, so nothing declares a screen here.\n`);
         return 1;
@@ -104,12 +96,11 @@ async function run() {
     }
     if (!checking) {
         for (const one of made) {
-            mkdirSync(dirname(join(tree.at, one.path)), { recursive: true });
             writeFileSync(join(tree.at, one.path), one.content, 'utf8');
             stdout.write(`thread: seeded ${one.path}\n`);
         }
     }
-    const loose = [...(await undeclared(tree, rows)), ...settled(tree.at, rows, checking, 'thread screens', new Set())];
+    const loose = [...undeclared(tree, rows), ...settled(tree.at, rows, checking, 'thread screens', new Set())];
     for (const one of loose)
         stdout.write(`thread: ${one}\n`);
     stdout.write(`thread: ${String(rows.length)} screen(s) declared, ${String(made.length)} seeded, ` +
@@ -118,4 +109,4 @@ async function run() {
     return loose.length === 0 ? 0 : 1;
 }
 if (invoked(import.meta.url))
-    exit(await run());
+    exit(run());

package/dist/ui/screens.ts

@@ -1,9 +1,9 @@
-import { existsSync, mkdirSync, writeFileSync } from 'node:fs'
+import { existsSync, readFileSync, writeFileSync } from '@prestack/thread/core/files'
 import { basename, dirname, join } from 'node:path'
 import { argv, stdout } from 'node:process'
-import { pathToFileURL } from 'node:url'
 
 import { exit, invoked } from '@prestack/thread/core/invoked'
+import { valuesIn } from '@prestack/thread/core/rows'
 import type { Threaded } from '@prestack/thread/core/thread'
 import { findTree, inTree } from '@prestack/thread/core/tree'
 
@@ -93,14 +93,14 @@ export function seeds(rows: readonly Threaded[], held: (at: string) => boolean):
   return rows.filter((row) => !held(row.at)).map((row) => ({ path: row.at, content: starter(row) }))
 }
 
-async function run(): Promise<number> {
+function run(): number {
   const tree = findTree()
   const at = inTree(tree, 'screens.ts')
   if (!existsSync(at)) {
     stdout.write(`thread: this tree has no ${tree.name}/${basename(at)}, so it declares no screen and there is nothing to seed or check.\n`)
     return 0
   }
-  const held = (await import(pathToFileURL(at).href)) as { SCREEN?: { readonly declares?: readonly Threaded[] } }
+  const held = valuesIn(readFileSync(at)) as { SCREEN?: { readonly declares?: readonly Threaded[] } }
 
   if (held.SCREEN === undefined) {
     stdout.write(`thread: ${tree.name}/screens.ts exports no \`SCREEN\`, so nothing declares a screen here.\n`)
@@ -122,13 +122,12 @@ async function run(): Promise<number> {
 
   if (!checking) {
     for (const one of made) {
-      mkdirSync(dirname(join(tree.at, one.path)), { recursive: true })
       writeFileSync(join(tree.at, one.path), one.content, 'utf8')
       stdout.write(`thread: seeded ${one.path}\n`)
     }
   }
 
-  const loose = [...(await undeclared(tree, rows)), ...settled(tree.at, rows, checking, 'thread screens', new Set<string>())]
+  const loose = [...undeclared(tree, rows), ...settled(tree.at, rows, checking, 'thread screens', new Set<string>())]
   for (const one of loose) stdout.write(`thread: ${one}\n`)
 
   stdout.write(
@@ -139,4 +138,4 @@ async function run(): Promise<number> {
   return loose.length === 0 ? 0 : 1
 }
 
-if (invoked(import.meta.url)) exit(await run())
+if (invoked(import.meta.url)) exit(run())

package/dist/ui/tokens.js

@@ -6,7 +6,7 @@ var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExte
     }
     return path;
 };
-import { existsSync, mkdirSync, readdirSync, writeFileSync } from 'node:fs';
+import { existsSync, readdirSync, writeFileSync } from "@prestack/thread/core/files";
 import { basename, dirname, join } from 'node:path';
 import { argv, stdout } from 'node:process';
 import { pathToFileURL } from 'node:url';
@@ -169,7 +169,6 @@ async function run() {
     }
     else {
         for (const seed of made) {
-            mkdirSync(dirname(join(tree.at, seed.path)), { recursive: true });
             writeFileSync(join(tree.at, seed.path), seed.content, 'utf8');
             stdout.write(`thread: seeded ${seed.path}\n`);
         }

package/dist/ui/tokens.ts

@@ -1,4 +1,4 @@
-import { existsSync, mkdirSync, readdirSync, writeFileSync } from 'node:fs'
+import { existsSync, readdirSync, writeFileSync } from '@prestack/thread/core/files'
 import { basename, dirname, join } from 'node:path'
 import { argv, stdout } from 'node:process'
 import { pathToFileURL } from 'node:url'
@@ -198,7 +198,6 @@ async function run(): Promise<number> {
     }
   } else {
     for (const seed of made) {
-      mkdirSync(dirname(join(tree.at, seed.path)), { recursive: true })
       writeFileSync(join(tree.at, seed.path), seed.content, 'utf8')
       stdout.write(`thread: seeded ${seed.path}\n`)
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@prestack/thread-ui",
-  "version": "0.0.2",
+  "version": "0.1.0",
   "type": "module",
   "files": [
     "dist",
@@ -17,6 +17,6 @@
     "react-dom": "^19.0.0",
     "typescript": "^6.0.0",
     "zod": "^4.5.4",
-    "@prestack/thread": "^0.0.3"
+    "@prestack/thread": "^0.1.0"
   }
 }

package/dist/ui/makers/message.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/ui/makers/message.js

@@ -1,230 +0,0 @@
-var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
-    if (typeof path === "string" && /^\.\.?\//.test(path)) {
-        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
-            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
-        });
-    }
-    return path;
-};
-import { readFileSync, writeFileSync } from 'node:fs';
-import { join } from 'node:path';
-import { argv, exit, stdout } from 'node:process';
-import { pathToFileURL } from 'node:url';
-import { ELSEWHERE, RECEIPT, answer, answering, asking, given, guidance, issue, marked, named, needed, only, prompted, refuse, spend, within, wordsIn, wrapped } from "@prestack/thread/core/asking";
-import { named as packageOf } from "@prestack/thread/core/scope";
-import { findTree, inTree } from "@prestack/thread/core/tree";
-import { keyProps, keysIn, readWording, walk, wordingFile } from "../generators/i18n.js";
-import { fileFor, languagesIn, sourceIn } from "../localizations.js";
-const TREE = findTree();
-const DOTTED = /^[a-z][a-z0-9]*(?:[.-][a-z0-9]+)*$/;
-const KEY = { at: 'key', guide: 'lowercase words joined by dots — `checkout.confirm`, `errors.db.not_found.title`' };
-async function languages() {
-    const path = inTree(TREE, `localizations.${'ts'}`);
-    let sheet = {};
-    try {
-        sheet = (await import(__rewriteRelativeImportExtension(pathToFileURL(path).href)));
-    }
-    catch {
-        sheet = {};
-    }
-    if (sheet.LOCALIZATION === undefined) {
-        refuse(`there is no ${within(TREE.at, path)} declaring a \`LOCALIZATION\` here, so this app is in no ` +
-            `language and a message has nowhere to go. Run \`npx thread attach ${packageOf('ui')}\`.`);
-    }
-    const rows = [...(sheet.LOCALIZATION.holds ?? []), ...(sheet.LOCALIZATION.declares ?? [])];
-    const held = languagesIn(rows);
-    const source = sourceIn(rows);
-    if (held.length === 0 || source === undefined) {
-        refuse('no language is declared, so there is nothing to write a message in. Add one with `npx thread create language`.');
-    }
-    return { held, source };
-}
-function usage(props) {
-    const found = new Map();
-    for (const file of walk(TREE.at)) {
-        const text = readFileSync(file, 'utf8');
-        for (const key of new Set(keysIn(text, props))) {
-            const held = found.get(key) ?? [];
-            held.push(within(TREE.at, file));
-            found.set(key, held);
-        }
-    }
-    return found;
-}
-const mark = (key, said) => marked([key, said]);
-function write(at, language, held) {
-    writeFileSync(join(at, fileFor(language)), wordingFile(held), 'utf8');
-}
-async function run() {
-    const { held: spoken, source } = await languages();
-    const props = keyProps(TREE.at);
-    if (props.length === 0) {
-        refuse(`nothing in the installed \`${packageOf('ui')}\` declares a prop of type \`MessageKey\`, so no key could be ` +
-            'recognised anywhere. That is a broken install rather than an app with no wording.');
-    }
-    const LANGUAGES = spoken.map((one) => ({ at: one.id, guide: `what it says in ${one.name}` }));
-    const NEW = [KEY, ...LANGUAGES];
-    const wording = new Map();
-    for (const one of spoken)
-        wording.set(one.id, { ...readWording(TREE.at, one.id) });
-    const written = wording.get(source) ?? {};
-    const keys = Object.keys(written).sort();
-    const used = usage(props);
-    const blank = (key) => spoken.filter((one) => ((wording.get(one.id) ?? {})[key] ?? '') === '').map((one) => one.id);
-    const listing = [
-        `${String(keys.length)} message(s), in ${spoken.map((one) => one.id).join(', ')} — written in ${source}:`,
-        '',
-        ...keys.map((key) => {
-            const missing = blank(key);
-            const said = (written[key] ?? '') || '(nothing yet)';
-            return (`  [${mark(key, written[key] ?? '')}] ${key.padEnd(38)} ${said.length > 46 ? `${said.slice(0, 45)}…` : said}` +
-                `${missing.length === 0 ? '' : `  · still to write: ${missing.join(', ')}`}` +
-                `${(used.get(key) ?? []).length === 0 ? '  · named by nothing here' : ''}`);
-        }),
-    ].join('\n');
-    const words = wordsIn(['new']);
-    const verb = words[0];
-    const flagged = argv.indexOf(RECEIPT);
-    if (flagged === -1) {
-        stdout.write(`${listing}\n`);
-        const nonce = issue(TREE.at, listing);
-        stdout.write([
-            '',
-            ...answering('message'),
-            '',
-            ...guidance(NEW),
-            '',
-            ...wrapped('Every language is asked for and none may be left blank. A key that exists in one language and ' +
-                'not another is what makes a screen come out half translated, and it is refused here rather ' +
-                'than found by whoever is reading the app in the other one.', '  '),
-            '',
-            `  npx thread create message new ${RECEIPT} ${nonce}`,
-            '',
-            ...ELSEWHERE,
-            '',
-            ...wrapped('A rename moves the wording in every language and rewrites every file in the interface that ' +
-                'names it, in one run.', '  '),
-            '',
-        ].join('\n'));
-        stdout.write(`create: receipt ${nonce} — spent on use, and stale the moment the wording changes.\n`);
-        return 0;
-    }
-    spend(TREE.at, listing, argv[flagged + 1], `the wording`);
-    const all = given();
-    const { piped, ask, shut } = asking(all);
-    const ASKS = {
-        new: ['do', ...named(NEW)],
-        edit: ['do', 'mark', ...named(NEW)],
-        remove: ['do', 'mark'],
-    };
-    const doing = verb ?? (await ask('do', 'new, edit or remove: '));
-    const allowed = ASKS[doing];
-    if (allowed === undefined) {
-        shut();
-        refuse(`there is nothing called "${doing}" to do here — say new, edit, remove, or read, which needs no receipt`);
-    }
-    if (piped)
-        only(all, allowed, `\`${doing}\``);
-    if (doing === 'remove' || doing === 'edit') {
-        const which = words[1] ?? (piped ? needed(all, 'mark', `\`${doing}\``) : await ask('mark', 'mark: '));
-        const one = keys.find((key) => mark(key, written[key] ?? '') === which);
-        if (one === undefined) {
-            shut();
-            refuse(`\`${which}\` is not a mark this sheet issued — they are printed in brackets beside each message.`);
-        }
-        if (doing === 'remove') {
-            const where = used.get(one) ?? [];
-            if (where.length > 0) {
-                shut();
-                refuse(`\`${one}\` is named by ${where.slice(0, 6).join(', ')}` +
-                    `${where.length > 6 ? ` and ${String(where.length - 6)} more` : ''}. ` +
-                    'Removing it would leave those asking for wording that does not exist, which throws the moment ' +
-                    'the screen renders. Take it out of the interface first.');
-            }
-            shut();
-            for (const language of spoken) {
-                const made = { ...(wording.get(language.id) ?? {}) };
-                delete made[one];
-                write(TREE.at, language.id, made);
-            }
-            stdout.write(`create: removed ${one} from ${String(spoken.length)} language file(s)\n`);
-            return 0;
-        }
-        const renamed = piped ? (answer(all, KEY.at) ?? '') : await ask(KEY.at, `key (${one}, blank to keep) `);
-        if (renamed !== '' && !DOTTED.test(renamed)) {
-            shut();
-            refuse(`\`${renamed}\` is not a key — lowercase words joined by dots.`);
-        }
-        if (renamed !== '' && written[renamed] !== undefined) {
-            shut();
-            refuse(`\`${renamed}\` is already a message. Two keys with one name is one key, and the other's wording is lost.`);
-        }
-        const said = new Map();
-        for (const language of spoken) {
-            const now = (wording.get(language.id) ?? {})[one] ?? '';
-            const next = piped
-                ? (answer(all, language.id) ?? '')
-                : await ask(language.id, `${language.name} (${now || 'nothing yet'}) `);
-            said.set(language.id, next === '' ? now : next);
-        }
-        shut();
-        const name = renamed === '' ? one : renamed;
-        for (const language of spoken) {
-            const made = { ...(wording.get(language.id) ?? {}) };
-            delete made[one];
-            made[name] = said.get(language.id) ?? '';
-            write(TREE.at, language.id, made);
-        }
-        let moved = 0;
-        if (renamed !== '') {
-            for (const file of walk(TREE.at)) {
-                const text = readFileSync(file, 'utf8');
-                if (!keysIn(text, props).includes(one))
-                    continue;
-                writeFileSync(file, text.replace(new RegExp(`(\\b(?:${props.join('|')})\\s*=\\s*")${one.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}(")`, 'g'), `$1${name}$2`), 'utf8');
-                moved += 1;
-            }
-        }
-        stdout.write(`create: ${one}${renamed === '' ? '' : ` is now ${name}`} — rewritten in ${String(spoken.length)} language file(s)` +
-            `${moved === 0 ? '' : ` and ${String(moved)} file(s) of the interface`}\n`);
-        const still = blankIn(said, spoken);
-        if (still.length > 0) {
-            stdout.write(`create: still nothing in ${still.join(', ')} — the gate refuses while that holds.\n`);
-        }
-        return 0;
-    }
-    const key = piped ? needed(all, KEY.at, '`new`') : await ask(KEY.at, prompted(KEY));
-    if (!DOTTED.test(key)) {
-        shut();
-        refuse(`\`${key}\` is not a key — lowercase words joined by dots, like \`checkout.confirm\`.`);
-    }
-    if (written[key] !== undefined) {
-        shut();
-        refuse(`\`${key}\` is already a message. Edit it by its mark, or choose another key.`);
-    }
-    const said = new Map();
-    for (const language of spoken) {
-        const next = piped
-            ? (answer(all, language.id) ?? '')
-            : await ask(language.id, `what it says in ${language.name}: `);
-        if (next === '') {
-            shut();
-            refuse(`\`${key}\` has nothing to say in ${language.name}. Every language is answered at the moment a key ` +
-                'is made, because a key that exists in one language and not another is a screen that comes out ' +
-                'half translated. There is no way past this on purpose.');
-        }
-        said.set(language.id, next);
-    }
-    shut();
-    for (const language of spoken) {
-        write(TREE.at, language.id, { ...(wording.get(language.id) ?? {}), [key]: said.get(language.id) ?? '' });
-    }
-    stdout.write(`create: wrote ${key} in ${spoken.map((one) => one.id).join(', ')}\n`);
-    stdout.write(`create: name it in the interface with one of: ${props.join(', ')} — for example \`label="${key}"\`.\n`);
-    return 0;
-}
-function blankIn(said, spoken) {
-    return spoken.filter((one) => (said.get(one.id) ?? '') === '').map((one) => one.id);
-}
-if (argv[1] !== undefined)
-    exit(await run());

package/dist/ui/makers/message.ts

@@ -1,292 +0,0 @@
-import { existsSync, readFileSync, writeFileSync } from 'node:fs'
-import { join } from 'node:path'
-import { argv, exit, stdout } from 'node:process'
-import { pathToFileURL } from 'node:url'
-
-import { ELSEWHERE, RECEIPT, answer, answering, asking, given, guidance, issue, marked, named, needed, only, prompted, refuse, spend, within, wordsIn, wrapped, type Asked } from '@prestack/thread/core/asking'
-import { named as packageOf } from '@prestack/thread/core/scope'
-import { findTree, inTree } from '@prestack/thread/core/tree'
-
-import { keyProps, keysIn, readWording, walk, wordingFile } from '../generators/i18n.ts'
-import { fileFor, languagesIn, sourceIn } from '../localizations.ts'
-
-const TREE = findTree()
-
-const DOTTED = /^[a-z][a-z0-9]*(?:[.-][a-z0-9]+)*$/
-
-const KEY: Asked = { at: 'key', guide: 'lowercase words joined by dots — `checkout.confirm`, `errors.db.not_found.title`' }
-
-interface Row {
-  readonly id: string
-  readonly is?: string
-  readonly sets?: Readonly<Record<string, string>>
-}
-
-async function languages(): Promise<{
-  readonly held: readonly { readonly id: string; readonly name: string; readonly flag: string }[]
-  readonly source: string
-}> {
-  const path = inTree(TREE, `localizations.${'ts'}`)
-  let sheet: { LOCALIZATION?: { readonly holds?: readonly Row[]; readonly declares?: readonly Row[] } } = {}
-  try {
-    sheet = (await import(pathToFileURL(path).href)) as typeof sheet
-  } catch {
-    sheet = {}
-  }
-  if (sheet.LOCALIZATION === undefined) {
-    refuse(
-      `there is no ${within(TREE.at, path)} declaring a \`LOCALIZATION\` here, so this app is in no ` +
-        `language and a message has nowhere to go. Run \`npx thread attach ${packageOf('ui')}\`.`,
-    )
-  }
-  const rows = [...(sheet.LOCALIZATION.holds ?? []), ...(sheet.LOCALIZATION.declares ?? [])]
-  const held = languagesIn(rows)
-  const source = sourceIn(rows)
-  if (held.length === 0 || source === undefined) {
-    refuse('no language is declared, so there is nothing to write a message in. Add one with `npx thread create language`.')
-  }
-  return { held, source }
-}
-
-function usage(props: readonly string[]): ReadonlyMap<string, readonly string[]> {
-  const found = new Map<string, string[]>()
-  for (const file of walk(TREE.at)) {
-    const text = readFileSync(file, 'utf8')
-    for (const key of new Set(keysIn(text, props))) {
-      const held = found.get(key) ?? []
-      held.push(within(TREE.at, file))
-      found.set(key, held)
-    }
-  }
-  return found
-}
-
-const mark = (key: string, said: string): string => marked([key, said])
-
-function write(at: string, language: string, held: Readonly<Record<string, string>>): void {
-  writeFileSync(join(at, fileFor(language)), wordingFile(held), 'utf8')
-}
-
-async function run(): Promise<number> {
-  const { held: spoken, source } = await languages()
-  const props = keyProps(TREE.at)
-  if (props.length === 0) {
-    refuse(
-      `nothing in the installed \`${packageOf('ui')}\` declares a prop of type \`MessageKey\`, so no key could be ` +
-        'recognised anywhere. That is a broken install rather than an app with no wording.',
-    )
-  }
-
-  const LANGUAGES: readonly Asked[] = spoken.map((one) => ({ at: one.id, guide: `what it says in ${one.name}` }))
-
-  const NEW: readonly Asked[] = [KEY, ...LANGUAGES]
-
-  const wording = new Map<string, Record<string, string>>()
-  for (const one of spoken) wording.set(one.id, { ...readWording(TREE.at, one.id) })
-
-  const written = wording.get(source) ?? {}
-  const keys = Object.keys(written).sort()
-  const used = usage(props)
-
-  const blank = (key: string): readonly string[] =>
-    spoken.filter((one) => ((wording.get(one.id) ?? {})[key] ?? '') === '').map((one) => one.id)
-
-  const listing = [
-    `${String(keys.length)} message(s), in ${spoken.map((one) => one.id).join(', ')} — written in ${source}:`,
-    '',
-
-    ...keys.map((key) => {
-      const missing = blank(key)
-      const said = (written[key] ?? '') || '(nothing yet)'
-      return (
-        `  [${mark(key, written[key] ?? '')}] ${key.padEnd(38)} ${said.length > 46 ? `${said.slice(0, 45)}…` : said}` +
-        `${missing.length === 0 ? '' : `  · still to write: ${missing.join(', ')}`}` +
-        `${(used.get(key) ?? []).length === 0 ? '  · named by nothing here' : ''}`
-      )
-    }),
-  ].join('\n')
-
-  const words = wordsIn(['new'])
-  const verb = words[0]
-
-  const flagged = argv.indexOf(RECEIPT)
-  if (flagged === -1) {
-    stdout.write(`${listing}\n`)
-    const nonce = issue(TREE.at, listing)
-    stdout.write(
-      [
-        '',
-        ...answering('message'),
-        '',
-        ...guidance(NEW),
-        '',
-        ...wrapped(
-          'Every language is asked for and none may be left blank. A key that exists in one language and ' +
-            'not another is what makes a screen come out half translated, and it is refused here rather ' +
-            'than found by whoever is reading the app in the other one.',
-          '  ',
-        ),
-        '',
-        `  npx thread create message new ${RECEIPT} ${nonce}`,
-        '',
-        ...ELSEWHERE,
-        '',
-        ...wrapped(
-          'A rename moves the wording in every language and rewrites every file in the interface that ' +
-            'names it, in one run.',
-          '  ',
-        ),
-        '',
-      ].join('\n'),
-    )
-    stdout.write(`create: receipt ${nonce} — spent on use, and stale the moment the wording changes.\n`)
-    return 0
-  }
-
-  spend(TREE.at, listing, argv[flagged + 1], `the wording`)
-
-  const all = given()
-  const { piped, ask, shut } = asking(all)
-
-  const ASKS: Readonly<Record<string, readonly string[]>> = {
-    new: ['do', ...named(NEW)],
-    edit: ['do', 'mark', ...named(NEW)],
-    remove: ['do', 'mark'],
-  }
-
-  const doing = verb ?? (await ask('do', 'new, edit or remove: '))
-  const allowed = ASKS[doing]
-  if (allowed === undefined) {
-    shut()
-    refuse(`there is nothing called "${doing}" to do here — say new, edit, remove, or read, which needs no receipt`)
-  }
-  if (piped) only(all, allowed, `\`${doing}\``)
-
-  if (doing === 'remove' || doing === 'edit') {
-    const which = words[1] ?? (piped ? needed(all, 'mark', `\`${doing}\``) : await ask('mark', 'mark: '))
-    const one = keys.find((key) => mark(key, written[key] ?? '') === which)
-    if (one === undefined) {
-      shut()
-      refuse(`\`${which}\` is not a mark this sheet issued — they are printed in brackets beside each message.`)
-    }
-
-    if (doing === 'remove') {
-      const where = used.get(one) ?? []
-      if (where.length > 0) {
-        shut()
-        refuse(
-          `\`${one}\` is named by ${where.slice(0, 6).join(', ')}` +
-            `${where.length > 6 ? ` and ${String(where.length - 6)} more` : ''}. ` +
-            'Removing it would leave those asking for wording that does not exist, which throws the moment ' +
-            'the screen renders. Take it out of the interface first.',
-        )
-      }
-      shut()
-      for (const language of spoken) {
-        const made = { ...(wording.get(language.id) ?? {}) }
-        delete made[one]
-        write(TREE.at, language.id, made)
-      }
-      stdout.write(`create: removed ${one} from ${String(spoken.length)} language file(s)\n`)
-      return 0
-    }
-
-    const renamed = piped ? (answer(all, KEY.at) ?? '') : await ask(KEY.at, `key (${one}, blank to keep) `)
-    if (renamed !== '' && !DOTTED.test(renamed)) {
-      shut()
-      refuse(`\`${renamed}\` is not a key — lowercase words joined by dots.`)
-    }
-    if (renamed !== '' && written[renamed] !== undefined) {
-      shut()
-      refuse(`\`${renamed}\` is already a message. Two keys with one name is one key, and the other's wording is lost.`)
-    }
-
-    const said = new Map<string, string>()
-    for (const language of spoken) {
-      const now = (wording.get(language.id) ?? {})[one] ?? ''
-      const next = piped
-        ? (answer(all, language.id) ?? '')
-        : await ask(language.id, `${language.name} (${now || 'nothing yet'}) `)
-      said.set(language.id, next === '' ? now : next)
-    }
-    shut()
-
-    const name = renamed === '' ? one : renamed
-    for (const language of spoken) {
-      const made = { ...(wording.get(language.id) ?? {}) }
-      delete made[one]
-      made[name] = said.get(language.id) ?? ''
-      write(TREE.at, language.id, made)
-    }
-
-    let moved = 0
-    if (renamed !== '') {
-      for (const file of walk(TREE.at)) {
-        const text = readFileSync(file, 'utf8')
-        if (!keysIn(text, props).includes(one)) continue
-        writeFileSync(
-          file,
-          text.replace(
-            new RegExp(`(\\b(?:${props.join('|')})\\s*=\\s*")${one.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}(")`, 'g'),
-            `$1${name}$2`,
-          ),
-          'utf8',
-        )
-        moved += 1
-      }
-    }
-
-    stdout.write(
-      `create: ${one}${renamed === '' ? '' : ` is now ${name}`} — rewritten in ${String(spoken.length)} language file(s)` +
-        `${moved === 0 ? '' : ` and ${String(moved)} file(s) of the interface`}\n`,
-    )
-    const still = blankIn(said, spoken)
-    if (still.length > 0) {
-      stdout.write(`create: still nothing in ${still.join(', ')} — the gate refuses while that holds.\n`)
-    }
-    return 0
-  }
-
-  const key = piped ? needed(all, KEY.at, '`new`') : await ask(KEY.at, prompted(KEY))
-  if (!DOTTED.test(key)) {
-    shut()
-    refuse(`\`${key}\` is not a key — lowercase words joined by dots, like \`checkout.confirm\`.`)
-  }
-  if (written[key] !== undefined) {
-    shut()
-    refuse(`\`${key}\` is already a message. Edit it by its mark, or choose another key.`)
-  }
-
-  const said = new Map<string, string>()
-  for (const language of spoken) {
-    const next = piped
-      ? (answer(all, language.id) ?? '')
-      : await ask(language.id, `what it says in ${language.name}: `)
-    if (next === '') {
-      shut()
-      refuse(
-        `\`${key}\` has nothing to say in ${language.name}. Every language is answered at the moment a key ` +
-          'is made, because a key that exists in one language and not another is a screen that comes out ' +
-          'half translated. There is no way past this on purpose.',
-      )
-    }
-    said.set(language.id, next)
-  }
-  shut()
-
-  for (const language of spoken) {
-    write(TREE.at, language.id, { ...(wording.get(language.id) ?? {}), [key]: said.get(language.id) ?? '' })
-  }
-  stdout.write(`create: wrote ${key} in ${spoken.map((one) => one.id).join(', ')}\n`)
-  stdout.write(`create: name it in the interface with one of: ${props.join(', ')} — for example \`label="${key}"\`.\n`)
-  return 0
-}
-
-function blankIn(
-  said: ReadonlyMap<string, string>,
-  spoken: readonly { readonly id: string }[],
-): readonly string[] {
-  return spoken.filter((one) => (said.get(one.id) ?? '') === '').map((one) => one.id)
-}
-
-if (argv[1] !== undefined) exit(await run())