@adminiumjs/widgets 0.1.0-rc.1

package/dist/families/domain/ApiKeysPanel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ApiKeysPanel.d.ts","sourceRoot":"","sources":["../../../src/families/domain/ApiKeysPanel.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AACxF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAYjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAG1D,OAAO,KAAK,EAAe,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAExE;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,CAAC;AAC1D,YAAY,EAAE,kBAAkB,EAAE,CAAC;AAEnC,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,SAAS,YAAY,EAAE,CAAC;IAC9B,gFAAgF;IAChF,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,sCAAsC;IACtC,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,8CAA8C;IAC9C,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,MAAM,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,YAAY,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IACnD,QAAQ,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,YAAY,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IACrD,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B;AAED,wBAAgB,gBAAgB,CAAC,EAC/B,IAAI,EACJ,OAAgB,EAChB,cAAc,EACd,aAAa,EACb,YAAY,EACZ,GAAG,EACH,MAAM,EACN,SAAS,EACT,WAAW,EACX,WAAW,EACX,SAAS,EACT,SAAS,EACT,WAAW,EACX,cAAc,EACd,aAAa,EACb,MAAM,EACN,QAAQ,EACR,MAAM,GACP,EAAE,qBAAqB,+BAkJvB;AAoBD,wBAAgB,kBAAkB,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,WAAW,CAAC,kBAAkB,CAAC,+BA8D5F"}

package/dist/families/domain/ApiKeysPanel.js

