@k8slens/element-components 3.9.0 → 3.9.2

package/dist/src/plugins/anchor/anchor.d.ts

@@ -36,6 +36,24 @@ export type AnchorPluginProps = {
      */
     readonly $anchoredAt?: AnchoredAt;
 };
+/**
+ * Lets {@link useAnchorNameFor} name an element as an anchor. A plugin whose wrapper may anchor
+ * what it renders to the element itself adds this to the element's `$className`. The name follows
+ * only when nothing else anchors the element, so the class alone changes nothing.
+ */
+export declare const anchorableClassName: string;
+/**
+ * The anchor name for what a plugin's wrapper renders beside its element and positions with
+ * `$anchoredAt` — a menu, say: that of the nearest `$anchor` around the element, the element's own
+ * included, or failing that a name of the element's own, which this gives it. Render what is
+ * positioned inside {@link AnchorNameProvider} with the returned name, so it finds its anchor.
+ *
+ * The element needs {@link anchorableClassName} for a name of its own to take effect, and is named
+ * only while `isAnchoring`: while what is positioned against it is shown.
+ */
+export declare const useAnchorNameFor: (elementRef: React.RefObject<HTMLElement | null>, isAnchoring: boolean) => string | undefined;
+/** Tells what is rendered inside which anchor to position against; see {@link useAnchorNameFor}. */
+export declare const AnchorNameProvider: React.Provider<string | undefined>;
 export declare const anchorPlugin: import("@k8slens/element-component").Plugin<{
     $className?: import("@k8slens/public-utilities").IClassName;
     className?: string;

package/dist/src/plugins/anchor/anchor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"anchor.d.ts","sourceRoot":"","sources":["../../../../src/plugins/anchor/anchor.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,KAAK,UAAU,EAAsB,MAAM,kBAAkB,CAAC;AASvE;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GACtB,KAAK,GACL,QAAQ,GACR,MAAM,GACN,OAAO,GACP,eAAe,GACf,gBAAgB,GAChB,kBAAkB,GAClB,mBAAmB,GACnB,eAAe,GACf,kBAAkB,GAClB,gBAAgB,GAChB,mBAAmB,CAAC;AAExB;;;GAGG;AACH,MAAM,MAAM,UAAU,GAClB,cAAc,GACd;IACE,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAElC,oEAAoE;IACpE,QAAQ,CAAC,GAAG,CAAC,EAAE,UAAU,CAAC;IAE1B,0DAA0D;IAC1D,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC;CAC7B,CAAC;AAIN,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAEpC;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAE3B;;;;;;OAMG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,UAAU,CAAC;CACnC,CAAC;AAqJF,eAAO,MAAM,YAAY;;;;;;;;;;;;;wBArKH,KAAK,CAAC,SAAS;uBAMhB,OAAO;2BASH,UAAU;WAmMjC,CAAC"}
+{"version":3,"file":"anchor.d.ts","sourceRoot":"","sources":["../../../../src/plugins/anchor/anchor.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,KAAK,UAAU,EAAsB,MAAM,kBAAkB,CAAC;AASvE;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GACtB,KAAK,GACL,QAAQ,GACR,MAAM,GACN,OAAO,GACP,eAAe,GACf,gBAAgB,GAChB,kBAAkB,GAClB,mBAAmB,GACnB,eAAe,GACf,kBAAkB,GAClB,gBAAgB,GAChB,mBAAmB,CAAC;AAExB;;;GAGG;AACH,MAAM,MAAM,UAAU,GAClB,cAAc,GACd;IACE,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAElC,oEAAoE;IACpE,QAAQ,CAAC,GAAG,CAAC,EAAE,UAAU,CAAC;IAE1B,0DAA0D;IAC1D,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC;CAC7B,CAAC;AAIN,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAEpC;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAE3B;;;;;;OAMG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,UAAU,CAAC;CACnC,CAAC;AAIF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,QAAgB,CAAC;AAEjD;;;;;;;;GAQG;AACH,eAAO,MAAM,gBAAgB,eAAgB,KAAK,CAAC,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,eAAe,OAAO,uBAkCrG,CAAC;AAIF,oGAAoG;AACpG,eAAO,MAAM,kBAAkB,oCAA6B,CAAC;AAmJ7D,eAAO,MAAM,YAAY;;;;;;;;;;;;;wBA9NH,KAAK,CAAC,SAAS;uBAMhB,OAAO;2BASH,UAAU;WA4PjC,CAAC"}

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

@@ -8,8 +8,10 @@ export type DropDownMenuPluginProps = {
      * from `@k8slens/drop-down-menu-contracts`; the items come from the contributions registered for
      * the kind.
      *
-     * The menu positions itself against the nearest anchor around it, so the element — or something
-     * enclosing it — declares `$anchor`.
+     * The menu positions itself against the nearest `$anchor` around the element, or against the
+     * element itself when there is none. Declare `$anchor` on an enclosing element to have the menu
+     * line up with that instead, as a menu opened from one half of a split button lines up with the
+     * whole of it.
      *
      * 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

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;;;;;;;;;;;;;;;;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"}
+{"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;AAU/B,MAAM,MAAM,uBAAuB,GAAG;IACpC,QAAQ,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACpC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAE3B;;;;;;;;;;;;;;;;;;OAkBG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,gBAAgB,CAAC;CAC3C,CAAC;AAqPF,eAAO,MAAM,kBAAkB;;;;;;;wBA5QT,KAAK,CAAC,SAAS;wBACf,MAAM;6BAqBD,gBAAgB;WA6RzC,CAAC"}