@timber-js/app 0.2.0-alpha.100 → 0.2.0-alpha.101

package/src/utils/directive-parser.ts

@@ -1,140 +0,0 @@
-/**
- * AST-based directive detection for 'use client' and 'use server'.
- *
- * Uses acorn to parse source code and detect directives properly,
- * avoiding false positives from regex matching inside string literals,
- * comments, or template expressions.
- *
- * @module
- */
-
-import { Parser } from 'acorn';
-import acornJsx from 'acorn-jsx';
-
-// acorn parser with JSX support
-const jsxParser = Parser.extend(acornJsx());
-
-// ---------------------------------------------------------------------------
-// Types
-// ---------------------------------------------------------------------------
-
-export interface FileDirective {
-  /** The directive value, e.g. 'use client', 'use server' */
-  directive: string;
-  /** 1-based line number where the directive appears */
-  line: number;
-}
-
-// ---------------------------------------------------------------------------
-// File-level directive detection
-// ---------------------------------------------------------------------------
-
-/**
- * Detect a file-level directive ('use client', 'use server', etc.).
- *
- * Per the ECMAScript spec, directives are string literal expression
- * statements at the start of a program body (before any non-directive
- * statements). This function checks the AST `Program.body` for
- * `ExpressionStatement` nodes whose expression is a `Literal` string
- * matching a known directive.
- *
- * Returns the first matching directive, or null if none found.
- */
-export function detectFileDirective(
-  code: string,
-  directives: string[] = ['use client', 'use server']
-): FileDirective | null {
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  let ast: any;
-  try {
-    ast = jsxParser.parse(code, {
-      ecmaVersion: 'latest',
-      sourceType: 'module',
-      locations: true,
-    });
-  } catch {
-    // If the file fails to parse (e.g. TypeScript syntax), fall back to
-    // a safe line-by-line check that only considers lines before any
-    // non-comment, non-whitespace, non-directive content.
-    return detectFileDirectiveFallback(code, directives);
-  }
-
-  for (const node of ast.body) {
-    if (
-      node.type === 'ExpressionStatement' &&
-      node.expression.type === 'Literal' &&
-      typeof node.expression.value === 'string'
-    ) {
-      if (directives.includes(node.expression.value)) {
-        return {
-          directive: node.expression.value,
-          line: node.loc.start.line,
-        };
-      }
-    } else {
-      // Directives must appear before any non-directive statements
-      break;
-    }
-  }
-
-  return null;
-}
-
-/**
- * Fallback for TypeScript files that acorn cannot parse.
- *
- * Scans lines from the top of the file. Skips blank lines and comments.
- * Checks if the first real statement is a directive string literal.
- */
-function detectFileDirectiveFallback(code: string, directives: string[]): FileDirective | null {
-  const lines = code.split('\n');
-  let inBlockComment = false;
-
-  for (let i = 0; i < lines.length; i++) {
-    let line = lines[i].trim();
-
-    // Handle block comments
-    if (inBlockComment) {
-      const endIdx = line.indexOf('*/');
-      if (endIdx === -1) continue;
-      line = line.slice(endIdx + 2).trim();
-      inBlockComment = false;
-      if (!line) continue;
-    }
-
-    // Skip blank lines
-    if (!line) continue;
-
-    // Skip line comments
-    if (line.startsWith('//')) continue;
-
-    // Skip block comment start
-    if (line.startsWith('/*')) {
-      const endIdx = line.indexOf('*/', 2);
-      if (endIdx === -1) {
-        inBlockComment = true;
-        continue;
-      }
-      line = line.slice(endIdx + 2).trim();
-      if (!line) continue;
-    }
-
-    // Check for directive
-    for (const dir of directives) {
-      // Match 'directive' or "directive" optionally followed by ;
-      if (
-        line === `'${dir}'` ||
-        line === `'${dir}';` ||
-        line === `"${dir}"` ||
-        line === `"${dir}";`
-      ) {
-        return { directive: dir, line: i + 1 };
-      }
-    }
-
-    // First non-comment, non-blank line is not a directive — stop
-    break;
-  }
-
-  return null;
-}