@happyvertical/smrt-ui 0.43.4 → 0.43.6

package/dist/components/forms/control-value-validation.d.ts

@@ -0,0 +1,19 @@
+import type { ControlOption } from './control-interaction.js';
+export declare function booleanControlValue(next: unknown): boolean;
+export declare function prepareBooleanControlValue(next: unknown): unknown;
+export declare function prepareTextControlValue(next: unknown): unknown;
+export declare function prepareNumberControlValue(next: unknown): unknown;
+export declare function prepareEnabledOptionValue(options: ControlOption[], next: unknown, matchLabel?: boolean): unknown;
+export declare function prepareEnabledOptionValues(options: ControlOption[], next: unknown): unknown;
+export declare function validateNativeCheckedValue(element: HTMLInputElement, next: unknown): boolean;
+export declare function validateNativeTextValue(element: HTMLTextAreaElement, next: unknown): boolean;
+export declare function matchingOption(options: ControlOption[], next: unknown, matchLabel?: boolean): ControlOption | undefined;
+export declare function validatesEnabledOption(options: ControlOption[], next: unknown, matchLabel?: boolean): boolean;
+export declare function validatesEnabledOptions(options: ControlOption[], next: unknown): boolean;
+export declare function normalizeEnabledOptions(options: ControlOption[], next: unknown): Array<string | number> | undefined;
+export declare function normalizeCurrentOptionValues(options: ControlOption[], next: unknown): Array<string | number>;
+export declare function numberMatchesStep(value: number, min: number, step: number): boolean;
+export declare function validatesSteppedNumber(next: unknown, min: number, max: number, step: number): boolean;
+export declare function snapSteppedNumber(next: number, min: number, max: number, step: number): number;
+export declare function validatesStringArray(next: unknown, maxItems: number | undefined, allowDuplicates: boolean): boolean;
+//# sourceMappingURL=control-value-validation.d.ts.map

package/dist/components/forms/control-value-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"control-value-validation.d.ts","sourceRoot":"","sources":["../../../src/components/forms/control-value-validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAE9D,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAI1D;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAMjE;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAU9D;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAOhE;AAED,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,aAAa,EAAE,EACxB,IAAI,EAAE,OAAO,EACb,UAAU,UAAQ,GACjB,OAAO,CAGT;AAED,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,aAAa,EAAE,EACxB,IAAI,EAAE,OAAO,GACZ,OAAO,CAET;AAED,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,gBAAgB,EACzB,IAAI,EAAE,OAAO,GACZ,OAAO,CAKT;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,mBAAmB,EAC5B,IAAI,EAAE,OAAO,GACZ,OAAO,CAST;AAED,wBAAgB,cAAc,CAC5B,OAAO,EAAE,aAAa,EAAE,EACxB,IAAI,EAAE,OAAO,EACb,UAAU,UAAQ,GACjB,aAAa,GAAG,SAAS,CAU3B;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,aAAa,EAAE,EACxB,IAAI,EAAE,OAAO,EACb,UAAU,UAAQ,GACjB,OAAO,CAGT;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,aAAa,EAAE,EACxB,IAAI,EAAE,OAAO,GACZ,OAAO,CAET;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,aAAa,EAAE,EACxB,IAAI,EAAE,OAAO,GACZ,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,SAAS,CAEpC;AAED,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,aAAa,EAAE,EACxB,IAAI,EAAE,OAAO,GACZ,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAExB;AAqCD,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,GACX,OAAO,CAIT;AAED,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,OAAO,EACb,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,GACX,OAAO,CAaT;AAED,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,GACX,MAAM,CA4BR;AAoBD,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,OAAO,EACb,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,eAAe,EAAE,OAAO,GACvB,OAAO,CAKT"}

package/dist/components/forms/control-value-validation.js

