@happyvertical/smrt-fields 0.40.60 → 0.40.62

package/dist/svelte/components/PolicyField.svelte

@@ -0,0 +1,338 @@
+<script lang="ts">
+/**
+ * PolicyField — layout-neutral wrapper around any input.
+ *
+ * Contributes:
+ * - Visibility by resolved tier × current mode (advanced fields hidden in
+ *   basic mode)
+ * - Initial-value prefill from the resolved default (new records only —
+ *   never clobbers loaded values)
+ * - Label rendering (the resolved label; when the policy has no label the
+ *   label element is omitted rather than fabricated from the raw field name,
+ *   and tooltip-density help falls back to a visible hint)
+ * - Help hint rendered from resolved help (manifest description → org/user
+ *   override)
+ * - Required marker
+ *
+ * Label ↔ control association: the default wrapper renders
+ * `<label for={name}>`, so the wrapped control should carry an `id` equal to
+ * the field `name`. When the first wrapped control has a different `id`, the
+ * `for` attribute is re-pointed to it after mount; when it has no `id` at
+ * all, the wrapper assigns `id={name}` so the association is guaranteed.
+ *
+ * Headless escape hatch: pass a `render` snippet receiving
+ * `{visible, label, help, defaultValue, required, tier}` for fully custom
+ * rendering. Without a snippet, PolicyField wraps children in a label + help
+ * affordance and controls visibility.
+ *
+ * Graceful degradation: outside a FieldPolicyProvider, PolicyField renders its
+ * children verbatim (no visibility filtering, no label/help injection) so
+ * forms can adopt it incrementally.
+ */
+import type { Snippet } from 'svelte';
+import { tryGetFieldPolicyContext } from '../context.svelte.js';
+import type { PolicyFieldSnippetProps } from '../types.js';
+
+export interface Props {
+  /** The field name matching a key in the resolved policy's `fields`. */
+  name: string;
+  /** Stable per-form control id; defaults to `name` for standalone use. */
+  id?: string;
+  /** Stable per-form help id; defaults to `${id}-help`. */
+  helpId?: string;
+  /**
+   * Children — the actual input(s). Always rendered when the field is visible
+   * (unless the `render` snippet escape hatch is used).
+   */
+  children?: Snippet;
+  /**
+   * Headless escape hatch: a snippet receiving all resolved policy data for
+   * fully custom rendering. When provided, it replaces the default label +
+   * children + help layout entirely.
+   */
+  render?: Snippet<[PolicyFieldSnippetProps]>;
+  /**
+   * Whether this is a new record. When true (default) and the field has a
+   * resolved default, the provider can prefill. Set to false for loaded
+   * records to prevent overwriting existing values.
+   * @default true
+   */
+  isNewRecord?: boolean;
+  /**
+   * Override the resolved label. When provided, takes precedence over the
+   * policy label.
+   */
+  label?: string;
+  /**
+   * Override the resolved help text. When provided, takes precedence over
+   * the policy help.
+   */
+  help?: string;
+  /**
+   * Density of the help hint: 'hint' (inline hint text, default) or
+   * 'tooltip' (title attribute on the label).
+   * @default 'hint'
+   */
+  helpDensity?: 'hint' | 'tooltip';
+  /** Additional class for the wrapper element. */
+  class?: string;
+}
+
+let {
+  name,
+  id = name,
+  helpId = `${id}-help`,
+  children,
+  render: renderSnippet,
+  isNewRecord = true,
+  label: labelOverride,
+  help: helpOverride,
+  helpDensity = 'hint',
+  class: className = '',
+}: Props = $props();
+
+const context = tryGetFieldPolicyContext();
+
+// Reactive resolved field policy — undefined when not in a Provider or when
+// the field name is not in the resolved set.
+const resolvedField = $derived(context?.getField(name));
+
+const tier = $derived(resolvedField?.visibility ?? 'basic');
+
+// A field is visible when:
+// - No context (graceful degradation → always visible)
+// - Tier is 'basic'
+// - Tier is 'advanced' and mode is 'advanced'
+// - Tier is 'hidden' → never visible (but required-and-defaultless fields are
+//   forced basic by the resolver, so this is a safety net)
+const visible = $derived.by(() => {
+  if (!context) return true;
+  if (tier === 'hidden') return false;
+  if (tier === 'basic') return true;
+  // advanced
+  return context.mode.current === 'advanced';
+});
+
+const label = $derived(labelOverride ?? resolvedField?.label ?? null);
+
+const help = $derived(helpOverride ?? resolvedField?.help ?? null);
+
+const required = $derived(resolvedField?.required ?? false);
+
+const hasDefault = $derived(resolvedField?.hasDefault ?? false);
+
+const defaultValue = $derived(resolvedField?.defaultValue);
+
+// Snippet escape hatch data
+const snippetProps = $derived<PolicyFieldSnippetProps>({
+  id,
+  helpId,
+  visible,
+  label,
+  help,
+  defaultValue,
+  required,
+  tier,
+});
+
+// --- Default prefill (new records only) ---
+// When this is a new record and the field has a resolved default, prefill the
+// wrapped input's value — but ONLY when the input is currently empty (a loaded
+// record with an existing value is never clobbered). Mirrors the "defaults
+// only apply to new records" invariant from the resolver.
+//
+// Runs via $effect rather than onMount so it also covers advanced-tier fields
+// that are hidden at mount and revealed later by the mode switch: the wrapper
+// div (and rootEl) only exist once the field is visible, and the effect re-runs
+// when visibility flips. A one-shot `prefilled` guard prevents re-filling an
+// input the user has deliberately cleared.
+//
+// After writing a value we dispatch the event the matching binding listens to
+// (`input` for text-like controls, `change` for select/checkbox/radio) so a
+// consumer's `bind:value` variable picks the prefilled value up instead of
+// staying stale.
+let rootEl = $state<HTMLDivElement | null>(null);
+let prefilled = false;
+
+function prefillInputs(): void {
+  if (!rootEl) {
+    return;
+  }
+
+  const inputs = rootEl.querySelectorAll<
+    HTMLInputElement | HTMLTextAreaElement | HTMLSelectElement
+  >('input, textarea, select');
+
+  for (const input of inputs) {
+    if (input instanceof HTMLSelectElement) {
+      if (input.value === '') {
+        input.value = String(defaultValue ?? '');
+        input.dispatchEvent(new Event('change', { bubbles: true }));
+      }
+      continue;
+    }
+
+    const inputType = (input as HTMLInputElement).type;
+    if (inputType === 'checkbox') {
+      const checkbox = input as HTMLInputElement;
+      if (!checkbox.checked && defaultValue === true) {
+        checkbox.checked = true;
+        checkbox.dispatchEvent(new Event('change', { bubbles: true }));
+      }
+      continue;
+    }
+
+    if (inputType === 'radio') {
+      const radio = input as HTMLInputElement;
+      if (String(defaultValue) === radio.value && !radio.checked) {
+        radio.checked = true;
+        radio.dispatchEvent(new Event('change', { bubbles: true }));
+      }
+      continue;
+    }
+
+    // text / textarea / number / date / etc.
+    const textInput = input as HTMLInputElement | HTMLTextAreaElement;
+    if (textInput.value === '') {
+      textInput.value = String(defaultValue ?? '');
+      textInput.dispatchEvent(new Event('input', { bubbles: true }));
+    }
+  }
+}
+
+// Link the help hint to the first wrapped control programmatically. Only
+// when the hint is actually rendered as a paragraph (hint density, or tooltip
+// density with no label) — otherwise the aria-describedby target would not
+// exist. Respects a consumer-provided aria-describedby and only fills in the
+// missing association. Runs after the wrapper exists, so it also covers
+// advanced-tier fields revealed later by the mode switch.
+const hintRendered = $derived(
+  help !== null && (helpDensity === 'hint' || label === null),
+);
+
+$effect(() => {
+  if (!rootEl || !hintRendered) {
+    return;
+  }
+  const control = rootEl.querySelector<HTMLElement>('input, textarea, select');
+  if (!control) {
+    return;
+  }
+  if (control.hasAttribute('aria-describedby')) {
+    return; // Consumer owns the association — never overwrite it.
+  }
+  control.setAttribute('aria-describedby', helpId);
+  return () => {
+    // Hint no longer rendered (or wrapper torn down) — drop the link we added.
+    if (control.getAttribute('aria-describedby') === helpId) {
+      control.removeAttribute('aria-describedby');
+    }
+  };
+});
+
+// --- Label ↔ control association (default wrapper only) ---
+// The wrapper renders `<label for={name}>`, which only associates with the
+// wrapped control when that control's `id` matches. Consumers normally give
+// the input `id={name}`; this effect repairs the association once the wrapper
+// exists (covering advanced-tier fields revealed later by the mode switch):
+// - control with its own id → re-point `for` at that id;
+// - control with no id → assign `id={name}` so the association holds;
+// - no wrapped control at all → omit `for` (a dangling reference is worse
+//   than none).
+//
+// `controlId` is undefined until the first effect pass (SSR and first paint
+// keep the documented `for={name}` convention); afterwards it is the repaired
+// target id, or null when there is no wrapped control.
+let controlId = $state<string | null | undefined>(undefined);
+
+$effect(() => {
+  if (!rootEl || label === null || !visible) {
+    return;
+  }
+  // Form controls only — buttons and contenteditable hosts are out of scope
+  // (same scope as the aria-describedby effect above).
+  const control = rootEl.querySelector<HTMLElement>('input, textarea, select');
+  if (!control) {
+    controlId = null;
+    return;
+  }
+  if (control.id) {
+    controlId = control.id;
+  } else {
+    control.setAttribute('id', id);
+    controlId = id;
+  }
+});
+
+// Prefill is a one-shot per component instance: it runs the first time the
+// wrapper exists with a usable default (mount for visible fields, or first
+// reveal for advanced-tier fields hidden in basic mode). The `visible` read
+// makes the effect re-run when a hidden field becomes visible; the `prefilled`
+// guard keeps it one-shot so a user who clears the input is never re-filled.
+$effect(() => {
+  if (prefilled || !visible || !isNewRecord || !hasDefault) {
+    return;
+  }
+  if (defaultValue === undefined || defaultValue === null) {
+    return;
+  }
+  if (!rootEl) {
+    // Wrapper not mounted yet — rootEl is tracked $state, so the effect
+    // re-runs once the binding lands.
+    return;
+  }
+  prefilled = true;
+  prefillInputs();
+});
+</script>
+
+{#if renderSnippet}
+  {@render renderSnippet(snippetProps)}
+{:else if visible}
+  <div class="policy-field {className}" bind:this={rootEl}>
+    {#if label !== null}
+      <!-- `for` tracks the repaired label↔control association: the `name`
+           convention before the first effect pass (SSR / first paint), the
+           repaired control id afterwards; Svelte omits the attribute entirely
+           when it resolves to null (no wrapped control). -->
+      <label
+        class="policy-field__label"
+        for={controlId === undefined ? id : controlId}
+        title={helpDensity === 'tooltip' && help !== null ? help : undefined}
+      >
+        {label}{#if required}<span class="policy-field__required" aria-hidden="true">*</span>{/if}
+      </label>
+    {/if}
+    {@render children?.()}
+    {#if help !== null && (helpDensity === 'hint' || label === null)}
+      <!-- Hint text density, or tooltip density with no label to attach the
+           title attribute to (fall back to visible help rather than dropping
+           it). -->
+      <p class="policy-field__hint" id={helpId}>{help}</p>
+    {/if}
+  </div>
+{/if}
+
+<style>
+  .policy-field {
+    display: flex;
+    flex-direction: column;
+    gap: var(--smrt-spacing-1, 0.25rem);
+  }
+
+  .policy-field__label {
+    font: var(--smrt-typography-label-large-font, inherit);
+    color: var(--smrt-color-on-surface, currentColor);
+  }
+
+  .policy-field__required {
+    color: var(--smrt-color-error, #b3261e);
+    margin-left: 0.25em;
+  }
+
+  .policy-field__hint {
+    font: var(--smrt-typography-body-small-font, inherit);
+    color: var(--smrt-color-on-surface-variant, currentColor);
+    margin: 0;
+  }
+</style>

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

@@ -0,0 +1,80 @@
+/**
+ * PolicyField — layout-neutral wrapper around any input.
+ *
+ * Contributes:
+ * - Visibility by resolved tier × current mode (advanced fields hidden in
+ *   basic mode)
+ * - Initial-value prefill from the resolved default (new records only —
+ *   never clobbers loaded values)
+ * - Label rendering (the resolved label; when the policy has no label the
+ *   label element is omitted rather than fabricated from the raw field name,
+ *   and tooltip-density help falls back to a visible hint)
+ * - Help hint rendered from resolved help (manifest description → org/user
+ *   override)
+ * - Required marker
+ *
+ * Label ↔ control association: the default wrapper renders
+ * `<label for={name}>`, so the wrapped control should carry an `id` equal to
+ * the field `name`. When the first wrapped control has a different `id`, the
+ * `for` attribute is re-pointed to it after mount; when it has no `id` at
+ * all, the wrapper assigns `id={name}` so the association is guaranteed.
+ *
+ * Headless escape hatch: pass a `render` snippet receiving
+ * `{visible, label, help, defaultValue, required, tier}` for fully custom
+ * rendering. Without a snippet, PolicyField wraps children in a label + help
+ * affordance and controls visibility.
+ *
+ * Graceful degradation: outside a FieldPolicyProvider, PolicyField renders its
+ * children verbatim (no visibility filtering, no label/help injection) so
+ * forms can adopt it incrementally.
+ */
+import type { Snippet } from 'svelte';
+import type { PolicyFieldSnippetProps } from '../types.js';
+export interface Props {
+    /** The field name matching a key in the resolved policy's `fields`. */
+    name: string;
+    /** Stable per-form control id; defaults to `name` for standalone use. */
+    id?: string;
+    /** Stable per-form help id; defaults to `${id}-help`. */
+    helpId?: string;
+    /**
+     * Children — the actual input(s). Always rendered when the field is visible
+     * (unless the `render` snippet escape hatch is used).
+     */
+    children?: Snippet;
+    /**
+     * Headless escape hatch: a snippet receiving all resolved policy data for
+     * fully custom rendering. When provided, it replaces the default label +
+     * children + help layout entirely.
+     */
+    render?: Snippet<[PolicyFieldSnippetProps]>;
+    /**
+     * Whether this is a new record. When true (default) and the field has a
+     * resolved default, the provider can prefill. Set to false for loaded
+     * records to prevent overwriting existing values.
+     * @default true
+     */
+    isNewRecord?: boolean;
+    /**
+     * Override the resolved label. When provided, takes precedence over the
+     * policy label.
+     */
+    label?: string;
+    /**
+     * Override the resolved help text. When provided, takes precedence over
+     * the policy help.
+     */
+    help?: string;
+    /**
+     * Density of the help hint: 'hint' (inline hint text, default) or
+     * 'tooltip' (title attribute on the label).
+     * @default 'hint'
+     */
+    helpDensity?: 'hint' | 'tooltip';
+    /** Additional class for the wrapper element. */
+    class?: string;
+}
+declare const PolicyField: import("svelte").Component<Props, {}, "">;
+type PolicyField = ReturnType<typeof PolicyField>;
+export default PolicyField;
+//# sourceMappingURL=PolicyField.svelte.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PolicyField.svelte.d.ts","sourceRoot":"","sources":["../../../src/svelte/components/PolicyField.svelte.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAEtC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAG3D,MAAM,WAAW,KAAK;IACpB,uEAAuE;IACvE,IAAI,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,yDAAyD;IACzD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC;IAC5C;;;;;OAKG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AA8OD,QAAA,MAAM,WAAW,2CAAwC,CAAC;AAC1D,KAAK,WAAW,GAAG,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC;AAClD,eAAe,WAAW,CAAC"}

package/dist/svelte/context.svelte.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Svelte context for the field-policy form primitives (#2048).
+ *
+ * `FieldPolicyProvider` seeds a {@link FieldPolicyContextValue} into the
+ * component tree from a pre-resolved {@link ResolvedObjectFieldPolicy} (SSR
+ * `initialData` or a client fetch by the app — no smrt-web import in the
+ * primitives). `PolicyField` and the mode-UX compositions read it through
+ * {@link getFieldPolicyContext} / {@link tryGetFieldPolicyContext}.
+ *
+ * Mirrors the established `tryGet…` pattern (`tryGetControlInteractionContext`,
+ * `useI18n`'s process-wide fallback) so `PolicyField` degrades gracefully
+ * outside a Provider: an unwrapped field renders its children verbatim, and a
+ * consumer can adopt the primitives incrementally without wrapping the whole
+ * form.
+ */
+import type { ResolvedFieldPolicy, ResolvedObjectFieldPolicy } from '../types.js';
+/** UI display mode for progressive disclosure. */
+export type FieldPolicyMode = 'basic' | 'advanced';
+/**
+ * Reactive mode store implemented as a class with `$state` fields. Svelte 5
+ * tracks `$state` on class instances correctly across context boundaries —
+ * the instance is the reactive root, not the closure.
+ */
+export declare class FieldPolicyModeStore {
+    current: FieldPolicyMode;
+    constructor(initial?: FieldPolicyMode);
+    set(next: FieldPolicyMode): void;
+    toggle(): void;
+}
+/** Svelte 5 runes-backed reactive context published by FieldPolicyProvider. */
+export interface FieldPolicyContextValue {
+    /** The fully resolved policy for one object. */
+    readonly policy: ResolvedObjectFieldPolicy;
+    /** Reactive mode store (basic/advanced) owned by the provider. */
+    readonly mode: FieldPolicyModeStore;
+    /**
+     * Lookup of a single field's resolved policy by name.
+     * Returns `undefined` when the field is not in the resolved set.
+     */
+    getField(fieldName: string): ResolvedFieldPolicy | undefined;
+    /** Count of advanced-visible fields for the disclosure label. */
+    readonly advancedFieldCount: number;
+}
+/** Publish the context (called by FieldPolicyProvider). */
+export declare function setFieldPolicyContext(context: FieldPolicyContextValue): void;
+/** Read the context, throwing when there is no Provider. */
+export declare function getFieldPolicyContext(): FieldPolicyContextValue;
+/**
+ * Optional reader — returns `undefined` when no Provider wraps the consumer.
+ * Used by `PolicyField` so it can render children verbatim outside a Provider
+ * (graceful degradation / incremental adoption).
+ */
+export declare function tryGetFieldPolicyContext(): FieldPolicyContextValue | undefined;
+//# sourceMappingURL=context.svelte.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.svelte.d.ts","sourceRoot":"","sources":["../../src/svelte/context.svelte.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,KAAK,EACV,mBAAmB,EACnB,yBAAyB,EAC1B,MAAM,aAAa,CAAC;AAErB,kDAAkD;AAClD,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,UAAU,CAAC;AAEnD;;;;GAIG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,kBAAoC;gBAE/B,OAAO,GAAE,eAAyB;IAI9C,GAAG,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI;IAIhC,MAAM,IAAI,IAAI;CAGf;AAED,+EAA+E;AAC/E,MAAM,WAAW,uBAAuB;IACtC,gDAAgD;IAChD,QAAQ,CAAC,MAAM,EAAE,yBAAyB,CAAC;IAC3C,kEAAkE;IAClE,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACpC;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAAC;IAC7D,iEAAiE;IACjE,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;CACrC;AAID,2DAA2D;AAC3D,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,uBAAuB,GAAG,IAAI,CAE5E;AAED,4DAA4D;AAC5D,wBAAgB,qBAAqB,IAAI,uBAAuB,CAS/D;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,IACpC,uBAAuB,GACvB,SAAS,CAIZ"}

package/dist/svelte/context.svelte.js

@@ -0,0 +1,55 @@
+/**
+ * Svelte context for the field-policy form primitives (#2048).
+ *
+ * `FieldPolicyProvider` seeds a {@link FieldPolicyContextValue} into the
+ * component tree from a pre-resolved {@link ResolvedObjectFieldPolicy} (SSR
+ * `initialData` or a client fetch by the app — no smrt-web import in the
+ * primitives). `PolicyField` and the mode-UX compositions read it through
+ * {@link getFieldPolicyContext} / {@link tryGetFieldPolicyContext}.
+ *
+ * Mirrors the established `tryGet…` pattern (`tryGetControlInteractionContext`,
+ * `useI18n`'s process-wide fallback) so `PolicyField` degrades gracefully
+ * outside a Provider: an unwrapped field renders its children verbatim, and a
+ * consumer can adopt the primitives incrementally without wrapping the whole
+ * form.
+ */
+import { getContext, setContext } from 'svelte';
+/**
+ * Reactive mode store implemented as a class with `$state` fields. Svelte 5
+ * tracks `$state` on class instances correctly across context boundaries —
+ * the instance is the reactive root, not the closure.
+ */
+export class FieldPolicyModeStore {
+    current = $state('basic');
+    constructor(initial = 'basic') {
+        this.current = initial;
+    }
+    set(next) {
+        this.current = next;
+    }
+    toggle() {
+        this.current = this.current === 'basic' ? 'advanced' : 'basic';
+    }
+}
+const FIELD_POLICY_CONTEXT_KEY = Symbol('smrt-field-policy-context');
+/** Publish the context (called by FieldPolicyProvider). */
+export function setFieldPolicyContext(context) {
+    setContext(FIELD_POLICY_CONTEXT_KEY, context);
+}
+/** Read the context, throwing when there is no Provider. */
+export function getFieldPolicyContext() {
+    const context = tryGetFieldPolicyContext();
+    if (!context) {
+        throw new Error('FieldPolicy context not found. Wrap your form in ' +
+            '<FieldPolicyProvider> from @happyvertical/smrt-fields/svelte.');
+    }
+    return context;
+}
+/**
+ * Optional reader — returns `undefined` when no Provider wraps the consumer.
+ * Used by `PolicyField` so it can render children verbatim outside a Provider
+ * (graceful degradation / incremental adoption).
+ */
+export function tryGetFieldPolicyContext() {
+    return getContext(FIELD_POLICY_CONTEXT_KEY);
+}

package/dist/svelte/data-table.d.ts

@@ -0,0 +1,17 @@
+/** Pure adapter between resolved field policy and smrt-ui DataTable columns. */
+import type { ResolvedObjectFieldPolicy } from '../types.js';
+export interface PolicyDataTableColumn {
+    id: string;
+    /** DataTable still enforces this independently; excluding it here is useful
+     * to callers that inspect the returned set before rendering. */
+    hidden?: boolean;
+}
+/**
+ * Produce DataTable's `visibleColumnIds` set from a resolved policy.
+ *
+ * Only policy-mapped hidden fields are removed. Columns with no matching field
+ * remain visible so computed, selection, and action columns keep working.
+ * Static `column.hidden` remains authoritative and can never be undone.
+ */
+export declare function policyToVisibleColumnIds(policy: ResolvedObjectFieldPolicy, columns: readonly PolicyDataTableColumn[], fieldNameByColumnId?: Readonly<Record<string, string>>): Set<string>;
+//# sourceMappingURL=data-table.d.ts.map

package/dist/svelte/data-table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-table.d.ts","sourceRoot":"","sources":["../../src/svelte/data-table.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAE7D,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX;oEACgE;IAChE,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,yBAAyB,EACjC,OAAO,EAAE,SAAS,qBAAqB,EAAE,EACzC,mBAAmB,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAM,GACzD,GAAG,CAAC,MAAM,CAAC,CASb"}

package/dist/svelte/data-table.js

@@ -0,0 +1,19 @@
+/**
+ * Produce DataTable's `visibleColumnIds` set from a resolved policy.
+ *
+ * Only policy-mapped hidden fields are removed. Columns with no matching field
+ * remain visible so computed, selection, and action columns keep working.
+ * Static `column.hidden` remains authoritative and can never be undone.
+ */
+export function policyToVisibleColumnIds(policy, columns, fieldNameByColumnId = {}) {
+    const visible = new Set();
+    for (const column of columns) {
+        if (column.hidden)
+            continue;
+        const fieldName = fieldNameByColumnId[column.id] ?? column.id;
+        const field = policy.fields[fieldName];
+        if (field?.visibility !== 'hidden')
+            visible.add(column.id);
+    }
+    return visible;
+}

package/dist/svelte/field-policy-editor.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Transport-neutral client contracts and pure helpers for the policy gear.
+ *
+ * Hosts normally adapt these methods to their generated FieldPolicyCollection
+ * client. Identity is intentionally absent from mutations: the server derives
+ * tenant/user scope from the authenticated ambient context.
+ */
+import type { FieldPolicyEditorRow, FieldPolicyEditorState, FieldPolicyEditorStateResult, FieldPolicyScopeType } from '../types.js';
+export interface FieldPolicyEditorAdapter {
+    load(input: {
+        objectRef: string;
+    }): Promise<FieldPolicyEditorStateResult>;
+    create(input: FieldPolicyEditorMutation): Promise<unknown>;
+    update(input: FieldPolicyEditorMutation & {
+        id: string;
+    }): Promise<unknown>;
+    delete(input: {
+        id: string;
+    }): Promise<unknown>;
+}
+/** Generated-client compatible sparse write shape. `defaultValue` is JSON. */
+export interface FieldPolicyEditorMutation {
+    objectRef: string;
+    fieldName: string;
+    scopeType: FieldPolicyScopeType;
+    defaultValue: string | null;
+    displayOrder: number | null;
+    help: string | null;
+    label: string | null;
+    locked: boolean | null;
+    visibility: 'basic' | 'advanced' | 'hidden' | null;
+}
+export type FieldPolicyEditorTab = 'organization' | 'personal';
+export type FieldPolicyOrganizationScope = 'app' | 'tenant';
+export interface FieldPolicyEditorDraft {
+    defaultEnabled: boolean;
+    defaultValue: unknown;
+    displayOrder: number | null;
+    help: string | null;
+    label: string | null;
+    locked: boolean | null;
+    visibility: 'basic' | 'advanced' | 'hidden' | null;
+}
+export declare function isFieldPolicyEditorState(result: unknown, expectedObjectRef?: string): result is FieldPolicyEditorState;
+/** Safe message extraction for generated custom actions, whose client type is `any`. */
+export declare function editorStateErrorMessage(result: unknown): string;
+export declare function rowForScope(state: FieldPolicyEditorState, fieldName: string, scope: FieldPolicyScopeType): FieldPolicyEditorRow | undefined;
+export declare function draftFromRow(row?: FieldPolicyEditorRow): FieldPolicyEditorDraft;
+export declare function mutationFromDraft(objectRef: string, fieldName: string, scopeType: FieldPolicyScopeType, draft: FieldPolicyEditorDraft): FieldPolicyEditorMutation;
+/**
+ * Serialize the explicit default-value wire channel without ever leaking an
+ * `undefined` payload into a generated client. JSON null remains intentional.
+ */
+export declare function serializeDefaultValue(value: unknown): string;
+export declare function defaultValueSerializationError(value: unknown): string | null;
+export declare function requiredVisibilityIsInvalid(required: boolean, visibility: FieldPolicyEditorDraft['visibility'], effectiveDefault: unknown): boolean;
+export declare function hasUsableDefault(value: unknown): boolean;
+/** Structural AdminShell seam; importing smrt-svelte here would invert the DAG. */
+export interface FieldPolicyFocusTool {
+    id: string;
+    label: string;
+    description?: string;
+    order?: number;
+    component?: unknown;
+    render?: unknown;
+    subject?: {
+        type: string;
+        id: string;
+        label?: string;
+    };
+}
+export interface FieldPolicyFocusToolRegistrar {
+    registerFocusTool(tool: FieldPolicyFocusTool): () => void;
+}
+/**
+ * Registers an object-form settings tool with AdminShell-compatible state.
+ * AdminShell passes `{ tool, shell }` to a component focus tool; callers pass
+ * that component through `tool.component` without Fields importing the shell.
+ */
+export declare function registerFieldPolicyFocusTool(shell: FieldPolicyFocusToolRegistrar, objectRef: string, tool: Omit<FieldPolicyFocusTool, 'subject'>): () => void;
+//# sourceMappingURL=field-policy-editor.d.ts.map

package/dist/svelte/field-policy-editor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-policy-editor.d.ts","sourceRoot":"","sources":["../../src/svelte/field-policy-editor.ts"],"names":[],"mappings":"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"}