@almadar/core 4.2.0 → 4.3.1

package/dist/builders.d.ts

@@ -1,5 +1,5 @@
 import { T as TraitEventContract, E as EntityField, a as EntityPersistence, b as EntityRow, O as OrbitalDefinition, c as OrbitalSchema, d as Trait, e as Entity, P as Page } from './schema-CDA_dJjH.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-DQTTCmR2.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--NQpnVOA.js';
 import 'zod';
 import '@almadar/patterns';
 
@@ -21,7 +21,7 @@ import '@almadar/patterns';
 /**
  * Ensure the fields array has an `id` field. Prepends one if missing.
  */
-declare function ensureIdField(fields: EntityField[]): EntityField[];
+declare function ensureIdField(fields?: EntityField[]): EntityField[];
 /**
  * Simple pluralization: append 's'.
  */
@@ -52,6 +52,11 @@ declare function makePage(opts: MakePageOpts): Page;
  * Build an OrbitalDefinition from its three components.
  */
 declare function makeOrbital(name: string, entity: Entity, traits: Trait[], pages: Page[]): OrbitalDefinition;
+/**
+ * Wrap one or more OrbitalDefinitions into an OrbitalSchema.
+ * Every .orb file should be a full OrbitalSchema — this is the builder for that.
+ */
+declare function makeSchema(name: string, ...definitions: OrbitalDefinition[]): OrbitalSchema;
 /**
  * Merge multiple OrbitalDefinitions into one.
  * Collects all traits from all sources into a single orbital with a shared entity.
@@ -65,15 +70,16 @@ declare function mergeOrbitals(name: string, entity: Entity, sources: OrbitalDef
  */
 declare function wire(source: Trait, target: Trait, event: TraitEventContract, triggers: string): [Trait, Trait];
 /**
- * Extract the first trait from an OrbitalDefinition.
+ * Extract the first trait from an OrbitalDefinition or OrbitalSchema.
+ * If given an OrbitalSchema, unwraps to the first orbital inside it.
  */
-declare function extractTrait(orbital: OrbitalDefinition): Trait;
+declare function extractTrait(input: OrbitalDefinition | OrbitalSchema): Trait;
 /**
  * Wire a cross-orbital event between two orbitals.
  * Adds emits to a's first trait, listens to b's first trait.
  * Pure: returns new orbitals, no mutation.
  */
