@dropins/tools 1.6.0-alpha999 → 1.6.0-beta2

package/types/elsie/src/lib/get-price-formatter.d.ts

@@ -0,0 +1,34 @@
+/********************************************************************
+ *  Copyright 2025 Adobe
+ *  All Rights Reserved.
+ *
+ * NOTICE:  Adobe permits you to use, modify, and distribute this
+ * file in accordance with the terms of the Adobe license agreement
+ * accompanying it.
+ *******************************************************************/
+export interface PriceFormatterOptions {
+    currency?: string | null;
+    locale?: string;
+    formatOptions?: Intl.NumberFormatOptions;
+}
+/**
+ * Determines the effective locale to use for price formatting
+ * Priority: prop locale > global locale > browser locale > default 'en-US'
+ */
+export declare function getEffectiveLocale(locale?: string): string;
+/**
+ * Gets an Intl.NumberFormat instance for price formatting
+ * Uses getEffectiveLocale internally to determine the best locale
+ *
+ * @example
+ * // Single price formatting
+ * const formatter = getPriceFormatter({ currency: 'USD', locale: 'en-US' });
+ * const price = formatter.format(10.99); // "$10.99"
+ *
+ * @example
+ * // Bulk price formatting (more efficient)
+ * const formatter = getPriceFormatter({ currency: 'EUR', locale: 'fr-FR' });
+ * const prices = [10.99, 25.50, 99.99].map(amount => formatter.format(amount));
+ */
+export declare function getPriceFormatter(options?: PriceFormatterOptions): Intl.NumberFormat;
+//# sourceMappingURL=get-price-formatter.d.ts.map

package/types/elsie/src/lib/index.d.ts

@@ -24,4 +24,5 @@ export * from './is-number';
 export * from './deviceUtils';
 export * from './get-path-value';
 export * from './get-cookie';
+export * from './get-price-formatter';
 //# sourceMappingURL=index.d.ts.map

package/types/elsie/src/lib/slot.d.ts

