@declarion/react 0.61.1 → 0.63.0

package/dist-lib/hooks/useProperties.d.ts

@@ -1,5 +0,0 @@
-export declare function useSetProperty(entity: string | undefined, id: string | undefined): import("@tanstack/react-query").UseMutationResult<import("..").PropertyValue, Error, {
-    propertyCode: string;
-    value: unknown;
-}, unknown>;
-export declare function useDeleteProperty(entity: string | undefined, id: string | undefined): import("@tanstack/react-query").UseMutationResult<void, Error, string, unknown>;

package/dist-lib/hooks/useRealtimeThresholds.d.ts

@@ -1 +0,0 @@
-export declare function useRealtimeThresholds(): void;

package/dist-lib/hooks/useRegisterScreenTab.d.ts

@@ -1,11 +0,0 @@
-import { type Entity, type Screen } from "../types/schema.d.ts";
-/**
- * The embed-guarded tab registration shared by the schema-driven Smart pages
- * (`useRegisterScreenTab`) and the public custom-screen hook (`useScreenTab`),
- * so the "open a tab for this screen" logic - and its embed guard - lives in one
- * place. Registers `route` as a tab once; `search` is captured at first
- * registration (the mirror syncs later changes), so it is excluded from the
- * effect deps. No-op when `route` is absent or embed mode is on.
- */
-export declare function useScreenTabRegistration(route: string | undefined, title: string, icon: string | undefined, search: string): void;
-export declare function useRegisterScreenTab(screen: Screen | undefined, entity: Entity | undefined, search: string): void;

package/dist-lib/hooks/useResponsiveMode.d.ts

@@ -1,27 +0,0 @@
-import { type ReactNode } from "react";
-import { DEFAULT_RESPONSIVE_BREAKPOINTS, resolveViewportCategory, type ResponsiveBreakpoints, type ResponsiveMode, type ResponsiveViewport, type ViewportCategory } from "../lib/viewport-category.d.ts";
-export { DEFAULT_RESPONSIVE_BREAKPOINTS, resolveViewportCategory, type ResponsiveBreakpoints, type ResponsiveMode, type ResponsiveViewport, type ViewportCategory, };
-export declare function clearViewportCssVariables(): void;
-export interface ResponsiveModeProviderProps {
-    children: ReactNode;
-    breakpoints?: ResponsiveBreakpoints;
-    /**
-     * A measured viewport, substituted for `window`'s. Carries a WIDTH, from
-     * which the category is derived. Used by tests to place the app at a size.
-     *
-     * This is NOT how you force a device class - a forced class is not
-     * expressible as a width. Use `viewport` for that.
-     */
-    viewportOverride?: ResponsiveViewport;
-    /**
-     * The deployment's declared device class, from
-     * `branding.chrome.{full,embed}.viewport`. `auto` (the default) derives it
-     * from the measured width, byte for byte as before. A forced value overrides
-     * the width for every consumer of the category at once.
-     */
-    viewport?: ForcedViewport;
-}
-/** `auto` derives from width; anything else forces the category. */
-export type ForcedViewport = "auto" | ViewportCategory;
-export declare function ResponsiveModeProvider({ children, breakpoints, viewportOverride, viewport: declaredViewport, }: ResponsiveModeProviderProps): import("react").JSX.Element;
-export declare function useResponsiveMode(): ResponsiveMode;

package/dist-lib/hooks/useSSE.d.ts

