@threadlabs/looma 0.44.1 → 0.44.3
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/components/shared/icons.js +1 -0
- package/components/ui-badge/ui-badge.html +7 -6
- package/components/ui-button/ui-button.html +47 -2
- package/components/ui-card/ui-card.html +6 -6
- package/components/ui-color-picker/ui-color-picker.html +12 -5
- package/components/ui-color-picker/ui-color-picker.js +20 -6
- package/components/ui-dialog/ui-dialog.html +5 -6
- package/components/ui-disclosure/ui-disclosure.html +1 -1
- package/components/ui-icon/ui-icon.html +1 -0
- package/components/ui-icon-button/ui-icon-button.html +59 -4
- package/components/ui-menu/ui-menu.html +5 -6
- package/components/ui-number-input/ui-number-input.html +7 -0
- package/components/ui-popover/ui-popover.html +5 -6
- package/components/ui-slider/ui-slider.html +6 -0
- package/components/ui-tooltip/ui-tooltip.html +8 -5
- package/components/ui-tree-item/ui-tree-item.html +7 -1
- package/dist/index.js +1 -1
- package/docs/README.md +18 -4
- package/docs/catalog.json +474 -3705
- package/docs/customizer-render.mjs +55 -36
- package/docs/customizer.js +48 -33
- package/docs/fonts.mjs +28 -0
- package/docs/index.d.ts +1 -1
- package/docs/navigation.mjs +26 -0
- package/docs/site.mjs +5 -1
- package/docs/theme.mjs +39 -14
- package/editor/icons.d.ts +1 -0
- package/editor/index.js +2 -1
- package/package.json +1 -1
- package/styles/ui-badge.css +11 -10
- package/styles/ui-button.css +47 -2
- package/styles/ui-card.css +4 -4
- package/styles/ui-color-picker.css +105 -2
- package/styles/ui-dialog.css +10 -12
- package/styles/ui-disclosure.css +1 -1
- package/styles/ui-icon-button.css +59 -4
- package/styles/ui-menu.css +5 -6
- package/styles/ui-number-input.css +6 -0
- package/styles/ui-popover.css +5 -6
- package/styles/ui-slider.css +3 -0
- package/styles/ui-tooltip.css +8 -5
- package/styles/ui-tree-item.css +12 -2
- package/theme-system.css +28 -16
- package/tokens.css +7 -0
- package/vanilla/UiColorPicker.d.ts +1 -0
- package/vanilla/UiColorPicker.js +32 -28
- package/vanilla/UiIcon.js +1 -1
- package/vanilla/UiNumberInput.d.ts +1 -0
- package/vanilla/UiNumberInput.js +53 -43
- package/vanilla/UiSlider.d.ts +1 -0
- package/vanilla/UiSlider.js +65 -57
- package/vanilla/UiTreeItem.js +1 -1
- package/vue/UiBadge.vue +7 -9
- package/vue/UiButton.vue +56 -2
- package/vue/UiCard.vue +13 -5
- package/vue/UiColorPicker.d.ts +6 -0
- package/vue/UiColorPicker.vue +156 -6
- package/vue/UiDialog.vue +22 -12
- package/vue/UiDisclosure.vue +1 -1
- package/vue/UiIcon.vue +1 -0
- package/vue/UiIconButton.vue +62 -4
- package/vue/UiMenu.vue +11 -6
- package/vue/UiNumberInput.d.ts +6 -0
- package/vue/UiNumberInput.vue +47 -1
- package/vue/UiPopover.vue +11 -6
- package/vue/UiSlider.d.ts +6 -0
- package/vue/UiSlider.vue +37 -1
- package/vue/UiTooltip.vue +11 -5
- package/vue/UiTreeItem.vue +19 -3
- package/vue/chunks/UiBadge.js +1 -1
- package/vue/chunks/UiButton.js +1 -1
- package/vue/chunks/UiCard.js +2 -2
- package/vue/chunks/UiColorPicker.js +60 -11
- package/vue/chunks/UiDialog.js +1 -1
- package/vue/chunks/UiDisclosure.js +1 -1
- package/vue/chunks/UiIcon.js +5 -1
- package/vue/chunks/UiIconButton.js +1 -1
- package/vue/chunks/UiMenu.js +1 -1
- package/vue/chunks/UiNumberInput.js +31 -2
- package/vue/chunks/UiPopover.js +1 -1
- package/vue/chunks/UiSlider.js +33 -2
- package/vue/chunks/UiTooltip.js +1 -1
- package/vue/chunks/UiTreeItem.js +3 -3
- package/vue/components.css +459 -86
- package/vue/editor/index.js +4 -0
- package/docs/examples/ui-editor-footnote-editor/examples/01-note.behavior.js +0 -9
- package/docs/examples/ui-editor-mention-menu/examples/00-preview.behavior.js +0 -1
- package/docs/examples/ui-editor-slash-menu/examples/00-preview.behavior.js +0 -81
- package/docs/examples/ui-editor-table-overlay/examples/00-preview.behavior.js +0 -24
package/docs/README.md
CHANGED
|
@@ -38,7 +38,7 @@ Import `./looma.theme.css` after Looma's tokens and palette in your application'
|
|
|
38
38
|
|
|
39
39
|
The CSS includes generated derivation rules as well as values. Re-export or save your recipe after a Looma upgrade to adopt updated rules.
|
|
40
40
|
|
|
41
|
-
Component navigation keeps every category linked and lists reference pages only beneath the current category. Category links open galleries with the matching filter selected; individual links open their references. Section selection survives reload and browser history, and overview cards render before JavaScript. The Section dropdown navigates between galleries; Filter components narrows only the cards on the current page, and changing sections starts with a fresh filter. Markupress supplies the section navigation and its continuous sidebar background. Editor
|
|
41
|
+
Component navigation keeps every category linked and lists reference pages only beneath the current category. Category links open galleries with the matching filter selected; individual links open their references. Section selection survives reload and browser history, and overview cards render before JavaScript. The Section dropdown navigates between galleries; Filter components narrows only the cards on the current page, and changing sections starts with a fresh filter. Markupress supplies the section navigation and its continuous sidebar background. The Editor guide documents its composed editing tools; implementation controls stay out of the component catalog.
|
|
42
42
|
|
|
43
43
|
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
44
|
|
|
@@ -87,6 +87,16 @@ the `packageName` you configure below. That is package attribution, not the
|
|
|
87
87
|
name of your design system. Shared CSS and recipe filenames are configured
|
|
88
88
|
under `theme`; changing a site title does not require renaming those files.
|
|
89
89
|
|
|
90
|
+
A navigation link with `"position": "start"` appears before the generated component and
|
|
91
|
+
editor sections. Other links keep their order after those sections:
|
|
92
|
+
|
|
93
|
+
```json
|
|
94
|
+
{ "nav": [{ "label": "Get started", "href": "/getting-started/", "position": "start" }] }
|
|
95
|
+
```
|
|
96
|
+
|
|
97
|
+
For documentation-site Markdown syntax and publishing options, see the
|
|
98
|
+
[Markupress documentation](https://threadlabs-studio.github.io/markupress/).
|
|
99
|
+
|
|
90
100
|
## Change the rule, keep the family consistent
|
|
91
101
|
|
|
92
102
|
The authoring model groups shared decisions as Colour, Type, Size & spacing, Material and Motion. The controls expose shared intent: control roominess relative to text, rhythm, spacing, corners, inner and outer depth, and response pace.
|
|
@@ -99,17 +109,19 @@ Palette details expose relationships rather than arbitrary status colors. **Neut
|
|
|
99
109
|
|
|
100
110
|
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.
|
|
101
111
|
|
|
102
|
-
Material
|
|
112
|
+
Material groups finish, transparency, frosting, lighting and depth in a compact control panel. The grid appears only behind material specimens; editing controls and the persistent summary have opaque backing panels. Help buttons preserve explanations without showing them all up front. Transparency mostly affects decorative rims and overlays; at maximum, content plates also reveal a little of the scene.
|
|
103
113
|
|
|
104
114
|
The starting themes make different choices within the same controls:
|
|
105
115
|
|
|
106
116
|
- **Clear:** gray neutrals, restrained status tints and minimal depth.
|
|
107
|
-
- **Gold:** warm primary actions,
|
|
117
|
+
- **Gold:** warm primary actions, readable amber links and plum selection, rounded polished surfaces, and Lato/Fraunces.
|
|
108
118
|
- **Bookish:** wine guidance and confirmations, coral and leather accents, restrained risk colors, and Open Sans/Newsreader.
|
|
109
119
|
- **Editorial:** flat ink-and-paper surfaces, rust links, serif type, and primary-color statuses distinguished by icons and labels.
|
|
110
120
|
- **Night:** cool supporting accents, amber warnings, glass material, and IBM Plex Sans/Mono.
|
|
111
121
|
- **Garden:** forest, clay and gold, soft rounded surfaces, and Nunito Sans/Lora.
|
|
112
122
|
|
|
123
|
+
The summary stays above the editor and updates as decisions change; Undo, Redo and Reset remain available there. Optional accent swatches offer None inside the picker, without a separate mode selector.
|
|
124
|
+
|
|
113
125
|
A refined preset keeps its name with “customized” beside it. **Reset material** resets only material and light; **Reset palette** resets only the palette. Status color relationships offer **Semantic colors**, **Less color**, and **Primary + icons**. **Reset status colors** restores the selected status relationship without changing brand colors, type, or material; advanced per-status relationships remain available. These family choices are recorded in the recipe's optional `presets` mapping. The `values` mapping remains the complete source of the generated theme; a preset is a named combination of those values.
|
|
114
126
|
|
|
115
127
|
Number controls accept arithmetic such as `1rem / 1.2` or `150ms * 2`, calculate on entry and show the result. Unit changes preserve the quantity. Sliders include exact entry, and curve handles support dragging and arrow keys alongside numeric coordinates. LightEditor keeps its coordinate fields under **Exact position**. Light and curve drags preserve the grab offset; Escape or pointer cancellation restores the gesture start without creating a saved edit.
|
|
@@ -183,7 +195,7 @@ An optional recipe `fonts` mapping records Google family names by `body-font` an
|
|
|
183
195
|
|
|
184
196
|
Light position is relative to each surface: horizontal and vertical positions run from 0 to 1, with 0.5, 0 at top centre. Drag the source, use its arrow keys (Shift moves faster), or enter exact percentages. Home returns it to top centre. Spread runs from a concentrated spot to broad illumination; strength controls its intensity. The source influences reflections, illuminated edges and the direction of depth shadows throughout the theme.
|
|
185
197
|
|
|
186
|
-
Depth controls elevation and recession independently from finish, transmission and motion. Finish controls how strongly a material catches a reflection, from matte to polished; it needs nonzero light strength. Light spread shapes that reflection, while position also directs shadows. A light strength of zero does not remove depth shadows. Edge light catches its boundary; glow spills beyond it. Glassiness and glow use a gently increasing lower range and an expressive upper response (`g + 2g⁴`), so the maximum can be exuberant without raising restrained defaults. Glassiness and surface separation govern the decorative material around floating content, scaled by popup purpose and rendered size. The content plane stays opaque. Overlay translucency changes the shared overlay fill and decorative glass;
|
|
198
|
+
Depth controls elevation and recession independently from finish, transmission and motion. Finish controls how strongly a material catches a reflection, from matte to polished; it needs nonzero light strength. Light spread shapes that reflection, while position also directs shadows. A light strength of zero does not remove depth shadows. Edge light catches its boundary; glow spills beyond it. Glassiness and glow use a gently increasing lower range and an expressive upper response (`g + 2g⁴`), so the maximum can be exuberant without raising restrained defaults. Glassiness and surface separation govern the decorative material around floating content, scaled by popup purpose and rendered size. The content plane stays nearly opaque, with slight transmission at maximum transparency. Overlay translucency changes the shared overlay fill and decorative glass; the content paint accounts for its reflection so stacked layers do not erase that slight transmission. Separation can create a rim even with glassiness at zero. Reflection peaks are bounded for readable text, and reduced transparency disables the ornamental reflection and glow as well as backdrop blur.
|
|
187
199
|
|
|
188
200
|
Card keeps surface structure and decorative treatment independent:
|
|
189
201
|
|
|
@@ -302,6 +314,8 @@ The local editor writes only the configured recipe and CSS inside the project. I
|
|
|
302
314
|
|
|
303
315
|
The writer stages complete files, serializes saves with a project lock, and rolls back the recipe if replacing the CSS fails. If a process stops during a save or build, close the old editor before removing its `.looma/theme-write.lock` or `.looma/docs-build.lock`; restart and save the loaded recipe to regenerate a consistent pair. Change the server base, output directory or theme-file paths by restarting `dev`.
|
|
304
316
|
|
|
317
|
+
The starting theme is selectable directly in the persistent summary bar. Font options preview their names using separate font faces loaded on visibility with Google Fonts’ [`text=` subsets](https://developers.google.com/fonts/docs/css2#optimizing_for_latency_and_file_size). Selecting a font loads its unrestricted family and supported weights; preview subsets never supply document text.
|
|
318
|
+
|
|
305
319
|
Preset choices use the styled, searchable dropdown already used for fonts and component examples. Palette choices include four color swatches for the accent, neutral fill, canvas and text; the selected field previews the current theme. An inherited default keeps muted text while its options remain readable.
|
|
306
320
|
|
|
307
321
|
Filled-action colors keep their supplied pigment. Readable on-fill ink is chosen independently from contextual text, outlines and focus. Neutral action and field boundaries derive from one contrast decision against their surfaces; their quiet fills are independent of primary pigment. Supporting brand families are separate from neutral secondary actions. Reflection preserves chromatic light and shade within that chosen foreground’s readability bounds.
|