@ouispec/bindings 0.0.0-stage → 0.1.1

package/dist/room.js

@@ -0,0 +1,111 @@
+/**
+ * The room catalog contract (ADR-0220 §2.3): what a room with its own editing
+ * model — the vector studio, the video editor — declares about everything a
+ * person can do in it, so the assistant's actions and knowledge are generated
+ * from the room's code rather than written by hand.
+ *
+ * The declarations are the contract's (`room-catalog-data.json`), generated
+ * from its schema: what `agent-catalog.json` holds and a generator reads. This
+ * module adds what a room runs — each action's `run`, each field's `read` and
+ * `write` — and the catalog's two derived pieces: its `problems` schema and
+ * its data.
+ *
+ * - **actions**: its operations, each carried out through the room's own
+ *   reducer and commands, with a JSON schema for the input;
+ * - **fields**: its inspector's fields, from the same definitions the
+ *   inspector renders, each with its value's schema, unit, range, its
+ *   animation and which kinds of thing it applies to;
+ * - **commands**: its keymap, each command with its keys and what it does;
+ * - **observations**: what a host reports about the room's state, including
+ *   the problems it has drawing it.
+ */
+/** Whether a field animates: its `animation`, or the `keyframeable` of a catalog written before it. */
+export function isKeyframeable(field) {
+    return field.animation?.keyframeable ?? field.keyframeable ?? false;
+}
+/**
+ * The ids of a room's two generic actions, built from the rest of its
+ * catalog so they cannot fall behind it: one sets any of its fields (its
+ * input has one property per field, under `values`), one runs any available
+ * command. A room with fields declares the first; a room with available
+ * commands declares the second.
+ */
+export const ROOM_SET_PROPERTIES_ID = 'set-properties';
+export const ROOM_RUN_COMMAND_ID = 'run-command';
+/** The id every room and page reports its problems under. */
+export const PROBLEMS_OBSERVATION_ID = 'problems';
+const PROBLEMS_DESCRIPTION = 'What is wrong that a person would see: what the page cannot show, load or do, as its banners and messages say it. ' +
+    'Empty when nothing is wrong.';
+/**
+ * The schema of a `problems` observation: a list of `RoomProblem`. Its kinds
+ * are the room's own when it declares them (`RoomCatalog.problems`).
+ */
+export function problemsSchema(kinds = []) {
+    const listed = kinds.map(k => `${k.kind} = ${k.description}`).join('; ');
+    return {
+        type: 'array',
+        description: kinds.length ? `${PROBLEMS_DESCRIPTION} Its kinds: ${listed}.` : PROBLEMS_DESCRIPTION,
+        items: {
+            type: 'object',
+            properties: {
+                kind: {
+                    type: 'string',
+                    description: 'What kind of problem it is, in the page’s own vocabulary',
+                    ...(kinds.length ? { enum: kinds.map(k => k.kind) } : {}),
+                },
+                message: { type: 'string', description: 'The words the page shows for it' },
+                hides: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Ids of what is not shown because of it',
+                },
+                resolve: {
+                    type: 'object',
+                    description: 'The action that resolves it, and the choices it offers',
+                    properties: { action: { type: 'string' }, choices: { type: 'array' } },
+                },
+                detail: { type: 'object' },
+            },
+            required: ['kind', 'message'],
+        },
+    };
+}
+/** The schema of a `problems` observation whose kinds are not declared: every page's. */
+export const PROBLEMS_SCHEMA = problemsSchema();
+/** The catalog's declarations, as `agent-catalog.json` holds them. Deterministic: entries keep the catalog's order. */
+export function catalogData(catalog) {
+    return {
+        room: catalog.room,
+        title: catalog.title,
+        description: catalog.description,
+        actions: catalog.actions.map(a => ({
+            kind: a.kind,
+            id: a.id,
+            title: a.title,
+            description: a.description,
+            control: a.control,
+            input: a.input,
+            effect: a.effect,
+            ...(a.destructive ? { destructive: true } : {}),
+        })),
+        fields: catalog.fields.map(f => ({
+            kind: f.kind,
+            id: f.id,
+            title: f.title,
+            description: f.description,
+            control: f.control,
+            section: f.section,
+            appliesTo: [...f.appliesTo],
+            value: f.value,
+            // Every reader finds `animation`; a catalog written before it keeps its
+            // `keyframeable` too, for readers of that name during the transition.
+            ...(f.animation || f.keyframeable !== undefined ? { animation: { keyframeable: isKeyframeable(f) } } : {}),
+            ...(f.keyframeable !== undefined ? { keyframeable: f.keyframeable } : {}),
+        })),
+        commands: catalog.commands.map(c => ({ ...c, keys: [...c.keys] })),
+        observations: catalog.observations.map(o => ({ ...o })),
+        ...(catalog.problems ? { problems: catalog.problems.map(p => ({ ...p })) } : {}),
+        ...(catalog.recipes ? { recipes: catalog.recipes.map(r => ({ ...r, steps: [...r.steps] })) } : {}),
+    };
+}
+//# sourceMappingURL=room.js.map

