@almadar/runtime 2.7.0 → 3.0.1

package/dist/{external-loader-FJVQACFN.js.map → external-loader-UBJ6VRW5.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/loader/external-loader.ts"],"names":[],"mappings":";;;;;AA+EO,IAAM,WAAA,GAAN,MAAM,YAAA,CAAY;AAAA,EACf,QAAkB,EAAC;AAAA;AAAA;AAAA;AAAA;AAAA,EAM3B,KAAK,YAAA,EAAqC;AACxC,IAAA,IAAI,IAAA,CAAK,KAAA,CAAM,QAAA,CAAS,YAAY,CAAA,EAAG;AACrC,MAAA,MAAM,KAAA,GAAQ,CAAC,GAAG,IAAA,CAAK,KAAA,CAAM,KAAA,CAAM,IAAA,CAAK,KAAA,CAAM,OAAA,CAAQ,YAAY,CAAC,CAAA,EAAG,YAAY,CAAA;AAClF,MAAA,OAAO,CAAA,0BAAA,EAA6B,KAAA,CAAM,IAAA,CAAK,MAAM,CAAC,CAAA,CAAA;AAAA,IACxD;AACA,IAAA,IAAA,CAAK,KAAA,CAAM,KAAK,YAAY,CAAA;AAC5B,IAAA,OAAO,IAAA;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKA,GAAA,GAAY;AACV,IAAA,IAAA,CAAK,MAAM,GAAA,EAAI;AAAA,EACjB;AAAA;AAAA;AAAA;AAAA,EAKA,KAAA,GAAqB;AACnB,IAAA,MAAM,QAAA,GAAW,IAAI,YAAA,EAAY;AACjC,IAAA,QAAA,CAAS,KAAA,GAAQ,CAAC,GAAG,IAAA,CAAK,KAAK,CAAA;AAC/B,IAAA,OAAO,QAAA;AAAA,EACT;AACF;AASO,IAAM,cAAN,MAAkB;AAAA,EACf,KAAA,uBAAY,GAAA,EAA0B;AAAA,EAE9C,IAAI,YAAA,EAAgD;AAClD,IAAA,OAAO,IAAA,CAAK,KAAA,CAAM,GAAA,CAAI,YAAY,CAAA;AAAA,EACpC;AAAA,EAEA,GAAA,CAAI,cAAsB,MAAA,EAA4B;AACpD,IAAA,IAAA,CAAK,KAAA,CAAM,GAAA,CAAI,YAAA,EAAc,MAAM,CAAA;AAAA,EACrC;AAAA,EAEA,IAAI,YAAA,EAA+B;AACjC,IAAA,OAAO,IAAA,CAAK,KAAA,CAAM,GAAA,CAAI,YAAY,CAAA;AAAA,EACpC;AAAA,EAEA,KAAA,GAAc;AACZ,IAAA,IAAA,CAAK,MAAM,KAAA,EAAM;AAAA,EACnB;AAAA,EAEA,IAAI,IAAA,GAAe;AACjB,IAAA,OAAO,KAAK,KAAA,CAAM,IAAA;AAAA,EACpB;AACF;AA6BO,IAAM,wBAAN,MAA4B;AAAA,EACzB,OAAA;AAAA,EACA,KAAA;AAAA,EAER,YAAY,OAAA,EAAwB;AAClC,IAAA,IAAA,CAAK,OAAA,GAAU;AAAA,MACb,UAAA,EAAY,QAAQ,UAAA,IAAc,EAAA;AAAA,MAClC,WAAA,EAAa,OAAA,CAAQ,WAAA,IAAe,EAAC;AAAA,MACrC,oBAAA,EAAsB,QAAQ,oBAAA,IAAwB,KAAA;AAAA,MACtD,GAAG;AAAA,KACL;AACA,IAAA,IAAA,CAAK,KAAA,GAAQ,IAAI,WAAA,EAAY;AAAA,EAC/B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAM,IAAA,CACJ,UAAA,EACA,QAAA,EACA,KAAA,EACmC;AACnC,IAAA,MAAM,WAAA,GAAc,KAAA,IAAS,IAAI,WAAA,EAAY;AAG7C,IAAA,MAAM,aAAA,GAAgB,IAAA,CAAK,WAAA,CAAY,UAAA,EAAY,QAAQ,CAAA;AAC3D,IAAA,IAAI,CAAC,cAAc,OAAA,EAAS;AAC1B,MAAA,OAAO,aAAA;AAAA,IACT;AACA,IAAA,MAAM,eAAe,aAAA,CAAc,IAAA;AAGnC,IAAA,MAAM,aAAA,GAAgB,WAAA,CAAY,IAAA,CAAK,YAAY,CAAA;AACnD,IAAA,IAAI,aAAA,EAAe;AACjB,MAAA,OAAO,EAAE,OAAA,EAAS,KAAA,EAAO,KAAA,EAAO,aAAA,EAAc;AAAA,IAChD;AAEA,IAAA,IAAI;AAEF,MAAA,MAAM,MAAA,GAAS,IAAA,CAAK,KAAA,CAAM,GAAA,CAAI,YAAY,CAAA;AAC1C,MAAA,IAAI,MAAA,EAAQ;AACV,QAAA,OAAO,EAAE,OAAA,EAAS,IAAA,EAAM,IAAA,EAAM,MAAA,EAAO;AAAA,MACvC;AAGA,MAAA,MAAM,UAAA,GAAa,MAAM,IAAA,CAAK,QAAA,CAAS,YAAY,CAAA;AACnD,MAAA,IAAI,CAAC,WAAW,OAAA,EAAS;AACvB,QAAA,OAAO,UAAA;AAAA,MACT;AAEA,MAAA,MAAM,MAAA,GAAuB;AAAA,QAC3B,QAAQ,UAAA,CAAW,IAAA;AAAA,QACnB,UAAA,EAAY,YAAA;AAAA,QACZ;AAAA,OACF;AAGA,MAAA,IAAA,CAAK,KAAA,CAAM,GAAA,CAAI,YAAA,EAAc,MAAM,CAAA;AAEnC,MAAA,OAAO,EAAE,OAAA,EAAS,IAAA,EAAM,IAAA,EAAM,MAAA,EAAO;AAAA,IACvC,CAAA,SAAE;AACA,MAAA,WAAA,CAAY,GAAA,EAAI;AAAA,IAClB;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,MAAM,WAAA,CACJ,UAAA,EACA,WAAA,EACA,UACA,KAAA,EACoC;AACpC,IAAA,MAAM,eAAe,MAAM,IAAA,CAAK,IAAA,CAAK,UAAA,EAAY,UAAU,KAAK,CAAA;AAChE,IAAA,IAAI,CAAC,aAAa,OAAA,EAAS;AACzB,MAAA,OAAO,YAAA;AAAA,IACT;AAEA,IAAA,MAAM,MAAA,GAAS,aAAa,IAAA,CAAK,MAAA;AACjC,IAAA,IAAI,OAAA;AAEJ,IAAA,IAAI,WAAA,EAAa;AACf,MAAA,MAAM,KAAA,GAAQ,OAAO,QAAA,CAAS,IAAA,CAAK,CAAC,CAAA,KAAe,CAAA,CAAE,SAAS,WAAW,CAAA;AACzE,MAAA,IAAI,CAAC,KAAA,EAAO;AACV,QAAA,OAAO;AAAA,UACL,OAAA,EAAS,KAAA;AAAA,UACT,OAAO,CAAA,SAAA,EAAY,WAAW,CAAA,eAAA,EAAkB,UAAU,gBAAgB,MAAA,CAAO,QAAA,CAAS,GAAA,CAAI,CAAC,MAAe,CAAA,CAAE,IAAI,CAAA,CAAE,IAAA,CAAK,IAAI,CAAC,CAAA;AAAA,SAClI;AAAA,MACF;AACA,MAAA,OAAA,GAAU,KAAA;AAAA,IACZ,CAAA,MAAO;AAEL,MAAA,IAAI,MAAA,CAAO,QAAA,CAAS,MAAA,KAAW,CAAA,EAAG;AAChC,QAAA,OAAO;AAAA,UACL,OAAA,EAAS,KAAA;AAAA,UACT,KAAA,EAAO,wBAAwB,UAAU,CAAA;AAAA,SAC3C;AAAA,MACF;AACA,MAAA,OAAA,GAAU,MAAA,CAAO,SAAS,CAAC,CAAA;AAAA,IAC7B;AAEA,IAAA,OAAO;AAAA,MACL,OAAA,EAAS,IAAA;AAAA,MACT,IAAA,EAAM;AAAA,QACJ,OAAA;AAAA,QACA,UAAA,EAAY,aAAa,IAAA,CAAK,UAAA;AAAA,QAC9B;AAAA;AACF,KACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,WAAA,CAAY,YAAoB,QAAA,EAAuC;AAErE,IAAA,IAAI,UAAA,CAAW,UAAA,CAAW,MAAM,CAAA,EAAG;AACjC,MAAA,OAAO,IAAA,CAAK,eAAe,UAAU,CAAA;AAAA,IACvC;AAGA,IAAA,IAAI,UAAA,CAAW,UAAA,CAAW,GAAG,CAAA,EAAG;AAC9B,MAAA,OAAO,IAAA,CAAK,kBAAkB,UAAU,CAAA;AAAA,IAC1C;AAGA,IAAA,IAAI,WAAW,UAAA,CAAW,IAAI,KAAK,UAAA,CAAW,UAAA,CAAW,KAAK,CAAA,EAAG;AAC/D,MAAA,OAAO,IAAA,CAAK,mBAAA,CAAoB,UAAA,EAAY,QAAQ,CAAA;AAAA,IACtD;AAGA,IAAA,IAAS,IAAA,CAAA,UAAA,CAAW,UAAU,CAAA,EAAG;AAC/B,MAAA,IAAI,CAAC,IAAA,CAAK,OAAA,CAAQ,oBAAA,EAAsB;AACtC,QAAA,OAAO;AAAA,UACL,OAAA,EAAS,KAAA;AAAA,UACT,KAAA,EAAO,+BAA+B,UAAU,CAAA;AAAA,SAClD;AAAA,MACF;AACA,MAAA,OAAO,EAAE,OAAA,EAAS,IAAA,EAAM,IAAA,EAAM,UAAA,EAAW;AAAA,IAC3C;AAGA,IAAA,OAAO,IAAA,CAAK,mBAAA,CAAoB,CAAA,EAAA,EAAK,UAAU,IAAI,QAAQ,CAAA;AAAA,EAC7D;AAAA;AAAA;AAAA;AAAA,EAKQ,eAAe,UAAA,EAAwC;AAC7D,IAAA,IAAI,CAAC,IAAA,CAAK,OAAA,CAAQ,UAAA,EAAY;AAC5B,MAAA,OAAO;AAAA,QACL,OAAA,EAAS,KAAA;AAAA,QACT,KAAA,EAAO,sDAAsD,UAAU,CAAA;AAAA,OACzE;AAAA,IACF;AAGA,IAAA,MAAM,YAAA,GAAe,UAAA,CAAW,KAAA,CAAM,CAAC,CAAA;AACvC,IAAA,IAAI,YAAA,GAAoB,IAAA,CAAA,IAAA,CAAK,IAAA,CAAK,OAAA,CAAQ,YAAY,YAAY,CAAA;AAGlE,IAAA,IAAI,CAAC,YAAA,CAAa,QAAA,CAAS,MAAM,CAAA,EAAG;AAClC,MAAA,YAAA,IAAgB,MAAA;AAAA,IAClB;AAGA,IAAA,MAAM,cAAA,GAAsB,eAAU,YAAY,CAAA;AAClD,IAAA,MAAM,gBAAA,GAAwB,IAAA,CAAA,SAAA,CAAU,IAAA,CAAK,OAAA,CAAQ,UAAU,CAAA;AAC/D,IAAA,IAAI,CAAC,cAAA,CAAe,UAAA,CAAW,gBAAgB,CAAA,EAAG;AAChD,MAAA,OAAO;AAAA,QACL,OAAA,EAAS,KAAA;AAAA,QACT,KAAA,EAAO,uCAAuC,UAAU,CAAA;AAAA,OAC1D;AAAA,IACF;AAEA,IAAA,OAAO,EAAE,OAAA,EAAS,IAAA,EAAM,IAAA,EAAM,YAAA,EAAa;AAAA,EAC7C;AAAA;AAAA;AAAA;AAAA,EAKQ,kBAAkB,UAAA,EAAwC;AAEhE,IAAA,MAAM,KAAA,GAAQ,UAAA,CAAW,KAAA,CAAM,WAAW,CAAA;AAC1C,IAAA,IAAI,CAAC,KAAA,EAAO;AACV,MAAA,OAAO;AAAA,QACL,OAAA,EAAS,KAAA;AAAA,QACT,KAAA,EAAO,gCAAgC,UAAU,CAAA;AAAA,OACnD;AAAA,IACF;AAEA,IAAA,MAAM,KAAA,GAAQ,MAAM,CAAC,CAAA;AACrB,IAAA,MAAM,SAAA,GAAY,IAAA,CAAK,OAAA,CAAQ,WAAA,CAAY,KAAK,CAAA;AAChD,IAAA,IAAI,CAAC,SAAA,EAAW;AACd,MAAA,OAAO;AAAA,QACL,OAAA,EAAS,KAAA;AAAA,QACT,KAAA,EAAO,CAAA,gBAAA,EAAmB,KAAK,CAAA,6BAAA,EAAgC,MAAA,CAAO,IAAA,CAAK,IAAA,CAAK,OAAA,CAAQ,WAAW,CAAA,CAAE,IAAA,CAAK,IAAI,KAAK,MAAM,CAAA;AAAA,OAC3H;AAAA,IACF;AAGA,IAAA,MAAM,YAAA,GAAe,UAAA,CAAW,KAAA,CAAM,KAAA,CAAM,SAAS,CAAC,CAAA;AACtD,IAAA,IAAI,YAAA,GAAoB,IAAA,CAAA,IAAA,CAAK,SAAA,EAAW,YAAY,CAAA;AAGpD,IAAA,IAAI,CAAC,YAAA,CAAa,QAAA,CAAS,MAAM,CAAA,EAAG;AAClC,MAAA,YAAA,IAAgB,MAAA;AAAA,IAClB;AAGA,IAAA,MAAM,cAAA,GAAsB,eAAU,YAAY,CAAA;AAClD,IAAA,MAAM,cAAA,GAAsB,eAAU,SAAS,CAAA;AAC/C,IAAA,IAAI,CAAC,cAAA,CAAe,UAAA,CAAW,cAAc,CAAA,EAAG;AAC9C,MAAA,OAAO;AAAA,QACL,OAAA,EAAS,KAAA;AAAA,QACT,KAAA,EAAO,0CAA0C,UAAU,CAAA;AAAA,OAC7D;AAAA,IACF;AAEA,IAAA,OAAO,EAAE,OAAA,EAAS,IAAA,EAAM,IAAA,EAAM,YAAA,EAAa;AAAA,EAC7C;AAAA;AAAA;AAAA;AAAA,EAKQ,mBAAA,CACN,YACA,QAAA,EACoB;AACpB,IAAA,MAAM,UAAU,QAAA,GACP,IAAA,CAAA,OAAA,CAAQ,QAAQ,CAAA,GACrB,KAAK,OAAA,CAAQ,QAAA;AAEjB,IAAA,IAAI,YAAA,GAAoB,IAAA,CAAA,OAAA,CAAQ,OAAA,EAAS,UAAU,CAAA;AAGnD,IAAA,IAAI,CAAC,YAAA,CAAa,QAAA,CAAS,MAAM,CAAA,EAAG;AAClC,MAAA,YAAA,IAAgB,MAAA;AAAA,IAClB;AAGA,IAAA,IAAI,CAAC,IAAA,CAAK,OAAA,CAAQ,oBAAA,EAAsB;AACtC,MAAA,MAAM,cAAA,GAAsB,eAAU,YAAY,CAAA;AAClD,MAAA,MAAM,cAAA,GAAsB,IAAA,CAAA,SAAA,CAAU,IAAA,CAAK,OAAA,CAAQ,QAAQ,CAAA;AAC3D,MAAA,IAAI,CAAC,cAAA,CAAe,UAAA,CAAW,cAAc,CAAA,EAAG;AAC9C,QAAA,OAAO;AAAA,UACL,OAAA,EAAS,KAAA;AAAA,UACT,OAAO,CAAA,kCAAA,EAAqC,UAAU,CAAA,QAAA,EAAW,IAAA,CAAK,QAAQ,QAAQ,CAAA;AAAA,SACxF;AAAA,MACF;AAAA,IACF;AAEA,IAAA,OAAO,EAAE,OAAA,EAAS,IAAA,EAAM,IAAA,EAAM,YAAA,EAAa;AAAA,EAC7C;AAAA;AAAA;AAAA;AAAA,EAKA,MAAc,SAAS,YAAA,EAA0D;AAC/E,IAAA,IAAI;AAEF,MAAA,IAAI,CAAI,EAAA,CAAA,UAAA,CAAW,YAAY,CAAA,EAAG;AAChC,QAAA,OAAO;AAAA,UACL,OAAA,EAAS,KAAA;AAAA,UACT,KAAA,EAAO,mBAAmB,YAAY,CAAA;AAAA,SACxC;AAAA,MACF;AAGA,MAAA,MAAM,OAAA,GAAU,MAAS,EAAA,CAAA,QAAA,CAAS,QAAA,CAAS,cAAc,OAAO,CAAA;AAGhE,MAAA,IAAI,IAAA;AACJ,MAAA,IAAI;AACF,QAAA,IAAA,GAAO,IAAA,CAAK,MAAM,OAAO,CAAA;AAAA,MAC3B,SAAS,CAAA,EAAG;AACV,QAAA,OAAO;AAAA,UACL,OAAA,EAAS,KAAA;AAAA,UACT,KAAA,EAAO,CAAA,gBAAA,EAAmB,YAAY,CAAA,EAAA,EAAK,CAAA,YAAa,QAAQ,CAAA,CAAE,OAAA,GAAU,MAAA,CAAO,CAAC,CAAC,CAAA;AAAA,SACvF;AAAA,MACF;AAGA,MAAA,MAAM,WAAA,GAAc,mBAAA,CAAoB,SAAA,CAAU,IAAI,CAAA;AACtD,MAAA,IAAI,CAAC,YAAY,OAAA,EAAS;AACxB,QAAA,MAAM,SAAS,WAAA,CAAY,KAAA,CAAM,OAC9B,GAAA,CAAI,CAAC,MAAM,CAAA,IAAA,EAAO,CAAA,CAAE,KAAK,IAAA,CAAK,GAAG,CAAC,CAAA,EAAA,EAAK,CAAA,CAAE,OAAO,CAAA,CAAE,CAAA,CAClD,KAAK,IAAI,CAAA;AACZ,QAAA,OAAO;AAAA,UACL,OAAA,EAAS,KAAA;AAAA,UACT,KAAA,EAAO,qBAAqB,YAAY,CAAA;AAAA,EAAM,MAAM,CAAA;AAAA,SACtD;AAAA,MACF;AAEA,MAAA,OAAO,EAAE,OAAA,EAAS,IAAA,EAAM,IAAA,EAAM,YAAY,IAAA,EAAsB;AAAA,IAClE,SAAS,CAAA,EAAG;AACV,MAAA,OAAO;AAAA,QACL,OAAA,EAAS,KAAA;AAAA,QACT,KAAA,EAAO,CAAA,eAAA,EAAkB,YAAY,CAAA,EAAA,EAAK,CAAA,YAAa,QAAQ,CAAA,CAAE,OAAA,GAAU,MAAA,CAAO,CAAC,CAAC,CAAA;AAAA,OACtF;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,UAAA,GAAmB;AACjB,IAAA,IAAA,CAAK,MAAM,KAAA,EAAM;AAAA,EACnB;AAAA;AAAA;AAAA;AAAA,EAKA,aAAA,GAAkC;AAChC,IAAA,OAAO,EAAE,IAAA,EAAM,IAAA,CAAK,KAAA,CAAM,IAAA,EAAK;AAAA,EACjC;AACF;AASO,SAAS,YAAA,CAAa,UAAkB,OAAA,EAAyD;AACtG,EAAA,OAAO,IAAI,qBAAA,CAAsB;AAAA,IAC/B,QAAA;AAAA,IACA,GAAG;AAAA,GACJ,CAAA;AACH;AAaO,SAAS,gBAAgB,UAAA,EAAyD;AACvF,EAAA,MAAM,SAAA,GAAY,UAAA,CAAW,OAAA,CAAQ,GAAG,CAAA;AACxC,EAAA,IAAI,cAAc,EAAA,EAAI;AACpB,IAAA,OAAO,EAAE,MAAM,UAAA,EAAW;AAAA,EAC5B;AACA,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,UAAA,CAAW,KAAA,CAAM,CAAA,EAAG,SAAS,CAAA;AAAA,IACnC,QAAA,EAAU,UAAA,CAAW,KAAA,CAAM,SAAA,GAAY,CAAC;AAAA,GAC1C;AACF","file":"external-loader-FJVQACFN.js","sourcesContent":["/**\n * External Orbital Loader\n *\n * Loads external .orb files from various sources:\n * - Local filesystem (relative paths)\n * - Standard library (std/...)\n * - Scoped packages (@name/...)\n *\n * @packageDocumentation\n */\n\nimport * as fs from \"fs\";\nimport * as path from \"path\";\nimport type { Orbital, OrbitalSchema } from \"@almadar/core\";\nimport { OrbitalSchemaSchema } from \"@almadar/core\";\n\n// ============================================================================\n// Types\n// ============================================================================\n\n/**\n * Result of loading an orbital.\n */\nexport interface LoadedOrbital {\n  /** The loaded orbital */\n  orbital: Orbital;\n\n  /** Source path (resolved absolute path) */\n  sourcePath: string;\n\n  /** Original import path */\n  importPath: string;\n}\n\n/**\n * Result of loading an orbital schema (may contain multiple orbitals).\n */\nexport interface LoadedSchema {\n  /** The loaded schema */\n  schema: OrbitalSchema;\n\n  /** Source path (resolved absolute path) */\n  sourcePath: string;\n\n  /** Original import path */\n  importPath: string;\n}\n\n/**\n * Loader options.\n */\nexport interface LoaderOptions {\n  /** Base directory for resolving relative imports */\n  basePath: string;\n\n  /** Standard library root path */\n  stdLibPath?: string;\n\n  /** Scoped package roots (e.g., { \"@game-lib\": \"/path/to/lib\" }) */\n  scopedPaths?: Record<string, string>;\n\n  /** Whether to allow paths outside basePath (security) */\n  allowOutsideBasePath?: boolean;\n}\n\n/**\n * Loader result with error handling.\n */\nexport type LoadResult<T> =\n  | { success: true; data: T }\n  | { success: false; error: string };\n\n// ============================================================================\n// Circular Import Detection\n// ============================================================================\n\n/**\n * Tracks import chains to detect circular imports.\n */\nexport class ImportChain {\n  private chain: string[] = [];\n\n  /**\n   * Try to add a path to the chain.\n   * @returns Error message if circular, null if OK\n   */\n  push(absolutePath: string): string | null {\n    if (this.chain.includes(absolutePath)) {\n      const cycle = [...this.chain.slice(this.chain.indexOf(absolutePath)), absolutePath];\n      return `Circular import detected: ${cycle.join(\" -> \")}`;\n    }\n    this.chain.push(absolutePath);\n    return null;\n  }\n\n  /**\n   * Remove the last path from the chain.\n   */\n  pop(): void {\n    this.chain.pop();\n  }\n\n  /**\n   * Clone the chain for nested loading.\n   */\n  clone(): ImportChain {\n    const newChain = new ImportChain();\n    newChain.chain = [...this.chain];\n    return newChain;\n  }\n}\n\n// ============================================================================\n// Cache\n// ============================================================================\n\n/**\n * Cache for loaded schemas to avoid re-loading.\n */\nexport class LoaderCache {\n  private cache = new Map<string, LoadedSchema>();\n\n  get(absolutePath: string): LoadedSchema | undefined {\n    return this.cache.get(absolutePath);\n  }\n\n  set(absolutePath: string, schema: LoadedSchema): void {\n    this.cache.set(absolutePath, schema);\n  }\n\n  has(absolutePath: string): boolean {\n    return this.cache.has(absolutePath);\n  }\n\n  clear(): void {\n    this.cache.clear();\n  }\n\n  get size(): number {\n    return this.cache.size;\n  }\n}\n\n// ============================================================================\n// External Orbital Loader\n// ============================================================================\n\n/**\n * ExternalOrbitalLoader - Loads external .orb files with security and caching.\n *\n * Security Model:\n * - By default, only allows loading from within basePath\n * - std library has its own allowed path\n * - Scoped packages have their own allowed paths\n * - No path traversal outside allowed directories\n *\n * @example\n * ```typescript\n * const loader = new ExternalOrbitalLoader({\n *   basePath: \"/project/schemas\",\n *   stdLibPath: \"/project/std\",\n * });\n *\n * // Load relative .orb file\n * const result = await loader.load(\"./shared/health.orb\");\n *\n * // Load from std library\n * const stdResult = await loader.load(\"std/behaviors/game-core\");\n * ```\n */\nexport class ExternalOrbitalLoader {\n  private options: Required<LoaderOptions>;\n  private cache: LoaderCache;\n\n  constructor(options: LoaderOptions) {\n    this.options = {\n      stdLibPath: options.stdLibPath ?? \"\",\n      scopedPaths: options.scopedPaths ?? {},\n      allowOutsideBasePath: options.allowOutsideBasePath ?? false,\n      ...options,\n    };\n    this.cache = new LoaderCache();\n  }\n\n  /**\n   * Load a schema from an import path.\n   *\n   * @param importPath - The import path (e.g., \"./health.orb\", \"std/behaviors/game-core\")\n   * @param fromPath - The path of the file doing the import (for relative resolution)\n   * @param chain - Import chain for circular detection\n   */\n  async load(\n    importPath: string,\n    fromPath?: string,\n    chain?: ImportChain\n  ): Promise<LoadResult<LoadedSchema>> {\n    const importChain = chain ?? new ImportChain();\n\n    // Resolve the absolute path\n    const resolveResult = this.resolvePath(importPath, fromPath);\n    if (!resolveResult.success) {\n      return resolveResult;\n    }\n    const absolutePath = resolveResult.data;\n\n    // Check for circular imports\n    const circularError = importChain.push(absolutePath);\n    if (circularError) {\n      return { success: false, error: circularError };\n    }\n\n    try {\n      // Check cache\n      const cached = this.cache.get(absolutePath);\n      if (cached) {\n        return { success: true, data: cached };\n      }\n\n      // Load and parse the file\n      const loadResult = await this.loadFile(absolutePath);\n      if (!loadResult.success) {\n        return loadResult;\n      }\n\n      const loaded: LoadedSchema = {\n        schema: loadResult.data,\n        sourcePath: absolutePath,\n        importPath,\n      };\n\n      // Cache the result\n      this.cache.set(absolutePath, loaded);\n\n      return { success: true, data: loaded };\n    } finally {\n      importChain.pop();\n    }\n  }\n\n  /**\n   * Load a specific orbital from a schema by name.\n   *\n   * @param importPath - The import path\n   * @param orbitalName - The orbital name (optional, defaults to first orbital)\n   * @param fromPath - The path of the file doing the import\n   * @param chain - Import chain for circular detection\n   */\n  async loadOrbital(\n    importPath: string,\n    orbitalName?: string,\n    fromPath?: string,\n    chain?: ImportChain\n  ): Promise<LoadResult<LoadedOrbital>> {\n    const schemaResult = await this.load(importPath, fromPath, chain);\n    if (!schemaResult.success) {\n      return schemaResult;\n    }\n\n    const schema = schemaResult.data.schema;\n    let orbital: Orbital;\n\n    if (orbitalName) {\n      const found = schema.orbitals.find((o: Orbital) => o.name === orbitalName);\n      if (!found) {\n        return {\n          success: false,\n          error: `Orbital \"${orbitalName}\" not found in ${importPath}. Available: ${schema.orbitals.map((o: Orbital) => o.name).join(\", \")}`,\n        };\n      }\n      orbital = found;\n    } else {\n      // Default to first orbital\n      if (schema.orbitals.length === 0) {\n        return {\n          success: false,\n          error: `No orbitals found in ${importPath}`,\n        };\n      }\n      orbital = schema.orbitals[0];\n    }\n\n    return {\n      success: true,\n      data: {\n        orbital,\n        sourcePath: schemaResult.data.sourcePath,\n        importPath,\n      },\n    };\n  }\n\n  /**\n   * Resolve an import path to an absolute filesystem path.\n   */\n  resolvePath(importPath: string, fromPath?: string): LoadResult<string> {\n    // Standard library\n    if (importPath.startsWith(\"std/\")) {\n      return this.resolveStdPath(importPath);\n    }\n\n    // Scoped packages\n    if (importPath.startsWith(\"@\")) {\n      return this.resolveScopedPath(importPath);\n    }\n\n    // Relative paths\n    if (importPath.startsWith(\"./\") || importPath.startsWith(\"../\")) {\n      return this.resolveRelativePath(importPath, fromPath);\n    }\n\n    // Absolute paths (only if allowed)\n    if (path.isAbsolute(importPath)) {\n      if (!this.options.allowOutsideBasePath) {\n        return {\n          success: false,\n          error: `Absolute paths not allowed: ${importPath}`,\n        };\n      }\n      return { success: true, data: importPath };\n    }\n\n    // Default: treat as relative to base path\n    return this.resolveRelativePath(`./${importPath}`, fromPath);\n  }\n\n  /**\n   * Resolve a standard library path.\n   */\n  private resolveStdPath(importPath: string): LoadResult<string> {\n    if (!this.options.stdLibPath) {\n      return {\n        success: false,\n        error: `Standard library path not configured. Cannot load: ${importPath}`,\n      };\n    }\n\n    // std/behaviors/game-core -> stdLibPath/behaviors/game-core.orb\n    const relativePath = importPath.slice(4); // Remove \"std/\"\n    let absolutePath = path.join(this.options.stdLibPath, relativePath);\n\n    // Add .orb extension if not present\n    if (!absolutePath.endsWith(\".orb\")) {\n      absolutePath += \".orb\";\n    }\n\n    // Validate it's within std library\n    const normalizedPath = path.normalize(absolutePath);\n    const normalizedStdLib = path.normalize(this.options.stdLibPath);\n    if (!normalizedPath.startsWith(normalizedStdLib)) {\n      return {\n        success: false,\n        error: `Path traversal outside std library: ${importPath}`,\n      };\n    }\n\n    return { success: true, data: absolutePath };\n  }\n\n  /**\n   * Resolve a scoped package path.\n   */\n  private resolveScopedPath(importPath: string): LoadResult<string> {\n    // Extract scope: @game-lib/enemies.orb -> @game-lib\n    const match = importPath.match(/^(@[^/]+)/);\n    if (!match) {\n      return {\n        success: false,\n        error: `Invalid scoped package path: ${importPath}`,\n      };\n    }\n\n    const scope = match[1];\n    const scopeRoot = this.options.scopedPaths[scope];\n    if (!scopeRoot) {\n      return {\n        success: false,\n        error: `Scoped package \"${scope}\" not configured. Available: ${Object.keys(this.options.scopedPaths).join(\", \") || \"none\"}`,\n      };\n    }\n\n    // @game-lib/enemies.orb -> scopeRoot/enemies.orb\n    const relativePath = importPath.slice(scope.length + 1); // Remove \"@scope/\"\n    let absolutePath = path.join(scopeRoot, relativePath);\n\n    // Add .orb extension if not present\n    if (!absolutePath.endsWith(\".orb\")) {\n      absolutePath += \".orb\";\n    }\n\n    // Validate it's within scope root\n    const normalizedPath = path.normalize(absolutePath);\n    const normalizedRoot = path.normalize(scopeRoot);\n    if (!normalizedPath.startsWith(normalizedRoot)) {\n      return {\n        success: false,\n        error: `Path traversal outside scoped package: ${importPath}`,\n      };\n    }\n\n    return { success: true, data: absolutePath };\n  }\n\n  /**\n   * Resolve a relative path.\n   */\n  private resolveRelativePath(\n    importPath: string,\n    fromPath?: string\n  ): LoadResult<string> {\n    const baseDir = fromPath\n      ? path.dirname(fromPath)\n      : this.options.basePath;\n\n    let absolutePath = path.resolve(baseDir, importPath);\n\n    // Add .orb extension if not present\n    if (!absolutePath.endsWith(\".orb\")) {\n      absolutePath += \".orb\";\n    }\n\n    // Security check: ensure within base path\n    if (!this.options.allowOutsideBasePath) {\n      const normalizedPath = path.normalize(absolutePath);\n      const normalizedBase = path.normalize(this.options.basePath);\n      if (!normalizedPath.startsWith(normalizedBase)) {\n        return {\n          success: false,\n          error: `Path traversal outside base path: ${importPath}. Base: ${this.options.basePath}`,\n        };\n      }\n    }\n\n    return { success: true, data: absolutePath };\n  }\n\n  /**\n   * Load and parse an .orb file.\n   */\n  private async loadFile(absolutePath: string): Promise<LoadResult<OrbitalSchema>> {\n    try {\n      // Check file exists\n      if (!fs.existsSync(absolutePath)) {\n        return {\n          success: false,\n          error: `File not found: ${absolutePath}`,\n        };\n      }\n\n      // Read file\n      const content = await fs.promises.readFile(absolutePath, \"utf-8\");\n\n      // Parse JSON\n      let data: unknown;\n      try {\n        data = JSON.parse(content);\n      } catch (e) {\n        return {\n          success: false,\n          error: `Invalid JSON in ${absolutePath}: ${e instanceof Error ? e.message : String(e)}`,\n        };\n      }\n\n      // Validate with Zod\n      const parseResult = OrbitalSchemaSchema.safeParse(data);\n      if (!parseResult.success) {\n        const errors = parseResult.error.errors\n          .map((e) => `  - ${e.path.join(\".\")}: ${e.message}`)\n          .join(\"\\n\");\n        return {\n          success: false,\n          error: `Invalid schema in ${absolutePath}:\\n${errors}`,\n        };\n      }\n\n      return { success: true, data: parseResult.data as OrbitalSchema };\n    } catch (e) {\n      return {\n        success: false,\n        error: `Failed to load ${absolutePath}: ${e instanceof Error ? e.message : String(e)}`,\n      };\n    }\n  }\n\n  /**\n   * Clear the cache.\n   */\n  clearCache(): void {\n    this.cache.clear();\n  }\n\n  /**\n   * Get cache statistics.\n   */\n  getCacheStats(): { size: number } {\n    return { size: this.cache.size };\n  }\n}\n\n// ============================================================================\n// Factory Function\n// ============================================================================\n\n/**\n * Create a loader with sensible defaults.\n */\nexport function createLoader(basePath: string, options?: Partial<LoaderOptions>): ExternalOrbitalLoader {\n  return new ExternalOrbitalLoader({\n    basePath,\n    ...options,\n  });\n}\n\n// ============================================================================\n// Utility Functions\n// ============================================================================\n\n/**\n * Parse an import path with optional fragment.\n *\n * @example\n * parseImportPath(\"./health.orb\") // { path: \"./health.orb\", fragment: undefined }\n * parseImportPath(\"./game.orb#Player\") // { path: \"./game.orb\", fragment: \"Player\" }\n */\nexport function parseImportPath(importPath: string): { path: string; fragment?: string } {\n  const hashIndex = importPath.indexOf(\"#\");\n  if (hashIndex === -1) {\n    return { path: importPath };\n  }\n  return {\n    path: importPath.slice(0, hashIndex),\n    fragment: importPath.slice(hashIndex + 1),\n  };\n}\n"]}
+{"version":3,"sources":["../src/loader/external-loader.ts"],"names":[],"mappings":"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","file":"external-loader-UBJ6VRW5.js","sourcesContent":["/**\n * External Orbital Loader\n *\n * Loads external .orb files from various sources:\n * - Local filesystem (relative paths)\n * - Standard library (std/...)\n * - Scoped packages (@name/...)\n *\n * @packageDocumentation\n */\n\nimport * as fs from \"fs\";\nimport * as path from \"path\";\nimport type { Orbital, OrbitalSchema } from \"@almadar/core\";\nimport { OrbitalSchemaSchema } from \"@almadar/core\";\n\n// ============================================================================\n// Types\n// ============================================================================\n\n/**\n * Result of loading an orbital.\n */\nexport interface LoadedOrbital {\n  /** The loaded orbital */\n  orbital: Orbital;\n\n  /** Source path (resolved absolute path) */\n  sourcePath: string;\n\n  /** Original import path */\n  importPath: string;\n}\n\n/**\n * Result of loading an orbital schema (may contain multiple orbitals).\n */\nexport interface LoadedSchema {\n  /** The loaded schema */\n  schema: OrbitalSchema;\n\n  /** Source path (resolved absolute path) */\n  sourcePath: string;\n\n  /** Original import path */\n  importPath: string;\n}\n\n/**\n * Loader options.\n */\nexport interface LoaderOptions {\n  /** Base directory for resolving relative imports */\n  basePath: string;\n\n  /** Standard library root path */\n  stdLibPath?: string;\n\n  /** Scoped package roots (e.g., { \"@game-lib\": \"/path/to/lib\" }) */\n  scopedPaths?: Record<string, string>;\n\n  /** Whether to allow paths outside basePath (security) */\n  allowOutsideBasePath?: boolean;\n}\n\n/**\n * Loader result with error handling.\n */\nexport type LoadResult<T> =\n  | { success: true; data: T }\n  | { success: false; error: string };\n\n// ============================================================================\n// Circular Import Detection\n// ============================================================================\n\n/**\n * Tracks import chains to detect circular imports.\n */\nexport class ImportChain {\n  private chain: string[] = [];\n\n  /**\n   * Try to add a path to the chain.\n   * @returns Error message if circular, null if OK\n   */\n  push(absolutePath: string): string | null {\n    if (this.chain.includes(absolutePath)) {\n      const cycle = [...this.chain.slice(this.chain.indexOf(absolutePath)), absolutePath];\n      return `Circular import detected: ${cycle.join(\" -> \")}`;\n    }\n    this.chain.push(absolutePath);\n    return null;\n  }\n\n  /**\n   * Remove the last path from the chain.\n   */\n  pop(): void {\n    this.chain.pop();\n  }\n\n  /**\n   * Clone the chain for nested loading.\n   */\n  clone(): ImportChain {\n    const newChain = new ImportChain();\n    newChain.chain = [...this.chain];\n    return newChain;\n  }\n}\n\n// ============================================================================\n// Cache\n// ============================================================================\n\n/**\n * Cache for loaded schemas to avoid re-loading.\n */\nexport class LoaderCache {\n  private cache = new Map<string, LoadedSchema>();\n\n  get(absolutePath: string): LoadedSchema | undefined {\n    return this.cache.get(absolutePath);\n  }\n\n  set(absolutePath: string, schema: LoadedSchema): void {\n    this.cache.set(absolutePath, schema);\n  }\n\n  has(absolutePath: string): boolean {\n    return this.cache.has(absolutePath);\n  }\n\n  clear(): void {\n    this.cache.clear();\n  }\n\n  get size(): number {\n    return this.cache.size;\n  }\n}\n\n// ============================================================================\n// External Orbital Loader\n// ============================================================================\n\n/**\n * ExternalOrbitalLoader - Loads external .orb files with security and caching.\n *\n * Security Model:\n * - By default, only allows loading from within basePath\n * - std library has its own allowed path\n * - Scoped packages have their own allowed paths\n * - No path traversal outside allowed directories\n *\n * @example\n * ```typescript\n * const loader = new ExternalOrbitalLoader({\n *   basePath: \"/project/schemas\",\n *   stdLibPath: \"/project/std\",\n * });\n *\n * // Load relative .orb file\n * const result = await loader.load(\"./shared/health.orb\");\n *\n * // Load from std library\n * const stdResult = await loader.load(\"std/behaviors/game-core\");\n * ```\n */\nexport class ExternalOrbitalLoader {\n  private options: Required<LoaderOptions>;\n  private cache: LoaderCache;\n\n  constructor(options: LoaderOptions) {\n    this.options = {\n      stdLibPath: options.stdLibPath ?? \"\",\n      scopedPaths: options.scopedPaths ?? {},\n      allowOutsideBasePath: options.allowOutsideBasePath ?? false,\n      ...options,\n    };\n    this.cache = new LoaderCache();\n  }\n\n  /**\n   * Load a schema from an import path.\n   *\n   * @param importPath - The import path (e.g., \"./health.orb\", \"std/behaviors/game-core\")\n   * @param fromPath - The path of the file doing the import (for relative resolution)\n   * @param chain - Import chain for circular detection\n   */\n  async load(\n    importPath: string,\n    fromPath?: string,\n    chain?: ImportChain\n  ): Promise<LoadResult<LoadedSchema>> {\n    const importChain = chain ?? new ImportChain();\n\n    // Resolve the absolute path\n    const resolveResult = this.resolvePath(importPath, fromPath);\n    if (!resolveResult.success) {\n      return resolveResult;\n    }\n    const absolutePath = resolveResult.data;\n\n    // Check for circular imports\n    const circularError = importChain.push(absolutePath);\n    if (circularError) {\n      return { success: false, error: circularError };\n    }\n\n    try {\n      // Check cache\n      const cached = this.cache.get(absolutePath);\n      if (cached) {\n        return { success: true, data: cached };\n      }\n\n      // Load and parse the file\n      const loadResult = await this.loadFile(absolutePath);\n      if (!loadResult.success) {\n        return loadResult;\n      }\n\n      const loaded: LoadedSchema = {\n        schema: loadResult.data,\n        sourcePath: absolutePath,\n        importPath,\n      };\n\n      // Cache the result\n      this.cache.set(absolutePath, loaded);\n\n      return { success: true, data: loaded };\n    } finally {\n      importChain.pop();\n    }\n  }\n\n  /**\n   * Load a specific orbital from a schema by name.\n   *\n   * @param importPath - The import path\n   * @param orbitalName - The orbital name (optional, defaults to first orbital)\n   * @param fromPath - The path of the file doing the import\n   * @param chain - Import chain for circular detection\n   */\n  async loadOrbital(\n    importPath: string,\n    orbitalName?: string,\n    fromPath?: string,\n    chain?: ImportChain\n  ): Promise<LoadResult<LoadedOrbital>> {\n    const schemaResult = await this.load(importPath, fromPath, chain);\n    if (!schemaResult.success) {\n      return schemaResult;\n    }\n\n    const schema = schemaResult.data.schema;\n    let orbital: Orbital;\n\n    if (orbitalName) {\n      const found = schema.orbitals.find((o: Orbital) => o.name === orbitalName);\n      if (!found) {\n        return {\n          success: false,\n          error: `Orbital \"${orbitalName}\" not found in ${importPath}. Available: ${schema.orbitals.map((o: Orbital) => o.name).join(\", \")}`,\n        };\n      }\n      orbital = found;\n    } else {\n      // Default to first orbital\n      if (schema.orbitals.length === 0) {\n        return {\n          success: false,\n          error: `No orbitals found in ${importPath}`,\n        };\n      }\n      orbital = schema.orbitals[0];\n    }\n\n    return {\n      success: true,\n      data: {\n        orbital,\n        sourcePath: schemaResult.data.sourcePath,\n        importPath,\n      },\n    };\n  }\n\n  /**\n   * Resolve an import path to an absolute filesystem path.\n   */\n  resolvePath(importPath: string, fromPath?: string): LoadResult<string> {\n    // Standard library\n    if (importPath.startsWith(\"std/\")) {\n      return this.resolveStdPath(importPath);\n    }\n\n    // Scoped packages\n    if (importPath.startsWith(\"@\")) {\n      return this.resolveScopedPath(importPath);\n    }\n\n    // Relative paths\n    if (importPath.startsWith(\"./\") || importPath.startsWith(\"../\")) {\n      return this.resolveRelativePath(importPath, fromPath);\n    }\n\n    // Absolute paths (only if allowed)\n    if (path.isAbsolute(importPath)) {\n      if (!this.options.allowOutsideBasePath) {\n        return {\n          success: false,\n          error: `Absolute paths not allowed: ${importPath}`,\n        };\n      }\n      return { success: true, data: importPath };\n    }\n\n    // Default: treat as relative to base path\n    return this.resolveRelativePath(`./${importPath}`, fromPath);\n  }\n\n  /**\n   * Resolve a standard library path.\n   */\n  private resolveStdPath(importPath: string): LoadResult<string> {\n    if (!this.options.stdLibPath) {\n      return {\n        success: false,\n        error: `Standard library path not configured. Cannot load: ${importPath}`,\n      };\n    }\n\n    // std/behaviors/game-core -> stdLibPath/behaviors/game-core.orb\n    const relativePath = importPath.slice(4); // Remove \"std/\"\n    let absolutePath = path.join(this.options.stdLibPath, relativePath);\n\n    // Add .orb extension if not present\n    if (!absolutePath.endsWith(\".orb\")) {\n      absolutePath += \".orb\";\n    }\n\n    // Validate it's within std library\n    const normalizedPath = path.normalize(absolutePath);\n    const normalizedStdLib = path.normalize(this.options.stdLibPath);\n    if (!normalizedPath.startsWith(normalizedStdLib)) {\n      return {\n        success: false,\n        error: `Path traversal outside std library: ${importPath}`,\n      };\n    }\n\n    return { success: true, data: absolutePath };\n  }\n\n  /**\n   * Resolve a scoped package path.\n   */\n  private resolveScopedPath(importPath: string): LoadResult<string> {\n    // Extract scope: @game-lib/enemies.orb -> @game-lib\n    const match = importPath.match(/^(@[^/]+)/);\n    if (!match) {\n      return {\n        success: false,\n        error: `Invalid scoped package path: ${importPath}`,\n      };\n    }\n\n    const scope = match[1];\n    const scopeRoot = this.options.scopedPaths[scope];\n    if (!scopeRoot) {\n      return {\n        success: false,\n        error: `Scoped package \"${scope}\" not configured. Available: ${Object.keys(this.options.scopedPaths).join(\", \") || \"none\"}`,\n      };\n    }\n\n    // @game-lib/enemies.orb -> scopeRoot/enemies.orb\n    const relativePath = importPath.slice(scope.length + 1); // Remove \"@scope/\"\n    let absolutePath = path.join(scopeRoot, relativePath);\n\n    // Add .orb extension if not present\n    if (!absolutePath.endsWith(\".orb\")) {\n      absolutePath += \".orb\";\n    }\n\n    // Validate it's within scope root\n    const normalizedPath = path.normalize(absolutePath);\n    const normalizedRoot = path.normalize(scopeRoot);\n    if (!normalizedPath.startsWith(normalizedRoot)) {\n      return {\n        success: false,\n        error: `Path traversal outside scoped package: ${importPath}`,\n      };\n    }\n\n    return { success: true, data: absolutePath };\n  }\n\n  /**\n   * Resolve a relative path.\n   */\n  private resolveRelativePath(\n    importPath: string,\n    fromPath?: string\n  ): LoadResult<string> {\n    const baseDir = fromPath\n      ? path.dirname(fromPath)\n      : this.options.basePath;\n\n    let absolutePath = path.resolve(baseDir, importPath);\n\n    // Add .orb extension if not present\n    if (!absolutePath.endsWith(\".orb\")) {\n      absolutePath += \".orb\";\n    }\n\n    // Security check: ensure within base path\n    if (!this.options.allowOutsideBasePath) {\n      const normalizedPath = path.normalize(absolutePath);\n      const normalizedBase = path.normalize(this.options.basePath);\n      if (!normalizedPath.startsWith(normalizedBase)) {\n        return {\n          success: false,\n          error: `Path traversal outside base path: ${importPath}. Base: ${this.options.basePath}`,\n        };\n      }\n    }\n\n    return { success: true, data: absolutePath };\n  }\n\n  /**\n   * Load and parse an .orb file.\n   */\n  private async loadFile(absolutePath: string): Promise<LoadResult<OrbitalSchema>> {\n    try {\n      // Check file exists\n      if (!fs.existsSync(absolutePath)) {\n        return {\n          success: false,\n          error: `File not found: ${absolutePath}`,\n        };\n      }\n\n      // Read file\n      const content = await fs.promises.readFile(absolutePath, \"utf-8\");\n\n      // Parse JSON\n      let data: unknown;\n      try {\n        data = JSON.parse(content);\n      } catch (e) {\n        return {\n          success: false,\n          error: `Invalid JSON in ${absolutePath}: ${e instanceof Error ? e.message : String(e)}`,\n        };\n      }\n\n      // Validate with Zod\n      const parseResult = OrbitalSchemaSchema.safeParse(data);\n      if (!parseResult.success) {\n        const errors = parseResult.error.errors\n          .map((e) => `  - ${e.path.join(\".\")}: ${e.message}`)\n          .join(\"\\n\");\n        return {\n          success: false,\n          error: `Invalid schema in ${absolutePath}:\\n${errors}`,\n        };\n      }\n\n      return { success: true, data: parseResult.data as OrbitalSchema };\n    } catch (e) {\n      return {\n        success: false,\n        error: `Failed to load ${absolutePath}: ${e instanceof Error ? e.message : String(e)}`,\n      };\n    }\n  }\n\n  /**\n   * Clear the cache.\n   */\n  clearCache(): void {\n    this.cache.clear();\n  }\n\n  /**\n   * Get cache statistics.\n   */\n  getCacheStats(): { size: number } {\n    return { size: this.cache.size };\n  }\n}\n\n// ============================================================================\n// Factory Function\n// ============================================================================\n\n/**\n * Create a loader with sensible defaults.\n */\nexport function createLoader(basePath: string, options?: Partial<LoaderOptions>): ExternalOrbitalLoader {\n  return new ExternalOrbitalLoader({\n    basePath,\n    ...options,\n  });\n}\n\n// ============================================================================\n// Utility Functions\n// ============================================================================\n\n/**\n * Parse an import path with optional fragment.\n *\n * @example\n * parseImportPath(\"./health.orb\") // { path: \"./health.orb\", fragment: undefined }\n * parseImportPath(\"./game.orb#Player\") // { path: \"./game.orb\", fragment: \"Player\" }\n */\nexport function parseImportPath(importPath: string): { path: string; fragment?: string } {\n  const hashIndex = importPath.indexOf(\"#\");\n  if (hashIndex === -1) {\n    return { path: importPath };\n  }\n  return {\n    path: importPath.slice(0, hashIndex),\n    fragment: importPath.slice(hashIndex + 1),\n  };\n}\n"]}

