@scaleflex/asset-picker 0.2.11 → 0.2.13

package/dist/{asset-picker-Cd9cgAZ6.js → asset-picker-DCcLalcQ.js}

@@ -13203,5 +13203,6 @@ Tt([
   p({ type: Object })
 ], Ge.prototype, "config");
 export {
-  Ge as A
+  Ge as A,
+  rr as g
 };

package/dist/define.cjs

@@ -1 +1 @@
-"use strict";const e=require("./asset-picker-BvXr_8iN.cjs");typeof customElements<"u"&&!customElements.get("sfx-asset-picker")&&customElements.define("sfx-asset-picker",e.AssetPicker);
+"use strict";const e=require("./asset-picker-CMsm4Ewp.cjs");typeof customElements<"u"&&!customElements.get("sfx-asset-picker")&&customElements.define("sfx-asset-picker",e.AssetPicker);

package/dist/define.js

@@ -1,2 +1,2 @@
-import { A as e } from "./asset-picker-Cd9cgAZ6.js";
+import { A as e } from "./asset-picker-DCcLalcQ.js";
 typeof customElements < "u" && !customElements.get("sfx-asset-picker") && customElements.define("sfx-asset-picker", e);

package/dist/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./asset-picker-BvXr_8iN.cjs");exports.AssetPicker=e.AssetPicker;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const s=require("./asset-picker-CMsm4Ewp.cjs");function l(t){return(t.type??"").startsWith("image")}function d(t){return(t.type??"").startsWith("video")}function h(t){return(t.type??"").startsWith("audio")}function u(t){var i,e;return((i=t.url)==null?void 0:i.cdn)??((e=t.url)==null?void 0:e.public)??""}function A(t,i){const{meta:e,name:f}=t;if(e!=null&&e.alt)return e.alt;const n=e==null?void 0:e.title;if(typeof n=="string"&&n)return n;if(n&&typeof n=="object"){if(i){const r=n[i];if(r)return r}const o=Object.keys(n)[0];if(o){const r=n[o];if(r)return r}}return f.split(".")[0]}function c(t){var i,e;return((i=t.info)==null?void 0:i.img_w)??((e=t.info)==null?void 0:e.video_w)??0}function g(t){var i,e;return((i=t.info)==null?void 0:i.img_h)??((e=t.info)==null?void 0:e.video_h)??0}function a(t){return{width:c(t),height:g(t)}}function y(t){return s.getHlsUrl(t)!==null}function U(t){return s.getHlsUrl(t)}function p(t){return s.getHlsUrl(t)??u(t)}exports.AssetPicker=s.AssetPicker;exports.getAltText=A;exports.getAssetDimensions=a;exports.getAssetHeight=g;exports.getAssetWidth=c;exports.getBestVideoUrl=p;exports.getCdnUrl=u;exports.getTranscodedUrl=U;exports.isAudio=h;exports.isImage=l;exports.isTranscoded=y;exports.isVideo=d;

package/dist/index.d.ts

@@ -5,4 +5,5 @@ export type { Folder } from './types/folder.types';
 export type { Label } from './types/label.types';
 export type { FilterKey, FilterOperator, FilterLogic, AnyFilterKey, AnyFilter, StringFilter, DateFilter, FiltersState, MetadataFieldType, MetadataModelField, FiltersConfig } from './types/filter.types';
 export type { AssetPickerSelectDetail, AssetPickerCancelDetail, FolderSelectDetail } from './types/events.types';
+export { getAltText, getCdnUrl, getAssetWidth, getAssetHeight, getAssetDimensions, isTranscoded, getTranscodedUrl, getBestVideoUrl, isVideo, isImage, isAudio, } from './utils/asset-helpers';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,YAAY,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,UAAU,EAAE,oBAAoB,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC3L,YAAY,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAClF,YAAY,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AACnD,YAAY,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AACjD,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,WAAW,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1M,YAAY,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,YAAY,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,UAAU,EAAE,oBAAoB,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC3L,YAAY,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAClF,YAAY,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AACnD,YAAY,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AACjD,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,WAAW,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1M,YAAY,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAGjH,OAAO,EACL,UAAU,EACV,SAAS,EACT,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,OAAO,EACP,OAAO,EACP,OAAO,GACR,MAAM,uBAAuB,CAAC"}

package/dist/index.js

