@oxyhq/bloom 0.79.1 → 0.81.0

package/lib/typescript/commonjs/scroll/scrollable.web.d.ts

@@ -8,17 +8,30 @@ export interface ResolvedScroller {
     getOffset: () => number;
     setOffset: (offset: number) => void;
     /**
-     * Whether the scroll container can currently hold a non-zero offset, i.e.
-     * its content is taller than its viewport (`scrollHeight > clientHeight`).
+     * The largest offset the container can currently hold — `scrollHeight -
+     * clientHeight`, clamped at 0. Answers two questions the save path needs:
+     * whether a 0 read is real (`maxOffset > 0`) and whether an offset is sitting
+     * exactly at the bottom, which is the signature of a browser clamp.
      *
      * React Navigation's web stack collapses a hidden background screen so its
      * content height drops to the viewport height; while collapsed the container
      * cannot be scrolled and its `scrollTop` is forced to 0. The hook uses this
      * to ignore a spurious 0 read coming from a collapsed container rather than
-     * persisting it over a previously-saved good offset. The `'window'` scroller
-     * is never collapsed by the navigator, so it always reports `true`.
+     * persisting it over a previously-saved good offset.
+     *
+     * The DOCUMENT collapses the same way, so the `'window'` sentinel answers the
+     * same question honestly rather than hardcoding `true`. It used to, on the
+     * premise that the navigator never collapses the document — false under a
+     * tabbed navigator, where every tab stays MOUNTED and non-focused ones are
+     * `display: none` (expo-router's `ui/TabSlot`, and react-native-screens' web
+     * `Screen` at `activityState === 0`). Measured in Chrome 150: switching from
+     * a tall tab to a short one drops `documentElement.scrollHeight` from 8040 to
+     * the 800px viewport, forces `scrollY` to 0 and dispatches two `scroll`
+     * events — which the outgoing tab's still-attached listener would otherwise
+     * persist as 0 over its real offset, because blur is emitted from an effect
+     * that has not run yet.
      */
-    canScroll: () => boolean;
+    getMaxOffset: () => number;
 }
 /**
  * Build a {@link ResolvedScroller} for a target. The window sentinel reads and

package/lib/typescript/commonjs/scroll/scrollable.web.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scrollable.web.d.ts","sourceRoot":"","sources":["../../../../src/scroll/scrollable.web.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAoB,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAEzE;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,MAAM,CAAC;IACxB,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC;;;;;;;;;;OAUG;IACH,SAAS,EAAE,MAAM,OAAO,CAAC;CAC1B;AAuCD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,uBAAuB,GAAG,gBAAgB,CAyBhF"}
+{"version":3,"file":"scrollable.web.d.ts","sourceRoot":"","sources":["../../../../src/scroll/scrollable.web.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAoB,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAEzE;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,MAAM,CAAC;IACxB,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,YAAY,EAAE,MAAM,MAAM,CAAC;CAC5B;AAuCD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,uBAAuB,GAAG,gBAAgB,CAkChF"}

package/lib/typescript/commonjs/tabs/Tabs.d.ts

@@ -1,6 +1,46 @@
 import React from 'react';
 import type { TabsProps, TabsTriggerProps, TabsContentProps } from './types';
-export declare const Tabs: React.NamedExoticComponent<TabsProps>;
+/**
+ * The imperative surface a horizontal drag gesture drives the underline through.
+ *
+ * It lives here rather than in the gesture's own code because every quantity the
+ * drag needs — where the neighbouring trigger is, how wide it is, whether there
+ * IS a neighbour — is measured layout the strip already holds and nothing
+ * outside it can see. The gesture supplies one number, the finger's delta; the
+ * strip decides what that means.
+ *
+ * Obtained via a `ref` on `Tabs`. The gesture belongs in the LAYOUT beside the
+ * strip, never inside a tab screen — a gesture mounted in a screen is destroyed
+ * by the navigation it commits, mid-release.
+ */
+export interface TabsDragController {
+    /**
+     * Feed the raw horizontal finger delta (`translationX`).
+     *
+     * The underline travels OPPOSITE the finger, because that is where the
+     * incoming tab is: dragging left reveals the NEXT tab, which sits to the
+     * right. Travel is clamped at the neighbour — the underline stops exactly
+     * where it would land, so it never promises more than the release delivers —
+     * and at the first/last tab it rubber-bands instead.
+     *
+     * Returns the value that releasing NOW would commit, or `null` for "no
+     * commit": either the drag has not passed the threshold, or there is no
+     * neighbour in that direction.
+     */
+    drag(translationX: number): string | null;
+    /**
+     * End the drag. Pass the value `drag` last returned to keep the underline
+     * where the finger left it while the caller navigates; pass `null` to spring
+     * it home.
+     *
+     * On a commit the offset is FOLDED into the underline's base position rather
+     * than zeroed, so the focus change that follows springs from where the finger
+     * actually let go. Zeroing first would snap backwards for a frame and then
+     * animate forwards from the wrong place.
+     */
+    release(committed: string | null): void;
+}
+export declare const Tabs: React.NamedExoticComponent<TabsProps & React.RefAttributes<TabsDragController>>;
 export declare const TabsTrigger: React.NamedExoticComponent<TabsTriggerProps>;
 export declare const TabsContent: React.NamedExoticComponent<TabsContentProps>;
 //# sourceMappingURL=Tabs.d.ts.map

