@happyvertical/smrt-svelte 0.55.2 → 0.55.4

package/README.md

@@ -587,7 +587,7 @@ clears it.
 
 ### Components by Category
 
-**Forms**: `AddressInput`, `CheckboxInput`, `DateRangeInput`, `DateTimeInput`, `FileUpload`, `Form`, `FormGroup`, `FormMicButton`, `Input`, `MeasurementInput`, `MoneyInput`, `NumberInput`, `PhoneInput`, `RelationInput`, `SearchInput`, `Select`, `SelectInput`, `Textarea`, `TextareaInput`, `TextInput`, `Toggle`
+**Forms**: `AddressInput`, `CheckboxInput`, `DateRangeInput`, `DateTimeInput`, `FileUpload`, `Form`, `FormGroup`, `FormMicButton`, `Input`, `MeasurementInput`, `MoneyInput`, `NumberInput`, `PhoneInput`, `RelationInput` (deprecated re-export; import from `@happyvertical/smrt-ui/forms`), `SearchInput`, `Select`, `SelectInput`, `Textarea`, `TextareaInput`, `TextInput`, `Toggle`
 
 **Layout**: `Container`, `EmptyState`, `Footer`, `Grid`, `Header`, `Masthead`, `PageHeader`, `SummaryCard`
 

package/agents/components.md

@@ -15,7 +15,7 @@ the top-of-stack, domain-aware pieces:
 | Category | Components |
 |----------|------------|
 | AI | `Provider`, `AILoadingOverlay`, `CapabilityGate`, `DownloadProgress`, `STTTest`, `VoiceInput` |
-| Forms (`/forms`) | `TextInput`, `Select`, `MoneyInput`, `DateTimeInput`, `Toggle`, `FileUpload`, `AddressInput`, `RelationInput`, + more (AI-wired inputs use the hooks/browser-ai here) |
+| Forms (`/forms`) | `TextInput`, `Select`, `MoneyInput`, `DateTimeInput`, `Toggle`, `FileUpload`, `AddressInput`, + more (`RelationInput` is a deprecated re-export of smrt-ui's) (AI-wired inputs use the hooks/browser-ai here) |
 | Module | `ModulePanel` |
 | Settings (`/settings`) | `SettingsCatalog`, `paginateSettingsCatalog` |
 | Audit (root export) | `RecordHistory`, `AuditList` — authorized data props; [contract](../../../docs/content/audit-trail.md) |
@@ -50,47 +50,13 @@ migrate domain re-rolls *onto* them rather than build new primitives:
   flow.
 - **`Card`** (`./ui`) — the standard surface/container; retire local card CSS.
 
-### `RelationInput` (`./forms`, #3600)
-
-Searchable single-select for relation (foreign-key) fields, a thin wrapper over
-the smrt-ui `Combobox`. It is presentation only: the caller supplies the data,
-so the same lookup an assistant uses to turn "Acme" into a record id backs the
-picker. Option shape is `RelationOption` — `{ id, label, detail? }`.
-
-- **Props.** `name`, `label`, `value` (bindable id, `''` = none), `required`,
-  `disabled`, `error`, `placeholder`, `description`, `search(query)`, optional
-  `resolve(id)` and `onCreate(query)`, plus `debounceMs` (250), `interaction`,
-  `onchange` and overridable text (`createLabel`, `clearLabel`, `loadingText`,
-  `emptyText`, `errorText`, `resultsText`).
-- **`search`** runs with `''` when the list opens and then debounced per
-  keystroke; a response for a superseded query is dropped. A rejected search
-  shows `errorText` and the next keystroke retries.
-- **`resolve`** supplies the label of a `value` that has not been searched yet
-  (initial value, parent rebind, form reset). Without it such a value shows an
-  empty field, never the raw id. A `null` result also leaves the field empty.
-- **`onCreate`** adds a "New ..." button; it receives the text most recently
-  searched for and may return the created `RelationOption`, which is selected.
-- **Form integration** is through `Combobox`'s control registration (rich `Form`
-  provides the registry), not a `FieldDefinition`: agents see a `combobox`
-  control whose value is the id. The form posts the id under `name`.
-- **Known limit.** An agent staging a value through the registered control can
-  only choose among the options last listed (the registry matches against
-  `options`; `allowCustom` is off), so it cannot write an id it has not
-  searched. It fails closed. Writing a resolved id needs an async hook on
-  `Combobox` and is tracked separately.
-- **Stale options.** Typing clears the listed options until the new search
-  answers, so Enter or a click can never pick a record for an older query.
-- **Clear button** shows only when not `required`, not `disabled`, and a value
-  is set; it returns focus to the field.
-- **Accessibility** is the combobox pattern (`role=combobox`, `aria-expanded`,
-  `aria-activedescendant`, listbox/option, Arrow/Enter/Escape) plus a polite
-  `role=status` live region announcing searching / "N results" / no matches,
-  `aria-busy` while fetching, and `aria-invalid` + `aria-describedby` for
-  `error` and `description`.
-- Options render `detail` under the label, so the option's accessible name
-  includes it. The `Combobox` additions that make this possible (`filter`,
-  `onquery`, `status`, `busy`, `invalid`, `describedby`, `optionContent`) are
-  generic and default to the previous behaviour.
+### `RelationInput` (moved to smrt-ui, #3637)
+
+`RelationInput` (#3600) now lives in `@happyvertical/smrt-ui/forms` next to
+`Combobox`; its contract is documented in the smrt-ui README ("RelationInput").
+`@happyvertical/smrt-svelte/forms` still re-exports it (and `RelationOption`),
+marked `@deprecated`, so published consumers keep working. New code imports it
+from smrt-ui.
 
 ### Import convention (S10 #1415)
 
@@ -102,7 +68,7 @@ library. Which barrel for what:
 | Need | Import from |
 |------|-------------|
 | Buttons, cards, badges, avatars, chips, skeletons, tooltips, dropdowns, trees, pagination | `@happyvertical/smrt-ui/ui` |
-| Provider-free base inputs — `Input`, `Select`, `Textarea`, `Toggle`, `FormGroup` | `@happyvertical/smrt-ui/forms` (also re-exported from `@happyvertical/smrt-svelte/forms`) |
+| Provider-free base inputs — `Input`, `Select`, `Textarea`, `Toggle`, `FormGroup`, `Combobox`, `RelationInput` | `@happyvertical/smrt-ui/forms` (also re-exported from `@happyvertical/smrt-svelte/forms`) |
 | Provider-free `Form` (plain `<form>` wrapper) | `@happyvertical/smrt-ui/forms` **only** — `@happyvertical/smrt-svelte/forms` exports the *rich* Provider-backed `Form` under that name, so import the plain one straight from smrt-ui |
 | Provider-backed inputs — `TextInput`, `NumberInput`, `MoneyInput`, date/measurement/address inputs, `CheckboxInput`, file upload, the rich `Form` | `@happyvertical/smrt-svelte/forms` |
 | `Modal`, `ConfirmDialog`, `LoadingOverlay`, `ProgressBar` | `@happyvertical/smrt-ui/feedback` |

package/agents/workspace.md

@@ -45,6 +45,14 @@ App settings, tenant names and environment badges wrap within narrow drawers.
 system bars never clip wrapped chips. Custom bars must allow this flex child
 to shrink; use safe alignment if aligning its contents to the end.
 
+Sidebar-only shells may set `top: false`. In that mode the configured brand is
+shown at the top of the expanded tenant panel as well as in the compact rail.
+Use `tenantRailFooter` for a control pinned below collapsed navigation; it sits
+outside the rail's scroll clip so menus can open over the workspace. Pair it
+with `WorkspaceAccountMenu compact` for an avatar-only trigger that retains the
+full account identity as its accessible name. Keep the ordinary
+`tenantFooter` for the expanded panel.
+
 ### Responsive chrome, viewport defaults, resizable edges
 
 The root grid has five rows: `header` · top edge · body · bottom edge · phone

package/dist/components/forms/index.d.ts

@@ -8,7 +8,12 @@
  * one-stop barrel for form primitives. The Provider-REQUIRED inputs (the rich
  * `Form`, `CheckboxInput`, `TextInput`, …) still live in this package.
  */
-export { FormGroup, Input, Select, Textarea, Toggle, } from '@happyvertical/smrt-ui/forms';
+export { FormGroup, Input, 
+/**
+ * @deprecated `RelationInput` moved to `@happyvertical/smrt-ui/forms`; import it
+ * from there. This re-export is kept so published consumers keep working.
+ */
+RelationInput, Select, Textarea, Toggle, } from '@happyvertical/smrt-ui/forms';
 export { default as AddressInput } from './AddressInput.svelte';
 export { default as CheckboxInput } from './CheckboxInput.svelte';
 export { default as DateRangeInput } from './DateRangeInput.svelte';
@@ -21,7 +26,6 @@ export { default as MeasurementInput } from './MeasurementInput.svelte';
 export { default as MoneyInput } from './MoneyInput.svelte';
 export { default as NumberInput } from './NumberInput.svelte';
 export { default as PhoneInput } from './PhoneInput.svelte';
-export { default as RelationInput } from './RelationInput.svelte';
 export { default as SearchInput } from './SearchInput.svelte';
 export { default as SelectInput } from './SelectInput.svelte';
 export { default as TextareaInput } from './TextareaInput.svelte';

package/dist/components/forms/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/forms/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EACL,SAAS,EACT,KAAK,EACL,MAAM,EACN,QAAQ,EACR,MAAM,GACP,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AACxE,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAG1D,YAAY,EACV,YAAY,EACZ,cAAc,EACd,UAAU,EACV,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,cAAc,GACf,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/forms/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EACL,SAAS,EACT,KAAK;AACL;;;GAGG;AACH,aAAa,EACb,MAAM,EACN,QAAQ,EACR,MAAM,GACP,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AACxE,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAG1D,YAAY,EACV,YAAY,EACZ,cAAc,EACd,UAAU,EACV,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,cAAc,GACf,MAAM,YAAY,CAAC"}

package/dist/components/forms/index.js

@@ -9,7 +9,12 @@
  * `Form`, `CheckboxInput`, `TextInput`, …) still live in this package.
  */
 // Provider-free base primitives — relocated to the smrt-ui leaf (#1589).
