@holoscript/core 7.0.0 → 8.0.1

package/dist/compiler/index.d.ts

@@ -34,33 +34,80 @@ export interface R3FNode {
   [key: string]: any;
 }
 
+export type ExportTarget =
+  | 'urdf'
+  | 'sdf'
+  | 'unity'
+  | 'unreal'
+  | 'godot'
+  | 'vrchat'
+  | 'openxr'
+  | 'android'
+  | 'android-xr'
+  | 'ios'
+  | 'visionos'
+  | 'ar'
+  | 'babylon'
+  | 'webgpu'
+  | 'r3f'
+  | 'wasm'
+  | 'playcanvas'
+  | 'usd'
+  | 'usdz'
+  | 'dtdl'
+  | 'vrr'
+  | 'multi-layer'
+  | 'incremental'
+  | 'state'
+  | 'trait-composition'
+  | 'tsl'
+  | 'a2a-agent-card'
+  | 'nir'
+  | 'openxr-spatial-entities'
+  | 'phone-sleeve-vr'
+  | 'native-2d'
+  | 'context'
+  | '3dgs';
+
+export interface HolomapPointCloudPayload {
+  positionsB64: string;
+  colorsB64: string;
+  pointCount: number;
+}
+
 export class R3FCompiler extends CompilerBase {
   compile(ast: any, token: CompilerToken): R3FNode[];
 }
 
 export declare const ENVIRONMENT_PRESETS: Record<string, any>;
 
