@molecule/app-node-editor-panel-react

Auto-generated, AI-first package reference for the molecule.dev ecosystem. It is written to be read by coding agents as much as by people, and is generated from this package's source — edit src/index.ts JSDoc, not this file.

@molecule/app-node-editor-panel-react — right-side properties panel for node-based editors (chatbot-builder bot nodes, workflow canvases, design-tool inspector panes).

Composable sub-primitives:

• <NodeEditorPanel> — aside chrome with title row, scroll body, footer.
• <NodeEditorSection> — labeled section with optional trailing slot.
• <NodeEditorSlider> — range slider with mono-font value chip.
• <NodeEditorToggle> — switch row with optional icon tile.
• <NodeEditorRadioGroup> — radio list with custom radio dots.

Consumer brings the form state; the package handles structure and styling.

Quick Start

import { useState } from 'react'

import {
  NodeEditorPanel,
  NodeEditorRadioGroup,
  NodeEditorSection,
  NodeEditorSlider,
  NodeEditorToggle,
} from '@molecule/app-node-editor-panel-react'

function Inspector() {
  const [temperature, setTemperature] = useState(0.7)
  const [kbEnabled, setKbEnabled] = useState(false)
  const [format, setFormat] = useState('conversational')
  return (
    <NodeEditorPanel title="Node Properties" onClose={() => {}}>
      <NodeEditorSlider label="Temperature" value={temperature} onChange={setTemperature} />
      <NodeEditorToggle
        title="Knowledge Base"
        icon="database"
        checked={kbEnabled}
        onChange={setKbEnabled}
      />
      <NodeEditorSection label="Response Format">
        <NodeEditorRadioGroup
          value={format}
          onChange={setFormat}
          options={[
            { value: 'conversational', label: 'Conversational' },
            { value: 'structured', label: 'Structured' },
          ]}
        />
      </NodeEditorSection>
    </NodeEditorPanel>
  )
}

Type

feature

Installation

npm install @molecule/app-node-editor-panel-react @molecule/app-react @molecule/app-ui @molecule/app-ui-react react
npm install -D @types/react

API

Interfaces

NodeEditorPanelProps

Props for {@link NodeEditorPanel}.

interface NodeEditorPanelProps {
  title: ReactNode
  children?: ReactNode
  /** Footer slot — typically the save bar + status row. */
  footer?: ReactNode
  /** Click handler for the close button (omitted if `onClose` is null). */
  onClose?: () => void
  closeAriaLabel?: string
  /** Tailwind width class fragment; defaults to `w-80` (20rem). */
  widthClass?: string
}

NodeEditorRadioGroupProps

Props for {@link NodeEditorRadioGroup}.

interface NodeEditorRadioGroupProps<T extends string> {
  options: NodeEditorRadioOption<T>[]
  value: T
  onChange: (next: T) => void
}

NodeEditorRadioOption

One selectable option in a {@link NodeEditorRadioGroup}.

interface NodeEditorRadioOption<T extends string> {
  value: T
  label: ReactNode
}

NodeEditorSectionProps

Props for {@link NodeEditorSection}.

interface NodeEditorSectionProps {
  label: ReactNode
  children?: ReactNode
  /** Optional content rendered on the right side of the label row (value chip, numeric input). */
  trailing?: ReactNode
  /** Stack gap between section header and children (default 3). */
  gap?: 1 | 2 | 3 | 4 | 5 | 6 | 8
}

NodeEditorSliderProps

Props for {@link NodeEditorSlider}.

interface NodeEditorSliderProps {
  label: ReactNode
  value: number
  onChange: (next: number) => void
  min?: number
  max?: number
  step?: number
  /** Rendered as the trailing value chip; defaults to `value`. */
  valueDisplay?: ReactNode
}

NodeEditorToggleProps

Props for {@link NodeEditorToggle}.

interface NodeEditorToggleProps {
  title: ReactNode
  subtitle?: ReactNode
  /** Material-symbols icon for the leading tile (omit for no tile). */
  icon?: string
  checked: boolean
  onChange: (next: boolean) => void
  ariaLabel?: string
}

Functions

NodeEditorPanel(props)

Properties panel chrome.

function NodeEditorPanel({
  title,
  children,
  footer,
  onClose,
  closeAriaLabel = 'Close panel',
  widthClass,
}: NodeEditorPanelProps): JSX.Element

NodeEditorRadioGroup(props)

Radio list.

function NodeEditorRadioGroup({
  options,
  value,
  onChange,
}: NodeEditorRadioGroupProps<T>): JSX.Element

NodeEditorSection(props)

Labeled section.

function NodeEditorSection({
  label,
  children,
  trailing,
  gap = 3,
}: NodeEditorSectionProps): JSX.Element

NodeEditorSlider(props)

Range slider section.

function NodeEditorSlider({
  label,
  value,
  onChange,
  min = 0,
  max = 1,
  step = 0.1,
  valueDisplay,
}: NodeEditorSliderProps): JSX.Element

NodeEditorToggle(props)

Toggle row.

function NodeEditorToggle({
  title,
  subtitle,
  icon,
  checked,
  onChange,
  ariaLabel,
}: NodeEditorToggleProps): JSX.Element

Injection Notes

Requirements

Peer dependencies:

• @molecule/app-react ^1.0.1
• @molecule/app-ui ^1.0.1
• @molecule/app-ui-react ^1.0.1
• react ^18.0.0 || ^19.0.0

Runtime Dependencies

• @molecule/app-react
• @molecule/app-ui
• @molecule/app-ui-react
• react

KNOWN LIMITATION — this package currently styles itself with raw Tailwind classes and Material-3 color tokens (bg-surface-container-low, text-on-surface-variant, border-outline-variant, accent-primary, w-80, ...) instead of ClassMap resolvers. Out of the box in a standard molecule app the panel renders UNSTYLED because (a) the app's Tailwind build does not scan this package's dist for class literals, and (b) the M3 color tokens are not defined by standard themes. To adopt it today you must add an @source "<path-to>/app-node-editor-panel-react/dist" line to the app's Tailwind CSS AND define the referenced surface-container-* / on-surface* / outline-variant theme colors.

The close button and NodeEditorToggle.icon render Material Symbols LIGATURES — without the "Material Symbols Outlined" font loaded and a material-symbols-outlined CSS class defined, icon names render as plain text (e.g. the word "close").

A wired ClassMap bond is still required for the layout helpers — getClassMap() throws before wiring. The close button's default aria-label is English-only; pass closeAriaLabel with a translated string in localized apps.