@limonify/zest-ui 0.1.0

package/lib/utils/createChangeEventDetails.d.ts

@@ -0,0 +1,45 @@
+import type { GestureResponderEvent, NativeSyntheticEvent } from 'react-native';
+/**
+ * The native event associated with a change. In React Native there is no DOM
+ * event hierarchy; press interactions produce `GestureResponderEvent`s and
+ * everything else is a `NativeSyntheticEvent`. Events may be absent for
+ * imperative or initial state changes.
+ */
+export type ZestNativeEvent = GestureResponderEvent | NativeSyntheticEvent<unknown> | undefined;
+type ZestChangeEventDetail<Reason extends string, CustomProperties extends object> = {
+    /**
+     * The reason for the event.
+     */
+    reason: Reason;
+    /**
+     * The native event associated with the custom event, if any.
+     */
+    event: ZestNativeEvent;
+    /**
+     * Cancels Zest from handling the event.
+     */
+    cancel: () => void;
+    /**
+     * Allows the event to propagate in cases where Zest will stop the propagation.
+     */
+    allowPropagation: () => void;
+    /**
+     * Indicates whether the event has been canceled.
+     */
+    isCanceled: boolean;
+    /**
+     * Indicates whether the event is allowed to propagate.
+     */
+    isPropagationAllowed: boolean;
+} & CustomProperties;
+/**
+ * Details of custom change events emitted by Zest components.
+ */
+export type ZestChangeEventDetails<Reason extends string, CustomProperties extends object = {}> = Reason extends string ? ZestChangeEventDetail<Reason, CustomProperties> & {} : never;
+/**
+ * Creates a Zest event details object with the given reason and utilities
+ * for preventing Zest's internal event handling.
+ */
+export declare function createChangeEventDetails<Reason extends string, CustomProperties extends object = {}>(reason: Reason, event?: ZestNativeEvent, customProperties?: CustomProperties): ZestChangeEventDetails<Reason, CustomProperties>;
+export {};
+//# sourceMappingURL=createChangeEventDetails.d.ts.map

package/lib/utils/createChangeEventDetails.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createChangeEventDetails.d.ts","sourceRoot":"","sources":["../../src/utils/createChangeEventDetails.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAGhF;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GACvB,qBAAqB,GACrB,oBAAoB,CAAC,OAAO,CAAC,GAC7B,SAAS,CAAC;AAEd,KAAK,qBAAqB,CAAC,MAAM,SAAS,MAAM,EAAE,gBAAgB,SAAS,MAAM,IAAI;IACnF;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,KAAK,EAAE,eAAe,CAAC;IACvB;;OAEG;IACH,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB;;OAEG;IACH,gBAAgB,EAAE,MAAM,IAAI,CAAC;IAC7B;;OAEG;IACH,UAAU,EAAE,OAAO,CAAC;IACpB;;OAEG;IACH,oBAAoB,EAAE,OAAO,CAAC;CAC/B,GAAG,gBAAgB,CAAC;AAErB;;GAEG;AACH,MAAM,MAAM,sBAAsB,CAChC,MAAM,SAAS,MAAM,EACrB,gBAAgB,SAAS,MAAM,GAAG,EAAE,IAClC,MAAM,SAAS,MAAM,GAAG,qBAAqB,CAAC,MAAM,EAAE,gBAAgB,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;AAEzF;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,SAAS,MAAM,EACrB,gBAAgB,SAAS,MAAM,GAAG,EAAE,EAEpC,MAAM,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,eAAe,EACvB,gBAAgB,CAAC,EAAE,gBAAgB,GAClC,sBAAsB,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAsBlD"}

package/lib/utils/createChangeEventDetails.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createChangeEventDetails = createChangeEventDetails;
+const empty_1 = require("./empty");
+/**
+ * Creates a Zest event details object with the given reason and utilities
+ * for preventing Zest's internal event handling.
+ */
+function createChangeEventDetails(reason, event, customProperties) {
+    let canceled = false;
+    let allowPropagation = false;
+    const custom = customProperties !== null && customProperties !== void 0 ? customProperties : empty_1.EMPTY_OBJECT;
+    const details = {
+        reason,
+        event,
+        cancel() {
+            canceled = true;
+        },
+        allowPropagation() {
+            allowPropagation = true;
+        },
+        get isCanceled() {
+            return canceled;
+        },
+        get isPropagationAllowed() {
+            return allowPropagation;
+        },
+        ...custom,
+    };
+    return details;
+}
+//# sourceMappingURL=createChangeEventDetails.js.map

