@almadar/core 10.102.0 → 10.104.0

package/dist/{bus-BS4TMOJW.d.ts → bus-DCYJF88B.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-DhsB3usU.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. */
@@ -609,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, ServerBatchSummarySchema as F, type ServerEffectResult as G, ServerEffectResultSchema as H, type ServerTopology as I, ServerTopologySchema as J, type TransitionRejectionCode as K, type LiveBroadcastItem as L, type Unsubscribe as M, decodeDevIdentityToken as N, type OrbitalEventRequest as O, encodeDevIdentityToken as P, findPersonaInRoster as Q, type RawUserClaims as R, type ServerBatchSummary as S, type TransitionRejection as T, type UserContext as U, normalizeUserContext as V, personaFromIdentityRow as W, resolveDefaultViewer as X, resolvePersonaSpec as Y, 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, type OrbitalRegisterResponse as x, OrbitalRegisterResponseSchema as y, RawUserClaimsSchema 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-DnEv7amB.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`
@@ -16169,13 +16181,13 @@ declare const CustomPatternDefinitionSchema: z.ZodObject<{
     props: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
 }, "strip", z.ZodTypeAny, {
     type: "custom";
-    component: "label" | "header" | "form" | "article" | "button" | "input" | "h1" | "h2" | "h3" | "h4" | "h5" | "h6" | "section" | "nav" | "aside" | "footer" | "main" | "a" | "div" | "span" | "p" | "ul" | "ol" | "li" | "img";
+    component: "label" | "header" | "form" | "article" | "button" | "input" | "h1" | "h2" | "h3" | "h4" | "h5" | "h6" | "section" | "nav" | "aside" | "main" | "footer" | "a" | "div" | "span" | "p" | "ul" | "ol" | "li" | "img";
     className: string;
     slots?: string[] | undefined;
     props?: string[] | undefined;
 }, {
     type: "custom";
-    component: "label" | "header" | "form" | "article" | "button" | "input" | "h1" | "h2" | "h3" | "h4" | "h5" | "h6" | "section" | "nav" | "aside" | "footer" | "main" | "a" | "div" | "span" | "p" | "ul" | "ol" | "li" | "img";
+    component: "label" | "header" | "form" | "article" | "button" | "input" | "h1" | "h2" | "h3" | "h4" | "h5" | "h6" | "section" | "nav" | "aside" | "main" | "footer" | "a" | "div" | "span" | "p" | "ul" | "ol" | "li" | "img";
     className: string;
     slots?: string[] | undefined;
     props?: string[] | undefined;
@@ -16192,13 +16204,13 @@ declare const CustomPatternMapSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.Z
     props: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
 }, "strip", z.ZodTypeAny, {
     type: "custom";
-    component: "label" | "header" | "form" | "article" | "button" | "input" | "h1" | "h2" | "h3" | "h4" | "h5" | "h6" | "section" | "nav" | "aside" | "footer" | "main" | "a" | "div" | "span" | "p" | "ul" | "ol" | "li" | "img";
+    component: "label" | "header" | "form" | "article" | "button" | "input" | "h1" | "h2" | "h3" | "h4" | "h5" | "h6" | "section" | "nav" | "aside" | "main" | "footer" | "a" | "div" | "span" | "p" | "ul" | "ol" | "li" | "img";
     className: string;
     slots?: string[] | undefined;
     props?: string[] | undefined;
 }, {
     type: "custom";
-    component: "label" | "header" | "form" | "article" | "button" | "input" | "h1" | "h2" | "h3" | "h4" | "h5" | "h6" | "section" | "nav" | "aside" | "footer" | "main" | "a" | "div" | "span" | "p" | "ul" | "ol" | "li" | "img";
+    component: "label" | "header" | "form" | "article" | "button" | "input" | "h1" | "h2" | "h3" | "h4" | "h5" | "h6" | "section" | "nav" | "aside" | "main" | "footer" | "a" | "div" | "span" | "p" | "ul" | "ol" | "li" | "img";
     className: string;
     slots?: string[] | undefined;
     props?: string[] | undefined;
@@ -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 };