univer-cli 0.0.1 → 0.1.0

package/chunks/zh-latn-pinyin-CKxTJrac-C5FQGc09.js

@@ -0,0 +1 @@
+import{t as e}from"./vendor-COKhmG6S.js";export{e as ZhLatnPinyin};

package/internal/daemon.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+const _0x52e123=_0x12b1;(function(_0x8d4604,_0x3808f9){const _0x26044a=_0x12b1,_0x5c0b56=_0x8d4604();while(!![]){try{const _0x465945=-parseInt(_0x26044a(0x180))/0x1*(parseInt(_0x26044a(0x1a2))/0x2)+-parseInt(_0x26044a(0x15d))/0x3+-parseInt(_0x26044a(0x170))/0x4*(-parseInt(_0x26044a(0x18f))/0x5)+parseInt(_0x26044a(0x163))/0x6+parseInt(_0x26044a(0x15e))/0x7+parseInt(_0x26044a(0x1a5))/0x8+parseInt(_0x26044a(0x19c))/0x9*(-parseInt(_0x26044a(0x195))/0xa);if(_0x465945===_0x3808f9)break;else _0x5c0b56['push'](_0x5c0b56['shift']());}catch(_0x2a07ea){_0x5c0b56['push'](_0x5c0b56['shift']());}}}(_0x13e9,0xdb76a));import{a as _0x1e1bff,d as _0x4c5415,n,o as _0x53de57,r as _0x471266,u as _0x2d6035}from'../chunks/runtime-manifest-B0sadzmq.js';import{t as _0x21831b}from'../chunks/build-id-DN-fKSnl.js';import{existsSync as _0x6862a2}from'node:fs';import{chmod as _0x49ca62,mkdir as _0x2f8796,readFile as _0x148bf9,rm as _0x5362c4,writeFile as _0x1991f7}from'node:fs/promises';import _0x486220 from'node:net';function _0x12b1(_0x5efcea,_0x330c4a){_0x5efcea=_0x5efcea-0x14f;const _0x13e94c=_0x13e9();let _0x12b10f=_0x13e94c[_0x5efcea];return _0x12b10f;}import _0x127b31 from'node:process';var h=new _0x471266();async function g(_0x2c860e={}){const _0x4b12c3=_0x12b1;if(_0x127b31[_0x4b12c3(0x16d)]===_0x4b12c3(0x194))throw Error(_0x4b12c3(0x153));let _0x2308f9=_0x2c860e['env']??_0x127b31['env'],_0x46d699=_0x2d6035(_0x2308f9),_0x16fe4b=n(_0x2308f9),_0x1c3c8d=_0x2c860e[_0x4b12c3(0x17d)]??v(new _0x1e1bff({'env':_0x2308f9,'resolveExecutionPlaneOptions':()=>({'execArgv':[..._0x16fe4b[_0x4b12c3(0x1b8)][_0x4b12c3(0x1ae)]],'modulePath':_0x16fe4b[_0x4b12c3(0x1b8)][_0x4b12c3(0x1b5)]})})),_0x456c1=_0x21831b(_0x2308f9),_0x437572=new Date()[_0x4b12c3(0x19e)]();if(await _0x2f8796(_0x46d699[_0x4b12c3(0x166)],{'recursive':!0x0,'mode':0x1c0}),await _0x2f8796(_0x46d699[_0x4b12c3(0x172)],{'recursive':!0x0,'mode':0x1c0}),!await S(_0x46d699[_0x4b12c3(0x1a7)],_0x46d699[_0x4b12c3(0x150)])){if(await C(_0x46d699[_0x4b12c3(0x1b7)]))return;throw Error(_0x4b12c3(0x1a6)+_0x46d699['lockPath']);}await x(_0x46d699);let _0x57fddb=!0x1,_0x4056dd={},_0x5097c5=async _0x52a5cd=>D(null,-0x7f5b,Error(_0x4b12c3(0x16a)+_0x52a5cd)),_0x234d8a=_0x486220[_0x4b12c3(0x183)](_0x4ecd24=>{let _0x5a8bce='';_0x4ecd24['on']('data',_0x1c174e=>{const _0x5a5dcd=_0x12b1;_0x5a8bce+=_0x1c174e[_0x5a5dcd(0x177)](_0x5a5dcd(0x19a)),_0x411de5();}),_0x4ecd24['on']('error',()=>void 0x0);let _0x411de5=async()=>{const _0xc13911=_0x12b1;for(;;){let _0x54a86d=_0x5a8bce[_0xc13911(0x179)]('\x0a');if(_0x54a86d<0x0)return;let _0x18d320=_0x5a8bce[_0xc13911(0x160)](0x0,_0x54a86d)[_0xc13911(0x16c)]();if(_0x5a8bce=_0x5a8bce[_0xc13911(0x160)](_0x54a86d+0x1),!_0x18d320)continue;let _0x52f7b5=await _0x5097c5(_0x18d320);_0x4ecd24[_0xc13911(0x1a4)](JSON[_0xc13911(0x1a9)](_0x52f7b5)+'\x0a');}};});_0x5097c5=_({'buildId':_0x456c1,'logRequestError':async _0x825c39=>{const _0x28fcf9=_0x4b12c3;await _0x53de57(_0x46d699[_0x28fcf9(0x15c)],{'event':'daemon.request.error','method':_0x825c39['method'],'error':_0x825c39[_0x28fcf9(0x1b4)],'timestamp':_0x825c39[_0x28fcf9(0x1b0)]});},'onShutdownRequest':()=>{const _0x3b0c5b=_0x4b12c3;_0x3c7c98('rpc-shutdown')[_0x3b0c5b(0x168)](()=>{const _0x52d484=_0x3b0c5b;_0x127b31[_0x52d484(0x1b6)](0x0);});},'pid':_0x127b31[_0x4b12c3(0x19f)],'runtimeRoot':_0x46d699[_0x4b12c3(0x18e)],'sessionHost':_0x1c3c8d,'socketPath':_0x46d699[_0x4b12c3(0x1b7)],'startedAt':_0x437572}),await new Promise((_0x5bbd54,_0x420fa1)=>{const _0x4d2a86=_0x4b12c3;_0x234d8a[_0x4d2a86(0x165)](_0x4d2a86(0x1b4),_0x420fa1),_0x234d8a[_0x4d2a86(0x18a)](_0x46d699[_0x4d2a86(0x1b7)],_0x5bbd54);}),await _0x49ca62(_0x46d699[_0x4b12c3(0x1b7)],0x180);let _0x540cf2={'pid':_0x127b31[_0x4b12c3(0x19f)],'startedAt':_0x437572,'socketPath':_0x46d699[_0x4b12c3(0x1b7)],'runtimeRoot':_0x46d699[_0x4b12c3(0x18e)],'buildId':_0x456c1};await _0x1991f7(_0x46d699[_0x4b12c3(0x150)],String(_0x127b31[_0x4b12c3(0x19f)]),'utf8'),await _0x1991f7(_0x46d699[_0x4b12c3(0x188)],JSON[_0x4b12c3(0x1a9)](_0x540cf2,null,0x2),_0x4b12c3(0x19a)),await _0x53de57(_0x46d699['logPath'],{'event':_0x4b12c3(0x1a0),'pid':_0x127b31[_0x4b12c3(0x19f)],'socketPath':_0x46d699[_0x4b12c3(0x1b7)],'runtimeRoot':_0x46d699[_0x4b12c3(0x18e)],'startedAt':_0x437572,'buildId':_0x456c1});let _0x3f19cc=setInterval(()=>{const _0x52fae2=_0x4b12c3;_0x1c3c8d[_0x52fae2(0x157)]();},Math[_0x4b12c3(0x175)](0x3e8,Math[_0x4b12c3(0x15b)](_0x1c3c8d[_0x4b12c3(0x176)](),0xea60)));_0x3f19cc[_0x4b12c3(0x16f)](),_0x4056dd[_0x4b12c3(0x1b1)]=_0x3f19cc;async function _0x3c7c98(_0x4ab2fa){const _0x33ec1f=_0x4b12c3;_0x57fddb||(_0x57fddb=!0x0,_0x4056dd[_0x33ec1f(0x1b1)]!==void 0x0&&clearInterval(_0x4056dd['current']),await _0x53de57(_0x46d699[_0x33ec1f(0x15c)],{'event':_0x33ec1f(0x17b),'pid':_0x127b31['pid'],'reason':_0x4ab2fa,'timestamp':new Date()['toISOString']()}),await _0x1c3c8d['destroyAll'](_0x4ab2fa),await new Promise(_0x2a267d=>{const _0x82741=_0x33ec1f;_0x234d8a[_0x82741(0x1af)](()=>_0x2a267d());}),await _0x5362c4(_0x46d699['socketPath'],{'force':!0x0})[_0x33ec1f(0x152)](()=>void 0x0),await _0x5362c4(_0x46d699[_0x33ec1f(0x150)],{'force':!0x0})['catch'](()=>void 0x0),await _0x5362c4(_0x46d699[_0x33ec1f(0x188)],{'force':!0x0})[_0x33ec1f(0x152)](()=>void 0x0),await _0x5362c4(_0x46d699[_0x33ec1f(0x1a7)],{'recursive':!0x0,'force':!0x0})[_0x33ec1f(0x152)](()=>void 0x0));}_0x127b31['on'](_0x4b12c3(0x19b),()=>{const _0xc4819=_0x4b12c3;_0x3c7c98(_0xc4819(0x18b))[_0xc4819(0x168)](()=>{const _0x4a9227=_0xc4819;_0x127b31[_0x4a9227(0x1b6)](0x0);});}),_0x127b31['on'](_0x4b12c3(0x182),()=>{const _0x395533=_0x4b12c3;_0x3c7c98(_0x395533(0x171))[_0x395533(0x168)](()=>{const _0x472990=_0x395533;_0x127b31[_0x472990(0x1b6)](0x0);});});}function _(_0x4d65ad){return async _0x4e8b29=>{const _0x38a972=_0x12b1;let _0x2c8387;try{_0x2c8387=JSON[_0x38a972(0x197)](_0x4e8b29);}catch(_0x44aae9){return D(null,-0x7fbc,_0x44aae9);}try{switch(_0x2c8387[_0x38a972(0x184)]){case _0x4c5415[_0x38a972(0x1ba)]:return{'jsonrpc':_0x38a972(0x1b9),'id':_0x2c8387['id'],'result':{'ok':!0x0,'pid':_0x4d65ad['pid'],'startedAt':_0x4d65ad[_0x38a972(0x18d)],'socketPath':_0x4d65ad[_0x38a972(0x1b7)],'runtimeRoot':_0x4d65ad[_0x38a972(0x155)],'buildId':_0x4d65ad[_0x38a972(0x192)],'sessionCount':_0x4d65ad['sessionHost']['getSessionCount']()}};case _0x4c5415[_0x38a972(0x162)]:return _0x4d65ad[_0x38a972(0x17e)]?.(),{'jsonrpc':'2.0','id':_0x2c8387['id'],'result':{'stopping':!0x0}};case _0x4c5415[_0x38a972(0x164)]:{let _0x3953f4=await _0x4d65ad[_0x38a972(0x17d)]['loadWorkbook'](_0x2c8387[_0x38a972(0x191)]);return E(_0x2c8387['id'],_0x3953f4);}case _0x4c5415[_0x38a972(0x159)]:{let _0x2f68ab=await _0x4d65ad[_0x38a972(0x17d)][_0x38a972(0x1ac)](_0x2c8387[_0x38a972(0x191)]);return E(_0x2c8387['id'],_0x2f68ab);}case _0x4c5415['SessionCreateWorkbook']:{let _0x207902=await _0x4d65ad[_0x38a972(0x17d)][_0x38a972(0x1a3)](_0x2c8387[_0x38a972(0x191)]);return E(_0x2c8387['id'],_0x207902);}case _0x4c5415[_0x38a972(0x19d)]:{let _0x35cc6b=await _0x4d65ad[_0x38a972(0x17d)][_0x38a972(0x198)](_0x2c8387[_0x38a972(0x191)]);return E(_0x2c8387['id'],_0x35cc6b);}case _0x4c5415[_0x38a972(0x16b)]:{let _0x5be89c=await _0x4d65ad[_0x38a972(0x17d)]['exportWorkbookFile'](_0x2c8387[_0x38a972(0x191)]);return E(_0x2c8387['id'],_0x5be89c);}case _0x4c5415[_0x38a972(0x186)]:{let _0x46145d=_0x2c8387[_0x38a972(0x191)],_0x1fcd9f=await _0x4d65ad['sessionHost'][_0x38a972(0x169)](_0x46145d);return E(_0x2c8387['id'],_0x1fcd9f);}case _0x4c5415[_0x38a972(0x173)]:{let _0x5b2c40=await _0x4d65ad[_0x38a972(0x17d)][_0x38a972(0x154)](_0x2c8387[_0x38a972(0x191)]);return E(_0x2c8387['id'],_0x5b2c40);}case _0x4c5415[_0x38a972(0x15f)]:{let _0x43a607=await _0x4d65ad[_0x38a972(0x17d)][_0x38a972(0x189)](_0x2c8387[_0x38a972(0x191)]);return E(_0x2c8387['id'],_0x43a607);}default:return D(_0x2c8387['id'],-0x7f59,Error('Method\x20not\x20found:\x20'+_0x2c8387[_0x38a972(0x184)]));}}catch(_0x447825){return await _0x4d65ad[_0x38a972(0x14f)]?.({'method':_0x2c8387['method'],'error':_0x447825 instanceof Error?_0x447825[_0x38a972(0x167)]:String(_0x447825),'timestamp':new Date()[_0x38a972(0x19e)]()}),D(_0x2c8387['id'],-0x7f5b,_0x447825);}};}function v(_0x4fe433){return{async 'createWorkbook'(_0x44fed3){const _0xe01945=_0x12b1;let _0x4f82a5=await y(_0x44fed3),_0x2acf40=await _0x4fe433[_0xe01945(0x1a3)]({..._0x44fed3[_0xe01945(0x187)]===void 0x0?{}:{'cwd':_0x44fed3['cwd']},'identity':_0x4f82a5,..._0x44fed3['id']===void 0x0?{}:{'workbookId':_0x44fed3['id']},..._0x44fed3['name']===void 0x0?{}:{'workbookName':_0x44fed3[_0xe01945(0x185)]}});return{'success':!0x0,'workbookData':_0x2acf40[_0xe01945(0x15a)],'session':b(_0x2acf40[_0xe01945(0x199)])};},async 'dispose'(_0x4c0a3e){const _0x15b9d0=_0x12b1;let _0x4df176=await y(_0x4c0a3e);return await _0x4fe433[_0x15b9d0(0x154)]({..._0x4c0a3e[_0x15b9d0(0x187)]===void 0x0?{}:{'cwd':_0x4c0a3e[_0x15b9d0(0x187)]},'identity':_0x4df176}),{'disposed':!0x0,'workbookIdentity':_0x4df176[_0x15b9d0(0x17f)]};},async 'destroyAll'(_0x2dabef){const _0x23cb32=_0x12b1;await _0x4fe433[_0x23cb32(0x1ad)]?.(_0x2dabef);},async 'evalJs'(_0x1f1358){const _0x30d36b=_0x12b1;let _0x4b3573=await y(_0x1f1358),_0x298c4f=await _0x4fe433[_0x30d36b(0x198)]({'code':_0x1f1358[_0x30d36b(0x196)],..._0x1f1358[_0x30d36b(0x187)]===void 0x0?{}:{'cwd':_0x1f1358[_0x30d36b(0x187)]},'identity':_0x4b3573,..._0x1f1358[_0x30d36b(0x151)]===void 0x0?{}:{'mutates':_0x1f1358[_0x30d36b(0x151)]}});return{..._0x298c4f['mutations']===void 0x0?{}:{'mutations':_0x298c4f[_0x30d36b(0x161)]},'success':!0x0,'value':_0x298c4f[_0x30d36b(0x178)],'session':b(_0x298c4f[_0x30d36b(0x199)])};},async 'exportWorkbookData'(_0x1f00c9){const _0x4d49bc=_0x12b1;let _0x4adc7c=await y(_0x1f00c9),_0x133147=await _0x4fe433[_0x4d49bc(0x169)]({..._0x1f00c9[_0x4d49bc(0x187)]===void 0x0?{}:{'cwd':_0x1f00c9[_0x4d49bc(0x187)]},'identity':_0x4adc7c});return{'success':!0x0,'workbookData':_0x133147[_0x4d49bc(0x15a)],'session':b(_0x133147[_0x4d49bc(0x199)])};},async 'exportWorkbookFile'(_0x335ed0){const _0x54a78c=_0x12b1;let _0xc2783c=await y(_0x335ed0),_0x1dfb57=await _0x4fe433[_0x54a78c(0x193)]({..._0x335ed0[_0x54a78c(0x187)]===void 0x0?{}:{'cwd':_0x335ed0[_0x54a78c(0x187)]},'format':_0x335ed0['format'],'identity':_0xc2783c,'outputPath':_0x335ed0[_0x54a78c(0x1aa)]});return{'success':!0x0,'format':_0x1dfb57[_0x54a78c(0x156)],'outputPath':_0x1dfb57[_0x54a78c(0x1aa)],'sizeBytes':_0x1dfb57[_0x54a78c(0x174)],'session':b(_0x1dfb57[_0x54a78c(0x199)])};},async 'getWorkbookSession'(_0x77703b){const _0x4a617e=_0x12b1;let _0x1b8f80=await y(_0x77703b),_0x109ca5=await _0x4fe433[_0x4a617e(0x17c)]({..._0x77703b[_0x4a617e(0x187)]===void 0x0?{}:{'cwd':_0x77703b['cwd']},'identity':_0x1b8f80});return{'exists':_0x109ca5!==null,'session':_0x109ca5===null?null:b(_0x109ca5)};},'getSessionCount'(){const _0x45753b=_0x12b1;return _0x4fe433[_0x45753b(0x18c)]?.()??0x0;},'getSessionIdleTtlMs'(){const _0x221049=_0x12b1;return _0x4fe433[_0x221049(0x176)]?.()??0xea60;},async 'loadWorkbook'(_0x124eeb){const _0x3cb493=_0x12b1;let _0x583aca=await y(_0x124eeb),_0x40c1e5=await _0x4fe433[_0x3cb493(0x158)]({..._0x124eeb['cwd']===void 0x0?{}:{'cwd':_0x124eeb[_0x3cb493(0x187)]},'identity':_0x583aca,'workbookData':_0x124eeb[_0x3cb493(0x15a)]});return{'success':!0x0,'workbookData':_0x40c1e5[_0x3cb493(0x15a)],'session':b(_0x40c1e5['session'])};},async 'loadWorkbookDataReplayPack'(_0x405e3b){const _0x367bf2=_0x12b1;let _0x35f394=await y(_0x405e3b),_0x24a127=await _0x4fe433[_0x367bf2(0x1ac)]({..._0x405e3b[_0x367bf2(0x187)]===void 0x0?{}:{'cwd':_0x405e3b[_0x367bf2(0x187)]},'identity':_0x35f394,'replayPack':{'baseWorkbookData':_0x405e3b['baseWorkbookData'],'mutations':_0x405e3b[_0x367bf2(0x161)]}});return{'success':!0x0,'workbookData':_0x24a127[_0x367bf2(0x15a)],'session':b(_0x24a127[_0x367bf2(0x199)])};},async 'unloadIdleSessions'(){await _0x4fe433['unloadIdleSessions']?.();}};}async function y(_0x4670a1){return await h['resolveIdentity'](_0x4670a1);}function b(_0x25e749){const _0x50998f=_0x12b1;return{'createdAt':_0x25e749['createdAt']??'','lastAccessedAt':_0x25e749['lastAccessedAt']??'','sessionId':_0x25e749[_0x50998f(0x1ab)],'workbookIdentity':_0x25e749[_0x50998f(0x1b3)]['absolutePath']};}function _0x13e9(){const _0x3272b9=['exit','socketPath','runtimeExecutionPlaneEntry','2.0','Health','logRequestError','pidPath','mutates','catch','Unix\x20socket\x20daemon\x20transport\x20is\x20not\x20supported\x20on\x20Windows\x20in\x20this\x20version','dispose','runtimeRoot','format','unloadIdleSessions','loadWorkbookData','SessionLoadWorkbookDataReplayPack','workbookData','min','logPath','1542417SxvuoQ','8797271BnKexo','SessionGetWorkbook','slice','mutations','Shutdown','10658388ugeHlR','SessionLoadWorkbook','once','daemonDir','message','finally','exportWorkbookData','Daemon\x20handler\x20not\x20ready:\x20','SessionExportWorkbookFile','trim','platform','createConnection','unref','14756kVvows','sigterm','sessionRoot','SessionDispose','sizeBytes','max','getSessionIdleTtlMs','toString','value','indexOf','EEXIST','daemon.stop','getSession','sessionHost','onShutdownRequest','absolutePath','107tVbUmQ','Unknown\x20daemon\x20subcommand:\x20','SIGTERM','createServer','method','name','SessionExportWorkbookData','cwd','metaPath','getWorkbookSession','listen','sigint','getSessionCount','startedAt','homeDir','275OUHXKi','kill','params','buildId','exportWorkbookFile','win32','218570HMAxxC','code','parse','evalJs','session','utf8','SIGINT','738KcgENz','SessionEvalJs','toISOString','pid','daemon.start','end','14088cbiubC','createWorkbook','write','5783976PETZCN','Another\x20daemon\x20startup\x20owns\x20','lockPath','serve','stringify','outputPath','sessionId','loadWorkbookDataReplayPack','destroyAll','execArgv','close','timestamp','current','connect','packageIdentity','error','modulePath'];_0x13e9=function(){return _0x3272b9;};return _0x13e9();}async function x(_0x15cacc){const _0x33a015=_0x12b1;_0x6862a2(_0x15cacc[_0x33a015(0x1b7)])&&!await C(_0x15cacc['socketPath'])&&await _0x5362c4(_0x15cacc[_0x33a015(0x1b7)],{'force':!0x0});let _0x3a08c9=await w(_0x15cacc[_0x33a015(0x150)]);_0x3a08c9!==null&&!T(_0x3a08c9)&&(await _0x5362c4(_0x15cacc[_0x33a015(0x150)],{'force':!0x0})[_0x33a015(0x152)](()=>void 0x0),await _0x5362c4(_0x15cacc['metaPath'],{'force':!0x0})[_0x33a015(0x152)](()=>void 0x0),await _0x5362c4(_0x15cacc[_0x33a015(0x1a7)],{'recursive':!0x0,'force':!0x0})[_0x33a015(0x152)](()=>void 0x0));}async function S(_0x5b37d7,_0x40ebb6){const _0x403be2=_0x12b1;try{return await _0x2f8796(_0x5b37d7,{'recursive':!0x1,'mode':0x1c0}),!0x0;}catch(_0x2b0996){if(_0x2b0996[_0x403be2(0x196)]!==_0x403be2(0x17a))throw _0x2b0996;let _0x520d6b=await w(_0x40ebb6);return _0x520d6b!==null&&T(_0x520d6b)?!0x1:(await _0x5362c4(_0x5b37d7,{'recursive':!0x0,'force':!0x0}),await _0x2f8796(_0x5b37d7,{'recursive':!0x1,'mode':0x1c0}),!0x0);}}async function C(_0x5baffc){return await new Promise(_0x3ab05c=>{const _0x5dd3be=_0x12b1;let _0x23a601=_0x486220[_0x5dd3be(0x16e)](_0x5baffc);_0x23a601[_0x5dd3be(0x165)](_0x5dd3be(0x1b2),()=>{const _0x4ca7c9=_0x5dd3be;_0x23a601[_0x4ca7c9(0x1a1)](),_0x3ab05c(!0x0);}),_0x23a601[_0x5dd3be(0x165)]('error',()=>{_0x3ab05c(!0x1);});});}async function w(_0x1f72af){const _0x3b7641=_0x12b1;try{let _0xafdcca=await _0x148bf9(_0x1f72af,_0x3b7641(0x19a)),_0x4483f8=Number(_0xafdcca[_0x3b7641(0x16c)]());return Number['isFinite'](_0x4483f8)?_0x4483f8:null;}catch{return null;}}function T(_0x3560ca){const _0x42d7f0=_0x12b1;try{return _0x127b31[_0x42d7f0(0x190)](_0x3560ca,0x0),!0x0;}catch{return!0x1;}}function E(_0x49a3f4,_0x40424e){const _0x221078=_0x12b1;return{'jsonrpc':_0x221078(0x1b9),'id':_0x49a3f4,'result':_0x40424e};}function D(_0x26c6a3,_0x35efd6,_0x48c091){const _0x1c0e5c=_0x12b1;return{'jsonrpc':_0x1c0e5c(0x1b9),'id':_0x26c6a3,'error':{'code':_0x35efd6,'message':_0x48c091 instanceof Error?_0x48c091[_0x1c0e5c(0x167)]:String(_0x48c091)}};}var O=process['argv'][0x2]??_0x52e123(0x1a8);O!=='serve'&&(console['error'](_0x52e123(0x181)+O),process[_0x52e123(0x1b6)](0x1)),g()[_0x52e123(0x152)](_0x285321=>{const _0x56152b=_0x52e123;console['error'](_0x285321 instanceof Error?_0x285321[_0x56152b(0x167)]:String(_0x285321)),process[_0x56152b(0x1b6)](0x1);});

