@lowdefy/helpers 5.2.0 → 5.4.0

package/dist/builtinMessages.js

@@ -0,0 +1,80 @@
+/*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/ const builtinMessages = {
+    'engine.action.loading': 'Loading',
+    'engine.action.success': 'Success',
+    'engine.validation.fieldRequired': 'This field is required',
+    'engine.validation.summary': '{count, plural, one {Your input has # validation error} other {Your input has # validation errors}}',
+    'client.popupBlocked': 'A popup blocker may be preventing the application from opening the page. Approve the popup to continue.',
+    'client.requestError': 'Request error',
+    'client.backAriaLabel': 'back',
+    'client.shortcutThen': 'then',
+    'errorPage.name': 'Error',
+    'errorPage.message': 'An error has occurred.',
+    'errorPage.homeLink': 'Return to home page',
+    // Agent runtime — surfaces in browser as HTTP error responses / streamed errors
+    'agent.runtime.methodNotAllowed': 'Only POST requests are supported.',
+    'agent.runtime.invalidPath': 'Invalid agent path',
+    'agent.runtime.messagesMustBeArray': 'messages must be an array',
+    'agent.runtime.urlQueryMustBeObject': 'urlQuery must be an object',
+    'agent.runtime.sharedStateMustBeObject': 'sharedState must be an object',
+    'agent.runtime.agentNotFound': 'Agent "{agentId}" does not exist.',
+    'agent.runtime.agentTypeNotFound': 'Agent type "{type}" can not be found.',
+    'agent.runtime.toolExecutionFailed': 'Endpoint execution failed',
+    'agent.runtime.subAgentDepthExceeded': 'Sub-agent nesting exceeds maximum depth of {max}.',
+    'agent.runtime.reservedToolName': '{kind} "{name}" uses a reserved platform tool name. Rename it (e.g., to "{name}-app" or "custom-{name}"). Reserved: {reserved}.',
+    // AgentChat block UI
+    'agent.sender.placeholder': 'Type a message...',
+    'agent.toolApproval.approve': 'Approve',
+    'agent.toolApproval.reject': 'Reject',
+    'agent.message.copy': 'Copy',
+    'agent.message.feedback': 'Feedback',
+    'agent.message.regenerate': 'Regenerate',
+    'agent.message.delete': 'Delete',
+    'agent.message.userHeader': 'You',
+    'agent.message.assistantHeader': 'Assistant',
+    'agent.toolResult.completed': 'Completed',
+    'agent.toolResult.completedNoData': 'Completed (no data)',
+    'agent.toolResult.empty': 'Empty',
+    'agent.toolResult.emptyList': 'Empty list',
+    'agent.toolResult.showMore': 'Show more',
+    'agent.toolResult.showLess': 'Show less',
+    'agent.toolResult.sourcesTitle': 'Sources',
+    'agent.toolResult.reasoningTitle': 'Reasoning',
+    'agent.toolResult.running': 'Running...',
+    'agent.toolResult.processing': 'Processing...',
+    'agent.toolResult.failed': 'Tool execution failed',
+    'agent.toolResult.rejected': 'Tool execution was rejected',
+    'agent.toolResult.returnedCount': '{count, plural, one {Returned # result} other {Returned # results}}',
+    'agent.toolResult.returnedKeys': 'Returned: {keys}',
+    'agent.toolResult.returnedFields': 'Returned object with {count} fields',
+    // Block built-ins — surfaced directly by block components, overridable per-locale.
+    'blocks.listSelector.search.placeholder': 'Search…',
+    'blocks.listSelector.search.noResults': 'No results',
+    'blocks.listSelector.noData': 'No data',
+    'blocks.treeSelector.placeholder': 'Select item',
+    'blocks.treeSelector.notFound': 'Not found',
+    'blocks.treeMultipleSelector.placeholder': 'Select items',
+    'blocks.treeMultipleSelector.notFound': 'Not found',
+    // antd X built-ins — apps can override per-locale via config.i18n.messages.
+    // For en_US and zh_CN, XProvider's pack already covers these natively.
+    'agent.antdx.conversations.create': 'New chat',
+    'agent.antdx.sender.stopLoading': 'Stop loading',
+    'agent.antdx.bubble.editableOk': 'OK',
+    'agent.antdx.bubble.editableCancel': 'Cancel',
+    'agent.antdx.actions.feedbackLike': 'Like',
+    'agent.antdx.actions.feedbackDislike': 'Dislike'
+};
+export default builtinMessages;

package/dist/getLocaleDateFormat.js

@@ -0,0 +1,61 @@
+/*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/ const TYPE_TO_TOKEN = {
+    year: 'YYYY',
+    month: 'MM',
+    day: 'DD',
+    hour: 'HH',
+    minute: 'mm',
+    second: 'ss'
+};
+const OPTIONS = {
+    date: {
+        year: 'numeric',
+        month: '2-digit',
+        day: '2-digit'
+    },
+    datetime: {
+        year: 'numeric',
+        month: '2-digit',
+        day: '2-digit',
+        hour: '2-digit',
+        minute: '2-digit',
+        hour12: false
+    },
+    time: {
+        hour: '2-digit',
+        minute: '2-digit',
+        hour12: false
+    },
+    month: {
+        year: 'numeric',
+        month: '2-digit'
+    }
+};
+// Fixed reference instant — only the locale's literal separators and digit ordering matter,
+// not the values themselves. Using a constant keeps the result deterministic.
+const REFERENCE = new Date(Date.UTC(2024, 0, 2, 15, 30, 45));
+function getLocaleDateFormat(locale, style = 'date') {
+    if (typeof locale !== 'string' || locale === '') return null;
+    const options = OPTIONS[style];
+    if (!options) return null;
+    try {
+        const parts = new Intl.DateTimeFormat(locale, options).formatToParts(REFERENCE);
+        return parts.map((p)=>TYPE_TO_TOKEN[p.type] ?? p.value).join('');
+    } catch  {
+        return null;
+    }
+}
+export default getLocaleDateFormat;

package/dist/getLocaleDecimalSeparator.js

@@ -0,0 +1,24 @@
+/*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/ function getLocaleDecimalSeparator(locale) {
+    if (typeof locale !== 'string' || locale === '') return null;
+    try {
+        const part = new Intl.NumberFormat(locale).formatToParts(1.1).find((p)=>p.type === 'decimal');
+        return part?.value ?? null;
+    } catch  {
+        return null;
+    }
+}
+export default getLocaleDecimalSeparator;

package/dist/getLocaleGroupSeparator.js

@@ -0,0 +1,24 @@
+/*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/ function getLocaleGroupSeparator(locale) {
+    if (typeof locale !== 'string' || locale === '') return null;
+    try {
+        const part = new Intl.NumberFormat(locale).formatToParts(12345).find((p)=>p.type === 'group');
+        return part?.value ?? null;
+    } catch  {
+        return null;
+    }
+}
+export default getLocaleGroupSeparator;

package/dist/index.js

@@ -13,9 +13,13 @@
   See the License for the specific language governing permissions and
   limitations under the License.
 */ import applyArrayIndices from './applyArrayIndices.js';
