Skip to content

design.v1 — 1.2.0

Latest

Choose a tag to compare

@HKTITAN HKTITAN released this 06 Aug 16:51

Reference tooling ships, and a five-lens adversarial audit (47 findings, all fixed) hardens the spec, schema, examples, and scripts.

Reference tooling

  • scripts/export_design.py — emits the exports.* artifacts from any .design file: CSS custom properties with mode strategies (media query / data-theme attribute / both, explicit toggle beats OS preference), Tailwind v4 @theme, DTCG JSON, and a shadcn registry:theme item installable in any project.
  • scripts/diff_design.py — SPEC §18 made real: added / removed / modified per token group, component/variant/locked changes, a regression flag, and --fail-on-regression for CI.
  • Both smoke-tested in CI alongside the schema-validating linter.

Audit fixes (highlights)

  • One canonical agent.instructions template — SPEC §8, docs, converter, and every shipped .design file now carry the identical self-teaching block (themes duty, figma rule, §18 verify format, NEVER section); the patch tool re-stamps all files idempotently.
  • Spec correctness: the §15.1.1 example was invalid YAML against the spec's own schema ("transition: all" now quoted); version now validates as real SemVer; write-safety duties are testable and consistent (§3/§23); heading hierarchy and field docs cleaned up.
  • Schema hardening: malformed catalog entries (variants/when as strings) no longer validate through the property-bag branch; nested zIndex; open sources[].type.
  • Safe tooling: the example converter no longer deletes all examples before discovering its inputs are missing on a fresh clone — it aborts with instructions; the linter survives malformed files and reports them instead of crashing; depth checks, omitted parent-path suppression, and {components.*} reference resolution fixed.
  • Example hygiene: descriptions readable (no \uXXXX escapes, no mid-word truncation, refs rewritten, uniform independent-analysis framing); dangling private-pipeline references scrubbed from one upstream analysis.
  • Docs: shadcn diagrams render their line breaks; contradictory claims reconciled; PHILOSOPHY matches the required-agent.instructions reality.

Full details: CHANGELOG.

🤖 Generated with Claude Code