@almadar/core 5.1.0 → 5.2.0

package/dist/builders.d.ts

@@ -1,23 +1,8 @@
-import { T as TraitEventContract, E as Entity, S as SExpr, a as TraitEventListener, b as EntityField, c as EntityPersistence, d as EntityRow, U as UseDeclaration, e as EntityRef, f as TraitRef, P as PageRef, O as OrbitalDefinition, g as OrbitalSchema, h as Trait, i as Page, j as PageRefObject, k as TraitReference } from './schema-CsX_xlhO.js';
-export { C as ComposeBehaviorsInput, a as ComposeBehaviorsResult, E as EventWiringEntry, L as LayoutStrategy, b as applyEventWiring, c as composeBehaviors, d as detectLayoutStrategy } from './compose-behaviors-vE2bU7TB.js';
+import { T as TraitEventContract, E as Entity, S as SExpr, a as TraitEventListener, b as TraitConfig, c as EntityField, d as EntityPersistence, e as EntityRow, U as UseDeclaration, f as EntityRef, g as TraitRef, P as PageRef, O as OrbitalDefinition, h as OrbitalSchema, i as Trait, j as Page, k as PageRefObject, l as TraitReference } from './schema-ks5fDpzp.js';
+export { C as ComposeBehaviorsInput, a as ComposeBehaviorsResult, E as EventWiringEntry, L as LayoutStrategy, b as applyEventWiring, c as composeBehaviors, d as detectLayoutStrategy } from './compose-behaviors-BOy-gFQn.js';
 import 'zod';
 import '@almadar/patterns';
 
-/**
- * Orbital Builders
- *
- * Pure functions for constructing and composing Orbitals.
- * No new types. Everything uses existing core types:
- * Entity, Trait, Page, OrbitalDefinition, OrbitalSchema.
- *
- * Three categories:
- * 1. Builders: construct Entity, Page from common params
- * 2. Utilities: ensureIdField, resolveDefaults
- * 3. Composition: connect, compose, pipe
- *
- * @packageDocumentation
- */
-
 /**
  * Ensure the fields array has an `id` field. Prepends one if missing.
  */