@@ -1,4 +1,70 @@
-import { A as s } from "./asset-picker-Cd9cgAZ6.js";
+import { g as o } from "./asset-picker-DCcLalcQ.js";
+import { A as b } from "./asset-picker-DCcLalcQ.js";
+function d(t) {
+  return (t.type ?? "").startsWith("image");
+}
+function h(t) {
+  return (t.type ?? "").startsWith("video");
+}
+function p(t) {
+  return (t.type ?? "").startsWith("audio");
+}
+function s(t) {
+  var i, n;
+  return ((i = t.url) == null ? void 0 : i.cdn) ?? ((n = t.url) == null ? void 0 : n.public) ?? "";
+}
+function y(t, i) {
+  const { meta: n, name: f } = t;
+  if (n != null && n.alt) return n.alt;
+  const r = n == null ? void 0 : n.title;
+  if (typeof r == "string" && r) return r;
+  if (r && typeof r == "object") {
+    if (i) {
+      const e = r[i];
+      if (e) return e;
+    }
+    const u = Object.keys(r)[0];
+    if (u) {
+      const e = r[u];
+      if (e) return e;
+    }
+  }
+  return f.split(".")[0];
+}
+function c(t) {
+  var i, n;
+  return ((i = t.info) == null ? void 0 : i.img_w) ?? ((n = t.info) == null ? void 0 : n.video_w) ?? 0;
+}
+function g(t) {
+  var i, n;
+  return ((i = t.info) == null ? void 0 : i.img_h) ?? ((n = t.info) == null ? void 0 : n.video_h) ?? 0;
+}
+function A(t) {
+  return {
+    width: c(t),
+    height: g(t)
+  };
+}
+function a(t) {
+  return o(t) !== null;
+}
+function m(t) {
+  return o(t);
+}
+function U(t) {
+  return o(t) ?? s(t);
+}
 export {
-  s as AssetPicker
+  b as AssetPicker,
+  y as getAltText,
+  A as getAssetDimensions,
+  g as getAssetHeight,
+  c as getAssetWidth,
+  U as getBestVideoUrl,
+  s as getCdnUrl,
+  m as getTranscodedUrl,
+  p as isAudio,
+  d as isImage,
+  a as isTranscoded,
+  h as isVideo
 };

package/dist/react.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t=require("react");typeof customElements<"u"&&Promise.resolve().then(()=>require("./define.cjs"));const g=t.forwardRef(function({config:a,open:o,onSelect:l,onSelectWithFolders:i,onCancel:d,className:y,style:P},k){const r=t.useRef(null),n=t.useRef(l),c=t.useRef(i),u=t.useRef(d);return t.useLayoutEffect(()=>{n.current=l,c.current=i,u.current=d}),t.useImperativeHandle(k,()=>({open(){var e;(e=r.current)==null||e.open()},close(){var e;(e=r.current)==null||e.close()}})),t.useLayoutEffect(()=>{const e=r.current;e&&(e.config=a)},[a]),t.useEffect(()=>{const e=r.current;e&&(o===!0?e.open():o===!1&&e.close())},[o]),t.useEffect(()=>{const e=r.current;if(!e)return;const E=f=>{var v,m,L;const s=f.detail;(v=n.current)==null||v.call(n,s.assets,s.folders),((m=s.folders)==null?void 0:m.length)>0&&((L=c.current)==null||L.call(c,{assets:s.assets,folders:s.folders}))},p=()=>{var f;(f=u.current)==null||f.call(u)};return e.addEventListener("ap-select",E),e.addEventListener("ap-cancel",p),()=>{e.removeEventListener("ap-select",E),e.removeEventListener("ap-cancel",p)}},[]),t.createElement("sfx-asset-picker",{ref:r,className:y,style:P})});exports.AssetPicker=g;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("react");typeof customElements<"u"&&Promise.resolve().then(()=>require("./define.cjs"));const R=e.forwardRef(function({config:k,open:o,onSelect:a,onSelectWithFolders:p,onCancel:m,className:c,style:t},u){const n=e.useRef(null),i=e.useRef(a),f=e.useRef(p),P=e.useRef(m);return e.useLayoutEffect(()=>{i.current=a,f.current=p,P.current=m}),e.useImperativeHandle(u,()=>({open(){var r;(r=n.current)==null||r.open()},close(){var r;(r=n.current)==null||r.close()}})),e.useLayoutEffect(()=>{const r=n.current;r&&(r.config=k)},[k]),e.useEffect(()=>{const r=n.current;r&&(o===!0?r.open():o===!1&&r.close())},[o]),e.useEffect(()=>{const r=n.current;if(!r)return;const E=s=>{var C,y,A;const v=s.detail;(C=i.current)==null||C.call(i,v.assets,v.folders),((y=v.folders)==null?void 0:y.length)>0&&((A=f.current)==null||A.call(f,{assets:v.assets,folders:v.folders}))},d=()=>{var s;(s=P.current)==null||s.call(P)};return r.addEventListener("ap-select",E),r.addEventListener("ap-cancel",d),()=>{r.removeEventListener("ap-select",E),r.removeEventListener("ap-cancel",d)}},[]),e.createElement("sfx-asset-picker",{ref:n,className:c,style:t})}),b=e.createContext(null);function g({config:l,children:k}){const[o,a]=e.useState(!1),[p,m]=e.useState(l),c=e.useRef(null),t=e.useRef(null),u=e.useRef(null),n=e.useRef(null),i=e.useCallback(d=>{t.current&&(t.current("cancelled"),c.current=null,t.current=null);const{onSelect:s,onCancel:v,...C}=d??{};return m({...l,...C}),a(!0),u.current=s??null,n.current=v??null,s?Promise.resolve([]):new Promise((y,A)=>{c.current=y,t.current=A})},[l]),f=e.useCallback(()=>{t.current&&t.current("cancelled"),c.current=null,t.current=null,u.current=null,n.current=null,a(!1)},[]),P=e.useCallback((d,s)=>{try{u.current?u.current(d,s):c.current&&c.current(d)}finally{c.current=null,t.current=null,u.current=null,n.current=null,a(!1)}},[]),r=e.useCallback(()=>{try{n.current?n.current():t.current&&t.current("cancelled")}finally{c.current=null,t.current=null,u.current=null,n.current=null,a(!1)}},[]),E=e.useMemo(()=>({open:i,close:f,isOpen:o}),[i,f,o]);return e.createElement(b.Provider,{value:E},k,e.createElement(R,{config:p,open:o,onSelect:P,onCancel:r}))}function h(){const l=e.useContext(b);if(!l)throw new Error("useAssetPicker() must be used inside <AssetPickerProvider>. Wrap your app (or layout) with <AssetPickerProvider config={...}>.");return l}exports.AssetPicker=R;exports.AssetPickerProvider=g;exports.useAssetPicker=h;

