@cellarnode/ui 0.201.1 → 0.203.0

package/dist/agent/role-cards/data-table-card.js

@@ -0,0 +1,214 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useId, useLayoutEffect, useRef, useState } from "react";
+import { ArrowUpRight } from "lucide-react";
+import { cn } from "../../lib/utils.js";
+import { DEFAULT_QUOTE, fmt, quoteText, useCopy } from "../copy.js";
+import { MaskedValue } from "../masked-value.js";
+import { isMasked } from "../schema.js";
+import { focusRing } from "../ui.js";
+import { AgentCardExtras, AgentCardFrame, AgentCardLink, } from "./card-kit.js";
+import { agentLinkKind } from "./surface-links.js";
+import { cleanInline } from "./text-safety.js";
+const DEFAULT_COPY = {
+    title: "Results",
+    caption: "Results table",
+    empty: "Nothing to show",
+    emptyCell: "-",
+    capped: "Showing the first {shown} of {total} rows",
+    column: "Column {n}",
+    yes: "Yes",
+    no: "No",
+    hidden: "Hidden",
+    quote: DEFAULT_QUOTE,
+    openOffer: "Open offer",
+    openProducer: "Open producer page",
+    openOrganisation: "Open organisation profile",
+    openPortfolio: "Open portfolio",
+    openProduct: "Open product",
+    openProductGallery: "Open product gallery",
+    openLabels: "Open labels",
+    openImports: "Open imports",
+    openElabelHome: "Open e-label home",
+    openElabel: "Open in e-label",
+    openOther: "Open in the dashboard",
+};
+const LINK_COPY = {
+    offer: "openOffer",
+    producer: "openProducer",
+    organisation: "openOrganisation",
+    portfolio: "openPortfolio",
+    product: "openProduct",
+    productGallery: "openProductGallery",
+    labels: "openLabels",
+    imports: "openImports",
+    elabelHome: "openElabelHome",
+    elabel: "openElabel",
+};
+/**
+ * Columns whose text is obviously someone else's, quoted without the host having to say so: a buyer, a counterparty, the
+ * opportunity an offer answers, and the columns the cellarnode-mcp agents key by author (`counterpartyFile`: the other side's offer
+ * file; `producerFile` and `producerBeverage`: a producer's public documents and beverages as an importer sees them; `file` is the
+ * caller's own and is not here). `thirdPartyColumns` EXTENDS these (`surfaceThirdPartyColumns` is the per-surface list). A
+ * `DataTable` has no flag that marks a column untrusted, so the column's key is what says whose words it carries.
+ */
+export const DEFAULT_THIRD_PARTY_COLUMNS = [
+    "buyer",
+    "counterparty",
+    "opportunity",
+    "market",
+    "counterpartyFile",
+    "producerFile",
+    "producerBeverage",
+];
+/** Rows drawn. The schema allows 500, the agents emit at most 51 (50 and a marker row), a chat card is not a data grid. */
+export const MAX_AGENT_TABLE_ROWS = 100;
+/** Code points of one cell's text; longer text ends in an ellipsis. */
+const MAX_CELL = 300;
+/** Code points of a column label and of a mask's display text. */
+const MAX_LABEL = 80;
+/** A cell's value, or `undefined` when the row has no such key. Own keys only: `constructor` and `__proto__` are not data. */
+const cellOf = (row, key) => Object.hasOwn(row, key) ? row[key] : undefined;
+/** One formatter per locale tag for the life of the page (building an `Intl.NumberFormat` is not cheap); a bad tag is remembered too. */
+const NUMBER_FORMATTERS = new Map();
+/** How a number reads: as JavaScript spells it, or in the host's locale (never grouped, so a year or an id stays as it is). */
+function numberFormatter(locale) {
+    if (locale === undefined)
+        return String;
+    const known = NUMBER_FORMATTERS.get(locale);
+    if (known)
+        return known;
+    let made;
+    try {
+        const format = new Intl.NumberFormat(locale, { useGrouping: false, maximumFractionDigits: 20 });
+        made = (n) => format.format(n);
+    }
+    catch {
+        made = String; // an unknown locale tag is the host's bug, not a reason to lose the table
+    }
+    NUMBER_FORMATTERS.set(locale, made);
+    return made;
+}
+/** The host's text for a plain cell, cleaned; `undefined` when the host has none, said nothing readable or threw. */
+function hostText(formatCell, key, value) {
+    if (!formatCell)
+        return undefined;
+    try {
+        return cleanInline(formatCell(key, value), MAX_CELL, true);
+    }
+    catch {
+        return undefined; // host code: fall back to the default text
+    }
+}
+/**
+ * One cell, as inert text. Nothing a cell holds becomes markup, a link or an instruction: a string is cleaned (unsafe characters out,
+ * whitespace collapsed, clipped), a number or a boolean is spelled out, a mask stays a mask, and an empty value is a dash.
+ */
+function TableCell({ columnKey, value, maskedColumn, quoted, copy, maskedCopy, formatNumber, formatCell, }) {
+    const dash = _jsx(MaskedValue, { value: null, empty: copy.emptyCell, copy: maskedCopy });
+    if (value === undefined || value === null || value === "")
+        return dash;
+    if (isMasked(value)) {
+        const display = cleanInline(value.display, MAX_LABEL, true) ?? copy.hidden;
+        return _jsx(MaskedValue, { value: { masked: true, display }, copy: maskedCopy });
+    }
+    // The server said this column is masked and sent a plain value: fail closed, never show it.
+    if (maskedColumn)
+        return _jsx(MaskedValue, { value: { masked: true, display: copy.hidden }, copy: maskedCopy });
+    const custom = hostText(formatCell, columnKey, value);
+    const text = custom ??
+        (typeof value === "boolean"
+            ? value
+                ? copy.yes
+                : copy.no
+            : typeof value === "number"
+                ? formatNumber(value)
+                : cleanInline(value, MAX_CELL, true));
+    if (text === undefined)
+        return dash;
+    return quoted && typeof value === "string" ? quoteText(text, copy.quote) : text;
+}
+/**
+ * Is the scrolling area wider than the card? Measured before paint and again whenever the area or the table changes size, so the
+ * area is a keyboard stop exactly when there is something to scroll to (`scrollable-region-focusable`), and not a dead tab stop
+ * otherwise. When it loses its overflow while it has focus, focus moves to the card.
+ */
+function useOverflowing(active) {
+    const ref = useRef(null);
+    const [overflowing, setOverflowing] = useState(false);
+    useLayoutEffect(() => {
+        const el = ref.current;
+        if (!active || !el)
+            return;
+        const measure = () => {
+            const wide = el.scrollWidth > el.clientWidth;
+            // The area stops being a tab stop when it stops overflowing. If it has focus, hand focus to the card first, or it would
+            // fall back to the page.
+            if (!wide && el.ownerDocument.activeElement === el) {
+                const card = el.closest("section");
+                if (card) {
+                    if (!card.hasAttribute("tabindex"))
+                        card.setAttribute("tabindex", "-1");
+                    card.focus({ preventScroll: true });
+                }
+            }
+            // A DOM measurement can only be read after layout. Taken before paint it never shows a frame with the wrong tab stop.
+            // eslint-disable-next-line @eslint-react/set-state-in-effect -- the setter is the measurement's result, not derived state
+            setOverflowing(wide);
+        };
+        measure();
+        if (typeof ResizeObserver === "undefined")
+            return;
+        const observer = new ResizeObserver(measure);
+        observer.observe(el);
+        if (el.firstElementChild)
+            observer.observe(el.firstElementChild);
+        return () => observer.disconnect();
+    }, [active]);
+    return { ref, overflowing: active && overflowing };
+}
+/**
+ * @internal Read card for a table the agent shows (CEL-2488): the file link tools, a producer's documents and showcase. Pure props in,
+ * events out, drawn on the card kit like every role card.
+ *
+ * - Cells are inert text, never markup or links. A mask stays a mask; a plain value in a column marked `masked` is replaced by a mask
+ *   (the server is the one that masks, so a plain value there is a contract break, and it is not shown). Text someone else wrote
+ *   renders quoted when its column is in `DEFAULT_THIRD_PARTY_COLUMNS` or the host's `thirdPartyColumns`.
+ * - The table's `link` is a visible link under the table, named for the page it opens ("Open offer", from `copy`), and it is drawn
+ *   only when the host's `allowLink` accepts the path: a refused link draws nothing. Rows carry no link of their own (the schema has
+ *   none).
+ * - Read-only: a `detail` pointer and a `proposal` are not drawn, because a table is a list, not one record (`readRoleCard` drops
+ *   them). `actions` go through the same catalog and `allowLink` rules as every card.
+ * - Rows past `MAX_AGENT_TABLE_ROWS` are left out and the card says so.
+ */
+export function AgentDataTableCard({ data, copy, thirdPartyColumns, columnLabels, formatCell, locale, ...host }) {
+    const { allowLink, renderLink, maskedCopy } = host;
+    const c = useCopy(DEFAULT_COPY, copy);
+    const captionId = useId();
+    // Rows and columns have no id of their own (two columns may share a key), so each gets its position as one.
+    const rows = data.rows.slice(0, MAX_AGENT_TABLE_ROWS).map((cells, r) => ({ id: `r${r}`, cells }));
+    const columns = data.columns.map((col, i) => ({
+        id: `c${i}`,
+        key: col.key,
+        label: (columnLabels && Object.hasOwn(columnLabels, col.key)
+            ? cleanInline(columnLabels[col.key], MAX_LABEL, true)
+            : undefined) ??
+            cleanInline(col.label, MAX_LABEL, true) ??
+            fmt(c.column, { n: i + 1 }),
+        masked: col.masked === true,
+        quoted: DEFAULT_THIRD_PARTY_COLUMNS.includes(col.key) || !!thirdPartyColumns?.includes(col.key),
+    }));
+    const formatNumber = numberFormatter(locale);
+    const { ref, overflowing } = useOverflowing(rows.length > 0);
+    const link = data.link !== undefined && allowLink?.(data.link) === true ? data.link : undefined;
+    const kind = link === undefined ? undefined : agentLinkKind(link);
+    return (_jsxs(AgentCardFrame, { title: c.title, children: [rows.length === 0 ? (_jsx("p", { className: "text-sm/5 text-muted-foreground", children: c.empty })) : (
+            // A wide table scrolls inside the card. Only then is the scrolling area a keyboard stop, and it is a named group (not a
+            // second landmark: the card is already the region).
+            _jsx("div", { ref: ref, ...(overflowing ? { role: "group", tabIndex: 0, "aria-labelledby": captionId } : {}), className: cn("overflow-x-auto rounded-xl ring-1 ring-border/60", focusRing), children: _jsxs("table", { className: "w-full text-start text-xs/5", children: [_jsx("caption", { id: captionId, className: "sr-only", children: c.caption }), _jsx("thead", { children: _jsx("tr", { className: "border-b border-border bg-muted/40 text-muted-foreground", children: columns.map((col) => (_jsx("th", { scope: "col", 
+                                    // `text-start` on the cell itself: a `th` that only inherits `start` is centred by the user agent.
+                                    className: "px-3 py-2 text-start align-top font-medium", children: col.label }, col.id))) }) }), _jsx("tbody", { children: rows.map((row) => (_jsx("tr", { className: "border-b border-border/60 last:border-b-0", children: columns.map((col) => {
+                                    const value = cellOf(row.cells, col.key);
+                                    return (_jsx("td", { className: "px-3 py-2 align-top", children: _jsx("div", { className: cn("max-w-64 min-w-24 wrap-anywhere", typeof value === "number" && "tabular-nums"), children: _jsx(TableCell, { columnKey: col.key, value: value, maskedColumn: col.masked, quoted: col.quoted, copy: c, maskedCopy: maskedCopy, formatNumber: formatNumber, formatCell: formatCell }) }) }, col.id));
+                                }) }, row.id))) })] }) })), data.rows.length > MAX_AGENT_TABLE_ROWS && (_jsx("p", { className: "text-xs/4 text-muted-foreground", children: fmt(c.capped, { shown: MAX_AGENT_TABLE_ROWS, total: data.rows.length }) })), link !== undefined && (_jsxs(AgentCardLink, { path: link, allowLink: allowLink, renderLink: renderLink, className: "inline-flex items-center gap-1 self-start text-sm/5 font-medium text-primary underline hover:decoration-2", children: [c[kind ? LINK_COPY[kind] : "openOther"], _jsx(ArrowUpRight, { "aria-hidden": true, className: "size-3.5 shrink-0 rtl:-scale-x-100" })] })), _jsx(AgentCardExtras, { data: { actions: data.actions }, subject: undefined, host: host })] }));
+}
+//# sourceMappingURL=data-table-card.js.map