-export class UnityCompiler extends CompilerBase { compile(ast: any, token: CompilerToken): any; }
-export class GodotCompiler extends CompilerBase { compile(ast: any, token: CompilerToken): any; }
-export class BabylonCompiler extends CompilerBase { compile(ast: any, token: CompilerToken): any; }
-export class PlayCanvasCompiler extends CompilerBase { compile(ast: any, token: CompilerToken): any; }
-export class ARCompiler extends CompilerBase { compile(ast: any, token: CompilerToken): any; }
-export class OpenXRCompiler extends CompilerBase { compile(ast: any, token: CompilerToken): any; }
-export class VRChatCompiler extends CompilerBase { compile(ast: any, token: CompilerToken): any; }
-export class VisionOSCompiler extends CompilerBase { compile(ast: any, token: CompilerToken): any; }
-export class AndroidCompiler extends CompilerBase { compile(ast: any, token: CompilerToken): any; }
-export class AndroidXRCompiler extends CompilerBase { compile(ast: any, token: CompilerToken): any; }
-export class IOSCompiler extends CompilerBase { compile(ast: any, token: CompilerToken): any; }
-export class WASMCompiler extends CompilerBase { compile(ast: any, token: CompilerToken): any; }
-export class WebGPUCompiler extends CompilerBase { compile(ast: any, token: CompilerToken): any; }
-export class SDFCompiler extends CompilerBase { compile(ast: any, token: CompilerToken): any; }
-export class DTDLCompiler extends CompilerBase { compile(ast: any, token: CompilerToken): any; }
-export class URDFCompiler extends CompilerBase { compile(ast: any, token: CompilerToken): any; }
-export class USDPhysicsCompiler extends CompilerBase { compile(ast: any, token: CompilerToken): any; }
-export class StateCompiler extends CompilerBase { compile(ast: any, token: CompilerToken): any; }
-export class TraitCompositionCompiler extends CompilerBase { compile(ast: any, token: CompilerToken): any; }
-export class IncrementalCompiler extends CompilerBase { compile(ast: any, token: CompilerToken): any; }
-export class MultiLayerCompiler extends CompilerBase { compile(ast: any, token: CompilerToken): any; }
+export class UnityCompiler extends CompilerBase { constructor(options?: any); compile(ast: any, token: CompilerToken): any; }
+export class GodotCompiler extends CompilerBase { constructor(options?: any); compile(ast: any, token: CompilerToken): any; }
+export class BabylonCompiler extends CompilerBase { constructor(options?: any); compile(ast: any, token: CompilerToken): any; }
+export class PlayCanvasCompiler extends CompilerBase { constructor(options?: any); compile(ast: any, token: CompilerToken): any; }
+export class ARCompiler extends CompilerBase { constructor(options?: any); compile(ast: any, token: CompilerToken): any; }
+export class OpenXRCompiler extends CompilerBase { constructor(options?: any); compile(ast: any, token: CompilerToken): any; }
+export class VRChatCompiler extends CompilerBase { constructor(options?: any); compile(ast: any, token: CompilerToken): any; }
+export class VisionOSCompiler extends CompilerBase { constructor(options?: any); compile(ast: any, token: CompilerToken): any; }
+export class AndroidCompiler extends CompilerBase { constructor(options?: any); compile(ast: any, token: CompilerToken): any; }
+export class AndroidXRCompiler extends CompilerBase { constructor(options?: any); compile(ast: any, token: CompilerToken): any; }
+export class IOSCompiler extends CompilerBase { constructor(options?: any); compile(ast: any, token: CompilerToken): any; }
+export class WASMCompiler extends CompilerBase { constructor(options?: any); compile(ast: any, token: CompilerToken): any; }
+export class WebGPUCompiler extends CompilerBase { constructor(options?: any); compile(ast: any, token: CompilerToken): any; }
+export class SDFCompiler extends CompilerBase { constructor(options?: any); compile(ast: any, token: CompilerToken): any; }
+export class DTDLCompiler extends CompilerBase { constructor(options?: any); compile(ast: any, token: CompilerToken): any; }
+export class URDFCompiler extends CompilerBase { constructor(options?: any); compile(ast: any, token: CompilerToken): any; }
+export class USDPhysicsCompiler extends CompilerBase { constructor(options?: any); compile(ast: any, token: CompilerToken): any; }
+export class StateCompiler extends CompilerBase { constructor(options?: any); compile(ast: any, token: CompilerToken): any; }
+export class TraitCompositionCompiler extends CompilerBase { constructor(options?: any); compile(ast: any, token: CompilerToken): any; }
+export class IncrementalCompiler extends CompilerBase {
+  constructor(options?: any);
+  static deserialize(json: string): IncrementalCompiler;
+  compile(ast: any, compileObject: (obj: any) => string, options?: any): Promise<any>;
+  [key: string]: any;
+}
+export function createIncrementalCompiler(config?: any): IncrementalCompiler;
+export class MultiLayerCompiler extends CompilerBase { constructor(options?: any); compile(ast: any, token: CompilerToken): any; }
 export class COCOExporter { [key: string]: any; }
 export class GLTFPipelineMCPTool { [key: string]: any; }
 export const BUSINESS_QUEST_TOOLS: any[];
@@ -80,7 +127,77 @@ export class NodeToyMapping { [key: string]: any; }
 export class RemotionBridge { [key: string]: any; }
 export class ReproducibilityMode { [key: string]: any; }
 export class SemanticSceneGraph { [key: string]: any; }
+export type MCPConfigTarget = 'claude' | 'vscode' | 'cursor' | 'antigravity' | 'generic';
+export interface MCPConfigCompilerOptions {
+  target?: MCPConfigTarget;
+  envFile?: string;
+  envValues?: Record<string, string>;
+  cwd?: string;
+}
+export class MCPConfigCompiler extends CompilerBase {
+  constructor(options?: MCPConfigCompilerOptions);
+  compile(composition: any, agentToken: string, outputPath?: string): string;
+}
 export class AgentInferenceExportTarget extends CompilerBase { compile(ast: any, token: CompilerToken): any; }
