@viyv/agent-ui-schema 0.1.0

package/dist/action-def.d.ts

@@ -0,0 +1,227 @@
+import { z } from 'zod';
+export declare const SetStateActionSchema: z.ZodObject<{
+    type: z.ZodLiteral<"setState">;
+    key: z.ZodString;
+    value: z.ZodOptional<z.ZodUnknown>;
+    onComplete: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    type: "setState";
+    key: string;
+    value?: unknown;
+    onComplete?: Record<string, unknown> | undefined;
+}, {
+    type: "setState";
+    key: string;
+    value?: unknown;
+    onComplete?: Record<string, unknown> | undefined;
+}>;
+export declare const RefreshHookActionSchema: z.ZodObject<{
+    type: z.ZodLiteral<"refreshHook">;
+    hookId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "refreshHook";
+    hookId: string;
+}, {
+    type: "refreshHook";
+    hookId: string;
+}>;
+export declare const NavigateActionSchema: z.ZodObject<{
+    type: z.ZodLiteral<"navigate">;
+    url: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "navigate";
+    url: string;
+}, {
+    type: "navigate";
+    url: string;
+}>;
+export declare const SubmitFormActionSchema: z.ZodObject<{
+    type: z.ZodLiteral<"submitForm">;
+    url: z.ZodString;
+    method: z.ZodDefault<z.ZodEnum<["POST", "PUT", "PATCH"]>>;
+    stateKey: z.ZodOptional<z.ZodString>;
+    onComplete: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    type: "submitForm";
+    url: string;
+    method: "POST" | "PUT" | "PATCH";
+    onComplete?: Record<string, unknown> | undefined;
+    stateKey?: string | undefined;
+}, {
+    type: "submitForm";
+    url: string;
+    onComplete?: Record<string, unknown> | undefined;
+    method?: "POST" | "PUT" | "PATCH" | undefined;
+    stateKey?: string | undefined;
+}>;
+export declare const AddItemActionSchema: z.ZodObject<{
+    type: z.ZodLiteral<"addItem">;
+    hookId: z.ZodString;
+    stateKey: z.ZodString;
+    idField: z.ZodOptional<z.ZodString>;
+    idPrefix: z.ZodOptional<z.ZodString>;
+    onComplete: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    type: "addItem";
+    hookId: string;
+    stateKey: string;
+    onComplete?: Record<string, unknown> | undefined;
+    idField?: string | undefined;
+    idPrefix?: string | undefined;
+}, {
+    type: "addItem";
+    hookId: string;
+    stateKey: string;
+    onComplete?: Record<string, unknown> | undefined;
+    idField?: string | undefined;
+    idPrefix?: string | undefined;
+}>;
+export declare const RemoveItemActionSchema: z.ZodObject<{
+    type: z.ZodLiteral<"removeItem">;
+    hookId: z.ZodString;
+    key: z.ZodString;
+    stateKey: z.ZodString;
+    onComplete: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    type: "removeItem";
+    key: string;
+    hookId: string;
+    stateKey: string;
+    onComplete?: Record<string, unknown> | undefined;
+}, {
+    type: "removeItem";
+    key: string;
+    hookId: string;
+    stateKey: string;
+    onComplete?: Record<string, unknown> | undefined;
+}>;
+export declare const UpdateItemActionSchema: z.ZodObject<{
+    type: z.ZodLiteral<"updateItem">;
+    hookId: z.ZodString;
+    key: z.ZodString;
+    stateKey: z.ZodString;
+    onComplete: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    type: "updateItem";
+    key: string;
+    hookId: string;
+    stateKey: string;
+    onComplete?: Record<string, unknown> | undefined;
+}, {
+    type: "updateItem";
+    key: string;
+    hookId: string;
+    stateKey: string;
+    onComplete?: Record<string, unknown> | undefined;
+}>;
+export declare const ActionDefSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    type: z.ZodLiteral<"setState">;
+    key: z.ZodString;
+    value: z.ZodOptional<z.ZodUnknown>;
+    onComplete: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    type: "setState";
+    key: string;
+    value?: unknown;
+    onComplete?: Record<string, unknown> | undefined;
+}, {
+    type: "setState";
+    key: string;
+    value?: unknown;
+    onComplete?: Record<string, unknown> | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"refreshHook">;
+    hookId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "refreshHook";
+    hookId: string;
+}, {
+    type: "refreshHook";
+    hookId: string;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"navigate">;
+    url: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "navigate";
+    url: string;
+}, {
+    type: "navigate";
+    url: string;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"submitForm">;
+    url: z.ZodString;
+    method: z.ZodDefault<z.ZodEnum<["POST", "PUT", "PATCH"]>>;
+    stateKey: z.ZodOptional<z.ZodString>;
+    onComplete: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    type: "submitForm";
+    url: string;
+    method: "POST" | "PUT" | "PATCH";
+    onComplete?: Record<string, unknown> | undefined;
+    stateKey?: string | undefined;
+}, {
+    type: "submitForm";
+    url: string;
+    onComplete?: Record<string, unknown> | undefined;
+    method?: "POST" | "PUT" | "PATCH" | undefined;
+    stateKey?: string | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"addItem">;
+    hookId: z.ZodString;
+    stateKey: z.ZodString;
+    idField: z.ZodOptional<z.ZodString>;
+    idPrefix: z.ZodOptional<z.ZodString>;
+    onComplete: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    type: "addItem";
+    hookId: string;
+    stateKey: string;
+    onComplete?: Record<string, unknown> | undefined;
+    idField?: string | undefined;
+    idPrefix?: string | undefined;
+}, {
+    type: "addItem";
+    hookId: string;
+    stateKey: string;
+    onComplete?: Record<string, unknown> | undefined;
+    idField?: string | undefined;
+    idPrefix?: string | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"removeItem">;
+    hookId: z.ZodString;
+    key: z.ZodString;
+    stateKey: z.ZodString;
+    onComplete: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    type: "removeItem";
+    key: string;
+    hookId: string;
+    stateKey: string;
+    onComplete?: Record<string, unknown> | undefined;
+}, {
+    type: "removeItem";
+    key: string;
+    hookId: string;
+    stateKey: string;
+    onComplete?: Record<string, unknown> | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"updateItem">;
+    hookId: z.ZodString;
+    key: z.ZodString;
+    stateKey: z.ZodString;
+    onComplete: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    type: "updateItem";
+    key: string;
+    hookId: string;
+    stateKey: string;
+    onComplete?: Record<string, unknown> | undefined;
+}, {
+    type: "updateItem";
+    key: string;
+    hookId: string;
+    stateKey: string;
+    onComplete?: Record<string, unknown> | undefined;
+}>]>;
+export type ActionDef = z.infer<typeof ActionDefSchema>;
+//# sourceMappingURL=action-def.d.ts.map

