@knighted/jsx 1.11.0 → 1.13.0

package/dist/cjs/transform.cjs

@@ -239,6 +239,57 @@ const collectTopLevelDeclarationMetadata = (body) => {
     }
     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 toJsxExpressionNode = (value) => {
+    const unwrapped = unwrapExpressionNode(value);
+    if (!isObjectRecord(unwrapped) || typeof unwrapped.type !== 'string') {
+        return null;
+    }
+    if (unwrapped.type === 'JSXElement' || unwrapped.type === 'JSXFragment') {
+        return unwrapped;
+    }
+    return null;
+};
+const createEmptyTopLevelJsxExpressionMetadata = () => ({
+    hasTopLevelJsxExpression: false,
+    topLevelJsxExpressionRange: null,
+});
+const collectTopLevelJsxExpressionMetadata = (body) => {
+    if (!Array.isArray(body)) {
+        return createEmptyTopLevelJsxExpressionMetadata();
+    }
+    for (const statement of body) {
+        if (!isObjectRecord(statement) || statement.type !== 'ExpressionStatement') {
+            continue;
+        }
+        const jsxNode = toJsxExpressionNode(statement.expression);
+        if (jsxNode) {
+            return {
+                hasTopLevelJsxExpression: true,
+                topLevelJsxExpressionRange: toSourceRange(jsxNode),
+            };
+        }
+    }
+    return createEmptyTopLevelJsxExpressionMetadata();
+};
 const ensureSupportedOptions = (options) => {
     if (options.sourceType !== undefined &&
         options.sourceType !== 'module' &&
@@ -259,6 +310,10 @@ const ensureSupportedOptions = (options) => {
         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;
@@ -272,6 +327,11 @@ function transformJsxSource(source, options = {}) {
     const declarations = internalOptions.collectTopLevelDeclarations
         ? collectTopLevelDeclarationMetadata(parsed.program.body)
         : undefined;
+    const topLevelJsxExpressionMetadata = internalOptions.collectTopLevelJsxExpression
+        ? collectTopLevelJsxExpressionMetadata(parsed.program.body)
+        : undefined;
+    const hasTopLevelJsxExpression = topLevelJsxExpressionMetadata?.hasTopLevelJsxExpression;
+    const topLevelJsxExpressionRange = topLevelJsxExpressionMetadata?.topLevelJsxExpressionRange;
     if (parserDiagnostics.length) {
         return {
             code: source,
@@ -279,6 +339,8 @@ function transformJsxSource(source, options = {}) {
             imports,
             diagnostics: parserDiagnostics,
             declarations,
+            hasTopLevelJsxExpression,
+            topLevelJsxExpressionRange,
         };
     }
     const transpileBaseOptions = {
@@ -295,6 +357,8 @@ function transformJsxSource(source, options = {}) {
             imports,
             diagnostics: parserDiagnostics,
             declarations,
+            hasTopLevelJsxExpression,
+            topLevelJsxExpressionRange,
         };
     }
     if (typescriptStripBackend === 'transpile-manual') {
@@ -308,6 +372,8 @@ function transformJsxSource(source, options = {}) {
             imports,
             diagnostics: parserDiagnostics,
             declarations,
+            hasTopLevelJsxExpression,
+            topLevelJsxExpressionRange,
         };
     }
     const transformed = (0, oxc_transform_1.transformSync)('transform-jsx-source.tsx', source, {
@@ -326,6 +392,8 @@ function transformJsxSource(source, options = {}) {
             imports,
             diagnostics,
             declarations,
+            hasTopLevelJsxExpression,
+            topLevelJsxExpressionRange,
         };
     }
     const jsxResult = (0, transpile_js_1.transpileJsxSource)(transformed.code, transpileBaseOptions);
@@ -335,5 +403,7 @@ function transformJsxSource(source, options = {}) {
         imports,
         diagnostics,
         declarations,
+        hasTopLevelJsxExpression,
+        topLevelJsxExpressionRange,
     };
 }

package/dist/cjs/transform.d.cts

@@ -36,6 +36,7 @@ export type TransformTopLevelDeclaration = {
 };
 export type TransformJsxSourceOptions = TranspileJsxSourceOptions & {
     collectTopLevelDeclarations?: boolean;
+    collectTopLevelJsxExpression?: boolean;
 };
 export type TransformJsxSourceResult = {
     code: string;
@@ -43,6 +44,8 @@ export type TransformJsxSourceResult = {
     imports: TransformImport[];
     diagnostics: TransformDiagnostic[];
     declarations?: TransformTopLevelDeclaration[];
+    hasTopLevelJsxExpression?: boolean;
+    topLevelJsxExpressionRange?: SourceRange | null;
 };
 export declare function transformJsxSource(source: string, options?: TransformJsxSourceOptions): TransformJsxSourceResult;
 export {};

package/dist/transform.d.ts

@@ -36,6 +36,7 @@ export type TransformTopLevelDeclaration = {
 };
 export type TransformJsxSourceOptions = TranspileJsxSourceOptions & {
     collectTopLevelDeclarations?: boolean;
+    collectTopLevelJsxExpression?: boolean;
 };
 export type TransformJsxSourceResult = {
     code: string;
@@ -43,6 +44,8 @@ export type TransformJsxSourceResult = {
     imports: TransformImport[];
     diagnostics: TransformDiagnostic[];
     declarations?: TransformTopLevelDeclaration[];
+    hasTopLevelJsxExpression?: boolean;
+    topLevelJsxExpressionRange?: SourceRange | null;
 };
 export declare function transformJsxSource(source: string, options?: TransformJsxSourceOptions): TransformJsxSourceResult;
 export {};

package/dist/transform.js

@@ -236,6 +236,57 @@ const collectTopLevelDeclarationMetadata = (body) => {
     }
     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 toJsxExpressionNode = (value) => {
+    const unwrapped = unwrapExpressionNode(value);
+    if (!isObjectRecord(unwrapped) || typeof unwrapped.type !== 'string') {
+        return null;
+    }
+    if (unwrapped.type === 'JSXElement' || unwrapped.type === 'JSXFragment') {
+        return unwrapped;
+    }
+    return null;
+};
+const createEmptyTopLevelJsxExpressionMetadata = () => ({
+    hasTopLevelJsxExpression: false,
+    topLevelJsxExpressionRange: null,
+});
+const collectTopLevelJsxExpressionMetadata = (body) => {
+    if (!Array.isArray(body)) {
+        return createEmptyTopLevelJsxExpressionMetadata();
+    }
+    for (const statement of body) {
+        if (!isObjectRecord(statement) || statement.type !== 'ExpressionStatement') {
+            continue;
+        }
+        const jsxNode = toJsxExpressionNode(statement.expression);
+        if (jsxNode) {
+            return {
+                hasTopLevelJsxExpression: true,
+                topLevelJsxExpressionRange: toSourceRange(jsxNode),
+            };
+        }
+    }
+    return createEmptyTopLevelJsxExpressionMetadata();
+};
 const ensureSupportedOptions = (options) => {
     if (options.sourceType !== undefined &&
         options.sourceType !== 'module' &&
@@ -256,6 +307,10 @@ const ensureSupportedOptions = (options) => {
         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;
@@ -269,6 +324,11 @@ export function transformJsxSource(source, options = {}) {
     const declarations = internalOptions.collectTopLevelDeclarations
         ? collectTopLevelDeclarationMetadata(parsed.program.body)
         : undefined;
+    const topLevelJsxExpressionMetadata = internalOptions.collectTopLevelJsxExpression
+        ? collectTopLevelJsxExpressionMetadata(parsed.program.body)
+        : undefined;
+    const hasTopLevelJsxExpression = topLevelJsxExpressionMetadata?.hasTopLevelJsxExpression;
+    const topLevelJsxExpressionRange = topLevelJsxExpressionMetadata?.topLevelJsxExpressionRange;
     if (parserDiagnostics.length) {
         return {
             code: source,
@@ -276,6 +336,8 @@ export function transformJsxSource(source, options = {}) {
             imports,
             diagnostics: parserDiagnostics,
             declarations,
+            hasTopLevelJsxExpression,
+            topLevelJsxExpressionRange,
         };
     }
     const transpileBaseOptions = {
@@ -292,6 +354,8 @@ export function transformJsxSource(source, options = {}) {
             imports,
             diagnostics: parserDiagnostics,
             declarations,
+            hasTopLevelJsxExpression,
+            topLevelJsxExpressionRange,
         };
     }
     if (typescriptStripBackend === 'transpile-manual') {
@@ -305,6 +369,8 @@ export function transformJsxSource(source, options = {}) {
             imports,
             diagnostics: parserDiagnostics,
             declarations,
+            hasTopLevelJsxExpression,
+            topLevelJsxExpressionRange,
         };
     }
     const transformed = transformSync('transform-jsx-source.tsx', source, {
@@ -323,6 +389,8 @@ export function transformJsxSource(source, options = {}) {
             imports,
             diagnostics,
             declarations,
+            hasTopLevelJsxExpression,
+            topLevelJsxExpressionRange,
         };
     }
     const jsxResult = transpileJsxSource(transformed.code, transpileBaseOptions);
@@ -332,5 +400,7 @@ export function transformJsxSource(source, options = {}) {
         imports,
         diagnostics,
         declarations,
+        hasTopLevelJsxExpression,
+        topLevelJsxExpressionRange,
     };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@knighted/jsx",
-  "version": "1.11.0",
+  "version": "1.13.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",