@maxhealth.tech/prefab 0.3.9 → 0.3.11

package/dist/a2ui/control.js

@@ -0,0 +1,107 @@
+/**
+ * Control-flow mappers — `ForEach`, `Define`/`Use`/`Slot`, and the conditionals.
+ *
+ * These are the prefab components with no A2UI component of their own, and they
+ * split three ways. `ForEach` has an A2UI *mechanism* rather than a component:
+ * the child template, the same construct `./table.ts` uses for `DataTable`.
+ * `Define`/`Use`/`Slot` need no A2UI concept at all, because a definition can be
+ * expanded before the payload is sent.
+ *
+ * Conditionals are the exception, and the one genuine capability gap between the
+ * two protocols. A2UI has no declarative `if`: the renderer draws what the
+ * adjacency list says, and the agent sends a fresh `updateComponents` when the
+ * shape should change. prefab runs a reactive client that re-shapes itself
+ * without a round trip. Faking it — emitting a one-item list template as a
+ * pretend conditional — would produce a UI that is wrong in a way nothing
+ * reports, so it is diagnosed instead.
+ */
+import { escapePointerToken } from './expr.js';
+/** Read the first present scalar prop from a node. */
+function textOf(node, ...keys) {
+    for (const k of keys) {
+        const v = node[k];
+        if (typeof v === 'string' || typeof v === 'number' || typeof v === 'boolean')
+            return String(v);
+    }
+    return undefined;
+}
+/** Narrow an unknown `slots` prop to the shape the renderer expects. */
+function isNodeMap(value) {
+    return value != null && typeof value === 'object' && !Array.isArray(value);
+}
+export const CONTROL_MAPPERS = {
+    ForEach: (node, ctx) => {
+        const expression = textOf(node, 'expression');
+        if (expression == null) {
+            ctx.note('unsupported', 'ForEach', 'no expression to iterate');
+            return undefined;
+        }
+        const bound = ctx.bind(expression);
+        if (bound.kind !== 'binding') {
+            ctx.note('expression', 'ForEach', `"${expression}" is not a plain path, so there is no list to bind`);
+            return undefined;
+        }
+        // Inside the template, `$item` is the current row and paths are relative to
+        // it, which is exactly how A2UI resolves a template's bindings.
+        const template = ctx.inScope({ $item: '', $index: '' }, () => ctx.single(node.children));
+        if (template == null) {
+            ctx.note('unsupported', 'ForEach', 'the loop body had nothing to render');
+            return undefined;
+        }
+        return { component: 'Column', children: { path: bound.value.path, componentId: template } };
+    },
+    // A definition is a template, not content. The renderer draws nothing at the
+    // point of definition, and neither does this.
+    Define: () => undefined,
+    Use: (node, ctx) => {
+        const name = textOf(node, 'def', 'name');
+        if (name == null) {
+            ctx.note('unsupported', 'Use', 'no definition name');
+            return undefined;
+        }
+        const body = ctx.definition(name);
+        if (body == null) {
+            ctx.note('unsupported', 'Use', `no definition named "${name}" was declared`);
+            return undefined;
+        }
+        // Overrides are the definition's parameters. They are seeded into the data
+        // model and brought into scope by name, so a `{{ title }}` inside the body
+        // reads this call's value rather than whatever sits at the model root.
+        const overrides = node.overrides;
+        const scope = {};
+        if (overrides != null && typeof overrides === 'object' && !Array.isArray(overrides)) {
+            const root = ctx.bindData(`use_${name}`, overrides);
+            for (const key of Object.keys(overrides)) {
+                scope[key] = `${root}/${escapePointerToken(key)}`;
+            }
+        }
+        const slots = {
+            ...(isNodeMap(node.slots) ? node.slots : {}),
+            ...(Array.isArray(node.children) && node.children.length > 0 ? { default: node.children } : {}),
+        };
+        const inlined = ctx.expand(name, () => ctx.inScope(scope, () => ctx.withSlots(slots, () => ctx.single(body))));
+        if (inlined == null) {
+            ctx.note('unsupported', 'Use', `definition "${name}" rendered nothing`);
+            return undefined;
+        }
+        return { component: 'Column', children: [inlined] };
+    },
+    Slot: (node, ctx) => {
+        const name = textOf(node, 'name') ?? 'default';
+        // Slot content from the enclosing Use, or the slot's own fallback children.
+        const content = ctx.slotContent(name) ?? (Array.isArray(node.children) ? node.children : undefined);
+        const inlined = content != null ? ctx.single(content) : undefined;
+        if (inlined == null) {
+            ctx.note('unsupported', 'Slot', `slot "${name}" had neither content nor a fallback`);
+            return undefined;
+        }
+        return { component: 'Column', children: [inlined] };
+    },
+};
+for (const type of ['If', 'Elif', 'Else', 'Condition', 'Match', 'Case']) {
+    CONTROL_MAPPERS[type] = (node, ctx) => {
+        ctx.note('unsupported', node.type, 'A2UI has no declarative conditional; the agent re-sends updateComponents when the shape changes');
+        return undefined;
+    };
+}
+//# sourceMappingURL=control.js.map