+import builtinMessages from './builtinMessages.js';
 import cachedPromises from './cachedPromises.js';
 import extractErrorProps from './extractErrorProps.js';
 import get from './get.js';
+import getLocaleDateFormat from './getLocaleDateFormat.js';
+import getLocaleDecimalSeparator from './getLocaleDecimalSeparator.js';
+import getLocaleGroupSeparator from './getLocaleGroupSeparator.js';
 import LRUCache from './LRUCache.js';
 import mergeObjects from './mergeObjects.js';
 import omit from './omit.js';
@@ -23,8 +27,9 @@ import serializer from './serializer.js';
 import set from './set.js';
 import stableStringify from './stableStringify.js';
 import swap from './swap.js';
+import translate from './translate.js';
 import type from './type.js';
 import unset from './unset.js';
 import urlQuery from './urlQuery.js';
 import wait from './wait.js';
-export { applyArrayIndices, cachedPromises, extractErrorProps, get, LRUCache, mergeObjects, omit, serializer, set, stableStringify, swap, type, unset, urlQuery, wait };
+export { applyArrayIndices, builtinMessages, cachedPromises, extractErrorProps, get, getLocaleDateFormat, getLocaleDecimalSeparator, getLocaleGroupSeparator, LRUCache, mergeObjects, omit, serializer, set, stableStringify, swap, translate, type, unset, urlQuery, wait };

package/dist/translate.js

@@ -0,0 +1,42 @@
+/*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/ import { IntlMessageFormat } from 'intl-messageformat';
+import builtinMessages from './builtinMessages.js';
+import type from './type.js';
+const FALLBACK_LOCALE = 'en-US';
+function resolveMessage({ key, active, messages }) {
+    if (active && messages[active]?.[key] != null) return messages[active][key];
+    if (messages[FALLBACK_LOCALE]?.[key] != null) return messages[FALLBACK_LOCALE][key];
+    if (builtinMessages[key] != null) return builtinMessages[key];
+    return key;
+}
+function translate({ key, values, locale, i18n }) {
+    if (!type.isString(key)) {
+        throw new Error('translate requires a string "key".');
+    }
+    const active = locale ?? i18n?.active ?? i18n?.defaultLocale;
+    const messages = i18n?.messages ?? {};
+    const message = resolveMessage({
+        key,
+        active,
+        messages
+    });
+    if (type.isNone(values)) return message;
+    if (!type.isObject(values)) {
+        throw new Error('translate "values" must be an object.');
+    }
+    return new IntlMessageFormat(message, active).format(values);
+}
+export default translate;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lowdefy/helpers",
-  "version": "5.2.0",
+  "version": "5.4.0",
   "license": "Apache-2.0",
   "description": "",
   "homepage": "https://lowdefy.com",
@@ -31,7 +31,8 @@
     "dist/*"
   ],
   "dependencies": {
-    "@lowdefy/errors": "5.2.0",
+    "@lowdefy/errors": "5.4.0",
+    "intl-messageformat": "11.2.7",
     "lodash.merge": "4.6.2"
   },
   "devDependencies": {