@objectstack/spec 0.1.0 → 0.1.2

package/dist/ui/app.zod.js

@@ -0,0 +1,138 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.App = exports.AppSchema = exports.AppBrandingSchema = exports.NavigationItemSchema = exports.GroupNavItemSchema = exports.UrlNavItemSchema = exports.PageNavItemSchema = exports.DashboardNavItemSchema = exports.ObjectNavItemSchema = void 0;
+const zod_1 = require("zod");
+/**
+ * Base Navigation Item Schema
+ * Shared properties for all navigation types.
+ */
+const BaseNavItemSchema = zod_1.z.object({
+    /** Unique identifier for the item */
+    id: zod_1.z.string().describe('Unique identifier for this navigation item'),
+    /** Display label */
+    label: zod_1.z.string().describe('Display proper label'),
+    /** Icon name (Lucide) */
+    icon: zod_1.z.string().optional().describe('Icon name'),
+    /**
+     * Visibility condition.
+     * Formula expression returning boolean.
+     * e.g. "user.is_admin || user.department == 'sales'"
+     */
+    visible: zod_1.z.string().optional().describe('Visibility formula condition'),
+});
+/**
+ * 1. Object Navigation Item
+ * Navigates to an object's list view.
+ */
+exports.ObjectNavItemSchema = BaseNavItemSchema.extend({
+    type: zod_1.z.literal('object'),
+    objectName: zod_1.z.string().describe('Target object name'),
+    viewName: zod_1.z.string().optional().describe('Default list view to open. Defaults to "all"'),
+});
+/**
+ * 2. Dashboard Navigation Item
+ * Navigates to a specific dashboard.
+ */
+exports.DashboardNavItemSchema = BaseNavItemSchema.extend({
+    type: zod_1.z.literal('dashboard'),
+    dashboardName: zod_1.z.string().describe('Target dashboard name'),
+});
+/**
+ * 3. Page Navigation Item
+ * Navigates to a custom UI page/component.
+ */
+exports.PageNavItemSchema = BaseNavItemSchema.extend({
+    type: zod_1.z.literal('page'),
+    pageName: zod_1.z.string().describe('Target custom page component name'),
+    params: zod_1.z.record(zod_1.z.any()).optional().describe('Parameters passed to the page context'),
+});
+/**
+ * 4. URL Navigation Item
+ * Navigates to an external or absolute URL.
+ */
+exports.UrlNavItemSchema = BaseNavItemSchema.extend({
+    type: zod_1.z.literal('url'),
+    url: zod_1.z.string().describe('Target external URL'),
+    target: zod_1.z.enum(['_self', '_blank']).default('_self').describe('Link target window'),
+});
+/**
+ * 5. Group Navigation Item
+ * A container for child navigation items (Sub-menu).
+ * Does not perform navigation itself.
+ */
+exports.GroupNavItemSchema = BaseNavItemSchema.extend({
+    type: zod_1.z.literal('group'),
+    expanded: zod_1.z.boolean().default(false).describe('Default expansion state in sidebar'),
+    // children property is added in the recursive definition below
+});
+/**
+ * Recursive Union of all navigation item types.
+ * Allows constructing a navigation tree.
+ */
+exports.NavigationItemSchema = zod_1.z.lazy(() => zod_1.z.union([
+    exports.ObjectNavItemSchema,
+    exports.DashboardNavItemSchema,
+    exports.PageNavItemSchema,
+    exports.UrlNavItemSchema,
+    exports.GroupNavItemSchema.extend({
+        children: zod_1.z.array(exports.NavigationItemSchema).describe('Child navigation items'),
+    })
+]));
+/**
+ * App Branding Configuration
+ * Allows configuring the look and feel of the specific app.
+ */
+exports.AppBrandingSchema = zod_1.z.object({
+    primaryColor: zod_1.z.string().optional().describe('Primary theme color hex code'),
+    logo: zod_1.z.string().optional().describe('Custom logo URL for this app'),
+    favicon: zod_1.z.string().optional().describe('Custom favicon URL for this app'),
+});
+/**
+ * Schema for Applications (Apps).
+ * A logical container for business functionality (e.g., "Sales CRM", "HR Portal").
+ */
+exports.AppSchema = zod_1.z.object({
+    /** Machine name (id) */
+    name: zod_1.z.string().regex(/^[a-z_][a-z0-9_]*$/).describe('App unique machine name'),
+    /** Display label */
+    label: zod_1.z.string().describe('App display label'),
+    /** App version */
+    version: zod_1.z.string().optional().describe('App version'),
+    /** Description */
+    description: zod_1.z.string().optional().describe('App description'),
+    /** Icon name (Lucide) */
+    icon: zod_1.z.string().optional().describe('App icon used in the App Launcher'),
+    /** Branding/Theming Configuration */
+    branding: exports.AppBrandingSchema.optional().describe('App-specific branding'),
+    /** Application status */
+    active: zod_1.z.boolean().default(true).describe('Whether the app is enabled'),
+    /** Is this the default app for new users? */
+    isDefault: zod_1.z.boolean().default(false).describe('Is default app'),
+    /**
+     * Navigation Tree Structure.
+     * Replaces the old flat 'tabs' list with a structured menu.
+     */
+    navigation: zod_1.z.array(exports.NavigationItemSchema).optional().describe('Structured navigation menu tree'),
+    /**
+     * App-level Home Page Override
+     * ID of the navigation item to act as the landing page.
+     * If not set, usually defaults to the first navigation item.
+     */
+    homePageId: zod_1.z.string().optional().describe('ID of the navigation item to serve as landing page'),
+    /**
+     * Access Control
+     * List of permissions required to access this app.
+     * Modern replacement for role/profile based assignment.
+     * Example: ["app.access.crm"]
+     */
+    requiredPermissions: zod_1.z.array(zod_1.z.string()).optional().describe('Permissions required to access this app'),
+    /**
+     * Package Components (For config file convenience)
+     * In a real monorepo these might be auto-discovered, but here we allow explicit registration.
+     */
+    objects: zod_1.z.array(zod_1.z.any()).optional().describe('Objects belonging to this app'),
+    apis: zod_1.z.array(zod_1.z.any()).optional().describe('Custom APIs belonging to this app'),
+});
+exports.App = Object.assign(exports.AppSchema, {
+    create: (config) => config,
+});

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

