@anvilkit/plugin-asset-manager 0.1.6 → 0.1.8

package/dist/sources/federated-search.cjs

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

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

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

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

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

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

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

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

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

package/dist/sources/federated-search.js

@@ -0,0 +1,123 @@
+import { inferAssetKind } from "../utils/infer-kind.js";
+function toBase64Url(json) {
+    return btoa(json).replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
+}
+function fromBase64Url(token) {
+    const padded = token.length % 4 === 0 ? token : token + "=".repeat(4 - token.length % 4);
+    return atob(padded.replace(/-/g, "+").replace(/_/g, "/"));
+}
+function encodeCompositeCursor(cursor) {
+    return toBase64Url(JSON.stringify(cursor));
+}
+function decodeCompositeCursor(token) {
+    if (void 0 === token || "" === token) return {};
+    try {
+        const parsed = JSON.parse(fromBase64Url(token));
+        return "object" == typeof parsed && null !== parsed ? parsed : {};
+    } catch  {
+        return {};
+    }
+}
+function providerCanSatisfy(provider, filter) {
+    if (void 0 !== filter.folderId && true !== provider.capabilities.folders) return false;
+    return true;
+}
+function createLocalProvider(source, registry, label = "assetManager.source.library") {
+    return {
+        id: "local",
+        label,
+        capabilities: {
+            searchable: true,
+            themed: false,
+            mutable: true,
+            requiresAttribution: false,
+            folders: true
+        },
+        listThemes: ()=>[],
+        search: (filter, page, signal)=>source.list(void 0 !== page ? {
+                ...filter,
+                cursor: page
+            } : filter, signal),
+        pickResult: async (asset)=>registry.get(asset.id) ?? {
+                id: asset.id,
+                url: asset.url
+            }
+    };
+}
+function sortKey(entry, field) {
+    switch(field){
+        case "name":
+            return (entry.name ?? "").toLowerCase();
+        case "size":
+            return entry.meta?.size ?? 0;
+        case "kind":
+            return inferAssetKind(entry);
+    }
+}
+function compareEntries(a, b, field) {
+    const ka = sortKey(a, field);
+    const kb = sortKey(b, field);
+    if ("number" == typeof ka && "number" == typeof kb) return ka - kb;
+    return String(ka).localeCompare(String(kb));
+}
+function mergePages(pages, filter, carryForward = {}) {
+    const field = filter.sort?.field ?? "recent";
+    const comparable = "name" === field || "size" === field || "kind" === field;
+    const items = pages.flatMap((p)=>[
+            ...p.page.items
+        ]);
+    if (comparable) {
+        const dir = filter.sort?.direction ?? ("name" === field ? "asc" : "desc");
+        const sign = "asc" === dir ? 1 : -1;
+        items.sort((a, b)=>compareEntries(a, b, field) * sign);
+    }
+    const total = pages.reduce((n, p)=>n + p.page.total, 0);
+    const sourceCursors = {
+        ...carryForward
+    };
+    const next = {
+        ...carryForward
+    };
+    let hasNext = Object.keys(carryForward).length > 0;
+    for (const { provider, page } of pages){
+        sourceCursors[provider.id] = page.nextCursor;
+        if (void 0 !== page.nextCursor) {
+            next[provider.id] = page.nextCursor;
+            hasNext = true;
+        }
+    }
+    return {
+        items: Object.freeze(items),
+        total,
+        nextCursor: hasNext ? encodeCompositeCursor(next) : void 0,
+        sourceCursors
+    };
+}
+async function federatedSearch(input) {
+    const { providers, filter, signal } = input;
+    const eligible = providers.filter((p)=>providerCanSatisfy(p, filter));
+    const targets = filter.sources && filter.sources.length > 0 ? eligible.filter((p)=>filter.sources?.includes(p.id)) : eligible;
+    if (0 === targets.length) return {
+        items: Object.freeze([]),
+        total: 0,
+        nextCursor: void 0
+    };
+    const cursors = decodeCompositeCursor(filter.cursor);
+    const settled = await Promise.allSettled(targets.map((p)=>p.search(filter, cursors[p.id], signal)));
+    const ok = [];
+    const carryForward = {};
+    settled.forEach((result, index)=>{
+        const provider = targets[index];
+        if (void 0 === provider) return;
+        if ("fulfilled" === result.status) ok.push({
+            provider,
+            page: result.value
+        });
+        else {
+            const incoming = cursors[provider.id];
+            if (void 0 !== incoming) carryForward[provider.id] = incoming;
+        }
+    });
+    return mergePages(ok, filter, carryForward);
+}
+export { createLocalProvider, decodeCompositeCursor, encodeCompositeCursor, federatedSearch, providerCanSatisfy };

