@reforma/site 0.0.1 → 0.0.3

package/dist/analytics.d.ts

@@ -0,0 +1,20 @@
+type AnalyticsOptions = {
+    /** Test-only: allow re-init and clear history hooks. */
+    reset?: boolean;
+    /** Default false — skip localhost / 127.0.0.1. */
+    captureOnLocalhost?: boolean;
+};
+type TrackProps = {
+    url?: string;
+    referrer?: string;
+};
+/**
+ * Start first-party pageview collection for a published Reforma site.
+ * Reads `NEXT_PUBLIC_REFORMA_ANALYTICS*` env baked on publish. Safe to call
+ * multiple times — only the first call installs history hooks.
+ */
+export declare function initAnalytics(options?: AnalyticsOptions): void;
+/** Send a named event. Today only `pageview` is stored by the API. */
+export declare function track(name: string, props?: TrackProps): void;
+export {};
+//# sourceMappingURL=analytics.d.ts.map

package/dist/analytics.d.ts.map

@@ -0,0 +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,UAAU,GAAG;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AASF;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE,gBAAqB,GAAG,IAAI,CAqClE;AAED,sEAAsE;AACtE,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,UAAe,GAAG,IAAI,CA6ChE"}

package/dist/analytics.js

@@ -0,0 +1,118 @@
+let started = false;
+let enabled = false;
+let writeKey = '';
+let endpoint = '';
+let lastPath = '';
+let unhook = null;
+/**
+ * Start first-party pageview collection for a published Reforma site.
+ * Reads `NEXT_PUBLIC_REFORMA_ANALYTICS*` env baked on publish. Safe to call
+ * multiple times — only the first call installs history hooks.
+ */
+export function initAnalytics(options = {}) {
+    if (typeof window === 'undefined') {
+        return;
+    }
+    if (options.reset) {
+        unhook?.();
+        unhook = null;
+        started = false;
+        lastPath = '';
+    }
+    if (started) {
+        return;
+    }
+    started = true;
+    enabled = process.env.NEXT_PUBLIC_REFORMA_ANALYTICS === '1';
+    writeKey = process.env.NEXT_PUBLIC_REFORMA_ANALYTICS_KEY?.trim() ?? '';
+    endpoint = process.env.NEXT_PUBLIC_REFORMA_ANALYTICS_ENDPOINT?.trim() ?? '';
+    if (!enabled || !writeKey || !endpoint) {
+        enabled = false;
+        return;
+    }
+    if (!options.captureOnLocalhost && isLocalHost(window.location.hostname)) {
+        enabled = false;
+        return;
+    }
+    track('pageview');
+    unhook = installHistoryHook(() => {
+        track('pageview');
+    });
+}
+/** Send a named event. Today only `pageview` is stored by the API. */
+export function track(name, props = {}) {
+    if (!enabled || name !== 'pageview' || typeof window === 'undefined') {
+        return;
+    }
+    const url = props.url ?? window.location.href;
+    const path = pathOf(url);
+    if (path === lastPath) {
+        return;
+    }
+    lastPath = path;
+    const payload = JSON.stringify({
+        key: writeKey,
+        url,
+        referrer: props.referrer ?? (document.referrer || undefined),
+    });
+    const body = typeof Blob === 'undefined'
+        ? payload
+        : new Blob([payload], { type: 'application/json' });
+    try {
+        if (typeof navigator !== 'undefined' && typeof navigator.sendBeacon === 'function') {
+            const ok = navigator.sendBeacon(endpoint, body);
+            if (ok) {
+                return;
+            }
+        }
+        void fetch(endpoint, {
+            method: 'POST',
+            body: payload,
+            headers: { 'Content-Type': 'application/json' },
+            keepalive: true,
+            mode: 'cors',
+            credentials: 'omit',
+        }).catch(() => {
+            // Fire-and-forget — never break the host site.
+        });
+    }
+    catch {
+        // Ignore beacon failures.
+    }
+}
+function installHistoryHook(onNavigate) {
+    const { pushState, replaceState } = history;
+    const notify = () => {
+        queueMicrotask(onNavigate);
+    };
+    history.pushState = function (...args) {
+        const result = pushState.apply(this, args);
+        notify();
+        return result;
+    };
+    history.replaceState = function (...args) {
+        const result = replaceState.apply(this, args);
+        notify();
+        return result;
+    };
+    window.addEventListener('popstate', notify);
+    return () => {
+        history.pushState = pushState;
+        history.replaceState = replaceState;
+        window.removeEventListener('popstate', notify);
+    };
+}
+function isLocalHost(hostname) {
+    return hostname === 'localhost'
+        || hostname === '127.0.0.1'
+        || hostname === '[::1]'
+        || hostname.endsWith('.local');
+}
+function pathOf(url) {
+    try {
+        return new URL(url, window.location.origin).pathname;
+    }
+    catch {
+        return url;
+    }
+}

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+export { initAnalytics, track } from './analytics.js';
 export { projectMetadata, projectRobots } from './metadata.js';
 export { SiteRoot, useMode } from './root.js';
 export type { Appearance, ModeAppearances, ModeDocument, SystemModes } from './root.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC9C,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,WAAW,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,eAAe,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC9C,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC"}

