@litfamily/litopencode 1.0.0

package/skills/frontend-ui-ux/schemas/design-contract-v1alpha1.json

@@ -0,0 +1,570 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "litfamily.design-contract/v1alpha1",
+  "title": "LitFamily Design Contract v1alpha1",
+  "description": "Shape reference for the Design Contract. The executable rules live in skills/frontend-ui-ux/scripts/design-contract.mjs; this document cannot express typed id prefixes, referential integrity, authenticated-surface coupling, global id uniqueness, duplicate-key rejection, or canonical hashing.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_id",
+    "contract_id",
+    "source_hash",
+    "intent",
+    "direction",
+    "inventory",
+    "accessibility",
+    "localization",
+    "performance",
+    "evidence_policy",
+    "omissions",
+    "accepted_exceptions"
+  ],
+  "properties": {
+    "schema_id": {
+      "const": "litfamily.design-contract/v1alpha1"
+    },
+    "contract_id": {
+      "$ref": "#/$defs/id"
+    },
+    "source_hash": {
+      "$ref": "#/$defs/hash"
+    },
+    "intent": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "audiences",
+        "tasks",
+        "qualities",
+        "constraints",
+        "non_goals"
+      ],
+      "properties": {
+        "audiences": {
+          "$ref": "#/$defs/required_lines"
+        },
+        "tasks": {
+          "$ref": "#/$defs/required_lines"
+        },
+        "qualities": {
+          "$ref": "#/$defs/required_lines"
+        },
+        "constraints": {
+          "$ref": "#/$defs/optional_lines"
+        },
+        "non_goals": {
+          "$ref": "#/$defs/optional_lines"
+        }
+      }
+    },
+    "direction": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "name",
+        "principles",
+        "token_strategy",
+        "voice"
+      ],
+      "properties": {
+        "name": {
+          "$ref": "#/$defs/line"
+        },
+        "principles": {
+          "type": "array",
+          "minItems": 3,
+          "maxItems": 7,
+          "uniqueItems": true,
+          "items": {
+            "$ref": "#/$defs/line"
+          }
+        },
+        "token_strategy": {
+          "enum": [
+            "reuse",
+            "extend",
+            "create"
+          ]
+        },
+        "voice": {
+          "$ref": "#/$defs/line"
+        }
+      }
+    },
+    "inventory": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "routes",
+        "regions",
+        "components",
+        "interactions",
+        "states",
+        "viewports",
+        "references",
+        "authenticated_surfaces"
+      ],
+      "properties": {
+        "routes": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "id",
+              "path",
+              "primary",
+              "auth_required"
+            ],
+            "properties": {
+              "id": {
+                "$ref": "#/$defs/id"
+              },
+              "path": {
+                "$ref": "#/$defs/line"
+              },
+              "primary": {
+                "type": "boolean"
+              },
+              "auth_required": {
+                "type": "boolean"
+              }
+            }
+          }
+        },
+        "regions": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "id",
+              "route_id"
+            ],
+            "properties": {
+              "id": {
+                "$ref": "#/$defs/id"
+              },
+              "route_id": {
+                "$ref": "#/$defs/id"
+              }
+            }
+          }
+        },
+        "components": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "id",
+              "region_id"
+            ],
+            "properties": {
+              "id": {
+                "$ref": "#/$defs/id"
+              },
+              "region_id": {
+                "$ref": "#/$defs/id"
+              }
+            }
+          }
+        },
+        "interactions": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "id",
+              "route_id",
+              "critical",
+              "input_modes"
+            ],
+            "properties": {
+              "id": {
+                "$ref": "#/$defs/id"
+              },
+              "route_id": {
+                "$ref": "#/$defs/id"
+              },
+              "critical": {
+                "type": "boolean"
+              },
+              "input_modes": {
+                "type": "array",
+                "minItems": 1,
+                "uniqueItems": true,
+                "items": {
+                  "enum": [
+                    "keyboard",
+                    "pointer",
+                    "touch",
+                    "voice",
+                    "switch"
+                  ]
+                }
+              }
+            }
+          }
+        },
+        "states": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "id",
+              "route_id",
+              "kind"
+            ],
+            "properties": {
+              "id": {
+                "$ref": "#/$defs/id"
+              },
+              "route_id": {
+                "$ref": "#/$defs/id"
+              },
+              "kind": {
+                "enum": [
+                  "loading",
+                  "empty",
+                  "error",
+                  "success",
+                  "disabled",
+                  "permission",
+                  "offline",
+                  "ready"
+                ]
+              }
+            }
+          }
+        },
+        "viewports": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "id",
+              "width",
+              "height",
+              "category"
+            ],
+            "properties": {
+              "id": {
+                "$ref": "#/$defs/id"
+              },
+              "width": {
+                "type": "integer",
+                "minimum": 240,
+                "maximum": 16384
+              },
+              "height": {
+                "type": "integer",
+                "minimum": 240,
+                "maximum": 16384
+              },
+              "category": {
+                "enum": [
+                  "compact",
+                  "medium",
+                  "expanded"
+                ]
+              }
+            }
+          }
+        },
+        "references": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "id",
+              "sha256",
+              "kind",
+              "label"
+            ],
+            "properties": {
+              "id": {
+                "$ref": "#/$defs/id"
+              },
+              "sha256": {
+                "$ref": "#/$defs/hash"
+              },
+              "kind": {
+                "enum": [
+                  "user-provided",
+                  "repo-local",
+                  "generated",
+                  "measured"
+                ]
+              },
+              "label": {
+                "$ref": "#/$defs/line"
+              }
+            }
+          }
+        },
+        "authenticated_surfaces": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "route_id",
+              "owner",
+              "safe_test_account"
+            ],
+            "properties": {
+              "route_id": {
+                "$ref": "#/$defs/id"
+              },
+              "owner": {
+                "$ref": "#/$defs/line"
+              },
+              "safe_test_account": {
+                "type": "boolean"
+              }
+            }
+          }
+        }
+      }
+    },
+    "accessibility": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "target",
+        "keyboard",
+        "screen_reader",
+        "reduced_motion",
+        "forced_colors",
+        "zoom_percent"
+      ],
+      "properties": {
+        "target": {
+          "const": "WCAG 2.2 AA"
+        },
+        "keyboard": {
+          "type": "boolean"
+        },
+        "screen_reader": {
+          "type": "boolean"
+        },
+        "reduced_motion": {
+          "type": "boolean"
+        },
+        "forced_colors": {
+          "type": "boolean"
+        },
+        "zoom_percent": {
+          "type": "integer",
+          "minimum": 200,
+          "maximum": 400
+        }
+      }
+    },
+    "localization": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "locales",
+        "text_expansion_percent",
+        "cjk_line_break_review",
+        "font_fallback_review",
+        "ime_review",
+        "rtl_review"
+      ],
+      "properties": {
+        "locales": {
+          "$ref": "#/$defs/required_lines"
+        },
+        "text_expansion_percent": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 300
+        },
+        "cjk_line_break_review": {
+          "type": "boolean"
+        },
+        "font_fallback_review": {
+          "type": "boolean"
+        },
+        "ime_review": {
+          "type": "boolean"
+        },
+        "rtl_review": {
+          "type": "boolean"
+        }
+      }
+    },
+    "performance": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "lcp_ms",
+        "cls",
+        "inp_ms",
+        "initial_js_kb",
+        "initial_css_kb"
+      ],
+      "properties": {
+        "lcp_ms": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 60000
+        },
+        "cls": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 1
+        },
+        "inp_ms": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 60000
+        },
+        "initial_js_kb": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 1048576
+        },
+        "initial_css_kb": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 1048576
+        }
+      }
+    },
+    "evidence_policy": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "independent_review_required",
+        "required_channels",
+        "cleanup_required"
+      ],
+      "properties": {
+        "independent_review_required": {
+          "type": "boolean"
+        },
+        "required_channels": {
+          "type": "array",
+          "minItems": 1,
+          "uniqueItems": true,
+          "items": {
+            "enum": [
+              "tests",
+              "browser",
+              "keyboard",
+              "accessibility-tree",
+              "screen-reader",
+              "performance",
+              "localization"
+            ]
+          }
+        },
+        "cleanup_required": {
+          "type": "boolean"
+        }
+      }
+    },
+    "omissions": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/deviation"
+      }
+    },
+    "accepted_exceptions": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/accepted_exception"
+      }
+    }
+  },
+  "$defs": {
+    "id": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9-]*:[a-z0-9][a-z0-9._/-]*$"
+    },
+    "hash": {
+      "type": "string",
+      "pattern": "^[0-9a-f]{64}$"
+    },
+    "line": {
+      "type": "string",
+      "minLength": 1,
+      "pattern": "^[^\\u0000-\\u001f\\u007f]+$"
+    },
+    "required_lines": {
+      "type": "array",
+      "minItems": 1,
+      "uniqueItems": true,
+      "items": {
+        "$ref": "#/$defs/line"
+      }
+    },
+    "optional_lines": {
+      "type": "array",
+      "uniqueItems": true,
+      "items": {
+        "$ref": "#/$defs/line"
+      }
+    },
+    "deviation": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "id",
+        "reason",
+        "owner"
+      ],
+      "properties": {
+        "id": {
+          "$ref": "#/$defs/id"
+        },
+        "reason": {
+          "$ref": "#/$defs/line"
+        },
+        "owner": {
+          "$ref": "#/$defs/line"
+        },
+        "expires_at": {
+          "type": "string",
+          "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{3})?Z$"
+        }
+      }
+    },
+    "accepted_exception": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "id",
+        "reason",
+        "owner",
+        "expires_at"
+      ],
+      "properties": {
+        "id": {
+          "$ref": "#/$defs/id"
+        },
+        "reason": {
+          "$ref": "#/$defs/line"
+        },
+        "owner": {
+          "$ref": "#/$defs/line"
+        },
+        "expires_at": {
+          "type": "string",
+          "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{3})?Z$"
+        }
+      }
+    }
+  }
+}

