@sheetxl/scripting 0.7.27 → 0.7.28-beta.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (83) hide show
  1. package/README.md +206 -247
  2. package/browser/cjs/1_xhnTjP6m5oj6za.cjs +21 -0
  3. package/browser/cjs/Bu4cZ8iSZ3rij-oV.cjs +1 -0
  4. package/browser/cjs/BvG8N7G_8CXIAlT-.cjs +1 -0
  5. package/browser/cjs/C_7w8EJZpHw8ueuq.cjs +1 -0
  6. package/browser/cjs/C_IEgjM-hSJCv6Gm.cjs +1 -0
  7. package/browser/cjs/CctaCN_w3o34V9AR.cjs +1 -0
  8. package/browser/cjs/DSEShe7kGtxvljOr.cjs +1 -0
  9. package/browser/cjs/btgKzY3qMXIaaNlB.cjs +1 -0
  10. package/browser/cjs/g7NzVvjLm_oCf_dd.cjs +1 -0
  11. package/browser/cjs/index.cjs +1 -6
  12. package/browser/cjs/qWYyYsBboXc9p0Lw.cjs +7 -0
  13. package/browser/esm/3M5kvBOeC9dO1anl.mjs +12 -0
  14. package/browser/esm/BO33MdJ1knSwnDFc.mjs +421 -0
  15. package/browser/esm/Buk8t7jbvkBl210h.mjs +25 -0
  16. package/browser/esm/DEMLy75ghnJrOdbg.mjs +23 -0
  17. package/browser/esm/D_RaFJ9L6p0FWrsc.mjs +87 -0
  18. package/browser/esm/DkclmJ-rIJcNsfWQ.mjs +27 -0
  19. package/browser/esm/DqlXZuvMsFv7k9Op.mjs +105 -0
  20. package/browser/esm/S3dk0h6UOMvLEQYW.mjs +152 -0
  21. package/browser/esm/SJ37xnNH-b4AhQOe.mjs +8 -0
  22. package/browser/esm/index.mjs +40 -20
  23. package/browser/esm/xhrsKI0xcttmWNAI.mjs +15 -0
  24. package/node/esm/BvEpRtUTq_sFtAnk.mjs +421 -0
  25. package/node/esm/BzB380N0KvPvx3Va.mjs +23 -0
  26. package/node/esm/CYHVS16ZrqxOoRVQ.mjs +17 -0
  27. package/node/esm/CcqVU5-hFGk6MS45.mjs +27 -0
  28. package/node/esm/DBuGDPGKGMJGN0-R.mjs +12 -0
  29. package/node/esm/Dx2TL-2TFdOTGPZo.mjs +14 -0
  30. package/node/esm/SJ37xnNH-b4AhQOe.mjs +8 -0
  31. package/node/esm/fVQ1ZTi1igB3_IOU.mjs +152 -0
  32. package/node/esm/index.mjs +144 -20
  33. package/package.json +11 -8
  34. package/types/index.d.ts +2 -165
  35. package/types/src/ScriptCompiler.d.ts +40 -0
  36. package/types/src/compiler/Bundler.d.ts +7 -0
  37. package/types/src/compiler/TypescriptCompiler.d.ts +27 -0
  38. package/types/src/compiler/TypescriptCompiler.impl.d.ts +17 -0
  39. package/types/src/compiler/TypescriptCompiler.worker.d.ts +2 -0
  40. package/types/src/compiler/compiler.browser.d.ts +8 -0
  41. package/types/src/compiler/compiler.node.d.ts +14 -0
  42. package/types/src/compiler/constants.d.ts +10 -0
  43. package/types/src/compiler/insertYieldBetweenStatements.d.ts +5 -0
  44. package/types/src/compiler/transformAwaitToYield.d.ts +6 -0
  45. package/types/src/index.d.ts +7 -0
  46. package/types/src/lib/esbuild/esbuild.browser.d.ts +4 -0
  47. package/types/src/lib/esbuild/esbuild.node.d.ts +11 -0
  48. package/types/src/lib/typescript/typescript.browser.d.ts +4 -0
  49. package/types/src/lib/typescript/typescript.node.d.ts +4 -0
  50. package/types/src/linter/Linter.d.ts +63 -0
  51. package/types/src/linter/index.d.ts +2 -0
  52. package/types/src/loader/index.d.ts +2 -0
  53. package/types/src/loader/loadCompiledModule.d.ts +19 -0
  54. package/types/src/loader/moduleLoader.browser.d.ts +11 -0
  55. package/types/src/loader/moduleLoader.node.d.ts +15 -0
  56. package/types/src/plugin/generate.d.ts +17 -0
  57. package/types/src/plugin/vite.d.ts +24 -0
  58. package/types/src/runtime/Constants.d.ts +9 -0
  59. package/types/src/runtime/index.d.ts +2 -0
  60. package/types/src/tags/DocTags.d.ts +46 -0
  61. package/types/src/tags/index.d.ts +2 -0
  62. package/types/src/type/CompileOptions.d.ts +58 -0
  63. package/types/src/type/CompiledModule.d.ts +70 -0
  64. package/types/src/type/Diagnostic.d.ts +120 -0
  65. package/types/src/type/Types.d.ts +72 -0
  66. package/types/src/type/index.d.ts +6 -0
  67. package/types/src/worker/WorkerWrapper.d.ts +44 -0
  68. package/types/src/worker/index.d.ts +2 -0
  69. package/browser/cjs/B4lAANRqTGnvOqGs.cjs +0 -1518
  70. package/browser/cjs/BRnBwa7X_-2hZkPR.cjs +0 -6
  71. package/browser/cjs/BgmE5dDR60P-0D05.cjs +0 -6
  72. package/browser/cjs/C6FgXFuZyUBSYx74.cjs +0 -6
  73. package/browser/cjs/Cmsp48m0ZoKEApI_.cjs +0 -32
  74. package/browser/esm/BCtqf7TlVX2XI9Sk.mjs +0 -29
  75. package/browser/esm/BUrlmQqFvt49Snxt.mjs +0 -1593
  76. package/browser/esm/BeDi9Rjq6Mj_zC_O.mjs +0 -24
  77. package/browser/esm/C1nmZG6Nh598I5Cy.mjs +0 -266
  78. package/browser/esm/C9oTtQ5kcPvveo9r.mjs +0 -21
  79. package/node/esm/B8mFYKKfM-fFEqr4.mjs +0 -1593
  80. package/node/esm/D3tC0pmcUWYhM3aH.mjs +0 -14
  81. package/node/esm/DUk3E5XxCEk6dBja.mjs +0 -16
  82. package/node/esm/Db6wgeAGcGPbeesO.mjs +0 -266
  83. package/node/esm/YSXanagcUr6QMDaF.mjs +0 -29
