@cognitap/radiant 0.0.91 → 0.0.92

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (129) hide show
  1. package/CHANGELOG.md +11 -0
  2. package/dist/library/a2ui/A2uiPlaceholder.d.ts +14 -0
  3. package/dist/library/a2ui/A2uiPlaceholder.d.ts.map +1 -0
  4. package/dist/library/a2ui/A2uiPlaceholder.js +44 -0
  5. package/dist/library/a2ui/A2uiPlaceholder.js.map +1 -0
  6. package/dist/library/a2ui/A2uiSurface.d.ts +33 -0
  7. package/dist/library/a2ui/A2uiSurface.d.ts.map +1 -0
  8. package/dist/library/a2ui/A2uiSurface.js +542 -0
  9. package/dist/library/a2ui/A2uiSurface.js.map +1 -0
  10. package/dist/library/a2ui/accessibility.d.ts +31 -0
  11. package/dist/library/a2ui/accessibility.d.ts.map +1 -0
  12. package/dist/library/a2ui/accessibility.js +108 -0
  13. package/dist/library/a2ui/accessibility.js.map +1 -0
  14. package/dist/library/a2ui/accessibilityRules.d.ts +28 -0
  15. package/dist/library/a2ui/accessibilityRules.d.ts.map +1 -0
  16. package/dist/library/a2ui/accessibilityRules.js +73 -0
  17. package/dist/library/a2ui/accessibilityRules.js.map +1 -0
  18. package/dist/library/a2ui/catalogGenerator.d.ts +29 -0
  19. package/dist/library/a2ui/catalogGenerator.d.ts.map +1 -0
  20. package/dist/library/a2ui/catalogGenerator.js +578 -0
  21. package/dist/library/a2ui/catalogGenerator.js.map +1 -0
  22. package/dist/library/a2ui/coerce.d.ts +16 -0
  23. package/dist/library/a2ui/coerce.d.ts.map +1 -0
  24. package/dist/library/a2ui/coerce.js +254 -0
  25. package/dist/library/a2ui/coerce.js.map +1 -0
  26. package/dist/library/a2ui/entries.d.ts +6 -0
  27. package/dist/library/a2ui/entries.d.ts.map +1 -0
  28. package/dist/library/a2ui/entries.js +277 -0
  29. package/dist/library/a2ui/entries.js.map +1 -0
  30. package/dist/library/a2ui/fixtures.d.ts +38 -0
  31. package/dist/library/a2ui/fixtures.d.ts.map +1 -0
  32. package/dist/library/a2ui/fixtures.js +389 -0
  33. package/dist/library/a2ui/fixtures.js.map +1 -0
  34. package/dist/library/a2ui/index.d.ts +17 -0
  35. package/dist/library/a2ui/index.d.ts.map +1 -0
  36. package/dist/library/a2ui/index.js +9 -0
  37. package/dist/library/a2ui/index.js.map +1 -0
  38. package/dist/library/a2ui/protocolErrors.d.ts +13 -0
  39. package/dist/library/a2ui/protocolErrors.d.ts.map +1 -0
  40. package/dist/library/a2ui/protocolErrors.js +48 -0
  41. package/dist/library/a2ui/protocolErrors.js.map +1 -0
  42. package/dist/library/a2ui/registry.d.ts +58 -0
  43. package/dist/library/a2ui/registry.d.ts.map +1 -0
  44. package/dist/library/a2ui/registry.js +128 -0
  45. package/dist/library/a2ui/registry.js.map +1 -0
  46. package/dist/library/a2ui/sanitize.d.ts +7 -0
  47. package/dist/library/a2ui/sanitize.d.ts.map +1 -0
  48. package/dist/library/a2ui/sanitize.js +54 -0
  49. package/dist/library/a2ui/sanitize.js.map +1 -0
  50. package/dist/library/a2ui/surfaceRuntime.d.ts +34 -0
  51. package/dist/library/a2ui/surfaceRuntime.d.ts.map +1 -0
  52. package/dist/library/a2ui/surfaceRuntime.js +284 -0
  53. package/dist/library/a2ui/surfaceRuntime.js.map +1 -0
  54. package/dist/library/catalog/actions.d.ts +40 -0
  55. package/dist/library/catalog/actions.d.ts.map +1 -0
  56. package/dist/library/catalog/actions.js +70 -0
  57. package/dist/library/catalog/actions.js.map +1 -0
  58. package/dist/library/catalog/coerce.d.ts +70 -0
  59. package/dist/library/catalog/coerce.d.ts.map +1 -0
  60. package/dist/library/catalog/coerce.js +332 -0
  61. package/dist/library/catalog/coerce.js.map +1 -0
  62. package/dist/library/catalog/index.d.ts +9 -0
  63. package/dist/library/catalog/index.d.ts.map +1 -0
  64. package/dist/library/catalog/index.js +6 -0
  65. package/dist/library/catalog/index.js.map +1 -0
  66. package/dist/library/catalog/radiantCatalog.d.ts +9 -0
  67. package/dist/library/catalog/radiantCatalog.d.ts.map +1 -0
  68. package/dist/library/catalog/radiantCatalog.js +902 -0
  69. package/dist/library/catalog/radiantCatalog.js.map +1 -0
  70. package/dist/library/catalog/types.d.ts +113 -0
  71. package/dist/library/catalog/types.d.ts.map +1 -0
  72. package/dist/library/catalog/types.js +27 -0
  73. package/dist/library/catalog/types.js.map +1 -0
  74. package/dist/library/catalog/validate.d.ts +31 -0
  75. package/dist/library/catalog/validate.d.ts.map +1 -0
  76. package/dist/library/catalog/validate.js +420 -0
  77. package/dist/library/catalog/validate.js.map +1 -0
  78. package/dist/library/components/Card/Card.d.ts +6 -2
  79. package/dist/library/components/Card/Card.d.ts.map +1 -1
  80. package/dist/library/components/Card/Card.js +12 -4
  81. package/dist/library/components/Card/Card.js.map +1 -1
  82. package/dist/library/components/Table/Table.d.ts +6 -2
  83. package/dist/library/components/Table/Table.d.ts.map +1 -1
  84. package/dist/library/components/Table/Table.js +10 -4
  85. package/dist/library/components/Table/Table.js.map +1 -1
  86. package/dist/library/index.d.ts +1 -1
  87. package/dist/library/index.d.ts.map +1 -1
  88. package/dist/library/presentation.d.ts +3 -0
  89. package/dist/library/presentation.d.ts.map +1 -1
  90. package/dist/library/styles.css +1 -1
  91. package/dist/library/themes/components.d.ts +6 -0
  92. package/dist/library/themes/components.d.ts.map +1 -1
  93. package/dist/library/themes/components.js +6 -0
  94. package/dist/library/themes/components.js.map +1 -1
  95. package/dist/library/themes/tokens.d.ts +4 -0
  96. package/dist/library/themes/tokens.d.ts.map +1 -1
  97. package/dist/library/themes/tokens.js +3 -0
  98. package/dist/library/themes/tokens.js.map +1 -1
  99. package/docs/accessibility.md +6 -0
  100. package/docs/architecture.md +13 -1
  101. package/docs/theming.md +13 -0
  102. package/package.json +17 -5
  103. package/src/a2ui/A2uiPlaceholder.tsx +64 -0
  104. package/src/a2ui/A2uiSurface.tsx +790 -0
  105. package/src/a2ui/accessibility.ts +145 -0
  106. package/src/a2ui/accessibilityRules.ts +106 -0
  107. package/src/a2ui/catalog.json +317 -0
  108. package/src/a2ui/catalogGenerator.ts +717 -0
  109. package/src/a2ui/coerce.ts +379 -0
  110. package/src/a2ui/entries.tsx +519 -0
  111. package/src/a2ui/fixtures.ts +402 -0
  112. package/src/a2ui/index.ts +50 -0
  113. package/src/a2ui/protocolErrors.ts +63 -0
  114. package/src/a2ui/registry.ts +221 -0
  115. package/src/a2ui/sanitize.ts +51 -0
  116. package/src/a2ui/surfaceRuntime.ts +317 -0
  117. package/src/catalog/actions.ts +108 -0
  118. package/src/catalog/coerce.ts +447 -0
  119. package/src/catalog/index.ts +67 -0
  120. package/src/catalog/radiantCatalog.ts +949 -0
  121. package/src/catalog/types.ts +159 -0
  122. package/src/catalog/validate.ts +454 -0
  123. package/src/components/Card/Card.tsx +35 -19
  124. package/src/components/Table/Table.tsx +16 -3
  125. package/src/index.ts +1 -1
  126. package/src/presentation.ts +3 -0
  127. package/src/themes/baseline.css +3 -0
  128. package/src/themes/components.ts +6 -0
  129. package/src/themes/tokens.ts +7 -0
