@lindaui/tokens 0.3.0 → 0.4.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/README.md CHANGED
@@ -21,6 +21,38 @@ Toggle a `.dark` class on an ancestor (e.g. `<html class="dark">`). The dark
21
21
  palette redefines the canonical tokens; HeroUI's variables reference them, so
22
22
  components re-skin for free.
23
23
 
24
+ ## HeroUI defaults and LeadConverter
25
+
26
+ These style entries and the migration utility layer first ship in tokens
27
+ **0.4.0**, required by UI/blocks 0.5.0. They are not in published tokens 0.3.1.
28
+
29
+ The default `/css` and `/theme.css` teal theme remains unchanged. To preserve
30
+ HeroUI defaults rather than inherit that theme, choose a separate source entry:
31
+
32
+ ```css
33
+ /* globals.css — your application runs Tailwind v4 */
34
+ @import "tailwindcss";
35
+ @import "@lindaui/tokens/lead-converter.css";
36
+ @source "../node_modules/@lindaui/ui/dist";
37
+ @source "../node_modules/@lindaui/ui/src";
38
+ @source "../node_modules/@lindaui/blocks/dist";
39
+ @source "../node_modules/@lindaui/blocks/src";
40
+ @source "./";
41
+ ```
42
+
43
+ Adjust these relative `@source` paths to your stylesheet location. Installed
44
+ tarballs include both `dist` and public source; app scanning keeps dynamic
45
+ composition classes available. Import this instead of `@heroui/styles` and
46
+ never alongside `/css`: it includes HeroUI defaults, the original violet
47
+ light/dark accents, field borders, notice CTA states and scrollbar styles.
48
+ It does not change the root font size or import teal canonical variables.
49
+
50
+ `@lindaui/tokens/heroui.css` provides only upstream styles for custom native
51
+ HeroUI themes. Without a Tailwind pipeline, import
52
+ `@lindaui/tokens/lead-converter/compiled.css` once instead; it already contains
53
+ Tailwind, HeroUI, the violet theme and the library's utilities. Do not combine
54
+ source and compiled entries, which would duplicate layers.
55
+
24
56
  ## Custom theme (per project)
25
57
 
26
58
  Every consumer can ship its own brand without rebuilding this package or touching
@@ -72,9 +104,17 @@ The template's bottom section documents this pattern in full.
72
104
  pnpm --filter @lindaui/tokens build
73
105
  ```
74
106
 
75
- Regenerates `dist/index.css`. The build chains `@import "tailwindcss"` +
107
+ Regenerates `dist/index.css` and `dist/lead-converter.css`. The build chains `@import "tailwindcss"` +
76
108
  `@source` scans of `@lindaui/ui` / `@lindaui/blocks` source + `@heroui/styles` + the
77
109
  brand `theme.css`, run through `@tailwindcss/cli` (Tailwind v4).
110
+ The token task also hashes UI/blocks source because their class changes must
111
+ invalidate compiled CSS even when no token values change.
112
+ Independent builds can run concurrently: each invocation compiles to unique
113
+ temporary files, validates its complete CSS snapshot, and atomically replaces
114
+ the public output. Cleanup never touches another invocation's files.
115
+ Regression check: `node --test scripts/tokens-concurrent-build.test.mjs` from
116
+ the repository root. It runs two builders together and checks output bytes and
117
+ markers continuously; watch mode publishes only after completed compilations.
78
118
 
79
119
  ## License
80
120