package/lib/utils/createChangeEventDetails.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createChangeEventDetails.js","sourceRoot":"","sources":["../../src/utils/createChangeEventDetails.ts"],"names":[],"mappings":";;AAqDA,4DA6BC;AAjFD,mCAAuC;AAgDvC;;;GAGG;AACH,SAAgB,wBAAwB,CAItC,MAAc,EACd,KAAuB,EACvB,gBAAmC;IAEnC,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,IAAI,gBAAgB,GAAG,KAAK,CAAC;IAC7B,MAAM,MAAM,GAAG,gBAAgB,aAAhB,gBAAgB,cAAhB,gBAAgB,GAAK,oBAAiC,CAAC;IACtE,MAAM,OAAO,GAAoD;QAC/D,MAAM;QACN,KAAK;QACL,MAAM;YACJ,QAAQ,GAAG,IAAI,CAAC;QAClB,CAAC;QACD,gBAAgB;YACd,gBAAgB,GAAG,IAAI,CAAC;QAC1B,CAAC;QACD,IAAI,UAAU;YACZ,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,IAAI,oBAAoB;YACtB,OAAO,gBAAgB,CAAC;QAC1B,CAAC;QACD,GAAG,MAAM;KACV,CAAC;IACF,OAAO,OAA2D,CAAC;AACrE,CAAC"}

package/lib/utils/empty.d.ts

@@ -0,0 +1,4 @@
+export declare function NOOP(): void;
+export declare const EMPTY_ARRAY: readonly any[];
+export declare const EMPTY_OBJECT: Readonly<{}>;
+//# sourceMappingURL=empty.d.ts.map

package/lib/utils/empty.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"empty.d.ts","sourceRoot":"","sources":["../../src/utils/empty.ts"],"names":[],"mappings":"AAAA,wBAAgB,IAAI,SAAK;AAEzB,eAAO,MAAM,WAAW,EAAE,SAAS,GAAG,EAAsB,CAAC;AAE7D,eAAO,MAAM,YAAY,cAAoB,CAAC"}

package/lib/utils/empty.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EMPTY_OBJECT = exports.EMPTY_ARRAY = void 0;
+exports.NOOP = NOOP;
+function NOOP() { }
+exports.EMPTY_ARRAY = Object.freeze([]);
+exports.EMPTY_OBJECT = Object.freeze({});
+//# sourceMappingURL=empty.js.map

package/lib/utils/empty.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"empty.js","sourceRoot":"","sources":["../../src/utils/empty.ts"],"names":[],"mappings":";;;AAAA,oBAAyB;AAAzB,SAAgB,IAAI,KAAI,CAAC;AAEZ,QAAA,WAAW,GAAmB,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAEhD,QAAA,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC"}

package/lib/utils/error.d.ts

@@ -0,0 +1,3 @@
+export declare function error(...messages: string[]): void;
+export declare function reset(): void;
+//# sourceMappingURL=error.d.ts.map

package/lib/utils/error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../src/utils/error.ts"],"names":[],"mappings":"AAKA,wBAAgB,KAAK,CAAC,GAAG,QAAQ,EAAE,MAAM,EAAE,QAQ1C;AAED,wBAAgB,KAAK,SAEpB"}

package/lib/utils/error.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.error = error;
+exports.reset = reset;
+let set;
+if (process.env.NODE_ENV !== 'production') {
+    set = new Set();
+}
+function error(...messages) {
+    if (process.env.NODE_ENV !== 'production') {
+        const messageKey = messages.join(' ');
+        if (!set.has(messageKey)) {
+            set.add(messageKey);
+            console.error(`Zest: ${messageKey}`);
+        }
+    }
+}
+function reset() {
+    set === null || set === void 0 ? void 0 : set.clear();
+}
+//# sourceMappingURL=error.js.map

