@pulse-editor/react-api 0.1.1-alpha.3 → 0.1.1-alpha.30

package/dist/hooks/agent/use-agent-tools.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Add or use agent tools in the editor.
+ * @param moduleName
+ * @returns
+ */
+export default function useAgentTools(): {};

package/dist/hooks/agent/use-agents.d.ts

@@ -0,0 +1,5 @@
+import { LLMConfig } from "@pulse-editor/shared-utils";
+export default function useAgents(): {
+    runAgentMethod: (agentName: string, methodName: string, parameters: Record<string, any>, abortSignal?: AbortSignal, llmConfig?: LLMConfig) => Promise<any>;
+    isReady: boolean;
+};

package/dist/hooks/ai-modality/use-image-gen.d.ts

@@ -0,0 +1,8 @@
+import { ImageModelConfig } from "@pulse-editor/shared-utils";
+export default function useImageGen(): {
+    runImageGen: (textPrompt?: string, imagePrompt?: string | ArrayBuffer, imageModelConfig?: ImageModelConfig) => Promise<{
+        arrayBuffer?: ArrayBuffer;
+        url?: string;
+    }>;
+    isReady: boolean;
+};

package/dist/hooks/ai-modality/use-llm.d.ts

@@ -0,0 +1,5 @@
+import { LLMConfig } from "@pulse-editor/shared-utils";
+export default function useLLM(): {
+    runLLM: (prompt: string, llmConfig?: LLMConfig) => Promise<string>;
+    isReady: boolean;
+};

package/dist/hooks/ai-modality/use-ocr.d.ts

@@ -0,0 +1,3 @@
+export default function useOCR(): {
+    recognizeText: (image: string) => Promise<string>;
+};

package/dist/hooks/ai-modality/use-speech2speech.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Use speech-to-speech API to listen to user input and read the output
+ * provided by you.
+ */
+export default function useSpeech2Speech(): {
+    isReady: boolean;
+    userInput: string;
+    isUserStopped: boolean;
+    respondAndRead: (text: string) => Promise<void>;
+};

package/dist/hooks/ai-modality/use-stt.d.ts

@@ -0,0 +1,5 @@
+import { STTConfig } from "@pulse-editor/shared-utils";
+export default function useSTT(): {
+    runSTT: (audio: Uint8Array, sttConfig?: STTConfig) => Promise<string>;
+    isReady: boolean;
+};

package/dist/hooks/ai-modality/use-tts.d.ts

@@ -0,0 +1,5 @@
+import { TTSConfig } from "@pulse-editor/shared-utils";
+export default function useTTS(): {
+    runTTS: (text: string, ttsConfig?: TTSConfig) => Promise<Uint8Array>;
+    isReady: boolean;
+};

package/dist/hooks/ai-modality/use-video-gen.d.ts

@@ -0,0 +1,8 @@
+import { VideoModelConfig } from "@pulse-editor/shared-utils";
+export default function useVideoGen(): {
+    runVideoGen: (duration: number, textPrompt?: string, imagePrompt?: string | ArrayBuffer, videoModelConfig?: VideoModelConfig) => Promise<{
+        url?: string;
+        arrayBuffer?: ArrayBuffer;
+    }>;
+    isReady: boolean;
+};

package/dist/hooks/editor/use-command.d.ts

@@ -0,0 +1,12 @@
+import { CommandInfo } from "@pulse-editor/shared-utils";
+/**
+ * Register an extension command to listen to IMC messages from the core,
+ * and pass to the extension to handle.
+ *
+ * @param commandInfo Command information to register.
+ * @param callbackHandler Callback handler function to handle the command.
+ *
+ */
+export default function useCommand(commandInfo: CommandInfo, callbackHandler?: (args: any) => Promise<string | void>): {
+    isReady: boolean;
+};

package/dist/hooks/editor/use-file-view.d.ts

@@ -0,0 +1,5 @@
+import { ViewModel } from "@pulse-editor/shared-utils";
+export default function useFileView(): {
+    viewModel: ViewModel | undefined;
+    updateViewModel: (viewModel: ViewModel) => void;
+};

package/dist/hooks/editor/use-loading.d.ts

@@ -0,0 +1,4 @@
+export default function useLoading(): {
+    isReady: boolean;
+    toggleLoading: (isLoading: boolean) => void;
+};

package/dist/hooks/editor/use-mic.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Use the microphone to record audio. (WIP)
+ */
+export default function useMic(): void;

