@polyxd/a2ui 0.1.0

package/dist/a2ui.d.ts

@@ -0,0 +1,22 @@
+/** Value of the `version` field on every emitted message. */
+export declare const A2UI_VERSION = "v1.0";
+/** Commit of a2ui-project/a2ui the vendored schemas were taken from. */
+export declare const A2UI_COMMIT = "04e6f07fde12ff2638b3b489bd9e3033066cb957";
+/** `catalogId` (and `$id`) of the Polyxd A2UI catalog. */
+export declare const POLYXD_CATALOG_ID = "https://polyxd.com/catalog/0.1/a2ui";
+/** `catalogId` of the official Basic catalog (for reference; the exporter does not emit Basic components). */
+export declare const BASIC_CATALOG_ID = "https://a2ui.org/specification/v1_0/catalogs/basic/catalog.json";
+/**
+ * Key under `metadata.extensions` for Polyxd metadata that has no A2UI equivalent.
+ * Third-party extension keys must be prefixed with an organisation id (A2UI v1.0 §Extensions); this is polyxd.com reversed.
+ */
+export declare const EXTENSION_KEY = "com_polyxd";
+export type Json = Record<string, any>;
+export declare const loadVendored: (path: string) => Json;
+/** The official schemas the exporter is checked against. */
+export declare const a2uiSchemas: {
+    agentToRenderer: () => Json;
+    commonTypes: () => Json;
+    catalogDefinition: () => Json;
+    basicCatalog: () => Json;
+};

package/dist/a2ui.js

@@ -0,0 +1,28 @@
+/**
+ * Constants for the A2UI target and loaders for the vendored official schemas.
+ * See vendor/a2ui/<version>/README.md for provenance.
+ */
+import { readFileSync } from "node:fs";
+/** Value of the `version` field on every emitted message. */
+export const A2UI_VERSION = "v1.0";
+/** Commit of a2ui-project/a2ui the vendored schemas were taken from. */
+export const A2UI_COMMIT = "04e6f07fde12ff2638b3b489bd9e3033066cb957";
+/** `catalogId` (and `$id`) of the Polyxd A2UI catalog. */
+export const POLYXD_CATALOG_ID = "https://polyxd.com/catalog/0.1/a2ui";
+/** `catalogId` of the official Basic catalog (for reference; the exporter does not emit Basic components). */
+export const BASIC_CATALOG_ID = "https://a2ui.org/specification/v1_0/catalogs/basic/catalog.json";
+/**
+ * Key under `metadata.extensions` for Polyxd metadata that has no A2UI equivalent.
+ * Third-party extension keys must be prefixed with an organisation id (A2UI v1.0 §Extensions); this is polyxd.com reversed.
+ */
+export const EXTENSION_KEY = "com_polyxd";
+const VENDOR_DIR = new URL("../vendor/a2ui/v1_0-04e6f07/", import.meta.url);
+export const loadVendored = (path) => JSON.parse(readFileSync(new URL(path, VENDOR_DIR), "utf8"));
+/** The official schemas the exporter is checked against. */
+export const a2uiSchemas = {
+    agentToRenderer: () => loadVendored("json/agent_to_renderer.json"),
+    commonTypes: () => loadVendored("json/common_types.json"),
+    catalogDefinition: () => loadVendored("json/catalog_definition.json"),
+    basicCatalog: () => loadVendored("catalogs/basic/catalog.json"),
+};
+//# sourceMappingURL=a2ui.js.map

package/dist/a2ui.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"a2ui.js","sourceRoot":"","sources":["../src/a2ui.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,6DAA6D;AAC7D,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAC;AACnC,wEAAwE;AACxE,MAAM,CAAC,MAAM,WAAW,GAAG,0CAA0C,CAAC;AACtE,0DAA0D;AAC1D,MAAM,CAAC,MAAM,iBAAiB,GAAG,qCAAqC,CAAC;AACvE,8GAA8G;AAC9G,MAAM,CAAC,MAAM,gBAAgB,GAAG,iEAAiE,CAAC;AAClG;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,YAAY,CAAC;AAE1C,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,8BAA8B,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;AAI5E,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,IAAY,EAAQ,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;AAEhH,4DAA4D;AAC5D,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,eAAe,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,6BAA6B,CAAC;IAClE,WAAW,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,wBAAwB,CAAC;IACzD,iBAAiB,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,8BAA8B,CAAC;IACrE,YAAY,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,6BAA6B,CAAC;CAChE,CAAC"}

