@reckona/mreact-compiler 0.0.160 → 0.0.161

package/dist/internal.d.ts

@@ -4,46 +4,55 @@ export { transformCompilerModuleContext } from "./transform.js";
 export { stripTypeScriptWithOxc } from "./oxc-transform.js";
 export type { CompilerModuleContext } from "./compiler-module-context.js";
 import type { AnalyzeModuleOptions, CompileTarget, Diagnostic } from "./types.js";
+/** Configures source code, filename, target, and analysis options for IR generation. */
 export interface AnalyzeToIrInput {
     code: string;
     filename: string;
     target: CompileTarget;
     options?: AnalyzeModuleOptions;
 }
+/** Contains the module IR and diagnostics produced by compiler analysis. */
 export interface AnalyzeToIrOutput {
     ir: ModuleIr;
     diagnostics: Diagnostic[];
     usedTypescriptFallback?: boolean;
 }
+/** Describes a static import declaration and the local names it introduces. */
 export interface StaticImportReference {
     localNames: string[];
     sideEffect: boolean;
     source: string;
 }
+/** Describes one specifier inside a static import declaration. */
 export interface StaticImportSpecifierReference {
     importedName: string;
     kind: "default" | "named" | "namespace";
     localName: string;
 }
+/** Describes a static import declaration with its individual specifiers. */
 export interface ClientRouteStaticImportReference extends StaticImportReference {
     specifiers: StaticImportSpecifierReference[];
 }
+/** Describes a static export declaration and the names it exports. */
 export interface StaticExportReference {
     exportedNames: string[];
     exportAll: boolean;
     specifiers: StaticExportSpecifierReference[];
     source: string;
 }
+/** Describes one specifier inside a static export declaration. */
 export interface StaticExportSpecifierReference {
     exportedName: string;
     localName: string;
 }
+/** Describes render and client-runtime reachability for one top-level export. */
 export interface TopLevelExportRenderInfo {
     calledComponentRoots: string[];
     clientRuntime: boolean;
     name: string;
     renderedComponentRoots: string[];
 }