package/dist/room.js.map

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

package/dist/tier2-react.d.ts

@@ -0,0 +1,35 @@
+import type { Tier2Control } from '@ouispec/contract';
+import type { AgentProp, AgentSlots } from './binding.js';
+/**
+ * What the bound module lets JSX pass as `agent`: a binding, a `nonAgent`
+ * reason, or a composite's slots (so a tier 1 composite's own `agent` type
+ * still fits beside it). The generator holds every `agent` to the control it
+ * is on.
+ */
+export type AgentAttribute = AgentProp | AgentSlots<string>;
+/**
+ * A bound control: the third-party `component`, registered under the
+ * mapping's `kind` with the app's own callback. `name` is its export path, for
+ * messages and its display name.
+ */
+export declare function boundControl<C>(component: C, name: string, control: Tier2Control): C;
+/**
+ * A compound control (Radix `Select.Root` / `Select.Item`, Mantine `Tabs` /
+ * `Tabs.Tab`): the bound root registers the mapping's kind, and its options
+ * are the items rendered under it, each reporting its `valueProp` and title
+ * while it is mounted. Each compound has its own registry, so an item finds
+ * its own root through any other compound between them.
+ */
+export declare function boundCompound<R, I>(root: R, item: I, name: string, control: Tier2Control): {
+    root: R;
+    item: I;
+};
+/**
+ * A namespace or component with some members replaced by bound parts
+ * (`Select` with its `Root` and `Item`, or a bound `Tabs` with its `Tab`),
+ * every other member kept. A module namespace or a third-party component is
+ * never changed: a new object, or a pass-through component, carries the
+ * members.
+ */
+export declare function withMembers<B>(base: B, members: Readonly<Record<string, unknown>>): B;
+//# sourceMappingURL=tier2-react.d.ts.map

package/dist/tier2-react.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tier2-react.d.ts","sourceRoot":"","sources":["../src/tier2-react.ts"],"names":[],"mappings":"AA2BA,OAAO,KAAK,EAA8B,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAElF,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAI1D;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;AA8E5D;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,CAAC,CAOpF;AAOD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG;IAAE,IAAI,EAAE,CAAC,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,CAiD/G;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,CAAC,CAkBrF"}

package/dist/tier2-react.js