package/lib/utils/error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.js","sourceRoot":"","sources":["../../src/utils/error.ts"],"names":[],"mappings":";;AAKA,sBAQC;AAED,sBAEC;AAjBD,IAAI,GAAgB,CAAC;AACrB,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,EAAE,CAAC;IAC1C,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;AAC1B,CAAC;AAED,SAAgB,KAAK,CAAC,GAAG,QAAkB;IACzC,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,EAAE,CAAC;QAC1C,MAAM,UAAU,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACtC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;YACzB,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;YACpB,OAAO,CAAC,KAAK,CAAC,SAAS,UAAU,EAAE,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAgB,KAAK;IACnB,GAAG,aAAH,GAAG,uBAAH,GAAG,CAAE,KAAK,EAAE,CAAC;AACf,CAAC"}

package/lib/utils/fastObjectShallowCompare.d.ts

@@ -0,0 +1,2 @@
+export declare function fastObjectShallowCompare<T extends Record<string, any> | null>(a: T, b: T): boolean;
+//# sourceMappingURL=fastObjectShallowCompare.d.ts.map

package/lib/utils/fastObjectShallowCompare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fastObjectShallowCompare.d.ts","sourceRoot":"","sources":["../../src/utils/fastObjectShallowCompare.ts"],"names":[],"mappings":"AAEA,wBAAgB,wBAAwB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,WA2BxF"}

package/lib/utils/fastObjectShallowCompare.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fastObjectShallowCompare = fastObjectShallowCompare;
+const is = Object.is;
+function fastObjectShallowCompare(a, b) {
+    if (a === b) {
+        return true;
+    }
+    if (!(a instanceof Object) || !(b instanceof Object)) {
+        return false;
+    }
+    let aLength = 0;
+    let bLength = 0;
+    /* eslint-disable guard-for-in */
+    for (const key in a) {
+        aLength += 1;
+        if (!is(a[key], b[key])) {
+            return false;
+        }
+        if (!(key in b)) {
+            return false;
+        }
+    }
+    for (const _ in b) {
+        bLength += 1;
+    }
+    return aLength === bLength;
+}
+//# sourceMappingURL=fastObjectShallowCompare.js.map

package/lib/utils/fastObjectShallowCompare.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fastObjectShallowCompare.js","sourceRoot":"","sources":["../../src/utils/fastObjectShallowCompare.ts"],"names":[],"mappings":";;AAEA,4DA2BC;AA7BD,MAAM,EAAE,GAAG,MAAM,CAAC,EAAE,CAAC;AAErB,SAAgB,wBAAwB,CAAuC,CAAI,EAAE,CAAI;IACvF,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACZ,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC,CAAC,CAAC,YAAY,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,MAAM,CAAC,EAAE,CAAC;QACrD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,OAAO,GAAG,CAAC,CAAC;IAEhB,iCAAiC;IACjC,KAAK,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC,CAAC;QAEb,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YACxB,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC;YAChB,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,KAAK,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC,CAAC;IACf,CAAC;IACD,OAAO,OAAO,KAAK,OAAO,CAAC;AAC7B,CAAC"}

package/lib/utils/formatNumber.d.ts

@@ -0,0 +1,3 @@
+export declare function getFormatter(locale?: Intl.LocalesArgument, options?: Intl.NumberFormatOptions): Intl.NumberFormat;
+export declare function formatNumber(value: number | null, locale?: Intl.LocalesArgument, options?: Intl.NumberFormatOptions): string;
+//# sourceMappingURL=formatNumber.d.ts.map

package/lib/utils/formatNumber.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatNumber.d.ts","sourceRoot":"","sources":["../../src/utils/formatNumber.ts"],"names":[],"mappings":"AAgBA,wBAAgB,YAAY,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,eAAe,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,mBAAmB,qBAY7F;AAED,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,GAAG,IAAI,EACpB,MAAM,CAAC,EAAE,IAAI,CAAC,eAAe,EAC7B,OAAO,CAAC,EAAE,IAAI,CAAC,mBAAmB,UAOnC"}

