@objectstack/spec 0.3.2 → 0.4.1

package/dist/ui/component.zod.js

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ComponentPropsMap = exports.RecordHighlightsProps = exports.RecordRelatedListProps = exports.RecordDetailsProps = exports.PageCardProps = exports.PageTabsProps = exports.PageHeaderProps = void 0;
+const zod_1 = require("zod");
+/**
+ * Empty Properties Schema
+ */
+const EmptyProps = zod_1.z.object({});
+/**
+ * ----------------------------------------------------------------------
+ * 1. Structure Components
+ * ----------------------------------------------------------------------
+ */
+exports.PageHeaderProps = zod_1.z.object({
+    title: zod_1.z.string().describe('Page title'),
+    subtitle: zod_1.z.string().optional().describe('Page subtitle'),
+    icon: zod_1.z.string().optional().describe('Icon name'),
+    breadcrumb: zod_1.z.boolean().default(true).describe('Show breadcrumb'),
+    actions: zod_1.z.array(zod_1.z.string()).optional().describe('Action IDs to show in header'),
+});
+exports.PageTabsProps = zod_1.z.object({
+    type: zod_1.z.enum(['line', 'card', 'pill']).default('line'),
+    position: zod_1.z.enum(['top', 'left']).default('top'),
+    items: zod_1.z.array(zod_1.z.object({
+        label: zod_1.z.string(),
+        icon: zod_1.z.string().optional(),
+        children: zod_1.z.array(zod_1.z.any()).describe('Child components')
+    }))
+});
+exports.PageCardProps = zod_1.z.object({
+    title: zod_1.z.string().optional(),
+    bordered: zod_1.z.boolean().default(true),
+    actions: zod_1.z.array(zod_1.z.string()).optional(),
+    children: zod_1.z.array(zod_1.z.any()).describe('Card content')
+});
+/**
+ * ----------------------------------------------------------------------
+ * 2. Record Context Components
+ * ----------------------------------------------------------------------
+ */
+exports.RecordDetailsProps = zod_1.z.object({
+    columns: zod_1.z.enum(['1', '2', '3', '4']).default('2'),
+    layout: zod_1.z.enum(['auto', 'custom']).default('auto'),
+    // If custom layout
+    sections: zod_1.z.array(zod_1.z.string()).optional().describe('Section IDs to show')
+});
+exports.RecordRelatedListProps = zod_1.z.object({
+    objectName: zod_1.z.string().describe('Related object name'),
+    relationshipField: zod_1.z.string().describe('Field on related object that points to this record'),
+    columns: zod_1.z.array(zod_1.z.string()).describe('Fields to display'),
+    sort: zod_1.z.string().optional(),
+    limit: zod_1.z.number().default(5)
+});
+exports.RecordHighlightsProps = zod_1.z.object({
+    fields: zod_1.z.array(zod_1.z.string()).min(1).max(7).describe('Key fields to highlights (max 7)')
+});
+/**
+ * ----------------------------------------------------------------------
+ * Component Props Map
+ * Maps Component Type to its Property Schema
+ * ----------------------------------------------------------------------
+ */
+exports.ComponentPropsMap = {
+    // Structure
+    'page:header': exports.PageHeaderProps,
+    'page:tabs': exports.PageTabsProps,
+    'page:card': exports.PageCardProps,
+    'page:footer': EmptyProps,
+    'page:sidebar': EmptyProps,
+    'page:accordion': EmptyProps,
+    'page:section': EmptyProps,
+    // Record
+    'record:details': exports.RecordDetailsProps,
+    'record:related_list': exports.RecordRelatedListProps,
+    'record:highlights': exports.RecordHighlightsProps,
+    'record:activity': EmptyProps,
+    'record:chatter': EmptyProps,
+    'record:path': EmptyProps,
+    // Navigation
+    'app:launcher': EmptyProps,
+    'nav:menu': EmptyProps,
+    'nav:breadcrumb': EmptyProps,
+    // Utility
+    'global:search': EmptyProps,
+    'global:notifications': EmptyProps,
+    'user:profile': EmptyProps,
+    // AI
+    'ai:chat_window': zod_1.z.object({ mode: zod_1.z.enum(['float', 'sidebar', 'inline']).default('float') }),
+    'ai:suggestion': zod_1.z.object({ context: zod_1.z.string().optional() })
+};

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

