@runtypelabs/persona 1.48.0 → 2.0.0

package/src/utils/code-generators.test.ts

@@ -24,6 +24,18 @@ const fullConfig = {
   },
 };
 
+const dockedConfig = {
+  apiUrl: "https://api.example.com/chat",
+  launcher: {
+    mountMode: "docked",
+    dock: {
+      side: "left",
+      width: "480px",
+      collapsedWidth: "84px",
+    },
+  },
+};
+
 // =============================================================================
 // Hook Serialization Tests
 // =============================================================================
@@ -109,6 +121,16 @@ describe("Hook Serialization", () => {
 // =============================================================================
 
 describe("ESM Format Hooks", () => {
+  it("should serialize docked launcher config", () => {
+    const code = generateCodeSnippet(dockedConfig, "esm");
+
+    expect(code).toContain('mountMode: "docked"');
+    expect(code).toContain('dock: {');
+    expect(code).toContain('side: "left"');
+    expect(code).toContain('width: "480px"');
+    expect(code).toContain('collapsedWidth: "84px"');
+  });
+
   it("should inject getHeaders hook", () => {
     const code = generateCodeSnippet(minimalConfig, "esm", {
       hooks: {
@@ -165,6 +187,16 @@ describe("ESM Format Hooks", () => {
 });
 
 describe("React Component Format Hooks", () => {
+  it("should serialize docked launcher config in React component format", () => {
+    const code = generateCodeSnippet(dockedConfig, "react-component");
+
+    expect(code).toContain('mountMode: "docked"');
+    expect(code).toContain('dock: {');
+    expect(code).toContain('side: "left"');
+    expect(code).toContain('width: "480px"');
+    expect(code).toContain('collapsedWidth: "84px"');
+  });
+
   it("should inject hooks in React component format", () => {
     const code = generateCodeSnippet(minimalConfig, "react-component", {
       hooks: {
@@ -191,6 +223,16 @@ describe("React Component Format Hooks", () => {
 });
 
 describe("React Advanced Format Hooks", () => {
+  it("should serialize docked launcher config in React advanced format", () => {
+    const code = generateCodeSnippet(dockedConfig, "react-advanced");
+
+    expect(code).toContain('mountMode: "docked"');
+    expect(code).toContain('dock: {');
+    expect(code).toContain('side: "left"');
+    expect(code).toContain('width: "480px"');
+    expect(code).toContain('collapsedWidth: "84px"');
+  });
+
   it("should inject custom action handlers alongside defaults", () => {
     const code = generateCodeSnippet(minimalConfig, "react-advanced", {
       hooks: {
@@ -242,6 +284,16 @@ describe("React Advanced Format Hooks", () => {
 });
 
 describe("Script Manual Format Hooks", () => {
+  it("should serialize docked launcher config in script-manual format", () => {
+    const code = generateCodeSnippet(dockedConfig, "script-manual");
+
+    expect(code).toContain('mountMode: "docked"');
+    expect(code).toContain('dock: {');
+    expect(code).toContain('side: "left"');
+    expect(code).toContain('width: "480px"');
+    expect(code).toContain('collapsedWidth: "84px"');
+  });
+
   it("should inject hooks in script-manual format", () => {
     const code = generateCodeSnippet(minimalConfig, "script-manual", {
       hooks: {

package/src/utils/code-generators.ts

@@ -497,6 +497,42 @@ function generateHooksConfig(hooks: CodeGeneratorHooks | undefined, indent: stri
   return lines;
 }
 
+function appendSerializableObjectEntries(
+  lines: string[],
+  value: Record<string, unknown>,
+  indent: string
+): void {
+  Object.entries(value).forEach(([key, entryValue]) => {
+    if (entryValue === undefined || typeof entryValue === "function") return;
+
+    if (Array.isArray(entryValue)) {
+      lines.push(`${indent}${key}: ${JSON.stringify(entryValue)},`);
+      return;
+    }
+
+    if (entryValue && typeof entryValue === "object") {
+      lines.push(`${indent}${key}: {`);
+      appendSerializableObjectEntries(lines, entryValue as Record<string, unknown>, `${indent}  `);
+      lines.push(`${indent}},`);
+      return;
+    }
+
+    lines.push(`${indent}${key}: ${JSON.stringify(entryValue)},`);
+  });
+}
+
+function appendSerializableObjectBlock(
+  lines: string[],
+  key: string,
+  value: Record<string, unknown> | undefined,
+  indent: string
+): void {
+  if (!value) return;
+  lines.push(`${indent}${key}: {`);
+  appendSerializableObjectEntries(lines, value, `${indent}  `);
+  lines.push(`${indent}},`);
+}
+
 export function generateCodeSnippet(
   config: any,
   format: CodeFormat = "esm",
@@ -555,15 +591,7 @@ function generateESMCode(config: any, options?: CodeGeneratorOptions): string {
   }
 
   if (config.launcher) {
-    lines.push("    launcher: {");
-    Object.entries(config.launcher).forEach(([key, value]) => {
-      if (typeof value === "string") {
-        lines.push(`      ${key}: "${value}",`);
-      } else if (typeof value === "boolean") {
-        lines.push(`      ${key}: ${value},`);
-      }
-    });
-    lines.push("    },");
+    appendSerializableObjectBlock(lines, "launcher", config.launcher, "    ");
   }
 
   if (config.copy) {
@@ -713,15 +741,7 @@ function generateReactComponentCode(config: any, options?: CodeGeneratorOptions)
   }
 
   if (config.launcher) {
-    lines.push("        launcher: {");
-    Object.entries(config.launcher).forEach(([key, value]) => {
-      if (typeof value === "string") {
-        lines.push(`          ${key}: "${value}",`);
-      } else if (typeof value === "boolean") {
-        lines.push(`          ${key}: ${value},`);
-      }
-    });
-    lines.push("        },");
+    appendSerializableObjectBlock(lines, "launcher", config.launcher, "        ");
   }
 
   if (config.copy) {
@@ -988,15 +1008,7 @@ function generateReactAdvancedCode(config: any, options?: CodeGeneratorOptions):
   }
 
   if (config.launcher) {
-    lines.push("        launcher: {");
-    Object.entries(config.launcher).forEach(([key, value]) => {
-      if (typeof value === "string") {
-        lines.push(`          ${key}: "${value}",`);
-      } else if (typeof value === "boolean") {
-        lines.push(`          ${key}: ${value},`);
-      }
-    });
-    lines.push("        },");
+    appendSerializableObjectBlock(lines, "launcher", config.launcher, "        ");
   }
 
   if (config.copy) {
@@ -1388,15 +1400,7 @@ function generateScriptManualCode(config: any, options?: CodeGeneratorOptions):
   }
 
   if (config.launcher) {
-    lines.push("      launcher: {");
-    Object.entries(config.launcher).forEach(([key, value]) => {
-      if (typeof value === "string") {
-        lines.push(`        ${key}: "${value}",`);
-      } else if (typeof value === "boolean") {
-        lines.push(`        ${key}: ${value},`);
-      }
-    });
-    lines.push("      },");
+    appendSerializableObjectBlock(lines, "launcher", config.launcher, "      ");
   }
 
   if (config.copy) {

package/src/utils/dock.ts

@@ -0,0 +1,17 @@
+import type { AgentWidgetConfig, AgentWidgetDockConfig } from "../types";
+
+const DEFAULT_DOCK_CONFIG: Required<AgentWidgetDockConfig> = {
+  side: "right",
+  width: "420px",
+  collapsedWidth: "72px",
+};
+
+export const isDockedMountMode = (config?: AgentWidgetConfig): boolean =>
+  (config?.launcher?.mountMode ?? "floating") === "docked";
+
+export const resolveDockConfig = (
+  config?: AgentWidgetConfig
+): Required<AgentWidgetDockConfig> => ({
+  ...DEFAULT_DOCK_CONFIG,
+  ...(config?.launcher?.dock ?? {}),
+});