package/dist/index.d.ts

@@ -1,9 +1,9 @@
-import { B as BindingContext, E as EvaluationContextExtensions, P as PatternProps, a as EffectHandlers, b as EffectContext, c as ExecutionEnvironment, d as EffectResult, T as TraitDefinition } from './types-CvYnmqkg.js';
-export { e as Effect, f as EventListener, H as HANDLER_MANIFEST, I as IEventBus, R as RuntimeConfig, g as RuntimeEvent, h as TraitState, i as TransitionObserver, j as TransitionResult, U as Unsubscribe } from './types-CvYnmqkg.js';
-export { E as EntitySharingMap, a as EventBus, b as EventNamespaceMap, O as OrbitalEventRequest, c as OrbitalEventResponse, d as OrbitalServerRuntimeConfig, P as PersistenceAdapter, e as PreprocessOptions, f as PreprocessResult, g as PreprocessedSchema, h as ProcessEventOptions, R as RegisteredOrbital, i as RuntimeOrbital, j as RuntimeOrbitalSchema, k as RuntimeTrait, S as StateMachineManager, l as createInitialTraitState, m as findInitialState, n as findTransition, o as getIsolatedCollectionName, p as getNamespacedEvent, q as isNamespacedEvent, r as normalizeEventKey, s as parseNamespacedEvent, t as preprocessSchema, u as processEvent } from './OrbitalServerRuntime-CJYMN0d3.js';
+import { B as BindingContext, E as EvaluationContextExtensions, P as PatternProps, a as EffectHandlers, b as EffectContext, c as ExecutionEnvironment, d as EffectResult, T as TraitDefinition } from './types-CM6txTNy.js';
+export { e as Effect, f as EventListener, H as HANDLER_MANIFEST, I as IEventBus, R as RuntimeConfig, g as RuntimeEvent, h as TraitState, i as TransitionObserver, j as TransitionResult, U as Unsubscribe } from './types-CM6txTNy.js';
+export { E as EntitySharingMap, a as EventBus, b as EventNamespaceMap, O as OrbitalEventRequest, c as OrbitalEventResponse, d as OrbitalServerRuntimeConfig, P as PersistenceAdapter, e as PreprocessOptions, f as PreprocessResult, g as PreprocessedSchema, h as ProcessEventOptions, R as RegisteredOrbital, i as RuntimeOrbital, j as RuntimeOrbitalSchema, k as RuntimeTrait, S as StateMachineManager, l as createInitialTraitState, m as findInitialState, n as findTransition, o as getIsolatedCollectionName, p as getNamespacedEvent, q as isNamespacedEvent, r as normalizeEventKey, s as parseNamespacedEvent, t as preprocessSchema, u as processEvent } from './OrbitalServerRuntime-QXgOGiS8.js';
 import { EvaluationContext } from '@almadar/evaluator';
 export { EvaluationContext, createMinimalContext } from '@almadar/evaluator';