package/dist/sources/provider.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/sources/provider.d.cts

@@ -0,0 +1,51 @@
+/**
+ * @file External read-only source provider contract (PRD 0002 §3.4, §8).
+ *
+ * Unsplash (and any host-defined stock source) implements this. All providers
+ * compose behind the single `StudioAssetSource` the plugin registers; the
+ * built-in `local` provider wraps the resolved `AssetDataSource`. These are
+ * types only — erased at runtime, zero bytes in any chunk.
+ */
+import type { StudioAsset } from "@anvilkit/core/types";
+import type { AssetFilter, AssetListPage, AssetSourceId } from "../types/filter.js";
+import type { UploadResult } from "../types/types.js";
+export interface AssetSourceCapabilities {
+    readonly searchable: boolean;
+    readonly themed: boolean;
+    /** Unsplash = false (browse + insert only). */
+    readonly mutable: boolean;
+    /** Unsplash = true. */
+    readonly requiresAttribution: boolean;
+    /**
+     * Supports folder scoping. Only the local library provider sets this; a
+     * folder-scoped query (`AssetFilter.folderId`) drops providers without it
+     * from the federation. Defaults to `false` when omitted.
+     */
+    readonly folders?: boolean;
+}
+export interface AssetTheme {
+    readonly id: string;
+    /** i18n message key (not inline copy). */
+    readonly label: string;
+    readonly description?: string;
+}
+export interface AssetSourceProvider {
+    /** `"unsplash"` | host id. The built-in `"local"` provider wraps the data source. */
+    readonly id: AssetSourceId;
+    readonly label: string;
+    readonly capabilities: AssetSourceCapabilities;
+    /** Content-Security-Policy hosts this provider needs (e.g. Unsplash img/connect src). */
+    readonly requiredCsp?: () => {
+        readonly connectSrc?: readonly string[];
+        readonly imgSrc?: readonly string[];
+    };
+    listThemes(): readonly AssetTheme[] | Promise<readonly AssetTheme[]>;
+    search(query: AssetFilter, page: string | undefined, signal?: AbortSignal): Promise<AssetListPage>;
+    /**
+     * Convert a browsed result into a real asset (fires the source's
+     * download-trigger / attribution work) and feed it into the existing
+     * registry → IR → `asset://` pipeline.
+     */
+    pickResult(asset: StudioAsset, signal?: AbortSignal): Promise<UploadResult>;
+}
+//# sourceMappingURL=provider.d.cts.map

package/dist/sources/provider.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.cts","sourceRoot":"","sources":["../../src/sources/provider.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD,OAAO,KAAK,EACX,WAAW,EACX,aAAa,EACb,aAAa,EACb,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,MAAM,WAAW,uBAAuB;IACvC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,+CAA+C;IAC/C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,uBAAuB;IACvB,QAAQ,CAAC,mBAAmB,EAAE,OAAO,CAAC;IACtC;;;;OAIG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,UAAU;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,mBAAmB;IACnC,qFAAqF;IACrF,QAAQ,CAAC,EAAE,EAAE,aAAa,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,YAAY,EAAE,uBAAuB,CAAC;IAC/C,yFAAyF;IACzF,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM;QAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;QACxC,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;KACpC,CAAC;IACF,UAAU,IAAI,SAAS,UAAU,EAAE,GAAG,OAAO,CAAC,SAAS,UAAU,EAAE,CAAC,CAAC;IACrE,MAAM,CACL,KAAK,EAAE,WAAW,EAClB,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,MAAM,CAAC,EAAE,WAAW,GAClB,OAAO,CAAC,aAAa,CAAC,CAAC;IAC1B;;;;OAIG;IACH,UAAU,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CAC5E"}

