@anvilkit/plugin-asset-manager 0.1.5 → 0.1.7

package/dist/sources/unsplash/themes.d.cts

@@ -0,0 +1,18 @@
+/**
+ * @file Default Unsplash theme set + resolution (PRD 0002 §8.2). A theme maps
+ * to an Unsplash topic slug (tried first), a curated search query (fallback /
+ * supplement), or both. Labels are i18n message keys, never inline copy.
+ */
+import type { UnsplashTheme, UnsplashThemeConfig } from "../../types/unsplash.js";
+/** The free-search pseudo-theme prepended unless `allowFreeSearch === false`. */
+export declare const ALL_THEME_ID = "__all__";
+export declare const DEFAULT_UNSPLASH_THEMES: readonly UnsplashTheme[];
+/**
+ * Resolve the effective theme list: replace-all when `themes` is given, else
+ * filter the defaults by `excludeThemes` and append `additionalThemes`. The
+ * `__all__` free-search pseudo-theme is prepended unless disabled.
+ */
+export declare function resolveThemes(config?: UnsplashThemeConfig): readonly UnsplashTheme[];
+/** Pick the initial theme: the configured default if present, else the first. */
+export declare function resolveDefaultThemeId(themes: readonly UnsplashTheme[], config?: UnsplashThemeConfig): string | undefined;
+//# sourceMappingURL=themes.d.cts.map

package/dist/sources/unsplash/themes.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"themes.d.cts","sourceRoot":"","sources":["../../../src/sources/unsplash/themes.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACX,aAAa,EACb,mBAAmB,EACnB,MAAM,yBAAyB,CAAC;AAEjC,iFAAiF;AACjF,eAAO,MAAM,YAAY,YAAY,CAAC;AAEtC,eAAO,MAAM,uBAAuB,EAAE,SAAS,aAAa,EAmD1D,CAAC;AAEH;;;;GAIG;AACH,wBAAgB,aAAa,CAC5B,MAAM,CAAC,EAAE,mBAAmB,GAC1B,SAAS,aAAa,EAAE,CAqB1B;AAED,iFAAiF;AACjF,wBAAgB,qBAAqB,CACpC,MAAM,EAAE,SAAS,aAAa,EAAE,EAChC,MAAM,CAAC,EAAE,mBAAmB,GAC1B,MAAM,GAAG,SAAS,CAQpB"}

package/dist/sources/unsplash/themes.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @file Default Unsplash theme set + resolution (PRD 0002 §8.2). A theme maps
+ * to an Unsplash topic slug (tried first), a curated search query (fallback /
+ * supplement), or both. Labels are i18n message keys, never inline copy.
+ */
+import type { UnsplashTheme, UnsplashThemeConfig } from "../../types/unsplash.js";
+/** The free-search pseudo-theme prepended unless `allowFreeSearch === false`. */
+export declare const ALL_THEME_ID = "__all__";
+export declare const DEFAULT_UNSPLASH_THEMES: readonly UnsplashTheme[];
+/**
+ * Resolve the effective theme list: replace-all when `themes` is given, else
+ * filter the defaults by `excludeThemes` and append `additionalThemes`. The
+ * `__all__` free-search pseudo-theme is prepended unless disabled.
+ */
+export declare function resolveThemes(config?: UnsplashThemeConfig): readonly UnsplashTheme[];
+/** Pick the initial theme: the configured default if present, else the first. */
+export declare function resolveDefaultThemeId(themes: readonly UnsplashTheme[], config?: UnsplashThemeConfig): string | undefined;
+//# sourceMappingURL=themes.d.ts.map

package/dist/sources/unsplash/themes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"themes.d.ts","sourceRoot":"","sources":["../../../src/sources/unsplash/themes.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACX,aAAa,EACb,mBAAmB,EACnB,MAAM,yBAAyB,CAAC;AAEjC,iFAAiF;AACjF,eAAO,MAAM,YAAY,YAAY,CAAC;AAEtC,eAAO,MAAM,uBAAuB,EAAE,SAAS,aAAa,EAmD1D,CAAC;AAEH;;;;GAIG;AACH,wBAAgB,aAAa,CAC5B,MAAM,CAAC,EAAE,mBAAmB,GAC1B,SAAS,aAAa,EAAE,CAqB1B;AAED,iFAAiF;AACjF,wBAAgB,qBAAqB,CACpC,MAAM,EAAE,SAAS,aAAa,EAAE,EAChC,MAAM,CAAC,EAAE,mBAAmB,GAC1B,MAAM,GAAG,SAAS,CAQpB"}

