@harborclient/core 0.1.1

package/dist/plugin/importHandlers.d.ts

@@ -0,0 +1,65 @@
+/**
+ * File selected through **File → Import** and forwarded to plugin import handlers.
+ *
+ * Mirrors {@link ImportFile} from `@harborclient/sdk` until HarborClient depends on
+ * a release that exports the symbol.
+ */
+export interface ImportFile {
+    /**
+     * Base file name including extension.
+     */
+    name: string;
+    /**
+     * Absolute path to the selected file.
+     */
+    path: string;
+    /**
+     * Normalized extension with a leading dot (for example `.json`).
+     */
+    extension: string;
+    /**
+     * Raw UTF-8 file contents.
+     */
+    contents: string;
+}
+/**
+ * Callbacks registered for one import format.
+ */
+export interface ImportHandler {
+    /**
+     * Returns whether this handler should process the file.
+     *
+     * @param file - Selected import file from the host.
+     */
+    canImport: (file: ImportFile) => boolean | Promise<boolean>;
+    /**
+     * Performs the import workflow for a matched file.
+     *
+     * @param file - Selected import file from the host.
+     */
+    import: (file: ImportFile) => void | Promise<void>;
+}
+/**
+ * **File → Import** handler registration on {@link PluginContext.imports}.
+ */
+export interface PluginImports {
+    /**
+     * Registers a handler for one or more file extensions.
+     *
+     * @param extensions - File extensions such as `.json` or `yaml`.
+     * @param handler - Import detection and execution callbacks.
+     */
+    registerHandler: (extensions: string | string[], handler: ImportHandler) => import('@harborclient/sdk').Disposable;
+}
+declare module '@harborclient/sdk' {
+    /**
+     * Renderer plugin API surface extended by HarborClient for import handlers.
+     */
+    interface PluginContext {
+        /**
+         * **File → Import** handler registration. Requires the `ui` permission.
+         */
+        imports: PluginImports;
+    }
+}
+//# sourceMappingURL=importHandlers.d.ts.map

package/dist/plugin/importHandlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"importHandlers.d.ts","sourceRoot":"","sources":["../../src/plugin/importHandlers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,SAAS,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE5D;;;;OAIG;IACH,MAAM,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpD;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;;OAKG;IACH,eAAe,EAAE,CACf,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,EAC7B,OAAO,EAAE,aAAa,KACnB,OAAO,mBAAmB,EAAE,UAAU,CAAC;CAC7C;AAED,OAAO,QAAQ,mBAAmB,CAAC;IACjC;;OAEG;IACH,UAAU,aAAa;QACrB;;WAEG;QACH,OAAO,EAAE,aAAa,CAAC;KACxB;CACF"}

package/dist/plugin/importHandlers.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=importHandlers.js.map

package/dist/plugin/importHandlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"importHandlers.js","sourceRoot":"","sources":["../../src/plugin/importHandlers.ts"],"names":[],"mappings":""}

package/dist/plugin/pluginDatabaseApi.d.ts

@@ -0,0 +1,39 @@
+import type { PluginDatabase } from './databaseTypes';
+/**
+ * Backend used to implement {@link PluginDatabase} in renderer or main plugin runtimes.
+ */
+export interface PluginDatabaseBackend {
+    /**
+     * Runs one query mode, optionally inside a transaction.
+     *
+     * @param mode - Query shape to execute.
+     * @param sql - Parameterized SQL statement.
+     * @param params - Bound parameter values.
+     * @param txnId - Active transaction id when applicable.
+     */
+    query(mode: 'get' | 'all' | 'run', sql: string, params?: unknown[], txnId?: string): Promise<unknown>;
+    /**
+     * Executes a multi-statement SQL script.
+     *
+     * @param sql - DDL or migration script.
+     */
+    exec(sql: string): Promise<void>;
+    /**
+     * Starts an exclusive transaction.
+     */
+    beginTransaction(): Promise<string>;
+    /**
+     * Commits or rolls back an open transaction.
+     *
+     * @param txnId - Transaction id from {@link beginTransaction}.
+     * @param action - Whether to commit or roll back.
+     */
+    endTransaction(txnId: string, action: 'commit' | 'rollback'): Promise<void>;
+}
+/**
+ * Builds the plugin database API surface from a runtime-specific backend.
+ *
+ * @param backend - IPC or child-process bridge implementing database operations.
+ */
+export declare function createPluginDatabaseApi(backend: PluginDatabaseBackend): PluginDatabase;
+//# sourceMappingURL=pluginDatabaseApi.d.ts.map

