@reforma/site 1.0.0 → 1.0.2

package/dist/analytics.d.ts

@@ -12,6 +12,7 @@ type TrackOptions = {
 /**
  * Start first-party pageview collection for a published Reforma site.
  * Reads the project site config. Only the first call installs history hooks.
+ * In the Reforma editor's canvas it reports the address to the editor and counts nothing.
  */
 export declare function initAnalytics(config: {
     analyticsEnabled: boolean;

package/dist/analytics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"analytics.d.ts","sourceRoot":"","sources":["../src/analytics.ts"],"names":[],"mappings":"AAAA,KAAK,gBAAgB,GAAG;IACpB,wDAAwD;IACxD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,kDAAkD;IAClD,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAChC,CAAC;AAEF,KAAK,YAAY,GAAG;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC,CAAC;AASF;;;GAGG;AACH,wBAAgB,aAAa,CACzB,MAAM,EAAE;IAAE,gBAAgB,EAAE,OAAO,CAAC;IAAC,iBAAiB,EAAE,MAAM,CAAC;IAAC,iBAAiB,EAAE,MAAM,CAAA;CAAE,EAC3F,OAAO,GAAE,gBAAqB,GAC/B,IAAI,CAqCN;AAED;;;GAGG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,GAAG,IAAI,CA6DpE"}
+{"version":3,"file":"analytics.d.ts","sourceRoot":"","sources":["../src/analytics.ts"],"names":[],"mappings":"AAAA,KAAK,gBAAgB,GAAG;IACpB,wDAAwD;IACxD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,kDAAkD;IAClD,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAChC,CAAC;AAEF,KAAK,YAAY,GAAG;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC,CAAC;AAcF;;;;GAIG;AACH,wBAAgB,aAAa,CACzB,MAAM,EAAE;IAAE,gBAAgB,EAAE,OAAO,CAAC;IAAC,iBAAiB,EAAE,MAAM,CAAC;IAAC,iBAAiB,EAAE,MAAM,CAAA;CAAE,EAC3F,OAAO,GAAE,gBAAqB,GAC/B,IAAI,CAoDN;AAED;;;GAGG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,GAAG,IAAI,CA6DpE"}

package/dist/analytics.js

@@ -1,3 +1,7 @@
+/** The Reforma editor names its canvas iframe this; the site checks it because it cannot see the parent's origin. */
+const EDITOR_FRAME_NAME = 'reforma-editor';
+/** What the editor listens for to follow the site's address. */
+const LOCATION_MESSAGE = 'reforma:location';
 let started = false;
 let enabled = false;
 let writeKey = '';
@@ -7,6 +11,7 @@ let unhook = null;
 /**
  * Start first-party pageview collection for a published Reforma site.
  * Reads the project site config. Only the first call installs history hooks.
+ * In the Reforma editor's canvas it reports the address to the editor and counts nothing.
  */
 export function initAnalytics(config, options = {}) {
     if (typeof window === 'undefined') {
@@ -22,6 +27,16 @@ export function initAnalytics(config, options = {}) {
         return;
     }
     started = true;
+    if (window.name === EDITOR_FRAME_NAME && window.parent !== window) {
+        enabled = false;
+        const report = () => {
+            // nosemgrep: javascript.browser.security.wildcard-postmessage-configuration.wildcard-postmessage-configuration -- only the page path, and the site cannot know the editor's origin
+            window.parent.postMessage({ type: LOCATION_MESSAGE, pathname: window.location.pathname }, '*');
+        };
+        report();
+        unhook = installHistoryHook(report);
+        return;
+    }
     enabled = config.analyticsEnabled;
     writeKey = config.analyticsWriteKey.trim();
     endpoint = config.analyticsEndpoint.trim();

package/dist/index.d.ts

@@ -1,5 +1,8 @@
 export { initAnalytics, track } from './analytics.js';
 export { ErrorState } from './error-state.js';
 export { projectMetadata, projectRobots } from './metadata.js';
+export { SiteRoot } from './root.js';
+export { useTheme as useMode, useTheme } from 'next-themes';
 export type { FixErrorDetail } from './error-state.js';
+export type { ModeDocument } from './root.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC/D,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAErC,OAAO,EAAE,QAAQ,IAAI,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5D,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,YAAY,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC"}

package/dist/index.js

@@ -1,3 +1,6 @@
 export { initAnalytics, track } from './analytics.js';
 export { ErrorState } from './error-state.js';
 export { projectMetadata, projectRobots } from './metadata.js';
+export { SiteRoot } from './root.js';
+// `useMode` is the pre-1.0 name, kept for older starters' sonner.tsx.
+export { useTheme as useMode, useTheme } from 'next-themes';

package/dist/root.d.ts

@@ -0,0 +1,15 @@
+import { type ReactNode } from 'react';
+/** The project's generated `.reforma/tokens/.generated/modes.json`. */
+export type ModeDocument = {
+    default: string;
+    modifiers: {
+        name: string;
+        contexts: string[];
+    }[];
+};
+/** Mounts next-themes on `data-theme` with the token modes, which the generated token CSS selects. */
+export declare function SiteRoot({ children, modes }: {
+    children: ReactNode;
+    modes: ModeDocument;
+}): import("react").JSX.Element;
+//# sourceMappingURL=root.d.ts.map

package/dist/root.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"root.d.ts","sourceRoot":"","sources":["../src/root.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAsB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAE3D,uEAAuE;AACvE,MAAM,MAAM,YAAY,GAAG;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE,EAAE,CAAC;CACrD,CAAC;AAeF,sGAAsG;AACtG,wBAAgB,QAAQ,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE;IAAE,QAAQ,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,YAAY,CAAA;CAAE,+BAYzF"}

package/dist/root.js

@@ -0,0 +1,19 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { ThemeProvider, useTheme } from 'next-themes';
+import { useEffect, useMemo } from 'react';
+/** next-themes keeps a stored theme the tokens no longer have (renamed or deleted); fall back to the default mode. */
+function DropRemovedTheme({ themes, defaultTheme }) {
+    const { theme, setTheme } = useTheme();
+    useEffect(() => {
+        if (theme && theme !== 'system' && !themes.includes(theme)) {
+            setTheme(defaultTheme);
+        }
+    }, [theme, setTheme, themes, defaultTheme]);
+    return null;
+}
+/** Mounts next-themes on `data-theme` with the token modes, which the generated token CSS selects. */
+export function SiteRoot({ children, modes }) {
+    const themes = useMemo(() => modes.modifiers.find(modifier => modifier.name === 'mode')?.contexts ?? [], [modes]);
+    return (_jsxs(ThemeProvider, { attribute: "data-theme", themes: themes, defaultTheme: modes.default, disableTransitionOnChange: true, children: [_jsx(DropRemovedTheme, { themes: themes, defaultTheme: modes.default }), children] }));
+}

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@reforma/site",
-    "version": "1.0.0",
-    "description": "Visitor runtime for a Reforma site: publish metadata, analytics, and the PostCSS url guard.",
+    "version": "1.0.2",
+    "description": "Visitor runtime for a Reforma site: theme modes, publish metadata, analytics, and the PostCSS url guard.",
     "type": "module",
     "license": "UNLICENSED",
     "author": "Reforma, Inc. <dev@reforma.ai>",
@@ -41,6 +41,9 @@
         "lint": "eslint src",
         "lint:fix": "eslint src --fix"
     },
+    "dependencies": {
+        "next-themes": "^0.4.6"
+    },
     "peerDependencies": {
         "react": "^19.2.8",
         "react-dom": "^19.2.8"