@almadar/std 16.239.0 → 16.242.0

package/dist/registry.d.ts

@@ -1,5 +1,5 @@
-import { S as StdOperatorMeta, a as StdModule, O as OperatorMeta, R as RunsOn, b as OperatorVisualForm } from './types-DLx38UFZ.js';
-export { c as OPERATOR_VISUAL_FORMS } from './types-DLx38UFZ.js';
+import { S as StdOperatorMeta, R as RunsOn, a as StdModule, O as OperatorMeta, b as OperatorVisualForm } from './types-Cdb321uM.js';
+export { c as OPERATOR_VISUAL_FORMS } from './types-Cdb321uM.js';
 
 /**
  * Standard Library Registry
@@ -107,6 +107,13 @@ declare function isStdGuardOperator(operator: string): boolean;
 declare function isStdEffectOperator(operator: string): boolean;
 /** Declared execution site of an effect operator; `undefined` for a pure or unknown one. */
 declare function getOperatorRunsOn(operator: string): RunsOn | undefined;
+/**
+ * Where one effect call runs: its declared `runsOn`, except a data effect
+ * (`entityArgPosition`) whose target entity stores its rows in the browser
+ * (core's `storesRowsInBrowser` over the program's entities), which runs on the
+ * client. Undefined for a pure op. Twin of Rust `effects::effect_site`.
+ */
+declare function effectSiteFor(operator: string, args: readonly unknown[], storesRowsInBrowser: (entityName: string) => boolean): RunsOn | undefined;
 /** Effect operators whose declared execution site is `site`, sorted. */
 declare function getOperatorsRunningOn(site: RunsOn): string[];
 /**
@@ -156,4 +163,4 @@ declare function getStdLibStats(): {
 /** The AVL circuit form of an operator: its declared form, else conveyor (takes a lambda), actuator (side effect) or block. Null when unregistered. */
 declare function operatorVisualForm(operator: string): OperatorVisualForm | null;
 
-export { OPERATOR_NAMES, OperatorVisualForm, STD_OPERATORS, STD_OPERATORS_BY_MODULE, assertOperatorArity, getAllStdOperators, getLambdaOperators, getModuleOperators, getOperatorMetaExtended, getOperatorRunsOn, getOperatorsRunningOn, getStdEffectOperators, getStdLibStats, getStdOperatorMeta, getStdOperatorsByModule, getStdPureOperators, isEffectOperatorExtended, isKnownOperatorExtended, isKnownStdOperator, isStdEffectOperator, isStdGuardOperator, operatorVisualForm, validateOperatorArityExtended, validateStdOperatorArity };
+export { OPERATOR_NAMES, OperatorVisualForm, STD_OPERATORS, STD_OPERATORS_BY_MODULE, assertOperatorArity, effectSiteFor, getAllStdOperators, getLambdaOperators, getModuleOperators, getOperatorMetaExtended, getOperatorRunsOn, getOperatorsRunningOn, getStdEffectOperators, getStdLibStats, getStdOperatorMeta, getStdOperatorsByModule, getStdPureOperators, isEffectOperatorExtended, isKnownOperatorExtended, isKnownStdOperator, isStdEffectOperator, isStdGuardOperator, operatorVisualForm, validateOperatorArityExtended, validateStdOperatorArity };

package/dist/registry.js

