@oneli8/tokens 1.0.0-beta.7 → 1.0.0-beta.9
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 +29 -6
- package/ai-context.json +5 -2
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,19 +1,42 @@
|
|
|
1
1
|
# @oneli8/tokens
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
[](https://www.npmjs.com/package/@oneli8/tokens)
|
|
4
|
+
[](https://github.com/Akshay007ad/OneLi8-Design-System/blob/main/LICENSE)
|
|
5
|
+
|
|
6
|
+
**OneLi8 means One Light.**
|
|
7
|
+
|
|
8
|
+
A design system created by Akshay Dhore, intended for broad human benefit and
|
|
9
|
+
conceived as service to Guruji Shrii Arnav, whose teachings inspire it. Service,
|
|
10
|
+
clarity, harmony, proportion, restraint and evolution guide its decisions.
|
|
11
|
+
|
|
12
|
+
This package is the decisions on their own, with no markup: the vocabulary every
|
|
13
|
+
OneLi8 component reads. It is also the Tailwind package, with a version 3 preset
|
|
14
|
+
and a version 4 bridge.
|
|
4
15
|
|
|
5
16
|
```sh
|
|
6
17
|
npm install @oneli8/tokens
|
|
7
18
|
```
|
|
8
19
|
|
|
9
20
|
```js
|
|
10
|
-
import '@oneli8/tokens/css';
|
|
11
|
-
import { tokens } from '@oneli8/tokens';
|
|
21
|
+
import '@oneli8/tokens/css'; // every token as a :root custom property
|
|
22
|
+
import { tokens } from '@oneli8/tokens'; // flat { 'color-text-primary': '#151817', ... }
|
|
12
23
|
```
|
|
13
24
|
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
25
|
+
The names follow a grammar, and the grammar is borrowed from Sanskrit rather
|
|
26
|
+
than from a CSS convention. A compound that names one thing is written as one
|
|
27
|
+
word, and a qualifier stays separate from what it qualifies. That is the whole
|
|
28
|
+
rule, and the Naming section below works through it.
|
|
29
|
+
|
|
30
|
+
Figma is the authority on the result. Every variable there carries an explicit
|
|
31
|
+
code syntax, recorded verbatim in `src/figma-code-syntax.txt`, so a component
|
|
32
|
+
reads the spelling the designer set rather than one re-derived from the grammar.
|
|
33
|
+
Where the file spells two siblings differently, this package reproduces both
|
|
34
|
+
rather than tidying one. The grammar is the rule; the record is the spelling.
|
|
35
|
+
|
|
36
|
+
The vocabulary is authored across `src/primitive.json`, `src/semantic.json`,
|
|
37
|
+
`src/component.json` and `src/themes.json`, each value carrying its own
|
|
38
|
+
description. Everything under `build/` is generated, so edit the source and
|
|
39
|
+
rebuild rather than the output.
|
|
17
40
|
|
|
18
41
|
## What the vocabulary contains
|
|
19
42
|
|
package/ai-context.json
CHANGED
|
@@ -1,13 +1,16 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$comment": "GENERATED by packages/sync/src/build-package-context.mjs — do not edit.",
|
|
3
3
|
"system": "OneLi8",
|
|
4
|
-
"version": "1.0.0-beta.
|
|
4
|
+
"version": "1.0.0-beta.9",
|
|
5
5
|
"meaning": "OneLi8 means One Light.",
|
|
6
6
|
"foundations": {
|
|
7
7
|
"package": "@oneli8/tokens",
|
|
8
8
|
"css": "@oneli8/tokens/css",
|
|
9
9
|
"tokenPrefix": "--ol8-",
|
|
10
|
-
"
|
|
10
|
+
"naming": {
|
|
11
|
+
"grammar": "Sanskrit grammar, not a CSS convention. Two rules follow from it and together they explain every name in the system. First, a compound that names ONE thing is written as one word: actionprimary is a single role rather than action plus primary, and cutedge is one feature of the Gem material, so action-primary would suggest two things where there is one. Second, a qualifier stays SEPARATE from what it qualifies: in --ol8-material-control-gem--primary-hover-start, hover is a state applied to start, two grammatical roles, so they stay apart. That is why disabledcontent is joined while hover-start is not. Hyphens separate levels of the hierarchy, never words inside a level. Words stay readable: no abbreviations, no truncation, no btn where button will do.",
|
|
12
|
+
"authority": "Figma is the authority on the result. Every variable there carries an explicit codeSyntax, copied verbatim into packages/tokens/src/figma-code-syntax.txt. Read a name from that record rather than re-deriving it from the grammar, because the file is not perfectly regular between siblings and guessing is how code and design drifted apart before. The grammar is the rule; the record is the spelling."
|
|
13
|
+
},
|
|
11
14
|
"rules": [
|
|
12
15
|
"Components consume SEMANTIC roles only. Primitives (color-<family>-<step>) are hidden from pickers in Figma and must not appear in component code.",
|
|
13
16
|
"color-primary-* is an alias ramp onto color-blue-* — identical values, distinct names. Prefer the semantic role over either.",
|
package/package.json
CHANGED