@mindees/atlas 0.13.0 → 0.14.0

package/README.md

@@ -6,10 +6,13 @@ The Atlas component library — MindeesNative's batteries-included UI primitives
 > separate, pre-existing React Native + Expo UI kit on npm. Atlas is this
 > framework's own component library.
 
-> Status: 🧪 **Experimental** — Phase 12A/12B are implemented and tested:
-> accessible, signals-native UI primitives, a structural theme subpath, and a
-> virtualized recycling `List`. Web rendering is real through the Helix DOM backend;
-> native Atlas rendering is still tied to the broader native app bridge research track.
+> Status: 🧪 **Experimental** (pre-1.0) — v0.13.0. A 27+ component library plus 12+
+> hooks: accessible, signals-native UI primitives, design-token theming with dark
+> mode, a full-screen portal/overlay layer, a virtualized recycling `List`, a
+> gesture system, an animation engine, and an animated stack navigator over the
+> Quantum router. Web rendering is real through the Helix DOM backend; the **same**
+> serializable tree now renders + is interactive on a real Android emulator
+> (QuickJS bridge) and a real iOS simulator (JavaScriptCore bridge), all CI-verified.
 > See the repository [STATUS.md](../../STATUS.md).
 
 ## What works today
@@ -17,17 +20,39 @@ The Atlas component library — MindeesNative's batteries-included UI primitives
 - **Primitives** — `View`, `Text`, `Image`, `TextInput`, `Pressable`, `Button`,
   `Stack`, `Row`, `Column`, `Spacer`, and `ScrollView` return renderer-agnostic
   `MindeesNode` trees over `@mindees/core` `createElement`.
+- **Components (27+)** — beyond the primitives: `Card`, `Switch`, `Badge`, `Avatar`,
+  `Chip`, `Divider`, `ProgressBar`, `ActivityIndicator`, `SafeAreaView`,
+  `KeyboardAvoidingView`, `Checkbox`, `RadioGroup`, `Skeleton`, `Tabs`, `Accordion`,
+  `Stepper`, and `SegmentedControl` — all accessible and signals-native.
+- **Overlays** — `@mindees/atlas` exports `Modal`, `Toast`, and `FocusScope`; these
+  render into a full-screen portal layer that overlaps the app (web today; the native
+  hosts have a matching overlay layer).
+- **Hooks (12+)** — state/effect hooks `useToggle`, `useCounter`, `usePrevious`,
+  `useReducer`, `useAsync`, `usePersistentSignal`, `useDebounce`, `useInterval`,
+  `useTimeout`, plus `useForm` and the device hooks `useWindowDimensions`,
+  `useColorScheme`, `useSafeAreaInsets`, and `useKeyboard` (RN-parity environment).
 - **Styling** — `StyleObject`, `StyleInput`, and `flattenStyle` normalize a curated
   cross-platform style subset; numeric web styles lower to `px` through the renderer.
 - **Accessibility** — typed `role` / `aria-*` helpers lower into host props, and
   `Image` requires a `label` unless explicitly marked decorative.
 - **Interaction** — `Pressable` and `usePressable` use real DOM events on web
   (`click`, pointer, focus, Enter, Space), with reactive hover/press/focus state.
-- **Theme** — `@mindees/atlas/theme` exports `ThemeTokens`, `defaultTokens`, and
-  `createTheme()`; token selection uses `@mindees/core` selector isolation.
+- **Gestures + motion** — `GestureView` attaches pan/press gestures; `motion` /
+  `animateTo` drive spring/interpolated animations on the same scene.
+- **Theming** — design tokens in two tiers: primitive scales (`space`, `radius`,
+  `fontSize`, `palette`, …) and semantic `tokens`/`Theme` (`bg`/`surface`/`text`/
+  `primary`/…). `useTheme` returns a reactive theme driven by `useColorScheme`, so
+  **dark mode** is a fine-grained token-set swap — only the color nodes update. The
+  `@mindees/atlas/theme` subpath additionally exports a structural `createTheme()`
+  with `@mindees/core` selector isolation.
 - **List** — `@mindees/atlas/list` exports `List`, `createList`, and `computeWindow`.
   It renders a fixed pool of recycled row regions for fixed-height virtualization;
   variable-height measurement is a 🔬 research track.
