@anvilkit/plugin-asset-manager 0.1.6 → 0.1.7

package/README.md

@@ -1,6 +1,6 @@
 # @anvilkit/plugin-asset-manager
 
-> **Alpha (`0.1.6`).** Public surface may still shift before `v1.0`. Bundle budgets enforced in CI: headless ≤ 6 KB gzip, UI subpath ≤ 12 KB gzip.
+> **Alpha (`0.1.7`).** Public surface may still shift before `v1.0`. Bundle budgets enforced in CI: headless entry ≤ 8 KB gzip, UI subpath ≤ 12 KB gzip, Unsplash subpath ≤ 4 KB gzip.
 
 Headless asset manager plugin for Anvilkit Studio. The host provides the upload backend; the plugin handles validation, registration, search, IR-time resolution, CSP guidance, and (optionally) a React UI for the upload + browse experience. Designed for pluggable production backends (S3, GCS, custom HTTP) with strict trust-boundary enforcement on every adapter response.
 
@@ -15,34 +15,36 @@ Non-optional peers: `react >=19.0.0`, `react-dom >=19.0.0`, `@puckeditor/core ^0
 Subpath imports:
 
 - `@anvilkit/plugin-asset-manager` — plugin factory, validation, adapters, CSP advisor, errors.
-- `@anvilkit/plugin-asset-manager/ui` — React UI components.
+- `@anvilkit/plugin-asset-manager/ui` — React UI components (browser + folders + Unsplash panel).
 - `@anvilkit/plugin-asset-manager/retry` — generic `RetryableError` + `withRetry()`.
 - `@anvilkit/plugin-asset-manager/adapters/s3` — production `s3PresignedAdapter`.
+- `@anvilkit/plugin-asset-manager/providers/unsplash` — the lazy, dependency-free Unsplash provider.
 - `@anvilkit/plugin-asset-manager/testing` — fixtures for downstream plugin tests.
 
 ## Quickstart
 
 ```ts
-import {
-  createAssetManagerPlugin,
-  dataUrlUploader,
-} from "@anvilkit/plugin-asset-manager";
+import { createAssetManagerPlugin } from "@anvilkit/plugin-asset-manager";
 import { Studio } from "@anvilkit/core";
 
-const assetManager = createAssetManagerPlugin({
-  uploader: dataUrlUploader(),
-});
+// Zero-config: an in-memory library with folders enabled. Every option is optional.
+const assetManager = createAssetManagerPlugin();
 
 <Studio puckConfig={puckConfig} plugins={[assetManager]} />;
 ```
 
-`dataUrlUploader` is dev-only — files are converted to in-memory `data:` URLs (1 MB cap by default). For production, swap in `s3PresignedAdapter` or a custom `UploadAdapter`.
+For real uploads pass an `uploader`. `dataUrlUploader` is dev-only — files are converted to in-memory `data:` URLs (1 MB cap by default). For production, swap in `s3PresignedAdapter` or a custom `UploadAdapter`. The default Studio sidebar's **Images** rail renders the library, folder breadcrumb/tree, source tabs and (when configured) the Unsplash picker with no extra wiring.
 
 ## Core features
 
 - **Pluggable upload adapters** — `dataUrlUploader`, `inMemoryUploader`, and `s3PresignedAdapter` ship in-box; custom adapters implement the `UploadAdapter` function signature.
 - **Strict trust model** — every adapter response is validated through `validateUploadResult`: scheme allowlist, path-traversal guard, IDN homoglyph guard. `javascript:` / `vbscript:` are hard-blocked. `data:` is opt-in.
 - **In-memory asset registry** — search (`query` / `kinds` / `tags`), opaque cursor pagination, auto-derived tags, rename / retag / replace / delete.
+- **Zero required config** — `createAssetManagerPlugin()` (no args) yields a working in-memory library with folders; wire only the `dataSource` operations you need.
+- **Folders** — tree management (create / rename / move / remove with reparent-or-cascade); membership is library metadata, never IR, so moves never change a rendered page.
+- **Host-backed data source** — optional async `AssetDataSource` (list returns assets + folder tree); per-plane fallback to the in-memory default for omitted methods.
+- **Unsplash** — built-in, lazy, proxy-first source with multiple themes, attribution + mandatory download-trigger; never enters the headless chunk.
+- **Categories & faceted filtering** — kind / tags / folder / source axes (AND-composed) plus host-defined categories & facets; federates across sources with a composite cursor.
 - **IR-time resolution** — `createIRAssetResolver` + `resolveAssets` turn `asset://<id>` references into validated URLs at export / render time.
 - **CSP advisor** — `getRequiredCsp` computes the minimum `connect-src` / `img-src` / `media-src` directives the configured adapters need.
 - **Production-ready S3 adapter** — `s3PresignedAdapter` POST-then-PUT with exponential-backoff retry on 5xx + network failures (4xx fails fast).
