@k8slens/element-components 3.6.1 → 3.7.0

package/dist/src/plugins/drop-down-menu/drop-down-menu.d.ts

@@ -11,9 +11,11 @@ export type DropDownMenuPluginProps = {
      * The menu positions itself against the nearest anchor around it, so the element — or something
      * enclosing it — declares `$anchor`.
      *
-     * Focus returns to the element once the menu is gone. A menu that opens on hovering opens with
-     * ArrowRight as well, and closes with ArrowLeft from anywhere within it, so a menu held by a menu
-     * row is reachable without a pointer.
+     * The menu takes focus as it opens, its first item becoming the current one — except when it
+     * opens by being hovered, where focus stays on the element: the row the pointer rests on is what
+     * the user is looking at. Focus returns to the element once the menu is gone. A menu that opens on
+     * hovering opens with ArrowRight as well, taking focus then, and closes with ArrowLeft from
+     * anywhere within it, so a menu held by a menu row is reachable without a pointer.
      *
      * Requires `dropDownMenuFeature` of `@lensapp/drop-down-menu` to be registered: the menu
      * component is resolved through an injection token this package does not implement.

package/dist/src/plugins/drop-down-menu/drop-down-menu.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"drop-down-menu.d.ts","sourceRoot":"","sources":["../../../../src/plugins/drop-down-menu/drop-down-menu.tsx"],"names":[],"mappings":"AACA,OAAO,EAAgB,KAAK,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAGxF,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAQ/B,MAAM,MAAM,uBAAuB,GAAG;IACpC,QAAQ,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACpC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAE3B;;;;;;;;;;;;;;OAcG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,gBAAgB,CAAC;CAC3C,CAAC;AAsNF,eAAO,MAAM,kBAAkB;;;;;;;wBAzOT,KAAK,CAAC,SAAS;wBACf,MAAM;6BAiBD,gBAAgB;WAwP1C,CAAC"}
+{"version":3,"file":"drop-down-menu.d.ts","sourceRoot":"","sources":["../../../../src/plugins/drop-down-menu/drop-down-menu.tsx"],"names":[],"mappings":"AACA,OAAO,EAAgB,KAAK,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAGxF,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAQ/B,MAAM,MAAM,uBAAuB,GAAG;IACpC,QAAQ,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACpC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAE3B;;;;;;;;;;;;;;;;OAgBG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,gBAAgB,CAAC;CAC3C,CAAC;AA4OF,eAAO,MAAM,kBAAkB;;;;;;;wBAjQT,KAAK,CAAC,SAAS;wBACf,MAAM;6BAmBD,gBAAgB;WA8Q1C,CAAC"}

