@holoscript/core 8.0.8 → 8.0.9

package/dist/compiler/index.d.ts

@@ -46,16 +46,11 @@ export type ExportTarget =
   | 'android-xr'
   | 'ios'
   | 'visionos'
-  | 'ar'
-  | 'babylon'
   | 'webgpu'
-  | 'r3f'
   | 'wasm'
-  | 'playcanvas'
   | 'usd'
   | 'usdz'
   | 'dtdl'
-  | 'vrr'
   | 'multi-layer'
   | 'incremental'
   | 'state'
@@ -64,10 +59,9 @@ export type ExportTarget =
   | 'a2a-agent-card'
   | 'nir'
   | 'openxr-spatial-entities'
-  | 'phone-sleeve-vr'
-  | 'native-2d'
   | 'context'
-  | '3dgs';
+  | '3dgs'
+  | 'llama-server';
 
 export interface HolomapPointCloudPayload {
   positionsB64: string;
@@ -75,17 +69,109 @@ export interface HolomapPointCloudPayload {
   pointCount: number;
 }
 
-export class R3FCompiler extends CompilerBase {
+export interface SceneIRCompilerOptions {
+  qualityTier?: 'low' | 'med' | 'high' | 'ultra';
+  defaultLighting?: boolean;
+  holomapPointCloud?: HolomapPointCloudPayload;
+  platformTarget?: any;
+}
+
+export class SceneIRCompiler extends CompilerBase {
+  constructor(options?: SceneIRCompilerOptions);
   compile(ast: any, token: CompilerToken): R3FNode[];
+  compileComposition(composition: any): R3FNode;
 }
 
+export type PerceptualColorPassSource = 'palette' | 'gradient' | 'color_map';
+export interface PerceptualGradientStop { t: number; color: string; }
+export interface PerceptualColorPassOptions {
+  steps?: number;
+  dampening?: number;
+  arcSteps?: number;
+  targetDeltaE?: number;
+  neutralAxis?: boolean;
+}
+export interface PerceptualColorPassInput {
+  palette?: readonly string[];
+  gradient?: readonly (string | PerceptualGradientStop)[];
+  colorMap?: string | readonly (string | PerceptualGradientStop)[];
+  steps?: number;
+  dampening?: number;
+  arcSteps?: number;
+  targetDeltaE?: number;
+  neutralAxis?: boolean;
+  scientific?: boolean;
+}
+export interface PerceptualPaletteResult {
+  colors: string[];
+  pairwiseDeltaE: number[];
+  minDeltaE: number;
+  maxDeltaE: number;
+  meanDeltaE: number;
+  nearestNeutral?: string[];
+}
+export interface PerceptualGradientResult {
+  stops: PerceptualGradientStop[];
+  colors: string[];
+  deltaE: number[];
+  minDeltaE: number;
+  maxDeltaE: number;
+  meanDeltaE: number;
+}
+export interface PerceptualColorMapResult extends PerceptualGradientResult { name: string; }
+export interface PerceptualColorPassResult {
+  algorithm: 'perceptual_lerp_delta_e2000';
+  source: PerceptualColorPassSource;
+  scientific: boolean;
+  targetDeltaE: number;
+  dampening: number;
+  palette?: PerceptualPaletteResult;
+  gradient?: PerceptualGradientResult;
+  colorMap?: PerceptualColorMapResult;
+  warnings: string[];
+}
+export interface PerceptualColorAnalysis {
+  color: string;
+  lightness: number;
+  chroma: number;
+  hue: number;
+  nearestNeutral: string;
+}
+export interface PerceptualColorCompilerMetadata {
+  mapName: string;
+  colors: string[];
+  stops: PerceptualGradientStop[];
+  minDeltaE: number;
+  maxDeltaE: number;
+  meanDeltaE: number;
+  warnings: string[];
+  pass: PerceptualColorPassResult;
+}
+export const SCIENTIFIC_COLOR_MAPS: Record<string, readonly string[]>;
+export function normalizeHexColor(color: string): string;
+export function hexToSrgb(color: string): readonly [number, number, number];
+export function srgbToHex(rgb: readonly [number, number, number]): string;
+export function buildPerceptualGradient(
+  stops: readonly (string | PerceptualGradientStop)[],
+  options?: PerceptualColorPassOptions
+): PerceptualGradientResult;
+export function buildPerceptualPalette(
+  colors: readonly string[],
+  options?: PerceptualColorPassOptions
+): PerceptualPaletteResult;
+export function analyzePerceptualColor(color: string): {
+  color: string;
+  lightness: number;
+  chroma: number;
+  hue: number;
+  nearestNeutral: string;
+};
+export function applyPerceptualColorPass(input: PerceptualColorPassInput): PerceptualColorPassResult;
+
 export declare const ENVIRONMENT_PRESETS: Record<string, 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; }
@@ -138,6 +224,56 @@ export class MCPConfigCompiler extends CompilerBase {
   constructor(options?: MCPConfigCompilerOptions);
   compile(composition: any, agentToken: string, outputPath?: string): string;
 }
+export interface LlamaServerCompilerOptions {
+  name?: string;
+  model?: string;
+  modelPath?: string;
+  mmprojPath?: string;
+  host?: string;
+  port?: number;
+  contextLength?: number;
+  gpuLayers?: number;
+  fit?: 'on' | 'off';
+  imageMinTokens?: number;
+  imageMaxTokens?: number;
+  parallel?: number;
+  metrics?: boolean;
+  grammarPath?: string;
+  grammar?: string;
+  loraPath?: string;
+  loraScale?: number;
+  executable?: string;
+  cudaPath?: string;
+  llamaBinDir?: string;
+  workingDirectory?: string;
+  platform?: 'windows' | 'linux';
+  serviceUser?: string;
+  node?: string;
+  registerAs?: string;
+  dryRun?: boolean;
+}
+export interface LlamaServerBundleFile {
+  path: string;
+  content: string;
+  executable?: boolean;
+}
+export interface LlamaServerBundle {
+  name: string;
+  target: 'llama-server';
+  dryRun: true;
+  launch: { executable: string; args: string[]; command: string; powershell: string };
+  healthProbe: { url: string; openaiModelsUrl: string; powershell: string };
+  service: { systemdUnit: string; windowsS4UTask: string };
+  registryEntry: Record<string, any>;
+  files: LlamaServerBundleFile[];
+  config: Record<string, any>;
+  warnings: string[];
+}
+export class LlamaServerCompiler extends CompilerBase {
+  constructor(options?: LlamaServerCompilerOptions);
+  compile(composition: any, agentToken: string, outputPath?: string): string;
+  compileToFiles(composition: any, agentToken?: string): Record<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 =
@@ -456,34 +592,12 @@ export function runCompilerWasmSnnEmulator(
   runtime: Tier1WasmRuntimeProbeResult
 ): Tier1WasmEmulatorResult;
 
-// Additional compilers (GaussianSplatting, VRR, FlatSemantic) for compiler subpath consumers
+// Additional live compilers 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;
-}
 
 // Sovereign target classification (D.006 native-vs-bridge registry — sovereign-targets.ts)
 export const SOVEREIGN_TARGETS: readonly ExportTarget[];