@oneli8/react 1.0.0-beta.6 → 1.0.0-beta.8

package/README.md

@@ -1,33 +1,57 @@
 # @oneli8/react
 
-OneLi8 Design System for React.
+[![npm](https://img.shields.io/npm/v/@oneli8/react?color=2c438b&label=npm)](https://www.npmjs.com/package/@oneli8/react)
+[![licence](https://img.shields.io/npm/l/@oneli8/react?color=2c438b)](https://github.com/Akshay007ad/OneLi8-Design-System/blob/main/LICENSE)
+
+**OneLi8 means One Light.**
+
+A design system created by Akshay Dhore, intended for broad human benefit and
+conceived as service to Guruji Shrii Arnav, whose teachings inspire it. Service,
+clarity, harmony, proportion, restraint and evolution guide its decisions.
+
+The practical intention is narrower and easier to check. Most design systems
+hand you components and hope you stay inside them. This one hands you the
+reasoning as well, so when you need something it does not ship, you can build it
+and have it still belong. The rules travel inside this package, not in a wiki
+someone forgets to read.
 
 ```sh
 npm install @oneli8/react
 ```
 
 ```jsx
-import { Button, Icon } from '@oneli8/react';
+import { MultiSelectField } from '@oneli8/react';
 import '@oneli8/react/styles.css';
 
-export function Actions() {
-  return <Button variant="primary" leadingIcon="add">Add item</Button>;
-}
+<MultiSelectField
+  label="Skills"
+  options={skills}
+  values={chosen}
+  placeholder="Add skill…"
+  onRemoveValue={remove}
+/>
 ```
 
-## What is included
+Every component is drawn from a component set in the Figma source rather than
+invented in code, and the two are checked against each other on every build.
 
-| Tier | Components |
-|---|---|
-| Atom | `Icon`, `SelectionIndicator`, `NavigationBadge` |
-| Molecule | `Button`, `IconButton`, `Link`, `TextField`, `FormMessage`, `Select`, `ChoiceItem`, `SelectionOption`, `ChoiceChip`, `Token` |
-| Organism | `Tabs`, `TabBar`, `SegmentedControl`, `RadioGroup`, `CheckboxGroup`, `SelectionPopup`, `Combobox`, `MultiSelectField`, `ChoicePicker` |
-| Material | Gem, an attribute adapter rather than a tier |
+## What is included
 
 Twenty one components, matching `@oneli8/core` one for one. Both packages are
 checked against each other on every build, so the two cannot answer differently
 about a role, a name, a relationship or a state.
 
+**Atoms** · `Icon` · `SelectionIndicator` · `NavigationBadge`
+
+**Molecules** · `Button` · `IconButton` · `Link` · `TextField` · `FormMessage`
+· `Select` · `ChoiceItem` · `SelectionOption` · `ChoiceChip` · `Token`
+
+**Organisms** · `Tabs` · `TabBar` · `SegmentedControl` · `RadioGroup`
+· `CheckboxGroup` · `SelectionPopup` · `Combobox` · `MultiSelectField`
+· `ChoicePicker`
+
+**Material** · Gem, an attribute adapter rather than a tier
+
 ## The system travels with the package
 
 If you need a component OneLi8 does not ship, build it from these foundations
@@ -54,14 +78,9 @@ Read @oneli8/react/ai-context.json and PRINCIPLES.md before writing any OneLi8 U
 
 ## Why this exists
 
-OneLi8 means One Light. It was created by Akshay Dhore, intended for broad human
-benefit and conceived as service to Guruji Shrii Arnav, whose teachings inspire
-it. Service, clarity, harmony, proportion, restraint and evolution guide its
-decisions. `PRINCIPLES.md` ships inside this package and sets them out in full.
-
-The practical intention: most design systems hand you components and hope you
-stay inside them. This one hands you the reasoning too, so when you need
-something it does not ship you can build it and have it still belong.
+`PRINCIPLES.md` ships inside this package and sets out the six values in full,
+along with the three operating laws every component obeys. It is the document to
+read before extending anything.
 
 ## Naming
 

package/ai-context.json

@@ -1,7 +1,7 @@
 {
   "$comment": "GENERATED by packages/sync/src/build-package-context.mjs — do not edit.",
   "system": "OneLi8",
-  "version": "1.0.0-beta.6",
+  "version": "1.0.0-beta.8",
   "meaning": "OneLi8 means One Light.",
   "foundations": {
     "package": "@oneli8/tokens",
@@ -13,7 +13,7 @@
       "color-primary-* is an alias ramp onto color-blue-* — identical values, distinct names. Prefer the semantic role over either.",
       "Dimension scale is 3px-atomic. Even multiples for structural layout; odd multiples are deliberate optical or micro-gap choices.",
       "Elevation ink is cyan-840 rgb(22,63,75) — never default black.",
-      "Typography roles are composite. Use the .ol8-type-<role> class, not the individual font vars.",
+      "Typography roles are composite. Apply a whole role, all five of --ol8-typography-<role>-{font-family,font-size,font-weight,line-height,letter-spacing}, rather than picking loose font vars. This package ships custom properties and no class names.",
       "shape-radius-full (999px) is reserved for pills and circles. Soft hexagons are component-specific recipes, not a radius token."
     ]
   },
@@ -223,7 +223,7 @@
       "A literal colour, size or font value anywhere in a component.",
       "A primitive token in a component. Primitives are hidden from the Figma pickers for the same reason.",
       "An invented icon name. Choose from OL8_ICONS.",
-      "A per-size icon stroke. The 1.8 stroke is shared, and the 18px master is an exact 0.75 scale of the 24px one.",
+      "A per-size icon stroke. The 1.8 stroke is shared, and an Icon Frame instance is an exact scale of the 24px master, so an 18px one carries a 1.35 stroke. The selection masters are the exception: Icon / Selection / Check keeps the same 10.2 x 6.9 artwork at 1.8 in both its 18 and 24 boxes, so it is not scaled.",
       "Mixing a filled treatment with an outlined one across selection controls. Checkbox and Radio share one language."
     ]
   },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oneli8/react",
-  "version": "1.0.0-beta.6",
+  "version": "1.0.0-beta.8",
   "description": "OneLi8 Design System for React. Components, design tokens, the Gem material, and the design language they follow.",
   "keywords": [
     "react",
@@ -52,7 +52,7 @@
     "NOTICE"
   ],
   "dependencies": {
-    "@oneli8/tokens": "1.0.0-beta.6"
+    "@oneli8/tokens": "1.0.0-beta.8"
   },
   "peerDependencies": {
     "react": ">=18"