@cosmicdrift/kumiko-renderer 0.387.0 → 0.389.0

package/dist/hooks/use-remembered-list-params.d.ts

@@ -0,0 +1,13 @@
+import type { ListStateStore } from "../components/list-state-store.tsx";
+import { type KnownListFields } from "./list-state-schema.ts";
+type RememberedListParamsArgs = {
+    readonly screenId: string;
+    readonly enabled: boolean;
+    readonly store: ListStateStore;
+    readonly known: KnownListFields;
+};
+/** URL stays the source of truth: the stored list params are copied into the
+ *  URL once when the screen opens without any, and every later URL change is
+ *  written back. A link that already carries list params is never overridden. */
+export declare function useRememberedListParams({ screenId, enabled, store, known, }: RememberedListParamsArgs): void;
+export {};

package/dist/hooks/use-remembered-list-params.js

@@ -0,0 +1,53 @@
+import { useEffect, useMemo, useRef } from "react";
+import { useNav } from "../app/nav.js";
+import { listParamKeys } from "./list-reset.js";
+import { sanitizeStoredListState } from "./list-state-schema.js";
+function stripScreenPrefix(params, screenId) {
+    const prefix = `${screenId}.`;
+    return Object.fromEntries(listParamKeys(params, screenId).flatMap((key) => {
+        const value = params[key];
+        return value === undefined ? [] : [[key.slice(prefix.length), value]];
+    }));
+}
+function sameParams(a, b) {
+    const keys = Object.keys(a);
+    return keys.length === Object.keys(b).length && keys.every((key) => a[key] === b[key]);
+}
+/** URL stays the source of truth: the stored list params are copied into the
+ *  URL once when the screen opens without any, and every later URL change is
+ *  written back. A link that already carries list params is never overridden. */
+export function useRememberedListParams({ screenId, enabled, store, known, }) {
+    const nav = useNav();
+    const current = useMemo(() => stripScreenPrefix(nav.searchParams, screenId), [nav.searchParams, screenId]);
+    const phaseRef = useRef({ screenId, phase: "pending" });
+    useEffect(() => {
+        // skip: remembering is not enabled
+        if (!enabled)
+            return;
+        if (phaseRef.current.screenId !== screenId)
+            phaseRef.current = { screenId, phase: "pending" };
+        const state = phaseRef.current;
+        const currentIsEmpty = Object.keys(current).length === 0;
+        if (state.phase === "pending" && currentIsEmpty) {
+            const stored = sanitizeStoredListState(store.read(screenId), known)?.params;
+            if (stored !== undefined && Object.keys(stored).length > 0) {
+                state.phase = "restoring";
+                nav.setSearchParams(Object.fromEntries(Object.entries(stored).map(([k, v]) => [`${screenId}.${k}`, v])));
+                // skip: restore started, effect reruns with the restored URL
+                return;
+            }
+        }
+        // skip: waiting for the restored URL to arrive
+        if (state.phase === "restoring" && currentIsEmpty)
+            return;
+        state.phase = "live";
+        const existing = store.read(screenId);
+        // skip: nothing stored and nothing to store
+        if (existing?.params === undefined && currentIsEmpty)
+            return;
+        // skip: stored state already matches the URL
+        if (existing?.params !== undefined && sameParams(existing.params, current))
+            return;
+        store.write(screenId, { ...existing, params: current });
+    }, [enabled, screenId, current, known, store, nav]);
+}

package/dist/hooks/use-remembered-local-list-state.d.ts

@@ -0,0 +1,26 @@
+import { type Dispatch, type SetStateAction } from "react";
+import type { ListStateStore } from "../components/list-state-store.tsx";
+import { type KnownListFields } from "./list-state-schema.ts";
+import type { ListSort } from "./use-list-url-state.ts";
+type LocalFilters = Readonly<Record<string, readonly string[]>>;
+type LocalListStateArgs = {
+    readonly storeKey: string;
+    readonly store: ListStateStore;
+    /** `table.rememberState`: seeds from the store and writes every change back. */
+    readonly remember: boolean;
+    readonly defaultSort: ListSort | null;
+    readonly known: KnownListFields;
+};
+/** Search, facet filters and sort of a list whose state is component-local
+ *  (relatedList has no URL namespace). Same stored `params` format as the URL lists. */
+export declare function useRememberedLocalListState({ storeKey, store, remember, defaultSort, known, }: LocalListStateArgs): {
+    search: string;
+    filters: LocalFilters;
+    sort: ListSort | null;
+    setSearch: (search: string) => void;
+    setFilters: Dispatch<SetStateAction<Readonly<Record<string, readonly string[]>>>>;
+    setSort: (sort: ListSort | null) => void;
+    reset: () => void;
+    atDefault: boolean;
+};
+export {};

package/dist/hooks/use-remembered-local-list-state.js

@@ -0,0 +1,63 @@
+import { useCallback, useEffect, useState } from "react";
+import { sanitizeStoredListState } from "./list-state-schema.js";
+const FILTER_PREFIX = "f.";
+function sameSort(a, b) {
+    return a === b || (a !== null && b !== null && a.field === b.field && a.dir === b.dir);
+}
+function toParams(state, defaultSort) {
+    const params = {};
+    if (state.search !== "")
+        params["q"] = state.search;
+    if (!sameSort(state.sort, defaultSort) && state.sort !== null) {
+        params["sort"] = state.sort.field;
+        params["dir"] = state.sort.dir;
+    }
+    for (const [field, values] of Object.entries(state.filters)) {
+        if (values.length > 0)
+            params[`${FILTER_PREFIX}${field}`] = values.join(",");
+    }
+    return params;
+}
+function fromParams(params, defaultSort) {
+    const sortField = params?.["sort"];
+    const dir = params?.["dir"];
+    const sort = sortField !== undefined && (dir === "asc" || dir === "desc")
+        ? { field: sortField, dir }
+        : defaultSort;
+    const filters = {};
+    for (const [key, value] of Object.entries(params ?? {})) {
+        if (key.startsWith(FILTER_PREFIX)) {
+            filters[key.slice(FILTER_PREFIX.length)] = value.split(",").filter((v) => v !== "");
+        }
+    }
+    return { search: params?.["q"] ?? "", filters, sort };
+}
+/** Search, facet filters and sort of a list whose state is component-local
+ *  (relatedList has no URL namespace). Same stored `params` format as the URL lists. */
+export function useRememberedLocalListState({ storeKey, store, remember, defaultSort, known, }) {
+    const [state, setState] = useState(() => remember
+        ? fromParams(sanitizeStoredListState(store.read(storeKey), known)?.params, defaultSort)
+        : { search: "", filters: {}, sort: defaultSort });
+    useEffect(() => {
+        // skip: remembering is not enabled
+        if (!remember)
+            return;
+        const params = toParams(state, defaultSort);
+        const existing = store.read(storeKey);
+        // skip: nothing stored and nothing to store
+        if (existing?.params === undefined && Object.keys(params).length === 0)
+            return;
+        store.write(storeKey, { ...existing, params });
+    }, [remember, state, defaultSort, store, storeKey]);
+    const setSearch = useCallback((search) => setState((prev) => ({ ...prev, search })), []);
+    const setFilters = useCallback((next) => setState((prev) => ({
+        ...prev,
+        filters: typeof next === "function" ? next(prev.filters) : next,
+    })), []);
+    const setSort = useCallback((sort) => setState((prev) => ({ ...prev, sort })), []);
+    const reset = useCallback(() => setState({ search: "", filters: {}, sort: defaultSort }), [defaultSort]);
+    const atDefault = state.search === "" &&
+        Object.values(state.filters).every((values) => values.length === 0) &&
+        sameSort(state.sort, defaultSort);
+    return { ...state, setSearch, setFilters, setSort, reset, atDefault };
+}

