@north-light/crouter 0.3.317 → 0.3.319

package/dist/commands/pkg/browse/command-view.js

@@ -1,191 +1 @@
-// The plugin browser's command-contract view: one node of a plugin's command
-// tree rendered as the whole contract an agent would read from `-h`.
-//
-// Pure rendering. It returns styled lines already wrapped to `width`; the
-// dossier owns scrolling and never truncates what comes back.
-import { visibleWidth, wrapTextWithAnsi } from '@earendil-works/pi-tui';
-import { theme, wrapText } from '../../../core/tui/panel.js';
-import { commandLabel } from './model.js';
-/** Every line of one command's contract view, wrapped to `width`. */
-export function renderCommandView(node, capability, width) {
-    const out = [];
-    out.push(...wrapped(commandLabel(node), width).map((line) => theme.fg("accent", theme.bold(line))));
-    out.push(...wrapped(`${node.kind.toUpperCase()} COMMAND · ${(node.tier ?? "normal").toUpperCase()} TIER`, width).map((line) => theme.fg("dim", line)));
-    out.push("");
-    out.push(...paragraph(node.description, width));
-    section(out, "WHEN TO USE", width);
-    out.push(...paragraph(node.whenToUse, width));
-    section(out, "SUMMARY", width);
-    out.push(...paragraph(node.summary, width));
-    if (node.kind === "leaf")
-        renderLeaf(out, node, capability, width);
-    else
-        renderBranch(out, node, width);
-    return out;
-}
-function renderLeaf(out, node, capability, width) {
-    section(out, "PARAMS", width);
-    if (node.params.length === 0)
-        out.push(...paragraph("No input parameters.", width));
-    else
-        for (const param of node.params)
-            out.push(...renderParam(param, width));
-    section(out, "OUTPUT", width);
-    if (node.output.length === 0)
-        out.push(...paragraph("No output fields declared.", width));
-    else
-        for (const field of node.output)
-            out.push(...renderField(field, width));
-    section(out, "EFFECTS", width);
-    if (node.effects.length === 0)
-        out.push(...paragraph("No effects declared.", width));
-    else
-        for (const effect of node.effects)
-            out.push(...hanging("  • ", effect, width));
-    section(out, "INVOKED VIA", width);
-    if (capability.transport === null) {
-        out.push(...wrapped("This plugin declares no command transport.", width).map((line) => theme.fg("warning", line)));
-        return;
-    }
-    const target = capability.transportTarget ?? "No target declared.";
-    out.push(...hanging(`  ${capability.transport}  `, target, width));
-    if (capability.transport === "http" && node.rest !== undefined) {
-        out.push(...hanging("  REST  ", `${node.rest.method} ${node.rest.path} · ${node.rest.streaming ? "streaming response" : "single response"}`, width));
-    }
-}
-function renderBranch(out, node, width) {
-    if (node.rootEntry !== undefined) {
-        section(out, "ROOT ENTRY", width);
-        out.push(...hanging("  Concept  ", node.rootEntry.concept, width));
-        out.push(...hanging("  Description  ", node.rootEntry.description, width));
-        out.push(...hanging("  When to use  ", node.rootEntry.whenToUse, width));
-    }
-    if (node.passthrough !== undefined) {
-        section(out, "PASSES THROUGH", width);
-        out.push(...hanging("  Binary  ", node.passthrough.bin, width));
-        out.push(...hanging("  Install  ", node.passthrough.installHint, width));
-    }
-    section(out, "CHILDREN", width);
-    if (node.children.length === 0) {
-        out.push(...paragraph(node.passthrough === undefined ? "No subcommands." : "No subcommands — every argument is forwarded to the binary.", width));
-        return;
-    }
-    for (const child of node.children)
-        out.push(...hanging(`  ${commandLabel(child)}  `, child.description, width));
-}
-function renderParam(param, width) {
-    const label = paramLabel(param);
-    const lines = hanging(`  ${label}  `, paramMeta(param), width);
-    // Each extra fact starts at one fixed column rather than under its own
-    // label: aligning to the label width makes a param list as ragged as its
-    // longest name, and `--target-pattern` would push its constraint 21 columns in.
-    const detailPrefix = DETAIL_INDENT;
-    if (param.kind === "positional") {
-        if (param.repeatable === true)
-            lines.push(...hanging(detailPrefix, "Repeatable; supply multiple values in argv order.", width));
-        if (param.encoding !== undefined)
-            lines.push(...hanging(detailPrefix, encodingDetail(param.encoding), width));
-        if (param.defaultFromEnv !== undefined)
-            lines.push(...hanging(detailPrefix, envDefaultDetail(param.defaultFromEnv), width));
-    }
-    else if (param.kind === "flag") {
-        if (param.choices !== undefined)
-            lines.push(...hanging(detailPrefix, `Choices: ${param.choices.join(", ")}.`, width));
-        if (param.default !== undefined)
-            lines.push(...hanging(detailPrefix, `Default: ${formatValue(param.default)}.`, width));
-        if (param.repeatable === true)
-            lines.push(...hanging(detailPrefix, "Repeatable; supply the flag multiple times to accumulate values.", width));
-        if (param.encoding !== undefined)
-            lines.push(...hanging(detailPrefix, encodingDetail(param.encoding), width));
-        if (param.defaultFromEnv !== undefined)
-            lines.push(...hanging(detailPrefix, envDefaultDetail(param.defaultFromEnv), width));
-        if (param.hidden === true)
-            lines.push(...hanging(detailPrefix, "Hidden from the command's ordinary -h output.", width, "warning"));
-    }
-    else if (param.kind === "context-file") {
-        lines.push(...hanging(detailPrefix, `Mapped input: ${param.name}.`, width));
-        if (param.shape !== undefined)
-            lines.push(...hanging(detailPrefix, `Expected JSON: ${param.shape}`, width));
-    }
-    lines.push(...hanging(detailPrefix, `Constraint: ${param.constraint}`, width));
-    return lines;
-}
-function renderField(field, width) {
-    return [
-        ...hanging(`  ${field.name}  `, `${field.type} · ${field.required ? "required" : "optional"}`, width),
-        ...hanging(DETAIL_INDENT, `Constraint: ${field.constraint}`, width),
-    ];
-}
-/** Where a param's or field's supporting facts start, whatever its name. */
-const DETAIL_INDENT = "    ";
-function paramLabel(param) {
-    switch (param.kind) {
-        case "positional":
-            return `${param.name}${param.repeatable === true ? "…" : ""}`;
-        case "flag":
-            return `--${param.name}`;
-        case "stdin":
-            return param.name;
-        case "context-file":
-            return "--context-file PATH";
-    }
-}
-function paramMeta(param) {
-    const requirement = param.required ? "required" : "optional";
-    switch (param.kind) {
-        case "positional":
-            return `positional · ${param.type ?? "string"} · ${requirement}`;
-        case "flag":
-            return `flag · ${param.type} · ${requirement}`;
-        case "stdin":
-            return `stdin · raw text · ${requirement}`;
-        case "context-file":
-            return `context file · JSON file · ${requirement}`;
-    }
-}
-function encodingDetail(encoding) {
-    return encoding === "base64"
-        ? "Encoding: reads the local file's raw bytes and sends base64; the path itself is never sent."
-        : "Encoding: reads the local file as UTF-8 text and sends its content; the path itself is never sent.";
-}
-function formatValue(value) {
-    return typeof value === "string" ? JSON.stringify(value) : String(value);
-}
-function envDefaultDetail(envVar) {
-    return `When $${envVar} is set and non-empty, it supplies the value and counts as supplied.`;
-}
-/** A section heading always has one blank line above it, never a trailing one. */
-function section(out, heading, width) {
-    out.push("");
-    out.push(...wrapped(heading, width).map((line) => theme.fg("dim", line)));
-}
-/** Prose sits two columns in, like the labelled rows beneath every other
- *  heading here and in the doc view — a flush-left paragraph between indented
- *  blocks reads as a different document. */
-function paragraph(text, width) {
-    const indent = "  ";
-    return wrapped(text, Math.max(1, width - indent.length)).map((line) => `${indent}${theme.fg("dim", line)}`);
-}
-/** Wrap text after a styled label; every continuation starts under its text. */
-function hanging(prefix, text, width, role = "dim") {
-    const prefixWidth = visibleWidth(prefix);
-    if (prefixWidth >= width) {
-        return [
-            ...wrapped(prefix.trimEnd(), width).map((line) => theme.fg("accent", line)),
-            ...wrapped(text, Math.max(1, width - 2)).map((line) => `  ${theme.fg(role, line)}`),
-        ];
-    }
-    const contentWidth = Math.max(1, width - prefixWidth);
-    const continuation = " ".repeat(prefixWidth);
-    return wrapped(text, contentWidth).map((line, index) => index === 0
-        ? `${theme.fg("accent", prefix)}${theme.fg(role, line)}`
-        : `${continuation}${theme.fg(role, line)}`);
-}
-/** Keep normal prose on the shared word wrapper, but never lose an over-wide token. */
-function wrapped(text, width) {
-    const clean = text.trim();
-    const safeWidth = Math.max(1, width);
-    return clean.split(/\s+/).some((word) => visibleWidth(word) > safeWidth)
-        ? wrapTextWithAnsi(clean, safeWidth)
-        : wrapText(clean, safeWidth);
-}
+var N=Object.defineProperty;var u=(e,n)=>N(e,"name",{value:n,configurable:!0});import{visibleWidth as g,wrapTextWithAnsi as y}from"@earendil-works/pi-tui";import{theme as f,wrapText as b}from"../../../core/tui/panel.js";import{commandLabel as h}from"./model.js";function W(e,n,t){const s=[];return s.push(...a(h(e),t).map(r=>f.fg("accent",f.bold(r)))),s.push(...a(`${e.kind.toUpperCase()} COMMAND \xB7 ${(e.tier??"normal").toUpperCase()} TIER`,t).map(r=>f.fg("dim",r))),s.push(""),s.push(...p(e.description,t)),c(s,"WHEN TO USE",t),s.push(...p(e.whenToUse,t)),c(s,"SUMMARY",t),s.push(...p(e.summary,t)),e.kind==="leaf"?x(s,e,n,t):S(s,e,t),s}u(W,"renderCommandView");function x(e,n,t,s){if(c(e,"PARAMS",s),n.params.length===0)e.push(...p("No input parameters.",s));else for(const o of n.params)e.push(...v(o,s));if(c(e,"OUTPUT",s),n.output.length===0)e.push(...p("No output fields declared.",s));else for(const o of n.output)e.push(...M(o,s));if(c(e,"EFFECTS",s),n.effects.length===0)e.push(...p("No effects declared.",s));else for(const o of n.effects)e.push(...i("  \u2022 ",o,s));if(c(e,"INVOKED VIA",s),t.transport===null){e.push(...a("This plugin declares no command transport.",s).map(o=>f.fg("warning",o)));return}const r=t.transportTarget??"No target declared.";e.push(...i(`  ${t.transport}  `,r,s)),t.transport==="http"&&n.rest!==void 0&&e.push(...i("  REST  ",`${n.rest.method} ${n.rest.path} \xB7 ${n.rest.streaming?"streaming response":"single response"}`,s))}u(x,"renderLeaf");function S(e,n,t){if(n.rootEntry!==void 0&&(c(e,"ROOT ENTRY",t),e.push(...i("  Concept  ",n.rootEntry.concept,t)),e.push(...i("  Description  ",n.rootEntry.description,t)),e.push(...i("  When to use  ",n.rootEntry.whenToUse,t))),n.passthrough!==void 0&&(c(e,"PASSES THROUGH",t),e.push(...i("  Binary  ",n.passthrough.bin,t)),e.push(...i("  Install  ",n.passthrough.installHint,t))),c(e,"CHILDREN",t),n.children.length===0){e.push(...p(n.passthrough===void 0?"No subcommands.":"No subcommands \u2014 every argument is forwarded to the binary.",t));return}for(const s of n.children)e.push(...i(`  ${h(s)}  `,s.description,t))}u(S,"renderBranch");function v(e,n){const t=C(e),s=i(`  ${t}  `,D(e),n),r=m;return e.kind==="positional"?(e.repeatable===!0&&s.push(...i(r,"Repeatable; supply multiple values in argv order.",n)),e.encoding!==void 0&&s.push(...i(r,d(e.encoding),n)),e.defaultFromEnv!==void 0&&s.push(...i(r,$(e.defaultFromEnv),n))):e.kind==="flag"?(e.choices!==void 0&&s.push(...i(r,`Choices: ${e.choices.join(", ")}.`,n)),e.default!==void 0&&s.push(...i(r,`Default: ${O(e.default)}.`,n)),e.repeatable===!0&&s.push(...i(r,"Repeatable; supply the flag multiple times to accumulate values.",n)),e.encoding!==void 0&&s.push(...i(r,d(e.encoding),n)),e.defaultFromEnv!==void 0&&s.push(...i(r,$(e.defaultFromEnv),n)),e.hidden===!0&&s.push(...i(r,"Hidden from the command's ordinary -h output.",n,"warning"))):e.kind==="context-file"&&(s.push(...i(r,`Mapped input: ${e.name}.`,n)),e.shape!==void 0&&s.push(...i(r,`Expected JSON: ${e.shape}`,n))),s.push(...i(r,`Constraint: ${e.constraint}`,n)),s}u(v,"renderParam");function M(e,n){return[...i(`  ${e.name}  `,`${e.type} \xB7 ${e.required?"required":"optional"}`,n),...i(m,`Constraint: ${e.constraint}`,n)]}u(M,"renderField");const m="    ";function C(e){switch(e.kind){case"positional":return`${e.name}${e.repeatable===!0?"\u2026":""}`;case"flag":return`--${e.name}`;case"stdin":return e.name;case"context-file":return"--context-file PATH"}}u(C,"paramLabel");function D(e){const n=e.required?"required":"optional";switch(e.kind){case"positional":return`positional \xB7 ${e.type??"string"} \xB7 ${n}`;case"flag":return`flag \xB7 ${e.type} \xB7 ${n}`;case"stdin":return`stdin \xB7 raw text \xB7 ${n}`;case"context-file":return`context file \xB7 JSON file \xB7 ${n}`}}u(D,"paramMeta");function d(e){return e==="base64"?"Encoding: reads the local file's raw bytes and sends base64; the path itself is never sent.":"Encoding: reads the local file as UTF-8 text and sends its content; the path itself is never sent."}u(d,"encodingDetail");function O(e){return typeof e=="string"?JSON.stringify(e):String(e)}u(O,"formatValue");function $(e){return`When $${e} is set and non-empty, it supplies the value and counts as supplied.`}u($,"envDefaultDetail");function c(e,n,t){e.push(""),e.push(...a(n,t).map(s=>f.fg("dim",s)))}u(c,"section");function p(e,n){return a(e,Math.max(1,n-2)).map(s=>`  ${f.fg("dim",s)}`)}u(p,"paragraph");function i(e,n,t,s="dim"){const r=g(e);if(r>=t)return[...a(e.trimEnd(),t).map(l=>f.fg("accent",l)),...a(n,Math.max(1,t-2)).map(l=>`  ${f.fg(s,l)}`)];const o=Math.max(1,t-r),E=" ".repeat(r);return a(n,o).map((l,T)=>T===0?`${f.fg("accent",e)}${f.fg(s,l)}`:`${E}${f.fg(s,l)}`)}u(i,"hanging");function a(e,n){const t=e.trim(),s=Math.max(1,n);return t.split(/\s+/).some(r=>g(r)>s)?y(t,s):b(t,s)}u(a,"wrapped");export{W as renderCommandView};