package/dist/sources/provider.d.ts

@@ -0,0 +1,51 @@
+/**
+ * @file External read-only source provider contract (PRD 0002 §3.4, §8).
+ *
+ * Unsplash (and any host-defined stock source) implements this. All providers
+ * compose behind the single `StudioAssetSource` the plugin registers; the
+ * built-in `local` provider wraps the resolved `AssetDataSource`. These are
+ * types only — erased at runtime, zero bytes in any chunk.
+ */
+import type { StudioAsset } from "@anvilkit/core/types";
+import type { AssetFilter, AssetListPage, AssetSourceId } from "../types/filter.js";
+import type { UploadResult } from "../types/types.js";
+export interface AssetSourceCapabilities {
+    readonly searchable: boolean;
+    readonly themed: boolean;
+    /** Unsplash = false (browse + insert only). */
+    readonly mutable: boolean;
+    /** Unsplash = true. */
+    readonly requiresAttribution: boolean;
+    /**
+     * Supports folder scoping. Only the local library provider sets this; a
+     * folder-scoped query (`AssetFilter.folderId`) drops providers without it
+     * from the federation. Defaults to `false` when omitted.
+     */
+    readonly folders?: boolean;
+}
+export interface AssetTheme {
+    readonly id: string;
+    /** i18n message key (not inline copy). */
+    readonly label: string;
+    readonly description?: string;
+}
+export interface AssetSourceProvider {
+    /** `"unsplash"` | host id. The built-in `"local"` provider wraps the data source. */
+    readonly id: AssetSourceId;
+    readonly label: string;
+    readonly capabilities: AssetSourceCapabilities;
+    /** Content-Security-Policy hosts this provider needs (e.g. Unsplash img/connect src). */
+    readonly requiredCsp?: () => {
+        readonly connectSrc?: readonly string[];
+        readonly imgSrc?: readonly string[];
+    };
+    listThemes(): readonly AssetTheme[] | Promise<readonly AssetTheme[]>;
+    search(query: AssetFilter, page: string | undefined, signal?: AbortSignal): Promise<AssetListPage>;
+    /**
+     * Convert a browsed result into a real asset (fires the source's
+     * download-trigger / attribution work) and feed it into the existing
+     * registry → IR → `asset://` pipeline.
+     */
+    pickResult(asset: StudioAsset, signal?: AbortSignal): Promise<UploadResult>;
+}
+//# sourceMappingURL=provider.d.ts.map

package/dist/sources/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/sources/provider.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD,OAAO,KAAK,EACX,WAAW,EACX,aAAa,EACb,aAAa,EACb,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,MAAM,WAAW,uBAAuB;IACvC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,+CAA+C;IAC/C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,uBAAuB;IACvB,QAAQ,CAAC,mBAAmB,EAAE,OAAO,CAAC;IACtC;;;;OAIG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,UAAU;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,mBAAmB;IACnC,qFAAqF;IACrF,QAAQ,CAAC,EAAE,EAAE,aAAa,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,YAAY,EAAE,uBAAuB,CAAC;IAC/C,yFAAyF;IACzF,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM;QAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;QACxC,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;KACpC,CAAC;IACF,UAAU,IAAI,SAAS,UAAU,EAAE,GAAG,OAAO,CAAC,SAAS,UAAU,EAAE,CAAC,CAAC;IACrE,MAAM,CACL,KAAK,EAAE,WAAW,EAClB,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,MAAM,CAAC,EAAE,WAAW,GAClB,OAAO,CAAC,aAAa,CAAC,CAAC;IAC1B;;;;OAIG;IACH,UAAU,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CAC5E"}

package/dist/sources/provider.js

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