@tai42/studio-sdk 0.2.0

package/dist/schema-form/validate.js

@@ -0,0 +1,162 @@
+/**
+ * `validateAgainstSchema` — a loud, structured pre-submit check. It walks the
+ * schema against a value and returns a path-keyed `SchemaFormErrors` bag:
+ * required-presence, type/format mismatches, enum/const violations, and any
+ * `unsupported` construct (surfaced, never hidden). It never throws on a
+ * malformed value — a malformed value IS the error it reports.
+ */
+import { classifySchema } from './classify';
+import { decodedByteSize, effectiveMaxBytes, overCapMessage } from './media';
+import { scalarLabel } from './resolve';
+import { activeVariantIndex } from './union';
+const EMAIL_RE = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+const DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
+const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+function isPlainObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function joinPath(path, key) {
+    return path === '' ? key : `${path}.${key}`;
+}
+function formatError(format, value) {
+    switch (format) {
+        case 'email':
+            return EMAIL_RE.test(value) ? undefined : 'must be a valid email address';
+        case 'uri':
+        case 'uri-reference':
+            try {
+                new URL(value, 'https://base.invalid');
+                return undefined;
+            }
+            catch {
+                return 'must be a valid URI';
+            }
+        case 'uuid':
+            return UUID_RE.test(value) ? undefined : 'must be a valid UUID';
+        case 'date':
+            return DATE_RE.test(value) && !Number.isNaN(Date.parse(value))
+                ? undefined
+                : 'must be a valid date (YYYY-MM-DD)';
+        case 'date-time':
+            return Number.isNaN(Date.parse(value)) ? 'must be a valid date-time' : undefined;
+        default:
+            return undefined;
+    }
+}
+function walk(schema, value, path, root, errors, maxUploadBytes) {
+    const classified = classifySchema(schema, root);
+    if (value === null) {
+        if (!classified.nullable)
+            errors[path] = 'must not be null';
+        return;
+    }
+    const { model } = classified;
+    switch (model.kind) {
+        case 'unsupported':
+            errors[path] = `unsupported schema (${model.reason})`;
+            return;
+        case 'const':
+            if (value !== model.value)
+                errors[path] = `must equal ${scalarLabel(model.value)}`;
+            return;
+        case 'enum': {
+            const allowed = model.options.some((option) => option.value === value);
+            if (!allowed)
+                errors[path] = 'must be one of the allowed values';
+            return;
+        }
+        case 'string': {
+            if (typeof value !== 'string') {
+                errors[path] = 'must be a string';
+                return;
+            }
+            // A media-annotated string carries a byte cap; enforce it on the value's
+            // DECODED size so a value that arrived by any route is caught here too. The
+            // precedence matches the renderer: field `contentMaxBytes` → host cap →
+            // shared default.
+            if (model.media !== undefined) {
+                const cap = effectiveMaxBytes(model.media.maxBytes, maxUploadBytes);
+                const size = decodedByteSize(value);
+                if (size > cap) {
+                    errors[path] = overCapMessage('The value', size, cap);
+                    return;
+                }
+            }
+            if (value.length > 0 && model.format !== undefined) {
+                const message = formatError(model.format, value);
+                if (message !== undefined)
+                    errors[path] = message;
+            }
+            return;
+        }
+        case 'number': {
+            if (typeof value !== 'number' || Number.isNaN(value)) {
+                errors[path] = model.integer ? 'must be an integer' : 'must be a number';
+                return;
+            }
+            if (model.integer && !Number.isInteger(value))
+                errors[path] = 'must be an integer';
+            return;
+        }
+        case 'boolean':
+            if (typeof value !== 'boolean')
+                errors[path] = 'must be true or false';
+            return;
+        case 'array': {
+            if (!Array.isArray(value)) {
+                errors[path] = 'must be an array';
+                return;
+            }
+            value.forEach((item, index) => {
+                walk(model.items, item, `${path}[${String(index)}]`, root, errors, maxUploadBytes);
+            });
+            return;
+        }
+        case 'object': {
+            if (!isPlainObject(value)) {
+                errors[path] = 'must be an object';
+                return;
+            }
+            const propMap = new Map(model.properties);
+            for (const [name, propSchema] of model.properties) {
+                const childPath = joinPath(path, name);
+                const childValue = value[name];
+                if (childValue === undefined) {
+                    if (model.required.has(name))
+                        errors[childPath] = `"${name}" is required`;
+                    continue;
+                }
+                walk(propSchema, childValue, childPath, root, errors, maxUploadBytes);
+            }
+            // Required keys naming a property that somehow isn't declared still count.
+            for (const name of model.required) {
+                if (!propMap.has(name) && value[name] === undefined) {
+                    errors[joinPath(path, name)] = `"${name}" is required`;
+                }
+            }
+            return;
+        }
+        case 'union': {
+            const index = activeVariantIndex(value, model.variants, model.discriminator, root);
+            const variant = index === -1 ? undefined : model.variants[index];
+            if (variant === undefined) {
+                errors[path] = 'does not match any allowed variant';
+                return;
+            }
+            walk(variant.schema, value, path, root, errors, maxUploadBytes);
+            return;
+        }
+    }
+}
+/**
+ * Validate `value` against `schema`, returning a per-path error bag (empty =
+ * valid). The caller runs this before submit and feeds the result back to
+ * `SchemaForm` for display. `options.maxUploadBytes` mirrors the renderer's
+ * `maxUploadBytes` prop so a media field's byte cap is enforced identically here.
+ */
+export function validateAgainstSchema(schema, value, options) {
+    const errors = {};
+    walk(schema, value, '', schema, errors, options?.maxUploadBytes);
+    return errors;
+}
+//# sourceMappingURL=validate.js.map