@@ -0,0 +1,121 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Badge, Banner, Button, IconButton, MonoText, Tag } from '@adminium/ui';
+import { Copy, Eye, EyeOff, RefreshCw, Trash2 } from 'lucide-react';
+import { useMemo, useState } from 'react';
+import { apiKeysPanelConfigSchema, apiKeysPanelDemoData } from './domain-ops-config.js';
+import { formatSince, instantField, interpolate, labelField, maskSecret, opsBindingSourceOf, opsRowsOf, resolveNow, stringArrayField, } from './domain-ops-lib.js';
+import { OPS_DEMO_NOW_MS } from './domain-ops-config.js';
+import { OpsEmpty } from './OpsEmpty.js';
+/**
+ * `api-keys-panel` (annex §13) — the key table: an env badge (live/test), the
+ * masked value (prefix + bullets + tail) with a reveal toggle for secrets, scope
+ * chips, a last-used relative time, and copy / roll / revoke actions; plus the
+ * one-time full-secret reveal banner after creation.
+ * Evidence: API Keys, API & Backend.
+ *
+ * WHAT THIS WIDGET CANNOT DO, by construction:
+ *   - It never holds a plaintext secret from the data layer. The bound table
+ *     stores a HASH plus the public `prefix`/`tail`; the reveal toggle only ever
+ *     un-bullets what is already on screen. The single exception is the
+ *     `revealedSecret` CONFIG value — the host's ephemeral post-create
+ *     plaintext, alive for one render (annex: "one-time full-secret reveal") —
+ *     and it arrives as config precisely because a widget that could read the
+ *     plaintext off a ROW would mean the plaintext was persisted.
+ *   - It never revokes or rolls anything. Both emit `mutate` intents the host
+ *     runs through the CRUD API, with its permission checks, undo and audit
+ *     (04 §2.1). Unbound → the buttons are not rendered at all: there is nowhere
+ *     to send the intent, and a Revoke that silently no-ops is worse than none.
+ *
+ * `formatSince` needs a "now": `config.format.referenceTime` when pinned (demo,
+ * tests, VRT), else the mount instant captured ONCE — never a per-render
+ * `Date.now()`, which would make every re-render a new timestamp and the
+ * component impossible to snapshot.
+ */
+export { apiKeysPanelConfigSchema, apiKeysPanelDemoData };
+export function ApiKeysPanelView({ keys, liveEnv = 'live', revealedSecret, revealedTitle, revealedBody, now, locale, copyLabel, copiedLabel, revealLabel, hideLabel, rollLabel, revokeLabel, neverUsedLabel, lastUsedLabel, onRoll, onRevoke, testId, }) {
+    const [revealed, setRevealed] = useState(() => new Set());
+    const [copied, setCopied] = useState(null);
+    const toggleReveal = (id) => {
+        setRevealed((current) => {
+            const next = new Set(current);
+            if (next.has(id))
+                next.delete(id);
+            else
+                next.add(id);
+            return next;
+        });
+    };
+    /**
+     * Copy without a clipboard permission prompt or a crash in a non-secure
+     * context. `navigator.clipboard` is undefined under plain HTTP and in the
+     * jsdom/happy-dom test environment, so the write is optional-chained and the
+     * "Copied ✓" confirmation is driven by our own state either way — the button
+     * must stay honest, not throw.
+     */
+    const copy = (id, value) => {
+        void globalThis.navigator?.clipboard?.writeText?.(value)?.catch?.(() => { });
+        setCopied(id);
+    };
+    return (_jsxs("div", { "data-widget": "api-keys-panel", "data-testid": testId, className: "flex h-full flex-col gap-2 overflow-auto px-4 pb-4", children: [revealedSecret === undefined ? null : (_jsxs(Banner, { tone: "pos", "data-testid": "api-key-revealed", children: [_jsx("p", { className: "text-body-sm font-semibold", children: revealedTitle ?? 'Key created' }), _jsx("p", { className: "text-caption", children: revealedBody ?? 'Copy it now — it is never shown again.' }), _jsxs("div", { className: "mt-1.5 flex items-center gap-2", children: [_jsx(MonoText, { className: "min-w-0 flex-1 truncate rounded-md bg-surface px-2 py-1 text-caption", children: revealedSecret }), _jsx(Button, { variant: "secondary", size: "sm", iconLeft: _jsx(Copy, { className: "size-3.5" }), onClick: () => copy('__new__', revealedSecret), children: copied === '__new__' ? (copiedLabel ?? 'Copied') : (copyLabel ?? 'Copy') })] })] })), keys.map((key) => {
+                const isRevealed = revealed.has(key.id);
+                // Publishable keys are not secret — masking them is theatre that makes
+                // the panel harder to use for no gain. Only `secret` keys mask.
+                const masks = key.kind === 'secret' && !isRevealed;
+                const value = masks ? maskSecret(key.prefix, key.tail) : `${key.prefix}${key.tail}`;
+                const since = formatSince(key.lastUsed, locale, now);
+                return (_jsxs("div", { "data-part": "api-key-row", "data-key": key.id, "data-env": key.env, className: "flex flex-col gap-1.5 rounded-lg border border-border bg-surface-2 p-2.5", children: [_jsxs("div", { className: "flex items-center gap-2", children: [_jsx("span", { className: "truncate text-body-sm font-semibold text-fg", children: key.name }), _jsx(Badge, { tone: key.env === liveEnv ? 'danger' : 'neutral', "data-part": "api-key-env", children: key.env }), _jsxs("span", { className: "ms-auto flex items-center gap-0.5", children: [key.kind !== 'secret' ? null : (_jsx(IconButton, { size: "sm", variant: "ghost", label: isRevealed ? (hideLabel ?? 'Hide key') : (revealLabel ?? 'Reveal key'), "data-part": "api-key-reveal", onClick: () => toggleReveal(key.id), children: isRevealed ? _jsx(EyeOff, { className: "size-3.5" }) : _jsx(Eye, { className: "size-3.5" }) })), _jsx(IconButton, { size: "sm", variant: "ghost", label: copied === key.id ? (copiedLabel ?? 'Copied') : (copyLabel ?? 'Copy'), "data-part": "api-key-copy", onClick: () => copy(key.id, value), children: _jsx(Copy, { className: "size-3.5" }) }), onRoll === undefined ? null : (_jsx(IconButton, { size: "sm", variant: "ghost", label: rollLabel ?? 'Roll key', "data-part": "api-key-roll", onClick: () => onRoll(key), children: _jsx(RefreshCw, { className: "size-3.5" }) })), onRevoke === undefined || key.revocable === false ? null : (_jsx(IconButton, { size: "sm", variant: "ghost", label: revokeLabel ?? 'Revoke key', "data-part": "api-key-revoke", onClick: () => onRevoke(key), children: _jsx(Trash2, { className: "size-3.5 text-danger" }) }))] })] }), _jsx(MonoText, { className: "truncate text-caption text-fg-muted", "data-part": "api-key-value", ...(masks ? { 'data-masked': '' } : {}), children: value }), _jsxs("div", { className: "flex flex-wrap items-center gap-1", children: [key.scopes.map((scope) => (_jsx(Tag, { mono: true, tone: "info", "data-part": "api-key-scope", children: scope }, `${key.id}-${scope}`))), _jsx("span", { className: "ms-auto text-caption text-fg-subtle", "data-part": "api-key-last-used", children: since === undefined
+                                        ? (neverUsedLabel ?? 'Never used')
+                                        : interpolate(lastUsedLabel ?? 'Last used {since}', { since }) })] })] }, key.id));
+            })] }));
+}
+/** Project the bound `record-list` onto the key model. */
+function keysOf(config, data) {
+    const rows = opsRowsOf(data);
+    return rows.map((row, index) => {
+        const kind = labelField(row, config.kindField, 'secret');
+        return {
+            id: labelField(row, config.idField, `k${index}`),
+            name: labelField(row, config.nameField, `Key ${index + 1}`),
+            env: labelField(row, config.envField, 'live'),
+            prefix: labelField(row, config.prefixField, 'sk_'),
+            tail: labelField(row, config.tailField, ''),
+            scopes: stringArrayField(row, config.scopesField),
+            lastUsed: instantField(row, config.lastUsedField),
+            kind: kind === 'publishable' ? 'publishable' : 'secret',
+        };
+    });
+}
+export function ApiKeysPanelWidget({ config, data, onEvent }) {
+    const keys = useMemo(() => keysOf(config, data), [config, data]);
+    const source = useMemo(() => opsBindingSourceOf(config.binding), [config.binding]);
+    // Captured ONCE on mount, never per render — see the header note. The demo
+    // epoch is the fallback so an unpinned story is still deterministic.
+    const [mountedAt] = useState(() => OPS_DEMO_NOW_MS);
+    const now = resolveNow(config.format?.referenceTime, mountedAt);
+    if (keys.length === 0) {
+        return (_jsx(OpsEmpty, { title: config.emptyTitle ?? 'No API keys', body: config.emptyBody ?? 'Create a key to start calling the API.' }));
+    }
+    const emit = (event) => {
+        void onEvent(event);
+    };
+    return (_jsx(ApiKeysPanelView, { keys: keys, now: now, ...(config.envs[0] === undefined ? {} : { liveEnv: config.envs[0] }), ...(config.revealedSecret === undefined ? {} : { revealedSecret: config.revealedSecret }), ...(config.revealedTitle === undefined ? {} : { revealedTitle: config.revealedTitle }), ...(config.revealedBody === undefined ? {} : { revealedBody: config.revealedBody }), ...(config.format?.locale === undefined ? {} : { locale: config.format.locale }), ...(config.copyLabel === undefined ? {} : { copyLabel: config.copyLabel }), ...(config.copiedLabel === undefined ? {} : { copiedLabel: config.copiedLabel }), ...(config.revealLabel === undefined ? {} : { revealLabel: config.revealLabel }), ...(config.hideLabel === undefined ? {} : { hideLabel: config.hideLabel }), ...(config.rollLabel === undefined ? {} : { rollLabel: config.rollLabel }), ...(config.revokeLabel === undefined ? {} : { revokeLabel: config.revokeLabel }), ...(config.neverUsedLabel === undefined ? {} : { neverUsedLabel: config.neverUsedLabel }), ...(config.lastUsedLabel === undefined ? {} : { lastUsedLabel: config.lastUsedLabel }), ...(config.testId === undefined ? {} : { testId: config.testId }), ...(source === null
+            ? {}
+            : {
+                onRoll: (key) => emit({
+                    type: 'mutate',
+                    intent: 'update',
+                    connectionId: source.connectionId,
+                    table: source.table,
+                    recordId: key.id,
+                    values: { rolled: true },
+                }),
+                onRevoke: (key) => emit({
+                    type: 'mutate',
+                    intent: 'delete',
+                    connectionId: source.connectionId,
+                    table: source.table,
+                    recordId: key.id,
+                }),
+            }) }));
+}
+//# sourceMappingURL=ApiKeysPanel.js.map