package/dist/agent/role-cards/data-table-card.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-table-card.js","sourceRoot":"","sources":["../../../src/agent/role-cards/data-table-card.tsx"],"names":[],"mappings":"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"}

package/dist/agent/role-cards/fixtures.d.ts

@@ -0,0 +1,124 @@
+import { z } from "zod";
+import type { DataTableData, MatchCardData, OfferCardData, OpportunityCardData, ProductCardData } from "@cellarnode/agent-cards/zod4";
+export declare const offerFull: OfferCardData;
+export declare const offerMinimal: OfferCardData;
+export declare const offerMasked: OfferCardData;
+export declare const offerAccepted: OfferCardData;
+export declare const offerRejected: OfferCardData;
+export declare const offerLongText: OfferCardData;
+export declare const offerProposal: OfferCardData;
+export declare const productFull: ProductCardData;
+export declare const productReady: ProductCardData;
+export declare const productMinimal: ProductCardData;
+export declare const productProposal: ProductCardData;
+export declare const opportunityOpen: OpportunityCardData;
+export declare const opportunityExpired: OpportunityCardData;
+export declare const opportunityMinimal: OpportunityCardData;
+export declare const matchStrong: MatchCardData;
+export declare const matchWeak: MatchCardData;
+export declare const matchMid: MatchCardData;
+export declare const matchDeclined: MatchCardData;
+export declare const matchMasked: MatchCardData;
+export declare const matchMinimal: MatchCardData;
+/** `get_offer_file_link`: the offer page, where the file opens. The file came from the other side of the offer. */
+export declare const tableOfferFile: DataTableData;
+/** `get_org_document_link`, as the producer's agent draws it. The caller's own document. */
+export declare const tableOrgDocument: DataTableData;
+/** `get_org_document_link`, as the importer's agent draws it: the importer has the same organisation profile page. */
+export declare const tableImporterOrgDocument: DataTableData;
+/** `get_attachment_link`, as the producer's agent draws it: where the file is shown (a product gallery). */
+export declare const tableAttachment: DataTableData;
+/** `list_producer_documents`, as the importer's agent draws it: three columns and the row that says the list was cut short. */
+export declare const tableProducerDocuments: DataTableData;
+/** `get_producer_showcase`, as the importer's agent draws it: a version count at the tool's cap on a cut list reads "20+". */
+export declare const tableProducerShowcase: DataTableData;
+/** An e-label producer's attachment: the e-label app keeps its producer area under `/app`. */
+export declare const tableElabelAttachment: DataTableData;
+export declare const tableEmpty: DataTableData;
+/** A file name that fills the card: it wraps inside its cell, and a table wider than the card scrolls inside the card. */
+export declare const tableLongText: DataTableData;
+/** A masked column, a masked cell in an open column, and a plain value the server forgot to mask. */
+export declare const tableMasked: DataTableData;
+/** Paths the story and test hosts accept. */
+export declare const allowFixtureLink: (path: string) => boolean;
+/** A host tool catalog for stories and tests. Tiers, titles and target kinds live HERE, never on a card. */
+export declare const fixtureCatalog: {
+    readonly counter_received_offer: {
+        readonly name: "counter_received_offer";
+        readonly title: "Counter the received offer";
+        readonly tier: "reversible";
+        readonly inputSchema: z.ZodObject<{
+            offerId: z.ZodString;
+            price: z.ZodOptional<z.ZodString>;
+            paymentTerms: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        readonly targetArg: "offerId";
+        readonly targetKind: "offer";
+        readonly argsFromChanges: (changes: {
+            path: string;
+            after: unknown;
+        }[], id: string) => {
+            [x: string]: unknown;
+        };
+    };
+    readonly update_variant: {
+        readonly name: "update_variant";
+        readonly title: "Update product version";
+        readonly tier: "reversible";
+        readonly inputSchema: z.ZodObject<{
+            variantId: z.ZodString;
+            abv: z.ZodOptional<z.ZodString>;
+            productionVolume: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>;
+        readonly targetArg: "variantId";
+        readonly targetKind: "variant";
+        readonly argsFromChanges: (changes: {
+            path: string;
+            after: unknown;
+        }[], id: string) => {
+            [x: string]: unknown;
+        };
+    };
+    readonly mark_match_interested: {
+        readonly name: "mark_match_interested";
+        readonly title: "Mark the match as interested";
+        readonly tier: "reversible";
+        readonly inputSchema: z.ZodObject<{
+            matchId: z.ZodString;
+        }, z.core.$strip>;
+        readonly targetArg: "matchId";
+        readonly targetKind: "match";
+    };
+    readonly discard_offer: {
+        readonly name: "discard_offer";
+        readonly title: "Discard the offer";
+        readonly tier: "destructive";
+        readonly inputSchema: z.ZodObject<{
+            offerId: z.ZodString;
+        }, z.core.$strip>;
+        readonly targetArg: "offerId";
+        readonly targetKind: "offer";
+    };
+    readonly delete_product: {
+        readonly name: "delete_product";
+        readonly title: "Delete the product";
+        readonly tier: "destructive";
+        readonly inputSchema: z.ZodObject<{
+            productId: z.ZodString;
+        }, z.core.$strip>;
+        readonly targetArg: "productId";
+        readonly targetKind: "product";
+    };
+    readonly get_offer: {
+        readonly name: "get_offer";
+        readonly title: "Read an offer";
+        readonly tier: "read";
+        readonly inputSchema: z.ZodObject<{
+            offerId: z.ZodString;
+        }, z.core.$strip>;
+    };
+};
+/** The records a story host would fetch for a proposal's Apply, keyed `kind:id`. */
+export declare const fixtureRecords: Record<string, unknown>;
+export declare const fixtureFetchRecord: (kind: string, id: string) => Promise<unknown>;
+//# sourceMappingURL=fixtures.d.ts.map

package/dist/agent/role-cards/fixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixtures.d.ts","sourceRoot":"","sources":["../../../src/agent/role-cards/fixtures.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EACV,aAAa,EACb,aAAa,EACb,aAAa,EACb,mBAAmB,EACnB,eAAe,EAChB,MAAM,8BAA8B,CAAC;AAKtC,eAAO,MAAM,SAAS,EAAE,aAqCvB,CAAC;AACF,eAAO,MAAM,YAAY,EAAE,aAAmD,CAAC;AAC/E,eAAO,MAAM,WAAW,EAAE,aAMzB,CAAC;AACF,eAAO,MAAM,aAAa,EAAE,aAK3B,CAAC;AACF,eAAO,MAAM,aAAa,EAAE,aAK3B,CAAC;AACF,eAAO,MAAM,aAAa,EAAE,aAM3B,CAAC;AACF,eAAO,MAAM,aAAa,EAAE,aAa3B,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,eAgCzB,CAAC;AACF,eAAO,MAAM,YAAY,EAAE,eAK1B,CAAC;AACF,eAAO,MAAM,cAAc,EAAE,eAAmC,CAAC;AACjE,eAAO,MAAM,eAAe,EAAE,eAa7B,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,mBAuB7B,CAAC;AACF,eAAO,MAAM,kBAAkB,EAAE,mBAMhC,CAAC;AACF,eAAO,MAAM,kBAAkB,EAAE,mBAAwC,CAAC;AAE1E,eAAO,MAAM,WAAW,EAAE,aA6BzB,CAAC;AACF,eAAO,MAAM,SAAS,EAAE,aAMvB,CAAC;AACF,eAAO,MAAM,QAAQ,EAAE,aAKtB,CAAC;AACF,eAAO,MAAM,aAAa,EAAE,aAI3B,CAAC;AACF,eAAO,MAAM,WAAW,EAAE,aAIzB,CAAC;AACF,eAAO,MAAM,YAAY,EAAE,aAA4C,CAAC;AAexE,mHAAmH;AACnH,eAAO,MAAM,cAAc,EAAE,aAI5B,CAAC;AACF,4FAA4F;AAC5F,eAAO,MAAM,gBAAgB,EAAE,aAI9B,CAAC;AACF,sHAAsH;AACtH,eAAO,MAAM,wBAAwB,EAAE,aAItC,CAAC;AACF,4GAA4G;AAC5G,eAAO,MAAM,eAAe,EAAE,aAI7B,CAAC;AACF,+HAA+H;AAC/H,eAAO,MAAM,sBAAsB,EAAE,aASpC,CAAC;AACF,8HAA8H;AAC9H,eAAO,MAAM,qBAAqB,EAAE,aAmBnC,CAAC;AACF,8FAA8F;AAC9F,eAAO,MAAM,qBAAqB,EAAE,aAInC,CAAC;AACF,eAAO,MAAM,UAAU,EAAE,aAIxB,CAAC;AACF,0HAA0H;AAC1H,eAAO,MAAM,aAAa,EAAE,aAW3B,CAAC;AACF,qGAAqG;AACrG,eAAO,MAAM,WAAW,EAAE,aAczB,CAAC;AAEF,6CAA6C;AAC7C,eAAO,MAAM,gBAAgB,GAAI,MAAM,MAAM,KAAG,OACgB,CAAC;AAWjE,4GAA4G;AAC5G,eAAO,MAAM,cAAc;;;;;;;;;;;;4CAYI;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,OAAO,CAAA;SAAE,EAAE,MAAM,MAAM;;;;;;;;;;;;;;;4CAc9C;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,OAAO,CAAA;SAAE,EAAE,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiCnE,CAAC;AAEX,oFAAoF;AACpF,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAMlD,CAAC;AACF,eAAO,MAAM,kBAAkB,GAAU,MAAM,MAAM,EAAE,IAAI,MAAM,KAAG,OAAO,CAAC,OAAO,CAC1C,CAAC"}