Add @objectstack/spec and zod dependencies to Gantt, Map, and Timeline plugins; implement configuration validation

Author: hotlong

apps/console/test-spec-import.ts

@@ -0,0 +1,4 @@
+
+import * as UI from '@objectstack/spec/ui';
+console.log('UI Exports:', Object.keys(UI).sort());
+

packages/plugin-gantt/package.json

@@ -36,6 +36,7 @@
     "@object-ui/fields": "workspace:*",
     "@object-ui/react": "workspace:*",
     "@object-ui/types": "workspace:*",
+    "@objectstack/spec": "^0.9.2",
     "lucide-react": "^0.563.0"
   },
   "peerDependencies": {

packages/plugin-gantt/src/ObjectGantt.tsx

@@ -24,6 +24,7 @@
 
 import React, { useEffect, useState, useMemo } from 'react';
 import type { ObjectGridSchema, DataSource, ViewData, GanttConfig } from '@object-ui/types';
+import { GanttConfigSchema } from '@objectstack/spec/ui';
 import { GanttView, type GanttTask } from './GanttView';
 
 export interface ObjectGanttProps {
@@ -91,14 +92,23 @@ function convertSortToQueryParams(sort: string | any[] | undefined): Record<stri
  * Helper to get gantt configuration from schema
  */
 function getGanttConfig(schema: ObjectGridSchema): GanttConfig | null {
+  let config: GanttConfig | null = null;
   // Check if schema has gantt configuration
   if (schema.filter && typeof schema.filter === 'object' && 'gantt' in schema.filter) {
-    return (schema.filter as any).gantt as GanttConfig;
+    config = (schema.filter as any).gantt as GanttConfig;
   }
 
   // For backward compatibility, check if schema has gantt config at root
-  if ((schema as any).gantt) {
-    return (schema as any).gantt as GanttConfig;
+  else if ((schema as any).gantt) {
+    config = (schema as any).gantt as GanttConfig;
+  }
+
+  if (config) {
+    const result = GanttConfigSchema.safeParse(config);
+    if (!result.success) {
+      console.warn(`[ObjectGantt] Invalid gantt configuration:`, result.error.format());
+    }
+    return config;
   }
 
   return null;

packages/plugin-map/package.json

@@ -35,7 +35,9 @@
     "@object-ui/core": "workspace:*",
     "@object-ui/react": "workspace:*",
     "@object-ui/types": "workspace:*",
-    "lucide-react": "^0.563.0"
+    "@objectstack/spec": "^0.9.2",
+    "lucide-react": "^0.563.0",
+    "zod": "^4.3.6"
   },
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0",

packages/plugin-map/src/ObjectMap.tsx

@@ -26,6 +26,17 @@
 
 import React, { useEffect, useState, useMemo } from 'react';
 import type { ObjectGridSchema, DataSource, ViewData } from '@object-ui/types';
+import { z } from 'zod';
+
+const MapConfigSchema = z.object({
+  latitudeField: z.string().optional(),
+  longitudeField: z.string().optional(),
+  locationField: z.string().optional(),
+  titleField: z.string().optional(),
+  descriptionField: z.string().optional(),
+  zoom: z.number().optional(),
+  center: z.tuple([z.number(), z.number()]).optional(),
+});
 
 export interface ObjectMapProps {
   schema: ObjectGridSchema;
@@ -109,14 +120,23 @@ function convertSortToQueryParams(sort: string | any[] | undefined): Record<stri
  * Helper to get map configuration from schema
  */
 function getMapConfig(schema: ObjectGridSchema): MapConfig {
+  let config: MapConfig | null = null;
   // Check if schema has map configuration
   if (schema.filter && typeof schema.filter === 'object' && 'map' in schema.filter) {
-    return (schema.filter as any).map as MapConfig;
+    config = (schema.filter as any).map as MapConfig;
   }
 
   // For backward compatibility, check if schema has map config at root
-  if ((schema as any).map) {
-    return (schema as any).map as MapConfig;
+  else if ((schema as any).map) {
+    config = (schema as any).map as MapConfig;
+  }
+
+  if (config) {
+     const result = MapConfigSchema.safeParse(config);
+     if (!result.success) {
+       console.warn(`[ObjectMap] Invalid map configuration:`, result.error.format());
+     }
+     return config;
   }
 
   // Default configuration

packages/plugin-timeline/package.json

@@ -34,17 +34,19 @@
     "@object-ui/components": "workspace:*",
     "@object-ui/core": "workspace:*",
     "@object-ui/react": "workspace:*",
-    "@object-ui/types": "workspace:*"
+    "@object-ui/types": "workspace:*",
+    "@objectstack/spec": "^0.9.2",
+    "zod": "^4.3.6"
   },
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0",
     "react-dom": "^18.0.0 || ^19.0.0"
   },
   "devDependencies": {
+    "@object-ui/data-objectstack": "workspace:*",
     "@types/react": "^19.2.10",
     "@types/react-dom": "^19.2.3",
     "@vitejs/plugin-react": "^5.1.3",
-    "@object-ui/data-objectstack": "workspace:*",
     "typescript": "^5.9.3",
     "vite": "^7.3.1",
     "vite-plugin-dts": "^4.5.4"

packages/plugin-timeline/src/ObjectTimeline.tsx

@@ -9,8 +9,24 @@
 import React, { useEffect, useState } from 'react';
 import type { DataSource, TimelineSchema } from '@object-ui/types';
 import { useDataScope } from '@object-ui/react';
+import { z } from 'zod';
 import { TimelineRenderer } from './renderer';
 
+const TimelineMappingSchema = z.object({
+  title: z.string().optional(),
+  date: z.string().optional(),
+  description: z.string().optional(),
+  variant: z.string().optional(),
+});
+
+const TimelineExtensionSchema = z.object({
+   mapping: TimelineMappingSchema.optional(),
+   objectName: z.string().optional(),
+   titleField: z.string().optional(),
+   dateField: z.string().optional(),
+   descriptionField: z.string().optional(),
+});
+
 export interface ObjectTimelineProps {
   schema: TimelineSchema & {
     objectName?: string;
@@ -38,6 +54,13 @@ export const ObjectTimeline: React.FC<ObjectTimelineProps> = ({
   const [loading, setLoading] = useState(false);
   const [error, setError] = useState<Error | null>(null);
 
+  useEffect(() => {
+    const result = TimelineExtensionSchema.safeParse(schema);
+    if (!result.success) {
+      console.warn(`[ObjectTimeline] Invalid timeline configuration:`, result.error.format());
+    }
+  }, [schema]);
+
   const boundData = useDataScope(schema.bind);
 
   useEffect(() => {