package/dist/schema-form/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../src/schema-form/validate.ts"],"names":[],"mappings":"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"}

package/dist/structured-output/StructuredOutput.d.ts

@@ -0,0 +1,27 @@
+/**
+ * `StructuredOutput` — the READ-ONLY output side of the schema-driven system:
+ * it renders a tool's `structured_content` THROUGH its declared MCP
+ * `output_schema` (property titles + declared order), and falls back to a raw
+ * `JsonTree` when the tool declares no output schema (or the content does not
+ * match an object schema).
+ *
+ * Reusable by any feature/plugin run surface. SAFETY: every schema-derived and
+ * content-derived value renders as React TEXT (through `JsonTree` / plain text
+ * nodes), so a payload carrying markup is escaped, never interpreted.
+ */
+import type { ReactNode } from 'react';
+import type { JsonSchema } from '../schema-form/types';
+export interface StructuredOutputProps {
+    /** The tool's declared MCP output schema, if any. */
+    readonly schema?: JsonSchema;
+    /** The `structured_content` the tool returned. */
+    readonly content: unknown;
+}
+/**
+ * Render `content` through `schema`. An object schema drives a labeled,
+ * ordered field list (each value shown with a `JsonTree`); anything else — no
+ * schema, a non-object schema, or content that is not a matching object —
+ * renders the raw content through a single `JsonTree`.
+ */
+export declare function StructuredOutput({ schema, content }: StructuredOutputProps): ReactNode;
+//# sourceMappingURL=StructuredOutput.d.ts.map

package/dist/structured-output/StructuredOutput.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StructuredOutput.d.ts","sourceRoot":"","sources":["../../src/structured-output/StructuredOutput.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAIvC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD,MAAM,WAAW,qBAAqB;IACpC,qDAAqD;IACrD,QAAQ,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC;IAC7B,kDAAkD;IAClD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAoBD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,qBAAqB,GAAG,SAAS,CAgCtF"}

package/dist/structured-output/StructuredOutput.js

