@paged-media/plugin-sdk 0.2.13-canary.0 → 0.2.16-canary.0

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { PagedBundle, FontFaceAsset, BundleHost, ConsentResult, DataProviderRegistration, DataProviderHandle, DataProviderInfo, DataProviderSnapshot, Disposable, ShellSurface, WidgetSurface, SchemaPanelRenderer, SchemaPanelContribution, EditContextContribution, ObjectTypeContribution, Diagnostic, PagedEditor, PluginManifest, ToolContribution, PanelContribution, CommandContribution, KeybindingContribution, OverlayContribution, ImporterContribution, ExporterContribution, ToolPreviewShape, BindingsSurface, PanelProps, SchemaGate, WasmArtifact, CanvasPointerEvent, Mutation, MutationOutcome } from '@paged-media/plugin-api';
+import { PagedBundle, FontFaceAsset, BundleHost, ClipboardPayload, ConsentResult, DataProviderRegistration, DataProviderHandle, DataProviderInfo, DataProviderSnapshot, Disposable, ShellSurface, WidgetSurface, SchemaPanelRenderer, SchemaPanelContribution, EditContextContribution, ObjectTypeContribution, Diagnostic, PagedEditor, PluginManifest, ToolContribution, PanelContribution, CommandContribution, KeybindingContribution, OverlayContribution, ImporterContribution, ExporterContribution, ToolPreviewShape, BindingsSurface, PanelProps, SchemaGate, WasmArtifact, CanvasPointerEvent, Mutation, MutationOutcome } from '@paged-media/plugin-api';
 import { ComponentType } from 'react';
 
 /**
@@ -113,6 +113,20 @@ interface BlobStore {
     /** Total bytes this plugin currently stores. */
     used(pluginId: string): Promise<number>;
 }
+/**
+ * The backend the editor injects to back `host.clipboard` (K-6 / S-14): a
+ * thin read/write pair over the REAL system clipboard (`navigator.clipboard`
+ * in-browser; a fake in the headless harness). The SDK adapter owns the
+ * capability gate + the `"vector"` tabular-stripping; this backend only does
+ * the raw IO. `read` recovers a `{ text?, tabular? }` payload (or `null` when
+ * the platform offers nothing / refuses); `write` puts a payload on the
+ * clipboard (the editor backend lays down BOTH `text/plain` TSV and a
+ * `text/html` `<table>` so a paste into Excel/Sheets/Word lands a real grid).
+ */
+interface ClipboardBackend {
+    read(): Promise<ClipboardPayload | null>;
+    write(payload: ClipboardPayload): Promise<void>;
+}
 /** The SHARED cross-plugin data-provider registry (paged.data §7.1 / D-09). The
  *  editor creates ONE (`createDataProviderRegistry`) and injects the SAME
  *  instance into every plugin host, so a provider plugin and a consumer plugin
@@ -220,6 +234,12 @@ interface CreateBundleHostOptions {
      *  When absent, reads answer empty and writes reject (the honest
      *  no-store door). */
     blobStore?: BlobStore;