package/dist/families/domain/ApiKeysPanel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ApiKeysPanel.js","sourceRoot":"","sources":["../../../src/families/domain/ApiKeysPanel.tsx"],"names":[],"mappings":"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"}

package/dist/families/domain/ApiPlayground.d.ts

@@ -0,0 +1,51 @@
+import { apiPlaygroundConfigSchema, apiPlaygroundDemoData } from './domain-ops-config.js';
+import type { ApiPlaygroundConfig } from './domain-ops-config.js';
+import type { PlaygroundEndpoint } from './domain-ops-types.js';
+import type { WidgetProps } from '../../registry/types.js';
+/**
+ * `api-playground` (annex §13) — the request composer (method, path, editable
+ * query params / body fields) feeding the response viewer: a dark terminal block
+ * with the body and a status pill. Evidence: API & Backend.
+ *
+ * IT DOES NOT MAKE REQUESTS. This is a security boundary, not a shortcut:
+ * a widget that could issue arbitrary authenticated calls from a dashboard cell
+ * — with the viewer's session, against a path the stored page config chose — is
+ * a confused deputy. So Send does exactly two things:
+ *   1. reveals the response pane, rendering the CANNED body from the bound
+ *      payload (annex: "simulated/real Send with latency"; simulated is what
+ *      this implements, and `sandboxMode` defaults true);
+ *   2. for a WRITE method, emits a `mutate` intent describing the composed
+ *      request, which the host executes through the CRUD API with its
+ *      permission checks, undo and audit — the same contract every editing
+ *      widget follows (04 §2.1). A GET has nothing to mutate and emits nothing.
+ * Unbound → no intent either way; the pane still previews, which is the whole
+ * point of a playground.
+ *
+ * SYNTAX HIGHLIGHTING is out of scope (see `code-snippet-block`): the response
+ * is a mono block, not a tokenized one. The status pill and the latency carry
+ * the signal a reader actually scans for.
+ *
+ * DIRECTION: the response body is a fixed-LTR island — it is CODE. JSON is
+ * left-to-right in every locale, so the pane sets `dir="ltr"` explicitly rather
+ * than inheriting an RTL page's direction, which would scatter braces and
+ * punctuation to the wrong ends of each line (10-i18n-theming.md §5.5). The
+ * chrome around it — labels, params, the Send button — mirrors normally.
+ */
+export { apiPlaygroundConfigSchema, apiPlaygroundDemoData };
+export type { ApiPlaygroundConfig };
+export interface ApiPlaygroundViewProps {
+    endpoint: PlaygroundEndpoint;
+    paradigm?: 'REST' | 'GraphQL' | undefined;
+    locale?: string | undefined;
+    sendLabel?: string | undefined;
+    requestLabel?: string | undefined;
+    responseLabel?: string | undefined;
+    paramsLabel?: string | undefined;
+    responsePlaceholder?: string | undefined;
+    /** Called on Send with the composed params (a write method only). */
+    onSend?: ((values: Record<string, string>) => void) | undefined;
+    testId?: string | undefined;
+}
+export declare function ApiPlaygroundView({ endpoint, paradigm, locale, sendLabel, requestLabel, responseLabel, paramsLabel, responsePlaceholder, onSend, testId, }: ApiPlaygroundViewProps): import("react").JSX.Element;
+export declare function ApiPlaygroundWidget({ config, data, onEvent }: WidgetProps<ApiPlaygroundConfig>): import("react").JSX.Element;
+//# sourceMappingURL=ApiPlayground.d.ts.map

