@sheetxl/scripting-react 0.7.23-beta.2

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@sheetxl/scripting-react",
+  "description": "Scripting React - Monaco based script editor and scripting UI for SheetXL.",
+  "version": "0.7.23-beta.2",
+  "license": "SEE LICENSE IN <LICENSE>",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./types/index.d.ts",
+      "browser": "./browser/esm/index.mjs",
+      "node": "./node/esm/index.mjs",
+      "import": "./browser/esm/index.mjs",
+      "require": "./browser/cjs/index.cjs"
+    }
+  },
+  "types": "./types/index.d.ts",
+  "module": "./browser/esm/index.mjs",
+  "main": "./browser/cjs/index.cjs",
+  "sideEffects": [
+    "*.css",
+    "**/*.css"
+  ],
+  "homepage": "https://sheetxl.com",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/sheetxl/sheetxl.git"
+  },
+  "bugs": {
+    "url": "https://github.com/sheetxl/sheetxl/issues"
+  },
+  "keywords": [
+    "sheetxl",
+    "spreadsheet",
+    "javascript",
+    "typescript",
+    "react",
+    "scripting",
+    "monaco",
+    "automation",
+    "macros"
+  ],
+  "dependencies": {
+    "@monaco-editor/react": "^4.7.0",
+    "@sheetxl/react": "^0.7.23-beta.2",
+    "@sheetxl/scripting": "^0.7.23-beta.2",
+    "@sheetxl/sdk": "^0.7.23-beta.2",
+    "@sheetxl/utils": "^0.7.23-beta.2",
+    "@sheetxl/utils-react": "^0.7.23-beta.2",
+    "clsx": "^2.1.1",
+    "monaco-editor-auto-typings": "^0.4.6",
+    "path-browserify": "^1.0.1",
+    "react-merge-refs": "^3.0.2"
+  },
+  "peerDependencies": {
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0"
+  },
+  "devDependencies": {
+    "@types/react": "^19.2.17",
+    "@types/react-dom": "^19.2.3"
+  }
+}

package/resources/contents.json

@@ -0,0 +1,36 @@
+{
+  "entries": [
+    {
+      "path": "locales/contents.json"
+    },
+    {
+      "path": "locales/de/groups.cmd.json"
+    },
+    {
+      "path": "locales/de/scriptEditor.cmd.json"
+    },
+    {
+      "path": "locales/de/ui.msg.json"
+    },
+    {
+      "path": "locales/de/workbookScript.cmd.json"
+    },
+    {
+      "path": "locales/en/groups.cmd.json"
+    },
+    {
+      "path": "locales/en/scriptEditor.cmd.json"
+    },
+    {
+      "path": "locales/en/ui.msg.json"
+    },
+    {
+      "path": "locales/en/workbookScript.cmd.json"
+    }
+  ],
+  "folders": [
+    "locales",
+    "locales/de",
+    "locales/en"
+  ]
+}

package/resources/locales/contents.json

@@ -0,0 +1,58 @@
+{
+  "kind": "locales",
+  "package": "@sheetxl/scripting-react",
+  "entries": [
+    {
+      "path": "de/groups.cmd.json",
+      "locale": "de",
+      "role": "catalog",
+      "scope": "ui",
+      "sourceId": "groups"
+    },
+    {
+      "path": "de/scriptEditor.cmd.json",
+      "locale": "de",
+      "role": "catalog",
+      "scope": "scriptEditor",
+      "sourceId": "scriptEditor"
+    },
+    {
+      "path": "de/ui.msg.json",
+      "locale": "de",
+      "role": "messages"
+    },
+    {
+      "path": "de/workbookScript.cmd.json",
+      "locale": "de",
+      "role": "catalog",
+      "scope": "workbook",
+      "sourceId": "workbookScript"
+    },
+    {
+      "path": "en/groups.cmd.json",
+      "locale": "en",
+      "role": "catalog",
+      "scope": "ui",
+      "sourceId": "groups"
+    },
+    {
+      "path": "en/scriptEditor.cmd.json",
+      "locale": "en",
+      "role": "catalog",
+      "scope": "scriptEditor",
+      "sourceId": "scriptEditor"
+    },
+    {
+      "path": "en/ui.msg.json",
+      "locale": "en",
+      "role": "messages"
+    },
+    {
+      "path": "en/workbookScript.cmd.json",
+      "locale": "en",
+      "role": "catalog",
+      "scope": "workbook",
+      "sourceId": "workbookScript"
+    }
+  ]
+}