package/dist/src/plugins/focusable/_private/use-keyboard-navigation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-keyboard-navigation.d.ts","sourceRoot":"","sources":["../../../../../src/plugins/focusable/_private/use-keyboard-navigation.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,iCAAiC,EAAiC,MAAM,0BAA0B,CAAC;AAEjH,KAAK,kBAAkB,GAAG;IACxB,QAAQ,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,aAAa,KAAK,IAAI,CAAC;IACzD,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;IAC7B,QAAQ,CAAC,uBAAuB,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,UAAU,KAAK,IAAI,CAAC;CACrE,CAAC;AAQF,eAAO,MAAM,qBAAqB,YACvB,iCAAiC,CAAC,GAAG,CAAC,GAAG,SAAS,QACrD,OAAO,eACA,MAAM,GAAG,SAAS,WACtB,WAAW,GAAG,IAAI,KAC1B,kBAmGF,CAAC"}
+{"version":3,"file":"use-keyboard-navigation.d.ts","sourceRoot":"","sources":["../../../../../src/plugins/focusable/_private/use-keyboard-navigation.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,iCAAiC,EAAiC,MAAM,0BAA0B,CAAC;AAEjH,KAAK,kBAAkB,GAAG;IACxB,QAAQ,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,aAAa,KAAK,IAAI,CAAC;IACzD,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;IAC7B,QAAQ,CAAC,uBAAuB,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,UAAU,KAAK,IAAI,CAAC;CACrE,CAAC;AAQF,eAAO,MAAM,qBAAqB,YACvB,iCAAiC,CAAC,GAAG,CAAC,GAAG,SAAS,QACrD,OAAO,eACA,MAAM,GAAG,SAAS,WACtB,WAAW,GAAG,IAAI,KAC1B,kBAsGF,CAAC"}

package/dist/src/plugins/focusable/get-focusable-context.d.ts

@@ -13,13 +13,14 @@ export type FocusableContext<FocusedItem> = {
 export type KeyboardNavigationOrientation = "vertical" | "horizontal" | "both";
 /**
  * A focusable context whose members are also navigated with arrow keys, in the order they state.
- * The lowest order number is focused when the members appear, and focus returns to the enclosing
- * context when they go away.
+ * The lowest order number is focused when the members appear, unless the context says otherwise,
+ * and focus returns to the enclosing context when they go away.
  */
 export type KeyboardNavigableFocusableContext<FocusedItem> = {
     readonly id: string;
     readonly isKeyboardNavigable: true;
     readonly orientation: KeyboardNavigationOrientation;
+    readonly takesFocusAsItAppears: boolean;
     focusable: (item: FocusedItem, orderNumber: number) => $FocusableProps<FocusedItem>;
 };
 export type AnyFocusableContext<FocusedItem = any> = FocusableContext<FocusedItem> | KeyboardNavigableFocusableContext<FocusedItem>;
@@ -32,15 +33,24 @@ export declare const getFocusableContext: <FocusedItem>(id: string) => Focusable
 export type KeyboardNavigableFocusableContextOptions = {
     /**
      * Which arrow keys move focus. Downwards by default, as most sets of things are laid out: the
-     * keys of the other axis are then left to whatever the members want them for, such as a menu row
-     * opening the menu it holds with ArrowRight.
+     * keys of the other axis are then left to whatever the members want them for, such as a member
+     * opening something of its own with ArrowRight.
      */
     readonly orientation?: KeyboardNavigationOrientation;
+    /**
+     * Whether the lowest order number is focused as the members appear. It is by default: a set of
+     * members appearing is usually something the user asked for and will go on with. Not so for a set
+     * that appears because the pointer rests on something, where what the user is looking at is what
+     * the pointer is on, and focus stays there until either the pointer or the keyboard moves it.
+     */
+    readonly takesFocusAsItAppears?: boolean;
 };
 /**
  * Declares a focusable context whose members are navigated with arrow keys. As with
- * {@link getFocusableContext}, the same id always yields the same context — so the options are the
- * ones the first call for an id stated.
+ * {@link getFocusableContext}, the same id always yields the same context — the same id with the
+ * same options, that is. A context with other options is a context of its own, whatever it is
+ * named, so a surface that asks for its context by the same name with other options moves its
+ * members there as they render again, and they appear anew as far as that context is concerned.
  */
 export declare const getKeyboardNavigableFocusableContext: <FocusedItem>(id: string, options?: KeyboardNavigableFocusableContextOptions) => KeyboardNavigableFocusableContext<FocusedItem>;
 //# sourceMappingURL=get-focusable-context.d.ts.map

package/dist/src/plugins/focusable/get-focusable-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-focusable-context.d.ts","sourceRoot":"","sources":["../../../../src/plugins/focusable/get-focusable-context.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAExD,MAAM,MAAM,eAAe,CAAC,WAAW,IAAI,QAAQ,CAAC,oBAAoB,CAAC,WAAW,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;AAErG;;;GAGG;AACH,MAAM,MAAM,gBAAgB,CAAC,WAAW,IAAI;IAC1C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,mBAAmB,EAAE,KAAK,CAAC;IACpC,SAAS,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,eAAe,CAAC,WAAW,CAAC,CAAC;CAChE,CAAC;AAEF,uEAAuE;AACvE,MAAM,MAAM,6BAA6B,GAAG,UAAU,GAAG,YAAY,GAAG,MAAM,CAAC;AAE/E;;;;GAIG;AACH,MAAM,MAAM,iCAAiC,CAAC,WAAW,IAAI;IAC3D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,mBAAmB,EAAE,IAAI,CAAC;IACnC,QAAQ,CAAC,WAAW,EAAE,6BAA6B,CAAC;IACpD,SAAS,EAAE,CAAC,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,KAAK,eAAe,CAAC,WAAW,CAAC,CAAC;CACrF,CAAC;AAEF,MAAM,MAAM,mBAAmB,CAAC,WAAW,GAAG,GAAG,IAC7C,gBAAgB,CAAC,WAAW,CAAC,GAC7B,iCAAiC,CAAC,WAAW,CAAC,CAAC;AAInD;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAAI,WAAW,MAAO,MAAM,KAAG,gBAAgB,CAAC,WAAW,CASvF,CAAC;AAEL,MAAM,MAAM,wCAAwC,GAAG;IACrD;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,6BAA6B,CAAC;CACtD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,oCAAoC,GAAI,WAAW,MAC1D,MAAM,YACD,wCAAwC,KAChD,iCAAiC,CAAC,WAAW,CAU5C,CAAC"}
+{"version":3,"file":"get-focusable-context.d.ts","sourceRoot":"","sources":["../../../../src/plugins/focusable/get-focusable-context.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAExD,MAAM,MAAM,eAAe,CAAC,WAAW,IAAI,QAAQ,CAAC,oBAAoB,CAAC,WAAW,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;AAErG;;;GAGG;AACH,MAAM,MAAM,gBAAgB,CAAC,WAAW,IAAI;IAC1C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,mBAAmB,EAAE,KAAK,CAAC;IACpC,SAAS,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,eAAe,CAAC,WAAW,CAAC,CAAC;CAChE,CAAC;AAEF,uEAAuE;AACvE,MAAM,MAAM,6BAA6B,GAAG,UAAU,GAAG,YAAY,GAAG,MAAM,CAAC;AAE/E;;;;GAIG;AACH,MAAM,MAAM,iCAAiC,CAAC,WAAW,IAAI;IAC3D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,mBAAmB,EAAE,IAAI,CAAC;IACnC,QAAQ,CAAC,WAAW,EAAE,6BAA6B,CAAC;IACpD,QAAQ,CAAC,qBAAqB,EAAE,OAAO,CAAC;IACxC,SAAS,EAAE,CAAC,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,KAAK,eAAe,CAAC,WAAW,CAAC,CAAC;CACrF,CAAC;AAEF,MAAM,MAAM,mBAAmB,CAAC,WAAW,GAAG,GAAG,IAC7C,gBAAgB,CAAC,WAAW,CAAC,GAC7B,iCAAiC,CAAC,WAAW,CAAC,CAAC;AAInD;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAAI,WAAW,MAAO,MAAM,KAAG,gBAAgB,CAAC,WAAW,CASvF,CAAC;AAEL,MAAM,MAAM,wCAAwC,GAAG;IACrD;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,6BAA6B,CAAC;IAErD;;;;;OAKG;IACH,QAAQ,CAAC,qBAAqB,CAAC,EAAE,OAAO,CAAC;CAC1C,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,oCAAoC,GAAI,WAAW,MAC1D,MAAM,YACD,wCAAwC,KAChD,iCAAiC,CAAC,WAAW,CAiB/C,CAAC"}