@mindees/atlas 0.25.0 → 0.26.0

package/dist/index.d.ts

@@ -12,13 +12,14 @@ 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 { WebEnvWindow, connectWebEnvironment } from "./web-environment.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.25.0";
+declare const VERSION = "0.26.0";
 /** Current maturity of this package. See the repository `STATUS.md`. */
 declare const maturity: Maturity;
 /**
@@ -28,5 +29,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, 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 };
+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 WebEnvWindow, type WindowDimensions, animateTo, connectWebEnvironment, 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;AANhD;;;;AAAiB;AAAjB,cAaa,IAAA,EAAM,WAAiE"}

package/dist/index.js

@@ -12,12 +12,13 @@ import { useAsync, useCounter, useDebounce, useInterval, usePersistentSignal, us
 import { animateTo, motion } from "./motion.js";
 import { FocusScope, Modal, Toast } from "./overlay.js";
 import { Show } from "./show.js";
+import { connectWebEnvironment } from "./web-environment.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.25.0";
+const VERSION = "0.26.0";
 /** Current maturity of this package. See the repository `STATUS.md`. */
 const maturity = "experimental";
 /**
@@ -31,6 +32,6 @@ const info = Object.freeze({
 	maturity
 });
 //#endregion
-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 };
+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, connectWebEnvironment, 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 design-token theming (`useTheme`/`tokens`, on the main entry).\n * 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.25.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"}
+{"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 design-token theming (`useTheme`/`tokens`, on the main entry).\n * 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.26.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 { connectWebEnvironment, type WebEnvWindow } from './web-environment'\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/web-environment.d.ts

@@ -0,0 +1,60 @@
+//#region src/web-environment.d.ts
+/**
+ * Web adapter for the platform environment.
+ *
+ * Wires the browser's live signals — color scheme, reduced motion, window size, the soft keyboard (via
+ * `visualViewport`), and CSS `env(safe-area-inset-*)` — into {@link setEnvironment}, so the device hooks
+ * (`useColorScheme`, `useWindowDimensions`, `useSafeAreaInsets`, `useKeyboard`, `useReducedMotion`) are
+ * LIVE on the web target with zero configuration. Without this, those signals keep their inert defaults
+ * (0×0, light, no insets, keyboard hidden) on web.
+ *
+ * SSR-safe: a no-op when there is no DOM. Call once at startup — the `create` template wires it into
+ * `main.tsx`. Returns a `disconnect()` that removes every listener and the probe element.
+ *
+ * @module
+ */
+interface MediaQueryLike {
+  readonly matches: boolean;
+  addEventListener(type: 'change', listener: () => void): void;
+  removeEventListener(type: 'change', listener: () => void): void;
+}
+interface VisualViewportLike {
+  readonly height: number;
+  readonly offsetTop: number;
+  addEventListener(type: string, listener: () => void): void;
+  removeEventListener(type: string, listener: () => void): void;
+}
+interface ProbeLike {
+  style: {
+    cssText: string;
+  };
+  remove(): void;
+}
+interface DocumentLike {
+  body: {
+    appendChild(node: ProbeLike): void;
+  } | null;
+  createElement(tag: string): ProbeLike;
+}
+/** The subset of `Window` the adapter uses. */
+interface WebEnvWindow {
+  readonly innerWidth: number;
+  readonly innerHeight: number;
+  readonly devicePixelRatio?: number;
+  readonly visualViewport?: VisualViewportLike | null;
+  readonly document?: DocumentLike;
+  matchMedia(query: string): MediaQueryLike;
+  getComputedStyle?(el: ProbeLike): {
+    getPropertyValue(prop: string): string;
+  };
+  addEventListener(type: string, listener: () => void): void;
+  removeEventListener(type: string, listener: () => void): void;
+}
+/**
+ * Connect the browser environment to the reactive device hooks. Pass a `window` (defaults to the global).
+ * Returns a `disconnect()`.
+ */
+declare function connectWebEnvironment(win?: WebEnvWindow): () => void;
+//#endregion
+export { WebEnvWindow, connectWebEnvironment };
+//# sourceMappingURL=web-environment.d.ts.map

