@objectstack/spec 2.0.5 → 2.0.7

package/json-schema/ui/ReportChart.json

@@ -47,15 +47,102 @@
     },
     "title": {
       "description": "Chart title",
-      "type": "string"
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "object",
+          "properties": {
+            "key": {
+              "type": "string",
+              "description": "Translation key (e.g., \"views.task_list.label\")"
+            },
+            "defaultValue": {
+              "description": "Fallback value when translation key is not found",
+              "type": "string"
+            },
+            "params": {
+              "description": "Interpolation parameters (e.g., { count: 5 })",
+              "type": "object",
+              "propertyNames": {
+                "type": "string"
+              },
+              "additionalProperties": {}
+            }
+          },
+          "required": [
+            "key"
+          ],
+          "additionalProperties": false
+        }
+      ]
     },
     "subtitle": {
       "description": "Chart subtitle",
-      "type": "string"
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "object",
+          "properties": {
+            "key": {
+              "type": "string",
+              "description": "Translation key (e.g., \"views.task_list.label\")"
+            },
+            "defaultValue": {
+              "description": "Fallback value when translation key is not found",
+              "type": "string"
+            },
+            "params": {
+              "description": "Interpolation parameters (e.g., { count: 5 })",
+              "type": "object",
+              "propertyNames": {
+                "type": "string"
+              },
+              "additionalProperties": {}
+            }
+          },
+          "required": [
+            "key"
+          ],
+          "additionalProperties": false
+        }
+      ]
     },
     "description": {
       "description": "Accessibility description",
-      "type": "string"
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "object",
+          "properties": {
+            "key": {
+              "type": "string",
+              "description": "Translation key (e.g., \"views.task_list.label\")"
+            },
+            "defaultValue": {
+              "description": "Fallback value when translation key is not found",
+              "type": "string"
+            },
+            "params": {
+              "description": "Interpolation parameters (e.g., { count: 5 })",
+              "type": "object",
+              "propertyNames": {
+                "type": "string"
+              },
+              "additionalProperties": {}
+            }
+          },
+          "required": [
+            "key"
+          ],
+          "additionalProperties": false
+        }
+      ]
     },
     "xAxis": {
       "type": "string",
@@ -77,7 +164,36 @@
           },
           "label": {
             "description": "Series display label",
-            "type": "string"
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "object",
+                "properties": {
+                  "key": {
+                    "type": "string",
+                    "description": "Translation key (e.g., \"views.task_list.label\")"
+                  },
+                  "defaultValue": {
+                    "description": "Fallback value when translation key is not found",
+                    "type": "string"
+                  },
+                  "params": {
+                    "description": "Interpolation parameters (e.g., { count: 5 })",
+                    "type": "object",
+                    "propertyNames": {
+                      "type": "string"
+                    },
+                    "additionalProperties": {}
+                  }
+                },
+                "required": [
+                  "key"
+                ],
+                "additionalProperties": false
+              }
+            ]
           },
           "type": {
             "description": "Override chart type for this series",
@@ -216,7 +332,37 @@
             "type": "string"
           },
           "label": {
-            "type": "string"
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "object",
+                "properties": {
+                  "key": {
+                    "type": "string",
+                    "description": "Translation key (e.g., \"views.task_list.label\")"
+                  },
+                  "defaultValue": {
+                    "description": "Fallback value when translation key is not found",
+                    "type": "string"
+                  },
+                  "params": {
+                    "description": "Interpolation parameters (e.g., { count: 5 })",
+                    "type": "object",
+                    "propertyNames": {
+                      "type": "string"
+                    },
+                    "additionalProperties": {}
+                  }
+                },
+                "required": [
+                  "key"
+                ],
+                "additionalProperties": false
+              }
+            ],
+            "description": "Display label: plain string or i18n translation object"
           },
           "style": {
             "default": "dashed",
@@ -264,6 +410,54 @@
       ],
       "additionalProperties": false
     },
