@objectstack/spec 2.0.5 → 2.0.7

package/json-schema/ui/ListView.json

@@ -9,7 +9,37 @@
       "pattern": "^[a-z][a-z0-9_]*$"
     },
     "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"
     },
     "type": {
       "default": "grid",
@@ -194,7 +224,36 @@
               },
               "label": {
                 "description": "Display label override",
-                "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
+                  }
+                ]
               },
               "width": {
                 "description": "Column width in pixels",
@@ -230,6 +289,31 @@
                 "description": "Renderer type override (e.g., \"currency\", \"date\")",
                 "type": "string"
               },
+              "pinned": {
+                "description": "Pin/freeze column to left or right side",
+                "type": "string",
+                "enum": [
+                  "left",
+                  "right"
+                ]
+              },
+              "summary": {
+                "description": "Footer aggregation function for this column",
+                "type": "string",
+                "enum": [
+                  "none",
+                  "count",
+                  "count_empty",
+                  "count_filled",
+                  "count_unique",
+                  "percent_empty",
+                  "percent_filled",
+                  "sum",
+                  "avg",
+                  "min",
+                  "max"
+                ]
+              },
               "link": {
                 "description": "Functions as the primary navigation link (triggers View navigation)",
                 "type": "boolean"
@@ -478,6 +562,245 @@
       ],
       "additionalProperties": false
     },
+    "gallery": {
+      "type": "object",
+      "properties": {
+        "coverField": {
+          "description": "Attachment/image field to display as card cover",
+          "type": "string"
+        },
+        "coverFit": {
+          "default": "cover",
+          "description": "Image fit mode for card cover",
+          "type": "string",
+          "enum": [
+            "cover",
+            "contain"
+          ]
+        },
+        "cardSize": {
+          "default": "medium",
+          "description": "Card size in gallery view",
+          "type": "string",
+          "enum": [
+            "small",
+            "medium",
+            "large"
+          ]
+        },
+        "titleField": {
+          "description": "Field to display as card title",
+          "type": "string"
+        },
+        "visibleFields": {
+          "description": "Fields to display on card body",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "required": [
+        "coverFit",
+        "cardSize"
+      ],
+      "additionalProperties": false,
+      "description": "Gallery/card view configuration"
+    },
+    "timeline": {
+      "type": "object",
+      "properties": {
+        "startDateField": {
+          "type": "string",
+          "description": "Field for timeline item start date"
+        },
+        "endDateField": {
+          "description": "Field for timeline item end date",
+          "type": "string"
+        },
+        "titleField": {
+          "type": "string",
+          "description": "Field to display as timeline item title"
+        },
+        "groupByField": {
+          "description": "Field to group timeline rows",
+          "type": "string"
+        },
+        "colorField": {
+          "description": "Field to determine item color",
+          "type": "string"
+        },
+        "scale": {
+          "default": "week",
+          "description": "Default timeline scale",
+          "type": "string",
+          "enum": [
+            "hour",
+            "day",
+            "week",
+            "month",
+            "quarter",
+            "year"
+          ]
+        }
+      },
+      "required": [
+        "startDateField",
+        "titleField",
+        "scale"
+      ],
+      "additionalProperties": false,
+      "description": "Timeline view configuration"
+    },
+    "description": {
+      "description": "View description for documentation/tooltips",
+      "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
+        }
+      ]
+    },
+    "sharing": {
+      "description": "View sharing and access configuration",
+      "type": "object",
+      "properties": {
+        "type": {
+          "default": "collaborative",
+          "description": "View ownership type",
+          "type": "string",
+          "enum": [
+            "personal",
+            "collaborative"
+          ]
+        },
+        "lockedBy": {
+          "description": "User who locked the view configuration",
+          "type": "string"
+        }
+      },
+      "required": [
+        "type"
+      ],
+      "additionalProperties": false
+    },
+    "rowHeight": {
+      "description": "Row height / density setting",
+      "type": "string",
+      "enum": [
+        "compact",
+        "short",
+        "medium",
+        "tall",
+        "extra_tall"
+      ]
+    },
+    "grouping": {
+      "description": "Group records by one or more fields",
+      "type": "object",
+      "properties": {
+        "fields": {
+          "minItems": 1,
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "field": {
+                "type": "string",
+                "description": "Field name to group by"
+              },
+              "order": {
+                "default": "asc",
+                "description": "Group sort order",
+                "type": "string",
+                "enum": [
+                  "asc",
+                  "desc"
+                ]
+              },
+              "collapsed": {
+                "default": false,
+                "description": "Collapse groups by default",
+                "type": "boolean"
+              }
+            },
+            "required": [
+              "field",
+              "order",
+              "collapsed"
+            ],
+            "additionalProperties": false
+          },
+          "description": "Fields to group by (supports up to 3 levels)"
+        }
+      },
+      "required": [
+        "fields"
+      ],
+      "additionalProperties": false
+    },
+    "rowColor": {
+      "description": "Color rows based on field value",
+      "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
+    },
+    "hiddenFields": {
+      "description": "Fields to hide in this specific view",
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "fieldOrder": {
+      "description": "Explicit field display order for this view",
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
     "rowActions": {
       "description": "Actions available for individual row items",
       "type": "array",
@@ -546,16 +869,124 @@
       "type": "object",
       "properties": {
         "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
+            }
+          ],
+          "description": "Display label: plain string or i18n translation object"
         },
         "message": {
-          "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"
         },
         "icon": {
           "type": "string"
         }
       },
       "additionalProperties": false
