@almadar/core 10.21.0 → 10.23.0

package/dist/{types-DBzaYmuJ.d.ts → types-DpBetrYc.d.ts}

@@ -1,4 +1,4 @@
-import { e as TraitEventListener, f as EntityField, g as EntityPersistence, j as TraitReference, k as RelationConfig } from './trait-BcRvHKLW.js';
+import { T as TraitEventListener, E as EntityField, a as EntityPersistence, b as TraitReference, R as RelationConfig } from './trait-Cs8Mrdw9.js';
 
 /**
  * Cross-cutting presentation knobs that don't live per orbital
@@ -357,6 +357,18 @@ interface FactoryPageSignature {
     defaultPath: string;
     primaryEntity: string;
 }
+/**
+ * Which coordinator surface may see this entry: `'app'` = pickable factory
+ * organism catalog, `'palette'` = free-lolo compose palette, `'both'`,
+ * `'internal'` = neither.
+ */
+type FactoryExposure = 'app' | 'palette' | 'both' | 'internal';
+/**
+ * `'generated'` = machine-emitted 1:1 wrapper (lolo-ui), `'authored'` =
+ * hand-authored (`.hand-authored.json` membership), `'promoted'` = landed
+ * through the cache-fill promotion pipeline.
+ */
+type FactoryProvenance = 'generated' | 'authored' | 'promoted';
 interface FactorySignature {
     /** Organism the factory belongs to (e.g. `"std-realtime-chat"`). */
     organism: string;
@@ -397,6 +409,33 @@ interface FactorySignature {
      * back to a loose schema + post-hoc validation.
      */
     paramsSchema?: JsonSchema;
+    /**
+     * Which coordinator surface may see this entry: `'app'` = pickable
+     * factory organism catalog, `'palette'` = free-lolo compose palette,
+     * `'both'`, `'internal'` = neither. Stamped at generation time by
+     * `tools/almadar-pattern-sync` (std-ts) from the `.lolo` `@exposure`
+     * header tag with per-topic defaults; consumers treat a missing field
+     * as "pre-V3 signature" and fall back to their legacy filters. An
+     * entry may carry `'app'`/`'both'` only if its factory is registered
+     * in the package's dispatch registry — enforced at generation time.
+     */
+    exposure?: FactoryExposure;
+    /**
+     * `'generated'` = machine-emitted 1:1 wrapper (lolo-ui), `'authored'` =
+     * hand-authored (`.hand-authored.json` membership), `'promoted'` =
+     * landed through the cache-fill promotion pipeline.
+     */
+    provenance?: FactoryProvenance;
+    /**
+     * Deterministic hash of the ui-substrate surface the behavior composes,
+     * stamped for `authored`/`promoted` (blessed) entries: sha256 (16 hex
+     * chars) over the sorted union of the registry .orb's `uses[].from`
+     * basenames and each trait `ref`'s imported trait name. A substrate
+     * change (what the entry composes) flips it — drift against the current
+     * substrate flags the entry for review. Stamped by pattern-sync std-ts
+     * (`computeSubstrateSignature`); recomputed every generation run.
+     */
+    substrateSignature?: string;
 }
 /**
  * Aggregate catalog written to
@@ -460,4 +499,4 @@ type FactoryParamValue = string | number | boolean | ReadonlyArray<FactoryParamV
     readonly [key: string]: FactoryParamValue;
 };
 
-export { type FactoryCallSite as F, type JsonValue as J, type OwnershipOverlayEntry as O, type PresentationNavItem as P, type RuleOverlay as R, type SchemaFieldType as S, type ToolArgs as T, type FactoryCallSiteParams as a, type FactoryConfigParam as b, type FactoryConfigTier as c, type FactoryEntitySignature as d, type FactoryEventSignature as e, type FactoryPageSignature as f, type FactoryParamValue as g, type FactorySignature as h, type FactorySignatureCatalog as i, type FactorySignatureEntityField as j, type FactoryTraitSignature as k, type JsonObject as l, type JsonSchema as m, type JsonSchemaType as n, type PresentationOverlay as o, type RuleOverlayEntry as p, type TraitOverlay as q, type TraitOverlayEntry as r, type TraitOverlayListener as s, isJsonArray as t, isJsonObject as u, isJsonPrimitive as v };
+export { type FactoryCallSite as F, type JsonValue as J, type OwnershipOverlayEntry as O, type PresentationNavItem as P, type RuleOverlay as R, type SchemaFieldType as S, type ToolArgs as T, type FactoryCallSiteParams as a, type FactoryConfigParam as b, type FactoryConfigTier as c, type FactoryEntitySignature as d, type FactoryEventSignature as e, type FactoryExposure as f, type FactoryPageSignature as g, type FactoryParamValue as h, type FactoryProvenance as i, type FactorySignature as j, type FactorySignatureCatalog as k, type FactorySignatureEntityField as l, type FactoryTraitSignature as m, type JsonObject as n, type JsonSchema as o, type JsonSchemaType as p, type PresentationOverlay as q, type RuleOverlayEntry as r, type TraitOverlay as s, type TraitOverlayEntry as t, type TraitOverlayListener as u, isJsonArray as v, isJsonObject as w, isJsonPrimitive as x };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/core",
-  "version": "10.21.0",
+  "version": "10.23.0",
   "description": "Core schema types and definitions for Almadar",
   "type": "module",
   "main": "./dist/index.js",

package/dist/compose-behaviors-mP-vUG61.d.ts

@@ -1,119 +0,0 @@
-import { a as OrbitalDefinition, O as OrbitalSchema } from './schema-BEL2Gr4v.js';
-
-/**
- * Event Wiring
- *
- * Applies cross-orbital event wiring to orbital definitions.
- * Adds emits/listens declarations to traits so they can communicate
- * across orbital boundaries.
- *
- * @packageDocumentation
- */
-
-/**
- * A single event wiring entry connecting two traits across orbitals.
- */
-interface EventWiringEntry {
-    /** Source trait name or orbital name */
-    from: string;
-    /** Event name (UPPER_SNAKE_CASE) */
-    event: string;
-    /** Target trait name or orbital name */
-    to: string;
-    /** Event to trigger on the listener side */
-    triggers: string;
-}
-/**
- * Apply event wiring to orbital definitions.
- *
- * For each wiring entry:
- * 1. Find the source trait and add an external emit (if not already present)
- * 2. Find the target trait and add an external listen (if not already present)
- *
- * Returns a new array of orbitals with wiring applied (deep-cloned).
- */
-declare function applyEventWiring(orbitals: OrbitalDefinition[], wiring: EventWiringEntry[]): OrbitalDefinition[];
-
-/**
- * Layout Strategy Detection
- *
- * Auto-detects the best layout strategy for a composed application
- * based on the number of orbitals and their event wiring topology.
- *
- * @packageDocumentation
- */
-
-/**
- * Layout strategy for the composed application.
- *
- * - 'single': One orbital, one page
- * - 'tabs': 2-4 orbitals with no sequential chain
- * - 'sidebar': 5+ orbitals (navigation-heavy)
- * - 'dashboard': Single page with all orbitals visible
- * - 'wizard-flow': Sequential event chain detected (A -> B -> C)
- */
-type LayoutStrategy = 'sidebar' | 'tabs' | 'dashboard' | 'wizard-flow' | 'single';
-/**
- * Detect the best layout strategy based on orbital count and event wiring.
- *
- * Heuristic:
- * 1. Sequential event chain detected -> 'wizard-flow'
- * 2. 1 orbital -> 'single'
- * 3. 2-4 orbitals -> 'tabs'
- * 4. 5+ orbitals -> 'sidebar'
- */
-declare function detectLayoutStrategy(orbitals: OrbitalDefinition[], eventWiring?: EventWiringEntry[]): LayoutStrategy;
-
-/**
- * Compose Behaviors
- *
- * Main entry point for composing multiple orbital definitions into
- * a single OrbitalSchema application. Handles event wiring, layout
- * strategy detection, and page generation.
- *
- * @packageDocumentation
- */
-
-/**
- * Input for composing behaviors into an application.
- */
-interface ComposeBehaviorsInput {
-    /** Application name */
-    appName: string;
-    /** Orbital definitions (or schemas) to compose */
-    orbitals: (OrbitalDefinition | OrbitalSchema)[];
-    /** Layout strategy override, or 'auto' to detect */
-    layoutStrategy?: LayoutStrategy | 'auto';
-    /** Cross-orbital event wiring */
-    eventWiring?: EventWiringEntry[];
-    /** Optional entity name mappings (original -> renamed) */
-    entityMappings?: Record<string, string>;
-}
-/**
- * Result of composing behaviors.
- */
-interface ComposeBehaviorsResult {
-    /** The composed OrbitalSchema */
-    schema: OrbitalSchema;
-    /** Layout metadata */
-    layout: {
-        strategy: LayoutStrategy;
-        pageCount: number;
-    };
-    /** Wiring metadata */
-    wiring: {
-        connections: number;
-    };
-}
-/**
- * Compose multiple orbital definitions into a single application schema.
- *
- * Steps:
- * 1. Apply event wiring (adds emits/listens to traits)
- * 2. Detect or use provided layout strategy
- * 3. Generate pages based on the strategy
- * 4. Build the final OrbitalSchema
- */
-declare function composeBehaviors(input: ComposeBehaviorsInput): ComposeBehaviorsResult;
-
-export { type ComposeBehaviorsInput as C, type EventWiringEntry as E, type LayoutStrategy as L, type ComposeBehaviorsResult as a, applyEventWiring as b, composeBehaviors as c, detectLayoutStrategy as d };