package/resources/locales/de/groups.cmd.json

@@ -0,0 +1,21 @@
+{
+  "$schema": "../../../utils-react/command-catalog.schema.json",
+  "scope": "ui",
+  "label": "Benutzeroberfläche",
+  "tag": "de",
+  "version": 1,
+  "commands": {
+    "customFunctionOptions": {
+      "label": "Benutzerdefiniert",
+      "description": "Eine benutzerdefinierte Funktion einfügen."
+    },
+    "scriptEditor": {
+      "label": "Skript (TypeScript)",
+      "icon": "ScriptRun"
+    },
+    "scriptsOptions": {
+      "label": "Makros",
+      "description": "Makros ausführen oder verwalten."
+    }
+  }
+}

package/resources/locales/de/scriptEditor.cmd.json

@@ -0,0 +1,36 @@
+{
+  "$schema": "../../../utils-react/command-catalog.schema.json",
+  "scope": "scriptEditor",
+  "label": "Skript-Editor",
+  "tag": "de",
+  "version": 1,
+  "commands": {
+    "scriptingHelp": {
+      "label": "Skripting-Hilfe",
+      "groupLabels": {
+        "scriptsOptions": "Hilfe"
+      },
+      "description": "Die Dokumentation zum Skripting öffnen.",
+      "icon": "Help"
+    },
+    "showScriptingCommands": {
+      "label": "Skript-Befehlspalette",
+      "groupLabels": {
+        "scriptsOptions": "Befehlspalette"
+      },
+      "description": "Befehle für Skripting anzeigen.",
+      "icon": "Keyboard",
+      "shortcut": "F1"
+    },
+    "insertScript": {
+      "label": "Skript einfügen",
+      "description": "Ein Skript aus einer Reihe von Vorlagen einfügen.",
+      "icon": "ScriptInsert"
+    },
+    "saveScripts": {
+      "label": "Skript speichern",
+      "description": "Die aktuellen Skripte speichern.",
+      "icon": "ScriptSave"
+    }
+  }
+}

package/resources/locales/de/ui.msg.json

@@ -0,0 +1,8 @@
+{
+  "reason.noChangesToSave": "Keine Änderungen zum Speichern",
+  "scriptEditor.glyph.autoRun": "Automatisch ausführen",
+  "scriptEditor.glyph.formula": "Formel",
+  "scriptEditor.glyph.macro": "Makro",
+  "scriptEditor.loading": "Wird geladen...",
+  "scriptEditor.saving": "Skripte werden gespeichert..."
+}

package/resources/locales/de/workbookScript.cmd.json

@@ -0,0 +1,26 @@
+{
+  "$schema": "../../../utils-react/command-catalog.schema.json",
+  "scope": "workbook",
+  "label": "Arbeitsmappe",
+  "tag": "de",
+  "version": 1,
+  "commands": {
+    "showScriptEditor": {
+      "label": "Skripte",
+      "groupLabels": {
+        "scriptsOptions": "Skript-Editor…"
+      },
+      "description": "Den Skript-Editor anzeigen.",
+      "icon": "ScriptRun",
+      "shortcut": [
+        "alt+F11"
+      ]
+    },
+    "executeScript": {
+      "label": "Skript ausführen",
+      "description": "Das zuletzt ausgeführte Skript ausführen.",
+      "icon": "ScriptRun",
+      "shortcut": "F8"
+    }
+  }
+}

