@anvilkit/plugin-asset-manager 0.1.5 → 0.1.7

package/dist/plugin.js

@@ -3,6 +3,7 @@ import { createElement } from "react";
 import config from "../meta/config.json" with {
     type: "json"
 };
+import { inMemoryUploader } from "./adapters/in-memory.js";
 import { createAssetReference } from "./utils/asset-reference.js";
 import { AssetValidationError } from "./utils/errors.js";
 import { uploadAssetAction } from "./utils/header-action.js";
@@ -19,7 +20,7 @@ const META = {
 };
 const stateByToken = new WeakMap();
 const tokenByContext = new WeakMap();
-function createAssetManagerPlugin(options) {
+function createAssetManagerPlugin(options = {}) {
     const token = {};
     const registry = createAssetRegistry();
     const normalizedOptions = normalizeOptions(options);
@@ -46,15 +47,34 @@ function createAssetManagerPlugin(options) {
                         });
                         tokenByContext.set(initCtx, token);
                         initCtx.registerAssetResolver(assetResolver);
+                        const upload = (file, opts)=>uploadAsset(initCtx, file, opts?.signal);
                         const studioAssetSource = createStudioAssetSource({
                             registry,
-                            upload: (file, opts)=>uploadAsset(initCtx, file, opts?.signal),
+                            upload,
                             ...normalizedOptions.getThumbnail ? {
                                 getThumbnail: normalizedOptions.getThumbnail
                             } : {}
                         });
-                        const unregisterAssetSource = initCtx.registerAssetSource?.(studioAssetSource);
-                        if (void 0 !== unregisterAssetSource) cleanups.push(unregisterAssetSource);
+                        let unregisterAssetSource = initCtx.registerAssetSource?.(studioAssetSource);
+                        cleanups.push(()=>unregisterAssetSource?.());
+                        if (needsRichSource(normalizedOptions)) {
+                            let disposed = false;
+                            cleanups.push(()=>{
+                                disposed = true;
+                            });
+                            loadRichSource(initCtx, registry, upload, normalizedOptions).then((composite)=>{
+                                if (disposed) return;
+                                unregisterAssetSource?.();
+                                unregisterAssetSource = void 0;
+                                const unregisterComposite = initCtx.registerAssetSource?.(composite);
+                                if (disposed) return void unregisterComposite?.();
+                                cleanups.push(()=>unregisterComposite?.());
+                            }).catch((error)=>{
+                                initCtx.log("error", "asset-manager: failed to load the data source.", {
+                                    error
+                                });
+                            });
+                        }
                     },
                     onDestroy (destroyCtx) {
                         const state = stateByToken.get(token);
@@ -118,9 +138,52 @@ function getRuntimeState(ctx) {
     if (!state) throw new Error("createAssetManagerPlugin: uploadAsset called before the plugin runtime was initialized.");
     return state;
 }
+function needsRichSource(options) {
+    return false !== options.folders || void 0 !== options.dataSource || void 0 !== options.providers && options.providers.length > 0 || void 0 !== options.unsplash;
+}
+async function loadRichSource(ctx, registry, upload, options) {
+    const [{ resolveDataSource }, { createCompositeAssetSource }] = await Promise.all([
+        import("./utils/data-source.js"),
+        import("./sources/composite-source.js")
+    ]);
+    const maxDepth = "object" == typeof options.folders ? options.folders.maxDepth : void 0;
+    const resolved = resolveDataSource({
+        registry,
+        upload,
+        ...options.dataSource ? {
+            hostDataSource: options.dataSource
+        } : {},
+        ...void 0 !== maxDepth ? {
+            maxDepth
+        } : {},
+        warn: (message)=>ctx.log("warn", message)
+    });
+    const providers = [
+        ...options.providers ?? []
+    ];
+    if (void 0 !== options.unsplash) {
+        const { createUnsplashProvider, unsplashEnabled } = await import("./sources/unsplash/index.js");
+        if (unsplashEnabled(options.unsplash)) {
+            if (void 0 !== options.unsplash.accessKey && void 0 === options.unsplash.proxyEndpoint) ctx.log("warn", "asset-manager: the Unsplash accessKey is public in the browser — use a server proxy (proxyEndpoint) in production.");
+            providers.push(createUnsplashProvider(options.unsplash));
+        }
+    }
+    return createCompositeAssetSource({
+        source: resolved,
+        registry,
+        upload,
+        ...providers.length > 0 ? {
+            providers
+        } : {},
+        ...options.getThumbnail ? {
+            getThumbnail: options.getThumbnail
+        } : {}
+    });
+}
 function normalizeOptions(options) {
     return {
         ...options,
+        uploader: options.uploader ?? inMemoryUploader(),
         ...options.acceptedMimeTypes ? {
             acceptedMimeTypes: Object.freeze([
                 ...options.acceptedMimeTypes

package/dist/sources/composite-source.cjs

@@ -0,0 +1,137 @@
+"use strict";
+var __webpack_require__ = {};
+(()=>{
+    __webpack_require__.d = (exports1, getters, values)=>{
+        var define = (defs, kind)=>{
+            for(var key in defs)if (__webpack_require__.o(defs, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
+                enumerable: true,
+                [kind]: defs[key]
+            });
+        };
+        define(getters, "get");
+        define(values, "value");
+    };
+})();
+(()=>{
+    __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
+})();
+(()=>{
+    __webpack_require__.r = (exports1)=>{
+        if ("u" > typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+            value: 'Module'
+        });
+        Object.defineProperty(exports1, '__esModule', {
+            value: true
+        });
+    };
+})();
+var __webpack_exports__ = {};
+__webpack_require__.r(__webpack_exports__);
+__webpack_require__.d(__webpack_exports__, {
+    createCompositeAssetSource: ()=>createCompositeAssetSource
+});
+const asset_reference_cjs_namespaceObject = require("../utils/asset-reference.cjs");
+const studio_asset_source_cjs_namespaceObject = require("../utils/studio-asset-source.cjs");
+const external_federated_search_cjs_namespaceObject = require("./federated-search.cjs");
+function createCompositeAssetSource(options) {
+    const { source, registry, upload, getThumbnail } = options;
+    const base = (0, studio_asset_source_cjs_namespaceObject.createStudioAssetSource)({
+        registry,
+        upload,
+        ...getThumbnail ? {
+            getThumbnail
+        } : {}
+    });
+    const project = (entry)=>{
+        const attribution = entry.meta?.attribution;
+        const isExternal = entry.id.startsWith("unsplash:");
+        return {
+            ...(0, studio_asset_source_cjs_namespaceObject.toStudioAsset)(entry, getThumbnail),
+            ...isExternal ? {
+                url: entry.url
+            } : {},
+            folderId: source.folders.folderOf(entry.id),
+            source: isExternal ? "unsplash" : "local",
+            ...attribution ? {
+                attribution: {
+                    photographerName: attribution.photographerName,
+                    photographerUrl: attribution.photographerUrl,
+                    sourceUrl: attribution.unsplashUrl
+                }
+            } : {}
+        };
+    };
+    const providers = [
+        (0, external_federated_search_cjs_namespaceObject.createLocalProvider)(source, registry),
+        ...options.providers ?? []
+    ];
+    const runList = (filter, signal)=>1 === providers.length ? source.list(filter, signal) : (0, external_federated_search_cjs_namespaceObject.federatedSearch)({
+            providers,
+            filter,
+            signal
+        });
+    return {
+        async list () {
+            const page = await runList({});
+            return Object.freeze(page.items.map(project));
+        },
+        async listPaginated (query) {
+            const page = await runList({
+                ...query
+            });
+            return {
+                items: Object.freeze(page.items.map(project)),
+                total: page.total,
+                nextCursor: page.nextCursor,
+                ...page.folders ? {
+                    folders: page.folders
+                } : {},
+                ...page.folderPath ? {
+                    folderPath: page.folderPath
+                } : {},
+                ...page.sourceCursors ? {
+                    sourceCursors: page.sourceCursors
+                } : {}
+            };
+        },
+        upload: base.upload,
+        setTags: base.setTags,
+        subscribeUploads: base.subscribeUploads,
+        getUrl: (assetId)=>(0, asset_reference_cjs_namespaceObject.createAssetReference)(assetId),
+        async delete (assetId) {
+            await source.remove(assetId);
+        },
+        async rename (assetId, nextName) {
+            await source.rename(assetId, nextName);
+        },
+        async replace (assetId, file) {
+            return project(await source.replace(assetId, file));
+        },
+        subscribe: (listener)=>source.subscribe(listener),
+        createFolder: (parentId, name)=>source.createFolder(parentId, name),
+        renameFolder: (id, name)=>source.renameFolder(id, name),
+        removeFolder: (id, opts)=>source.removeFolder(id, opts),
+        moveFolder: (id, parentId)=>source.moveFolder(id, parentId),
+        moveAsset: (assetId, folderId)=>source.move(assetId, folderId),
+        async pickResult (asset) {
+            const provider = providers.find((p)=>p.id === asset.source);
+            if (void 0 === provider || "local" === provider.id) return asset;
+            const result = await provider.pickResult(asset);
+            registry.register(result);
+            return project(result);
+        },
+        subscribeStatus: (listener)=>source.subscribeStatus(listener),
+        async listThemes () {
+            const themes = [];
+            for (const provider of providers)if ("local" !== provider.id) themes.push(...await provider.listThemes());
+            return themes;
+        }
+    };
+}
+exports.createCompositeAssetSource = __webpack_exports__.createCompositeAssetSource;
+for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "createCompositeAssetSource"
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

package/dist/sources/composite-source.d.cts

@@ -0,0 +1,39 @@
+/**
+ * @file `CompositeAssetSource` (PRD 0002 §6.1, §8.1). Implements core's
+ * `StudioAssetSource` by routing reads + catalog mutations through the resolved
+ * `AssetDataSource` (so host backends and folder scoping work), while reusing
+ * the proven upload pipeline + projection from `createStudioAssetSource`.
+ *
+ * Lazy-loaded by the factory only when a host opts into a richer surface
+ * (`dataSource`/`providers`/`unsplash`), so flat callers never pull this — or
+ * the folder/data-source code it imports — into the headless entry chunk.
+ */
+import type { StudioAssetSource } from "@anvilkit/core/types";
+import type { AssetFolder, FolderId } from "../types/folders.js";
+import type { AssetRegistry, UploadResult } from "../types/types.js";
+import type { ResolvedAssetDataSource, UploadFn } from "../utils/data-source.js";
+import type { AssetSourceProvider } from "./provider.js";
+export interface CreateCompositeAssetSourceOptions {
+    readonly source: ResolvedAssetDataSource;
+    readonly registry: AssetRegistry;
+    readonly upload: UploadFn;
+    readonly getThumbnail?: (entry: UploadResult) => string | undefined;
+    /** External read-only sources (e.g. Unsplash) federated alongside the local library. */
+    readonly providers?: readonly AssetSourceProvider[];
+}
+/**
+ * The core `StudioAssetSource` plus the folder methods the plugin's `./ui` and
+ * (Phase 2) core `ImageModule` consume. The folder methods are additive — core
+ * ignores what it doesn't know until its sidebar types adopt them.
+ */
+export interface CompositeAssetSource extends StudioAssetSource {
+    createFolder(parentId: FolderId | null, name: string): Promise<AssetFolder>;
+    renameFolder(id: FolderId, name: string): Promise<AssetFolder>;
+    removeFolder(id: FolderId, opts?: {
+        readonly cascade?: boolean;
+    }): Promise<void>;
+    moveFolder(id: FolderId, parentId: FolderId | null): Promise<AssetFolder>;
+    moveAsset(assetId: string, folderId: FolderId | null): Promise<void>;
+}
+export declare function createCompositeAssetSource(options: CreateCompositeAssetSourceOptions): CompositeAssetSource;
+//# sourceMappingURL=composite-source.d.cts.map

package/dist/sources/composite-source.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composite-source.d.cts","sourceRoot":"","sources":["../../src/sources/composite-source.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAIX,iBAAiB,EAEjB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAErE,OAAO,KAAK,EACX,uBAAuB,EACvB,QAAQ,EACR,MAAM,yBAAyB,CAAC;AAMjC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAEzD,MAAM,WAAW,iCAAiC;IACjD,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAC;IACzC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAC1B,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,MAAM,GAAG,SAAS,CAAC;IACpE,wFAAwF;IACxF,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;CACpD;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAqB,SAAQ,iBAAiB;IAC9D,YAAY,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAC5E,YAAY,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAC/D,YAAY,CACX,EAAE,EAAE,QAAQ,EACZ,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GACnC,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,UAAU,CAAC,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAC1E,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrE;AAED,wBAAgB,0BAA0B,CACzC,OAAO,EAAE,iCAAiC,GACxC,oBAAoB,CA8HtB"}

package/dist/sources/composite-source.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @file `CompositeAssetSource` (PRD 0002 §6.1, §8.1). Implements core's
+ * `StudioAssetSource` by routing reads + catalog mutations through the resolved
+ * `AssetDataSource` (so host backends and folder scoping work), while reusing
+ * the proven upload pipeline + projection from `createStudioAssetSource`.
+ *
+ * Lazy-loaded by the factory only when a host opts into a richer surface
+ * (`dataSource`/`providers`/`unsplash`), so flat callers never pull this — or
+ * the folder/data-source code it imports — into the headless entry chunk.
+ */
+import type { StudioAssetSource } from "@anvilkit/core/types";
+import type { AssetFolder, FolderId } from "../types/folders.js";
+import type { AssetRegistry, UploadResult } from "../types/types.js";
+import type { ResolvedAssetDataSource, UploadFn } from "../utils/data-source.js";
+import type { AssetSourceProvider } from "./provider.js";
+export interface CreateCompositeAssetSourceOptions {
+    readonly source: ResolvedAssetDataSource;
+    readonly registry: AssetRegistry;
+    readonly upload: UploadFn;
+    readonly getThumbnail?: (entry: UploadResult) => string | undefined;
+    /** External read-only sources (e.g. Unsplash) federated alongside the local library. */
+    readonly providers?: readonly AssetSourceProvider[];
+}
+/**
+ * The core `StudioAssetSource` plus the folder methods the plugin's `./ui` and
+ * (Phase 2) core `ImageModule` consume. The folder methods are additive — core
+ * ignores what it doesn't know until its sidebar types adopt them.
+ */
+export interface CompositeAssetSource extends StudioAssetSource {
+    createFolder(parentId: FolderId | null, name: string): Promise<AssetFolder>;
+    renameFolder(id: FolderId, name: string): Promise<AssetFolder>;
+    removeFolder(id: FolderId, opts?: {
+        readonly cascade?: boolean;
+    }): Promise<void>;
+    moveFolder(id: FolderId, parentId: FolderId | null): Promise<AssetFolder>;
+    moveAsset(assetId: string, folderId: FolderId | null): Promise<void>;
+}
+export declare function createCompositeAssetSource(options: CreateCompositeAssetSourceOptions): CompositeAssetSource;
+//# sourceMappingURL=composite-source.d.ts.map

package/dist/sources/composite-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composite-source.d.ts","sourceRoot":"","sources":["../../src/sources/composite-source.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAIX,iBAAiB,EAEjB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAErE,OAAO,KAAK,EACX,uBAAuB,EACvB,QAAQ,EACR,MAAM,yBAAyB,CAAC;AAMjC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAEzD,MAAM,WAAW,iCAAiC;IACjD,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAC;IACzC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAC1B,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,MAAM,GAAG,SAAS,CAAC;IACpE,wFAAwF;IACxF,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;CACpD;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAqB,SAAQ,iBAAiB;IAC9D,YAAY,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAC5E,YAAY,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAC/D,YAAY,CACX,EAAE,EAAE,QAAQ,EACZ,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GACnC,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,UAAU,CAAC,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAC1E,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrE;AAED,wBAAgB,0BAA0B,CACzC,OAAO,EAAE,iCAAiC,GACxC,oBAAoB,CA8HtB"}

package/dist/sources/composite-source.js

@@ -0,0 +1,99 @@
+import { createAssetReference } from "../utils/asset-reference.js";
+import { createStudioAssetSource, toStudioAsset } from "../utils/studio-asset-source.js";
+import { createLocalProvider, federatedSearch } from "./federated-search.js";
+function createCompositeAssetSource(options) {
+    const { source, registry, upload, getThumbnail } = options;
+    const base = createStudioAssetSource({
+        registry,
+        upload,
+        ...getThumbnail ? {
+            getThumbnail
+        } : {}
+    });
+    const project = (entry)=>{
+        const attribution = entry.meta?.attribution;
+        const isExternal = entry.id.startsWith("unsplash:");
+        return {
+            ...toStudioAsset(entry, getThumbnail),
+            ...isExternal ? {
+                url: entry.url
+            } : {},
+            folderId: source.folders.folderOf(entry.id),
+            source: isExternal ? "unsplash" : "local",
+            ...attribution ? {
+                attribution: {
+                    photographerName: attribution.photographerName,
+                    photographerUrl: attribution.photographerUrl,
+                    sourceUrl: attribution.unsplashUrl
+                }
+            } : {}
+        };
+    };
+    const providers = [
+        createLocalProvider(source, registry),
+        ...options.providers ?? []
+    ];
+    const runList = (filter, signal)=>1 === providers.length ? source.list(filter, signal) : federatedSearch({
+            providers,
+            filter,
+            signal
+        });
+    return {
+        async list () {
+            const page = await runList({});
+            return Object.freeze(page.items.map(project));
+        },
+        async listPaginated (query) {
+            const page = await runList({
+                ...query
+            });
+            return {
+                items: Object.freeze(page.items.map(project)),
+                total: page.total,
+                nextCursor: page.nextCursor,
+                ...page.folders ? {
+                    folders: page.folders
+                } : {},
+                ...page.folderPath ? {
+                    folderPath: page.folderPath
+                } : {},
+                ...page.sourceCursors ? {
+                    sourceCursors: page.sourceCursors
+                } : {}
+            };
+        },
+        upload: base.upload,
+        setTags: base.setTags,
+        subscribeUploads: base.subscribeUploads,
+        getUrl: (assetId)=>createAssetReference(assetId),
+        async delete (assetId) {
+            await source.remove(assetId);
+        },
+        async rename (assetId, nextName) {
+            await source.rename(assetId, nextName);
+        },
+        async replace (assetId, file) {
+            return project(await source.replace(assetId, file));
+        },
+        subscribe: (listener)=>source.subscribe(listener),
+        createFolder: (parentId, name)=>source.createFolder(parentId, name),
+        renameFolder: (id, name)=>source.renameFolder(id, name),
+        removeFolder: (id, opts)=>source.removeFolder(id, opts),
+        moveFolder: (id, parentId)=>source.moveFolder(id, parentId),
+        moveAsset: (assetId, folderId)=>source.move(assetId, folderId),
+        async pickResult (asset) {
+            const provider = providers.find((p)=>p.id === asset.source);
+            if (void 0 === provider || "local" === provider.id) return asset;
+            const result = await provider.pickResult(asset);
+            registry.register(result);
+            return project(result);
+        },
+        subscribeStatus: (listener)=>source.subscribeStatus(listener),
+        async listThemes () {
+            const themes = [];
+            for (const provider of providers)if ("local" !== provider.id) themes.push(...await provider.listThemes());
+            return themes;
+        }
+    };
+}
+export { createCompositeAssetSource };

package/dist/sources/federated-search.cjs

@@ -0,0 +1,163 @@
+"use strict";
+var __webpack_require__ = {};
+(()=>{
+    __webpack_require__.d = (exports1, getters, values)=>{
+        var define = (defs, kind)=>{
+            for(var key in defs)if (__webpack_require__.o(defs, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
+                enumerable: true,
+                [kind]: defs[key]
+            });
+        };
+        define(getters, "get");
+        define(values, "value");
+    };
+})();
+(()=>{
+    __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
+})();
+(()=>{
+    __webpack_require__.r = (exports1)=>{
+        if ("u" > typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+            value: 'Module'
+        });
+        Object.defineProperty(exports1, '__esModule', {
+            value: true
+        });
+    };
+})();
+var __webpack_exports__ = {};
+__webpack_require__.r(__webpack_exports__);
+__webpack_require__.d(__webpack_exports__, {
+    createLocalProvider: ()=>createLocalProvider,
+    decodeCompositeCursor: ()=>decodeCompositeCursor,
+    encodeCompositeCursor: ()=>encodeCompositeCursor,
+    federatedSearch: ()=>federatedSearch,
+    providerCanSatisfy: ()=>providerCanSatisfy
+});
+const infer_kind_cjs_namespaceObject = require("../utils/infer-kind.cjs");
+function toBase64Url(json) {
+    return btoa(json).replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
+}
+function fromBase64Url(token) {
+    const padded = token.length % 4 === 0 ? token : token + "=".repeat(4 - token.length % 4);
+    return atob(padded.replace(/-/g, "+").replace(/_/g, "/"));
+}
+function encodeCompositeCursor(cursor) {
+    return toBase64Url(JSON.stringify(cursor));
+}
+function decodeCompositeCursor(token) {
+    if (void 0 === token || "" === token) return {};
+    try {
+        const parsed = JSON.parse(fromBase64Url(token));
+        return "object" == typeof parsed && null !== parsed ? parsed : {};
+    } catch  {
+        return {};
+    }
+}
+function providerCanSatisfy(provider, filter) {
+    if (void 0 !== filter.folderId && true !== provider.capabilities.folders) return false;
+    return true;
+}
+function createLocalProvider(source, registry, label = "assetManager.source.library") {
+    return {
+        id: "local",
+        label,
+        capabilities: {
+            searchable: true,
+            themed: false,
+            mutable: true,
+            requiresAttribution: false,
+            folders: true
+        },
+        listThemes: ()=>[],
+        search: (filter, page, signal)=>source.list(void 0 !== page ? {
+                ...filter,
+                cursor: page
+            } : filter, signal),
+        pickResult: async (asset)=>registry.get(asset.id) ?? {
+                id: asset.id,
+                url: asset.url
+            }
+    };
+}
+function sortKey(entry, field) {
+    switch(field){
+        case "name":
+            return (entry.name ?? "").toLowerCase();
+        case "size":
+            return entry.meta?.size ?? 0;
+        case "kind":
+            return (0, infer_kind_cjs_namespaceObject.inferAssetKind)(entry);
+    }
+}
+function compareEntries(a, b, field) {
+    const ka = sortKey(a, field);
+    const kb = sortKey(b, field);
+    if ("number" == typeof ka && "number" == typeof kb) return ka - kb;
+    return String(ka).localeCompare(String(kb));
+}
+function mergePages(pages, filter) {
+    const field = filter.sort?.field ?? "recent";
+    const comparable = "name" === field || "size" === field || "kind" === field;
+    const items = pages.flatMap((p)=>[
+            ...p.page.items
+        ]);
+    if (comparable) {
+        const dir = filter.sort?.direction ?? ("name" === field ? "asc" : "desc");
+        const sign = "asc" === dir ? 1 : -1;
+        items.sort((a, b)=>compareEntries(a, b, field) * sign);
+    }
+    const total = pages.reduce((n, p)=>n + p.page.total, 0);
+    const sourceCursors = {};
+    const next = {};
+    let hasNext = false;
+    for (const { provider, page } of pages){
+        sourceCursors[provider.id] = page.nextCursor;
+        if (void 0 !== page.nextCursor) {
+            next[provider.id] = page.nextCursor;
+            hasNext = true;
+        }
+    }
+    return {
+        items: Object.freeze(items),
+        total,
+        nextCursor: hasNext ? encodeCompositeCursor(next) : void 0,
+        sourceCursors
+    };
+}
+async function federatedSearch(input) {
+    const { providers, filter, signal } = input;
+    const eligible = providers.filter((p)=>providerCanSatisfy(p, filter));
+    const targets = filter.sources && filter.sources.length > 0 ? eligible.filter((p)=>filter.sources?.includes(p.id)) : eligible;
+    if (0 === targets.length) return {
+        items: Object.freeze([]),
+        total: 0,
+        nextCursor: void 0
+    };
+    const cursors = decodeCompositeCursor(filter.cursor);
+    const settled = await Promise.allSettled(targets.map((p)=>p.search(filter, cursors[p.id], signal)));
+    const ok = [];
+    settled.forEach((result, index)=>{
+        const provider = targets[index];
+        if (void 0 !== provider && "fulfilled" === result.status) ok.push({
+            provider,
+            page: result.value
+        });
+    });
+    return mergePages(ok, filter);
+}
+exports.createLocalProvider = __webpack_exports__.createLocalProvider;
+exports.decodeCompositeCursor = __webpack_exports__.decodeCompositeCursor;
+exports.encodeCompositeCursor = __webpack_exports__.encodeCompositeCursor;
+exports.federatedSearch = __webpack_exports__.federatedSearch;
+exports.providerCanSatisfy = __webpack_exports__.providerCanSatisfy;
+for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "createLocalProvider",
+    "decodeCompositeCursor",
+    "encodeCompositeCursor",
+    "federatedSearch",
+    "providerCanSatisfy"
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

package/dist/sources/federated-search.d.cts

@@ -0,0 +1,33 @@
+/**
+ * @file Federated search across asset source providers (PRD 0002 §9.3).
+ *
+ * Routes a single-source query to one provider, or federates across many with
+ * `Promise.allSettled` (one failing remote never blanks the rest). The page
+ * cursor is an OPAQUE composite token carrying one sub-cursor per source, so
+ * each provider paginates independently. Comparable sorts (name/size/kind) are
+ * k-way merged; `recent`/`relevance` fall back to provider-grouped order
+ * (incomparable across heterogeneous sources).
+ */
+import type { AssetFilter, AssetListPage } from "../types/filter.js";
+import type { AssetRegistry } from "../types/types.js";
+import type { ResolvedAssetDataSource } from "../utils/data-source.js";
+import type { AssetSourceProvider } from "./provider.js";
+type CompositeCursor = Record<string, string | undefined>;
+export declare function encodeCompositeCursor(cursor: CompositeCursor): string;
+export declare function decodeCompositeCursor(token: string | undefined): CompositeCursor;
+/** A provider is eligible only if it can satisfy every required axis of the filter. */
+export declare function providerCanSatisfy(provider: AssetSourceProvider, filter: AssetFilter): boolean;
+/** Adapt the resolved (local) data source into an `AssetSourceProvider`. */
+export declare function createLocalProvider(source: ResolvedAssetDataSource, registry: AssetRegistry, label?: string): AssetSourceProvider;
+export interface FederatedSearchInput {
+    readonly providers: readonly AssetSourceProvider[];
+    readonly filter: AssetFilter;
+    readonly signal?: AbortSignal;
+}
+/**
+ * Run a filter across providers. `filter.sources` naming exactly one provider
+ * ROUTES to it (zero other calls); otherwise eligible providers FEDERATE.
+ */
+export declare function federatedSearch(input: FederatedSearchInput): Promise<AssetListPage>;
+export {};
+//# sourceMappingURL=federated-search.d.cts.map

package/dist/sources/federated-search.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"federated-search.d.cts","sourceRoot":"","sources":["../../src/sources/federated-search.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,KAAK,EAAE,aAAa,EAAgB,MAAM,mBAAmB,CAAC;AACrE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAEvE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAEzD,KAAK,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;AAY1D,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAErE;AAED,wBAAgB,qBAAqB,CACpC,KAAK,EAAE,MAAM,GAAG,SAAS,GACvB,eAAe,CAUjB;AAED,uFAAuF;AACvF,wBAAgB,kBAAkB,CACjC,QAAQ,EAAE,mBAAmB,EAC7B,MAAM,EAAE,WAAW,GACjB,OAAO,CAKT;AAED,4EAA4E;AAC5E,wBAAgB,mBAAmB,CAClC,MAAM,EAAE,uBAAuB,EAC/B,QAAQ,EAAE,aAAa,EACvB,KAAK,SAAgC,GACnC,mBAAmB,CAqBrB;AA+DD,MAAM,WAAW,oBAAoB;IACpC,QAAQ,CAAC,SAAS,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACnD,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC9B;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACpC,KAAK,EAAE,oBAAoB,GACzB,OAAO,CAAC,aAAa,CAAC,CA4BxB"}

package/dist/sources/federated-search.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @file Federated search across asset source providers (PRD 0002 §9.3).
+ *
+ * Routes a single-source query to one provider, or federates across many with
+ * `Promise.allSettled` (one failing remote never blanks the rest). The page
+ * cursor is an OPAQUE composite token carrying one sub-cursor per source, so
+ * each provider paginates independently. Comparable sorts (name/size/kind) are
+ * k-way merged; `recent`/`relevance` fall back to provider-grouped order
+ * (incomparable across heterogeneous sources).
+ */
+import type { AssetFilter, AssetListPage } from "../types/filter.js";
+import type { AssetRegistry } from "../types/types.js";
+import type { ResolvedAssetDataSource } from "../utils/data-source.js";
+import type { AssetSourceProvider } from "./provider.js";
+type CompositeCursor = Record<string, string | undefined>;
+export declare function encodeCompositeCursor(cursor: CompositeCursor): string;
+export declare function decodeCompositeCursor(token: string | undefined): CompositeCursor;
+/** A provider is eligible only if it can satisfy every required axis of the filter. */
+export declare function providerCanSatisfy(provider: AssetSourceProvider, filter: AssetFilter): boolean;
+/** Adapt the resolved (local) data source into an `AssetSourceProvider`. */
+export declare function createLocalProvider(source: ResolvedAssetDataSource, registry: AssetRegistry, label?: string): AssetSourceProvider;
+export interface FederatedSearchInput {
+    readonly providers: readonly AssetSourceProvider[];
+    readonly filter: AssetFilter;
+    readonly signal?: AbortSignal;
+}
+/**
+ * Run a filter across providers. `filter.sources` naming exactly one provider
+ * ROUTES to it (zero other calls); otherwise eligible providers FEDERATE.
+ */
+export declare function federatedSearch(input: FederatedSearchInput): Promise<AssetListPage>;
+export {};
+//# sourceMappingURL=federated-search.d.ts.map