@object-ui/fields 17.5.0 → 17.6.0

package/src/__tests__/PercentCellRenderer.locale.test.tsx

@@ -1,152 +0,0 @@
-/**
- * ObjectUI
- * Copyright (c) 2024-present ObjectStack Inc.
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- */
-
-/**
- * objectui#4553 phase 2 — the percent CELL, the fields-internal consumer of
- * `formatPercent`.
- *
- * `PercentCellRenderer` had two rendering paths and BOTH were outside the
- * display-locale channel:
- *
- *     const formatted = isWholePercentField
- *       ? `${numValue.toFixed(precision)}%`   // a second bare toFixed path
- *       : formatPercent(numValue, precision); // no locale to pass
- *
- * The branch exists for a real reason — a field named `progress` / `completion`
- * stores 0-100, so it must NOT go through `percentDisplayValue`'s fraction
- * scaling — but it had quietly become a second place where a percent was
- * formatted, and it was the more primitive of the two. Threading only the
- * `formatPercent` half would have made ONE grid internally inconsistent: a
- * `progress` column ungrouped and unlocalized beside a `rate` column that was
- * neither. So both branches now render through the same locale-aware body and
- * differ only in the scaling policy, which is all the branch was ever about.
- *
- * ── Directions, predicted in writing BEFORE the run ──────────────────────
- * Runner machine locale en-US.
- *
- *   de, ordinary percent 1234.5   `1235%` → `1.235 %`   RED
- *   de, `progress` 1234.5         `1235%` → `1.235 %`   RED (the second path)
- *   en, ordinary percent 1234.5   `1235%` → `1,235%`    RED (grouping move)
- *   en, `progress` 1234.5         `1235%` → `1,235%`    RED (grouping move)
- *   the fraction/whole SPLIT itself                     PIN, green both sides
- *   small-value en output                               PIN, green both sides
- *
- * Provider-mounted by construction (objectui#4514) — the pure-function cases
- * live in `percent-formatter-locale-4553.test.ts`.
- */
-
-import React from 'react';
-import { describe, it, expect, afterEach } from 'vitest';
-import { render, screen, cleanup } from '@testing-library/react';
-import '@testing-library/jest-dom';
-import { I18nProvider, LocalizationProvider } from '@object-ui/i18n';
-import { PercentCellRenderer } from '../index';
-
-/** German writes a NO-BREAK SPACE (U+00A0) before the percent sign. */
-const NBSP = '\u00a0';
-
-/**
- * A session: the UI language the user picked plus the tenant's regional
- * default. `useDisplayLocale()` resolves tenant regional default → active UI
- * language → 'en'.
- */
-function renderCell(
-  value: unknown,
-  field: Record<string, unknown>,
-  language: string,
-  tenantLocale?: string,
-) {
-  return render(
-    <I18nProvider
-      config={{ defaultLanguage: language, detectBrowserLanguage: false }}
-      persistLanguage={false}
-    >
-      <LocalizationProvider value={{ locale: tenantLocale }}>
-        <PercentCellRenderer
-          value={value as any}
-          field={{ type: 'percent', ...field } as any}
-        />
-      </LocalizationProvider>
-    </I18nProvider>,
-  );
-}
-
-/** The cell's text, read off the value span beside the decorative bar. */
-function cellText(): string {
-  return document.body.textContent ?? '';
-}
-
-afterEach(() => cleanup());
-
-describe('PercentCellRenderer follows the display locale (objectui#4553)', () => {
-  it('de renders the German percent form', () => {
-    renderCell(1234.5, { name: 'win_rate' }, 'de');
-    expect(cellText()).toContain(`1.235${NBSP}%`);
-  });
-
-  /**
-   * The SECOND path — `progress` matches WHOLE_PERCENT_FIELD_PATTERN, so this
-   * value skips fraction scaling and used to skip `formatPercent` entirely.
-   */
-  it('de renders the German form on the whole-percent path too', () => {
-    renderCell(1234.5, { name: 'progress' }, 'de');
-    expect(cellText()).toContain(`1.235${NBSP}%`);
-  });
-
-  it('en groups at four digits on both paths — the deliberate output move', () => {
-    const { unmount } = renderCell(1234.5, { name: 'win_rate' }, 'en');
-    expect(cellText()).toContain('1,235%');
-    unmount();
-
-    renderCell(1234.5, { name: 'progress' }, 'en');
-    expect(cellText()).toContain('1,235%');
-  });
-
-  it('an explicit tenant locale outranks the active UI language', () => {
-    renderCell(1234.5, { name: 'win_rate' }, 'en', 'de');
-    expect(cellText()).toContain(`1.235${NBSP}%`);
-    expect(cellText()).not.toContain('1,235%');
-  });
-});
-
-describe('PercentCellRenderer keeps its scaling contract (objectui#4553 must-not-change)', () => {
-  /**
-   * PIN, green both sides — and the reason the whole-percent branch was kept
-   * rather than collapsed into `formatPercent`. The same stored number means
-   * different things in the two columns, and that must not have changed.
-   */
-  it('an ordinary percent scales a fraction; a progress field does not', () => {
-    const { unmount } = renderCell(0.5, { name: 'win_rate' }, 'en');
-    // Fraction-stored: 0.5 → 50%.
-    expect(cellText()).toContain('50%');
-    unmount();
-
-    renderCell(0.5, { name: 'progress' }, 'en');
-    // Whole-percent field: 0.5 really is half a percent, rounded to 1% at
-    // precision 0 — NOT 50%.
-    expect(cellText()).toContain('1%');
-    expect(cellText()).not.toContain('50%');
-  });
-
-  /** PIN: small-value English output is byte-identical across the change. */
-  it('en small-value output is unchanged (must-not-change)', () => {
-    renderCell(33.33, { name: 'win_rate', precision: 2 }, 'en');
-    expect(cellText()).toContain('33.33%');
-  });
-
-  /** PIN: the decorative bar still reports the un-formatted magnitude. */
-  it('the progressbar still carries the numeric value', () => {
-    renderCell(33.33, { name: 'win_rate' }, 'en');
-    expect(screen.getByRole('progressbar')).toHaveAttribute('aria-valuenow', '33.33');
-  });
-
-  /** PIN: the null path is untouched — and the hook runs before it. */
-  it('renders the empty value for null without crashing on the hook', () => {
-    expect(() => renderCell(null, { name: 'win_rate' }, 'de')).not.toThrow();
-  });
-});