@@ -1,31 +0,0 @@
-import { type QueryClient } from "@tanstack/react-query";
-import { type ChangedObject, type EntityAction } from "../api/events.d.ts";
-export interface EntityChangedEvent {
-    entity: string;
-    action: EntityAction;
-    eventID?: string;
-    ids: string[];
-    objects?: ChangedObject[];
-    reason?: string;
-}
-/**
- * Applies one coalescing window of change frames, resolving once every query it
- * touched claims no freshness it lacks - which is what lets the caller advance
- * its resume position.
- */
-export declare function applyEntityChanges(queryClient: QueryClient, events: EntityChangedEvent[], signal?: AbortSignal): Promise<void>;
-/**
- * What a write of one's OWN settles: the rows it NAMED are re-read through the
- * path a change frame takes, and `fallback` covers everything it does not
- * identify.
- */
-export declare function settleOwnWrite(queryClient: QueryClient, isAuthenticated: boolean, entity: string, rows: Array<Record<string, string>>, fallback: () => void): void;
-export declare function evictEntityBackedQueries(queryClient: QueryClient): void;
-export declare function liveEntityChanges(queryClient: QueryClient, isAuthenticated: boolean, events: EntityChangedEvent[]): EntityChangedEvent[];
-/**
- * What a returning tab still has to ask for, once the replay covers the rest:
- * the entities that are not `realtime: true` and the ones the relay degraded,
- * which between them are the majority of screens.
- */
-export declare function refetchQueriesReplayDoesNotCover(queryClient: QueryClient, isAuthenticated: boolean): void;
-export declare function useSSE(): void;

package/dist-lib/hooks/useSchema.d.ts

@@ -1 +0,0 @@
-export declare function useSchema(): import("@tanstack/react-query").UseQueryResult<import("..").Schema, Error>;

package/dist-lib/hooks/useScreen.d.ts

@@ -1,2 +0,0 @@
-import type { Screen } from "../types/schema.d.ts";
-export declare function useScreen(screenCode: string | undefined): Screen | undefined;

package/dist-lib/hooks/useScreenBack.d.ts

@@ -1,21 +0,0 @@
-export interface UseScreenBackOptions {
-    /** Static/parent fallback invoked when there is no valid origin (e.g. a
-     *  detail's `backToList`, a custom screen's static `PageHeader.backTo`).
-     *  Callers make this embed-correct themselves; the hook never tab-ops it. */
-    fallback?: () => void;
-}
-export interface ScreenBack {
-    /** True when `goBack` will navigate (an origin exists, or a fallback is
-     *  provided and permitted). Drives whether to render a Back affordance when a
-     *  surface has no other visibility rule. */
-    canGoBack: boolean;
-    /** True when the active screen has a captured origin to return to. */
-    hasOriginBack: boolean;
-    /** True when a static/parent fallback is permitted (false ONLY for a
-     *  menu-cleared origin). Surfaces combine it with their own rule. */
-    allowFallbackBack: boolean;
-    /** Navigate Back: switch to / reopen the origin tab, else invoke the
-     *  fallback. Never closes the current tab; never throws. */
-    goBack: () => void;
-}
-export declare function useScreenBack(opts?: UseScreenBackOptions): ScreenBack;

package/dist-lib/hooks/useScreenTab.d.ts

@@ -1,10 +0,0 @@
-export interface UseScreenTabOptions {
-    /** The tab's route. Defaults to the live `location.pathname` - the right value
-     *  for a param-less custom screen, which is the common case. */
-    route?: string;
-    /** Tab title. Defaults to the route when omitted. */
-    title?: string;
-    /** Tab icon name (resolved by the icon registry). */
-    icon?: string;
-}
-export declare function useScreenTab(opts?: UseScreenTabOptions): void;

package/dist-lib/hooks/useTabNavigate.d.ts

