@almadar/core 10.101.0 → 10.103.0

package/dist/{bus-B8evi8AZ.d.ts → bus-BGojNDOE.d.ts}

@@ -1,6 +1,6 @@
-import { F as FieldValue, S as ServerReportedEffect, N as NamespacedEffectName, g as EntityRow, d as OrbitalId, T as TraitId, b as EventId, h as PatternConfig, i as ResolvedPatternProps, A as AnyPatternConfig } from './effect-Hm_QDaSI.js';
+import { F as FieldValue, S as ServerReportedEffect, N as NamespacedEffectName, g as EntityRow, d as OrbitalId, T as TraitId, b as EventId, h as PatternConfig, i as ResolvedPatternProps, A as AnyPatternConfig } from './effect-Xn3LIyL7.js';
 import { z } from 'zod';
-import { a as EventPayloadValue, b as EventPayload } from './expression-DRwzVnMu.js';
+import { a as EventPayloadValue, b as EventPayload } from './expression-CfeHdS-f.js';
 
 /**
  * Authenticated user context — what `@user.x` resolves against.
@@ -337,8 +337,25 @@ interface BusEventSource {
      */
     originClientId?: string;
 }
+/** The delivery a transition is processing: `@event`, and one element of `@prevEvents` (Runtime Spec Clause 5.5). */
+interface DeliveryRecord {
+    event: string;
+    payload?: EventPayload;
+    source: BusEventSource;
+}
+/** A trait's log so far in a dispatch that began elsewhere (`@prevEvents` / `@prevStates`), carried on the request. */
+interface DispatchLog {
+    prevEvents: DeliveryRecord[];
+    prevStates: string[];
+}
+/** The evaluator value of a delivery record: `source` carries exactly the ten `BusEventSource` fields that are set. */
+declare function deliveryRecordValue(record: DeliveryRecord): EventPayload;
 /** Zod twin of `BusEventSource`. */
 declare const BusEventSourceSchema: z.ZodType<BusEventSource, z.ZodTypeDef, object>;
+/** Zod twin of `DeliveryRecord`. */
+declare const DeliveryRecordSchema: z.ZodType<DeliveryRecord, z.ZodTypeDef, object>;
+/** Zod twin of `DispatchLog`. */
+declare const DispatchLogSchema: z.ZodType<DispatchLog, z.ZodTypeDef, object>;
 /**
  * An event flowing on the bus.
  *
@@ -475,6 +492,10 @@ interface OrbitalEventRequest {
     entityByTrait?: Record<string, EntityRow>;
     /** The orbital/behavior name this dispatch targets, for stateless multi-orbital addressing. */
     behavior?: string;
+    /** `@event` for the target when this request continues a dispatch that began on the client; absent = a direct dispatch. */
+    delivery?: DeliveryRecord;
+    /** The target trait's log so far in that dispatch; absent = empty. */
+    dispatchLog?: DispatchLog;
 }
 /** Structured reason one trait (or the whole dispatch) did not transition. */
 type TransitionRejectionCode = 'no-matching-transition' | 'guard-rejected' | 'no-dispatchable-traits';
@@ -493,6 +514,18 @@ interface TransitionRejection {
     transition?: string;
     guard?: unknown;
 }
+/**
+ * One client effect paired with the trait that produced it and, when the
+ * producer knows it, the transition that fired: that transition's own event
+ * key (for a listens delivery, the triggered event, not the source emit) and
+ * the state it fired from. A client stamps render provenance from these.
+ */
+interface ClientEffectByTrait {
+    traitName: string;
+    effect: ClientEffectTuple;
+    event?: string;
+    fromState?: string;
+}
 /**
  * Server → client event dispatch response. Mirrors the compiled path's
  * generated `EventResponse` (orbital-shell-typescript's `shared/types.ts`,
@@ -537,10 +570,7 @@ interface OrbitalEventResponse {
      *
      * Same length and ordering as `clientEffects`; entries are 1:1 by index.
      */
-    clientEffectsByTrait?: Array<{
-        traitName: string;
-        effect: ClientEffectTuple;
-    }>;
+    clientEffectsByTrait?: ClientEffectByTrait[];
     /** Results from server-side effects (persist, call-service, set). */
     effectResults?: ServerEffectResult[];
     /** Guard that failed, addressed as `"<Trait>.<event>"`, for debugging. */
