improvement(editor): convert new inline comments to concise TSDoc

Replaces the multi-line // comment blocks introduced by this PR (render-phase
adjustment rationale, derived-in-render notes) with concise TSDoc, per the
repo's TSDoc-only comment convention. Comment-only; no code changes.

Author: waleedlatif1

apps/sim/app/workspace/[workspaceId]/w/[workflowId]/components/panel/components/copilot/components/user-input/hooks/use-mention-tokens.ts

@@ -57,7 +57,7 @@ export function useMentionTokens({
     // when multiple contexts share the same label
     const uniqueLabels = Array.from(new Set(labels))
 
-    // Precompute first-matching context per label for O(1) lookups in the loop
+    /** First-matching context per label, for O(1) lookup while tokenizing. */
     const contextByLabel = new Map<string, (typeof selectedContexts)[number]>()
     for (const c of selectedContexts) {
       if (c.label && !contextByLabel.has(c.label)) contextByLabel.set(c.label, c)

apps/sim/app/workspace/[workspaceId]/w/[workflowId]/components/panel/components/editor/components/sub-block/components/document-tag-entry/document-tag-entry.tsx

@@ -192,8 +192,7 @@ export function DocumentTagEntry({
   const tags: DocumentTag[] = parsedTags.length > 0 ? parsedTags : [createDefaultTag()]
   const isReadOnly = isPreview || disabled
 
-  // Get tag names already used (case-insensitive).
-  // `tags` is rebuilt every render, so this is computed during render rather than memoized.
+  /** Tag names already in use (case-insensitive); computed in render since `tags` is rebuilt each render. */
   const usedTagNames = (() => {
     const names = new Set<string>()
     for (const t of tags) {

apps/sim/app/workspace/[workspaceId]/w/[workflowId]/components/panel/components/editor/components/sub-block/components/file-upload/file-upload.tsx

@@ -632,8 +632,7 @@ export function FileUpload({
     [workspaceFiles, acceptedTypes]
   )
 
-  // Find the selected file's workspace ID for highlighting in single file mode.
-  // `filesArray` is rebuilt every render, so this is computed during render rather than memoized.
+  /** Selected file's workspace id for single-file highlighting; computed in render since `filesArray` is rebuilt each render. */
   const selectedFileId = (() => {
     if (!hasFiles || multiple) return ''
     const currentFile = filesArray[0]

apps/sim/app/workspace/[workspaceId]/w/[workflowId]/components/panel/components/editor/components/sub-block/components/long-input/long-input.tsx

@@ -204,9 +204,10 @@ export function LongInput({
       ? propValue
       : ctrl.valueString
 
-  // Sync local content with base value when not streaming by adjusting state
-  // during render (no effect), so the wand's currentValue stays current without
-  // an extra commit. localContent is only displayed while streaming.
+  /**
+   * Sync local content with the base value when not streaming, adjusted during render (no effect)
+   * so the wand's currentValue never lags a commit. localContent is shown only while streaming.
+   */
   if (!wandHook.isStreaming) {
     const baseValueString = baseValue?.toString() ?? ''
     if (baseValueString !== localContent) {

apps/sim/app/workspace/[workspaceId]/w/[workflowId]/components/panel/components/editor/components/sub-block/hooks/use-sub-block-value.ts

@@ -207,8 +207,7 @@ export function useSubBlockValue<T = any>(
       ? storeValue
       : initialValue
 
-  // Keep the ref in sync with the effective value so we always work with the latest value.
-  // On first render valueRef starts as null, so this effect also performs the initial seed.
+  /** Mirror the latest effective value into the ref; also seeds it on first render (ref starts null). */
   useEffect(() => {
     // Use deep comparison for objects to prevent unnecessary updates
     if (!isEqual(valueRef.current, effectiveValue)) {

apps/sim/app/workspace/[workspaceId]/w/[workflowId]/workflow.tsx

@@ -2621,11 +2621,11 @@ const WorkflowContent = React.memo(
       syncPanelWithSelection(selectedNodeIds)
     }, [selectedNodeIdsKey])
 
-    // Keep the most recently selected block on top even after deselection, so a
-    // dragged block doesn't suddenly drop behind other overlapping blocks. Adjust
-    // during render (not through an effect) so the latched id never lags a commit
-    // behind the selection it mirrors. It retains the previous value when the
-    // selection is cleared, so this is a latch rather than plain derived state.
+    /**
+     * Keep the most recently selected block on top even after deselection (so a dragged block
+     * doesn't drop behind overlapping blocks). Latched during render — retains the previous id
+     * when the selection clears, so it's a latch rather than plain derived state.
+     */
     const lastSelectedNodeId =
       selectedNodeIds.length > 0 ? selectedNodeIds[selectedNodeIds.length - 1] : null
     if (lastSelectedNodeId !== null && lastSelectedNodeId !== lastInteractedNodeId) {

apps/sim/app/workspace/[workspaceId]/w/components/sidebar/components/workspace-header/components/fork-workspace-modal/fork-workspace-modal.tsx

@@ -108,9 +108,11 @@ export function ForkWorkspaceModal({
   const [forkedWorkspace, setForkedWorkspace] = useState<{ id: string; name: string } | null>(null)
   const [confirmRollbackOpen, setConfirmRollbackOpen] = useState(false)
 
-  // Reset the modal to a fresh state each time it opens (or the source name changes while
-  // open). Adjusted during render via prev-value refs rather than a post-commit effect, so the
-  // reopened modal never briefly commits the previous fork's name/selection before clearing it.
+  /**
+   * Reset the modal to a fresh state on open or when the source name changes while open.
+   * Adjusted during render so the reopened modal never commits the previous fork's
+   * name/selection before clearing it.
+   */
   const prevOpenRef = useRef(open)
   const prevSourceNameRef = useRef(sourceWorkspaceName)
   if (open && (prevOpenRef.current !== open || prevSourceNameRef.current !== sourceWorkspaceName)) {
@@ -125,9 +127,7 @@ export function ForkWorkspaceModal({
   prevOpenRef.current = open
   prevSourceNameRef.current = sourceWorkspaceName
 
-  // Seed the selection with everything the moment the resources query resolves (once per open,
-  // guarded by `defaulted`). Adjusted during render for the same reason as the reset above:
-  // routing it through an effect would commit an empty selection for a frame before the default.
+  /** Seed the full selection once the resources query resolves (once per open, guarded by `defaulted`). */
   if (open && resources.data && !defaulted) {
     setDefaulted(true)
     setSelected(fullSelection(resources.data))

apps/sim/app/workspace/[workspaceId]/w/components/sidebar/components/workspace-header/components/promote-workspace-modal/promote-workspace-modal.tsx

@@ -216,10 +216,11 @@ export function PromoteWorkspaceModal({
   const [confirmSyncOpen, setConfirmSyncOpen] = useState(false)
   const [submitting, setSubmitting] = useState(false)
 
-  // Seed the direction picker when the modal opens (or the parent edge changes while it's
-  // open). Adjusted during render via a prev-value compare so the seeded value lands before
-  // paint instead of a post-paint effect flashing the prior selection. `selectedKey` stays
-  // editable (the dropdown sets it), so it isn't derived state.
+  /**
+   * Seed the direction picker when the modal opens or the parent edge changes while open.
+   * Adjusted during render so the value lands before paint; `selectedKey` stays editable (the
+   * dropdown sets it), so it isn't derived state.
+   */
   const prevOpenSeedRef = useRef(false)
   const prevEdgeOptionsRef = useRef(edgeOptions)
   const openSeedChanged = prevOpenSeedRef.current !== open
@@ -230,11 +231,11 @@ export function PromoteWorkspaceModal({
     setSelectedKey(edgeOptions[0]?.value ?? '')
   }
 
-  // Restart at the overview and drop in-session overrides whenever it (re)opens or the
-  // direction changes - the mapping set, and therefore the steps, depend on the direction.
-  // Adjusted during render (prev-value compare) so the reset lands before paint rather than
-  // an effect flashing the prior edge's state. `copyDefaulted` stays state so its reset here
-  // re-triggers the copy-default effect below (needed on a reopen with cached diff data).
+  /**
+   * Restart at the overview and drop in-session overrides on (re)open or direction change (the
+   * mapping set, and therefore the steps, depend on direction). Adjusted during render;
+   * `copyDefaulted` stays state so its reset here re-triggers the copy-default effect below.
+   */
   const prevOpenResetRef = useRef(false)
   const prevSelectedKeyRef = useRef(selectedKey)
   const openResetChanged = prevOpenResetRef.current !== open