@litfamily/litcodex 1.0.29 → 1.0.31

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (388) hide show
  1. package/README-Ko-KR.md +11 -11
  2. package/README.md +11 -11
  3. package/dist/install/generated-skill-payload-hashes.d.ts +191 -85
  4. package/dist/install/generated-skill-payload-hashes.js +191 -85
  5. package/dist/install/marketplace.js +10 -1
  6. package/dist/install/skill-catalog.d.ts +1 -1
  7. package/dist/install/skill-catalog.js +12 -1
  8. package/dist/install/skill-resource-hashes.d.ts +1 -1
  9. package/dist/install/skill-resource-hashes.js +1 -1
  10. package/marketplace/.agents/plugins/marketplace.json +4 -1
  11. package/marketplace/plugins/litcodex/.codex-plugin/plugin.json +14 -2
  12. package/marketplace/plugins/litcodex/assets/screenshot-lit-ignited.png +0 -0
  13. package/marketplace/plugins/litcodex/components/auto-update/package.json +1 -1
  14. package/marketplace/plugins/litcodex/components/comment-checker/package.json +1 -1
  15. package/marketplace/plugins/litcodex/components/git-bash/package.json +1 -1
  16. package/marketplace/plugins/litcodex/components/lit-loop/directive.md +10 -4
  17. package/marketplace/plugins/litcodex/components/lit-loop/directives/lit-adhd.md +191 -0
  18. package/marketplace/plugins/litcodex/components/lit-loop/directives/lit-handoff.md +2 -0
  19. package/marketplace/plugins/litcodex/components/lit-loop/directives/lit-hijack.md +219 -0
  20. package/marketplace/plugins/litcodex/components/lit-loop/directives/lit-recap.md +2 -0
  21. package/marketplace/plugins/litcodex/components/lit-loop/directives/lit-schematic.md +199 -0
  22. package/marketplace/plugins/litcodex/components/lit-loop/directives/litwork.md +2 -1
  23. package/marketplace/plugins/litcodex/components/lit-loop/dist/adhd-suggest.d.ts +10 -0
  24. package/marketplace/plugins/litcodex/components/lit-loop/dist/adhd-suggest.js +67 -0
  25. package/marketplace/plugins/litcodex/components/lit-loop/dist/card-html.d.ts +1 -1
  26. package/marketplace/plugins/litcodex/components/lit-loop/dist/card-html.js +128 -8
  27. package/marketplace/plugins/litcodex/components/lit-loop/dist/card-looks.d.ts +19 -0
  28. package/marketplace/plugins/litcodex/components/lit-loop/dist/card-looks.js +58 -0
  29. package/marketplace/plugins/litcodex/components/lit-loop/dist/card-status.d.ts +27 -0
  30. package/marketplace/plugins/litcodex/components/lit-loop/dist/card-status.js +94 -7
  31. package/marketplace/plugins/litcodex/components/lit-loop/dist/cli.js +13 -3
  32. package/marketplace/plugins/litcodex/components/lit-loop/dist/codex-hook.d.ts +2 -0
  33. package/marketplace/plugins/litcodex/components/lit-loop/dist/codex-hook.js +8 -9
  34. package/marketplace/plugins/litcodex/components/lit-loop/dist/control-chars.d.ts +5 -0
  35. package/marketplace/plugins/litcodex/components/lit-loop/dist/control-chars.js +23 -0
  36. package/marketplace/plugins/litcodex/components/lit-loop/dist/hook-cli.d.ts +8 -0
  37. package/marketplace/plugins/litcodex/components/lit-loop/dist/hook-cli.js +118 -11
  38. package/marketplace/plugins/litcodex/components/lit-loop/dist/hud.d.ts +1 -1
  39. package/marketplace/plugins/litcodex/components/lit-loop/dist/hud.js +29 -13
  40. package/marketplace/plugins/litcodex/components/lit-loop/dist/lane-events.d.ts +13 -0
  41. package/marketplace/plugins/litcodex/components/lit-loop/dist/lane-events.js +85 -0
  42. package/marketplace/plugins/litcodex/components/lit-loop/dist/lane-state.d.ts +55 -0
  43. package/marketplace/plugins/litcodex/components/lit-loop/dist/lane-state.js +227 -0
  44. package/marketplace/plugins/litcodex/components/lit-loop/dist/live-step.d.ts +5 -1
  45. package/marketplace/plugins/litcodex/components/lit-loop/dist/live-step.js +17 -1
  46. package/marketplace/plugins/litcodex/components/lit-loop/dist/markers.d.ts +6 -0
  47. package/marketplace/plugins/litcodex/components/lit-loop/dist/markers.js +6 -0
  48. package/marketplace/plugins/litcodex/components/lit-loop/dist/modes.d.ts +1 -1
  49. package/marketplace/plugins/litcodex/components/lit-loop/dist/modes.js +25 -1
  50. package/marketplace/plugins/litcodex/components/lit-loop/dist/motion-gate.d.ts +79 -0
  51. package/marketplace/plugins/litcodex/components/lit-loop/dist/motion-gate.js +310 -0
  52. package/marketplace/plugins/litcodex/components/lit-loop/dist/motion-route.js +5 -1
  53. package/marketplace/plugins/litcodex/components/lit-loop/dist/plan-persistence.js +10 -0
  54. package/marketplace/plugins/litcodex/components/lit-loop/dist/redaction.js +18 -0
  55. package/marketplace/plugins/litcodex/components/lit-loop/dist/reentry.d.ts +15 -0
  56. package/marketplace/plugins/litcodex/components/lit-loop/dist/reentry.js +46 -9
  57. package/marketplace/plugins/litcodex/components/lit-loop/dist/rewind-cli.d.ts +10 -0
  58. package/marketplace/plugins/litcodex/components/lit-loop/dist/rewind-cli.js +88 -0
  59. package/marketplace/plugins/litcodex/components/lit-loop/dist/rewind-go.d.ts +20 -0
  60. package/marketplace/plugins/litcodex/components/lit-loop/dist/rewind-go.js +84 -0
  61. package/marketplace/plugins/litcodex/components/lit-loop/dist/rewind-look.d.ts +6 -0
  62. package/marketplace/plugins/litcodex/components/lit-loop/dist/rewind-look.js +41 -0
  63. package/marketplace/plugins/litcodex/components/lit-loop/dist/rewind-redact.d.ts +3 -0
  64. package/marketplace/plugins/litcodex/components/lit-loop/dist/rewind-redact.js +40 -0
  65. package/marketplace/plugins/litcodex/components/lit-loop/dist/rewind-rollout.d.ts +48 -0
  66. package/marketplace/plugins/litcodex/components/lit-loop/dist/rewind-rollout.js +292 -0
  67. package/marketplace/plugins/litcodex/components/lit-loop/dist/rewind.d.ts +162 -0
  68. package/marketplace/plugins/litcodex/components/lit-loop/dist/rewind.js +773 -0
  69. package/marketplace/plugins/litcodex/components/lit-loop/dist/route-heads.js +44 -2
  70. package/marketplace/plugins/litcodex/components/lit-loop/dist/run-panel.js +1 -0
  71. package/marketplace/plugins/litcodex/components/lit-loop/dist/schematic-route.d.ts +6 -0
  72. package/marketplace/plugins/litcodex/components/lit-loop/dist/schematic-route.js +35 -0
  73. package/marketplace/plugins/litcodex/components/lit-loop/dist/screen-card.d.ts +3 -0
  74. package/marketplace/plugins/litcodex/components/lit-loop/dist/screen-card.js +15 -5
  75. package/marketplace/plugins/litcodex/components/lit-loop/dist/skill-mention-scope.js +6 -0
  76. package/marketplace/plugins/litcodex/components/lit-loop/dist/stack-hook.d.ts +8 -0
  77. package/marketplace/plugins/litcodex/components/lit-loop/dist/stack-hook.js +57 -0
  78. package/marketplace/plugins/litcodex/components/lit-loop/dist/statusline.js +8 -3
  79. package/marketplace/plugins/litcodex/components/lit-loop/dist/threads.d.ts +50 -0
  80. package/marketplace/plugins/litcodex/components/lit-loop/dist/threads.js +178 -0
  81. package/marketplace/plugins/litcodex/components/lit-loop/dist/trigger.d.ts +1 -1
  82. package/marketplace/plugins/litcodex/components/lit-loop/dist/trigger.js +31 -6
  83. package/marketplace/plugins/litcodex/components/lit-loop/dist/workflow-map.d.ts +10 -0
  84. package/marketplace/plugins/litcodex/components/lit-loop/dist/workflow-map.js +11 -1
  85. package/marketplace/plugins/litcodex/components/lit-loop/dist/workflow-stack.d.ts +132 -0
  86. package/marketplace/plugins/litcodex/components/lit-loop/dist/workflow-stack.js +488 -0
  87. package/marketplace/plugins/litcodex/components/lit-loop/package.json +1 -1
  88. package/marketplace/plugins/litcodex/components/lsp/package.json +1 -1
  89. package/marketplace/plugins/litcodex/components/rules/node_modules/picomatch/README.md +15 -21
  90. package/marketplace/plugins/litcodex/components/rules/node_modules/picomatch/lib/parse.js +49 -10
  91. package/marketplace/plugins/litcodex/components/rules/node_modules/picomatch/lib/picomatch.js +14 -2
  92. package/marketplace/plugins/litcodex/components/rules/node_modules/picomatch/lib/scan.js +30 -18
  93. package/marketplace/plugins/litcodex/components/rules/node_modules/picomatch/package.json +3 -2
  94. package/marketplace/plugins/litcodex/components/rules/package.json +1 -1
  95. package/marketplace/plugins/litcodex/components/start-work-continuation/dist/codex-hook.d.ts +6 -0
  96. package/marketplace/plugins/litcodex/components/start-work-continuation/dist/codex-hook.js +65 -0
  97. package/marketplace/plugins/litcodex/components/start-work-continuation/package.json +1 -1
  98. package/marketplace/plugins/litcodex/components/telemetry/package.json +1 -1
  99. package/marketplace/plugins/litcodex/components/wikify-knowledge/package.json +1 -1
  100. package/marketplace/plugins/litcodex/hooks/hooks.json +24 -0
  101. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/SKILL.md +6 -0
  102. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/kit/components.css +414 -0
  103. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/kit/fonts.json +22 -0
  104. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/kit/layouts/landing.html +164 -0
  105. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/kit/layouts/settings.html +114 -0
  106. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/kit/layouts/workspace.html +115 -0
  107. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/kit/styles/computational-brutalism.json +227 -0
  108. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/kit/styles/field-notes.json +205 -0
  109. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/kit/styles/graphite.json +200 -0
  110. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/kit/styles/meadow.json +199 -0
  111. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/kit/styles/neo-brutalism.json +222 -0
  112. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/kit/ui.js +228 -0
  113. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/references/brand-and-imagery.md +1 -1
  114. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/references/complete-contract.md +1 -0
  115. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/references/craft-floor.md +2 -2
  116. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/references/default-editorial-pixel.json +15 -8
  117. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/references/design-choice.md +19 -0
  118. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/references/house-styles.md +235 -0
  119. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/references/motion-guide.md +2 -2
  120. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/references/probe-and-review.md +6 -0
  121. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/references/production-interview.md +2 -0
  122. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/references/slop-register.md +4 -4
  123. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/scripts/design-lock.mjs +400 -0
  124. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/scripts/lock-probe.mjs +196 -0
  125. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/scripts/page-probe.mjs +22 -4
  126. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/scripts/pixel-art.mjs +60 -0
  127. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/scripts/probe.mjs +59 -13
  128. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/scripts/rule-data.mjs +38 -4
  129. package/marketplace/plugins/litcodex/skills/lit-adhd/SKILL.md +181 -0
  130. package/marketplace/plugins/litcodex/skills/lit-adhd/agents/openai.yaml +6 -0
  131. package/marketplace/plugins/litcodex/skills/lit-adhd/references/card-examples.md +147 -0
  132. package/marketplace/plugins/litcodex/skills/lit-adhd/references/status-taxonomy.md +37 -0
  133. package/marketplace/plugins/litcodex/skills/lit-diagram-drawer/SKILL.md +18 -7
  134. package/marketplace/plugins/litcodex/skills/lit-diagram-drawer/references/style-guide.md +20 -11
  135. package/marketplace/plugins/litcodex/skills/lit-diagram-drawer/references/type-architecture.md +3 -3
  136. package/marketplace/plugins/litcodex/skills/lit-diagram-drawer/references/type-dependency.md +1 -1
  137. package/marketplace/plugins/litcodex/skills/lit-diagram-drawer/references/type-swimlane.md +1 -1
  138. package/marketplace/plugins/litcodex/skills/lit-diagram-drawer/references/type-tree-block-decomposition.md +1 -1
  139. package/marketplace/plugins/litcodex/skills/lit-diagram-drawer/references/type-tree.md +3 -3
  140. package/marketplace/plugins/litcodex/skills/lit-diagram-drawer/references/type-wardley.md +1 -1
  141. package/marketplace/plugins/litcodex/skills/lit-diagram-drawer/references/verifier-guide.md +1 -0
  142. package/marketplace/plugins/litcodex/skills/lit-diagram-drawer/scripts/diagram-craft-rules.mjs +1 -2
  143. package/marketplace/plugins/litcodex/skills/lit-diagram-drawer/scripts/visual-quality.mjs +1 -2
  144. package/marketplace/plugins/litcodex/skills/lit-docx/SKILL.md +12 -3
  145. package/marketplace/plugins/litcodex/skills/lit-docx/references/direction-step.md +6 -3
  146. package/marketplace/plugins/litcodex/skills/lit-hijack/SKILL.md +449 -0
  147. package/marketplace/plugins/litcodex/skills/lit-hijack/agents/openai.yaml +6 -0
  148. package/marketplace/plugins/litcodex/skills/lit-hijack/references/capture-and-provenance.md +100 -0
  149. package/marketplace/plugins/litcodex/skills/lit-hijack/references/clean-room-build.md +111 -0
  150. package/marketplace/plugins/litcodex/skills/lit-hijack/references/distil-and-licence.md +102 -0
  151. package/marketplace/plugins/litcodex/skills/lit-hijack/references/gap-and-port-design.md +125 -0
  152. package/marketplace/plugins/litcodex/skills/lit-hijack/references/parity-and-report.md +108 -0
  153. package/marketplace/plugins/litcodex/skills/lit-hijack/scripts/hijack.mjs +1050 -0
  154. package/marketplace/plugins/litcodex/skills/lit-loop/SKILL.md +13 -4
  155. package/marketplace/plugins/litcodex/skills/lit-plan/SKILL.md +6 -0
  156. package/marketplace/plugins/litcodex/skills/lit-pptx/NOTICE +1 -0
  157. package/marketplace/plugins/litcodex/skills/lit-pptx/SKILL.md +35 -8
  158. package/marketplace/plugins/litcodex/skills/lit-pptx/fonts/jetbrains-mono/JetBrainsMono-Bold.ttf +0 -0
  159. package/marketplace/plugins/litcodex/skills/lit-pptx/fonts/jetbrains-mono/JetBrainsMono-Regular.ttf +0 -0
  160. package/marketplace/plugins/litcodex/skills/lit-pptx/fonts/jetbrains-mono/OFL.txt +93 -0
  161. package/marketplace/plugins/litcodex/skills/lit-pptx/fonts/jetbrains-mono/SOURCE.md +21 -0
  162. package/marketplace/plugins/litcodex/skills/lit-pptx/references/anti-slop-checklist.md +5 -2
  163. package/marketplace/plugins/litcodex/skills/lit-pptx/references/authoring-guide.md +3 -4
  164. package/marketplace/plugins/litcodex/skills/lit-pptx/references/density-and-fill.md +20 -6
  165. package/marketplace/plugins/litcodex/skills/lit-pptx/references/direction-step.md +26 -8
  166. package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/14-engineering-review-computational-brutalism-ko.md +173 -0
  167. package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/15-launch-pitch-neo-brutalism-ko.md +154 -0
  168. package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/16-design-lecture-bauhaus-ko.md +139 -0
  169. package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/17-community-programme-riso-ko.md +158 -0
  170. package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/18-public-data-briefing-newsroom-ko.md +179 -0
  171. package/marketplace/plugins/litcodex/skills/lit-pptx/references/layout-families.md +42 -27
  172. package/marketplace/plugins/litcodex/skills/lit-pptx/references/title-treatments.md +31 -27
  173. package/marketplace/plugins/litcodex/skills/lit-pptx/references/tonalities/bauhaus.md +136 -0
  174. package/marketplace/plugins/litcodex/skills/lit-pptx/references/tonalities/chalk.md +1 -1
  175. package/marketplace/plugins/litcodex/skills/lit-pptx/references/tonalities/computational-brutalism.md +145 -0
  176. package/marketplace/plugins/litcodex/skills/lit-pptx/references/tonalities/neo-brutalism.md +155 -0
  177. package/marketplace/plugins/litcodex/skills/lit-pptx/references/tonalities/newsroom.md +141 -0
  178. package/marketplace/plugins/litcodex/skills/lit-pptx/references/tonalities/riso.md +133 -0
  179. package/marketplace/plugins/litcodex/skills/lit-pptx/references/tonalities/signal.md +1 -1
  180. package/marketplace/plugins/litcodex/skills/lit-pptx/references/tonalities/studio.md +1 -1
  181. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/compile-deck.js +1 -1
  182. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/craft_extras.py +136 -94
  183. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/embed_fonts.py +13 -1
  184. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/lib/grid-resolver.js +101 -110
  185. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/lib/layout-resolver.js +9 -15
  186. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/lib/render-pack.js +386 -579
  187. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/lib/slide-grid.js +104 -0
  188. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/lib/template-registry.js +57 -6
  189. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/office-run.mjs +2 -1
  190. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/qa_deck.py +7 -13
  191. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/render_pages.py +124 -0
  192. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/atlas/pack.yaml +1 -1
  193. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/bauhaus/pack.yaml +98 -0
  194. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/chalk/pack.yaml +1 -1
  195. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/computational-brutalism/pack.yaml +100 -0
  196. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/gazette/pack.yaml +1 -1
  197. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/ledger/pack.yaml +1 -1
  198. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/neo-brutalism/pack.yaml +107 -0
  199. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/newsroom/pack.yaml +99 -0
  200. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/night/pack.yaml +1 -1
  201. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/paper/pack.yaml +1 -1
  202. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/riso/pack.yaml +99 -0
  203. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/signal/pack.yaml +2 -2
  204. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/studio/pack.yaml +1 -1
  205. package/marketplace/plugins/litcodex/skills/lit-recap/SKILL.md +2 -0
  206. package/marketplace/plugins/litcodex/skills/lit-schematic/SKILL.md +198 -0
  207. package/marketplace/plugins/litcodex/skills/lit-schematic/agents/openai.yaml +6 -0
  208. package/marketplace/plugins/litcodex/skills/lit-schematic/examples/iso-heat-exchanger/build.mjs +38 -0
  209. package/marketplace/plugins/litcodex/skills/lit-schematic/examples/iso-heat-exchanger/scene.mjs +133 -0
  210. package/marketplace/plugins/litcodex/skills/lit-schematic/examples/journal-adsorption-rig/build.mjs +87 -0
  211. package/marketplace/plugins/litcodex/skills/lit-schematic/examples/pid-dosing-skid/build.mjs +85 -0
  212. package/marketplace/plugins/litcodex/skills/lit-schematic/references/cutaway-outputs.md +70 -0
  213. package/marketplace/plugins/litcodex/skills/lit-schematic/references/isometric-craft.md +101 -0
  214. package/marketplace/plugins/litcodex/skills/lit-schematic/references/journal-figures.md +72 -0
  215. package/marketplace/plugins/litcodex/skills/lit-schematic/references/kit-api.md +134 -0
  216. package/marketplace/plugins/litcodex/skills/lit-schematic/references/pfd-and-layout.md +53 -0
  217. package/marketplace/plugins/litcodex/skills/lit-schematic/references/pid-drafting.md +103 -0
  218. package/marketplace/plugins/litcodex/skills/lit-schematic/references/pid-symbols.md +163 -0
  219. package/marketplace/plugins/litcodex/skills/lit-schematic/references/verification.md +100 -0
  220. package/marketplace/plugins/litcodex/skills/lit-schematic/scripts/doctor.mjs +57 -0
  221. package/marketplace/plugins/litcodex/skills/lit-schematic/scripts/lib/figure.mjs +81 -0
  222. package/marketplace/plugins/litcodex/skills/lit-schematic/scripts/lib/fonts.mjs +28 -0
  223. package/marketplace/plugins/litcodex/skills/lit-schematic/scripts/lib/geom.mjs +113 -0
  224. package/marketplace/plugins/litcodex/skills/lit-schematic/scripts/lib/interactive.mjs +292 -0
  225. package/marketplace/plugins/litcodex/skills/lit-schematic/scripts/lib/isa.mjs +115 -0
  226. package/marketplace/plugins/litcodex/skills/lit-schematic/scripts/lib/iso.mjs +719 -0
  227. package/marketplace/plugins/litcodex/skills/lit-schematic/scripts/lib/legend-sheet.mjs +162 -0
  228. package/marketplace/plugins/litcodex/skills/lit-schematic/scripts/lib/pid.mjs +937 -0
  229. package/marketplace/plugins/litcodex/skills/lit-schematic/scripts/lib/png.mjs +132 -0
  230. package/marketplace/plugins/litcodex/skills/lit-schematic/scripts/lib/qa-core.mjs +658 -0
  231. package/marketplace/plugins/litcodex/skills/lit-schematic/scripts/lib/route.mjs +218 -0
  232. package/marketplace/plugins/litcodex/skills/lit-schematic/scripts/lib/sheet.mjs +890 -0
  233. package/marketplace/plugins/litcodex/skills/lit-schematic/scripts/lib/svg.mjs +82 -0
  234. package/marketplace/plugins/litcodex/skills/lit-schematic/scripts/lib/theme.mjs +115 -0
  235. package/marketplace/plugins/litcodex/skills/lit-schematic/scripts/motion.mjs +129 -0
  236. package/marketplace/plugins/litcodex/skills/lit-schematic/scripts/qa.mjs +92 -0
  237. package/marketplace/plugins/litcodex/skills/lit-schematic/scripts/render.mjs +233 -0
  238. package/marketplace/plugins/litcodex/skills/lit-schematic/scripts/scaffold.mjs +60 -0
  239. package/marketplace/plugins/litcodex/skills/lit-scientific-visualization/SKILL.md +34 -8
  240. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/SKILL.md +18 -14
  241. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/THIRD_PARTY_NOTICES +12 -0
  242. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/assets.mjs +388 -0
  243. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/blender/runner.py +221 -0
  244. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/blender.mjs +132 -0
  245. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/board.mjs +142 -0
  246. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/constants.mjs +6 -0
  247. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/cover-assets.mjs +7 -4
  248. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/cover-capture.mjs +8 -7
  249. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/cover-init.js +14 -2
  250. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/cover-treatment.mjs +38 -3
  251. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/cover.mjs +19 -4
  252. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/driver.mjs +8 -8
  253. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/gallery.mjs +147 -0
  254. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/house.mjs +45 -0
  255. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/image.mjs +89 -0
  256. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/look.mjs +58 -25
  257. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/runtime.mjs +59 -14
  258. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/safe-read.mjs +32 -0
  259. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/scaffold.mjs +208 -0
  260. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/score.mjs +668 -0
  261. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/sound.mjs +174 -31
  262. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/stage-gate.mjs +45 -3
  263. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/stage-kit.js +99 -1
  264. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/stage-qa.js +8 -1
  265. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/stage-qa.mjs +180 -11
  266. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/stage-render.mjs +42 -12
  267. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/stage-worker.mjs +7 -4
  268. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/stage.mjs +96 -10
  269. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/styles.mjs +233 -0
  270. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/treatment.mjs +291 -14
  271. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/vendor/three/LICENSE +21 -0
  272. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/vendor/three/addons/environments/RoomEnvironment.js +144 -0
  273. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/vendor/three/addons/geometries/RoundedBoxGeometry.js +155 -0
  274. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/vendor/three/three.module.js +54571 -0
  275. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/recipes/hero-3d/expected.json +33 -0
  276. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/recipes/hero-3d/index.html +139 -0
  277. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/references/cover.md +44 -7
  278. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/references/depth.md +156 -0
  279. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/references/design-choice.md +22 -0
  280. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/references/quality-gate.md +29 -7
  281. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/references/runtime.md +1 -1
  282. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/references/sound.md +87 -0
  283. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/references/stage.md +19 -7
  284. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/references/studio.md +246 -0
  285. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/references/style-bibles.md +2 -2
  286. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/references/treatment.md +41 -21
  287. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/runtime/requirements-audio.txt +3 -3
  288. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/scripts/render.mjs +51 -4
  289. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/styles/paper.json +185 -0
  290. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/styles/swiss-signal.json +188 -0
  291. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/styles/terminalcore.json +182 -0
  292. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/styles/tidal.json +187 -0
  293. package/marketplace/plugins/litcodex/skills/litresearch/SKILL.md +7 -0
  294. package/marketplace/plugins/litcodex/skills/litwork/SKILL.md +2 -1
  295. package/marketplace/plugins/litcodex/skills/lsp-setup/SKILL.md +2 -1
  296. package/marketplace/plugins/litcodex/skills/readme-studio/SKILL.md +10 -0
  297. package/marketplace/plugins/litcodex/skills/readme-studio/templates/hyperframes-cover/package-lock.json +3 -3
  298. package/marketplace/plugins/litcodex/skills/readme-studio/templates/remotion-cover/package-lock.json +3 -3
  299. package/marketplace/plugins/litcodex/skills/review-work/SKILL.md +7 -1
  300. package/marketplace/plugins/litcodex/skills/start-work/SKILL.md +10 -0
  301. package/node_modules/@litcodex/lit-loop/directive.md +10 -4
  302. package/node_modules/@litcodex/lit-loop/directives/lit-adhd.md +191 -0
  303. package/node_modules/@litcodex/lit-loop/directives/lit-handoff.md +2 -0
  304. package/node_modules/@litcodex/lit-loop/directives/lit-hijack.md +219 -0
  305. package/node_modules/@litcodex/lit-loop/directives/lit-recap.md +2 -0
  306. package/node_modules/@litcodex/lit-loop/directives/lit-schematic.md +199 -0
  307. package/node_modules/@litcodex/lit-loop/directives/litwork.md +2 -1
  308. package/node_modules/@litcodex/lit-loop/dist/adhd-suggest.d.ts +10 -0
  309. package/node_modules/@litcodex/lit-loop/dist/adhd-suggest.js +67 -0
  310. package/node_modules/@litcodex/lit-loop/dist/card-html.d.ts +1 -1
  311. package/node_modules/@litcodex/lit-loop/dist/card-html.js +128 -8
  312. package/node_modules/@litcodex/lit-loop/dist/card-looks.d.ts +19 -0
  313. package/node_modules/@litcodex/lit-loop/dist/card-looks.js +58 -0
  314. package/node_modules/@litcodex/lit-loop/dist/card-status.d.ts +27 -0
  315. package/node_modules/@litcodex/lit-loop/dist/card-status.js +94 -7
  316. package/node_modules/@litcodex/lit-loop/dist/cli.js +13 -3
  317. package/node_modules/@litcodex/lit-loop/dist/codex-hook.d.ts +2 -0
  318. package/node_modules/@litcodex/lit-loop/dist/codex-hook.js +8 -9
  319. package/node_modules/@litcodex/lit-loop/dist/control-chars.d.ts +5 -0
  320. package/node_modules/@litcodex/lit-loop/dist/control-chars.js +23 -0
  321. package/node_modules/@litcodex/lit-loop/dist/hook-cli.d.ts +8 -0
  322. package/node_modules/@litcodex/lit-loop/dist/hook-cli.js +118 -11
  323. package/node_modules/@litcodex/lit-loop/dist/hud.d.ts +1 -1
  324. package/node_modules/@litcodex/lit-loop/dist/hud.js +29 -13
  325. package/node_modules/@litcodex/lit-loop/dist/lane-events.d.ts +13 -0
  326. package/node_modules/@litcodex/lit-loop/dist/lane-events.js +85 -0
  327. package/node_modules/@litcodex/lit-loop/dist/lane-state.d.ts +55 -0
  328. package/node_modules/@litcodex/lit-loop/dist/lane-state.js +227 -0
  329. package/node_modules/@litcodex/lit-loop/dist/live-step.d.ts +5 -1
  330. package/node_modules/@litcodex/lit-loop/dist/live-step.js +17 -1
  331. package/node_modules/@litcodex/lit-loop/dist/markers.d.ts +6 -0
  332. package/node_modules/@litcodex/lit-loop/dist/markers.js +6 -0
  333. package/node_modules/@litcodex/lit-loop/dist/modes.d.ts +1 -1
  334. package/node_modules/@litcodex/lit-loop/dist/modes.js +25 -1
  335. package/node_modules/@litcodex/lit-loop/dist/motion-gate.d.ts +79 -0
  336. package/node_modules/@litcodex/lit-loop/dist/motion-gate.js +310 -0
  337. package/node_modules/@litcodex/lit-loop/dist/motion-route.js +5 -1
  338. package/node_modules/@litcodex/lit-loop/dist/plan-persistence.js +10 -0
  339. package/node_modules/@litcodex/lit-loop/dist/redaction.js +18 -0
  340. package/node_modules/@litcodex/lit-loop/dist/reentry.d.ts +15 -0
  341. package/node_modules/@litcodex/lit-loop/dist/reentry.js +46 -9
  342. package/node_modules/@litcodex/lit-loop/dist/rewind-cli.d.ts +10 -0
  343. package/node_modules/@litcodex/lit-loop/dist/rewind-cli.js +88 -0
  344. package/node_modules/@litcodex/lit-loop/dist/rewind-go.d.ts +20 -0
  345. package/node_modules/@litcodex/lit-loop/dist/rewind-go.js +84 -0
  346. package/node_modules/@litcodex/lit-loop/dist/rewind-look.d.ts +6 -0
  347. package/node_modules/@litcodex/lit-loop/dist/rewind-look.js +41 -0
  348. package/node_modules/@litcodex/lit-loop/dist/rewind-redact.d.ts +3 -0
  349. package/node_modules/@litcodex/lit-loop/dist/rewind-redact.js +40 -0
  350. package/node_modules/@litcodex/lit-loop/dist/rewind-rollout.d.ts +48 -0
  351. package/node_modules/@litcodex/lit-loop/dist/rewind-rollout.js +292 -0
  352. package/node_modules/@litcodex/lit-loop/dist/rewind.d.ts +162 -0
  353. package/node_modules/@litcodex/lit-loop/dist/rewind.js +773 -0
  354. package/node_modules/@litcodex/lit-loop/dist/route-heads.js +44 -2
  355. package/node_modules/@litcodex/lit-loop/dist/run-panel.js +1 -0
  356. package/node_modules/@litcodex/lit-loop/dist/schematic-route.d.ts +6 -0
  357. package/node_modules/@litcodex/lit-loop/dist/schematic-route.js +35 -0
  358. package/node_modules/@litcodex/lit-loop/dist/screen-card.d.ts +3 -0
  359. package/node_modules/@litcodex/lit-loop/dist/screen-card.js +15 -5
  360. package/node_modules/@litcodex/lit-loop/dist/skill-mention-scope.js +6 -0
  361. package/node_modules/@litcodex/lit-loop/dist/stack-hook.d.ts +8 -0
  362. package/node_modules/@litcodex/lit-loop/dist/stack-hook.js +57 -0
  363. package/node_modules/@litcodex/lit-loop/dist/statusline.js +8 -3
  364. package/node_modules/@litcodex/lit-loop/dist/threads.d.ts +50 -0
  365. package/node_modules/@litcodex/lit-loop/dist/threads.js +178 -0
  366. package/node_modules/@litcodex/lit-loop/dist/trigger.d.ts +1 -1
  367. package/node_modules/@litcodex/lit-loop/dist/trigger.js +31 -6
  368. package/node_modules/@litcodex/lit-loop/dist/workflow-map.d.ts +10 -0
  369. package/node_modules/@litcodex/lit-loop/dist/workflow-map.js +11 -1
  370. package/node_modules/@litcodex/lit-loop/dist/workflow-stack.d.ts +132 -0
  371. package/node_modules/@litcodex/lit-loop/dist/workflow-stack.js +488 -0
  372. package/node_modules/@litcodex/lit-loop/package.json +1 -1
  373. package/node_modules/@litcodex/lit-loop/skills/lit-adhd/SKILL.md +181 -0
  374. package/node_modules/@litcodex/lit-loop/skills/lit-hijack/SKILL.md +449 -0
  375. package/node_modules/@litcodex/lit-loop/skills/lit-loop/SKILL.md +13 -4
  376. package/node_modules/@litcodex/lit-loop/skills/lit-plan/SKILL.md +6 -0
  377. package/node_modules/@litcodex/lit-loop/skills/lit-recap/SKILL.md +2 -0
  378. package/node_modules/@litcodex/lit-loop/skills/lit-schematic/SKILL.md +198 -0
  379. package/node_modules/@litcodex/lit-loop/skills/lit-scientific-visualization/SKILL.md +34 -8
  380. package/node_modules/@litcodex/lit-loop/skills/litresearch/SKILL.md +7 -0
  381. package/node_modules/@litcodex/lit-loop/skills/litwork/SKILL.md +2 -1
  382. package/node_modules/@litcodex/lit-loop/skills/review-work/SKILL.md +7 -1
  383. package/node_modules/@litcodex/lit-loop/skills/start-work/SKILL.md +10 -0
  384. package/package.json +2 -2
  385. package/readme-assets/badge-version.svg +1 -1
  386. package/readme-assets/skills/lit-adhd.webp +0 -0
  387. package/readme-assets/skills/lit-hijack.webp +0 -0
  388. package/readme-assets/skills/lit-schematic.webp +0 -0