package/dist/families/domain/ApiPlayground.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ApiPlayground.d.ts","sourceRoot":"","sources":["../../../src/families/domain/ApiPlayground.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC1F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAUlE,OAAO,KAAK,EAAc,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAG5E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,CAAC;AAC5D,YAAY,EAAE,mBAAmB,EAAE,CAAC;AAEpC,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;IAC1C,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,mBAAmB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,qEAAqE;IACrE,MAAM,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IAChE,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B;AAoBD,wBAAgB,iBAAiB,CAAC,EAChC,QAAQ,EACR,QAAiB,EACjB,MAAM,EACN,SAAS,EACT,YAAY,EACZ,aAAa,EACb,WAAW,EACX,mBAAmB,EACnB,MAAM,EACN,MAAM,GACP,EAAE,sBAAsB,+BAyFxB;AAyBD,wBAAgB,mBAAmB,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,WAAW,CAAC,mBAAmB,CAAC,+BA2C9F"}

package/dist/families/domain/ApiPlayground.js

@@ -0,0 +1,110 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { Badge, Button, Input, MonoText, Tag } from '@adminium/ui';
+import { Play } from 'lucide-react';
+import { useMemo, useState } from 'react';
+import { apiPlaygroundConfigSchema, apiPlaygroundDemoData } from './domain-ops-config.js';
+import { METHOD_TONE, countField, formatMs, httpMethodOf, labelField, opsBindingSourceOf, opsRowOf, } from './domain-ops-lib.js';
+import { asRecord } from './domain-lib.js';
+import { OpsEmpty } from './OpsEmpty.js';
+/**
+ * `api-playground` (annex §13) — the request composer (method, path, editable
+ * query params / body fields) feeding the response viewer: a dark terminal block
+ * with the body and a status pill. Evidence: API & Backend.
+ *
+ * IT DOES NOT MAKE REQUESTS. This is a security boundary, not a shortcut:
+ * a widget that could issue arbitrary authenticated calls from a dashboard cell
+ * — with the viewer's session, against a path the stored page config chose — is
+ * a confused deputy. So Send does exactly two things:
+ *   1. reveals the response pane, rendering the CANNED body from the bound
+ *      payload (annex: "simulated/real Send with latency"; simulated is what
+ *      this implements, and `sandboxMode` defaults true);
+ *   2. for a WRITE method, emits a `mutate` intent describing the composed
+ *      request, which the host executes through the CRUD API with its
+ *      permission checks, undo and audit — the same contract every editing
+ *      widget follows (04 §2.1). A GET has nothing to mutate and emits nothing.
+ * Unbound → no intent either way; the pane still previews, which is the whole
+ * point of a playground.
+ *
+ * SYNTAX HIGHLIGHTING is out of scope (see `code-snippet-block`): the response
+ * is a mono block, not a tokenized one. The status pill and the latency carry
+ * the signal a reader actually scans for.
+ *
+ * DIRECTION: the response body is a fixed-LTR island — it is CODE. JSON is
+ * left-to-right in every locale, so the pane sets `dir="ltr"` explicitly rather
+ * than inheriting an RTL page's direction, which would scatter braces and
+ * punctuation to the wrong ends of each line (10-i18n-theming.md §5.5). The
+ * chrome around it — labels, params, the Send button — mirrors normally.
+ */
+export { apiPlaygroundConfigSchema, apiPlaygroundDemoData };
+/** Write methods carry a body the host could actually execute. */
+const WRITE_INTENT = {
+    POST: 'insert',
+    PATCH: 'update',
+    PUT: 'update',
+    DELETE: 'delete',
+};
+/** Stable pretty-print for the canned body. */
+function prettyJson(value) {
+    try {
+        return JSON.stringify(value, null, 2) ?? 'null';
+    }
+    catch {
+        // A payload with a cycle (or a BigInt) must not take the widget down.
+        return String(value);
+    }
+}
+export function ApiPlaygroundView({ endpoint, paradigm = 'REST', locale, sendLabel, requestLabel, responseLabel, paramsLabel, responsePlaceholder, onSend, testId, }) {
+    const [values, setValues] = useState(() => Object.fromEntries(endpoint.params.map((param) => [param.key, param.value])));
+    const [sent, setSent] = useState(false);
+    const statusTone = endpoint.status >= 500 ? 'danger' : endpoint.status >= 400 ? 'warn' : 'pos';
+    return (_jsxs("div", { "data-widget": "api-playground", "data-testid": testId, "data-paradigm": paradigm, className: "flex h-full flex-col gap-3 overflow-auto px-4 pb-4", children: [_jsxs("section", { className: "flex flex-col gap-2", "aria-label": requestLabel ?? 'Request', children: [_jsxs("div", { className: "flex items-center gap-2", children: [_jsx(Tag, { mono: true, tone: METHOD_TONE[endpoint.method], "data-part": "playground-method", children: endpoint.method }), _jsx(MonoText, { dir: "ltr", className: "min-w-0 flex-1 truncate text-body-sm text-fg", "data-part": "playground-path", children: endpoint.path }), _jsx(Button, { size: "sm", iconLeft: _jsx(Play, { className: "size-3.5" }), "data-part": "playground-send", onClick: () => {
+                                    setSent(true);
+                                    onSend?.(values);
+                                }, children: sendLabel ?? 'Send' })] }), endpoint.params.length === 0 ? null : (_jsxs("div", { className: "flex flex-col gap-1.5", children: [_jsx("p", { className: "text-caption font-semibold text-fg-subtle", children: paramsLabel ?? 'Parameters' }), endpoint.params.map((param) => (_jsxs("label", { className: "flex items-center gap-2", "data-part": "playground-param", children: [_jsx(MonoText, { className: "w-28 shrink-0 truncate text-caption text-fg-muted", children: param.key }), _jsx(Input, { mono: true, value: values[param.key] ?? '', "data-param": param.key, onChange: (event) => setValues((current) => ({ ...current, [param.key]: event.target.value })) })] }, param.key)))] }))] }), _jsxs("section", { className: "flex min-h-0 flex-1 flex-col gap-1.5", "aria-label": responseLabel ?? 'Response', children: [_jsxs("div", { className: "flex items-center gap-2", children: [_jsx("p", { className: "text-caption font-semibold text-fg-subtle", children: responseLabel ?? 'Response' }), !sent ? null : (_jsxs(_Fragment, { children: [_jsx(Badge, { tone: statusTone, dot: true, "data-part": "playground-status", children: String(endpoint.status) }), _jsx(MonoText, { className: "text-caption text-fg-subtle", "data-part": "playground-latency", children: formatMs(endpoint.latencyMs, locale) })] }))] }), _jsx("div", { dir: "ltr", "data-testid": "playground-response", className: "min-h-24 flex-1 overflow-auto rounded-lg bg-fg p-3", children: sent ? (_jsx(MonoText, { asChild: true, children: _jsx("pre", { className: "whitespace-pre-wrap break-words text-caption text-bg", children: prettyJson(endpoint.sample) }) })) : (_jsx("p", { className: "text-caption text-bg/60", children: responsePlaceholder ?? 'Send the request to see the response.' })) })] })] }));
+}
+/** Project the bound `record` onto the endpoint model. */
+function endpointOf(config, data) {
+    const row = opsRowOf(data);
+    if (row === null)
+        return null;
+    const rawParams = row[config.paramsField];
+    const params = [];
+    if (Array.isArray(rawParams)) {
+        for (const entry of rawParams) {
+            const param = asRecord(entry);
+            if (param === null || typeof param.key !== 'string')
+                continue;
+            params.push({ key: param.key, value: param.value === undefined ? '' : String(param.value) });
+        }
+    }
+    return {
+        method: httpMethodOf(row[config.methodField]),
+        path: labelField(row, config.pathField, '/'),
+        params,
+        sample: row[config.sampleField] ?? null,
+        status: countField(row, config.statusField, 200),
+        latencyMs: countField(row, config.latencyField, 0),
+    };
+}
+export function ApiPlaygroundWidget({ config, data, onEvent }) {
+    const endpoint = useMemo(() => endpointOf(config, data), [config, data]);
+    const source = useMemo(() => opsBindingSourceOf(config.binding), [config.binding]);
+    if (endpoint === null) {
+        return (_jsx(OpsEmpty, { title: config.emptyTitle ?? 'No endpoint selected', body: config.emptyBody ?? 'Pick an endpoint to compose a request against it.' }));
+    }
+    const intent = WRITE_INTENT[endpoint.method];
+    return (_jsx(ApiPlaygroundView, { endpoint: endpoint, paradigm: config.paradigm, ...(config.format?.locale === undefined ? {} : { locale: config.format.locale }), ...(config.sendLabel === undefined ? {} : { sendLabel: config.sendLabel }), ...(config.requestLabel === undefined ? {} : { requestLabel: config.requestLabel }), ...(config.responseLabel === undefined ? {} : { responseLabel: config.responseLabel }), ...(config.paramsLabel === undefined ? {} : { paramsLabel: config.paramsLabel }), ...(config.responsePlaceholder === undefined ? {} : { responsePlaceholder: config.responsePlaceholder }), ...(config.testId === undefined ? {} : { testId: config.testId }), ...(source === null || intent === undefined
+            ? {}
+            : {
+                onSend: (values) => {
+                    void onEvent({
+                        type: 'mutate',
+                        intent,
+                        connectionId: source.connectionId,
+                        table: source.table,
+                        values,
+                    });
+                },
+            }) }));
+}
+//# sourceMappingURL=ApiPlayground.js.map