@@ -0,0 +1,186 @@
+/**
+ * The bound wrappers `oui generate` emits for a tier 2 mapping (ADR-0226
+ * §2.3) are built from these. Each wrapper accepts `agent`, registers the
+ * mapped kind with the app's own callback through `useAgentBinding`, returns
+ * that callback's result (§2.2 rule 3), reports the component's `disabled`
+ * prop, and renders the third-party component unchanged: its props, its ref,
+ * its static members.
+ *
+ * A bound export keeps the third-party component's own type, generics and
+ * polymorphism included (a wrapper type cannot add a prop to a generic call
+ * signature), and the bound module adds `agent` to JSX through
+ * `AgentAttribute`, the way a styling library adds `css`.
+ */
+import { createContext, createElement, forwardRef, isValidElement, useContext, useEffect, useMemo, useRef, useState, } from 'react';
+import { useAgentBinding } from './react.js';
+import { mappedOptions, tier2CallbackArgs } from './tier2.js';
+const BOUND = Symbol.for('oui.tier2.bound');
+/** React's own members of a component, never copied from the third-party one. */
+const REACT_MEMBERS = new Set(['$$typeof', 'render', 'type', 'compare', 'displayName', 'propTypes', 'defaultProps', 'contextTypes', 'prototype', 'length', 'name', 'caller', 'arguments']);
+/** The visible text of rendered children, nested elements included. */
+function textOf(node) {
+    if (typeof node === 'string' || typeof node === 'number')
+        return String(node);
+    if (Array.isArray(node))
+        return node.map(textOf).join(' ');
+    if (isValidElement(node))
+        return textOf(node.props.children);
+    return '';
+}
+/** The first non-empty title the named props give; `children` is the element's text. */
+function titleOf(titleProps, props) {
+    for (const prop of titleProps ?? []) {
+        const value = prop === 'children' ? textOf(props.children) : props[prop];
+        if ((typeof value === 'string' || typeof value === 'number') && String(value).trim()) {
+            return String(value).replace(/\s+/g, ' ').trim();
+        }
+    }
+    return '';
+}
+/** The props a value schema is derived from, as the mapping names them, over its defaults. */
+function schemaPropsOf(control, props, options) {
+    const out = { ...(control.defaults ?? {}) };
+    for (const [key, prop] of Object.entries(control.schemaProps ?? {})) {
+        if (typeof prop === 'string' && props[prop] !== undefined)
+            out[key] = props[prop];
+    }
+    if (options)
+        out.options = options;
+    return out;
+}
+/** One mapped control's binding, from the props the page gave it. */
+function useMappedBinding(name, control, props, agent, items) {
+    const callback = control.callbacks[0];
+    const options = items ?? (control.options ? mappedOptions(control.options, props[control.options.prop]) : null);
+    useAgentBinding({
+        agent,
+        kind: control.kind,
+        title: titleOf(control.titleProps, props),
+        schemaProps: schemaPropsOf(control, props, options),
+        value: control.controlled ? props[control.controlled] : undefined,
+        disabled: props.disabled === true,
+        run: ({ value }) => {
+            const fn = props[callback];
+            if (typeof fn !== 'function') {
+                return { ok: false, code: 'NOT_WIRED', message: `${name} was given no ${callback}, so there is nothing for it to do` };
+            }
+            return fn(...tier2CallbackArgs(control, value));
+        },
+    });
+}
+/** Props with `agent` taken out, and the ref put back when there is one. */
+function forwarded(rest, ref) {
+    return ref ? { ...rest, ref } : rest;
+}
+/** The wrapper named, marked as bound, with the third-party component's static members. */
+function finish(wrapper, original, name) {
+    wrapper.displayName = `Bound${name.replace(/\./g, '')}`;
+    Object.defineProperty(wrapper, BOUND, { value: true });
+    if (original && (typeof original === 'object' || typeof original === 'function')) {
+        for (const key of Object.getOwnPropertyNames(original)) {
+            if (REACT_MEMBERS.has(key) || key in wrapper)
+                continue;
+            const descriptor = Object.getOwnPropertyDescriptor(original, key);
+            if (descriptor)
+                Object.defineProperty(wrapper, key, descriptor);
+        }
+    }
+    return wrapper;
+}
+/**
+ * A bound control: the third-party `component`, registered under the
+ * mapping's `kind` with the app's own callback. `name` is its export path, for
+ * messages and its display name.
+ */
+export function boundControl(component, name, control) {
+    const Component = component;
+    const Bound = forwardRef(function Bound({ agent, ...rest }, ref) {
+        useMappedBinding(name, control, rest, agent, null);
+        return createElement(Component, forwarded(rest, ref));
+    });
+    return finish(Bound, component, name);
+}
+/**
+ * A compound control (Radix `Select.Root` / `Select.Item`, Mantine `Tabs` /
+ * `Tabs.Tab`): the bound root registers the mapping's kind, and its options
+ * are the items rendered under it, each reporting its `valueProp` and title
+ * while it is mounted. Each compound has its own registry, so an item finds
+ * its own root through any other compound between them.
+ */
+export function boundCompound(root, item, name, control) {
+    const part = control.parts?.item;
+    if (!part)
+        throw new Error(`${name} has no item part: bind it with boundControl`);
+    const valueProp = part.valueProp ?? 'value';
+    const itemTitleProps = part.titleProps ?? ['children'];
+    const Items = createContext(null);
+    const RootComponent = root;
+    const ItemComponent = item;
+    const BoundRoot = forwardRef(function BoundRoot({ agent, ...rest }, ref) {
+        const entries = useRef(new Map());
+        const [version, setVersion] = useState(0);
+        const registry = useMemo(() => ({
+            set: (key, option) => {
+                const current = entries.current.get(key);
+                if (current && current.value === option.value && current.title === option.title && !!current.disabled === !!option.disabled)
+                    return;
+                entries.current.set(key, option);
+                setVersion(v => v + 1);
+            },
+            delete: key => {
+                if (entries.current.delete(key))
+                    setVersion(v => v + 1);
+            },
+        }), []);
+        // Recomputed on each registration (`version`), in the order the items mounted.
+        const items = useMemo(() => [...entries.current.values()], [version]);
+        useMappedBinding(name, control, rest, agent, items);
+        return createElement(Items.Provider, { value: registry }, createElement(RootComponent, forwarded(rest, ref)));
+    });
+    const BoundItem = forwardRef(function BoundItem(props, ref) {
+        const registry = useContext(Items);
+        const key = useRef({}).current;
+        const value = props[valueProp];
+        const title = titleOf(itemTitleProps, props) || (typeof value === 'string' || typeof value === 'number' ? String(value) : '');
+        const disabled = props.disabled === true;
+        useEffect(() => {
+            if (registry && (typeof value === 'string' || typeof value === 'number'))
+                registry.set(key, { value, title, ...(disabled ? { disabled } : {}) });
+        }, [registry, key, value, title, disabled]);
+        useEffect(() => () => registry?.delete(key), [registry, key]);
+        return createElement(ItemComponent, forwarded(props, ref));
+    });
+    return {
+        root: finish(BoundRoot, root, `${name}.root`),
+        item: finish(BoundItem, item, `${name}.item`),
+    };
+}
+/**
+ * A namespace or component with some members replaced by bound parts
+ * (`Select` with its `Root` and `Item`, or a bound `Tabs` with its `Tab`),
+ * every other member kept. A module namespace or a third-party component is
+ * never changed: a new object, or a pass-through component, carries the
+ * members.
+ */
+export function withMembers(base, members) {
+    let target;
+    if (typeof base === 'function' || (base && typeof base === 'object' && '$$typeof' in base)) {
+        if (base[BOUND])
+            target = base;
+        else {
+            const Component = base;
+            const PassThrough = forwardRef(function PassThrough(props, ref) {
+                return createElement(Component, forwarded(props, ref));
+            });
+            target = finish(PassThrough, base, 'Namespace');
+        }
+    }
+    else {
+        target = { ...base };
+    }
+    for (const [key, value] of Object.entries(members)) {
+        Object.defineProperty(target, key, { value, enumerable: true, configurable: true, writable: true });
+    }
+    return target;
+}
+//# sourceMappingURL=tier2-react.js.map

