@axiapps/axi-design 1.32.0 → 1.34.0

package/dist/axi.css

@@ -371,6 +371,17 @@ button.axi-panel--tile:hover,
   padding: var(--axi-well-pad, 10px);
 }
 
+/* The reading-scale well, which the comment above describes and this language
+   then made every consumer spell out by hand. Saying `--axi-radius-sm` inline
+   is fine for the handful of instances that comment imagined; the first real
+   consumer to be counted had fifty, and fifty inline style attributes is the
+   thing a class exists to prevent. The same argument produced .axi-btn--sm.
+
+   Only the radius, because that is the only thing that changes: a recess the
+   size of a single reading still holds objects that carry their own padding, so
+   the pad knob is still the right way to say anything else. */
+.axi-well--sm { --axi-well-radius: var(--axi-radius-sm); }
+
 /* ---------- button ---------- */
 .axi-btn {
   display: inline-flex; align-items: center; gap: 8px;
@@ -672,6 +683,37 @@ button.axi-panel--tile:hover,
   color: var(--axi-accent); font-weight: 900; pointer-events: none;
 }
 
+/* ---------- code ---------- */
+/* A literal the reader is meant to type or recognise character for character:
+   a slash command, a file extension, a URL, a config key. The language already
+   had this style, but only as `.axi-prose code` - reachable by adopting a whole
+   typography layer for a document. A consumer with one command to name inside a
+   sentence of interface copy cannot adopt that layer without restyling the
+   sentence, so it invents a box instead. One real consumer had three spellings
+   for six spans, and the sixth had given up and drawn no box at all.
+
+   So the rule below carries both selectors. Not for brevity - because a code
+   span inside rendered markdown and a code span inside a card are the same
+   object, and the last time this language spelled one object twice the two
+   copies drifted. There is a test that they stay one rule.
+
+   `em`, not `px`: this lands in body copy and in 10px captions alike, and a
+   literal that does not track the text around it reads as a different voice.
+
+   It sits on --axi-ground where .axi-kbd sits on --axi-surface, and the
+   reason is already written down one rule below: a key is raised off what it
+   is printed on, and a quoted literal is sunk into it. */
+.axi-code,
+.axi-prose code {
+  font-family: var(--axi-mono);
+  font-size: .88em;
+  background: var(--axi-ground);
+  color: var(--axi-text);
+  border: var(--axi-border-hairline) solid var(--axi-ink-line);
+  border-radius: var(--axi-radius-sm);
+  padding: 1px 5px;
+}
+
 /* ---------- keyboard key ---------- */
 /* A key on the keyboard, named in the interface: the Esc that closes a
    palette, the Ctrl K that opens it. Drawn as a small control rather than as a
@@ -2606,12 +2648,8 @@ textarea.axi-input {
   border: var(--axi-border-hairline) solid var(--axi-ink-line);
 }
 
-.axi-prose code {
-  font-family: var(--axi-mono); font-size: .88em;
-  background: var(--axi-ground); color: var(--axi-text);
-  border: var(--axi-border-hairline) solid var(--axi-ink-line);
-  border-radius: var(--axi-radius-sm); padding: 1px 5px;
-}
+/* .axi-prose code is declared beside .axi-code in primitives.css: one rule,
+   both selectors, because they are one object. */
 .axi-prose pre {
   margin: 0 0 18px; padding: 14px 16px; overflow-x: auto;
   background: var(--axi-ground);

package/docs/RULES.md

@@ -682,3 +682,23 @@ vacuously while no theme exists, and binds the moment the first file lands.
 4. Add it to the gallery, and check it with the accent switcher — if it does
    not follow the accent, it hard-coded something.
 5. `npm run build` and commit `dist/axi.css` with your source change.
+
+### A style only reachable through a layer will be re-invented
+
+If a style lives at `.some-layer .thing` and nowhere else, then it exists for
+consumers who adopted that layer and for nobody else. Every other consumer that
+needs the same object has to adopt a whole layer to reach one declaration — and
+what it does instead is draw its own. That is not a hypothetical: `.axi-prose
+code` was the language's only word for a quoted literal, and a consumer with six
+literals in its interface copy — none of them in prose — had written three
+different boxes for them, the sixth having given up and drawn none.
+
+So when a layer-scoped style names an object that can appear outside that layer,
+give the object its own class and put **both selectors on one rule**. Not two
+rules that agree: one rule. `.axi-code, .axi-prose code { … }`. Two rules that
+agree today are two rules that disagree after the next edit, and that is how the
+same object ends up with two appearances inside one language — the defect this
+whole section exists to prevent.
+
+The test to write is not "does `.axi-code` exist". It is "are both spellings in
+the same rule", because only the second one fails when someone splits them.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@axiapps/axi-design",
-  "version": "1.32.0",
+  "version": "1.34.0",
   "description": "The design language for the axi suite — flat and outlined, dark, drawn in saturated ink.",
   "type": "module",
   "license": "MIT",

package/src/primitives.css

@@ -97,6 +97,17 @@ button.axi-panel--tile:hover,
   padding: var(--axi-well-pad, 10px);
 }
 
