@bgub/fig-vite 0.0.0-tegami-trusted-publish-setup → 0.1.0-alpha.2

package/CHANGELOG.md

@@ -0,0 +1,41 @@
+## @bgub/fig-vite@0.1.0-alpha.1
+
+### Refresh resolves the app's renderer runtime
+
+`figRefresh` now imports `@bgub/fig-dom/refresh` through its bare specifier
+rather than a resolved `/@fs/` path, so app-level aliases, dedupe, and
+prebundling apply and the refresh scheduler cannot be instantiated twice.
+
+### TanStack Start's client graph is prebundled
+
+The TanStack Start adapter now prebundles `@tanstack/start-client-core` in
+development while leaving its application-bound router and Start imports as
+external Vite modules. This reduces the module-request waterfall without
+freezing generated app entries or the linked Fig adapter packages. Production
+continues to use Vite's normal application bundling.
+
+### Use one data-resource API in every environment
+
+`dataResource` now covers shared, browser, and server-only loaders without a
+second API. Server-only loaders belong behind the framework's server module
+boundary; browser code uses an explicit key-only resource when it needs the
+same hydrated value.
+
+The pass-through `serverDataResource` API, `@bgub/fig/server` entry point,
+`figData` Vite transform, and generated browser resource stubs are removed.
+
+### TanStack Start gains state-preserving Fast Refresh
+
+The TanStack Start Vite adapter now installs Fig Fast Refresh automatically.
+Component edits update in place and preserve hook state in accepted modules.
+
+`@bgub/fig-vite` is now a public package containing the reusable Fast Refresh
+and server data-resource transforms.
+
+## @bgub/fig-vite@0.1.0-alpha.0 (alpha)
+
+### Initial alpha release
+
+Fig Fast Refresh and server data-resource transforms for Vite.
+
+# Changelog

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) Ben Gubler
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,5 +1,18 @@
-# Placeholder package
+# @bgub/fig-vite
 