package/lib/typescript/commonjs/tabs/Tabs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Tabs.d.ts","sourceRoot":"","sources":["../../../../src/tabs/Tabs.tsx"],"names":[],"mappings":"AAAA,OAAO,KAQN,MAAM,OAAO,CAAC;AAiBf,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,gBAAgB,EAAe,MAAM,SAAS,CAAC;AA4Q1F,eAAO,MAAM,IAAI,uCAAyB,CAAC;AAG3C,eAAO,MAAM,WAAW,8CAAqB,CAAC;AAG9C,eAAO,MAAM,WAAW,8CAA0B,CAAC"}
+{"version":3,"file":"Tabs.d.ts","sourceRoot":"","sources":["../../../../src/tabs/Tabs.tsx"],"names":[],"mappings":"AAAA,OAAO,KAUN,MAAM,OAAO,CAAC;AA4Bf,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,gBAAgB,EAAe,MAAM,SAAS,CAAC;AA0E1F;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;;;;;;;;OAYG;IACH,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC1C;;;;;;;;;OASG;IACH,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;CACzC;AAikBD,eAAO,MAAM,IAAI,iFAAyB,CAAC;AAG3C,eAAO,MAAM,WAAW,8CAAqB,CAAC;AAG9C,eAAO,MAAM,WAAW,8CAA0B,CAAC"}

package/lib/typescript/commonjs/tabs/expo-router/RouterTabs.d.ts

@@ -0,0 +1,80 @@
+/**
+ * expo-router bindings for the in-screen tab strip.
+ *
+ * This subpath (`@oxyhq/bloom/tabs/expo-router`) is the ONLY place in the tabs
+ * feature allowed to import `expo-router`, which is why it is a separate entry:
+ * the core `@oxyhq/bloom/tabs` stays usable in an app with a different router,
+ * or none, and the optional peer is never pulled into a bundle that does not
+ * ask for it. Same split as `tab-bar` / `tab-bar/expo-router` and
+ * `scroll` / `scroll/expo-router`.
+ *
+ * Everything routing-shaped lives here on purpose: which tab the route means,
+ * what a committed swipe navigates to, and which links to warm. The strip
+ * itself stays presentational and knows only about measured geometry.
+ */
+import { type ReactNode } from 'react';
+import { type Href } from 'expo-router';
+import type { TabsProps } from '../types';
+export interface RouterTabItem {
+    /** Stable id for the tab. Used as a React key and a callback argument. */
+    value: string;
+    /** Tab label text. */
+    label: string;
+    /** The route this tab shows. Must be the tab's EXACT path. */
+    href: Href;
+    /** Icon rendered before the label. */
+    icon?: ReactNode;
+    /** Optional tally beside the label; `0` or omitted renders nothing. */
+    count?: number;
+    disabled?: boolean;
+}
+export type RouterTabsProps = Omit<TabsProps, 'value' | 'onValueChange' | 'hasSelection' | 'children'> & {
+    items: RouterTabItem[];
+    /**
+     * Called instead of navigating when the ALREADY-active tab is pressed.
+     *
+     * Without it a re-tap would push a second history entry for the route the
+     * user is already on, so Back would appear to do nothing. Re-tapping the
+     * active tab conventionally means "refresh" or "scroll to top", and that is
+     * the caller's to define.
+     */
+    onReselect?: (value: string) => void;
+    /**
+     * Enable the horizontal swipe between neighbouring tabs. Defaults to `true`.
+     *
+     * The gesture is INDICATOR-LED: the underline tracks the finger toward the
+     * neighbour and commits on release past a threshold, while the content stays
+     * where it is. That asymmetry is deliberate — the underline has somewhere
+     * real to go and can complete its journey, whereas under a `<Slot/>` there is
+     * no neighbouring screen mounted to bring in, so translating the content
+     * would only open a blank gutter on the trailing edge.
+     */
+    swipeEnabled?: boolean;
+};
+/**
+ * A tab strip whose selection IS the route.
+ *
+ * Render it in the LAYOUT that owns the tabs, above the `<Slot/>` that renders
+ * them — not inside the tab screens themselves. That placement is the whole
+ * point, and it is load-bearing twice over: a strip inside the screens is
+ * unmounted and rebuilt by every navigation, so its underline has nothing to
+ * animate from and the chrome blanks while the incoming route's chunk loads;
+ * and a GESTURE inside the screens would be destroyed by the very navigation it
+ * commits, mid-release.
+ *
+ * ```tsx
+ * // app/(app)/[username]/_layout.tsx
+ * <RouterTabs
+ *   items={[
+ *     { value: 'posts', label: 'Posts', href: `/${username}` },
+ *     { value: 'replies', label: 'Replies', href: `/${username}/replies` },
+ *   ]}
+ * />
+ * <Slot />
+ * ```
+ */
+export declare function RouterTabs({ items, onReselect, swipeEnabled, ...tabsProps }: RouterTabsProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace RouterTabs {
+    var displayName: string;
+}
+//# sourceMappingURL=RouterTabs.d.ts.map

package/lib/typescript/commonjs/tabs/expo-router/RouterTabs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RouterTabs.d.ts","sourceRoot":"","sources":["../../../../../src/tabs/expo-router/RouterTabs.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAA2C,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAGhF,OAAO,EAAuB,KAAK,IAAI,EAAE,MAAM,aAAa,CAAC;AAG7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C,MAAM,WAAW,aAAa;IAC5B,0EAA0E;IAC1E,KAAK,EAAE,MAAM,CAAC;IACd,sBAAsB;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,8DAA8D;IAC9D,IAAI,EAAE,IAAI,CAAC;IACX,sCAAsC;IACtC,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,uEAAuE;IACvE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,MAAM,eAAe,GAAG,IAAI,CAChC,SAAS,EAGT,OAAO,GAAG,eAAe,GAAG,cAAc,GAAG,UAAU,CACxD,GAAG;IACF,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC;;;;;;;;;OASG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AAuCF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,UAAU,CAAC,EACzB,KAAK,EACL,UAAU,EACV,YAAmB,EACnB,GAAG,SAAS,EACb,EAAE,eAAe,2CAwIjB;yBA7Ie,UAAU"}

package/lib/typescript/commonjs/tabs/expo-router/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Entry for `@oxyhq/bloom/tabs/expo-router`. The component lives in a sibling
+ * module because this file is the published entry path and must stay stable;
+ * the split also keeps the router binding in one place, which is what the
+ * optional-peer allowlist asserts about.
+ */
+export { RouterTabs } from './RouterTabs';
+export type { RouterTabItem, RouterTabsProps } from './RouterTabs';
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/commonjs/tabs/expo-router/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/tabs/expo-router/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}