@@ -13,6 +13,7 @@ interface SlotElement {
     prependChild: MutateElement;
     appendSibling: MutateElement;
     prependSibling: MutateElement;
+    remove: () => void;
 }
 interface PrivateContext<T> {
     _setProps: (s: StateUpdater<{}>) => void;
@@ -27,13 +28,14 @@ interface DefaultSlotContext<T> extends PrivateContext<T> {
     prependChild: MutateElement;
     appendSibling: MutateElement;
     prependSibling: MutateElement;
+    remove: () => void;
     onRender: (cb: (next: T & DefaultSlotContext<T>) => void) => void;
     onChange: (cb: (next: T & DefaultSlotContext<T>) => void) => void;
 }
 type Context<T> = T & ThisType<DefaultSlotContext<T>>;
 export type SlotProps<T = any> = (ctx: T & DefaultSlotContext<T>, element: HTMLDivElement | null) => Promise<void> | void;
 export type SlotMethod<P = any> = (callback: (next: unknown, state: State) => P) => void;
-export declare function useSlot<K, V extends HTMLElement>(name: string, context?: Context<K>, callback?: SlotProps<K>, children?: ComponentChildren, render?: Function, contentTag?: keyof HTMLElementTagNameMap): [RefObject<V>, Record<string, any>];
+export declare function useSlot<K, V extends HTMLElement>(name: string, context?: Context<K>, callback?: SlotProps<K>, children?: ComponentChildren, render?: Function, contentTag?: keyof HTMLElementTagNameMap): [RefObject<V>, Record<string, any>, 'loading' | 'pending' | 'ready'];
 interface SlotPropsComponent<T> extends Omit<HTMLAttributes<HTMLElement>, 'slot'> {
     name: string;
     lazy?: boolean;

package/types/fetch-graphql/src/index.d.ts

@@ -32,15 +32,20 @@ export type AfterHook<T = any> = (requestInit: RequestInit, response: {
     data: T;
 };
 declare class FetchGraphQLMesh {
-    _endpoint?: string;
-    get endpoint(): string | undefined;
-    get fetchGraphQlHeaders(): Header;
+    protected _endpoint?: string;
     _fetchGraphQlHeaders: Header;
     _beforeHooks: BeforeHook[];
     _afterHooks: AfterHook[];
+    get endpoint(): string | undefined;
+    get fetchGraphQlHeaders(): Header;
     /**
      * Sets the GraphQL endpoint.
-     * @param endpoint - The GraphQL endpoint.
+     * @param endpoint - The GraphQL endpoint URL string.
+     * @example
+     * ```js
+     * // Set endpoint as string
+     * instance.setEndpoint('https://api.example.com/graphql');
+     * ```
      */
     setEndpoint(endpoint: string): void;
     /**
@@ -106,6 +111,16 @@ declare class FetchGraphQLMesh {
      * ```
      */
     addAfterHook(hook: AfterHook): void;
+    /**
+     * Collects all before hooks. Can be overridden by subclasses for inheritance.
+     * @protected
+     */
+    protected _collectBeforeHooks(): BeforeHook[];
+    /**
+     * Collects all after hooks. Can be overridden by subclasses for inheritance.
+     * @protected
+     */
+    protected _collectAfterHooks(): AfterHook[];
     /**
      * Fetches GraphQL data.
      * @param query - The GraphQL query.
@@ -143,14 +158,75 @@ declare class FetchGraphQLMesh {
 }
 /**
  * `FetchGraphQL` is a class that extends `FetchGraphQLMesh`.
- * It provides methods to get the GraphQL endpoint and headers.
+ * It provides methods to get the GraphQL endpoint and headers with support for inheritance.
  *
  * @class
  *
  */
 export declare class FetchGraphQL extends FetchGraphQLMesh {
+    private _mode;
+    private _source?;
     get endpoint(): string | undefined;
     get fetchGraphQlHeaders(): Header;
+    /**
+     * Sets the GraphQL endpoint or links to another FetchGraphQL instance.
+     * @param endpoint - The GraphQL endpoint URL string, or a FetchGraphQL instance to link to.
+     * @example
+     * ```js
+     * // Set endpoint as string
+     * instance.setEndpoint('https://api.example.com/graphql');
+     *
+     * // Link to another instance
+     * const parent = new FetchGraphQL();
+     * parent.setEndpoint('https://api.example.com/graphql');
+     *
+     * const child = new FetchGraphQL();
+     * child.setEndpoint(parent); // Links to parent, shares endpoint, headers, and hooks
+     * ```
+     */
+    setEndpoint(endpoint: string | FetchGraphQL): void;
+    /**
+     * Sets a GraphQL header. When linked to another instance, this sets the header on the linked instance.
+     * @param key - The key of the header.
+     * @param value - The value of the header.
+     */
+    setFetchGraphQlHeader(key: string, value: string | null): void;
+    /**
+     * Sets the GraphQL headers. When linked to another instance, this sets the headers on the linked instance.
+     * @param header - The header object or a function that returns a header object.
+     */
+    setFetchGraphQlHeaders(header: Header | ((prev: Header) => Header)): void;
+    /**
+     * Removes a specific GraphQL header. When linked to another instance, this removes the header from the linked instance.
+     * @param key - The key of the header.
+     */
+    removeFetchGraphQlHeader(key: string): void;
+    /**
+     * Gets the value of a specific GraphQL header. When linked to another instance, this gets the header from the linked instance.
+     * @param key - The key of the header.
+     * @returns The value of the header, or undefined if not found.
+     */
+    getFetchGraphQlHeader(key: string): string | null | undefined;
+    /**
+     * Adds a before hook. When linked to another instance, this adds the hook to the linked instance.
+     * @param hook - The hook function.
+     */
+    addBeforeHook(hook: BeforeHook): void;
+    /**
+     * Adds an after hook. When linked to another instance, this adds the hook to the linked instance.
+     * @param hook - The hook function.
+     */
+    addAfterHook(hook: AfterHook): void;
+    /**
+     * Collects all before hooks. When linked, delegates to the linked instance.
+     * @protected
+     */
+    protected _collectBeforeHooks(): BeforeHook[];
+    /**
+     * Collects all after hooks. When linked, delegates to the linked instance.
+     * @protected
+     */
+    protected _collectAfterHooks(): AfterHook[];
 }
 /**
  * Exports several methods from the `mesh` object.
@@ -162,6 +238,8 @@ export declare class FetchGraphQL extends FetchGraphQLMesh {
  * @property {Function} removeFetchGraphQlHeader - Removes a specific GraphQL header.
  * @property {Function} fetchGraphQl - Fetches GraphQL data.
  * @property {Function} getConfig - Gets the configuration.
+ * @property {Function} addBeforeHook - Adds a hook executed before the GraphQL call.
+ * @property {Function} addAfterHook - Adds a hook executed after the GraphQL call.
  */
 export declare const setEndpoint: (endpoint: string) => void, setFetchGraphQlHeaders: (header: Header | ((prev: Header) => Header)) => void, setFetchGraphQlHeader: (key: string, value: string | null) => void, getFetchGraphQlHeader: (key: string) => string | null | undefined, removeFetchGraphQlHeader: (key: string) => void, fetchGraphQl: <T = any>(query: string, options?: FetchOptions) => Promise<{
     errors?: FetchQueryError | undefined;

package/chunks/deviceUtils.js

@@ -1,4 +0,0 @@
-/*! Copyright 2025 Adobe
-All Rights Reserved. */
-const s=(e,o)=>{let t;return function(...n){clearTimeout(t),t=setTimeout(()=>e.apply(this,n),o)}},i=e=>typeof e=="number",c=()=>{const e=navigator.userAgent.toLowerCase(),o=/ipad|iphone|ipod/.test(e),t=e.includes("mac")&&"ontouchend"in document;return o||t};export{c as a,s as d,i};
-//# sourceMappingURL=deviceUtils.js.map

package/chunks/deviceUtils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"deviceUtils.js","sources":["/@dropins/tools/src/lib/debounce.ts","/@dropins/tools/src/lib/is-number.ts","/@dropins/tools/src/lib/deviceUtils.ts"],"sourcesContent":["/********************************************************************\n *  Copyright 2024 Adobe\n *  All Rights Reserved.\n *\n * NOTICE:  Adobe permits you to use, modify, and distribute this \n * file in accordance with the terms of the Adobe license agreement \n * accompanying it. \n *******************************************************************/\n\nexport const debounce = (fn: Function, ms: number) => {\n  let timeoutId: ReturnType<typeof setTimeout>;\n  return function (this: any, ...args: any[]) {\n    clearTimeout(timeoutId);\n    timeoutId = setTimeout(() => fn.apply(this, args), ms);\n  };\n};\n","/********************************************************************\n *  Copyright 2024 Adobe\n *  All Rights Reserved.\n *\n * NOTICE:  Adobe permits you to use, modify, and distribute this \n * file in accordance with the terms of the Adobe license agreement \n * accompanying it. \n *******************************************************************/\n\nexport const isNumber = (value: number | string): value is number => {\n  return typeof value === 'number';\n};\n","/********************************************************************\n *  Copyright 2024 Adobe\n *  All Rights Reserved.\n *\n * NOTICE:  Adobe permits you to use, modify, and distribute this \n * file in accordance with the terms of the Adobe license agreement \n * accompanying it. \n *******************************************************************/\n\nexport const isIOSMobileDevice = () => {\n  const userAgent = navigator.userAgent.toLowerCase();\n  const isIOS = /ipad|iphone|ipod/.test(userAgent);\n  const isMacWithTouch = userAgent.includes('mac') && 'ontouchend' in document;\n\n  return isIOS || isMacWithTouch;\n};\n"],"names":["debounce","fn","ms","timeoutId","args","isNumber","value","isIOSMobileDevice","userAgent","isIOS","isMacWithTouch"],"mappings":"AASa,MAAAA,EAAW,CAACC,EAAcC,IAAe,CAChD,IAAAC,EACJ,OAAO,YAAwBC,EAAa,CAC1C,aAAaD,CAAS,EACtBA,EAAY,WAAW,IAAMF,EAAG,MAAM,KAAMG,CAAI,EAAGF,CAAE,CACvD,CACF,ECNaG,EAAYC,GAChB,OAAOA,GAAU,SCDbC,EAAoB,IAAM,CAC/B,MAAAC,EAAY,UAAU,UAAU,YAAY,EAC5CC,EAAQ,mBAAmB,KAAKD,CAAS,EACzCE,EAAiBF,EAAU,SAAS,KAAK,GAAK,eAAgB,SAEpE,OAAOC,GAASC,CAClB"}