@loupfeed/babel-plugin 0.1.0

package/LICENSE.md

@@ -0,0 +1,114 @@
+# Functional Source License, Version 1.1, Apache 2.0 Future License
+
+## Abbreviation
+
+FSL-1.1-ALv2
+
+## Notice
+
+Copyright 2026 loupfeed
+
+## Terms and Conditions
+
+### Licensor ("We")
+
+The party offering the Software under these Terms and Conditions.
+
+### The Software
+
+The "Software" is each version of the software that we make available under
+these Terms and Conditions, as indicated by our inclusion of these Terms and
+Conditions with the Software.
+
+### License Grant
+
+Subject to your compliance with this License Grant and the Patents,
+Redistribution and Trademark clauses below, we hereby grant you the right to use,
+copy, modify, create derivative works, publicly perform, publicly display and
+redistribute the Software for any Permitted Purpose identified below.
+
+### Permitted Purpose
+
+A Permitted Purpose is any purpose other than a Competing Use. A Competing Use
+means making the Software available to others in a commercial product or service
+that:
+
+1. substitutes for the Software;
+
+2. substitutes for any other product or service we offer using the Software that
+   exists as of the date we make the Software available; or
+
+3. offers the same or substantially similar functionality as the Software.
+
+Permitted Purposes specifically include using the Software:
+
+1. for your internal use and access;
+
+2. for non-commercial education;
+
+3. for non-commercial research; and
+
+4. in connection with professional services that you provide to a licensee using
+   the Software in accordance with these Terms and Conditions.
+
+### Patents
+
+To the extent your use for a Permitted Purpose would necessarily infringe our
+patents, the license grant above includes a license under our patents. If you
+make a claim against any party that the Software infringes or contributes to the
+infringement of any patent, then your patent license to the Software ends
+immediately.
+
+### Redistribution
+
+The Terms and Conditions apply to all copies, modifications and derivatives of
+the Software.
+
+If you redistribute any copies, modifications or derivatives of the Software, you
+must include a copy of or a link to these Terms and Conditions and not remove any
+copyright notices provided in or with the Software.
+
+### Disclaimer
+
+THE SOFTWARE IS PROVIDED "AS IS" AND WITHOUT WARRANTIES OF ANY KIND, INCLUDING
+BUT NOT LIMITED TO WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
+PURPOSE, NON-INFRINGEMENT AND TITLE.
+
+IN NO EVENT WILL WE HAVE ANY LIABILITY TO YOU ARISING OUT OF OR RELATED TO THE
+SOFTWARE, INCLUDING INDIRECT, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES, EVEN
+IF WE HAVE BEEN INFORMED OF THEIR POSSIBILITY IN ADVANCE.
+
+### Trademarks
+
+Except for displaying the License Details and identifying us as the origin of the
+Software, you have no right under these Terms and Conditions to use our
+trademarks, trade names, service marks or product names.
+
+## Grant of Future License
+
+We hereby irrevocably grant you an additional license to use the Software under
+the Apache License, Version 2.0 that is effective on the second anniversary of
+the date we make the Software available. On or after that date, you may use the
+Software under the Apache License, Version 2.0, in which case the following will
+apply:
+
+We hereby grant you a license to the Software under the Apache License, Version
+2.0, a copy of which is available at https://www.apache.org/licenses/LICENSE-2.0.
+
+---
+
+## In plain language (non-binding summary)
+
+This is a **Fair Source** license. You can:
+
+- **Self-host and run loupfeed** for your own purposes — including inside a
+  company, on your own servers or cloud account, for your own products.
+- Read, modify, fork, and redistribute the source.
+
+The one thing you may **not** do is offer loupfeed (or something substantially
+similar built from it) **as a competing commercial product or hosted service**.
+
+Two years after each release is published, that version automatically becomes
+available to you under the **Apache License 2.0** (fully open source).
+
+This summary is for convenience only; the Terms and Conditions above govern.

package/dist/index.cjs