-export { FormGroup, Input, Select, Textarea, Toggle, } from '@happyvertical/smrt-ui/forms';
+export { FormGroup, Input, 
+/**
+ * @deprecated `RelationInput` moved to `@happyvertical/smrt-ui/forms`; import it
+ * from there. This re-export is kept so published consumers keep working.
+ */
+RelationInput, Select, Textarea, Toggle, } from '@happyvertical/smrt-ui/forms';
 // SMRT-enhanced form components with voice support (v2.0 naming)
 export { default as AddressInput } from './AddressInput.svelte';
 export { default as CheckboxInput } from './CheckboxInput.svelte';
@@ -23,7 +28,6 @@ export { default as MeasurementInput } from './MeasurementInput.svelte';
 export { default as MoneyInput } from './MoneyInput.svelte';
 export { default as NumberInput } from './NumberInput.svelte';
 export { default as PhoneInput } from './PhoneInput.svelte';
-export { default as RelationInput } from './RelationInput.svelte';
 export { default as SearchInput } from './SearchInput.svelte';
 export { default as SelectInput } from './SelectInput.svelte';
 export { default as TextareaInput } from './TextareaInput.svelte';

package/dist/components/forms/types.d.ts

@@ -10,15 +10,12 @@ export interface SelectOption {
     value: string;
     label: string;
 }
