@lapis-notes/api 0.2.3 → 0.2.6

package/CHANGELOG.md

@@ -1,5 +1,64 @@
 # @lapis-notes/api
 
+## 0.2.6
+
+### Patch Changes
+
+- [#72](https://github.com/lapismd/lapis-notes/pull/72)
+  [`5bd58d8`](https://github.com/lapismd/lapis-notes/commit/5bd58d8033062923f09549fa341d84f22b143452)
+  Thanks
+  [@lapismd-dependency-bot](https://github.com/apps/lapismd-dependency-bot)! -
+  Refresh first-party Lapis dependencies to the published versions recorded in
+  this pull request.
+
+- [#73](https://github.com/lapismd/lapis-notes/pull/73)
+  [`8a7ec3c`](https://github.com/lapismd/lapis-notes/commit/8a7ec3c3d1d1610e8be0e3b29aab4b2f4188a0c5)
+  Thanks
+  [@lapismd-dependency-bot](https://github.com/apps/lapismd-dependency-bot)! -
+  Refresh first-party Lapis dependencies to the published versions recorded in
+  this pull request.
+
+- [#79](https://github.com/lapismd/lapis-notes/pull/79)
+  [`5292b52`](https://github.com/lapismd/lapis-notes/commit/5292b52ebc37318fcfad7971e4e309cf3afaff18)
+  Thanks [@stevejuma](https://github.com/stevejuma)! - Retain a successfully
+  opened same-leaf file as the active-file fallback when a panel becomes active
+  before the open completes.
+
+## 0.2.5
+
+### Patch Changes
+
+- [#66](https://github.com/lapismd/lapis-notes/pull/66)
+  [`6086980`](https://github.com/lapismd/lapis-notes/commit/6086980be8a0d9cf6e697a689b0c17f409afdc3f)
+  Thanks [@stevejuma](https://github.com/stevejuma)! - Consume published Design
+  Core 0.10.1 so browser hosts can reserve leading and trailing native controls
+  and title-bar height, with a continuous divider when sidebars collapse. Keep
+  portable registry ranges and existing compatibility.
+- Updated dependencies
+  [[`6086980`](https://github.com/lapismd/lapis-notes/commit/6086980be8a0d9cf6e697a689b0c17f409afdc3f)]:
+  - @lapis-notes/ui@0.1.7
+
+## 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";