@7onic-ui/tokens 0.3.4 → 0.3.6
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/cli/sync.js +3 -1
- package/css/variables.css +5 -3
- package/llms.txt +10 -74
- package/package.json +1 -1
package/cli/sync.js
CHANGED
|
@@ -925,6 +925,7 @@ function generateVariablesCss(tokens) {
|
|
|
925
925
|
lines.push(` --background: var(--color-background);`);
|
|
926
926
|
lines.push(` --foreground: var(--color-text);`);
|
|
927
927
|
lines.push(` color-scheme: light dark;`);
|
|
928
|
+
lines.push(` height: auto;`);
|
|
928
929
|
lines.push(`}`);
|
|
929
930
|
lines.push(``);
|
|
930
931
|
lines.push(`/* ========================================`);
|
|
@@ -934,11 +935,12 @@ function generateVariablesCss(tokens) {
|
|
|
934
935
|
lines.push(``);
|
|
935
936
|
lines.push(`html body {`);
|
|
936
937
|
lines.push(` background-color: var(--color-background);`);
|
|
937
|
-
lines.push(` color: var(--color-
|
|
938
|
+
lines.push(` color: var(--color-text);`);
|
|
938
939
|
lines.push(` font-family: var(--font-family-sans);`);
|
|
939
940
|
lines.push(` display: block;`);
|
|
940
941
|
lines.push(` place-items: initial;`);
|
|
941
942
|
lines.push(` min-width: auto;`);
|
|
943
|
+
lines.push(` min-height: auto;`);
|
|
942
944
|
lines.push(` margin: 0;`);
|
|
943
945
|
lines.push(`}`);
|
|
944
946
|
lines.push(``);
|
package/css/variables.css
CHANGED
|
@@ -934,7 +934,7 @@
|
|
|
934
934
|
|
|
935
935
|
/* ========================================
|
|
936
936
|
Framework Compat Aliases
|
|
937
|
-
Maps Next.js
|
|
937
|
+
Maps Next.js / Tailwind v4 convention
|
|
938
938
|
(--background, --foreground) to our tokens.
|
|
939
939
|
======================================== */
|
|
940
940
|
|
|
@@ -942,20 +942,22 @@ html:root {
|
|
|
942
942
|
--background: var(--color-background);
|
|
943
943
|
--foreground: var(--color-text);
|
|
944
944
|
color-scheme: light dark;
|
|
945
|
+
height: auto;
|
|
945
946
|
}
|
|
946
947
|
|
|
947
948
|
/* ========================================
|
|
948
|
-
Body Baseline
|
|
949
|
+
Body Baseline for Next.js / Vite resets
|
|
949
950
|
Overrides framework default body rules.
|
|
950
951
|
======================================== */
|
|
951
952
|
|
|
952
953
|
html body {
|
|
953
954
|
background-color: var(--color-background);
|
|
954
|
-
color: var(--
|
|
955
|
+
color: var(--color-text);
|
|
955
956
|
font-family: var(--font-family-sans);
|
|
956
957
|
display: block;
|
|
957
958
|
place-items: initial;
|
|
958
959
|
min-width: auto;
|
|
960
|
+
min-height: auto;
|
|
959
961
|
margin: 0;
|
|
960
962
|
}
|
|
961
963
|
|
package/llms.txt
CHANGED
|
@@ -26,85 +26,21 @@ Before writing any code, present this checklist and wait for answers:
|
|
|
26
26
|
|
|
27
27
|
**If the user answers in natural language**, extract the answers. **If any item is missing, ask a follow-up question for the missing items only.** Do not proceed until all 4 items are answered.
|
|
28
28
|
|
|
29
|
-
### Step 2:
|
|
29
|
+
### Step 2: Install / Setup
|
|
30
30
|
|
|
31
|
-
|
|
31
|
+
⚠️ **DO NOT GUESS** — token install procedures evolve with each Tailwind / framework version. Before writing any code, AI **MUST** fetch the live pages below and follow their instructions verbatim:
|
|
32
32
|
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
npm install @7onic-ui/tokens
|
|
36
|
-
```
|
|
37
|
-
> Check package.json first. If already listed in dependencies, skip this step.
|
|
38
|
-
|
|
39
|
-
**2-2. Create or update globals.css with token imports:**
|
|
40
|
-
|
|
41
|
-
**How to detect Tailwind version:**
|
|
42
|
-
- `tailwind.config.js` (or `.ts`) exists → **v3**
|
|
43
|
-
- No config file → **v4** (uses CSS-based configuration)
|
|
44
|
-
|
|
45
|
-
**New project (Tailwind v4):**
|
|
46
|
-
```css
|
|
47
|
-
/* globals.css (Next.js) or src/index.css (Vite) — ALL imports are required, do not skip any */
|
|
48
|
-
@import "tailwindcss";
|
|
49
|
-
@import "@7onic-ui/tokens/css/variables.css";
|
|
50
|
-
@import "@7onic-ui/tokens/css/themes/light.css";
|
|
51
|
-
@import "@7onic-ui/tokens/css/themes/dark.css"; /* omit ONLY if dark mode = no */
|
|
52
|
-
@import "@7onic-ui/tokens/tailwind/v4-theme.css";
|
|
53
|
-
```
|
|
54
|
-
|
|
55
|
-
> **Vite + Tailwind v4**: `npx 7onic init` auto-injects `@import "tailwindcss"` if not present, and automatically configures the `@/` path alias (`tsconfig.app.json` + `vite.config.ts`). No manual CSS or alias setup needed.
|
|
56
|
-
|
|
57
|
-
**Existing project with Tailwind v3** (detect from tailwind.config.js):
|
|
58
|
-
```css
|
|
59
|
-
/* globals.css — @import must come BEFORE @tailwind directives */
|
|
60
|
-
@import '@7onic-ui/tokens/css/variables.css';
|
|
61
|
-
@import '@7onic-ui/tokens/css/themes/light.css';
|
|
62
|
-
@import '@7onic-ui/tokens/css/themes/dark.css'; /* omit ONLY if dark mode = no */
|
|
63
|
-
@tailwind base;
|
|
64
|
-
@tailwind components;
|
|
65
|
-
@tailwind utilities;
|
|
66
|
-
```
|
|
67
|
-
```js
|
|
68
|
-
// tailwind.config.js — add preset
|
|
69
|
-
const preset = require('@7onic-ui/tokens/tailwind/v3-preset')
|
|
70
|
-
module.exports = {
|
|
71
|
-
presets: [preset],
|
|
72
|
-
content: ['./src/**/*.{js,ts,jsx,tsx}'],
|
|
73
|
-
}
|
|
74
|
-
```
|
|
75
|
-
|
|
76
|
-
**2-3. Set body classes:**
|
|
77
|
-
```html
|
|
78
|
-
<body class="bg-background text-foreground">
|
|
79
|
-
```
|
|
80
|
-
|
|
81
|
-
**Font baseline (automatic — do NOT add manually):**
|
|
82
|
-
`variables.css` import automatically applies:
|
|
83
|
-
- `html body { font-family: var(--font-family-sans) }` — Inter by default
|
|
84
|
-
- `html body code, pre, kbd { font-family: var(--font-family-mono) }` — monospace
|
|
85
|
-
|
|
86
|
-
Do NOT write `body { font-family: ... }` manually — it is already handled by the token import.
|
|
87
|
-
To use a custom font, override the CSS variable instead:
|
|
88
|
-
```css
|
|
89
|
-
:root { --font-family-sans: 'Your Font', sans-serif; }
|
|
90
|
-
```
|
|
91
|
-
|
|
92
|
-
**2-4. Apply user's answers:**
|
|
33
|
+
- **Official tokens install page (SSOT)**: https://7onic.design/design-tokens/installation
|
|
34
|
+
- **Tailwind CSS official**: https://tailwindcss.com/docs/installation
|
|
93
35
|
|
|
94
|
-
-
|
|
95
|
-
- Custom font → load font (next/font for Next.js, CDN for Vite) + set `--font-family-sans`
|
|
96
|
-
- Locale includes Japanese → load Noto Sans JP font
|
|
97
|
-
- Locale includes Korean → load Noto Sans KR font
|
|
36
|
+
The install instructions are intentionally **not duplicated in this file**. Setup details (`@7onic-ui/tokens` install, `tailwind.config.js` preset, `globals.css` imports, font baseline, dark mode toggle, etc.) are version-sensitive and change frequently — always defer to the live documentation above.
|
|
98
37
|
|
|
99
|
-
|
|
100
|
-
-
|
|
101
|
-
-
|
|
102
|
-
-
|
|
103
|
-
- [ ] Dark mode toggle (if selected)
|
|
104
|
-
- [ ] Font loaded (if custom)
|
|
105
|
-
- [ ] CJK fonts loaded (if applicable)
|
|
38
|
+
Apply user's answers from Step 1 after the install page steps are complete:
|
|
39
|
+
- Dark mode = yes → implement dark mode toggle (see below in this file)
|
|
40
|
+
- Custom font → override `--font-family-sans` per the install page guidance
|
|
41
|
+
- Japanese / Korean locale → load Noto Sans JP / KR
|
|
106
42
|
|
|
107
|
-
⛔ **Do NOT proceed to Step 3 until
|
|
43
|
+
⛔ **Do NOT proceed to Step 3 until install page setup is verified.**
|
|
108
44
|
|
|
109
45
|
### Icon Import Pattern (lucide-react)
|
|
110
46
|
|
package/package.json
CHANGED