@objectstack/spec 0.1.0 → 0.1.1

package/dist/ui/dashboard.zod.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+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'),
+});

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?: "small" | "medium" | "large" | "full" | undefined;
+}, {
+    name: string;
+    components: {
+        type: string;
+        properties: Record<string, any>;
+        label?: string | undefined;
+        id?: string | undefined;
+        visibility?: string | undefined;
+    }[];
+    width?: "small" | "medium" | "large" | "full" | 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?: "small" | "medium" | "large" | "full" | undefined;
+    }, {
+        name: string;
+        components: {
+            type: string;
+            properties: Record<string, any>;
+            label?: string | undefined;
+            id?: string | undefined;
+            visibility?: string | undefined;
+        }[];
+        width?: "small" | "medium" | "large" | "full" | 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?: "small" | "medium" | "large" | "full" | 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?: "small" | "medium" | "large" | "full" | 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()
+});

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

@@ -0,0 +1,224 @@
+import { z } from 'zod';
+/**
+ * Report Type Enum
+ */
+export declare const ReportType: z.ZodEnum<["tabular", "summary", "matrix", "joined"]>;
+/**
+ * Report Column Schema
+ */
+export declare const ReportColumnSchema: z.ZodObject<{
+    field: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    aggregate: z.ZodOptional<z.ZodEnum<["sum", "avg", "max", "min", "count", "unique"]>>;
+}, "strip", z.ZodTypeAny, {
+    field: string;
+    label?: string | undefined;
+    aggregate?: "unique" | "min" | "max" | "count" | "sum" | "avg" | undefined;
+}, {
+    field: string;
+    label?: string | undefined;
+    aggregate?: "unique" | "min" | "max" | "count" | "sum" | "avg" | undefined;
+}>;
+/**
+ * Report Grouping Schema
+ */
+export declare const ReportGroupingSchema: z.ZodObject<{
+    field: z.ZodString;
+    sortOrder: z.ZodDefault<z.ZodEnum<["asc", "desc"]>>;
+    dateGranularity: z.ZodOptional<z.ZodEnum<["day", "week", "month", "quarter", "year"]>>;
+}, "strip", z.ZodTypeAny, {
+    field: string;
+    sortOrder: "asc" | "desc";
+    dateGranularity?: "day" | "week" | "month" | "quarter" | "year" | undefined;
+}, {
+    field: string;
+    sortOrder?: "asc" | "desc" | undefined;
+    dateGranularity?: "day" | "week" | "month" | "quarter" | "year" | undefined;
+}>;
+/**
+ * Report Chart Schema
+ * Embedded visualization configuration.
+ */
+export declare const ReportChartSchema: z.ZodObject<{
+    type: z.ZodEnum<["bar", "column", "line", "pie", "donut", "scatter", "funnel"]>;
+    title: z.ZodOptional<z.ZodString>;
+    showLegend: z.ZodDefault<z.ZodBoolean>;
+    xAxis: z.ZodString;
+    yAxis: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "bar" | "line" | "pie" | "donut" | "funnel" | "column" | "scatter";
+    showLegend: boolean;
+    xAxis: string;
+    yAxis: string;
+    title?: string | undefined;
+}, {
+    type: "bar" | "line" | "pie" | "donut" | "funnel" | "column" | "scatter";
+    xAxis: string;
+    yAxis: string;
+    title?: string | undefined;
+    showLegend?: boolean | undefined;
+}>;
+/**
+ * Report Schema
+ * Deep data analysis definition.
+ */
+export declare const ReportSchema: z.ZodObject<{
+    /** Identity */
+    name: z.ZodString;
+    label: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    /** Data Source */
+    objectName: z.ZodString;
+    /** Report Configuration */
+    type: z.ZodDefault<z.ZodEnum<["tabular", "summary", "matrix", "joined"]>>;
+    columns: z.ZodArray<z.ZodObject<{
+        field: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        aggregate: z.ZodOptional<z.ZodEnum<["sum", "avg", "max", "min", "count", "unique"]>>;
+    }, "strip", z.ZodTypeAny, {
+        field: string;
+        label?: string | undefined;
+        aggregate?: "unique" | "min" | "max" | "count" | "sum" | "avg" | undefined;
+    }, {
+        field: string;
+        label?: string | undefined;
+        aggregate?: "unique" | "min" | "max" | "count" | "sum" | "avg" | undefined;
+    }>, "many">;
+    /** Grouping (for Summary/Matrix) */
+    groupingsDown: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        field: z.ZodString;
+        sortOrder: z.ZodDefault<z.ZodEnum<["asc", "desc"]>>;
+        dateGranularity: z.ZodOptional<z.ZodEnum<["day", "week", "month", "quarter", "year"]>>;
+    }, "strip", z.ZodTypeAny, {
+        field: string;
+        sortOrder: "asc" | "desc";
+        dateGranularity?: "day" | "week" | "month" | "quarter" | "year" | undefined;
+    }, {
+        field: string;
+        sortOrder?: "asc" | "desc" | undefined;
+        dateGranularity?: "day" | "week" | "month" | "quarter" | "year" | undefined;
+    }>, "many">>;
+    groupingsAcross: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        field: z.ZodString;
+        sortOrder: z.ZodDefault<z.ZodEnum<["asc", "desc"]>>;
+        dateGranularity: z.ZodOptional<z.ZodEnum<["day", "week", "month", "quarter", "year"]>>;
+    }, "strip", z.ZodTypeAny, {
+        field: string;
+        sortOrder: "asc" | "desc";
+        dateGranularity?: "day" | "week" | "month" | "quarter" | "year" | undefined;
+    }, {
+        field: string;
+        sortOrder?: "asc" | "desc" | undefined;
+        dateGranularity?: "day" | "week" | "month" | "quarter" | "year" | undefined;
+    }>, "many">>;
+    /** Filtering */
+    filter: z.ZodOptional<z.ZodString>;
+    filterItems: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodNumber;
+        field: z.ZodString;
+        operator: z.ZodString;
+        value: z.ZodAny;
+    }, "strip", z.ZodTypeAny, {
+        field: string;
+        id: number;
+        operator: string;
+        value?: any;
+    }, {
+        field: string;
+        id: number;
+        operator: string;
+        value?: any;
+    }>, "many">>;
+    /** Visualization */
+    chart: z.ZodOptional<z.ZodObject<{
+        type: z.ZodEnum<["bar", "column", "line", "pie", "donut", "scatter", "funnel"]>;
+        title: z.ZodOptional<z.ZodString>;
+        showLegend: z.ZodDefault<z.ZodBoolean>;
+        xAxis: z.ZodString;
+        yAxis: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "bar" | "line" | "pie" | "donut" | "funnel" | "column" | "scatter";
+        showLegend: boolean;
+        xAxis: string;
+        yAxis: string;
+        title?: string | undefined;
+    }, {
+        type: "bar" | "line" | "pie" | "donut" | "funnel" | "column" | "scatter";
+        xAxis: string;
+        yAxis: string;
+        title?: string | undefined;
+        showLegend?: boolean | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    type: "summary" | "tabular" | "matrix" | "joined";
+    label: string;
+    name: string;
+    objectName: string;
+    columns: {
+        field: string;
+        label?: string | undefined;
+        aggregate?: "unique" | "min" | "max" | "count" | "sum" | "avg" | undefined;
+    }[];
+    filter?: string | undefined;
+    description?: string | undefined;
+    groupingsDown?: {
+        field: string;
+        sortOrder: "asc" | "desc";
+        dateGranularity?: "day" | "week" | "month" | "quarter" | "year" | undefined;
+    }[] | undefined;
+    groupingsAcross?: {
+        field: string;
+        sortOrder: "asc" | "desc";
+        dateGranularity?: "day" | "week" | "month" | "quarter" | "year" | undefined;
+    }[] | undefined;
+    filterItems?: {
+        field: string;
+        id: number;
+        operator: string;
+        value?: any;
+    }[] | undefined;
+    chart?: {
+        type: "bar" | "line" | "pie" | "donut" | "funnel" | "column" | "scatter";
+        showLegend: boolean;
+        xAxis: string;
+        yAxis: string;
+        title?: string | undefined;
+    } | undefined;
+}, {
+    label: string;
+    name: string;
+    objectName: string;
+    columns: {
+        field: string;
+        label?: string | undefined;
+        aggregate?: "unique" | "min" | "max" | "count" | "sum" | "avg" | undefined;
+    }[];
+    filter?: string | undefined;
+    type?: "summary" | "tabular" | "matrix" | "joined" | undefined;
+    description?: string | undefined;
+    groupingsDown?: {
+        field: string;
+        sortOrder?: "asc" | "desc" | undefined;
+        dateGranularity?: "day" | "week" | "month" | "quarter" | "year" | undefined;
+    }[] | undefined;
+    groupingsAcross?: {
+        field: string;
+        sortOrder?: "asc" | "desc" | undefined;
+        dateGranularity?: "day" | "week" | "month" | "quarter" | "year" | undefined;
+    }[] | undefined;
+    filterItems?: {
+        field: string;
+        id: number;
+        operator: string;
+        value?: any;
+    }[] | undefined;
+    chart?: {
+        type: "bar" | "line" | "pie" | "donut" | "funnel" | "column" | "scatter";
+        xAxis: string;
+        yAxis: string;
+        title?: string | undefined;
+        showLegend?: boolean | undefined;
+    } | undefined;
+}>;
+export type Report = z.infer<typeof ReportSchema>;
+//# sourceMappingURL=report.zod.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"report.zod.d.ts","sourceRoot":"","sources":["../../src/ui/report.zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,UAAU,uDAKrB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;EAI7B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;EAI/B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;EAM5B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,YAAY;IACvB,eAAe;;;;IAKf,kBAAkB;;IAGlB,2BAA2B;;;;;;;;;;;;;;;IAK3B,oCAAoC;;;;;;;;;;;;;;;;;;;;;;;;;;;IAIpC,gBAAgB;;;;;;;;;;;;;;;;;;IAShB,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEpB,CAAC;AAEH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC"}

