@lapis-notes/api 0.2.3 → 0.2.4

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # @lapis-notes/api
 
+## 0.2.4
+
+### Patch Changes
+
+- [#60](https://github.com/lapismd/lapis-notes/pull/60)
+  [`fb2eff2`](https://github.com/lapismd/lapis-notes/commit/fb2eff2b11b4a623ea2780f5e3e0f92a0530844b)
+  Thanks [@stevejuma](https://github.com/stevejuma)! - Expose the explicit
+  Notebook Design Core/UI host modules and admit Design Core 0.9 compatibility,
+  including File Explorer so the host resolves one shared Core installation.
+  This changes generated host admission metadata and dependency compatibility,
+  not the API runtime interface; retain the 0.2 API peer cohort. Full host
+  qualification remains required before release.
+
+  Add a public Vite renderer adapter that binds plugin compiler imports to the
+  admitted versioned Svelte namespace and resolves those entries through the
+  shared host runtime. Expose the required Markdown and CodeMirror host modules
+  while keeping private imports and renderer version mismatches rejected.
+- Updated dependencies
+  [[`fb2eff2`](https://github.com/lapismd/lapis-notes/commit/fb2eff2b11b4a623ea2780f5e3e0f92a0530844b)]:
+  - @lapis-notes/ui@0.1.6
+
 ## 0.2.3
 
 ### Patch Changes

package/README.md

@@ -65,3 +65,27 @@ Explorer uses editor associations and pattern priority to choose the
 contribution, then resolves artwork through `app.icons`. Pending, missing or
 failed artwork retains the filename icon. Changes repaint existing rows;
 rendering an icon never activates a plugin or constructs its file view.
+
+### Versioned renderer builds
+
+Use the public build adapter when producing renderer plugins or embedding their
+npm exports in a Vite host. Pass the exact installed Svelte version; the generated
+host catalog rejects unknown modules and incompatible compiler/runtime versions.
+
+```ts
+import { defineConfig } from "vite";
+import { svelte } from "@sveltejs/vite-plugin-svelte";
+import { rendererHostModulePlugin } from "@lapis-notes/api/build/vite";
+
+export default defineConfig({
+  plugins: [
+    rendererHostModulePlugin({ mode: "host", svelteVersion: "5.56.10" }),
+    svelte(),
+  ],
+});
+```
+
+Plugin producers choose `mode: "plugin"` and let the adapter externalize Svelte
+imports; do not pre-externalize them or copy private host build helpers. The
+versioned providers retain the host's single Svelte runtime. Other imports still
+need explicit host admission and the plugin's normal manifest audit.

package/dist/build-tools/renderer.d.ts

@@ -0,0 +1,20 @@
+export interface RendererHostModuleOptions {
+    /** Plugin producers externalize imports; npm hosts resolve admitted providers. */
+    mode: "plugin" | "host";
+    /** The exact installed compiler/runtime version, never a semver range. */
+    svelteVersion: string;
+}
+/** Bind compiled plugins to the host's public versioned renderer catalog. */
+export declare function rendererHostModulePlugin(options: RendererHostModuleOptions): {
+    name: string;
+    enforce: "pre";
+    config(this: void): {
+        optimizeDeps: {
+            exclude: string[];
+        };
+    };
+    resolveId(this: import("rollup").PluginContext, source: string, importer?: string): Promise<{
+        id: string;
+        external?: boolean | "absolute" | "relative";
+    } | null>;
+};

package/dist/build-tools/renderer.js

@@ -0,0 +1,49 @@
+import { pluginHostModuleRegistry } from "../generated/plugin-host-modules.schema.generated.js";
+/** Bind compiled plugins to the host's public versioned renderer catalog. */
+export function rendererHostModulePlugin(options) {
+    if (!/^[0-9]+\.[0-9]+\.[0-9]+(?:[-+][\w.-]+)?$/.test(options.svelteVersion))
+        throw Error("Renderer binding requires an exact Svelte version");
+    if (options.mode !== "plugin" && options.mode !== "host")
+        throw Error("Renderer mode must be plugin or host");
+    const entries = Object.values(pluginHostModuleRegistry).filter((entry) => entry.source === "renderer-abi" &&
+        entry.public &&
+        entry.version === options.svelteVersion);
+    if (!entries.length)
+        throw Error(`The host catalog does not admit Svelte ${options.svelteVersion}`);
+    const providers = new Map(entries.map((entry) => [entry.specifier, entry.entry]));
+    const specifiers = new Map(entries.map((entry) => [entry.entry, entry.specifier]));
+    return {
+        name: "lapis-renderer-host-modules",
+        enforce: "pre",
+        config() {
+            return {
+                optimizeDeps: {
+                    // These are host ABI identifiers, not exports of the npm Svelte package.
+                    exclude: options.mode === "host" ? [...providers.keys()] : [],
+                },
+            };
+        },
+        async resolveId(source, importer) {
+            if (source.startsWith("svelte/renderer/")) {
+                const provider = providers.get(source);
+                if (!provider)
+                    throw Error(`Unadmitted renderer module: ${source}`);
+                if (options.mode === "plugin")
+                    return { id: source, external: true };
+                const resolved = await this.resolve(provider, importer, {
+                    skipSelf: true,
+                });
+                if (!resolved)
+                    throw Error(`Missing host renderer provider: ${provider}`);
+                return resolved;
+            }
+            if (options.mode !== "plugin" ||
+                !(source === "svelte" || source.startsWith("svelte/")))
+                return null;
+            const specifier = specifiers.get(source);
+            if (!specifier)
+                throw Error(`Unadmitted compiler renderer module: ${source}`);
+            return { id: specifier, external: true };
+        },
+    };
+}

package/dist/build-tools/vite.d.ts

@@ -13,3 +13,4 @@ export declare function tursoBundleBuildPlugin(): {
         map: null;
     } | null;
 };
+export { rendererHostModulePlugin, type RendererHostModuleOptions, } from "./renderer.js";

package/dist/build-tools/vite.js

@@ -34,3 +34,4 @@ export function tursoBundleBuildPlugin() {
         },
     };
 }
+export { rendererHostModulePlugin, } from "./renderer.js";