package/dist/catalog.d.ts

@@ -0,0 +1,33 @@
+import { type Json } from "./a2ui.ts";
+/** Renderer-handled Polyxd actions (`ui.*`), exported as A2UI local function calls. */
+export declare const RENDERER_FUNCTIONS: Record<string, {
+    fn: string;
+    description: string;
+}>;
+interface ComponentSource {
+    name: string;
+    category: string;
+    summary: string;
+    props: Record<string, Json>;
+    required: string[];
+    whenToUse: string[];
+    whenNotToUse: string[];
+    accessibility: {
+        role: string;
+        requirements: string[];
+    };
+    agent: string;
+    rendering: string[];
+    a2ui: string;
+}
+export declare function loadPolyxdSources(): {
+    common: Record<string, Json>;
+    components: ComponentSource[];
+};
+export declare function buildInstructions(components: ComponentSource[]): string;
+export declare function buildCatalog(): Json;
+export declare const catalogJson: () => string;
+export declare const CATALOG_FILE: URL;
+/** The committed catalog (catalog/catalog.json). */
+export declare const loadPolyxdCatalog: () => Json;
+export {};

package/dist/catalog.js

@@ -0,0 +1,184 @@
+/**
+ * Builds the Polyxd catalog in A2UI v1.0 catalog format from the Polyxd component sources
+ * (@polyxd/spec components/*.json + schema/common.defs.json).
+ *
+ * A2UI catalog rules this follows (A2UI v1.0 protocol, "Catalog Schema Rules and Conventions"):
+ *  - top-level keys limited to $schema, $id, protocolVersion, title, description, catalogId, instructions, components, functions, $defs
+ *  - $defs holds only anyComponent / anyFunction; no shared helpers, so Polyxd helper types are inlined per prop
+ *  - external $refs only to common_types.json ComponentId, ChildList, Dynamic*, AccessibilityAttributes, CheckRule, Checkable, Action
+ *  - component ids use ComponentId, child lists and templates use ChildList (validators find links by these refs)
+ *  - id / catalogId / accessibility / metadata are envelope-level (ComponentCommon) and are not redeclared
+ */
+import { readdirSync, readFileSync } from "node:fs";
+import { EXTENSION_KEY, POLYXD_CATALOG_ID } from "./a2ui.js";
+import { REFERENCE_TYPES } from "@polyxd/spec";
+import { MAPPING } from "./mapping.js";
+const COMMON = "common_types.json#/$defs/";
+/** Polyxd defs that map one-to-one onto an A2UI common type. */
+const DIRECT = {
+    Id: "ComponentId",
+    DynamicString: "DynamicString",
+    DynamicNumber: "DynamicNumber",
+    DynamicBoolean: "DynamicBoolean",
+    DynamicValue: "DynamicValue",
+    Accessibility: "AccessibilityAttributes",
+    Action: "Action",
+};
+/**
+ * A2UI `allowedChildren` for one component: emitted only when EVERY slot that can hold other
+ * components is restricted to named types. Derived from the spec's REFERENCE_TYPES, so the two
+ * can't drift apart (a component with a free-form `children` list stays unrestricted).
+ */
+function allowedChildren(c) {
+    const refOf = (v) => {
+        const ref = v?.$ref;
+        return typeof ref === "string" ? ref : undefined;
+    };
+    // A Template holds any component as its repeated item, so it leaves the component unrestricted.
+    if (Object.values(c.props).some((v) => refOf(v)?.endsWith("/Template")))
+        return undefined;
+    const slots = Object.entries(c.props)
+        .filter(([, v]) => refOf(v)?.endsWith("/Id") || refOf(v)?.endsWith("/ChildList"))
+        .map(([k]) => k);
+    if (!slots.length)
+        return undefined;
+    const types = new Set();
+    for (const slot of slots) {
+        const allowed = REFERENCE_TYPES[`${c.name}.${slot}`];
+        if (!allowed)
+            return undefined;
+        for (const t of allowed)
+            types.add(t);
+    }
+    return [...types].sort();
+}
+/** Renderer-handled Polyxd actions (`ui.*`), exported as A2UI local function calls. */
+export const RENDERER_FUNCTIONS = {
+    "ui.dismiss": { fn: "dismiss", description: "Closes the surface without doing anything (Polyxd 'ui.dismiss')." },
+    "ui.back": { fn: "back", description: "Returns to the previous step or surface (Polyxd 'ui.back')." },
+    "ui.next": { fn: "next", description: "Advances to the next step (Polyxd 'ui.next')." },
+};
+const specRoot = new URL("./", import.meta.resolve("@polyxd/spec/package.json"));
+const readSpec = (p) => JSON.parse(readFileSync(new URL(p, specRoot), "utf8"));
+export function loadPolyxdSources() {
+    const files = readdirSync(new URL("components/", specRoot)).filter((f) => f.endsWith(".json")).sort();
+    return { common: readSpec("schema/common.defs.json"), components: files.map((f) => readSpec(`components/${f}`)) };
+}
+/** Rewrites a Polyxd prop schema into an A2UI-catalog-compliant one (allowed $refs only, helpers inlined). */
+function convert(schema, common) {
+    if (Array.isArray(schema))
+        return schema.map((s) => convert(s, common));
+    if (!schema || typeof schema !== "object")
+        return schema;
+    const s = schema;
+    if (typeof s.$ref === "string") {
+        const name = s.$ref.replace("#/$defs/", "");
+        const { $ref: _ref, ...siblings } = s;
+        const extra = convert(siblings, common);
+        if (name === "ChildList") {
+            return { $ref: `${COMMON}ChildList`, type: "array", minItems: 1, description: common.ChildList.description, ...extra };
+        }
+        if (name === "Template") {
+            return { $ref: `${COMMON}ChildList`, type: "object", description: common.Template.description, ...extra };
+        }
+        if (DIRECT[name])
+            return { $ref: `${COMMON}${DIRECT[name]}`, ...extra };
+        const def = common[name];
+        if (!def)
+            throw new Error(`unknown Polyxd def ${name}`);
+        return { ...convert(def, common), ...extra };
+    }
+    return Object.fromEntries(Object.entries(s).map(([k, v]) => [k, k === "enum" || k === "const" || k === "default" ? v : convert(v, common)]));
+}
+const bullets = (items) => items.map((x) => `  - ${x}`).join("\n");
+export function buildInstructions(components) {
+    const head = `# Polyxd catalog for A2UI
+
+Semantic components for just-in-time interfaces. The renderer maps each one onto its own native, design-system components and tokens. Pick components by meaning, not by look. Never send colours, sizes or fonts.
+
+## Rules for every surface
+
+1. The top-level component has \`"id": "root"\`. Children are referenced by id (flat adjacency list), never nested inline.
+2. Data always comes from the host through JSON Pointer bindings \`{"path": "/..."}\`. Never invent data or pre-format numbers and dates into strings. Set \`format\` instead.
+3. Inside a templated list (\`Collection.items\`), relative paths such as \`{"path": "title"}\` resolve against the current item. Absolute paths start with \`/\`.
+4. Actions are declared capability intents: \`{"event": {"name": "transfer.confirm", "context": {...}}}\`. Use \`{"functionCall": {"call": "dismiss" | "back" | "next"}}\` for navigation the renderer handles itself.
+5. At most one primary action is visible at a time. A Form's submit and a Steps finish count as primary.
+6. Destructive or consequential actions go through \`Confirm\`.
+7. Components carry their own roles and names. Use \`accessibility\` only to add to them.
+
+## Components
+`;
+    const body = components.map((c) => [
+        `### ${c.name}`,
+        "",
+        c.summary,
+        "",
+        `- **Use when:**\n${bullets(c.whenToUse)}`,
+        `- **Don't use when:**\n${bullets(c.whenNotToUse)}`,
+        `- **Rendering:**\n${bullets(c.rendering)}`,
+        `- **Accessibility** (role: ${c.accessibility.role}):\n${bullets(c.accessibility.requirements)}`,
+        `- **Agents:** ${c.agent}`,
+    ].join("\n"));
+    return head + "\n" + body.join("\n\n") + "\n";
+}
+export function buildCatalog() {
+    const { common, components } = loadPolyxdSources();
+    const defs = {};
+    for (const c of components) {
+        const decision = MAPPING[c.name];
+        if (!decision)
+            throw new Error(`no A2UI mapping decision for ${c.name} (add it to src/mapping.ts)`);
+        const props = {
+            component: { const: c.name },
+            visible: { $ref: `${COMMON}DynamicBoolean`, description: "Hide the component when false" },
+        };
+        for (const [k, v] of Object.entries(c.props))
+            props[k] = convert(v, common);
+        defs[c.name] = {
+            type: "object",
+            description: c.summary,
+            properties: props,
+            required: ["component", ...c.required],
+            ...(allowedChildren(c) ? { allowedChildren: allowedChildren(c) } : {}),
+            metadata: {
+                extensions: {
+                    [EXTENSION_KEY]: { category: c.category, target: decision.target, basicAnalog: decision.basicAnalog, why: decision.why },
+                },
+            },
+        };
+    }
+    const functions = {};
+    for (const { fn, description } of Object.values(RENDERER_FUNCTIONS)) {
+        functions[fn] = {
+            type: "object",
+            description,
+            returnType: "void",
+            allowedCallers: "rendererOnly",
+            properties: { call: { const: fn } },
+            required: ["call"],
+        };
+    }
+    return {
+        $schema: "https://json-schema.org/draft/2020-12/schema",
+        $id: POLYXD_CATALOG_ID,
+        protocolVersion: "1.0",
+        title: "Polyxd catalog",
+        description: "Polyxd semantic components as an A2UI v1.0 catalog. Every component is a faithful projection of the Polyxd component with the same name and props. Generated from @polyxd/spec components/*.json by @polyxd/a2ui (npm run build:catalog).",
+        catalogId: POLYXD_CATALOG_ID,
+        instructions: buildInstructions(components),
+        components: defs,
+        functions,
+        $defs: {
+            anyComponent: {
+                oneOf: components.map((c) => ({ $ref: `#/components/${c.name}` })),
+                discriminator: { propertyName: "component" },
+            },
+            anyFunction: { oneOf: Object.keys(functions).map((f) => ({ $ref: `#/functions/${f}` })) },
+        },
+    };
+}
+export const catalogJson = () => JSON.stringify(buildCatalog(), null, 2) + "\n";
+export const CATALOG_FILE = new URL("../catalog/catalog.json", import.meta.url);
+/** The committed catalog (catalog/catalog.json). */
+export const loadPolyxdCatalog = () => JSON.parse(readFileSync(CATALOG_FILE, "utf8"));
+//# sourceMappingURL=catalog.js.map