package/dist/hooks/{use-notification.d.ts → editor/use-notification.d.ts}

@@ -1,4 +1,4 @@
 import { NotificationTypeEnum } from "@pulse-editor/shared-utils";
-export default function useNotification(moduleName: string): {
+export default function useNotification(): {
     openNotification: (text: string, type: NotificationTypeEnum) => void;
 };

package/dist/hooks/editor/use-theme.d.ts

@@ -0,0 +1,3 @@
+export default function useTheme(): {
+    theme: string;
+};

package/dist/hooks/editor/use-toolbar.d.ts

@@ -0,0 +1 @@
+export default function useToolbar(): {};

package/dist/hooks/terminal/use-terminal.d.ts

@@ -0,0 +1,4 @@
+export default function useTerminal(): {
+    websocketUrl: string | undefined;
+    projectHomePath: string | undefined;
+};

package/dist/lib/{hooks/use-imc.d.ts → use-imc.d.ts}

@@ -1,6 +1,6 @@
 import { InterModuleCommunication } from "@pulse-editor/shared-utils";
 import { ReceiverHandlerMap } from "@pulse-editor/shared-utils";
-export default function useIMC(moduleName: string, handlerMap: ReceiverHandlerMap): {
+export default function useIMC(handlerMap: ReceiverHandlerMap): {
     imc: InterModuleCommunication | undefined;
     isReady: boolean;
 };

package/dist/main.d.ts

@@ -1,7 +1,16 @@
-import useFileView from "./hooks/use-file-view";
-import useTheme from "./hooks/use-theme";
-import useNotification from "./hooks/use-notification";
-import useAgents from "./hooks/use-agents";
-import useOCR from "./hooks/use-orc";
-import useTerminal from "./hooks/use-terminal";
-export { useFileView, useTheme, useNotification, useAgents, useOCR, useTerminal, };
+import useAgentTools from "./hooks/agent/use-agent-tools";
+import useAgents from "./hooks/agent/use-agents";
+import useFileView from "./hooks/editor/use-file-view";
+import useLoading from "./hooks/editor/use-loading";
+import useNotification from "./hooks/editor/use-notification";
+import useTheme from "./hooks/editor/use-theme";
+import useToolbar from "./hooks/editor/use-toolbar";
+import useCommand from "./hooks/editor/use-command";
+import useImageGen from "./hooks/ai-modality/use-image-gen";
+import useLLM from "./hooks/ai-modality/use-llm";
+import useOCR from "./hooks/ai-modality/use-ocr";
+import useSTT from "./hooks/ai-modality/use-stt";
+import useTTS from "./hooks/ai-modality/use-tts";
+import useVideoGen from "./hooks/ai-modality/use-video-gen";
+import useTerminal from "./hooks/terminal/use-terminal";
+export { useAgentTools, useAgents, useFileView, useNotification, useTheme, useToolbar, useImageGen, useVideoGen, useLLM, useOCR, useSTT, useTTS, useCommand, useTerminal, useLoading, };

package/dist/main.js

@@ -1 +1 @@
-"use strict";var e=require("@pulse-editor/shared-utils"),n=require("react");function t(t,s){const[i,a]=n.useState(void 0),[o,r]=n.useState(!1),u=window.parent;return n.useEffect((()=>{const n=new e.InterModuleCommunication(t);return n.initThisWindow(window),n.updateReceiverHandlerMap(s),n.initOtherWindow(u),a(n),n.sendMessage(e.IMCMessageTypeEnum.Ready).then((()=>{r(!0)})),()=>{n.close()}}),[]),{imc:i,isReady:o}}exports.useAgents=function(n){const s=new Map,{imc:i,isReady:a}=t(n,s);return{installAgent:async function(n){if(!i)throw new Error("IMC not initialized.");await i.sendMessage(e.IMCMessageTypeEnum.InstallAgent,n).catch((e=>{throw new Error(e)}))},runAgentMethod:async function(n,t,s,a){if(!i)throw new Error("IMC not initialized.");return await i.sendMessage(e.IMCMessageTypeEnum.RunAgentMethod,{agentName:n,methodName:t,parameters:s},a).then((e=>e))},isReady:a}},exports.useFileView=function(s){const[i,a]=n.useState(void 0),[o,r]=n.useState(!1),u=new Map,{imc:c,isReady:M}=t(s,u);return n.useEffect((()=>{M&&c?.sendMessage(e.IMCMessageTypeEnum.RequestViewFile).then((e=>{a(e)}))}),[M]),n.useEffect((()=>{o&&c?.sendMessage(e.IMCMessageTypeEnum.Loaded)}),[o,c]),{viewFile:i,updateViewFile:function(n){c?.sendMessage(e.IMCMessageTypeEnum.WriteViewFile,n)},setIsLoaded:r}},exports.useNotification=function(n){const s=new Map,{imc:i}=t(n,s);return{openNotification:function(n,t){if(!i)throw new Error("IMC is not initialized.");i.sendMessage(e.IMCMessageTypeEnum.Notification,{text:n,type:t})}}},exports.useOCR=function(n){const s=new Map,{imc:i}=t(n,s);return{recognizeText:async function(n){if(!i)throw new Error("IMC is not initialized.");return(await i.sendMessage(e.IMCMessageTypeEnum.OCR,{uri:n})).payload.text}}},exports.useTerminal=function(s){const i=new Map,{imc:a,isReady:o}=t(s,i),[r,u]=n.useState(void 0);return n.useEffect((()=>{o&&a?.sendMessage(e.IMCMessageTypeEnum.RequestTerminal).then((n=>{const{websocketUrl:t}=n;u(t),a.sendMessage(e.IMCMessageTypeEnum.Loaded)}))}),[o]),{websocketUrl:r}},exports.useTheme=function(s){const[i,a]=n.useState("light"),o=new Map;return o.set(e.IMCMessageTypeEnum.ThemeChange,(async(e,n)=>{const t=n.payload;a((e=>t))})),t(s,o),{theme:i}};
+import{InterModuleCommunication as e,IMCMessageTypeEnum as t}from"@pulse-editor/shared-utils";import{useState as n,useEffect as i}from"react";function r(r){const[o,a]=n(void 0),[s,d]=n(!1),[c,u]=n(!1),f=window.parent;return i(()=>(u(!0),()=>{u(!1),o?.close(),a(void 0)}),[]),i(()=>{!async function(){if(!c)return;if(void 0!==o)return;const n=new e;n.initThisWindow(window),n.updateReceiverHandlerMap(r),await n.initOtherWindow(f),a(n),n.sendMessage(t.ExtReady).then(()=>{d(!0)})}()},[c,o]),{imc:o,isReady:s}}function o(){return r(new Map),{}}function a(){const e=new Map,{imc:n,isReady:i}=r(e);return{runAgentMethod:async function(e,i,r,o,a){if(!n)throw new Error("IMC not initialized.");return await n.sendMessage(t.EditorRunAgentMethod,{agentName:e,methodName:i,parameters:r,llmConfig:a},o).then(e=>e)},isReady:i}}function s(){const[e,o]=n(void 0),a=new Map,{imc:s,isReady:d}=r(a);return i(()=>{d&&s?.sendMessage(t.PlatformReadFile).then(e=>{o(e)})},[d]),{viewModel:e,updateViewModel:function(e){s?.sendMessage(t.PlatformWriteFile,e)}}}function d(){const e=new Map,{imc:o,isReady:a}=r(e),[s,d]=n(!0);return i(()=>{a&&o?.sendMessage(t.EditorLoadingExt,{isLoading:s})},[s]),{isReady:a,toggleLoading:function(e){d(t=>e)}}}function c(){const e=new Map,{imc:n}=r(e);return{openNotification:function(e,i){if(!n)throw new Error("IMC is not initialized.");n.sendMessage(t.EditorShowNotification,{text:e,type:i})}}}function u(){const[e,i]=n("light"),o=new Map;return o.set(t.EditorThemeUpdate,async(e,t)=>{const n=t.payload;i(e=>n)}),r(o),{theme:e}}function f(){return{}}function w(e,o){const{isReady:a,imc:s}=r(u()),[d,c]=n(void 0);function u(){return new Map([[t.EditorRunExtCommand,async(t,n)=>{if(!e)throw new Error("Extension command is not available");const{name:i,args:r}=n.payload;if(i===e.name){const t=e.parameters;if(Object.keys(r).length!==Object.keys(t).length)throw new Error(`Invalid number of parameters: expected ${Object.keys(t).length}, got ${Object.keys(r).length}`);for(const[t,n]of Object.entries(r)){if(void 0===e.parameters[t])throw new Error(`Invalid parameter: ${t}`);if(typeof n!==e.parameters[t].type)throw new Error(`Invalid type for parameter ${t}: expected ${e.parameters[t].type}, got ${typeof n}. Value received: ${n}`)}if(d){const e=await d(r);if(e)return e}}}]])}return i(()=>{s?.updateReceiverHandlerMap(u())},[d,s]),i(()=>{c(()=>o)},[o]),{isReady:a}}function m(){const e=new Map,{imc:n,isReady:i}=r(e);return{runImageGen:async function(e,i,r){if(!n)throw new Error("IMC not initialized.");if(!e&&!i)throw new Error("At least one of textPrompt or imagePrompt is required.");return await n.sendMessage(t.ModalityImageGen,{textPrompt:e,imagePrompt:i,imageModelConfig:r}).then(e=>e)},isReady:i}}function p(){const e=new Map,{imc:n,isReady:i}=r(e);return{runLLM:async function(e,i){if(!n)throw new Error("IMC not initialized.");return await n.sendMessage(t.ModalityLLM,{prompt:e,llmConfig:i}).then(e=>e)},isReady:i}}function l(){const e=new Map,{imc:n}=r(e);return{recognizeText:async function(e){if(!n)throw new Error("IMC is not initialized.");return(await n.sendMessage(t.ModalityOCR,{image:e})).payload.text}}}function M(){const e=new Map,{imc:n,isReady:i}=r(e);return{runSTT:async function(e,i){if(!n)throw new Error("IMC not initialized.");return await n.sendMessage(t.ModalitySTT,{audio:e,sttConfig:i}).then(e=>e)},isReady:i}}function y(){const e=new Map,{imc:n,isReady:i}=r(e);return{runTTS:async function(e,i){if(!n)throw new Error("IMC not initialized.");return await n.sendMessage(t.ModalityTTS,{text:e,ttsConfig:i}).then(e=>e)},isReady:i}}function g(){const e=new Map,{imc:n,isReady:i}=r(e);return{runVideoGen:async function(e,i,r,o){if(!n)throw new Error("IMC not initialized.");if(!i&&!r)throw new Error("At least one of textPrompt or imagePrompt is required.");return await n.sendMessage(t.ModalityVideoGen,{duration:e,textPrompt:i,imagePrompt:r,videoModelConfig:o}).then(e=>e)},isReady:i}}function h(){const e=new Map,{imc:o,isReady:a}=r(e),[s,d]=n(void 0),[c,u]=n(void 0);return i(()=>{a&&o?.sendMessage(t.PlatformCreateTerminal).then(e=>{const{websocketUrl:t,projectHomePath:n}=e;d(t),u(n)})},[a]),{websocketUrl:s,projectHomePath:c}}export{o as useAgentTools,a as useAgents,w as useCommand,s as useFileView,m as useImageGen,p as useLLM,d as useLoading,c as useNotification,l as useOCR,M as useSTT,y as useTTS,h as useTerminal,u as useTheme,f as useToolbar,g as useVideoGen};

package/package.json

@@ -1,14 +1,15 @@
 {
   "name": "@pulse-editor/react-api",
-  "version": "0.1.1-alpha.3",
-  "main": "src/main.ts",
-  "type": "module",
+  "version": "0.1.1-alpha.30",
+  "main": "dist/main.js",
   "files": [
     "dist"
   ],
   "publishConfig": {
     "access": "public"
   },
+  "types": "dist/main.d.ts",
+  "type": "module",
   "scripts": {
     "build": "npm run clean && rollup -c",
     "lint": "eslint .",
@@ -37,7 +38,7 @@
     "typescript-eslint": "^8.30.1"
   },
   "peerDependencies": {
-    "@pulse-editor/shared-utils": "0.1.1-alpha.3",
+    "@pulse-editor/shared-utils": "0.1.1-alpha.30",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"
   }

package/dist/hooks/use-agent-tools.d.ts

@@ -1,4 +0,0 @@
-import { AgentTool } from "@pulse-editor/shared-utils";
-export default function useAgentTools(moduleName: string): {
-    installAgentTool: (tool: AgentTool) => Promise<void>;
-};

package/dist/hooks/use-agents.d.ts

@@ -1,6 +0,0 @@
-import { Agent } from "@pulse-editor/shared-utils";
-export default function useAgents(moduleName: string): {
-    installAgent: (config: Agent) => Promise<void>;
-    runAgentMethod: (agentName: string, methodName: string, parameters: Record<string, any>, abortSignal?: AbortSignal) => Promise<Record<string, any>>;
-    isReady: boolean;
-};

package/dist/hooks/use-fetch.d.ts

@@ -1,3 +0,0 @@
-export default function useFetch(moduleName: string): {
-    fetch: (uri: string, options?: RequestInit) => Promise<Response>;
-};

package/dist/hooks/use-file-view.d.ts

@@ -1,6 +0,0 @@
-import { FileViewModel } from "@pulse-editor/shared-utils";
-export default function useFileView(moduleName: string): {
-    viewFile: FileViewModel | undefined;
-    updateViewFile: (file: FileViewModel) => void;
-    setIsLoaded: import("react").Dispatch<import("react").SetStateAction<boolean>>;
-};

package/dist/hooks/use-orc.d.ts

@@ -1,3 +0,0 @@
-export default function useOCR(moduleName: string): {
-    recognizeText: (uri: string) => Promise<string>;
-};

package/dist/hooks/use-terminal.d.ts

@@ -1,3 +0,0 @@
-export default function useTerminal(moduleName: string): {
-    websocketUrl: string | undefined;
-};

package/dist/hooks/use-theme.d.ts

@@ -1,3 +0,0 @@
-export default function useTheme(moduleName: string): {
-    theme: string;
-};

package/dist/main.es.js

@@ -1 +0,0 @@
-import{InterModuleCommunication as e,IMCMessageTypeEnum as n}from"@pulse-editor/shared-utils";import{useState as t,useEffect as i}from"react";function o(o,s){const[a,r]=t(void 0),[d,c]=t(!1),w=window.parent;return i((()=>{const t=new e(o);return t.initThisWindow(window),t.updateReceiverHandlerMap(s),t.initOtherWindow(w),r(t),t.sendMessage(n.Ready).then((()=>{c(!0)})),()=>{t.close()}}),[]),{imc:a,isReady:d}}function s(e){const[s,a]=t(void 0),[r,d]=t(!1),c=new Map,{imc:w,isReady:u}=o(e,c);return i((()=>{u&&w?.sendMessage(n.RequestViewFile).then((e=>{a(e)}))}),[u]),i((()=>{r&&w?.sendMessage(n.Loaded)}),[r,w]),{viewFile:s,updateViewFile:function(e){w?.sendMessage(n.WriteViewFile,e)},setIsLoaded:d}}function a(e){const[i,s]=t("light"),a=new Map;return a.set(n.ThemeChange,(async(e,n)=>{const t=n.payload;s((e=>t))})),o(e,a),{theme:i}}function r(e){const t=new Map,{imc:i}=o(e,t);return{openNotification:function(e,t){if(!i)throw new Error("IMC is not initialized.");i.sendMessage(n.Notification,{text:e,type:t})}}}function d(e){const t=new Map,{imc:i,isReady:s}=o(e,t);return{installAgent:async function(e){if(!i)throw new Error("IMC not initialized.");await i.sendMessage(n.InstallAgent,e).catch((e=>{throw new Error(e)}))},runAgentMethod:async function(e,t,o,s){if(!i)throw new Error("IMC not initialized.");return await i.sendMessage(n.RunAgentMethod,{agentName:e,methodName:t,parameters:o},s).then((e=>e))},isReady:s}}function c(e){const t=new Map,{imc:i}=o(e,t);return{recognizeText:async function(e){if(!i)throw new Error("IMC is not initialized.");return(await i.sendMessage(n.OCR,{uri:e})).payload.text}}}function w(e){const s=new Map,{imc:a,isReady:r}=o(e,s),[d,c]=t(void 0);return i((()=>{r&&a?.sendMessage(n.RequestTerminal).then((e=>{const{websocketUrl:t}=e;c(t),a.sendMessage(n.Loaded)}))}),[r]),{websocketUrl:d}}export{d as useAgents,s as useFileView,r as useNotification,c as useOCR,w as useTerminal,a as useTheme};

package/src/main.ts

@@ -1,15 +0,0 @@
-import useFileView from "./hooks/use-file-view";
-import useTheme from "./hooks/use-theme";
-import useNotification from "./hooks/use-notification";
-import useAgents from "./hooks/use-agents";
-import useOCR from "./hooks/use-orc";
-import useTerminal from "./hooks/use-terminal";
-
-export {
-  useFileView,
-  useTheme,
-  useNotification,
-  useAgents,
-  useOCR,
-  useTerminal,
-};