@maxhealth.tech/prefab 0.3.9 → 0.3.11

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

@@ -0,0 +1 @@
+{"version":3,"file":"expr.d.ts","sourceRoot":"","sources":["../../src/a2ui/expr.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAoB,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAgBxG;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AAK9C;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,6DAA6D;AAC7D,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAExD;AA0CD,6EAA6E;AAC7E,MAAM,MAAM,aAAa;AACvB,wCAAwC;AACtC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE;AACpC,8DAA8D;GAC5D;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,eAAe,CAAA;CAAE;AAC7C;;;;GAIG;GACD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,gBAAgB,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE;AAC5D,+DAA+D;GAC7D;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,gBAAgB,CAAA;CAAE;AAC5C,iFAAiF;GAC/E;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAA;AA8D9C;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,SAAc,GAAG,aAAa,CAgC7E;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,GAAE,SAAc,GAAG,iBAAiB,GAAG,SAAS,CAU7G"}

package/dist/a2ui/expr.js

@@ -0,0 +1,201 @@
+/**
+ * `{{ }}` 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 { parsePipe, pipeCall } from './pipes.js';
+/** Matches a string that is exactly one `{{ … }}` template and nothing else. */
+const SOLE_TEMPLATE = /^\s*\{\{\s*(.+?)\s*\}\}\s*$/s;
+/** Matches every `{{ … }}` occurrence, for interpolating mixed text. */
+const EVERY_TEMPLATE = /\{\{\s*(.+?)\s*\}\}/g;
+/**
+ * A plain member path: `user.name`, `items.0.label`, `count`, `$item.title`.
+ *
+ * Deliberately narrow. Anything outside this shape (operators, pipes, calls,
+ * ternaries, string literals) has no A2UI equivalent.
+ */
+const PLAIN_PATH = /^\$?[A-Za-z_][\w$]*(?:\.(?:[A-Za-z_$][\w$]*|\d+))*$/;
+/** prefab's loop index. A2UI exposes the same thing as a system function. */
+const LOOP_INDEX = '$index';
+/**
+ * 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 function escapePointerToken(token) {
+    return token.replace(/~/g, '~0').replace(/\//g, '~1');
+}
+/** Build a JSON Pointer from already-split path segments. */
+export function toJsonPointer(segments) {
+    return '/' + segments.map(escapePointerToken).join('/');
+}
+/**
+ * prefab state expressions address state keys directly (`count`), but actions
+ * and docs also spell the same key as `state.count`. Both mean the root of the
+ * data model, so the prefix is stripped before the pointer is built.
+ */
+function stripStatePrefix(path) {
+    return path.startsWith('state.') ? path.slice('state.'.length) : path;
+}
+/**
+ * Resolve a member path to a JSON Pointer under `scope`.
+ *
+ * A leading segment named in the scope is replaced by its prefix; everything
+ * else resolves from the data-model root.
+ */
+function pathToPointer(expr, scope) {
+    if (!PLAIN_PATH.test(expr))
+        return undefined;
+    const segments = stripStatePrefix(expr).split('.');
+    const head = segments[0];
+    // `hasOwn` rather than a truthiness check: '' is a meaningful prefix, meaning
+    // "relative to the current template item".
+    const prefix = Object.hasOwn(scope, head) ? scope[head] : undefined;
+    if (prefix === undefined) {
+        // A `$`-prefixed name is a runtime binding prefab supplies ($event, $error,
+        // $result). Outside a scope that defines it, there is nothing to point at.
+        if (head.startsWith('$'))
+            return undefined;
+        return toJsonPointer(segments);
+    }
+    const rest = segments.slice(1);
+    if (prefix === '') {
+        // Relative to the current template item. `{{ $item }}` alone has no field to
+        // address, so it cannot become a pointer.
+        return rest.length === 0 ? undefined : rest.map(escapePointerToken).join('/');
+    }
+    return rest.length === 0 ? prefix : `${prefix}/${rest.map(escapePointerToken).join('/')}`;
+}
+/**
+ * Escape a literal segment for a `formatString` template.
+ *
+ * `${` is the interpolation opener, so a literal one has to be escaped or the
+ * renderer reads the surrounding text as an expression.
+ */
+function escapeFormatLiteral(text) {
+    return text.replace(/\$\{/g, '\\${');
+}
+/**
+ * Convert mixed literal and template text into a `formatString` call.
+ *
+ * @returns `undefined` when any embedded expression is richer than a path, in
+ *   which case the whole string is unbindable rather than partly interpolated.
+ */
+function toFormatString(value, scope) {
+    let failed;
+    let interpolated = '';
+    let cursor = 0;
+    for (const match of value.matchAll(EVERY_TEMPLATE)) {
+        const expr = match[1].trim();
+        const pointer = pathToPointer(expr, scope);
+        if (pointer == null) {
+            failed = expr;
+            break;
+        }
+        interpolated += escapeFormatLiteral(value.slice(cursor, match.index));
+        interpolated += `\${${pointer}}`;
+        cursor = match.index + match[0].length;
+    }
+    if (failed != null)
+        return undefined;
+    interpolated += escapeFormatLiteral(value.slice(cursor));
+    return { call: 'formatString', args: { value: interpolated } };
+}
+/**
+ * Resolve a piped expression to a catalog-function call.
+ *
+ * The base must itself be a plain path or a literal, since A2UI function
+ * arguments take a value rather than an expression to evaluate.
+ */
+function toPipeCall(expr, scope) {
+    const pipe = parsePipe(expr);
+    if (pipe == null)
+        return undefined;
+    const pointer = pathToPointer(pipe.base, scope);
+    const value = pointer != null
+        ? { path: pointer }
+        : /^-?\d+(\.\d+)?$/.test(pipe.base) ? Number(pipe.base) : undefined;
+    if (value === undefined)
+        return undefined;
+    const mapped = pipeCall(pipe, value);
+    if (mapped == null)
+        return undefined;
+    return { kind: 'format', value: mapped.call, ...(mapped.note != null && { note: mapped.note }) };
+}
+/**
+ * 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 function toBinding(value, scope = {}) {
+    const sole = SOLE_TEMPLATE.exec(value);
+    // The capture is lazy but still spans `}} … {{`, so `{{ a }} of {{ b }}`
+    // matches as one template whose body is `a }} of {{ b`. Rejecting a capture
+    // that contains delimiters sends those strings down the interpolation path,
+    // which is where they belong.
+    const isSole = sole != null && !sole[1].includes('{{') && !sole[1].includes('}}');
+    if (isSole) {
+        const expr = sole[1].trim();
+        if (expr === LOOP_INDEX && LOOP_INDEX in scope) {
+            return { kind: 'index', value: { call: '@index' } };
+        }
+        const pointer = pathToPointer(expr, scope);
+        if (pointer != null)
+            return { kind: 'binding', value: { path: pointer } };
+        // A pipe is not part of A2UI's expression language, but the common
+        // formatting ones exist in its catalog as functions.
+        const piped = toPipeCall(expr, scope);
+        if (piped != null)
+            return piped;
+        return { kind: 'unbindable', expression: expr };
+    }
+    if (!value.includes('{{'))
+        return { kind: 'literal', value };
+    const format = toFormatString(value, scope);
+    if (format != null)
+        return { kind: 'format', value: format };
+    return { kind: 'unbindable', expression: value };
+}
+/**
+ * Resolve a value to an `A2uiDynamicString`, or `undefined` when it cannot be
+ * expressed. Callers pair this with a diagnostic when it returns `undefined`.
+ */
+export function dynamicString(value, scope = {}) {
+    if (value == null)
+        return undefined;
+    const r = toBinding(value, scope);
+    switch (r.kind) {
+        case 'literal': return r.value;
+        case 'binding': return r.value;
+        case 'format': return r.value;
+        case 'index': return r.value;
+        default: return undefined;
+    }
+}
+//# sourceMappingURL=expr.js.map

package/dist/a2ui/expr.js.map

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

package/dist/a2ui/icons.d.ts

@@ -0,0 +1,30 @@
+/**
+ * prefab icon name → A2UI Basic catalog icon.
+ *
+ * The one place where the two catalogs disagree on *values* rather than on
+ * component shape. prefab's `Icon(name)` takes any string, because its renderer
+ * resolves Lucide names at runtime and new icons cost nothing. A2UI's
+ * `Icon.name` is a closed enum of 59 names, so an unrecognised value does not
+ * render as a fallback glyph — it makes the whole component fail validation.
+ *
+ * Passing the name through unchecked therefore emits an invalid surface for
+ * every icon outside those 59, which is most of them. Instead the name is
+ * normalised, matched against the enum, and dropped with a diagnostic when
+ * nothing fits, so an unmappable icon costs a glyph rather than the payload.
+ */
+/**
+ * The A2UI Basic catalog's `Icon.name` enum, v1.0.
+ *
+ * Duplicated as a literal because prefab ships zero runtime dependencies and
+ * cannot read the catalog JSON at emit time. `test/a2ui-icons.test.ts` asserts
+ * this matches the vendored catalog exactly, so it cannot drift silently.
+ */
+export declare const A2UI_ICONS: readonly string[];
+/**
+ * Resolve a prefab icon name to an A2UI one.
+ *
+ * @returns the catalog name, or `undefined` when nothing in the enum means the
+ *   same thing. Callers drop the icon and record a diagnostic.
+ */
+export declare function a2uiIconName(name: string): string | undefined;
+//# sourceMappingURL=icons.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"icons.d.ts","sourceRoot":"","sources":["../../src/a2ui/icons.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,EAAE,SAAS,MAAM,EAUvC,CAAA;AAiDD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG7D"}

package/dist/a2ui/icons.js

@@ -0,0 +1,87 @@
+/**
+ * prefab icon name → A2UI Basic catalog icon.
+ *
+ * The one place where the two catalogs disagree on *values* rather than on
+ * component shape. prefab's `Icon(name)` takes any string, because its renderer
+ * resolves Lucide names at runtime and new icons cost nothing. A2UI's
+ * `Icon.name` is a closed enum of 59 names, so an unrecognised value does not
+ * render as a fallback glyph — it makes the whole component fail validation.
+ *
+ * Passing the name through unchecked therefore emits an invalid surface for
+ * every icon outside those 59, which is most of them. Instead the name is
+ * normalised, matched against the enum, and dropped with a diagnostic when
+ * nothing fits, so an unmappable icon costs a glyph rather than the payload.
+ */
+/**
+ * The A2UI Basic catalog's `Icon.name` enum, v1.0.
+ *
+ * Duplicated as a literal because prefab ships zero runtime dependencies and
+ * cannot read the catalog JSON at emit time. `test/a2ui-icons.test.ts` asserts
+ * this matches the vendored catalog exactly, so it cannot drift silently.
+ */
+export const A2UI_ICONS = [
+    'accountCircle', 'add', 'arrowBack', 'arrowForward', 'attachFile', 'calendarToday',
+    'call', 'camera', 'check', 'close', 'delete', 'download', 'edit', 'event', 'error',
+    'fastForward', 'favorite', 'favoriteOff', 'folder', 'help', 'home', 'info',
+    'locationOn', 'lock', 'lockOpen', 'mail', 'menu', 'moreVert', 'moreHoriz',
+    'notificationsOff', 'notifications', 'pause', 'payment', 'person', 'phone', 'photo',
+    'play', 'print', 'refresh', 'rewind', 'search', 'send', 'settings', 'share',
+    'shoppingCart', 'skipNext', 'skipPrevious', 'star', 'starHalf', 'starOff', 'stop',
+    'upload', 'visibility', 'visibilityOff', 'volumeDown', 'volumeMute', 'volumeOff',
+    'volumeUp', 'warning',
+];
+/** Lookup by normalised form, so `Arrow-Back`, `arrow_back` and `ArrowBack` all hit. */
+const BY_NORMALISED = new Map(A2UI_ICONS.map(name => [normalise(name), name]));
+/**
+ * Names that differ between the two vocabularies rather than merely in case.
+ *
+ * prefab follows Lucide, A2UI follows Material. Where the concept exists in both
+ * under different words, the alias keeps the icon; where it does not, the entry
+ * is absent and the icon is dropped rather than mapped to something that means
+ * something else. Keys are normalised, so one entry covers every spelling.
+ */
+const ALIASES = {
+    // Status and feedback
+    alertcircle: 'error', alerttriangle: 'warning', alertoctagon: 'error',
+    xcircle: 'error', circlex: 'error', circlealert: 'error',
+    checkcircle: 'check', circlecheck: 'check', checkcircle2: 'check',
+    infocircle: 'info', circleinfo: 'info', helpcircle: 'help', circlehelp: 'help',
+    bell: 'notifications', belloff: 'notificationsOff',
+    // Navigation
+    arrowleft: 'arrowBack', arrowright: 'arrowForward',
+    chevronleft: 'arrowBack', chevronright: 'arrowForward',
+    x: 'close', plus: 'add', trash: 'delete', trash2: 'delete',
+    ellipsisvertical: 'moreVert', ellipsis: 'moreHoriz', morehorizontal: 'moreHoriz',
+    morevertical: 'moreVert',
+    // Objects and actions
+    pencil: 'edit', pen: 'edit', squarepen: 'edit',
+    user: 'person', usercircle: 'accountCircle', circleuser: 'accountCircle',
+    eye: 'visibility', eyeoff: 'visibilityOff',
+    mappin: 'locationOn', map: 'locationOn',
+    image: 'photo', images: 'photo', file: 'folder', files: 'folder',
+    calendar: 'calendarToday', calendardays: 'calendarToday', clock: 'event',
+    creditcard: 'payment', cart: 'shoppingCart', shoppingbag: 'shoppingCart',
+    phonecall: 'call', mailopen: 'mail', inbox: 'mail',
+    cog: 'settings', gear: 'settings', sliders: 'settings',
+    rotatecw: 'refresh', rotateccw: 'refresh', refreshcw: 'refresh',
+    heart: 'favorite', heartoff: 'favoriteOff',
+    volume: 'volumeUp', volume1: 'volumeDown', volume2: 'volumeUp', volumex: 'volumeOff',
+    skipforward: 'skipNext', skipback: 'skipPrevious',
+    paperclip: 'attachFile', link: 'share', share2: 'share',
+    magnifyingglass: 'search', searchicon: 'search',
+};
+/** Case-insensitive, separator-insensitive key for matching either vocabulary. */
+function normalise(name) {
+    return name.replace(/[\s._-]/g, '').toLowerCase();
+}
+/**
+ * Resolve a prefab icon name to an A2UI one.
+ *
+ * @returns the catalog name, or `undefined` when nothing in the enum means the
+ *   same thing. Callers drop the icon and record a diagnostic.
+ */
+export function a2uiIconName(name) {
+    const key = normalise(name);
+    return BY_NORMALISED.get(key) ?? ALIASES[key];
+}
+//# sourceMappingURL=icons.js.map

package/dist/a2ui/icons.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"icons.js","sourceRoot":"","sources":["../../src/a2ui/icons.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,UAAU,GAAsB;IAC3C,eAAe,EAAE,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,YAAY,EAAE,eAAe;IAClF,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO;IAClF,aAAa,EAAE,UAAU,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAC1E,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,WAAW;IACzE,kBAAkB,EAAE,eAAe,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO;IACnF,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO;IAC3E,cAAc,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM;IACjF,QAAQ,EAAE,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW;IAChF,UAAU,EAAE,SAAS;CACtB,CAAA;AAED,wFAAwF;AACxF,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAA;AAE9E;;;;;;;GAOG;AACH,MAAM,OAAO,GAA2B;IACtC,sBAAsB;IACtB,WAAW,EAAE,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,YAAY,EAAE,OAAO;IACrE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO;IACxD,WAAW,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO;IACjE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;IAC9E,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,kBAAkB;IAClD,aAAa;IACb,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,cAAc;IAClD,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,cAAc;IACtD,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ;IAC1D,gBAAgB,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,EAAE,cAAc,EAAE,WAAW;IAChF,YAAY,EAAE,UAAU;IACxB,sBAAsB;IACtB,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;IAC9C,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,eAAe,EAAE,UAAU,EAAE,eAAe;IACxE,GAAG,EAAE,YAAY,EAAE,MAAM,EAAE,eAAe;IAC1C,MAAM,EAAE,YAAY,EAAE,GAAG,EAAE,YAAY;IACvC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ;IAChE,QAAQ,EAAE,eAAe,EAAE,YAAY,EAAE,eAAe,EAAE,KAAK,EAAE,OAAO;IACxE,UAAU,EAAE,SAAS,EAAE,IAAI,EAAE,cAAc,EAAE,WAAW,EAAE,cAAc;IACxE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;IAClD,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU;IACtD,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS;IAC/D,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,aAAa;IAC1C,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,WAAW;IACpF,WAAW,EAAE,UAAU,EAAE,QAAQ,EAAE,cAAc;IACjD,SAAS,EAAE,YAAY,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO;IACvD,eAAe,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ;CAChD,CAAA;AAED,kFAAkF;AAClF,SAAS,SAAS,CAAC,IAAY;IAC7B,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAA;AACnD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,CAAA;IAC3B,OAAO,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,CAAA;AAC/C,CAAC"}

package/dist/a2ui/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * A2UI emitter — the second output target alongside the `$prefab` wire format.
+ *
+ * `$prefab` payloads render through prefab's own renderer, in an MCP Apps
+ * iframe or any web app. A2UI payloads render natively in the A2UI renderers
+ * (React, Angular, Lit, Flutter, Swift, Compose) with no iframe involved. Both
+ * come from the same server-side component tree.
+ *
+ * @example
+ * ```ts
+ * import { Column, H1, autoTable } from '@maxhealth.tech/prefab'
+ * import { PrefabApp } from '@maxhealth.tech/prefab'
+ *
+ * const app = new PrefabApp({ view: Column({ children: [H1('Users'), autoTable(rows)] }) })
+ * const { messages, diagnostics } = app.toA2UI()
+ * ```
+ */
+export { emitA2UI } from './emit.js';
+export type { A2uiEmitOptions, A2uiEmitResult } from './emit.js';
+export { mappedTypes } from './catalog.js';
+export { a2uiIconName, A2UI_ICONS } from './icons.js';
+export { mappedPipes, parsePipe } from './pipes.js';
+export type { ParsedPipe, PipeMapping } from './pipes.js';
+export type { A2uiProps, EmitContext, Mapper } from './catalog.js';
+export { toBinding, toJsonPointer, escapePointerToken, dynamicString } from './expr.js';
+export type { BindingResult } from './expr.js';
+export { A2UI_VERSION, A2UI_BASIC_CATALOG, A2UI_MIME, A2UI_SCHEME, A2UI_ROOT_ID, } from './types.js';
+export type { A2uiAccessibility, A2uiAction, A2uiChildList, A2uiChildTemplate, A2uiComponent, A2uiCreateSurface, A2uiDataBinding, A2uiDeleteSurface, A2uiDiagnostic, A2uiDiagnosticKind, A2uiDynamicBoolean, A2uiDynamicNumber, A2uiDynamicString, A2uiDynamicValue, A2uiEventAction, A2uiFunctionAction, A2uiFunctionCall, A2uiMessage, A2uiMessageList, A2uiUpdateComponents, A2uiUpdateDataModel, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/a2ui/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AACpC,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAEhE,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC1C,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AACrD,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AACnD,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AACzD,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAElE,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AACvF,YAAY,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAE9C,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,SAAS,EACT,WAAW,EACX,YAAY,GACb,MAAM,YAAY,CAAA;AACnB,YAAY,EACV,iBAAiB,EACjB,UAAU,EACV,aAAa,EACb,iBAAiB,EACjB,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,WAAW,EACX,eAAe,EACf,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,YAAY,CAAA"}

package/dist/a2ui/index.js

@@ -0,0 +1,24 @@
+/**
+ * A2UI emitter — the second output target alongside the `$prefab` wire format.
+ *
+ * `$prefab` payloads render through prefab's own renderer, in an MCP Apps
+ * iframe or any web app. A2UI payloads render natively in the A2UI renderers
+ * (React, Angular, Lit, Flutter, Swift, Compose) with no iframe involved. Both
+ * come from the same server-side component tree.
+ *
+ * @example
+ * ```ts
+ * import { Column, H1, autoTable } from '@maxhealth.tech/prefab'
+ * import { PrefabApp } from '@maxhealth.tech/prefab'
+ *
+ * const app = new PrefabApp({ view: Column({ children: [H1('Users'), autoTable(rows)] }) })
+ * const { messages, diagnostics } = app.toA2UI()
+ * ```
+ */
+export { emitA2UI } from './emit.js';
+export { mappedTypes } from './catalog.js';
+export { a2uiIconName, A2UI_ICONS } from './icons.js';
+export { mappedPipes, parsePipe } from './pipes.js';
+export { toBinding, toJsonPointer, escapePointerToken, dynamicString } from './expr.js';
+export { A2UI_VERSION, A2UI_BASIC_CATALOG, A2UI_MIME, A2UI_SCHEME, A2UI_ROOT_ID, } from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/a2ui/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/a2ui/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AAGpC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC1C,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AACrD,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAInD,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAGvF,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,SAAS,EACT,WAAW,EACX,YAAY,GACb,MAAM,YAAY,CAAA"}

package/dist/a2ui/pipes.d.ts

@@ -0,0 +1,49 @@
+/**
+ * prefab pipe → A2UI catalog function.
+ *
+ * `{{ price | currency:'USD' }}` was previously reported as unbindable on the
+ * grounds that A2UI has no expression language. That is true of the language and
+ * false of the catalog: A2UI ships `formatCurrency`, `formatNumber`, `formatDate`
+ * and `pluralize` as functions, which is exactly what these pipes are.
+ *
+ * Seven of prefab's twenty-two built-ins map. The rest — `truncate`, `join`,
+ * `selectattr`, `percent`, `compact` and friends — transform data rather than
+ * format it and have no equivalent, so they stay unbindable.
+ *
+ * The date pipes are the one inexact mapping. prefab renders through
+ * `toLocaleDateString()`, so the output follows the reader's locale; A2UI's
+ * `formatDate` requires an explicit Unicode TR35 pattern. Choosing a pattern
+ * changes what the reader sees, so it is done with a diagnostic rather than
+ * silently — losing the value entirely would be the worse trade.
+ */
+import type { A2uiDynamicValue, A2uiFunctionCall } from './types.js';
+/** A pipe applied to a base expression: `path | name:arg`. */
+export interface ParsedPipe {
+    base: string;
+    name: string;
+    arg?: string | number;
+}
+/**
+ * Split a pipe expression into its parts.
+ *
+ * Only a single pipe with at most one argument, which is the shape prefab's own
+ * evaluator handles. A chained expression returns `undefined` and is reported
+ * rather than half-translated.
+ */
+export declare function parsePipe(expr: string): ParsedPipe | undefined;
+/** What a mapped pipe produces, plus anything the mapping cost. */
+export interface PipeMapping {
+    call: A2uiFunctionCall;
+    /** Set when the translation is inexact, for the caller to report. */
+    note?: string;
+}
+/** Every prefab pipe with an A2UI equivalent, for docs and tests. */
+export declare function mappedPipes(): string[];
+/**
+ * Map a parsed pipe onto a catalog function.
+ *
+ * @param value the already-resolved base, as a binding or a literal.
+ * @returns `undefined` when the pipe transforms rather than formats.
+ */
+export declare function pipeCall(pipe: ParsedPipe, value: A2uiDynamicValue): PipeMapping | undefined;
+//# sourceMappingURL=pipes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pipes.d.ts","sourceRoot":"","sources":["../../src/a2ui/pipes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAEpE,8DAA8D;AAC9D,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;CACtB;AAKD;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CA2B9D;AAED,mEAAmE;AACnE,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,gBAAgB,CAAA;IACtB,qEAAqE;IACrE,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AA2CD,qEAAqE;AACrE,wBAAgB,WAAW,IAAI,MAAM,EAAE,CAEtC;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,gBAAgB,GAAG,WAAW,GAAG,SAAS,CAE3F"}

package/dist/a2ui/pipes.js

@@ -0,0 +1,106 @@
+/**
+ * prefab pipe → A2UI catalog function.
+ *
+ * `{{ price | currency:'USD' }}` was previously reported as unbindable on the
+ * grounds that A2UI has no expression language. That is true of the language and
+ * false of the catalog: A2UI ships `formatCurrency`, `formatNumber`, `formatDate`
+ * and `pluralize` as functions, which is exactly what these pipes are.
+ *
+ * Seven of prefab's twenty-two built-ins map. The rest — `truncate`, `join`,
+ * `selectattr`, `percent`, `compact` and friends — transform data rather than
+ * format it and have no equivalent, so they stay unbindable.
+ *
+ * The date pipes are the one inexact mapping. prefab renders through
+ * `toLocaleDateString()`, so the output follows the reader's locale; A2UI's
+ * `formatDate` requires an explicit Unicode TR35 pattern. Choosing a pattern
+ * changes what the reader sees, so it is done with a diagnostic rather than
+ * silently — losing the value entirely would be the worse trade.
+ */
+/** Matches `<base> | <name>` with an optional single `:arg`. */
+const PIPE = /^(.+?)\s*\|\s*([A-Za-z_][\w]*)\s*(?::\s*(.+))?$/;
+/**
+ * Split a pipe expression into its parts.
+ *
+ * Only a single pipe with at most one argument, which is the shape prefab's own
+ * evaluator handles. A chained expression returns `undefined` and is reported
+ * rather than half-translated.
+ */
+export function parsePipe(expr) {
+    const m = PIPE.exec(expr);
+    if (m == null)
+        return undefined;
+    const base = m[1].trim();
+    // A second `|` means a chain, which has no single-function equivalent.
+    if (base.includes('|'))
+        return undefined;
+    // `at` rather than indexing: an optional capture group is typed `string` but
+    // is genuinely absent when the pipe took no argument.
+    const raw = m.at(3)?.trim();
+    if (raw === undefined)
+        return { base, name: m[2] };
+    const quoted = /^'([^']*)'$|^"([^"]*)"$/.exec(raw);
+    if (quoted != null) {
+        // One alternative matched, so exactly one group is present. An empty capture
+        // is a real empty-string argument, which `??` keeps and `||` would discard.
+        const literal = quoted.at(1) ?? quoted.at(2);
+        return { base, name: m[2], arg: literal ?? '' };
+    }
+    const num = Number(raw);
+    if (!Number.isNaN(num))
+        return { base, name: m[2], arg: num };
+    // An unquoted, non-numeric argument is a reference prefab would resolve at
+    // render time. A2UI function args take a value, not an expression to evaluate.
+    return undefined;
+}
+/** Build a `formatDate` call, noting that an explicit pattern replaces the locale. */
+function dateFormat(pattern, pipe) {
+    return (value) => ({
+        call: { call: 'formatDate', args: { value, format: pattern } },
+        note: `the "${pipe}" pipe renders in the reader's locale; A2UI needs an explicit pattern, so "${pattern}" was used`,
+    });
+}
+const BUILDERS = {
+    currency: (value, arg) => ({
+        call: {
+            call: 'formatCurrency',
+            // prefab defaults to USD when the pipe is given no code.
+            args: { value, currency: typeof arg === 'string' ? arg : 'USD' },
+        },
+    }),
+    number: (value, arg) => ({
+        call: {
+            call: 'formatNumber',
+            args: { value, ...(typeof arg === 'number' && { decimals: arg }) },
+        },
+    }),
+    round: (value, arg) => ({
+        call: {
+            call: 'formatNumber',
+            // prefab's `round` with no argument means whole numbers.
+            args: { value, decimals: typeof arg === 'number' ? arg : 0 },
+        },
+    }),
+    pluralize: (value, arg) => {
+        if (typeof arg !== 'string')
+            return undefined;
+        // prefab pluralizes by appending an s, which is the rule it can express.
+        return { call: { call: 'pluralize', args: { value, one: arg, other: `${arg}s` } } };
+    },
+    date: dateFormat('y-MM-dd', 'date'),
+    time: dateFormat('HH:mm', 'time'),
+    datetime: dateFormat('y-MM-dd HH:mm', 'datetime'),
+};
+/** Every prefab pipe with an A2UI equivalent, for docs and tests. */
+export function mappedPipes() {
+    return Object.keys(BUILDERS).sort();
+}
+/**
+ * Map a parsed pipe onto a catalog function.
+ *
+ * @param value the already-resolved base, as a binding or a literal.
+ * @returns `undefined` when the pipe transforms rather than formats.
+ */
+export function pipeCall(pipe, value) {
+    return BUILDERS[pipe.name]?.(value, pipe.arg);
+}
+//# sourceMappingURL=pipes.js.map

package/dist/a2ui/pipes.js.map

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

package/dist/a2ui/table.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Table mappers — the one place a prefab component gains structure on the way
+ * out rather than losing it.
+ *
+ * The A2UI Basic catalog has no table component, so a table becomes a `Column`
+ * of `Row`s. For `DataTable` that would be a poor trade, because prefab's table
+ * is data-driven and flattening it would inline every row as its own component
+ * and lose the binding. A2UI's own answer is the child template: a `Column`
+ * whose `children` is `{ path, componentId }` instantiates one copy of the
+ * template component per item in a data-model list, and paths inside the
+ * template resolve relative to the current item. That maps onto `DataTable`
+ * exactly — one `Row` template, one `Text` per column bound to the column key —
+ * so the emitted surface stays as small and as reactive as the prefab original.
+ *
+ * The pattern follows `catalogs/basic/examples/18_track-list.json` in the A2UI
+ * specification, which is the normative example for templated lists.
+ */
+import type { ComponentJSON } from '../core/component.js';
+import type { A2uiProps, EmitContext } from './catalog.js';
+/** prefab table parts that only exist inside a `Table` and never map on their own. */
+export declare const TABLE_PART_TYPES: readonly ["TableHead", "TableBody", "TableFooter", "TableRow", "TableCell", "TableHeader", "ExpandableRow"];
+/**
+ * `DataTable` → a header `Row` plus a templated `Column`.
+ *
+ * A column key containing a `.` addresses a nested field on the row. Relative
+ * paths inside a template are JSON Pointers too, so the dots become slashes.
+ */
+export declare function mapDataTable(node: ComponentJSON, ctx: EmitContext): A2uiProps | undefined;
+/** `Table` → a `Column` of `Row`s, one per `TableRow`. */
+export declare function mapTable(node: ComponentJSON, ctx: EmitContext): A2uiProps | undefined;
+//# sourceMappingURL=table.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"table.d.ts","sourceRoot":"","sources":["../../src/a2ui/table.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAG1D,sFAAsF;AACtF,eAAO,MAAM,gBAAgB,6GAEnB,CAAA;AAyCV;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,aAAa,EAAE,GAAG,EAAE,WAAW,GAAG,SAAS,GAAG,SAAS,CAkCzF;AAyCD,0DAA0D;AAC1D,wBAAgB,QAAQ,CAAC,IAAI,EAAE,aAAa,EAAE,GAAG,EAAE,WAAW,GAAG,SAAS,GAAG,SAAS,CAkBrF"}