package/dist/families/domain/ApiPlayground.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ApiPlayground.js","sourceRoot":"","sources":["../../../src/families/domain/ApiPlayground.tsx"],"names":[],"mappings":"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"}

package/dist/families/domain/BlockContent.d.ts

@@ -0,0 +1,11 @@
+import { blockContactConfigSchema, blockContactDemoData, blockHighlightBoxConfigSchema, blockHighlightBoxDemoData } from './blocks-config.js';
+import type { BlockContactConfig, BlockHighlightBoxConfig } from './blocks-config.js';
+import type { WidgetProps } from '../../registry/types.js';
+export { blockContactConfigSchema, blockContactDemoData, blockHighlightBoxConfigSchema, blockHighlightBoxDemoData, };
+/**
+ * TRACK BUILDER — the CONTENT tail of the annex §13 document-block vocabulary:
+ * `block-contact` and `block-highlight-box`.
+ */
+export declare function BlockContactWidget({ config, data }: WidgetProps<BlockContactConfig>): import("react").JSX.Element;
+export declare function BlockHighlightBoxWidget({ config, data }: WidgetProps<BlockHighlightBoxConfig>): import("react").JSX.Element;
+//# sourceMappingURL=BlockContent.d.ts.map

package/dist/families/domain/BlockContent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BlockContent.d.ts","sourceRoot":"","sources":["../../../src/families/domain/BlockContent.tsx"],"names":[],"mappings":"AAKA,OAAO,EACL,wBAAwB,EACxB,oBAAoB,EACpB,6BAA6B,EAC7B,yBAAyB,EAC1B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAEtF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,EACL,wBAAwB,EACxB,oBAAoB,EACpB,6BAA6B,EAC7B,yBAAyB,GAC1B,CAAC;AAEF;;;GAGG;AAIH,wBAAgB,kBAAkB,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,WAAW,CAAC,kBAAkB,CAAC,+BA+BnF;AAID,wBAAgB,uBAAuB,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,WAAW,CAAC,uBAAuB,CAAC,+BAmB7F"}