package/dist/action-def.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-def.d.ts","sourceRoot":"","sources":["../src/action-def.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;EAK/B,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;;;;;;;EAGlC,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;EAG/B,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;EAMjC,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;EAO9B,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;EAMjC,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;EAMjC,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAQ1B,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC"}

package/dist/action-def.js

@@ -0,0 +1,54 @@
+import { z } from 'zod';
+export const SetStateActionSchema = z.object({
+    type: z.literal('setState'),
+    key: z.string().min(1),
+    value: z.unknown().optional(),
+    onComplete: z.record(z.unknown()).optional(),
+});
+export const RefreshHookActionSchema = z.object({
+    type: z.literal('refreshHook'),
+    hookId: z.string().min(1),
+});
+export const NavigateActionSchema = z.object({
+    type: z.literal('navigate'),
+    url: z.string().min(1),
+});
+export const SubmitFormActionSchema = z.object({
+    type: z.literal('submitForm'),
+    url: z.string().min(1),
+    method: z.enum(['POST', 'PUT', 'PATCH']).default('POST'),
+    stateKey: z.string().optional(),
+    onComplete: z.record(z.unknown()).optional(),
+});
+export const AddItemActionSchema = z.object({
+    type: z.literal('addItem'),
+    hookId: z.string().min(1),
+    stateKey: z.string().min(1),
+    idField: z.string().optional(),
+    idPrefix: z.string().optional(),
+    onComplete: z.record(z.unknown()).optional(),
+});
+export const RemoveItemActionSchema = z.object({
+    type: z.literal('removeItem'),
+    hookId: z.string().min(1),
+    key: z.string().min(1),
+    stateKey: z.string().min(1),
+    onComplete: z.record(z.unknown()).optional(),
+});
+export const UpdateItemActionSchema = z.object({
+    type: z.literal('updateItem'),
+    hookId: z.string().min(1),
+    key: z.string().min(1),
+    stateKey: z.string().min(1),
+    onComplete: z.record(z.unknown()).optional(),
+});
+export const ActionDefSchema = z.discriminatedUnion('type', [
+    SetStateActionSchema,
+    RefreshHookActionSchema,
+    NavigateActionSchema,
+    SubmitFormActionSchema,
+    AddItemActionSchema,
+    RemoveItemActionSchema,
+    UpdateItemActionSchema,
+]);
+//# sourceMappingURL=action-def.js.map

