@almadar/core 10.11.0 → 10.13.0

package/dist/{compose-behaviors-D9bQEgqN.d.ts → compose-behaviors-CmTHzC3Z.d.ts}

@@ -1,4 +1,4 @@
-import { a as OrbitalDefinition, O as OrbitalSchema } from './schema-CtOoanon.js';
+import { a as OrbitalDefinition, O as OrbitalSchema } from './schema-DisJeRQc.js';
 
 /**
  * Event Wiring

package/dist/factory/index.d.ts

@@ -1,6 +1,6 @@
-import { g as FactoryParamValue, c as FactoryConfigTier, b as FactoryConfigParam, F as FactoryCallSite, h as FactorySignature, R as RuleOverlay, p as RuleOverlayEntry, o as PresentationOverlay, q as TraitOverlay } from '../types-COc0mLs1.js';
-export { a as FactoryCallSiteParams, d as FactoryEntitySignature, e as FactoryEventSignature, f as FactoryPageSignature, i as FactorySignatureCatalog, j as FactorySignatureEntityField, k as FactoryTraitSignature, m as JsonSchema, n as JsonSchemaType, J as JsonValue, O as OwnershipOverlayEntry, P as PresentationNavItem, S as SchemaFieldType, r as TraitOverlayEntry, s as TraitOverlayListener } from '../types-COc0mLs1.js';
-import { g as EntityPersistence, f as EntityField, j as TraitReference } from '../trait-BB1dc5A_.js';
+import { g as FactoryParamValue, c as FactoryConfigTier, b as FactoryConfigParam, F as FactoryCallSite, h as FactorySignature, R as RuleOverlay, p as RuleOverlayEntry, o as PresentationOverlay, q as TraitOverlay } from '../types-CIi6Vxmc.js';
+export { a as FactoryCallSiteParams, d as FactoryEntitySignature, e as FactoryEventSignature, f as FactoryPageSignature, i as FactorySignatureCatalog, j as FactorySignatureEntityField, k as FactoryTraitSignature, m as JsonSchema, n as JsonSchemaType, J as JsonValue, O as OwnershipOverlayEntry, P as PresentationNavItem, S as SchemaFieldType, r as TraitOverlayEntry, s as TraitOverlayListener } from '../types-CIi6Vxmc.js';
+import { g as EntityPersistence, f as EntityField, j as TraitReference } from '../trait-Bwhkhv3V.js';
 import 'zod';
 import '../expression-BUIi9ezJ.js';
 import '@almadar/patterns';

package/dist/factory-runtime/index.d.ts

@@ -1,10 +1,10 @@
-import { O as OrbitalSchema, a as OrbitalDefinition } from '../schema-CtOoanon.js';
-import { f as EntityField, g as EntityPersistence, C as CallSiteConfig, Y as CallSiteConfigEntry, a as Trait } from '../trait-BB1dc5A_.js';
+import { O as OrbitalSchema, a as OrbitalDefinition } from '../schema-DisJeRQc.js';
+import { f as EntityField, g as EntityPersistence, C as CallSiteConfig, $ as CallSiteConfigEntry, a as Trait } from '../trait-Bwhkhv3V.js';
 import { MakeTraitRefOpts } from '../builders.js';
 import '../expression-BUIi9ezJ.js';
 import 'zod';
 import '@almadar/patterns';
-import '../compose-behaviors-D9bQEgqN.js';
+import '../compose-behaviors-CmTHzC3Z.js';
 
 /**
  * Orbital factory manifest types — shared across all packages.

package/dist/factory-runtime/index.js

@@ -1,67 +1,7 @@
 import { z } from 'zod';
 import '@almadar/patterns';
 
-// src/factory-runtime/extract-manifest.ts
-var STATIC_PARAM_FIELDS = [
-  {
-    name: "fields",
-    type: "EntityField[]",
-    description: "Extra fields appended to the canonical entity."
-  },
-  {
-    name: "pagePath",
-    type: "string",
-    description: "URL override for the orbital first page."
-  },
-  {
-    name: "persistence",
-    type: "'persistent' | 'runtime' | 'singleton' | 'instance' | 'local'",
-    description: "Override the canonical entity persistence mode."
-  },
-  {
-    name: "entityName",
-    type: "string",
-    description: "Rename the canonical entity. PascalCase singular, \u226432 chars. Threads through every trait's linkedEntity binding; compiler rewrites @Entity.x refs."
-  },
-  {
-    name: "collection",
-    type: "string",
-    description: "Override derived collection key. Defaults to plural(entityName).toLowerCase()."
-  },
-  {
-    name: "traitOverrides",
-    type: "Partial<Record<TraitName, { config?, linkedEntity?, events?, name?, emitsScope?, listens? }>>",
-    description: ".lolo's native trait-composition surface 1:1: per-imported-trait config, linkedEntity, events, name, emitsScope, listens. effects is excluded (atom-owned; use listens via a sibling trait)."
-  }
-];
-function splitTraits(traits) {
-  const refTraitNames = [];
-  const inlineTraitNames = [];
-  for (const t of traits) {
-    if (!t || typeof t !== "object") continue;
-    const tName = typeof t.name === "string" ? t.name : null;
-    if (!tName) continue;
-    if (typeof t.ref === "string") {
-      refTraitNames.push(tName);
-    } else {
-      inlineTraitNames.push(tName);
-    }
-  }
-  return { refTraitNames, inlineTraitNames };
-}
-function extractManifest(orb) {
-  const behaviorName = orb.name;
-  return orb.orbitals.map((orbital) => {
-    const { refTraitNames, inlineTraitNames } = splitTraits(orbital.traits);
-    return {
-      organism: behaviorName,
-      orbitalName: orbital.name,
-      paramFields: STATIC_PARAM_FIELDS,
-      traitNames: refTraitNames,
-      inlineTraitNames
-    };
-  });
-}
+// src/types/orbital.ts
 z.enum([
   "string",
   "number",
@@ -224,11 +164,27 @@ var GAME_TYPES = [
   "rpg"
 ];
 var GameTypeSchema = z.enum(GAME_TYPES);
+var ANIMATION_NAMES = ["idle", "walk", "attack", "hit", "death"];
+var AnimationNameSchema = z.enum(ANIMATION_NAMES);
+var SPRITE_DIRECTIONS = ["se", "sw"];
+var SpriteDirectionSchema = z.enum(SPRITE_DIRECTIONS);
 var AnimationDefSchema = z.object({
-  frames: z.union([z.array(z.number()), z.array(z.string())]),
-  fps: z.number().positive(),
+  row: z.number().int().nonnegative(),
+  frames: z.number().int().positive(),
+  frameRate: z.number().positive(),
   loop: z.boolean()
 });
+z.object({
+  unit: z.string().optional(),
+  type: z.string().optional(),
+  frameWidth: z.number().positive(),
+  frameHeight: z.number().positive(),
+  columns: z.number().int().positive(),
+  rows: z.number().int().positive(),
+  directions: z.array(SpriteDirectionSchema),
+  sheets: z.record(SpriteDirectionSchema, z.string()),
+  animations: z.record(AnimationNameSchema, AnimationDefSchema)
+});
 var SemanticAssetRefSchema = z.object({
   role: EntityRoleSchema,
   category: z.string().min(1),
@@ -296,6 +252,9 @@ var OrbitalEntitySchema = z.object({
   assetRef: SemanticAssetRefSchema.optional()
 });
 var EntitySchema = OrbitalEntitySchema;
+function persistenceModeAllowsOverrides(persistence) {
+  return persistence === "persistent" || persistence === void 0;
+}
 var UI_SLOTS = [
   // App slots
   "main",
@@ -1311,6 +1270,80 @@ z.object({
 });
 z.string();
 
+// src/factory-runtime/extract-manifest.ts
+var STATIC_PARAM_FIELDS = [
+  {
+    name: "fields",
+    type: "EntityField[]",
+    description: "Extra fields appended to the canonical entity."
+  },
+  {
+    name: "pagePath",
+    type: "string",
+    description: "URL override for the orbital first page."
+  },
+  {
+    name: "persistence",
+    type: "'persistent' | 'runtime' | 'singleton' | 'instance' | 'local'",
+    description: "Override the canonical entity persistence mode."
+  },
+  {
+    name: "entityName",
+    type: "string",
+    description: "Rename the canonical entity. PascalCase singular, \u226432 chars. Threads through every trait's linkedEntity binding; compiler rewrites @Entity.x refs."
+  },
+  {
+    name: "collection",
+    type: "string",
+    description: "Override derived collection key. Defaults to plural(entityName).toLowerCase()."
+  },
+  {
+    name: "traitOverrides",
+    type: "Partial<Record<TraitName, { config?, linkedEntity?, events?, name?, emitsScope?, listens? }>>",
+    description: ".lolo's native trait-composition surface 1:1: per-imported-trait config, linkedEntity, events, name, emitsScope, listens. effects is excluded (atom-owned; use listens via a sibling trait)."
+  }
+];
+function entityPersistence(entity) {
+  if (entity && typeof entity === "object" && !("extends" in entity)) {
+    return entity.persistence;
+  }
+  return void 0;
+}
+function paramFieldsForPersistence(persistence) {
+  if (persistenceModeAllowsOverrides(persistence)) {
+    return STATIC_PARAM_FIELDS;
+  }
+  return STATIC_PARAM_FIELDS.filter((f) => f.name !== "persistence" && f.name !== "collection");
+}
+function splitTraits(traits) {
+  const refTraitNames = [];
+  const inlineTraitNames = [];
+  for (const t of traits) {
+    if (!t || typeof t !== "object") continue;
+    const tName = typeof t.name === "string" ? t.name : null;
+    if (!tName) continue;
+    if (typeof t.ref === "string") {
+      refTraitNames.push(tName);
+    } else {
+      inlineTraitNames.push(tName);
+    }
+  }
+  return { refTraitNames, inlineTraitNames };
+}
+function extractManifest(orb) {
+  const behaviorName = orb.name;
+  return orb.orbitals.map((orbital) => {
+    const { refTraitNames, inlineTraitNames } = splitTraits(orbital.traits);
+    return {
+      organism: behaviorName,
+      orbitalName: orbital.name,
+      paramFields: paramFieldsForPersistence(entityPersistence(orbital.entity)),
+      traitNames: refTraitNames,
+      inlineTraitNames
+    };
+  });
+}
+
 // src/builders.ts
 function makeTraitRef(opts) {
   const ref2 = { ref: opts.ref };
@@ -1352,14 +1385,7 @@ function validateOrbitalFactoryParams(manifest, raw) {
       error: { kind: "not-object", received: Array.isArray(raw) ? "array" : "null" }
     };
   }
-  const ALLOWED_KEYS = /* @__PURE__ */ new Set([
-    "fields",
-    "pagePath",
-    "persistence",
-    "entityName",
-    "collection",
-    "traitOverrides"
-  ]);
+  const ALLOWED_KEYS = new Set(manifest.paramFields.map((f) => f.name));
   for (const key of Object.keys(raw)) {
     if (!ALLOWED_KEYS.has(key)) {
       return { ok: false, error: { kind: "unknown-key", key } };
@@ -1450,12 +1476,15 @@ function buildEntity(ctx, effectiveName, effectiveCollection, params) {
       ...extras
     ];
   }
+  const allowPersistenceOverride = persistenceModeAllowsOverrides(
+    ctx.canonicalEntity.persistence
+  );
   const entity = {
     name: effectiveName,
-    persistence: params.persistence ?? ctx.canonicalEntity.persistence,
+    persistence: allowPersistenceOverride ? params.persistence ?? ctx.canonicalEntity.persistence : ctx.canonicalEntity.persistence,
     fields: [...mergedFields]
   };
-  if (effectiveCollection !== void 0) {
+  if (allowPersistenceOverride && effectiveCollection !== void 0) {
     entity.collection = effectiveCollection;
   }
   return entity;