@mindees/atlas 0.1.0

package/LICENSE

@@ -0,0 +1,31 @@
+# License
+
+MindeesNative is dual-licensed under either of:
+
+- **Apache License, Version 2.0** ([LICENSE-APACHE](./LICENSE-APACHE) or
+  <https://www.apache.org/licenses/LICENSE-2.0>)
+- **MIT license** ([LICENSE-MIT](./LICENSE-MIT) or
+  <https://opensource.org/licenses/MIT>)
+
+at your option.
+
+This `MIT OR Apache-2.0` dual-license is the same model used by the Rust
+ecosystem and many modern open-source projects. It gives downstream users
+maximum flexibility: the MIT option is short and permissive, while the Apache
+option adds an explicit patent grant.
+
+## SPDX identifier
+
+```
+SPDX-License-Identifier: MIT OR Apache-2.0
+```
+
+## Contribution
+
+Unless you explicitly state otherwise, any contribution intentionally
+submitted for inclusion in the work by you, as defined in the Apache-2.0
+license, shall be dual-licensed as above, without any additional terms or
+conditions.
+
+Contributions are accepted under the **Developer Certificate of Origin (DCO)**.
+See [CONTRIBUTING.md](./CONTRIBUTING.md) for details on signing off your commits.

package/README.md

@@ -0,0 +1,62 @@
+# @mindees/atlas
+
+The Atlas component library — MindeesNative's batteries-included UI primitives.
+
+> Note: named `@mindees/atlas` (not `@mindees/ui`) because `@mindees/ui` is a
+> 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.
+> See the repository [STATUS.md](../../STATUS.md).
+
+## What works today
+
+- **Primitives** — `View`, `Text`, `Image`, `TextInput`, `Pressable`, `Button`,
+  `Stack`, `Row`, `Column`, `Spacer`, and `ScrollView` return renderer-agnostic
+  `MindeesNode` trees over `@mindees/core` `createElement`.
+- **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.
+- **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.
+
+## Quick start
+
+```ts
+import { Button, Column, Text } from '@mindees/atlas'
+import { List } from '@mindees/atlas/list'
+import { createTheme } from '@mindees/atlas/theme'
+
+const theme = createTheme({ colors: { primary: '#2563eb' } })
+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.' }),
+    Button({ title: 'Save', style: () => ({ backgroundColor: primary(), padding: 12 }) }),
+    List({
+      items: ['One', 'Two', 'Three'],
+      height: 120,
+      itemHeight: 40,
+      renderItem: (item) => Text({ children: item }),
+    }),
+  ],
+})
+```
+
+Design rationale: [ADR-0022](../../docs/adr/0022-atlas-primitives.md) and
+[ADR-0023](../../docs/adr/0023-atlas-list.md).
+
+## License
+
+`MIT OR Apache-2.0`

package/dist/a11y.d.ts

@@ -0,0 +1,43 @@
+//#region src/a11y.d.ts
+/**
+ * Atlas accessibility — a single typed `A11yProps` surface lowered to `role` + `aria-*`
+ * attribute props. The DOM backend passes these through verbatim (`setAttribute`), so web a11y
+ * is real; native hosts receive them as serialized props (interpretation is a 🔬 research-track
+ * host concern — carried, never silently dropped). See `docs/adr/0022-atlas-primitives.md`.
+ *
+ * @module
+ */
+/** A WAI-ARIA-ish role, mapped straight to the host `role` attribute on web. */
+type Role = 'button' | 'link' | 'image' | 'heading' | 'list' | 'listitem' | 'text' | 'textbox' | 'checkbox' | 'switch' | 'radio' | 'tab' | 'tabpanel' | 'dialog' | 'alert' | 'status' | 'none' | 'presentation';
+/** Accessibility state, lowered to the matching `aria-*` attributes. */
+interface A11yState {
+  disabled?: boolean;
+  selected?: boolean;
+  checked?: boolean;
+  expanded?: boolean;
+  busy?: boolean;
+  hidden?: boolean;
+}
+/** The accessibility surface every Atlas primitive accepts. */
+interface A11yProps {
+  /** ARIA role (web `role`). */
+  role?: Role;
+  /** Accessible name (`aria-label`). */
+  label?: string;
+  /** Id(s) of the element(s) labelling this one (`aria-labelledby`). */
+  labelledBy?: string;
+  /** Id(s) of the element(s) describing this one (`aria-describedby`). */
+  describedBy?: string;
+  /** Live-region politeness (`aria-live`). */
+  live?: 'off' | 'polite' | 'assertive';
+  /** Accessibility state (`aria-disabled`/`-selected`/`-checked`/`-expanded`/`-busy`/`aria-hidden`). */
+  state?: A11yState;
+}
+/**
+ * Lower {@link A11yProps} to a host prop bag of `role` + `aria-*` (only keys that are defined,
+ * so omitted props stay omitted — exactOptionalPropertyTypes-safe).
+ */
+declare function toA11yProps(a11y: A11yProps): Record<string, string>;
+//#endregion
+export { A11yProps, A11yState, Role, toA11yProps };
+//# sourceMappingURL=a11y.d.ts.map

package/dist/a11y.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"a11y.d.ts","names":[],"sources":["../src/a11y.ts"],"mappings":";;AAUA;;;;AAAgB;AAqBhB;;;KArBY,IAAA;;UAqBK,SAAA;EACf,QAAA;EACA,QAAA;EACA,OAAA;EACA,QAAA;EACA,IAAA;EACA,MAAA;AAAA;;UAIe,SAAA;EAYE;EAVjB,IAAA,GAAO,IAAA;EAAA;EAEP,KAAA;EAEA;EAAA,UAAA;EAIA;EAFA,WAAA;EAIQ;EAFR,IAAA;EAEiB;EAAjB,KAAA,GAAQ,SAAS;AAAA;;;;;iBAOH,WAAA,CAAY,IAAA,EAAM,SAAA,GAAY,MAAM"}

package/dist/a11y.js

@@ -0,0 +1,27 @@
+//#region src/a11y.ts
+/**
+* Lower {@link A11yProps} to a host prop bag of `role` + `aria-*` (only keys that are defined,
+* so omitted props stay omitted — exactOptionalPropertyTypes-safe).
+*/
+function toA11yProps(a11y) {
+	const out = {};
+	if (a11y.role !== void 0) out.role = a11y.role;
+	if (a11y.label !== void 0) out["aria-label"] = a11y.label;
+	if (a11y.labelledBy !== void 0) out["aria-labelledby"] = a11y.labelledBy;
+	if (a11y.describedBy !== void 0) out["aria-describedby"] = a11y.describedBy;
+	if (a11y.live !== void 0) out["aria-live"] = a11y.live;
+	const s = a11y.state;
+	if (s) {
+		if (s.disabled !== void 0) out["aria-disabled"] = String(s.disabled);
+		if (s.selected !== void 0) out["aria-selected"] = String(s.selected);
+		if (s.checked !== void 0) out["aria-checked"] = String(s.checked);
+		if (s.expanded !== void 0) out["aria-expanded"] = String(s.expanded);
+		if (s.busy !== void 0) out["aria-busy"] = String(s.busy);
+		if (s.hidden !== void 0) out["aria-hidden"] = String(s.hidden);
+	}
+	return out;
+}
+//#endregion
+export { toA11yProps };
+
+//# sourceMappingURL=a11y.js.map

package/dist/a11y.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"a11y.js","names":[],"sources":["../src/a11y.ts"],"sourcesContent":["/**\n * Atlas accessibility — a single typed `A11yProps` surface lowered to `role` + `aria-*`\n * attribute props. The DOM backend passes these through verbatim (`setAttribute`), so web a11y\n * is real; native hosts receive them as serialized props (interpretation is a 🔬 research-track\n * host concern — carried, never silently dropped). See `docs/adr/0022-atlas-primitives.md`.\n *\n * @module\n */\n\n/** A WAI-ARIA-ish role, mapped straight to the host `role` attribute on web. */\nexport type Role =\n  | 'button'\n  | 'link'\n  | 'image'\n  | 'heading'\n  | 'list'\n  | 'listitem'\n  | 'text'\n  | 'textbox'\n  | 'checkbox'\n  | 'switch'\n  | 'radio'\n  | 'tab'\n  | 'tabpanel'\n  | 'dialog'\n  | 'alert'\n  | 'status'\n  | 'none'\n  | 'presentation'\n\n/** Accessibility state, lowered to the matching `aria-*` attributes. */\nexport interface A11yState {\n  disabled?: boolean\n  selected?: boolean\n  checked?: boolean\n  expanded?: boolean\n  busy?: boolean\n  hidden?: boolean\n}\n\n/** The accessibility surface every Atlas primitive accepts. */\nexport interface A11yProps {\n  /** ARIA role (web `role`). */\n  role?: Role\n  /** Accessible name (`aria-label`). */\n  label?: string\n  /** Id(s) of the element(s) labelling this one (`aria-labelledby`). */\n  labelledBy?: string\n  /** Id(s) of the element(s) describing this one (`aria-describedby`). */\n  describedBy?: string\n  /** Live-region politeness (`aria-live`). */\n  live?: 'off' | 'polite' | 'assertive'\n  /** Accessibility state (`aria-disabled`/`-selected`/`-checked`/`-expanded`/`-busy`/`aria-hidden`). */\n  state?: A11yState\n}\n\n/**\n * Lower {@link A11yProps} to a host prop bag of `role` + `aria-*` (only keys that are defined,\n * so omitted props stay omitted — exactOptionalPropertyTypes-safe).\n */\nexport function toA11yProps(a11y: A11yProps): Record<string, string> {\n  const out: Record<string, string> = {}\n  if (a11y.role !== undefined) out.role = a11y.role\n  if (a11y.label !== undefined) out['aria-label'] = a11y.label\n  if (a11y.labelledBy !== undefined) out['aria-labelledby'] = a11y.labelledBy\n  if (a11y.describedBy !== undefined) out['aria-describedby'] = a11y.describedBy\n  if (a11y.live !== undefined) out['aria-live'] = a11y.live\n  const s = a11y.state\n  if (s) {\n    if (s.disabled !== undefined) out['aria-disabled'] = String(s.disabled)\n    if (s.selected !== undefined) out['aria-selected'] = String(s.selected)\n    if (s.checked !== undefined) out['aria-checked'] = String(s.checked)\n    if (s.expanded !== undefined) out['aria-expanded'] = String(s.expanded)\n    if (s.busy !== undefined) out['aria-busy'] = String(s.busy)\n    if (s.hidden !== undefined) out['aria-hidden'] = String(s.hidden)\n  }\n  return out\n}\n"],"mappings":";;;;;AA4DA,SAAgB,YAAY,MAAyC;CACnE,MAAM,MAA8B,CAAC;CACrC,IAAI,KAAK,SAAS,KAAA,GAAW,IAAI,OAAO,KAAK;CAC7C,IAAI,KAAK,UAAU,KAAA,GAAW,IAAI,gBAAgB,KAAK;CACvD,IAAI,KAAK,eAAe,KAAA,GAAW,IAAI,qBAAqB,KAAK;CACjE,IAAI,KAAK,gBAAgB,KAAA,GAAW,IAAI,sBAAsB,KAAK;CACnE,IAAI,KAAK,SAAS,KAAA,GAAW,IAAI,eAAe,KAAK;CACrD,MAAM,IAAI,KAAK;CACf,IAAI,GAAG;EACL,IAAI,EAAE,aAAa,KAAA,GAAW,IAAI,mBAAmB,OAAO,EAAE,QAAQ;EACtE,IAAI,EAAE,aAAa,KAAA,GAAW,IAAI,mBAAmB,OAAO,EAAE,QAAQ;EACtE,IAAI,EAAE,YAAY,KAAA,GAAW,IAAI,kBAAkB,OAAO,EAAE,OAAO;EACnE,IAAI,EAAE,aAAa,KAAA,GAAW,IAAI,mBAAmB,OAAO,EAAE,QAAQ;EACtE,IAAI,EAAE,SAAS,KAAA,GAAW,IAAI,eAAe,OAAO,EAAE,IAAI;EAC1D,IAAI,EAAE,WAAW,KAAA,GAAW,IAAI,iBAAiB,OAAO,EAAE,MAAM;CAClE;CACA,OAAO;AACT"}