@@ -1,6 +0,0 @@
1
- "use strict";/**
2
- * @license @sheetxl/scripting - Scripting - Scripting engine for Macros and formulas; includes TypeScript and EsBuild. - v0.7.27
3
- *
4
- * (C) 2025-present SheetXL Inc. & Michael T. Ford
5
- * License: The license can be found at https://www.sheetxl.com/license.
6
- */Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});exports.TypeScriptCompiler=class{constructor(r={}){this.workerWrapper=null}async getWorkerWrapper(){if(this.workerWrapper)return this.workerWrapper;const{createCompilerWorker:r}=await Promise.resolve().then(()=>require("./B4lAANRqTGnvOqGs.cjs"));return this.workerWrapper=await r(),this.workerWrapper}async compileModule(r){try{return(await this.getWorkerWrapper()).execute(r)}catch(e){throw console.error("Failed to compile using worker:",e),e}}terminate(){this.workerWrapper?.terminate(),this.workerWrapper=null}};
@@ -1,6 +0,0 @@
1
- "use strict";/**
2
- * @license @sheetxl/scripting - Scripting - Scripting engine for Macros and formulas; includes TypeScript and EsBuild. - v0.7.27
3
- *
4
- * (C) 2025-present SheetXL Inc. & Michael T. Ford
5
- * License: The license can be found at https://www.sheetxl.com/license.
6
- */Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});let e=null;exports.initialize=async function(){return e||(e=new Promise(async(s,r)=>{try{const i="0.20.2",a=`https://esm.sh/esbuild-wasm@${i}`,l=`https://esm.sh/esbuild-wasm@${i}/esbuild.wasm`,t=(await import(a)).default;await t.initialize({wasmURL:l,worker:!1}),s(t)}catch(i){console.error("Error initializing esbuild:",i),r(i)}}),e)};
@@ -1,6 +0,0 @@
1
- "use strict";/**
2
- * @license @sheetxl/scripting - Scripting - Scripting engine for Macros and formulas; includes TypeScript and EsBuild. - v0.7.27
3
- *
4
- * (C) 2025-present SheetXL Inc. & Michael T. Ford
5
- * License: The license can be found at https://www.sheetxl.com/license.
6
- */Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});let e=null;exports.initialize=async function(){return e||(e=new Promise(async(i,l)=>{let t=null;try{t=await import("https://esm.sh/typescript@5.7.2")}catch(r){console.error("Error initializing Browser TypeScript module:",r)}t||console.log("use script fallback"),i(t)}),e)};
@@ -1,32 +0,0 @@
1
- "use strict";/**
2
- * @license @sheetxl/scripting - Scripting - Scripting engine for Macros and formulas; includes TypeScript and EsBuild. - v0.7.27
3
- *
4
- * (C) 2025-present SheetXL Inc. & Michael T. Ford
5
- * License: The license can be found at https://www.sheetxl.com/license.
6
- */Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const F=require("@sheetxl/primitives"),le=require("@sheetxl/utils");let L=null,q=null;const se={compilerOptions:{target:"esnext"}};async function ce(h,x,b="/script.js",w="__SHEETXL"){try{const K=await(async function(){if(L)return L;if(q){if(await q,!L)throw new Error("ESBuild initialization promise resolved, but instance is not available.");return L}let p,T;q=new Promise((a,S)=>{p=a,T=S});try{const{initialize:a}=await Promise.resolve().then(()=>require("./BgmE5dDR60P-0D05.cjs"));return L=await a(),p(),L}catch(a){throw console.error("Failed to import or initialize esbuild:",a),q=null,T(a),a}})(),O="@sheetxl/primitives",n=`
7
- export const FormulaContext = globalThis.${w}?.FormulaContext;
8
- export const ScalarType = globalThis.${w}?.ScalarType;
9
- export const Observable = globalThis.${w}?.Observable;
10
- export const IRange = globalThis.${w}?.IRange;
11
- export const FormulaError = globalThis.${w}?.FormulaError;
12
- // Add more exports as needed
13
- `,C={name:"sheetxl-esbuild-in-memory",setup(p){const T="sheetxl-"+new Date().getTime();p.onResolve({filter:new RegExp(`^(${b.replace("/","\\/")}|${O})$`)},a=>({path:a.path,namespace:T})),p.onResolve({filter:/.*/},a=>{if(a.namespace!==T)return console.warn(`esbuild: Treating import "${a.path}" as external.`),{path:a.path,external:!0}}),p.onLoad({filter:/.*/,namespace:T},a=>{let S;if(a.path===b)S=x;else{if(a.path!==O)return{errors:[{text:`Cannot load unknown path in ${T}: ${a.path}`}]};S=n}return{contents:S,loader:"ts"}})}},y=await K.build({entryPoints:[b],bundle:!0,write:!1,format:"esm",plugins:[C],sourcemap:"inline",tsconfigRaw:se,minify:!0,platform:"neutral"});if(y.outputFiles&&y.outputFiles.length>0)return y.outputFiles[0].text;throw y.errors&&y.errors.length>0?new Error(`esbuild bundling failed: ${y.errors.map(p=>p.text).join(`
14
- `)}`):new Error("esbuild did not produce an output file.")}catch(K){throw console.error("esbuild bundling process failed:",K),K}}const de=async()=>`
15
- interface FirstTest {
16
- isTrue?: boolean;
17
- }
18
- `,ee=new Map([["IReferenceRange","r"],["IRange","l"]]),te=new Map([["IWorkbook","workbook"],["ISheet","sheet"],["ICellRanges","ranges"],["ICellRange","range"],["IFormulaContext","context"]]),X=(h,x)=>{Array.from(x.keys()).forEach(b=>{const w=x.get(b);x.set(`${h}.${b}`,w)})},ue=new Map([["Scalar","*"],["FormulaError.Known",F.ScalarType.Error],["Date","Date"],["JSON","JSON"]]),pe=new Map([]),_="SheetXL";X(_,ee),X(_,te),X(_,pe);const me=new Map([["Promise",()=>({async:!0})],["Observable",()=>({stream:!0})]]);let B=null;async function fe(){if(B)return B;try{return await(await Promise.resolve().then(()=>require("./C6FgXFuZyUBSYx74.cjs"))).initialize()}catch(h){throw B=null,h}finally{B=null}}exports.compileModule=async function(h){const x=h?.source??null;if(!x)return null;const b=(h.disableBundle||h.declarationsOnly)??!1,w=[de(),fe()],K=await Promise.all(w),O=K[0],n=K[1];let C="",y=null;const p=[],T={allowJs:!0,declaration:!1,sourceMap:!1,inlineSourceMap:!1,inlineSources:!1,isolatedModules:!0,preserveConstEnums:!1,module:99,noResolve:!0,emitDeclarationOnly:!1,target:n.ScriptTarget.ES2020},a="script",S=`${a}.ts`,H="lib.d.ts",W="global.d.ts",M={[S]:x,[H]:`
19
- /**
20
- * Represents the completion of an asynchronous operation
21
- */
22
- interface Promise<T> {
23
- /**
24
- * Attaches a callback that is invoked when the Promise is settled (fulfilled or rejected). The
25
- * resolved value cannot be modified from the callback.
26
- * @param onfinally The callback to execute when the Promise is settled (fulfilled or rejected).
27
- * @returns A Promise for the completion of the callback.
28
- */
29
- finally(onfinally?: (() => void) | undefined | null): Promise<T>;
30
- }
31
- `,[W]:O},ne={getSourceFile:(e,t,u,m)=>n.createSourceFile(e,M[e],n.ScriptTarget.Latest,!0),fileExists:e=>M[e]!==void 0,readFile:e=>M[e],writeFile:(e,t)=>{M[e]=t},getCurrentDirectory:()=>"./",getCanonicalFileName:e=>e,useCaseSensitiveFileNames:()=>!0,getDefaultLibFileName:e=>H,getNewLine:()=>`
32
- `},J=n.createProgram([S,W],T,ne),A=J.getTypeChecker(),re=J.getSourceFile(S),G=J.emit();G.diagnostics.length>0&&console.warn(G.diagnostics),C=M[`${a}.js`];const I=(e,t,u,m)=>{if(e){if(e.kind===n.SyntaxKind.NumberKeyword)t.scalar=F.ScalarType.Number;else if(e.kind===n.SyntaxKind.StringKeyword)t.scalar=F.ScalarType.String;else if(e.kind===n.SyntaxKind.BooleanKeyword)t.scalar=F.ScalarType.Boolean;else if(e.kind===n.SyntaxKind.UndefinedKeyword||e.kind===n.SyntaxKind.NullKeyword||e.kind===n.SyntaxKind.VoidKeyword){if(m)return void k(e,new Error(`'undefined' is not a valid type for input: '${e?.parent?.name?.escapedText}'.`));t.scalar=F.ScalarType.Null}else if(e.kind===n.SyntaxKind.BigIntKeyword)t.scalar=F.ScalarType.Number;else if(e.kind===n.SyntaxKind.AnyKeyword)t.scalar=F.ScalarType.Null;else if(e.kind===n.SyntaxKind.ArrayType){const o=e.elementType;if(!o)return void k(e,new Error(`'Array' must be typed: '${e?.parent?.name?.escapedText}'.`));t.arrayDepth=(t.arrayDepth??0)+1,I(o,t,u,m)}else if(e.kind!==n.SyntaxKind.TupleType){if(e.kind===n.SyntaxKind.TypeReference){const o=e.typeName?.getText?.()??null,R=ee.get(o);let E=!1;R&&(t.range=R,E=!0);const D=ue.get(o);if(D&&(t.scalar=D),D!==void 0&&(E=!0),m){const r=te.get(o);if(r)return r}else{const r=me.get(o);if(r){const l={...t,...r()};let g=0;if(l.async&&g++,l.stream&&g++,g>1)return void k(e,new Error(`'${o}' cannot have multiple modifiers: '${e?.parent?.name?.escapedText}'.`));t=l,E=!0}}if(!E)return void k("node",new Error(`'${o}' is not a valid type: '${e?.parent?.name?.escapedText}'.`));const c=e.typeArguments;if(c){if(c.length!==1)return void k(e,new Error(`'${o}' must be typed with exactly 1 type: '${e?.parent?.name?.escapedText}'.`));I(c[0],t,u,m)}}}}else k(e,new Error(`Type is not defined for '${t?.name??"return"}'.`))},z=[],k=(e,t)=>{z.push(t)};if(n.forEachChild(re,e=>{if((t=>(n.getCombinedModifierFlags(t)&n.ModifierFlags.Export)!==0)(e)&&n.isFunctionDeclaration(e)){const t={},u={parameters:{}},m=e?.name?.getText();try{t.name=m;const o=A.getSymbolAtLocation(e.name).getDocumentationComment(A);if(o&&o.length>0&&o[0].text){let c=o[0].text;c=c.replace(/[\r\n]+/g,"\\n").trim(),u.summary=c}const R={};I(e.type,R,t,!1),t.returnType=R;const E={};(c=>(n.getCombinedModifierFlags(c)&n.ModifierFlags.Default)!==0)(e)&&(E.default=!0,y=m),Object.keys(E).length>0&&(t.behavior=E),t.parameters=[];const D=new Map;for(let c=0;c<e.parameters.length;c++){const r=e.parameters[c],l={};l.name=r.name?.getText();const g=I(r.type,l,t,!0);if(g){if(t.parameters.length!==0){const s=e?.parent,i=s?.name?.getText();return void k(e,new Error(`'${t.name}' contexts must be the first parameter: '${i}'.`))}t.context=g;continue}let P;if((r.initializer!==void 0&&r.initializer!==null||r.questionToken!==void 0&&r.questionToken!==null)&&(l.optional=!0,r.initializer))try{P=r.initializer.kind===n.SyntaxKind.StringLiteral?r.initializer.text:r.initializer.kind===n.SyntaxKind.NumericLiteral?parseFloat(r.initializer.text):r.initializer.kind===n.SyntaxKind.TrueKeyword||r.initializer.kind===n.SyntaxKind.FalseKeyword?r.initializer.kind===n.SyntaxKind.TrueKeyword:r.initializer.kind===n.SyntaxKind.NullKeyword?null:r.initializer.kind===n.SyntaxKind.ObjectLiteralExpression||r.initializer.kind===n.SyntaxKind.ArrayLiteralExpression?r.initializer.getText():r.initializer.getText?.()}catch(s){console.warn(`Couldn't extract default value for parameter '${l.name}'`,s)}r.dotDotDotToken&&(l.rest=!0),t.parameters.push(l);const $={description:""};u.parameters[l.name]=$;const f=A.getSymbolAtLocation(r.name).getDocumentationComment(A);f&&f.length>0&&f[0].text&&($.description=f[0].text),P!==void 0&&($.defaultValue=P),D.set(l.name,l)}if(e.jsDoc&&e.jsDoc.length>0){const c=e.jsDoc,r=c.length;for(let l=0;l<r;l++){const g=c[l]?.tags;if(!g)continue;const P=g.length;for(let $=0;$<P;$++){const f=g[$];let s=f?.tagName?.text;if(!s)continue;s=s.toLowerCase();let i=f.comment;const Y=s==="hidden";if((typeof i=="string"||Y)&&(typeof i=="string"&&(i=i.replace(/[\r\n]+/g,"\\n").trim()),Y||!i||(i=i.split(/\\n/)[0],i&&i.length!==0))){if(i&&typeof i=="string"){const d=/\{@link(code|plain)?\s+([^}|]+)(?:\s*\|\s*([^}]+))?\}/g;let v,N=i,j=[];for(;(v=d.exec(i))!==null;){const[U,V,ae,Z]=v,oe=[ae.trim()];Z&&oe.push(Z.trim())}i=N,j.length>0&&s==="see"&&(u.links||(u.links=[]),u.links.push(...j))}if(s==="name"){const d=i;d!==m&&(u.name=d)}else if(s!=="description"){if(s==="summary"){const d=i;d&&(u.summary=d)}else if(s==="param"){const d=f.name?.text,v=D.get(d);if(!v){z.push(new Error(`Parameter '${d}' not found in function '${m}'.`));continue}if(f.typeExpression&&f.typeExpression.type)try{const N=f.typeExpression.type;if(N.kind===n.SyntaxKind.UnionType){const j=[];v.enums=j,N.types.forEach(U=>{if(U.kind===n.SyntaxKind.LiteralType){const V=U.literal.text;V&&j.push(V)}})}}catch(N){console.warn("Error parsing JSDoc type expression:",N)}}else if(s==="returns"||s==="return")t.returnType.description=i;else if(s==="category")u.category=i;else if(s==="hidden"){let d=!0;const v=i?.toLowerCase();v==="false"?d=!1:v!=="true"&&(d=i),d!==!1&&(u.hidden=d??!0)}}}}}}Object.keys(t.returnType).length===0&&delete t.returnType,p.push([t,u])}catch(o){k(e,new Error(`'${m}': ${o.message}`))}}}),z.length>0)throw console.warn(z),new Error("There were compilation errors.",{cause:z});if(p.length===0)throw new Error("No exported functions.");const ie=`${le.CommonUtils.uuidV4()}-script`;try{b||z.length!==0||(C=await ce(0,C,a))}catch{console.warn("Error bundling script")}const Q={functions:p,commitId:ie,source:x,name:"Script",language:"typescript",compiled:C};return y&&(Q.autoRun=y),Q};
@@ -1,29 +0,0 @@
1
- /**
2
- * @license @sheetxl/scripting - Scripting - Scripting engine for Macros and formulas; includes TypeScript and EsBuild. - v0.7.27
3
- *
4
- * (C) 2025-present SheetXL Inc. & Michael T. Ford
5
- * License: The license can be found at https://www.sheetxl.com/license.
6
- */
7
- class o {
8
- constructor(r = {}) {
9
- this.workerWrapper = null;
10
- }
11
- async getWorkerWrapper() {
12
- if (this.workerWrapper) return this.workerWrapper;
13
- const { createCompilerWorker: r } = await import("./BUrlmQqFvt49Snxt.mjs");
14
- return this.workerWrapper = await r(), this.workerWrapper;
15
- }
16
- async compileModule(r) {
17
- try {
18
- return (await this.getWorkerWrapper()).execute(r);
19
- } catch (e) {
20
- throw console.error("Failed to compile using worker:", e), e;
21
- }
22
- }
23
- terminate() {
24
- this.workerWrapper?.terminate(), this.workerWrapper = null;
25
- }
26
- }
27
- export {
28
- o as TypeScriptCompiler
29
- };