@fnndsc/brasa 0.56.2 → 0.56.3

package/dist/builtins/fs/acl.js

@@ -7,62 +7,148 @@
  * a group's grant, and `chmod o±r` is the other entry spelled as a mode.
  * `share X with Y` is a sentence; it lands nowhere in a terminal.
  *
- * The capability itself lives in the kernel (cumin `feed_share`,
+ * Each is declared in one record: the feeds are path operands that glob,
+ * `setfacl`'s entry an option's value, `chmod`'s mode one of two words. The
+ * capability itself lives in the kernel (cumin `feed_share`,
  * `feedShare_group`, `feedShare_revoke`, `feedAccess_read`,
  * `feed_makePublic`, `feed_makePrivate`). This is its shell face.
  *
+ * Key components:
+ * - setfaclCommand, getfaclCommand, chmodCommand: the declarations.
+ * - builtin_setfacl, builtin_getfacl, builtin_chmod: each declaration run over words already split.
+ *
+ * Typical usage:
+ * ```ts
+ * await builtin_setfacl(['-m', 'u:someone:r', 'feed_12']);
+ * ```
+ *
+ * Dependencies: cumin's sharing calls; the words of an entry and of a feed (`acl.args.ts`).
+ *
  * @module
  */
 import { feed_share, feedShare_group, feedShare_revoke, feedAccess_read, feed_makePublic, feed_makePrivate } from '@fnndsc/cumin';
-import { aclTarget_resolve, acl_render, chmodArgs_parse, setfaclArgs_parse, GETFACL_USAGE, } from './acl.args.js';
+import { aclEntry_parse, aclRemoval_parse, aclTarget_resolve, acl_render, } from './acl.args.js';
 import { errorStack } from '@fnndsc/fond';
 import { envelope_ok, envelope_error } from '@fnndsc/menu';
+import { command_declare } from '../../core/commandDeclaration.js';
+import { declaredCommand_run } from '../../core/commandParse.js';
+/** The feeds a line names, as each of these commands takes them. */
+const FEEDS_OPERAND = {
+    name: 'path',
+    kind: 'cfsPath',
+    repeat: true,
+    glob: true,
+    summary: 'The feeds: an id, feed_N, any path through /feeds/, or /proc/jobs/feed_N',
+};
+/** What a `setfacl` line may hold. */
+const SETFACL_GRAMMAR = {
+    operands: [FEEDS_OPERAND],
+    options: {
+        modify: { short: 'm', long: 'modify', summary: 'Add an entry: u:<user>:r, g:<group>:r, o::r (public) or o::- (private)', value: { name: 'entry', kind: 'word' } },
+        remove: { short: 'x', long: 'remove', summary: 'Withdraw a grant: u:<user> or g:<group>', value: { name: 'entry', kind: 'word' } },
+    },
+};
 /**
- * Adds or modifies an access control entry on a feed.
+ * The feeds some targets name, in order.
  *
- * @param args - Raw argument tokens.
- * @returns An envelope naming what was granted.
+ * @param verb - The command, for its refusal.
+ * @param paths - The targets as the line gave them.
+ * @param distinct - Whether a feed named twice counts once.
+ * @returns The feed ids, or the refusal of the first target that names none.
  */
-export async function builtin_setfacl(args) {
-    let parsed = setfaclArgs_parse(args);
-    // A path and no entry names WHAT to share and not WITH WHOM, which is a
-    // question rather than a usage error (an-absent-value-is-a-question). The
-    // grant CUBE offers is read on a feed, so the only thing missing is the
-    // identity: ask for it, and refuse as before when it is not answered.
-    if (parsed.error !== null && entryless_is(args)) {
-        const paths = args.filter((token) => !token.startsWith('-'));
-        const feedIDs = [];
-        for (const path of paths) {
-            const feedID = aclTarget_resolve(path);
-            if (feedID === null) {
-                return envelope_error(`setfacl: '${path}' does not name a feed\n`);
-            }
-            if (!feedIDs.includes(feedID))
-                feedIDs.push(feedID);
-        }
-        // One question for the whole set: a grant is per identity, and asking
-        // who once for twenty feeds is the same answer twenty times.
-        const who = (await who_ask(feedIDs)).trim();
-        if (who === '') {
-            const named = feedIDs.map((id) => `feed_${id}`).join(' ');
-            return envelope_error(`setfacl: nobody named; ${named} shared with no one new\n`);
-        }
-        parsed = setfaclArgs_parse(['-m', `u:${who}:r`, ...paths]);
-    }
-    if (parsed.error !== null)
-        return envelope_error(`${parsed.error}\n`);
+function feedIDs_resolve(verb, paths, distinct) {
     const feedIDs = [];
-    for (const path of parsed.paths) {
+    for (const path of paths) {
         const feedID = aclTarget_resolve(path);
         if (feedID === null)
-            return envelope_error(`setfacl: '${path}' does not name a feed\n`);
-        feedIDs.push(feedID);
+            return envelope_error(`${verb}: '${path}' does not name a feed\n`);
+        if (!distinct || !feedIDs.includes(feedID))
+            feedIDs.push(feedID);
+    }
+    return feedIDs;
+}
+/**
+ * Adds or modifies an access control entry on feeds, or withdraws a grant;
+ * given feeds and no entry, asks whom to share them with.
+ *
+ * @param args - The line, parsed.
+ * @returns An envelope naming what was granted or withdrawn.
+ */
+async function setfacl_run(args) {
+    const { modify, remove } = args.options;
+    if (remove !== undefined) {
+        const removal = aclRemoval_parse(remove);
+        if (typeof removal === 'string')
+            return envelope_error(`${removal}\n`);
+        const feedIDs = feedIDs_resolve('setfacl', args.operands.path, false);
+        return Array.isArray(feedIDs) ? acl_remove(removal, feedIDs) : feedIDs;
+    }
+    if (modify !== undefined) {
+        const entry = aclEntry_parse(modify);
+        if (entry === null)
+            return envelope_error(`setfacl: '${modify}' is not an entry (want u:<user>:r, g:<group>:r, o::r or o::-)\n`);
+        const feedIDs = feedIDs_resolve('setfacl', args.operands.path, false);
+        return Array.isArray(feedIDs) ? acl_apply(entry, feedIDs, 'setfacl') : feedIDs;
     }
-    if (parsed.remove !== null)
-        return acl_remove(parsed.remove, feedIDs);
-    if (parsed.modify === null)
-        return envelope_error(`${parsed.error ?? 'setfacl: nothing to do'}\n`);
-    return acl_apply(parsed.modify, feedIDs, 'setfacl');
+    // A path and no entry names WHAT to share and not WITH WHOM, which is a
+    // question rather than a usage error (an-absent-value-is-a-question). The
+    // grant CUBE offers is read on a feed, so the only thing missing is the
+    // identity: ask for it, and refuse when it is not answered.
+    const feedIDs = feedIDs_resolve('setfacl', args.operands.path, true);
+    if (!Array.isArray(feedIDs))
+        return feedIDs;
+    // One question for the whole set: a grant is per identity, and asking
+    // who once for twenty feeds is the same answer twenty times.
+    const who = (await who_ask(feedIDs)).trim();
+    if (who === '') {
+        const named = feedIDs.map((id) => `feed_${id}`).join(' ');
+        return envelope_error(`setfacl: nobody named; ${named} shared with no one new\n`);
+    }
+    return acl_apply({ kind: 'user', name: who, perms: 'r' }, feedIDs, 'setfacl');
+}
+/**
+ * `setfacl [-m <entry>] [-x <entry>] <path>…`: the declaration.
+ *
+ * @example
+ * ```ts
+ * commands_register({ declarations: [setfaclCommand] }, 'backend');
+ * ```
+ */
+export const setfaclCommand = command_declare({
+    name: 'setfacl',
+    grammar: SETFACL_GRAMMAR,
+    help: {
+        summary: 'Share a feed with a user, a group or everyone, or stop sharing it',
+        description: 'A feed\'s access list, as POSIX ACL entries. -m u:<user>:r shares it with a user, -m g:<group>:r '
+            + 'with a group, -m o::r with everyone (a public feed) and -m o::- makes it private again. '
+            + '-x u:<user> or -x g:<group> withdraws that grant. A feed is named by id, by the feed_N a '
+            + 'listing shows, by any path through /feeds/, or by /proc/jobs/feed_N. Given a feed and no '
+            + 'entry, it asks which user to share it with.',
+        category: 'Sharing',
+        posix: { group: 'Files', differs: 'ChRIS sharing, as ACL entries' },
+        examples: [
+            'setfacl -m u:someone:r /home/me/feeds/feed_12',
+            'setfacl -m g:grantlab:r feed_12 feed_13',
+            'setfacl -m o::r feed_12                  # public',
+            'setfacl -x u:someone feed_12',
+            'setfacl feed_12                          # asks who to share it with',
+        ],
+    },
+    handler: setfacl_run,
+});
+/**
+ * `setfacl` over words already split: the declaration's parse and handler.
+ *
+ * @param args - The words after `setfacl`.
+ * @returns An envelope naming what was granted, or the refusal of a bad line.
+ *
+ * @example
+ * ```ts
+ * await builtin_setfacl(['-x', 'u:someone', 'feed_12']);
+ * ```
+ */
+export async function builtin_setfacl(args) {
+    return declaredCommand_run(setfaclCommand, args);
 }
 /**
  * Applies one entry to feeds: a user or group granted read, or the other
@@ -128,36 +214,63 @@ async function acl_remove(removal, feedIDs) {
         lines.unshift(`${removal.kind} ${removal.name} no longer reads ${removed.join(' ')}`);
     return envelope_ok(`${lines.join('\n')}\n`, { kind: 'fs.acl.removed', data: { kind: removal.kind, name: removal.name, targets: removed } });
 }
+/** What a `chmod` line may hold: a feed's one mode, then the feeds. */
+const CHMOD_GRAMMAR = {
+    operands: [
+        { name: 'mode', kind: 'enum', values: ['o+r', 'o-r'], summary: 'o+r makes the feeds public, o-r private: no other mode is one a feed has' },
+        FEEDS_OPERAND,
+    ],
+};
 /**
  * `chmod o+r` / `o-r` on feeds: the other entry, public or private, as
- * `setfacl -m o::r` / `o::-` writes it. No other mode is one a feed has.
+ * `setfacl -m o::r` / `o::-` writes it.
  *
- * @param args - Raw argument tokens.
+ * @param args - The line, parsed.
  * @returns An envelope naming what changed.
  */
-export async function builtin_chmod(args) {
-    const parsed = chmodArgs_parse(args);
-    if (typeof parsed === 'string')
-        return envelope_error(`${parsed}\n`);
-    const feedIDs = [];
-    for (const path of parsed.paths) {
-        const feedID = aclTarget_resolve(path);
-        if (feedID === null)
-            return envelope_error(`chmod: '${path}' does not name a feed\n`);
-        feedIDs.push(feedID);
-    }
-    return acl_apply(parsed.entry, feedIDs, 'chmod');
+async function chmod_run(args) {
+    const feedIDs = feedIDs_resolve('chmod', args.operands.path, false);
+    if (!Array.isArray(feedIDs))
+        return feedIDs;
+    return acl_apply({ kind: 'other', name: '', perms: args.operands.mode === 'o+r' ? 'r' : '-' }, feedIDs, 'chmod');
 }
 /**
- * Whether an invocation names paths but no entry to apply to them.
+ * `chmod <o+r|o-r> <path>…`: the declaration.
+ *
+ * @example
+ * ```ts
+ * commands_register({ declarations: [chmodCommand] }, 'backend');
+ * ```
+ */
+export const chmodCommand = command_declare({
+    name: 'chmod',
+    grammar: CHMOD_GRAMMAR,
+    help: {
+        summary: 'Make a feed public, or private again',
+        description: 'The other entry of a feed\'s access list spelled as a mode: o+r makes it public, o-r private, '
+            + 'exactly as setfacl -m o::r and o::- do. No other mode is one a feed has.',
+        category: 'Sharing',
+        posix: { group: 'Files', differs: 'sets who may see a feed or folder (ChRIS sharing)' },
+        examples: [
+            'chmod o+r feed_12',
+            'chmod o-r /proc/jobs/feed_12',
+        ],
+    },
+    handler: chmod_run,
+});
+/**
+ * `chmod` over words already split: the declaration's parse and handler.
+ *
+ * @param args - The words after `chmod`.
+ * @returns An envelope naming what changed, or the refusal of a bad line.
  *
- * @param args - Raw argument tokens.
- * @returns True when there is something to share and nobody to share with.
+ * @example
+ * ```ts
+ * await builtin_chmod(['o+r', 'feed_12']);
+ * ```
  */
-function entryless_is(args) {
-    const flagged = args.some((token) => token === '-m' || token === '-x' || token.startsWith('--'));
-    const paths = args.filter((token) => !token.startsWith('-'));
-    return !flagged && paths.length >= 1;
+export async function builtin_chmod(args) {
+    return declaredCommand_run(chmodCommand, args);
 }
 /**
  * Asks which identity a feed should be shared with.
@@ -179,19 +292,20 @@ async function who_ask(feedIDs) {
         return '';
     }
 }
+/** What a `getfacl` line may hold. */
+const GETFACL_GRAMMAR = {
+    operands: [FEEDS_OPERAND],
+};
 /**
  * Reports a feed's access list, in `getfacl`'s own shape.
  *
- * @param args - Raw argument tokens.
+ * @param args - The line, parsed.
  * @returns An envelope carrying the rendered list.
  */
-export async function builtin_getfacl(args) {
-    const paths = args.filter((token) => !token.startsWith('-'));
-    if (paths.length === 0)
-        return envelope_error(`${GETFACL_USAGE}\n`);
+async function getfacl_run(args) {
     const blocks = [];
     const model = [];
-    for (const path of paths) {
+    for (const path of args.operands.path) {
         const feedID = aclTarget_resolve(path);
         if (feedID === null) {
             return envelope_error(`getfacl: '${path}' does not name a feed\n`);
@@ -206,4 +320,44 @@ export async function builtin_getfacl(args) {
     }
     return envelope_ok(`${blocks.join('\n\n')}\n`, { kind: 'fs.acl', data: model });
 }
+/**
+ * `getfacl <path>…`: the declaration.
+ *
+ * @example
+ * ```ts
+ * commands_register({ declarations: [getfaclCommand] }, 'backend');
+ * ```
+ */
+export const getfaclCommand = command_declare({
+    name: 'getfacl',
+    grammar: GETFACL_GRAMMAR,
+    help: {
+        summary: 'Show who can read a feed: users, groups, and whether it is public',
+        description: 'Show who can read a feed, in the familiar block: a # file: line, the owner\'s user:: entry, '
+            + 'one user: line per user and one group: line per group holding access, then other:: '
+            + '(r-- when the feed is public).',
+        category: 'Sharing',
+        posix: { group: 'Files', differs: 'who a feed or folder is shared with, as ACL entries' },
+        examples: [
+            'getfacl /home/me/feeds/feed_12',
+        ],
+    },
+    // Reading an access list changes nothing of the session.
+    holds: [],
+    handler: getfacl_run,
+});
+/**
+ * `getfacl` over words already split: the declaration's parse and handler.
+ *
+ * @param args - The words after `getfacl`.
+ * @returns The access lists, or the refusal of a bad line.
+ *
+ * @example
+ * ```ts
+ * await builtin_getfacl(['feed_12']);
+ * ```
+ */
+export async function builtin_getfacl(args) {
+    return declaredCommand_run(getfaclCommand, args);
+}
 //# sourceMappingURL=acl.js.map

package/dist/builtins/fs/acl.js.map

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

package/dist/builtins/fs/cat.args.d.ts

@@ -1,36 +1,35 @@
 /**
- * @file Shared `cat` command-line grammar.
+ * @file What of `cat`'s line other modules read without loading cat.
  *
- * Defines the typed result used by the builtin, the usage text shown in help
- * and errors, and the option predicate used by redirect filename inference.
- * This module is intentionally dependency-free so preprocessing can consume
- * the grammar without loading the file reader or syntax highlighter.
+ * Defines the typed options the core reads, the usage text, and the option
+ * predicate redirect filename inference uses. The line itself is parsed
+ * against `catCommand`'s grammar (`cat.ts`). This module is intentionally
+ * dependency-free so preprocessing can consume it without loading the file
+ * reader or syntax highlighter.
  *
  * @module
  */
 /** Whether syntax highlighting follows TTY detection, is forced, or is disabled. */
 export type CatHighlightMode = 'auto' | 'always' | 'never';
-/** Parsed `cat` command-line arguments. */
+/** The typed core's options: which files, and how they are presented. */
 export interface CatArguments {
     binaryMode: boolean;
     highlightMode: CatHighlightMode;
     highlightLanguage?: string;
     filePaths: string[];
 }
-/** Canonical usage shared by builtin errors and interactive help. */
+/** Canonical usage shared by the typed core's refusal and interactive help. */
 export declare const CAT_USAGE: string;
 /**
  * Returns whether an argument belongs to the `cat` option grammar.
  *
  * @param argument - One token from the command line.
  * @returns True for a recognized binary or highlight option.
- */
-export declare function catArgument_isOption(argument: string): boolean;
-/**
- * Parses file paths and presentation options for the `cat` builtin.
- * Later highlight flags take precedence over earlier highlight flags.
  *
- * @param args - Tokens following the `cat` command name.
- * @returns Typed binary, highlighting, language, and file-path selections.
+ * @example
+ * ```ts
+ * catArgument_isOption('--highlight=python'); // true
+ * catArgument_isOption('notes.txt');          // false
+ * ```
  */
-export declare function catArguments_parse(args: string[]): CatArguments;
+export declare function catArgument_isOption(argument: string): boolean;

package/dist/builtins/fs/cat.args.js

@@ -1,14 +1,15 @@
 /**
- * @file Shared `cat` command-line grammar.
+ * @file What of `cat`'s line other modules read without loading cat.
  *
- * Defines the typed result used by the builtin, the usage text shown in help
- * and errors, and the option predicate used by redirect filename inference.
- * This module is intentionally dependency-free so preprocessing can consume
- * the grammar without loading the file reader or syntax highlighter.
+ * Defines the typed options the core reads, the usage text, and the option
+ * predicate redirect filename inference uses. The line itself is parsed
+ * against `catCommand`'s grammar (`cat.ts`). This module is intentionally
+ * dependency-free so preprocessing can consume it without loading the file
+ * reader or syntax highlighter.
  *
  * @module
  */
-/** Canonical usage shared by builtin errors and interactive help. */
+/** Canonical usage shared by the typed core's refusal and interactive help. */
 export const CAT_USAGE = 'cat [--binary] [--highlight[=language] | --no-highlight] <file> [file...]';
 const BINARY_OPTION = '--binary';
 const HIGHLIGHT_OPTION = '--highlight';
@@ -19,6 +20,12 @@ const NO_HIGHLIGHT_OPTION = '--no-highlight';
  *
  * @param argument - One token from the command line.
  * @returns True for a recognized binary or highlight option.
+ *
+ * @example
+ * ```ts
+ * catArgument_isOption('--highlight=python'); // true
+ * catArgument_isOption('notes.txt');          // false
+ * ```
  */
 export function catArgument_isOption(argument) {
     return argument === BINARY_OPTION
@@ -26,38 +33,4 @@ export function catArgument_isOption(argument) {
         || argument === NO_HIGHLIGHT_OPTION
         || argument.startsWith(HIGHLIGHT_LANGUAGE_PREFIX);
 }
-/**
- * Parses file paths and presentation options for the `cat` builtin.
- * Later highlight flags take precedence over earlier highlight flags.
- *
- * @param args - Tokens following the `cat` command name.
- * @returns Typed binary, highlighting, language, and file-path selections.
- */
-export function catArguments_parse(args) {
-    let binaryMode = false;
-    let highlightMode = 'auto';
-    let highlightLanguage;
-    const filePaths = [];
-    for (const argument of args) {
-        if (argument === BINARY_OPTION) {
-            binaryMode = true;
-        }
-        else if (argument === HIGHLIGHT_OPTION) {
-            highlightMode = 'always';
-            highlightLanguage = undefined;
-        }
-        else if (argument.startsWith(HIGHLIGHT_LANGUAGE_PREFIX)) {
-            highlightMode = 'always';
-            highlightLanguage = argument.slice(HIGHLIGHT_LANGUAGE_PREFIX.length);
-        }
-        else if (argument === NO_HIGHLIGHT_OPTION) {
-            highlightMode = 'never';
-            highlightLanguage = undefined;
-        }
-        else {
-            filePaths.push(argument);
-        }
-    }
-    return { binaryMode, highlightMode, highlightLanguage, filePaths };
-}
 //# sourceMappingURL=cat.args.js.map

package/dist/builtins/fs/cat.args.js.map

@@ -1 +1 @@
-{"version":3,"file":"cat.args.js","sourceRoot":"","sources":["../../../src/builtins/fs/cat.args.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAaH,qEAAqE;AACrE,MAAM,CAAC,MAAM,SAAS,GACpB,2EAA2E,CAAC;AAE9E,MAAM,aAAa,GAAW,UAAU,CAAC;AACzC,MAAM,gBAAgB,GAAW,aAAa,CAAC;AAC/C,MAAM,yBAAyB,GAAW,cAAc,CAAC;AACzD,MAAM,mBAAmB,GAAW,gBAAgB,CAAC;AAErD;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,QAAgB;IACnD,OAAO,QAAQ,KAAK,aAAa;WAC5B,QAAQ,KAAK,gBAAgB;WAC7B,QAAQ,KAAK,mBAAmB;WAChC,QAAQ,CAAC,UAAU,CAAC,yBAAyB,CAAC,CAAC;AACtD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAc;IAC/C,IAAI,UAAU,GAAY,KAAK,CAAC;IAChC,IAAI,aAAa,GAAqB,MAAM,CAAC;IAC7C,IAAI,iBAAqC,CAAC;IAC1C,MAAM,SAAS,GAAa,EAAE,CAAC;IAE/B,KAAK,MAAM,QAAQ,IAAI,IAAI,EAAE,CAAC;QAC5B,IAAI,QAAQ,KAAK,aAAa,EAAE,CAAC;YAC/B,UAAU,GAAG,IAAI,CAAC;QACpB,CAAC;aAAM,IAAI,QAAQ,KAAK,gBAAgB,EAAE,CAAC;YACzC,aAAa,GAAG,QAAQ,CAAC;YACzB,iBAAiB,GAAG,SAAS,CAAC;QAChC,CAAC;aAAM,IAAI,QAAQ,CAAC,UAAU,CAAC,yBAAyB,CAAC,EAAE,CAAC;YAC1D,aAAa,GAAG,QAAQ,CAAC;YACzB,iBAAiB,GAAG,QAAQ,CAAC,KAAK,CAAC,yBAAyB,CAAC,MAAM,CAAC,CAAC;QACvE,CAAC;aAAM,IAAI,QAAQ,KAAK,mBAAmB,EAAE,CAAC;YAC5C,aAAa,GAAG,OAAO,CAAC;YACxB,iBAAiB,GAAG,SAAS,CAAC;QAChC,CAAC;aAAM,CAAC;YACN,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,iBAAiB,EAAE,SAAS,EAAE,CAAC;AACrE,CAAC"}
+{"version":3,"file":"cat.args.js","sourceRoot":"","sources":["../../../src/builtins/fs/cat.args.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAaH,+EAA+E;AAC/E,MAAM,CAAC,MAAM,SAAS,GACpB,2EAA2E,CAAC;AAE9E,MAAM,aAAa,GAAW,UAAU,CAAC;AACzC,MAAM,gBAAgB,GAAW,aAAa,CAAC;AAC/C,MAAM,yBAAyB,GAAW,cAAc,CAAC;AACzD,MAAM,mBAAmB,GAAW,gBAAgB,CAAC;AAErD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,oBAAoB,CAAC,QAAgB;IACnD,OAAO,QAAQ,KAAK,aAAa;WAC5B,QAAQ,KAAK,gBAAgB;WAC7B,QAAQ,KAAK,mBAAmB;WAChC,QAAQ,CAAC,UAAU,CAAC,yBAAyB,CAAC,CAAC;AACtD,CAAC"}

package/dist/builtins/fs/cat.d.ts

@@ -8,7 +8,44 @@ export interface CatOutcome {
     bytes?: number;
 }
 /**
- * Displays the content of one or more files.
+ * `cat [--binary] [--highlight[=<language>]] [--no-highlight] <files…>`: the declaration.
+ *
+ * @example
+ * ```ts
+ * commands_register({ declarations: [catCommand] });
+ * ```
+ */
+export declare const catCommand: import("../../core/commandDeclaration.js").CommandDeclaration<{
+    readonly operands: readonly [{
+        readonly name: "files";
+        readonly kind: "cfsPath";
+        readonly repeat: true;
+        readonly glob: true;
+        readonly summary: "The files to print, in order";
+    }];
+    readonly options: {
+        readonly binary: {
+            readonly long: "binary";
+            readonly summary: "Force byte-for-byte binary output";
+        };
+        readonly highlight: {
+            readonly long: "highlight";
+            readonly summary: "Force highlighting: in a cli-highlight language such as python, typescript, or sql; given none, inferred from the filename or content";
+            readonly value: {
+                readonly name: "language";
+                readonly kind: "word";
+                readonly optional: true;
+            };
+        };
+        readonly noHighlight: {
+            readonly long: "no-highlight";
+            readonly summary: "Disable automatic syntax highlighting (wins over --highlight)";
+        };
+    };
+}>;
+/**
+ * Displays the content of one or more files: the declaration's parse and
+ * handler over words already split.
  *
  * Supports multiple files and concatenates their output. Binary mode is applied
  * per recognized file, or consistently to all files when `--binary` is specified.
@@ -17,9 +54,9 @@ export interface CatOutcome {
  * and the binary auto-detection notice is emitted live on the err channel so it
  * precedes the bytes it describes.
  *
- * @param args - File paths plus optional binary/highlight flags.
+ * @param args - The words after `cat`.
  * @returns An envelope whose rendered text carries the (highlighted) file
- *   contents and whose model lists per-file outcomes.
+ *   contents and whose model lists per-file outcomes, or the refusal of a bad line.
  */
 export declare function builtin_cat(args: string[]): Promise<CommandEnvelope>;
 /**