@declarion/react 0.1.67 → 0.1.69

package/dist-lib/api/auth.d.ts

@@ -23,3 +23,4 @@ export interface ImpersonationStartResponse extends LoginResponse {
 export declare function impersonationStart(targetUserId: string, reason: string, durationMinutes?: number): Promise<ImpersonationStartResponse>;
 export declare function impersonationStop(): Promise<LoginResponse>;
 export declare function impersonationRevoke(sessionId: string): Promise<void>;
+export declare function changePassword(currentPassword: string, newPassword: string): Promise<void>;

package/dist-lib/api/client.d.ts

@@ -17,6 +17,23 @@ export declare function setPersistentAuthFailureHandler(h: PersistentAuthFailure
  *  reads this lazily so a setPersistentAuthFailureHandler() call from a test
  *  is observed by the SSE retry loop without re-importing the module. */
 export declare function getPersistentAuthFailureHandler(): PersistentAuthFailureHandler;
+export type ApiErrorReport = {
+    status: number;
+    code: string;
+    message: string;
+};
+type ApiErrorReporter = (report: ApiErrorReport) => void;
+/** Replace the reporter invoked for every non-2xx response. Returns the
+ *  previous reporter so callers can restore it. Tests should install a
+ *  spy or no-op via this hook instead of stubbing `console.error`. */
+export declare function setApiErrorReporter(r: ApiErrorReporter): ApiErrorReporter;
 export declare function apiFetch<T>(path: string, options?: RequestInit): Promise<T>;
+export interface BlobResponse {
+    blob: Blob;
+    filename: string;
+    headers: Headers;
+}
+export declare function apiFetchBlob(path: string, options?: RequestInit): Promise<BlobResponse>;
+export declare function parseContentDispositionFilename(headers: Headers): string;
 export declare function callHandler<R = unknown>(code: string, args?: unknown): Promise<R>;
 export {};

package/dist-lib/api/data.d.ts

@@ -1,11 +1,23 @@
 import type { ListParams, ListResponse, DataResponse } from "../types/api";
 import type { PkValues } from "../types/schema";
+import type { ExportRequest } from "../components/pages/exportRequest";
 export declare function listEntities(entity: string, params?: ListParams): Promise<ListResponse>;
 export declare function getEntity(entity: string, pkValues: PkValues | string): Promise<DataResponse>;
 export declare function createEntity(entity: string, data: Record<string, unknown>): Promise<DataResponse>;
 export declare function updateEntity(entity: string, pkValues: PkValues | string, data: Record<string, unknown>): Promise<DataResponse>;
 export declare function deleteEntity(entity: string, pkValues: PkValues | string): Promise<void>;
 export declare function restoreEntity(entity: string, pkValues: PkValues | string): Promise<void>;
+/** Result of POST /api/data/{entity}/export. The server streams a CSV
+ *  blob; the client gets the bytes plus the server-resolved filename
+ *  (parsed from Content-Disposition by apiFetchBlob, with RFC 5987
+ *  filename* preferred). Triggering the actual download (anchor click)
+ *  is the caller's job — separation lets ExportMenu show the bytes in a
+ *  toast when the browser blocks the download. */
+export interface ExportResponse {
+    blob: Blob;
+    filename: string;
+}
+export declare function exportEntities(entity: string, body: ExportRequest): Promise<ExportResponse>;
 /**
  * Action request body is flat: top-level keys are handler params. The only
  * reserved control key is `_ids` (array of object IDs for single/batch

package/dist-lib/api/params.d.ts

@@ -1,11 +1,17 @@
-import type { PublicParamsResponse, ResolvedParam } from "../types/api";
+import type { ParamLookup, PublicParamsResponse } from "../types/api";
 /**
  * Fetches the full pre-login envelope from /api/params/public:
- * {parameters, accents, branding}. Used by AuthShell to theme
+ * {parameters, accents, branding, meta}. Used by AuthShell to theme
  * unauthenticated screens before any user context exists.
  */
 export declare function fetchPublicParams(): Promise<PublicParamsResponse>;
-export declare function fetchParam(code: string): Promise<ResolvedParam>;
+/**
+ * Looks up a single parameter from the platform. Always returns a
+ * `ParamLookup`; `found:false` signals "no value, use your default".
+ * Network/auth failures still throw - "missing" is normal, "broken"
+ * is an error.
+ */
+export declare function fetchParam(code: string): Promise<ParamLookup>;
 /**
  * Persist a parameter override at user scope. Writes via the existing
  * subresource $params channel on the user entity (PATCH /api/data/user).

package/dist-lib/components/fields/EmailField.d.ts

@@ -1,2 +1,2 @@
 import type { FieldRendererProps } from "./index";
-export declare function EmailField({ value, mode, onChange }: FieldRendererProps): import("react/jsx-runtime").JSX.Element;
+export declare function EmailField({ value, onChange }: FieldRendererProps): import("react/jsx-runtime").JSX.Element;

package/dist-lib/components/fields/PhoneField.d.ts

@@ -0,0 +1,2 @@
+import type { FieldRendererProps } from "./index";
+export declare function PhoneField({ value, onChange }: FieldRendererProps): import("react/jsx-runtime").JSX.Element;

package/dist-lib/components/fields/UrlField.d.ts

@@ -1,2 +1,2 @@
 import type { FieldRendererProps } from "./index";
-export declare function UrlField({ field, value, mode, onChange }: FieldRendererProps): import("react/jsx-runtime").JSX.Element;
+export declare function UrlField({ value, onChange }: FieldRendererProps): import("react/jsx-runtime").JSX.Element;

package/dist-lib/components/fields/cells/factories/badge.d.ts

@@ -0,0 +1,2 @@
+import type { CellFactory } from "../registry";
+export declare const badgeFactory: CellFactory;

package/dist-lib/components/fields/cells/factories/boolPill.d.ts

@@ -0,0 +1,2 @@
+import type { CellFactory } from "../registry";
+export declare const boolPillFactory: CellFactory;

package/dist-lib/components/fields/cells/factories/code.d.ts

@@ -0,0 +1,2 @@
+import type { CellFactory } from "../registry";
+export declare const codeFactory: CellFactory;

package/dist-lib/components/fields/cells/factories/email.d.ts

@@ -0,0 +1,2 @@
+import type { CellFactory } from "../registry";
+export declare const emailFactory: CellFactory;

package/dist-lib/components/fields/cells/factories/host-icons.d.ts

@@ -0,0 +1,9 @@
+import { type FC, type SVGProps } from "react";
+type IconFC = FC<SVGProps<SVGSVGElement>>;
+export interface HostIconProps {
+    /** Canonical (after-www) hostname; pass null/empty to render the globe. */
+    domain: string | null | undefined;
+}
+export declare function HostIcon({ domain }: HostIconProps): React.ReactElement;
+export declare const GENERIC_GLOBE: IconFC;
+export {};

package/dist-lib/components/fields/cells/factories/link.d.ts

@@ -0,0 +1,2 @@
+import type { CellFactory } from "../registry";
+export declare const linkFactory: CellFactory;

package/dist-lib/components/fields/cells/factories/markdown.d.ts

@@ -0,0 +1,2 @@
+import type { CellFactory } from "../registry";
+export declare const markdownFactory: CellFactory;

package/dist-lib/components/fields/cells/factories/money.d.ts

@@ -0,0 +1,2 @@
+import type { CellFactory } from "../registry";
+export declare const moneyFactory: CellFactory;

package/dist-lib/components/fields/cells/factories/multilangInline.d.ts

@@ -0,0 +1,2 @@
+import type { CellFactory } from "../registry";
+export declare const multilangInlineFactory: CellFactory;

package/dist-lib/components/fields/cells/factories/nextRun.d.ts

@@ -0,0 +1,2 @@
+import type { CellFactory } from "../registry";
+export declare const nextRunFactory: CellFactory;

package/dist-lib/components/fields/cells/factories/number.d.ts

@@ -0,0 +1,2 @@
+import type { CellFactory } from "../registry";
+export declare const numberFactory: CellFactory;

package/dist-lib/components/fields/cells/factories/passwordMask.d.ts

@@ -0,0 +1,2 @@
+import type { CellFactory } from "../registry";
+export declare const passwordMaskFactory: CellFactory;

package/dist-lib/components/fields/cells/factories/phone.d.ts

@@ -0,0 +1,2 @@
+import type { CellFactory } from "../registry";
+export declare const phoneFactory: CellFactory;

package/dist-lib/components/fields/cells/factories/refLink.d.ts

@@ -0,0 +1,2 @@
+import type { CellFactory } from "../registry";
+export declare const refLinkFactory: CellFactory;

package/dist-lib/components/fields/cells/factories/richTextPreview.d.ts

@@ -0,0 +1,2 @@
+import type { CellFactory } from "../registry";
+export declare const richTextPreviewFactory: CellFactory;

package/dist-lib/components/fields/cells/factories/statusPill.d.ts

@@ -0,0 +1,2 @@
+import type { CellFactory } from "../registry";
+export declare const statusPillFactory: CellFactory;

package/dist-lib/components/fields/cells/factories/tagList.d.ts

@@ -0,0 +1,2 @@
+import type { CellFactory } from "../registry";
+export declare const tagListFactory: CellFactory;

package/dist-lib/components/fields/cells/factories/text.d.ts

@@ -0,0 +1,2 @@
+import type { CellFactory } from "../registry";
+export declare const textFactory: CellFactory;

package/dist-lib/components/fields/cells/factories/timestamp.d.ts

@@ -0,0 +1,3 @@
+import type { CellFactory } from "../registry";
+export declare const timeAgoFactory: CellFactory;
+export declare const timestampFullFactory: CellFactory;

package/dist-lib/components/fields/cells/factories/url-helpers.d.ts

@@ -0,0 +1,12 @@
+export declare const LONG_TLD: RegExp;
+export declare function looksLikeHostname(candidate: string): boolean;
+export declare function normalizeUrl(raw: string): string | null;
+export declare function parseDomain(href: string): string | null;
+/**
+ * LinkedIn is the only host we special-case. Recognized path prefixes
+ * `/in/<slug>`, `/company/<slug>`, `/school/<slug>` render as `<prefix>/<slug>`.
+ * Any other linkedin.com URL (feed, jobs, posts, bare host) falls through to
+ * the default hostname rendering.
+ */
+export declare function linkedinLabel(href: string, domain: string): string | null;
+export declare function isValidUrl(href: string): boolean;

package/dist-lib/components/fields/cells/factories/url.d.ts

@@ -0,0 +1,2 @@
+import type { CellFactory } from "../registry";
+export declare const urlFactory: CellFactory;

package/dist-lib/components/fields/cells/registry.d.ts

@@ -0,0 +1,18 @@
+import type { ReactNode } from "react";
+import type { EntityField, Entity, Screen } from "../../../types/schema";
+export type RowRecord = Record<string, unknown>;
+export type CellRenderer = (value: unknown, record: RowRecord) => ReactNode;
+export type RefsMap = Record<string, Record<string, Record<string, unknown>>>;
+export interface CellResolveCtx {
+    field: EntityField;
+    fieldName: string;
+    entity?: Entity;
+    entities?: Record<string, Entity>;
+    screens?: Record<string, Screen>;
+    refs?: RefsMap | (() => RefsMap | undefined);
+    locale: string;
+    navigate?: (href: string) => void;
+}
+export type CellFactory = (ctx: CellResolveCtx) => CellRenderer;
+export declare const REGISTRY_WIDGETS: readonly string[];
+export declare function resolveCellRenderer(ctx: CellResolveCtx): CellRenderer;

package/dist-lib/components/fields/index.d.ts

@@ -1,4 +1,5 @@
-import type { EntityField } from "../../types/schema";
+import type { EntityField, Entity, Screen } from "../../types/schema";
+import { type FieldType } from "../../types/fieldType";
 export type RefsMap = Record<string, Record<string, Record<string, unknown>>>;
 export interface FieldRendererProps {
     field: EntityField;
@@ -11,9 +12,13 @@ export interface FieldRendererProps {
     refs?: RefsMap;
     fill?: boolean;
     compact?: boolean;
+    entity?: Entity;
+    entities?: Record<string, Entity>;
+    screens?: Record<string, Screen>;
+    navigate?: (href: string) => void;
+    locale: string;
 }
 type FieldRenderer = React.ComponentType<FieldRendererProps>;
+export declare const editRegistry: Record<FieldType, FieldRenderer>;
 export declare function renderField(props: FieldRendererProps): React.ReactNode;
-export declare function getFieldRenderer(type: string): FieldRenderer;
-export declare function hasFieldRenderer(key: string): boolean;
 export {};

package/dist-lib/components/file-widgets/host.d.ts

@@ -1,5 +1,5 @@
 import type { ReactNode } from "react";
-import type { Entity } from "../../types/schema";
+import type { Entity, Screen } from "../../types/schema";
 import type { FileFieldDef, FileFieldValue } from "../../types/files";
 import type { RefsMap } from "../../components/fields";
 export declare function getEntityFileField(entity: Pick<Entity, "files">, fieldName: string): FileFieldDef | undefined;
@@ -16,4 +16,8 @@ export declare function renderSchemaField(props: {
     onChange?: (value: unknown) => void;
     refs?: RefsMap;
     disabled?: boolean;
+    entities?: Record<string, Entity>;
+    screens?: Record<string, Screen>;
+    navigate?: (href: string) => void;
+    locale: string;
 }): ReactNode;

package/dist-lib/components/pages/ExportMenu.d.ts

@@ -0,0 +1,32 @@
+import type { Entity, Screen } from "../../types/schema";
+import { type ListViewState } from "./exportRequest";
+export interface ExportMenuProps {
+    entityCode: string;
+    entity: Entity;
+    screen?: Screen | undefined;
+    /** Live list-view state (filters/search/sort/page/per_page/etc). */
+    viewState: ListViewState;
+    /** Visible columns in display order. _select / _actions stripped by buildExportRequest. */
+    visibleColumns: string[];
+    /** Currently-selected row PKs. Empty array = nothing selected; the
+     *  Selected scope item is hidden. Caller is responsible for translating
+     *  whatever row-selection state shape into PK objects. */
+    selectedRowPKs: Array<Record<string, string>>;
+    /** Total row count for the current view, when known (from list meta.total).
+     *  When undefined, the menu shows "all matching rows" instead of a number. */
+    totalRows?: number;
+    /** Per-page size of the current view (for the Current page label). */
+    pageSize?: number;
+    /** Caller's UI locale (e.g. "en"). Server falls back to ui_language when omitted. */
+    locale?: string;
+    /** Optional placement override for the popover. */
+    align?: "start" | "end";
+    /** When true, render only as a single MenuItem suitable for embedding inside
+     *  the existing selection menu (replaces the placeholder at :2007-2015).
+     *  Defaults to a full Btn + Dropdown toolbar item. */
+    variant?: "toolbar" | "selection-menu-item";
+    /** Optional click-handler ran before scope dispatch — e.g. to close a
+     *  parent menu so the export popover doesn't stack underneath. */
+    onBeforeOpen?: () => void;
+}
+export declare function ExportMenu(props: ExportMenuProps): import("react/jsx-runtime").JSX.Element | null;

package/dist-lib/components/pages/auth/AuthShell.d.ts

@@ -2,7 +2,22 @@ import { type ReactNode } from "react";
 import { Icon } from "../../../components/primitives/Icons";
 export type AuthShellProps = {
     children: ReactNode;
-    workspaceHost?: string;
+    /**
+     * Tenant slug used to compose the workspace pill. The pill renders
+     * `<tenantSlug>.<branding.workspace_domain>` only when both pieces
+     * are set; otherwise it is hidden. Callers are not required to
+     * provide a slug — the auth shell fails closed (no pill) rather
+     * than display a placeholder host.
+     *
+     * Currently unwired in v1: no SDK caller passes this prop because
+     * frontend tenant-from-host resolution does not exist yet (see
+     * `docs/gotchas.md` "Tenant Resolution" — the deferred multi-tenant-
+     * via-host work). When that lands, callers will source the slug from
+     * `window.location.hostname` (or an equivalent middleware-supplied
+     * context) and thread it through. Until then the pill stays hidden;
+     * the prop is kept so the contract is in place for the follow-up.
+     */
+    tenantSlug?: string;
     tagline?: string;
     subTagline?: string;
     version?: string;
@@ -10,4 +25,4 @@ export type AuthShellProps = {
     /** Optional override for the wordmark / app name shown in topbar + brand panel. */
     brandName?: string;
 };
-export declare function AuthShell({ children, workspaceHost, tagline, subTagline, version, badges, brandName, }: AuthShellProps): import("react/jsx-runtime").JSX.Element;
+export declare function AuthShell({ children, tenantSlug, tagline, subTagline, version, badges, brandName, }: AuthShellProps): import("react/jsx-runtime").JSX.Element;

package/dist-lib/components/pages/auth/Reset.d.ts

@@ -0,0 +1 @@
+export declare function Reset(): import("react/jsx-runtime").JSX.Element;

package/dist-lib/components/pages/exportRequest.d.ts

@@ -0,0 +1,71 @@
+import type { FilterNodeParam } from "../../types/api";
+/** ExportQuery mirrors the Go ExportQuery struct (server/handlers/data_export.go).
+ *  Field order matches; semantics match parseListParams 1:1. */
+export interface ExportQuery {
+    screen?: string;
+    filters?: FilterNodeParam[];
+    search?: string;
+    sort?: string;
+    include_deleted?: boolean;
+    page?: number;
+    per_page?: number;
+}
+/** ExportScope values accepted by the server. v1 supports `current_view`,
+ *  `selected_rows`, and `current_page`; `template` is reserved for v2. */
+export type ExportScope = "current_view" | "selected_rows" | "current_page";
+/** ExportRequest mirrors the Go ExportRequest struct. */
+export interface ExportRequest {
+    format: "csv";
+    scope: ExportScope;
+    query: ExportQuery;
+    columns: string[];
+    selection?: Array<Record<string, string>>;
+    locale?: string;
+    /** v1 wire defaults: `header_style="label"`, `ref_mode="display"`. v2 will
+     *  add `code` / `stable_key`. Omitted = server defaults. */
+    header_style?: "label";
+    ref_mode?: "display";
+    filename?: string;
+}
+/** ListViewState captures the SmartListPage hook state needed to describe
+ *  the current view. Field names mirror useEntityData state so the call
+ *  site can spread it as-is. */
+export interface ListViewState {
+    /** Active screen code, when the list is rendered through a screen. */
+    screenCode?: string;
+    /** JSON filter tree (the same shape sent in the `filters` URL param). */
+    jsonFilters?: FilterNodeParam[];
+    /** Debounced search value from the toolbar. */
+    search?: string;
+    /** "field:asc" / "field:desc" sort spec. */
+    sort?: string;
+    /** Show soft-deleted rows. */
+    includeDeleted?: boolean;
+    /** Current page (1-based). Used only for `current_page` scope. */
+    page?: number;
+    perPage?: number;
+}
+/** Locale resolver hook input — typically a string from the SDK ctx
+ *  (e.g. `useLocale()`); empty/undefined defers to the server default. */
+export interface ExportIntent {
+    scope: ExportScope;
+    /** All visible columns in display order. _select / _actions are stripped
+     *  by buildExportRequest. */
+    visibleColumns: string[];
+    /** PK objects of the currently-selected rows. Non-empty only for
+     *  `selected_rows` scope. */
+    selectedRowPKs?: Array<Record<string, string>>;
+    locale?: string;
+    filename?: string;
+}
+/** buildListQuery returns the canonical list-query JSON shape from the
+ *  hook state the table renders against. Output is plain-object so it
+ *  serializes deterministically through JSON.stringify (key order is
+ *  controlled by spread order below). */
+export declare function buildListQuery(state: ListViewState): ExportQuery;
+/** buildExportRequest assembles the POST body for the export endpoint.
+ *  The query block is always present (even for selected_rows; the server
+ *  ignores filters/search/sort under that scope but keeps screen for
+ *  per-screen export gating). Reserved column keys (_select, _actions)
+ *  are stripped here, never on the server. */
+export declare function buildExportRequest(state: ListViewState, intent: ExportIntent): ExportRequest;

package/dist-lib/components/primitives/BrandGlyph.d.ts

@@ -0,0 +1,8 @@
+export interface BrandGlyphProps {
+    /** Pixel edge of the rendered SVG. Defaults to 24. */
+    size?: number;
+    className?: string;
+    /** ARIA label; omit for purely decorative usages. */
+    title?: string;
+}
+export declare function BrandGlyph({ size, className, title }: BrandGlyphProps): import("react/jsx-runtime").JSX.Element;

package/dist-lib/components/primitives/BrandLogo.d.ts

@@ -6,11 +6,7 @@ export interface BrandLogoProps {
     size: number;
     /** Border radius for the image frame. Defaults to 8 at size>=30 else 6. */
     radius?: number;
-    /**
-     * Rendered when appLogo is missing or not a valid URL. Surfaces like
-     * the pre-login AuthShell want a visible platform-default tile;
-     * surfaces like the Sidebar prefer nothing (text app_name fills in).
-     */
+    /** Rendered when appLogo is missing or not a valid URL. */
     fallback?: ReactNode;
 }
 export declare function BrandLogo({ appLogo, size, radius, fallback }: BrandLogoProps): import("react/jsx-runtime").JSX.Element | null;

package/dist-lib/components/primitives/index.d.ts

@@ -10,6 +10,8 @@ export type { PillProps, PillTone, PillSize } from "./Pill";
 export { Kbd } from "./Kbd";
 export { Avatar } from "./Avatar";
 export type { AvatarProps } from "./Avatar";
+export { BrandGlyph } from "./BrandGlyph";
+export type { BrandGlyphProps } from "./BrandGlyph";
 export { Dropdown } from "./Dropdown";
 export type { DropdownProps } from "./Dropdown";
 export { Chip } from "./Chip";

package/dist-lib/components/shared/EmptyState.d.ts

@@ -2,7 +2,7 @@ import type { ReactNode } from "react";
 interface EmptyStateProps {
     icon?: string;
     title: string;
-    description?: string;
+    description?: ReactNode;
     action?: ReactNode;
 }
 export declare function EmptyState({ icon, title, description, action }: EmptyStateProps): import("react/jsx-runtime").JSX.Element;

package/dist-lib/declarion-glyph.svg

@@ -0,0 +1,17 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" width="64" height="64">
+  <!--
+    Declarion mark: angular letter "D" with an embedded "=" in the negative
+    space of the counter. Encodes the product thesis ("this declaration
+    equals this runtime behavior") in the letterform itself. Solid accent
+    purple #5B5BD6 — visible on both light surfaces and the dark brand
+    panel without prefers-color-scheme tricks. Trademark distinctive,
+    scales crisp from favicon (16px) through hero (96px+).
+  -->
+  <path
+    fill-rule="evenodd"
+    fill="#5B5BD6"
+    d="M 6 6 H 42 L 58 22 V 42 L 42 58 H 6 Z M 18 18 V 46 H 38 L 46 38 V 26 L 38 18 Z"
+  />
+  <rect x="22" y="28" width="20" height="3" fill="#5B5BD6"/>
+  <rect x="22" y="33" width="20" height="3" fill="#5B5BD6"/>
+</svg>