@arronqzy/react-blueprint 1.0.18 → 1.0.21

package/src/components/FetchNodeConfigPanel.tsx

@@ -7,6 +7,10 @@ import {
   SelectItem,
   SelectTrigger,
   SelectValue,
+  Tooltip,
+  TooltipContent,
+  TooltipProvider,
+  TooltipTrigger,
   cn,
 } from "@arronqzy/ui";
 import type {
@@ -14,8 +18,10 @@ import type {
   FetchHttpMethod,
   FetchRequestConfig,
   FetchResponseType,
+  FetchUrlInputMode,
 } from "@arronqzy/blueprint-dsl";
 import {
+  applyApiCollectionEndpointToFetchConfig,
   applyFetchConfigScope,
   draftFetchHeadersText,
   FETCH_CACHES,
@@ -45,7 +51,8 @@ import {
   useFetchDebugTask,
   useSwaggerLoadTask,
 } from "../fetch-config-task-store";
-import { useI18n } from "@arronqzy/i18n/react";
+import { useApiCollections } from "../library/api-collection-store";
+import { useI18nOptional as useI18n } from "@arronqzy/i18n/react";
 
 import { ConfigFieldLabel, ConfigHintIcon, ConfigSectionTitle } from "./ConfigHintIcon";
 import { FetchUrlAutocomplete } from "./FetchUrlAutocomplete";
@@ -274,10 +281,22 @@ export function FetchNodeConfigPanel({
 }: FetchNodeConfigPanelProps) {
   const { t } = useI18n();
   const fetchConfig = resolveNodeFetchConfig(node);
+  const apiCollections = useApiCollections();
   const endpoints = fetchConfig.swaggerEndpoints ?? [];
   const hasSwaggerEndpoints = endpoints.length > 0;
-  const urlInputMode =
+  const urlInputMode: FetchUrlInputMode =
     fetchConfig.urlInputMode ?? (hasSwaggerEndpoints ? "swagger" : "manual");
+  const usingCollection = urlInputMode === "collection";
+  const selectedCollection =
+    apiCollections.find((item) => item.id === fetchConfig.apiCollectionId) ??
+    null;
+  const collectionEndpoints = selectedCollection?.document.apis ?? [];
+  const selectedCollectionEndpoint =
+    collectionEndpoints.find(
+      (item) => item.name === fetchConfig.apiCollectionEndpointName
+    ) ?? null;
+  const selectedEndpointDescription =
+    selectedCollectionEndpoint?.description?.trim() || "";
   const swaggerTask = useSwaggerLoadTask(node.id);
   const fetchDebugTask = useFetchDebugTask(node.id);
   const loadingSwagger = swaggerTask.status === "loading";
@@ -352,12 +371,90 @@ export function FetchNodeConfigPanel({
   const [formEl, setFormEl] = useState<HTMLDivElement | null>(null);
 
   const setUrlInputMode = useCallback(
-    (mode: "swagger" | "manual") => {
+    (mode: FetchUrlInputMode) => {
       onUpdateNode(node.id, patchFetchConfig(node, { urlInputMode: mode }));
     },
     [node, onUpdateNode]
   );
 
+  const setFetchSourceMode = useCallback(
+    (mode: "direct" | "collection") => {
+      if (mode === "collection") {
+        onUpdateNode(
+          node.id,
+          patchFetchConfig(node, { urlInputMode: "collection" })
+        );
+        return;
+      }
+      const nextMode: FetchUrlInputMode = hasSwaggerEndpoints ? "swagger" : "manual";
+      onUpdateNode(
+        node.id,
+        patchFetchConfig(node, {
+          urlInputMode: nextMode,
+          apiCollectionId: undefined,
+          apiCollectionEndpointName: undefined,
+        })
+      );
+    },
+    [hasSwaggerEndpoints, node, onUpdateNode]
+  );
+
+  const handleSelectCollection = useCallback(
+    (collectionId: string) => {
+      if (!collectionId) {
+        onUpdateNode(
+          node.id,
+          patchFetchConfig(node, {
+            apiCollectionId: undefined,
+            apiCollectionEndpointName: undefined,
+            urlInputMode: "collection",
+          })
+        );
+        return;
+      }
+      onUpdateNode(
+        node.id,
+        patchFetchConfig(node, {
+          apiCollectionId: collectionId,
+          apiCollectionEndpointName: undefined,
+          urlInputMode: "collection",
+        })
+      );
+    },
+    [node, onUpdateNode]
+  );
+
+  const handleSelectCollectionEndpoint = useCallback(
+    (endpointName: string) => {
+      if (!selectedCollection || !endpointName) {
+        onUpdateNode(
+          node.id,
+          patchFetchConfig(node, {
+            apiCollectionEndpointName: undefined,
+            urlInputMode: "collection",
+          })
+        );
+        return;
+      }
+      const endpoint = selectedCollection.document.apis.find(
+        (item) => item.name === endpointName
+      );
+      if (!endpoint) return;
+      onUpdateNode(
+        node.id,
+        patchFetchConfig(
+          node,
+          applyApiCollectionEndpointToFetchConfig({
+            collectionId: selectedCollection.id,
+            document: selectedCollection.document,
+            endpoint,
+          })
+        )
+      );
+    },
+    [node, onUpdateNode, selectedCollection]
+  );
+
   const handleLoadSwagger = useCallback(() => {
     const docsUrl = fetchConfig.swaggerDocsUrl?.trim();
     if (!docsUrl) {
@@ -454,6 +551,90 @@ export function FetchNodeConfigPanel({
         title={t("blueprint.config.fetchTitle")}
         hint={t("blueprint.config.fetchHint")}
       />
+
+      {fetchConfig.apiCollectionSyncNotice ? (
+        <div className="rounded-md border border-emerald-500/40 bg-emerald-500/10 p-2.5 text-[11px] text-foreground">
+          <div className="flex items-start justify-between gap-2">
+            <div className="space-y-1">
+              <p className="font-medium text-emerald-800 dark:text-emerald-200">
+                {t("blueprint.config.apiCollectionSyncUpdatedTitle")}
+              </p>
+              <p className="text-muted-foreground">
+                {t("blueprint.config.apiCollectionSyncUpdatedSource")}
+              </p>
+              <p>
+                {t("blueprint.config.apiCollectionSyncUpdatedCollection", {
+                  collection: fetchConfig.apiCollectionSyncNotice.collectionName,
+                  endpoint: fetchConfig.apiCollectionSyncNotice.endpointName,
+                })}
+              </p>
+              <p>
+                {fetchConfig.apiCollectionSyncNotice.changedFields.length > 0
+                  ? t("blueprint.config.apiCollectionSyncUpdatedFields", {
+                      fields: fetchConfig.apiCollectionSyncNotice.changedFields
+                        .map((field) =>
+                          t(`blueprint.config.apiCollectionSyncField.${field}`)
+                        )
+                        .join("、"),
+                    })
+                  : t("blueprint.config.apiCollectionSyncUpdatedNoFieldChange")}
+              </p>
+            </div>
+            <Button
+              type="button"
+              variant="outline"
+              size="sm"
+              className="h-7 shrink-0 px-2 text-[11px]"
+              onClick={() =>
+                onUpdateNode(
+                  node.id,
+                  patchFetchConfig(node, { apiCollectionSyncNotice: null })
+                )
+              }
+            >
+              {t("common.close")}
+            </Button>
+          </div>
+        </div>
+      ) : null}
+
+      <div className="space-y-1">
+        <span className="text-[11px] text-muted-foreground">
+          {t("blueprint.config.fetchSourceMode")}
+        </span>
+        <div className="flex rounded-md border border-border p-0.5">
+          <button
+            type="button"
+            className={cn(
+              "flex-1 rounded px-2 py-1 text-[11px] transition-colors",
+              !usingCollection
+                ? "bg-primary text-primary-foreground"
+                : "text-muted-foreground hover:text-foreground"
+            )}
+            onClick={() => setFetchSourceMode("direct")}
+          >
+            {t("blueprint.config.fetchSourceDirect")}
+          </button>
+          <button
+            type="button"
+            className={cn(
+              "flex-1 rounded px-2 py-1 text-[11px] transition-colors",
+              usingCollection
+                ? "bg-primary text-primary-foreground"
+                : "text-muted-foreground hover:text-foreground"
+            )}
+            onClick={() => setFetchSourceMode("collection")}
+          >
+            {t("blueprint.config.fetchSourceCollection")}
+          </button>
+        </div>
+        <p className="text-[10px] text-muted-foreground">
+          {usingCollection
+            ? t("blueprint.config.fetchSourceCollectionHint")
+            : t("blueprint.config.fetchSourceDirectHint")}
+        </p>
+      </div>
+
       <div className="space-y-1 rounded-md border border-border/60 bg-background/70 p-2">
         <div className="flex items-center gap-1.5 text-[11px] font-medium text-foreground">
           {t("blueprint.config.fetchScopeTitle")}
@@ -477,6 +658,133 @@ export function FetchNodeConfigPanel({
         )}
       </div>
 
+      {usingCollection ? (
+        <div className="space-y-2 rounded-md border border-border/60 bg-background/70 p-2">
+          <label className="block space-y-1">
+            <span className="text-muted-foreground">
+              {t("blueprint.config.apiCollectionSelect")}
+            </span>
+            <Select
+              value={fetchConfig.apiCollectionId || undefined}
+              onValueChange={handleSelectCollection}
+            >
+              <SelectTrigger className="h-8 text-[11px]">
+                <SelectValue
+                  placeholder={t("blueprint.config.apiCollectionSelectPlaceholder")}
+                />
+              </SelectTrigger>
+              <SelectContent className="z-[10200]">
+                {apiCollections.length === 0 ? (
+                  <SelectItem value="__empty" disabled>
+                    {t("blueprint.config.apiCollectionEmpty")}
+                  </SelectItem>
+                ) : (
+                  apiCollections.map((item) => (
+                    <SelectItem key={item.id} value={item.id}>
+                      {item.name}
+                    </SelectItem>
+                  ))
+                )}
+              </SelectContent>
+            </Select>
+          </label>
+          <label className="block space-y-1">
+            <span className="text-muted-foreground">
+              {t("blueprint.config.apiCollectionEndpoint")}
+            </span>
+            <div className="flex gap-1.5">
+              <TooltipProvider delayDuration={200}>
+                <Tooltip>
+                  <TooltipTrigger asChild>
+                    <div className="min-w-0 flex-1">
+                      <Select
+                        value={fetchConfig.apiCollectionEndpointName || undefined}
+                        onValueChange={handleSelectCollectionEndpoint}
+                        disabled={!selectedCollection}
+                      >
+                        <SelectTrigger className="h-8 w-full text-[11px]">
+                          <SelectValue
+                            placeholder={t(
+                              "blueprint.config.apiCollectionEndpointPlaceholder"
+                            )}
+                          />
+                        </SelectTrigger>
+                        <SelectContent className="z-[10200]">
+                          {collectionEndpoints.length === 0 ? (
+                            <SelectItem value="__empty" disabled>
+                              {t("blueprint.config.apiCollectionNoEndpoints")}
+                            </SelectItem>
+                          ) : (
+                            collectionEndpoints.map((item) => (
+                              <SelectItem
+                                key={item.name}
+                                value={item.name}
+                                title={item.description?.trim() || undefined}
+                              >
+                                {item.name}
+                              </SelectItem>
+                            ))
+                          )}
+                        </SelectContent>
+                      </Select>
+                    </div>
+                  </TooltipTrigger>
+                  {selectedEndpointDescription ? (
+                    <TooltipContent
+                      side="top"
+                      className="z-[10300] max-w-sm whitespace-pre-wrap text-[11px]"
+                    >
+                      {selectedEndpointDescription}
+                    </TooltipContent>
+                  ) : null}
+                </Tooltip>
+              </TooltipProvider>
+              <AsyncSendButton
+                loading={loadingFetchDebug}
+                disabled={!fetchConfig.url?.trim()}
+                onSend={handleSendFetchDebug}
+                onAbort={handleAbortFetchDebug}
+                sendTitle={t("blueprint.config.sendDebugRequest")}
+                abortTitle={t("blueprint.config.abortRequest")}
+                sendAriaLabel={t("blueprint.config.sendDebugRequest")}
+                abortAriaLabel={t("blueprint.config.abortDebugAria")}
+              />
+            </div>
+          </label>
+          {selectedCollection ? (
+            <p className="text-[10px] text-muted-foreground">
+              {t("blueprint.config.apiCollectionFilledHint")}
+            </p>
+          ) : null}
+          <label className="block space-y-1">
+            <span className="text-muted-foreground">{t("blueprint.config.requestUrl")}</span>
+            <Input
+              value={fetchConfig.url}
+              disabled={loadingFetchDebug}
+              onChange={(e: ChangeEvent<HTMLInputElement>) =>
+                onUpdateNode(node.id, patchFetchConfig(node, { url: e.target.value }))
+              }
+              className="h-8 font-mono text-[11px]"
+            />
+          </label>
+          {usesScopeTemplate && resolvedUrlPreview ? (
+            <p className="break-all font-mono text-[10px] text-muted-foreground">
+              {t("blueprint.config.fetchScopeResolvedUrl")}: {resolvedUrlPreview}
+            </p>
+          ) : null}
+          {loadingFetchDebug ? (
+            <p className="flex items-center gap-1.5 text-[11px] text-muted-foreground">
+              <LoaderIcon className="h-3.5 w-3.5 shrink-0" />
+              {t("blueprint.config.sendingDebug")}
+            </p>
+          ) : null}
+          {fetchValidationError ? (
+            <p className="text-[11px] text-destructive">{fetchValidationError}</p>
+          ) : null}
+          <FetchDebugResponsePanel task={fetchDebugTask} />
+        </div>
+      ) : (
+      <>
       <label className="block space-y-1">
         <span className="text-muted-foreground">{t("blueprint.config.swaggerUrlOptional")}</span>
         <div className="flex gap-1.5">
@@ -667,6 +975,9 @@ export function FetchNodeConfigPanel({
         <FetchDebugResponsePanel task={fetchDebugTask} />
       </label>
 
+      </>
+      )}
+
       <label className="block space-y-1">
         <span className="text-muted-foreground">{t("blueprint.config.requestMethod")}</span>
         <Select

package/src/components/FetchUrlAutocomplete.tsx

@@ -1,6 +1,6 @@
 import { useEffect, useMemo, useRef, useState } from "react";
 import { cn } from "@arronqzy/ui";
-import { useI18n } from "@arronqzy/i18n/react";
+import { useI18nOptional as useI18n } from "@arronqzy/i18n/react";
 import {
   buildEndpointSuggestions,
   filterEndpointSuggestions,

package/src/components/JsonLintTextarea.tsx

@@ -0,0 +1,97 @@
+import { useMemo, useRef, type ChangeEvent } from "react";
+import {
+  renderJsonWithErrorHighlights,
+  type JsonErrorRange,
+} from "@arronqzy/blueprint-dsl";
+import { useI18nOptional as useI18n } from "@arronqzy/i18n/react";
+import { cn } from "@arronqzy/ui";
+
+export function JsonLintTextarea({
+  value,
+  onChange,
+  ranges,
+  placeholder,
+  rows = 12,
+  className,
+}: {
+  value: string;
+  onChange: (value: string) => void;
+  ranges: JsonErrorRange[];
+  placeholder?: string;
+  rows?: number;
+  className?: string;
+}) {
+  const { t } = useI18n();
+  const textareaRef = useRef<HTMLTextAreaElement | null>(null);
+
+  const highlightedHtml = useMemo(
+    () => renderJsonWithErrorHighlights(value, ranges),
+    [ranges, value]
+  );
+
+  const handleChange = (e: ChangeEvent<HTMLTextAreaElement>) => {
+    onChange(e.target.value);
+  };
+
+  const jumpToFirstError = () => {
+    const ta = textareaRef.current;
+    const first = ranges[0];
+    if (!ta || !first) return;
+    ta.focus();
+    const start = Math.max(0, first.start);
+    const end = Math.max(start, Math.min(value.length, first.end));
+    ta.setSelectionRange(start, end);
+  };
+
+  return (
+    <div className={cn("space-y-1.5", className)}>
+      <textarea
+        ref={textareaRef}
+        value={value}
+        onChange={handleChange}
+        rows={rows}
+        spellCheck={false}
+        placeholder={placeholder}
+        className={cn(
+          "w-full resize-y rounded-md border border-input bg-background px-2 py-1.5 font-mono text-[11px] leading-relaxed text-foreground shadow-sm outline-none focus-visible:ring-1 focus-visible:ring-primary",
+          ranges.length > 0 && "border-destructive/60"
+        )}
+      />
+      {ranges.length > 0 ? (
+        <div className="space-y-1">
+          <div className="flex items-center justify-between gap-2">
+            <span className="text-[10px] text-destructive">
+              {t("blueprint.config.jsonErrorPreviewHint")}
+            </span>
+            <button
+              type="button"
+              className="shrink-0 text-[10px] text-destructive underline-offset-2 hover:underline"
+              onClick={jumpToFirstError}
+            >
+              {t("blueprint.config.jsonJumpToError")}
+            </button>
+          </div>
+          <pre
+            aria-hidden
+            className="max-h-40 overflow-auto whitespace-pre-wrap break-words rounded-md border border-destructive/30 bg-destructive/5 px-2 py-1.5 font-mono text-[11px] leading-relaxed text-foreground"
+            dangerouslySetInnerHTML={{ __html: highlightedHtml || "\n" }}
+          />
+          <style>{`
+            .json-lint-error {
+              margin: 0;
+              padding: 0;
+              border: 0;
+              font: inherit;
+              line-height: inherit;
+              color: hsl(var(--destructive));
+              background: color-mix(in oklab, hsl(var(--destructive)) 22%, transparent);
+              border-radius: 2px;
+              text-decoration: underline wavy hsl(var(--destructive));
+              text-underline-offset: 2px;
+            }
+          `}</style>
+        </div>
+      ) : null}
+    </div>
+  );
+}

package/src/components/JsonNodeConfigPanel.tsx

@@ -1,6 +1,7 @@
-import { useCallback, useMemo, useState, type ChangeEvent } from "react";
+import { useCallback, useMemo, useState } from "react";
 import type {
   ExecutionTraceEntry,
+  JsonErrorRange,
   JsonNodeConfig,
 } from "@arronqzy/blueprint-dsl";
 import {
@@ -9,11 +10,12 @@ import {
   resolveFetchScopeAutocompleteRoot,
   validateJsonStringAllowingScope,
 } from "@arronqzy/blueprint-dsl";
-import { useI18n } from "@arronqzy/i18n/react";
+import { useI18nOptional as useI18n } from "@arronqzy/i18n/react";
 
 import type { BlueprintGraphEdge, BlueprintGraphNode } from "../graph/document";
 import { resolveNodeJsonConfig } from "../graph/document";
 import { ConfigHintIcon, ConfigSectionTitle } from "./ConfigHintIcon";
+import { JsonLintTextarea } from "./JsonLintTextarea";
 import { ScopeTemplateAutocompleteHost } from "./ScopeTemplateAutocompleteHost";
 
 export type JsonNodeConfigPanelProps = {
@@ -48,6 +50,7 @@ export function JsonNodeConfigPanel({
   const [formEl, setFormEl] = useState<HTMLDivElement | null>(null);
   const jsonConfig = resolveNodeJsonConfig(node);
   const [draftError, setDraftError] = useState<string | null>(null);
+  const [draftRanges, setDraftRanges] = useState<JsonErrorRange[] | null>(null);
 
   const incomingScope = useMemo(() => {
     const outputs = latestTraceOutputsByNode(traceEntries);
@@ -68,16 +71,21 @@ export function JsonNodeConfigPanel({
   const parseError =
     draftError ??
     (storedValidation.ok ? null : storedValidation.error);
+  const errorRanges: JsonErrorRange[] =
+    draftRanges ??
+    (!storedValidation.ok && "ranges" in storedValidation
+      ? storedValidation.ranges
+      : []);
   const deferredScope =
     storedValidation.ok && "deferred" in storedValidation
       ? storedValidation.deferred === true
       : false;
 
   const handleChange = useCallback(
-    (e: ChangeEvent<HTMLTextAreaElement>) => {
-      const jsonString = e.target.value;
+    (jsonString: string) => {
       const result = validateJsonStringAllowingScope(jsonString);
       setDraftError(result.ok ? null : result.error);
+      setDraftRanges(result.ok ? null : result.ranges);
       onUpdateNode(node.id, patchJsonConfig(node, { jsonString }));
     },
     [node, onUpdateNode]
@@ -104,12 +112,11 @@ export function JsonNodeConfigPanel({
             {t("blueprint.config.jsonScopeHint")}
           </ConfigHintIcon>
         </span>
-        <textarea
+        <JsonLintTextarea
           value={jsonConfig.jsonString}
           onChange={handleChange}
+          ranges={errorRanges}
           rows={12}
-          spellCheck={false}
-          className="w-full rounded-md border border-input bg-background px-2 py-1.5 font-mono text-[11px] leading-relaxed text-foreground shadow-sm outline-none focus-visible:ring-1 focus-visible:ring-primary"
           placeholder={'{\n  "key": "{scope?.value}"\n}'}
         />
         {parseError ? (

package/src/components/LogicNodeConfigPanel.tsx

@@ -1,7 +1,7 @@
 import { useCallback, useMemo, useState, type ChangeEvent } from "react";
 import { validateLogicSourceCode } from "@arronqzy/blueprint-dsl";
 import type { LogicNodeConfig } from "@arronqzy/blueprint-dsl";
-import { useI18n } from "@arronqzy/i18n/react";
+import { useI18nOptional as useI18n } from "@arronqzy/i18n/react";
 
 import type { BlueprintGraphNode } from "../graph/document";
 import { resolveNodeLogicConfig } from "../graph/document";

package/src/components/ScopeTemplateAutocompleteHost.tsx

@@ -76,17 +76,13 @@ export function ScopeTemplateAutocompleteHost({
 
   const refreshForInput = useCallback(
     (input: HTMLInputElement | HTMLTextAreaElement) => {
-      if (scope === undefined) {
-        closeDropdown();
-        return;
-      }
       const cursor = input.selectionStart ?? input.value.length;
-      const parsed = parseScopeAutocomplete(input.value, cursor, scope);
+      const parsed = parseScopeAutocomplete(input.value, cursor, scope ?? {});
       if (!parsed) {
         closeDropdown();
         return;
       }
-      const suggestions = getScopeAutocompleteSuggestions(scope, parsed);
+      const suggestions = getScopeAutocompleteSuggestions(scope ?? {}, parsed);
       if (suggestions.length === 0) {
         closeDropdown();
         return;
@@ -126,7 +122,7 @@ export function ScopeTemplateAutocompleteHost({
   );
 
   useEffect(() => {
-    if (!root || scope === undefined) return;
+    if (!root) return;
 
     const onFocusIn = (event: FocusEvent) => {
       if (!isAutocompleteTarget(event.target)) return;
@@ -209,7 +205,7 @@ export function ScopeTemplateAutocompleteHost({
     };
   }, [applySuggestion, closeDropdown, refreshForInput, root, scope]);
 
-  if (!dropdown || scope === undefined) return null;
+  if (!dropdown) return null;
 
   return createPortal(
     <div

package/src/components/StorageKeyAutocomplete.tsx

@@ -1,6 +1,6 @@
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";
 import { cn } from "@arronqzy/ui";
-import { useI18n } from "@arronqzy/i18n/react";
+import { useI18nOptional as useI18n } from "@arronqzy/i18n/react";
 import {
   filterStorageKeySuggestions,
   listBrowserStorageKeys,

package/src/components/StorageNodeConfigPanel.tsx

@@ -20,7 +20,7 @@ import {
   resolveFetchScopeAutocompleteRoot,
   uniqueStorageKinds,
 } from "@arronqzy/blueprint-dsl";
-import { useI18n } from "@arronqzy/i18n/react";
+import { useI18nOptional as useI18n } from "@arronqzy/i18n/react";
 
 import type { BlueprintGraphEdge, BlueprintGraphNode } from "../graph/document";
 import { resolveNodeStorageConfig } from "../graph/document";

package/src/components/ViewElementMultiSelect.tsx

@@ -12,7 +12,7 @@ import {
   PopoverContent,
   PopoverTrigger,
 } from "@arronqzy/ui";
-import { useI18n } from "@arronqzy/i18n/react";
+import { useI18nOptional as useI18n } from "@arronqzy/i18n/react";
 
 export type ViewElementMultiSelectOption = {
   id: string;

package/src/edges/BlueprintSmoothEdge.tsx

@@ -1,7 +1,7 @@
 import { BaseEdge, getSmoothStepPath, type EdgeProps } from "@xyflow/react";
 
-const EDGE_STROKE = "#2563eb";
-const EDGE_WIDTH = 2.5;
+const EDGE_STROKE = "#94a3b8";
+const EDGE_WIDTH = 1.75;
 
 export function BlueprintSmoothEdge({
   sourceX,

package/src/graph/blueprint-graph.ts

@@ -3,6 +3,7 @@ import {
   createNodeId,
   defaultBlueprintNodeLabel,
   filterInvalidBlueprintEdges,
+  isDefaultBlueprintNodeLabel,
   patchNodeConfigSource,
   resolveNodeClockConfig,
   resolveNodeEventConfig,
@@ -218,6 +219,14 @@ export class BlueprintGraph {
       nodes: this.document.nodes.map((n) => {
         if (n.id !== nodeId) return n;
         const nextNode = { ...n, ...configPatch, ...patch };
+        if (
+          patch.configSource &&
+          patch.configSource !== exists.configSource &&
+          patch.label === undefined &&
+          isDefaultBlueprintNodeLabel(exists.label)
+        ) {
+          nextNode.label = defaultBlueprintNodeLabel(patch.configSource);
+        }
         if (
           patch.viewElementIds !== undefined ||
           patch.viewElementId !== undefined

package/src/graph/document.ts

@@ -289,6 +289,18 @@ export function defaultBlueprintNodeLabel(
   return getBlueprintNodeTypeLabel(t, configSource);
 }
 
+/** 当前名称是否仍是「类型默认名」（空或等于任一类型文案） */
+export function isDefaultBlueprintNodeLabel(
+  label: string | undefined | null,
+  t: TranslateFn = defaultTranslate()
+): boolean {
+  const trimmed = (label ?? "").trim();
+  if (!trimmed) return true;
+  return (
+    Object.keys(BLUEPRINT_CONFIG_TYPE_LABEL_KEYS) as BlueprintConfigSource[]
+  ).some((src) => getBlueprintNodeTypeLabel(t, src) === trimmed);
+}
+
 export function resolveNodeFetchConfig(
   node: Pick<BlueprintGraphNode, "fetchConfig">
 ): FetchRequestConfig {