@watt42/a2ui-core 0.1.0

package/README.md

@@ -0,0 +1,32 @@
+# @watt42/a2ui-core
+
+## Purpose
+
+Shared TypeScript A2UI types, message prepare/diagnostics, and lightweight UIService facade.
+
+## Owns
+
+- A2UI message types and version constants
+- `prepare` / normalize helpers used before processors
+- Diagnostics helpers
+- Thin `UIService` client stub for TS consumers
+
+## Does Not Own
+
+- React rendering or components
+- Python compiler / `UICapability`
+- Transport adapters
+
+## Public API
+
+```ts
+import {
+  A2UI_VERSION,
+  prepareA2UiMessages,
+  type A2UiMessage,
+} from "@watt42/a2ui-core";
+```
+
+## Dependencies
+
+- `@watt42/a2ui-component-catalog`

package/dist/a2uiDiagnostics.d.ts

@@ -0,0 +1,18 @@
+import type { MissingComponentReferenceIssue, ObjectTextBindingIssue, TabsConfigurationIssue, UnsupportedComponentIssue } from "./catalogDiagnostics.js";
+import type { A2UiMessage } from "./types.js";
+/** Catalog / binding diagnostics for an A2UI message batch (host-agnostic). */
+export interface A2UiDiagnostics {
+    unsupportedComponents: UnsupportedComponentIssue[];
+    tabsIssues: TabsConfigurationIssue[];
+    missingComponentRefs: MissingComponentReferenceIssue[];
+    objectTextBindings: ObjectTextBindingIssue[];
+    missingDataModel: boolean;
+    hasWarnings: boolean;
+}
+export declare function buildA2UiDiagnostics(messages: A2UiMessage[], options?: {
+    alreadyPrepared?: boolean;
+    renderer?: "official" | "surface";
+}): A2UiDiagnostics;
+/** Surface/editor strip: ignore object-text binding noise. */
+export declare function a2uiSurfaceHasWarnings(diagnostics: A2UiDiagnostics): boolean;
+//# sourceMappingURL=a2uiDiagnostics.d.ts.map

package/dist/a2uiDiagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"a2uiDiagnostics.d.ts","sourceRoot":"","sources":["../src/a2uiDiagnostics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,8BAA8B,EAC9B,sBAAsB,EACtB,sBAAsB,EACtB,yBAAyB,EAC1B,MAAM,yBAAyB,CAAC;AAQjC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,+EAA+E;AAC/E,MAAM,WAAW,eAAe;IAC9B,qBAAqB,EAAE,yBAAyB,EAAE,CAAC;IACnD,UAAU,EAAE,sBAAsB,EAAE,CAAC;IACrC,oBAAoB,EAAE,8BAA8B,EAAE,CAAC;IACvD,kBAAkB,EAAE,sBAAsB,EAAE,CAAC;IAC7C,gBAAgB,EAAE,OAAO,CAAC;IAC1B,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,WAAW,EAAE,EACvB,OAAO,CAAC,EAAE;IAAE,eAAe,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,UAAU,GAAG,SAAS,CAAA;CAAE,GACzE,eAAe,CAwBjB;AAED,8DAA8D;AAC9D,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,eAAe,GAAG,OAAO,CAO5E"}

package/dist/a2uiDiagnostics.js