@@ -1,34 +0,0 @@
-interface TabNavigateOptions {
-    title?: string;
-    icon?: string;
-    search?: string;
-    replace?: boolean;
-    /**
-     * Top-level (chrome) navigation: do NOT capture the current screen as the
-     * destination's Back origin; CLEAR the destination tab's origin to `null`
-     * (the menu-cleared sentinel) so a menu/sidebar/command-palette-opened
-     * screen shows no Back. Default `false` = capture by default, which is what
-     * makes every drill-in (content anchors, row clicks, association, action
-     * href, custom `tabNavigate`) origin-aware with no per-site change.
-     */
-    topLevel?: boolean;
-}
-/**
- * Split a full location string (`/path?query#hash`) into the fields
- * react-router's object `to` accepts. The router REJECTS a `?` or `#` inside
- * `to.pathname` ("Cannot include a '?' character in a manually specified
- * to.pathname field"), so every string reaching the navigation chokepoint must
- * be parsed first - the global link interceptor returns `pathname+search+hash`
- * and schema `href` actions carry their own query. Pushing the raw string into
- * the pathname field threw and silently aborted the redirect to /login on a
- * terminal session (the stranded-on-page incident). `fallbackSearch` applies
- * only when the path has no query of its own, for callers that pass pathname
- * and search separately.
- */
-export declare function resolveTabTarget(to: string, fallbackSearch?: string): {
-    pathname: string;
-    search?: string;
-    hash?: string;
-};
-export declare function useTabNavigate(): (to: string, opts?: TabNavigateOptions) => void;
-export {};

package/dist-lib/hooks/useTabSearchMirror.d.ts

@@ -1 +0,0 @@
-export declare function useTabSearchMirror(route: string | undefined): void;

package/dist-lib/hooks/useTabTitle.d.ts

@@ -1,2 +0,0 @@
-import type { TabItem } from "../stores/tabs.d.ts";
-export declare function useTabTitle(): (tab: Pick<TabItem, "pathname" | "title" | "derivedTitle">) => string;

package/dist-lib/hooks/useText.d.ts

@@ -1,3 +0,0 @@
-import { type TextFn } from "../lib/language.d.ts";
-export type { TextFn } from "../lib/language.d.ts";
-export declare function useText(catalog?: "messages" | "errors"): TextFn;

package/dist-lib/hooks/useTimelineData.d.ts

@@ -1,10 +0,0 @@
-import type { V2ListResponse } from "../types/api.d.ts";
-export declare function useTimelineData(parentEntity: string, parentId: string, childCode: string, foreignKey: string | string[], timeField: string | undefined, limit?: number): {
-    rows: Record<string, unknown>[];
-    refs: import("../types/api.d.ts").Refs | undefined;
-    fetchNextPage: (options?: import("@tanstack/react-query").FetchNextPageOptions) => Promise<import("@tanstack/react-query").InfiniteQueryObserverResult<import("@tanstack/react-query").InfiniteData<V2ListResponse<Record<string, unknown>>, unknown>, Error>>;
-    hasOlder: boolean;
-    isFetchingOlder: boolean;
-    isLoading: boolean;
-    isError: boolean;
-};

package/dist-lib/hooks/useVersionWatcher.d.ts

@@ -1,30 +0,0 @@
-/**
- * useVersionWatcher — staleness watchdog for the SPA.
- *
- * Wires three layers of detection (in defense-in-depth order):
- *
- *   1. Header-based detection (in apiFetch via versionTracker.observe)
- *      — instant, runs on every API response, no extra round-trip.
- *
- *   2. Periodic /api/version probe — caps drift latency at 60s for
- *      idle tabs. Fires on:
- *        • window focus            (debounced to ≥5s)
- *        • online reconnect
- *        • document.visibilitychange → visible
- *        • 60s interval while visible
- *      Backs off exponentially on failure (1s → 5min cap) so a 5xx
- *      doesn't error-loop.
- *
- *   3. (future) SSE `version-changed` from the realtime role —
- *      handled by useSSE; kicks fetchProbe() on receipt.
- *
- * On drift the tracker classifies the delta:
- *   • schema-only      → silent React Query invalidation of ["schema"]
- *   • asset-or-binary  → persistent toast with a "Reload now" action
- *   • unknown          → same as asset/binary (conservative reload)
- *
- * Safe to call exactly once at the App root. Subsequent calls are
- * harmless (subscribe is idempotent through the tracker's drift-
- * debounce flag), but the probes would compound — keep it to one.
- */
-export declare function useVersionWatcher(): void;

package/dist-lib/hooks/useViews.d.ts