package/dist/tier2-react.js.map

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

package/dist/tier2.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Tier 2 (ADR-0226 §2.3): what a mapping of a third-party design system
+ * means, as the generator reads it and the bound wrappers run it.
+ *
+ * - `tier2ControlTable`: the control table a mapping makes, which the bound
+ *   module ships and the generator reads exactly as it reads a tier 1 table.
+ * - `tier2Parts`: where a control's root and items are exported.
+ * - `mappedOptions`: a control's options from the prop its mapping names.
+ * - `tier2CallbackArgs`: the arguments the app's callback gets when the
+ *   assistant sets a value, built from `valueFrom`.
+ *
+ * Pure and dependency-free: the generator reads it in plain Node, and the
+ * React wrappers (`@ouispec/bindings/react`) run the same code.
+ */
+import type { ControlDescriptor, ControlOption, ControlTableFile, OptionsSource, Tier2Control, Tier2Mapping } from '@ouispec/contract';
+/** Whether a mapped control's binding runs with a value. */
+export declare function tier2TakesValue(control: Tier2Control): boolean;
+/**
+ * Where a mapped control is exported: its root (the export that takes the
+ * callbacks; the control's own name when it has no parts) and, for a compound
+ * control, its item. Each is an export of the package or one member of one.
+ */
+export declare function tier2Parts(name: string, control: Tier2Control): {
+    root: string;
+    item?: string;
+};
+/**
+ * How the generator reads one mapped control where a page uses it: its
+ * mapping as a control table entry. A tabs or dialog control whose mapping
+ * names the prop that shows it is a container of that state, as a tier 1
+ * table declares one, so what it shows is reached through it.
+ */
+export declare function tier2Descriptor(control: Tier2Control): ControlDescriptor;
+/** The control table a mapping makes: one entry per mapped control, under its name. */
+export declare function tier2ControlTable(mapping: Tier2Mapping): ControlTableFile;
+/**
+ * A control's options from the value of the prop its mapping names: each
+ * entry an object with the named value and title keys, a string or number
+ * (its own title), or a group (an object with an `items` array of entries,
+ * and no value of its own). `null` when any entry cannot be read, so a
+ * schema is never narrower than the control.
+ */
+export declare function mappedOptions(source: OptionsSource, raw: unknown): ControlOption[] | null;
+/**
+ * What a binding hands a callback where the third-party component would hand
+ * it an event: shaped like one, so a handler that calls `preventDefault`
+ * runs, and `isTrusted: false`, as for any event a script makes.
+ */
+export interface AgentEvent {
+    readonly type: 'oui-agent';
+    readonly isTrusted: false;
+    readonly defaultPrevented: boolean;
+    preventDefault(): void;
+    stopPropagation(): void;
+    persist(): void;
+    [key: string]: unknown;
+}
+/** A fresh event-shaped argument (`AgentEvent`). */
+export declare function agentEvent(): AgentEvent;
+/**
+ * The arguments the app's callback gets when the assistant runs a mapped
+ * control. A control that takes a value gets it where `valueFrom` says the
+ * third-party component puts it: at its argument position, or at `path`
+ * inside an event-shaped argument there; every argument before it is an
+ * event-shaped argument. A button or a dialog gets one event-shaped argument.
+ */
+export declare function tier2CallbackArgs(control: Tier2Control, value: unknown): unknown[];
+//# sourceMappingURL=tier2.d.ts.map