package/dist/a2ui/control.js.map

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

package/dist/a2ui/emit.d.ts

@@ -0,0 +1,59 @@
+/**
+ * `$prefab` → A2UI emitter.
+ *
+ * Walks the nested `$prefab` component tree and produces A2UI's flat adjacency
+ * list, plus the surface data model. Three invariants drive the implementation:
+ *
+ *   - **The root is named `root`.** A2UI requires exactly that id on the entry
+ *     component, so it is reserved before traversal begins rather than renamed
+ *     afterwards.
+ *   - **Ids are allocated before children are emitted.** A mapper calls back
+ *     into the context to emit its children, so the parent's slot is reserved
+ *     first and filled in once the mapper returns. Nodes that turn out to be
+ *     unmappable release their slot, which is why the components map is keyed
+ *     by id rather than being a positional array.
+ *   - **Emission is deterministic.** Ids are drawn from a counter in traversal
+ *     order, so the same tree always produces byte-identical output and can be
+ *     asserted on in tests and cached by hosts.
+ */
+import type { PrefabWireFormat } from '../app.js';
+import { type A2uiDiagnostic, type A2uiMessage } from './types.js';
+export interface A2uiEmitOptions {
+    /**
+     * Surface id. Must be unique for the renderer's lifetime.
+     * @default 'prefab'
+     */
+    surfaceId?: string;
+    /**
+     * Catalog the surface's components are drawn from.
+     * @default the A2UI Basic catalog
+     */
+    catalogId?: string;
+    /**
+     * Split the output into `createSurface` + `updateComponents` +
+     * `updateDataModel` instead of inlining everything into `createSurface`.
+     * Streaming transports want the split so the renderer can paint early; a
+     * single stored payload does not. @default false
+     */
+    stream?: boolean;
+    /** Ask the renderer to echo the data model back on every event. @default false */
+    sendDataModel?: boolean;
+    /** Log degradations and dropped nodes at warn level. @default false */
+    warn?: boolean;
+}
+/** Emitted messages plus what the translation cost. */
+export interface A2uiEmitResult {
+    messages: A2uiMessage[];
+    diagnostics: A2uiDiagnostic[];
+}
+/**
+ * Translate a `$prefab` wire payload into A2UI messages.
+ *
+ * @example
+ * ```ts
+ * const { messages, diagnostics } = emitA2UI(app.toJSON())
+ * if (diagnostics.length > 0) console.warn(diagnostics)
+ * ```
+ */
+export declare function emitA2UI(wire: PrefabWireFormat, options?: A2uiEmitOptions): A2uiEmitResult;
+//# sourceMappingURL=emit.d.ts.map

package/dist/a2ui/emit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit.d.ts","sourceRoot":"","sources":["../../src/a2ui/emit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AAIjD,OAAO,EAML,KAAK,cAAc,EAInB,KAAK,WAAW,EACjB,MAAM,YAAY,CAAA;AAInB,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,kFAAkF;IAClF,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,uEAAuE;IACvE,IAAI,CAAC,EAAE,OAAO,CAAA;CACf;AAED,uDAAuD;AACvD,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,WAAW,EAAE,CAAA;IACvB,WAAW,EAAE,cAAc,EAAE,CAAA;CAC9B;AAiWD;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,cAAc,CAG1F"}

package/dist/a2ui/emit.js