package/lib/typescript/commonjs/tabs/types.d.ts

@@ -1,10 +1,38 @@
 import type { StyleProp, ViewStyle, TextStyle } from 'react-native';
 export type TabsVariant = 'underline' | 'filled' | 'outlined';
 export interface TabsProps {
-    /** The currently selected tab value. */
-    value: string;
-    /** Called when a tab is selected. */
-    onValueChange: (value: string) => void;
+    /**
+     * The currently selected tab value — the CONTROLLED path, where the bar owns
+     * the underline and reports presses through {@link TabsProps.onValueChange}.
+     *
+     * OMIT it for the focus-driven path, where each trigger supplies its own
+     * {@link TabsTriggerProps.isFocused} and performs its own navigation. That is
+     * how `@oxyhq/bloom/tabs/expo-router` keeps the underline correct through
+     * deep links, browser Back and back gestures — none of which pass through a
+     * press handler. Providing both would put two writers on one shared value.
+     */
+    value?: string;
+    /** Called when a tab is selected. Controlled path only. */
+    onValueChange?: (value: string) => void;
+    /**
+     * Focus-driven path only: whether ANY trigger is currently focused.
+     *
+     * `false` fades the underline out where it stands. This is not the same as
+     * "the selection moved", and it is not hypothetical: a strip rendered by a
+     * LAYOUT keeps rendering while the layout's other, non-tab children are
+     * showing — a profile's `/followers` sits beside its tab routes under one
+     * layout — and without this the underline stays parked on whichever tab was
+     * last visited, asserting a selection that is not there.
+     *
+     * Fading is the whole response; the underline is deliberately NOT moved,
+     * because there is no position that means "nowhere" and travelling to a
+     * sentinel would drag it across every tab on the way out.
+     *
+     * `RouterTabs` sets it, so an app author never passes it by hand. Defaults to
+     * `true`, which is correct for the controlled path (a `value` naming no
+     * trigger simply leaves the underline where it was, as it always has).
+     */
+    hasSelection?: boolean;
     /** Visual variant for the tab bar. */
     variant?: TabsVariant;
     /**
@@ -26,8 +54,24 @@ export interface TabsTriggerProps {
     label: string;
     /** Icon rendered before the label. */
     icon?: React.ReactNode;
+    /**
+     * Optional tally rendered as a small muted number beside the label. Omitted
+     * (or `0`) renders nothing. The underline tracks the trigger's measured
+     * width, so a count never changes where it sits.
+     */
+    count?: number;
+    /**
+     * Whether the ROUTER considers this tab focused — the focus-driven path.
+     * Supplying it makes this trigger, not the bar, the writer of the shared
+     * underline, and suppresses {@link TabsProps.onValueChange} on press because
+     * navigation is then the caller's job. Leave it `undefined` on the controlled
+     * path.
+     */
+    isFocused?: boolean;
     /** Whether this tab is disabled. */
     disabled?: boolean;
+    /** Extra press handler. Runs on both paths, before any selection is reported. */
+    onPress?: () => void;
     style?: StyleProp<ViewStyle>;
     textStyle?: StyleProp<TextStyle>;
 }

package/lib/typescript/commonjs/tabs/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/tabs/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEpE,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG,QAAQ,GAAG,UAAU,CAAC;AAE9D,MAAM,WAAW,SAAS;IACxB,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,sCAAsC;IACtC,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,qDAAqD;IACrD,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,sBAAsB;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,oCAAoC;IACpC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,SAAS,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,gBAAgB;IAC/B,+CAA+C;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,qBAAqB;IACrB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;CAC9B"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/tabs/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEpE,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG,QAAQ,GAAG,UAAU,CAAC;AAE9D,MAAM,WAAW,SAAS;IACxB;;;;;;;;;OASG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC;;;;;;;;;;;;;;;;;OAiBG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,sCAAsC;IACtC,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,qDAAqD;IACrD,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,sBAAsB;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,oCAAoC;IACpC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,iFAAiF;IACjF,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,SAAS,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,gBAAgB;IAC/B,+CAA+C;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,qBAAqB;IACrB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;CAC9B"}

package/lib/typescript/commonjs/theme/color-engine/index.d.ts

