@adia-ai/a2ui 0.8.37 → 0.8.39

package/catalog/common_types.d.ts

@@ -0,0 +1,5 @@
+// JSON-module type stub — the `types` conditional for
+// `@adia-ai/a2ui/catalog/common-types`. Real declarations land with the
+// TS-migration phase that generates them (same posture as
+// catalog-a2ui_0_9.d.ts).
+export {};

package/catalog/common_types.json

@@ -0,0 +1,222 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://adiaui.dev/a2ui/v0_9/common_types.json",
+  "title": "AdiaUI A2UI Common Types",
+  "description": "Shared structural primitives used by every AdiaUI catalog component. Modeled after Google A2UI v0.9 (github.com/google/A2UI/blob/main/specification/v0_9/json/common_types.json) so catalogs produced here remain shape-compatible with the public spec. An authoring-time dependency — at publish time, scripts/build-components.mjs inlines these entries into the assembled catalog's $defs.",
+
+  "$defs": {
+    "ComponentId": {
+      "type": "string",
+      "description": "Reference to another component's id within the same surface. Validators follow this ref to verify the target exists."
+    },
+
+    "ChildList": {
+      "oneOf": [
+        {
+          "type": "array",
+          "items": { "$ref": "#/$defs/ComponentId" },
+          "description": "A static list of child component ids."
+        },
+        {
+          "type": "object",
+          "description": "A template-driven list: binds a data model list and stamps a component template per item.",
+          "properties": {
+            "path": { "type": "string" },
+            "componentId": { "$ref": "#/$defs/ComponentId" }
+          },
+          "required": ["path", "componentId"],
+          "additionalProperties": false
+        }
+      ]
+    },
+
+    "DynamicString": {
+      "oneOf": [
+        { "type": "string" },
+        {
+          "type": "object",
+          "properties": { "path": { "type": "string" } },
+          "required": ["path"],
+          "additionalProperties": false,
+          "description": "Binds to a JSON Pointer in the surface's data model."
+        },
+        { "$ref": "#/$defs/FunctionCall" }
+      ],
+      "description": "A string that may be a literal, a path-bound reference, or the result of a FunctionCall."
+    },
+
+    "DynamicNumber": {
+      "oneOf": [
+        { "type": "number" },
+        {
+          "type": "object",
+          "properties": { "path": { "type": "string" } },
+          "required": ["path"],
+          "additionalProperties": false
+        },
+        { "$ref": "#/$defs/FunctionCall" }
+      ]
+    },
+
+    "DynamicBoolean": {
+      "oneOf": [
+        { "type": "boolean" },
+        {
+          "type": "object",
+          "properties": { "path": { "type": "string" } },
+          "required": ["path"],
+          "additionalProperties": false
+        },
+        { "$ref": "#/$defs/FunctionCall" }
+      ]
+    },
+
+    "DynamicStringList": {
+      "oneOf": [
+        { "type": "array", "items": { "type": "string" } },
+        {
+          "type": "object",
+          "properties": { "path": { "type": "string" } },
+          "required": ["path"],
+          "additionalProperties": false
+        },
+        { "$ref": "#/$defs/FunctionCall" }
+      ]
+    },
+
+    "DynamicObjectList": {
+      "oneOf": [
+        { "type": "array", "items": { "type": "object" } },
+        {
+          "type": "object",
+          "properties": { "path": { "type": "string" } },
+          "required": ["path"],
+          "additionalProperties": false
+        },
+        { "$ref": "#/$defs/FunctionCall" }
+      ],
+      "description": "An array of plain objects (e.g. chart/table row records) that may be a literal, a path-bound reference, or the result of a FunctionCall. TKT-0010: split from DynamicStringList, which only ever accepted array-of-string — the wrong shape for JS-set collection props whose items are records."
+    },
+
+    "FunctionCall": {
+      "type": "object",
+      "properties": {
+        "call": { "type": "string", "description": "Name of a function registered in the catalog's `functions` dictionary." },
+        "args": { "type": "object", "description": "Named arguments; shape validated by the function's own schema entry." }
+      },
+      "required": ["call"],
+      "additionalProperties": false,
+      "description": "A reference to a client-side function. No code crosses the wire — only names and typed arguments."
+    },
+
+    "AccessibilityAttributes": {
+      "type": "object",
+      "properties": {
+        "label":       { "$ref": "#/$defs/DynamicString", "description": "Short label (1–3 words) used by assistive tech." },
+        "description": { "$ref": "#/$defs/DynamicString", "description": "Additional instructions/context for assistive tech." }
+      },
+      "additionalProperties": false
+    },
+
+    "ComponentCommon": {
+      "type": "object",
+      "properties": {
+        "id":            { "$ref": "#/$defs/ComponentId" },
+        "accessibility": { "$ref": "#/$defs/AccessibilityAttributes" }
+      },
+      "required": ["id"]
+    },
+
+    "CatalogComponentCommon": {
+      "type": "object",
+      "description": "Shared properties accepted by every AdiaUI catalog component. Split into three concerns: runtime hooks (visible, style, slot), universal child region (children), and global HTML attributes the renderer honors on every custom element (nomargin, truncate, grow, color, weight, size, align, justify, text). Per-component schemas can restrict these further via their own enum declarations; allOf composition means the stricter rule wins.",
+      "properties": {
+        "visible":  { "$ref": "#/$defs/DynamicBoolean", "description": "When false, the component is not rendered." },
+        "style":    { "type": "string", "description": "Inline CSS string applied to the host element (use sparingly; prefer variants)." },
+        "slot":     { "type": "string", "description": "Named slot to project into when child of a slotted container." },
+
+        "children": { "$ref": "#/$defs/ChildList",      "description": "Ordered list of child component ids (or a template binding)." },
+
+        "nomargin": { "$ref": "#/$defs/DynamicBoolean", "description": "Remove default block margins (typography + prose elements)." },
+        "truncate": { "$ref": "#/$defs/DynamicBoolean", "description": "Single-line ellipsis when the container constrains width." },
+        "grow":     { "$ref": "#/$defs/DynamicBoolean", "description": "flex: 1 — fills remaining space in a flex parent (row-ui/col-ui)." },
+
+        "color":    { "$ref": "#/$defs/DynamicString",  "description": "Foreground color role. Common values: text, text-strong, subtle, muted, accent, success, warning, danger, info." },
+        "weight":   { "$ref": "#/$defs/DynamicString",  "description": "Font weight role. Common values: thin, light, normal, medium, semibold, bold." },
+        "size":     { "$ref": "#/$defs/DynamicString",  "description": "Sizing role. Values: sm, md, lg (scale picks the table, size picks the row — denser/larger registers come from an ancestor [scale] tier). Per-component schemas may narrow." },
+        "align":    { "$ref": "#/$defs/DynamicString",  "description": "Alignment role. Values depend on container (flex cross-axis for row-ui/col-ui, text for typography)." },
+        "justify":  { "$ref": "#/$defs/DynamicString",  "description": "Main-axis justification for flex/grid containers." },
+        "text":     { "$ref": "#/$defs/DynamicString",  "description": "Short text payload rendered via CSS attr(text) on ::after (Button, Badge, Tag, etc.)." },
+        "prose":    { "$ref": "#/$defs/DynamicBoolean", "description": "Content-optimized spacing/typography for long-form prose containers." },
+        "icon":     { "$ref": "#/$defs/DynamicString",  "description": "Leading Phosphor icon name. Components that support leading icons render it; others ignore." },
+        "title":    { "$ref": "#/$defs/DynamicString",  "description": "Short heading/identifier. Used by EmptyState/Dialog/Modal etc. for heading slot shortcut." },
+        "label":    { "$ref": "#/$defs/DynamicString",  "description": "Accessible label or leading heading — aria-label or first-line text depending on component." },
+        "hidden":    { "$ref": "#/$defs/DynamicBoolean", "description": "HTML [hidden] — element not displayed but remains in the DOM." },
+        "textAlign": { "$ref": "#/$defs/DynamicString",  "description": "Text alignment — start, center, end, justify." },
+        "ariaLabel": { "$ref": "#/$defs/DynamicString",  "description": "Accessibility label (maps to aria-label at runtime)." },
+        "ariaHidden":{ "$ref": "#/$defs/DynamicBoolean", "description": "Accessibility hidden state (maps to aria-hidden at runtime)." },
+        "span":      { "$ref": "#/$defs/DynamicString",  "description": "Grid-child column span, read by grid-ui's CSS attribute selector ([span=\"N\"] { grid-column: span N }). Layout-bearing like slot — accepted on every component, not a per-component prop (TKT-0002/TKT-0010)." }
+      },
+      "patternProperties": {
+        "^data-": { "description": "Arbitrary data-* attribute — a JS/CSS hook the transpiler passes through verbatim (TKT-0010); not modeled per-component." }
+      }
+    },
+
+    "Action": {
+      "type": "object",
+      "description": "An event handler binding. The `event` identifies which AdiaEvent to match; `handler` names a registered handler function; `config` supplies handler arguments.",
+      "properties": {
+        "event":     { "$ref": "#/$defs/Event" },
+        "handler":   { "type": "string", "description": "Handler name registered in the wiring registry." },
+        "config":    { "type": "object", "description": "Handler-specific configuration (URL, path, payload, etc.)." },
+        "onSuccess": { "type": "array", "items": { "$ref": "#/$defs/Action" } },
+        "onError":   { "type": "array", "items": { "$ref": "#/$defs/Action" } }
+      },
+      "required": ["event", "handler"],
+      "additionalProperties": false
+    },
+
+    "Event": {
+      "type": "object",
+      "description": "A typed event selector. Matches events fired by components (submit, input, click, mount, etc.) optionally scoped to a component id.",
+      "properties": {
+        "event":     { "type": "string", "description": "Event type name (e.g. 'submit', 'input', 'press')." },
+        "target":    { "$ref": "#/$defs/ComponentId", "description": "Optional — scopes the match to a specific component. Omit for surface-level events." },
+        "debounce":  { "type": "number", "description": "Debounce window in ms." },
+        "throttle":  { "type": "number", "description": "Throttle window in ms." },
+        "condition": {
+          "type": "object",
+          "description": "Guard — the action only fires when the condition holds.",
+          "properties": {
+            "path":      { "type": "string" },
+            "equals":    {},
+            "notEquals": {},
+            "exists":    { "type": "boolean" }
+          }
+        }
+      },
+      "required": ["event"],
+      "additionalProperties": false
+    },
+
+    "Checkable": {
+      "type": "object",
+      "description": "Mixed into components that support validation checks (Input, TextArea, Button, etc.). Failed checks block dependent actions (e.g. a Button with unmet checks is auto-disabled).",
+      "properties": {
+        "checks": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "call":         { "type": "string" },
+              "args":         { "type": "object" },
+              "errorMessage": { "$ref": "#/$defs/DynamicString" }
+            },
+            "required": ["call"],
+            "additionalProperties": false
+          }
+        }
+      }
+    }
+  }
+}

