@arkstack/view 0.15.4 → 0.16.0

package/dist/index.d.ts

@@ -257,9 +257,23 @@ interface ViteTagOptions {
  */
 declare const viteTags: (entries: string | string[], options?: ViteTagOptions) => string;
 /**
- * Register the `@vite(...)` tag (and its backing global) on a view factory so
- * templates can emit Vite asset tags: `@vite('resources/js/app.ts')` or
- * `@vite(['resources/css/app.css', 'resources/js/app.ts'])`.
+ * Resolve the React Refresh preamble for `@vitejs/plugin-react`.
+ *
+ * When Vite serves the HTML itself it injects this preamble automatically; here
+ * the page is rendered by Edge and the dev tags are emitted manually, so the
+ * preamble must be added by hand — otherwise React throws "can't detect
+ * preamble". It must precede the `@vite(...)` tags. Emits nothing in production.
+ *
+ * @param options
+ * @returns
+ */
+declare const viteReactRefresh: (options?: ViteTagOptions) => string;
+/**
+ * Register the `@vite(...)` and `@viteReactRefresh` tags (and their backing
+ * globals) on a view factory so templates can emit Vite asset tags:
+ * `@vite('resources/js/app.ts')` or `@vite(['resources/css/app.css',
+ * 'resources/js/app.ts'])`, and the React Refresh preamble via
+ * `@viteReactRefresh` (placed before `@vite`).
  *
  * @param factory
  */
@@ -272,4 +286,4 @@ declare const runWithViewData: <T>(data: ViewData, callback: () => T | Promise<T
 declare const clearViewData: () => void;
 declare const collectViewData: (context: Record<string, any>) => ViewData;
 //#endregion
-export { type ComposerRunner, Edge, type SyncComposerRunner, View, type ViewComposer, type ViewComposerClass, type ViewComposerHandler, type ViewComposerName, type ViewComposerObject, type ViewData, ViewErrorBag, type ViewErrorRecord, type ViewErrorValue, ViewFactory, type ViewFactoryOptions, ViewInstance, type ViewName, type ViteTagOptions, clearRouterViewPlugin, clearViewData, collectViewData, edge, enterViewData, getViewData, normalizeViewErrors, parsePackageViewName, registerViteTag, resolvePackageViewsPath, runWithViewData, view, viteTags };
+export { type ComposerRunner, Edge, type SyncComposerRunner, View, type ViewComposer, type ViewComposerClass, type ViewComposerHandler, type ViewComposerName, type ViewComposerObject, type ViewData, ViewErrorBag, type ViewErrorRecord, type ViewErrorValue, ViewFactory, type ViewFactoryOptions, ViewInstance, type ViewName, type ViteTagOptions, clearRouterViewPlugin, clearViewData, collectViewData, edge, enterViewData, getViewData, normalizeViewErrors, parsePackageViewName, registerViteTag, resolvePackageViewsPath, runWithViewData, view, viteReactRefresh, viteTags };

package/dist/index.js

@@ -1,3 +1,3 @@
-import { a as viteTags, c as enterViewData, d as ViewInstance, f as parsePackageViewName, g as normalizeViewErrors, h as ViewErrorBag, i as registerViteTag, l as getViewData, m as view, n as View, o as clearViewData, p as resolvePackageViewsPath, r as ViewFactory, s as collectViewData, t as clearRouterViewPlugin, u as runWithViewData } from "./plugins-DWO_aTcP.js";
+import { _ as normalizeViewErrors, a as viteReactRefresh, c as collectViewData, d as runWithViewData, f as ViewInstance, g as ViewErrorBag, h as view, i as registerViteTag, l as enterViewData, m as resolvePackageViewsPath, n as View, o as viteTags, p as parsePackageViewName, r as ViewFactory, s as clearViewData, t as clearRouterViewPlugin, u as getViewData } from "./plugins-DCq-Gl05.js";
 import edge, { Edge } from "edge.js";
-export { Edge, View, ViewErrorBag, ViewFactory, ViewInstance, clearRouterViewPlugin, clearViewData, collectViewData, edge, enterViewData, getViewData, normalizeViewErrors, parsePackageViewName, registerViteTag, resolvePackageViewsPath, runWithViewData, view, viteTags };
+export { Edge, View, ViewErrorBag, ViewFactory, ViewInstance, clearRouterViewPlugin, clearViewData, collectViewData, edge, enterViewData, getViewData, normalizeViewErrors, parsePackageViewName, registerViteTag, resolvePackageViewsPath, runWithViewData, view, viteReactRefresh, viteTags };

package/dist/{plugins-DWO_aTcP.js → plugins-DCq-Gl05.js}

@@ -351,19 +351,49 @@ const viteTags = (entries, options = {}) => {
 	return productionTags(list, options.manifest ?? join(Arkstack.rootDir(), "public", "build", ".vite", "manifest.json"), options.buildDir ?? "/build/");
 };
 /**
-* Register the `@vite(...)` tag (and its backing global) on a view factory so
-* templates can emit Vite asset tags: `@vite('resources/js/app.ts')` or
-* `@vite(['resources/css/app.css', 'resources/js/app.ts'])`.
-* 
-* @param factory 
+* Resolve the React Refresh preamble for `@vitejs/plugin-react`.
+*
+* When Vite serves the HTML itself it injects this preamble automatically; here
+* the page is rendered by Edge and the dev tags are emitted manually, so the
+* preamble must be added by hand — otherwise React throws "can't detect
+* preamble". It must precede the `@vite(...)` tags. Emits nothing in production.
+*
+* @param options
+* @returns
+*/
+const viteReactRefresh = (options = {}) => {
+	if (!(options.hot ?? nodeEnv() !== "prod")) return "";
+	return [
+		"<script type=\"module\">",
+		`import RefreshRuntime from '${trimTrailingSlash(options.devUrl ?? env("VITE_DEV_URL", "http://localhost:5173"))}/@react-refresh'`,
+		"RefreshRuntime.injectIntoGlobalHook(window)",
+		"window.$RefreshReg$ = () => {}",
+		"window.$RefreshSig$ = () => (type) => type",
+		"window.__vite_plugin_react_preamble_installed__ = true",
+		"<\/script>"
+	].join("\n");
+};
+/**
+* Register the `@vite(...)` and `@viteReactRefresh` tags (and their backing
+* globals) on a view factory so templates can emit Vite asset tags:
+* `@vite('resources/js/app.ts')` or `@vite(['resources/css/app.css',
+* 'resources/js/app.ts'])`, and the React Refresh preamble via
+* `@viteReactRefresh` (placed before `@vite`).
+*
+* @param factory
 */
 const registerViteTag = (factory) => {
 	factory.edge.global("__arkViteTags", (entries, options) => viteTags(entries, options));
+	factory.edge.global("__arkViteReactRefresh", (options) => viteReactRefresh(options));
 	factory.tag("vite", false, true, (parser, buffer, token) => {
 		const expression = `__arkViteTags(${token.properties.jsArg})`;
 		const ast = parser.utils.transformAst(parser.utils.generateAST(expression, token.loc, token.filename), token.filename, parser);
 		buffer.outputExpression(parser.utils.stringify(ast), token.filename, token.loc.start.line, false);
 	});
+	factory.tag("viteReactRefresh", false, false, (parser, buffer, token) => {
+		const ast = parser.utils.transformAst(parser.utils.generateAST("__arkViteReactRefresh()", token.loc, token.filename), token.filename, parser);
+		buffer.outputExpression(parser.utils.stringify(ast), token.filename, token.loc.start.line, false);
+	});
 };
 //#endregion
 //#region src/ViewFactory.ts
@@ -588,4 +618,4 @@ const clearRouterViewPlugin = definePlugin({
 	}
 });
 //#endregion
-export { viteTags as a, enterViewData as c, ViewInstance as d, parsePackageViewName as f, normalizeViewErrors as g, ViewErrorBag as h, registerViteTag as i, getViewData as l, view as m, View as n, clearViewData as o, resolvePackageViewsPath as p, ViewFactory as r, collectViewData as s, clearRouterViewPlugin as t, runWithViewData as u };
+export { normalizeViewErrors as _, viteReactRefresh as a, collectViewData as c, runWithViewData as d, ViewInstance as f, ViewErrorBag as g, view as h, registerViteTag as i, enterViewData as l, resolvePackageViewsPath as m, View as n, viteTags as o, parsePackageViewName as p, ViewFactory as r, clearViewData as s, clearRouterViewPlugin as t, getViewData as u };

package/dist/setup.js

@@ -1,4 +1,4 @@
-import { t as clearRouterViewPlugin } from "./plugins-DWO_aTcP.js";
+import { t as clearRouterViewPlugin } from "./plugins-DCq-Gl05.js";
 import { CoreRouter } from "clear-router/core";
 //#region src/setup.ts
 CoreRouter.use(clearRouterViewPlugin);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arkstack/view",
-  "version": "0.15.4",
+  "version": "0.16.0",
   "type": "module",
   "description": "View module for Arkstack, providing template rendering and view integration utilities.",
   "homepage": "https://arkstack.toneflix.net/guide/views",
@@ -33,13 +33,13 @@
   ],
   "dependencies": {
     "edge.js": "^6.5.0",
-    "@arkstack/contract": "^0.15.4"
+    "@arkstack/contract": "^0.16.0"
   },
   "peerDependencies": {
     "@h3ravel/musket": "^2.2.1",
     "clear-router": "^2.9.0",
-    "@arkstack/common": "^0.15.4",
-    "@arkstack/foundry": "^0.15.4"
+    "@arkstack/common": "^0.16.0",
+    "@arkstack/foundry": "^0.16.0"
   },
   "peerDependenciesMeta": {
     "@h3ravel/musket": {