+    "aria": {
+      "description": "ARIA accessibility attributes",
+      "type": "object",
+      "properties": {
+        "ariaLabel": {
+          "description": "Accessible label for screen readers (WAI-ARIA aria-label)",
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "object",
+              "properties": {
+                "key": {
+                  "type": "string",
+                  "description": "Translation key (e.g., \"views.task_list.label\")"
+                },
+                "defaultValue": {
+                  "description": "Fallback value when translation key is not found",
+                  "type": "string"
+                },
+                "params": {
+                  "description": "Interpolation parameters (e.g., { count: 5 })",
+                  "type": "object",
+                  "propertyNames": {
+                    "type": "string"
+                  },
+                  "additionalProperties": {}
+                }
+              },
+              "required": [
+                "key"
+              ],
+              "additionalProperties": false
+            }
+          ]
+        },
+        "ariaDescribedBy": {
+          "description": "ID of element providing additional description (WAI-ARIA aria-describedby)",
+          "type": "string"
+        },
+        "role": {
+          "description": "WAI-ARIA role attribute (e.g., \"dialog\", \"navigation\", \"alert\")",
+          "type": "string"
+        }
+      },
+      "additionalProperties": false
+    },
     "groupBy": {
       "description": "Additional grouping field",
       "type": "string"

package/json-schema/ui/ReportColumn.json

@@ -8,7 +8,36 @@
     },
     "label": {
       "description": "Override label",
-      "type": "string"
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "object",
+          "properties": {
+            "key": {
+              "type": "string",
+              "description": "Translation key (e.g., \"views.task_list.label\")"
+            },
+            "defaultValue": {
+              "description": "Fallback value when translation key is not found",
+              "type": "string"
+            },
+            "params": {
+              "description": "Interpolation parameters (e.g., { count: 5 })",
+              "type": "object",
+              "propertyNames": {
+                "type": "string"
+              },
+              "additionalProperties": {}
+            }
+          },
+          "required": [
+            "key"
+          ],
+          "additionalProperties": false
+        }
+      ]
     },
     "aggregate": {
       "description": "Aggregation function",
@@ -21,6 +50,102 @@
         "count",
         "unique"
       ]
+    },
+    "responsive": {
+      "description": "Responsive visibility for this column",
+      "type": "object",
+      "properties": {
+        "breakpoint": {
+          "description": "Minimum breakpoint for visibility",
+          "type": "string",
+          "enum": [
+            "xs",
+            "sm",
+            "md",
+            "lg",
+            "xl",
+            "2xl"
+          ]
+        },
+        "hiddenOn": {
+          "description": "Hide on these breakpoints",
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": [
+              "xs",
+              "sm",
+              "md",
+              "lg",
+              "xl",
+              "2xl"
+            ]
+          }
+        },
+        "columns": {
+          "description": "Grid columns per breakpoint",
+          "type": "object",
+          "properties": {
+            "xs": {
+              "type": "number",
+              "minimum": 1,
+              "maximum": 12
+            },
+            "sm": {
+              "type": "number",
+              "minimum": 1,
+              "maximum": 12
+            },
+            "md": {
+              "type": "number",
+              "minimum": 1,
+              "maximum": 12
+            },
+            "lg": {
+              "type": "number",
+              "minimum": 1,
+              "maximum": 12
+            },
+            "xl": {
+              "type": "number",
+              "minimum": 1,
+              "maximum": 12
+            },
+            "2xl": {
+              "type": "number",
+              "minimum": 1,
+              "maximum": 12
+            }
+          },
+          "additionalProperties": false
+        },
+        "order": {
+          "description": "Display order per breakpoint",
+          "type": "object",
+          "properties": {
+            "xs": {
+              "type": "number"
+            },
+            "sm": {
+              "type": "number"
+            },
+            "md": {
+              "type": "number"
+            },
+            "lg": {
+              "type": "number"
+            },
+            "xl": {
+              "type": "number"
+            },
+            "2xl": {
+              "type": "number"
+            }
+          },
+          "additionalProperties": false
+        }
+      },
+      "additionalProperties": false
     }
   },
   "required": [

package/json-schema/ui/ResponsiveConfig.json

@@ -0,0 +1,97 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "breakpoint": {
+      "description": "Minimum breakpoint for visibility",
+      "type": "string",
+      "enum": [
+        "xs",
+        "sm",
+        "md",
+        "lg",
+        "xl",
+        "2xl"
+      ]
+    },
+    "hiddenOn": {
+      "description": "Hide on these breakpoints",
+      "type": "array",
+      "items": {
+        "type": "string",
+        "enum": [
+          "xs",
+          "sm",
+          "md",
+          "lg",
+          "xl",
+          "2xl"
+        ]
+      }
+    },
+    "columns": {
+      "description": "Grid columns per breakpoint",
+      "type": "object",
+      "properties": {
+        "xs": {
+          "type": "number",
+          "minimum": 1,
+          "maximum": 12
+        },
+        "sm": {
+          "type": "number",
+          "minimum": 1,
+          "maximum": 12
+        },
+        "md": {
+          "type": "number",
+          "minimum": 1,
+          "maximum": 12
+        },
+        "lg": {
+          "type": "number",
+          "minimum": 1,
+          "maximum": 12
+        },
+        "xl": {
+          "type": "number",
+          "minimum": 1,
+          "maximum": 12
+        },
+        "2xl": {
+          "type": "number",
+          "minimum": 1,
+          "maximum": 12
+        }
+      },
+      "additionalProperties": false
+    },
+    "order": {
+      "description": "Display order per breakpoint",
+      "type": "object",
+      "properties": {
+        "xs": {
+          "type": "number"
+        },
+        "sm": {
+          "type": "number"
+        },
+        "md": {
+          "type": "number"
+        },
+        "lg": {
+          "type": "number"
+        },
+        "xl": {
+          "type": "number"
+        },
+        "2xl": {
+          "type": "number"
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  "additionalProperties": false,
+  "description": "Responsive layout configuration"
+}

package/json-schema/ui/RowColorConfig.json

@@ -0,0 +1,25 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "field": {
+      "type": "string",
+      "description": "Field to derive color from (typically a select/status field)"
+    },
+    "colors": {
+      "description": "Map of field value to color (hex/token)",
+      "type": "object",
+      "propertyNames": {
+        "type": "string"
+      },
+      "additionalProperties": {
+        "type": "string"
+      }
+    }
+  },
+  "required": [
+    "field"
+  ],
+  "additionalProperties": false,
+  "description": "Row color configuration based on field values"
+}

package/json-schema/ui/RowHeight.json

@@ -0,0 +1,12 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "string",
+  "enum": [
+    "compact",
+    "short",
+    "medium",
+    "tall",
+    "extra_tall"
+  ],
+  "description": "Row height / density setting for list view"
+}

