@forgeax/engine-devkit 0.1.2

package/dist/init.d.ts

@@ -0,0 +1,20 @@
+import type { SdkManifest } from './sdk.js';
+import type { CommandResult, InitOptions, ProjectFacts } from './types.js';
+export interface InitPlan {
+    readonly root: string;
+    readonly version: string;
+    readonly archiveBacked: boolean;
+    readonly dependencyChanges: readonly {
+        readonly section: string;
+        readonly name: string;
+        readonly from?: string;
+        readonly to: string;
+    }[];
+    readonly scriptChanges: readonly {
+        readonly name: string;
+        readonly to: string;
+    }[];
+}
+export declare function createInitPlan(facts: ProjectFacts, sdk?: Pick<SdkManifest, 'sdkVersion' | 'packages'>): CommandResult<InitPlan>;
+export declare function applyInitPlan(facts: ProjectFacts, plan: InitPlan, options: InitOptions): Promise<CommandResult<InitPlan>>;
+//# sourceMappingURL=init.d.ts.map

package/dist/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../src/init.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAoB3E,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,iBAAiB,EAAE,SAAS;QACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;KACrB,EAAE,CAAC;IACJ,QAAQ,CAAC,aAAa,EAAE,SAAS;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACnF;AAED,wBAAgB,cAAc,CAC5B,KAAK,EAAE,YAAY,EACnB,GAAG,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,YAAY,GAAG,UAAU,CAAC,GACjD,aAAa,CAAC,QAAQ,CAAC,CAkHzB;AAED,wBAAsB,aAAa,CACjC,KAAK,EAAE,YAAY,EACnB,IAAI,EAAE,QAAQ,EACd,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CA2ClC"}

package/dist/plugin-authoring.d.ts

@@ -0,0 +1,4 @@
+import type { CommandResult, PluginInstallOptions, PluginUninstallOptions } from './types.js';
+export declare function pluginInstallCommand(options: PluginInstallOptions): Promise<CommandResult<unknown>>;
+export declare function pluginUninstallCommand(options: PluginUninstallOptions): Promise<CommandResult<unknown>>;
+//# sourceMappingURL=plugin-authoring.d.ts.map

package/dist/plugin-authoring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-authoring.d.ts","sourceRoot":"","sources":["../src/plugin-authoring.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAkE9F,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAoDjC;AAED,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CA8CjC"}

package/dist/project.d.ts

@@ -0,0 +1,5 @@
+import type { CommandError, CommandResult, ProjectFacts } from './types.js';
+export declare function readProjectFacts(rootInput?: string): Promise<CommandResult<ProjectFacts>>;
+export declare function isCommandError(value: unknown): value is CommandError;
+export declare function commandError(cause: unknown, fallbackCode: string): CommandError;
+//# sourceMappingURL=project.d.ts.map

package/dist/project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../src/project.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAyC5E,wBAAsB,gBAAgB,CACpC,SAAS,SAAgB,GACxB,OAAO,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC,CAiItC;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAWpE;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,GAAG,YAAY,CAQ/E"}

package/dist/rhi-debug/cli-context.d.ts

@@ -0,0 +1,3 @@
+import type { RhiDebugOperationContext } from './operations.js';
+export declare function createCliRhiDebugOperationContext(): RhiDebugOperationContext;
+//# sourceMappingURL=cli-context.d.ts.map

package/dist/rhi-debug/cli-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-context.d.ts","sourceRoot":"","sources":["../../src/rhi-debug/cli-context.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAe,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAE7E,wBAAgB,iCAAiC,IAAI,wBAAwB,CAkE5E"}

package/dist/rhi-debug/operations.d.ts

