@happyvertical/smrt-prompts 0.51.21 → 0.51.29

package/dist/svelte/components/PromptSettingsPanel.svelte

@@ -0,0 +1,353 @@
+<script lang="ts">
+/**
+ * PromptSettingsPanel — the shared prompt-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
+ * `PromptSettingsService` and `PromptOverrideService`). Rendering the app
+ * 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:
+ * the "override" checkbox and the textarea are independent fields, and
+ * whether a scope is overridden is decided by whether its checkbox's name is
+ * present in the submitted `FormData` — never by disabling the textarea,
+ * which a plain HTML submit could not re-enable. Supplying `onSave` instead
+ * intercepts the submit and hands the host the same decision.
+ */
+import { Badge, Button, Card } from '@happyvertical/smrt-ui/ui';
+import type { PromptSettingsChange, PromptSettingsView } from '../types.js';
+import {
+  appRevertPreview,
+  isTemplateEditable,
+  supplyingLevelLabel,
+  tenantRevertPreview,
+} from '../types.js';
+
+export interface Props {
+  /** The prompts to manage, in the order they should be rendered. */
+  prompts?: PromptSettingsView[];
+  /** Column heading for the tenant-scope editor. */
+  tenantLabel?: string;
+  /**
+   * Render the app-scope column. Off by default: an app with no
+   * platform-admin tier has nothing to put there.
+   */
+  showApp?: boolean;
+  /**
+   * Let the operator change the app column. Ignored unless `showApp`. When
+   * false the column is rendered read-only, which is how a tenant admin sees
+   * the app-wide default their own override is layered on.
+   */
+  appEditable?: boolean;
+  /** Column heading for the app-scope editor. */
+  appLabel?: 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
+   * `prompts` 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 text into the next tenant's rows under the same key.
+   */
+  contextKey?: unknown;
+  /** Label for each row's submit control. */
+  saveLabel?: string;
+  /**
+   * SvelteKit form action for each row's `<form>` (e.g. `?/savePrompt`). 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: PromptSettingsChange) => void;
+}
+
+const {
+  prompts = [],
+  tenantLabel = 'Tenant override',
+  showApp = false,
+  appEditable = false,
+  appLabel = 'App override',
+  busy = false,
+  contextKey,
+  message = null,
+  error = null,
+  emptyMessage = 'No prompts are registered yet. Definitions appear here once they are registered from code.',
+  saveLabel = 'Save',
+  formAction,
+  onSave,
+}: Props = $props();
+
+const appIsEditable = $derived(showApp && appEditable);
+const canSubmit = $derived(!busy && (onSave != null || formAction != null));
+
+/**
+ * Remount the rows when the editing context changes, discarding unsaved
+ * edits. Without this an operator's unsaved text would survive a reload or a
+ * tenant switch and then be submitted against the new rows.
+ */
+const resetKey = $derived(contextKey ?? prompts);
+
+function submit(event: SubmitEvent, prompt: PromptSettingsView): void {
+  // A non-editable row's controls are disabled, and disabled controls are
+  // absent from FormData — a submit would read as "unchecked" and revert an
+  // existing override. Such a row is read-only: it never submits.
+  if (!isTemplateEditable(prompt)) {
+    event.preventDefault();
+    return;
+  }
+  if (!onSave) return;
+  event.preventDefault();
+  const fields = new FormData(event.currentTarget as HTMLFormElement);
+  const change: PromptSettingsChange = {
+    key: prompt.key,
+    tenantTemplate: fields.has('tenantOverride')
+      ? String(fields.get('tenantTemplate') ?? '')
+      : null,
+  };
+  if (appIsEditable) {
+    change.appTemplate = fields.has('appOverride')
+      ? String(fields.get('appTemplate') ?? '')
+      : null;
+  }
+  onSave(change);
+}
+</script>
+
+<section class="prompt-settings" data-testid="prompt-settings-panel">
+  {#if message}
+    <p class="ps-flash" role="status">{message}</p>
+  {/if}
+  {#if error}
+    <p class="ps-flash ps-flash-error" role="alert">{error}</p>
+  {/if}
+
+  {#key resetKey}
+    {#each prompts as prompt (prompt.key)}
+      <Card variant="outlined">
+        <div class="ps-row">
+          <div class="ps-copy">
+            <div class="ps-title-row">
+              <h3 class="ps-title">{prompt.description || prompt.key}</h3>
+              <Badge variant="default" size="sm">
+                {supplyingLevelLabel(prompt.supplyingLevel)}
+              </Badge>
+            </div>
+            <code class="ps-key">{prompt.key}</code>
+            <pre class="ps-effective">{prompt.effectiveTemplate}</pre>
+          </div>
+
+          <form
+            class="ps-controls"
+            method="POST"
+            action={formAction}
+            onsubmit={(event) => submit(event, prompt)}
+          >
+            <input type="hidden" name="key" value={prompt.key} />
+
+            {#if showApp}
+              {#if appIsEditable}
+                <div class="ps-field">
+                  <label class="ps-toggle">
+                    <input
+                      type="checkbox"
+                      name="appOverride"
+                      checked={prompt.appTemplate != null}
+                      disabled={busy || !isTemplateEditable(prompt)}
+                    />
+                    {appLabel}
+                  </label>
+                  <textarea
+                    class="ps-textarea"
+                    name="appTemplate"
+                    aria-label={appLabel}
+                    rows="3"
+                    disabled={busy || !isTemplateEditable(prompt)}
+                    value={prompt.appTemplate ?? appRevertPreview(prompt)}
+                  ></textarea>
+                  <p class="ps-hint">
+                    Unchecked reverts to: {appRevertPreview(prompt)}
+                  </p>
+                </div>
+              {:else}
+                <div class="ps-field">
+                  <span class="ps-field-label">{appLabel}</span>
+                  <p class="ps-readonly">
+                    {prompt.appTemplate ?? appRevertPreview(prompt)}
+                  </p>
+                </div>
+              {/if}
+            {/if}
+
+            <div class="ps-field">
+              <label class="ps-toggle">
+                <input
+                  type="checkbox"
+                  name="tenantOverride"
+                  checked={prompt.tenantTemplate != null}
+                  disabled={busy || !isTemplateEditable(prompt)}
+                />
+                {tenantLabel}
+              </label>
+              <textarea
+                class="ps-textarea"
+                name="tenantTemplate"
+                aria-label={tenantLabel}
+                rows="4"
+                disabled={busy || !isTemplateEditable(prompt)}
+                value={prompt.tenantTemplate ?? tenantRevertPreview(prompt)}
+              ></textarea>
+              <p class="ps-hint">
+                Unchecked reverts to: {tenantRevertPreview(prompt)}
+              </p>
+            </div>
+
+            <Button
+              type="submit"
+              variant="primary"
+              size="sm"
+              disabled={!canSubmit || !isTemplateEditable(prompt)}
+            >
+              {saveLabel}
+            </Button>
+          </form>
+        </div>
+      </Card>
+    {:else}
+      <p class="ps-empty">{emptyMessage}</p>
+    {/each}
+  {/key}
+</section>
+
+<style>
+  .prompt-settings {
+    display: flex;
+    flex-direction: column;
+    gap: 1rem;
+  }
+
+  .ps-flash {
+    margin: 0;
+    padding: 0.625rem 0.75rem;
+    border-radius: 0.375rem;
+    background: var(--color-surface-muted, #f3f4f6);
+  }
+
+  .ps-flash-error {
+    color: var(--color-error-text, #991b1b);
+    background: var(--color-error-surface, #fef2f2);
+  }
+
+  .ps-empty {
+    margin: 0;
+    color: var(--color-text-muted, #6b7280);
+    font-style: italic;
+  }
+
+  .ps-row {
+    display: grid;
+    grid-template-columns: minmax(0, 1fr) minmax(18rem, 26rem);
+    gap: 1rem;
+    align-items: start;
+  }
+
+  .ps-copy {
+    min-width: 0;
+    display: flex;
+    flex-direction: column;
+    gap: 0.25rem;
+  }
+
+  .ps-title-row {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    gap: 0.5rem;
+  }
+
+  .ps-title {
+    margin: 0;
+    font-size: 1rem;
+    line-height: 1.25;
+  }
+
+  .ps-key {
+    font-size: 0.8125rem;
+    color: var(--color-text-muted, #6b7280);
+    overflow-wrap: anywhere;
+  }
+
+  .ps-effective {
+    margin: 0;
+    padding: 0.5rem;
+    border-radius: 0.375rem;
+    background: var(--color-surface-muted, #f3f4f6);
+    white-space: pre-wrap;
+    overflow-wrap: anywhere;
+    font-family: inherit;
+    font-size: 0.875rem;
+  }
+
+  .ps-controls {
+    display: flex;
+    flex-direction: column;
+    gap: 0.75rem;
+  }
+
+  .ps-field {
+    min-width: 0;
+    display: flex;
+    flex-direction: column;
+    gap: 0.25rem;
+  }
+
+  .ps-field-label {
+    font-size: 0.8125rem;
+    color: var(--color-text-muted, #6b7280);
+  }
+
+  .ps-toggle {
+    display: flex;
+    align-items: center;
+    gap: 0.375rem;
+    font-size: 0.8125rem;
+    color: var(--color-text-muted, #6b7280);
+  }
+
+  .ps-textarea {
+    width: 100%;
+    padding: 0.5rem;
+    border: 1px solid var(--color-border, #d1d5db);
+    border-radius: 0.375rem;
+    background: var(--color-surface, #fff);
+    color: inherit;
+    font: inherit;
+    resize: vertical;
+  }
+
+  .ps-hint,
+  .ps-readonly {
+    margin: 0;
+    font-size: 0.8125rem;
+    color: var(--color-text-muted, #6b7280);
+    line-height: 1.45;
+    overflow-wrap: anywhere;
+  }
+
+  @media (max-width: 860px) {
+    .ps-row {
+      grid-template-columns: 1fr;
+    }
+  }
+</style>

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

@@ -0,0 +1,52 @@
+import type { PromptSettingsChange, PromptSettingsView } from '../types.js';
+export interface Props {
+    /** The prompts to manage, in the order they should be rendered. */
+    prompts?: PromptSettingsView[];
+    /** Column heading for the tenant-scope editor. */
+    tenantLabel?: string;
+    /**
+     * Render the app-scope column. Off by default: an app with no
+     * platform-admin tier has nothing to put there.
+     */
+    showApp?: boolean;
+    /**
+     * Let the operator change the app column. Ignored unless `showApp`. When
+     * false the column is rendered read-only, which is how a tenant admin sees
+     * the app-wide default their own override is layered on.
+     */
+    appEditable?: boolean;
+    /** Column heading for the app-scope editor. */
+    appLabel?: 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
+     * `prompts` 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 text into the next tenant's rows under the same key.
+     */
+    contextKey?: unknown;
+    /** Label for each row's submit control. */
+    saveLabel?: string;
+    /**
+     * SvelteKit form action for each row's `<form>` (e.g. `?/savePrompt`). 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: PromptSettingsChange) => void;
+}
+declare const PromptSettingsPanel: import("svelte").Component<Props, {}, "">;
+type PromptSettingsPanel = ReturnType<typeof PromptSettingsPanel>;
+export default PromptSettingsPanel;
+//# sourceMappingURL=PromptSettingsPanel.svelte.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PromptSettingsPanel.svelte.d.ts","sourceRoot":"","sources":["../../../src/svelte/components/PromptSettingsPanel.svelte.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAS5E,MAAM,WAAW,KAAK;IACpB,mEAAmE;IACnE,OAAO,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAC/B,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,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,oBAAoB,KAAK,IAAI,CAAC;CACjD;AAuID,QAAA,MAAM,mBAAmB,2CAAwC,CAAC;AAClE,KAAK,mBAAmB,GAAG,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAClE,eAAe,mBAAmB,CAAC"}

package/dist/svelte/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @happyvertical/smrt-prompts/svelte
+ *
+ * Optional Svelte 5 UI for prompt 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
+ * `PromptSettingsService` and wire saves to their own permission-checked
+ * route. The root `@happyvertical/smrt-prompts` export stays Svelte-free.
+ *
+ * @packageDocumentation
+ */
+import type { ComponentProps } from 'svelte';
+import PromptSettingsPanel from './components/PromptSettingsPanel.svelte';
+export { PromptSettingsPanel };
+export type PromptSettingsPanelProps = ComponentProps<typeof PromptSettingsPanel>;
+export { appRevertPreview, isTemplateEditable, type PromptSettingsChange, type PromptSettingsSupplyingLevel, type PromptSettingsView, supplyingLevelLabel, tenantRevertPreview, } 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,mBAAmB,MAAM,yCAAyC,CAAC;AAE1E,OAAO,EAAE,mBAAmB,EAAE,CAAC;AAC/B,MAAM,MAAM,wBAAwB,GAAG,cAAc,CACnD,OAAO,mBAAmB,CAC3B,CAAC;AAEF,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,KAAK,oBAAoB,EACzB,KAAK,4BAA4B,EACjC,KAAK,kBAAkB,EACvB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,YAAY,CAAC"}

package/dist/svelte/index.js

@@ -0,0 +1,14 @@
+/**
+ * @happyvertical/smrt-prompts/svelte
+ *
+ * Optional Svelte 5 UI for prompt 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
+ * `PromptSettingsService` and wire saves to their own permission-checked
+ * route. The root `@happyvertical/smrt-prompts` export stays Svelte-free.
+ *
+ * @packageDocumentation
+ */
+import PromptSettingsPanel from './components/PromptSettingsPanel.svelte';
+export { PromptSettingsPanel };
+export { appRevertPreview, isTemplateEditable, supplyingLevelLabel, tenantRevertPreview, } from './types.js';

package/dist/svelte/types.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Presentational types for the prompt management UI.
+ *
+ * Deliberately free of the `@smrt()` model classes and of `@happyvertical/smrt-core`
+ * so the Svelte bundle stays a thin presentation layer. Field names match
+ * `PromptSettingsRow` produced by `PromptSettingsService.listPromptSettings()`,
+ * so a row is structurally assignable to {@link PromptSettingsView} with no
+ * mapping step.
+ *
+ * @module
+ */
+/** Which level supplied a prompt's effective template. */
+export type PromptSettingsSupplyingLevel = 'default' | 'config' | 'app' | 'tenant';
+/** A render-ready view of one prompt's settings. */
+export interface PromptSettingsView {
+    /**
+     * The persisted identifier. Shown verbatim so an operator can correlate the
+     * row with code — renaming a key orphans its overrides, so it is stable
+     * enough to quote.
+     */
+    key: string;
+    /** Human description; falls back to the key when empty. */
+    description?: string;
+    /** The text actually in effect for the requested tenant (unrendered). */
+    effectiveTemplate: string;
+    /** Which level supplied {@link effectiveTemplate}. */
+    supplyingLevel?: PromptSettingsSupplyingLevel;
+    /** Whether a stored override may change the template; hides the editor when `false`. */
+    editable?: {
+        template?: boolean;
+    };
+    /** The app-level override's text, or `null`/absent when there is none. */
+    appTemplate?: string | null;
+    /** The tenant-level override's text, or `null`/absent when there is none. */
+    tenantTemplate?: string | null;
+    /** What the **app** scope's "revert to default" produces. */
+    appDefaultTemplate?: string;
+    /**
+     * What the **tenant** scope's "revert to default" produces. `null`/absent
+     * when not known (e.g. no tenant was requested) — the panel then falls back
+     * to {@link appDefaultTemplate} or {@link effectiveTemplate} rather than
+     * claiming a value nothing computed.
+     */
+    inheritedTemplate?: string | null;
+}
+/** One override change requested from the panel. */
+export interface PromptSettingsChange {
+    /** The prompt the operator was editing. */
+    key: string;
+    /**
+     * Requested tenant-scope text, or `null` to revert (return the tenant scope
+     * to whatever it inherits).
+     */
+    tenantTemplate: string | null;
+    /**
+     * Requested app-scope text, or `null` to revert — present only when the
+     * panel rendered an editable app column.
+     */
+    appTemplate?: string | null;
+}
+/** Human label for {@link PromptSettingsView.supplyingLevel}. */
+export declare function supplyingLevelLabel(level: PromptSettingsSupplyingLevel | undefined): string;
+/**
+ * What the tenant scope's "revert to default" control returns to: the app
+ * override if there is one, otherwise the config/registry value. Falls back to
+ * {@link PromptSettingsView.effectiveTemplate} only when the row supplies
+ * neither computed fallback (e.g. a minimal test fixture), rather than
+ * rendering nothing.
+ */
+export declare function tenantRevertPreview(view: PromptSettingsView): string;
+/** What the app scope's "revert to default" control returns to. */
+export declare function appRevertPreview(view: PromptSettingsView): string;
+/** Whether the panel may offer an editor for this prompt's template at all. */
+export declare function isTemplateEditable(view: PromptSettingsView): boolean;
+//# 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,0DAA0D;AAC1D,MAAM,MAAM,4BAA4B,GACpC,SAAS,GACT,QAAQ,GACR,KAAK,GACL,QAAQ,CAAC;AAEb,oDAAoD;AACpD,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yEAAyE;IACzE,iBAAiB,EAAE,MAAM,CAAC;IAC1B,sDAAsD;IACtD,cAAc,CAAC,EAAE,4BAA4B,CAAC;IAC9C,wFAAwF;IACxF,QAAQ,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAClC,0EAA0E;IAC1E,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,6EAA6E;IAC7E,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,6DAA6D;IAC7D,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAED,oDAAoD;AACpD,MAAM,WAAW,oBAAoB;IACnC,2CAA2C;IAC3C,GAAG,EAAE,MAAM,CAAC;IACZ;;;OAGG;IACH,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,iEAAiE;AACjE,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,4BAA4B,GAAG,SAAS,GAC9C,MAAM,CAWR;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,kBAAkB,GAAG,MAAM,CAIpE;AAED,mEAAmE;AACnE,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,kBAAkB,GAAG,MAAM,CAEjE;AAED,+EAA+E;AAC/E,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAEpE"}

package/dist/svelte/types.js

@@ -0,0 +1,42 @@
+/**
+ * Presentational types for the prompt management UI.
+ *
+ * Deliberately free of the `@smrt()` model classes and of `@happyvertical/smrt-core`
+ * so the Svelte bundle stays a thin presentation layer. Field names match
+ * `PromptSettingsRow` produced by `PromptSettingsService.listPromptSettings()`,
+ * so a row is structurally assignable to {@link PromptSettingsView} with no
+ * mapping step.
+ *
+ * @module
+ */
+/** Human label for {@link PromptSettingsView.supplyingLevel}. */
+export function supplyingLevelLabel(level) {
+    switch (level) {
+        case 'tenant':
+            return 'Tenant override';
+        case 'app':
+            return 'App override';
+        case 'config':
+            return 'Config override';
+        default:
+            return 'Registry default';
+    }
+}
+/**
+ * What the tenant scope's "revert to default" control returns to: the app
+ * override if there is one, otherwise the config/registry value. Falls back to
+ * {@link PromptSettingsView.effectiveTemplate} only when the row supplies
+ * neither computed fallback (e.g. a minimal test fixture), rather than
+ * rendering nothing.
+ */
+export function tenantRevertPreview(view) {
+    return (view.inheritedTemplate ?? view.appDefaultTemplate ?? view.effectiveTemplate);
+}
+/** What the app scope's "revert to default" control returns to. */
+export function appRevertPreview(view) {
+    return view.appDefaultTemplate ?? view.effectiveTemplate;
+}
+/** Whether the panel may offer an editor for this prompt's template at all. */
+export function isTemplateEditable(view) {
+    return view.editable?.template !== false;
+}