package/dist/react.d.ts

@@ -1,4 +1,4 @@
-import { CSSProperties } from 'react';
+import { CSSProperties, ReactNode } from 'react';
 import { AssetPickerConfig } from './types/config.types';
 import { Asset } from './types/asset.types';
 import { Folder } from './types/folder.types';
@@ -19,4 +19,85 @@ export interface AssetPickerProps {
     style?: CSSProperties;
 }
 export declare const AssetPicker: import('react').ForwardRefExoticComponent<AssetPickerProps & import('react').RefAttributes<AssetPickerRef>>;
+/**
+ * Options passed to `picker.open()`. Extends the base config with optional
+ * callback overrides. Any config property here merges with (and overrides)
+ * the base config from the provider.
+ */
+export interface OpenOptions extends Partial<AssetPickerConfig> {
+    /** Called when the user confirms selection. */
+    onSelect?: (assets: Asset[], folders?: Folder[]) => void;
+    /** Called when the user cancels / closes the picker. */
+    onCancel?: () => void;
+}
+export interface UseAssetPickerReturn {
+    /**
+     * Open the asset picker.
+     *
+     * **Promise mode** (no `onSelect` in options):
+     * ```ts
+     * const assets = await picker.open({ multiSelect: true });
+     * ```
+     *
+     * **Callback mode** (pass `onSelect`):
+     * ```ts
+     * picker.open({ onSelect: (assets) => console.log(assets) });
+     * ```
+     *
+     * In promise mode the promise rejects with `'cancelled'` if the user
+     * closes without selecting.
+     */
+    open(overrides?: OpenOptions): Promise<Asset[]>;
+    /** Close the picker programmatically. */
+    close(): void;
+    /** Whether the picker is currently open. */
+    isOpen: boolean;
+}
+export interface AssetPickerProviderProps {
+    /** Base configuration applied to every `open()` call. */
+    config: AssetPickerConfig;
+    children: ReactNode;
+}
+interface PickerContextValue {
+    open(overrides?: OpenOptions): Promise<Asset[]>;
+    close(): void;
+    isOpen: boolean;
+}
+/**
+ * Mount a single `<AssetPicker>` instance at the root of your React tree.
+ * All `useAssetPicker()` calls share this instance.
+ *
+ * @example
+ * ```tsx
+ * <AssetPickerProvider config={{ auth: { mode: 'sassKey', sassKey, projectToken } }}>
+ *   <App />
+ * </AssetPickerProvider>
+ * ```
+ */
+export declare function AssetPickerProvider({ config, children }: AssetPickerProviderProps): import('react').FunctionComponentElement<import('react').ProviderProps<PickerContextValue | null>>;
+/**
+ * Access the singleton asset picker from anywhere in the React tree.
+ *
+ * Must be used inside an `<AssetPickerProvider>`.
+ *
+ * @example
+ * ```tsx
+ * function UploadButton() {
+ *   const picker = useAssetPicker();
+ *
+ *   const handleClick = async () => {
+ *     try {
+ *       const assets = await picker.open({ multiSelect: true });
+ *       console.log('Selected:', assets);
+ *     } catch {
+ *       console.log('User cancelled');
+ *     }
+ *   };
+ *
+ *   return <button onClick={handleClick}>Choose files</button>;
+ * }
+ * ```
+ */
+export declare function useAssetPicker(): UseAssetPickerReturn;
+export {};
 //# sourceMappingURL=react.d.ts.map