@@ -0,0 +1,373 @@
+/**
+ * `$prefab` → A2UI emitter.
+ *
+ * Walks the nested `$prefab` component tree and produces A2UI's flat adjacency
+ * list, plus the surface data model. Three invariants drive the implementation:
+ *
+ *   - **The root is named `root`.** A2UI requires exactly that id on the entry
+ *     component, so it is reserved before traversal begins rather than renamed
+ *     afterwards.
+ *   - **Ids are allocated before children are emitted.** A mapper calls back
+ *     into the context to emit its children, so the parent's slot is reserved
+ *     first and filled in once the mapper returns. Nodes that turn out to be
+ *     unmappable release their slot, which is why the components map is keyed
+ *     by id rather than being a positional array.
+ *   - **Emission is deterministic.** Ids are drawn from a counter in traversal
+ *     order, so the same tree always produces byte-identical output and can be
+ *     asserted on in tests and cached by hosts.
+ */
+import { createLogger } from '../core/logger.js';
+import { dynamicString, escapePointerToken, toBinding } from './expr.js';
+import { fallbackMapper, isConsumedByParent, mapperFor } from './catalog.js';
+import { A2UI_BASIC_CATALOG, A2UI_ROOT_ID, A2UI_VERSION, } from './types.js';
+const log = createLogger('a2ui');
+/**
+ * The wrapper `toJSON()` puts around every view. It carries a CSS class and
+ * nothing else, so it is unwrapped rather than emitted as a pointless Column.
+ */
+function unwrapAppRoot(view) {
+    const children = view.children;
+    if (view.type === 'Div'
+        && typeof view.cssClass === 'string'
+        && view.cssClass.startsWith('pf-app-root')
+        && Array.isArray(children)
+        && children.length === 1) {
+        return children[0];
+    }
+    return view;
+}
+/**
+ * Collect every `Define` in the tree.
+ *
+ * A pre-pass rather than collection during the walk, because prefab resolves a
+ * definition by name at render time and imposes no ordering: a `Use` may appear
+ * before the `Define` it refers to, and inside a different branch of the tree.
+ */
+function collectDefinitions(node, into) {
+    if (node.type === 'Define') {
+        const name = typeof node.name === 'string' ? node.name : undefined;
+        if (name != null && Array.isArray(node.children))
+            into.set(name, node.children);
+    }
+    if (Array.isArray(node.children))
+        for (const child of node.children)
+            collectDefinitions(child, into);
+}
+class Emitter {
+    warn;
+    /** Insertion-ordered; `undefined` marks a reserved slot that was released. */
+    components = new Map();
+    // A Map rather than an object literal so a rolled-back subtree's seeded keys
+    // can be removed without a dynamic delete.
+    dataModel = new Map();
+    used = new Set([A2UI_ROOT_ID]);
+    diagnostics = [];
+    definitions = new Map();
+    counter = 0;
+    /** Names in force for binding, extended while inlining a template or a definition. */
+    scope = {};
+    /** Slot content from the nearest enclosing `Use`. */
+    slots = {};
+    /**
+     * Definitions currently being expanded, so a `Use` inside its own `Define`
+     * reports a cycle instead of recursing until the stack gives out.
+     */
+    expanding = new Set();
+    constructor(warn) {
+        this.warn = warn;
+    }
+    bind(value) {
+        return toBinding(value, this.scope);
+    }
+    dyn(value) {
+        return dynamicString(value, this.scope);
+    }
+    inScope(names, fn) {
+        const previous = this.scope;
+        this.scope = { ...previous, ...names };
+        try {
+            return fn();
+        }
+        finally {
+            this.scope = previous;
+        }
+    }
+    withSlots(slots, fn) {
+        const previous = this.slots;
+        this.slots = { ...previous, ...slots };
+        try {
+            return fn();
+        }
+        finally {
+            this.slots = previous;
+        }
+    }
+    slotContent(name) {
+        return this.slots[name];
+    }
+    definition(name) {
+        if (this.expanding.has(name)) {
+            this.note('unsupported', 'Use', `definition "${name}" uses itself; A2UI has no recursive template`);
+            return undefined;
+        }
+        return this.definitions.get(name);
+    }
+    /** Track expansion depth so `definition()` can detect a cycle. */
+    expand(name, fn) {
+        this.expanding.add(name);
+        try {
+            return fn();
+        }
+        finally {
+            this.expanding.delete(name);
+        }
+    }
+    note(kind, subject, detail) {
+        this.diagnostics.push({ kind, subject, detail });
+        if (this.warn)
+            log.warn(`${kind}: ${subject} — ${detail}`);
+    }
+    /** Allocate an id, honouring an author-supplied one when it is still free. */
+    allocate(node) {
+        const preferred = typeof node?.id === 'string' && node.id.length > 0 ? node.id : undefined;
+        if (preferred != null && !this.used.has(preferred)) {
+            this.used.add(preferred);
+            return preferred;
+        }
+        let id;
+        do {
+            this.counter += 1;
+            id = `c${this.counter}`;
+        } while (this.used.has(id));
+        this.used.add(id);
+        return id;
+    }
+    push(props) {
+        const id = this.allocate();
+        this.components.set(id, { id, ...props });
+        return id;
+    }
+    bindData(key, value) {
+        let name = key;
+        let n = 0;
+        while (this.dataModel.has(name)) {
+            n += 1;
+            name = `${key}${n}`;
+        }
+        this.dataModel.set(name, value);
+        return `/${escapePointerToken(name)}`;
+    }
+    child(node) {
+        return this.emit(node, false);
+    }
+    children(nodes) {
+        if (!Array.isArray(nodes))
+            return [];
+        const ids = [];
+        for (const node of nodes) {
+            if (node == null || typeof node !== 'object')
+                continue;
+            const id = this.emit(node, false);
+            if (id != null)
+                ids.push(id);
+        }
+        return ids;
+    }
+    single(nodes) {
+        const ids = this.children(nodes);
+        if (ids.length === 0)
+            return undefined;
+        if (ids.length === 1)
+            return ids[0];
+        // A2UI's single-child slots take one id, so several children need a wrapper.
+        return this.push({ component: 'Column', children: ids });
+    }
+    action(value, subject) {
+        if (value == null)
+            return undefined;
+        if (Array.isArray(value)) {
+            if (value.length === 0)
+                return undefined;
+            if (value.length > 1) {
+                this.note('action', subject, `${value.length} actions were bound; A2UI carries one, so the rest were dropped`);
+            }
+            return this.action(value[0], subject);
+        }
+        if (typeof value !== 'object')
+            return undefined;
+        const json = value;
+        const kind = typeof json.action === 'string' ? json.action : undefined;
+        if (kind == null)
+            return undefined;
+        switch (kind) {
+            // `callTool` is the spelling the shipped examples use and the renderer
+            // accepts both, so an emitter that knew only one silently downgraded every
+            // hand-written tool call into a generic agent event.
+            case 'toolCall':
+            case 'callTool': {
+                const tool = typeof json.tool === 'string' ? json.tool : undefined;
+                if (tool == null)
+                    return undefined;
+                const context = this.eventContext(json.arguments, subject);
+                return { event: { name: tool, ...(context != null && { context }) } };
+            }
+            case 'sendMessage': {
+                const message = typeof json.message === 'string' ? json.message : '';
+                return { event: { name: 'sendMessage', context: { message } } };
+            }
+            case 'openLink': {
+                const url = typeof json.url === 'string' ? json.url : typeof json.href === 'string' ? json.href : undefined;
+                if (url == null)
+                    return undefined;
+                return { functionCall: { call: 'openUrl', args: { url } } };
+            }
+            default: {
+                // Everything else mutates renderer state, which the Basic catalog has no
+                // function for. Reporting the intent to the agent keeps the control
+                // interactive instead of dropping it for want of an action.
+                this.note('action', subject, `"${kind}" has no renderer-side equivalent; emitted as an agent event`);
+                const { action: _kind, ...rest } = json;
+                const context = this.eventContext(rest, subject);
+                return { event: { name: kind, ...(context != null && { context }) } };
+            }
+        }
+    }
+    /**
+     * Convert a prefab action's argument bag into an A2UI event context.
+     *
+     * Values go through the same `{{ }}` conversion as component props, so a
+     * `CallTool('search', { arguments: { q: '{{ query }}' } })` sends the bound
+     * value rather than shipping the uninterpolated template to the agent.
+     */
+    eventContext(value, subject) {
+        if (value == null || typeof value !== 'object' || Array.isArray(value))
+            return undefined;
+        const context = {};
+        for (const [key, raw] of Object.entries(value)) {
+            if (typeof raw === 'number' || typeof raw === 'boolean' || raw === null) {
+                context[key] = raw;
+                continue;
+            }
+            if (typeof raw !== 'string') {
+                this.note('action', subject, `argument "${key}" is not a scalar and was dropped from the event context`);
+                continue;
+            }
+            const bound = toBinding(raw);
+            if (bound.kind === 'unbindable') {
+                this.note('action', subject, `argument "${key}" uses "${bound.expression}", which A2UI cannot bind; it was dropped`);
+                continue;
+            }
+            context[key] = bound.kind === 'binding' ? bound.value : bound.value;
+        }
+        return Object.keys(context).length > 0 ? context : undefined;
+    }
+    /**
+     * Undo everything emitted since a watermark.
+     *
+     * A mapper reads its children before deciding whether it can map at all — a
+     * `Dialog` emits its body, then finds it cannot build a trigger. Without this,
+     * those children stay in the adjacency list with nothing pointing at them,
+     * which is a payload the renderer rejects for unreachability. Dropping a node
+     * has to drop its whole subtree.
+     */
+    rollback(components, dataKeys) {
+        const keys = [...this.components.keys()];
+        for (let i = components; i < keys.length; i++) {
+            this.components.delete(keys[i]);
+            if (keys[i] !== A2UI_ROOT_ID)
+                this.used.delete(keys[i]);
+        }
+        const seeded = [...this.dataModel.keys()];
+        for (let i = dataKeys; i < seeded.length; i++)
+            this.dataModel.delete(seeded[i]);
+    }
+    /** Emit one subtree. Returns the allocated id, or `undefined` if it was dropped. */
+    emit(node, isRoot) {
+        if (typeof node.type !== 'string')
+            return undefined;
+        if (isConsumedByParent(node.type)) {
+            this.note('unsupported', node.type, 'only meaningful inside its parent; emitted standalone it has no meaning');
+            return undefined;
+        }
+        const componentMark = this.components.size;
+        const dataMark = this.dataModel.size;
+        const id = isRoot ? A2UI_ROOT_ID : this.allocate(node);
+        // Reserve the slot before the mapper runs, so children emitted during
+        // mapping cannot claim this id.
+        this.components.set(id, undefined);
+        const mapper = mapperFor(node.type) ?? fallbackMapper;
+        const props = mapper(node, this);
+        if (props == null) {
+            this.rollback(componentMark, dataMark);
+            return undefined;
+        }
+        this.components.set(id, { id, ...props });
+        return id;
+    }
+    finish(wire, options) {
+        const surfaceId = options.surfaceId ?? 'prefab';
+        // Envelope-level defs first, then any `Define` in the tree, which wins on a
+        // name clash for the same reason it does in the renderer: it is nearer.
+        for (const [name, body] of Object.entries(wire.defs ?? {}))
+            this.definitions.set(name, [body]);
+        collectDefinitions(wire.view, this.definitions);
+        const rootId = this.emit(unwrapAppRoot(wire.view), true);
+        if (rootId == null) {
+            this.note('unsupported', 'view', 'nothing in the view could be expressed in A2UI; the surface is empty');
+        }
+        const components = [];
+        for (const c of this.components.values())
+            if (c != null)
+                components.push(c);
+        // prefab state and any literals seeded during mapping share one data model.
+        // State wins on a collision, since seeded keys are generated and state keys
+        // are author-chosen.
+        const dataModel = { ...Object.fromEntries(this.dataModel), ...(wire.state ?? {}) };
+        const hasData = Object.keys(dataModel).length > 0;
+        const messages = [];
+        const catalogId = options.catalogId ?? A2UI_BASIC_CATALOG;
+        if (options.stream === true) {
+            messages.push({
+                version: A2UI_VERSION,
+                createSurface: {
+                    surfaceId,
+                    catalogId,
+                    ...(options.sendDataModel === true && { sendDataModel: true }),
+                },
+            });
+            if (components.length > 0) {
+                messages.push({ version: A2UI_VERSION, updateComponents: { surfaceId, components } });
+            }
+            if (hasData) {
+                messages.push({ version: A2UI_VERSION, updateDataModel: { surfaceId, value: dataModel } });
+            }
+        }
+        else {
+            messages.push({
+                version: A2UI_VERSION,
+                createSurface: {
+                    surfaceId,
+                    catalogId,
+                    ...(options.sendDataModel === true && { sendDataModel: true }),
+                    ...(components.length > 0 && { components }),
+                    ...(hasData && { dataModel }),
+                },
+            });
+        }
+        return { messages, diagnostics: this.diagnostics };
+    }
+}
+/**
+ * Translate a `$prefab` wire payload into A2UI messages.
+ *
+ * @example
+ * ```ts
+ * const { messages, diagnostics } = emitA2UI(app.toJSON())
+ * if (diagnostics.length > 0) console.warn(diagnostics)
+ * ```
+ */
+export function emitA2UI(wire, options) {
+    const opts = options ?? {};
+    return new Emitter(opts.warn === true).finish(wire, opts);
+}
+//# sourceMappingURL=emit.js.map

