@declarion/react 0.32.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/document-templates.d.ts

@@ -0,0 +1,12 @@
+import type { Schema } from "../types/schema";
+/**
+ * Heuristic used by DocumentsMenu mount sites to decide whether the caller
+ * can manage TENANT document templates: the `document_template` entity is
+ * present in the projected schema (schema.entities is already RBAC-pruned -
+ * `document_template` appears only when the caller can read it). Gates the
+ * lazy `document.templates.available` tenant-template visibility probe
+ * (Business Case 6, plan 2026-07-08-document-generation-hardening) so a
+ * caller who cannot manage templates never fires it - the Haia default.
+ * One shared predicate so SmartDetailPage and SmartListPage agree.
+ */
+export declare function canManageDocumentTemplates(schema: Schema | undefined): boolean;

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

@@ -0,0 +1,20 @@
+export declare class DownloadError extends Error {
+    readonly code?: string | undefined;
+    constructor(message: string, code?: string | undefined);
+}
+/** True when `err` is the download failing because the underlying blob is
+ *  gone (purged, superseded, never generated). Callers use this to disable a
+ *  dead Download button instead of leaving it re-clickable against nothing. */
+export declare function isMissingArtifactError(err: unknown): boolean;
+/**
+ * Fetches `url` as an authenticated (same-origin cookie) request, then
+ * triggers a browser download of the resulting blob. Refuses any URL whose
+ * scheme is not in the safeExternalUrl allowlist (http/https/mailto/relative)
+ * BEFORE issuing the fetch - a `javascript:`/`data:` URL never reaches
+ * `fetch` or an anchor's `href`.
+ *
+ * Blob-fetch (not a bare `<a href>`) so a non-2xx response (404 FILE_NOT_FOUND,
+ * 403, etc.) surfaces as a thrown DownloadError instead of silently
+ * navigating the browser to an error page.
+ */
+export declare function downloadFile(url: string, filename?: string): Promise<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/record-documents-key.d.ts

@@ -0,0 +1 @@
+export declare const RECORD_DOCUMENTS_KEY: "record-documents";

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).