@omerdlw/base-framework 1.0.3 → 1.0.5

package/docs/modules/ambient.md

@@ -132,14 +132,18 @@ On cleanup the previous inline values (and priorities) are restored exactly. If
 
 ## 8. File map
 
-| File           | Responsibility                                                                                                                                                                        |
-| :------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| `index.ts`     | Public barrel.                                                                                                                                                                        |
-| `types.ts`     | Palette, config, descriptor, target/source, page contracts.                                                                                                                           |
-| `constants.ts` | CSS variable names, defaults, extraction tuning, `ambientTheme`.                                                                                                                      |
-| `utils.ts`     | OKLCH conversion, canvas sampling, palette derivation, fetch/cache/extraction, target resolution, scoped CSS-variable application, `resolveAmbientVarMap`, `resolvePageAmbientTheme`. |
-| `context.tsx`  | `AmbientProvider` (shared palette store), `useAmbientColor`, `useAmbientTheme`, `useAmbient`.                                                                                         |
-| `module.tsx`   | `ambientModule`, `useAmbientPage` (applies the page theme), `defineAmbient`, kernel type augmentation.                                                                                |
+| File           | Responsibility                                                                                      |
+| :------------- | :-------------------------------------------------------------------------------------------------- |
+| `index.ts`     | Public barrel export.                                                                               |
+| `types.ts`     | Palette, config, descriptor, target/source, page contracts.                                         |
+| `constants.ts` | Default palette constants and `ambientTheme` spec.                                                  |
+| `color.ts`     | Pure OKLCH color math, linear sRGB conversions, string formatting, and palette derivation.          |
+| `extractor.ts` | Canvas 2D pixel histogram sampling, CORS/proxy image fetch, and LRU palette cache.                   |
+| `dom.ts`       | Target element resolution, CSS variable mapping (`AMBIENT_CSS_VARS`), and scoped style restoration. |
+| `hooks.ts`     | React hooks: `useAmbientColor`, `useAmbientTheme`, `useAmbient`, `useStableObject`.                 |
+| `builder.ts`   | Reusable theme factory builder (`defineAmbient`).                                                   |
+| `context.tsx`  | Microkernel global `AmbientContext` and `AmbientProvider` store.                                    |
+| `module.tsx`   | `ambientModule` definition, `resolvePageAmbientTheme`, and kernel type augmentation.                |
 
 No `view.tsx` or `motion.ts`: the module renders nothing, and transitions are CSS classes from the theme ([README](./README.md#42-why-some-optional-slots-are-absent)).
 

package/docs/modules/background.md

@@ -174,19 +174,21 @@ All classes come from `backgroundTheme` (`src/config/background.module.theme.ts`
 
 ## 11. File map
 
-| File                | Responsibility                                                                                                                                       |
-| :------------------ | :--------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `index.ts`          | Public barrel.                                                                                                                                       |
-| `types.ts`          | `BackgroundState`, `VideoOptions`, actions, computed state, YouTube controller/player types, theme slots.                                            |
-| `constants.ts`      | `DEFAULT_BACKGROUND`, registry key, media id, token → slot maps, `backgroundTheme`.                                                                  |
-| `utils.ts`          | Input normalization and merging, `selectPageBackground`, video option and class resolution, gradient/edge-fade/mask math, direct-video sync helpers. |
-| `context.tsx`       | `BackgroundProvider`: registry read, scoped override store, computed state store, actions, `media` registration; `useBackground*` hooks.             |
-| `hooks.ts`          | View models: `useBackgroundOverlayModel`, `useNativeVideoModel`, `useYouTubeBackgroundPlayerModel`.                                                  |
-| `overlay.tsx`       | `BackgroundOverlay`, `NativeVideo`, `YouTubeBackgroundPlayer`, gradient / edge / noise / solid layers.                                               |
-| `motion.ts`         | Default and custom motion resolution, CSS duration/easing helpers.                                                                                   |
-| `module.tsx`        | `backgroundModule`, page API (`set` + actions), `defineBackground`, kernel type augmentation.                                                        |
-| `youtube/parse.ts`  | URL/ID parsing, time params, stream/thumbnail URL builders, the `<video>` element proxy.                                                             |
-| `youtube/iframe.ts` | Iframe API loader and player wrapper (fallback path).                                                                                                |
+| File                 | Responsibility                                                                                            |
+| :------------------- | :-------------------------------------------------------------------------------------------------------- |
+| `index.ts`           | Public barrel export.                                                                                     |
+| `types.ts`           | `BackgroundState`, `VideoOptions`, actions, computed state, YouTube controller/player types, theme slots. |
+| `constants.ts`       | Registry key, media id, `backgroundTheme` spec, and domain constants.                                     |
+| `state.ts`           | `DEFAULT_BACKGROUND`, normalization, patch merging, scoped override resolution, and computed state.       |
+| `visual.ts`          | Gradient generation, smoothstep edge-fade masks, and video styling/fit options.                           |
+| `playback.ts`        | Direct HTML video DOM controls: play/pause, volume/mute, loop, and playbackRate sync.                     |
+| `overlay.tsx`        | `BackgroundOverlay`, `NativeVideo`, and backdrop overlay layers (solid, noise, gradients).                |
+| `motion.ts`          | Motion animations, transition presets, and CSS duration/easing helpers.                                  |
+| `context.tsx`        | `BackgroundProvider`: store, actions, `media` module bridge, and `useBackground*` hooks.                  |
+| `module.tsx`         | `backgroundModule` definition, `selectPageBackground`, `defineBackground`, and kernel type augmentation.  |
+| `youtube/parse.ts`   | YouTube URL/ID parsing, time params, stream/thumbnail URLs, and video element proxy.                      |
+| `youtube/iframe.ts`  | Iframe API loader and YouTube iframe player controller (fallback path).                                   |
+| `youtube/player.tsx` | Dedicated dual-stream YouTube player component and companion audio synchronization hook.                  |
 
 ## 12. Dependencies
 

package/docs/modules/context-menu.md

@@ -227,19 +227,19 @@ No classes or colors in the module, except the pointer-following `left/top/posit
 
 ## 8. File map
 
-| File           | Responsibility                                                                                                                                             |
-| :------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `index.ts`     | Public barrel.                                                                                                                                             |
-| `types.ts`     | Config, item, header, context, state, actions, page and theme-slot contracts.                                                                              |
-| `constants.ts` | Registry keys (`current-page`, `*`), screen margin, visibility event, `contextMenuTheme`.                                                                  |
-| `utils.ts`     | Value resolution, item/header resolution, page metadata from the dock card, safe invocation, positioning, keyboard index helper, visibility event emitter. |
-| `resolver.ts`  | Candidate normalization, path/target/route scoring, context building, `resolveContextMenu`, `prepareMenu`.                                                 |
-| `state.ts`     | Initial and next-open state helpers.                                                                                                                       |
-| `context.tsx`  | `ContextMenuProvider` (store, `openMenu`, `closeMenu`, `bind`), `useContextMenu*` hooks.                                                                   |
-| `hooks.ts`     | `useContextMenuListener`, dismissal, content view model (keyboard, focus, class merging).                                                                  |
-| `overlay.tsx`  | `ContextMenuGlobal`, renderer, content, header, item components.                                                                                           |
-| `motion.ts`    | Pop, content and item variants; tap and spring presets.                                                                                                    |
-| `module.tsx`   | `contextMenuModule`, page API, `defineContextMenu`, kernel type augmentation.                                                                              |
+| File           | Responsibility                                                                                                             |
+| :------------- | :------------------------------------------------------------------------------------------------------------------------- |
+| `index.ts`     | Public barrel.                                                                                                             |
+| `types.ts`     | Config, item, header, context, state, actions, page and theme-slot contracts.                                              |
+| `constants.ts` | Registry keys (`current-page`, `*`), screen margin, visibility event, initial position, `contextMenuTheme`.                |
+| `items.ts`     | Value and boolean resolution, item/header resolution, dock page metadata, safe callback invocation.                       |
+| `dom.ts`       | Menu viewport positioning, keyboard arrow navigation index helper, scroll lock keys detection, class name joining.         |
+| `state.ts`     | Initial and next-open menu state derivation, visibility custom event dispatch.                                             |
+| `resolver.ts`  | Candidate normalization, path/target/route scoring, context building, `resolveContextMenu`, `prepareMenu`.                 |
+| `context.tsx`  | `ContextMenuProvider` (store, `openMenu`, `closeMenu`, `bind`), `useContextMenu*` consumer hooks.                          |
+| `overlay.tsx`  | `ContextMenuGlobal`, portalled renderer, content host, header, item components, and interaction listeners.                |
+| `motion.ts`    | Pop, content and item animation variants; tap and spring presets.                                                          |
+| `module.tsx`   | `contextMenuModule`, page API adapter, `defineContextMenu`, kernel type augmentation.                                     |
 
 ## 9. Dependencies
 

package/docs/modules/controls.md

@@ -146,9 +146,10 @@ No classes or colors in the module apart from the measured position. Slots in `c
 | `index.ts`     | Public barrel.                                                                                                                                               |
 | `types.ts`     | Entries, slots, layout, definition and page-config contracts, theme slots.                                                                                   |
 | `constants.ts` | Edge inset, dock gap, dock element id, side names, `controlsTheme`.                                                                                          |
-| `utils.ts`     | `resolveControlsPairs` (path filter, pairing, ordering), `getControlsLayout` (geometry), `areLayoutsEqual`, `validateControlEntry`, `normalizePageControls`. |
-| `hooks.ts`     | `useControlsLayout` (measurement + observers), `useControls`, `useControlsRegistration`, slot resolution, `useControlsModel`.                                |
-| `overlay.tsx`  | `Controls` and the side rail renderer.                                                                                                                       |
+| `layout.ts`    | `getControlsLayout` (geometry calculation), `areLayoutsEqual`, dock element queries, and `useControlsLayout` (reactive layout measurement + DOM observers).     |
+| `entries.ts`   | `resolveControlsPairs` (path filter, pairing, ordering), `validateControlEntry`, `normalizePageControls`, `resolveSlot`, `isControlSide`.                    |
+| `hooks.ts`     | `useControls`, `useControlsRegistration`, and `useControlsLayout` re-export.                                                                                  |
+| `overlay.tsx`  | `Controls`, `ControlsSide` rail renderer, and internal `useControlsModel`.                                                                                    |
 | `module.tsx`   | `controlsModule`, page API (`set`), `defineControls`, kernel type augmentation.                                                                              |
 
 No `provider.tsx` or `motion.ts`: the module is stateless and does not animate ([README](./README.md#42-why-some-optional-slots-are-absent)).

package/docs/modules/dock.md

@@ -698,10 +698,14 @@ Gotchas:
 | `index.ts`                | Public barrel (named exports only).                                                                                                                                                                                       |
 | `types.ts`                | All contracts (`DockItem`, `DockActions`, `DockState`, surfaces, HUD, status, guards, theme slots). The one deliberate `any` is `DockComponent`.                                                                          |
 | `constants.ts`            | Event names, attention kinds/priorities, surface phases, transaction/operation enums, card dimensions, status priorities, timeouts, `dockTheme`.                                                                          |
-| `utils.ts`                | Path helpers, safe-href check, banner validation, component/renderable resolution, style helpers, focus helpers, item ordering, surface/extension normalization, return handshakes, `createDockScheduler`.                |
+| `paths.ts`                | Path matching, prefix comparison, inline action path detection, safe internal href checking, location key resolution.                                                                                                    |
+| `dom.ts`                  | Focus management (`focusDockElement`, `blurActiveElement`, `getDockFocusableElements`), element classification, focus trap (`useDockFocusTrap`), keyboard handling (`useDockKeyboard`), and route reset (`useDockRouteReset`).|
+| `styles.ts`               | Visual and style helpers (`isValidBannerUrl`, `resolveDockActionClass`, `getDockItemCardProps`, `resolveDockVisualStyle`), and style hooks (`useDockTheme`, `useDockActionClass`).                                         |
+| `layout.ts`               | Geometry and measurement (`getViewportMaxHeight`, `getContainerHeight`, `getDockCardWidth`), height publishing (`publishDockHeightCssVar`), height controller (`useDockHeightController`), and viewport observer (`useDockViewport`).|
+| `helpers.ts`              | General dock helpers (`resolveComponentType`, `resolveRenderableContent`, `formatMediaTime`, `isHudDescriptor`, `createDockScheduler`).                                                                                   |
 | `context.ts`              | `DockContext`, `EMPTY_DOCK_STATE`, state hooks, and the media / loading / notification **peers**.                                                                                                                         |
 | `state.ts`                | Pure logic: `resolveDockAttention`, `resolveDockScene`, operation factory and reducer.                                                                                                                                    |
-| `hooks.ts`                | Public hooks (`useDockRegistration`, `useDockConfig`, `useDockBanner`, `useDockDimensions`, `useSurfaceReturn`, `useDockActionClass`), plus internal focus trap, keyboard, height controller, viewport, style resolution. |
+| `hooks.ts`                | Public hooks (`useDockRegistration`, `useDockConfig`, `useDockBanner`, `useDockDimensions`, `useSurfaceReturn`).                                                                                                          |
 | `provider.tsx`            | `DockProvider`: composes route bridge, expansion, operations, HUD registry, command registry, surface stack, continuity; publishes `DockState` to a store.                                                                |
 | `module.tsx`              | `dockModule`, page slice (`selectPageDock`, `toDockEntries`, `validateDockEntry`, `mergeDockEntries`, `openPageSurface`), event-map and kernel type augmentation.                                                         |
 | `overlay.tsx`             | `Dock` and every rendered piece: cards, header, banner, command bar, surface shell/controls/extensions, HUD view, media controls and scrubber, breadcrumbs card, `ErrorActions`, `GuardActions`.                          |
@@ -710,6 +714,7 @@ Gotchas:
 | `motion.ts`               | Dock durations, springs, transitions, variants and factories, all derived from `@omerdlw/base-framework/tokens`.                                                                                                                           |
 | `runtime/dock.tsx`        | `useDock` (view controller), `useDockModel`, layout ordering, expansion, operation state, route bridge.                                                                                                                   |
 | `runtime/display.ts`      | Item pipeline: registry entries → filtered items → active item (applies surface / status / media).                                                                                                                        |
+| `runtime/pipeline.ts`     | Item identity, active item detection, ancestor deduplication, loading item cleanup, and stacking reorder.                                                                                                                |
 | `runtime/commands.ts`     | Context-action registry, `useDockContextActions`, `defineDockAction`.                                                                                                                                                     |
 | `routing/navigation.ts`   | `useDockNavigation`, route policy, topology, prefetch, location key, view connection.                                                                                                                                     |
 | `routing/transactions.ts` | Navigation transaction reducer and timeout.                                                                                                                                                                               |
@@ -725,6 +730,7 @@ Gotchas:
 | `surface/hooks.tsx`       | Flow operations, lifecycle effects (back button, unmount), `useSurfaceFlow`, extension/shell models.                                                                                                                      |
 | `surface/context.tsx`     | Surface item context, header-action and extension stores, `useSurface*` hooks.                                                                                                                                            |
 | `surface/view-model.ts`   | `resolveSurfaceViewModel` / `applySurfaceToDockItem`: surface state → dock item.                                                                                                                                          |
+| `surface/helpers.ts`      | Surface descriptors, extension normalization, snapshot normalization, and surface return handshakes.                                                                                                                       |
 
 ## 20. Dependencies
 

package/docs/modules/loading.md

@@ -70,7 +70,7 @@ CheckoutLoading.use(isSubmitting); // boolean | message string | LoadingOptions
 | `defineLoading(def)`                                            | builder   | `defineLoading(options \| message).use(overrides?, options?)` → `LoadingStateWithPage & LoadingActions`.                                  |
 | `LoadingContext`                                                | context   | For tests and the dock's peer reader.                                                                                                     |
 | `DEFAULT_LOADING_STATE`, `LOADING_REGISTRY_KEY`, `loadingTheme` | constants |                                                                                                                                           |
-| `normalizeLoadingOptions(options)`, `selectPageLoading(input)`  | utils     | Coerce loose input; map `boolean` / `string` / object page input to `LoadingOptions`.                                                     |
+| `normalizeLoadingOptions(options)`, `selectPageLoading(input)`  | state     | Coerce loose input; map `boolean` / `string` / object page input to `LoadingOptions`.                                                     |
 | Types                                                           |           | `LoadingState`, `LoadingStateWithPage`, `LoadingOptions`, `LoadingActions`, `LoadingPageConfig`, `DefinedLoading`, …                      |
 
 ### 4.1 `LoadingOptions`
@@ -140,16 +140,16 @@ No classes or inline styles in the module. The `loadingTheme` slot `overlay` (st
 
 ## 8. File map
 
-| File           | Responsibility                                                                                    |
-| :------------- | :------------------------------------------------------------------------------------------------ |
-| `index.ts`     | Public barrel.                                                                                    |
-| `types.ts`     | State, options, actions, definition, page-config and theme contracts.                             |
-| `constants.ts` | `DEFAULT_LOADING_STATE`, registry key, `loadingTheme`.                                            |
-| `utils.ts`     | `normalizeLoadingOptions`, `selectPageLoading`.                                                   |
-| `context.tsx`  | `LoadingProvider` (manual state, min-duration timer, registry merge, store), `useLoading*` hooks. |
-| `hooks.ts`     | `useLoadingOverlayModel` (visibility incl. fullscreen check, theme).                              |
-| `overlay.tsx`  | `LoadingOverlay`.                                                                                 |
-| `module.tsx`   | `loadingModule`, page API, `defineLoading`, kernel type augmentation.                             |
+| File           | Responsibility                                                                                                     |
+| :------------- | :----------------------------------------------------------------------------------------------------------------- |
+| `index.ts`     | Public barrel.                                                                                                     |
+| `types.ts`     | State, options, actions, definition, page-config and theme contracts.                                              |
+| `constants.ts` | `DEFAULT_LOADING_STATE`, registry key, `loadingTheme`.                                                             |
+| `state.ts`     | `normalizeLoadingOptions`, `selectPageLoading`, `resolveLoadingState`, `calculateRemainingMinDuration`.            |
+| `context.tsx`  | `LoadingContext`, `LoadingProvider` (manual state, min-duration timer, registry merge, store).                     |
+| `hooks.ts`     | Public hooks (`useLoading`, `useLoadingState`, `useLoadingActions`, `useLoadingRegistration`) & overlay model hook. |
+| `overlay.tsx`  | `LoadingOverlay`.                                                                                                  |
+| `module.tsx`   | `loadingModule`, page API, `defineLoading`, kernel type augmentation.                                              |
 
 ## 9. Dependencies
 

package/docs/modules/media.md

@@ -93,10 +93,10 @@ return <MediaSource src="/audio/city.mp3" follow={BACKGROUND_MEDIA_ID} />; // "b
 | `useMediaState()`                                                                        | hook      | Read-only `MediaState` (re-renders on change).                                                                                                                  |
 | `useMediaActions()`                                                                      | hook      | `MediaActions`. Both hooks throw outside `MediaProvider`.                                                                                                       |
 | `MediaContext`                                                                           | context   | For tests / custom providers.                                                                                                                                   |
-| `resolveMediaSession(sources)`                                                           | util      | Pure: sources → `{ transport, audible, followers }` or `null`.                                                                                                  |
-| `createMediaState(session)`                                                              | util      | Session → `MediaState` (`DEFAULT_MEDIA_STATE` for `null`).                                                                                                      |
-| `bindFollowers(transport, followers)`                                                    | util      | Wire followers to a transport element; returns a cleanup function.                                                                                              |
-| `selectPageMedia(media)`                                                                 | util      | Normalizes `usePage({ media })` input.                                                                                                                          |
+| `resolveMediaSession(sources)`                                                           | session   | Pure: sources → `{ transport, audible, followers }` or `null`.                                                                                                  |
+| `createMediaState(session)`                                                              | session   | Session → `MediaState` (`DEFAULT_MEDIA_STATE` for `null`).                                                                                                      |
+| `bindFollowers(transport, followers)`                                                    | playback  | Wire followers to a transport element; returns a cleanup function.                                                                                              |
+| `selectPageMedia(media)`                                                                 | session   | Normalizes `usePage({ media })` input.                                                                                                                          |
 | `DEFAULT_MEDIA_STATE`, `MEDIA_REGISTRY_KEY`, `MEDIA_SYNC_DRIFT_SECONDS`, `PAGE_MEDIA_ID` | constants | `PAGE_MEDIA_ID` is `"page"`.                                                                                                                                    |
 | Types                                                                                    |           | `MediaOptions`, `MediaHandle`, `MediaState`, `MediaActions`, `MediaEntry`, `MediaEntryInput`, `MediaSession`, `MediaKind`, `MediaPageConfig`, `MediaPageApi`, … |
 
@@ -182,9 +182,10 @@ Keep `isPlaying` current with another `upsertSource({ id, isPlaying })` call. `c
 | `index.ts`     | Public barrel.                                                                                                                                                         |
 | `types.ts`     | Entries, sessions, state, actions, option and page-config contracts.                                                                                                   |
 | `constants.ts` | `DEFAULT_MEDIA_STATE`, registry key, drift threshold, page source id.                                                                                                  |
-| `utils.ts`     | `resolveMediaSession`, `createMediaState`, `mergeMediaSource`, `bindFollowers`, `toggleElement`, `findDisplacedAudio`, `selectPageMedia` (pure or DOM-only, no React). |
-| `context.tsx`  | `MediaProvider`: source registry, session publishing, follower binding, actions; `useMediaState`, `useMediaActions`.                                                   |
-| `hooks.ts`     | `useMedia`: owns the `HTMLAudioElement` lifecycle and registers it.                                                                                                    |
+| `session.ts`   | Pure session resolution: `resolveMediaSession`, `createMediaState`, `mergeMediaSource`, `findDisplacedAudio`, `selectPageMedia`.                                       |
+| `playback.ts`  | DOM media playback and sync: `bindFollowers`, `toggleElement`, `safePlay`, `sameElements`.                                                                              |
+| `context.tsx`  | `MediaProvider`: source registry, session publishing, follower binding, actions; `MediaContext`.                                                                       |
+| `hooks.ts`     | `useMedia` (Audio element lifecycle), `useMediaState`, `useMediaActions`, `useOptionalMediaState`, `useOptionalMediaActions`.                                           |
 | `overlay.tsx`  | `MediaSource` and `MediaOverlay` (components that render nothing).                                                                                                     |
 | `module.tsx`   | `mediaModule`, `usePage({ media })` page API, kernel type augmentation.                                                                                                |
 

package/docs/modules/modal.md

@@ -216,7 +216,10 @@ Motion (`motion.ts`: backdrop, per-position panel variants/transitions, header/b
 | `types.ts`     | Positions, chrome, entries, state, actions, definitions, container props, theme slots.                                                |
 | `constants.ts` | `MODAL_POSITIONS`, `MODAL_CHROME`, mobile breakpoint, scroll-lock event, focusable selector, height-constraint pattern, `modalTheme`. |
 | `state.ts`     | `createModalState` (stack → state) and the initial state.                                                                             |
-| `utils.ts`     | Identity resolution, position normalization (responsive), focus trap helpers, header-action resolution, labels.                       |
+| `identity.ts`  | Modal identity derivation (`getModalIdentity`) and humanized modal labels (`getModalLabel`).                                           |
+| `layout.ts`    | Position resolution (`getModalPosition`, `getModalLayout`), responsive normalization, viewport checks, height constraints.            |
+| `dom.ts`       | Focus trap helpers (`getFocusableElements`, `trapFocus`) and smooth scroll-lock event dispatch.                                       |
+| `header.ts`    | Header configuration checking (`isHeaderConfig`), slot content validation (`hasSlotContent`), and action resolution.                  |
 | `context.tsx`  | `ModalProvider` (stack, pending promises, actions), `useModal*` hooks, registry lookup.                                               |
 | `hooks.ts`     | View models: `useModalModel` (visibility, viewport, scroll lock), `useModalLayerModel` (focus, Esc), `useModalContainerModel`.        |
 | `overlay.tsx`  | `Modal`, `ModalLayer`, `ModalContainer`, switcher, close button.                                                                      |

package/docs/modules/notification.md

@@ -146,12 +146,12 @@ No classes or inline styles in the module. `notificationTheme` slots: `layer`, `
 | `index.ts`     | Public barrel.                                                                              |
 | `types.ts`     | Notification data, options, controller, page and theme-slot contracts.                      |
 | `constants.ts` | `TOAST_DURATIONS`, session-expired message, `DOCK_STACK_ELEMENT_ID`, `notificationTheme`.   |
-| `utils.ts`     | Option normalization, default duration, text normalization, active-toast selection, guards. |
-| `context.tsx`  | `NotificationProvider` (store, timers, show/dismiss), `useNotification*` hooks.             |
-| `hooks.ts`     | `useToast` (`promise`, `fromResult`), `NotificationListener`, container view model.         |
+| `state.ts`     | Option normalization, duration resolution, text normalization, entry creation, active toast selection. |
+| `context.tsx`  | `NotificationProvider` (store, timers, show/dismiss actions), `NotificationContext`.         |
+| `hooks.ts`     | Public hooks (`useToast`, `useNotification*`), `NotificationListener`, container view model. |
 | `overlay.tsx`  | `Toast`, `NotificationContainer` (dock/floating portal), `NotificationLayer`.               |
 | `motion.ts`    | Toast variants and transition.                                                              |
-| `module.ts`    | `notificationModule` and the page API (plain `.ts`: it has no JSX).                         |
+| `module.tsx`   | `notificationModule` and the page API.                                                      |
 
 `builder.ts` is absent: toasts are imperative ([README](./README.md#42-why-some-optional-slots-are-absent)).
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@omerdlw/base-framework",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "Microkernel engine and first-party declarative UI modules for app-like Next.js products.",
   "type": "module",
   "sideEffects": false,
@@ -126,10 +126,10 @@
     "LICENSE"
   ],
   "scripts": {
-    "build": "rm -rf dist && tsup && tsc --emitDeclarationOnly --outDir dist",
+    "build": "rm -rf dist && ./node_modules/.bin/tsup && ./node_modules/.bin/tsc --emitDeclarationOnly --outDir dist",
     "prepublishOnly": "npm run build",
-    "dev": "tsup --watch",
-    "type-check": "tsc --noEmit",
+    "dev": "./node_modules/.bin/tsup --watch",
+    "type-check": "./node_modules/.bin/tsc --noEmit",
     "check:architecture": "node scripts/check-architecture.mjs",
     "test": "node --import ./tests/support/register.mjs --test 'tests/**/*.test.ts'",
     "pack": "npm run build && npm pack",

package/dist/modules/ambient/utils.d.ts

@@ -1,18 +0,0 @@
-import { type AmbientConfig, type AmbientExtractOptions, type AmbientImageSource, type AmbientPageSlice, type AmbientPalette, type AmbientTarget, type OklchColor } from "./types";
-export declare function rgbToOklch(r: number, g: number, b: number): OklchColor;
-export declare function oklchToString(l: number | string, c: number | string, h: number | string, alpha?: number | string): string;
-export declare function sampleImageData(imageData: ImageData): OklchColor;
-export declare function createDefaultPalette(fallback?: AmbientPalette | null): AmbientPalette;
-export declare function derivePalette(sampled: OklchColor): AmbientPalette;
-export declare function extractPaletteFromImage(imageSource: AmbientImageSource, options?: AmbientExtractOptions): Promise<AmbientPalette>;
-export declare function resolveTargetElement(target: AmbientTarget): HTMLElement | null;
-export declare function applyScopedCssVariables(element: HTMLElement, varMap: Record<string, string>): () => void;
-export declare function resolveAmbientVarMap({ colors, extractedBlack, extractedPrimary, image, tintGlobals, }: {
-    colors?: Record<string, string> | null;
-    extractedBlack?: string;
-    extractedPrimary?: string;
-    image?: AmbientImageSource;
-    tintGlobals?: boolean;
-}): Record<string, string>;
-export declare function resolvePageAmbientTheme(slice: AmbientPageSlice | null, posterUrl: string | null): Partial<AmbientConfig> | null;
-//# sourceMappingURL=utils.d.ts.map

package/dist/modules/ambient/utils.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/modules/ambient/utils.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,UAAU,EAChB,MAAM,SAAS,CAAC;AAOjB,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,UAAU,CAyBtE;AAED,wBAAgB,aAAa,CAC3B,CAAC,EAAE,MAAM,GAAG,MAAM,EAClB,CAAC,EAAE,MAAM,GAAG,MAAM,EAClB,CAAC,EAAE,MAAM,GAAG,MAAM,EAClB,KAAK,GAAE,MAAM,GAAG,MAAU,GACzB,MAAM,CASR;AAED,wBAAgB,eAAe,CAAC,SAAS,EAAE,SAAS,GAAG,UAAU,CAsFhE;AAED,wBAAgB,oBAAoB,CAClC,QAAQ,CAAC,EAAE,cAAc,GAAG,IAAI,GAC/B,cAAc,CAKhB;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,UAAU,GAAG,cAAc,CAuBjE;AAsED,wBAAsB,uBAAuB,CAC3C,WAAW,EAAE,kBAAkB,EAC/B,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,cAAc,CAAC,CAqBzB;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,aAAa,GACpB,WAAW,GAAG,IAAI,CAOpB;AAmBD,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,WAAW,EACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC7B,MAAM,IAAI,CAiBZ;AAED,wBAAgB,oBAAoB,CAAC,EACnC,MAAa,EACb,cAAmB,EACnB,gBAAqB,EACrB,KAAY,EACZ,WAAkB,GACnB,EAAE;IACD,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IACvC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAezB;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,gBAAgB,GAAG,IAAI,EAC9B,SAAS,EAAE,MAAM,GAAG,IAAI,GACvB,OAAO,CAAC,aAAa,CAAC,GAAG,IAAI,CAiB/B"}

package/dist/modules/background/utils.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/modules/background/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,OAAO,CAAC;AAE3C,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,eAAe,EACpB,KAAK,SAAS,EACd,KAAK,YAAY,EAClB,MAAM,SAAS,CAAC;AAKjB,wBAAgB,sBAAsB,CACpC,GAAG,MAAM,EAAE,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,GACvC;IAAE,WAAW,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAe9D;AAED,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,YAAiB;;;;;;;;;;;EAa7D;AAED,wBAAgB,wBAAwB,CACtC,KAAK,GAAE,OAAO,CAAC,eAAe,CAAC,GAAG,MAAM,GAAG,IAAI,GAAG,SAAc,GAC/D,OAAO,CAAC,eAAe,CAAC,CAuB1B;AAED,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,eAAe,EAC1B,KAAK,GAAE,OAAO,CAAC,eAAe,CAAC,GAAG,MAAW,GAC5C,eAAe,CA6CjB;AAED,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,oBAAoB,GAAG,IAAI,GAAG,SAAS,GAClD,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI,CAEjC;AAED,eAAO,MAAM,oBAAoB,GAC/B,WAAW,MAAM,GAAG,OAAO,EAC3B,OAAO,MAAM,KACZ,MAGF,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAC/B,WAAW,MAAM,GAAG,OAAO,EAC3B,OAAO,MAAM,KACZ,MAGF,CAAC;AAEF,wBAAgB,cAAc,CAAC,YAAY,GAAE,oBAAyB;eAQ1C,aAAa;;;EAIxC;AAED,wBAAgB,uBAAuB,CAAC,EACtC,SAAgB,EAChB,QAAgB,EAChB,YAAgB,EAChB,aAAiB,GAClB,EAAE;IACD,SAAS,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;IACzD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;;;;;;EAsCA;AAmCD,wBAAgB,eAAe,CAAC,EAC9B,KAA4B,EAC5B,WAAe,EACf,YAAgB,GACjB,EAAE;IACD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,MAAM,GAAG,SAAS,CAWrB;AAED,wBAAgB,uBAAuB,CAAC,EACtC,SAAS,EACT,YAAY,EACZ,eAAe,EACf,YAAY,GACb,EAAE;IACD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IAC5C,YAAY,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;CACxC,GAAG,IAAI,CA6CP;AAED,wBAAgB,0BAA0B,CACxC,YAAY,EAAE,gBAAgB,GAAG,IAAI,GAAG,SAAS,EACjD,WAAW,EAAE,OAAO,EACpB,eAAe,EAAE,OAAO,GACvB,IAAI,CAgBN;AAED,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,gBAAgB,GAAG,IAAI,GAAG,SAAS,EACjD,SAAS,EAAE,OAAO,GACjB,IAAI,CAMN;AAED,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,gBAAgB,GAAG,IAAI,GAAG,SAAS,EACjD,QAAQ,EAAE,OAAO,GAChB,IAAI,CAGN"}

package/dist/modules/context-menu/utils.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/modules/context-menu/utils.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,EAG5B,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,yBAAyB,EAC9B,KAAK,uBAAuB,EAE7B,MAAM,SAAS,CAAC;AAGjB,wBAAgB,cAAc,CAC5B,GAAG,OAAO,EAAE,CAAC,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,GAClD,MAAM,CAER;AAaD,wBAAgB,eAAe,CAAC,KAAK,EAAE;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAE/D;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAgBtD;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,OAAO,EACjB,YAAY,UAAO,GAClB,OAAO,CAYT;AAED,wBAAgB,cAAc,CAAC,CAAC,GAAG,OAAO,EACxC,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,OAAO,EACjB,QAAQ,CAAC,EAAE,CAAC,GACX,CAAC,CAUH;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAO/D;AAED,wBAAgB,UAAU,CAAC,CAAC,GAAG,OAAO,EACpC,OAAO,EAAE,OAAO,EAChB,GAAG,IAAI,EAAE,OAAO,EAAE,GACjB,CAAC,GAAG,SAAS,CAcf;AAED,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,OAAO,EACjB,QAAQ,SAAK,GACZ,mBAAmB,GAAG,IAAI,CA8B5B;AAED,wBAAgB,YAAY,CAC1B,WAAW,EAAE,WAAW,GAAG,IAAI,EAC/B,QAAQ,CAAC,EAAE,mBAAmB,GAAG,IAAI,GACpC,IAAI,CAWN;AAmDD,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,iBAAiB,GAAG,IAAI,GAAG,SAAS,EAC5C,OAAO,EAAE,uBAAuB,GAC/B,uBAAuB,EAAE,CAmB3B;AAED,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,iBAAiB,GAAG,IAAI,GAAG,SAAS,EAC5C,OAAO,EAAE,uBAAuB,GAC/B,yBAAyB,GAAG,IAAI,CAyBlC;AAED,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,uBAAuB,EAAE,EAChC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,CAAC,GAAG,CAAC,CAAC,GAChB,MAAM,CAUR"}

package/dist/modules/controls/utils.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/modules/controls/utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAOjD,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EAEvB,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACxB,MAAM,SAAS,CAAC;AAEjB,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAElE;AAMD,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,GAAG,YAAY,EAAE,GAAG,IAAI,GAAG,SAAS,EACzE,QAAQ,EAAE,MAAM,GACf,qBAAqB,CAoCvB;AAED,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,IAAI,CAAC,OAAO,EAAE,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC,GAAG,IAAI,EACtE,QAAQ,EAAE,kBAAkB,GAC3B,cAAc,GAAG,IAAI,CAsBvB;AAED,wBAAgB,eAAe,CAC7B,CAAC,EAAE,cAAc,GAAG,IAAI,EACxB,CAAC,EAAE,cAAc,GAAG,IAAI,GACvB,OAAO,CAYT;AAcD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAkBrE;AAED,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,kBAAkB,GAAG,IAAI,GAAG,SAAS,GAC9C,gBAAgB,EAAE,GAAG,IAAI,CAoB3B"}

package/dist/modules/dock/utils.d.ts

@@ -1,93 +0,0 @@
-import { cn, type CoreSchedulerOptions } from "@/utils";
-import { type ReactNode, type CSSProperties } from "react";
-import { type DockComponent, type DockVisualStyleSection, type DockItem, type DockHudDescriptor, type NormalizedSurfaceExtension, type SurfaceDescriptor, type DockTheme, type SurfaceFlowDefinition, type SurfaceReturnHandshake, type SurfaceReturnHandshakeInput } from "./types";
-export declare function isSamePath(left: unknown, right: unknown): boolean;
-export declare function isPathPrefix(candidatePath: unknown, pathname: unknown): boolean;
-export declare function isInlineActionPathMatch(path: unknown, pathname: unknown): boolean;
-export declare function isSafeInternalHref(value: unknown): boolean;
-export declare function getDockLocationKey({ hash, pathname, search, }?: {
-    hash?: string;
-    pathname?: string;
-    search?: string;
-}): string;
-export declare function formatMediaTime(seconds?: number | string): string;
-export declare function isValidBannerUrl(banner: unknown): boolean;
-export declare function toObject(value: unknown): Record<string, unknown>;
-export declare function isValidComponentType(type: unknown): type is DockComponent;
-export declare function resolveComponentType(...candidates: unknown[]): DockComponent | null;
-export declare function resolveRenderableContent(...candidates: ReactNode[]): ReactNode | null;
-export declare function toSearchableText(value: unknown): string;
-export type DockStyleInput = DockVisualStyleSection;
-export declare function normalizeUpper(value: unknown): string;
-export declare function splitStyle<T extends DockStyleInput>(style?: T): {
-    className: string | undefined;
-    inlineStyle: Omit<T, "className">;
-};
-export declare function getLineClampStyle(maxLines: number | string | undefined, style: CSSProperties): CSSProperties;
-export declare function getImageIconStyle(style: CSSProperties, icon: string): CSSProperties;
-export declare function resolveDockActionClass(slots: DockTheme["slots"], { className, button, isActive, variant, tone, base, cn: classNamesFn, }?: {
-    className?: string;
-    button?: string;
-    isActive?: boolean;
-    variant?: string;
-    tone?: string;
-    base?: string;
-    cn?: (...args: Parameters<typeof cn>) => string;
-}): string;
-export declare function blurActiveElement(): void;
-export declare function isInteractiveTarget(target: unknown): boolean;
-export declare function isEditableDockTarget(target: unknown): boolean;
-export declare function getDockFocusableElements(container: HTMLElement | null): HTMLElement[];
-export declare function focusDockElement(element: HTMLElement | null): boolean;
-export declare function shouldRestoreDockFocus(result: unknown): boolean;
-type AncestorAwareItem = DockItem & {
-    keepWhenDescendant?: boolean | ((activePath: string, item: DockItem) => boolean);
-    statusType?: string;
-};
-declare function isSameDockItem(item: DockItem | null | undefined, candidate: DockItem | null | undefined): boolean;
-export declare const isSameItem: typeof isSameDockItem;
-export declare function getItemKey(link: DockItem | null, index?: number): string;
-export declare function getItemMeasurementKey({ link, expanded, isHud, }: {
-    link: DockItem;
-    expanded: boolean;
-    isHud?: boolean;
-    isHovered?: boolean;
-    isStackHovered?: boolean;
-}): string;
-export declare function getRouteMeasurementKey(pathname: string | null, key: string): string;
-export declare function resolveDockHeaderKey({ link, description, showVideoIcon, }: {
-    link: AncestorAwareItem;
-    description?: string | null;
-    showVideoIcon?: boolean;
-}): string;
-export declare function findDockItemIndex(dockItems: DockItem[], activeItem: DockItem | null, pathname: string): number;
-export declare function resolveActiveIndex({ dockItems, activeItem, pathname, }: {
-    dockItems: DockItem[];
-    activeItem: DockItem | null;
-    pathname: string;
-}): number;
-export declare function removeAncestorDuplicates(items?: DockItem[]): DockItem[];
-export declare function replaceActiveItem(items: DockItem[], activeIndex: number, activeItem: DockItem | null): DockItem[];
-export declare function removeInactiveLoadingItems(items?: DockItem[], activeItem?: DockItem | null): DockItem[];
-export declare function reorderItemsWithActiveFirst(items: DockItem[], activeIndex: number): DockItem[];
-export declare function isHudDescriptor(value: unknown): value is DockHudDescriptor;
-export declare function isSurfaceDescriptor(value: unknown): value is SurfaceDescriptor;
-export declare function normalizeSurfaceExtension(input: unknown): NormalizedSurfaceExtension | null;
-export declare function normalizeSurfaceFlowSnapshot(value: unknown): Record<string, unknown> | null;
-export declare function createSurfaceReturnHandshake(input: SurfaceReturnHandshakeInput): SurfaceReturnHandshake | null;
-export declare function resolveSurfaceFlowReturnHandshake(definition: Pick<SurfaceFlowDefinition, "returnHandshake"> | null | undefined, input: unknown): SurfaceReturnHandshake | null;
-export declare function createDockScheduler(options?: CoreSchedulerOptions): Readonly<{
-    cancel: (taskId: number) => boolean;
-    cancelAll(): number[];
-    getSnapshot(): import("@/utils").SchedulerSnapshot;
-    now: () => number;
-    schedule(callback: (timestamp: number) => void, delayMs?: number, options?: {
-        label?: string;
-    }): number | null;
-    scheduleFrame(callback: (timestamp: number) => void, options?: {
-        label?: string;
-    }): number | null;
-    subscribe(listener: () => void): () => void;
-}>;
-export {};
-//# sourceMappingURL=utils.d.ts.map

package/dist/modules/dock/utils.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/modules/dock/utils.ts"],"names":[],"mappings":"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"}

package/dist/modules/loading/utils.d.ts

@@ -1,4 +0,0 @@
-import { type LoadingOptions, type LoadingPageConfig, type LoadingState } from "./types";
-export declare function normalizeLoadingOptions(options?: LoadingOptions): Omit<LoadingState, "isLoading">;
-export declare function selectPageLoading(loading: LoadingPageConfig | null | undefined): LoadingOptions | null;
-//# sourceMappingURL=utils.d.ts.map

package/dist/modules/loading/utils.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/modules/loading/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EAClB,MAAM,SAAS,CAAC;AAEjB,wBAAgB,uBAAuB,CACrC,OAAO,GAAE,cAAmB,GAC3B,IAAI,CAAC,YAAY,EAAE,WAAW,CAAC,CASjC;AAED,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,iBAAiB,GAAG,IAAI,GAAG,SAAS,GAC5C,cAAc,GAAG,IAAI,CAKvB"}

package/dist/modules/media/utils.d.ts

@@ -1,17 +0,0 @@
-import { type MediaSession, type MediaEntry, type MediaEntryInput, type MediaPageConfig, type MediaPageOptions, type MediaState } from "./types";
-export declare function resolveMediaSession(sources: readonly MediaEntry[]): MediaSession | null;
-export declare function createMediaState(session: MediaSession | null): MediaState;
-export declare function mediaStatesEqual(a: MediaState, b: MediaState): boolean;
-export declare function mergeMediaSource(current: MediaEntry | undefined, input: MediaEntryInput, order: number): MediaEntry;
-export declare function toggleElement(element: HTMLMediaElement | null): void;
-export declare function safePlay(element: HTMLMediaElement): void;
-export declare function bindFollowers(transport: HTMLMediaElement, followers: readonly HTMLMediaElement[]): () => void;
-export declare function sameElements(a: readonly (HTMLMediaElement | null)[], b: readonly (HTMLMediaElement | null)[]): boolean;
-export declare function selectPageMedia(media: MediaPageConfig | null | undefined): MediaPageOptions | null;
-/**
- * Standalone audio that a newly registered source pushes out of the controls.
- * Two independent tracks would otherwise play over each other while the dock
- * only controls the newest.
- */
-export declare function findDisplacedAudio(entries: readonly MediaEntry[], session: MediaSession | null, newId: string): MediaEntry[];
-//# sourceMappingURL=utils.d.ts.map

package/dist/modules/media/utils.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/modules/media/utils.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,UAAU,EAChB,MAAM,SAAS,CAAC;AAQjB,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,SAAS,UAAU,EAAE,GAC7B,YAAY,GAAG,IAAI,CAyBrB;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,GAAG,UAAU,CAYzE;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,GAAG,OAAO,CAEtE;AAED,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,UAAU,GAAG,SAAS,EAC/B,KAAK,EAAE,eAAe,EACtB,KAAK,EAAE,MAAM,GACZ,UAAU,CAYZ;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,GAAG,IAAI,CAOpE;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAMxD;AAED,wBAAgB,aAAa,CAC3B,SAAS,EAAE,gBAAgB,EAC3B,SAAS,EAAE,SAAS,gBAAgB,EAAE,GACrC,MAAM,IAAI,CAgDZ;AAED,wBAAgB,YAAY,CAC1B,CAAC,EAAE,SAAS,CAAC,gBAAgB,GAAG,IAAI,CAAC,EAAE,EACvC,CAAC,EAAE,SAAS,CAAC,gBAAgB,GAAG,IAAI,CAAC,EAAE,GACtC,OAAO,CAIT;AAED,wBAAgB,eAAe,CAC7B,KAAK,EAAE,eAAe,GAAG,IAAI,GAAG,SAAS,GACxC,gBAAgB,GAAG,IAAI,CAIzB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,SAAS,UAAU,EAAE,EAC9B,OAAO,EAAE,YAAY,GAAG,IAAI,EAC5B,KAAK,EAAE,MAAM,GACZ,UAAU,EAAE,CAWd"}

package/dist/modules/modal/utils.d.ts

@@ -1,31 +0,0 @@
-import { type ReactNode } from "react";
-import { type DefineModalOptions, type ModalComponent, type ModalInput, type ModalPosition, type ModalLayout, type ResponsiveModalPosition } from "./types";
-export declare function getModalIdentity(input: ModalInput | DefineModalOptions): {
-    component: ModalComponent | null;
-    type: string;
-};
-export declare function hasHeightConstraint(className?: string): boolean;
-export declare function isSidePosition(position: ModalPosition | null | undefined): boolean;
-export declare function isVerticalEdgePosition(position: ModalPosition | null | undefined): boolean;
-export declare function hasSlotContent(value: unknown): boolean;
-export declare function isHeaderConfig(value: unknown): boolean;
-export declare function resolveHeaderActions(actions: ReactNode | ((props: {
-    close?: (result?: unknown) => void;
-}) => ReactNode) | undefined, close?: (result?: unknown) => void): ReactNode;
-export declare function getModalPosition(position: ModalPosition): ModalPosition;
-/**
- * The fully resolved layout of a modal. Themes style it through
- * `data-layout`, so every position/viewport combination is one selector.
- */
-export declare function getModalLayout(position: ModalPosition, isMobile: boolean): ModalLayout;
-export declare function dispatchSmoothScrollLock(locked: boolean): void;
-export declare function getViewportIsMobile(): boolean;
-export declare function resolveActivePosition(position: ModalPosition, responsivePosition: ResponsiveModalPosition | null | undefined, isMobileViewport: boolean): ModalPosition;
-export declare function normalizePosition(input: ModalPosition | ResponsiveModalPosition | undefined): {
-    position: ModalPosition;
-    responsivePosition: ResponsiveModalPosition | null;
-};
-export declare function getFocusableElements(container: HTMLElement | null): HTMLElement[];
-export declare function trapFocus(event: KeyboardEvent, container: HTMLElement | null): void;
-export declare function getModalLabel(modalType?: string | null): string;
-//# sourceMappingURL=utils.d.ts.map

package/dist/modules/modal/utils.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/modules/modal/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAUvD,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,cAAc,EAEnB,KAAK,UAAU,EACf,KAAK,aAAa,EAElB,KAAK,WAAW,EAChB,KAAK,uBAAuB,EAC7B,MAAM,SAAS,CAAC;AAEjB,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,kBAAkB,GAAG;IACxE,SAAS,EAAE,cAAc,GAAG,IAAI,CAAC;IACjC,IAAI,EAAE,MAAM,CAAC;CACd,CAaA;AAED,wBAAgB,mBAAmB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAI/D;AAED,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,aAAa,GAAG,IAAI,GAAG,SAAS,GACzC,OAAO,CAIT;AAED,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,aAAa,GAAG,IAAI,GAAG,SAAS,GACzC,OAAO,CAIT;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAItD;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAOtD;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EACH,SAAS,GACT,CAAC,CAAC,KAAK,EAAE;IAAE,KAAK,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,OAAO,KAAK,IAAI,CAAA;CAAE,KAAK,SAAS,CAAC,GAC9D,SAAS,EACb,KAAK,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,OAAO,KAAK,IAAI,GACjC,SAAS,CAEX;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,aAAa,GAAG,aAAa,CAOvE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,aAAa,EACvB,QAAQ,EAAE,OAAO,GAChB,WAAW,CAQb;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAO9D;AAED,wBAAgB,mBAAmB,IAAI,OAAO,CAU7C;AAED,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,aAAa,EACvB,kBAAkB,EAAE,uBAAuB,GAAG,IAAI,GAAG,SAAS,EAC9D,gBAAgB,EAAE,OAAO,GACxB,aAAa,CAMf;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,aAAa,GAAG,uBAAuB,GAAG,SAAS,GACzD;IACD,QAAQ,EAAE,aAAa,CAAC;IACxB,kBAAkB,EAAE,uBAAuB,GAAG,IAAI,CAAC;CACpD,CAeA;AAED,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,WAAW,GAAG,IAAI,GAC5B,WAAW,EAAE,CASf;AAED,wBAAgB,SAAS,CACvB,KAAK,EAAE,aAAa,EACpB,SAAS,EAAE,WAAW,GAAG,IAAI,GAC5B,IAAI,CAmBN;AAED,wBAAgB,aAAa,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAQ/D"}

package/dist/modules/notification/utils.d.ts

@@ -1,9 +0,0 @@
-import { type NotificationData, type NotificationEntry, type NotificationOptions, type ToastOptionsInput } from "./types";
-export declare function normalizeFeedbackText<T = unknown>(value: T): T;
-export declare function getActiveNotification(notifications: Record<string, NotificationEntry>): NotificationEntry | null;
-export declare function normalizeToastOptions(options?: ToastOptionsInput): NotificationOptions;
-export declare function withDefaultDuration(duration: number, options?: ToastOptionsInput): NotificationOptions & {
-    duration: number | null;
-};
-export declare function isNotificationDataObject(value: unknown): value is NotificationData;
-//# sourceMappingURL=utils.d.ts.map

package/dist/modules/notification/utils.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/modules/notification/utils.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACvB,MAAM,SAAS,CAAC;AAEjB,wBAAgB,qBAAqB,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAG9D;AAED,wBAAgB,qBAAqB,CACnC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAC/C,iBAAiB,GAAG,IAAI,CAM1B;AAED,wBAAgB,qBAAqB,CACnC,OAAO,CAAC,EAAE,iBAAiB,GAC1B,mBAAmB,CAErB;AAED,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,mBAAmB,GAAG;IAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAOnD;AAED,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,gBAAgB,CAE3B"}