package/resources/locales/en/groups.cmd.json

@@ -0,0 +1,21 @@
+{
+  "$schema": "../../../utils-react/command-catalog.schema.json",
+  "scope": "ui",
+  "label": "Interface",
+  "tag": "en",
+  "version": 1,
+  "commands": {
+    "customFunctionOptions": {
+      "label": "Custom",
+      "description": "Insert a custom function."
+    },
+    "scriptEditor": {
+      "label": "Script (Typescript)",
+      "icon": "ScriptRun"
+    },
+    "scriptsOptions": {
+      "label": "Macros",
+      "description": "Run or manage macros."
+    }
+  }
+}

package/resources/locales/en/scriptEditor.cmd.json

@@ -0,0 +1,36 @@
+{
+  "$schema": "../../../utils-react/command-catalog.schema.json",
+  "scope": "scriptEditor",
+  "label": "Script Editor",
+  "tag": "en",
+  "version": 1,
+  "commands": {
+    "scriptingHelp": {
+      "label": "Scripting Help",
+      "description": "Open Documentation For Scripting.",
+      "groupLabels": {
+        "scriptsOptions": "Help"
+      },
+      "icon": "Help"
+    },
+    "showScriptingCommands": {
+      "label": "Scripting Command Palette",
+      "description": "Show commands for scripting.",
+      "groupLabels": {
+        "scriptsOptions": "Command Palette"
+      },
+      "icon": "Keyboard",
+      "shortcut": "F1"
+    },
+    "insertScript": {
+      "label": "Insert Script",
+      "description": "Inserts a script from a set of templates.",
+      "icon": "ScriptInsert"
+    },
+    "saveScripts": {
+      "label": "Save Script",
+      "description": "Save the current scripts.",
+      "icon": "ScriptSave"
+    }
+  }
+}

package/resources/locales/en/ui.msg.json

@@ -0,0 +1,8 @@
+{
+  "reason.noChangesToSave": "No changes to save",
+  "scriptEditor.glyph.autoRun": "Auto Run",
+  "scriptEditor.glyph.formula": "Formula",
+  "scriptEditor.glyph.macro": "Macro",
+  "scriptEditor.loading": "Loading...",
+  "scriptEditor.saving": "Saving Scripts..."
+}

package/resources/locales/en/workbookScript.cmd.json

@@ -0,0 +1,26 @@
+{
+  "$schema": "../../../utils-react/command-catalog.schema.json",
+  "scope": "workbook",
+  "label": "Workbook",
+  "tag": "en",
+  "version": 1,
+  "commands": {
+    "showScriptEditor": {
+      "label": "Scripts",
+      "description": "Show the script editor.",
+      "groupLabels": {
+        "scriptsOptions": "Script Editor…"
+      },
+      "icon": "ScriptRun",
+      "shortcut": [
+        "alt+F11"
+      ]
+    },
+    "executeScript": {
+      "label": "Run Script",
+      "description": "Run the last executed script.",
+      "icon": "ScriptRun",
+      "shortcut": "F8"
+    }
+  }
+}

package/types/index.d.ts

@@ -0,0 +1,2 @@
+export * from './src/index'
+export {}