@@ -1,26 +0,0 @@
-import type { ViewItem } from "../components/list/ViewSwitcher.d.ts";
-import type { RowData } from "../types/api.d.ts";
-/** One saved-view row as the switcher and the resolver read it. */
-export declare function viewItemFromRow(row: RowData, userId?: string): ViewItem;
-/** One view by identifier. The switcher's window is bounded, so a link to an
- *  older view resolves here instead of reading as deleted. */
-export declare function useViewById(id: string | null, userId?: string): {
-    view: ViewItem | undefined;
-    isSettled: boolean;
-};
-/** The screen's views and whether the saved half of them has arrived. */
-export interface ViewsQuery {
-    views: ViewItem[];
-    /** A failed request is settled, and so is one the browser has PAUSED for
-     *  being offline: in both the list is what it is, and a view the URL names
-     *  is not found rather than still coming. */
-    isSettled: boolean;
-    isFetching: boolean;
-    refetch: () => void;
-}
-/**
- * useViews fetches DB views for a screen and merges with system views (presets) from DSL.
- * Returns a unified list with source tagging.
- */
-export declare function useViews(screenCode: string, userId?: string): ViewItem[];
-export declare function useViewsQuery(screenCode: string, userId?: string): ViewsQuery;

package/dist-lib/lib/action-dispatch.d.ts

@@ -1,8 +0,0 @@
-import { type UIActionContext } from "./ui-actions.d.ts";
-import type { UIStep } from "../types/schema.d.ts";
-import type { TextFn } from "./language.d.ts";
-export declare function dispatchAction(errorTitle: TextFn, code: string, action: {
-    ui_steps?: UIStep[];
-    handler?: string;
-    entity?: string;
-}, uiContext: UIActionContext, entityFallback?: string): string | null;

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