@@ -0,0 +1,41 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { JsonTree } from '../components/json-tree';
+import { resolveRef } from '../schema-form/resolve';
+/** The pane's name when the payload has no schema to name it by. */
+const RAW_OUTPUT_LABEL = 'Structured output';
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function isObjectSchema(schema, root) {
+    if (!schema || !root)
+        return false;
+    const resolved = schema.$ref ? resolveRef(schema, root) : schema;
+    const type = resolved.type;
+    const isObject = type === 'object' || (Array.isArray(type) && type.includes('object'));
+    return isObject && isRecord(resolved.properties);
+}
+/**
+ * Render `content` through `schema`. An object schema drives a labeled,
+ * ordered field list (each value shown with a `JsonTree`); anything else — no
+ * schema, a non-object schema, or content that is not a matching object —
+ * renders the raw content through a single `JsonTree`.
+ */
+export function StructuredOutput({ schema, content }) {
+    if (!isObjectSchema(schema, schema) || !isRecord(content)) {
+        return (
+        // A deeply nested payload outruns its column; the tree's own pane scrolls
+        // it and is a keyboard target only while it actually does.
+        _jsx("div", { "data-testid": "structured-output-raw", children: _jsx(JsonTree, { data: content, defaultExpanded: true, label: RAW_OUTPUT_LABEL }) }));
+    }
+    // `schema` is narrowed to a defined object schema here.
+    const resolved = schema.$ref ? resolveRef(schema, schema) : schema;
+    // `isObjectSchema` guarantees `properties` is a record; the fallback only
+    // satisfies the optional type.
+    const properties = resolved.properties ?? {};
+    return (_jsx("div", { className: "tai-stack tai-stack-2", "data-testid": "structured-output", children: Object.entries(properties).map(([key, propSchema]) => {
+            const field = propSchema.$ref ? resolveRef(propSchema, schema) : propSchema;
+            const name = field.title ?? key;
+            return (_jsxs("div", { className: "tai-field", children: [_jsx("span", { className: "tai-field-label", children: name }), _jsx(JsonTree, { data: content[key], defaultExpanded: true, label: name })] }, key));
+        }) }));
+}
+//# sourceMappingURL=StructuredOutput.js.map

package/dist/structured-output/StructuredOutput.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StructuredOutput.js","sourceRoot":"","sources":["../../src/structured-output/StructuredOutput.tsx"],"names":[],"mappings":";AAaA,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAUpD,oEAAoE;AACpE,MAAM,gBAAgB,GAAG,mBAAmB,CAAC;AAE7C,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,cAAc,CACrB,MAA8B,EAC9B,IAA4B;IAE5B,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IACnC,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IACjE,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC;IAC3B,MAAM,QAAQ,GAAG,IAAI,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;IACvF,OAAO,QAAQ,IAAI,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;AACnD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,EAAE,MAAM,EAAE,OAAO,EAAyB;IACzE,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAC1D,OAAO;QACL,0EAA0E;QAC1E,2DAA2D;QAC3D,6BAAiB,uBAAuB,YACtC,KAAC,QAAQ,IAAC,IAAI,EAAE,OAAO,EAAE,eAAe,QAAC,KAAK,EAAE,gBAAgB,GAAI,GAChE,CACP,CAAC;IACJ,CAAC;IAED,wDAAwD;IACxD,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IACnE,0EAA0E;IAC1E,+BAA+B;IAC/B,MAAM,UAAU,GAAG,QAAQ,CAAC,UAAU,IAAI,EAAE,CAAC;IAE7C,OAAO,CACL,cAAK,SAAS,EAAC,uBAAuB,iBAAa,mBAAmB,YACnE,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,UAAU,CAAC,EAAE,EAAE;YACpD,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;YAC5E,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,IAAI,GAAG,CAAC;YAChC,OAAO,CACL,eAAe,SAAS,EAAC,WAAW,aAClC,eAAM,SAAS,EAAC,iBAAiB,YAAE,IAAI,GAAQ,EAE/C,KAAC,QAAQ,IAAC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,eAAe,QAAC,KAAK,EAAE,IAAI,GAAI,KAHrD,GAAG,CAIP,CACP,CAAC;QACJ,CAAC,CAAC,GACE,CACP,CAAC;AACJ,CAAC"}

package/dist/testing.d.ts