package/src/__tests__/PercentCellRenderer.test.tsx

@@ -1,115 +0,0 @@
-/**
- * ObjectUI
- * Copyright (c) 2024-present ObjectStack Inc.
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- */
-
-/**
- * Regression for objectstack-ai/objectstack#5066: the percent / progress cell
- * renderer emitted a FIXED-WIDTH, NON-SHRINKABLE bar (`w-16 shrink-0`) next to a
- * shrinkable value span. Inside a narrow clipping container — a
- * `record:highlights` chip is `basis-[9rem]` / `min-w-[7rem]` and clips with
- * `truncate` — the 64px bar won the space and the VALUE was cut mid-digit: a
- * stored `33.33` carried `33%` in the DOM but read as `3` on screen (measured:
- * 79px clipping box, 32px text node, 25px overflow), with no ellipsis and no
- * signal in the accessible name. A silently wrong number, not a cosmetic glitch.
- *
- * Pin: the number is the CONTENT (`shrink-0`, never sacrificed) and the bar is
- * DECORATION (`w-16` as its preferred width, free to shrink away under
- * pressure — and never `flex-1`, so a wide grid cell keeps today's 64px bar).
- *
- * jsdom has no layout engine, so these are class-semantics assertions (same
- * approach as `cell-truncation.test.tsx` for objectui#3466) plus DOM-text
- * assertions — deliberately not brittle pixel measurements.
- */
-import { describe, it, expect } from 'vitest';
-import { render, screen } from '@testing-library/react';
-import '@testing-library/jest-dom';
-import React from 'react';
-
-import { PercentCellRenderer } from '../index';
-
-const renderPercent = (value: unknown, field: Record<string, unknown> = {}) =>
-  render(
-    <PercentCellRenderer value={value as any} field={{ type: 'percent', ...field } as any} />,
-  );
-
-/** The decorative bar: `role="progressbar"` wrapper the renderer emits. */
-const bar = () => screen.getByRole('progressbar');
-/** The row that holds bar + value. */
-const row = () => bar().parentElement!;
-
-describe('PercentCellRenderer — value beats the decorative bar (issue #5066)', () => {
-  it('renders BOTH the bar and the value at normal width', () => {
-    renderPercent(33.33);
-
-    expect(bar()).toBeInTheDocument();
-    expect(bar()).toHaveAttribute('aria-valuenow', '33.33');
-    expect(screen.getByText('33%')).toBeInTheDocument();
-    // Bar and value are siblings in one flex row (nothing was dropped).
-    expect(row()).toHaveClass('flex');
-    expect(row()).toContainElement(screen.getByText('33%'));
-  });
-
-  it('gives the value span shrink priority so a narrow chip cannot clip it', () => {
-    renderPercent(33.33);
-
-    const value = screen.getByText('33%');
-    // The number never shrinks — it is the content of the cell.
-    expect(value).toHaveClass('shrink-0');
-    expect(value).toHaveClass('whitespace-nowrap', 'tabular-nums');
-  });
-
-  it('lets the bar shrink away instead of pushing the value out of the clip box', () => {
-    renderPercent(33.33);
-
-    // The bar keeps `w-16` as its PREFERRED width but is shrinkable, and
-    // `min-w-0` stops the automatic minimum size from pinning it at 64px.
-    expect(bar()).toHaveClass('w-16', 'min-w-0', 'shrink');
-    // The pre-fix spelling: a non-shrinkable bar is exactly the bug.
-    expect(bar()).not.toHaveClass('shrink-0');
-    // The row itself must be able to shrink below its content width inside the
-    // chip's flex column, or the deficit never reaches the bar.
-    expect(row()).toHaveClass('min-w-0');
-  });
-
-  it('does not let the bar GROW in a wide cell (no flex-1 / grow)', () => {
-    renderPercent(33.33);
-
-    // `flex-1` would also make the bar stretch to fill every wide grid cell —
-    // `w-16` stays the upper bound, only the shrink direction changed.
-    expect(bar().className).not.toMatch(/(^|\s)(flex-1|grow|basis-)/);
-  });
-
-  it('keeps the full formatted value in the DOM (fraction, whole, precision)', () => {
-    const first = renderPercent(33.33);
-    expect(screen.getByText('33%')).toBeInTheDocument();
-    first.unmount();
-
-    // Declared precision keeps the decimals — the widest text, worst overflow.
-    renderPercent(33.33, { precision: 2 });
-    const wide = screen.getByText('33.33%');
-    expect(wide).toBeInTheDocument();
-    expect(wide).toHaveClass('shrink-0');
-  });
-
-  it('scales a fraction-stored percent and still renders both parts', () => {
-    renderPercent(0.8);
-
-    expect(screen.getByText('80%')).toBeInTheDocument();
-    expect(bar()).toHaveAttribute('aria-valuenow', '80');
-    expect(screen.getByText('80%')).toHaveClass('shrink-0');
-  });
-
-  it('applies the same contract to whole-percent `progress` fields', () => {
-    renderPercent(33.33, { type: 'progress', name: 'progress' });
-
-    // 0-100 storage: no fraction scaling, value rendered as-is.
-    expect(screen.getByText('33%')).toBeInTheDocument();
-    expect(screen.getByText('33%')).toHaveClass('shrink-0');
-    expect(bar()).toHaveClass('min-w-0', 'shrink');
-    expect(bar()).not.toHaveClass('shrink-0');
-  });
-});

