@knighted/jsx 1.10.0 → 1.11.0

package/dist/cjs/transform.cjs

@@ -120,6 +120,125 @@ 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 ensureSupportedOptions = (options) => {
     if (options.sourceType !== undefined &&
         options.sourceType !== 'module' &&
@@ -136,6 +255,10 @@ 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.`);
+    }
 };
 function transformJsxSource(source, options = {}) {
     const internalOptions = options;
@@ -146,12 +269,16 @@ 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;
     if (parserDiagnostics.length) {
         return {
             code: source,
             changed: false,
             imports,
             diagnostics: parserDiagnostics,
+            declarations,
         };
     }
     const transpileBaseOptions = {
@@ -167,6 +294,7 @@ function transformJsxSource(source, options = {}) {
             changed: result.changed,
             imports,
             diagnostics: parserDiagnostics,
+            declarations,
         };
     }
     if (typescriptStripBackend === 'transpile-manual') {
@@ -179,6 +307,7 @@ function transformJsxSource(source, options = {}) {
             changed: result.changed,
             imports,
             diagnostics: parserDiagnostics,
+            declarations,
         };
     }
     const transformed = (0, oxc_transform_1.transformSync)('transform-jsx-source.tsx', source, {
@@ -196,6 +325,7 @@ function transformJsxSource(source, options = {}) {
             changed: fallbackCode !== source,
             imports,
             diagnostics,
+            declarations,
         };
     }
     const jsxResult = (0, transpile_js_1.transpileJsxSource)(transformed.code, transpileBaseOptions);
@@ -204,5 +334,6 @@ function transformJsxSource(source, options = {}) {
         changed: jsxResult.code !== source,
         imports,
         diagnostics,
+        declarations,
     };
 }

package/dist/cjs/transform.d.cts

@@ -23,12 +23,26 @@ 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;
+};
 export type TransformJsxSourceResult = {
     code: string;
     changed: boolean;
     imports: TransformImport[];
     diagnostics: TransformDiagnostic[];
+    declarations?: TransformTopLevelDeclaration[];
 };
 export declare function transformJsxSource(source: string, options?: TransformJsxSourceOptions): TransformJsxSourceResult;
 export {};

package/dist/transform.d.ts

@@ -23,12 +23,26 @@ 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;
+};
 export type TransformJsxSourceResult = {
     code: string;
     changed: boolean;
     imports: TransformImport[];
     diagnostics: TransformDiagnostic[];
+    declarations?: TransformTopLevelDeclaration[];
 };
 export declare function transformJsxSource(source: string, options?: TransformJsxSourceOptions): TransformJsxSourceResult;
 export {};

package/dist/transform.js

@@ -117,6 +117,125 @@ 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 ensureSupportedOptions = (options) => {
     if (options.sourceType !== undefined &&
         options.sourceType !== 'module' &&
@@ -133,6 +252,10 @@ 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.`);
+    }
 };
 export function transformJsxSource(source, options = {}) {
     const internalOptions = options;
@@ -143,12 +266,16 @@ 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;
     if (parserDiagnostics.length) {
         return {
             code: source,
             changed: false,
             imports,
             diagnostics: parserDiagnostics,
+            declarations,
         };
     }
     const transpileBaseOptions = {
@@ -164,6 +291,7 @@ export function transformJsxSource(source, options = {}) {
             changed: result.changed,
             imports,
             diagnostics: parserDiagnostics,
+            declarations,
         };
     }
     if (typescriptStripBackend === 'transpile-manual') {
@@ -176,6 +304,7 @@ export function transformJsxSource(source, options = {}) {
             changed: result.changed,
             imports,
             diagnostics: parserDiagnostics,
+            declarations,
         };
     }
     const transformed = transformSync('transform-jsx-source.tsx', source, {
@@ -193,6 +322,7 @@ export function transformJsxSource(source, options = {}) {
             changed: fallbackCode !== source,
             imports,
             diagnostics,
+            declarations,
         };
     }
     const jsxResult = transpileJsxSource(transformed.code, transpileBaseOptions);
@@ -201,5 +331,6 @@ export function transformJsxSource(source, options = {}) {
         changed: jsxResult.code !== source,
         imports,
         diagnostics,
+        declarations,
     };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@knighted/jsx",
-  "version": "1.10.0",
+  "version": "1.11.0",
   "description": "Runtime JSX tagged template that renders DOM or React trees anywhere with or without a build step.",
   "keywords": [
     "jsx runtime",