@fnndsc/brasa 0.56.2 → 0.56.3

package/dist/builtins/sys/cal.d.ts

@@ -1,11 +1,50 @@
 import { CommandEnvelope } from '@fnndsc/menu';
 /**
- * Reports a calendar as a command envelope.
+ * `cal [[month] year]`: the declaration.
  *
- * `cal` shows the current month; `cal <year>` a whole year; `cal <month> <year>`
- * a specific month.
+ * @example
+ * ```ts
+ * commands_register({ declarations: [calCommand] });
+ * ```
+ */
+export declare const calCommand: import("../../core/commandDeclaration.js").CommandDeclaration<{
+    readonly operands: readonly [{
+        readonly name: "month";
+        readonly kind: "int";
+        readonly optional: true;
+        readonly summary: "The month, 1 to 12; with no year after it, the year";
+    }, {
+        readonly name: "year";
+        readonly kind: "int";
+        readonly optional: true;
+        readonly summary: "The year, 1 to 9999";
+    }];
+}>;
+/**
+ * `cal` over words already split: the declaration's parse and handler.
  *
- * @param args - Command arguments.
- * @returns An envelope carrying the calendar, or an error envelope on bad input.
+ * @param args - The words after `cal`.
+ * @returns The calendar, or the refusal of a bad line.
+ *
+ * @example
+ * ```ts
+ * await builtin_cal(['7', '2026']);
+ * ```
  */
 export declare function builtin_cal(args: string[]): Promise<CommandEnvelope>;
+/**
+ * Reports a calendar as a command envelope.
+ *
+ * With neither, the current month; with a year alone, the whole year; with
+ * both, that month.
+ *
+ * @param month - The month, 1 to 12, or undefined for none.
+ * @param year - The year, 1 to 9999, or undefined for none.
+ * @returns An envelope carrying the calendar, or an error envelope on a month or year out of range.
+ *
+ * @example
+ * ```ts
+ * await cal_run(7, 2026);
+ * ```
+ */
+export declare function cal_run(month: number | undefined, year: number | undefined): Promise<CommandEnvelope>;

package/dist/builtins/sys/cal.js

@@ -11,6 +11,8 @@
  */
 import chalk from 'chalk';
 import { envelope_ok, envelope_error } from '@fnndsc/menu';
+import { command_declare } from '../../core/commandDeclaration.js';
+import { declaredCommand_run } from '../../core/commandParse.js';
 const MONTHS_LONG = [
     'January', 'February', 'March', 'April', 'May', 'June',
     'July', 'August', 'September', 'October', 'November', 'December',
@@ -82,29 +84,74 @@ function calendar_year(year, today) {
     }
     return `${lines.join('\n')}\n`;
 }