package/dist/sources/unsplash/themes.js

@@ -0,0 +1,93 @@
+const ALL_THEME_ID = "__all__";
+const DEFAULT_UNSPLASH_THEMES = Object.freeze([
+    {
+        id: "nature",
+        label: "assetManager.unsplash.theme.nature",
+        topicSlugs: [
+            "nature"
+        ],
+        query: "nature landscape",
+        orientation: "landscape"
+    },
+    {
+        id: "architecture",
+        label: "assetManager.unsplash.theme.architecture",
+        topicSlugs: [
+            "architecture-interior"
+        ],
+        query: "architecture building"
+    },
+    {
+        id: "business",
+        label: "assetManager.unsplash.theme.business",
+        topicSlugs: [
+            "business-work"
+        ],
+        query: "business office work"
+    },
+    {
+        id: "food",
+        label: "assetManager.unsplash.theme.food",
+        topicSlugs: [
+            "food-drink"
+        ],
+        query: "food meal"
+    },
+    {
+        id: "technology",
+        label: "assetManager.unsplash.theme.technology",
+        topicSlugs: [
+            "experimental"
+        ],
+        query: "technology computer"
+    },
+    {
+        id: "travel",
+        label: "assetManager.unsplash.theme.travel",
+        topicSlugs: [
+            "travel"
+        ],
+        query: "travel destination"
+    },
+    {
+        id: "texture",
+        label: "assetManager.unsplash.theme.texture",
+        topicSlugs: [
+            "textures-patterns"
+        ],
+        query: "abstract texture",
+        orientation: "squarish"
+    },
+    {
+        id: "people",
+        label: "assetManager.unsplash.theme.people",
+        topicSlugs: [
+            "people"
+        ],
+        query: "people portrait"
+    }
+]);
+function resolveThemes(config) {
+    let base;
+    if (config?.themes) base = config.themes;
+    else {
+        const excluded = new Set(config?.excludeThemes ?? []);
+        const filtered = excluded.size > 0 ? DEFAULT_UNSPLASH_THEMES.filter((t)=>!excluded.has(t.id)) : DEFAULT_UNSPLASH_THEMES;
+        base = config?.additionalThemes ? [
+            ...filtered,
+            ...config.additionalThemes
+        ] : filtered;
+    }
+    const themes = [];
+    if (config?.allowFreeSearch !== false) themes.push({
+        id: ALL_THEME_ID,
+        label: "assetManager.unsplash.theme.all"
+    });
+    themes.push(...base);
+    return Object.freeze(themes);
+}
+function resolveDefaultThemeId(themes, config) {
+    if (config?.defaultThemeId && themes.some((t)=>t.id === config.defaultThemeId)) return config.defaultThemeId;
+    return themes[0]?.id;
+}
+export { ALL_THEME_ID, DEFAULT_UNSPLASH_THEMES, resolveDefaultThemeId, resolveThemes };

package/dist/sources/unsplash/throttle-cache.cjs

