@olddevs/ui 4.6.0 → 4.6.1

package/docs/icons.en.md

@@ -113,7 +113,7 @@ import { DeleteIcon, SearchIcon } from "@olddevs/ui/icons";
 | Vertical "more": the Block menu     | `MoreVerticalIcon`                              | `MoreIcon`, `DragHandleIcon`   |
 | Duplicate next to the original      | `DuplicateIcon`                                 | `CopyIcon`                     |
 | Arrow up / down                     | `ArrowUpIcon`, `ArrowDownIcon`                  | `ChevronUpIcon`, `SortIcon`    |
-| Document Layout in columns          | `ColumnLayoutIcon`                              | `ColumnsIcon`                  |
+| A Column layout of the Document     | `ColumnLayoutIcon`                              | `ColumnsIcon`                  |
 | Wrapper: a group of Blocks          | `WrapperIcon`                                   | `ColumnLayoutIcon`             |
 | Remove the Wrapper, keep the Blocks | `UnwrapIcon`                                    | `DeleteIcon`                   |
 | Collapsible Block of the Editor     | `DetailsIcon`                                   | `ChevronDownIcon`              |
@@ -185,15 +185,15 @@ has no checkboxes, so that a list of records does not read as "done".
 The only visible label on the Toolbar buttons is the icon; the button's name
 comes from `aria-label`, and the keyboard shortcut is shown by a tooltip.
 
-The Insert menu added `ParagraphIcon` (¶) — the "Turn into
+The Slash menu added `ParagraphIcon` (¶) — the "Turn into
 paragraph" item. `HeadingIcon` does not fit it: that one is a heading in general, with no
-level. The "+" button of the Insert menu reuses the existing `AddIcon`.
+level. The "+" button of the Slash menu reuses the existing `AddIcon`.
 
 The Block type menu "¶" (under ADR-0049) added
 `Heading1Icon`–`Heading4Icon` (a heading with the level digit) and `TextIcon` (the letter
 "T", the "Text" item). `HeadingIcon` remains the icon of a heading without a level: the items of the
-Insert menu need it that way. `TextIcon` does not repeat `ParagraphIcon`: that one is
-the "paragraph" pilcrow in the Insert menu, and this one is "Text" in the Block type menu. The "¶" button
+Slash menu need it that way. `TextIcon` does not repeat `ParagraphIcon`: that one is
+the "paragraph" pilcrow in the Slash menu, and this one is "Text" in the Block type menu. The "¶" button
 on the Toolbar shows the icon of the current type: the icon of its menu item,
 `CodeBlockIcon` in a code Block, or the pilcrow `ParagraphIcon` when there is no text
 Block under the caret (an image is selected).
@@ -212,13 +212,13 @@ The Block handle added four names: `MoreVerticalIcon` — "⋮", the button of t
 
 Emoji added `EmojiIcon` — a smiley face, the button of the emoji grid in the Toolbar. The name is by the meaning "emoji", not by the glyph: a face elsewhere would mean mood or rating, and that would be a different decision under ADR-0049.
 
-HTML mode added `SourceIcon` — a sheet with `</>` (`FileCode`), the "HTML" button of the Toolbar: the source code of the whole Document. `CodeBlockIcon` already means a code Block inside a Document, and `CodeIcon` the subject topic "development"; a third meaning is not attached to them (ADR-0049).
+Source mode added `SourceIcon` — a sheet with `</>` (`FileCode`), the "HTML" button of the Toolbar: the source code of the whole Document. `CodeBlockIcon` already means a code Block inside a Document, and `CodeIcon` the subject topic "development"; a third meaning is not attached to them (ADR-0049).
 
-Layout added `ColumnLayoutIcon` — two columns, the "Layout" item of the Insert menu. `ColumnsIcon` with three columns already means "choosing the columns of a data table", and a second meaning is not attached to it (ADR-0049): the Layout has its own glyph.
+Column layout added `ColumnLayoutIcon` — two columns, the "Layout" item of the Slash menu. `ColumnsIcon` with three columns already means "choosing the columns of a data table", and a second meaning is not attached to it (ADR-0049): the Column layout has its own glyph.
 
-Wrapper added the pair `WrapperIcon` and `UnwrapIcon` — lucide's `Group` and `Ungroup`: a frame with dashed corners around two Blocks and the same Blocks without a frame. The icons sit at the "Wrapper" item of the Insert menu and the "Remove Wrapper" item in the Block handle menu. This is not `ColumnLayoutIcon`: columns put Blocks side by side, while a Wrapper groups them without changing their order. `DeleteIcon` does not fit removal: only the container is deleted, not the content.
+Wrapper added the pair `WrapperIcon` and `UnwrapIcon` — lucide's `Group` and `Ungroup`: a frame with dashed corners around two Blocks and the same Blocks without a frame. The icons sit at the "Wrapper" item of the Slash menu and the "Remove Wrapper" item in the Block handle menu. This is not `ColumnLayoutIcon`: columns put Blocks side by side, while a Wrapper groups them without changing their order. `DeleteIcon` does not fit removal: only the container is deleted, not the content.
 
