tevra-design-kit 0.0.0-stage → 1.0.0

package/registry/sources.json

@@ -0,0 +1,159 @@
+{
+  "version": 1,
+  "sources": [
+    {
+      "id": "taste-skill",
+      "repository": "https://github.com/Leonxlnx/taste-skill",
+      "revision": "98565e65bc3274ddf6eb0838734341714057178b",
+      "revisionStatus": "content-verified",
+      "inspectedRef": "98565e65bc3274ddf6eb0838734341714057178b",
+      "inspectedAt": "2026-10-23",
+      "license": "MIT",
+      "licenseStatus": "root-text-verified-on-main",
+      "declaredLicense": "MIT",
+      "copyright": "Copyright (c) 2026 Leonxlnx",
+      "reuse": "inspiration",
+      "inspectedPaths": [
+        "skills/taste-skill/SKILL.md",
+        "LICENSE"
+      ],
+      "evidence": [
+        "https://github.com/Leonxlnx/taste-skill/commits/main/",
+        "https://raw.githubusercontent.com/Leonxlnx/taste-skill/main/LICENSE"
+      ],
+      "excludedAssets": [
+        "logos",
+        "screenshots",
+        "fonts",
+        "remote-assets"
+      ],
+      "limitations": [
+        "Full recursive file-level license audit unavailable; no upstream assets or scripts vendored."
+      ]
+    },
+    {
+      "id": "ui-ux-pro-max",
+      "repository": "https://github.com/nextlevelbuilder/ui-ux-pro-max-skill",
+      "revision": "0720614e6e4e2c190f68ff4ab0a71faa0fa70b4a",
+      "revisionStatus": "discovered-content-unavailable",
+      "inspectedRef": "main",
+      "inspectedAt": "2026-10-23",
+      "license": "MIT",
+      "licenseStatus": "root-text-verified-on-main",
+      "declaredLicense": "MIT",
+      "copyright": "Copyright (c) 2024 Next Level Builder",
+      "reuse": "adapted",
+      "inspectedPaths": [
+        "src/ui-ux-pro-max/scripts/core.py",
+        "LICENSE"
+      ],
+      "evidence": [
+        "https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/commits/main/",
+        "https://raw.githubusercontent.com/nextlevelbuilder/ui-ux-pro-max-skill/main/LICENSE"
+      ],
+      "excludedAssets": [
+        "logos",
+        "screenshots",
+        "fonts",
+        "remote-assets"
+      ],
+      "limitations": [
+        "Full recursive file-level license audit unavailable; no upstream assets or scripts vendored.",
+        "Pinned raw content returned cache miss; main inspection is not attributed to this SHA."
+      ]
+    },
+    {
+      "id": "vercel-agent-skills",
+      "repository": "https://github.com/vercel-labs/agent-skills",
+      "revision": "050e24cd7b2d54cef2e9f2f6a39da152dd70fbb5",
+      "revisionStatus": "discovered-content-unavailable",
+      "inspectedRef": "main",
+      "inspectedAt": "2026-10-23",
+      "license": null,
+      "licenseStatus": "metadata-only",
+      "declaredLicense": "MIT",
+      "copyright": null,
+      "reuse": "inspiration",
+      "inspectedPaths": [
+        "skills/react-best-practices/SKILL.md",
+        "LICENSE"
+      ],
+      "evidence": [
+        "https://github.com/vercel-labs/agent-skills/commits/main/",
+        "https://raw.githubusercontent.com/vercel-labs/agent-skills/main/skills/react-best-practices/SKILL.md"
+      ],
+      "excludedAssets": [
+        "logos",
+        "screenshots",
+        "fonts",
+        "remote-assets"
+      ],
+      "limitations": [
+        "Full recursive file-level license audit unavailable; no upstream assets or scripts vendored.",
+        "Pinned raw content returned cache miss; main inspection is not attributed to this SHA."
+      ]
+    },
+    {
+      "id": "web-quality-skills",
+      "repository": "https://github.com/addyosmani/web-quality-skills",
+      "revision": "c3cd7e0443125c55237d50105cdc8454e9e8f83d",
+      "revisionStatus": "discovered-content-unavailable",
+      "inspectedRef": "main",
+      "inspectedAt": "2026-10-23",
+      "license": "MIT",
+      "licenseStatus": "root-text-verified-on-main",
+      "declaredLicense": "MIT",
+      "copyright": "Copyright (c) 2026 Addy Osmani",
+      "reuse": "inspiration",
+      "inspectedPaths": [
+        "skills/performance/SKILL.md",
+        "LICENSE"
+      ],
+      "evidence": [
+        "https://github.com/addyosmani/web-quality-skills/commits/main/",
+        "https://raw.githubusercontent.com/addyosmani/web-quality-skills/main/LICENSE"
+      ],
+      "excludedAssets": [
+        "logos",
+        "screenshots",
+        "fonts",
+        "remote-assets"
+      ],
+      "limitations": [
+        "Full recursive file-level license audit unavailable; no upstream assets or scripts vendored.",
+        "Pinned raw content returned cache miss; main inspection is not attributed to this SHA."
+      ]
+    },
+    {
+      "id": "playwright",
+      "repository": "https://github.com/microsoft/playwright",
+      "revision": "14c2dcf1ec955532aa861ecd039b23b9acc53a97",
+      "revisionStatus": "discovered-content-unavailable",
+      "inspectedRef": "main",
+      "inspectedAt": "2026-10-23",
+      "license": "Apache-2.0",
+      "licenseStatus": "root-text-verified-on-main",
+      "declaredLicense": "Apache-2.0",
+      "copyright": "Copyright (c) Microsoft Corporation",
+      "reuse": "dependency",
+      "inspectedPaths": [
+        "packages/playwright/package.json",
+        "LICENSE"
+      ],
+      "evidence": [
+        "https://github.com/microsoft/playwright/commits/main/",
+        "https://raw.githubusercontent.com/microsoft/playwright/main/LICENSE"
+      ],
+      "excludedAssets": [
+        "logos",
+        "screenshots",
+        "fonts",
+        "remote-assets"
+      ],
+      "limitations": [
+        "Full recursive file-level license audit unavailable; no upstream assets or scripts vendored.",
+        "Pinned raw content returned cache miss; main inspection is not attributed to this SHA."
+      ]
+    }
+  ]
+}

