lumiverse-spindle-types 0.2.3 → 0.2.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lumiverse-spindle-types",
-  "version": "0.2.3",
+  "version": "0.2.5",
   "types": "./src/index.ts",
   "keywords": [
     "lumiverse",

package/src/dom.ts

@@ -165,6 +165,26 @@ export interface PermissionRequestOptions {
   reason?: string;
 }
 
+// ── Text Editor ──
+
+export interface SpindleTextEditorOptions {
+  /** Modal title. Default: "Edit Text" */
+  title?: string;
+  /** Initial text content. Default: "" */
+  value?: string;
+  /** Placeholder text. Default: "" */
+  placeholder?: string;
+  /** Enable macro syntax highlighting and insertion panel. Default: true */
+  macros?: boolean;
+}
+
+export interface SpindleTextEditorResult {
+  /** The edited text (or original value if cancelled) */
+  text: string;
+  /** True if the user dismissed the editor without confirming */
+  cancelled: boolean;
+}
+
 /** Context object provided to frontend extension modules */
 export interface SpindleFrontendContext {
   dom: SpindleDOMHelper;
@@ -179,6 +199,26 @@ export interface SpindleFrontendContext {
     requestDockPanel(options: SpindleDockPanelOptions): SpindleDockPanelHandle;
     mountApp(options?: SpindleAppMountOptions): SpindleAppMountHandle;
     registerInputBarAction(options: SpindleInputBarActionOptions): SpindleInputBarActionHandle;
+    /**
+     * Open the native Lumiverse expanded text editor modal.
+     * Provides macro syntax highlighting, macro insertion panel with search,
+     * and a full-screen editing experience.
+     *
+     * Returns a Promise that resolves when the user closes the editor.
+     *
+     * @example
+     * ```ts
+     * const result = await ctx.ui.openTextEditor({
+     *   title: 'Edit System Prompt',
+     *   value: currentText,
+     *   macros: true,
+     * })
+     * if (!result.cancelled) {
+     *   currentText = result.text
+     * }
+     * ```
+     */
+    openTextEditor(options?: SpindleTextEditorOptions): Promise<SpindleTextEditorResult>;
   };
   uploads: {
     pickFile(options?: {

package/src/spindle-api.ts

@@ -402,6 +402,40 @@ export interface SpindleAPI {
     }>;
   };
 
+  /**
+   * Macro resolution (free tier — no permission needed).
+   * Resolve `{{macro}}` placeholders in arbitrary text using
+   * the full Lumiverse macro engine (character fields, chat context,
+   * variables, time/date, random, etc.).
+   */
+  macros: {
+    /**
+     * Resolve all macros in the given template string.
+     * Provide `chatId` and/or `characterId` for full context resolution.
+     * Without them, only context-free macros (time, random, etc.) resolve.
+     *
+     * @example
+     * ```ts
+     * const { text } = await spindle.macros.resolve(
+     *   'Hello {{user}}, I am {{char}}!',
+     *   { chatId: 'abc', characterId: 'xyz' },
+     * )
+     * ```
+     */
+    resolve(
+      template: string,
+      options?: {
+        chatId?: string;
+        characterId?: string;
+        /** For operator-scoped extensions only. */
+        userId?: string;
+      },
+    ): Promise<{
+      text: string;
+      diagnostics: Array<{ message: string; offset: number; length: number }>;
+    }>;
+  };
+
   /**
    * User presence queries (free tier — no permission needed).
    * Check whether a user currently has the Lumiverse app visible/focused