@anvilkit/plugin-asset-manager 0.1.5 → 0.1.7

package/dist/types/filter.cjs

@@ -0,0 +1,18 @@
+"use strict";
+var __webpack_require__ = {};
+(()=>{
+    __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__);
+for(var __rspack_i in __webpack_exports__)exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

package/dist/types/filter.d.cts

@@ -0,0 +1,55 @@
+/**
+ * @file Unified categorization & filtering model (PRD 0002 §3.2, §9).
+ *
+ * `AssetSearchOptions` (the historic 5-field query in `./types.ts`) is retained
+ * verbatim; {@link AssetFilter} EXTENDS it additively, so every existing caller
+ * keeps compiling while new code gains folder/source/facet/sort axes. The page
+ * envelope {@link AssetListPage} likewise extends the existing `AssetSearchPage`
+ * with a unified folder view (`folders` + `folderPath`) so a single `list()`
+ * returns assets, child folders, and the breadcrumb — no separate `listFolders`.
+ */
+import type { AssetFolder, FolderId } from "./folders.js";
+import type { AssetSearchOptions, AssetSearchPage } from "./types.js";
+/**
+ * Stable source identifiers. Branded so a typo is a type error while hosts can
+ * still introduce their own ids (e.g. `"brandfolder"`).
+ */
+export type AssetSourceId = "local" | "unsplash" | (string & {});
+export type AssetSortField = "recent" | "name" | "size" | "kind" | "relevance";
+export interface AssetSort {
+    readonly field: AssetSortField;
+    /** Defaults are field-appropriate: `recent`→`desc`, `name`→`asc`. */
+    readonly direction?: "asc" | "desc";
+}
+/**
+ * The single, unified query passed to every filterable surface. All fields are
+ * optional and compose with AND semantics (an asset must satisfy every supplied
+ * axis), extending the existing `runSearch()` conjunction.
+ */
+export interface AssetFilter extends AssetSearchOptions {
+    /** Scope to a folder. `null` ⇒ root only; `undefined` ⇒ any folder. */
+    readonly folderId?: FolderId | null;
+    /** When true, include assets in descendant folders too. Default false. */
+    readonly recursive?: boolean;
+    /** Restrict to one or more sources. `undefined` ⇒ federate across all. */
+    readonly sources?: readonly AssetSourceId[];
+    /** Host-registered facet selections, keyed by facet id. */
+    readonly facets?: Readonly<Record<string, readonly string[]>>;
+    /** Sort. Defaults to `{ field: "recent", direction: "desc" }`. */
+    readonly sort?: AssetSort;
+}
+/**
+ * Page envelope: `AssetSearchPage` (assets, paginated) plus the unified folder
+ * view. `folders`/`folderPath` ride OUTSIDE the asset cursor/`limit` (folders
+ * are few and returned whole per scope); only `items` paginates. A flat source
+ * omits the folder fields.
+ */
+export interface AssetListPage extends AssetSearchPage {
+    /** Child folders of `query.folderId` (or the whole sub-tree when `recursive`). */
+    readonly folders?: readonly AssetFolder[];
+    /** Root → … → current folder, for the breadcrumb. Omitted at root. */
+    readonly folderPath?: readonly AssetFolder[];
+    /** Per-source page tokens for federated paging, keyed by source id. */
+    readonly sourceCursors?: Readonly<Record<string, string | undefined>>;
+}
+//# sourceMappingURL=filter.d.cts.map

package/dist/types/filter.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter.d.cts","sourceRoot":"","sources":["../../src/types/filter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEtE;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,UAAU,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAEjE,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,WAAW,CAAC;AAE/E,MAAM,WAAW,SAAS;IACzB,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,qEAAqE;IACrE,QAAQ,CAAC,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;CACpC;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAY,SAAQ,kBAAkB;IACtD,uEAAuE;IACvE,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC;IACpC,0EAA0E;IAC1E,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,0EAA0E;IAC1E,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;IAC5C,2DAA2D;IAC3D,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC,CAAC;IAC9D,kEAAkE;IAClE,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC;CAC1B;AAED;;;;;GAKG;AACH,MAAM,WAAW,aAAc,SAAQ,eAAe;IACrD,kFAAkF;IAClF,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;IAC1C,sEAAsE;IACtE,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;IAC7C,uEAAuE;IACvE,QAAQ,CAAC,aAAa,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;CACtE"}

package/dist/types/filter.d.ts

@@ -0,0 +1,55 @@
+/**
+ * @file Unified categorization & filtering model (PRD 0002 §3.2, §9).
+ *
+ * `AssetSearchOptions` (the historic 5-field query in `./types.ts`) is retained
+ * verbatim; {@link AssetFilter} EXTENDS it additively, so every existing caller
+ * keeps compiling while new code gains folder/source/facet/sort axes. The page
+ * envelope {@link AssetListPage} likewise extends the existing `AssetSearchPage`
+ * with a unified folder view (`folders` + `folderPath`) so a single `list()`
+ * returns assets, child folders, and the breadcrumb — no separate `listFolders`.
+ */
+import type { AssetFolder, FolderId } from "./folders.js";
+import type { AssetSearchOptions, AssetSearchPage } from "./types.js";
+/**
+ * Stable source identifiers. Branded so a typo is a type error while hosts can
+ * still introduce their own ids (e.g. `"brandfolder"`).
+ */
+export type AssetSourceId = "local" | "unsplash" | (string & {});
+export type AssetSortField = "recent" | "name" | "size" | "kind" | "relevance";
+export interface AssetSort {
+    readonly field: AssetSortField;
+    /** Defaults are field-appropriate: `recent`→`desc`, `name`→`asc`. */
+    readonly direction?: "asc" | "desc";
+}
+/**
+ * The single, unified query passed to every filterable surface. All fields are
+ * optional and compose with AND semantics (an asset must satisfy every supplied
+ * axis), extending the existing `runSearch()` conjunction.
+ */
+export interface AssetFilter extends AssetSearchOptions {
+    /** Scope to a folder. `null` ⇒ root only; `undefined` ⇒ any folder. */
+    readonly folderId?: FolderId | null;
+    /** When true, include assets in descendant folders too. Default false. */
+    readonly recursive?: boolean;
+    /** Restrict to one or more sources. `undefined` ⇒ federate across all. */
+    readonly sources?: readonly AssetSourceId[];
+    /** Host-registered facet selections, keyed by facet id. */
+    readonly facets?: Readonly<Record<string, readonly string[]>>;
+    /** Sort. Defaults to `{ field: "recent", direction: "desc" }`. */
+    readonly sort?: AssetSort;
+}
+/**
+ * Page envelope: `AssetSearchPage` (assets, paginated) plus the unified folder
+ * view. `folders`/`folderPath` ride OUTSIDE the asset cursor/`limit` (folders
+ * are few and returned whole per scope); only `items` paginates. A flat source
+ * omits the folder fields.
+ */
+export interface AssetListPage extends AssetSearchPage {
+    /** Child folders of `query.folderId` (or the whole sub-tree when `recursive`). */
+    readonly folders?: readonly AssetFolder[];
+    /** Root → … → current folder, for the breadcrumb. Omitted at root. */
+    readonly folderPath?: readonly AssetFolder[];
+    /** Per-source page tokens for federated paging, keyed by source id. */
+    readonly sourceCursors?: Readonly<Record<string, string | undefined>>;
+}
+//# sourceMappingURL=filter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"filter.d.ts","sourceRoot":"","sources":["../../src/types/filter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEtE;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,UAAU,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAEjE,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,WAAW,CAAC;AAE/E,MAAM,WAAW,SAAS;IACzB,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,qEAAqE;IACrE,QAAQ,CAAC,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;CACpC;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAY,SAAQ,kBAAkB;IACtD,uEAAuE;IACvE,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC;IACpC,0EAA0E;IAC1E,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,0EAA0E;IAC1E,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;IAC5C,2DAA2D;IAC3D,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC,CAAC;IAC9D,kEAAkE;IAClE,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC;CAC1B;AAED;;;;;GAKG;AACH,MAAM,WAAW,aAAc,SAAQ,eAAe;IACrD,kFAAkF;IAClF,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;IAC1C,sEAAsE;IACtE,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;IAC7C,uEAAuE;IACvE,QAAQ,CAAC,aAAa,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;CACtE"}

package/dist/types/filter.js

@@ -0,0 +1 @@
+export { };

package/dist/types/folders.cjs

@@ -0,0 +1,42 @@
+"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__);
+function resolveFolderId(folderId) {
+    return folderId ?? null;
+}
+__webpack_require__.d(__webpack_exports__, {
+    resolveFolderId: ()=>resolveFolderId
+});
+exports.resolveFolderId = __webpack_exports__.resolveFolderId;
+for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "resolveFolderId"
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

package/dist/types/folders.d.cts

@@ -0,0 +1,46 @@
+/**
+ * @file Folder model for the asset library (PRD 0002 §3.1).
+ *
+ * Folders form an arbitrarily-deep tree keyed by {@link AssetFolder.parentId};
+ * `null` is the single root convention everywhere a folder id is accepted —
+ * there is no string sentinel. Folder *membership* (which folder an asset lives
+ * in) is a registry-owned side-index, NOT a field on `UploadResult`, so these
+ * types never bleed into the freeze/validate reconstruction of an asset.
+ */
+/** Canonical id of a folder. `null` (never a real id) denotes the root. */
+export type FolderId = string;
+export interface AssetFolder {
+    readonly id: FolderId;
+    /** Display name; trimmed, non-empty. Siblings are case-insensitively unique. */
+    readonly name: string;
+    /** Parent container. `null` ⇒ top level. */
+    readonly parentId: FolderId | null;
+    /** Epoch-ms creation timestamp (stamped via an injected clock, test-friendly). */
+    readonly createdAt: number;
+    /** Epoch-ms last-mutation timestamp. */
+    readonly updatedAt: number;
+    /**
+     * Denormalized direct-child counts for cheap tree rendering. NEVER the
+     * source of truth for membership — the asset→folder side-index is.
+     */
+    readonly counts: {
+        readonly assets: number;
+        readonly folders: number;
+    };
+    /** Optional host-opaque metadata (e.g. color label, ACL). */
+    readonly meta?: Readonly<Record<string, string | number | boolean>>;
+}
+export interface FolderOptions {
+    /** Maximum nesting depth. `undefined` ⇒ unbounded. */
+    readonly maxDepth?: number;
+    /** Allow moving assets/folders. `undefined` ⇒ treated as `true`. */
+    readonly allowMove?: boolean;
+}
+/**
+ * Normalize a folder-id input to the canonical root convention: `undefined`
+ * and `null` both collapse to `null` (root); a real id is returned unchanged.
+ * This is the only folder-id normalization helper — there is no `__root__`
+ * sentinel to expand or collapse.
+ */
+export declare function resolveFolderId(folderId?: FolderId | null): FolderId | null;
+//# sourceMappingURL=folders.d.cts.map

package/dist/types/folders.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"folders.d.cts","sourceRoot":"","sources":["../../src/types/folders.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,2EAA2E;AAC3E,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC;AAE9B,MAAM,WAAW,WAAW;IAC3B,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC;IACtB,gFAAgF;IAChF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,4CAA4C;IAC5C,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IACnC,kFAAkF;IAClF,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,wCAAwC;IACxC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE;QAChB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;KACzB,CAAC;IACF,6DAA6D;IAC7D,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;CACpE;AAED,MAAM,WAAW,aAAa;IAC7B,sDAAsD;IACtD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,oEAAoE;IACpE,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,QAAQ,CAAC,EAAE,QAAQ,GAAG,IAAI,GAAG,QAAQ,GAAG,IAAI,CAE3E"}

package/dist/types/folders.d.ts

@@ -0,0 +1,46 @@
+/**
+ * @file Folder model for the asset library (PRD 0002 §3.1).
+ *
+ * Folders form an arbitrarily-deep tree keyed by {@link AssetFolder.parentId};
+ * `null` is the single root convention everywhere a folder id is accepted —
+ * there is no string sentinel. Folder *membership* (which folder an asset lives
+ * in) is a registry-owned side-index, NOT a field on `UploadResult`, so these
+ * types never bleed into the freeze/validate reconstruction of an asset.
+ */
+/** Canonical id of a folder. `null` (never a real id) denotes the root. */
+export type FolderId = string;
+export interface AssetFolder {
+    readonly id: FolderId;
+    /** Display name; trimmed, non-empty. Siblings are case-insensitively unique. */
+    readonly name: string;
+    /** Parent container. `null` ⇒ top level. */
+    readonly parentId: FolderId | null;
+    /** Epoch-ms creation timestamp (stamped via an injected clock, test-friendly). */
+    readonly createdAt: number;
+    /** Epoch-ms last-mutation timestamp. */
+    readonly updatedAt: number;
+    /**
+     * Denormalized direct-child counts for cheap tree rendering. NEVER the
+     * source of truth for membership — the asset→folder side-index is.
+     */
+    readonly counts: {
+        readonly assets: number;
+        readonly folders: number;
+    };
+    /** Optional host-opaque metadata (e.g. color label, ACL). */
+    readonly meta?: Readonly<Record<string, string | number | boolean>>;
+}
+export interface FolderOptions {
+    /** Maximum nesting depth. `undefined` ⇒ unbounded. */
+    readonly maxDepth?: number;
+    /** Allow moving assets/folders. `undefined` ⇒ treated as `true`. */
+    readonly allowMove?: boolean;
+}
+/**
+ * Normalize a folder-id input to the canonical root convention: `undefined`
+ * and `null` both collapse to `null` (root); a real id is returned unchanged.
+ * This is the only folder-id normalization helper — there is no `__root__`
+ * sentinel to expand or collapse.
+ */
+export declare function resolveFolderId(folderId?: FolderId | null): FolderId | null;
+//# sourceMappingURL=folders.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"folders.d.ts","sourceRoot":"","sources":["../../src/types/folders.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,2EAA2E;AAC3E,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC;AAE9B,MAAM,WAAW,WAAW;IAC3B,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC;IACtB,gFAAgF;IAChF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,4CAA4C;IAC5C,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IACnC,kFAAkF;IAClF,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,wCAAwC;IACxC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE;QAChB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;KACzB,CAAC;IACF,6DAA6D;IAC7D,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;CACpE;AAED,MAAM,WAAW,aAAa;IAC7B,sDAAsD;IACtD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,oEAAoE;IACpE,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,QAAQ,CAAC,EAAE,QAAQ,GAAG,IAAI,GAAG,QAAQ,GAAG,IAAI,CAE3E"}

package/dist/types/folders.js

@@ -0,0 +1,4 @@
+function resolveFolderId(folderId) {
+    return folderId ?? null;
+}
+export { resolveFolderId };

package/dist/types/options.cjs

@@ -0,0 +1,18 @@
+"use strict";
+var __webpack_require__ = {};
+(()=>{
+    __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__);
+for(var __rspack_i in __webpack_exports__)exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

package/dist/types/options.d.cts

@@ -0,0 +1,68 @@
+/**
+ * @file The asset-manager plugin's public options surface (PRD 0002 §4).
+ *
+ * Hoisted out of `types.ts` into its own module so it can aggregate the new
+ * data-source / folder / provider / category / Unsplash contracts WITHOUT
+ * forming an import cycle (those modules depend on `types.ts`; this one sits
+ * above them). The public name `AssetManagerOptions` is unchanged and
+ * re-exported from the package barrel — a pure relocation, not a rename.
+ */
+import type { AssetSourceProvider } from "../sources/provider.js";
+import type { AssetCategory, AssetFacetDefinition } from "./categories.js";
+import type { AssetDataSource } from "./data-source.js";
+import type { FolderOptions } from "./folders.js";
+import type { UploadAdapter, UploadResult } from "./types.js";
+import type { UnsplashSourceOptions } from "./unsplash.js";
+export interface AssetManagerOptions {
+    /**
+     * Binary ingest: `File → UploadResult`. WIDENED to optional in PRD 0002 —
+     * omitted ⇒ the plugin resolves the built-in `inMemoryUploader()`, so
+     * `createAssetManagerPlugin()` works with zero config. The resolved value is
+     * always non-optional internally; every existing `{ uploader }` caller still
+     * assigns (pure widening).
+     */
+    readonly uploader?: UploadAdapter;
+    /**
+     * Unified local-library data plane (list + asset/folder CRUD). Omitted ⇒ a
+     * full in-memory default over the built-in registry + a folder side-index.
+     */
+    readonly dataSource?: AssetDataSource;
+    /**
+     * Enable folder management. `true` (default) ⇒ in-memory folder store;
+     * `false` ⇒ flat library (today's UX); an object tunes depth / move.
+     */
+    readonly folders?: boolean | FolderOptions;
+    /** Additional external read-only sources (federated tabs, e.g. Unsplash). */
+    readonly providers?: readonly AssetSourceProvider[];
+    /**
+     * Built-in Unsplash source config — sugar that builds + registers an Unsplash
+     * provider. Enabled when a proxy endpoint or access key is present; the
+     * package never bundles a key.
+     */
+    readonly unsplash?: UnsplashSourceOptions;
+    /** Host saved-view chips shown beside the kind chips. */
+    readonly categories?: readonly AssetCategory[];
+    /** Host-registered custom facets, merged onto the built-ins. */
+    readonly facets?: readonly AssetFacetDefinition[];
+    readonly maxFileSize?: number;
+    readonly acceptedMimeTypes?: readonly string[];
+    /**
+     * Permit `data:` URLs through the trust boundary. Defaults to `false` —
+     * `http`, `https`, and `blob` are always allowed; every other scheme is
+     * rejected. Replaced the previous `urlAllowlist: ["data"]` pattern in v1.0.
+     */
+    readonly dataUrlAllowlistOptIn?: boolean;
+    /**
+     * Permit `http(s)` URLs whose hostname mixes Unicode scripts. Defaults to
+     * `false` (homoglyph-attack guard). Single-script IDN hosts are always
+     * allowed regardless of this flag.
+     */
+    readonly allowMixedScriptHostnames?: boolean;
+    /**
+     * Optional thumbnail derivation. Returning a string sets
+     * `StudioAsset.thumbnailUrl`; returning `undefined` suppresses the thumbnail
+     * (overriding the default-for-images behavior).
+     */
+    readonly getThumbnail?: (entry: UploadResult) => string | undefined;
+}
+//# sourceMappingURL=options.d.cts.map

package/dist/types/options.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.cts","sourceRoot":"","sources":["../../src/types/options.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC3E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAE3D,MAAM,WAAW,mBAAmB;IACnC;;;;;;OAMG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC;IAClC;;;OAGG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,eAAe,CAAC;IACtC;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,aAAa,CAAC;IAC3C,6EAA6E;IAC7E,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACpD;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,qBAAqB,CAAC;IAC1C,yDAAyD;IACzD,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;IAC/C,gEAAgE;IAChE,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAGlD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/C;;;;OAIG;IACH,QAAQ,CAAC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IACzC;;;;OAIG;IACH,QAAQ,CAAC,yBAAyB,CAAC,EAAE,OAAO,CAAC;IAC7C;;;;OAIG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,MAAM,GAAG,SAAS,CAAC;CACpE"}

package/dist/types/options.d.ts

@@ -0,0 +1,68 @@
+/**
+ * @file The asset-manager plugin's public options surface (PRD 0002 §4).
+ *
+ * Hoisted out of `types.ts` into its own module so it can aggregate the new
+ * data-source / folder / provider / category / Unsplash contracts WITHOUT
+ * forming an import cycle (those modules depend on `types.ts`; this one sits
+ * above them). The public name `AssetManagerOptions` is unchanged and
+ * re-exported from the package barrel — a pure relocation, not a rename.
+ */
+import type { AssetSourceProvider } from "../sources/provider.js";
+import type { AssetCategory, AssetFacetDefinition } from "./categories.js";
+import type { AssetDataSource } from "./data-source.js";
+import type { FolderOptions } from "./folders.js";
+import type { UploadAdapter, UploadResult } from "./types.js";
+import type { UnsplashSourceOptions } from "./unsplash.js";
+export interface AssetManagerOptions {
+    /**
+     * Binary ingest: `File → UploadResult`. WIDENED to optional in PRD 0002 —
+     * omitted ⇒ the plugin resolves the built-in `inMemoryUploader()`, so
+     * `createAssetManagerPlugin()` works with zero config. The resolved value is
+     * always non-optional internally; every existing `{ uploader }` caller still
+     * assigns (pure widening).
+     */
+    readonly uploader?: UploadAdapter;
+    /**
+     * Unified local-library data plane (list + asset/folder CRUD). Omitted ⇒ a
+     * full in-memory default over the built-in registry + a folder side-index.
+     */
+    readonly dataSource?: AssetDataSource;
+    /**
+     * Enable folder management. `true` (default) ⇒ in-memory folder store;
+     * `false` ⇒ flat library (today's UX); an object tunes depth / move.
+     */
+    readonly folders?: boolean | FolderOptions;
+    /** Additional external read-only sources (federated tabs, e.g. Unsplash). */
+    readonly providers?: readonly AssetSourceProvider[];
+    /**
+     * Built-in Unsplash source config — sugar that builds + registers an Unsplash
+     * provider. Enabled when a proxy endpoint or access key is present; the
+     * package never bundles a key.
+     */
+    readonly unsplash?: UnsplashSourceOptions;
+    /** Host saved-view chips shown beside the kind chips. */
+    readonly categories?: readonly AssetCategory[];
+    /** Host-registered custom facets, merged onto the built-ins. */
+    readonly facets?: readonly AssetFacetDefinition[];
+    readonly maxFileSize?: number;
+    readonly acceptedMimeTypes?: readonly string[];
+    /**
+     * Permit `data:` URLs through the trust boundary. Defaults to `false` —
+     * `http`, `https`, and `blob` are always allowed; every other scheme is
+     * rejected. Replaced the previous `urlAllowlist: ["data"]` pattern in v1.0.
+     */
+    readonly dataUrlAllowlistOptIn?: boolean;
+    /**
+     * Permit `http(s)` URLs whose hostname mixes Unicode scripts. Defaults to
+     * `false` (homoglyph-attack guard). Single-script IDN hosts are always
+     * allowed regardless of this flag.
+     */
+    readonly allowMixedScriptHostnames?: boolean;
+    /**
+     * Optional thumbnail derivation. Returning a string sets
+     * `StudioAsset.thumbnailUrl`; returning `undefined` suppresses the thumbnail
+     * (overriding the default-for-images behavior).
+     */
+    readonly getThumbnail?: (entry: UploadResult) => string | undefined;
+}
+//# sourceMappingURL=options.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../src/types/options.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC3E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAE3D,MAAM,WAAW,mBAAmB;IACnC;;;;;;OAMG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC;IAClC;;;OAGG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,eAAe,CAAC;IACtC;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,aAAa,CAAC;IAC3C,6EAA6E;IAC7E,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACpD;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,qBAAqB,CAAC;IAC1C,yDAAyD;IACzD,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;IAC/C,gEAAgE;IAChE,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAGlD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/C;;;;OAIG;IACH,QAAQ,CAAC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IACzC;;;;OAIG;IACH,QAAQ,CAAC,yBAAyB,CAAC,EAAE,OAAO,CAAC;IAC7C;;;;OAIG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,MAAM,GAAG,SAAS,CAAC;CACpE"}

package/dist/types/options.js

@@ -0,0 +1 @@
+export { };

package/dist/types/types.d.cts

@@ -3,6 +3,21 @@ export interface AssetMeta {
     readonly mimeType?: string;
     readonly width?: number;
     readonly height?: number;
+    /**
+     * Optional provenance/attribution for externally-sourced assets (PRD 0002
+     * §8.4). Set when an asset is inserted from a credit-requiring provider such
+     * as Unsplash; export plugins read it to emit the required photographer +
+     * source credit. NOTE: the in-memory registry's freeze reconstructor is
+     * extended to preserve this field in Phase 1 (M5); the type is additive here.
+     */
+    readonly attribution?: {
+        readonly source: "unsplash";
+        readonly photographerName: string;
+        readonly photographerUrl: string;
+        readonly unsplashUrl: string;
+        readonly photoUrl: string;
+        readonly downloadLocation: string;
+    };
 }
 /**
  * Library-management kind union surfaced by `AssetRegistry.search` and
@@ -40,33 +55,6 @@ export interface UploadAdapterOptions {
     readonly signal?: AbortSignal;
 }
 export type UploadAdapter = (file: File, options?: UploadAdapterOptions) => Promise<UploadResult>;
-export interface AssetManagerOptions {
-    readonly uploader: UploadAdapter;
-    readonly maxFileSize?: number;
-    readonly acceptedMimeTypes?: readonly string[];
-    /**
-     * Permit `data:` URLs to flow through the trust boundary. Defaults to
-     * `false` — `http`, `https`, and `blob` are always allowed; every
-     * other scheme is rejected. The previous `urlAllowlist: ["data"]`
-     * pattern is replaced by this typed flag in v1.0.
-     */
-    readonly dataUrlAllowlistOptIn?: boolean;
-    /**
-     * Permit `http(s)` URLs whose hostname mixes Unicode scripts (e.g.
-     * `аpple.com` blending Cyrillic and Latin). Defaults to `false` —
-     * mixed-script hostnames are rejected as a homoglyph-attack guard.
-     * Single-script IDN hosts (e.g. `münchen.de`, `日本.jp`) are always
-     * allowed regardless of this flag.
-     */
-    readonly allowMixedScriptHostnames?: boolean;
-    /**
-     * Optional thumbnail derivation passed to {@link createStudioAssetSource}.
-     * Returning a string sets `StudioAsset.thumbnailUrl`; returning
-     * `undefined` suppresses the thumbnail (overriding the default-for-images
-     * behavior).
-     */
-    readonly getThumbnail?: (entry: UploadResult) => string | undefined;
-}
 /**
  * Listener invoked after every registry mutation
  * (`register` / `delete` / `rename` / `replace` / `setTags`). The

package/dist/types/types.d.cts.map

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

package/dist/types/types.d.ts

@@ -3,6 +3,21 @@ export interface AssetMeta {
     readonly mimeType?: string;
     readonly width?: number;
     readonly height?: number;
+    /**
+     * Optional provenance/attribution for externally-sourced assets (PRD 0002
+     * §8.4). Set when an asset is inserted from a credit-requiring provider such
+     * as Unsplash; export plugins read it to emit the required photographer +
+     * source credit. NOTE: the in-memory registry's freeze reconstructor is
+     * extended to preserve this field in Phase 1 (M5); the type is additive here.
+     */
+    readonly attribution?: {
+        readonly source: "unsplash";
+        readonly photographerName: string;
+        readonly photographerUrl: string;
+        readonly unsplashUrl: string;
+        readonly photoUrl: string;
+        readonly downloadLocation: string;
+    };
 }
 /**
  * Library-management kind union surfaced by `AssetRegistry.search` and
@@ -40,33 +55,6 @@ export interface UploadAdapterOptions {
     readonly signal?: AbortSignal;
 }
 export type UploadAdapter = (file: File, options?: UploadAdapterOptions) => Promise<UploadResult>;
-export interface AssetManagerOptions {
-    readonly uploader: UploadAdapter;
-    readonly maxFileSize?: number;
-    readonly acceptedMimeTypes?: readonly string[];
-    /**
-     * Permit `data:` URLs to flow through the trust boundary. Defaults to
-     * `false` — `http`, `https`, and `blob` are always allowed; every
-     * other scheme is rejected. The previous `urlAllowlist: ["data"]`
-     * pattern is replaced by this typed flag in v1.0.
-     */
-    readonly dataUrlAllowlistOptIn?: boolean;
-    /**
-     * Permit `http(s)` URLs whose hostname mixes Unicode scripts (e.g.
-     * `аpple.com` blending Cyrillic and Latin). Defaults to `false` —
-     * mixed-script hostnames are rejected as a homoglyph-attack guard.
-     * Single-script IDN hosts (e.g. `münchen.de`, `日本.jp`) are always
-     * allowed regardless of this flag.
-     */
-    readonly allowMixedScriptHostnames?: boolean;
-    /**
-     * Optional thumbnail derivation passed to {@link createStudioAssetSource}.
-     * Returning a string sets `StudioAsset.thumbnailUrl`; returning
-     * `undefined` suppresses the thumbnail (overriding the default-for-images
-     * behavior).
-     */
-    readonly getThumbnail?: (entry: UploadResult) => string | undefined;
-}
 /**
  * Listener invoked after every registry mutation
  * (`register` / `delete` / `rename` / `replace` / `setTags`). The

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

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

package/dist/types/unsplash.cjs

@@ -0,0 +1,18 @@
+"use strict";
+var __webpack_require__ = {};
+(()=>{
+    __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__);
+for(var __rspack_i in __webpack_exports__)exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});