package/lib/utils/formatNumber.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getFormatter = getFormatter;
+exports.formatNumber = formatNumber;
+function stringifyLocale(locale) {
+    if (Array.isArray(locale)) {
+        return locale.map((value) => stringifyLocale(value)).join(',');
+    }
+    if (locale == null) {
+        return '';
+    }
+    return String(locale);
+}
+// Constructing an Intl.NumberFormat is expensive, and a number field re-formats
+// on every keystroke.
+const cache = new Map();
+function getFormatter(locale, options) {
+    const key = JSON.stringify({ locale: stringifyLocale(locale), options });
+    const cached = cache.get(key);
+    if (cached) {
+        return cached;
+    }
+    const formatter = new Intl.NumberFormat(locale, options);
+    cache.set(key, formatter);
+    return formatter;
+}
+function formatNumber(value, locale, options) {
+    if (value == null) {
+        return '';
+    }
+    return getFormatter(locale, options).format(value);
+}
+//# sourceMappingURL=formatNumber.js.map

package/lib/utils/formatNumber.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatNumber.js","sourceRoot":"","sources":["../../src/utils/formatNumber.ts"],"names":[],"mappings":";;AAgBA,oCAYC;AAED,oCAUC;AAxCD,SAAS,eAAe,CAAC,MAA6B;IACpD,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1B,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACjE,CAAC;IAED,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;QACnB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC;AACxB,CAAC;AAED,gFAAgF;AAChF,sBAAsB;AACtB,MAAM,KAAK,GAAG,IAAI,GAAG,EAA6B,CAAC;AAEnD,SAAgB,YAAY,CAAC,MAA6B,EAAE,OAAkC;IAC5F,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,eAAe,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;IACzE,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAE9B,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,YAAY,CAAC,MAAuC,EAAE,OAAO,CAAC,CAAC;IAC1F,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IAE1B,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAgB,YAAY,CAC1B,KAAoB,EACpB,MAA6B,EAC7B,OAAkC;IAElC,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;QAClB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACrD,CAAC"}

package/lib/utils/generateId.d.ts

@@ -0,0 +1,6 @@
+/**
+ * A unique id for things React's `useId` cannot cover — values created outside
+ * of rendering, like a toast pushed from an event handler.
+ */
+export declare function generateId(prefix: string): string;
+//# sourceMappingURL=generateId.d.ts.map

package/lib/utils/generateId.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateId.d.ts","sourceRoot":"","sources":["../../src/utils/generateId.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,UAGxC"}

package/lib/utils/generateId.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateId = generateId;
+let counter = 0;
+/**
+ * A unique id for things React's `useId` cannot cover — values created outside
+ * of rendering, like a toast pushed from an event handler.
+ */
+function generateId(prefix) {
+    counter += 1;
+    return `${prefix}-${Math.random().toString(36).slice(2, 6)}-${counter}`;
+}
+//# sourceMappingURL=generateId.js.map

package/lib/utils/generateId.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateId.js","sourceRoot":"","sources":["../../src/utils/generateId.ts"],"names":[],"mappings":";;AAMA,gCAGC;AATD,IAAI,OAAO,GAAG,CAAC,CAAC;AAEhB;;;GAGG;AACH,SAAgB,UAAU,CAAC,MAAc;IACvC,OAAO,IAAI,CAAC,CAAC;IACb,OAAO,GAAG,MAAM,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,OAAO,EAAE,CAAC;AAC1E,CAAC"}

package/lib/utils/getReactElementRef.d.ts

@@ -0,0 +1,7 @@
+import * as React from 'react';
+/**
+ * Extracts the `ref` from a React element.
+ * Zest requires React >= 19, where element refs live on `props`.
+ */
+export declare function getReactElementRef(element: unknown): React.Ref<unknown> | null;
+//# sourceMappingURL=getReactElementRef.d.ts.map

package/lib/utils/getReactElementRef.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getReactElementRef.d.ts","sourceRoot":"","sources":["../../src/utils/getReactElementRef.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,IAAI,CAQ9E"}

package/lib/utils/getReactElementRef.js

@@ -0,0 +1,50 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getReactElementRef = getReactElementRef;
+const React = __importStar(require("react"));
+/**
+ * Extracts the `ref` from a React element.
+ * Zest requires React >= 19, where element refs live on `props`.
+ */
+function getReactElementRef(element) {
+    var _a;
+    if (!React.isValidElement(element)) {
+        return null;
+    }
+    const propsWithRef = element.props;
+    return (_a = propsWithRef === null || propsWithRef === void 0 ? void 0 : propsWithRef.ref) !== null && _a !== void 0 ? _a : null;
+}
+//# sourceMappingURL=getReactElementRef.js.map