@@ -2,7 +2,7 @@ import { z } from 'zod';
 /**
  * Chart Type Enum
  */
-export declare const ChartType: z.ZodEnum<["metric", "bar", "line", "pie", "donut", "funnel", "table", "text"]>;
+export declare const ChartType: z.ZodEnum<["metric", "bar", "line", "pie", "donut", "gauge", "funnel", "radar", "scatter", "heatmap", "pivot", "table", "list", "text", "image", "frame"]>;
 /**
  * Dashboard Widget Schema
  * A single component on the dashboard grid.
@@ -11,7 +11,7 @@ export declare const DashboardWidgetSchema: z.ZodObject<{
     /** Widget Title */
     title: z.ZodOptional<z.ZodString>;
     /** Visualization Type */
-    type: z.ZodDefault<z.ZodEnum<["metric", "bar", "line", "pie", "donut", "funnel", "table", "text"]>>;
+    type: z.ZodDefault<z.ZodEnum<["metric", "bar", "line", "pie", "donut", "gauge", "funnel", "radar", "scatter", "heatmap", "pivot", "table", "list", "text", "image", "frame"]>>;
     /** Data Source Object */
     object: z.ZodOptional<z.ZodString>;
     /** Data Filter (MongoDB-style FilterCondition) */
@@ -48,8 +48,8 @@ export declare const DashboardWidgetSchema: z.ZodObject<{
     /** Widget specific options (colors, legend, etc.) */
     options: z.ZodOptional<z.ZodAny>;
 }, "strip", z.ZodTypeAny, {
-    type: "text" | "metric" | "bar" | "line" | "pie" | "donut" | "funnel" | "table";
-    aggregate: "min" | "max" | "count" | "sum" | "avg";
+    type: "frame" | "text" | "image" | "list" | "metric" | "bar" | "line" | "pie" | "donut" | "gauge" | "funnel" | "radar" | "scatter" | "heatmap" | "pivot" | "table";
+    aggregate: "count" | "sum" | "avg" | "min" | "max";
     layout: {
         x: number;
         y: number;
@@ -72,8 +72,8 @@ export declare const DashboardWidgetSchema: z.ZodObject<{
     object?: string | undefined;
     filter?: import("../data/filter.zod").FilterCondition | undefined;
     options?: any;
-    type?: "text" | "metric" | "bar" | "line" | "pie" | "donut" | "funnel" | "table" | undefined;
-    aggregate?: "min" | "max" | "count" | "sum" | "avg" | undefined;
+    type?: "frame" | "text" | "image" | "list" | "metric" | "bar" | "line" | "pie" | "donut" | "gauge" | "funnel" | "radar" | "scatter" | "heatmap" | "pivot" | "table" | undefined;
+    aggregate?: "count" | "sum" | "avg" | "min" | "max" | undefined;
     title?: string | undefined;
     categoryField?: string | undefined;
     valueField?: string | undefined;
@@ -94,7 +94,7 @@ export declare const DashboardSchema: z.ZodObject<{
         /** Widget Title */
         title: z.ZodOptional<z.ZodString>;
         /** Visualization Type */
-        type: z.ZodDefault<z.ZodEnum<["metric", "bar", "line", "pie", "donut", "funnel", "table", "text"]>>;
+        type: z.ZodDefault<z.ZodEnum<["metric", "bar", "line", "pie", "donut", "gauge", "funnel", "radar", "scatter", "heatmap", "pivot", "table", "list", "text", "image", "frame"]>>;
         /** Data Source Object */
         object: z.ZodOptional<z.ZodString>;
         /** Data Filter (MongoDB-style FilterCondition) */
@@ -131,8 +131,8 @@ export declare const DashboardSchema: z.ZodObject<{
         /** Widget specific options (colors, legend, etc.) */
         options: z.ZodOptional<z.ZodAny>;
     }, "strip", z.ZodTypeAny, {
-        type: "text" | "metric" | "bar" | "line" | "pie" | "donut" | "funnel" | "table";
-        aggregate: "min" | "max" | "count" | "sum" | "avg";
+        type: "frame" | "text" | "image" | "list" | "metric" | "bar" | "line" | "pie" | "donut" | "gauge" | "funnel" | "radar" | "scatter" | "heatmap" | "pivot" | "table";
+        aggregate: "count" | "sum" | "avg" | "min" | "max";
         layout: {
             x: number;
             y: number;
@@ -155,8 +155,8 @@ export declare const DashboardSchema: z.ZodObject<{
         object?: string | undefined;
         filter?: import("../data/filter.zod").FilterCondition | undefined;
         options?: any;
-        type?: "text" | "metric" | "bar" | "line" | "pie" | "donut" | "funnel" | "table" | undefined;
-        aggregate?: "min" | "max" | "count" | "sum" | "avg" | undefined;
+        type?: "frame" | "text" | "image" | "list" | "metric" | "bar" | "line" | "pie" | "donut" | "gauge" | "funnel" | "radar" | "scatter" | "heatmap" | "pivot" | "table" | undefined;
+        aggregate?: "count" | "sum" | "avg" | "min" | "max" | undefined;
         title?: string | undefined;
         categoryField?: string | undefined;
         valueField?: string | undefined;
@@ -165,8 +165,8 @@ export declare const DashboardSchema: z.ZodObject<{
     label: string;
     name: string;
     widgets: {
-        type: "text" | "metric" | "bar" | "line" | "pie" | "donut" | "funnel" | "table";
-        aggregate: "min" | "max" | "count" | "sum" | "avg";
+        type: "frame" | "text" | "image" | "list" | "metric" | "bar" | "line" | "pie" | "donut" | "gauge" | "funnel" | "radar" | "scatter" | "heatmap" | "pivot" | "table";
+        aggregate: "count" | "sum" | "avg" | "min" | "max";
         layout: {
             x: number;
             y: number;
@@ -194,8 +194,8 @@ export declare const DashboardSchema: z.ZodObject<{
         object?: string | undefined;
         filter?: import("../data/filter.zod").FilterCondition | undefined;
         options?: any;
-        type?: "text" | "metric" | "bar" | "line" | "pie" | "donut" | "funnel" | "table" | undefined;
-        aggregate?: "min" | "max" | "count" | "sum" | "avg" | undefined;
+        type?: "frame" | "text" | "image" | "list" | "metric" | "bar" | "line" | "pie" | "donut" | "gauge" | "funnel" | "radar" | "scatter" | "heatmap" | "pivot" | "table" | undefined;
+        aggregate?: "count" | "sum" | "avg" | "min" | "max" | undefined;
         title?: string | undefined;
         categoryField?: string | undefined;
         valueField?: string | undefined;

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

@@ -1 +1 @@
-{"version":3,"file":"dashboard.zod.d.ts","sourceRoot":"","sources":["../../src/ui/dashboard.zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;GAEG;AACH,eAAO,MAAM,SAAS,iFASpB,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,qBAAqB;IAChC,mBAAmB;;IAGnB,yBAAyB;;IAGzB,yBAAyB;;IAGzB,kDAAkD;;IAGlD,yCAAyC;;IAGzC,2BAA2B;;IAG3B,0BAA0B;;IAG1B;;;;;;OAMG;;;;;;;;;;;;;;;;;IAQH,qDAAqD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAErD,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,eAAe;IAC1B,mBAAmB;;IAGnB,oBAAoB;;IAGpB,kBAAkB;;IAGlB,4BAA4B;;QArD5B,mBAAmB;;QAGnB,yBAAyB;;QAGzB,yBAAyB;;QAGzB,kDAAkD;;QAGlD,yCAAyC;;QAGzC,2BAA2B;;QAG3B,0BAA0B;;QAG1B;;;;;;WAMG;;;;;;;;;;;;;;;;;QAQH,qDAAqD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoBrD,CAAC;AAEH,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;AAEpE;;GAEG;AACH,eAAO,MAAM,SAAS;8BACH,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,KAAG,SAAS;CACpD,CAAC"}
+{"version":3,"file":"dashboard.zod.d.ts","sourceRoot":"","sources":["../../src/ui/dashboard.zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;GAEG;AACH,eAAO,MAAM,SAAS,4JAoBpB,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,qBAAqB;IAChC,mBAAmB;;IAGnB,yBAAyB;;IAGzB,yBAAyB;;IAGzB,kDAAkD;;IAGlD,yCAAyC;;IAGzC,2BAA2B;;IAG3B,0BAA0B;;IAG1B;;;;;;OAMG;;;;;;;;;;;;;;;;;IAQH,qDAAqD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAErD,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,eAAe;IAC1B,mBAAmB;;IAGnB,oBAAoB;;IAGpB,kBAAkB;;IAGlB,4BAA4B;;QArD5B,mBAAmB;;QAGnB,yBAAyB;;QAGzB,yBAAyB;;QAGzB,kDAAkD;;QAGlD,yCAAyC;;QAGzC,2BAA2B;;QAG3B,0BAA0B;;QAG1B;;;;;;WAMG;;;;;;;;;;;;;;;;;QAQH,qDAAqD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoBrD,CAAC;AAEH,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;AAEpE;;GAEG;AACH,eAAO,MAAM,SAAS;8BACH,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,KAAG,SAAS;CACpD,CAAC"}

package/dist/ui/dashboard.zod.js

@@ -7,14 +7,24 @@ const filter_zod_1 = require("../data/filter.zod");
  * Chart Type Enum
  */
 exports.ChartType = zod_1.z.enum([
-    'metric', // Single big number
-    'bar', // Bar chart
-    'line', // Line chart
-    'pie', // Pie/Donut chart
-    'donut', // Donut chart
-    'funnel', // Funnel chart
-    'table', // Data table
-    'text' // Rich text / Markdown
+    // Analysis
+    'metric', // KPI / Big Number
+    'bar', // Bar / Column
+    'line', // Line / Area
+    'pie', // Pie
+    'donut', // Donut
+    'gauge', // Gauge / Speedometer
+    'funnel', // Conversion Funnel
+    'radar', // Spider / Radar
+    'scatter', // Scatter Plot
+    'heatmap', // Heatmap
+    'pivot', // Pivot Table (Cross-tab)
+    // Content
+    'table', // Data Grid
+    'list', // Simple List
+    'text', // Markdown / HTML
+    'image', // Static Image
+    'frame', // IFrame / Embed
 ]);
 /**
  * Dashboard Widget Schema

package/dist/ui/index.d.ts

@@ -13,5 +13,6 @@ export * from './report.zod';
 export * from './action.zod';
 export * from './page.zod';
 export * from './widget.zod';
+export * from './block.zod';
 export * from './theme.zod';
 //# sourceMappingURL=index.d.ts.map

package/dist/ui/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ui/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ui/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC"}

package/dist/ui/index.js

@@ -29,4 +29,5 @@ __exportStar(require("./report.zod"), exports);
 __exportStar(require("./action.zod"), exports);
 __exportStar(require("./page.zod"), exports);
 __exportStar(require("./widget.zod"), exports);
+__exportStar(require("./block.zod"), exports);
 __exportStar(require("./theme.zod"), exports);

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

@@ -8,7 +8,7 @@ export declare const PageRegionSchema: z.ZodObject<{
     width: z.ZodOptional<z.ZodEnum<["small", "medium", "large", "full"]>>;
     components: z.ZodArray<z.ZodLazy<z.ZodObject<{
         /** Definition */
-        type: z.ZodString;
+        type: z.ZodUnion<[z.ZodEnum<["page:header", "page:footer", "page:sidebar", "page:tabs", "page:accordion", "page:card", "page:section", "record:details", "record:highlights", "record:related_list", "record:activity", "record:chatter", "record:path", "app:launcher", "nav:menu", "nav:breadcrumb", "global:search", "global:notifications", "user:profile", "ai:chat_window", "ai:suggestion"]>, z.ZodString]>;
         id: z.ZodOptional<z.ZodString>;
         /** Configuration */
         label: z.ZodOptional<z.ZodString>;
@@ -49,13 +49,17 @@ export declare const PageRegionSchema: z.ZodObject<{
     }[];
     width?: "full" | "small" | "medium" | "large" | undefined;
 }>;
+/**
+ * Standard Page Component Types
+ */
+export declare const PageComponentType: z.ZodEnum<["page:header", "page:footer", "page:sidebar", "page:tabs", "page:accordion", "page:card", "page:section", "record:details", "record:highlights", "record:related_list", "record:activity", "record:chatter", "record:path", "app:launcher", "nav:menu", "nav:breadcrumb", "global:search", "global:notifications", "user:profile", "ai:chat_window", "ai:suggestion"]>;
 /**
  * Page Component Schema
  * A configured instance of a UI component.
  */
 export declare const PageComponentSchema: z.ZodObject<{
     /** Definition */
-    type: z.ZodString;
+    type: z.ZodUnion<[z.ZodEnum<["page:header", "page:footer", "page:sidebar", "page:tabs", "page:accordion", "page:card", "page:section", "record:details", "record:highlights", "record:related_list", "record:activity", "record:chatter", "record:path", "app:launcher", "nav:menu", "nav:breadcrumb", "global:search", "global:notifications", "user:profile", "ai:chat_window", "ai:suggestion"]>, z.ZodString]>;
     id: z.ZodOptional<z.ZodString>;
     /** Configuration */
     label: z.ZodOptional<z.ZodString>;
@@ -79,6 +83,20 @@ export declare const PageComponentSchema: z.ZodObject<{
  * Page Schema
  * Defines a composition of components for a specific context (Record, Home, App).
  * Compare to Salesforce FlexiPage.
+ *
+ * **NAMING CONVENTION:**
+ * Page names are used in routing and must be lowercase snake_case.
+ * Prefix with 'page_' is recommended for clarity.
+ *
+ * @example Good page names
+ * - 'page_dashboard'
+ * - 'page_settings'
+ * - 'home_page'
+ * - 'record_detail'
+ *
+ * @example Bad page names (will be rejected)
+ * - 'PageDashboard' (PascalCase)
+ * - 'Settings Page' (spaces)
  */
 export declare const PageSchema: z.ZodObject<{
     name: z.ZodString;
@@ -96,7 +114,7 @@ export declare const PageSchema: z.ZodObject<{
         width: z.ZodOptional<z.ZodEnum<["small", "medium", "large", "full"]>>;
         components: z.ZodArray<z.ZodLazy<z.ZodObject<{
             /** Definition */
-            type: z.ZodString;
+            type: z.ZodUnion<[z.ZodEnum<["page:header", "page:footer", "page:sidebar", "page:tabs", "page:accordion", "page:card", "page:section", "record:details", "record:highlights", "record:related_list", "record:activity", "record:chatter", "record:path", "app:launcher", "nav:menu", "nav:breadcrumb", "global:search", "global:notifications", "user:profile", "ai:chat_window", "ai:suggestion"]>, z.ZodString]>;
             id: z.ZodOptional<z.ZodString>;
             /** Configuration */
             label: z.ZodOptional<z.ZodString>;
@@ -144,8 +162,8 @@ export declare const PageSchema: z.ZodObject<{
     type: "record" | "home" | "app" | "utility";
     label: string;
     name: string;
-    template: string;
     isDefault: boolean;
+    template: string;
     regions: {
         name: string;
         components: {
@@ -177,8 +195,8 @@ export declare const PageSchema: z.ZodObject<{
     object?: string | undefined;
     type?: "record" | "home" | "app" | "utility" | undefined;
     description?: string | undefined;
-    template?: string | undefined;
     isDefault?: boolean | undefined;
+    template?: string | undefined;
     assignedProfiles?: string[] | undefined;
 }>;
 export type Page = z.infer<typeof PageSchema>;

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

@@ -1 +1 @@
-{"version":3,"file":"page.zod.d.ts","sourceRoot":"","sources":["../../src/ui/page.zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,eAAO,MAAM,gBAAgB;;;;QAW3B,iBAAiB;;;QAIjB,oBAAoB;;;QAIpB,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAftB,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,mBAAmB;IAC9B,iBAAiB;;;IAIjB,oBAAoB;;;IAIpB,sBAAsB;;;;;;;;;;;;;;EAEtB,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,UAAU;;;;IAKrB,gBAAgB;;IAGhB,cAAc;;IAGd,sBAAsB;;IAGtB,wBAAwB;;;;;YA/BxB,iBAAiB;;;YAIjB,oBAAoB;;;YAIpB,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA0BtB,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAGjB,CAAC;AAEH,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAC9C,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC"}
+{"version":3,"file":"page.zod.d.ts","sourceRoot":"","sources":["../../src/ui/page.zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;GAGG;AACH,eAAO,MAAM,gBAAgB;;;;QA2B3B,iBAAiB;;;QAOjB,oBAAoB;;;QAIpB,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAlCtB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,iBAAiB,mXAW5B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,mBAAmB;IAC9B,iBAAiB;;;IAOjB,oBAAoB;;;IAIpB,sBAAsB;;;;;;;;;;;;;;EAEtB,CAAC;AAEH;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,UAAU;;;;IAKrB,gBAAgB;;IAGhB,cAAc;;IAGd,sBAAsB;;IAGtB,wBAAwB;;;;;YAhDxB,iBAAiB;;;YAOjB,oBAAoB;;;YAIpB,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAwCtB,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAGjB,CAAC;AAEH,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAC9C,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC"}

package/dist/ui/page.zod.js

@@ -1,7 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PageSchema = exports.PageComponentSchema = exports.PageRegionSchema = void 0;
+exports.PageSchema = exports.PageComponentSchema = exports.PageComponentType = exports.PageRegionSchema = void 0;
 const zod_1 = require("zod");
+const identifiers_zod_1 = require("../shared/identifiers.zod");
 /**
  * Page Region Schema
  * A named region in the template where components are dropped.
@@ -11,17 +12,35 @@ exports.PageRegionSchema = zod_1.z.object({
     width: zod_1.z.enum(['small', 'medium', 'large', 'full']).optional(),
     components: zod_1.z.array(zod_1.z.lazy(() => exports.PageComponentSchema)).describe('Components in this region')
 });
+/**
+ * Standard Page Component Types
+ */
+exports.PageComponentType = zod_1.z.enum([
+    // Structure
+    'page:header', 'page:footer', 'page:sidebar', 'page:tabs', 'page:accordion', 'page:card', 'page:section',
+    // Record Context
+    'record:details', 'record:highlights', 'record:related_list', 'record:activity', 'record:chatter', 'record:path',
+    // Navigation
+    'app:launcher', 'nav:menu', 'nav:breadcrumb',
+    // Utility
+    'global:search', 'global:notifications', 'user:profile',
+    // AI
+    'ai:chat_window', 'ai:suggestion'
+]);
 /**
  * Page Component Schema
  * A configured instance of a UI component.
  */
 exports.PageComponentSchema = zod_1.z.object({
     /** Definition */
-    type: zod_1.z.string().describe('Component Type (e.g. "steedos-labs.related-list")'),
+    type: zod_1.z.union([
+        exports.PageComponentType,
+        zod_1.z.string()
+    ]).describe('Component Type (Standard enum or custom string)'),
     id: zod_1.z.string().optional().describe('Unique instance ID'),
     /** Configuration */
     label: zod_1.z.string().optional(),
-    properties: zod_1.z.record(zod_1.z.any()).describe('Component props passed to the widget'),
+    properties: zod_1.z.record(zod_1.z.any()).describe('Component props passed to the widget. See block.zod.ts for schemas.'),
     /** Visibility Rule */
     visibility: zod_1.z.string().optional().describe('Visibility filter/formula')
 });
@@ -29,9 +48,23 @@ exports.PageComponentSchema = zod_1.z.object({
  * Page Schema
  * Defines a composition of components for a specific context (Record, Home, App).
  * Compare to Salesforce FlexiPage.
+ *
+ * **NAMING CONVENTION:**
+ * Page names are used in routing and must be lowercase snake_case.
+ * Prefix with 'page_' is recommended for clarity.
+ *
+ * @example Good page names
+ * - 'page_dashboard'
+ * - 'page_settings'
+ * - 'home_page'
+ * - 'record_detail'
+ *
+ * @example Bad page names (will be rejected)
+ * - 'PageDashboard' (PascalCase)
+ * - 'Settings Page' (spaces)
  */
 exports.PageSchema = zod_1.z.object({
-    name: zod_1.z.string().regex(/^[a-z_][a-z0-9_]*$/),
+    name: identifiers_zod_1.SnakeCaseIdentifierSchema.describe('Page unique name (lowercase snake_case)'),
     label: zod_1.z.string(),
     description: zod_1.z.string().optional(),
     /** Page Type */

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

@@ -13,11 +13,11 @@ export declare const ReportColumnSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     field: string;
     label?: string | undefined;
-    aggregate?: "unique" | "min" | "max" | "count" | "sum" | "avg" | undefined;
+    aggregate?: "count" | "sum" | "avg" | "min" | "max" | "unique" | undefined;
 }, {
     field: string;
     label?: string | undefined;
-    aggregate?: "unique" | "min" | "max" | "count" | "sum" | "avg" | undefined;
+    aggregate?: "count" | "sum" | "avg" | "min" | "max" | "unique" | undefined;
 }>;
 /**
  * Report Grouping Schema
@@ -46,13 +46,13 @@ export declare const ReportChartSchema: z.ZodObject<{
     xAxis: z.ZodString;
     yAxis: z.ZodString;
 }, "strip", z.ZodTypeAny, {
-    type: "bar" | "line" | "pie" | "donut" | "funnel" | "column" | "scatter";
+    type: "bar" | "line" | "pie" | "donut" | "funnel" | "scatter" | "column";
     showLegend: boolean;
     xAxis: string;
     yAxis: string;
     title?: string | undefined;
 }, {
-    type: "bar" | "line" | "pie" | "donut" | "funnel" | "column" | "scatter";
+    type: "bar" | "line" | "pie" | "donut" | "funnel" | "scatter" | "column";
     xAxis: string;
     yAxis: string;
     title?: string | undefined;
@@ -78,11 +78,11 @@ export declare const ReportSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         field: string;
         label?: string | undefined;
-        aggregate?: "unique" | "min" | "max" | "count" | "sum" | "avg" | undefined;
+        aggregate?: "count" | "sum" | "avg" | "min" | "max" | "unique" | undefined;
     }, {
         field: string;
         label?: string | undefined;
-        aggregate?: "unique" | "min" | "max" | "count" | "sum" | "avg" | undefined;
+        aggregate?: "count" | "sum" | "avg" | "min" | "max" | "unique" | undefined;
     }>, "many">;
     /** Grouping (for Summary/Matrix) */
     groupingsDown: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -121,13 +121,13 @@ export declare const ReportSchema: z.ZodObject<{
         xAxis: z.ZodString;
         yAxis: z.ZodString;
     }, "strip", z.ZodTypeAny, {
-        type: "bar" | "line" | "pie" | "donut" | "funnel" | "column" | "scatter";
+        type: "bar" | "line" | "pie" | "donut" | "funnel" | "scatter" | "column";
         showLegend: boolean;
         xAxis: string;
         yAxis: string;
         title?: string | undefined;
     }, {
-        type: "bar" | "line" | "pie" | "donut" | "funnel" | "column" | "scatter";
+        type: "bar" | "line" | "pie" | "donut" | "funnel" | "scatter" | "column";
         xAxis: string;
         yAxis: string;
         title?: string | undefined;
@@ -141,7 +141,7 @@ export declare const ReportSchema: z.ZodObject<{
     columns: {
         field: string;
         label?: string | undefined;
-        aggregate?: "unique" | "min" | "max" | "count" | "sum" | "avg" | undefined;
+        aggregate?: "count" | "sum" | "avg" | "min" | "max" | "unique" | undefined;
     }[];
     filter?: import("../data/filter.zod").FilterCondition | undefined;
     description?: string | undefined;
@@ -156,7 +156,7 @@ export declare const ReportSchema: z.ZodObject<{
         dateGranularity?: "day" | "week" | "month" | "quarter" | "year" | undefined;
     }[] | undefined;
     chart?: {
-        type: "bar" | "line" | "pie" | "donut" | "funnel" | "column" | "scatter";
+        type: "bar" | "line" | "pie" | "donut" | "funnel" | "scatter" | "column";
         showLegend: boolean;
         xAxis: string;
         yAxis: string;
@@ -169,7 +169,7 @@ export declare const ReportSchema: z.ZodObject<{
     columns: {
         field: string;
         label?: string | undefined;
-        aggregate?: "unique" | "min" | "max" | "count" | "sum" | "avg" | undefined;
+        aggregate?: "count" | "sum" | "avg" | "min" | "max" | "unique" | undefined;
     }[];
     filter?: import("../data/filter.zod").FilterCondition | undefined;
     type?: "summary" | "tabular" | "matrix" | "joined" | undefined;
@@ -185,7 +185,7 @@ export declare const ReportSchema: z.ZodObject<{
         dateGranularity?: "day" | "week" | "month" | "quarter" | "year" | undefined;
     }[] | undefined;
     chart?: {
-        type: "bar" | "line" | "pie" | "donut" | "funnel" | "column" | "scatter";
+        type: "bar" | "line" | "pie" | "donut" | "funnel" | "scatter" | "column";
         xAxis: string;
         yAxis: string;
         title?: string | undefined;