@holoscript/core 6.0.4 → 6.1.2

package/dist/world/index.d.ts

@@ -0,0 +1,147 @@
+/** @holoscript/core/world — Native world generation adapters/service */
+export interface WorldGenerationRequest {
+  prompt: string;
+  input_image?: string;
+  input_images?: string[];
+  format: 'mesh' | '3dgs' | 'both' | 'neural_field';
+  quality: 'low' | 'medium' | 'high' | 'ultra';
+  seed?: number;
+  navEnabled?: boolean;
+  interactiveMode?: boolean;
+}
+export interface WorldMetadata {
+  format: 'mesh' | '3dgs' | 'both' | 'neural_field';
+  bounds: [number, number, number, number, number, number];
+  agentStart?: [number, number, number];
+  waypoints?: [number, number, number][];
+  splatCount?: number;
+  triangleCount?: number;
+  generationMs?: number;
+}
+export interface WorldGenerationResult {
+  generationId: string;
+  assetUrl: string;
+  navmeshUrl?: string;
+  pointCloudUrl?: string;
+  metadata: WorldMetadata;
+}
+export interface WorldGeneratorAdapter {
+  readonly id: string;
+  generate(req: WorldGenerationRequest): Promise<WorldGenerationResult>;
+  getProgress?(generationId: string): Promise<number>;
+  cancel?(generationId: string): Promise<void>;
+}
+export declare class WorldAdapterRegistry {
+  register(adapter: WorldGeneratorAdapter): void;
+  get(engineId: string): WorldGeneratorAdapter;
+  has(engineId: string): boolean;
+  list(): string[];
+}
+export declare const worldAdapterRegistry: WorldAdapterRegistry;
+export interface SovereignWorldAdapterOptions {
+  endpoint?: string;
+  apiKey?: string;
+}
+export declare class SovereignWorldAdapter implements WorldGeneratorAdapter {
+  readonly id: string;
+  constructor(options?: SovereignWorldAdapterOptions);
+  generate(req: WorldGenerationRequest): Promise<WorldGenerationResult>;
+}
+export interface Sovereign3DAdapterOptions {
+  baseUrl?: string;
+  apiKey?: string;
+  timeoutMs?: number;
+  pollIntervalMs?: number;
+  mockMode?: boolean;
+  mockLatencyMs?: number;
+}
+export declare class Sovereign3DAdapter implements WorldGeneratorAdapter {
+  readonly id: string;
+  constructor(options?: Sovereign3DAdapterOptions);
+  generate(req: WorldGenerationRequest): Promise<WorldGenerationResult>;
+  getProgress(generationId: string): Promise<number>;
+}
+export type GeneratorSource = 'sovereign-local' | 'sovereign-cloud' | 'keyword-fallback' | 'mock';
+export interface TraitSuggestionResult {
+  traits: string[];
+  reasoning: Record<string, string>;
+  confidence: number;
+  metadata: { source: GeneratorSource };
+}
+export interface ObjectGenerationResult {
+  code: string;
+  metadata: {
+    description: string;
+    traits: string[];
+    geometry: string;
+    generationMs?: number;
+    source: GeneratorSource;
+  };
+}
+export interface SceneGenerationResult {
+  code: string;
+  metadata: {
+    description: string;
+    objectCount: number;
+    traits: string[];
+    generationMs?: number;
+    source: GeneratorSource;
+  };
+}
+export interface SovereignGeneratorAdapterOptions {
+  localEndpoint?: string;
+  cloudEndpoint?: string;
+  cloudApiKey?: string;
+  localModel?: string;
+  cloudModel?: string;
+  maxTokens?: number;
+  timeoutMs?: number;
+  offlineOnly?: boolean;
+  mockMode?: boolean;
+  mockLatencyMs?: number;
+}
+export declare class SovereignGeneratorAdapter {
+  readonly id: string;
+  constructor(options?: SovereignGeneratorAdapterOptions);
+  suggestTraits(description: string, context?: string): Promise<TraitSuggestionResult>;
+  generateObject(description: string): Promise<ObjectGenerationResult>;
+  generateScene(description: string): Promise<SceneGenerationResult>;
+}
+export interface WorldGenerateEvent extends WorldGenerationRequest {
+  nodeId: string;
+  engine: string;
+}
+export interface WorldGenerationStartedEvent {
+  nodeId: string;
+  engine: string;
+  generationId: string;
+}
+export interface WorldGenerationProgressEvent {
+  nodeId: string;
+  progress: number;
+}
+export interface WorldGenerationCompleteEvent {
+  nodeId: string;
+  assetUrl: string;
+  navmeshUrl?: string;
+  pointCloudUrl?: string;
+  generationId: string;
+  metadata: Record<string, unknown>;
+}
+export interface WorldGenerationErrorEvent {
+  nodeId: string;
+  error: string;
+}
+export interface WorldEventEmitter {
+  on(event: string, listener: (data: unknown) => void): void;
+  off?(event: string, listener: (data: unknown) => void): void;
+  emit(event: string, data: unknown): void;
+}
+export declare class WorldGeneratorService {
+  readonly registry: WorldAdapterRegistry;
+  constructor(registry?: WorldAdapterRegistry);
+  registerDefaultAdapters(): void;
+  bindEventEmitter(emitter: WorldEventEmitter): () => void;
+  handleGenerateEvent(emitter: WorldEventEmitter, event: WorldGenerateEvent): Promise<void>;
+}
+export declare const worldGeneratorService: WorldGeneratorService;