@@ -0,0 +1,152 @@
+export function booleanControlValue(next) {
+    return typeof next === 'string'
+        ? ['true', '1', 'yes', 'on'].includes(next.toLowerCase())
+        : Boolean(next);
+}
+export function prepareBooleanControlValue(next) {
+    if (typeof next === 'boolean')
+        return next;
+    if (next !== null && typeof next === 'object') {
+        throw new Error('staged_value_invalid');
+    }
+    return next;
+}
+export function prepareTextControlValue(next) {
+    if (next === null || next === undefined)
+        return next;
+    if (typeof next === 'string' ||
+        typeof next === 'number' ||
+        typeof next === 'boolean') {
+        return String(next);
+    }
+    throw new Error('staged_value_invalid');
+}
+export function prepareNumberControlValue(next) {
+    if (next === '' || next === null || next === undefined)
+        return '';
+    if (typeof next !== 'string' && typeof next !== 'number') {
+        throw new Error('staged_value_invalid');
+    }
+    const value = Number(next);
+    return Number.isFinite(value) ? value : next;
+}
+export function prepareEnabledOptionValue(options, next, matchLabel = false) {
+    const option = matchingOption(options, next, matchLabel);
+    return option?.value ?? next;
+}
+export function prepareEnabledOptionValues(options, next) {
+    return normalizeEnabledOptions(options, next) ?? next;
+}
+export function validateNativeCheckedValue(element, next) {
+    if (typeof next !== 'boolean')
+        return false;
+    const candidate = element.cloneNode();
+    candidate.checked = next;
+    return candidate.checkValidity();
+}
+export function validateNativeTextValue(element, next) {
+    const candidate = element.cloneNode();
+    candidate.value = String(next ?? '');
+    if (candidate.required && candidate.value.length === 0)
+        return false;
+    if (candidate.minLength >= 0 && candidate.value.length < candidate.minLength)
+        return false;
+    if (candidate.maxLength >= 0 && candidate.value.length > candidate.maxLength)
+        return false;
+    return candidate.checkValidity();
+}
+export function matchingOption(options, next, matchLabel = false) {
+    const candidate = String(next ?? '');
+    return (options.find((option) => Object.is(option.value, next)) ??
+        options.find((option) => String(option.value) === candidate ||
+            (matchLabel && option.label === candidate)));
+}
+export function validatesEnabledOption(options, next, matchLabel = false) {
+    const option = matchingOption(options, next, matchLabel);
+    return option !== undefined && option.disabled !== true;
+}
+export function validatesEnabledOptions(options, next) {
+    return normalizeEnabledOptions(options, next) !== undefined;
+}
+export function normalizeEnabledOptions(options, next) {
+    return normalizeOptionValues(options, next, false, false);
+}
+export function normalizeCurrentOptionValues(options, next) {
+    return normalizeOptionValues(options, next, true, true) ?? [];
+}
+function normalizeOptionValues(options, next, allowDisabled, skipInvalid) {
+    if (!Array.isArray(next))
+        return undefined;
+    const matchedIndexes = new Set();
+    const normalized = [];
+    for (const candidate of next) {
+        if (typeof candidate !== 'string' && typeof candidate !== 'number')
+            return undefined;
+        let index = options.findIndex((option) => Object.is(option.value, candidate));
+        if (index < 0) {
+            index = options.findIndex((option) => String(option.value) === String(candidate));
+        }
+        const option = options[index];
+        const invalid = !option ||
+            (!allowDisabled && option.disabled) ||
+            matchedIndexes.has(index);
+        if (invalid) {
+            if (skipInvalid)
+                continue;
+            return undefined;
+        }
+        matchedIndexes.add(index);
+        normalized.push(option.value);
+    }
+    return normalized;
+}
+export function numberMatchesStep(value, min, step) {
+    if (!Number.isFinite(step) || step <= 0)
+        return true;
+    const offset = (value - min) / step;
+    return Math.abs(offset - Math.round(offset)) <= 1e-9;
+}
+export function validatesSteppedNumber(next, min, max, step) {
+    let value;
+    try {
+        value = typeof next === 'number' ? next : Number(next);
+    }
+    catch {
+        return false;
+    }
+    return (Number.isFinite(value) &&
+        value >= min &&
+        value <= max &&
+        numberMatchesStep(value, min, step));
+}
+export function snapSteppedNumber(next, min, max, step) {
+    if (!Number.isFinite(step) || step <= 0) {
+        return Math.min(max, Math.max(min, next));
+    }
+    const snapped = min + Math.round((next - min) / step) * step;
+    const precision = Math.max(decimalPlaces(min), decimalPlaces(max), decimalPlaces(step));
+    const stable = precision <= 100
+        ? Number(snapped.toFixed(precision))
+        : Number(snapped.toPrecision(Math.min(100, Math.max(significantDigits(min), significantDigits(max), significantDigits(step), significantDigits(next), significantDigits(snapped)))));
+    return Math.min(max, Math.max(min, stable));
+}
+function significantDigits(value) {
+    const coefficient = String(Math.abs(value)).toLowerCase().split('e')[0] ?? '';
+    const digits = coefficient.replace('.', '').replace(/^0+/, '');
+    return Math.max(1, digits.length);
+}
+function decimalPlaces(value) {
+    const [coefficient = '', exponentText = '0'] = String(value)
+        .toLowerCase()
+        .split('e');
+    const fractionLength = coefficient.split('.')[1]?.length ?? 0;
+    const exponent = Number(exponentText);
+    return Math.max(0, fractionLength - (Number.isFinite(exponent) ? exponent : 0));
+}
+export function validatesStringArray(next, maxItems, allowDuplicates) {
+    if (!Array.isArray(next) || !next.every((item) => typeof item === 'string'))
+        return false;
+    if (maxItems !== undefined && next.length > maxItems)
+        return false;
+    return allowDuplicates || new Set(next).size === next.length;
+}

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

