@objectstack/spec 2.0.5 → 2.0.7

package/json-schema/ui/DndConfig.json

@@ -0,0 +1,306 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "enabled": {
+      "default": false,
+      "description": "Enable drag and drop",
+      "type": "boolean"
+    },
+    "dragItem": {
+      "description": "Configuration for draggable item",
+      "type": "object",
+      "properties": {
+        "type": {
+          "type": "string",
+          "description": "Drag item type identifier for matching with drop zones"
+        },
+        "label": {
+          "description": "Accessible label describing the draggable item",
+          "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
+            }
+          ]
+        },
+        "handle": {
+          "default": "element",
+          "description": "How to initiate drag",
+          "type": "string",
+          "enum": [
+            "element",
+            "handle",
+            "grip_icon"
+          ]
+        },
+        "constraint": {
+          "description": "Drag movement constraints",
+          "type": "object",
+          "properties": {
+            "axis": {
+              "default": "both",
+              "description": "Constrain drag axis",
+              "type": "string",
+              "enum": [
+                "x",
+                "y",
+                "both"
+              ]
+            },
+            "bounds": {
+              "default": "none",
+              "description": "Constrain within bounds",
+              "type": "string",
+              "enum": [
+                "parent",
+                "viewport",
+                "none"
+              ]
+            },
+            "grid": {
+              "description": "Snap to grid [x, y] in pixels",
+              "type": "array",
+              "prefixItems": [
+                {
+                  "type": "number"
+                },
+                {
+                  "type": "number"
+                }
+              ]
+            }
+          },
+          "required": [
+            "axis",
+            "bounds"
+          ],
+          "additionalProperties": false
+        },
+        "preview": {
+          "default": "element",
+          "description": "Drag preview type",
+          "type": "string",
+          "enum": [
+            "element",
+            "custom",
+            "none"
+          ]
+        },
+        "disabled": {
+          "default": false,
+          "description": "Disable dragging",
+          "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"
+        }
+      },
+      "required": [
+        "type",
+        "handle",
+        "preview",
+        "disabled"
+      ],
+      "additionalProperties": false
+    },
+    "dropZone": {
+      "description": "Configuration for drop target",
+      "type": "object",
+      "properties": {
+        "label": {
+          "description": "Accessible label for the drop zone",
+          "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
+            }
+          ]
+        },
+        "accept": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Accepted drag item types"
+        },
+        "maxItems": {
+          "description": "Maximum items allowed in drop zone",
+          "type": "number"
+        },
+        "highlightOnDragOver": {
+          "default": true,
+          "description": "Highlight drop zone when dragging over",
+          "type": "boolean"
+        },
+        "dropEffect": {
+          "default": "move",
+          "description": "Visual effect on drop",
+          "type": "string",
+          "enum": [
+            "move",
+            "copy",
+            "link",
+            "none"
+          ]
+        },
+        "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"
+        }
+      },
+      "required": [
+        "accept",
+        "highlightOnDragOver",
+        "dropEffect"
+      ],
+      "additionalProperties": false
+    },
+    "sortable": {
+      "default": false,
+      "description": "Enable sortable list behavior",
+      "type": "boolean"
+    },
+    "autoScroll": {
+      "default": true,
+      "description": "Auto-scroll during drag near edges",
+      "type": "boolean"
+    },
+    "touchDelay": {
+      "default": 200,
+      "description": "Delay in ms before drag starts on touch devices",
+      "type": "number"
+    }
+  },
+  "required": [
+    "enabled",
+    "sortable",
+    "autoScroll",
+    "touchDelay"
+  ],
+  "additionalProperties": false,
+  "description": "Drag and drop interaction configuration"
+}

package/json-schema/ui/DragConstraint.json