@@ -0,0 +1,32 @@
+import { findMissingComponentReferences, findMissingDataModelMessages, findObjectTextBindingIssues, findTabsConfigurationIssues, findUnsupportedComponents, } from "./catalogDiagnostics.js";
+export function buildA2UiDiagnostics(messages, options) {
+    const opts = {
+        alreadyPrepared: options?.alreadyPrepared ?? false,
+        renderer: options?.renderer,
+    };
+    const unsupportedComponents = findUnsupportedComponents(messages, opts);
+    const tabsIssues = findTabsConfigurationIssues(messages, opts);
+    const missingComponentRefs = findMissingComponentReferences(messages, opts);
+    const objectTextBindings = findObjectTextBindingIssues(messages, opts);
+    const missingDataModel = findMissingDataModelMessages(messages, opts);
+    return {
+        unsupportedComponents,
+        tabsIssues,
+        missingComponentRefs,
+        objectTextBindings,
+        missingDataModel,
+        hasWarnings: unsupportedComponents.length > 0 ||
+            tabsIssues.length > 0 ||
+            missingComponentRefs.length > 0 ||
+            objectTextBindings.length > 0 ||
+            missingDataModel,
+    };
+}
+/** Surface/editor strip: ignore object-text binding noise. */
+export function a2uiSurfaceHasWarnings(diagnostics) {
+    return (diagnostics.unsupportedComponents.length > 0 ||
+        diagnostics.tabsIssues.length > 0 ||
+        diagnostics.missingComponentRefs.length > 0 ||
+        diagnostics.missingDataModel);
+}
+//# sourceMappingURL=a2uiDiagnostics.js.map

package/dist/a2uiDiagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"a2uiDiagnostics.js","sourceRoot":"","sources":["../src/a2uiDiagnostics.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,8BAA8B,EAC9B,4BAA4B,EAC5B,2BAA2B,EAC3B,2BAA2B,EAC3B,yBAAyB,GAC1B,MAAM,yBAAyB,CAAC;AAajC,MAAM,UAAU,oBAAoB,CAClC,QAAuB,EACvB,OAA0E;IAE1E,MAAM,IAAI,GAAG;QACX,eAAe,EAAE,OAAO,EAAE,eAAe,IAAI,KAAK;QAClD,QAAQ,EAAE,OAAO,EAAE,QAAQ;KAC5B,CAAC;IACF,MAAM,qBAAqB,GAAG,yBAAyB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACxE,MAAM,UAAU,GAAG,2BAA2B,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAC/D,MAAM,oBAAoB,GAAG,8BAA8B,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAC5E,MAAM,kBAAkB,GAAG,2BAA2B,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACvE,MAAM,gBAAgB,GAAG,4BAA4B,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAEtE,OAAO;QACL,qBAAqB;QACrB,UAAU;QACV,oBAAoB;QACpB,kBAAkB;QAClB,gBAAgB;QAChB,WAAW,EACT,qBAAqB,CAAC,MAAM,GAAG,CAAC;YAChC,UAAU,CAAC,MAAM,GAAG,CAAC;YACrB,oBAAoB,CAAC,MAAM,GAAG,CAAC;YAC/B,kBAAkB,CAAC,MAAM,GAAG,CAAC;YAC7B,gBAAgB;KACnB,CAAC;AACJ,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,sBAAsB,CAAC,WAA4B;IACjE,OAAO,CACL,WAAW,CAAC,qBAAqB,CAAC,MAAM,GAAG,CAAC;QAC5C,WAAW,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC;QACjC,WAAW,CAAC,oBAAoB,CAAC,MAAM,GAAG,CAAC;QAC3C,WAAW,CAAC,gBAAgB,CAC7B,CAAC;AACJ,CAAC"}