package/dist/action-def.js.map

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

package/dist/catalog.d.ts

@@ -0,0 +1,16 @@
+import type { z } from 'zod';
+export interface ComponentMeta {
+    type: string;
+    label: string;
+    description: string;
+    category: 'layout' | 'display' | 'data' | 'chart' | 'input' | 'control' | 'navigation' | 'overlay' | 'feedback' | 'map';
+    propsSchema: z.ZodType;
+    acceptsChildren: boolean;
+    /** When true, ElementRenderer passes `open` prop from visibility instead of unmounting */
+    overlay?: boolean;
+}
+export interface ComponentCatalog {
+    components: Record<string, ComponentMeta>;
+}
+export declare function defineCatalog(components: ComponentMeta[]): ComponentCatalog;
+//# sourceMappingURL=catalog.d.ts.map

package/dist/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../src/catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,MAAM,WAAW,aAAa;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,SAAS,GAAG,YAAY,GAAG,SAAS,GAAG,UAAU,GAAG,KAAK,CAAC;IACxH,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC;IACvB,eAAe,EAAE,OAAO,CAAC;IACzB,0FAA0F;IAC1F,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAChC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;CAC1C;AAED,wBAAgB,aAAa,CAAC,UAAU,EAAE,aAAa,EAAE,GAAG,gBAAgB,CAM3E"}

package/dist/catalog.js

@@ -0,0 +1,8 @@
+export function defineCatalog(components) {
+    const map = {};
+    for (const comp of components) {
+        map[comp.type] = comp;
+    }
+    return { components: map };
+}
+//# sourceMappingURL=catalog.js.map

package/dist/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../src/catalog.ts"],"names":[],"mappings":"AAiBA,MAAM,UAAU,aAAa,CAAC,UAA2B;IACxD,MAAM,GAAG,GAAkC,EAAE,CAAC;IAC9C,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC/B,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACvB,CAAC;IACD,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC;AAC5B,CAAC"}

package/dist/data-source.d.ts