package/dist/plugin/pluginDatabaseApi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pluginDatabaseApi.d.ts","sourceRoot":"","sources":["../../src/plugin/pluginDatabaseApi.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAqC,MAAM,iBAAiB,CAAC;AAEzF;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;;;;OAOG;IACH,KAAK,CACH,IAAI,EAAE,KAAK,GAAG,KAAK,GAAG,KAAK,EAC3B,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,OAAO,EAAE,EAClB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,OAAO,CAAC,CAAC;IAEpB;;;;OAIG;IACH,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjC;;OAEG;IACH,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAEpC;;;;;OAKG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAG,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7E;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,qBAAqB,GAAG,cAAc,CAiDtF"}

package/dist/plugin/pluginDatabaseApi.js

@@ -0,0 +1,45 @@
+/**
+ * Builds the plugin database API surface from a runtime-specific backend.
+ *
+ * @param backend - IPC or child-process bridge implementing database operations.
+ */
+export function createPluginDatabaseApi(backend) {
+    /**
+     * Runs one query mode through the backend.
+     *
+     * @param mode - Query shape to execute.
+     * @param sql - Parameterized SQL statement.
+     * @param params - Bound parameter values.
+     * @param txnId - Active transaction id when applicable.
+     */
+    const query = (mode, sql, params, txnId) => backend.query(mode, sql, params, txnId);
+    /**
+     * Transaction-scoped helpers passed to {@link PluginDatabase.transaction}.
+     *
+     * @param txnId - Active transaction id.
+     */
+    const createTx = (txnId) => ({
+        get: async (sql, params) => (await query('get', sql, params, txnId)),
+        all: async (sql, params) => (await query('all', sql, params, txnId)),
+        run: async (sql, params) => (await query('run', sql, params, txnId))
+    });
+    return {
+        get: async (sql, params) => (await query('get', sql, params)),
+        all: async (sql, params) => (await query('all', sql, params)),
+        run: async (sql, params) => (await query('run', sql, params)),
+        exec: (sql) => backend.exec(sql),
+        transaction: async (fn) => {
+            const txnId = await backend.beginTransaction();
+            try {
+                const result = await fn(createTx(txnId));
+                await backend.endTransaction(txnId, 'commit');
+                return result;
+            }
+            catch (error) {
+                await backend.endTransaction(txnId, 'rollback');
+                throw error;
+            }
+        }
+    };
+}
+//# sourceMappingURL=pluginDatabaseApi.js.map

package/dist/plugin/pluginDatabaseApi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pluginDatabaseApi.js","sourceRoot":"","sources":["../../src/plugin/pluginDatabaseApi.ts"],"names":[],"mappings":"AA0CA;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAA8B;IACpE;;;;;;;OAOG;IACH,MAAM,KAAK,GAAG,CACZ,IAA2B,EAC3B,GAAW,EACX,MAAkB,EAClB,KAAc,EACI,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IAE/D;;;;OAIG;IACH,MAAM,QAAQ,GAAG,CAAC,KAAa,EAAoB,EAAE,CAAC,CAAC;QACrD,GAAG,EAAE,KAAK,EAAK,GAAW,EAAE,MAAkB,EAAE,EAAE,CAChD,CAAC,MAAM,KAAK,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,CAAkB;QAC3D,GAAG,EAAE,KAAK,EAAK,GAAW,EAAE,MAAkB,EAAE,EAAE,CAChD,CAAC,MAAM,KAAK,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,CAAQ;QACjD,GAAG,EAAE,KAAK,EAAE,GAAW,EAAE,MAAkB,EAAE,EAAE,CAC7C,CAAC,MAAM,KAAK,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,CAAoB;KAC9D,CAAC,CAAC;IAEH,OAAO;QACL,GAAG,EAAE,KAAK,EAAK,GAAW,EAAE,MAAkB,EAAE,EAAE,CAChD,CAAC,MAAM,KAAK,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,CAAC,CAAkB;QACpD,GAAG,EAAE,KAAK,EAAK,GAAW,EAAE,MAAkB,EAAE,EAAE,CAAC,CAAC,MAAM,KAAK,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,CAAC,CAAQ;QAC3F,GAAG,EAAE,KAAK,EAAE,GAAW,EAAE,MAAkB,EAAE,EAAE,CAC7C,CAAC,MAAM,KAAK,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,CAAC,CAAoB;QACtD,IAAI,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC;QACxC,WAAW,EAAE,KAAK,EAAK,EAAwC,EAAE,EAAE;YACjE,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,gBAAgB,EAAE,CAAC;YAC/C,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;gBACzC,MAAM,OAAO,CAAC,cAAc,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;gBAC9C,OAAO,MAAM,CAAC;YAChB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,OAAO,CAAC,cAAc,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;gBAChD,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/plugin/pluginSurface.d.ts