@@ -10,7 +10,7 @@
 export { Hct } from './hct';
 export { TonalPalette } from './tonal-palette';
 export { DynamicScheme } from './dynamic-scheme';
-export { buildScheme, schemeVibrant, schemeExpressive, schemeTonalSpot, schemeNeutral } from './scheme-variants';
+export { buildScheme, schemeVibrant, schemeExpressive, schemeTonalSpot, schemeNeutral, schemeMonochrome } from './scheme-variants';
 export type { SchemeVariant, AccentSources } from './scheme-variants';
 export { Roles } from './color-roles';
 export type { RoleName } from './color-roles';

package/lib/typescript/commonjs/theme/color-engine/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/theme/color-engine/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAC5B,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,gBAAgB,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACjH,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACtE,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,YAAY,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,YAAY,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAChG,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAGtF,OAAO,EAAS,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAC;AAErD,OAAO,EAAe,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEpE,sEAAsE;AACtE,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAI/C;AAED,uCAAuC;AACvC,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKhD;AAED,yDAAyD;AACzD,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;AAElD,MAAM,WAAW,eAAe;IAC9B,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,wCAAwC;IACxC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,eAAe,GAAG,UAAU,CAuBpE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/theme/color-engine/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAC5B,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,gBAAgB,EAAE,eAAe,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACnI,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACtE,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,YAAY,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,YAAY,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAChG,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAGtF,OAAO,EAAS,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAC;AAErD,OAAO,EAAe,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEpE,sEAAsE;AACtE,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAI/C;AAED,uCAAuC;AACvC,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKhD;AAED,yDAAyD;AACzD,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;AAElD,MAAM,WAAW,eAAe;IAC9B,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,wCAAwC;IACxC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,eAAe,GAAG,UAAU,CAuBpE"}

package/lib/typescript/commonjs/theme/color-engine/scheme-variants.d.ts

@@ -9,7 +9,7 @@
  */
 import { DynamicScheme } from './dynamic-scheme';
 import type { Hct } from './hct';
-export type SchemeVariant = 'vivid' | 'vibrant' | 'expressive' | 'tonalSpot' | 'neutral';
+export type SchemeVariant = 'vivid' | 'vibrant' | 'expressive' | 'tonalSpot' | 'neutral' | 'monochrome';
 /**
  * Optional explicit accent seeds for a scheme. When a source HCT is supplied, its
  * palette is built from that colour itself (keeping the brand hue + chroma) instead
@@ -39,6 +39,18 @@ export declare function schemeExpressive(source: Hct, isDark: boolean, contrastL
 export declare function schemeTonalSpot(source: Hct, isDark: boolean, contrastLevel: number, accents?: AccentSources): DynamicScheme;
 /** Near-greyscale — the seed hue is present only as a whisper. */
 export declare function schemeNeutral(source: Hct, isDark: boolean, contrastLevel: number, accents?: AccentSources): DynamicScheme;
+/**
+ * No colour at all: every palette is greyscale, so the seed's hue is irrelevant
+ * and only its tone survives. This is the variant the `isMonochrome` role
+ * branches in `color-roles` were written for — they push `primary` to the far end
+ * of the scale (tone 0 on a light page, 100 on a dark one) rather than the
+ * mid-tone the chromatic curves would pick, which is what keeps a black-and-white
+ * theme from reading as a grey one.
+ *
+ * A pinned accent is ignored on purpose: honouring it would put one coloured
+ * family back into a scheme whose entire point is that nothing is coloured.
+ */
+export declare function schemeMonochrome(source: Hct, isDark: boolean, contrastLevel: number): DynamicScheme;
 /**
  * Build a scheme by variant name.
  *

package/lib/typescript/commonjs/theme/color-engine/scheme-variants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scheme-variants.d.ts","sourceRoot":"","sources":["../../../../../src/theme/color-engine/scheme-variants.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAKjC,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,SAAS,GAAG,YAAY,GAAG,WAAW,GAAG,SAAS,CAAC;AAEzF;;;;;;;GAOG;AACH,MAAM,WAAW,aAAa;IAC5B,eAAe,CAAC,EAAE,GAAG,CAAC;IACtB,cAAc,CAAC,EAAE,GAAG,CAAC;CACtB;AAoBD,uEAAuE;AACvE,wBAAgB,aAAa,CAC3B,MAAM,EAAE,GAAG,EACX,MAAM,EAAE,OAAO,EACf,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE,aAAkB,GAC1B,aAAa,CAsBf;AAED,gFAAgF;AAChF;;;;;;;GAOG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,GAAG,EACX,MAAM,EAAE,OAAO,EACf,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE,aAAkB,GAC1B,aAAa,CAsBf;AAED,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,GAAG,EACX,MAAM,EAAE,OAAO,EACf,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE,aAAkB,GAC1B,aAAa,CAsBf;AAED,yEAAyE;AACzE,wBAAgB,eAAe,CAC7B,MAAM,EAAE,GAAG,EACX,MAAM,EAAE,OAAO,EACf,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE,aAAkB,GAC1B,aAAa,CAgBf;AAED,kEAAkE;AAClE,wBAAgB,aAAa,CAC3B,MAAM,EAAE,GAAG,EACX,MAAM,EAAE,OAAO,EACf,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE,aAAkB,GAC1B,aAAa,CAgBf;AAaD;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,aAAa,EACtB,MAAM,EAAE,GAAG,EACX,MAAM,EAAE,OAAO,EACf,aAAa,SAAI,EACjB,OAAO,GAAE,aAAkB,GAC1B,aAAa,CAEf"}
+{"version":3,"file":"scheme-variants.d.ts","sourceRoot":"","sources":["../../../../../src/theme/color-engine/scheme-variants.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAKjC,MAAM,MAAM,aAAa,GACrB,OAAO,GACP,SAAS,GACT,YAAY,GACZ,WAAW,GACX,SAAS,GACT,YAAY,CAAC;AAEjB;;;;;;;GAOG;AACH,MAAM,WAAW,aAAa;IAC5B,eAAe,CAAC,EAAE,GAAG,CAAC;IACtB,cAAc,CAAC,EAAE,GAAG,CAAC;CACtB;AAoBD,uEAAuE;AACvE,wBAAgB,aAAa,CAC3B,MAAM,EAAE,GAAG,EACX,MAAM,EAAE,OAAO,EACf,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE,aAAkB,GAC1B,aAAa,CAsBf;AAED,gFAAgF;AAChF;;;;;;;GAOG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,GAAG,EACX,MAAM,EAAE,OAAO,EACf,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE,aAAkB,GAC1B,aAAa,CAsBf;AAED,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,GAAG,EACX,MAAM,EAAE,OAAO,EACf,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE,aAAkB,GAC1B,aAAa,CAsBf;AAED,yEAAyE;AACzE,wBAAgB,eAAe,CAC7B,MAAM,EAAE,GAAG,EACX,MAAM,EAAE,OAAO,EACf,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE,aAAkB,GAC1B,aAAa,CAgBf;AAED,kEAAkE;AAClE,wBAAgB,aAAa,CAC3B,MAAM,EAAE,GAAG,EACX,MAAM,EAAE,OAAO,EACf,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE,aAAkB,GAC1B,aAAa,CAgBf;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,GAAG,EACX,MAAM,EAAE,OAAO,EACf,aAAa,EAAE,MAAM,GACpB,aAAa,CAaf;AAcD;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,aAAa,EACtB,MAAM,EAAE,GAAG,EACX,MAAM,EAAE,OAAO,EACf,aAAa,SAAI,EACjB,OAAO,GAAE,aAAkB,GAC1B,aAAa,CAEf"}

package/lib/typescript/commonjs/theme/color-policy.d.ts

@@ -37,6 +37,12 @@ export interface PinnedAccents {
 }
 /** The tokens the policy owns. Everything else keeps coming from the M3 roles. */
 export type PolicyTokens = Record<string, string>;
