@levo-so/site-runtime 0.3.0 → 0.3.1

package/index.d.ts

@@ -297,6 +297,12 @@ export declare interface ILevoPopupsProps {
      * workspace-wide active popups are returned.
      */
     siteId?: string;
+    /**
+     * The current page's platform id, read from the head by `LevoSiteProvider` (see
+     * `../pageId`). Feeds page-bound targeting rules ("show on the pricing page", "show on
+     * all blog posts"). Absent → those rules never match; URL-path rules still do.
+     */
+    pageId?: string;
 }
 
 /** A single-record binding — one collection record / blog post / event by `slug` (a detail page). */
@@ -437,6 +443,13 @@ export declare interface IPatchedHistoryFn {
 
 /** The full `meta/<route>.json` shape: page identity (platform-owned) + the SEO object. */
 export declare interface IPlatformMetaFile {
+    /**
+     * The platform's page id. Stamped by the platform (never by the AI) and used for
+     * analytics `page_id` + popup page-bound targeting — see `./pageId`. Ships empty on
+     * sites provisioned before the platform started stamping it; empty = simply absent,
+     * every consumer degrades to URL-based behavior.
+     */
+    id?: string;
     title?: string;
     description?: string;
     meta?: IPlatformPageMeta;
@@ -741,9 +754,10 @@ export declare const LevoForm: React.FC<ILevoFormProps>;
  * everything else: it fetches active popups, evaluates page/referrer targeting against the
  * current URL, lazy-loads the renderer only when popups exist, and self-hides otherwise.
  *
- * No `pageId` is threaded: that is a studio DB page id with no equivalent in a code-routed
- * site, so page-bound rules don't apply here — site-wide and URL-path targeting (the
- * `is_all_pages` / `contains` / `begins_with` matchers) do.
+ * `pageId` comes from the matched route's `meta/<route>.json` (the provider reads it off the
+ * head — see `../pageId`), which is what makes page-bound rules work on a code-routed site.
+ * Sites whose meta files carry no id still get site-wide and URL-path targeting (the
+ * `is_all_pages` / `contains` / `begins_with` matchers).
  */
 export declare const LevoPopups: React.FC<ILevoPopupsProps>;
 
@@ -764,6 +778,9 @@ export declare const LevoSiteProvider: React.FC<{
     children: React.ReactNode;
 }>;
 
+/** `name` of the head tag carrying the page id. Written by `levoHead`, read by `readPageId`. */
+export declare const PAGE_ID_META = "levo:page-id";
+
 /**
  * Renders a page's metadata as document tags. Pages include it anywhere in their JSX —
  * React 19 hoists <title>/<meta>/<link> into <head> (SSR too); scripts render in place
@@ -818,6 +835,13 @@ export declare const prefetchLevoSources: ({ queryClient, config, sources, param
     params?: Record<string, string>;
 }) => Promise<Record<string, unknown>>;
 
+/**
+ * The id the currently matched route stamped into the head, or null when the site's
+ * platform hasn't stamped ids into its meta files yet (the field ships empty). Client-only —
+ * returns null during SSR, so callers must read it in an effect.
+ */
+export declare const readPageId: () => string | null;
+
 /** What `system` resolves to — the class actually on `<html>`. */
 export declare type ResolvedColorMode = "dark" | "light";