@anvilkit/plugin-asset-manager 0.1.6 → 0.1.8

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,27 @@ 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?: {
+        /**
+         * Provider that requires the credit. Open string union: `"unsplash"`
+         * keeps autocomplete while a future credit-requiring provider (Pexels,
+         * etc.) can set its own id without a breaking type change. Mirrors the
+         * `AssetSourceId` idiom.
+         */
+        readonly source: "unsplash" | (string & {});
+        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 +61,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,27 @@ 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?: {
+        /**
+         * Provider that requires the credit. Open string union: `"unsplash"`
+         * keeps autocomplete while a future credit-requiring provider (Pexels,
+         * etc.) can set its own id without a breaking type change. Mirrors the
+         * `AssetSourceId` idiom.
+         */
+        readonly source: "unsplash" | (string & {});
+        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 +61,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
+});

package/dist/types/unsplash.d.cts

@@ -0,0 +1,60 @@
+/**
+ * @file Unsplash configuration types (PRD 0002 §8.2, §8.3).
+ *
+ * Types only — the runtime client, default themes, and `resolveThemes` land in
+ * Phase 1 under the lazy `./sources/unsplash` subpath. Defining the config shape
+ * here keeps the `AssetManagerOptions.unsplash` field fully typed now.
+ */
+export interface UnsplashTheme {
+    readonly id: string;
+    /** i18n message key (not inline copy). */
+    readonly label: string;
+    /** Tried first via `GET /topics/:id/photos`. */
+    readonly topicSlugs?: readonly string[];
+    /** Fallback / supplement via `GET /search/photos`. */
+    readonly query?: string;
+    readonly orientation?: "landscape" | "portrait" | "squarish";
+    /** Defaults to `"high"`. */
+    readonly contentFilter?: "low" | "high";
+}
+export interface UnsplashThemeConfig {
+    /** Replace the default theme set entirely. */
+    readonly themes?: readonly UnsplashTheme[];
+    /** Append to the defaults. */
+    readonly additionalThemes?: readonly UnsplashTheme[];
+    /** Theme ids to drop from the defaults. */
+    readonly excludeThemes?: readonly string[];
+    readonly defaultThemeId?: string;
+    /** When `false`, the `__all__` free-search pseudo-theme is not prepended. */
+    readonly allowFreeSearch?: boolean;
+}
+export interface UnsplashSourceOptions {
+    /** RECOMMENDED — proxy injects the `Client-ID` server-side. */
+    readonly proxyEndpoint?: string | URL;
+    /** DEV ONLY — ships the key to the browser; ignored when `proxyEndpoint` is set. */
+    readonly accessKey?: string;
+    /** Defaults to `!!(proxyEndpoint || accessKey)`; the package never bundles a key. */
+    readonly enabled?: boolean;
+    /** REQUIRED when enabled — `utm_source` for mandatory attribution. */
+    readonly appName: string;
+    readonly themes?: UnsplashThemeConfig;
+    /** Default 24 (clamped 1–30). */
+    readonly perPage?: number;
+    /** Throttle floor between JSON requests. Default 1200. */
+    readonly minRequestIntervalMs?: number;
+    /** Result LRU TTL. Default 300_000. */
+    readonly cacheTtlMs?: number;
+    /**
+     * Per-request timeout for search / topic / photo lookups (ms). A request
+     * that exceeds it aborts and surfaces as a retryable `PROVIDER_NETWORK`
+     * error, so a blocked or flaky network path (e.g. a VPN/proxy black-holing
+     * `api.unsplash.com`) lets the sidebar fall back to "Unsplash unavailable"
+     * instead of spinning. Default 15_000. Ignored if not a positive number.
+     */
+    readonly requestTimeoutMs?: number;
+    /** Injectable fetch for tests / SSR. */
+    readonly fetch?: typeof globalThis.fetch;
+    /** Opt-in re-host instead of hotlinking. Default false. */
+    readonly rehostOnPick?: boolean;
+}
+//# sourceMappingURL=unsplash.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"unsplash.d.cts","sourceRoot":"","sources":["../../src/types/unsplash.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,gDAAgD;IAChD,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,sDAAsD;IACtD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,GAAG,UAAU,GAAG,UAAU,CAAC;IAC7D,4BAA4B;IAC5B,QAAQ,CAAC,aAAa,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;CACxC;AAED,MAAM,WAAW,mBAAmB;IACnC,8CAA8C;IAC9C,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;IAC3C,8BAA8B;IAC9B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;IACrD,2CAA2C;IAC3C,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,6EAA6E;IAC7E,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;CACnC;AAED,MAAM,WAAW,qBAAqB;IACrC,+DAA+D;IAC/D,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC;IACtC,oFAAoF;IACpF,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,qFAAqF;IACrF,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,sEAAsE;IACtE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,mBAAmB,CAAC;IACtC,iCAAiC;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,0DAA0D;IAC1D,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IACvC,uCAAuC;IACvC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B;;;;;;OAMG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,wCAAwC;IACxC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IACzC,2DAA2D;IAC3D,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;CAChC"}