+/**
+ * Whether a seed carries no colour to derive a theme from — the one authority for
+ * that question, so the policy and the scheme choice can never disagree about a
+ * given seed and produce a grey palette wearing chromatic surfaces.
+ */
+export declare function isColourlessSeed(seedHex: string): boolean;
 /**
  * Build the policy-owned tokens for a seed and mode.
  *

package/lib/typescript/commonjs/theme/color-policy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"color-policy.d.ts","sourceRoot":"","sources":["../../../../src/theme/color-policy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,EAAe,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAK9D,sFAAsF;AACtF,eAAO,MAAM,YAAY;;;;;CAKf,CAAC;AAEX,wFAAwF;AACxF,MAAM,WAAW,aAAa;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,kFAAkF;AAClF,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAkPlD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,OAAO,EACf,KAAK,EAAE,UAAU,EACjB,MAAM,GAAE,aAAkB,GACzB,YAAY,CAgHd"}
+{"version":3,"file":"color-policy.d.ts","sourceRoot":"","sources":["../../../../src/theme/color-policy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,EAAe,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAK9D,sFAAsF;AACtF,eAAO,MAAM,YAAY;;;;;CAKf,CAAC;AAEX,wFAAwF;AACxF,MAAM,WAAW,aAAa;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,kFAAkF;AAClF,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAiGlD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEzD;AAkKD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,OAAO,EACf,KAAK,EAAE,UAAU,EACjB,MAAM,GAAE,aAAkB,GACzB,YAAY,CA8Id"}

package/lib/typescript/commonjs/theme/color-presets.d.ts

@@ -1,5 +1,5 @@
 import type { SchemeVariant } from './color-engine';
-export type AppColorName = 'teal' | 'blue' | 'green' | 'amber' | 'yellow' | 'red' | 'purple' | 'pink' | 'sky' | 'orange' | 'mint' | 'oxy' | 'faircoin';
+export type AppColorName = 'teal' | 'blue' | 'green' | 'amber' | 'yellow' | 'red' | 'purple' | 'pink' | 'sky' | 'orange' | 'mint' | 'oxy' | 'faircoin' | 'mono';
 /**
  * A single colour preset: a brand SEED colour plus the tonal scheme variant to
  * derive its full role set with.

package/lib/typescript/commonjs/theme/color-presets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"color-presets.d.ts","sourceRoot":"","sources":["../../../../src/theme/color-presets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD,MAAM,MAAM,YAAY,GACpB,MAAM,GACN,MAAM,GACN,OAAO,GACP,OAAO,GACP,QAAQ,GACR,KAAK,GACL,QAAQ,GACR,MAAM,GACN,KAAK,GACL,QAAQ,GACR,MAAM,GACN,KAAK,GACL,UAAU,CAAC;AAEf;;;;;;;;;;GAUG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,YAAY,CAAC;IACnB,kFAAkF;IAClF,GAAG,EAAE,MAAM,CAAC;IACZ,8DAA8D;IAC9D,OAAO,EAAE,aAAa,CAAC;IACvB;;;;;;;OAOG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAElD,eAAO,MAAM,eAAe,EAAE,SAAS,YAAY,EAAsH,CAAC;AAE1K,wEAAwE;AACxE,eAAO,MAAM,mBAAmB,EAAE,SAAS,YAAY,EAAwB,CAAC;AAEhF,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAczD,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAE3D;AAED;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,YAAY,EAAE,cAAc,CAclE,CAAC"}
+{"version":3,"file":"color-presets.d.ts","sourceRoot":"","sources":["../../../../src/theme/color-presets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD,MAAM,MAAM,YAAY,GACpB,MAAM,GACN,MAAM,GACN,OAAO,GACP,OAAO,GACP,QAAQ,GACR,KAAK,GACL,QAAQ,GACR,MAAM,GACN,KAAK,GACL,QAAQ,GACR,MAAM,GACN,KAAK,GACL,UAAU,GACV,MAAM,CAAC;AAEX;;;;;;;;;;GAUG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,YAAY,CAAC;IACnB,kFAAkF;IAClF,GAAG,EAAE,MAAM,CAAC;IACZ,8DAA8D;IAC9D,OAAO,EAAE,aAAa,CAAC;IACvB;;;;;;;OAOG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAElD,eAAO,MAAM,eAAe,EAAE,SAAS,YAAY,EAA8H,CAAC;AAElL,wEAAwE;AACxE,eAAO,MAAM,mBAAmB,EAAE,SAAS,YAAY,EAAwB,CAAC;AAEhF,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAezD,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAE3D;AAED;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,YAAY,EAAE,cAAc,CAqBlE,CAAC"}

package/lib/typescript/commonjs/theme/color-scope/seed-scope.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"seed-scope.d.ts","sourceRoot":"","sources":["../../../../../src/theme/color-scope/seed-scope.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,UAAU,EAAE,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAI1F;;;;;;;;;;;;;GAaG;AACH,wBAAgB,wBAAwB,CAAC,CAAC,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA4C9E;AAED,mEAAmE;AACnE,MAAM,WAAW,gBAAgB;IAC/B,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC;IACvB;;;;OAIG;IACH,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,uDAAuD;IACvD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA+BpF"}
+{"version":3,"file":"seed-scope.d.ts","sourceRoot":"","sources":["../../../../../src/theme/color-scope/seed-scope.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,UAAU,EAAE,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAI1F;;;;;;;;;;;;;GAaG;AACH,wBAAgB,wBAAwB,CAAC,CAAC,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA4C9E;AAED,mEAAmE;AACnE,MAAM,WAAW,gBAAgB;IAC/B,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC;IACvB;;;;OAIG;IACH,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,uDAAuD;IACvD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAmCpF"}

package/lib/typescript/module/scroll/index.web.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.web.d.ts","sourceRoot":"","sources":["../../../../src/scroll/index.web.tsx"],"names":[],"mappings":"AA6CA,OAAO,KAAK,EACV,wBAAwB,EACxB,uBAAuB,EACvB,2BAA2B,EAC5B,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,yBAAyB,EAAE,MAAM,WAAW,CAAC;AAEtD,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,wBAAwB,EACxB,8BAA8B,EAC9B,uBAAuB,EACvB,mBAAmB,EACnB,2BAA2B,GAC5B,MAAM,SAAS,CAAC;AA0DjB;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,uBAAuB,EAC/B,OAAO,CAAC,EAAE,2BAA2B,GACpC,wBAAwB,CA4J1B"}
+{"version":3,"file":"index.web.d.ts","sourceRoot":"","sources":["../../../../src/scroll/index.web.tsx"],"names":[],"mappings":"AA6CA,OAAO,KAAK,EACV,wBAAwB,EACxB,uBAAuB,EACvB,2BAA2B,EAC5B,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,yBAAyB,EAAE,MAAM,WAAW,CAAC;AAEtD,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,wBAAwB,EACxB,8BAA8B,EAC9B,uBAAuB,EACvB,mBAAmB,EACnB,2BAA2B,GAC5B,MAAM,SAAS,CAAC;AA0DjB;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,uBAAuB,EAC/B,OAAO,CAAC,EAAE,2BAA2B,GACpC,wBAAwB,CAgM1B"}

package/lib/typescript/module/scroll/scrollable.web.d.ts

@@ -8,17 +8,30 @@ export interface ResolvedScroller {
     getOffset: () => number;
     setOffset: (offset: number) => void;
     /**
-     * Whether the scroll container can currently hold a non-zero offset, i.e.
-     * its content is taller than its viewport (`scrollHeight > clientHeight`).
+     * The largest offset the container can currently hold — `scrollHeight -
+     * clientHeight`, clamped at 0. Answers two questions the save path needs:
+     * whether a 0 read is real (`maxOffset > 0`) and whether an offset is sitting
+     * exactly at the bottom, which is the signature of a browser clamp.
      *
      * React Navigation's web stack collapses a hidden background screen so its
      * content height drops to the viewport height; while collapsed the container
      * cannot be scrolled and its `scrollTop` is forced to 0. The hook uses this
      * to ignore a spurious 0 read coming from a collapsed container rather than
-     * persisting it over a previously-saved good offset. The `'window'` scroller
-     * is never collapsed by the navigator, so it always reports `true`.
+     * persisting it over a previously-saved good offset.
+     *
+     * The DOCUMENT collapses the same way, so the `'window'` sentinel answers the
+     * same question honestly rather than hardcoding `true`. It used to, on the
+     * premise that the navigator never collapses the document — false under a
+     * tabbed navigator, where every tab stays MOUNTED and non-focused ones are
+     * `display: none` (expo-router's `ui/TabSlot`, and react-native-screens' web
+     * `Screen` at `activityState === 0`). Measured in Chrome 150: switching from
+     * a tall tab to a short one drops `documentElement.scrollHeight` from 8040 to
+     * the 800px viewport, forces `scrollY` to 0 and dispatches two `scroll`
+     * events — which the outgoing tab's still-attached listener would otherwise
+     * persist as 0 over its real offset, because blur is emitted from an effect
+     * that has not run yet.
      */
