@xenosystem/elements-react 0.0.6 โ 0.0.7
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 +41 -41
- package/package.json +3 -3
package/README.md
CHANGED
|
@@ -1,41 +1,41 @@
|
|
|
1
|
-
# @xenosystem/elements-react
|
|
2
|
-
|
|
3
|
-
**Web + Electron renderer**
|
|
4
|
-
|
|
5
|
-
> Status: ๐ต **planned** โ see [`../../SPEC.md`](../../SPEC.md) ยง13 for the build order.
|
|
6
|
-
|
|
7
|
-
Interprets `@xenosystem/elements` declarations as React components and web components.
|
|
8
|
-
|
|
9
|
-
**Not built yet** โ Phase 2. The contract lands first, deliberately (`SPEC.md` ยง13).
|
|
10
|
-
|
|
11
|
-
## When it is built, it must
|
|
12
|
-
|
|
13
|
-
1. **Honour every declared axis.** Silently ignoring one produces an element that looks
|
|
14
|
-
interactive and isn't โ the worst failure in the set.
|
|
15
|
-
2. **Never invent state.** No `pressed` binding in the declaration means pressed looks like idle.
|
|
16
|
-
3. **Map input modalities** per `docs/STATE-MODEL.md` ยง3 โ including the **agent** row, or
|
|
17
|
-
agent-driven UI diverges from what a human would have seen.
|
|
18
|
-
4. **Be visually indistinguishable** from every other renderer given the same declaration. Testable, and tested.
|
|
19
|
-
5. **Add nothing.** No renderer-local colours, timings or easing.
|
|
20
|
-
|
|
21
|
-
## Hard constraints
|
|
22
|
-
|
|
23
|
-
- **CSS-first, 0 kb runtime.** Axes become `data-*` attributes; bindings become CSS custom
|
|
24
|
-
properties and transitions. This diverges from the 2026 norm (@animateicons, LivelyIcons,
|
|
25
|
-
Itshover all build on `motion/react`) because XENO elements must run inside **sandboxed
|
|
26
|
-
iframes** and survive **web export**, where a JS animation runtime is weight in every sandbox
|
|
27
|
-
and a dependency that cannot be removed later.
|
|
28
|
-
- **`motion` is an opt-in entry point only** (`/motion`), for genuinely orchestrated cases โ
|
|
29
|
-
multi-step morphs, physics. ~4.6 kb with `m` + `LazyMotion` vs 34 kb naive. **Never a
|
|
30
|
-
dependency of the base renderer.**
|
|
31
|
-
- **No barrel.** Per-element entry points, `sideEffects: false`. A single index importing
|
|
32
|
-
everything is why `lucide-react` is 2.4 MB โ and `lucide-react/dynamic` collapses to an empty
|
|
33
|
-
chunk in production builds.
|
|
34
|
-
- **Base UI is an implementation detail here**, used for composite behaviour and accessibility.
|
|
35
|
-
It is never exposed as the system's foundation. (Radix stalled after the WorkOS acquisition;
|
|
36
|
-
Base UI reached v1.0 in Dec 2025 with full-time MUI engineering.)
|
|
37
|
-
- **Components are generated**, never hand-written. Editing one to fix a glyph means the
|
|
38
|
-
declaration is wrong.
|
|
39
|
-
|
|
40
|
-
---
|
|
41
|
-
Part of [`xeno-elements`](../../README.md). Visual authority: [`DESIGN_SYSTEM.md`](../../DESIGN_SYSTEM.md) โ LOCKED.
|
|
1
|
+
# @xenosystem/elements-react
|
|
2
|
+
|
|
3
|
+
**Web + Electron renderer**
|
|
4
|
+
|
|
5
|
+
> Status: ๐ต **planned** โ see [`../../SPEC.md`](../../SPEC.md) ยง13 for the build order.
|
|
6
|
+
|
|
7
|
+
Interprets `@xenosystem/elements` declarations as React components and web components.
|
|
8
|
+
|
|
9
|
+
**Not built yet** โ Phase 2. The contract lands first, deliberately (`SPEC.md` ยง13).
|
|
10
|
+
|
|
11
|
+
## When it is built, it must
|
|
12
|
+
|
|
13
|
+
1. **Honour every declared axis.** Silently ignoring one produces an element that looks
|
|
14
|
+
interactive and isn't โ the worst failure in the set.
|
|
15
|
+
2. **Never invent state.** No `pressed` binding in the declaration means pressed looks like idle.
|
|
16
|
+
3. **Map input modalities** per `docs/STATE-MODEL.md` ยง3 โ including the **agent** row, or
|
|
17
|
+
agent-driven UI diverges from what a human would have seen.
|
|
18
|
+
4. **Be visually indistinguishable** from every other renderer given the same declaration. Testable, and tested.
|
|
19
|
+
5. **Add nothing.** No renderer-local colours, timings or easing.
|
|
20
|
+
|
|
21
|
+
## Hard constraints
|
|
22
|
+
|
|
23
|
+
- **CSS-first, 0 kb runtime.** Axes become `data-*` attributes; bindings become CSS custom
|
|
24
|
+
properties and transitions. This diverges from the 2026 norm (@animateicons, LivelyIcons,
|
|
25
|
+
Itshover all build on `motion/react`) because XENO elements must run inside **sandboxed
|
|
26
|
+
iframes** and survive **web export**, where a JS animation runtime is weight in every sandbox
|
|
27
|
+
and a dependency that cannot be removed later.
|
|
28
|
+
- **`motion` is an opt-in entry point only** (`/motion`), for genuinely orchestrated cases โ
|
|
29
|
+
multi-step morphs, physics. ~4.6 kb with `m` + `LazyMotion` vs 34 kb naive. **Never a
|
|
30
|
+
dependency of the base renderer.**
|
|
31
|
+
- **No barrel.** Per-element entry points, `sideEffects: false`. A single index importing
|
|
32
|
+
everything is why `lucide-react` is 2.4 MB โ and `lucide-react/dynamic` collapses to an empty
|
|
33
|
+
chunk in production builds.
|
|
34
|
+
- **Base UI is an implementation detail here**, used for composite behaviour and accessibility.
|
|
35
|
+
It is never exposed as the system's foundation. (Radix stalled after the WorkOS acquisition;
|
|
36
|
+
Base UI reached v1.0 in Dec 2025 with full-time MUI engineering.)
|
|
37
|
+
- **Components are generated**, never hand-written. Editing one to fix a glyph means the
|
|
38
|
+
declaration is wrong.
|
|
39
|
+
|
|
40
|
+
---
|
|
41
|
+
Part of [`xeno-elements`](../../README.md). Visual authority: [`DESIGN_SYSTEM.md`](../../DESIGN_SYSTEM.md) โ LOCKED.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@xenosystem/elements-react",
|
|
3
|
-
"version": "0.0.
|
|
3
|
+
"version": "0.0.7",
|
|
4
4
|
"license": "UNLICENSED",
|
|
5
5
|
"description": "The XENO web renderer โ interprets element declarations as React/SVG. CSS-first, 0 kb runtime.",
|
|
6
6
|
"author": "XENO Corporation <emilian@bnkrsys.com>",
|
|
@@ -42,8 +42,8 @@
|
|
|
42
42
|
},
|
|
43
43
|
"dependencies": {
|
|
44
44
|
"@fontsource-variable/inter": "^5.3.0",
|
|
45
|
-
"@xenosystem/elements": "0.0.
|
|
46
|
-
"@xenosystem/generate": "0.0.
|
|
45
|
+
"@xenosystem/elements": "0.0.7",
|
|
46
|
+
"@xenosystem/generate": "0.0.7"
|
|
47
47
|
},
|
|
48
48
|
"devDependencies": {
|
|
49
49
|
"@types/react": "^19.0.0",
|