package/lib/utils/getReactElementRef.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getReactElementRef.js","sourceRoot":"","sources":["../../src/utils/getReactElementRef.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAMA,gDAQC;AAdD,6CAA+B;AAE/B;;;GAGG;AACH,SAAgB,kBAAkB,CAAC,OAAgB;;IACjD,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,CAAC;QACnC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,YAAY,GAAG,OAAO,CAAC,KAA6D,CAAC;IAE3F,OAAO,MAAA,YAAY,aAAZ,YAAY,uBAAZ,YAAY,CAAE,GAAG,mCAAI,IAAI,CAAC;AACnC,CAAC"}

package/lib/utils/mergeObjects.d.ts

@@ -0,0 +1,2 @@
+export declare function mergeObjects<A extends object | undefined, B extends object | undefined>(a: A, b: B): NonNullable<A> | NonNullable<B> | (A & B) | undefined;
+//# sourceMappingURL=mergeObjects.d.ts.map

package/lib/utils/mergeObjects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mergeObjects.d.ts","sourceRoot":"","sources":["../../src/utils/mergeObjects.ts"],"names":[],"mappings":"AAAA,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,GAAG,SAAS,EAAE,CAAC,SAAS,MAAM,GAAG,SAAS,EACrF,CAAC,EAAE,CAAC,EACJ,CAAC,EAAE,CAAC,yDAYL"}

package/lib/utils/mergeObjects.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mergeObjects = mergeObjects;
+function mergeObjects(a, b) {
+    if (a && !b) {
+        return a;
+    }
+    if (!a && b) {
+        return b;
+    }
+    if (a || b) {
+        return { ...a, ...b };
+    }
+    return undefined;
+}
+//# sourceMappingURL=mergeObjects.js.map

package/lib/utils/mergeObjects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mergeObjects.js","sourceRoot":"","sources":["../../src/utils/mergeObjects.ts"],"names":[],"mappings":";;AAAA,oCAcC;AAdD,SAAgB,YAAY,CAC1B,CAAI,EACJ,CAAI;IAEJ,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;QACZ,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;QACZ,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACX,OAAO,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;IACxB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/lib/utils/popups/BasePopupHandle.d.ts

