@almadar/std 16.227.0 → 16.228.0

package/dist/modules/anim.d.ts

@@ -1,4 +1,4 @@
-import { S as StdOperatorMeta } from '../types-DpbKBJu8.js';
+import { S as StdOperatorMeta } from '../types-DwAW4Nni.js';
 
 /**
  * Anim Module - Sprite Animation Helpers

package/dist/modules/array.d.ts

@@ -1,4 +1,4 @@
-import { S as StdOperatorMeta } from '../types-DpbKBJu8.js';
+import { S as StdOperatorMeta } from '../types-DwAW4Nni.js';
 
 /**
  * Array Module - Collection Operations

package/dist/modules/async.d.ts

@@ -1,4 +1,4 @@
-import { S as StdOperatorMeta } from '../types-DpbKBJu8.js';
+import { S as StdOperatorMeta } from '../types-DwAW4Nni.js';
 
 /**
  * Async Module - Asynchronous Operations

package/dist/modules/async.js

@@ -7,6 +7,7 @@ var ASYNC_OPERATORS = {
     maxArity: 2,
     description: "Wait for specified milliseconds, optionally execute an effect after",
     hasSideEffects: true,
+    runsOn: "any",
     returnType: "any",
     params: [
       { name: "ms", type: "number", description: "Milliseconds to wait" },
@@ -21,6 +22,7 @@ var ASYNC_OPERATORS = {
     maxArity: 2,
     description: "Execute an effect periodically at a fixed interval",
     hasSideEffects: true,
+    runsOn: "any",
     returnType: "string",
     params: [
       { name: "ms", type: "number", description: "Interval in milliseconds" },
@@ -35,6 +37,7 @@ var ASYNC_OPERATORS = {
     maxArity: 2,
     description: "Add timeout to an effect",
     hasSideEffects: true,
+    runsOn: "any",
     returnType: "any",
     params: [
       { name: "effect", type: "expression", description: "Effect to execute" },
@@ -49,6 +52,7 @@ var ASYNC_OPERATORS = {
     maxArity: 2,
     description: "Debounce an event (wait for pause in events)",
     hasSideEffects: true,
+    runsOn: "any",
     returnType: "void",
     params: [
       { name: "event", type: "string", description: "Event name to emit" },
@@ -63,6 +67,7 @@ var ASYNC_OPERATORS = {
     maxArity: 2,
     description: "Throttle an event (emit at most once per interval)",
     hasSideEffects: true,
+    runsOn: "any",
     returnType: "void",
     params: [
       { name: "event", type: "string", description: "Event name to emit" },
@@ -77,6 +82,7 @@ var ASYNC_OPERATORS = {
     maxArity: 2,
     description: "Retry an effect with configurable backoff",
     hasSideEffects: true,
+    runsOn: "any",
     returnType: "any",
     params: [
       { name: "effect", type: "expression", description: "Effect to retry" },
@@ -93,6 +99,7 @@ var ASYNC_OPERATORS = {
     maxArity: null,
     description: "Execute effects in parallel, return first to complete",
     hasSideEffects: true,
+    runsOn: "any",
     returnType: "any",
     params: [{ name: "...effects", type: "expression[]", description: "Effects to race" }],
     example: '["async/race", ["call", "api1"], ["call", "api2"]]'
@@ -104,6 +111,7 @@ var ASYNC_OPERATORS = {
     maxArity: null,
     description: "Execute effects in parallel, wait for all to complete",
     hasSideEffects: true,
+    runsOn: "any",
     returnType: "array",
     params: [{ name: "...effects", type: "expression[]", description: "Effects to execute" }],
     example: '["async/all", ["call", "api1"], ["call", "api2"]]'
@@ -115,6 +123,7 @@ var ASYNC_OPERATORS = {
     maxArity: null,
     description: "Execute effects in sequence (one after another)",
     hasSideEffects: true,
+    runsOn: "any",
     returnType: "array",
     params: [{ name: "...effects", type: "expression[]", description: "Effects to execute in order" }],
     example: '["async/sequence", ["call", "validate"], ["call", "save"]]'

package/dist/modules/behavior.d.ts

@@ -1,4 +1,4 @@
-import { S as StdOperatorMeta } from '../types-DpbKBJu8.js';
+import { S as StdOperatorMeta } from '../types-DwAW4Nni.js';
 
 /**
  * Behavior Module - Orbital behavior composition, instantiation, validation, and lolo emission.

package/dist/modules/behavior.js

@@ -7,6 +7,7 @@ var BEHAVIOR_OPERATORS = {
     maxArity: 0,
     description: "Compose all orbitals in the workspace into a single schema. Backed by composeBehaviors.",
     hasSideEffects: true,
+    runsOn: "any",
     returnType: "ComposeAllResult",
     params: [],
     example: '["compose/compose-all"]'
@@ -18,6 +19,7 @@ var BEHAVIOR_OPERATORS = {
     maxArity: 1,
     description: "Compose child orbitals under a parent for recursive builds.",
     hasSideEffects: true,
+    runsOn: "any",
     returnType: "ComposeChildrenResult",
     params: [{ name: "parentName", type: "string", description: "Parent orbital name" }],
     example: '["compose/compose-children", "GameScreenOrbital"]'
@@ -29,6 +31,7 @@ var BEHAVIOR_OPERATORS = {
     maxArity: 3,
     description: "Instantiate a behavior from the registry at runtime (meta-programming). Equivalent to compile-time `uses` but dynamic \u2014 the behavior name is a runtime value. Applies the same override surface (linkedEntity, events, config, fields).",
     hasSideEffects: true,
+    runsOn: "any",
     returnType: "BuilderResult",
     params: [
       { name: "behavior", type: "string", description: 'Behavior/organism name (e.g. "std-ecommerce")' },
@@ -44,6 +47,7 @@ var BEHAVIOR_OPERATORS = {
     maxArity: 3,
     description: "Call a behavior service action. Returns the ServiceCallResult union \u2014 resolves to the specific member when the (behavior, action) pair is a literal.",
     hasSideEffects: true,
+    runsOn: "any",
     returnType: "ServiceCallResult",
     params: [
       { name: "behavior", type: "string", description: "Service/behavior name" },
@@ -59,6 +63,7 @@ var BEHAVIOR_OPERATORS = {
     maxArity: 3,
     description: "Emit a .lolo orbital body from the LLM (free-lolo path). Returns the emitted lolo source.",
     hasSideEffects: true,
+    runsOn: "any",
     returnType: "LoloEmitResult",
     params: [
       { name: "name", type: "string", description: "Orbital name" },
@@ -74,6 +79,7 @@ var BEHAVIOR_OPERATORS = {
     maxArity: 2,
     description: "Validate an orbital or the composed schema using orb validate.",
     hasSideEffects: true,
+    runsOn: "any",
     returnType: "ValidateResult",
     params: [
       { name: "target", type: { kind: "union", of: [{ kind: "literal", value: "orbital" }, { kind: "literal", value: "composed" }] }, description: "Validation target" },

package/dist/modules/browser.d.ts

@@ -1,4 +1,4 @@
-import { S as StdOperatorMeta } from '../types-DpbKBJu8.js';
+import { S as StdOperatorMeta } from '../types-DwAW4Nni.js';
 
 /**
  * Browser Module - Browser Device Operators (client host path)

package/dist/modules/browser.js

@@ -7,6 +7,7 @@ var BROWSER_OPERATORS = {
     maxArity: 1,
     description: "Open the OS file picker (window.showOpenFilePicker / host dialog). Resolves with the selected file metadata list, or emits failure when the user cancels or the capability is denied. Async; use the trailing { emit } envelope for success/failure events.",
     hasSideEffects: true,
+    runsOn: "client",
     returnType: "array",
     params: [
       {
@@ -47,6 +48,7 @@ var BROWSER_OPERATORS = {
     maxArity: 0,
     description: "Read text from the system clipboard (navigator.clipboard.readText / host clipboard). Requires a user gesture and clipboard permission. Resolves with the clipboard text via the trailing { emit } envelope.",
     hasSideEffects: true,
+    runsOn: "client",
     returnType: "string",
     effect: {
       kind: "custom",
@@ -61,6 +63,7 @@ var BROWSER_OPERATORS = {
     maxArity: 1,
     description: "Write text to the system clipboard (navigator.clipboard.writeText / host clipboard). Requires a user gesture. Emits success/failure via the trailing { emit } envelope.",
     hasSideEffects: true,
+    runsOn: "client",
     returnType: "void",
     params: [
       { name: "text", type: "string", description: "Text to write to the clipboard" }
@@ -78,6 +81,7 @@ var BROWSER_OPERATORS = {
     maxArity: 0,
     description: "Subscribe this browser to Web Push notifications: registers the shared push service worker, fetches the VAPID public key from the host (/api/push/vapid-public-key \u2014 no key material in the schema), and calls PushManager.subscribe. Requires notification permission (user gesture). Resolves with the flat subscription credentials { endpoint, p256dh, auth } via the trailing { emit } envelope \u2014 persist them on an owner-scoped entity row and pass them back to the push.send service as subscription: { endpoint, keys: { p256dh, auth } }. Emits failure when the Push API is unavailable, permission is denied, or the host has no VAPID key configured.",
     hasSideEffects: true,
+    runsOn: "client",
     returnType: "object",
     effect: {
       kind: "custom",
@@ -99,6 +103,7 @@ var BROWSER_OPERATORS = {
     maxArity: 1,
     description: "Read the current device position (navigator.geolocation.getCurrentPosition / host geolocation). Requires location permission. Resolves with { latitude, longitude, accuracy } via the trailing { emit } envelope.",
     hasSideEffects: true,
+    runsOn: "client",
     returnType: "object",
     params: [
       {

package/dist/modules/composition.d.ts

@@ -1,4 +1,4 @@
-import { S as StdOperatorMeta } from '../types-DpbKBJu8.js';
+import { S as StdOperatorMeta } from '../types-DwAW4Nni.js';
 
 /**
  * Composition Module - Behavior Composition Operators

package/dist/modules/contract.d.ts

@@ -1,4 +1,4 @@
-import { S as StdOperatorMeta } from '../types-DpbKBJu8.js';
+import { S as StdOperatorMeta } from '../types-DwAW4Nni.js';
 
 /**
  * Contract Module - ML Contract Validation Operations

package/dist/modules/core.d.ts

@@ -1,4 +1,4 @@
-import { S as StdOperatorMeta } from '../types-DpbKBJu8.js';
+import { S as StdOperatorMeta } from '../types-DwAW4Nni.js';
 
 /**
  * Core Module - Language Primitives

package/dist/modules/core.js

@@ -334,6 +334,7 @@ var CORE_OPERATORS = {
     maxArity: 2,
     description: "Set a binding to a value",
     hasSideEffects: true,
+    runsOn: "any",
     returnType: "void",
     params: [
       { name: "binding", type: BINDING, description: 'Target binding (e.g. "@entity.field")' },
@@ -356,6 +357,7 @@ var CORE_OPERATORS = {
     maxArity: 2,
     description: "Emit an event onto the bus",
     hasSideEffects: true,
+    runsOn: "any",
     returnType: "void",
     params: [
       { name: "event", type: EVENT_KEY, description: "Event key" },
@@ -378,6 +380,7 @@ var CORE_OPERATORS = {
     maxArity: 4,
     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",
     returnType: "void",
     params: [
       { name: "action", type: PERSIST_ACTION, description: "Persist action" },
@@ -434,6 +437,7 @@ var CORE_OPERATORS = {
     maxArity: 3,
     description: "Navigate to a route: (navigate path payload? options?) \u2014 options carries { crumb } labelling the navigation-stack entry for the target page",
     hasSideEffects: true,
+    runsOn: "client",
     returnType: "void",
     params: [
       { name: "path", type: STRING, description: "Route path (supports :param placeholders)" },
@@ -460,6 +464,7 @@ var CORE_OPERATORS = {
     maxArity: 0,
     description: "Pop the orbital-scoped navigation stack and return to the previous entry",
     hasSideEffects: true,
+    runsOn: "client",
     returnType: "void",
     effect: { kind: "navigate-back" }
   },
@@ -470,6 +475,7 @@ var CORE_OPERATORS = {
     maxArity: 2,
     description: "Show a notification (in-app, email, push, sms)",
     hasSideEffects: true,
+    runsOn: "any",
     returnType: "void",
     params: [
       { name: "channel", type: NOTIFY_CHANNEL, description: "Delivery channel" },
@@ -485,6 +491,7 @@ var CORE_OPERATORS = {
     maxArity: 1,
     description: "Emit a structured info log line (compiled + runtime)",
     hasSideEffects: true,
+    runsOn: "any",
     returnType: "void",
     params: [{ name: "message", type: STRING, description: "Log message" }],
     example: '["log", "Context below compact threshold"]',
@@ -497,6 +504,7 @@ var CORE_OPERATORS = {
     maxArity: 2,
     description: "Spawn a new entity instance (games)",
     hasSideEffects: true,
+    runsOn: "any",
     returnType: "void",
     params: [
       { name: "entity", type: { kind: "entity" }, description: "Entity name to spawn" },
@@ -517,6 +525,7 @@ var CORE_OPERATORS = {
     maxArity: 1,
     description: "Despawn an entity instance (games)",
     hasSideEffects: true,
+    runsOn: "any",
     returnType: "void",
     params: [
       { name: "entityId", type: STRING, description: "Target entity id (defaults to @entity.id)", optional: true }
@@ -531,6 +540,7 @@ var CORE_OPERATORS = {
     maxArity: 2,
     description: "Fetch an entity (by id) or a collection (by filter) from persistence",
     hasSideEffects: true,
+    runsOn: "server",
     returnType: "void",
     params: [
       { name: "entity", type: { kind: "entity" }, description: "Target entity name" },
@@ -578,6 +588,7 @@ var CORE_OPERATORS = {
     maxArity: 2,
     description: "Stream an LLM or HTTP response, emitting on_message per chunk, success on completion, failure on error",
     hasSideEffects: true,
+    runsOn: "server",
     returnType: "void",
     params: [
       { name: "entity", type: { kind: "entity" }, description: "Target entity name" },
@@ -609,6 +620,7 @@ var CORE_OPERATORS = {
     maxArity: 2,
     description: "Send an orbital event to the server over WebSocket (client-side; chat/real-time trigger)",
     hasSideEffects: true,
+    runsOn: "client",
     returnType: "void",
     params: [
       { name: "event", type: EVENT_KEY, description: "Target orbital event name on the server" },
@@ -629,6 +641,7 @@ var CORE_OPERATORS = {
     maxArity: 2,
     description: "Reactive entity reference (deprecated, use fetch with listens in V2)",
     hasSideEffects: true,
+    runsOn: "any",
     returnType: "void",
     params: [
       { name: "entity", type: { kind: "entity" }, description: "Target entity name" },
@@ -669,6 +682,78 @@ var CORE_OPERATORS = {
       }
     }
   },
+  deref: {
+    module: "core",
+    category: "effect",
+    minArity: 1,
+    maxArity: 2,
+    description: "Snapshot read of a binding or entity, without subscribing to changes",
+    hasSideEffects: true,
+    runsOn: "any",
+    returnType: "any",
+    params: [
+      { name: "target", type: STRING, description: "A binding (`@entity.health`) or entity name" },
+      {
+        name: "options",
+        type: {
+          kind: "object",
+          fields: { id: STRING, filter: ANY, include: { kind: "array", of: STRING } },
+          open: true
+        },
+        description: "Selector: id | filter | include",
+        optional: true
+      }
+    ],
+    example: '["deref", "@entity.health"]'
+  },
+  "swap!": {
+    module: "core",
+    category: "effect",
+    minArity: 2,
+    maxArity: 2,
+    description: "Atomic compare-and-swap of an entity field on the server",
+    hasSideEffects: true,
+    runsOn: "server",
+    returnType: "void",
+    params: [
+      { name: "target", type: BINDING, description: "The field to swap (`@entity.counter`)" },
+      { name: "update", type: SEXPR, description: "The new value, computed from the current one" }
+    ],
+    example: "(swap! @entity.counter (+ @entity.counter 1))"
+  },
+  watch: {
+    module: "core",
+    category: "effect",
+    minArity: 2,
+    maxArity: 3,
+    description: "Emit an event whenever a watched binding changes",
+    hasSideEffects: true,
+    runsOn: "any",
+    returnType: "void",
+    params: [
+      { name: "target", type: BINDING, description: "The binding to watch" },
+      { name: "event", type: EVENT_KEY, description: "Event emitted on each change" },
+      {
+        name: "options",
+        type: { kind: "object", fields: { debounce: "number", emit: { kind: "object", fields: {}, open: true } }, open: false },
+        description: "debounce (ms) | emit",
+        optional: true
+      }
+    ],
+    example: '["watch", "@entity.status", "STATUS_UPDATED", { "debounce": 100 }]'
+  },
+  atomic: {
+    module: "core",
+    category: "effect",
+    minArity: 1,
+    maxArity: null,
+    description: "Run effects as one server transaction: all succeed or all roll back",
+    hasSideEffects: true,
+    runsOn: "server",
+    returnType: "void",
+    params: [{ name: "effects", type: SEXPR, description: "The effects to group" }],
+    example: "(atomic (set @entity.x 10) (set @entity.y 20))"
+  },
   "call-service": {
     module: "core",
     category: "effect",
@@ -676,6 +761,7 @@ var CORE_OPERATORS = {
     maxArity: 4,
     description: "Invoke an external service action. Optional trailing { emit: { success, failure } } options object attaches closed-circuit emit routing (V2 frame contract).",
     hasSideEffects: true,
+    runsOn: "server",
     returnType: "void",
     params: [
       { name: "service", type: STRING, description: 'Service name (e.g. "llm", "stripe")' },
@@ -709,6 +795,7 @@ var CORE_OPERATORS = {
     maxArity: 3,
     description: "Render a pattern into a UI slot",
     hasSideEffects: true,
+    runsOn: "client",
     returnType: "void",
     params: [
       { name: "slot", type: UI_SLOT, description: "Target UI slot (main, sidebar, modal, hud, ...)" },

package/dist/modules/data.d.ts

@@ -1,4 +1,4 @@
-import { S as StdOperatorMeta } from '../types-DpbKBJu8.js';
+import { S as StdOperatorMeta } from '../types-DwAW4Nni.js';
 
 /**
  * Data Module - ML Data Preprocessing Operations

package/dist/modules/ease.d.ts

@@ -1,4 +1,4 @@
-import { S as StdOperatorMeta } from '../types-DpbKBJu8.js';
+import { S as StdOperatorMeta } from '../types-DwAW4Nni.js';
 
 /**
  * Ease Module - Easing & Interpolation Curves

package/dist/modules/format.d.ts

@@ -1,4 +1,4 @@
-import { S as StdOperatorMeta } from '../types-DpbKBJu8.js';
+import { S as StdOperatorMeta } from '../types-DwAW4Nni.js';
 
 /**
  * Format Module - Display Formatting

package/dist/modules/geo.d.ts

@@ -1,4 +1,4 @@
-import { S as StdOperatorMeta } from '../types-DpbKBJu8.js';
+import { S as StdOperatorMeta } from '../types-DwAW4Nni.js';
 
 /**
  * Geo Module - 2D Collision & Geometry

package/dist/modules/graph.d.ts

@@ -1,4 +1,4 @@
-import { S as StdOperatorMeta } from '../types-DpbKBJu8.js';
+import { S as StdOperatorMeta } from '../types-DwAW4Nni.js';
 
 /**
  * Graph Module - Graph Neural Network Operations

package/dist/modules/grid.d.ts

@@ -1,4 +1,4 @@
-import { S as StdOperatorMeta } from '../types-DpbKBJu8.js';
+import { S as StdOperatorMeta } from '../types-DwAW4Nni.js';
 
 /**
  * Grid Module - Tile/Cell Coordinate Operations

package/dist/modules/index.d.ts

@@ -32,4 +32,4 @@ export { MEMORY_OPERATORS, getMemoryOperators } from './memory.js';
 export { TRACE_OPERATORS, getTraceOperators } from './trace.js';
 export { BEHAVIOR_OPERATORS, getBehaviorOperators } from './behavior.js';
 export { INTEGRATION_OPERATORS, getIntegrationOperators } from './integration.js';
-import '../types-DpbKBJu8.js';
+import '../types-DwAW4Nni.js';