anhedral 0.16.0 → 0.17.0

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.
Files changed (109) hide show
  1. package/README.md +75 -18
  2. package/assets/ui/UPSTREAM.json +1 -18
  3. package/dist/capabilities.d.ts +1 -1
  4. package/dist/dependencies.d.ts +0 -3
  5. package/dist/dependencies.js +0 -54
  6. package/dist/registry/resolve.js +2 -0
  7. package/dist/scaffold/documentation.js +17 -48
  8. package/dist/scaffold/workspace.js +0 -6
  9. package/dist/stack-registry.d.ts +2 -4
  10. package/dist/stack-registry.js +1 -11
  11. package/dist/version.d.ts +1 -1
  12. package/dist/version.js +1 -1
  13. package/docs/anhedral-stack.md +10 -5
  14. package/docs/assets/anhedral-stack-light.png +0 -0
  15. package/docs/assets/anhedral-stack.png +0 -0
  16. package/docs/capabilities.md +1 -1
  17. package/docs/native-ui.md +47 -102
  18. package/docs/software-factory.md +37 -24
  19. package/docs/stack-standard.md +19 -21
  20. package/docs/ui.md +1 -1
  21. package/docs/verification.md +6 -1067
  22. package/package.json +10 -6
  23. package/assets/ui/native/_controls.tsx +0 -521
  24. package/assets/ui/native/_core.tsx +0 -118
  25. package/assets/ui/native/_data.tsx +0 -200
  26. package/assets/ui/native/_display.tsx +0 -453
  27. package/assets/ui/native/_feedback.tsx +0 -242
  28. package/assets/ui/native/_legacy-dialog.tsx +0 -38
  29. package/assets/ui/native/_motion.tsx +0 -520
  30. package/assets/ui/native/_overlay.tsx +0 -402
  31. package/assets/ui/native/_selection.tsx +0 -366
  32. package/assets/ui/native/accordion.tsx +0 -1
  33. package/assets/ui/native/alert-dialog.tsx +0 -11
  34. package/assets/ui/native/alert.tsx +0 -1
  35. package/assets/ui/native/aspect-ratio.tsx +0 -1
  36. package/assets/ui/native/attachment.tsx +0 -8
  37. package/assets/ui/native/avatar.tsx +0 -8
  38. package/assets/ui/native/badge.tsx +0 -1
  39. package/assets/ui/native/breadcrumb.tsx +0 -9
  40. package/assets/ui/native/bubble.tsx +0 -1
  41. package/assets/ui/native/button-group.tsx +0 -1
  42. package/assets/ui/native/button.tsx +0 -86
  43. package/assets/ui/native/calendar.tsx +0 -170
  44. package/assets/ui/native/card.tsx +0 -44
  45. package/assets/ui/native/carousel.tsx +0 -1
  46. package/assets/ui/native/chart.tsx +0 -193
  47. package/assets/ui/native/checkbox.tsx +0 -1
  48. package/assets/ui/native/code-block.tsx +0 -137
  49. package/assets/ui/native/collapsible.tsx +0 -1
  50. package/assets/ui/native/combobox.tsx +0 -1
  51. package/assets/ui/native/command.tsx +0 -11
  52. package/assets/ui/native/context-menu.tsx +0 -16
  53. package/assets/ui/native/data-table.tsx +0 -1
  54. package/assets/ui/native/date-picker.tsx +0 -43
  55. package/assets/ui/native/dialog.tsx +0 -15
  56. package/assets/ui/native/direction.tsx +0 -1
  57. package/assets/ui/native/drawer.tsx +0 -10
  58. package/assets/ui/native/dropdown-menu.tsx +0 -16
  59. package/assets/ui/native/empty.tsx +0 -8
  60. package/assets/ui/native/field.tsx +0 -13
  61. package/assets/ui/native/hover-card.tsx +0 -1
  62. package/assets/ui/native/input-group.tsx +0 -8
  63. package/assets/ui/native/input-otp.tsx +0 -1
  64. package/assets/ui/native/input.tsx +0 -28
  65. package/assets/ui/native/item.tsx +0 -12
  66. package/assets/ui/native/kbd.tsx +0 -1
  67. package/assets/ui/native/label.tsx +0 -4
  68. package/assets/ui/native/layout.tsx +0 -26
  69. package/assets/ui/native/marker.tsx +0 -1
  70. package/assets/ui/native/menubar.tsx +0 -17
  71. package/assets/ui/native/message-scroller.tsx +0 -6
  72. package/assets/ui/native/message.tsx +0 -10
  73. package/assets/ui/native/native-select.tsx +0 -1
  74. package/assets/ui/native/navigation-menu.tsx +0 -10
  75. package/assets/ui/native/pagination.tsx +0 -9
  76. package/assets/ui/native/popover.tsx +0 -1
  77. package/assets/ui/native/progress.tsx +0 -1
  78. package/assets/ui/native/questionnaire.tsx +0 -130
  79. package/assets/ui/native/radio-group.tsx +0 -1
  80. package/assets/ui/native/registry.json +0 -1103
  81. package/assets/ui/native/resizable.tsx +0 -1
  82. package/assets/ui/native/scroll-area.tsx +0 -1
  83. package/assets/ui/native/select.tsx +0 -11
  84. package/assets/ui/native/separator.tsx +0 -1
  85. package/assets/ui/native/sheet.tsx +0 -10
  86. package/assets/ui/native/sidebar.tsx +0 -22
  87. package/assets/ui/native/skeleton.tsx +0 -1
  88. package/assets/ui/native/slider.tsx +0 -1
  89. package/assets/ui/native/spinner.tsx +0 -1
  90. package/assets/ui/native/switch.tsx +0 -1
  91. package/assets/ui/native/table.tsx +0 -10
  92. package/assets/ui/native/tabs.tsx +0 -1
  93. package/assets/ui/native/text.tsx +0 -20
  94. package/assets/ui/native/textarea.tsx +0 -1
  95. package/assets/ui/native/theme-switcher.tsx +0 -22
  96. package/assets/ui/native/toast.tsx +0 -11
  97. package/assets/ui/native/toggle-group.tsx +0 -1
  98. package/assets/ui/native/toggle.tsx +0 -1
  99. package/assets/ui/native/tooltip.tsx +0 -1
  100. package/assets/ui/native/trace.tsx +0 -20
  101. package/assets/ui/native/typography.tsx +0 -15
  102. package/assets/ui/theme-storage.ts +0 -25
  103. package/assets/ui/theme.tsx +0 -66
  104. package/dist/platforms/mobile.d.ts +0 -2
  105. package/dist/platforms/mobile.js +0 -137
  106. package/dist/scaffold/expo-runtime.d.ts +0 -3
  107. package/dist/scaffold/expo-runtime.js +0 -42
  108. package/dist/scaffold/native-ui.d.ts +0 -2
  109. package/dist/scaffold/native-ui.js +0 -74
