@litsx/compiler 0.1.0

package/dist/shared/authored-input-QenSVW8t.cjs

@@ -0,0 +1,325 @@
+'use strict';
+
+var babelParser = require('@babel/parser');
+var parser = require('@litsx/jsx-authoring/parser');
+
+function _interopNamespaceDefault(e) {
+  var n = Object.create(null);
+  if (e) {
+    Object.keys(e).forEach(function (k) {
+      if (k !== 'default') {
+        var d = Object.getOwnPropertyDescriptor(e, k);
+        Object.defineProperty(n, k, d.get ? d : {
+          enumerable: true,
+          get: function () { return e[k]; }
+        });
+      }
+    });
+  }
+  n.default = e;
+  return Object.freeze(n);
+}
+
+var babelParser__namespace = /*#__PURE__*/_interopNamespaceDefault(babelParser);
+
+function normalizeLocationNumber(value) {
+  return typeof value === "number" && Number.isFinite(value) ? value : null;
+}
+
+function normalizeLitsxWarning(warning, context = {}) {
+  const normalized = warning && typeof warning === "object" ? { ...warning } : {};
+
+  normalized.code =
+    (typeof normalized.code === "string" && normalized.code !== "") ||
+    (typeof normalized.code === "number" && Number.isFinite(normalized.code))
+      ? normalized.code
+      : null;
+  normalized.message =
+    typeof normalized.message === "string" && normalized.message !== ""
+      ? normalized.message
+      : "LitSX emitted a warning during compilation.";
+  normalized.filename =
+    typeof normalized.filename === "string" && normalized.filename !== ""
+      ? normalized.filename
+      : typeof context.filename === "string" && context.filename !== ""
+        ? context.filename
+        : null;
+  normalized.line = normalizeLocationNumber(normalized.line);
+  normalized.column = normalizeLocationNumber(normalized.column);
+  normalized.attributeName =
+    typeof normalized.attributeName === "string" && normalized.attributeName !== ""
+      ? normalized.attributeName
+      : null;
+  normalized.tagName =
+    typeof normalized.tagName === "string" && normalized.tagName !== ""
+      ? normalized.tagName
+      : null;
+  normalized.propName =
+    typeof normalized.propName === "string" && normalized.propName !== ""
+      ? normalized.propName
+      : null;
+
+  return normalized;
+}
+
+function mergeLitsxWarnings(existingWarnings = [], additionalWarnings = [], context = {}) {
+  const merged = [];
+  const seen = new Set();
+
+  for (const rawWarning of [...existingWarnings, ...additionalWarnings]) {
+    const warning = normalizeLitsxWarning(rawWarning, context);
+    const key = [
+      warning.code ?? "",
+      warning.attributeName ?? "",
+      warning.tagName ?? "",
+      warning.propName ?? "",
+      warning.line ?? "",
+      warning.column ?? "",
+      warning.message ?? "",
+    ].join(":");
+
+    if (seen.has(key)) {
+      continue;
+    }
+
+    seen.add(key);
+    merged.push(warning);
+  }
+
+  return merged;
+}
+
+function isNativeIntrinsicJsxName(nameNode) {
+  return nameNode?.type === "JSXIdentifier" && /^[a-z]/.test(nameNode.name);
+}
+
+function collectNativeClassNameWarnings(ast) {
+  const warnings = [];
+
+  function visit(node, currentTagName = null) {
+    if (!node || typeof node !== "object") {
+      return;
+    }
+
+    let nextTagName = currentTagName;
+    if (node.type === "JSXOpeningElement" && isNativeIntrinsicJsxName(node.name)) {
+      nextTagName = node.name.name;
+    }
+
+    if (
+      node.type === "JSXAttribute" &&
+      nextTagName &&
+      node.name?.type === "JSXIdentifier" &&
+      node.name.name === "className"
+    ) {
+      warnings.push({
+        code: "LITSX_NATIVE_CLASSNAME",
+        message:
+          '`className` is not native LitSX syntax. Use `class` in native LitSX, or add the React compatibility layer to rewrite `className`.',
+        attributeName: "className",
+        tagName: nextTagName,
+        line: node.name.loc?.start?.line ?? null,
+        column: node.name.loc?.start?.column ?? null,
+      });
+    }
+
+    for (const value of Object.values(node)) {
+      if (Array.isArray(value)) {
+        value.forEach((child) => visit(child, nextTagName));
+      } else {
+        visit(value, nextTagName);
+      }
+    }
+  }
+
+  visit(ast.program ?? ast, null);
+  return warnings;
+}
+
+function collectReactMemoWarnings(ast) {
+  const warnings = [];
+  const reactMemoLocalNames = new Set();
+  const reactNamespaceNames = new Set();
+
+  const body = ast?.program?.body ?? ast?.body ?? [];
+  for (const node of body) {
+    if (node?.type !== "ImportDeclaration" || node.source?.value !== "react") {
+      continue;
+    }
+
+    for (const specifier of node.specifiers || []) {
+      if (
+        specifier?.type === "ImportSpecifier" &&
+        specifier.imported?.type === "Identifier" &&
+        specifier.imported.name === "memo" &&
+        specifier.local?.type === "Identifier"
+      ) {
+        reactMemoLocalNames.add(specifier.local.name);
+      }
+
+      if (
+        (specifier?.type === "ImportDefaultSpecifier" ||
+          specifier?.type === "ImportNamespaceSpecifier") &&
+        specifier.local?.type === "Identifier"
+      ) {
+        reactNamespaceNames.add(specifier.local.name);
+      }
+    }
+  }
+
+  function addMemoWarnings(node) {
+    const line = node.loc?.start?.line ?? null;
+    const column = node.loc?.start?.column ?? null;
+
+    warnings.push({
+      code: 91016,
+      message:
+        "`memo(...)` is removed during LitSX lowering. LitSX does not use React-style parent re-render bailout semantics, so `memo` is treated as a migration wrapper only.",
+      line,
+      column,
+    });
+
+    if ((node.arguments || []).length > 1) {
+      warnings.push({
+        code: 91017,
+        message:
+          "`memo(Component, areEqual)` ignores the comparator during LitSX lowering because LitSX does not use React-style parent re-render bailout semantics.",
+        line,
+        column,
+      });
+    }
+  }
+
+  function visit(node) {
+    if (!node || typeof node !== "object") {
+      return;
+    }
+
+    if (node.type === "CallExpression") {
+      const callee = node.callee;
+      const isImportedMemo =
+        callee?.type === "Identifier" && reactMemoLocalNames.has(callee.name);
+      const isNamespacedMemo =
+        callee?.type === "MemberExpression" &&
+        callee.computed === false &&
+        callee.object?.type === "Identifier" &&
+        reactNamespaceNames.has(callee.object.name) &&
+        callee.property?.type === "Identifier" &&
+        callee.property.name === "memo";
+
+      if (isImportedMemo || isNamespacedMemo) {
+        addMemoWarnings(node);
+      }
+    }
+
+    for (const value of Object.values(node)) {
+      if (Array.isArray(value)) {
+        value.forEach((child) => visit(child));
+      } else {
+        visit(value);
+      }
+    }
+  }
+
+  visit(ast.program ?? ast);
+  return warnings;
+}
+
+function normalizeParserPlugins(filename, parserPlugins = []) {
+  if (Array.isArray(parserPlugins) && parserPlugins.length > 0) {
+    return parserPlugins;
+  }
+
+  if (typeof filename === "string" && (
+    filename.endsWith(".tsx") ||
+    filename.endsWith(".litsx")
+  )) {
+    return ["typescript"];
+  }
+
+  return [];
+}
+
+function normalizePluginList(plugins) {
+  return Array.isArray(plugins) ? plugins : [];
+}
+
+function ensureLitsxParserPlugins(filename, parserPlugins = [], { requireJsx = false } = {}) {
+  const normalized = normalizeParserPlugins(filename, parserPlugins);
+  if (!requireJsx) {
+    return normalized;
+  }
+
+  const hasJsx = normalized.some((plugin) => {
+    if (typeof plugin === "string") {
+      return plugin === "jsx";
+    }
+    return Array.isArray(plugin) && plugin[0] === "jsx";
+  });
+
+  return hasJsx ? normalized : [...normalized, "jsx"];
+}
+
+function prepareLitsxAuthoredInput(
+  source,
+  options = {},
+  runtime = {}
+) {
+  const runtimeImpl = {
+    parse: babelParser__namespace.parse,
+    transformFromAstSync: null,
+    ...runtime,
+  };
+  const filename = options.filename;
+  const sourceMaps = options.sourceMaps === true;
+  const parserPlugins = ensureLitsxParserPlugins(filename, options.parserPlugins, {
+    requireJsx: options.requireJsx === true,
+  });
+  const virtualizedAst = parser.parseWithLitsxVirtualization(runtimeImpl.parse, source, {
+    sourceType: "module",
+    plugins: parserPlugins,
+    sourceFileName: filename,
+    litsxSourceMap: sourceMaps,
+  });
+  const virtualization = parser.getLitsxVirtualizationMetadata(virtualizedAst);
+  const authoredWarnings = mergeLitsxWarnings(
+    collectNativeClassNameWarnings(virtualizedAst),
+    collectReactMemoWarnings(virtualizedAst),
+    { filename }
+  );
+  const authoringPlugins = normalizePluginList(options.authoringPlugins);
+
+  let inputAst = virtualizedAst;
+  if (authoringPlugins.length > 0) {
+    if (typeof runtimeImpl.transformFromAstSync !== "function") {
+      throw new Error(
+        "prepareLitsxAuthoredInput(...) requires runtime.transformFromAstSync when authoringPlugins are provided."
+      );
+    }
+
+    const authoringPass = runtimeImpl.transformFromAstSync(virtualizedAst, source, {
+      filename,
+      sourceFileName: filename,
+      configFile: false,
+      babelrc: false,
+      ast: true,
+      code: false,
+      sourceMaps: false,
+      plugins: authoringPlugins,
+    });
+
+    inputAst = authoringPass?.ast ?? virtualizedAst;
+  }
+
+  return {
+    filename,
+    virtualization,
+    inputAst,
+    authoredWarnings,
+  };
+}
+
+exports.ensureLitsxParserPlugins = ensureLitsxParserPlugins;
+exports.mergeLitsxWarnings = mergeLitsxWarnings;
+exports.prepareLitsxAuthoredInput = prepareLitsxAuthoredInput;
+//# sourceMappingURL=authored-input-QenSVW8t.cjs.map