+/** Summarizes route-module imports, exports, directives, references, and reachable render roots. */
 export interface ClientRouteModuleAnalysis {
     clientRuntime: boolean;
     defaultExportIdentifier: string | undefined;
@@ -60,11 +69,13 @@ export interface ClientRouteModuleAnalysis {
     staticImports: ClientRouteStaticImportReference[];
     topLevelExportRenderInfo: TopLevelExportRenderInfo[];
 }
+/** Describes a named form action reference and its source span. */
 export interface FormActionReference {
     end: number;
     name: string;
     start: number;
 }
+/** Describes a form action expression reference and both wrapper and expression source spans. */
 export interface FormActionExpressionReference {
     end: number;
     expression: string;
@@ -72,91 +83,115 @@ export interface FormActionExpressionReference {
     expressionStart: number;
     start: number;
 }
+/** Analyzes source code into compiler IR with diagnostics. */
 export declare function analyzeToIr(input: AnalyzeToIrInput): AnalyzeToIrOutput;
+/** Analyzes a pre-parsed compiler module context into compiler IR with diagnostics. */
 export declare function analyzeCompilerModuleContextToIr(context: CompilerModuleContext, input: Omit<AnalyzeToIrInput, "code" | "filename">): AnalyzeToIrOutput;
+/** Creates a compiler module context from source code and an optional filename. */
 export declare function createCompilerModuleContext(input: {
     code: string;
     filename?: string | undefined;
 }): CompilerModuleContext;
+/** Checks whether a module declares any of the given names as top-level exports. */
 export declare function hasTopLevelExportDeclaration(input: {
     code: string;
     filename?: string | undefined;
     names: readonly string[];
 }): boolean;
+/** Reads a top-level exported boolean literal by name, ignoring comments and non-literal values. */
 export declare function readTopLevelBooleanExport(input: {
     code: string;
     filename?: string | undefined;
     name: string;
 }): boolean | undefined;
+/** Reads a top-level exported boolean literal from a cached compiler module context. */
 export declare function readTopLevelBooleanExportFromContext(context: CompilerModuleContext, name: string): boolean | undefined;
+/** Removes top-level export declarations for selected names while preserving their values where possible. */
 export declare function stripTopLevelExportDeclarations(input: {
     code: string;
     filename?: string | undefined;
     names: readonly string[];
 }): string;
+/** Converts selected top-level export declarations into non-exported declarations. */
 export declare function demoteTopLevelExportDeclarations(input: {
     code: string;
     filename?: string | undefined;
     names: readonly string[];
 }): string;
+/** Removes unused static value imports while preserving side-effect and type-only imports. */
 export declare function stripUnusedStaticValueImports(input: {
     code: string;
     filename?: string | undefined;
 }): string;
+/** Collects module specifier strings from static import and export declarations. */
 export declare function collectStaticModuleSpecifiers(input: {
     code: string;
     filename?: string | undefined;
 }): string[];
+/** Collects static import declarations and their local binding names. */
 export declare function collectStaticImportReferences(input: {
     code: string;
     filename?: string | undefined;
 }): StaticImportReference[];
+/** Collects static export declarations and their exported names. */
 export declare function collectStaticExportReferences(input: {
     code: string;
     filename?: string | undefined;
 }): StaticExportReference[];
+/** Collects root component names referenced by JSX elements in a module. */
 export declare function collectJsxComponentRootNames(input: {
     code: string;
     filename?: string | undefined;
 }): string[];
+/** Collects identifier reference names from a module, excluding declarations. */
 export declare function collectIdentifierReferenceNames(input: {
     code: string;
     filename?: string | undefined;
 }): string[];
+/** Checks whether browser globals may execute during server rendering without a guard. */
 export declare function hasUnguardedBrowserGlobalReference(input: {
     code: string;
     filename?: string | undefined;
 }): boolean;
+/** Collects unique named form action references from a module. */
 export declare function collectFormActionReferenceNames(input: {
     code: string;
     filename?: string | undefined;
 }): string[];
+/** Collects named form action references and their source spans from a module. */
 export declare function collectFormActionReferences(input: {
     code: string;
     filename?: string | undefined;
 }): FormActionReference[];
+/** Collects form action expression references and their source spans from a module. */
 export declare function collectFormActionExpressionReferences(input: {
     code: string;
     filename?: string | undefined;
 }): FormActionExpressionReference[];
+/** Collects value export names declared at the top level of a module. */
 export declare function collectTopLevelValueExportNames(input: {
     code: string;
     filename?: string | undefined;
 }): string[];
+/** Collects render reachability information for top-level exports in a module. */
 export declare function collectTopLevelExportRenderInfo(input: {
     code: string;
     filename?: string | undefined;
 }): TopLevelExportRenderInfo[];
+/** Analyzes a route module for directives, static imports, exports, references, and render reachability. */
 export declare function collectClientRouteModuleAnalysis(input: {
     code: string;
     filename?: string | undefined;
 }): ClientRouteModuleAnalysis;
+/** Analyzes a cached compiler module context for route-module metadata. */
 export declare function collectClientRouteModuleAnalysisFromContext(context: CompilerModuleContext): ClientRouteModuleAnalysis;
+/** Checks whether a module begins with a specific directive string. */
 export declare function hasModuleDirective(input: {
     code: string;
     directive: string;
     filename?: string | undefined;
 }): boolean;
+/** Checks whether a module contains syntax that requires client runtime execution. */
 export declare function hasClientRuntimeSyntax(input: {
     code: string;
     filename?: string | undefined;

package/dist/internal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"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"}

package/dist/internal.js

@@ -2,29 +2,29 @@ import { analyzeCompilerModuleContextWithOxc, analyzeWithOxc, } from "./oxc.js";
 import { createCompilerModuleContextWithOxc, } from "./compiler-module-context.js";
 export { transformCompilerModuleContext } from "./transform.js";
 export { stripTypeScriptWithOxc } from "./oxc-transform.js";
+/** Analyzes source code into compiler IR with diagnostics. */
 export function analyzeToIr(input) {
     return analyzeWithOxc(input);
 }
+/** Analyzes a pre-parsed compiler module context into compiler IR with diagnostics. */
 export function analyzeCompilerModuleContextToIr(context, input) {
     return analyzeCompilerModuleContextWithOxc(context, input);
 }
+/** Creates a compiler module context from source code and an optional filename. */
 export function createCompilerModuleContext(input) {
     return createCompilerModuleContextWithOxc(input);
 }
+/** Checks whether a module declares any of the given names as top-level exports. */
 export function hasTopLevelExportDeclaration(input) {
     const names = new Set(input.names);
     const parsed = parseModule(input.code, input.filename);
     return programBody(parsed.program).some((statement) => exportedNames(statement).some((name) => names.has(name)));
 }
-// Reads the value of a top-level `export const <name> = <boolean literal>`
-// declaration. Returns `undefined` when the export is absent or not a boolean
-// literal. AST-based so commented-out or string-literal occurrences of the same
-// text are not mistaken for a real export.
+/** Reads a top-level exported boolean literal by name, ignoring comments and non-literal values. */
 export function readTopLevelBooleanExport(input) {
     return readTopLevelBooleanExportFromContext(createCompilerModuleContext({ code: input.code, filename: input.filename }), input.name);
 }
-// Context-accepting variant so callers with a cached `CompilerModuleContext`
-// (e.g. the dev server) avoid re-parsing the module per request.
+/** Reads a top-level exported boolean literal from a cached compiler module context. */
 export function readTopLevelBooleanExportFromContext(context, name) {
     const parsed = parseModuleContext(context);
     for (const statement of programBody(parsed.program)) {
@@ -63,6 +63,7 @@ function booleanExpressionValue(node) {
     }
     return undefined;
 }
+/** Removes top-level export declarations for selected names while preserving their values where possible. */
 export function stripTopLevelExportDeclarations(input) {
     const names = new Set(input.names);
     const parsed = parseModule(input.code, input.filename);
@@ -76,6 +77,7 @@ export function stripTopLevelExportDeclarations(input) {
     }
     return code;
 }
+/** Converts selected top-level export declarations into non-exported declarations. */
 export function demoteTopLevelExportDeclarations(input) {
     const names = new Set(input.names);
     const parsed = parseModule(input.code, input.filename);
@@ -89,6 +91,7 @@ export function demoteTopLevelExportDeclarations(input) {
     }
     return code;
 }
+/** Removes unused static value imports while preserving side-effect and type-only imports. */
 export function stripUnusedStaticValueImports(input) {
     const parsed = parseModule(input.code, input.filename);
     const referencedNames = new Set(collectIdentifierReferenceNames(input));
@@ -102,18 +105,22 @@ export function stripUnusedStaticValueImports(input) {
     }
     return code;
 }
+/** Collects module specifier strings from static import and export declarations. */
 export function collectStaticModuleSpecifiers(input) {
     const parsed = parseModule(input.code, input.filename);
     return programBody(parsed.program).flatMap(staticModuleSpecifier);
 }
+/** Collects static import declarations and their local binding names. */
 export function collectStaticImportReferences(input) {
     const parsed = parseModule(input.code, input.filename);
     return programBody(parsed.program).flatMap(staticImportReference);
 }
+/** Collects static export declarations and their exported names. */
 export function collectStaticExportReferences(input) {
     const parsed = parseModule(input.code, input.filename);
     return programBody(parsed.program).flatMap(staticExportReference);
 }
+/** Collects root component names referenced by JSX elements in a module. */
 export function collectJsxComponentRootNames(input) {
     const parsed = parseModule(input.code, input.filename);
     const names = new Set();
@@ -123,34 +130,30 @@ export function collectJsxComponentRootNames(input) {
     expandJsxComponentAliasRoots(names, aliasState.aliases);
     return Array.from(names).sort();
 }
+/** Collects identifier reference names from a module, excluding declarations. */
 export function collectIdentifierReferenceNames(input) {
     const parsed = parseModule(input.code, input.filename);
     const names = new Set();
     collectIdentifierReferenceNamesFromNode(parsed.program, names);
     return Array.from(names).sort();
 }
-// Returns true when the module references a browser global (`window`,
-// `document`, `localStorage`) in a position that may execute during server
-// rendering. A reference is considered guarded -- and therefore server-safe --
-// when it can only evaluate behind a `typeof window !== "undefined"` style
-// check: the guarded branch of an if/ternary, the short-circuited side of a
-// logical expression, or statements following a guarded early exit. A guard on
-// any one browser global covers the others, matching how isomorphic modules
-// are written in practice. Alias-tracked guards (`const isBrowser = ...`) are
-// not followed; they conservatively report an unguarded reference.
+/** Checks whether browser globals may execute during server rendering without a guard. */
 export function hasUnguardedBrowserGlobalReference(input) {
     const parsed = parseModule(input.code, input.filename);
     return hasUnguardedBrowserGlobalReferenceInNode(parsed.program, false);
 }
+/** Collects unique named form action references from a module. */
 export function collectFormActionReferenceNames(input) {
     return Array.from(new Set(collectFormActionReferences(input).map((reference) => reference.name))).sort();
 }
+/** Collects named form action references and their source spans from a module. */
 export function collectFormActionReferences(input) {
     const parsed = parseModule(input.code, input.filename);
     const references = [];
     collectFormActionReferencesFromNode(parsed.program, references);
     return references.sort((left, right) => left.start === right.start ? left.name.localeCompare(right.name) : left.start - right.start);
 }
+/** Collects form action expression references and their source spans from a module. */
 export function collectFormActionExpressionReferences(input) {
     const parsed = parseModule(input.code, input.filename);
     const references = [];
@@ -159,6 +162,7 @@ export function collectFormActionExpressionReferences(input) {
         ? left.expression.localeCompare(right.expression)
         : left.start - right.start);
 }
+/** Collects value export names declared at the top level of a module. */
 export function collectTopLevelValueExportNames(input) {
     const parsed = parseModule(input.code, input.filename);
     const names = new Set();
@@ -169,14 +173,17 @@ export function collectTopLevelValueExportNames(input) {
     }
     return Array.from(names).sort();
 }
+/** Collects render reachability information for top-level exports in a module. */
 export function collectTopLevelExportRenderInfo(input) {
     const parsed = parseModule(input.code, input.filename);
     return collectTopLevelExportRenderInfoFromProgram(parsed.program);
 }
+/** Analyzes a route module for directives, static imports, exports, references, and render reachability. */
 export function collectClientRouteModuleAnalysis(input) {
     const parsed = parseModule(input.code, input.filename);
     return collectClientRouteModuleAnalysisFromContext(parsed);
 }
+/** Analyzes a cached compiler module context for route-module metadata. */
 export function collectClientRouteModuleAnalysisFromContext(context) {
     const parsed = parseModuleContext(context);
     const body = programBody(parsed.program);
@@ -559,6 +566,7 @@ function isNonComputedPropertyKey(node) {
         node.type === "MethodDefinition") &&
         node.computed !== true);
 }
+/** Checks whether a module begins with a specific directive string. */
 export function hasModuleDirective(input) {
     const parsed = parseModule(input.code, input.filename);
     return hasModuleDirectiveInProgram(parsed.program, input.directive);
@@ -578,6 +586,7 @@ function hasModuleDirectiveInProgram(program, expectedDirective) {
     }
     return false;
 }
+/** Checks whether a module contains syntax that requires client runtime execution. */
 export function hasClientRuntimeSyntax(input) {
     const parsed = parseModule(input.code, input.filename);
     return hasClientRuntimeSyntaxNode(parsed.program);