@microverse.ts/host-surface 0.2.0 → 0.3.0

package/dist/infrastructure/components/hostScriptSession.d.ts

@@ -1,7 +1,9 @@
-import { CapabilityId, InMemoryCapabilityRegistry } from '@microverse.ts/runtime-capabilities';
 import { Result } from '@microverse.ts/shared';
 import { z } from 'zod';
 import { ExecutionFailure, RunScriptResult, MicroverseId, MicroverseRuntime, ScriptAuditEvent, ScriptInstanceContext, ScriptPropertyBag, ScriptPropertyValue, TimeoutPolicy } from '@microverse.ts/runtime-core';
+import { SchemaValidationPort } from '../../application/ports/SchemaValidationPort';
+import { ScriptReferenceResolverPort } from '../../application/ports/ScriptReferenceResolverPort';
+import { ResolvedScriptProfile } from '../../domain/scriptProfileSpec';
 import { HostSurface, HostComponentHooksSpec } from '../../domain/hostSurfaceTypes';
 import { LuaGlobalHookName } from '../../domain/luaGlobalHook';
 export type ComponentEventHookInvokeArgs<TH extends HostComponentHooksSpec> = {
@@ -13,25 +15,37 @@ export type HostScriptSessionOptions<THost, THooks extends HostComponentHooksSpe
     readonly surface: HostSurface<THooks>;
     readonly host: THost;
     readonly slotKey: MicroverseId;
-    readonly allowedCapabilities: readonly CapabilityId[];
     readonly defaultTimeout?: TimeoutPolicy | undefined;
     readonly script: ScriptInstanceContext;
+    /** Host-selected script profile (surface component type name). Applied at openSession before the main chunk. */
+    readonly profileId?: string | undefined;
+    /** When set, used instead of {@link HostSurfaceCore.getComponentType} (inline catalog profiles). */
+    readonly resolvedProfile?: ResolvedScriptProfile | undefined;
+    /** Lua singleton global for `Type:extend()` (e.g. `SortingAlgorithm`). Defaults to `profileId`. */
+    readonly profileSingleton?: string | undefined;
     readonly enableComponentRuntime?: boolean | undefined;
-    readonly propsSchema?: z.ZodObject<z.ZodRawShape> | undefined;
+    readonly schemaValidation?: SchemaValidationPort | undefined;
+    readonly referenceResolver?: ScriptReferenceResolverPort | undefined;
     readonly onScriptAudit?: ((event: ScriptAuditEvent) => void) | undefined;
 };
 export declare class HostScriptSession<THost, THooks extends HostComponentHooksSpec | undefined = undefined> {
     private readonly opts;
     private sandbox;
     private readonly hostProps;
-    private readonly registry;
+    private readonly schemaValidation;
+    private activeComponentType;
+    private hostProfileApplied;
     readonly context: ScriptInstanceContext;
     constructor(opts: HostScriptSessionOptions<THost, THooks>);
     readonly openSession: () => Promise<void>;
-    readonly getCapabilityRegistry: () => InMemoryCapabilityRegistry;
     private requireMicroverseSlot;
     private mergeEnv;
+    private wrapReference;
     private emitAudit;
+    private getActiveProfileName;
+    private profileSingletonName;
+    private singletonTypeNames;
+    private tryGetActiveProfile;
     private validatePropsBag;
     readonly getProps: () => Readonly<ScriptPropertyBag>;
     readonly setProps: (bag: ScriptPropertyBag) => Promise<void>;
@@ -44,6 +58,7 @@ export declare class HostScriptSession<THost, THooks extends HostComponentHooksS
     readonly dispose: () => Promise<void>;
     /** Seeds host props bag without Lua sync (call before setProps after mount). */
     readonly seedHostProps: (bag: ScriptPropertyBag) => void;
+    readonly getHostProfileApplied: () => boolean;
 }
 export {};
 //# sourceMappingURL=hostScriptSession.d.ts.map

package/dist/infrastructure/components/hostScriptSession.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@microverse.ts/host-surface",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "type": "module",
   "license": "MIT",
   "sideEffects": false,
@@ -27,19 +27,19 @@
   ],
   "dependencies": {
     "zod": "^3.24.0",
-    "@microverse.ts/lua-defs": "0.2.0",
-    "@microverse.ts/runtime-bridge": "0.2.0",
-    "@microverse.ts/runtime-capabilities": "0.2.0",
-    "@microverse.ts/runtime-core": "0.2.0",
-    "@microverse.ts/runtime-zod": "0.2.0",
-    "@microverse.ts/shared": "0.2.0"
+    "@microverse.ts/lua-defs": "0.3.0",
+    "@microverse.ts/runtime-bridge": "0.3.0",
+    "@microverse.ts/runtime-capabilities": "0.3.0",
+    "@microverse.ts/runtime-core": "0.3.0",
+    "@microverse.ts/runtime-zod": "0.3.0",
+    "@microverse.ts/shared": "0.3.0"
   },
   "devDependencies": {
     "typescript": "^5.8.3",
     "vite": "^8.0.0",
     "vite-plugin-dts": "^4.5.4",
     "vitest": "^3.1.4",
-    "@microverse.ts/runtime-wasm": "0.2.0"
+    "@microverse.ts/runtime-wasm": "0.3.0"
   },
   "scripts": {
     "build": "vite build",