package/dist/commands/pkg/browse/detail-panel.js

@@ -1,402 +1 @@
-// The right-hand dossier, and the explorer rooted in it.
-//
-// The dossier is a view stack: an overview of what the plugin adds, and — one
-// `enter` deeper — a whole memory doc or a whole command contract. The overview
-// is not a teaser: every command node and every memory doc it lists is a real
-// row a cursor can land on and open, and nothing is elided with `+N more`.
-import { truncateToWidth, visibleWidth } from '@earendil-works/pi-tui';
-import { padAnsi, theme, wrapText } from '../../../core/tui/panel.js';
-import { renderCommandView } from './command-view.js';
-import { renderDocView } from './doc-view.js';
-import { commandLabel, displayVersion, plural } from './model.js';
-/** One labelled row and its explanation. Inline while both fit; otherwise the
- *  explanation wraps underneath, hanging under the label rather than resetting
- *  to the left margin. Nothing is ever truncated to make it fit. */
-function entryLines(indent, label, explanation, width, hangingIndent) {
-    const styled = `${indent}${theme.fg("accent", label)}`;
-    if (explanation === undefined || explanation.trim() === "")
-        return [styled];
-    const inline = `${indent}${label} — ${explanation}`;
-    if (visibleWidth(inline) <= width)
-        return [`${styled}${theme.fg("dim", ` — ${explanation}`)}`];
-    // The hanging indent is blank space, never a re-print of the prefix: an
-    // indent carrying a branch's ▾ would stamp that glyph down every wrapped
-    // line of its description, as though each were another branch.
-    const hanging = hangingIndent ?? " ".repeat(visibleWidth(indent) + 2);
-    return [
-        styled,
-        ...wrapText(explanation, Math.max(1, width - hanging.length)).map((line) => `${hanging}${theme.fg("dim", line)}`),
-    ];
-}
-/** `wrapText` trims, so wrapping an already-indented string silently loses its
- *  indent on every line. Wrap the text, then indent each line. */
-function indented(indent, text, width, hangingIndent = indent) {
-    return wrapText(text, Math.max(1, width - indent.length)).map((line, index) => `${index === 0 ? indent : hangingIndent}${line}`);
-}
-export class PkgDetailPanel {
-    entry;
-    source;
-    capability;
-    pluginAction;
-    marketplaceAction;
-    /** Page-level catalog problems. The list's notice shows the first; this is
-     *  where the rest stay readable. */
-    warnings = [];
-    scroll = 0;
-    /** Extra scrolling the user asked for past the last selectable row, so the
-     *  inert tail of the overview stays reachable. Reset whenever the cursor
-     *  moves or the view changes. */
-    tailScroll = 0;
-    cursor = 0;
-    view = { kind: "overview" };
-    /** Command branches the user has folded shut, by command path. Branches are
-     *  open by default: the explorer's whole point is that nothing is hidden. */
-    collapsed = new Set();
-    /** Last render's geometry, so scrolling can clamp against real content
-     *  instead of running a counter nobody can see. */
-    lastLines = 0;
-    lastHeight = 1;
-    /** Where the cursor's row sits in the last built overview, in line numbers. */
-    cursorRange;
-    setEntry(entry, source, capability) {
-        const changedEntry = this.entry?.key !== entry?.key;
-        if (changedEntry || this.source?.id !== source?.id) {
-            this.scroll = 0;
-            this.tailScroll = 0;
-        }
-        if (changedEntry) {
-            this.pluginAction = undefined;
-            this.view = { kind: "overview" };
-            this.cursor = 0;
-            this.collapsed.clear();
-        }
-        if (this.source?.id !== source?.id)
-            this.marketplaceAction = undefined;
-        this.entry = entry;
-        this.source = source;
-        this.capability = capability;
-    }
-    setPluginAction(entry, outcome) {
-        this.pluginAction = entry === undefined ? undefined : { key: entry.key, outcome };
-    }
-    setMarketplaceAction(sourceId, outcome) {
-        this.marketplaceAction = sourceId === undefined ? undefined : { sourceId, outcome };
-    }
-    setWarnings(warnings) {
-        this.warnings = warnings;
-    }
-    /** True while an opened doc or command owns the pane, so the shell's footer
-     *  can teach `esc back` instead of `esc list`. */
-    get viewing() {
-        return this.view.kind !== "overview";
-    }
-    // navigation
-    /** `j`/`k`: move the cursor between selectable rows on the overview, scroll a
-     *  line inside an opened view — and scroll the overview too when the plugin
-     *  has nothing selectable to move between. */
-    moveVertical(delta) {
-        const targets = this.targets();
-        if (this.view.kind !== "overview" || targets.length === 0) {
-            this.scroll = Math.max(0, Math.min(this.scroll + delta, Math.max(0, this.lastLines - this.lastHeight)));
-            return;
-        }
-        const next = Math.max(0, Math.min(targets.length - 1, this.cursor + delta));
-        if (next !== this.cursor) {
-            this.cursor = next;
-            this.tailScroll = 0;
-            return;
-        }
-        // The cursor is already on the last row, but ON DISK and FROM sit below it
-        // as inert text. Keep scrolling so a plugin with 78 memory docs does not
-        // bury its own install path where nothing can reach it.
-        this.tailScroll = Math.max(0, this.tailScroll + delta);
-    }
-    /** `space`: fold the focused command branch shut, or open it again. */
-    toggleExpand() {
-        const target = this.targets()[this.cursor];
-        if (this.view.kind !== "overview" || target?.kind !== "command")
-            return false;
-        if (target.node.children.length === 0)
-            return false;
-        const key = target.node.path.join(" ");
-        if (this.collapsed.has(key))
-            this.collapsed.delete(key);
-        else {
-            this.collapsed.add(key);
-            // Folding removes rows below the cursor; the cursor itself stays on the
-            // branch it just folded, which is still row `this.cursor`.
-        }
-        return true;
-    }
-    /** `enter`/`l`: open the focused doc or command as its own view. */
-    open() {
-        if (this.view.kind !== "overview")
-            return false;
-        const target = this.targets()[this.cursor];
-        if (target === undefined)
-            return false;
-        this.view = target.kind === "command"
-            ? { kind: "command", node: target.node }
-            : { kind: "doc", doc: target.doc };
-        this.scroll = 0;
-        return true;
-    }
-    /** `h`/`left`: pop an open view, else fold the focused branch. False means
-     *  the key was not used here and the shell should leave for the list. */
-    collapseOrPop() {
-        if (this.view.kind !== "overview")
-            return this.popView();
-        return this.toggleExpandShut();
-    }
-    /** `esc`: pop an open view. False at the root, where the shell leaves. */
-    escape() {
-        return this.popView();
-    }
-    popView() {
-        if (this.view.kind === "overview")
-            return false;
-        this.view = { kind: "overview" };
-        this.scroll = 0;
-        this.tailScroll = 0;
-        return true;
-    }
-    toggleExpandShut() {
-        const target = this.targets()[this.cursor];
-        if (target?.kind !== "command" || target.node.children.length === 0)
-            return false;
-        const key = target.node.path.join(" ");
-        if (this.collapsed.has(key))
-            return false;
-        this.collapsed.add(key);
-        return true;
-    }
-    // the selectable model
-    /** Command rows in display order, skipping the children of folded branches. */
-    commandRows() {
-        const rows = [];
-        const walk = (nodes, depth) => {
-            for (const node of nodes) {
-                rows.push({ node, depth });
-                if (node.children.length > 0 && !this.collapsed.has(node.path.join(" ")))
-                    walk(node.children, depth + 1);
-            }
-        };
-        walk(this.capability?.commands ?? [], 0);
-        return rows;
-    }
-    /** Every row the cursor can land on, in the order the overview renders them.
-     *  The renderer walks the same two lists, so index N here is row N there. */
-    targets() {
-        const capability = this.capability;
-        if (capability === undefined || capability === null)
-            return [];
-        return [
-            ...this.commandRows().map((row) => ({ kind: "command", node: row.node })),
-            ...capability.docs.map((doc) => ({ kind: "doc", doc })),
-        ];
-    }
-    // rendering
-    render(width, height, focused) {
-        const lines = this.lines(width, focused);
-        this.lastLines = lines.length;
-        this.lastHeight = height;
-        let start = 0;
-        if (focused) {
-            const range = this.view.kind === "overview" ? this.cursorRange : undefined;
-            let cursorScroll;
-            if (range !== undefined) {
-                if (range.start < this.scroll)
-                    this.scroll = range.start;
-                if (range.start + range.count > this.scroll + height)
-                    this.scroll = range.start + range.count - height;
-                cursorScroll = this.scroll;
-                this.scroll += this.tailScroll;
-            }
-            // Clamping here is what keeps the last reachable position a full pane
-            // rather than one line of text above an empty one.
-            this.scroll = Math.max(0, Math.min(this.scroll, Math.max(0, lines.length - height)));
-            // Bank only the tail scrolling that actually landed, so one `k` walks
-            // back up instead of unwinding every keypress the clamp swallowed.
-            if (cursorScroll !== undefined)
-                this.tailScroll = Math.max(0, this.scroll - cursorScroll);
-            start = this.scroll;
-        }
-        const window = lines.slice(start, start + height).map((line) => truncateToWidth(line, width));
-        // Pad to the full height so the divider drawn beside this column runs the
-        // whole page rather than stopping where the dossier's text runs out.
-        while (window.length < height)
-            window.push("");
-        return window;
-    }
-    lines(width, focused) {
-        const entry = this.entry;
-        if (entry === undefined)
-            return this.sourceLines(this.source, width);
-        if (this.view.kind === "doc")
-            return renderDocView(this.view.doc, width);
-        if (this.view.kind === "command" && this.capability !== undefined && this.capability !== null)
-            return renderCommandView(this.view.node, this.capability, width);
-        return this.overviewLines(entry, width, focused);
-    }
-    overviewLines(entry, width, focused) {
-        const out = [];
-        const ranges = [];
-        const push = (lines, selectable = false) => {
-            if (selectable)
-                ranges.push({ start: out.length, count: lines.length });
-            out.push(...lines);
-        };
-        const version = displayVersion(entry) ?? "";
-        const identity = theme.fg("accent", theme.bold(entry.name));
-        const gap = width - visibleWidth(identity) - visibleWidth(version);
-        push([gap >= 2 ? `${identity}${" ".repeat(gap)}${theme.fg("dim", version)}` : identity]);
-        push([this.status(entry)]);
-        if (entry.description) {
-            push([""]);
-            push(wrapText(entry.description, width));
-        }
-        const capability = this.capability;
-        if (capability === undefined) {
-            push(["", theme.fg("dim", "ADDS TO CRTR"), theme.fg("dim", " Reading capability surface…")]);
-        }
-        else if (capability === null) {
-            push(["", theme.fg("warning", "Capability details are unavailable — plugin files are not on disk.")]);
-        }
-        else {
-            push(["", theme.fg("dim", "ADDS TO CRTR")]);
-            const transport = this.transportLine(capability);
-            if (transport !== undefined)
-                push([transport]);
-            push([
-                ` ${plural(this.commandRows().length, "command", "commands")} · ${plural(capability.docs.length, "memory doc", "memory docs")}`,
-            ].map((line) => theme.fg("dim", line)));
-            const commandRows = this.commandRows();
-            if (commandRows.length > 0 || capability.commandIssues.length > 0) {
-                push(["", theme.fg("dim", "COMMANDS")]);
-                for (const row of commandRows)
-                    push(this.commandRowLines(row, width), true);
-                for (const issue of capability.commandIssues)
-                    push(indented(" ! ", `${issue.message}${issue.next ? ` — ${issue.next}` : ""}`, width, "   ").map((line) => theme.fg("warning", line)));
-            }
-            if (capability.docs.length > 0) {
-                push(["", theme.fg("dim", "MEMORY")]);
-                for (const doc of capability.docs)
-                    // Correction 2: the description beside a doc is its short form —
-                    // what the doc SAYS. Its routing line is agent read-routing and
-                    // lives under the doc view's own heading, never here.
-                    push(entryLines("   ", doc.name, doc.shortForm, width), true);
-            }
-            if (entry.install.kind === "installed" && capability.sizeBytes !== undefined) {
-                push(["", theme.fg("dim", "ON DISK")]);
-                push([` ${theme.fg("accent", entry.install.path)}${theme.fg("dim", ` · ${this.size(capability.sizeBytes)}`)}`]);
-            }
-        }
-        push(this.fromLines(entry, width));
-        if (this.pluginAction?.key === entry.key && this.pluginAction.outcome.detail?.length) {
-            push(["", theme.fg("dim", "LAST ACTION")]);
-            for (const line of this.pluginAction.outcome.detail)
-                push(indented(" ", line, width));
-        }
-        this.cursor = ranges.length === 0 ? 0 : Math.min(this.cursor, ranges.length - 1);
-        this.cursorRange = ranges[this.cursor];
-        const range = this.cursorRange;
-        if (focused && range !== undefined)
-            for (let line = range.start; line < range.start + range.count; line += 1)
-                out[line] = theme.bg("selectedBg", padAnsi(out[line] ?? "", width));
-        return out;
-    }
-    commandRowLines(row, width) {
-        const indent = `   ${"  ".repeat(row.depth)}`;
-        const glyph = row.node.children.length === 0
-            ? "  "
-            : this.collapsed.has(row.node.path.join(" "))
-                ? `${theme.fg("dim", "▸")} `
-                : `${theme.fg("dim", "▾")} `;
-        const prefix = `${indent}${glyph}`;
-        // A leaf indents its wrapped description under its label, as a memory doc
-        // does. A branch cannot: that column is where its own children's labels
-        // start, so its description would read as one more subcommand. It hangs
-        // flush with the label instead, where only the glyph column sits.
-        const hanging = row.node.children.length === 0 ? undefined : " ".repeat(visibleWidth(prefix));
-        return entryLines(prefix, commandLabel(row.node), row.node.description, width, hanging);
-    }
-    status(entry) {
-        if (entry.install.kind === "absent")
-            return theme.fg("dim", "Not installed");
-        if (entry.install.scope === "builtin")
-            return `${theme.fg("muted", "Builtin")} · ships with crtr`;
-        // Enablement survives an update offer: a disabled plugin that happens to
-        // have a newer version is still disabled, and the status line is the one
-        // place that fact is spelled out.
-        const enablement = entry.install.enabled ? theme.fg("success", "enabled") : theme.fg("dim", "disabled");
-        if (entry.install.updateAvailable)
-            return `${theme.fg("warning", `Update available · ${entry.install.version ?? "?"} → ${entry.version ?? "?"}`)} · ${enablement}`;
-        return `Installed · ${entry.install.scope} · ${enablement}`;
-    }
-    transportLine(capability) {
-        if (capability.transport === null)
-            return undefined;
-        const target = capability.transportTarget === undefined ? "" : ` · ${capability.transportTarget}`;
-        return capability.transport === "http"
-            ? ` ${theme.fg("accent", "Transport")}  http${theme.fg("warning", target)}`
-            : ` ${theme.fg("accent", "Transport")}  exec${theme.fg("dim", target)}`;
-    }
-    fromLines(entry, width) {
-        if (!entry.marketplace && !entry.source && !entry.owner)
-            return [];
-        const out = ["", theme.fg("dim", "FROM")];
-        if (entry.marketplace) {
-            const revision = this.source?.marketplace?.revision;
-            // A short revision: this line says which clone the plugin came from, and
-            // a 40-character object name buys nothing a human reads here.
-            out.push(` ${theme.fg("accent", entry.marketplace)}${revision ? theme.fg("dim", ` @ ${revision.slice(0, 12)}`) : ""}`);
-        }
-        if (entry.source)
-            out.push(...indented(" ", entry.source, width));
-        if (entry.owner?.name || entry.owner?.email)
-            out.push(theme.fg("dim", ` owner · ${entry.owner.name ?? entry.owner.email}`));
-        return out;
-    }
-    /** The dossier for a source rather than a plugin: what a marketplace is and
-     *  where it came from, or the library's own shape — plus every catalog
-     *  problem, which is page-level and has no other home with room for it. */
-    sourceLines(source, width) {
-        const marketplace = source?.marketplace;
-        const out = [];
-        if (marketplace === undefined) {
-            out.push(theme.fg("accent", theme.bold(source?.label ?? "Library")));
-            out.push(theme.fg("dim", "Choose a marketplace or plugin to inspect it."));
-        }
-        else {
-            out.push(theme.fg("accent", theme.bold(marketplace.name)));
-            out.push(`Installed ${marketplace.installedCount}/${marketplace.pluginCount} plugins${theme.fg("dim", ` · ${plural(marketplace.updatableCount, "update", "updates")}`)}`);
-            out.push("", theme.fg("dim", "MARKETPLACE"));
-            out.push(` ${theme.fg("accent", marketplace.scope)} scope · ${marketplace.ref}`);
-            out.push(...indented(" ", marketplace.url, width));
-            out.push(` ${theme.fg("accent", marketplace.path)}`);
-            if (marketplace.revision)
-                out.push(` revision · ${marketplace.revision}${marketplace.revisionDate ? ` · ${marketplace.revisionDate}` : ""}`);
-            if (marketplace.owner?.name || marketplace.owner?.email)
-                out.push(` owner · ${marketplace.owner.name ?? marketplace.owner.email}`);
-        }
-        if (this.warnings.length > 0) {
-            out.push("", theme.fg("dim", "PROBLEMS"));
-            for (const warning of this.warnings)
-                out.push(...indented(" ", warning, width).map((line) => theme.fg("warning", line)));
-        }
-        const action = this.marketplaceAction;
-        if (action !== undefined && action.sourceId === source?.id && action.outcome.detail?.length) {
-            out.push("", theme.fg("dim", "LAST ACTION"));
-            for (const line of action.outcome.detail)
-                out.push(...indented(" ", line, width));
-        }
-        return out;
-    }
-    size(bytes) {
-        if (bytes < 1024)
-            return `${bytes} B`;
-        if (bytes < 1024 * 1024)
-            return `${Math.round(bytes / 1024)} KB`;
-        return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
-    }
-}
+var b=Object.defineProperty;var f=(c,i)=>b(c,"name",{value:i,configurable:!0});import{truncateToWidth as L,visibleWidth as p}from"@earendil-works/pi-tui";import{padAnsi as R,theme as t,wrapText as v}from"../../../core/tui/panel.js";import{renderCommandView as S}from"./command-view.js";import{renderDocView as x}from"./doc-view.js";import{commandLabel as T,displayVersion as C,plural as w}from"./model.js";function A(c,i,e,n,s){const o=`${c}${t.fg("accent",i)}`;if(e===void 0||e.trim()==="")return[o];const r=`${c}${i} \u2014 ${e}`;if(p(r)<=n)return[`${o}${t.fg("dim",` \u2014 ${e}`)}`];const a=s??" ".repeat(p(c)+2);return[o,...v(e,Math.max(1,n-a.length)).map(u=>`${a}${t.fg("dim",u)}`)]}f(A,"entryLines");function m(c,i,e,n=c){return v(i,Math.max(1,e-c.length)).map((s,o)=>`${o===0?c:n}${s}`)}f(m,"indented");class P{static{f(this,"PkgDetailPanel")}entry;source;capability;pluginAction;marketplaceAction;warnings=[];scroll=0;tailScroll=0;cursor=0;view={kind:"overview"};collapsed=new Set;lastLines=0;lastHeight=1;cursorRange;setEntry(i,e,n){const s=this.entry?.key!==i?.key;(s||this.source?.id!==e?.id)&&(this.scroll=0,this.tailScroll=0),s&&(this.pluginAction=void 0,this.view={kind:"overview"},this.cursor=0,this.collapsed.clear()),this.source?.id!==e?.id&&(this.marketplaceAction=void 0),this.entry=i,this.source=e,this.capability=n}setPluginAction(i,e){this.pluginAction=i===void 0?void 0:{key:i.key,outcome:e}}setMarketplaceAction(i,e){this.marketplaceAction=i===void 0?void 0:{sourceId:i,outcome:e}}setWarnings(i){this.warnings=i}get viewing(){return this.view.kind!=="overview"}moveVertical(i){const e=this.targets();if(this.view.kind!=="overview"||e.length===0){this.scroll=Math.max(0,Math.min(this.scroll+i,Math.max(0,this.lastLines-this.lastHeight)));return}const n=Math.max(0,Math.min(e.length-1,this.cursor+i));if(n!==this.cursor){this.cursor=n,this.tailScroll=0;return}this.tailScroll=Math.max(0,this.tailScroll+i)}toggleExpand(){const i=this.targets()[this.cursor];if(this.view.kind!=="overview"||i?.kind!=="command"||i.node.children.length===0)return!1;const e=i.node.path.join(" ");return this.collapsed.has(e)?this.collapsed.delete(e):this.collapsed.add(e),!0}open(){if(this.view.kind!=="overview")return!1;const i=this.targets()[this.cursor];return i===void 0?!1:(this.view=i.kind==="command"?{kind:"command",node:i.node}:{kind:"doc",doc:i.doc},this.scroll=0,!0)}collapseOrPop(){return this.view.kind!=="overview"?this.popView():this.toggleExpandShut()}escape(){return this.popView()}popView(){return this.view.kind==="overview"?!1:(this.view={kind:"overview"},this.scroll=0,this.tailScroll=0,!0)}toggleExpandShut(){const i=this.targets()[this.cursor];if(i?.kind!=="command"||i.node.children.length===0)return!1;const e=i.node.path.join(" ");return this.collapsed.has(e)?!1:(this.collapsed.add(e),!0)}commandRows(){const i=[],e=f((n,s)=>{for(const o of n)i.push({node:o,depth:s}),o.children.length>0&&!this.collapsed.has(o.path.join(" "))&&e(o.children,s+1)},"walk");return e(this.capability?.commands??[],0),i}targets(){const i=this.capability;return i==null?[]:[...this.commandRows().map(e=>({kind:"command",node:e.node})),...i.docs.map(e=>({kind:"doc",doc:e}))]}render(i,e,n){const s=this.lines(i,n);this.lastLines=s.length,this.lastHeight=e;let o=0;if(n){const a=this.view.kind==="overview"?this.cursorRange:void 0;let u;a!==void 0&&(a.start<this.scroll&&(this.scroll=a.start),a.start+a.count>this.scroll+e&&(this.scroll=a.start+a.count-e),u=this.scroll,this.scroll+=this.tailScroll),this.scroll=Math.max(0,Math.min(this.scroll,Math.max(0,s.length-e))),u!==void 0&&(this.tailScroll=Math.max(0,this.scroll-u)),o=this.scroll}const r=s.slice(o,o+e).map(a=>L(a,i));for(;r.length<e;)r.push("");return r}lines(i,e){const n=this.entry;return n===void 0?this.sourceLines(this.source,i):this.view.kind==="doc"?x(this.view.doc,i):this.view.kind==="command"&&this.capability!==void 0&&this.capability!==null?S(this.view.node,this.capability,i):this.overviewLines(n,i,e)}overviewLines(i,e,n){const s=[],o=[],r=f((l,$=!1)=>{$&&o.push({start:s.length,count:l.length}),s.push(...l)},"push"),a=C(i)??"",u=t.fg("accent",t.bold(i.name)),k=e-p(u)-p(a);r([k>=2?`${u}${" ".repeat(k)}${t.fg("dim",a)}`:u]),r([this.status(i)]),i.description&&(r([""]),r(v(i.description,e)));const d=this.capability;if(d===void 0)r(["",t.fg("dim","ADDS TO CRTR"),t.fg("dim"," Reading capability surface\u2026")]);else if(d===null)r(["",t.fg("warning","Capability details are unavailable \u2014 plugin files are not on disk.")]);else{r(["",t.fg("dim","ADDS TO CRTR")]);const l=this.transportLine(d);l!==void 0&&r([l]),r([` ${w(this.commandRows().length,"command","commands")} \xB7 ${w(d.docs.length,"memory doc","memory docs")}`].map(h=>t.fg("dim",h)));const $=this.commandRows();if($.length>0||d.commandIssues.length>0){r(["",t.fg("dim","COMMANDS")]);for(const h of $)r(this.commandRowLines(h,e),!0);for(const h of d.commandIssues)r(m(" ! ",`${h.message}${h.next?` \u2014 ${h.next}`:""}`,e,"   ").map(M=>t.fg("warning",M)))}if(d.docs.length>0){r(["",t.fg("dim","MEMORY")]);for(const h of d.docs)r(A("   ",h.name,h.shortForm,e),!0)}i.install.kind==="installed"&&d.sizeBytes!==void 0&&(r(["",t.fg("dim","ON DISK")]),r([` ${t.fg("accent",i.install.path)}${t.fg("dim",` \xB7 ${this.size(d.sizeBytes)}`)}`]))}if(r(this.fromLines(i,e)),this.pluginAction?.key===i.key&&this.pluginAction.outcome.detail?.length){r(["",t.fg("dim","LAST ACTION")]);for(const l of this.pluginAction.outcome.detail)r(m(" ",l,e))}this.cursor=o.length===0?0:Math.min(this.cursor,o.length-1),this.cursorRange=o[this.cursor];const g=this.cursorRange;if(n&&g!==void 0)for(let l=g.start;l<g.start+g.count;l+=1)s[l]=t.bg("selectedBg",R(s[l]??"",e));return s}commandRowLines(i,e){const n=`   ${"  ".repeat(i.depth)}`,s=i.node.children.length===0?"  ":this.collapsed.has(i.node.path.join(" "))?`${t.fg("dim","\u25B8")} `:`${t.fg("dim","\u25BE")} `,o=`${n}${s}`,r=i.node.children.length===0?void 0:" ".repeat(p(o));return A(o,T(i.node),i.node.description,e,r)}status(i){if(i.install.kind==="absent")return t.fg("dim","Not installed");if(i.install.scope==="builtin")return`${t.fg("muted","Builtin")} \xB7 ships with crtr`;const e=i.install.enabled?t.fg("success","enabled"):t.fg("dim","disabled");return i.install.updateAvailable?`${t.fg("warning",`Update available \xB7 ${i.install.version??"?"} \u2192 ${i.version??"?"}`)} \xB7 ${e}`:`Installed \xB7 ${i.install.scope} \xB7 ${e}`}transportLine(i){if(i.transport===null)return;const e=i.transportTarget===void 0?"":` \xB7 ${i.transportTarget}`;return i.transport==="http"?` ${t.fg("accent","Transport")}  http${t.fg("warning",e)}`:` ${t.fg("accent","Transport")}  exec${t.fg("dim",e)}`}fromLines(i,e){if(!i.marketplace&&!i.source&&!i.owner)return[];const n=["",t.fg("dim","FROM")];if(i.marketplace){const s=this.source?.marketplace?.revision;n.push(` ${t.fg("accent",i.marketplace)}${s?t.fg("dim",` @ ${s.slice(0,12)}`):""}`)}return i.source&&n.push(...m(" ",i.source,e)),(i.owner?.name||i.owner?.email)&&n.push(t.fg("dim",` owner \xB7 ${i.owner.name??i.owner.email}`)),n}sourceLines(i,e){const n=i?.marketplace,s=[];if(n===void 0?(s.push(t.fg("accent",t.bold(i?.label??"Library"))),s.push(t.fg("dim","Choose a marketplace or plugin to inspect it."))):(s.push(t.fg("accent",t.bold(n.name))),s.push(`Installed ${n.installedCount}/${n.pluginCount} plugins${t.fg("dim",` \xB7 ${w(n.updatableCount,"update","updates")}`)}`),s.push("",t.fg("dim","MARKETPLACE")),s.push(` ${t.fg("accent",n.scope)} scope \xB7 ${n.ref}`),s.push(...m(" ",n.url,e)),s.push(` ${t.fg("accent",n.path)}`),n.revision&&s.push(` revision \xB7 ${n.revision}${n.revisionDate?` \xB7 ${n.revisionDate}`:""}`),(n.owner?.name||n.owner?.email)&&s.push(` owner \xB7 ${n.owner.name??n.owner.email}`)),this.warnings.length>0){s.push("",t.fg("dim","PROBLEMS"));for(const r of this.warnings)s.push(...m(" ",r,e).map(a=>t.fg("warning",a)))}const o=this.marketplaceAction;if(o!==void 0&&o.sourceId===i?.id&&o.outcome.detail?.length){s.push("",t.fg("dim","LAST ACTION"));for(const r of o.outcome.detail)s.push(...m(" ",r,e))}return s}size(i){return i<1024?`${i} B`:i<1024*1024?`${Math.round(i/1024)} KB`:`${(i/(1024*1024)).toFixed(1)} MB`}}export{P as PkgDetailPanel};