package/dist/host.d.ts

@@ -0,0 +1,23 @@
+import { A11yProps } from "./a11y.js";
+import { StyleInput, StyleObject } from "./style.js";
+import { Accessor } from "@mindees/core";
+
+//#region src/host.d.ts
+/** A value that may be static or a reactive accessor — a function makes it a fine-grained binding. */
+type Reactive<T> = T | Accessor<T>;
+/** Props every Atlas primitive accepts. */
+interface BaseProps extends A11yProps {
+  /** Style (or a list of styles), static or reactive. */
+  readonly style?: Reactive<StyleInput>;
+  /** Host element id. */
+  readonly id?: string;
+  /** Test identifier (lowered to `data-testid`). */
+  readonly testID?: string;
+}
+/** Resolve a `Reactive<StyleInput>` to a flattened style object, or an accessor of one. */
+declare function resolveStyle(style: Reactive<StyleInput>): StyleObject | Accessor<StyleObject>;
+/** Lower the base props (style + a11y + id/testID) to a host prop bag (omitted stays omitted). */
+declare function toHostProps(props: BaseProps): Record<string, unknown>;
+//#endregion
+export { BaseProps, Reactive, resolveStyle, toHostProps };
+//# sourceMappingURL=host.d.ts.map

package/dist/host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.d.ts","names":[],"sources":["../src/host.ts"],"mappings":";;;;;;KAcY,QAAA,MAAc,CAAA,GAAI,QAAA,CAAS,CAAA;;UAGtB,SAAA,SAAkB,SAAA;EAHL;EAAA,SAKnB,KAAA,GAAQ,QAAA,CAAS,UAAA;EALY;EAAA,SAO7B,EAAA;EAJM;EAAA,SAMN,MAAA;AAAA;;iBAIK,YAAA,CAAa,KAAA,EAAO,QAAA,CAAS,UAAA,IAAc,WAAA,GAAc,QAAA,CAAS,WAAA;;iBASlE,WAAA,CAAY,KAAA,EAAO,SAAA,GAAY,MAAM"}

package/dist/host.js

@@ -0,0 +1,23 @@
+import { toA11yProps } from "./a11y.js";
+import { flattenStyle } from "./style.js";
+//#region src/host.ts
+/** Resolve a `Reactive<StyleInput>` to a flattened style object, or an accessor of one. */
+function resolveStyle(style) {
+	if (typeof style === "function") {
+		const accessor = style;
+		return () => flattenStyle(accessor());
+	}
+	return flattenStyle(style);
+}
+/** Lower the base props (style + a11y + id/testID) to a host prop bag (omitted stays omitted). */
+function toHostProps(props) {
+	const host = { ...toA11yProps(props) };
+	if (props.style !== void 0) host.style = resolveStyle(props.style);
+	if (props.id !== void 0) host.id = props.id;
+	if (props.testID !== void 0) host["data-testid"] = props.testID;
+	return host;
+}
+//#endregion
+export { resolveStyle, toHostProps };
+
+//# sourceMappingURL=host.js.map

package/dist/host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.js","names":[],"sources":["../src/host.ts"],"sourcesContent":["/**\n * The prop→host adapter. Atlas primitives expose a curated, typed prop surface; `toHostProps`\n * lowers the shared base (style + accessibility + id/testID) to the host prop bag that\n * `createElement` receives — the renderer then special-cases `style` (object → inline/native)\n * and passes `role`/`aria-*`/attributes through. Each primitive adds its own events/extra props.\n *\n * @module\n */\n\nimport type { Accessor } from '@mindees/core'\nimport { type A11yProps, toA11yProps } from './a11y'\nimport { flattenStyle, type StyleInput, type StyleObject } from './style'\n\n/** A value that may be static or a reactive accessor — a function makes it a fine-grained binding. */\nexport type Reactive<T> = T | Accessor<T>\n\n/** Props every Atlas primitive accepts. */\nexport interface BaseProps extends A11yProps {\n  /** Style (or a list of styles), static or reactive. */\n  readonly style?: Reactive<StyleInput>\n  /** Host element id. */\n  readonly id?: string\n  /** Test identifier (lowered to `data-testid`). */\n  readonly testID?: string\n}\n\n/** Resolve a `Reactive<StyleInput>` to a flattened style object, or an accessor of one. */\nexport function resolveStyle(style: Reactive<StyleInput>): StyleObject | Accessor<StyleObject> {\n  if (typeof style === 'function') {\n    const accessor = style as Accessor<StyleInput>\n    return () => flattenStyle(accessor())\n  }\n  return flattenStyle(style)\n}\n\n/** Lower the base props (style + a11y + id/testID) to a host prop bag (omitted stays omitted). */\nexport function toHostProps(props: BaseProps): Record<string, unknown> {\n  const host: Record<string, unknown> = { ...toA11yProps(props) }\n  if (props.style !== undefined) host.style = resolveStyle(props.style)\n  if (props.id !== undefined) host.id = props.id\n  if (props.testID !== undefined) host['data-testid'] = props.testID\n  return host\n}\n"],"mappings":";;;;AA2BA,SAAgB,aAAa,OAAkE;CAC7F,IAAI,OAAO,UAAU,YAAY;EAC/B,MAAM,WAAW;EACjB,aAAa,aAAa,SAAS,CAAC;CACtC;CACA,OAAO,aAAa,KAAK;AAC3B;;AAGA,SAAgB,YAAY,OAA2C;CACrE,MAAM,OAAgC,EAAE,GAAG,YAAY,KAAK,EAAE;CAC9D,IAAI,MAAM,UAAU,KAAA,GAAW,KAAK,QAAQ,aAAa,MAAM,KAAK;CACpE,IAAI,MAAM,OAAO,KAAA,GAAW,KAAK,KAAK,MAAM;CAC5C,IAAI,MAAM,WAAW,KAAA,GAAW,KAAK,iBAAiB,MAAM;CAC5D,OAAO;AACT"}

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+import { A11yProps, A11yState, Role, toA11yProps } from "./a11y.js";
+import { StyleInput, StyleObject, StyleValue, flattenStyle } from "./style.js";
+import { BaseProps, Reactive, resolveStyle, toHostProps } from "./host.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 { 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.1.0";
+/** Current maturity of this package. See the repository `STATUS.md`. */
+declare const maturity: Maturity;
+/**
+ * Static identity + maturity metadata for this package. Frozen so the
+ * self-reported identity tooling introspects cannot be mutated at runtime,
+ * matching the `readonly` fields of {@link PackageInfo}.
+ */
+declare const info: PackageInfo;
+//#endregion
+export { type A11yProps, type A11yState, type BaseProps, Button, type ButtonProps, Column, Image, type ImageProps, type InteractionState, type Maturity, NotImplementedError, type PackageInfo, Pressable, type PressableProps, type Reactive, type Role, Row, ScrollView, type ScrollViewProps, Spacer, type SpacerProps, Stack, type StackProps, type StyleInput, type StyleObject, type StyleValue, Text, TextInput, type TextInputProps, type TextProps, VERSION, View, type ViewProps, flattenStyle, info, maturity, name, notImplemented, resolveStyle, toA11yProps, toHostProps, usePressable };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"mappings":";;;;;;;AAkBA;AAAA,cAHa,IAAA;;cAGA,OAAA;AAAO;AAAA,cAGP,QAAA,EAAU,QAAyB;;;;AAAA;AAOhD;cAAa,IAAA,EAAM,WAAiE"}

package/dist/index.js

@@ -0,0 +1,26 @@
+import { toA11yProps } from "./a11y.js";
+import { flattenStyle } from "./style.js";
+import { resolveStyle, toHostProps } from "./host.js";
+import { Button, Column, Image, Pressable, Row, ScrollView, Spacer, Stack, Text, TextInput, View, usePressable } from "./primitives.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.1.0";
+/** Current maturity of this package. See the repository `STATUS.md`. */
+const maturity = "experimental";
+/**
+* Static identity + maturity metadata for this package. Frozen so the
+* self-reported identity tooling introspects cannot be mutated at runtime,
+* matching the `readonly` fields of {@link PackageInfo}.
+*/
+const info = Object.freeze({
+	name,
+	version: VERSION,
+	maturity
+});
+//#endregion
+export { Button, Column, Image, NotImplementedError, Pressable, Row, ScrollView, Spacer, Stack, Text, TextInput, VERSION, View, flattenStyle, info, maturity, name, notImplemented, resolveStyle, toA11yProps, toHostProps, usePressable };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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.1.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 { type BaseProps, type Reactive, resolveStyle, toHostProps } from './host'\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 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/list.d.ts

@@ -0,0 +1,57 @@
+import { StyleInput } from "./style.js";
+import { Reactive } from "./host.js";
+import { MindeesNode } from "@mindees/core";
+
+//#region src/list.d.ts
+/** The computed visible window over the item list. */
+interface ListWindow {
+  /** First visible index (inclusive), overscan applied. */
+  readonly startIndex: number;
+  /** Last visible index (exclusive), overscan applied. */
+  readonly endIndex: number;
+  /** Total scrollable height (px) = itemCount × itemHeight. */
+  readonly totalHeight: number;
+}
+/**
+ * Pure window math: which item indices are visible for a given scroll offset. Exported and
+ * exhaustively unit-tested — the deterministic heart of virtualization (no signals, no DOM).
+ */
+declare function computeWindow(scrollTop: number, viewportHeight: number, itemHeight: number, itemCount: number, overscan: number): ListWindow;
+/** Options for {@link createList}. */
+interface ListOptions<T> {
+  /** The items, static or reactive. */
+  readonly items: readonly T[] | (() => readonly T[]);
+  /**
+   * Render one row. Receives reactive `item`/`index` **accessors** — consume them LAZILY
+   * (`Text({ children: () => item().name })`, a `style` fn, or pass them to a child) so a
+   * recycled slot patches in place. Reading `item()`/`index()` synchronously in the body bakes
+   * the value in and opts the row out of recycling (it re-runs renderItem on reuse instead).
+   */
+  readonly renderItem: (item: () => T, index: () => number) => MindeesNode;
+  /** Fixed row height in px (variable heights are a research track). */
+  readonly itemHeight: number;
+  /** Viewport height in px. */
+  readonly height: number;
+  /** Extra rows rendered above/below the viewport (default 3, clamped 0–50). */
+  readonly overscan?: number;
+  /** Read the current scroll offset (test/SSR injection seam; default 0). */
+  readonly getScrollOffset?: () => number;
+  /**
+   * Fires once when the last item is within the rendered window — including at mount if the list
+   * already fits the viewport — and re-arms when the end scrolls back out (e.g. to load more).
+   */
+  readonly onEndReached?: () => void;
+  /** Extra style on the scroll container. */
+  readonly style?: Reactive<StyleInput>;
+}
+/**
+ * Create a virtualized recycling list as a renderer-agnostic `MindeesNode`.
+ *
+ * @throws RangeError if `itemHeight`/`height` are not positive finite numbers.
+ */
+declare function createList<T>(options: ListOptions<T>): MindeesNode;
+/** Component-style alias for {@link createList}. */
+declare function List<T>(options: ListOptions<T>): MindeesNode;
+//#endregion
+export { List, ListOptions, ListWindow, computeWindow, createList };
+//# sourceMappingURL=list.d.ts.map