package/docs/native-ui.md CHANGED
@@ -1,102 +1,47 @@
1
- # Native shadcn components for Expo
2
-
3
- > Legacy port reference. New init does not generate this port. Current Anhedral UI uses official shadcn and React Native Reusables through [the UI CLI](ui.md); exhaustive native parity is not its release gate. This material and active port work are preserved for separate review.
4
-
5
- Anhedral CLI maintains React Native semantic adaptations for the **66 entries** in the [shadcn Components catalog](https://ui.shadcn.com/docs/components), reviewed 2026-10-24. This is the native component baseline; upstream's separate AI Elements, form-library integrations and ecosystem registry packages have independent scopes. New upstream components require a new review rather than inheriting a complete status automatically.
6
-
7
- ## Source and ownership
8
-
9
- Canonical implementations live in `assets/ui/native/`; `registry.json` owns the public component inventory and export names. Shared helpers have an underscore prefix. `src/scaffold/native-ui.ts` copies all required source into each generated application's `packages/native-ui`, with the inventory in `NATIVE_COMPONENTS.json`. The package exposes `@workspace/native-ui`, `@workspace/native-ui/components/<name>` and `@workspace/native-ui/theme`. Styling comes from `@workspace/styling`; no independent native palette or DOM runtime is installed.
10
-
11
- Generated source belongs to the application. CLI updates never overwrite an existing product's edited components. Compare the pinned inventory and apply reviewed source changes explicitly. Maintain attribution in `assets/ui/UPSTREAM.json` and `LICENSE.shadcn`.
12
-
13
- ## Native API and interactions
14
-
15
- These are native APIs, not DOM prop or Recharts compatibility shims. Use React Native `style`, `onPress`, accessibility props and typed controlled-value callbacks. Compound Dialog/Select/Tabs/Accordion/menu parts share root context. The original Dialog `triggerLabel`/`title` interface remains supported. Do not import this package into Next.js.
16
-
17
- Menus, popovers, sheets and preview cards use native Modal surfaces; hover/context interactions have touch-and-hold and screen-reader activation. Overlays handle native back/escape, restore trigger focus and keep dismissed content out of accessibility traversal. Drawer has a drag handle and accessible dismissal action. Slider and Resizable expose adjustable actions as well as drag handling. Native ScrollView owns platform scroll indicators, so ScrollBar intentionally renders no separate thumb.
18
-
19
- Calendar supports local-date single, multiple and range selection, locale labels and disabled bounds/predicates. DatePicker adds a modal trigger. DataTable owns native sorting/filtering/pagination and stable row IDs, with native column renderers. Chart accepts `data: { label: string; value: number }[]` and bar/line/area/pie/radar/radial renderers using Expo-compatible SVG; it does not execute browser chart components. CodeBlock preserves source bytes, renders offline lexical syntax/diff tokens and uses Expo Clipboard. It does not execute code or claim language-server tokenization. MessageScroller follows new content only while the reader is at the bottom. Questionnaire supports single/multiple/text steps, back/skip and validated submission.
20
-
21
- ## Checks and maintenance
22
-
23
- From the CLI checkout, install the pinned test harness with `pnpm --dir tests/native-ui install --frozen-lockfile`, then run `pnpm test:native-ui`. It typechecks the copied public source and renders it with React Native Testing Library under iOS and Android module resolution. Native bridges are mocked only at platform boundaries; component implementations are not replaced with HTML or mocks. The catalog examples must cover exactly the baseline and every declared export must exist. Family tests exercise controlled/uncontrolled state, disabled choices, filtering, date bounds/ranges, native dismissal, stepping/resizing, pagination/selection, timers, code/clipboard, chart selection, themes and submission.
24
-
25
- For interactive review, run `pnpm --dir tests/native-ui showcase` with a development client built from this harness (`pnpm --dir tests/native-ui exec expo run:ios` or `expo run:android`). The gallery exposes all 66 examples and theme switching. Use a fresh client after changing native dependency pins. Device acceptance includes VoiceOver/TalkBack, dynamic type, safe areas, gestures, keyboard dismissal, RTL and reduced motion.
26
-
27
- Root tests additionally generate a source-only application and compare every native source file, public export, dependency pin and packaged registry. Native-source changes run the native harness in the existing Linux CI gate. `pnpm native-ui:upstream` explicitly checks the live upstream catalog for added/removed IDs; it is not a network requirement for normal builds/tests. Update the reviewed baseline, implementation and tests together, then regenerate this checklist with `pnpm native-ui:docs`.
28
-
29
- **Evidence boundary:** automated component tests execute JavaScript, not native OS rendering. The device columns deliberately remain unchecked until each component is accepted with VoiceOver/TalkBack, dynamic type, keyboard/gestures, safe areas, reduced motion, RTL, and light/dark themes on the actual iOS/Android target. Compile/export success is not device acceptance. Record dated runs in `docs/verification.md`; do not mark these device columns from a Jest result.
30
-
31
- ## Component parity checklist
32
-
33
- This table is generated from `assets/ui/native/registry.json`. “Automated” means a catalog render/export contract plus its named family suite, not complete upstream DOM API coverage or native-device certification.
34
-
35
- | Upstream component | Native source | Implementation | Automated family | iOS device | Android device | Native adaptation |
36
- | --- | --- | --- | --- | --- | --- | --- |
37
- | [accordion](https://ui.shadcn.com/docs/components/accordion) | `accordion.tsx` | [x] | [x] controls | [ ] | [ ] | Native React Native primitives and shared semantic tokens; no DOM runtime. |
38
- | [alert](https://ui.shadcn.com/docs/components/alert) | `alert.tsx` | [x] | [x] presentation | [ ] | [ ] | Native React Native primitives and shared semantic tokens; no DOM runtime. |
39
- | [alert-dialog](https://ui.shadcn.com/docs/components/alert-dialog) | `alert-dialog.tsx` | [x] | [x] overlays | [ ] | [ ] | Explicit action/cancel; backdrop touches do not dismiss the decision. |
40
- | [aspect-ratio](https://ui.shadcn.com/docs/components/aspect-ratio) | `aspect-ratio.tsx` | [x] | [x] presentation | [ ] | [ ] | Native React Native primitives and shared semantic tokens; no DOM runtime. |
41
- | [attachment](https://ui.shadcn.com/docs/components/attachment) | `attachment.tsx` | [x] | [x] presentation | [ ] | [ ] | Native React Native primitives and shared semantic tokens; no DOM runtime. |
42
- | [avatar](https://ui.shadcn.com/docs/components/avatar) | `avatar.tsx` | [x] | [x] presentation | [ ] | [ ] | Native React Native primitives and shared semantic tokens; no DOM runtime. |
43
- | [badge](https://ui.shadcn.com/docs/components/badge) | `badge.tsx` | [x] | [x] presentation | [ ] | [ ] | Native React Native primitives and shared semantic tokens; no DOM runtime. |
44
- | [breadcrumb](https://ui.shadcn.com/docs/components/breadcrumb) | `breadcrumb.tsx` | [x] | [x] presentation | [ ] | [ ] | Native React Native primitives and shared semantic tokens; no DOM runtime. |
45
- | [bubble](https://ui.shadcn.com/docs/components/bubble) | `bubble.tsx` | [x] | [x] presentation | [ ] | [ ] | Native React Native primitives and shared semantic tokens; no DOM runtime. |
46
- | [button](https://ui.shadcn.com/docs/components/button) | `button.tsx` | [x] | [x] controls | [ ] | [ ] | Native React Native primitives and shared semantic tokens; no DOM runtime. |
47
- | [button-group](https://ui.shadcn.com/docs/components/button-group) | `button-group.tsx` | [x] | [x] presentation | [ ] | [ ] | Native React Native primitives and shared semantic tokens; no DOM runtime. |
48
- | [calendar](https://ui.shadcn.com/docs/components/calendar) | `calendar.tsx` | [x] | [x] calendar | [ ] | [ ] | Locale-aware native day grid; single/multiple/range selection and disabled dates. |
49
- | [card](https://ui.shadcn.com/docs/components/card) | `card.tsx` | [x] | [x] presentation | [ ] | [ ] | Native React Native primitives and shared semantic tokens; no DOM runtime. |
50
- | [carousel](https://ui.shadcn.com/docs/components/carousel) | `carousel.tsx` | [x] | [x] motion | [ ] | [ ] | Native paged ScrollView, bounded/loop navigation and accessible controls. |
51
- | [chart](https://ui.shadcn.com/docs/components/chart) | `chart.tsx` | [x] | [x] content | [ ] | [ ] | Native SVG bar, line, area, pie, radar and radial charts with accessible data selection; native data API replaces Recharts. |
52
- | [checkbox](https://ui.shadcn.com/docs/components/checkbox) | `checkbox.tsx` | [x] | [x] controls | [ ] | [ ] | Native React Native primitives and shared semantic tokens; no DOM runtime. |
53
- | [code-block](https://ui.shadcn.com/docs/components/code-block) | `code-block.tsx` | [x] | [x] content | [ ] | [ ] | Offline native Text syntax/diff tokens and Expo Clipboard; no HTML injection or runtime code execution. |
54
- | [collapsible](https://ui.shadcn.com/docs/components/collapsible) | `collapsible.tsx` | [x] | [x] controls | [ ] | [ ] | Native React Native primitives and shared semantic tokens; no DOM runtime. |
55
- | [combobox](https://ui.shadcn.com/docs/components/combobox) | `combobox.tsx` | [x] | [x] selection | [ ] | [ ] | Native React Native primitives and shared semantic tokens; no DOM runtime. |
56
- | [command](https://ui.shadcn.com/docs/components/command) | `command.tsx` | [x] | [x] selection | [ ] | [ ] | Native React Native primitives and shared semantic tokens; no DOM runtime. |
57
- | [context-menu](https://ui.shadcn.com/docs/components/context-menu) | `context-menu.tsx` | [x] | [x] overlays | [ ] | [ ] | Touch-and-hold or accessibility activation opens a native modal action menu. |
58
- | [data-table](https://ui.shadcn.com/docs/components/data-table) | `data-table.tsx` | [x] | [x] data-feedback | [ ] | [ ] | Native sortable/filterable/paginated rows with stable ID selection; native column API replaces DOM/TanStack renderers. |
59
- | [date-picker](https://ui.shadcn.com/docs/components/date-picker) | `date-picker.tsx` | [x] | [x] calendar | [ ] | [ ] | Modal calendar picker replaces browser popover input. |
60
- | [dialog](https://ui.shadcn.com/docs/components/dialog) | `dialog.tsx` | [x] | [x] overlays | [ ] | [ ] | Compound native Modal API plus backwards-compatible original triggerLabel/title API. |
61
- | [direction](https://ui.shadcn.com/docs/components/direction) | `direction.tsx` | [x] | [x] motion | [ ] | [ ] | Context and native layout direction; slider adjusts its gesture direction in RTL. |
62
- | [drawer](https://ui.shadcn.com/docs/components/drawer) | `drawer.tsx` | [x] | [x] overlays | [ ] | [ ] | Native React Native primitives and shared semantic tokens; no DOM runtime. |
63
- | [dropdown-menu](https://ui.shadcn.com/docs/components/dropdown-menu) | `dropdown-menu.tsx` | [x] | [x] overlays | [ ] | [ ] | Native React Native primitives and shared semantic tokens; no DOM runtime. |
64
- | [empty](https://ui.shadcn.com/docs/components/empty) | `empty.tsx` | [x] | [x] presentation | [ ] | [ ] | Native React Native primitives and shared semantic tokens; no DOM runtime. |
65
- | [field](https://ui.shadcn.com/docs/components/field) | `field.tsx` | [x] | [x] controls | [ ] | [ ] | Native React Native primitives and shared semantic tokens; no DOM runtime. |
66
- | [hover-card](https://ui.shadcn.com/docs/components/hover-card) | `hover-card.tsx` | [x] | [x] overlays | [ ] | [ ] | Touch-and-hold preview replaces hover-only activation. |
67
- | [input](https://ui.shadcn.com/docs/components/input) | `input.tsx` | [x] | [x] controls | [ ] | [ ] | Native React Native primitives and shared semantic tokens; no DOM runtime. |
68
- | [input-group](https://ui.shadcn.com/docs/components/input-group) | `input-group.tsx` | [x] | [x] controls | [ ] | [ ] | Native React Native primitives and shared semantic tokens; no DOM runtime. |
69
- | [input-otp](https://ui.shadcn.com/docs/components/input-otp) | `input-otp.tsx` | [x] | [x] controls | [ ] | [ ] | Native single code field supports OS autofill and paste; optional visual digit slots. |
70
- | [item](https://ui.shadcn.com/docs/components/item) | `item.tsx` | [x] | [x] presentation | [ ] | [ ] | Native React Native primitives and shared semantic tokens; no DOM runtime. |
71
- | [kbd](https://ui.shadcn.com/docs/components/kbd) | `kbd.tsx` | [x] | [x] presentation | [ ] | [ ] | Native React Native primitives and shared semantic tokens; no DOM runtime. |
72
- | [label](https://ui.shadcn.com/docs/components/label) | `label.tsx` | [x] | [x] presentation | [ ] | [ ] | Native React Native primitives and shared semantic tokens; no DOM runtime. |
73
- | [marker](https://ui.shadcn.com/docs/components/marker) | `marker.tsx` | [x] | [x] presentation | [ ] | [ ] | Native React Native primitives and shared semantic tokens; no DOM runtime. |
74
- | [menubar](https://ui.shadcn.com/docs/components/menubar) | `menubar.tsx` | [x] | [x] overlays | [ ] | [ ] | Touch menus replace browser menubar keyboard conventions. |
75
- | [message](https://ui.shadcn.com/docs/components/message) | `message.tsx` | [x] | [x] presentation | [ ] | [ ] | Native React Native primitives and shared semantic tokens; no DOM runtime. |
76
- | [message-scroller](https://ui.shadcn.com/docs/components/message-scroller) | `message-scroller.tsx` | [x] | [x] data-feedback | [ ] | [ ] | Follow new content only while at the bottom; preserve reading position otherwise. |
77
- | [native-select](https://ui.shadcn.com/docs/components/native-select) | `native-select.tsx` | [x] | [x] selection | [ ] | [ ] | Accessible modal picker replaces the HTML select element. |
78
- | [navigation-menu](https://ui.shadcn.com/docs/components/navigation-menu) | `navigation-menu.tsx` | [x] | [x] selection | [ ] | [ ] | Native React Native primitives and shared semantic tokens; no DOM runtime. |
79
- | [pagination](https://ui.shadcn.com/docs/components/pagination) | `pagination.tsx` | [x] | [x] data-feedback | [ ] | [ ] | Native React Native primitives and shared semantic tokens; no DOM runtime. |
80
- | [popover](https://ui.shadcn.com/docs/components/popover) | `popover.tsx` | [x] | [x] overlays | [ ] | [ ] | Native React Native primitives and shared semantic tokens; no DOM runtime. |
81
- | [progress](https://ui.shadcn.com/docs/components/progress) | `progress.tsx` | [x] | [x] presentation | [ ] | [ ] | Native React Native primitives and shared semantic tokens; no DOM runtime. |
82
- | [questionnaire](https://ui.shadcn.com/docs/components/questionnaire) | `questionnaire.tsx` | [x] | [x] content | [ ] | [ ] | Native single/multiple/text steps with required-answer validation, back/skip and one completion per submission. |
83
- | [radio-group](https://ui.shadcn.com/docs/components/radio-group) | `radio-group.tsx` | [x] | [x] controls | [ ] | [ ] | Native React Native primitives and shared semantic tokens; no DOM runtime. |
84
- | [resizable](https://ui.shadcn.com/docs/components/resizable) | `resizable.tsx` | [x] | [x] motion | [ ] | [ ] | PanResponder handles and accessible increment/decrement resize adjacent native panels within bounds. |
85
- | [scroll-area](https://ui.shadcn.com/docs/components/scroll-area) | `scroll-area.tsx` | [x] | [x] data-feedback | [ ] | [ ] | Native ScrollView owns scrolling and its platform scrollbar; ScrollBar is an intentional no-render adapter. |
86
- | [select](https://ui.shadcn.com/docs/components/select) | `select.tsx` | [x] | [x] selection | [ ] | [ ] | Native React Native primitives and shared semantic tokens; no DOM runtime. |
87
- | [separator](https://ui.shadcn.com/docs/components/separator) | `separator.tsx` | [x] | [x] presentation | [ ] | [ ] | Native React Native primitives and shared semantic tokens; no DOM runtime. |
88
- | [sheet](https://ui.shadcn.com/docs/components/sheet) | `sheet.tsx` | [x] | [x] overlays | [ ] | [ ] | Native React Native primitives and shared semantic tokens; no DOM runtime. |
89
- | [sidebar](https://ui.shadcn.com/docs/components/sidebar) | `sidebar.tsx` | [x] | [x] data-feedback | [ ] | [ ] | Modal navigation drawer with a shared controlled/uncontrolled provider. |
90
- | [skeleton](https://ui.shadcn.com/docs/components/skeleton) | `skeleton.tsx` | [x] | [x] presentation | [ ] | [ ] | Native React Native primitives and shared semantic tokens; no DOM runtime. |
91
- | [slider](https://ui.shadcn.com/docs/components/slider) | `slider.tsx` | [x] | [x] motion | [ ] | [ ] | Touch drag and screen-reader adjustable actions; bounded single/multiple values and step constraints. |
92
- | [spinner](https://ui.shadcn.com/docs/components/spinner) | `spinner.tsx` | [x] | [x] presentation | [ ] | [ ] | Native React Native primitives and shared semantic tokens; no DOM runtime. |
93
- | [switch](https://ui.shadcn.com/docs/components/switch) | `switch.tsx` | [x] | [x] controls | [ ] | [ ] | Native React Native primitives and shared semantic tokens; no DOM runtime. |
94
- | [table](https://ui.shadcn.com/docs/components/table) | `table.tsx` | [x] | [x] data-feedback | [ ] | [ ] | Native React Native primitives and shared semantic tokens; no DOM runtime. |
95
- | [tabs](https://ui.shadcn.com/docs/components/tabs) | `tabs.tsx` | [x] | [x] controls | [ ] | [ ] | Native React Native primitives and shared semantic tokens; no DOM runtime. |
96
- | [textarea](https://ui.shadcn.com/docs/components/textarea) | `textarea.tsx` | [x] | [x] controls | [ ] | [ ] | Native React Native primitives and shared semantic tokens; no DOM runtime. |
97
- | [toast](https://ui.shadcn.com/docs/components/toast) | `toast.tsx` | [x] | [x] data-feedback | [ ] | [ ] | Native React Native primitives and shared semantic tokens; no DOM runtime. |
98
- | [toggle](https://ui.shadcn.com/docs/components/toggle) | `toggle.tsx` | [x] | [x] controls | [ ] | [ ] | Native React Native primitives and shared semantic tokens; no DOM runtime. |
99
- | [toggle-group](https://ui.shadcn.com/docs/components/toggle-group) | `toggle-group.tsx` | [x] | [x] controls | [ ] | [ ] | Native React Native primitives and shared semantic tokens; no DOM runtime. |
100
- | [tooltip](https://ui.shadcn.com/docs/components/tooltip) | `tooltip.tsx` | [x] | [x] overlays | [ ] | [ ] | Touch-and-hold or screen-reader activation reveals dismissible native help. |
101
- | [trace](https://ui.shadcn.com/docs/components/trace) | `trace.tsx` | [x] | [x] content | [ ] | [ ] | Native React Native primitives and shared semantic tokens; no DOM runtime. |
102
- | [typography](https://ui.shadcn.com/docs/components/typography) | `typography.tsx` | [x] | [x] presentation | [ ] | [ ] | Native React Native primitives and shared semantic tokens; no DOM runtime. |
1
+ # Archived native port
2
+
3
+ The exhaustive Anhedral shadcn-to-React-Native port is superseded by the
4
+ [source-owned UI catalog and installer](ui.md). Its assets, generator, dependency
5
+ set, test harness and parity tooling are no longer part of the active CLI.
6
+ Existing generated applications remain consumer-owned and are not rewritten.
7
+
8
+ New applications start with Next.js. Add an Expo client with `anhedral add expo`,
9
+ then its RNR/NativeWind integration with `anhedral add native-ui`. Use
10
+ `anhedral ui add` for selected platform components. Programmatic initialization
11
+ with the retired `expo` product now fails before writes with this migration path.
12
+
13
+ ## Recovery
14
+
15
+ The October 26, 2026 local archive preserves the unfinished port, including all
16
+ uncommitted tracked and untracked source, at commit
17
+ `4033cab2f068ebc021803d6730e9e04cbc274081` under
18
+ `refs/archive/2026-10-26/old-port`. The clean pre-cleanup staging baseline is
19
+ `630315094dc6bcf71414aa002bedf0dbba09fb86`. These are source identities, not release
20
+ or native acceptance certifications.
21
+
22
+ The independently restorable archive contains `repository.bundle`, source tarballs,
23
+ binary diffs, original Git status, per-file SHA-256 manifests, selected ignored
24
+ local evidence and restoration scripts/results. It is retained outside the npm
25
+ package and plugin. The archive is local; these refs are not promised on GitHub.
26
+ The maintainer's archive location and verification results are recorded in the
27
+ existing development notes.
28
+
29
+ From a supplied archive directory, restore into a new directory:
30
+
31
+ ```sh
32
+ git clone --no-checkout /path/to/archive/repository.bundle restored-native-port
33
+ git -C restored-native-port checkout --detach 4033cab2f068ebc021803d6730e9e04cbc274081
34
+ ```
35
+
36
+ The bundle also retains available refs and stashes. Inspect `git bundle list-heads`
37
+ and fetch selected refs explicitly into a separate recovery repository when needed;
38
+ ordinary cloning imports branch/tag refs, not every archival or stash ref.
39
+
40
+ Use the archive's `verify_restore.py` to verify source and evidence against their
41
+ manifests. Read `evidence-exclusions.json` for omitted reproducible caches and native
42
+ binaries; original ignored material remains in the retained old checkout.
43
+
44
+ Recover selected components only for a concrete product requirement. Review their
45
+ dependencies, provenance and compatibility with the current NativeWind/RNR runtime,
46
+ then validate the consuming application on iOS and Android. Do not merge the old
47
+ branch wholesale or revive exhaustive registry parity as a release gate.
@@ -1,26 +1,39 @@
1
1
  # Scaffold workflow
2
2
 
3
- Anhedral CLI creates a foundation; consumers develop and operate it themselves. See stack-standard.md for architectural ownership.
4
-
5
- 1. Inspect an empty destination. Preview `anhedral init my-app --dry-run --json`.
6
- 2. Run `anhedral init my-app`, or `--skip-install --no-git` for offline source generation.
7
- 3. Review README.md, AGENTS.md, anhedral.json, environment examples and Wrangler configuration. Follow the recorded Node and pnpm versions.
8
- 4. Run `pnpm dev` and open the address printed by the server. New projects contain only the web app. Add other clients only when required.
9
- 5. Use `anhedral ui list/add/diff/doctor` to extend source-owned UI; see [UI commands](ui.md). Develop features and run `pnpm check`.
10
- 6. Use `anhedral add` to compose selected [stack capabilities](capabilities.md), inspect the dry-run plan, configure the selected auth methods/providers and validate the consumer. Cloudflare, Stripe and RevenueCat Codex plugins can assist when installed and explicitly invoked; they are separate products with their own credentials and workflows.
11
-
12
- The CLI does not manage provider access, billing, infrastructure, deployments, releases or production acceptance. Generated Wrangler/OpenNext configuration and explicit database migration scripts remain editable consumer tooling.
13
-
14
- ## Maintaining the scaffold
15
-
16
- Preserve generated-consumer tests, source-generation safety, pinned dependencies, UI provenance, licenses and immutable release packaging. Check emitted source and the actual packed npm artifact. Preserve docs/verification.md as dated evidence. Keep one focused behavior per topic branch from staging; promote stable releases through main. A build does not publish npm or install a plugin.
17
-
18
- The Codex plugin ships skills and stack references only. It has no MCP server, project catalog, dashboard or provider credentials. Package validation checks the skills, references, versions and absence of a managed runtime.
19
-
20
- ## Next/OpenNext runtime regression gate
21
-
22
- Relevant web generator, build dependency and runtime-harness PRs automatically compile one isolated generated foundation and run it in local workerd. The smoke verifies prerendered homepage output, dynamic SSR/RSC, a synthetic Server Action and cookie round-trip, static asset cache headers; Hono service binding is covered separately by the retained proxy contract tests. Synthetic routes exist only in the test workspace. It never deploys or migrates a configured database. Run `pnpm test:next-runtime` locally.
23
-
24
- The gate retains `.artifacts/next-runtime/{bundle,smoke}.json` for one day. Its initial 4 MiB gzip budget sums emitted Worker JS/Wasm modules individually, lists the largest modules, and fails when exceeded. This is a source artifact regression ceiling, not provider upload size, memory consumption or cold-request latency. Review measurement changes before adjusting the ceiling.
25
-
26
- New public homepages are prerenderable; request-dependent routes opt into dynamic rendering where needed. Generated `public/_headers` caches fingerprinted Next assets immutably; ordinary assets retain platform revalidation. Authenticated responses continue to require private/no-store policy. Existing apps must adopt generator changes explicitly.
3
+ 1. Preview an empty destination with `anhedral init my-app --dry-run --json`, then
4
+ run `anhedral init my-app` and `pnpm dev` inside it.
5
+ 2. Read the generated README, AGENTS, `anhedral.json`, environment examples and
6
+ Wrangler configuration. Use their recorded tool versions.
7
+ 3. Preview and add [capabilities](capabilities.md) as needed. Configure selected
8
+ providers/auth methods, apply reviewed migrations and validate actual runtime
9
+ behavior before deployment. Source installation is not provider activation.
10
+ 4. Extend [source-owned UI](ui.md), implement features and run consumer checks.
11
+
12
+ ## Evidence-driven maintenance
13
+
14
+ Inspect current Git state and preserve unrelated work. Verify runtime entrypoints,
15
+ exports, generated consumers and operational safeguards before removing source;
16
+ static findings and passing tests alone do not prove a path is unused.
17
+
18
+ Update the existing owning guide with behavior changes. Keep exact versions and
19
+ defaults in manifests/source, not duplicated narratives. Store dated development,
20
+ audit and verification notes in
21
+ [docs/agent-notes](https://github.com/anhedral/anhedral-cli/tree/main/docs/agent-notes),
22
+ with revision, checks, failures and remaining gaps. Keep raw reports in ignored
23
+ `.artifacts/`. Historical notes are not current instructions.
24
+
25
+ Canonical docs live in `docs/`; `pnpm build` refreshes bundled plugin references.
26
+ Generated app guidance lives in `src/scaffold/documentation.ts`. Preserve shipped
27
+ reference paths, source-generation safety, dependency patch gates, UI provenance,
28
+ licenses and exact-artifact packaging. A build does not publish npm or update an
29
+ installed plugin. See [Contributing](https://github.com/anhedral/anhedral-cli/blob/main/.github/CONTRIBUTING.md)
30
+ for staging, release identity and validation tiers.
31
+
32
+ ## Next/OpenNext runtime gate
33
+
34
+ Relevant generator/build changes compile an isolated foundation and exercise it
35
+ in workerd. Run `pnpm test:next-runtime` for SSR/RSC, Server Actions/cookies,
36
+ prerendering and static cache checks. Hono proxy contracts have separate tests.
37
+ The harness owns the module-size budget and short-lived `.artifacts/next-runtime/`
38
+ receipts. Review measurement changes before adjusting limits. The smoke never
39
+ deploys or migrates a configured database; it is not production acceptance.
@@ -1,23 +1,21 @@
1
1
  # Stack standard
2
2
 
3
- New applications begin with Next.js App Router, OpenNext for Cloudflare Workers and Anhedral UI. Init writes `apps/web`, shared tokens and workspace tooling. It does not generate Expo, Hono, database/contracts packages, authentication, private R2 or managed services.
4
-
5
- ## Progressive composition
6
-
7
- Add Hono when a separate API is useful, then Drizzle/D1 and Better Auth when persistence and identity are useful. Add private R2, payments, realtime and AI for actual product requirements. Additional clients may use Expo, WXT with the Side Panel API, or GPUI for a native desktop application. Anhedral UI for Expo and RevenueCat remain conditional choices. The precise “if needed” conditions remain open; these are optional additions, without commercial tier labels.
8
-
9
- The public source interface implements `init`, progressive `add`, `stack list/status/doctor` and the `ui` family. See [capability recipes and safety](capabilities.md). Retired operational `auth`, `ship`, `inspect` and provider-management commands remain unavailable. The reintroduced `add` command composes source only. The programmatic generator retains explicit legacy recipes for compatibility tests; they are not the new-project default or the new UI architecture.
10
-
11
- When a backend is introduced, Hono owns privileged data and application authorization. Next server actions adapt forms and call that API. Share framework-independent contracts and tokens without cross-importing application source. Keep R2 private; implement identity, ownership and limits before exposing files. Database migrations are deliberate operations and never part of startup or build.
12
-
13
- ## Anhedral UI
14
-
15
- Anhedral UI is thin orchestration over official shadcn web and React Native Reusables native source. Its maintained surface is a versioned component catalog, CLI routing, setup metadata and a small reviewed native extension registry. Native resolution prefers an Anhedral extension, then RNR, then reports unavailable. The extension registry is initially empty. Do not revive the exhaustive native shadcn fork or require every component to reach parity before shipping a useful feature.
16
-
17
- New web applications include a bounded Button/Input/Label starter and MIT attribution. Additional components are installed by the pinned shadcn CLI. Native currently supports the RNR NativeWind 4 registry only, in an already configured Expo application. Keep matching React/React Native/Expo dependencies and test the consuming app. The UI layer has no dependency on Hono, D1 or Better Auth.
18
-
19
- Components belong to the consumer's source tree. Retain upstream licenses, use semantic theme tokens, review diffs and preserve local edits. No runtime UI package or automatic overwrite/update is introduced. Catalog availability means an upstream source exists; it does not assert API parity, accessibility or device acceptance. See [UI commands](ui.md).
20
-
21
- ## Operations and compatibility
22
-
23
- Init writes editable source and can install dependencies and initialize Git. It never provisions providers, creates credentials, deploys or registers a managed project. Consumers own application security and operations; Platform is a separate managed product. Existing applications, native port work and Platform runtime artifacts retain their explicit reviewed pins until separately adopted. A CLI build or release does not update them.
3
+ Start with Next.js App Router, OpenNext for Cloudflare Workers and source-owned
4
+ Anhedral UI. Add Hono, then Drizzle/D1 and Better Auth. Add private R2, payments,
5
+ realtime, AI and other clients as required. The [README](https://github.com/anhedral/anhedral-cli#readme) lists every
6
+ addition; [capabilities](capabilities.md) owns prerequisites and safety.
7
+
8
+ Hono owns privileged data and application authorization. Next server actions
9
+ adapt forms and call the API. Share framework-independent contracts and tokens
10
+ without cross-importing application source. Keep R2 private and enforce identity,
11
+ ownership and limits before exposing files. Apply reviewed database migrations
12
+ explicitly, separately from builds and startup.
13
+
14
+ UI source belongs to the consumer: official shadcn for web, React Native Reusables
15
+ for Expo and a small reviewed native extension layer. Preserve licenses, semantic
16
+ tokens and local edits. See [UI commands](ui.md).
17
+
18
+ The CLI writes editable source/configuration; consumers configure services,
19
+ credentials and deployment. Platform separately owns its managed operations.
20
+ Existing applications, legacy native work and runtime artifacts retain their
21
+ reviewed pins until deliberately adopted and validated.
package/docs/ui.md CHANGED
@@ -28,6 +28,6 @@ All commands accept the global `--cwd`, `--json` and `--quiet` options. `--web`,
28
28
 
29
29
  `.anhedral-ui.json` records platform, catalog revision and source ownership; it does not automatically update components. `ANHEDRAL_UI_LICENSES/` retains the relevant MIT notice. No Anhedral runtime package is introduced. Theme through consumer CSS variables and existing tokens. Future native extensions require a focused product need, upstream provenance/license and native consumer evidence; broad parity is not a release prerequisite.
30
30
 
31
- Validate web flows in a browser. Validate native interactions in Android/iOS development builds, including accessibility, overlays, keyboard and lifecycle. Typechecking or an Expo web export does not establish device acceptance. Legacy `docs/native-ui.md` describes the retained earlier port, not this new default UI layer.
31
+ Validate web flows in a browser. Validate native interactions in Android/iOS development builds, including accessibility, overlays, keyboard and lifecycle. Typechecking or an Expo web export does not establish device acceptance. The retired exhaustive port is preserved outside the active CLI; `docs/native-ui.md` records its recovery identity and migration path.
32
32
 
33
33
  For a generated Anhedral workspace, `anhedral add expo` creates the native application after its core source prerequisites, and `anhedral add native-ui` prepares its NativeWind/RNR integration without replacing product UI. The UI component commands remain independent of backend activation. See [stack additions](capabilities.md).