package/dist/i18n-defaults.js

@@ -1,6 +1,10 @@
-// Framework default bundle. These strings are required by renderer components (Save/Cancel/Delete buttons, empty states, search placeholder, navigation-toggle ARIA labels, and validation reasons). createKumikoApp adds this as the last fallback in LocaleProvider, while apps can override individual keys via clientFeatures.translations.
+// Framework default bundle. These strings are required by renderer components (Save/Cancel/Delete
+// buttons, empty states, search placeholder, navigation-toggle ARIA labels, and validation
+// reasons). createKumikoApp adds this as the last fallback in LocaleProvider, while apps can
+// override individual keys via clientFeatures.translations.
 //
-// All keys use the `kumiko.` prefix to avoid collisions with app keys. Subpaths group keys by area (actions / list / nav / form / validation).
+// All keys use the `kumiko.` prefix to avoid collisions with app keys. Subpaths group keys by area
+// (actions / list / nav / form / validation).
 export const kumikoDefaultTranslations = {
     en: {
         "kumiko.actions.save": "Save",
@@ -82,6 +86,44 @@ export const kumikoDefaultTranslations = {
         "kumiko.list.sort.unsorted": "Unsorted",
         "kumiko.list.filter.reset": "Reset",
         "kumiko.list.filter.toggle": "Filters",
+        "kumiko.list.reset-all": "Reset",
+        "kumiko.list.export": "Export",
+        "kumiko.list.export-busy": "Exporting…",
+        "kumiko.list.export-too-many": "More than {max} rows. Narrow the list with a filter and export again.",
+        "kumiko.list.export-failed": "The export failed. Please try again.",
+        "kumiko.list.view.menu": "View",
+        "kumiko.list.view.columns": "Columns",
+        "kumiko.list.view.density": "Density",
+        "kumiko.list.view.density.comfortable": "Comfortable",
+        "kumiko.list.view.density.compact": "Compact",
+        "kumiko.list.view.reset": "Reset view",
+        "kumiko.list.group.by": "Group by",
+        "kumiko.list.group.none": "None",
+        "kumiko.list.group.empty": "(empty)",
+        "kumiko.list.group.load-more": "Load more",
+        "kumiko.list.group.loading": "Loading…",
+        "kumiko.list.group.loaded": "{loaded} of {count}",
+        "kumiko.list.measure.sum": "Sum of {label}",
+        "kumiko.list.measure.avg": "Average {label}",
+        "kumiko.list.measure.count": "Count",
+        "kumiko.list.measure.min": "Minimum {label}",
+        "kumiko.list.measure.max": "Maximum {label}",
+        "kumiko.list.measure.kind.sum": "Sum",
+        "kumiko.list.measure.kind.avg": "Average",
+        "kumiko.list.measure.kind.count": "Count",
+        "kumiko.list.measure.kind.min": "Minimum",
+        "kumiko.list.measure.kind.max": "Maximum",
+        "kumiko.list.totals.label": "Total",
+        "kumiko.list.range.min": "From",
+        "kumiko.list.range.max": "To",
+        "kumiko.list.notice.truncated": "Not every group is shown. Please narrow the list with a filter.",
+        "kumiko.list.notice.searchTruncated": "The search matched too many entries; groups and totals cover only part of them. Please filter further.",
+        "kumiko.list.view.column.move-up": "Move {column} up",
+        "kumiko.list.view.pinning": "Pinned columns",
+        "kumiko.list.view.pin-left": "Pin {column} left",
+        "kumiko.list.view.pin-right": "Pin {column} right",
+        "kumiko.list.column.resize": "Resize {column}",
+        "kumiko.list.view.column.move-down": "Move {column} down",
         "kumiko.list.related-list-truncated": "Showing the first {count} entries. More are available but not loaded — this list does not paginate.",
         "kumiko.reference.system-tenant": "System",
         "kumiko.reference.system-user": "System",
@@ -107,6 +149,21 @@ export const kumikoDefaultTranslations = {
         "kumiko.theme.light": "Light theme",
         "kumiko.list.row.collapse": "Collapse {title}",
         "kumiko.list.row.expand": "Expand {title}",
+        "kumiko.list.bulk.selected": "{count} selected",
+        "kumiko.list.bulk.clear": "Clear selection",
+        "kumiko.list.bulk.limit": "At most {max} rows per selection",
+        "kumiko.list.bulk.select-all": "Select all rows on this page",
+        "kumiko.list.bulk.select-row": "Select {title}",
+        "kumiko.list.bulk.progress": "{settled} of {total} done",
+        "kumiko.list.bulk.cancel": "Cancel",
+        "kumiko.list.bulk.cancelling": "Cancelling…",
+        "kumiko.list.bulk.confirm": "Run “{action}” on the selection ({count})?",
+        "kumiko.list.bulk.result.title": "“{action}” finished",
+        "kumiko.list.bulk.result.succeeded": "Succeeded: {count}",
+        "kumiko.list.bulk.result.failed": "Failed: {count}",
+        "kumiko.list.bulk.result.skipped": "Skipped: {count}",
+        "kumiko.list.bulk.result.not-started": "Not run: {count}",
+        "kumiko.list.bulk.result.dismiss": "Dismiss",
         "kumiko.list.sort.by": "Sorted by {column}",
         "kumiko.form.changed": "changed",
         "kumiko.form.on-this-page": "On this page",

package/dist/index.d.ts

@@ -2,6 +2,8 @@ export { type Formality, formalLocaleTag } from "@cosmicdrift/kumiko-framework/u
 export { synthesizeActionFormEntity, synthesizeActionFormScreen } from "./app/action-form-shim.ts";
 export type { AppFeaturesProviderProps } from "./app/app-features-context.tsx";
 export { AppFeaturesProvider, useAppFeatures } from "./app/app-features-context.tsx";
+export { normalizeBasePath, prependBasePath, stripBasePath } from "./app/base-path.ts";
+export { BasePathProvider, useBasePath } from "./app/base-path-context.tsx";
 export type { ActionNotice, ActionNotifier, ClientActionHandler, ClientActionOutcome, ClientActionRuntime, ClientActionsMap, } from "./app/client-actions.tsx";
 export { ActionNoticeProvider, ClientActionsProvider, runClientAction, useClientActionHandler, useClientActionRuntime, } from "./app/client-actions.tsx";
 export type { ColumnRendererComponent, ColumnRendererProps, ColumnRenderersMap, ColumnRenderersProviderProps, } from "./app/column-renderers.tsx";
@@ -14,6 +16,7 @@ export type { CustomScreensMap, CustomScreensProviderProps } from "./app/custom-
 export { CustomScreensProvider, useCustomScreenComponent } from "./app/custom-screens.tsx";
 export type { DashboardBodyProps, DashboardBodyProviderProps } from "./app/dashboard-body.tsx";
 export { DashboardBodyProvider, useDashboardBody } from "./app/dashboard-body.tsx";
+export { type TenantCurrencyResolution, useTenantCurrency } from "./app/entity-edit-prefill.ts";
 export { type ErrorNotice, ErrorReference, errorNoticeOf } from "./app/error-reference.tsx";
 export type { ExtensionFormRegistry, ExtensionFormSubmitHandler, ExtensionSubmitContext, ExtensionSubmitResult, } from "./app/extension-form-submit.tsx";
 export { ExtensionFormRegistryProvider, useExtensionFormSubmit, } from "./app/extension-form-submit.tsx";
@@ -85,7 +88,7 @@ export { InsideDrawerProvider, useInsideDrawer } from "./inside-drawer.ts";
 export { hasUnsavedInput, registerUnsavedInputSource, requestLeave, setLeaveConfirmer, useUnsavedInputSource, } from "./leave-guard.ts";
 export { LeaveGuardDialog } from "./leave-guard-dialog.tsx";
 export { PageHeaderCompactProvider, PageHeaderSlotAvailableProvider, usePageHeaderCompact, usePageHeaderSlotAvailable, } from "./page-header-slot.ts";
-export type { ActionMenuItemSpec, ActionOverflowMenuProps, AppPrimitives, BannerProps, ButtonProps, CardOptions, CardProps, CardSlots, CopyButtonProps, CorePrimitives, DataTableDateRangeFacet, DataTableFacet, DataTableFacetChip, DataTableProps, DataTableRowAction, DataTableRowActionMode, DataTableRowGrouping, DataTableSort, DataTableSortDir, DialogProps, DrawerProps, EmbeddedListCellType, EmbeddedListColumn, EmbeddedListInputProps, EmbeddedListTotal, FieldCellWidth, FieldProps, FileValueListProps, FillContainerProps, FooterActionMarker, FooterActionRole, FormProps, FormSectionNavItem, FormWidth, GridCellProps, GridProps, HeadingProps, InputFillAction, InputProps, JsonViewProps, LightboxImage, LightboxProps, LinkProps, MetricBandProps, MetricProps, ModalProps, PageHeaderProps, PickedFile, PrimitivesProviderProps, PrimitivesRegistry, ProgressProps, ProgressTone, PromoPanelAction, PromoPanelProps, RuntimeRenderer, SecretRevealProps, SecretRevealValue, SectionProps, ShareButtonProps, StatusBadgeProps, StatusTone, StepBarProps, StickyActionBarProps, StickyPrimaryActionMarker, TabsProps, TextProps, TrailingInputAction, WizardStepGroupProps, } from "./primitives.tsx";
+export type { ActionMenuItemSpec, ActionOverflowMenuProps, AppPrimitives, BannerProps, BulkRowOutcome, ButtonProps, CardOptions, CardProps, CardSlots, CopyButtonProps, CorePrimitives, DataTableBulk, DataTableBulkAction, DataTableDateRangeFacet, DataTableFacet, DataTableFacetChip, DataTableProps, DataTableRowAction, DataTableRowActionMode, DataTableSort, DataTableSortDir, DialogProps, DrawerProps, EmbeddedListCellType, EmbeddedListColumn, EmbeddedListInputProps, EmbeddedListTotal, FieldCellWidth, FieldProps, FileValueListProps, FillContainerProps, FooterActionMarker, FooterActionRole, FormProps, FormSectionNavItem, FormWidth, GridCellProps, GridProps, HeadingProps, InputFillAction, InputProps, JsonViewProps, LightboxImage, LightboxProps, LinkProps, MetricBandProps, MetricProps, ModalProps, PageHeaderProps, PickedFile, PrimitivesProviderProps, PrimitivesRegistry, ProgressProps, ProgressTone, PromoPanelAction, PromoPanelProps, RuntimeRenderer, SecretRevealProps, SecretRevealValue, SectionProps, ShareButtonProps, StatusBadgeProps, StatusTone, StepBarProps, StickyActionBarProps, StickyPrimaryActionMarker, TabsProps, TextProps, TrailingInputAction, WizardStepGroupProps, } from "./primitives.tsx";
 export { FOOTER_ACTION_ROLE_PROP, NARROW_LABEL_PROP, PrimitivesProvider, STICKY_PRIMARY_ACTION_PROP, shouldRenderActionsIconOnly, statusToneForOptionTone, statusToneForValue, useOptionalPrimitives, usePrimitives, } from "./primitives.tsx";
 export type { SessionEndedSignal, SessionEndedSignalProviderProps, } from "./session/session-ended.tsx";
 export { createSessionEndedSignal, isSessionEndedError, SESSION_ENDED_ERROR_CODES, SessionEndedSignalProvider, useSessionEndedSignal, withSessionEndedDetection, } from "./session/session-ended.tsx";

package/dist/index.js

@@ -11,12 +11,15 @@
 export { formalLocaleTag } from "@cosmicdrift/kumiko-framework/ui-types";
 export { synthesizeActionFormEntity, synthesizeActionFormScreen } from "./app/action-form-shim.js";
 export { AppFeaturesProvider, useAppFeatures } from "./app/app-features-context.js";
+export { normalizeBasePath, prependBasePath, stripBasePath } from "./app/base-path.js";
+export { BasePathProvider, useBasePath } from "./app/base-path-context.js";
 export { ActionNoticeProvider, ClientActionsProvider, runClientAction, useClientActionHandler, useClientActionRuntime, } from "./app/client-actions.js";
 export { ColumnRenderersProvider, useColumnRenderer } from "./app/column-renderers.js";
 export { CONTENT_EDITOR_ELEMENT_ID, ContentEditorsProvider, TextareaContentEditor, useContentEditor, } from "./app/content-editors.js";
 export { ContentPreview, substituteVariables } from "./app/content-preview.js";
 export { CustomScreensProvider, useCustomScreenComponent } from "./app/custom-screens.js";
 export { DashboardBodyProvider, useDashboardBody } from "./app/dashboard-body.js";
+export { useTenantCurrency } from "./app/entity-edit-prefill.js";
 export { ErrorReference, errorNoticeOf } from "./app/error-reference.js";
 export { ExtensionFormRegistryProvider, useExtensionFormSubmit, } from "./app/extension-form-submit.js";
 export { ExtensionSectionsProvider, extensionSectionName, useExtensionSectionComponent, } from "./app/extension-sections.js";

package/dist/primitives.d.ts

@@ -1,6 +1,9 @@
 import type { ConfigCascade, ConfigScope, ConfigValueSource } from "@cosmicdrift/kumiko-framework/engine";
 import type { FieldIconKey, FormWidth, IconKey, NavIconKey, RowActionDisplay, SelectOptionTone } from "@cosmicdrift/kumiko-framework/ui-types";
 import { type ComponentType, type FormEvent, type KeyboardEvent, type ReactNode, type Ref } from "react";
+import type { DataTableBulk } from "./data-table-bulk-types.ts";
+import type { DataTableDateRangeFacet, DataTableFacet } from "./data-table-facet-types.ts";
+import type { DataTableTableBlock } from "./data-table-view-types.ts";
 import type { FieldIssue, ListColumnViewModel, ListRowViewModel, RuntimeRenderer } from "./headless/index.ts";
 export type { RuntimeRenderer };
 /** Escape hatch for `data-*` test hooks (e.g. an E2E selector) that don't
@@ -203,6 +206,7 @@ export type InputProps = {
     readonly name: string;
     readonly value: string;
     readonly onChange: (v: string) => void;
+    readonly autoFocus?: boolean;
     readonly disabled?: boolean;
     readonly required?: boolean;
     readonly hasError?: boolean;
@@ -228,6 +232,24 @@ export type InputProps = {
     /** Raw keydown access (e.g. Enter-to-submit at the field instead of
      *  the surrounding Form). Forwarded to the element. */
     readonly onKeyDown?: (event: KeyboardEvent<HTMLInputElement>) => void;
+} | {
+    /** Fixed-length numeric one-time code. `onComplete` fires once when input,
+     *  paste or autofill brings the value to full length; the value holds
+     *  digits only. */
+    readonly kind: "code";
+    readonly id: string;
+    readonly name: string;
+    readonly value: string;
+    readonly onChange: (v: string) => void;
+    readonly length: number;
+    readonly onComplete?: (code: string) => void;
+    readonly autoFocus?: boolean;
+    readonly disabled?: boolean;
+    readonly required?: boolean;
+    readonly hasError?: boolean;
+    readonly testId?: string;
+    /** Default "one-time-code". */
+    readonly autoComplete?: string;
 } | {
     readonly kind: "email";
     readonly id: string;
@@ -628,55 +650,11 @@ export type DataTableRowAction = {
 export declare function shouldRenderActionsIconOnly(actions: readonly {
     readonly icon?: IconKey;
 }[]): boolean;
-export type DataTableFacet = {
-    /** Entity-Feldname (= URL-State-Key + payload.filters[].field). */
-    readonly field: string;
-    /** Translated Button-Label ("Status", "Active"). */
-    readonly label: string;
-    /** Selectable values with display labels. `value` is the raw filter value
-     *  (a select option or `"true"`/`"false"`), transported as a string. */
-    readonly options: readonly {
-        readonly value: string;
-        readonly label: string;
-    }[];
-    /** Present: render the facet as a row of single-choice toggle chips instead
-     *  of a dropdown. A chip is pressed while the selection equals its values. */
-    readonly chips?: readonly DataTableFacetChip[];
-    /** Chips only: show each chip's `count` next to its label. */
-    readonly showCounts?: boolean;
-    /** Chips only: hide chips whose `count` is 0 (unless pressed). */
-    readonly hideEmpty?: boolean;
-};
-export type DataTableFacetChip = {
-    readonly id: string;
-    /** Translated chip label. */
-    readonly label: string;
-    /** Selection a click sets; `[]` clears the facet. */
-    readonly values: readonly string[];
-    /** Matching row count, undefined while unknown. */
-    readonly count?: number;
-};
-export type DataTableDateRangeFacet = {
-    /** The facet's namespace (its date field) — a key, not a filter value. */
-    readonly field: string;
-    /** Translated label ("When"). */
-    readonly label: string;
-    readonly from: string;
-    readonly to: string;
-};
-/** Splits rows into collapsible groups (order of first appearance). A
- *  renderer without grouping support shows the flat list. A group whose
- *  `headerLabel` is undefined shows its rows without a header and never
- *  collapses. */
-export type DataTableRowGrouping = {
-    readonly keyOf: (row: ListRowViewModel) => string;
-    readonly headerLabel: (groupKey: string, rows: readonly ListRowViewModel[]) => string | undefined;
-    readonly startsCollapsed: (groupKey: string) => boolean;
-};
+export type { BulkRowOutcome, DataTableBulk, DataTableBulkAction, } from "./data-table-bulk-types.ts";
+export type { DataTableDateRangeFacet, DataTableFacet, DataTableFacetChip, } from "./data-table-facet-types.ts";
 export type DataTableProps = {
     readonly columns: readonly ListColumnViewModel[];
     readonly rows: readonly ListRowViewModel[];
-    readonly rowGrouping?: DataTableRowGrouping;
     /** Tints a row. Renderers without row tinting ignore it. */
     readonly rowTone?: (row: ListRowViewModel) => SelectOptionTone | undefined;
     readonly onRowClick?: (row: ListRowViewModel) => void;
@@ -704,6 +682,8 @@ export type DataTableProps = {
      *    kebab). Actions then sit at the same x-position across all rows
      *    (no drifting with label width) and all lists in an app look alike. */
     readonly rowActionMode?: DataTableRowActionMode;
+    /** Present: row checkboxes plus a selection bar that runs these actions once per selected row. */
+    readonly bulk?: DataTableBulk;
     /** Custom empty-state content (e.g. Icon + Heading + CTA-Button).
      *  The default renderer wraps it in a dashed-border box. */
     readonly emptyState?: ReactNode;
@@ -813,7 +793,8 @@ export type DataTableProps = {
     /** Content of the area under an expanded row. Native renderers implement
      *  the same three props. */
     readonly renderExpandedRow?: (row: ListRowViewModel) => ReactNode;
-};
+} & DataTableTableBlock;
+export type DataTableTableBlockProps = Pick<DataTableProps, keyof DataTableTableBlock>;
 /** Cell type for one column of an embedded-list field. Mirrors
  *  EmbeddedListCellViewModel["type"] from `@cosmicdrift/kumiko-renderer/headless`. */
 export type EmbeddedListCellType = "text" | "number" | "boolean" | "date" | "money" | "decimal" | "select" | "reference" | "timestamp";
@@ -1384,6 +1365,8 @@ export type JsonViewProps = {
  *  PDFs, an inline preview. Used for `renderer: { format: "file" }` on a detail field. */
 export type FileValueListProps = {
     readonly fileIds: readonly string[];
+    /** Starts the inline PDF preview of the first file open. */
+    readonly previewOpenByDefault?: boolean;
     readonly testId?: string;
 };
 /** Band above the tabs of a record detail: optional subtitle line plus the

package/dist/web/app/create-app.d.ts

@@ -92,6 +92,11 @@ export type CreateKumikoAppOptions = {
         readonly hasWorkspaces?: boolean;
         readonly features?: readonly FeatureSchema[];
     }) => NavApi;
+    /** URL prefix the app is mounted under (for example "/admin"). The default nav adapter reads
+     *  and writes URLs relative to it, and the auth gates and pages, which sit outside the
+     *  NavProvider, use it to match and build their paths. A custom `navAdapter` handles its own
+     *  prefix. */
+    readonly basePath?: string;
     /** App-wide default width for form/detail screens that don't set their
      *  own `layout.width`. Default "4xl" (unchanged behavior) — a
      *  consumer app that wants e.g. bundled-feature screens to match its own

package/dist/web/app/create-app.js

@@ -3,9 +3,10 @@ import { isOpenToAllGranted } from "@cosmicdrift/kumiko-framework/ui-types";
 import { createContext, useContext, useEffect, useMemo, useRef, useState, } from "react";
 import { createRoot } from "react-dom/client";
 import { rendererError, rendererWarn } from "../../dev-console.js";
-import { AppFeaturesProvider, ClientActionsProvider, ColumnRenderersProvider, ContentEditorsProvider, CustomScreensProvider, createSessionEndedSignal, DashboardBodyProvider, DispatcherProvider, DraftStorageProvider, ErrorBoundary, ExtensionSectionsProvider, hasDetailScreen, KumikoScreen, kumikoDefaultTranslations, LeaveGuardDialog, LiveEventsProvider, LocaleProvider, mergeTranslations, NavProvider, navigateWithReturnTo, PrimitivesProvider, qualifyScreenId, ScreenMissingState, SessionEndedSignalProvider, TokensProvider, toAppSchema, translationsByLocaleFromKeys, useNav, usePrimitives, useTranslation, withSessionEndedDetection, } from "../../index.js";
+import { AppFeaturesProvider, BasePathProvider, ClientActionsProvider, ColumnRenderersProvider, ContentEditorsProvider, CustomScreensProvider, createSessionEndedSignal, DashboardBodyProvider, DispatcherProvider, DraftStorageProvider, ErrorBoundary, ExtensionSectionsProvider, hasDetailScreen, KumikoScreen, kumikoDefaultTranslations, LeaveGuardDialog, LiveEventsProvider, LocaleProvider, mergeTranslations, NavProvider, navigateWithReturnTo, PrimitivesProvider, qualifyScreenId, ScreenMissingState, SessionEndedSignalProvider, TokensProvider, toAppSchema, translationsByLocaleFromKeys, useNav, usePrimitives, useTranslation, withSessionEndedDetection, } from "../../index.js";
 import { createLiveDispatcher } from "../../live/index.js";
 import { lastSegment } from "../layout/nav-tree.js";
+import { clearFileMetaCache } from "../primitives/file-thumbnail.js";
 import { defaultPrimitives, ScreenWidthProvider } from "../primitives/index.js";
 import { ToastProvider } from "../primitives/toast.js";
 import { createEventSourceLiveEvents } from "../sse/live-events.js";
@@ -18,6 +19,7 @@ import { stackWrappers } from "./client-plugin.js";
 import { WebDashboardBody } from "./dashboard-body.js";
 import { DocumentLangSync } from "./document-lang-sync.js";
 import { createBrowserDraftStorage } from "./draft-storage.js";
+import { ListStateStoreBoot } from "./list-state-store-boot.js";
 import { useBrowserNavApi } from "./nav.js";
 import { NavProvidersProvider } from "./nav-providers-context.js";
 import { ResolversProvider } from "./resolvers-context.js";
@@ -236,7 +238,7 @@ function KumikoAppRoot(props) {
             warnMissingCustomScreens(loaded, props.customScreens);
             setApp(loaded);
         }, schemaIsRoleProjected: isFetchMode, ...(isFetchMode && { onUnmountResetSchema: () => setApp(undefined) }), ...(props.translate !== undefined && { translate: props.translate }), ...(props.onRowClick !== undefined && { onRowClick: props.onRowClick }), ...(props.shell !== undefined && { shell: props.shell }) }));
-    return (_jsx(TokensBoot, { children: _jsxs(LocaleProvider, { resolver: props.localeResolver, fallbackBundles: fallbackBundles, children: [_jsx(DocumentLangSync, { resolver: props.localeResolver }), _jsx(PrimitivesProvider, { value: props.primitives, children: _jsx(ScreenWidthProvider, { width: props.screenWidth, children: _jsx(AppFeaturesProvider, { features: app?.features ?? EMPTY_FEATURES, children: _jsx(DispatcherProvider, { dispatcher: props.dispatcher, children: _jsx(DraftStorageProvider, { value: props.draftStorage, children: _jsx(LiveEventsProvider, { value: props.liveEvents, children: _jsx(DashboardBodyProvider, { value: WebDashboardBody, children: _jsx(CustomScreensProvider, { value: props.customScreens, children: _jsx(ColumnRenderersProvider, { value: props.columnRenderers, children: _jsx(ContentEditorsProvider, { value: props.contentEditors, children: _jsx(ExtensionSectionsProvider, { value: props.extensionSectionComponents, children: _jsx(ClientActionsProvider, { value: props.clientActions, children: _jsx(NavProvidersProvider, { value: navProviders, entities: navEntities, children: _jsx(ResolversProvider, { resolvers: props.resolvers, children: _jsx(ToastProvider, { children: _jsxs(ToastActionNotifier, { children: [_jsx(UpdateChecker, {}), _jsx(LeaveGuardDialog, {}), _jsx(SessionEndedSignalProvider, { signal: props.sessionEndedSignal, children: stackWrappers(props.providers, stackWrappers(props.gates, screenNode)) })] }) }) }) }) }) }) }) }) }) }) }) }) }) }) }) })] }) }));
+    return (_jsx(TokensBoot, { children: _jsxs(LocaleProvider, { resolver: props.localeResolver, fallbackBundles: fallbackBundles, children: [_jsx(DocumentLangSync, { resolver: props.localeResolver }), _jsx(PrimitivesProvider, { value: props.primitives, children: _jsx(ScreenWidthProvider, { width: props.screenWidth, children: _jsx(AppFeaturesProvider, { features: app?.features ?? EMPTY_FEATURES, children: _jsx(DispatcherProvider, { dispatcher: props.dispatcher, children: _jsx(DraftStorageProvider, { value: props.draftStorage, children: _jsx(LiveEventsProvider, { value: props.liveEvents, children: _jsx(DashboardBodyProvider, { value: WebDashboardBody, children: _jsx(CustomScreensProvider, { value: props.customScreens, children: _jsx(ColumnRenderersProvider, { value: props.columnRenderers, children: _jsx(ContentEditorsProvider, { value: props.contentEditors, children: _jsx(ExtensionSectionsProvider, { value: props.extensionSectionComponents, children: _jsx(ClientActionsProvider, { value: props.clientActions, children: _jsx(NavProvidersProvider, { value: navProviders, entities: navEntities, children: _jsx(ResolversProvider, { resolvers: props.resolvers, children: _jsx(ToastProvider, { children: _jsxs(ToastActionNotifier, { children: [_jsx(UpdateChecker, {}), _jsx(LeaveGuardDialog, {}), _jsx(SessionEndedSignalProvider, { signal: props.sessionEndedSignal, children: stackWrappers(props.providers, stackWrappers(props.gates, _jsx(ListStateStoreBoot, { children: screenNode }))) })] }) }) }) }) }) }) }) }) }) }) }) }) }) }) }) })] }) }));
 }
 // Sits INSIDE the clientFeature gates (e.g. an auth gate) — a gate that
 // renders a login placeholder instead of children keeps this component
@@ -255,9 +257,13 @@ function AppSchemaBoundary({ app, screenQn, schemaUrl, navAdapter, onAppLoaded,
     onUnmountResetSchemaRef.current = onUnmountResetSchema;
     // A real unmount (the gate withdrawing children, e.g. on logout) resets
     // the schema so the next mount re-fetches instead of reusing this
-    // session's — fetch-mode only, see isFetchMode in KumikoAppRoot.
+    // session's — fetch-mode only, see isFetchMode in KumikoAppRoot. The file
+    // meta cache is dropped in every mode.
     useEffect(() => {
-        return () => onUnmountResetSchemaRef.current?.();
+        return () => {
+            clearFileMetaCache();
+            onUnmountResetSchemaRef.current?.();
+        };
     }, []);
     if (app === undefined) {
         return (_jsx(AppSchemaFetchBoot, { onLoaded: onAppLoaded, ...(schemaUrl !== undefined && { schemaUrl }) }));
@@ -335,7 +341,9 @@ export function createKumikoApp(options = {}) {
         }
     }
     const localeResolver = options.locale ?? createBrowserLocaleResolver();
-    const navAdapter = options.navAdapter ?? useBrowserNavApi;
+    const { basePath } = options;
+    const useBrowserNavApiWithBasePath = (navOptions) => useBrowserNavApi({ ...navOptions, ...(basePath !== undefined && { basePath }) });
+    const navAdapter = options.navAdapter ?? useBrowserNavApiWithBasePath;
     const reporter = options.reportClientErrors === false ? undefined : createClientErrorReporter();
     reporter?.installGlobalHandlers();
     const handleBoundaryError = (error, info, context) => {
@@ -348,7 +356,7 @@ export function createKumikoApp(options = {}) {
         options.onError?.(error, info, context);
     };
     const root = createRoot(container);
-    root.render(_jsx(ErrorBoundary, { scope: "root", onError: handleBoundaryError, fallback: ({ errorId }) => _jsx(RootErrorFallback, { errorId: errorId }), children: _jsx(BoundaryErrorHandlerContext.Provider, { value: handleBoundaryError, children: _jsx(KumikoAppRoot, { initialApp: initialApp, screenQn: options.screenQn, ...(options.schemaUrl !== undefined && { schemaUrl: options.schemaUrl }), clientFeatures: clientFeatures, providers: providers, gates: gates, customScreens: customScreens, columnRenderers: columnRenderers, extensionSectionComponents: extensionSectionComponents, clientActions: clientActions, contentEditors: contentEditors, resolvers: resolvers, dispatcher: dispatcher, sessionEndedSignal: sessionEndedSignal, draftStorage: draftStorage, primitives: primitives, liveEvents: liveEvents, localeResolver: localeResolver, navAdapter: navAdapter, screenWidth: options.screenWidth, ...(options.translate !== undefined && { translate: options.translate }), ...(options.onRowClick !== undefined && { onRowClick: options.onRowClick }), ...(options.shell !== undefined && { shell: options.shell }) }) }) }));
+    root.render(_jsx(ErrorBoundary, { scope: "root", onError: handleBoundaryError, fallback: ({ errorId }) => _jsx(RootErrorFallback, { errorId: errorId }), children: _jsx(BoundaryErrorHandlerContext.Provider, { value: handleBoundaryError, children: _jsx(BasePathProvider, { basePath: basePath, children: _jsx(KumikoAppRoot, { initialApp: initialApp, screenQn: options.screenQn, ...(options.schemaUrl !== undefined && { schemaUrl: options.schemaUrl }), clientFeatures: clientFeatures, providers: providers, gates: gates, customScreens: customScreens, columnRenderers: columnRenderers, extensionSectionComponents: extensionSectionComponents, clientActions: clientActions, contentEditors: contentEditors, resolvers: resolvers, dispatcher: dispatcher, sessionEndedSignal: sessionEndedSignal, draftStorage: draftStorage, primitives: primitives, liveEvents: liveEvents, localeResolver: localeResolver, navAdapter: navAdapter, screenWidth: options.screenWidth, ...(options.translate !== undefined && { translate: options.translate }), ...(options.onRowClick !== undefined && { onRowClick: options.onRowClick }), ...(options.shell !== undefined && { shell: options.shell }) }) }) }) }));
     return { root };
 }
 // TokensBoot uses the browser-backed TokensApi hook (class-based
@@ -498,7 +506,7 @@ function RoutedScreen({ app, fallbackQn, translate, onRowClick, }) {
     }, [nav]);
     if (feature === undefined || activeScreen === undefined) {
         const landingExists = findOwnerFeature(app.features, fallbackQn) !== undefined;
-        return (_jsx(ScreenMissingState, { ...(landingExists && { homeScreenId: lastSegment(fallbackQn) }), screenQn: qn }));
+        return (_jsx(ScreenMissingState, { ...(landingExists && { homeScreenId: lastSegment(fallbackQn) }), screenQn: nav.route?.screenId ?? qn }));
     }
     // KumikoScreen takes a single-feature schema: the feature owning the active screen.
     const schemaForScreen = feature;

package/dist/web/app/dashboard-body.js

@@ -140,6 +140,20 @@ function useVisibilityGateResults() {
     }, []);
     return { results, report, forget };
 }
+const NOOP_REFETCH = async () => { };
+// A gate reports through an effect, so for its first commit (and after a payload change) no
+// result exists yet; without a placeholder that reads as "hidden" and flashes the fallback.
+function withPendingGates(results, gateKeys) {
+    if (gateKeys.every((key) => results.has(key)))
+        return results;
+    const merged = new Map(results);
+    for (const key of gateKeys) {
+        if (!merged.has(key)) {
+            merged.set(key, { data: null, error: null, loading: true, refetch: NOOP_REFETCH });
+        }
+    }
+    return merged;
+}
 function distinctVisibilityGates(panels, screenParams) {
     const gates = new Map();
     for (const panel of panels) {
@@ -227,6 +241,8 @@ export function WebDashboardBody({ featureName, screen, translate, }) {
     const { loadedAtMs, reportLoaded } = useLoadedAt(screenParams);
     const visibilityGates = distinctVisibilityGates(screen.panels, screenParams);
     const gateResults = useVisibilityGateResults();
+    const gateKeysSignature = visibilityGates.map((gate) => gate.key).join("\n");
+    const gateResultsWithPending = useMemo(() => withPendingGates(gateResults.results, gateKeysSignature === "" ? [] : gateKeysSignature.split("\n")), [gateResults.results, gateKeysSignature]);
     // The record query is not a panel query: it needs the interval before the
     // registry context below exists, and `refresh.field` reads from its own row.
     const [refreshIntervalMs, setRefreshIntervalMs] = useState(() => resolveRefreshIntervalMs(screen.refresh, null));
@@ -271,7 +287,7 @@ export function WebDashboardBody({ featureName, screen, translate, }) {
     // The shell header owns the title; the badge and the actions sit in it there.
     const badgeInHeader = scopeBadge !== null && usesPageHeaderSlot;
     const showPageHeader = usesPageHeaderSlot && (badgeInHeader || recordTitle !== undefined || headerActionsBar !== null);
-    return (_jsx(PanelLoadedContext.Provider, { value: reportLoaded, children: _jsx(DashboardQueryContext.Provider, { value: queryRuntime, children: _jsxs(PageSection, { className: "flex flex-col gap-4", testId: `dashboard-${screen.id}`, children: [showPageHeader && (_jsx(PageHeader, { ...(recordTitle !== undefined && { title: recordTitle }), ...(badgeInHeader && { status: scopeBadge }), ...(headerActionsBar !== null && { actions: headerActionsBar }) })), _jsxs("div", { className: "flex flex-wrap items-end justify-between gap-3", children: [_jsxs("div", { className: "flex min-w-0 flex-wrap items-center gap-2", children: [!usesPageHeaderSlot && recordTitle !== undefined && (_jsx(Heading, { variant: "page", testId: `dashboard-${screen.id}-record-title`, children: recordTitle })), !badgeInHeader && scopeBadge, picker] }), _jsxs("div", { className: "flex flex-wrap items-center gap-3", children: [!usesPageHeaderSlot && headerActionsBar, screen.showUpdatedAt !== false && (_jsx("span", { "data-testid": `dashboard-${screen.id}-updated-at`, className: "text-xs tabular-nums text-muted-foreground", children: t("kumiko.dashboard.updated-at", { time: formatDateTime(loadedAtMs) }) })), rangeControl] })] }), actionError !== null && (_jsxs(Banner, { variant: "error", testId: "render-edit-action-error", children: [actionError.message, _jsx(ErrorReference, { requestId: actionError.requestId })] })), recordQuery.error !== null && recordRow === null && (_jsxs("div", { role: "alert", "data-testid": `dashboard-${screen.id}-record-error`, className: "flex flex-col items-start gap-2 text-sm", children: [_jsx("span", { className: "text-status-bad", children: dispatcherErrorText(recordQuery.error, t) }), _jsx(Button, { variant: "secondary", onClick: () => void refetchRecord(), children: t("kumiko.dashboard.panel.error.retry") })] })), description !== undefined && (_jsx(Text, { variant: "muted", testId: `dashboard-${screen.id}-description`, children: description })), scope?.notice !== undefined && (_jsx(Banner, { variant: "info", testId: `dashboard-${screen.id}-scope-notice`, children: effectiveTranslate(scope.notice) })), _jsxs(VisibilityQueryContext.Provider, { value: gateResults.results, children: [_jsx(VisibilityGateQueries, { gates: visibilityGates, onResult: gateResults.report, onForget: gateResults.forget }), _jsx("div", { className: "grid grid-cols-1 gap-4 sm:grid-cols-2 lg:grid-cols-4", children: screen.panels.map((panel) => {
+    return (_jsx(PanelLoadedContext.Provider, { value: reportLoaded, children: _jsx(DashboardQueryContext.Provider, { value: queryRuntime, children: _jsxs(PageSection, { className: "flex flex-col gap-4", testId: `dashboard-${screen.id}`, children: [showPageHeader && (_jsx(PageHeader, { ...(recordTitle !== undefined && { title: recordTitle }), ...(badgeInHeader && { status: scopeBadge }), ...(headerActionsBar !== null && { actions: headerActionsBar }) })), _jsxs("div", { className: "flex flex-wrap items-end justify-between gap-3", children: [_jsxs("div", { className: "flex min-w-0 flex-wrap items-center gap-2", children: [!usesPageHeaderSlot && recordTitle !== undefined && (_jsx(Heading, { variant: "page", testId: `dashboard-${screen.id}-record-title`, children: recordTitle })), !badgeInHeader && scopeBadge, picker] }), _jsxs("div", { className: "flex flex-wrap items-center gap-3", children: [!usesPageHeaderSlot && headerActionsBar, screen.showUpdatedAt !== false && (_jsx("span", { "data-testid": `dashboard-${screen.id}-updated-at`, className: "text-xs tabular-nums text-muted-foreground", children: t("kumiko.dashboard.updated-at", { time: formatDateTime(loadedAtMs) }) })), rangeControl] })] }), actionError !== null && (_jsxs(Banner, { variant: "error", testId: "render-edit-action-error", children: [actionError.message, _jsx(ErrorReference, { requestId: actionError.requestId })] })), recordQuery.error !== null && recordRow === null && (_jsxs("div", { role: "alert", "data-testid": `dashboard-${screen.id}-record-error`, className: "flex flex-col items-start gap-2 text-sm", children: [_jsx("span", { className: "text-status-bad", children: dispatcherErrorText(recordQuery.error, t) }), _jsx(Button, { variant: "secondary", onClick: () => void refetchRecord(), children: t("kumiko.dashboard.panel.error.retry") })] })), description !== undefined && (_jsx(Text, { variant: "muted", testId: `dashboard-${screen.id}-description`, children: description })), scope?.notice !== undefined && (_jsx(Banner, { variant: "info", testId: `dashboard-${screen.id}-scope-notice`, children: effectiveTranslate(scope.notice) })), _jsxs(VisibilityQueryContext.Provider, { value: gateResultsWithPending, children: [_jsx(VisibilityGateQueries, { gates: visibilityGates, onResult: gateResults.report, onForget: gateResults.forget }), _jsx("div", { className: "grid grid-cols-1 gap-4 sm:grid-cols-2 lg:grid-cols-4", children: screen.panels.map((panel) => {
                                     if (panel.kind === "screen") {
                                         return (_jsx(ScreenPanelTile, { panel: panel, featureName: featureName, translate: effectiveTranslate }, panel.id));
                                     }

package/dist/web/app/dashboard-panels.js

@@ -311,7 +311,7 @@ function TextBlockView({ block, translate, }) {
                     ? "text-sm font-medium text-foreground"
                     : "text-sm text-muted-foreground", children: translate(block.text) }));
         case "list":
-            return (_jsx("ul", { "data-block": "list", className: "list-disc space-y-1 pl-5 text-sm text-muted-foreground", children: block.items.map((item) => (_jsx("li", { children: translate(item) }, item))) }));
+            return (_jsx("ul", { "data-block": "list", className: "list-disc space-y-1 pl-5 text-sm text-muted-foreground", children: withOccurrenceKeys(block.items, (item) => item).map(({ entry, key }) => (_jsx("li", { children: translate(entry) }, key))) }));
         case "code":
             return (_jsx("pre", { "data-block": "code", className: "overflow-x-auto rounded-md bg-muted p-3 text-xs", children: _jsx("code", { children: block.code }) }));
         case "hint":
@@ -330,6 +330,16 @@ function TextBlockLink({ block, translate, }) {
     const target = { screenId: lastSegment(block.screen) };
     return (_jsx(Link, { href: nav.hrefFor(target), onPress: () => nav.navigate(target), testId: `dashboard-text-link-${target.screenId}`, children: translate(block.text) }));
 }
+// Content-derived keys collide for identical entries; the occurrence count keeps them unique.
+function withOccurrenceKeys(entries, contentKey) {
+    const seen = new Map();
+    return entries.map((entry) => {
+        const content = contentKey(entry);
+        const occurrence = seen.get(content) ?? 0;
+        seen.set(content, occurrence + 1);
+        return { entry, key: `${content}#${occurrence}` };
+    });
+}
 function textBlockKey(block) {
     switch (block.kind) {
         case "list":
@@ -341,7 +351,7 @@ function textBlockKey(block) {
     }
 }
 export function TextPanelBody({ panel, label, translate, }) {
-    const blocks = (_jsx("div", { className: "flex flex-col gap-3", children: panel.blocks.map((block) => (_jsx(TextBlockView, { block: block, translate: translate }, textBlockKey(block)))) }));
+    const blocks = (_jsx("div", { className: "flex flex-col gap-3", children: withOccurrenceKeys(panel.blocks, textBlockKey).map(({ entry, key }) => (_jsx(TextBlockView, { block: entry, translate: translate }, key))) }));
     const testId = `dashboard-panel-${panel.id}`;
     if (label !== undefined) {
         return (_jsx(PanelShell, { testId: testId, title: label, children: blocks }));

package/dist/web/app/history-leave-guard.d.ts

@@ -0,0 +1,6 @@
+export declare function committedUrl(): string;
+/** Adopts the entry the browser currently shows as the committed one. */
+export declare function adoptCurrentEntry(): void;
+export declare function pushEntry(url: string): void;
+export declare function replaceEntry(url: string): void;
+export declare function handlePopstate(notify: () => void): void;