@@ -0,0 +1,213 @@
+import { z } from 'zod';
+/**
+ * Chart Type Enum
+ */
+export declare const ChartType: z.ZodEnum<["metric", "bar", "line", "pie", "donut", "funnel", "table", "text"]>;
+/**
+ * Dashboard Widget Schema
+ * A single component on the dashboard grid.
+ */
+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"]>>;
+    /** Data Source Object */
+    object: z.ZodOptional<z.ZodString>;
+    /** Data Filter (ObjectQL JSON) */
+    filter: z.ZodOptional<z.ZodAny>;
+    /** Category Field (X-Axis / Group By) */
+    categoryField: z.ZodOptional<z.ZodString>;
+    /** Value Field (Y-Axis) */
+    valueField: z.ZodOptional<z.ZodString>;
+    /** Aggregate operation */
+    aggregate: z.ZodDefault<z.ZodOptional<z.ZodEnum<["count", "sum", "avg", "min", "max"]>>>;
+    /**
+     * Layout Position (React-Grid-Layout style)
+     * x: column (0-11)
+     * y: row
+     * w: width (1-12)
+     * h: height
+     */
+    layout: z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        w: z.ZodNumber;
+        h: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    }, {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    }>;
+    /** 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";
+    layout: {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    };
+    object?: string | undefined;
+    filter?: any;
+    options?: any;
+    title?: string | undefined;
+    categoryField?: string | undefined;
+    valueField?: string | undefined;
+}, {
+    layout: {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    };
+    object?: string | undefined;
+    filter?: any;
+    options?: any;
+    type?: "text" | "metric" | "bar" | "line" | "pie" | "donut" | "funnel" | "table" | undefined;
+    aggregate?: "min" | "max" | "count" | "sum" | "avg" | undefined;
+    title?: string | undefined;
+    categoryField?: string | undefined;
+    valueField?: string | undefined;
+}>;
+/**
+ * Dashboard Schema
+ * Represents a page containing multiple visualizations.
+ */
+export declare const DashboardSchema: z.ZodObject<{
+    /** Machine name */
+    name: z.ZodString;
+    /** Display label */
+    label: z.ZodString;
+    /** Description */
+    description: z.ZodOptional<z.ZodString>;
+    /** Collection of widgets */
+    widgets: z.ZodArray<z.ZodObject<{
+        /** Widget Title */
+        title: z.ZodOptional<z.ZodString>;
+        /** Visualization Type */
+        type: z.ZodDefault<z.ZodEnum<["metric", "bar", "line", "pie", "donut", "funnel", "table", "text"]>>;
+        /** Data Source Object */
+        object: z.ZodOptional<z.ZodString>;
+        /** Data Filter (ObjectQL JSON) */
+        filter: z.ZodOptional<z.ZodAny>;
+        /** Category Field (X-Axis / Group By) */
+        categoryField: z.ZodOptional<z.ZodString>;
+        /** Value Field (Y-Axis) */
+        valueField: z.ZodOptional<z.ZodString>;
+        /** Aggregate operation */
+        aggregate: z.ZodDefault<z.ZodOptional<z.ZodEnum<["count", "sum", "avg", "min", "max"]>>>;
+        /**
+         * Layout Position (React-Grid-Layout style)
+         * x: column (0-11)
+         * y: row
+         * w: width (1-12)
+         * h: height
+         */
+        layout: z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            w: z.ZodNumber;
+            h: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            x: number;
+            y: number;
+            w: number;
+            h: number;
+        }, {
+            x: number;
+            y: number;
+            w: number;
+            h: number;
+        }>;
+        /** 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";
+        layout: {
+            x: number;
+            y: number;
+            w: number;
+            h: number;
+        };
+        object?: string | undefined;
+        filter?: any;
+        options?: any;
+        title?: string | undefined;
+        categoryField?: string | undefined;
+        valueField?: string | undefined;
+    }, {
+        layout: {
+            x: number;
+            y: number;
+            w: number;
+            h: number;
+        };
+        object?: string | undefined;
+        filter?: any;
+        options?: any;
+        type?: "text" | "metric" | "bar" | "line" | "pie" | "donut" | "funnel" | "table" | undefined;
+        aggregate?: "min" | "max" | "count" | "sum" | "avg" | undefined;
+        title?: string | undefined;
+        categoryField?: string | undefined;
+        valueField?: string | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    label: string;
+    name: string;
+    widgets: {
+        type: "text" | "metric" | "bar" | "line" | "pie" | "donut" | "funnel" | "table";
+        aggregate: "min" | "max" | "count" | "sum" | "avg";
+        layout: {
+            x: number;
+            y: number;
+            w: number;
+            h: number;
+        };
+        object?: string | undefined;
+        filter?: any;
+        options?: any;
+        title?: string | undefined;
+        categoryField?: string | undefined;
+        valueField?: string | undefined;
+    }[];
+    description?: string | undefined;
+}, {
+    label: string;
+    name: string;
+    widgets: {
+        layout: {
+            x: number;
+            y: number;
+            w: number;
+            h: number;
+        };
+        object?: string | undefined;
+        filter?: any;
+        options?: any;
+        type?: "text" | "metric" | "bar" | "line" | "pie" | "donut" | "funnel" | "table" | undefined;
+        aggregate?: "min" | "max" | "count" | "sum" | "avg" | undefined;
+        title?: string | undefined;
+        categoryField?: string | undefined;
+        valueField?: string | undefined;
+    }[];
+    description?: string | undefined;
+}>;
+export type Dashboard = z.infer<typeof DashboardSchema>;
+export type DashboardWidget = z.infer<typeof DashboardWidgetSchema>;
+/**
+ * Dashboard Factory Helper
+ */
+export declare const Dashboard: {
+    readonly create: (config: z.input<typeof DashboardSchema>) => Dashboard;
+};
+//# sourceMappingURL=dashboard.zod.d.ts.map

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

@@ -0,0 +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;AAExB;;GAEG;AACH,eAAO,MAAM,SAAS,iFASpB,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,qBAAqB;IAChC,mBAAmB;;IAGnB,yBAAyB;;IAGzB,yBAAyB;;IAGzB,kCAAkC;;IAGlC,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,kCAAkC;;QAGlC,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

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Dashboard = exports.DashboardSchema = exports.DashboardWidgetSchema = exports.ChartType = void 0;
+const zod_1 = require("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
+]);
+/**
+ * Dashboard Widget Schema
+ * A single component on the dashboard grid.
+ */
+exports.DashboardWidgetSchema = zod_1.z.object({
+    /** Widget Title */
+    title: zod_1.z.string().optional().describe('Widget title'),
+    /** Visualization Type */
+    type: exports.ChartType.default('metric').describe('Visualization type'),
+    /** Data Source Object */
+    object: zod_1.z.string().optional().describe('Data source object name'),
+    /** Data Filter (ObjectQL JSON) */
+    filter: zod_1.z.any().optional().describe('Data filter criteria'),
+    /** Category Field (X-Axis / Group By) */
+    categoryField: zod_1.z.string().optional().describe('Field for grouping (X-Axis)'),
+    /** Value Field (Y-Axis) */
+    valueField: zod_1.z.string().optional().describe('Field for values (Y-Axis)'),
+    /** Aggregate operation */
+    aggregate: zod_1.z.enum(['count', 'sum', 'avg', 'min', 'max']).optional().default('count').describe('Aggregate function'),
+    /**
+     * Layout Position (React-Grid-Layout style)
+     * x: column (0-11)
+     * y: row
+     * w: width (1-12)
+     * h: height
+     */
+    layout: zod_1.z.object({
+        x: zod_1.z.number(),
+        y: zod_1.z.number(),
+        w: zod_1.z.number(),
+        h: zod_1.z.number(),
+    }).describe('Grid layout position'),
+    /** Widget specific options (colors, legend, etc.) */
+    options: zod_1.z.any().optional().describe('Widget specific configuration'),
+});
+/**
+ * Dashboard Schema
+ * Represents a page containing multiple visualizations.
+ */
+exports.DashboardSchema = zod_1.z.object({
+    /** Machine name */
+    name: zod_1.z.string().regex(/^[a-z_][a-z0-9_]*$/).describe('Dashboard unique name'),
+    /** Display label */
+    label: zod_1.z.string().describe('Dashboard label'),
+    /** Description */
+    description: zod_1.z.string().optional().describe('Dashboard description'),
+    /** Collection of widgets */
+    widgets: zod_1.z.array(exports.DashboardWidgetSchema).describe('Widgets to display'),
+});
+/**
+ * Dashboard Factory Helper
+ */
+exports.Dashboard = {
+    create: (config) => exports.DashboardSchema.parse(config),
+};

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