@@ -0,0 +1,83 @@
+import { type FrameModel, type InspectField, type ReplayBackend, type RhiDebugError, type WorkInspection } from '@forgeax/engine-rhi-debug';
+import { type Result } from '@forgeax/engine-types';
+import type { CommandResult } from '../types.js';
+export declare const RHI_TAPE_ARTIFACT_KIND: "rhi-tape";
+export interface ArtifactRef {
+    readonly kind: typeof RHI_TAPE_ARTIFACT_KIND;
+    readonly digest: string;
+    readonly source: string;
+    readonly path?: string;
+}
+export interface CapturedRhiTape extends ArtifactRef {
+    readonly bytes: Uint8Array;
+}
+export interface RhiCaptureFrameValue {
+    readonly kind: typeof RHI_TAPE_ARTIFACT_KIND;
+    readonly digest: string;
+    readonly bytes: Uint8Array;
+    readonly source?: string;
+    readonly path?: string;
+}
+export interface RhiCaptureInput {
+    readonly signal?: AbortSignal;
+}
+export interface RhiSummaryInput {
+    readonly artifact: ArtifactRef;
+}
+export interface RhiInspectInput {
+    readonly artifact: ArtifactRef;
+    readonly workIndex: number;
+    readonly fields?: readonly InspectField[];
+}
+export type RhiDebugOperationName = 'rhi.capture' | 'rhi.summary' | 'rhi.inspect';
+export type RhiDebugOperationInput = RhiCaptureInput | RhiSummaryInput | RhiInspectInput;
+export interface RhiSummaryOutput {
+    readonly artifact: ArtifactRef;
+    readonly model: FrameModel;
+}
+export interface RhiInspectOutput {
+    readonly artifact: ArtifactRef;
+    readonly inspection: WorkInspection;
+}
+export type RhiDebugOperationOutput = ArtifactRef | RhiSummaryOutput | RhiInspectOutput;
+export interface RhiDebugOperationContext {
+    readonly captureFrame: (input?: RhiCaptureInput) => Promise<Result<CapturedRhiTape, RhiDebugError>>;
+    readonly readArtifact: (artifact: ArtifactRef) => Promise<CommandResult<Uint8Array>>;
+    readonly createReplayBackend?: () => Promise<CommandResult<ReplayBackend>>;
+}
+export interface RhiDebugOperationHost {
+    readonly captureFrame: (input?: RhiCaptureInput) => Promise<Result<RhiCaptureFrameValue, RhiDebugError>>;
+    readonly readArtifact: (artifact: ArtifactRef) => Promise<CommandResult<Uint8Array>>;
+    readonly createReplayBackend?: () => Promise<CommandResult<ReplayBackend>>;
+}
+export declare function createRhiDebugOperationContext(host: RhiDebugOperationHost): RhiDebugOperationContext;
+export interface JsonSchema {
+    readonly type: 'object' | 'string' | 'integer' | 'array';
+    readonly properties?: Readonly<Record<string, JsonSchema>>;
+    readonly required?: readonly string[];
+    readonly items?: JsonSchema;
+    readonly enum?: readonly string[];
+    readonly minimum?: number;
+    readonly additionalProperties?: boolean;
+}
+export interface RhiDebugOperationDescriptor {
+    readonly name: RhiDebugOperationName;
+    readonly summary: string;
+    readonly inputSchema: JsonSchema;
+    readonly outputSchema: JsonSchema;
+    readonly recoveryCodes: readonly string[];
+}
+export interface RhiDebugOperationManifest {
+    readonly schemaVersion: '1.0.0';
+    readonly artifactRefSchema: JsonSchema;
+    readonly operations: readonly RhiDebugOperationDescriptor[];
+}
+export declare const RHI_DEBUG_OPERATION_MANIFEST: RhiDebugOperationManifest;
+export declare function discoverRhiDebugOperations(): readonly RhiDebugOperationDescriptor[];
+export declare function renderRhiDebugHelp(): string;
+export declare function recoverRhiDebugError(error: RhiDebugError): string;
+export declare function runRhiDebugOperation(name: 'rhi.capture', input: RhiCaptureInput, context: RhiDebugOperationContext): Promise<CommandResult<ArtifactRef>>;
+export declare function runRhiDebugOperation(name: 'rhi.summary', input: RhiSummaryInput, context: RhiDebugOperationContext): Promise<CommandResult<RhiSummaryOutput>>;
+export declare function runRhiDebugOperation(name: 'rhi.inspect', input: RhiInspectInput, context: RhiDebugOperationContext): Promise<CommandResult<RhiInspectOutput>>;
+export declare function runRhiDebugOperation(name: RhiDebugOperationName, input: RhiDebugOperationInput, context: RhiDebugOperationContext): Promise<CommandResult<RhiDebugOperationOutput>>;
+//# sourceMappingURL=operations.d.ts.map

package/dist/rhi-debug/operations.d.ts.map

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

package/dist/sdk-cli.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=sdk-cli.d.ts.map

package/dist/sdk-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-cli.d.ts","sourceRoot":"","sources":["../src/sdk-cli.ts"],"names":[],"mappings":""}