@@ -0,0 +1,80 @@
+/** Test-only registry reset, used to clear module-level state between cases; never shipped to the browser. */
+export { __resetContributions } from './plugin/registry';
+/** Test-only plugin host-state reset, cleared between cases beside the registry reset. */
+export { __resetPluginHostState } from './plugin/host-state';
+/**
+ * Fires every live `ResizeObserver` stub's callback for the elements it is
+ * observing. Pair it with `setElementOverflow` to drive a component that
+ * measures itself (`ScrollRegion` and `useProseScrollRegions` re-read
+ * `scrollWidth`/`clientWidth` from their observer callbacks):
+ *
+ *     setElementOverflow(region, true);
+ *     flushResizeObservers();
+ *
+ * Only meaningful once `installJsdomStubs` has installed the stub; with a real
+ * `ResizeObserver` present (a browser environment) there is nothing to flush.
+ */
+export declare function flushResizeObservers(): void;
+/**
+ * Delivers a resize for ONE element, to every stub observing it — the narrow
+ * form of {@link flushResizeObservers}. Use it to prove which element a
+ * component is watching: a measurement driven by a resize of a CHILD only
+ * arrives if that child is observed, so the assertion fails the moment a
+ * component narrows its observation to its own box.
+ *
+ * @param target - the element whose resize to deliver.
+ */
+export declare function flushResizeObserversFor(target: Element): void;
+/**
+ * Makes `element` report itself as horizontally overflowing (or not). jsdom runs
+ * no layout, so `scrollWidth` and `clientWidth` are both 0 and every
+ * overflow test reads as "fits"; this shadows the prototype getters with own,
+ * configurable values so a test can drive either state. Call it again with the
+ * opposite flag to flip the element back.
+ *
+ * @param element - the element whose scroll metrics to fake.
+ * @param overflowing - true to report content wider than the box.
+ */
+export declare function setElementOverflow(element: HTMLElement, overflowing: boolean): void;
+/**
+ * jsdom omits a handful of browser APIs the Studio components reach for while a
+ * test drives them. Installing every stub in one place keeps each feature's
+ * `test-setup.ts` identical and lets interaction tests exercise the real
+ * components instead of mocking them out:
+ *
+ * - Radix primitives observe element size (`ResizeObserver`), scroll the active
+ *   item into view, and capture the pointer while opening.
+ * - Export/download paths create and revoke object URLs.
+ * - File-import flows read the picked file via `Blob.text()`.
+ * - Router scroll restoration calls `scrollTo` on navigation.
+ *
+ * The `ResizeObserver` stub is a WORKING observer, not an inert one: it keeps a
+ * registry of the observers still in use, delivers an entry to the callback as
+ * each element is observed (as a real observer does for its initial
+ * observation), and lets a test re-deliver on demand via
+ * `flushResizeObservers`. Components that size themselves — `ScrollRegion` and
+ * `useProseScrollRegions` — are therefore exercised for real, with
+ * `setElementOverflow` supplying the scroll metrics jsdom cannot compute.
+ *
+ * Each stub only fills a MISSING API, so installing the whole set everywhere is
+ * harmless — the one exception is `window.scrollTo`, which jsdom ships as a "Not
+ * implemented" stub that logs loudly on every navigation, so it is replaced
+ * unconditionally. Call once from a package's Vitest `setupFiles` entry.
+ */
+export declare function installJsdomStubs(): void;
+/**
+ * A promise whose settlement the test controls, returned alongside its own
+ * `resolve`/`reject`. It pins a component's loading state for assertion: hand the
+ * unsettled `promise` to the code under test (e.g. as a mocked api call's return
+ * value), assert the in-flight UI while it hangs, then call `resolve`/`reject` to
+ * drive the success or failure branch and assert the settled UI. Each call
+ * returns a fresh, independent deferred.
+ *
+ * @typeParam T - the value the promise resolves to.
+ */
+export declare function deferred<T>(): {
+    promise: Promise<T>;
+    resolve: (value: T) => void;
+    reject: (reason: unknown) => void;
+};
+//# sourceMappingURL=testing.d.ts.map

package/dist/testing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":"AAAA,8GAA8G;AAC9G,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,0FAA0F;AAC1F,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAiC7D;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAK3C;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAK7D;AAMD;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,GAAG,IAAI,CAMnF;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CA4FxC;AAED;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,CAAC,KAAK;IAC7B,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IACpB,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;IAC5B,MAAM,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;CACnC,CAQA"}

