@microverse.ts/host-surface 0.1.0 → 0.2.0

package/README.md

@@ -24,33 +24,33 @@ export default defineHostSurfaceFor<MyHost>()
     description: 'Load order by id',
     handler: ({ host }, { orderId }) => host.orders.get(orderId),
   })
-  .workflowHooks(workflowHooks) // optional
+  .componentHooks(componentHooks) // optional
   .build();
 ```
 
 | Step | Role |
 |------|------|
 | `defineHostSurfaceFor<THost>()` | Start builder; `handler` receives typed `host`. |
-| `.bridge('orders')` | Lua global table name. |
+| `.bridge('orders')` | Bridge table on `self.bridges` after `component:extend()`. |
 | `.method('get', { … })` | One bridge method: `requires`, `input`, `output`, `handler`. |
-| `.workflowHooks(…)` | Optional Zod map → `on*` hooks in Lua. |
+| `.componentHooks(…)` | Optional Zod map → `on*` domain events on `Component`. |
 | `.build()` | Compiled {@link HostSurface}. |
 
 `requires` is a `domain:action` capability string. `async` is inferred from `async function` handlers.
 
-Bridge names become **Lua global tables** (`orders`, `billing`, …). Do not use `workflow` as a bridge name when workflow hooks are enabled—that name is reserved for the injected `workflow:extend()` helper.
+Bridges are **not** global in the slot: use `self.bridges.orders:get(…)` from component methods.
 
 ### Host object
 
 The **host** is your engine context (services, repos, config). It is not generated here—you construct it in your app and pass it to `MicroverseLua.create({ host, surface })` or `HostScriptSession`.
 
-### Workflow hooks
+### Component domain events
 
-Call `.workflowHooks({ OrderPlaced: z.object({ … }), … })` before `.build()`.
+Call `.componentHooks({ OrderPlaced: z.object({ … }), … })` before `.build()`.
 
-- TypeScript emits via `emitToAllScripts('OrderPlaced', payload)`.
-- Lua implements `onOrderPlaced` on the table from `workflow:extend()`.
-- Manifest includes `MicroverseWorkflowEvt_*` classes in `.d.lua`.
+- TypeScript emits via `emitToAllInstances('OrderPlaced', payload)`.
+- Lua implements `onOrderPlaced` on the table from `component:extend()`.
+- Manifest includes `MicroverseEvt_*` payload classes and `on*` fields on `Component` in `.d.lua`.
 
 ## `HostScriptSession`
 
@@ -68,7 +68,7 @@ await session.openSession();
 await session.runChunk(luaSource);
 ```
 
-`MicroverseLua` in `@microverse.ts/microverse-lua` wraps this for the common case (shared VM, `registerScript`, broadcast hooks).
+`MicroverseLua` in `@microverse.ts/microverse-lua` wraps this for the common case (shared VM, script catalog + instances, broadcast hooks).
 
 ## Generating `.d.lua`
 