@@ -0,0 +1,228 @@
1
+ // frontend-ui-ux kit: behaviour that every build otherwise re-invents. No dependencies, no
2
+ // network. Colours come from the locked tokens (CSS custom properties), never from literals.
3
+ // UI.bars(el, { labels, series: [{ name, values, role }], marker, unit, caption })
4
+ // UI.lines(el, { labels, series: [{ name, values, role }], marker, unit, caption })
5
+ // <table data-ui-sortable> header <button class="ui-sort"> cells sort by data-value or text
6
+ // <div role="tablist" data-ui-tabs> arrow keys, Home and End move between tabs
7
+ (function () {
8
+ "use strict";
9
+ const NS = "http://www.w3.org/2000/svg";
10
+ const svg = (tag, attrs = {}) => {
11
+ const node = document.createElementNS(NS, tag);
12
+ for (const [key, value] of Object.entries(attrs)) node.setAttribute(key, String(value));
13
+ return node;
14
+ };
15
+ const roleColor = (role, index) => `var(--c-${role || `chart-${(index % 5) + 1}`})`;
16
+ const niceMax = (value) => {
17
+ if (value <= 0) return 1;
18
+ const power = 10 ** Math.floor(Math.log10(value));
19
+ const step = [1, 2, 2.5, 5, 10].find((n) => n * power >= value / 4) * power;
20
+ return Math.ceil(value / step) * step;
21
+ };
22
+ const fmt = (value, unit) => `${Number(value).toLocaleString()}${unit ?? ""}`;
23
+
24
+ function frame(el, opts, maxValue) {
25
+ el.classList.add("ui-chart");
26
+ el.replaceChildren();
27
+ const width = Math.max(280, Math.round(el.getBoundingClientRect().width) || 640);
28
+ const height = opts.height ?? (width < 480 ? 200 : 240);
29
+ const pad = { top: 16, right: 8, bottom: 28, left: 36 };
30
+ const plotW = width - pad.left - pad.right;
31
+ const plotH = height - pad.top - pad.bottom;
32
+ const root = svg("svg", { viewBox: `0 0 ${width} ${height}`, width, height, role: "img", "aria-label": opts.caption ?? "Chart" });
33
+ // Whole-number data keeps whole-number ticks: round the top up to a multiple of the four steps.
34
+ const top = opts.integer ? Math.max(4, Math.ceil(niceMax(maxValue) / 4) * 4) : niceMax(maxValue);
35
+ const axis = svg("g", { class: "ui-axis" });
36
+ for (let i = 0; i <= 4; i += 1) {
37
+ const y = pad.top + plotH - (plotH * i) / 4;
38
+ root.append(svg("line", { class: i === 0 ? "ui-baseline" : "ui-grid-line", x1: pad.left, x2: width - pad.right, y1: y, y2: y }));
39
+ const label = svg("text", { x: pad.left - 8, y: y + 4, "text-anchor": "end" });
40
+ label.textContent = fmt((top * i) / 4, "");
41
+ axis.append(label);
42
+ }
43
+ root.append(axis);
44
+ return { root, axis, width, height, pad, plotW, plotH, top };
45
+ }
46
+
47
+ function legendAndTable(el, opts) {
48
+ if (opts.series.length > 1) {
49
+ const legend = document.createElement("div");
50
+ legend.className = "ui-legend";
51
+ opts.series.forEach((series, index) => {
52
+ const item = document.createElement("span");
53
+ const swatch = document.createElement("i");
54
+ swatch.style.setProperty("--swatch", roleColor(series.role, index));
55
+ item.append(swatch, document.createTextNode(series.name));
56
+ legend.append(item);
57
+ });
58
+ el.prepend(legend);
59
+ }
60
+ const details = document.createElement("details");
61
+ const summary = document.createElement("summary");
62
+ summary.className = "ui-meta";
63
+ summary.textContent = opts.tableLabel ?? "Show as table";
64
+ const table = document.createElement("table");
65
+ table.className = "ui-table ui-table--compact";
66
+ const head = document.createElement("tr");
67
+ for (const text of [opts.indexLabel ?? "", ...opts.series.map((s) => s.name)]) {
68
+ const th = document.createElement("th");
69
+ th.textContent = text;
70
+ head.append(th);
71
+ }
72
+ const thead = document.createElement("thead");
73
+ thead.append(head);
74
+ const tbody = document.createElement("tbody");
75
+ opts.labels.forEach((label, row) => {
76
+ const tr = document.createElement("tr");
77
+ const th = document.createElement("th");
78
+ th.scope = "row";
79
+ th.textContent = label;
80
+ tr.append(th);
81
+ for (const series of opts.series) {
82
+ const td = document.createElement("td");
83
+ td.className = "is-num";
84
+ td.textContent = fmt(series.values[row], opts.unit);
85
+ tr.append(td);
86
+ }
87
+ tbody.append(tr);
88
+ });
89
+ table.append(thead, tbody);
90
+ details.append(summary, table);
91
+ el.append(details);
92
+ }
93
+
94
+ function xLabels(f, labels, step) {
95
+ const every = Math.max(1, Math.ceil(labels.length / (f.plotW / 44)));
96
+ labels.forEach((label, index) => {
97
+ if (index % every) return;
98
+ const text = svg("text", { x: f.pad.left + step * index + (step / 2) * (f.bandCenter ? 1 : 0), y: f.height - 8, "text-anchor": "middle" });
99
+ text.textContent = label;
100
+ f.axis.append(text);
101
+ });
102
+ }
103
+
104
+ function marker(f, opts, x) {
105
+ if (!opts.marker) return;
106
+ f.root.append(svg("line", { class: "ui-marker", x1: x, x2: x, y1: f.pad.top - 4, y2: f.pad.top + f.plotH }));
107
+ // The label sits above the plot so it never covers a bar, and flips to the line's left side near the right edge.
108
+ const flip = x > f.pad.left + f.plotW * 0.55;
109
+ const text = svg("text", { class: "ui-marker-label", x: flip ? x - 4 : x + 4, y: f.pad.top - 6, "text-anchor": flip ? "end" : "start" });
110
+ text.textContent = opts.marker.label;
111
+ f.root.append(text);
112
+ }
113
+
114
+ const drawn = new Map();
115
+ let resizeTimer = 0;
116
+ addEventListener("resize", () => {
117
+ clearTimeout(resizeTimer);
118
+ resizeTimer = setTimeout(() => { for (const [el, draw] of drawn) draw(); }, 150);
119
+ });
120
+ const remember = (el, draw) => { drawn.set(el, draw); draw(); };
121
+
122
+ function bars(el, opts) { remember(el, () => drawBars(el, opts)); }
123
+ function lines(el, opts) { remember(el, () => drawLines(el, opts)); }
124
+
125
+ function drawBars(el, opts) {
126
+ const stacked = Boolean(opts.stacked);
127
+ const totals = opts.labels.map((_, i) => opts.series.reduce((sum, s) => sum + (stacked ? s.values[i] : 0), 0));
128
+ const max = stacked ? Math.max(...totals) : Math.max(...opts.series.flatMap((s) => s.values));
129
+ const f = frame(el, { ...opts, integer: opts.series.every((s) => s.values.every(Number.isInteger)) }, max);
130
+ f.bandCenter = true;
131
+ const step = f.plotW / opts.labels.length;
132
+ const groupW = step * 0.64;
133
+ const barW = stacked ? groupW : groupW / opts.series.length;
134
+ opts.labels.forEach((label, i) => {
135
+ let base = 0;
136
+ opts.series.forEach((series, s) => {
137
+ const value = series.values[i];
138
+ const h = (value / f.top) * f.plotH;
139
+ const x = f.pad.left + step * i + (step - groupW) / 2 + (stacked ? 0 : barW * s);
140
+ const y = f.pad.top + f.plotH - h - (stacked ? (base / f.top) * f.plotH : 0);
141
+ const rect = svg("rect", { x, y, width: Math.max(1, barW - (stacked ? 0 : 2)), height: Math.max(0, h), rx: 2, style: `fill: ${roleColor(series.role, s)}` });
142
+ const title = svg("title");
143
+ title.textContent = `${label}: ${series.name} ${fmt(value, opts.unit)}`;
144
+ rect.append(title);
145
+ f.root.append(rect);
146
+ base += stacked ? value : 0;
147
+ });
148
+ });
149
+ xLabels(f, opts.labels, step);
150
+ if (opts.marker) marker(f, opts, f.pad.left + step * opts.marker.index + step / 2);
151
+ el.append(f.root);
152
+ legendAndTable(el, opts);
153
+ }
154
+
155
+ function drawLines(el, opts) {
156
+ const max = Math.max(...opts.series.flatMap((s) => s.values));
157
+ const f = frame(el, { ...opts, integer: opts.series.every((s) => s.values.every(Number.isInteger)) }, max);
158
+ const step = f.plotW / Math.max(1, opts.labels.length - 1);
159
+ opts.series.forEach((series, s) => {
160
+ const points = series.values.map((value, i) => `${f.pad.left + step * i},${f.pad.top + f.plotH - (value / f.top) * f.plotH}`);
161
+ f.root.append(svg("polyline", { points: points.join(" "), style: `fill: none; stroke: ${roleColor(series.role, s)}`, "stroke-width": 2, "stroke-linejoin": "round", "stroke-linecap": "round" }));
162
+ });
163
+ f.bandCenter = false;
164
+ xLabels(f, opts.labels, step);
165
+ if (opts.marker) marker(f, opts, f.pad.left + step * opts.marker.index);
166
+ el.append(f.root);
167
+ legendAndTable(el, opts);
168
+ }
169
+
170
+ function sortable(table) {
171
+ const tbody = table.tBodies[0];
172
+ table.querySelectorAll("thead th .ui-sort").forEach((button) => {
173
+ button.type = "button";
174
+ button.addEventListener("click", () => {
175
+ const th = button.closest("th");
176
+ const index = [...th.parentElement.children].indexOf(th);
177
+ const next = th.getAttribute("aria-sort") === "ascending" ? "descending" : "ascending";
178
+ table.querySelectorAll("thead th[aria-sort]").forEach((cell) => cell.removeAttribute("aria-sort"));
179
+ th.setAttribute("aria-sort", next);
180
+ const key = (row) => {
181
+ const cell = row.children[index];
182
+ const raw = cell?.dataset.value ?? cell?.textContent.trim() ?? "";
183
+ const number = Number(raw);
184
+ return raw !== "" && !Number.isNaN(number) ? number : raw.toLocaleLowerCase();
185
+ };
186
+ const rows = [...tbody.rows].sort((a, b) => {
187
+ const x = key(a);
188
+ const y = key(b);
189
+ const order = typeof x === "number" && typeof y === "number" ? x - y : String(x).localeCompare(String(y));
190
+ return next === "ascending" ? order : -order;
191
+ });
192
+ tbody.append(...rows);
193
+ table.dispatchEvent(new CustomEvent("ui:sorted", { detail: { index, order: next } }));
194
+ });
195
+ });
196
+ }
197
+
198
+ function tabs(list) {
199
+ const items = [...list.querySelectorAll('[role="tab"]')];
200
+ const select = (tab) => {
201
+ for (const item of items) {
202
+ const on = item === tab;
203
+ item.setAttribute("aria-selected", String(on));
204
+ item.tabIndex = on ? 0 : -1;
205
+ const panel = document.getElementById(item.getAttribute("aria-controls"));
206
+ if (panel) panel.hidden = !on;
207
+ }
208
+ };
209
+ items.forEach((tab, index) => {
210
+ tab.addEventListener("click", () => select(tab));
211
+ tab.addEventListener("keydown", (event) => {
212
+ const move = { ArrowRight: 1, ArrowLeft: -1, Home: -index, End: items.length - 1 - index }[event.key];
213
+ if (move === undefined) return;
214
+ event.preventDefault();
215
+ const next = items[(index + move + items.length) % items.length];
216
+ next.focus();
217
+ select(next);
218
+ });
219
+ });
220
+ select(items.find((tab) => tab.getAttribute("aria-selected") === "true") ?? items[0]);
221
+ }
222
+
223
+ document.addEventListener("DOMContentLoaded", () => {
224
+ document.querySelectorAll("table[data-ui-sortable]").forEach(sortable);
225
+ document.querySelectorAll("[data-ui-tabs]").forEach(tabs);
226
+ });
227
+ window.UI = { bars, lines, sortable, tabs };
228
+ })();
@@ -8,7 +8,7 @@ Use authorized purpose and audience, marks and clear-space rules, licensed color
8
8
 