package/dist/tier2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tier2.d.ts","sourceRoot":"","sources":["../src/tier2.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,gBAAgB,EAAE,aAAa,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAKvI,4DAA4D;AAC5D,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAE9D;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAE/F;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,iBAAiB,CAcxE;AAED,uFAAuF;AACvF,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,YAAY,GAAG,gBAAgB,CAIzE;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,EAAE,OAAO,GAAG,aAAa,EAAE,GAAG,IAAI,CA0BzF;AAED;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,KAAK,CAAC;IAC1B,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC,cAAc,IAAI,IAAI,CAAC;IACvB,eAAe,IAAI,IAAI,CAAC;IACxB,OAAO,IAAI,IAAI,CAAC;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,oDAAoD;AACpD,wBAAgB,UAAU,IAAI,UAAU,CAcvC;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,EAAE,CAsBlF"}

package/dist/tier2.js

@@ -0,0 +1,129 @@
+/** The kinds that take no value, so their mapping needs no `valueFrom`. */
+const VALUELESS = new Set(['button', 'dialog']);
+/** Whether a mapped control's binding runs with a value. */
+export function tier2TakesValue(control) {
+    return !VALUELESS.has(control.kind);
+}
+/**
+ * Where a mapped control is exported: its root (the export that takes the
+ * callbacks; the control's own name when it has no parts) and, for a compound
+ * control, its item. Each is an export of the package or one member of one.
+ */
+export function tier2Parts(name, control) {
+    return { root: control.parts?.root.export ?? name, ...(control.parts?.item ? { item: control.parts.item.export } : {}) };
+}
+/**
+ * How the generator reads one mapped control where a page uses it: its
+ * mapping as a control table entry. A tabs or dialog control whose mapping
+ * names the prop that shows it is a container of that state, as a tier 1
+ * table declares one, so what it shows is reached through it.
+ */
+export function tier2Descriptor(control) {
+    const container = control.controlled && (control.kind === 'tabs' || control.kind === 'dialog')
+        ? { container: { kind: control.kind, stateProp: control.controlled } }
+        : {};
+    return {
+        kind: control.kind,
+        callbacks: [...control.callbacks],
+        titleProps: [...(control.titleProps ?? [])],
+        ...(control.schemaProps ? { schemaProps: { ...control.schemaProps } } : {}),
+        ...(control.options ? { options: { ...control.options } } : {}),
+        ...(control.defaults ? { defaults: { ...control.defaults } } : {}),
+        ...container,
+    };
+}
+/** The control table a mapping makes: one entry per mapped control, under its name. */
+export function tier2ControlTable(mapping) {
+    const table = {};
+    for (const [name, control] of Object.entries(mapping.controls))
+        table[name] = tier2Descriptor(control);
+    return table;
+}
+/**
+ * A control's options from the value of the prop its mapping names: each
+ * entry an object with the named value and title keys, a string or number
+ * (its own title), or a group (an object with an `items` array of entries,
+ * and no value of its own). `null` when any entry cannot be read, so a
+ * schema is never narrower than the control.
+ */
+export function mappedOptions(source, raw) {
+    if (!Array.isArray(raw))
+        return null;
+    const out = [];
+    for (const entry of raw) {
+        if (typeof entry === 'string' || typeof entry === 'number') {
+            out.push({ value: entry, title: String(entry) });
+            continue;
+        }
+        if (!entry || typeof entry !== 'object')
+            return null;
+        const rec = entry;
+        const value = rec[source.value];
+        if (value === undefined && Array.isArray(rec.items)) {
+            const group = mappedOptions(source, rec.items);
+            if (!group)
+                return null;
+            out.push(...group);
+            continue;
+        }
+        if (typeof value !== 'string' && typeof value !== 'number')
+            return null;
+        const title = rec[source.title];
+        out.push({
+            value,
+            title: typeof title === 'string' && title.trim() ? title : String(value),
+            ...(rec.disabled === true ? { disabled: true } : {}),
+        });
+    }
+    return out;
+}
+/** A fresh event-shaped argument (`AgentEvent`). */
+export function agentEvent() {
+    let prevented = false;
+    return {
+        type: 'oui-agent',
+        isTrusted: false,
+        get defaultPrevented() {
+            return prevented;
+        },
+        preventDefault() {
+            prevented = true;
+        },
+        stopPropagation() { },
+        persist() { },
+    };
+}
+/**
+ * The arguments the app's callback gets when the assistant runs a mapped
+ * control. A control that takes a value gets it where `valueFrom` says the
+ * third-party component puts it: at its argument position, or at `path`
+ * inside an event-shaped argument there; every argument before it is an
+ * event-shaped argument. A button or a dialog gets one event-shaped argument.
+ */
+export function tier2CallbackArgs(control, value) {
+    if (!tier2TakesValue(control) || !control.valueFrom)
+        return [agentEvent()];
+    const { arg, path } = control.valueFrom;
+    const args = [];
+    for (let i = 0; i < arg; i++)
+        args.push(agentEvent());
+    if (!path) {
+        args.push(value);
+        return args;
+    }
+    const event = agentEvent();
+    const keys = path.split('.');
+    let node = event;
+    keys.forEach((key, i) => {
+        if (i === keys.length - 1)
+            node[key] = value;
+        else {
+            const next = {};
+            node[key] = next;
+            node = next;
+        }
+    });
+    args.push(event);
+    return args;
+}
+//# sourceMappingURL=tier2.js.map

