@microverse.ts/host-surface 0.2.0 → 0.3.0

package/README.md

@@ -1,6 +1,6 @@
 # `@microverse.ts/host-surface`
 
-Declare a **host surface** in TypeScript: Zod schemas, capabilities, and handlers that compile into:
+Declare a **host surface** in TypeScript: Zod schemas, capabilities, component types, and handlers that compile into:
 
 1. **Runtime bridge tables** for `mergeEnv` (what Lua calls at execution time).
 2. A **`LuaDefManifest`** for `@microverse.ts/lua-defs` (`.d.lua` stubs for LuaLS).
@@ -16,6 +16,19 @@ import { defineHostSurfaceFor } from '@microverse.ts/microverse-lua';
 import { z } from 'zod';
 
 export default defineHostSurfaceFor<MyHost>()
+  .componentType('OrderEcho', {
+    extends: 'AuditOnly',
+    capabilities: ['orders:read', 'notifications:send'],
+    props: z.object({ label: z.string().optional() }),
+    state: z.object({}),
+    hooks: ['OrderPlaced'],
+  })
+  .componentType('AuditOnly', {
+    capabilities: ['audit:record'],
+    props: z.object({}),
+    state: z.object({}),
+    hooks: ['OrderPlaced'],
+  })
   .bridge('orders')
   .method('get', {
     requires: 'orders:read',
@@ -31,14 +44,15 @@ export default defineHostSurfaceFor<MyHost>()
 | Step | Role |
 |------|------|
 | `defineHostSurfaceFor<THost>()` | Start builder; `handler` receives typed `host`. |
-| `.bridge('orders')` | Bridge table on `self.bridges` after `component:extend()`. |
+| `.componentType(name, …)` | Declares props, state, capability set, and hook subset for Lua `Name:extend()`. |
+| `.bridge('orders')` | Bridge table on `self.bridges` after `OrderEcho:extend()` (only bridges allowed by the active type). |
 | `.method('get', { … })` | One bridge method: `requires`, `input`, `output`, `handler`. |
-| `.componentHooks(…)` | Optional Zod map → `on*` domain events on `Component`. |
-| `.build()` | Compiled {@link HostSurface}. |
+| `.componentHooks(…)` | Optional Zod map → `on*` domain events; each type lists which hooks it implements. |
+| `.build()` | Compiled {@link HostSurface} with `componentTypes` registry. |
 
-`requires` is a `domain:action` capability string. `async` is inferred from `async function` handlers.
+`requires` is a `domain:action` capability string on each bridge method. Each **component type** lists which capabilities its instances may use; runtime mounts only those bridges/methods on `self.bridges`. Disallowed bridges are **absent** (`nil` in Lua), not denied at call time.
 
-Bridges are **not** global in the slot: use `self.bridges.orders:get(…)` from component methods.
+Bridges are **not** global in the slot: use `self.bridges.orders:get(…)` from component methods after `YourType:extend()`.
 
 ### Host object
 
@@ -49,12 +63,22 @@ The **host** is your engine context (services, repos, config). It is not generat
 Call `.componentHooks({ OrderPlaced: z.object({ … }), … })` before `.build()`.
 
 - 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`.
+- Lua implements `onOrderPlaced` on the table from `OrderEcho:extend()` (when that type’s `hooks` includes `OrderPlaced`).
+- Manifest emits `MicroverseEvt_*` payload classes and per-type `on*` fields on `OrderEchoComponent` in `.d.lua`.
+
+### Component types and inheritance
+
+| Field | Rule |
+|-------|------|
+| `capabilities` | Union of parent + child (deduplicated). |
+| `props` / `state` | Zod `parent.extend(childShape)`. |
+| `hooks` | Union of parent + child hook names. |
+
+`extends` must reference another type on the same surface. Names must be unique; cycles are rejected at `build()`.
 
 ## `HostScriptSession`
 
-Lower-level API when you manage slots yourself (one session = one env slot + capability allowlist):
+Lower-level API when you manage slots yourself (one session = one env slot):
 
 ```ts
 const session = new HostScriptSession({
@@ -62,10 +86,10 @@ const session = new HostScriptSession({
   surface,
   host,
   slotKey: createLuaEnvSlotKey('script:my-id'),
-  allowedCapabilities: surface.pickCapabilities('orders:read'),
 });
 await session.openSession();
-await session.runChunk(luaSource);
+await session.runChunk(luaSource); // script must call YourType:extend() first
+await session.setProps({ … }); // validated against active type’s props schema
 ```
 
 `MicroverseLua` in `@microverse.ts/microverse-lua` wraps this for the common case (shared VM, script catalog + instances, broadcast hooks).
@@ -76,9 +100,15 @@ await session.runChunk(luaSource);
 microverse generate-lua-defs --surface src/mySurface.ts
 ```
 
-Requires `export default` of the compiled surface (`.build()` result). See [`@microverse.ts/cli`](../cli/README.md) and [`@microverse.ts/lua-defs`](../lua-defs/README.md).
+Requires `export default` of the compiled surface (`.build()` result). The manifest emits, per component type:
+
+- `AuditOnlyProps`, `AuditOnlyState`, `AuditOnlyBridges`
+- `AuditOnlyComponent` (with `on*` only for that type’s hooks)
+- `AuditOnly:extend() → AuditOnlyComponent` singleton stub
+
+See [`@microverse.ts/cli`](../cli/README.md) and [`@microverse.ts/lua-defs`](../lua-defs/README.md).
 
-Optional **Lua type names** on Zod schemas (`luaType('OrderDto', z.object({ … }))`) improve stub names—see `examples/business-scripting-engine/src/schemas/surface/bridgePayloads.ts`.
+Optional **Lua type names** on Zod schemas (`luaType('OrderDto', z.object({ … }))`) improve stub names—see bridge payload patterns in consumer surfaces (e.g. `examples/sorting-lab`).
 
 ## Async bridges and Lua patterns
 
@@ -86,9 +116,9 @@ Bridge handlers are **synchronous at the Lua boundary**; Wasmoon does not auto-r
 
 - [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)
+- Example: [`bubble_sort.lua`](../../examples/sorting-lab/lua/bubble_sort.lua)
 
 ## Reference
 
-- Example surface: [`examples/business-scripting-engine/src/businessSurface.ts`](../../examples/business-scripting-engine/src/businessSurface.ts)
+- Example surface: [`examples/sorting-lab/src/engine/sortingSurface.ts`](../../examples/sorting-lab/src/engine/sortingSurface.ts)
 - Tests: `src/domain/`, `src/application/`, `src/infrastructure/`

package/dist/application/ports/ScriptReferenceResolverPort.d.ts

@@ -0,0 +1,13 @@
+import { ScriptReferenceKind } from '@microverse.ts/runtime-core';
+export type ScriptReferenceWrapContext = {
+    readonly slotKey: string;
+    readonly field: string;
+    readonly raw: string | null;
+    readonly kind: ScriptReferenceKind;
+    readonly componentType?: string | undefined;
+};
+/** Host-provided wrapper for `self.references.*` (opaque Lua userdata/table). */
+export type ScriptReferenceResolverPort = {
+    readonly wrap: (ctx: ScriptReferenceWrapContext) => unknown;
+};
+//# sourceMappingURL=ScriptReferenceResolverPort.d.ts.map

package/dist/application/ports/ScriptReferenceResolverPort.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScriptReferenceResolverPort.d.ts","sourceRoot":"","sources":["../../../src/application/ports/ScriptReferenceResolverPort.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAEvE,MAAM,MAAM,0BAA0B,GAAG;IACvC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IACnC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7C,CAAC;AAEF,iFAAiF;AACjF,MAAM,MAAM,2BAA2B,GAAG;IACxC,QAAQ,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,0BAA0B,KAAK,OAAO,CAAC;CAC7D,CAAC"}

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

@@ -1,9 +1,9 @@
 import { DeclarativeBridgeDeclaration } from '@microverse.ts/runtime-bridge';
-import { WithMicroverseCapabilityRegistry } from '../../domain/capabilityRegistrySymbol';
-import { HostSurfaceSpec } from '../../domain/hostSurfaceTypes';
+import { WithMicroverseScriptContext } from '../../domain/scriptContextSymbol';
+import { HostSurfaceSpec } from '../../domain/hostSurfaceSpecTypes';
 import { SchemaValidationPort } from '../ports/SchemaValidationPort';
 /**
  * Builds declarative bridge declarations from a host surface spec, using the schema validation port for Lua ↔ host payloads.
  */
-export declare function createBridgeDeclarationsFromHostSurfaceSpec<TSpec extends HostSurfaceSpec>(schemaValidation: SchemaValidationPort, spec: TSpec): ReadonlyArray<DeclarativeBridgeDeclaration<WithMicroverseCapabilityRegistry, string>>;
+export declare function createBridgeDeclarationsFromHostSurfaceSpec<TSpec extends HostSurfaceSpec>(schemaValidation: SchemaValidationPort, spec: TSpec): ReadonlyArray<DeclarativeBridgeDeclaration<WithMicroverseScriptContext, string>>;
 //# sourceMappingURL=compileBridgeDeclarationsFromHostSurfaceSpec.d.ts.map

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,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"}
+{"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;AAKlF,OAAO,EAA6B,KAAK,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAE/G,OAAO,KAAK,EAAwB,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAC/F,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,2BAA2B,EAAE,MAAM,CAAC,CAAC,CAoDlF"}

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

@@ -1,13 +1,14 @@
+import { ComponentTypeDefRegistry } from '../../domain/componentTypeSpec';
 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 HostComponentHooksSpec>(ports: readonly [SchemaValidationPort], spec: TSpec, componentHooks: THooks): HostSurface<THooks, InferSurfaceCapabilities<TSpec>>;
+export declare function compileHostSurface<const TSpec extends HostSurfaceSpec>(ports: readonly [SchemaValidationPort], spec: TSpec, componentTypeRegistry: ComponentTypeDefRegistry): HostSurface<undefined, InferSurfaceCapabilities<TSpec>>;
+export declare function compileHostSurface<const TSpec extends HostSurfaceSpec, const THooks extends HostComponentHooksSpec>(ports: readonly [SchemaValidationPort], spec: TSpec, componentTypeRegistry: ComponentTypeDefRegistry, 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 HostComponentHooksSpec | undefined = undefined>(ports: readonly [SchemaValidationPort], spec: TSpec, componentHooks?: THooks): THooks extends HostComponentHooksSpec ? 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, componentTypeRegistry: ComponentTypeDefRegistry, 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,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"}
+{"version":3,"file":"compileHostSurface.d.ts","sourceRoot":"","sources":["../../../src/application/useCases/compileHostSurface.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAK/E,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;AAoC1E;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,CAAC,KAAK,SAAS,eAAe,EACpE,KAAK,EAAE,SAAS,CAAC,oBAAoB,CAAC,EACtC,IAAI,EAAE,KAAK,EACX,qBAAqB,EAAE,wBAAwB,GAC9C,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,qBAAqB,EAAE,wBAAwB,EAC/C,cAAc,EAAE,MAAM,GACrB,WAAW,CAAC,MAAM,EAAE,wBAAwB,CAAC,KAAK,CAAC,CAAC,CAAC;AAexD;;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,qBAAqB,EAAE,wBAAwB,EAC/C,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

@@ -1,3 +1,11 @@
+import { ResolvedScriptProfileRegistry } from './scriptProfileSpec';
 /** @see MICROVERSE_LUA_COMPONENT_SLOT_PRELUDE */
 export declare const MICROVERSE_LUA_COMPONENT_SLOT_PRELUDE: string;
+/** Lua prelude that registers `TypeName:extend()` singletons for each component type. */
+export declare function profileBridgeSlotKey(typeName: string, bridgeName: string): string;
+export declare function profileBridgeNamesMergeEnvKey(typeName: string): string;
+export declare function buildComponentTypeBridgeNamesPreludeLua(componentTypes: ResolvedScriptProfileRegistry): string;
+export declare function buildComponentTypeSingletonsPreludeLua(typeNames: readonly string[]): string;
+/** Applies host-selected profile (same as `Type:extend()` without requiring Lua to call it). */
+export declare function buildApplyHostScriptProfileChunkLua(profileName: string): string;
 //# sourceMappingURL=componentSlotPrelude.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"componentSlotPrelude.d.ts","sourceRoot":"","sources":["../../src/domain/componentSlotPrelude.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,eAAO,MAAM,qCAAqC,QAyF1C,CAAC"}
+{"version":3,"file":"componentSlotPrelude.d.ts","sourceRoot":"","sources":["../../src/domain/componentSlotPrelude.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,qBAAqB,CAAC;AAEzE,iDAAiD;AACjD,eAAO,MAAM,qCAAqC,QAiF1C,CAAC;AAET,yFAAyF;AACzF,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAEjF;AAED,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED,wBAAgB,uCAAuC,CACrD,cAAc,EAAE,6BAA6B,GAC5C,MAAM,CAaR;AAED,wBAAgB,sCAAsC,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAuC3F;AAED,gGAAgG;AAChG,wBAAgB,mCAAmC,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAU/E"}

package/dist/domain/componentTypeSpec.d.ts

@@ -0,0 +1,12 @@
+import { ScriptProfileDefInput } from '@microverse.ts/runtime-core';
+import { z } from 'zod';
+import { HostComponentHooksSpec, HostSurfaceSpec } from './hostSurfaceSpecTypes';
+import { ScriptProfileDefRegistry } from './scriptProfileSpec';
+/** Fluent input for {@link SurfaceBuilder.componentType} (requires `state`; catalog profiles may omit it). */
+export type ComponentTypeDefInput<TCap extends `${string}:${string}` = `${string}:${string}`, THooks extends HostComponentHooksSpec | undefined = undefined> = ScriptProfileDefInput<TCap> & {
+    readonly state: z.ZodObject<z.ZodRawShape>;
+    readonly hooks?: THooks extends HostComponentHooksSpec ? readonly (keyof THooks & string)[] : readonly string[] | undefined;
+};
+export type ComponentTypeDefRegistry = ScriptProfileDefRegistry;
+export declare function validateComponentTypeRegistry(registry: ComponentTypeDefRegistry, spec: HostSurfaceSpec, componentHooks?: HostComponentHooksSpec): void;
+//# sourceMappingURL=componentTypeSpec.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"componentTypeSpec.d.ts","sourceRoot":"","sources":["../../src/domain/componentTypeSpec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACzE,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,OAAO,KAAK,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACtF,OAAO,EAEL,KAAK,wBAAwB,EAC9B,MAAM,qBAAqB,CAAC;AAE7B,8GAA8G;AAC9G,MAAM,MAAM,qBAAqB,CAC/B,IAAI,SAAS,GAAG,MAAM,IAAI,MAAM,EAAE,GAAG,GAAG,MAAM,IAAI,MAAM,EAAE,EAC1D,MAAM,SAAS,sBAAsB,GAAG,SAAS,GAAG,SAAS,IAC3D,qBAAqB,CAAC,IAAI,CAAC,GAAG;IAChC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;IAC3C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,SAAS,sBAAsB,GAClD,SAAS,CAAC,MAAM,MAAM,GAAG,MAAM,CAAC,EAAE,GAClC,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG,wBAAwB,CAAC;AAEhE,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,wBAAwB,EAClC,IAAI,EAAE,eAAe,EACrB,cAAc,CAAC,EAAE,sBAAsB,GACtC,IAAI,CAEN"}

package/dist/domain/hostSurfaceManifest.d.ts

@@ -1,8 +1,9 @@
 import { LuaDefManifest } from '@microverse.ts/lua-defs';
-import { HostSurfaceSpec, HostComponentHooksSpec } from './hostSurfaceTypes';
+import { ResolvedScriptProfileRegistry } from './scriptProfileSpec';
+import { HostComponentHooksSpec, HostSurfaceSpec } from './hostSurfaceSpecTypes';
 export declare function buildLuaDefManifestFromHostSurfaceSpec(spec: HostSurfaceSpec, opts: {
     readonly output: string;
     readonly headerNote?: string | undefined;
     readonly luaTypeAliases?: Readonly<Record<string, string>> | undefined;
-}, componentHooks?: HostComponentHooksSpec): LuaDefManifest;
+}, componentHooks?: HostComponentHooksSpec, componentTypes?: ResolvedScriptProfileRegistry): 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,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"}
+{"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,EAML,KAAK,6BAA6B,EACnC,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAkMtF,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,EACvC,cAAc,CAAC,EAAE,6BAA6B,GAC7C,cAAc,CAuEhB"}

package/dist/domain/hostSurfaceSpecTypes.d.ts

@@ -0,0 +1,89 @@
+import { ScriptInstanceContext } from '@microverse.ts/runtime-core';
+import { CapabilityId } from '@microverse.ts/runtime-capabilities';
+import { z } from 'zod';
+/**
+ * Context passed to every surface `handler`: your typed host plus the active Lua **slot key** (string form).
+ *
+ * @typeParam THost - Host services / world object you declare for bridge handlers.
+ */
+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).
+ * TypeScript checks `handler` against `input` / `output` schemas.
+ *
+ * @typeParam THost - Host type available as `ctx.host` inside `handler`.
+ * @typeParam TIn - Payload type after Zod `input` parsing (Lua calls the bridge with one table argument).
+ * @typeParam TOut - Return type validated by Zod `output` before crossing back to Lua.
+ * @typeParam TCap - Capability id for this method (from fluent `requires: 'domain:action'`).
+ */
+export type HostSurfaceMethodEntry<THost, TIn, TOut, TCap extends CapabilityId = CapabilityId> = {
+    /** Capability required to invoke this method; checked against the session registry before the handler runs. */
+    readonly capability: TCap;
+    /** Zod schema for the single payload object from Lua (e.g. `z.object({ id: z.string() })`). */
+    readonly input: z.ZodType<TIn>;
+    /** Zod schema for the value returned to Lua. */
+    readonly output: z.ZodType<TOut>;
+    /**
+     * Host logic at the Lua↔JS boundary. May return `Promise<TOut>`; Lua must use `:await()` on the returned handle
+     * or pass an `onComplete` callback as the second argument (see `MICROVERSE_LUA_SLOT_VM_BOOTSTRAP` in `@microverse.ts/runtime-wasm`).
+     */
+    readonly handler: (ctx: HostFnContext<THost>, input: TIn) => TOut | Promise<TOut>;
+    /**
+     * When true, manifest and Lua runtime treat this method as async (`MethodHandle` + optional `onComplete`).
+     * Set automatically for `async function` handlers in the fluent builder.
+     */
+    readonly async?: boolean | undefined;
+    /** Optional description emitted into the LuaCATS manifest. */
+    readonly description?: string | undefined;
+    /**
+     * Advanced escape hatch for manifest emission. Prefer registering Zod schemas with {@link luaType}
+     * (see `bridgePayloads` in the business example) so `.d.lua` stays inferred from `input` / `output`.
+     * Does not replace async bridge typing (`async: true` emits handle + `onComplete` in `.d.lua`).
+     * `paramTypes` keys must match `input` object keys (or `value` for non-object inputs).
+     */
+    readonly lua?: {
+        readonly paramTypes?: Partial<Record<string, string>> | undefined;
+        readonly returns?: string | undefined;
+    };
+};
+/**
+ * Erased method entry stored inside a {@link HostSurfaceSpec}. Assignability widens at the spec boundary.
+ */
+export type AnyHostSurfaceMethod = {
+    readonly capability: CapabilityId;
+    readonly input: z.ZodTypeAny;
+    readonly output: z.ZodTypeAny;
+    readonly handler: (ctx: HostFnContext<any>, input: any) => unknown;
+    readonly async?: boolean | undefined;
+    readonly description?: string | undefined;
+    readonly lua?: {
+        readonly paramTypes?: Partial<Record<string, string>> | undefined;
+        readonly returns?: string | undefined;
+    };
+};
+/**
+ * Tree shape accepted by {@link defineHostSurface}: top-level keys become Lua global bridge **tables**
+ * (e.g. `orders`, `billing`); inner keys become **methods** on that table.
+ */
+export type HostSurfaceSpec = Readonly<Record<string, Readonly<Record<string, AnyHostSurfaceMethod | HostSurfaceMethodEntry<any, any, any, any>>>>>;
+/**
+ * Surface spec where every method entry uses the same host type as your engine context
+ * (the `THost` you pass as `host` into {@link HostScriptSession}).
+ */
+export type HostSurfaceSpecForHost<THost> = Readonly<{
+    readonly [bridge: string]: Readonly<{
+        readonly [method: string]: HostSurfaceMethodEntry<THost, any, any, any>;
+    }>;
+}>;
+/**
+ * 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 HostComponentHooksSpec = Readonly<Record<string, z.ZodObject<any>>>;
+//# sourceMappingURL=hostSurfaceSpecTypes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hostSurfaceSpecTypes.d.ts","sourceRoot":"","sources":["../../src/domain/hostSurfaceSpecTypes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AACxE,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B;;;;GAIG;AACH,MAAM,MAAM,aAAa,CAAC,KAAK,IAAI;IACjC,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,mGAAmG;IACnG,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,yDAAyD;IACzD,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC;CACxC,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,MAAM,sBAAsB,CAChC,KAAK,EACL,GAAG,EACH,IAAI,EACJ,IAAI,SAAS,YAAY,GAAG,YAAY,IACtC;IACF,+GAA+G;IAC/G,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC;IAC1B,+FAA+F;IAC/F,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC/B,gDAAgD;IAChD,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,aAAa,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,GAAG,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClF;;;OAGG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACrC,8DAA8D;IAC9D,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C;;;;;OAKG;IACH,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,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,CAAC,UAAU,EAAE,YAAY,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,UAAU,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,aAAa,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,GAAG,KAAK,OAAO,CAAC;IACnE,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;;;GAGG;AAEH,MAAM,MAAM,eAAe,GAAG,QAAQ,CACpC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,oBAAoB,GAAG,sBAAsB,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAC5G,CAAC;AAGF;;;GAGG;AAEH,MAAM,MAAM,sBAAsB,CAAC,KAAK,IAAI,QAAQ,CAAC;IACnD,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAC;QAClC,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAG,sBAAsB,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;KACzE,CAAC,CAAC;CACJ,CAAC,CAAC;AAGH;;;GAGG;AAEH,MAAM,MAAM,sBAAsB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC"}

package/dist/domain/hostSurfaceTypes.d.ts

@@ -1,106 +1,27 @@
 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 { ResolvedScriptProfile, ResolvedScriptProfileRegistry } from './scriptProfileSpec';
 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).
- *
- * @typeParam THost - Host services / world object you declare for bridge handlers.
- */
-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).
- * TypeScript checks `handler` against `input` / `output` schemas.
- *
- * @typeParam THost - Host type available as `ctx.host` inside `handler`.
- * @typeParam TIn - Payload type after Zod `input` parsing (Lua calls the bridge with one table argument).
- * @typeParam TOut - Return type validated by Zod `output` before crossing back to Lua.
- * @typeParam TCap - Capability id for this method (from fluent `requires: 'domain:action'`).
- */
-export type HostSurfaceMethodEntry<THost, TIn, TOut, TCap extends CapabilityId = CapabilityId> = {
-    /** Capability required to invoke this method; checked against the session registry before the handler runs. */
-    readonly capability: TCap;
-    /** Zod schema for the single payload object from Lua (e.g. `z.object({ id: z.string() })`). */
-    readonly input: z.ZodType<TIn>;
-    /** Zod schema for the value returned to Lua. */
-    readonly output: z.ZodType<TOut>;
-    /**
-     * Host logic at the Lua↔JS boundary. May return `Promise<TOut>`; Lua must use `:await()` on the returned handle
-     * or pass an `onComplete` callback as the second argument (see `MICROVERSE_LUA_SLOT_VM_BOOTSTRAP` in `@microverse.ts/runtime-wasm`).
-     */
-    readonly handler: (ctx: HostFnContext<THost>, input: TIn) => TOut | Promise<TOut>;
-    /**
-     * When true, manifest and Lua runtime treat this method as async (`MethodHandle` + optional `onComplete`).
-     * Set automatically for `async function` handlers in the fluent builder.
-     */
-    readonly async?: boolean | undefined;
-    /** Optional description emitted into the LuaCATS manifest. */
-    readonly description?: string | undefined;
-    /**
-     * Advanced escape hatch for manifest emission. Prefer registering Zod schemas with {@link luaType}
-     * (see `bridgePayloads` in the business example) so `.d.lua` stays inferred from `input` / `output`.
-     * Does not replace async bridge typing (`async: true` emits handle + `onComplete` in `.d.lua`).
-     * `paramTypes` keys must match `input` object keys (or `value` for non-object inputs).
-     */
-    readonly lua?: {
-        readonly paramTypes?: Partial<Record<string, string>> | undefined;
-        readonly returns?: string | undefined;
-    };
-};
-/**
- * Erased method entry stored inside a {@link HostSurfaceSpec}. Assignability widens at the spec boundary.
- */
-export type AnyHostSurfaceMethod = {
-    readonly capability: CapabilityId;
-    readonly input: z.ZodTypeAny;
-    readonly output: z.ZodTypeAny;
-    readonly handler: (ctx: HostFnContext<any>, input: any) => unknown;
-    readonly async?: boolean | undefined;
-    readonly description?: string | undefined;
-    readonly lua?: {
-        readonly paramTypes?: Partial<Record<string, string>> | undefined;
-        readonly returns?: string | undefined;
-    };
-};
-/**
- * Tree shape accepted by {@link defineHostSurface}: top-level keys become Lua global bridge **tables**
- * (e.g. `orders`, `billing`); inner keys become **methods** on that table.
- */
-export type HostSurfaceSpec = Readonly<Record<string, Readonly<Record<string, AnyHostSurfaceMethod | HostSurfaceMethodEntry<any, any, any, any>>>>>;
-/**
- * Surface spec where every method entry uses the same host type as your engine context
- * (the `THost` you pass as `host` into {@link HostScriptSession}).
- */
-export type HostSurfaceSpecForHost<THost> = Readonly<{
-    readonly [bridge: string]: Readonly<{
-        readonly [method: string]: HostSurfaceMethodEntry<THost, any, any, any>;
-    }>;
-}>;
-/**
- * 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 HostComponentHooksSpec = Readonly<Record<string, z.ZodObject<any>>>;
+import { WithMicroverseScriptContext } from './scriptContextSymbol';
+import { HostComponentHooksSpec, HostSurfaceSpec } from './hostSurfaceSpecTypes';
+export type { AnyHostSurfaceMethod, HostComponentHooksSpec, HostFnContext, HostSurfaceMethodEntry, HostSurfaceSpec, HostSurfaceSpecForHost, } from './hostSurfaceSpecTypes';
 /**
  * Bridge + manifest API shared by every {@link HostSurface} (with or without workflow hooks).
  *
  * @typeParam TCapabilities - Union of capability ids declared on the surface spec (see {@link InferSurfaceCapabilities}).
  */
 export type HostSurfaceCore<TCapabilities extends CapabilityId = CapabilityId> = {
+    /** Internal bridge/method tree (for profile filtering and manifest). */
+    readonly getHostSurfaceSpec: () => HostSurfaceSpec;
     /**
      * Declarative bridge declarations compatible with {@link buildDeclarativeBridgeTable}.
-     * The host must satisfy {@link WithMicroverseCapabilityRegistry} (see {@link HostScriptSession}).
      */
-    readonly toBridgeDeclarations: () => ReadonlyArray<DeclarativeBridgeDeclaration<WithMicroverseCapabilityRegistry, string>>;
+    readonly toBridgeDeclarations: () => ReadonlyArray<DeclarativeBridgeDeclaration<WithMicroverseScriptContext, string>>;
+    /** Resolved script profiles declared via `.componentType()`. */
+    readonly componentTypes: ResolvedScriptProfileRegistry;
+    /** Lookup a script profile by name (throws if unknown). */
+    readonly getComponentType: (name: string) => ResolvedScriptProfile;
     /**
      * Builds a `LuaDefManifest` for `@microverse.ts/lua-defs` (`buildLuaCatsDocument`, `generateDefs`, CLI).
      *

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":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,+BAA+B,CAAC;AAClF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AAExE,OAAO,KAAK,EACV,qBAAqB,EACrB,6BAA6B,EAC9B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AAEzE,YAAY,EACV,oBAAoB,EACpB,sBAAsB,EACtB,aAAa,EACb,sBAAsB,EACtB,eAAe,EACf,sBAAsB,GACvB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,KAAK,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEtF;;;;GAIG;AACH,MAAM,MAAM,eAAe,CAAC,aAAa,SAAS,YAAY,GAAG,YAAY,IAAI;IAC/E,wEAAwE;IACxE,QAAQ,CAAC,kBAAkB,EAAE,MAAM,eAAe,CAAC;IACnD;;OAEG;IACH,QAAQ,CAAC,oBAAoB,EAAE,MAAM,aAAa,CAChD,4BAA4B,CAAC,2BAA2B,EAAE,MAAM,CAAC,CAClE,CAAC;IACF,gEAAgE;IAChE,QAAQ,CAAC,cAAc,EAAE,6BAA6B,CAAC;IACvD,2DAA2D;IAC3D,QAAQ,CAAC,gBAAgB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,qBAAqB,CAAC;IACnE;;;;;;OAMG;IACH,QAAQ,CAAC,gBAAgB,EAAE,CAAC,IAAI,EAAE;QAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QACzC;;WAEG;QACH,QAAQ,CAAC,cAAc,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC;KACxE,KAAK,cAAc,CAAC;IACrB,iFAAiF;IACjF,QAAQ,CAAC,YAAY,EAAE,SAAS,aAAa,EAAE,CAAC;IAChD;;OAEG;IACH,gBAAgB,CAAC,KAAK,CAAC,CAAC,SAAS,SAAS,uBAAuB,CAAC,aAAa,CAAC,EAAE,EAChF,GAAG,YAAY,EAAE,CAAC,GACjB,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC;CACrD,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,CACrB,MAAM,SAAS,sBAAsB,GAAG,SAAS,GAAG,SAAS,EAC7D,aAAa,SAAS,YAAY,GAAG,YAAY,IAC/C,CAAC,SAAS,CAAC,SAAS,CAAC,MAAM,CAAC,GAC5B,eAAe,CAAC,aAAa,CAAC,GAC9B,eAAe,CAAC,aAAa,CAAC,GAAG;IAAE,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzE,kEAAkE;AAClE,MAAM,MAAM,2BAA2B,GAAG,UAAU,CAAC,eAAe,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC"}

package/dist/domain/safeObjectKey.d.ts

@@ -1,7 +1,7 @@
 /**
  * Rejects bridge/method names that could trigger prototype pollution when used as object keys.
  */
-export declare function assertSafeObjectKey(kind: 'bridge' | 'method', name: string): void;
+export declare function assertSafeObjectKey(kind: 'bridge' | 'method' | 'componentType', name: string): void;
 /** Record with no inherited prototype — safe for dynamic string keys at runtime. */
 export declare function createNullPrototypeRecord<T extends object>(): T;
 //# sourceMappingURL=safeObjectKey.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"safeObjectKey.d.ts","sourceRoot":"","sources":["../../src/domain/safeObjectKey.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAIjF;AAED,oFAAoF;AACpF,wBAAgB,yBAAyB,CAAC,CAAC,SAAS,MAAM,KAAK,CAAC,CAE/D"}
+{"version":3,"file":"safeObjectKey.d.ts","sourceRoot":"","sources":["../../src/domain/safeObjectKey.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,eAAe,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAInG;AAED,oFAAoF;AACpF,wBAAgB,yBAAyB,CAAC,CAAC,SAAS,MAAM,KAAK,CAAC,CAE/D"}

package/dist/domain/scriptCatalogManifest.d.ts

@@ -0,0 +1,14 @@
+import { LuaDefManifest } from '@microverse.ts/lua-defs';
+export type ScriptCatalogEntry = {
+    readonly scriptId: string;
+    readonly profileId: string;
+    /**
+     * When true, the script's `.lua` file defines `---@class …ScriptComponent` (e.g. script-local methods).
+     * Omit the catalog `---@alias` so LuaLS does not report duplicate-doc-alias.
+     */
+    readonly localComponentClass?: boolean | undefined;
+};
+/** LuaCATS aliases per catalog scriptId → resolved component class (for `---@type` in `.lua` files). */
+export declare function buildScriptCatalogLuaDefManifest(entries: readonly ScriptCatalogEntry[]): LuaDefManifest;
+export declare function scriptCatalogComponentAlias(scriptId: string): string;
+//# sourceMappingURL=scriptCatalogManifest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scriptCatalogManifest.d.ts","sourceRoot":"","sources":["../../src/domain/scriptCatalogManifest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAiB,MAAM,yBAAyB,CAAC;AAI7E,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B;;;OAGG;IACH,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACpD,CAAC;AAEF,wGAAwG;AACxG,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,SAAS,kBAAkB,EAAE,GACrC,cAAc,CAsBhB;AAED,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGpE"}

package/dist/domain/scriptProfileSpec.d.ts

@@ -0,0 +1,31 @@
+import { CapabilityId } from '@microverse.ts/runtime-capabilities';
+import { ScriptProfileDefInput } from '@microverse.ts/runtime-core';
+import { z } from 'zod';
+import { HostComponentHooksSpec, HostSurfaceSpec } from './hostSurfaceSpecTypes';
+export type ScriptProfileDefRegistry = Readonly<Record<string, ScriptProfileDefInput>>;
+export type ResolvedScriptProfile = {
+    readonly name: string;
+    readonly extends?: string | undefined;
+    readonly capabilities: readonly CapabilityId[];
+    readonly props: z.ZodObject<z.ZodRawShape>;
+    readonly state: z.ZodObject<z.ZodRawShape>;
+    readonly hooks: readonly string[];
+    readonly bridgeNames: readonly string[];
+    readonly references?: ScriptProfileDefInput['references'];
+};
+export type ResolvedScriptProfileRegistry = Readonly<Record<string, ResolvedScriptProfile>>;
+declare const EMPTY_PROPS: z.ZodObject<z.ZodRawShape>;
+declare const EMPTY_STATE: z.ZodObject<z.ZodRawShape>;
+export declare function scriptProfileComponentClassName(profileName: string): string;
+export declare function scriptProfilePropsAlias(profileName: string): string;
+export declare function scriptProfileStateAlias(profileName: string): string;
+export declare function scriptProfileBridgesClassName(profileName: string): string;
+/** Bridge table names whose methods include at least one capability from the profile. */
+export declare function bridgeNamesForCapabilities(spec: HostSurfaceSpec, capabilities: readonly CapabilityId[]): readonly string[];
+export declare function resolveScriptProfile(registry: ScriptProfileDefRegistry, name: string, spec: HostSurfaceSpec): ResolvedScriptProfile;
+export declare function buildResolvedScriptProfileRegistry(registry: ScriptProfileDefRegistry, spec: HostSurfaceSpec): ResolvedScriptProfileRegistry;
+export declare function validateScriptProfileRegistry(registry: ScriptProfileDefRegistry, spec: HostSurfaceSpec, componentHooks?: HostComponentHooksSpec, opts?: {
+    readonly requireAtLeastOne?: boolean | undefined;
+}): void;
+export { EMPTY_PROPS, EMPTY_STATE };
+//# sourceMappingURL=scriptProfileSpec.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scriptProfileSpec.d.ts","sourceRoot":"","sources":["../../src/domain/scriptProfileSpec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,qCAAqC,CAAC;AAC5F,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACzE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAItF,MAAM,MAAM,wBAAwB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC,CAAC;AAEvF,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,YAAY,EAAE,SAAS,YAAY,EAAE,CAAC;IAC/C,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;IAC3C,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;IAC3C,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,UAAU,CAAC,EAAE,qBAAqB,CAAC,YAAY,CAAC,CAAC;CAC3D,CAAC;AAEF,MAAM,MAAM,6BAA6B,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC,CAAC;AAE5F,QAAA,MAAM,WAAW,EAAmB,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;AAC/D,QAAA,MAAM,WAAW,EAAmB,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;AAE/D,wBAAgB,+BAA+B,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE3E;AAED,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED,wBAAgB,6BAA6B,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEzE;AAED,yFAAyF;AACzF,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,eAAe,EACrB,YAAY,EAAE,SAAS,YAAY,EAAE,GACpC,SAAS,MAAM,EAAE,CAcnB;AAED,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,wBAAwB,EAClC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,eAAe,GACpB,qBAAqB,CAqDvB;AAED,wBAAgB,kCAAkC,CAChD,QAAQ,EAAE,wBAAwB,EAClC,IAAI,EAAE,eAAe,GACpB,6BAA6B,CAM/B;AAED,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,wBAAwB,EAClC,IAAI,EAAE,eAAe,EACrB,cAAc,CAAC,EAAE,sBAAsB,EACvC,IAAI,CAAC,EAAE;IAAE,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;CAAE,GAC1D,IAAI,CA6CN;AAED,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC"}

package/dist/domain/surfaceCapabilities.d.ts

@@ -1,5 +1,5 @@
 import { CapabilityId } from '@microverse.ts/runtime-capabilities';
-import { HostSurfaceMethodEntry, HostSurfaceSpec } from './hostSurfaceTypes';
+import { HostSurfaceMethodEntry, HostSurfaceSpec } from './hostSurfaceSpecTypes';
 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,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"}
+{"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,wBAAwB,CAAC;AAE5G,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';
+import { HostFnContext, HostSurfaceMethodEntry } from './hostSurfaceSpecTypes';
 /**
  * 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,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"}
+{"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,wBAAwB,CAAC;AAEpF;;;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"}