9
9
  | Quality | Interface expression |
10
10
  | --- | --- |
11
- | Precise | aligned layout, explicit labels, restrained transitions |
11
+ | Precise | aligned layout, explicit labels, restrained transitions (a calm brief) |
12
12
  | Energetic | clear contrast, dynamic crops, quick feedback |
13
13
  | Humane | readable type, forgiving recovery, warm content |
14
14
  | Premium | restrained materials, deliberate pace, strong imagery |
@@ -140,6 +140,7 @@ Load only the smallest complete set:
140
140
  | --- | --- |
141
141
  | Every frontend mode: numbered craft and responsive rules | `references/craft-floor.md` |
142
142
  | Every frontend mode: generic-pattern and functional register | `references/slop-register.md` |
143
+ | Building a new page or screen: the design lock, five house styles, density, signature moment, starters | `references/house-styles.md` |
143
144
  | Probe execution, mode routing, fix loop, and findings table | `references/probe-and-review.md` |
144
145
  | Product framing, research, inclusive scenarios, decision quality | `references/product-direction.md` |
145
146
  | Tokens, themes, components, governance | `references/system-foundations.md` |
@@ -24,7 +24,7 @@ Read this in every frontend mode. These checks describe what to inspect and how
24
24
  | CF-202 | Compare a sampled control before and after `focus()` and `:focus-visible`; a browser `outline-style:auto` passes. A custom ring needs ≥2px and ≥3:1 against its neighbors. HIGH only when focus changes nothing; a weaker visible ring is MEDIUM. |