-Collapsible block added `DetailsIcon` — lucide's `ListCollapse`: a list with collapse arrows, the "Collapsible block" item of the Insert menu. The dictionary had no fitting name: `ChevronDownIcon` is a step and nesting, `CollapseIcon` is collapsing a window, while here it is a whole Block with a title and hidden content. Removing the Block uses the already taken `UnwrapIcon` (ADR-0049).
+Collapsible block added `DetailsIcon` — lucide's `ListCollapse`: a list with collapse arrows, the "Collapsible block" item of the Slash menu. The dictionary had no fitting name: `ChevronDownIcon` is a step and nesting, `CollapseIcon` is collapsing a window, while here it is a whole Block with a title and hidden content. Removing the Block uses the already taken `UnwrapIcon` (ADR-0049).
 
 The first iteration of the table made do with two icons for four directions
 (`AddRowIcon`, `AddColumnIcon`) and an icon for the separate "Table

package/docs/palette.en.md

@@ -61,7 +61,7 @@ blue tint of `cloud`: the background of the inverse surface in the light theme.
 
 ### Tones
 
-The "Used by" column is the only way to see why a family has exactly this many
+The "Used by" column is the only way to see why a color scale has exactly this many
 steps: each one exists for a specific role in a specific theme, and there are no spare ones.
 
 | Primitive       | Value     | Used by                                                          |
@@ -155,7 +155,7 @@ text, borders, shadows and `--topbar-bg`, and takes tones and accent from the da
 ### Inverse surface
 
 A pill that has to differ from everything around it by sign, not by step
-of brightness: the Editor's Selection menu (`toolbar="bubble"`), which sits directly on the
+of brightness: the Editor's Bubble menu (`toolbar="bubble"`), which sits directly on the
 Document. Light in the dark themes, dark in the light one. It has the utilities
 `bg-surface-inverse`, `bg-surface-inverse-hover`, `bg-surface-inverse-pressed`,
 `text-text-on-inverse`, `outline-accent-on-inverse`.
@@ -366,7 +366,7 @@ VS Code and macOS; 3:1 is not the goal, because in a dark theme such a fill no l
 holds 4.5:1 for light text on top of it. `--selection-light` is the light variant in
 any app theme: the Editor's Paper (`surface="paper"`) takes it.
 `--selection-dark` is the dark mirror in any theme: the Editor's
-HTML mode field takes it, dark in the light theme too; the dark themes assign
+Source mode field takes it, dark in the light theme too; the dark themes assign
 it to `--selection`.
 
 The `teal` brand primitives are declared inside its own block and are not part of the shared

package/docs/theming.en.md

@@ -25,11 +25,11 @@ it writes the class `bg-bg-0`, backed by the `@theme` bridge.
 
 ### Layer 1 — primitives
 
-Three neutral ramps, one per theme (`slate` for dark, `cloud` for light,
-`navy` for dim), and seven tone families. Within a ramp the step number increases with lightness:
+Three neutral scales, one per theme (`slate` for dark, `cloud` for light,
+`navy` for dim), and seven tone scales. Within a scale the step number increases with lightness:
 1 is the darkest, 12 the lightest.
 
-Three ramps instead of one is not duplication: each theme's neutrals are tuned
+Three scales instead of one is not duplication: each theme's neutrals are tuned
 by hand for its own background, and reducing them to one scale would mean recoloring two
 themes out of three.
 
@@ -58,7 +58,7 @@ cover both; details and numbers are in the comments of `styles.css`.
 
 **Inverse surface** is a separate group of roles for a pill
 that sits directly on the Document and has to differ from it by polarity, not by a single
-step: the Editor's Selection menu. `--surface-inverse` (the background),
+step: the Editor's Bubble menu. `--surface-inverse` (the background),
 `--surface-inverse-hover` and `--surface-inverse-pressed` (hover and press),
 `--text-on-inverse` (text and icons) are light in `dark` and `dim`, and dark in
 `light`. The focus outline on it is `--accent-on-inverse`: it is the `--accent-strong`
@@ -71,7 +71,7 @@ a compatibility layer. Components get their colors through them, via Tailwind cl
 
 ### Layer 3 — component tokens
 
-The list is **closed**. A component token is added when a family has a real
+The list is **closed**. A component token is added when a component family has a real
 reason to differ from the semantics, not "just in case"; a token with no reader is
 not added at all.
 
@@ -346,7 +346,7 @@ The order is exactly this, checked on `teal`, which ships in the package as a sa
 
 **3. Check the light theme separately.** `--accent-strong` is read on a background,
 and the light theme almost certainly needs its own step; `--accent-on-inverse` is
-the opposite, light: the Selection menu pill is dark in the light theme. `--selection`
+the opposite, light: the Bubble menu pill is dark in the light theme. `--selection`
 returns to the light variant only here: the brand block comes after the light theme
 in the file and would override it with the dark one.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@olddevs/ui",
-  "version": "4.6.0",
+  "version": "4.6.1",
   "description": "Olddevs UI — design system: tokens, themes and accessible UI primitives",
   "license": "MIT",
   "private": false,