+export type ContextSurface = 'claude' | 'codex' | 'cursor' | 'copilot' | 'gemini' | 'any';
+export type ContextEmitFormat =
+  | 'claude_md'
+  | 'agents_md'
+  | 'cursor_rules'
+  | 'skill_md'
+  | 'anthropic_system_prompt'
+  | 'brain_includes'
+  | 'mcp_context_loader';
+export interface ContextValidationDiagnostic {
+  severity: 'error' | 'warning';
+  rule: string;
+  message: string;
+  location?: string;
+}
+export interface ContextAST { [key: string]: any; warnings: ContextValidationDiagnostic[]; }
+export interface ContextCompileResult {
+  files: Record<string, string>;
+  ast: ContextAST;
+  diagnostics: ContextValidationDiagnostic[];
+}
+export interface ContextCompilerOptions { formats?: ContextEmitFormat[]; }
+export class ContextCompileError extends Error { constructor(message: string); }
+export class ContextCompiler extends CompilerBase {
+  constructor(options?: ContextCompilerOptions);
+  compile(composition: any, agentToken: string, outputPath?: string): ContextCompileResult;
+}
+export function createContextCompiler(options?: ContextCompilerOptions): ContextCompiler;
+export type LLMProviderStatus = 'live' | 'partial' | 'teammate' | 'runtime' | 'planned';
+export type LLMModelStatus = 'active' | 'active-recommended' | 'active-legacy' | 'deprecated';
+export type LLMCapabilityEmitFormat =
+  | 'markdown_ssot'
+  | 'ts_adapter_capabilities'
+  | 'cost_guard_pricing'
+  | 'json_capability_matrix';
+export interface LLMCapabilityValidationDiagnostic {
+  severity: 'error' | 'warning';
+  rule: string;
+  message: string;
+  location?: string;
+}
+export interface LLMCapabilityMatrixAST { [key: string]: any; warnings: LLMCapabilityValidationDiagnostic[]; }
+export interface LLMCapabilityCompileResult {
+  files: Record<string, string>;
+  ast: LLMCapabilityMatrixAST;
+  diagnostics: LLMCapabilityValidationDiagnostic[];
+}
+export interface LLMCapabilityCompilerOptions {
+  formats?: LLMCapabilityEmitFormat[];
+  nowIso?: string;
+}
+export class LLMCapabilityCompileError extends Error { constructor(message: string); }
+export class LLMProviderCapabilitiesCompiler extends CompilerBase {
+  constructor(options?: LLMCapabilityCompilerOptions);
+  compile(composition: any, agentToken: string, outputPath?: string): LLMCapabilityCompileResult;
+}
+export function createLLMProviderCapabilitiesCompiler(
+  options?: LLMCapabilityCompilerOptions
+): LLMProviderCapabilitiesCompiler;
 
 export interface GeometryData { vertices: Float32Array; indices?: Uint32Array; normals?: Float32Array; uvs?: Float32Array; }
 export interface BlobDef { center: [number, number, number]; radius: number; }
@@ -102,10 +219,35 @@ export type EffectViolationSeverity = 'error' | 'warning' | 'info';
 export interface EffectViolation { effect: VREffect; severity: EffectViolationSeverity; [key: string]: any; }
 export interface EffectDeclaration { effects: VREffect[]; [key: string]: any; }
 export type CompilePlatformTarget = string;
+export function createPlatformTarget(platform: string): CompilePlatformTarget;
+export function filterCompositionForPlatform(composition: any, platform: string): any;
+export function matchesPlatformConstraint(constraint: any, target: CompilePlatformTarget): boolean;
+export function normalizePlatformName(name: string): string;
 
 export class USDZPipeline { [key: string]: any; }
 export interface USDZPipelineOptions { [key: string]: any; }
 
+export interface QuantumAtom {
+  symbol: string;
+  x: number;
+  y: number;
+  z: number;
+}
+export interface QASMOutput {
+  qasm: string;
+  numQubits: number;
+  numClbits: number;
+  estimatedDepth: number;
+  circuitType: 'vqe' | 'qaoa' | 'grover' | 'custom';
+  molecule?: { atoms: QuantumAtom[] };
+  weightMatrix?: number[][];
+  recommendedBackend: 'aer' | 'ibm-quantum';
+  warnings: string[];
+}
+export class QuantumCircuitCompiler extends CompilerBase {
+  compile(composition: any, agentToken?: string, outputPath?: string, sceneGraph?: any): QASMOutput;
+}
+
 export class CompilerBridge { [key: string]: any; }
 
 // Social Causal Model (SCM) — Cycle 9/10/12