@@ -0,0 +1,187 @@
+import { z } from 'zod';
+/**
+ * Page Region Schema
+ * A named region in the template where components are dropped.
+ */
+export declare const PageRegionSchema: z.ZodObject<{
+    name: z.ZodString;
+    width: z.ZodOptional<z.ZodEnum<["small", "medium", "large", "full"]>>;
+    components: z.ZodArray<z.ZodLazy<z.ZodObject<{
+        /** Definition */
+        type: z.ZodString;
+        id: z.ZodOptional<z.ZodString>;
+        /** Configuration */
+        label: z.ZodOptional<z.ZodString>;
+        properties: z.ZodRecord<z.ZodString, z.ZodAny>;
+        /** Visibility Rule */
+        visibility: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: string;
+        properties: Record<string, any>;
+        label?: string | undefined;
+        id?: string | undefined;
+        visibility?: string | undefined;
+    }, {
+        type: string;
+        properties: Record<string, any>;
+        label?: string | undefined;
+        id?: string | undefined;
+        visibility?: string | undefined;
+    }>>, "many">;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    components: {
+        type: string;
+        properties: Record<string, any>;
+        label?: string | undefined;
+        id?: string | undefined;
+        visibility?: string | undefined;
+    }[];
+    width?: "full" | "small" | "medium" | "large" | undefined;
+}, {
+    name: string;
+    components: {
+        type: string;
+        properties: Record<string, any>;
+        label?: string | undefined;
+        id?: string | undefined;
+        visibility?: string | undefined;
+    }[];
+    width?: "full" | "small" | "medium" | "large" | undefined;
+}>;
+/**
+ * Page Component Schema
+ * A configured instance of a UI component.
+ */
+export declare const PageComponentSchema: z.ZodObject<{
+    /** Definition */
+    type: z.ZodString;
+    id: z.ZodOptional<z.ZodString>;
+    /** Configuration */
+    label: z.ZodOptional<z.ZodString>;
+    properties: z.ZodRecord<z.ZodString, z.ZodAny>;
+    /** Visibility Rule */
+    visibility: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: string;
+    properties: Record<string, any>;
+    label?: string | undefined;
+    id?: string | undefined;
+    visibility?: string | undefined;
+}, {
+    type: string;
+    properties: Record<string, any>;
+    label?: string | undefined;
+    id?: string | undefined;
+    visibility?: string | undefined;
+}>;
+/**
+ * Page Schema
+ * Defines a composition of components for a specific context (Record, Home, App).
+ * Compare to Salesforce FlexiPage.
+ */
+export declare const PageSchema: z.ZodObject<{
+    name: z.ZodString;
+    label: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    /** Page Type */
+    type: z.ZodDefault<z.ZodEnum<["record", "home", "app", "utility"]>>;
+    /** Context */
+    object: z.ZodOptional<z.ZodString>;
+    /** Layout Template */
+    template: z.ZodDefault<z.ZodString>;
+    /** Regions & Content */
+    regions: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        width: z.ZodOptional<z.ZodEnum<["small", "medium", "large", "full"]>>;
+        components: z.ZodArray<z.ZodLazy<z.ZodObject<{
+            /** Definition */
+            type: z.ZodString;
+            id: z.ZodOptional<z.ZodString>;
+            /** Configuration */
+            label: z.ZodOptional<z.ZodString>;
+            properties: z.ZodRecord<z.ZodString, z.ZodAny>;
+            /** Visibility Rule */
+            visibility: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            type: string;
+            properties: Record<string, any>;
+            label?: string | undefined;
+            id?: string | undefined;
+            visibility?: string | undefined;
+        }, {
+            type: string;
+            properties: Record<string, any>;
+            label?: string | undefined;
+            id?: string | undefined;
+            visibility?: string | undefined;
+        }>>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        components: {
+            type: string;
+            properties: Record<string, any>;
+            label?: string | undefined;
+            id?: string | undefined;
+            visibility?: string | undefined;
+        }[];
+        width?: "full" | "small" | "medium" | "large" | undefined;
+    }, {
+        name: string;
+        components: {
+            type: string;
+            properties: Record<string, any>;
+            label?: string | undefined;
+            id?: string | undefined;
+            visibility?: string | undefined;
+        }[];
+        width?: "full" | "small" | "medium" | "large" | undefined;
+    }>, "many">;
+    /** Activation */
+    isDefault: z.ZodDefault<z.ZodBoolean>;
+    assignedProfiles: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    type: "record" | "home" | "app" | "utility";
+    label: string;
+    name: string;
+    template: string;
+    isDefault: boolean;
+    regions: {
+        name: string;
+        components: {
+            type: string;
+            properties: Record<string, any>;
+            label?: string | undefined;
+            id?: string | undefined;
+            visibility?: string | undefined;
+        }[];
+        width?: "full" | "small" | "medium" | "large" | undefined;
+    }[];
+    object?: string | undefined;
+    description?: string | undefined;
+    assignedProfiles?: string[] | undefined;
+}, {
+    label: string;
+    name: string;
+    regions: {
+        name: string;
+        components: {
+            type: string;
+            properties: Record<string, any>;
+            label?: string | undefined;
+            id?: string | undefined;
+            visibility?: string | undefined;
+        }[];
+        width?: "full" | "small" | "medium" | "large" | undefined;
+    }[];
+    object?: string | undefined;
+    type?: "record" | "home" | "app" | "utility" | undefined;
+    description?: string | undefined;
+    template?: string | undefined;
+    isDefault?: boolean | undefined;
+    assignedProfiles?: string[] | undefined;
+}>;
+export type Page = z.infer<typeof PageSchema>;
+export type PageComponent = z.infer<typeof PageComponentSchema>;
+export type PageRegion = z.infer<typeof PageRegionSchema>;
+//# sourceMappingURL=page.zod.d.ts.map

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