@@ -0,0 +1,77 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  default: () => loupfeedBabel,
+  getManifest: () => getManifest,
+  resetManifest: () => resetManifest
+});
+module.exports = __toCommonJS(index_exports);
+var import_node_path = __toESM(require("path"), 1);
+var import_build = require("@loupfeed/build");
+var manifest = {};
+function getManifest() {
+  return { ...manifest };
+}
+function resetManifest() {
+  for (const k of Object.keys(manifest)) delete manifest[k];
+}
+function loupfeedBabel(babel, options = {}) {
+  const t = babel.types;
+  const attribute = options.attribute ?? import_build.FB_ATTR;
+  const projectRoot = options.projectRoot ?? process.cwd();
+  return {
+    name: "loupfeed",
+    visitor: {
+      JSXOpeningElement(p, state) {
+        const node = p.node;
+        if (!node.loc) return;
+        const filename = state.file?.opts?.filename ?? "";
+        const rel = filename ? import_node_path.default.relative(projectRoot, filename) : "unknown";
+        const already = node.attributes.some(
+          (a) => a.type === "JSXAttribute" && a.name?.name === attribute
+        );
+        if (already) return;
+        const id = (0, import_build.fbId)(rel, node.loc.start.line, node.loc.start.column);
+        manifest[id] = `${rel}:${node.loc.start.line}`;
+        node.attributes.push(
+          t.jsxAttribute(t.jsxIdentifier(attribute), t.stringLiteral(id))
+        );
+      }
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getManifest,
+  resetManifest
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * @loupfeed/babel-plugin — the generic JSX tagger. This is the fallback that also\n * powers React Native via Metro (RN runs Babel). On web it injects an opaque\n * `data-fb` attribute; for RN set `attribute: 'fbId'` so the id rides as a prop\n * threaded to the native view's testID (doc 03 §React Native).\n *\n * Babel runs per-file, so the manifest is accumulated in-process and flushed by a\n * build/CLI hook (`getManifest()` → upload). Types are kept minimal so we don't\n * hard-depend on @babel/core at build time (it's a peer).\n */\n\nimport path from 'node:path';\nimport { FB_ATTR, fbId } from '@loupfeed/build';\n\ninterface BabelTypes {\n  jsxAttribute(name: unknown, value: unknown): unknown;\n  jsxIdentifier(name: string): unknown;\n  stringLiteral(value: string): unknown;\n}\ninterface Babel {\n  types: BabelTypes;\n}\ninterface JSXAttr {\n  type: string;\n  name?: { name?: string };\n}\ninterface JSXOpeningElementNode {\n  loc?: { start: { line: number; column: number } };\n  attributes: JSXAttr[];\n}\ninterface VisitorPath {\n  node: JSXOpeningElementNode;\n}\ninterface PluginState {\n  file?: { opts?: { filename?: string } };\n}\n\nexport interface LoupfeedBabelOptions {\n  /** 'data-fb' (web, default) or 'fbId' (React Native). */\n  attribute?: string;\n  projectRoot?: string;\n}\n\nconst manifest: Record<string, string> = {};\n\n/** The accumulated `{ id -> rel:line }` across all transformed files. */\nexport function getManifest(): Record<string, string> {\n  return { ...manifest };\n}\n\nexport function resetManifest(): void {\n  for (const k of Object.keys(manifest)) delete manifest[k];\n}\n\nexport default function loupfeedBabel(babel: Babel, options: LoupfeedBabelOptions = {}) {\n  const t = babel.types;\n  const attribute = options.attribute ?? FB_ATTR;\n  const projectRoot = options.projectRoot ?? process.cwd();\n\n  return {\n    name: 'loupfeed',\n    visitor: {\n      JSXOpeningElement(p: VisitorPath, state: PluginState) {\n        const node = p.node;\n        if (!node.loc) return;\n        const filename = state.file?.opts?.filename ?? '';\n        const rel = filename ? path.relative(projectRoot, filename) : 'unknown';\n        const already = node.attributes.some(\n          (a) => a.type === 'JSXAttribute' && a.name?.name === attribute,\n        );\n        if (already) return;\n        const id = fbId(rel, node.loc.start.line, node.loc.start.column);\n        manifest[id] = `${rel}:${node.loc.start.line}`;\n        node.attributes.push(\n          t.jsxAttribute(t.jsxIdentifier(attribute), t.stringLiteral(id)) as JSXAttr,\n        );\n      },\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAWA,uBAAiB;AACjB,mBAA8B;AA+B9B,IAAM,WAAmC,CAAC;AAGnC,SAAS,cAAsC;AACpD,SAAO,EAAE,GAAG,SAAS;AACvB;AAEO,SAAS,gBAAsB;AACpC,aAAW,KAAK,OAAO,KAAK,QAAQ,EAAG,QAAO,SAAS,CAAC;AAC1D;AAEe,SAAR,cAA+B,OAAc,UAAgC,CAAC,GAAG;AACtF,QAAM,IAAI,MAAM;AAChB,QAAM,YAAY,QAAQ,aAAa;AACvC,QAAM,cAAc,QAAQ,eAAe,QAAQ,IAAI;AAEvD,SAAO;AAAA,IACL,MAAM;AAAA,IACN,SAAS;AAAA,MACP,kBAAkB,GAAgB,OAAoB;AACpD,cAAM,OAAO,EAAE;AACf,YAAI,CAAC,KAAK,IAAK;AACf,cAAM,WAAW,MAAM,MAAM,MAAM,YAAY;AAC/C,cAAM,MAAM,WAAW,iBAAAA,QAAK,SAAS,aAAa,QAAQ,IAAI;AAC9D,cAAM,UAAU,KAAK,WAAW;AAAA,UAC9B,CAAC,MAAM,EAAE,SAAS,kBAAkB,EAAE,MAAM,SAAS;AAAA,QACvD;AACA,YAAI,QAAS;AACb,cAAM,SAAK,mBAAK,KAAK,KAAK,IAAI,MAAM,MAAM,KAAK,IAAI,MAAM,MAAM;AAC/D,iBAAS,EAAE,IAAI,GAAG,GAAG,IAAI,KAAK,IAAI,MAAM,IAAI;AAC5C,aAAK,WAAW;AAAA,UACd,EAAE,aAAa,EAAE,cAAc,SAAS,GAAG,EAAE,cAAc,EAAE,CAAC;AAAA,QAChE;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;","names":["path"]}

package/dist/index.d.cts

@@ -0,0 +1,59 @@
+/**
+ * @loupfeed/babel-plugin — the generic JSX tagger. This is the fallback that also
+ * powers React Native via Metro (RN runs Babel). On web it injects an opaque
+ * `data-fb` attribute; for RN set `attribute: 'fbId'` so the id rides as a prop
+ * threaded to the native view's testID (doc 03 §React Native).
+ *
+ * Babel runs per-file, so the manifest is accumulated in-process and flushed by a
+ * build/CLI hook (`getManifest()` → upload). Types are kept minimal so we don't
+ * hard-depend on @babel/core at build time (it's a peer).
+ */
+interface BabelTypes {
+    jsxAttribute(name: unknown, value: unknown): unknown;
+    jsxIdentifier(name: string): unknown;
+    stringLiteral(value: string): unknown;
+}
+interface Babel {
+    types: BabelTypes;
+}
+interface JSXAttr {
+    type: string;
+    name?: {
+        name?: string;
+    };
+}
+interface JSXOpeningElementNode {
+    loc?: {
+        start: {
+            line: number;
+            column: number;
+        };
+    };
+    attributes: JSXAttr[];
+}
+interface VisitorPath {
+    node: JSXOpeningElementNode;
+}
+interface PluginState {
+    file?: {
+        opts?: {
+            filename?: string;
+        };
+    };
+}
+interface LoupfeedBabelOptions {
+    /** 'data-fb' (web, default) or 'fbId' (React Native). */
+    attribute?: string;
+    projectRoot?: string;
+}
+/** The accumulated `{ id -> rel:line }` across all transformed files. */
+declare function getManifest(): Record<string, string>;
+declare function resetManifest(): void;
+declare function loupfeedBabel(babel: Babel, options?: LoupfeedBabelOptions): {
+    name: string;
+    visitor: {
+        JSXOpeningElement(p: VisitorPath, state: PluginState): void;
+    };
+};
+
+export { type LoupfeedBabelOptions, loupfeedBabel as default, getManifest, resetManifest };

package/dist/index.d.ts

@@ -0,0 +1,59 @@
+/**
+ * @loupfeed/babel-plugin — the generic JSX tagger. This is the fallback that also
+ * powers React Native via Metro (RN runs Babel). On web it injects an opaque
+ * `data-fb` attribute; for RN set `attribute: 'fbId'` so the id rides as a prop
+ * threaded to the native view's testID (doc 03 §React Native).
+ *
+ * Babel runs per-file, so the manifest is accumulated in-process and flushed by a
+ * build/CLI hook (`getManifest()` → upload). Types are kept minimal so we don't
+ * hard-depend on @babel/core at build time (it's a peer).
+ */
+interface BabelTypes {
+    jsxAttribute(name: unknown, value: unknown): unknown;
+    jsxIdentifier(name: string): unknown;
+    stringLiteral(value: string): unknown;
+}
+interface Babel {
+    types: BabelTypes;
+}
+interface JSXAttr {
+    type: string;
+    name?: {
+        name?: string;
+    };
+}
+interface JSXOpeningElementNode {
+    loc?: {
+        start: {
+            line: number;
+            column: number;
+        };
+    };
+    attributes: JSXAttr[];
+}
+interface VisitorPath {
+    node: JSXOpeningElementNode;
+}
+interface PluginState {
+    file?: {
+        opts?: {
+            filename?: string;
+        };
+    };
+}
+interface LoupfeedBabelOptions {
+    /** 'data-fb' (web, default) or 'fbId' (React Native). */
+    attribute?: string;
+    projectRoot?: string;
+}
+/** The accumulated `{ id -> rel:line }` across all transformed files. */
+declare function getManifest(): Record<string, string>;
+declare function resetManifest(): void;
+declare function loupfeedBabel(babel: Babel, options?: LoupfeedBabelOptions): {
+    name: string;
+    visitor: {
+        JSXOpeningElement(p: VisitorPath, state: PluginState): void;
+    };
+};
+
+export { type LoupfeedBabelOptions, loupfeedBabel as default, getManifest, resetManifest };

package/dist/index.js

@@ -0,0 +1,41 @@
+// src/index.ts
+import path from "path";
+import { FB_ATTR, fbId } from "@loupfeed/build";
+var manifest = {};
+function getManifest() {
+  return { ...manifest };
+}
+function resetManifest() {
+  for (const k of Object.keys(manifest)) delete manifest[k];
+}
+function loupfeedBabel(babel, options = {}) {
+  const t = babel.types;
+  const attribute = options.attribute ?? FB_ATTR;
+  const projectRoot = options.projectRoot ?? process.cwd();
+  return {
+    name: "loupfeed",
+    visitor: {
+      JSXOpeningElement(p, state) {
+        const node = p.node;
+        if (!node.loc) return;
+        const filename = state.file?.opts?.filename ?? "";
+        const rel = filename ? path.relative(projectRoot, filename) : "unknown";
+        const already = node.attributes.some(
+          (a) => a.type === "JSXAttribute" && a.name?.name === attribute
+        );
+        if (already) return;
+        const id = fbId(rel, node.loc.start.line, node.loc.start.column);
+        manifest[id] = `${rel}:${node.loc.start.line}`;
+        node.attributes.push(
+          t.jsxAttribute(t.jsxIdentifier(attribute), t.stringLiteral(id))
+        );
+      }
+    }
+  };
+}
+export {
+  loupfeedBabel as default,
+  getManifest,
+  resetManifest
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * @loupfeed/babel-plugin — the generic JSX tagger. This is the fallback that also\n * powers React Native via Metro (RN runs Babel). On web it injects an opaque\n * `data-fb` attribute; for RN set `attribute: 'fbId'` so the id rides as a prop\n * threaded to the native view's testID (doc 03 §React Native).\n *\n * Babel runs per-file, so the manifest is accumulated in-process and flushed by a\n * build/CLI hook (`getManifest()` → upload). Types are kept minimal so we don't\n * hard-depend on @babel/core at build time (it's a peer).\n */\n\nimport path from 'node:path';\nimport { FB_ATTR, fbId } from '@loupfeed/build';\n\ninterface BabelTypes {\n  jsxAttribute(name: unknown, value: unknown): unknown;\n  jsxIdentifier(name: string): unknown;\n  stringLiteral(value: string): unknown;\n}\ninterface Babel {\n  types: BabelTypes;\n}\ninterface JSXAttr {\n  type: string;\n  name?: { name?: string };\n}\ninterface JSXOpeningElementNode {\n  loc?: { start: { line: number; column: number } };\n  attributes: JSXAttr[];\n}\ninterface VisitorPath {\n  node: JSXOpeningElementNode;\n}\ninterface PluginState {\n  file?: { opts?: { filename?: string } };\n}\n\nexport interface LoupfeedBabelOptions {\n  /** 'data-fb' (web, default) or 'fbId' (React Native). */\n  attribute?: string;\n  projectRoot?: string;\n}\n\nconst manifest: Record<string, string> = {};\n\n/** The accumulated `{ id -> rel:line }` across all transformed files. */\nexport function getManifest(): Record<string, string> {\n  return { ...manifest };\n}\n\nexport function resetManifest(): void {\n  for (const k of Object.keys(manifest)) delete manifest[k];\n}\n\nexport default function loupfeedBabel(babel: Babel, options: LoupfeedBabelOptions = {}) {\n  const t = babel.types;\n  const attribute = options.attribute ?? FB_ATTR;\n  const projectRoot = options.projectRoot ?? process.cwd();\n\n  return {\n    name: 'loupfeed',\n    visitor: {\n      JSXOpeningElement(p: VisitorPath, state: PluginState) {\n        const node = p.node;\n        if (!node.loc) return;\n        const filename = state.file?.opts?.filename ?? '';\n        const rel = filename ? path.relative(projectRoot, filename) : 'unknown';\n        const already = node.attributes.some(\n          (a) => a.type === 'JSXAttribute' && a.name?.name === attribute,\n        );\n        if (already) return;\n        const id = fbId(rel, node.loc.start.line, node.loc.start.column);\n        manifest[id] = `${rel}:${node.loc.start.line}`;\n        node.attributes.push(\n          t.jsxAttribute(t.jsxIdentifier(attribute), t.stringLiteral(id)) as JSXAttr,\n        );\n      },\n    },\n  };\n}\n"],"mappings":";AAWA,OAAO,UAAU;AACjB,SAAS,SAAS,YAAY;AA+B9B,IAAM,WAAmC,CAAC;AAGnC,SAAS,cAAsC;AACpD,SAAO,EAAE,GAAG,SAAS;AACvB;AAEO,SAAS,gBAAsB;AACpC,aAAW,KAAK,OAAO,KAAK,QAAQ,EAAG,QAAO,SAAS,CAAC;AAC1D;AAEe,SAAR,cAA+B,OAAc,UAAgC,CAAC,GAAG;AACtF,QAAM,IAAI,MAAM;AAChB,QAAM,YAAY,QAAQ,aAAa;AACvC,QAAM,cAAc,QAAQ,eAAe,QAAQ,IAAI;AAEvD,SAAO;AAAA,IACL,MAAM;AAAA,IACN,SAAS;AAAA,MACP,kBAAkB,GAAgB,OAAoB;AACpD,cAAM,OAAO,EAAE;AACf,YAAI,CAAC,KAAK,IAAK;AACf,cAAM,WAAW,MAAM,MAAM,MAAM,YAAY;AAC/C,cAAM,MAAM,WAAW,KAAK,SAAS,aAAa,QAAQ,IAAI;AAC9D,cAAM,UAAU,KAAK,WAAW;AAAA,UAC9B,CAAC,MAAM,EAAE,SAAS,kBAAkB,EAAE,MAAM,SAAS;AAAA,QACvD;AACA,YAAI,QAAS;AACb,cAAM,KAAK,KAAK,KAAK,KAAK,IAAI,MAAM,MAAM,KAAK,IAAI,MAAM,MAAM;AAC/D,iBAAS,EAAE,IAAI,GAAG,GAAG,IAAI,KAAK,IAAI,MAAM,IAAI;AAC5C,aAAK,WAAW;AAAA,UACd,EAAE,aAAa,EAAE,cAAc,SAAS,GAAG,EAAE,cAAc,EAAE,CAAC;AAAA,QAChE;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;","names":[]}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@loupfeed/babel-plugin",
+  "version": "0.1.0",
+  "description": "loupfeed Babel plugin — the generic JSX tagger (Next/SWC fallback + RN/Metro). Injects an opaque data-fb attribute (web) or fbId prop (React Native).",
+  "license": "FSL-1.1-ALv2",
+  "homepage": "https://loupfeed.com",
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@loupfeed/build": "0.1.0"
+  },
+  "peerDependencies": {
+    "@babel/core": "^7.0.0"
+  },
+  "devDependencies": {
+    "@babel/core": "^7.26.0",
+    "@babel/plugin-syntax-jsx": "^7.25.9",
+    "@types/babel__core": "^7.20.5",
+    "@types/node": "^22.10.2",
+    "tsup": "^8.3.5",
+    "typescript": "~5.7.2",
+    "vitest": "^2.1.8"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "clean": "rm -rf dist .turbo"
+  }
+}