package/dist/react.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../src/react.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,aAAa,EACnB,MAAM,OAAO,CAAC;AAEf,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAQnD,MAAM,WAAW,cAAc;IAC7B,IAAI,IAAI,IAAI,CAAC;IACb,KAAK,IAAI,IAAI,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,iBAAiB,CAAC;IAC1B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IACzD,mBAAmB,CAAC,EAAE,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,KAAK,EAAE,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,KAAK,IAAI,CAAC;IAC/E,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB;AAED,eAAO,MAAM,WAAW,6GAyEvB,CAAC"}
+{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../src/react.ts"],"names":[],"mappings":"AAAA,OAAO,EAWL,KAAK,aAAa,EAClB,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAEf,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAQnD,MAAM,WAAW,cAAc;IAC7B,IAAI,IAAI,IAAI,CAAC;IACb,KAAK,IAAI,IAAI,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,iBAAiB,CAAC;IAC1B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IACzD,mBAAmB,CAAC,EAAE,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,KAAK,EAAE,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,KAAK,IAAI,CAAC;IAC/E,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB;AAED,eAAO,MAAM,WAAW,6GAyEvB,CAAC;AAMF;;;;GAIG;AACH,MAAM,WAAW,WAAY,SAAQ,OAAO,CAAC,iBAAiB,CAAC;IAC7D,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IACzD,wDAAwD;IACxD,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;CACvB;AAED,MAAM,WAAW,oBAAoB;IACnC;;;;;;;;;;;;;;;OAeG;IACH,IAAI,CAAC,SAAS,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IAChD,yCAAyC;IACzC,KAAK,IAAI,IAAI,CAAC;IACd,4CAA4C;IAC5C,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,wBAAwB;IACvC,yDAAyD;IACzD,MAAM,EAAE,iBAAiB,CAAC;IAC1B,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,UAAU,kBAAkB;IAC1B,IAAI,CAAC,SAAS,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IAChD,KAAK,IAAI,IAAI,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;CACjB;AAID;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,wBAAwB,sGA2FjF;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,cAAc,IAAI,oBAAoB,CASrD"}

package/dist/react.js

@@ -1,46 +1,90 @@
-import { forwardRef as g, useRef as f, useLayoutEffect as k, useImperativeHandle as h, useEffect as x, createElement as w } from "react";
+import { forwardRef as R, useRef as u, useLayoutEffect as w, useImperativeHandle as O, useEffect as L, createElement as h, createContext as I, useState as b, useCallback as x, useMemo as S, useContext as j } from "react";
 typeof customElements < "u" && import("./define.js");
-const b = g(
-  function({ config: a, open: o, onSelect: l, onSelectWithFolders: i, onCancel: d, className: y, style: A }, P) {
-    const t = f(null), s = f(l), n = f(i), c = f(d);
-    return k(() => {
-      s.current = l, n.current = i, c.current = d;
-    }), h(P, () => ({
+const H = R(
+  function({ config: P, open: o, onSelect: i, onSelectWithFolders: m, onCancel: k, className: t, style: r }, l) {
+    const n = u(null), a = u(i), f = u(m), v = u(k);
+    return w(() => {
+      a.current = i, f.current = m, v.current = k;
+    }), O(l, () => ({
       open() {
         var e;
-        (e = t.current) == null || e.open();
+        (e = n.current) == null || e.open();
       },
       close() {
         var e;
-        (e = t.current) == null || e.close();
+        (e = n.current) == null || e.close();
       }
-    })), k(() => {
-      const e = t.current;
-      e && (e.config = a);
-    }, [a]), x(() => {
-      const e = t.current;
+    })), w(() => {
+      const e = n.current;
+      e && (e.config = P);
+    }, [P]), L(() => {
+      const e = n.current;
       e && (o === !0 ? e.open() : o === !1 && e.close());
-    }, [o]), x(() => {
-      const e = t.current;
+    }, [o]), L(() => {
+      const e = n.current;
       if (!e) return;
-      const p = (u) => {
-        var E, v, L;
-        const r = u.detail;
-        (E = s.current) == null || E.call(s, r.assets, r.folders), ((v = r.folders) == null ? void 0 : v.length) > 0 && ((L = n.current) == null || L.call(n, { assets: r.assets, folders: r.folders }));
-      }, m = () => {
-        var u;
-        (u = c.current) == null || u.call(c);
+      const C = (c) => {
+        var E, y, A;
+        const p = c.detail;
+        (E = a.current) == null || E.call(a, p.assets, p.folders), ((y = p.folders) == null ? void 0 : y.length) > 0 && ((A = f.current) == null || A.call(f, { assets: p.assets, folders: p.folders }));
+      }, d = () => {
+        var c;
+        (c = v.current) == null || c.call(v);
       };
-      return e.addEventListener("ap-select", p), e.addEventListener("ap-cancel", m), () => {
-        e.removeEventListener("ap-select", p), e.removeEventListener("ap-cancel", m);
+      return e.addEventListener("ap-select", C), e.addEventListener("ap-cancel", d), () => {
+        e.removeEventListener("ap-select", C), e.removeEventListener("ap-cancel", d);
       };
-    }, []), w("sfx-asset-picker", {
-      ref: t,
-      className: y,
-      style: A
+    }, []), h("sfx-asset-picker", {
+      ref: n,
+      className: t,
+      style: r
     });
   }
-);
+), g = I(null);
+function q({ config: s, children: P }) {
+  const [o, i] = b(!1), [m, k] = b(s), t = u(null), r = u(null), l = u(null), n = u(null), a = x((d) => {
+    r.current && (r.current("cancelled"), t.current = null, r.current = null);
+    const { onSelect: c, onCancel: p, ...E } = d ?? {};
+    return k({ ...s, ...E }), i(!0), l.current = c ?? null, n.current = p ?? null, c ? Promise.resolve([]) : new Promise((y, A) => {
+      t.current = y, r.current = A;
+    });
+  }, [s]), f = x(() => {
+    r.current && r.current("cancelled"), t.current = null, r.current = null, l.current = null, n.current = null, i(!1);
+  }, []), v = x((d, c) => {
+    try {
+      l.current ? l.current(d, c) : t.current && t.current(d);
+    } finally {
+      t.current = null, r.current = null, l.current = null, n.current = null, i(!1);
+    }
+  }, []), e = x(() => {
+    try {
+      n.current ? n.current() : r.current && r.current("cancelled");
+    } finally {
+      t.current = null, r.current = null, l.current = null, n.current = null, i(!1);
+    }
+  }, []), C = S(() => ({ open: a, close: f, isOpen: o }), [a, f, o]);
+  return h(
+    g.Provider,
+    { value: C },
+    P,
+    h(H, {
+      config: m,
+      open: o,
+      onSelect: v,
+      onCancel: e
+    })
+  );
+}
+function z() {
+  const s = j(g);
+  if (!s)
+    throw new Error(
+      "useAssetPicker() must be used inside <AssetPickerProvider>. Wrap your app (or layout) with <AssetPickerProvider config={...}>."
+    );
+  return s;
+}
 export {
-  b as AssetPicker
+  H as AssetPicker,
+  q as AssetPickerProvider,
+  z as useAssetPicker
 };

package/dist/types/asset.types.d.ts

@@ -23,7 +23,12 @@ export interface AssetInfo {
     }>;
 }
 export interface AssetMeta {
-    title?: string;
+    /**
+     * Asset title. May be a plain string or a localized record keyed by
+     * language code (e.g. `{ en: "Sunset", fr: "Coucher de soleil" }`).
+     * Use `getAltText()` from the package to handle both cases.
+     */
+    title?: string | Record<string, string>;
     description?: string;
     alt?: string;
     [key: string]: unknown;

package/dist/types/asset.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"asset.types.d.ts","sourceRoot":"","sources":["../../src/types/asset.types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"asset.types.d.ts","sourceRoot":"","sources":["../../src/types/asset.types.ts"],"names":[],"mappings":"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"}

package/dist/utils/asset-helpers.d.ts

@@ -0,0 +1,80 @@
+import { Asset } from '../types/asset.types';
+/** Check if the asset is an image (type starts with "image"). */
+export declare function isImage(asset: Asset): boolean;
+/** Check if the asset is a video (type starts with "video"). */
+export declare function isVideo(asset: Asset): boolean;
+/** Check if the asset is audio (type starts with "audio"). */
+export declare function isAudio(asset: Asset): boolean;
+/**
+ * Get the CDN URL for an asset, falling back to the public URL.
+ *
+ * @example
+ * ```ts
+ * const url = getCdnUrl(asset);
+ * // "https://token.filerobot.com/path/to/image.jpg"
+ * ```
+ */
+export declare function getCdnUrl(asset: Asset): string;
+/**
+ * Derive a human-readable alt text from asset metadata.
+ *
+ * Priority: `meta.alt` > `meta.title` (string or localized record) > filename
+ * (without extension).
+ *
+ * @param asset - The asset to extract alt text from.
+ * @param lang  - Preferred language code for localized titles (e.g. "en").
+ *                Falls back to the first available language.
+ *
+ * @example
+ * ```ts
+ * const alt = getAltText(asset);        // uses first available language
+ * const alt = getAltText(asset, 'fr');  // prefers French title
+ * ```
+ */
+export declare function getAltText(asset: Asset, lang?: string): string;
+/**
+ * Get the asset width (works for both images and videos).
+ *
+ * @returns Width in pixels, or `0` if unknown.
+ */
+export declare function getAssetWidth(asset: Asset): number;
+/**
+ * Get the asset height (works for both images and videos).
+ *
+ * @returns Height in pixels, or `0` if unknown.
+ */
+export declare function getAssetHeight(asset: Asset): number;
+/**
+ * Get the asset dimensions as `{ width, height }`.
+ *
+ * @example
+ * ```ts
+ * const { width, height } = getAssetDimensions(asset);
+ * ```
+ */
+export declare function getAssetDimensions(asset: Asset): {
+    width: number;
+    height: number;
+};
+/**
+ * Check whether the video asset has a transcoded (HLS) version available.
+ */
+export declare function isTranscoded(asset: Asset): boolean;
+/**
+ * Get the transcoded (HLS manifest) URL if available.
+ *
+ * @returns The HLS URL string, or `null` if not transcoded.
+ */
+export declare function getTranscodedUrl(asset: Asset): string | null;
+/**
+ * Get the best playback URL for a video asset.
+ *
+ * Priority: transcoded HLS URL > CDN URL > public URL.
+ *
+ * @example
+ * ```ts
+ * const videoSrc = getBestVideoUrl(asset);
+ * ```
+ */
+export declare function getBestVideoUrl(asset: Asset): string;
+//# sourceMappingURL=asset-helpers.d.ts.map

package/dist/utils/asset-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-helpers.d.ts","sourceRoot":"","sources":["../../src/utils/asset-helpers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAOlD,iEAAiE;AACjE,wBAAgB,OAAO,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAE7C;AAED,gEAAgE;AAChE,wBAAgB,OAAO,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAE7C;AAED,8DAA8D;AAC9D,wBAAgB,OAAO,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAE7C;AAMD;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAE9C;AAMD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAuB9D;AAMD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAElD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAEnD;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,KAAK,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAKlF;AAMD;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAElD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,IAAI,CAE5D;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAEpD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@scaleflex/asset-picker",
-  "version": "0.2.11",
+  "version": "0.2.13",
   "description": "Framework-agnostic Asset Picker for Scaleflex VXP DAM",
   "type": "module",
   "main": "dist/index.cjs",
@@ -55,7 +55,7 @@
     "vite-plugin-dts": "^4.0.0"
   },
   "peerDependencies": {
-    "@scaleflex/uploader": "^0.2.2",
+    "@scaleflex/uploader": "^0.2.3",
     "react": ">=18",
     "react-dom": ">=18"
   },