@navbook/cli 0.4.0 → 0.5.0

package/dist/plugins/commands.js

@@ -0,0 +1,148 @@
+/**
+ * Building Commander commands out of manifests — spec 04 §4.3.
+ *
+ * Every command a plugin adds is built from its declaration, with no plugin
+ * code loaded. That is what makes `nav --help` and shell completion work
+ * without paying for an import, and it is what the manifest's shapes exist to
+ * make possible. The plugin's own module is imported inside the action, the
+ * moment somebody actually runs the command.
+ *
+ * A name that collides with a built-in noun, or with one an earlier plugin
+ * took, is refused and the plugin skipped, because a word that means different
+ * things depending on load order is worse than one that means nothing.
+ */
+import { Command, Option } from "commander";
+import { finiteNumber, wholeNumber } from "../args.js";
+/**
+ * Sort out which plugin owns what, refusing collisions.
+ *
+ * `taken` is the built-in noun vocabulary. A plugin colliding with one of
+ * those loses outright; two plugins colliding with each other are resolved by
+ * which was resolved first, and the loser is named.
+ */
+export function collectCommands(plugins, taken) {
+    const nouns = new Map();
+    const contributions = new Map();
+    const skipped = new Set();
+    const problems = [];
+    const builtin = new Set(taken);
+    for (const plugin of plugins) {
+        const declared = plugin.manifest.cli;
+        if (declared === undefined)
+            continue;
+        const clash = (declared.commands ?? []).find((spec) => builtin.has(spec.name) || nouns.has(spec.name));
+        if (clash !== undefined) {
+            const owner = builtin.has(clash.name)
+                ? "a built-in command"
+                : `plugin ${nouns.get(clash.name)?.plugin.name}`;
+            problems.push(`nav: plugin ${plugin.name} skipped: '${clash.name}' is already ${owner} (spec 04 §4.3)`);
+            skipped.add(plugin.name);
+            continue;
+        }
+        for (const spec of declared.commands ?? [])
+            nouns.set(spec.name, { plugin, spec });
+        for (const spec of declared.contributions ?? []) {
+            const existing = contributions.get(spec.on) ?? [];
+            existing.push({ plugin, spec });
+            contributions.set(spec.on, existing);
+        }
+    }
+    return { nouns, contributions, skipped, problems };
+}
+/** Build one plugin noun into a Commander command tree. */
+export function buildPluginCommand(plugin, spec, getCtx, run) {
+    return buildCommand(plugin, spec, spec.name, getCtx, run);
+}
+function buildCommand(plugin, spec, path, getCtx, run) {
+    const command = new Command(spec.name).description(spec.description);
+    // A group — a noun with verbs under it — has no action of its own, and
+    // Commander's implicit `help` verb is dropped for the reason the built-in
+    // nouns drop it: it prints exactly what `--help` prints.
+    if (spec.commands?.length) {
+        command.helpCommand(false);
+        for (const child of spec.commands) {
+            command.addCommand(buildCommand(plugin, child, `${path} ${child.name}`, getCtx, run));
+        }
+        return command;
+    }
+    for (const argument of spec.arguments ?? [])
+        command.argument(...argumentOf(argument));
+    for (const option of spec.options ?? [])
+        applyOption(command, option);
+    command.action(async (...received) => {
+        // Commander hands the action its positional arguments, then the parsed
+        // options, then the command itself. The declared arguments say how many
+        // positionals there are, so the split needs no guessing.
+        const count = spec.arguments?.length ?? 0;
+        const args = received.slice(0, count);
+        const opts = (received[count] ?? {});
+        // Touch the context before loading the plugin: a command run outside a
+        // repository should say so in the CLI's own words rather than in whatever
+        // the plugin says when it finds no tree.
+        getCtx();
+        await run(plugin, path, args, opts);
+    });
+    return command;
+}
+/** A declared argument, in the `[name]` / `<name...>` shape Commander parses. */
+function argumentOf(spec) {
+    const dots = spec.variadic === true ? "..." : "";
+    const name = spec.optional === true ? `[${spec.name}${dots}]` : `<${spec.name}${dots}>`;
+    return [name, spec.description ?? ""];
+}
+/** Apply one declared option to a command. */
+export function applyOption(command, spec) {
+    const option = new Option(spec.flags, spec.description);
+    if (spec.repeatable === true) {
+        option.argParser((value, previous = []) => [...previous, value]);
+        option.default([]);
+    }
+    else if (spec.parse === "int") {
+        // The parsers the built-in options use, so a plugin's count is refused
+        // where the built-in ones are: `parseInt` read `2.5` as 2 and `3abc` as 3,
+        // and `Number` reads `0x10` and `1e1` and rounds past 2^53 (#kw143sq9).
+        option.argParser(wholeNumber(null));
+    }
+    else if (spec.parse === "number") {
+        option.argParser(finiteNumber);
+    }
+    if (spec.default !== undefined)
+        option.default(spec.default);
+    command.addOption(option);
+}
+/**
+ * Why a declared option cannot be applied, or null when it can.
+ *
+ * Two different rules, because two different namespaces are at stake.
+ *
+ * On a plugin's **own** command the plugin owns every flag, so a short one is
+ * its business: `nav feature open -m "…"` reads exactly as `nav issue open -m
+ * "…"` does, and denying it would make a plugin's commands feel like
+ * second-class ones for no gain.
+ *
+ * On a **contribution** to a built-in verb the namespace is shared, and short
+ * flags are the scarce part of it — `-m`, `-y`, `-n` already mean things
+ * across the whole CLI. A plugin taking one there would be discovered by
+ * whoever installed two plugins rather than by whoever wrote the second, so
+ * they are refused outright rather than raced for.
+ *
+ * A long flag that is already taken is refused either way, and checked before
+ * Commander sees it: `.option()` throws on a duplicate, which would take the
+ * whole CLI down over one plugin's manifest.
+ */
+export function optionCollision(command, spec, where = "contribution") {
+    const flags = spec.flags.split(/[ ,|]+/).filter((part) => part.startsWith("-"));
+    if (where === "contribution") {
+        const short = flags.find((flag) => /^-[^-]/.test(flag));
+        if (short !== undefined) {
+            return `'${short}' is a short flag, which a plugin may not add to a built-in verb`;
+        }
+    }
+    for (const flag of flags) {
+        if (command.options.some((existing) => existing.long === flag || existing.short === flag)) {
+            return `'${flag}' is already an option of '${command.name()}'`;
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=commands.js.map

package/dist/plugins/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../src/plugins/commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAgBvD;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAC7B,OAAgC,EAChC,KAAwB;IAExB,MAAM,KAAK,GAAG,IAAI,GAAG,EAAuD,CAAC;IAC7E,MAAM,aAAa,GAAG,IAAI,GAAG,EAA8D,CAAC;IAC5F,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;IAE/B,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC;QACrC,IAAI,QAAQ,KAAK,SAAS;YAAE,SAAS;QAErC,MAAM,KAAK,GAAG,CAAC,QAAQ,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,IAAI,CAC1C,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CACzD,CAAC;QACF,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;gBACnC,CAAC,CAAC,oBAAoB;gBACtB,CAAC,CAAC,UAAU,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;YACnD,QAAQ,CAAC,IAAI,CACX,eAAe,MAAM,CAAC,IAAI,cAAc,KAAK,CAAC,IAAI,gBAAgB,KAAK,iBAAiB,CACzF,CAAC;YACF,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACzB,SAAS;QACX,CAAC;QACD,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,QAAQ,IAAI,EAAE;YAAE,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QACnF,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,aAAa,IAAI,EAAE,EAAE,CAAC;YAChD,MAAM,QAAQ,GAAG,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;YAClD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;YAChC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;AACrD,CAAC;AAUD,2DAA2D;AAC3D,MAAM,UAAU,kBAAkB,CAChC,MAAoB,EACpB,IAAiB,EACjB,MAAiB,EACjB,GAAe;IAEf,OAAO,YAAY,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;AAC5D,CAAC;AAED,SAAS,YAAY,CACnB,MAAoB,EACpB,IAAiB,EACjB,IAAY,EACZ,MAAiB,EACjB,GAAe;IAEf,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAErE,uEAAuE;IACvE,0EAA0E;IAC1E,yDAAyD;IACzD,IAAI,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;QAC1B,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QAC3B,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClC,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,IAAI,KAAK,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;QACxF,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,IAAI,EAAE;QAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC;IACvF,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,IAAI,EAAE;QAAE,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAEtE,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,QAAmB,EAAE,EAAE;QAC9C,uEAAuE;QACvE,wEAAwE;QACxE,yDAAyD;QACzD,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,EAAE,MAAM,IAAI,CAAC,CAAC;QAC1C,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAa,CAAC;QAClD,MAAM,IAAI,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAA4B,CAAC;QAChE,uEAAuE;QACvE,0EAA0E;QAC1E,yCAAyC;QACzC,MAAM,EAAE,CAAC;QACT,MAAM,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IACH,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,iFAAiF;AACjF,SAAS,UAAU,CAAC,IAAkB;IACpC,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IACjD,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,GAAG,IAAI,GAAG,CAAC;IACxF,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;AACxC,CAAC;AAED,8CAA8C;AAC9C,MAAM,UAAU,WAAW,CAAC,OAAgB,EAAE,IAAgB;IAC5D,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IACxD,IAAI,IAAI,CAAC,UAAU,KAAK,IAAI,EAAE,CAAC;QAC7B,MAAM,CAAC,SAAS,CAAC,CAAC,KAAa,EAAE,WAAqB,EAAE,EAAE,EAAE,CAAC,CAAC,GAAG,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;QACnF,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACrB,CAAC;SAAM,IAAI,IAAI,CAAC,KAAK,KAAK,KAAK,EAAE,CAAC;QAChC,uEAAuE;QACvE,2EAA2E;QAC3E,wEAAwE;QACxE,MAAM,CAAC,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;IACtC,CAAC;SAAM,IAAI,IAAI,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QACnC,MAAM,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;IACjC,CAAC;IACD,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS;QAAE,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC7D,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,eAAe,CAC7B,OAAgB,EAChB,IAAgB,EAChB,QAAgC,cAAc;IAE9C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;IAChF,IAAI,KAAK,KAAK,cAAc,EAAE,CAAC;QAC7B,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QACxD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,IAAI,KAAK,kEAAkE,CAAC;QACrF,CAAC;IACH,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,KAAK,IAAI,IAAI,QAAQ,CAAC,KAAK,KAAK,IAAI,CAAC,EAAE,CAAC;YAC1F,OAAO,IAAI,IAAI,8BAA8B,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC;QACjE,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/plugins/hint.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Saying that a tree holds data this `nav` cannot read.
+ *
+ * Spec 02 §2.12 requires a tool to preserve an extension namespace it does not
+ * understand, and allows it to say the namespace is undeclared. Saying so is
+ * the whole value of the declaration to somebody who has just cloned: the
+ * files are there, `nav` is ignoring them, and nothing else on screen would
+ * explain why.
+ *
+ * One line, on stderr, and never an error. The tree is conforming; this `nav`
+ * simply has less of it than the repository expects.
+ */
+import type { PluginDeclarationReading } from "@navbook/core";
+import type { Ctx } from "../context.ts";
+/**
+ * Say once that the tree holds namespaces nothing here reads.
+ *
+ * `loaded` is the directories a plugin claimed, which are read rather than
+ * ignored and so are not worth a word. `declaration` is what the marker says:
+ * a namespace whose plugin is declared but missing has already been reported
+ * by name, and saying it twice helps nobody.
+ */
+export declare function hintUndeclared(ctx: Ctx, declaration: PluginDeclarationReading, loaded: readonly string[]): void;

package/dist/plugins/hint.js

@@ -0,0 +1,65 @@
+/**
+ * Saying that a tree holds data this `nav` cannot read.
+ *
+ * Spec 02 §2.12 requires a tool to preserve an extension namespace it does not
+ * understand, and allows it to say the namespace is undeclared. Saying so is
+ * the whole value of the declaration to somebody who has just cloned: the
+ * files are there, `nav` is ignoring them, and nothing else on screen would
+ * explain why.
+ *
+ * One line, on stderr, and never an error. The tree is conforming; this `nav`
+ * simply has less of it than the repository expects.
+ */
+import { readdirSync } from "node:fs";
+/** Names this format defines at the top of the root; never a namespace. */
+const FORMAT_NAMES = new Set(["issues", "prs", "archive", "sync", "navbook.json"]);
+/**
+ * Namespaces this project knows the plugin for, so the hint can name it.
+ *
+ * Only the grandfathered pair is listed, and deliberately: a namespace whose
+ * plugin nobody here knows about gets the generic line below, which is the
+ * honest thing to say about a directory some other project's plugin wrote.
+ */
+const KNOWN = {
+    specs: "@navbook/plugin-kb",
+};
+/**
+ * Directories at the top of the root that this format does not define.
+ *
+ * One `readdir` rather than a parse of the tree: the caller has usually just
+ * read the whole repository, and reading it a second time to find out what the
+ * first read ignored would cost more than the hint is worth.
+ */
+function namespaceDirs(navRoot) {
+    try {
+        return readdirSync(navRoot, { withFileTypes: true })
+            .filter((entry) => entry.isDirectory() && !FORMAT_NAMES.has(entry.name))
+            .map((entry) => entry.name)
+            .sort();
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Say once that the tree holds namespaces nothing here reads.
+ *
+ * `loaded` is the directories a plugin claimed, which are read rather than
+ * ignored and so are not worth a word. `declaration` is what the marker says:
+ * a namespace whose plugin is declared but missing has already been reported
+ * by name, and saying it twice helps nobody.
+ */
+export function hintUndeclared(ctx, declaration, loaded) {
+    const claimed = new Set(loaded);
+    for (const name of namespaceDirs(ctx.navRoot)) {
+        if (claimed.has(name))
+            continue;
+        const plugin = KNOWN[name];
+        if (plugin !== undefined && declaration.plugins.has(plugin))
+            continue;
+        ctx.stderr.write(plugin === undefined
+            ? `nav: ${ctx.navDir}/${name}/ is not a shape this nav reads; it is preserved untouched (spec 02 §2.12)\n`
+            : `nav: ${ctx.navDir}/${name}/ belongs to ${plugin}, which ${ctx.navDir}/navbook.json does not declare; add it and run 'nav plugin install'\n`);
+    }
+}
+//# sourceMappingURL=hint.js.map

package/dist/plugins/hint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hint.js","sourceRoot":"","sources":["../../src/plugins/hint.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAItC,2EAA2E;AAC3E,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC;AAEnF;;;;;;GAMG;AACH,MAAM,KAAK,GAA2B;IACpC,KAAK,EAAE,oBAAoB;CAC5B,CAAC;AAEF;;;;;;GAMG;AACH,SAAS,aAAa,CAAC,OAAe;IACpC,IAAI,CAAC;QACH,OAAO,WAAW,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;aACjD,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;aACvE,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC;aAC1B,IAAI,EAAE,CAAC;IACZ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAC5B,GAAQ,EACR,WAAqC,EACrC,MAAyB;IAEzB,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC;IAChC,KAAK,MAAM,IAAI,IAAI,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9C,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,SAAS;QAChC,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3B,IAAI,MAAM,KAAK,SAAS,IAAI,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC;YAAE,SAAS;QACtE,GAAG,CAAC,MAAM,CAAC,KAAK,CACd,MAAM,KAAK,SAAS;YAClB,CAAC,CAAC,QAAQ,GAAG,CAAC,MAAM,IAAI,IAAI,8EAA8E;YAC1G,CAAC,CAAC,QAAQ,GAAG,CAAC,MAAM,IAAI,IAAI,gBAAgB,MAAM,WAAW,GAAG,CAAC,MAAM,uEAAuE,CACjJ,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/plugins/host.d.ts

@@ -0,0 +1,125 @@
+/**
+ * What a plugin's entry module is handed — spec 05 §5.2.
+ *
+ * Each entry exports `activate(host)`. The host carries three things: the
+ * running core, the settings the repository declared, and the hooks for
+ * registering what this layer accepts.
+ *
+ * `core` is the host's own module object, not something the plugin imported.
+ * That is the single most important line in this file. A plugin resolving its
+ * own `@navbook/core` would get a second copy, and then `instanceof
+ * WorkspaceError` would be false across the boundary, two YAML parsers would
+ * sit on the startup path, and two `Repo` types that are structurally
+ * identical would be nominally different. The store installs with
+ * `--omit=peer` so that copy cannot exist; this is how the plugin gets the
+ * real one instead.
+ */
+import type { CorePluginHost, EntityRecord, Repo } from "@navbook/core";
+import type { Composed, ComposeOptions } from "../commands/compose.ts";
+import type { ExtraColumn } from "../commands/entity.ts";
+import type { Ctx } from "../context.ts";
+/** What every entry module exports. */
+export interface PluginEntry<H> {
+    activate(host: H): void | Promise<void>;
+}
+export type { CorePluginHost };
+/**
+ * What a plugin adds to a command that already exists.
+ *
+ * Every field here has a seam in the CLI that predates plugins: `columns` and
+ * `jsonExtra` are what `nav pr list --all-refs` already uses to add its `refs`
+ * column, and `showSection` is the same idea for a detail view. A plugin
+ * contributing through them renders identically to a built-in, which is the
+ * point — `nav issue list` should not look like it has a bolt-on.
+ */
+export interface VerbHandlers {
+    /**
+     * Frontmatter for a newly created entity, read off this verb's options.
+     *
+     * Returns what `NewEntityInput.ext` takes, so the plugin's keys are written
+     * by the same composer that writes the format's own.
+     */
+    openFields?(opts: Record<string, unknown>): Record<string, string | readonly string[]>;
+    /** Columns appended to this listing, after the built-in ones. */
+    columns?: ExtraColumn[];
+    /** Keys merged into this command's `--json` object, per entity. */
+    jsonExtra?(entity: EntityRecord): Record<string, unknown>;
+    /** Lines appended to this `show`, after the built-in detail. */
+    showSection?(entity: EntityRecord, repo: Repo): string[];
+    /** Candidates offered for this command's query terms, e.g. `feature:auth`. */
+    listCompletions?(): string[];
+}
+/** What the `./cli` entry is given: the core host, plus the terminal. */
+export interface CliPluginHost extends CorePluginHost {
+    /** Where output goes, who is acting, and where the repository is. */
+    ctx: Ctx;
+    /**
+     * Implement a command the manifest declared.
+     *
+     * `path` is the command as typed, without `nav`: `"feature open"`, or
+     * `"feature spec add"`. A path the manifest does not declare is refused,
+     * because the manifest is what built the help and the completions, and a
+     * command that runs but is not in either would be worse than one that does
+     * not run.
+     */
+    command(path: string, run: (args: string[], opts: Record<string, unknown>) => void | Promise<void>): void;
+    /** Implement contributions to an existing verb the manifest declared. */
+    contribute(on: string, handlers: VerbHandlers): void;
+    /** Answer completion for an argument whose spec names this completer. */
+    completer(id: string, complete: (words: string[]) => string[]): void;
+    /** The terminal conveniences, so a plugin's output matches a built-in's. */
+    ui: CliPluginUi;
+}
+/**
+ * The parts of the CLI a plugin may use to talk to the terminal.
+ *
+ * Named rather than handed the modules wholesale: this is the surface the
+ * plugin API version promises, and a plugin reaching past it into the CLI's
+ * internals would break on a refactor nobody thought was a breaking change.
+ */
+export interface CliPluginUi {
+    /** Stop with an operational error (exit 1), as every built-in verb does. */
+    fail(message: string, details?: string[]): never;
+    /** Stop with a format violation (exit 2), as `doctor` does. */
+    failFormat(message: string, details?: string[]): never;
+    /** Ask a yes/no question; anything but yes is a no. */
+    askYesNo(question: string): boolean;
+    /** Print what will happen, ask once, then do it — the `nav install` shape. */
+    confirmAndPerform(opts: {
+        title: string;
+        actions: readonly {
+            description: string;
+            perform: () => void;
+        }[];
+        assumeYes?: boolean;
+    }): boolean;
+    /**
+     * Produce the text of a new file, from `-m` or from `$EDITOR`.
+     *
+     * The whole composing path rather than the editor alone, because what makes
+     * a hand-edited buffer safe is that it is parsed and validated before
+     * anything is written — and a plugin opening `$EDITOR` itself would have to
+     * reproduce that, and would eventually reproduce it slightly differently.
+     */
+    composeFile(opts: ComposeOptions): Composed;
+    /** Open `$EDITOR` on a file already in the tree, as `nav issue edit` does. */
+    editFile(absolutePath: string): void;
+    /** Render a table sized to the terminal, the way every listing does. */
+    renderTable(columns: readonly {
+        header: string;
+        flexible?: boolean;
+        minWidth?: number;
+    }[], rows: readonly string[][]): string;
+    /**
+     * Pad text with spaces to `width` terminal columns, measured as a listing
+     * measures its cells — so a wide or combining character lines up.
+     */
+    pad(text: string, width: number): string;
+    /** The one-line report printed after a `--commit` run. */
+    commitReport(result: {
+        committed: boolean;
+        subject: string;
+    }): string;
+    /** Collect a repeatable option's values, for a manifest that declares one. */
+    collect(value: string, previous: string[]): string[];
+}

package/dist/plugins/host.js

@@ -0,0 +1,18 @@
+/**
+ * What a plugin's entry module is handed — spec 05 §5.2.
+ *
+ * Each entry exports `activate(host)`. The host carries three things: the
+ * running core, the settings the repository declared, and the hooks for
+ * registering what this layer accepts.
+ *
+ * `core` is the host's own module object, not something the plugin imported.
+ * That is the single most important line in this file. A plugin resolving its
+ * own `@navbook/core` would get a second copy, and then `instanceof
+ * WorkspaceError` would be false across the boundary, two YAML parsers would
+ * sit on the startup path, and two `Repo` types that are structurally
+ * identical would be nominally different. The store installs with
+ * `--omit=peer` so that copy cannot exist; this is how the plugin gets the
+ * real one instead.
+ */
+export {};
+//# sourceMappingURL=host.js.map

package/dist/plugins/host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.js","sourceRoot":"","sources":["../../src/plugins/host.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG"}

package/dist/plugins/loader.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Importing a plugin's code, as late as possible — spec 04 §4.3, 05 §5.2.
+ *
+ * The rule this file exists to keep: nothing here runs for a command whose
+ * manifest does not name it. `nav issue list` on a machine with five plugins
+ * installed imports none of them, and `nav --help` imports none of them
+ * either, because the help was built from manifests. An `import()` of one
+ * plugin costs more than the whole of `nav issue list`'s budget, so this is
+ * not a micro-optimisation: it is the difference between plugins being
+ * affordable and not.
+ *
+ * What triggers a load is therefore always a *declaration* — a command the
+ * plugin declared being run, a contribution it declared being reached, a
+ * query term it declared being typed.
+ */
+import { type CoreExtensions } from "@navbook/core";
+import type { PluginEntry } from "./host.ts";
+import type { LoadedPlugin } from "./resolve.ts";
+/** Which part of a plugin to import; the `exports` subpath, without the dot. */
+export type PluginPart = "core" | "cli" | "server" | "web";
+/**
+ * The file a plugin's `exports` maps a subpath to.
+ *
+ * Read from the package's own `package.json` rather than guessed, because the
+ * whole point of `exports` is that a package decides its own layout — and a
+ * published plugin's `./cli` points into `dist/` while the same plugin in a
+ * checkout points into `src/`.
+ *
+ * Null only when the plugin has no such part, which is a plugin's choice. A
+ * package that is gone, or an entry it declares that is not on disk, throws:
+ * the index still lists the plugin, and "declares a command but does not
+ * implement it" would send its author looking for a bug that is not theirs.
+ */
+export declare function entryPath(plugin: LoadedPlugin, part: PluginPart): string | null;
+/** Import one part of one plugin, memoised. */
+export declare function importEntry<H>(plugin: LoadedPlugin, part: PluginPart): Promise<PluginEntry<H> | null>;
+/** Clear the memo. For tests that load the same plugin under two settings. */
+export declare function forgetLoaded(): void;
+/** A plugin's `./core` part, activated, with whatever went wrong. */
+export interface CoreLoad {
+    ext: CoreExtensions;
+    /** One line per plugin that could not contribute, for stderr. */
+    problems: string[];
+}
+/**
+ * Activate every plugin's `./core` entry and merge what they registered.
+ *
+ * A plugin that throws while activating, or that collides with one already
+ * merged, is dropped and reported — the run continues with the plugins that
+ * worked. Dropping one plugin loses that plugin's data; refusing to start
+ * loses the user's whole tracker, and the second is not a better answer to a
+ * bad `package.json` somebody published.
+ */
+export declare function loadCoreExtensions(plugins: readonly LoadedPlugin[]): Promise<CoreLoad>;

package/dist/plugins/loader.js

@@ -0,0 +1,165 @@
+/**
+ * Importing a plugin's code, as late as possible — spec 04 §4.3, 05 §5.2.
+ *
+ * The rule this file exists to keep: nothing here runs for a command whose
+ * manifest does not name it. `nav issue list` on a machine with five plugins
+ * installed imports none of them, and `nav --help` imports none of them
+ * either, because the help was built from manifests. An `import()` of one
+ * plugin costs more than the whole of `nav issue list`'s budget, so this is
+ * not a micro-optimisation: it is the difference between plugins being
+ * affordable and not.
+ *
+ * What triggers a load is therefore always a *declaration* — a command the
+ * plugin declared being run, a contribution it declared being reached, a
+ * query term it declared being typed.
+ */
+var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
+    if (typeof path === "string" && /^\.\.?\//.test(path)) {
+        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
+            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
+        });
+    }
+    return path;
+};
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { pathToFileURL } from "node:url";
+import * as core from "@navbook/core";
+import { ExtensionConflictError, mergeExtensions, NO_EXTENSIONS, } from "@navbook/core";
+/** One import per part per process, however many commands ask for it. */
+const loaded = new Map();
+/**
+ * The file a plugin's `exports` maps a subpath to.
+ *
+ * Read from the package's own `package.json` rather than guessed, because the
+ * whole point of `exports` is that a package decides its own layout — and a
+ * published plugin's `./cli` points into `dist/` while the same plugin in a
+ * checkout points into `src/`.
+ *
+ * Null only when the plugin has no such part, which is a plugin's choice. A
+ * package that is gone, or an entry it declares that is not on disk, throws:
+ * the index still lists the plugin, and "declares a command but does not
+ * implement it" would send its author looking for a bug that is not theirs.
+ */
+export function entryPath(plugin, part) {
+    let pkg;
+    try {
+        pkg = JSON.parse(readFileSync(join(plugin.dir, "package.json"), "utf8"));
+    }
+    catch (error) {
+        throw new Error(existsSync(plugin.dir)
+            ? `its package.json cannot be read: ${message(error)}`
+            : `its package is not at ${plugin.dir}; reinstall it with 'nav plugin install ${plugin.name}'`);
+    }
+    const entry = pkg.exports?.[`./${part}`];
+    const file = typeof entry === "string" ? entry : resolveConditions(entry);
+    if (file === null)
+        return null;
+    const path = join(plugin.dir, file);
+    if (!existsSync(path))
+        throw new Error(`its './${part}' entry ${path} does not exist`);
+    return path;
+}
+/** Pick a file out of a conditional exports object, preferring what Node runs. */
+function resolveConditions(entry) {
+    if (typeof entry !== "object" || entry === null)
+        return null;
+    const conditions = entry;
+    for (const key of ["node", "import", "default", "require"]) {
+        const value = conditions[key];
+        if (typeof value === "string")
+            return value;
+        if (typeof value === "object" && value !== null) {
+            const nested = resolveConditions(value);
+            if (nested !== null)
+                return nested;
+        }
+    }
+    return null;
+}
+/** Import one part of one plugin, memoised. */
+export async function importEntry(plugin, part) {
+    const key = `${plugin.name}#${part}`;
+    const existing = loaded.get(key);
+    if (existing !== undefined)
+        return (await existing);
+    // Outside the memo, so a throw here is reported by each caller that asks.
+    const path = entryPath(plugin, part);
+    if (path === null) {
+        loaded.set(key, Promise.resolve(null));
+        return null;
+    }
+    const pending = import(__rewriteRelativeImportExtension(pathToFileURL(path).href));
+    loaded.set(key, pending);
+    return (await pending);
+}
+/** Clear the memo. For tests that load the same plugin under two settings. */
+export function forgetLoaded() {
+    loaded.clear();
+}
+/**
+ * Activate every plugin's `./core` entry and merge what they registered.
+ *
+ * A plugin that throws while activating, or that collides with one already
+ * merged, is dropped and reported — the run continues with the plugins that
+ * worked. Dropping one plugin loses that plugin's data; refusing to start
+ * loses the user's whole tracker, and the second is not a better answer to a
+ * bad `package.json` somebody published.
+ */
+export async function loadCoreExtensions(plugins) {
+    if (plugins.length === 0)
+        return { ext: NO_EXTENSIONS, problems: [] };
+    const parts = [];
+    const problems = [];
+    for (const plugin of plugins) {
+        const entry = await importEntry(plugin, "core").catch((error) => {
+            problems.push(`nav: plugin ${plugin.name} could not be loaded: ${message(error)}`);
+            return null;
+        });
+        if (entry === null)
+            continue;
+        if (typeof entry.activate !== "function") {
+            problems.push(`nav: plugin ${plugin.name} exports no activate() from './core'`);
+            continue;
+        }
+        const registered = [];
+        try {
+            await entry.activate({
+                core,
+                manifest: plugin.manifest,
+                settings: plugin.settings,
+                register: (received) => void registered.push(received),
+            });
+        }
+        catch (error) {
+            problems.push(`nav: plugin ${plugin.name} failed to activate: ${message(error)}`);
+            continue;
+        }
+        parts.push({ name: plugin.name, registered });
+    }
+    // Merge one plugin at a time, so a collision names the plugin that lost and
+    // the ones before it survive. Merging everything at once would only be able
+    // to say that two plugins collided, which is true but not actionable.
+    const kept = [];
+    for (const part of parts) {
+        try {
+            mergeExtensions([...kept, ...part.registered]);
+            kept.push(...part.registered);
+        }
+        catch (error) {
+            // Any fault, not only a collision: a registration of the wrong shape
+            // (`treeLocations` as an object, say) throws a TypeError from deep in
+            // the merge, and rethrowing it would take down every command over one
+            // plugin — the outcome this function exists to prevent.
+            const why = error instanceof ExtensionConflictError
+                ? error.message
+                : `what it registered could not be used: ${message(error)}`;
+            problems.push(`nav: plugin ${part.name} skipped: ${why}`);
+        }
+    }
+    return { ext: kept.length === 0 ? NO_EXTENSIONS : mergeExtensions(kept), problems };
+}
+function message(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=loader.js.map

package/dist/plugins/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/plugins/loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;;;;;;;;;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,KAAK,IAAI,MAAM,eAAe,CAAC;AACtC,OAAO,EAEL,sBAAsB,EACtB,eAAe,EACf,aAAa,GACd,MAAM,eAAe,CAAC;AAOvB,yEAAyE;AACzE,MAAM,MAAM,GAAG,IAAI,GAAG,EAA4B,CAAC;AAEnD;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,SAAS,CAAC,MAAoB,EAAE,IAAgB;IAC9D,IAAI,GAA0C,CAAC;IAC/C,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;IAC3E,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC;YACpB,CAAC,CAAC,oCAAoC,OAAO,CAAC,KAAK,CAAC,EAAE;YACtD,CAAC,CAAC,yBAAyB,MAAM,CAAC,GAAG,2CAA2C,MAAM,CAAC,IAAI,GAAG,CACjG,CAAC;IACJ,CAAC;IACD,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;IACzC,MAAM,IAAI,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAC1E,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC/B,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACpC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,UAAU,IAAI,WAAW,IAAI,iBAAiB,CAAC,CAAC;IACvF,OAAO,IAAI,CAAC;AACd,CAAC;AAED,kFAAkF;AAClF,SAAS,iBAAiB,CAAC,KAAc;IACvC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC7D,MAAM,UAAU,GAAG,KAAgC,CAAC;IACpD,KAAK,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,CAAC,EAAE,CAAC;QAC3D,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;QAC9B,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QAC5C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YAChD,MAAM,MAAM,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;YACxC,IAAI,MAAM,KAAK,IAAI;gBAAE,OAAO,MAAM,CAAC;QACrC,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,+CAA+C;AAC/C,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,MAAoB,EACpB,IAAgB;IAEhB,MAAM,GAAG,GAAG,GAAG,MAAM,CAAC,IAAI,IAAI,IAAI,EAAE,CAAC;IACrC,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,CAAC,MAAM,QAAQ,CAA0B,CAAC;IAE7E,0EAA0E;IAC1E,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACrC,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAClB,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QACvC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,kCAAC,aAAa,CAAC,IAAI,CAAC,CAAC,IAAI,EAAC,CAAC;IACjD,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACzB,OAAO,CAAC,MAAM,OAAO,CAAmB,CAAC;AAC3C,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,YAAY;IAC1B,MAAM,CAAC,KAAK,EAAE,CAAC;AACjB,CAAC;AASD;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,OAAgC;IACvE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,GAAG,EAAE,aAAa,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;IAEtE,MAAM,KAAK,GAAgF,EAAE,CAAC;IAC9F,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,KAAK,GAAG,MAAM,WAAW,CAAiB,MAAM,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;YACvF,QAAQ,CAAC,IAAI,CAAC,eAAe,MAAM,CAAC,IAAI,yBAAyB,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACnF,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CAAC;QACH,IAAI,KAAK,KAAK,IAAI;YAAE,SAAS;QAC7B,IAAI,OAAO,KAAK,CAAC,QAAQ,KAAK,UAAU,EAAE,CAAC;YACzC,QAAQ,CAAC,IAAI,CAAC,eAAe,MAAM,CAAC,IAAI,sCAAsC,CAAC,CAAC;YAChF,SAAS;QACX,CAAC;QACD,MAAM,UAAU,GAAgD,EAAE,CAAC;QACnE,IAAI,CAAC;YACH,MAAM,KAAK,CAAC,QAAQ,CAAC;gBACnB,IAAI;gBACJ,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,QAAQ,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,KAAK,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC;aACvD,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,QAAQ,CAAC,IAAI,CAAC,eAAe,MAAM,CAAC,IAAI,wBAAwB,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAClF,SAAS;QACX,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;IAChD,CAAC;IAED,4EAA4E;IAC5E,4EAA4E;IAC5E,sEAAsE;IACtE,MAAM,IAAI,GAAgD,EAAE,CAAC;IAC7D,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,eAAe,CAAC,CAAC,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;YAC/C,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC;QAChC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,qEAAqE;YACrE,sEAAsE;YACtE,sEAAsE;YACtE,wDAAwD;YACxD,MAAM,GAAG,GACP,KAAK,YAAY,sBAAsB;gBACrC,CAAC,CAAC,KAAK,CAAC,OAAO;gBACf,CAAC,CAAC,yCAAyC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAChE,QAAQ,CAAC,IAAI,CAAC,eAAe,IAAI,CAAC,IAAI,aAAa,GAAG,EAAE,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;IAED,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,CAAC;AACtF,CAAC;AAED,SAAS,OAAO,CAAC,KAAc;IAC7B,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC"}