@@ -0,0 +1,103 @@
+import { type ZestChangeEventDetails } from '../createChangeEventDetails';
+import { REASONS } from '../reasons';
+import type { PopupTriggerMap } from './PopupTriggerMap';
+/**
+ * The minimal store contract a handle exposes to detached triggers.
+ *
+ * Detached triggers read `store` during render and subscribe so they are notified
+ * when the handle switches between its fallback store and a mounted root's live
+ * store.
+ */
+export interface PopupHandleStoreProvider<HandleStore> {
+    readonly store: HandleStore;
+    subscribeStore(listener: () => void): () => void;
+}
+/**
+ * The store shape a handle needs to resolve a trigger by id.
+ */
+export interface PopupHandleStoreWithTriggers {
+    readonly context: {
+        readonly triggerNodes: PopupTriggerMap;
+    };
+}
+/**
+ * The store shape a handle needs to drive open state. Only the root-owned store
+ * needs this — the view exposed to detached triggers never has `setOpen` called
+ * on it.
+ */
+export interface PopupHandleStoreWithOpen extends PopupHandleStoreWithTriggers {
+    setOpen(open: boolean, eventDetails: ZestChangeEventDetails<typeof REASONS.imperativeAction>): void;
+}
+/**
+ * The shared implementation behind every popup handle: it coordinates detached
+ * triggers with a mounted root.
+ *
+ * Ported from upstream near-verbatim — it is pure state, and the only DOM in it
+ * was the trigger element's type (see `PopupTriggerMap`). Subclasses add the
+ * component-specific imperative methods; this owns the fallback store, the root
+ * attachment stack, and subscriber notification.
+ */
+export declare class BasePopupHandle<HandleStore extends PopupHandleStoreWithTriggers, Store extends HandleStore & PopupHandleStoreWithOpen> {
+    protected readonly fallbackStore: HandleStore;
+    private readonly componentName;
+    private readonly throwOnMissingTrigger;
+    /**
+     * The stores of every root currently using this handle, in attach order. A
+     * handle is meant for a single mounted root, but roots can transiently overlap
+     * (an animated screen transition, say), so this stack lets `attachStore`'s
+     * cleanup restore the previous root rather than leaving a still-mounted root
+     * uncontrollable when a newer one detaches first.
+     */
+    private readonly attachedStores;
+    private attachedStoreValue;
+    private readonly storeListeners;
+    /**
+     * @param fallbackStore An inert, closed store handed to detached triggers while
+     * no root is attached, so they can render and register without one. Triggers
+     * register into whichever store `store` resolves to and migrate themselves as
+     * roots attach and detach.
+     * @param componentName Prefixes dev warnings, e.g. `'Menu'` produces
+     * `MenuHandle.open()`.
+     * @param throwOnMissingTrigger Whether `open(triggerId)` throws when no trigger
+     * with that id is registered. Anchored popups (Menu, Popover) need a trigger to
+     * anchor to, so they throw; a Dialog is not anchored and opens unassociated
+     * with a warning instead.
+     */
+    constructor(fallbackStore: HandleStore, componentName: string, throwOnMissingTrigger?: boolean);
+    protected get attachedStore(): Store | null;
+    /**
+     * The store detached triggers read from: the attached root's, or the inert
+     * fallback while none is attached.
+     * @internal
+     */
+    get store(): HandleStore;
+    /** @internal */
+    subscribeStore(listener: () => void): () => void;
+    /**
+     * Points the handle at a root's store and notifies subscribers, so detached
+     * triggers re-render and re-register into it. Returns a cleanup that detaches.
+     * @internal
+     */
+    attachStore(newStore: Store): () => void;
+    private setActiveStore;
+    /**
+     * Opens the attached root, associating it with the trigger of the given id.
+     * A no-op while no root is attached.
+     *
+     * Call this from an event handler or an effect, never during rendering.
+     */
+    protected openByTrigger(triggerId: string | null | undefined): void;
+    /**
+     * Points the popup at the trigger it was opened by. Anchored popups override
+     * this to set the store's `triggerNode`, without which their positioner would
+     * have nothing to anchor to; an unanchored one (Dialog) has nothing to do.
+     */
+    protected associateTrigger(_store: Store, _triggerNode: unknown): void;
+    /**
+     * Closes the popup. A no-op while no root is attached.
+     *
+     * Call this from an event handler or an effect, never during rendering.
+     */
+    protected closePopup(): void;
+}
+//# sourceMappingURL=BasePopupHandle.d.ts.map

package/lib/utils/popups/BasePopupHandle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BasePopupHandle.d.ts","sourceRoot":"","sources":["../../../src/utils/popups/BasePopupHandle.ts"],"names":[],"mappings":"AACA,OAAO,EAA4B,KAAK,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACpG,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD;;;;;;GAMG;AACH,MAAM,WAAW,wBAAwB,CAAC,WAAW;IACnD,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,cAAc,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;CAClD;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,OAAO,EAAE;QAAE,QAAQ,CAAC,YAAY,EAAE,eAAe,CAAA;KAAE,CAAC;CAC9D;AAED;;;;GAIG;AACH,MAAM,WAAW,wBAAyB,SAAQ,4BAA4B;IAC5E,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,YAAY,EAAE,sBAAsB,CAAC,OAAO,OAAO,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAAC;CACrG;AAED;;;;;;;;GAQG;AACH,qBAAa,eAAe,CAC1B,WAAW,SAAS,4BAA4B,EAChD,KAAK,SAAS,WAAW,GAAG,wBAAwB;IA4BlD,SAAS,CAAC,QAAQ,CAAC,aAAa,EAAE,WAAW;IAC7C,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,qBAAqB;IA5BxC;;;;;;OAMG;IACH,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAe;IAE9C,OAAO,CAAC,kBAAkB,CAAsB;IAEhD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAyB;IAExD;;;;;;;;;;;OAWG;gBAEkB,aAAa,EAAE,WAAW,EAC5B,aAAa,EAAE,MAAM,EACrB,qBAAqB,GAAE,OAAc;IAGxD,SAAS,KAAK,aAAa,iBAE1B;IAED;;;;OAIG;IACH,IAAI,KAAK,IAAI,WAAW,CAEvB;IAED,gBAAgB;IAChB,cAAc,CAAC,QAAQ,EAAE,MAAM,IAAI;IAQnC;;;;OAIG;IACH,WAAW,CAAC,QAAQ,EAAE,KAAK;IAmC3B,OAAO,CAAC,cAAc;IAStB;;;;;OAKG;IACH,SAAS,CAAC,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAgD5D;;;;OAIG;IACH,SAAS,CAAC,gBAAgB,CAAC,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO;IAE/D;;;;OAIG;IACH,SAAS,CAAC,UAAU;CAerB"}