@@ -1,254 +0,0 @@
-import type { Action, ActionCondition, Entity, LocalizedString, Schema } from "../types/schema.d.ts";
-import type { TextFn } from "./language.d.ts";
-/**
- * Row-menu navigation platform-default action codes. The server injects them
- * into every entity and (for explicit action_layout trees) prepends them so the
- * Row Menu leads with navigation. `__peek` opens the Quick peek drawer (mode-less
- * client verb); `__open` navigates to the record's detail page (href). Shared by
- * the dispatcher, the nav-divider renderer, and client-side suppression (drop
- * `__peek` where peek is unavailable, `__open` where the entity has no detail
- * route). Kept as named constants because these codes are read in 3+ places.
- */
-export declare const PEEK_ACTION_CODE = "__peek";
-export declare const OPEN_ACTION_CODE = "__open";
-/** True when the code is one of the leading row-menu navigation defaults. */
-export declare function isNavDefaultCode(code: string): boolean;
-/**
- * rowDetailId builds the detail-route id for a row - the value an href's
- * `${id}` placeholder and a detail screen's `:id` segment receive - addressing
- * it by the entity's REAL primary key (any single field or a composite key), so
- * an entity whose PK is not named `id` (e.g. `schedule.code`) resolves correctly
- * instead of emitting an empty `${id}`. Falls back to a raw `id` lookup only
- * when no entity is in scope (defensive; an href dispatch always has one) or the
- * row has no resolvable PK yet (an optimistic placeholder).
- *
- * Single source of truth for row -> detail-id, shared by ResponsiveActionBar
- * (action_layout dispatch) and ActionButton (flat href dispatch).
- */
-export declare function rowDetailId(row: Record<string, unknown> | undefined, entity: Entity | undefined): string;
-/**
- * Evaluates action conditions against row data.
- * Returns true if the action is available (all conditions pass).
- * An action with no conditions is always available.
- */
-export declare function evaluateConditions(conditions: ActionCondition[] | undefined, row: Record<string, unknown>): boolean;
-export declare function actionConditionFieldValue(row: Record<string, unknown>, field: string): unknown;
-export declare function withActionConditionFields<T extends Record<string, unknown>>(row: T): T;
-/**
- * Returns actions from an entity whose visibility array contains the given
- * placement. Canonical values (the 9 the Go validator accepts): detail |
- * detail_toolbar | list_row | list_toolbar | list_floatbar | quick_peek |
- * app_menu | nav_create | command_palette. Schema validator rejects unknown
- * values at load time so we don't need runtime alias handling here.
- */
-export declare function getActionsByVisibility(actions: Record<string, Action> | undefined, visibility: string): Array<{
-    code: string;
-    action: Action;
-}>;
-/**
- * Returns actions bound to a screen. When the screen defines explicit action/row_action
- * codes, only those are returned (resolved from entity.actions first, then global actions).
- * When no screen binding exists, falls back to visibility-based filtering.
- */
-export declare function getScreenActions(entityActions: Record<string, Action> | undefined, screenActionCodes: string[] | undefined, fallbackVisibility: string, globalActions?: Record<string, Action>): Array<{
-    code: string;
-    action: Action;
-}>;
-export declare function filterUnavailableMutationActions(actions: Array<{
-    code: string;
-    action: Action;
-}>, entity: Pick<Entity, "readonly" | "mutations"> | undefined): Array<{
-    code: string;
-    action: Action;
-}>;
-/**
- * Checks if an action has parameters that need user input.
- */
-export declare function actionHasParams(action: Action): boolean;
-/**
- * The confirmation message to show before running an action, or null when no
- * confirm step is needed. This is the SINGLE source of confirm semantics, read
- * by every dispatch surface (the ActionRunner and ActionButton) so they cannot
- * drift:
- *   - a declared `confirmation` wins (works on any action, destructive or not);
- *   - else a `destructive` action gets the default danger warning;
- *   - else null (no confirm).
- * Both the declared text and the default are declared words, read through `t`. `destructive` is a semantic class (danger colour + trailing
- * placement + the server impersonation gate + agent HITL); the confirm is one
- * of its effects, and `confirmation` only tunes the TEXT - not a second gate.
- */
-export declare function actionConfirmMessage(t: TextFn, action: Action | undefined): string | null;
-/**
- * True when the action must show a confirm step (destructive OR a declared
- * confirmation). Language-independent - it is a presence check, so the runner can
- * decide whether to open the dialog without resolving the text.
- */
-export declare function actionNeedsConfirm(action: Action | undefined): boolean;
-/**
- * Tooltip text for an action control.
- * Precedence: disabled-reason > description > name.
- *
- * A labeled control already shows the name, so its tooltip is the description
- * alone. A control with no visible label - declared `display.icon_only`, or a
- * label the bar dropped to keep the button in a tight row - leads with the NAME
- * on its own line, then the description. Absent description falls back to the
- * name.
- */
-export declare function actionTooltip(t: TextFn, action: Action | undefined, name: string, isDisabled: boolean, reason: string | null | undefined, 
-/**
- * True when the button is rendering WITHOUT its label right now - either
- * because the author declared `display.icon_only`, or because the row ran out
- * of width and the bar dropped the label to keep the button. Both cases leave
- * the user looking at an icon, so the tooltip has to say the name first.
- */
-labelHidden?: boolean): string;
-/**
- * Builds the full dot-qualified action code for API calls.
- */
-export declare function fullActionCode(entityCode: string | undefined, actionCode: string): string;
-/**
- * Checks if an action is an association navigation action.
- * Reason: in the wire format, dispatch mode is
- * encoded by which dispatch field is set; the `association` field is the mode.
- */
-export declare function isAssociationAction(action: Action): boolean;
-/**
- * Finds the list screen route for a given entity code.
- * Returns the screen route and display info, or undefined if no list screen exists.
- */
-export declare function findListScreenForEntity(schema: Schema | undefined, entityCode: string): {
-    route: string;
-    icon: string;
-} | undefined;
-/**
- * Resolved leaf node. Kind discriminator "action".
- * Enabled defaults true from server; client sets false when enabled_if fails.
- * Reason carries the localized tooltip text when Enabled is false.
- *
- * Wire format: {"kind":"action","code":"approve","enabled":true,"reason":null}
- */
-export interface ResolvedActionLeaf {
-    kind: "action";
-    code: string;
-    enabled: boolean;
-    reason: string | null;
-}
-/**
- * Resolved group node. Kind discriminator "group".
- * Items is always non-empty after pruning (empty groups are dropped).
- *
- * Wire format: {"kind":"group","name":{...},"icon":"...","items":[...]}
- */
-export interface ResolvedActionGroup {
-    kind: "group";
-    name?: LocalizedString;
-    icon?: string;
-    items: ResolvedActionLayoutNode[];
-}
-/**
- * Discriminated union for a resolved action layout node.
- * Narrow via node.kind === "action" or node.kind === "group".
- */
-export type ResolvedActionLayoutNode = ResolvedActionLeaf | ResolvedActionGroup;
-/**
- * applyRowState walks an RBAC-pruned ResolvedActionLayoutNode[] and applies
- * per-row visible_if / enabled_if evaluation.
- *
- * Drop conditions:
- * - visible_if conditions not satisfied by row -> leaf dropped
- * - Empty groups after all children are dropped -> group dropped
- *
- * Disable conditions:
- * - enabled_if conditions not satisfied by row -> leaf enabled=false + reason set
- * - For bulk (rowSelection.length > 0): visible when ANY selected row satisfies
- *   visible_if; enabled only when ALL selected rows satisfy visible_if and
- *   enabled_if. Reason carries the failing count.
- *
- * @param layout   RBAC-pruned tree from the server (or resolveActionLayout client-side).
- * @param entityActions  Entity-level actions map (entity wins on code collision).
- * @param globalActions  Global schema actions (fallback when entity doesn't declare).
- * @param row      The current row data for single-row context (detail / list_row).
- * @param rowSelection  All selected rows for bulk context (list_toolbar bulk mode).
- *                      Pass empty array for non-bulk contexts.
- */
-export declare function applyRowState(t: TextFn, layout: ResolvedActionLayoutNode[], entityActions: Record<string, Action> | undefined, globalActions: Record<string, Action> | undefined, row: Record<string, unknown>, rowSelection: Record<string, unknown>[], allowedActionCodes?: ReadonlySet<string>): ResolvedActionLayoutNode[];
-/**
- * Filters a server-emitted ResolvedActionLayoutNode tree to a single slot,
- * preserving group structure. Drops leaves whose action's visibility[] does
- * not include the slot. Drops groups whose entire item list pruned out
- * (empty-group auto-hide). Additional filters via `opts`:
- *
- *  - opts.bulkRequired: when set, gates list_toolbar leaves whose effective
- *    "bulk-required" semantic matches the request. The old wire-format flag
- *    `bulk_selection_required` was removed (the server now derives this
- *    from `handler.invoke`), so the caller passes a predicate that decides
- *    per action.
- *    Reason: keep the slot+bulk filtering surface intact while removing the
- *    field; the call sites supply the legacy predicate.
- *  - opts.excludeIf: drop leaves where the predicate returns true. Common
- *    use: hide "create" / "edit" / "delete" style actions that the screen
- *    renders inline elsewhere. Reason: the old `excludeTypes` keyed on
- *    `action.type`, which is removed; callers now express the same intent
- *    as a field-presence predicate.
- *
- * Leaves whose code cannot be looked up are dropped (server should have
- * pruned them; defensive).
- */
-export declare function filterLayoutForSlot(layout: ResolvedActionLayoutNode[], entityActions: Record<string, Action> | undefined, globalActions: Record<string, Action> | undefined, slot: string, opts?: {
-    bulkRequired?: boolean;
-    bulkRequiredPredicate?: (action: Action) => boolean;
-    excludeIf?: (action: Action) => boolean;
-}): ResolvedActionLayoutNode[];
-export declare function resolveActionLayoutForSlot(screenActionLayout: ResolvedActionLayoutNode[] | null | undefined, entityActionLayout: ResolvedActionLayoutNode[] | null | undefined, entityActions: Record<string, Action> | undefined, globalActions: Record<string, Action> | undefined, slot: string, opts?: Parameters<typeof filterLayoutForSlot>[4]): ResolvedActionLayoutNode[];
-/**
- * True when an action needs at least one selected row to be meaningful, so a
- * surface (the list toolbar) greys it while nothing is selected and enables it
- * once a selection exists.
- *
- * The server derives this from the handler's id-arity contract (a handler that
- * cannot run without object IDs - not allow_no_objects, not invoke=unbound),
- * association mode, or an href `${id}` row-link, and emits it as
- * `requires_selection`. When the field is PRESENT it is authoritative.
- *
- * When ABSENT (an older server, or the `widget`/`ui_steps` modes the server
- * does not derive) we fall back to the historical proxy: slot membership in
- * `list_floatbar`. Absent MUST NOT be read as false, or every handler action
- * would silently read as page-level against an older server.
- */
-export declare function actionRequiresSelection(action: Action): boolean;
-/**
- * True when the action declares the `list_floatbar` (selection bar) slot.
- *
- * This is the OLD body of actionRequiresSelection, kept ONLY to decide
- * toolbar/floatbar de-duplication: an action that opts into the floatbar is
- * rendered there on selection, so the static toolbar drops it to avoid a
- * double-render. It is NOT the selection predicate - greying is driven by
- * actionRequiresSelection (the accurate server signal).
- */
-export declare function actionInFloatbarSlot(action: Action): boolean;
-/**
- * Walks a ResolvedActionLayoutNode[] and sets `enabled: false` plus the
- * given `reason` on every leaf whose action satisfies `predicate`. Groups
- * are recursed into; tree structure is preserved (no nodes dropped) so the
- * user still sees what is available. Leaves whose code cannot be resolved
- * are left untouched (defensive; the server should have pruned them).
- *
- * Use: grey out selection-mode actions on the list toolbar while no rows
- * are selected.
- */
-export declare function disableLeavesWhere(layout: ResolvedActionLayoutNode[], entityActions: Record<string, Action> | undefined, globalActions: Record<string, Action> | undefined, predicate: (action: Action) => boolean, reason: string): ResolvedActionLayoutNode[];
-/**
- * Composes a flat ResolvedActionLayoutNode[] from an entity's actions map,
- * filtered to those that include the given slot in their visibility array,
- * sorted by position ascending (ties broken by action code).
- *
- * This is the fallback used when neither screen.action_layout nor
- * entity.action_layout is present.
- *
- * All leaves are emitted with enabled=true; client applies visible_if /
- * enabled_if via applyRowState.
- *
- * @param actions  Entity-level actions map from the (already RBAC-pruned) schema.
- * @param slot     Placement slot code (e.g. "detail", "list_row", "list_toolbar").
- */
-export declare function defaultFlatForSlot(actions: Record<string, Action> | undefined, slot: string): ResolvedActionLayoutNode[];

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

