@lumx/core 4.16.0-alpha.6 → 4.16.0-alpha.7

package/js/components/Combobox/setupListbox.d.ts

@@ -18,4 +18,6 @@ import type { ComboboxEventMap, ComboboxHandle } from './types';
  * @param notify Notify subscribers of combobox events.
  * @returns The created focus navigation controller.
  */
-export declare function setupListbox(handle: ComboboxHandle, signal: AbortSignal, notify: <K extends keyof ComboboxEventMap>(event: K, value: ComboboxEventMap[K]) => void): FocusNavigationController;
+export declare function setupListbox(handle: ComboboxHandle, signal: AbortSignal, notify: <K extends keyof ComboboxEventMap>(event: K, value: ComboboxEventMap[K]) => void, options?: {
+    wrapNavigation?: boolean;
+}): FocusNavigationController;

package/js/utils/focusNavigation/createGridFocusNavigation.d.ts

@@ -2,16 +2,13 @@ import type { FocusNavigationCallbacks, FocusNavigationController, GridNavigatio
 /**
  * Create a focus navigation controller for a 2D grid.
  *
- * The controller is composed of two layers:
- * - a pure, side-effect-free **selection** layer ({@link createGridSelectors}) that only
- *   resolves/reports rows and cells by querying the DOM, and
- * - a **mover** layer (this function) that commits focus by updating the active-item state
- *   (which fires {@link FocusNavigationCallbacks}) on top of the selectors.
+ * Resolves rows and cells by querying the DOM and commits focus by updating the
+ * active-item state (which fires {@link FocusNavigationCallbacks}).
  *
  * Supports Up/Down between rows (with column memory) and Left/Right between cells
  * (with wrapping across rows).
  *
- * @param options Grid navigation options (container, rowSelector, cellSelector, isRowVisible, wrap).
+ * @param options Grid navigation options (container, rowSelector, cellSelector, wrap).
  * @param callbacks Callbacks for focus state changes.
  * @param signal AbortSignal for cleanup.
  * @returns FocusNavigationController instance.

package/js/utils/focusNavigation/createListFocusNavigation.d.ts

@@ -2,12 +2,6 @@ import type { FocusNavigationCallbacks, ListFocusNavigationController, ListNavig
 /**
  * Create a focus navigation controller for a 1D list.
  *
- * The controller is composed of two layers:
- * - a pure, side-effect-free **selection** layer ({@link createListSelectors}) that only
- *   resolves/reports items by querying the DOM, and
- * - a **mover** layer (this function) that commits focus by calling
- *   {@link FocusNavigationCallbacks} on top of the selectors.
- *
  * This controller is **stateless** — it does not maintain an internal reference to
  * the active item. Instead it reads the active item from the DOM each time via the
  * `getActiveItem` callback provided in the options. This avoids any desync between

package/js/utils/focusNavigation/types.d.ts

@@ -17,7 +17,6 @@ export interface GridNavigationOptions {
     container: HTMLElement;
     rowSelector: string;
     cellSelector: string;
-    isRowVisible?: (row: HTMLElement) => boolean;
     wrap?: boolean;
 }
 /** Pure, side-effect-free selection layer for focus navigation. */
@@ -46,7 +45,6 @@ export interface ListFocusNavigationSelectors extends FocusNavigationSelectors {
 export interface FocusNavigationController<Selectors extends FocusNavigationSelectors = FocusNavigationSelectors> {
     readonly type: 'list' | 'grid';
     readonly selectors: Selectors;
-    goToItem(item: HTMLElement): boolean;
     goToOffset(offset: number): boolean;
     clear(): void;
     goUp(): boolean;

package/package.json

@@ -7,7 +7,7 @@
     },
     "dependencies": {
         "@floating-ui/dom": "^1.7.5",
-        "@lumx/icons": "^4.16.0-alpha.6",
+        "@lumx/icons": "^4.16.0-alpha.7",
         "classnames": "^2.3.2",
         "focus-visible": "^5.0.2",
         "lodash": "4.18.1",
@@ -69,7 +69,7 @@
         "update-version-changelog": "yarn version-changelog ../../CHANGELOG.md"
     },
     "sideEffects": false,
-    "version": "4.16.0-alpha.6",
+    "version": "4.16.0-alpha.7",
     "devDependencies": {
         "@rollup/plugin-typescript": "^12.3.0",
         "@testing-library/dom": "^10.4.1",

package/js/utils/focusNavigation/createGridSelectors.d.ts

@@ -1,25 +0,0 @@
-import type { FocusNavigationSelectors, GridNavigationOptions } from './types';
-/**
- * Create the pure selection layer for a 2D grid.
- *
- * Everything here is side-effect-free: it only *queries* the DOM to resolve and report
- * rows/cells. No focus is moved and no {@link FocusNavigationCallbacks} are invoked — that
- * is the job of the mover layer built on top of this.
- *
- * @param options Grid navigation options (container, rowSelector, cellSelector).
- * @param getActive Reader for the currently active cell (owned by the mover's active-item state).
- * @param isVisible Predicate deciding whether a row is visible (derived from `isRowVisible`).
- * @returns The public {@link FocusNavigationSelectors} plus the internal
- *   {@link GridSelectorHelpers} the mover layer consumes.
- */
-export declare function createGridSelectors(options: GridNavigationOptions, getActive: () => HTMLElement | null, isVisible: (row: HTMLElement) => boolean): {
-    selectors: FocusNavigationSelectors;
-    helpers: {
-        findFirstVisibleRow: () => HTMLElement | null;
-        findLastVisibleRow: () => HTMLElement | null;
-        findAllVisibleRows: () => HTMLElement[];
-        getRowCells: (row: HTMLElement) => HTMLElement[];
-        findParentRow: (cell: HTMLElement) => HTMLElement | null;
-        findAdjacentVisibleRow: (fromRow: HTMLElement, direction: "next" | "prev") => HTMLElement | null;
-    };
-};

package/js/utils/focusNavigation/createListSelectors.d.ts

@@ -1,21 +0,0 @@
-import type { ListFocusNavigationSelectors, ListNavigationOptions } from './types';
-/**
- * Create the pure selection layer for a 1D list.
- *
- * Everything here is side-effect-free: it only *queries* the DOM to resolve and report
- * items. No focus is moved and no {@link FocusNavigationCallbacks} are invoked — that is
- * the job of the mover layer built on top of this (`createListFocusNavigation`).
- *
- * @param options List navigation options (container, itemSelector, itemDisabledSelector, getActiveItem).
- * @returns The public {@link ListFocusNavigationSelectors} plus the internal
- *   {@link ListSelectorHelpers} the mover layer consumes.
- */
-export declare function createListSelectors(options: ListNavigationOptions): {
-    selectors: ListFocusNavigationSelectors;
-    helpers: {
-        createItemWalker: (enabledOnly?: boolean) => TreeWalker;
-        findFirstEnabled: () => HTMLElement | null;
-        findLastEnabled: () => HTMLElement | null;
-        getActiveItem: () => HTMLElement | null;
-    };
-};