@molecule/app-ide-react 3.2.0 → 4.0.0

package/README.md

@@ -3,7 +3,7 @@ AUTO-GENERATED — DO NOT EDIT THIS FILE.
 Generated by `mlcl sync-docs` from the package's src/index.ts JSDoc + mlcl/registry.json.
 Edits here are overwritten on the next commit (molecule's pre-commit hook regenerates).
 To change this document, edit the module-level JSDoc in src/index.ts.
-Generated: 2026-11-01T15:38:20.051Z
+Generated: 2026-11-12T04:40:46.343Z
 -->
 
 # @molecule/app-ide-react
@@ -884,139 +884,91 @@ actions, etc.).
 interface ChatPanelProps {
   projectId: string
   endpoint?: string
-  /** If provided, auto-send this message once on mount (e.g., prompt from landing page). */
   initialMessage?: string
-  /** Called after the initial message has been sent — used to clear router state. */
   onInitialMessageSent?: () => void
-  /** Called to open a file as a preview tab. `opts.focus === false` opens it quietly (no pane switch) — e.g. a saved plan or a system-initiated open while the user is busy. */
   onFileOpen?: (path: string, opts?: { focus?: boolean }) => void
-  /** Called when a filename in a tool call is double-clicked — should pin the tab. */
   onFileDoubleClick?: (path: string) => void
-  /** Called when a file in the uncommitted list is clicked for diff view. */
   onFileDiff?: (path: string, diff?: { original: string; modified: string }) => void
-  /** Called to undo/redo a file change — writes the given content to the file path. */
   onFileRevert?: (path: string, content: string) => Promise<void>
-  /** Called when the AI creates or modifies a file — should refresh the editor if the file is open. */
   onFileChange?: (path: string, content: string) => void
-  /** Called when a file is removed from disk (e.g. reverting an untracked file). */
   onFileDeleted?: (path: string) => void
-  /** Called after a commit or no-op — should refresh file explorer git status. */
   onCommit?: () => void
-  /** Called when an inline activity card is clicked — should open the Activity panel filtered to this activity. */
   onActivityClick?: (activity: ActivityFromCard) => void
-  /**
-   * Reports a chat timeline item that threw during render, caught by that item's
-   * error boundary. The item degrades to an inline notice either way; this is how the
-   * host gets the crash into its telemetry instead of it being visible only to the
-   * one user who hit it.
-   */
   onRenderError?: (error: Error, info: ErrorInfo) => void
-  /**
-   * Called when a user avatar or author name in the chat timeline is clicked —
-   * the host opens THAT user's profile (e.g. molecule.dev's profile modal).
-   * Receives the clicked author's {@link ChatUserIdentity}: a teammate's click
-   * carries their persisted author fields, the signed-in user's own click
-   * carries their own — the host compares `id` against the signed-in user to
-   * decide editable-own vs view-only-teammate. Omit it (the default) to render
-   * the avatars/names non-interactive (static, exactly as before). Only human
-   * authors are clickable — the molecule glyph on auto-sent messages is not.
-   */
   onProfileClick?: (user: ChatUserIdentity) => void
-  /**
-   * The signed-in user's id (a message's persisted `author.id`). Used to stamp
-   * the identity handed to {@link onProfileClick} for AUTHOR-LESS messages (the
-   * local optimistic echo, legacy solo rows), which are always the signed-in
-   * user's own. Omit in a solo host — those clicks then carry no `id`, which
-   * hosts treat as "the signed-in user".
-   */
   currentUserId?: string
-  /** Called when the server signals (via the `ready_to_build` stream event) that discovery is complete and the sandbox should boot. */
   onReadyToBuild?: () => void
-  /**
-   * True while the plan has finished streaming but the sandbox is still booting
-   * (after `ready_to_build`, before the post-boot build kickoff). When set and no
-   * message is actively streaming, the chat shows a "waiting for the development
-   * environment" indicator so the conversation doesn't appear to silently stall.
-   */
   awaitingSandboxBoot?: boolean
-  /** Called when the agent requests a UI action via the `client_action` stream event (reload/navigate the preview, open a file). */
   onClientAction?: (action: IdeClientAction) => void
-  /** Called on each stream `done` — host uses it to keep the boot view up until the parallel during-boot plan stream finishes. */
   onTurnComplete?: () => void
-  /**
-   * Called whenever the chat's loading state changes — true when a turn (plan or build) is in
-   * progress, false when idle. The host uses this as the authoritative "the agent is actively
-   * building" signal to drive the preview's "Building your app…" overlay, so a half-built /
-   * blank preview during a long build always shows progress instead of a bare white screen.
-   */
   onLoadingChange?: (loading: boolean) => void
-  /**
-   * Navigates the live preview to a route path. Wired so a `[label](/route)` markdown link in
-   * an assistant message (e.g. the agent's "your app is ready" handoff) jumps the preview to
-   * that page on click. User-initiated, so the host should navigate unconditionally (it is not
-   * the rate-limited agent `navigate_preview` action).
-   */
   onNavigatePreview?: (path: string) => void
-  /**
-   * Called on mount with a handler the parent invokes to deliver a broadcast chat event
-   * from another project member (the push channel); called with null on unmount.
-   */
   onRegisterPushHandler?: (
     handler: ((conversationId: string, event: ChatStreamEvent) => void) | null,
   ) => void
-  /**
-   * Called on mount with a function that reloads chat history and converges the
-   * panel on the persisted transcript; called with null on unmount. The host
-   * should invoke it whenever its chat push channel (re)connects: a broadcast
-   * sent while that socket was down (a teammate's team note against a
-   * backgrounded tab or a slept laptop) is otherwise lost until a page
-   * lifecycle event happens to fire. Cheap when nothing changed — an identical
-   * transcript is never re-applied.
-   */
   onRegisterHistoryReconcile?: (reconcile: (() => Promise<void>) | null) => void
-  /** Changing this value submits the current input draft — used to send a prefilled prompt after the prompt→chat morph docks. */
   autoSubmitSignal?: number
-  /** Seeds the input with this text on mount (prompt→chat morph), so the chat input shows the prompt before it is sent. */
   initialInputValue?: string
-  /** Hide the conversation-selector header (e.g. during discovery, before any history is worth showing). */
   hideConversationMenu?: boolean
-  /**
-   * Whether to render the built-in conversation header (the picker + searchable
-   * history dropdown, the share / bug-report / settings buttons, and the
-   * new-chat "+"). Defaults to `true` (the package owns that chrome). Pass
-   * `false` to operate **headless** — the host renders those controls itself
-   * (e.g. molecule.dev's Workspace top bar) and drives the chat through the
-   * controlled props below: {@link ChatPanelProps.conversationId} /
-   * {@link ChatPanelProps.chatKey} / {@link ChatPanelProps.onConversationId} for
-   * the conversation, and {@link ChatPanelProps.openShareSignal} /
-   * {@link ChatPanelProps.openReportSignal} to open the in-chat modals.
-   */
   renderConversationHeader?: boolean
-  /**
-   * Host-controlled active conversation id (headless mode). Drives the chat
-   * endpoint's `?conversationId=`. When `undefined` (the default) the panel owns
-   * the active conversation internally (localStorage-backed). `null` is a valid
-   * controlled value meaning "no conversation yet".
-   */
   conversationId?: string | null
-  /**
-   * Host-controlled remount key for the inner chat (headless mode). Changing it
-   * remounts the conversation timeline (a new chat or a switch); the backend
-   * assigning an id mid-stream must NOT change it (that would drop in-flight
-   * messages). Falls back to the internal key when omitted.
-   */
   chatKey?: string
-  /**
-   * Called whenever the active conversation id changes — the backend assigns one
-   * mid-stream and the host needs it to keep its own picker in sync WITHOUT
-   * remounting (do not change {@link ChatPanelProps.chatKey} in response).
-   */
   onConversationId?: (id: string | null) => void
-  /** Changing this opens the in-chat `/share` modal (host-driven, e.g. a top-bar share button). Overrides the built-in header's share button signal. */
   openShareSignal?: number
-// … truncated — the full declaration is in node_modules/@molecule/app-ide-react/dist/types.d.ts
+  openReportSignal?: number
+  openSettingsSignal?: number
+  onManageCustomModels?: (context?: { mode?: 'plan' | 'execute' }) => void
+  modelSelectionSignal?: number
+  canEdit?: boolean
+  canSendTeamMessages?: boolean
+  canShare?: boolean
+  shareLinksAllowed?: boolean
+  shareLinksRefreshSignal?: number
+  shareModalContent?: ReactNode
+  spinner?: ReactNode
+  activeFile?: string | null
+  openTabs?: string[]
+  gitStatusTick?: number
+  pendingMessage?: string
+  pendingMessageKey?: number
+  pendingMessageSuppressUser?: boolean
+  pendingMessageUserInitiated?: boolean
+  userEditedFile?: string
+  userEditedFileKey?: number
+  isAnonymous?: boolean
+  isPro?: boolean
+  suppressGuestReminder?: boolean
+  buildUpgradeCta?: (context: {
+    requiresSignup?: boolean
+    limitType?: string
+    billingAction?: string
+    upgradeTier?: string | null
+  }) => ChatEventCardAction | ChatEventCardAction[] | null | undefined
+  buildHelpUpgradeSection?: () =>
+    { lines: string[]; action?: ChatEventCardAction | ChatEventCardAction[] } | null | undefined
+  userAvatar?: string | null
+  agentName?: string
+  productName?: string
+  version?: string
+  extraCommands?: readonly CommandDef[]
+  feedbackUrl?: string
+  listTests?: () => Promise<TestList>
+  runTests?: (selection: TestSelection, onEvent: (event: TestRunEvent) => void) => TestRunHandle
+  watchTestRuns?: (onEvent: (event: TestRunFeedEvent) => void) => () => void
+  nativeTests?: {
+    visible: boolean
+    history: ReactNode
+    renderStatus: (openTests: () => void) => ReactNode
+  }
+  canRunTests?: boolean
+  testsAvailable?: boolean
+  skipToolCall?: (toolCallId: string) => void | Promise<boolean | void>
+  className?: string
+}
 ```
 
+_(Member comments are left out to fit; the full declaration is in `node_modules/@molecule/app-ide-react/dist/types.d.ts`.)_
+
 #### `EditorPanelProps`
 
 Properties for the editor panel component.
@@ -3870,10 +3822,10 @@ Peer dependencies:
 - `@molecule/app-ide` ^1.0.1
 - `@molecule/app-live-preview` ^1.0.1
 - `@molecule/app-logger` ^1.0.1
-- `@molecule/app-react` ^3.0.0
+- `@molecule/app-react` ^4.0.0
 - `@molecule/app-storage` ^1.0.1
 - `@molecule/app-ui` ^1.0.1
-- `@molecule/app-ui-react` ^3.0.0
+- `@molecule/app-ui-react` ^4.0.0
 - `react` ^18.0.0 || ^19.0.0
 - `react-dom` ^18.0.0 || ^19.0.0
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@molecule/app-ide-react",
-  "version": "3.2.0",
+  "version": "4.0.0",
   "description": "React IDE components for molecule.dev workspace",
   "type": "module",
   "main": "dist/index.js",
@@ -45,10 +45,10 @@
     "@molecule/app-ide": "^1.0.1",
     "@molecule/app-live-preview": "^1.0.1",
     "@molecule/app-logger": "^1.0.1",
-    "@molecule/app-react": "^3.0.0",
+    "@molecule/app-react": "^4.0.0",
     "@molecule/app-storage": "^1.0.1",
     "@molecule/app-ui": "^1.0.1",
-    "@molecule/app-ui-react": "^3.0.0",
+    "@molecule/app-ui-react": "^4.0.0",
     "react": "^18.0.0 || ^19.0.0",
     "react-dom": "^18.0.0 || ^19.0.0"
   },
@@ -56,19 +56,19 @@
     "material-file-icons": "2.4.0"
   },
   "devDependencies": {
-    "@molecule/app-ai-models": "1.4.3",
+    "@molecule/app-ai-models": "1.4.4",
     "@molecule/app-ai-voice": "1.0.3",
     "@molecule/app-country-flags": "1.0.3",
     "@molecule/app-i18n": "1.1.2",
     "@molecule/app-icons": "1.0.3",
     "@molecule/app-live-preview": "1.0.3",
     "@molecule/app-locales-ide": "1.10.14",
-    "@molecule/app-logger": "1.0.5",
-    "@molecule/app-react": "3.1.0",
+    "@molecule/app-logger": "1.0.6",
+    "@molecule/app-react": "4.0.0",
     "@molecule/app-storage": "1.1.0",
-    "@molecule/app-ui": "1.3.8",
-    "@molecule/app-ui-react": "3.0.4",
-    "@molecule/app-ui-tailwind": "1.2.8",
+    "@molecule/app-ui": "1.3.9",
+    "@molecule/app-ui-react": "4.0.0",
+    "@molecule/app-ui-tailwind": "1.2.9",
     "@testing-library/react": "16.3.3",
     "@types/node": "26.6.5",
     "@types/react": "19.3.0",