unplugin-react-fine-grained-signals 0.1.0

package/dist/unplugin-CG9_mdcA.d.ts

@@ -0,0 +1,77 @@
+import { TransformResult } from "unplugin";
+//#region src/internal/transform.d.ts
+type ReactFineGrainedSignalsMode = "manual" | "auto" | "all";
+type ReactFineGrainedSignalsTransform = "inject" | "managed";
+type ReactFineGrainedSignalsReactCompiler = "auto" | "off";
+//#endregion
+//#region src/unplugin.d.ts
+interface ReactFineGrainedSignalsOptions {
+  /**
+   * `manual` preserves explicit useSignals() opt-in. `auto` detects signal
+   * reads in components and custom hooks; `all` also wraps JSX components that
+   * do not statically expose a .value read.
+   */
+  mode?: ReactFineGrainedSignalsMode;
+  /** `managed` (default) adds an exact try/finally boundary; `inject` adds bare useSignals() for best-effort opt-in. */
+  transform?: ReactFineGrainedSignalsTransform;
+  /**
+   * `auto` (default) marks every transformed function with `"use no memo"`, so
+   * React Compiler cannot memoize away the signal reads render tracking needs.
+   * `off` omits the directive; only choose it when the compiler is not used, or
+   * when its memoization has been verified against this library's tracking.
+   */
+  reactCompiler?: ReactFineGrainedSignalsReactCompiler;
+  /** Package that exports `useSignals` and its `/runtime` entry. */
+  importSource?: string;
+  /**
+   * Extra module specifier whose `memo`/`forwardRef` exports are treated as
+   * React's own, for a codebase that imports them through one stable internal
+   * module instead of directly from `"react"`. Recognition is additive: a
+   * direct `"react"` import always counts, so this only widens detection.
+   * It does not resolve arbitrary re-export chains, and it cannot cover
+   * relative barrel paths that differ per importing file.
+   */
+  reactImportSource?: string;
+  /** Restrict transformation to matching source module identifiers. */
+  include?: (id: string) => boolean;
+  /** Exclude matching source module identifiers from transformation. */
+  exclude?: (id: string) => boolean;
+}
+declare const pluginName = "unplugin-react-fine-grained-signals";
+declare function canTransform(id: string, options: ReactFineGrainedSignalsOptions): boolean;
+/**
+ * The esbuild loader names this plugin itself ever chooses. esbuild's own
+ * `Loader` union is wider and is not importable here (esbuild is not a
+ * dependency of this package), so a value read out of the project's configured
+ * loader map is handed straight back and narrowed to this at the hook boundary.
+ */
+type EsbuildLoaderName = "js" | "jsx" | "ts" | "tsx";
+/**
+ * The loader to label `id`'s contents with, deferring to the build's own
+ * `loader` map first so a project that configured an extension keeps its
+ * choice. Exported for the adapter tests, which exercise the decision without
+ * needing esbuild itself.
+ */
+declare function resolveEsbuildLoader(id: string, configuredLoaders?: Record<string, string> | undefined): string;
+declare const reactFineGrainedSignals: import("unplugin").UnpluginInstance<ReactFineGrainedSignalsOptions, boolean>;
+/**
+ * The `{ code, map }` shape a bundler's `transform` hook returns on a real
+ * change, `null` on none. Derived from unplugin's own `TransformResult`
+ * (rather than naming the source-map types by hand) so the accepted `map`
+ * shape -- a real source map object when `sourceMaps: true` produces one, not
+ * only `null` -- always matches what unplugin itself expects, and follows
+ * unplugin's own type surface if that ever changes.
+ */
+type BundlerTransformOutput = Extract<TransformResult, {
+  code: string;
+}> | null;
+/**
+ * The one piece every per-bundler entry file (`vite.ts`, `webpack.ts`,
+ * `rollup.ts`, `esbuild.ts`, `rspack.ts`) repeated: casting `reactFineGrainedSignals`'s
+ * `bundler` property to a callable factory of its own bundler-specific plugin
+ * type. Each entry file supplies only the two things that actually differ
+ * between bundlers -- which property to read and what shape it returns.
+ */
+declare function createBundlerPlugin<Plugin>(bundler: "vite" | "webpack" | "rollup" | "esbuild" | "rspack"): (options?: ReactFineGrainedSignalsOptions) => Plugin;
+//#endregion
+export { createBundlerPlugin as a, resolveEsbuildLoader as c, ReactFineGrainedSignalsTransform as d, canTransform as i, ReactFineGrainedSignalsMode as l, EsbuildLoaderName as n, pluginName as o, ReactFineGrainedSignalsOptions as r, reactFineGrainedSignals as s, BundlerTransformOutput as t, ReactFineGrainedSignalsReactCompiler as u };

package/dist/vite.d.ts