package/types/src/IScriptEditor.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Used by the Script editor to interface with the repo for the Scripts.
+ *
+ * @remarks
+ * The old `Context` / `ContainerListener` marshalling is gone — the editor reads the live workbook directly
+ * (`useWorkbook`) for ranges/scripts, executes the workbook `insertFunction` command for the fx picker, and
+ * listens to the workbook's own `onBeforeSave`/`onLoad` for the save-flush + reload. What remains is the small
+ * set of editor-facing view types.
+ */
+export declare namespace IScriptEditor {
+    /**
+     * Implemented by the editor to allow for ui interactions.
+     */
+    interface Editor {
+        /**
+         * Closes the editor.
+         * @returns A promise that resolves when the editor is closed.
+         */
+        close: () => Promise<void>;
+    }
+    /**
+     * The current function that is selected.
+     */
+    interface SelectedFunction {
+        /**
+         * The selected function.
+         */
+        name: string;
+        /**
+         * Needed for JIT.
+         */
+        source: string;
+    }
+    /**
+     * Provides status of the editor.
+     */
+    interface Status {
+        /**
+         * The message to display.
+         */
+        message: string;
+        /**
+         * The cursor position.
+         */
+        cursor: string;
+        /**
+         * If the script is unsaved.
+         */
+        dirty: boolean;
+    }
+}
+//# sourceMappingURL=IScriptEditor.d.ts.map

package/types/src/IScriptEditor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IScriptEditor.d.ts","sourceRoot":"","sources":["../../../src/IScriptEditor.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,yBAAiB,aAAa,CAAC;IAC7B;;OAEG;IACH,UAAiB,MAAM;QACrB;;;WAGG;QACH,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;KAC5B;IAED;;OAEG;IAEH,UAAiB,gBAAgB;QAC/B;;WAEG;QACH,IAAI,EAAE,MAAM,CAAC;QACb;;WAEG;QACH,MAAM,EAAE,MAAM,CAAA;KACf;IAED;;OAEG;IACH,UAAiB,MAAM;QACrB;;WAEG;QACH,OAAO,EAAE,MAAM,CAAC;QAChB;;WAEG;QACH,MAAM,EAAE,MAAM,CAAC;QACf;;WAEG;QACH,KAAK,EAAE,OAAO,CAAC;KAGhB;CACF"}

package/types/src/MonacoOptions.d.ts

@@ -0,0 +1,68 @@
+declare const _default: {
+    lightbulb: {
+        enabled: boolean;
+    };
+    tabSize: number;
+    acceptSuggestionOnCommitCharacter: boolean;
+    acceptSuggestionOnEnter: string;
+    accessibilitySupport: string;
+    automaticLayout: boolean;
+    autoIndent: boolean;
+    codeLens: boolean;
+    colorDecorators: boolean;
+    contextmenu: boolean;
+    cursorBlinking: string;
+    cursorSmoothCaretAnimation: boolean;
+    cursorStyle: string;
+    disableLayerHinting: boolean;
+    disableMonospaceOptimizations: boolean;
+    dragAndDrop: boolean;
+    glyphMargin: boolean;
+    fixedOverflowWidgets: boolean;
+    folding: boolean;
+    foldingStrategy: string;
+    fontLigatures: boolean;
+    formatOnPaste: boolean;
+    formatOnType: boolean;
+    hideCursorInOverviewRuler: boolean;
+    highlightActiveIndentGuide: boolean;
+    links: boolean;
+    lineDecorationsWidth: number;
+    lineNumbersMinChars: number;
+    mouseWheelZoom: boolean;
+    multiCursorMergeOverlapping: boolean;
+    multiCursorModifier: string;
+    overviewRulerBorder: boolean;
+    overviewRulerLanes: number;
+    quickSuggestions: boolean;
+    quickSuggestionsDelay: number;
+    readOnly: boolean;
+    renderControlCharacters: boolean;
+    renderFinalNewline: boolean;
+    renderIndentGuides: boolean;
+    renderLineHighlight: string;
+    renderWhitespace: string;
+    revealHorizontalRightPadding: number;
+    roundedSelection: boolean;
+    rulers: never[];
+    scrollBeyondLastColumn: number;
+    scrollBeyondLastLine: boolean;
+    selectOnLineNumbers: boolean;
+    selectionClipboard: boolean;
+    selectionHighlight: boolean;
+    showLightbulbIconMode: boolean;
+    showFoldingControls: string;
+    smoothScrolling: boolean;
+    suggestOnTriggerCharacters: boolean;
+    wordBasedSuggestions: boolean;
+    wordSeparators: string;
+    wordWrap: string;
+    wordWrapBreakAfterCharacters: string;
+    wordWrapBreakBeforeCharacters: string;
+    wordWrapBreakObtrusiveCharacters: string;
+    wordWrapColumn: number;
+    wordWrapMinified: boolean;
+    wrappingIndent: string;
+};
+export default _default;
+//# sourceMappingURL=MonacoOptions.d.ts.map