package/dist/testing.js

@@ -0,0 +1,207 @@
+/** Test-only registry reset, used to clear module-level state between cases; never shipped to the browser. */
+export { __resetContributions } from './plugin/registry';
+/** Test-only plugin host-state reset, cleared between cases beside the registry reset. */
+export { __resetPluginHostState } from './plugin/host-state';
+const liveResizeObservers = new Set();
+/**
+ * A full `ResizeObserverEntry` shape for `target`. Radix's `useSize` reads
+ * `borderBoxSize[0].inlineSize`, so a `target`-only entry would throw there;
+ * jsdom reports zero geometry, which is exactly what a real headless observer
+ * would report for an unlaid-out element.
+ */
+function resizeObserverEntry(target) {
+    const rect = target.getBoundingClientRect();
+    const size = { inlineSize: rect.width, blockSize: rect.height };
+    return {
+        target,
+        contentRect: rect,
+        borderBoxSize: [size],
+        contentBoxSize: [size],
+        devicePixelContentBoxSize: [size],
+    };
+}
+/**
+ * Fires every live `ResizeObserver` stub's callback for the elements it is
+ * observing. Pair it with `setElementOverflow` to drive a component that
+ * measures itself (`ScrollRegion` and `useProseScrollRegions` re-read
+ * `scrollWidth`/`clientWidth` from their observer callbacks):
+ *
+ *     setElementOverflow(region, true);
+ *     flushResizeObservers();
+ *
+ * Only meaningful once `installJsdomStubs` has installed the stub; with a real
+ * `ResizeObserver` present (a browser environment) there is nothing to flush.
+ */
+export function flushResizeObservers() {
+    for (const live of [...liveResizeObservers]) {
+        if (live.targets.size === 0)
+            continue;
+        live.callback([...live.targets].map(resizeObserverEntry), live.observer);
+    }
+}
+/**
+ * Delivers a resize for ONE element, to every stub observing it — the narrow
+ * form of {@link flushResizeObservers}. Use it to prove which element a
+ * component is watching: a measurement driven by a resize of a CHILD only
+ * arrives if that child is observed, so the assertion fails the moment a
+ * component narrows its observation to its own box.
+ *
+ * @param target - the element whose resize to deliver.
+ */
+export function flushResizeObserversFor(target) {
+    for (const live of [...liveResizeObservers]) {
+        if (!live.targets.has(target))
+            continue;
+        live.callback([resizeObserverEntry(target)], live.observer);
+    }
+}
+/** The faked widths: equal reads as "fits", unequal as "scrolls". */
+const FITTING_WIDTH = 100;
+const OVERFLOWING_SCROLL_WIDTH = 400;
+/**
+ * Makes `element` report itself as horizontally overflowing (or not). jsdom runs
+ * no layout, so `scrollWidth` and `clientWidth` are both 0 and every
+ * overflow test reads as "fits"; this shadows the prototype getters with own,
+ * configurable values so a test can drive either state. Call it again with the
+ * opposite flag to flip the element back.
+ *
+ * @param element - the element whose scroll metrics to fake.
+ * @param overflowing - true to report content wider than the box.
+ */
+export function setElementOverflow(element, overflowing) {
+    Object.defineProperty(element, 'clientWidth', { configurable: true, value: FITTING_WIDTH });
+    Object.defineProperty(element, 'scrollWidth', {
+        configurable: true,
+        value: overflowing ? OVERFLOWING_SCROLL_WIDTH : FITTING_WIDTH,
+    });
+}
+/**
+ * jsdom omits a handful of browser APIs the Studio components reach for while a
+ * test drives them. Installing every stub in one place keeps each feature's
+ * `test-setup.ts` identical and lets interaction tests exercise the real
+ * components instead of mocking them out:
+ *
+ * - Radix primitives observe element size (`ResizeObserver`), scroll the active
+ *   item into view, and capture the pointer while opening.
+ * - Export/download paths create and revoke object URLs.
+ * - File-import flows read the picked file via `Blob.text()`.
+ * - Router scroll restoration calls `scrollTo` on navigation.
+ *
+ * The `ResizeObserver` stub is a WORKING observer, not an inert one: it keeps a
+ * registry of the observers still in use, delivers an entry to the callback as
+ * each element is observed (as a real observer does for its initial
+ * observation), and lets a test re-deliver on demand via
+ * `flushResizeObservers`. Components that size themselves — `ScrollRegion` and
+ * `useProseScrollRegions` — are therefore exercised for real, with
+ * `setElementOverflow` supplying the scroll metrics jsdom cannot compute.
+ *
+ * Each stub only fills a MISSING API, so installing the whole set everywhere is
+ * harmless — the one exception is `window.scrollTo`, which jsdom ships as a "Not
+ * implemented" stub that logs loudly on every navigation, so it is replaced
+ * unconditionally. Call once from a package's Vitest `setupFiles` entry.
+ */
+export function installJsdomStubs() {
+    if (typeof globalThis.ResizeObserver !== 'function') {
+        class ResizeObserverStub {
+            #live;
+            constructor(callback) {
+                this.#live = { callback, targets: new Set(), observer: this };
+                liveResizeObservers.add(this.#live);
+            }
+            observe(target) {
+                // `disconnect()` stops observation; it does not destroy the observer, so
+                // observing again re-registers it exactly as the real API does.
+                liveResizeObservers.add(this.#live);
+                this.#live.targets.add(target);
+                this.#live.callback([resizeObserverEntry(target)], this);
+            }
+            unobserve(target) {
+                this.#live.targets.delete(target);
+            }
+            disconnect() {
+                this.#live.targets.clear();
+                liveResizeObservers.delete(this.#live);
+            }
+        }
+        globalThis.ResizeObserver = ResizeObserverStub;
+    }
+    if (typeof Element.prototype.scrollIntoView !== 'function') {
+        Element.prototype.scrollIntoView = function scrollIntoView() {
+            /* jsdom stub */
+        };
+    }
+    if (typeof Element.prototype.hasPointerCapture !== 'function') {
+        Element.prototype.hasPointerCapture = function hasPointerCapture() {
+            return false;
+        };
+    }
+    if (typeof Element.prototype.setPointerCapture !== 'function') {
+        Element.prototype.setPointerCapture = function setPointerCapture() {
+            /* jsdom stub */
+        };
+    }
+    if (typeof Element.prototype.releasePointerCapture !== 'function') {
+        Element.prototype.releasePointerCapture = function releasePointerCapture() {
+            /* jsdom stub */
+        };
+    }
+    // TanStack Router's scroll restoration calls scrollTo on every navigation.
+    // jsdom omits `Element.prototype.scrollTo`, so fill it like the others; but it
+    // DOES ship `window.scrollTo` as a "Not implemented" stub that logs loudly on
+    // every call, so that one is REPLACED unconditionally to silence the noise.
+    if (typeof Element.prototype.scrollTo !== 'function') {
+        Element.prototype.scrollTo = function scrollTo() {
+            /* jsdom stub */
+        };
+    }
+    window.scrollTo = function scrollTo() {
+        /* jsdom stub */
+    };
+    // jsdom does not implement object URLs; export/download paths create and
+    // revoke one.
+    if (typeof URL.createObjectURL !== 'function') {
+        URL.createObjectURL = () => 'blob:stub';
+    }
+    if (typeof URL.revokeObjectURL !== 'function') {
+        URL.revokeObjectURL = () => {
+            /* jsdom stub */
+        };
+    }
+    // jsdom's Blob/File omit the `text()` reader browsers ship, so file-import
+    // flows that call `file.text()` cannot run. Back it with the FileReader jsdom
+    // does provide.
+    if (typeof Blob.prototype.text !== 'function') {
+        Blob.prototype.text = function readAsText() {
+            return new Promise((resolve, reject) => {
+                const reader = new FileReader();
+                reader.onload = () => {
+                    resolve(typeof reader.result === 'string' ? reader.result : '');
+                };
+                reader.onerror = () => {
+                    reject(reader.error ?? new Error('FileReader failed'));
+                };
+                reader.readAsText(this);
+            });
+        };
+    }
+}
+/**
+ * A promise whose settlement the test controls, returned alongside its own
+ * `resolve`/`reject`. It pins a component's loading state for assertion: hand the
+ * unsettled `promise` to the code under test (e.g. as a mocked api call's return
+ * value), assert the in-flight UI while it hangs, then call `resolve`/`reject` to
+ * drive the success or failure branch and assert the settled UI. Each call
+ * returns a fresh, independent deferred.
+ *
+ * @typeParam T - the value the promise resolves to.
+ */
+export function deferred() {
+    let resolve;
+    let reject;
+    const promise = new Promise((res, rej) => {
+        resolve = res;
+        reject = rej;
+    });
+    return { promise, resolve, reject };
+}
+//# sourceMappingURL=testing.js.map

package/dist/testing.js.map

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

package/package.json

@@ -0,0 +1,101 @@
+{
+  "name": "@tai42/studio-sdk",
+  "version": "0.2.0",
+  "description": "The Studio plugin contract, shared UI components, and hooks that every feature builds on.",
+  "license": "Apache-2.0",
+  "author": "tai42 <oss@tai42.ai>",
+  "homepage": "https://tai42.ai",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/tai42ai/tai-studio",
+    "directory": "packages/studio-sdk"
+  },
+  "bugs": {
+    "url": "https://github.com/tai42ai/tai-studio/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "browserslist": [
+    "chrome >= 99",
+    "edge >= 99",
+    "firefox >= 97",
+    "safari >= 15.4",
+    "ios_saf >= 15.4"
+  ],
+  "type": "module",
+  "sideEffects": [
+    "**/*.css",
+    "./dist/index.js",
+    "./src/index.ts"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./host": {
+      "types": "./dist/host.d.ts",
+      "import": "./dist/host.js"
+    },
+    "./testing": {
+      "types": "./dist/testing.d.ts",
+      "import": "./dist/testing.js"
+    },
+    "./tokens.css": "./dist/components/tokens.css",
+    "./fonts.css": "./dist/components/fonts.css",
+    "./components.css": "./dist/components/components.css",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "LICENSE",
+    "NOTICE",
+    "SECURITY.md",
+    "dist",
+    "src",
+    "!src/**/*.test.ts",
+    "!src/**/*.test.tsx",
+    "!src/**/*.spec.ts",
+    "!src/**/*.spec.tsx",
+    "!src/**/test-*.ts",
+    "!src/**/test-*.tsx",
+    "!src/**/__snapshots__"
+  ],
+  "peerDependencies": {
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0"
+  },
+  "devDependencies": {
+    "@testing-library/jest-dom": "^6.9.1",
+    "@testing-library/react": "^16.3.2",
+    "@testing-library/user-event": "^14.6.1",
+    "@types/react": "^19.2.17",
+    "@types/react-dom": "^19.2.3",
+    "@vitejs/plugin-react": "^4.7.0",
+    "@vitest/coverage-v8": "^3.2.6",
+    "jsdom": "^25.0.1",
+    "react": "^19.2.7",
+    "react-dom": "^19.2.7",
+    "vitest": "^3.2.6"
+  },
+  "dependencies": {
+    "@fontsource-variable/geist-mono": "^5.2.7",
+    "@fontsource-variable/inter": "^5.2.8",
+    "@radix-ui/react-checkbox": "^1.3.6",
+    "@radix-ui/react-dialog": "^1.1.18",
+    "@radix-ui/react-radio-group": "^1.4.2",
+    "@radix-ui/react-select": "^2.3.2",
+    "@radix-ui/react-tabs": "^1.1.16",
+    "@radix-ui/react-tooltip": "^1.2.11",
+    "@tai42/api-client": "0.2.0"
+  },
+  "scripts": {
+    "build": "tsc -b tsconfig.build.json && node scripts/copy-assets.mjs",
+    "typecheck": "tsc -b tsconfig.build.json && tsc --noEmit -p tsconfig.json",
+    "lint": "eslint src scripts --max-warnings 0",
+    "format:check": "prettier --check \"src/**/*.{ts,tsx,css}\" \"scripts/**/*.mjs\"",
+    "test": "vitest run"
+  }
+}