@@ -57,14 +59,20 @@ const assetManager = createAssetManagerPlugin({
 function createAssetManagerPlugin(options: AssetManagerOptions): StudioPlugin;
 ```
 
-| Field                       | Type                                           | Default    | Purpose                                                                   |
-| --------------------------- | ---------------------------------------------- | ---------- | ------------------------------------------------------------------------- |
-| `uploader`                  | `UploadAdapter`                                | _required_ | Upload backend.                                                           |
-| `maxFileSize`               | `number`                                       | none       | Bytes. Enforced before the adapter runs.                                  |
-| `acceptedMimeTypes`         | `readonly string[]`                            | none       | Allowlist. Enforced before the adapter runs.                              |
-| `dataUrlAllowlistOptIn`     | `boolean`                                      | `false`    | When `true`, `data:` URLs are valid output.                               |
-| `allowMixedScriptHostnames` | `boolean`                                      | `false`    | When `true`, hostnames mixing Latin with a confusable script are allowed. |
-| `getThumbnail`              | `(entry: UploadResult) => string \| undefined` | none       | Optional override for the displayed thumbnail.                            |
+| Field                       | Type                                           | Default   | Purpose                                                                      |
+| --------------------------- | ---------------------------------------------- | --------- | ---------------------------------------------------------------------------- |
+| `uploader`                  | `UploadAdapter`                                | in-memory | Binary ingest backend (optional; defaults to an in-memory uploader).         |
+| `dataSource`                | `AssetDataSource`                              | in-memory | Host-backed catalog (list / remove / replace / rename / move + folders).     |
+| `folders`                   | `boolean \| FolderOptions`                     | `true`    | Folder management; `false` for a flat library, or `{ maxDepth, allowMove }`. |
+| `providers`                 | `readonly AssetSourceProvider[]`               | `[]`      | Extra read-only sources, federated alongside the local library.              |
+| `unsplash`                  | `UnsplashSourceOptions`                        | none      | Built-in Unsplash source (proxy-first; no bundled key).                      |
+| `categories`                | `readonly AssetCategory[]`                     | none      | Saved-view chips beside the kind filters.                                    |
+| `facets`                    | `readonly AssetFacetDefinition[]`              | none      | Custom faceted filters (local `valueOf` or remote).                          |
+| `maxFileSize`               | `number`                                       | none      | Bytes. Enforced before the adapter runs.                                     |
+| `acceptedMimeTypes`         | `readonly string[]`                            | none      | Allowlist. Enforced before the adapter runs.                                 |
+| `dataUrlAllowlistOptIn`     | `boolean`                                      | `false`   | When `true`, `data:` URLs are valid output.                                  |
+| `allowMixedScriptHostnames` | `boolean`                                      | `false`   | When `true`, hostnames mixing Latin with a confusable script are allowed.    |
+| `getThumbnail`              | `(entry: UploadResult) => string \| undefined` | none      | Optional override for the displayed thumbnail.                               |
 
 ### Imperative API on the plugin context
 

package/dist/index.cjs

@@ -29,6 +29,7 @@ var __webpack_exports__ = {};
 __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
     AssetResolutionError: ()=>errors_cjs_namespaceObject.AssetResolutionError,
+    AssetSourceError: ()=>errors_cjs_namespaceObject.AssetSourceError,
     AssetValidationError: ()=>errors_cjs_namespaceObject.AssetValidationError,
     createAssetManagerPlugin: ()=>external_plugin_cjs_namespaceObject.createAssetManagerPlugin,
     createAssetReference: ()=>external_plugin_cjs_namespaceObject.createAssetReference,
@@ -42,12 +43,14 @@ __webpack_require__.d(__webpack_exports__, {
     inferAssetKind: ()=>infer_kind_cjs_namespaceObject.inferAssetKind,
     inferStudioAssetKind: ()=>studio_asset_source_cjs_namespaceObject.inferStudioAssetKind,
     resolveAssets: ()=>resolver_cjs_namespaceObject.resolveAssets,
+    resolveFolderId: ()=>folders_cjs_namespaceObject.resolveFolderId,
     uploadAsset: ()=>external_plugin_cjs_namespaceObject.uploadAsset,
     validateUploadResult: ()=>validate_upload_result_cjs_namespaceObject.validateUploadResult
 });
 const data_url_cjs_namespaceObject = require("./adapters/data-url.cjs");
 const in_memory_cjs_namespaceObject = require("./adapters/in-memory.cjs");
 const external_plugin_cjs_namespaceObject = require("./plugin.cjs");
+const folders_cjs_namespaceObject = require("./types/folders.cjs");
 const csp_cjs_namespaceObject = require("./utils/csp.cjs");
 const errors_cjs_namespaceObject = require("./utils/errors.cjs");
 const infer_kind_cjs_namespaceObject = require("./utils/infer-kind.cjs");
@@ -56,6 +59,7 @@ const resolver_cjs_namespaceObject = require("./utils/resolver.cjs");
 const studio_asset_source_cjs_namespaceObject = require("./utils/studio-asset-source.cjs");
 const validate_upload_result_cjs_namespaceObject = require("./utils/validate-upload-result.cjs");
 exports.AssetResolutionError = __webpack_exports__.AssetResolutionError;
+exports.AssetSourceError = __webpack_exports__.AssetSourceError;
 exports.AssetValidationError = __webpack_exports__.AssetValidationError;
 exports.createAssetManagerPlugin = __webpack_exports__.createAssetManagerPlugin;
 exports.createAssetReference = __webpack_exports__.createAssetReference;
@@ -69,10 +73,12 @@ exports.inMemoryUploader = __webpack_exports__.inMemoryUploader;
 exports.inferAssetKind = __webpack_exports__.inferAssetKind;
 exports.inferStudioAssetKind = __webpack_exports__.inferStudioAssetKind;
 exports.resolveAssets = __webpack_exports__.resolveAssets;
+exports.resolveFolderId = __webpack_exports__.resolveFolderId;
 exports.uploadAsset = __webpack_exports__.uploadAsset;
 exports.validateUploadResult = __webpack_exports__.validateUploadResult;
 for(var __rspack_i in __webpack_exports__)if (-1 === [
     "AssetResolutionError",
+    "AssetSourceError",
     "AssetValidationError",
     "createAssetManagerPlugin",
     "createAssetReference",
@@ -86,6 +92,7 @@ for(var __rspack_i in __webpack_exports__)if (-1 === [
     "inferAssetKind",
     "inferStudioAssetKind",
     "resolveAssets",
+    "resolveFolderId",
     "uploadAsset",
     "validateUploadResult"
 ].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];

package/dist/index.d.cts

@@ -2,11 +2,19 @@ export type { DataUrlUploaderOptions } from "./adapters/data-url.js";
 export { dataUrlUploader } from "./adapters/data-url.js";
 export { inMemoryUploader } from "./adapters/in-memory.js";
 export { createAssetManagerPlugin, createAssetReference, getAssetRegistry, uploadAsset, } from "./plugin.js";
-export type { AssetKind, AssetManagerOptions, AssetMeta, AssetRegistry, AssetRegistryListener, AssetSearchOptions, AssetSearchPage, UploadAdapter, UploadAdapterOptions, UploadResult, } from "./types/types.js";
+export type { AssetSourceCapabilities, AssetSourceProvider, AssetTheme, } from "./sources/provider.js";
+export type { AssetCategory, AssetFacetDefinition, AssetFacetOption, } from "./types/categories.js";
+export type { AssetDataSource, AssetSourceStatus, ReplacePayload, } from "./types/data-source.js";
+export type { AssetFilter, AssetListPage, AssetSort, AssetSortField, AssetSourceId, } from "./types/filter.js";
+export type { AssetFolder, FolderId, FolderOptions } from "./types/folders.js";
+export { resolveFolderId } from "./types/folders.js";
+export type { AssetManagerOptions } from "./types/options.js";
+export type { AssetKind, AssetMeta, AssetRegistry, AssetRegistryListener, AssetSearchOptions, AssetSearchPage, UploadAdapter, UploadAdapterOptions, UploadResult, } from "./types/types.js";
+export type { UnsplashSourceOptions, UnsplashTheme, UnsplashThemeConfig, } from "./types/unsplash.js";
 export type { RequiredCsp, RequiredCspOptions, S3CspOptions, } from "./utils/csp.js";
 export { getRequiredCsp } from "./utils/csp.js";
-export type { AssetResolutionErrorCode } from "./utils/errors.js";
-export { AssetResolutionError, AssetValidationError } from "./utils/errors.js";
+export type { AssetResolutionErrorCode, AssetSourceErrorCode, } from "./utils/errors.js";
+export { AssetResolutionError, AssetSourceError, AssetValidationError, } from "./utils/errors.js";
 export { inferAssetKind } from "./utils/infer-kind.js";
 export { createAssetRegistry } from "./utils/registry.js";
 export type { CreateIRAssetResolverOptions } from "./utils/resolver.js";

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EACN,wBAAwB,EACxB,oBAAoB,EACpB,gBAAgB,EAChB,WAAW,GACX,MAAM,aAAa,CAAC;AACrB,YAAY,EACX,SAAS,EACT,mBAAmB,EACnB,SAAS,EACT,aAAa,EACb,qBAAqB,EACrB,kBAAkB,EAClB,eAAe,EACf,aAAa,EACb,oBAAoB,EACpB,YAAY,GACZ,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACX,WAAW,EACX,kBAAkB,EAClB,YAAY,GACZ,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,YAAY,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC/E,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,YAAY,EAAE,4BAA4B,EAAE,MAAM,qBAAqB,CAAC;AACxE,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC3E,YAAY,EAAE,8BAA8B,EAAE,MAAM,gCAAgC,CAAC;AACrF,OAAO,EACN,uBAAuB,EACvB,oBAAoB,GACpB,MAAM,gCAAgC,CAAC;AACxC,YAAY,EAAE,2BAA2B,EAAE,MAAM,mCAAmC,CAAC;AACrF,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC"}
+{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EACN,wBAAwB,EACxB,oBAAoB,EACpB,gBAAgB,EAChB,WAAW,GACX,MAAM,aAAa,CAAC;AACrB,YAAY,EACX,uBAAuB,EACvB,mBAAmB,EACnB,UAAU,GACV,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACX,aAAa,EACb,oBAAoB,EACpB,gBAAgB,GAChB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACX,eAAe,EACf,iBAAiB,EACjB,cAAc,GACd,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACX,WAAW,EACX,aAAa,EACb,SAAS,EACT,cAAc,EACd,aAAa,GACb,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAC/E,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,YAAY,EACX,SAAS,EACT,SAAS,EACT,aAAa,EACb,qBAAqB,EACrB,kBAAkB,EAClB,eAAe,EACf,aAAa,EACb,oBAAoB,EACpB,YAAY,GACZ,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACX,qBAAqB,EACrB,aAAa,EACb,mBAAmB,GACnB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACX,WAAW,EACX,kBAAkB,EAClB,YAAY,GACZ,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,YAAY,EACX,wBAAwB,EACxB,oBAAoB,GACpB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACN,oBAAoB,EACpB,gBAAgB,EAChB,oBAAoB,GACpB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,YAAY,EAAE,4BAA4B,EAAE,MAAM,qBAAqB,CAAC;AACxE,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC3E,YAAY,EAAE,8BAA8B,EAAE,MAAM,gCAAgC,CAAC;AACrF,OAAO,EACN,uBAAuB,EACvB,oBAAoB,GACpB,MAAM,gCAAgC,CAAC;AACxC,YAAY,EAAE,2BAA2B,EAAE,MAAM,mCAAmC,CAAC;AACrF,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC"}

package/dist/index.d.ts

@@ -2,11 +2,19 @@ export type { DataUrlUploaderOptions } from "./adapters/data-url.js";
 export { dataUrlUploader } from "./adapters/data-url.js";
 export { inMemoryUploader } from "./adapters/in-memory.js";
 export { createAssetManagerPlugin, createAssetReference, getAssetRegistry, uploadAsset, } from "./plugin.js";
-export type { AssetKind, AssetManagerOptions, AssetMeta, AssetRegistry, AssetRegistryListener, AssetSearchOptions, AssetSearchPage, UploadAdapter, UploadAdapterOptions, UploadResult, } from "./types/types.js";
+export type { AssetSourceCapabilities, AssetSourceProvider, AssetTheme, } from "./sources/provider.js";
+export type { AssetCategory, AssetFacetDefinition, AssetFacetOption, } from "./types/categories.js";
+export type { AssetDataSource, AssetSourceStatus, ReplacePayload, } from "./types/data-source.js";
+export type { AssetFilter, AssetListPage, AssetSort, AssetSortField, AssetSourceId, } from "./types/filter.js";
+export type { AssetFolder, FolderId, FolderOptions } from "./types/folders.js";
+export { resolveFolderId } from "./types/folders.js";
+export type { AssetManagerOptions } from "./types/options.js";
+export type { AssetKind, AssetMeta, AssetRegistry, AssetRegistryListener, AssetSearchOptions, AssetSearchPage, UploadAdapter, UploadAdapterOptions, UploadResult, } from "./types/types.js";
+export type { UnsplashSourceOptions, UnsplashTheme, UnsplashThemeConfig, } from "./types/unsplash.js";
 export type { RequiredCsp, RequiredCspOptions, S3CspOptions, } from "./utils/csp.js";
 export { getRequiredCsp } from "./utils/csp.js";
-export type { AssetResolutionErrorCode } from "./utils/errors.js";
-export { AssetResolutionError, AssetValidationError } from "./utils/errors.js";
+export type { AssetResolutionErrorCode, AssetSourceErrorCode, } from "./utils/errors.js";
+export { AssetResolutionError, AssetSourceError, AssetValidationError, } from "./utils/errors.js";
 export { inferAssetKind } from "./utils/infer-kind.js";
 export { createAssetRegistry } from "./utils/registry.js";
 export type { CreateIRAssetResolverOptions } from "./utils/resolver.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EACN,wBAAwB,EACxB,oBAAoB,EACpB,gBAAgB,EAChB,WAAW,GACX,MAAM,aAAa,CAAC;AACrB,YAAY,EACX,SAAS,EACT,mBAAmB,EACnB,SAAS,EACT,aAAa,EACb,qBAAqB,EACrB,kBAAkB,EAClB,eAAe,EACf,aAAa,EACb,oBAAoB,EACpB,YAAY,GACZ,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACX,WAAW,EACX,kBAAkB,EAClB,YAAY,GACZ,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,YAAY,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC/E,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,YAAY,EAAE,4BAA4B,EAAE,MAAM,qBAAqB,CAAC;AACxE,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC3E,YAAY,EAAE,8BAA8B,EAAE,MAAM,gCAAgC,CAAC;AACrF,OAAO,EACN,uBAAuB,EACvB,oBAAoB,GACpB,MAAM,gCAAgC,CAAC;AACxC,YAAY,EAAE,2BAA2B,EAAE,MAAM,mCAAmC,CAAC;AACrF,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EACN,wBAAwB,EACxB,oBAAoB,EACpB,gBAAgB,EAChB,WAAW,GACX,MAAM,aAAa,CAAC;AACrB,YAAY,EACX,uBAAuB,EACvB,mBAAmB,EACnB,UAAU,GACV,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACX,aAAa,EACb,oBAAoB,EACpB,gBAAgB,GAChB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACX,eAAe,EACf,iBAAiB,EACjB,cAAc,GACd,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACX,WAAW,EACX,aAAa,EACb,SAAS,EACT,cAAc,EACd,aAAa,GACb,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAC/E,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,YAAY,EACX,SAAS,EACT,SAAS,EACT,aAAa,EACb,qBAAqB,EACrB,kBAAkB,EAClB,eAAe,EACf,aAAa,EACb,oBAAoB,EACpB,YAAY,GACZ,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACX,qBAAqB,EACrB,aAAa,EACb,mBAAmB,GACnB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACX,WAAW,EACX,kBAAkB,EAClB,YAAY,GACZ,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,YAAY,EACX,wBAAwB,EACxB,oBAAoB,GACpB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACN,oBAAoB,EACpB,gBAAgB,EAChB,oBAAoB,GACpB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,YAAY,EAAE,4BAA4B,EAAE,MAAM,qBAAqB,CAAC;AACxE,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC3E,YAAY,EAAE,8BAA8B,EAAE,MAAM,gCAAgC,CAAC;AACrF,OAAO,EACN,uBAAuB,EACvB,oBAAoB,GACpB,MAAM,gCAAgC,CAAC;AACxC,YAAY,EAAE,2BAA2B,EAAE,MAAM,mCAAmC,CAAC;AACrF,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC"}

package/dist/index.js

@@ -1,8 +1,9 @@
 export { dataUrlUploader } from "./adapters/data-url.js";
 export { inMemoryUploader } from "./adapters/in-memory.js";
 export { createAssetManagerPlugin, createAssetReference, getAssetRegistry, uploadAsset } from "./plugin.js";
+export { resolveFolderId } from "./types/folders.js";
 export { getRequiredCsp } from "./utils/csp.js";
-export { AssetResolutionError, AssetValidationError } from "./utils/errors.js";
+export { AssetResolutionError, AssetSourceError, AssetValidationError } from "./utils/errors.js";
 export { inferAssetKind } from "./utils/infer-kind.js";
 export { createAssetRegistry } from "./utils/registry.js";
 export { createIRAssetResolver, resolveAssets } from "./utils/resolver.js";

package/dist/plugin.cjs

@@ -47,6 +47,7 @@ const external_lucide_react_namespaceObject = require("lucide-react");
 const external_react_namespaceObject = require("react");
 const config_json_namespaceObject = require("../meta/config.json");
 var config_json_default = /*#__PURE__*/ __webpack_require__.n(config_json_namespaceObject);
+const in_memory_cjs_namespaceObject = require("./adapters/in-memory.cjs");
 const asset_reference_cjs_namespaceObject = require("./utils/asset-reference.cjs");
 const errors_cjs_namespaceObject = require("./utils/errors.cjs");
 const header_action_cjs_namespaceObject = require("./utils/header-action.cjs");
@@ -63,7 +64,7 @@ const META = {
 };
 const stateByToken = new WeakMap();
 const tokenByContext = new WeakMap();
-function createAssetManagerPlugin(options) {
+function createAssetManagerPlugin(options = {}) {
     const token = {};
     const registry = (0, registry_cjs_namespaceObject.createAssetRegistry)();
     const normalizedOptions = normalizeOptions(options);
@@ -90,15 +91,34 @@ function createAssetManagerPlugin(options) {
                         });
                         tokenByContext.set(initCtx, token);
                         initCtx.registerAssetResolver(assetResolver);
+                        const upload = (file, opts)=>uploadAsset(initCtx, file, opts?.signal);
                         const studioAssetSource = (0, studio_asset_source_cjs_namespaceObject.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);
@@ -162,9 +182,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.cjs"),
+        import("./sources/composite-source.cjs")
+    ]);
+    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.cjs");
+        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 ?? (0, in_memory_cjs_namespaceObject.inMemoryUploader)(),
         ...options.acceptedMimeTypes ? {
             acceptedMimeTypes: Object.freeze([
                 ...options.acceptedMimeTypes

package/dist/plugin.d.cts

@@ -1,9 +1,10 @@
 import type { StudioPlugin, StudioPluginContext } from "@anvilkit/core/types";
 import type { Config as PuckConfig } from "@puckeditor/core";
-import type { AssetManagerOptions, AssetRegistry, UploadResult } from "./types/types.js";
+import type { AssetManagerOptions } from "./types/options.js";
+import type { AssetRegistry, UploadResult } from "./types/types.js";
 import { createAssetReference } from "./utils/asset-reference.js";
 export { createAssetReference };
-export declare function createAssetManagerPlugin<UserConfig extends PuckConfig = PuckConfig>(options: AssetManagerOptions): StudioPlugin<UserConfig>;
+export declare function createAssetManagerPlugin<UserConfig extends PuckConfig = PuckConfig>(options?: AssetManagerOptions): StudioPlugin<UserConfig>;
 export declare function getAssetRegistry<UserConfig extends PuckConfig = PuckConfig>(ctx: StudioPluginContext<UserConfig>): AssetRegistry | undefined;
 export declare function uploadAsset<UserConfig extends PuckConfig = PuckConfig>(ctx: StudioPluginContext<UserConfig>, file: File, signal?: AbortSignal): Promise<UploadResult>;
 export declare function validateSelectedFile(file: File, options: Pick<AssetManagerOptions, "acceptedMimeTypes" | "maxFileSize">): void;

package/dist/plugin.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.cts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEX,YAAY,EACZ,mBAAmB,EAEnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAK7D,OAAO,KAAK,EACX,mBAAmB,EAEnB,aAAa,EACb,YAAY,EACZ,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAUlE,OAAO,EAAE,oBAAoB,EAAE,CAAC;AA2BhC,wBAAgB,wBAAwB,CACvC,UAAU,SAAS,UAAU,GAAG,UAAU,EACzC,OAAO,EAAE,mBAAmB,GAAG,YAAY,CAAC,UAAU,CAAC,CAwDxD;AAED,wBAAgB,gBAAgB,CAAC,UAAU,SAAS,UAAU,GAAG,UAAU,EAC1E,GAAG,EAAE,mBAAmB,CAAC,UAAU,CAAC,GAClC,aAAa,GAAG,SAAS,CAG3B;AAED,wBAAsB,WAAW,CAAC,UAAU,SAAS,UAAU,GAAG,UAAU,EAC3E,GAAG,EAAE,mBAAmB,CAAC,UAAU,CAAC,EACpC,IAAI,EAAE,IAAI,EACV,MAAM,CAAC,EAAE,WAAW,GAClB,OAAO,CAAC,YAAY,CAAC,CAwDvB;AAED,wBAAgB,oBAAoB,CACnC,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,IAAI,CAAC,mBAAmB,EAAE,mBAAmB,GAAG,aAAa,CAAC,GACrE,IAAI,CAmBN"}
+{"version":3,"file":"plugin.d.cts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEX,YAAY,EACZ,mBAAmB,EAEnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAS7D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,KAAK,EAEX,aAAa,EAEb,YAAY,EACZ,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAWlE,OAAO,EAAE,oBAAoB,EAAE,CAAC;AA6BhC,wBAAgB,wBAAwB,CACvC,UAAU,SAAS,UAAU,GAAG,UAAU,EACzC,OAAO,GAAE,mBAAwB,GAAG,YAAY,CAAC,UAAU,CAAC,CAyF7D;AAED,wBAAgB,gBAAgB,CAAC,UAAU,SAAS,UAAU,GAAG,UAAU,EAC1E,GAAG,EAAE,mBAAmB,CAAC,UAAU,CAAC,GAClC,aAAa,GAAG,SAAS,CAG3B;AAED,wBAAsB,WAAW,CAAC,UAAU,SAAS,UAAU,GAAG,UAAU,EAC3E,GAAG,EAAE,mBAAmB,CAAC,UAAU,CAAC,EACpC,IAAI,EAAE,IAAI,EACV,MAAM,CAAC,EAAE,WAAW,GAClB,OAAO,CAAC,YAAY,CAAC,CAwDvB;AAED,wBAAgB,oBAAoB,CACnC,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,IAAI,CAAC,mBAAmB,EAAE,mBAAmB,GAAG,aAAa,CAAC,GACrE,IAAI,CAmBN"}

package/dist/plugin.d.ts

@@ -1,9 +1,10 @@
 import type { StudioPlugin, StudioPluginContext } from "@anvilkit/core/types";
 import type { Config as PuckConfig } from "@puckeditor/core";
-import type { AssetManagerOptions, AssetRegistry, UploadResult } from "./types/types.js";
+import type { AssetManagerOptions } from "./types/options.js";
+import type { AssetRegistry, UploadResult } from "./types/types.js";
 import { createAssetReference } from "./utils/asset-reference.js";
 export { createAssetReference };
-export declare function createAssetManagerPlugin<UserConfig extends PuckConfig = PuckConfig>(options: AssetManagerOptions): StudioPlugin<UserConfig>;
+export declare function createAssetManagerPlugin<UserConfig extends PuckConfig = PuckConfig>(options?: AssetManagerOptions): StudioPlugin<UserConfig>;
 export declare function getAssetRegistry<UserConfig extends PuckConfig = PuckConfig>(ctx: StudioPluginContext<UserConfig>): AssetRegistry | undefined;
 export declare function uploadAsset<UserConfig extends PuckConfig = PuckConfig>(ctx: StudioPluginContext<UserConfig>, file: File, signal?: AbortSignal): Promise<UploadResult>;
 export declare function validateSelectedFile(file: File, options: Pick<AssetManagerOptions, "acceptedMimeTypes" | "maxFileSize">): void;

package/dist/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEX,YAAY,EACZ,mBAAmB,EAEnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAK7D,OAAO,KAAK,EACX,mBAAmB,EAEnB,aAAa,EACb,YAAY,EACZ,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAUlE,OAAO,EAAE,oBAAoB,EAAE,CAAC;AA2BhC,wBAAgB,wBAAwB,CACvC,UAAU,SAAS,UAAU,GAAG,UAAU,EACzC,OAAO,EAAE,mBAAmB,GAAG,YAAY,CAAC,UAAU,CAAC,CAwDxD;AAED,wBAAgB,gBAAgB,CAAC,UAAU,SAAS,UAAU,GAAG,UAAU,EAC1E,GAAG,EAAE,mBAAmB,CAAC,UAAU,CAAC,GAClC,aAAa,GAAG,SAAS,CAG3B;AAED,wBAAsB,WAAW,CAAC,UAAU,SAAS,UAAU,GAAG,UAAU,EAC3E,GAAG,EAAE,mBAAmB,CAAC,UAAU,CAAC,EACpC,IAAI,EAAE,IAAI,EACV,MAAM,CAAC,EAAE,WAAW,GAClB,OAAO,CAAC,YAAY,CAAC,CAwDvB;AAED,wBAAgB,oBAAoB,CACnC,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,IAAI,CAAC,mBAAmB,EAAE,mBAAmB,GAAG,aAAa,CAAC,GACrE,IAAI,CAmBN"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEX,YAAY,EACZ,mBAAmB,EAEnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAS7D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,KAAK,EAEX,aAAa,EAEb,YAAY,EACZ,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAWlE,OAAO,EAAE,oBAAoB,EAAE,CAAC;AA6BhC,wBAAgB,wBAAwB,CACvC,UAAU,SAAS,UAAU,GAAG,UAAU,EACzC,OAAO,GAAE,mBAAwB,GAAG,YAAY,CAAC,UAAU,CAAC,CAyF7D;AAED,wBAAgB,gBAAgB,CAAC,UAAU,SAAS,UAAU,GAAG,UAAU,EAC1E,GAAG,EAAE,mBAAmB,CAAC,UAAU,CAAC,GAClC,aAAa,GAAG,SAAS,CAG3B;AAED,wBAAsB,WAAW,CAAC,UAAU,SAAS,UAAU,GAAG,UAAU,EAC3E,GAAG,EAAE,mBAAmB,CAAC,UAAU,CAAC,EACpC,IAAI,EAAE,IAAI,EACV,MAAM,CAAC,EAAE,WAAW,GAClB,OAAO,CAAC,YAAY,CAAC,CAwDvB;AAED,wBAAgB,oBAAoB,CACnC,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,IAAI,CAAC,mBAAmB,EAAE,mBAAmB,GAAG,aAAa,CAAC,GACrE,IAAI,CAmBN"}

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
+});