25
25
  | CF-203 | APCA is an annotation, never a separate blocker: body Lc 75/90, other text 60/75, ≥36px display 45/60, UI floor 30. Keep the WCAG result primary. |
26
26
  | CF-204 | For text over images or gradients, sample the worst color behind the glyph area. If a cross-origin surface prevents reading it, mark the rule not verified. |
27
- | CF-205 | Count saturated filled emphasis surfaces ≥24×24px and group nearby hues. Exclude semantic status fills (including small status pills ≤32px) before clustering. Prefer one accent family per view. |
27
+ | CF-205 | Count saturated filled emphasis surfaces ≥24×24px and group nearby hues. Exclude semantic status fills (including small status pills ≤32px) before clustering. A rich view may use up to four hue families when each carries a role (primary, accent-2, status, data); a calm lock allows one. More than that, or an unowned hue, is the finding. |
28
28
  | CF-206 | Treat hue angles within 15° as one semantic family. Keep meaning consistent across controls and status. |
29
29
  | CF-207 | A status needs words, a meaningful icon, or a pattern in addition to color. Confirm intent manually; color-only state is HIGH. |
30
30
 
@@ -40,7 +40,7 @@ Read this in every frontend mode. These checks describe what to inspect and how
40
40
  | CF-306 | Review repeated groups for parent `gap` instead of margins on every child; change the owner of spacing when the pattern is real. |