package/dist/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","names":[],"sources":["../src/list.ts"],"mappings":";;;;;;UA6BiB,UAAA;EAef;EAAA,SAbS,UAAA;EAeT;EAAA,SAbS,QAAA;EAeR;EAAA,SAbQ,WAAA;AAAA;AAyBX;;;;AAAA,iBAlBgB,aAAA,CACd,SAAA,UACA,cAAA,UACA,UAAA,UACA,SAAA,UACA,QAAA,WACC,UAAU;;UAYI,WAAA;EAwBW;EAAA,SAtBjB,KAAA,WAAgB,CAAA,qBAAsB,CAAA;EAsBtB;;;;;;EAAA,SAfhB,UAAA,GAAa,IAAA,QAAY,CAAA,EAAG,KAAA,mBAAwB,WAAA;EAA3B;EAAA,SAEzB,UAAA;EAF4B;EAAA,SAI5B,MAAA;EAFA;EAAA,SAIA,QAAA;EAAA;EAAA,SAEA,eAAA;EAKA;;;;EAAA,SAAA,YAAA;EAE2B;EAAA,SAA3B,KAAA,GAAQ,QAAA,CAAS,UAAA;AAAA;;;;;;iBAoBZ,UAAA,IAAc,OAAA,EAAS,WAAA,CAAY,CAAA,IAAK,WAAA;;iBA2HxC,IAAA,IAAQ,OAAA,EAAS,WAAA,CAAY,CAAA,IAAK,WAAA"}

package/dist/list.js

@@ -0,0 +1,124 @@
+import { flattenStyle } from "./style.js";
+import { ScrollView } from "./primitives.js";
+import { batch, createElement, effect, memo, signal } from "@mindees/core";
+//#region src/list.ts
+/**
+* Atlas `List` — a virtualized, **recycling** list. Only the visible window (+ overscan) is
+* rendered; rows are a FIXED POOL of per-slot reactive regions, NOT one region returning
+* `items.map(...)` (the Helix reconciler has no keyed array diff, so a single array region
+* would tear down + remount every visible row on each scroll). Each slot region depends only
+* on its own `active` signal, so a row that stays in view keeps its identity and `renderItem`
+* runs once for it — only rows scrolling across the window edge are (re)created. A total-height
+* spacer keeps the native scrollbar correct; rows are absolutely positioned by `transform`.
+*
+* Fixed row height in v1 (deterministic windowing, headless-testable with zero real scroll);
+* variable/measured heights are a 🔬 research track. See `docs/adr/0023-atlas-list.md`.
+*
+* @module
+*/
+/**
+* Pure window math: which item indices are visible for a given scroll offset. Exported and
+* exhaustively unit-tested — the deterministic heart of virtualization (no signals, no DOM).
+*/
+function computeWindow(scrollTop, viewportHeight, itemHeight, itemCount, overscan) {
+	const totalHeight = itemCount * itemHeight;
+	if (itemCount <= 0) return {
+		startIndex: 0,
+		endIndex: 0,
+		totalHeight: 0
+	};
+	const top = Math.max(0, Math.min(scrollTop, Math.max(0, totalHeight - viewportHeight)));
+	const firstVisible = Math.floor(top / itemHeight);
+	const lastVisible = Math.ceil((top + viewportHeight) / itemHeight);
+	return {
+		startIndex: Math.max(0, firstVisible - overscan),
+		endIndex: Math.min(itemCount, lastVisible + overscan),
+		totalHeight
+	};
+}
+function readScrollTop(event) {
+	const top = event?.target?.scrollTop;
+	return typeof top === "number" && Number.isFinite(top) ? top : 0;
+}
+/**
+* Create a virtualized recycling list as a renderer-agnostic `MindeesNode`.
+*
+* @throws RangeError if `itemHeight`/`height` are not positive finite numbers.
+*/
+function createList(options) {
+	const { renderItem, itemHeight, height } = options;
+	if (!Number.isFinite(itemHeight) || itemHeight <= 0) throw new RangeError("List itemHeight must be a positive number");
+	if (!Number.isFinite(height) || height <= 0) throw new RangeError("List height must be a positive number");
+	const overscan = Math.max(0, Math.min(50, Math.floor(options.overscan ?? 3)));
+	const itemsOf = typeof options.items === "function" ? options.items : () => options.items;
+	return () => {
+		const scrollTop = signal(options.getScrollOffset ? options.getScrollOffset() : 0);
+		const poolSize = Math.ceil(height / itemHeight) + 2 * overscan + 1;
+		const windowMemo = memo(() => computeWindow(scrollTop(), height, itemHeight, itemsOf().length, overscan), { equals: (a, b) => a.startIndex === b.startIndex && a.endIndex === b.endIndex });
+		const slots = Array.from({ length: poolSize }, () => ({
+			item: signal(void 0),
+			index: signal(0),
+			top: signal(0),
+			active: signal(false)
+		}));
+		let endReachedFired = false;
+		effect(() => {
+			const { startIndex, endIndex } = windowMemo();
+			const items = itemsOf();
+			const used = new Array(poolSize).fill(false);
+			batch(() => {
+				for (let i = startIndex; i < endIndex; i++) {
+					const s = (i % poolSize + poolSize) % poolSize;
+					used[s] = true;
+					const slot = slots[s];
+					if (!slot) continue;
+					slot.item.set(items[i]);
+					slot.index.set(i);
+					slot.top.set(i * itemHeight);
+					slot.active.set(true);
+				}
+				for (let s = 0; s < poolSize; s++) if (!used[s]) slots[s]?.active.set(false);
+			});
+			if (options.onEndReached && items.length > 0) if (endIndex >= items.length) {
+				if (!endReachedFired) {
+					endReachedFired = true;
+					options.onEndReached();
+				}
+			} else endReachedFired = false;
+		});
+		const spacer = createElement("view", { style: () => ({
+			position: "relative",
+			width: "100%",
+			height: itemsOf().length * itemHeight
+		}) }, ...slots.map((slot, s) => () => {
+			if (!slot.active()) return null;
+			const content = renderItem(() => slot.item(), () => slot.index());
+			return createElement("view", {
+				key: `atlas-list-row-${s}`,
+				style: () => ({
+					position: "absolute",
+					left: 0,
+					right: 0,
+					top: 0,
+					height: itemHeight,
+					transform: `translateY(${slot.top()}px)`
+				})
+			}, content);
+		}));
+		return createElement(ScrollView, {
+			onScroll: (event) => scrollTop.set(readScrollTop(event)),
+			style: flattenStyle([{
+				height,
+				position: "relative"
+			}, options.style])
+		}, spacer);
+	};
+}
+/** Component-style alias for {@link createList}. */
+function List(options) {
+	return createList(options);
+}
+//#endregion
+export { List, computeWindow, createList };
+
+//# sourceMappingURL=list.js.map