@@ -0,0 +1,195 @@
+import { z } from 'zod';
+export declare const ColumnMetaSchema: z.ZodObject<{
+    name: z.ZodString;
+    type: z.ZodString;
+    nullable: z.ZodDefault<z.ZodBoolean>;
+    description: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: string;
+    name: string;
+    nullable: boolean;
+    description?: string | undefined;
+}, {
+    type: string;
+    name: string;
+    nullable?: boolean | undefined;
+    description?: string | undefined;
+}>;
+export declare const TableMetaSchema: z.ZodObject<{
+    name: z.ZodString;
+    columns: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodString;
+        nullable: z.ZodDefault<z.ZodBoolean>;
+        description: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: string;
+        name: string;
+        nullable: boolean;
+        description?: string | undefined;
+    }, {
+        type: string;
+        name: string;
+        nullable?: boolean | undefined;
+        description?: string | undefined;
+    }>, "many">;
+    description: z.ZodOptional<z.ZodString>;
+    rowCount: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    columns: {
+        type: string;
+        name: string;
+        nullable: boolean;
+        description?: string | undefined;
+    }[];
+    description?: string | undefined;
+    rowCount?: number | undefined;
+}, {
+    name: string;
+    columns: {
+        type: string;
+        name: string;
+        nullable?: boolean | undefined;
+        description?: string | undefined;
+    }[];
+    description?: string | undefined;
+    rowCount?: number | undefined;
+}>;
+export declare const EndpointMetaSchema: z.ZodObject<{
+    path: z.ZodString;
+    method: z.ZodEnum<["GET", "POST"]>;
+    description: z.ZodOptional<z.ZodString>;
+    responseSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    method: "POST" | "GET";
+    description?: string | undefined;
+    responseSchema?: Record<string, unknown> | undefined;
+}, {
+    path: string;
+    method: "POST" | "GET";
+    description?: string | undefined;
+    responseSchema?: Record<string, unknown> | undefined;
+}>;
+export declare const DataSourceMetaSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    type: z.ZodEnum<["sql", "rest", "static"]>;
+    description: z.ZodOptional<z.ZodString>;
+    tables: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        columns: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            type: z.ZodString;
+            nullable: z.ZodDefault<z.ZodBoolean>;
+            description: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            type: string;
+            name: string;
+            nullable: boolean;
+            description?: string | undefined;
+        }, {
+            type: string;
+            name: string;
+            nullable?: boolean | undefined;
+            description?: string | undefined;
+        }>, "many">;
+        description: z.ZodOptional<z.ZodString>;
+        rowCount: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        columns: {
+            type: string;
+            name: string;
+            nullable: boolean;
+            description?: string | undefined;
+        }[];
+        description?: string | undefined;
+        rowCount?: number | undefined;
+    }, {
+        name: string;
+        columns: {
+            type: string;
+            name: string;
+            nullable?: boolean | undefined;
+            description?: string | undefined;
+        }[];
+        description?: string | undefined;
+        rowCount?: number | undefined;
+    }>, "many">>;
+    endpoints: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        method: z.ZodEnum<["GET", "POST"]>;
+        description: z.ZodOptional<z.ZodString>;
+        responseSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        method: "POST" | "GET";
+        description?: string | undefined;
+        responseSchema?: Record<string, unknown> | undefined;
+    }, {
+        path: string;
+        method: "POST" | "GET";
+        description?: string | undefined;
+        responseSchema?: Record<string, unknown> | undefined;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    type: "sql" | "rest" | "static";
+    name: string;
+    id: string;
+    description?: string | undefined;
+    tables?: {
+        name: string;
+        columns: {
+            type: string;
+            name: string;
+            nullable: boolean;
+            description?: string | undefined;
+        }[];
+        description?: string | undefined;
+        rowCount?: number | undefined;
+    }[] | undefined;
+    endpoints?: {
+        path: string;
+        method: "POST" | "GET";
+        description?: string | undefined;
+        responseSchema?: Record<string, unknown> | undefined;
+    }[] | undefined;
+}, {
+    type: "sql" | "rest" | "static";
+    name: string;
+    id: string;
+    description?: string | undefined;
+    tables?: {
+        name: string;
+        columns: {
+            type: string;
+            name: string;
+            nullable?: boolean | undefined;
+            description?: string | undefined;
+        }[];
+        description?: string | undefined;
+        rowCount?: number | undefined;
+    }[] | undefined;
+    endpoints?: {
+        path: string;
+        method: "POST" | "GET";
+        description?: string | undefined;
+        responseSchema?: Record<string, unknown> | undefined;
+    }[] | undefined;
+}>;
+export type ColumnMeta = z.infer<typeof ColumnMetaSchema>;
+export type TableMeta = z.infer<typeof TableMetaSchema>;
+export type EndpointMeta = z.infer<typeof EndpointMetaSchema>;
+export type DataSourceMeta = z.infer<typeof DataSourceMetaSchema>;
+/**
+ * DataConnector port interface.
+ * Implemented in the server package for each data source type.
+ */
+export interface DataConnector {
+    readonly meta: DataSourceMeta;
+    describe(): Promise<DataSourceMeta>;
+    query(params: Record<string, unknown>): Promise<unknown>;
+}
+//# sourceMappingURL=data-source.d.ts.map

package/dist/data-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-source.d.ts","sourceRoot":"","sources":["../src/data-source.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;EAK3B,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAK1B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;EAK7B,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAO/B,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC1D,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AACxD,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,IAAI,OAAO,CAAC,cAAc,CAAC,CAAC;IACpC,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACzD"}

package/dist/data-source.js

