@harborclient/sdk 0.6.15 → 0.6.17

package/dist/build/index.d.ts

@@ -0,0 +1,59 @@
+import type { BuildOptions, Plugin } from 'esbuild';
+/**
+ * Which JSX runtime alias (if any) the renderer bundle should use.
+ *
+ * - `host` — bind `react/jsx-runtime` to `@harborclient/sdk/jsx-runtime-host` for
+ *   bundled third-party React libraries that import jsx-runtime at module load.
+ * - `runtime` — route through the SDK runtime shims that forward to `hc.react`.
+ * - `automatic` — automatic JSX with `@harborclient/sdk` import source, no alias.
+ * - `none` — no JSX options (theme plugins that only register colors).
+ */
+export type JsxRuntimeMode = 'host' | 'runtime' | 'automatic' | 'none';
+/**
+ * Options for {@link buildRenderer}.
+ */
+export interface BuildRendererOptions {
+    /** Renderer entry file. Defaults to `src/renderer.tsx`. */
+    entry?: string;
+    /** Output bundle path. Defaults to `dist/renderer.js`. */
+    outfile?: string;
+    /** When true, watch for changes instead of a one-shot build. */
+    watch?: boolean;
+    /** JSX runtime wiring for the bundle. Defaults to `runtime`. */
+    jsxRuntime?: JsxRuntimeMode;
+    /** Modules left external (provided by the HarborClient host). */
+    external?: string[];
+    /** esbuild `define` replacements merged into the build. */
+    define?: Record<string, string>;
+    /** Extra esbuild plugins appended after built-in plugins. */
+    plugins?: Plugin[];
+    /**
+     * When set, alias `react` to this path instead of externalizing it (e.g. aws-sigv
+     * proxy shim). Implies `external: []` unless `external` is explicitly provided.
+     */
+    aliasReactTo?: string;
+    /** esbuild log level. Defaults to `info`. */
+    logLevel?: BuildOptions['logLevel'];
+    /**
+     * Files to copy after a successful build, e.g. theme stylesheets.
+     * Each pair is `[source, destination]`.
+     */
+    copy?: ReadonlyArray<readonly [string, string]>;
+}
+/**
+ * Bundles a HarborClient plugin renderer entry with canonical esbuild options.
+ *
+ * @param options - Build configuration.
+ */
+export declare function buildRenderer(options?: BuildRendererOptions): Promise<void>;
+/**
+ * esbuild plugin that stubs Node built-in modules with empty exports.
+ *
+ * Use when a dependency imports Node modules that are unused at runtime in the
+ * renderer (e.g. `dotenv` importing `fs`/`path`).
+ *
+ * @param moduleNames - Built-in module names to stub (e.g. `path`, `fs`).
+ * @returns esbuild plugin.
+ */
+export declare function nodeBuiltinStubsPlugin(moduleNames: readonly string[]): Plugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/build/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/build/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEpD;;;;;;;;GAQG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,SAAS,GAAG,WAAW,GAAG,MAAM,CAAC;AAEvE;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,gEAAgE;IAChE,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,iEAAiE;IACjE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,YAAY,CAAC,UAAU,CAAC,CAAC;IACpC;;;OAGG;IACH,IAAI,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACjD;AAwCD;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqDrF;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAiB7E"}

package/dist/build/index.js

