@objectstack/spec 2.0.6 → 2.0.7

package/json-schema/ui/MotionConfig.json

@@ -0,0 +1,405 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "label": {
+      "description": "Descriptive label for the motion configuration",
+      "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
+        }
+      ]
+    },
+    "defaultTransition": {
+      "description": "Default transition applied to all animations",
+      "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
+    },
+    "pageTransitions": {
+      "description": "Page navigation transition settings",
+      "type": "object",
+      "properties": {
+        "type": {
+          "default": "fade",
+          "description": "Page transition type",
+          "type": "string",
+          "enum": [
+            "fade",
+            "slide_up",
+            "slide_down",
+            "slide_left",
+            "slide_right",
+            "scale",
+            "rotate",
+            "flip",
+            "none"
+          ]
+        },
+        "duration": {
+          "default": 300,
+          "description": "Transition duration in milliseconds",
+          "type": "number"
+        },
+        "easing": {
+          "default": "ease_in_out",
+          "description": "Easing function for the transition",
+          "type": "string",
+          "enum": [
+            "linear",
+            "ease",
+            "ease_in",
+            "ease_out",
+            "ease_in_out",
+            "spring"
+          ]
+        },
+        "crossFade": {
+          "default": false,
+          "description": "Whether to cross-fade between pages",
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "type",
+        "duration",
+        "easing",
+        "crossFade"
+      ],
+      "additionalProperties": false
+    },
+    "componentAnimations": {
+      "description": "Component name to animation configuration mapping",
+      "type": "object",
+      "propertyNames": {
+        "type": "string"
+      },
+      "additionalProperties": {
+        "type": "object",
+        "properties": {
+          "label": {
+            "description": "Descriptive label for this animation configuration",
+            "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
+              }
+            ]
+          },
+          "enter": {
+            "description": "Enter/mount animation",
+            "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
+          },
+          "exit": {
+            "description": "Exit/unmount animation",
+            "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
+          },
+          "hover": {
+            "description": "Hover state animation",
+            "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
+          },
+          "trigger": {
+            "description": "When to trigger the animation",
+            "type": "string",
+            "enum": [
+              "on_mount",
+              "on_unmount",
+              "on_hover",
+              "on_focus",
+              "on_click",
+              "on_scroll",
+              "on_visible"
+            ]
+          },
+          "reducedMotion": {
+            "default": "respect",
+            "description": "Accessibility: how to handle prefers-reduced-motion",
+            "type": "string",
+            "enum": [
+              "respect",
+              "disable",
+              "alternative"
+            ]
+          },
+          "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": [
+          "reducedMotion"
+        ],
+        "additionalProperties": false,
+        "description": "Component-level animation configuration"
+      }
+    },
+    "reducedMotion": {
+      "default": false,
+      "description": "When true, respect prefers-reduced-motion and suppress animations globally",
+      "type": "boolean"
+    },
+    "enabled": {
+      "default": true,
+      "description": "Enable or disable all animations globally",
+      "type": "boolean"
+    }
+  },
+  "required": [
+    "reducedMotion",
+    "enabled"
+  ],
+  "additionalProperties": false,
+  "description": "Top-level motion and animation design configuration"
+}

package/json-schema/ui/NavigationItem.json

@@ -11,7 +11,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": {
@@ -60,7 +89,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": {
@@ -98,7 +156,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": {
@@ -144,7 +231,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": {
@@ -192,7 +308,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": {