@@ -1,36 +0,0 @@
-/**
- * The anchor expression, TypeScript side.
- *
- * One grammar for "a moment relative to now", shared with the server. The
- * language boundary is the only reason there are two implementations; nothing
- * else may declare a third.
- *
- *   now            the current instant
- *   now+3w         three weeks ahead
- *   now-1d         one day back
- *   now+3w-1d      the offsets compose, left to right
- *
- * Units are Go's plus `d` (24h) and `w` (7d). Calendar units `y` and `mo` are
- * refused: they have no fixed length, so `1mo` from the 31st has no answer this
- * platform is willing to invent.
- */
-/**
- * One magnitude, and the running total of an anchor's offsets, may not exceed
- * 100 years. Beyond that the server's arithmetic saturates and `now+N` and
- * `now-N` collapse to the same instant - a predicate written to match nothing
- * matching everything. The client refuses the same inputs so a template that
- * would fail on the server does not silently produce a different moment here.
- */
-export declare const MAX_DURATION_MAGNITUDE_MS: number;
-/** At most this many signed offsets in one anchor expression. */
-export declare const MAX_ANCHOR_OFFSETS = 8;
-/** Parse one unsigned magnitude (`3w`, `1h30m`). Returns null when invalid. */
-export declare function parseDurationMagnitudeMs(text: string): number | null;
-/**
- * Parse an anchor expression WITHOUT any surface wrapper - `now`, `now+3w`,
- * `now+3w-1d` - and return the summed offset in milliseconds. Returns null when
- * the text is not a valid anchor expression, which the caller surfaces the way
- * it surfaces any unresolved token: by leaving the template visible rather than
- * writing a wrong moment.
- */
-export declare function parseAnchorOffsetMs(expr: string): number | null;

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