-This empty package was published by [Tegami](https://tegami.fuma-nama.dev) to configure npm trusted publishing.
+Vite integration for Fig. It provides state-preserving Fast Refresh.
 
-The real package contents will be published via CI with OIDC.
+```ts
+import { figRefresh } from "@bgub/fig-vite";
+
+const plugins = [figRefresh()];
+```
+
+Framework adapters may install this plugin for you. In particular,
+`@bgub/fig-tanstack-start/plugin/vite` includes `figRefresh()`.
+
+Fig packages are ESM-only and require Node `^20.19.0 || >=22.12.0`.
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+//#region src/index.d.ts
+interface FigRefreshOptions {
+  include?: RegExp;
+}
+interface FigRefreshPlugin {
+  apply: "serve";
+  enforce: "pre";
+  load(id: string): string | null;
+  name: string;
+  resolveId(id: string): string | null;
+  transform(code: string, id: string, options?: {
+    ssr?: boolean;
+  }): Promise<{
+    code: string;
+    map: unknown;
+  } | null>;
+}
+declare function figRefresh(options?: FigRefreshOptions): FigRefreshPlugin;
+//#endregion
+export { FigRefreshOptions, FigRefreshPlugin, figRefresh };

package/dist/index.js

@@ -0,0 +1,234 @@
+import { fileURLToPath } from "node:url";
+import * as babel from "@babel/core";
+import presetTypescript from "@babel/preset-typescript";
+//#region src/transform.ts
+function figRefreshBabelPlugin(api) {
+	const t = api.types;
+	const template = api.template;
+	return {
+		name: "fig-refresh",
+		visitor: { Program: { exit(path) {
+			const moduleId = this.opts?.moduleId;
+			if (moduleId === void 0) return;
+			const functions = /* @__PURE__ */ new Map();
+			for (const statement of path.get("body")) {
+				const declaration = statement.isExportNamedDeclaration() || statement.isExportDefaultDeclaration() ? statement.get("declaration") : statement;
+				if (!Array.isArray(declaration) && (declaration.isFunctionDeclaration() || declaration.isVariableDeclaration())) collectFunction(declaration, functions);
+			}
+			const components = [...functions.values()].filter((record) => record.isComponent);
+			if (components.length === 0) return;
+			const canSelfAccept = exportsOnlyComponents(path, functions);
+			for (const component of components) {
+				const result = signatureFor(component, [component.name]);
+				component.signature = result.signature;
+				component.forceReset = result.forceReset;
+			}
+			path.node.body.unshift(template.statement.ast(canSelfAccept ? `import { register as __figReg, setSignature as __figSig, enqueueRefresh as __figRefresh } from "virtual:fig-refresh";` : `import { register as __figReg, setSignature as __figSig } from "virtual:fig-refresh";`));
+			const tail = [];
+			for (const component of components) {
+				const signature = component.signature ?? "";
+				const forceReset = component.forceReset === true;
+				tail.push(template.statement.ast(`__figReg(${component.name}, ${JSON.stringify(`${moduleId}#${component.name}`)});`));
+				tail.push(template.statement.ast(forceReset ? `__figSig(${component.name}, ${JSON.stringify(signature)}, true);` : `__figSig(${component.name}, ${JSON.stringify(signature)});`));
+			}
+			if (canSelfAccept) tail.push(template.statement.ast(`if (import.meta.hot) { import.meta.hot.accept(); __figRefresh(); }`));
+			path.node.body.push(...tail);
+			function collectFunction(declaration, into) {
+				if (declaration.isFunctionDeclaration()) {
+					const id = declaration.node.id;
+					if (id != null) {
+						const isComponent = isComponentName(id.name);
+						const isCustomHook = isCustomHookName(id.name);
+						if (isComponent || isCustomHook) into.set(id.name, {
+							fnPath: declaration,
+							isComponent,
+							isCustomHook,
+							name: id.name
+						});
+					}
+					return;
+				}
+				if (declaration.isVariableDeclaration()) for (const declarator of declaration.get("declarations")) {
+					const id = declarator.node.id;
+					const init = declarator.node.init;
+					if (t.isIdentifier(id) && init != null && (t.isArrowFunctionExpression(init) || t.isFunctionExpression(init))) {
+						const isComponent = isComponentName(id.name);
+						const isCustomHook = isCustomHookName(id.name);
+						if (!isComponent && !isCustomHook) continue;
+						into.set(id.name, {
+							fnPath: declarator.get("init"),
+							isComponent,
+							isCustomHook,
+							name: id.name
+						});
+					}
+				}
+			}
+			function signatureFor(record, stack) {
+				const hookNames = [];
+				let forceReset = false;
+				record.fnPath.traverse({ CallExpression(call) {
+					if (call.getFunctionParent()?.node !== record.fnPath.node) return;
+					const callee = call.node.callee;
+					const hookName = hookCallName(callee);
+					if (hookName === null) return;
+					hookNames.push(hookName);
+					const hookRecord = functions.get(hookName);
+					if (hookRecord?.isCustomHook !== true) {
+						if (!isBuiltinFigHookName(hookName)) forceReset = true;
+						return;
+					}
+					if (stack.includes(hookName)) {
+						forceReset = true;
+						return;
+					}
+					const nested = signatureFor(hookRecord, [...stack, hookName]);
+					forceReset = forceReset || nested.forceReset;
+					if (nested.signature !== "") hookNames.push(...nested.signature.split("\n").map((line) => `>${line}`));
+				} });
+				return {
+					forceReset,
+					signature: hookNames.join("\n")
+				};
+			}
+			function hookCallName(callee) {
+				if (t.isIdentifier(callee)) return isCustomHookName(callee.name) ? callee.name : null;
+				if (t.isMemberExpression(callee) && !callee.computed && t.isIdentifier(callee.property) && isCustomHookName(callee.property.name)) return callee.property.name;
+				return null;
+			}
+			function exportsOnlyComponents(program, records) {
+				for (const statement of program.get("body")) {
+					if (statement.isExportNamedDeclaration()) {
+						if (statement.node.exportKind === "type") continue;
+						const declaration = statement.get("declaration");
+						if (!Array.isArray(declaration) && declaration.node != null) {
+							if (!declarationExportsOnlyComponents(declaration.node, records)) return false;
+							continue;
+						}
+						if (statement.node.source != null) {
+							for (const specifier of statement.node.specifiers) {
+								if ("exportKind" in specifier && specifier.exportKind === "type") continue;
+								return false;
+							}
+							continue;
+						}
+						for (const specifier of statement.get("specifiers")) {
+							if (specifier.isExportSpecifier() && specifier.node.exportKind === "type") continue;
+							if (!specifier.isExportSpecifier()) return false;
+							const local = specifier.node.local;
+							if (!t.isIdentifier(local)) return false;
+							if (records.get(local.name)?.isComponent !== true) return false;
+						}
+						continue;
+					}
+					if (statement.isExportDefaultDeclaration()) {
+						const declaration = statement.get("declaration");
+						if (Array.isArray(declaration)) return false;
+						if (declaration.isFunctionDeclaration()) {
+							const id = declaration.node.id;
+							if (id == null || !isComponentName(id.name)) return false;
+							continue;
+						}
+						if (declaration.isIdentifier() && records.get(declaration.node.name)?.isComponent === true) continue;
+						return false;
+					}
+					if (statement.isExportAllDeclaration()) return false;
+				}
+				return true;
+			}
+			function declarationExportsOnlyComponents(declaration, records) {
+				if (t.isFunctionDeclaration(declaration)) {
+					const id = declaration.id;
+					return id != null && records.get(id.name)?.isComponent === true;
+				}
+				if (!t.isVariableDeclaration(declaration)) return false;
+				for (const declarator of declaration.declarations) {
+					if (!t.isIdentifier(declarator.id)) return false;
+					if (records.get(declarator.id.name)?.isComponent !== true) return false;
+				}
+				return true;
+			}
+		} } }
+	};
+}
+function isComponentName(name) {
+	const first = name[0];
+	return first !== void 0 && first >= "A" && first <= "Z";
+}
+function isCustomHookName(name) {
+	return /^use[A-Z]/.test(name);
+}
+function isBuiltinFigHookName(name) {
+	return name === "useActionState" || name === "useBeforeLayout" || name === "useBeforePaint" || name === "useCallback" || name === "useSyncExternalStore" || name === "useId" || name === "useDeferredValue" || name === "useMemo" || name === "useReactive" || name === "useStableEvent" || name === "useState" || name === "useTransition";
+}
+async function transformModule(code, id) {
+	const result = await babel.transformAsync(code, {
+		babelrc: false,
+		configFile: false,
+		filename: id,
+		sourceMaps: true,
+		presets: [[presetTypescript, {
+			ignoreExtensions: true,
+			onlyRemoveTypeImports: true
+		}]],
+		parserOpts: { plugins: id.endsWith("x") ? ["jsx"] : [] },
+		plugins: [[figRefreshBabelPlugin, { moduleId: id }]]
+	});
+	if (result?.code == null || !result.code.includes("virtual:fig-refresh")) return null;
+	return {
+		code: result.code,
+		map: result.map
+	};
+}
+//#endregion
+//#region src/index.ts
+const VIRTUAL_ID = "virtual:fig-refresh";
+const RESOLVED_VIRTUAL_ID = "\0virtual:fig-refresh";
+const REFRESH_RUNTIME_IMPORT = viteFileImport(import.meta.resolve("@bgub/fig-refresh"));
+const DOM_REFRESH_IMPORT = "@bgub/fig-dom/refresh";
+function figRefresh(options = {}) {
+	const include = options.include ?? /\.[jt]sx?$/;
+	return {
+		apply: "serve",
+		enforce: "pre",
+		name: "fig:refresh",
+		resolveId(id) {
+			return id === VIRTUAL_ID ? RESOLVED_VIRTUAL_ID : null;
+		},
+		load(id) {
+			return id === RESOLVED_VIRTUAL_ID ? virtualModuleCode() : null;
+		},
+		async transform(code, id, transformOptions) {
+			if (transformOptions?.ssr === true) return null;
+			const clean = id.split("?")[0] ?? id;
+			if (clean.includes("/node_modules/") || !include.test(clean)) return null;
+			return transformModule(code, clean);
+		}
+	};
+}
+function virtualModuleCode() {
+	return `import { injectScheduleRefresh, performRefresh, register, setSignature } from ${JSON.stringify(REFRESH_RUNTIME_IMPORT)};
+import { scheduleRefresh } from ${JSON.stringify(DOM_REFRESH_IMPORT)};
+
+injectScheduleRefresh(scheduleRefresh);
+
+let queued = false;
+export function enqueueRefresh() {
+  if (queued) return;
+  queued = true;
+  queueMicrotask(() => {
+    queued = false;
+    performRefresh();
+  });
+}
+
+export { register, setSignature };
+`;
+}
+function viteFileImport(url) {
+	return `/@fs/${fileURLToPath(url)}`;
+}
+//#endregion
+export { figRefresh };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/transform.ts","../src/index.ts"],"sourcesContent":["import * as babel from \"@babel/core\";\nimport type { NodePath, PluginObject } from \"@babel/core\";\nimport presetTypescript from \"@babel/preset-typescript\";\n\ninterface TransformResult {\n  code: string;\n  map: unknown;\n}\n\ninterface FunctionRecord {\n  fnPath: NodePath;\n  isComponent: boolean;\n  isCustomHook: boolean;\n  name: string;\n}\n\ninterface SignatureResult {\n  forceReset: boolean;\n  signature: string;\n}\n\n// Babel visitor: find top-level component declarations (PascalCase functions),\n// then inject calls to the Fig refresh runtime + a self-accepting HMR boundary.\n// Emits register/setSignature directly (no react-refresh global protocol).\nfunction figRefreshBabelPlugin(api: typeof babel): PluginObject {\n  const t = api.types;\n  const template = api.template;\n\n  return {\n    name: \"fig-refresh\",\n    visitor: {\n      Program: {\n        exit(path) {\n          const moduleId = (this as { opts?: { moduleId?: string } }).opts\n            ?.moduleId;\n          if (moduleId === undefined) return;\n\n          const functions = new Map<string, FunctionRecord>();\n\n          for (const statement of path.get(\"body\")) {\n            const exported =\n              statement.isExportNamedDeclaration() ||\n              statement.isExportDefaultDeclaration();\n            const declaration = exported\n              ? statement.get(\"declaration\")\n              : statement;\n            if (\n              !Array.isArray(declaration) &&\n              (declaration.isFunctionDeclaration() ||\n                declaration.isVariableDeclaration())\n            ) {\n              collectFunction(declaration, functions);\n            }\n          }\n\n          const components = [...functions.values()].filter(\n            (record) => record.isComponent,\n          );\n          if (components.length === 0) return;\n\n          const canSelfAccept = exportsOnlyComponents(path, functions);\n          for (const component of components) {\n            const result = signatureFor(component, [component.name]);\n            (component as FunctionRecord & SignatureResult).signature =\n              result.signature;\n            (component as FunctionRecord & SignatureResult).forceReset =\n              result.forceReset;\n          }\n\n          path.node.body.unshift(\n            template.statement.ast(\n              canSelfAccept\n                ? `import { register as __figReg, setSignature as __figSig, enqueueRefresh as __figRefresh } from \"virtual:fig-refresh\";`\n                : `import { register as __figReg, setSignature as __figSig } from \"virtual:fig-refresh\";`,\n            ),\n          );\n\n          const tail = [];\n          for (const component of components) {\n            const signature =\n              (component as FunctionRecord & Partial<SignatureResult>)\n                .signature ?? \"\";\n            const forceReset =\n              (component as FunctionRecord & Partial<SignatureResult>)\n                .forceReset === true;\n            tail.push(\n              template.statement.ast(\n                `__figReg(${component.name}, ${JSON.stringify(\n                  `${moduleId}#${component.name}`,\n                )});`,\n              ),\n            );\n            tail.push(\n              template.statement.ast(\n                forceReset\n                  ? `__figSig(${component.name}, ${JSON.stringify(\n                      signature,\n                    )}, true);`\n                  : `__figSig(${component.name}, ${JSON.stringify(\n                      signature,\n                    )});`,\n              ),\n            );\n          }\n          if (canSelfAccept) {\n            tail.push(\n              template.statement.ast(\n                `if (import.meta.hot) { import.meta.hot.accept(); __figRefresh(); }`,\n              ),\n            );\n          }\n          path.node.body.push(...(tail as never[]));\n\n          function collectFunction(\n            declaration:\n              | NodePath<babel.types.FunctionDeclaration>\n              | NodePath<babel.types.VariableDeclaration>,\n            into: Map<string, FunctionRecord>,\n          ): void {\n            if (declaration.isFunctionDeclaration()) {\n              const id = declaration.node.id;\n              if (id != null) {\n                const isComponent = isComponentName(id.name);\n                const isCustomHook = isCustomHookName(id.name);\n                if (isComponent || isCustomHook) {\n                  into.set(id.name, {\n                    fnPath: declaration,\n                    isComponent,\n                    isCustomHook,\n                    name: id.name,\n                  });\n                }\n              }\n              return;\n            }\n\n            if (declaration.isVariableDeclaration()) {\n              for (const declarator of declaration.get(\"declarations\")) {\n                const id = declarator.node.id;\n                const init = declarator.node.init;\n                if (\n                  t.isIdentifier(id) &&\n                  init != null &&\n                  (t.isArrowFunctionExpression(init) ||\n                    t.isFunctionExpression(init))\n                ) {\n                  const isComponent = isComponentName(id.name);\n                  const isCustomHook = isCustomHookName(id.name);\n                  if (!isComponent && !isCustomHook) continue;\n                  into.set(id.name, {\n                    fnPath: declarator.get(\"init\") as NodePath,\n                    isComponent,\n                    isCustomHook,\n                    name: id.name,\n                  });\n                }\n              }\n            }\n          }\n\n          function signatureFor(\n            record: FunctionRecord,\n            stack: string[],\n          ): SignatureResult {\n            const hookNames: string[] = [];\n            let forceReset = false;\n\n            record.fnPath.traverse({\n              CallExpression(call) {\n                if (call.getFunctionParent()?.node !== record.fnPath.node) {\n                  return;\n                }\n\n                const callee = call.node.callee;\n                const hookName = hookCallName(callee);\n                if (hookName === null) {\n                  return;\n                }\n\n                hookNames.push(hookName);\n                const hookRecord = functions.get(hookName);\n                if (hookRecord?.isCustomHook !== true) {\n                  if (!isBuiltinFigHookName(hookName)) forceReset = true;\n                  return;\n                }\n\n                if (stack.includes(hookName)) {\n                  forceReset = true;\n                  return;\n                }\n\n                const nested = signatureFor(hookRecord, [...stack, hookName]);\n                forceReset = forceReset || nested.forceReset;\n                if (nested.signature !== \"\") {\n                  hookNames.push(\n                    ...nested.signature.split(\"\\n\").map((line) => `>${line}`),\n                  );\n                }\n              },\n            });\n\n            return { forceReset, signature: hookNames.join(\"\\n\") };\n          }\n\n          function hookCallName(\n            callee:\n              | babel.types.Expression\n              | babel.types.Import\n              | babel.types.Super\n              | babel.types.V8IntrinsicIdentifier,\n          ): string | null {\n            if (t.isIdentifier(callee)) {\n              return isCustomHookName(callee.name) ? callee.name : null;\n            }\n            if (\n              t.isMemberExpression(callee) &&\n              !callee.computed &&\n              t.isIdentifier(callee.property) &&\n              isCustomHookName(callee.property.name)\n            ) {\n              return callee.property.name;\n            }\n            return null;\n          }\n\n          function exportsOnlyComponents(\n            program: NodePath<babel.types.Program>,\n            records: Map<string, FunctionRecord>,\n          ): boolean {\n            for (const statement of program.get(\"body\")) {\n              if (statement.isExportNamedDeclaration()) {\n                if (statement.node.exportKind === \"type\") continue;\n                const declaration = statement.get(\"declaration\");\n                if (!Array.isArray(declaration) && declaration.node != null) {\n                  if (\n                    !declarationExportsOnlyComponents(declaration.node, records)\n                  ) {\n                    return false;\n                  }\n                  continue;\n                }\n\n                if (statement.node.source != null) {\n                  for (const specifier of statement.node.specifiers) {\n                    if (\n                      \"exportKind\" in specifier &&\n                      specifier.exportKind === \"type\"\n                    ) {\n                      continue;\n                    }\n                    return false;\n                  }\n                  continue;\n                }\n\n                for (const specifier of statement.get(\"specifiers\")) {\n                  if (\n                    specifier.isExportSpecifier() &&\n                    specifier.node.exportKind === \"type\"\n                  ) {\n                    continue;\n                  }\n                  if (!specifier.isExportSpecifier()) return false;\n                  const local = specifier.node.local;\n                  if (!t.isIdentifier(local)) return false;\n                  if (records.get(local.name)?.isComponent !== true) {\n                    return false;\n                  }\n                }\n                continue;\n              }\n\n              if (statement.isExportDefaultDeclaration()) {\n                const declaration = statement.get(\"declaration\");\n                if (Array.isArray(declaration)) return false;\n                if (declaration.isFunctionDeclaration()) {\n                  const id = declaration.node.id;\n                  if (id == null || !isComponentName(id.name)) return false;\n                  continue;\n                }\n                if (\n                  declaration.isIdentifier() &&\n                  records.get(declaration.node.name)?.isComponent === true\n                ) {\n                  continue;\n                }\n                return false;\n              }\n\n              if (statement.isExportAllDeclaration()) return false;\n            }\n\n            return true;\n          }\n\n          function declarationExportsOnlyComponents(\n            declaration: babel.types.Declaration,\n            records: Map<string, FunctionRecord>,\n          ): boolean {\n            if (t.isFunctionDeclaration(declaration)) {\n              const id = declaration.id;\n              return id != null && records.get(id.name)?.isComponent === true;\n            }\n\n            if (!t.isVariableDeclaration(declaration)) return false;\n\n            for (const declarator of declaration.declarations) {\n              if (!t.isIdentifier(declarator.id)) return false;\n              if (records.get(declarator.id.name)?.isComponent !== true) {\n                return false;\n              }\n            }\n            return true;\n          }\n        },\n      },\n    },\n  };\n}\n\nfunction isComponentName(name: string): boolean {\n  const first = name[0];\n  return first !== undefined && first >= \"A\" && first <= \"Z\";\n}\n\nfunction isCustomHookName(name: string): boolean {\n  return /^use[A-Z]/.test(name);\n}\n\nfunction isBuiltinFigHookName(name: string): boolean {\n  return (\n    name === \"useActionState\" ||\n    name === \"useBeforeLayout\" ||\n    name === \"useBeforePaint\" ||\n    name === \"useCallback\" ||\n    name === \"useSyncExternalStore\" ||\n    name === \"useId\" ||\n    name === \"useDeferredValue\" ||\n    name === \"useMemo\" ||\n    name === \"useReactive\" ||\n    name === \"useStableEvent\" ||\n    name === \"useState\" ||\n    name === \"useTransition\"\n  );\n}\n\n// Transform a single module. Returns null when it has no components (so the\n// caller leaves it for the regular pipeline).\nexport async function transformModule(\n  code: string,\n  id: string,\n): Promise<TransformResult | null> {\n  const result = await babel.transformAsync(code, {\n    babelrc: false,\n    configFile: false,\n    filename: id,\n    sourceMaps: true,\n    presets: [\n      [\n        presetTypescript,\n        {\n          ignoreExtensions: true,\n          onlyRemoveTypeImports: true,\n        },\n      ],\n    ],\n    parserOpts: { plugins: id.endsWith(\"x\") ? [\"jsx\"] : [] },\n    plugins: [[figRefreshBabelPlugin, { moduleId: id }]],\n  });\n\n  if (result?.code == null || !result.code.includes(\"virtual:fig-refresh\")) {\n    return null;\n  }\n  return { code: result.code, map: result.map };\n}\n","import { fileURLToPath } from \"node:url\";\nimport { transformModule } from \"./transform.ts\";\n\nconst VIRTUAL_ID = \"virtual:fig-refresh\";\nconst RESOLVED_VIRTUAL_ID = \"\\0virtual:fig-refresh\";\nconst REFRESH_RUNTIME_IMPORT = viteFileImport(\n  import.meta.resolve(\"@bgub/fig-refresh\"),\n);\n// A bare specifier so the app's resolve config (aliases, dedupe, prebundling)\n// applies; a file path would load a second copy of the scheduler state next to\n// the one `@bgub/fig-dom` wires up internally.\nconst DOM_REFRESH_IMPORT = \"@bgub/fig-dom/refresh\";\n\nexport interface FigRefreshOptions {\n  // Files to consider for the refresh transform. Defaults to JS/TS(X).\n  include?: RegExp;\n}\n\n// Minimal structural shape of a Vite plugin (avoids a hard dep on vite types).\nexport interface FigRefreshPlugin {\n  apply: \"serve\";\n  enforce: \"pre\";\n  load(id: string): string | null;\n  name: string;\n  resolveId(id: string): string | null;\n  transform(\n    code: string,\n    id: string,\n    options?: { ssr?: boolean },\n  ): Promise<{ code: string; map: unknown } | null>;\n}\n\nexport function figRefresh(options: FigRefreshOptions = {}): FigRefreshPlugin {\n  const include = options.include ?? /\\.[jt]sx?$/;\n\n  return {\n    apply: \"serve\",\n    enforce: \"pre\",\n    name: \"fig:refresh\",\n    resolveId(id) {\n      return id === VIRTUAL_ID ? RESOLVED_VIRTUAL_ID : null;\n    },\n    load(id) {\n      return id === RESOLVED_VIRTUAL_ID ? virtualModuleCode() : null;\n    },\n    async transform(code, id, transformOptions) {\n      if (transformOptions?.ssr === true) return null;\n\n      const clean = id.split(\"?\")[0] ?? id;\n      if (clean.includes(\"/node_modules/\") || !include.test(clean)) return null;\n      return transformModule(code, clean);\n    },\n  };\n}\n\n// The virtual runtime module: wires the renderer to the refresh runtime once,\n// and exposes register/setSignature plus a microtask-batched refresh trigger.\nfunction virtualModuleCode(): string {\n  return `import { injectScheduleRefresh, performRefresh, register, setSignature } from ${JSON.stringify(\n    REFRESH_RUNTIME_IMPORT,\n  )};\nimport { scheduleRefresh } from ${JSON.stringify(DOM_REFRESH_IMPORT)};\n\ninjectScheduleRefresh(scheduleRefresh);\n\nlet queued = false;\nexport function enqueueRefresh() {\n  if (queued) return;\n  queued = true;\n  queueMicrotask(() => {\n    queued = false;\n    performRefresh();\n  });\n}\n\nexport { register, setSignature };\n`;\n}\n\nfunction viteFileImport(url: string): string {\n  return `/@fs/${fileURLToPath(url)}`;\n}\n"],"mappings":"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"}

package/package.json

@@ -1,5 +1,53 @@
 {
   "name": "@bgub/fig-vite",
-  "version": "0.0.0-tegami-trusted-publish-setup",
-  "description": "Placeholder published by Tegami for npm trusted publishing setup."
-}
+  "version": "0.1.0-alpha.2",
+  "description": "Fig Vite plugin for state-preserving Fast Refresh",
+  "keywords": [],
+  "homepage": "https://github.com/bgub/fig",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "types": "./dist/index.d.ts",
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "CHANGELOG.md",
+    "LICENSE",
+    "README.md"
+  ],
+  "author": "Ben Gubler <nebrelbug@gmail.com>",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/bgub/fig",
+    "directory": "packages/fig-vite"
+  },
+  "bugs": {
+    "url": "https://github.com/bgub/fig/issues"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@babel/core": "^8.0.1",
+    "@babel/preset-typescript": "^8.0.1",
+    "@bgub/fig-dom": "0.1.0-alpha.2",
+    "@bgub/fig-refresh": "0.1.0-alpha.2"
+  },
+  "devDependencies": {
+    "@types/node": "^20.19.0"
+  },
+  "engines": {
+    "node": "^20.19.0 || >=22.12.0"
+  },
+  "scripts": {
+    "build": "tsdown --config ../../tsdown.config.ts && node ../../scripts/strip-declaration-map-comments.mjs dist",
+    "test": "vitest run --config ../../vite.config.ts src"
+  }
+}