@punica/editor 1.3.3 → 1.3.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@punica/editor",
-  "version": "1.3.3",
+  "version": "1.3.5",
   "description": "Punica Editor",
   "private": false,
   "type": "module",

package/types/punica.module.runtime.fs.d.ts

@@ -15,6 +15,8 @@ declare module 'punica' {
      * provider has not declared).
      *
      *  - 'streaming'         : opt-in chunked read/write for large files
+     *  - 'binary'            : ranged binary reads via `readBytes` (e.g.
+     *                          Parquet); text-only providers omit this
      *  - 'watch'             : path-scoped change notifications
      *  - 'versioning'        : per-path history + time-travel reads
      *  - 'encrypted-at-rest' : payloads stored encrypted by the host
@@ -22,6 +24,7 @@ declare module 'punica' {
      */
     export type FileSystemProviderCapability =
       | 'streaming'
+      | 'binary'
       | 'watch'
       | 'versioning'
       | 'encrypted-at-rest'
@@ -214,6 +217,18 @@ declare module 'punica' {
        */
       readFile(path: string): Promise<string>;
 
+      /**
+       * Read a raw byte range of a workspace file. Optional/capability-gated:
+       * present on hosts with a binary bridge (Electron), absent in the browser.
+       * Returns fewer bytes than `length` only at EOF. Use for binary workspace
+       * files (e.g. Parquet) that `readFile` (text-only) cannot handle.
+       */
+      readBytes?(
+        path: string,
+        offset: number,
+        length: number
+      ): Promise<ArrayBuffer>;
+
       /**
        * Create a new file with the given textual content.
        */
@@ -337,6 +352,13 @@ declare module 'punica' {
        * Unique identifier for this opener within the runtime.
        */
       id: string;
+      /**
+       * Human-readable name shown in an "Open With…" chooser (e.g. "DuckDB",
+       * "CSV Viewer"). Declared in the extension manifest
+       * (`integrations.fileOpeners[].label`). Falls back to the opener id when
+       * omitted.
+       */
+      label?: string;
       /**
        * Command id that will be executed when this opener is selected.
        * The convention is that commands accept at least (path: string, content: string, ctx?: FileOpenContext).
@@ -380,6 +402,13 @@ declare module 'punica' {
        * Returns null when no suitable opener is found.
        */
       resolve(ctx: FileOpenContext): ResolvedOpener | null;
+      /**
+       * All openers that match the given file context, ordered by priority
+       * (highest first). Powers an "Open With…" chooser: the first entry is
+       * what `resolve` would return; the rest are alternatives. Excludes
+       * matchless fallback openers. Returns an empty array when none match.
+       */
+      resolveAll(ctx: FileOpenContext): ResolvedOpener[];
     }
   }
 }