@@ -0,0 +1,107 @@
+import { cpSync, mkdirSync } from 'node:fs';
+import { dirname } from 'node:path';
+import * as esbuild from 'esbuild';
+const JSX_RUNTIME_HOST = '@harborclient/sdk/jsx-runtime-host';
+const JSX_RUNTIME = '@harborclient/sdk/jsx-runtime';
+const JSX_DEV_RUNTIME = '@harborclient/sdk/jsx-dev-runtime';
+/**
+ * Builds the jsx-runtime alias map for the given mode.
+ *
+ * @param mode - JSX runtime wiring mode.
+ * @returns Alias entries to merge into esbuild options, or undefined when none apply.
+ */
+function jsxRuntimeAliases(mode) {
+    if (mode === 'host') {
+        return {
+            'react/jsx-runtime': JSX_RUNTIME_HOST,
+            'react/jsx-dev-runtime': JSX_RUNTIME_HOST
+        };
+    }
+    if (mode === 'runtime') {
+        return {
+            'react/jsx-runtime': JSX_RUNTIME,
+            'react/jsx-dev-runtime': JSX_DEV_RUNTIME
+        };
+    }
+    return undefined;
+}
+/**
+ * Copies asset files after a successful renderer build.
+ *
+ * @param pairs - Source/destination path pairs.
+ */
+function copyAssets(pairs) {
+    for (const [source, destination] of pairs) {
+        mkdirSync(dirname(destination), { recursive: true });
+        cpSync(source, destination);
+    }
+}
+/**
+ * Bundles a HarborClient plugin renderer entry with canonical esbuild options.
+ *
+ * @param options - Build configuration.
+ */
+export async function buildRenderer(options = {}) {
+    const { entry = 'src/renderer.tsx', outfile = 'dist/renderer.js', watch = false, jsxRuntime = 'runtime', define, plugins = [], aliasReactTo, logLevel = 'info', copy = [] } = options;
+    const external = options.external ?? (aliasReactTo ? [] : ['react', 'react-dom']);
+    const alias = {
+        ...jsxRuntimeAliases(jsxRuntime),
+        ...(aliasReactTo ? { react: aliasReactTo } : {})
+    };
+    const shared = {
+        entryPoints: [entry],
+        outfile,
+        bundle: true,
+        format: 'esm',
+        platform: 'browser',
+        logLevel,
+        external,
+        define,
+        plugins,
+        ...(Object.keys(alias).length > 0 ? { alias } : {}),
+        ...(jsxRuntime === 'none'
+            ? {}
+            : {
+                jsx: 'automatic',
+                jsxImportSource: '@harborclient/sdk'
+            })
+    };
+    if (watch) {
+        const context = await esbuild.context(shared);
+        await context.watch();
+        console.log('Watching for changes…');
+        return;
+    }
+    const context = await esbuild.context(shared);
+    await context.rebuild();
+    await context.dispose();
+    if (copy.length > 0) {
+        copyAssets(copy);
+    }
+}
+/**
+ * esbuild plugin that stubs Node built-in modules with empty exports.
+ *
+ * Use when a dependency imports Node modules that are unused at runtime in the
+ * renderer (e.g. `dotenv` importing `fs`/`path`).
+ *
+ * @param moduleNames - Built-in module names to stub (e.g. `path`, `fs`).
+ * @returns esbuild plugin.
+ */
+export function nodeBuiltinStubsPlugin(moduleNames) {
+    return {
+        name: 'node-builtins-stub',
+        setup(build) {
+            for (const moduleName of moduleNames) {
+                build.onResolve({ filter: new RegExp(`^${moduleName}$`) }, () => ({
+                    path: moduleName,
+                    namespace: 'node-stub'
+                }));
+            }
+            build.onLoad({ filter: /.*/, namespace: 'node-stub' }, () => ({
+                contents: 'export default {};',
+                loader: 'js'
+            }));
+        }
+    };
+}

package/dist/components/index.d.ts

@@ -24,6 +24,7 @@ export type { Props as KeyValueEditorProps } from './KeyValueEditor/index.js';
 export { MethodSelect } from './MethodSelect/index.js';
 export { Modal, ModalFooter, ModalFormLayout } from './Modal/index.js';
 export { ModalHeader } from './Modal/ModalHeader.js';
+export { portalToBody } from './portalToBody.js';
 export { OverlayCloseButton } from './OverlayCloseButton/index.js';
 export { Page } from './Page/index.js';
 export { PageHeader } from './PageHeader/index.js';

package/dist/components/index.d.ts.map

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

package/dist/components/index.js

@@ -17,6 +17,7 @@ export { KeyValueEditor } from './KeyValueEditor/index.js';
 export { MethodSelect } from './MethodSelect/index.js';
 export { Modal, ModalFooter, ModalFormLayout } from './Modal/index.js';
 export { ModalHeader } from './Modal/ModalHeader.js';
+export { portalToBody } from './portalToBody.js';
 export { OverlayCloseButton } from './OverlayCloseButton/index.js';
 export { Page } from './Page/index.js';
 export { PageHeader } from './PageHeader/index.js';

