openuispec 0.1.0

package/schema/tokens/layout.schema.json

@@ -0,0 +1,170 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openuispec.org/schema/tokens/layout.schema.json",
+  "title": "OpenUISpec Layout Tokens",
+  "description": "Size classes, platform mapping, layout primitives, and content reflow rules",
+  "type": "object",
+  "required": [
+    "layout"
+  ],
+  "additionalProperties": false,
+  "properties": {
+    "layout": {
+      "type": "object",
+      "properties": {
+        "size_classes": {
+          "type": "object",
+          "description": "Size class definitions",
+          "properties": {
+            "compact": {
+              "$ref": "https://openuispec.org/schema/tokens/layout.schema.json#/$defs/size_class_def"
+            },
+            "regular": {
+              "$ref": "https://openuispec.org/schema/tokens/layout.schema.json#/$defs/size_class_def"
+            },
+            "expanded": {
+              "$ref": "https://openuispec.org/schema/tokens/layout.schema.json#/$defs/size_class_def"
+            }
+          },
+          "additionalProperties": false
+        },
+        "platform_mapping": {
+          "type": "object",
+          "description": "How each platform resolves size classes",
+          "properties": {
+            "ios": {
+              "$ref": "https://openuispec.org/schema/tokens/layout.schema.json#/$defs/platform_size_mapping"
+            },
+            "android": {
+              "$ref": "https://openuispec.org/schema/tokens/layout.schema.json#/$defs/platform_size_mapping"
+            },
+            "web": {
+              "$ref": "https://openuispec.org/schema/tokens/layout.schema.json#/$defs/platform_size_mapping"
+            }
+          },
+          "additionalProperties": false
+        },
+        "primitives": {
+          "type": "object",
+          "description": "Layout primitive definitions",
+          "additionalProperties": {
+            "$ref": "https://openuispec.org/schema/tokens/layout.schema.json#/$defs/primitive_def"
+          }
+        },
+        "reflow_rules": {
+          "type": "object",
+          "description": "Content reflow rules across size class boundaries",
+          "additionalProperties": {
+            "$ref": "https://openuispec.org/schema/defs/adaptive.schema.json"
+          }
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  "$defs": {
+    "size_class_def": {
+      "type": "object",
+      "properties": {
+        "semantic": {
+          "type": "string"
+        },
+        "width": {
+          "type": "object",
+          "properties": {
+            "min": {
+              "type": "integer"
+            },
+            "max": {
+              "type": "integer"
+            }
+          },
+          "additionalProperties": false
+        },
+        "columns": {
+          "type": "integer"
+        },
+        "margin": {
+          "type": "string"
+        },
+        "content_max_width": {
+          "type": [
+            "integer",
+            "null"
+          ]
+        },
+        "examples": {
+          "type": "string"
+        }
+      },
+      "additionalProperties": false
+    },
+    "platform_size_mapping": {
+      "type": "object",
+      "properties": {
+        "uses": {
+          "type": "string"
+        },
+        "compact": {
+          "type": "string"
+        },
+        "regular": {
+          "type": "string"
+        },
+        "expanded": {
+          "type": "string"
+        }
+      },
+      "additionalProperties": false
+    },
+    "primitive_def": {
+      "type": "object",
+      "properties": {
+        "semantic": {
+          "type": "string"
+        },
+        "props": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "object",
+            "properties": {
+              "type": {
+                "type": "string"
+              },
+              "values": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              },
+              "default": {},
+              "required": {
+                "type": "boolean"
+              }
+            },
+            "additionalProperties": false
+          }
+        },
+        "platform_mapping": {
+          "type": "object",
+          "properties": {
+            "ios": {
+              "type": "string"
+            },
+            "android": {
+              "type": "string"
+            },
+            "web": {
+              "type": "string"
+            }
+          },
+          "additionalProperties": false
+        },
+        "behavior": {
+          "type": "string"
+        }
+      },
+      "additionalProperties": false
+    }
+  }
+}

package/schema/tokens/motion.schema.json