@@ -0,0 +1,20 @@
+/** Custom scheme used for isolated plugin webContents documents and assets. */
+export declare const HARBOR_PLUGIN_PROTOCOL = "harbor-plugin";
+/** Contribution buckets that render inside plugin surface webviews. */
+export type PluginContributionKind = 'settingsSections' | 'sidebarPanels' | 'sidebarSections' | 'mainViews' | 'requestTabs' | 'responseTabs' | 'collectionSettingsTabs' | 'footerPanels' | 'statusBarItems' | 'modals';
+/**
+ * Builds the harbor-plugin agent shell URL for one plugin.
+ *
+ * @param pluginId - Plugin manifest id.
+ */
+export declare function buildPluginAgentUrl(pluginId: string): string;
+/**
+ * Builds the harbor-plugin shell URL for one isolated plugin surface webview.
+ *
+ * @param pluginId - Plugin manifest id.
+ * @param contributionId - Manifest contribution id.
+ * @param kind - Contribution bucket key.
+ * @param slot - Optional sub-slot within the contribution.
+ */
+export declare function buildPluginSurfaceUrl(pluginId: string, contributionId: string, kind: PluginContributionKind, slot?: 'content' | 'headerActions'): string;
+//# sourceMappingURL=pluginSurface.d.ts.map

package/dist/plugin/pluginSurface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pluginSurface.d.ts","sourceRoot":"","sources":["../../src/plugin/pluginSurface.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,eAAO,MAAM,sBAAsB,kBAAkB,CAAC;AAEtD,uEAAuE;AACvE,MAAM,MAAM,sBAAsB,GAC9B,kBAAkB,GAClB,eAAe,GACf,iBAAiB,GACjB,WAAW,GACX,aAAa,GACb,cAAc,GACd,wBAAwB,GACxB,cAAc,GACd,gBAAgB,GAChB,QAAQ,CAAC;AAEb;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAG5D;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,MAAM,EACtB,IAAI,EAAE,sBAAsB,EAC5B,IAAI,GAAE,SAAS,GAAG,eAA2B,GAC5C,MAAM,CAUR"}

package/dist/plugin/pluginSurface.js

@@ -0,0 +1,31 @@
+/** Custom scheme used for isolated plugin webContents documents and assets. */
+export const HARBOR_PLUGIN_PROTOCOL = 'harbor-plugin';
+/**
+ * Builds the harbor-plugin agent shell URL for one plugin.
+ *
+ * @param pluginId - Plugin manifest id.
+ */
+export function buildPluginAgentUrl(pluginId) {
+    const params = new URLSearchParams({ role: 'agent' });
+    return `${HARBOR_PLUGIN_PROTOCOL}://${encodeURIComponent(pluginId)}/shell.html?${params.toString()}`;
+}
+/**
+ * Builds the harbor-plugin shell URL for one isolated plugin surface webview.
+ *
+ * @param pluginId - Plugin manifest id.
+ * @param contributionId - Manifest contribution id.
+ * @param kind - Contribution bucket key.
+ * @param slot - Optional sub-slot within the contribution.
+ */
+export function buildPluginSurfaceUrl(pluginId, contributionId, kind, slot = 'content') {
+    const params = new URLSearchParams({
+        role: 'view',
+        contrib: contributionId,
+        kind
+    });
+    if (slot !== 'content') {
+        params.set('slot', slot);
+    }
+    return `${HARBOR_PLUGIN_PROTOCOL}://${encodeURIComponent(pluginId)}/shell.html?${params.toString()}`;
+}
+//# sourceMappingURL=pluginSurface.js.map

