@happyvertical/smrt-features 0.51.18 → 0.51.20

package/dist/svelte/components/FeatureSettingsPanel.svelte

@@ -0,0 +1,338 @@
+<script lang="ts">
+/**
+ * FeatureSettingsPanel — the shared feature-flag management surface.
+ *
+ * Purely presentational: it takes rows and callbacks. It does no fetching, and
+ * it makes no authorization decision — the host decides who may see the panel
+ * and who may write, and enforces that on the server (see
+ * `FeatureSettingsService` and `FeatureOverrideService`). Rendering the global
+ * column is a host decision too: apps with no platform-admin tier omit it.
+ *
+ * Each row renders as its own `<form>`, so a SvelteKit host can point
+ * `formAction` at a form action and get a working screen with no client JS;
+ * supplying `onSave` instead (or as well) intercepts the submit and hands the
+ * change to the host.
+ */
+import { Badge, Button, Card } from '@happyvertical/smrt-ui/ui';
+import type { FeatureSettingsChange, FeatureSettingsView } from '../types.js';
+import {
+  defaultOptionLabel,
+  effectiveStateLabel,
+  inheritedOptionLabel,
+  toFeatureSettingsEffect,
+} from '../types.js';
+
+export interface Props {
+  /** The features to manage, in the order they should be rendered. */
+  features?: FeatureSettingsView[];
+  /** Column heading for the tenant-scope control. */
+  tenantLabel?: string;
+  /**
+   * Render the global-scope column. Off by default: an app with no
+   * platform-admin tier has nothing to put there.
+   */
+  showGlobal?: boolean;
+  /**
+   * Let the operator change the global column. Ignored unless `showGlobal`.
+   * When false the column is rendered read-only, which is how a tenant admin
+   * sees the platform default that their own override is layered on.
+   */
+  globalEditable?: boolean;
+  /** Column heading for the global-scope control. */
+  globalLabel?: string;
+  /** Disable every control while a save is in flight. */
+  busy?: boolean;
+  /** Success text to show above the list. */
+  message?: string | null;
+  /** Error text to show above the list. */
+  error?: string | null;
+  /** Text for the empty state. */
+  emptyMessage?: string;
+  /**
+   * Identity of what is being edited (typically the tenant id). Unsaved edits
+   * are discarded whenever this changes — or, when it is omitted, whenever
+   * `features` is replaced with a new array, which is what a reloaded server
+   * load produces. Without that, a row edited for one tenant would carry its
+   * unsaved choice into the next tenant's rows under the same feature key.
+   */
+  contextKey?: unknown;
+  /** Label for each row's submit control. */
+  saveLabel?: string;
+  /**
+   * SvelteKit form action for each row's `<form>` (e.g. `?/saveFeature`).
+   * Omit when driving the panel entirely through {@link Props.onSave}.
+   */
+  formAction?: string;
+  /**
+   * Called with the requested change instead of submitting the form. The host
+   * performs its own permission check and the write.
+   */
+  onSave?: (change: FeatureSettingsChange) => void;
+}
+
+const {
+  features = [],
+  tenantLabel = 'Tenant',
+  showGlobal = false,
+  globalEditable = false,
+  globalLabel = 'Global',
+  busy = false,
+  contextKey,
+  message = null,
+  error = null,
+  emptyMessage = 'No features are registered yet. Definitions appear here once they are synced from code.',
+  saveLabel = 'Save',
+  formAction,
+  onSave,
+}: Props = $props();
+
+const globalIsEditable = $derived(showGlobal && globalEditable);
+const canSubmit = $derived(!busy && (onSave != null || formAction != null));
+
+/**
+ * Remount the rows when the editing context changes, discarding unsaved edits.
+ * The selects are uncontrolled — their `selected` attributes seed them from
+ * `features` and the browser owns the value afterwards — so without this an
+ * operator's unsaved choice would survive a reload or a tenant switch and then
+ * be submitted against the new rows.
+ */
+const resetKey = $derived(contextKey ?? features);
+
+function submit(event: SubmitEvent, feature: FeatureSettingsView): void {
+  if (!onSave) return;
+  event.preventDefault();
+  const fields = new FormData(event.currentTarget as HTMLFormElement);
+  onSave({
+    featureKey: feature.featureKey,
+    tenantEffect: toFeatureSettingsEffect(fields.get('tenantEffect')),
+    ...(globalIsEditable
+      ? { globalEffect: toFeatureSettingsEffect(fields.get('globalEffect')) }
+      : {}),
+  });
+}
+
+/** Read-only rendering of an override level that this operator cannot change. */
+function readOnlyEffectLabel(feature: FeatureSettingsView): string {
+  if (feature.globalEffect === 'enable') return 'Enabled';
+  if (feature.globalEffect === 'disable') return 'Disabled';
+  return defaultOptionLabel(feature.defaultEnabled);
+}
+</script>
+
+<section class="feature-settings" data-testid="feature-settings-panel">
+  {#if message}
+    <p class="fs-flash" role="status">{message}</p>
+  {/if}
+  {#if error}
+    <p class="fs-flash fs-flash-error" role="alert">{error}</p>
+  {/if}
+
+  {#key resetKey}
+    {#each features as feature (feature.featureKey)}
+      <Card variant="outlined">
+        <div class="fs-row">
+          <div class="fs-copy">
+            <div class="fs-title-row">
+              <h3 class="fs-title">{feature.label || feature.featureKey}</h3>
+              <Badge
+                variant={feature.effectiveEnabled ? 'success' : 'default'}
+                size="sm"
+              >
+                {effectiveStateLabel(feature.effectiveEnabled)}
+              </Badge>
+            </div>
+            <p class="fs-description">{feature.description || feature.featureKey}</p>
+            <code class="fs-key">{feature.featureKey}</code>
+            {#if feature.packageName}
+              <span class="fs-package">{feature.packageName}</span>
+            {/if}
+          </div>
+
+          <form
+            class="fs-controls"
+            method="POST"
+            action={formAction}
+            onsubmit={(event) => submit(event, feature)}
+          >
+            <input type="hidden" name="featureKey" value={feature.featureKey} />
+
+            {#if showGlobal}
+              {#if globalIsEditable}
+                <label class="fs-field">
+                  <span class="fs-field-label">{globalLabel}</span>
+                  <select name="globalEffect" disabled={busy}>
+                    <option
+                      value="inherit"
+                      selected={feature.globalEffect !== 'enable' &&
+                        feature.globalEffect !== 'disable'}
+                    >
+                      {defaultOptionLabel(feature.defaultEnabled)}
+                    </option>
+                    <option
+                      value="enable"
+                      selected={feature.globalEffect === 'enable'}
+                    >
+                      Enable
+                    </option>
+                    <option
+                      value="disable"
+                      selected={feature.globalEffect === 'disable'}
+                    >
+                      Disable
+                    </option>
+                  </select>
+                </label>
+              {:else}
+                <div class="fs-field">
+                  <span class="fs-field-label">{globalLabel}</span>
+                  <p class="fs-readonly">{readOnlyEffectLabel(feature)}</p>
+                </div>
+              {/if}
+            {/if}
+
+            <label class="fs-field">
+              <span class="fs-field-label">{tenantLabel}</span>
+              <select name="tenantEffect" disabled={busy}>
+                <option
+                  value="inherit"
+                  selected={feature.tenantEffect !== 'enable' &&
+                    feature.tenantEffect !== 'disable'}
+                >
+                  <!-- The tenant scope inherits from the levels above it, so
+                       this never names the bare code default. -->
+                  {inheritedOptionLabel(feature)}
+                </option>
+                <option value="enable" selected={feature.tenantEffect === 'enable'}>
+                  Enable
+                </option>
+                <option
+                  value="disable"
+                  selected={feature.tenantEffect === 'disable'}
+                >
+                  Disable
+                </option>
+              </select>
+            </label>
+
+            <Button type="submit" variant="primary" size="sm" disabled={!canSubmit}>
+              {saveLabel}
+            </Button>
+          </form>
+        </div>
+      </Card>
+    {:else}
+      <p class="fs-empty">{emptyMessage}</p>
+    {/each}
+  {/key}
+</section>
+
+<style>
+  .feature-settings {
+    display: flex;
+    flex-direction: column;
+    gap: 1rem;
+  }
+
+  .fs-flash {
+    margin: 0;
+    padding: 0.625rem 0.75rem;
+    border-radius: 0.375rem;
+    background: var(--color-surface-muted, #f3f4f6);
+  }
+
+  .fs-flash-error {
+    color: var(--color-error-text, #991b1b);
+    background: var(--color-error-surface, #fef2f2);
+  }
+
+  .fs-empty {
+    margin: 0;
+    color: var(--color-text-muted, #6b7280);
+    font-style: italic;
+  }
+
+  .fs-row {
+    display: grid;
+    grid-template-columns: minmax(0, 1fr) minmax(16rem, 22rem);
+    gap: 1rem;
+    align-items: start;
+  }
+
+  .fs-copy {
+    min-width: 0;
+    display: flex;
+    flex-direction: column;
+    gap: 0.25rem;
+  }
+
+  .fs-title-row {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    gap: 0.5rem;
+  }
+
+  .fs-title {
+    margin: 0;
+    font-size: 1rem;
+    line-height: 1.25;
+  }
+
+  .fs-description {
+    margin: 0;
+    color: var(--color-text-muted, #6b7280);
+    line-height: 1.45;
+  }
+
+  .fs-key,
+  .fs-package {
+    font-size: 0.8125rem;
+    color: var(--color-text-muted, #6b7280);
+    overflow-wrap: anywhere;
+  }
+
+  .fs-controls {
+    display: flex;
+    align-items: flex-end;
+    gap: 0.5rem;
+  }
+
+  .fs-field {
+    min-width: 0;
+    flex: 1 1 0;
+    display: flex;
+    flex-direction: column;
+    gap: 0.25rem;
+  }
+
+  .fs-field-label {
+    font-size: 0.8125rem;
+    color: var(--color-text-muted, #6b7280);
+  }
+
+  .fs-field select {
+    width: 100%;
+    padding: 0.375rem 0.5rem;
+    border: 1px solid var(--color-border, #d1d5db);
+    border-radius: 0.375rem;
+    background: var(--color-surface, #fff);
+    color: inherit;
+    font: inherit;
+  }
+
+  .fs-readonly {
+    margin: 0;
+    line-height: 1.45;
+  }
+
+  @media (max-width: 860px) {
+    .fs-row {
+      grid-template-columns: 1fr;
+    }
+
+    .fs-controls {
+      flex-direction: column;
+      align-items: stretch;
+    }
+  }
+</style>

package/dist/svelte/components/FeatureSettingsPanel.svelte.d.ts

@@ -0,0 +1,52 @@
+import type { FeatureSettingsChange, FeatureSettingsView } from '../types.js';
+export interface Props {
+    /** The features to manage, in the order they should be rendered. */
+    features?: FeatureSettingsView[];
+    /** Column heading for the tenant-scope control. */
+    tenantLabel?: string;
+    /**
+     * Render the global-scope column. Off by default: an app with no
+     * platform-admin tier has nothing to put there.
+     */
+    showGlobal?: boolean;
+    /**
+     * Let the operator change the global column. Ignored unless `showGlobal`.
+     * When false the column is rendered read-only, which is how a tenant admin
+     * sees the platform default that their own override is layered on.
+     */
+    globalEditable?: boolean;
+    /** Column heading for the global-scope control. */
+    globalLabel?: string;
+    /** Disable every control while a save is in flight. */
+    busy?: boolean;
+    /** Success text to show above the list. */
+    message?: string | null;
+    /** Error text to show above the list. */
+    error?: string | null;
+    /** Text for the empty state. */
+    emptyMessage?: string;
+    /**
+     * Identity of what is being edited (typically the tenant id). Unsaved edits
+     * are discarded whenever this changes — or, when it is omitted, whenever
+     * `features` is replaced with a new array, which is what a reloaded server
+     * load produces. Without that, a row edited for one tenant would carry its
+     * unsaved choice into the next tenant's rows under the same feature key.
+     */
+    contextKey?: unknown;
+    /** Label for each row's submit control. */
+    saveLabel?: string;
+    /**
+     * SvelteKit form action for each row's `<form>` (e.g. `?/saveFeature`).
+     * Omit when driving the panel entirely through {@link Props.onSave}.
+     */
+    formAction?: string;
+    /**
+     * Called with the requested change instead of submitting the form. The host
+     * performs its own permission check and the write.
+     */
+    onSave?: (change: FeatureSettingsChange) => void;
+}
+declare const FeatureSettingsPanel: import("svelte").Component<Props, {}, "">;
+type FeatureSettingsPanel = ReturnType<typeof FeatureSettingsPanel>;
+export default FeatureSettingsPanel;
+//# sourceMappingURL=FeatureSettingsPanel.svelte.d.ts.map

package/dist/svelte/components/FeatureSettingsPanel.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FeatureSettingsPanel.svelte.d.ts","sourceRoot":"","sources":["../../../src/svelte/components/FeatureSettingsPanel.svelte.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAS9E,MAAM,WAAW,KAAK;IACpB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,mBAAmB,EAAE,CAAC;IACjC,mDAAmD;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,mDAAmD;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uDAAuD;IACvD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,gCAAgC;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,qBAAqB,KAAK,IAAI,CAAC;CAClD;AAgJD,QAAA,MAAM,oBAAoB,2CAAwC,CAAC;AACnE,KAAK,oBAAoB,GAAG,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC;AACpE,eAAe,oBAAoB,CAAC"}

package/dist/svelte/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @happyvertical/smrt-features/svelte
+ *
+ * Optional Svelte 5 UI for feature-flag management. Presentational only: the
+ * panel takes rows and callbacks, does no fetching, and makes no authorization
+ * decision. Hosts render it from a server load that used
+ * `FeatureSettingsService` and wire saves to their own permission-checked
+ * route. The root `@happyvertical/smrt-features` export stays Svelte-free.
+ *
+ * @packageDocumentation
+ */
+import type { ComponentProps } from 'svelte';
+import FeatureSettingsPanel from './components/FeatureSettingsPanel.svelte';
+export { FeatureSettingsPanel };
+export type FeatureSettingsPanelProps = ComponentProps<typeof FeatureSettingsPanel>;
+export { defaultOptionLabel, effectiveStateLabel, type FeatureSettingsChange, type FeatureSettingsEffect, type FeatureSettingsView, inheritedOptionLabel, toFeatureSettingsEffect, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/svelte/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/svelte/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAC7C,OAAO,oBAAoB,MAAM,0CAA0C,CAAC;AAE5E,OAAO,EAAE,oBAAoB,EAAE,CAAC;AAChC,MAAM,MAAM,yBAAyB,GAAG,cAAc,CACpD,OAAO,oBAAoB,CAC5B,CAAC;AAEF,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,oBAAoB,EACpB,uBAAuB,GACxB,MAAM,YAAY,CAAC"}

package/dist/svelte/index.js

@@ -0,0 +1,14 @@
+/**
+ * @happyvertical/smrt-features/svelte
+ *
+ * Optional Svelte 5 UI for feature-flag management. Presentational only: the
+ * panel takes rows and callbacks, does no fetching, and makes no authorization
+ * decision. Hosts render it from a server load that used
+ * `FeatureSettingsService` and wire saves to their own permission-checked
+ * route. The root `@happyvertical/smrt-features` export stays Svelte-free.
+ *
+ * @packageDocumentation
+ */
+import FeatureSettingsPanel from './components/FeatureSettingsPanel.svelte';
+export { FeatureSettingsPanel };
+export { defaultOptionLabel, effectiveStateLabel, inheritedOptionLabel, toFeatureSettingsEffect, } from './types.js';

package/dist/svelte/types.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Presentational types for the feature-flag management UI.
+ *
+ * Deliberately free of the `@smrt()` model classes and of `@happyvertical/smrt-core`
+ * so the Svelte bundle stays a thin presentation layer. The effect strings match
+ * `FeatureOverrideEffect`'s values, so a `FeatureSettingsRow` produced by
+ * `FeatureSettingsService.listFeatureSettings()` is structurally assignable to
+ * {@link FeatureSettingsView} with no mapping step.
+ *
+ * @module
+ */
+/** The three states an override control offers, matching `FeatureOverrideEffect`. */
+export type FeatureSettingsEffect = 'inherit' | 'enable' | 'disable';
+/** A render-ready view of one feature's settings. */
+export interface FeatureSettingsView {
+    /**
+     * The persisted identifier. Shown verbatim so an operator can correlate the
+     * row with code and with support requests — renaming a key orphans its
+     * overrides, so it is stable enough to quote.
+     */
+    featureKey: string;
+    /** Human label; falls back to the key when empty. */
+    label?: string;
+    /** Human description; falls back to the key when empty. */
+    description?: string;
+    /** Owning package, shown as provenance when present. */
+    packageName?: string;
+    /** The code-owned default, used to label the "Default" option. */
+    defaultEnabled: boolean;
+    /** What the resolver reports for the current context. */
+    effectiveEnabled: boolean;
+    /** Effect of the global override row, or `null`/absent when there is none. */
+    globalEffect?: FeatureSettingsEffect | null;
+    /** Effect of the tenant override row, or `null`/absent when there is none. */
+    tenantEffect?: FeatureSettingsEffect | null;
+    /**
+     * What this feature resolves to for this tenant with **no override of its
+     * own** — the state returning the tenant scope to Default actually produces.
+     *
+     * Only the server can know this: with a tenant hierarchy configured, an
+     * ancestor tenant's override sits between the global scope and this tenant,
+     * so it is not derivable from `defaultEnabled` and `globalEffect`. Leave it
+     * `null`/absent when it is not known and the panel says "Default (inherited)"
+     * rather than naming a state it cannot vouch for.
+     */
+    inheritedEnabled?: boolean | null;
+}
+/** One override change requested from the panel. */
+export interface FeatureSettingsChange {
+    /** The feature the operator was editing. */
+    featureKey: string;
+    /** Requested tenant-scope effect. */
+    tenantEffect: FeatureSettingsEffect;
+    /**
+     * Requested global-scope effect — present only when the panel rendered an
+     * editable global column.
+     */
+    globalEffect?: FeatureSettingsEffect;
+}
+/** Narrow an untrusted string to a {@link FeatureSettingsEffect}, defaulting to `inherit`. */
+export declare function toFeatureSettingsEffect(value: unknown): FeatureSettingsEffect;
+/** Label for the "back to default" option, naming the state it returns to. */
+export declare function defaultOptionLabel(enabledWhenDefault: boolean): string;
+/**
+ * Label for the option that removes the **tenant** override.
+ *
+ * `defaultEnabled` is the wrong thing to name here: the tenant scope inherits
+ * whatever the levels above it resolve to — the global override, and, when a
+ * tenant hierarchy is configured, any ancestor tenant's override. So this names
+ * the inherited state only when the row carries one, and otherwise says
+ * "Default (inherited)" rather than claiming a state it cannot know.
+ */
+export declare function inheritedOptionLabel(feature: FeatureSettingsView): string;
+/** Badge text for a feature's effective state. */
+export declare function effectiveStateLabel(effectiveEnabled: boolean): string;
+//# sourceMappingURL=types.d.ts.map

package/dist/svelte/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/svelte/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,qFAAqF;AACrF,MAAM,MAAM,qBAAqB,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;AAErE,qDAAqD;AACrD,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wDAAwD;IACxD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kEAAkE;IAClE,cAAc,EAAE,OAAO,CAAC;IACxB,yDAAyD;IACzD,gBAAgB,EAAE,OAAO,CAAC;IAC1B,8EAA8E;IAC9E,YAAY,CAAC,EAAE,qBAAqB,GAAG,IAAI,CAAC;IAC5C,8EAA8E;IAC9E,YAAY,CAAC,EAAE,qBAAqB,GAAG,IAAI,CAAC;IAC5C;;;;;;;;;OASG;IACH,gBAAgB,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CACnC;AAED,oDAAoD;AACpD,MAAM,WAAW,qBAAqB;IACpC,4CAA4C;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB,qCAAqC;IACrC,YAAY,EAAE,qBAAqB,CAAC;IACpC;;;OAGG;IACH,YAAY,CAAC,EAAE,qBAAqB,CAAC;CACtC;AAED,8FAA8F;AAC9F,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,qBAAqB,CAE7E;AAED,8EAA8E;AAC9E,wBAAgB,kBAAkB,CAAC,kBAAkB,EAAE,OAAO,GAAG,MAAM,CAEtE;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM,CAIzE;AAED,kDAAkD;AAClD,wBAAgB,mBAAmB,CAAC,gBAAgB,EAAE,OAAO,GAAG,MAAM,CAErE"}

package/dist/svelte/types.js

@@ -0,0 +1,37 @@
+/**
+ * Presentational types for the feature-flag management UI.
+ *
+ * Deliberately free of the `@smrt()` model classes and of `@happyvertical/smrt-core`
+ * so the Svelte bundle stays a thin presentation layer. The effect strings match
+ * `FeatureOverrideEffect`'s values, so a `FeatureSettingsRow` produced by
+ * `FeatureSettingsService.listFeatureSettings()` is structurally assignable to
+ * {@link FeatureSettingsView} with no mapping step.
+ *
+ * @module
+ */
+/** Narrow an untrusted string to a {@link FeatureSettingsEffect}, defaulting to `inherit`. */
+export function toFeatureSettingsEffect(value) {
+    return value === 'enable' || value === 'disable' ? value : 'inherit';
+}
+/** Label for the "back to default" option, naming the state it returns to. */
+export function defaultOptionLabel(enabledWhenDefault) {
+    return `Default (${enabledWhenDefault ? 'enabled' : 'disabled'})`;
+}
+/**
+ * Label for the option that removes the **tenant** override.
+ *
+ * `defaultEnabled` is the wrong thing to name here: the tenant scope inherits
+ * whatever the levels above it resolve to — the global override, and, when a
+ * tenant hierarchy is configured, any ancestor tenant's override. So this names
+ * the inherited state only when the row carries one, and otherwise says
+ * "Default (inherited)" rather than claiming a state it cannot know.
+ */
+export function inheritedOptionLabel(feature) {
+    return typeof feature.inheritedEnabled === 'boolean'
+        ? defaultOptionLabel(feature.inheritedEnabled)
+        : 'Default (inherited)';
+}
+/** Badge text for a feature's effective state. */
+export function effectiveStateLabel(effectiveEnabled) {
+    return effectiveEnabled ? 'Enabled' : 'Disabled';
+}