@viyv/agent-ui-schema 0.1.0

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 (75) hide show
  1. package/.turbo/turbo-build.log +4 -0
  2. package/.turbo/turbo-test.log +16 -0
  3. package/.turbo/turbo-typecheck.log +4 -0
  4. package/dist/__tests__/expression.test.d.ts +2 -0
  5. package/dist/__tests__/expression.test.d.ts.map +1 -0
  6. package/dist/__tests__/expression.test.js +77 -0
  7. package/dist/__tests__/expression.test.js.map +1 -0
  8. package/dist/__tests__/page-spec.test.d.ts +2 -0
  9. package/dist/__tests__/page-spec.test.d.ts.map +1 -0
  10. package/dist/__tests__/page-spec.test.js +223 -0
  11. package/dist/__tests__/page-spec.test.js.map +1 -0
  12. package/dist/__tests__/validator.test.d.ts +2 -0
  13. package/dist/__tests__/validator.test.d.ts.map +1 -0
  14. package/dist/__tests__/validator.test.js +177 -0
  15. package/dist/__tests__/validator.test.js.map +1 -0
  16. package/dist/action-def.d.ts +227 -0
  17. package/dist/action-def.d.ts.map +1 -0
  18. package/dist/action-def.js +54 -0
  19. package/dist/action-def.js.map +1 -0
  20. package/dist/catalog.d.ts +16 -0
  21. package/dist/catalog.d.ts.map +1 -0
  22. package/dist/catalog.js +8 -0
  23. package/dist/catalog.js.map +1 -0
  24. package/dist/data-source.d.ts +195 -0
  25. package/dist/data-source.d.ts.map +1 -0
  26. package/dist/data-source.js +28 -0
  27. package/dist/data-source.js.map +1 -0
  28. package/dist/element-def.d.ts +37 -0
  29. package/dist/element-def.d.ts.map +1 -0
  30. package/dist/element-def.js +13 -0
  31. package/dist/element-def.js.map +1 -0
  32. package/dist/expression.d.ts +28 -0
  33. package/dist/expression.d.ts.map +1 -0
  34. package/dist/expression.js +56 -0
  35. package/dist/expression.js.map +1 -0
  36. package/dist/hook-def.d.ts +456 -0
  37. package/dist/hook-def.d.ts.map +1 -0
  38. package/dist/hook-def.js +67 -0
  39. package/dist/hook-def.js.map +1 -0
  40. package/dist/index.d.ts +20 -0
  41. package/dist/index.d.ts.map +1 -0
  42. package/dist/index.js +19 -0
  43. package/dist/index.js.map +1 -0
  44. package/dist/page-spec.d.ts +684 -0
  45. package/dist/page-spec.d.ts.map +1 -0
  46. package/dist/page-spec.js +34 -0
  47. package/dist/page-spec.js.map +1 -0
  48. package/dist/page-store.d.ts +20 -0
  49. package/dist/page-store.d.ts.map +1 -0
  50. package/dist/page-store.js +2 -0
  51. package/dist/page-store.js.map +1 -0
  52. package/dist/patch.d.ts +144 -0
  53. package/dist/patch.d.ts.map +1 -0
  54. package/dist/patch.js +23 -0
  55. package/dist/patch.js.map +1 -0
  56. package/dist/validator.d.ts +13 -0
  57. package/dist/validator.d.ts.map +1 -0
  58. package/dist/validator.js +286 -0
  59. package/dist/validator.js.map +1 -0
  60. package/package.json +27 -0
  61. package/src/__tests__/expression.test.ts +93 -0
  62. package/src/__tests__/page-spec.test.ts +242 -0
  63. package/src/__tests__/validator.test.ts +189 -0
  64. package/src/action-def.ts +63 -0
  65. package/src/catalog.ts +24 -0
  66. package/src/data-source.ts +46 -0
  67. package/src/element-def.ts +17 -0
  68. package/src/expression.ts +77 -0
  69. package/src/hook-def.ts +79 -0
  70. package/src/index.ts +72 -0
  71. package/src/page-spec.ts +42 -0
  72. package/src/page-store.ts +18 -0
  73. package/src/patch.ts +28 -0
  74. package/src/validator.ts +347 -0
  75. package/tsconfig.json +8 -0
