@declarion/react 0.34.0 → 0.35.1

package/dist-lib/lib/brand-tokens.d.ts

@@ -0,0 +1,43 @@
+import type { BrandingTheme } from "../types/api";
+/** The two color schemes, and the order their rules are emitted in. */
+export declare const COLOR_SCHEMES: readonly ["light", "dark"];
+export type BrandColorScheme = (typeof COLOR_SCHEMES)[number];
+/**
+ * The fourteen brandable color fields, in declaration order.
+ *
+ * Each writes the CSS custom property of the SAME name with underscores
+ * hyphenated. Keep in sync with `branding_theme_colors` in
+ * `modules/_platform/schema/core_branding.yaml`; a Go test exports that
+ * structure's fields and `brand-tokens.parity.test.ts` asserts the two agree in
+ * both directions, so a field added to one and forgotten in the other fails CI
+ * rather than loading, validating, and doing nothing.
+ */
+/**
+ * The typography fields, in declaration order. Scheme-independent: a title is
+ * the same size in light and dark, so these are emitted on `:root` alongside
+ * the fonts rather than inside a scheme block.
+ *
+ * Same naming contract as the colors: `page_title_size` writes
+ * `--page-title-size`.
+ */
+export declare const BRAND_TYPOGRAPHY_FIELDS: readonly ["page_title_size", "page_title_line_height"];
+export declare const BRAND_COLOR_FIELDS: readonly ["background", "surface", "surface_2", "surface_3", "text", "text_2", "text_3", "border", "divider", "accent", "accent_hover", "accent_foreground", "sidebar", "rail"];
+/** `surface_2` -> `--surface-2`. The whole naming contract, in one line. */
+export declare function cssPropertyFor(field: string): string;
+/**
+ * Render `branding.theme` as a stylesheet. Returns "" when the brand declares
+ * nothing, so the platform's own palette stands untouched.
+ */
+export declare function brandTokenCss(theme: BrandingTheme | undefined): string;
+export declare const BRAND_TOKENS_STYLE_ID = "declarion-brand-tokens";
+export declare const CONSUMER_BRAND_CSS_ID = "consumer-brand-css";
+/**
+ * Write the block into <head>, idempotently, ALWAYS before the consumer's
+ * stylesheet.
+ *
+ * The ordering is re-asserted on every call rather than assumed: branding is a
+ * runtime-resolved parameter, so this element and the consumer's <link> can be
+ * created in either order, and DOM order is what decides who wins between two
+ * rules of equal specificity.
+ */
+export declare function applyBrandTokens(css: string): void;

package/dist-lib/lib/html-state.d.ts

@@ -0,0 +1,11 @@
+/** The device class the SDK renders for. Mirrors ViewportCategory. */
+export type HtmlViewport = "phone" | "tablet" | "desktop";
+export declare function applyViewportAttribute(viewport: HtmlViewport): void;
+/**
+ * Mark the document as an embed. Written once at boot: `?embed=1` is a boot
+ * property of the document, not a value that changes while it lives.
+ *
+ * Always written, `"false"` included, so a consumer can select on either state
+ * without an `:not()` and without depending on the attribute's absence.
+ */
+export declare function applyEmbedAttribute(enabled: boolean): void;

package/dist-lib/lib/versionTracker.d.ts

@@ -55,6 +55,12 @@ export declare function observe(headers: Headers | undefined | null): void;
  * 304 with no body). On any change, emit a typed delta.
  */
 export declare function fetchProbe(): Promise<void>;
+/**
+ * The reload-requiring delta observed earlier, or null. useVersionWatcher
+ * re-shows the reload prompt from this on every tab focus: a dismissed
+ * prompt must not leave a long-lived tab silently stale.
+ */
+export declare function pendingReload(): VersionDelta | null;
 /**
  * Subscribe to drift events. Called once from useVersionWatcher; the
  * subscriber renders the UpdatePrompt (toast or silent invalidation).