@arronqzy/blueprint-dsl 1.0.16 → 1.0.17

package/dist/index.cjs

@@ -1,5 +1,146 @@
 'use strict';
 
+// src/messages.ts
+var ZH_CN = {
+  invalidJson: "\u4E0D\u662F\u6709\u6548 JSON\uFF1A{reason}",
+  invalidFormat: "\u683C\u5F0F\u65E0\u6548",
+  jsonInvalid: "JSON \u683C\u5F0F\u65E0\u6548",
+  jsonEmpty: "JSON \u4E0D\u80FD\u4E3A\u7A7A",
+  jsonRootMustBeContainer: "JSON \u6839\u8282\u70B9\u5FC5\u987B\u662F object \u6216 array",
+  contentEmpty: "\u5185\u5BB9\u4E3A\u7A7A",
+  contentRequired: "\u5185\u5BB9\u4E0D\u80FD\u4E3A\u7A7A",
+  codeRequired: "\u4EE3\u7801\u4E0D\u80FD\u4E3A\u7A7A",
+  javascriptSyntaxError: "JavaScript \u8BED\u6CD5\u9519\u8BEF",
+  logicUpdateRequired: "\u9700\u8981\u5B9A\u4E49 update(input) \u51FD\u6570",
+  apiItemMustBeObject: "apis[{index}] \u5FC5\u987B\u662F\u5BF9\u8C61",
+  apiItemFieldRequired: "apis[{index}].{field} \u5FC5\u586B\u4E14\u4E3A\u975E\u7A7A\u5B57\u7B26\u4E32",
+  apiItemMethodInvalid: "apis[{index}].method \u5FC5\u987B\u662F {methods} \u4E4B\u4E00",
+  apiItemFieldStringMap: "apis[{index}].{field} \u5FC5\u987B\u662F string \u5B57\u5178",
+  apiItemFieldString: "apis[{index}].{field} \u5FC5\u987B\u662F\u5B57\u7B26\u4E32",
+  apiRootMustBeObject: "\u6839\u8282\u70B9\u5FC5\u987B\u662F\u5BF9\u8C61",
+  apiVersionMismatch: "version \u5FC5\u987B\u4E3A {version}",
+  apiNameRequired: "name \u5FC5\u586B\u4E14\u4E3A\u975E\u7A7A\u5B57\u7B26\u4E32",
+  apiBaseUrlString: "baseUrl \u5FC5\u987B\u662F\u5B57\u7B26\u4E32",
+  apiListMustBeArray: "apis \u5FC5\u987B\u662F\u6570\u7EC4",
+  apiListEmpty: "apis \u81F3\u5C11\u5305\u542B\u4E00\u6761\u63A5\u53E3",
+  apiNameDuplicated: "\u63A5\u53E3\u540D\u79F0\u91CD\u590D\uFF1A{name}",
+  apiTemplateName: "\u793A\u4F8B\u63A5\u53E3\u96C6\u5408",
+  apiTemplateListUsers: "\u83B7\u53D6\u7528\u6237\u5217\u8868",
+  apiTemplateListUsersDesc: "\u5206\u9875\u67E5\u8BE2\u7528\u6237\uFF1Bpage / tenant / token \u53EF\u7528 Scope \u6A21\u7248",
+  apiTemplateCreateUser: "\u521B\u5EFA\u7528\u6237",
+  apiTemplateCreateUserDesc: "\u521B\u5EFA\u7528\u6237\uFF1BURL \u4E0E body \u5747\u652F\u6301 Scope \u6A21\u7248",
+  apiTemplateGetUser: "\u83B7\u53D6\u7528\u6237\u8BE6\u60C5",
+  apiTemplateGetUserDesc: "\u6309 id \u67E5\u8BE2\uFF1B\u8DEF\u5F84\u91CC\u53EF\u76F4\u63A5\u5199 Scope \u6A21\u7248",
+  fetchUrlMissing: "\u8BF7\u6C42 URL \u672A\u914D\u7F6E",
+  fetchBodyInvalidJson: "\u8BF7\u6C42\u4F53\u4E0D\u662F\u6709\u6548 JSON\uFF1A{reason}",
+  fetchResponseInvalidJson: "\u54CD\u5E94\u4E0D\u662F\u6709\u6548\u7684 JSON",
+  fetchAborted: "\u8BF7\u6C42\u5DF2\u4E2D\u6B62",
+  fetchTimeout: "\u8BF7\u6C42\u8D85\u65F6\uFF08{ms}ms\uFF09",
+  headersTemplateNotObject: "\u8BF7\u6C42\u5934\u6A21\u677F\u89E3\u6790\u540E\u4E0D\u662F\u6709\u6548\u7684 JSON \u5BF9\u8C61",
+  headersNotObject: "\u8BF7\u6C42\u5934\u4E0D\u662F\u6709\u6548\u7684 JSON \u5BF9\u8C61",
+  swaggerInvalid: "Swagger \u6587\u6863\u683C\u5F0F\u65E0\u6548",
+  openApiNoOperations: "\u672A\u5728 OpenAPI \u6587\u6863\u4E2D\u627E\u5230\u63A5\u53E3",
+  swagger2NoOperations: "\u672A\u5728 Swagger 2.0 \u6587\u6863\u4E2D\u627E\u5230\u63A5\u53E3",
+  swaggerUnsupported: "\u4EC5\u652F\u6301 OpenAPI 3.x \u4E0E Swagger 2.0 \u6587\u6863",
+  storageUnsupported: "\u5F53\u524D\u73AF\u5883\u4E0D\u652F\u6301 {storage}",
+  storageKeyEmpty: "\u5B58\u50A8\u5199\u5165 key \u89E3\u6790\u4E3A\u7A7A",
+  clockCountPositive: "\u8F93\u51FA\u6B21\u6570\u987B\u5927\u4E8E 0",
+  clockIntervalPositive: "\u5F53\u524D\u914D\u7F6E\u4E0B\u65F6\u949F\u4FE1\u53F7\u95F4\u9694\u987B\u5927\u4E8E 0 \u79D2",
+  lifecycleSignalMissing: "\u751F\u547D\u5468\u671F\u4FE1\u53F7\u7F3A\u5931",
+  blueprintCycle: "\u84DD\u56FE\u5F15\u7528\u5B58\u5728\u6B7B\u5FAA\u73AF\uFF1A{path}",
+  debugMustStartFromLifecycle: "\u8C03\u8BD5\u4F1A\u8BDD\u53EA\u80FD\u4ECE\u751F\u547D\u5468\u671F\u8282\u70B9\u5F00\u59CB",
+  nodeRemoved: "\u8282\u70B9\u5DF2\u4ECE\u84DD\u56FE\u4E2D\u79FB\u9664",
+  clockNeedsTrue: "\u65F6\u949F\u8282\u70B9\u9700\u8981\u6536\u5230\u771F\u4FE1\u53F7\u540E\u624D\u4F1A\u542F\u52A8",
+  blueprintNeedsTrue: "\u84DD\u56FE\u8282\u70B9\u9700\u8981\u6536\u5230\u771F\u4FE1\u53F7\u540E\u624D\u4F1A\u6267\u884C",
+  blueprintNotSelected: "\u672A\u9009\u62E9\u84DD\u56FE\u5E93\u4E2D\u7684\u84DD\u56FE",
+  blueprintResolverMissing: "\u84DD\u56FE\u5E93\u89E3\u6790\u5668\u672A\u914D\u7F6E",
+  blueprintRecordMissing: "\u84DD\u56FE\u5E93\u8BB0\u5F55\u4E0D\u5B58\u5728: {id}",
+  fetchNoUpstream: "\u6570\u636E\u6E90\u8282\u70B9\u672A\u6536\u5230\u4E0A\u6E38\u8F93\u51FA\uFF0C\u8BF7\u786E\u8BA4\u8FDE\u7EBF\u4E0E\u4E0A\u6E38\u8282\u70B9\u5DF2\u6267\u884C",
+  fetchNeedsTrue: "\u6570\u636E\u6E90\u8282\u70B9\u9700\u8981\u6536\u5230\u771F\u4FE1\u53F7\u540E\u624D\u4F1A\u53D1\u8D77\u8BF7\u6C42",
+  jsonNeedsTrue: "JSON \u8282\u70B9\u9700\u8981\u6536\u5230\u771F\u4FE1\u53F7\u540E\u624D\u4F1A\u89E3\u6790",
+  storageNeedsTrue: "\u5B58\u50A8\u8282\u70B9\u9700\u8981\u6536\u5230\u771F\u4FE1\u53F7\u540E\u624D\u4F1A\u8BFB\u5199\u7F13\u5B58",
+  andNeedsBothTrue: "\u5E76\u8FD0\u7B97\uFF1A\u4E24\u4E2A\u8F93\u5165\u987B\u5747\u4E3A\u771F\u4FE1\u53F7"
+};
+var EN_US = {
+  invalidJson: "Invalid JSON: {reason}",
+  invalidFormat: "invalid format",
+  jsonInvalid: "Invalid JSON",
+  jsonEmpty: "JSON cannot be empty",
+  jsonRootMustBeContainer: "JSON root must be an object or array",
+  contentEmpty: "Content is empty",
+  contentRequired: "Content cannot be empty",
+  codeRequired: "Code cannot be empty",
+  javascriptSyntaxError: "JavaScript syntax error",
+  logicUpdateRequired: "An update(input) function is required",
+  apiItemMustBeObject: "apis[{index}] must be an object",
+  apiItemFieldRequired: "apis[{index}].{field} is required and must be a non-empty string",
+  apiItemMethodInvalid: "apis[{index}].method must be one of {methods}",
+  apiItemFieldStringMap: "apis[{index}].{field} must be a string map",
+  apiItemFieldString: "apis[{index}].{field} must be a string",
+  apiRootMustBeObject: "Root must be an object",
+  apiVersionMismatch: "version must be {version}",
+  apiNameRequired: "name is required and must be a non-empty string",
+  apiBaseUrlString: "baseUrl must be a string",
+  apiListMustBeArray: "apis must be an array",
+  apiListEmpty: "apis must contain at least one API",
+  apiNameDuplicated: "Duplicate API name: {name}",
+  apiTemplateName: "Sample API collection",
+  apiTemplateListUsers: "List users",
+  apiTemplateListUsersDesc: "Paged user query; page / tenant / token accept Scope templates",
+  apiTemplateCreateUser: "Create user",
+  apiTemplateCreateUserDesc: "Create a user; URL and body both accept Scope templates",
+  apiTemplateGetUser: "Get user detail",
+  apiTemplateGetUserDesc: "Query by id; Scope templates can be used directly in the path",
+  fetchUrlMissing: "Request URL is not configured",
+  fetchBodyInvalidJson: "Request body is not valid JSON: {reason}",
+  fetchResponseInvalidJson: "Response is not valid JSON",
+  fetchAborted: "Request aborted",
+  fetchTimeout: "Request timed out ({ms}ms)",
+  headersTemplateNotObject: "Headers template does not resolve to a JSON object",
+  headersNotObject: "Headers are not a valid JSON object",
+  swaggerInvalid: "Invalid Swagger document",
+  openApiNoOperations: "No operations found in the OpenAPI document",
+  swagger2NoOperations: "No operations found in the Swagger 2.0 document",
+  swaggerUnsupported: "Only OpenAPI 3.x and Swagger 2.0 documents are supported",
+  storageUnsupported: "{storage} is not available in this environment",
+  storageKeyEmpty: "Storage write key resolved to empty",
+  clockCountPositive: "Output count must be greater than 0",
+  clockIntervalPositive: "Clock interval must be greater than 0 seconds with the current config",
+  lifecycleSignalMissing: "Lifecycle signal is missing",
+  blueprintCycle: "Blueprint references form a cycle: {path}",
+  debugMustStartFromLifecycle: "A debug session can only start from a lifecycle node",
+  nodeRemoved: "Node was removed from the blueprint",
+  clockNeedsTrue: "Clock node starts only after receiving a true signal",
+  blueprintNeedsTrue: "Blueprint node runs only after receiving a true signal",
+  blueprintNotSelected: "No blueprint selected from the library",
+  blueprintResolverMissing: "Blueprint library resolver is not configured",
+  blueprintRecordMissing: "Blueprint library record not found: {id}",
+  fetchNoUpstream: "Data source node received no upstream output; check the connection and that upstream nodes ran",
+  fetchNeedsTrue: "Data source node sends the request only after receiving a true signal",
+  jsonNeedsTrue: "JSON node parses only after receiving a true signal",
+  storageNeedsTrue: "Storage node reads/writes only after receiving a true signal",
+  andNeedsBothTrue: "AND: both inputs must be true signals"
+};
+var CATALOGS = {
+  "zh-CN": ZH_CN,
+  "en-US": EN_US
+};
+var currentLocale = "zh-CN";
+function setBlueprintDslLocale(locale) {
+  currentLocale = locale;
+}
+function getBlueprintDslLocale() {
+  return currentLocale;
+}
+function dslMessage(key, params) {
+  const template = CATALOGS[currentLocale][key];
+  if (!params) return template;
+  return template.replace(
+    /\{(\w+)\}/g,
+    (match, name) => name in params ? String(params[name]) : match
+  );
+}
+
 // src/lifecycle.ts
 var PAGE_LIFECYCLE_PHASES = [
   "created",
@@ -139,7 +280,7 @@ function registerDefaultBehaviors(registry) {
   registry.registerJS("lifecycle-emit", async ({ token, io }) => {
     const lifecycle = token.scope.vars.get(LIFECYCLE_SIGNAL_KEY);
     if (!lifecycle) {
-      io.setOutput("out", createFalseSignal("\u751F\u547D\u5468\u671F\u4FE1\u53F7\u7F3A\u5931"));
+      io.setOutput("out", createFalseSignal(dslMessage("lifecycleSignalMissing")));
     } else if (lifecycle.phase === "blueprintActivated") {
       io.setOutput(
         "out",
@@ -974,7 +1115,7 @@ function hasExplicitUrlScheme(url) {
 function resolveFetchRequestUrl(config) {
   const rawUrl = config.url?.trim() ?? "";
   if (!rawUrl) {
-    throw new Error("\u8BF7\u6C42 URL \u672A\u914D\u7F6E");
+    throw new Error(dslMessage("fetchUrlMissing"));
   }
   if (hasExplicitUrlScheme(rawUrl)) {
     return rawUrl;
@@ -1004,7 +1145,7 @@ function linkAbortSignal(controller, external) {
 async function executeFetch(config, options) {
   const rawUrl = config.url?.trim();
   if (!rawUrl) {
-    throw new Error("\u8BF7\u6C42 URL \u672A\u914D\u7F6E");
+    throw new Error(dslMessage("fetchUrlMissing"));
   }
   const url = resolveFetchRequestUrl(config);
   const method = config.method ?? "GET";
@@ -1015,7 +1156,9 @@ async function executeFetch(config, options) {
       JSON.parse(body);
     } catch (error) {
       throw new Error(
-        `\u8BF7\u6C42\u4F53\u4E0D\u662F\u6709\u6548 JSON\uFF1A${error instanceof Error ? error.message : "\u683C\u5F0F\u65E0\u6548"}`
+        dslMessage("fetchBodyInvalidJson", {
+          reason: error instanceof Error ? error.message : dslMessage("invalidFormat")
+        })
       );
     }
   }
@@ -1056,7 +1199,7 @@ async function executeFetch(config, options) {
           if (options?.allowHttpError) {
             data = text;
           } else {
-            throw new Error("\u54CD\u5E94\u4E0D\u662F\u6709\u6548\u7684 JSON");
+            throw new Error(dslMessage("fetchResponseInvalidJson"));
           }
         }
       }
@@ -1076,9 +1219,9 @@ async function executeFetch(config, options) {
   } catch (error) {
     if (error instanceof Error && error.name === "AbortError") {
       if (options?.signal?.aborted) {
-        throw new Error("\u8BF7\u6C42\u5DF2\u4E2D\u6B62");
+        throw new Error(dslMessage("fetchAborted"));
       }
-      throw new Error(`\u8BF7\u6C42\u8D85\u65F6\uFF08${timeoutMs}ms\uFF09`);
+      throw new Error(dslMessage("fetchTimeout", { ms: timeoutMs }));
     }
     throw error;
   } finally {
@@ -1424,7 +1567,7 @@ function parseJsonText(text) {
   } catch (error) {
     return {
       ok: false,
-      error: error instanceof Error ? error.message : "JSON \u683C\u5F0F\u65E0\u6548"
+      error: error instanceof Error ? error.message : dslMessage("jsonInvalid")
     };
   }
 }
@@ -1432,7 +1575,7 @@ function validateFetchJsonText(text, options) {
   const trimmed = text.trim();
   if (!trimmed) {
     if (options?.allowEmpty === false) {
-      return { ok: false, error: "\u5185\u5BB9\u4E0D\u80FD\u4E3A\u7A7A" };
+      return { ok: false, error: dslMessage("contentRequired") };
     }
     return { ok: true };
   }
@@ -1477,13 +1620,13 @@ function getFetchHeadersValidationError(config, scope) {
   if (isWholeScopeExpression(raw) || hasScopeTemplate(raw)) {
     if (scope === void 0) return null;
     const parsed2 = parseFetchHeadersJson(raw, scope);
-    if (!parsed2) return "\u8BF7\u6C42\u5934\u6A21\u677F\u89E3\u6790\u540E\u4E0D\u662F\u6709\u6548\u7684 JSON \u5BF9\u8C61";
+    if (!parsed2) return dslMessage("headersTemplateNotObject");
     return null;
   }
   const result = validateFetchJsonText(raw);
   if (!result.ok) return result.error;
   const parsed = parseFetchHeadersJson(raw, scope);
-  if (!parsed) return "\u8BF7\u6C42\u5934\u4E0D\u662F\u6709\u6548\u7684 JSON \u5BF9\u8C61";
+  if (!parsed) return dslMessage("headersNotObject");
   return null;
 }
 function isWholeScopeExpression(text) {
@@ -1808,7 +1951,7 @@ function lintJsonString(jsonString) {
   const raw = jsonString ?? "";
   const trimmed = raw.trim();
   if (!trimmed) {
-    return { ok: false, error: "JSON \u4E0D\u80FD\u4E3A\u7A7A", ranges: [] };
+    return { ok: false, error: dslMessage("jsonEmpty"), ranges: [] };
   }
   const suspectRanges = findSuspectCharRanges(raw);
   const trimStart = raw.indexOf(trimmed);
@@ -1818,13 +1961,13 @@ function lintJsonString(jsonString) {
     if (value === null || typeof value !== "object") {
       return {
         ok: false,
-        error: "JSON \u6839\u8282\u70B9\u5FC5\u987B\u662F object \u6216 array",
+        error: dslMessage("jsonRootMustBeContainer"),
         ranges: mergeRanges(suspectRanges)
       };
     }
     return { ok: true, value };
   } catch (error) {
-    const message = error instanceof Error ? error.message : "JSON \u683C\u5F0F\u65E0\u6548";
+    const message = error instanceof Error ? error.message : dslMessage("jsonInvalid");
     const ranges = [...suspectRanges];
     const fromEngine = extractJsonErrorPosition(message, trimmed);
     const fromScan = findJsonSyntaxErrorOffset(trimmed);
@@ -2025,7 +2168,7 @@ function requireStorage(accessors, kind) {
   const target = kind === "session" ? accessors?.session : accessors?.local;
   if (!target) {
     throw new Error(
-      kind === "session" ? "\u5F53\u524D\u73AF\u5883\u4E0D\u652F\u6301 sessionStorage" : "\u5F53\u524D\u73AF\u5883\u4E0D\u652F\u6301 localStorage"
+      kind === "session" ? dslMessage("storageUnsupported", { storage: "sessionStorage" }) : dslMessage("storageUnsupported", { storage: "localStorage" })
     );
   }
   return target;
@@ -2038,7 +2181,7 @@ function executeStorageConfig(config, incomingScope, accessors) {
     const serialized = serializeStorageValue(value);
     const key = resolveStorageKey(normalized.set.key, incomingScope);
     if (!key) {
-      throw new Error("\u5B58\u50A8\u5199\u5165 key \u89E3\u6790\u4E3A\u7A7A");
+      throw new Error(dslMessage("storageKeyEmpty"));
     }
     for (const kind of normalized.set.storages) {
       requireStorage(store, kind).setItem(key, serialized);
@@ -2078,7 +2221,7 @@ function compileLogicRunner(sourceCode) {
     `"use strict";
 ${sourceCode}
 if (typeof update !== "function") {
-  throw new TypeError("\u9700\u8981\u5B9A\u4E49 update(input) \u51FD\u6570");
+  throw new TypeError(dslMessage("logicUpdateRequired"));
 }
 return update(input);`
   );
@@ -2086,7 +2229,7 @@ return update(input);`
 function validateLogicSourceCode(sourceCode) {
   const raw = sourceCode?.trim();
   if (!raw) {
-    return { ok: false, error: "\u4EE3\u7801\u4E0D\u80FD\u4E3A\u7A7A" };
+    return { ok: false, error: dslMessage("codeRequired") };
   }
   try {
     compileLogicRunner(raw);
@@ -2094,7 +2237,7 @@ function validateLogicSourceCode(sourceCode) {
   } catch (error) {
     return {
       ok: false,
-      error: error instanceof Error ? error.message : "JavaScript \u8BED\u6CD5\u9519\u8BEF"
+      error: error instanceof Error ? error.message : dslMessage("javascriptSyntaxError")
     };
   }
 }
@@ -2130,11 +2273,11 @@ function normalizeClockConfig(config) {
 function validateClockScheduleConfig(config) {
   const normalized = normalizeClockConfig(config);
   if (normalized.outputCount <= 0) {
-    return { ok: false, error: "\u8F93\u51FA\u6B21\u6570\u987B\u5927\u4E8E 0" };
+    return { ok: false, error: dslMessage("clockCountPositive") };
   }
   const needsInterval = normalized.outputCount > 1 || normalized.outputCount === 1 && !normalized.emitImmediately;
   if (needsInterval && normalized.intervalSeconds <= 0) {
-    return { ok: false, error: "\u5F53\u524D\u914D\u7F6E\u4E0B\u65F6\u949F\u4FE1\u53F7\u95F4\u9694\u987B\u5927\u4E8E 0 \u79D2" };
+    return { ok: false, error: dslMessage("clockIntervalPositive") };
   }
   return { ok: true };
 }
@@ -2423,24 +2566,24 @@ function parseSwaggerV2(spec, docsUrl) {
 }
 function parseSwaggerDocument(spec, docsUrl) {
   if (!spec || typeof spec !== "object") {
-    throw new Error("Swagger \u6587\u6863\u683C\u5F0F\u65E0\u6548");
+    throw new Error(dslMessage("swaggerInvalid"));
   }
   const document2 = spec;
   if (typeof document2.openapi === "string") {
     const parsed = parseOpenApiV3(document2, docsUrl);
     if (parsed.endpoints.length === 0) {
-      throw new Error("\u672A\u5728 OpenAPI \u6587\u6863\u4E2D\u627E\u5230\u63A5\u53E3");
+      throw new Error(dslMessage("openApiNoOperations"));
     }
     return parsed;
   }
   if (document2.swagger === "2.0" || document2.swagger === 2) {
     const parsed = parseSwaggerV2(document2, docsUrl);
     if (parsed.endpoints.length === 0) {
-      throw new Error("\u672A\u5728 Swagger 2.0 \u6587\u6863\u4E2D\u627E\u5230\u63A5\u53E3");
+      throw new Error(dslMessage("swagger2NoOperations"));
     }
     return parsed;
   }
-  throw new Error("\u4EC5\u652F\u6301 OpenAPI 3.x \u4E0E Swagger 2.0 \u6587\u6863");
+  throw new Error(dslMessage("swaggerUnsupported"));
 }
 function buildEndpointFullUrl(apiBaseUrl, pathOrEndpoint) {
   const path = typeof pathOrEndpoint === "string" ? pathOrEndpoint : pathOrEndpoint.path;
@@ -2480,28 +2623,28 @@ function isPlainStringRecord(value) {
 }
 function normalizeEndpoint(raw, index) {
   if (!raw || typeof raw !== "object" || Array.isArray(raw)) {
-    return `apis[${index}] \u5FC5\u987B\u662F\u5BF9\u8C61`;
+    return dslMessage("apiItemMustBeObject", { index });
   }
   const item = raw;
   const name = typeof item.name === "string" ? item.name.trim() : "";
-  if (!name) return `apis[${index}].name \u5FC5\u586B\u4E14\u4E3A\u975E\u7A7A\u5B57\u7B26\u4E32`;
+  if (!name) return dslMessage("apiItemFieldRequired", { index, field: "name" });
   const url = typeof item.url === "string" ? item.url.trim() : "";
-  if (!url) return `apis[${index}].url \u5FC5\u586B\u4E14\u4E3A\u975E\u7A7A\u5B57\u7B26\u4E32`;
+  if (!url) return dslMessage("apiItemFieldRequired", { index, field: "url" });
   const methodRaw = typeof item.method === "string" ? item.method.trim().toUpperCase() : "";
   if (!HTTP_METHOD_SET.has(methodRaw)) {
-    return `apis[${index}].method \u5FC5\u987B\u662F ${FETCH_HTTP_METHODS.join(" / ")} \u4E4B\u4E00`;
+    return dslMessage("apiItemMethodInvalid", { index, methods: FETCH_HTTP_METHODS.join(" / ") });
   }
   if (item.params !== void 0 && !isPlainStringRecord(item.params)) {
-    return `apis[${index}].params \u5FC5\u987B\u662F string \u5B57\u5178`;
+    return dslMessage("apiItemFieldStringMap", { index, field: "params" });
   }
   if (item.headers !== void 0 && !isPlainStringRecord(item.headers)) {
-    return `apis[${index}].headers \u5FC5\u987B\u662F string \u5B57\u5178`;
+    return dslMessage("apiItemFieldStringMap", { index, field: "headers" });
   }
   if (item.body !== void 0 && typeof item.body !== "string") {
-    return `apis[${index}].body \u5FC5\u987B\u662F\u5B57\u7B26\u4E32`;
+    return dslMessage("apiItemFieldString", { index, field: "body" });
   }
   if (item.description !== void 0 && typeof item.description !== "string") {
-    return `apis[${index}].description \u5FC5\u987B\u662F\u5B57\u7B26\u4E32`;
+    return dslMessage("apiItemFieldString", { index, field: "description" });
   }
   return {
     name,
@@ -2515,26 +2658,26 @@ function normalizeEndpoint(raw, index) {
 }
 function validateApiCollectionDocument(input) {
   if (!input || typeof input !== "object" || Array.isArray(input)) {
-    return { ok: false, error: "\u6839\u8282\u70B9\u5FC5\u987B\u662F\u5BF9\u8C61" };
+    return { ok: false, error: dslMessage("apiRootMustBeObject") };
   }
   const root = input;
   const version = root.version;
   if (version !== API_COLLECTION_DOCUMENT_VERSION && version !== "1") {
     return {
       ok: false,
-      error: `version \u5FC5\u987B\u4E3A ${API_COLLECTION_DOCUMENT_VERSION}`
+      error: dslMessage("apiVersionMismatch", { version: API_COLLECTION_DOCUMENT_VERSION })
     };
   }
   const name = typeof root.name === "string" ? root.name.trim() : "";
-  if (!name) return { ok: false, error: "name \u5FC5\u586B\u4E14\u4E3A\u975E\u7A7A\u5B57\u7B26\u4E32" };
+  if (!name) return { ok: false, error: dslMessage("apiNameRequired") };
   if (root.baseUrl !== void 0 && typeof root.baseUrl !== "string") {
-    return { ok: false, error: "baseUrl \u5FC5\u987B\u662F\u5B57\u7B26\u4E32" };
+    return { ok: false, error: dslMessage("apiBaseUrlString") };
   }
   if (!Array.isArray(root.apis)) {
-    return { ok: false, error: "apis \u5FC5\u987B\u662F\u6570\u7EC4" };
+    return { ok: false, error: dslMessage("apiListMustBeArray") };
   }
   if (root.apis.length === 0) {
-    return { ok: false, error: "apis \u81F3\u5C11\u5305\u542B\u4E00\u6761\u63A5\u53E3" };
+    return { ok: false, error: dslMessage("apiListEmpty") };
   }
   const apis = [];
   const nameSet = /* @__PURE__ */ new Set();
@@ -2544,7 +2687,7 @@ function validateApiCollectionDocument(input) {
       return { ok: false, error: normalized };
     }
     if (nameSet.has(normalized.name)) {
-      return { ok: false, error: `\u63A5\u53E3\u540D\u79F0\u91CD\u590D\uFF1A${normalized.name}` };
+      return { ok: false, error: dslMessage("apiNameDuplicated", { name: normalized.name }) };
     }
     nameSet.add(normalized.name);
     apis.push(normalized);
@@ -2561,14 +2704,16 @@ function validateApiCollectionDocument(input) {
 }
 function parseApiCollectionJson(text) {
   const trimmed = text.trim();
-  if (!trimmed) return { ok: false, error: "\u5185\u5BB9\u4E3A\u7A7A" };
+  if (!trimmed) return { ok: false, error: dslMessage("contentEmpty") };
   let parsed;
   try {
     parsed = JSON.parse(trimmed);
   } catch (error) {
     return {
       ok: false,
-      error: `\u4E0D\u662F\u6709\u6548 JSON\uFF1A${error instanceof Error ? error.message : "\u683C\u5F0F\u65E0\u6548"}`
+      error: dslMessage("invalidJson", {
+        reason: error instanceof Error ? error.message : dslMessage("invalidFormat")
+      })
     };
   }
   const validated = validateApiCollectionDocument(parsed);
@@ -2594,11 +2739,11 @@ function apiCollectionToListItem(record) {
 function getApiCollectionTemplateDocument() {
   return {
     version: API_COLLECTION_DOCUMENT_VERSION,
-    name: "\u793A\u4F8B\u63A5\u53E3\u96C6\u5408",
+    name: dslMessage("apiTemplateName"),
     baseUrl: "https://api.example.com",
     apis: [
       {
-        name: "\u83B7\u53D6\u7528\u6237\u5217\u8868",
+        name: dslMessage("apiTemplateListUsers"),
         method: "GET",
         url: "/users",
         params: {
@@ -2610,22 +2755,22 @@ function getApiCollectionTemplateDocument() {
           Accept: "application/json",
           Authorization: "Bearer {scope?.value?.token}"
         },
-        description: "\u5206\u9875\u67E5\u8BE2\u7528\u6237\uFF1Bpage / tenant / token \u53EF\u7528 Scope \u6A21\u7248"
+        description: dslMessage("apiTemplateListUsersDesc")
       },
       {
-        name: "\u521B\u5EFA\u7528\u6237",
+        name: dslMessage("apiTemplateCreateUser"),
         method: "POST",
         url: "/tenants/{scope?.value?.tenant}/users",
         headers: { "Content-Type": "application/json" },
         body: '{\n  "name": "{scope?.value?.name}",\n  "role": "member"\n}',
-        description: "\u521B\u5EFA\u7528\u6237\uFF1BURL \u4E0E body \u5747\u652F\u6301 Scope \u6A21\u7248"
+        description: dslMessage("apiTemplateCreateUserDesc")
       },
       {
-        name: "\u83B7\u53D6\u7528\u6237\u8BE6\u60C5",
+        name: dslMessage("apiTemplateGetUser"),
         method: "GET",
         url: "/users/{scope?.value?.id}",
         headers: { Accept: "application/json" },
-        description: "\u6309 id \u67E5\u8BE2\uFF1B\u8DEF\u5F84\u91CC\u53EF\u76F4\u63A5\u5199 Scope \u6A21\u7248"
+        description: dslMessage("apiTemplateGetUserDesc")
       }
     ]
   };
@@ -2930,7 +3075,7 @@ function collectBlueprintLibraryRefs(graph) {
 }
 function formatBlueprintCycleMessage(cycleIds, resolveName) {
   const labels = cycleIds.map((id) => resolveName?.(id) ?? id);
-  return `\u84DD\u56FE\u5F15\u7528\u5B58\u5728\u6B7B\u5FAA\u73AF\uFF1A${labels.join(" \u2192 ")}`;
+  return dslMessage("blueprintCycle", { path: labels.join(" \u2192 ") });
 }
 async function detectBlueprintReferenceCycle(options) {
   const {
@@ -3390,7 +3535,7 @@ var BlueprintGraphRunner = class _BlueprintGraphRunner {
     stopAllClockSchedules();
     const node = this.requireNode(lifecycleNodeId);
     if (node.nodeType !== LIFECYCLE_NODE_TYPE) {
-      throw new Error("\u8C03\u8BD5\u4F1A\u8BDD\u53EA\u80FD\u4ECE\u751F\u547D\u5468\u671F\u8282\u70B9\u5F00\u59CB");
+      throw new Error(dslMessage("debugMustStartFromLifecycle"));
     }
     this.outputs.clear();
     this.traceEntries = [];
@@ -3591,7 +3736,7 @@ var BlueprintGraphRunner = class _BlueprintGraphRunner {
     const runExecutor = executor ?? this.debugExecutor ?? this.createExecutor(this.debugQueue ?? []);
     if (!this.syncTokenFromGraph(token)) {
       return this.appendDebugTraceEntry(token, nodeLabelById, startedAt, {
-        error: "\u8282\u70B9\u5DF2\u4ECE\u84DD\u56FE\u4E2D\u79FB\u9664"
+        error: dslMessage("nodeRemoved")
       });
     }
     try {
@@ -3652,7 +3797,7 @@ var BlueprintGraphRunner = class _BlueprintGraphRunner {
       }
       if (!isTrueSignal(input)) {
         return finishWithOutput(
-          createFalseSignal("\u65F6\u949F\u8282\u70B9\u9700\u8981\u6536\u5230\u771F\u4FE1\u53F7\u540E\u624D\u4F1A\u542F\u52A8")
+          createFalseSignal(dslMessage("clockNeedsTrue"))
         );
       }
       const validation = validateClockScheduleConfig(normalized);
@@ -3727,19 +3872,19 @@ var BlueprintGraphRunner = class _BlueprintGraphRunner {
         if (!isTrueSignal(input)) {
           io.setOutput(
             "out",
-            createFalseSignal("\u84DD\u56FE\u8282\u70B9\u9700\u8981\u6536\u5230\u771F\u4FE1\u53F7\u540E\u624D\u4F1A\u6267\u884C")
+            createFalseSignal(dslMessage("blueprintNeedsTrue"))
           );
           io.emitFlow("out");
           return;
         }
         const libraryId = node.libraryBlueprintId;
         if (!libraryId) {
-          io.setOutput("out", createFalseSignal("\u672A\u9009\u62E9\u84DD\u56FE\u5E93\u4E2D\u7684\u84DD\u56FE"));
+          io.setOutput("out", createFalseSignal(dslMessage("blueprintNotSelected")));
           io.emitFlow("out");
           return;
         }
         if (!runner.resolveLibraryBlueprint) {
-          io.setOutput("out", createFalseSignal("\u84DD\u56FE\u5E93\u89E3\u6790\u5668\u672A\u914D\u7F6E"));
+          io.setOutput("out", createFalseSignal(dslMessage("blueprintResolverMissing")));
           io.emitFlow("out");
           return;
         }
@@ -3762,7 +3907,7 @@ var BlueprintGraphRunner = class _BlueprintGraphRunner {
         if (!nestedGraph) {
           io.setOutput(
             "out",
-            createFalseSignal(`\u84DD\u56FE\u5E93\u8BB0\u5F55\u4E0D\u5B58\u5728: ${libraryId}`)
+            createFalseSignal(dslMessage("blueprintRecordMissing", { id: libraryId }))
           );
           io.emitFlow("out");
           return;
@@ -3814,7 +3959,7 @@ var BlueprintGraphRunner = class _BlueprintGraphRunner {
           io.setOutput(
             "out",
             createFalseSignal(
-              input === void 0 ? "\u6570\u636E\u6E90\u8282\u70B9\u672A\u6536\u5230\u4E0A\u6E38\u8F93\u51FA\uFF0C\u8BF7\u786E\u8BA4\u8FDE\u7EBF\u4E0E\u4E0A\u6E38\u8282\u70B9\u5DF2\u6267\u884C" : "\u6570\u636E\u6E90\u8282\u70B9\u9700\u8981\u6536\u5230\u771F\u4FE1\u53F7\u540E\u624D\u4F1A\u53D1\u8D77\u8BF7\u6C42"
+              input === void 0 ? dslMessage("fetchNoUpstream") : dslMessage("fetchNeedsTrue")
             )
           );
           io.emitFlow("out");
@@ -3835,7 +3980,7 @@ var BlueprintGraphRunner = class _BlueprintGraphRunner {
         }
         const bodyError = getFetchBodyValidationError(config.body, config.body);
         if (bodyError) {
-          throw new Error(`\u8BF7\u6C42\u4F53\u4E0D\u662F\u6709\u6548 JSON\uFF1A${bodyError}`);
+          throw new Error(dslMessage("fetchBodyInvalidJson", { reason: bodyError }));
         }
         resolveFetchRequestUrl(config);
         const result = await executeFetch(config, {
@@ -3891,7 +4036,7 @@ var BlueprintGraphRunner = class _BlueprintGraphRunner {
         if (!isTrueSignal(input)) {
           io.setOutput(
             "out",
-            createFalseSignal("JSON \u8282\u70B9\u9700\u8981\u6536\u5230\u771F\u4FE1\u53F7\u540E\u624D\u4F1A\u89E3\u6790")
+            createFalseSignal(dslMessage("jsonNeedsTrue"))
           );
           io.emitFlow("out");
           return;
@@ -3933,7 +4078,7 @@ var BlueprintGraphRunner = class _BlueprintGraphRunner {
         if (!isTrueSignal(input)) {
           io.setOutput(
             "out",
-            createFalseSignal("\u5B58\u50A8\u8282\u70B9\u9700\u8981\u6536\u5230\u771F\u4FE1\u53F7\u540E\u624D\u4F1A\u8BFB\u5199\u7F13\u5B58")
+            createFalseSignal(dslMessage("storageNeedsTrue"))
           );
           io.emitFlow("out");
           return;
@@ -3978,7 +4123,7 @@ var BlueprintGraphRunner = class _BlueprintGraphRunner {
         if (!isTrueSignal(input)) {
           io.setOutput(
             "out",
-            createFalseSignal("\u65F6\u949F\u8282\u70B9\u9700\u8981\u6536\u5230\u771F\u4FE1\u53F7\u540E\u624D\u4F1A\u542F\u52A8")
+            createFalseSignal(dslMessage("clockNeedsTrue"))
           );
           io.emitFlow("out");
           return;
@@ -4016,7 +4161,7 @@ var BlueprintGraphRunner = class _BlueprintGraphRunner {
       } else {
         io.setOutput(
           "out",
-          createFalseSignal("\u5E76\u8FD0\u7B97\uFF1A\u4E24\u4E2A\u8F93\u5165\u987B\u5747\u4E3A\u771F\u4FE1\u53F7")
+          createFalseSignal(dslMessage("andNeedsBothTrue"))
         );
       }
       io.emitFlow("out");
@@ -4297,6 +4442,7 @@ exports.detectBlueprintReferenceCycle = detectBlueprintReferenceCycle;
 exports.detectRuntimeBlueprintCycle = detectRuntimeBlueprintCycle;
 exports.downloadApiCollectionTemplate = downloadApiCollectionTemplate;
 exports.draftFetchHeadersText = draftFetchHeadersText;
+exports.dslMessage = dslMessage;
 exports.evaluateScopeExpression = evaluateScopeExpression;
 exports.evaluateScopeTemplate = evaluateScopeTemplate;
 exports.evaluateScopeTemplateInJson = evaluateScopeTemplateInJson;
@@ -4315,6 +4461,7 @@ exports.formatClockTime = formatClockTime;
 exports.getActiveClockNodeIds = getActiveClockNodeIds;
 exports.getApiCollectionTemplateDocument = getApiCollectionTemplateDocument;
 exports.getApiCollectionTemplateJson = getApiCollectionTemplateJson;
+exports.getBlueprintDslLocale = getBlueprintDslLocale;
 exports.getClockTickDelayOffsetMs = getClockTickDelayOffsetMs;
 exports.getClockTickWaitMs = getClockTickWaitMs;
 exports.getFetchBodyValidationError = getFetchBodyValidationError;
@@ -4367,6 +4514,7 @@ exports.resolveStorageWriteValue = resolveStorageWriteValue;
 exports.scheduleClockOutputs = scheduleClockOutputs;
 exports.serializeStorageValue = serializeStorageValue;
 exports.serializeTraceValue = serializeTraceValue;
+exports.setBlueprintDslLocale = setBlueprintDslLocale;
 exports.snapshotDomEvent = snapshotDomEvent;
 exports.snapshotViewEventNode = snapshotViewEventNode;
 exports.startClockSchedule = startClockSchedule;