package/catalog/functions.d.ts

@@ -0,0 +1,5 @@
+// JSON-module type stub — the `types` conditional for
+// `@adia-ai/a2ui/catalog/functions`. Real declarations land with the
+// TS-migration phase that generates them (same posture as
+// catalog-a2ui_0_9.d.ts).
+export {};

package/catalog/functions.json

@@ -0,0 +1,253 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://adiaui.dev/a2ui/v0_9/functions.json",
+  "title": "AdiaUI A2UI Functions",
+  "description": "Client-side function vocabulary. Each function is a named routine with typed `args` and a declared `returnType`. Agents reference functions by name in `FunctionCall` objects (inside `checks` or anywhere a DynamicString/Number/Boolean is accepted). No code crosses the wire — only names and typed arguments. At publish time, scripts/build-components.mjs inlines these entries into the assembled catalog's `functions` key.",
+
+  "functions": {
+    "required": {
+      "type": "object",
+      "description": "Returns true when `value` is non-empty (non-null string, number, boolean, or array). Used in `checks` to gate Button enablement and surface inline errors.",
+      "properties": {
+        "call": { "const": "required" },
+        "args": {
+          "type": "object",
+          "properties": {
+            "value": { "$ref": "common_types.json#/$defs/DynamicString" }
+          },
+          "required": ["value"],
+          "additionalProperties": false
+        },
+        "returnType": { "const": "boolean" }
+      },
+      "required": ["call", "args"],
+      "unevaluatedProperties": false
+    },
+
+    "minLength": {
+      "type": "object",
+      "description": "Returns true when `value`'s length is at least `min`. Strings count characters; arrays count entries.",
+      "properties": {
+        "call": { "const": "minLength" },
+        "args": {
+          "type": "object",
+          "properties": {
+            "value": { "$ref": "common_types.json#/$defs/DynamicString" },
+            "min":   { "$ref": "common_types.json#/$defs/DynamicNumber" }
+          },
+          "required": ["value", "min"],
+          "additionalProperties": false
+        },
+        "returnType": { "const": "boolean" }
+      },
+      "required": ["call", "args"],
+      "unevaluatedProperties": false
+    },
+
+    "maxLength": {
+      "type": "object",
+      "description": "Returns true when `value`'s length is at most `max`.",
+      "properties": {
+        "call": { "const": "maxLength" },
+        "args": {
+          "type": "object",
+          "properties": {
+            "value": { "$ref": "common_types.json#/$defs/DynamicString" },
+            "max":   { "$ref": "common_types.json#/$defs/DynamicNumber" }
+          },
+          "required": ["value", "max"],
+          "additionalProperties": false
+        },
+        "returnType": { "const": "boolean" }
+      },
+      "required": ["call", "args"],
+      "unevaluatedProperties": false
+    },
+
+    "matchesPattern": {
+      "type": "object",
+      "description": "Returns true when `value` matches the regex `pattern` (tested as ^(?:pattern)$ — anchored full match).",
+      "properties": {
+        "call": { "const": "matchesPattern" },
+        "args": {
+          "type": "object",
+          "properties": {
+            "value":   { "$ref": "common_types.json#/$defs/DynamicString" },
+            "pattern": { "type": "string" }
+          },
+          "required": ["value", "pattern"],
+          "additionalProperties": false
+        },
+        "returnType": { "const": "boolean" }
+      },
+      "required": ["call", "args"],
+      "unevaluatedProperties": false
+    },
+
+    "isEmail": {
+      "type": "object",
+      "description": "Convenience check — returns true when `value` parses as a well-formed email address.",
+      "properties": {
+        "call": { "const": "isEmail" },
+        "args": {
+          "type": "object",
+          "properties": {
+            "value": { "$ref": "common_types.json#/$defs/DynamicString" }
+          },
+          "required": ["value"],
+          "additionalProperties": false
+        },
+        "returnType": { "const": "boolean" }
+      },
+      "required": ["call", "args"],
+      "unevaluatedProperties": false
+    },
+
+    "equals": {
+      "type": "object",
+      "description": "Returns true when `value` deep-equals `target`. Used for confirm-password checks (compare field to its sibling).",
+      "properties": {
+        "call": { "const": "equals" },
+        "args": {
+          "type": "object",
+          "properties": {
+            "value":  { "$ref": "common_types.json#/$defs/DynamicString" },
+            "target": { "$ref": "common_types.json#/$defs/DynamicString" }
+          },
+          "required": ["value", "target"],
+          "additionalProperties": false
+        },
+        "returnType": { "const": "boolean" }
+      },
+      "required": ["call", "args"],
+      "unevaluatedProperties": false
+    },
+
+    "formatString": {
+      "type": "object",
+      "description": "Template-interpolate a string using `${/abs/path}` for absolute JSON Pointers, `${rel/path}` for relative paths inside a template child scope, and `${fn(arg: value)}` for nested calls. The `${...}` grammar is ONLY legal inside this function's `value` arg; every other string property in A2UI is static or path-bound via DynamicString.",
+      "properties": {
+        "call": { "const": "formatString" },
+        "args": {
+          "type": "object",
+          "properties": {
+            "value": { "type": "string", "description": "Template. Supports ${path}, ${fn(...)}, \\${ escapes." }
+          },
+          "required": ["value"],
+          "additionalProperties": false
+        },
+        "returnType": { "const": "string" }
+      },
+      "required": ["call", "args"],
+      "unevaluatedProperties": false
+    },
+
+    "formatNumber": {
+      "type": "object",
+      "description": "Localize a number. `style` = decimal (default) | percent | unit. `unit` paired with style=unit. `maximumFractionDigits` + `minimumFractionDigits` control precision.",
+      "properties": {
+        "call": { "const": "formatNumber" },
+        "args": {
+          "type": "object",
+          "properties": {
+            "value":                  { "$ref": "common_types.json#/$defs/DynamicNumber" },
+            "style":                  { "enum": ["decimal", "percent", "unit"], "default": "decimal" },
+            "unit":                   { "type": "string" },
+            "minimumFractionDigits":  { "type": "number" },
+            "maximumFractionDigits":  { "type": "number" },
+            "locale":                 { "type": "string" }
+          },
+          "required": ["value"],
+          "additionalProperties": false
+        },
+        "returnType": { "const": "string" }
+      },
+      "required": ["call", "args"],
+      "unevaluatedProperties": false
+    },
+
+    "formatCurrency": {
+      "type": "object",
+      "description": "Render a numeric amount as currency in the given ISO-4217 code.",
+      "properties": {
+        "call": { "const": "formatCurrency" },
+        "args": {
+          "type": "object",
+          "properties": {
+            "value":    { "$ref": "common_types.json#/$defs/DynamicNumber" },
+            "currency": { "type": "string", "description": "ISO-4217 code (USD, EUR, JPY, …)." },
+            "locale":   { "type": "string" }
+          },
+          "required": ["value", "currency"],
+          "additionalProperties": false
+        },
+        "returnType": { "const": "string" }
+      },
+      "required": ["call", "args"],
+      "unevaluatedProperties": false
+    },
+
+    "formatDate": {
+      "type": "object",
+      "description": "Format a date (ISO string or epoch ms). `style` shortcuts: short/medium/long/full; or pass an explicit Intl options shape.",
+      "properties": {
+        "call": { "const": "formatDate" },
+        "args": {
+          "type": "object",
+          "properties": {
+            "value":  { "$ref": "common_types.json#/$defs/DynamicString" },
+            "style":  { "enum": ["short", "medium", "long", "full", "relative"] },
+            "locale": { "type": "string" }
+          },
+          "required": ["value"],
+          "additionalProperties": false
+        },
+        "returnType": { "const": "string" }
+      },
+      "required": ["call", "args"],
+      "unevaluatedProperties": false
+    },
+
+    "pluralize": {
+      "type": "object",
+      "description": "Pick a variant based on `count`. Supply `one` and `plural` (and optionally `zero` / `other`). The return is the chosen variant string.",
+      "properties": {
+        "call": { "const": "pluralize" },
+        "args": {
+          "type": "object",
+          "properties": {
+            "count":  { "$ref": "common_types.json#/$defs/DynamicNumber" },
+            "one":    { "type": "string" },
+            "plural": { "type": "string" },
+            "zero":   { "type": "string" },
+            "other":  { "type": "string" }
+          },
+          "required": ["count", "plural"],
+          "additionalProperties": false
+        },
+        "returnType": { "const": "string" }
+      },
+      "required": ["call", "args"],
+      "unevaluatedProperties": false
+    },
+
+    "not": {
+      "type": "object",
+      "description": "Logical negation — inverts a boolean result. Useful for composing custom checks.",
+      "properties": {
+        "call": { "const": "not" },
+        "args": {
+          "type": "object",
+          "properties": {
+            "value": { "$ref": "common_types.json#/$defs/DynamicBoolean" }
+          },
+          "required": ["value"],
+          "additionalProperties": false
+        },
+        "returnType": { "const": "boolean" }
+      },
+      "required": ["call", "args"],
+      "unevaluatedProperties": false
+    }
+  }
+}

package/catalog/tier-index.d.ts

@@ -0,0 +1,4 @@
+// JSON-module type stub — the `types` conditional for
+// `@adia-ai/a2ui/catalog/tiers`. Real declarations land with the TS-migration
+// phase that generates them (same posture as catalog-a2ui_0_9.d.ts).
+export {};