@fnndsc/brasa 0.56.2 → 0.56.3

package/dist/builtins/res/group.js

@@ -1,12 +1,19 @@
 /**
- * @file Builtin group command.
+ * @file `group` and `groups`: CUBE's groups, listed, searched, and their
+ * members listed, added and removed. Changing a membership needs an
+ * administrator (`sudo group adduser …`).
  *
- * Subcommands: list, search, inspect, members, adduser, removeuser
- * [admin]: create, delete, adduser, removeuser
- * Singular/plural aliases: group / groups
+ * Declared in one record (`groupCommand`, `groups` among its aliases): the subcommands, their operands, and the listing options every
+ * resource command reads.
+ *
+ * Key components:
+ * - groupCommand: the declaration, answered as `group` and `groups`.
+ * - builtin_group: the declaration run over words already split.
+ * - groupSync_note: the caveat an add carries.
+ *
+ * @module
  */
 import chalk from 'chalk';
-import { commandArgs_process, cliOptions_extract, resourceListOptions_refusal, resourceSearchTerm_refusal, resourceSearch_args } from '../utils.js';
 import { groups_fetchList } from '@fnndsc/chili/commands/groups/list.js';
 import { groupFields_fetch } from '@fnndsc/chili/commands/groups/fields.js';
 import { groupMembers_fetch, groupReference_resolve, groupUser_add, groupUser_remove, } from '@fnndsc/chili/commands/groups/membership.js';
@@ -14,6 +21,9 @@ import { table_render } from '@fnndsc/chili/screen/screen.js';
 import { authorizationFailure_is, sudoHint_build } from '../../core/elevation.js';
 import { envelope_ok, envelope_error } from '@fnndsc/menu';
 import { exitCode_set } from '../../core/handlerRun.js';
+import { command_declare } from '../../core/commandDeclaration.js';
+import { declaredCommand_run } from '../../core/commandParse.js';
+import { RESOURCE_LIST_OPTIONS_GRAMMAR, resourceListBag_build } from './resourceList.js';
 /**
  * Renders an error for a failed group membership operation.
  *
@@ -109,87 +119,148 @@ export function groupSync_note() {
     return `${chalk.gray('Note: where CUBE takes its groups from a directory (Authentik, LDAP), a membership added here is undone at the user\'s next login; grant it in the directory to make it stick.')}\n`;
 }
 /**
- * Builtin handler for the `group` command.
+ * Lists the groups a listing's options ask for.
  *
- * @param args - Parsed command arguments for the group command.
- * @returns An envelope carrying a group listing, membership result, or usage error.
+ * @param options - The bag chili's listing reads.
+ * @returns The table, or that there are none, or the error.
  */
