@north-light/crouter 0.3.318 → 0.3.320

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

@@ -1,89 +1 @@
-// The plugin browser's memory-doc reader: one doc rendered whole, for a human
-// deciding whether the agent reading it will do the right thing.
-//
-// Pure rendering. It receives a doc already read from disk and returns styled
-// lines already wrapped to `width`; the dossier owns scrolling and never
-// truncates what comes back.
-import { getMarkdownTheme } from '@earendil-works/pi-coding-agent';
-import { Markdown, visibleWidth, wrapTextWithAnsi } from '@earendil-works/pi-tui';
-import { theme, wrapText } from '../../../core/tui/panel.js';
-/** Every line of one memory doc's reader view, wrapped to `width`. */
-export function renderDocView(doc, width) {
-    const out = [];
-    const viewWidth = Math.max(1, width);
-    out.push(...wrapped(doc.name, viewWidth).map((line) => theme.fg("accent", theme.bold(line))));
-    out.push(theme.fg("dim", doc.kind));
-    if (doc.shortForm) {
-        out.push("");
-        out.push(...paragraph(doc.shortForm, viewWidth));
-    }
-    out.push("", theme.fg("dim", "READ WHEN"));
-    out.push(...paragraph(doc.routingLine || "Not declared.", viewWidth));
-    // One row per surfaces entry answers "will an agent ever see this?"; a doc
-    // with none is reachable through listings and explicit reads only, and the
-    // qualifiers below are shown only when the doc sets one.
-    out.push("", theme.fg("dim", "ROUTING"));
-    if (doc.surfaces.length === 0) {
-        out.push(...paragraph("No surfaces — reachable through directory listings and explicit reads only.", viewWidth));
-    }
-    for (const entry of doc.surfaces) {
-        const parts = [`at ${entry.at}`];
-        if (entry.match?.length)
-            parts.push(entry.match.join(", "));
-        if (entry.matchFrontmatter !== undefined)
-            parts.push(JSON.stringify(entry.matchFrontmatter));
-        if (entry.gate !== undefined)
-            parts.push(JSON.stringify(entry.gate));
-        out.push(...field(entry.on, parts.join("  "), viewWidth));
-    }
-    if (doc.unlisted)
-        out.push(...field("unlisted", "suppressed from directory listings", viewWidth));
-    if (doc.slash)
-        out.push(...field("slash", `/${doc.name.replaceAll("/", ":")}`, viewWidth));
-    if (doc.gate !== undefined)
-        out.push(...field("gate", JSON.stringify(doc.gate), viewWidth));
-    if (doc.rationale) {
-        out.push("", theme.fg("dim", "RATIONALE"));
-        out.push(...paragraph(doc.rationale, viewWidth));
-    }
-    out.push("", theme.fg("dim", "ON DISK"));
-    out.push(...field("path", doc.path, viewWidth));
-    out.push(...field("size", size(doc.sizeBytes), viewWidth));
-    out.push("", theme.fg("dim", "BODY"), "");
-    out.push(...new Markdown(doc.body, 0, 0, getMarkdownTheme()).render(viewWidth));
-    return out;
-}
-/** A prose block gets a quiet, stable left edge instead of reflowing raggedly
- * against a section title. */
-function paragraph(text, width) {
-    const indent = "  ";
-    return wrapped(text, Math.max(1, width - indent.length)).map((line) => `${indent}${theme.fg("dim", line)}`);
-}
-/** A field's later rows line up under its value, not under its label. */
-function field(label, value, width) {
-    const prefix = `  ${label}  `;
-    const indent = " ".repeat(visibleWidth(prefix));
-    const valueWidth = Math.max(1, width - visibleWidth(prefix));
-    return wrapped(value, valueWidth).map((line, index) => index === 0
-        ? `${theme.fg("accent", prefix)}${theme.fg("dim", line)}`
-        : `${indent}${theme.fg("dim", line)}`);
-}
-/** `wrapText` is the page's ordinary prose wrapper. Its word-oriented contract
- * deliberately leaves a filesystem path or compact JSON predicate intact, so
- * use pi-tui's character-safe wrapper only for those over-wide tokens instead
- * of turning a full value into an ellipsis. */
-function wrapped(text, width) {
-    const clean = text.trim();
-    return clean.split(/\s+/).some((word) => visibleWidth(word) > width)
-        ? wrapTextWithAnsi(clean, width)
-        : wrapText(clean, width);
-}
-function size(bytes) {
-    if (bytes === undefined)
-        return "unknown";
-    if (bytes < 1024)
-        return `${bytes} B`;
-    if (bytes < 1024 * 1024)
-        return `${Math.round(bytes / 1024)} KB`;
-    return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
-}
+var d=Object.defineProperty;var u=(t,s)=>d(t,"name",{value:s,configurable:!0});import{getMarkdownTheme as l}from"@earendil-works/pi-coding-agent";import{Markdown as c,visibleWidth as p,wrapTextWithAnsi as $}from"@earendil-works/pi-tui";import{theme as r,wrapText as x}from"../../../core/tui/panel.js";function B(t,s){const n=[],e=Math.max(1,s);n.push(...m(t.name,e).map(i=>r.fg("accent",r.bold(i)))),n.push(r.fg("dim",t.kind)),t.shortForm&&(n.push(""),n.push(...f(t.shortForm,e))),n.push("",r.fg("dim","READ WHEN")),n.push(...f(t.routingLine||"Not declared.",e)),n.push("",r.fg("dim","ROUTING")),t.surfaces.length===0&&n.push(...f("No surfaces \u2014 reachable through directory listings and explicit reads only.",e));for(const i of t.surfaces){const a=[`at ${i.at}`];i.match?.length&&a.push(i.match.join(", ")),i.matchFrontmatter!==void 0&&a.push(JSON.stringify(i.matchFrontmatter)),i.gate!==void 0&&a.push(JSON.stringify(i.gate)),n.push(...h(i.on,a.join("  "),e))}return t.unlisted&&n.push(...h("unlisted","suppressed from directory listings",e)),t.slash&&n.push(...h("slash",`/${t.name.replaceAll("/",":")}`,e)),t.gate!==void 0&&n.push(...h("gate",JSON.stringify(t.gate),e)),t.rationale&&(n.push("",r.fg("dim","RATIONALE")),n.push(...f(t.rationale,e))),n.push("",r.fg("dim","ON DISK")),n.push(...h("path",t.path,e)),n.push(...h("size",N(t.sizeBytes),e)),n.push("",r.fg("dim","BODY"),""),n.push(...new c(t.body,0,0,l()).render(e)),n}u(B,"renderDocView");function f(t,s){return m(t,Math.max(1,s-2)).map(e=>`  ${r.fg("dim",e)}`)}u(f,"paragraph");function h(t,s,n){const e=`  ${t}  `,i=" ".repeat(p(e)),a=Math.max(1,n-p(e));return m(s,a).map((o,g)=>g===0?`${r.fg("accent",e)}${r.fg("dim",o)}`:`${i}${r.fg("dim",o)}`)}u(h,"field");function m(t,s){const n=t.trim();return n.split(/\s+/).some(e=>p(e)>s)?$(n,s):x(n,s)}u(m,"wrapped");function N(t){return t===void 0?"unknown":t<1024?`${t} B`:t<1024*1024?`${Math.round(t/1024)} KB`:`${(t/(1024*1024)).toFixed(1)} MB`}u(N,"size");export{B as renderDocView};

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

