@vllnt/ui-native 0.1.0-canary.20260917105553.sha7466647a4ba5
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/CHANGELOG.md +17 -0
- package/LICENSE +21 -0
- package/README.md +89 -0
- package/dist/index.d.ts +4636 -0
- package/dist/index.js +24238 -0
- package/package.json +57 -0
- package/registry.json +876 -0
- package/registry.schema.json +78 -0
package/CHANGELOG.md
ADDED
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
# Changelog
|
|
2
|
+
|
|
3
|
+
All notable changes to `@vllnt/ui-native` are documented in this file.
|
|
4
|
+
|
|
5
|
+
## [Unreleased]
|
|
6
|
+
|
|
7
|
+
### Added
|
|
8
|
+
|
|
9
|
+
- Experimental source-only React Native renderer with 171 component modules spanning foundation, forms, data, content, AI, learning, motion, utilities, controls, overlays, and navigation.
|
|
10
|
+
- Shared light, dark, and system theme support generated from canonical design tokens.
|
|
11
|
+
- Controlled/uncontrolled state, caller-owned selection, reduced-motion observation, native modal layering, safe-area injection, and typed platform-service adapters.
|
|
12
|
+
- Machine-readable availability, compatibility, source, peer dependency, and installation metadata in `registry.json`.
|
|
13
|
+
- Generated barrel/manifest drift checks, native boundary checks, Jest interaction coverage, and packed-package validation.
|
|
14
|
+
|
|
15
|
+
### Availability
|
|
16
|
+
|
|
17
|
+
- No npm version is published. The renderer remains `availability: "source"` with `installation.available: false` until synchronized canary publication and device/accessibility gates pass.
|
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2025 vllnt
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
ADDED
|
@@ -0,0 +1,89 @@
|
|
|
1
|
+
# @vllnt/ui-native
|
|
2
|
+
|
|
3
|
+
Accessible React Native components that share VLLNT UI semantic tokens and portable option names while using a renderer designed specifically for React Native.
|
|
4
|
+
|
|
5
|
+
> Experimental and source-only. The repository contains the renderer, but no npm release exists yet. Do not run the planned canary install command until the native manifest reports `installation.available: true`.
|
|
6
|
+
|
|
7
|
+
The package base is **0.1.0**, not a published stable release. Core and Native canaries use the same `0.1.0-canary.<run>.sha<commit>` version and an exact core dependency. Workflow publication is unconditionally disabled pending a separate hardening/enabling review; the stable promotion hold also remains. See [releasing](../../docs/RELEASING.md). Neither merge nor passing local tests authorizes enabling Native publication.
|
|
8
|
+
|
|
9
|
+
## Current availability
|
|
10
|
+
|
|
11
|
+
- 171 native component modules are listed in [`registry.json`](registry.json).
|
|
12
|
+
- `availability` is `source` and `installation.available` is `false`.
|
|
13
|
+
- React 19 and React Native 0.81 or newer are required.
|
|
14
|
+
- Android/iOS Metro export, real-device, VoiceOver, and TalkBack validation remain release gates.
|
|
15
|
+
|
|
16
|
+
The planned command after the first synchronized publication is:
|
|
17
|
+
|
|
18
|
+
```bash
|
|
19
|
+
pnpm add @vllnt/ui-native@canary
|
|
20
|
+
```
|
|
21
|
+
|
|
22
|
+
Until then, use the repository workspace and private Expo catalog for local evaluation.
|
|
23
|
+
|
|
24
|
+
## Local use
|
|
25
|
+
|
|
26
|
+
```tsx
|
|
27
|
+
import {
|
|
28
|
+
Button,
|
|
29
|
+
Card,
|
|
30
|
+
CardContent,
|
|
31
|
+
Heading,
|
|
32
|
+
Text,
|
|
33
|
+
ThemeProvider,
|
|
34
|
+
} from "@vllnt/ui-native";
|
|
35
|
+
|
|
36
|
+
export function Example() {
|
|
37
|
+
return (
|
|
38
|
+
<ThemeProvider colorScheme="system">
|
|
39
|
+
<Card>
|
|
40
|
+
<CardContent>
|
|
41
|
+
<Heading level={2}>Native VLLNT UI</Heading>
|
|
42
|
+
<Text>React Native primitives and semantic tokens.</Text>
|
|
43
|
+
<Button onPress={() => {}}>Save changes</Button>
|
|
44
|
+
</CardContent>
|
|
45
|
+
</Card>
|
|
46
|
+
</ThemeProvider>
|
|
47
|
+
);
|
|
48
|
+
}
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
The renderer includes foundation, form, data, content, AI, learning, motion, utility, control, overlay, and navigation modules. The machine-readable manifest is the authoritative inventory and classifies each module as `portable-options` or `native-adapted`.
|
|
52
|
+
|
|
53
|
+
## Renderer contract
|
|
54
|
+
|
|
55
|
+
Native APIs stay native:
|
|
56
|
+
|
|
57
|
+
- Use `onPress`, `style`, React Native accessibility roles/states/actions, safe-area adapters, and platform services.
|
|
58
|
+
- Use caller-owned IDs for selection and controlled/uncontrolled state where applicable.
|
|
59
|
+
- Inject clipboard and file-picker services; unsupported capabilities expose an explicit unavailable state.
|
|
60
|
+
- Respect reduced-motion preferences for animated interactions.
|
|
61
|
+
- Do not pass web-only props such as `className`, `onClick`, or `asChild`.
|
|
62
|
+
|
|
63
|
+
The package has no DOM, Radix UI, Tailwind CSS, NativeWind, or browser-global dependency. `@vllnt/ui` remains the stable web renderer and does not depend on this package.
|
|
64
|
+
|
|
65
|
+
## Theme
|
|
66
|
+
|
|
67
|
+
`ThemeProvider` follows the device color scheme by default. Pass `colorScheme="light"` or `colorScheme="dark"` for a fixed mode, and `override` for semantic token customization. Native-safe sRGB colors and point values are generated from `packages/design/tokens.json` through `@vllnt/ui-core`.
|
|
68
|
+
|
|
69
|
+
## Source organization
|
|
70
|
+
|
|
71
|
+
- `src/components/<name>/<name>.tsx`: flat kebab-case component folders, matching Web; component-specific helpers and unit tests belong beside the implementation (for example, `button/button-styles.ts`).
|
|
72
|
+
- `src/primitives/`: shared Native interaction, platform-service, selection, and motion utilities, with their colocated tests.
|
|
73
|
+
- `src/theme/`: Native theme provider; portable tokens remain in `@vllnt/ui-core`.
|
|
74
|
+
- `src/tests/`: cross-component family and integration suites, named for their contracts rather than review batches.
|
|
75
|
+
- `src/index.ts`: generated public exports. No extra folder barrels or public import changes are required.
|
|
76
|
+
|
|
77
|
+
## Verify locally
|
|
78
|
+
|
|
79
|
+
```bash
|
|
80
|
+
pnpm -F @vllnt/ui-native lint
|
|
81
|
+
pnpm -F @vllnt/ui-native typecheck
|
|
82
|
+
pnpm -F @vllnt/ui-native test:once
|
|
83
|
+
pnpm -F @vllnt/ui-native build
|
|
84
|
+
pnpm -F @vllnt/ui-native boundaries:check
|
|
85
|
+
pnpm -F @vllnt/ui-native generate:index:check
|
|
86
|
+
pnpm -F @vllnt/ui-native pack:check
|
|
87
|
+
```
|
|
88
|
+
|
|
89
|
+
Browse the [Native component catalog](https://ui.vllnt.com/components?platform=native) and switch to Native on the [unified installation guide](https://ui.vllnt.com/docs/installation?platform=native) for source availability and the release boundary.
|