package/dist/shared/authored-input-QenSVW8t.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"authored-input-QenSVW8t.cjs","sources":["../../src/warnings.js","../../src/authored-input.js"],"sourcesContent":["function normalizeLocationNumber(value) {\n  return typeof value === \"number\" && Number.isFinite(value) ? value : null;\n}\n\nexport function normalizeLitsxWarning(warning, context = {}) {\n  const normalized = warning && typeof warning === \"object\" ? { ...warning } : {};\n\n  normalized.code =\n    (typeof normalized.code === \"string\" && normalized.code !== \"\") ||\n    (typeof normalized.code === \"number\" && Number.isFinite(normalized.code))\n      ? normalized.code\n      : null;\n  normalized.message =\n    typeof normalized.message === \"string\" && normalized.message !== \"\"\n      ? normalized.message\n      : \"LitSX emitted a warning during compilation.\";\n  normalized.filename =\n    typeof normalized.filename === \"string\" && normalized.filename !== \"\"\n      ? normalized.filename\n      : typeof context.filename === \"string\" && context.filename !== \"\"\n        ? context.filename\n        : null;\n  normalized.line = normalizeLocationNumber(normalized.line);\n  normalized.column = normalizeLocationNumber(normalized.column);\n  normalized.attributeName =\n    typeof normalized.attributeName === \"string\" && normalized.attributeName !== \"\"\n      ? normalized.attributeName\n      : null;\n  normalized.tagName =\n    typeof normalized.tagName === \"string\" && normalized.tagName !== \"\"\n      ? normalized.tagName\n      : null;\n  normalized.propName =\n    typeof normalized.propName === \"string\" && normalized.propName !== \"\"\n      ? normalized.propName\n      : null;\n\n  return normalized;\n}\n\nexport function mergeLitsxWarnings(existingWarnings = [], additionalWarnings = [], context = {}) {\n  const merged = [];\n  const seen = new Set();\n\n  for (const rawWarning of [...existingWarnings, ...additionalWarnings]) {\n    const warning = normalizeLitsxWarning(rawWarning, context);\n    const key = [\n      warning.code ?? \"\",\n      warning.attributeName ?? \"\",\n      warning.tagName ?? \"\",\n      warning.propName ?? \"\",\n      warning.line ?? \"\",\n      warning.column ?? \"\",\n      warning.message ?? \"\",\n    ].join(\":\");\n\n    if (seen.has(key)) {\n      continue;\n    }\n\n    seen.add(key);\n    merged.push(warning);\n  }\n\n  return merged;\n}\n","import * as babelParser from \"@babel/parser\";\nimport {\n  getLitsxVirtualizationMetadata,\n  parseWithLitsxVirtualization,\n} from \"@litsx/jsx-authoring/parser\";\nimport { mergeLitsxWarnings } from \"./warnings.js\";\n\nfunction isNativeIntrinsicJsxName(nameNode) {\n  return nameNode?.type === \"JSXIdentifier\" && /^[a-z]/.test(nameNode.name);\n}\n\nfunction collectNativeClassNameWarnings(ast) {\n  const warnings = [];\n\n  function visit(node, currentTagName = null) {\n    if (!node || typeof node !== \"object\") {\n      return;\n    }\n\n    let nextTagName = currentTagName;\n    if (node.type === \"JSXOpeningElement\" && isNativeIntrinsicJsxName(node.name)) {\n      nextTagName = node.name.name;\n    }\n\n    if (\n      node.type === \"JSXAttribute\" &&\n      nextTagName &&\n      node.name?.type === \"JSXIdentifier\" &&\n      node.name.name === \"className\"\n    ) {\n      warnings.push({\n        code: \"LITSX_NATIVE_CLASSNAME\",\n        message:\n          '`className` is not native LitSX syntax. Use `class` in native LitSX, or add the React compatibility layer to rewrite `className`.',\n        attributeName: \"className\",\n        tagName: nextTagName,\n        line: node.name.loc?.start?.line ?? null,\n        column: node.name.loc?.start?.column ?? null,\n      });\n    }\n\n    for (const value of Object.values(node)) {\n      if (Array.isArray(value)) {\n        value.forEach((child) => visit(child, nextTagName));\n      } else {\n        visit(value, nextTagName);\n      }\n    }\n  }\n\n  visit(ast.program ?? ast, null);\n  return warnings;\n}\n\nfunction collectReactMemoWarnings(ast) {\n  const warnings = [];\n  const reactMemoLocalNames = new Set();\n  const reactNamespaceNames = new Set();\n\n  const body = ast?.program?.body ?? ast?.body ?? [];\n  for (const node of body) {\n    if (node?.type !== \"ImportDeclaration\" || node.source?.value !== \"react\") {\n      continue;\n    }\n\n    for (const specifier of node.specifiers || []) {\n      if (\n        specifier?.type === \"ImportSpecifier\" &&\n        specifier.imported?.type === \"Identifier\" &&\n        specifier.imported.name === \"memo\" &&\n        specifier.local?.type === \"Identifier\"\n      ) {\n        reactMemoLocalNames.add(specifier.local.name);\n      }\n\n      if (\n        (specifier?.type === \"ImportDefaultSpecifier\" ||\n          specifier?.type === \"ImportNamespaceSpecifier\") &&\n        specifier.local?.type === \"Identifier\"\n      ) {\n        reactNamespaceNames.add(specifier.local.name);\n      }\n    }\n  }\n\n  function addMemoWarnings(node) {\n    const line = node.loc?.start?.line ?? null;\n    const column = node.loc?.start?.column ?? null;\n\n    warnings.push({\n      code: 91016,\n      message:\n        \"`memo(...)` is removed during LitSX lowering. LitSX does not use React-style parent re-render bailout semantics, so `memo` is treated as a migration wrapper only.\",\n      line,\n      column,\n    });\n\n    if ((node.arguments || []).length > 1) {\n      warnings.push({\n        code: 91017,\n        message:\n          \"`memo(Component, areEqual)` ignores the comparator during LitSX lowering because LitSX does not use React-style parent re-render bailout semantics.\",\n        line,\n        column,\n      });\n    }\n  }\n\n  function visit(node) {\n    if (!node || typeof node !== \"object\") {\n      return;\n    }\n\n    if (node.type === \"CallExpression\") {\n      const callee = node.callee;\n      const isImportedMemo =\n        callee?.type === \"Identifier\" && reactMemoLocalNames.has(callee.name);\n      const isNamespacedMemo =\n        callee?.type === \"MemberExpression\" &&\n        callee.computed === false &&\n        callee.object?.type === \"Identifier\" &&\n        reactNamespaceNames.has(callee.object.name) &&\n        callee.property?.type === \"Identifier\" &&\n        callee.property.name === \"memo\";\n\n      if (isImportedMemo || isNamespacedMemo) {\n        addMemoWarnings(node);\n      }\n    }\n\n    for (const value of Object.values(node)) {\n      if (Array.isArray(value)) {\n        value.forEach((child) => visit(child));\n      } else {\n        visit(value);\n      }\n    }\n  }\n\n  visit(ast.program ?? ast);\n  return warnings;\n}\n\nfunction normalizeParserPlugins(filename, parserPlugins = []) {\n  if (Array.isArray(parserPlugins) && parserPlugins.length > 0) {\n    return parserPlugins;\n  }\n\n  if (typeof filename === \"string\" && (\n    filename.endsWith(\".tsx\") ||\n    filename.endsWith(\".litsx\")\n  )) {\n    return [\"typescript\"];\n  }\n\n  return [];\n}\n\nfunction normalizePluginList(plugins) {\n  return Array.isArray(plugins) ? plugins : [];\n}\n\nexport function ensureLitsxParserPlugins(filename, parserPlugins = [], { requireJsx = false } = {}) {\n  const normalized = normalizeParserPlugins(filename, parserPlugins);\n  if (!requireJsx) {\n    return normalized;\n  }\n\n  const hasJsx = normalized.some((plugin) => {\n    if (typeof plugin === \"string\") {\n      return plugin === \"jsx\";\n    }\n    return Array.isArray(plugin) && plugin[0] === \"jsx\";\n  });\n\n  return hasJsx ? normalized : [...normalized, \"jsx\"];\n}\n\nexport function prepareLitsxAuthoredInput(\n  source,\n  options = {},\n  runtime = {}\n) {\n  const runtimeImpl = {\n    parse: babelParser.parse,\n    transformFromAstSync: null,\n    ...runtime,\n  };\n  const filename = options.filename;\n  const sourceMaps = options.sourceMaps === true;\n  const parserPlugins = ensureLitsxParserPlugins(filename, options.parserPlugins, {\n    requireJsx: options.requireJsx === true,\n  });\n  const virtualizedAst = parseWithLitsxVirtualization(runtimeImpl.parse, source, {\n    sourceType: \"module\",\n    plugins: parserPlugins,\n    sourceFileName: filename,\n    litsxSourceMap: sourceMaps,\n  });\n  const virtualization = getLitsxVirtualizationMetadata(virtualizedAst);\n  const authoredWarnings = mergeLitsxWarnings(\n    collectNativeClassNameWarnings(virtualizedAst),\n    collectReactMemoWarnings(virtualizedAst),\n    { filename }\n  );\n  const authoringPlugins = normalizePluginList(options.authoringPlugins);\n\n  let inputAst = virtualizedAst;\n  if (authoringPlugins.length > 0) {\n    if (typeof runtimeImpl.transformFromAstSync !== \"function\") {\n      throw new Error(\n        \"prepareLitsxAuthoredInput(...) requires runtime.transformFromAstSync when authoringPlugins are provided.\"\n      );\n    }\n\n    const authoringPass = runtimeImpl.transformFromAstSync(virtualizedAst, source, {\n      filename,\n      sourceFileName: filename,\n      configFile: false,\n      babelrc: false,\n      ast: true,\n      code: false,\n      sourceMaps: false,\n      plugins: authoringPlugins,\n    });\n\n    inputAst = authoringPass?.ast ?? virtualizedAst;\n  }\n\n  return {\n    filename,\n    virtualization,\n    inputAst,\n    authoredWarnings,\n  };\n}\n"],"names":["babelParser","parseWithLitsxVirtualization","getLitsxVirtualizationMetadata"],"mappings":"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"}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@litsx/compiler",
+  "version": "0.1.0",
+  "description": "Build-facing LitSX compilation facade with correct parser and sourcemap handling",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./src/index.js",
+  "types": "./src/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./src/index.d.ts",
+      "import": "./src/index.js",
+      "require": "./dist/index.cjs",
+      "default": "./src/index.js"
+    },
+    "./authored-input": {
+      "types": "./src/authored-input.d.ts",
+      "import": "./src/authored-input.js",
+      "require": "./dist/authored-input.cjs",
+      "default": "./src/authored-input.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "README.md"
+  ],
+  "keywords": [
+    "litsx",
+    "compiler",
+    "babel",
+    "vite",
+    "jsx"
+  ],
+  "license": "Apache-2.0",
+  "homepage": "https://github.com/litsxdev/litsx/tree/main/packages/compiler",
+  "bugs": {
+    "url": "https://github.com/litsxdev/litsx/issues"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/litsxdev/litsx.git",
+    "directory": "packages/compiler"
+  },
+  "dependencies": {
+    "@babel/core": "^7.29.0",
+    "@babel/parser": "^7.29.3",
+    "@litsx/babel-plugin-transform-jsx-html-template": "workspace:^",
+    "@litsx/babel-preset-litsx": "workspace:^",
+    "@litsx/jsx-authoring": "workspace:^",
+    "@litsx/typescript-session": "workspace:^"
+  },
+  "scripts": {
+    "build": "../../node_modules/.bin/rollup --config rollup.config.mjs",
+    "prepack": "yarn build"
+  }
+}