package/dist/components/portalToBody.d.ts

@@ -0,0 +1,10 @@
+import type { ReactNode, ReactPortal } from 'react';
+/**
+ * Portals modal content to document.body so fixed positioning is not clipped by
+ * the sidebar or other overflow-hidden plugin webview containers.
+ *
+ * @param node - Modal element to render.
+ * @returns Portal into document.body, or the node unchanged when document is unavailable.
+ */
+export declare function portalToBody(node: ReactNode): ReactPortal;
+//# sourceMappingURL=portalToBody.d.ts.map

package/dist/components/portalToBody.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"portalToBody.d.ts","sourceRoot":"","sources":["../../src/components/portalToBody.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAEpD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,GAAG,WAAW,CAKzD"}

package/dist/components/portalToBody.js

@@ -0,0 +1,14 @@
+import { createPortal } from '@harborclient/sdk/react-dom';
+/**
+ * Portals modal content to document.body so fixed positioning is not clipped by
+ * the sidebar or other overflow-hidden plugin webview containers.
+ *
+ * @param node - Modal element to render.
+ * @returns Portal into document.body, or the node unchanged when document is unavailable.
+ */
+export function portalToBody(node) {
+    if (typeof document !== 'undefined') {
+        return createPortal(node, document.body);
+    }
+    return node;
+}

package/dist/eslint/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Shared flat ESLint config for HarborClient plugins (ESLint 10 compatible).
+ *
+ * Plugins re-export this from `eslint.config.mjs`:
+ * `export { default } from '@harborclient/sdk/eslint';`
+ */
+declare const _default: import("typescript-eslint").FlatConfig.ConfigArray;
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/dist/eslint/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/eslint/index.ts"],"names":[],"mappings":"AAKA;;;;;GAKG;;AACH,wBAaE"}

package/dist/eslint/index.js

@@ -0,0 +1,18 @@
+import eslint from '@eslint/js';
+import eslintConfigPrettier from 'eslint-config-prettier';
+import globals from 'globals';
+import tseslint from 'typescript-eslint';
+/**
+ * Shared flat ESLint config for HarborClient plugins (ESLint 10 compatible).
+ *
+ * Plugins re-export this from `eslint.config.mjs`:
+ * `export { default } from '@harborclient/sdk/eslint';`
+ */
+export default tseslint.config({
+    ignores: ['**/node_modules', '**/dist', 'pnpm-lock.yaml']
+}, eslint.configs.recommended, tseslint.configs.recommended, {
+    files: ['**/*.mjs'],
+    languageOptions: {
+        globals: globals.node
+    }
+}, eslintConfigPrettier);

package/dist/http/resolveRequest.test.js

@@ -30,7 +30,8 @@ describe('resolveRequest', () => {
                 bearer: { token: '{{token}}' }
             },
             collectionHeaders: [{ key: 'Accept', value: 'application/json', enabled: true }],
-            variables: { base: 'https://api.test', token: 'secret' }
+            variables: { base: 'https://api.test', token: 'secret' },
+            requestKey: 'POST https://api.test/users'
         };
         const resolved = resolveRequest(context);
         expect(resolved.url).toBe('https://api.test/users?page=1');

package/dist/pluginDatabaseApi.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=pluginDatabaseApi.test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pluginDatabaseApi.test.d.ts","sourceRoot":"","sources":["../src/pluginDatabaseApi.test.ts"],"names":[],"mappings":""}

package/dist/pluginDatabaseApi.test.js

