@forgeax/engine-pack 0.1.2

package/dist/scriptable-pack-node.d.ts

@@ -0,0 +1,67 @@
+import type { Result } from '@forgeax/engine-types';
+import { type ProducerSemanticIdentityInput } from './evidence/source-inventory.js';
+import { type ScriptablePackAssetKind, type ScriptablePackAuthoringPort, type ScriptablePackDefinition, type ScriptablePackError } from './scriptable-pack.js';
+export interface ScriptablePackModuleExecutor {
+    load(sourcePath: string): Promise<unknown>;
+    dispose?(reason: 'complete' | 'timeout' | 'failure'): void | Promise<void>;
+}
+export interface ScriptablePackModuleExecutorPool {
+    acquire(): Promise<ScriptablePackModuleExecutor>;
+    dispose(): Promise<void>;
+}
+export interface ScriptablePackModuleExecutorPoolOptions {
+    readonly maxWorkers?: number;
+    readonly maxTasksPerWorker?: number;
+}
+export declare function scriptablePackDdcKey(input: ProducerSemanticIdentityInput): string;
+export interface OptionalBuildCache<T> {
+    readonly read: () => Promise<T | null>;
+    readonly coldCook: () => Promise<T>;
+}
+/** Build CAS is a performance hint; source cold cook remains the correctness path. */
+export declare function readOptionalBuildCache<T>(cache: OptionalBuildCache<T>): Promise<{
+    readonly value: T;
+    readonly fromCache: boolean;
+}>;
+/** Serializable source-closure evidence shared by scanner and producer paths. */
+export interface ScriptablePackSourceClosureEntry {
+    readonly path: string;
+    readonly digest: string;
+}
+/** Inventory a ScriptablePack module without importing or executing it. */
+export declare function inventoryScriptablePackSource(sourcePath: string): Promise<readonly ScriptablePackSourceClosureEntry[]>;
+export interface LoadScriptablePackOptions {
+    /** Maximum time allowed for module initialization in the isolated worker. */
+    readonly timeoutMs?: number;
+    /** Maximum time allowed for one definition.build(reader) in the isolated worker. */
+    readonly buildTimeoutMs?: number;
+    readonly executor?: ScriptablePackModuleExecutor;
+    /** Release the isolated loader after identity projection when build will not be called. */
+    readonly metadataOnly?: boolean;
+}
+export declare function createScriptablePackModuleExecutorPool(options?: ScriptablePackModuleExecutorPoolOptions): ScriptablePackModuleExecutorPool;
+export declare function loadScriptablePack(sourcePath: string, options?: LoadScriptablePackOptions): Promise<Result<Readonly<ScriptablePackDefinition>, ScriptablePackError>>;
+interface CanonicalOutput {
+    readonly guid: string;
+    readonly kind: ScriptablePackAssetKind;
+    readonly name?: string;
+}
+interface CanonicalManifest {
+    readonly schemaVersion: '1.0.0';
+    readonly packageId: string;
+    readonly name?: string;
+    readonly assets: Readonly<Record<string, CanonicalOutput>>;
+    readonly externalAssets: Readonly<Record<string, string>>;
+}
+export interface FileSystemScriptablePackAuthoringOptions {
+    /** All source and target paths are confined to this game root. */
+    readonly gameRoot: string;
+    readonly incomingRefs?: (sourcePath: string, sourceKey?: string) => Promise<readonly string[]>;
+    readonly rebuild?: (sourcePath: string, mode: 'rebuild' | 'cold-cook') => Promise<Result<void, ScriptablePackError>>;
+}
+/** Render the one source shape that the file authoring port may mutate structurally. */
+export declare function renderCanonicalScriptablePack(manifest: CanonicalManifest): string;
+/** Node filesystem adapter for the public ScriptablePack authoring gateway. */
+export declare function createFileSystemScriptablePackAuthoringPort(options: FileSystemScriptablePackAuthoringOptions): ScriptablePackAuthoringPort;
+export {};
+//# sourceMappingURL=scriptable-pack-node.d.ts.map

package/dist/scriptable-pack-node.d.ts.map

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