package/src/authored-input.d.ts

@@ -0,0 +1,28 @@
+export function ensureLitsxParserPlugins(
+  filename?: string,
+  parserPlugins?: string[],
+  options?: { requireJsx?: boolean }
+): string[];
+
+export function prepareLitsxAuthoredInput(
+  source: string,
+  options?: {
+    filename?: string;
+    parserPlugins?: string[];
+    sourceMaps?: boolean;
+    authoringPlugins?: unknown[];
+    requireJsx?: boolean;
+  },
+  runtime?: {
+    parse: (...args: unknown[]) => object;
+    transformFromAstSync?: (...args: unknown[]) => { ast?: object } | null | undefined;
+  }
+): {
+  filename?: string;
+  virtualization: {
+    code?: string;
+    map?: object | null;
+  } | null;
+  inputAst: object;
+  authoredWarnings: unknown[];
+};

package/src/authored-input.js

@@ -0,0 +1,236 @@
+import * as babelParser from "@babel/parser";
+import {
+  getLitsxVirtualizationMetadata,
+  parseWithLitsxVirtualization,
+} from "@litsx/jsx-authoring/parser";
+import { mergeLitsxWarnings } from "./warnings.js";
+
+function isNativeIntrinsicJsxName(nameNode) {
+  return nameNode?.type === "JSXIdentifier" && /^[a-z]/.test(nameNode.name);
+}
+
+function collectNativeClassNameWarnings(ast) {
+  const warnings = [];
+
+  function visit(node, currentTagName = null) {
+    if (!node || typeof node !== "object") {
+      return;
+    }
+
+    let nextTagName = currentTagName;
+    if (node.type === "JSXOpeningElement" && isNativeIntrinsicJsxName(node.name)) {
+      nextTagName = node.name.name;
+    }
+
+    if (
+      node.type === "JSXAttribute" &&
+      nextTagName &&
+      node.name?.type === "JSXIdentifier" &&
+      node.name.name === "className"
+    ) {
+      warnings.push({
+        code: "LITSX_NATIVE_CLASSNAME",
+        message:
+          '`className` is not native LitSX syntax. Use `class` in native LitSX, or add the React compatibility layer to rewrite `className`.',
+        attributeName: "className",
+        tagName: nextTagName,
+        line: node.name.loc?.start?.line ?? null,
+        column: node.name.loc?.start?.column ?? null,
+      });
+    }
+
+    for (const value of Object.values(node)) {
+      if (Array.isArray(value)) {
+        value.forEach((child) => visit(child, nextTagName));
+      } else {
+        visit(value, nextTagName);
+      }
+    }
+  }
+
+  visit(ast.program ?? ast, null);
+  return warnings;
+}
+
+function collectReactMemoWarnings(ast) {
+  const warnings = [];
+  const reactMemoLocalNames = new Set();
+  const reactNamespaceNames = new Set();
+
+  const body = ast?.program?.body ?? ast?.body ?? [];
+  for (const node of body) {
+    if (node?.type !== "ImportDeclaration" || node.source?.value !== "react") {
+      continue;
+    }
+
+    for (const specifier of node.specifiers || []) {
+      if (
+        specifier?.type === "ImportSpecifier" &&
+        specifier.imported?.type === "Identifier" &&
+        specifier.imported.name === "memo" &&
+        specifier.local?.type === "Identifier"
+      ) {
+        reactMemoLocalNames.add(specifier.local.name);
+      }
+
+      if (
+        (specifier?.type === "ImportDefaultSpecifier" ||
+          specifier?.type === "ImportNamespaceSpecifier") &&
+        specifier.local?.type === "Identifier"
+      ) {
+        reactNamespaceNames.add(specifier.local.name);
+      }
+    }
+  }
+
+  function addMemoWarnings(node) {
+    const line = node.loc?.start?.line ?? null;
+    const column = node.loc?.start?.column ?? null;
+
+    warnings.push({
+      code: 91016,
+      message:
+        "`memo(...)` is removed during LitSX lowering. LitSX does not use React-style parent re-render bailout semantics, so `memo` is treated as a migration wrapper only.",
+      line,
+      column,
+    });
+
+    if ((node.arguments || []).length > 1) {
+      warnings.push({
+        code: 91017,
+        message:
+          "`memo(Component, areEqual)` ignores the comparator during LitSX lowering because LitSX does not use React-style parent re-render bailout semantics.",
+        line,
+        column,
+      });
+    }
+  }
+
+  function visit(node) {
+    if (!node || typeof node !== "object") {
+      return;
+    }
+
+    if (node.type === "CallExpression") {
+      const callee = node.callee;
+      const isImportedMemo =
+        callee?.type === "Identifier" && reactMemoLocalNames.has(callee.name);
+      const isNamespacedMemo =
+        callee?.type === "MemberExpression" &&
+        callee.computed === false &&
+        callee.object?.type === "Identifier" &&
+        reactNamespaceNames.has(callee.object.name) &&
+        callee.property?.type === "Identifier" &&
+        callee.property.name === "memo";
+
+      if (isImportedMemo || isNamespacedMemo) {
+        addMemoWarnings(node);
+      }
+    }
+
+    for (const value of Object.values(node)) {
+      if (Array.isArray(value)) {
+        value.forEach((child) => visit(child));
+      } else {
+        visit(value);
+      }
+    }
+  }
+
+  visit(ast.program ?? ast);
+  return warnings;
+}
+
+function normalizeParserPlugins(filename, parserPlugins = []) {
+  if (Array.isArray(parserPlugins) && parserPlugins.length > 0) {
+    return parserPlugins;
+  }
+
+  if (typeof filename === "string" && (
+    filename.endsWith(".tsx") ||
+    filename.endsWith(".litsx")
+  )) {
+    return ["typescript"];
+  }
+
+  return [];
+}
+
+function normalizePluginList(plugins) {
+  return Array.isArray(plugins) ? plugins : [];
+}
+
+export function ensureLitsxParserPlugins(filename, parserPlugins = [], { requireJsx = false } = {}) {
+  const normalized = normalizeParserPlugins(filename, parserPlugins);
+  if (!requireJsx) {
+    return normalized;
+  }
+
+  const hasJsx = normalized.some((plugin) => {
+    if (typeof plugin === "string") {
+      return plugin === "jsx";
+    }
+    return Array.isArray(plugin) && plugin[0] === "jsx";
+  });
+
+  return hasJsx ? normalized : [...normalized, "jsx"];
+}
+
+export function prepareLitsxAuthoredInput(
+  source,
+  options = {},
+  runtime = {}
+) {
+  const runtimeImpl = {
+    parse: babelParser.parse,
+    transformFromAstSync: null,
+    ...runtime,
+  };
+  const filename = options.filename;
+  const sourceMaps = options.sourceMaps === true;
+  const parserPlugins = ensureLitsxParserPlugins(filename, options.parserPlugins, {
+    requireJsx: options.requireJsx === true,
+  });
+  const virtualizedAst = parseWithLitsxVirtualization(runtimeImpl.parse, source, {
+    sourceType: "module",
+    plugins: parserPlugins,
+    sourceFileName: filename,
+    litsxSourceMap: sourceMaps,
+  });
+  const virtualization = getLitsxVirtualizationMetadata(virtualizedAst);
+  const authoredWarnings = mergeLitsxWarnings(
+    collectNativeClassNameWarnings(virtualizedAst),
+    collectReactMemoWarnings(virtualizedAst),
+    { filename }
+  );
+  const authoringPlugins = normalizePluginList(options.authoringPlugins);
+
+  let inputAst = virtualizedAst;
+  if (authoringPlugins.length > 0) {
+    if (typeof runtimeImpl.transformFromAstSync !== "function") {
+      throw new Error(
+        "prepareLitsxAuthoredInput(...) requires runtime.transformFromAstSync when authoringPlugins are provided."
+      );
+    }
+
+    const authoringPass = runtimeImpl.transformFromAstSync(virtualizedAst, source, {
+      filename,
+      sourceFileName: filename,
+      configFile: false,
+      babelrc: false,
+      ast: true,
+      code: false,
+      sourceMaps: false,
+      plugins: authoringPlugins,
+    });
+
+    inputAst = authoringPass?.ast ?? virtualizedAst;
+  }
+
+  return {
+    filename,
+    virtualization,
+    inputAst,
+    authoredWarnings,
+  };
+}