@paged-media/plugin-api 0.2.25-canary.0 → 0.2.27-canary.0

package/dist/host.d.ts

@@ -707,6 +707,20 @@ export interface PartsSurface {
      *  returned as relative paths. */
     list(prefix?: string): Promise<string[]>;
 }
+export interface NativeDocumentSurface {
+    /** Read the core-owned native MODEL part (`paged/core/model/document.pgm`)
+     *  bytes, or null if the document carries no native model part. */
+    readModel(): Promise<Uint8Array | null>;
+    /** Read the core-owned COMPOSITION part (`paged/core/composition/document.pgd`)
+     *  bytes, or null if absent. */
+    readComposition(): Promise<Uint8Array | null>;
+    /** List the container's `paged/core/` native part paths (optionally under a
+     *  relative prefix). Empty when the host wires no backend. */
+    listParts(prefix?: string): Promise<string[]>;
+    /** Replace the active document by loading a native/importable package
+     *  (an importer plugin produces these bytes, e.g. from IDML). */
+    open(bytes: Uint8Array): Promise<void>;
+}
 /** The per-origin outcome of a consent request. */
 export interface ConsentResult {
     /** Origins the user granted (a subset of the requested set). */
@@ -861,6 +875,17 @@ export interface BundleHost {
      *  null/`[]`, writes reject, and `supports("storage.parts@1")` is false. The
      *  part-types are declared in `contributes.partTypes`. */
     readonly parts: PartsSurface;
+    /** The isolate-safe NATIVE-DOCUMENT door (ADR-021): capability-gated read of
+     *  the host document's CORE-OWNED native parts (`paged/core/` MODEL +
+     *  COMPOSITION) + loading a plugin-produced native/importable package as the
+     *  active document — the isolate-safe replacement for the `host.editor.client`
+     *  escape hatch used by importers/exporters. Gated on
+     *  `capabilities.document.readNative` (the reads) and
+     *  `capabilities.document.openNative` (`open`). Always present; when the host
+     *  wires no backend, reads answer null/`[]`, `open` rejects, and
+     *  `supports("document.readNative@1")` / `supports("document.openNative@1")`
+     *  are false. */
+    readonly nativeDocument: NativeDocumentSurface;
     /** The capability-gated NETWORK CONSENT door (D-03; base-idea §11). Always
      *  present; gated on `capabilities.network` and per-origin user consent.
      *  When the host injects no consent backend, every request is DENIED (the

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 export type { PluginId, PluginManifest, PluginCapabilities, PluginContributions, NetworkCapability, DataProvidersCapability, StorageCapability, WasmArtifact, WasmPurpose, WorkersCapability, SecretsCapability, GpuCapability, } from "./manifest";
 export type { BundleHandle, PagedBundle } from "./bundle";
-export type { BundleHost, ContributionSurface, SceneLayerSurface, ImagesSurface, ImageResourceClaimOptions, TileBytes, WorkersSurface, BundleWorker, SpawnWorkerOptions, SecretsSurface, SecretMaterial, DocumentSurface, SelectionSurface, ViewportSurface, TextSurface, TextMetrics, FrameChainLink, OverlaySurface, ShellSurface, FilePickerOptions, PickedFile, StorageSurface, BlobSurface, BlobUsage, PartsSurface, NetworkSurface, ConsentResult, DataProvidersSurface, DataProviderRegistration, DataProviderHandle, DataProviderInfo, DataProviderSnapshot, ProviderSchema, ProviderField, ProviderRecordSet, DiagnosticsSurface, BindingsSurface, Diagnostic, DocumentChangeEvent, MutationOutcome, Disposable, PluginLogger, EditContextContribution, ObjectTypeContribution, EditContextCandidate, EnteredEditContext, ContentPointerEvent, EditContextDescriptor, ObjectTypeDescriptor, PluginMetadataEnvelope, ObjectTypeBaker, BakeContext, } from "./host";
+export type { BundleHost, ContributionSurface, SceneLayerSurface, ImagesSurface, ImageResourceClaimOptions, TileBytes, WorkersSurface, BundleWorker, SpawnWorkerOptions, SecretsSurface, SecretMaterial, DocumentSurface, SelectionSurface, ViewportSurface, TextSurface, TextMetrics, FrameChainLink, OverlaySurface, ShellSurface, FilePickerOptions, PickedFile, StorageSurface, BlobSurface, BlobUsage, PartsSurface, NativeDocumentSurface, NetworkSurface, ConsentResult, DataProvidersSurface, DataProviderRegistration, DataProviderHandle, DataProviderInfo, DataProviderSnapshot, ProviderSchema, ProviderField, ProviderRecordSet, DiagnosticsSurface, BindingsSurface, Diagnostic, DocumentChangeEvent, MutationOutcome, Disposable, PluginLogger, EditContextContribution, ObjectTypeContribution, EditContextCandidate, EnteredEditContext, ContentPointerEvent, EditContextDescriptor, ObjectTypeDescriptor, PluginMetadataEnvelope, ObjectTypeBaker, BakeContext, } from "./host";
 export type { PanelSchema, PanelSchemaSection, PanelSchemaRow, SchemaPanelContribution, SchemaPanelRenderer, SchemaPanelRendererProps, WidgetValueBinding, BindingRef, SchemaGate, } from "./panel-schema";
 export type { WidgetSurface, CodeEditorProps, CodeEditorDiagnostic, CodeEditorLanguage, } from "./widgets";
 export type { AssetSurface, AssetKind, FontFaceAsset, FontFaceFormat, } from "./assets";

package/dist/manifest.d.ts

@@ -27,6 +27,16 @@ export interface PluginCapabilities {
     document?: {
         read?: "broad" | "scoped";
         write?: "broad" | "scoped";
+        /** Privileged READ of the document's core-owned NATIVE parts
+         *  (`host.nativeDocument.readModel/readComposition/listParts`, the
+         *  `paged/core/` subtree — ADR-021). Gates the native read doors; an
+         *  absent field denies them. */
+        readNative?: boolean;
+        /** Authorizes REPLACING the active document by loading a
+         *  plugin-produced native/importable package
+         *  (`host.nativeDocument.open` — an importer's door). Gates that write;
+         *  an absent field denies it. */
+        openNative?: boolean;
     };
     /** Render-pipeline surfaces the bundle uses. `overlay` means the
      *  shared TS overlay signals (tool previews) AND `contribute.overlay`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@paged-media/plugin-api",
-  "version": "0.2.25-canary.0",
+  "version": "0.2.27-canary.0",
   "description": "The Paged plugin contract: manifest, bundle lifecycle, the BundleHost surface, and the contribution + engine wire types. Type-only.",
   "license": "MPL-2.0 OR LicenseRef-PMEL",
   "type": "module",

package/src/manifest.schema.json

@@ -51,6 +51,14 @@
                 "broad",
                 "scoped"
               ]
+            },
+            "readNative": {
+              "type": "boolean",
+              "description": "Privileged read of the document's core-owned native parts (host.nativeDocument reads; the paged/core/ subtree — ADR-021)."
+            },
+            "openNative": {
+              "type": "boolean",
+              "description": "Authorizes replacing the active document by loading a plugin-produced native/importable package (host.nativeDocument.open)."
             }
           }
         },