package/dist/catalog.js.map

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

package/dist/export.d.ts

@@ -0,0 +1,79 @@
+import { A2UI_VERSION, type Json } from "./a2ui.ts";
+export interface PolyxdComponent {
+    id: string;
+    component: string;
+    key?: string;
+    accessibility?: Json;
+    [prop: string]: unknown;
+}
+export interface PolyxdDocument {
+    $schema?: string;
+    specVersion: string;
+    surface: {
+        id: string;
+        title: string;
+        intent?: string;
+        pattern?: string;
+        journey?: string;
+        dismissible?: boolean;
+    };
+    root: string;
+    components: PolyxdComponent[];
+    data?: Json;
+}
+export interface A2UIComponent {
+    id: string;
+    component: string;
+    accessibility?: Json;
+    metadata?: {
+        extensions: Json;
+    };
+    [prop: string]: unknown;
+}
+export type A2UIMessage = {
+    version: typeof A2UI_VERSION;
+    createSurface: {
+        surfaceId: string;
+        catalogId: string;
+        sendDataModel?: boolean;
+        components?: A2UIComponent[];
+        dataModel?: Json;
+        metadata?: {
+            extensions: Json;
+        };
+    };
+} | {
+    version: typeof A2UI_VERSION;
+    updateComponents: {
+        surfaceId: string;
+        components: A2UIComponent[];
+    };
+} | {
+    version: typeof A2UI_VERSION;
+    updateDataModel: {
+        surfaceId: string;
+        path?: string;
+        value: unknown;
+    };
+};
+export interface ExportOptions {
+    /**
+     * "inline" (default): one `createSurface` carrying `components` and `dataModel` (allowed by v1.0).
+     * "stream": `createSurface`, then `updateComponents`, then `updateDataModel` (only when the document has data).
+     */
+    mode?: "inline" | "stream";
+    /** Override the A2UI surfaceId (must be unique for the renderer's lifetime). Defaults to `surface.id`. */
+    surfaceId?: string;
+    /** Carry Polyxd-only metadata in `metadata.extensions.com_polyxd` (default true). The fields are listed in `lossy` either way. */
+    extensions?: boolean;
+    /** Passed through to createSurface.sendDataModel. */
+    sendDataModel?: boolean;
+}
+export interface ExportResult {
+    messages: A2UIMessage[];
+    /** JSON Pointers into the Polyxd document for every field with no A2UI representation. */
+    lossy: string[];
+    /** Component ids that were renamed (Polyxd id → A2UI id). Only "root" handling renames. */
+    idMap: Record<string, string>;
+}
+export declare function exportToA2UI(doc: PolyxdDocument, options?: ExportOptions): ExportResult;