@@ -0,0 +1,86 @@
+"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 createTtlCache(ttlMs, maxEntries = 100) {
+    const map = new Map();
+    return {
+        get (key, now) {
+            const entry = map.get(key);
+            if (void 0 === entry) return;
+            if (entry.expires <= now) return void map.delete(key);
+            map.delete(key);
+            map.set(key, entry);
+            return entry.value;
+        },
+        set (key, value, now) {
+            if (!map.has(key) && map.size >= maxEntries) {
+                const oldest = map.keys().next().value;
+                if (void 0 !== oldest) map.delete(oldest);
+            }
+            map.set(key, {
+                value,
+                expires: now + ttlMs
+            });
+        },
+        get size () {
+            return map.size;
+        }
+    };
+}
+function createSingleFlightThrottle(options) {
+    const now = options.now ?? (()=>Date.now());
+    const wait = options.wait ?? ((ms)=>new Promise((resolve)=>setTimeout(resolve, ms)));
+    let last = -1 / 0;
+    let chain = Promise.resolve();
+    return {
+        run (task) {
+            const result = chain.then(async ()=>{
+                const elapsed = now() - last;
+                if (elapsed < options.minIntervalMs) await wait(options.minIntervalMs - elapsed);
+                last = now();
+                return task();
+            });
+            chain = result.then(()=>void 0, ()=>void 0);
+            return result;
+        }
+    };
+}
+__webpack_require__.d(__webpack_exports__, {
+    createSingleFlightThrottle: ()=>createSingleFlightThrottle,
+    createTtlCache: ()=>createTtlCache
+});
+exports.createSingleFlightThrottle = __webpack_exports__.createSingleFlightThrottle;
+exports.createTtlCache = __webpack_exports__.createTtlCache;
+for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "createSingleFlightThrottle",
+    "createTtlCache"
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

package/dist/sources/unsplash/throttle-cache.d.cts

@@ -0,0 +1,25 @@
+/**
+ * @file Rate-limit discipline for Unsplash JSON calls (PRD 0002 §8.5): an
+ * LRU+TTL result cache and a single-flight throttle that enforces a minimum
+ * interval between requests. Clock + wait are injectable for deterministic tests.
+ */
+export interface TtlCache<T> {
+    get(key: string, now: number): T | undefined;
+    set(key: string, value: T, now: number): void;
+    readonly size: number;
+}
+export declare function createTtlCache<T>(ttlMs: number, maxEntries?: number): TtlCache<T>;
+export interface SingleFlightThrottle {
+    run<T>(task: () => Promise<T>): Promise<T>;
+}
+export interface CreateThrottleOptions {
+    readonly minIntervalMs: number;
+    readonly now?: () => number;
+    readonly wait?: (ms: number) => Promise<void>;
+}
+/**
+ * Serializes tasks and guarantees at least `minIntervalMs` between the *starts*
+ * of consecutive tasks — the politeness Unsplash's quota requires.
+ */
+export declare function createSingleFlightThrottle(options: CreateThrottleOptions): SingleFlightThrottle;
+//# sourceMappingURL=throttle-cache.d.cts.map

package/dist/sources/unsplash/throttle-cache.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"throttle-cache.d.cts","sourceRoot":"","sources":["../../../src/sources/unsplash/throttle-cache.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,QAAQ,CAAC,CAAC;IAC1B,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;IAC7C,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,cAAc,CAAC,CAAC,EAC/B,KAAK,EAAE,MAAM,EACb,UAAU,SAAM,GACd,QAAQ,CAAC,CAAC,CAAC,CA0Bb;AAED,MAAM,WAAW,oBAAoB;IACpC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,qBAAqB;IACrC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9C;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACzC,OAAO,EAAE,qBAAqB,GAC5B,oBAAoB,CA0BtB"}

package/dist/sources/unsplash/throttle-cache.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @file Rate-limit discipline for Unsplash JSON calls (PRD 0002 §8.5): an
+ * LRU+TTL result cache and a single-flight throttle that enforces a minimum
+ * interval between requests. Clock + wait are injectable for deterministic tests.
+ */
+export interface TtlCache<T> {
+    get(key: string, now: number): T | undefined;
+    set(key: string, value: T, now: number): void;
+    readonly size: number;
+}
+export declare function createTtlCache<T>(ttlMs: number, maxEntries?: number): TtlCache<T>;
+export interface SingleFlightThrottle {
+    run<T>(task: () => Promise<T>): Promise<T>;
+}
+export interface CreateThrottleOptions {
+    readonly minIntervalMs: number;
+    readonly now?: () => number;
+    readonly wait?: (ms: number) => Promise<void>;
+}
+/**
+ * Serializes tasks and guarantees at least `minIntervalMs` between the *starts*
+ * of consecutive tasks — the politeness Unsplash's quota requires.
+ */
+export declare function createSingleFlightThrottle(options: CreateThrottleOptions): SingleFlightThrottle;
+//# sourceMappingURL=throttle-cache.d.ts.map

