@oneli8/react 1.0.0-beta.7 → 1.0.0-beta.9

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,13 +1,16 @@
 {
   "$comment": "GENERATED by packages/sync/src/build-package-context.mjs — do not edit.",
   "system": "OneLi8",
-  "version": "1.0.0-beta.7",
+  "version": "1.0.0-beta.9",
   "meaning": "OneLi8 means One Light.",
   "foundations": {
     "package": "@oneli8/tokens",
     "css": "@oneli8/tokens/css",
     "tokenPrefix": "--ol8-",
-    "namingAuthority": "Figma. Every variable carries an explicit codeSyntax, recorded verbatim in packages/tokens/src/figma-code-syntax.txt. Names are never derived from a rule.",
+    "naming": {
+      "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.",
+      "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."
+    },
     "rules": [
       "Components consume SEMANTIC roles only. Primitives (color-<family>-<step>) are hidden from pickers in Figma and must not appear in component code.",
       "color-primary-* is an alias ramp onto color-blue-* — identical values, distinct names. Prefer the semantic role over either.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oneli8/react",
-  "version": "1.0.0-beta.7",
+  "version": "1.0.0-beta.9",
   "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.7"
+    "@oneli8/tokens": "1.0.0-beta.9"
   },
   "peerDependencies": {
     "react": ">=18"