package/dist/plugin/pluginSurface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pluginSurface.js","sourceRoot":"","sources":["../../src/plugin/pluginSurface.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,MAAM,CAAC,MAAM,sBAAsB,GAAG,eAAe,CAAC;AAetD;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,QAAgB;IAClD,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;IACtD,OAAO,GAAG,sBAAsB,MAAM,kBAAkB,CAAC,QAAQ,CAAC,eAAe,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC;AACvG,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,qBAAqB,CACnC,QAAgB,EAChB,cAAsB,EACtB,IAA4B,EAC5B,OAAoC,SAAS;IAE7C,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC;QACjC,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,cAAc;QACvB,IAAI;KACL,CAAC,CAAC;IACH,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC3B,CAAC;IACD,OAAO,GAAG,sBAAsB,MAAM,kBAAkB,CAAC,QAAQ,CAAC,eAAe,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC;AACvG,CAAC"}

package/dist/plugin/stripPluginScreenshotImagesFromMarkdown.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Removes markdown image syntax for plugin screenshots already shown in the detail carousel.
+ *
+ * @param markdown - Raw plugin README or description markdown.
+ * @param screenshotRefs - Manifest screenshot paths and/or resolved catalog URLs.
+ * @returns Markdown with redundant screenshot images removed.
+ */
+export declare function stripPluginScreenshotImagesFromMarkdown(markdown: string, screenshotRefs: string[]): string;
+//# sourceMappingURL=stripPluginScreenshotImagesFromMarkdown.d.ts.map

package/dist/plugin/stripPluginScreenshotImagesFromMarkdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stripPluginScreenshotImagesFromMarkdown.d.ts","sourceRoot":"","sources":["../../src/plugin/stripPluginScreenshotImagesFromMarkdown.ts"],"names":[],"mappings":"AAkJA;;;;;;GAMG;AACH,wBAAgB,uCAAuC,CACrD,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,MAAM,EAAE,GACvB,MAAM,CASR"}

package/dist/plugin/stripPluginScreenshotImagesFromMarkdown.js