@@ -78,12 +63,8 @@ interface MakeTraitRefOpts {
     listens?: TraitEventListener[];
     /** Set every emit's scope. */
     emitsScope?: 'internal' | 'external';
-    /**
-     * Nested config overrides. Matches the real {@link TraitReference.config}
-     * shape: `Record<string, Record<string, unknown>>` (the outer key is the
-     * config field name, the inner record is its value shape).
-     */
-    config?: Record<string, Record<string, unknown>>;
+    /** Call-site config overrides. Matches {@link TraitReference.config}. */
+    config?: TraitConfig;
 }
 /**
  * Build a {@link TraitReference} from options.
@@ -155,7 +136,7 @@ interface MakeAtomOrbitalTraitOverrides {
     effects?: Record<string, SExpr[]>;
     listens?: TraitEventListener[];
     emitsScope?: 'internal' | 'external';
-    config?: Record<string, Record<string, unknown>>;
+    config?: TraitConfig;
 }
 /**
  * Options for {@link makeAtomOrbital}.

package/dist/builders.js

@@ -185,36 +185,6 @@ var OrbitalEntitySchema = z.object({
   assetRef: SemanticAssetRefSchema.optional()
 });
 var EntitySchema = OrbitalEntitySchema;
-var ViewTypeSchema = z.enum([
-  "list",
-  "detail",
-  "create",
-  "edit",
-  "dashboard",
-  "custom"
-]);
-var PageTraitRefSchema = z.object({
-  ref: z.string().min(1, "Trait ref is required"),
-  linkedEntity: z.string().optional(),
-  config: z.record(z.unknown()).optional()
-});
-z.object({
-  name: z.string().min(1, "Page name is required"),
-  path: z.string().min(1, "Page path is required").startsWith("/", "Path must start with /"),
-  primaryEntity: z.string().min(1, "Primary entity is required"),
-  traits: z.array(PageTraitRefSchema).min(1, "Page must have at least one trait"),
-  title: z.string().optional()
-}).strict();
-var OrbitalPageSchema = z.object({
-  name: z.string().min(1, "Page name is required"),
-  path: z.string().min(1, "Page path is required").startsWith("/", "Path must start with /"),
-  viewType: ViewTypeSchema.optional(),
-  title: z.string().optional(),
-  primaryEntity: z.string().optional(),
-  traits: z.array(PageTraitRefSchema).optional(),
-  isInitial: z.boolean().optional()
-}).strict();
-var PageSchema = OrbitalPageSchema;
 var UI_SLOTS = [
   // App slots
   "main",
@@ -311,6 +281,17 @@ var StateMachineSchema = z.object({
 });
 
 // src/types/trait.ts
+var TraitConfigValueSchema = z.lazy(
+  () => z.union([
+    z.string(),
+    z.number(),
+    z.boolean(),
+    z.null(),
+    z.array(TraitConfigValueSchema),
+    z.record(TraitConfigValueSchema)
+  ])
+);
+var TraitConfigSchema = z.record(TraitConfigValueSchema);
 var TraitCategorySchema = z.enum([
   "lifecycle",
   "temporal",
@@ -383,12 +364,22 @@ var TraitEventContractSchema = z.object({
   payload: z.array(EventPayloadFieldSchema).optional(),
   scope: EventScopeSchema.optional()
 });
+var ListenSourceSchema = z.union([
+  z.object({ kind: z.literal("any") }),
+  z.object({ kind: z.literal("trait"), trait: z.string().min(1) }),
+  z.object({
+    kind: z.literal("orbital"),
+    orbital: z.string().min(1),
+    trait: z.string().min(1)
+  })
+]);
 var TraitEventListenerSchema = z.object({
   event: z.string().min(1),
   triggers: z.string().min(1),
   guard: ExpressionSchema.optional(),
   scope: EventScopeSchema.optional(),
-  payloadMapping: z.record(z.string()).optional()
+  payloadMapping: z.record(z.string()).optional(),
+  source: ListenSourceSchema.optional()
 });
 var RequiredFieldSchema = z.object({
   name: z.string().min(1),
@@ -405,7 +396,7 @@ z.object({
     z.string().min(1, "events key (atom event name) must be non-empty"),
     z.string().min(1, "events value (caller event name) must be non-empty")
   ).optional(),
-  config: z.record(z.record(z.unknown())).optional(),
+  config: TraitConfigSchema.optional(),
   appliesTo: z.array(z.string()).optional(),
   // Phase F.7: zod accepts an array (the inliner validates element
   // shape). The full ListenDefinition shape isn't recursively encoded
@@ -456,7 +447,7 @@ var TraitRefSchema = z.union([
   z.string().min(1),
   z.object({
     ref: z.string().min(1),
-    config: z.record(z.unknown()).optional(),
+    config: TraitConfigSchema.optional(),
     linkedEntity: z.string().optional(),
     name: z.string().optional(),
     // Phase F.4: same non-empty refine as TraitReferenceSchema.events.
@@ -473,6 +464,38 @@ var TraitRefSchema = z.union([
 function isInlineTrait(traitRef) {
   return typeof traitRef === "object" && "name" in traitRef && !("ref" in traitRef);
 }
+
+// src/types/page.ts
+var ViewTypeSchema = z.enum([
+  "list",
+  "detail",
+  "create",
+  "edit",
+  "dashboard",
+  "custom"
+]);
+var PageTraitRefSchema = z.object({
+  ref: z.string().min(1, "Trait ref is required"),
+  linkedEntity: z.string().optional(),
+  config: TraitConfigSchema.optional()
+});
+z.object({
+  name: z.string().min(1, "Page name is required"),
+  path: z.string().min(1, "Page path is required").startsWith("/", "Path must start with /"),
+  primaryEntity: z.string().min(1, "Primary entity is required"),
+  traits: z.array(PageTraitRefSchema).min(1, "Page must have at least one trait"),
+  title: z.string().optional()
+}).strict();
+var OrbitalPageSchema = z.object({
+  name: z.string().min(1, "Page name is required"),
+  path: z.string().min(1, "Page path is required").startsWith("/", "Path must start with /"),
+  viewType: ViewTypeSchema.optional(),
+  title: z.string().optional(),
+  primaryEntity: z.string().optional(),
+  traits: z.array(PageTraitRefSchema).optional(),
+  isInitial: z.boolean().optional()
+}).strict();
+var PageSchema = OrbitalPageSchema;
 z.enum([
   "healthcare",
   "education",