@knighted/jsx 1.10.0 → 1.12.0

package/dist/cjs/transform.cjs

@@ -120,6 +120,165 @@ const collectImportMetadata = (body) => {
     });
     return imports;
 };
+const toIdentifierName = (value) => {
+    if (!isObjectRecord(value)) {
+        return null;
+    }
+    if (value.type !== 'Identifier') {
+        return null;
+    }
+    return typeof value.name === 'string' ? value.name : null;
+};
+const toVariableInitializerKind = (value) => {
+    if (!isObjectRecord(value) || typeof value.type !== 'string') {
+        return null;
+    }
+    if (value.type === 'ArrowFunctionExpression') {
+        return 'arrow-function';
+    }
+    if (value.type === 'FunctionExpression') {
+        return 'function-expression';
+    }
+    if (value.type === 'ClassExpression') {
+        return 'class-expression';
+    }
+    return 'other';
+};
+const pushTopLevelDeclarationMetadata = ({ declaration, exportKind, statementRange, declarations, }) => {
+    if (declaration.type === 'FunctionDeclaration') {
+        const name = toIdentifierName(declaration.id);
+        if (!name) {
+            return;
+        }
+        declarations.push({
+            name,
+            kind: 'function',
+            exportKind,
+            range: toSourceRange(declaration),
+            statementRange,
+            initializerKind: null,
+        });
+        return;
+    }
+    if (declaration.type === 'ClassDeclaration') {
+        const name = toIdentifierName(declaration.id);
+        if (!name) {
+            return;
+        }
+        declarations.push({
+            name,
+            kind: 'class',
+            exportKind,
+            range: toSourceRange(declaration),
+            statementRange,
+            initializerKind: null,
+        });
+        return;
+    }
+    if (!Array.isArray(declaration.declarations)) {
+        return;
+    }
+    for (const declarator of declaration.declarations) {
+        if (!isObjectRecord(declarator)) {
+            continue;
+        }
+        const name = toIdentifierName(declarator.id);
+        if (!name) {
+            continue;
+        }
+        declarations.push({
+            name,
+            kind: 'variable',
+            exportKind,
+            range: toSourceRange(declarator),
+            statementRange,
+            initializerKind: toVariableInitializerKind(declarator.init),
+        });
+    }
+};
+const collectTopLevelDeclarationMetadata = (body) => {
+    if (!Array.isArray(body)) {
+        return [];
+    }
+    const declarations = [];
+    for (const statement of body) {
+        if (!isObjectRecord(statement) || typeof statement.type !== 'string') {
+            continue;
+        }
+        const statementRange = toSourceRange(statement);
+        if (statement.type === 'ExportNamedDeclaration') {
+            if (!isObjectRecord(statement.declaration)) {
+                continue;
+            }
+            pushTopLevelDeclarationMetadata({
+                declaration: statement.declaration,
+                exportKind: 'named',
+                statementRange,
+                declarations,
+            });
+            continue;
+        }
+        if (statement.type === 'ExportDefaultDeclaration') {
+            if (!isObjectRecord(statement.declaration)) {
+                continue;
+            }
+            pushTopLevelDeclarationMetadata({
+                declaration: statement.declaration,
+                exportKind: 'default',
+                statementRange,
+                declarations,
+            });
+            continue;
+        }
+        pushTopLevelDeclarationMetadata({
+            declaration: statement,
+            exportKind: 'none',
+            statementRange,
+            declarations,
+        });
+    }
+    return declarations;
+};
+const unwrapExpressionNode = (value) => {
+    let current = value;
+    while (isObjectRecord(current) && typeof current.type === 'string') {
+        if (current.type === 'ParenthesizedExpression') {
+            current = current.expression;
+            continue;
+        }
+        if (current.type === 'TSAsExpression' ||
+            current.type === 'TSSatisfiesExpression' ||
+            current.type === 'TSInstantiationExpression' ||
+            current.type === 'TSNonNullExpression' ||
+            current.type === 'TSTypeAssertion') {
+            current = current.expression;
+            continue;
+        }
+        break;
+    }
+    return current;
+};
+const isJsxExpressionNode = (value) => {
+    const unwrapped = unwrapExpressionNode(value);
+    if (!isObjectRecord(unwrapped) || typeof unwrapped.type !== 'string') {
+        return false;
+    }
+    return unwrapped.type === 'JSXElement' || unwrapped.type === 'JSXFragment';
+};
+const collectTopLevelJsxExpressionMetadata = (body) => {
+    if (!Array.isArray(body)) {
+        return false;
+    }
+    for (const statement of body) {
+        if (!isObjectRecord(statement) || statement.type !== 'ExpressionStatement') {
+            continue;
+        }
+        if (isJsxExpressionNode(statement.expression)) {
+            return true;
+        }
+    }
+    return false;
+};
 const ensureSupportedOptions = (options) => {
     if (options.sourceType !== undefined &&
         options.sourceType !== 'module' &&
@@ -136,6 +295,14 @@ const ensureSupportedOptions = (options) => {
         options.typescriptStripBackend !== 'transpile-manual') {
         throw new Error(`[jsx] Unsupported typescriptStripBackend "${String(options.typescriptStripBackend)}". Use "oxc-transform" or "transpile-manual".`);
     }
+    if (options.collectTopLevelDeclarations !== undefined &&
+        typeof options.collectTopLevelDeclarations !== 'boolean') {
+        throw new Error(`[jsx] Unsupported collectTopLevelDeclarations value "${String(options.collectTopLevelDeclarations)}". Use true or false.`);
+    }
+    if (options.collectTopLevelJsxExpression !== undefined &&
+        typeof options.collectTopLevelJsxExpression !== 'boolean') {
+        throw new Error(`[jsx] Unsupported collectTopLevelJsxExpression value "${String(options.collectTopLevelJsxExpression)}". Use true or false.`);
+    }
 };
 function transformJsxSource(source, options = {}) {
     const internalOptions = options;
@@ -146,12 +313,20 @@ function transformJsxSource(source, options = {}) {
     const parsed = (0, oxc_parser_1.parseSync)('transform-jsx-source.tsx', source, createParserOptions(sourceType));
     const parserDiagnostics = parsed.errors.map(error => toDiagnostic('parser', error));
     const imports = collectImportMetadata(parsed.program.body);
+    const declarations = internalOptions.collectTopLevelDeclarations
+        ? collectTopLevelDeclarationMetadata(parsed.program.body)
+        : undefined;
+    const hasTopLevelJsxExpression = internalOptions.collectTopLevelJsxExpression
+        ? collectTopLevelJsxExpressionMetadata(parsed.program.body)
+        : undefined;
     if (parserDiagnostics.length) {
         return {
             code: source,
             changed: false,
             imports,
             diagnostics: parserDiagnostics,
+            declarations,
+            hasTopLevelJsxExpression,
         };
     }
     const transpileBaseOptions = {
@@ -167,6 +342,8 @@ function transformJsxSource(source, options = {}) {
             changed: result.changed,
             imports,
             diagnostics: parserDiagnostics,
+            declarations,
+            hasTopLevelJsxExpression,
         };
     }
     if (typescriptStripBackend === 'transpile-manual') {
@@ -179,6 +356,8 @@ function transformJsxSource(source, options = {}) {
             changed: result.changed,
             imports,
             diagnostics: parserDiagnostics,
+            declarations,
+            hasTopLevelJsxExpression,
         };
     }
     const transformed = (0, oxc_transform_1.transformSync)('transform-jsx-source.tsx', source, {
@@ -196,6 +375,8 @@ function transformJsxSource(source, options = {}) {
             changed: fallbackCode !== source,
             imports,
             diagnostics,
+            declarations,
+            hasTopLevelJsxExpression,
         };
     }
     const jsxResult = (0, transpile_js_1.transpileJsxSource)(transformed.code, transpileBaseOptions);
@@ -204,5 +385,7 @@ function transformJsxSource(source, options = {}) {
         changed: jsxResult.code !== source,
         imports,
         diagnostics,
+        declarations,
+        hasTopLevelJsxExpression,
     };
 }

package/dist/cjs/transform.d.cts

@@ -23,12 +23,28 @@ export type TransformImport = {
     bindings: TransformImportBinding[];
     range: SourceRange | null;
 };
-export type TransformJsxSourceOptions = TranspileJsxSourceOptions;
+export type TransformTopLevelDeclarationKind = 'function' | 'class' | 'variable';
+export type TransformTopLevelDeclarationExportKind = 'none' | 'named' | 'default';
+export type TransformVariableInitializerKind = 'arrow-function' | 'function-expression' | 'class-expression' | 'other' | null;
+export type TransformTopLevelDeclaration = {
+    name: string;
+    kind: TransformTopLevelDeclarationKind;
+    exportKind: TransformTopLevelDeclarationExportKind;
+    range: SourceRange | null;
+    statementRange: SourceRange | null;
+    initializerKind: TransformVariableInitializerKind;
+};
+export type TransformJsxSourceOptions = TranspileJsxSourceOptions & {
+    collectTopLevelDeclarations?: boolean;
+    collectTopLevelJsxExpression?: boolean;
+};
 export type TransformJsxSourceResult = {
     code: string;
     changed: boolean;
     imports: TransformImport[];
     diagnostics: TransformDiagnostic[];
+    declarations?: TransformTopLevelDeclaration[];
+    hasTopLevelJsxExpression?: boolean;
 };
 export declare function transformJsxSource(source: string, options?: TransformJsxSourceOptions): TransformJsxSourceResult;
 export {};

package/dist/transform.d.ts

@@ -23,12 +23,28 @@ export type TransformImport = {
     bindings: TransformImportBinding[];
     range: SourceRange | null;
 };
-export type TransformJsxSourceOptions = TranspileJsxSourceOptions;
+export type TransformTopLevelDeclarationKind = 'function' | 'class' | 'variable';
+export type TransformTopLevelDeclarationExportKind = 'none' | 'named' | 'default';
+export type TransformVariableInitializerKind = 'arrow-function' | 'function-expression' | 'class-expression' | 'other' | null;
+export type TransformTopLevelDeclaration = {
+    name: string;
+    kind: TransformTopLevelDeclarationKind;
+    exportKind: TransformTopLevelDeclarationExportKind;
+    range: SourceRange | null;
+    statementRange: SourceRange | null;
+    initializerKind: TransformVariableInitializerKind;
+};
+export type TransformJsxSourceOptions = TranspileJsxSourceOptions & {
+    collectTopLevelDeclarations?: boolean;
+    collectTopLevelJsxExpression?: boolean;
+};
 export type TransformJsxSourceResult = {
     code: string;
     changed: boolean;
     imports: TransformImport[];
     diagnostics: TransformDiagnostic[];
+    declarations?: TransformTopLevelDeclaration[];
+    hasTopLevelJsxExpression?: boolean;
 };
 export declare function transformJsxSource(source: string, options?: TransformJsxSourceOptions): TransformJsxSourceResult;
 export {};

package/dist/transform.js

@@ -117,6 +117,165 @@ const collectImportMetadata = (body) => {
     });
     return imports;
 };
+const toIdentifierName = (value) => {
+    if (!isObjectRecord(value)) {
+        return null;
+    }
+    if (value.type !== 'Identifier') {
+        return null;
+    }
+    return typeof value.name === 'string' ? value.name : null;
+};
+const toVariableInitializerKind = (value) => {
+    if (!isObjectRecord(value) || typeof value.type !== 'string') {
+        return null;
+    }
+    if (value.type === 'ArrowFunctionExpression') {
+        return 'arrow-function';
+    }
+    if (value.type === 'FunctionExpression') {
+        return 'function-expression';
+    }
+    if (value.type === 'ClassExpression') {
+        return 'class-expression';
+    }
+    return 'other';
+};
+const pushTopLevelDeclarationMetadata = ({ declaration, exportKind, statementRange, declarations, }) => {
+    if (declaration.type === 'FunctionDeclaration') {
+        const name = toIdentifierName(declaration.id);
+        if (!name) {
+            return;
+        }
+        declarations.push({
+            name,
+            kind: 'function',
+            exportKind,
+            range: toSourceRange(declaration),
+            statementRange,
+            initializerKind: null,
+        });
+        return;
+    }
+    if (declaration.type === 'ClassDeclaration') {
+        const name = toIdentifierName(declaration.id);
+        if (!name) {
+            return;
+        }
+        declarations.push({
+            name,
+            kind: 'class',
+            exportKind,
+            range: toSourceRange(declaration),
+            statementRange,
+            initializerKind: null,
+        });
+        return;
+    }
+    if (!Array.isArray(declaration.declarations)) {
+        return;
+    }
+    for (const declarator of declaration.declarations) {
+        if (!isObjectRecord(declarator)) {
+            continue;
+        }
+        const name = toIdentifierName(declarator.id);
+        if (!name) {
+            continue;
+        }
+        declarations.push({
+            name,
+            kind: 'variable',
+            exportKind,
+            range: toSourceRange(declarator),
+            statementRange,
+            initializerKind: toVariableInitializerKind(declarator.init),
+        });
+    }
+};
+const collectTopLevelDeclarationMetadata = (body) => {
+    if (!Array.isArray(body)) {
+        return [];
+    }
+    const declarations = [];
+    for (const statement of body) {
+        if (!isObjectRecord(statement) || typeof statement.type !== 'string') {
+            continue;
+        }
+        const statementRange = toSourceRange(statement);
+        if (statement.type === 'ExportNamedDeclaration') {
+            if (!isObjectRecord(statement.declaration)) {
+                continue;
+            }
+            pushTopLevelDeclarationMetadata({
+                declaration: statement.declaration,
+                exportKind: 'named',
+                statementRange,
+                declarations,
+            });
+            continue;
+        }
+        if (statement.type === 'ExportDefaultDeclaration') {
+            if (!isObjectRecord(statement.declaration)) {
+                continue;
+            }
+            pushTopLevelDeclarationMetadata({
+                declaration: statement.declaration,
+                exportKind: 'default',
+                statementRange,
+                declarations,
+            });
+            continue;
+        }
+        pushTopLevelDeclarationMetadata({
+            declaration: statement,
+            exportKind: 'none',
+            statementRange,
+            declarations,
+        });
+    }
+    return declarations;
+};
+const unwrapExpressionNode = (value) => {
+    let current = value;
+    while (isObjectRecord(current) && typeof current.type === 'string') {
+        if (current.type === 'ParenthesizedExpression') {
+            current = current.expression;
+            continue;
+        }
+        if (current.type === 'TSAsExpression' ||
+            current.type === 'TSSatisfiesExpression' ||
+            current.type === 'TSInstantiationExpression' ||
+            current.type === 'TSNonNullExpression' ||
+            current.type === 'TSTypeAssertion') {
+            current = current.expression;
+            continue;
+        }
+        break;
+    }
+    return current;
+};
+const isJsxExpressionNode = (value) => {
+    const unwrapped = unwrapExpressionNode(value);
+    if (!isObjectRecord(unwrapped) || typeof unwrapped.type !== 'string') {
+        return false;
+    }
+    return unwrapped.type === 'JSXElement' || unwrapped.type === 'JSXFragment';
+};
+const collectTopLevelJsxExpressionMetadata = (body) => {
+    if (!Array.isArray(body)) {
+        return false;
+    }
+    for (const statement of body) {
+        if (!isObjectRecord(statement) || statement.type !== 'ExpressionStatement') {
+            continue;
+        }
+        if (isJsxExpressionNode(statement.expression)) {
+            return true;
+        }
+    }
+    return false;
+};
 const ensureSupportedOptions = (options) => {
     if (options.sourceType !== undefined &&
         options.sourceType !== 'module' &&
@@ -133,6 +292,14 @@ const ensureSupportedOptions = (options) => {
         options.typescriptStripBackend !== 'transpile-manual') {
         throw new Error(`[jsx] Unsupported typescriptStripBackend "${String(options.typescriptStripBackend)}". Use "oxc-transform" or "transpile-manual".`);
     }
+    if (options.collectTopLevelDeclarations !== undefined &&
+        typeof options.collectTopLevelDeclarations !== 'boolean') {
+        throw new Error(`[jsx] Unsupported collectTopLevelDeclarations value "${String(options.collectTopLevelDeclarations)}". Use true or false.`);
+    }
+    if (options.collectTopLevelJsxExpression !== undefined &&
+        typeof options.collectTopLevelJsxExpression !== 'boolean') {
+        throw new Error(`[jsx] Unsupported collectTopLevelJsxExpression value "${String(options.collectTopLevelJsxExpression)}". Use true or false.`);
+    }
 };
 export function transformJsxSource(source, options = {}) {
     const internalOptions = options;
@@ -143,12 +310,20 @@ export function transformJsxSource(source, options = {}) {
     const parsed = parseSync('transform-jsx-source.tsx', source, createParserOptions(sourceType));
     const parserDiagnostics = parsed.errors.map(error => toDiagnostic('parser', error));
     const imports = collectImportMetadata(parsed.program.body);
+    const declarations = internalOptions.collectTopLevelDeclarations
+        ? collectTopLevelDeclarationMetadata(parsed.program.body)
+        : undefined;
+    const hasTopLevelJsxExpression = internalOptions.collectTopLevelJsxExpression
+        ? collectTopLevelJsxExpressionMetadata(parsed.program.body)
+        : undefined;
     if (parserDiagnostics.length) {
         return {
             code: source,
             changed: false,
             imports,
             diagnostics: parserDiagnostics,
+            declarations,
+            hasTopLevelJsxExpression,
         };
     }
     const transpileBaseOptions = {
@@ -164,6 +339,8 @@ export function transformJsxSource(source, options = {}) {
             changed: result.changed,
             imports,
             diagnostics: parserDiagnostics,
+            declarations,
+            hasTopLevelJsxExpression,
         };
     }
     if (typescriptStripBackend === 'transpile-manual') {
@@ -176,6 +353,8 @@ export function transformJsxSource(source, options = {}) {
             changed: result.changed,
             imports,
             diagnostics: parserDiagnostics,
+            declarations,
+            hasTopLevelJsxExpression,
         };
     }
     const transformed = transformSync('transform-jsx-source.tsx', source, {
@@ -193,6 +372,8 @@ export function transformJsxSource(source, options = {}) {
             changed: fallbackCode !== source,
             imports,
             diagnostics,
+            declarations,
+            hasTopLevelJsxExpression,
         };
     }
     const jsxResult = transpileJsxSource(transformed.code, transpileBaseOptions);
@@ -201,5 +382,7 @@ export function transformJsxSource(source, options = {}) {
         changed: jsxResult.code !== source,
         imports,
         diagnostics,
+        declarations,
+        hasTopLevelJsxExpression,
     };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@knighted/jsx",
-  "version": "1.10.0",
+  "version": "1.12.0",
   "description": "Runtime JSX tagged template that renders DOM or React trees anywhere with or without a build step.",
   "keywords": [
     "jsx runtime",
@@ -173,7 +173,7 @@
     "jsdom": "^27.2.0",
     "lint-staged": "^16.2.7",
     "lit": "^3.2.1",
-    "next": "^16.1.6",
+    "next": "^16.1.7",
     "oxlint": "^1.51.0",
     "prettier": "^3.7.3",
     "react": "^19.0.0",