@objectstack/spec 2.0.5 → 2.0.7

package/json-schema/ui/FocusManagement.json

@@ -0,0 +1,69 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "tabOrder": {
+      "default": "auto",
+      "description": "Tab order strategy: auto (DOM order) or manual (explicit tabIndex)",
+      "type": "string",
+      "enum": [
+        "auto",
+        "manual"
+      ]
+    },
+    "skipLinks": {
+      "default": false,
+      "description": "Provide skip-to-content navigation links",
+      "type": "boolean"
+    },
+    "focusVisible": {
+      "default": true,
+      "description": "Show visible focus indicators for keyboard users",
+      "type": "boolean"
+    },
+    "focusTrap": {
+      "description": "Focus trap settings",
+      "type": "object",
+      "properties": {
+        "enabled": {
+          "default": false,
+          "description": "Enable focus trapping within this container",
+          "type": "boolean"
+        },
+        "initialFocus": {
+          "description": "CSS selector for the element to focus on activation",
+          "type": "string"
+        },
+        "returnFocus": {
+          "default": true,
+          "description": "Return focus to trigger element on deactivation",
+          "type": "boolean"
+        },
+        "escapeDeactivates": {
+          "default": true,
+          "description": "Allow Escape key to deactivate the focus trap",
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "enabled",
+        "returnFocus",
+        "escapeDeactivates"
+      ],
+      "additionalProperties": false
+    },
+    "arrowNavigation": {
+      "default": false,
+      "description": "Enable arrow key navigation between focusable items",
+      "type": "boolean"
+    }
+  },
+  "required": [
+    "tabOrder",
+    "skipLinks",
+    "focusVisible",
+    "arrowNavigation"
+  ],
+  "additionalProperties": false,
+  "description": "Focus and tab navigation management"
+}

package/json-schema/ui/FocusTrapConfig.json

@@ -0,0 +1,32 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "enabled": {
+      "default": false,
+      "description": "Enable focus trapping within this container",
+      "type": "boolean"
+    },
+    "initialFocus": {
+      "description": "CSS selector for the element to focus on activation",
+      "type": "string"
+    },
+    "returnFocus": {
+      "default": true,
+      "description": "Return focus to trigger element on deactivation",
+      "type": "boolean"
+    },
+    "escapeDeactivates": {
+      "default": true,
+      "description": "Allow Escape key to deactivate the focus trap",
+      "type": "boolean"
+    }
+  },
+  "required": [
+    "enabled",
+    "returnFocus",
+    "escapeDeactivates"
+  ],
+  "additionalProperties": false,
+  "description": "Focus trap configuration for modal-like containers"
+}

package/json-schema/ui/FormField.json

@@ -8,15 +8,102 @@
     },
     "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
+        }
+      ]
     },
     "placeholder": {
       "description": "Placeholder text",
-      "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
+        }
+      ]
     },
     "helpText": {
       "description": "Help/hint text",
-      "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
+        }
+      ]
     },
     "readonly": {
       "description": "Read-only override",

package/json-schema/ui/GalleryConfig.json

@@ -0,0 +1,46 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "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"
+}

package/json-schema/ui/GestureConfig.json

@@ -0,0 +1,128 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "type": {
+      "type": "string",
+      "enum": [
+        "swipe",
+        "pinch",
+        "long_press",
+        "double_tap",
+        "drag",
+        "rotate",
+        "pan"
+      ],
+      "description": "Gesture type to configure"
+    },
+    "label": {
+      "description": "Descriptive label for the gesture action",
+      "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
+        }
+      ]
+    },
+    "enabled": {
+      "default": true,
+      "description": "Whether this gesture is active",
+      "type": "boolean"
+    },
+    "swipe": {
+      "description": "Swipe gesture settings (when type is swipe)",
+      "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
+    },
+    "pinch": {
+      "description": "Pinch gesture settings (when type is pinch)",
+      "type": "object",
+      "properties": {
+        "minScale": {
+          "description": "Minimum scale factor (e.g., 0.5 for 50%)",
+          "type": "number"
+        },
+        "maxScale": {
+          "description": "Maximum scale factor (e.g., 3.0 for 300%)",
+          "type": "number"
+        }
+      },
+      "additionalProperties": false
+    },
+    "longPress": {
+      "description": "Long press settings (when type is long_press)",
+      "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
+    }
+  },
+  "required": [
+    "type",
+    "enabled"
+  ],
+  "additionalProperties": false,
+  "description": "Per-gesture configuration"
+}

package/json-schema/ui/GestureType.json

@@ -0,0 +1,14 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "string",
+  "enum": [
+    "swipe",
+    "pinch",
+    "long_press",
+    "double_tap",
+    "drag",
+    "rotate",
+    "pan"
+  ],
+  "description": "Touch gesture type"
+}

package/json-schema/ui/GroupNavItem.json

@@ -9,7 +9,36 @@
       "description": "Unique identifier for this navigation item (lowercase snake_case)"
     },
     "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 proper label"
     },
     "icon": {

package/json-schema/ui/GroupingConfig.json

@@ -0,0 +1,45 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "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,
+  "description": "Record grouping configuration"
+}

package/json-schema/ui/GroupingField.json

@@ -0,0 +1,30 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "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
+}

package/json-schema/ui/I18nLabel.json

@@ -0,0 +1,34 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "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"
+}

package/json-schema/ui/I18nObject.json

@@ -0,0 +1,26 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "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
+}