Fix TypeScript build errors in CRM example

- Add phone field type helper to Field factory
- Update Field.select/multiselect to support both array and object signatures
- Add factory methods (Action.create, Dashboard.create, Report.create)
- Use z.input and parse for factory methods to support default values

Co-authored-by: huangyiirene <7665279+huangyiirene@users.noreply.github.com>

Author: Copilot

content/docs/references/ai/meta.json

@@ -1,3 +1,4 @@
 {
-  "title": "AI Protocol"
+  "title": "AI Protocol",
+  "root": true
 }

content/docs/references/data/meta.json

@@ -1,5 +1,6 @@
 {
   "title": "Data Protocol",
+  "root": true,
   "pages": [
     "core",
     "logic",

content/docs/references/meta.json

@@ -1,6 +1,5 @@
 {
   "label": "Protocol Reference",
-  "root": true,
   "order": 100,
   "pages": [
     "data",

content/docs/references/system/meta.json

@@ -1,5 +1,6 @@
 {
   "title": "System Protocol",
+  "root": true,
   "pages": [
     "identity",
     "integration",

content/docs/references/ui/meta.json

@@ -1,5 +1,6 @@
 {
   "title": "UI Protocol",
+  "root": true,
   "pages": [
     "app",
     "views",

packages/spec/src/data/field.zod.ts

@@ -111,6 +111,7 @@ export const Field = {
   percent: (config: FieldInput = {}) => ({ type: 'percent', ...config } as const),
   url: (config: FieldInput = {}) => ({ type: 'url', ...config } as const),
   email: (config: FieldInput = {}) => ({ type: 'email', ...config } as const),
+  phone: (config: FieldInput = {}) => ({ type: 'phone', ...config } as const),
   image: (config: FieldInput = {}) => ({ type: 'image', ...config } as const),
   file: (config: FieldInput = {}) => ({ type: 'file', ...config } as const),
   avatar: (config: FieldInput = {}) => ({ type: 'avatar', ...config } as const),
@@ -121,17 +122,43 @@ export const Field = {
   html: (config: FieldInput = {}) => ({ type: 'html', ...config } as const),
   password: (config: FieldInput = {}) => ({ type: 'password', ...config } as const),
 
-  select: (options: string[], config: FieldInput = {}) => ({ 
-    type: 'select', 
-    options: options.map(o => ({ label: o, value: o })), 
-    ...config 
-  } as const),
+  select: (optionsOrConfig: SelectOption[] | string[] | FieldInput & { options: SelectOption[] | string[] }, config?: FieldInput) => {
+    // Support both old and new signatures:
+    // Old: Field.select(['a', 'b'], { label: 'X' })
+    // New: Field.select({ options: [{label: 'A', value: 'a'}], label: 'X' })
+    let options: SelectOption[];
+    let finalConfig: FieldInput;
+    
+    if (Array.isArray(optionsOrConfig)) {
+      // Old signature: array as first param
+      options = optionsOrConfig.map(o => typeof o === 'string' ? { label: o, value: o } : o);
+      finalConfig = config || {};
+    } else {
+      // New signature: config object with options
+      options = (optionsOrConfig.options || []).map(o => typeof o === 'string' ? { label: o, value: o } : o);
+      finalConfig = optionsOrConfig;
+    }
+    
+    return { type: 'select', ...finalConfig, options } as const;
+  },
 
-  multiselect: (options: string[], config: FieldInput = {}) => ({ 
-    type: 'multiselect', 
-    options: options.map(o => ({ label: o, value: o })), 
-    ...config 
-  } as const),
+  multiselect: (optionsOrConfig: SelectOption[] | string[] | FieldInput & { options: SelectOption[] | string[] }, config?: FieldInput) => {
+    // Support both old and new signatures
+    let options: SelectOption[];
+    let finalConfig: FieldInput;
+    
+    if (Array.isArray(optionsOrConfig)) {
+      // Old signature: array as first param
+      options = optionsOrConfig.map(o => typeof o === 'string' ? { label: o, value: o } : o);
+      finalConfig = config || {};
+    } else {
+      // New signature: config object with options
+      options = (optionsOrConfig.options || []).map(o => typeof o === 'string' ? { label: o, value: o } : o);
+      finalConfig = optionsOrConfig;
+    }
+    
+    return { type: 'multiselect', ...finalConfig, options } as const;
+  },
 
   lookup: (reference: string, config: FieldInput = {}) => ({ 
     type: 'lookup', 

packages/spec/src/ui/action.zod.ts

@@ -56,3 +56,11 @@ export const ActionSchema = z.object({
 });
 
 export type Action = z.infer<typeof ActionSchema>;
+export type ActionParam = z.infer<typeof ActionParamSchema>;
+
+/**
+ * Action Factory Helper
+ */
+export const Action = {
+  create: (config: z.input<typeof ActionSchema>): Action => ActionSchema.parse(config),
+} as const;

packages/spec/src/ui/dashboard.zod.ts

@@ -78,3 +78,10 @@ export const DashboardSchema = z.object({
 
 export type Dashboard = z.infer<typeof DashboardSchema>;
 export type DashboardWidget = z.infer<typeof DashboardWidgetSchema>;
+
+/**
+ * Dashboard Factory Helper
+ */
+export const Dashboard = {
+  create: (config: z.input<typeof DashboardSchema>): Dashboard => DashboardSchema.parse(config),
+} as const;

packages/spec/src/ui/report.zod.ts

@@ -76,3 +76,13 @@ export const ReportSchema = z.object({
 });
 
 export type Report = z.infer<typeof ReportSchema>;
+export type ReportColumn = z.infer<typeof ReportColumnSchema>;
+export type ReportGrouping = z.infer<typeof ReportGroupingSchema>;
+export type ReportChart = z.infer<typeof ReportChartSchema>;
+
+/**
+ * Report Factory Helper
+ */
+export const Report = {
+  create: (config: z.input<typeof ReportSchema>): Report => ReportSchema.parse(config),
+} as const;