package/rubrics/quality-rubric.md

@@ -0,0 +1,24 @@
+# Evidence-based quality rubric
+
+| Category | Default weight | Evidence |
+| --- | ---: | --- |
+| Visual hierarchy | 15 | Purpose and next action clear at tested widths |
+| Typography | 10 | Readable roles, locale glyphs and content fit |
+| Layout and spacing | 15 | Deliberate grouping without clipping |
+| Design consistency | 15 | Approved tokens, components and states |
+| Responsive behavior | 15 | Real viewport/state evidence |
+| Accessibility | 15 | Automated plus executed manual checks |
+| Interaction quality | 10 | Real behavior, feedback and recovery |
+| Performance | 5 | Measurements or clearly bounded source evidence |
+
+Weights are configurable and total 100. Scores 0–4 describe judgment: 0 task blocked, 1 major issues, 2 partial usability, 3 scoped criteria met, 4 demonstrated strengths. Every executed check needs evidence. Scores below 3 require specific findings and corrections. Missing categories remain unscored.
+
+Separate deterministic tests, automated heuristics, AI-assisted judgment and human approval. The engine uses the lowest submitted score per category, weights it on a 100-point scale, and defaults to threshold 75. Arithmetic is deterministic; aesthetic judgments remain subjective. Explicit minScore 0 allows an automation-only gate while keeping missing scores unscored.
+
+Failed critical checks always block. Required IDs must actually pass: visual-diff, axe, overflow and functional-tests by default. Missing/unverified required checks block. Pixel changes may be intentional; review and approve them before replacing a baseline. Never average away functional failures or severe accessibility barriers.
+
+Unexecuted screen-reader, native, motion and performance checks stay visible. Automated PASS never establishes complete WCAG compliance.
+
+## Default weights
+
+Hierarchy 15, typography 10, layout 15, consistency 10, responsive 15, accessibility 15, functional 10 and performance 10. Legacy `interaction` scores remain accepted for existing configurations with a default weight of zero. Existing project weights are preserved. Performance metric checks have no subjective design score. Required/critical failures and missing required evidence still block PASS regardless of aggregate score.