package/dist/ui/report.zod.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReportSchema = exports.ReportChartSchema = exports.ReportGroupingSchema = exports.ReportColumnSchema = exports.ReportType = void 0;
+const zod_1 = require("zod");
+/**
+ * Report Type Enum
+ */
+exports.ReportType = zod_1.z.enum([
+    'tabular', // Simple list
+    'summary', // Grouped by row
+    'matrix', // Grouped by row and column
+    'joined' // Joined multiple blocks
+]);
+/**
+ * Report Column Schema
+ */
+exports.ReportColumnSchema = zod_1.z.object({
+    field: zod_1.z.string().describe('Field name'),
+    label: zod_1.z.string().optional().describe('Override label'),
+    aggregate: zod_1.z.enum(['sum', 'avg', 'max', 'min', 'count', 'unique']).optional().describe('Aggregation function'),
+});
+/**
+ * Report Grouping Schema
+ */
+exports.ReportGroupingSchema = zod_1.z.object({
+    field: zod_1.z.string().describe('Field to group by'),
+    sortOrder: zod_1.z.enum(['asc', 'desc']).default('asc'),
+    dateGranularity: zod_1.z.enum(['day', 'week', 'month', 'quarter', 'year']).optional().describe('For date fields'),
+});
+/**
+ * Report Chart Schema
+ * Embedded visualization configuration.
+ */
+exports.ReportChartSchema = zod_1.z.object({
+    type: zod_1.z.enum(['bar', 'column', 'line', 'pie', 'donut', 'scatter', 'funnel']).describe('Chart type'),
+    title: zod_1.z.string().optional(),
+    showLegend: zod_1.z.boolean().default(true),
+    xAxis: zod_1.z.string().describe('Grouping field for X-Axis'),
+    yAxis: zod_1.z.string().describe('Summary field for Y-Axis'),
+});
+/**
+ * Report Schema
+ * Deep data analysis definition.
+ */
+exports.ReportSchema = zod_1.z.object({
+    /** Identity */
+    name: zod_1.z.string().regex(/^[a-z_][a-z0-9_]*$/).describe('Report unique name'),
+    label: zod_1.z.string().describe('Report label'),
+    description: zod_1.z.string().optional(),
+    /** Data Source */
+    objectName: zod_1.z.string().describe('Primary object'),
+    /** Report Configuration */
+    type: exports.ReportType.default('tabular').describe('Report format type'),
+    columns: zod_1.z.array(exports.ReportColumnSchema).describe('Columns to display'),
+    /** Grouping (for Summary/Matrix) */
+    groupingsDown: zod_1.z.array(exports.ReportGroupingSchema).optional().describe('Row groupings'),
+    groupingsAcross: zod_1.z.array(exports.ReportGroupingSchema).optional().describe('Column groupings (Matrix only)'),
+    /** Filtering */
+    filter: zod_1.z.string().optional().describe('Filter logic (e.g. "1 AND (2 OR 3)")'),
+    filterItems: zod_1.z.array(zod_1.z.object({
+        id: zod_1.z.number(),
+        field: zod_1.z.string(),
+        operator: zod_1.z.string(),
+        value: zod_1.z.any()
+    })).optional().describe('Filter criteria lines'),
+    /** Visualization */
+    chart: exports.ReportChartSchema.optional().describe('Embedded chart configuration'),
+});