package/types/src/MonacoOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MonacoOptions.d.ts","sourceRoot":"","sources":["../../../src/MonacoOptions.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEA,wBAiEC"}

package/types/src/ScriptEditor.d.ts

@@ -0,0 +1,73 @@
+import { default as React } from 'react';
+import { IScript } from '@sheetxl/sdk';
+import { IFrame } from '@sheetxl/react';
+import { IScriptEditor } from './IScriptEditor';
+/**
+ * Move this to another project. Automation-Editor
+ */
+export interface ScriptEditorProps extends React.HTMLAttributes<HTMLElement> {
+    /**
+     * If the values can be modified
+     */
+    readOnly?: boolean;
+    /**
+     * Handle to the frame
+     */
+    frame?: IFrame;
+    /**
+     * The script collection to edit.
+     */
+    scripts: IScript;
+    /**
+     * Allows for component to be autoFocused.
+     */
+    /**
+     * If provided then a custom loading panel will be used.
+     */
+    loadingPanel?: React.ReactElement;
+    /**
+     * Called for status change events.
+     */
+    onStatusChange?: (status: Partial<IScriptEditor.Status>) => void;
+    /**
+     * Monaco theme
+     */
+    darkMode?: boolean;
+}
+export interface ScriptEditorAttributes {
+    insertSnippet(snippet: string): Promise<void>;
+    showCommandPalette(): void;
+    getScripts(): IScript;
+    saveSource(): Promise<void>;
+    isScriptEditorElement(): true;
+    close(): Promise<void>;
+    /**
+     * Run a Monaco editor action by id (e.g. `editor.action.selectAll`). The editor owns its own
+     * selection, so `selectAll` routes here rather than through the generic input-clipboard injector.
+     * No-op until the editor has mounted. **Not for clipboard** — see {@link copy}/{@link cut}/{@link paste}.
+     */
+    runAction(actionId: string): void;
+    /**
+     * Clipboard, model-based (focus-independent, so they also work from the context menu, and paste is a
+     * single undo). No-op until the editor has mounted. These are what the editor's `copy`/`cut`/`paste`
+     * commands and its context-menu items call — NOT Monaco's built-in clipboard actions, which depend on
+     * editor focus and so fail from the (focus-stealing) context menu.
+     */
+    copy(): Promise<void>;
+    cut(): Promise<void>;
+    paste(): Promise<void>;
+}
+/**
+ * Type returned via ref property
+ */
+export interface IScriptEditorElement extends ScriptEditorAttributes, HTMLDivElement {
+}
+export type ScriptEditorAttribute = {
+    ref?: React.Ref<IScriptEditorElement>;
+};
+/**
+ * This tracks the selection of the sheet and
+ * updates the a named range editor and a sheet cell editor.
+ */
+export declare const ScriptEditor: React.FC<ScriptEditorProps & ScriptEditorAttribute>;
+//# sourceMappingURL=ScriptEditor.d.ts.map

