@fnndsc/brasa 0.56.2 → 0.56.3

package/dist/builtins/store.d.ts

@@ -1,8 +1,90 @@
 import { type CommandEnvelope } from '@fnndsc/menu';
 /**
- * Handles store commands.
+ * `store <list | search <query> | install <plugin> | inspect | set <url> | reset>`: the declaration.
  *
- * @param args - command arguments.
- * @returns An envelope carrying the rendered store output.
+ * @example
+ * ```ts
+ * commands_register({ declarations: [storeCommand] }, 'backend');
+ * ```
+ */
+export declare const storeCommand: import("../core/commandDeclaration.js").CommandDeclaration<{
+    readonly options: {
+        readonly store: {
+            readonly long: "store";
+            readonly summary: "Ask this peer store instead of the one set (store inspect names it)";
+            readonly value: {
+                readonly name: "url";
+                readonly kind: "word";
+            };
+        };
+    };
+    readonly subcommands: {
+        readonly list: {
+            readonly summary: "Browse every plugin in the peer store";
+            readonly options: {
+                readonly long: {
+                    readonly short: "l";
+                    readonly summary: "One plugin per line, with its details";
+                };
+            };
+        };
+        readonly search: {
+            readonly summary: "Search the peer store's plugins by name";
+            readonly operands: readonly [{
+                readonly name: "query";
+                readonly kind: "word";
+                readonly summary: "Part of a plugin name";
+            }];
+            readonly options: {
+                readonly long: {
+                    readonly short: "l";
+                    readonly summary: "One plugin per line, with its details";
+                };
+            };
+        };
+        readonly install: {
+            readonly summary: "Install a plugin from the peer store into this CUBE (an administrator: sudo store install …)";
+            readonly operands: readonly [{
+                readonly name: "plugin";
+                readonly kind: "word";
+                readonly summary: "The plugin: its name, name-vVersion, or its image";
+            }];
+            readonly options: {
+                readonly compute: {
+                    readonly long: "compute";
+                    readonly summary: "The compute resources it runs on, comma-separated";
+                    readonly value: {
+                        readonly name: "names";
+                        readonly kind: "compute";
+                    };
+                };
+            };
+        };
+        readonly inspect: {
+            readonly summary: "Name the peer store, and whether it is the default";
+        };
+        readonly set: {
+            readonly summary: "Set the peer store (kept in ~/.config/chell/settings.json)";
+            readonly operands: readonly [{
+                readonly name: "url";
+                readonly kind: "word";
+                readonly summary: "The store's API URL";
+            }];
+        };
+        readonly reset: {
+            readonly summary: `Set the peer store back to the default (${string})`;
+        };
+    };
+}>;
+/**
+ * `store` over words already split: the declaration's parse and handler.
+ *
+ * @param args - The words after `store`.
+ * @returns The answer, or the refusal of a bad line.
+ *
+ * @example
+ * ```ts
+ * await builtin_store(['search', 'dicom']);
+ * ```
  */
 export declare function builtin_store(args: string[]): Promise<CommandEnvelope>;

package/dist/builtins/store.js

@@ -1,9 +1,18 @@
 /**
- * @file Builtin store command.
- * Manages peer store interactions (list, search, install).
+ * @file `store`: the peer store, another ChRIS whose plugins this CUBE can
+ * install. Browse and search it, install a plugin from it, and say, set or
+ * reset which store it is.
+ *
+ * Declared in one record (`storeCommand`): the subcommands, their operands
+ * and options.
+ *
+ * Key components:
+ * - storeCommand: the declaration.
+ * - builtin_store: the declaration run over words already split.
+ *
+ * @module
  */
 import chalk from 'chalk';
-import { commandArgs_process } from './utils.js';
 import { store_listPlugins, store_searchPlugins } from '@fnndsc/chili/commands/store/list.js';
 import { grid_render, long_render } from '@fnndsc/chili/views/ls.js';
 import { spinner } from '../lib/spinner.js';
