@punica/editor 1.51.0 → 1.52.0

package/package.json

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

package/types/vendor/monaco-editor.d.ts

@@ -0,0 +1,109 @@
+/**
+ * The Monaco surface the hosts ship, for extensions that do not install it.
+ *
+ * `monaco-editor` is the product's, not an extension's: both hosts map the
+ * bare specifier to one shared `monaco-editor.bundle.js` through the renderer
+ * import map (punica-editor-browser/vendor/monaco-vendor.ts, monaco-editor
+ * ^0.53.0 in both hosts' package.json), and an extension keeps it `external`
+ * in rollup. Installing the package only for its types puts ~70 MB in every
+ * extension's node_modules and lets an extension compile against API the
+ * host's core-only bundle does not carry.
+ *
+ * **Opt in through tsconfig `paths`**, the way `punica` is mapped:
+ *
+ *   "paths": {
+ *     "punica": ["node_modules/@punica/editor/types"],
+ *     "monaco-editor": ["node_modules/@punica/editor/types/vendor/monaco-editor"]
+ *   }
+ *
+ * It is a module, not an ambient `declare module`, and it is deliberately not
+ * referenced from `types/index.d.ts`: an extension that does install the real
+ * package (extension-code-editor uses far more of it) must keep resolving to
+ * that one.
+ *
+ * Only what an extension in the fleet calls is declared. Widen it when a
+ * caller needs more — and check the member exists in the host's bundle,
+ * which is the core editor plus the python, markdown, sql, typescript and
+ * javascript tokenizers, no language services and no workers.
+ */
+
+export interface IDisposable {
+  dispose(): void;
+}
+
+export interface IPosition {
+  lineNumber: number;
+  column: number;
+}
+
+export interface IRange {
+  startLineNumber: number;
+  startColumn: number;
+  endLineNumber: number;
+  endColumn: number;
+}
+
+export enum MarkerSeverity {
+  Hint = 1,
+  Info = 2,
+  Warning = 4,
+  Error = 8,
+}
+
+export namespace editor {
+  interface IMarkerData extends IRange {
+    severity: MarkerSeverity;
+    message: string;
+  }
+
+  interface ITextModel {
+    getValue(): string;
+    getFullModelRange(): IRange;
+    getPositionAt(offset: number): IPosition;
+    getOffsetAt(position: IPosition): number;
+    pushEditOperations(
+      beforeCursorState: unknown[] | null,
+      editOperations: { range: IRange; text: string }[],
+      cursorStateComputer: () => unknown[] | null
+    ): unknown;
+    pushStackElement(): void;
+    dispose(): void;
+  }
+
+  interface IStandaloneCodeEditor {
+    getValue(): string;
+    setValue(value: string): void;
+    getModel(): ITextModel | null;
+    focus(): void;
+    dispose(): void;
+    layout(): void;
+    setSelection(range: IRange): void;
+    revealRangeInCenterIfOutsideViewport(range: IRange): void;
+    onDidChangeModelContent(listener: () => void): IDisposable;
+    updateOptions(options: Record<string, unknown>): void;
+  }
+
+  function create(
+    host: HTMLElement,
+    options: Record<string, unknown>
+  ): IStandaloneCodeEditor;
+  function setTheme(theme: string): void;
+  function setModelMarkers(
+    model: ITextModel,
+    owner: string,
+    markers: IMarkerData[]
+  ): void;
+}
+
+export namespace languages {
+  function register(language: { id: string; extensions?: string[] }): void;
+  function getLanguages(): { id: string }[];
+  function setMonarchTokensProvider(
+    languageId: string,
+    language: Record<string, unknown>
+  ): IDisposable;
+  function setLanguageConfiguration(
+    languageId: string,
+    configuration: Record<string, unknown>
+  ): IDisposable;
+}