@objectstack/spec 0.3.0 → 0.3.2

package/dist/ui/view.zod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"view.zod.d.ts","sourceRoot":"","sources":["../../src/ui/view.zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;EAI7B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;EAK/B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;EAM5B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,cAAc;;;;IAKzB,0BAA0B;;;;;;;;;;;;;IAW1B,aAAa;;IAGb,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAI3B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;EAM5B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAIzB,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,UAAU;;;;;QA5CrB,0BAA0B;;;;;;;;;;;;;QAW1B,aAAa;;QAGb,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAd3B,0BAA0B;;;;;;;;;;;;;QAW1B,aAAa;;QAGb,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmC3B,CAAC;AAEH,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAC9C,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AACtD,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AACtD,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC"}
+{"version":3,"file":"view.zod.d.ts","sourceRoot":"","sources":["../../src/ui/view.zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,gBAAgB,sDAAoD,CAAC;AAElF;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;EAM5B,CAAC;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAczB,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAU3B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;EAEhC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;EAGjC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;EAI7B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;EAK/B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;EAM5B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,cAAc;;;;IAKzB,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAGhC,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAc1B,aAAa;;IAGb,oBAAoB;;;;IAKpB,gBAAgB;;;;;;;;IAGhB,iBAAiB;;;;;;;;;;;IAGjB,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAI3B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAY1B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAS5B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,cAAc;;IAGzB,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAKhC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,UAAU;;;;;QAtFrB,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAGhC,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAc1B,aAAa;;QAGb,oBAAoB;;;;QAKpB,gBAAgB;;;;;;;;QAGhB,iBAAiB;;;;;;;;;;;QAGjB,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QA4C3B,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QA3EhC,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAGhC,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAc1B,aAAa;;QAGb,oBAAoB;;;;QAKpB,gBAAgB;;;;;;;;QAGhB,iBAAiB;;;;;;;;;;;QAGjB,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QA4C3B,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgBhC,CAAC;AAEH,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAC9C,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AACtD,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AACtD,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,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,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AACtD,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC"}

package/dist/ui/view.zod.js

@@ -1,7 +1,71 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ViewSchema = exports.FormViewSchema = exports.FormSectionSchema = exports.ListViewSchema = exports.GanttConfigSchema = exports.CalendarConfigSchema = exports.KanbanConfigSchema = void 0;
+exports.ViewSchema = exports.FormViewSchema = exports.FormSectionSchema = exports.FormFieldSchema = exports.ListViewSchema = exports.GanttConfigSchema = exports.CalendarConfigSchema = exports.KanbanConfigSchema = exports.PaginationConfigSchema = exports.SelectionConfigSchema = exports.ListColumnSchema = exports.ViewDataSchema = exports.HttpRequestSchema = exports.HttpMethodSchema = void 0;
 const zod_1 = require("zod");
+/**
+ * HTTP Method Enum
+ */
+exports.HttpMethodSchema = zod_1.z.enum(['GET', 'POST', 'PUT', 'PATCH', 'DELETE']);
+/**
+ * HTTP Request Configuration for API Provider
+ */
+exports.HttpRequestSchema = zod_1.z.object({
+    url: zod_1.z.string().describe('API endpoint URL'),
+    method: exports.HttpMethodSchema.optional().default('GET').describe('HTTP method'),
+    headers: zod_1.z.record(zod_1.z.string()).optional().describe('Custom HTTP headers'),
+    params: zod_1.z.record(zod_1.z.unknown()).optional().describe('Query parameters'),
+    body: zod_1.z.unknown().optional().describe('Request body for POST/PUT/PATCH'),
+});
+/**
+ * View Data Source Configuration
+ * Supports three modes:
+ * 1. 'object': Standard Protocol - Auto-connects to ObjectStack Metadata and Data APIs
+ * 2. 'api': Custom API - Explicitly provided API URLs
+ * 3. 'value': Static Data - Hardcoded data array
+ */
+exports.ViewDataSchema = zod_1.z.discriminatedUnion('provider', [
+    zod_1.z.object({
+        provider: zod_1.z.literal('object'),
+        object: zod_1.z.string().describe('Target object name'),
+    }),
+    zod_1.z.object({
+        provider: zod_1.z.literal('api'),
+        read: exports.HttpRequestSchema.optional().describe('Configuration for fetching data'),
+        write: exports.HttpRequestSchema.optional().describe('Configuration for submitting data (for forms/editable tables)'),
+    }),
+    zod_1.z.object({
+        provider: zod_1.z.literal('value'),
+        items: zod_1.z.array(zod_1.z.unknown()).describe('Static data array'),
+    }),
+]);
+/**
+ * List Column Configuration Schema
+ * Detailed configuration for individual list view columns
+ */
+exports.ListColumnSchema = zod_1.z.object({
+    field: zod_1.z.string().describe('Field name (snake_case)'),
+    label: zod_1.z.string().optional().describe('Display label override'),
+    width: zod_1.z.number().positive().optional().describe('Column width in pixels'),
+    align: zod_1.z.enum(['left', 'center', 'right']).optional().describe('Text alignment'),
+    hidden: zod_1.z.boolean().optional().describe('Hide column by default'),
+    sortable: zod_1.z.boolean().optional().describe('Allow sorting by this column'),
+    resizable: zod_1.z.boolean().optional().describe('Allow resizing this column'),
+    wrap: zod_1.z.boolean().optional().describe('Allow text wrapping'),
+    type: zod_1.z.string().optional().describe('Renderer type override (e.g., "currency", "date")'),
+});
+/**
+ * List View Selection Configuration
+ */
+exports.SelectionConfigSchema = zod_1.z.object({
+    type: zod_1.z.enum(['none', 'single', 'multiple']).default('none').describe('Selection mode'),
+});
+/**
+ * List View Pagination Configuration
+ */
+exports.PaginationConfigSchema = zod_1.z.object({
+    pageSize: zod_1.z.number().int().positive().default(25).describe('Number of records per page'),
+    pageSizeOptions: zod_1.z.array(zod_1.z.number().int().positive()).optional().describe('Available page size options'),
+});
 /**
  * Kanban Settings
  */
@@ -36,8 +100,13 @@ exports.ListViewSchema = zod_1.z.object({
     name: zod_1.z.string().optional(), // Internal name
     label: zod_1.z.string().optional(), // Display label override
     type: zod_1.z.enum(['grid', 'kanban', 'calendar', 'gantt', 'map']).default('grid'),
+    /** Data Source Configuration */
+    data: exports.ViewDataSchema.optional().describe('Data source configuration (defaults to "object" provider)'),
     /** Shared Query Config */
-    columns: zod_1.z.array(zod_1.z.string()).describe('Fields to display as columns'),
+    columns: zod_1.z.union([
+        zod_1.z.array(zod_1.z.string()), // Legacy: simple field names
+        zod_1.z.array(exports.ListColumnSchema), // Enhanced: detailed column config
+    ]).describe('Fields to display as columns'),
     filter: zod_1.z.array(zod_1.z.any()).optional().describe('Filter criteria (JSON Rules)'),
     sort: zod_1.z.union([
         zod_1.z.string(), //Legacy "field desc"
@@ -48,11 +117,36 @@ exports.ListViewSchema = zod_1.z.object({
     ]).optional(),
     /** Search */
     searchableFields: zod_1.z.array(zod_1.z.string()).optional().describe('Fields enabled for search'),
+    /** Grid Features */
+    resizable: zod_1.z.boolean().optional().describe('Enable column resizing'),
+    striped: zod_1.z.boolean().optional().describe('Striped row styling'),
+    bordered: zod_1.z.boolean().optional().describe('Show borders'),
+    /** Selection */
+    selection: exports.SelectionConfigSchema.optional().describe('Row selection configuration'),
+    /** Pagination */
+    pagination: exports.PaginationConfigSchema.optional().describe('Pagination configuration'),
     /** Type Specific Config */
     kanban: exports.KanbanConfigSchema.optional(),
     calendar: exports.CalendarConfigSchema.optional(),
     gantt: exports.GanttConfigSchema.optional(),
 });
+/**
+ * Form Field Configuration Schema
+ * Detailed configuration for individual form fields
+ */
+exports.FormFieldSchema = zod_1.z.object({
+    field: zod_1.z.string().describe('Field name (snake_case)'),
+    label: zod_1.z.string().optional().describe('Display label override'),
+    placeholder: zod_1.z.string().optional().describe('Placeholder text'),
+    helpText: zod_1.z.string().optional().describe('Help/hint text'),
+    readonly: zod_1.z.boolean().optional().describe('Read-only override'),
+    required: zod_1.z.boolean().optional().describe('Required override'),
+    hidden: zod_1.z.boolean().optional().describe('Hidden override'),
+    colSpan: zod_1.z.number().int().min(1).max(4).optional().describe('Column span in grid layout (1-4)'),
+    widget: zod_1.z.string().optional().describe('Custom widget/component name'),
+    dependsOn: zod_1.z.string().optional().describe('Parent field name for cascading'),
+    visibleOn: zod_1.z.string().optional().describe('Visibility condition expression'),
+});
 /**
  * Form Layout Section
  */
@@ -61,13 +155,18 @@ exports.FormSectionSchema = zod_1.z.object({
     collapsible: zod_1.z.boolean().default(false),
     collapsed: zod_1.z.boolean().default(false),
     columns: zod_1.z.enum(['1', '2', '3', '4']).default('2').transform(val => parseInt(val)),
-    fields: zod_1.z.array(zod_1.z.string()), // or complex FieldConfig
+    fields: zod_1.z.array(zod_1.z.union([
+        zod_1.z.string(), // Legacy: simple field name
+        exports.FormFieldSchema, // Enhanced: detailed field config
+    ])),
 });
 /**
  * Form View Schema
  */
 exports.FormViewSchema = zod_1.z.object({
     type: zod_1.z.enum(['simple', 'tabbed', 'wizard']).default('simple'),
+    /** Data Source Configuration */
+    data: exports.ViewDataSchema.optional().describe('Data source configuration (defaults to "object" provider)'),
     sections: zod_1.z.array(exports.FormSectionSchema).optional(), // For simple layout
     groups: zod_1.z.array(exports.FormSectionSchema).optional(), // Legacy support -> alias to sections
 });

package/dist/ui/widget.zod.d.ts

@@ -48,7 +48,7 @@ export declare const FieldWidgetPropsSchema: z.ZodObject<{
     field: z.ZodObject<{
         name: z.ZodOptional<z.ZodString>;
         label: z.ZodOptional<z.ZodString>;
-        type: z.ZodEnum<["text", "textarea", "email", "url", "phone", "password", "markdown", "html", "richtext", "number", "currency", "percent", "date", "datetime", "time", "boolean", "select", "lookup", "master_detail", "image", "file", "avatar", "formula", "summary", "autonumber", "location", "address", "code", "color", "rating", "signature"]>;
+        type: z.ZodEnum<["text", "textarea", "email", "url", "phone", "password", "markdown", "html", "richtext", "number", "currency", "percent", "date", "datetime", "time", "boolean", "select", "lookup", "master_detail", "image", "file", "avatar", "formula", "summary", "autonumber", "location", "geolocation", "address", "code", "color", "rating", "slider", "signature", "qrcode"]>;
         description: z.ZodOptional<z.ZodString>;
         format: z.ZodOptional<z.ZodString>;
         required: z.ZodDefault<z.ZodBoolean>;
@@ -108,13 +108,20 @@ export declare const FieldWidgetPropsSchema: z.ZodObject<{
         colorFormat: z.ZodOptional<z.ZodEnum<["hex", "rgb", "rgba", "hsl"]>>;
         allowAlpha: z.ZodOptional<z.ZodBoolean>;
         presetColors: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        step: z.ZodOptional<z.ZodNumber>;
+        showValue: z.ZodOptional<z.ZodBoolean>;
+        marks: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        barcodeFormat: z.ZodOptional<z.ZodEnum<["qr", "ean13", "ean8", "code128", "code39", "upca", "upce"]>>;
+        qrErrorCorrection: z.ZodOptional<z.ZodEnum<["L", "M", "Q", "H"]>>;
+        displayValue: z.ZodOptional<z.ZodBoolean>;
+        allowScanning: z.ZodOptional<z.ZodBoolean>;
         hidden: z.ZodDefault<z.ZodBoolean>;
         readonly: z.ZodDefault<z.ZodBoolean>;
         encryption: z.ZodDefault<z.ZodBoolean>;
         index: z.ZodDefault<z.ZodBoolean>;
         externalId: z.ZodDefault<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
-        type: "number" | "boolean" | "text" | "textarea" | "email" | "url" | "phone" | "password" | "markdown" | "html" | "richtext" | "currency" | "percent" | "date" | "datetime" | "time" | "select" | "lookup" | "master_detail" | "image" | "file" | "avatar" | "formula" | "summary" | "autonumber" | "location" | "address" | "code" | "color" | "rating" | "signature";
+        type: "number" | "boolean" | "text" | "textarea" | "email" | "url" | "phone" | "password" | "markdown" | "html" | "richtext" | "currency" | "percent" | "date" | "datetime" | "time" | "select" | "lookup" | "master_detail" | "image" | "file" | "avatar" | "formula" | "summary" | "autonumber" | "location" | "geolocation" | "address" | "code" | "color" | "rating" | "slider" | "signature" | "qrcode";
         required: boolean;
         searchable: boolean;
         multiple: boolean;
@@ -163,8 +170,15 @@ export declare const FieldWidgetPropsSchema: z.ZodObject<{
         colorFormat?: "hex" | "rgb" | "rgba" | "hsl" | undefined;
         allowAlpha?: boolean | undefined;
         presetColors?: string[] | undefined;
+        step?: number | undefined;
+        showValue?: boolean | undefined;
+        marks?: Record<string, string> | undefined;
+        barcodeFormat?: "qr" | "ean13" | "ean8" | "code128" | "code39" | "upca" | "upce" | undefined;
+        qrErrorCorrection?: "L" | "M" | "Q" | "H" | undefined;
+        displayValue?: boolean | undefined;
+        allowScanning?: boolean | undefined;
     }, {
-        type: "number" | "boolean" | "text" | "textarea" | "email" | "url" | "phone" | "password" | "markdown" | "html" | "richtext" | "currency" | "percent" | "date" | "datetime" | "time" | "select" | "lookup" | "master_detail" | "image" | "file" | "avatar" | "formula" | "summary" | "autonumber" | "location" | "address" | "code" | "color" | "rating" | "signature";
+        type: "number" | "boolean" | "text" | "textarea" | "email" | "url" | "phone" | "password" | "markdown" | "html" | "richtext" | "currency" | "percent" | "date" | "datetime" | "time" | "select" | "lookup" | "master_detail" | "image" | "file" | "avatar" | "formula" | "summary" | "autonumber" | "location" | "geolocation" | "address" | "code" | "color" | "rating" | "slider" | "signature" | "qrcode";
         formula?: string | undefined;
         options?: {
             value: string;
@@ -208,6 +222,13 @@ export declare const FieldWidgetPropsSchema: z.ZodObject<{
         colorFormat?: "hex" | "rgb" | "rgba" | "hsl" | undefined;
         allowAlpha?: boolean | undefined;
         presetColors?: string[] | undefined;
+        step?: number | undefined;
+        showValue?: boolean | undefined;
+        marks?: Record<string, string> | undefined;
+        barcodeFormat?: "qr" | "ean13" | "ean8" | "code128" | "code39" | "upca" | "upce" | undefined;
+        qrErrorCorrection?: "L" | "M" | "Q" | "H" | undefined;
+        displayValue?: boolean | undefined;
+        allowScanning?: boolean | undefined;
         hidden?: boolean | undefined;
         readonly?: boolean | undefined;
         encryption?: boolean | undefined;
@@ -227,7 +248,7 @@ export declare const FieldWidgetPropsSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     required: boolean;
     field: {
-        type: "number" | "boolean" | "text" | "textarea" | "email" | "url" | "phone" | "password" | "markdown" | "html" | "richtext" | "currency" | "percent" | "date" | "datetime" | "time" | "select" | "lookup" | "master_detail" | "image" | "file" | "avatar" | "formula" | "summary" | "autonumber" | "location" | "address" | "code" | "color" | "rating" | "signature";
+        type: "number" | "boolean" | "text" | "textarea" | "email" | "url" | "phone" | "password" | "markdown" | "html" | "richtext" | "currency" | "percent" | "date" | "datetime" | "time" | "select" | "lookup" | "master_detail" | "image" | "file" | "avatar" | "formula" | "summary" | "autonumber" | "location" | "geolocation" | "address" | "code" | "color" | "rating" | "slider" | "signature" | "qrcode";
         required: boolean;
         searchable: boolean;
         multiple: boolean;
@@ -276,6 +297,13 @@ export declare const FieldWidgetPropsSchema: z.ZodObject<{
         colorFormat?: "hex" | "rgb" | "rgba" | "hsl" | undefined;
         allowAlpha?: boolean | undefined;
         presetColors?: string[] | undefined;
+        step?: number | undefined;
+        showValue?: boolean | undefined;
+        marks?: Record<string, string> | undefined;
+        barcodeFormat?: "qr" | "ean13" | "ean8" | "code128" | "code39" | "upca" | "upce" | undefined;
+        qrErrorCorrection?: "L" | "M" | "Q" | "H" | undefined;
+        displayValue?: boolean | undefined;
+        allowScanning?: boolean | undefined;
     };
     readonly: boolean;
     onChange: (args_0: any, ...args: unknown[]) => void;
@@ -285,7 +313,7 @@ export declare const FieldWidgetPropsSchema: z.ZodObject<{
     record?: Record<string, any> | undefined;
 }, {
     field: {
-        type: "number" | "boolean" | "text" | "textarea" | "email" | "url" | "phone" | "password" | "markdown" | "html" | "richtext" | "currency" | "percent" | "date" | "datetime" | "time" | "select" | "lookup" | "master_detail" | "image" | "file" | "avatar" | "formula" | "summary" | "autonumber" | "location" | "address" | "code" | "color" | "rating" | "signature";
+        type: "number" | "boolean" | "text" | "textarea" | "email" | "url" | "phone" | "password" | "markdown" | "html" | "richtext" | "currency" | "percent" | "date" | "datetime" | "time" | "select" | "lookup" | "master_detail" | "image" | "file" | "avatar" | "formula" | "summary" | "autonumber" | "location" | "geolocation" | "address" | "code" | "color" | "rating" | "slider" | "signature" | "qrcode";
         formula?: string | undefined;
         options?: {
             value: string;
@@ -329,6 +357,13 @@ export declare const FieldWidgetPropsSchema: z.ZodObject<{
         colorFormat?: "hex" | "rgb" | "rgba" | "hsl" | undefined;
         allowAlpha?: boolean | undefined;
         presetColors?: string[] | undefined;
+        step?: number | undefined;
+        showValue?: boolean | undefined;
+        marks?: Record<string, string> | undefined;
+        barcodeFormat?: "qr" | "ean13" | "ean8" | "code128" | "code39" | "upca" | "upce" | undefined;
+        qrErrorCorrection?: "L" | "M" | "Q" | "H" | undefined;
+        displayValue?: boolean | undefined;
+        allowScanning?: boolean | undefined;
         hidden?: boolean | undefined;
         readonly?: boolean | undefined;
         encryption?: boolean | undefined;

package/dist/ui/widget.zod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"widget.zod.d.ts","sourceRoot":"","sources":["../../src/ui/widget.zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,sBAAsB;IACjC;;;OAGG;;IAGH;;;;;OAKG;;IAMH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAGH;;;OAGG;;IAGH;;;OAGG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEH,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC"}
+{"version":3,"file":"widget.zod.d.ts","sourceRoot":"","sources":["../../src/ui/widget.zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,sBAAsB;IACjC;;;OAGG;;IAGH;;;;;OAKG;;IAMH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAGH;;;OAGG;;IAGH;;;OAGG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEH,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC"}

package/json-schema/README.md

@@ -0,0 +1,127 @@
+# JSON Schema Directory
+
+This directory contains auto-generated JSON schemas for all ObjectStack protocols, organized by category.
+
+## Directory Structure
+
+The schemas are organized into the following categories matching the protocol structure:
+
+```
+json-schema/
+├── data/       # Data Protocol - Business Logic & Data Modeling (74 schemas)
+├── ui/         # UI Protocol - Presentation & Interaction (39 schemas)
+├── system/     # System Protocol - Runtime Configuration & Security (112 schemas)
+├── ai/         # AI Protocol - AI/ML Capabilities (86 schemas)
+└── api/        # API Protocol - API Contracts & Envelopes (12 schemas)
+```
+
+## Categories
+
+### 📊 Data Protocol (`data/`)
+Core business logic and data modeling schemas:
+- Object, Field, Validation
+- Query (AST), Mapping (ETL)
+- Permission, Sharing, Flow, Workflow
+
+**Example schemas:** `Field.json`, `Object.json`, `Query.json`, `ValidationRule.json`
+
+### 🎨 UI Protocol (`ui/`)
+Presentation and interaction schemas:
+- App, Page, View (Grid/Kanban/Calendar/Gantt)
+- Dashboard (Widgets), Report
+- Action (Triggers), Theme
+
+**Example schemas:** `App.json`, `View.json`, `Dashboard.json`, `Theme.json`
+
+### ⚙️ System Protocol (`system/`)
+Runtime configuration and security schemas:
+- Manifest (Config), Datasource, Driver
+- Role (Hierarchy), Identity (Auth)
+- Webhook (Integration), Policy (Compliance)
+- Plugin Architecture, Audit, Tenant Management
+
+**Example schemas:** `Manifest.json`, `AuthConfig.json`, `Datasource.json`, `AuditEvent.json`
+
+### 🤖 AI Protocol (`ai/`)
+AI/ML capabilities schemas:
+- Agent Configuration
+- Model Registry & Selection
+- RAG Pipeline, NLQ (Natural Language Query)
+- Workflow Automation, Predictive Analytics
+- Conversation Memory & Token Management
+- Cost Tracking & Budget Management
+
+**Example schemas:** `Agent.json`, `ModelRegistry.json`, `RAGPipelineConfig.json`, `NLQRequest.json`
+
+### 🔌 API Protocol (`api/`)
+API contracts and envelopes:
+- Request/Response schemas
+- Error handling
+- Bulk operations
+
+**Example schemas:** `ApiEndpoint.json`, `BaseResponse.json`, `BulkRequest.json`
+
+## Generation
+
+These schemas are automatically generated from Zod schemas during the build process:
+
+```bash
+npm run gen:schema
+```
+
+The generation script is located at `scripts/build-schemas.ts`.
+
+## Usage
+
+### In TypeScript/JavaScript Projects
+
+You can reference these JSON schemas for validation, documentation, or IDE support:
+
+```typescript
+import fieldSchema from '@objectstack/spec/json-schema/data/Field.json';
+```
+
+### In JSON Schema Tools
+
+Use these schemas with any JSON Schema validator or documentation generator:
+
+```bash
+ajv validate -s json-schema/data/Field.json -d myfield.json
+```
+
+### In IDEs
+
+Many IDEs support JSON schema validation. You can reference these schemas in your configuration files:
+
+```json
+{
+  "$schema": "./node_modules/@objectstack/spec/json-schema/data/Object.json"
+}
+```
+
+## Schema Format
+
+All schemas are generated with:
+- **Format:** JSON Schema Draft 7
+- **Strategy:** Self-contained (no external `$ref`s)
+- **Naming:** PascalCase matching the TypeScript type names
+
+## Conventions
+
+- **Configuration Keys (Properties):** `camelCase` (e.g., `maxLength`, `referenceFilters`)
+- **Machine Names (Data Values):** `snake_case` (e.g., `name: 'first_name'`, `object: 'project_task'`)
+
+## Contributing
+
+Do not manually edit these files. They are auto-generated from the Zod schemas in `src/`.
+
+To update schemas:
+1. Edit the corresponding `.zod.ts` file in `src/{category}/`
+2. Run `npm run gen:schema`
+3. Commit both the Zod source and generated JSON schemas
+
+---
+
+**Total Schemas:** 325 (as of latest build)
+
+For more information, see the main [README](../README.md).

package/json-schema/ai/AITask.json

@@ -0,0 +1,123 @@
+{
+  "$ref": "#/definitions/AITask",
+  "definitions": {
+    "AITask": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Optional task ID for referencing"
+        },
+        "name": {
+          "type": "string",
+          "description": "Human-readable task name"
+        },
+        "type": {
+          "type": "string",
+          "enum": [
+            "classify",
+            "extract",
+            "summarize",
+            "generate",
+            "predict",
+            "translate",
+            "sentiment",
+            "entity_recognition",
+            "anomaly_detection",
+            "recommendation"
+          ]
+        },
+        "model": {
+          "type": "string",
+          "description": "Model ID from registry (uses default if not specified)"
+        },
+        "promptTemplate": {
+          "type": "string",
+          "description": "Prompt template ID for this task"
+        },
+        "inputFields": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Source fields to process (e.g., [\"description\", \"comments\"])"
+        },
+        "inputContext": {
+          "type": "object",
+          "additionalProperties": {},
+          "description": "Additional context for the AI model"
+        },
+        "outputField": {
+          "type": "string",
+          "description": "Target field to store the result"
+        },
+        "outputFormat": {
+          "type": "string",
+          "enum": [
+            "text",
+            "json",
+            "number",
+            "boolean",
+            "array"
+          ],
+          "default": "text"
+        },
+        "classes": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Valid classes for classification tasks"
+        },
+        "multiClass": {
+          "type": "boolean",
+          "default": false,
+          "description": "Allow multiple classes to be selected"
+        },
+        "extractionSchema": {
+          "type": "object",
+          "additionalProperties": {},
+          "description": "JSON schema for structured extraction"
+        },
+        "maxLength": {
+          "type": "number",
+          "description": "Maximum length for generated content"
+        },
+        "temperature": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 2,
+          "description": "Model temperature override"
+        },
+        "fallbackValue": {
+          "description": "Fallback value if AI task fails"
+        },
+        "retryAttempts": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 5,
+          "default": 1
+        },
+        "condition": {
+          "type": "string",
+          "description": "Formula condition - task only runs if TRUE"
+        },
+        "description": {
+          "type": "string"
+        },
+        "active": {
+          "type": "boolean",
+          "default": true
+        }
+      },
+      "required": [
+        "name",
+        "type",
+        "inputFields",
+        "outputField"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/ai/AITaskType.json

@@ -0,0 +1,21 @@
+{
+  "$ref": "#/definitions/AITaskType",
+  "definitions": {
+    "AITaskType": {
+      "type": "string",
+      "enum": [
+        "classify",
+        "extract",
+        "summarize",
+        "generate",
+        "predict",
+        "translate",
+        "sentiment",
+        "entity_recognition",
+        "anomaly_detection",
+        "recommendation"
+      ]
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}