@mindees/atlas 0.15.0 → 0.17.0

package/dist/error-boundary.d.ts

@@ -0,0 +1,15 @@
+import { MindeesNode } from "@mindees/core";
+
+//#region src/error-boundary.d.ts
+/** Props for {@link ErrorBoundary}. */
+interface ErrorBoundaryProps {
+  /** Rendered when `children` throws. `reset` re-runs `children` (retry). */
+  readonly fallback: (error: unknown, reset: () => void) => MindeesNode;
+  /** The guarded subtree, as a thunk so it's evaluated (and re-evaluated) inside the boundary. */
+  readonly children: () => MindeesNode;
+}
+/** Render `children`; if it throws, render `fallback(error, reset)` instead. Returns a reactive region. */
+declare function ErrorBoundary(props: ErrorBoundaryProps): () => MindeesNode;
+//#endregion
+export { ErrorBoundary, ErrorBoundaryProps };
+//# sourceMappingURL=error-boundary.d.ts.map

package/dist/error-boundary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-boundary.d.ts","names":[],"sources":["../src/error-boundary.ts"],"mappings":";;;;UAuBiB,kBAAA;EAQ0D;EAAA,SANhE,QAAA,GAAW,KAAA,WAAgB,KAAA,iBAAsB,WAAA;;WAEjD,QAAA,QAAgB,WAAW;AAAA;;iBAItB,aAAA,CAAc,KAAA,EAAO,kBAAA,SAA2B,WAAW"}

package/dist/error-boundary.js

@@ -0,0 +1,40 @@
+import { signal, untrack } from "@mindees/core";
+//#region src/error-boundary.ts
+/**
+* Atlas `ErrorBoundary` — catch errors thrown while rendering a subtree and show a fallback instead of
+* letting the whole app fail (RN/React's `<ErrorBoundary>`, signals-native). The children are a thunk
+* evaluated inside a **reactive region**: if it throws, the region renders `fallback(error, reset)`;
+* `reset()` re-runs the children (retry after the cause is fixed), and any signal the children read
+* before throwing also re-runs the region automatically when it changes.
+*
+* Scope: this catches **synchronous render-time** errors (a component throwing while building its
+* view). Errors thrown later inside an `effect` run on their own and are not routed here — handle
+* those where the effect lives.
+*
+* @example
+* ErrorBoundary({
+*   fallback: (err, reset) => <Button title="Retry" onPress={reset} />,
+*   children: () => <RiskyScreen />,
+* })
+*
+* @module
+*/
+/** Render `children`; if it throws, render `fallback(error, reset)` instead. Returns a reactive region. */
+function ErrorBoundary(props) {
+	const resetKey = signal(0);
+	const reset = () => {
+		resetKey.set(untrack(resetKey) + 1);
+	};
+	return () => {
+		resetKey();
+		try {
+			return props.children();
+		} catch (error) {
+			return props.fallback(error, reset);
+		}
+	};
+}
+//#endregion
+export { ErrorBoundary };
+
+//# sourceMappingURL=error-boundary.js.map

