@lmb-it/kitsconcerto-native 0.1.259 → 0.1.260

package/index.d.ts

@@ -1785,6 +1785,38 @@ export interface ISelectBase<T extends FieldValues = any> extends IElementBase<T
     filterBy?: string;
     emptyFilterMessage?: ReactNode;
     virtualScroll?: boolean;
+    /**
+     * Open the options in a popup that owns the screen instead of a panel
+     * anchored to the trigger.
+     *
+     * ⛔ IT LIVES HERE, ON THE ELEMENT BASE, AND FOR ONE RELEASE IT DID NOT.
+     * 0.1.259 declared it on `ISelectCore` — the select COMPONENT's props — and
+     * shipped. The runtime was right end to end: `form-renderer`'s Select field
+     * pulls `popup` off the element and hands it to the select. But every select
+     * in a consumer's form is a form ELEMENT, and an element reads THIS
+     * interface, so `popup: true` in a form config was TS2353 and nobody could
+     * turn the feature on. AlphaMatch tried it on six pickers, took six errors,
+     * and reverted the lot.
+     *
+     * ⚠️ THE TWO BASES MUST STAY IN STEP. `ISelectCore` is the component side of
+     * this same decision and carries `popup` for every shape; this is its
+     * element-side mirror. A prop on one and not the other is what a consumer
+     * meets as "the feature exists and I cannot use it".
+     *
+     * ── WHAT THE RUNTIME HONOURS ───────────────────────────────────────────
+     * The NATIVE Dropdown and the NATIVE MultiSelect, through
+     * `form/selects/helpers/SelectPopupOverlay.native.tsx`. ⚠️ Tags, ListBox,
+     * TreeSelect and CascadeSelect accept it and draw nothing, and so does every
+     * web build — on web the options render in PrimeReact's own overlay, which
+     * is not boxed in by an on-screen keyboard, so there is no fault to escape.
+     *
+     * ⚠️ ACCEPTED-AND-INERT IS DELIBERATE, NOT AN OVERSIGHT: a shared element
+     * array stays valid on both surfaces rather than making a consumer branch on
+     * platform. Same contract, same wording, as `ISelectCore`.
+     *
+     * Default false: every existing consumer keeps the anchored panel.
+     */
+    popup?: boolean;
 }
 export interface IFormSelect<T extends FieldValues = any> extends ISelectBase<T> {
     type: 'Select';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lmb-it/kitsconcerto-native",
-  "version": "0.1.259",
+  "version": "0.1.260",
   "description": "KitsConcerto — Native (React Native) UI components",
   "main": "index.cjs",
   "module": "index.js",