@@ -9,6 +9,7 @@ var STD_MODULES = [
   "time",
   "validate",
   "format",
+  "i18n",
   "async",
   "nn",
   "tensor",
@@ -452,6 +453,7 @@ var CORE_OPERATORS = {
     description: "Create, update, delete, clear, or batch entity records. Optional trailing { emit: { success, failure } } options object attaches closed-circuit emit routing.",
     hasSideEffects: true,
     runsOn: "server",
+    entityArgPosition: 1,
     returnType: "void",
     params: [
       { name: "action", type: PERSIST_ACTION, description: "Persist action" },
@@ -612,6 +614,7 @@ var CORE_OPERATORS = {
     description: "Fetch an entity (by id) or a collection (by filter) from persistence",
     hasSideEffects: true,
     runsOn: "server",
+    entityArgPosition: 0,
     returnType: "void",
     params: [
       { name: "entity", type: { kind: "entity" }, description: "Target entity name" },
@@ -3220,6 +3223,24 @@ var FORMAT_OPERATORS = {
   }
 };
 
+// modules/i18n.ts
+var I18N_OPERATORS = {
+  "i18n/t": {
+    module: "i18n",
+    category: "std-i18n",
+    minArity: 1,
+    maxArity: 2,
+    description: "The active locale's message for a catalog key, with {{placeholders}} filled from params",
+    hasSideEffects: false,
+    returnType: "string",
+    params: [
+      { name: "key", type: "string", description: "Catalog key (a string literal)" },
+      { name: "params", type: "object", description: "Values for the message {{placeholders}}", optional: true }
+    ],
+    example: '["i18n/t", "posts.count", { "n": 3 }] // => "3 posts"'
+  }
+};
+
 // modules/async.ts
 var ASYNC_OPERATORS = {
   "async/delay": {
@@ -6602,6 +6623,7 @@ var STD_OPERATORS = {
   ...TIME_OPERATORS,
   ...VALIDATE_OPERATORS,
   ...FORMAT_OPERATORS,
+  ...I18N_OPERATORS,
   ...ASYNC_OPERATORS,
   ...NN_OPERATORS,
   ...TENSOR_OPERATORS,
@@ -6639,6 +6661,7 @@ var STD_OPERATORS_BY_MODULE = {
   time: TIME_OPERATORS,
   validate: VALIDATE_OPERATORS,
   format: FORMAT_OPERATORS,
+  i18n: I18N_OPERATORS,
   async: ASYNC_OPERATORS,
   nn: NN_OPERATORS,
   tensor: TENSOR_OPERATORS,
@@ -6725,6 +6748,13 @@ function isStdEffectOperator(operator) {
 function getOperatorRunsOn(operator) {
   return STD_OPERATORS[operator]?.runsOn;
 }
+function effectSiteFor(operator, args, storesRowsInBrowser) {
+  const meta = STD_OPERATORS[operator];
+  const site = meta?.runsOn;
+  if (site !== "server" || meta.entityArgPosition === void 0) return site;
+  const entity = args[meta.entityArgPosition];
+  return typeof entity === "string" && !entity.startsWith("@") && storesRowsInBrowser(entity) ? "client" : "server";
+}
 function getOperatorsRunningOn(site) {
   return Object.keys(STD_OPERATORS).filter((name) => STD_OPERATORS[name].runsOn === site).sort();
 }
@@ -6784,4 +6814,4 @@ function operatorVisualForm(operator) {
   return meta.hasSideEffects ? "actuator" : "block";
 }
 
-export { OPERATOR_NAMES, OPERATOR_VISUAL_FORMS, STD_OPERATORS, STD_OPERATORS_BY_MODULE, assertOperatorArity, getAllStdOperators, getLambdaOperators, getModuleOperators, getOperatorMetaExtended, getOperatorRunsOn, getOperatorsRunningOn, getStdEffectOperators, getStdLibStats, getStdOperatorMeta, getStdOperatorsByModule, getStdPureOperators, isEffectOperatorExtended, isKnownOperatorExtended, isKnownStdOperator, isStdEffectOperator, isStdGuardOperator, operatorVisualForm, validateOperatorArityExtended, validateStdOperatorArity };
+export { OPERATOR_NAMES, OPERATOR_VISUAL_FORMS, STD_OPERATORS, STD_OPERATORS_BY_MODULE, assertOperatorArity, effectSiteFor, getAllStdOperators, getLambdaOperators, getModuleOperators, getOperatorMetaExtended, getOperatorRunsOn, getOperatorsRunningOn, getStdEffectOperators, getStdLibStats, getStdOperatorMeta, getStdOperatorsByModule, getStdPureOperators, isEffectOperatorExtended, isKnownOperatorExtended, isKnownStdOperator, isStdEffectOperator, isStdGuardOperator, operatorVisualForm, validateOperatorArityExtended, validateStdOperatorArity };

package/dist/{types-DLx38UFZ.d.ts → types-Cdb321uM.d.ts}

@@ -9,7 +9,7 @@
 /**
  * Operator categories for the core expression language.
  */
-declare const OPERATOR_CATEGORIES: readonly ["arithmetic", "comparison", "logic", "control", "effect", "collection", "std-math", "std-str", "std-array", "std-object", "std-validate", "std-json", "std-time", "std-format", "std-async", "std-nn", "std-tensor", "std-train", "std-prob", "std-os", "std-browser", "std-composition", "std-vec", "std-geo", "std-grid", "std-anim", "std-ease", "std-noise", "std-path", "ml-arch", "ml-effect", "ml-tensor", "ml-graph", "ml-contract", "ml-data", "std-llm", "std-workspace", "std-session", "std-memory", "std-trace", "std-behavior", "std-integration"];
+declare const OPERATOR_CATEGORIES: readonly ["arithmetic", "comparison", "logic", "control", "effect", "collection", "std-math", "std-str", "std-array", "std-object", "std-validate", "std-json", "std-time", "std-format", "std-i18n", "std-async", "std-nn", "std-tensor", "std-train", "std-prob", "std-os", "std-browser", "std-composition", "std-vec", "std-geo", "std-grid", "std-anim", "std-ease", "std-noise", "std-path", "ml-arch", "ml-effect", "ml-tensor", "ml-graph", "ml-contract", "ml-data", "std-llm", "std-workspace", "std-session", "std-memory", "std-trace", "std-behavior", "std-integration"];
 type OperatorCategory = (typeof OPERATOR_CATEGORIES)[number];
 /**
  * Basic return types for core operators.
@@ -104,13 +104,13 @@ interface OperatorMeta {
  * Each module provides a set of operators prefixed with the module name.
  * E.g., 'math' provides 'math/abs', 'math/clamp', etc.
  */
-declare const STD_MODULES: readonly ["core", "math", "str", "array", "object", "json", "time", "validate", "format", "async", "nn", "tensor", "train", "prob", "os", "browser", "graph", "contract", "data", "composition", "vec", "geo", "grid", "anim", "ease", "noise", "path", "llm", "workspace", "session", "memory", "trace", "behavior", "integration"];
+declare const STD_MODULES: readonly ["core", "math", "str", "array", "object", "json", "time", "validate", "format", "i18n", "async", "nn", "tensor", "train", "prob", "os", "browser", "graph", "contract", "data", "composition", "vec", "geo", "grid", "anim", "ease", "noise", "path", "llm", "workspace", "session", "memory", "trace", "behavior", "integration"];
 type StdModule = (typeof STD_MODULES)[number];
 /**
  * Standard library operator categories.
  * These extend the core categories for more granular classification.
  */
-declare const STD_OPERATOR_CATEGORIES: readonly ["std-math", "std-str", "std-array", "std-object", "std-json", "std-time", "std-validate", "std-format", "std-async", "std-nn", "std-tensor", "std-train", "std-prob", "std-os", "std-browser", "std-composition", "std-vec", "std-geo", "std-grid", "std-anim", "std-ease", "std-noise", "std-path", "ml-arch", "ml-effect", "ml-tensor", "ml-graph", "ml-contract", "ml-data", "std-llm", "std-workspace", "std-session", "std-memory", "std-trace", "std-behavior", "std-integration"];
+declare const STD_OPERATOR_CATEGORIES: readonly ["std-math", "std-str", "std-array", "std-object", "std-json", "std-time", "std-validate", "std-format", "std-i18n", "std-async", "std-nn", "std-tensor", "std-train", "std-prob", "std-os", "std-browser", "std-composition", "std-vec", "std-geo", "std-grid", "std-anim", "std-ease", "std-noise", "std-path", "ml-arch", "ml-effect", "ml-tensor", "ml-graph", "ml-contract", "ml-data", "std-llm", "std-workspace", "std-session", "std-memory", "std-trace", "std-behavior", "std-integration"];
 type StdOperatorCategory = (typeof STD_OPERATOR_CATEGORIES)[number];
 /**
  * Structured parameter type reference (Schema v2).
@@ -189,6 +189,12 @@ interface StdOperatorMeta extends OperatorMeta {
     acceptsLambda?: boolean;
     /** Position of the lambda argument (0-indexed) */
     lambdaArgPosition?: number;
+    /**
+     * Position of the argument naming the target entity (0-indexed), on a data
+     * effect: the effect runs where that entity's rows live, so a `runsOn: server`
+     * data effect on a client-resident entity runs on the client.
+     */
+    entityArgPosition?: number;
     /** Compile-time operator (resolved during .lolo lowering, not at runtime) */
     compileTime?: boolean;
     /** Schema v2: structured metadata for effect operators */

package/i18n/ar.json

@@ -147,6 +147,7 @@
     "grid/neighbors": "شبكة/الجيران",
     "grid/screen-to-iso": "شبكة/شاشة_إلى_متساوي_القياس",
     "grid/to-world": "شبكة/إلى_العالم",
+    "i18n/t": "ترجمة/نص",
     "if": "إذا",
     "integration/github-create-issue": "تكامل/إنشاء_تذكرة_جيت_هب",
     "integration/github-get-repo": "تكامل/جلب_مستودع_جيت_هب",

package/i18n/en.json

@@ -147,6 +147,7 @@
     "grid/neighbors": "grid/neighbors",
     "grid/screen-to-iso": "grid/screen-to-iso",
     "grid/to-world": "grid/to-world",
+    "i18n/t": "i18n/t",
     "if": "if",
     "integration/github-create-issue": "integration/github-create-issue",
     "integration/github-get-repo": "integration/github-get-repo",

package/i18n/sl.json

@@ -147,6 +147,7 @@
     "grid/neighbors": "mreza/sosedje",
     "grid/screen-to-iso": "mreza/zaslon-do-iso",
     "grid/to-world": "mreza/do-svet",
+    "i18n/t": "prevod/besedilo",
     "if": "ce",
     "integration/github-create-issue": "integracija/github-ustvari-zadeva",
     "integration/github-get-repo": "integracija/github-dobi-repozitorij",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/std",
-  "version": "16.239.0",
+  "version": "16.242.0",
   "description": "Standard library operators for Almadar (math, string, array, etc.)",
   "type": "module",
   "main": "./dist/index.js",
@@ -87,11 +87,11 @@
     "compiler": ">=4.10.0"
   },
   "dependencies": {
-    "@almadar/core": "^10.115.0"
+    "@almadar/core": "^10.117.0"
   },
   "devDependencies": {
     "@almadar/eslint-plugin": "^2.21.0",
-    "@almadar/llm": "^2.58.0",
+    "@almadar/llm": "^2.60.0",
     "@types/node": "^20.0.0",
     "@typescript-eslint/parser": "8.65.0",
     "eslint": "10.0.0",