package/dist/a2ui/emit.js.map

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

package/dist/a2ui/expr.d.ts

@@ -0,0 +1,91 @@
+/**
+ * `{{ }}` template → A2UI data binding.
+ *
+ * `$prefab` interpolates arbitrary expressions client-side. A2UI binds values
+ * through JSON Pointers and, for text that mixes literals with values, through
+ * the `formatString` catalog function. Between them those cover more than a
+ * plain-path conversion would suggest:
+ *
+ *   - `{{ user.name }}`        → `{ path: '/user/name' }`
+ *   - `Hi {{ name }}!`         → `{ call: 'formatString', args: { value: 'Hi ${/name}!' } }`
+ *   - `{{ p | currency:'EUR' }}` → `{ call: 'formatCurrency', args: { … } }`
+ *   - `{{ count + 1 }}`        → nothing; A2UI has no expression language
+ *
+ * What does not survive is arithmetic, conditionals, and the pipes that
+ * transform data rather than format it (see `./pipes.ts`). Those are reported as
+ * `expression` diagnostics rather than emitted as a binding that would render an
+ * empty string in someone's renderer.
+ *
+ * ## Scopes
+ *
+ * A binding is resolved against a {@link BindScope}, which is how names local to
+ * a region become pointers. Inside a list template A2UI resolves relative paths
+ * against the current item, so prefab's `$item` maps to the empty prefix; inside
+ * an inlined definition, a `Use`'s overrides map to wherever the emitter seeded
+ * them. Without this, a name that means something local would silently bind to
+ * the root of the data model and read whatever happened to be there.
+ */
+import type { A2uiDataBinding, A2uiDynamicString, A2uiFunctionCall } from './types.js';
+/**
+ * Names local to a region, mapped to the pointer they resolve to.
+ *
+ * An empty-string value means "relative to the current template item", which is
+ * how A2UI addresses fields inside a list template.
+ */
+export type BindScope = Record<string, string>;
+/**
+ * Escape one JSON Pointer reference token (RFC 6901 §3).
+ *
+ * `~` must be escaped before `/`, otherwise the `~1` produced for a slash gets
+ * re-escaped into `~01` on the second pass.
+ */
+export declare function escapePointerToken(token: string): string;
+/** Build a JSON Pointer from already-split path segments. */
+export declare function toJsonPointer(segments: string[]): string;
+/** The outcome of converting one prefab value into an A2UI dynamic value. */
+export type BindingResult = 
+/** A literal with no template in it. */
+{
+    kind: 'literal';
+    value: string;
+}
+/** A `{{ path }}` that mapped cleanly onto a JSON Pointer. */
+ | {
+    kind: 'binding';
+    value: A2uiDataBinding;
+}
+/**
+ * A value produced by a catalog function: interpolated text, or a pipe that
+ * maps onto one of A2UI's formatters. `note` carries anything the mapping
+ * cost, for the caller to report.
+ */
+ | {
+    kind: 'format';
+    value: A2uiFunctionCall;
+    note?: string;
+}
+/** The loop index, which A2UI exposes as a system function. */
+ | {
+    kind: 'index';
+    value: A2uiFunctionCall;
+}
+/** A template too rich for A2UI. `expression` is the source, for diagnostics. */
+ | {
+    kind: 'unbindable';
+    expression: string;
+};
+/**
+ * Convert a prefab string value into an A2UI dynamic value.
+ *
+ * A whole-string template over a plain path becomes a binding, one over a
+ * formatting pipe becomes a catalog-function call, mixed text becomes a
+ * `formatString` call, a string with no template passes through, and anything
+ * else is unbindable.
+ */
+export declare function toBinding(value: string, scope?: BindScope): BindingResult;
+/**
+ * Resolve a value to an `A2uiDynamicString`, or `undefined` when it cannot be
+ * expressed. Callers pair this with a diagnostic when it returns `undefined`.
+ */
+export declare function dynamicString(value: string | undefined, scope?: BindScope): A2uiDynamicString | undefined;
+//# sourceMappingURL=expr.d.ts.map