package/dist/web-environment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-environment.d.ts","names":[],"sources":["../src/web-environment.ts"],"mappings":";;;;;;;;;;;;;;AAsB0D;UAHhD,cAAA;EAAA,SACC,OAAA;EACT,gBAAA,CAAiB,IAAA,YAAgB,QAAA;EACjC,mBAAA,CAAoB,IAAA,YAAgB,QAAA;AAAA;AAAA,UAE5B,kBAAA;EAAA,SACC,MAAA;EAAA,SACA,SAAA;EACT,gBAAA,CAAiB,IAAA,UAAc,QAAA;EAC/B,mBAAA,CAAoB,IAAA,UAAc,QAAA;AAAA;AAAA,UAE1B,SAAA;EACR,KAAA;IAAS,OAAA;EAAA;EACT,MAAA;AAAA;AAAA,UAEQ,YAAA;EACR,IAAA;IAAQ,WAAA,CAAY,IAAA,EAAM,SAAA;EAAA;EAC1B,aAAA,CAAc,GAAA,WAAc,SAAS;AAAA;AAJ/B;AAAA,UAOS,YAAA;EAAA,SACN,UAAA;EAAA,SACA,WAAA;EAAA,SACA,gBAAA;EAAA,SACA,cAAA,GAAiB,kBAAA;EAAA,SACjB,QAAA,GAAW,YAAA;EACpB,UAAA,CAAW,KAAA,WAAgB,cAAA;EAC3B,gBAAA,EAAkB,EAAA,EAAI,SAAA;IAAc,gBAAA,CAAiB,IAAA;EAAA;EACrD,gBAAA,CAAiB,IAAA,UAAc,QAAA;EAC/B,mBAAA,CAAoB,IAAA,UAAc,QAAA;AAAA;;;;;iBAUpB,qBAAA,CAAsB,GAAkB,GAAZ,YAAY"}

package/dist/web-environment.js

@@ -0,0 +1,98 @@
+import { setEnvironment } from "./environment.js";
+//#region src/web-environment.ts
+/**
+* Web adapter for the platform environment.
+*
+* Wires the browser's live signals — color scheme, reduced motion, window size, the soft keyboard (via
+* `visualViewport`), and CSS `env(safe-area-inset-*)` — into {@link setEnvironment}, so the device hooks
+* (`useColorScheme`, `useWindowDimensions`, `useSafeAreaInsets`, `useKeyboard`, `useReducedMotion`) are
+* LIVE on the web target with zero configuration. Without this, those signals keep their inert defaults
+* (0×0, light, no insets, keyboard hidden) on web.
+*
+* SSR-safe: a no-op when there is no DOM. Call once at startup — the `create` template wires it into
+* `main.tsx`. Returns a `disconnect()` that removes every listener and the probe element.
+*
+* @module
+*/
+const KEYBOARD_THRESHOLD = 80;
+/**
+* Connect the browser environment to the reactive device hooks. Pass a `window` (defaults to the global).
+* Returns a `disconnect()`.
+*/
+function connectWebEnvironment(win) {
+	const w = win ?? globalThis.window;
+	if (!w || typeof w.matchMedia !== "function") return () => {};
+	const cleanups = [];
+	const bindMedia = (query, apply) => {
+		const mq = w.matchMedia(query);
+		const on = () => apply(mq.matches);
+		on();
+		mq.addEventListener("change", on);
+		cleanups.push(() => mq.removeEventListener("change", on));
+	};
+	bindMedia("(prefers-color-scheme: dark)", (m) => setEnvironment({ colorScheme: m ? "dark" : "light" }));
+	bindMedia("(prefers-reduced-motion: reduce)", (m) => setEnvironment({ reducedMotion: m }));
+	const readWindow = () => setEnvironment({ window: {
+		width: w.innerWidth,
+		height: w.innerHeight,
+		scale: w.devicePixelRatio ?? 1,
+		fontScale: 1
+	} });
+	const doc = w.document;
+	let probe = null;
+	if (doc?.body && typeof doc.createElement === "function" && typeof w.getComputedStyle === "function") {
+		probe = doc.createElement("div");
+		probe.style.cssText = "position:fixed;visibility:hidden;pointer-events:none;top:0;left:0;padding:env(safe-area-inset-top) env(safe-area-inset-right) env(safe-area-inset-bottom) env(safe-area-inset-left)";
+		doc.body.appendChild(probe);
+		cleanups.push(() => probe?.remove());
+	}
+	const readSafeArea = () => {
+		if (!probe || typeof w.getComputedStyle !== "function") return;
+		const cs = w.getComputedStyle(probe);
+		const px = (v) => Number.parseFloat(v) || 0;
+		setEnvironment({ safeAreaInsets: {
+			top: px(cs.getPropertyValue("padding-top")),
+			right: px(cs.getPropertyValue("padding-right")),
+			bottom: px(cs.getPropertyValue("padding-bottom")),
+			left: px(cs.getPropertyValue("padding-left"))
+		} });
+	};
+	const vv = w.visualViewport;
+	const readKeyboard = () => {
+		if (!vv) return;
+		const h = Math.max(0, w.innerHeight - vv.height - vv.offsetTop);
+		const visible = h > KEYBOARD_THRESHOLD;
+		setEnvironment({ keyboard: {
+			visible,
+			height: visible ? h : 0
+		} });
+	};
+	const onResize = () => {
+		readWindow();
+		readSafeArea();
+		readKeyboard();
+	};
+	onResize();
+	w.addEventListener("resize", onResize);
+	cleanups.push(() => w.removeEventListener("resize", onResize));
+	if (vv) {
+		const onViewport = () => {
+			readKeyboard();
+			readSafeArea();
+		};
+		vv.addEventListener("resize", onViewport);
+		vv.addEventListener("scroll", onViewport);
+		cleanups.push(() => {
+			vv.removeEventListener("resize", onViewport);
+			vv.removeEventListener("scroll", onViewport);
+		});
+	}
+	return () => {
+		for (const c of cleanups) c();
+		cleanups.length = 0;
+	};
+}
+//#endregion
+export { connectWebEnvironment };
+
+//# sourceMappingURL=web-environment.js.map

