@once-ui-system/core 1.8.5 → 2.0.0-alpha.1

package/dist/ai/components/SettingAxes.json

@@ -0,0 +1,127 @@
+{
+ "name": "SettingAxes",
+ "group": "components",
+ "extends": [
+  "Flex"
+ ],
+ "mixins": [
+  "CommonProps",
+  "DisplayProps",
+  "FlexProps",
+  "SizeProps",
+  "SpacingProps",
+  "StyleProps"
+ ],
+ "props": {
+  "label": "React.ReactNode",
+  "info": "React.ReactNode",
+  "axes": "!{ label: React.ReactNode; control: React.ReactNode }[]",
+  "axisWidth": "number = 13"
+ },
+ "mixinsRef": [
+  "CommonProps",
+  "DisplayProps",
+  "FlexProps",
+  "SizeProps",
+  "SpacingProps",
+  "StyleProps"
+ ],
+ "tokensRef": "see spec.json mixins",
+ "resolvedMixins": {
+  "CommonProps": {
+   "onBackground": "Colors",
+   "onSolid": "Colors",
+   "align": "CSSProperties[\"textAlign\"]"
+  },
+  "DisplayProps": {
+   "as": "ElementType",
+   "inline": "boolean",
+   "hide": "boolean",
+   "pointerEvents": "\"none\" | \"all\" | \"auto\"",
+   "position": "CSSProperties[\"position\"]",
+   "overflow": "CSSProperties[\"overflow\"]",
+   "overflowX": "CSSProperties[\"overflowX\"]",
+   "overflowY": "CSSProperties[\"overflowY\"]",
+   "scrollbar": "\"default\" | \"minimal\"",
+   "transition": "\"micro-short\" | \"micro-medium\" | \"micro-long\" | \"macro-short\" | \"macro-medium\" | \"macro-long\"",
+   "opacity": "Opacity",
+   "zIndex": "-1 | 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | \"-1\" | \"0\" | \"1\" | \"2\" | \"3\" | \"4\" | \"5\" | \"6\" | \"7\" | \"8\" | \"9\" | \"10\"",
+   "dark": "boolean",
+   "light": "boolean"
+  },
+  "FlexProps": {
+   "direction": "\"row\" | \"column\" | \"row-reverse\" | \"column-reverse\"",
+   "horizontal": "\"start\" | \"center\" | \"end\" | \"between\" | \"around\" | \"even\" | \"stretch\"",
+   "vertical": "\"start\" | \"center\" | \"end\" | \"between\" | \"around\" | \"even\" | \"stretch\"",
+   "center": "boolean",
+   "wrap": "boolean",
+   "flex": "FlexValue"
+  },
+  "SizeProps": {
+   "width": "number | SpacingToken | CSSUnit",
+   "height": "number | SpacingToken | CSSUnit",
+   "maxWidth": "number | SpacingToken | CSSUnit",
+   "minWidth": "number | SpacingToken | CSSUnit",
+   "minHeight": "number | SpacingToken | CSSUnit",
+   "maxHeight": "number | SpacingToken | CSSUnit",
+   "fit": "boolean",
+   "fitWidth": "boolean",
+   "fitHeight": "boolean",
+   "fill": "boolean",
+   "fillWidth": "boolean",
+   "fillHeight": "boolean",
+   "aspectRatio": "CSSProperties[\"aspectRatio\"]"
+  },
+  "SpacingProps": {
+   "padding": "SpacingToken | number",
+   "paddingLeft": "SpacingToken | number",
+   "paddingRight": "SpacingToken | number",
+   "paddingTop": "SpacingToken | number",
+   "paddingBottom": "SpacingToken | number",
+   "paddingX": "SpacingToken | number",
+   "paddingY": "SpacingToken | number",
+   "margin": "SpacingToken | number",
+   "marginLeft": "SpacingToken | number",
+   "marginRight": "SpacingToken | number",
+   "marginTop": "SpacingToken | number",
+   "marginBottom": "SpacingToken | number",
+   "marginX": "SpacingToken | number",
+   "marginY": "SpacingToken | number",
+   "gap": "SpacingToken | number | \"-1\"",
+   "top": "SpacingToken | number | CSSUnit",
+   "right": "SpacingToken | number | CSSUnit",
+   "bottom": "SpacingToken | number | CSSUnit",
+   "left": "SpacingToken | number | CSSUnit",
+   "translateX": "SpacingToken | number | CSSUnit",
+   "translateY": "SpacingToken | number | CSSUnit"
+  },
+  "StyleProps": {
+   "textVariant": "TextVariant",
+   "textSize": "TextSize",
+   "textType": "TextType",
+   "textWeight": "TextWeight",
+   "background": "Colors | \"surface\" | \"overlay\" | \"page\" | \"transparent\"",
+   "solid": "Colors",
+   "borderTop": "Colors | \"surface\" | \"transparent\" | boolean",
+   "borderRight": "Colors | \"surface\" | \"transparent\" | boolean",
+   "borderBottom": "Colors | \"surface\" | \"transparent\" | boolean",
+   "borderLeft": "Colors | \"surface\" | \"transparent\" | boolean",
+   "borderX": "Colors | \"surface\" | \"transparent\" | boolean",
+   "borderY": "Colors | \"surface\" | \"transparent\" | boolean",
+   "border": "Colors | \"surface\" | \"transparent\" | boolean",
+   "borderStyle": "\"solid\" | \"dashed\"",
+   "borderWidth": "1 | 2 | 4 | 8 | \"1\" | \"2\" | \"4\" | \"8\"",
+   "topRadius": "RadiusSize",
+   "rightRadius": "RadiusSize",
+   "bottomRadius": "RadiusSize",
+   "leftRadius": "RadiusSize",
+   "topLeftRadius": "RadiusSize",
+   "topRightRadius": "RadiusSize",
+   "bottomLeftRadius": "RadiusSize",
+   "bottomRightRadius": "RadiusSize",
+   "shadow": "ShadowSize",
+   "cursor": "CSSProperties[\"cursor\"] | \"interactive\" | ReactNode",
+   "radius": "RadiusSize | `${RadiusSize}-${RadiusNest}`"
+  }
+ }
+}

