@almadar/core 11.3.0 → 11.5.0

package/dist/language/program-types.json

@@ -844,9 +844,22 @@
                 "error": {
                   "type": "string"
                 },
+                "code": {
+                  "type": "enum",
+                  "values": [
+                    "not-found",
+                    "no-row-key",
+                    "duplicate-id",
+                    "denied",
+                    "derived-failed"
+                  ]
+                },
                 "routed": {
                   "type": "boolean",
                   "required": true
+                },
+                "nested": {
+                  "type": "SExpr"
                 }
               }
             },
@@ -1078,7 +1091,8 @@
                         "effect-failed",
                         "locale-not-declared",
                         "client-circuit-state-refused",
-                        "repaint-failed"
+                        "repaint-failed",
+                        "cascade-capped"
                       ],
                       "required": true
                     },
@@ -1186,9 +1200,22 @@
                       "error": {
                         "type": "string"
                       },
+                      "code": {
+                        "type": "enum",
+                        "values": [
+                          "not-found",
+                          "no-row-key",
+                          "duplicate-id",
+                          "denied",
+                          "derived-failed"
+                        ]
+                      },
                       "routed": {
                         "type": "boolean",
                         "required": true
+                      },
+                      "nested": {
+                        "type": "SExpr"
                       }
                     }
                   },

package/dist/language/validation-codes.json

@@ -144,6 +144,11 @@
     "category": "effect",
     "description": "one dispatch's delegated effects reach browser-stored rows and server work"
   },
+  {
+    "code": "ORB_LANGUAGE_DATA_FAULT",
+    "category": "effect",
+    "description": "the installed language data cannot answer a lookup the validated program needs"
+  },
   {
     "code": "ORB_EFF_SLOT_CONFLICT",
     "category": "effect",
@@ -279,6 +284,11 @@
     "category": "binding",
     "description": "**The payload invariant.** An event's declared payload type IS its access path: declaring `Survey` means the payload is the row (read `?name`); declaring `{ row : Survey }` means read `?row.name`. This fires when an event declares a field that the effect firing it does not actually emit — so every read of that field is `undefined` at runtime, even though `orb validate` and `orb verify` otherwise pass. Checked as width subtyping (`declared ⊆ produced`): declaring FEWER fields than are emitted is legal, declaring one that is never emitted is not. Replaces the narrower `EmitSuccessPayloadWrapped` (persist-only) and `EmitSuccessPayloadReturnMismatch` (empty-payload-only) checks. Error severity."
   },
+  {
+    "code": "ORB_LISTEN_PAYLOAD_TYPE_MISMATCH",
+    "category": "binding",
+    "description": "An `emit` declares a payload field whose type does not fit the type the listening trait declares for the same field of the event its `listens` route triggers: the emitted value would be refused or misread on delivery. Compared by structure under the kernel's one type relation (aliases resolved, a missing optional member and a non-null value into a nullable slot are fine), never by the spelling of the type names. Error severity."
+  },
   {
     "code": "ORB_EFFECT_IN_LAMBDA",
     "category": "binding",
@@ -304,6 +314,116 @@
     "category": "generic",
     "description": "Generic duplicate entity/item"
   },