-declare function connect(a: OrbitalDefinition, b: OrbitalDefinition, event: TraitEventContract, triggers?: string): [OrbitalDefinition, OrbitalDefinition];
+declare function connect(a: OrbitalDefinition | OrbitalSchema, b: OrbitalDefinition | OrbitalSchema, event: TraitEventContract, triggers?: string): [OrbitalDefinition, OrbitalDefinition];
 interface ComposeConnection {
     from: string;
     to: string;
@@ -90,11 +96,11 @@ interface ComposePage {
  * Compose multiple orbitals into a single OrbitalSchema (application).
  * Applies connections (cross-orbital event wiring) and page assignments.
  */
-declare function compose(orbitals: OrbitalDefinition[], pages: ComposePage[], connections: ComposeConnection[], appName?: string): OrbitalSchema;
+declare function compose(orbitals: (OrbitalDefinition | OrbitalSchema)[], pages: ComposePage[], connections: ComposeConnection[], appName?: string): OrbitalSchema;
 /**
  * Chain orbitals in sequence with automatic event wiring.
  * Sugar over connect + compose: wires events[0] from orbital[0] to orbital[1], etc.
  */
-declare function pipe(orbitals: OrbitalDefinition[], events: TraitEventContract[], appName?: string): OrbitalSchema;
+declare function pipe(orbitals: (OrbitalDefinition | OrbitalSchema)[], events: TraitEventContract[], appName?: string): OrbitalSchema;
 
-export { type ComposeConnection, type ComposePage, type MakeEntityOpts, type MakePageOpts, compose, connect, ensureIdField, extractTrait, makeEntity, makeOrbital, makePage, mergeOrbitals, pipe, plural, wire };
+export { type ComposeConnection, type ComposePage, type MakeEntityOpts, type MakePageOpts, compose, connect, ensureIdField, extractTrait, makeEntity, makeOrbital, makePage, makeSchema, mergeOrbitals, pipe, plural, wire };

package/dist/builders.js

@@ -903,6 +903,14 @@ function applyEventWiring(orbitals, wiring) {
 }
 
 // src/builders/compose-behaviors.ts
+function asDefinitions(inputs) {
+  return inputs.flatMap((input) => {
+    if ("orbitals" in input && Array.isArray(input.orbitals)) {
+      return input.orbitals;
+    }
+    return [input];
+  });
+}
 function toKebabCase(name) {
   return name.replace(/([a-z])([A-Z])/g, "$1-$2").replace(/[\s_]+/g, "-").toLowerCase();
 }
@@ -953,10 +961,11 @@ function getEntityName(orbital) {
 function composeBehaviors(input) {
   const {
     appName,
-    orbitals: rawOrbitals,
+    orbitals: rawInputs,
     layoutStrategy: strategyInput,
     eventWiring
   } = input;
+  const rawOrbitals = asDefinitions(rawInputs);
   const wiredOrbitals = eventWiring && eventWiring.length > 0 ? applyEventWiring(rawOrbitals, eventWiring) : rawOrbitals;
   const strategy = !strategyInput || strategyInput === "auto" ? detectLayoutStrategy(wiredOrbitals, eventWiring) : strategyInput;
   const pages = generatePages(wiredOrbitals, strategy);
@@ -989,6 +998,7 @@ function composeBehaviors(input) {
 
 // src/builders.ts
 function ensureIdField(fields) {
+  if (!fields || fields.length === 0) return [{ name: "id", type: "string", required: true }];
   if (fields.some((f) => f.name === "id")) return fields;
   return [{ name: "id", type: "string", required: true }, ...fields];
 }
@@ -1027,6 +1037,23 @@ function makePage(opts) {
 function makeOrbital(name, entity, traits, pages) {
   return { name, entity, traits, pages };
 }
+function makeSchema(name, ...definitions) {
+  return { name, version: "1.0.0", orbitals: definitions };
+}
+function asDefinitions2(inputs) {
+  return inputs.flatMap((input) => {
+    if ("orbitals" in input && Array.isArray(input.orbitals)) {
+      return input.orbitals;
+    }
+    return [input];
+  });
+}
+function asDefinition(input) {
+  if ("orbitals" in input && Array.isArray(input.orbitals)) {
+    return input.orbitals[0];
+  }
+  return input;
+}
 function mergeOrbitals(name, entity, sources, pages) {
   const allTraits = sources.flatMap(
     (s) => s.traits.map((t) => structuredClone(t))
@@ -1044,12 +1071,13 @@ function wire(source, target, event, triggers) {
   }];
   return [s, t];
 }
-function extractTrait(orbital) {
+function extractTrait(input) {
+  const orbital = asDefinition(input);
   return structuredClone(orbital.traits[0]);
 }
 function connect(a, b, event, triggers) {
-  const aClone = structuredClone(a);
-  const bClone = structuredClone(b);
+  const aClone = structuredClone(asDefinition(a));
+  const bClone = structuredClone(asDefinition(b));
   const aTrait = aClone.traits[0];
   if (aTrait) {
     const emitContract = {
@@ -1070,7 +1098,7 @@ function connect(a, b, event, triggers) {
   return [aClone, bClone];
 }
 function compose(orbitals, pages, connections, appName) {
-  const cloned = structuredClone(orbitals);
+  const cloned = structuredClone(asDefinitions2(orbitals));
   for (const conn of connections) {
     const emitter = cloned.find((o) => {
       const traits = o.traits;
@@ -1119,7 +1147,7 @@ function pipe(orbitals, events, appName) {
   if (events.length !== orbitals.length - 1) {
     throw new Error(`pipe requires exactly ${orbitals.length - 1} events for ${orbitals.length} orbitals`);
   }
-  const cloned = structuredClone(orbitals);
+  const cloned = structuredClone(asDefinitions2(orbitals));
   for (let i = 0; i < events.length; i++) {
     const aTrait = cloned[i].traits[0];
     const bTrait = cloned[i + 1].traits[0];
@@ -1156,6 +1184,6 @@ function pipe(orbitals, events, appName) {
   };
 }
 
-export { applyEventWiring, compose, composeBehaviors, connect, detectLayoutStrategy, ensureIdField, extractTrait, makeEntity, makeOrbital, makePage, mergeOrbitals, pipe, plural, wire };
+export { applyEventWiring, compose, composeBehaviors, connect, detectLayoutStrategy, ensureIdField, extractTrait, makeEntity, makeOrbital, makePage, makeSchema, mergeOrbitals, pipe, plural, wire };
 //# sourceMappingURL=builders.js.map
 //# sourceMappingURL=builders.js.map