package/internal/univer-runner.js

@@ -0,0 +1 @@
+const _0xd45519=_0x4dfe;(function(_0x48052d,_0x59eee1){const _0x250dd6=_0x4dfe,_0x29fea4=_0x48052d();while(!![]){try{const _0x350e01=-parseInt(_0x250dd6(0xc2))/0x1+-parseInt(_0x250dd6(0xec))/0x2+-parseInt(_0x250dd6(0x110))/0x3+-parseInt(_0x250dd6(0x109))/0x4+parseInt(_0x250dd6(0xca))/0x5+parseInt(_0x250dd6(0x111))/0x6*(parseInt(_0x250dd6(0xfa))/0x7)+parseInt(_0x250dd6(0xfc))/0x8;if(_0x350e01===_0x59eee1)break;else _0x29fea4['push'](_0x29fea4['shift']());}catch(_0x170b70){_0x29fea4['push'](_0x29fea4['shift']());}}}(_0x40af,0xe8446));import{$t as _0x369a19,At as _0x289dfb,Dt as _0x48e693,Et as _0x2da5b3,Ft as _0x20c090,It as _0x1c17d5,Jt as _0x57f703,Lt as _0x57f4c4,Mt as _0x47dc9c,Nt as _0x1590e1,Ot as _0x5d7da6,Pt as _0x1c0a22,Qt as _0x903d8c,Rt as _0x3bba5b,Tt as _0x5f11a6,Xt as _0x24d688,Yt as _0x5c617e,Zt as _0x5b1e44,an as _0x397ad0,cn as _0x360687,dn as _0x3575f5,en as _0x3c9d1f,in as _0x36608d,jt as _0x3edd4d,kt as _0x51e8ad,ln as _0x4683f2,on as _0x316407,qt as _0x29255a,sn as _0x2c2ea5,tn as _0x18f824,un as _0x18fd53,wt as _0x18a04c}from'../chunks/vendor-COKhmG6S.js';import{writeFile as _0x4d1a98}from'node:fs/promises';var N='0.21.1',P=_0xd45519(0xdb),F=_0xd45519(0xd2),I='Sheet1',L=0x3e8,R=0x1a,z=_0xd45519(0xeb);function B(){const _0x2b5bdc=_0xd45519;let _0x2af854=new _0x360687({'locale':_0x2c2ea5[_0x2b5bdc(0xba)],'locales':{[_0x2c2ea5[_0x2b5bdc(0xba)]]:_0x4683f2(_0x1c17d5,_0x1c0a22)}});_0x2af854['registerPlugin'](_0x903d8c),_0x2af854[_0x2b5bdc(0xfd)](_0x369a19),_0x2af854['registerPlugin'](_0x20c090),_0x2af854[_0x2b5bdc(0xfd)](_0x3c9d1f),_0x1590e1[_0x2b5bdc(0xf9)]=N,_0x5d7da6[_0x2b5bdc(0xf9)]=N,_0x2af854[_0x2b5bdc(0xfd)](_0x1590e1,{'enableDynamicToolExecution':!0x0}),_0x2af854[_0x2b5bdc(0xfd)](_0x5d7da6),_0x2af854[_0x2b5bdc(0xfd)](_0x18f824),_0x2af854[_0x2b5bdc(0xfd)](_0x2da5b3),_0x2af854[_0x2b5bdc(0xfd)](_0x24d688),_0x2af854[_0x2b5bdc(0xfd)](_0x29255a),_0x2af854['registerPlugin'](_0x5f11a6),_0x2af854['registerPlugin'](_0x3edd4d),_0x2af854[_0x2b5bdc(0xfd)](_0x5c617e),_0x2af854[_0x2b5bdc(0xfd)](_0x51e8ad),_0x2af854['registerPlugin'](_0x57f703),_0x2af854['registerPlugin'](_0x48e693),_0x2af854[_0x2b5bdc(0xfd)](_0x5b1e44),_0x2af854[_0x2b5bdc(0xfd)](_0x18a04c),_0x2af854[_0x2b5bdc(0xfd)](_0x289dfb);let _0x8be37a=_0x3bba5b[_0x2b5bdc(0xd3)](_0x2af854),_0x46576b=_0x2af854[_0x2b5bdc(0xbc)](),_0x441b5b=_0x46576b[_0x2b5bdc(0xd5)](_0x47dc9c);_0x441b5b[_0x2b5bdc(0xe1)]=!0x1;let _0x5dfeb6=_0x46576b[_0x2b5bdc(0xd5)](_0x397ad0),_0x5c649f=_0x46576b[_0x2b5bdc(0xd5)](_0x316407),_0x10a5c8=null,_0x4986c5=null,_0x3c9759=_0x5dfeb6[_0x2b5bdc(0xfb)]((_0x3aad4b,_0x5101cc)=>{const _0xbd73a6=_0x2b5bdc;if(_0x10a5c8===null)return;let _0x525e65=V(_0x3aad4b,_0x5101cc,_0x10a5c8['unitId']);_0x525e65!==null&&_0x10a5c8[_0xbd73a6(0xf5)]['push'](_0x525e65);}),_0x252557={'univer':_0x2af854,'univerAPI':_0x8be37a,'createWorkbook'(_0x469898){return _0x5b9be0(K(_0x469898));},'dispose'(){const _0x31500d=_0x2b5bdc;_0x3c9759[_0x31500d(0xed)](),_0x423f39(),_0x2af854['dispose']();},async 'evalJs'(_0x131b0a,_0x247a8f=0x186a0){const _0xc3663b=_0x2b5bdc;if(_0x131b0a[_0xc3663b(0xd4)]>_0x247a8f)throw Error(_0xc3663b(0xda)+_0x247a8f+_0xc3663b(0xe2));return await Function('univerAPI',_0xc3663b(0xe6)+_0x131b0a+_0xc3663b(0x105))(_0x8be37a);},async 'evalJsWithMutationCapture'(_0x438a03,_0x478355=0x186a0){const _0x432319=_0x2b5bdc;let _0x25d12f=_0x5df809()[_0x432319(0xdd)]();if(_0x10a5c8!==null)throw Error(_0x432319(0xf0));let _0x8d5929={'mutations':[],'unitId':_0x25d12f};_0x10a5c8=_0x8d5929;try{return{'value':await _0x252557['evalJs'](_0x438a03,_0x478355),'mutations':_0x8d5929[_0x432319(0xf5)]};}finally{_0x10a5c8=null;}},async 'exportWorkbookFile'(_0x2a9648,_0x5c734a){const _0x3395a1=_0x2b5bdc;let _0x282976=_0x252557[_0x3395a1(0xc8)]();if(_0x5c734a===_0x3395a1(0x10e)){let _0x450627=U(_0x282976);return await _0x4d1a98(_0x2a9648,_0x450627,_0x3395a1(0xc9)),{'format':_0x5c734a,'outputPath':_0x2a9648,'sizeBytes':Buffer[_0x3395a1(0x10c)](_0x450627,_0x3395a1(0xc9))};}throw Error(_0x3395a1(0xcd));},'exportWorkbookData'(){const _0x9fb11a=_0x2b5bdc;let _0x21759f=_0x5df809();return _0x46576b[_0x9fb11a(0x107)](_0x57f4c4,_0x21759f)[_0x9fb11a(0xe0)]();},'loadWorkbookDataReplayPack'(_0x328d98){const _0x567838=_0x2b5bdc;return _0x5b9be0(_0x328d98['baseWorkbookData']),_0x2928fc(_0x328d98[_0x567838(0xf5)]),_0x252557[_0x567838(0xc8)]();},'loadWorkbookData':_0x5b9be0};return _0x252557;function _0x423f39(){const _0x3f5d05=_0x2b5bdc;_0x4986c5&&=(_0x5c649f[_0x3f5d05(0xd6)](_0x4986c5),null);}function _0x5df809(){const _0x4e1cff=_0x2b5bdc;if(!_0x4986c5)throw Error(_0x4e1cff(0xe3));let _0x193ec7=_0x5c649f[_0x4e1cff(0x113)](_0x4986c5,_0x3575f5['UNIVER_SHEET']);if(!_0x193ec7)throw Error('Workbook\x20not\x20found:\x20'+_0x4986c5);return _0x193ec7;}function _0x5b9be0(_0x2dbd6a){const _0x263f1e=_0x2b5bdc;return _0x423f39(),_0x4986c5=_0x5c649f[_0x263f1e(0xc3)](_0x3575f5[_0x263f1e(0xc6)],structuredClone(_0x2dbd6a))[_0x263f1e(0xdd)](),_0x252557[_0x263f1e(0xc8)]();}function _0x2928fc(_0x4d1c7f){const _0x304a57=_0x2b5bdc;if(_0x4d1c7f[_0x304a57(0xd4)]===0x0)return;let _0x1be83e=_0x18fd53(_0x4d1c7f[_0x304a57(0xcc)](_0x4984cb=>({'id':_0x4984cb['id'],'params':structuredClone(_0x4984cb[_0x304a57(0xbb)]),'type':_0x36608d[_0x304a57(0xf3)]})),_0x5dfeb6,{'fromChangeset':!0x0,'onlyLocal':!0x0});if(!_0x1be83e[_0x304a57(0xd1)]){let _0x5b3116=_0x4d1c7f[_0x1be83e[_0x304a57(0xe4)]];throw Error(_0x304a57(0xbe)+(_0x5b3116?.['id']??_0x304a57(0x10f))+'\x20at\x20index\x20'+_0x1be83e['index']);}}}function V(_0x475a7d,_0xe657b2,_0x5ca4ad){const _0x2c9cca=_0xd45519;return _0x475a7d[_0x2c9cca(0xfe)]!==_0x36608d[_0x2c9cca(0xf3)]||_0xe657b2?.[_0x2c9cca(0x108)]||_0xe657b2?.['onlyLocal']||_0x475a7d['id']===z||!H(_0x475a7d[_0x2c9cca(0xbb)])||_0x475a7d[_0x2c9cca(0xbb)][_0x2c9cca(0x10a)]!==_0x5ca4ad?null:{'id':_0x475a7d['id'],'params':structuredClone(_0x475a7d[_0x2c9cca(0xbb)]),'type':_0x36608d[_0x2c9cca(0xf3)]};}function _0x40af(){const _0x5fe153=['number','keys','loadWorkbookDataReplayPack','Code\x20too\x20long\x20(max\x20','enUS','send','getUnitId','evalJsWithMutationCapture','loadWorkbook','save','enableAutoConnect','\x20characters)','Workbook\x20not\x20loaded','index','sheetOrder','return\x20(async\x20()\x20=>\x20{\x20','disconnect','ready','rpc-response','string','doc.mutation.rich-text-editing','1880276hCdBJr','dispose','loadWorkbookData','data','Mutation\x20collection\x20is\x20already\x20active','format','isArray','MUTATION','sort','mutations','toString','mutates','workbook-','version','21DqdvZT','onMutationExecutedForCollab','13604168yQoUDH','registerPlugin','type','evaljs','code','SIGTERM','object','name','exit','\x20})();','EvalJs','createInstance','fromCollab','627300RbeqGO','unitId','outputPath','byteLength','LoadWorkbookDataReplayPack','csv','<unknown>','65526JdzNkp','1814280QKKFtr','tail','getUnit','sheets','2.0','join','Method\x20not\x20implemented:\x20','isFinite','EN_US','params','__getInjector','ExportWorkbookFile','Failed\x20to\x20replay\x20mutation\x20','message','filter','push','1441283xODrzv','createUnit','ExportWorkbookData','createWorkbook','UNIVER_SHEET','enqueue','exportWorkbookData','utf8','4518965clPpcu','CreateWorkbook','map','runtime\x20xlsx\x20export\x20is\x20not\x20available;\x20use\x20workbook\x20exchange\x20export','method','cellData','exportWorkbookFile','result','sheet-1','newAPI','length','get','disposeUnit'];_0x40af=function(){return _0x5fe153;};return _0x40af();}function H(_0x5fc814){const _0x1c400b=_0xd45519;return typeof _0x5fc814==_0x1c400b(0x102)&&!!_0x5fc814&&!Array[_0x1c400b(0xf2)](_0x5fc814);}function U(_0x329dd2){const _0x31ccd0=_0xd45519;let _0x146bda=_0x329dd2[_0x31ccd0(0xe5)]?.[0x0];if(!_0x146bda)return'';let _0x5ca3bf=_0x329dd2[_0x31ccd0(0x114)]?.[_0x146bda];if(!_0x5ca3bf?.[_0x31ccd0(0xcf)])return'';let _0x598598=Object[_0x31ccd0(0xd8)](_0x5ca3bf[_0x31ccd0(0xcf)])[_0x31ccd0(0xcc)](Number)['filter'](Number[_0x31ccd0(0xb9)])[_0x31ccd0(0xf4)]((_0x1f78e2,_0x1f9db3)=>_0x1f78e2-_0x1f9db3),_0x3f1cae=[];for(let _0x4a24d2 of _0x598598){let _0xf58af3=_0x5ca3bf['cellData'][_0x4a24d2];if(!_0xf58af3)continue;let _0x15a209=Object['keys'](_0xf58af3)['map'](Number)[_0x31ccd0(0xc0)](Number['isFinite'])[_0x31ccd0(0xf4)]((_0x46ce5d,_0x313d7e)=>_0x46ce5d-_0x313d7e),_0x3735e6=[];for(let _0x5c3c6e of _0x15a209){let _0x35b828=_0xf58af3[_0x5c3c6e];_0x3735e6[_0x5c3c6e]=G(W(_0x35b828));}_0x3f1cae[_0x31ccd0(0xc1)](_0x3735e6['map'](_0x56b2dc=>_0x56b2dc??'')['join'](','));}return _0x3f1cae[_0x31ccd0(0x116)]('\x0a');}function W(_0x4a98c3){const _0x27c331=_0xd45519;if(!_0x4a98c3||typeof _0x4a98c3!='object')return'';let _0x14a2fb=_0x4a98c3;return typeof _0x14a2fb['v']==_0x27c331(0xea)?_0x14a2fb['v']:typeof _0x14a2fb['v']==_0x27c331(0xd7)||typeof _0x14a2fb['v']=='boolean'?String(_0x14a2fb['v']):typeof _0x14a2fb['p']==_0x27c331(0xea)?_0x14a2fb['p']:'';}function G(_0x58f2d8){return/[",\n]/['test'](_0x58f2d8)?'\x22'+_0x58f2d8['replaceAll']('\x22','\x22\x22')+'\x22':_0x58f2d8;}function _0x4dfe(_0x3fc797,_0x108a3a){_0x3fc797=_0x3fc797-0xb8;const _0x40af07=_0x40af();let _0x4dfeca=_0x40af07[_0x3fc797];return _0x4dfeca;}function K(_0x1657de={}){const _0x35d301=_0xd45519;let _0x430f3b=_0x1657de['id']??_0x35d301(0xf8)+Date['now']()[_0x35d301(0xf6)](0x24);return{'id':_0x430f3b,'name':_0x1657de[_0x35d301(0x103)]??_0x430f3b,'appVersion':N,'locale':P,'styles':{},'sheetOrder':[F],'sheets':{[F]:{'id':F,'name':I,'rowCount':L,'columnCount':R,'cellData':{}}},'resources':[]};}let q=function(_0x889ff0){const _0x2a8ca3=_0xd45519;return _0x889ff0[_0x2a8ca3(0xcb)]=_0x2a8ca3(0xc5),_0x889ff0[_0x2a8ca3(0x106)]=_0x2a8ca3(0xff),_0x889ff0['ExportWorkbookFile']=_0x2a8ca3(0xd0),_0x889ff0[_0x2a8ca3(0xc4)]=_0x2a8ca3(0xc8),_0x889ff0['LoadWorkbook']=_0x2a8ca3(0xdf),_0x889ff0[_0x2a8ca3(0x10d)]=_0x2a8ca3(0xd9),_0x889ff0;}({});var J=class{[_0xd45519(0x112)]=Promise['resolve']();async['enqueue'](_0x2aecfa){const _0x235ddb=_0xd45519;let _0x507962=this[_0x235ddb(0x112)],_0x988091;this[_0x235ddb(0x112)]=new Promise(_0x3a720a=>{_0x988091=_0x3a720a;}),await _0x507962;try{return await _0x2aecfa();}finally{_0x988091?.();}}},Y=B(),X=new J();process[_0xd45519(0xdc)]?.({'type':_0xd45519(0xe8)}),process['on'](_0xd45519(0xbf),async _0x443f2b=>{const _0x2608c6=_0xd45519;if(_0x443f2b?.['type']!=='rpc-request')return;let _0x2466f1=await Z(_0x443f2b[_0x2608c6(0xef)]);process['send']?.({'type':_0x2608c6(0xe9),'id':_0x443f2b['id'],'data':_0x2466f1});}),process['on'](_0xd45519(0xe7),()=>{const _0x57898e=_0xd45519;Y[_0x57898e(0xed)](),process[_0x57898e(0x104)](0x0);}),process['on'](_0xd45519(0x101),()=>{const _0x55c186=_0xd45519;Y[_0x55c186(0xed)](),process[_0x55c186(0x104)](0x0);});async function Z(_0x50d0c0){const _0x2e3690=_0xd45519;try{switch(_0x50d0c0[_0x2e3690(0xce)]){case q[_0x2e3690(0xcb)]:{let _0x24fb4f=Y[_0x2e3690(0xc5)](_0x50d0c0[_0x2e3690(0xbb)]??{});return{'jsonrpc':_0x2e3690(0x115),'id':_0x50d0c0['id'],'result':{'success':!0x0,'workbookData':_0x24fb4f}};}case q['LoadWorkbook']:{let _0xf1eedc=Y[_0x2e3690(0xee)](_0x50d0c0[_0x2e3690(0xbb)]['workbookData']);return{'jsonrpc':_0x2e3690(0x115),'id':_0x50d0c0['id'],'result':{'success':!0x0,'workbookData':_0xf1eedc}};}case q[_0x2e3690(0x10d)]:{let _0x1729e3=Y['loadWorkbookDataReplayPack'](_0x50d0c0[_0x2e3690(0xbb)]);return{'jsonrpc':_0x2e3690(0x115),'id':_0x50d0c0['id'],'result':{'success':!0x0,'workbookData':_0x1729e3}};}case q[_0x2e3690(0xc4)]:return{'jsonrpc':_0x2e3690(0x115),'id':_0x50d0c0['id'],'result':{'success':!0x0,'workbookData':Y[_0x2e3690(0xc8)]()}};case q[_0x2e3690(0xbd)]:{let _0x598449=_0x50d0c0['params'],_0x3fbfe6=await Y[_0x2e3690(0xd0)](_0x598449[_0x2e3690(0x10b)],_0x598449[_0x2e3690(0xf1)]);return{'jsonrpc':_0x2e3690(0x115),'id':_0x50d0c0['id'],'result':{'success':!0x0,..._0x3fbfe6}};}case q[_0x2e3690(0x106)]:{let _0x253799=_0x50d0c0['params']??{},_0x32a6ca=async()=>{const _0x35771d=_0x2e3690;let _0x1435cd=_0x253799[_0x35771d(0xf7)]?await Y[_0x35771d(0xde)](_0x253799[_0x35771d(0x100)]):{'value':await Y['evalJs'](_0x253799[_0x35771d(0x100)]),'mutations':void 0x0};return{'success':!0x0,..._0x1435cd[_0x35771d(0xf5)]===void 0x0?{}:{'mutations':_0x1435cd[_0x35771d(0xf5)]},'value':_0x1435cd['value']};},_0x4d796d=_0x253799[_0x2e3690(0xf7)]?await X[_0x2e3690(0xc7)](_0x32a6ca):await _0x32a6ca();return{'jsonrpc':_0x2e3690(0x115),'id':_0x50d0c0['id'],'result':_0x4d796d};}default:throw Error(_0x2e3690(0xb8)+String(_0x50d0c0[_0x2e3690(0xce)]));}}catch(_0x2b64a8){return{'jsonrpc':_0x2e3690(0x115),'id':_0x50d0c0['id'],'error':{'code':-0x7f5b,'message':_0x2b64a8 instanceof Error?_0x2b64a8['message']:String(_0x2b64a8)}};}}

package/package.json

@@ -1,15 +1,32 @@
 {
   "name": "univer-cli",
-  "version": "0.0.1",
-  "description": "Univer CLI - A command-line tool for Univer",
-  "main": "index.js",
-  "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
+  "version": "0.1.0",
+  "description": "Command-line tools for local Univer workbook automation.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dream-num/univer.git"
   },
-  "keywords": ["univer", "cli"],
-  "author": "",
-  "license": "ISC",
-  "type": "commonjs",
+  "homepage": "https://github.com/dream-num/univer#readme",
+  "bugs": {
+    "url": "https://github.com/dream-num/univer/issues"
+  },
+  "keywords": [
+    "automation",
+    "cli",
+    "spreadsheet",
+    "univer",
+    "univer-cli",
+    "workbook",
+    "xlsx"
+  ],
+  "type": "module",
+  "bin": {
+    "univer": "./bin/univer.js"
+  },
+  "dependencies": {
+    "@univerjs-pro/uexcli": "0.1.20"
+  },
+  "private": false,
   "publishConfig": {
     "registry": "https://registry.npmjs.org/"
   }

package/run-help/topics/core.md

@@ -0,0 +1,144 @@
+# Core
+
+This topic groups the workbook, worksheet, and structural APIs behind most `run` tasks.
+
+## Object Hierarchy
+
+```text
+univerAPI
+  -> getActiveWorkbook() -> FWorkbook
+    -> getSheetByName(name) -> FWorksheet | null
+      -> getRange(...) -> FRange
+```
+
+## Entry Point
+
+Start from the active workbook:
+
+```javascript
+const workbook = univerAPI.getActiveWorkbook();
+```
+
+Top-level APIs used most often:
+
+- `univerAPI.getActiveWorkbook() -> FWorkbook` - get the current active workbook
+- `univerAPI.getFormula() -> FFormula` - get the formula engine instance used for calculation synchronization
+
+Dimension constants used by `insertCells()` and `deleteCells()`:
+
+- `univerAPI.Enum.Dimension.ROWS` - row dimension constant for `insertCells()` and `deleteCells()`
+- `univerAPI.Enum.Dimension.COLUMNS` - column dimension constant for `insertCells()` and `deleteCells()`
+
+## Workbook And Worksheet Access
+
+Use the workbook object to locate, list, create, and delete sheets.
+
+- `getSheetByName(name) -> FWorksheet | null` - recommended explicit lookup by sheet name
+- `getSheets() -> FWorksheet[]` - list all worksheets; useful when the task first needs sheet names
+- `create(name, rows, cols) -> FWorksheet` - create a new worksheet with an initial shape
+- `deleteSheet(sheetId) -> boolean` - delete the specified worksheet by sheet id
+
+Common worksheet reads:
+
+- `getSheetId() -> number`
+- `getSheetName() -> string`
+- `getLastRow() -> number` - 0-based index of the last row with data
+- `getLastColumn() -> number` - 0-based index of the last column with data
+- `hasHiddenGridLines() -> boolean`
+
+Common worksheet writes:
+
+- `setName(name) -> void`
+- `insertRows(rowIndex, numRows) -> FWorksheet`
+- `deleteRows(rowIndex, numRows) -> FWorksheet`
+- `insertColumns(columnIndex, numColumns) -> FWorksheet`
+- `deleteColumns(columnIndex, numColumns) -> FWorksheet`
+- `setFrozenRows(rows)` or `setFrozenRows(startRow, endRow) -> FWorksheet`
+- `setFrozenColumns(columns)` or `setFrozenColumns(startColumn, endColumn) -> FWorksheet`
+- `setHiddenGridlines(hidden) -> FWorksheet`
+- `setGridLinesColor(color) -> FWorksheet` - `undefined` or `null` resets to default
+- `setRowHeight(rowIndex, height) -> FWorksheet`
+- `setRowHeights(startRow, numRows, height) -> FWorksheet`
+- `showRows(rowIndex, numRows) -> FWorksheet`
+- `hideRows(rowIndex, numRows) -> FWorksheet`
+- `autoResizeRows(startRow, numRows) -> FWorksheet`
+- `setColumnWidth(columnIndex, width) -> FWorksheet`
+- `setColumnWidths(startColumn, numColumns, width) -> FWorksheet`
+- `showColumns(columnIndex, numColumns) -> FWorksheet`
+- `hideColumns(columnIndex, numColumns) -> FWorksheet`
+- `autoResizeColumns(startColumn, numColumns) -> FWorksheet`
+
+Example:
+
+```javascript
+() => {
+  const workbook = univerAPI.getActiveWorkbook();
+  const existing = workbook.getSheetByName("Summary");
+  if (existing) {
+    return { success: true, sheetName: existing.getSheetName() };
+  }
+
+  const sheet = workbook.create("Summary", 100, 20);
+  return { success: true, sheetName: sheet.getSheetName() };
+};
+```
+
+Formula wait API:
+
+- `onCalculationResultApplied() -> Promise<void>` - wait until formula-calculation results are applied before reading computed values
+- note: if a real calculation runs, it resolves when results are applied; if no calculation starts quickly, it can resolve automatically instead of hanging forever
+
+## getRange()
+
+`getRange()` is the standard bridge from a worksheet to cell-level work.
+
+Supported forms:
+
+- `getRange('A1')`
+- `getRange('A1:C10')`
+- `getRange('A:A')`
+- `getRange('1:1')`
+- `getRange(row, col)`
+- `getRange(row, col, rowCount, colCount)`
+
+Example:
+
+```javascript
+() => {
+  const workbook = univerAPI.getActiveWorkbook();
+  const sheet = workbook.getSheetByName("Sales");
+  if (!sheet) return { success: false, error: 'Sheet "Sales" not found' };
+
+  const header = sheet.getRange("A1:C1").getValues();
+  const firstCell = sheet.getRange(0, 0).getValue();
+
+  return { success: true, header, firstCell };
+};
+```
+
+## Coordinate Model
+
+Numeric coordinates are 0-based:
+
+- `getRange(0, 0)` is `A1`
+- `getRange(1, 2)` is `C2`
+- `getRange(0, 0, 2, 2)` is `A1:B2`
+- `insertRows(4, 3)` inserts 3 rows starting at spreadsheet row 5
+- `insertColumns(1, 2)` inserts 2 columns starting at spreadsheet column B
+
+Use numeric coordinates for loops or generated positions. Use A1 notation when the target is fixed and workbook-facing.
+
+## A1 Notation
+
+Prefer A1 notation for explicit workbook-facing locations:
+
+- `'A1'`
+- `'A1:B10'`
+- `'A:A'`
+- `'1:1'`
+
+## Related Topics
+
+- See `sheets` for worksheet-focused structure and presentation tasks.
+- See `ranges` for cell reads, writes, formulas, merges, clear, cell shifts, and AutoFill.
+- See `overview` when you need the command shape, execution rules, and hard rules.

package/run-help/topics/formatting.md

@@ -0,0 +1,162 @@
+# Formatting
+
+This topic groups the formatting APIs commonly used in `run`.
+
+## Font Formatting
+
+Available font APIs:
+
+- `setFontWeight(weight) -> FRange` - set font weight such as `'bold'`; `null` clears it
+- `setFontLine(line) -> FRange` - set text decoration such as `'underline'`, `'line-through'`, or `'none'`
+- `setFontFamily(family) -> FRange` - set font family such as `Arial`, `Verdana`, `Microsoft YaHei`, `SimSun`, or `SimHei`
+- `setFontSize(size) -> FRange` - set font size as a number
+- `setFontColor(color) -> FRange` - set font color with a CSS color string such as `'#ffffff'` or `'white'`; `null` resets it
+- `setFontStyle(style) -> FRange` - set font style such as `'italic'` or `'normal'`; `null` resets it
+
+Example:
+
+```javascript
+() => {
+  const workbook = univerAPI.getActiveWorkbook();
+  const sheet = workbook.getSheetByName("Report");
+  if (!sheet) return { success: false, error: 'Sheet "Report" not found' };
+
+  sheet
+    .getRange("A1:D1")
+    .setFontWeight("bold")
+    .setFontSize(14)
+    .setFontFamily("Arial")
+    .setFontColor("#1F1F1F");
+
+  return { success: true };
+};
+```
+
+## Background Fill
+
+Available background API:
+
+- `setBackgroundColor(color) -> FRange` - set background fill color with a CSS color string
+
+Example:
+
+```javascript
+() => {
+  const workbook = univerAPI.getActiveWorkbook();
+  const sheet = workbook.getSheetByName("Report");
+  if (!sheet) return { success: false, error: 'Sheet "Report" not found' };
+
+  sheet.getRange("A1:D1").setBackgroundColor("#F2F2F2");
+  return { success: true };
+};
+```
+
+## Alignment
+
+Available alignment APIs:
+
+- `setHorizontalAlignment(alignment) -> FRange` - set horizontal alignment such as `'left'`, `'center'`, or `'normal'`
+- `setVerticalAlignment(alignment) -> FRange` - set vertical alignment such as `'top'`, `'middle'`, or `'bottom'`
+
+Notes:
+
+- in this API, `'normal'` horizontal alignment means right alignment
+- use alignment changes only when workbook-visible verification does not already have a smaller primitive
+
+Example:
+
+```javascript
+() => {
+  const workbook = univerAPI.getActiveWorkbook();
+  const sheet = workbook.getSheetByName("Report");
+  if (!sheet) return { success: false, error: 'Sheet "Report" not found' };
+
+  sheet.getRange("A1:D10").setHorizontalAlignment("center").setVerticalAlignment("middle");
+
+  return { success: true };
+};
+```
+
+## Borders
+
+Border API:
+
+- `setBorder(type, style, color?) -> FRange`
+
+Border type constants:
+
+- `univerAPI.Enum.BorderType.TOP` - top border only
+- `univerAPI.Enum.BorderType.BOTTOM` - bottom border only
+- `univerAPI.Enum.BorderType.LEFT` - left border only
+- `univerAPI.Enum.BorderType.RIGHT` - right border only
+- `univerAPI.Enum.BorderType.ALL` - all borders, including outer and inner grid lines
+- `univerAPI.Enum.BorderType.OUTSIDE` - outside borders only
+- `univerAPI.Enum.BorderType.INSIDE` - inside borders only
+- `univerAPI.Enum.BorderType.NONE` - clear or remove borders from the range
+
+Border style constants:
+
+- `univerAPI.Enum.BorderStyleTypes.THIN` - thin line, the most common default
+- `univerAPI.Enum.BorderStyleTypes.HAIR` - hair line
+- `univerAPI.Enum.BorderStyleTypes.MEDIUM` - medium line
+- `univerAPI.Enum.BorderStyleTypes.THICK` - thick line
+- `univerAPI.Enum.BorderStyleTypes.DASHED` - dashed line
+- `univerAPI.Enum.BorderStyleTypes.DOUBLE` - double line
+
+Example:
+
+```javascript
+() => {
+  const workbook = univerAPI.getActiveWorkbook();
+  const sheet = workbook.getSheetByName("Report");
+  if (!sheet) return { success: false, error: 'Sheet "Report" not found' };
+
+  sheet
+    .getRange("A1:D10")
+    .setBorder(univerAPI.Enum.BorderType.OUTSIDE, univerAPI.Enum.BorderStyleTypes.THIN, "#808080");
+
+  return { success: true };
+};
+```
+
+## Number Formats
+
+Number format API:
+
+- `setNumberFormats(patterns) -> FRange` - set number formats with a 2D array that matches the target range shape
+
+`patterns` is a 2D array aligned to the target range, similar to `setValues()`.
+
+Common patterns:
+
+- `#,##0.00` - thousands separator with two decimals
+- `0.00%` - percentage
+- `yyyy-MM-DD` - date
+
+Example:
+
+```javascript
+() => {
+  const workbook = univerAPI.getActiveWorkbook();
+  const sheet = workbook.getSheetByName("Finance");
+  if (!sheet) return { success: false, error: 'Sheet "Finance" not found' };
+
+  sheet.getRange("B2:C3").setNumberFormats([
+    ["$#,##0.00", "0.00%"],
+    ["$#,##0.00", "0.00%"]
+  ]);
+
+  return { success: true };
+};
+```
+
+## Clearing Format
+
+Use `clearFormat()` to remove formatting from a range without deleting its content:
+
+- `clearFormat() -> void`
+
+## Related Topics
+
+- See `ranges` for `clearContent()`, `clear()`, value writes, and AutoFill.
+- See `sheets` when the task is row or column presentation instead of cell-level style.

package/run-help/topics/formulas.md

@@ -0,0 +1,85 @@
+# Formulas
+
+This topic focuses on formula writes, calculation waits, and readback behavior inside `run`.
+
+## What This Topic Is For
+
+Use this topic when the task needs workbook-native recalculation and the result must remain consistent with how the workbook computes formulas.
+
+## Formula Writes
+
+You can write formulas with either of these APIs:
+
+- `setFormula(formula) -> void`
+- `setValue(value) -> FRange` when `value` starts with `=`
+
+This applies to both:
+
+- `range.setFormula('=SUM(B1:B10)')`
+- `range.setValue('=SUM(B1:B10)')`
+
+## Formula Calculation
+
+Formula calculation is asynchronous. If you need the calculated result in the same `run`, wait for calculation to finish:
+
+```javascript
+await univerAPI.getFormula().onCalculationResultApplied();
+```
+
+Available formula wait API:
+
+- `univerAPI.getFormula() -> FFormula`
+- `onCalculationResultApplied() -> Promise<void>` - wait for formula-calculation results to be applied before reading the computed value
+- note: if a real calculation runs, it resolves when results are applied; if no calculation starts quickly, it can resolve automatically instead of hanging forever
+
+## Formula Warning
+
+Without the wait, readback can be stale.
+
+## Copyable Example
+
+```javascript
+async () => {
+  const workbook = univerAPI.getActiveWorkbook();
+  const sheet = workbook.getSheetByName("Sales");
+  if (!sheet) return { success: false, error: 'Sheet "Sales" not found' };
+
+  sheet.getRange("A1").setFormula("=SUM(B1:B10)");
+  await univerAPI.getFormula().onCalculationResultApplied();
+
+  return {
+    success: true,
+    formula: sheet.getRange("A1").getFormulas(),
+    value: sheet.getRange("A1").getValue()
+  };
+};
+```
+
+## Formula Readback With setValue()
+
+```javascript
+async () => {
+  const workbook = univerAPI.getActiveWorkbook();
+  const sheet = workbook.getSheetByName("Sales");
+  if (!sheet) return { success: false, error: 'Sheet "Sales" not found' };
+
+  sheet.getRange("A2").setValue("=SUM(B2:B10)");
+  await univerAPI.getFormula().onCalculationResultApplied();
+
+  return {
+    success: true,
+    value: sheet.getRange("A2").getValue()
+  };
+};
+```
+
+## Getchas
+
+- do not read the computed result immediately after writing a formula
+- always verify formula output with workbook-visible reads after the command
+- if the task is only propagation from an existing seed, prefer `ranges -> AutoFill` over custom formula scripting
+
+## Related Topics
+
+- See `ranges` for formula writes alongside value writes, shape rules, merges, clear, and AutoFill.
+- See `overview` for hard rules and command-selection guidance.

package/run-help/topics/overview.md

@@ -0,0 +1,92 @@
+# Overview
+
+`run` is the workbook-local programmable surface in `univer-cli`. It executes a bounded JavaScript function inside the Univer spreadsheet engine so you can read workbook state, compute results, and write workbook state.
+
+Read this topic first when the job belongs in `run` but you have not chosen the exact API yet.
+
+## When To Use `run`
+
+Use `run` when the task is workbook-local logic that is clearer or more reliable in API form, especially for:
+
+- styling and presentation
+- row or column structure changes
+- freeze panes, gridline settings, and sheet-level display settings
+- merge or unmerge flows
+- formula orchestration that needs workbook-native recalculation
+- bounded read/compute/write logic inside one workbook
+
+Prefer smaller surfaces when they already express the task directly:
+
+- `inspect` for reconnaissance and workbook-visible verification
+- `search` to locate rows, columns, sheets, and formula matches
+- `pipe out` / `pipe in` for bulk rectangular data roundtrips through shell tools
+
+## Quick Start
+
+Use this command shape. The script must be an arrow function and should return a plain object.
+
+```bash
+univer run <univer-path> --code '() => {
+  const workbook = univerAPI.getActiveWorkbook();
+  const sheet = workbook.getSheetByName("Sheet1");
+  if (!sheet) return { success: false, error: "Sheet1 not found" };
+
+  sheet.getRange("A1").setValue("ready");
+  return { success: true, value: sheet.getRange("A1").getValue() };
+}'
+```
+
+Use one of these wrappers:
+
+- `() => {}`
+- `async () => {}`
+
+## Hard Rules
+
+- always wrap the program in an arrow function
+- always return an object
+- use only APIs documented in this run manual reference family
+- strictly use documented methods; do not guess or invent API names
+- prefer A1 notation for fixed ranges
+- remember that coordinate overloads are 0-based
+- check for missing sheets before writing
+- keep the operation bounded to the workbook task at hand
+- verify the result with workbook-visible reads after the command
+
+If a needed API is not documented here, stop and inspect or update the run manual documentation instead of guessing method names, overloads, enum names, or object relationships.
+
+## Common Task Aliases
+
+- `autofill` -> `ranges`
+- `fill-series` -> `ranges`
+- `get-values` -> `ranges`
+- `read-range` -> `ranges`
+- `formula-readback` -> `formulas`
+- `calculation` -> `formulas`
+- `freeze-panes` -> `sheets`
+- `number-format` -> `formatting`
+
+## Topics
+
+- `overview` - command selection, hard rules, and progressive discovery
+- `core` - `univerAPI`, workbook access, worksheet access, `getRange()`, A1 notation, coordinates
+- `ranges` - value reads, writes, shape rules, formulas, merges, clear, cell shifts, AutoFill
+- `formulas` - formula writes, async calculation waits, and stale-readback getchas
+- `sheets` - worksheet creation, rename, row or column structure, freezing, gridlines, and visibility
+- `formatting` - font, fill, alignment, border, number-format, and clear-format APIs
+
+## Formula Readback Warning
+
+Formula calculation is asynchronous. If you set a formula with `setFormula()` or by writing a string starting with `=`, do not read the computed result immediately. Wait for calculation to finish:
+
+```javascript
+await univerAPI.getFormula().onCalculationResultApplied();
+```
+
+Without that wait, readback can be stale.
+
+## Related Topics
+
+- See `core` for workbook, sheet, structure, coordinates, and `getRange()`.
+- See `ranges` for range reads and writes, formulas, merges, clear, cell insertion and deletion, and AutoFill.
+- See `formatting` for fonts, fills, alignment, borders, and number formats.