package/schemas/capability-ownership.schema.json

@@ -0,0 +1,69 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "version",
+    "capabilities"
+  ],
+  "properties": {
+    "version": {
+      "const": 1
+    },
+    "capabilities": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "id",
+          "primary",
+          "supporting",
+          "stage",
+          "constraints",
+          "validation"
+        ],
+        "properties": {
+          "id": {
+            "type": "string",
+            "minLength": 1
+          },
+          "primary": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "supporting": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1
+            },
+            "uniqueItems": true
+          },
+          "stage": {
+            "type": "integer",
+            "minimum": 1
+          },
+          "constraints": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1
+            },
+            "uniqueItems": true
+          },
+          "validation": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1
+            },
+            "uniqueItems": true
+          }
+        }
+      }
+    }
+  }
+}

package/schemas/capture-manifest.schema.json

@@ -0,0 +1,209 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "version": {
+      "const": 1
+    },
+    "kind": {
+      "enum": [
+        "baseline",
+        "current"
+      ]
+    },
+    "createdAt": {
+      "type": "string",
+      "minLength": 1,
+      "format": "date-time"
+    },
+    "configHash": {
+      "type": "string",
+      "minLength": 1
+    },
+    "contextRevision": {
+      "type": "integer",
+      "minimum": 0,
+      "maximum": 1000000
+    },
+    "browserVersion": {
+      "type": "string",
+      "minLength": 1
+    },
+    "entries": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "id": {
+            "type": "string",
+            "pattern": "^[a-z0-9-]+$"
+          },
+          "route": {
+            "type": "string",
+            "minLength": 1
+          },
+          "state": {
+            "type": "string",
+            "minLength": 1
+          },
+          "viewport": {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+              "name": {
+                "type": "string",
+                "minLength": 1
+              },
+              "width": {
+                "type": "integer",
+                "minimum": 240,
+                "maximum": 7680
+              },
+              "height": {
+                "type": "integer",
+                "minimum": 240,
+                "maximum": 4320
+              }
+            },
+            "required": [
+              "name",
+              "width",
+              "height"
+            ]
+          },
+          "file": {
+            "type": "string",
+            "minLength": 1
+          },
+          "masks": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1
+            },
+            "minItems": 0
+          },
+          "overflow": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1
+            },
+            "minItems": 0
+          },
+          "smallTargets": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1
+            },
+            "minItems": 0
+          },
+          "axeViolations": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "additionalProperties": false,
+              "properties": {
+                "id": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "impact": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "targets": {
+                  "type": "array",
+                  "items": {
+                    "type": "string",
+                    "minLength": 1
+                  },
+                  "minItems": 0
+                },
+                "help": {
+                  "type": "string",
+                  "minLength": 1
+                }
+              },
+              "required": [
+                "id",
+                "impact",
+                "targets",
+                "help"
+              ]
+            },
+            "minItems": 0
+          },
+          "incompleteRules": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1
+            },
+            "minItems": 0
+          },
+          "pageErrors": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1
+            },
+            "minItems": 0
+          },
+          "imageHash": {
+            "type": "string",
+            "pattern": "^[a-f0-9]{64}$"
+          },
+          "consoleErrors": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "networkErrors": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "assertions": {
+            "type": "integer",
+            "minimum": 0
+          }
+        },
+        "required": [
+          "id",
+          "route",
+          "state",
+          "viewport",
+          "file",
+          "masks",
+          "overflow",
+          "smallTargets",
+          "axeViolations",
+          "incompleteRules",
+          "pageErrors",
+          "imageHash"
+        ]
+      },
+      "minItems": 1
+    },
+    "runId": {
+      "type": "string",
+      "minLength": 1
+    }
+  },
+  "required": [
+    "version",
+    "kind",
+    "createdAt",
+    "configHash",
+    "contextRevision",
+    "browserVersion",
+    "entries",
+    "runId"
+  ]
+}