@@ -13,7 +13,7 @@
  */
 export { default as Checkbox } from './Checkbox.svelte';
 export { default as Combobox } from './Combobox.svelte';
-export { type ControlCapability, type ControlCommand, type ControlCommandAction, type ControlCommandContext, type ControlCommandResult, type ControlCommandSource, type ControlConstraints, type ControlIdentity, type ControlInteractionEvent, type ControlInteractionOptions, type ControlInteractionPolicy, type ControlInteractionRegistry, type ControlKind, type ControlMetadata, type ControlOption, type ControlRegistration, type ControlRuntimeState, type ControlSensitivity, type ControlSnapshot, type ControlSubject, createControlInteractionRegistry, } from './control-interaction.js';
+export { type ControlBatchResult, type ControlCapability, type ControlCommand, type ControlCommandAction, type ControlCommandContext, type ControlCommandResult, type ControlCommandSource, type ControlConstraints, type ControlExtensionContext, type ControlIdentity, type ControlInteractionEvent, type ControlInteractionOptions, type ControlInteractionPolicy, type ControlInteractionRegistry, type ControlKind, type ControlMetadata, type ControlOption, type ControlRegistration, type ControlRuntimeState, type ControlSensitivity, type ControlSnapshot, type ControlStagedEntry, type ControlStagedProvenance, type ControlSubject, type ControlValueValidationResult, createControlInteractionRegistry, executeLocalControlBatch, executeLocalControlCommand, } from './control-interaction.js';
 export { type ControlInteractionContextValue, getControlInteractionContext, setControlInteractionContext, tryGetControlInteractionContext, } from './control-interaction-context.js';
 export { default as DatePicker } from './DatePicker.svelte';
 export { default as ErrorSummary } from './ErrorSummary.svelte';
@@ -32,7 +32,9 @@ export { default as RangeSlider } from './RangeSlider.svelte';
 export { default as SegmentedControl } from './SegmentedControl.svelte';
 export { default as Select } from './Select.svelte';
 export { default as Slider } from './Slider.svelte';
+export { default as StagedControlReview } from './StagedControlReview.svelte';
 export { default as Switch } from './Switch.svelte';
+export type { StagedControlReviewLabels } from './staged-control-review.js';
 export { default as TagsInput } from './TagsInput.svelte';
 export { default as Textarea } from './Textarea.svelte';
 export { default as TimePicker } from './TimePicker.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;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,uBAAuB,EAC5B,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,EAC7B,KAAK,0BAA0B,EAC/B,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,gCAAgC,GACjC,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,KAAK,8BAA8B,EACnC,4BAA4B,EAC5B,4BAA4B,EAC5B,+BAA+B,GAChC,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,EACL,KAAK,qBAAqB,EAC1B,WAAW,EACX,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AACxE,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAChE,YAAY,EACV,SAAS,EACT,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/forms/index.ts"],"names":[],"mappings":"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"}

package/dist/components/forms/index.js

@@ -13,7 +13,7 @@
  */
 export { default as Checkbox } from './Checkbox.svelte';
 export { default as Combobox } from './Combobox.svelte';
-export { createControlInteractionRegistry, } from './control-interaction.js';
+export { createControlInteractionRegistry, executeLocalControlBatch, executeLocalControlCommand, } from './control-interaction.js';
 export { getControlInteractionContext, setControlInteractionContext, tryGetControlInteractionContext, } from './control-interaction-context.js';
 export { default as DatePicker } from './DatePicker.svelte';
 export { default as ErrorSummary } from './ErrorSummary.svelte';