package/dist/tier2.js.map

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

package/package.json

@@ -1,6 +1,77 @@
 {
   "name": "@ouispec/bindings",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.1",
+  "description": "Every UI capability declared once, in code (ADR-0220): the semantic binding on design-system controls, the room catalog contract, the generated manifest and knowledge, and the runtime registry that serves them as OUI surfaces",
+  "homepage": "https://github.com/wesreid/oui/tree/main/packages/bindings#readme",
+  "bugs": {
+    "url": "https://github.com/wesreid/oui/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/wesreid/oui.git",
+    "directory": "packages/bindings"
+  },
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./react": {
+      "types": "./dist/react.d.ts",
+      "import": "./dist/react.js",
+      "default": "./dist/react.js"
+    },
+    "./oui": {
+      "types": "./dist/oui.d.ts",
+      "import": "./dist/oui.js",
+      "default": "./dist/oui.js"
+    },
+    "./jsx": {
+      "types": "./dist/jsx.d.ts",
+      "import": "./dist/jsx.js",
+      "default": "./dist/jsx.js"
+    }
+  },
+  "files": [
+    "README.md",
+    "dist"
+  ],
+  "sideEffects": false,
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "@ouispec/agent-events": "^0.1.1",
+    "oui-spec": "^0.7.0",
+    "@ouispec/contract": "^0.1.0"
+  },
+  "devDependencies": {
+    "@testing-library/react": "^16",
+    "@types/react": "^19.0.0",
+    "jsdom": "^26",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "typescript": "^5.8.0",
+    "vitest": "^3.2.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit && tsc --noEmit -p tsconfig.test.json",
+    "test": "vitest run",
+    "clean": "rm -rf dist"
+  }
 }