@@ -12,6 +21,8 @@ import { envelope_ok, envelope_error } from '@fnndsc/menu';
 import { DEFAULT_STORE_URL, storeUrl_get, storeUrl_isDefault, storeUrl_set, storeUrl_clear, storeConfig_persist, } from '../config/storeConfig.js';
 import { errorStack } from '@fnndsc/fond';
 import { exitCode_set } from '../core/handlerRun.js';
+import { command_declare } from '../core/commandDeclaration.js';
+import { declaredCommand_run } from '../core/commandParse.js';
 /**
  * Renders a store fetch failure as an error envelope, draining the reason the
  * fetch pushed onto the error stack.
@@ -26,83 +37,96 @@ function storeFailure_envelope(fallback) {
     return envelope_error('', undefined, `${chalk.red(detail)}\n`);
 }
 /**
- * Handles store commands.
+ * The store's plugins as a listing draws them: a grid, or one per line with `-l`.
  *
- * @param args - command arguments.
- * @returns An envelope carrying the rendered store output.
+ * @param items - The plugins.
+ * @param long - Whether to draw one per line.
+ * @returns The listing.
  */
-export async function builtin_store(args) {
-    const parsed = commandArgs_process(args);
-    const subcommand = parsed._[0];
-    if (!subcommand) {
-        return envelope_ok(`${chalk.red("Usage: store <list|search|install> ...")}\n`);
-    }
-    const storeOptions = {
-        store: parsed.store
-    };
+function storeItems_render(items, long) {
+    return long ? `${long_render(items, { human: false })}\n` : `${grid_render(items)}\n`;
+}
+/** What a `store` line may hold. */
+const STORE_GRAMMAR = {
+    options: {
+        store: { long: 'store', summary: 'Ask this peer store instead of the one set (store inspect names it)', value: { name: 'url', kind: 'word' } },
+    },
+    subcommands: {
+        list: { summary: "Browse every plugin in the peer store", options: { long: { short: 'l', summary: 'One plugin per line, with its details' } } },
+        search: {
+            summary: 'Search the peer store\'s plugins by name',
+            operands: [{ name: 'query', kind: 'word', summary: 'Part of a plugin name' }],
+            options: { long: { short: 'l', summary: 'One plugin per line, with its details' } },
+        },
+        install: {
+            summary: 'Install a plugin from the peer store into this CUBE (an administrator: sudo store install …)',
+            operands: [{ name: 'plugin', kind: 'word', summary: 'The plugin: its name, name-vVersion, or its image' }],
+            options: { compute: { long: 'compute', summary: 'The compute resources it runs on, comma-separated', value: { name: 'names', kind: 'compute' } } },
+        },
+        inspect: { summary: 'Name the peer store, and whether it is the default' },
+        set: { summary: 'Set the peer store (kept in ~/.config/chell/settings.json)', operands: [{ name: 'url', kind: 'word', summary: "The store's API URL" }] },
+        reset: { summary: `Set the peer store back to the default (${DEFAULT_STORE_URL})` },
+    },
+};
+/**
+ * Runs one `store` line.
+ *
+ * @param args - The line, parsed.
+ * @returns The answer, or the error.
+ */
+async function store_run(args) {
+    const storeOptions = { store: args.options.store };
     try {
         spinner.start('Fetching from store...');
-        if (subcommand === 'list') {
-            const listResult = await store_listPlugins(storeOptions);
-            spinner.stop();
-            if (!listResult.ok) {
-                return storeFailure_envelope('store list failed');
+        switch (args.subcommand) {
+            case 'list': {
+                const listResult = await store_listPlugins(storeOptions);
+                spinner.stop();
+                if (!listResult.ok)
+                    return storeFailure_envelope('store list failed');
+                if (listResult.value.length === 0)
+                    return envelope_ok('No plugins found in store.\n');
+                return envelope_ok(storeItems_render(listResult.value, args.options.long));
             }
-            const items = listResult.value;
-            if (items.length === 0) {
-                return envelope_ok('No plugins found in store.\n');
+            case 'search': {
+                const query = args.operands.query;
+                const searchResult = await store_searchPlugins(query, storeOptions);
+                spinner.stop();
+                if (!searchResult.ok)
+                    return storeFailure_envelope(`store search failed for '${query}'`);
+                if (searchResult.value.length === 0)
+                    return envelope_ok(`No plugins found matching '${query}'.\n`);
+                return envelope_ok(storeItems_render(searchResult.value, args.options.long));
             }
-            // Use grid render by default, or long render if -l flag.
-            return envelope_ok(parsed.l ? `${long_render(items, { human: !!parsed.h })}\n` : `${grid_render(items)}\n`);
-        }
-        else if (subcommand === 'search') {
-            const query = parsed._[1];
-            if (!query) {
+            case 'install': {
                 spinner.stop();
-                return envelope_ok(`${chalk.red("Usage: store search <query>")}\n`);
+                // The add is the plugin verb's, which reads its words as parsed.
+                const install = {
+                    _: ['install', args.operands.plugin],
+                    ...(args.options.compute !== undefined ? { compute: args.options.compute } : {}),
+                    ...(args.options.store !== undefined ? { store: args.options.store } : {}),
+                };
+                return await plugin_addInteractive(install);
             }
-            const searchResult = await store_searchPlugins(query, storeOptions);
-            spinner.stop();
-            if (!searchResult.ok) {
-                return storeFailure_envelope(`store search failed for '${query}'`);
+            case 'inspect': {
+                spinner.stop();
+                const current = storeUrl_get();
+                const isDefault = storeUrl_isDefault();
+                return envelope_ok(`${chalk.bold('Peer store URL:')} ${chalk.blue(current)}${isDefault ? chalk.gray(' (default)') : chalk.yellow(' (custom)')}\n`);
             }
-            const items = searchResult.value;
-            if (items.length === 0) {
-                return envelope_ok(`No plugins found matching '${query}'.\n`);
+            case 'set': {
+                spinner.stop();
+                storeUrl_set(args.operands.url);
+                await storeConfig_persist();
+                return envelope_ok(`${chalk.green(`Store URL set to: ${chalk.blue(args.operands.url)}`)}\n`);
             }
-            return envelope_ok(parsed.l ? `${long_render(items, { human: !!parsed.h })}\n` : `${grid_render(items)}\n`);
-        }
-        else if (subcommand === 'install') {
-            spinner.stop();
-            const installParsed = { ...parsed, _: [parsed._[0], parsed._[1]] };
-            return await plugin_addInteractive(installParsed);
-        }
-        else if (subcommand === 'inspect') {
-            spinner.stop();
-            const current = storeUrl_get();
-            const isDefault = storeUrl_isDefault();
-            return envelope_ok(`${chalk.bold('Peer store URL:')} ${chalk.blue(current)}${isDefault ? chalk.gray(' (default)') : chalk.yellow(' (custom)')}\n`);
-        }
-        else if (subcommand === 'set') {
-            spinner.stop();
-            const url = parsed._[1];
-            if (!url) {
-                exitCode_set(1);
-                return envelope_error('', undefined, `${chalk.red('Usage: store set <url>')}\n`);
+            case 'reset': {
+                spinner.stop();
+                storeUrl_clear();
+                await storeConfig_persist();
+                return envelope_ok(`${chalk.green(`Store URL reset to default: ${chalk.blue(DEFAULT_STORE_URL)}`)}\n`);
             }
-            storeUrl_set(url);
-            await storeConfig_persist();
-            return envelope_ok(`${chalk.green(`Store URL set to: ${chalk.blue(url)}`)}\n`);
-        }
-        else if (subcommand === 'reset') {
-            spinner.stop();
-            storeUrl_clear();
-            await storeConfig_persist();
-            return envelope_ok(`${chalk.green(`Store URL reset to default: ${chalk.blue(DEFAULT_STORE_URL)}`)}\n`);
         }
-        spinner.stop();
-        exitCode_set(1);
-        return envelope_error('', undefined, `${chalk.red(`Unknown subcommand: ${subcommand}. Usage: store <list|search|install|inspect|set|reset>`)}\n`);
     }
     catch (e) {
         spinner.stop();
@@ -111,4 +135,47 @@ export async function builtin_store(args) {
         return envelope_error('', undefined, `${chalk.red(`Store error: ${msg}`)}\n`);
     }
 }
+/**
+ * `store <list | search <query> | install <plugin> | inspect | set <url> | reset>`: the declaration.
+ *
+ * @example
+ * ```ts
+ * commands_register({ declarations: [storeCommand] }, 'backend');
+ * ```
+ */
+export const storeCommand = command_declare({
+    name: 'store',
+    grammar: STORE_GRAMMAR,
+    help: {
+        summary: 'The peer store: browse and search its plugins, install one, say or set which store it is',
+        description: "The peer store is another ChRIS, by default cube.chrisproject.org, whose plugins this CUBE can install; it is not a resource of this CUBE, so the resource listing options do not apply. list and search browse it; install registers one of its plugins here, on the compute resources --compute names, and needs an administrator (sudo store install …); inspect names the store, set and reset change it.",
+        category: 'Resources',
+        examples: [
+            'store list',
+            'store search dicom',
+            'store install pl-dcm2niix',
+            'store install pl-dcm2niix-v1.2.3',
+            'store install fnndsc/pl-dcm2niix:1.2.3',
+            'store install pl-dcm2niix --compute moc',
+            'store inspect',
+            'store set https://my-cube.org/api/v1/',
+            'store reset',
+        ],
+    },
+    handler: store_run,
+});
+/**
+ * `store` over words already split: the declaration's parse and handler.
+ *
+ * @param args - The words after `store`.
+ * @returns The answer, or the refusal of a bad line.
+ *
+ * @example
+ * ```ts
+ * await builtin_store(['search', 'dicom']);
+ * ```
+ */
+export async function builtin_store(args) {
+    return declaredCommand_run(storeCommand, args);
+}
 //# sourceMappingURL=store.js.map

package/dist/builtins/store.js.map

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

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

@@ -2,21 +2,96 @@
  * @file apropos and man: find a command by a word, and read its page, in the
  * words every Unix hand already knows (builtins/helpSections.ts).
  *
+ * Declared in one record each (`aproposCommand`, `manCommand`): grammar,
+ * help and handler.
+ *
+ * Key components:
+ * - aproposCommand, manCommand: the declarations.
+ * - builtin_apropos, builtin_man: the declarations run over words already split.
+ * - apropos_run: the typed core of both.
+ *
+ * Typical usage:
+ * ```ts
+ * await builtin_apropos(['dicom']);
+ * await builtin_man(['-k', 'pull']);
+ * ```
+ *
  * @module
  */
 import { CommandEnvelope } from '@fnndsc/menu';
 /**
- * `apropos <word>`: every command, section and Shell topic whose name,
- * summary or description holds the word.
+ * `apropos <word…>`: the declaration.
+ *
+ * @example
+ * ```ts
+ * commands_register({ declarations: [aproposCommand] });
+ * ```
+ */
+export declare const aproposCommand: import("../../core/commandDeclaration.js").CommandDeclaration<{
+    readonly operands: readonly [{
+        readonly name: "word";
+        readonly kind: "word";
+        readonly repeat: true;
+        readonly summary: "The word to look for; several words are one phrase";
+    }];
+}>;
+/**
+ * `man <topic…> | man -k <word…>`: the declaration.
  *
- * @param args - The word (several words are one phrase).
+ * @example
+ * ```ts
+ * commands_register({ declarations: [manCommand] });
+ * ```
+ */
+export declare const manCommand: import("../../core/commandDeclaration.js").CommandDeclaration<{
+    readonly operands: readonly [{
+        readonly name: "topic";
+        readonly kind: "word";
+        readonly optional: true;
+        readonly repeat: true;
+        readonly summary: "A command, a section or a Shell topic; with -k, the word to look for";
+    }];
+    readonly options: {
+        readonly keyword: {
+            readonly short: "k";
+            readonly summary: "Look for the word, as apropos does";
+        };
+    };
+}>;
+/**
+ * Every command, section and Shell topic whose name, summary or description
+ * holds the words, as one phrase.
+ *
+ * @param words - The words to look for.
  * @returns The matches, or nothing appropriate (exit 1, as apropos does).
+ *
+ * @example
+ * ```ts
+ * await apropos_run(['dicom']);
+ * ```
+ */
+export declare function apropos_run(words: readonly string[]): Promise<CommandEnvelope>;
+/**
+ * `apropos` over words already split: the declaration's parse and handler.
+ *
+ * @param args - The words after `apropos`.
+ * @returns The matches, or the refusal of a bad line.
+ *
+ * @example
+ * ```ts
+ * await builtin_apropos(['dicom']);
+ * ```
  */
 export declare function builtin_apropos(args: string[]): Promise<CommandEnvelope>;
 /**
- * `man <command|Section|topic>` is `help` for it; `man -k <word>` is apropos.
+ * `man` over words already split: the declaration's parse and handler.
  *
  * @param args - The words after `man`.
- * @returns The page, or the matches.
+ * @returns The page, the matches, or the refusal of a bad line.
+ *
+ * @example
+ * ```ts
+ * await builtin_man(['ls']);
+ * ```
  */
 export declare function builtin_man(args: string[]): Promise<CommandEnvelope>;

package/dist/builtins/sys/apropos.js

@@ -2,23 +2,99 @@
  * @file apropos and man: find a command by a word, and read its page, in the
  * words every Unix hand already knows (builtins/helpSections.ts).
  *
+ * Declared in one record each (`aproposCommand`, `manCommand`): grammar,
+ * help and handler.
+ *
+ * Key components:
+ * - aproposCommand, manCommand: the declarations.
+ * - builtin_apropos, builtin_man: the declarations run over words already split.
+ * - apropos_run: the typed core of both.
+ *
+ * Typical usage:
+ * ```ts
+ * await builtin_apropos(['dicom']);
+ * await builtin_man(['-k', 'pull']);
+ * ```
+ *
  * @module
  */
 import { envelope_ok, envelope_error } from '@fnndsc/menu';
 import { apropos_search } from '../helpSections.js';
-import { builtin_help, helpLookup_make } from '../help.js';
+import { help_answer, helpLookup_make } from '../help.js';
 import { exitCode_set } from '../../core/handlerRun.js';
+import { command_declare } from '../../core/commandDeclaration.js';
+import { declaredCommand_run } from '../../core/commandParse.js';
+/** What an `apropos` line may hold. */
+const APROPOS_GRAMMAR = {
+    operands: [
+        { name: 'word', kind: 'word', repeat: true, summary: 'The word to look for; several words are one phrase' },
+    ],
+};
+/** What a `man` line may hold. */
+const MAN_GRAMMAR = {
+    operands: [
+        { name: 'topic', kind: 'word', optional: true, repeat: true, summary: 'A command, a section or a Shell topic; with -k, the word to look for' },
+    ],
+    options: {
+        keyword: { short: 'k', summary: 'Look for the word, as apropos does' },
+    },
+};
+/**
+ * `apropos <word…>`: the declaration.
+ *
+ * @example
+ * ```ts
+ * commands_register({ declarations: [aproposCommand] });
+ * ```
+ */
+export const aproposCommand = command_declare({
+    name: 'apropos',
+    grammar: APROPOS_GRAMMAR,
+    help: {
+        summary: 'Find commands by a word in their name, summary or description',
+        description: 'Search every command, section and Shell topic for a word, in any case. Nothing found is exit 1, as apropos is. man -k <word> is the same.',
+        category: 'General',
+        posix: { group: 'Shell', differs: 'as apropos: searches every command\'s line and description' },
+        examples: ['apropos dicom', 'apropos link', 'man -k pull'],
+    },
+    holds: [],
+    handler: async (args) => apropos_run(args.operands.word),
+});
 /**
- * `apropos <word>`: every command, section and Shell topic whose name,
- * summary or description holds the word.
+ * `man <topic…> | man -k <word…>`: the declaration.
  *
- * @param args - The word (several words are one phrase).
+ * @example
+ * ```ts
+ * commands_register({ declarations: [manCommand] });
+ * ```
+ */
+export const manCommand = command_declare({
+    name: 'man',
+    grammar: MAN_GRAMMAR,
+    help: {
+        summary: 'The page for a command, a section or a Shell topic (help, by its Unix name)',
+        description: 'man <name> is help <name>; man -k <word> is apropos <word>',
+        category: 'General',
+        posix: { group: 'Shell', differs: 'man <name> is help <name>; man -k is apropos' },
+        examples: ['man grep', 'man PACS', 'man -k dicom'],
+    },
+    holds: [],
+    handler: async (args) => man_run(args.operands.topic, args.options.keyword),
+});
+/**
+ * Every command, section and Shell topic whose name, summary or description
+ * holds the words, as one phrase.
+ *
+ * @param words - The words to look for.
  * @returns The matches, or nothing appropriate (exit 1, as apropos does).
+ *
+ * @example
+ * ```ts
+ * await apropos_run(['dicom']);
+ * ```
  */
-export async function builtin_apropos(args) {
-    const word = args.join(' ').trim();
-    if (word === '')
-        return envelope_error('', undefined, 'apropos: a word to look for: apropos <word>\n');
+export async function apropos_run(words) {
+    const word = words.join(' ').trim();
     const hits = apropos_search(word, helpLookup_make());
     if (hits.length === 0) {
         exitCode_set(1);
@@ -27,16 +103,46 @@ export async function builtin_apropos(args) {
     return envelope_ok(`${hits.join('\n')}\n`);
 }
 /**
- * `man <command|Section|topic>` is `help` for it; `man -k <word>` is apropos.
+ * `man <topic>` is `help` for it; `man -k <word>` is apropos.
+ *
+ * @param topic - The words after the options.
+ * @param keyword - Whether -k asked for apropos.
+ * @returns The page, the matches, or a refusal for nothing asked.
+ */
+async function man_run(topic, keyword) {
+    if (topic.length === 0) {
+        return envelope_error('', undefined, keyword
+            ? 'apropos: a word to look for: apropos <word>\n'
+            : 'man: what manual page do you want? man <command>, man <Section>, man -k <word>\n');
+    }
+    return keyword ? apropos_run(topic) : help_answer(topic);
+}
+/**
+ * `apropos` over words already split: the declaration's parse and handler.
+ *
+ * @param args - The words after `apropos`.
+ * @returns The matches, or the refusal of a bad line.
+ *
+ * @example
+ * ```ts
+ * await builtin_apropos(['dicom']);
+ * ```
+ */
+export async function builtin_apropos(args) {
+    return declaredCommand_run(aproposCommand, args);
+}
+/**
+ * `man` over words already split: the declaration's parse and handler.
  *
  * @param args - The words after `man`.
- * @returns The page, or the matches.
+ * @returns The page, the matches, or the refusal of a bad line.
+ *
+ * @example
+ * ```ts
+ * await builtin_man(['ls']);
+ * ```
  */
 export async function builtin_man(args) {
-    if (args[0] === '-k')
-        return builtin_apropos(args.slice(1));
-    if (args.length === 0)
-        return envelope_error('', undefined, 'man: what manual page do you want? man <command>, man <Section>, man -k <word>\n');
-    return builtin_help(args);
+    return declaredCommand_run(manCommand, args);
 }
 //# sourceMappingURL=apropos.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"apropos.js","sourceRoot":"","sources":["../../../src/builtins/sys/apropos.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAmB,WAAW,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC5E,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAc;IAClD,MAAM,IAAI,GAAW,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAC3C,IAAI,IAAI,KAAK,EAAE;QAAE,OAAO,cAAc,CAAC,EAAE,EAAE,SAAS,EAAE,+CAA+C,CAAC,CAAC;IACvG,MAAM,IAAI,GAAa,cAAc,CAAC,IAAI,EAAE,eAAe,EAAE,CAAC,CAAC;IAC/D,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,YAAY,CAAC,CAAC,CAAC,CAAC;QAChB,OAAO,WAAW,CAAC,GAAG,IAAI,0BAA0B,CAAC,CAAC;IACxD,CAAC;IACD,OAAO,WAAW,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC7C,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAc;IAC9C,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI;QAAE,OAAO,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5D,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,cAAc,CAAC,EAAE,EAAE,SAAS,EAAE,kFAAkF,CAAC,CAAC;IAChJ,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC"}
+{"version":3,"file":"apropos.js","sourceRoot":"","sources":["../../../src/builtins/sys/apropos.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAAmB,WAAW,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC5E,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,eAAe,EAA8C,MAAM,kCAAkC,CAAC;AAC/G,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEjE,uCAAuC;AACvC,MAAM,eAAe,GAAG;IACtB,QAAQ,EAAE;QACR,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,oDAAoD,EAAE;KAC5G;CACgC,CAAC;AAEpC,kCAAkC;AAClC,MAAM,WAAW,GAAG;IAClB,QAAQ,EAAE;QACR,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,sEAAsE,EAAE;KAC/I;IACD,OAAO,EAAE;QACP,OAAO,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,oCAAoC,EAAE;KACvE;CACgC,CAAC;AAEpC;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,eAAe,CAAC;IAC5C,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,eAAe;IACxB,IAAI,EAAE;QACJ,OAAO,EAAE,+DAA+D;QACxE,WAAW,EAAE,2IAA2I;QACxJ,QAAQ,EAAE,SAAS;QACnB,KAAK,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,4DAA4D,EAAE;QAChG,QAAQ,EAAE,CAAC,eAAe,EAAE,cAAc,EAAE,aAAa,CAAC;KAC3D;IACD,KAAK,EAAE,EAAE;IACT,OAAO,EAAE,KAAK,EAAE,IAA8C,EAA4B,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;CAC7H,CAAC,CAAC;AAEH;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,eAAe,CAAC;IACxC,IAAI,EAAE,KAAK;IACX,OAAO,EAAE,WAAW;IACpB,IAAI,EAAE;QACJ,OAAO,EAAE,6EAA6E;QACtF,WAAW,EAAE,4DAA4D;QACzE,QAAQ,EAAE,SAAS;QACnB,KAAK,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,8CAA8C,EAAE;QAClF,QAAQ,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,cAAc,CAAC;KACnD;IACD,KAAK,EAAE,EAAE;IACT,OAAO,EAAE,KAAK,EAAE,IAA0C,EAA4B,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;CAC5I,CAAC,CAAC;AAEH;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,KAAwB;IACxD,MAAM,IAAI,GAAW,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAC5C,MAAM,IAAI,GAAa,cAAc,CAAC,IAAI,EAAE,eAAe,EAAE,CAAC,CAAC;IAC/D,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,YAAY,CAAC,CAAC,CAAC,CAAC;QAChB,OAAO,WAAW,CAAC,GAAG,IAAI,0BAA0B,CAAC,CAAC;IACxD,CAAC;IACD,OAAO,WAAW,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC7C,CAAC;AAED;;;;;;GAMG;AACH,KAAK,UAAU,OAAO,CAAC,KAAwB,EAAE,OAAgB;IAC/D,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,cAAc,CAAC,EAAE,EAAE,SAAS,EAAE,OAAO;YAC1C,CAAC,CAAC,+CAA+C;YACjD,CAAC,CAAC,kFAAkF,CAAC,CAAC;IAC1F,CAAC;IACD,OAAO,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;AAC3D,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAc;IAClD,OAAO,mBAAmB,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC;AACnD,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAc;IAC9C,OAAO,mBAAmB,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;AAC/C,CAAC"}