@tai42/studio-sdk 20.0.0 → 22.0.0

package/dist/components/json-tree-model.js

@@ -1,7 +1,8 @@
 /**
  * The bounded-traversal model behind `JsonTree`: container inspection, the paged
  * child slice, path identity, and the open-state computation for the depth
- * default, expand-all and collapse-all baselines. Pure — no React, no DOM.
+ * default, expand-all and collapse-all baselines and the caller's named paths.
+ * Pure — no React, no DOM.
  */
 import { isRecord } from '../guards';
 /** The deepest level opened by the guarded default; deeper nodes start collapsed. */
@@ -63,6 +64,23 @@ export function childPath(parent, name) {
     const segment = encodeURIComponent(name);
     return parent === '' ? segment : `${parent}/${segment}`;
 }
+/**
+ * The identities of every container a caller's named paths open: each path is a
+ * list of keys from the root (an array item named by its index), and the root,
+ * every container along the path and the one it ends at are all opened.
+ */
+export function namedOpenPaths(paths) {
+    const open = new Set();
+    for (const segments of paths) {
+        let path = '';
+        open.add(path);
+        for (const segment of segments) {
+            path = childPath(path, segment);
+            open.add(path);
+        }
+    }
+    return open;
+}
 export function initialBaseline(defaultExpanded) {
     if (defaultExpanded === true)
         return 'expanded';
@@ -107,19 +125,25 @@ export function expandedOpenPaths(root) {
     return open;
 }
 /**
- * Whether a node is open, from the baseline and the reader's own toggles. An
- * explicit toggle always wins; otherwise the baseline decides — the depth-guarded
- * default opens through {@link AUTO_EXPAND_DEPTH}, expand-all opens the budgeted
- * breadth-first set, collapse-all opens nothing.
+ * Whether a node is open, from the baseline, the caller's named paths and the
+ * reader's own toggles. An explicit toggle always wins; the reader's collapse-all
+ * opens nothing; otherwise a node on a named path is open beside any baseline a call
+ * site selects, and the baseline decides the rest — a collapsed baseline opens
+ * nothing else, the depth-guarded default opens through {@link AUTO_EXPAND_DEPTH},
+ * expand-all opens the budgeted breadth-first set.
  */
-export function computeOpen(baseline, overrides, expandedPaths, path, depth) {
+export function computeOpen(baseline, overrides, expandedPaths, namedPaths, path, depth) {
     const override = overrides.get(path);
     if (override !== undefined)
         return override;
-    if (baseline === 'expanded')
-        return expandedPaths?.has(path) ?? false;
+    if (baseline === 'closed')
+        return false;
+    if (namedPaths.has(path))
+        return true;
     if (baseline === 'collapsed')
         return false;
+    if (baseline === 'expanded')
+        return expandedPaths?.has(path) ?? false;
     return depth <= AUTO_EXPAND_DEPTH;
 }
 //# sourceMappingURL=json-tree-model.js.map

package/dist/components/json-tree-model.js.map

@@ -1 +1 @@
-{"version":3,"file":"json-tree-model.js","sourceRoot":"","sources":["../../src/components/json-tree-model.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"json-tree-model.js","sourceRoot":"","sources":["../../src/components/json-tree-model.ts"],"names":[],"mappings":"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"}

package/dist/components/json-tree.d.ts

@@ -12,6 +12,8 @@
  *   renders no children. `defaultExpanded` overrides per call site.
  * - Expand-all opens breadth-first only until {@link AUTO_EXPAND_NODE_BUDGET} nodes
  *   render and never past {@link MAX_AUTO_DEPTH}; a node beyond either opens on click.
+ * - `openPaths` opens exactly the containers along the paths a caller names, at any
+ *   depth, beside the baseline; collapse-all and the reader's toggles close them.
  * - A container over {@link PAGE_SIZE} children renders one page plus a "show more".
  * - Copy-whole and copy-node write JSON to the clipboard; a refused write shows an alert.
  *
@@ -27,8 +29,15 @@ export interface JsonTreeProps {
      * opens through {@link AUTO_EXPAND_DEPTH} and collapses everything below.
      */
     readonly defaultExpanded?: boolean;
+    /**
+     * Paths whose containers open beside the baseline, at any depth: each path lists
+     * the keys from the root (an array item by its index, as a string), and the root,
+     * every container along it and the one it ends at open. The reader's own toggle
+     * still wins, and collapse-all closes them like every other node.
+     */
+    readonly openPaths?: readonly (readonly string[])[];
     /** The region's accessible name, applied only while the pane actually scrolls. */
     readonly label?: string;
 }
-export declare function JsonTree({ data, defaultExpanded, label }: JsonTreeProps): ReactElement;
+export declare function JsonTree({ data, defaultExpanded, openPaths, label, }: JsonTreeProps): ReactElement;
 //# sourceMappingURL=json-tree.d.ts.map

package/dist/components/json-tree.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"json-tree.d.ts","sourceRoot":"","sources":["../../src/components/json-tree.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAkB1C,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB;;;;OAIG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;IACnC,kFAAkF;IAClF,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAKD,wBAAgB,QAAQ,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,EAAE,aAAa,GAAG,YAAY,CA2FtF"}
+{"version":3,"file":"json-tree.d.ts","sourceRoot":"","sources":["../../src/components/json-tree.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAmB1C,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB;;;;OAIG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;IACnC;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,CAAC;IACpD,kFAAkF;IAClF,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAQD,wBAAgB,QAAQ,CAAC,EACvB,IAAI,EACJ,eAAe,EACf,SAAoB,EACpB,KAAK,GACN,EAAE,aAAa,GAAG,YAAY,CA6F9B"}

package/dist/components/json-tree.js

@@ -3,13 +3,15 @@ import { useCallback, useMemo, useState } from 'react';
 import { useClipboardCopy } from '../hooks/useClipboardCopy';
 import { XCircleIcon } from './icons';
 import { JsonTreeContext } from './json-tree-context';
-import { computeOpen, expandedOpenPaths, initialBaseline, isContainer, PAGE_SIZE, } from './json-tree-model';
+import { computeOpen, expandedOpenPaths, initialBaseline, isContainer, namedOpenPaths, PAGE_SIZE, } from './json-tree-model';
 import { COPY_LABEL, CopyButton, JsonNode } from './json-tree-nodes';
 import { copyFailed, NO_CLIPBOARD, serializeForCopy } from './json-value-format';
 import { useOverflowRegion } from './scroll-region';
 /** The region's name when the caller supplies none. */
 const DEFAULT_LABEL = 'JSON';
-export function JsonTree({ data, defaultExpanded, label }) {
+/** The paths a tree without `openPaths` opens beside its baseline. */
+const NO_PATHS = [];
+export function JsonTree({ data, defaultExpanded, openPaths = NO_PATHS, label, }) {
     const [baseline, setBaseline] = useState(() => initialBaseline(defaultExpanded));
     const [overrides, setOverrides] = useState(() => new Map());
     const { error: copyError, announcement, copy: copyText, } = useClipboardCopy({
@@ -23,7 +25,8 @@ export function JsonTree({ data, defaultExpanded, label }) {
     // while that baseline is active; deriving it lazily keeps a collapsed or
     // depth-default tree from sweeping the payload at all.
     const expandedPaths = useMemo(() => (baseline === 'expanded' ? expandedOpenPaths(data) : null), [baseline, data]);
-    const isOpen = useCallback((path, depth) => computeOpen(baseline, overrides, expandedPaths, path, depth), [baseline, overrides, expandedPaths]);
+    const namedPaths = useMemo(() => namedOpenPaths(openPaths), [openPaths]);
+    const isOpen = useCallback((path, depth) => computeOpen(baseline, overrides, expandedPaths, namedPaths, path, depth), [baseline, overrides, expandedPaths, namedPaths]);
     const setOpen = useCallback((path, open) => {
         setOverrides((previous) => {
             const next = new Map(previous);
@@ -40,7 +43,7 @@ export function JsonTree({ data, defaultExpanded, label }) {
         setOverrides(new Map());
     };
     const collapseAll = () => {
-        setBaseline('collapsed');
+        setBaseline('closed');
         setOverrides(new Map());
     };
     const showToolbar = isContainer(data);

package/dist/components/json-tree.js.map

@@ -1 +1 @@
-{"version":3,"file":"json-tree.js","sourceRoot":"","sources":["../../src/components/json-tree.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"json-tree.js","sourceRoot":"","sources":["../../src/components/json-tree.tsx"],"names":[],"mappings":";AAuBA,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,EAAE,eAAe,EAA6B,MAAM,qBAAqB,CAAC;AACjF,OAAO,EAEL,WAAW,EACX,iBAAiB,EACjB,eAAe,EACf,WAAW,EACX,cAAc,EACd,SAAS,GACV,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACjF,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAqBpD,uDAAuD;AACvD,MAAM,aAAa,GAAG,MAAM,CAAC;AAE7B,sEAAsE;AACtE,MAAM,QAAQ,GAAmC,EAAE,CAAC;AAEpD,MAAM,UAAU,QAAQ,CAAC,EACvB,IAAI,EACJ,eAAe,EACf,SAAS,GAAG,QAAQ,EACpB,KAAK,GACS;IACd,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAW,GAAG,EAAE,CAAC,eAAe,CAAC,eAAe,CAAC,CAAC,CAAC;IAC3F,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAA+B,GAAG,EAAE,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC;IAE1F,MAAM,EACJ,KAAK,EAAE,SAAS,EAChB,YAAY,EACZ,IAAI,EAAE,QAAQ,GACf,GAAG,gBAAgB,CAAC;QACnB,WAAW,EAAE,YAAY;QACzB,WAAW,EAAE,UAAU;KACxB,CAAC,CAAC;IAEH,6EAA6E;IAC7E,8DAA8D;IAC9D,MAAM,MAAM,GAAG,iBAAiB,CAAC,SAAS,EAAE,KAAK,IAAI,aAAa,CAAC,CAAC;IAEpE,kFAAkF;IAClF,yEAAyE;IACzE,uDAAuD;IACvD,MAAM,aAAa,GAAG,OAAO,CAC3B,GAAG,EAAE,CAAC,CAAC,QAAQ,KAAK,UAAU,CAAC,CAAC,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAChE,CAAC,QAAQ,EAAE,IAAI,CAAC,CACjB,CAAC;IAEF,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,cAAc,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;IAEzE,MAAM,MAAM,GAAG,WAAW,CACxB,CAAC,IAAY,EAAE,KAAa,EAAW,EAAE,CACvC,WAAW,CAAC,QAAQ,EAAE,SAAS,EAAE,aAAa,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,CAAC,EAC1E,CAAC,QAAQ,EAAE,SAAS,EAAE,aAAa,EAAE,UAAU,CAAC,CACjD,CAAC;IAEF,MAAM,OAAO,GAAG,WAAW,CAAC,CAAC,IAAY,EAAE,IAAa,EAAQ,EAAE;QAChE,YAAY,CAAC,CAAC,QAAQ,EAAE,EAAE;YACxB,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC;YAC/B,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YACrB,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CAAC;IACL,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,gFAAgF;IAChF,wEAAwE;IACxE,MAAM,IAAI,GAAG,WAAW,CACtB,CAAC,KAAc,EAAoB,EAAE,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,EAC7E,CAAC,QAAQ,CAAC,CACX,CAAC;IAEF,MAAM,OAAO,GAAG,OAAO,CACrB,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EACtD,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CACxB,CAAC;IAEF,MAAM,SAAS,GAAG,GAAS,EAAE;QAC3B,WAAW,CAAC,UAAU,CAAC,CAAC;QACxB,YAAY,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC;IAC1B,CAAC,CAAC;IACF,MAAM,WAAW,GAAG,GAAS,EAAE;QAC7B,WAAW,CAAC,QAAQ,CAAC,CAAC;QACtB,YAAY,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC;IAC1B,CAAC,CAAC;IAEF,MAAM,WAAW,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAEtC,OAAO,CACL,KAAC,eAAe,CAAC,QAAQ,IAAC,KAAK,EAAE,OAAO,YACtC,eAAK,SAAS,EAAC,uBAAuB,aACnC,WAAW,CAAC,CAAC,CAAC,CACb,eAAK,SAAS,EAAC,SAAS,aACtB,iBAAQ,IAAI,EAAC,QAAQ,EAAC,SAAS,EAAC,uBAAuB,EAAC,OAAO,EAAE,SAAS,2BAEjE,EACT,iBAAQ,IAAI,EAAC,QAAQ,EAAC,SAAS,EAAC,uBAAuB,EAAC,OAAO,EAAE,WAAW,6BAEnE,EACT,KAAC,UAAU,IAAC,KAAK,EAAE,IAAI,EAAE,OAAO,EAAC,MAAM,EAAC,KAAK,EAAE,UAAU,GAAI,EAC7D,4BAAgB,QAAQ,EAAC,SAAS,EAAC,qBAAqB,YACrD,YAAY,GACR,IACH,CACP,CAAC,CAAC,CAAC,IAAI,EACP,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,CACzB,gBAAM,IAAI,EAAC,OAAO,EAAC,SAAS,EAAC,iBAAiB,aAC5C,KAAC,WAAW,KAAG,EACd,SAAS,IACL,CACR,CAAC,CAAC,CAAC,IAAI,EACR,cAAK,SAAS,EAAC,gBAAgB,KAAK,MAAM,YACxC,KAAC,QAAQ,IAAC,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAC,EAAE,GAAG,GACvC,IACF,GACmB,CAC5B,CAAC;AACJ,CAAC"}

package/dist/components/select.d.ts

@@ -23,6 +23,12 @@ interface SelectSharedProps {
      * the visible text out of the accessible name (WCAG 2.5.3).
      */
     readonly 'aria-label'?: string;
+    /**
+     * IDREFs of elements that describe the trigger. An enclosing `Field` owns entries
+     * in the same list (its description and error), so the two are concatenated,
+     * caller's first, exactly as the text inputs do.
+     */
+    readonly 'aria-describedby'?: string;
 }
 /** The FLAT listbox: one ungrouped run of options. */
 export interface SelectProps extends SelectSharedProps {

package/dist/components/select.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"select.d.ts","sourceRoot":"","sources":["../../src/components/select.tsx"],"names":[],"mappings":"AAiBA,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,iEAAiE;AACjE,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,CAAC;CAC3C;AAED,wDAAwD;AACxD,UAAU,iBAAiB;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACjD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,sDAAsD;AACtD,MAAM,WAAW,WAAY,SAAQ,iBAAiB;IACpD,QAAQ,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,CAAC;CAC3C;AAED,6EAA6E;AAC7E,MAAM,WAAW,iBAAkB,SAAQ,iBAAiB;IAC1D,QAAQ,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,CAAC;CACzC;AAED;;;;;;;;;;GAUG;AACH,KAAK,UAAU,GACX,CAAC,WAAW,GAAG;IAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAA;CAAE,CAAC,GAC/C,CAAC,iBAAiB,GAAG;IAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,CAAA;CAAE,CAAC,CAAC;AAiB3D,wBAAgB,MAAM,CAAC,KAAK,EAAE,UAAU,+BA8DvC"}
+{"version":3,"file":"select.d.ts","sourceRoot":"","sources":["../../src/components/select.tsx"],"names":[],"mappings":"AAiBA,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,iEAAiE;AACjE,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,CAAC;CAC3C;AAED,wDAAwD;AACxD,UAAU,iBAAiB;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACjD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B;;;;OAIG;IACH,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;CACtC;AAED,sDAAsD;AACtD,MAAM,WAAW,WAAY,SAAQ,iBAAiB;IACpD,QAAQ,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,CAAC;CAC3C;AAED,6EAA6E;AAC7E,MAAM,WAAW,iBAAkB,SAAQ,iBAAiB;IAC1D,QAAQ,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,CAAC;CACzC;AAED;;;;;;;;;;GAUG;AACH,KAAK,UAAU,GACX,CAAC,WAAW,GAAG;IAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAA;CAAE,CAAC,GAC/C,CAAC,iBAAiB,GAAG;IAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,CAAA;CAAE,CAAC,CAAC;AAiB3D,wBAAgB,MAAM,CAAC,KAAK,EAAE,UAAU,+BAkEvC"}

package/dist/components/select.js

@@ -18,15 +18,16 @@ function OptionItem({ option }) {
     return (_jsxs(RadixSelect.Item, { className: "tai-select-item", value: option.value, disabled: option.disabled, children: [_jsx(RadixSelect.ItemText, { children: option.label }), _jsx(RadixSelect.ItemIndicator, { className: "tai-select-item-indicator", children: _jsx(CheckIcon, {}) })] }));
 }
 export function Select(props) {
-    const { value, defaultValue, onValueChange, placeholder = 'Select…', disabled, name, 'aria-label': ariaLabel, } = props;
+    const { value, defaultValue, onValueChange, placeholder = 'Select…', disabled, name, 'aria-label': ariaLabel, 'aria-describedby': ownDescribedBy, } = props;
     const field = useFieldControl();
+    const describedBy = [ownDescribedBy, field['aria-describedby']].filter((id) => id !== undefined);
     // Untyped JavaScript is the only caller that reaches this. Rendering one list
     // and dropping the other would lose every entry in the discarded one silently,
     // and an empty listbox reads as "there is nothing to choose".
     if ((props.options === undefined) === (props.groups === undefined)) {
         throw new Error('Select renders exactly one of `options` or `groups`; it was given both, or neither.');
     }
-    return (_jsxs(RadixSelect.Root, { value: value, defaultValue: defaultValue, onValueChange: onValueChange, disabled: disabled, name: name, children: [_jsxs(RadixSelect.Trigger, { id: field.id, className: SELECT_TRIGGER_CLASS, "aria-label": field.id === undefined ? ariaLabel : undefined, "aria-describedby": field['aria-describedby'], "aria-invalid": field['aria-invalid'], children: [_jsx(RadixSelect.Value, { placeholder: placeholder }), _jsx(RadixSelect.Icon, { "aria-hidden": "true", children: _jsx(ChevronDownIcon, {}) })] }), _jsx(RadixSelect.Portal, { children: _jsx(RadixSelect.Content, { className: "tai-select-content", position: "popper", sideOffset: 4, children: _jsx(RadixSelect.Viewport, { className: "tai-select-viewport", children: props.groups !== undefined
+    return (_jsxs(RadixSelect.Root, { value: value, defaultValue: defaultValue, onValueChange: onValueChange, disabled: disabled, name: name, children: [_jsxs(RadixSelect.Trigger, { id: field.id, className: SELECT_TRIGGER_CLASS, "aria-label": field.id === undefined ? ariaLabel : undefined, "aria-describedby": describedBy.length > 0 ? describedBy.join(' ') : undefined, "aria-invalid": field['aria-invalid'], children: [_jsx(RadixSelect.Value, { placeholder: placeholder }), _jsx(RadixSelect.Icon, { "aria-hidden": "true", children: _jsx(ChevronDownIcon, {}) })] }), _jsx(RadixSelect.Portal, { children: _jsx(RadixSelect.Content, { className: "tai-select-content", position: "popper", sideOffset: 4, children: _jsx(RadixSelect.Viewport, { className: "tai-select-viewport", children: props.groups !== undefined
                             ? props.groups.map((group) => (_jsxs(RadixSelect.Group, { children: [_jsx(RadixSelect.Label, { className: "tai-select-group-label tai-label", children: group.label }), group.options.map((option) => (_jsx(OptionItem, { option: option }, option.value)))] }, group.label)))
                             : props.options.map((option) => _jsx(OptionItem, { option: option }, option.value)) }) }) })] }));
 }

package/dist/components/select.js.map

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

package/dist/components/served-media.d.ts

@@ -12,15 +12,26 @@
  * url is a loud blocked notice, its text React-escaped, never a live attribute.
  * There is no `dangerouslySetInnerHTML` here.
  */
+import type { ServedConstants } from '@tai42/api-client';
 import type { ReactNode } from 'react';
+/**
+ * The served-media grammar the contract publishes, read from the injected client
+ * (`useApi().constants`): the served route prefix and the stored-media id pattern. Media is
+ * stored by reference and served from the API origin at `MEDIA_ROUTE_PREFIX + <id>`; a record
+ * carries it as a RELATIVE url of exactly that shape, resolved to the API base at render time
+ * ({@link resolveMediaSrc}), not assumed same-origin as the SPA page.
+ */
+export type ServedMediaGrammar = {
+    readonly [K in keyof Pick<ServedConstants, 'MEDIA_ROUTE_PREFIX' | 'MEDIA_ID_PATTERN'>]: string;
+};
 /**
  * Whether `url` is the platform's own served-media reference: a relative
- * `MEDIA_ROUTE_PREFIX + <id>` with a well-formed 43-char urlsafe-base64 id. A served
+ * `MEDIA_ROUTE_PREFIX + <id>` whose id matches `MEDIA_ID_PATTERN` whole. A served
  * reference is same-origin to the API base ({@link resolveMediaSrc}) and leaks no page
  * context on load, so a sink with no per-element referrer control (`<audio>`/`<video>`,
  * where `referrerPolicy` is not a valid attribute) admits ONLY this form.
  */
-export declare function isServedMediaUrl(url: string): boolean;
+export declare function isServedMediaUrl(url: string, grammar: ServedMediaGrammar): boolean;
 /**
  * The media src gate: a media element renders ONLY for an `https:` URL, the
  * platform's own served-media reference (a relative `MEDIA_ROUTE_PREFIX + <id>`),
@@ -36,7 +47,7 @@ export declare function isServedMediaUrl(url: string): boolean;
  * item. The gate keys on the reference form; {@link resolveMediaSrc} joins an
  * admitted reference to the API base for the actual load.
  */
-export declare function isRenderableMediaSrc(url: string, allowDataImage?: boolean): boolean;
+export declare function isRenderableMediaSrc(url: string, grammar: ServedMediaGrammar, allowDataImage?: boolean): boolean;
 /**
  * The URL an admitted media element actually loads. An `https:` url is already
  * absolute and is returned unchanged. A served-media reference is RELATIVE and is
@@ -46,7 +57,7 @@ export declare function isRenderableMediaSrc(url: string, allowDataImage?: boole
  * relative, which is correct; a configured base's trailing slash is stripped so the
  * join never double-slashes.
  */
-export declare function resolveMediaSrc(url: string, baseUrl: string): string;
+export declare function resolveMediaSrc(url: string, baseUrl: string, grammar: ServedMediaGrammar): string;
 export interface MediaImageProps {
     readonly url: string;
     readonly caption?: string;
@@ -76,4 +87,39 @@ export interface MediaImageProps {
  * blocked/failed states in its own presentation.
  */
 export declare function MediaImage({ url, caption, altFallback, renderNotice, allowDataImage, }: MediaImageProps): ReactNode;
+export interface MediaDocumentProps {
+    readonly url: string;
+    /** The download label: the item's filename or caption, or the caller's default. */
+    readonly label: string;
+    /** Render the notice shown when the url fails the src gate. */
+    readonly renderNotice: (url: string) => ReactNode;
+}
+/**
+ * One document: a labelled download affordance. The served route sends
+ * `Content-Disposition: attachment` for documents, so the anchor `download`-hints and
+ * opens in a new tab; `rel="noreferrer"` stops the Studio URL leaking to the media
+ * host. A url that fails {@link isRenderableMediaSrc} is the caller's notice, never a
+ * live href.
+ */
+export declare function MediaDocument({ url, label, renderNotice }: MediaDocumentProps): ReactNode;
+export interface MediaPlayerProps {
+    readonly kind: 'audio' | 'video';
+    readonly url: string;
+    /** The player's accessible label. */
+    readonly label: string;
+    /**
+     * Render the notice shown when no player is displayed: `state` is `'blocked'` when
+     * the url is not a served reference and `'failed'` when it fails to LOAD.
+     */
+    readonly renderNotice: (state: 'blocked' | 'failed', url: string) => ReactNode;
+}
+/**
+ * A native `<audio>`/`<video controls>` player. `referrerPolicy` is not a valid
+ * attribute on `<audio>`/`<video>`, so a remote load has no per-element referrer
+ * control; the player therefore admits ONLY the platform's own served-media reference
+ * ({@link isServedMediaUrl}: same-origin, leaking no page URL to a media host), and any
+ * other url, a bare `https:` one included, is the caller's notice. The load-failure
+ * flag keys on the url that failed so a new url at the same position gets a fresh load.
+ */
+export declare function MediaPlayer({ kind, url, label, renderNotice }: MediaPlayerProps): ReactNode;
 //# sourceMappingURL=served-media.d.ts.map

package/dist/components/served-media.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"served-media.d.ts","sourceRoot":"","sources":["../../src/components/served-media.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAiB,SAAS,EAAE,MAAM,OAAO,CAAC;AAiBtD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAErD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,cAAc,UAAQ,GAAG,OAAO,CAGjF;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAEpE;AAuCD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,uDAAuD;IACvD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,GAAG,QAAQ,EAAE,GAAG,EAAE,MAAM,KAAK,SAAS,CAAC;IAChF;;;;OAIG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;CACnC;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,EACzB,GAAG,EACH,OAAO,EACP,WAA8B,EAC9B,YAAY,EACZ,cAAsB,GACvB,EAAE,eAAe,GAAG,SAAS,CAyC7B"}
+{"version":3,"file":"served-media.d.ts","sourceRoot":"","sources":["../../src/components/served-media.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAiB,SAAS,EAAE,MAAM,OAAO,CAAC;AAOtD;;;;;;GAMG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,EAAE,CAAC,IAAI,MAAM,IAAI,CAAC,eAAe,EAAE,oBAAoB,GAAG,kBAAkB,CAAC,GAAG,MAAM;CAC/F,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAMlF;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,kBAAkB,EAC3B,cAAc,UAAQ,GACrB,OAAO,CAOT;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,MAAM,CAEjG;AAuCD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,uDAAuD;IACvD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,GAAG,QAAQ,EAAE,GAAG,EAAE,MAAM,KAAK,SAAS,CAAC;IAChF;;;;OAIG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;CACnC;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,EACzB,GAAG,EACH,OAAO,EACP,WAA8B,EAC9B,YAAY,EACZ,cAAsB,GACvB,EAAE,eAAe,GAAG,SAAS,CAyC7B;AAcD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,mFAAmF;IACnF,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,+DAA+D;IAC/D,QAAQ,CAAC,YAAY,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,SAAS,CAAC;CACnD;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,YAAY,EAAE,EAAE,kBAAkB,GAAG,SAAS,CAkBzF;AAiBD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC;IACjC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,qCAAqC;IACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,QAAQ,CAAC,YAAY,EAAE,CAAC,KAAK,EAAE,SAAS,GAAG,QAAQ,EAAE,GAAG,EAAE,MAAM,KAAK,SAAS,CAAC;CAChF;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,YAAY,EAAE,EAAE,gBAAgB,GAAG,SAAS,CAoC3F"}

package/dist/components/served-media.js

@@ -3,24 +3,17 @@ import { useState } from 'react';
 import { useApi } from '../hooks/useApi';
 import { Badge } from './badge';
 import { isSafeHttpUrl } from './primitives';
-/**
- * The served-media route: media is stored by reference and served from the API
- * origin at `MEDIA_ROUTE_PREFIX + <id>`, where the id is 43 urlsafe-base64 chars
- * (32 random bytes). A record carries it as a RELATIVE url of exactly that shape —
- * the platform's own media reference, resolved to the API base at render time
- * ({@link resolveMediaSrc}), not assumed same-origin as the SPA page.
- */
-const MEDIA_ROUTE_PREFIX = '/api/interactions/media/';
-const MEDIA_ID = /^[A-Za-z0-9_-]{43}$/;
 /**
  * Whether `url` is the platform's own served-media reference: a relative
- * `MEDIA_ROUTE_PREFIX + <id>` with a well-formed 43-char urlsafe-base64 id. A served
+ * `MEDIA_ROUTE_PREFIX + <id>` whose id matches `MEDIA_ID_PATTERN` whole. A served
  * reference is same-origin to the API base ({@link resolveMediaSrc}) and leaks no page
  * context on load, so a sink with no per-element referrer control (`<audio>`/`<video>`,
  * where `referrerPolicy` is not a valid attribute) admits ONLY this form.
  */
-export function isServedMediaUrl(url) {
-    return url.startsWith(MEDIA_ROUTE_PREFIX) && MEDIA_ID.test(url.slice(MEDIA_ROUTE_PREFIX.length));
+export function isServedMediaUrl(url, grammar) {
+    const prefix = grammar.MEDIA_ROUTE_PREFIX;
+    return (url.startsWith(prefix) &&
+        new RegExp(`^${grammar.MEDIA_ID_PATTERN}$`).test(url.slice(prefix.length)));
 }
 /**
  * The media src gate: a media element renders ONLY for an `https:` URL, the
@@ -37,9 +30,11 @@ export function isServedMediaUrl(url) {
  * item. The gate keys on the reference form; {@link resolveMediaSrc} joins an
  * admitted reference to the API base for the actual load.
  */
-export function isRenderableMediaSrc(url, allowDataImage = false) {
+export function isRenderableMediaSrc(url, grammar, allowDataImage = false) {
     const isHttpsUrl = isSafeHttpUrl(url) && new URL(url).protocol === 'https:';
-    return isHttpsUrl || (allowDataImage && url.startsWith('data:image/')) || isServedMediaUrl(url);
+    return (isHttpsUrl ||
+        (allowDataImage && url.startsWith('data:image/')) ||
+        isServedMediaUrl(url, grammar));
 }
 /**
  * The URL an admitted media element actually loads. An `https:` url is already
@@ -50,8 +45,8 @@ export function isRenderableMediaSrc(url, allowDataImage = false) {
  * relative, which is correct; a configured base's trailing slash is stripped so the
  * join never double-slashes.
  */
-export function resolveMediaSrc(url, baseUrl) {
-    return isServedMediaUrl(url) ? `${baseUrl.replace(/\/+$/, '')}${url}` : url;
+export function resolveMediaSrc(url, baseUrl, grammar) {
+    return isServedMediaUrl(url, grammar) ? `${baseUrl.replace(/\/+$/, '')}${url}` : url;
 }
 // -- styles ------------------------------------------------------------------
 const itemStyle = {
@@ -96,8 +91,8 @@ export function MediaImage({ url, caption, altFallback = 'Attached image', rende
     // url rendered at this same position gets a fresh load attempt instead of inheriting
     // a stale failure notice.
     const [failedUrl, setFailedUrl] = useState(null);
-    const { baseUrl } = useApi();
-    if (!isRenderableMediaSrc(url, allowDataImage)) {
+    const { baseUrl, constants } = useApi();
+    if (!isRenderableMediaSrc(url, constants, allowDataImage)) {
         if (renderNotice !== undefined)
             return renderNotice('blocked', url);
         return (_jsxs("div", { role: "alert", "data-testid": "media-item-blocked", style: blockedStyle, children: [_jsx(Badge, { variant: "danger", children: "Blocked image" }), _jsx("span", { style: blockedUrlStyle, children: url })] }));
@@ -107,8 +102,63 @@ export function MediaImage({ url, caption, altFallback = 'Attached image', rende
             return renderNotice('failed', url);
         return (_jsxs("div", { role: "alert", "data-testid": "media-image-error", style: blockedStyle, children: [_jsx(Badge, { variant: "danger", children: "Image failed to load" }), _jsx("span", { style: blockedUrlStyle, children: url })] }));
     }
-    return (_jsxs("div", { style: itemStyle, children: [_jsx("img", { src: resolveMediaSrc(url, baseUrl), alt: caption ?? altFallback, referrerPolicy: "no-referrer", style: imageStyle, onError: () => {
+    return (_jsxs("div", { style: itemStyle, children: [_jsx("img", { src: resolveMediaSrc(url, baseUrl, constants), alt: caption ?? altFallback, referrerPolicy: "no-referrer", style: imageStyle, onError: () => {
                     setFailedUrl(url);
                 } }), caption !== undefined ? _jsx("span", { style: captionStyle, children: caption }) : null] }));
 }
+// -- document item -----------------------------------------------------------
+const chipStyle = {
+    display: 'flex',
+    alignItems: 'center',
+    gap: 'var(--tai-space-2)',
+};
+const labelStyle = {
+    wordBreak: 'break-all',
+};
+/**
+ * One document: a labelled download affordance. The served route sends
+ * `Content-Disposition: attachment` for documents, so the anchor `download`-hints and
+ * opens in a new tab; `rel="noreferrer"` stops the Studio URL leaking to the media
+ * host. A url that fails {@link isRenderableMediaSrc} is the caller's notice, never a
+ * live href.
+ */
+export function MediaDocument({ url, label, renderNotice }) {
+    const { baseUrl, constants } = useApi();
+    if (!isRenderableMediaSrc(url, constants))
+        return renderNotice(url);
+    return (_jsxs("div", { style: chipStyle, "data-testid": "media-document", children: [_jsx(Badge, { variant: "neutral", children: "Document" }), _jsx("a", { href: resolveMediaSrc(url, baseUrl, constants), target: "_blank", rel: "noreferrer", download: true, title: label, style: labelStyle, children: label })] }));
+}
+// -- audio / video item ------------------------------------------------------
+const audioStyle = {
+    width: '100%',
+};
+const videoStyle = {
+    maxWidth: '100%',
+    maxHeight: '320px',
+    width: 'auto',
+    height: 'auto',
+    borderRadius: 'var(--tai-radius-md)',
+    border: '1px solid var(--tai-color-border)',
+};
+/**
+ * A native `<audio>`/`<video controls>` player. `referrerPolicy` is not a valid
+ * attribute on `<audio>`/`<video>`, so a remote load has no per-element referrer
+ * control; the player therefore admits ONLY the platform's own served-media reference
+ * ({@link isServedMediaUrl}: same-origin, leaking no page URL to a media host), and any
+ * other url, a bare `https:` one included, is the caller's notice. The load-failure
+ * flag keys on the url that failed so a new url at the same position gets a fresh load.
+ */
+export function MediaPlayer({ kind, url, label, renderNotice }) {
+    const [failedUrl, setFailedUrl] = useState(null);
+    const { baseUrl, constants } = useApi();
+    if (!isServedMediaUrl(url, constants))
+        return renderNotice('blocked', url);
+    if (failedUrl === url)
+        return renderNotice('failed', url);
+    const src = resolveMediaSrc(url, baseUrl, constants);
+    const onError = () => {
+        setFailedUrl(url);
+    };
+    return (_jsx("div", { style: itemStyle, children: kind === 'audio' ? (_jsx("audio", { controls: true, src: src, "aria-label": label, onError: onError, style: audioStyle, "data-testid": "media-audio" })) : (_jsx("video", { controls: true, src: src, "aria-label": label, onError: onError, style: videoStyle, "data-testid": "media-video" })) }));
+}
 //# sourceMappingURL=served-media.js.map

package/dist/components/served-media.js.map

@@ -1 +1 @@
-{"version":3,"file":"served-media.js","sourceRoot":"","sources":["../../src/components/served-media.tsx"],"names":[],"mappings":";AAeA,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEjC,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C;;;;;;GAMG;AACH,MAAM,kBAAkB,GAAG,0BAA0B,CAAC;AACtD,MAAM,QAAQ,GAAG,qBAAqB,CAAC;AAEvC;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,OAAO,GAAG,CAAC,UAAU,CAAC,kBAAkB,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC;AACnG,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,oBAAoB,CAAC,GAAW,EAAE,cAAc,GAAG,KAAK;IACtE,MAAM,UAAU,GAAG,aAAa,CAAC,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC;IAC5E,OAAO,UAAU,IAAI,CAAC,cAAc,IAAI,GAAG,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,IAAI,gBAAgB,CAAC,GAAG,CAAC,CAAC;AAClG,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAAC,GAAW,EAAE,OAAe;IAC1D,OAAO,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;AAC9E,CAAC;AAED,+EAA+E;AAE/E,MAAM,SAAS,GAAkB;IAC/B,OAAO,EAAE,MAAM;IACf,aAAa,EAAE,QAAQ;IACvB,GAAG,EAAE,oBAAoB;CAC1B,CAAC;AAEF,MAAM,UAAU,GAAkB;IAChC,QAAQ,EAAE,MAAM;IAChB,SAAS,EAAE,OAAO;IAClB,KAAK,EAAE,MAAM;IACb,MAAM,EAAE,MAAM;IACd,SAAS,EAAE,SAAS;IACpB,YAAY,EAAE,sBAAsB;IACpC,MAAM,EAAE,mCAAmC;CAC5C,CAAC;AAEF,MAAM,YAAY,GAAkB;IAClC,KAAK,EAAE,6BAA6B;IACpC,QAAQ,EAAE,oBAAoB;CAC/B,CAAC;AAEF,MAAM,YAAY,GAAkB;IAClC,OAAO,EAAE,MAAM;IACf,aAAa,EAAE,QAAQ;IACvB,GAAG,EAAE,oBAAoB;CAC1B,CAAC;AAEF,MAAM,eAAe,GAAkB;IACrC,KAAK,EAAE,6BAA6B;IACpC,QAAQ,EAAE,oBAAoB;IAC9B,SAAS,EAAE,WAAW;CACvB,CAAC;AAwBF;;;;;;;;GAQG;AACH,MAAM,UAAU,UAAU,CAAC,EACzB,GAAG,EACH,OAAO,EACP,WAAW,GAAG,gBAAgB,EAC9B,YAAY,EACZ,cAAc,GAAG,KAAK,GACN;IAChB,mFAAmF;IACnF,qFAAqF;IACrF,0BAA0B;IAC1B,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAgB,IAAI,CAAC,CAAC;IAChE,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,EAAE,CAAC;IAE7B,IAAI,CAAC,oBAAoB,CAAC,GAAG,EAAE,cAAc,CAAC,EAAE,CAAC;QAC/C,IAAI,YAAY,KAAK,SAAS;YAAE,OAAO,YAAY,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;QACpE,OAAO,CACL,eAAK,IAAI,EAAC,OAAO,iBAAa,oBAAoB,EAAC,KAAK,EAAE,YAAY,aACpE,KAAC,KAAK,IAAC,OAAO,EAAC,QAAQ,8BAAsB,EAC7C,eAAM,KAAK,EAAE,eAAe,YAAG,GAAG,GAAQ,IACtC,CACP,CAAC;IACJ,CAAC;IAED,IAAI,SAAS,KAAK,GAAG,EAAE,CAAC;QACtB,IAAI,YAAY,KAAK,SAAS;YAAE,OAAO,YAAY,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QACnE,OAAO,CACL,eAAK,IAAI,EAAC,OAAO,iBAAa,mBAAmB,EAAC,KAAK,EAAE,YAAY,aACnE,KAAC,KAAK,IAAC,OAAO,EAAC,QAAQ,qCAA6B,EACpD,eAAM,KAAK,EAAE,eAAe,YAAG,GAAG,GAAQ,IACtC,CACP,CAAC;IACJ,CAAC;IAED,OAAO,CACL,eAAK,KAAK,EAAE,SAAS,aACnB,cACE,GAAG,EAAE,eAAe,CAAC,GAAG,EAAE,OAAO,CAAC,EAClC,GAAG,EAAE,OAAO,IAAI,WAAW,EAC3B,cAAc,EAAC,aAAa,EAC5B,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,GAAG,EAAE;oBACZ,YAAY,CAAC,GAAG,CAAC,CAAC;gBACpB,CAAC,GACD,EACD,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,eAAM,KAAK,EAAE,YAAY,YAAG,OAAO,GAAQ,CAAC,CAAC,CAAC,IAAI,IACvE,CACP,CAAC;AACJ,CAAC"}
+{"version":3,"file":"served-media.js","sourceRoot":"","sources":["../../src/components/served-media.tsx"],"names":[],"mappings":"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"}

package/dist/env-markers.d.ts

@@ -0,0 +1,25 @@
+/**
+ * The `!ENV ${VAR[:default]}` manifest marker grammar the platform reads: a string leaf
+ * that begins with the `!ENV ` prefix (the tag and exactly one space) references an
+ * environment variable by name, never its value. A variable name carries no `{`, `}` or
+ * `:`; an optional `:default` follows it.
+ */
+/** The prefix that makes a string leaf an `!ENV` marker. */
+export declare const ENV_MARKER_PREFIX = "!ENV ";
+/** The reference of a single-reference marker leaf. */
+export interface EnvRef {
+    readonly key: string;
+    /** The `:default` text (without the leading colon); absent for a bare reference. */
+    readonly default?: string;
+}
+/** The reference of `value` when it is exactly `!ENV ${KEY}` or `!ENV ${KEY:default}`, else `null`. */
+export declare function parseEnvMarker(value: unknown): EnvRef | null;
+/**
+ * The marker referencing `key`, carrying `defaultValue` when given. Throws when
+ * {@link parseEnvMarker} would not read the marker back as `(key, defaultValue)`: a name is
+ * non-empty and carries no `{`, `}` or `:`; a default is non-empty and carries no `}`.
+ */
+export declare function formatEnvMarker(key: string, defaultValue?: string): string;
+/** Every variable name any marker leaf anywhere under `value` references. */
+export declare function collectEnvRefs(value: unknown): Set<string>;
+//# sourceMappingURL=env-markers.d.ts.map

package/dist/env-markers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-markers.d.ts","sourceRoot":"","sources":["../src/env-markers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,4DAA4D;AAC5D,eAAO,MAAM,iBAAiB,UAAU,CAAC;AAQzC,uDAAuD;AACvD,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,oFAAoF;IACpF,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,uGAAuG;AACvG,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAO5D;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAY1E;AAED,6EAA6E;AAC7E,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,CAgB1D"}

package/dist/env-markers.js

@@ -0,0 +1,63 @@
+/**
+ * The `!ENV ${VAR[:default]}` manifest marker grammar the platform reads: a string leaf
+ * that begins with the `!ENV ` prefix (the tag and exactly one space) references an
+ * environment variable by name, never its value. A variable name carries no `{`, `}` or
+ * `:`; an optional `:default` follows it.
+ */
+/** The prefix that makes a string leaf an `!ENV` marker. */
+export const ENV_MARKER_PREFIX = '!ENV ';
+/** A leaf that is exactly one reference: group 1 the name, group 2 the optional default. */
+const SINGLE_REF = /^!ENV \$\{([^}{:]+)(?::([^}]+))?\}$/;
+/** Every reference inside a marker leaf's expression. */
+const ANY_REF = /\$\{([^}{:]+)(?::[^}]+)?\}/g;
+/** The reference of `value` when it is exactly `!ENV ${KEY}` or `!ENV ${KEY:default}`, else `null`. */
+export function parseEnvMarker(value) {
+    if (typeof value !== 'string')
+        return null;
+    const match = SINGLE_REF.exec(value);
+    if (match === null)
+        return null;
+    const key = match[1] ?? '';
+    const defaultText = match[2];
+    return defaultText === undefined ? { key } : { key, default: defaultText };
+}
+/**
+ * The marker referencing `key`, carrying `defaultValue` when given. Throws when
+ * {@link parseEnvMarker} would not read the marker back as `(key, defaultValue)`: a name is
+ * non-empty and carries no `{`, `}` or `:`; a default is non-empty and carries no `}`.
+ */
+export function formatEnvMarker(key, defaultValue) {
+    const marker = defaultValue === undefined
+        ? `${ENV_MARKER_PREFIX}\${${key}}`
+        : `${ENV_MARKER_PREFIX}\${${key}:${defaultValue}}`;
+    const parsed = parseEnvMarker(marker);
+    if (parsed?.key !== key || parsed.default !== defaultValue) {
+        throw new Error(`var ${JSON.stringify(key)} with default ${JSON.stringify(defaultValue)} cannot be written as an !ENV marker: a name is non-empty without '{', '}' or ':', a default is non-empty without '}'`);
+    }
+    return marker;
+}
+/** Every variable name any marker leaf anywhere under `value` references. */
+export function collectEnvRefs(value) {
+    const refs = new Set();
+    const walk = (node) => {
+        if (typeof node === 'string') {
+            if (!node.startsWith(ENV_MARKER_PREFIX))
+                return;
+            for (const match of node.slice(ENV_MARKER_PREFIX.length).matchAll(ANY_REF)) {
+                if (match[1] !== undefined)
+                    refs.add(match[1]);
+            }
+        }
+        else if (Array.isArray(node)) {
+            for (const item of node)
+                walk(item);
+        }
+        else if (typeof node === 'object' && node !== null) {
+            for (const nested of Object.values(node))
+                walk(nested);
+        }
+    };
+    walk(value);
+    return refs;
+}
+//# sourceMappingURL=env-markers.js.map

package/dist/env-markers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-markers.js","sourceRoot":"","sources":["../src/env-markers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,4DAA4D;AAC5D,MAAM,CAAC,MAAM,iBAAiB,GAAG,OAAO,CAAC;AAEzC,4FAA4F;AAC5F,MAAM,UAAU,GAAG,qCAAqC,CAAC;AAEzD,yDAAyD;AACzD,MAAM,OAAO,GAAG,6BAA6B,CAAC;AAS9C,uGAAuG;AACvG,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3C,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrC,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAChC,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC3B,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAC7B,OAAO,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;AAC7E,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,GAAW,EAAE,YAAqB;IAChE,MAAM,MAAM,GACV,YAAY,KAAK,SAAS;QACxB,CAAC,CAAC,GAAG,iBAAiB,MAAM,GAAG,GAAG;QAClC,CAAC,CAAC,GAAG,iBAAiB,MAAM,GAAG,IAAI,YAAY,GAAG,CAAC;IACvD,MAAM,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IACtC,IAAI,MAAM,EAAE,GAAG,KAAK,GAAG,IAAI,MAAM,CAAC,OAAO,KAAK,YAAY,EAAE,CAAC;QAC3D,MAAM,IAAI,KAAK,CACb,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,iBAAiB,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,uHAAuH,CAC/L,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,IAAI,GAAG,CAAC,IAAa,EAAQ,EAAE;QACnC,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC7B,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC;gBAAE,OAAO;YAChD,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC3E,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS;oBAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YACjD,CAAC;QACH,CAAC;aAAM,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/B,KAAK,MAAM,IAAI,IAAI,IAAI;gBAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QACtC,CAAC;aAAM,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YACrD,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;gBAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACzD,CAAC;IACH,CAAC,CAAC;IACF,IAAI,CAAC,KAAK,CAAC,CAAC;IACZ,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/hooks/interactions-stream.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interactions-stream.d.ts","sourceRoot":"","sources":["../../src/hooks/interactions-stream.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIrD,qEAAqE;AACrE,MAAM,MAAM,iBAAiB,GAAG,WAAW,GAAG;IAAE,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC;AAoG7E;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAK9D;AAED,wEAAwE;AACxE,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGnD;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,QAAQ,CAAC,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACzC;AAED,wBAAgB,YAAY,IAAI,WAAW,CAQ1C;AAED,kFAAkF;AAClF,wBAAgB,eAAe,CAC7B,OAAO,EAAE,WAAW,EACpB,WAAW,EAAE,WAAW,EACxB,KAAK,EAAE,MAAM,GACZ,IAAI,CAGN;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,WAAW,EACpB,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,SAAS,WAAW,EAAE,GAC3B,IAAI,CAUN;AAED,4FAA4F;AAC5F,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAMzF;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAexD;AAED,iFAAiF;AACjF,wBAAgB,KAAK,CAAC,IAAI,EAAE,SAAS,WAAW,EAAE,EAAE,IAAI,EAAE,WAAW,GAAG,iBAAiB,EAAE,CAW1F;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,SAAS,WAAW,EAAE,EAC5B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,WAAW,EACjB,UAAU,EAAE,MAAM,GACjB,MAAM,CAWR"}
+{"version":3,"file":"interactions-stream.d.ts","sourceRoot":"","sources":["../../src/hooks/interactions-stream.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIrD,qEAAqE;AACrE,MAAM,MAAM,iBAAiB,GAAG,WAAW,GAAG;IAAE,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC;AAsG7E;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAK9D;AAED,wEAAwE;AACxE,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGnD;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,QAAQ,CAAC,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACzC;AAED,wBAAgB,YAAY,IAAI,WAAW,CAQ1C;AAED,kFAAkF;AAClF,wBAAgB,eAAe,CAC7B,OAAO,EAAE,WAAW,EACpB,WAAW,EAAE,WAAW,EACxB,KAAK,EAAE,MAAM,GACZ,IAAI,CAGN;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,WAAW,EACpB,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,SAAS,WAAW,EAAE,GAC3B,IAAI,CAUN;AAED,4FAA4F;AAC5F,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAMzF;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAexD;AAED,iFAAiF;AACjF,wBAAgB,KAAK,CAAC,IAAI,EAAE,SAAS,WAAW,EAAE,EAAE,IAAI,EAAE,WAAW,GAAG,iBAAiB,EAAE,CAW1F;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,SAAS,WAAW,EAAE,EAC5B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,WAAW,EACjB,UAAU,EAAE,MAAM,GACjB,MAAM,CAWR"}