package/dist/catalogDiagnostics.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Catalog-aware diagnostics using shared component-catalog metadata.
+ */
+import type { A2UiMessage } from "./types.js";
+export declare function getSupportedCatalogComponentNames(renderer?: "official" | "surface"): string[];
+export interface UnsupportedComponentIssue {
+    component: string;
+    catalogId: string;
+}
+export interface A2UiValidationOptions {
+    alreadyPrepared?: boolean;
+    renderer?: "official" | "surface";
+}
+export declare function findUnsupportedComponents(messages: A2UiMessage[], options?: A2UiValidationOptions): UnsupportedComponentIssue[];
+export declare function formatUnsupportedComponentHint(issue: UnsupportedComponentIssue): string;
+export declare function findMissingDataModelMessages(messages: A2UiMessage[], options?: A2UiValidationOptions): boolean;
+export interface TabsConfigurationIssue {
+    componentId: string;
+    detail: string;
+}
+export interface ObjectTextBindingIssue {
+    componentId: string;
+    path: string;
+}
+export interface MissingComponentReferenceIssue {
+    referencedBy: string;
+    missingId: string;
+}
+export declare function formatMissingComponentReferenceDetail(issue: MissingComponentReferenceIssue): string;
+export declare function findMissingComponentReferences(messages: A2UiMessage[], options?: A2UiValidationOptions): MissingComponentReferenceIssue[];
+export declare function findObjectTextBindingIssues(messages: A2UiMessage[], options?: A2UiValidationOptions): ObjectTextBindingIssue[];
+export declare function findTabsConfigurationIssues(messages: A2UiMessage[], options?: A2UiValidationOptions): TabsConfigurationIssue[];
+//# sourceMappingURL=catalogDiagnostics.d.ts.map

package/dist/catalogDiagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalogDiagnostics.d.ts","sourceRoot":"","sources":["../src/catalogDiagnostics.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAU9C,wBAAgB,iCAAiC,CAC/C,QAAQ,CAAC,EAAE,UAAU,GAAG,SAAS,GAChC,MAAM,EAAE,CAOV;AAMD,MAAM,WAAW,yBAAyB;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAoBD,MAAM,WAAW,qBAAqB;IACpC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;CACnC;AASD,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,WAAW,EAAE,EACvB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,yBAAyB,EAAE,CAoB7B;AAED,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,yBAAyB,GAC/B,MAAM,CAER;AASD,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,WAAW,EAAE,EACvB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAgBT;AAED,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,8BAA8B;IAC7C,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,qCAAqC,CACnD,KAAK,EAAE,8BAA8B,GACpC,MAAM,CAMR;AA6CD,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,WAAW,EAAE,EACvB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,8BAA8B,EAAE,CAuBlC;AAuCD,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,WAAW,EAAE,EACvB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,sBAAsB,EAAE,CA0B1B;AAeD,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,WAAW,EAAE,EACvB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,sBAAsB,EAAE,CA4C1B"}

package/dist/catalogDiagnostics.js