@@ -1,168 +1,2 @@
-import { matchesKey, truncateToWidth, visibleWidth } from '@earendil-works/pi-tui';
-import { padAnsi, theme, visibleRange } from '../../../core/tui/panel.js';
-import { displayVersion, plural } from './model.js';
-/** The middle column of the plugin browser. It owns filtering and row position;
- * the shell owns horizontal navigation and actions. */
-export class PkgListPanel {
-    onChange;
-    source;
-    index = 0;
-    filter = "";
-    filtering = false;
-    notice;
-    hasMarketplaces = false;
-    constructor(onChange) {
-        this.onChange = onChange;
-    }
-    get selected() {
-        const entries = this.entries();
-        this.index = Math.max(0, Math.min(this.index, entries.length - 1));
-        return entries[this.index];
-    }
-    get ownsKeyboard() {
-        return this.filtering;
-    }
-    setSource(source, selectedKey) {
-        const changed = this.source?.id !== source.id;
-        this.source = source;
-        const entries = this.entries();
-        const found = selectedKey === undefined ? -1 : entries.findIndex((entry) => entry.key === selectedKey);
-        this.index = found >= 0 ? found : changed ? 0 : Math.min(this.index, Math.max(0, entries.length - 1));
-        if (changed) {
-            this.filter = "";
-            this.filtering = false;
-        }
-    }
-    setEmptyState(hasMarketplaces) {
-        this.hasMarketplaces = hasMarketplaces;
-    }
-    move(delta) {
-        const entries = this.entries();
-        if (entries.length === 0)
-            return;
-        this.index = Math.max(0, Math.min(entries.length - 1, this.index + delta));
-        this.onChange();
-    }
-    /** Returns true only when a live filter consumed the input. */
-    handleInput(data) {
-        if (this.filtering) {
-            if (matchesKey(data, "escape")) {
-                this.filter = "";
-                this.filtering = false;
-            }
-            else if (matchesKey(data, "enter")) {
-                // Enter leaves entry mode but deliberately keeps the narrowed list.
-                this.filtering = false;
-            }
-            else if (matchesKey(data, "backspace")) {
-                this.filter = this.filter.slice(0, -1);
-                this.index = 0;
-            }
-            else if (data.length === 1 && data.charCodeAt(0) >= 32) {
-                this.filter += data;
-                this.index = 0;
-            }
-            this.onChange();
-            return true;
-        }
-        if (data === "/" || matchesKey(data, "/")) {
-            this.filtering = true;
-            this.onChange();
-            return true;
-        }
-        // Escape has a useful local meaning only while a committed filter remains.
-        if (matchesKey(data, "escape") && this.filter !== "") {
-            this.filter = "";
-            this.index = 0;
-            this.onChange();
-            return true;
-        }
-        return false;
-    }
-    setNotice(notice) {
-        this.notice = notice;
-    }
-    entries() {
-        const entries = this.source?.entries ?? [];
-        const needle = this.filter.trim().toLowerCase();
-        if (needle === "")
-            return entries;
-        return entries.filter((entry) => [entry.name, entry.description ?? "", ...entry.keywords]
-            .join("\n")
-            .toLowerCase()
-            .includes(needle));
-    }
-    render(width, height, focused) {
-        const out = [];
-        const source = this.source;
-        const entries = this.entries();
-        const sourceLabel = source?.kind === "installed" ? "Installed" : source?.label ?? "Library";
-        const filterLabel = this.filtering
-            ? ` /${this.filter} · ${plural(entries.length, "match", "matches")}`
-            : this.filter === ""
-                ? ` ${plural(entries.length, "plugin", "plugins")}`
-                : ` ${plural(entries.length, "match", "matches")} · esc clears`;
-        // A marketplace name can be wider than this whole column, so the source
-        // label yields first: how many rows matched and how to get back out are
-        // what a filtering user needs, and truncating the pair together drops
-        // exactly that half off the end.
-        const labelRoom = Math.max(3, width - visibleWidth(filterLabel));
-        out.push(truncateToWidth(`${theme.fg("accent", theme.bold(truncateToWidth(sourceLabel, labelRoom)))}${theme.fg("dim", filterLabel)}`, width));
-        if (this.notice !== undefined) {
-            out.push(truncateToWidth(theme.fg("warning", `! ${this.notice}`), width));
-        }
-        if (entries.length === 0) {
-            out.push("");
-            const firstRun = source?.kind === "installed" && !this.hasMarketplaces;
-            if (firstRun) {
-                out.push(truncateToWidth(theme.fg("accent", "No marketplaces yet."), width));
-                out.push(truncateToWidth(theme.fg("dim", "Press a to add a marketplace."), width));
-            }
-            else {
-                out.push(truncateToWidth(theme.fg("dim", "No plugins installed yet."), width));
-                out.push(truncateToWidth(theme.fg("dim", "Press tab to browse marketplaces."), width));
-            }
-            return this.fit(out, height);
-        }
-        const available = Math.max(1, height - out.length);
-        const range = visibleRange(entries.length, this.index, available);
-        for (let position = range.start; position < range.end; position += 1) {
-            const entry = entries[position];
-            const selected = position === this.index;
-            const glyph = this.stateGlyph(entry);
-            const version = displayVersion(entry);
-            const prefix = `${glyph} ${entry.name}`;
-            const suffix = version === undefined ? "" : ` ${version}`;
-            const fixed = visibleWidth(prefix) + visibleWidth(suffix);
-            const descriptionWidth = width - fixed - 2;
-            const description = descriptionWidth >= 12 && entry.description
-                ? theme.fg("dim", `  ${truncateToWidth(entry.description, descriptionWidth)}`)
-                : "";
-            const row = truncateToWidth(`${prefix}${suffix}${description}`, width);
-            out.push(selected && focused
-                ? theme.bg("selectedBg", padAnsi(row, width))
-                : selected
-                    ? `${theme.fg("accent", "▌")}${truncateToWidth(theme.fg("accent", row), Math.max(0, width - 1))}`
-                    : row);
-        }
-        return this.fit(out, height);
-    }
-    /** Pad rather than trim: this column sets the length of the divider drawn
-     *  beside it, and a divider that stops where the content runs out makes the
-     *  page look half-drawn. */
-    fit(lines, height) {
-        while (lines.length < height)
-            lines.push("");
-        return lines.slice(0, height);
-    }
-    stateGlyph(entry) {
-        if (entry.install.kind === "absent")
-            return " ";
-        if (entry.install.scope === "builtin")
-            return theme.fg("muted", "⌂");
-        if (entry.install.enabled) {
-            return entry.install.updateAvailable ? theme.fg("warning", "↑") : theme.fg("success", "✓");
-        }
-        return theme.fg("dim", "○");
-    }
-}
+var I=Object.defineProperty;var C=(d,e)=>I(d,"name",{value:e,configurable:!0});import{matchesKey as c,truncateToWidth as n,visibleWidth as u}from"@earendil-works/pi-tui";import{padAnsi as N,theme as t,visibleRange as W}from"../../../core/tui/panel.js";import{displayVersion as G,plural as g}from"./model.js";class K{static{C(this,"PkgListPanel")}onChange;source;index=0;filter="";filtering=!1;notice;hasMarketplaces=!1;constructor(e){this.onChange=e}get selected(){const e=this.entries();return this.index=Math.max(0,Math.min(this.index,e.length-1)),e[this.index]}get ownsKeyboard(){return this.filtering}setSource(e,i){const r=this.source?.id!==e.id;this.source=e;const s=this.entries(),h=i===void 0?-1:s.findIndex(l=>l.key===i);this.index=h>=0?h:r?0:Math.min(this.index,Math.max(0,s.length-1)),r&&(this.filter="",this.filtering=!1)}setEmptyState(e){this.hasMarketplaces=e}move(e){const i=this.entries();i.length!==0&&(this.index=Math.max(0,Math.min(i.length-1,this.index+e)),this.onChange())}handleInput(e){return this.filtering?(c(e,"escape")?(this.filter="",this.filtering=!1):c(e,"enter")?this.filtering=!1:c(e,"backspace")?(this.filter=this.filter.slice(0,-1),this.index=0):e.length===1&&e.charCodeAt(0)>=32&&(this.filter+=e,this.index=0),this.onChange(),!0):e==="/"||c(e,"/")?(this.filtering=!0,this.onChange(),!0):c(e,"escape")&&this.filter!==""?(this.filter="",this.index=0,this.onChange(),!0):!1}setNotice(e){this.notice=e}entries(){const e=this.source?.entries??[],i=this.filter.trim().toLowerCase();return i===""?e:e.filter(r=>[r.name,r.description??"",...r.keywords].join(`
+`).toLowerCase().includes(i))}render(e,i,r){const s=[],h=this.source,l=this.entries(),y=h?.kind==="installed"?"Installed":h?.label??"Library",p=this.filtering?` /${this.filter} \xB7 ${g(l.length,"match","matches")}`:this.filter===""?` ${g(l.length,"plugin","plugins")}`:` ${g(l.length,"match","matches")} \xB7 esc clears`,v=Math.max(3,e-u(p));if(s.push(n(`${t.fg("accent",t.bold(n(y,v)))}${t.fg("dim",p)}`,e)),this.notice!==void 0&&s.push(n(t.fg("warning",`! ${this.notice}`),e)),l.length===0)return s.push(""),h?.kind==="installed"&&!this.hasMarketplaces?(s.push(n(t.fg("accent","No marketplaces yet."),e)),s.push(n(t.fg("dim","Press a to add a marketplace."),e))):(s.push(n(t.fg("dim","No plugins installed yet."),e)),s.push(n(t.fg("dim","Press tab to browse marketplaces."),e))),this.fit(s,i);const L=Math.max(1,i-s.length),m=W(l.length,this.index,L);for(let a=m.start;a<m.end;a+=1){const o=l[a],x=a===this.index,P=this.stateGlyph(o),b=G(o),$=`${P} ${o.name}`,k=b===void 0?"":` ${b}`,R=u($)+u(k),M=e-R-2,A=M>=12&&o.description?t.fg("dim",`  ${n(o.description,M)}`):"",f=n(`${$}${k}${A}`,e);s.push(x&&r?t.bg("selectedBg",N(f,e)):x?`${t.fg("accent","\u258C")}${n(t.fg("accent",f),Math.max(0,e-1))}`:f)}return this.fit(s,i)}fit(e,i){for(;e.length<i;)e.push("");return e.slice(0,i)}stateGlyph(e){return e.install.kind==="absent"?" ":e.install.scope==="builtin"?t.fg("muted","\u2302"):e.install.enabled?e.install.updateAvailable?t.fg("warning","\u2191"):t.fg("success","\u2713"):t.fg("dim","\u25CB")}}export{K as PkgListPanel};