-import { EventPayload, EntityRow } from '@almadar/core';
+import { EventPayload, EntityRow, OrbitalDefinition, OrbitalSchema } from '@almadar/core';
 export { ServerBridgeConfig, ServerBridgeState } from './ServerBridge.js';
 import 'express';
 
@@ -350,4 +350,173 @@ declare function validatePayloadShapes(traits: TraitDefinition[], emits: Map<str
  */
 declare function buildEmitsFromTraits(traits: TraitDefinition[], explicitEmits?: Map<string, EmitDeclaration[]>): Map<string, EmitDeclaration[]>;
 
-export { BindingContext, type ClientEventBus, type CreateClientEffectHandlersOptions, EffectContext, EffectExecutor, type EffectExecutorOptions, EffectHandlers, EffectResult, type EntityField, type EntitySchema, ExecutionEnvironment, type MockPersistenceConfig, type OsHandlerContext, type OsHandlerResult, type PayloadMismatch, type SlotSetter, TraitDefinition, buildEmitsFromTraits, containsBindings, createClientEffectHandlers, createContextFromBindings, createTestExecutor, extractBindings, interpolateProps, interpolateValue, validatePayloadShapes };
+/**
+ * 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 to compose */
+    orbitals: OrbitalDefinition[];
+    /** 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;
+
+/**
+ * Pipe Behaviors
+ *
+ * Left-to-right composition. Each step receives the previous result as its
+ * first argument and returns the value handed to the next step.
+ *
+ * @packageDocumentation
+ */
+/**
+ * A single step in a behavior pipeline.
+ */
+type PipeStep<I, O> = (input: I) => O;
+/**
+ * Apply a series of transformation steps to a seed value, left to right.
+ * Each step receives the previous step's output as its first argument.
+ *
+ * @example
+ * ```ts
+ * pipeBehaviors(1, (n) => n + 1, (n) => n * 10); // -> 20
+ * ```
+ */
+declare function pipeBehaviors<T>(seed: T, ...steps: Array<PipeStep<unknown, unknown>>): unknown;
+
+/**
+ * Composition Module
+ *
+ * Runtime-side TypeScript composition layer for behavior/* operators.
+ *
+ * Composition is normally a compile-time concept, evaluated by the Rust
+ * compiler pass before code generation. The runtime ships an equivalent
+ * TypeScript implementation so dev-mode hot reload, agent-driven dynamic
+ * composition, and the legacy `composeBehaviors()` callers all have a
+ * usable in-process implementation. The handlers are wired into
+ * `EffectExecutor` as optional handlers (`composeBehaviors`,
+ * `applyEventWiring`, `detectLayoutStrategy`, `pipeBehaviors`) so
+ * consumers that do not need composition pay no cost.
+ *
+ * @packageDocumentation
+ */
+
+type index_ComposeBehaviorsInput = ComposeBehaviorsInput;
+type index_ComposeBehaviorsResult = ComposeBehaviorsResult;
+type index_EventWiringEntry = EventWiringEntry;
+type index_LayoutStrategy = LayoutStrategy;
+type index_PipeStep<I, O> = PipeStep<I, O>;
+declare const index_applyEventWiring: typeof applyEventWiring;
+declare const index_composeBehaviors: typeof composeBehaviors;
+declare const index_detectLayoutStrategy: typeof detectLayoutStrategy;
+declare const index_pipeBehaviors: typeof pipeBehaviors;
+declare namespace index {
+  export { type index_ComposeBehaviorsInput as ComposeBehaviorsInput, type index_ComposeBehaviorsResult as ComposeBehaviorsResult, type index_EventWiringEntry as EventWiringEntry, type index_LayoutStrategy as LayoutStrategy, type index_PipeStep as PipeStep, index_applyEventWiring as applyEventWiring, index_composeBehaviors as composeBehaviors, index_detectLayoutStrategy as detectLayoutStrategy, index_pipeBehaviors as pipeBehaviors };
+}
+
+export { BindingContext, type ClientEventBus, type ComposeBehaviorsInput, type ComposeBehaviorsResult, type CreateClientEffectHandlersOptions, EffectContext, EffectExecutor, type EffectExecutorOptions, EffectHandlers, EffectResult, type EntityField, type EntitySchema, type EventWiringEntry, ExecutionEnvironment, type LayoutStrategy, type MockPersistenceConfig, type OsHandlerContext, type OsHandlerResult, type PayloadMismatch, type PipeStep, type SlotSetter, TraitDefinition, applyEventWiring, buildEmitsFromTraits, composeBehaviors, index as composition, containsBindings, createClientEffectHandlers, createContextFromBindings, createTestExecutor, detectLayoutStrategy, extractBindings, interpolateProps, interpolateValue, pipeBehaviors, validatePayloadShapes };

package/dist/index.js

@@ -1,4 +1,6 @@
-export { EffectExecutor, EventBus, HANDLER_MANIFEST, StateMachineManager, containsBindings, createContextFromBindings, createInitialTraitState, createMinimalContext, createTestExecutor, extractBindings, findInitialState, findTransition, getIsolatedCollectionName, getNamespacedEvent, interpolateProps, interpolateValue, isNamespacedEvent, normalizeEventKey, parseNamespacedEvent, preprocessSchema, processEvent } from './chunk-ZYH3XSOL.js';
+export { EffectExecutor, EventBus, HANDLER_MANIFEST, StateMachineManager, containsBindings, createContextFromBindings, createInitialTraitState, createMinimalContext, createTestExecutor, extractBindings, findInitialState, findTransition, getIsolatedCollectionName, getNamespacedEvent, interpolateProps, interpolateValue, isNamespacedEvent, normalizeEventKey, parseNamespacedEvent, preprocessSchema, processEvent } from './chunk-HIM4HJAN.js';
+import { __export } from './chunk-PZ5AY32C.js';
+import { isInlineTrait } from '@almadar/core';
 
 // src/ClientEffectHandlers.ts
 function createClientEffectHandlers(options) {
@@ -111,6 +113,220 @@ function buildEmitsFromTraits(traits, explicitEmits) {
   return result;
 }
 
-export { buildEmitsFromTraits, createClientEffectHandlers, validatePayloadShapes };
+// src/composition/index.ts
+var composition_exports = {};
+__export(composition_exports, {
+  applyEventWiring: () => applyEventWiring,
+  composeBehaviors: () => composeBehaviors,
+  detectLayoutStrategy: () => detectLayoutStrategy,
+  pipeBehaviors: () => pipeBehaviors
+});
+function findInlineTrait(orbitals, name) {
+  for (const orbital of orbitals) {
+    for (const traitRef of orbital.traits) {
+      if (isInlineTrait(traitRef) && traitRef.name === name) {
+        return traitRef;
+      }
+    }
+  }
+  return null;
+}
+function hasEmit(emits, event) {
+  return emits.some((e) => e.event === event);
+}
+function hasListen(listens, event, triggers) {
+  return listens.some((l) => l.event === event && l.triggers === triggers);
+}
+function applyEventWiring(orbitals, wiring) {
+  const cloned = JSON.parse(
+    JSON.stringify(orbitals)
+  );
+  for (const entry of wiring) {
+    const sourceTrait = findInlineTrait(cloned, entry.from);
+    if (sourceTrait) {
+      if (!sourceTrait.emits) {
+        sourceTrait.emits = [];
+      }
+      if (!hasEmit(sourceTrait.emits, entry.event)) {
+        sourceTrait.emits.push({
+          event: entry.event,
+          scope: "external"
+        });
+      }
+    }
+    const targetTrait = findInlineTrait(cloned, entry.to);
+    if (targetTrait) {
+      if (!targetTrait.listens) {
+        targetTrait.listens = [];
+      }
+      if (!hasListen(targetTrait.listens, entry.event, entry.triggers)) {
+        targetTrait.listens.push({
+          event: entry.event,
+          triggers: entry.triggers,
+          scope: "external"
+        });
+      }
+    }
+  }
+  return cloned;
+}
+
+// src/composition/layout-strategy.ts
+function hasSequentialChain(wiring) {
+  if (wiring.length < 2) {
+    return false;
+  }
+  const adjacency = /* @__PURE__ */ new Map();
+  const allTargets = /* @__PURE__ */ new Set();
+  for (const entry of wiring) {
+    let targets = adjacency.get(entry.from);
+    if (!targets) {
+      targets = /* @__PURE__ */ new Set();
+      adjacency.set(entry.from, targets);
+    }
+    targets.add(entry.to);
+    allTargets.add(entry.to);
+  }
+  const roots = [];
+  for (const from of adjacency.keys()) {
+    if (!allTargets.has(from)) {
+      roots.push(from);
+    }
+  }
+  const starts = roots.length > 0 ? roots : [...adjacency.keys()];
+  for (const start of starts) {
+    let current = start;
+    let length = 1;
+    const visited = /* @__PURE__ */ new Set([current]);
+    while (true) {
+      const nexts = adjacency.get(current);
+      if (!nexts || nexts.size === 0) break;
+      let advanced = false;
+      for (const next of nexts) {
+        if (!visited.has(next)) {
+          visited.add(next);
+          current = next;
+          length++;
+          advanced = true;
+          break;
+        }
+      }
+      if (!advanced) break;
+    }
+    if (length >= 3) {
+      return true;
+    }
+  }
+  return false;
+}
+function detectLayoutStrategy(orbitals, eventWiring) {
+  if (eventWiring && eventWiring.length > 0 && hasSequentialChain(eventWiring)) {
+    return "wizard-flow";
+  }
+  const count = orbitals.length;
+  if (count <= 1) {
+    return "single";
+  }
+  if (count <= 4) {
+    return "tabs";
+  }
+  return "sidebar";
+}
+
+// src/composition/compose-behaviors.ts
+function toKebabCase(name) {
+  return name.replace(/([a-z])([A-Z])/g, "$1-$2").replace(/[\s_]+/g, "-").toLowerCase();
+}
+function generatePages(orbitals, strategy) {
+  switch (strategy) {
+    case "single": {
+      const orbital = orbitals[0];
+      const name = orbital?.name ?? "Main";
+      return [
+        {
+          name: `${name}Page`,
+          path: "/",
+          isInitial: true,
+          primaryEntity: getEntityName(orbital)
+        }
+      ];
+    }
+    case "dashboard": {
+      return [
+        {
+          name: "DashboardPage",
+          path: "/",
+          viewType: "dashboard",
+          isInitial: true
+        }
+      ];
+    }
+    case "sidebar":
+    case "tabs":
+    case "wizard-flow": {
+      return orbitals.map((orbital, index) => ({
+        name: `${orbital.name}Page`,
+        path: index === 0 ? "/" : `/${toKebabCase(orbital.name)}`,
+        isInitial: index === 0,
+        primaryEntity: getEntityName(orbital)
+      }));
+    }
+  }
+}
+function getEntityName(orbital) {
+  if (!orbital) return void 0;
+  const entity = orbital.entity;
+  if (typeof entity === "string") {
+    return entity.replace(".entity", "");
+  }
+  return entity.name;
+}
+function composeBehaviors(input) {
+  const {
+    appName,
+    orbitals: rawOrbitals,
+    layoutStrategy: strategyInput,
+    eventWiring
+  } = input;
+  const wiredOrbitals = eventWiring && eventWiring.length > 0 ? applyEventWiring(rawOrbitals, eventWiring) : rawOrbitals;
+  const strategy = !strategyInput || strategyInput === "auto" ? detectLayoutStrategy(wiredOrbitals, eventWiring) : strategyInput;
+  const pages = generatePages(wiredOrbitals, strategy);
+  const orbitalsWithPages = wiredOrbitals.map((orbital, index) => {
+    if (orbital.pages && orbital.pages.length > 0) {
+      return orbital;
+    }
+    const page = strategy === "dashboard" || strategy === "single" ? pages[0] : pages[index];
+    return {
+      ...orbital,
+      pages: page ? [page] : []
+    };
+  });
+  const schema = {
+    name: appName,
+    version: "1.0.0",
+    orbitals: orbitalsWithPages
+  };
+  return {
+    schema,
+    layout: {
+      strategy,
+      pageCount: pages.length
+    },
+    wiring: {
+      connections: eventWiring?.length ?? 0
+    }
+  };
+}
+
+// src/composition/pipe.ts
+function pipeBehaviors(seed, ...steps) {
+  let current = seed;
+  for (const step of steps) {
+    current = step(current);
+  }
+  return current;
+}
+
+export { applyEventWiring, buildEmitsFromTraits, composeBehaviors, composition_exports as composition, createClientEffectHandlers, detectLayoutStrategy, pipeBehaviors, validatePayloadShapes };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map