@@ -0,0 +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"}

package/dist/ui/page.zod.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PageSchema = exports.PageComponentSchema = exports.PageRegionSchema = void 0;
+const zod_1 = require("zod");
+/**
+ * Page Region Schema
+ * A named region in the template where components are dropped.
+ */
+exports.PageRegionSchema = zod_1.z.object({
+    name: zod_1.z.string().describe('Region name (e.g. "sidebar", "main", "header")'),
+    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')
+});
+/**
+ * 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")'),
+    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'),
+    /** Visibility Rule */
+    visibility: zod_1.z.string().optional().describe('Visibility filter/formula')
+});
+/**
+ * Page Schema
+ * Defines a composition of components for a specific context (Record, Home, App).
+ * Compare to Salesforce FlexiPage.
+ */
+exports.PageSchema = zod_1.z.object({
+    name: zod_1.z.string().regex(/^[a-z_][a-z0-9_]*$/),
+    label: zod_1.z.string(),
+    description: zod_1.z.string().optional(),
+    /** Page Type */
+    type: zod_1.z.enum(['record', 'home', 'app', 'utility']).default('record'),
+    /** Context */
+    object: zod_1.z.string().optional().describe('Bound object (for Record pages)'),
+    /** Layout Template */
+    template: zod_1.z.string().default('default').describe('Layout template name (e.g. "header-sidebar-main")'),
+    /** Regions & Content */
+    regions: zod_1.z.array(exports.PageRegionSchema).describe('Defined regions with components'),
+    /** Activation */
+    isDefault: zod_1.z.boolean().default(false),
+    assignedProfiles: zod_1.z.array(zod_1.z.string()).optional()
+});