@@ -1,43 +0,0 @@
-import type { BrandingTheme } from "../types/api.d.ts";
-/** 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/declarion-core/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/branding.d.ts

@@ -1,20 +0,0 @@
-import type { BrandingChrome, BrandingIdentity, BrandingTheme, PublicBranding, PublicParam, PublicParamsResponse } from "../types/api.d.ts";
-export declare const BRANDING_PARAM_CODE = "branding";
-export declare function paramsToRecord(list: PublicParam[] | undefined): Record<string, unknown>;
-export declare function publicParamValue(publicParams: PublicParamsResponse | undefined, code: string): unknown;
-export declare function getPublicBranding(publicParams: PublicParamsResponse | undefined): PublicBranding | undefined;
-export declare function brandingFromValue(value: unknown): PublicBranding | undefined;
-export declare function getBrandingIdentity(publicParams: PublicParamsResponse | undefined): BrandingIdentity | undefined;
-export declare function getBrandingTheme(publicParams: PublicParamsResponse | undefined): BrandingTheme | undefined;
-export declare function getBrandingChrome(publicParams: PublicParamsResponse | undefined): BrandingChrome | undefined;
-/**
- * Returns true when `value` is a renderable logo URL. Accepts:
- *   - root-relative paths ("/logo.png" or "/modules/<module>/public/logo.png");
- *   - absolute http(s) URLs;
- *   - data:image/... URIs.
- *
- * Rejects inline SVG markup and any other string so callers can't
- * accidentally inject operator-controlled YAML into a dangerouslySet
- * surface. Returns false for null/undefined/empty input.
- */
-export declare function isValidLogoUrl(value: string | undefined | null): boolean;