+/** What a `cal` line may hold. */
+const CAL_GRAMMAR = {
+    operands: [
+        { name: 'month', kind: 'int', optional: true, summary: 'The month, 1 to 12; with no year after it, the year' },
+        { name: 'year', kind: 'int', optional: true, summary: 'The year, 1 to 9999' },
+    ],
+};
 /**
- * Reports a calendar as a command envelope.
+ * `cal [[month] year]`: the declaration.
+ *
+ * @example
+ * ```ts
+ * commands_register({ declarations: [calCommand] });
+ * ```
+ */
+export const calCommand = command_declare({
+    name: 'cal',
+    grammar: CAL_GRAMMAR,
+    help: {
+        summary: 'Print a calendar',
+        description: 'Prints a month or year calendar with today highlighted, in the spirit of UNIX cal.',
+        examples: ['cal', 'cal 2026', 'cal 7 2026'],
+        category: 'Games',
+        posix: { group: 'System', differs: 'as cal' },
+    },
+    holds: [],
+    handler: async (args) => args.operands.year === undefined ? cal_run(undefined, args.operands.month) : cal_run(args.operands.month, args.operands.year),
+});
+/**
+ * `cal` over words already split: the declaration's parse and handler.
  *
- * `cal` shows the current month; `cal <year>` a whole year; `cal <month> <year>`
- * a specific month.
+ * @param args - The words after `cal`.
+ * @returns The calendar, or the refusal of a bad line.
  *
- * @param args - Command arguments.
- * @returns An envelope carrying the calendar, or an error envelope on bad input.
+ * @example
+ * ```ts
+ * await builtin_cal(['7', '2026']);
+ * ```
  */
 export async function builtin_cal(args) {
+    return declaredCommand_run(calCommand, args);
+}
+/**
+ * Reports a calendar as a command envelope.
+ *
+ * With neither, the current month; with a year alone, the whole year; with
+ * both, that month.
+ *
+ * @param month - The month, 1 to 12, or undefined for none.
+ * @param year - The year, 1 to 9999, or undefined for none.
+ * @returns An envelope carrying the calendar, or an error envelope on a month or year out of range.
+ *
+ * @example
+ * ```ts
+ * await cal_run(7, 2026);
+ * ```
+ */
+export async function cal_run(month, year) {
     const now = new Date();
     const today = { year: now.getFullYear(), month: now.getMonth(), day: now.getDate() };
-    const nums = args.filter((a) => /^\d+$/.test(a)).map(Number);
-    if (nums.length === 0) {
+    if (year === undefined) {
         return envelope_ok(calendar_month(today.year, today.month, today), { kind: 'sys.cal', data: { year: today.year, month: today.month + 1 } });
     }
-    if (nums.length === 1) {
-        const year = nums[0];
+    if (month === undefined) {
         if (year < 1 || year > 9999)
             return envelope_error(`${chalk.red(`cal: year ${year} out of range (1..9999)`)}\n`);
         return envelope_ok(calendar_year(year, today), { kind: 'sys.cal', data: { year } });
     }
-    const [month, year] = nums;
     if (month < 1 || month > 12)
         return envelope_error(`${chalk.red(`cal: ${month} is not a month number (1..12)`)}\n`);
     if (year < 1 || year > 9999)

package/dist/builtins/sys/cal.js.map

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

package/dist/builtins/sys/command.d.ts

@@ -8,13 +8,33 @@
  * `command -v` as it always does), reading whatever was piped in:
  * `query … | command grep -i t1` is plain text grep, no listing logic.
  *
+ * Declared in one record (`commandCommand`). Its words after the name are
+ * the host program's own line, options and all, so it declares them its own
+ * (`grammar: 'expression'`): the GNU option grammar would take `grep -i` for
+ * an option of `command`.
+ *
  * @module
  */
 import { CommandEnvelope } from '@fnndsc/menu';
+import type { ExpressionDeclaration } from '../../core/commandDeclaration.js';
+/**
+ * `command <name> [args...]`: the declaration.
+ *
+ * @example
+ * ```ts
+ * commands_register({ declarations: [commandCommand] });
+ * ```
+ */
+export declare const commandCommand: ExpressionDeclaration;
 /**
  * `command <name> [args...]`
  *
  * @param args - The program and its words.
  * @returns What the program wrote, or why it could not run.
+ *
+ * @example
+ * ```ts
+ * await builtin_command(['grep', '-i', 't1']);
+ * ```
  */
 export declare function builtin_command(args: string[]): Promise<CommandEnvelope>;

package/dist/builtins/sys/command.js

@@ -8,6 +8,11 @@
  * `command -v` as it always does), reading whatever was piped in:
  * `query … | command grep -i t1` is plain text grep, no listing logic.
  *
+ * Declared in one record (`commandCommand`). Its words after the name are
+ * the host program's own line, options and all, so it declares them its own
+ * (`grammar: 'expression'`): the GNU option grammar would take `grep -i` for
+ * an option of `command`.
+ *
  * @module
  */
 import { envelope_ok, envelope_error } from '@fnndsc/menu';
@@ -18,11 +23,37 @@ import { surface_get } from '../../core/surface.js';
 function word_quote(word) {
     return /^[\w@%+=:,./-]+$/.test(word) ? word : `'${word.replace(/'/g, `'\\''`)}'`;
 }
+/**
+ * `command <name> [args...]`: the declaration.
+ *
+ * @example
+ * ```ts
+ * commands_register({ declarations: [commandCommand] });
+ * ```
+ */
+export const commandCommand = {
+    name: 'command',
+    grammar: 'expression',
+    help: {
+        usage: 'command <name> [args...]',
+        summary: 'Run the system program of a name, not the builtin',
+        description: 'Run the system program of a name, skipping the chell builtin of the same name. The whole line goes to the host shell as command <name> <args>, reading whatever was piped in: query … | command grep -i t1 is plain text grep. command -v <name> answers as the host shell does.',
+        category: 'General',
+        posix: { group: 'Shell', differs: 'as in any POSIX shell: runs the system\'s program, not the builtin' },
+        examples: ['query PatientID:1234567 | command grep -i t1', 'command -v grep'],
+    },
+    handler: (args) => builtin_command(args),
+};
 /**
  * `command <name> [args...]`
  *
  * @param args - The program and its words.
  * @returns What the program wrote, or why it could not run.
+ *
+ * @example
+ * ```ts
+ * await builtin_command(['grep', '-i', 't1']);
+ * ```
  */
 export async function builtin_command(args) {
     // What was piped in is the program's input; a listing has no meaning there.

package/dist/builtins/sys/command.js.map

@@ -1 +1 @@
-{"version":3,"file":"command.js","sourceRoot":"","sources":["../../../src/builtins/sys/command.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAmB,WAAW,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC5E,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD,6CAA6C;AAC7C,SAAS,UAAU,CAAC,IAAY;IAC9B,OAAO,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC;AACnF,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAc;IAClD,4EAA4E;IAC5E,cAAc,EAAE,CAAC;IACjB,MAAM,KAAK,GAAW,UAAU,EAAE,IAAI,EAAE,CAAC;IACzC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,cAAc,CAAC,EAAE,EAAE,SAAS,EAAE,6FAA6F,CAAC,CAAC;IAC3J,MAAM,OAAO,GAAG,WAAW,EAAE,CAAC;IAC9B,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,YAAY,EAAE,CAAC;QACvC,OAAO,cAAc,CAAC,EAAE,EAAE,SAAS,EAAE,WAAW,IAAI,CAAC,CAAC,CAAC,6CAA6C,CAAC,CAAC;IACxG,CAAC;IACD,MAAM,GAAG,GAAW,MAAM,OAAO,CAAC,WAAW,CAAC,WAAW,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;IACxH,OAAO,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;AAC5C,CAAC"}
+{"version":3,"file":"command.js","sourceRoot":"","sources":["../../../src/builtins/sys/command.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAmB,WAAW,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC5E,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGpD,6CAA6C;AAC7C,SAAS,UAAU,CAAC,IAAY;IAC9B,OAAO,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC;AACnF,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,cAAc,GAA0B;IACnD,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,YAAY;IACrB,IAAI,EAAE;QACJ,KAAK,EAAE,0BAA0B;QACjC,OAAO,EAAE,mDAAmD;QAC5D,WAAW,EAAE,kRAAkR;QAC/R,QAAQ,EAAE,SAAS;QACnB,KAAK,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,oEAAoE,EAAE;QACxG,QAAQ,EAAE,CAAC,8CAA8C,EAAE,iBAAiB,CAAC;KAC9E;IACD,OAAO,EAAE,CAAC,IAAc,EAA4B,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC;CAC7E,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAc;IAClD,4EAA4E;IAC5E,cAAc,EAAE,CAAC;IACjB,MAAM,KAAK,GAAW,UAAU,EAAE,IAAI,EAAE,CAAC;IACzC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,cAAc,CAAC,EAAE,EAAE,SAAS,EAAE,6FAA6F,CAAC,CAAC;IAC3J,MAAM,OAAO,GAAG,WAAW,EAAE,CAAC;IAC9B,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,YAAY,EAAE,CAAC;QACvC,OAAO,cAAc,CAAC,EAAE,EAAE,SAAS,EAAE,WAAW,IAAI,CAAC,CAAC,CAAC,6CAA6C,CAAC,CAAC;IACxG,CAAC;IACD,MAAM,GAAG,GAAW,MAAM,OAAO,CAAC,WAAW,CAAC,WAAW,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;IACxH,OAAO,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;AAC5C,CAAC"}

package/dist/builtins/sys/context.d.ts

@@ -1,7 +1,17 @@
 import { CommandEnvelope } from '@fnndsc/menu';
 /**
- * Displays the current ChRIS context.
+ * `context`: the declaration.
  *
- * @param args - Command line arguments (optional flags).
+ * @example
+ * ```ts
+ * commands_register({ declarations: [contextCommand] }, 'backend');
+ * ```
  */
-export declare function builtin_context(_args: string[]): Promise<CommandEnvelope>;
+export declare const contextCommand: import("../../core/commandDeclaration.js").CommandDeclaration<{}>;
+/**
+ * `context` over words already split: the declaration's parse and handler.
+ *
+ * @param args - The words after `context`: none.
+ * @returns The context table, or the refusal of a bad line.
+ */
+export declare function builtin_context(args: string[]): Promise<CommandEnvelope>;

package/dist/builtins/sys/context.js

@@ -1,18 +1,65 @@
 /**
- * @file Builtin context command.
- * Displays the current session context.
+ * @file `context`: the session's ChRIS context as a table: user, CUBE,
+ * folder, feed, plugin, PACS server and physical mode.
+ *
+ * Declared in one record (`contextCommand`): it takes no operand or option.
+ *
+ * Key components:
+ * - contextCommand: the declaration.
+ * - builtin_context: the declaration run over words already split.
+ *
+ * Typical usage:
+ * ```ts
+ * await builtin_context([]);
+ * ```
+ *
+ * Dependencies: salsa's context; chili's table.
+ *
+ * @module
  */
 import chalk from 'chalk';
 import { context_getSingle } from '@fnndsc/salsa';
 import { session } from '../../session/index.js';
 import { table_render } from '@fnndsc/chili/screen/screen.js';
 import { envelope_ok } from '@fnndsc/menu';
+import { command_declare } from '../../core/commandDeclaration.js';
+import { declaredCommand_run } from '../../core/commandParse.js';
+/** What a `context` line may hold: nothing after the command. */
+const CONTEXT_GRAMMAR = {};
+/**
+ * `context`: the declaration.
+ *
+ * @example
+ * ```ts
+ * commands_register({ declarations: [contextCommand] }, 'backend');
+ * ```
+ */
+export const contextCommand = command_declare({
+    name: 'context',
+    grammar: CONTEXT_GRAMMAR,
+    help: {
+        summary: 'Display current ChRIS context information',
+        description: "Shows the session's ChRIS context as a table: the user, the CUBE URL, the folder, feed and plugin, the PACS server, and whether physical mode is on.",
+        category: 'Connection',
+        examples: ['context'],
+    },
+    handler: async () => context_run(),
+});
+/**
+ * `context` over words already split: the declaration's parse and handler.
+ *
+ * @param args - The words after `context`: none.
+ * @returns The context table, or the refusal of a bad line.
+ */
+export async function builtin_context(args) {
+    return declaredCommand_run(contextCommand, args);
+}
 /**
  * Displays the current ChRIS context.
  *
- * @param args - Command line arguments (optional flags).
+ * @returns The context as a table.
  */
-export async function builtin_context(_args) {
+async function context_run() {
     const context = await context_getSingle();
     const tableData = [
         {

package/dist/builtins/sys/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/builtins/sys/context.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAEjD,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAC9D,OAAO,EAAmB,WAAW,EAAE,MAAM,cAAc,CAAC;AAU5D;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,KAAe;IACnD,MAAM,OAAO,GAAkB,MAAM,iBAAiB,EAAE,CAAC;IAEzD,MAAM,SAAS,GAAiB;QAC9B;YACE,OAAO,EAAE,YAAY;YACrB,KAAK,EAAE,OAAO,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC;SAC7C;QACD;YACE,OAAO,EAAE,WAAW;YACpB,KAAK,EAAE,OAAO,CAAC,GAAG,IAAI,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC;SAC5C;QACD;YACE,OAAO,EAAE,cAAc;YACvB,KAAK,EAAE,OAAO,CAAC,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC;SAC/C;QACD;YACE,OAAO,EAAE,YAAY;YACrB,KAAK,EAAE,OAAO,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC;SAC7C;QACD;YACE,OAAO,EAAE,cAAc;YACvB,KAAK,EAAE,OAAO,CAAC,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC;SAC/C;QACD;YACE,OAAO,EAAE,aAAa;YACtB,KAAK,EAAE,OAAO,CAAC,UAAU,IAAI,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC;SACnD;QACD;YACE,OAAO,EAAE,eAAe;YACxB,KAAK,EAAE,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC;SACtF;KACF,CAAC;IAEF,OAAO,WAAW,CAChB,YAAY,CAAC,SAAS,EAAE,CAAC,SAAS,EAAE,OAAO,CAAC,EAAE;QAC5C,KAAK,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,QAAQ,EAAE;KAC3D,CAAC,CACH,CAAC;AACJ,CAAC"}
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/builtins/sys/context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAEjD,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAC9D,OAAO,EAAmB,WAAW,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAuB,MAAM,kCAAkC,CAAC;AACxF,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AASjE,iEAAiE;AACjE,MAAM,eAAe,GAAG,EAAoC,CAAC;AAE7D;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,eAAe,CAAC;IAC5C,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,eAAe;IACxB,IAAI,EAAE;QACJ,OAAO,EAAE,2CAA2C;QACpD,WAAW,EAAE,sJAAsJ;QACnK,QAAQ,EAAE,YAAY;QACtB,QAAQ,EAAE,CAAC,SAAS,CAAC;KACtB;IACD,OAAO,EAAE,KAAK,IAA8B,EAAE,CAAC,WAAW,EAAE;CAC7D,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAc;IAClD,OAAO,mBAAmB,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC;AACnD,CAAC;AAED;;;;GAIG;AACH,KAAK,UAAU,WAAW;IACxB,MAAM,OAAO,GAAkB,MAAM,iBAAiB,EAAE,CAAC;IAEzD,MAAM,SAAS,GAAiB;QAC9B;YACE,OAAO,EAAE,YAAY;YACrB,KAAK,EAAE,OAAO,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC;SAC7C;QACD;YACE,OAAO,EAAE,WAAW;YACpB,KAAK,EAAE,OAAO,CAAC,GAAG,IAAI,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC;SAC5C;QACD;YACE,OAAO,EAAE,cAAc;YACvB,KAAK,EAAE,OAAO,CAAC,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC;SAC/C;QACD;YACE,OAAO,EAAE,YAAY;YACrB,KAAK,EAAE,OAAO,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC;SAC7C;QACD;YACE,OAAO,EAAE,cAAc;YACvB,KAAK,EAAE,OAAO,CAAC,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC;SAC/C;QACD;YACE,OAAO,EAAE,aAAa;YACtB,KAAK,EAAE,OAAO,CAAC,UAAU,IAAI,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC;SACnD;QACD;YACE,OAAO,EAAE,eAAe;YACxB,KAAK,EAAE,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC;SACtF;KACF,CAAC;IAEF,OAAO,WAAW,CAChB,YAAY,CAAC,SAAS,EAAE,CAAC,SAAS,EAAE,OAAO,CAAC,EAAE;QAC5C,KAAK,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,QAAQ,EAAE;KAC3D,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/builtins/sys/date.d.ts

@@ -1,3 +1,15 @@
+/**
+ * @file Builtin date.
+ *
+ * Prints the current date and time, in the spirit of the UNIX `date` command:
+ * the default human format, `-u` for UTC, and `+FORMAT` strftime-style format
+ * strings. Pure computation — no host `date` binary, no subprocess — so it
+ * behaves the same in a local shell, over a CALYPSO daemon, and in the
+ * standalone binary. It reports the time only; it never sets the clock.
+ * Declared in one record (`dateCommand`).
+ *
+ * @module
+ */
 import { CommandEnvelope } from '@fnndsc/menu';
 /**
  * Formats a date with a strftime-style format string.
@@ -9,12 +21,51 @@ import { CommandEnvelope } from '@fnndsc/menu';
  */
 export declare function date_format(date: Date, format: string, utc: boolean): string;
 /**
- * Reports the current date/time as a command envelope.
+ * `date [-u] [+format]`: the declaration.
  *
- * Supports `-u`/`--utc` for UTC and a `+FORMAT` strftime-style argument;
- * otherwise the default `date` format is used.
+ * @example
+ * ```ts
+ * commands_register({ declarations: [dateCommand] });
+ * ```
+ */
+export declare const dateCommand: import("../../core/commandDeclaration.js").CommandDeclaration<{
+    readonly operands: readonly [{
+        readonly name: "format";
+        readonly kind: "word";
+        readonly optional: true;
+        readonly summary: "+ and a strftime-style format (e.g. +%Y-%m-%d, +%H:%M:%S)";
+    }];
+    readonly options: {
+        readonly utc: {
+            readonly short: "u";
+            readonly long: "utc";
+            readonly summary: "Print (or interpret) time in UTC";
+        };
+    };
+}>;
+/**
+ * `date` over words already split: the declaration's parse and handler.
  *
- * @param args - Command arguments.
- * @returns An envelope carrying the formatted date and an ISO/unix model.
+ * @param args - The words after `date`.
+ * @returns The date, or the refusal of a bad line.
+ *
+ * @example
+ * ```ts
+ * await builtin_date(['-u', '+%Y']);
+ * ```
  */
 export declare function builtin_date(args: string[]): Promise<CommandEnvelope>;
+/**
+ * Reports the current date/time as a command envelope: under a `+FORMAT`
+ * strftime-style format when one is given, otherwise the default `date` format.
+ *
+ * @param format - The format, its `+` included, or undefined for the default.
+ * @param utc - Whether to report the time in UTC.
+ * @returns An envelope carrying the formatted date and an ISO/unix model, or a refusal for a format without its `+`.
+ *
+ * @example
+ * ```ts
+ * await date_run('+%Y-%m-%d', true);
+ * ```
+ */
+export declare function date_run(format: string | undefined, utc: boolean): Promise<CommandEnvelope>;

package/dist/builtins/sys/date.js

@@ -1,4 +1,3 @@
-import { envelope_ok } from '@fnndsc/menu';
 /**
  * @file Builtin date.
  *
@@ -7,9 +6,14 @@ import { envelope_ok } from '@fnndsc/menu';
  * strings. Pure computation — no host `date` binary, no subprocess — so it
  * behaves the same in a local shell, over a CALYPSO daemon, and in the
  * standalone binary. It reports the time only; it never sets the clock.
+ * Declared in one record (`dateCommand`).
  *
  * @module
  */
+import { envelope_error, envelope_ok } from '@fnndsc/menu';
+import { exitCode_set } from '../../core/handlerRun.js';
+import { command_declare } from '../../core/commandDeclaration.js';
+import { declaredCommand_run } from '../../core/commandParse.js';
 const DAYS_LONG = ['Sunday', 'Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday'];
 const DAYS_SHORT = ['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat'];
 const MONTHS_LONG = [
@@ -102,20 +106,70 @@ export function date_format(date, format, utc) {
     const expanded = format.replace(/%[DFTRc]/g, (m) => COMPOSITE[m[1]]);
     return expanded.replace(/%([A-Za-z%])/g, (m, code) => (code in simple ? simple[code] : m));
 }
+/** What a `date` line may hold. */
+const DATE_GRAMMAR = {
+    operands: [
+        { name: 'format', kind: 'word', optional: true, summary: '+ and a strftime-style format (e.g. +%Y-%m-%d, +%H:%M:%S)' },
+    ],
+    options: {
+        utc: { short: 'u', long: 'utc', summary: 'Print (or interpret) time in UTC' },
+    },
+};
 /**
- * Reports the current date/time as a command envelope.
+ * `date [-u] [+format]`: the declaration.
  *
- * Supports `-u`/`--utc` for UTC and a `+FORMAT` strftime-style argument;
- * otherwise the default `date` format is used.
+ * @example
+ * ```ts
+ * commands_register({ declarations: [dateCommand] });
+ * ```
+ */
+export const dateCommand = command_declare({
+    name: 'date',
+    grammar: DATE_GRAMMAR,
+    help: {
+        summary: 'Print the current date and time',
+        description: 'Prints the current date and time, in the spirit of UNIX date. Use -u for UTC and +FORMAT for a strftime-style format string. Reports the time only; it never sets the clock.',
+        category: 'General',
+        posix: { group: 'System', differs: 'as date, with its + formats' },
+        examples: ['date', 'date -u', 'date +%Y-%m-%d', 'date "+%A, %B %e %Y"'],
+    },
+    holds: [],
+    handler: async (args) => date_run(args.operands.format, args.options.utc),
+});
+/**
+ * `date` over words already split: the declaration's parse and handler.
  *
- * @param args - Command arguments.
- * @returns An envelope carrying the formatted date and an ISO/unix model.
+ * @param args - The words after `date`.
+ * @returns The date, or the refusal of a bad line.
+ *
+ * @example
+ * ```ts
+ * await builtin_date(['-u', '+%Y']);
+ * ```
  */
 export async function builtin_date(args) {
-    const utc = args.includes('-u') || args.includes('--utc');
-    const formatArg = args.find((a) => a.startsWith('+'));
+    return declaredCommand_run(dateCommand, args);
+}
+/**
+ * Reports the current date/time as a command envelope: under a `+FORMAT`
+ * strftime-style format when one is given, otherwise the default `date` format.
+ *
+ * @param format - The format, its `+` included, or undefined for the default.
+ * @param utc - Whether to report the time in UTC.
+ * @returns An envelope carrying the formatted date and an ISO/unix model, or a refusal for a format without its `+`.
+ *
+ * @example
+ * ```ts
+ * await date_run('+%Y-%m-%d', true);
+ * ```
+ */
+export async function date_run(format, utc) {
+    if (format !== undefined && !format.startsWith('+')) {
+        exitCode_set(1);
+        return envelope_error('', undefined, `date: '${format}': a format starts with +, as +%Y-%m-%d; date never sets the clock\n`);
+    }
     const now = new Date();
-    const rendered = date_format(now, formatArg ? formatArg.slice(1) : DEFAULT_FORMAT, utc);
+    const rendered = date_format(now, format !== undefined ? format.slice(1) : DEFAULT_FORMAT, utc);
     return envelope_ok(`${rendered}\n`, {
         kind: 'sys.date',
         data: { iso: now.toISOString(), unix: Math.floor(now.getTime() / 1000) },

package/dist/builtins/sys/date.js.map

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