-export async function builtin_group(args) {
-    const parsed = commandArgs_process(args);
-    const subcommand = parsed._[0];
-    if (!subcommand || subcommand === 'list') {
-        const refusal = resourceListOptions_refusal('group', parsed);
-        if (refusal !== null) {
-            exitCode_set(1);
-            return envelope_error('', undefined, `${chalk.red(refusal)}\n`);
-        }
-        try {
-            const { groups, selectedFields, totalCount } = await groups_fetchList(cliOptions_extract(parsed));
-            if (groups.length === 0) {
-                return envelope_ok(`${chalk.gray('No groups found.')}\n`);
-            }
-            return envelope_ok(table_render(groups, selectedFields, { title: { title: 'Groups', justification: 'center' }, pagination: totalCount !== undefined ? { shown: groups.length, total: totalCount } : undefined }));
-        }
-        catch (e) {
-            exitCode_set(1);
-            return envelope_error('', undefined, `${chalk.red(`group error: ${e instanceof Error ? e.message : String(e)}`)}\n`);
+async function groupList_render(options) {
+    try {
+        const { groups, selectedFields, totalCount } = await groups_fetchList(options);
+        if (groups.length === 0) {
+            return envelope_ok(`${chalk.gray('No groups found.')}\n`);
         }
+        return envelope_ok(table_render(groups, selectedFields, { title: { title: 'Groups', justification: 'center' }, pagination: totalCount !== undefined ? { shown: groups.length, total: totalCount } : undefined }));
     }
-    if (subcommand === 'search') {
-        const refusal = resourceSearchTerm_refusal('group', parsed);
-        if (refusal !== null) {
-            exitCode_set(1);
-            return envelope_error('', undefined, `${chalk.red(refusal)}\n`);
-        }
-        const query = String(parsed._[1]);
-        const search = query.includes(':') ? query : `name_icontains:${query}`;
-        return builtin_group(resourceSearch_args(parsed, search));
-    }
-    if (subcommand === 'inspect') {
-        const reference = parsed._[1];
-        if (reference !== undefined) {
-            const resolved = await groupReference_resolve(reference);
-            if (!resolved.ok)
-                return group_error(resolved.error);
-            return envelope_ok(table_render([{ id: resolved.value.id, name: resolved.value.name }], ['id', 'name'], { title: { title: `Group ${group_label(resolved.value)}`, justification: 'center' } }));
-        }
-        const fields = await groupFields_fetch();
-        if (fields && fields.length > 0) {
-            return envelope_ok(table_render(fields.map((f) => ({ field: f })), ['field'], { title: { title: 'Group fields', justification: 'center' } }));
-        }
-        return envelope_ok(`${chalk.gray('No fields found for groups.')}\n`);
+    catch (e) {
+        exitCode_set(1);
+        return envelope_error('', undefined, `${chalk.red(`group error: ${e instanceof Error ? e.message : String(e)}`)}\n`);
     }
-    if (subcommand === 'members') {
-        const reference = parsed._[1];
-        if (reference === undefined)
-            return group_error('Usage: group members <group>');
+}
+/**
+ * `group inspect [<group>]`: one group's identity, or the fields a group has.
+ *
+ * @param reference - The group's name or id, or none for the fields.
+ * @returns The identity or the fields, or the error.
+ */
+async function groupInspect_render(reference) {
+    if (reference !== undefined) {
         const resolved = await groupReference_resolve(reference);
         if (!resolved.ok)
             return group_error(resolved.error);
-        const result = await groupMembers_fetch(resolved.value.id);
-        if (!result.ok)
-            return group_error(result.error);
-        if (result.value.length === 0) {
-            return envelope_ok(`${chalk.gray(`Group ${group_label(resolved.value)} has no users.`)}\n`);
-        }
-        const rows = result.value.map((member) => ({
-            id: member.id,
-            username: member.username,
-        }));
-        return envelope_ok(table_render(rows, ['id', 'username'], { title: { title: `Group ${group_label(resolved.value)} users`, justification: 'center' } }));
+        return envelope_ok(table_render([{ id: resolved.value.id, name: resolved.value.name }], ['id', 'name'], { title: { title: `Group ${group_label(resolved.value)}`, justification: 'center' } }));
+    }
+    const fields = await groupFields_fetch();
+    if (fields && fields.length > 0) {
+        return envelope_ok(table_render(fields.map((f) => ({ field: f })), ['field'], { title: { title: 'Group fields', justification: 'center' } }));
+    }
+    return envelope_ok(`${chalk.gray('No fields found for groups.')}\n`);
+}
+/**
+ * `group members <group>`: the users in one group.
+ *
+ * @param reference - The group's name or id.
+ * @returns The members' table, or that it has none, or the error.
+ */
+async function groupMembers_render(reference) {
+    const resolved = await groupReference_resolve(reference);
+    if (!resolved.ok)
+        return group_error(resolved.error);
+    const result = await groupMembers_fetch(resolved.value.id);
+    if (!result.ok)
+        return group_error(result.error);
+    if (result.value.length === 0) {
+        return envelope_ok(`${chalk.gray(`Group ${group_label(resolved.value)} has no users.`)}\n`);
     }
-    if (subcommand === 'adduser' || subcommand === 'removeuser') {
-        const reference = parsed._[1];
-        const usernames = parsed._.slice(2);
-        if (reference === undefined || usernames.length === 0) {
-            return group_error(`Usage: group ${subcommand} <group> <username...>`);
+    const rows = result.value.map((member) => ({
+        id: member.id,
+        username: member.username,
+    }));
+    return envelope_ok(table_render(rows, ['id', 'username'], { title: { title: `Group ${group_label(resolved.value)} users`, justification: 'center' } }));
+}
+/**
+ * `group adduser|removeuser <group> <user…>`: one membership change for
+ * every user named.
+ *
+ * @param reference - The group's name or id.
+ * @param usernames - The users, in the order given.
+ * @param operation - Whether they are added or removed.
+ * @returns The batch's outcome, or the error.
+ */
+async function groupMembership_change(reference, usernames, operation) {
+    const resolved = await groupReference_resolve(reference);
+    if (!resolved.ok)
+        return group_error(resolved.error);
+    return groupMembership_batch(resolved.value, usernames, operation);
+}
+/** What a `group` line may hold. */
+const GROUP_GRAMMAR = {
+    bare: { summary: 'List the groups, as list does', options: RESOURCE_LIST_OPTIONS_GRAMMAR },
+    subcommands: {
+        list: { summary: 'List the groups, 20 to a page', options: RESOURCE_LIST_OPTIONS_GRAMMAR },
+        search: {
+            summary: 'List the groups a filter matches: field:value, or a name fragment (list --search <term>)',
+            operands: [{ name: 'term', kind: 'word', summary: 'The filter, field:value, or part of a name' }],
+            options: RESOURCE_LIST_OPTIONS_GRAMMAR,
+        },
+        inspect: { summary: "One group's name and id, or, with none named, the fields a group has", operands: [{ name: 'group', kind: 'word', optional: true, summary: "The group's name or id" }] },
+        members: { summary: 'List the users in a group', operands: [{ name: 'group', kind: 'word', summary: "The group's name or id" }] },
+        adduser: { summary: 'Add users to a group (an administrator: sudo group adduser …)', operands: [{ name: 'group', kind: 'word', summary: "The group's name or id" }, { name: 'users', kind: 'word', repeat: true, summary: 'The usernames' }] },
+        removeuser: { summary: 'Remove users from a group (an administrator: sudo group removeuser …)', operands: [{ name: 'group', kind: 'word', summary: "The group's name or id" }, { name: 'users', kind: 'word', repeat: true, summary: 'The usernames' }] },
+    },
+};
+/**
+ * Runs one `group` line.
+ *
+ * @param args - The line, parsed.
+ * @returns The listing, the group, its members, or what a change did.
+ */
+async function group_run(args) {
+    switch (args.subcommand) {
+        case null:
+        case 'list': return groupList_render(resourceListBag_build(args.options));
+        case 'search': {
+            const term = args.operands.term;
+            return groupList_render(resourceListBag_build(args.options, term.includes(':') ? term : `name_icontains:${term}`));
         }
-        const resolved = await groupReference_resolve(reference);
-        if (!resolved.ok)
-            return group_error(resolved.error);
-        return groupMembership_batch(resolved.value, usernames, subcommand === 'adduser' ? 'add' : 'remove');
+        case 'inspect': return groupInspect_render(args.operands.group);
+        case 'members': return groupMembers_render(args.operands.group);
+        case 'adduser': return groupMembership_change(args.operands.group, args.operands.users, 'add');
+        case 'removeuser': return groupMembership_change(args.operands.group, args.operands.users, 'remove');
     }
-    exitCode_set(1);
-    return envelope_error(`${chalk.red(`Unknown subcommand: ${subcommand}. Usage: groups <list|search|inspect|members|adduser|removeuser>`)}\n`);
+}
+/**
+ * `group [list | search <term> | inspect [group] | members <group> | adduser|removeuser <group> <user…>]`: the declaration.
+ *
+ * @example
+ * ```ts
+ * commands_register({ declarations: [groupCommand] }, 'backend');
+ * ```
+ */
+export const groupCommand = command_declare({
+    name: 'group',
+    aliases: [{ name: 'groups', holds: [] }],
+    grammar: GROUP_GRAMMAR,
+    help: {
+        summary: "CUBE's groups: list them, search them, list and change their members",
+        description: "List the groups in CUBE, a page at a time or every page, filtered by a search (field:value, or part of a name) and in the columns asked for; inspect names one group's id, or the fields a group has. members lists a group's users; adduser and removeuser change them, each user in turn, and need an administrator (sudo group adduser …). Where CUBE takes its groups from a directory (Authentik, LDAP), a membership added here is undone at the user's next login. group and groups are one command.",
+        category: 'Resources',
+        examples: ['groups list', 'groups search pacs', 'group inspect pacs_users', 'group members pacs_users', 'sudo group adduser pacs_users peter.hong joe.schmo', 'sudo group removeuser pacs_users joe.schmo'],
+    },
+    handler: group_run,
+});
+/**
+ * `group` over words already split: the declaration's parse and handler.
+ *
+ * @param args - The words after `group`.
+ * @returns The answer, or the refusal of a bad line.
+ *
+ * @example
+ * ```ts
+ * await builtin_group(['members', 'pacs_users']);
+ * ```
+ */
+export async function builtin_group(args) {
+    return declaredCommand_run(groupCommand, args);
 }
 //# sourceMappingURL=group.js.map

package/dist/builtins/res/group.js.map

@@ -1 +1 @@
-{"version":3,"file":"group.js","sourceRoot":"","sources":["../../../src/builtins/res/group.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"group.js","sourceRoot":"","sources":["../../../src/builtins/res/group.ts"],"names":[],"mappings":"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"}

package/dist/builtins/res/image.d.ts

@@ -1,8 +1,36 @@
 import { type CommandEnvelope } from '@fnndsc/menu';
 /**
- * Handles `image [--force] <path>`.
+ * `image [--force] [path]`: the declaration. Given no path, it shows its help.
+ *
+ * @example
+ * ```ts
+ * commands_register({ declarations: [imageCommand] }, 'backend');
+ * ```
+ */
+export declare const imageCommand: import("../../core/commandDeclaration.js").CommandDeclaration<{
+    readonly operands: readonly [{
+        readonly name: "path";
+        readonly kind: "cfsPath";
+        readonly optional: true;
+        readonly glob: true;
+        readonly summary: "A series folder, a .dcm file (its folder is the series), or a NIfTI/MGZ volume";
+    }];
+    readonly options: {
+        readonly force: {
+            readonly long: "force";
+            readonly summary: "Ride through the volume-size guard a graphical surface would hold at";
+        };
+    };
+}>;
+/**
+ * `image` over words already split: the declaration's parse and handler.
  *
  * @param args - The command arguments.
- * @returns An envelope carrying the reflection text and the `image.view` intent.
+ * @returns An envelope carrying the reflection text and the `image.view` intent, or the refusal of a bad line.
+ *
+ * @example
+ * ```ts
+ * await builtin_image(['--force', 'brain.nii.gz']);
+ * ```
  */
 export declare function builtin_image(args: string[]): Promise<CommandEnvelope>;

package/dist/builtins/res/image.js

@@ -13,7 +13,8 @@
  *
  * The path resolves to a series (via the same reader `dcm series` uses) or a
  * volume file; anything else is refused by name. `--force` rides through the
- * volume-size guard a graphical surface would otherwise hold at.
+ * volume-size guard a graphical surface would otherwise hold at. The line is
+ * declared in one record (`imageCommand`).
  *
  * A stop is honoured between the reads: after the path resolves, after the
  * series' listing and header, and before the thumbnail's slice. A read
@@ -24,8 +25,10 @@
 import { context_getSingle, dicomSeries_summarize, dicomSlice_gray } from '@fnndsc/salsa';
 import { IMAGE_MODEL_KINDS, envelope_ok, envelope_error } from '@fnndsc/menu';
 import chalk from 'chalk';
-import { commandArgs_process, path_resolve } from '../utils.js';
-import { args_checkHasHelpFlag, help_render } from '../help.js';
+import { path_resolve } from '../utils.js';
+import { help_render } from '../help.js';
+import { command_declare } from '../../core/commandDeclaration.js';
+import { declaredCommand_run } from '../../core/commandParse.js';
 import { surface_get } from '../../core/surface.js';
 import { series_render } from './dicom.js';
 import { thumbnail_render } from './thumbnail.js';
@@ -43,20 +46,69 @@ const DICOM_FILE_PATTERN = /\.dcm$/i;
 function stopped_answer() {
     return envelope_error('', undefined, 'image: stopped\n');
 }
+/** What an `image` line may hold. */
+const IMAGE_GRAMMAR = {
+    operands: [{ name: 'path', kind: 'cfsPath', optional: true, glob: true, summary: 'A series folder, a .dcm file (its folder is the series), or a NIfTI/MGZ volume' }],
+    options: {
+        force: { long: 'force', summary: 'Ride through the volume-size guard a graphical surface would hold at' },
+    },
+};
 /**
- * Handles `image [--force] <path>`.
+ * `image [--force] [path]`: the declaration. Given no path, it shows its help.
+ *
+ * @example
+ * ```ts
+ * commands_register({ declarations: [imageCommand] }, 'backend');
+ * ```
+ */
+export const imageCommand = command_declare({
+    name: 'image',
+    grammar: IMAGE_GRAMMAR,
+    help: {
+        summary: 'Show a DICOM series or a volume — a browser draws it, a terminal reflects it',
+        description: 'Open an image as the kernel sees it. `image <path>` resolves what the path is — a series '
+            + 'folder, a `.dcm` file (its folder is the series), or a NIfTI/MGZ volume — and emits an image.view '
+            + 'intent every attached surface renders in its own way: a graphical surface (ARGUS) opens a rendered '
+            + 'pane; a text surface (a shared TTY) prints a reflection — the same facts `dcm series` shows, under an '
+            + '`image` line, with a small ASCII or truecolour thumbnail of the middle slice. So the same `image` line '
+            + 'works from a browser and from a terminal sharing one CALYPSO session.',
+        category: 'Imaging',
+        examples: [
+            'image ~/uploads/sag-anon                      # A series folder',
+            'image /SERVICES/PACS/PACSDCM/patient/study/00005-T1-abcdef0',
+            'image scan.dcm                                # A single file; its folder is the series',
+            'image brain.nii.gz --force                    # A volume, past the size guard',
+        ],
+    },
+    // `image` answers with an intent a surface draws, and changes nothing of the session.
+    holds: [],
+    handler: (args) => image_run(args.operands.path, args.options.force),
+});
+/**
+ * `image` over words already split: the declaration's parse and handler.
  *
  * @param args - The command arguments.
- * @returns An envelope carrying the reflection text and the `image.view` intent.
+ * @returns An envelope carrying the reflection text and the `image.view` intent, or the refusal of a bad line.
+ *
+ * @example
+ * ```ts
+ * await builtin_image(['--force', 'brain.nii.gz']);
+ * ```
  */
 export async function builtin_image(args) {
-    if (args_checkHasHelpFlag(args, 'image'))
-        return envelope_ok(help_render('image'));
-    const parsed = commandArgs_process(args, { booleanLongOptions: ['force'] });
-    const target = parsed._[0];
+    return declaredCommand_run(imageCommand, args);
+}
+/**
+ * Shows the image a path names: a volume's intent, or a series' reflection
+ * and intent; its help when no path is given.
+ *
+ * @param target - The path, or undefined.
+ * @param force - Ride through a surface's volume-size guard.
+ * @returns An envelope carrying the reflection text and the `image.view` intent.
+ */
+async function image_run(target, force) {
     if (target === undefined)
         return envelope_ok(help_render('image'));
-    const force = parsed.force === true;
     commandCancellation_enable();
     const signal = commandCancellation_signalGet();
     // Read afresh at each step: the signal changes while a read is awaited.

package/dist/builtins/res/image.js.map

@@ -1 +1 @@
-{"version":3,"file":"image.js","sourceRoot":"","sources":["../../../src/builtins/res/image.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"image.js","sourceRoot":"","sources":["../../../src/builtins/res/image.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,eAAe,EAAkD,MAAM,eAAe,CAAC;AAC1I,OAAO,EAAE,iBAAiB,EAAoE,WAAW,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAChJ,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,eAAe,EAA8C,MAAM,kCAAkC,CAAC;AAC/G,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,0BAA0B,EAAE,6BAA6B,EAAE,MAAM,4BAA4B,CAAC;AAEvG,iDAAiD;AACjD,MAAM,cAAc,GAAW,2BAA2B,CAAC;AAC3D,gDAAgD;AAChD,MAAM,kBAAkB,GAAW,SAAS,CAAC;AAE7C;;;;GAIG;AACH,SAAS,cAAc;IACrB,OAAO,cAAc,CAAC,EAAE,EAAE,SAAS,EAAE,kBAAkB,CAAC,CAAC;AAC3D,CAAC;AAED,qCAAqC;AACrC,MAAM,aAAa,GAAG;IACpB,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,gFAAgF,EAAE,CAAC;IACpK,OAAO,EAAE;QACP,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,sEAAsE,EAAE;KAC1G;CACgC,CAAC;AAEpC;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,eAAe,CAAC;IAC1C,IAAI,EAAE,OAAO;IACb,OAAO,EAAE,aAAa;IACtB,IAAI,EAAE;QACJ,OAAO,EAAE,8EAA8E;QACvF,WAAW,EAAE,2FAA2F;cACpG,oGAAoG;cACpG,qGAAqG;cACrG,wGAAwG;cACxG,yGAAyG;cACzG,uEAAuE;QAC3E,QAAQ,EAAE,SAAS;QACnB,QAAQ,EAAE;YACR,iEAAiE;YACjE,6DAA6D;YAC7D,yFAAyF;YACzF,+EAA+E;SAChF;KACF;IACD,sFAAsF;IACtF,KAAK,EAAE,EAAE;IACT,OAAO,EAAE,CAAC,IAA4C,EAA4B,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC;CACvI,CAAC,CAAC;AAEH;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAc;IAChD,OAAO,mBAAmB,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;AACjD,CAAC;AAED;;;;;;;GAOG;AACH,KAAK,UAAU,SAAS,CAAC,MAA0B,EAAE,KAAc;IACjE,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,WAAW,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC;IACnE,0BAA0B,EAAE,CAAC;IAC7B,MAAM,MAAM,GAA4B,6BAA6B,EAAE,CAAC;IACxE,wEAAwE;IACxE,MAAM,YAAY,GAAG,GAAY,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;IAC7D,MAAM,QAAQ,GAAW,MAAM,YAAY,CAAC,MAAM,CAAC,CAAC;IACpD,IAAI,YAAY,EAAE;QAAE,OAAO,cAAc,EAAE,CAAC;IAE5C,4EAA4E;IAC5E,IAAI,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,GAAW,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,QAAQ,CAAC;QAC3D,MAAM,KAAK,GAAmB,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;QAChG,OAAO,WAAW,CAChB,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,KAAK,KAAK,CAAC,IAAI,CAAC,yEAAyE,CAAC,IAAI,EAC5H,EAAE,IAAI,EAAE,iBAAiB,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAC9C,CAAC;IACJ,CAAC;IAED,qEAAqE;IACrE,MAAM,MAAM,GAAW,kBAAkB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;IACnH,MAAM,cAAc,GAAuB,MAAM,kBAAkB,EAAE,CAAC;IACtE,MAAM,OAAO,GAA+B,MAAM,qBAAqB,CAAC,MAAM,EAAE,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACxI,IAAI,YAAY,EAAE;QAAE,OAAO,cAAc,EAAE,CAAC;IAC5C,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC;QAChB,YAAY,CAAC,CAAC,CAAC,CAAC;QAChB,OAAO,cAAc,CAAC,EAAE,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,UAAU,MAAM,iDAAiD,CAAC,IAAI,CAAC,CAAC;IAC5H,CAAC;IACD,MAAM,MAAM,GAAqB,OAAO,CAAC,KAAK,CAAC;IAC/C,MAAM,KAAK,GAAmB,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IAChG,4EAA4E;IAC5E,6EAA6E;IAC7E,MAAM,SAAS,GAAW,MAAM,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC9D,MAAM,UAAU,GAAW,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,iBAAiB,IAAI,MAAM,KAAK,aAAa,CAAC,MAAM,CAAC,GAAG,SAAS,EAAE,CAAC;IAChI,OAAO,WAAW,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,iBAAiB,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;AAChF,CAAC;AAED;;;;;;;;GAQG;AACH,KAAK,UAAU,qBAAqB,CAAC,MAAwB;IAC3D,MAAM,KAAK,GAAuB,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC;IACrG,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACnC,MAAM,IAAI,GAA6B,MAAM,eAAe,CAAC,KAAK,CAAC,CAAC;IACpE,IAAI,CAAC,IAAI,CAAC,EAAE;QAAE,OAAO,EAAE,CAAC;IACxB,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;QACrC,OAAO,KAAK,KAAK,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,cAAc,sDAAsD,CAAC,IAAI,CAAC;IACpH,CAAC;IACD,OAAO,KAAK,gBAAgB,CAAC,IAAI,CAAC,KAAK,EAAE,WAAW,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;AAC/E,CAAC;AAED,wEAAwE;AACxE,KAAK,UAAU,kBAAkB;IAC/B,MAAM,IAAI,GAAkB,CAAC,MAAM,iBAAiB,EAAE,CAAC,CAAC,IAAI,CAAC;IAC7D,OAAO,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,IAAI,cAAc,CAAC;AACjE,CAAC"}

package/dist/builtins/res/play.d.ts

@@ -70,21 +70,83 @@ interface PlayArgs {
     parseError: string | null;
 }
 /**
- * Parses `play`'s own arguments.
+ * `play <manifest> [--param NAME=value]… [--pace <duration>] [--dry-run] [--status [--text <script>]]`: the declaration.
  *
- * Hand-parsed because `--param` repeats, and a generic parser keeps only the
- * last of a repeated option — which would silently drop every parameter but
- * one and play the manifest with the wrong values.
+ * @example
+ * ```ts
+ * commands_register({ declarations: [playCommand] });
+ * ```
+ */
+export declare const playCommand: import("../../core/commandDeclaration.js").CommandDeclaration<{
+    readonly operands: readonly [{
+        readonly name: "manifest";
+        readonly kind: "cfsPath";
+        readonly glob: true;
+        readonly summary: "The manifest: read from the session's filesystem first, the engine's disk second";
+    }];
+    readonly options: {
+        readonly param: {
+            readonly long: "param";
+            readonly repeat: true;
+            readonly summary: "Supply a parameter the manifest declares (repeatable)";
+            readonly value: {
+                readonly name: "NAME=value";
+                readonly kind: "word";
+            };
+        };
+        readonly pace: {
+            readonly long: "pace";
+            readonly summary: "Wait between lines, for watching a play at a surface";
+            readonly value: {
+                readonly name: "duration";
+                readonly kind: "word";
+            };
+        };
+        readonly dryRun: {
+            readonly long: "dry-run";
+            readonly summary: "Expand the lines and show them without running any";
+        };
+        readonly status: {
+            readonly long: "status";
+            readonly summary: "Run nothing: say where each line stands, from what the backend keeps";
+        };
+        readonly text: {
+            readonly long: "text";
+            readonly summary: "With --status: the script's text, read in place of the file's";
+            readonly value: {
+                readonly name: "script";
+                readonly kind: "word";
+            };
+        };
+        readonly step: {
+            readonly long: "step";
+            readonly summary: "Refused: a keypress needs a terminal; at a surface, play with --pace";
+        };
+    };
+}>;
+/**
+ * Reads `play`'s own words as its declaration parses them, with the checks
+ * the parse cannot make: the request a line makes, or why it makes none.
  *
- * @param args - The tokens after `play`.
- * @returns What was asked for.
+ * @param args - The words after `play`, as literals.
+ * @returns What was asked for; `parseError` holds a refusal, the parser's or a check's.
+ *
+ * @example
+ * ```ts
+ * (await playArgs_parse(['f.mise', '--param', 'MRN=1'])).params.get('MRN'); // '1'
+ * ```
  */
-export declare function playArgs_parse(args: string[]): PlayArgs;
+export declare function playArgs_parse(args: string[]): Promise<PlayArgs>;
 /**
- * Builtin handler for the `play` command.
+ * `play` over words already split: the declaration's parse and handler.
  *
- * @param args - Parsed command arguments.
+ * @param args - The words after `play`.
  * @returns An envelope carrying what the play did, or the refusal that stopped it.
+ *
+ * @example
+ * ```ts
+ * await builtin_play(['~/flows/battery.mise', '--dry-run']);
+ * ```
  */
 export declare function builtin_play(args: string[]): Promise<CommandEnvelope>;
 export {};