package/dist-lib/lib/canonical-url.d.ts

@@ -1,27 +0,0 @@
-/** The minimal location shape canonicalUrl needs (a router `Location` satisfies
- *  it; tests can pass a bare object). */
-export interface CanonicalLocation {
-    pathname: string;
-    search?: string;
-}
-/**
- * Build the canonical URL key for a location: normalized pathname + the
- * view-defining query, sorted by key, with the embed transport params removed.
- *
- * Sorting makes `?a=1&b=2` and `?b=2&a=1` one key. Removing `EMBED_PARAM_KEYS`
- * makes the same screen one key whether or not the embed params ride along, so
- * a retained page is shared between the embedded and non-embedded view of the
- * same URL. Default query values are NOT collapsed (which params have a default
- * is screen-specific and collapsing the wrong one would silently merge or fork
- * pages); two URLs that differ only by an explicit-vs-implicit default are
- * treated as distinct, which is safe (at worst slightly less sharing).
- */
-export declare function canonicalUrl(location: CanonicalLocation): string;
-/**
- * The SCREEN-scoped key: the normalized pathname alone, ignoring the query.
- * Coarser than `canonicalUrl` - it does NOT fork when filters/sort/columns
- * change. Used for deep state that must persist ACROSS in-screen query changes
- * (row selection, pruned to the visible result set) rather than resetting per
- * filtered view. Two filter views of the same screen share one screen key.
- */
-export declare function canonicalPath(location: CanonicalLocation): string;

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

@@ -1,6 +0,0 @@
-/**
- * Warm every code-split capability chunk during browser idle time.
- * Idempotent - call once, after the app has mounted.
- */
-export declare function prefetchHeavyCapabilities(): void;
-export declare function __resetCapabilityPrefetchForTests(): void;