package/dist/index.js

@@ -1,2 +1,3 @@
+export { initAnalytics, track } from './analytics.js';
 export { projectMetadata, projectRobots } from './metadata.js';
 export { SiteRoot, useMode } from './root.js';

package/dist/root.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"root.d.ts","sourceRoot":"","sources":["../src/root.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAgE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAErG,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,MAAM,CAAC;AAE1C,MAAM,MAAM,YAAY,GAAG;IACvB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,EAAE,CAAC;CACvD,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AAEzD,MAAM,MAAM,WAAW,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC;AAEjE,KAAK,SAAS,GAAG;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,UAAU,CAAC;CAC1B,CAAC;AAEF,KAAK,gBAAgB,GAAG,SAAS,GAAG;IAAE,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAA;CAAE,CAAC;AAe/E,8EAA8E;AAC9E,wBAAgB,OAAO,qBAEtB;AAMD,wBAAgB,QAAQ,CAAC,EACrB,QAAQ,EACR,KAAK,EACL,WAAgC,EAChC,WAAkB,GACrB,EAAE;IACC,QAAQ,EAAE,SAAS,CAAC;IACpB,KAAK,EAAE,YAAY,CAAC;IACpB,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,WAAW,CAAC,EAAE,WAAW,CAAC;CAC7B,+BAqGA"}
+{"version":3,"file":"root.d.ts","sourceRoot":"","sources":["../src/root.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAgE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAErG,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,MAAM,CAAC;AAE1C,MAAM,MAAM,YAAY,GAAG;IACvB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,EAAE,CAAC;CACvD,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AAEzD,MAAM,MAAM,WAAW,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC;AAEjE,KAAK,SAAS,GAAG;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,UAAU,CAAC;CAC1B,CAAC;AAEF,KAAK,gBAAgB,GAAG,SAAS,GAAG;IAAE,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAA;CAAE,CAAC;AAe/E,8EAA8E;AAC9E,wBAAgB,OAAO,qBAEtB;AAMD,wBAAgB,QAAQ,CAAC,EACrB,QAAQ,EACR,KAAK,EACL,WAAgC,EAChC,WAAkB,GACrB,EAAE;IACC,QAAQ,EAAE,SAAS,CAAC;IACpB,KAAK,EAAE,YAAY,CAAC;IACpB,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,WAAW,CAAC,EAAE,WAAW,CAAC;CAC7B,+BA6FA"}

package/dist/root.js

@@ -20,7 +20,7 @@ function modeNames(modes) {
 }
 export function SiteRoot({ children, modes, appearances = defaultAppearances, systemModes = null, }) {
     const defaultMode = modes.default ?? '';
-    const [state, setState] = useState({
+    const [modeState, setModeState] = useState({
         mode: defaultMode,
         siteMode: defaultMode,
         preview: null,
@@ -29,19 +29,11 @@ export function SiteRoot({ children, modes, appearances = defaultAppearances, sy
     });
     const latestState = useRef(null);
     const selectVisitorMode = useRef(null);
-    const modesRef = useRef(modes);
-    const appearancesRef = useRef(appearances);
-    const systemModesRef = useRef(systemModes);
-    modesRef.current = modes;
-    appearancesRef.current = appearances;
-    systemModesRef.current = systemModes;
     // Hydrate the server default first, then apply visitor preferences without masking mismatches.
     useLayoutEffect(() => {
         const storageKey = 'project-mode';
-        const names = modeNames(modesRef.current);
-        const defaultMode = modesRef.current.default ?? '';
-        const appearances = appearancesRef.current;
-        const systemModes = systemModesRef.current;
+        const names = modeNames(modes);
+        const defaultMode = modes.default ?? '';
         const valid = (mode) => mode !== null && names.includes(mode) ? mode : null;
         const media = systemModes ? window.matchMedia('(prefers-color-scheme: dark)') : null;
         let preference = latestState.current?.preference ?? null;
@@ -65,7 +57,7 @@ export function SiteRoot({ children, modes, appearances = defaultAppearances, sy
             document.documentElement.setAttribute('data-appearance', appearance);
             document.documentElement.style.colorScheme = appearance;
             latestState.current = next;
-            setState(next);
+            setModeState(next);
             window.dispatchEvent(new CustomEvent('project:mode-change', { detail: next }));
         };
         const onStorage = (event) => {
@@ -112,6 +104,6 @@ export function SiteRoot({ children, modes, appearances = defaultAppearances, sy
             media?.removeEventListener('change', publishMode);
             window.removeEventListener('reforma:token-mode', onPreview);
         };
-    }, []);
-    return (_jsx(ModeContext, { value: { ...state, setMode: mode => selectVisitorMode.current?.(mode) }, children: children }));
+    }, [appearances, modes, systemModes]);
+    return (_jsx(ModeContext, { value: { ...modeState, setMode: mode => selectVisitorMode.current?.(mode) }, children: children }));
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@reforma/site",
-    "version": "0.0.1",
+    "version": "0.0.3",
     "description": "Visitor runtime for a Reforma site: mode, publish metadata, and the PostCSS url guard.",
     "type": "module",
     "license": "UNLICENSED",