@@ -0,0 +1,83 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openuispec.org/schema/tokens/motion.schema.json",
+  "title": "OpenUISpec Motion Tokens",
+  "description": "Animation durations, easings, reduced motion policy, and motion patterns",
+  "type": "object",
+  "required": [
+    "motion"
+  ],
+  "additionalProperties": false,
+  "properties": {
+    "motion": {
+      "type": "object",
+      "properties": {
+        "duration": {
+          "type": "object",
+          "description": "Named duration values in milliseconds",
+          "additionalProperties": {
+            "type": "integer"
+          }
+        },
+        "easing": {
+          "type": "object",
+          "description": "Named easing curves",
+          "additionalProperties": {
+            "type": "string"
+          }
+        },
+        "reduced_motion": {
+          "type": "string",
+          "description": "Policy for reduced motion preference",
+          "enum": [
+            "remove-animation",
+            "reduce-animation",
+            "respect-system"
+          ]
+        },
+        "patterns": {
+          "type": "object",
+          "description": "Named motion patterns for common interactions",
+          "additionalProperties": {
+            "$ref": "https://openuispec.org/schema/tokens/motion.schema.json#/$defs/motion_pattern"
+          }
+        }
+      },
+      "required": [
+        "duration",
+        "easing"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$defs": {
+    "motion_pattern": {
+      "type": "object",
+      "properties": {
+        "duration": {
+          "type": "string",
+          "description": "Reference to a named duration"
+        },
+        "easing": {
+          "type": "string",
+          "description": "Reference to a named easing"
+        },
+        "property": {
+          "type": "string",
+          "description": "CSS/animated property"
+        },
+        "value": {
+          "type": [
+            "number",
+            "string"
+          ]
+        },
+        "pattern": {
+          "type": "string",
+          "description": "Named animation pattern"
+        }
+      },
+      "additionalProperties": false
+    }
+  }
+}

package/schema/tokens/spacing.schema.json

@@ -0,0 +1,93 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openuispec.org/schema/tokens/spacing.schema.json",
+  "title": "OpenUISpec Spacing Tokens",
+  "description": "Spacing scale, base unit, and aliases",
+  "type": "object",
+  "required": [
+    "spacing"
+  ],
+  "additionalProperties": false,
+  "properties": {
+    "spacing": {
+      "type": "object",
+      "properties": {
+        "base_unit": {
+          "type": "integer",
+          "description": "Base spacing unit in pixels"
+        },
+        "platform_flex": {
+          "type": "number",
+          "description": "Platform flexibility factor (0-1)"
+        },
+        "scale": {
+          "type": "object",
+          "description": "Named spacing scale values",
+          "additionalProperties": {
+            "$ref": "https://openuispec.org/schema/tokens/spacing.schema.json#/$defs/spacing_value"
+          }
+        },
+        "aliases": {
+          "type": "object",
+          "description": "Named spacing aliases for common patterns",
+          "additionalProperties": {
+            "$ref": "https://openuispec.org/schema/tokens/spacing.schema.json#/$defs/alias_value"
+          }
+        }
+      },
+      "required": [
+        "base_unit",
+        "scale"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$defs": {
+    "spacing_value": {
+      "description": "A spacing value \u2014 integer or base+range object",
+      "oneOf": [
+        {
+          "type": "integer"
+        },
+        {
+          "$ref": "https://openuispec.org/schema/defs/common.schema.json#/$defs/range_object"
+        }
+      ]
+    },
+    "alias_value": {
+      "description": "Spacing alias \u2014 a token reference string or object with directional values",
+      "oneOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "object",
+          "properties": {
+            "all": {
+              "type": "string"
+            },
+            "horizontal": {
+              "type": "string"
+            },
+            "vertical": {
+              "type": "string"
+            },
+            "top": {
+              "type": "string"
+            },
+            "bottom": {
+              "type": "string"
+            },
+            "leading": {
+              "type": "string"
+            },
+            "trailing": {
+              "type": "string"
+            }
+          },
+          "additionalProperties": false
+        }
+      ]
+    }
+  }
+}

package/schema/tokens/themes.schema.json