-    canScroll: () => boolean;
+    getMaxOffset: () => number;
 }
 /**
  * Build a {@link ResolvedScroller} for a target. The window sentinel reads and

package/lib/typescript/module/scroll/scrollable.web.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scrollable.web.d.ts","sourceRoot":"","sources":["../../../../src/scroll/scrollable.web.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAoB,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAEzE;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,MAAM,CAAC;IACxB,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC;;;;;;;;;;OAUG;IACH,SAAS,EAAE,MAAM,OAAO,CAAC;CAC1B;AAuCD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,uBAAuB,GAAG,gBAAgB,CAyBhF"}
+{"version":3,"file":"scrollable.web.d.ts","sourceRoot":"","sources":["../../../../src/scroll/scrollable.web.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAoB,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAEzE;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,MAAM,CAAC;IACxB,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,YAAY,EAAE,MAAM,MAAM,CAAC;CAC5B;AAuCD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,uBAAuB,GAAG,gBAAgB,CAkChF"}

package/lib/typescript/module/tabs/Tabs.d.ts

@@ -1,6 +1,46 @@
 import React from 'react';
 import type { TabsProps, TabsTriggerProps, TabsContentProps } from './types';
-export declare const Tabs: React.NamedExoticComponent<TabsProps>;
+/**
+ * The imperative surface a horizontal drag gesture drives the underline through.
+ *
+ * It lives here rather than in the gesture's own code because every quantity the
+ * drag needs — where the neighbouring trigger is, how wide it is, whether there
+ * IS a neighbour — is measured layout the strip already holds and nothing
+ * outside it can see. The gesture supplies one number, the finger's delta; the
+ * strip decides what that means.
+ *
+ * Obtained via a `ref` on `Tabs`. The gesture belongs in the LAYOUT beside the
+ * strip, never inside a tab screen — a gesture mounted in a screen is destroyed
+ * by the navigation it commits, mid-release.
+ */
+export interface TabsDragController {
+    /**
+     * Feed the raw horizontal finger delta (`translationX`).
+     *
+     * The underline travels OPPOSITE the finger, because that is where the
+     * incoming tab is: dragging left reveals the NEXT tab, which sits to the
+     * right. Travel is clamped at the neighbour — the underline stops exactly
+     * where it would land, so it never promises more than the release delivers —
+     * and at the first/last tab it rubber-bands instead.
+     *
+     * Returns the value that releasing NOW would commit, or `null` for "no
+     * commit": either the drag has not passed the threshold, or there is no
+     * neighbour in that direction.
+     */
+    drag(translationX: number): string | null;
+    /**
+     * End the drag. Pass the value `drag` last returned to keep the underline
+     * where the finger left it while the caller navigates; pass `null` to spring
+     * it home.
+     *
+     * On a commit the offset is FOLDED into the underline's base position rather
+     * than zeroed, so the focus change that follows springs from where the finger
+     * actually let go. Zeroing first would snap backwards for a frame and then
+     * animate forwards from the wrong place.
+     */
+    release(committed: string | null): void;
+}
+export declare const Tabs: React.NamedExoticComponent<TabsProps & React.RefAttributes<TabsDragController>>;
 export declare const TabsTrigger: React.NamedExoticComponent<TabsTriggerProps>;
 export declare const TabsContent: React.NamedExoticComponent<TabsContentProps>;
 //# sourceMappingURL=Tabs.d.ts.map