@@ -0,0 +1,132 @@
+/**
+ * Normalizes a manifest path or absolute URL into comparable path segments.
+ *
+ * @param ref - Manifest screenshot path or resolved catalog URL.
+ */
+function normalizeScreenshotRef(ref) {
+    const trimmed = ref.trim();
+    try {
+        const url = new URL(trimmed);
+        const path = decodeURIComponent(url.pathname.replace(/^\/+/, ''));
+        const basename = path.split('/').pop() ?? path;
+        return { fullPath: path.toLowerCase(), basename: basename.toLowerCase() };
+    }
+    catch {
+        const path = decodeURIComponent(trimmed.replace(/^\.\//, '').replace(/^\/+/, ''));
+        const basename = path.split('/').pop() ?? path;
+        return { fullPath: path.toLowerCase(), basename: basename.toLowerCase() };
+    }
+}
+/**
+ * Builds lookup sets from manifest and catalog screenshot references.
+ *
+ * @param screenshotRefs - Manifest-relative paths and/or resolved catalog URLs.
+ */
+function buildScreenshotMatchers(screenshotRefs) {
+    const fullPaths = new Set();
+    const basenames = new Set();
+    for (const ref of screenshotRefs) {
+        const { fullPath, basename } = normalizeScreenshotRef(ref);
+        if (fullPath.length > 0) {
+            fullPaths.add(fullPath);
+        }
+        if (basename.length > 0) {
+            basenames.add(basename);
+        }
+    }
+    return { fullPaths, basenames };
+}
+/**
+ * Returns true when a markdown image target refers to a known plugin screenshot.
+ *
+ * @param target - URL or path from markdown image syntax.
+ * @param matchers - Normalized screenshot lookup sets.
+ */
+function isPluginScreenshotImageTarget(target, matchers) {
+    if (matchers.fullPaths.size === 0 && matchers.basenames.size === 0) {
+        return false;
+    }
+    const { fullPath, basename } = normalizeScreenshotRef(target);
+    if (fullPath.length > 0 && matchers.fullPaths.has(fullPath)) {
+        return true;
+    }
+    return basename.length > 0 && matchers.basenames.has(basename);
+}
+/** Inline markdown image: `![alt](path)` or `![alt](path "title")`. */
+const INLINE_IMAGE_PATTERN = /!\[[^\]]*\]\(\s*([^)\s]+)(?:\s+"[^"]*")?\s*\)/g;
+/** Reference-style image usage: `![alt][id]`. */
+const REFERENCE_IMAGE_USAGE_PATTERN = /!\[[^\]]*\]\[([^\]]+)\]/g;
+/** Reference definition line: `[id]: path`. */
+const REFERENCE_DEFINITION_PATTERN = /^\s*\[([^\]]+)\]:\s*(\S+)(?:\s+"[^"]*")?\s*$/gm;
+/**
+ * Removes inline markdown images whose targets match plugin screenshot refs.
+ *
+ * @param markdown - Description markdown body.
+ * @param matchers - Normalized screenshot lookup sets.
+ */
+function stripInlineScreenshotImages(markdown, matchers) {
+    return markdown.replace(INLINE_IMAGE_PATTERN, (match, target) => {
+        return isPluginScreenshotImageTarget(target, matchers) ? '' : match;
+    });
+}
+/**
+ * Removes reference-style markdown images and their link definitions for plugin screenshots.
+ *
+ * @param markdown - Description markdown body.
+ * @param matchers - Normalized screenshot lookup sets.
+ */
+function stripReferenceScreenshotImages(markdown, matchers) {
+    const screenshotReferenceIds = new Set();
+    for (const match of markdown.matchAll(REFERENCE_DEFINITION_PATTERN)) {
+        const id = match[1];
+        const target = match[2];
+        if (id && target && isPluginScreenshotImageTarget(target, matchers)) {
+            screenshotReferenceIds.add(id.toLowerCase());
+        }
+    }
+    if (screenshotReferenceIds.size === 0) {
+        return markdown;
+    }
+    let result = markdown.replace(REFERENCE_DEFINITION_PATTERN, (line, id, target) => {
+        if (screenshotReferenceIds.has(id.toLowerCase())) {
+            return '';
+        }
+        if (isPluginScreenshotImageTarget(target, matchers)) {
+            return '';
+        }
+        return line;
+    });
+    result = result.replace(REFERENCE_IMAGE_USAGE_PATTERN, (match, id) => {
+        return screenshotReferenceIds.has(id.toLowerCase()) ? '' : match;
+    });
+    return result;
+}
+/**
+ * Trims trailing whitespace per line and collapses excessive blank lines.
+ *
+ * @param markdown - Markdown after image removal.
+ */
+function cleanupMarkdownWhitespace(markdown) {
+    const trimmedLines = markdown
+        .split('\n')
+        .map((line) => line.replace(/\s+$/, ''))
+        .join('\n');
+    return trimmedLines.replace(/\n{3,}/g, '\n\n').trim();
+}
+/**
+ * Removes markdown image syntax for plugin screenshots already shown in the detail carousel.
+ *
+ * @param markdown - Raw plugin README or description markdown.
+ * @param screenshotRefs - Manifest screenshot paths and/or resolved catalog URLs.
+ * @returns Markdown with redundant screenshot images removed.
+ */
+export function stripPluginScreenshotImagesFromMarkdown(markdown, screenshotRefs) {
+    if (!markdown.trim() || screenshotRefs.length === 0) {
+        return markdown.trim();
+    }
+    const matchers = buildScreenshotMatchers(screenshotRefs);
+    let result = stripReferenceScreenshotImages(markdown, matchers);
+    result = stripInlineScreenshotImages(result, matchers);
+    return cleanupMarkdownWhitespace(result);
+}
+//# sourceMappingURL=stripPluginScreenshotImagesFromMarkdown.js.map

package/dist/plugin/stripPluginScreenshotImagesFromMarkdown.js.map

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

package/dist/plugin/themeCategory.d.ts