package/src/__tests__/boolean-label-association-e2e.test.tsx

@@ -1,298 +0,0 @@
-/**
- * ObjectUI
- * Copyright (c) 2024-present ObjectStack Inc.
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- */
-
-/**
- * End-to-end: a boolean field's VISIBLE label is associated with the control
- * the widget renders (objectui#3952).
- *
- * The defect: `<FormControl>` is a Radix `Slot` that hands its child the id
- * `<FormLabel htmlFor>` already points at (`_r_N_-form-item`), and
- * `BooleanField` REPLACED it with the field name. So the form's visible label
- * referenced an id no element carried — clicking it toggled nothing — while the
- * widget emitted a SECOND, `sr-only` label of its own carrying the same text.
- * The accessible name survived only by that accident.
- *
- * Two scenarios, pinned separately, because the widget has two hosts with
- * opposite needs:
- *
- *  - **hosted** (the form renderer, `ObjectForm`, any `<FormControl>`): the host
- *    owns the id AND the label. The widget must use the id it was handed and
- *    must NOT emit a label of its own — that is the duplicate half of the bug.
- *  - **standalone** (`FieldEditWidget`'s inline grid editor, a bare SDUI node):
- *    nobody hands an id and nobody renders a label, so the widget's own
- *    `sr-only` label is the control's ONLY accessible name and must stay.
- *
- * The widgets are registered raw rather than through `registerAllFields()`,
- * which wraps every loader in `React.lazy`: an unbounded module load inside a
- * bounded `findBy`/`waitFor` window is the repo's known flake generator
- * (AGENTS.md 测试纪律, objectui#3010). Same component, no Suspense boundary.
- */
-
-import { describe, it, expect, beforeAll, beforeEach, afterEach, vi } from 'vitest';
-import { render, screen, fireEvent, cleanup } from '@testing-library/react';
-import '@testing-library/jest-dom';
-import { ComponentRegistry } from '@object-ui/core';
-// Module scope: pulls in the form renderer's registration side effect.
-import '@object-ui/components';
-
-import { BooleanField } from '../widgets/BooleanField';
-
-beforeAll(() => {
-  ComponentRegistry.register('boolean', BooleanField as any, {
-    namespace: 'field',
-    skipFallback: true,
-  });
-}, 30000);
-
-beforeEach(() => {
-  if (!(Element.prototype as any).scrollIntoView) {
-    (Element.prototype as any).scrollIntoView = () => {};
-  }
-});
-
-afterEach(() => {
-  cleanup();
-  vi.restoreAllMocks();
-});
-
-/** The real form renderer hosting one field — the #3952 reproduction. */
-function renderForm(field: any, defaultValue: unknown) {
-  const Form = ComponentRegistry.get('form')!;
-  return render(
-    <Form
-      schema={{
-        type: 'form',
-        mode: 'create',
-        showSubmit: true,
-        showCancel: false,
-        submitLabel: 'Create',
-        defaultValues: { [field.name]: defaultValue },
-        fields: [field],
-        onSubmit: () => {},
-      }}
-    />,
-  );
-}
-
-/** Every `<label for=…>` in the document, paired with its resolved target. */
-function labelTargets(): Array<{ text: string; forId: string; resolves: boolean }> {
-  return Array.from(document.querySelectorAll('label'))
-    .map((el) => ({
-      text: (el.textContent ?? '').trim(),
-      forId: el.getAttribute('for') ?? '',
-      resolves: !!el.getAttribute('for') && !!document.getElementById(el.getAttribute('for')!),
-    }))
-    .filter((l) => l.forId !== '');
-}
-
-const switchOf = (name: string): Element => {
-  const el = document.querySelector(`[data-field="${name}"] [role="switch"]`);
-  if (!el) throw new Error(`no switch rendered for field "${name}"`);
-  return el;
-};
-
-const BOOLEAN_FIELD = {
-  name: 'notifications',
-  label: 'Email Notifications',
-  type: 'boolean',
-};
-
-describe('a form-hosted boolean field is labelled by its HOST (objectui#3952)', () => {
-  it('every label the form emits points at an element that exists', () => {
-    renderForm(BOOLEAN_FIELD, false);
-
-    const labels = labelTargets();
-    expect(labels.length).toBeGreaterThan(0);
-    // A `for` naming an id nothing carries is the defect verbatim: the form's
-    // visible label used to reference `_r_N_-form-item` while the switch
-    // carried `notifications`.
-    expect(labels.filter((l) => !l.resolves)).toEqual([]);
-  });
-
-  it('the visible label names the switch — one label, associated with the control', () => {
-    renderForm(BOOLEAN_FIELD, false);
-
-    // `getAllByLabelText` resolves label→control through `for`/id, so it guards
-    // the ID half: restore the override and it does not merely return the wrong
-    // node, it throws "found a label … however no form control was found
-    // associated to that label" — the switch left with NO accessible name,
-    // which is exactly what #3952 warned would happen the day the widget's own
-    // label went away. It does NOT guard the duplicate half: two labels
-    // pointing at ONE control still resolve to one element (measured), so the
-    // duplicate is pinned by the label-text count below.
-    const labelled = screen.getAllByLabelText('Email Notifications');
-    expect(labelled).toHaveLength(1);
-    expect(labelled[0]).toBe(switchOf('notifications'));
-    expect(labelled[0]).toHaveAttribute('role', 'switch');
-  });
-
-  it('the label text appears exactly once in the DOM', () => {
-    renderForm(BOOLEAN_FIELD, false);
-
-    // The duplicate half of the defect (and why a naive `getByText` on a
-    // boolean field returned two nodes).
-    expect(screen.getAllByText('Email Notifications')).toHaveLength(1);
-  });
-
-  it('activating the visible label toggles the switch', () => {
-    renderForm(BOOLEAN_FIELD, false);
-
-    const control = switchOf('notifications');
-    expect(control).toHaveAttribute('aria-checked', 'false');
-
-    // The user-facing symptom of #3952: the normal affordance for a switch row
-    // is clicking its label. It reaches the control only through the `for`/id
-    // association the form set up.
-    fireEvent.click(screen.getByText('Email Notifications'));
-
-    expect(switchOf('notifications')).toHaveAttribute('aria-checked', 'true');
-  });
-
-  it('the control keeps the HOST id verbatim — the widget does not rename it', () => {
-    renderForm(BOOLEAN_FIELD, false);
-
-    const control = switchOf('notifications');
-    const id = control.getAttribute('id') ?? '';
-    // The host's id is a `useId()`-derived form-item id; the field name is what
-    // the widget used to substitute for it.
-    expect(id).not.toBe('');
-    expect(id).not.toBe('notifications');
-    expect(id).toMatch(/-form-item$/);
-    // …and it is the id the visible label points at.
-    const visible = screen.getByText('Email Notifications');
-    expect(visible.getAttribute('for')).toBe(id);
-  });
-
-  it('two boolean fields in one form each get their own label', () => {
-    const Form = ComponentRegistry.get('form')!;
-    render(
-      <Form
-        schema={{
-          type: 'form',
-          mode: 'create',
-          showSubmit: false,
-          showCancel: false,
-          defaultValues: { notifications: false, digest: false },
-          fields: [BOOLEAN_FIELD, { name: 'digest', label: 'Weekly Digest', type: 'boolean' }],
-          onSubmit: () => {},
-        }}
-      />,
-    );
-
-    expect(labelTargets().filter((l) => !l.resolves)).toEqual([]);
-    // Each label reaches its OWN switch (a shared/colliding id would make both
-    // resolve to the first one).
-    fireEvent.click(screen.getByText('Weekly Digest'));
-    expect(switchOf('digest')).toHaveAttribute('aria-checked', 'true');
-    expect(switchOf('notifications')).toHaveAttribute('aria-checked', 'false');
-  });
-});
-
-describe('a STANDALONE boolean widget keeps its own accessible name (objectui#3952)', () => {
-  // `FieldEditWidget` (the grid's inline cell editor) renders these widgets with
-  // no `id` and no label of its own, so removing the widget's `sr-only` label
-  // unconditionally would leave the control unnamed. These pin the fallback.
-
-  it('switch variant: the sr-only label names the control', () => {
-    render(
-      <BooleanField
-        value={false}
-        onChange={() => {}}
-        field={{ name: 'notifications', label: 'Email Notifications', type: 'boolean' } as any}
-      />,
-    );
-
-    expect(labelTargets().filter((l) => !l.resolves)).toEqual([]);
-    const labelled = screen.getAllByLabelText('Email Notifications');
-    expect(labelled).toHaveLength(1);
-    expect(labelled[0]).toHaveAttribute('role', 'switch');
-  });
-
-  it('checkbox variant: the sr-only label names the control', () => {
-    render(
-      <BooleanField
-        value={false}
-        onChange={() => {}}
-        field={
-          {
-            name: 'agreed',
-            label: 'I agree',
-            type: 'boolean',
-            widget: 'checkbox',
-          } as any
-        }
-      />,
-    );
-
-    expect(labelTargets().filter((l) => !l.resolves)).toEqual([]);
-    const labelled = screen.getAllByLabelText('I agree');
-    expect(labelled).toHaveLength(1);
-    expect(labelled[0]).toHaveAttribute('role', 'checkbox');
-  });
-});
-
-describe('a host that labels by field NAME keeps its association (objectui#3952)', () => {
-  // `@object-ui/app-shell`'s `ActionParamDialog` boolean branch renders
-  // `<Label htmlFor={param.name}>` and — unlike its own generic branch, which
-  // passes `id={param.name}` — hands the widget NO id. It works only because
-  // the fallback chain's second term derives the id from the field name
-  // (`paramToField` sets `name: param.name`).
-  //
-  // So the chain is `hostId || config.name || useId()`, in that order, and the
-  // middle term is NOT dead weight to be "cleaned up" into a bare `useId()`:
-  // that would silently unlink every boolean action param in the console. This
-  // pin is what makes that attempt fail loudly instead.
-  it('falls back to the field name when no id was handed down', () => {
-    render(
-      <div>
-        <BooleanField
-          value={false}
-          onChange={() => {}}
-          field={{ name: 'confirmed', label: 'Confirmed', type: 'boolean' } as any}
-        />
-        <label htmlFor="confirmed">Send anyway</label>
-      </div>,
-    );
-
-    const control = document.querySelector('[role="switch"]')!;
-    expect(control).toHaveAttribute('id', 'confirmed');
-    expect(labelTargets().filter((l) => !l.resolves)).toEqual([]);
-    // The host's OWN label reaches the control through that id.
-    expect(screen.getAllByLabelText(/Send anyway/)).toHaveLength(1);
-  });
-});
-
-describe('a host-supplied id wins for BOTH variants (objectui#3952)', () => {
-  // The checkbox variant is unreachable through the standalone form renderer —
-  // `resolvedType = widget || field.widget || type` turns `widget: 'checkbox'`
-  // into the renderer's own BUILTIN `checkbox` branch before the registry is
-  // consulted — so its host contract is pinned at the prop boundary, exactly
-  // as `<FormControl>`'s Slot delivers it.
-  it.each([
-    ['switch', undefined, 'switch'],
-    ['checkbox', 'checkbox', 'checkbox'],
-  ] as const)('%s variant uses the id the host handed it', (_name, widget, role) => {
-    render(
-      <label htmlFor="host-item">
-        Host Label
-        <BooleanField
-          value={false}
-          onChange={() => {}}
-          id="host-item"
-          field={{ name: 'agreed', label: 'I agree', type: 'boolean', widget } as any}
-        />
-      </label>,
-    );
-
-    const control = document.querySelector(`[role="${role}"]`)!;
-    expect(control).toHaveAttribute('id', 'host-item');
-    // And the widget adds no second label of its own.
-    expect(screen.queryByText('I agree')).toBeNull();
-    expect(document.querySelectorAll('label')).toHaveLength(1);
-  });
-});

