@objectstack/spec 2.0.5 → 2.0.7

package/json-schema/ui/PageHeaderProps.json

@@ -3,12 +3,70 @@
   "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": "Page title"
     },
     "subtitle": {
       "description": "Page subtitle",
-      "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
+        }
+      ]
     },
     "icon": {
       "description": "Icon name",
@@ -25,6 +83,54 @@
       "items": {
         "type": "string"
       }
+    },
+    "aria": {
+      "description": "ARIA accessibility attributes",
+      "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/PageNavItem.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/PageRegion.json

@@ -59,7 +59,37 @@
             "type": "string"
           },
           "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"
           },
           "properties": {
             "type": "object",
@@ -96,6 +126,150 @@
           "visibility": {
             "description": "Visibility filter/formula",
             "type": "string"
+          },
+          "responsive": {
+            "description": "Responsive layout configuration",
+            "type": "object",
+            "properties": {
+              "breakpoint": {
+                "description": "Minimum breakpoint for visibility",
+                "type": "string",
+                "enum": [
+                  "xs",
+                  "sm",
+                  "md",
+                  "lg",
+                  "xl",
+                  "2xl"
+                ]
+              },
+              "hiddenOn": {
+                "description": "Hide on these breakpoints",
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "enum": [
+                    "xs",
+                    "sm",
+                    "md",
+                    "lg",
+                    "xl",
+                    "2xl"
+                  ]
+                }
+              },
+              "columns": {
+                "description": "Grid columns per breakpoint",
+                "type": "object",
+                "properties": {
+                  "xs": {
+                    "type": "number",
+                    "minimum": 1,
+                    "maximum": 12
+                  },
+                  "sm": {
+                    "type": "number",
+                    "minimum": 1,
+                    "maximum": 12
+                  },
+                  "md": {
+                    "type": "number",
+                    "minimum": 1,
+                    "maximum": 12
+                  },
+                  "lg": {
+                    "type": "number",
+                    "minimum": 1,
+                    "maximum": 12
+                  },
+                  "xl": {
+                    "type": "number",
+                    "minimum": 1,
+                    "maximum": 12
+                  },
+                  "2xl": {
+                    "type": "number",
+                    "minimum": 1,
+                    "maximum": 12
+                  }
+                },
+                "additionalProperties": false
+              },
+              "order": {
+                "description": "Display order per breakpoint",
+                "type": "object",
+                "properties": {
+                  "xs": {
+                    "type": "number"
+                  },
+                  "sm": {
+                    "type": "number"
+                  },
+                  "md": {
+                    "type": "number"
+                  },
+                  "lg": {
+                    "type": "number"
+                  },
+                  "xl": {
+                    "type": "number"
+                  },
+                  "2xl": {
+                    "type": "number"
+                  }
+                },
+                "additionalProperties": false
+              }
+            },
+            "additionalProperties": false
+          },
+          "aria": {
+            "description": "ARIA accessibility attributes",
+            "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/PageTabsProps.json

@@ -25,7 +25,37 @@
         "type": "object",
         "properties": {
           "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"
           },
           "icon": {
             "type": "string"
@@ -42,6 +72,54 @@
         ],
         "additionalProperties": false
       }
+    },
+    "aria": {
+      "description": "ARIA accessibility attributes",
+      "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/PageTransition.json

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

package/json-schema/ui/PerformanceConfig.json

@@ -0,0 +1,57 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "lazyLoad": {
+      "description": "Enable lazy loading (defer rendering until visible)",
+      "type": "boolean"
+    },
+    "virtualScroll": {
+      "description": "Virtual scrolling configuration",
+      "type": "object",
+      "properties": {
+        "enabled": {
+          "default": false,
+          "description": "Enable virtual scrolling",
+          "type": "boolean"
+        },
+        "itemHeight": {
+          "description": "Fixed item height in pixels (for estimation)",
+          "type": "number"
+        },
+        "overscan": {
+          "description": "Number of extra items to render outside viewport",
+          "type": "number"
+        }
+      },
+      "required": [
+        "enabled"
+      ],
+      "additionalProperties": false
+    },
+    "cacheStrategy": {
+      "description": "Client-side data caching strategy",
+      "type": "string",
+      "enum": [
+        "none",
+        "cache-first",
+        "network-first",
+        "stale-while-revalidate"
+      ]
+    },
+    "prefetch": {
+      "description": "Prefetch data before component is visible",
+      "type": "boolean"
+    },
+    "pageSize": {
+      "description": "Number of items per page for pagination",
+      "type": "number"
+    },
+    "debounceMs": {
+      "description": "Debounce interval for user interactions in milliseconds",
+      "type": "number"
+    }
+  },
+  "additionalProperties": false,
+  "description": "Performance optimization configuration"
+}

package/json-schema/ui/PersistStorage.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "string",
+  "enum": [
+    "indexeddb",
+    "localstorage",
+    "sqlite"
+  ],
+  "description": "Client-side storage backend for offline cache"
+}

package/json-schema/ui/PinchGestureConfig.json

@@ -0,0 +1,16 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "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,
+  "description": "Pinch/zoom gesture recognition settings"
+}

package/json-schema/ui/PluralRule.json

@@ -0,0 +1,40 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "key": {
+      "type": "string",
+      "description": "Translation key"
+    },
+    "zero": {
+      "description": "Zero form (e.g., \"No items\")",
+      "type": "string"
+    },
+    "one": {
+      "description": "Singular form (e.g., \"{count} item\")",
+      "type": "string"
+    },
+    "two": {
+      "description": "Dual form (e.g., \"{count} items\" for exactly 2)",
+      "type": "string"
+    },
+    "few": {
+      "description": "Few form (e.g., for 2-4 in some languages)",
+      "type": "string"
+    },
+    "many": {
+      "description": "Many form (e.g., for 5+ in some languages)",
+      "type": "string"
+    },
+    "other": {
+      "type": "string",
+      "description": "Default plural form (e.g., \"{count} items\")"
+    }
+  },
+  "required": [
+    "key",
+    "other"
+  ],
+  "additionalProperties": false,
+  "description": "ICU plural rules for a translation key"
+}