@antelopejs/dms 0.10.0 → 0.11.0

package/frontend-vue/layers/dms-ui/app/composables/form/useForm.ts

@@ -5,7 +5,11 @@ import type { FormProps, FormFetchResponse, FormSubmitResponse } from "./types";
 import { jsonSchemaToZod } from "json-schema-to-zod";
 import { FormEvents } from "./types/events";
 import type { FormData, FormFieldValue } from "./types/value";
-import type { FormField, FormFieldOrGroup } from "./types/field";
+import type {
+  FieldCondition,
+  FormField,
+  FormFieldOrGroup,
+} from "./types/field";
 import { isFieldGroup } from "./types/field";
 import { resolveResponseToast } from "../../build/utils/responseWarning";
 import { processFieldI18n } from "../../build/utils/fieldOptionsI18n";
@@ -35,9 +39,11 @@ interface FormSubmitNotice {
 import type { DataType } from "#dms-core/app/composables/data-types/useDataType";
 import {
   type ApiFieldError,
+  apiErrorStatus,
   apiErrorText,
   resolveFieldErrors,
 } from "#dms-core/app/composables/useFieldErrors";
+import { HTTP_NOT_FOUND } from "#dms-core/app/utils/http-status";
 import { isBlankValue } from "#dms-core/app/composables/useFormValidation";
 import {
   isPlainObject,
@@ -472,6 +478,34 @@ export function isFieldMarkedRequired(
   return !!field.required || (required?.has(field.id) ?? false);
 }
 
+const meetsCondition = (
+  condition: FieldCondition,
+  values: Record<string, unknown>,
+): boolean => condition.in.includes(values[condition.field] ?? null);
+
+/**
+ * The fields the values hide (`visibleWhen` not met) or disable
+ * (`disabledWhen` met), added to those the watches hide or disable: the
+ * conditions hold from the values the form opens with, without a watch.
+ */
+export function withConditionFields(
+  fields: ReadonlyArray<Pick<FormField, "id" | "visibleWhen" | "disabledWhen">>,
+  values: Record<string, unknown>,
+  watched: { disabled?: Set<string>; hidden?: Set<string> },
+): { disabled: Set<string>; hidden: Set<string> } {
+  const disabled = new Set(watched.disabled);
+  const hidden = new Set(watched.hidden);
+  for (const field of fields) {
+    if (field.visibleWhen && !meetsCondition(field.visibleWhen, values)) {
+      hidden.add(field.id);
+    }
+    if (field.disabledWhen && meetsCondition(field.disabledWhen, values)) {
+      disabled.add(field.id);
+    }
+  }
+  return { disabled, hidden };
+}
+
 function watchFieldChanges(
   state: Ref<Record<string, unknown>>,
   componentId: string | undefined,
@@ -612,13 +646,16 @@ export const useForm = (props: FormProps, options: UseFormOptions = {}) => {
     { deep: true },
   );
 
-  const disabledFields = computed(
-    () => state.value.disabledFields as Set<string> | undefined,
+  const inactiveFields = computed(() =>
+    withConditionFields(allFields.value, state.value, {
+      disabled: state.value.disabledFields as Set<string> | undefined,
+      hidden: state.value.hiddenFields as Set<string> | undefined,
+    }),
   );
 
-  const hiddenFields = computed(
-    () => state.value.hiddenFields as Set<string> | undefined,
-  );
+  const disabledFields = computed(() => inactiveFields.value.disabled);
+
+  const hiddenFields = computed(() => inactiveFields.value.hidden);
 
   const requiredFields = computed(
     () => state.value.requiredFields as Set<string> | undefined,
@@ -686,7 +723,10 @@ export const useForm = (props: FormProps, options: UseFormOptions = {}) => {
       // A server render shows the failure in the form (FormLoadError) and
       // hands it to the browser; a toast it added would show in its HTML
       // alone, which the browser's toasts never hold.
-      if (!import.meta.env.SSR) showFetchErrorToast(error);
+      // A 404 is no error either: the form says the record is not found.
+      if (!import.meta.env.SSR && apiErrorStatus(error) !== HTTP_NOT_FOUND) {
+        showFetchErrorToast(error);
+      }
       throw error;
     }
   };

package/frontend-vue/layers/dms-ui/app/composables/live/usePageLive.ts

@@ -1,7 +1,9 @@
 import {
   computed,
   getCurrentScope,
+  onMounted,
   onScopeDispose,
+  shallowRef,
   type ComputedRef,
 } from "vue";
 import {
@@ -75,7 +77,12 @@ export interface PageLiveState {
  * never paused, and its actions do nothing. A server render reads the page as
  * live and never paused too, but `isEnabled` says whether it declares `live`:
  * the browser hydrates the page's blocks with its controller installed, so
- * the server draws them as it will.
+ * the server draws them as it will. The rest of the state is born in the
+ * browser (the realtime stream, the page's reads, a pause): a component
+ * hydrating the server's HTML reads it as the server did (live, not polling,
+ * never read, nothing missed) until its own `onMounted`, then follows the
+ * page. A component mounted afresh, after a client navigation, reads the page
+ * at once.
  *
  * ```ts
  * const { isPaused, missedCount, resume, hold, release } = usePageLive();
@@ -86,26 +93,29 @@ export interface PageLiveState {
  * `realtimeTopic` are.
  */
 export function usePageLive(): PageLiveState {
-  const isPaused = computed(() => currentPageLive()?.isPaused.value ?? false);
+  // An async block hydrates after the page has installed its controller and
+  // read its data: until mounted, it draws the state the server drew.
+  const isHydrating = shallowRef(isDmsHydrating());
+  if (isHydrating.value) onMounted(() => (isHydrating.value = false));
+  const shown = () => (isHydrating.value ? null : currentPageLive());
+  const isPaused = computed(() => shown()?.isPaused.value ?? false);
   const hold = usePageLiveHold();
   const isServerLive = isServerPageLive();
   return {
     isEnabled: computed(() => currentPageLive() !== null || isServerLive),
     isLive: computed(() => !isPaused.value),
     isPaused,
-    pauseReason: computed(() => currentPageLive()?.pauseReason.value ?? null),
+    pauseReason: computed(() => shown()?.pauseReason.value ?? null),
     pause: () => currentPageLive()?.pause(),
     resume: () => currentPageLive()?.resume(),
     toggle: () => currentPageLive()?.toggle(),
     hold: hold.hold,
     release: hold.release,
-    lastUpdatedAt: computed(
-      () => currentPageLive()?.lastUpdatedAt.value ?? null,
-    ),
-    missedCount: computed(() => currentPageLive()?.missedCount.value ?? 0),
-    missedDetail: computed(() => currentPageLive()?.missedDetail.value ?? null),
+    lastUpdatedAt: computed(() => shown()?.lastUpdatedAt.value ?? null),
+    missedCount: computed(() => shown()?.missedCount.value ?? 0),
+    missedDetail: computed(() => shown()?.missedDetail.value ?? null),
     setMissedDetail: (detail) => currentPageLive()?.setMissedDetail(detail),
-    isPolling: computed(() => currentPageLive()?.isPolling.value ?? false),
+    isPolling: computed(() => shown()?.isPolling.value ?? false),
   };
 }
 

package/frontend-vue/layers/dms-ui/app/utils/cascader.ts

@@ -27,6 +27,7 @@ export interface CascaderTreeOptions {
 
 export const CASCADER_PATH_SEPARATOR = " / ";
 
+/** How many rows the picker's open menu lists to browse the tree. */
 export const CASCADER_FETCH_LIMIT = 1000;
 
 export const DEFAULT_CASCADER_KEY_MAPPING: CascaderKeyMapping = {
@@ -220,10 +221,100 @@ export function cascaderValuePath(
 ): string[] {
   const row = asPickedRow(item);
   const ownLabel = row ? rowValue(row, keyMapping.label) : undefined;
-  const id = row
-    ? rowValue(row, keyMapping.value)
-    : rowValue({ id: item }, "id");
+  const id = cascaderValueId(item, keyMapping);
   if (!id) return ownLabel ? [ownLabel] : [];
   const labels = rows ? buildCascaderPathLabels(rows, keyMapping, id) : [];
   return labels.length > 0 ? labels : [ownLabel ?? id];
 }
+
+/** Reads the rows of the given ids from the cascader's `select` route. */
+export type CascaderRowsReader = (ids: string[]) => Promise<CascaderRow[]>;
+
+/** The rows a path is drawn from, and the picked ids none of them answer. */
+export interface CascaderAncestry {
+  rows: CascaderRow[];
+  notFound: string[];
+}
+
+/**
+ * The rows of the picked ids and of every ancestor above them, read with
+ * `?ids=` one level at a time: the picked rows, then their parents, then
+ * theirs, until a level names no row not read yet. A tree is as many reads as
+ * it is deep (a level is one request for all its ids), whatever its size, and
+ * a parent cycle ends because a row is never asked twice. A picked id no row
+ * answers (deleted, out of reach) is returned as not found.
+ */
+export async function readCascaderAncestry(
+  read: CascaderRowsReader,
+  keyMapping: CascaderKeyMapping,
+  ids: string[],
+): Promise<CascaderAncestry> {
+  const rowsByValue = new Map<string, CascaderRow>();
+  const asked = new Set<string>();
+  let pending = [...new Set(ids)];
+  while (pending.length > 0) {
+    for (const id of pending) asked.add(id);
+    const rows = await read(pending);
+    for (const row of rows) {
+      const value = rowValue(row, keyMapping.value);
+      if (value !== undefined) rowsByValue.set(value, row);
+    }
+    pending = [
+      ...new Set(
+        rows
+          .map((row) => rowValue(row, keyMapping.parent))
+          .filter(
+            (parent): parent is string =>
+              parent !== undefined && !asked.has(parent),
+          ),
+      ),
+    ];
+  }
+  return {
+    rows: [...rowsByValue.values()],
+    notFound: ids.filter((id) => !rowsByValue.has(id)),
+  };
+}
+
+/** The id of a picked value: an id, or a row carrying its id. */
+export function cascaderValueId(
+  item: unknown,
+  keyMapping: CascaderKeyMapping,
+): string | undefined {
+  const row = asPickedRow(item);
+  return row ? rowValue(row, keyMapping.value) : rowValue({ id: item }, "id");
+}
+
+/** What a cell already holds of its path, and the ids it still has to read. */
+export interface CascaderValueReads {
+  /** The rows the server joined: each one labels itself. */
+  joinedRows: CascaderRow[];
+  /** The picked ids sent plain, and the parents of the joined rows. */
+  idsToRead: string[];
+}
+
+/**
+ * Splits a cell's picked values into the rows the list joined and the ids it
+ * still reads: a plain id is read, a joined row only has its parent read
+ * (none for a root), so a list whose route joins the relation reads nothing
+ * for a pick at the top of the tree.
+ */
+export function cascaderValueReads(
+  values: unknown[],
+  keyMapping: CascaderKeyMapping,
+): CascaderValueReads {
+  const joinedRows = values
+    .map(asPickedRow)
+    .filter(
+      (row): row is CascaderRow =>
+        !!row && rowValue(row, keyMapping.value) !== undefined,
+    );
+  const plainIds = values
+    .filter((item) => !asPickedRow(item))
+    .map((item) => cascaderValueId(item, keyMapping))
+    .filter((id): id is string => id !== undefined);
+  const parents = joinedRows
+    .map((row) => rowValue(row, keyMapping.parent))
+    .filter((id): id is string => id !== undefined);
+  return { joinedRows, idsToRead: [...new Set([...plainIds, ...parents])] };
+}

package/frontend-vue/layers/dms-ui/i18n/locales/ui-en-GB.json

@@ -290,12 +290,15 @@
         "forbidden_description": "Your role doesn't let you view this entry, so the form can't open on its current values. Ask an administrator for access.",
         "missing_title": "No entry selected",
         "missing_description": "This form shows one entry, and the address names none. Open it from an entry to see its values.",
+        "not_found_title": "Not found",
+        "not_found_description": "This entry does not exist, or no longer does: it may have been deleted.",
         "retry": "Try again"
       },
       "select_date": "Select date",
       "relation": {
         "selected_count": "{count} selected",
-        "add_new": "Add new entry"
+        "add_new": "Add new entry",
+        "not_found": "Not found"
       },
       "cascader": {
         "placeholder": "Select an item",

package/frontend-vue/layers/dms-ui/i18n/locales/ui-fr-FR.json

@@ -291,12 +291,15 @@
         "forbidden_description": "Votre rôle ne vous permet pas de voir cet élément, le formulaire ne peut donc pas s'ouvrir sur ses valeurs actuelles. Demandez l'accès à un administrateur.",
         "missing_title": "Aucun élément sélectionné",
         "missing_description": "Ce formulaire affiche un élément, et l'adresse n'en désigne aucun. Ouvrez-le depuis un élément pour voir ses valeurs.",
+        "not_found_title": "Introuvable",
+        "not_found_description": "Cet élément n'existe pas, ou plus : il a peut-être été supprimé.",
         "retry": "Réessayer"
       },
       "select_date": "Sélectionner une date",
       "relation": {
         "selected_count": "{count} sélectionné(s)",
-        "add_new": "Ajouter une nouvelle entrée"
+        "add_new": "Ajouter une nouvelle entrée",
+        "not_found": "Introuvable"
       },
       "cascader": {
         "placeholder": "Sélectionner un élément",

package/frontend-vue/package.json

@@ -11,7 +11,7 @@
   "license": "Apache-2.0",
   "packageManager": "pnpm@10.6.5",
   "engines": {
-    "@antelopejs/dms-frontend": ">=0.8.0 <0.9.0"
+    "@antelopejs/dms-frontend": ">=0.9.0 <0.10.0"
   },
   "scripts": {
     "typecheck": "ajs dms verify-source --layer \"$PWD\" --local-package @antelopejs/dms=.. --local-package @antelopejs/interface-dms=../../interface-dms",
@@ -37,7 +37,11 @@
     "@iconify-json/ph": "^1.2.2",
     "@internationalized/date": "^3.10.0",
     "@lezer/common": "^1.5.3",
+    "@lezer/css": "^1.3.8",
     "@lezer/highlight": "^1.2.5",
+    "@lezer/html": "^1.3.13",
+    "@lezer/javascript": "^1.5.6",
+    "@lezer/json": "^1.0.3",
     "@tailwindcss/typography": "^0.5.19",
     "@tanstack/vue-table": "^8.21.3",
     "@tiptap/core": "^3.30.2",
@@ -75,7 +79,7 @@
   },
   "devDependencies": {
     "@antelopejs/core": ">=1.16.0 <2",
-    "@antelopejs/dms-frontend": ">=0.8.0 <0.9.0",
+    "@antelopejs/dms-frontend": ">=0.9.0 <0.10.0",
     "@eslint/js": "^8.57.0",
     "@inertiajs/vue3": "^3.7.0",
     "@nuxt/ui": "4.10.0",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@antelopejs/dms",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "The AntelopeJS dashboard management system: admin dashboards declared in TypeScript, with auth and tenancy, data management, file uploads, notifications and realtime.",
   "keywords": [
     "antelopejs",
@@ -58,10 +58,10 @@
     "@antelopejs/interface-api": ">=0.0.15 <1.0.0",
     "@antelopejs/interface-api-util": ">=0.1.3 <1.0.0",
     "@antelopejs/interface-core": ">=0.2.4 <1.0.0",
-    "@antelopejs/interface-data-api": ">=0.3.0 <1.0.0",
-    "@antelopejs/interface-database": ">=0.1.10 <1.0.0",
-    "@antelopejs/interface-database-decorators": ">=0.1.9 <1.0.0",
-    "@antelopejs/interface-dms": ">=0.8.0 <0.9.0",
+    "@antelopejs/interface-data-api": ">=0.4.0 <1.0.0",
+    "@antelopejs/interface-database": ">=0.1.11 <1.0.0",
+    "@antelopejs/interface-database-decorators": ">=0.1.10 <1.0.0",
+    "@antelopejs/interface-dms": ">=0.9.0 <0.10.0",
     "@antelopejs/interface-email": ">=0.0.6 <1.0.0",
     "@antelopejs/interface-file-storage": ">=0.1.4 <1.0.0",
     "archiver": "^7.0.1",
@@ -77,7 +77,7 @@
     "zod": "~3.24.2"
   },
   "devDependencies": {
-    "@antelopejs/core": ">=1.16.0 <2",
+    "@antelopejs/core": ">=1.17.0 <2",
     "@antelopejs/tooling-configs": ">=0.0.9 <1.0.0",
     "@types/archiver": "^6.0.4",
     "@types/chai": "^4.3.20",
@@ -120,7 +120,7 @@
     "@antelopejs/interface-redis": ">=0.0.9 <1.0.0"
   },
   "peerDependencies": {
-    "@antelopejs/core": ">=1.16.0 <2"
+    "@antelopejs/core": ">=1.17.0 <2"
   },
   "peerDependenciesMeta": {
     "@antelopejs/core": {

package/skills/dms-module/SKILL.md

@@ -85,7 +85,7 @@ module's frontend; without it the module is backend-only.
 
 `renderer` names the framework (Vue 3), not a loader release. The `@antelopejs/dms-frontend`
 releases the frontend module runs on go in the frontend module's own `package.json`, as
-`"engines": { "@antelopejs/dms-frontend": ">=0.8.0 <0.9.0" }`: the loader refuses the module
+`"engines": { "@antelopejs/dms-frontend": ">=0.9.0 <0.10.0" }`: the loader refuses the module
 outside that range. Cap it below the next loader minor while the loader is 0.x.
 
 An absolute link (a public file, a snippet to copy, a mail) is built on `await GetApiBaseUrl()`

package/skills/dms-pages/REFERENCE.md

@@ -206,9 +206,13 @@ row's ⋯ button — `docs/04.components/08.tables/0.index.md#pinned-rows`.
   `{ label, tone?, variant: "soft" | "outline" }`.
 - A `TableView` over a shared controller hides a column on one page with
   `columns: { hidden: ["workspace"] }` — no view just to hide it.
-- Conditional fields on a `TableView`'s generated forms go in `forms: { new?, edit?, view? }`, each a
-  callback receiving the form's builder: `new: (form) => form.watch(FormEvents.FIELD_CHANGE, …)` —
-  they run in a drawer, a modal or a form page alike; no custom page just to add a watch.
+- A field shown, required or locked by another column's value goes on its `@Column`:
+  `visibleWhen: { field: "stage", in: ["lost"] }`, `disabledWhen: { field: "stage", in: ["won"] }`.
+  The generated forms and the data routes both apply them (hidden: not mandatory, value ignored,
+  stored value cleared on edit; disabled: sent value ignored, stored one kept) — no watch, no custom page.
+- `forms: { new?, edit?, view? }` hands each generated form's builder to a callback
+  (`new: (form) => form.watch(FormEvents.FIELD_CHANGE, …)`) for input comfort only — a value filled
+  in from another, a field one table's forms leave out. No data rule there: the routes never see it.
 - A table of more than a few columns that phones will read offers the cards and opens them there:
   `displays: [{ id: "table" }, { id: "cards" }], mobileDisplay: "cards"`. Only a display the user
   saved or the open view's own `display` overrides it: a `views.defaultView` that sets no display

package/dist/hooks/tenant-instances.d.ts

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

package/dist/hooks/tenant-instances.js

@@ -1,13 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.registerTenantInstanceProvisioning = registerTenantInstanceProvisioning;
-const hooks_1 = require("@antelopejs/interface-dms/hooks");
-const tenant_instances_1 = require("../utils/tenant-instances");
-async function onTenantBeingProvisioned(payload) {
-    await (0, tenant_instances_1.registerTenantInstance)(payload.tenantId);
-    return undefined;
-}
-function registerTenantInstanceProvisioning() {
-    (0, hooks_1.RegisterHook)(hooks_1.Hook.TENANT_BEING_PROVISIONED, onTenantBeingProvisioned);
-}
-//# sourceMappingURL=tenant-instances.js.map

package/dist/hooks/tenant-instances.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"tenant-instances.js","sourceRoot":"","sources":["../../src/hooks/tenant-instances.ts"],"names":[],"mappings":";;AAqBA,gFAEC;AAvBD,2DAIyC;AACzC,gEAAmE;AAEnE,KAAK,UAAU,wBAAwB,CACrC,OAAsC;IAEtC,MAAM,IAAA,yCAAsB,EAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC/C,OAAO,SAAS,CAAC;AACnB,CAAC;AASD,SAAgB,kCAAkC;IAChD,IAAA,oBAAY,EAAC,YAAI,CAAC,wBAAwB,EAAE,wBAAwB,CAAC,CAAC;AACxE,CAAC"}

package/frontend-vue/layers/dms-core/app/composables/hydration/isHydratingComponent.ts

@@ -1,29 +0,0 @@
-import { getCurrentInstance } from "vue";
-
-/**
- * Whether the component setting up or rendering now is hydrating the
- * server's HTML.
- *
- * Vue binds a hydrating component's vnode to its server-rendered node before
- * its setup runs, where a fresh mount has no node until it is mounted; once
- * mounted, the component no longer hydrates. So this is true from the setup
- * to the first render of a component the browser takes over from the server,
- * and false in a client navigation, on a later re-render, on the server, and
- * outside a component.
- *
- * Read it where the browser must draw what the server drew: a part drawn
- * in the browser only, or a value only the browser knows (local storage, the
- * clock), waits until mounted while hydrating, and shows at once anywhere
- * else. Call it before the setup's first `await`, while the component is
- * still Vue's current instance. Data needs no check: `useApiData` hands the
- * server's answer to the browser on its own.
- *
- * ```ts
- * const isDrawn = ref(!import.meta.env.SSR && !isHydratingComponent());
- * onMounted(() => (isDrawn.value = true));
- * ```
- */
-export function isHydratingComponent(): boolean {
-  const instance = getCurrentInstance();
-  return !!instance && !instance.isMounted && !!instance.vnode.el;
-}

package/frontend-vue/layers/dms-layout/app/composables/layout/usePageRecord.ts

@@ -1,50 +0,0 @@
-import { computed, type ComputedRef } from "vue";
-import { resolveUrlVariables } from "#dms-ui/app/build/utils/urlVariables";
-import type { PageRecord } from "../../utils/pageRecord";
-
-/** The record a page shows, as the layout declares it (`record`). */
-export interface PageRecordSource {
-  /** `{{params.X}}` and `{{query.X}}` are filled in from the page URL. */
-  fetchUrl: string;
-}
-
-/**
- * The record the page shows, for the header buttons acting on it: loading
- * until it answers, missing when it does not, or when its URL names a value
- * the page does not carry. Undefined for a page declaring no record.
- *
- * It is read through `useApiData`, keyed on its URL like a block's
- * `fetchUrl`: a block of the page reading the same URL shares the one
- * request, and a server render hands the record to the browser with the page.
- */
-export function usePageRecord(
-  source: () => PageRecordSource | undefined,
-): ComputedRef<PageRecord | undefined> {
-  const route = useDmsRoute();
-  const siteLayout = useSiteLayout();
-
-  // Null while the URL names a value the page does not carry.
-  const url = computed(() => {
-    const declared = source();
-    if (!declared) return undefined;
-    return (
-      resolveUrlVariables(declared.fetchUrl, {
-        routeParams: siteLayout.findMatchingRoute(route.path)?.params,
-        routeQuery: route.query as Record<string, unknown>,
-      }) ?? null
-    );
-  });
-  // The options a block's read takes (`useChartFetch`): a block never holds
-  // a navigation, and neither does the header.
-  const { data, error } = useApiData<Record<string, unknown>>(
-    () => url.value ?? null,
-    { lazy: true },
-  );
-
-  return computed<PageRecord | undefined>(() => {
-    if (url.value === undefined) return undefined;
-    if (url.value === null || error.value) return { status: "missing" };
-    if (data.value) return { status: "loaded", values: data.value };
-    return { status: "loading" };
-  });
-}

package/frontend-vue/layers/dms-layout/app/utils/pageRecord.ts

@@ -1,71 +0,0 @@
-import { get } from "@nuxt/ui/runtime/utils/index.js";
-import type { ActionTarget } from "#dms-ui/app/composables/table-view/types/action-target";
-
-// The record a page shows (`DefaultLayout({ record })`), as its header
-// buttons read it: `{{record.X}}` in a target, a button acting on it.
-
-/** The record of the page as the header knows it. */
-export type PageRecord =
-  | { status: "loading" }
-  | { status: "loaded"; values: Record<string, unknown> }
-  /** Not found, refused, or its URL names a value the page does not carry. */
-  | { status: "missing" };
-
-/** What the header needs of a button to bind it to the page's record. */
-export interface RecordBoundButton {
-  target?: ActionTarget;
-  requiresRecord?: boolean;
-  disabled?: boolean;
-}
-
-const RECORD_TOKEN = /\{\{\s*record\.([\w.-]+)\s*\}\}/g;
-const NAMES_RECORD = /\{\{\s*record\./;
-
-const targetUrl = (target: ActionTarget | undefined): string | undefined => {
-  const url = (target as { url?: unknown } | undefined)?.url;
-  return typeof url === "string" ? url : undefined;
-};
-
-/** Whether a button acts on the page's record. */
-export function isRecordBound(button: RecordBoundButton): boolean {
-  if (button.requiresRecord) return true;
-  const url = targetUrl(button.target);
-  return !!url && NAMES_RECORD.test(url);
-}
-
-/**
- * A URL with its `{{record.X}}` tokens filled in, each value percent-encoded
- * (an address is one query value). A token the record has no value for is
- * left as written.
- */
-export function fillRecordTokens(
-  url: string,
-  record: Record<string, unknown>,
-): string {
-  return url.replace(RECORD_TOKEN, (match, key: string) => {
-    const value: unknown = get(record, key);
-    return typeof value === "string" || typeof value === "number"
-      ? encodeURIComponent(String(value))
-      : match;
-  });
-}
-
-/**
- * The button as the page's record leaves it: unchanged when it does not act
- * on the record; disabled while the record loads; left out (`null`) when the
- * record is missing; its target's `{{record.X}}` filled in once loaded.
- */
-export function withPageRecord<T extends RecordBoundButton>(
-  button: T,
-  record: PageRecord | undefined,
-): T | null {
-  if (!record || !isRecordBound(button)) return button;
-  if (record.status === "missing") return null;
-  if (record.status === "loading") return { ...button, disabled: true };
-  const url = targetUrl(button.target);
-  if (!url) return button;
-  return {
-    ...button,
-    target: { ...button.target, url: fillRecordTokens(url, record.values) },
-  } as T;
-}