package/src/__tests__/capability-multiselect-retired.test.ts

@@ -1,109 +0,0 @@
-/**
- * ObjectUI
- * Copyright (c) 2024-present ObjectStack Inc.
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- */
-
-/**
- * Retirement pin — `field:capability-multiselect` (objectui#3308, ADR-0049
- * enforce-or-remove).
- *
- * The key was registered on ONE path only: `registerFields()`, whose sole caller
- * was the docs site. The live path (`registerAllFields()`, run at module import)
- * never had it, because `fieldWidgetMap` never listed it — so a field authored
- * with `widget: 'capability-multiselect'` resolved to nothing in every real app
- * while a code comment advertised it as usable from a record form. Nothing
- * stamped the hint either: ADR-0056 P1 stamps `permission-facet-link` on all six
- * `sys_permission_set` facets (including `system_permissions`), and P2 put the
- * capability editor in Studio.
- *
- * `registerFields()` itself is gone as of objectui#3910 (ruling B of
- * objectui#3798): the docs catalog's field examples are form-hosted now, so the
- * demo adapter that path existed for has no reason to exist. That REMOVES this
- * file's second and third assertions rather than re-spelling them — a test may
- * not call a function that no longer exists, and asserting over a deleted path
- * would pass for the empty reason (nothing is registered because nothing runs).
- * What each one becomes:
- *
- *   1. absent on the live path — UNCHANGED, and it is now the whole fact. While
- *      a second path existed this assertion pinned nothing (it passed on
- *      `origin/main` too, as PR #3793 recorded); with that path deleted, the
- *      live registry is the only registry, so re-adding the name to
- *      `fieldWidgetMap` is exactly what turns this red.
- *   2. "absent after `registerFields()` too" — DELETED with the path.
- *   3. "registers every other docs-path key" — RE-POINTED at the live path,
- *      which is a superset of the 38 keys the docs path used to register. It
- *      still pins "the retirement subtracts exactly one name", now against the
- *      surviving seam instead of a deleted one.
- *
- * `CapabilityMultiSelectField` the component is deliberately NOT asserted gone:
- * Studio's `PermissionMatrixEditor` imports and renders it directly, which is
- * ADR-0056 P2's design. Only the widget NAME is retired.
- */
-
-import { describe, it, expect } from 'vitest';
-import { ComponentRegistry } from '@object-ui/core';
-
-// Importing the entry runs `registerAllFields()` at module load — the live path.
-import { registerAllFields, FORM_FIELD_TYPES } from '../index';
-
-const RETIRED = 'capability-multiselect';
-
-/**
- * Every key the retired docs-demo path (`registerFields()`) registered, minus the
- * retired one. Spelled out rather than derived so a future edit that silently
- * drops one of these registrations fails here instead of passing vacuously.
- * The live path registers these AND more (`multiselect`, `radio`, `checkboxes`,
- * `tags`, `richtext`, and the widget-hint-only pickers) — this list is the floor
- * the retirement promised to leave intact, not the full live surface.
- */
-const RETAINED_FIELD_KEYS = [
-  'text', 'textarea', 'number', 'boolean', 'select', 'date', 'datetime', 'time',
-  'email', 'phone', 'url',
-  'currency', 'percent', 'password', 'markdown', 'html', 'lookup', 'master_detail',
-  'file', 'image', 'location',
-  'formula', 'summary', 'auto_number',
-  'user', 'owner',
-  'object', 'vector', 'grid',
-  'color', 'slider', 'rating', 'code', 'avatar', 'address', 'geolocation',
-  'signature', 'qrcode',
-] as const;
-
-describe('capability-multiselect widget retirement (objectui#3308)', () => {
-  it('is absent on the live registerAllFields() path', () => {
-    registerAllFields();
-    expect(ComponentRegistry.get(`field:${RETIRED}`)).toBeUndefined();
-    expect(ComponentRegistry.get(RETIRED)).toBeUndefined();
-  });
-
-  it('is not in fieldWidgetMap, so no bare field type can reach it either', () => {
-    expect(FORM_FIELD_TYPES).not.toContain(RETIRED);
-  });
-
-  it('registers every retained field key (retirement subtracts exactly one)', () => {
-    registerAllFields();
-    for (const key of RETAINED_FIELD_KEYS) {
-      expect(
-        ComponentRegistry.get(`field:${key}`),
-        `field:${key} must survive the retirement`,
-      ).toBeTruthy();
-    }
-    expect(RETAINED_FIELD_KEYS).toHaveLength(38);
-  });
-
-  it('has no second registration path left to shadow the live one (objectui#3910)', async () => {
-    // The defect ruling B closed was structural, not cosmetic: `registerFields()`
-    // re-registered the SAME `field:<type>` keys with demo-only wrappers, so
-    // whichever ran last won the registry for every consumer sharing it. Pinning
-    // the export gone is what stops it growing back under a new name.
-    const entry = (await import('../index')) as Record<string, unknown>;
-    expect(entry.registerFields).toBeUndefined();
-    expect(entry.createFieldRenderer).toBeUndefined();
-    // The surviving seam is still exported — this test must fail loudly if the
-    // removal ever takes the live path with it.
-    expect(typeof entry.registerAllFields).toBe('function');
-    expect(typeof entry.registerField).toBe('function');
-  });
-});