@@ -82,10 +82,11 @@ Optional **Lua type names** on Zod schemas (`luaType('OrderDto', z.object({ …
 
 ## Async bridges and Lua patterns
 
-Bridge handlers are **synchronous at the Lua boundary**; Wasmoon does not auto-resolve `Promise` into Lua values. For async TypeScript work, use the async bridge pattern (`:await()` or `onComplete` callback) documented in:
+Bridge handlers are **synchronous at the Lua boundary**; Wasmoon does not auto-resolve `Promise` into Lua values. For async TypeScript work, use an `async` handler on the surface; Lua calls the bridge with `:await()` or an `onComplete` callback. See:
 
-- [docs/async-subroutines-components.md](docs/async-subroutines-components.md)
-- [examples/business-scripting-engine/docs/COMPONENT_PATTERN.md](../../examples/business-scripting-engine/docs/COMPONENT_PATTERN.md)
+- [Async bridges — `@microverse.ts/microverse-lua`](../microverse-lua/README.md#async-bridges)
+- [Lua authoring (components)](../microverse-lua/README.md#lua-authoring)
+- Example: [`order_asyncio_tick.lua`](../../examples/business-scripting-engine/lua/components/order_asyncio_tick.lua)
 
 ## Reference
 

package/dist/application/useCases/compileBridgeDeclarationsFromHostSurfaceSpec.d.ts

@@ -1,7 +1,7 @@
 import { DeclarativeBridgeDeclaration } from '@microverse.ts/runtime-bridge';
-import { WithMicroverseCapabilityRegistry } from '../../domain/capabilityRegistrySymbol.js';
-import { HostSurfaceSpec } from '../../domain/hostSurfaceTypes.js';
-import { SchemaValidationPort } from '../ports/SchemaValidationPort.js';
+import { WithMicroverseCapabilityRegistry } from '../../domain/capabilityRegistrySymbol';
+import { HostSurfaceSpec } from '../../domain/hostSurfaceTypes';
+import { SchemaValidationPort } from '../ports/SchemaValidationPort';
 /**
  * Builds declarative bridge declarations from a host surface spec, using the schema validation port for Lua ↔ host payloads.
  */

package/dist/application/useCases/compileBridgeDeclarationsFromHostSurfaceSpec.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compileBridgeDeclarationsFromHostSurfaceSpec.d.ts","sourceRoot":"","sources":["../../../src/application/useCases/compileBridgeDeclarationsFromHostSurfaceSpec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,4BAA4B,EAAE,MAAM,+BAA+B,CAAC;AAGlF,OAAO,EAAkC,KAAK,gCAAgC,EAAE,MAAM,0CAA0C,CAAC;AAGjI,OAAO,KAAK,EAAwB,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAC9F,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAa7E;;GAEG;AACH,wBAAgB,2CAA2C,CAAC,KAAK,SAAS,eAAe,EACvF,gBAAgB,EAAE,oBAAoB,EACtC,IAAI,EAAE,KAAK,GACV,aAAa,CAAC,4BAA4B,CAAC,gCAAgC,EAAE,MAAM,CAAC,CAAC,CA+CvF"}
+{"version":3,"file":"compileBridgeDeclarationsFromHostSurfaceSpec.d.ts","sourceRoot":"","sources":["../../../src/application/useCases/compileBridgeDeclarationsFromHostSurfaceSpec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,4BAA4B,EAAE,MAAM,+BAA+B,CAAC;AAGlF,OAAO,EAAkC,KAAK,gCAAgC,EAAE,MAAM,uCAAuC,CAAC;AAM9H,OAAO,KAAK,EAAwB,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAC3F,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAa1E;;GAEG;AACH,wBAAgB,2CAA2C,CAAC,KAAK,SAAS,eAAe,EACvF,gBAAgB,EAAE,oBAAoB,EACtC,IAAI,EAAE,KAAK,GACV,aAAa,CAAC,4BAA4B,CAAC,gCAAgC,EAAE,MAAM,CAAC,CAAC,CA0DvF"}

package/dist/application/useCases/compileHostSurface.d.ts

@@ -1,13 +1,13 @@
-import { InferSurfaceCapabilities } from '../../domain/surfaceCapabilities.js';
-import { HostSurface, HostSurfaceSpec, HostWorkflowHooksSpec } from '../../domain/hostSurfaceTypes.js';
-import { SchemaValidationPort } from '../ports/SchemaValidationPort.js';
+import { InferSurfaceCapabilities } from '../../domain/surfaceCapabilities';
+import { HostSurface, HostSurfaceSpec, HostComponentHooksSpec } from '../../domain/hostSurfaceTypes';
+import { SchemaValidationPort } from '../ports/SchemaValidationPort';
 /**
  * Compiles a host surface using the injected schema validation port (tuple matches `UseCase` conventions in `@microverse.ts/shared`).
  */
 export declare function compileHostSurface<const TSpec extends HostSurfaceSpec>(ports: readonly [SchemaValidationPort], spec: TSpec): HostSurface<undefined, InferSurfaceCapabilities<TSpec>>;
-export declare function compileHostSurface<const TSpec extends HostSurfaceSpec, const THooks extends HostWorkflowHooksSpec>(ports: readonly [SchemaValidationPort], spec: TSpec, workflowHooks: THooks): HostSurface<THooks, InferSurfaceCapabilities<TSpec>>;
+export declare function compileHostSurface<const TSpec extends HostSurfaceSpec, const THooks extends HostComponentHooksSpec>(ports: readonly [SchemaValidationPort], spec: TSpec, componentHooks: THooks): HostSurface<THooks, InferSurfaceCapabilities<TSpec>>;
 /**
  * Same as {@link compileHostSurface}, but requires every bridge method to be typed with the same `THost`.
  */
-export declare function compileHostSurfaceFor<const TSpec extends HostSurfaceSpec, const THooks extends HostWorkflowHooksSpec | undefined = undefined>(ports: readonly [SchemaValidationPort], spec: TSpec, workflowHooks?: THooks): THooks extends HostWorkflowHooksSpec ? HostSurface<THooks, InferSurfaceCapabilities<TSpec>> : HostSurface<undefined, InferSurfaceCapabilities<TSpec>>;
+export declare function compileHostSurfaceFor<const TSpec extends HostSurfaceSpec, const THooks extends HostComponentHooksSpec | undefined = undefined>(ports: readonly [SchemaValidationPort], spec: TSpec, componentHooks?: THooks): THooks extends HostComponentHooksSpec ? HostSurface<THooks, InferSurfaceCapabilities<TSpec>> : HostSurface<undefined, InferSurfaceCapabilities<TSpec>>;
 //# sourceMappingURL=compileHostSurface.d.ts.map

package/dist/application/useCases/compileHostSurface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compileHostSurface.d.ts","sourceRoot":"","sources":["../../../src/application/useCases/compileHostSurface.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,wBAAwB,EAC9B,MAAM,qCAAqC,CAAC;AAC7C,OAAO,KAAK,EACV,WAAW,EAEX,eAAe,EACf,qBAAqB,EACtB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAoB7E;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,CAAC,KAAK,SAAS,eAAe,EACpE,KAAK,EAAE,SAAS,CAAC,oBAAoB,CAAC,EACtC,IAAI,EAAE,KAAK,GACV,WAAW,CAAC,SAAS,EAAE,wBAAwB,CAAC,KAAK,CAAC,CAAC,CAAC;AAC3D,wBAAgB,kBAAkB,CAChC,KAAK,CAAC,KAAK,SAAS,eAAe,EACnC,KAAK,CAAC,MAAM,SAAS,qBAAqB,EAE1C,KAAK,EAAE,SAAS,CAAC,oBAAoB,CAAC,EACtC,IAAI,EAAE,KAAK,EACX,aAAa,EAAE,MAAM,GACpB,WAAW,CAAC,MAAM,EAAE,wBAAwB,CAAC,KAAK,CAAC,CAAC,CAAC;AAcxD;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,CAAC,KAAK,SAAS,eAAe,EACnC,KAAK,CAAC,MAAM,SAAS,qBAAqB,GAAG,SAAS,GAAG,SAAS,EAElE,KAAK,EAAE,SAAS,CAAC,oBAAoB,CAAC,EACtC,IAAI,EAAE,KAAK,EACX,aAAa,CAAC,EAAE,MAAM,GACrB,MAAM,SAAS,qBAAqB,GACnC,WAAW,CAAC,MAAM,EAAE,wBAAwB,CAAC,KAAK,CAAC,CAAC,GACpD,WAAW,CAAC,SAAS,EAAE,wBAAwB,CAAC,KAAK,CAAC,CAAC,CAQ1D"}
+{"version":3,"file":"compileHostSurface.d.ts","sourceRoot":"","sources":["../../../src/application/useCases/compileHostSurface.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,wBAAwB,EAC9B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,KAAK,EACV,WAAW,EAEX,eAAe,EACf,sBAAsB,EACvB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAoB1E;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,CAAC,KAAK,SAAS,eAAe,EACpE,KAAK,EAAE,SAAS,CAAC,oBAAoB,CAAC,EACtC,IAAI,EAAE,KAAK,GACV,WAAW,CAAC,SAAS,EAAE,wBAAwB,CAAC,KAAK,CAAC,CAAC,CAAC;AAC3D,wBAAgB,kBAAkB,CAChC,KAAK,CAAC,KAAK,SAAS,eAAe,EACnC,KAAK,CAAC,MAAM,SAAS,sBAAsB,EAE3C,KAAK,EAAE,SAAS,CAAC,oBAAoB,CAAC,EACtC,IAAI,EAAE,KAAK,EACX,cAAc,EAAE,MAAM,GACrB,WAAW,CAAC,MAAM,EAAE,wBAAwB,CAAC,KAAK,CAAC,CAAC,CAAC;AAcxD;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,CAAC,KAAK,SAAS,eAAe,EACnC,KAAK,CAAC,MAAM,SAAS,sBAAsB,GAAG,SAAS,GAAG,SAAS,EAEnE,KAAK,EAAE,SAAS,CAAC,oBAAoB,CAAC,EACtC,IAAI,EAAE,KAAK,EACX,cAAc,CAAC,EAAE,MAAM,GACtB,MAAM,SAAS,sBAAsB,GACpC,WAAW,CAAC,MAAM,EAAE,wBAAwB,CAAC,KAAK,CAAC,CAAC,GACpD,WAAW,CAAC,SAAS,EAAE,wBAAwB,CAAC,KAAK,CAAC,CAAC,CAQ1D"}

package/dist/domain/componentSlotPrelude.d.ts

@@ -0,0 +1,3 @@
+/** @see MICROVERSE_LUA_COMPONENT_SLOT_PRELUDE */
+export declare const MICROVERSE_LUA_COMPONENT_SLOT_PRELUDE: string;
+//# sourceMappingURL=componentSlotPrelude.d.ts.map

package/dist/domain/componentSlotPrelude.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"componentSlotPrelude.d.ts","sourceRoot":"","sources":["../../src/domain/componentSlotPrelude.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,eAAO,MAAM,qCAAqC,QAyF1C,CAAC"}

package/dist/domain/hostSurfaceManifest.d.ts

@@ -1,8 +1,8 @@
 import { LuaDefManifest } from '@microverse.ts/lua-defs';
-import { HostSurfaceSpec, HostWorkflowHooksSpec } from './hostSurfaceTypes.js';
+import { HostSurfaceSpec, HostComponentHooksSpec } from './hostSurfaceTypes';
 export declare function buildLuaDefManifestFromHostSurfaceSpec(spec: HostSurfaceSpec, opts: {
     readonly output: string;
     readonly headerNote?: string | undefined;
     readonly luaTypeAliases?: Readonly<Record<string, string>> | undefined;
-}, workflowHooks?: HostWorkflowHooksSpec): LuaDefManifest;
+}, componentHooks?: HostComponentHooksSpec): LuaDefManifest;
 //# sourceMappingURL=hostSurfaceManifest.d.ts.map

package/dist/domain/hostSurfaceManifest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hostSurfaceManifest.d.ts","sourceRoot":"","sources":["../../src/domain/hostSurfaceManifest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EAMf,MAAM,yBAAyB,CAAC;AAGjC,OAAO,KAAK,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AA0DpF,wBAAgB,sCAAsC,CACpD,IAAI,EAAE,eAAe,EACrB,IAAI,EAAE;IACJ,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,cAAc,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC;CACxE,EACD,aAAa,CAAC,EAAE,qBAAqB,GACpC,cAAc,CAiGhB"}
+{"version":3,"file":"hostSurfaceManifest.d.ts","sourceRoot":"","sources":["../../src/domain/hostSurfaceManifest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EAMf,MAAM,yBAAyB,CAAC;AAGjC,OAAO,KAAK,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAwIlF,wBAAgB,sCAAsC,CACpD,IAAI,EAAE,eAAe,EACrB,IAAI,EAAE;IACJ,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,cAAc,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC;CACxE,EACD,cAAc,CAAC,EAAE,sBAAsB,GACtC,cAAc,CAsEhB"}

package/dist/domain/hostSurfaceTypes.d.ts

@@ -1,9 +1,10 @@
 import { LuaDefManifest } from '@microverse.ts/lua-defs';
+import { ScriptInstanceContext } from '@microverse.ts/runtime-core';
 import { DeclarativeBridgeDeclaration } from '@microverse.ts/runtime-bridge';
 import { CapabilityId } from '@microverse.ts/runtime-capabilities';
 import { z } from 'zod';
-import { SurfaceCapabilityString } from './surfaceCapabilityString.js';
-import { WithMicroverseCapabilityRegistry } from './capabilityRegistrySymbol.js';
+import { SurfaceCapabilityString } from './surfaceCapabilityString';
+import { WithMicroverseCapabilityRegistry } from './capabilityRegistrySymbol';
 /**
  * Context passed to every surface `handler`: your typed host plus the active Lua **slot key** (string form).
  *
@@ -13,6 +14,8 @@ export type HostFnContext<THost> = {
     readonly host: THost;
     /** Stable slot identifier for this sandbox (same convention as `DeclarativeBridgeDeclaration`). */
     readonly slotKey: string;
+    /** Mounted script instance identity (audit, logging). */
+    readonly script: ScriptInstanceContext;
 };
 /**
  * Strongly typed description of one bridge method (produced by the fluent `.method(…)` builder).
@@ -83,10 +86,10 @@ export type HostSurfaceSpecForHost<THost> = Readonly<{
     }>;
 }>;
 /**
- * Zod object schemas keyed by PascalCase event kind (`OrderPlaced` → Lua method `onOrderPlaced` on the handler from `workflow:extend()`).
- * Passed as the second argument to {@link defineHostSurface} to emit workflow hook typings into `.d.lua`.
+ * Zod object schemas keyed by PascalCase event kind (`OrderPlaced` → Lua method `onOrderPlaced` on the component from `component:extend()`).
+ * Passed to {@link SurfaceBuilder.componentHooks} to emit domain event typings into `.d.lua`.
  */
-export type HostWorkflowHooksSpec = Readonly<Record<string, z.ZodObject<any>>>;
+export type HostComponentHooksSpec = Readonly<Record<string, z.ZodObject<any>>>;
 /**
  * Bridge + manifest API shared by every {@link HostSurface} (with or without workflow hooks).
  *
@@ -123,12 +126,12 @@ export type HostSurfaceCore<TCapabilities extends CapabilityId = CapabilityId> =
 /**
  * Compiled host surface: bridge factories for `mergeEnv` plus manifest builder for `.d.lua` generation.
  *
- * @typeParam THooks - When you pass `workflowHooks` to {@link defineHostSurface}, the returned surface includes
- * `workflowHooks` so callers can type workflow events from the surface object alone.
+ * @typeParam THooks - When you pass `componentHooks` to {@link defineHostSurface}, the returned surface includes
+ * `componentHooks` so callers can type domain events from the surface object alone.
  * @typeParam TCapabilities - Capability ids declared on the surface (for script allowlists).
  */
-export type HostSurface<THooks extends HostWorkflowHooksSpec | undefined = undefined, TCapabilities extends CapabilityId = CapabilityId> = [undefined] extends [THooks] ? HostSurfaceCore<TCapabilities> : HostSurfaceCore<TCapabilities> & {
-    readonly workflowHooks: THooks;
+export type HostSurface<THooks extends HostComponentHooksSpec | undefined = undefined, TCapabilities extends CapabilityId = CapabilityId> = [undefined] extends [THooks] ? HostSurfaceCore<TCapabilities> : HostSurfaceCore<TCapabilities> & {
+    readonly componentHooks: THooks;
 };
 /** Options passed to {@link HostSurfaceCore.toLuaDefManifest}. */
 export type LuaDefManifestGeneratorOpts = Parameters<HostSurfaceCore['toLuaDefManifest']>[0];

package/dist/domain/hostSurfaceTypes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hostSurfaceTypes.d.ts","sourceRoot":"","sources":["../../src/domain/hostSurfaceTypes.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"hostSurfaceTypes.d.ts","sourceRoot":"","sources":["../../src/domain/hostSurfaceTypes.ts"],"names":[],"mappings":"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"}

package/dist/domain/luaGlobalHook.d.ts

@@ -1,6 +1,6 @@
 /**
  * Lua convention for domain hooks: PascalCase event kind → method name `on{Kind}` on the workflow
- * handler table from `workflow:extend()` in each Lua slot (e.g. `OrderPlaced` → `onOrderPlaced`).
+ * component table from `component:extend()` in each Lua slot (e.g. `OrderPlaced` → `onOrderPlaced`).
  */
 export type LuaGlobalHookName<Kind extends string> = `on${Kind}`;
 /**

package/dist/domain/scriptContextSymbol.d.ts

@@ -0,0 +1,6 @@
+import { ScriptInstanceContext } from '@microverse.ts/runtime-core';
+export declare const MICROVERSE_SCRIPT_CONTEXT: unique symbol;
+export type WithMicroverseScriptContext = {
+    readonly [MICROVERSE_SCRIPT_CONTEXT]?: ScriptInstanceContext | undefined;
+};
+//# sourceMappingURL=scriptContextSymbol.d.ts.map

package/dist/domain/scriptContextSymbol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scriptContextSymbol.d.ts","sourceRoot":"","sources":["../../src/domain/scriptContextSymbol.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAEzE,eAAO,MAAM,yBAAyB,eAAqC,CAAC;AAE5E,MAAM,MAAM,2BAA2B,GAAG;IACxC,QAAQ,CAAC,CAAC,yBAAyB,CAAC,CAAC,EAAE,qBAAqB,GAAG,SAAS,CAAC;CAC1E,CAAC"}

package/dist/domain/scriptPropertyMergeEnv.d.ts

@@ -0,0 +1,6 @@
+import { ScriptPropertyBag, ScriptPropertyValue } from '@microverse.ts/runtime-core';
+export declare function scriptPropertyBagToMergeEnv(bag: ScriptPropertyBag): Record<string, unknown>;
+export declare function scriptPropertyValueToPlain(value: ScriptPropertyValue): unknown;
+export declare function mergeEnvSinkToScriptPropertyBag(sink: Record<string, unknown>): ScriptPropertyBag;
+export declare function plainToScriptPropertyValue(value: unknown): ScriptPropertyValue | undefined;
+//# sourceMappingURL=scriptPropertyMergeEnv.d.ts.map

package/dist/domain/scriptPropertyMergeEnv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scriptPropertyMergeEnv.d.ts","sourceRoot":"","sources":["../../src/domain/scriptPropertyMergeEnv.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAE1F,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAM3F;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAa9E;AAED,wBAAgB,+BAA+B,CAC7C,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,iBAAiB,CASnB;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,GAAG,mBAAmB,GAAG,SAAS,CAgC1F"}

package/dist/domain/surfaceCapabilities.d.ts

@@ -1,5 +1,5 @@
 import { CapabilityId } from '@microverse.ts/runtime-capabilities';
-import { HostSurfaceMethodEntry, HostSurfaceSpec } from './hostSurfaceTypes.js';
+import { HostSurfaceMethodEntry, HostSurfaceSpec } from './hostSurfaceTypes';
 type InferMethodCapability<M> = M extends {
     readonly capability: infer C extends CapabilityId;
 } ? C : never;

package/dist/domain/surfaceCapabilities.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"surfaceCapabilities.d.ts","sourceRoot":"","sources":["../../src/domain/surfaceCapabilities.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AAExE,OAAO,KAAK,EAAwB,sBAAsB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE3G,KAAK,qBAAqB,CAAC,CAAC,IAAI,CAAC,SAAS;IAAE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,SAAS,YAAY,CAAA;CAAE,GAC3F,CAAC,GACD,KAAK,CAAC;AAEV,KAAK,uBAAuB,CAAC,CAAC,IAAI,CAAC,SAAS,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACzE,qBAAqB,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GACjC,KAAK,CAAC;AAEV;;;GAGG;AACH,MAAM,MAAM,wBAAwB,CAAC,KAAK,SAAS,eAAe,IAAI,uBAAuB,CAC3F,KAAK,CAAC,MAAM,KAAK,CAAC,CACnB,CAAC;AAEF,0EAA0E;AAC1E,wBAAgB,sCAAsC,CAAC,KAAK,CAAC,KAAK,SAAS,eAAe,EACxF,IAAI,EAAE,KAAK,GACV,SAAS,wBAAwB,CAAC,KAAK,CAAC,EAAE,CAgB5C;AAED,+EAA+E;AAC/E,wBAAgB,uBAAuB,CACrC,KAAK,CAAC,QAAQ,SAAS,SAAS,YAAY,EAAE,EAC9C,KAAK,CAAC,CAAC,SAAS,SAAS,GAAG,MAAM,IAAI,MAAM,EAAE,EAAE,EAEhD,mBAAmB,EAAE,QAAQ,EAC7B,GAAG,YAAY,EAAE,CAAC,GACjB,aAAa,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC,CAAC,CAUxD;AAED,kFAAkF;AAClF,MAAM,MAAM,sBAAsB,CAAC,IAAI,SAAS,YAAY,IAAI,sBAAsB,CACpF,OAAO,EACP,OAAO,EACP,OAAO,CACR,GAAG;IAAE,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAA;CAAE,CAAC"}
+{"version":3,"file":"surfaceCapabilities.d.ts","sourceRoot":"","sources":["../../src/domain/surfaceCapabilities.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AAExE,OAAO,KAAK,EAAwB,sBAAsB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAExG,KAAK,qBAAqB,CAAC,CAAC,IAAI,CAAC,SAAS;IAAE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,SAAS,YAAY,CAAA;CAAE,GAC3F,CAAC,GACD,KAAK,CAAC;AAEV,KAAK,uBAAuB,CAAC,CAAC,IAAI,CAAC,SAAS,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACzE,qBAAqB,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GACjC,KAAK,CAAC;AAEV;;;GAGG;AACH,MAAM,MAAM,wBAAwB,CAAC,KAAK,SAAS,eAAe,IAAI,uBAAuB,CAC3F,KAAK,CAAC,MAAM,KAAK,CAAC,CACnB,CAAC;AAEF,0EAA0E;AAC1E,wBAAgB,sCAAsC,CAAC,KAAK,CAAC,KAAK,SAAS,eAAe,EACxF,IAAI,EAAE,KAAK,GACV,SAAS,wBAAwB,CAAC,KAAK,CAAC,EAAE,CAgB5C;AAED,+EAA+E;AAC/E,wBAAgB,uBAAuB,CACrC,KAAK,CAAC,QAAQ,SAAS,SAAS,YAAY,EAAE,EAC9C,KAAK,CAAC,CAAC,SAAS,SAAS,GAAG,MAAM,IAAI,MAAM,EAAE,EAAE,EAEhD,mBAAmB,EAAE,QAAQ,EAC7B,GAAG,YAAY,EAAE,CAAC,GACjB,aAAa,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC,CAAC,CAUxD;AAED,kFAAkF;AAClF,MAAM,MAAM,sBAAsB,CAAC,IAAI,SAAS,YAAY,IAAI,sBAAsB,CACpF,OAAO,EACP,OAAO,EACP,OAAO,CACR,GAAG;IAAE,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAA;CAAE,CAAC"}

package/dist/domain/surfaceMethodDef.d.ts

@@ -1,6 +1,6 @@
 import { CapabilityId } from '@microverse.ts/runtime-capabilities';
 import { z } from 'zod';
-import { HostFnContext, HostSurfaceMethodEntry } from './hostSurfaceTypes.js';
+import { HostFnContext, HostSurfaceMethodEntry } from './hostSurfaceTypes';
 /**
  * Consumer-facing method definition for the fluent {@link SurfaceBuilder} API.
  * Use `requires: 'domain:action'` for the capability id.

package/dist/domain/surfaceMethodDef.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"surfaceMethodDef.d.ts","sourceRoot":"","sources":["../../src/domain/surfaceMethodDef.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,qCAAqC,CAAC;AAC5F,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAG7B,OAAO,KAAK,EAAE,aAAa,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAEnF;;;GAGG;AACH,MAAM,MAAM,gBAAgB,CAC1B,KAAK,EACL,GAAG,EACH,IAAI,EACJ,IAAI,SAAS,GAAG,MAAM,IAAI,MAAM,EAAE,GAAG,GAAG,MAAM,IAAI,MAAM,EAAE,IACxD;IACF,sEAAsE;IACtE,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,aAAa,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,GAAG,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClF,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,GAAG,CAAC,EAAE;QACb,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC;QAClE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KACvC,CAAC;CACH,CAAC;AAEF;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EACL,GAAG,EACH,IAAI,EACJ,KAAK,CAAC,IAAI,SAAS,GAAG,MAAM,IAAI,MAAM,EAAE,EAExC,GAAG,EAAE,gBAAgB,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,GAC5C,sBAAsB,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,YAAY,GAAG,IAAI,CAAC,CAW/D"}
+{"version":3,"file":"surfaceMethodDef.d.ts","sourceRoot":"","sources":["../../src/domain/surfaceMethodDef.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,qCAAqC,CAAC;AAC5F,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAG7B,OAAO,KAAK,EAAE,aAAa,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAEhF;;;GAGG;AACH,MAAM,MAAM,gBAAgB,CAC1B,KAAK,EACL,GAAG,EACH,IAAI,EACJ,IAAI,SAAS,GAAG,MAAM,IAAI,MAAM,EAAE,GAAG,GAAG,MAAM,IAAI,MAAM,EAAE,IACxD;IACF,sEAAsE;IACtE,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,aAAa,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,GAAG,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClF,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,GAAG,CAAC,EAAE;QACb,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC;QAClE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KACvC,CAAC;CACH,CAAC;AAEF;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EACL,GAAG,EACH,IAAI,EACJ,KAAK,CAAC,IAAI,SAAS,GAAG,MAAM,IAAI,MAAM,EAAE,EAExC,GAAG,EAAE,gBAAgB,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,GAC5C,sBAAsB,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,YAAY,GAAG,IAAI,CAAC,CAW/D"}

package/dist/index.d.ts

@@ -4,18 +4,22 @@
  *
  * @packageDocumentation
  */
-export { buildBridgeMergeEnvForHost, } from './infrastructure/builders/bridgeMergeEnv.js';
-export { BridgeBuilder, defineHostSurface, defineHostSurfaceFor, SurfaceBuilder, type AnyHostSurfaceMethod, type HostFnContext, type HostSurface, type HostSurfaceCore, type HostSurfaceMethodEntry, type HostSurfaceSpec, type HostSurfaceSpecForHost, type HostWorkflowHooksSpec, type LuaDefManifestGeneratorOpts, type SurfaceMethodDef, } from './infrastructure/builders/defineHostSurfaceFacade.js';
-export { compileHostSurface, compileHostSurfaceFor, } from './application/useCases/compileHostSurface.js';
-export { createBridgeDeclarationsFromHostSurfaceSpec } from './application/useCases/compileBridgeDeclarationsFromHostSurfaceSpec.js';
-export type { SchemaValidationPort } from './application/ports/SchemaValidationPort.js';
-export { HostScriptSession, type HostScriptSessionOptions, type WorkflowHookInvokeArgs, } from './infrastructure/components/hostScriptSession.js';
-export { luaGlobalHookName, type LuaGlobalHookName } from './domain/luaGlobalHook.js';
-export { luaType } from './domain/zodLuaType.js';
-export { zodToLuaTypeRef, type ZodToLuaTypeRefOptions } from './domain/zodToLuaTypeRef.js';
-export { MICROVERSE_CAPABILITY_REGISTRY, type WithMicroverseCapabilityRegistry } from './domain/capabilityRegistrySymbol.js';
-export { augmentHostWithCapabilityRegistry } from './infrastructure/adapters/augmentHostWithCapabilityRegistry.js';
-export type { InferSurfaceCapabilities } from './domain/surfaceCapabilities.js';
-export type { SurfaceCapabilityString } from './domain/surfaceCapabilityString.js';
-export { collectCapabilitiesFromHostSurfaceSpec, pickSurfaceCapabilities } from './domain/surfaceCapabilities.js';
+export { buildBridgeMergeEnvForHost, } from './infrastructure/builders/bridgeMergeEnv';
+export { BridgeBuilder, defineHostSurface, defineHostSurfaceFor, SurfaceBuilder, type AnyHostSurfaceMethod, type HostFnContext, type HostSurface, type HostSurfaceCore, type HostSurfaceMethodEntry, type HostSurfaceSpec, type HostSurfaceSpecForHost, type HostComponentHooksSpec, type LuaDefManifestGeneratorOpts, type SurfaceMethodDef, } from './infrastructure/builders/defineHostSurfaceFacade';
+export { compileHostSurface, compileHostSurfaceFor, } from './application/useCases/compileHostSurface';
+export { createBridgeDeclarationsFromHostSurfaceSpec } from './application/useCases/compileBridgeDeclarationsFromHostSurfaceSpec';
+export type { SchemaValidationPort } from './application/ports/SchemaValidationPort';
+export { HostScriptSession, type HostScriptSessionOptions, type ComponentEventHookInvokeArgs, } from './infrastructure/components/hostScriptSession';
+export { luaGlobalHookName, type LuaGlobalHookName } from './domain/luaGlobalHook';
+export { luaType } from './domain/zodLuaType';
+export { zodToLuaTypeRef, type ZodToLuaTypeRefOptions } from './domain/zodToLuaTypeRef';
+export { MICROVERSE_CAPABILITY_REGISTRY, type WithMicroverseCapabilityRegistry } from './domain/capabilityRegistrySymbol';
+export { augmentHostWithCapabilityRegistry } from './infrastructure/adapters/augmentHostWithCapabilityRegistry';
+export { augmentHostWithScriptContext } from './infrastructure/adapters/augmentHostWithScriptContext';
+export { MICROVERSE_LUA_COMPONENT_SLOT_PRELUDE } from './domain/componentSlotPrelude';
+export { mergeEnvSinkToScriptPropertyBag, scriptPropertyBagToMergeEnv, scriptPropertyValueToPlain, } from './domain/scriptPropertyMergeEnv';
+export { MICROVERSE_SCRIPT_CONTEXT, type WithMicroverseScriptContext } from './domain/scriptContextSymbol';
+export type { InferSurfaceCapabilities } from './domain/surfaceCapabilities';
+export type { SurfaceCapabilityString } from './domain/surfaceCapabilityString';
+export { collectCapabilitiesFromHostSurfaceSpec, pickSurfaceCapabilities } from './domain/surfaceCapabilities';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EACL,0BAA0B,GAC3B,MAAM,6CAA6C,CAAC;AACrD,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,oBAAoB,EACpB,cAAc,EACd,KAAK,oBAAoB,EACzB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC3B,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,2BAA2B,EAChC,KAAK,gBAAgB,GACtB,MAAM,sDAAsD,CAAC;AAC9D,OAAO,EACL,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,8CAA8C,CAAC;AACtD,OAAO,EAAE,2CAA2C,EAAE,MAAM,wEAAwE,CAAC;AACrI,YAAY,EAAE,oBAAoB,EAAE,MAAM,6CAA6C,CAAC;AACxF,OAAO,EACL,iBAAiB,EACjB,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,GAC5B,MAAM,kDAAkD,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,KAAK,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACtF,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,KAAK,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAC3F,OAAO,EAAE,8BAA8B,EAAE,KAAK,gCAAgC,EAAE,MAAM,sCAAsC,CAAC;AAC7H,OAAO,EAAE,iCAAiC,EAAE,MAAM,gEAAgE,CAAC;AACnH,YAAY,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAChF,YAAY,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AACnF,OAAO,EAAE,sCAAsC,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EACL,0BAA0B,GAC3B,MAAM,0CAA0C,CAAC;AAClD,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,oBAAoB,EACpB,cAAc,EACd,KAAK,oBAAoB,EACzB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC3B,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAC3B,KAAK,2BAA2B,EAChC,KAAK,gBAAgB,GACtB,MAAM,mDAAmD,CAAC;AAC3D,OAAO,EACL,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,2CAA2C,CAAC;AACnD,OAAO,EAAE,2CAA2C,EAAE,MAAM,qEAAqE,CAAC;AAClI,YAAY,EAAE,oBAAoB,EAAE,MAAM,0CAA0C,CAAC;AACrF,OAAO,EACL,iBAAiB,EACjB,KAAK,wBAAwB,EAC7B,KAAK,4BAA4B,GAClC,MAAM,+CAA+C,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,KAAK,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AACnF,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,KAAK,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AACxF,OAAO,EAAE,8BAA8B,EAAE,KAAK,gCAAgC,EAAE,MAAM,mCAAmC,CAAC;AAC1H,OAAO,EAAE,iCAAiC,EAAE,MAAM,6DAA6D,CAAC;AAChH,OAAO,EAAE,4BAA4B,EAAE,MAAM,wDAAwD,CAAC;AACtG,OAAO,EAAE,qCAAqC,EAAE,MAAM,+BAA+B,CAAC;AACtF,OAAO,EACL,+BAA+B,EAC/B,2BAA2B,EAC3B,0BAA0B,GAC3B,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,yBAAyB,EAAE,KAAK,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAC3G,YAAY,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AAC7E,YAAY,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAChF,OAAO,EAAE,sCAAsC,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC"}