+    /** Host-provided CLIPBOARD backend (K-6 / S-14). When present,
+     *  `host.clipboard.read/write` go through it (capability-gated on
+     *  `capabilities.clipboard`) and `supports("clipboard@1")` answers true.
+     *  When absent, `read` answers `null` and `write` is a no-op (the honest
+     *  no-clipboard door). */
+    clipboard?: ClipboardBackend;
     /**
      * How the host treats a declaration↔use mismatch — a bundle that
      * USES a door (`contribute.tool`, `document.mutate`, …) it did not
@@ -314,7 +334,7 @@ interface RecordedContribution {
     id: string;
     value: ToolContribution | PanelContribution | SchemaPanelContribution | CommandContribution | KeybindingContribution | OverlayContribution | EditContextContribution | ObjectTypeContribution | ImporterContribution | ExporterContribution;
 }
-interface HarnessOptions extends LoadHeadlessEngineOptions, Pick<CreateBundleHostOptions, "console" | "storage" | "capabilityMode" | "assetSource" | "blobStore"> {
+interface HarnessOptions extends LoadHeadlessEngineOptions, Pick<CreateBundleHostOptions, "console" | "storage" | "capabilityMode" | "assetSource" | "blobStore" | "clipboard"> {
 }
 /** What `createHeadlessHost` resolves to: a real engine-backed host plus
  *  the conformance affordances (load an IDML, read the contribution log,
@@ -460,13 +480,19 @@ declare function loadBundle(getEditor: () => PagedEditor, bundle: PagedBundle, o
  *  KEEP IN SYNC with plugin-cli's WASM_MAX_* and the schema's `maxBytes`
  *  maximum — the CLI hand-mirrors the contract. */
 declare const WASM_BUDGETS: {
-    /** Hard per-artifact byte ceiling. A release-optimised wasm layout
-     *  engine (Blitz-class) lands in the low-single-digit MiB; 8 MiB
-     *  rejects an accidentally-bundled debug build while leaving headroom
-     *  for one real engine. A manifest `maxBytes` may only TIGHTEN this. */
+    /** Hard per-artifact byte ceiling for layout/codec/compute. A
+     *  release-optimised wasm layout engine (Blitz-class) lands in the
+     *  low-single-digit MiB; 8 MiB rejects an accidentally-bundled debug
+     *  build while leaving headroom for one real engine. A manifest
+     *  `maxBytes` may only TIGHTEN this. */
     readonly maxArtifactBytes: number;
-    /** Total declared wasm across one bundle. Bounds a bundle that ships
-     *  several modules (engine + a codec, say). */
+    /** D-07b — the governed HIGHER ceiling for `purpose: "engine"` (a
+     *  vendored DB/query engine like DuckDB-WASM ≈ 36 MiB). 64 MiB fits the
+     *  real artifacts with headroom; still a hard cap a manifest may only
+     *  tighten. Only the `engine` purpose earns it. */
+    readonly maxEngineArtifactBytes: number;
+    /** Total declared wasm across one bundle. Sized so one `engine`
+     *  artifact + a codec fit. */
     readonly maxTotalBytes: number;
     /** Wall-clock budget for fetch + compile + instantiate. Protects the
      *  editor's main flow from a pathological module; advisory, the loader
@@ -577,4 +603,4 @@ declare function contributeEditContext(host: BundleHost, contribution: EditConte
  *  descent. Capability-gated on `contributes.objectTypes`. */
 declare function contributeObjectType(host: BundleHost, contribution: ObjectTypeContribution): Disposable;
 
-export { API_VERSION, ASSET_BUDGETS, BLOB_BUDGETS, type BlobStore, type BundleAssetProvider, type BundleAssetSource, type BundleHostHandle, type BundleTrust, CANVAS_WASM_PKG, CLICK_DRAG_THRESHOLD_PX, type ConsentBackend, type CreateBundleHostOptions, type DataProviderBackend, type DiagnosticsSink, DisposableStore, FALLBACK_WIDGETS, HOST_FEATURES, type HarnessOptions, type HeadlessCanvasWorker, type HeadlessHost, type HeadlessHostHandle, type LoadBundleWasmOptions, type LoadHeadlessEngineOptions, type LoadedBundle, type LoadedBundleWasm, type LoadedEngine, type PageDrag, PluginApiNotImplemented, PluginCapabilityError, type RecordableAssetSource, type RecordedContribution, type RecordedFontFaceRequest, type SeededFace, type StorageBacking, WASM_BUDGETS, beginPageDrag, commitAndSelect, contributeEditContext, contributeObjectType, contributePanel, contributeSchemaPanel, contributeTool, createBundleHost, createDataProviderRegistry, createHeadlessHost, createRecordableAssetSource, defineBundle, endLocalFor, loadBundle, loadBundleWasm, loadHeadlessEngine, makeSchemaPanelComponent, protocolFromVersion, pxToPt, readVendoredWireVersion, resolveCanvasWasm, resolveGate, satisfiesApiVersion, toDisposable };
+export { API_VERSION, ASSET_BUDGETS, BLOB_BUDGETS, type BlobStore, type BundleAssetProvider, type BundleAssetSource, type BundleHostHandle, type BundleTrust, CANVAS_WASM_PKG, CLICK_DRAG_THRESHOLD_PX, type ClipboardBackend, type ConsentBackend, type CreateBundleHostOptions, type DataProviderBackend, type DiagnosticsSink, DisposableStore, FALLBACK_WIDGETS, HOST_FEATURES, type HarnessOptions, type HeadlessCanvasWorker, type HeadlessHost, type HeadlessHostHandle, type LoadBundleWasmOptions, type LoadHeadlessEngineOptions, type LoadedBundle, type LoadedBundleWasm, type LoadedEngine, type PageDrag, PluginApiNotImplemented, PluginCapabilityError, type RecordableAssetSource, type RecordedContribution, type RecordedFontFaceRequest, type SeededFace, type StorageBacking, WASM_BUDGETS, beginPageDrag, commitAndSelect, contributeEditContext, contributeObjectType, contributePanel, contributeSchemaPanel, contributeTool, createBundleHost, createDataProviderRegistry, createHeadlessHost, createRecordableAssetSource, defineBundle, endLocalFor, loadBundle, loadBundleWasm, loadHeadlessEngine, makeSchemaPanelComponent, protocolFromVersion, pxToPt, readVendoredWireVersion, resolveCanvasWasm, resolveGate, satisfiesApiVersion, toDisposable };

package/dist/index.js

@@ -272,6 +272,7 @@ function createBundleHost(getEditor, manifest, options) {
   const hasRendering = (s) => caps?.rendering?.includes(s) ?? false;
   const hasAsset = (k) => caps?.assets?.includes(k) ?? false;
   const hasBlobStore = () => caps?.storage?.blob === true;
+  const clipboardGrant = () => caps?.clipboard === "full" ? "full" : caps?.clipboard === "vector" ? "vector" : "none";
   const lists = (arr, id) => arr?.includes(id) ?? false;
   const declaresType = (arr, type) => arr?.some((e) => e.type === type) ?? false;
   const requireDeclared = (ok, door, missing) => {
@@ -1031,6 +1032,51 @@ function createBundleHost(getEditor, manifest, options) {
       return { used: await blobBackend.used(manifest.id), quota: blobQuota };
     }
   };
+  const clipboardBackend = options?.clipboard;
+  const clipboardGate = (door) => {
+    const grant = clipboardGrant();
+    requireDeclared(
+      grant !== "none",
+      door,
+      'capabilities.clipboard must be "full" or "vector"'
+    );
+    return grant === "full" ? "full" : "vector";
+  };
+  const clipboard = {
+    async read() {
+      const tier = clipboardGate("clipboard.read");
+      if (!clipboardBackend) return null;
+      let payload;
+      try {
+        payload = await clipboardBackend.read();
+      } catch {
+        return null;
+      }
+      if (!payload) return null;
+      if (tier === "vector" && payload.tabular !== void 0) {
+        const { tabular: _dropped, ...rest } = payload;
+        return rest;
+      }
+      return payload;
+    },
+    async write(payload) {
+      const tier = clipboardGate("clipboard.write");
+      if (!clipboardBackend) return;
+      let toWrite = payload;
+      if (tier === "vector" && payload.tabular !== void 0) {
+        log.warn(
+          'clipboard.write: dropping the tabular payload \u2014 capabilities.clipboard is "vector" (text only); declare "full" to copy a cell grid'
+        );
+        const { tabular: _dropped, ...rest } = payload;
+        toWrite = rest;
+      }
+      try {
+        await clipboardBackend.write(toWrite);
+      } catch (err) {
+        log.warn("clipboard.write: the platform refused the write", err);
+      }
+    }
+  };
   const featureSet = new Set(HOST_FEATURES);
   if (getEditor().text) {
     featureSet.add("text.measure@1");
@@ -1063,6 +1109,9 @@ function createBundleHost(getEditor, manifest, options) {
   if (options?.blobStore) {
     featureSet.add("storage.blob@1");
   }
+  if (options?.clipboard) {
+    featureSet.add("clipboard@1");
+  }
   const host = {
     manifest,
     log,
@@ -1081,6 +1130,7 @@ function createBundleHost(getEditor, manifest, options) {
     bindings,
     widgets,
     assets,
+    clipboard,
     supports: (feature) => featureSet.has(feature),
     get editor() {
       return getEditor();
@@ -1255,6 +1305,24 @@ function inMemoryBlobStore() {
     }
   };
 }
+function inMemoryClipboard() {
+  let slot = null;
+  return {
+    async read() {
+      if (!slot) return null;
+      return {
+        ...slot.text !== void 0 ? { text: slot.text } : {},
+        ...slot.tabular ? { tabular: { rows: slot.tabular.rows.map((r) => [...r]) } } : {}
+      };
+    },
+    async write(payload) {
+      slot = {
+        ...payload.text !== void 0 ? { text: payload.text } : {},
+        ...payload.tabular ? { tabular: { rows: payload.tabular.rows.map((r) => [...r]) } } : {}
+      };
+    }
+  };
+}
 var seqCounter = 1;
 function makeEngineEditor(worker, recorder, onToolPreview) {
   const protocol = worker.protocolVersion;
@@ -1417,10 +1485,12 @@ async function createHeadlessHost(options = {}) {
   let currentHost = null;
   let disposed = false;
   const blobStore = options.blobStore ?? inMemoryBlobStore();
+  const clipboard = options.clipboard ?? inMemoryClipboard();
   const buildHost = (manifest, mode) => createBundleHost(() => editor, manifest, {
     console: options.console,
     storage: options.storage,
     blobStore,
+    clipboard,
     capabilityMode: mode,
     // W-06 — a recordable fake asset source the conformance harness
     // can pass so a bundle's `@font-face` byte path is exercisable
@@ -1672,14 +1742,20 @@ function loadBundle(getEditor, bundle, options) {
 
 // src/wasm-bundle-loader.ts
 var WASM_BUDGETS = {
-  /** Hard per-artifact byte ceiling. A release-optimised wasm layout
-   *  engine (Blitz-class) lands in the low-single-digit MiB; 8 MiB
-   *  rejects an accidentally-bundled debug build while leaving headroom
-   *  for one real engine. A manifest `maxBytes` may only TIGHTEN this. */
+  /** Hard per-artifact byte ceiling for layout/codec/compute. A
+   *  release-optimised wasm layout engine (Blitz-class) lands in the
+   *  low-single-digit MiB; 8 MiB rejects an accidentally-bundled debug
+   *  build while leaving headroom for one real engine. A manifest
+   *  `maxBytes` may only TIGHTEN this. */
   maxArtifactBytes: 8 * 1024 * 1024,
-  /** Total declared wasm across one bundle. Bounds a bundle that ships
-   *  several modules (engine + a codec, say). */
-  maxTotalBytes: 16 * 1024 * 1024,
+  /** D-07b — the governed HIGHER ceiling for `purpose: "engine"` (a
+   *  vendored DB/query engine like DuckDB-WASM ≈ 36 MiB). 64 MiB fits the
+   *  real artifacts with headroom; still a hard cap a manifest may only
+   *  tighten. Only the `engine` purpose earns it. */
+  maxEngineArtifactBytes: 64 * 1024 * 1024,
+  /** Total declared wasm across one bundle. Sized so one `engine`
+   *  artifact + a codec fit. */
+  maxTotalBytes: 80 * 1024 * 1024,
   /** Wall-clock budget for fetch + compile + instantiate. Protects the
    *  editor's main flow from a pathological module; advisory, the loader
    *  aborts with a clear error when exceeded. */
@@ -1724,7 +1800,8 @@ async function loadBundleWasm(bundle, name, options) {
   const src = bytes instanceof Uint8Array ? bytes : new Uint8Array(bytes);
   const view = new Uint8Array(src.byteLength);
   view.set(src);
-  const ceiling = typeof artifact.maxBytes === "number" && artifact.maxBytes > 0 ? Math.min(artifact.maxBytes, WASM_BUDGETS.maxArtifactBytes) : WASM_BUDGETS.maxArtifactBytes;
+  const hostCeiling = artifact.purpose === "engine" ? WASM_BUDGETS.maxEngineArtifactBytes : WASM_BUDGETS.maxArtifactBytes;
+  const ceiling = typeof artifact.maxBytes === "number" && artifact.maxBytes > 0 ? Math.min(artifact.maxBytes, hostCeiling) : hostCeiling;
   if (view.byteLength > ceiling) {
     throw new Error(
       `loadBundleWasm: "${name}" of ${id} is ${view.byteLength} bytes, over its ${ceiling}-byte ceiling.`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@paged-media/plugin-sdk",
-  "version": "0.2.13-canary.0",
+  "version": "0.2.16-canary.0",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -11,7 +11,7 @@
     }
   },
   "dependencies": {
-    "@paged-media/plugin-api": "0.2.13-canary.0"
+    "@paged-media/plugin-api": "0.2.16-canary.0"
   },
   "peerDependencies": {
     "react": "^18.3.0"
@@ -22,7 +22,7 @@
     }
   },
   "devDependencies": {
-    "@paged-media/canvas-wasm": "0.43.0",
+    "@paged-media/canvas-wasm": "0.44.0",
     "@types/node": "20.19.39",
     "@types/react": "^18.3.12",
     "react": "^18.3.0",