package/dist/error-boundary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-boundary.js","names":[],"sources":["../src/error-boundary.ts"],"sourcesContent":["/**\n * Atlas `ErrorBoundary` — catch errors thrown while rendering a subtree and show a fallback instead of\n * letting the whole app fail (RN/React's `<ErrorBoundary>`, signals-native). The children are a thunk\n * evaluated inside a **reactive region**: if it throws, the region renders `fallback(error, reset)`;\n * `reset()` re-runs the children (retry after the cause is fixed), and any signal the children read\n * before throwing also re-runs the region automatically when it changes.\n *\n * Scope: this catches **synchronous render-time** errors (a component throwing while building its\n * view). Errors thrown later inside an `effect` run on their own and are not routed here — handle\n * those where the effect lives.\n *\n * @example\n * ErrorBoundary({\n *   fallback: (err, reset) => <Button title=\"Retry\" onPress={reset} />,\n *   children: () => <RiskyScreen />,\n * })\n *\n * @module\n */\n\nimport { type MindeesNode, signal, untrack } from '@mindees/core'\n\n/** Props for {@link ErrorBoundary}. */\nexport interface ErrorBoundaryProps {\n  /** Rendered when `children` throws. `reset` re-runs `children` (retry). */\n  readonly fallback: (error: unknown, reset: () => void) => MindeesNode\n  /** The guarded subtree, as a thunk so it's evaluated (and re-evaluated) inside the boundary. */\n  readonly children: () => MindeesNode\n}\n\n/** Render `children`; if it throws, render `fallback(error, reset)` instead. Returns a reactive region. */\nexport function ErrorBoundary(props: ErrorBoundaryProps): () => MindeesNode {\n  const resetKey = signal(0)\n  const reset = (): void => {\n    resetKey.set(untrack(resetKey) + 1)\n  }\n  return () => {\n    resetKey() // track: reset() (and tracked children deps) re-run this region, retrying\n    try {\n      return props.children()\n    } catch (error) {\n      return props.fallback(error, reset)\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AA+BA,SAAgB,cAAc,OAA8C;CAC1E,MAAM,WAAW,OAAO,CAAC;CACzB,MAAM,cAAoB;EACxB,SAAS,IAAI,QAAQ,QAAQ,IAAI,CAAC;CACpC;CACA,aAAa;EACX,SAAS;EACT,IAAI;GACF,OAAO,MAAM,SAAS;EACxB,SAAS,OAAO;GACd,OAAO,MAAM,SAAS,OAAO,KAAK;EACpC;CACF;AACF"}

package/dist/index.d.ts

@@ -3,6 +3,7 @@ import { StyleInput, StyleObject, StyleValue, flattenStyle } from "./style.js";
 import { BaseProps, Reactive, resolveStyle, toHostProps } from "./host.js";
 import { Accordion, AccordionProps, AccordionSection, ActivityIndicator, ActivityIndicatorProps, Avatar, AvatarProps, Badge, BadgeProps, Card, CardProps, Checkbox, CheckboxProps, Chip, ChipProps, Divider, DividerProps, KeyboardAvoidingView, KeyboardAvoidingViewProps, ProgressBar, ProgressBarProps, RadioGroup, RadioGroupProps, RadioOption, SafeAreaView, SafeAreaViewProps, Segment, SegmentedControl, SegmentedControlProps, Skeleton, SkeletonProps, Stepper, StepperProps, Switch, SwitchProps, TabItem, Tabs, TabsProps } from "./components.js";
 import { ColorScheme, KeyboardState, PlatformEnvironment, SafeAreaInsets, WindowDimensions, getEnvironment, setEnvironment, useColorScheme, useKeyboard, useReducedMotion, useSafeAreaInsets, useWindowDimensions } from "./environment.js";
+import { ErrorBoundary, ErrorBoundaryProps } from "./error-boundary.js";
 import { Field, FormApi, UseFormOptions, useForm } from "./form.js";
 import { AttachableGesture, GestureView, GestureViewProps } from "./gesture.js";
 import { AsyncState, Counter, PersistentSignalOptions, SignalStorage, Toggle, useAsync, useCounter, useDebounce, useInterval, usePersistentSignal, usePrevious, useReducer, useTimeout, useToggle } from "./hooks.js";
@@ -10,13 +11,14 @@ import { Theme, ThemeColors, duration, easing, fontSize, fontWeight, getTheme, l
 import { animateTo, motion } from "./motion.js";
 import { FocusScope, FocusScopeProps, Modal, ModalProps, Toast, ToastProps } from "./overlay.js";
 import { Button, ButtonProps, Column, Image, ImageProps, InteractionState, Pressable, PressableProps, Row, ScrollView, ScrollViewProps, Spacer, SpacerProps, Stack, StackProps, Text, TextInput, TextInputProps, TextProps, View, ViewProps, usePressable } from "./primitives.js";
+import { Show, ShowProps } from "./show.js";
 import { Maturity, NotImplementedError, PackageInfo, notImplemented } from "@mindees/core";
 
 //#region src/index.d.ts
 /** The npm package name. */
 declare const name = "@mindees/atlas";
 /** The package version. All `@mindees/*` packages share one locked version line. */
-declare const VERSION = "0.15.0";
+declare const VERSION = "0.17.0";
 /** Current maturity of this package. See the repository `STATUS.md`. */
 declare const maturity: Maturity;
 /**
@@ -26,5 +28,5 @@ declare const maturity: Maturity;
  */
 declare const info: PackageInfo;
 //#endregion
-export { type A11yProps, type A11yState, Accordion, type AccordionProps, type AccordionSection, ActivityIndicator, type ActivityIndicatorProps, type AsyncState, type AttachableGesture, Avatar, type AvatarProps, Badge, type BadgeProps, type BaseProps, Button, type ButtonProps, Card, type CardProps, Checkbox, type CheckboxProps, Chip, type ChipProps, type ColorScheme, Column, type Counter, Divider, type DividerProps, type Field, FocusScope, type FocusScopeProps, type FormApi, GestureView, type GestureViewProps, Image, type ImageProps, type InteractionState, KeyboardAvoidingView, type KeyboardAvoidingViewProps, type KeyboardState, type Maturity, Modal, type ModalProps, NotImplementedError, type PackageInfo, type PersistentSignalOptions, type PlatformEnvironment, Pressable, type PressableProps, ProgressBar, type ProgressBarProps, RadioGroup, type RadioGroupProps, type RadioOption, type Reactive, type Role, Row, type SafeAreaInsets, SafeAreaView, type SafeAreaViewProps, ScrollView, type ScrollViewProps, type Segment, SegmentedControl, type SegmentedControlProps, type SignalStorage, Skeleton, type SkeletonProps, Spacer, type SpacerProps, Stack, type StackProps, Stepper, type StepperProps, type StyleInput, type StyleObject, type StyleValue, Switch, type SwitchProps, type TabItem, Tabs, type TabsProps, Text, TextInput, type TextInputProps, type TextProps, type Theme, type ThemeColors, Toast, type ToastProps, type Toggle, type UseFormOptions, VERSION, View, type ViewProps, type WindowDimensions, animateTo, duration, easing, flattenStyle, fontSize, fontWeight, getEnvironment, getTheme, info, lineHeight, maturity, motion, name, notImplemented, palette, radius, resolveStyle, setEnvironment, space, toA11yProps, toHostProps, tokens, useAsync, useColorScheme, useCounter, useDebounce, useForm, useInterval, useKeyboard, usePersistentSignal, usePressable, usePrevious, useReducedMotion, useReducer, useSafeAreaInsets, useTheme, useTimeout, useToggle, useWindowDimensions };
+export { type A11yProps, type A11yState, Accordion, type AccordionProps, type AccordionSection, ActivityIndicator, type ActivityIndicatorProps, type AsyncState, type AttachableGesture, Avatar, type AvatarProps, Badge, type BadgeProps, type BaseProps, Button, type ButtonProps, Card, type CardProps, Checkbox, type CheckboxProps, Chip, type ChipProps, type ColorScheme, Column, type Counter, Divider, type DividerProps, ErrorBoundary, type ErrorBoundaryProps, type Field, FocusScope, type FocusScopeProps, type FormApi, GestureView, type GestureViewProps, Image, type ImageProps, type InteractionState, KeyboardAvoidingView, type KeyboardAvoidingViewProps, type KeyboardState, type Maturity, Modal, type ModalProps, NotImplementedError, type PackageInfo, type PersistentSignalOptions, type PlatformEnvironment, Pressable, type PressableProps, ProgressBar, type ProgressBarProps, RadioGroup, type RadioGroupProps, type RadioOption, type Reactive, type Role, Row, type SafeAreaInsets, SafeAreaView, type SafeAreaViewProps, ScrollView, type ScrollViewProps, type Segment, SegmentedControl, type SegmentedControlProps, Show, type ShowProps, type SignalStorage, Skeleton, type SkeletonProps, Spacer, type SpacerProps, Stack, type StackProps, Stepper, type StepperProps, type StyleInput, type StyleObject, type StyleValue, Switch, type SwitchProps, type TabItem, Tabs, type TabsProps, Text, TextInput, type TextInputProps, type TextProps, type Theme, type ThemeColors, Toast, type ToastProps, type Toggle, type UseFormOptions, VERSION, View, type ViewProps, type WindowDimensions, animateTo, duration, easing, flattenStyle, fontSize, fontWeight, getEnvironment, getTheme, info, lineHeight, maturity, motion, name, notImplemented, palette, radius, resolveStyle, setEnvironment, space, toA11yProps, toHostProps, tokens, useAsync, useColorScheme, useCounter, useDebounce, useForm, useInterval, useKeyboard, usePersistentSignal, usePressable, usePrevious, useReducedMotion, useReducer, useSafeAreaInsets, useTheme, useTimeout, useToggle, useWindowDimensions };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"mappings":";;;;;;;;;;;;;;;;cAea,IAAA;;cAGA,OAAA;;cAGA,QAAA,EAAU,QAAyB;;AAN/B;AAGjB;;;cAUa,IAAA,EAAM,WAAiE"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"mappings":";;;;;;;;;;;;;;;;;;cAea,IAAA;;cAGA,OAAA;;cAGA,QAAA,EAAU,QAAyB;;;;AAN/B;AAGjB;cAUa,IAAA,EAAM,WAAiE"}

package/dist/index.js

@@ -5,17 +5,19 @@ import { resolveStyle, toHostProps } from "./host.js";
 import { Button, Column, Image, Pressable, Row, ScrollView, Spacer, Stack, Text, TextInput, View, usePressable } from "./primitives.js";
 import { duration, easing, fontSize, fontWeight, getTheme, lineHeight, palette, radius, space, tokens, useTheme } from "./tokens.js";
 import { Accordion, ActivityIndicator, Avatar, Badge, Card, Checkbox, Chip, Divider, KeyboardAvoidingView, ProgressBar, RadioGroup, SafeAreaView, SegmentedControl, Skeleton, Stepper, Switch, Tabs } from "./components.js";
+import { ErrorBoundary } from "./error-boundary.js";
 import { useForm } from "./form.js";
 import { GestureView } from "./gesture.js";
 import { useAsync, useCounter, useDebounce, useInterval, usePersistentSignal, usePrevious, useReducer, useTimeout, useToggle } from "./hooks.js";
 import { animateTo, motion } from "./motion.js";
 import { FocusScope, Modal, Toast } from "./overlay.js";
+import { Show } from "./show.js";
 import { NotImplementedError, notImplemented } from "@mindees/core";
 //#region src/index.ts
 /** The npm package name. */
 const name = "@mindees/atlas";
 /** The package version. All `@mindees/*` packages share one locked version line. */
-const VERSION = "0.15.0";
+const VERSION = "0.17.0";
 /** Current maturity of this package. See the repository `STATUS.md`. */
 const maturity = "experimental";
 /**
@@ -29,6 +31,6 @@ const info = Object.freeze({
 	maturity
 });
 //#endregion
-export { Accordion, ActivityIndicator, Avatar, Badge, Button, Card, Checkbox, Chip, Column, Divider, FocusScope, GestureView, Image, KeyboardAvoidingView, Modal, NotImplementedError, Pressable, ProgressBar, RadioGroup, Row, SafeAreaView, ScrollView, SegmentedControl, Skeleton, Spacer, Stack, Stepper, Switch, Tabs, Text, TextInput, Toast, VERSION, View, animateTo, duration, easing, flattenStyle, fontSize, fontWeight, getEnvironment, getTheme, info, lineHeight, maturity, motion, name, notImplemented, palette, radius, resolveStyle, setEnvironment, space, toA11yProps, toHostProps, tokens, useAsync, useColorScheme, useCounter, useDebounce, useForm, useInterval, useKeyboard, usePersistentSignal, usePressable, usePrevious, useReducedMotion, useReducer, useSafeAreaInsets, useTheme, useTimeout, useToggle, useWindowDimensions };
+export { Accordion, ActivityIndicator, Avatar, Badge, Button, Card, Checkbox, Chip, Column, Divider, ErrorBoundary, FocusScope, GestureView, Image, KeyboardAvoidingView, Modal, NotImplementedError, Pressable, ProgressBar, RadioGroup, Row, SafeAreaView, ScrollView, SegmentedControl, Show, Skeleton, Spacer, Stack, Stepper, Switch, Tabs, Text, TextInput, Toast, VERSION, View, animateTo, duration, easing, flattenStyle, fontSize, fontWeight, getEnvironment, getTheme, info, lineHeight, maturity, motion, name, notImplemented, palette, radius, resolveStyle, setEnvironment, space, toA11yProps, toHostProps, tokens, useAsync, useColorScheme, useCounter, useDebounce, useForm, useInterval, useKeyboard, usePersistentSignal, usePressable, usePrevious, useReducedMotion, useReducer, useSafeAreaInsets, useTheme, useTimeout, useToggle, useWindowDimensions };
 
 //# sourceMappingURL=index.js.map

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.15.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  useReducedMotion,\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.17.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  useReducedMotion,\n  useSafeAreaInsets,\n  useWindowDimensions,\n  type WindowDimensions,\n} from './environment'\nexport { ErrorBoundary, type ErrorBoundaryProps } from './error-boundary'\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 { Show, type ShowProps } from './show'\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/dist/show.d.ts

@@ -0,0 +1,19 @@
+import { MindeesNode } from "@mindees/core";
+
+//#region src/show.d.ts
+/** A falsy condition value that hides the children. */
+type Falsy = false | null | undefined | 0 | '';
+/** Props for {@link Show}. */
+interface ShowProps<T> {
+  /** The condition: a value or an accessor. Children render when it's truthy. */
+  readonly when: T | (() => T);
+  /** Rendered when `when` is falsy. */
+  readonly fallback?: () => MindeesNode;
+  /** Rendered when `when` is truthy; a function receives the narrowed truthy value. */
+  readonly children: MindeesNode | ((value: Exclude<T, Falsy>) => MindeesNode);
+}
+/** Render `children` when `when` is truthy, else `fallback`. Returns a reactive region. */
+declare function Show<T>(props: ShowProps<T>): () => MindeesNode;
+//#endregion
+export { Show, ShowProps };
+//# sourceMappingURL=show.d.ts.map

package/dist/show.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"show.d.ts","names":[],"sources":["../src/show.ts"],"mappings":";;;;KAkBK,KAAA;;UAGY,SAAA;EAM4D;EAAA,SAJlE,IAAA,EAAM,CAAA,UAAW,CAAA;EAFD;EAAA,SAIhB,QAAA,SAAiB,WAAA;EAFX;EAAA,SAIN,QAAA,EAAU,WAAA,KAAgB,KAAA,EAAO,OAAA,CAAQ,CAAA,EAAG,KAAA,MAAW,WAAA;AAAA;;iBAIlD,IAAA,IAAQ,KAAA,EAAO,SAAA,CAAU,CAAA,UAAW,WAAA"}

package/dist/show.js

@@ -0,0 +1,14 @@
+//#region src/show.ts
+/** Render `children` when `when` is truthy, else `fallback`. Returns a reactive region. */
+function Show(props) {
+	const cond = typeof props.when === "function" ? props.when : () => props.when;
+	return () => {
+		const value = cond();
+		if (value) return typeof props.children === "function" ? props.children(value) : props.children;
+		return props.fallback ? props.fallback() : null;
+	};
+}
+//#endregion
+export { Show };
+
+//# sourceMappingURL=show.js.map

package/dist/show.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"show.js","names":[],"sources":["../src/show.ts"],"sourcesContent":["/**\n * Atlas `Show` — the ergonomic conditional. Renders `children` when `when` is truthy, else `fallback`.\n * `when` is a value or accessor; when it's an accessor the result is a **reactive region** that swaps\n * content as the condition flips. `children` may be a function that receives the **narrowed** truthy\n * value (so you don't re-check for null inside).\n *\n * You can always write `() => cond() ? a() : b()` by hand — `Show` is the readable, fallback-aware,\n * narrowing version of exactly that (Solid/Vue ship the same battery).\n *\n * @example\n * Show({ when: () => user(), fallback: () => <Spinner/>, children: (u) => <Text>{() => u.name}</Text> })\n *\n * @module\n */\n\nimport type { MindeesNode } from '@mindees/core'\n\n/** A falsy condition value that hides the children. */\ntype Falsy = false | null | undefined | 0 | ''\n\n/** Props for {@link Show}. */\nexport interface ShowProps<T> {\n  /** The condition: a value or an accessor. Children render when it's truthy. */\n  readonly when: T | (() => T)\n  /** Rendered when `when` is falsy. */\n  readonly fallback?: () => MindeesNode\n  /** Rendered when `when` is truthy; a function receives the narrowed truthy value. */\n  readonly children: MindeesNode | ((value: Exclude<T, Falsy>) => MindeesNode)\n}\n\n/** Render `children` when `when` is truthy, else `fallback`. Returns a reactive region. */\nexport function Show<T>(props: ShowProps<T>): () => MindeesNode {\n  const cond = typeof props.when === 'function' ? (props.when as () => T) : () => props.when\n  return () => {\n    const value = cond()\n    if (value) {\n      return typeof props.children === 'function'\n        ? (props.children as (value: Exclude<T, Falsy>) => MindeesNode)(value as Exclude<T, Falsy>)\n        : props.children\n    }\n    return props.fallback ? props.fallback() : null\n  }\n}\n"],"mappings":";;AA+BA,SAAgB,KAAQ,OAAwC;CAC9D,MAAM,OAAO,OAAO,MAAM,SAAS,aAAc,MAAM,aAAyB,MAAM;CACtF,aAAa;EACX,MAAM,QAAQ,KAAK;EACnB,IAAI,OACF,OAAO,OAAO,MAAM,aAAa,aAC5B,MAAM,SAAuD,KAA0B,IACxF,MAAM;EAEZ,OAAO,MAAM,WAAW,MAAM,SAAS,IAAI;CAC7C;AACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mindees/atlas",
-  "version": "0.15.0",
+  "version": "0.17.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.15.0",
-    "@mindees/router": "0.15.0"
+    "@mindees/core": "0.17.0",
+    "@mindees/router": "0.17.0"
   },
   "devDependencies": {
     "happy-dom": "20.9.0",
-    "@mindees/renderer": "0.15.0"
+    "@mindees/renderer": "0.17.0"
   },
   "scripts": {
     "build": "tsdown",