@almadar/core 10.97.0 → 10.100.0

package/README.md

@@ -20,6 +20,31 @@ import { /* ... */ } from '@almadar/core';
 
 <!-- Document public exports here -->
 
+## Event-wire fixtures (`@almadar/core/fixtures`)
+
+`fixtures/events-wire/<case>/{request,response}.json` (+ `stream.json` for
+`sse-stream`, `live-push.json` for `live-push`) is the ONE recorded fixture
+set for the event-dispatch wire (Program A, §156) — canonical =
+`OrbitalEventRequest`/`OrbitalEventResponse`/`LiveBroadcastItem` from
+`src/types/bus.ts`. Generated and zod-validated by
+`scripts/generate-event-wire-fixtures.ts` (`pnpm run build:fixtures`, wired
+into `build`); loaded at runtime via `loadEventWireFixture(caseName)` /
+`EVENT_WIRE_FIXTURE_CASES` from the `@almadar/core/fixtures` subpath
+(Node-only — reads from disk — never the main entry).
+
+Consumers, all reading these SAME files instead of hand-rolled wire
+examples:
+
+- vitest in `@almadar/runtime`, `@almadar/ui`, `almadar-playground-runtime`
+- `cargo test` in `orbital-core` (serde round trip), `orbital-server`
+  (posts fixture requests), `orbital-client`, and the Android/iOS native
+  shell decoders
+- the Hono/Express codegen contract test (`orbital-shell-typescript`)
+- `orb verify --server`
+
+Separate from `packages/almadar-parity` (behaviour traces across execution
+paths, not wire bytes).
+
 ## License
 
 BSL 1.1 (Business Source License). Converts to Apache 2.0 on 2030-02-01. Non-production use is free.

package/dist/builders.d.ts

@@ -1,9 +1,10 @@
-import { I as IdentityLedger, A as AnyPatternConfig, U as UISlot, c as Effect, i as RenderBinding, j as RenderUIEffect, e as EntityId, f as Entity, E as EntityField, a as EntityPersistence, g as EntityRow } from './effect-Bw8T4qh5.js';
-import { a as OrbitalDefinition, O as OrbitalSchema, U as UseDeclaration, E as EntityRef, b as ExpectDeclaration, P as PageRef, c as Page, d as PageRefObject } from './schema-DPpES4qj.js';
-import { b as TraitConfig, h as Trait, T as TraitEventListener, i as CallSiteConfig, k as TraitEventContract, d as TraitRef, a as TraitReference } from './trait-DXXRrRMP.js';
-import { S as SExpr } from './expression-WfTp2arD.js';
+import { I as IdentityLedger, A as AnyPatternConfig, U as UISlot, c as Effect, l as RenderBinding, m as RenderUIEffect, e as EntityId, f as Entity, E as EntityField, a as EntityPersistence, g as EntityRow } from './effect-Hm_QDaSI.js';
+import { a as OrbitalDefinition, O as OrbitalSchema, U as UseDeclaration, E as EntityRef, b as ExpectDeclaration, P as PageRef, c as Page, d as PageRefObject } from './schema-TqLV2wlK.js';
+import { b as TraitConfig, h as Trait, T as TraitEventListener, i as CallSiteConfig, k as TraitEventContract, d as TraitRef, a as TraitReference } from './trait-YlNXc4H3.js';
+import { S as SExpr } from './expression-DRwzVnMu.js';
 import 'zod';
 import './json-D8gmyK3l.js';