package/skills/frontend-ui-ux/schemas/design-contract-v1beta1.json

@@ -0,0 +1,32 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "litfamily.design-contract/v1beta1",
+  "title": "LitFamily Design Contract v1beta1",
+  "description": "Additive beta shape; the OpenCode-installed validator enforces base and referential rules.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_id", "contract_id", "source_hash", "intent", "direction", "inventory", "accessibility", "localization", "performance", "evidence_policy", "omissions", "accepted_exceptions", "lane", "tokens", "component_behaviors", "responsive_transformations", "motion", "acceptance_criteria"],
+  "properties": {
+    "schema_id": { "const": "litfamily.design-contract/v1beta1" },
+    "contract_id": { "$ref": "#/$defs/id" }, "source_hash": { "$ref": "#/$defs/hash" },
+    "intent": { "type": "object" }, "direction": { "type": "object" }, "inventory": { "type": "object" },
+    "accessibility": { "type": "object" }, "localization": { "type": "object" }, "performance": { "type": "object" },
+    "evidence_policy": { "type": "object" }, "omissions": { "type": "array" }, "accepted_exceptions": { "type": "array" },
+    "lane": { "enum": ["new-build", "brownfield", "redesign", "reference-fidelity", "design-system"] },
+    "tokens": { "type": "array", "minItems": 1, "items": { "$ref": "#/$defs/token" } },
+    "component_behaviors": { "type": "array", "minItems": 1, "items": { "$ref": "#/$defs/componentBehavior" } },
+    "responsive_transformations": { "type": "array", "minItems": 1, "items": { "$ref": "#/$defs/responsiveTransformation" } },
+    "motion": { "$ref": "#/$defs/motion" },
+    "acceptance_criteria": { "type": "array", "minItems": 1, "items": { "$ref": "#/$defs/criterion" } }
+  },
+  "$defs": {
+    "id": { "type": "string", "pattern": "^[a-z][a-z0-9-]*:[a-z0-9][a-z0-9._/-]*$" }, "hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "text": { "type": "string", "minLength": 1, "maxLength": 512 },
+    "idList": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "$ref": "#/$defs/id" } },
+    "token": { "type": "object", "additionalProperties": false, "required": ["id", "category", "value", "usage"], "properties": { "id": { "type": "string", "pattern": "^token:[a-z0-9][a-z0-9._/-]*$" }, "category": { "enum": ["color", "typography", "spacing", "radius", "shadow", "motion", "other"] }, "value": { "$ref": "#/$defs/text" }, "usage": { "$ref": "#/$defs/text" } } },
+    "componentBehavior": { "type": "object", "additionalProperties": false, "required": ["component_id", "state_ids", "interaction_ids", "keyboard_behavior"], "properties": { "component_id": { "type": "string", "pattern": "^component:[a-z0-9][a-z0-9._/-]*$" }, "state_ids": { "$ref": "#/$defs/idList" }, "interaction_ids": { "$ref": "#/$defs/idList" }, "keyboard_behavior": { "$ref": "#/$defs/text" } } },
+    "responsiveTransformation": { "type": "object", "additionalProperties": false, "required": ["route_id", "viewport_id", "behavior"], "properties": { "route_id": { "type": "string", "pattern": "^route:[a-z0-9][a-z0-9._/-]*$" }, "viewport_id": { "type": "string", "pattern": "^viewport:[a-z0-9][a-z0-9._/-]*$" }, "behavior": { "$ref": "#/$defs/text" } } },
+    "motion": { "type": "object", "additionalProperties": false, "required": ["policy", "reduced_motion_behavior", "transitions"], "properties": { "policy": { "enum": ["none", "functional", "expressive"] }, "reduced_motion_behavior": { "$ref": "#/$defs/text" }, "transitions": { "type": "array", "items": { "$ref": "#/$defs/transition" } } } },
+    "transition": { "type": "object", "additionalProperties": false, "required": ["id", "interaction_id", "duration_ms", "easing"], "properties": { "id": { "type": "string", "pattern": "^transition:[a-z0-9][a-z0-9._/-]*$" }, "interaction_id": { "type": "string", "pattern": "^interaction:[a-z0-9][a-z0-9._/-]*$" }, "duration_ms": { "type": "integer", "minimum": 0, "maximum": 10000 }, "easing": { "$ref": "#/$defs/text" } } },
+    "criterion": { "type": "object", "additionalProperties": false, "required": ["id", "observable", "verification", "required", "inventory_ids"], "properties": { "id": { "type": "string", "pattern": "^criterion:[a-z0-9][a-z0-9._/-]*$" }, "observable": { "$ref": "#/$defs/text" }, "verification": { "enum": ["tests", "browser", "keyboard", "accessibility-tree", "screen-reader", "performance", "localization", "manual"] }, "required": { "const": true }, "inventory_ids": { "$ref": "#/$defs/idList" } } }
+  }
+}