package/dist/families/domain/BlockContent.js

@@ -0,0 +1,42 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { MonoText } from '@adminium/ui';
+import { Mail, Phone, User } from 'lucide-react';
+import { BlockEmpty } from './BlockShell.js';
+import { rowOf } from './block-lib.js';
+import { blockContactConfigSchema, blockContactDemoData, blockHighlightBoxConfigSchema, blockHighlightBoxDemoData, } from './blocks-config.js';
+export { blockContactConfigSchema, blockContactDemoData, blockHighlightBoxConfigSchema, blockHighlightBoxDemoData, };
+/**
+ * TRACK BUILDER — the CONTENT tail of the annex §13 document-block vocabulary:
+ * `block-contact` and `block-highlight-box`.
+ */
+// ── block-contact ───────────────────────────────────────────────────────────
+export function BlockContactWidget({ config, data }) {
+    const payload = rowOf(data);
+    if (payload === null) {
+        return _jsx(BlockEmpty, { title: config.emptyTitle ?? 'No contact', body: config.emptyBody ?? 'Contact details appear once this document names a recipient.' });
+    }
+    const rows = [
+        { key: 'name', icon: User, value: payload.name, mono: false },
+        { key: 'email', icon: Mail, value: payload.email, mono: true },
+        { key: 'phone', icon: Phone, value: payload.phone, mono: true },
+    ];
+    return (_jsx("ul", { "data-widget": "block-contact", "data-testid": config.testId, className: "w-full space-y-1.5", children: rows
+            .filter((row) => row.value !== undefined && row.value !== '')
+            .map((row) => {
+            const Icon = row.icon;
+            return (_jsxs("li", { "data-part": `contact-${row.key}`, className: "flex items-center gap-2.5 text-body-sm", children: [_jsx(Icon, { className: "size-3.5 shrink-0 text-fg-subtle", "aria-hidden": true }), row.mono ? (_jsx(MonoText, { className: "min-w-0 truncate text-fg", children: row.value })) : (_jsx("span", { className: "min-w-0 truncate font-bold text-fg", children: row.value }))] }, row.key));
+        }) }));
+}
+// ── block-highlight-box ─────────────────────────────────────────────────────
+export function BlockHighlightBoxWidget({ config, data }) {
+    const payload = rowOf(data);
+    if (payload === null) {
+        return _jsx(BlockEmpty, { title: config.emptyTitle ?? 'Nothing highlighted', body: config.emptyBody ?? 'A highlighted figure appears once this block is bound.' });
+    }
+    return (
+    // The annex's "gray callout, label + large mono value ("Amount charged /
+    // $290.00")" — centered, because it is the one figure an email surface wants
+    // the reader to land on.
+    _jsxs("div", { "data-widget": "block-highlight-box", "data-testid": config.testId, className: "w-full rounded-md bg-surface-2 px-4 py-3 text-center", children: [_jsx("p", { className: "text-caption text-fg-subtle", children: payload.label }), _jsx(MonoText, { className: "mt-0.5 block text-title font-bold text-fg", children: payload.value })] }));
+}
+//# sourceMappingURL=BlockContent.js.map