+  {
+    "code": "ORB_BINDING_ROOT_SHADOWED",
+    "category": "binding",
+    "description": "A `let` binding or `fn` parameter is named after a binding root (`entity`, `payload`, `config`, `user`, and so on), so `@name` in its scope reads the local instead of the root."
+  },
+  {
+    "code": "ORB_RUI_COLLECTION_FIELDS_MISSING",
+    "category": "render_ui",
+    "description": "A render-ui pattern whose registry props take both `entity` and `fields`/`columns` is bound to entity rows but declares neither, so a host would have to derive the shown fields from the first row."
+  },
+  {
+    "code": "ORB_BEHAVIOR_AMBIGUOUS",
+    "category": "behavior",
+    "description": "A behavior name resolves in more than one installed package"
+  },
+  {
+    "code": "ORB_BEHAVIOR_NAME_DUPLICATE",
+    "category": "behavior",
+    "description": "A package declares the same behavior name twice"
+  },
+  {
+    "code": "ORB_BEHAVIOR_NOT_FOUND",
+    "category": "behavior",
+    "description": "An imported behavior is found in no installed package"
+  },
+  {
+    "code": "ORB_BEHAVIOR_PACKAGE_INVALID",
+    "category": "behavior",
+    "description": "An installed behavior package cannot be read or has an invalid layout"
+  },
+  {
+    "code": "ORB_BEHAVIOR_PACKAGE_NOT_INSTALLED",
+    "category": "behavior",
+    "description": "A behavior package a program imports from is not installed"
+  },
+  {
+    "code": "ORB_BEHAVIOR_PREFIX_CONFLICT",
+    "category": "behavior",
+    "description": "Two installed packages claim the same behavior prefix"
+  },
+  {
+    "code": "ORB_LAZY_EAGER_REF",
+    "category": "uses",
+    "description": "An eager orbital references a lazily imported alias beyond a whole page-bearing orbital"
+  },
+  {
+    "code": "ORB_LAZY_NOT_SPLIT",
+    "category": "uses",
+    "description": "An orbital that references a lazy import reached inlining before the lazy split"
+  },
+  {
+    "code": "ORB_LAZY_NO_PAGES",
+    "category": "uses",
+    "description": "An orbital imported lazily declares no pages, so nothing can load it"
+  },
+  {
+    "code": "ORB_O_LISTEN_SOURCE_UNKNOWN",
+    "category": "orbital_ref",
+    "description": "An orbital import listens route names a source trait that is neither imported nor authored in the import body"
+  },
+  {
+    "code": "ORB_O_LISTEN_TARGET_UNKNOWN",
+    "category": "orbital_ref",
+    "description": "An orbital import listens route targets a trait that is not in the imported set"
+  },
+  {
+    "code": "ORB_O_PAGE_ACCESS_WEAKENED",
+    "category": "orbital_ref",
+    "description": "A page reference sets public access on an upstream page that requires authentication"
+  },
+  {
+    "code": "ORB_O_PAGE_PROTOCOL_MISMATCH",
+    "category": "orbital_ref",
+    "description": "A page reference is written with a protocol other than the referenced page's"
+  },
+  {
+    "code": "ORB_O_SIBLING_ENTITY_AMBIGUOUS",
+    "category": "orbital_ref",
+    "description": "A sibling entity is declared by two imports with different fields"
+  },
+  {
+    "code": "ORB_T_AMBIGUOUS_TYPE_NAME",
+    "category": "trait",
+    "description": "A type name is declared by two sources with different shapes"
+  },
+  {
+    "code": "ORB_T_CONFLICTING_TYPE_ALIAS",
+    "category": "trait",
+    "description": "A struct alias is declared both locally and by an imported trait with different shapes"
+  },
+  {
+    "code": "ORB_T_EMIT_MERGE_CONFLICT",
+    "category": "trait",
+    "description": "An emit from an inline-expanded trait collides with an emit of different payload"
+  },
+  {
+    "code": "ORB_T_LAMBDA_STATEFUL_TRAIT",
+    "category": "trait",
+    "description": "A trait used as a lambda keeps its own state machine"
+  },
+  {
+    "code": "ORB_T_LISTEN_KEY_DROPPED",
+    "category": "trait",
+    "description": "A call-site listens override restates a keyed route without its per clause"
+  },
+  {
+    "code": "ORB_T_TYPE_IMPORT_REFUSED",
+    "category": "trait",
+    "description": "A program uses a type declared by a behavior instead of declaring or sharing it"
+  },
   {
     "code": "CIRCUIT_ACTION_COMPONENT_MISMATCH",
     "category": "circuit",
@@ -407,7 +527,7 @@
   {
     "code": "ORB_BINDING_FROM_ENTITY_OUTSIDE_ENSURES",
     "category": "binding",
-    "description": "@fromEntity is the row before a transition and may only be used inside an @ensures"
+    "description": "The @fromEntity binding is the row before a transition and may only be used inside an @ensures"
   },
   {
     "code": "ORB_BINDING_INVALID_FORMAT",
@@ -524,6 +644,11 @@
     "category": "circuit",
     "description": "A transition declares async result events but its target state has no arm handling them, so the requester cannot hear its own result"
   },
+  {
+    "code": "ORB_CIRCUIT_ASYNC_RESULT_DEAF_WAITING",
+    "category": "circuit",
+    "description": "A state that only an async result can leave is reachable while a call-service is in flight and has no arm for that call's outcome, so the outcome is dropped there"
+  },
   {
     "code": "ORB_CIRCUIT_DEAD_BODILESS_ACTION",
     "category": "circuit",
@@ -539,6 +664,11 @@
     "category": "circuit",
     "description": "A state handles a failure event but its arm neither renders nor emits a declared event, so the failure reaches no one"
   },
+  {
+    "code": "ORB_CIRCUIT_INIT_ARM_NEVER_FIRES",
+    "category": "circuit",
+    "description": "Every INIT arm of a trait's initial state is guarded by a condition that is false for the composition's config and no other arm of that state can fire, so the trait never starts"
+  },
   {
     "code": "ORB_CIRCUIT_INIT_UNCOVERED_STATE",
     "category": "circuit",
@@ -574,6 +704,11 @@
     "category": "circuit",
     "description": "A page's content owner repaints its region on a user-triggered event with a body that offers no way on"
   },
+  {
+    "code": "ORB_CLIENT_ENTITY_SERVER_ONLY",
+    "category": "orbital",
+    "description": "A client trait is linked to the entity of an orbital whose every page is a protocol endpoint, which the client program leaves out"
+  },
   {
     "code": "ORB_COMPOSED_STATE_UNREACHABLE",
     "category": "circuit",
@@ -709,6 +844,11 @@
     "category": "effect",
     "description": "An effect is written in a retired object form instead of the array form"
   },
+  {
+    "code": "ORB_EFF_SERVER_EFFECT_NO_FAILURE_ROUTE",
+    "category": "effect",
+    "description": "A fetch, persist or call-service effect on a server entity declares no `emit: { failure }` route, so its error reaches no one"
+  },
   {
     "code": "ORB_EFF_SET_INVALID_BINDING",
     "category": "effect",
@@ -759,11 +899,21 @@
     "category": "entity",
     "description": "An entity declares owner columns but has no access policy scoping rows to the owner"
   },
+  {
+    "code": "ORB_ENTITY_READ_UNDECLARED",
+    "category": "entity",
+    "description": "A persistent entity declares neither an @read policy nor an @read none waiver, so who reads its rows is unstated"
+  },
   {
     "code": "ORB_ENTITY_SPLIT_MUTATION",
     "category": "entity_mutation",
     "description": "A runtime entity is mutated by several traits on isolated per-trait copies while another trait reads a field it never writes"
   },
+  {
+    "code": "ORB_ENTITY_WRITE_UNDECLARED",
+    "category": "entity",
+    "description": "A persistent entity declares no @create, or declares some write directives but not all of @create, @update and @delete, so an undeclared write is allow-all"
+  },
   {
     "code": "ORB_E_DUPLICATE_FIELD",
     "category": "entity",
@@ -879,6 +1029,11 @@
     "category": "effect",
     "description": "A fetch with total none skips the count, so the success event's totalCount is never set and may not be read"
   },
+  {
+    "code": "ORB_FETCH_UNBOUNDED",
+    "category": "query",
+    "description": "A fetch of a persistent entity has no limit, id or nearest, so it reads every row"
+  },
   {
     "code": "ORB_FETCH_UNINDEXED",
     "category": "query",
@@ -984,6 +1139,21 @@
     "category": "inbound",
     "description": "An inbound hook event answers with an event the trait does not declare in emits"
   },
+  {
+    "code": "ORB_INBOUND_CLI_DASH_WORD",
+    "category": "inbound",
+    "description": "A cli- inbound hook has an empty command word, so a word would start with a dash"
+  },
+  {
+    "code": "ORB_INBOUND_CLI_RESERVED",
+    "category": "inbound",
+    "description": "A cli- inbound hook takes a command word the orb bootloader reserves"
+  },
+  {
+    "code": "ORB_INBOUND_CLI_SHADOWED",
+    "category": "inbound",
+    "description": "A cli- inbound hook is a prefix of a longer cli- hook, so the longer hook takes the arguments that begin with its next word"
+  },
   {
     "code": "ORB_INBOUND_DUPLICATE",
     "category": "inbound",
@@ -1019,6 +1189,11 @@
     "category": "lint",
     "description": "json/parse re-parses what json/stringify just serialized; a stringify→parse round trip launders a value's type past the checker (owner hard rule, CLAUDE.md). Narrow with `as`."
   },
+  {
+    "code": "ORB_JSON_STRINGIFY_KEY",
+    "category": "lint",
+    "description": "json/stringify is an operand of =, !=, array/unique, array/indexOf or an object/set key; compare or key by value/key instead of serialized text"
+  },
   {
     "code": "ORB_LINT_FINDING_CODE_UNDECLARED",
     "category": "lint",
@@ -1069,6 +1244,11 @@
     "category": "listen",
     "description": "A listens route is redundant because the embedded trait already receives that event"
   },
+  {
+    "code": "ORB_LISTEN_ROUTE_PROJECTION_MISMATCH",
+    "category": "trait_event",
+    "description": "A listens route copies a payload field projected from one entity field into a payload field projected from a different field of the same entity"
+  },
   {
     "code": "ORB_LISTEN_ROUTE_STARVES_REQUIRED_FIELD",
     "category": "trait_event",
@@ -1329,6 +1509,11 @@
     "category": "persist",
     "description": "A persist effect names its row id with an expression instead of a binding path or literal id, so no row key resolves"
   },
+  {
+    "code": "ORB_PERSIST_UPDATE_WITHOUT_CREATE",
+    "category": "cross",
+    "description": "A persistent entity the program updates but never creates, upserts or batch-creates, and that declares no instances: the update can never find a row. An update made by a trait authored in this program that binds the entity as its `@rebindable` placeholder is not judged, since the program that composes the trait owns the rows; nor is an update by a trait authored in an orbital that declares `expects entity` for that entity (a composed copy of the trait is still judged), which states that another part of the program supplies the rows"
+  },
   {
     "code": "ORB_PERSIST_WHERE_NOT_A_PREDICATE",
     "category": "persist",
@@ -1369,6 +1554,11 @@
     "category": "page",
     "description": "A page declares an empty traits array"
   },
+  {
+    "code": "ORB_P_ENTRY_UNKNOWN_ROUTE",
+    "category": "page",
+    "description": "An entry route of the app names a path that is no page of the app"
+  },
   {
     "code": "ORB_P_HOST_RESERVED_ROUTE",
     "category": "page",
@@ -1414,6 +1604,11 @@
     "category": "page",
     "description": "A page has no traits array for trait-driven UI"
   },
+  {
+    "code": "ORB_P_ROUTE_PARAM_MISSING_FOR_INIT",
+    "category": "page",
+    "description": "A route page whose path lacks a :param for a field a mounted trait declares required on its INIT event, so navigating to it is refused"
+  },
   {
     "code": "ORB_P_SIGN_IN_UNKNOWN_ROUTE",
     "category": "page",
@@ -1454,6 +1649,11 @@
     "category": "render_ui",
     "description": "A non-drawable child is composed under a canvas draw-host, which paints only neutral drawable descriptors"
   },
+  {
+    "code": "ORB_RUI_CONTROLLED_WITHOUT_CHANGE",
+    "category": "render_ui",
+    "description": "A control whose value is bound to a non-literal and that wires none of the events that report its change: the field cannot be edited"
+  },
   {
     "code": "ORB_RUI_ELEMENT_SHAPE_MISMATCH",
     "category": "render_ui",
@@ -1554,6 +1754,16 @@
     "category": "slot",
     "description": "No trait on a page renders anything into the main slot"
   },
+  {
+    "code": "ORB_SLOT_MAIN_ONLY_CONTAINERS",
+    "category": "slot",
+    "description": "Every trait render into the main slot of a page paints only empty layout-only containers, so nothing is shown"
+  },
+  {
+    "code": "ORB_STATE_TRAPPED",
+    "category": "composed",
+    "description": "A trait can reach a state that no event the program sends can take it out of"
+  },
   {
     "code": "ORB_STORE_DRIVER_CONTRACT",
     "category": "store",
@@ -1674,6 +1884,11 @@
     "category": "schema",
     "description": "A read of a field of the signed-in user names a field the declared identity entity does not have"
   },
+  {
+    "code": "ORB_S_USER_ID_EMPTY_COMPARISON",
+    "category": "schema",
+    "description": "A comparison of @user.id with the empty string, which is never true of a viewer: the anonymous viewer's id is \"anonymous\", so the comparison is constant"
+  },
   {
     "code": "ORB_TAB_EFFECT_ON_SERVER",
     "category": "tab",
@@ -1869,6 +2084,11 @@
     "category": "trait",
     "description": "A config field typed secret does not default to a string credential reference"
   },
+  {
+    "code": "ORB_T_SERVER_TRAIT_CLIENT_EFFECT",
+    "category": "trait",
+    "description": "A trait that runs every step on the server performs an effect only a client can do and the kernel does not forward to one"
+  },
   {
     "code": "ORB_T_STATE_UNREACHABLE",
     "category": "trait",
@@ -1924,11 +2144,21 @@
     "category": "lint",
     "description": "A parse inside a lambda re-parses the same value for every element and should be bound once outside"
   },
+  {
+    "code": "ORB_X_BARE_LISTEN_UNROUTED",
+    "category": "cross",
+    "description": "A trait declares a bare listens contract for an event another orbital emits to the embedder, and no route joins them"
+  },
   {
     "code": "ORB_X_CIRCULAR_DEPENDENCY",
     "category": "cross",
     "description": "Traits form a circular event dependency"
   },
+  {
+    "code": "ORB_X_COLLECTION_ENUM_MISMATCH",
+    "category": "cross",
+    "description": "Two persistent entities on one collection declare the same field as an enum with different value sets, so one entity's rows fail the other's type"
+  },
   {
     "code": "ORB_X_CROSS_EMITTER_DECLARED_PAYLOAD_MISMATCH",
     "category": "cross",

package/dist/language/vocabulary.json

@@ -23,6 +23,7 @@
     "from",
     "to",
     "every",
+    "in",
     "capabilities",
     "match",
     "external",
@@ -76,6 +77,7 @@
     "icon",
     "siteName",
     "signIn",
+    "entries",
     "authenticated",
     "index",
     "noindex",
@@ -222,6 +224,7 @@
     "file",
     "bytes",
     "CallKey",
+    "MessageKey",
     "field",
     "email",
     "url",
@@ -276,6 +279,7 @@
     "additionalProperties": "additionalProperties",
     "address": "address",
     "after": "after",
+    "afterEntryMs": "afterEntryMs",
     "alias": "alias",
     "animations": "animations",
     "answers": "answers",
@@ -308,6 +312,7 @@
     "content": "content",
     "create": "create",
     "create_policy": "create_policy",
+    "create_server": "create_server",
     "createdAt": "createdAt",
     "credential": "credential",
     "curName": "curName",
@@ -337,6 +342,7 @@
     "display": "display",
     "displayName": "displayName",
     "domainContext": "domainContext",
+    "droppedListens": "droppedListens",
     "effectRow": "effectRow",
     "effects": "effects",
     "egress": "egress",
@@ -418,6 +424,7 @@
     "linkedEntityId": "linkedEntityId",
     "links": "links",
     "listPattern": "listPattern",
+    "listen": "listen",
     "listened": "listened",
     "listens": "listens",
     "local": "local",
@@ -435,6 +442,7 @@
     "motion": "motion",
     "mounts": "mounts",
     "name": "name",
+    "nearest": "nearest",
     "nestedForwardedFrom": "nestedForwardedFrom",
     "net": "net",
     "nullable": "nullable",
@@ -487,6 +495,7 @@
     "radii": "radii",
     "read": "read",
     "read_policy": "read_policy",
+    "read_server": "read_server",
     "reconnect": "reconnect",
     "record": "record",
     "ref": "ref",
@@ -516,6 +525,7 @@
     "sections": "sections",
     "seedMock": "seedMock",
     "semanticRole": "semanticRole",
+    "serverListens": "serverListens",
     "serverPath": "serverPath",
     "services": "services",
     "shadows": "shadows",
@@ -585,6 +595,7 @@
     "types": "types",
     "typography": "typography",
     "ui": "ui",
+    "union": "union",
     "unique": "unique",
     "update": "update",
     "update_policy": "update_policy",
@@ -602,5 +613,56 @@
     "vocabulary": "vocabulary",
     "whileVisible": "whileVisible",
     "wired": "wired"
-  }
+  },
+  "fieldTypes": [
+    "string",
+    "number",
+    "int",
+    "i8",
+    "i16",
+    "i32",
+    "i64",
+    "u8",
+    "u16",
+    "u32",
+    "u64",
+    "f32",
+    "f64",
+    "boolean",
+    "date",
+    "datetime",
+    "timestamp",
+    "instant",
+    "email",
+    "url",
+    "phone",
+    "uuid",
+    "image",
+    "money",
+    "file",
+    "bytes",
+    "CallKey",
+    "MessageKey",
+    "array",
+    "object",
+    "enum",
+    "relation",
+    "trait",
+    "orbital",
+    "behavior",
+    "slot",
+    "pattern",
+    "node",
+    "event",
+    "union",
+    "tuple"
+  ],
+  "reservedCliWords": [
+    "run",
+    "help",
+    "--help",
+    "-h",
+    "--version",
+    "-V"
+  ]
 }