@@ -0,0 +1,62 @@
+import type { PluginCatalogEntry } from './catalog';
+import type { PluginInfo } from './types';
+/**
+ * Marketplace/manifest category slug that marks a plugin as a theme.
+ */
+export declare const THEME_CATEGORY: "themes";
+/**
+ * Returns a theme plugin name for UI display, omitting the redundant " Theme"
+ * suffix used in marketplace manifests.
+ *
+ * @param name - Raw plugin or catalog name from a theme manifest.
+ * @returns Display name without a trailing " Theme" suffix when present.
+ */
+export declare function formatThemeDisplayName(name: string): string;
+/**
+ * Marketplace category slugs that describe a theme's light, dark, or high-contrast appearance.
+ */
+export declare const THEME_APPEARANCE_CATEGORIES: readonly ["light", "dark", "high-contrast"];
+/**
+ * One allowed theme appearance category slug.
+ */
+export type ThemeAppearanceCategory = (typeof THEME_APPEARANCE_CATEGORIES)[number];
+/**
+ * Returns whether a string is a recognized theme appearance category slug.
+ *
+ * @param value - Raw category string from a catalog entry or manifest.
+ * @returns True when the value is a predefined theme appearance slug.
+ */
+export declare function isThemeAppearanceCategory(value: string): value is ThemeAppearanceCategory;
+/**
+ * Returns whether a marketplace catalog entry is a theme plugin.
+ *
+ * @param entry - Catalog listing to classify.
+ * @returns True when the entry includes the themes category slug.
+ */
+export declare function catalogEntryIsTheme(entry: PluginCatalogEntry): boolean;
+/**
+ * Returns whether an installed plugin is a theme based on its manifest categories.
+ *
+ * @param plugin - Installed plugin metadata row.
+ * @returns True when the manifest lists the themes category slug.
+ */
+export declare function pluginIsTheme(plugin: PluginInfo): boolean;
+/**
+ * Returns theme appearance types declared on a marketplace catalog entry.
+ *
+ * Reads `contributes.themes[].type` emitted from each plugin manifest at catalog
+ * build time. Unrecognized values are dropped; duplicates are removed.
+ *
+ * @param entry - Marketplace catalog row for a theme plugin.
+ * @returns Distinct light, dark, or high-contrast type slugs from theme contributions.
+ */
+export declare function getCatalogEntryThemeTypes(entry: PluginCatalogEntry): ThemeAppearanceCategory[];
+/**
+ * Filters theme catalog entries to those whose contributed theme type matches.
+ *
+ * @param plugins - Theme catalog rows in display order.
+ * @param appearance - Selected appearance slug, or empty string to return all themes.
+ * @returns Themes with a matching `contributes.themes[].type`, or the original list when unset.
+ */
+export declare function filterThemeCatalogByAppearance(plugins: PluginCatalogEntry[], appearance: ThemeAppearanceCategory | ''): PluginCatalogEntry[];
+//# sourceMappingURL=themeCategory.d.ts.map

package/dist/plugin/themeCategory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"themeCategory.d.ts","sourceRoot":"","sources":["../../src/plugin/themeCategory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C;;GAEG;AACH,eAAO,MAAM,cAAc,EAAG,QAAiB,CAAC;AAIhD;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAI3D;AAED;;GAEG;AACH,eAAO,MAAM,2BAA2B,6CAA8C,CAAC;AAEvF;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,CAAC,OAAO,2BAA2B,CAAC,CAAC,MAAM,CAAC,CAAC;AAInF;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,uBAAuB,CAEzF;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAEtE;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAEzD;AAED;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,kBAAkB,GAAG,uBAAuB,EAAE,CAa9F;AAED;;;;;;GAMG;AACH,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,kBAAkB,EAAE,EAC7B,UAAU,EAAE,uBAAuB,GAAG,EAAE,GACvC,kBAAkB,EAAE,CAMtB"}

package/dist/plugin/themeCategory.js