package/dist/ai/components/SettingGroup.json

@@ -0,0 +1,129 @@
+{
+ "name": "SettingGroup",
+ "group": "components",
+ "extends": [
+  "Flex"
+ ],
+ "mixins": [
+  "CommonProps",
+  "DisplayProps",
+  "FlexProps",
+  "SizeProps",
+  "SpacingProps",
+  "StyleProps"
+ ],
+ "props": {
+  "label": "React.ReactNode",
+  "description": "React.ReactNode",
+  "info": "React.ReactNode",
+  "control": "React.ReactNode",
+  "open": "boolean",
+  "children": "React.ReactNode"
+ },
+ "mixinsRef": [
+  "CommonProps",
+  "DisplayProps",
+  "FlexProps",
+  "SizeProps",
+  "SpacingProps",
+  "StyleProps"
+ ],
+ "tokensRef": "see spec.json mixins",
+ "resolvedMixins": {
+  "CommonProps": {
+   "onBackground": "Colors",
+   "onSolid": "Colors",
+   "align": "CSSProperties[\"textAlign\"]"
+  },
+  "DisplayProps": {
+   "as": "ElementType",
+   "inline": "boolean",
+   "hide": "boolean",
+   "pointerEvents": "\"none\" | \"all\" | \"auto\"",
+   "position": "CSSProperties[\"position\"]",
+   "overflow": "CSSProperties[\"overflow\"]",
+   "overflowX": "CSSProperties[\"overflowX\"]",
+   "overflowY": "CSSProperties[\"overflowY\"]",
+   "scrollbar": "\"default\" | \"minimal\"",
+   "transition": "\"micro-short\" | \"micro-medium\" | \"micro-long\" | \"macro-short\" | \"macro-medium\" | \"macro-long\"",
+   "opacity": "Opacity",
+   "zIndex": "-1 | 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | \"-1\" | \"0\" | \"1\" | \"2\" | \"3\" | \"4\" | \"5\" | \"6\" | \"7\" | \"8\" | \"9\" | \"10\"",
+   "dark": "boolean",
+   "light": "boolean"
+  },
+  "FlexProps": {
+   "direction": "\"row\" | \"column\" | \"row-reverse\" | \"column-reverse\"",
+   "horizontal": "\"start\" | \"center\" | \"end\" | \"between\" | \"around\" | \"even\" | \"stretch\"",
+   "vertical": "\"start\" | \"center\" | \"end\" | \"between\" | \"around\" | \"even\" | \"stretch\"",
+   "center": "boolean",
+   "wrap": "boolean",
+   "flex": "FlexValue"
+  },
+  "SizeProps": {
+   "width": "number | SpacingToken | CSSUnit",
+   "height": "number | SpacingToken | CSSUnit",
+   "maxWidth": "number | SpacingToken | CSSUnit",
+   "minWidth": "number | SpacingToken | CSSUnit",
+   "minHeight": "number | SpacingToken | CSSUnit",
+   "maxHeight": "number | SpacingToken | CSSUnit",
+   "fit": "boolean",
+   "fitWidth": "boolean",
+   "fitHeight": "boolean",
+   "fill": "boolean",
+   "fillWidth": "boolean",
+   "fillHeight": "boolean",
+   "aspectRatio": "CSSProperties[\"aspectRatio\"]"
+  },
+  "SpacingProps": {
+   "padding": "SpacingToken | number",
+   "paddingLeft": "SpacingToken | number",
+   "paddingRight": "SpacingToken | number",
+   "paddingTop": "SpacingToken | number",
+   "paddingBottom": "SpacingToken | number",
+   "paddingX": "SpacingToken | number",
+   "paddingY": "SpacingToken | number",
+   "margin": "SpacingToken | number",
+   "marginLeft": "SpacingToken | number",
+   "marginRight": "SpacingToken | number",
+   "marginTop": "SpacingToken | number",
+   "marginBottom": "SpacingToken | number",
+   "marginX": "SpacingToken | number",
+   "marginY": "SpacingToken | number",
+   "gap": "SpacingToken | number | \"-1\"",
+   "top": "SpacingToken | number | CSSUnit",
+   "right": "SpacingToken | number | CSSUnit",
+   "bottom": "SpacingToken | number | CSSUnit",
+   "left": "SpacingToken | number | CSSUnit",
+   "translateX": "SpacingToken | number | CSSUnit",
+   "translateY": "SpacingToken | number | CSSUnit"
+  },
+  "StyleProps": {
+   "textVariant": "TextVariant",
+   "textSize": "TextSize",
+   "textType": "TextType",
+   "textWeight": "TextWeight",
+   "background": "Colors | \"surface\" | \"overlay\" | \"page\" | \"transparent\"",
+   "solid": "Colors",
+   "borderTop": "Colors | \"surface\" | \"transparent\" | boolean",
+   "borderRight": "Colors | \"surface\" | \"transparent\" | boolean",
+   "borderBottom": "Colors | \"surface\" | \"transparent\" | boolean",
+   "borderLeft": "Colors | \"surface\" | \"transparent\" | boolean",
+   "borderX": "Colors | \"surface\" | \"transparent\" | boolean",
+   "borderY": "Colors | \"surface\" | \"transparent\" | boolean",
+   "border": "Colors | \"surface\" | \"transparent\" | boolean",
+   "borderStyle": "\"solid\" | \"dashed\"",
+   "borderWidth": "1 | 2 | 4 | 8 | \"1\" | \"2\" | \"4\" | \"8\"",
+   "topRadius": "RadiusSize",
+   "rightRadius": "RadiusSize",
+   "bottomRadius": "RadiusSize",
+   "leftRadius": "RadiusSize",
+   "topLeftRadius": "RadiusSize",
+   "topRightRadius": "RadiusSize",
+   "bottomLeftRadius": "RadiusSize",
+   "bottomRightRadius": "RadiusSize",
+   "shadow": "ShadowSize",
+   "cursor": "CSSProperties[\"cursor\"] | \"interactive\" | ReactNode",
+   "radius": "RadiusSize | `${RadiusSize}-${RadiusNest}`"
+  }
+ }
+}