41
41
  | CF-401 | A nested rounded frame expects inner radius approximately outer radius minus inset, within 1px. Exclude offset icon chips that are not concentric. |
42
42
  | CF-402 | A border and a ≤2px hard shadow tracing the same edge duplicate elevation. Delete one; a soft ambient shadow is a different case. |
43
- | CF-403 | A hard-offset shadow together with a ≥2px border on at least three elements signals repeated pseudo-brutalist decoration. Review its content role before softening. |
43
+ | CF-403 | A hard-offset shadow together with a ≥2px border on at least three elements signals repeated pseudo-brutalist decoration. Review its content role before softening. A lock whose style declares `offset` elevation is that register on purpose and passes this row. |
44
44
  | CF-404 | On primary controls, inspect chromatic near-zero-offset blooms whose blur is ≥1.5× the shorter side; reduce or remove the halo. |
45
45
  | CF-405 | A photographic image may need a restrained neutral ~1px outline against the ground; test the actual edge before adding one. |
46
46
  | CF-406 | A modal scrim uses a solid or near-solid veil; avoid blur as a default backdrop treatment. |
@@ -31,22 +31,29 @@
31
31
  "spacing": {
32
32
  "base_px": 8,
33
33
  "microstep_px": 4,
34
- "desktop_section_gap_px": [80, 128],
35
- "mobile_section_gap_px": [40, 64]
34
+ "desktop_section_gap_px": [72, 96],
35
+ "mobile_section_gap_px": [40, 56]
36
36
  },
37
37
  "typography": {
38
- "display_px": { "desktop": [56, 104], "mobile": [36, 56] },
38
+ "display_px": { "desktop": [56, 96], "mobile": [36, 56] },
39
39
  "latin_leading": [0.95, 1.05],
40
40
  "korean_leading": [1.12, 1.25],
41
41
  "body_leading": [1.5, 1.7]
42
42
  },
43
43
  "color_roles": {
44
- "paper": "#F4F1E9",
45
- "ink": "#15242A",
46
- "signal": "#E86A4A",
47
- "quiet_signal": "#A9DCC8",
48
- "boundary": "#15242A"
44
+ "paper": "#F5F3EB",
45
+ "ink": "#18272B",
46
+ "signal": "#C64D2E",
47
+ "signal_2": "#1D6B68",
48
+ "quiet_signal": "#B7D8C7",
49
+ "boundary": "#18272B"
49
50
  },