@@ -32,6 +32,7 @@ export { default as RangeSlider } from './RangeSlider.svelte';
 export { default as SegmentedControl } from './SegmentedControl.svelte';
 export { default as Select } from './Select.svelte';
 export { default as Slider } from './Slider.svelte';
+export { default as StagedControlReview } from './StagedControlReview.svelte';
 export { default as Switch } from './Switch.svelte';
 export { default as TagsInput } from './TagsInput.svelte';
 export { default as Textarea } from './Textarea.svelte';

package/dist/components/forms/staged-control-review.d.ts

@@ -0,0 +1,21 @@
+export interface StagedControlReviewLabels {
+    region: string;
+    heading: string;
+    description: string;
+    proposedBy: string;
+    stagedAt: string;
+    before: string;
+    after: string;
+    redacted: string;
+    stale: string;
+    invalid: string;
+    apply: string;
+    discard: string;
+    applyAll: string;
+    discardAll: string;
+    edit: string;
+    appliedStatus: string;
+    discardedStatus: string;
+    batchStatus: string;
+}
+//# sourceMappingURL=staged-control-review.d.ts.map

package/dist/components/forms/staged-control-review.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"staged-control-review.d.ts","sourceRoot":"","sources":["../../../src/components/forms/staged-control-review.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;CACrB"}

package/dist/components/forms/staged-control-review.js

@@ -0,0 +1 @@
+export {};