package/skills/frontend-ui-ux/schemas/design-contract-v1beta2.json

@@ -0,0 +1,34 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "litfamily.design-contract/v1beta2",
+  "title": "LitFamily Design Contract v1beta2",
+  "description": "v1beta1 plus one optional taste object and nothing else. Every valid v1beta1 document stays valid after changing schema_id, and a v1beta2 document that omits taste is complete. The OpenCode-installed validator enforces base, referential, and dial rules.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_id", "contract_id", "source_hash", "intent", "direction", "inventory", "accessibility", "localization", "performance", "evidence_policy", "omissions", "accepted_exceptions", "lane", "tokens", "component_behaviors", "responsive_transformations", "motion", "acceptance_criteria"],
+  "properties": {
+    "schema_id": { "const": "litfamily.design-contract/v1beta2" },
+    "contract_id": { "$ref": "#/$defs/id" }, "source_hash": { "$ref": "#/$defs/hash" },
+    "intent": { "type": "object" }, "direction": { "type": "object" }, "inventory": { "type": "object" },
+    "accessibility": { "type": "object" }, "localization": { "type": "object" }, "performance": { "type": "object" },
+    "evidence_policy": { "type": "object" }, "omissions": { "type": "array" }, "accepted_exceptions": { "type": "array" },
+    "lane": { "enum": ["new-build", "brownfield", "redesign", "reference-fidelity", "design-system"] },
+    "tokens": { "type": "array", "minItems": 1, "items": { "$ref": "#/$defs/token" } },
+    "component_behaviors": { "type": "array", "minItems": 1, "items": { "$ref": "#/$defs/componentBehavior" } },
+    "responsive_transformations": { "type": "array", "minItems": 1, "items": { "$ref": "#/$defs/responsiveTransformation" } },
+    "motion": { "$ref": "#/$defs/motion" },
+    "acceptance_criteria": { "type": "array", "minItems": 1, "items": { "$ref": "#/$defs/criterion" } },
+    "taste": { "$ref": "#/$defs/taste" }
+  },
+  "$defs": {
+    "taste": { "type": "object", "additionalProperties": false, "required": ["variance", "motion", "density"], "properties": { "variance": { "type": "integer", "minimum": 1, "maximum": 10, "description": "How far layout and composition may depart from the most conventional arrangement." }, "motion": { "type": "integer", "minimum": 1, "maximum": 10, "description": "How much meaning animation carries, bounded independently of motion.policy, which decides whether motion is permitted at all." }, "density": { "type": "integer", "minimum": 1, "maximum": 10, "description": "How much information occupies a given area before the layout is considered crowded." } } },
+    "id": { "type": "string", "pattern": "^[a-z][a-z0-9-]*:[a-z0-9][a-z0-9._/-]*$" }, "hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "text": { "type": "string", "minLength": 1, "maxLength": 512 },
+    "idList": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "$ref": "#/$defs/id" } },
+    "token": { "type": "object", "additionalProperties": false, "required": ["id", "category", "value", "usage"], "properties": { "id": { "type": "string", "pattern": "^token:[a-z0-9][a-z0-9._/-]*$" }, "category": { "enum": ["color", "typography", "spacing", "radius", "shadow", "motion", "other"] }, "value": { "$ref": "#/$defs/text" }, "usage": { "$ref": "#/$defs/text" } } },
+    "componentBehavior": { "type": "object", "additionalProperties": false, "required": ["component_id", "state_ids", "interaction_ids", "keyboard_behavior"], "properties": { "component_id": { "type": "string", "pattern": "^component:[a-z0-9][a-z0-9._/-]*$" }, "state_ids": { "$ref": "#/$defs/idList" }, "interaction_ids": { "$ref": "#/$defs/idList" }, "keyboard_behavior": { "$ref": "#/$defs/text" } } },
+    "responsiveTransformation": { "type": "object", "additionalProperties": false, "required": ["route_id", "viewport_id", "behavior"], "properties": { "route_id": { "type": "string", "pattern": "^route:[a-z0-9][a-z0-9._/-]*$" }, "viewport_id": { "type": "string", "pattern": "^viewport:[a-z0-9][a-z0-9._/-]*$" }, "behavior": { "$ref": "#/$defs/text" } } },
+    "motion": { "type": "object", "additionalProperties": false, "required": ["policy", "reduced_motion_behavior", "transitions"], "properties": { "policy": { "enum": ["none", "functional", "expressive"] }, "reduced_motion_behavior": { "$ref": "#/$defs/text" }, "transitions": { "type": "array", "items": { "$ref": "#/$defs/transition" } } } },
+    "transition": { "type": "object", "additionalProperties": false, "required": ["id", "interaction_id", "duration_ms", "easing"], "properties": { "id": { "type": "string", "pattern": "^transition:[a-z0-9][a-z0-9._/-]*$" }, "interaction_id": { "type": "string", "pattern": "^interaction:[a-z0-9][a-z0-9._/-]*$" }, "duration_ms": { "type": "integer", "minimum": 0, "maximum": 10000 }, "easing": { "$ref": "#/$defs/text" } } },
+    "criterion": { "type": "object", "additionalProperties": false, "required": ["id", "observable", "verification", "required", "inventory_ids"], "properties": { "id": { "type": "string", "pattern": "^criterion:[a-z0-9][a-z0-9._/-]*$" }, "observable": { "$ref": "#/$defs/text" }, "verification": { "enum": ["tests", "browser", "keyboard", "accessibility-tree", "screen-reader", "performance", "localization", "manual"] }, "required": { "const": true }, "inventory_ids": { "$ref": "#/$defs/idList" } } }
+  }
+}