+    },
+    "aria": {
+      "description": "ARIA accessibility attributes for the list view",
+      "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
     }
   },
   "required": [

package/json-schema/ui/LocaleConfig.json

@@ -0,0 +1,108 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "code": {
+      "type": "string",
+      "description": "BCP 47 language code (e.g., \"en-US\", \"zh-CN\")"
+    },
+    "fallbackChain": {
+      "description": "Fallback language codes in priority order (e.g., [\"zh-TW\", \"en\"])",
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "direction": {
+      "default": "ltr",
+      "description": "Text direction: left-to-right or right-to-left",
+      "type": "string",
+      "enum": [
+        "ltr",
+        "rtl"
+      ]
+    },
+    "numberFormat": {
+      "description": "Default number formatting rules",
+      "type": "object",
+      "properties": {
+        "style": {
+          "default": "decimal",
+          "description": "Number formatting style",
+          "type": "string",
+          "enum": [
+            "decimal",
+            "currency",
+            "percent",
+            "unit"
+          ]
+        },
+        "currency": {
+          "description": "ISO 4217 currency code (e.g., \"USD\", \"EUR\")",
+          "type": "string"
+        },
+        "unit": {
+          "description": "Unit for unit formatting (e.g., \"kilometer\", \"liter\")",
+          "type": "string"
+        },
+        "minimumFractionDigits": {
+          "description": "Minimum number of fraction digits",
+          "type": "number"
+        },
+        "maximumFractionDigits": {
+          "description": "Maximum number of fraction digits",
+          "type": "number"
+        },
+        "useGrouping": {
+          "description": "Whether to use grouping separators (e.g., 1,000)",
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "style"
+      ],
+      "additionalProperties": false
+    },
+    "dateFormat": {
+      "description": "Default date/time formatting rules",
+      "type": "object",
+      "properties": {
+        "dateStyle": {
+          "description": "Date display style",
+          "type": "string",
+          "enum": [
+            "full",
+            "long",
+            "medium",
+            "short"
+          ]
+        },
+        "timeStyle": {
+          "description": "Time display style",
+          "type": "string",
+          "enum": [
+            "full",
+            "long",
+            "medium",
+            "short"
+          ]
+        },
+        "timeZone": {
+          "description": "IANA time zone (e.g., \"America/New_York\")",
+          "type": "string"
+        },
+        "hour12": {
+          "description": "Use 12-hour format",
+          "type": "boolean"
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  "required": [
+    "code",
+    "direction"
+  ],
+  "additionalProperties": false,
+  "description": "Locale configuration"
+}

package/json-schema/ui/LongPressGestureConfig.json

@@ -0,0 +1,20 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "duration": {
+      "default": 500,
+      "description": "Hold duration in milliseconds to trigger long press",
+      "type": "number"
+    },
+    "moveTolerance": {
+      "description": "Max movement in pixels allowed during press",
+      "type": "number"
+    }
+  },
+  "required": [
+    "duration"
+  ],
+  "additionalProperties": false,
+  "description": "Long press gesture recognition settings"
+}