package/schemas/checks.schema.json

@@ -0,0 +1,83 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "array",
+  "items": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "id": {
+        "type": "string",
+        "minLength": 1
+      },
+      "category": {
+        "enum": [
+          "hierarchy",
+          "typography",
+          "layout",
+          "consistency",
+          "responsive",
+          "accessibility",
+          "interaction",
+          "performance",
+          "functional"
+        ]
+      },
+      "kind": {
+        "enum": [
+          "deterministic",
+          "heuristic",
+          "ai",
+          "human"
+        ]
+      },
+      "status": {
+        "enum": [
+          "passed",
+          "failed",
+          "unverified"
+        ]
+      },
+      "severity": {
+        "enum": [
+          "critical",
+          "major",
+          "minor"
+        ]
+      },
+      "score": {
+        "type": "number",
+        "minimum": 0,
+        "maximum": 4
+      },
+      "evidence": {
+        "type": "array",
+        "items": {
+          "type": "string",
+          "minLength": 1
+        },
+        "minItems": 0
+      },
+      "issue": {
+        "type": "string"
+      },
+      "component": {
+        "type": "string"
+      },
+      "correction": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "id",
+      "category",
+      "kind",
+      "status",
+      "severity",
+      "evidence",
+      "issue",
+      "component",
+      "correction"
+    ]
+  },
+  "minItems": 0
+}

package/schemas/comparison.schema.json

@@ -0,0 +1,154 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "version": {
+      "const": 1
+    },
+    "createdAt": {
+      "type": "string",
+      "minLength": 1,
+      "format": "date-time"
+    },
+    "comparisons": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "id": {
+            "type": "string",
+            "minLength": 1
+          },
+          "ratio": {
+            "type": "number",
+            "minimum": 0,
+            "maximum": 1
+          },
+          "differentPixels": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 40000000
+          },
+          "sizeMismatch": {
+            "type": "boolean"
+          },
+          "diff": {
+            "type": "string",
+            "minLength": 1
+          },
+          "passed": {
+            "type": "boolean"
+          }
+        },
+        "required": [
+          "id",
+          "ratio",
+          "differentPixels",
+          "sizeMismatch",
+          "diff",
+          "passed"
+        ]
+      },
+      "minItems": 1
+    },
+    "checks": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "id": {
+            "type": "string",
+            "minLength": 1
+          },
+          "category": {
+            "enum": [
+              "hierarchy",
+              "typography",
+              "layout",
+              "consistency",
+              "responsive",
+              "accessibility",
+              "interaction",
+              "performance"
+            ]
+          },
+          "kind": {
+            "enum": [
+              "deterministic",
+              "heuristic",
+              "ai",
+              "human"
+            ]
+          },
+          "status": {
+            "enum": [
+              "passed",
+              "failed",
+              "unverified"
+            ]
+          },
+          "severity": {
+            "enum": [
+              "critical",
+              "major",
+              "minor"
+            ]
+          },
+          "score": {
+            "type": "number",
+            "minimum": 0,
+            "maximum": 4
+          },
+          "evidence": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1
+            },
+            "minItems": 0
+          },
+          "issue": {
+            "type": "string"
+          },
+          "component": {
+            "type": "string"
+          },
+          "correction": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "id",
+          "category",
+          "kind",
+          "status",
+          "severity",
+          "evidence",
+          "issue",
+          "component",
+          "correction"
+        ]
+      },
+      "minItems": 1
+    },
+    "currentManifestHash": {
+      "type": "string",
+      "minLength": 1
+    },
+    "settingsHash": {
+      "type": "string",
+      "minLength": 1
+    }
+  },
+  "required": [
+    "version",
+    "createdAt",
+    "comparisons",
+    "checks",
+    "currentManifestHash",
+    "settingsHash"
+  ]
+}