51
+ "density": {
52
+ "default": "rich",
53
+ "rich": "section padding 48/72/96px, notebook-dot canvas and one warm glow on the atmosphere surface, up to four hue families that each own a role",
54
+ "calm": "only when the user asks for minimal, calm, quiet or restrained: padding 64/96/128px, flat canvas, no glow, one hue family"
55
+ },
56
+ "work_surfaces": "Dashboards, settings and tools keep these palette and type roles but take the graphite house style by default and a small accent in place of the pixel illustration. See references/house-styles.md.",
50
57
  "surface_rules": [
51
58
  "Use typography, spacing, and one deliberate contrast shift to establish hierarchy.",
52
59
  "Keep pixel edges crisp and original; do not blur or upscale low-resolution art with smoothing.",
@@ -0,0 +1,19 @@
1
+ # Choose the design first
2
+
3
+ For a new page or screen the user picks the look and has the right to choose. Before `design-lock.mjs` runs or any markup is written, ask up to three questions and pass the answers to `init` as `--style`, `--family` and `--density`:
4
+
5
+ 1. `Style` ("Which house style?"): the style the brief's register points to as `<style> (Recommended)` (`field-notes` for a read-once page, `graphite` for a screen worked in), then up to three of `meadow` (warm, consumer), `computational-brutalism` (instrument, terminal), `neo-brutalism` (loud, outlined), `graphite` or `field-notes`, picked by their `use_when` lines in `references/house-styles.md`.
6
+ 2. `Family` ("What is being built?"): `landing`, `workspace` or `settings`, the one the brief implies first with `(Recommended)`.
7
+ 3. `Density` ("How full should it be?"): `Rich (Recommended)` (the lock default: section rhythm, texture, second accent, bands) or `Calm` (broad flat page, one accent).
8
+
9
+ ## How to ask
10
+
11
+ Ask with `request_user_input` when this turn offers it (Plan mode): 2–4 options per question, the recommended one first and labelled `(Recommended)`, a one-line description each; the tool takes a free-text answer on its own, so no Other option is written.
12
+
13
+ When it is not offered (Default mode), put the same questions in the reply as a short numbered list with the recommended option first as `1. … (Recommended)`, and end the turn to wait for the pick; build nothing before it arrives.
14
+
15
+ In a non-interactive `codex exec` run nobody can answer: take the recommended option, say so in one line ("Non-interactive run: building with graphite, the recommended option") and continue.
16
+
17
+ ## When to skip
18
+
19
+ Skip a question only when the prompt already names its answer (a style keyword, a family, an existing brand or token file, a brownfield or redesign lane that keeps the product's identity) or hands the choice over ("you choose", "just make it good", "알아서", "네가 골라"), or under a bare `lit`, which asks no questions; then apply the family defaults and say which style was used. A typed style id from `design-lock.mjs list` or brand tokens go to `--style` or `--from`. Review, plan and keyword-only requests stay read-only and ask nothing.
@@ -0,0 +1,235 @@
1
+ # House styles, the kit and the design lock
2
+
3
+ Read this before writing markup for a new page or screen. It replaces the decisions a run used to
4
+ make from scratch every time (typeface, palette, scale, radii, component anatomy, page skeleton)
5
+ with a small closed set that a script writes into the project and `scripts/probe.mjs` checks on the
6
+ render. The point is that two runs of the same brief land in the same register at the same level of
7
+ craft; what still varies is the content, the composition inside the skeleton and the accent art. One
8
+ place on every page is allowed to be bold: its signature moment (section 6), declared in the lock and
9
+ checked like the rest.
10
+
11
+ ## 1. Lock the look first
12
+
13
+ ```bash
14
+ FRONTEND_UIUX_SKILL_ROOT="<directory of the host-selected SKILL.md>"
15
+ node "$FRONTEND_UIUX_SKILL_ROOT/scripts/design-lock.mjs" list
16
+ node "$FRONTEND_UIUX_SKILL_ROOT/scripts/design-lock.mjs" match "<the request>"
17
+ node "$FRONTEND_UIUX_SKILL_ROOT/scripts/design-lock.mjs" init --family <family> [--style <id>] [--brief "<the request>"] [--density calm] --dir <project> --scaffold \
18
+ --moment <kind> --moment-note "<what it shows>" [--moment-place "<where it sits>"]
19
+ node "$FRONTEND_UIUX_SKILL_ROOT/scripts/design-lock.mjs" moment --dir <project> --kind <kind> --note "<what it shows>"
20
+ ```
21
+
22
+ `init` writes into the project:
23
+
24
+ | File | What it is |
25
+ |---|---|
26
+ | `design.lock.json` | The declaration the probe reads: style id, family, density, fonts, type scale, display range and moment ceiling, radii, spacing, light and dark palette, elevation, and the signature moment (scale, kind, note, place) |
27
+ | `ui/tokens.css` | Generated custom properties (`--c-*`, `--fs-*`, `--fw-*`, `--sp-*`, `--radius-*`, `--shadow-*`, `--dur-*`) with dark mode and the `@font-face` rules |
28
+ | `ui/components.css` | The shared `ui-*` component sheet; it reads only tokens |
29
+ | `ui/ui.js` | Charts with a table fallback, sortable tables, keyboard tabs |
30
+ | `ui/fonts/` | Pretendard (Latin and Hangul) and JetBrains Mono with their OFL texts, copied from the sibling skills that already ship them (lit-diagram-drawer, lit-typographic-motion) after a sha256 check; nothing is fetched |
31
+ | `index.html` | Only with `--scaffold` and no existing page: the starter for the family |
32
+
33
+ **Density.** Every lock records `density: rich` unless the request asks for a calm page. Rich is
34
+ the default because the user wants pages that feel made, not emptied: a tighter section rhythm
35
+ (48, 72 and 96 px), the style's texture (field-notes notebook dots), a second accent family
36
+ (`--c-accent-2`, `-ink`, `-wash`, `on-accent-2`), colour bands (`ui-band`, `ui-band--accent-2`,
37
+ `ui-band--support`), a two-accent wash (`ui-wash`) and an atmosphere glow (`ui-glow`, a soft
38
+ glow token that is `none` on flat and offset locks). `density: calm` is opt-in: `--density calm`,
39
+ or a brief that says minimal, calm, quiet, restrained, understated, 미니멀, 차분, 절제, 담백 or 간결
40
+ (`match` prints the density it reads). Calm restores the broad 64, 96 and 128 px sections, a flat
41
+ canvas, no glow, and holds the probe to one accent hue (CF-205). Contrast, focus, overflow,
42
+ reduced motion and every other floor are the same in both.
43
+
44
+ Choose in this order and stop at the first rule that decides:
45
+
46
+ 1. **Existing product or brand tokens** (brownfield, a design system in the repo, colours or type the
47
+ user named): do not lock a kit style over them. Either write a style file in the same schema as
48
+ `kit/styles/*.json` with the brand's values and lock it with `--from <file>` (a new id), or skip
49
+ the lock and say the DS rules did not run.
50
+ 2. **The brief names a register.** A style keyword in the request picks it: pass the request as
51
+ `--brief` (or run `match`) and `init` locks the style whose keyword it contains, the longest
52
+ keyword winning, so "neo-brutalism" never lands on `computational-brutalism`. Brutalist,
53
+ brutalism, retro-futurist, CRT, 브루탈리즘 and 레트로퓨처 pick `computational-brutalism`;
54
+ neo-brutalism, neubrutalism and 네오브루탈리즘 pick `neo-brutalism`; `list` prints every
55
+ keyword. A register named in other words matches a style's `use_when` line: lock that style.
56
+ 3. **Competing directions left open** by the brief: ask, as `references/production-interview.md`
57
+ says, before locking.
58
+ 4. **No visual direction at all:** the family decides, and `init` without `--style` applies it.
59
+ A `landing` page (read once: landing, docs, report) locks `field-notes`, the authored default
60
+ profile (`references/default-editorial-pixel.json`) made complete: same palette, spacing, type
61
+ ranges and pixel-art rule, plus the fonts, radii, elevation and component anatomy the profile
62
+ left open. A `workspace` or `settings` screen (dashboards, settings, forms, admin and data-dense
63
+ screens) locks `graphite`. `meadow` is never a default; it needs a brief that asks for its
64
+ register. The same holds for `computational-brutalism` and `neo-brutalism`: opt-in only.
65
+
66
+ | Style | Register | Accent art |
67
+ |---|---|---|
68
+ | `field-notes` | Default for `landing`. Warm paper with notebook dots, deep ink, a terracotta accent with a deep-teal second accent, mist as the tint, thin rules instead of shadows, large editorial title, small lowercase mono labels | An original pixel motif on read-once pages (section 5) |
69
+ | `graphite` | Default for `workspace` and `settings`. Cool greys, white surfaces, a blue accent with a rose second accent, 6–8 px radii, soft two-layer elevation | None |
70
+ | `meadow` | Opt-in only. Near-white, deep teal accent, coral second accent, sand tint, 12–18 px radii, soft elevation | None |
71
+ | `computational-brutalism` | Opt-in only. Retro-futurist instrument with its structure on show: drafting-film grey on a 32 px plotting grid with a stronger line every 160 px, monospaced text and mono headings and figures at real size, square corners, 3 px section rules carrying `data-coord` labels, 2 px compartments with inverse ink header bars, uppercase mono meta, heavy uppercase display, a hazard-orange signal with a plotter-blue second accent; dark mode is a phosphor CRT with an amber signal. Flat elevation | Instrument parts (section 5) |
72
+ | `neo-brutalism` | Opt-in only. Lavender canvas, white surfaces, 3 px ink outlines on surfaces and 2 px on controls, zero-blur ink offset shadows (6 px surfaces, 3 px controls), solid sunflower-yellow panel heads and accent with ink text, an electric-blue second accent, pink support block, chunky 900-weight display and 800-weight headings, buttons that press into their shadow. Offset elevation | Stickers and colour blocks (section 5) |
73
+
74
+ Each style file also carries `signature` (what must show for the register to read) and `forbid`
75
+ (what breaks it); `design-lock.mjs list` prints both. The two brutalist registers differ on
76
+ purpose: computational brutalism is flat, square and monospaced, neo-brutalism is outlined, offset
77
+ and loud. Never mix their signatures on one page.
78
+
79
+ Families decide the skeleton, not the look:
80
+
81
+ | Family | Use for | Starter |
82
+ |---|---|---|
83
+ | `landing` | Pages read once: landing, product, launch, portfolio, docs home | Site bar, split hero, steps, feature split with a real kit view, quote, three plans, FAQ, footer |
84
+ | `workspace` | Screens worked in: dashboards, consoles, admin, tables | App shell (side nav, top bar), headline figures, 8 + 4 panel row, full-width table with filter and search |
85
+ | `settings` | Guided forms: settings, account, onboarding, checkout | Section index plus one column capped near 720 px, labelled fields with hints and errors, save bar with status, danger zone with a typed confirmation dialog |
86
+
87
+ A starter is a skeleton: keep its order unless the brief says otherwise, delete what the brief does
88
+ not ask for, add sections by reusing its parts. Replace every `{{slot}}`; the probe fails a page
89
+ that still shows one (DS-006). Mixed products use one style and the family of each screen.
90
+
91
+ ## 2. Build only with the kit
92
+
93
+ - Link `ui/tokens.css` first, then `ui/components.css`, then page rules. Load `ui/ui.js` with
94
+ `defer` when a chart, sortable table or tab set is on the page.
95
+ - Page rules may set layout (grid areas, widths, order, `gap`) and may only use `var(--…)` for
96
+ colour, type size, weight, radius, shadow, spacing and duration. A literal colour, font family or
97
+ off-scale size is drift; the probe reports it (DS-002 to DS-005).
98
+ - Something the kit lacks is built from tokens in a page rule, in the kit's idiom. It is not a reason
99
+ to import a framework, a second icon set or another font.
100
+ - Copy is still the work: product names, numbers and sentences specific to the brief. Mark invented
101
+ figures as examples where a reader could take them as real.
102
+
103
+ ### Class catalogue
104
+
105
+ | Area | Classes |
106
+ |---|---|
107
+ | Type | `ui-display` (the one display title), `ui-h1` `ui-h2` `ui-h3` `ui-h4`, `ui-lead`, `ui-body`, `ui-muted`, `ui-small`, `ui-meta`, `ui-label` (mono, lowercase, short), `ui-num` (tabular), `ui-code` |
108
+ | Layout | `ui-container` (`--narrow`, `--wide`), `ui-section` (`--sunken`), `ui-band` (`--accent-2`, `--support`: a full-bleed colour band whose text takes the band's ink), `ui-section-head`, `ui-stack` (`--tight`, `--loose`), `ui-cluster`, `ui-split` (`--even`, `--top`), `ui-grid` with `--cols` |
109
+ | Actions | `ui-btn` with `--primary`, `--ink`, `--quiet`, `--danger`, `--sm`; one primary per view |
110
+ | Forms | `ui-field` with `__label`, `__hint`, `__error`; `ui-input`, `ui-select`, `ui-textarea`; `ui-input-group` with `__addon`; `ui-check`; `ui-switch` (a checkbox with `role="switch"`); `ui-segmented` (buttons with `aria-pressed`); `ui-form-actions` |
111
+ | Surfaces | `ui-panel` (`--flush`, `--accent-2`) with `__head` and `__title`; `ui-wash` (the two-accent wash); `ui-glow` (the lock's glow, for one surface such as the moment); `ui-rule`; `ui-callout` (`--info`, `--positive`, `--warning`, `--negative`) |
112
+ | Status | `ui-status` (`--positive`, `--warning`, `--negative`, `--info`) always with words; `ui-tag` with the same variants, `--accent` and `--accent-2` |
113
+ | Figures | `ui-stat-row` of `ui-stat` with `__label`, `__value` (a `div`), `__note`; `ui-meter` with an inner `span` width |
114
+ | Tables | `ui-table-wrap` around every `ui-table` (`--compact`, `--stack` for phones with `data-label` on each cell); numeric cells `is-num`; sortable headers `<th><button class="ui-sort">` inside `table[data-ui-sortable]` |
115
+ | Lists | `ui-list`, `ui-steps` (an `ol` of real steps), `ui-checklist` |
116
+ | Disclosure | `details.ui-disclosure`, `ui-tabs` with `role="tablist"` and `data-ui-tabs`, `dialog.ui-dialog` with `__body` and `__actions`, `ui-toast-region` and `ui-toast` |
117
+ | Site | `ui-skip`, `ui-sitebar` with `__inner`, `ui-brand`, `ui-sitenav`, `details.ui-menu` with `__panel`, `ui-hero` (`--stage`: the art takes the larger column and the height) with `__copy` and `__art`, `ui-quote`, `ui-plans` of `ui-plan` (`--featured`) with `__price`, `ui-cta-band`, `ui-footer`, `ui-pixel` |
118
+ | App | `ui-app` with `__nav` and `__main`, `ui-navgroup` with `__label`, `ui-navlist` with `aria-current`, `ui-topbar`, `ui-page` with `__head` and `__title`, `ui-workgrid` with `ui-span-12/8/7/6/5/4/3`, `ui-scroll`, `ui-toolbar`, `ui-search`, `ui-empty` |
119
+ | Settings | `ui-settings` with `__nav` and `__body`, `ui-setting-section` (`--danger`) with `__head`, `ui-savebar` |
120
+ | Moment | `ui-setpiece` (display type at the lock's moment size), `ui-bignum` (one figure at moment size, heading font, tabular); both only inside `[data-ui-moment]` (section 6); they run at a tight line height, so give the caption under one a `--sp-24` gap |
121
+ | Signature | `ui-coord` (bracketed mono coordinate or measurement label), `ui-prompt` (a `>` prefix; `--cursor` adds a static block cursor), `data-coord="…"` on a `ui-section` or `ui-hero` (a label on the section rule where the lock shows section marks), `ui-ruler` (tick bar), `ui-frame` (a ruled box with registration crosses), `ui-scan` (static scanlines), `ui-readout` (mono value well), `ui-panel--accent` and `ui-panel--support` (colour blocks), `ui-sticker` (tilted tag) |
122
+ | Charts | `UI.bars(el, { labels, series: [{ name, values, role: "chart-1" }], marker: { index, label }, caption, indexLabel, unit, stacked })` and `UI.lines(…)`; roles are `chart-1` to `chart-5`; each chart gets a legend when it has two series and a "Show as table" fallback |
123
+
124
+ ## 3. What the probe checks against the lock
125
+
126
+ `scripts/probe.mjs` finds `design.lock.json` beside the page it serves (or takes `--lock <path>`)
127
+ and runs these rules at every matrix row. Without a lock they are listed under Not verified.
128
+
129
+ | Id | Rule | Severity |
130
+ |---|---|---|
131
+ | DS-001 | `ui/tokens.css` is not applied: `--ui-lock` on `:root` is missing or names another style | HIGH |
132
+ | DS-002 | Visible text set in a family the lock does not name | HIGH |
133
+ | DS-003 | Text, background, border or SVG colour more than 8 per channel from every palette role (light and dark); four or more distinct colours is HIGH, fewer is MEDIUM | HIGH / MEDIUM |
134
+ | DS-004 | Font size neither on the scale (±0.5 px) nor inside the display range | MEDIUM |
135
+ | DS-005 | Corner radius not in the lock and not fully round | LOW |
136
+ | DS-006 | A `{{slot}}` from a starter left in text, a title or a labelling attribute (`probe.mjs --static` reads one `.html` file and flags a leftover slot; framework templates use braces, so run the rendered probe for those) | HIGH |
137
+ | DS-007 | A shadow outside the lock's elevation grammar: a `flat` lock (computational-brutalism) takes only rings, no blur and no offset past a hairline; an `offset` lock (neo-brutalism) takes zero-blur offsets but no blur. Inset shadows never count; `soft` locks leave offsets to CF-403 | MEDIUM |
138
+ | DS-008 | The signature moment: the lock declares none (a lock written before signature moments counts; add one with `design-lock.mjs moment`); no visible `[data-ui-moment]`; the marked kind differs from the lock; it is smaller than 40 000 px² (bold) or 4 800 px² (small); a read-once page's moment starts below the first screen at 1024 px and wider (more than 120 px short of the fold) or past 1.5 screens on narrower viewports; it lacks what its kind needs (section 6); or it is a generic gradient-and-centred-text hero. Two marked moments, and a work-surface moment over half the screen at 1024 px and wider, are MEDIUM. Fold and size-share checks run on the four plain light rows (320, 390, 768, 1440) | HIGH |
139
+
140
+ CF-403 is a review row in this skill, not a measured one. A lock with `offset` elevation is the
141
+ recorded neo-brutalist register it asks about, so offset shadows plus heavy borders are the style
142
+ there, not decoration; DS-007 is the measured elevation check and holds every lock to its grammar.
143
+
144
+ Media, `img`, `video`, `canvas`, `iframe` and anything inside `[data-lock-exempt]` are skipped. Use
145
+ the exemption only for third-party embeds and real brand marks, and say so in the reply.
146
+
147
+ Thresholds live in `LOCK_RULES` in `scripts/rule-data.mjs`, beside the other numeric policy. Never widen a
148
+ tolerance or add an exemption to make a page pass; change the page.
149
+
150
+ ## 4. Look, then fix
151
+
152
+ After the findings, a rendered probe run prints the paths of the 1440, 390 and 320 screenshots on
153
+ stderr, with six fixed questions (LOOK-1 to LOOK-6: one focal point, shared edges, grouping by space, kit not
154
+ costume, composed mobile, specific content). Open the screenshots, answer each question in one line,
155
+ fix the two worst answers, and run the probe again. Stop after two look rounds; keep the better
156
+ version if a round made it worse. The questions are concrete on purpose: a reviewer, human or
157
+ model, agrees with itself on "do the sections share a left edge" far more often than on "is it
158
+ beautiful".
159
+
160
+ ## 5. Accent art by style
161
+
162
+ The landing starter's art slot takes the locked style's art; work surfaces keep at most a small mark.
163
+
164
+ | Style | Accent art |
165
+ |---|---|
166
+ | `field-notes` | The pixel motif below |
167
+ | `graphite`, `meadow` | A real product view set on a `ui-wash` or between `ui-band` sections, with the second accent on the featured panel |
168
+ | `computational-brutalism` | Instrument parts on real content: a `ui-frame` around the product view or a key figure, `ui-coord` labels that name real positions, sizes or revisions, one `ui-ruler`, `data-coord` on each section (sheet, grid reference or revision, not 01/02/03), a `ui-prompt--cursor` line, and `ui-readout ui-scan` wells on the readouts that carry real values. No made-up telemetry: every number labels something on the page |
169
+ | `neo-brutalism` | `ui-sticker` labels with real facts (price, launch date, a count), never over body text, and colour blocks in all three fills (`ui-panel--accent`, `ui-panel--accent-2`, `ui-panel--support`) |
170
+
171
+ ### Pixel motif (field-notes)
172
+
173
+ On read-once pages the field-notes hero carries an original pixel motif of the product's subject.
174
+ Draw it as a character grid and convert it, rather than hand-placing rectangles:
175
+
176
+ ```bash
177
+ node "$FRONTEND_UIUX_SKILL_ROOT/scripts/pixel-art.mjs" motif.txt --label "<what it shows>" --cell 12
178
+ ```
179
+
180
+ Characters map to palette roles (`i` ink, `a` accent, `b` second accent, `m` support, `s` sunken, `p` surface,
181
+ `c` canvas, `l` line-strong, `2` ink-2, `.` empty), so the motif follows dark mode and stays inside
182
+ the lock. Keep it recognisable: a scene of the product's subject, 20 to 64 cells wide, hard edges, as
183
+ many roles as the subject needs, the accent on the one detail that matters. Cells render at 6 px or more. On a
184
+ work surface the motif is at most a small mark beside the product name.
185
+
186
+ ## 6. Signature moment
187
+
188
+ The lock makes runs agree on the look. The signature moment is the one place a page is allowed to be
189
+ bold, so a locked page still has something that makes a person stop. Choose it from the content before
190
+ writing markup, record it in the lock, mark it in the page, and let the probe check it (DS-008).
191
+
192
+ 1. Record it: `init … --moment <kind> --moment-note "<what it shows>" [--moment-place "<where>"]`, or
193
+ later `design-lock.mjs moment --dir <project> --kind <kind> --note "<what it shows>"`. Until a kind
194
+ is recorded the probe fails every render.
195
+ 2. Mark the one element that carries it: `data-ui-moment="<kind>"`.
196
+ 3. Build it from this page's content, inside the lock: palette roles, the kit's type, radii and
197
+ elevation. The moment may use `--fs-moment` (`ui-setpiece`, `ui-bignum`) up to the lock's moment
198
+ ceiling; DS-004 accepts that size only inside `[data-ui-moment]`.
199
+
200
+ | Family | Scale | Kinds | Where |
201
+ |---|---|---|---|
202
+ | `landing` (landing, product, launch, portfolio, docs home, report) | bold | `hero-composition`, `type-set-piece`, `data-moment`, `diagram`, `motion-detail`, `interactive-object` | Starts in the first screen at 1024 px and wider, within 1.5 screens on phones |
203
+ | `workspace`, `settings` | small | `chart`, `empty-state`, `header-detail` | Anywhere; under half the screen at desktop widths. The data stays the focus |
204
+
205
+ | Kind | What it is | DS-008 needs inside it |
206
+ |---|---|---|
207
+ | `hero-composition` | The hero arranged around the product's one concrete object: the invoice, the truck, the score, drawn or built from kit parts at a size that dominates the first screen (`ui-hero--stage`) | An image, drawing, figure, frame or product view |
208
+ | `type-set-piece` | The pitch set as type: a short line at moment size with the accent on the one word that matters, aligned to the grid, never centred over a gradient | Text at display size or above |
209
+ | `data-moment` | One real number or small dataset made big: a `ui-bignum` with its unit and source, a chart that answers the page's question | A chart, table, figure or readout |
210
+ | `diagram` | The product's process or structure drawn once, clearly: inputs, the step the product does, the result | An image, drawing or figure |
211
+ | `motion-detail` | One movement that explains something (a figure counting up to its real value, a step sequence), short, in the style's durations, stopped under reduced motion (RS-003) | An animation or transition (not checked on the reduced-motion row) |
212
+ | `interactive-object` | Something to try on the page: a fee calculator, a toggle between before and after, a slider on a real variable | A control a reader can operate |
213
+ | `chart` | The work surface's main chart, with one annotated marker that names the event a person acts on | A chart, table or readout |
214
+ | `empty-state` | The empty state drawn with care: a small mark from the style, one sentence, the next action | Nothing beyond presence |
215
+ | `header-detail` | The page header's one detail: the product mark, a live status, the plan or period, set with care | Nothing beyond presence |
216
+
217
+ Choose the kind from the content in this order: the one object or number the reader cares about
218
+ (`data-moment`, `hero-composition`); a process they must grasp (`diagram`); words that carry the
219
+ pitch (`type-set-piece`); something worth trying (`interactive-object`); `motion-detail` only when
220
+ movement is the point. State the choice and the note in the reply.
221
+
222
+ Moments by style:
223
+
224
+ | Style | A moment that belongs to it |
225
+ |---|---|
226
+ | `field-notes` | A pixel scene of the product's subject filling the art column (`ui-hero--stage`, cells of 10 to 16 px, the accent on the one detail that matters), or a `ui-setpiece` line in the editorial display with a small pixel mark |
227
+ | `graphite`, `meadow` | On a landing page, the real product view at full size with one live state shown (`ui-panel` parts, `UI.bars`); on a work surface, the main chart with its annotated marker |
228
+ | `computational-brutalism` | An instrument plate on the plot grid: a `ui-frame` holding a `ui-bignum` readout in mono at moment size, a `ui-ruler` and `ui-coord` labels that measure real values, one `ui-scan`; or a heavy uppercase `ui-setpiece` that spans the grid columns |
229
+ | `neo-brutalism` | A stacked block composition: the product object in a `ui-panel--accent` with its offset shadow, more blocks in `ui-panel--accent-2` and `ui-panel--support`, `ui-sticker` labels with real facts, chunky `ui-setpiece` type |
230
+
231
+ Never, in a moment or anywhere: a centred headline over a gradient (DS-008 reports it as a generic
232
+ hero), scattered floating blobs, glass, a stock 3D object, a fake dashboard with invented numbers, or
233
+ a second moment competing with the first. Everything outside the moment stays inside the kit and, in
234
+ the default rich register, may be layered: bands, a wash, the style's texture, the second accent and
235
+ an atmosphere glow.
@@ -2,7 +2,7 @@
2
2
 
3
3
  This guide turns motion into a small, testable part of the interface. Start with one sentence naming the page, target components, and out-of-scope areas; follow it with labeled sections in implementation order. Specify the stack, visual tokens, layers, timing, viewport behavior, reduced-motion behavior, assets, and performance limits before describing a page. Name exact files or components so the implementation does not invent unrelated sections. A page brief may name component families such as hero, pricing, footer, or dashboard before detailing the chosen one.
4
4
 
5
- All values below are starting defaults. Keep the page calm when motion does not explain hierarchy, state, or cause and effect.
5
+ All values below are starting defaults. Motion earns its place by explaining hierarchy, state, or cause and effect, and a rich lock (the default; see `house-styles.md`) layers more of it: up to four elements may move together in a section. The flash and reduced-motion floors do not relax at any density, and a calm brief or `calm` lock keeps the page quiet.
6
6
 
7
7
  ## 1. Stack, tokens, and composition
8
8
 
@@ -49,7 +49,7 @@ Use named curves so a later editor can change the motion family without hunting
49
49
 
50
50
  ## 3. Motion and resource budgets
51
51
 
52
- **Do:** Give each section one entrance sequence and no more than two simultaneously moving elements. Give the hero one principal scroll or entrance effect and one animated headline. Keep controls responsive while decorative motion runs.
52
+ **Do:** Give each section one entrance sequence and no more than two simultaneously moving elements on a calm lock (four on a rich one). Give the hero one principal scroll or entrance effect and one animated headline. Keep controls responsive while decorative motion runs.
53
53
 
54
54
  **Don't:** animate the headline, background, cards, icons, and navigation at once. Remove any motion whose absence does not change comprehension or feedback.
55
55
 
@@ -28,6 +28,12 @@ Build follows build → probe → fix, at most three fix rounds, then a final pr
28
28
 
29
29
  The probe's JSON contains `{manifest,findings}`. A finding has `rule`, `severity`, `tier`, `viewport`, `value`, `threshold`, and optionally `selector`/`note`. `measured` means a direct style, rect, pixel, or state read; `derived` means a calculation from sound measured inputs. If a source value is unreadable or stale, downgrade the claim to inferred prose or put the rule in `manifest.not_verified`. Human-only JUDG observations are `Inferred` in the report and never fabricated as machine JSON.
30
30
 
31
+ ## Design lock and look review
32
+
33
+ A build starts from a lock, not from taste. `node "$FRONTEND_UIUX_SKILL_ROOT/scripts/design-lock.mjs" init --brief "<the user's words>" --dir <project>` picks one of five house styles (or take `--style`), writes `design.lock.json` and the token layer, and scaffolds the kit; `references/house-styles.md` holds the catalogue, density, signature moment and starters. The probe finds `design.lock.json` beside the page (or `--lock path`) and adds DS-001..008: tokens present, no off-palette colour, type and radius drift, leftover `{{slot}}` text, elevation grammar, and the declared signature moment. Without a lock the DS rules go to **Not verified**; the manifest records `design_lock`.
34
+
35
+ After a run with a browser, the probe prints the 1440, 390 and 320 screenshot paths and the LOOK-1..6 rubric on stderr. Open those images and answer each LOOK row from what you see; a rubric answer is Inferred prose, never a measured row, and a page that passes every rule can still fail the look.
36
+
31
37
  ## Human review
32
38
 
33
39
  Present the findings table with exactly these columns:
@@ -12,6 +12,8 @@ Keep the direction to hierarchy, visual language, key interaction, and why it fi
12
12
 
13
13
  When visual direction is absent, apply the authored default profile in `references/default-editorial-pixel.json`. Its original crisp pixel illustration is the primary visual anchor: draw aligned square cells (or use true pixel art), render cells at least 6 CSS pixels, preserve crisp edges, and do not substitute smooth vector curves as the only featured artwork or a pixel icon/background grid alone. Echo one art color in a nearby interface detail without reducing contrast. Recompose at 320px, 390px, and 1440px; the full subject stays visible and recognizable without horizontal overflow. An explicit user direction can replace this profile.
14
14
 
15
+ For a new page or screen, lock the look first: `scripts/design-lock.mjs init` chooses one of the five house styles from the brief (`references/house-styles.md`), defaults to the rich density, and goes calm only when the user asks for minimal, quiet or restrained. SKILL.md's "Choose the design first" step asks the user to pick the house style, family and density with one `request_user_input` call or a numbered list; only after that step is answered, skipped (a named style, "you choose", "알아서", bare `lit`) or taken as the recommended option in a non-interactive run does the default profile above, the field-notes look, apply without asking.
16
+
15
17
  ## Contract with implementation
16
18
 
17
19
  Settle direction and finite inventory, then create or evolve `design-contract.json` with `schema_id: "litfamily.design-contract/v1beta2"` alongside authorized implementation. Validate it before acceptance, not as a gate that stalls a sufficiently specified build. Use actual repository identifiers and evidence, not schema examples. Include source state, scope, inventory, tokens, responsive and keyboard behavior, reduced motion, access/performance budgets, acceptance checks, omissions, and accepted exceptions. Keep earlier contracts intact. Validate with `scripts/validate-design-contract.mjs --input design-contract.json`.