@@ -0,0 +1,65 @@
+import { describe, expect, it, jest } from '@jest/globals';
+import { createPluginDatabaseApi } from './runtime/pluginDatabaseApi.js';
+/**
+ * Builds a mock database backend for unit tests.
+ */
+function createMockBackend() {
+    return {
+        query: jest.fn(async () => undefined),
+        exec: jest.fn(async () => undefined),
+        beginTransaction: jest.fn(async () => 'txn-1'),
+        endTransaction: jest.fn(async () => undefined)
+    };
+}
+describe('createPluginDatabaseApi', () => {
+    it('forwards get, all, and run with the correct query modes', async () => {
+        const backend = createMockBackend();
+        backend.query
+            .mockResolvedValueOnce({ id: 1 })
+            .mockResolvedValueOnce([{ id: 1 }, { id: 2 }])
+            .mockResolvedValueOnce({ changes: 1, lastInsertRowid: 42 });
+        const db = createPluginDatabaseApi(backend);
+        await expect(db.get('SELECT 1', [1])).resolves.toEqual({ id: 1 });
+        await expect(db.all('SELECT *', [2])).resolves.toEqual([{ id: 1 }, { id: 2 }]);
+        await expect(db.run('INSERT INTO t VALUES (?)', [3])).resolves.toEqual({
+            changes: 1,
+            lastInsertRowid: 42
+        });
+        expect(backend.query).toHaveBeenNthCalledWith(1, 'get', 'SELECT 1', [1], undefined);
+        expect(backend.query).toHaveBeenNthCalledWith(2, 'all', 'SELECT *', [2], undefined);
+        expect(backend.query).toHaveBeenNthCalledWith(3, 'run', 'INSERT INTO t VALUES (?)', [3], undefined);
+    });
+    it('forwards exec unchanged', async () => {
+        const backend = createMockBackend();
+        const db = createPluginDatabaseApi(backend);
+        await db.exec('CREATE TABLE t (id INTEGER)');
+        expect(backend.exec).toHaveBeenCalledWith('CREATE TABLE t (id INTEGER)');
+    });
+    it('commits successful transactions and passes txnId to tx helpers', async () => {
+        const backend = createMockBackend();
+        backend.query.mockResolvedValue({ changes: 1, lastInsertRowid: 1 });
+        const db = createPluginDatabaseApi(backend);
+        const result = await db.transaction(async (tx) => {
+            await tx.run('INSERT INTO t VALUES (?)', [1]);
+            await tx.all('SELECT * FROM t');
+            return 'done';
+        });
+        expect(result).toBe('done');
+        expect(backend.beginTransaction).toHaveBeenCalledTimes(1);
+        expect(backend.endTransaction).toHaveBeenCalledWith('txn-1', 'commit');
+        expect(backend.query).toHaveBeenCalledWith('run', 'INSERT INTO t VALUES (?)', [1], 'txn-1');
+        expect(backend.query).toHaveBeenCalledWith('all', 'SELECT * FROM t', undefined, 'txn-1');
+    });
+    it('rolls back failed transactions', async () => {
+        const backend = createMockBackend();
+        const db = createPluginDatabaseApi(backend);
+        const boom = new Error('boom');
+        await expect(db.transaction(async (tx) => {
+            await tx.run('INSERT INTO t VALUES (?)', [1]);
+            throw boom;
+        })).rejects.toThrow(boom);
+        expect(backend.beginTransaction).toHaveBeenCalledTimes(1);
+        expect(backend.endTransaction).toHaveBeenCalledWith('txn-1', 'rollback');
+        expect(backend.endTransaction).not.toHaveBeenCalledWith('txn-1', 'commit');
+    });
+});

package/dist/runtime/createBridgedPluginContext.js

@@ -7,6 +7,7 @@ import {
   registerContributionHeaderActions,
   registerContributionIndicator
 } from './contributionRegistry.js';
+import { createPluginDatabaseApi } from './pluginDatabaseApi.js';
 import { setHostReact } from './reactHost.js';
 
 /** @type {Map<string, Set<(...args: unknown[]) => void | Promise<void>>>} */
@@ -197,7 +198,7 @@ export function createBridgedPluginContext({ pluginId, mode, contributionId, rea
         await bridgeInvoke('storage.set', { key, value });
       }
     },
