@shapeshift-labs/frontier-lang-compiler 0.2.32 → 0.2.34

package/README.md

@@ -336,8 +336,10 @@ import {
   createCSharpRoslynNativeImporterAdapter,
   createGoAstNativeImporterAdapter,
   createJavaAstNativeImporterAdapter,
+  createKotlinPsiNativeImporterAdapter,
   createPythonAstNativeImporterAdapter,
   createRustSynNativeImporterAdapter,
+  createSwiftSyntaxNativeImporterAdapter,
   importNativeProject,
   runNativeImporterAdapter
 } from '@shapeshift-labs/frontier-lang-compiler';
@@ -366,6 +368,11 @@ const javaAstAdapter = createJavaAstNativeImporterAdapter({
   javaVersion: '21',
   sourceLevel: '21'
 });
+const kotlinPsiAdapter = createKotlinPsiNativeImporterAdapter({
+  parserModule: hostKotlinPsiParser,
+  kotlinVersion: '2.1',
+  analysisApiEvidence: { hash: kotlinAnalysisApiIndexHash }
+});
 const csharpRoslynAdapter = createCSharpRoslynNativeImporterAdapter({
   parserModule: hostRoslynParser,
   languageVersion: '12',
@@ -384,7 +391,7 @@ const imported = await runNativeImporterAdapter(babelAdapter, {
 
 const project = await importNativeProject({
   projectRoot: 'src',
-  adapters: [babelAdapter, pythonAstAdapter, rustSynAdapter, clangAstAdapter, goAstAdapter, javaAstAdapter, csharpRoslynAdapter, swiftSyntaxAdapter],
+  adapters: [babelAdapter, pythonAstAdapter, rustSynAdapter, clangAstAdapter, goAstAdapter, javaAstAdapter, kotlinPsiAdapter, csharpRoslynAdapter, swiftSyntaxAdapter],
   sources: [
     { language: 'typescript', adapter: babelAdapter.id, sourcePath: 'src/todo.ts', sourceText },
     { language: 'python', adapter: pythonAstAdapter.id, sourcePath: 'tools/todo.py', sourceText: pythonSource },
@@ -392,6 +399,7 @@ const project = await importNativeProject({
     { language: 'c', adapter: clangAstAdapter.id, sourcePath: 'native/todo.c', sourceText: cSource },
     { language: 'go', adapter: goAstAdapter.id, sourcePath: 'cmd/todo/main.go', sourceText: goSource },
     { language: 'java', adapter: javaAstAdapter.id, sourcePath: 'src/main/java/Todo.java', sourceText: javaSource },
+    { language: 'kotlin', adapter: kotlinPsiAdapter.id, sourcePath: 'src/main/kotlin/Todo.kt', sourceText: kotlinSource },
     { language: 'csharp', adapter: csharpRoslynAdapter.id, sourcePath: 'src/Todo.cs', sourceText: csharpSource },
     { language: 'swift', adapter: swiftSyntaxAdapter.id, sourcePath: 'Sources/Todo.swift', sourceText: swiftSource }
   ]
@@ -417,6 +425,7 @@ The built-in adapter factories are dependency-light wrappers for caller-owned pa
 - `createClangAstNativeImporterAdapter`
 - `createGoAstNativeImporterAdapter`
 - `createJavaAstNativeImporterAdapter`
+- `createKotlinPsiNativeImporterAdapter`
 - `createCSharpRoslynNativeImporterAdapter`
 - `createSwiftSyntaxNativeImporterAdapter`
 - `createTreeSitterNativeImporterAdapter`
@@ -456,8 +465,8 @@ The published Frontier package family is generated from one shared package catal
 - [`@shapeshift-labs/frontier-workflow`](https://www.npmjs.com/package/@shapeshift-labs/frontier-workflow): Serializable durable workflow/process manifests for Frontier apps, including steps, waits, approvals, timers, retries, expected patches, compensation, records, timelines, and registry graph output.
 - [`@shapeshift-labs/frontier-worker`](https://www.npmjs.com/package/@shapeshift-labs/frontier-worker): Serializable worker and edge task descriptors for Frontier apps, including queues, idempotency keys, retry and timeout policy, declared reads/writes/effects, snapshots, patch outputs, produced assets, execution records, logs, trace links, proof hashes, dedupe indexes, and registry graph output.
 - [`@shapeshift-labs/frontier-queue`](https://www.npmjs.com/package/@shapeshift-labs/frontier-queue): Serializable durable queue state, leases, retries, dedupe keys, patch-carrying jobs, dead-letter records, replay evidence, and queue inspection for Frontier apps.
-- [`@shapeshift-labs/frontier-swarm`](https://www.npmjs.com/package/@shapeshift-labs/frontier-swarm): Hierarchical swarm plans, lanes, compute profiles, ownership policy, semantic ownership regions, task queues, event streams, run records, merge bundles, merge indexes, queue overlays, merge admission, changed-path checks, and proof artifacts for Frontier agent work.
-- [`@shapeshift-labs/frontier-swarm-codex`](https://www.npmjs.com/package/@shapeshift-labs/frontier-swarm-codex): Node Codex CLI adapter for Frontier swarm plans, including prompt rendering, worktree and snapshot workspaces, Codex argument compatibility, browser resource allocation, JSONL capture, verification commands, pid-backed stop, collect/apply workflows, merge indexes, queue overlays, merge bundles, and result artifacts.
+- [`@shapeshift-labs/frontier-swarm`](https://www.npmjs.com/package/@shapeshift-labs/frontier-swarm): Hierarchical swarm plans, lanes, compute profiles, ownership policy, semantic ownership regions, task queues, event streams, run records, merge bundles, merge indexes, queue overlays, merge admission, coordinator dashboards, changed-path checks, and proof artifacts for Frontier agent work.
+- [`@shapeshift-labs/frontier-swarm-codex`](https://www.npmjs.com/package/@shapeshift-labs/frontier-swarm-codex): Node Codex CLI adapter for Frontier swarm plans, including prompt rendering, worktree and snapshot workspaces, Codex argument compatibility, browser resource allocation, JSONL capture, verification commands, pid-backed stop, collect/apply workflows, merge indexes, queue overlays, merge bundles, normalized job evidence, coordinator query artifacts, and result artifacts.
 - [`@shapeshift-labs/frontier-lang-kernel`](https://www.npmjs.com/package/@shapeshift-labs/frontier-lang-kernel): Runtime-neutral semantic source graph, type/lattice/extern declarations, patch bundles, replay, hashing, evidence records, and merge-admission kernel for Frontier Lang.
 - [`@shapeshift-labs/frontier-lang-parser`](https://www.npmjs.com/package/@shapeshift-labs/frontier-lang-parser): Dependency-light Frontier Lang parser for modules, entities, state, actions, effects, types, externs, targets, and lattice declarations.
 - [`@shapeshift-labs/frontier-lang-checker`](https://www.npmjs.com/package/@shapeshift-labs/frontier-lang-checker): Checker and diagnostics for Frontier Lang semantic documents, including type symbols, effects, regions, lattice laws, CRDT metadata, and patch evidence.
@@ -466,6 +475,8 @@ The published Frontier package family is generated from one shared package catal
 - [`@shapeshift-labs/frontier-lang-rust`](https://www.npmjs.com/package/@shapeshift-labs/frontier-lang-rust): Rust projection adapter for Frontier Lang semantic documents, including structs, aliases, and action stubs.
 - [`@shapeshift-labs/frontier-lang-python`](https://www.npmjs.com/package/@shapeshift-labs/frontier-lang-python): Python projection adapter for Frontier Lang semantic documents, including dataclasses, typed patch records, and action stubs.
 - [`@shapeshift-labs/frontier-lang-c`](https://www.npmjs.com/package/@shapeshift-labs/frontier-lang-c): C header projection adapter for Frontier Lang semantic documents, including structs and action prototypes.
+- [`@shapeshift-labs/frontier-lang-swift`](https://www.npmjs.com/package/@shapeshift-labs/frontier-lang-swift): Swift source-language importer package for Frontier Lang semantic documents, including package-level metadata, SwiftSyntax adapter helpers, native import results, and semantic sidecar generation for SwiftSyntax/SwiftParser-shaped syntax trees.
+- [`@shapeshift-labs/frontier-lang-kotlin`](https://www.npmjs.com/package/@shapeshift-labs/frontier-lang-kotlin): Kotlin PSI source-language importer package for Frontier Lang semantic documents, including package-level metadata, Kotlin PSI adapter helpers, native import results, and semantic sidecar generation for Kotlin PSI/KtFile-shaped syntax trees.
 - [`@shapeshift-labs/frontier-lang-java`](https://www.npmjs.com/package/@shapeshift-labs/frontier-lang-java): Java source-language importer package for Frontier Lang semantic documents, including package-level metadata, Java AST adapter helpers, native import results, and semantic sidecar generation for javac/JDT/JavaParser-shaped ASTs.
 - [`@shapeshift-labs/frontier-lang-go`](https://www.npmjs.com/package/@shapeshift-labs/frontier-lang-go): Go source-language importer package for Frontier Lang semantic documents, including package-level metadata, Go AST adapter helpers, native import results, and semantic sidecar generation for go/ast File or Package trees.
 - [`@shapeshift-labs/frontier-lang-csharp`](https://www.npmjs.com/package/@shapeshift-labs/frontier-lang-csharp): C# Roslyn source-language importer package for Frontier Lang semantic documents, including package-level metadata, Roslyn adapter helpers, native import results, and semantic sidecar generation for SyntaxTree/SyntaxNode-shaped ASTs.
@@ -557,6 +568,8 @@ Package source repositories:
 - [`siliconjungle/-shapeshift-labs-frontier-lang-python`](https://github.com/siliconjungle/-shapeshift-labs-frontier-lang-python)
 - [`siliconjungle/-shapeshift-labs-frontier-lang-c`](https://github.com/siliconjungle/-shapeshift-labs-frontier-lang-c)
 - [`siliconjungle/-shapeshift-labs-frontier-lang-compiler`](https://github.com/siliconjungle/-shapeshift-labs-frontier-lang-compiler)
+- [`siliconjungle/-shapeshift-labs-frontier-lang-swift`](https://github.com/siliconjungle/-shapeshift-labs-frontier-lang-swift)
+- [`siliconjungle/-shapeshift-labs-frontier-lang-kotlin`](https://github.com/siliconjungle/-shapeshift-labs-frontier-lang-kotlin)
 - [`siliconjungle/-shapeshift-labs-frontier-lang-java`](https://github.com/siliconjungle/-shapeshift-labs-frontier-lang-java)
 - [`siliconjungle/-shapeshift-labs-frontier-lang-go`](https://github.com/siliconjungle/-shapeshift-labs-frontier-lang-go)
 - [`siliconjungle/-shapeshift-labs-frontier-lang-csharp`](https://github.com/siliconjungle/-shapeshift-labs-frontier-lang-csharp)

package/bench/smoke.mjs

@@ -7,8 +7,10 @@ import {
   createEstreeNativeImporterAdapter,
   createGoAstNativeImporterAdapter,
   createJavaAstNativeImporterAdapter,
+  createKotlinPsiNativeImporterAdapter,
   createNativeImportCoverageMatrix,
   createNativeParserAstFormatMatrix,
+  createNativeParserFeatureMatrix,
   createProjectionTargetLossMatrix,
   createNativeSourcePreservation,
   createPythonAstNativeImporterAdapter,
@@ -19,6 +21,7 @@ import {
   importExternalSemanticIndex,
   importNativeSource,
   projectNativeImportToSource,
+  queryNativeParserFeatureMatrix,
   runNativeImporterAdapter,
   summarizeNativeImportFeatureEvidence
 } from '../dist/index.js';
@@ -48,6 +51,7 @@ const compileDurationMs = performance.now() - start;
 
 const importStart = performance.now();
 const estreeAdapter = createEstreeNativeImporterAdapter();
+const kotlinPsiAdapter = createKotlinPsiNativeImporterAdapter();
 let nativeSymbols = 0;
 const nativeImportResults = [];
 for (let index = 0; index < 150; index += 1) {
@@ -75,6 +79,37 @@ for (let index = 0; index < 150; index += 1) {
   nativeSymbols += imported.semanticIndex?.symbols?.length ?? 0;
   nativeImportResults.push(imported);
 }
+for (let index = 0; index < 50; index += 1) {
+  const imported = await runNativeImporterAdapter(kotlinPsiAdapter, {
+    sourcePath: `src/bench-${index}.kt`,
+    sourceText: `package bench\nclass BenchKotlin${index}(val title: String) { fun render${index}() = title }\n`,
+    adapterOptions: {
+      ast: {
+        kind: 'KtFile',
+        packageDirective: { kind: 'KtPackageDirective', fqName: 'bench' },
+        declarations: [{
+          kind: 'KtClass',
+          name: `BenchKotlin${index}`,
+          declarations: [{
+            kind: 'KtPrimaryConstructor',
+            parameters: [{
+              kind: 'KtParameter',
+              name: 'title',
+              typeReference: { text: 'String' },
+              valOrVarKeyword: 'val'
+            }]
+          }, {
+            kind: 'KtNamedFunction',
+            name: `render${index}`,
+            bodyExpression: { kind: 'KtBlockExpression' }
+          }]
+        }]
+      }
+    }
+  });
+  nativeSymbols += imported.semanticIndex?.symbols?.length ?? 0;
+  nativeImportResults.push(imported);
+}
 const importDurationMs = performance.now() - importStart;
 
 const matrixStart = performance.now();
@@ -84,10 +119,23 @@ const matrixDurationMs = performance.now() - matrixStart;
 const parserFormatMatrixStart = performance.now();
 const parserFormatMatrix = createNativeParserAstFormatMatrix({
   imports: nativeImportResults,
-  adapters: [estreeAdapter, createPythonAstNativeImporterAdapter(), createRustSynNativeImporterAdapter(), createClangAstNativeImporterAdapter(), createGoAstNativeImporterAdapter(), createJavaAstNativeImporterAdapter(), createCSharpRoslynNativeImporterAdapter(), createSwiftSyntaxNativeImporterAdapter()]
+  adapters: [estreeAdapter, createPythonAstNativeImporterAdapter(), createRustSynNativeImporterAdapter(), createClangAstNativeImporterAdapter(), createGoAstNativeImporterAdapter(), createJavaAstNativeImporterAdapter(), kotlinPsiAdapter, createCSharpRoslynNativeImporterAdapter(), createSwiftSyntaxNativeImporterAdapter()]
 });
 const parserFormatMatrixDurationMs = performance.now() - parserFormatMatrixStart;
 
+const parserFeatureMatrixStart = performance.now();
+const parserFeatureMatrix = createNativeParserFeatureMatrix({
+  imports: nativeImportResults,
+  adapters: [estreeAdapter, createPythonAstNativeImporterAdapter(), createRustSynNativeImporterAdapter(), createClangAstNativeImporterAdapter(), createGoAstNativeImporterAdapter(), createJavaAstNativeImporterAdapter(), kotlinPsiAdapter, createCSharpRoslynNativeImporterAdapter(), createSwiftSyntaxNativeImporterAdapter()],
+  requiredFeatures: ['syntax', 'semantic', 'sourcePreservation']
+});
+const parserFeatureQuery = queryNativeParserFeatureMatrix(parserFeatureMatrix, {
+  language: 'javascript',
+  parser: 'estree',
+  requiredFeatures: ['syntax', 'semantic', 'sourcePreservation']
+});
+const parserFeatureMatrixDurationMs = performance.now() - parserFeatureMatrixStart;
+
 const projectionMatrixStart = performance.now();
 const projectionLossMatrix = createProjectionTargetLossMatrix({ imports: nativeImportResults });
 const projectionMatrixDurationMs = performance.now() - projectionMatrixStart;
@@ -233,7 +281,7 @@ console.log(JSON.stringify({
   compiles: 250,
   bytes,
   compileDurationMs: Number(compileDurationMs.toFixed(2)),
-  nativeImports: 150,
+  nativeImports: nativeImportResults.length,
   nativeSymbols,
   nativeImportDurationMs: Number(importDurationMs.toFixed(2)),
   coverageMatrixLanguages: coverageMatrix.summary.languages,
@@ -247,6 +295,11 @@ console.log(JSON.stringify({
   parserFormatMatrixImports: parserFormatMatrix.summary.imports,
   parserFormatMatrixNativeAstNodes: parserFormatMatrix.summary.nativeAstNodes,
   parserFormatMatrixDurationMs: Number(parserFormatMatrixDurationMs.toFixed(2)),
+  parserFeatureMatrixParsers: parserFeatureMatrix.summary.parsers,
+  parserFeatureMatrixMergeReady: parserFeatureMatrix.summary.mergeReady,
+  parserFeatureMatrixSyntaxFull: parserFeatureMatrix.summary.byFeatureStatus.syntax?.full ?? 0,
+  parserFeatureQueryMergeReady: parserFeatureQuery.merge.mergeReady,
+  parserFeatureMatrixDurationMs: Number(parserFeatureMatrixDurationMs.toFixed(2)),
   projectionMatrixLanguages: projectionLossMatrix.summary.languages,
   projectionMatrixMissingAdapters: projectionLossMatrix.summary.missingAdapters,
   projectionMatrixUnsupportedTargetFeatures: projectionLossMatrix.summary.unsupportedTargetFeatures,

package/dist/index.d.ts

@@ -318,6 +318,161 @@ export interface NativeParserAstFormatMatrixOptions {
   readonly generatedAt?: number;
 }
 
+export type NativeParserFeatureCategory =
+  | 'syntax'
+  | 'semantic'
+  | 'type'
+  | 'controlFlow'
+  | 'macroMetaprogramming'
+  | 'sourcePreservation'
+  | string;
+
+export type NativeParserFeatureCoverageStatus =
+  | 'full'
+  | 'partial'
+  | 'evidence-required'
+  | 'missing'
+  | 'blocked'
+  | 'not-applicable'
+  | string;
+
+export interface NativeParserFeatureCoverage {
+  readonly category: NativeParserFeatureCategory;
+  readonly status: NativeParserFeatureCoverageStatus;
+  readonly readiness: SemanticMergeReadiness;
+  readonly mergeReady: boolean;
+  readonly supported: boolean;
+  readonly capabilities: Readonly<Record<string, unknown>>;
+  readonly gaps: readonly string[];
+  readonly lossKinds: Readonly<Record<string, number>>;
+  readonly reasons: readonly string[];
+  readonly notes: readonly string[];
+}
+
+export interface NativeParserFeatureCoverageMap {
+  readonly syntax: NativeParserFeatureCoverage;
+  readonly semantic: NativeParserFeatureCoverage;
+  readonly type: NativeParserFeatureCoverage;
+  readonly controlFlow: NativeParserFeatureCoverage;
+  readonly macroMetaprogramming: NativeParserFeatureCoverage;
+  readonly sourcePreservation: NativeParserFeatureCoverage;
+  readonly [category: string]: NativeParserFeatureCoverage;
+}
+
+export interface NativeParserFeatureMergeAssessment {
+  readonly mergeReady: boolean;
+  readonly readiness: SemanticMergeReadiness;
+  readonly requiredFeatures: readonly NativeParserFeatureCategory[];
+  readonly minimumReadiness: SemanticMergeReadiness;
+  readonly blockingFeatures: readonly NativeParserFeatureCategory[];
+  readonly reviewFeatures: readonly NativeParserFeatureCategory[];
+  readonly reasons: readonly string[];
+}
+
+export interface NativeParserFeatureParserRow {
+  readonly language: FrontierSourceLanguage | string;
+  readonly aliases: readonly string[];
+  readonly parser: string;
+  readonly parserFormat: string;
+  readonly parserAliases: readonly string[];
+  readonly parserAdapters: readonly string[];
+  readonly extensions: readonly string[];
+  readonly supportsLightweightScan: boolean;
+  readonly projectionTargets: readonly (FrontierCompileTarget | string)[];
+  readonly knownLossKinds: readonly NativeImportKnownLossKind[];
+  readonly defaultReadiness: SemanticMergeReadiness;
+  readonly notes: readonly string[];
+  readonly adapters: {
+    readonly total: number;
+    readonly ids: readonly string[];
+    readonly versions: readonly string[];
+    readonly exactness: readonly NativeImporterAdapterExactness[];
+    readonly coverage: NativeImporterAdapterCoverageAggregate;
+  };
+  readonly imports: {
+    readonly total: number;
+    readonly sourcePaths: readonly string[];
+    readonly readiness: SemanticMergeReadiness;
+    readonly readinessReasons: readonly string[];
+    readonly nativeAstNodes: number;
+    readonly symbols: number;
+    readonly references: number;
+    readonly types: number;
+    readonly controlFlow: number;
+    readonly sourceMaps: number;
+    readonly sourceMapMappings: number;
+    readonly losses: number;
+    readonly lossKinds: Readonly<Record<string, number>>;
+    readonly lossCategories: readonly NativeImportTaxonomyKind[];
+    readonly sourcePreservation: NativeImportSourcePreservationContract;
+  };
+  readonly features: NativeParserFeatureCoverageMap;
+  readonly merge: NativeParserFeatureMergeAssessment;
+}
+
+export interface NativeParserFeatureLanguageSummary {
+  readonly language: FrontierSourceLanguage | string;
+  readonly aliases: readonly string[];
+  readonly parserRows: number;
+  readonly parsers: readonly string[];
+  readonly imports: number;
+  readonly adapters: number;
+  readonly mergeReadyParsers: readonly string[];
+  readonly readiness: SemanticMergeReadiness;
+}
+
+export interface NativeParserFeatureMatrix {
+  readonly kind: 'frontier.lang.nativeParserFeatureMatrix';
+  readonly version: 1;
+  readonly generatedAt: number;
+  readonly parsers: readonly NativeParserFeatureParserRow[];
+  readonly languages: readonly NativeParserFeatureLanguageSummary[];
+  readonly summary: {
+    readonly languages: number;
+    readonly parsers: number;
+    readonly imports: number;
+    readonly adapters: number;
+    readonly mergeReady: number;
+    readonly byReadiness: Readonly<Record<SemanticMergeReadiness, number>>;
+    readonly byFeatureStatus: Readonly<Record<NativeParserFeatureCategory, Readonly<Record<NativeParserFeatureCoverageStatus, number>>>>;
+    readonly byFeatureReadiness: Readonly<Record<NativeParserFeatureCategory, Readonly<Record<SemanticMergeReadiness, number>>>>;
+  };
+  readonly metadata: {
+    readonly categories: readonly NativeParserFeatureCategory[];
+    readonly statuses: readonly NativeParserFeatureCoverageStatus[];
+    readonly requiredFeatures: readonly NativeParserFeatureCategory[];
+    readonly minimumReadiness: SemanticMergeReadiness;
+    readonly note: string;
+  };
+}
+
+export interface NativeParserFeatureMatrixOptions {
+  readonly languages?: readonly NativeImportLanguageProfile[];
+  readonly imports?: readonly NativeSourceImportResult[];
+  readonly adapters?: readonly NativeImporterAdapter[];
+  readonly requiredFeatures?: readonly NativeParserFeatureCategory[];
+  readonly minimumReadiness?: SemanticMergeReadiness;
+  readonly includeEmptyParsers?: boolean;
+  readonly generatedAt?: number;
+}
+
+export interface NativeParserFeatureMatrixQuery {
+  readonly language?: FrontierSourceLanguage | string;
+  readonly parser?: string;
+  readonly requiredFeatures?: readonly NativeParserFeatureCategory[];
+  readonly minimumReadiness?: SemanticMergeReadiness;
+}
+
+export interface NativeParserFeatureMatrixQueryResult {
+  readonly kind: 'frontier.lang.nativeParserFeatureQuery';
+  readonly version: 1;
+  readonly found: boolean;
+  readonly language?: FrontierSourceLanguage | string;
+  readonly parser?: string;
+  readonly row?: NativeParserFeatureParserRow;
+  readonly merge: NativeParserFeatureMergeAssessment;
+}
+
 export interface NativeImporterAdapterCoverageAggregate {
   readonly total: number;
   readonly declared: Readonly<Record<string, number>>;
@@ -1497,6 +1652,45 @@ export interface JavaAstNativeImporterAdapterOptions {
   readonly maxNodes?: number;
 }
 
+export interface KotlinPsiNativeImporterAdapterOptions {
+  readonly id?: string;
+  readonly language?: FrontierSourceLanguage;
+  readonly parser?: string;
+  readonly version?: string;
+  readonly capabilities?: readonly string[];
+  readonly coverage?: NativeImporterAdapterCoverageInput;
+  readonly supportedExtensions?: readonly string[];
+  readonly diagnostics?: readonly NativeImporterAdapterDiagnostic[];
+  readonly ast?: unknown;
+  readonly nativeAst?: unknown;
+  readonly ktFile?: unknown;
+  readonly file?: unknown;
+  readonly sourceFile?: unknown;
+  readonly root?: unknown;
+  readonly parse?: (sourceText: string, options: Record<string, unknown>) => unknown;
+  readonly parserModule?: { readonly parse: (sourceText: string, options: Record<string, unknown>) => unknown };
+  readonly kotlinPsi?: { readonly parse: (sourceText: string, options: Record<string, unknown>) => unknown };
+  readonly kotlinCompiler?: { readonly parse: (sourceText: string, options: Record<string, unknown>) => unknown };
+  readonly intellijPsi?: { readonly parse: (sourceText: string, options: Record<string, unknown>) => unknown };
+  readonly parserOptions?: Record<string, unknown>;
+  readonly kotlinVersion?: string;
+  readonly languageVersion?: string;
+  readonly apiVersion?: string;
+  readonly script?: boolean;
+  readonly generated?: boolean;
+  readonly analysisApiEvidence?: unknown;
+  readonly firEvidence?: unknown;
+  readonly compilerPluginEvidence?: unknown;
+  readonly kspEvidence?: unknown;
+  readonly kaptEvidence?: unknown;
+  readonly multiplatformEvidence?: unknown;
+  readonly buildVariantEvidence?: unknown;
+  readonly positionResolver?: (position: unknown) => unknown;
+  readonly lineMap?: unknown;
+  readonly includeAnnotations?: boolean;
+  readonly maxNodes?: number;
+}
+
 export interface CSharpRoslynNativeImporterAdapterOptions {
   readonly id?: string;
   readonly language?: FrontierSourceLanguage;
@@ -1903,6 +2097,8 @@ export declare const NativeImportTaxonomyKinds: readonly NativeImportTaxonomyKin
 export declare const NativeImportLossKinds: readonly NativeImportKnownLossKind[];
 export declare const NativeImportRegionTaxonomyKinds: readonly NativeImportRegionTaxonomyKind[];
 export declare const ProjectionTargetLossClasses: readonly ProjectionTargetLossClass[];
+export declare const NativeParserFeatureCategories: readonly NativeParserFeatureCategory[];
+export declare const NativeParserFeatureCoverageStatuses: readonly NativeParserFeatureCoverageStatus[];
 export declare const NativeImportReadinessBySeverity: Readonly<Record<NativeImportLossSummary['highestSeverity'], SemanticMergeReadiness>>;
 export declare const NativeImportFeatureEvidencePolicies: Readonly<Record<string, NativeImportFeatureEvidencePolicy>>;
 export declare const NativeImportLanguageProfiles: readonly NativeImportLanguageProfile[];
@@ -1926,6 +2122,8 @@ export declare function classifyNativeImportRoundtripReadiness(importResult: Nat
 export declare function createNativeImportCoverageMatrix(options?: NativeImportCoverageMatrixOptions): NativeImportCoverageMatrix;
 export declare function getNativeParserAstFormatProfile(format?: string): NativeParserAstFormatProfile | undefined;
 export declare function createNativeParserAstFormatMatrix(options?: NativeParserAstFormatMatrixOptions): NativeParserAstFormatMatrix;
+export declare function createNativeParserFeatureMatrix(options?: NativeParserFeatureMatrixOptions): NativeParserFeatureMatrix;
+export declare function queryNativeParserFeatureMatrix(matrixOrOptions?: NativeParserFeatureMatrix | NativeParserFeatureMatrixOptions, query?: NativeParserFeatureMatrixQuery): NativeParserFeatureMatrixQueryResult;
 export declare function createProjectionTargetLossMatrix(options?: ProjectionTargetLossMatrixOptions): ProjectionTargetLossMatrix;
 export declare function createNativeSourcePreservation(options: CreateNativeSourcePreservationOptions): NativeSourcePreservation;
 export declare function createSemanticImportSidecar(importResult: NativeSourceImportResult | NativeProjectImportResult, options?: SemanticImportSidecarOptions): SemanticImportSidecar;
@@ -1938,6 +2136,7 @@ export declare function createRustSynNativeImporterAdapter(options?: RustSynNati
 export declare function createClangAstNativeImporterAdapter(options?: ClangAstNativeImporterAdapterOptions): NativeImporterAdapter;
 export declare function createGoAstNativeImporterAdapter(options?: GoAstNativeImporterAdapterOptions): NativeImporterAdapter;
 export declare function createJavaAstNativeImporterAdapter(options?: JavaAstNativeImporterAdapterOptions): NativeImporterAdapter;
+export declare function createKotlinPsiNativeImporterAdapter(options?: KotlinPsiNativeImporterAdapterOptions): NativeImporterAdapter;
 export declare function createCSharpRoslynNativeImporterAdapter(options?: CSharpRoslynNativeImporterAdapterOptions): NativeImporterAdapter;
 export declare function createSwiftSyntaxNativeImporterAdapter(options?: SwiftSyntaxNativeImporterAdapterOptions): NativeImporterAdapter;
 export declare function createTreeSitterNativeImporterAdapter(options?: TreeSitterNativeImporterAdapterOptions): NativeImporterAdapter;