package/dist/language-data.js

@@ -1,6 +1,6 @@
-import { installedPackageDirs, userStoreDir } from './chunk-RGACZEYC.js';
-import { parseVocabularyPack } from './chunk-DNS4GKQV.js';
-import './chunk-B4MNHGBP.js';
+import { installedPackageDirs, userStoreDir } from './chunk-DDBAQMWA.js';
+import { parseVocabularyPack } from './chunk-27Y5AXHB.js';
+import './chunk-5IRZ6ROW.js';
 import { readFileSync, existsSync, readdirSync } from 'fs';
 import { join, dirname, resolve } from 'path';
 
@@ -100,5 +100,3 @@ function readLanguageBundle(fromDir, userStore = userStoreDir()) {
 }
 
 export { LanguageDataError, readLanguageBundle, readVocabularyPacks };
-//# sourceMappingURL=language-data.js.map
-//# sourceMappingURL=language-data.js.map

package/dist/lolo-document/index.js

@@ -662,5 +662,3 @@ function addEntityFields(doc, entityName, fields) {
 }
 
 export { addEntityFields, addListens, addTraitRef, addUses, aliasForBehavior, appendPageTrait, applyEdits, arrayElementSpans, findPage, formatLoloValue, lineStart, matchDelimiter, parseLoloDocument, removePageTrait, removeTrait, renameEvent, setConfigArrayRow, setConfigValue, setEmbedAttribute, usesAlias };