package/lib/typescript/module/tabs/Tabs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Tabs.d.ts","sourceRoot":"","sources":["../../../../src/tabs/Tabs.tsx"],"names":[],"mappings":"AAAA,OAAO,KAQN,MAAM,OAAO,CAAC;AAiBf,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,gBAAgB,EAAe,MAAM,SAAS,CAAC;AA4Q1F,eAAO,MAAM,IAAI,uCAAyB,CAAC;AAG3C,eAAO,MAAM,WAAW,8CAAqB,CAAC;AAG9C,eAAO,MAAM,WAAW,8CAA0B,CAAC"}
+{"version":3,"file":"Tabs.d.ts","sourceRoot":"","sources":["../../../../src/tabs/Tabs.tsx"],"names":[],"mappings":"AAAA,OAAO,KAUN,MAAM,OAAO,CAAC;AA4Bf,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,gBAAgB,EAAe,MAAM,SAAS,CAAC;AA0E1F;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;;;;;;;;OAYG;IACH,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC1C;;;;;;;;;OASG;IACH,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;CACzC;AAikBD,eAAO,MAAM,IAAI,iFAAyB,CAAC;AAG3C,eAAO,MAAM,WAAW,8CAAqB,CAAC;AAG9C,eAAO,MAAM,WAAW,8CAA0B,CAAC"}