+import './domain-Ds_7wZIL.js';
 
 /**
  * Event Wiring

package/dist/builders.js

@@ -415,6 +415,19 @@ var SExprSchema = z.lazy(
   ])
 );
 var ExpressionSchema = SExprSchema;
+var EventPayloadValueSchema = z.lazy(
+  () => z.union([
+    z.string(),
+    z.number(),
+    z.boolean(),
+    z.date(),
+    z.null(),
+    z.undefined(),
+    EventPayloadSchema,
+    z.array(EventPayloadValueSchema)
+  ])
+);
+var EventPayloadSchema = z.lazy(() => z.record(EventPayloadValueSchema));
 
 // src/types/entity.ts
 var EntityPersistenceSchema = z.enum([
@@ -463,6 +476,7 @@ var EntitySchema = OrbitalEntitySchema;
 var FieldValueSchema = z.lazy(
   () => z.union([z.string(), z.number(), z.boolean(), z.date(), z.null(), z.array(FieldValueSchema), z.record(FieldValueSchema.optional())])
 );
+z.object({ id: z.string().optional() }).catchall(FieldValueSchema.optional());
 var UI_SLOTS = [
   // App slots
   "main",
@@ -496,6 +510,14 @@ var EffectSchema = z.array(SExprDataSchema).min(1).refine(
   (arr) => typeof arr[0] === "string",
   { message: "Effect must be an S-expression with a string operator as first element" }
 );
+z.custom(
+  (value) => value === null || typeof value === "object" && value !== null && !Array.isArray(value),
+  { message: "Expected a pattern config object or null" }
+);
+z.custom(
+  (value) => typeof value === "object" && value !== null && !Array.isArray(value),
+  { message: "Expected a resolved pattern props object" }
+);
 
 // src/types/state-machine.ts
 var StateSchema = z.object({
@@ -873,6 +895,8 @@ var TraitSchema = z.object({
   ticks: z.array(TraitTickSchema).optional(),
   emits: z.array(TraitEventContractSchema).optional(),
   listens: z.array(TraitEventListenerSchema).optional(),
+  /** Call-site rename map (`events { ACTION: CONFIRM_VOID }`) — mirrors `Trait.events`. */
+  events: z.record(z.string().min(1), z.string().min(1)).optional(),
   ui: TraitUIBindingSchema.optional(),
   config: DeclaredTraitConfigSchema.optional(),
   sourceBehavior: SourceBehaviorMetadataSchema.optional(),
@@ -1194,40 +1218,44 @@ var GeometryTokensSchema = z.object({
   borderStandard: z.string().optional(),
   borderHeavy: z.string().optional()
 });
-var ColorTokensSchema = z.object({
-  primary: z.string().optional(),
-  primaryHover: z.string().optional(),
-  primaryForeground: z.string().optional(),
-  secondary: z.string().optional(),
-  secondaryHover: z.string().optional(),
-  secondaryForeground: z.string().optional(),
-  accent: z.string().optional(),
-  accentForeground: z.string().optional(),
-  muted: z.string().optional(),
-  mutedForeground: z.string().optional(),
-  background: z.string().optional(),
-  foreground: z.string().optional(),
-  card: z.string().optional(),
-  cardForeground: z.string().optional(),
-  surface: z.string().optional(),
-  border: z.string().optional(),
-  input: z.string().optional(),
-  ring: z.string().optional(),
-  error: z.string().optional(),
-  errorForeground: z.string().optional(),
-  success: z.string().optional(),
-  successForeground: z.string().optional(),
-  warning: z.string().optional(),
-  warningForeground: z.string().optional(),
-  info: z.string().optional(),
-  infoForeground: z.string().optional(),
-  tableHeader: z.string().optional(),
-  tableBorder: z.string().optional(),
-  tableRowHover: z.string().optional(),
-  surfaceHover: z.string().optional(),
-  borderHover: z.string().optional(),
-  placeholder: z.string().optional()
-});
+var COLOR_TOKEN_KEY_LIST = [
+  "primary",
+  "primaryHover",
+  "primaryForeground",
+  "secondary",
+  "secondaryHover",
+  "secondaryForeground",
+  "accent",
+  "accentForeground",
+  "muted",
+  "mutedForeground",
+  "background",
+  "foreground",
+  "card",
+  "cardForeground",
+  "surface",
+  "border",
+  "input",
+  "ring",
+  "error",
+  "errorForeground",
+  "success",
+  "successForeground",
+  "warning",
+  "warningForeground",
+  "info",
+  "infoForeground",
+  "tableHeader",
+  "tableBorder",
+  "tableRowHover",
+  "surfaceHover",
+  "borderHover",
+  "placeholder"
+];
+var COLOR_TOKEN_KEYS = COLOR_TOKEN_KEY_LIST;
+var ColorTokensSchema = z.object(
+  Object.fromEntries(COLOR_TOKEN_KEYS.map((key) => [key, z.string().optional()]))
+);
 var IllustrationStyleSchema = z.enum([
   "minimal",
   "illustrated",