@sheetxl/scripting-react 0.8.0-beta.6 → 0.8.0-beta.7

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@sheetxl/scripting-react",
   "description": "Scripting React - Monaco based script editor and scripting UI for SheetXL.",
-  "version": "0.8.0-beta.6",
+  "version": "0.8.0-beta.7",
   "license": "SEE LICENSE IN <LICENSE>",
   "type": "module",
   "exports": {
@@ -41,12 +41,13 @@
   ],
   "dependencies": {
     "@monaco-editor/react": "^4.7.0",
-    "@sheetxl/react": "^0.8.0-beta.6",
-    "@sheetxl/scripting": "^0.8.0-beta.6",
-    "@sheetxl/sdk": "^0.8.0-beta.6",
-    "@sheetxl/utils": "^0.8.0-beta.6",
-    "@sheetxl/utils-react": "^0.8.0-beta.6",
+    "@sheetxl/react": "^0.8.0-beta.7",
+    "@sheetxl/scripting": "^0.8.0-beta.7",
+    "@sheetxl/sdk": "^0.8.0-beta.7",
+    "@sheetxl/utils": "^0.8.0-beta.7",
+    "@sheetxl/utils-react": "^0.8.0-beta.7",
     "clsx": "^2.1.1",
+    "monaco-editor": "~0.55.1",
     "monaco-editor-auto-typings": "^0.4.6",
     "path-browserify": "^1.0.1",
     "react-merge-refs": "^3.0.2"

package/types/src/mergeImports.d.ts

@@ -0,0 +1,64 @@
+/**
+ * A single `import` statement from the leading import block of a script.
+ */
+export interface ImportStatement {
+    /** Offset of the `import` keyword. */
+    start: number;
+    /** Offset just past the statement, including its `;` when it has one. */
+    end: number;
+    /** The statement as written. */
+    text: string;
+    /** The module specifier, unquoted. */
+    module: string;
+    /** The quote character the module specifier was written with. */
+    quote: string;
+    /** Whether this is an `import type` statement. */
+    typeOnly: boolean;
+    /** A default or namespace binding (`Foo`, `* as Foo`), or `''`. */
+    binding: string;
+    /** The specifiers between the braces, whitespace-normalized; `null` when there are no braces. */
+    names: string[] | null;
+    /** Offset just past the `{`. Only meaningful when {@link names} is not `null`. */
+    namesStart: number;
+    /** Offset of the `}`. Only meaningful when {@link names} is not `null`. */
+    namesEnd: number;
+}
+export interface ImportInsert {
+    /** Offset into the existing source. */
+    offset: number;
+    text: string;
+}
+export interface MergedImports {
+    /** The snippet with its import statements removed. */
+    body: string;
+    /** Insertions into the existing source that bring in whatever the snippet imports, by ascending offset. */
+    inserts: ImportInsert[];
+    /** Offset just past the existing source's last leading import, or `0` if it has none. */
+    importsEnd: number;
+}
+/**
+ * Reads the leading import block of a script.
+ *
+ * @remarks
+ * Only the leading block is read: whitespace and comments are skipped and the scan stops at the
+ * first thing that is not an import statement. Text further down is never inspected, so an
+ * `import` inside a string, a comment, or a template literal cannot be mistaken for one.
+ */
+export declare const scanImports: (source: string) => ImportStatement[];
+/**
+ * Separates a snippet's imports from its body and works out how to fold them into a script that
+ * may already import some of the same things.
+ *
+ * @remarks
+ * Named imports (`import { A, B } from 'm'`) merge per name: a name the script already imports
+ * from that module is dropped, and the rest join the script's existing import of that module, or
+ * become a new statement after its last import when it has none. `import type` statements are
+ * merged among themselves, and a type the script already imports as a value is dropped.
+ *
+ * Any other form (default, namespace, side-effect) is added whole unless the script already has
+ * the same statement.
+ *
+ * A name that is already bound to a different module is not detected.
+ */
+export declare const mergeImports: (source: string, snippet: string) => MergedImports;
+//# sourceMappingURL=mergeImports.d.ts.map