package/types/src/ScriptEditor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScriptEditor.d.ts","sourceRoot":"","sources":["../../../src/ScriptEditor.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAa/B,OAAO,EAAkB,KAAK,OAAO,EAAkD,MAAM,cAAc,CAAC;AAK5G,OAAO,EAAiC,KAAK,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAI5E,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAmDrD;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,KAAK,CAAC,cAAc,CAAC,WAAW,CAAC;IAC1E;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB;;OAEG;IAEH;;OAEG;IACH,YAAY,CAAC,EAAE,KAAK,CAAC,YAAY,CAAC;IAClC;;OAEG;IACH,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC;IACjE;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAGD,MAAM,WAAW,sBAAsB;IACrC,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,kBAAkB,IAAI,IAAI,CAAC;IAC3B,UAAU,IAAI,OAAO,CAAC;IACtB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,qBAAqB,IAAI,IAAI,CAAC;IAC9B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB;;;;OAIG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC;;;;;OAKG;IACH,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACrB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,sBAAsB,EAAE,cAAc;CAAG;AAEvF,MAAM,MAAM,qBAAqB,GAAG;IAClC,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;CACvC,CAAC;AAi0BF;;;GAGG;AACH,eAAO,MAAM,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC,iBAAiB,GAAG,qBAAqB,CAqtB5E,CAAC"}

package/types/src/ScriptEditorCommands.d.ts

@@ -0,0 +1,23 @@
+import { Command } from '@sheetxl/utils-react';
+import { IScriptEditorElement } from './ScriptEditor';
+export interface ContributeScriptEditorCommandsOptions {
+    /** Whether the editor has unsaved changes — gates `saveScripts`. */
+    isDirty?: boolean;
+}
+/**
+ * Contribute the script-editor commands (help / command palette / insert-snippet / save) into a
+ * command scope, wired **directly to the live editor handle**. The replacement for
+ * `useScriptCommands`' `CommandGroup`.
+ *
+ * @remarks
+ * Because the definition is contributed *where the editor handle lives* and resolved via the shared
+ * scope, the old `IScriptEditor.Context` marshalling is unnecessary for these commands — the toolbar
+ * (above the editor, same resolver) resolves them straight off the scope. Idempotent: re-call to refresh
+ * `saveScripts`' enabled state when `isDirty` changes.
+ */
+/** The single `data` bundle {@link contributeScriptEditorCommands} takes (the `DynamicCommandContributor` shape). */
+export interface ScriptEditorCommandData extends ContributeScriptEditorCommandsOptions {
+    scriptEditor: IScriptEditorElement;
+}
+export declare function contributeScriptEditorCommands(contribution: Command.CommandContribution, data: ScriptEditorCommandData): void;
+//# sourceMappingURL=ScriptEditorCommands.d.ts.map

package/types/src/ScriptEditorCommands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScriptEditorCommands.d.ts","sourceRoot":"","sources":["../../../src/ScriptEditorCommands.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAEpD,OAAO,EAAE,KAAK,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAE3D,MAAM,WAAW,qCAAqC;IACpD,oEAAoE;IACpE,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;;;;GAUG;AACH,qHAAqH;AACrH,MAAM,WAAW,uBAAwB,SAAQ,qCAAqC;IACpF,YAAY,EAAE,oBAAoB,CAAC;CACpC;AACD,wBAAgB,8BAA8B,CAC5C,YAAY,EAAE,OAAO,CAAC,mBAAmB,EACzC,IAAI,EAAE,uBAAuB,GAC5B,IAAI,CAuCN"}

package/types/src/ScriptEditorOpener.d.ts