package/json-schema/ui/SwipeDirection.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "string",
+  "enum": [
+    "up",
+    "down",
+    "left",
+    "right"
+  ]
+}

package/json-schema/ui/SwipeGestureConfig.json

@@ -0,0 +1,32 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "direction": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "enum": [
+          "up",
+          "down",
+          "left",
+          "right"
+        ]
+      },
+      "description": "Allowed swipe directions"
+    },
+    "threshold": {
+      "description": "Minimum distance in pixels to recognize swipe",
+      "type": "number"
+    },
+    "velocity": {
+      "description": "Minimum velocity (px/ms) to trigger swipe",
+      "type": "number"
+    }
+  },
+  "required": [
+    "direction"
+  ],
+  "additionalProperties": false,
+  "description": "Swipe gesture recognition settings"
+}

package/json-schema/ui/SyncConfig.json

@@ -0,0 +1,47 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "strategy": {
+      "default": "network_first",
+      "description": "Sync fetch strategy",
+      "type": "string",
+      "enum": [
+        "cache_first",
+        "network_first",
+        "stale_while_revalidate",
+        "network_only",
+        "cache_only"
+      ]
+    },
+    "conflictResolution": {
+      "default": "last_write_wins",
+      "description": "Conflict resolution policy",
+      "type": "string",
+      "enum": [
+        "client_wins",
+        "server_wins",
+        "manual",
+        "last_write_wins"
+      ]
+    },
+    "retryInterval": {
+      "description": "Retry interval in milliseconds between sync attempts",
+      "type": "number"
+    },
+    "maxRetries": {
+      "description": "Maximum number of sync retry attempts",
+      "type": "number"
+    },
+    "batchSize": {
+      "description": "Number of mutations to sync per batch",
+      "type": "number"
+    }
+  },
+  "required": [
+    "strategy",
+    "conflictResolution"
+  ],
+  "additionalProperties": false,
+  "description": "Offline-to-online synchronization configuration"
+}