noxcturnal 0.1.2 → 0.1.3

package/README.md

@@ -63,6 +63,25 @@ Every plugin in a phase observes the same immutable input. Its edits become visi
 phase boundary, after validation and an optional reparse. Split dependent transforms into separate
 phases when a later transform must observe an earlier transform's output.
 
+Plugins that only apply to particular syntax can declare a necessary condition:
+
+```ts
+contract: {
+  syntax: {
+    anyOf: ['AsyncFunction', 'Super'];
+  }
+}
+```
+
+The plugin runs only when at least one listed feature occurs in the current phase's input.
+Features are concrete AST node kinds, plus `AsyncFunction` (including async arrows and methods)
+and `GeneratorFunction` (including generator methods). Comments, strings, and property names do
+not count as the syntax they mention. Choose a conservative condition: use `analyze` for further
+semantic checks. A rejected plugin skips all lifecycle hooks, including state creation and cleanup,
+and adds no retention or child hydration requirements. Native syntax selection shares the input
+parse with active visitors and is reevaluated when earlier phases change the source. Pipelines
+without syntax requirements keep their existing execution path.
+
 `path.matchesPattern()` uses native AST facts. Declare `fields: ['memberPath']` for static or
 computed member expressions or `fields: ['name']` for identifiers, including in child contracts.
 Missing declarations throw. An identifier reached through a `memberPath` declaration returns false,

package/dist/noxcturnal.d.ts

@@ -1047,7 +1047,7 @@ interface NativeChildRoles {
   };
   TSModuleDeclaration: {
     readonly body: {
-      readonly child: 'TSModuleBlock';
+      readonly child: 'TSModuleBlock' | 'TSModuleDeclaration';
       readonly list: false;
     };
   };
@@ -4431,6 +4431,8 @@ interface PreflightReactRefresh {
 }
 /** Focused Metro-compatible post-processing. Each operation is independently selectable. */
 interface PreflightOptimize {
+  /** Top-level bindings are private to a module wrapper. Affects DCE only, not parsing. */
+  moduleContext?: boolean | undefined;
   constantFolding?: boolean | undefined;
   deadCodeElimination?: boolean | undefined;
 }
@@ -4828,7 +4830,9 @@ declare enum ArtifactDemand {
 }
 
 interface NativePreflightOptionsInput {
+  functionMap?: boolean;
   sourceFilename?: string;
+  optimizationModuleContext?: boolean;
   reactCompiler?: boolean;
   reactCompilerCompilationMode?: string;
   reactCompilerPanicThreshold?: string;
@@ -4889,6 +4893,7 @@ interface NativePreflightOptionsInput {
 }
 interface NativePreflightResultOutput {
   status: 'complete' | 'unsupported' | 'error';
+  functionMap?: FunctionMap;
   changed: boolean;
   normalizedJavascript: boolean;
   jsx: boolean;
@@ -4901,6 +4906,20 @@ interface NativePreflightResultOutput {
   helpersUsed: string[];
 }
 interface NativeBinding$1 {
+  NativeParsedSource: new (
+    source: string,
+    filename: string
+  ) => {
+    syntaxFacts(): string[];
+    functionMap(): FunctionMap;
+    materializeRouted(manifest: Buffer): Buffer;
+    materialize(
+      retentionManifest: Buffer,
+      initialRouteManifest: Buffer
+    ): NativeIndexedSessionBinding;
+    validate(): void;
+    close(): void;
+  };
   NativeSourceText: new (source: string) => {
     generateUid(name: string, filename: string): string;
     whitespace(): number[];
@@ -4943,9 +4962,16 @@ interface NativeBinding$1 {
     initialRouteManifest?: Buffer,
     buildInitialRoute?: boolean
   ) => {
+    generateUid(name: string): string | null;
     nextRoutedPacked(manifest: Buffer, rootStart?: number, rootEnd?: number): Buffer;
     queryGlobalsBuffer(names: string[]): Buffer;
     globalBindingReferencesBuffer(name: string): Buffer;
+    queryBindingsBatch(
+      requests: {
+        name: string;
+        scopeId: number;
+      }[]
+    ): ReturnType<NativeIndexedSessionBinding['queryBindings']>;
     queryBindings(
       name?: string,
       scopeId?: number,
@@ -5052,6 +5078,13 @@ interface NativeBinding$1 {
       calleeGlobal: boolean;
       staticArgument?: string;
     }[];
+    queryCallsBatch(
+      requests: {
+        callee: string;
+        globalOnly?: boolean;
+        staticArguments?: boolean;
+      }[]
+    ): ReturnType<NativeIndexedSessionBinding['queryCalls']>[];
     queryNodesPackedBuffer(nodeTypes: string[]): Buffer;
     scopeParentId(scopeId: number): number | null;
     close(): void;
@@ -5151,7 +5184,7 @@ interface NativeBinding$1 {
     rootEnd?: number
   ): Buffer;
   /**
-   * Throws for a construct no implementation compiles — a `var` binding in a
+   * Throws for internal failures and invalid constructs — a `var` binding in a
    * match pattern, say. `bailed` is for everything the erasure merely does not
    * cover, where the parser adapter is expected to take over; a throw means it
    * would fail too, so the message is the answer.
@@ -5175,6 +5208,7 @@ interface NativeBinding$1 {
   validateStatements(code: string, parserMode?: string): void;
 }
 declare const native: NativeBinding$1;
+type NativeIndexedSessionBinding = InstanceType<NativeBinding$1['NativeIndexedSession']>;
 
 declare class NativeTransformError extends Error {
   readonly diagnostics: Diagnostic[];
@@ -6016,12 +6050,20 @@ declare function defineVisitor<
   contract: Contract & ValidateContract<Route, Contract>,
   handler: TypedVisitorHandler<Route, Contract, State>
 ): DefinedVisitor<State>;
+/** Concrete AST kinds, plus function modifiers needed by compatibility repairs. */
+type SyntaxFeature = NativeNodeType | 'AsyncFunction' | 'GeneratorFunction';
 /**
- * Plugin-level requirements and typings for `context`: metadata ownership and
- * semantic queries. The visitor contract types the path; the plugin contract
- * types the context.
+ * Plugin-level requirements and typings for `context`: syntax applicability,
+ * metadata ownership, and semantic queries. The visitor contract types the path;
+ * the plugin contract types the context.
  */
 interface PluginContract {
+  /** Run this plugin only when at least one feature occurs in the current phase
+   * input. Rejected plugins skip every lifecycle hook and contribute no retained
+   * data. Comments and string contents do not count as syntax. */
+  syntax?: {
+    readonly anyOf: readonly SyntaxFeature[];
+  };
   metadata?: {
     writes?: readonly string[];
     reads?: readonly string[];
@@ -6396,6 +6438,7 @@ export type {
   SourceMapMode,
   StoredVisitorContract,
   StringLiteralView,
+  SyntaxFeature,
   TransformDecision,
   TransformOptions,
   TransformResult,