package/dist/families/domain/BlockContent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BlockContent.js","sourceRoot":"","sources":["../../../src/families/domain/BlockContent.tsx"],"names":[],"mappings":"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"}

package/dist/families/domain/BlockFinancial.d.ts

@@ -0,0 +1,32 @@
+import { blockDiscountCodesConfigSchema, blockDiscountCodesDemoData, blockLateFeesConfigSchema, blockLateFeesDemoData, blockLineItemsConfigSchema, blockLineItemsDemoData, blockMultiCurrencyConfigSchema, blockMultiCurrencyDemoData, blockPaymentHistoryConfigSchema, blockPaymentHistoryDemoData, blockQrPayConfigSchema, blockQrPayDemoData, blockTaxBreakdownConfigSchema, blockTaxBreakdownDemoData, blockTotalsSummaryConfigSchema, blockTotalsSummaryDemoData } from './blocks-config.js';
+import type { BlockDiscountCodesConfig, BlockLateFeesConfig, BlockLineItemsConfig, BlockMultiCurrencyConfig, BlockPaymentHistoryConfig, BlockQrPayConfig, BlockTaxBreakdownConfig, BlockTotalsSummaryConfig } from './blocks-config.js';
+import type { WidgetProps } from '../../registry/types.js';
+export { blockDiscountCodesConfigSchema, blockDiscountCodesDemoData, blockLateFeesConfigSchema, blockLateFeesDemoData, blockLineItemsConfigSchema, blockLineItemsDemoData, blockMultiCurrencyConfigSchema, blockMultiCurrencyDemoData, blockPaymentHistoryConfigSchema, blockPaymentHistoryDemoData, blockQrPayConfigSchema, blockQrPayDemoData, blockTaxBreakdownConfigSchema, blockTaxBreakdownDemoData, blockTotalsSummaryConfigSchema, blockTotalsSummaryDemoData, };
+/**
+ * TRACK BUILDER — the INVOICE/PAYMENT half of the annex §13 document-block
+ * vocabulary, grouped in one module because the annex specifies them as one
+ * shared library and they share the money helpers (`computeTotals`,
+ * `formatBlockMoney`) end to end:
+ *
+ *   `block-line-items`, `block-totals-summary`, `block-tax-breakdown`,
+ *   `block-multi-currency`, `block-payment-history`, `block-discount-codes`,
+ *   `block-late-fees`, `block-qr-pay`.
+ *
+ * NEVER WRITES: `block-line-items`' qty/rate edits emit `mutate` intents through
+ * `onEvent` and the host runs them through the CRUD API with undo + audit
+ * (04 §2.1). An unbound (demo) block has no table to address, so it renders the
+ * inputs but emits nothing.
+ *
+ * MONEY IS ALWAYS RECOMPUTED, never read from a stored column: the totals, the
+ * tax lines and the QR amount all derive from the same `computeTotals`, so a
+ * canvas edit can never leave one block disagreeing with another.
+ */
+export declare function BlockLineItemsWidget({ config, data, onEvent }: WidgetProps<BlockLineItemsConfig>): import("react").JSX.Element;
+export declare function BlockTotalsSummaryWidget({ config, data }: WidgetProps<BlockTotalsSummaryConfig>): import("react").JSX.Element;
+export declare function BlockTaxBreakdownWidget({ config, data }: WidgetProps<BlockTaxBreakdownConfig>): import("react").JSX.Element;
+export declare function BlockMultiCurrencyWidget({ config, data }: WidgetProps<BlockMultiCurrencyConfig>): import("react").JSX.Element;
+export declare function BlockPaymentHistoryWidget({ config, data }: WidgetProps<BlockPaymentHistoryConfig>): import("react").JSX.Element;
+export declare function BlockDiscountCodesWidget({ config, data }: WidgetProps<BlockDiscountCodesConfig>): import("react").JSX.Element;
+export declare function BlockLateFeesWidget({ config, data }: WidgetProps<BlockLateFeesConfig>): import("react").JSX.Element;
+export declare function BlockQrPayWidget({ config, data }: WidgetProps<BlockQrPayConfig>): import("react").JSX.Element;
+//# sourceMappingURL=BlockFinancial.d.ts.map