package/lib/utils/popups/BasePopupHandle.js

@@ -0,0 +1,174 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BasePopupHandle = void 0;
+const useAnimationFrame_1 = require("../../hooks/useAnimationFrame");
+const createChangeEventDetails_1 = require("../createChangeEventDetails");
+const reasons_1 = require("../reasons");
+/**
+ * The shared implementation behind every popup handle: it coordinates detached
+ * triggers with a mounted root.
+ *
+ * Ported from upstream near-verbatim — it is pure state, and the only DOM in it
+ * was the trigger element's type (see `PopupTriggerMap`). Subclasses add the
+ * component-specific imperative methods; this owns the fallback store, the root
+ * attachment stack, and subscriber notification.
+ */
+class BasePopupHandle {
+    /**
+     * @param fallbackStore An inert, closed store handed to detached triggers while
+     * no root is attached, so they can render and register without one. Triggers
+     * register into whichever store `store` resolves to and migrate themselves as
+     * roots attach and detach.
+     * @param componentName Prefixes dev warnings, e.g. `'Menu'` produces
+     * `MenuHandle.open()`.
+     * @param throwOnMissingTrigger Whether `open(triggerId)` throws when no trigger
+     * with that id is registered. Anchored popups (Menu, Popover) need a trigger to
+     * anchor to, so they throw; a Dialog is not anchored and opens unassociated
+     * with a warning instead.
+     */
+    constructor(fallbackStore, componentName, throwOnMissingTrigger = true) {
+        this.fallbackStore = fallbackStore;
+        this.componentName = componentName;
+        this.throwOnMissingTrigger = throwOnMissingTrigger;
+        /**
+         * The stores of every root currently using this handle, in attach order. A
+         * handle is meant for a single mounted root, but roots can transiently overlap
+         * (an animated screen transition, say), so this stack lets `attachStore`'s
+         * cleanup restore the previous root rather than leaving a still-mounted root
+         * uncontrollable when a newer one detaches first.
+         */
+        this.attachedStores = [];
+        this.attachedStoreValue = null;
+        this.storeListeners = new Set();
+    }
+    get attachedStore() {
+        return this.attachedStoreValue;
+    }
+    /**
+     * The store detached triggers read from: the attached root's, or the inert
+     * fallback while none is attached.
+     * @internal
+     */
+    get store() {
+        var _a;
+        return (_a = this.attachedStoreValue) !== null && _a !== void 0 ? _a : this.fallbackStore;
+    }
+    /** @internal */
+    subscribeStore(listener) {
+        this.storeListeners.add(listener);
+        return () => {
+            this.storeListeners.delete(listener);
+        };
+    }
+    /**
+     * Points the handle at a root's store and notifies subscribers, so detached
+     * triggers re-render and re-register into it. Returns a cleanup that detaches.
+     * @internal
+     */
+    attachStore(newStore) {
+        var _a;
+        this.attachedStores.push(newStore);
+        this.setActiveStore(newStore);
+        if (process.env.NODE_ENV !== 'production') {
+            if (this.attachedStores.length > 1) {
+                // More than one root is attached. This is usually a transient overlap
+                // during a screen transition, where the outgoing root unmounts shortly
+                // after the incoming one mounts. Defer a frame and only warn if the
+                // overlap is still there once things have settled, so a clean handoff
+                // stays quiet regardless of unmount timing.
+                const dev = this;
+                ((_a = dev.overlapWarningFrame) !== null && _a !== void 0 ? _a : (dev.overlapWarningFrame = useAnimationFrame_1.AnimationFrame.create())).request(() => {
+                    if (this.attachedStores.length > 1) {
+                        console.warn('Zest: A handle is attached to more than one mounted root at the same time. ' +
+                            'The most recently mounted root takes over and the previous one stops being controlled by the handle. ' +
+                            'A handle should be used by a single root that stays mounted for the lifetime of the handle.');
+                    }
+                });
+            }
+        }
+        return () => {
+            var _a;
+            const index = this.attachedStores.lastIndexOf(newStore);
+            if (index !== -1) {
+                this.attachedStores.splice(index, 1);
+            }
+            // Restore control to the most recently attached root that is still
+            // mounted, rather than detaching unconditionally.
+            this.setActiveStore((_a = this.attachedStores[this.attachedStores.length - 1]) !== null && _a !== void 0 ? _a : null);
+        };
+    }
+    setActiveStore(store) {
+        if (this.attachedStoreValue !== store) {
+            this.attachedStoreValue = store;
+            this.storeListeners.forEach((listener) => {
+                listener();
+            });
+        }
+    }
+    /**
+     * Opens the attached root, associating it with the trigger of the given id.
+     * A no-op while no root is attached.
+     *
+     * Call this from an event handler or an effect, never during rendering.
+     */
+    openByTrigger(triggerId) {
+        const attachedStore = this.attachedStore;
+        if (attachedStore === null) {
+            if (process.env.NODE_ENV !== 'production') {
+                console.warn(`Zest: ${this.componentName}Handle.open() was called while no root using this handle is mounted. ` +
+                    'The call was ignored; mount a root with this handle before opening it imperatively.');
+            }
+            return;
+        }
+        // A trigger normally lives in the active root's store, but during the commit
+        // in which a root attaches, a still-mounted detached trigger has not
+        // migrated yet — it is registered wherever it lived before. Search the whole
+        // stack (newest first) and the fallback, so an imperative open-by-id in that
+        // commit still resolves it.
+        let triggerNode;
+        if (triggerId) {
+            for (let i = this.attachedStores.length - 1; i >= 0 && triggerNode === undefined; i -= 1) {
+                triggerNode = this.attachedStores[i].context.triggerNodes.getById(triggerId);
+            }
+            triggerNode !== null && triggerNode !== void 0 ? triggerNode : (triggerNode = this.fallbackStore.context.triggerNodes.getById(triggerId));
+        }
+        if (triggerId && triggerNode === undefined) {
+            if (this.throwOnMissingTrigger) {
+                throw new Error(`Zest: ${this.componentName}Handle.open() was called with the trigger id "${triggerId}", ` +
+                    'but no matching trigger is registered with this handle. ' +
+                    'An anchored popup cannot open without a trigger to anchor to. ' +
+                    `Pass the id of a mounted ${this.componentName}.Trigger that has this handle set on its "handle" prop.`);
+            }
+            if (process.env.NODE_ENV !== 'production') {
+                console.warn(`Zest: ${this.componentName}Handle.open: No trigger found with id "${triggerId}". ` +
+                    'The popup will open, but the trigger will not be associated with it.');
+            }
+        }
+        this.associateTrigger(attachedStore, triggerNode);
+        attachedStore.setOpen(true, (0, createChangeEventDetails_1.createChangeEventDetails)(reasons_1.REASONS.imperativeAction));
+    }
+    /**
+     * Points the popup at the trigger it was opened by. Anchored popups override
+     * this to set the store's `triggerNode`, without which their positioner would
+     * have nothing to anchor to; an unanchored one (Dialog) has nothing to do.
+     */
+    associateTrigger(_store, _triggerNode) { }
+    /**
+     * Closes the popup. A no-op while no root is attached.
+     *
+     * Call this from an event handler or an effect, never during rendering.
+     */
+    closePopup() {
+        const attachedStore = this.attachedStore;
+        if (attachedStore === null) {
+            if (process.env.NODE_ENV !== 'production') {
+                console.warn(`Zest: ${this.componentName}Handle.close() was called while no root using this handle is mounted. ` +
+                    'The call was ignored.');
+            }
+            return;
+        }
+        attachedStore.setOpen(false, (0, createChangeEventDetails_1.createChangeEventDetails)(reasons_1.REASONS.imperativeAction));
+    }
+}
+exports.BasePopupHandle = BasePopupHandle;
+//# sourceMappingURL=BasePopupHandle.js.map