@@ -0,0 +1,33 @@
+import { IWorkbook } from '@sheetxl/sdk';
+/**
+ * Details passed to a {@link ScriptEditorOpener} when the user invokes `showScriptEditor`.
+ */
+export interface ScriptEditorOpenRequest {
+    /**
+     * The workbook whose script should be edited.
+     */
+    workbook: IWorkbook;
+}
+/**
+ * Opens the script editor for a workbook.
+ *
+ * @remarks
+ * When registered via {@link setScriptEditorOpener}, this fully owns the `showScriptEditor` action -
+ * the default in-app behavior (toggling the `scriptEditor` task pane) is skipped. A host that edits
+ * scripts elsewhere (e.g. the VS Code extension opening a native editor) registers one of these.
+ */
+export type ScriptEditorOpener = (request: ScriptEditorOpenRequest) => void;
+/**
+ * Registers (or clears, with `null`) the global script-editor opener.
+ *
+ * @remarks
+ * A single opener is supported; the last registration wins. This is a host-level override, set once
+ * during application startup.
+ */
+export declare const setScriptEditorOpener: (opener: ScriptEditorOpener | null) => void;
+/**
+ * Returns the registered {@link ScriptEditorOpener}, or `null` if none is set (use the default
+ * in-app task-pane behavior).
+ */
+export declare const getScriptEditorOpener: () => ScriptEditorOpener | null;
+//# sourceMappingURL=ScriptEditorOpener.d.ts.map

package/types/src/ScriptEditorOpener.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScriptEditorOpener.d.ts","sourceRoot":"","sources":["../../../src/ScriptEditorOpener.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,EAAE,uBAAuB,KAAK,IAAI,CAAC;AAI5E;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,GAAI,QAAQ,kBAAkB,GAAG,IAAI,KAAG,IAEzE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,QAAO,kBAAkB,GAAG,IAE7D,CAAC"}

package/types/src/ScriptingReactPlugin.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Registers the scripting task pane (`scriptEditor`) into the {@link DefaultTaskPaneRegistry}.
+ *
+ * @remarks
+ * Call once during application startup. This is the lightweight registration that ships the bare
+ * {@link ScriptEditor}; it is intentionally MUI free so it can be used by non-studio hosts.
+ */
+export declare const ScriptingReactPlugin: () => void;
+//# sourceMappingURL=ScriptingReactPlugin.d.ts.map

package/types/src/ScriptingReactPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScriptingReactPlugin.d.ts","sourceRoot":"","sources":["../../../src/ScriptingReactPlugin.tsx"],"names":[],"mappings":"AAoCA;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,QAAO,IA+BvC,CAAC"}

package/types/src/WorkbookScriptCommands.d.ts

@@ -0,0 +1,18 @@
+import { CommandContributionComponentProps } from '@sheetxl/utils-react';
+import { WorkbookCommandContributorData } from '@sheetxl/react';
+/**
+ * Wires the workbook-level scripting commands' behavior — `executeScript` (run a macro) and
+ * `showScriptEditor` (toggle the task pane) — onto the per-workbook `workbook` scope, and starts the script
+ * engine on workbook load.
+ *
+ * @remarks
+ * The editor no longer needs a pushed-in `IScriptEditor.Context`: it reads the live workbook via `useWorkbook`
+ * (ranges/scripts), executes the workbook `insertFunction` command for the fx picker, and listens to the
+ * workbook's own `onBeforeSave` to flush its source. So this component contributes plain callbacks — no context
+ * marshalling.
+ *
+ * `showScriptEditor` defers to a registered {@link ScriptEditorOpener} when present (e.g. the VS Code
+ * host opens a native editor); otherwise it toggles the in-app `scriptEditor` task pane.
+ */
+export declare const WorkbookScriptCommands: import('react').MemoExoticComponent<(props: CommandContributionComponentProps<WorkbookCommandContributorData>) => null>;
+//# sourceMappingURL=WorkbookScriptCommands.d.ts.map

package/types/src/WorkbookScriptCommands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkbookScriptCommands.d.ts","sourceRoot":"","sources":["../../../src/WorkbookScriptCommands.tsx"],"names":[],"mappings":"AAMA,OAAO,EAC6C,KAAK,iCAAiC,EACzF,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAC8B,KAAK,8BAA8B,EACvE,MAAM,gBAAgB,CAAC;AAIxB;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,sBAAsB,8CAAgB,iCAAiC,CAAC,8BAA8B,CAAC,UAmFlH,CAAC"}