-//# sourceMappingURL=index.js.map
-//# sourceMappingURL=index.js.map

package/dist/patterns/component-mapping.json

@@ -1,6 +1,6 @@
 {
   "version": "1.0.0",
-  "exportedAt": "2026-11-07T03:57:49.631Z",
+  "exportedAt": "2026-11-14T09:17:31.667Z",
   "mappings": {
     "page-header": {
       "component": "PageHeader",
@@ -1343,6 +1343,16 @@
       "component": "GuestView",
       "importPath": "@almadar/shell-web/components/core/molecules/GuestView",
       "category": "component"
+    },
+    "annotated-media": {
+      "component": "AnnotatedMedia",
+      "importPath": "@almadar/shell-web/components/core/molecules/AnnotatedMedia",
+      "category": "component"
+    },
+    "draw-emitter": {
+      "component": "DrawEmitter",
+      "importPath": "@almadar/shell-web/components/game/atoms/DrawEmitter",
+      "category": "game"
     }
   }
 }

package/dist/patterns/definitions.d.ts

@@ -1,4 +1,4 @@
 export { PATTERN_REGISTRY, getPatternDefinition, patternsRegistry, registry } from './index.js';
-import '../effect-C2VKm6kk.js';
+import '../effect-gddySYLX.js';
 import 'zod';
-import '../expression-DirYKz-f.js';
+import '../expression-DxY6ct3t.js';

package/dist/patterns/definitions.js

@@ -1,3 +1 @@
-export { PATTERN_REGISTRY, getPatternDefinition, patternsRegistry, registry } from '../chunk-N3CK4AYW.js';
-//# sourceMappingURL=definitions.js.map
-//# sourceMappingURL=definitions.js.map
+export { PATTERN_REGISTRY, getPatternDefinition, patternsRegistry, registry } from '../chunk-VC3HXUWQ.js';

package/dist/patterns/event-contracts.json

@@ -1,6 +1,6 @@
 {
   "version": "1.0.0",
-  "exportedAt": "2026-11-07T03:57:49.631Z",
+  "exportedAt": "2026-11-14T09:17:31.667Z",
   "contracts": {
     "form": {
       "emits": [