package/dist/ai/components/ShineFx.json

@@ -8,7 +8,7 @@
   "TextProps"
  ],
  "props": {
-  "speed": "number = 1",
+  "speed": "number = 1000",
   "disabled": "boolean = false",
   "inverse": "boolean = false",
   "baseOpacity": "number = 0.3",

package/dist/ai/components/Skeleton.json

@@ -14,9 +14,8 @@
  ],
  "props": {
   "shape": "!\"line\" | \"circle\" | \"block\" = line",
-  "width": "\"xl\" | \"l\" | \"m\" | \"s\" | \"xs\" = m",
-  "height": "\"xl\" | \"l\" | \"m\" | \"s\" | \"xs\" = m",
-  "delay": "\"1\" | \"2\" | \"3\" | \"4\" | \"5\" | \"6\"",
+  "size": "\"xl\" | \"l\" | \"m\" | \"s\" | \"xs\" = m",
+  "delay": "number",
   "style": "React.CSSProperties",
   "className": "string"
  },

package/dist/ai/components/SplitView.json

@@ -16,6 +16,8 @@
  "props": {
   "leftPanel": "!ReactNode",
   "rightPanel": "!ReactNode",
+  "labels": "{ left: string; right: string }",
+  "collapseBelow": "BreakpointKey | false = s",
   "defaultSplit": "number = 0.3",
   "minSplit": "number = 0.2",
   "maxSplit": "number = 0.8"

package/dist/ai/components/StylePanel.json

@@ -2,6 +2,7 @@
  "name": "StylePanel",
  "group": "components",
  "extends": [
+  "Column",
   "Flex"
  ],
  "mixins": [
@@ -13,8 +14,9 @@
   "StyleProps"
  ],
  "props": {
-  "style": "React.CSSProperties",
-  "className": "string"
+  "visibility": "StylePanelVisibility",
+  "value": "StylePanelRootProps[\"value\"]",
+  "onChange": "StylePanelRootProps[\"onChange\"]"
  },
  "mixinsRef": [
   "CommonProps",

package/dist/ai/components/Swatch.json

@@ -0,0 +1,11 @@
+{
+ "name": "Swatch",
+ "group": "data",
+ "importFrom": "@once-ui-system/core/data",
+ "props": {
+  "color": "!string",
+  "size": "\"s\" | \"m\" = m",
+  "variant": "ChartVariant = useDataTheme().variant"
+ },
+ "mixinsRef": []
+}

package/dist/ai/components/Swiper.json

@@ -16,7 +16,7 @@
   "items": "!SwiperItem[] = []",
   "controls": "boolean | \"contained\" = true",
   "priority": "boolean = false",
-  "fill": "boolean = false",
+  "stretch": "boolean = false",
   "aspectRatio": "string = 16 / 9",
   "sizes": "string",
   "unoptimized": "boolean = false",

package/dist/ai/components/Switch.json

@@ -7,7 +7,7 @@
  "props": {
   "style": "React.CSSProperties",
   "className": "string",
-  "isChecked": "!boolean",
+  "checked": "!boolean",
   "loading": "boolean = false",
   "name": "string",
   "value": "string",

package/dist/ai/components/Tag.json

@@ -13,7 +13,7 @@
   "StyleProps"
  ],
  "props": {
-  "variant": "ColorScheme | \"gradient\" = neutral",
+  "scheme": "ColorScheme | \"gradient\" = neutral",
   "size": "CondensedTShirtSizes = m",
   "label": "string = ",
   "prefixIcon": "IconName",

package/dist/ai/components/Textarea.json

@@ -5,16 +5,17 @@
   "id": "!string",
   "label": "string",
   "placeholder": "string",
-  "lines": "number | \"auto\" = 3",
-  "height": "TShirtSizes = m",
+  "lines": "number | \"auto\" = auto",
+  "size": "TShirtSizes = m",
   "error": "boolean = false",
   "errorMessage": "ReactNode",
   "description": "ReactNode",
-  "radius": "\"none\" | \"top\" | \"right\" | \"bottom\" | \"left\" | \"top-left\" | \"top-right\" | \"bottom-right\" | \"bottom-left\"",
+  "corners": "\"none\" | \"top\" | \"right\" | \"bottom\" | \"left\" | \"top-left\" | \"top-right\" | \"bottom-right\" | \"bottom-left\"",
   "className": "string",
-  "hasPrefix": "ReactNode",
-  "hasSuffix": "ReactNode",
+  "prefix": "ReactNode",
+  "suffix": "ReactNode",
   "variant": "\"default\" | \"ghost\" = default",
+  "focusRing": "boolean = false",
   "characterCount": "boolean",
   "resize": "\"horizontal\" | \"vertical\" | \"both\" | \"none\" = vertical",
   "validate": "(value: ReactNode) => ReactNode | null",

package/dist/ai/components/ThemeSwitcher.json

@@ -13,6 +13,9 @@
   "SpacingProps",
   "StyleProps"
  ],
+ "props": {
+  "collapsed": "boolean"
+ },
  "mixinsRef": [
   "CommonProps",
   "DisplayProps",

package/dist/ai/components/Toast.json

@@ -4,7 +4,7 @@
  "props": {
   "className": "string",
   "variant": "!\"success\" | \"danger\" | \"warning\" | \"info\"",
-  "icon": "boolean = true",
+  "showIcon": "boolean = true",
   "onClose": "() => void",
   "action": "React.ReactNode",
   "children": "!React.ReactNode"

package/dist/ai/components/ToggleButton.json

@@ -6,7 +6,8 @@
   "selected": "boolean = false",
   "variant": "\"ghost\" | \"outline\" | \"subtle\" = ghost",
   "size": "TShirtSizes = m",
-  "radius": "\"none\" | \"top\" | \"right\" | \"bottom\" | \"left\" | \"top-left\" | \"top-right\" | \"bottom-right\" | \"bottom-left\"",
+  "radius": "RadiusSize",
+  "corners": "\"none\" | \"top\" | \"right\" | \"bottom\" | \"left\" | \"top-left\" | \"top-right\" | \"bottom-right\" | \"bottom-left\"",
   "rounded": "boolean = false",
   "horizontal": "\"start\" | \"center\" | \"end\" | \"between\" = center",
   "fillWidth": "boolean = false",

package/dist/ai/eval-tasks.md

@@ -25,7 +25,8 @@ is found in the wild.
 Mechanical (count occurrences):
 
 - [ ] Compiles / no invented props or components
-- [ ] Redundant-default props (`position="relative"`, `variant="primary"` on Button, ...) — target: 0
+- [ ] Redundant-default props (`position="relative"`, `variant="primary"` on Button, `fillWidth` beside `maxWidth`, `minWidth={0}` beside `fillWidth`, `border="neutral-alpha-weak"` for the default border, ...) — target: 0
+- [ ] `zIndex` outside an isolated stacking group (nothing absolute/fixed/sticky nearby) — target: 0
 - [ ] Shorthand violations (`fillWidth fillHeight` instead of `fill`, `horizontal+vertical center` instead of `center`, `Flex direction=` instead of `Row`/`Column`) — target: 0
 - [ ] `style={{}}` uses where a token prop exists — target: 0
 - [ ] Raw HTML elements where a component exists (`img`, `a`, `button`) — target: 0
@@ -69,3 +70,11 @@ Record every recurring failure here; each entry should become a rule in
 | 2026-06-12 | Invented icon names (`more`, `bell`, `arrowRight`) | rules.md #14b, IconName list in spec.json |
 | 2026-06-12 | `Badge title` + children rendered same text twice ("2 unread2") | rules.md #14c |
 | 2026-06-12 | `Fade` wrapped the whole message list → washed-out content | rules.md #14d |
+| 2026-09-13 | `gotchas.json` still said `RevealFx.delay` is seconds after 2.0 made it ms — and the task bundles point at it, so an agent trusting the bundle got the wrong answer | `gotchas.json` `RevealFx.delay` |
+| 2026-09-13 | `bell` and `arrowRight` named as non-existent icons; both are registered. Reversed from the 06-12 entry above — the registry grew, the prose didn't | rules.md #14b, `gotchas.json` `Icon.names` |
+| 2026-09-13 | `Dashboard1.tsx` shipped `icon: "chat" as IconName` — unregistered, and the cast defeats the 2.0 union that would have caught it. No chat/comment icon exists | Dashboard1 uses `edit`; #14b names the gap |
+| 2026-09-13 | Gold `examples/pricing.tsx` imported `AccordionGroup` and never rendered it, leaving the FAQ component of the FAQ task with no call site to copy | import removed; `AccordionItem` shape still undocumented |
+| 2026-09-13 | Gold `examples/dashboard.tsx` used `style={{ cursor: "pointer" }}` on a `Text` — the exact defect the checklist scores, in the file agents copy | now a `Button variant="tertiary"` |
+| 2026-09-13 | rules.md #4's spacing list stopped at `"64"` while #17 requires `"80"`–`"160"` | #4 lists the full `SpacingToken` scale |
+| 2026-09-13 | rules.md #14 listed 4 Button variants; the slice has 10 | #14 matches the slice |
+| 2026-09-13 | **Open:** `LineChart`, `BarChart`, `MediaUpload` and `CodeBlock` have `props: {}` and extend `*.impl` / `interfaces`, neither of which the spec defines — the whole chart and upload API is invisible to the harness, and `BarChart` has no example either. Agents extrapolate or fall back | generator change, not yet made |

package/dist/ai/gotchas.json

@@ -1,86 +1,160 @@
 {
   "Background.gradient.width": {
     "rule": "Quarter-percent units: 400 = 100% of container. Soft glows use width 100–200, not 500.",
-    "components": ["Background"]
+    "components": [
+      "Background"
+    ]
   },
   "Background.gradient.x": {
     "rule": "x/y are percent positions of the container (50/50 = center).",
-    "components": ["Background"]
+    "components": [
+      "Background"
+    ]
   },
   "Background.absolute": {
     "rule": "Every absolute decorative layer needs top=\"0\" left=\"0\" or it offsets by parent padding.",
-    "components": ["Background", "MatrixFx", "BlobFx"]
+    "components": [
+      "Background",
+      "MatrixFx",
+      "BlobFx"
+    ]
   },
   "Card.interactive": {
-    "rule": "Card is for interactive surfaces only (href or onClick). Static panels use Column + background=\"surface\" border=\"neutral-alpha-weak\" radius=\"l\".",
-    "components": ["Card"]
+    "rule": "Card is for interactive surfaces only (href or onClick). Static panels use Column + background=\"surface\" border radius=\"l\".",
+    "components": [
+      "Card"
+    ]
   },
   "Fade.edge": {
     "rule": "Fade is an edge overlay strip on scroll containers, not a content wrapper.",
-    "components": ["Fade"]
+    "components": [
+      "Fade"
+    ]
   },
   "RevealFx.delay": {
-    "rule": "delay is in seconds — stagger with delay={index * 0.1}, never index * 80.",
-    "components": ["RevealFx"]
+    "rule": "delay is in milliseconds — stagger with delay={index * 100}, never index * 0.1 (that was 1.8.x; 2.0 reads 0.1 as a tenth of a millisecond, i.e. no stagger).",
+    "components": [
+      "RevealFx",
+      "ShineFx"
+    ]
   },
   "RevealFx.translateY": {
     "rule": "translateY as a number is in rem. Use translateY={1} or token \"16\" (1rem); 16 means 16rem.",
-    "components": ["RevealFx"]
+    "components": [
+      "RevealFx"
+    ]
   },
   "LogoCloud.columns": {
     "rule": "LogoCloud extends Grid — always set columns and responsive overrides or logos stack in one column.",
-    "components": ["LogoCloud"]
+    "components": [
+      "LogoCloud"
+    ]
   },
   "StatusIndicator.color": {
     "rule": "StatusIndicator uses color=\"green\" | \"red\" | \"orange\" | \"gray\" etc. — not variant or semantic scheme names.",
-    "components": ["StatusIndicator"]
+    "components": [
+      "StatusIndicator"
+    ]
   },
   "Icon.names": {
-    "rule": "Icon names must come from IconName in spec.json — never invent names like more, bell, arrowRight.",
-    "components": ["Icon", "Button", "IconButton"]
+    "rule": "Icon names must come from iconNames in spec.json, which is a real union in 2.0 (an unregistered name is a type error, not a blank space). Do not guess a plausible name, and do not cast one with `as IconName` to silence the check. Brand marks are not in the set — an app registers those itself by augmenting IconLibraryOverrides.",
+    "components": [
+      "Icon",
+      "Button",
+      "IconButton"
+    ]
   },
   "Badge.duplicate": {
     "rule": "Do not pass the same text as both title prop and children — it renders twice.",
-    "components": ["Badge"]
+    "components": [
+      "Badge"
+    ]
   },
   "Tag.duplicate": {
     "rule": "Do not pass the same text as both label prop and children — it renders twice.",
-    "components": ["Tag"]
+    "components": [
+      "Tag"
+    ]
   },
   "color.tokens": {
     "rule": "Colors are semantic tokens ({scheme}-{weight}), never hex/rgb. background also accepts surface | overlay | page | transparent.",
-    "components": ["Column", "Row", "Text", "Button"]
+    "components": [
+      "Column",
+      "Row",
+      "Text",
+      "Button"
+    ]
   },
   "color.background-weak": {
     "rule": "*-background-weak is nearly the page color — invisible as accent. Use alpha tokens (brand-alpha-medium) for glows.",
-    "components": ["Background"]
+    "components": [
+      "Background"
+    ]
   },
   "layout.shorthands": {
     "rule": "Use fill not fillWidth fillHeight; center not horizontal=\"center\" vertical=\"center\"; Row/Column not Flex direction=.",
-    "components": ["Row", "Column", "Flex", "Grid"]
+    "components": [
+      "Row",
+      "Column",
+      "Flex",
+      "Grid"
+    ]
   },
   "layout.defaults": {
-    "rule": "Never write props equal to defaults: position=\"relative\", direction on Row/Column, variant=\"primary\" on Button.",
-    "components": ["Row", "Column", "Button"]
+    "rule": "Never write props equal to defaults or implied by another prop on the element: position=\"relative\", direction on Row/Column, variant=\"primary\" on Button, fillWidth beside maxWidth (maxWidth already fills the width), minWidth={0} beside fillWidth (fillWidth already sets min-width: 0).",
+    "components": [
+      "Row",
+      "Column",
+      "Grid",
+      "Button"
+    ]
+  },
+  "border.default": {
+    "rule": "Bare border (and borderTop, borderBottom, borderX, …) draws the default border. Do not write border=\"neutral-alpha-weak\" to get it; name a colour only to deviate, e.g. border=\"brand-alpha-medium\".",
+    "components": [
+      "Row",
+      "Column",
+      "Card"
+    ]
+  },
+  "zIndex.scope": {
+    "rule": "zIndex is for an isolated stacking group: an absolute decorative layer and its content sibling (zIndex={1}), or a sticky header over its pane. Never on a lone element, never a page-wide ladder of 3 / 5 / 9 — restructure the tree instead.",
+    "components": [
+      "Row",
+      "Column",
+      "Background"
+    ]
   },
   "section.gaps": {
     "rule": "Gap between page sections: 80–160 (typical 104). Inside sections: 24–40.",
-    "components": ["Column"]
+    "components": [
+      "Column"
+    ]
   },
   "heading.scale": {
     "rule": "Hero = display-strong-l/xl; section titles = display-strong-xs/s — never heading-* for section titles.",
-    "components": ["Heading"]
+    "components": [
+      "Heading"
+    ]
   },
   "animation.budget": {
     "rule": "Entry animation budget: hero + at most 1–2 key moments. Animate coherent blocks all-or-none within a sibling set.",
-    "components": ["RevealFx", "CountFx"]
+    "components": [
+      "RevealFx",
+      "CountFx"
+    ]
   },
   "CountFx.trigger": {
     "rule": "CountFx has no trigger prop — drive value from useInViewport latch instead.",
-    "components": ["CountFx"]
+    "components": [
+      "CountFx"
+    ]
   },
   "overflow.hero": {
     "rule": "overflow=\"hidden\" on full-bleed sections clips glows into hard bands — only use when parent has radius.",
-    "components": ["Column", "Background"]
+    "components": [
+      "Column",
+      "Background"
+    ]
   }
 }