+- **Keyed iteration** — `@mindees/atlas/for` exports `For`, a keyed region for
+  efficient list reconciliation (reused/disposed by key).
+- **Stack navigator** — `@mindees/atlas/stack` exports `createStackNavigator`, an
+  animated stack over the Quantum router: push slides/fades a screen in, an edge
+  swipe-back gesture drives the pop interactively, and surviving screens keep state.
 
 ## Quick start
 
@@ -42,7 +67,7 @@ const primary = theme.select((tokens) => tokens.colors.primary)
 export const Screen = Column({
   gap: 12,
   children: [
-    Text({ children: 'Atlas works on the Helix DOM backend today.' }),
+    Text({ children: 'One Atlas tree — web, Android, and iOS.' }),
     Button({ title: 'Save', style: () => ({ backgroundColor: primary(), padding: 12 }) }),
     List({
       items: ['One', 'Two', 'Three'],

package/dist/index.d.ts

@@ -16,7 +16,7 @@ import { Maturity, NotImplementedError, PackageInfo, notImplemented } from "@min
 /** The npm package name. */
 declare const name = "@mindees/atlas";
 /** The package version. All `@mindees/*` packages share one locked version line. */
-declare const VERSION = "0.13.0";
+declare const VERSION = "0.14.0";
 /** Current maturity of this package. See the repository `STATUS.md`. */
 declare const maturity: Maturity;
 /**

package/dist/index.js

@@ -15,7 +15,7 @@ import { NotImplementedError, notImplemented } from "@mindees/core";
 /** The npm package name. */
 const name = "@mindees/atlas";
 /** The package version. All `@mindees/*` packages share one locked version line. */
-const VERSION = "0.13.0";
+const VERSION = "0.14.0";
 /** Current maturity of this package. See the repository `STATUS.md`. */
 const maturity = "experimental";
 /**

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["/**\n * `@mindees/atlas` (Atlas) — accessible, signals-native UI primitives. Function components\n * over `@mindees/core`'s `createElement` that return renderer-agnostic `MindeesNode` trees:\n * web rendering is real via the Helix DOM backend; native is a labeled 🔬 research track (the\n * same serializable tree, interpreted by a native host later). A curated cross-platform\n * `StyleObject`, typed accessibility, and a structural theme (on the `@mindees/atlas/theme`\n * subpath). The virtualized recycling `List` is on the `@mindees/atlas/list` subpath.\n *\n * @module\n */\n\nimport type { Maturity, PackageInfo } from '@mindees/core'\nimport { NotImplementedError, notImplemented } from '@mindees/core'\n\n/** The npm package name. */\nexport const name = '@mindees/atlas'\n\n/** The package version. All `@mindees/*` packages share one locked version line. */\nexport const VERSION = '0.13.0'\n\n/** Current maturity of this package. See the repository `STATUS.md`. */\nexport const maturity: Maturity = 'experimental'\n\n/**\n * Static identity + maturity metadata for this package. Frozen so the\n * self-reported identity tooling introspects cannot be mutated at runtime,\n * matching the `readonly` fields of {@link PackageInfo}.\n */\nexport const info: PackageInfo = Object.freeze({ name, version: VERSION, maturity })\n\nexport { type A11yProps, type A11yState, type Role, toA11yProps } from './a11y'\nexport {\n  Accordion,\n  type AccordionProps,\n  type AccordionSection,\n  ActivityIndicator,\n  type ActivityIndicatorProps,\n  Avatar,\n  type AvatarProps,\n  Badge,\n  type BadgeProps,\n  Card,\n  type CardProps,\n  Checkbox,\n  type CheckboxProps,\n  Chip,\n  type ChipProps,\n  Divider,\n  type DividerProps,\n  KeyboardAvoidingView,\n  type KeyboardAvoidingViewProps,\n  ProgressBar,\n  type ProgressBarProps,\n  RadioGroup,\n  type RadioGroupProps,\n  type RadioOption,\n  SafeAreaView,\n  type SafeAreaViewProps,\n  type Segment,\n  SegmentedControl,\n  type SegmentedControlProps,\n  Skeleton,\n  type SkeletonProps,\n  Stepper,\n  type StepperProps,\n  Switch,\n  type SwitchProps,\n  type TabItem,\n  Tabs,\n  type TabsProps,\n} from './components'\nexport {\n  type ColorScheme,\n  getEnvironment,\n  type KeyboardState,\n  type PlatformEnvironment,\n  type SafeAreaInsets,\n  setEnvironment,\n  useColorScheme,\n  useKeyboard,\n  useSafeAreaInsets,\n  useWindowDimensions,\n  type WindowDimensions,\n} from './environment'\nexport { type Field, type FormApi, type UseFormOptions, useForm } from './form'\nexport { type AttachableGesture, GestureView, type GestureViewProps } from './gesture'\nexport {\n  type AsyncState,\n  type Counter,\n  type PersistentSignalOptions,\n  type SignalStorage,\n  type Toggle,\n  useAsync,\n  useCounter,\n  useDebounce,\n  useInterval,\n  usePersistentSignal,\n  usePrevious,\n  useReducer,\n  useTimeout,\n  useToggle,\n} from './hooks'\nexport { type BaseProps, type Reactive, resolveStyle, toHostProps } from './host'\nexport { animateTo, motion } from './motion'\nexport {\n  FocusScope,\n  type FocusScopeProps,\n  Modal,\n  type ModalProps,\n  Toast,\n  type ToastProps,\n} from './overlay'\nexport {\n  Button,\n  type ButtonProps,\n  Column,\n  Image,\n  type ImageProps,\n  type InteractionState,\n  Pressable,\n  type PressableProps,\n  Row,\n  ScrollView,\n  type ScrollViewProps,\n  Spacer,\n  type SpacerProps,\n  Stack,\n  type StackProps,\n  Text,\n  TextInput,\n  type TextInputProps,\n  type TextProps,\n  usePressable,\n  View,\n  type ViewProps,\n} from './primitives'\nexport { flattenStyle, type StyleInput, type StyleObject, type StyleValue } from './style'\nexport {\n  duration,\n  easing,\n  fontSize,\n  fontWeight,\n  getTheme,\n  lineHeight,\n  palette,\n  radius,\n  space,\n  type Theme,\n  type ThemeColors,\n  tokens,\n  useTheme,\n} from './tokens'\nexport type { Maturity, PackageInfo }\nexport { NotImplementedError, notImplemented }\n"],"mappings":";;;;;;;;;;;;;;;AAeA,MAAa,OAAO;;AAGpB,MAAa,UAAU;;AAGvB,MAAa,WAAqB;;;;;;AAOlC,MAAa,OAAoB,OAAO,OAAO;CAAE;CAAM,SAAS;CAAS;AAAS,CAAC"}
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["/**\n * `@mindees/atlas` (Atlas) — accessible, signals-native UI primitives. Function components\n * over `@mindees/core`'s `createElement` that return renderer-agnostic `MindeesNode` trees:\n * web rendering is real via the Helix DOM backend; native is a labeled 🔬 research track (the\n * same serializable tree, interpreted by a native host later). A curated cross-platform\n * `StyleObject`, typed accessibility, and a structural theme (on the `@mindees/atlas/theme`\n * subpath). The virtualized recycling `List` is on the `@mindees/atlas/list` subpath.\n *\n * @module\n */\n\nimport type { Maturity, PackageInfo } from '@mindees/core'\nimport { NotImplementedError, notImplemented } from '@mindees/core'\n\n/** The npm package name. */\nexport const name = '@mindees/atlas'\n\n/** The package version. All `@mindees/*` packages share one locked version line. */\nexport const VERSION = '0.14.0'\n\n/** Current maturity of this package. See the repository `STATUS.md`. */\nexport const maturity: Maturity = 'experimental'\n\n/**\n * Static identity + maturity metadata for this package. Frozen so the\n * self-reported identity tooling introspects cannot be mutated at runtime,\n * matching the `readonly` fields of {@link PackageInfo}.\n */\nexport const info: PackageInfo = Object.freeze({ name, version: VERSION, maturity })\n\nexport { type A11yProps, type A11yState, type Role, toA11yProps } from './a11y'\nexport {\n  Accordion,\n  type AccordionProps,\n  type AccordionSection,\n  ActivityIndicator,\n  type ActivityIndicatorProps,\n  Avatar,\n  type AvatarProps,\n  Badge,\n  type BadgeProps,\n  Card,\n  type CardProps,\n  Checkbox,\n  type CheckboxProps,\n  Chip,\n  type ChipProps,\n  Divider,\n  type DividerProps,\n  KeyboardAvoidingView,\n  type KeyboardAvoidingViewProps,\n  ProgressBar,\n  type ProgressBarProps,\n  RadioGroup,\n  type RadioGroupProps,\n  type RadioOption,\n  SafeAreaView,\n  type SafeAreaViewProps,\n  type Segment,\n  SegmentedControl,\n  type SegmentedControlProps,\n  Skeleton,\n  type SkeletonProps,\n  Stepper,\n  type StepperProps,\n  Switch,\n  type SwitchProps,\n  type TabItem,\n  Tabs,\n  type TabsProps,\n} from './components'\nexport {\n  type ColorScheme,\n  getEnvironment,\n  type KeyboardState,\n  type PlatformEnvironment,\n  type SafeAreaInsets,\n  setEnvironment,\n  useColorScheme,\n  useKeyboard,\n  useSafeAreaInsets,\n  useWindowDimensions,\n  type WindowDimensions,\n} from './environment'\nexport { type Field, type FormApi, type UseFormOptions, useForm } from './form'\nexport { type AttachableGesture, GestureView, type GestureViewProps } from './gesture'\nexport {\n  type AsyncState,\n  type Counter,\n  type PersistentSignalOptions,\n  type SignalStorage,\n  type Toggle,\n  useAsync,\n  useCounter,\n  useDebounce,\n  useInterval,\n  usePersistentSignal,\n  usePrevious,\n  useReducer,\n  useTimeout,\n  useToggle,\n} from './hooks'\nexport { type BaseProps, type Reactive, resolveStyle, toHostProps } from './host'\nexport { animateTo, motion } from './motion'\nexport {\n  FocusScope,\n  type FocusScopeProps,\n  Modal,\n  type ModalProps,\n  Toast,\n  type ToastProps,\n} from './overlay'\nexport {\n  Button,\n  type ButtonProps,\n  Column,\n  Image,\n  type ImageProps,\n  type InteractionState,\n  Pressable,\n  type PressableProps,\n  Row,\n  ScrollView,\n  type ScrollViewProps,\n  Spacer,\n  type SpacerProps,\n  Stack,\n  type StackProps,\n  Text,\n  TextInput,\n  type TextInputProps,\n  type TextProps,\n  usePressable,\n  View,\n  type ViewProps,\n} from './primitives'\nexport { flattenStyle, type StyleInput, type StyleObject, type StyleValue } from './style'\nexport {\n  duration,\n  easing,\n  fontSize,\n  fontWeight,\n  getTheme,\n  lineHeight,\n  palette,\n  radius,\n  space,\n  type Theme,\n  type ThemeColors,\n  tokens,\n  useTheme,\n} from './tokens'\nexport type { Maturity, PackageInfo }\nexport { NotImplementedError, notImplemented }\n"],"mappings":";;;;;;;;;;;;;;;AAeA,MAAa,OAAO;;AAGpB,MAAa,UAAU;;AAGvB,MAAa,WAAqB;;;;;;AAOlC,MAAa,OAAoB,OAAO,OAAO;CAAE;CAAM,SAAS;CAAS;AAAS,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mindees/atlas",
-  "version": "0.13.0",
+  "version": "0.14.0",
   "description": "MindeesNative Atlas - accessible, signals-native UI primitives + a virtualized recycling list. Renderer-agnostic (web real, native research track).",
   "license": "MIT OR Apache-2.0",
   "type": "module",
@@ -39,12 +39,12 @@
     "directory": "packages/atlas"
   },
   "dependencies": {
-    "@mindees/core": "0.13.0",
-    "@mindees/router": "0.13.0"
+    "@mindees/core": "0.14.0",
+    "@mindees/router": "0.14.0"
   },
   "devDependencies": {
     "happy-dom": "20.9.0",
-    "@mindees/renderer": "0.13.0"
+    "@mindees/renderer": "0.14.0"
   },
   "scripts": {
     "build": "tsdown",