@objectstack/spec 0.3.3 → 0.4.1

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

@@ -6,7 +6,7 @@ import { z } from 'zod';
 export declare const ActionParamSchema: z.ZodObject<{
     name: z.ZodString;
     label: 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", "geolocation", "address", "code", "color", "rating", "slider", "signature", "qrcode"]>;
+    type: z.ZodEnum<["text", "textarea", "email", "url", "phone", "password", "markdown", "html", "richtext", "number", "currency", "percent", "date", "datetime", "time", "boolean", "toggle", "select", "multiselect", "radio", "checkboxes", "lookup", "master_detail", "tree", "image", "file", "avatar", "video", "audio", "formula", "summary", "autonumber", "location", "address", "code", "json", "color", "rating", "slider", "signature", "qrcode", "progress", "tags", "vector"]>;
     required: z.ZodDefault<z.ZodBoolean>;
     options: z.ZodOptional<z.ZodArray<z.ZodObject<{
         label: z.ZodString;
@@ -19,7 +19,7 @@ export declare const ActionParamSchema: z.ZodObject<{
         label: string;
     }>, "many">>;
 }, "strip", z.ZodTypeAny, {
-    type: "number" | "boolean" | "code" | "date" | "text" | "textarea" | "email" | "url" | "phone" | "password" | "markdown" | "html" | "richtext" | "currency" | "percent" | "datetime" | "time" | "select" | "lookup" | "master_detail" | "image" | "file" | "avatar" | "formula" | "summary" | "autonumber" | "location" | "geolocation" | "address" | "color" | "rating" | "slider" | "signature" | "qrcode";
+    type: "number" | "boolean" | "code" | "date" | "text" | "textarea" | "email" | "url" | "phone" | "password" | "markdown" | "html" | "richtext" | "currency" | "percent" | "datetime" | "time" | "toggle" | "select" | "multiselect" | "radio" | "checkboxes" | "lookup" | "master_detail" | "tree" | "image" | "file" | "avatar" | "video" | "audio" | "formula" | "summary" | "autonumber" | "location" | "address" | "json" | "color" | "rating" | "slider" | "signature" | "qrcode" | "progress" | "tags" | "vector";
     required: boolean;
     label: string;
     name: string;
@@ -28,7 +28,7 @@ export declare const ActionParamSchema: z.ZodObject<{
         label: string;
     }[] | undefined;
 }, {
-    type: "number" | "boolean" | "code" | "date" | "text" | "textarea" | "email" | "url" | "phone" | "password" | "markdown" | "html" | "richtext" | "currency" | "percent" | "datetime" | "time" | "select" | "lookup" | "master_detail" | "image" | "file" | "avatar" | "formula" | "summary" | "autonumber" | "location" | "geolocation" | "address" | "color" | "rating" | "slider" | "signature" | "qrcode";
+    type: "number" | "boolean" | "code" | "date" | "text" | "textarea" | "email" | "url" | "phone" | "password" | "markdown" | "html" | "richtext" | "currency" | "percent" | "datetime" | "time" | "toggle" | "select" | "multiselect" | "radio" | "checkboxes" | "lookup" | "master_detail" | "tree" | "image" | "file" | "avatar" | "video" | "audio" | "formula" | "summary" | "autonumber" | "location" | "address" | "json" | "color" | "rating" | "slider" | "signature" | "qrcode" | "progress" | "tags" | "vector";
     label: string;
     name: string;
     options?: {
@@ -39,6 +39,23 @@ export declare const ActionParamSchema: z.ZodObject<{
 }>;
 /**
  * Action Schema
+ *
+ * **NAMING CONVENTION:**
+ * Action names are machine identifiers used in code and must be lowercase snake_case.
+ *
+ * @example Good action names
+ * - 'on_close_deal'
+ * - 'send_welcome_email'
+ * - 'approve_contract'
+ * - 'export_report'
+ *
+ * @example Bad action names (will be rejected)
+ * - 'OnCloseDeal' (PascalCase)
+ * - 'sendEmail' (camelCase)
+ * - 'Send Email' (spaces)
+ *
+ * Note: The action name is the configuration ID. JavaScript function names can use camelCase,
+ * but the metadata ID must be lowercase snake_case.
  */
 export declare const ActionSchema: z.ZodObject<{
     /** Machine name of the action */
@@ -49,6 +66,12 @@ export declare const ActionSchema: z.ZodObject<{
     icon: z.ZodOptional<z.ZodString>;
     /** Where does this action appear? */
     locations: z.ZodOptional<z.ZodArray<z.ZodEnum<["list_toolbar", "list_item", "record_header", "record_more", "record_related", "global_nav"]>, "many">>;
+    /**
+     * Visual Component Type
+     * Defaults to 'button' or 'menu_item' based on location,
+     * but can be overridden.
+     */
+    component: z.ZodOptional<z.ZodEnum<["action:button", "action:icon", "action:menu", "action:group"]>>;
     /** Legacy location support */
     location: z.ZodOptional<z.ZodAny>;
     /** What type of interaction? */
@@ -60,7 +83,7 @@ export declare const ActionSchema: z.ZodObject<{
     params: z.ZodOptional<z.ZodArray<z.ZodObject<{
         name: z.ZodString;
         label: 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", "geolocation", "address", "code", "color", "rating", "slider", "signature", "qrcode"]>;
+        type: z.ZodEnum<["text", "textarea", "email", "url", "phone", "password", "markdown", "html", "richtext", "number", "currency", "percent", "date", "datetime", "time", "boolean", "toggle", "select", "multiselect", "radio", "checkboxes", "lookup", "master_detail", "tree", "image", "file", "avatar", "video", "audio", "formula", "summary", "autonumber", "location", "address", "code", "json", "color", "rating", "slider", "signature", "qrcode", "progress", "tags", "vector"]>;
         required: z.ZodDefault<z.ZodBoolean>;
         options: z.ZodOptional<z.ZodArray<z.ZodObject<{
             label: z.ZodString;
@@ -73,7 +96,7 @@ export declare const ActionSchema: z.ZodObject<{
             label: string;
         }>, "many">>;
     }, "strip", z.ZodTypeAny, {
-        type: "number" | "boolean" | "code" | "date" | "text" | "textarea" | "email" | "url" | "phone" | "password" | "markdown" | "html" | "richtext" | "currency" | "percent" | "datetime" | "time" | "select" | "lookup" | "master_detail" | "image" | "file" | "avatar" | "formula" | "summary" | "autonumber" | "location" | "geolocation" | "address" | "color" | "rating" | "slider" | "signature" | "qrcode";
+        type: "number" | "boolean" | "code" | "date" | "text" | "textarea" | "email" | "url" | "phone" | "password" | "markdown" | "html" | "richtext" | "currency" | "percent" | "datetime" | "time" | "toggle" | "select" | "multiselect" | "radio" | "checkboxes" | "lookup" | "master_detail" | "tree" | "image" | "file" | "avatar" | "video" | "audio" | "formula" | "summary" | "autonumber" | "location" | "address" | "json" | "color" | "rating" | "slider" | "signature" | "qrcode" | "progress" | "tags" | "vector";
         required: boolean;
         label: string;
         name: string;
@@ -82,7 +105,7 @@ export declare const ActionSchema: z.ZodObject<{
             label: string;
         }[] | undefined;
     }, {
-        type: "number" | "boolean" | "code" | "date" | "text" | "textarea" | "email" | "url" | "phone" | "password" | "markdown" | "html" | "richtext" | "currency" | "percent" | "datetime" | "time" | "select" | "lookup" | "master_detail" | "image" | "file" | "avatar" | "formula" | "summary" | "autonumber" | "location" | "geolocation" | "address" | "color" | "rating" | "slider" | "signature" | "qrcode";
+        type: "number" | "boolean" | "code" | "date" | "text" | "textarea" | "email" | "url" | "phone" | "password" | "markdown" | "html" | "richtext" | "currency" | "percent" | "datetime" | "time" | "toggle" | "select" | "multiselect" | "radio" | "checkboxes" | "lookup" | "master_detail" | "tree" | "image" | "file" | "avatar" | "video" | "audio" | "formula" | "summary" | "autonumber" | "location" | "address" | "json" | "color" | "rating" | "slider" | "signature" | "qrcode" | "progress" | "tags" | "vector";
         label: string;
         name: string;
         options?: {
@@ -103,7 +126,7 @@ export declare const ActionSchema: z.ZodObject<{
     name: string;
     refreshAfter: boolean;
     params?: {
-        type: "number" | "boolean" | "code" | "date" | "text" | "textarea" | "email" | "url" | "phone" | "password" | "markdown" | "html" | "richtext" | "currency" | "percent" | "datetime" | "time" | "select" | "lookup" | "master_detail" | "image" | "file" | "avatar" | "formula" | "summary" | "autonumber" | "location" | "geolocation" | "address" | "color" | "rating" | "slider" | "signature" | "qrcode";
+        type: "number" | "boolean" | "code" | "date" | "text" | "textarea" | "email" | "url" | "phone" | "password" | "markdown" | "html" | "richtext" | "currency" | "percent" | "datetime" | "time" | "toggle" | "select" | "multiselect" | "radio" | "checkboxes" | "lookup" | "master_detail" | "tree" | "image" | "file" | "avatar" | "video" | "audio" | "formula" | "summary" | "autonumber" | "location" | "address" | "json" | "color" | "rating" | "slider" | "signature" | "qrcode" | "progress" | "tags" | "vector";
         required: boolean;
         label: string;
         name: string;
@@ -114,17 +137,18 @@ export declare const ActionSchema: z.ZodObject<{
     }[] | undefined;
     location?: any;
     icon?: string | undefined;
-    execute?: string | undefined;
     visible?: string | undefined;
     target?: string | undefined;
     locations?: ("list_toolbar" | "list_item" | "record_header" | "record_more" | "record_related" | "global_nav")[] | undefined;
+    component?: "action:button" | "action:icon" | "action:menu" | "action:group" | undefined;
+    execute?: string | undefined;
     confirmText?: string | undefined;
     successMessage?: string | undefined;
 }, {
     label: string;
     name: string;
     params?: {
-        type: "number" | "boolean" | "code" | "date" | "text" | "textarea" | "email" | "url" | "phone" | "password" | "markdown" | "html" | "richtext" | "currency" | "percent" | "datetime" | "time" | "select" | "lookup" | "master_detail" | "image" | "file" | "avatar" | "formula" | "summary" | "autonumber" | "location" | "geolocation" | "address" | "color" | "rating" | "slider" | "signature" | "qrcode";
+        type: "number" | "boolean" | "code" | "date" | "text" | "textarea" | "email" | "url" | "phone" | "password" | "markdown" | "html" | "richtext" | "currency" | "percent" | "datetime" | "time" | "toggle" | "select" | "multiselect" | "radio" | "checkboxes" | "lookup" | "master_detail" | "tree" | "image" | "file" | "avatar" | "video" | "audio" | "formula" | "summary" | "autonumber" | "location" | "address" | "json" | "color" | "rating" | "slider" | "signature" | "qrcode" | "progress" | "tags" | "vector";
         label: string;
         name: string;
         options?: {
@@ -136,10 +160,11 @@ export declare const ActionSchema: z.ZodObject<{
     type?: "url" | "script" | "api" | "modal" | "flow" | undefined;
     location?: any;
     icon?: string | undefined;
-    execute?: string | undefined;
     visible?: string | undefined;
     target?: string | undefined;
     locations?: ("list_toolbar" | "list_item" | "record_header" | "record_more" | "record_related" | "global_nav")[] | undefined;
+    component?: "action:button" | "action:icon" | "action:menu" | "action:group" | undefined;
+    execute?: string | undefined;
     confirmText?: string | undefined;
     successMessage?: string | undefined;
     refreshAfter?: boolean | undefined;

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

@@ -1 +1 @@
-{"version":3,"file":"action.zod.d.ts","sourceRoot":"","sources":["../../src/ui/action.zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;GAGG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAM5B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,YAAY;IACvB,iCAAiC;;IAGjC,oBAAoB;;IAGpB,yBAAyB;;IAGzB,qCAAqC;;IAOrC,8BAA8B;;IAG9B,gCAAgC;;IAGhC,uBAAuB;;;IAIvB,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAG9B,kBAAkB;;;;IAKlB,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEb,CAAC;AAEH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAClD,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D;;GAEG;AACH,eAAO,MAAM,MAAM;8BACA,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,KAAG,MAAM;CAC9C,CAAC"}
+{"version":3,"file":"action.zod.d.ts","sourceRoot":"","sources":["../../src/ui/action.zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB;;;GAGG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAM5B,CAAC;AAEH;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,YAAY;IACvB,iCAAiC;;IAGjC,oBAAoB;;IAGpB,yBAAyB;;IAGzB,qCAAqC;;IAOrC;;;;OAIG;;IAQH,8BAA8B;;IAG9B,gCAAgC;;IAGhC,uBAAuB;;;IAIvB,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAG9B,kBAAkB;;;;IAKlB,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEb,CAAC;AAEH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAClD,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D;;GAEG;AACH,eAAO,MAAM,MAAM;8BACA,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,KAAG,MAAM;CAC9C,CAAC"}

package/dist/ui/action.zod.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Action = exports.ActionSchema = exports.ActionParamSchema = void 0;
 const zod_1 = require("zod");
 const field_zod_1 = require("../data/field.zod");
+const identifiers_zod_1 = require("../shared/identifiers.zod");
 /**
  * Action Parameter Schema
  * Defines inputs required before executing an action.
@@ -16,10 +17,27 @@ exports.ActionParamSchema = zod_1.z.object({
 });
 /**
  * Action Schema
+ *
+ * **NAMING CONVENTION:**
+ * Action names are machine identifiers used in code and must be lowercase snake_case.
+ *
+ * @example Good action names
+ * - 'on_close_deal'
+ * - 'send_welcome_email'
+ * - 'approve_contract'
+ * - 'export_report'
+ *
+ * @example Bad action names (will be rejected)
+ * - 'OnCloseDeal' (PascalCase)
+ * - 'sendEmail' (camelCase)
+ * - 'Send Email' (spaces)
+ *
+ * Note: The action name is the configuration ID. JavaScript function names can use camelCase,
+ * but the metadata ID must be lowercase snake_case.
  */
 exports.ActionSchema = zod_1.z.object({
     /** Machine name of the action */
-    name: zod_1.z.string().regex(/^[a-z_][a-z0-9_]*$/).describe('Machine name (snake_case)'),
+    name: identifiers_zod_1.SnakeCaseIdentifierSchema.describe('Machine name (lowercase snake_case)'),
     /** Display label */
     label: zod_1.z.string().describe('Display label'),
     /** Icon name (Lucide) */
@@ -30,6 +48,17 @@ exports.ActionSchema = zod_1.z.object({
         'record_header', 'record_more', 'record_related',
         'global_nav'
     ])).optional().describe('Locations where this action is visible'),
+    /**
+     * Visual Component Type
+     * Defaults to 'button' or 'menu_item' based on location,
+     * but can be overridden.
+     */
+    component: zod_1.z.enum([
+        'action:button', // Standard Button
+        'action:icon', // Icon only
+        'action:menu', // Dropdown menu
+        'action:group' // Button Group
+    ]).optional().describe('Visual component override'),
     /** Legacy location support */
     location: zod_1.z.any().optional(),
     /** What type of interaction? */

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

@@ -209,6 +209,21 @@ export declare const AppBrandingSchema: z.ZodObject<{
 /**
  * Schema for Applications (Apps).
  * A logical container for business functionality (e.g., "Sales CRM", "HR Portal").
+ *
+ * **NAMING CONVENTION:**
+ * App names are used in URLs and routing and must be lowercase snake_case.
+ * Prefix with 'app_' is recommended for clarity.
+ *
+ * @example Good app names
+ * - 'app_crm'
+ * - 'app_finance'
+ * - 'app_portal'
+ * - 'sales_app'
+ *
+ * @example Bad app names (will be rejected)
+ * - 'CRM' (uppercase)
+ * - 'FinanceApp' (mixed case)
+ * - 'Sales App' (spaces)
  */
 export declare const AppSchema: z.ZodObject<{
     /** Machine name (id) */
@@ -236,9 +251,9 @@ export declare const AppSchema: z.ZodObject<{
         favicon?: string | undefined;
     }>>;
     /** Application status */
-    active: z.ZodDefault<z.ZodBoolean>;
+    active: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     /** Is this the default app for new users? */
-    isDefault: z.ZodDefault<z.ZodBoolean>;
+    isDefault: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     /**
      * Navigation Tree Structure.
      * Replaces the old flat 'tabs' list with a structured menu.
@@ -270,8 +285,8 @@ export declare const AppSchema: z.ZodObject<{
     isDefault: boolean;
     description?: string | undefined;
     icon?: string | undefined;
-    version?: string | undefined;
     objects?: any[] | undefined;
+    version?: string | undefined;
     branding?: {
         primaryColor?: string | undefined;
         logo?: string | undefined;
@@ -287,8 +302,8 @@ export declare const AppSchema: z.ZodObject<{
     description?: string | undefined;
     active?: boolean | undefined;
     icon?: string | undefined;
-    version?: string | undefined;
     objects?: any[] | undefined;
+    version?: string | undefined;
     branding?: {
         primaryColor?: string | undefined;
         logo?: string | undefined;
@@ -326,9 +341,9 @@ export declare const App: z.ZodObject<{
         favicon?: string | undefined;
     }>>;
     /** Application status */
-    active: z.ZodDefault<z.ZodBoolean>;
+    active: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     /** Is this the default app for new users? */
-    isDefault: z.ZodDefault<z.ZodBoolean>;
+    isDefault: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     /**
      * Navigation Tree Structure.
      * Replaces the old flat 'tabs' list with a structured menu.
@@ -360,8 +375,8 @@ export declare const App: z.ZodObject<{
     isDefault: boolean;
     description?: string | undefined;
     icon?: string | undefined;
-    version?: string | undefined;
     objects?: any[] | undefined;
+    version?: string | undefined;
     branding?: {
         primaryColor?: string | undefined;
         logo?: string | undefined;
@@ -377,8 +392,8 @@ export declare const App: z.ZodObject<{
     description?: string | undefined;
     active?: boolean | undefined;
     icon?: string | undefined;
-    version?: string | undefined;
     objects?: any[] | undefined;
+    version?: string | undefined;
     branding?: {
         primaryColor?: string | undefined;
         logo?: string | undefined;

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

@@ -1 +1 @@
-{"version":3,"file":"app.zod.d.ts","sourceRoot":"","sources":["../../src/ui/app.zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAwBxB;;;GAGG;AACH,eAAO,MAAM,mBAAmB;IArB9B,qCAAqC;;IAGrC,oBAAoB;;IAGpB,yBAAyB;;IAGzB;;;;OAIG;;;;;;;;;;;;;;;;;;;;;;EAYH,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,sBAAsB;IA/BjC,qCAAqC;;IAGrC,oBAAoB;;IAGpB,yBAAyB;;IAGzB;;;;OAIG;;;;;;;;;;;;;;;;;;;EAqBH,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,iBAAiB;IAxC5B,qCAAqC;;IAGrC,oBAAoB;;IAGpB,yBAAyB;;IAGzB;;;;OAIG;;;;;;;;;;;;;;;;;;;;;;EA+BH,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,gBAAgB;IAlD3B,qCAAqC;;IAGrC,oBAAoB;;IAGpB,yBAAyB;;IAGzB;;;;OAIG;;;;;;;;;;;;;;;;;;;;;;EAyCH,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,kBAAkB;IA7D7B,qCAAqC;;IAGrC,oBAAoB;;IAGpB,yBAAyB;;IAGzB;;;;OAIG;;;;;;;;;;;;;;;;;;;EAoDH,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAU/C,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;EAI5B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,SAAS;IACpB,wBAAwB;;IAGxB,oBAAoB;;IAGpB,kBAAkB;;IAGlB,kBAAkB;;IAGlB,yBAAyB;;IAGzB,qCAAqC;;;;;;;;;;;;;;IAGrC,yBAAyB;;IAGzB,6CAA6C;;IAG7C;;;OAGG;;IAGH;;;;OAIG;;IAGH;;;;;OAKG;;IAGH;;;OAGG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAGH,CAAC;AAEH,eAAO,MAAM,GAAG;IArDd,wBAAwB;;IAGxB,oBAAoB;;IAGpB,kBAAkB;;IAGlB,kBAAkB;;IAGlB,yBAAyB;;IAGzB,qCAAqC;;;;;;;;;;;;;;IAGrC,yBAAyB;;IAGzB,6CAA6C;;IAG7C;;;OAGG;;IAGH;;;;OAIG;;IAGH;;;;;OAKG;;IAGH;;;OAGG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;aAMM,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,UAAU,CAAC;CACvD,CAAC;AAGH,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AAC5C,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAGlE,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,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,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,GAAG;IAAE,QAAQ,EAAE,cAAc,EAAE,CAAA;CAAE,CAAC"}
+{"version":3,"file":"app.zod.d.ts","sourceRoot":"","sources":["../../src/ui/app.zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAqCxB;;;GAGG;AACH,eAAO,MAAM,mBAAmB;IArB9B,qCAAqC;;IAGrC,oBAAoB;;IAGpB,yBAAyB;;IAGzB;;;;OAIG;;;;;;;;;;;;;;;;;;;;;;EAYH,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,sBAAsB;IA/BjC,qCAAqC;;IAGrC,oBAAoB;;IAGpB,yBAAyB;;IAGzB;;;;OAIG;;;;;;;;;;;;;;;;;;;EAqBH,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,iBAAiB;IAxC5B,qCAAqC;;IAGrC,oBAAoB;;IAGpB,yBAAyB;;IAGzB;;;;OAIG;;;;;;;;;;;;;;;;;;;;;;EA+BH,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,gBAAgB;IAlD3B,qCAAqC;;IAGrC,oBAAoB;;IAGpB,yBAAyB;;IAGzB;;;;OAIG;;;;;;;;;;;;;;;;;;;;;;EAyCH,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,kBAAkB;IA7D7B,qCAAqC;;IAGrC,oBAAoB;;IAGpB,yBAAyB;;IAGzB;;;;OAIG;;;;;;;;;;;;;;;;;;;EAoDH,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAU/C,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;EAI5B,CAAC;AAEH;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,SAAS;IACpB,wBAAwB;;IAGxB,oBAAoB;;IAGpB,kBAAkB;;IAGlB,kBAAkB;;IAGlB,yBAAyB;;IAGzB,qCAAqC;;;;;;;;;;;;;;IAGrC,yBAAyB;;IAGzB,6CAA6C;;IAG7C;;;OAGG;;IAGH;;;;OAIG;;IAGH;;;;;OAKG;;IAGH;;;OAGG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAGH,CAAC;AAEH,eAAO,MAAM,GAAG;IArDd,wBAAwB;;IAGxB,oBAAoB;;IAGpB,kBAAkB;;IAGlB,kBAAkB;;IAGlB,yBAAyB;;IAGzB,qCAAqC;;;;;;;;;;;;;;IAGrC,yBAAyB;;IAGzB,6CAA6C;;IAG7C;;;OAGG;;IAGH;;;;OAIG;;IAGH;;;;;OAKG;;IAGH;;;OAGG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;aAMM,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,UAAU,CAAC;CACvD,CAAC;AAGH,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AAC5C,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAGlE,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,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,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,GAAG;IAAE,QAAQ,EAAE,cAAc,EAAE,CAAA;CAAE,CAAC"}

package/dist/ui/app.zod.js

@@ -2,13 +2,26 @@
 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");
+const identifiers_zod_1 = require("../shared/identifiers.zod");
 /**
  * Base Navigation Item Schema
  * Shared properties for all navigation types.
+ *
+ * **NAMING CONVENTION:**
+ * Navigation item IDs are used in URLs and configuration and must be lowercase snake_case.
+ *
+ * @example Good IDs
+ * - 'menu_accounts'
+ * - 'page_dashboard'
+ * - 'nav_settings'
+ *
+ * @example Bad IDs (will be rejected)
+ * - 'MenuAccounts' (PascalCase)
+ * - 'Page Dashboard' (spaces)
  */
 const BaseNavItemSchema = zod_1.z.object({
     /** Unique identifier for the item */
-    id: zod_1.z.string().describe('Unique identifier for this navigation item'),
+    id: identifiers_zod_1.SnakeCaseIdentifierSchema.describe('Unique identifier for this navigation item (lowercase snake_case)'),
     /** Display label */
     label: zod_1.z.string().describe('Display proper label'),
     /** Icon name (Lucide) */
@@ -90,10 +103,25 @@ exports.AppBrandingSchema = zod_1.z.object({
 /**
  * Schema for Applications (Apps).
  * A logical container for business functionality (e.g., "Sales CRM", "HR Portal").
+ *
+ * **NAMING CONVENTION:**
+ * App names are used in URLs and routing and must be lowercase snake_case.
+ * Prefix with 'app_' is recommended for clarity.
+ *
+ * @example Good app names
+ * - 'app_crm'
+ * - 'app_finance'
+ * - 'app_portal'
+ * - 'sales_app'
+ *
+ * @example Bad app names (will be rejected)
+ * - 'CRM' (uppercase)
+ * - 'FinanceApp' (mixed case)
+ * - 'Sales App' (spaces)
  */
 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'),
+    name: identifiers_zod_1.SnakeCaseIdentifierSchema.describe('App unique machine name (lowercase snake_case)'),
     /** Display label */
     label: zod_1.z.string().describe('App display label'),
     /** App version */
@@ -105,9 +133,9 @@ exports.AppSchema = zod_1.z.object({
     /** 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'),
+    active: zod_1.z.boolean().optional().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'),
+    isDefault: zod_1.z.boolean().optional().default(false).describe('Is default app'),
     /**
      * Navigation Tree Structure.
      * Replaces the old flat 'tabs' list with a structured menu.

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

@@ -0,0 +1,265 @@
+import { z } from 'zod';
+/**
+ * ----------------------------------------------------------------------
+ * 1. Structure Components
+ * ----------------------------------------------------------------------
+ */
+export declare const PageHeaderProps: z.ZodObject<{
+    title: z.ZodString;
+    subtitle: z.ZodOptional<z.ZodString>;
+    icon: z.ZodOptional<z.ZodString>;
+    breadcrumb: z.ZodDefault<z.ZodBoolean>;
+    actions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    title: string;
+    breadcrumb: boolean;
+    icon?: string | undefined;
+    subtitle?: string | undefined;
+    actions?: string[] | undefined;
+}, {
+    title: string;
+    icon?: string | undefined;
+    subtitle?: string | undefined;
+    breadcrumb?: boolean | undefined;
+    actions?: string[] | undefined;
+}>;
+export declare const PageTabsProps: z.ZodObject<{
+    type: z.ZodDefault<z.ZodEnum<["line", "card", "pill"]>>;
+    position: z.ZodDefault<z.ZodEnum<["top", "left"]>>;
+    items: z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        icon: z.ZodOptional<z.ZodString>;
+        children: z.ZodArray<z.ZodAny, "many">;
+    }, "strip", z.ZodTypeAny, {
+        label: string;
+        children: any[];
+        icon?: string | undefined;
+    }, {
+        label: string;
+        children: any[];
+        icon?: string | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    type: "line" | "card" | "pill";
+    items: {
+        label: string;
+        children: any[];
+        icon?: string | undefined;
+    }[];
+    position: "left" | "top";
+}, {
+    items: {
+        label: string;
+        children: any[];
+        icon?: string | undefined;
+    }[];
+    type?: "line" | "card" | "pill" | undefined;
+    position?: "left" | "top" | undefined;
+}>;
+export declare const PageCardProps: z.ZodObject<{
+    title: z.ZodOptional<z.ZodString>;
+    bordered: z.ZodDefault<z.ZodBoolean>;
+    actions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    children: z.ZodArray<z.ZodAny, "many">;
+}, "strip", z.ZodTypeAny, {
+    children: any[];
+    bordered: boolean;
+    title?: string | undefined;
+    actions?: string[] | undefined;
+}, {
+    children: any[];
+    bordered?: boolean | undefined;
+    title?: string | undefined;
+    actions?: string[] | undefined;
+}>;
+/**
+ * ----------------------------------------------------------------------
+ * 2. Record Context Components
+ * ----------------------------------------------------------------------
+ */
+export declare const RecordDetailsProps: z.ZodObject<{
+    columns: z.ZodDefault<z.ZodEnum<["1", "2", "3", "4"]>>;
+    layout: z.ZodDefault<z.ZodEnum<["auto", "custom"]>>;
+    sections: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    columns: "1" | "2" | "3" | "4";
+    layout: "custom" | "auto";
+    sections?: string[] | undefined;
+}, {
+    columns?: "1" | "2" | "3" | "4" | undefined;
+    sections?: string[] | undefined;
+    layout?: "custom" | "auto" | undefined;
+}>;
+export declare const RecordRelatedListProps: z.ZodObject<{
+    objectName: z.ZodString;
+    relationshipField: z.ZodString;
+    columns: z.ZodArray<z.ZodString, "many">;
+    sort: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    objectName: string;
+    columns: string[];
+    relationshipField: string;
+    sort?: string | undefined;
+}, {
+    objectName: string;
+    columns: string[];
+    relationshipField: string;
+    sort?: string | undefined;
+    limit?: number | undefined;
+}>;
+export declare const RecordHighlightsProps: z.ZodObject<{
+    fields: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    fields: string[];
+}, {
+    fields: string[];
+}>;
+/**
+ * ----------------------------------------------------------------------
+ * Component Props Map
+ * Maps Component Type to its Property Schema
+ * ----------------------------------------------------------------------
+ */
+export declare const ComponentPropsMap: {
+    readonly 'page:header': z.ZodObject<{
+        title: z.ZodString;
+        subtitle: z.ZodOptional<z.ZodString>;
+        icon: z.ZodOptional<z.ZodString>;
+        breadcrumb: z.ZodDefault<z.ZodBoolean>;
+        actions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        title: string;
+        breadcrumb: boolean;
+        icon?: string | undefined;
+        subtitle?: string | undefined;
+        actions?: string[] | undefined;
+    }, {
+        title: string;
+        icon?: string | undefined;
+        subtitle?: string | undefined;
+        breadcrumb?: boolean | undefined;
+        actions?: string[] | undefined;
+    }>;
+    readonly 'page:tabs': z.ZodObject<{
+        type: z.ZodDefault<z.ZodEnum<["line", "card", "pill"]>>;
+        position: z.ZodDefault<z.ZodEnum<["top", "left"]>>;
+        items: z.ZodArray<z.ZodObject<{
+            label: z.ZodString;
+            icon: z.ZodOptional<z.ZodString>;
+            children: z.ZodArray<z.ZodAny, "many">;
+        }, "strip", z.ZodTypeAny, {
+            label: string;
+            children: any[];
+            icon?: string | undefined;
+        }, {
+            label: string;
+            children: any[];
+            icon?: string | undefined;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        type: "line" | "card" | "pill";
+        items: {
+            label: string;
+            children: any[];
+            icon?: string | undefined;
+        }[];
+        position: "left" | "top";
+    }, {
+        items: {
+            label: string;
+            children: any[];
+            icon?: string | undefined;
+        }[];
+        type?: "line" | "card" | "pill" | undefined;
+        position?: "left" | "top" | undefined;
+    }>;
+    readonly 'page:card': z.ZodObject<{
+        title: z.ZodOptional<z.ZodString>;
+        bordered: z.ZodDefault<z.ZodBoolean>;
+        actions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        children: z.ZodArray<z.ZodAny, "many">;
+    }, "strip", z.ZodTypeAny, {
+        children: any[];
+        bordered: boolean;
+        title?: string | undefined;
+        actions?: string[] | undefined;
+    }, {
+        children: any[];
+        bordered?: boolean | undefined;
+        title?: string | undefined;
+        actions?: string[] | undefined;
+    }>;
+    readonly 'page:footer': z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+    readonly 'page:sidebar': z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+    readonly 'page:accordion': z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+    readonly 'page:section': z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+    readonly 'record:details': z.ZodObject<{
+        columns: z.ZodDefault<z.ZodEnum<["1", "2", "3", "4"]>>;
+        layout: z.ZodDefault<z.ZodEnum<["auto", "custom"]>>;
+        sections: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        columns: "1" | "2" | "3" | "4";
+        layout: "custom" | "auto";
+        sections?: string[] | undefined;
+    }, {
+        columns?: "1" | "2" | "3" | "4" | undefined;
+        sections?: string[] | undefined;
+        layout?: "custom" | "auto" | undefined;
+    }>;
+    readonly 'record:related_list': z.ZodObject<{
+        objectName: z.ZodString;
+        relationshipField: z.ZodString;
+        columns: z.ZodArray<z.ZodString, "many">;
+        sort: z.ZodOptional<z.ZodString>;
+        limit: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        limit: number;
+        objectName: string;
+        columns: string[];
+        relationshipField: string;
+        sort?: string | undefined;
+    }, {
+        objectName: string;
+        columns: string[];
+        relationshipField: string;
+        sort?: string | undefined;
+        limit?: number | undefined;
+    }>;
+    readonly 'record:highlights': z.ZodObject<{
+        fields: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        fields: string[];
+    }, {
+        fields: string[];
+    }>;
+    readonly 'record:activity': z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+    readonly 'record:chatter': z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+    readonly 'record:path': z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+    readonly 'app:launcher': z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+    readonly 'nav:menu': z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+    readonly 'nav:breadcrumb': z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+    readonly 'global:search': z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+    readonly 'global:notifications': z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+    readonly 'user:profile': z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+    readonly 'ai:chat_window': z.ZodObject<{
+        mode: z.ZodDefault<z.ZodEnum<["float", "sidebar", "inline"]>>;
+    }, "strip", z.ZodTypeAny, {
+        mode: "float" | "inline" | "sidebar";
+    }, {
+        mode?: "float" | "inline" | "sidebar" | undefined;
+    }>;
+    readonly 'ai:suggestion': z.ZodObject<{
+        context: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        context?: string | undefined;
+    }, {
+        context?: string | undefined;
+    }>;
+};
+/**
+ * Type Helper to extract props from map
+ */
+export type ComponentProps<T extends keyof typeof ComponentPropsMap> = z.infer<typeof ComponentPropsMap[T]>;
+//# sourceMappingURL=block.zod.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"block.zod.d.ts","sourceRoot":"","sources":["../../src/ui/block.zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB;;;;GAIG;AAEH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;EAM1B,CAAC;AAEH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQxB,CAAC;AAEH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;EAKxB,CAAC;AAEH;;;;GAIG;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;EAK7B,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;EAMjC,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;EAEhC,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+BpB,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,MAAM,OAAO,iBAAiB,IAAI,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC"}