@@ -0,0 +1,4 @@
1
+
2
+ > @viyv/agent-ui-schema@0.1.0 build /Users/hiroki/myworkspace/ai_project/viyv-agent-ui/packages/schema
3
+ > tsc
4
+
@@ -0,0 +1,16 @@
1
+
2
+ > @viyv/agent-ui-schema@0.1.0 test /Users/hiroki/myworkspace/ai_project/viyv-agent-ui/packages/schema
3
+ > vitest run
4
+
5
+
6
+ RUN v2.1.9 /Users/hiroki/myworkspace/ai_project/viyv-agent-ui/packages/schema
7
+
8
+ ✓ src/__tests__/expression.test.ts (17 tests) 6ms
9
+ ✓ src/__tests__/validator.test.ts (12 tests) 7ms
10
+ ✓ src/__tests__/page-spec.test.ts (16 tests) 5ms
11
+
12
+ Test Files 3 passed (3)
13
+ Tests 45 passed (45)
14
+ Start at 16:20:39
15
+ Duration 856ms (transform 109ms, setup 0ms, collect 510ms, tests 18ms, environment 0ms, prepare 573ms)
16
+
@@ -0,0 +1,4 @@
1
+
2
+ > @viyv/agent-ui-schema@0.1.0 typecheck /Users/hiroki/myworkspace/ai_project/viyv-agent-ui/packages/schema
3
+ > tsc --noEmit
4
+
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=expression.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"expression.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/expression.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,77 @@
1
+ import { describe, expect, it } from 'vitest';
2
+ import { isExpression, parseExpression } from '../expression.js';
3
+ describe('isExpression', () => {
4
+ it('returns true for $-prefixed strings', () => {
5
+ expect(isExpression('$hook.sales')).toBe(true);
6
+ expect(isExpression('$state.filter')).toBe(true);
7
+ });
8
+ it('returns false for non-expressions', () => {
9
+ expect(isExpression('hello')).toBe(false);
10
+ expect(isExpression(42)).toBe(false);
11
+ expect(isExpression(null)).toBe(false);
12
+ });
13
+ });
14
+ describe('parseExpression', () => {
15
+ it('parses $hook.xxx', () => {
16
+ const ref = parseExpression('$hook.sales');
17
+ expect(ref).toEqual({ type: 'hook', hookId: 'sales', path: [] });
18
+ });
19
+ it('parses $hook.xxx.data.nested', () => {
20
+ const ref = parseExpression('$hook.sales.data.items');
21
+ expect(ref).toEqual({ type: 'hook', hookId: 'sales', path: ['data', 'items'] });
22
+ });
23
+ it('parses $state.xxx', () => {
24
+ const ref = parseExpression('$state.filter');
25
+ expect(ref).toEqual({ type: 'state', key: 'filter' });
26
+ });
27
+ it('parses $bindState.xxx', () => {
28
+ const ref = parseExpression('$bindState.searchTerm');
29
+ expect(ref).toEqual({ type: 'bindState', key: 'searchTerm' });
30
+ });
31
+ it('parses $action.xxx', () => {
32
+ const ref = parseExpression('$action.refresh');
33
+ expect(ref).toEqual({ type: 'action', actionId: 'refresh' });
34
+ });
35
+ it('parses $expr(...)', () => {
36
+ const ref = parseExpression('$expr(hook.sales.length > 0)');
37
+ expect(ref).toEqual({ type: 'expr', code: 'hook.sales.length > 0' });
38
+ });
39
+ it('parses $hook with deep nesting (a.b.c.d)', () => {
40
+ const ref = parseExpression('$hook.data.a.b.c.d');
41
+ expect(ref).toEqual({ type: 'hook', hookId: 'data', path: ['a', 'b', 'c', 'd'] });
42
+ });
43
+ it('parses hook IDs with hyphens', () => {
44
+ const ref = parseExpression('$hook.my-hook');
45
+ expect(ref).toEqual({ type: 'hook', hookId: 'my-hook', path: [] });
46
+ });
47
+ it('parses state keys with hyphens', () => {
48
+ const ref = parseExpression('$state.my-state');
49
+ expect(ref).toEqual({ type: 'state', key: 'my-state' });
50
+ });
51
+ it('parses action IDs with hyphens', () => {
52
+ const ref = parseExpression('$action.my-action');
53
+ expect(ref).toEqual({ type: 'action', actionId: 'my-action' });
54
+ });
55
+ it('parses $expr with nested parentheses', () => {
56
+ const ref = parseExpression('$expr(Math.max(hook.a, hook.b))');
57
+ expect(ref).toEqual({ type: 'expr', code: 'Math.max(hook.a, hook.b)' });
58
+ });
59
+ it('parses $item (whole object)', () => {
60
+ const ref = parseExpression('$item');
61
+ expect(ref).toEqual({ type: 'item', path: [] });
62
+ });
63
+ it('parses $item.name', () => {
64
+ const ref = parseExpression('$item.name');
65
+ expect(ref).toEqual({ type: 'item', path: ['name'] });
66
+ });
67
+ it('parses $item.a.b.c (deep path)', () => {
68
+ const ref = parseExpression('$item.a.b.c');
69
+ expect(ref).toEqual({ type: 'item', path: ['a', 'b', 'c'] });
70
+ });
71
+ it('returns null for invalid expressions', () => {
72
+ expect(parseExpression('$invalid')).toBeNull();
73
+ expect(parseExpression('$')).toBeNull();
74
+ expect(parseExpression('$$hook.x')).toBeNull();
75
+ });
76
+ });
77
+ //# sourceMappingURL=expression.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"expression.test.js","sourceRoot":"","sources":["../../src/__tests__/expression.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=page-spec.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"page-spec.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/page-spec.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,223 @@
1
+ import { describe, expect, it } from 'vitest';
2
+ import { ActionDefSchema } from '../action-def.js';
3
+ import { PageSpecSchema } from '../page-spec.js';
4
+ import { validatePageSpec } from '../validator.js';
5
+ describe('ActionDefSchema — CRUD actions', () => {
6
+ it('parses addItem action', () => {
7
+ const result = ActionDefSchema.safeParse({
8
+ type: 'addItem',
9
+ hookId: 'tasks',
10
+ stateKey: 'newTask',
11
+ idPrefix: 'TASK',
12
+ });
13
+ expect(result.success).toBe(true);
14
+ });
15
+ it('parses removeItem action', () => {
16
+ const result = ActionDefSchema.safeParse({
17
+ type: 'removeItem',
18
+ hookId: 'tasks',
19
+ key: 'id',
20
+ stateKey: 'editingTask',
21
+ });
22
+ expect(result.success).toBe(true);
23
+ });
24
+ it('parses updateItem action', () => {
25
+ const result = ActionDefSchema.safeParse({
26
+ type: 'updateItem',
27
+ hookId: 'tasks',
28
+ key: 'id',
29
+ stateKey: 'editingTask',
30
+ onComplete: { showEditDialog: false },
31
+ });
32
+ expect(result.success).toBe(true);
33
+ });
34
+ it('parses setState with onComplete', () => {
35
+ const result = ActionDefSchema.safeParse({
36
+ type: 'setState',
37
+ key: 'showDialog',
38
+ value: true,
39
+ onComplete: { newTask: { title: '' } },
40
+ });
41
+ expect(result.success).toBe(true);
42
+ });
43
+ it('rejects addItem without required hookId', () => {
44
+ const result = ActionDefSchema.safeParse({
45
+ type: 'addItem',
46
+ stateKey: 'newTask',
47
+ });
48
+ expect(result.success).toBe(false);
49
+ });
50
+ it('rejects removeItem without required key', () => {
51
+ const result = ActionDefSchema.safeParse({
52
+ type: 'removeItem',
53
+ hookId: 'tasks',
54
+ stateKey: 'editingTask',
55
+ });
56
+ expect(result.success).toBe(false);
57
+ });
58
+ it('rejects updateItem without required stateKey', () => {
59
+ const result = ActionDefSchema.safeParse({
60
+ type: 'updateItem',
61
+ hookId: 'tasks',
62
+ key: 'id',
63
+ });
64
+ expect(result.success).toBe(false);
65
+ });
66
+ });
67
+ describe('validatePageSpec — CRUD hookId validation', () => {
68
+ const baseSpec = {
69
+ id: 'test',
70
+ title: 'Test',
71
+ root: 'root',
72
+ elements: { root: { type: 'Stack', props: {} } },
73
+ state: {},
74
+ };
75
+ it('errors when hookId references undefined hook', () => {
76
+ const result = validatePageSpec({
77
+ ...baseSpec,
78
+ hooks: {},
79
+ actions: {
80
+ add: { type: 'addItem', hookId: 'missing', stateKey: 'x' },
81
+ },
82
+ });
83
+ expect(result.valid).toBe(false);
84
+ expect(result.errors.some((e) => e.message.includes('"missing" not defined'))).toBe(true);
85
+ });
86
+ it('errors when hookId references non-useState hook', () => {
87
+ const result = validatePageSpec({
88
+ ...baseSpec,
89
+ hooks: {
90
+ derived: { use: 'useDerived', from: 'tasks', params: {} },
91
+ tasks: { use: 'useState', params: { initial: [] } },
92
+ },
93
+ actions: {
94
+ add: { type: 'addItem', hookId: 'derived', stateKey: 'x' },
95
+ },
96
+ });
97
+ expect(result.valid).toBe(false);
98
+ expect(result.errors.some((e) => e.message.includes('not useState'))).toBe(true);
99
+ });
100
+ it('passes when hookId references useState hook', () => {
101
+ const result = validatePageSpec({
102
+ ...baseSpec,
103
+ hooks: {
104
+ tasks: { use: 'useState', params: { initial: [] } },
105
+ },
106
+ actions: {
107
+ add: { type: 'addItem', hookId: 'tasks', stateKey: 'newTask' },
108
+ },
109
+ });
110
+ expect(result.valid).toBe(true);
111
+ });
112
+ it('errors for removeItem targeting non-useState hook', () => {
113
+ const result = validatePageSpec({
114
+ ...baseSpec,
115
+ hooks: {
116
+ tasks: { use: 'useState', params: { initial: [] } },
117
+ derived: { use: 'useDerived', from: 'tasks', params: {} },
118
+ },
119
+ actions: {
120
+ remove: { type: 'removeItem', hookId: 'derived', key: 'id', stateKey: 'x' },
121
+ },
122
+ });
123
+ expect(result.valid).toBe(false);
124
+ expect(result.errors.some((e) => e.message.includes('not useState'))).toBe(true);
125
+ });
126
+ it('errors for updateItem targeting undefined hook', () => {
127
+ const result = validatePageSpec({
128
+ ...baseSpec,
129
+ hooks: {},
130
+ actions: {
131
+ update: { type: 'updateItem', hookId: 'missing', key: 'id', stateKey: 'x' },
132
+ },
133
+ });
134
+ expect(result.valid).toBe(false);
135
+ expect(result.errors.some((e) => e.message.includes('"missing" not defined'))).toBe(true);
136
+ });
137
+ it('does not validate refreshHook hookId against useState', () => {
138
+ const result = validatePageSpec({
139
+ ...baseSpec,
140
+ hooks: {
141
+ data: {
142
+ use: 'useSqlQuery',
143
+ params: { connection: 'db', query: 'SELECT 1' },
144
+ },
145
+ },
146
+ actions: {
147
+ refresh: { type: 'refreshHook', hookId: 'data' },
148
+ },
149
+ });
150
+ expect(result.valid).toBe(true);
151
+ });
152
+ });
153
+ describe('PageSpecSchema', () => {
154
+ it('validates a minimal page spec', () => {
155
+ const spec = {
156
+ id: 'test-page',
157
+ title: 'Test Page',
158
+ root: 'root',
159
+ elements: {
160
+ root: { type: 'Stack', props: { direction: 'vertical' } },
161
+ },
162
+ };
163
+ const result = PageSpecSchema.safeParse(spec);
164
+ expect(result.success).toBe(true);
165
+ if (result.success) {
166
+ expect(result.data.id).toBe('test-page');
167
+ expect(result.data.hooks).toEqual({});
168
+ expect(result.data.state).toEqual({});
169
+ expect(result.data.actions).toEqual({});
170
+ }
171
+ });
172
+ it('validates a full page spec with hooks and actions', () => {
173
+ const spec = {
174
+ id: 'sales-dashboard',
175
+ title: 'Sales Dashboard',
176
+ description: 'Monthly sales overview',
177
+ root: 'root',
178
+ elements: {
179
+ root: {
180
+ type: 'Stack',
181
+ props: { direction: 'vertical' },
182
+ children: ['header', 'table'],
183
+ },
184
+ header: { type: 'Header', props: { title: 'Sales' } },
185
+ table: {
186
+ type: 'DataTable',
187
+ props: { data: '$hook.sales', columns: [] },
188
+ },
189
+ },
190
+ hooks: {
191
+ sales: {
192
+ use: 'useSqlQuery',
193
+ params: {
194
+ connection: 'main-db',
195
+ query: 'SELECT * FROM sales',
196
+ refreshInterval: 60000,
197
+ },
198
+ },
199
+ },
200
+ state: { filter: '' },
201
+ actions: {
202
+ refresh: { type: 'refreshHook', hookId: 'sales' },
203
+ },
204
+ theme: { colorScheme: 'light', spacing: 'default' },
205
+ };
206
+ const result = PageSpecSchema.safeParse(spec);
207
+ expect(result.success).toBe(true);
208
+ });
209
+ it('rejects invalid hook definitions', () => {
210
+ const spec = {
211
+ id: 'test',
212
+ title: 'Test',
213
+ root: 'root',
214
+ elements: { root: { type: 'Stack', props: {} } },
215
+ hooks: {
216
+ bad: { use: 'useInvalid', params: {} },
217
+ },
218
+ };
219
+ const result = PageSpecSchema.safeParse(spec);
220
+ expect(result.success).toBe(false);
221
+ });
222
+ });
223
+ //# sourceMappingURL=page-spec.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"page-spec.test.js","sourceRoot":"","sources":["../../src/__tests__/page-spec.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=validator.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"validator.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/validator.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,177 @@
1
+ import { describe, expect, it } from 'vitest';
2
+ import { validatePageSpec } from '../validator.js';
3
+ describe('validatePageSpec', () => {
4
+ const validSpec = {
5
+ id: 'test',
6
+ title: 'Test',
7
+ root: 'root',
8
+ elements: {
9
+ root: {
10
+ type: 'Stack',
11
+ props: { direction: 'vertical' },
12
+ children: ['header'],
13
+ },
14
+ header: { type: 'Header', props: { title: 'Hello' } },
15
+ },
16
+ hooks: {},
17
+ state: {},
18
+ actions: {},
19
+ };
20
+ it('validates a correct spec', () => {
21
+ const result = validatePageSpec(validSpec);
22
+ expect(result.valid).toBe(true);
23
+ expect(result.errors).toHaveLength(0);
24
+ });
25
+ it('detects missing root element', () => {
26
+ const result = validatePageSpec({
27
+ ...validSpec,
28
+ root: 'nonexistent',
29
+ });
30
+ expect(result.valid).toBe(false);
31
+ expect(result.errors.some((e) => e.message.includes('Root element'))).toBe(true);
32
+ });
33
+ it('detects missing child references', () => {
34
+ const result = validatePageSpec({
35
+ ...validSpec,
36
+ elements: {
37
+ root: {
38
+ type: 'Stack',
39
+ props: {},
40
+ children: ['missing-child'],
41
+ },
42
+ },
43
+ });
44
+ expect(result.valid).toBe(false);
45
+ expect(result.errors.some((e) => e.message.includes('Child element'))).toBe(true);
46
+ });
47
+ it('detects undefined hook references', () => {
48
+ const result = validatePageSpec({
49
+ ...validSpec,
50
+ elements: {
51
+ root: {
52
+ type: 'DataTable',
53
+ props: { data: '$hook.nonexistent' },
54
+ },
55
+ },
56
+ });
57
+ expect(result.valid).toBe(false);
58
+ expect(result.errors.some((e) => e.message.includes('Hook "nonexistent"'))).toBe(true);
59
+ });
60
+ it('detects unsafe SQL', () => {
61
+ const result = validatePageSpec({
62
+ ...validSpec,
63
+ hooks: {
64
+ bad: {
65
+ use: 'useSqlQuery',
66
+ params: {
67
+ connection: 'db',
68
+ query: 'DROP TABLE users',
69
+ },
70
+ },
71
+ },
72
+ });
73
+ expect(result.valid).toBe(false);
74
+ expect(result.errors.some((e) => e.message.includes('unsafe SQL'))).toBe(true);
75
+ });
76
+ it('detects hook cycle', () => {
77
+ const result = validatePageSpec({
78
+ ...validSpec,
79
+ hooks: {
80
+ a: { use: 'useDerived', from: 'b', params: {} },
81
+ b: { use: 'useDerived', from: 'a', params: {} },
82
+ },
83
+ });
84
+ expect(result.valid).toBe(false);
85
+ expect(result.errors.some((e) => e.message.includes('Circular dependency'))).toBe(true);
86
+ });
87
+ it('validates action references in elements', () => {
88
+ const result = validatePageSpec({
89
+ ...validSpec,
90
+ elements: {
91
+ root: {
92
+ type: 'Button',
93
+ props: { onClick: '$action.nonexistent' },
94
+ },
95
+ },
96
+ });
97
+ expect(result.valid).toBe(false);
98
+ expect(result.errors.some((e) => e.message.includes('Action "nonexistent"'))).toBe(true);
99
+ });
100
+ it('rejects non-SELECT SQL queries', () => {
101
+ const result = validatePageSpec({
102
+ ...validSpec,
103
+ hooks: {
104
+ insert: {
105
+ use: 'useSqlQuery',
106
+ params: {
107
+ connection: 'db',
108
+ query: 'INSERT INTO users VALUES (1)',
109
+ },
110
+ },
111
+ },
112
+ });
113
+ expect(result.valid).toBe(false);
114
+ });
115
+ it('detects dangling useDerived source', () => {
116
+ const result = validatePageSpec({
117
+ ...validSpec,
118
+ hooks: {
119
+ derived: { use: 'useDerived', from: 'nonexistent', params: {} },
120
+ },
121
+ });
122
+ expect(result.valid).toBe(false);
123
+ expect(result.errors.some((e) => e.message.includes('undefined source hook'))).toBe(true);
124
+ });
125
+ it('validates visibility expression hook references', () => {
126
+ const result = validatePageSpec({
127
+ ...validSpec,
128
+ elements: {
129
+ root: {
130
+ type: 'Stack',
131
+ props: {},
132
+ visible: { expr: '$hook.nonexistent' },
133
+ },
134
+ },
135
+ });
136
+ expect(result.valid).toBe(false);
137
+ expect(result.errors.some((e) => e.path.includes('visible.expr'))).toBe(true);
138
+ });
139
+ it('no warning for $item inside Repeater descendant', () => {
140
+ const result = validatePageSpec({
141
+ ...validSpec,
142
+ elements: {
143
+ root: {
144
+ type: 'Repeater',
145
+ props: { data: '$hook.items' },
146
+ children: ['itemText'],
147
+ },
148
+ itemText: {
149
+ type: 'Text',
150
+ props: { content: '$item.name' },
151
+ },
152
+ },
153
+ hooks: {
154
+ items: {
155
+ use: 'useSqlQuery',
156
+ params: { connection: 'viyv-db', query: 'SELECT name FROM items' },
157
+ },
158
+ },
159
+ });
160
+ expect(result.valid).toBe(true);
161
+ expect(result.warnings).toHaveLength(0);
162
+ });
163
+ it('warns for $item outside Repeater context', () => {
164
+ const result = validatePageSpec({
165
+ ...validSpec,
166
+ elements: {
167
+ root: {
168
+ type: 'Text',
169
+ props: { content: '$item.name' },
170
+ },
171
+ },
172
+ });
173
+ expect(result.valid).toBe(true); // warning, not error
174
+ expect(result.warnings.some((w) => w.message.includes('$item expression used outside Repeater'))).toBe(true);
175
+ });
176
+ });
177
+ //# sourceMappingURL=validator.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"validator.test.js","sourceRoot":"","sources":["../../src/__tests__/validator.test.ts"],"names":[],"mappings":"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"}