@@ -0,0 +1,268 @@
+/**
+ * Catalog-aware diagnostics using shared component-catalog metadata.
+ */
+import { getCatalog, listComponents } from "@watt42/a2ui-component-catalog";
+import { coerceA2UiMessages, isDynamicBindingValue, normalizeTabsArray, } from "./normalize.js";
+let cachedByRenderer = new Map();
+export function getSupportedCatalogComponentNames(renderer) {
+    const key = renderer ?? "all";
+    const cached = cachedByRenderer.get(key);
+    if (cached)
+        return cached;
+    const names = listComponents(renderer).map((c) => c.name).sort();
+    cachedByRenderer.set(key, names);
+    return names;
+}
+function getSupportedComponentSet(renderer) {
+    return new Set(getSupportedCatalogComponentNames(renderer));
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function componentTypeFromRaw(raw) {
+    if (!isRecord(raw))
+        return null;
+    if (typeof raw.component === "string")
+        return raw.component;
+    if (typeof raw.type === "string" &&
+        raw.type !== "updateComponents" &&
+        raw.type !== "createSurface" &&
+        raw.type !== "surfaceUpdate") {
+        return raw.type;
+    }
+    return null;
+}
+function resolveMessages(messages, options) {
+    return options?.alreadyPrepared ? messages : coerceA2UiMessages(messages);
+}
+export function findUnsupportedComponents(messages, options) {
+    const coerced = resolveMessages(messages, options);
+    const supported = getSupportedComponentSet(options?.renderer ?? "surface");
+    const catalogId = getCatalog().catalogId;
+    const seen = new Set();
+    const issues = [];
+    for (const message of coerced) {
+        const payload = message.updateComponents ?? message.surfaceUpdate;
+        if (!isRecord(payload) || !Array.isArray(payload.components))
+            continue;
+        for (const raw of payload.components) {
+            const name = componentTypeFromRaw(raw);
+            if (!name || supported.has(name) || seen.has(name))
+                continue;
+            seen.add(name);
+            issues.push({ component: name, catalogId });
+        }
+    }
+    return issues;
+}
+export function formatUnsupportedComponentHint(issue) {
+    return `"${issue.component}" is not in catalog ${issue.catalogId}. Available: ${getSupportedCatalogComponentNames().join(", ")}.`;
+}
+function usesDataModelPaths(value) {
+    if (Array.isArray(value))
+        return value.some(usesDataModelPaths);
+    if (isDynamicBindingValue(value))
+        return true;
+    if (!isRecord(value))
+        return false;
+    return Object.values(value).some(usesDataModelPaths);
+}
+export function findMissingDataModelMessages(messages, options) {
+    const coerced = resolveMessages(messages, options);
+    let needsModel = false;
+    let hasModel = false;
+    for (const message of coerced) {
+        if (message.updateDataModel || message.dataModelUpdate) {
+            hasModel = true;
+        }
+        const payload = message.updateComponents ?? message.surfaceUpdate;
+        if (isRecord(payload) && usesDataModelPaths(payload.components)) {
+            needsModel = true;
+        }
+    }
+    return needsModel && !hasModel;
+}
+export function formatMissingComponentReferenceDetail(issue) {
+    return (`Component "${issue.missingId}" is referenced by "${issue.referencedBy}" ` +
+        `(in children, child, or tabs) but is not defined in updateComponents. ` +
+        `Add a component with id "${issue.missingId}" to the components array.`);
+}
+function collectComponentIds(messages, options) {
+    const ids = new Set();
+    const coerced = resolveMessages(messages, options);
+    for (const message of coerced) {
+        const payload = message.updateComponents ?? message.surfaceUpdate;
+        if (!isRecord(payload) || !Array.isArray(payload.components))
+            continue;
+        for (const raw of payload.components) {
+            if (isRecord(raw) && typeof raw.id === "string") {
+                ids.add(raw.id);
+            }
+        }
+    }
+    return ids;
+}
+function referencedChildIdsFromRaw(raw) {
+    const ids = [];
+    if (Array.isArray(raw.children)) {
+        for (const child of raw.children) {
+            if (typeof child === "string")
+                ids.push(child);
+        }
+    }
+    if (typeof raw.child === "string")
+        ids.push(raw.child);
+    const tabs = raw.tabs ?? raw.tabItems;
+    if (Array.isArray(tabs)) {
+        for (const item of tabs) {
+            if (!isRecord(item))
+                continue;
+            if (typeof item.child === "string")
+                ids.push(item.child);
+        }
+    }
+    return ids;
+}
+export function findMissingComponentReferences(messages, options) {
+    const coerced = resolveMessages(messages, options);
+    const componentIds = collectComponentIds(messages, options);
+    const seen = new Set();
+    const issues = [];
+    for (const message of coerced) {
+        const payload = message.updateComponents ?? message.surfaceUpdate;
+        if (!isRecord(payload) || !Array.isArray(payload.components))
+            continue;
+        for (const raw of payload.components) {
+            if (!isRecord(raw) || typeof raw.id !== "string")
+                continue;
+            for (const missingId of referencedChildIdsFromRaw(raw)) {
+                if (componentIds.has(missingId))
+                    continue;
+                const key = `${raw.id}\0${missingId}`;
+                if (seen.has(key))
+                    continue;
+                seen.add(key);
+                issues.push({ referencedBy: raw.id, missingId });
+            }
+        }
+    }
+    return issues;
+}
+function getAtPath(root, path) {
+    if (!path || path === "/")
+        return root;
+    const segments = path.split("/").filter(Boolean);
+    let current = root;
+    for (const segment of segments) {
+        if (!isRecord(current) && !Array.isArray(current))
+            return undefined;
+        if (Array.isArray(current)) {
+            const index = Number(segment);
+            if (!Number.isInteger(index))
+                return undefined;
+            current = current[index];
+            continue;
+        }
+        current = current[segment];
+    }
+    return current;
+}
+function collectDataModelRoots(messages) {
+    const roots = new Map();
+    for (const message of messages) {
+        const payload = message.updateDataModel ?? message.dataModelUpdate;
+        if (!isRecord(payload) || typeof payload.surfaceId !== "string")
+            continue;
+        const path = typeof payload.path === "string" ? payload.path : "/";
+        if (path === "/") {
+            roots.set(payload.surfaceId, payload.value ?? payload.contents);
+        }
+    }
+    return roots;
+}
+function textPathFromProp(value) {
+    if (isRecord(value) && typeof value.path === "string" && value.path.trim()) {
+        return value.path.trim();
+    }
+    return null;
+}
+export function findObjectTextBindingIssues(messages, options) {
+    const coerced = resolveMessages(messages, options);
+    const roots = collectDataModelRoots(coerced);
+    const issues = [];
+    for (const message of coerced) {
+        const payload = message.updateComponents ?? message.surfaceUpdate;
+        if (!isRecord(payload) || !Array.isArray(payload.components))
+            continue;
+        const surfaceId = typeof payload.surfaceId === "string" ? payload.surfaceId : "default";
+        const root = roots.get(surfaceId);
+        for (const raw of payload.components) {
+            if (!isRecord(raw) || typeof raw.id !== "string")
+                continue;
+            const type = componentTypeFromRaw(raw);
+            if (type !== "Text")
+                continue;
+            const path = textPathFromProp(raw.text);
+            if (!path)
+                continue;
+            const value = getAtPath(root, path);
+            if (isRecord(value) && !Array.isArray(value)) {
+                issues.push({ componentId: raw.id, path });
+            }
+        }
+    }
+    return issues;
+}
+function formatTabTitleForMessage(title) {
+    if (typeof title === "string")
+        return title;
+    if (typeof title === "object" &&
+        title !== null &&
+        "path" in title &&
+        typeof title.path === "string") {
+        return title.path;
+    }
+    return "(dynamic title)";
+}
+export function findTabsConfigurationIssues(messages, options) {
+    const coerced = resolveMessages(messages, options);
+    const componentIds = collectComponentIds(messages, options);
+    const issues = [];
+    for (const message of coerced) {
+        const payload = message.updateComponents ?? message.surfaceUpdate;
+        if (!isRecord(payload) || !Array.isArray(payload.components))
+            continue;
+        for (const raw of payload.components) {
+            if (!isRecord(raw))
+                continue;
+            const type = componentTypeFromRaw(raw);
+            if (type !== "Tabs" || typeof raw.id !== "string")
+                continue;
+            const props = { ...raw };
+            delete props.id;
+            delete props.component;
+            delete props.type;
+            if (isRecord(raw.props)) {
+                Object.assign(props, raw.props);
+            }
+            const tabs = normalizeTabsArray(props);
+            if (tabs.length === 0) {
+                issues.push({
+                    componentId: raw.id,
+                    detail: 'Tabs needs a "tabs" array of {title, child} entries. Use string titles, {"path":"..."} for dynamic titles, and updateDataModel for values.',
+                });
+                continue;
+            }
+            for (const tab of tabs) {
+                if (!componentIds.has(tab.child)) {
+                    issues.push({
+                        componentId: raw.id,
+                        detail: `Tabs references missing component "${tab.child}" (tab ${formatTabTitleForMessage(tab.title)}).`,
+                    });
+                }
+            }
+        }
+    }
+    return issues;
+}
+//# sourceMappingURL=catalogDiagnostics.js.map

package/dist/catalogDiagnostics.js.map

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

package/dist/catalogIds.d.ts

@@ -0,0 +1,5 @@
+/** Canonical shared surface catalog id (generated catalog.json). */
+export declare const WATT42_SHARED_UI_CATALOG: string;
+/** Missing/invalid/retired catalogId → canonical shared catalog. */
+export declare function resolveCatalogId(catalogId: unknown): string;
+//# sourceMappingURL=catalogIds.d.ts.map

package/dist/catalogIds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalogIds.d.ts","sourceRoot":"","sources":["../src/catalogIds.ts"],"names":[],"mappings":"AAEA,oEAAoE;AACpE,eAAO,MAAM,wBAAwB,QAAyB,CAAC;AAI/D,oEAAoE;AACpE,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,OAAO,GAAG,MAAM,CAQ3D"}

package/dist/catalogIds.js

@@ -0,0 +1,15 @@
+import { getCatalog } from "@watt42/a2ui-component-catalog";
+/** Canonical shared surface catalog id (generated catalog.json). */
+export const WATT42_SHARED_UI_CATALOG = getCatalog().catalogId;
+const RETIRED_CATALOG_IDS = new Set(["watt42:a2ui:catalog:shadcn:v1"]);
+/** Missing/invalid/retired catalogId → canonical shared catalog. */
+export function resolveCatalogId(catalogId) {
+    if (typeof catalogId !== "string" || !catalogId.trim()) {
+        return WATT42_SHARED_UI_CATALOG;
+    }
+    if (RETIRED_CATALOG_IDS.has(catalogId.trim())) {
+        return WATT42_SHARED_UI_CATALOG;
+    }
+    return catalogId;
+}
+//# sourceMappingURL=catalogIds.js.map

package/dist/catalogIds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalogIds.js","sourceRoot":"","sources":["../src/catalogIds.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAE5D,oEAAoE;AACpE,MAAM,CAAC,MAAM,wBAAwB,GAAG,UAAU,EAAE,CAAC,SAAS,CAAC;AAE/D,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC,CAAC,+BAA+B,CAAC,CAAC,CAAC;AAEvE,oEAAoE;AACpE,MAAM,UAAU,gBAAgB,CAAC,SAAkB;IACjD,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,CAAC;QACvD,OAAO,wBAAwB,CAAC;IAClC,CAAC;IACD,IAAI,mBAAmB,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;QAC9C,OAAO,wBAAwB,CAAC;IAClC,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+import type { A2UiMessage, UIServiceConfig, ValidationResult } from "./types.js";
+import { A2UI_VERSION } from "./types.js";
+export type { A2UiMessage, ValidationResult, UIServiceConfig };
+export { A2UI_VERSION };
+export { coerceA2UiMessages, normalizeProcessorComponents, countRenderableComponents, hasUpdateComponentsMessage, isDynamicBindingValue, resolveSurfaceId, normalizeTabsArray, type TabEntry, } from "./normalize.js";
+export { prepareA2UiMessagesForProcessor } from "./prepare.js";
+export { buildA2UiDiagnostics, a2uiSurfaceHasWarnings, type A2UiDiagnostics, } from "./a2uiDiagnostics.js";
+export { formatMissingComponentReferenceDetail, formatUnsupportedComponentHint, getSupportedCatalogComponentNames, type MissingComponentReferenceIssue, type ObjectTextBindingIssue, type TabsConfigurationIssue, type UnsupportedComponentIssue, } from "./catalogDiagnostics.js";
+export { WATT42_SHARED_UI_CATALOG, resolveCatalogId, } from "./catalogIds.js";
+export declare class UIService {
+    private readonly config;
+    constructor(config?: UIServiceConfig);
+    validate(messages: A2UiMessage[]): ValidationResult;
+    prepare(messages: A2UiMessage[]): A2UiMessage[];
+    get catalogId(): string | undefined;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,eAAe,EAAE,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,CAAC;AAExB,OAAO,EACL,kBAAkB,EAClB,4BAA4B,EAC5B,yBAAyB,EACzB,0BAA0B,EAC1B,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,EAClB,KAAK,QAAQ,GACd,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,+BAA+B,EAAE,MAAM,cAAc,CAAC;AAE/D,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,KAAK,eAAe,GACrB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,qCAAqC,EACrC,8BAA8B,EAC9B,iCAAiC,EACjC,KAAK,8BAA8B,EACnC,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAC3B,KAAK,yBAAyB,GAC/B,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,wBAAwB,EACxB,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AAEzB,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;gBAE7B,MAAM,GAAE,eAAoB;IAIxC,QAAQ,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,gBAAgB;IAcnD,OAAO,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,WAAW,EAAE;IAI/C,IAAI,SAAS,IAAI,MAAM,GAAG,SAAS,CAElC;CACF"}

package/dist/index.js

@@ -0,0 +1,35 @@
+import { buildA2UiDiagnostics } from "./a2uiDiagnostics.js";
+import { prepareA2UiMessagesForProcessor } from "./prepare.js";
+import { A2UI_VERSION } from "./types.js";
+export { A2UI_VERSION };
+export { coerceA2UiMessages, normalizeProcessorComponents, countRenderableComponents, hasUpdateComponentsMessage, isDynamicBindingValue, resolveSurfaceId, normalizeTabsArray, } from "./normalize.js";
+export { prepareA2UiMessagesForProcessor } from "./prepare.js";
+export { buildA2UiDiagnostics, a2uiSurfaceHasWarnings, } from "./a2uiDiagnostics.js";
+export { formatMissingComponentReferenceDetail, formatUnsupportedComponentHint, getSupportedCatalogComponentNames, } from "./catalogDiagnostics.js";
+export { WATT42_SHARED_UI_CATALOG, resolveCatalogId, } from "./catalogIds.js";
+export class UIService {
+    config;
+    constructor(config = {}) {
+        this.config = config;
+    }
+    validate(messages) {
+        const diagnostics = buildA2UiDiagnostics(messages, {
+            renderer: "surface",
+        });
+        const errors = [];
+        for (const issue of diagnostics.unsupportedComponents) {
+            errors.push(`Unsupported component: ${issue.component}`);
+        }
+        if (diagnostics.missingDataModel) {
+            errors.push("Missing updateDataModel for path-bound fields");
+        }
+        return { ok: errors.length === 0, errors };
+    }
+    prepare(messages) {
+        return prepareA2UiMessagesForProcessor(messages);
+    }
+    get catalogId() {
+        return this.config.catalogId;
+    }
+}
+//# 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,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,+BAA+B,EAAE,MAAM,cAAc,CAAC;AAE/D,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG1C,OAAO,EAAE,YAAY,EAAE,CAAC;AAExB,OAAO,EACL,kBAAkB,EAClB,4BAA4B,EAC5B,yBAAyB,EACzB,0BAA0B,EAC1B,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,GAEnB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,+BAA+B,EAAE,MAAM,cAAc,CAAC;AAE/D,OAAO,EACL,oBAAoB,EACpB,sBAAsB,GAEvB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,qCAAqC,EACrC,8BAA8B,EAC9B,iCAAiC,GAKlC,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,wBAAwB,EACxB,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AAEzB,MAAM,OAAO,SAAS;IACH,MAAM,CAAkB;IAEzC,YAAY,SAA0B,EAAE;QACtC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,QAAQ,CAAC,QAAuB;QAC9B,MAAM,WAAW,GAAG,oBAAoB,CAAC,QAAQ,EAAE;YACjD,QAAQ,EAAE,SAAS;SACpB,CAAC,CAAC;QACH,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,qBAAqB,EAAE,CAAC;YACtD,MAAM,CAAC,IAAI,CAAC,0BAA0B,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC;QAC3D,CAAC;QACD,IAAI,WAAW,CAAC,gBAAgB,EAAE,CAAC;YACjC,MAAM,CAAC,IAAI,CAAC,+CAA+C,CAAC,CAAC;QAC/D,CAAC;QACD,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7C,CAAC;IAED,OAAO,CAAC,QAAuB;QAC7B,OAAO,+BAA+B,CAAC,QAAQ,CAAC,CAAC;IACnD,CAAC;IAED,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC;IAC/B,CAAC;CACF"}

package/dist/normalize.d.ts

@@ -0,0 +1,44 @@
+/**
+ * A2UI message and component normalization (prepare pipeline).
+ *
+ * ## Dynamic UI (what we preserve)
+ * - Data bindings: `{ "path": "/field" }` on Chart, Input, tab titles, etc.
+ * - Literals from the data model: `updateDataModel` + optional `literalString` in props.
+ * - Function-call bindings when present in incoming JSON.
+ *
+ * ## What we do NOT do (no hardcoded content)
+ * - No static component name lists (use the generated catalog / registry).
+ * - No invented tab titles ("Tab 1"), no Python `SystemState` defaults, no template substitution.
+ *
+ * ## Structural-only transforms (shape repair)
+ * - Message key coercion (`type` → `createSurface` / `updateComponents` / `updateDataModel`).
+ * - Flat component extraction, Card single-child wrapper, Tabs `tabItems` → `tabs`, Chart field aliases.
+ */
+import type { A2UiMessage } from "./types.js";
+/** True when value is already an A2UI dynamic binding (not a static string to rewrite). */
+export declare function isDynamicBindingValue(value: unknown): boolean;
+/** Resolve surface id from v0.9 payloads (models sometimes use `id` instead of `surfaceId`). */
+export declare function resolveSurfaceId(payload: Record<string, unknown>, fallback?: string): string;
+/** Ensure createSurface / deleteSurface / beginRendering payloads use `surfaceId`. */
+export declare function normalizeSurfacePayload(payload: Record<string, unknown>): Record<string, unknown>;
+/** Coerce `{ "type": "updateComponents", ... }` into proper A2UI v0.9 message keys. */
+export declare function coerceA2UiMessages(messages: A2UiMessage[]): A2UiMessage[];
+/** A2UI DynamicString: literal, path binding, or literalString wrapper. */
+export type TabTitleValue = string | {
+    path: string;
+} | {
+    literalString: string;
+};
+export interface TabEntry {
+    title: TabTitleValue;
+    child: string;
+}
+/**
+ * Canonical A2UI v0.9 Tabs `tabs` array: [{ title, child }].
+ * Preserves dynamic titles (`path` bindings). Does not invent placeholder titles.
+ */
+export declare function normalizeTabsArray(props: Record<string, unknown>): TabEntry[];
+export declare function normalizeProcessorComponents(rawComponents: unknown[]): Record<string, unknown>[];
+export declare function countRenderableComponents(messages: A2UiMessage[]): number;
+export declare function hasUpdateComponentsMessage(messages: A2UiMessage[]): boolean;
+//# sourceMappingURL=normalize.d.ts.map

package/dist/normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../src/normalize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AA4B9C,2FAA2F;AAC3F,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAQ7D;AAED,gGAAgG;AAChG,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,QAAQ,SAAqB,GAC5B,MAAM,CAQR;AAMD,sFAAsF;AACtF,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAIzB;AAiBD,uFAAuF;AACvF,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,WAAW,EAAE,CAsGzE;AA2DD,2EAA2E;AAC3E,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,aAAa,EAAE,MAAM,CAAA;CAAE,CAAA;AAEjF,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,aAAa,CAAA;IACpB,KAAK,EAAE,MAAM,CAAA;CACd;AA6BD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,QAAQ,EAAE,CA0B7E;AAyGD,wBAAgB,4BAA4B,CAAC,aAAa,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAyChG;AA2BD,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,MAAM,CAEzE;AAED,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,OAAO,CAO3E"}