package/dist/export.js

@@ -0,0 +1,120 @@
+/**
+ * Polyxd UI document → A2UI v1.0 agent-to-renderer message stream.
+ *
+ * The Polyxd component layer mirrors A2UI's shapes (flat adjacency list, JSON Pointer bindings,
+ * `action.event {name, context}`, `accessibility`), and the Polyxd A2UI catalog declares every component
+ * with its Polyxd props. So most of the export is an identity projection. The exceptions are:
+ *  - the top-level component is renamed to "root" (A2UI mounts the component with id "root"),
+ *  - `ui.*` renderer actions become A2UI local function calls (`dismiss` / `back` / `next`),
+ *  - Polyxd metadata with no A2UI equivalent (spec version, surface title/intent/pattern/journey/dismissible,
+ *    component `key`) is listed in `lossy`. Unless `extensions: false`, it is also carried as opaque
+ *    `metadata.extensions.com_polyxd`, which A2UI renderers must ignore.
+ */
+import { readFileSync } from "node:fs";
+import { A2UI_VERSION, EXTENSION_KEY, POLYXD_CATALOG_ID } from "./a2ui.js";
+import { RENDERER_FUNCTIONS } from "./catalog.js";
+const uiSchema = JSON.parse(readFileSync(new URL(import.meta.resolve("@polyxd/spec/schema/ui.schema.json")), "utf8"));
+const defs = uiSchema.$defs;
+const refName = (s) => (typeof s?.$ref === "string" ? s.$ref.replace("#/$defs/", "") : undefined);
+const deref = (s) => {
+    let cur = s;
+    while (cur && refName(cur))
+        cur = defs[refName(cur)];
+    return cur;
+};
+const pointer = (...parts) => "/" + parts.map((p) => String(p).replace(/~/g, "~0").replace(/\//g, "~1")).join("/");
+const clone = (v) => structuredClone(v);
+/** Fields of the Polyxd envelope that A2UI has no place for. */
+const SURFACE_ONLY = ["title", "intent", "pattern", "journey", "dismissible"];
+export function exportToA2UI(doc, options = {}) {
+    const { mode = "inline", extensions = true } = options;
+    const surfaceId = options.surfaceId ?? doc.surface.id;
+    const lossy = [];
+    // A2UI mounts the component with id "root". Rename the Polyxd root, moving any other "root" out of the way.
+    const ids = new Set(doc.components.map((c) => c.id));
+    const idMap = {};
+    if (doc.root !== "root") {
+        if (ids.has("root")) {
+            let n = 2;
+            while (ids.has(`root_${n}`))
+                n++;
+            idMap.root = `root_${n}`;
+        }
+        idMap[doc.root] = "root";
+    }
+    const mapId = (id) => idMap[id] ?? id;
+    /** Copies a prop value, rewriting component ids and renderer actions where the Polyxd schema says they are. */
+    const project = (schema, value, at) => {
+        const name = refName(schema);
+        if (name === "Id" && typeof value === "string")
+            return mapId(value);
+        if (name === "Action" && value && typeof value === "object")
+            return projectAction(value, at);
+        if (name === "Template" && value && typeof value === "object") {
+            const t = value;
+            return { ...clone(t), componentId: mapId(t.componentId) };
+        }
+        const s = deref(schema);
+        if (!s || s.oneOf || value === null || typeof value !== "object")
+            return clone(value);
+        if (Array.isArray(value))
+            return value.map((v, i) => project(s.items, v, `${at}/${i}`));
+        return Object.fromEntries(Object.entries(value).map(([k, v]) => [k, project(s.properties?.[k], v, `${at}/${k}`)]));
+    };
+    const projectAction = (action, at) => {
+        const fn = RENDERER_FUNCTIONS[action.event?.name];
+        if (!fn)
+            return clone(action);
+        if (action.event.context)
+            lossy.push(`${at}/event/context`);
+        return { functionCall: { call: fn.fn } };
+    };
+    const components = doc.components.map((c, i) => {
+        const compSchema = defs[`Component${c.component}`];
+        const out = { id: mapId(c.id), component: c.component };
+        for (const [prop, value] of Object.entries(c)) {
+            if (prop === "id" || prop === "component")
+                continue;
+            if (prop === "key") {
+                lossy.push(pointer("components", i, "key"));
+                continue;
+            }
+            out[prop] = project(compSchema?.properties?.[prop], value, pointer("components", i, prop));
+        }
+        if (extensions && c.key !== undefined)
+            out.metadata = { extensions: { [EXTENSION_KEY]: { key: c.key } } };
+        return out;
+    });
+    // Envelope fields.
+    const surfaceExt = {};
+    if (doc.$schema !== undefined)
+        lossy.push("/$schema");
+    if (doc.specVersion !== undefined)
+        (lossy.push("/specVersion"), (surfaceExt.specVersion = doc.specVersion));
+    for (const f of SURFACE_ONLY) {
+        if (doc.surface[f] !== undefined)
+            (lossy.push(`/surface/${f}`), (surfaceExt[f] = doc.surface[f]));
+    }
+    if (doc.root !== "root")
+        surfaceExt.root = doc.root;
+    const createSurface = { surfaceId, catalogId: POLYXD_CATALOG_ID };
+    if (options.sendDataModel !== undefined)
+        createSurface.sendDataModel = options.sendDataModel;
+    if (extensions && Object.keys(surfaceExt).length)
+        createSurface.metadata = { extensions: { [EXTENSION_KEY]: surfaceExt } };
+    const messages = [];
+    if (mode === "inline") {
+        createSurface.components = components;
+        if (doc.data !== undefined)
+            createSurface.dataModel = clone(doc.data);
+        messages.push({ version: A2UI_VERSION, createSurface });
+    }
+    else {
+        messages.push({ version: A2UI_VERSION, createSurface });
+        messages.push({ version: A2UI_VERSION, updateComponents: { surfaceId, components } });
+        if (doc.data !== undefined)
+            messages.push({ version: A2UI_VERSION, updateDataModel: { surfaceId, value: clone(doc.data) } });
+    }
+    return { messages, lossy, idMap };
+}
+//# sourceMappingURL=export.js.map

package/dist/export.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { exportToA2UI, type ExportOptions, type ExportResult, type A2UIMessage, type A2UIComponent, type PolyxdDocument, type PolyxdComponent } from "./export.ts";
+export { buildCatalog, catalogJson, loadPolyxdCatalog, CATALOG_FILE, RENDERER_FUNCTIONS } from "./catalog.ts";
+export { createValidator, checkComponentTree, type A2UIValidator, type A2UIValidationError } from "./validate.ts";
+export { MAPPING, type MappingDecision } from "./mapping.ts";
+export { A2UI_VERSION, A2UI_COMMIT, POLYXD_CATALOG_ID, BASIC_CATALOG_ID, EXTENSION_KEY, a2uiSchemas } from "./a2ui.ts";

package/dist/index.js

@@ -0,0 +1,6 @@
+export { exportToA2UI } from "./export.js";
+export { buildCatalog, catalogJson, loadPolyxdCatalog, CATALOG_FILE, RENDERER_FUNCTIONS } from "./catalog.js";
+export { createValidator, checkComponentTree } from "./validate.js";
+export { MAPPING } from "./mapping.js";
+export { A2UI_VERSION, A2UI_COMMIT, POLYXD_CATALOG_ID, BASIC_CATALOG_ID, EXTENSION_KEY, a2uiSchemas } from "./a2ui.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAA0H,MAAM,aAAa,CAAC;AACnK,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAC9G,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAgD,MAAM,eAAe,CAAC;AAClH,OAAO,EAAE,OAAO,EAAwB,MAAM,cAAc,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC"}

package/dist/mapping.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Per-component export decision: Basic catalog component, or a custom component in the Polyxd A2UI catalog.
+ *
+ * Rule: a Polyxd component maps to a Basic component only when every Polyxd prop has a Basic
+ * equivalent with the same meaning. Otherwise it is exported as a custom component with the same name and
+ * props, so the export stays a lossless projection rather than a lossy flattening
+ * (docs/decisions/0001 §6: "a faithful export", custom catalogs being the endorsed A2UI path).
+ * None of the 26 components currently meets the rule. `basicAnalog` records the nearest Basic
+ * construct and `why` records what flattening into it would lose.
+ */
+export interface MappingDecision {
+    target: "basic" | "custom";
+    /** Nearest construct in the A2UI v1.0 Basic catalog */
+    basicAnalog: string;
+    /** What exporting to the Basic analog would lose */
+    why: string;
+}
+export declare const MAPPING: Record<string, MappingDecision>;