+/* The reading-scale well, which the comment above describes and this language
+   then made every consumer spell out by hand. Saying `--axi-radius-sm` inline
+   is fine for the handful of instances that comment imagined; the first real
+   consumer to be counted had fifty, and fifty inline style attributes is the
+   thing a class exists to prevent. The same argument produced .axi-btn--sm.
+
+   Only the radius, because that is the only thing that changes: a recess the
+   size of a single reading still holds objects that carry their own padding, so
+   the pad knob is still the right way to say anything else. */
+.axi-well--sm { --axi-well-radius: var(--axi-radius-sm); }
+
 /* ---------- button ---------- */
 .axi-btn {
   display: inline-flex; align-items: center; gap: 8px;
@@ -398,6 +409,37 @@ button.axi-panel--tile:hover,
   color: var(--axi-accent); font-weight: 900; pointer-events: none;
 }
 
+/* ---------- code ---------- */
+/* A literal the reader is meant to type or recognise character for character:
+   a slash command, a file extension, a URL, a config key. The language already
+   had this style, but only as `.axi-prose code` - reachable by adopting a whole
+   typography layer for a document. A consumer with one command to name inside a
+   sentence of interface copy cannot adopt that layer without restyling the
+   sentence, so it invents a box instead. One real consumer had three spellings
+   for six spans, and the sixth had given up and drawn no box at all.
+
+   So the rule below carries both selectors. Not for brevity - because a code
+   span inside rendered markdown and a code span inside a card are the same
+   object, and the last time this language spelled one object twice the two
+   copies drifted. There is a test that they stay one rule.
+
+   `em`, not `px`: this lands in body copy and in 10px captions alike, and a
+   literal that does not track the text around it reads as a different voice.
+
+   It sits on --axi-ground where .axi-kbd sits on --axi-surface, and the
+   reason is already written down one rule below: a key is raised off what it
+   is printed on, and a quoted literal is sunk into it. */
+.axi-code,
+.axi-prose code {
+  font-family: var(--axi-mono);
+  font-size: .88em;
+  background: var(--axi-ground);
+  color: var(--axi-text);
+  border: var(--axi-border-hairline) solid var(--axi-ink-line);
+  border-radius: var(--axi-radius-sm);
+  padding: 1px 5px;
+}
+
 /* ---------- keyboard key ---------- */
 /* A key on the keyboard, named in the interface: the Esc that closes a
    palette, the Ctrl K that opens it. Drawn as a small control rather than as a

package/src/prose.css

@@ -46,12 +46,8 @@
   border: var(--axi-border-hairline) solid var(--axi-ink-line);
 }
 
-.axi-prose code {
-  font-family: var(--axi-mono); font-size: .88em;
-  background: var(--axi-ground); color: var(--axi-text);
-  border: var(--axi-border-hairline) solid var(--axi-ink-line);
-  border-radius: var(--axi-radius-sm); padding: 1px 5px;
-}
+/* .axi-prose code is declared beside .axi-code in primitives.css: one rule,
+   both selectors, because they are one object. */
 .axi-prose pre {
   margin: 0 0 18px; padding: 14px 16px; overflow-x: auto;
   background: var(--axi-ground);