-/** A searchable relation target for the RelationInput component */
-export interface RelationOption {
-    /** Record id; this is the value the form posts. */
-    id: string;
-    /** Human-readable name shown in the field and the list. */
-    label: string;
-    /** Secondary text shown under the label in the list. */
-    detail?: string;
-}
+/**
+ * A searchable relation target for the RelationInput component.
+ *
+ * @deprecated Moved to `@happyvertical/smrt-ui/forms`; import it from there.
+ */
+export type { RelationOption } from '@happyvertical/smrt-ui/forms';
 /** Address value for SMRTAddress component */
 export interface AddressValue {
     street: string;

package/dist/components/forms/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/forms/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,kCAAkC;AAClC,MAAM,MAAM,cAAc,GAAG,gBAAgB,GAAG,cAAc,GAAG,aAAa,CAAC;AAE/E,wCAAwC;AACxC,MAAM,MAAM,UAAU,GAClB,MAAM,GACN,cAAc,GACd,cAAc,GACd,cAAc,GACd,cAAc,CAAC;AAEnB,sCAAsC;AACtC,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,mEAAmE;AACnE,MAAM,WAAW,cAAc;IAC7B,mDAAmD;IACnD,EAAE,EAAE,MAAM,CAAC;IACX,2DAA2D;IAC3D,KAAK,EAAE,MAAM,CAAC;IACd,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,8CAA8C;AAC9C,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,mDAAmD;AACnD,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,6BAA6B;AAC7B,MAAM,MAAM,eAAe,GAAG,IAAI,GAAG,IAAI,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAErE,sDAAsD;AACtD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,eAAe,CAAC;CACvB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/forms/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,kCAAkC;AAClC,MAAM,MAAM,cAAc,GAAG,gBAAgB,GAAG,cAAc,GAAG,aAAa,CAAC;AAE/E,wCAAwC;AACxC,MAAM,MAAM,UAAU,GAClB,MAAM,GACN,cAAc,GACd,cAAc,GACd,cAAc,GACd,cAAc,CAAC;AAEnB,sCAAsC;AACtC,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,YAAY,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAEnE,8CAA8C;AAC9C,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,mDAAmD;AACnD,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,6BAA6B;AAC7B,MAAM,MAAM,eAAe,GAAG,IAAI,GAAG,IAAI,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAErE,sDAAsD;AACtD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,eAAe,CAAC;CACvB"}

package/dist/components/workspace/admin-shell/AdminShell.svelte

@@ -81,6 +81,8 @@ function buildLayoutStyle(shell: ModuleShellState): string {
     appPanel?: Snippet;
     /** Content for the left tenant rail. */
     tenantRail?: Snippet;
+    /** Content pinned below the collapsed tenant rail. */
+    tenantRailFooter?: Snippet;
     /** Content for the left tenant panel. */
     tenantPanel?: Snippet;
     /** Content for the tenant panel footer. */
@@ -164,6 +166,7 @@ function buildLayoutStyle(shell: ModuleShellState): string {
     account,
     appPanel,
     tenantRail,
+    tenantRailFooter,
     tenantPanel,
     tenantFooter,
     focusRail,
@@ -239,8 +242,19 @@ function buildLayoutStyle(shell: ModuleShellState): string {
     });
     return () => { cancelled = true; queueMicrotask(() => { if (opener?.isConnected) opener.focus(); }); };
   });
