@objectstack/spec 3.0.1 → 3.0.3

package/dist/index.js

@@ -4132,6 +4132,7 @@ var PolicySchema = zod.z.object({
 // src/ui/index.ts
 var ui_exports = {};
 __export(ui_exports, {
+  AIChatWindowProps: () => AIChatWindowProps,
   Action: () => Action,
   ActionParamSchema: () => ActionParamSchema,
   ActionSchema: () => ActionSchema,
@@ -4211,6 +4212,7 @@ __export(ui_exports, {
   OfflineCacheConfigSchema: () => OfflineCacheConfigSchema,
   OfflineConfigSchema: () => OfflineConfigSchema,
   OfflineStrategySchema: () => OfflineStrategySchema,
+  PageAccordionProps: () => PageAccordionProps,
   PageCardProps: () => PageCardProps,
   PageComponentSchema: () => PageComponentSchema,
   PageComponentType: () => PageComponentType,
@@ -4226,8 +4228,10 @@ __export(ui_exports, {
   PersistStorageSchema: () => PersistStorageSchema,
   PinchGestureConfigSchema: () => PinchGestureConfigSchema,
   PluralRuleSchema: () => PluralRuleSchema,
+  RecordActivityProps: () => RecordActivityProps,
   RecordDetailsProps: () => RecordDetailsProps,
   RecordHighlightsProps: () => RecordHighlightsProps,
+  RecordPathProps: () => RecordPathProps,
   RecordRelatedListProps: () => RecordRelatedListProps,
   Report: () => Report,
   ReportChartSchema: () => ReportChartSchema,
@@ -5501,20 +5505,71 @@ var PageCardProps = zod.z.object({
   aria: AriaPropsSchema.optional().describe("ARIA accessibility attributes")
 });
 var RecordDetailsProps = zod.z.object({
-  columns: zod.z.enum(["1", "2", "3", "4"]).default("2"),
-  layout: zod.z.enum(["auto", "custom"]).default("auto"),
-  // If custom layout
-  sections: zod.z.array(zod.z.string()).optional().describe("Section IDs to show")
+  columns: zod.z.enum(["1", "2", "3", "4"]).default("2").describe("Number of columns for field layout (1-4)"),
+  layout: zod.z.enum(["auto", "custom"]).default("auto").describe("Layout mode: auto uses object compactLayout, custom uses explicit sections"),
+  sections: zod.z.array(zod.z.string()).optional().describe('Section IDs to show (required when layout is "custom")'),
+  fields: zod.z.array(zod.z.string()).optional().describe("Explicit field list to display (optional, overrides compactLayout)"),
+  /** ARIA accessibility */
+  aria: AriaPropsSchema.optional().describe("ARIA accessibility attributes")
 });
 var RecordRelatedListProps = zod.z.object({
-  objectName: zod.z.string().describe("Related object name"),
-  relationshipField: zod.z.string().describe("Field on related object that points to this record"),
-  columns: zod.z.array(zod.z.string()).describe("Fields to display"),
-  sort: zod.z.string().optional(),
-  limit: zod.z.number().default(5)
+  objectName: zod.z.string().describe('Related object name (e.g., "task", "opportunity")'),
+  relationshipField: zod.z.string().describe('Field on related object that points to this record (e.g., "account_id")'),
+  columns: zod.z.array(zod.z.string()).describe("Fields to display in the related list"),
+  sort: zod.z.union([
+    zod.z.string(),
+    zod.z.array(zod.z.object({
+      field: zod.z.string(),
+      order: zod.z.enum(["asc", "desc"])
+    }))
+  ]).optional().describe("Sort order for related records"),
+  limit: zod.z.number().int().positive().default(5).describe("Number of records to display initially"),
+  filter: zod.z.array(zod.z.unknown()).optional().describe("Additional filter criteria for related records"),
+  title: I18nLabelSchema.optional().describe("Custom title for the related list"),
+  showViewAll: zod.z.boolean().default(true).describe('Show "View All" link to see all related records'),
+  actions: zod.z.array(zod.z.string()).optional().describe("Action IDs available for related records"),
+  /** ARIA accessibility */
+  aria: AriaPropsSchema.optional().describe("ARIA accessibility attributes")
 });
 var RecordHighlightsProps = zod.z.object({
-  fields: zod.z.array(zod.z.string()).min(1).max(7).describe("Key fields to highlights (max 7)")
+  fields: zod.z.array(zod.z.string()).min(1).max(7).describe("Key fields to highlight (1-7 fields max, typically displayed as prominent cards)"),
+  layout: zod.z.enum(["horizontal", "vertical"]).default("horizontal").describe("Layout orientation for highlight fields"),
+  /** ARIA accessibility */
+  aria: AriaPropsSchema.optional().describe("ARIA accessibility attributes")
+});
+var RecordActivityProps = zod.z.object({
+  types: zod.z.array(zod.z.enum(["task", "event", "email", "call", "note"])).optional().describe("Activity types to display"),
+  limit: zod.z.number().int().positive().default(10).describe("Number of activities to show"),
+  showCompleted: zod.z.boolean().default(false).describe("Include completed activities"),
+  /** ARIA accessibility */
+  aria: AriaPropsSchema.optional().describe("ARIA accessibility attributes")
+});
+var RecordPathProps = zod.z.object({
+  statusField: zod.z.string().describe("Field name representing the current status/stage"),
+  stages: zod.z.array(zod.z.object({
+    value: zod.z.string(),
+    label: I18nLabelSchema
+  })).optional().describe("Explicit stage definitions (if not using field metadata)"),
+  /** ARIA accessibility */
+  aria: AriaPropsSchema.optional().describe("ARIA accessibility attributes")
+});
+var PageAccordionProps = zod.z.object({
+  items: zod.z.array(zod.z.object({
+    label: I18nLabelSchema,
+    icon: zod.z.string().optional(),
+    collapsed: zod.z.boolean().default(false),
+    children: zod.z.array(zod.z.unknown()).describe("Child components")
+  })),
+  allowMultiple: zod.z.boolean().default(false).describe("Allow multiple panels to be expanded simultaneously"),
+  /** ARIA accessibility */
+  aria: AriaPropsSchema.optional().describe("ARIA accessibility attributes")
+});
+var AIChatWindowProps = zod.z.object({
+  mode: zod.z.enum(["float", "sidebar", "inline"]).default("float").describe("Display mode for the chat window"),
+  agentId: zod.z.string().optional().describe("Specific AI agent to use"),
+  context: zod.z.record(zod.z.string(), zod.z.unknown()).optional().describe("Contextual data to pass to the AI"),
+  /** ARIA accessibility */
+  aria: AriaPropsSchema.optional().describe("ARIA accessibility attributes")
 });
 var ComponentPropsMap = {
   // Structure
@@ -5523,15 +5578,15 @@ var ComponentPropsMap = {
   "page:card": PageCardProps,
   "page:footer": EmptyProps,
   "page:sidebar": EmptyProps,
-  "page:accordion": EmptyProps,
+  "page:accordion": PageAccordionProps,
   "page:section": EmptyProps,
   // Record
   "record:details": RecordDetailsProps,
   "record:related_list": RecordRelatedListProps,
   "record:highlights": RecordHighlightsProps,
-  "record:activity": EmptyProps,
+  "record:activity": RecordActivityProps,
   "record:chatter": EmptyProps,
-  "record:path": EmptyProps,
+  "record:path": RecordPathProps,
   // Navigation
   "app:launcher": EmptyProps,
   "nav:menu": EmptyProps,
@@ -5541,7 +5596,7 @@ var ComponentPropsMap = {
   "global:notifications": EmptyProps,
   "user:profile": EmptyProps,
   // AI
-  "ai:chat_window": zod.z.object({ mode: zod.z.enum(["float", "sidebar", "inline"]).default("float") }),
+  "ai:chat_window": AIChatWindowProps,
   "ai:suggestion": zod.z.object({ context: zod.z.string().optional() })
 };
 var TouchTargetConfigSchema = zod.z.object({
@@ -6056,6 +6111,7 @@ __export(system_exports, {
   FailoverModeSchema: () => FailoverModeSchema,
   FeatureSchema: () => FeatureSchema,
   FieldEncryptionSchema: () => FieldEncryptionSchema,
+  FieldTranslationSchema: () => FieldTranslationSchema,
   FileDestinationConfigSchema: () => FileDestinationConfigSchema,
   FileMetadataSchema: () => FileMetadataSchema,
   GCounterSchema: () => GCounterSchema,
@@ -6138,6 +6194,7 @@ __export(system_exports, {
   OTTransformResultSchema: () => OTTransformResultSchema,
   ObjectMetadataSchema: () => ObjectMetadataSchema,
   ObjectStorageConfigSchema: () => ObjectStorageConfigSchema,
+  ObjectTranslationDataSchema: () => ObjectTranslationDataSchema,
   OnceScheduleSchema: () => OnceScheduleSchema,
   OpenTelemetryCompatibilitySchema: () => OpenTelemetryCompatibilitySchema,
   OtelExporterType: () => OtelExporterType,
@@ -6218,7 +6275,9 @@ __export(system_exports, {
   TraceStateSchema: () => TraceStateSchema,
   TracingConfigSchema: () => TracingConfigSchema,
   TranslationBundleSchema: () => TranslationBundleSchema,
+  TranslationConfigSchema: () => TranslationConfigSchema,
   TranslationDataSchema: () => TranslationDataSchema,
+  TranslationFileOrganizationSchema: () => TranslationFileOrganizationSchema,
   UserActivityStatus: () => UserActivityStatus,
   VectorClockSchema: () => VectorClockSchema,
   WorkerConfig: () => WorkerConfig,
@@ -10318,17 +10377,23 @@ var NotificationConfigSchema2 = zod.z.object({
     trackDelivery: zod.z.boolean().optional().default(true).describe("Track delivery")
   }).optional().describe("Tracking configuration")
 });
+var LocaleSchema = zod.z.string().describe("BCP-47 Language Tag (e.g. en-US, zh-CN)");
+var FieldTranslationSchema = zod.z.object({
+  label: zod.z.string().optional().describe("Translated field label"),
+  help: zod.z.string().optional().describe("Translated help text"),
+  options: zod.z.record(zod.z.string(), zod.z.string()).optional().describe("Option value to translated label map")
+}).describe("Translation data for a single field");
+var ObjectTranslationDataSchema = zod.z.object({
+  /** Translated singular label for the object */
+  label: zod.z.string().describe("Translated singular label"),
+  /** Translated plural label for the object */
+  pluralLabel: zod.z.string().optional().describe("Translated plural label"),
+  /** Field-level translations keyed by field name (snake_case) */
+  fields: zod.z.record(zod.z.string(), FieldTranslationSchema).optional().describe("Field-level translations")
+}).describe("Translation data for a single object");
 var TranslationDataSchema = zod.z.object({
   /** Object translations */
-  objects: zod.z.record(zod.z.string(), zod.z.object({
-    label: zod.z.string().describe("Translated singular label"),
-    pluralLabel: zod.z.string().optional().describe("Translated plural label"),
-    fields: zod.z.record(zod.z.string(), zod.z.object({
-      label: zod.z.string().optional().describe("Translated field label"),
-      help: zod.z.string().optional().describe("Translated help text"),
-      options: zod.z.record(zod.z.string(), zod.z.string()).optional().describe("Option value to translated label map")
-    })).optional().describe("Field-level translations")
-  })).optional().describe("Object translations keyed by object name"),
+  objects: zod.z.record(zod.z.string(), ObjectTranslationDataSchema).optional().describe("Object translations keyed by object name"),
   /** App/Menu translations */
   apps: zod.z.record(zod.z.string(), zod.z.object({
     label: zod.z.string().describe("Translated app label"),
@@ -10339,8 +10404,26 @@ var TranslationDataSchema = zod.z.object({
   /** Validation Error Messages */
   validationMessages: zod.z.record(zod.z.string(), zod.z.string()).optional().describe('Translatable validation error messages keyed by rule name (e.g., {"discount_limit": "\u6298\u6263\u4E0D\u80FD\u8D85\u8FC740%"})')
 }).describe("Translation data for objects, apps, and UI messages");
-var LocaleSchema = zod.z.string().describe("BCP-47 Language Tag (e.g. en-US, zh-CN)");
 var TranslationBundleSchema = zod.z.record(LocaleSchema, TranslationDataSchema).describe("Map of locale codes to translation data");
+var TranslationFileOrganizationSchema = zod.z.enum([
+  "bundled",
+  "per_locale",
+  "per_namespace"
+]).describe("Translation file organization strategy");
+var TranslationConfigSchema = zod.z.object({
+  /** Default locale for the application */
+  defaultLocale: LocaleSchema.describe('Default locale (e.g., "en")'),
+  /** Supported BCP-47 locale codes */
+  supportedLocales: zod.z.array(LocaleSchema).describe("Supported BCP-47 locale codes"),
+  /** Fallback locale when translation is not found */
+  fallbackLocale: LocaleSchema.optional().describe("Fallback locale code"),
+  /** How translation files are organized on disk */
+  fileOrganization: TranslationFileOrganizationSchema.default("per_locale").describe("File organization strategy"),
+  /** Load translations on demand instead of eagerly */
+  lazyLoad: zod.z.boolean().default(false).describe("Load translations on demand"),
+  /** Cache loaded translations in memory */
+  cache: zod.z.boolean().default(true).describe("Cache loaded translations")
+}).describe("Internationalization configuration");
 var OTOperationType = zod.z.enum([
   "insert",
   // Insert characters at position
@@ -28436,6 +28519,7 @@ var DEFAULT_DISPATCHER_ROUTES = [
   // Optional Services (plugin-provided)
   { prefix: "/api/v1/packages", service: "metadata" },
   { prefix: "/api/v1/ui", service: "ui" },
+  // @deprecated — use /api/v1/meta/view and /api/v1/meta/dashboard instead
   { prefix: "/api/v1/workflow", service: "workflow" },
   { prefix: "/api/v1/analytics", service: "analytics" },
   { prefix: "/api/v1/automation", service: "automation" },
@@ -33794,9 +33878,10 @@ function defineStudioPlugin(input) {
 }
 var ObjectStackDefinitionSchema = zod.z.object({
   /** System Configuration */
-  manifest: ManifestSchema.describe("Project Package Configuration"),
+  manifest: ManifestSchema.optional().describe("Project Package Configuration"),
   datasources: zod.z.array(DatasourceSchema).optional().describe("External Data Connections"),
   translations: zod.z.array(TranslationBundleSchema).optional().describe("I18n Translation Bundles"),
+  i18n: TranslationConfigSchema.optional().describe("Internationalization configuration"),
   /** 
    * ObjectQL: Data Layer 
    * All business objects and entities.
@@ -33971,7 +34056,8 @@ function validateCrossReferences(config) {
   return errors;
 }
 function defineStack(config, options) {
-  if (!options?.strict) {
+  const strict = options?.strict !== false;
+  if (!strict) {
     return config;
   }
   const result = ObjectStackDefinitionSchema.safeParse(config, {