package/lib/typescript/module/tabs/expo-router/RouterTabs.d.ts

@@ -0,0 +1,80 @@
+/**
+ * expo-router bindings for the in-screen tab strip.
+ *
+ * This subpath (`@oxyhq/bloom/tabs/expo-router`) is the ONLY place in the tabs
+ * feature allowed to import `expo-router`, which is why it is a separate entry:
+ * the core `@oxyhq/bloom/tabs` stays usable in an app with a different router,
+ * or none, and the optional peer is never pulled into a bundle that does not
+ * ask for it. Same split as `tab-bar` / `tab-bar/expo-router` and
+ * `scroll` / `scroll/expo-router`.
+ *
+ * Everything routing-shaped lives here on purpose: which tab the route means,
+ * what a committed swipe navigates to, and which links to warm. The strip
+ * itself stays presentational and knows only about measured geometry.
+ */
+import { type ReactNode } from 'react';
+import { type Href } from 'expo-router';
+import type { TabsProps } from '../types';
+export interface RouterTabItem {
+    /** Stable id for the tab. Used as a React key and a callback argument. */
+    value: string;
+    /** Tab label text. */
+    label: string;
+    /** The route this tab shows. Must be the tab's EXACT path. */
+    href: Href;
+    /** Icon rendered before the label. */
+    icon?: ReactNode;
+    /** Optional tally beside the label; `0` or omitted renders nothing. */
+    count?: number;
+    disabled?: boolean;
+}
+export type RouterTabsProps = Omit<TabsProps, 'value' | 'onValueChange' | 'hasSelection' | 'children'> & {
+    items: RouterTabItem[];
+    /**
+     * Called instead of navigating when the ALREADY-active tab is pressed.
+     *
+     * Without it a re-tap would push a second history entry for the route the
+     * user is already on, so Back would appear to do nothing. Re-tapping the
+     * active tab conventionally means "refresh" or "scroll to top", and that is
+     * the caller's to define.
+     */
+    onReselect?: (value: string) => void;
+    /**
+     * Enable the horizontal swipe between neighbouring tabs. Defaults to `true`.
+     *
+     * The gesture is INDICATOR-LED: the underline tracks the finger toward the
+     * neighbour and commits on release past a threshold, while the content stays
+     * where it is. That asymmetry is deliberate — the underline has somewhere
+     * real to go and can complete its journey, whereas under a `<Slot/>` there is
+     * no neighbouring screen mounted to bring in, so translating the content
+     * would only open a blank gutter on the trailing edge.
+     */
+    swipeEnabled?: boolean;
+};
+/**
+ * A tab strip whose selection IS the route.
+ *
+ * Render it in the LAYOUT that owns the tabs, above the `<Slot/>` that renders
+ * them — not inside the tab screens themselves. That placement is the whole
+ * point, and it is load-bearing twice over: a strip inside the screens is
+ * unmounted and rebuilt by every navigation, so its underline has nothing to
+ * animate from and the chrome blanks while the incoming route's chunk loads;
+ * and a GESTURE inside the screens would be destroyed by the very navigation it
+ * commits, mid-release.
+ *
+ * ```tsx
+ * // app/(app)/[username]/_layout.tsx
+ * <RouterTabs
+ *   items={[
+ *     { value: 'posts', label: 'Posts', href: `/${username}` },
+ *     { value: 'replies', label: 'Replies', href: `/${username}/replies` },
+ *   ]}
+ * />
+ * <Slot />
+ * ```
+ */
+export declare function RouterTabs({ items, onReselect, swipeEnabled, ...tabsProps }: RouterTabsProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace RouterTabs {
+    var displayName: string;
+}
+//# sourceMappingURL=RouterTabs.d.ts.map

package/lib/typescript/module/tabs/expo-router/RouterTabs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RouterTabs.d.ts","sourceRoot":"","sources":["../../../../../src/tabs/expo-router/RouterTabs.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAA2C,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAGhF,OAAO,EAAuB,KAAK,IAAI,EAAE,MAAM,aAAa,CAAC;AAG7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C,MAAM,WAAW,aAAa;IAC5B,0EAA0E;IAC1E,KAAK,EAAE,MAAM,CAAC;IACd,sBAAsB;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,8DAA8D;IAC9D,IAAI,EAAE,IAAI,CAAC;IACX,sCAAsC;IACtC,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,uEAAuE;IACvE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,MAAM,eAAe,GAAG,IAAI,CAChC,SAAS,EAGT,OAAO,GAAG,eAAe,GAAG,cAAc,GAAG,UAAU,CACxD,GAAG;IACF,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC;;;;;;;;;OASG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AAuCF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,UAAU,CAAC,EACzB,KAAK,EACL,UAAU,EACV,YAAmB,EACnB,GAAG,SAAS,EACb,EAAE,eAAe,2CAwIjB;yBA7Ie,UAAU"}

package/lib/typescript/module/tabs/expo-router/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Entry for `@oxyhq/bloom/tabs/expo-router`. The component lives in a sibling
+ * module because this file is the published entry path and must stay stable;
+ * the split also keeps the router binding in one place, which is what the
+ * optional-peer allowlist asserts about.
+ */
+export { RouterTabs } from './RouterTabs';
+export type { RouterTabItem, RouterTabsProps } from './RouterTabs';
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/module/tabs/expo-router/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/tabs/expo-router/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}