@threadlabs/looma 0.46.4 → 0.47.0

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.
package/docs/README.md CHANGED
@@ -12,11 +12,13 @@ In a project with a `package.json`, install Looma and its documentation tools:
12
12
 
13
13
  ```sh
14
14
  pnpm add @threadlabs/looma @nextwebwg/html-next@1.0.0-alpha.69
15
- pnpm add -D 'markupress@>=0.12.0 <1' '@threadlabs/markupkit@>=0.2.0 <1' vite
15
+ pnpm add -D 'markupress@>=0.12.0 <0.14.4 || >=0.14.5 <1' '@threadlabs/markupkit@>=0.2.0 <1' vite
16
16
  pnpm exec looma-docs init --title "The Fellowship"
17
17
  pnpm exec looma-docs dev
18
18
  ```
19
19
 
20
+ Markupress 0.14.4 is excluded because its declared Looma peer range ends below 0.45.
21
+
20
22
  Use the tool versions accepted by Looma's optional peer dependencies. Markupress 0.12.0 and later compatible 0.x releases render authored documentation with Expressmark’s standard syntax and supply section navigation with category overview links, a full-height sidebar, the shared Looma site header, mobile home-page navigation, and one appearance button that cycles Automatic, Light and Dark. Regular component imports do not load the documentation server. Vue and Tiptap remain optional; install them when your own authored documentation mounts the Vue editor.
21
23
 
22
24
  Initialization creates three project-owned files:
@@ -43,7 +45,7 @@ Component navigation keeps every category linked and lists reference pages only
43
45
  Open the local address printed by `dev`, choose **Customize**, and save your theme. Saving updates those shared theme files and rebuilds the documentation. Your application consumes the same CSS import. A static or public site instead offers CSS and recipe downloads.
44
46
 
45
47
  Starting points set a complete identity across color, typography, shape, spacing,
46
- material and motion. Looma is the default identity; Gold pairs a warm action color with Lato/Fraunces and restrained polished surfaces. Clear remains a neutral starting point. Palette and material refinements then change only their own
48
+ material and motion. Looma is the default identity; Gold pairs a warm action color with Lato/Fraunces and restrained polished surfaces. Minimal remains a neutral starting point. Palette and material refinements then change only their own
47
49
  families. The compact sampler includes heading, body and supporting text beside
48
50
  the controls. Search components searches your whole discovered catalog; nine
49
51
  previews render initially, and **Show more components** reveals the next group.
@@ -105,7 +107,7 @@ The generated values follow rules. The medium control height is base text size t
105
107
 
106
108
  Choose a coordinated palette, then refine surface warmth, color intensity and palette relationship. Warmth runs from cool to warm paper and ink, with 0.5 neutral; intensity runs from quiet to vivid, with 0.5 retaining original seed intensity. Keep my colors preserves the base hues; Related colors and Contrasting colors tint quiet surfaces toward neighboring and opposite hues. These decisions regenerate paired light/dark colors through Oklab/OKLCH operations, gamut repair and readability checks. They do not transform existing CSS colors live. Four base colors remain visible for precise edits. Supporting accents optionally adds second and third brand seeds. They feed `tone="accent-secondary"` and `tone="accent-tertiary"` on Button, IconButton, Badge, Card, Meter and Text, with the same derived readable text, states and material response as the primary. Unset supporting accents follow primary; the primary remains the normal action voice.
107
109
 
108
- Palette details expose relationships rather than arbitrary status colors. **Neutrals & shared borders** derives restrained neutrals from text, an accent family or untinted gray, with fill strength and a shared minimum boundary contrast (default 2:1). Neutral solid/outline actions and form fields all consume `--ui-control-border` and its hover role. Colored outlines resolve from their pigment against the same minimum over the finished wash and material gradient in light and dark modes, independently of readable text; outline hover retains that boundary color. Button and IconButton washes use translucent tone pigment rather than contextual text ink. **Status colors** lets each role retain its semantic hue, harmonize toward the primary hue by at most 15 degrees, or use one of the three brand families. Perceptual saturation is coordinated with the primary; readability and material stops are resolved for both modes. Dark derivation separates canvas and content elevations, compensates quiet neutral fills and borders, and derives selection washes from readable contextual pigment. Subtle badges, toned cards, callouts, toasts and generated notifications share semantic background, foreground and border roles. Composed Text inherits the containing foreground; the document root supplies the normal body color. These roles provide paler light fills and visible dark tints. Optional overlay group overrides remain explicit choices instead of masking semantic defaults. There are no per-status color pickers. Words and icons preserve meaning when all statuses use one family. **Accent assignments** selects families for links, focus rings and selected rows. Light/dark specimens show these roles together, including an actual field beside the shared neutral actions.
110
+ Palette details expose relationships rather than arbitrary status colors. **Neutrals & shared borders** derives restrained neutrals from text, an accent family or untinted gray, with fill strength and a shared minimum boundary contrast (default 2:1). Neutral solid/outline actions and form fields all consume `--ui-control-border` and its hover role. Colored outlines resolve from their pigment against the same minimum over the finished wash and material gradient in light and dark modes, independently of readable text; outline hover retains that boundary color. Button and IconButton washes use translucent tone pigment rather than contextual text ink. Their shared wash roles lift deep pigment before compositing, then calibrate opacity against the material plate for a restrained perceptual hover step. Solid states change lightness while preserving hue and chroma, with extra lift for deep pigments; their reflections move with the fill. Outline hover keeps the same material layer, and ghost feedback uses the same paint in text and icon actions. **Status colors** lets each role retain its semantic hue, harmonize toward the primary hue by at most 15 degrees, or use one of the three brand families. Perceptual saturation is coordinated with the primary; readability and material stops are resolved for both modes. Dark derivation separates canvas and content elevations, compensates quiet neutral fills and borders, and derives selection washes from readable contextual pigment. Subtle badges, toned cards, callouts, toasts and generated notifications share semantic background, foreground and border roles. Composed Text inherits the containing foreground; the document root supplies the normal body color. These roles provide paler light fills and visible dark tints. Optional overlay group overrides remain explicit choices instead of masking semantic defaults. There are no per-status color pickers. Words and icons preserve meaning when all statuses use one family. **Accent assignments** selects families for links, focus rings and selected rows. Light/dark specimens show these roles together, including an actual field beside the shared neutral actions.
109
111
 
110
112
  Documentation navigation stays out of the customization workspace. **Material & light** opens a movable light source, real component samples and bounded surface controls. **Palette** opens light/dark specimens, base seeds and advanced relationship controls. Each editor changes the same persistent theme. Returning to the overview, navigating to a component, or reloading keeps the result.
111
113
 
@@ -113,7 +115,7 @@ Material groups finish, transparency, frosting, lighting and depth in a compact
113
115
 
114
116
  The starting themes make different choices within the same controls:
115
117
 
116
- - **Clear:** gray neutrals, restrained status tints and minimal depth.
118
+ - **Minimal:** gray neutrals, restrained status tints and minimal depth.
117
119
  - **Gold:** warm primary actions, readable amber links and plum selection, rounded polished surfaces, and Lato/Fraunces.
118
120
  - **Bookish:** wine guidance and confirmations, coral and leather accents, restrained risk colors, and Open Sans/Newsreader.
119
121
  - **Editorial:** flat ink-and-paper surfaces, rust links, serif type, and primary-color statuses distinguished by icons and labels.