package/dist/families/domain/BlockFinancial.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BlockFinancial.d.ts","sourceRoot":"","sources":["../../../src/families/domain/BlockFinancial.tsx"],"names":[],"mappings":"AAiBA,OAAO,EACL,8BAA8B,EAC9B,0BAA0B,EAC1B,yBAAyB,EACzB,qBAAqB,EACrB,0BAA0B,EAC1B,sBAAsB,EACtB,8BAA8B,EAC9B,0BAA0B,EAC1B,+BAA+B,EAC/B,2BAA2B,EAC3B,sBAAsB,EACtB,kBAAkB,EAClB,6BAA6B,EAC7B,yBAAyB,EACzB,8BAA8B,EAC9B,0BAA0B,EAC3B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EACV,wBAAwB,EACxB,mBAAmB,EACnB,oBAAoB,EACpB,wBAAwB,EACxB,yBAAyB,EACzB,gBAAgB,EAChB,uBAAuB,EAEvB,wBAAwB,EACzB,MAAM,oBAAoB,CAAC;AAU5B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,EACL,8BAA8B,EAC9B,0BAA0B,EAC1B,yBAAyB,EACzB,qBAAqB,EACrB,0BAA0B,EAC1B,sBAAsB,EACtB,8BAA8B,EAC9B,0BAA0B,EAC1B,+BAA+B,EAC/B,2BAA2B,EAC3B,sBAAsB,EACtB,kBAAkB,EAClB,6BAA6B,EAC7B,yBAAyB,EACzB,8BAA8B,EAC9B,0BAA0B,GAC3B,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AAIH,wBAAgB,oBAAoB,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,WAAW,CAAC,oBAAoB,CAAC,+BAyFhG;AAID,wBAAgB,wBAAwB,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,WAAW,CAAC,wBAAwB,CAAC,+BAoC/F;AAID,wBAAgB,uBAAuB,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,WAAW,CAAC,uBAAuB,CAAC,+BAoC7F;AAID,wBAAgB,wBAAwB,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,WAAW,CAAC,wBAAwB,CAAC,+BA2B/F;AAID,wBAAgB,yBAAyB,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,WAAW,CAAC,yBAAyB,CAAC,+BAgCjG;AAID,wBAAgB,wBAAwB,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,WAAW,CAAC,wBAAwB,CAAC,+BA4B/F;AAID,wBAAgB,mBAAmB,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,WAAW,CAAC,mBAAmB,CAAC,+BAqBrF;AAuDD,wBAAgB,gBAAgB,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,WAAW,CAAC,gBAAgB,CAAC,+BA0B/E"}