package/dist/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","names":[],"sources":["../src/list.ts"],"sourcesContent":["/**\n * Atlas `List` — a virtualized, **recycling** list. Only the visible window (+ overscan) is\n * rendered; rows are a FIXED POOL of per-slot reactive regions, NOT one region returning\n * `items.map(...)` (the Helix reconciler has no keyed array diff, so a single array region\n * would tear down + remount every visible row on each scroll). Each slot region depends only\n * on its own `active` signal, so a row that stays in view keeps its identity and `renderItem`\n * runs once for it — only rows scrolling across the window edge are (re)created. A total-height\n * spacer keeps the native scrollbar correct; rows are absolutely positioned by `transform`.\n *\n * Fixed row height in v1 (deterministic windowing, headless-testable with zero real scroll);\n * variable/measured heights are a 🔬 research track. See `docs/adr/0023-atlas-list.md`.\n *\n * @module\n */\n\nimport {\n  batch,\n  createElement,\n  effect,\n  type MindeesNode,\n  memo,\n  type Signal,\n  signal,\n} from '@mindees/core'\nimport type { Reactive } from './host'\nimport { ScrollView } from './primitives'\nimport { flattenStyle, type StyleInput } from './style'\n\n/** The computed visible window over the item list. */\nexport interface ListWindow {\n  /** First visible index (inclusive), overscan applied. */\n  readonly startIndex: number\n  /** Last visible index (exclusive), overscan applied. */\n  readonly endIndex: number\n  /** Total scrollable height (px) = itemCount × itemHeight. */\n  readonly totalHeight: number\n}\n\n/**\n * Pure window math: which item indices are visible for a given scroll offset. Exported and\n * exhaustively unit-tested — the deterministic heart of virtualization (no signals, no DOM).\n */\nexport function computeWindow(\n  scrollTop: number,\n  viewportHeight: number,\n  itemHeight: number,\n  itemCount: number,\n  overscan: number,\n): ListWindow {\n  const totalHeight = itemCount * itemHeight\n  if (itemCount <= 0) return { startIndex: 0, endIndex: 0, totalHeight: 0 }\n  const top = Math.max(0, Math.min(scrollTop, Math.max(0, totalHeight - viewportHeight)))\n  const firstVisible = Math.floor(top / itemHeight)\n  const lastVisible = Math.ceil((top + viewportHeight) / itemHeight)\n  const startIndex = Math.max(0, firstVisible - overscan)\n  const endIndex = Math.min(itemCount, lastVisible + overscan)\n  return { startIndex, endIndex, totalHeight }\n}\n\n/** Options for {@link createList}. */\nexport interface ListOptions<T> {\n  /** The items, static or reactive. */\n  readonly items: readonly T[] | (() => readonly T[])\n  /**\n   * Render one row. Receives reactive `item`/`index` **accessors** — consume them LAZILY\n   * (`Text({ children: () => item().name })`, a `style` fn, or pass them to a child) so a\n   * recycled slot patches in place. Reading `item()`/`index()` synchronously in the body bakes\n   * the value in and opts the row out of recycling (it re-runs renderItem on reuse instead).\n   */\n  readonly renderItem: (item: () => T, index: () => number) => MindeesNode\n  /** Fixed row height in px (variable heights are a research track). */\n  readonly itemHeight: number\n  /** Viewport height in px. */\n  readonly height: number\n  /** Extra rows rendered above/below the viewport (default 3, clamped 0–50). */\n  readonly overscan?: number\n  /** Read the current scroll offset (test/SSR injection seam; default 0). */\n  readonly getScrollOffset?: () => number\n  /**\n   * Fires once when the last item is within the rendered window — including at mount if the list\n   * already fits the viewport — and re-arms when the end scrolls back out (e.g. to load more).\n   */\n  readonly onEndReached?: () => void\n  /** Extra style on the scroll container. */\n  readonly style?: Reactive<StyleInput>\n}\n\ninterface Slot<T> {\n  readonly item: Signal<T | undefined>\n  readonly index: Signal<number>\n  readonly top: Signal<number>\n  readonly active: Signal<boolean>\n}\n\nfunction readScrollTop(event: unknown): number {\n  const top = (event as { target?: { scrollTop?: number } })?.target?.scrollTop\n  return typeof top === 'number' && Number.isFinite(top) ? top : 0\n}\n\n/**\n * Create a virtualized recycling list as a renderer-agnostic `MindeesNode`.\n *\n * @throws RangeError if `itemHeight`/`height` are not positive finite numbers.\n */\nexport function createList<T>(options: ListOptions<T>): MindeesNode {\n  const { renderItem, itemHeight, height } = options\n  if (!Number.isFinite(itemHeight) || itemHeight <= 0) {\n    throw new RangeError('List itemHeight must be a positive number')\n  }\n  if (!Number.isFinite(height) || height <= 0) {\n    throw new RangeError('List height must be a positive number')\n  }\n  const overscan = Math.max(0, Math.min(50, Math.floor(options.overscan ?? 3)))\n  const itemsOf: () => readonly T[] =\n    typeof options.items === 'function' ? options.items : () => options.items as readonly T[]\n\n  // Return a reactive-region accessor so ALL the signals/memo/effect below are created under the\n  // mounting owner (the renderer runs this once via bindReactiveChild) and are disposed on\n  // unmount. Creating them eagerly here would leave them un-owned (currentOwner === null at call\n  // time) and leak past `dispose()`. Validation above stays synchronous (throws at call time).\n  return () => {\n    const scrollTop = signal(options.getScrollOffset ? options.getScrollOffset() : 0)\n    const poolSize = Math.ceil(height / itemHeight) + 2 * overscan + 1\n\n    // Re-run the assignment only when the integer window actually changes (not every pixel).\n    const windowMemo = memo(\n      () => computeWindow(scrollTop(), height, itemHeight, itemsOf().length, overscan),\n      {\n        equals: (a, b) => a.startIndex === b.startIndex && a.endIndex === b.endIndex,\n      },\n    )\n\n    const slots: Slot<T>[] = Array.from({ length: poolSize }, () => ({\n      item: signal<T | undefined>(undefined),\n      index: signal(0),\n      top: signal(0),\n      active: signal(false),\n    }))\n\n    let endReachedFired = false\n    // Assign each visible index to slot `index % poolSize`; deactivate the rest. Max window size\n    // equals poolSize (the `+1` is that exact margin — do NOT remove it), and any run of ≤\n    // poolSize consecutive indices has distinct residues mod poolSize, so no two visible indices\n    // ever share a slot.\n    effect(() => {\n      const { startIndex, endIndex } = windowMemo()\n      const items = itemsOf()\n      const used = new Array<boolean>(poolSize).fill(false)\n      batch(() => {\n        for (let i = startIndex; i < endIndex; i++) {\n          const s = ((i % poolSize) + poolSize) % poolSize\n          used[s] = true\n          const slot = slots[s]\n          if (!slot) continue\n          slot.item.set(items[i])\n          slot.index.set(i)\n          slot.top.set(i * itemHeight)\n          slot.active.set(true)\n        }\n        for (let s = 0; s < poolSize; s++) {\n          if (!used[s]) slots[s]?.active.set(false)\n        }\n      })\n      // onEndReached: fire when the last item is within the window (incl. at mount if the list\n      // fits the viewport); re-arm when the end leaves the window.\n      if (options.onEndReached && items.length > 0) {\n        if (endIndex >= items.length) {\n          if (!endReachedFired) {\n            endReachedFired = true\n            options.onEndReached()\n          }\n        } else {\n          endReachedFired = false\n        }\n      }\n    })\n\n    // One reactive region per slot. The body depends ONLY on `active()`, so a slot that stays\n    // active never re-runs renderItem; item/index/top flow through the inner accessors — provided\n    // renderItem consumes them lazily (see the ListOptions.renderItem contract).\n    const rows: MindeesNode[] = slots.map((slot, s) => () => {\n      if (!slot.active()) return null\n      const content = renderItem(\n        () => slot.item() as T,\n        () => slot.index(),\n      )\n      return createElement(\n        'view',\n        {\n          key: `atlas-list-row-${s}`,\n          style: () => ({\n            position: 'absolute',\n            left: 0,\n            right: 0,\n            top: 0,\n            height: itemHeight,\n            transform: `translateY(${slot.top()}px)`,\n          }),\n        },\n        content,\n      )\n    })\n\n    const spacer = createElement(\n      'view',\n      {\n        style: () => ({\n          position: 'relative',\n          width: '100%',\n          height: itemsOf().length * itemHeight,\n        }),\n      },\n      ...rows,\n    )\n\n    return createElement(\n      ScrollView,\n      {\n        onScroll: (event: unknown) => scrollTop.set(readScrollTop(event)),\n        style: flattenStyle([{ height, position: 'relative' }, options.style as StyleInput]),\n      },\n      spacer,\n    )\n  }\n}\n\n/** Component-style alias for {@link createList}. */\nexport function List<T>(options: ListOptions<T>): MindeesNode {\n  return createList(options)\n}\n"],"mappings":"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"}

package/dist/primitives.d.ts

@@ -0,0 +1,98 @@
+import { StyleInput } from "./style.js";
+import { BaseProps, Reactive } from "./host.js";
+import { Component, MindeesNode } from "@mindees/core";
+
+//#region src/primitives.d.ts
+/** A generic container (→ `view`/`div`). */
+interface ViewProps extends BaseProps {
+  readonly children?: MindeesNode;
+}
+declare const View: Component<ViewProps>;
+/** Text content (→ `text`/`span`). No default `role` (a bare span is correct; pass `role` to opt in). */
+interface TextProps extends BaseProps {
+  readonly children?: MindeesNode;
+}
+declare const Text: Component<TextProps>;
+/** An image (→ `image`/`img`). Requires `label` (alt) unless `decorative`. */
+interface ImageProps extends BaseProps {
+  readonly src: string;
+  /** Mark purely-decorative images so screen readers skip them (alt="" + aria-hidden). */
+  readonly decorative?: boolean;
+}
+declare const Image: Component<ImageProps>;
+/** A text field (→ `textinput`/`input`). `value` may be reactive (controlled). */
+interface TextInputProps extends BaseProps {
+  readonly value?: Reactive<string>;
+  readonly placeholder?: string;
+  readonly type?: 'text' | 'password' | 'email' | 'number' | 'search' | 'tel' | 'url';
+  readonly disabled?: boolean;
+  /** Fires on every keystroke with the current value (`input` event). */
+  readonly onInput?: (value: string) => void;
+  /** Fires on commit/blur with the current value (`change` event). */
+  readonly onChange?: (value: string) => void;
+}
+declare const TextInput: Component<TextInputProps>;
+/** Interaction state exposed to a Pressable style function. */
+interface InteractionState {
+  readonly hovered: boolean;
+  readonly pressed: boolean;
+  readonly focused: boolean;
+}
+/** A pressable surface with built-in hover/press/focus state. Web-real via DOM events. */
+interface PressableProps extends Omit<BaseProps, 'style'> {
+  readonly children?: MindeesNode;
+  /** Called when activated (click / Enter / Space) — skipped while `disabled`. */
+  readonly onPress?: () => void;
+  readonly disabled?: boolean;
+  /** Static/reactive style, or a function of the live interaction state. */
+  readonly style?: Reactive<StyleInput> | ((state: InteractionState) => StyleInput);
+}
+/**
+ * Create the interaction signals + host handlers a pressable surface needs. Reusable so other
+ * primitives can compose interaction state. Web wires REAL DOM events (`click`, `pointer*`,
+ * `focus`/`blur`, `keydown`) — never a fake cross-platform `press` event that no-ops on web.
+ */
+declare function usePressable(options?: {
+  onPress?: () => void;
+  disabled?: boolean;
+}): {
+  state: () => InteractionState;
+  handlers: Record<string, (event: unknown) => void>;
+};
+declare const Pressable: Component<PressableProps>;
+/** A labelled button = {@link Pressable} wrapping a {@link Text}. */
+interface ButtonProps extends PressableProps {
+  /** Convenience text label (alternative to `children`). */
+  readonly title?: string;
+}
+declare const Button: Component<ButtonProps>;
+type FlexAlign = 'flex-start' | 'flex-end' | 'center' | 'stretch' | 'baseline';
+type FlexJustify = 'flex-start' | 'flex-end' | 'center' | 'space-between' | 'space-around' | 'space-evenly';
+/** A flex container. `direction` defaults to `column`. */
+interface StackProps extends ViewProps {
+  readonly direction?: 'row' | 'column';
+  readonly gap?: number | string;
+  readonly align?: FlexAlign;
+  readonly justify?: FlexJustify;
+}
+declare const Stack: Component<StackProps>;
+/** A horizontal {@link Stack}. */
+declare const Row: Component<Omit<StackProps, 'direction'>>;
+/** A vertical {@link Stack}. */
+declare const Column: Component<Omit<StackProps, 'direction'>>;
+/** Flexible (or fixed) empty space. */
+interface SpacerProps {
+  /** Fixed size (px) instead of flexible fill. */
+  readonly size?: number | string;
+}
+declare const Spacer: Component<SpacerProps>;
+/** A scrollable container (→ `scrollview`/`div` with `overflow:auto`). */
+interface ScrollViewProps extends ViewProps {
+  readonly horizontal?: boolean;
+  /** Fires on scroll with the host scroll event. */
+  readonly onScroll?: (event: unknown) => void;
+}
+declare const ScrollView: Component<ScrollViewProps>;
+//#endregion
+export { Button, ButtonProps, Column, Image, ImageProps, InteractionState, Pressable, PressableProps, Row, ScrollView, ScrollViewProps, Spacer, SpacerProps, Stack, StackProps, Text, TextInput, TextInputProps, TextProps, View, ViewProps, usePressable };
+//# sourceMappingURL=primitives.d.ts.map

package/dist/primitives.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitives.d.ts","names":[],"sources":["../src/primitives.ts"],"mappings":";;;;;;UA+CiB,SAAA,SAAkB,SAAS;EAAA,SACjC,QAAA,GAAW,WAAA;AAAA;AAAA,cAET,IAAA,EAAM,SAAS,CAAC,SAAA;;UAIZ,SAAA,SAAkB,SAAS;EAAA,SACjC,QAAA,GAAW,WAAA;AAAA;AAAA,cAET,IAAA,EAAM,SAAS,CAAC,SAAA;;UAIZ,UAAA,SAAmB,SAAS;EAAA,SAClC,GAAA;EAPW;EAAA,SASX,UAAA;AAAA;AAAA,cAEE,KAAA,EAAO,SAAS,CAAC,UAAA;;UAoBb,cAAA,SAAuB,SAAS;EAAA,SACtC,KAAA,GAAQ,QAAA;EAAA,SACR,WAAA;EAAA,SACA,IAAA;EAAA,SACA,QAAA;;WAEA,OAAA,IAAW,KAAA;EA/Bc;EAAA,SAiCzB,QAAA,IAAY,KAAA;AAAA;AAAA,cAEV,SAAA,EAAW,SAAS,CAAC,cAAA;AAhCb;AAAA,UA6CJ,gBAAA;EAAA,SACN,OAAA;EAAA,SACA,OAAA;EAAA,SACA,OAAA;AAAA;AA1BX;AAAA,UA8BiB,cAAA,SAAuB,IAAA,CAAK,SAAA;EAAA,SAClC,QAAA,GAAW,WAAA;EA/B2B;EAAA,SAiCtC,OAAA;EAAA,SACA,QAAA;EAjCQ;EAAA,SAmCR,KAAA,GAAQ,QAAA,CAAS,UAAA,MAAgB,KAAA,EAAO,gBAAA,KAAqB,UAAA;AAAA;;;;;;iBAQxD,YAAA,CAAa,OAAA;EAAW,OAAA;EAAsB,QAAA;AAAA;EAC5D,KAAA,QAAa,gBAAA;EACb,QAAA,EAAU,MAAM,UAAU,KAAA;AAAA;AAAA,cAgDf,SAAA,EAAW,SAAS,CAAC,cAAA;;UA2BjB,WAAA,SAAoB,cAAc;EAlGlB;EAAA,SAoGtB,KAAK;AAAA;AAAA,cAEH,MAAA,EAAQ,SAAS,CAAC,WAAA;AAAA,KAe1B,SAAA;AAAA,KACA,WAAA;AA/GL;AAAA,UAwHiB,UAAA,SAAmB,SAAA;EAAA,SACzB,SAAA;EAAA,SACA,GAAA;EAAA,SACA,KAAA,GAAQ,SAAA;EAAA,SACR,OAAA,GAAU,WAAA;AAAA;AAAA,cAER,KAAA,EAAO,SAAS,CAAC,UAAA;;cAajB,GAAA,EAAK,SAAA,CAAU,IAAA,CAAK,UAAA;;cAIpB,MAAA,EAAQ,SAAA,CAAU,IAAA,CAAK,UAAA;;UAInB,WAAA;EAlJN;EAAA,SAoJA,IAAI;AAAA;AAAA,cAEF,MAAA,EAAQ,SAAS,CAAC,WAAA;;UAMd,eAAA,SAAwB,SAAS;EAAA,SACvC,UAAA;EAxJwC;EAAA,SA0JxC,QAAA,IAAY,KAAA;AAAA;AAAA,cAEV,UAAA,EAAY,SAAS,CAAC,eAAA"}

package/dist/primitives.js

@@ -0,0 +1,176 @@
+import { flattenStyle } from "./style.js";
+import { resolveStyle, toHostProps } from "./host.js";
+import { createElement, signal } from "@mindees/core";
+//#region src/primitives.ts
+/**
+* Atlas primitives — accessible, signals-native UI building blocks. Each is a
+* `Component<P>` over `@mindees/core`'s `createElement`, returning a renderer-agnostic
+* `MindeesNode`. Web rendering is real (via the Helix DOM backend); native is a labeled 🔬
+* research track (the same serializable tree, interpreted by a native host later). See
+* `docs/adr/0022-atlas-primitives.md`.
+*
+* @module
+*/
+/** Merge a base layout style with a caller's (possibly reactive) style, staying reactive if it is. */
+function withBaseStyle(base, style) {
+	if (typeof style === "function") {
+		const accessor = style;
+		return () => flattenStyle([base, accessor()]);
+	}
+	return flattenStyle([base, style]);
+}
+/** Dev-only warning (silent in production). Structural global access — no DOM/Node lib needed. */
+function warnDev(message) {
+	const g = globalThis;
+	if (g.process?.env?.NODE_ENV === "production") return;
+	g.console?.warn?.(`[atlas] ${message}`);
+}
+function eventValue(event) {
+	return event?.target?.value ?? "";
+}
+const View = (props) => createElement("view", toHostProps(props), props.children);
+const Text = (props) => createElement("text", toHostProps(props), props.children);
+const Image = (props) => {
+	const host = toHostProps(props);
+	host.src = props.src;
+	if (props.decorative) {
+		host.alt = "";
+		host["aria-hidden"] = "true";
+		delete host["aria-label"];
+		delete host["aria-labelledby"];
+	} else {
+		if (props.label === void 0) warnDev("Image without a `label` (alt text); pass `label` or set `decorative`.");
+		host.alt = props.label ?? "";
+	}
+	return createElement("image", host);
+};
+const TextInput = (props) => {
+	const host = toHostProps(props);
+	if (!host.role) host.role = "textbox";
+	if (props.value !== void 0) host.value = props.value;
+	if (props.placeholder !== void 0) host.placeholder = props.placeholder;
+	if (props.type !== void 0) host.type = props.type;
+	if (props.disabled) host.disabled = true;
+	if (props.onInput) host.onInput = (e) => props.onInput?.(eventValue(e));
+	if (props.onChange) host.onChange = (e) => props.onChange?.(eventValue(e));
+	return createElement("textinput", host);
+};
+/**
+* Create the interaction signals + host handlers a pressable surface needs. Reusable so other
+* primitives can compose interaction state. Web wires REAL DOM events (`click`, `pointer*`,
+* `focus`/`blur`, `keydown`) — never a fake cross-platform `press` event that no-ops on web.
+*/
+function usePressable(options = {}) {
+	const hovered = signal(false);
+	const pressed = signal(false);
+	const focused = signal(false);
+	const enabled = () => !options.disabled;
+	const fire = () => {
+		if (enabled()) options.onPress?.();
+	};
+	return {
+		state: () => ({
+			hovered: hovered(),
+			pressed: pressed(),
+			focused: focused()
+		}),
+		handlers: {
+			onClick: () => fire(),
+			onPointerEnter: () => {
+				if (enabled()) hovered.set(true);
+			},
+			onPointerLeave: () => {
+				if (enabled()) {
+					hovered.set(false);
+					pressed.set(false);
+				}
+			},
+			onPointerDown: () => {
+				if (enabled()) pressed.set(true);
+			},
+			onPointerUp: () => {
+				if (enabled()) pressed.set(false);
+			},
+			onFocus: () => {
+				if (enabled()) focused.set(true);
+			},
+			onBlur: () => {
+				if (enabled()) focused.set(false);
+			},
+			onKeyDown: (e) => {
+				const ev = e;
+				if (ev.key === "Enter" || ev.key === " ") {
+					ev.preventDefault?.();
+					fire();
+				}
+			}
+		}
+	};
+}
+const Pressable = (props) => {
+	const { state, handlers } = usePressable({
+		...props.onPress ? { onPress: props.onPress } : {},
+		...props.disabled ? { disabled: true } : {}
+	});
+	const { style, ...rest } = props;
+	const host = {
+		...toHostProps(rest),
+		...handlers
+	};
+	if (!host.role) host.role = "button";
+	if (props.disabled) host["aria-disabled"] = "true";
+	else host.tabindex = 0;
+	if (style !== void 0) host.style = typeof style === "function" && style.length >= 1 ? () => flattenStyle(style(state())) : resolveStyle(style);
+	return createElement("view", host, props.children);
+};
+const Button = (props) => {
+	const { title, children, ...rest } = props;
+	return createElement(Pressable, rest, (Array.isArray(children) ? children.length > 0 : children != null) ? children : title !== void 0 ? createElement(Text, null, title) : null);
+};
+const Stack = (props) => {
+	const { direction = "column", gap, align, justify, style, children, ...rest } = props;
+	const layout = {
+		display: "flex",
+		flexDirection: direction,
+		...gap !== void 0 ? { gap } : {},
+		...align !== void 0 ? { alignItems: align } : {},
+		...justify !== void 0 ? { justifyContent: justify } : {}
+	};
+	return createElement(View, {
+		...rest,
+		style: withBaseStyle(layout, style)
+	}, children);
+};
+/** A horizontal {@link Stack}. */
+const Row = (props) => createElement(Stack, {
+	...props,
+	direction: "row"
+}, props.children);
+/** A vertical {@link Stack}. */
+const Column = (props) => createElement(Stack, {
+	...props,
+	direction: "column"
+}, props.children);
+const Spacer = (props) => createElement(View, { style: props.size !== void 0 ? {
+	width: props.size,
+	height: props.size
+} : { flex: 1 } });
+const ScrollView = (props) => {
+	const { horizontal, onScroll, style, children, ...rest } = props;
+	const host = toHostProps({
+		...rest,
+		style: withBaseStyle(horizontal ? {
+			display: "flex",
+			overflow: "auto",
+			flexDirection: "row",
+			flexWrap: "nowrap"
+		} : { overflow: "auto" }, style)
+	});
+	if (onScroll) host.onScroll = onScroll;
+	if (horizontal) host["data-orientation"] = "horizontal";
+	return createElement("scrollview", host, children);
+};
+//#endregion
+export { Button, Column, Image, Pressable, Row, ScrollView, Spacer, Stack, Text, TextInput, View, usePressable };
+
+//# sourceMappingURL=primitives.js.map

package/dist/primitives.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitives.js","names":[],"sources":["../src/primitives.ts"],"sourcesContent":["/**\n * Atlas primitives — accessible, signals-native UI building blocks. Each is a\n * `Component<P>` over `@mindees/core`'s `createElement`, returning a renderer-agnostic\n * `MindeesNode`. Web rendering is real (via the Helix DOM backend); native is a labeled 🔬\n * research track (the same serializable tree, interpreted by a native host later). See\n * `docs/adr/0022-atlas-primitives.md`.\n *\n * @module\n */\n\nimport {\n  type Accessor,\n  type Component,\n  createElement,\n  type MindeesNode,\n  signal,\n} from '@mindees/core'\nimport { type BaseProps, type Reactive, resolveStyle, toHostProps } from './host'\nimport { flattenStyle, type StyleInput } from './style'\n\n/** Merge a base layout style with a caller's (possibly reactive) style, staying reactive if it is. */\nfunction withBaseStyle(\n  base: StyleInput,\n  style: Reactive<StyleInput> | undefined,\n): Reactive<StyleInput> {\n  if (typeof style === 'function') {\n    const accessor = style as Accessor<StyleInput>\n    return () => flattenStyle([base, accessor()])\n  }\n  return flattenStyle([base, style])\n}\n\n/** Dev-only warning (silent in production). Structural global access — no DOM/Node lib needed. */\nfunction warnDev(message: string): void {\n  const g = globalThis as {\n    process?: { env?: Record<string, string | undefined> }\n    console?: { warn?: (message: string) => void }\n  }\n  if (g.process?.env?.NODE_ENV === 'production') return\n  g.console?.warn?.(`[atlas] ${message}`)\n}\n\nfunction eventValue(event: unknown): string {\n  return (event as { target?: { value?: string } })?.target?.value ?? ''\n}\n\n/** A generic container (→ `view`/`div`). */\nexport interface ViewProps extends BaseProps {\n  readonly children?: MindeesNode\n}\nexport const View: Component<ViewProps> = (props) =>\n  createElement('view', toHostProps(props), props.children)\n\n/** Text content (→ `text`/`span`). No default `role` (a bare span is correct; pass `role` to opt in). */\nexport interface TextProps extends BaseProps {\n  readonly children?: MindeesNode\n}\nexport const Text: Component<TextProps> = (props) =>\n  createElement('text', toHostProps(props), props.children)\n\n/** An image (→ `image`/`img`). Requires `label` (alt) unless `decorative`. */\nexport interface ImageProps extends BaseProps {\n  readonly src: string\n  /** Mark purely-decorative images so screen readers skip them (alt=\"\" + aria-hidden). */\n  readonly decorative?: boolean\n}\nexport const Image: Component<ImageProps> = (props) => {\n  const host = toHostProps(props)\n  host.src = props.src\n  if (props.decorative) {\n    host.alt = ''\n    host['aria-hidden'] = 'true'\n    // A decorative image must expose NO accessible name; drop any label lowered by\n    // toHostProps so we don't emit a contradictory aria-label on a hidden element.\n    delete host['aria-label']\n    delete host['aria-labelledby']\n  } else {\n    if (props.label === undefined) {\n      warnDev('Image without a `label` (alt text); pass `label` or set `decorative`.')\n    }\n    host.alt = props.label ?? ''\n  }\n  return createElement('image', host)\n}\n\n/** A text field (→ `textinput`/`input`). `value` may be reactive (controlled). */\nexport interface TextInputProps extends BaseProps {\n  readonly value?: Reactive<string>\n  readonly placeholder?: string\n  readonly type?: 'text' | 'password' | 'email' | 'number' | 'search' | 'tel' | 'url'\n  readonly disabled?: boolean\n  /** Fires on every keystroke with the current value (`input` event). */\n  readonly onInput?: (value: string) => void\n  /** Fires on commit/blur with the current value (`change` event). */\n  readonly onChange?: (value: string) => void\n}\nexport const TextInput: Component<TextInputProps> = (props) => {\n  const host = toHostProps(props)\n  if (!host.role) host.role = 'textbox'\n  if (props.value !== undefined) host.value = props.value\n  if (props.placeholder !== undefined) host.placeholder = props.placeholder\n  if (props.type !== undefined) host.type = props.type\n  if (props.disabled) host.disabled = true\n  if (props.onInput) host.onInput = (e: unknown) => props.onInput?.(eventValue(e))\n  if (props.onChange) host.onChange = (e: unknown) => props.onChange?.(eventValue(e))\n  return createElement('textinput', host)\n}\n\n/** Interaction state exposed to a Pressable style function. */\nexport interface InteractionState {\n  readonly hovered: boolean\n  readonly pressed: boolean\n  readonly focused: boolean\n}\n\n/** A pressable surface with built-in hover/press/focus state. Web-real via DOM events. */\nexport interface PressableProps extends Omit<BaseProps, 'style'> {\n  readonly children?: MindeesNode\n  /** Called when activated (click / Enter / Space) — skipped while `disabled`. */\n  readonly onPress?: () => void\n  readonly disabled?: boolean\n  /** Static/reactive style, or a function of the live interaction state. */\n  readonly style?: Reactive<StyleInput> | ((state: InteractionState) => StyleInput)\n}\n\n/**\n * Create the interaction signals + host handlers a pressable surface needs. Reusable so other\n * primitives can compose interaction state. Web wires REAL DOM events (`click`, `pointer*`,\n * `focus`/`blur`, `keydown`) — never a fake cross-platform `press` event that no-ops on web.\n */\nexport function usePressable(options: { onPress?: () => void; disabled?: boolean } = {}): {\n  state: () => InteractionState\n  handlers: Record<string, (event: unknown) => void>\n} {\n  const hovered = signal(false)\n  const pressed = signal(false)\n  const focused = signal(false)\n  const enabled = (): boolean => !options.disabled\n  const fire = (): void => {\n    if (enabled()) options.onPress?.()\n  }\n  // A disabled control is inert: its interaction signals don't update, so a state-driven style\n  // shows no hover/press/focus feedback (and `fire` blocks onPress / keyboard activation).\n  const handlers: Record<string, (event: unknown) => void> = {\n    onClick: () => fire(),\n    onPointerEnter: () => {\n      if (enabled()) hovered.set(true)\n    },\n    onPointerLeave: () => {\n      if (enabled()) {\n        hovered.set(false)\n        pressed.set(false)\n      }\n    },\n    onPointerDown: () => {\n      if (enabled()) pressed.set(true)\n    },\n    onPointerUp: () => {\n      if (enabled()) pressed.set(false)\n    },\n    onFocus: () => {\n      if (enabled()) focused.set(true)\n    },\n    onBlur: () => {\n      if (enabled()) focused.set(false)\n    },\n    onKeyDown: (e: unknown) => {\n      const ev = e as { key?: string; preventDefault?: () => void }\n      if (ev.key === 'Enter' || ev.key === ' ') {\n        ev.preventDefault?.() // stop Space from page-scrolling a div[role=button]\n        fire()\n      }\n    },\n  }\n  return {\n    state: () => ({ hovered: hovered(), pressed: pressed(), focused: focused() }),\n    handlers,\n  }\n}\n\nexport const Pressable: Component<PressableProps> = (props) => {\n  const { state, handlers } = usePressable({\n    ...(props.onPress ? { onPress: props.onPress } : {}),\n    ...(props.disabled ? { disabled: true } : {}),\n  })\n  // Base host props WITHOUT style (Pressable resolves style itself, supporting a state fn).\n  const { style, ...rest } = props\n  const host: Record<string, unknown> = { ...toHostProps(rest), ...handlers }\n  if (!host.role) host.role = 'button'\n  if (props.disabled) host['aria-disabled'] = 'true'\n  else host.tabindex = 0\n  if (style !== undefined) {\n    // Distinguish a state-fn `(state) => StyleInput` from a plain reactive style accessor\n    // `() => StyleInput` by ARITY: both are functions, but only the state-fn declares a\n    // parameter. Treating every function as a state-fn would subscribe an ordinary\n    // reactive style to hover/press/focus, re-running it on every interaction.\n    const isStateFn = typeof style === 'function' && style.length >= 1\n    host.style = isStateFn\n      ? () => flattenStyle((style as (s: InteractionState) => StyleInput)(state()))\n      : // Arity ruled the state-fn out, so the remainder is a plain `Reactive<StyleInput>`.\n        // TS can't narrow on `.length`, so assert it (mirrors the state-fn cast above).\n        resolveStyle(style as Reactive<StyleInput>)\n  }\n  return createElement('view', host, props.children)\n}\n\n/** A labelled button = {@link Pressable} wrapping a {@link Text}. */\nexport interface ButtonProps extends PressableProps {\n  /** Convenience text label (alternative to `children`). */\n  readonly title?: string\n}\nexport const Button: Component<ButtonProps> = (props) => {\n  const { title, children, ...rest } = props\n  // The renderer always passes `children` as an array (`[]` when empty), so `??` wouldn't\n  // trigger the title fallback — treat an empty array as \"no children\".\n  const hasChildren = Array.isArray(children) ? children.length > 0 : children != null\n  const content = hasChildren\n    ? children\n    : title !== undefined\n      ? createElement(Text, null, title)\n      : null\n  return createElement(Pressable, rest, content)\n}\n\n// --- Layout composition (pure View + style, no new host concepts) ---\n\ntype FlexAlign = 'flex-start' | 'flex-end' | 'center' | 'stretch' | 'baseline'\ntype FlexJustify =\n  | 'flex-start'\n  | 'flex-end'\n  | 'center'\n  | 'space-between'\n  | 'space-around'\n  | 'space-evenly'\n\n/** A flex container. `direction` defaults to `column`. */\nexport interface StackProps extends ViewProps {\n  readonly direction?: 'row' | 'column'\n  readonly gap?: number | string\n  readonly align?: FlexAlign\n  readonly justify?: FlexJustify\n}\nexport const Stack: Component<StackProps> = (props) => {\n  const { direction = 'column', gap, align, justify, style, children, ...rest } = props\n  const layout: StyleInput = {\n    display: 'flex',\n    flexDirection: direction,\n    ...(gap !== undefined ? { gap } : {}),\n    ...(align !== undefined ? { alignItems: align } : {}),\n    ...(justify !== undefined ? { justifyContent: justify } : {}),\n  }\n  return createElement(View, { ...rest, style: withBaseStyle(layout, style) }, children)\n}\n\n/** A horizontal {@link Stack}. */\nexport const Row: Component<Omit<StackProps, 'direction'>> = (props) =>\n  createElement(Stack, { ...props, direction: 'row' }, props.children)\n\n/** A vertical {@link Stack}. */\nexport const Column: Component<Omit<StackProps, 'direction'>> = (props) =>\n  createElement(Stack, { ...props, direction: 'column' }, props.children)\n\n/** Flexible (or fixed) empty space. */\nexport interface SpacerProps {\n  /** Fixed size (px) instead of flexible fill. */\n  readonly size?: number | string\n}\nexport const Spacer: Component<SpacerProps> = (props) =>\n  createElement(View, {\n    style: props.size !== undefined ? { width: props.size, height: props.size } : { flex: 1 },\n  })\n\n/** A scrollable container (→ `scrollview`/`div` with `overflow:auto`). */\nexport interface ScrollViewProps extends ViewProps {\n  readonly horizontal?: boolean\n  /** Fires on scroll with the host scroll event. */\n  readonly onScroll?: (event: unknown) => void\n}\nexport const ScrollView: Component<ScrollViewProps> = (props) => {\n  const { horizontal, onScroll, style, children, ...rest } = props\n  // A horizontal scroller lays its children out in a row and scrolls along x; a vertical\n  // one stacks and scrolls along y. Drive real layout through the curated cross-platform\n  // style subset (flexDirection + overflow), not an inert `data-orientation` attribute that\n  // no backend reads.\n  const host = toHostProps({\n    ...rest,\n    style: withBaseStyle(\n      horizontal\n        ? // `display: 'flex'` is required for `flexDirection`/`flexWrap` to take effect —\n          // without it the row layout is inert (the element keeps the default block flow).\n          { display: 'flex', overflow: 'auto', flexDirection: 'row', flexWrap: 'nowrap' }\n        : { overflow: 'auto' },\n      style,\n    ),\n  })\n  if (onScroll) host.onScroll = onScroll\n  if (horizontal) host['data-orientation'] = 'horizontal' // extra hint for native hosts\n  return createElement('scrollview', host, children)\n}\n"],"mappings":"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"}

package/dist/style.d.ts

@@ -0,0 +1,80 @@
+//#region src/style.d.ts
+/**
+ * Atlas styling — a curated, typed `StyleObject` that is the single cross-platform style
+ * vehicle. The renderer applies one `style` object to web inline styles (numbers → `px` for
+ * dimensional props) and serializes the same object as a native prop, so Atlas never needs a
+ * second channel. The subset is hand-picked to be meaningful on **both** web and native;
+ * anything outside it goes through the explicit `unsafeStyle` escape hatch. See
+ * `docs/adr/0022-atlas-primitives.md`.
+ *
+ * @module
+ */
+/** A single style value: a string (e.g. `'red'`, `'50%'`) or a number (px on web, dp on native). */
+type StyleValue = string | number;
+/** A curated, cross-platform-meaningful style object. */
+interface StyleObject {
+  display?: 'flex' | 'none';
+  flexDirection?: 'row' | 'column' | 'row-reverse' | 'column-reverse';
+  justifyContent?: 'flex-start' | 'flex-end' | 'center' | 'space-between' | 'space-around' | 'space-evenly';
+  alignItems?: 'flex-start' | 'flex-end' | 'center' | 'stretch' | 'baseline';
+  alignSelf?: 'auto' | 'flex-start' | 'flex-end' | 'center' | 'stretch' | 'baseline';
+  flexWrap?: 'wrap' | 'nowrap' | 'wrap-reverse';
+  flex?: number | string;
+  flexGrow?: number;
+  flexShrink?: number;
+  flexBasis?: StyleValue;
+  gap?: StyleValue;
+  rowGap?: StyleValue;
+  columnGap?: StyleValue;
+  width?: StyleValue;
+  height?: StyleValue;
+  minWidth?: StyleValue;
+  minHeight?: StyleValue;
+  maxWidth?: StyleValue;
+  maxHeight?: StyleValue;
+  padding?: StyleValue;
+  paddingTop?: StyleValue;
+  paddingRight?: StyleValue;
+  paddingBottom?: StyleValue;
+  paddingLeft?: StyleValue;
+  margin?: StyleValue;
+  marginTop?: StyleValue;
+  marginRight?: StyleValue;
+  marginBottom?: StyleValue;
+  marginLeft?: StyleValue;
+  position?: 'relative' | 'absolute' | 'fixed' | 'sticky' | 'static';
+  top?: StyleValue;
+  right?: StyleValue;
+  bottom?: StyleValue;
+  left?: StyleValue;
+  overflow?: 'visible' | 'hidden' | 'scroll' | 'auto';
+  zIndex?: number;
+  backgroundColor?: string;
+  opacity?: number;
+  borderRadius?: StyleValue;
+  borderWidth?: StyleValue;
+  borderColor?: string;
+  borderStyle?: 'solid' | 'dashed' | 'dotted' | 'none';
+  boxShadow?: string;
+  color?: string;
+  fontSize?: StyleValue;
+  fontWeight?: number | string;
+  fontFamily?: string;
+  lineHeight?: StyleValue;
+  letterSpacing?: StyleValue;
+  textAlign?: 'left' | 'center' | 'right' | 'justify';
+  textDecoration?: string;
+  transform?: string;
+  cursor?: string;
+}
+/** A style or a (possibly nested) list of styles with falsy entries dropped — `flattenStyle` merges it. */
+type StyleInput = StyleObject | false | null | undefined | StyleInput[];
+/**
+ * Merge a {@link StyleInput} (a style, or an array of styles with `false`/`null`/`undefined`
+ * entries skipped) into one {@link StyleObject}; later entries win. Lets conditional styles
+ * compose: `flattenStyle([base, active && activeStyle, props.style])`.
+ */
+declare function flattenStyle(input: StyleInput): StyleObject;
+//#endregion
+export { StyleInput, StyleObject, StyleValue, flattenStyle };
+//# sourceMappingURL=style.d.ts.map

package/dist/style.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"style.d.ts","names":[],"sources":["../src/style.ts"],"mappings":";;AAYA;;;;AAAsB;AAGtB;;;;;KAHY,UAAA;;UAGK,WAAA;EAEf,OAAA;EACA,aAAA;EACA,cAAA;EAOA,UAAA;EACA,SAAA;EACA,QAAA;EACA,IAAA;EACA,QAAA;EACA,UAAA;EACA,SAAA,GAAY,UAAA;EACZ,GAAA,GAAM,UAAA;EACN,MAAA,GAAS,UAAA;EACT,SAAA,GAAY,UAAA;EAGZ,KAAA,GAAQ,UAAA;EACR,MAAA,GAAS,UAAA;EACT,QAAA,GAAW,UAAA;EACX,SAAA,GAAY,UAAA;EACZ,QAAA,GAAW,UAAA;EACX,SAAA,GAAY,UAAA;EACZ,OAAA,GAAU,UAAA;EACV,UAAA,GAAa,UAAA;EACb,YAAA,GAAe,UAAA;EACf,aAAA,GAAgB,UAAA;EAChB,WAAA,GAAc,UAAA;EACd,MAAA,GAAS,UAAA;EACT,SAAA,GAAY,UAAA;EACZ,WAAA,GAAc,UAAA;EACd,YAAA,GAAe,UAAA;EACf,UAAA,GAAa,UAAA;EACb,QAAA;EACA,GAAA,GAAM,UAAA;EACN,KAAA,GAAQ,UAAA;EACR,MAAA,GAAS,UAAA;EACT,IAAA,GAAO,UAAA;EACP,QAAA;EACA,MAAA;EAGA,eAAA;EACA,OAAA;EACA,YAAA,GAAe,UAAA;EACf,WAAA,GAAc,UAAA;EACd,WAAA;EACA,WAAA;EACA,SAAA;EAGA,KAAA;EACA,QAAA,GAAW,UAAA;EACX,UAAA;EACA,UAAA;EACA,UAAA,GAAa,UAAA;EACb,aAAA,GAAgB,UAAA;EAChB,SAAA;EACA,cAAA;EAGA,SAAA;EACA,MAAA;AAAA;;KAIU,UAAA,GAAa,WAAA,8BAAyC,UAAU;;;;;;iBAO5D,YAAA,CAAa,KAAA,EAAO,UAAA,GAAa,WAAW"}

package/dist/style.js

@@ -0,0 +1,23 @@
+//#region src/style.ts
+/**
+* Merge a {@link StyleInput} (a style, or an array of styles with `false`/`null`/`undefined`
+* entries skipped) into one {@link StyleObject}; later entries win. Lets conditional styles
+* compose: `flattenStyle([base, active && activeStyle, props.style])`.
+*/
+function flattenStyle(input) {
+	const out = {};
+	const visit = (value) => {
+		if (!value) return;
+		if (Array.isArray(value)) {
+			for (const v of value) visit(v);
+			return;
+		}
+		Object.assign(out, value);
+	};
+	visit(input);
+	return out;
+}
+//#endregion
+export { flattenStyle };
+
+//# sourceMappingURL=style.js.map

package/dist/style.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"style.js","names":[],"sources":["../src/style.ts"],"sourcesContent":["/**\n * Atlas styling — a curated, typed `StyleObject` that is the single cross-platform style\n * vehicle. The renderer applies one `style` object to web inline styles (numbers → `px` for\n * dimensional props) and serializes the same object as a native prop, so Atlas never needs a\n * second channel. The subset is hand-picked to be meaningful on **both** web and native;\n * anything outside it goes through the explicit `unsafeStyle` escape hatch. See\n * `docs/adr/0022-atlas-primitives.md`.\n *\n * @module\n */\n\n/** A single style value: a string (e.g. `'red'`, `'50%'`) or a number (px on web, dp on native). */\nexport type StyleValue = string | number\n\n/** A curated, cross-platform-meaningful style object. */\nexport interface StyleObject {\n  // Flexbox layout\n  display?: 'flex' | 'none'\n  flexDirection?: 'row' | 'column' | 'row-reverse' | 'column-reverse'\n  justifyContent?:\n    | 'flex-start'\n    | 'flex-end'\n    | 'center'\n    | 'space-between'\n    | 'space-around'\n    | 'space-evenly'\n  alignItems?: 'flex-start' | 'flex-end' | 'center' | 'stretch' | 'baseline'\n  alignSelf?: 'auto' | 'flex-start' | 'flex-end' | 'center' | 'stretch' | 'baseline'\n  flexWrap?: 'wrap' | 'nowrap' | 'wrap-reverse'\n  flex?: number | string\n  flexGrow?: number\n  flexShrink?: number\n  flexBasis?: StyleValue\n  gap?: StyleValue\n  rowGap?: StyleValue\n  columnGap?: StyleValue\n\n  // Box model\n  width?: StyleValue\n  height?: StyleValue\n  minWidth?: StyleValue\n  minHeight?: StyleValue\n  maxWidth?: StyleValue\n  maxHeight?: StyleValue\n  padding?: StyleValue\n  paddingTop?: StyleValue\n  paddingRight?: StyleValue\n  paddingBottom?: StyleValue\n  paddingLeft?: StyleValue\n  margin?: StyleValue\n  marginTop?: StyleValue\n  marginRight?: StyleValue\n  marginBottom?: StyleValue\n  marginLeft?: StyleValue\n  position?: 'relative' | 'absolute' | 'fixed' | 'sticky' | 'static'\n  top?: StyleValue\n  right?: StyleValue\n  bottom?: StyleValue\n  left?: StyleValue\n  overflow?: 'visible' | 'hidden' | 'scroll' | 'auto'\n  zIndex?: number\n\n  // Visual\n  backgroundColor?: string\n  opacity?: number\n  borderRadius?: StyleValue\n  borderWidth?: StyleValue\n  borderColor?: string\n  borderStyle?: 'solid' | 'dashed' | 'dotted' | 'none'\n  boxShadow?: string\n\n  // Text\n  color?: string\n  fontSize?: StyleValue\n  fontWeight?: number | string\n  fontFamily?: string\n  lineHeight?: StyleValue\n  letterSpacing?: StyleValue\n  textAlign?: 'left' | 'center' | 'right' | 'justify'\n  textDecoration?: string\n\n  // Transform / interaction (web-leaning but harmless on native)\n  transform?: string\n  cursor?: string\n}\n\n/** A style or a (possibly nested) list of styles with falsy entries dropped — `flattenStyle` merges it. */\nexport type StyleInput = StyleObject | false | null | undefined | StyleInput[]\n\n/**\n * Merge a {@link StyleInput} (a style, or an array of styles with `false`/`null`/`undefined`\n * entries skipped) into one {@link StyleObject}; later entries win. Lets conditional styles\n * compose: `flattenStyle([base, active && activeStyle, props.style])`.\n */\nexport function flattenStyle(input: StyleInput): StyleObject {\n  const out: StyleObject = {}\n  const visit = (value: StyleInput): void => {\n    if (!value) return\n    if (Array.isArray(value)) {\n      for (const v of value) visit(v)\n      return\n    }\n    Object.assign(out, value)\n  }\n  visit(input)\n  return out\n}\n"],"mappings":";;;;;;AA8FA,SAAgB,aAAa,OAAgC;CAC3D,MAAM,MAAmB,CAAC;CAC1B,MAAM,SAAS,UAA4B;EACzC,IAAI,CAAC,OAAO;EACZ,IAAI,MAAM,QAAQ,KAAK,GAAG;GACxB,KAAK,MAAM,KAAK,OAAO,MAAM,CAAC;GAC9B;EACF;EACA,OAAO,OAAO,KAAK,KAAK;CAC1B;CACA,MAAM,KAAK;CACX,OAAO;AACT"}

package/dist/theme.d.ts

@@ -0,0 +1,54 @@
+import { Context, ContextProvider } from "@mindees/core";
+
+//#region src/theme.d.ts
+/** A design-token theme. External token packages can satisfy this shape. */
+interface ThemeTokens {
+  readonly colors: {
+    readonly background: string;
+    readonly surface: string;
+    readonly text: string;
+    readonly textMuted: string;
+    readonly primary: string;
+    readonly onPrimary: string;
+    readonly border: string;
+    readonly danger: string;
+  };
+  /** Spacing scale (px), index 0 = none. */
+  readonly space: readonly number[];
+  readonly radii: {
+    readonly sm: number;
+    readonly md: number;
+    readonly lg: number;
+    readonly full: number;
+  };
+  readonly fontSizes: {
+    readonly sm: number;
+    readonly md: number;
+    readonly lg: number;
+    readonly xl: number;
+  };
+  readonly fontWeights: {
+    readonly regular: number;
+    readonly medium: number;
+    readonly bold: number;
+  };
+}
+/** A sensible, neutral default theme so Atlas works standalone. */
+declare const defaultTokens: ThemeTokens;
+/** The Atlas theme context (defaults to {@link defaultTokens}). */
+declare const ThemeContext: Context<ThemeTokens>;
+/** One-level-deep partial of the token groups (arrays are replaced wholesale, not deep-partialed). */
+type DeepPartial<T> = { [K in keyof T]?: T[K] extends ReadonlyArray<unknown> ? T[K] : T[K] extends object ? Partial<T[K]> : T[K] };
+/**
+ * Create a theme provider. Pass partial overrides (deep-merged one level onto the defaults) or
+ * nothing for the defaults. Use `.select(t => …)` for a reactive, isolated token accessor that
+ * a primitive consumes as a `Reactive<StyleObject>`.
+ *
+ * @example
+ * const theme = createTheme({ colors: { primary: '#7c3aed' } })
+ * const accent = theme.select((t) => t.colors.primary)
+ */
+declare function createTheme(overrides?: DeepPartial<ThemeTokens>): ContextProvider<ThemeTokens>;
+//#endregion
+export { ThemeContext, ThemeTokens, createTheme, defaultTokens };
+//# sourceMappingURL=theme.d.ts.map

package/dist/theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.d.ts","names":[],"sources":["../src/theme.ts"],"mappings":";;;;UAaiB,WAAA;EAAA,SACN,MAAA;IAAA,SACE,UAAA;IAAA,SACA,OAAA;IAAA,SACA,IAAA;IAAA,SACA,SAAA;IAAA,SACA,OAAA;IAAA,SACA,SAAA;IAAA,SACA,MAAA;IAAA,SACA,MAAA;EAAA;EAUF;EAAA,SAPA,KAAA;EAAA,SACA,KAAA;IAAA,SACE,EAAA;IAAA,SACA,EAAA;IAAA,SACA,EAAA;IAAA,SACA,IAAA;EAAA;EAAA,SAEF,SAAA;IAAA,SACE,EAAA;IAAA,SACA,EAAA;IAAA,SACA,EAAA;IAAA,SACA,EAAA;EAAA;EAAA,SAEF,WAAA;IAAA,SAAwB,OAAA;IAAA,SAA0B,MAAA;IAAA,SAAyB,IAAA;EAAA;AAAA;AAsBxC;AAAA,cAlBjC,aAAA,EAAe,WAe3B;;cAGY,YAAA,EAAc,OAAO,CAAC,WAAA;;KAc9B,WAAA,oBACS,CAAA,IAAK,CAAA,CAAE,CAAA,UAAW,aAAA,YAC1B,CAAA,CAAE,CAAA,IACF,CAAA,CAAE,CAAA,mBACA,OAAA,CAAQ,CAAA,CAAE,CAAA,KACV,CAAA,CAAE,CAAA;;;;;;;;;;iBAYM,WAAA,CACd,SAAA,GAAW,WAAA,CAAY,WAAA,IACtB,eAAA,CAAgB,WAAA"}

package/dist/theme.js

@@ -0,0 +1,92 @@
+import { createContext, createProvider } from "@mindees/core";
+//#region src/theme.ts
+/**
+* Atlas theming — a structural `ThemeTokens` interface + a minimal `defaultTokens`, consumed
+* through a `@mindees/core` selector-isolated context. Atlas takes **no dependency** on any
+* tokens package (the user's published `@mindees/tokens` can satisfy `ThemeTokens` and be
+* injected by the app); a component that selects one slice (`t => t.colors.primary`) only
+* re-runs when that slice changes. See `docs/adr/0022-atlas-primitives.md`.
+*
+* @module
+*/
+/** A sensible, neutral default theme so Atlas works standalone. */
+const defaultTokens = {
+	colors: {
+		background: "#ffffff",
+		surface: "#f5f5f5",
+		text: "#111827",
+		textMuted: "#6b7280",
+		primary: "#2563eb",
+		onPrimary: "#ffffff",
+		border: "#e5e7eb",
+		danger: "#dc2626"
+	},
+	space: [
+		0,
+		4,
+		8,
+		12,
+		16,
+		24,
+		32,
+		48,
+		64
+	],
+	radii: {
+		sm: 4,
+		md: 8,
+		lg: 16,
+		full: 9999
+	},
+	fontSizes: {
+		sm: 12,
+		md: 14,
+		lg: 18,
+		xl: 24
+	},
+	fontWeights: {
+		regular: 400,
+		medium: 500,
+		bold: 700
+	}
+};
+/** The Atlas theme context (defaults to {@link defaultTokens}). */
+const ThemeContext = createContext(defaultTokens);
+/** Deep-merge (one level) token overrides onto the defaults. */
+function mergeTokens(overrides) {
+	return {
+		colors: {
+			...defaultTokens.colors,
+			...overrides.colors
+		},
+		space: overrides.space ?? defaultTokens.space,
+		radii: {
+			...defaultTokens.radii,
+			...overrides.radii
+		},
+		fontSizes: {
+			...defaultTokens.fontSizes,
+			...overrides.fontSizes
+		},
+		fontWeights: {
+			...defaultTokens.fontWeights,
+			...overrides.fontWeights
+		}
+	};
+}
+/**
+* Create a theme provider. Pass partial overrides (deep-merged one level onto the defaults) or
+* nothing for the defaults. Use `.select(t => …)` for a reactive, isolated token accessor that
+* a primitive consumes as a `Reactive<StyleObject>`.
+*
+* @example
+* const theme = createTheme({ colors: { primary: '#7c3aed' } })
+* const accent = theme.select((t) => t.colors.primary)
+*/
+function createTheme(overrides = {}) {
+	return createProvider(ThemeContext, mergeTokens(overrides));
+}
+//#endregion
+export { ThemeContext, createTheme, defaultTokens };
+
+//# sourceMappingURL=theme.js.map

package/dist/theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.js","names":[],"sources":["../src/theme.ts"],"sourcesContent":["/**\n * Atlas theming — a structural `ThemeTokens` interface + a minimal `defaultTokens`, consumed\n * through a `@mindees/core` selector-isolated context. Atlas takes **no dependency** on any\n * tokens package (the user's published `@mindees/tokens` can satisfy `ThemeTokens` and be\n * injected by the app); a component that selects one slice (`t => t.colors.primary`) only\n * re-runs when that slice changes. See `docs/adr/0022-atlas-primitives.md`.\n *\n * @module\n */\n\nimport { type Context, type ContextProvider, createContext, createProvider } from '@mindees/core'\n\n/** A design-token theme. External token packages can satisfy this shape. */\nexport interface ThemeTokens {\n  readonly colors: {\n    readonly background: string\n    readonly surface: string\n    readonly text: string\n    readonly textMuted: string\n    readonly primary: string\n    readonly onPrimary: string\n    readonly border: string\n    readonly danger: string\n  }\n  /** Spacing scale (px), index 0 = none. */\n  readonly space: readonly number[]\n  readonly radii: {\n    readonly sm: number\n    readonly md: number\n    readonly lg: number\n    readonly full: number\n  }\n  readonly fontSizes: {\n    readonly sm: number\n    readonly md: number\n    readonly lg: number\n    readonly xl: number\n  }\n  readonly fontWeights: { readonly regular: number; readonly medium: number; readonly bold: number }\n}\n\n/** A sensible, neutral default theme so Atlas works standalone. */\nexport const defaultTokens: ThemeTokens = {\n  colors: {\n    background: '#ffffff',\n    surface: '#f5f5f5',\n    text: '#111827',\n    textMuted: '#6b7280',\n    primary: '#2563eb',\n    onPrimary: '#ffffff',\n    border: '#e5e7eb',\n    danger: '#dc2626',\n  },\n  space: [0, 4, 8, 12, 16, 24, 32, 48, 64],\n  radii: { sm: 4, md: 8, lg: 16, full: 9999 },\n  fontSizes: { sm: 12, md: 14, lg: 18, xl: 24 },\n  fontWeights: { regular: 400, medium: 500, bold: 700 },\n}\n\n/** The Atlas theme context (defaults to {@link defaultTokens}). */\nexport const ThemeContext: Context<ThemeTokens> = createContext(defaultTokens)\n\n/** Deep-merge (one level) token overrides onto the defaults. */\nfunction mergeTokens(overrides: DeepPartial<ThemeTokens>): ThemeTokens {\n  return {\n    colors: { ...defaultTokens.colors, ...overrides.colors },\n    space: overrides.space ?? defaultTokens.space,\n    radii: { ...defaultTokens.radii, ...overrides.radii },\n    fontSizes: { ...defaultTokens.fontSizes, ...overrides.fontSizes },\n    fontWeights: { ...defaultTokens.fontWeights, ...overrides.fontWeights },\n  }\n}\n\n/** One-level-deep partial of the token groups (arrays are replaced wholesale, not deep-partialed). */\ntype DeepPartial<T> = {\n  [K in keyof T]?: T[K] extends ReadonlyArray<unknown>\n    ? T[K]\n    : T[K] extends object\n      ? Partial<T[K]>\n      : T[K]\n}\n\n/**\n * Create a theme provider. Pass partial overrides (deep-merged one level onto the defaults) or\n * nothing for the defaults. Use `.select(t => …)` for a reactive, isolated token accessor that\n * a primitive consumes as a `Reactive<StyleObject>`.\n *\n * @example\n * const theme = createTheme({ colors: { primary: '#7c3aed' } })\n * const accent = theme.select((t) => t.colors.primary)\n */\nexport function createTheme(\n  overrides: DeepPartial<ThemeTokens> = {},\n): ContextProvider<ThemeTokens> {\n  return createProvider(ThemeContext, mergeTokens(overrides))\n}\n"],"mappings":";;;;;;;;;;;;AA0CA,MAAa,gBAA6B;CACxC,QAAQ;EACN,YAAY;EACZ,SAAS;EACT,MAAM;EACN,WAAW;EACX,SAAS;EACT,WAAW;EACX,QAAQ;EACR,QAAQ;CACV;CACA,OAAO;EAAC;EAAG;EAAG;EAAG;EAAI;EAAI;EAAI;EAAI;EAAI;CAAE;CACvC,OAAO;EAAE,IAAI;EAAG,IAAI;EAAG,IAAI;EAAI,MAAM;CAAK;CAC1C,WAAW;EAAE,IAAI;EAAI,IAAI;EAAI,IAAI;EAAI,IAAI;CAAG;CAC5C,aAAa;EAAE,SAAS;EAAK,QAAQ;EAAK,MAAM;CAAI;AACtD;;AAGA,MAAa,eAAqC,cAAc,aAAa;;AAG7E,SAAS,YAAY,WAAkD;CACrE,OAAO;EACL,QAAQ;GAAE,GAAG,cAAc;GAAQ,GAAG,UAAU;EAAO;EACvD,OAAO,UAAU,SAAS,cAAc;EACxC,OAAO;GAAE,GAAG,cAAc;GAAO,GAAG,UAAU;EAAM;EACpD,WAAW;GAAE,GAAG,cAAc;GAAW,GAAG,UAAU;EAAU;EAChE,aAAa;GAAE,GAAG,cAAc;GAAa,GAAG,UAAU;EAAY;CACxE;AACF;;;;;;;;;;AAoBA,SAAgB,YACd,YAAsC,CAAC,GACT;CAC9B,OAAO,eAAe,cAAc,YAAY,SAAS,CAAC;AAC5D"}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@mindees/atlas",
+  "version": "0.1.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",
+  "sideEffects": false,
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./theme": {
+      "types": "./dist/theme.d.ts",
+      "import": "./dist/theme.js"
+    },
+    "./list": {
+      "types": "./dist/list.d.ts",
+      "import": "./dist/list.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mindees/mindees.git",
+    "directory": "packages/atlas"
+  },
+  "dependencies": {
+    "@mindees/core": "0.1.0"
+  },
+  "devDependencies": {
+    "happy-dom": "20.9.0",
+    "@mindees/renderer": "0.1.0"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "typecheck": "tsc --noEmit"
+  }
+}