package/dist/web-environment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-environment.js","names":[],"sources":["../src/web-environment.ts"],"sourcesContent":["/**\n * Web adapter for the platform environment.\n *\n * Wires the browser's live signals — color scheme, reduced motion, window size, the soft keyboard (via\n * `visualViewport`), and CSS `env(safe-area-inset-*)` — into {@link setEnvironment}, so the device hooks\n * (`useColorScheme`, `useWindowDimensions`, `useSafeAreaInsets`, `useKeyboard`, `useReducedMotion`) are\n * LIVE on the web target with zero configuration. Without this, those signals keep their inert defaults\n * (0×0, light, no insets, keyboard hidden) on web.\n *\n * SSR-safe: a no-op when there is no DOM. Call once at startup — the `create` template wires it into\n * `main.tsx`. Returns a `disconnect()` that removes every listener and the probe element.\n *\n * @module\n */\n\nimport { setEnvironment } from './environment'\n\n// Minimal STRUCTURAL views of the DOM we touch — so this package needs no `lib.dom` in its types and\n// stays platform-neutral. A real `Window` satisfies these shapes.\ninterface MediaQueryLike {\n  readonly matches: boolean\n  addEventListener(type: 'change', listener: () => void): void\n  removeEventListener(type: 'change', listener: () => void): void\n}\ninterface VisualViewportLike {\n  readonly height: number\n  readonly offsetTop: number\n  addEventListener(type: string, listener: () => void): void\n  removeEventListener(type: string, listener: () => void): void\n}\ninterface ProbeLike {\n  style: { cssText: string }\n  remove(): void\n}\ninterface DocumentLike {\n  body: { appendChild(node: ProbeLike): void } | null\n  createElement(tag: string): ProbeLike\n}\n/** The subset of `Window` the adapter uses. */\nexport interface WebEnvWindow {\n  readonly innerWidth: number\n  readonly innerHeight: number\n  readonly devicePixelRatio?: number\n  readonly visualViewport?: VisualViewportLike | null\n  readonly document?: DocumentLike\n  matchMedia(query: string): MediaQueryLike\n  getComputedStyle?(el: ProbeLike): { getPropertyValue(prop: string): string }\n  addEventListener(type: string, listener: () => void): void\n  removeEventListener(type: string, listener: () => void): void\n}\n\n// Below this the viewport-height delta is browser chrome (URL bar), not a soft keyboard.\nconst KEYBOARD_THRESHOLD = 80\n\n/**\n * Connect the browser environment to the reactive device hooks. Pass a `window` (defaults to the global).\n * Returns a `disconnect()`.\n */\nexport function connectWebEnvironment(win?: WebEnvWindow): () => void {\n  const w = win ?? (globalThis as unknown as { window?: WebEnvWindow }).window\n  if (!w || typeof w.matchMedia !== 'function') return () => {} // SSR / non-DOM → inert\n\n  const cleanups: Array<() => void> = []\n\n  const bindMedia = (query: string, apply: (matches: boolean) => void): void => {\n    const mq = w.matchMedia(query)\n    const on = (): void => apply(mq.matches)\n    on()\n    mq.addEventListener('change', on)\n    cleanups.push(() => mq.removeEventListener('change', on))\n  }\n  bindMedia('(prefers-color-scheme: dark)', (m) =>\n    setEnvironment({ colorScheme: m ? 'dark' : 'light' }),\n  )\n  bindMedia('(prefers-reduced-motion: reduce)', (m) => setEnvironment({ reducedMotion: m }))\n\n  const readWindow = (): void =>\n    setEnvironment({\n      window: {\n        width: w.innerWidth,\n        height: w.innerHeight,\n        scale: w.devicePixelRatio ?? 1,\n        fontScale: 1,\n      },\n    })\n\n  // Safe-area insets: a hidden probe whose padding is `env(safe-area-inset-*)`; read its computed style.\n  const doc = w.document\n  let probe: ProbeLike | null = null\n  if (\n    doc?.body &&\n    typeof doc.createElement === 'function' &&\n    typeof w.getComputedStyle === 'function'\n  ) {\n    probe = doc.createElement('div')\n    probe.style.cssText =\n      'position:fixed;visibility:hidden;pointer-events:none;top:0;left:0;padding:env(safe-area-inset-top) env(safe-area-inset-right) env(safe-area-inset-bottom) env(safe-area-inset-left)'\n    doc.body.appendChild(probe)\n    cleanups.push(() => probe?.remove())\n  }\n  const readSafeArea = (): void => {\n    if (!probe || typeof w.getComputedStyle !== 'function') return\n    const cs = w.getComputedStyle(probe)\n    const px = (v: string): number => Number.parseFloat(v) || 0\n    setEnvironment({\n      safeAreaInsets: {\n        top: px(cs.getPropertyValue('padding-top')),\n        right: px(cs.getPropertyValue('padding-right')),\n        bottom: px(cs.getPropertyValue('padding-bottom')),\n        left: px(cs.getPropertyValue('padding-left')),\n      },\n    })\n  }\n\n  const vv = w.visualViewport\n  const readKeyboard = (): void => {\n    if (!vv) return\n    const h = Math.max(0, w.innerHeight - vv.height - vv.offsetTop)\n    const visible = h > KEYBOARD_THRESHOLD\n    setEnvironment({ keyboard: { visible, height: visible ? h : 0 } })\n  }\n\n  const onResize = (): void => {\n    readWindow()\n    readSafeArea()\n    readKeyboard()\n  }\n  onResize() // seed immediately\n  w.addEventListener('resize', onResize)\n  cleanups.push(() => w.removeEventListener('resize', onResize))\n\n  if (vv) {\n    const onViewport = (): void => {\n      readKeyboard()\n      readSafeArea()\n    }\n    vv.addEventListener('resize', onViewport)\n    vv.addEventListener('scroll', onViewport)\n    cleanups.push(() => {\n      vv.removeEventListener('resize', onViewport)\n      vv.removeEventListener('scroll', onViewport)\n    })\n  }\n\n  return () => {\n    for (const c of cleanups) c()\n    cleanups.length = 0\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAoDA,MAAM,qBAAqB;;;;;AAM3B,SAAgB,sBAAsB,KAAgC;CACpE,MAAM,IAAI,OAAQ,WAAoD;CACtE,IAAI,CAAC,KAAK,OAAO,EAAE,eAAe,YAAY,aAAa,CAAC;CAE5D,MAAM,WAA8B,CAAC;CAErC,MAAM,aAAa,OAAe,UAA4C;EAC5E,MAAM,KAAK,EAAE,WAAW,KAAK;EAC7B,MAAM,WAAiB,MAAM,GAAG,OAAO;EACvC,GAAG;EACH,GAAG,iBAAiB,UAAU,EAAE;EAChC,SAAS,WAAW,GAAG,oBAAoB,UAAU,EAAE,CAAC;CAC1D;CACA,UAAU,iCAAiC,MACzC,eAAe,EAAE,aAAa,IAAI,SAAS,QAAQ,CAAC,CACtD;CACA,UAAU,qCAAqC,MAAM,eAAe,EAAE,eAAe,EAAE,CAAC,CAAC;CAEzF,MAAM,mBACJ,eAAe,EACb,QAAQ;EACN,OAAO,EAAE;EACT,QAAQ,EAAE;EACV,OAAO,EAAE,oBAAoB;EAC7B,WAAW;CACb,EACF,CAAC;CAGH,MAAM,MAAM,EAAE;CACd,IAAI,QAA0B;CAC9B,IACE,KAAK,QACL,OAAO,IAAI,kBAAkB,cAC7B,OAAO,EAAE,qBAAqB,YAC9B;EACA,QAAQ,IAAI,cAAc,KAAK;EAC/B,MAAM,MAAM,UACV;EACF,IAAI,KAAK,YAAY,KAAK;EAC1B,SAAS,WAAW,OAAO,OAAO,CAAC;CACrC;CACA,MAAM,qBAA2B;EAC/B,IAAI,CAAC,SAAS,OAAO,EAAE,qBAAqB,YAAY;EACxD,MAAM,KAAK,EAAE,iBAAiB,KAAK;EACnC,MAAM,MAAM,MAAsB,OAAO,WAAW,CAAC,KAAK;EAC1D,eAAe,EACb,gBAAgB;GACd,KAAK,GAAG,GAAG,iBAAiB,aAAa,CAAC;GAC1C,OAAO,GAAG,GAAG,iBAAiB,eAAe,CAAC;GAC9C,QAAQ,GAAG,GAAG,iBAAiB,gBAAgB,CAAC;GAChD,MAAM,GAAG,GAAG,iBAAiB,cAAc,CAAC;EAC9C,EACF,CAAC;CACH;CAEA,MAAM,KAAK,EAAE;CACb,MAAM,qBAA2B;EAC/B,IAAI,CAAC,IAAI;EACT,MAAM,IAAI,KAAK,IAAI,GAAG,EAAE,cAAc,GAAG,SAAS,GAAG,SAAS;EAC9D,MAAM,UAAU,IAAI;EACpB,eAAe,EAAE,UAAU;GAAE;GAAS,QAAQ,UAAU,IAAI;EAAE,EAAE,CAAC;CACnE;CAEA,MAAM,iBAAuB;EAC3B,WAAW;EACX,aAAa;EACb,aAAa;CACf;CACA,SAAS;CACT,EAAE,iBAAiB,UAAU,QAAQ;CACrC,SAAS,WAAW,EAAE,oBAAoB,UAAU,QAAQ,CAAC;CAE7D,IAAI,IAAI;EACN,MAAM,mBAAyB;GAC7B,aAAa;GACb,aAAa;EACf;EACA,GAAG,iBAAiB,UAAU,UAAU;EACxC,GAAG,iBAAiB,UAAU,UAAU;EACxC,SAAS,WAAW;GAClB,GAAG,oBAAoB,UAAU,UAAU;GAC3C,GAAG,oBAAoB,UAAU,UAAU;EAC7C,CAAC;CACH;CAEA,aAAa;EACX,KAAK,MAAM,KAAK,UAAU,EAAE;EAC5B,SAAS,SAAS;CACpB;AACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mindees/atlas",
-  "version": "0.25.0",
+  "version": "0.26.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",
@@ -35,12 +35,12 @@
     "directory": "packages/atlas"
   },
   "dependencies": {
-    "@mindees/core": "0.25.0",
-    "@mindees/router": "0.25.0"
+    "@mindees/core": "0.26.0",
+    "@mindees/router": "0.26.0"
   },
   "devDependencies": {
     "happy-dom": "20.9.0",
-    "@mindees/renderer": "0.25.0"
+    "@mindees/renderer": "0.26.0"
   },
   "scripts": {
     "build": "tsdown",