@@ -0,0 +1,44 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "axis": {
+      "default": "both",
+      "description": "Constrain drag axis",
+      "type": "string",
+      "enum": [
+        "x",
+        "y",
+        "both"
+      ]
+    },
+    "bounds": {
+      "default": "none",
+      "description": "Constrain within bounds",
+      "type": "string",
+      "enum": [
+        "parent",
+        "viewport",
+        "none"
+      ]
+    },
+    "grid": {
+      "description": "Snap to grid [x, y] in pixels",
+      "type": "array",
+      "prefixItems": [
+        {
+          "type": "number"
+        },
+        {
+          "type": "number"
+        }
+      ]
+    }
+  },
+  "required": [
+    "axis",
+    "bounds"
+  ],
+  "additionalProperties": false,
+  "description": "Drag movement constraints"
+}

package/json-schema/ui/DragHandle.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "string",
+  "enum": [
+    "element",
+    "handle",
+    "grip_icon"
+  ],
+  "description": "Drag initiation method"
+}

package/json-schema/ui/DragItem.json

@@ -0,0 +1,160 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "type": {
+      "type": "string",
+      "description": "Drag item type identifier for matching with drop zones"
+    },
+    "label": {
+      "description": "Accessible label describing the draggable item",
+      "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
+        }
+      ]
+    },
+    "handle": {
+      "default": "element",
+      "description": "How to initiate drag",
+      "type": "string",
+      "enum": [
+        "element",
+        "handle",
+        "grip_icon"
+      ]
+    },
+    "constraint": {
+      "description": "Drag movement constraints",
+      "type": "object",
+      "properties": {
+        "axis": {
+          "default": "both",
+          "description": "Constrain drag axis",
+          "type": "string",
+          "enum": [
+            "x",
+            "y",
+            "both"
+          ]
+        },
+        "bounds": {
+          "default": "none",
+          "description": "Constrain within bounds",
+          "type": "string",
+          "enum": [
+            "parent",
+            "viewport",
+            "none"
+          ]
+        },
+        "grid": {
+          "description": "Snap to grid [x, y] in pixels",
+          "type": "array",
+          "prefixItems": [
+            {
+              "type": "number"
+            },
+            {
+              "type": "number"
+            }
+          ]
+        }
+      },
+      "required": [
+        "axis",
+        "bounds"
+      ],
+      "additionalProperties": false
+    },
+    "preview": {
+      "default": "element",
+      "description": "Drag preview type",
+      "type": "string",
+      "enum": [
+        "element",
+        "custom",
+        "none"
+      ]
+    },
+    "disabled": {
+      "default": false,
+      "description": "Disable dragging",
+      "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"
+    }
+  },
+  "required": [
+    "type",
+    "handle",
+    "preview",
+    "disabled"
+  ],
+  "additionalProperties": false,
+  "description": "Draggable item configuration"
+}

package/json-schema/ui/DropEffect.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "string",
+  "enum": [
+    "move",
+    "copy",
+    "link",
+    "none"
+  ],
+  "description": "Drop operation effect"
+}

package/json-schema/ui/DropZone.json

@@ -0,0 +1,114 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "label": {
+      "description": "Accessible label for the drop zone",
+      "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
+        }
+      ]
+    },
+    "accept": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "Accepted drag item types"
+    },
+    "maxItems": {
+      "description": "Maximum items allowed in drop zone",
+      "type": "number"
+    },
+    "highlightOnDragOver": {
+      "default": true,
+      "description": "Highlight drop zone when dragging over",
+      "type": "boolean"
+    },
+    "dropEffect": {
+      "default": "move",
+      "description": "Visual effect on drop",
+      "type": "string",
+      "enum": [
+        "move",
+        "copy",
+        "link",
+        "none"
+      ]
+    },
+    "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"
+    }
+  },
+  "required": [
+    "accept",
+    "highlightOnDragOver",
+    "dropEffect"
+  ],
+  "additionalProperties": false,
+  "description": "Drop zone configuration"
+}

package/json-schema/ui/EasingFunction.json

@@ -0,0 +1,13 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "string",
+  "enum": [
+    "linear",
+    "ease",
+    "ease_in",
+    "ease_out",
+    "ease_in_out",
+    "spring"
+  ],
+  "description": "Animation easing function"
+}

package/json-schema/ui/EvictionPolicy.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "string",
+  "enum": [
+    "lru",
+    "lfu",
+    "fifo"
+  ],
+  "description": "Cache eviction policy"
+}