@cellarnode/ui 0.201.0 → 0.202.0

package/dist/agent/role-cards/card-kit.d.ts

@@ -0,0 +1,111 @@
+import { type ReactNode } from "react";
+import type { CardAction, CardDetail, CardProposal } from "@cellarnode/agent-cards/zod4";
+import { type MaskedValueCopy } from "../masked-value.js";
+import { type CellValue } from "../schema.js";
+import { type Tone } from "../ui.js";
+import { subjectOf, type AgentToolCatalog, type BuildConfirmFailure, type CardConfirmPlan, type DetailKind, type ProposalApplyPlan } from "./host-contract.js";
+import { type AgentProposalDiffCopy } from "./proposal-diff.js";
+/**
+ * @internal Shared kit for the role-agent result cards (CEL-2445): frame, field grid, chip, actions, detail pointer.
+ * Pure props in, events out. Cards never fetch, never run a tool and never build a link from model text: a link renders
+ * only when the host's `allowLink` accepts the path, otherwise the label is plain text.
+ */
+export interface AgentCardLinkProps {
+    /** The host's route allowlist. With no `allowLink` NO link renders (secure default). */
+    allowLink?: (path: string) => boolean;
+    /** How the host renders an accepted internal link (router `<Link>`); defaults to a plain anchor. */
+    renderLink?: (path: string, children: ReactNode, className: string) => ReactNode;
+}
+export declare function AgentCardLink({ path, allowLink, renderLink, className, children, }: AgentCardLinkProps & {
+    path: string | undefined;
+    className?: string;
+    children: ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function AgentCardFrame({ title, eyebrow, badge, children, footer, className, }: {
+    title: ReactNode;
+    /** A small kind label above the title ("Offer") when the title is the record's own name. */
+    eyebrow?: ReactNode;
+    badge?: ReactNode;
+    children: ReactNode;
+    footer?: ReactNode;
+    className?: string;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function AgentChip({ tone, className, children, }: {
+    tone?: Tone;
+    className?: string;
+    children: ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function AgentFieldGrid({ children }: {
+    children: ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+/** One labelled value. Renders nothing for an absent field, so a sparse card stays compact. A masked cell renders as masked and takes a full row (the mask pill does not wrap, so it never spills into its neighbour at 320px). */
+export declare function AgentField({ label, value, wide, maskedCopy, }: {
+    label: string;
+    value: CellValue | undefined;
+    wide?: boolean;
+    /** The mask pill's strings, in the host's language. */
+    maskedCopy?: Partial<MaskedValueCopy>;
+}): import("react/jsx-runtime").JSX.Element | null;
+export interface AgentCardActionsCopy {
+    needsConfirm: string;
+    openDetail: string;
+}
+export declare const ACTIONS_COPY: AgentCardActionsCopy;
+/**
+ * What every role card needs from its host. The host owns the catalog, the record fetch and what happens after a confirm
+ * plan exists; the card owns nothing that writes.
+ */
+export interface AgentRoleCardHostProps extends AgentCardLinkProps {
+    /** The mask pill's strings (its accessible name and tooltip), in the host's language. Every masked value on the card uses them. */
+    maskedCopy?: Partial<MaskedValueCopy>;
+    /** The host's tool catalog. Without it no tool action and no proposal can be used. */
+    catalog?: AgentToolCatalog;
+    /** Fetch the full record for a proposal's Apply (the host's own authenticated read). */
+    fetchRecord?: (kind: DetailKind, id: string) => Promise<unknown>;
+    /** Called ONLY with a successful confirm plan built from the catalog; never with the raw model action. */
+    onAction?: (result: {
+        action: CardAction;
+        plan: CardConfirmPlan;
+    }) => void;
+    /** Called when a clicked action could not be turned into a plan (the catalog changed under it, or the args no longer validate). */
+    onActionRefused?: (action: CardAction, reason: BuildConfirmFailure) => void;
+    /**
+     * Open the inspector drawer / canvas for the record the pointer names; the host fetches the record itself. `opener` is the button
+     * that was pressed: hand it back to the drawer's `returnFocus` so focus returns to it on close even where the browser did not
+     * focus the button on click (Safari) or the card re-rendered in between.
+     */
+    onOpenDetail?: (detail: CardDetail, opener?: HTMLElement) => void;
+    /** Called ONLY with the `planProposalApply` result; never with the raw proposal. */
+    onApplyProposal?: (result: ProposalApplyPlan) => void;
+    /**
+     * Edit before applying. The edited proposal is a NEW claim: saving it MUST go back through `planProposalApply` (re-fetch, stale
+     * check, subject and targetKind binding, input schema) and the confirm flow, exactly like the original. Never apply an edited
+     * proposal directly.
+     */
+    onEditProposal?: (proposal: CardProposal) => void;
+    onRejectProposal?: (proposal: CardProposal) => void;
+    proposalCopy?: Partial<AgentProposalDiffCopy>;
+}
+export interface AgentCardActionsProps extends AgentCardLinkProps {
+    actions?: CardAction[];
+    detail?: CardDetail;
+    catalog?: AgentToolCatalog;
+    onAction?: AgentRoleCardHostProps["onAction"];
+    onActionRefused?: AgentRoleCardHostProps["onActionRefused"];
+    onOpenDetail?: AgentRoleCardHostProps["onOpenDetail"];
+    copy?: Partial<AgentCardActionsCopy>;
+}
+export declare function AgentCardActions({ actions, detail, catalog, onAction, onActionRefused, onOpenDetail, allowLink, renderLink, copy, }: AgentCardActionsProps): import("react/jsx-runtime").JSX.Element | null;
+/** The proposal diff and the action row every role card ends with, wired to the host contract. */
+export declare function AgentCardExtras({ data, subject, host, }: {
+    data: {
+        actions?: CardAction[];
+        detail?: CardDetail;
+        proposal?: CardProposal;
+    };
+    /** The record THIS card is about; a proposal for any other record is refused at Apply. */
+    subject: Pick<CardDetail, "kind" | "id"> | undefined;
+    host: AgentRoleCardHostProps;
+}): import("react/jsx-runtime").JSX.Element;
+export { subjectOf };
+//# sourceMappingURL=card-kit.d.ts.map

package/dist/agent/role-cards/card-kit.d.ts.map

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

package/dist/agent/role-cards/card-kit.js

@@ -0,0 +1,68 @@
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useId } from "react";
+import { cn } from "../../lib/utils.js";
+import { fmt, useCopy } from "../copy.js";
+import { MaskedValue } from "../masked-value.js";
+import { isMasked } from "../schema.js";
+import { agentButton, bezel, toneChip } from "../ui.js";
+import { buildConfirm, offeredActions, subjectOf, } from "./host-contract.js";
+import { AgentProposalDiff } from "./proposal-diff.js";
+export function AgentCardLink({ path, allowLink, renderLink, className, children, }) {
+    const cls = cn("rounded-sm underline-offset-2 hover:underline pointer-coarse:inline-flex pointer-coarse:min-h-11 pointer-coarse:items-center focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-ring", className);
+    if (!path || !allowLink?.(path))
+        return _jsx(_Fragment, { children: children });
+    if (renderLink)
+        return _jsx(_Fragment, { children: renderLink(path, children, cls) });
+    return (_jsx("a", { href: path, className: cls, children: children }));
+}
+export function AgentCardFrame({ title, eyebrow, badge, children, footer, className, }) {
+    const id = useId();
+    return (_jsxs("section", { "aria-labelledby": id, className: cn("@container flex flex-col gap-3 p-4 text-sm/5 text-foreground", bezel, className), children: [_jsxs("header", { className: "flex flex-wrap items-center justify-between gap-2", children: [_jsxs("div", { className: "flex min-w-0 flex-col gap-0.5", children: [eyebrow && _jsx("p", { className: "text-xs/4 text-muted-foreground", children: eyebrow }), _jsx("h3", { id: id, className: "min-w-0 text-sm/5 font-semibold text-balance", children: title })] }), badge] }), children, footer] }));
+}
+export function AgentChip({ tone = "neutral", className, children, }) {
+    return (_jsx("span", { className: cn("inline-flex items-center rounded-full px-2.5 py-0.5 text-xs/4 font-medium", toneChip[tone], className), children: children }));
+}
+export function AgentFieldGrid({ children }) {
+    return _jsx("dl", { className: "grid grid-cols-2 gap-x-4 gap-y-2 @sm:grid-cols-3", children: children });
+}
+/** One labelled value. Renders nothing for an absent field, so a sparse card stays compact. A masked cell renders as masked and takes a full row (the mask pill does not wrap, so it never spills into its neighbour at 320px). */
+export function AgentField({ label, value, wide, maskedCopy, }) {
+    if (value === undefined || value === null || value === "")
+        return null;
+    return (_jsxs("div", { className: cn("flex min-w-0 flex-col gap-0.5", (wide || isMasked(value)) && "col-span-2 @sm:col-span-3"), children: [_jsx("dt", { className: "text-xs/4 text-muted-foreground", children: label }), _jsx("dd", { className: "min-w-0 text-sm/5 break-words", children: _jsx(MaskedValue, { value: value, copy: maskedCopy }) })] }));
+}
+export const ACTIONS_COPY = {
+    needsConfirm: "Asks you to confirm",
+    openDetail: "Open full details",
+};
+export function AgentCardActions({ actions, detail, catalog, onAction, onActionRefused, onOpenDetail, allowLink, renderLink, copy, }) {
+    const c = useCopy(ACTIONS_COPY, copy);
+    // Rules 1 to 3: only what the catalog accepts, labelled and tiered by the catalog.
+    const visible = offeredActions(actions, catalog, { canRunTools: !!onAction, allowLink });
+    const showDetail = detail !== undefined && onOpenDetail !== undefined;
+    if (visible.length === 0 && !showDetail)
+        return null;
+    return (_jsxs("div", { className: "flex flex-wrap items-center gap-2 border-t border-border/60 pt-3", children: [showDetail && (_jsx("button", { type: "button", className: agentButton.quiet, onClick: (event) => onOpenDetail(detail, event.currentTarget), children: c.openDetail })), visible.map((a) => {
+                const gated = a.tier === "destructive" || a.tier === "costly";
+                const cls = gated ? agentButton.danger : agentButton.quiet;
+                const hint = gated
+                    ? fmt("{label}. {hint}", { label: a.label, hint: c.needsConfirm })
+                    : a.label;
+                if (a.tool && onAction) {
+                    return (_jsx("button", { type: "button", className: cls, "aria-label": hint, onClick: () => {
+                            const built = buildConfirm(a, catalog ?? {});
+                            if (built.ok)
+                                onAction({ action: a, plan: built.plan });
+                            else
+                                onActionRefused?.(a, built.reason);
+                        }, children: a.label }, a.id));
+                }
+                return (_jsx(AgentCardLink, { path: a.href, allowLink: allowLink, renderLink: renderLink, className: cls, children: a.label }, a.id));
+            })] }));
+}
+/** The proposal diff and the action row every role card ends with, wired to the host contract. */
+export function AgentCardExtras({ data, subject, host, }) {
+    return (_jsxs(_Fragment, { children: [data.proposal && (_jsx(AgentProposalDiff, { proposal: data.proposal, catalog: host.catalog, fetchRecord: host.fetchRecord, expected: subject, onApply: host.onApplyProposal, onEdit: host.onEditProposal, onReject: host.onRejectProposal, copy: host.proposalCopy })), _jsx(AgentCardActions, { actions: data.actions, detail: data.detail, catalog: host.catalog, onAction: host.onAction, onActionRefused: host.onActionRefused, onOpenDetail: host.onOpenDetail, allowLink: host.allowLink, renderLink: host.renderLink })] }));
+}
+export { subjectOf };
+//# sourceMappingURL=card-kit.js.map

package/dist/agent/role-cards/card-kit.js.map

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

package/dist/agent/role-cards/data-table-card.d.ts

@@ -0,0 +1,80 @@
+import type { DataTableData } from "@cellarnode/agent-cards/zod4";
+import { type AgentRoleCardHostProps } from "./card-kit.js";
+export interface AgentDataTableCardCopy {
+    title: string;
+    /** The table's name for a screen reader. */
+    caption: string;
+    /** What the card says when there are no rows. */
+    empty: string;
+    /** What a cell with nothing in it shows. */
+    emptyCell: string;
+    /** `{shown}` rows are drawn out of `{total}`. */
+    capped: string;
+    /** A column whose label is empty once cleaned: `{n}` is its position. */
+    column: string;
+    yes: string;
+    no: string;
+    /** What a plain value in a column the server marked masked is replaced with. */
+    hidden: string;
+    /** How text written by someone else is set off: `{text}` is the text. */
+    quote: string;
+    /** The name of the card's deep link, by the kind of page it opens (the link's text, so it reads on its own). */
+    openOffer: string;
+    openProducer: string;
+    openOrganisation: string;
+    openPortfolio: string;
+    openProduct: string;
+    openProductGallery: string;
+    openLabels: string;
+    openImports: string;
+    openElabelHome: string;
+    /** Any other page of the e-label app. */
+    openElabel: string;
+    /** A link to a route the host added itself. */
+    openOther: string;
+}
+/**
+ * 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 declare const DEFAULT_THIRD_PARTY_COLUMNS: readonly string[];
+/** 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 declare const MAX_AGENT_TABLE_ROWS = 100;
+export interface AgentDataTableCardProps extends AgentRoleCardHostProps {
+    data: DataTableData;
+    copy?: Partial<AgentDataTableCardCopy>;
+    /** More column keys whose text someone else wrote, on top of `DEFAULT_THIRD_PARTY_COLUMNS`. Matched on the column's `key`. */
+    thirdPartyColumns?: readonly string[];
+    /** The host's own label for a column, by its `key`. It wins over the label the agent sent (which is in the agent's language). */
+    columnLabels?: Readonly<Record<string, string>>;
+    /**
+     * The host's display text for a cell (a date, a currency, a number in the viewer's locale), or `undefined` for the default. Never
+     * called for a mask, an empty cell or a plain value in a masked column. Text from a column quoted as third-party stays quoted. A
+     * hook that throws is skipped: it cannot take the card down.
+     */
+    formatCell?: (key: string, value: string | number | boolean) => string | undefined;
+    /**
+     * A BCP 47 tag for the numbers in cells. Set, a number shows with that locale's decimal separator and never grouped (a year or an
+     * id stays `2022`); unset, a number shows as JavaScript spells it. Use `formatCell` for grouping or a currency.
+     */
+    locale?: string;
+}
+/**
+ * @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 declare function AgentDataTableCard({ data, copy, thirdPartyColumns, columnLabels, formatCell, locale, ...host }: AgentDataTableCardProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=data-table-card.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"data-table-card.d.ts","sourceRoot":"","sources":["../../../src/agent/role-cards/data-table-card.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAMlE,OAAO,EAIL,KAAK,sBAAsB,EAC5B,MAAM,YAAY,CAAC;AAIpB,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,yEAAyE;IACzE,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,gFAAgF;IAChF,MAAM,EAAE,MAAM,CAAC;IACf,yEAAyE;IACzE,KAAK,EAAE,MAAM,CAAC;IACd,gHAAgH;IAChH,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAC;CACnB;AAsCD;;;;;;GAMG;AACH,eAAO,MAAM,2BAA2B,EAAE,SAAS,MAAM,EAQxD,CAAC;AAEF,2HAA2H;AAC3H,eAAO,MAAM,oBAAoB,MAAM,CAAC;AAMxC,MAAM,WAAW,uBAAwB,SAAQ,sBAAsB;IACrE,IAAI,EAAE,aAAa,CAAC;IACpB,IAAI,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACvC,8HAA8H;IAC9H,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,iIAAiI;IACjI,YAAY,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAChD;;;;OAIG;IACH,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,KAAK,MAAM,GAAG,SAAS,CAAC;IACnF;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAgID;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,IAAI,EACJ,IAAI,EACJ,iBAAiB,EACjB,YAAY,EACZ,UAAU,EACV,MAAM,EACN,GAAG,IAAI,EACR,EAAE,uBAAuB,2CAyGzB"}

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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"}