@@ -0,0 +1,84 @@
+/**
+ * Marketplace/manifest category slug that marks a plugin as a theme.
+ */
+export const THEME_CATEGORY = 'themes';
+const THEME_DISPLAY_NAME_SUFFIX = ' Theme';
+/**
+ * Returns a theme plugin name for UI display, omitting the redundant " Theme"
+ * suffix used in marketplace manifests.
+ *
+ * @param name - Raw plugin or catalog name from a theme manifest.
+ * @returns Display name without a trailing " Theme" suffix when present.
+ */
+export function formatThemeDisplayName(name) {
+    return name.endsWith(THEME_DISPLAY_NAME_SUFFIX)
+        ? name.slice(0, -THEME_DISPLAY_NAME_SUFFIX.length)
+        : name;
+}
+/**
+ * Marketplace category slugs that describe a theme's light, dark, or high-contrast appearance.
+ */
+export const THEME_APPEARANCE_CATEGORIES = ['light', 'dark', 'high-contrast'];
+const themeAppearanceCategorySet = new Set(THEME_APPEARANCE_CATEGORIES);
+/**
+ * Returns whether a string is a recognized theme appearance category slug.
+ *
+ * @param value - Raw category string from a catalog entry or manifest.
+ * @returns True when the value is a predefined theme appearance slug.
+ */
+export function isThemeAppearanceCategory(value) {
+    return themeAppearanceCategorySet.has(value);
+}
+/**
+ * Returns whether a marketplace catalog entry is a theme plugin.
+ *
+ * @param entry - Catalog listing to classify.
+ * @returns True when the entry includes the themes category slug.
+ */
+export function catalogEntryIsTheme(entry) {
+    return entry.categories.includes(THEME_CATEGORY);
+}
+/**
+ * Returns whether an installed plugin is a theme based on its manifest categories.
+ *
+ * @param plugin - Installed plugin metadata row.
+ * @returns True when the manifest lists the themes category slug.
+ */
+export function pluginIsTheme(plugin) {
+    return plugin.manifest.categories?.includes(THEME_CATEGORY) ?? false;
+}
+/**
+ * Returns theme appearance types declared on a marketplace catalog entry.
+ *
+ * Reads `contributes.themes[].type` emitted from each plugin manifest at catalog
+ * build time. Unrecognized values are dropped; duplicates are removed.
+ *
+ * @param entry - Marketplace catalog row for a theme plugin.
+ * @returns Distinct light, dark, or high-contrast type slugs from theme contributions.
+ */
+export function getCatalogEntryThemeTypes(entry) {
+    const types = [];
+    const seen = new Set();
+    for (const theme of entry.contributes?.themes ?? []) {
+        if (!isThemeAppearanceCategory(theme.type) || seen.has(theme.type)) {
+            continue;
+        }
+        seen.add(theme.type);
+        types.push(theme.type);
+    }
+    return types;
+}
+/**
+ * Filters theme catalog entries to those whose contributed theme type matches.
+ *
+ * @param plugins - Theme catalog rows in display order.
+ * @param appearance - Selected appearance slug, or empty string to return all themes.
+ * @returns Themes with a matching `contributes.themes[].type`, or the original list when unset.
+ */
+export function filterThemeCatalogByAppearance(plugins, appearance) {
+    if (!appearance) {
+        return plugins;
+    }
+    return plugins.filter((entry) => getCatalogEntryThemeTypes(entry).includes(appearance));
+}
+//# sourceMappingURL=themeCategory.js.map

package/dist/plugin/themeCategory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"themeCategory.js","sourceRoot":"","sources":["../../src/plugin/themeCategory.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,QAAiB,CAAC;AAEhD,MAAM,yBAAyB,GAAG,QAAQ,CAAC;AAE3C;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAY;IACjD,OAAO,IAAI,CAAC,QAAQ,CAAC,yBAAyB,CAAC;QAC7C,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,yBAAyB,CAAC,MAAM,CAAC;QAClD,CAAC,CAAC,IAAI,CAAC;AACX,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,eAAe,CAAU,CAAC;AAOvF,MAAM,0BAA0B,GAAG,IAAI,GAAG,CAAS,2BAA2B,CAAC,CAAC;AAEhF;;;;;GAKG;AACH,MAAM,UAAU,yBAAyB,CAAC,KAAa;IACrD,OAAO,0BAA0B,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AAC/C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAyB;IAC3D,OAAO,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;AACnD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,MAAkB;IAC9C,OAAO,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,cAAc,CAAC,IAAI,KAAK,CAAC;AACvE,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,yBAAyB,CAAC,KAAyB;IACjE,MAAM,KAAK,GAA8B,EAAE,CAAC;IAC5C,MAAM,IAAI,GAAG,IAAI,GAAG,EAA2B,CAAC;IAEhD,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,WAAW,EAAE,MAAM,IAAI,EAAE,EAAE,CAAC;QACpD,IAAI,CAAC,yBAAyB,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACnE,SAAS;QACX,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACrB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,8BAA8B,CAC5C,OAA6B,EAC7B,UAAwC;IAExC,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,yBAAyB,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC;AAC1F,CAAC"}