package/dist/types/unsplash.d.ts

@@ -0,0 +1,60 @@
+/**
+ * @file Unsplash configuration types (PRD 0002 §8.2, §8.3).
+ *
+ * Types only — the runtime client, default themes, and `resolveThemes` land in
+ * Phase 1 under the lazy `./sources/unsplash` subpath. Defining the config shape
+ * here keeps the `AssetManagerOptions.unsplash` field fully typed now.
+ */
+export interface UnsplashTheme {
+    readonly id: string;
+    /** i18n message key (not inline copy). */
+    readonly label: string;
+    /** Tried first via `GET /topics/:id/photos`. */
+    readonly topicSlugs?: readonly string[];
+    /** Fallback / supplement via `GET /search/photos`. */
+    readonly query?: string;
+    readonly orientation?: "landscape" | "portrait" | "squarish";
+    /** Defaults to `"high"`. */
+    readonly contentFilter?: "low" | "high";
+}
+export interface UnsplashThemeConfig {
+    /** Replace the default theme set entirely. */
+    readonly themes?: readonly UnsplashTheme[];
+    /** Append to the defaults. */
+    readonly additionalThemes?: readonly UnsplashTheme[];
+    /** Theme ids to drop from the defaults. */
+    readonly excludeThemes?: readonly string[];
+    readonly defaultThemeId?: string;
+    /** When `false`, the `__all__` free-search pseudo-theme is not prepended. */
+    readonly allowFreeSearch?: boolean;
+}
+export interface UnsplashSourceOptions {
+    /** RECOMMENDED — proxy injects the `Client-ID` server-side. */
+    readonly proxyEndpoint?: string | URL;
+    /** DEV ONLY — ships the key to the browser; ignored when `proxyEndpoint` is set. */
+    readonly accessKey?: string;
+    /** Defaults to `!!(proxyEndpoint || accessKey)`; the package never bundles a key. */
+    readonly enabled?: boolean;
+    /** REQUIRED when enabled — `utm_source` for mandatory attribution. */
+    readonly appName: string;
+    readonly themes?: UnsplashThemeConfig;
+    /** Default 24 (clamped 1–30). */
+    readonly perPage?: number;
+    /** Throttle floor between JSON requests. Default 1200. */
+    readonly minRequestIntervalMs?: number;
+    /** Result LRU TTL. Default 300_000. */
+    readonly cacheTtlMs?: number;
+    /**
+     * Per-request timeout for search / topic / photo lookups (ms). A request
+     * that exceeds it aborts and surfaces as a retryable `PROVIDER_NETWORK`
+     * error, so a blocked or flaky network path (e.g. a VPN/proxy black-holing
+     * `api.unsplash.com`) lets the sidebar fall back to "Unsplash unavailable"
+     * instead of spinning. Default 15_000. Ignored if not a positive number.
+     */
+    readonly requestTimeoutMs?: number;
+    /** Injectable fetch for tests / SSR. */
+    readonly fetch?: typeof globalThis.fetch;
+    /** Opt-in re-host instead of hotlinking. Default false. */
+    readonly rehostOnPick?: boolean;
+}
+//# sourceMappingURL=unsplash.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"unsplash.d.ts","sourceRoot":"","sources":["../../src/types/unsplash.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,gDAAgD;IAChD,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,sDAAsD;IACtD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,GAAG,UAAU,GAAG,UAAU,CAAC;IAC7D,4BAA4B;IAC5B,QAAQ,CAAC,aAAa,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;CACxC;AAED,MAAM,WAAW,mBAAmB;IACnC,8CAA8C;IAC9C,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;IAC3C,8BAA8B;IAC9B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;IACrD,2CAA2C;IAC3C,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,6EAA6E;IAC7E,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;CACnC;AAED,MAAM,WAAW,qBAAqB;IACrC,+DAA+D;IAC/D,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC;IACtC,oFAAoF;IACpF,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,qFAAqF;IACrF,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,sEAAsE;IACtE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,mBAAmB,CAAC;IACtC,iCAAiC;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,0DAA0D;IAC1D,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IACvC,uCAAuC;IACvC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B;;;;;;OAMG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,wCAAwC;IACxC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IACzC,2DAA2D;IAC3D,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;CAChC"}

package/dist/types/unsplash.js

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