@@ -0,0 +1,11 @@
+import { a as createBundlerPlugin, c as resolveEsbuildLoader, d as ReactFineGrainedSignalsTransform, i as canTransform, l as ReactFineGrainedSignalsMode, n as EsbuildLoaderName, o as pluginName, r as ReactFineGrainedSignalsOptions, s as reactFineGrainedSignals, t as BundlerTransformOutput, u as ReactFineGrainedSignalsReactCompiler } from "./unplugin-CG9_mdcA.js";
+//#region src/vite.d.ts
+/** A Rollup-compatible plugin shape also accepted by Vite. */
+interface VitePlugin {
+  name: string;
+  enforce?: "pre" | "post";
+  transform?: (code: string, id: string) => BundlerTransformOutput;
+}
+declare const _default: (options?: ReactFineGrainedSignalsOptions) => VitePlugin;
+//#endregion
+export { BundlerTransformOutput, EsbuildLoaderName, type ReactFineGrainedSignalsMode, ReactFineGrainedSignalsOptions, type ReactFineGrainedSignalsReactCompiler, type ReactFineGrainedSignalsTransform, VitePlugin, canTransform, createBundlerPlugin, _default as default, pluginName, reactFineGrainedSignals, resolveEsbuildLoader };

package/dist/vite.js

@@ -0,0 +1,5 @@
+import { a as resolveEsbuildLoader, i as reactFineGrainedSignals, n as createBundlerPlugin, r as pluginName, t as canTransform } from "./unplugin-B2_q8KNi.js";
+//#region src/vite.ts
+var vite_default = createBundlerPlugin("vite");
+//#endregion
+export { canTransform, createBundlerPlugin, vite_default as default, pluginName, reactFineGrainedSignals, resolveEsbuildLoader };

package/dist/webpack.d.ts

@@ -0,0 +1,9 @@
+import { a as createBundlerPlugin, c as resolveEsbuildLoader, d as ReactFineGrainedSignalsTransform, i as canTransform, l as ReactFineGrainedSignalsMode, n as EsbuildLoaderName, o as pluginName, r as ReactFineGrainedSignalsOptions, s as reactFineGrainedSignals, t as BundlerTransformOutput, u as ReactFineGrainedSignalsReactCompiler } from "./unplugin-CG9_mdcA.js";
+//#region src/webpack.d.ts
+/** The compiler-plugin contract used by webpack. */
+interface WebpackPlugin {
+  apply(compiler: unknown): void;
+}
+declare const _default: (options?: ReactFineGrainedSignalsOptions) => WebpackPlugin;
+//#endregion
+export { BundlerTransformOutput, EsbuildLoaderName, type ReactFineGrainedSignalsMode, ReactFineGrainedSignalsOptions, type ReactFineGrainedSignalsReactCompiler, type ReactFineGrainedSignalsTransform, WebpackPlugin, canTransform, createBundlerPlugin, _default as default, pluginName, reactFineGrainedSignals, resolveEsbuildLoader };

package/dist/webpack.js

@@ -0,0 +1,5 @@
+import { a as resolveEsbuildLoader, i as reactFineGrainedSignals, n as createBundlerPlugin, r as pluginName, t as canTransform } from "./unplugin-B2_q8KNi.js";
+//#region src/webpack.ts
+var webpack_default = createBundlerPlugin("webpack");
+//#endregion
+export { canTransform, createBundlerPlugin, webpack_default as default, pluginName, reactFineGrainedSignals, resolveEsbuildLoader };

package/package.json

@@ -0,0 +1,88 @@
+{
+  "name": "unplugin-react-fine-grained-signals",
+  "version": "0.1.0",
+  "description": "Universal useSignals transform for react-fine-grained-signals.",
+  "license": "MIT",
+  "author": "akazawa",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sakzw/react-fine-grained-signals.git",
+    "directory": "packages/unplugin-react-fine-grained-signals"
+  },
+  "homepage": "https://github.com/sakzw/react-fine-grained-signals/tree/main/packages/unplugin-react-fine-grained-signals#readme",
+  "bugs": {
+    "url": "https://github.com/sakzw/react-fine-grained-signals/issues"
+  },
+  "keywords": [
+    "unplugin",
+    "vite",
+    "rollup",
+    "webpack",
+    "rspack",
+    "esbuild",
+    "react",
+    "signals",
+    "fine-grained",
+    "react-fine-grained-signals",
+    "alien-signals"
+  ],
+  "type": "module",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./vite": {
+      "types": "./dist/vite.d.ts",
+      "import": "./dist/vite.js"
+    },
+    "./rollup": {
+      "types": "./dist/rollup.d.ts",
+      "import": "./dist/rollup.js"
+    },
+    "./webpack": {
+      "types": "./dist/webpack.d.ts",
+      "import": "./dist/webpack.js"
+    },
+    "./rspack": {
+      "types": "./dist/rspack.d.ts",
+      "import": "./dist/rspack.js"
+    },
+    "./esbuild": {
+      "types": "./dist/esbuild.d.ts",
+      "import": "./dist/esbuild.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "README.ja.md",
+    "LICENSE"
+  ],
+  "peerDependencies": {
+    "react-fine-grained-signals": "^0.1.0"
+  },
+  "dependencies": {
+    "@babel/core": "^8.0.1",
+    "@babel/helper-plugin-utils": "^8.0.1",
+    "@babel/types": "^8.0.4",
+    "unplugin": "^3.3.0"
+  },
+  "devDependencies": {
+    "@vitest/coverage-v8": "4.1.11",
+    "react-fine-grained-signals": "0.1.0",
+    "tsdown": "0.22.14",
+    "typescript": "^7.0.2",
+    "vitest": "^4.1.11"
+  },
+  "scripts": {
+    "build": "tsdown && node tests/build-smoke.mjs",
+    "bench": "node --expose-gc benchmarks/transform.mjs",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "test:react-compiler": "vitest run tests/react-compiler.test.ts",
+    "typecheck": "tsc --noEmit"
+  }
+}