-  const showPhoneTop = $derived(isPhone && Boolean(phoneTopBar));
-  const showHeader = $derived(Boolean(header) && !showPhoneTop);
+  const showDefaultPhoneTenantOpener = $derived(
+    isPhone &&
+      !phoneTopBar &&
+      panelState('top') === 'hidden' &&
+      shell.isEdgeShown('left') &&
+      shell.phonePresentation('left') !== 'hidden',
+  );
+  const showPhoneTop = $derived(
+    isPhone && (Boolean(phoneTopBar) || showDefaultPhoneTenantOpener),
+  );
+  const showHeader = $derived(
+    Boolean(header) && !(isPhone && Boolean(phoneTopBar)),
+  );
   const bottomBar = $derived<BottomBarMode>(
     isPhone && phoneBottomBar
       ? bottomBarMode({ formActions, keyboardOpen })
@@ -598,7 +612,12 @@ function buildLayoutStyle(shell: ModuleShellState): string {
     handle.addEventListener('lostpointercapture', onEnd);
   }
 
-  const footerInHeader = $derived(!account && !!tenantFooter && (!shell.isEdgeShown('left') || !edgeExpanded('left')));
+  const footerInHeader = $derived(
+    !account &&
+      !!tenantFooter &&
+      (!shell.isEdgeShown('left') ||
+        (!edgeExpanded('left') && !tenantRailFooter)),
+  );
 
   const layoutStyle = $derived(buildLayoutStyle(shell));
 
@@ -883,7 +902,9 @@ function buildLayoutStyle(shell: ModuleShellState): string {
     >
       {@render resizer('left')}
       <div class="smrt-admin-shell__rail">
-        {#if !edgeExpanded('left') && (homeHref || logoSrc || brand)}{@render shellBrand(true)}{/if}
+        {#if (panelState('top') === 'hidden' || !edgeExpanded('left')) && (homeHref || logoSrc || brand)}
+          {@render shellBrand(!edgeExpanded('left'))}
+        {/if}
         {#if showTenantToggle}{@render edgeToggle('left')}{/if}
         {#if shownOpen('left') || (tenantPanel && keepsContent('left'))}
           <div
@@ -904,8 +925,19 @@ function buildLayoutStyle(shell: ModuleShellState): string {
             {/if}
           </div>
         {/if}
-        {#if !shownOpen('left') && tenantRail}
-          {@render tenantRail()}
+        {#if !shownOpen('left') && (tenantRail || tenantRailFooter)}
+          <div class="smrt-admin-shell__tenant-rail-stack">
+            {#if tenantRail}
+              <div class="smrt-admin-shell__tenant-rail-content">
+                {@render tenantRail()}
+              </div>
+            {/if}
+            {#if tenantRailFooter}
+              <div class="smrt-admin-shell__tenant-rail-footer">
+                {@render tenantRailFooter()}
+              </div>
+            {/if}
+          </div>
         {/if}
       </div>
     </aside>
@@ -922,7 +954,24 @@ function buildLayoutStyle(shell: ModuleShellState): string {
 
   {#if showPhoneTop}
     <div class="smrt-admin-shell__phone-top" data-testid="admin-shell-phone-top">
-      {@render phoneTopBar?.({ hidden: chromeHidden })}
+      {#if phoneTopBar}
+        {@render phoneTopBar({ hidden: chromeHidden })}
+      {:else if showDefaultPhoneTenantOpener}
+        <div class="smrt-admin-shell__phone-default-top">
+          <Button
+            variant="ghost"
+            size="sm"
+            aria-label={t(M['ui.admin_shell.menu'])}
+            aria-expanded={edgeExpanded('left')}
+            aria-controls="smrt-admin-shell-left-panel"
+            onclick={() =>
+              shell.setPanelState(
+                'left',
+                edgeExpanded('left') ? 'collapsed' : 'expanded',
+              )}
+          >{t(M['ui.admin_shell.menu'])}</Button>
+        </div>
+      {/if}
     </div>
   {/if}
 
@@ -1424,6 +1473,7 @@ function buildLayoutStyle(shell: ModuleShellState): string {
     display: flex;
     flex-direction: column;
     gap: var(--smrt-spacing-2);
+    overflow: visible;
   }
 
   /* A collapsed `keepMounted` edge keeps its panel in the DOM but hidden;
@@ -1456,6 +1506,30 @@ function buildLayoutStyle(shell: ModuleShellState): string {
     border-block-start: 1px solid var(--smrt-color-outline-variant);
   }
 
+  .smrt-admin-shell__tenant-rail-stack {
+    display: grid;
+    grid-template-rows: minmax(0, 1fr) auto;
+    flex: 1;
+    min-width: 0;
+    min-height: 0;
+  }
+
+  .smrt-admin-shell__tenant-rail-content {
+    min-width: 0;
+    min-height: 0;
+    overflow: auto;
+  }
+
+  .smrt-admin-shell__tenant-rail-footer {
+    position: relative;
+    z-index: 1;
+    grid-row: 2;
+    min-width: 0;
+    padding-block-start: var(--smrt-spacing-2);
+    border-block-start: 1px solid var(--smrt-color-outline-variant);
+    overflow: visible;
+  }
+
   .smrt-admin-shell__edge--right[data-state='expanded']
     .smrt-admin-shell__rail {
     grid-column: 2;
@@ -1643,6 +1717,13 @@ function buildLayoutStyle(shell: ModuleShellState): string {
       var(--smrt-easing-standard, ease);
   }
 
+  .smrt-admin-shell__phone-default-top {
+    display: flex;
+    align-items: center;
+    min-block-size: var(--smrt-admin-shell-phone-top-size);
+    padding-inline: var(--smrt-spacing-3);
+  }
+
   .smrt-admin-shell[data-chrome-hidden] .smrt-admin-shell__phone-top {
     transform: translateY(-100%);
   }

package/dist/components/workspace/admin-shell/AdminShell.svelte.d.ts

@@ -13,6 +13,8 @@ interface Props extends AdminShellProps {
     appPanel?: Snippet;
     /** Content for the left tenant rail. */
     tenantRail?: Snippet;
+    /** Content pinned below the collapsed tenant rail. */
+    tenantRailFooter?: Snippet;
     /** Content for the left tenant panel. */
     tenantPanel?: Snippet;
     /** Content for the tenant panel footer. */

package/dist/components/workspace/admin-shell/AdminShell.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AdminShell.svelte.d.ts","sourceRoot":"","sources":["../../../../src/components/workspace/admin-shell/AdminShell.svelte.ts"],"names":[],"mappings":"AA+CA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAQtC,OAAO,EAAE,KAAK,aAAa,EAAiB,MAAM,mBAAmB,CAAC;AAStE,OAAO,EAAoB,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACtE,OAAO,KAAK,EACR,sBAAsB,EACtB,eAAe,EAEf,cAAc,EACd,aAAa,EACd,MAAM,YAAY,CAAC;AAGpB,UAAU,KAAM,SAAQ,eAAe;IACrC,sEAAsE;IACtE,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,mCAAmC;IACnC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,qEAAqE;IACrE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,wCAAwC;IACxC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,yCAAyC;IACzC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,2CAA2C;IAC3C,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,wCAAwC;IACxC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,mEAAmE;IACnE,UAAU,CAAC,EAAE,OAAO,CAAC,CAAC;QAAE,IAAI,EAAE,cAAc,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC,CAAC;IACxD;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,oCAAoC;IACpC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,uCAAuC;IACvC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,wCAAwC;IACxC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,0CAA0C;IAC1C,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,2CAA2C;IAC3C,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,kDAAkD;IAClD,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC;QAAE,QAAQ,EAAE,aAAa,CAAA;KAAE,CAAC,CAAC,CAAC;IAChD;;;;;;;;;OASG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC,CAAC;QAAE,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC,CAAC;IAC7C;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC;QAAE,QAAQ,EAAE,aAAa,CAAC;QAAC,SAAS,EAAE,aAAa,CAAA;KAAE,CAAC,CAAC,CAAC;IAC5E,uEAAuE;IACvE,KAAK,CAAC,EAAE,sBAAsB,CAAC;IAC/B,qEAAqE;IACrE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;CACnB;AA82BH,QAAA,MAAM,UAAU,2CAAwC,CAAC;AACzD,KAAK,UAAU,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;AAChD,eAAe,UAAU,CAAC"}
+{"version":3,"file":"AdminShell.svelte.d.ts","sourceRoot":"","sources":["../../../../src/components/workspace/admin-shell/AdminShell.svelte.ts"],"names":[],"mappings":"AA+CA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAQtC,OAAO,EAAE,KAAK,aAAa,EAAiB,MAAM,mBAAmB,CAAC;AAStE,OAAO,EAAoB,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACtE,OAAO,KAAK,EACR,sBAAsB,EACtB,eAAe,EAEf,cAAc,EACd,aAAa,EACd,MAAM,YAAY,CAAC;AAGpB,UAAU,KAAM,SAAQ,eAAe;IACrC,sEAAsE;IACtE,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,mCAAmC;IACnC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,qEAAqE;IACrE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,wCAAwC;IACxC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,sDAAsD;IACtD,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,yCAAyC;IACzC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,2CAA2C;IAC3C,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,wCAAwC;IACxC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,mEAAmE;IACnE,UAAU,CAAC,EAAE,OAAO,CAAC,CAAC;QAAE,IAAI,EAAE,cAAc,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC,CAAC;IACxD;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,oCAAoC;IACpC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,uCAAuC;IACvC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,wCAAwC;IACxC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,0CAA0C;IAC1C,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,2CAA2C;IAC3C,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,kDAAkD;IAClD,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC;QAAE,QAAQ,EAAE,aAAa,CAAA;KAAE,CAAC,CAAC,CAAC;IAChD;;;;;;;;;OASG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC,CAAC;QAAE,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC,CAAC;IAC7C;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC;QAAE,QAAQ,EAAE,aAAa,CAAC;QAAC,SAAS,EAAE,aAAa,CAAA;KAAE,CAAC,CAAC,CAAC;IAC5E,uEAAuE;IACvE,KAAK,CAAC,EAAE,sBAAsB,CAAC;IAC/B,qEAAqE;IACrE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;CACnB;AAs5BH,QAAA,MAAM,UAAU,2CAAwC,CAAC;AACzD,KAAK,UAAU,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;AAChD,eAAe,UAAU,CAAC"}

package/dist/components/workspace/admin-shell/WorkspaceAccountMenu.svelte

@@ -13,6 +13,8 @@ export interface Props {
   userName: string;
   /** Target density; omit to inherit the theme density. */
   density?: 'comfortable' | 'touch';
+  /** Show only the avatar while preserving the full accessible account name. */
+  compact?: boolean;
   /** Custom display name for the user, falls back to userName. */
   userLabel?: string;
   /** URL for the user's avatar image. */
@@ -38,6 +40,7 @@ export interface Props {
 let {
   userName,
   density,
+  compact = false,
   userLabel = '',
   avatarUrl,
   tenantLabel = '',
@@ -103,10 +106,11 @@ function handleSelect(id: string): void {
 }
 </script>
 
-<div data-density={density} class="smrt-workspace-account-menu" title={summaryTitle}>
+<div data-density={density} data-compact={compact ? '' : undefined} class="smrt-workspace-account-menu" title={summaryTitle}>
   <Dropdown
     {items}
     {placement}
+    triggerLabel={compact ? `${t(M['ui.workspace_account_menu.open'])} ${summaryTitle}` : undefined}
     onselect={handleSelect}
     disabled={disabled || items.length === 0}
   >
@@ -161,6 +165,19 @@ function handleSelect(id: string): void {
     text-align: start;
   }
 
+  .smrt-workspace-account-menu[data-compact] :global(.dropdown__trigger) {
+    display: grid;
+    place-items: center;
+    grid-template-columns: minmax(0, 1fr);
+    padding: var(--smrt-spacing-1);
+  }
+
+  .smrt-workspace-account-menu[data-compact] .smrt-workspace-account-menu__identity,
+  .smrt-workspace-account-menu[data-compact] .smrt-workspace-account-menu__indicator,
+  .smrt-workspace-account-menu[data-compact] .smrt-workspace-account-menu__open {
+    display: none;
+  }
+
   .smrt-workspace-account-menu :global(.dropdown__menu) {
     box-sizing: border-box;
     width: 100%;

package/dist/components/workspace/admin-shell/WorkspaceAccountMenu.svelte.d.ts

@@ -5,6 +5,8 @@ export interface Props {
     userName: string;
     /** Target density; omit to inherit the theme density. */
     density?: 'comfortable' | 'touch';
+    /** Show only the avatar while preserving the full accessible account name. */
+    compact?: boolean;
     /** Custom display name for the user, falls back to userName. */
     userLabel?: string;
     /** URL for the user's avatar image. */

package/dist/components/workspace/admin-shell/WorkspaceAccountMenu.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WorkspaceAccountMenu.svelte.d.ts","sourceRoot":"","sources":["../../../../src/components/workspace/admin-shell/WorkspaceAccountMenu.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAY,MAAM,wBAAwB,CAAC;AAI1E,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAGzD,MAAM,WAAW,KAAK;IACpB,4DAA4D;IAC5D,QAAQ,EAAE,MAAM,CAAC;IACjB,yDAAyD;IACzD,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC;IAClC,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uCAAuC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mDAAmD;IACnD,OAAO,CAAC,EAAE,sBAAsB,EAAE,CAAC;IACnC,2CAA2C;IAC3C,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,sEAAsE;IACtE,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,wCAAwC;IACxC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,uDAAuD;IACvD,cAAc,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;CACxB;AAsGD,QAAA,MAAM,oBAAoB,2CAAwC,CAAC;AACnE,KAAK,oBAAoB,GAAG,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC;AACpE,eAAe,oBAAoB,CAAC"}
+{"version":3,"file":"WorkspaceAccountMenu.svelte.d.ts","sourceRoot":"","sources":["../../../../src/components/workspace/admin-shell/WorkspaceAccountMenu.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAY,MAAM,wBAAwB,CAAC;AAI1E,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAGzD,MAAM,WAAW,KAAK;IACpB,4DAA4D;IAC5D,QAAQ,EAAE,MAAM,CAAC;IACjB,yDAAyD;IACzD,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC;IAClC,8EAA8E;IAC9E,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uCAAuC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mDAAmD;IACnD,OAAO,CAAC,EAAE,sBAAsB,EAAE,CAAC;IACnC,2CAA2C;IAC3C,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,sEAAsE;IACtE,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,wCAAwC;IACxC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,uDAAuD;IACvD,cAAc,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;CACxB;AAuGD,QAAA,MAAM,oBAAoB,2CAAwC,CAAC;AACnE,KAAK,oBAAoB,GAAG,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC;AACpE,eAAe,oBAAoB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@happyvertical/smrt-svelte",
-  "version": "0.55.2",
+  "version": "0.55.4",
   "smrtJsdoc": "strict",
   "description": "Svelte 5 components for SMRT user management - auth, users, tenants, roles, permissions, groups",
   "type": "module",
@@ -148,12 +148,12 @@
     "access": "public"
   },
   "dependencies": {
-    "@happyvertical/logger": "^0.102.2",
-    "@happyvertical/smrt-languages": "0.55.2",
-    "@happyvertical/smrt-mcp-apps": "0.55.2",
-    "@happyvertical/smrt-types": "0.55.2",
-    "@happyvertical/smrt-ui": "0.55.2",
-    "@happyvertical/smrt-web": "0.55.2",
+    "@happyvertical/logger": "^0.102.3",
+    "@happyvertical/smrt-languages": "0.55.4",
+    "@happyvertical/smrt-mcp-apps": "0.55.4",
+    "@happyvertical/smrt-types": "0.55.4",
+    "@happyvertical/smrt-ui": "0.55.4",
+    "@happyvertical/smrt-web": "0.55.4",
     "@tanstack/db": "^0.6.14",
     "@tanstack/svelte-db": "^0.1.91",
     "esm-env": "^1.2.2"
@@ -188,14 +188,14 @@
     }
   },
   "devDependencies": {
-    "@happyvertical/smrt-agents": "0.55.2",
-    "@happyvertical/smrt-chat": "0.55.2",
-    "@happyvertical/smrt-content": "0.55.2",
-    "@happyvertical/smrt-core": "0.55.2",
-    "@happyvertical/smrt-reports": "0.55.2",
-    "@happyvertical/smrt-scanner": "0.55.2",
-    "@happyvertical/smrt-tenancy": "0.55.2",
-    "@happyvertical/smrt-users": "0.55.2",
+    "@happyvertical/smrt-agents": "0.55.4",
+    "@happyvertical/smrt-chat": "0.55.4",
+    "@happyvertical/smrt-content": "0.55.4",
+    "@happyvertical/smrt-core": "0.55.4",
+    "@happyvertical/smrt-reports": "0.55.4",
+    "@happyvertical/smrt-scanner": "0.55.4",
+    "@happyvertical/smrt-tenancy": "0.55.4",
+    "@happyvertical/smrt-users": "0.55.4",
     "@sveltejs/package": "^2.5.8",
     "@sveltejs/vite-plugin-svelte": "^7.3.0",
     "@testing-library/jest-dom": "^7.0.1",

package/dist/components/forms/RelationInput.svelte

@@ -1,379 +0,0 @@
-<script lang="ts">
-import { Button } from '@happyvertical/smrt-ui';
-import {
-  Combobox,
-  type ControlInteractionOptions,
-  emitControlChange,
-  recordControlUserEdit,
-  tryGetControlInteractionContext,
-} from '@happyvertical/smrt-ui/forms';
-import { untrack } from 'svelte';
-import { logger } from '../../internal/logger.js';
-import type { RelationOption } from './types.js';
-
-/**
- * RelationInput - searchable single-select for relation (foreign key) fields.
- *
- * Presentation only: the caller supplies `search` (and optionally `resolve`),
- * so the same lookup an assistant uses to turn "Acme" into a record id backs
- * the picker. Built on the smrt-ui `Combobox`, which supplies the ARIA 1.2
- * combobox pattern (arrow keys, Enter, Escape, `aria-activedescendant`) and
- * registers with the rich Form's control registry. The form posts the
- * committed id under `name`, never the visible label.
- *
- * @example
- * ```svelte
- * <RelationInput
- *   name="customerId"
- *   label="Customer"
- *   bind:value={customerId}
- *   search={(q) => customers.search(q)}
- *   resolve={(id) => customers.byId(id)}
- * />
- * ```
- */
-export interface Props {
-  /** Field name; the selected id posts under it. */
-  name: string;
-  /** Visible label. */
-  label: string;
-  /** Selected record id (bindable). Empty string means no selection. */
-  value?: string;
-  /** Required field: hides the clear button and flags an empty value. */
-  required?: boolean;
-  /** Disabled state. */
-  disabled?: boolean;
-  /** Validation error message, shown below the field. */
-  error?: string;
-  /** Placeholder shown when nothing is selected. */
-  placeholder?: string;
-  /** Hint announced with the field. */
-  description?: string;
-  /** Look up records matching the text; called with '' when the list opens. */
-  search: (query: string) => Promise<RelationOption[]>;
-  /** Look up the current value's label when it has not been searched yet. */
-  resolve?: (id: string) => Promise<{ id: string; label: string } | null>;
-  /**
-   * "New ..." action. Receives the text most recently searched for. May
-   * return the created record, which is then selected.
-   */
-  onCreate?: (
-    query: string,
-  ) => void | RelationOption | Promise<void | RelationOption>;
-  /** Milliseconds to wait after typing before searching. */
-  debounceMs?: number;
-  /** Combobox interaction options (stable id, subject) for agents. */
-  interaction?: ControlInteractionOptions | false;
-  /** Text for the "New ..." button. */
-  createLabel?: string;
-  /** Accessible name for the clear button. */
-  clearLabel?: string;
-  /** Status text while searching. */
-  loadingText?: string;
-  /** Status text when nothing matches. */
-  emptyText?: string;
-  /** Status text when the search fails. */
-  errorText?: string;
-  /** Status text announcing how many results are listed. */
-  resultsText?: (count: number) => string;
-  /** Called when the selected id changes ('' when cleared). */
-  onchange?: (value: string) => void;
-}
-
-let {
-  name,
-  label,
-  value = $bindable(''),
-  required = false,
-  disabled = false,
-  error,
-  placeholder,
-  description,
-  search,
-  resolve,
-  onCreate,
-  debounceMs = 250,
-  interaction,
-  createLabel,
-  clearLabel,
-  loadingText = 'Searching…',
-  emptyText = 'No matches',
-  errorText = 'Search failed. Try again.',
-  resultsText = (count: number) =>
-    `${count} ${count === 1 ? 'result' : 'results'} available`,
-  onchange,
-}: Props = $props();
-
-const instanceId = $props.id();
-const errorId = `${instanceId}-error`;
-const hintId = `${instanceId}-hint`;
-const interactionContext = tryGetControlInteractionContext();
-
-let rootEl = $state<HTMLDivElement | null>(null);
-let results = $state<RelationOption[]>([]);
-let loading = $state(false);
-let failed = $state(false);
-let selectedLabel = $state('');
-let creating = $state(false);
-
-// Plain bookkeeping, deliberately not reactive.
-let labelledId = '';
-let resolvingId = '';
-let searchSeq = 0;
-let lastQuery = '';
-let timer: ReturnType<typeof setTimeout> | undefined;
-
-const options = $derived(
-  results.map((item) => ({ value: item.id, label: item.label })),
-);
-const detailById = $derived(
-  new Map(results.map((item) => [item.id, item.detail])),
-);
-const status = $derived(
-  loading
-    ? loadingText
-    : failed
-      ? errorText
-      : results.length === 0
-        ? emptyText
-        : resultsText(results.length),
-);
-const describedby = $derived(
-  [error ? errorId : '', description ? hintId : ''].filter(Boolean).join(' ') ||
-    undefined,
-);
-const controlId = $derived(
-  interaction === false ? undefined : (interaction?.id ?? name),
-);
-const canClear = $derived(!required && !disabled && value !== '');
-const newLabel = $derived(createLabel ?? `New ${label.toLowerCase()}`);
-
-async function runSearch(query: string) {
-  const seq = ++searchSeq;
-  loading = true;
-  failed = false;
-  try {
-    const found = await search(query);
-    if (seq !== searchSeq) return;
-    results = found;
-  } catch (err) {
-    if (seq !== searchSeq) return;
-    results = [];
-    failed = true;
-    logger.warn('[smrt-svelte] RelationInput search failed', {
-      error: String(err),
-    });
-  } finally {
-    if (seq === searchSeq) loading = false;
-  }
-}
-
-function handleQuery(query: string) {
-  clearTimeout(timer);
-  lastQuery = query;
-  if (query === '') {
-    // Opening the list: no typing to wait for.
-    void runSearch('');
-    return;
-  }
-  // Show "Searching" straight away and drop any in-flight older request. The
-  // listed options answered an older query, so none stay selectable (Enter or
-  // a click would otherwise pick a record that no longer matches the text).
-  searchSeq++;
-  loading = true;
-  failed = false;
-  results = [];
-  timer = setTimeout(() => void runSearch(query), debounceMs);
-}
-
-function handleValueChange(next: string) {
-  lastQuery = '';
-  const hit = results.find((item) => item.id === next);
-  if (hit) {
-    selectedLabel = hit.label;
-    labelledId = next;
-  }
-  onchange?.(next);
-}
-
-function focusInput() {
-  rootEl?.querySelector<HTMLInputElement>('input[role="combobox"]')?.focus();
-}
-
-function clear() {
-  if (!canClear) return;
-  value = '';
-  selectedLabel = '';
-  labelledId = '';
-  lastQuery = '';
-  onchange?.('');
-  recordControlUserEdit(
-    interactionContext,
-    controlId,
-    interaction === false ? undefined : interaction?.subject,
-  );
-  if (rootEl) emitControlChange(rootEl);
-  focusInput();
-}
-
-async function create() {
-  if (!onCreate || creating || disabled) return;
-  // The field has already lost focus (and reset its text) by now, so use the
-  // text most recently searched for.
-  const typed = lastQuery;
-  creating = true;
-  try {
-    const made = await onCreate(typed);
-    if (made && typeof made === 'object') {
-      results = [made, ...results.filter((item) => item.id !== made.id)];
-      selectedLabel = made.label;
-      labelledId = made.id;
-      value = made.id;
-      onchange?.(made.id);
-      recordControlUserEdit(
-        interactionContext,
-        controlId,
-        interaction === false ? undefined : interaction?.subject,
-      );
-      if (rootEl) emitControlChange(rootEl);
-    }
-  } catch (err) {
-    logger.warn('[smrt-svelte] RelationInput onCreate failed', {
-      error: String(err),
-    });
-  } finally {
-    creating = false;
-  }
-}
-
-// Keep the visible label in step with `value` however it changed (initial
-// value, parent rebind, form reset): known from a search, else resolved.
-$effect(() => {
-  const id = value;
-  const known = results.find((item) => item.id === id);
-  untrack(() => {
-    if (!id) {
-      selectedLabel = '';
-      labelledId = '';
-      return;
-    }
-    if (id === labelledId) return;
-    if (known) {
-      selectedLabel = known.label;
-      labelledId = id;
-      return;
-    }
-    // A different id than the one labelled: never keep the previous label.
-    selectedLabel = '';
-    labelledId = '';
-    if (!resolve || resolvingId === id) return;
-    resolvingId = id;
-    resolve(id)
-      .then((record) => {
-        if (value === id && record) {
-          selectedLabel = record.label;
-          labelledId = id;
-        }
-      })
-      .catch((err) => {
-        logger.warn('[smrt-svelte] RelationInput resolve failed', {
-          error: String(err),
-        });
-      })
-      .finally(() => {
-        if (resolvingId === id) resolvingId = '';
-      });
-  });
-});
-
-$effect(() => () => clearTimeout(timer));
-</script>
-
-<div class="relation-input" bind:this={rootEl}>
-  <div class="field">
-    <Combobox
-      {name}
-      {label}
-      {options}
-      {placeholder}
-      {disabled}
-      {required}
-      {interaction}
-      {status}
-      {describedby}
-      bind:value
-      valueLabel={selectedLabel}
-      filter={false}
-      busy={loading}
-      invalid={!!error}
-      onquery={handleQuery}
-      onvaluechange={handleValueChange}
-    >
-      {#snippet optionContent(option)}
-        <span class="option-label">{option.label}</span>
-        {#if detailById.get(String(option.value))}
-          <span class="option-detail">{detailById.get(String(option.value))}</span>
-        {/if}
-      {/snippet}
-    </Combobox>
-    {#if canClear}
-      <Button
-        variant="ghost"
-        size="sm"
-        class="clear"
-        aria-label={clearLabel ?? `Clear ${label}`}
-        onclick={clear}
-      >
-        &times;
-      </Button>
-    {/if}
-  </div>
-  {#if description}<p id={hintId} class="hint">{description}</p>{/if}
-  {#if onCreate}
-    <Button
-      variant="ghost"
-      size="sm"
-      class="create"
-      disabled={disabled || creating}
-      onclick={create}
-    >
-      + {newLabel}
-    </Button>
-  {/if}
-  {#if error}<p id={errorId} class="error" role="alert">{error}</p>{/if}
-</div>
-
-<style>
-  .relation-input {
-    display: grid;
-    gap: var(--smrt-spacing-1, 4px);
-    min-width: 0;
-  }
-  .field {
-    position: relative;
-  }
-  .field :global(.clear) {
-    position: absolute;
-    right: var(--smrt-spacing-1, 4px);
-    bottom: var(--smrt-spacing-1, 4px);
-  }
-  .option-label,
-  .option-detail {
-    display: block;
-  }
-  .option-detail {
-    font-size: var(--smrt-typography-body-small-size, 0.75rem);
-    color: var(--smrt-color-on-surface-variant);
-  }
-  .hint,
-  .error {
-    margin: 0;
-    font-size: var(--smrt-typography-body-small-size, 0.75rem);
-  }
-  .hint {
-    color: var(--smrt-color-on-surface-variant);
-  }
-  .error {
-    color: var(--smrt-color-error);
-  }
-</style>

package/dist/components/forms/RelationInput.svelte.d.ts

@@ -1,75 +0,0 @@
-import { type ControlInteractionOptions } from '@happyvertical/smrt-ui/forms';
-import type { RelationOption } from './types.js';
-/**
- * RelationInput - searchable single-select for relation (foreign key) fields.
- *
- * Presentation only: the caller supplies `search` (and optionally `resolve`),
- * so the same lookup an assistant uses to turn "Acme" into a record id backs
- * the picker. Built on the smrt-ui `Combobox`, which supplies the ARIA 1.2
- * combobox pattern (arrow keys, Enter, Escape, `aria-activedescendant`) and
- * registers with the rich Form's control registry. The form posts the
- * committed id under `name`, never the visible label.
- *
- * @example
- * ```svelte
- * <RelationInput
- *   name="customerId"
- *   label="Customer"
- *   bind:value={customerId}
- *   search={(q) => customers.search(q)}
- *   resolve={(id) => customers.byId(id)}
- * />
- * ```
- */
-export interface Props {
-    /** Field name; the selected id posts under it. */
-    name: string;
-    /** Visible label. */
-    label: string;
-    /** Selected record id (bindable). Empty string means no selection. */
-    value?: string;
-    /** Required field: hides the clear button and flags an empty value. */
-    required?: boolean;
-    /** Disabled state. */
-    disabled?: boolean;
-    /** Validation error message, shown below the field. */
-    error?: string;
-    /** Placeholder shown when nothing is selected. */
-    placeholder?: string;
-    /** Hint announced with the field. */
-    description?: string;
-    /** Look up records matching the text; called with '' when the list opens. */
-    search: (query: string) => Promise<RelationOption[]>;
-    /** Look up the current value's label when it has not been searched yet. */
-    resolve?: (id: string) => Promise<{
-        id: string;
-        label: string;
-    } | null>;
-    /**
-     * "New ..." action. Receives the text most recently searched for. May
-     * return the created record, which is then selected.
-     */
-    onCreate?: (query: string) => void | RelationOption | Promise<void | RelationOption>;
-    /** Milliseconds to wait after typing before searching. */
-    debounceMs?: number;
-    /** Combobox interaction options (stable id, subject) for agents. */
-    interaction?: ControlInteractionOptions | false;
-    /** Text for the "New ..." button. */
-    createLabel?: string;
-    /** Accessible name for the clear button. */
-    clearLabel?: string;
-    /** Status text while searching. */
-    loadingText?: string;
-    /** Status text when nothing matches. */
-    emptyText?: string;
-    /** Status text when the search fails. */
-    errorText?: string;
-    /** Status text announcing how many results are listed. */
-    resultsText?: (count: number) => string;
-    /** Called when the selected id changes ('' when cleared). */
-    onchange?: (value: string) => void;
-}
-declare const RelationInput: import("svelte").Component<Props, {}, "value">;
-type RelationInput = ReturnType<typeof RelationInput>;
-export default RelationInput;
-//# sourceMappingURL=RelationInput.svelte.d.ts.map

package/dist/components/forms/RelationInput.svelte.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"RelationInput.svelte.d.ts","sourceRoot":"","sources":["../../../src/components/forms/RelationInput.svelte.ts"],"names":[],"mappings":"AAIA,OAAO,EAEL,KAAK,yBAAyB,EAI/B,MAAM,8BAA8B,CAAC;AAGtC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAGjD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,KAAK;IACpB,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,sEAAsE;IACtE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uEAAuE;IACvE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,sBAAsB;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,uDAAuD;IACvD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qCAAqC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6EAA6E;IAC7E,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IACrD,2EAA2E;IAC3E,OAAO,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;IACxE;;;OAGG;IACH,QAAQ,CAAC,EAAE,CACT,KAAK,EAAE,MAAM,KACV,IAAI,GAAG,cAAc,GAAG,OAAO,CAAC,IAAI,GAAG,cAAc,CAAC,CAAC;IAC5D,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,WAAW,CAAC,EAAE,yBAAyB,GAAG,KAAK,CAAC;IAChD,qCAAqC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4CAA4C;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mCAAmC;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0DAA0D;IAC1D,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IACxC,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACpC;AAuPD,QAAA,MAAM,aAAa,gDAAwC,CAAC;AAC5D,KAAK,aAAa,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC;AACtD,eAAe,aAAa,CAAC"}