@objectstack/spec 2.0.5 → 2.0.7

package/json-schema/ui/Theme.json

@@ -531,6 +531,143 @@
     "extends": {
       "description": "Base theme to extend from",
       "type": "string"
+    },
+    "density": {
+      "description": "Display density: compact, regular, or spacious",
+      "type": "string",
+      "enum": [
+        "compact",
+        "regular",
+        "spacious"
+      ]
+    },
+    "wcagContrast": {
+      "description": "WCAG color contrast level (AA or AAA)",
+      "type": "string",
+      "enum": [
+        "AA",
+        "AAA"
+      ]
+    },
+    "rtl": {
+      "description": "Enable right-to-left layout direction",
+      "type": "boolean"
+    },
+    "touchTarget": {
+      "description": "Touch target sizing defaults",
+      "type": "object",
+      "properties": {
+        "minWidth": {
+          "default": 44,
+          "description": "Minimum touch target width in pixels (WCAG 2.5.5: 44px)",
+          "type": "number"
+        },
+        "minHeight": {
+          "default": 44,
+          "description": "Minimum touch target height in pixels (WCAG 2.5.5: 44px)",
+          "type": "number"
+        },
+        "padding": {
+          "description": "Additional padding around touch target in pixels",
+          "type": "number"
+        },
+        "hitSlop": {
+          "description": "Invisible hit area extension beyond the visible bounds",
+          "type": "object",
+          "properties": {
+            "top": {
+              "description": "Extra hit area above the element",
+              "type": "number"
+            },
+            "right": {
+              "description": "Extra hit area to the right of the element",
+              "type": "number"
+            },
+            "bottom": {
+              "description": "Extra hit area below the element",
+              "type": "number"
+            },
+            "left": {
+              "description": "Extra hit area to the left of the element",
+              "type": "number"
+            }
+          },
+          "additionalProperties": false
+        }
+      },
+      "required": [
+        "minWidth",
+        "minHeight"
+      ],
+      "additionalProperties": false
+    },
+    "keyboardNavigation": {
+      "description": "Keyboard focus management settings",
+      "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
     }
   },
   "required": [

package/json-schema/ui/TimelineConfig.json

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

package/json-schema/ui/TouchInteraction.json

@@ -0,0 +1,232 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "gestures": {
+      "description": "Configured gesture recognizers",
+      "type": "array",
+      "items": {
+        "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"
+      }
+    },
+    "touchTarget": {
+      "description": "Touch target sizing and hit area",
+      "type": "object",
+      "properties": {
+        "minWidth": {
+          "default": 44,
+          "description": "Minimum touch target width in pixels (WCAG 2.5.5: 44px)",
+          "type": "number"
+        },
+        "minHeight": {
+          "default": 44,
+          "description": "Minimum touch target height in pixels (WCAG 2.5.5: 44px)",
+          "type": "number"
+        },
+        "padding": {
+          "description": "Additional padding around touch target in pixels",
+          "type": "number"
+        },
+        "hitSlop": {
+          "description": "Invisible hit area extension beyond the visible bounds",
+          "type": "object",
+          "properties": {
+            "top": {
+              "description": "Extra hit area above the element",
+              "type": "number"
+            },
+            "right": {
+              "description": "Extra hit area to the right of the element",
+              "type": "number"
+            },
+            "bottom": {
+              "description": "Extra hit area below the element",
+              "type": "number"
+            },
+            "left": {
+              "description": "Extra hit area to the left of the element",
+              "type": "number"
+            }
+          },
+          "additionalProperties": false
+        }
+      },
+      "required": [
+        "minWidth",
+        "minHeight"
+      ],
+      "additionalProperties": false
+    },
+    "hapticFeedback": {
+      "description": "Enable haptic feedback on touch interactions",
+      "type": "boolean"
+    },
+    "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,
+  "description": "Touch and gesture interaction configuration"
+}

package/json-schema/ui/TouchTargetConfig.json

@@ -0,0 +1,49 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "minWidth": {
+      "default": 44,
+      "description": "Minimum touch target width in pixels (WCAG 2.5.5: 44px)",
+      "type": "number"
+    },
+    "minHeight": {
+      "default": 44,
+      "description": "Minimum touch target height in pixels (WCAG 2.5.5: 44px)",
+      "type": "number"
+    },
+    "padding": {
+      "description": "Additional padding around touch target in pixels",
+      "type": "number"
+    },
+    "hitSlop": {
+      "description": "Invisible hit area extension beyond the visible bounds",
+      "type": "object",
+      "properties": {
+        "top": {
+          "description": "Extra hit area above the element",
+          "type": "number"
+        },
+        "right": {
+          "description": "Extra hit area to the right of the element",
+          "type": "number"
+        },
+        "bottom": {
+          "description": "Extra hit area below the element",
+          "type": "number"
+        },
+        "left": {
+          "description": "Extra hit area to the left of the element",
+          "type": "number"
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  "required": [
+    "minWidth",
+    "minHeight"
+  ],
+  "additionalProperties": false,
+  "description": "Touch target sizing configuration (WCAG accessible)"
+}

package/json-schema/ui/TransitionConfig.json

@@ -0,0 +1,47 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "preset": {
+      "description": "Transition preset to apply",
+      "type": "string",
+      "enum": [
+        "fade",
+        "slide_up",
+        "slide_down",
+        "slide_left",
+        "slide_right",
+        "scale",
+        "rotate",
+        "flip",
+        "none"
+      ]
+    },
+    "duration": {
+      "description": "Transition duration in milliseconds",
+      "type": "number"
+    },
+    "easing": {
+      "description": "Easing function for the transition",
+      "type": "string",
+      "enum": [
+        "linear",
+        "ease",
+        "ease_in",
+        "ease_out",
+        "ease_in_out",
+        "spring"
+      ]
+    },
+    "delay": {
+      "description": "Delay before transition starts in milliseconds",
+      "type": "number"
+    },
+    "customKeyframes": {
+      "description": "CSS @keyframes name for custom animations",
+      "type": "string"
+    }
+  },
+  "additionalProperties": false,
+  "description": "Animation transition configuration"
+}

package/json-schema/ui/TransitionPreset.json

@@ -0,0 +1,16 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "string",
+  "enum": [
+    "fade",
+    "slide_up",
+    "slide_down",
+    "slide_left",
+    "slide_right",
+    "scale",
+    "rotate",
+    "flip",
+    "none"
+  ],
+  "description": "Transition preset type"
+}

package/json-schema/ui/UrlNavItem.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/ViewSharing.json

@@ -0,0 +1,24 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "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,
+  "description": "View sharing and access configuration"
+}

package/json-schema/ui/WcagContrastLevel.json

@@ -0,0 +1,8 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "string",
+  "enum": [
+    "AA",
+    "AAA"
+  ]
+}

package/json-schema/ui/WidgetEvent.json

@@ -8,11 +8,69 @@
     },
     "label": {
       "description": "Human-readable event 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": {
       "description": "Event description and usage",
-      "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
+        }
+      ]
     },
     "bubbles": {
       "default": false,