@@ -0,0 +1,128 @@
1
+ import { Catalog as WebCoreCatalog } from '@a2ui/web_core/catalog';
2
+ import { findForbiddenPropsInSchema } from '../catalog/index.js';
3
+ import { A2UI_PROTOCOL_VERSION } from './catalogGenerator.js';
4
+ const ENTRY_NAME_PATTERN = /^[A-Z][A-Za-z0-9]*$/;
5
+ function findForbiddenInA2uiSchema(schema, path) {
6
+ const violations = [...findForbiddenPropsInSchema(schema, path)];
7
+ if (Array.isArray(schema.allOf)) {
8
+ for (let i = 0; i < schema.allOf.length; i++) {
9
+ const branch = schema.allOf[i];
10
+ if (branch && typeof branch === 'object') {
11
+ violations.push(...findForbiddenInA2uiSchema(branch, `${path}.allOf[${i}]`));
12
+ }
13
+ }
14
+ }
15
+ return violations;
16
+ }
17
+ /**
18
+ * Defines a single validated A2UI registry entry pairing a Radiant component,
19
+ * its curated JSON Schema, its agent-facing description, and its prop adapter.
20
+ */
21
+ export function createA2uiRegistryEntry(input) {
22
+ if (typeof input.name !== 'string' || !ENTRY_NAME_PATTERN.test(input.name)) {
23
+ throw new TypeError(`A2UI registry entry name must be PascalCase; received "${input.name}".`);
24
+ }
25
+ if (typeof input.description !== 'string' || !input.description.trim()) {
26
+ throw new TypeError(`A2UI registry entry "${input.name}" requires a non-empty description.`);
27
+ }
28
+ if (!input.schema || typeof input.schema !== 'object' || Array.isArray(input.schema)) {
29
+ throw new TypeError(`A2UI registry entry "${input.name}" requires a JSON Schema object.`);
30
+ }
31
+ if (typeof input.adapter !== 'function') {
32
+ throw new TypeError(`A2UI registry entry "${input.name}" requires an adapter function.`);
33
+ }
34
+ if (!Array.isArray(input.accessibility)) {
35
+ throw new TypeError(`A2UI registry entry "${input.name}" must declare accessibility rules.`);
36
+ }
37
+ if (!input.accessibility.every(rule => rule && typeof rule.id === 'string' && rule.id && typeof rule.check === 'function')) {
38
+ throw new TypeError(`A2UI registry entry "${input.name}" has an accessibility rule without an id or check function.`);
39
+ }
40
+ const forbidden = findForbiddenInA2uiSchema(input.schema, `${input.name}.schema`);
41
+ if (forbidden.length > 0) {
42
+ throw new TypeError(`A2UI registry entry "${input.name}" exposes forbidden props: ${forbidden.join(', ')}.`);
43
+ }
44
+ return Object.freeze({
45
+ name: input.name,
46
+ component: input.component,
47
+ schema: structuredClone(input.schema),
48
+ description: input.description,
49
+ adapter: input.adapter,
50
+ accessibility: Object.freeze([...input.accessibility])
51
+ });
52
+ }
53
+ /**
54
+ * Builds an immutable A2UI 1.0 registry that generates both its JSON Schema catalog
55
+ * document and its executable `@a2ui/web_core` catalog from the same entry list.
56
+ */
57
+ export function createA2uiRegistry(input) {
58
+ if (typeof input.catalogId !== 'string' || !input.catalogId.trim()) {
59
+ throw new TypeError('A2UI registry requires a non-empty catalogId.');
60
+ }
61
+ if (typeof input.title !== 'string' || !input.title.trim()) {
62
+ throw new TypeError('A2UI registry requires a non-empty title.');
63
+ }
64
+ if (typeof input.description !== 'string' || !input.description.trim()) {
65
+ throw new TypeError('A2UI registry requires a non-empty description.');
66
+ }
67
+ if (!Array.isArray(input.entries) || input.entries.length === 0) {
68
+ throw new TypeError('A2UI registry requires at least one entry.');
69
+ }
70
+ const entryMap = {};
71
+ for (const entry of input.entries) {
72
+ if (Object.hasOwn(entryMap, entry.name)) {
73
+ throw new TypeError(`Duplicate A2UI registry entry "${entry.name}".`);
74
+ }
75
+ const validated = createA2uiRegistryEntry(entry);
76
+ entryMap[validated.name] = validated;
77
+ }
78
+ const frozenEntries = Object.freeze(entryMap);
79
+ const buildDocument = () => {
80
+ const components = {};
81
+ for (const [name, entry] of Object.entries(frozenEntries)) {
82
+ components[name] = structuredClone(entry.schema);
83
+ }
84
+ return {
85
+ $schema: 'https://json-schema.org/draft/2020-12/schema',
86
+ $id: input.catalogId,
87
+ catalogId: input.catalogId,
88
+ protocolVersion: A2UI_PROTOCOL_VERSION,
89
+ title: input.title,
90
+ description: input.description,
91
+ components,
92
+ functions: {},
93
+ $defs: {
94
+ anyComponent: {
95
+ oneOf: Object.keys(components).map(name => ({ $ref: `#/components/${name}` })),
96
+ discriminator: { propertyName: 'component' }
97
+ },
98
+ anyFunction: { not: {} },
99
+ Weight: {
100
+ type: 'number',
101
+ description: 'Relative flex growth of this component inside a Row or Column. Set it only on direct children of a Row or Column.'
102
+ }
103
+ }
104
+ };
105
+ };
106
+ let cachedCatalog;
107
+ return Object.freeze({
108
+ catalogId: input.catalogId,
109
+ title: input.title,
110
+ description: input.description,
111
+ entries: frozenEntries,
112
+ toCatalogJson() {
113
+ return buildDocument();
114
+ },
115
+ toWebCoreCatalog() {
116
+ if (!cachedCatalog) {
117
+ const parsed = WebCoreCatalog.fromJson(buildDocument(), A2UI_PROTOCOL_VERSION);
118
+ cachedCatalog = new WebCoreCatalog(parsed.id, A2UI_PROTOCOL_VERSION, [...parsed.components.values()], [], {
119
+ defs: parsed.defs,
120
+ title: parsed.title,
121
+ description: parsed.description
122
+ });
123
+ }
124
+ return cachedCatalog;
125
+ }
126
+ });
127
+ }
128
+ //# sourceMappingURL=registry.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/a2ui/registry.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,7 @@
1
+ export type A2uiMessage = Readonly<Record<string, unknown>>;
2
+ /**
3
+ * Returns a copy of incoming A2UI messages with agent-supplied theme hints stripped so
4
+ * the surrounding Radiant ThemeScope remains the sole styling authority.
5
+ */
6
+ export declare function sanitizeA2uiMessages(messages: readonly A2uiMessage[]): readonly A2uiMessage[];
7
+ //# sourceMappingURL=sanitize.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sanitize.d.ts","sourceRoot":"","sources":["../../../src/a2ui/sanitize.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;AAkC3D;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,GAAG,SAAS,WAAW,EAAE,CAY7F"}
@@ -0,0 +1,54 @@
1
+ function stripThemeFromObject(value) {
2
+ const next = {};
3
+ for (const [key, entry] of Object.entries(value)) {
4
+ if (key === 'theme')
5
+ continue;
6
+ if (key === 'metadata' && entry && typeof entry === 'object' && !Array.isArray(entry)) {
7
+ const cleanedMeta = stripThemeFromMetadata(entry);
8
+ if (Object.keys(cleanedMeta).length > 0)
9
+ next.metadata = cleanedMeta;
10
+ continue;
11
+ }
12
+ next[key] = entry;
13
+ }
14
+ return next;
15
+ }
16
+ function stripThemeFromMetadata(metadata) {
17
+ const next = {};
18
+ for (const [key, entry] of Object.entries(metadata)) {
19
+ if (key === 'theme')
20
+ continue;
21
+ if (key === 'extensions' && entry && typeof entry === 'object' && !Array.isArray(entry)) {
22
+ const ext = {};
23
+ for (const [extKey, extValue] of Object.entries(entry)) {
24
+ if (extKey === 'theme')
25
+ continue;
26
+ ext[extKey] = extValue;
27
+ }
28
+ if (Object.keys(ext).length > 0)
29
+ next.extensions = ext;
30
+ continue;
31
+ }
32
+ next[key] = entry;
33
+ }
34
+ return next;
35
+ }
36
+ /**
37
+ * Returns a copy of incoming A2UI messages with agent-supplied theme hints stripped so
38
+ * the surrounding Radiant ThemeScope remains the sole styling authority.
39
+ */
40
+ export function sanitizeA2uiMessages(messages) {
41
+ return messages.map(message => {
42
+ if (!message || typeof message !== 'object' || Array.isArray(message))
43
+ return message;
44
+ const createSurface = message.createSurface;
45
+ if (!createSurface || typeof createSurface !== 'object' || Array.isArray(createSurface)) {
46
+ return message;
47
+ }
48
+ return {
49
+ ...message,
50
+ createSurface: stripThemeFromObject(createSurface)
51
+ };
52
+ });
53
+ }
54
+ //# sourceMappingURL=sanitize.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sanitize.js","sourceRoot":"","sources":["../../../src/a2ui/sanitize.ts"],"names":[],"mappings":"AAEA,SAAS,oBAAoB,CAAC,KAA8B;IAC1D,MAAM,IAAI,GAA4B,EAAE,CAAA;IACxC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACjD,IAAI,GAAG,KAAK,OAAO;YAAE,SAAQ;QAC7B,IAAI,GAAG,KAAK,UAAU,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACtF,MAAM,WAAW,GAAG,sBAAsB,CAAC,KAAgC,CAAC,CAAA;YAC5E,IAAI,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,MAAM,GAAG,CAAC;gBAAE,IAAI,CAAC,QAAQ,GAAG,WAAW,CAAA;YACpE,SAAQ;QACV,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;IACnB,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED,SAAS,sBAAsB,CAAC,QAAiC;IAC/D,MAAM,IAAI,GAA4B,EAAE,CAAA;IACxC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACpD,IAAI,GAAG,KAAK,OAAO;YAAE,SAAQ;QAC7B,IAAI,GAAG,KAAK,YAAY,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACxF,MAAM,GAAG,GAA4B,EAAE,CAAA;YACvC,KAAK,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC,EAAE,CAAC;gBAClF,IAAI,MAAM,KAAK,OAAO;oBAAE,SAAQ;gBAChC,GAAG,CAAC,MAAM,CAAC,GAAG,QAAQ,CAAA;YACxB,CAAC;YACD,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC;gBAAE,IAAI,CAAC,UAAU,GAAG,GAAG,CAAA;YACtD,SAAQ;QACV,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;IACnB,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,QAAgC;IACnE,OAAO,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE;QAC5B,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;YAAE,OAAO,OAAO,CAAA;QACrF,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,CAAA;QAC3C,IAAI,CAAC,aAAa,IAAI,OAAO,aAAa,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC;YACxF,OAAO,OAAO,CAAA;QAChB,CAAC;QACD,OAAO;YACL,GAAG,OAAO;YACV,aAAa,EAAE,oBAAoB,CAAC,aAAwC,CAAC;SAC9E,CAAA;IACH,CAAC,CAAC,CAAA;AACJ,CAAC"}
@@ -0,0 +1,34 @@
1
+ import type { MotionProfile } from '../motion/config.js';
2
+ import type { A2uiMessage } from './sanitize.js';
3
+ export declare const A2UI_NODE_ENTRY_ANIMATION_ID = "radiant-a2ui-entry";
4
+ /** Deep-clones wire messages so live state cannot mutate caller or stored history. */
5
+ export declare function cloneMessageValue<T>(value: T): T;
6
+ /** Returns true when `previous` is a structurally equal prefix of `next`. */
7
+ export declare function isMessagePrefix(previous: readonly A2uiMessage[], next: readonly A2uiMessage[]): boolean;
8
+ /** Coalesces repeated calls within the same turn into a single microtask invocation. */
9
+ export declare function createMicrotaskCoalescer(run: () => void): () => void;
10
+ export declare function isHtmlElement(node: unknown): node is HTMLElement;
11
+ export type NodeHost = {
12
+ readonly nodeId: string;
13
+ readonly instanceId: string;
14
+ readonly element: HTMLElement;
15
+ readonly isContainer: boolean;
16
+ };
17
+ export type FocusSnapshot = {
18
+ readonly active: HTMLElement;
19
+ readonly restoreInstanceId: string | null;
20
+ readonly controlIndex: number;
21
+ readonly after: readonly HTMLElement[];
22
+ readonly before: readonly HTMLElement[];
23
+ readonly selectionStart: number | null;
24
+ readonly selectionEnd: number | null;
25
+ readonly scrollTop: number;
26
+ readonly scrollLeft: number;
27
+ };
28
+ /** Captures the active control, unambiguous owning instance, and surrounding tabbable order. */
29
+ export declare function captureFocusSnapshot(root: HTMLElement | null, hosts: ReadonlyMap<string, NodeHost>): FocusSnapshot | null;
30
+ /** Restores focus synchronously in an active document using the order documented in architecture.md. */
31
+ export declare function restoreFocusFallback(root: HTMLElement | null, snapshot: FocusSnapshot, hosts: ReadonlyMap<string, NodeHost>): void;
32
+ /** Runs entry motion once on a newly mounted node host, ignoring invalid easing values safely. */
33
+ export declare function animateNodeEntry(element: HTMLElement, profile: MotionProfile): Animation | undefined;
34
+ //# sourceMappingURL=surfaceRuntime.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"surfaceRuntime.d.ts","sourceRoot":"","sources":["../../../src/a2ui/surfaceRuntime.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAMhD,eAAO,MAAM,4BAA4B,uBAAuB,CAAA;AAyBhE,sFAAsF;AACtF,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAOhD;AA+BD,6EAA6E;AAC7E,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,SAAS,WAAW,EAAE,EAChC,IAAI,EAAE,SAAS,WAAW,EAAE,GAC3B,OAAO,CAMT;AAED,wFAAwF;AACxF,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAUpE;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,WAAW,CAIhE;AAED,MAAM,MAAM,QAAQ,GAAG;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAA;IAC7B,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAA;CAC9B,CAAA;AAqDD,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAC5B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAA;IACzC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,CAAA;IACtC,QAAQ,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,CAAA;IACvC,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;IACtC,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IACpC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC5B,CAAA;AAED,gGAAgG;AAChG,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,WAAW,GAAG,IAAI,EACxB,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,QAAQ,CAAC,GACnC,aAAa,GAAG,IAAI,CA6CtB;AAsBD,wGAAwG;AACxG,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,WAAW,GAAG,IAAI,EACxB,QAAQ,EAAE,aAAa,EACvB,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,QAAQ,CAAC,GACnC,IAAI,CA+BN;AASD,kGAAkG;AAClG,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,aAAa,GACrB,SAAS,GAAG,SAAS,CAuBvB"}
@@ -0,0 +1,284 @@
1
+ import { isPlainRecord } from '../catalog/coerce.js';
2
+ const FOCUSABLE_SELECTOR = 'a[href],area[href],button,input,select,textarea,summary,[tabindex],[contenteditable]:not([contenteditable="false"])';
3
+ const DEFAULT_ENTRY_EASING = 'cubic-bezier(0.2, 0.8, 0.2, 1)';
4
+ export const A2UI_NODE_ENTRY_ANIMATION_ID = 'radiant-a2ui-entry';
5
+ function cloneFallback(value, seen = new WeakMap()) {
6
+ if (!value || typeof value !== 'object')
7
+ return value;
8
+ if (seen.has(value))
9
+ return seen.get(value);
10
+ if (Array.isArray(value)) {
11
+ const next = [];
12
+ seen.set(value, next);
13
+ for (let i = 0; i < value.length; i++)
14
+ next[i] = cloneFallback(value[i], seen);
15
+ return next;
16
+ }
17
+ if (!isPlainRecord(value))
18
+ return value;
19
+ const next = {};
20
+ seen.set(value, next);
21
+ for (const key of Object.keys(value)) {
22
+ Object.defineProperty(next, key, {
23
+ value: cloneFallback(value[key], seen),
24
+ enumerable: true,
25
+ writable: true,
26
+ configurable: true
27
+ });
28
+ }
29
+ return next;
30
+ }
31
+ /** Deep-clones wire messages so live state cannot mutate caller or stored history. */
32
+ export function cloneMessageValue(value) {
33
+ if (!value || typeof value !== 'object')
34
+ return value;
35
+ try {
36
+ return structuredClone(value);
37
+ }
38
+ catch {
39
+ return cloneFallback(value);
40
+ }
41
+ }
42
+ function sameMessageValue(a, b) {
43
+ const seen = new WeakMap();
44
+ const stack = [[a, b]];
45
+ while (stack.length > 0) {
46
+ const [left, right] = stack.pop();
47
+ if (Object.is(left, right))
48
+ continue;
49
+ if (!left || !right || typeof left !== 'object' || typeof right !== 'object')
50
+ return false;
51
+ let rightSeen = seen.get(left);
52
+ if (rightSeen?.has(right))
53
+ continue;
54
+ if (!rightSeen)
55
+ seen.set(left, (rightSeen = new WeakSet()));
56
+ rightSeen.add(right);
57
+ if (Array.isArray(left) || Array.isArray(right)) {
58
+ if (!Array.isArray(left) || !Array.isArray(right) || left.length !== right.length) {
59
+ return false;
60
+ }
61
+ for (let i = 0; i < left.length; i++)
62
+ stack.push([left[i], right[i]]);
63
+ continue;
64
+ }
65
+ if (!isPlainRecord(left) || !isPlainRecord(right))
66
+ return false;
67
+ const keys = Object.keys(left);
68
+ if (keys.length !== Object.keys(right).length)
69
+ return false;
70
+ for (const key of keys) {
71
+ if (!Object.hasOwn(right, key))
72
+ return false;
73
+ stack.push([left[key], right[key]]);
74
+ }
75
+ }
76
+ return true;
77
+ }
78
+ /** Returns true when `previous` is a structurally equal prefix of `next`. */
79
+ export function isMessagePrefix(previous, next) {
80
+ if (previous.length > next.length)
81
+ return false;
82
+ for (let i = 0; i < previous.length; i++) {
83
+ if (!sameMessageValue(previous[i], next[i]))
84
+ return false;
85
+ }
86
+ return true;
87
+ }
88
+ /** Coalesces repeated calls within the same turn into a single microtask invocation. */
89
+ export function createMicrotaskCoalescer(run) {
90
+ let scheduled = false;
91
+ return () => {
92
+ if (scheduled)
93
+ return;
94
+ scheduled = true;
95
+ queueMicrotask(() => {
96
+ scheduled = false;
97
+ run();
98
+ });
99
+ };
100
+ }
101
+ export function isHtmlElement(node) {
102
+ if (typeof node !== 'object' || node === null || !('ownerDocument' in node))
103
+ return false;
104
+ const win = node.ownerDocument?.defaultView;
105
+ return Boolean(win && node instanceof win.HTMLElement);
106
+ }
107
+ function isFocusableWithin(element, root, allowProgrammatic = false) {
108
+ if (!element.isConnected || !root.contains(element) || element === root)
109
+ return false;
110
+ if (element.tabIndex < 0 && !(allowProgrammatic && element.hasAttribute('tabindex')))
111
+ return false;
112
+ if (element.tagName === 'INPUT' && element.type === 'hidden')
113
+ return false;
114
+ if (element.matches(':disabled') || element.getAttribute('aria-disabled') === 'true')
115
+ return false;
116
+ if (element.closest('[hidden],[inert]') || element.getClientRects().length === 0)
117
+ return false;
118
+ const win = element.ownerDocument.defaultView;
119
+ return !win || win.getComputedStyle(element).visibility !== 'hidden';
120
+ }
121
+ function queryFocusable(scope, root, allowProgrammatic = false) {
122
+ const results = scope !== root && isFocusableWithin(scope, root, allowProgrammatic) ? [scope] : [];
123
+ for (const element of scope.querySelectorAll(FOCUSABLE_SELECTOR)) {
124
+ if (isFocusableWithin(element, root, allowProgrammatic))
125
+ results.push(element);
126
+ }
127
+ return results;
128
+ }
129
+ function findOwningHost(active, hosts) {
130
+ let owner = null;
131
+ for (const host of hosts.values()) {
132
+ if (host.isContainer || !host.element.isConnected || !host.element.contains(active))
133
+ continue;
134
+ if (!owner || owner.element.contains(host.element))
135
+ owner = host;
136
+ }
137
+ return owner;
138
+ }
139
+ function findUniqueHostByInstance(hosts, instanceId) {
140
+ let match = null;
141
+ for (const host of hosts.values()) {
142
+ if (host.instanceId !== instanceId || !host.element.isConnected)
143
+ continue;
144
+ if (match)
145
+ return null;
146
+ match = host;
147
+ }
148
+ return match;
149
+ }
150
+ /** Captures the active control, unambiguous owning instance, and surrounding tabbable order. */
151
+ export function captureFocusSnapshot(root, hosts) {
152
+ if (!root?.isConnected)
153
+ return null;
154
+ const active = root.ownerDocument.activeElement;
155
+ if (!isHtmlElement(active) || !root.contains(active) || active === root)
156
+ return null;
157
+ const after = [];
158
+ const before = [];
159
+ for (const candidate of queryFocusable(root, root)) {
160
+ if (candidate === active)
161
+ continue;
162
+ const pos = active.compareDocumentPosition(candidate);
163
+ if (pos & active.DOCUMENT_POSITION_FOLLOWING)
164
+ after.push(candidate);
165
+ else if (pos & active.DOCUMENT_POSITION_PRECEDING)
166
+ before.push(candidate);
167
+ }
168
+ before.reverse();
169
+ const owner = findOwningHost(active, hosts);
170
+ const restoreInstanceId = owner && findUniqueHostByInstance(hosts, owner.instanceId) === owner ? owner.instanceId : null;
171
+ const controlIndex = owner
172
+ ? Math.max(0, queryFocusable(owner.element, root, true).indexOf(active))
173
+ : 0;
174
+ let selectionStart = null;
175
+ let selectionEnd = null;
176
+ if (active.tagName === 'INPUT' || active.tagName === 'TEXTAREA') {
177
+ try {
178
+ const input = active;
179
+ selectionStart = input.selectionStart;
180
+ selectionEnd = input.selectionEnd;
181
+ }
182
+ catch {
183
+ // Non-text inputs do not expose selection ranges.
184
+ }
185
+ }
186
+ return {
187
+ active,
188
+ restoreInstanceId,
189
+ controlIndex,
190
+ after,
191
+ before,
192
+ selectionStart,
193
+ selectionEnd,
194
+ scrollTop: active.scrollTop,
195
+ scrollLeft: active.scrollLeft
196
+ };
197
+ }
198
+ function restoreControlState(target, snapshot) {
199
+ target.focus({ preventScroll: true });
200
+ if ((target.tagName === 'INPUT' || target.tagName === 'TEXTAREA') &&
201
+ snapshot.selectionStart !== null &&
202
+ snapshot.selectionEnd !== null) {
203
+ try {
204
+ ;
205
+ target.setSelectionRange(snapshot.selectionStart, snapshot.selectionEnd);
206
+ }
207
+ catch {
208
+ // Ignore inputs that disallow setting a selection range.
209
+ }
210
+ }
211
+ if (snapshot.scrollTop > 0)
212
+ target.scrollTop = snapshot.scrollTop;
213
+ if (snapshot.scrollLeft > 0)
214
+ target.scrollLeft = snapshot.scrollLeft;
215
+ }
216
+ /** Restores focus synchronously in an active document using the order documented in architecture.md. */
217
+ export function restoreFocusFallback(root, snapshot, hosts) {
218
+ if (!root?.isConnected)
219
+ return;
220
+ const doc = root.ownerDocument;
221
+ if (typeof doc.hasFocus === 'function' && !doc.hasFocus())
222
+ return;
223
+ const current = doc.activeElement;
224
+ if (current && current !== doc.body && current !== doc.documentElement)
225
+ return;
226
+ if (isFocusableWithin(snapshot.active, root, true)) {
227
+ restoreControlState(snapshot.active, snapshot);
228
+ return;
229
+ }
230
+ if (snapshot.restoreInstanceId) {
231
+ const movedHost = findUniqueHostByInstance(hosts, snapshot.restoreInstanceId);
232
+ if (movedHost) {
233
+ const controls = queryFocusable(movedHost.element, root, true);
234
+ const movedTarget = controls[snapshot.controlIndex] ?? controls[0];
235
+ if (movedTarget) {
236
+ restoreControlState(movedTarget, snapshot);
237
+ return;
238
+ }
239
+ }
240
+ }
241
+ const target = snapshot.after.find(element => isFocusableWithin(element, root)) ??
242
+ snapshot.before.find(element => isFocusableWithin(element, root)) ??
243
+ queryFocusable(root, root)[0] ??
244
+ root;
245
+ target.focus({ preventScroll: true });
246
+ }
247
+ function parseDurationMs(value) {
248
+ const match = /^(\d+(?:\.\d+)?|\.\d+)(ms|s)$/.exec(value.trim());
249
+ if (!match)
250
+ return undefined;
251
+ const num = Number.parseFloat(match[1]);
252
+ return Number.isFinite(num) ? (match[2] === 's' ? num * 1000 : num) : undefined;
253
+ }
254
+ /** Runs entry motion once on a newly mounted node host, ignoring invalid easing values safely. */
255
+ export function animateNodeEntry(element, profile) {
256
+ if (profile.mode === 'off')
257
+ return undefined;
258
+ const win = element.ownerDocument.defaultView;
259
+ if (!win || win.matchMedia?.('(prefers-reduced-motion: reduce)').matches)
260
+ return undefined;
261
+ if (typeof element.animate !== 'function')
262
+ return undefined;
263
+ const styles = win.getComputedStyle(element);
264
+ const duration = parseDurationMs(styles.getPropertyValue('--rad-motion-release-duration')) ?? 160;
265
+ if (duration <= 0)
266
+ return undefined;
267
+ const easing = styles.getPropertyValue('--rad-motion-release-ease').trim() || DEFAULT_ENTRY_EASING;
268
+ const keyframes = [{ transform: 'translateY(6px)' }, { transform: 'translateY(0px)' }];
269
+ const options = { id: A2UI_NODE_ENTRY_ANIMATION_ID, duration, easing, fill: 'none' };
270
+ try {
271
+ return element.animate(keyframes, options);
272
+ }
273
+ catch {
274
+ if (easing === DEFAULT_ENTRY_EASING)
275
+ return undefined;
276
+ try {
277
+ return element.animate(keyframes, { ...options, easing: DEFAULT_ENTRY_EASING });
278
+ }
279
+ catch {
280
+ return undefined;
281
+ }
282
+ }
283
+ }
284
+ //# sourceMappingURL=surfaceRuntime.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"surfaceRuntime.js","sourceRoot":"","sources":["../../../src/a2ui/surfaceRuntime.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,40 @@
1
+ export type CatalogJsonValue = string | number | boolean | null | readonly CatalogJsonValue[] | {
2
+ readonly [key: string]: CatalogJsonValue;
3
+ };
4
+ /**
5
+ * Immutable JSON snapshot of a surface's client-side state.
6
+ * Preserves any JSON root value supported by the runtime (object, array, primitive, or `null`).
7
+ * When no state is available (`undefined`) or the root is unsupported, snapshots normalize to a
8
+ * frozen empty object (`{}`).
9
+ */
10
+ export type CatalogSurfaceState = CatalogJsonValue;
11
+ /**
12
+ * Outbound event delivered to the host when a generated surface triggers a named action.
13
+ * Local interactive entries update client state directly without invoking this callback;
14
+ * only named actions deliver the action name and a snapshot of the surface state.
15
+ */
16
+ export type CatalogActionEvent = {
17
+ readonly action: string;
18
+ readonly surfaceId: string;
19
+ readonly nodeId: string;
20
+ readonly state: CatalogSurfaceState;
21
+ };
22
+ /** Host callback invoked when a generated surface dispatches a named outbound action. */
23
+ export type CatalogActionHandler = (event: CatalogActionEvent) => void;
24
+ export type CatalogActionEventInput = {
25
+ readonly action: string;
26
+ readonly surfaceId: string;
27
+ readonly nodeId: string;
28
+ readonly state?: unknown;
29
+ };
30
+ /**
31
+ * Captures an isolated, deeply frozen JSON snapshot of a surface's client-side state.
32
+ * When `rawState` is `undefined` or an unsupported non-JSON value, returns a frozen empty object.
33
+ */
34
+ export declare function snapshotSurfaceState(rawState: unknown): CatalogSurfaceState;
35
+ /**
36
+ * Builds a frozen protocol-independent action event with an isolated state snapshot.
37
+ * If `state` is omitted (`undefined`), `event.state` defaults to a frozen empty object (`{}`).
38
+ */
39
+ export declare function createCatalogActionEvent(input: CatalogActionEventInput): CatalogActionEvent;
40
+ //# sourceMappingURL=actions.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../../src/catalog/actions.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GACxB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,SAAS,gBAAgB,EAAE,GAC3B;IAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,gBAAgB,CAAA;CAAE,CAAA;AAEhD;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAAG,gBAAgB,CAAA;AAElD;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAA;CACpC,CAAA;AAED,yFAAyF;AACzF,MAAM,MAAM,oBAAoB,GAAG,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,CAAA;AAEtE,MAAM,MAAM,uBAAuB,GAAG;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CACzB,CAAA;AA4CD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,OAAO,GAAG,mBAAmB,CAG3E;AASD;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,uBAAuB,GAAG,kBAAkB,CAO3F"}