@@ -171,3 +313,174 @@ export function mergeSocialCausalModels(
   agentDags: SCMDAG[],
   options?: SocialMergeOptions,
 ): SocialMergeResult;
+
+export enum DispatchTier {
+  TIER_1_NEUROMORPHIC = 'tier-1-neuromorphic',
+  TIER_1_BROWSER = 'tier-1-browser',
+  TIER_1_WASM = 'tier-1-wasm',
+  TIER_2_SPECULATIVE = 'tier-2-speculative',
+  TIER_3_CPU_DIRECT = 'tier-3-cpu-direct',
+}
+
+export type NeuromorphicDeviceTarget = 'loihi' | 'spinnaker' | 'synsense' | 'akida';
+export interface NeuromorphicRuntimeDevice {
+  target: NeuromorphicDeviceTarget;
+  id?: string;
+  available?: boolean;
+  source?: string;
+}
+export interface NeuromorphicRuntimeProbeResult {
+  available: boolean;
+  device?: NeuromorphicDeviceTarget;
+  source: string;
+  reason?: string;
+  devices?: NeuromorphicRuntimeDevice[];
+}
+export type NeuromorphicRuntimeProbe = (
+  preferredDevice?: NeuromorphicDeviceTarget
+) => NeuromorphicRuntimeProbeResult | Promise<NeuromorphicRuntimeProbeResult>;
+export interface DispatchEffectVerifierResult {
+  passed: boolean;
+  reason?: string;
+}
+export interface Tier3CpuDirectOutput {
+  trait: string;
+  nodeId: string;
+  config: Record<string, unknown>;
+}
+export interface TraitEquivalenceOracleInput {
+  operation: DispatchableOperation;
+  proposal: unknown;
+  tier3Output: unknown;
+}
+export interface TraitEquivalenceOracleResult {
+  equivalent: boolean;
+  source: string;
+  reason?: string;
+  score?: number;
+  proposalFingerprint?: string;
+  tier3Fingerprint?: string;
+}
+export type DispatchProposalProvider = (
+  op: DispatchableOperation
+) => unknown | null | Promise<unknown | null>;
+export type Tier3CpuExecutor = (op: DispatchableOperation) => unknown | Promise<unknown>;
+export type TraitEquivalenceOracle = (
+  input: TraitEquivalenceOracleInput
+) => TraitEquivalenceOracleResult | Promise<TraitEquivalenceOracleResult>;
+export interface Tier1WasmRuntimeProbeResult {
+  available: boolean;
+  source: string;
+  reason?: string;
+  moduleValidated?: boolean;
+}
+export interface Tier1WasmEmulatorResult {
+  accepted: boolean;
+  source: string;
+  runtime: Tier1WasmRuntimeProbeResult;
+  reason?: string;
+  steps?: number;
+  spikeCount?: number;
+  membranePotential?: number;
+  inputChecksum?: number;
+}
+export type Tier1WasmRuntimeProbe = () =>
+  | Tier1WasmRuntimeProbeResult
+  | Promise<Tier1WasmRuntimeProbeResult>;
+export type Tier1WasmExecutor = (
+  op: DispatchableOperation,
+  runtime: Tier1WasmRuntimeProbeResult
+) => Tier1WasmEmulatorResult | Promise<Tier1WasmEmulatorResult>;
+export type Tier1BrowserExecutor = (
+  op: DispatchableOperation
+) => Promise<{ accepted: boolean; source: string; steps?: number; reason?: string }>;
+export interface DispatchPolicyConfig {
+  tier1BrowserEnabled: boolean;
+  tier1WasmEnabled: boolean;
+  tier1WasmRuntimeProbe?: Tier1WasmRuntimeProbe;
+  tier1WasmExecutor?: Tier1WasmExecutor;
+  tier1BrowserExecutor?: Tier1BrowserExecutor;
+  tier1NeuromorphicEnabled: boolean;
+  tier1NeuromorphicDevice?: NeuromorphicDeviceTarget;
+  neuromorphicRuntimeProbe?: NeuromorphicRuntimeProbe;
+  tier2Enabled: boolean;
+  llmProposalProvider?: DispatchProposalProvider;
+  tier3CpuExecutor?: Tier3CpuExecutor;
+  traitEquivalenceOracle?: TraitEquivalenceOracle;
+  tier2AlphaThreshold: number;
+  effectVerifier?: (traits: string[]) => Promise<DispatchEffectVerifierResult | null>;
+  simulationContractVerifier?: (manifest: unknown) => Promise<boolean>;
+  alphaWindowSize: number;
+}
+export interface DispatchableOperation {
+  trait: string;
+  nodeId: string;
+  config?: Record<string, unknown>;
+  provenanceContext?: unknown;
+  manifest?: ReconstructionManifest;
+}
+export interface DispatchMetrics {
+  tierAttempted: DispatchTier;
+  tierAccepted: boolean;
+  fallbackReason?: string;
+  latencyEstimateMs: number;
+  alpha?: number;
+  verifierPassed?: boolean;
+  traitEquivalence?: TraitEquivalenceOracleResult;
+  neuromorphicProbe?: NeuromorphicRuntimeProbeResult;
+  wasmProbe?: Tier1WasmRuntimeProbeResult;
+  wasmEmulator?: Tier1WasmEmulatorResult;
+  browserExecutor?: { accepted: boolean; source: string; steps?: number; reason?: string };
+}
+export interface DispatchDecision {
+  tier: DispatchTier;
+  accepted: boolean;
+  provenance: unknown;
+  metrics: DispatchMetrics;
+  replayFingerprint?: string;
+}
+export class AlphaTracker {
+  constructor(size?: number);
+  recordAttempt(success: boolean): void;
+  getAlpha(): number;
+  readonly windowLength: number;
+}
+export class DispatchPolicy {
+  constructor(config?: Partial<DispatchPolicyConfig>);
+  route(op: DispatchableOperation): Promise<DispatchDecision>;
+}
+export function createTier3CpuDirectOutput(op: DispatchableOperation): Tier3CpuDirectOutput;
+export function detectWasmRuntime(): Tier1WasmRuntimeProbeResult;
+export function runCompilerWasmSnnEmulator(
+  op: DispatchableOperation,
+  runtime: Tier1WasmRuntimeProbeResult
+): Tier1WasmEmulatorResult;
+
+// Additional compilers (GaussianSplatting, VRR, FlatSemantic) for compiler subpath consumers
+export class GaussianSplattingCompiler extends CompilerBase {
+  constructor(options?: { format?: 'gltf' | 'glb'; [key: string]: any });
+  compile(ast: any, token?: any, ...args: any[]): any;
+  [key: string]: any;
+}
+export class VRRCompiler extends CompilerBase {
+  constructor(options?: any);
+  compile(composition: any, agentToken?: any, outputPath?: string): any;
+  [key: string]: any;
+}
+export class FlatSemanticCompiler extends CompilerBase {
+  constructor(options?: any);
+  compile(ast: any, ...args: any[]): any;
+  [key: string]: any;
+}
+// Native2DCompiler — .holo composition → hydration-free HTML / React (I.017).
+// Consumed via @holoscript/core/compiler by the studio Founder Console native
+// route (packages/studio/src/app/quest-proof/native/route.ts, N1/N2 lane).
+export interface Native2DCompilerOptions {
+  format?: 'html' | 'react';
+  minify?: boolean;
+}
+export class Native2DCompiler extends CompilerBase {
+  constructor(options?: Native2DCompilerOptions);
+  compile(ast: any, agentToken: string, outputPath?: string, options?: Native2DCompilerOptions): string | any;
+  [key: string]: any;
+}