@@ -0,0 +1,28 @@
+import { z } from 'zod';
+export const ColumnMetaSchema = z.object({
+    name: z.string().min(1),
+    type: z.string().min(1),
+    nullable: z.boolean().default(false),
+    description: z.string().optional(),
+});
+export const TableMetaSchema = z.object({
+    name: z.string().min(1),
+    columns: z.array(ColumnMetaSchema),
+    description: z.string().optional(),
+    rowCount: z.number().optional(),
+});
+export const EndpointMetaSchema = z.object({
+    path: z.string().min(1),
+    method: z.enum(['GET', 'POST']),
+    description: z.string().optional(),
+    responseSchema: z.record(z.unknown()).optional(),
+});
+export const DataSourceMetaSchema = z.object({
+    id: z.string().min(1),
+    name: z.string().min(1),
+    type: z.enum(['sql', 'rest', 'static']),
+    description: z.string().optional(),
+    tables: z.array(TableMetaSchema).optional(),
+    endpoints: z.array(EndpointMetaSchema).optional(),
+});
+//# sourceMappingURL=data-source.js.map

package/dist/data-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-source.js","sourceRoot":"","sources":["../src/data-source.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IACpC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAClC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC;IAClC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC/B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAC/B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,cAAc,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;CAChD,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IACvC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,QAAQ,EAAE;IAC3C,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC,QAAQ,EAAE;CACjD,CAAC,CAAC"}

package/dist/element-def.d.ts

@@ -0,0 +1,37 @@
+import { z } from 'zod';
+export declare const VisibilityConditionSchema: z.ZodOptional<z.ZodObject<{
+    expr: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    expr: string;
+}, {
+    expr: string;
+}>>;
+export declare const ElementDefSchema: z.ZodObject<{
+    type: z.ZodString;
+    props: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    children: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    visible: z.ZodOptional<z.ZodObject<{
+        expr: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        expr: string;
+    }, {
+        expr: string;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    type: string;
+    props: Record<string, unknown>;
+    children?: string[] | undefined;
+    visible?: {
+        expr: string;
+    } | undefined;
+}, {
+    type: string;
+    props?: Record<string, unknown> | undefined;
+    children?: string[] | undefined;
+    visible?: {
+        expr: string;
+    } | undefined;
+}>;
+export type ElementDef = z.infer<typeof ElementDefSchema>;
+export type VisibilityCondition = z.infer<typeof VisibilityConditionSchema>;
+//# sourceMappingURL=element-def.d.ts.map

package/dist/element-def.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"element-def.d.ts","sourceRoot":"","sources":["../src/element-def.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,yBAAyB;;;;;;GAI1B,CAAC;AAEb,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;EAK3B,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC1D,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC"}

package/dist/element-def.js

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+export const VisibilityConditionSchema = z
+    .object({
+    expr: z.string(),
+})
+    .optional();
+export const ElementDefSchema = z.object({
+    type: z.string().min(1),
+    props: z.record(z.unknown()).default({}),
+    children: z.array(z.string().min(1)).optional(),
+    visible: VisibilityConditionSchema,
+});
+//# sourceMappingURL=element-def.js.map

package/dist/element-def.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"element-def.js","sourceRoot":"","sources":["../src/element-def.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC;KACxC,MAAM,CAAC;IACP,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;CAChB,CAAC;KACD,QAAQ,EAAE,CAAC;AAEb,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACxC,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC/C,OAAO,EAAE,yBAAyB;CAClC,CAAC,CAAC"}

package/dist/expression.d.ts

@@ -0,0 +1,28 @@
+import { z } from 'zod';
+export type ExpressionRef = {
+    type: 'hook';
+    hookId: string;
+    path: string[];
+} | {
+    type: 'state';
+    key: string;
+} | {
+    type: 'bindState';
+    key: string;
+} | {
+    type: 'action';
+    actionId: string;
+} | {
+    type: 'item';
+    path: string[];
+} | {
+    type: 'param';
+    name: string;
+} | {
+    type: 'expr';
+    code: string;
+};
+export declare function isExpression(value: unknown): value is string;
+export declare function parseExpression(value: string): ExpressionRef | null;
+export declare const ExpressionStringSchema: z.ZodEffects<z.ZodString, string, string>;
+//# sourceMappingURL=expression.d.ts.map

package/dist/expression.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expression.d.ts","sourceRoot":"","sources":["../src/expression.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,MAAM,aAAa,GACtB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,GAChD;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAYlC,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAE5D;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CA4CnE;AAED,eAAO,MAAM,sBAAsB,2CAIhC,CAAC"}