-    database: {
+    database: createPluginDatabaseApi({
       query: (mode, sql, params, txnId) => {
         assertPermission('database');
         return bridgeInvoke('database.query', { mode, sql, params, txnId });
@@ -214,7 +215,7 @@ export function createBridgedPluginContext({ pluginId, mode, contributionId, rea
         assertPermission('database');
         return bridgeInvoke('database.endTransaction', { txnId, action });
       }
-    },
+    }),
     fs: {
       pickFile: async (options) => {
         assertPermission('filesystem:pick');
@@ -691,7 +692,7 @@ export function mountContributionView({
     'mainViews'
   ]);
 
-  if (FILL_SURFACE_KINDS.has(kind)) {
+  if (FILL_SURFACE_KINDS.has(kind) && slot === 'content') {
     document.body.classList.add('plugin-surface-fill');
   }
 
@@ -704,6 +705,15 @@ export function mountContributionView({
     root.style.overflow = 'hidden';
   }
 
+  if (slot === 'indicator') {
+    document.body.classList.add('plugin-surface-indicator');
+    document.documentElement.classList.add('plugin-surface-indicator');
+    root.style.display = 'inline-flex';
+    root.style.width = 'fit-content';
+    root.style.maxWidth = '100%';
+    root.style.overflow = 'hidden';
+  }
+
   /** @type {ResizeObserver | null} */
   let resizeObserver = null;
   /** @type {number | null} */
@@ -827,6 +837,60 @@ export function mountContributionView({
     };
   }
 
+  if (slot === 'indicator') {
+    /**
+     * Reports footer panel indicator size so the host webview stays compact inline.
+     */
+    const reportIndicatorSize = () => {
+      const measureTarget = root.firstElementChild ?? root;
+      const width = Math.ceil(
+        Math.max(
+          measureTarget.scrollWidth,
+          measureTarget.getBoundingClientRect().width,
+          measureTarget.offsetWidth
+        )
+      );
+      const height = Math.ceil(
+        Math.max(
+          measureTarget.scrollHeight,
+          measureTarget.getBoundingClientRect().height,
+          measureTarget.offsetHeight
+        )
+      );
+      if (width <= 0 && height <= 0) {
+        return;
+      }
+      if (resizeFrame != null) {
+        cancelAnimationFrame(resizeFrame);
+      }
+      resizeFrame = requestAnimationFrame(() => {
+        resizeFrame = requestAnimationFrame(() => {
+          resizeFrame = null;
+          void bridgeInvoke('view.reportSize', {
+            ...(width > 0 ? { width } : {}),
+            ...(height > 0 ? { height } : {}),
+            slot: 'indicator'
+          });
+        });
+      });
+    };
+
+    resizeObserver = new ResizeObserver(() => {
+      reportIndicatorSize();
+    });
+    resizeObserver.observe(root);
+
+    render();
+    reportIndicatorSize();
+
+    return () => {
+      resizeObserver?.disconnect();
+      if (resizeFrame != null) {
+        cancelAnimationFrame(resizeFrame);
+      }
+    };
+  }
+
   const unsubscribe = bridgeOn('view.context', (payload) => {
     currentContext = payload;
     render();

package/dist/runtime/index.d.ts

@@ -1,4 +1,5 @@
 import type * as React from 'react';
+import type { Disposable, PluginContext, ThemeContribution } from '../types';
 
 /**
  * Installs the HarborClient renderer React instance for plugin JSX and hooks.
@@ -18,3 +19,20 @@ export function installReact(react: typeof React): void;
 export function createPluginComponent<P extends Record<string, unknown>>(
   factory: (react: typeof React) => React.ComponentType<P>
 ): React.ComponentType<P>;
+
+/**
+ * Registers a custom appearance theme and tracks its disposable for cleanup.
+ *
+ * @param hc - Renderer plugin context.
+ * @param theme - Theme definition; `theme.id` must match `contributes.themes`.
+ * @returns Disposable that unregisters the theme.
+ */
+export function registerTheme(hc: PluginContext, theme: ThemeContribution): Disposable;
+
+/**
+ * Identity helper that applies `ThemeContribution` typing to a theme literal.
+ *
+ * @param theme - Theme definition.
+ * @returns The same theme, typed.
+ */
+export function defineTheme(theme: ThemeContribution): ThemeContribution;

package/dist/runtime/index.js

@@ -41,3 +41,26 @@ export function createPluginComponent(factory) {
 
   return PluginComponent;
 }
+
+/**
+ * Registers a custom appearance theme and tracks its disposable for cleanup.
+ *
+ * @param {import('../types').PluginContext} hc - Renderer plugin context.
+ * @param {import('../types').ThemeContribution} theme - Theme definition; `theme.id` must match `contributes.themes`.
+ * @returns {import('../types').Disposable} Disposable that unregisters the theme.
+ */
+export function registerTheme(hc, theme) {
+  const disposable = hc.themes.register(theme);
+  hc.subscriptions.push(disposable);
+  return disposable;
+}
+
+/**
+ * Identity helper that applies `ThemeContribution` typing to a theme literal.
+ *
+ * @param {import('../types').ThemeContribution} theme - Theme definition.
+ * @returns {import('../types').ThemeContribution} The same theme, typed.
+ */
+export function defineTheme(theme) {
+  return theme;
+}

package/dist/runtime/index.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.test.d.ts.map

package/dist/runtime/index.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.d.ts","sourceRoot":"","sources":["../../src/runtime/index.test.ts"],"names":[],"mappings":""}

package/dist/runtime/index.test.js

@@ -0,0 +1,41 @@
+import { describe, expect, it, jest } from '@jest/globals';
+import { defineTheme, registerTheme } from './index.js';
+/**
+ * Builds a minimal plugin context mock for registerTheme tests.
+ */
+function createMockPluginContext() {
+    const disposable = { dispose: jest.fn() };
+    const registerMock = jest.fn(() => disposable);
+    const subscriptions = [];
+    return {
+        subscriptions,
+        themes: { register: registerMock },
+        registerMock
+    };
+}
+describe('registerTheme', () => {
+    it('registers the theme, pushes the disposable onto subscriptions, and returns it', () => {
+        const hc = createMockPluginContext();
+        const theme = {
+            id: 'solarized',
+            title: 'Solarized Dark',
+            type: 'dark',
+            colors: { surface: '#002b36' }
+        };
+        const disposable = registerTheme(hc, theme);
+        expect(hc.registerMock).toHaveBeenCalledWith(theme);
+        expect(hc.subscriptions).toHaveLength(1);
+        expect(hc.subscriptions[0]).toBe(disposable);
+    });
+});
+describe('defineTheme', () => {
+    it('returns the theme argument unchanged', () => {
+        const theme = {
+            id: 'nord',
+            title: 'Nord',
+            type: 'dark',
+            stylesheet: 'dist/theme.css'
+        };
+        expect(defineTheme(theme)).toBe(theme);
+    });
+});

package/dist/runtime/index.test.ts

@@ -0,0 +1,53 @@
+import { describe, expect, it, jest } from '@jest/globals';
+import type { PluginContext, ThemeContribution } from '../types';
+import { defineTheme, registerTheme } from './index.js';
+
+/**
+ * Builds a minimal plugin context mock for registerTheme tests.
+ */
+function createMockPluginContext(): PluginContext & {
+  registerMock: jest.MockedFunction<PluginContext['themes']['register']>;
+} {
+  const disposable = { dispose: jest.fn() };
+  const registerMock = jest.fn(() => disposable);
+  const subscriptions: PluginContext['subscriptions'] = [];
+
+  return {
+    subscriptions,
+    themes: { register: registerMock },
+    registerMock
+  } as unknown as PluginContext & {
+    registerMock: jest.MockedFunction<PluginContext['themes']['register']>;
+  };
+}
+
+describe('registerTheme', () => {
+  it('registers the theme, pushes the disposable onto subscriptions, and returns it', () => {
+    const hc = createMockPluginContext();
+    const theme: ThemeContribution = {
+      id: 'solarized',
+      title: 'Solarized Dark',
+      type: 'dark',
+      colors: { surface: '#002b36' }
+    };
+
+    const disposable = registerTheme(hc, theme);
+
+    expect(hc.registerMock).toHaveBeenCalledWith(theme);
+    expect(hc.subscriptions).toHaveLength(1);
+    expect(hc.subscriptions[0]).toBe(disposable);
+  });
+});
+
+describe('defineTheme', () => {
+  it('returns the theme argument unchanged', () => {
+    const theme: ThemeContribution = {
+      id: 'nord',
+      title: 'Nord',
+      type: 'dark',
+      stylesheet: 'dist/theme.css'
+    };
+
+    expect(defineTheme(theme)).toBe(theme);
+  });
+});