package/dist/components/forms/use-control-registration.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-control-registration.svelte.d.ts","sourceRoot":"","sources":["../../../src/components/forms/use-control-registration.svelte.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,cAAc,EACf,MAAM,0BAA0B,CAAC;AAGlC,MAAM,WAAW,6BACf,SAAQ,IAAI,CAAC,mBAAmB,EAAE,UAAU,CAAC;IAC7C,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,OAAO,CAAC,EAAE,cAAc,CAAC;CAC1B;AAED,6EAA6E;AAC7E,wBAAgB,sBAAsB,CACpC,aAAa,EAAE,MAAM,6BAA6B,GAAG,KAAK,GACzD,IAAI,CAWN"}
+{"version":3,"file":"use-control-registration.svelte.d.ts","sourceRoot":"","sources":["../../../src/components/forms/use-control-registration.svelte.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,mBAAmB,EACnB,cAAc,EACf,MAAM,0BAA0B,CAAC;AAGlC,MAAM,WAAW,6BACf,SAAQ,IAAI,CAAC,mBAAmB,EAAE,UAAU,CAAC;IAC7C,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,OAAO,CAAC,EAAE,cAAc,CAAC;CAC1B;AAED,6EAA6E;AAC7E,wBAAgB,sBAAsB,CACpC,aAAa,EAAE,MAAM,6BAA6B,GAAG,KAAK,GACzD,IAAI,CAkCN"}

package/dist/components/forms/use-control-registration.svelte.js

@@ -1,15 +1,34 @@
+import { onDestroy, untrack } from 'svelte';
 import { tryGetControlInteractionContext } from './control-interaction-context.js';
 /** Register a reactive control descriptor with the nearest Form registry. */
 export function useControlRegistration(getDescriptor) {
     const context = tryGetControlInteractionContext();
+    let disposeCurrent;
+    onDestroy(() => {
+        disposeCurrent?.();
+        disposeCurrent = undefined;
+    });
     $effect(() => {
         const descriptor = getDescriptor();
-        if (!context || descriptor === false || !descriptor.controlId)
+        if (!context || descriptor === false || !descriptor.controlId) {
+            disposeCurrent?.();
+            disposeCurrent = undefined;
             return;
+        }
         const { controlId, subject, ...registration } = descriptor;
-        return context.registry.register({
+        const registry = context.registry;
+        const formId = context.formId;
+        const identitySubject = subject
+            ? { type: subject.type, id: subject.id, label: subject.label }
+            : undefined;
+        const previousDispose = disposeCurrent;
+        disposeCurrent = untrack(() => registry.register({
             ...registration,
-            identity: { formId: context.formId, controlId, subject },
-        });
+            identity: { formId, controlId, subject: identitySubject },
+        }));
+        // Register the replacement before disposing the prior descriptor. For a
+        // same-identity reactive update the old disposer then becomes a no-op,
+        // preserving staged proposals, undo history, and user-edit snapshots.
+        previousDispose?.();
     });
 }

package/dist/i18n/strings.d.ts

@@ -1,4 +1,7 @@
 export declare const M: {
+    readonly 'ui.currency_display.invalid_code': "ui.currency_display.invalid_code";
+    readonly 'ui.currency_display.invalid_minor_unit_amount': "ui.currency_display.invalid_minor_unit_amount";
+    readonly 'ui.currency_display.no_minor_unit': "ui.currency_display.no_minor_unit";
     readonly 'ui.data_table.select_all': "ui.data_table.select_all";
     readonly 'ui.data_table.select_current_page': "ui.data_table.select_current_page";
     readonly 'ui.data_table.select_row': "ui.data_table.select_row";

package/dist/i18n/strings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"strings.d.ts","sourceRoot":"","sources":["../../src/i18n/strings.ts"],"names":[],"mappings":"AAcA,eAAO,MAAM,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiCZ,CAAC"}
+{"version":3,"file":"strings.d.ts","sourceRoot":"","sources":["../../src/i18n/strings.ts"],"names":[],"mappings":"AAcA,eAAO,MAAM,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqCZ,CAAC"}

package/dist/i18n/strings.js

@@ -12,6 +12,9 @@
  */
 import { defineMessages } from './registry.js';
 export const M = defineMessages({
+    'ui.currency_display.invalid_code': 'Invalid currency code: {code}',
+    'ui.currency_display.invalid_minor_unit_amount': 'Invalid minor-unit amount',
+    'ui.currency_display.no_minor_unit': 'Currency code has no minor unit: {code}',
     'ui.data_table.select_all': 'Select all rows',
     'ui.data_table.select_current_page': 'Select all rows on this page',
     'ui.data_table.select_row': 'Select {row}',

package/dist/i18n/strings.ui.d.ts

@@ -32,5 +32,23 @@ export declare const M: {
     readonly 'ui.pagination.last_page': "ui.pagination.last_page";
     readonly 'ui.reaction_picker.label': "ui.reaction_picker.label";
     readonly 'ui.reaction_picker.react_with': "ui.reaction_picker.react_with";
+    readonly 'ui.staged_control_review.region': "ui.staged_control_review.region";
+    readonly 'ui.staged_control_review.heading': "ui.staged_control_review.heading";
+    readonly 'ui.staged_control_review.description': "ui.staged_control_review.description";
+    readonly 'ui.staged_control_review.proposed_by': "ui.staged_control_review.proposed_by";
+    readonly 'ui.staged_control_review.staged_at': "ui.staged_control_review.staged_at";
+    readonly 'ui.staged_control_review.before': "ui.staged_control_review.before";
+    readonly 'ui.staged_control_review.after': "ui.staged_control_review.after";
+    readonly 'ui.staged_control_review.redacted': "ui.staged_control_review.redacted";
+    readonly 'ui.staged_control_review.stale': "ui.staged_control_review.stale";
+    readonly 'ui.staged_control_review.invalid': "ui.staged_control_review.invalid";
+    readonly 'ui.staged_control_review.apply': "ui.staged_control_review.apply";
+    readonly 'ui.staged_control_review.discard': "ui.staged_control_review.discard";
+    readonly 'ui.staged_control_review.apply_all': "ui.staged_control_review.apply_all";
+    readonly 'ui.staged_control_review.discard_all': "ui.staged_control_review.discard_all";
+    readonly 'ui.staged_control_review.edit': "ui.staged_control_review.edit";
+    readonly 'ui.staged_control_review.applied_status': "ui.staged_control_review.applied_status";
+    readonly 'ui.staged_control_review.discarded_status': "ui.staged_control_review.discarded_status";
+    readonly 'ui.staged_control_review.batch_status': "ui.staged_control_review.batch_status";
 };
 //# sourceMappingURL=strings.ui.d.ts.map

package/dist/i18n/strings.ui.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"strings.ui.d.ts","sourceRoot":"","sources":["../../src/i18n/strings.ui.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,eAAO,MAAM,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;CAgDZ,CAAC"}
+{"version":3,"file":"strings.ui.d.ts","sourceRoot":"","sources":["../../src/i18n/strings.ui.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,eAAO,MAAM,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuEZ,CAAC"}

package/dist/i18n/strings.ui.js

@@ -44,4 +44,23 @@ export const M = defineMessages({
     // chat/ReactionPicker.svelte
     'ui.reaction_picker.label': 'Add reaction',
     'ui.reaction_picker.react_with': 'React with {emoji}',
+    // forms/StagedControlReview.svelte
+    'ui.staged_control_review.region': 'Review proposed changes',
+    'ui.staged_control_review.heading': 'Proposed changes',
+    'ui.staged_control_review.description': 'Review changes before they update the form.',
+    'ui.staged_control_review.proposed_by': 'Proposed by',
+    'ui.staged_control_review.staged_at': 'staged',
+    'ui.staged_control_review.before': 'Current',
+    'ui.staged_control_review.after': 'Proposed',
+    'ui.staged_control_review.redacted': 'Hidden for privacy',
+    'ui.staged_control_review.stale': 'The field changed after this proposal was staged.',
+    'ui.staged_control_review.invalid': 'This proposal is not valid.',
+    'ui.staged_control_review.apply': 'Apply',
+    'ui.staged_control_review.discard': 'Discard',
+    'ui.staged_control_review.apply_all': 'Apply valid changes',
+    'ui.staged_control_review.discard_all': 'Discard valid changes',
+    'ui.staged_control_review.edit': 'Edit proposed value for',
+    'ui.staged_control_review.applied_status': 'Applied proposed change.',
+    'ui.staged_control_review.discarded_status': 'Discarded proposed change.',
+    'ui.staged_control_review.batch_status': 'Processed {completed} of {total} proposed changes.',
 });

package/dist/svelte/playground/InteractiveControlsPreview.svelte

@@ -40,10 +40,9 @@ let tags = $state(['svelte', 'agents']);
 let region = $state<string | number>('west');
 let status = $state('Controls are ready for direct use or agent guidance.');
 
-async function command(command: ControlCommand, confirmed = false) {
+async function command(command: ControlCommand) {
   const result = await registry.execute(command, {
     source: 'agent',
-    confirmed,
   });
   status = result.ok
     ? `${command.action} completed for ${command.identity.controlId}.`
@@ -62,10 +61,10 @@ const identity = (controlId: string) => ({
     <div class="agent-actions">
       <Button size="sm" variant="secondary" onclick={() => command({ action: 'highlight', identity: identity('country') })}>Highlight country</Button>
       <Button size="sm" variant="secondary" onclick={() => command({ action: 'stage', identity: identity('volume'), value: 72 })}>Stage volume 72</Button>
-      <Button size="sm" onclick={() => command({ action: 'apply', identity: identity('volume') }, true)}>Confirm staged value</Button>
+      <Button size="sm" onclick={() => command({ action: 'stage', identity: identity('country'), value: 'us' })}>Stage country US</Button>
     </div>
   </header>
-  <p class="agent-status" aria-live="polite">Agent: {status}</p>
+  <p class="agent-status" aria-live="polite">Agent: {status} Review staged changes in the form before applying or discarding them.</p>
 
   <Form formId="foundation-demo" interactionRegistry={registry} aria-label="Foundation controls">
     <section><h5>Choice and state</h5><div class="grid compact">

package/dist/svelte/playground/InteractiveControlsPreview.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"InteractiveControlsPreview.svelte.d.ts","sourceRoot":"","sources":["../../../src/svelte/playground/InteractiveControlsPreview.svelte.ts"],"names":[],"mappings":"AAyHA,QAAA,MAAM,0BAA0B,2DAAwC,CAAC;AACzE,KAAK,0BAA0B,GAAG,UAAU,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAChF,eAAe,0BAA0B,CAAC"}
+{"version":3,"file":"InteractiveControlsPreview.svelte.d.ts","sourceRoot":"","sources":["../../../src/svelte/playground/InteractiveControlsPreview.svelte.ts"],"names":[],"mappings":"AAwHA,QAAA,MAAM,0BAA0B,2DAAwC,CAAC;AACzE,KAAK,0BAA0B,GAAG,UAAU,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAChF,eAAe,0BAA0B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@happyvertical/smrt-ui",
-  "version": "0.43.4",
+  "version": "0.43.6",
   "description": "Domain-agnostic Svelte 5 UI runtime for SMRT: primitives, i18n client, theme system, and module UI registry",
   "type": "module",
   "main": "./dist/index.js",
@@ -129,7 +129,7 @@
   },
   "dependencies": {
     "esm-env": "^1.2.2",
-    "@happyvertical/smrt-types": "0.43.4"
+    "@happyvertical/smrt-types": "0.43.6"
   },
   "peerDependencies": {
     "svelte": "^5.56.4"