package/dist/commands/pkg/browse/model.js

@@ -1,36 +1 @@
-// The read model behind `crtr pkg browse` — one shape the catalog produces, the
-// action layer consumes, and the panels render.
-//
-// The browser answers one question the flat `pkg market browse` listing cannot:
-// *what does installing this actually do to my crtr?* So an entry carries its
-// marketplace metadata (cheap, from the manifest index) separately from its
-// capability surface (commands mounted, memory docs provided, transport), which
-// costs a directory read and is resolved on demand for the focused row only.
-export const INSTALLED_SOURCE_ID = "installed";
-export function marketplaceSourceId(name, scope) {
-    return `market:${scope}:${name}`;
-}
-/** `crtr search web` — how a user types the command a node names. The one place
- *  a command path becomes a label, so no corner of the page invents its own. */
-export function commandLabel(node) {
-    return `crtr ${node.path.join(" ")}`;
-}
-/** Every node in a command forest, parents before their children. */
-export function flattenCommands(nodes) {
-    return nodes.flatMap((node) => [node, ...flattenCommands(node.children)]);
-}
-/** The version to show beside a plugin's name, anywhere in the page.
- *
- *  One rule, one place: the version beside a name is always the one in play on
- *  THIS machine — what is installed, or what installing would get you. The
- *  marketplace's offer for an already-installed plugin is a different fact, and
- *  it appears only as the right-hand side of the update arrow in the status
- *  line. Headline and list row both call this so they cannot disagree. */
-export function displayVersion(entry) {
-    return entry.install.kind === "installed" ? entry.install.version ?? entry.version : entry.version;
-}
-/** `<count> <noun>`, with the noun agreeing with the count. Every count this
- *  page renders goes through here so no corner of it reads "1 docs". */
-export function plural(count, one, many) {
-    return `${count} ${count === 1 ? one : many}`;
-}
+var o=Object.defineProperty;var t=(n,r)=>o(n,"name",{value:r,configurable:!0});const l="installed";function p(n,r){return`market:${r}:${n}`}t(p,"marketplaceSourceId");function s(n){return`crtr ${n.path.join(" ")}`}t(s,"commandLabel");function i(n){return n.flatMap(r=>[r,...i(r.children)])}t(i,"flattenCommands");function u(n){return n.install.kind==="installed"?n.install.version??n.version:n.version}t(u,"displayVersion");function c(n,r,e){return`${n} ${n===1?r:e}`}t(c,"plural");export{l as INSTALLED_SOURCE_ID,s as commandLabel,u as displayVersion,i as flattenCommands,p as marketplaceSourceId,c as plural};