@@ -566,6 +596,21 @@ interface OrbitalEventResponse {
 declare const OrbitalEventRequestSchema: z.ZodType<OrbitalEventRequest, z.ZodTypeDef, object>;
 /** Zod twin of `OrbitalEventResponse`. Third type param `object`, see `BusEventSourceSchema`. */
 declare const OrbitalEventResponseSchema: z.ZodType<OrbitalEventResponse, z.ZodTypeDef, object>;
+/**
+ * Where circuit state lives between events (`docs/Almadar_Runtime_Stateless_Stateful_PLAN.md` §1a):
+ * `'stateless'` = the client carries it on every request, `'stateful'` = the server holds it.
+ */
+type ServerTopology = 'stateless' | 'stateful';
+declare const ServerTopologySchema: z.ZodEnum<["stateless", "stateful"]>;
+/** `POST /register` response. `topology` absent = a server that predates the declaration. */
+interface OrbitalRegisterResponse {
+    success: boolean;
+    topology?: ServerTopology;
+    message?: string;
+    orbitals?: string[];
+    error?: string;
+}
+declare const OrbitalRegisterResponseSchema: z.ZodType<OrbitalRegisterResponse, z.ZodTypeDef, object>;
 /**
  * One persist-envelope success emit, handed to the live-broadcast sink
  * (`OrbitalServerRuntime.setLiveBroadcastSink`) and relayed to every OTHER
@@ -594,4 +639,4 @@ type EventDispatchResponse = OrbitalEventResponse;
 /** @deprecated use {@link OrbitalEventResponseSchema}. */
 declare const EventDispatchResponseSchema: z.ZodType<OrbitalEventResponse, z.ZodTypeDef, object>;
 
-export { ANONYMOUS_USER as A, type BusEvent as B, type ClientEffectTuple as C, DEFAULT_VIEWER as D, type EmittedEvent as E, ServerEffectResultSchema as F, type TransitionRejectionCode as G, type Unsubscribe as H, decodeDevIdentityToken as I, encodeDevIdentityToken as J, findPersonaInRoster as K, type LiveBroadcastItem as L, normalizeUserContext as M, personaFromIdentityRow as N, type OrbitalEventRequest as O, resolveDefaultViewer as P, resolvePersonaSpec as Q, type RawUserClaims as R, type ServerBatchSummary as S, type TransitionRejection as T, type UserContext as U, type OrbitalEventResponse as a, type BusEventListener as b, type BusEventSource as c, BusEventSourceSchema as d, ClientEffectTupleSchema as e, type ClientNavigateBackTuple as f, ClientNavigateBackTupleSchema as g, type ClientNavigateTuple as h, ClientNavigateTupleSchema as i, type ClientRenderUITuple as j, ClientRenderUITupleSchema as k, DEV_TOKEN_PREFIX as l, EmittedEventSchema as m, type EventDispatchRequest as n, EventDispatchRequestSchema as o, type EventDispatchResponse as p, EventDispatchResponseSchema as q, type EventEmit as r, type EventKey as s, type EventListen as t, LiveBroadcastItemSchema as u, OrbitalEventRequestSchema as v, OrbitalEventResponseSchema as w, RawUserClaimsSchema as x, ServerBatchSummarySchema as y, type ServerEffectResult as z };
+export { normalizeUserContext as $, ANONYMOUS_USER as A, type BusEvent as B, type ClientEffectTuple as C, DEFAULT_VIEWER as D, type EmittedEvent as E, OrbitalEventRequestSchema as F, OrbitalEventResponseSchema as G, type OrbitalRegisterResponse as H, OrbitalRegisterResponseSchema as I, RawUserClaimsSchema as J, ServerBatchSummarySchema as K, type LiveBroadcastItem as L, type ServerEffectResult as M, ServerEffectResultSchema as N, type OrbitalEventRequest as O, type ServerTopology as P, ServerTopologySchema as Q, type RawUserClaims as R, type ServerBatchSummary as S, type TransitionRejection as T, type UserContext as U, type TransitionRejectionCode as V, type Unsubscribe as W, decodeDevIdentityToken as X, deliveryRecordValue as Y, encodeDevIdentityToken as Z, findPersonaInRoster as _, type OrbitalEventResponse as a, personaFromIdentityRow as a0, resolveDefaultViewer as a1, resolvePersonaSpec as a2, type BusEventListener as b, type BusEventSource as c, BusEventSourceSchema as d, type ClientEffectByTrait as e, ClientEffectTupleSchema as f, type ClientNavigateBackTuple as g, ClientNavigateBackTupleSchema as h, type ClientNavigateTuple as i, ClientNavigateTupleSchema as j, type ClientRenderUITuple as k, ClientRenderUITupleSchema as l, DEV_TOKEN_PREFIX as m, type DeliveryRecord as n, DeliveryRecordSchema as o, type DispatchLog as p, DispatchLogSchema as q, EmittedEventSchema as r, type EventDispatchRequest as s, EventDispatchRequestSchema as t, type EventDispatchResponse as u, EventDispatchResponseSchema as v, type EventEmit as w, type EventKey as x, type EventListen as y, LiveBroadcastItemSchema as z };

package/dist/{domain-Ds_7wZIL.d.ts → domain-OgMkN3WN.d.ts}

@@ -8315,6 +8315,18 @@ interface NavStackEntry {
  * isThemeReference({ name: "ocean", colors: {...} }); // returns false
  */
 declare function isThemeReference(theme: ThemeRef): theme is string;
+/**
+ * True when `theme` is a registry theme key (e.g. "gazette-light") — a value a
+ * `[data-theme]` selector can match — as opposed to an inline definition or
+ * the legacy "Alias.theme" import form, which must be resolved upstream.
+ */
+declare function isThemeRegistryKey(theme: ThemeRef | undefined): theme is string;
+/**
+ * The `data-theme` key an orbital's `theme` maps to: a string ref is the key
+ * itself, an inline definition keys by its `name`, and an absent theme is "".
+ * Mirrors orbital-core's `theme_data_key`.
+ */
+declare function themeDataKey(theme: ThemeRef | undefined): string;
 /**
  * Validate theme reference format: either the legacy import form
  * "Alias.theme" or a registry theme key (the full kebab-case `data-theme`
@@ -16210,4 +16222,4 @@ type DesignTokensInput = z.input<typeof DesignTokensSchema>;
 type CustomPatternDefinitionInput = z.input<typeof CustomPatternDefinitionSchema>;
 type CustomPatternMapInput = z.input<typeof CustomPatternMapSchema>;
 
-export { IconFamilySchema as $, AGENT_DOMAIN_CATEGORIES as A, type DomainCategory as B, type ColorTokens as C, type DomainContext as D, DomainCategorySchema as E, type DomainContextInput as F, DomainContextSchema as G, type DomainVocabulary as H, DomainVocabularySchema as I, type ElevationSlice as J, ElevationSliceSchema as K, type ElevationTokens as L, ElevationTokensSchema as M, type EntitySemanticRole as N, EntitySemanticRoleSchema as O, type EventSemanticRole as P, EventSemanticRoleSchema as Q, type GameSubCategory as R, type SuggestedGuard as S, type ThemeDefinition as T, GameSubCategorySchema as U, type GeometrySlice as V, GeometrySliceSchema as W, type GeometryTokens as X, GeometryTokensSchema as Y, ILLUSTRATION_TOKEN_KEYS as Z, type IconFamily as _, type ThemeRef as a, TypeSlotSchema as a$, type IconographySlice as a0, IconographySliceSchema as a1, type IconographyTokens as a2, IconographyTokensSchema as a3, type IllustrationSlice as a4, IllustrationSliceSchema as a5, type IllustrationStyle as a6, IllustrationStyleSchema as a7, type IllustrationTokenKey as a8, type IllustrationTokens as a9, type SpacingScale as aA, SpacingScaleSchema as aB, type StateSemanticRole as aC, StateSemanticRoleSchema as aD, SuggestedGuardSchema as aE, ThemeDefinitionSchema as aF, ThemeRefSchema as aG, ThemeRefStringSchema as aH, type ThemeTokens as aI, ThemeTokensSchema as aJ, type ThemeVariant as aK, ThemeVariantSchema as aL, type TypeIntent as aM, type TypeIntentMap as aN, TypeIntentMapSchema as aO, TypeIntentSchema as aP, type TypeScale as aQ, type TypeScaleEntry as aR, TypeScaleEntrySchema as aS, TypeScaleSchema as aT, type TypeScaleTokens as aU, TypeScaleTokensSchema as aV, type TypeSizeKey as aW, TypeSizeKeySchema as aX, type TypeSlice as aY, TypeSliceSchema as aZ, type TypeSlot as a_, IllustrationTokensSchema as aa, type KeysComplete as ab, type MotionDurationKey as ac, MotionDurationKeySchema as ad, type MotionDurationPalette as ae, MotionDurationPaletteSchema as af, type MotionEasingKey as ag, MotionEasingKeySchema as ah, type MotionEasingPalette as ai, MotionEasingPaletteSchema as aj, type MotionIntent as ak, type MotionIntentMap as al, MotionIntentMapSchema as am, MotionIntentSchema as an, type MotionSlice as ao, MotionSliceSchema as ap, type MotionTokens as aq, MotionTokensSchema as ar, type NavItem as as, type NavStackEntry as at, type NodeClassification as au, NodeClassificationSchema as av, type RelatedLink as aw, RelatedLinkSchema as ax, type SkinSpec as ay, SkinSpecSchema as az, type DesignPreferences as b, type TypeWeight as b0, TypeWeightSchema as b1, type UXHints as b2, UXHintsSchema as b3, type UserPersona as b4, type UserPersonaInput as b5, UserPersonaSchema as b6, isThemeReference as b7, type DesignTokens as c, type CustomPatternMap as d, ALLOWED_CUSTOM_COMPONENTS as e, type AgentDomainCategory as f, AgentDomainCategorySchema as g, type AllowedCustomComponent as h, COLOR_TOKEN_KEYS as i, type ColorSlice as j, ColorSliceSchema as k, type ColorTokenKey as l, ColorTokensSchema as m, type CustomPatternDefinition as n, type CustomPatternDefinitionInput as o, CustomPatternDefinitionSchema as p, type CustomPatternMapInput as q, CustomPatternMapSchema as r, type DensitySlice as s, DensitySliceSchema as t, type DensityTokens as u, DensityTokensSchema as v, type DesignPreferencesInput as w, DesignPreferencesSchema as x, type DesignTokensInput as y, DesignTokensSchema as z };
+export { IconFamilySchema as $, AGENT_DOMAIN_CATEGORIES as A, type DomainCategory as B, type ColorTokens as C, type DomainContext as D, DomainCategorySchema as E, type DomainContextInput as F, DomainContextSchema as G, type DomainVocabulary as H, DomainVocabularySchema as I, type ElevationSlice as J, ElevationSliceSchema as K, type ElevationTokens as L, ElevationTokensSchema as M, type EntitySemanticRole as N, EntitySemanticRoleSchema as O, type EventSemanticRole as P, EventSemanticRoleSchema as Q, type GameSubCategory as R, type SuggestedGuard as S, type ThemeDefinition as T, GameSubCategorySchema as U, type GeometrySlice as V, GeometrySliceSchema as W, type GeometryTokens as X, GeometryTokensSchema as Y, ILLUSTRATION_TOKEN_KEYS as Z, type IconFamily as _, type ThemeRef as a, TypeSlotSchema as a$, type IconographySlice as a0, IconographySliceSchema as a1, type IconographyTokens as a2, IconographyTokensSchema as a3, type IllustrationSlice as a4, IllustrationSliceSchema as a5, type IllustrationStyle as a6, IllustrationStyleSchema as a7, type IllustrationTokenKey as a8, type IllustrationTokens as a9, type SpacingScale as aA, SpacingScaleSchema as aB, type StateSemanticRole as aC, StateSemanticRoleSchema as aD, SuggestedGuardSchema as aE, ThemeDefinitionSchema as aF, ThemeRefSchema as aG, ThemeRefStringSchema as aH, type ThemeTokens as aI, ThemeTokensSchema as aJ, type ThemeVariant as aK, ThemeVariantSchema as aL, type TypeIntent as aM, type TypeIntentMap as aN, TypeIntentMapSchema as aO, TypeIntentSchema as aP, type TypeScale as aQ, type TypeScaleEntry as aR, TypeScaleEntrySchema as aS, TypeScaleSchema as aT, type TypeScaleTokens as aU, TypeScaleTokensSchema as aV, type TypeSizeKey as aW, TypeSizeKeySchema as aX, type TypeSlice as aY, TypeSliceSchema as aZ, type TypeSlot as a_, IllustrationTokensSchema as aa, type KeysComplete as ab, type MotionDurationKey as ac, MotionDurationKeySchema as ad, type MotionDurationPalette as ae, MotionDurationPaletteSchema as af, type MotionEasingKey as ag, MotionEasingKeySchema as ah, type MotionEasingPalette as ai, MotionEasingPaletteSchema as aj, type MotionIntent as ak, type MotionIntentMap as al, MotionIntentMapSchema as am, MotionIntentSchema as an, type MotionSlice as ao, MotionSliceSchema as ap, type MotionTokens as aq, MotionTokensSchema as ar, type NavItem as as, type NavStackEntry as at, type NodeClassification as au, NodeClassificationSchema as av, type RelatedLink as aw, RelatedLinkSchema as ax, type SkinSpec as ay, SkinSpecSchema as az, type DesignPreferences as b, type TypeWeight as b0, TypeWeightSchema as b1, type UXHints as b2, UXHintsSchema as b3, type UserPersona as b4, type UserPersonaInput as b5, UserPersonaSchema as b6, isThemeReference as b7, isThemeRegistryKey as b8, themeDataKey as b9, type DesignTokens as c, type CustomPatternMap as d, ALLOWED_CUSTOM_COMPONENTS as e, type AgentDomainCategory as f, AgentDomainCategorySchema as g, type AllowedCustomComponent as h, COLOR_TOKEN_KEYS as i, type ColorSlice as j, ColorSliceSchema as k, type ColorTokenKey as l, ColorTokensSchema as m, type CustomPatternDefinition as n, type CustomPatternDefinitionInput as o, CustomPatternDefinitionSchema as p, type CustomPatternMapInput as q, CustomPatternMapSchema as r, type DensitySlice as s, DensitySliceSchema as t, type DensityTokens as u, DensityTokensSchema as v, type DesignPreferencesInput as w, DesignPreferencesSchema as x, type DesignTokensInput as y, DesignTokensSchema as z };

package/dist/{effect-Hm_QDaSI.d.ts → effect-Xn3LIyL7.d.ts}

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { S as SExpr, b as EventPayload, E as Expression } from './expression-DRwzVnMu.js';
+import { S as SExpr, b as EventPayload, E as Expression } from './expression-CfeHdS-f.js';
 import { J as JsonValue, R as RuntimeValue } from './json-D8gmyK3l.js';
 
 /**

package/dist/{entityAccess-DdcKps16.d.ts → entityAccess-z5HA0P7P.d.ts}

@@ -1,6 +1,6 @@
-import { O as OrbitalEntity } from './effect-Hm_QDaSI.js';
-import { O as OrbitalSchema, a as OrbitalDefinition } from './schema-TqLV2wlK.js';
-import { S as SExpr } from './expression-DRwzVnMu.js';
+import { O as OrbitalEntity } from './effect-Xn3LIyL7.js';
+import { O as OrbitalSchema, a as OrbitalDefinition } from './schema-sHVqe8Kb.js';
+import { S as SExpr } from './expression-CfeHdS-f.js';
 
 /**
  * Entity access policies — the declared `@read`/`@create`/`@update`/`@delete`

package/dist/{expression-DRwzVnMu.d.ts → expression-CfeHdS-f.d.ts}

@@ -255,5 +255,14 @@ type LogMetaValue = string | number | boolean | Date | null | undefined | Error
 interface LogMeta {
     [key: string]: LogMetaValue;
 }
+/**
+ * True when `expr` provably evaluates falsy — the twin of orbital-core's
+ * `SExpression::is_statically_false`, one table on both paths. Conservative:
+ * anything undecidable returns `false` ("not provably false"). `resolve`
+ * turns a binding (`@config.selfFetch`) into its known literal value, or
+ * `undefined` when unknown — the JS path keeps config bindings in guards
+ * where Rust inlines them.
+ */
+declare function isStaticallyFalse(expr: SExpr, resolve?: (binding: string) => SExprAtom | undefined): boolean;
 
-export { walkSExpr as A, CORE_BINDINGS as C, type Expression as E, type LogMeta as L, type ParsedBinding as P, type SExpr as S, type EventPayloadValue as a, type EventPayload as b, type CoreBinding as c, type EvalContext as d, EventPayloadSchema as e, EventPayloadValueSchema as f, type ExpressionInput as g, ExpressionSchema as h, type LogMetaValue as i, type SExprAtom as j, SExprAtomSchema as k, SExprDataSchema as l, type SExprInput as m, type SExprObject as n, SExprSchema as o, collectBindings as p, getArgs as q, getOperator as r, isBinding as s, isEventPayloadValue as t, isSExpr as u, isSExprAtom as v, isSExprCall as w, isValidBinding as x, parseBinding as y, sexpr as z };
+export { sexpr as A, walkSExpr as B, CORE_BINDINGS as C, type Expression as E, type LogMeta as L, type ParsedBinding as P, type SExpr as S, type EventPayloadValue as a, type EventPayload as b, type CoreBinding as c, type EvalContext as d, EventPayloadSchema as e, EventPayloadValueSchema as f, type ExpressionInput as g, ExpressionSchema as h, type LogMetaValue as i, type SExprAtom as j, SExprAtomSchema as k, SExprDataSchema as l, type SExprInput as m, type SExprObject as n, SExprSchema as o, collectBindings as p, getArgs as q, getOperator as r, isBinding as s, isEventPayloadValue as t, isSExpr as u, isSExprAtom as v, isSExprCall as w, isStaticallyFalse as x, isValidBinding as y, parseBinding as z };

package/dist/factory/index.d.ts

@@ -1,10 +1,10 @@
-import { k as FactorySignatureCatalog, h as FactoryParamValue, c as FactoryConfigTier, b as FactoryConfigParam, F as FactoryCallSite, j as FactorySignature, R as RuleOverlay, p as RuleOverlayEntry, o as PresentationOverlay, T as TraitOverlay, J as JsonSchema } from '../types-Ug92oza4.js';
-export { a as FactoryCallSiteParams, d as FactoryEntitySignature, e as FactoryEventSignature, f as FactoryExposure, g as FactoryPageSignature, i as FactoryProvenance, l as FactorySignatureEntityField, m as FactoryTraitSignature, n as JsonSchemaType, O as OwnershipOverlayEntry, P as PresentationNavItem, S as SchemaFieldType, q as TraitOverlayEntry, r as TraitOverlayListener } from '../types-Ug92oza4.js';
-import { a as EntityPersistence, E as EntityField } from '../effect-Hm_QDaSI.js';
-import { a as TraitReference } from '../trait-YlNXc4H3.js';
+import { k as FactorySignatureCatalog, h as FactoryParamValue, c as FactoryConfigTier, b as FactoryConfigParam, F as FactoryCallSite, j as FactorySignature, R as RuleOverlay, p as RuleOverlayEntry, o as PresentationOverlay, T as TraitOverlay, J as JsonSchema } from '../types-DK29MMOQ.js';
+export { a as FactoryCallSiteParams, d as FactoryEntitySignature, e as FactoryEventSignature, f as FactoryExposure, g as FactoryPageSignature, i as FactoryProvenance, l as FactorySignatureEntityField, m as FactoryTraitSignature, n as JsonSchemaType, O as OwnershipOverlayEntry, P as PresentationNavItem, S as SchemaFieldType, q as TraitOverlayEntry, r as TraitOverlayListener } from '../types-DK29MMOQ.js';
+import { a as EntityPersistence, E as EntityField } from '../effect-Xn3LIyL7.js';
+import { a as TraitReference } from '../trait-BSe6oDBd.js';
 export { J as JsonValue } from '../json-D8gmyK3l.js';
 import 'zod';
-import '../expression-DRwzVnMu.js';
+import '../expression-CfeHdS-f.js';
 
 /**
  * Rehydrate `overridableConfigKeys` from a catalog's `knobDefs` table,