package/dist/sources/unsplash/throttle-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"throttle-cache.d.ts","sourceRoot":"","sources":["../../../src/sources/unsplash/throttle-cache.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,QAAQ,CAAC,CAAC;IAC1B,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;IAC7C,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,cAAc,CAAC,CAAC,EAC/B,KAAK,EAAE,MAAM,EACb,UAAU,SAAM,GACd,QAAQ,CAAC,CAAC,CAAC,CA0Bb;AAED,MAAM,WAAW,oBAAoB;IACpC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,qBAAqB;IACrC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9C;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACzC,OAAO,EAAE,qBAAqB,GAC5B,oBAAoB,CA0BtB"}

package/dist/sources/unsplash/throttle-cache.js

@@ -0,0 +1,45 @@
+function createTtlCache(ttlMs, maxEntries = 100) {
+    const map = new Map();
+    return {
+        get (key, now) {
+            const entry = map.get(key);
+            if (void 0 === entry) return;
+            if (entry.expires <= now) return void map.delete(key);
+            map.delete(key);
+            map.set(key, entry);
+            return entry.value;
+        },
+        set (key, value, now) {
+            if (!map.has(key) && map.size >= maxEntries) {
+                const oldest = map.keys().next().value;
+                if (void 0 !== oldest) map.delete(oldest);
+            }
+            map.set(key, {
+                value,
+                expires: now + ttlMs
+            });
+        },
+        get size () {
+            return map.size;
+        }
+    };
+}
+function createSingleFlightThrottle(options) {
+    const now = options.now ?? (()=>Date.now());
+    const wait = options.wait ?? ((ms)=>new Promise((resolve)=>setTimeout(resolve, ms)));
+    let last = -1 / 0;
+    let chain = Promise.resolve();
+    return {
+        run (task) {
+            const result = chain.then(async ()=>{
+                const elapsed = now() - last;
+                if (elapsed < options.minIntervalMs) await wait(options.minIntervalMs - elapsed);
+                last = now();
+                return task();
+            });
+            chain = result.then(()=>void 0, ()=>void 0);
+            return result;
+        }
+    };
+}
+export { createSingleFlightThrottle, createTtlCache };

package/dist/testing/index.cjs