@@ -0,0 +1,92 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openuispec.org/schema/tokens/themes.schema.json",
+  "title": "OpenUISpec Themes",
+  "description": "Theme variants with token overrides and platform capabilities",
+  "type": "object",
+  "required": [
+    "themes"
+  ],
+  "additionalProperties": false,
+  "properties": {
+    "themes": {
+      "type": "object",
+      "properties": {
+        "default": {
+          "type": "string",
+          "description": "Name of the default theme variant"
+        },
+        "variants": {
+          "type": "object",
+          "description": "Named theme variants with token overrides",
+          "additionalProperties": {
+            "$ref": "https://openuispec.org/schema/tokens/themes.schema.json#/$defs/theme_variant"
+          }
+        },
+        "platform": {
+          "type": "object",
+          "description": "Per-platform theme capabilities",
+          "properties": {
+            "ios": {
+              "type": "object",
+              "additionalProperties": true
+            },
+            "android": {
+              "type": "object",
+              "additionalProperties": true
+            },
+            "web": {
+              "type": "object",
+              "additionalProperties": true
+            }
+          },
+          "additionalProperties": false
+        }
+      },
+      "required": [
+        "default",
+        "variants"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$defs": {
+    "theme_variant": {
+      "type": "object",
+      "description": "A theme variant \u2014 keys are dot-notation token paths, values are override objects. 'extends' inherits from another variant.",
+      "properties": {
+        "extends": {
+          "type": "string"
+        }
+      },
+      "additionalProperties": {
+        "description": "Token override \u2014 object with HSL range properties and/or opacity",
+        "type": "object",
+        "properties": {
+          "hue": {
+            "type": [
+              "number",
+              "array"
+            ]
+          },
+          "saturation": {
+            "type": [
+              "number",
+              "array"
+            ]
+          },
+          "lightness": {
+            "type": [
+              "number",
+              "array"
+            ]
+          },
+          "opacity": {
+            "type": "number"
+          }
+        },
+        "additionalProperties": false
+      }
+    }
+  }
+}

package/schema/tokens/typography.schema.json

@@ -0,0 +1,106 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openuispec.org/schema/tokens/typography.schema.json",
+  "title": "OpenUISpec Typography Tokens",
+  "description": "Font families and type scale definitions",
+  "type": "object",
+  "required": [
+    "typography"
+  ],
+  "additionalProperties": false,
+  "properties": {
+    "typography": {
+      "type": "object",
+      "properties": {
+        "font_family": {
+          "type": "object",
+          "description": "Named font family definitions",
+          "additionalProperties": {
+            "$ref": "https://openuispec.org/schema/tokens/typography.schema.json#/$defs/font_family_entry"
+          }
+        },
+        "scale": {
+          "type": "object",
+          "description": "Named type scale entries",
+          "additionalProperties": {
+            "$ref": "https://openuispec.org/schema/tokens/typography.schema.json#/$defs/scale_entry"
+          }
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  "$defs": {
+    "font_family_entry": {
+      "type": "object",
+      "properties": {
+        "semantic": {
+          "type": "string"
+        },
+        "value": {
+          "type": "string"
+        },
+        "fallback_strategy": {
+          "type": "string"
+        },
+        "platform": {
+          "type": "object",
+          "properties": {
+            "ios": {
+              "type": "object",
+              "additionalProperties": true
+            },
+            "android": {
+              "type": "object",
+              "additionalProperties": true
+            },
+            "web": {
+              "type": "object",
+              "additionalProperties": true
+            }
+          },
+          "additionalProperties": false
+        }
+      },
+      "required": [
+        "value"
+      ],
+      "additionalProperties": false
+    },
+    "scale_entry": {
+      "type": "object",
+      "properties": {
+        "semantic": {
+          "type": "string"
+        },
+        "size": {
+          "$ref": "https://openuispec.org/schema/defs/common.schema.json#/$defs/size_value"
+        },
+        "weight": {
+          "type": "integer"
+        },
+        "tracking": {
+          "type": "number"
+        },
+        "line_height": {
+          "type": "number"
+        },
+        "transform": {
+          "type": "string",
+          "enum": [
+            "uppercase",
+            "lowercase",
+            "capitalize",
+            "none"
+          ]
+        }
+      },
+      "required": [
+        "size",
+        "weight",
+        "line_height"
+      ],
+      "additionalProperties": false
+    }
+  }
+}