@@ -1,11 +1,15 @@
 "use strict";
 var __webpack_require__ = {};
 (()=>{
-    __webpack_require__.d = (exports1, definition)=>{
-        for(var key in definition)if (__webpack_require__.o(definition, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
-            enumerable: true,
-            get: definition[key]
-        });
+    __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");
     };
 })();
 (()=>{

package/dist/types/categories.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/categories.d.cts

@@ -0,0 +1,48 @@
+/**
+ * @file Extensible categorization / facet registry (PRD 0002 §3.5, §9.2).
+ *
+ * `kind`, `tags`, `folder`, and `source` are built-in facets registered by the
+ * plugin; hosts append {@link AssetFacetDefinition}s rather than reconfigure.
+ * {@link AssetCategory} is a host-friendly "saved view" sugar over filters and
+ * providers, surfaced as chips beside the kind chips.
+ */
+import type { AssetSourceId } from "./filter.js";
+import type { AssetKind, UploadResult } from "./types.js";
+export interface AssetFacetOption {
+    readonly value: string;
+    readonly label: string;
+    /** Populated by memoized facet counts when available. */
+    readonly count?: number;
+}
+export interface AssetFacetDefinition {
+    /** Stable key; used in `AssetFilter.facets[id]`. */
+    readonly id: string;
+    readonly label: string;
+    /** `"single"` renders as chips/radio; `"multi"` as a multiselect. */
+    readonly selection: "single" | "multi";
+    /** Which sources this facet applies to. `undefined` ⇒ all. */
+    readonly appliesTo?: readonly AssetSourceId[];
+    /** Derive the asset's value(s) for this facet (local, sync). */
+    readonly valueOf?: (asset: UploadResult) => readonly string[] | undefined;
+    /** Static options, or an async loader for remote facets (e.g. Unsplash topics). */
+    readonly options?: readonly AssetFacetOption[] | ((ctx: {
+        readonly source?: AssetSourceId;
+    }) => Promise<readonly AssetFacetOption[]>);
+    /** When true, the facet is delegated to the source instead of matched locally. */
+    readonly remote?: boolean;
+}
+export interface AssetCategory {
+    readonly id: string;
+    readonly label: string;
+    /** Local match composed with AND-semantic search. */
+    readonly match?: {
+        readonly tags?: readonly string[];
+        readonly kinds?: readonly AssetKind[];
+    };
+    /** Route the category to an external provider/theme instead of a local match. */
+    readonly provider?: {
+        readonly source: AssetSourceId;
+        readonly theme?: string;
+    };
+}
+//# sourceMappingURL=categories.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"categories.d.cts","sourceRoot":"","sources":["../../src/types/categories.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1D,MAAM,WAAW,gBAAgB;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,yDAAyD;IACzD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,oBAAoB;IACpC,oDAAoD;IACpD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,qEAAqE;IACrE,QAAQ,CAAC,SAAS,EAAE,QAAQ,GAAG,OAAO,CAAC;IACvC,8DAA8D;IAC9D,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;IAC9C,gEAAgE;IAChE,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IAC1E,mFAAmF;IACnF,QAAQ,CAAC,OAAO,CAAC,EACd,SAAS,gBAAgB,EAAE,GAC3B,CAAC,CAAC,GAAG,EAAE;QACP,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,CAAC;KAC/B,KAAK,OAAO,CAAC,SAAS,gBAAgB,EAAE,CAAC,CAAC,CAAC;IAC/C,kFAAkF;IAClF,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,qDAAqD;IACrD,QAAQ,CAAC,KAAK,CAAC,EAAE;QAChB,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;QAClC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,SAAS,EAAE,CAAC;KACtC,CAAC;IACF,iFAAiF;IACjF,QAAQ,CAAC,QAAQ,CAAC,EAAE;QACnB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;QAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;CACF"}

package/dist/types/categories.d.ts

@@ -0,0 +1,48 @@
+/**
+ * @file Extensible categorization / facet registry (PRD 0002 §3.5, §9.2).
+ *
+ * `kind`, `tags`, `folder`, and `source` are built-in facets registered by the
+ * plugin; hosts append {@link AssetFacetDefinition}s rather than reconfigure.
+ * {@link AssetCategory} is a host-friendly "saved view" sugar over filters and
+ * providers, surfaced as chips beside the kind chips.
+ */
+import type { AssetSourceId } from "./filter.js";
+import type { AssetKind, UploadResult } from "./types.js";
+export interface AssetFacetOption {
+    readonly value: string;
+    readonly label: string;
+    /** Populated by memoized facet counts when available. */
+    readonly count?: number;
+}
+export interface AssetFacetDefinition {
+    /** Stable key; used in `AssetFilter.facets[id]`. */
+    readonly id: string;
+    readonly label: string;
+    /** `"single"` renders as chips/radio; `"multi"` as a multiselect. */
+    readonly selection: "single" | "multi";
+    /** Which sources this facet applies to. `undefined` ⇒ all. */
+    readonly appliesTo?: readonly AssetSourceId[];
+    /** Derive the asset's value(s) for this facet (local, sync). */
+    readonly valueOf?: (asset: UploadResult) => readonly string[] | undefined;
+    /** Static options, or an async loader for remote facets (e.g. Unsplash topics). */
+    readonly options?: readonly AssetFacetOption[] | ((ctx: {
+        readonly source?: AssetSourceId;
+    }) => Promise<readonly AssetFacetOption[]>);
+    /** When true, the facet is delegated to the source instead of matched locally. */
+    readonly remote?: boolean;
+}
+export interface AssetCategory {
+    readonly id: string;
+    readonly label: string;
+    /** Local match composed with AND-semantic search. */
+    readonly match?: {
+        readonly tags?: readonly string[];
+        readonly kinds?: readonly AssetKind[];
+    };
+    /** Route the category to an external provider/theme instead of a local match. */
+    readonly provider?: {
+        readonly source: AssetSourceId;
+        readonly theme?: string;
+    };
+}
+//# sourceMappingURL=categories.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"categories.d.ts","sourceRoot":"","sources":["../../src/types/categories.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1D,MAAM,WAAW,gBAAgB;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,yDAAyD;IACzD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,oBAAoB;IACpC,oDAAoD;IACpD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,qEAAqE;IACrE,QAAQ,CAAC,SAAS,EAAE,QAAQ,GAAG,OAAO,CAAC;IACvC,8DAA8D;IAC9D,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;IAC9C,gEAAgE;IAChE,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IAC1E,mFAAmF;IACnF,QAAQ,CAAC,OAAO,CAAC,EACd,SAAS,gBAAgB,EAAE,GAC3B,CAAC,CAAC,GAAG,EAAE;QACP,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,CAAC;KAC/B,KAAK,OAAO,CAAC,SAAS,gBAAgB,EAAE,CAAC,CAAC,CAAC;IAC/C,kFAAkF;IAClF,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,qDAAqD;IACrD,QAAQ,CAAC,KAAK,CAAC,EAAE;QAChB,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;QAClC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,SAAS,EAAE,CAAC;KACtC,CAAC;IACF,iFAAiF;IACjF,QAAQ,CAAC,QAAQ,CAAC,EAAE;QACnB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;QAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;CACF"}

package/dist/types/categories.js

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

package/dist/types/data-source.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/data-source.d.cts

@@ -0,0 +1,59 @@
+/**
+ * @file The unified host-facing data plane (PRD 0002 §3.3, §3.6).
+ *
+ * `AssetDataSource` is the ONE optional object a host supplies to back the local
+ * library. Every method is optional and async-first; any method (resolved
+ * per-plane) the host omits is filled by the built-in in-memory default. Binary
+ * ingest is NOT here — it stays on the top-level `uploader` (`UploadAdapter`).
+ *
+ * The READ is unified: `list()` returns the folder's assets, its child folders,
+ * and its breadcrumb in one envelope — there is deliberately no `listFolders`.
+ * Folder *mutations* are a separate plane.
+ */
+import type { AssetSourceError } from "../utils/errors.js";
+import type { AssetFilter, AssetListPage } from "./filter.js";
+import type { AssetFolder, FolderId } from "./folders.js";
+import type { UploadResult } from "./types.js";
+/**
+ * Replacement payload for {@link AssetDataSource.replace}. Kept `File`-only for
+ * parity with core's `StudioAssetSource.replace` boundary; programmatic
+ * `UploadResult` replacement stays on the registry.
+ */
+export type ReplacePayload = File;
+/** Loading/mutation status surfaced through {@link AssetDataSource.subscribeStatus}. */
+export type AssetSourceStatus = {
+    readonly phase: "idle";
+} | {
+    readonly phase: "loading";
+} | {
+    readonly phase: "paginating";
+    readonly loaded: number;
+} | {
+    readonly phase: "mutating";
+    readonly op: "rename" | "remove" | "move" | "replace" | "createFolder" | "removeFolder" | "moveFolder";
+    readonly id: string;
+} | {
+    readonly phase: "error";
+    readonly error: AssetSourceError;
+};
+export interface AssetDataSource {
+    /**
+     * THE single read. Scoped by `query.folderId` (null=root, undefined=all),
+     * returns the folder's assets (paginated `items`), its child `folders`, and
+     * its `folderPath` breadcrumb in one envelope. No separate `listFolders`.
+     */
+    list?(query: AssetFilter, signal?: AbortSignal): Promise<AssetListPage>;
+    remove?(id: string, signal?: AbortSignal): Promise<void>;
+    replace?(id: string, payload: ReplacePayload, signal?: AbortSignal): Promise<UploadResult>;
+    rename?(id: string, name: string, signal?: AbortSignal): Promise<UploadResult>;
+    /** Move an asset into a folder. `null` ⇒ root. */
+    move?(id: string, folderId: FolderId | null, signal?: AbortSignal): Promise<void>;
+    createFolder?(parentId: FolderId | null, name: string, signal?: AbortSignal): Promise<AssetFolder>;
+    renameFolder?(id: FolderId, name: string, signal?: AbortSignal): Promise<AssetFolder>;
+    removeFolder?(id: FolderId, opts?: {
+        readonly cascade?: boolean;
+    }, signal?: AbortSignal): Promise<void>;
+    moveFolder?(id: FolderId, parentId: FolderId | null, signal?: AbortSignal): Promise<AssetFolder>;
+    subscribeStatus?(listener: (status: AssetSourceStatus) => void): () => void;
+}
+//# sourceMappingURL=data-source.d.cts.map

package/dist/types/data-source.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-source.d.cts","sourceRoot":"","sources":["../../src/types/data-source.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,IAAI,CAAC;AAElC,wFAAwF;AACxF,MAAM,MAAM,iBAAiB,GAC1B;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC1B;IAAE,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAA;CAAE,GAC7B;IAAE,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACzD;IACA,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,EAAE,EACR,QAAQ,GACR,QAAQ,GACR,MAAM,GACN,SAAS,GACT,cAAc,GACd,cAAc,GACd,YAAY,CAAC;IAChB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACnB,GACD;IAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAA;CAAE,CAAC;AAEjE,MAAM,WAAW,eAAe;IAE/B;;;;OAIG;IACH,IAAI,CAAC,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAGxE,MAAM,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzD,OAAO,CAAC,CACP,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,cAAc,EACvB,MAAM,CAAC,EAAE,WAAW,GAClB,OAAO,CAAC,YAAY,CAAC,CAAC;IACzB,MAAM,CAAC,CACN,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,WAAW,GAClB,OAAO,CAAC,YAAY,CAAC,CAAC;IACzB,kDAAkD;IAClD,IAAI,CAAC,CACJ,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,QAAQ,GAAG,IAAI,EACzB,MAAM,CAAC,EAAE,WAAW,GAClB,OAAO,CAAC,IAAI,CAAC,CAAC;IAGjB,YAAY,CAAC,CACZ,QAAQ,EAAE,QAAQ,GAAG,IAAI,EACzB,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,WAAW,GAClB,OAAO,CAAC,WAAW,CAAC,CAAC;IACxB,YAAY,CAAC,CACZ,EAAE,EAAE,QAAQ,EACZ,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,WAAW,GAClB,OAAO,CAAC,WAAW,CAAC,CAAC;IACxB,YAAY,CAAC,CACZ,EAAE,EAAE,QAAQ,EACZ,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,EACrC,MAAM,CAAC,EAAE,WAAW,GAClB,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,UAAU,CAAC,CACV,EAAE,EAAE,QAAQ,EACZ,QAAQ,EAAE,QAAQ,GAAG,IAAI,EACzB,MAAM,CAAC,EAAE,WAAW,GAClB,OAAO,CAAC,WAAW,CAAC,CAAC;IAGxB,eAAe,CAAC,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,iBAAiB,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CAC5E"}

package/dist/types/data-source.d.ts

@@ -0,0 +1,59 @@
+/**
+ * @file The unified host-facing data plane (PRD 0002 §3.3, §3.6).
+ *
+ * `AssetDataSource` is the ONE optional object a host supplies to back the local
+ * library. Every method is optional and async-first; any method (resolved
+ * per-plane) the host omits is filled by the built-in in-memory default. Binary
+ * ingest is NOT here — it stays on the top-level `uploader` (`UploadAdapter`).
+ *
+ * The READ is unified: `list()` returns the folder's assets, its child folders,
+ * and its breadcrumb in one envelope — there is deliberately no `listFolders`.
+ * Folder *mutations* are a separate plane.
+ */
+import type { AssetSourceError } from "../utils/errors.js";
+import type { AssetFilter, AssetListPage } from "./filter.js";
+import type { AssetFolder, FolderId } from "./folders.js";
+import type { UploadResult } from "./types.js";
+/**
+ * Replacement payload for {@link AssetDataSource.replace}. Kept `File`-only for
+ * parity with core's `StudioAssetSource.replace` boundary; programmatic
+ * `UploadResult` replacement stays on the registry.
+ */
+export type ReplacePayload = File;
+/** Loading/mutation status surfaced through {@link AssetDataSource.subscribeStatus}. */
+export type AssetSourceStatus = {
+    readonly phase: "idle";
+} | {
+    readonly phase: "loading";
+} | {
+    readonly phase: "paginating";
+    readonly loaded: number;
+} | {
+    readonly phase: "mutating";
+    readonly op: "rename" | "remove" | "move" | "replace" | "createFolder" | "removeFolder" | "moveFolder";
+    readonly id: string;
+} | {
+    readonly phase: "error";
+    readonly error: AssetSourceError;
+};
+export interface AssetDataSource {
+    /**
+     * THE single read. Scoped by `query.folderId` (null=root, undefined=all),
+     * returns the folder's assets (paginated `items`), its child `folders`, and
+     * its `folderPath` breadcrumb in one envelope. No separate `listFolders`.
+     */
+    list?(query: AssetFilter, signal?: AbortSignal): Promise<AssetListPage>;
+    remove?(id: string, signal?: AbortSignal): Promise<void>;
+    replace?(id: string, payload: ReplacePayload, signal?: AbortSignal): Promise<UploadResult>;
+    rename?(id: string, name: string, signal?: AbortSignal): Promise<UploadResult>;
+    /** Move an asset into a folder. `null` ⇒ root. */
+    move?(id: string, folderId: FolderId | null, signal?: AbortSignal): Promise<void>;
+    createFolder?(parentId: FolderId | null, name: string, signal?: AbortSignal): Promise<AssetFolder>;
+    renameFolder?(id: FolderId, name: string, signal?: AbortSignal): Promise<AssetFolder>;
+    removeFolder?(id: FolderId, opts?: {
+        readonly cascade?: boolean;
+    }, signal?: AbortSignal): Promise<void>;
+    moveFolder?(id: FolderId, parentId: FolderId | null, signal?: AbortSignal): Promise<AssetFolder>;
+    subscribeStatus?(listener: (status: AssetSourceStatus) => void): () => void;
+}
+//# sourceMappingURL=data-source.d.ts.map

package/dist/types/data-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-source.d.ts","sourceRoot":"","sources":["../../src/types/data-source.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,IAAI,CAAC;AAElC,wFAAwF;AACxF,MAAM,MAAM,iBAAiB,GAC1B;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC1B;IAAE,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAA;CAAE,GAC7B;IAAE,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACzD;IACA,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,EAAE,EACR,QAAQ,GACR,QAAQ,GACR,MAAM,GACN,SAAS,GACT,cAAc,GACd,cAAc,GACd,YAAY,CAAC;IAChB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACnB,GACD;IAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAA;CAAE,CAAC;AAEjE,MAAM,WAAW,eAAe;IAE/B;;;;OAIG;IACH,IAAI,CAAC,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAGxE,MAAM,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzD,OAAO,CAAC,CACP,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,cAAc,EACvB,MAAM,CAAC,EAAE,WAAW,GAClB,OAAO,CAAC,YAAY,CAAC,CAAC;IACzB,MAAM,CAAC,CACN,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,WAAW,GAClB,OAAO,CAAC,YAAY,CAAC,CAAC;IACzB,kDAAkD;IAClD,IAAI,CAAC,CACJ,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,QAAQ,GAAG,IAAI,EACzB,MAAM,CAAC,EAAE,WAAW,GAClB,OAAO,CAAC,IAAI,CAAC,CAAC;IAGjB,YAAY,CAAC,CACZ,QAAQ,EAAE,QAAQ,GAAG,IAAI,EACzB,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,WAAW,GAClB,OAAO,CAAC,WAAW,CAAC,CAAC;IACxB,YAAY,CAAC,CACZ,EAAE,EAAE,QAAQ,EACZ,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,WAAW,GAClB,OAAO,CAAC,WAAW,CAAC,CAAC;IACxB,YAAY,CAAC,CACZ,EAAE,EAAE,QAAQ,EACZ,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,EACrC,MAAM,CAAC,EAAE,WAAW,GAClB,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,UAAU,CAAC,CACV,EAAE,EAAE,QAAQ,EACZ,QAAQ,EAAE,QAAQ,GAAG,IAAI,EACzB,MAAM,CAAC,EAAE,WAAW,GAClB,OAAO,CAAC,WAAW,CAAC,CAAC;IAGxB,eAAe,CAAC,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,iBAAiB,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CAC5E"}

package/dist/types/data-source.js

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