@sectile/core 0.1.0

package/dist/pagination.js

@@ -0,0 +1,190 @@
+import { fail, ok, validateSafeCeiling } from './internal/kernel/foundation.js';
+import { createMachineUpdate } from './internal/kernel/machine.js';
+export function createPaginationModel(options) {
+    const itemsPerPage = options.itemsPerPage ?? 10;
+    const siblingCount = options.siblingCount ?? 2;
+    for (const [value, name, minimum] of [
+        [options.total, 'total', 0],
+        [itemsPerPage, 'itemsPerPage', 1],
+        [siblingCount, 'siblingCount', 0],
+    ]) {
+        const error = validateSafeCeiling(value, name, minimum);
+        if (error !== null)
+            return { ok: false, error };
+    }
+    if (siblingCount > 1_000) {
+        return fail('resource-rejection', 'pagination-sibling-ceiling-exceeded', 'Pagination siblingCount exceeds its safety ceiling.', { siblingCount, ceiling: 1_000 });
+    }
+    if (options.showEdges !== undefined && typeof options.showEdges !== 'boolean') {
+        return fail('construction', 'invalid-pagination-show-edges', 'Pagination showEdges must be boolean.');
+    }
+    if (options.showControls !== undefined && typeof options.showControls !== 'boolean') {
+        return fail('construction', 'invalid-pagination-show-controls', 'Pagination showControls must be boolean.');
+    }
+    return ok(Object.freeze({
+        total: options.total,
+        itemsPerPage,
+        siblingCount,
+        showEdges: options.showEdges ?? false,
+        showControls: options.showControls ?? true,
+    }));
+}
+export function createPaginationState(model, page = 1, itemsPerPage = model.itemsPerPage) {
+    const modelError = validatePaginationModel(model);
+    if (modelError !== null)
+        return { ok: false, error: modelError };
+    const sizeError = validateSafeCeiling(itemsPerPage, 'itemsPerPage', 1);
+    if (sizeError !== null)
+        return { ok: false, error: sizeError };
+    const pageCount = derivePageCount(model.total, itemsPerPage);
+    if (!Number.isSafeInteger(page) || page < 1 || page > pageCount) {
+        return fail('construction', 'pagination-page-out-of-range', 'Pagination page must be a safe integer inside the page range.', { page, pageCount });
+    }
+    return ok(Object.freeze({ page, itemsPerPage }));
+}
+export function applyPaginationEvent(model, state, event) {
+    const validState = createPaginationState(model, state.page, state.itemsPerPage);
+    if (!validState.ok)
+        return transitionFailure(validState);
+    if (!isPaginationEvent(event)) {
+        return fail('transition-rejection', 'invalid-pagination-event', 'Pagination event must select a page or request a page boundary movement.', { event });
+    }
+    if (typeof event === 'object' && event.type === 'set-items-per-page') {
+        const sizeError = validateSafeCeiling(event.itemsPerPage, 'itemsPerPage', 1);
+        if (sizeError !== null)
+            return { ok: false, error: { ...sizeError, class: 'transition-rejection' } };
+    }
+    const pageCount = derivePageCount(model.total, state.itemsPerPage);
+    const nextState = typeof event === 'object' && event.type === 'set-items-per-page'
+        ? createPaginationState(model, Math.min(derivePageCount(model.total, event.itemsPerPage), Math.floor(((state.page - 1) * state.itemsPerPage) / event.itemsPerPage) + 1), event.itemsPerPage)
+        : createPaginationState(model, typeof event === 'object' ? event.page
+            : event === 'first-page' ? 1
+                : event === 'last-page' ? pageCount
+                    : event === 'previous-page' ? Math.max(1, state.page - 1)
+                        : Math.min(pageCount, state.page + 1), state.itemsPerPage);
+    if (!nextState.ok)
+        return transitionFailure(nextState);
+    const commands = [];
+    if (nextState.value.itemsPerPage !== state.itemsPerPage) {
+        commands.push({ type: 'items-per-page-changed', itemsPerPage: nextState.value.itemsPerPage });
+    }
+    if (nextState.value.page !== state.page)
+        commands.push({ type: 'page-changed', page: nextState.value.page });
+    return createMachineUpdate(nextState.value, commands);
+}
+export function getPaginationPageCount(model, state) {
+    const validState = createPaginationState(model, state.page, state.itemsPerPage);
+    return validState.ok
+        ? ok(derivePageCount(model.total, validState.value.itemsPerPage))
+        : transitionFailure(validState);
+}
+export function getPaginationItems(model, state) {
+    const validState = createPaginationState(model, state.page, state.itemsPerPage);
+    if (!validState.ok)
+        return transitionFailure(validState);
+    const pageCount = derivePageCount(model.total, state.itemsPerPage);
+    const pages = getVisiblePages(state.page, pageCount, model.siblingCount, model.showEdges);
+    const items = [];
+    if (model.showControls) {
+        items.push(control('first-page', 1, state.page === 1), control('previous-page', Math.max(1, state.page - 1), state.page === 1));
+    }
+    for (const page of pages) {
+        items.push(typeof page === 'number'
+            ? Object.freeze({ type: 'page', page, selected: page === state.page })
+            : Object.freeze({ type: 'ellipsis', side: page }));
+    }
+    if (model.showControls) {
+        items.push(control('next-page', Math.min(pageCount, state.page + 1), state.page === pageCount), control('last-page', pageCount, state.page === pageCount));
+    }
+    return ok(Object.freeze(items));
+}
+export function getPaginationItemRange(model, state) {
+    const validState = createPaginationState(model, state.page, state.itemsPerPage);
+    if (!validState.ok)
+        return transitionFailure(validState);
+    if (model.total === 0)
+        return ok(Object.freeze({ start: 0, end: 0, total: 0 }));
+    const start = (state.page - 1) * state.itemsPerPage + 1;
+    const count = Math.min(state.itemsPerPage, model.total - start + 1);
+    return ok(Object.freeze({ start, end: start + count - 1, total: model.total }));
+}
+function getVisiblePages(currentPage, pageCount, siblingCount, showEdges) {
+    const leftSibling = Math.max(currentPage - siblingCount, 1);
+    const rightSibling = Math.min(currentPage + siblingCount, pageCount);
+    if (!showEdges) {
+        const itemCount = siblingCount * 2 + 1;
+        if (pageCount <= itemCount)
+            return range(1, pageCount);
+        if (currentPage <= siblingCount + 1)
+            return range(1, itemCount);
+        if (pageCount - currentPage <= siblingCount)
+            return range(pageCount - itemCount + 1, pageCount);
+        return range(leftSibling, rightSibling);
+    }
+    const totalPageNumbers = Math.min(siblingCount * 2 + 5, pageCount);
+    const interiorCount = totalPageNumbers - 2;
+    const showStartEllipsis = leftSibling > 3
+        && Math.abs(pageCount - interiorCount) > 2
+        && Math.abs(leftSibling - 1) > 2;
+    const showEndEllipsis = rightSibling < pageCount - 2
+        && Math.abs(pageCount - interiorCount) > 2
+        && Math.abs(pageCount - rightSibling) > 2;
+    if (!showStartEllipsis && showEndEllipsis) {
+        return [...range(1, interiorCount), 'end', pageCount];
+    }
+    if (showStartEllipsis && !showEndEllipsis) {
+        return [1, 'start', ...range(pageCount - interiorCount + 1, pageCount)];
+    }
+    if (showStartEllipsis && showEndEllipsis) {
+        return [1, 'start', ...range(leftSibling, rightSibling), 'end', pageCount];
+    }
+    return range(1, pageCount);
+}
+function range(start, end) {
+    return Array.from({ length: Math.max(0, end - start + 1) }, (_, index) => start + index);
+}
+function derivePageCount(total, itemsPerPage) {
+    return Math.max(1, Math.ceil(total / itemsPerPage));
+}
+function control(controlType, targetPage, disabled) {
+    return Object.freeze({ type: 'control', control: controlType, targetPage, disabled });
+}
+function validatePaginationModel(model) {
+    if (typeof model !== 'object' || model === null) {
+        return {
+            class: 'construction',
+            code: 'invalid-pagination-model',
+            message: 'Pagination model must be an object.',
+        };
+    }
+    if (!Number.isSafeInteger(model.total) || model.total < 0
+        || !Number.isSafeInteger(model.itemsPerPage) || model.itemsPerPage < 1
+        || !Number.isSafeInteger(model.siblingCount) || model.siblingCount < 0
+        || typeof model.showEdges !== 'boolean' || typeof model.showControls !== 'boolean') {
+        return {
+            class: 'construction',
+            code: 'invalid-pagination-model',
+            message: 'Pagination model fields must agree with a valid pagination domain.',
+        };
+    }
+    return null;
+}
+function isPaginationEvent(value) {
+    if (typeof value === 'string') {
+        return value === 'first-page' || value === 'previous-page'
+            || value === 'next-page' || value === 'last-page';
+    }
+    if (typeof value !== 'object' || value === null || !('type' in value))
+        return false;
+    return value.type === 'go-to-page'
+        ? 'page' in value && Number.isSafeInteger(value.page)
+        : value.type === 'set-items-per-page'
+            && 'itemsPerPage' in value && Number.isSafeInteger(value.itemsPerPage);
+}
+function transitionFailure(result) {
+    if (result.ok) {
+        return fail('internal-invariant', 'unexpected-pagination-success', 'Expected a pagination failure.');
+    }
+    return { ok: false, error: { ...result.error, class: 'transition-rejection' } };
+}
+//# sourceMappingURL=pagination.js.map

package/dist/pagination.js.map

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

package/dist/pin-input.d.ts

@@ -0,0 +1,29 @@
+import type { Result } from './shared.js';
+export interface PinInputState {
+    readonly values: readonly string[];
+    readonly current: number;
+}
+export type PinInputEvent = 'next' | 'previous' | 'backspace' | 'delete' | {
+    readonly type: 'focus';
+    readonly index: number;
+} | {
+    readonly type: 'input';
+    readonly value: string;
+};
+export type PinInputCommand = {
+    readonly type: 'focus-cell';
+    readonly index: number;
+} | {
+    readonly type: 'complete';
+    readonly value: string;
+};
+export interface PinInputPolicies {
+    readonly accept?: (value: string, index: number) => boolean;
+}
+export interface PinInputUpdate {
+    readonly state: PinInputState;
+    readonly commands: readonly PinInputCommand[];
+}
+export declare function createPinInputState(length: number, value?: string | readonly string[]): Result<PinInputState>;
+export declare function applyPinInputEvent(length: number, state: PinInputState, event: PinInputEvent, policies?: PinInputPolicies): Result<PinInputUpdate>;
+//# sourceMappingURL=pin-input.d.ts.map

package/dist/pin-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pin-input.d.ts","sourceRoot":"","sources":["../src/pin-input.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAI1C,MAAM,WAAW,aAAa;IAAG,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE;AAC/F,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,UAAU,GAAG,WAAW,GAAG,QAAQ,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AACnL,MAAM,MAAM,eAAe,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAC9I,MAAM,WAAW,gBAAgB;IAAG,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAA;CAAE;AACjG,MAAM,WAAW,cAAc;IAAG,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,SAAS,eAAe,EAAE,CAAA;CAAE;AAEhH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,GAAE,MAAM,GAAG,SAAS,MAAM,EAAO,GAAG,MAAM,CAAC,aAAa,CAAC,CAOjH;AACD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,EAAE,QAAQ,GAAE,gBAAqB,GAAG,MAAM,CAAC,cAAc,CAAC,CAWtJ"}

package/dist/pin-input.js

@@ -0,0 +1,49 @@
+import { fail, freezeArray, ok } from './internal/kernel/foundation.js';
+import { createMachineUpdate } from './internal/kernel/machine.js';
+export function createPinInputState(length, value = '') {
+    if (!Number.isSafeInteger(length) || length < 1)
+        return fail('construction', 'invalid-pin-input-length', 'Pin input length must be a positive safe integer.');
+    const source = typeof value === 'string' ? Array.from(value) : [...value];
+    if (source.length > length || source.some((part) => typeof part !== 'string' || Array.from(part).length > 1))
+        return fail('construction', 'invalid-pin-input-value', 'Pin input values must contain at most one character per cell.');
+    const values = Array.from({ length }, (_, index) => source[index] ?? '');
+    const current = Math.min(source.length, length - 1);
+    return ok(Object.freeze({ values: freezeArray(values), current }));
+}
+export function applyPinInputEvent(length, state, event, policies = {}) {
+    const valid = createPinInputState(length, state.values);
+    if (!valid.ok || state.current < 0 || state.current >= length)
+        return fail('transition-rejection', 'invalid-pin-input-state', 'Pin input state must match its declared length.');
+    const focus = (index) => createMachineUpdate(Object.freeze({ values: state.values, current: Math.max(0, Math.min(length - 1, index)) }), [{ type: 'focus-cell', index: Math.max(0, Math.min(length - 1, index)) }]);
+    if (event === 'next')
+        return focus(state.current + 1);
+    if (event === 'previous')
+        return focus(state.current - 1);
+    if (typeof event === 'object' && event.type === 'focus')
+        return Number.isSafeInteger(event.index) ? focus(event.index) : fail('transition-rejection', 'invalid-pin-input-index', 'Pin input focus index must be a safe integer.');
+    const values = [...state.values];
+    if (event === 'delete')
+        values[state.current] = '';
+    else if (event === 'backspace') {
+        if (values[state.current] === '' && state.current > 0) {
+            values[state.current - 1] = '';
+            return createMachineUpdate(Object.freeze({ values: freezeArray(values), current: state.current - 1 }), [{ type: 'focus-cell', index: state.current - 1 }]);
+        }
+        values[state.current] = '';
+    }
+    else if (typeof event === 'object' && event.type === 'input') {
+        const characters = Array.from(event.value);
+        if (characters.length !== 1 || policies.accept?.(event.value, state.current) === false)
+            return fail('transition-rejection', 'pin-input-value-rejected', 'Pin input accepts one permitted character at a time.');
+        values[state.current] = event.value;
+        const current = Math.min(length - 1, state.current + 1);
+        const commands = current === state.current ? [] : [{ type: 'focus-cell', index: current }];
+        if (values.every(Boolean))
+            commands.push({ type: 'complete', value: values.join('') });
+        return createMachineUpdate(Object.freeze({ values: freezeArray(values), current }), commands);
+    }
+    else
+        return fail('transition-rejection', 'invalid-pin-input-event', 'Pin input event is not recognized.');
+    return createMachineUpdate(Object.freeze({ values: freezeArray(values), current: state.current }));
+}
+//# sourceMappingURL=pin-input.js.map

package/dist/pin-input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pin-input.js","sourceRoot":"","sources":["../src/pin-input.ts"],"names":[],"mappings":"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"}

package/dist/quantity-field.d.ts

@@ -0,0 +1,58 @@
+import type { Result } from './shared.js';
+import { type DecimalRounding } from './internal/kernel/decimal.js';
+import { type NumberFieldEvent, type NumericExpressionEvaluator } from './number-field.js';
+import { type TextEditingState } from './text.js';
+import type { UnitExpression, UnitID, UnitRegistry, UnitSystemProfile } from './units.js';
+export interface QuantityValue {
+    readonly value: string;
+    readonly unit: UnitID;
+}
+export interface QuantityFieldState {
+    readonly quantity: QuantityValue | null;
+    readonly displayUnit: UnitID;
+    readonly inputState: TextEditingState;
+}
+export type QuantityFieldEvent = NumberFieldEvent | {
+    readonly type: 'set-display-unit';
+    readonly unit: UnitID;
+};
+export type QuantityFieldCommand = {
+    readonly type: 'input-state-changed';
+    readonly value: TextEditingState;
+} | {
+    readonly type: 'display-unit-changed';
+    readonly unit: UnitID;
+} | {
+    readonly type: 'quantity-committed';
+    readonly value: QuantityValue | null;
+    readonly expression: string;
+    readonly displayUnit: UnitID;
+};
+export interface QuantityFieldPolicies {
+    readonly registry: UnitRegistry;
+    readonly canonicalUnit: UnitID;
+    readonly unitSystem?: UnitSystemProfile;
+    readonly evaluator?: NumericExpressionEvaluator;
+    readonly precision?: number;
+    readonly rounding?: DecimalRounding;
+    readonly min?: string;
+    readonly max?: string;
+    readonly required?: boolean;
+}
+export interface QuantityInputParserOptions {
+    readonly registry: UnitRegistry;
+    readonly evaluator?: NumericExpressionEvaluator;
+}
+export interface ParsedQuantityInput {
+    readonly value: string | null;
+    readonly expression: string;
+    readonly unitExpression: UnitExpression | null;
+}
+export interface QuantityFieldUpdate {
+    readonly state: QuantityFieldState;
+    readonly commands: readonly QuantityFieldCommand[];
+}
+export declare function createQuantityFieldState(policies: QuantityFieldPolicies, quantity?: QuantityValue | null, displayUnit?: UnitID, inputState?: TextEditingState): Result<QuantityFieldState>;
+export declare function applyQuantityFieldEvent(state: QuantityFieldState, event: QuantityFieldEvent, policies: QuantityFieldPolicies): Result<QuantityFieldUpdate>;
+export declare function parseQuantityInput(input: string, options: QuantityInputParserOptions): Result<ParsedQuantityInput>;
+//# sourceMappingURL=quantity-field.d.ts.map

package/dist/quantity-field.d.ts.map

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

package/dist/quantity-field.js

@@ -0,0 +1,250 @@
+import { compareDecimal, parseDecimal } from './internal/kernel/decimal.js';
+import { fail, ok } from './internal/kernel/foundation.js';
+import { createMachineUpdate } from './internal/kernel/machine.js';
+import { applyNumberFieldEvent, createNumberFieldState, } from './number-field.js';
+import { createTextEditingState } from './text.js';
+export function createQuantityFieldState(policies, quantity = null, displayUnit, inputState) {
+    const validPolicies = validatePolicies(policies);
+    if (!validPolicies.ok)
+        return validPolicies;
+    const resolvedDisplayUnit = displayUnit
+        ?? policies.unitSystem?.getDefaultUnit(policies.canonicalUnit)
+        ?? policies.canonicalUnit;
+    const display = policies.registry.get(resolvedDisplayUnit);
+    if (display === null)
+        return fail('construction', 'unknown-display-unit', 'Quantity field display unit must be registered.', { displayUnit: resolvedDisplayUnit });
+    if (!policies.registry.compatible(policies.canonicalUnit, resolvedDisplayUnit)) {
+        return fail('construction', 'incompatible-display-unit', 'Quantity field display unit must match the canonical dimension.', { displayUnit: resolvedDisplayUnit, canonicalUnit: policies.canonicalUnit });
+    }
+    let normalizedQuantity = null;
+    if (quantity !== null) {
+        if (typeof quantity !== 'object' || typeof quantity.value !== 'string' || typeof quantity.unit !== 'string') {
+            return fail('construction', 'invalid-quantity-value', 'Quantity must contain decimal value text and a unit ID.');
+        }
+        const converted = policies.registry.convert(quantity.value, quantity.unit, policies.canonicalUnit, conversionOptions(policies));
+        if (!converted.ok)
+            return asConstruction(converted);
+        normalizedQuantity = Object.freeze({ value: converted.value.value, unit: policies.canonicalUnit });
+    }
+    let input = inputState;
+    if (input === undefined) {
+        const displayed = displayValue(normalizedQuantity, resolvedDisplayUnit, policies);
+        if (!displayed.ok)
+            return displayed;
+        const text = displayed.value ?? '';
+        const created = createTextEditingState(text, {
+            anchorCodeUnitOffset: text.length,
+            focusCodeUnitOffset: text.length,
+        });
+        if (!created.ok)
+            return created;
+        input = created.value;
+    }
+    const number = createNumberFieldState(null, input);
+    if (!number.ok)
+        return number;
+    return ok(Object.freeze({
+        quantity: normalizedQuantity,
+        displayUnit: resolvedDisplayUnit,
+        inputState: number.value.inputState,
+    }));
+}
+export function applyQuantityFieldEvent(state, event, policies) {
+    const valid = createQuantityFieldState(policies, state.quantity, state.displayUnit, state.inputState);
+    if (!valid.ok)
+        return { ok: false, error: { ...valid.error, class: 'transition-rejection' } };
+    const bounds = normalizeBounds(policies);
+    if (!bounds.ok)
+        return bounds;
+    if (typeof event === 'object' && event.type === 'set-display-unit') {
+        return changeDisplayUnit(valid.value, event.unit, policies);
+    }
+    if (event === 'commit')
+        return commitQuantityField(valid.value, policies, bounds.value);
+    const displayed = displayValue(valid.value.quantity, valid.value.displayUnit, policies);
+    if (!displayed.ok)
+        return displayed;
+    const numberState = createNumberFieldState(displayed.value, valid.value.inputState);
+    if (!numberState.ok)
+        return numberState;
+    const reduced = applyNumberFieldEvent(numberState.value, event, {
+        ...(policies.evaluator === undefined ? {} : { evaluator: policies.evaluator }),
+        ...(policies.required === undefined ? {} : { required: policies.required }),
+    });
+    if (!reduced.ok)
+        return reduced;
+    const next = Object.freeze({ ...valid.value, inputState: reduced.value.state.inputState });
+    const commands = reduced.value.commands
+        .filter((command) => command.type === 'input-state-changed')
+        .map((command) => ({ type: 'input-state-changed', value: command.value }));
+    return createMachineUpdate(next, commands);
+}
+export function parseQuantityInput(input, options) {
+    if (typeof input !== 'string')
+        return fail('transition-rejection', 'invalid-quantity-input', 'Quantity input must be text.');
+    const expression = input.trim();
+    if (expression.length === 0)
+        return ok(Object.freeze({ value: null, expression: input, unitExpression: null }));
+    const direct = evaluateQuantityExpression(expression, options.evaluator);
+    if (direct.ok)
+        return ok(Object.freeze({ value: direct.value, expression: input, unitExpression: null }));
+    for (let position = expression.length - 1; position > 0; position -= 1) {
+        const numeric = expression.slice(0, position).trimEnd();
+        const unitSource = expression.slice(position).trimStart();
+        if (numeric.length === 0 || unitSource.length === 0)
+            continue;
+        const unitExpression = options.registry.parse(unitSource);
+        if (!unitExpression.ok)
+            continue;
+        const value = evaluateQuantityExpression(numeric, options.evaluator);
+        if (!value.ok)
+            continue;
+        return ok(Object.freeze({ value: value.value, expression: input, unitExpression: unitExpression.value }));
+    }
+    return fail('transition-rejection', 'invalid-quantity-input', 'Quantity input must contain a valid number or expression followed by an optional unit expression.', { input });
+}
+function commitQuantityField(state, policies, bounds) {
+    if (state.inputState.composition !== null) {
+        return fail('transition-rejection', 'quantity-commit-during-composition', 'Quantity field cannot commit during active composition.');
+    }
+    const parsedInput = parseQuantityInput(state.inputState.snapshot.text, {
+        registry: policies.registry,
+        ...(policies.evaluator === undefined ? {} : { evaluator: policies.evaluator }),
+    });
+    if (!parsedInput.ok)
+        return parsedInput;
+    if (parsedInput.value.value === null) {
+        if (policies.required === true)
+            return fail('transition-rejection', 'required-quantity', 'Quantity field requires a value.');
+        const input = createTextEditingState('', { anchorCodeUnitOffset: 0, focusCodeUnitOffset: 0 });
+        if (!input.ok)
+            return input;
+        return createMachineUpdate(Object.freeze({ ...state, quantity: null, inputState: input.value }), [
+            { type: 'input-state-changed', value: input.value },
+            { type: 'quantity-committed', value: null, expression: parsedInput.value.expression, displayUnit: state.displayUnit },
+        ]);
+    }
+    const canonical = parsedInput.value.unitExpression === null
+        ? policies.registry.convert(parsedInput.value.value, state.displayUnit, policies.canonicalUnit, conversionOptions(policies))
+        : policies.registry.convertExpression(parsedInput.value.value, parsedInput.value.unitExpression, policies.canonicalUnit, conversionOptions(policies));
+    if (!canonical.ok)
+        return canonical;
+    const canonicalValue = canonical.value.value;
+    const parsedCanonical = parseDecimal(canonicalValue);
+    if (parsedCanonical === null)
+        return fail('internal-invariant', 'invalid-canonical-quantity', 'Unit registry returned invalid canonical decimal text.');
+    if (bounds.min !== null && compareDecimal(parsedCanonical, bounds.min) < 0) {
+        return fail('transition-rejection', 'quantity-below-minimum', 'Quantity is below its canonical minimum.', { value: canonicalValue, min: policies.min });
+    }
+    if (bounds.max !== null && compareDecimal(parsedCanonical, bounds.max) > 0) {
+        return fail('transition-rejection', 'quantity-above-maximum', 'Quantity is above its canonical maximum.', { value: canonicalValue, max: policies.max });
+    }
+    const requestedUnit = parsedInput.value.unitExpression?.resolvedUnit;
+    const displayUnit = requestedUnit !== null && requestedUnit !== undefined
+        && policies.registry.compatible(policies.canonicalUnit, requestedUnit)
+        ? requestedUnit
+        : state.displayUnit;
+    const display = policies.registry.convert(canonicalValue, policies.canonicalUnit, displayUnit, conversionOptions(policies));
+    if (!display.ok)
+        return display;
+    const input = createTextEditingState(display.value.value, {
+        anchorCodeUnitOffset: display.value.value.length,
+        focusCodeUnitOffset: display.value.value.length,
+    });
+    if (!input.ok)
+        return input;
+    const quantity = Object.freeze({ value: canonicalValue, unit: policies.canonicalUnit });
+    return createMachineUpdate(Object.freeze({ quantity, displayUnit, inputState: input.value }), [
+        { type: 'input-state-changed', value: input.value },
+        ...(displayUnit === state.displayUnit ? [] : [{ type: 'display-unit-changed', unit: displayUnit }]),
+        { type: 'quantity-committed', value: quantity, expression: parsedInput.value.expression, displayUnit },
+    ]);
+}
+function evaluateQuantityExpression(expression, evaluator) {
+    const input = createTextEditingState(expression, {
+        anchorCodeUnitOffset: expression.length,
+        focusCodeUnitOffset: expression.length,
+    });
+    if (!input.ok)
+        return input;
+    const state = createNumberFieldState(null, input.value);
+    if (!state.ok)
+        return state;
+    const committed = applyNumberFieldEvent(state.value, 'commit', {
+        ...(evaluator === undefined ? {} : { evaluator }),
+    });
+    if (!committed.ok)
+        return committed;
+    const command = committed.value.commands.find((candidate) => candidate.type === 'value-committed');
+    return command === undefined
+        ? fail('internal-invariant', 'missing-quantity-expression-result', 'Number field commit must produce a value command.')
+        : ok(command.value);
+}
+function changeDisplayUnit(state, displayUnit, policies) {
+    if (policies.registry.get(displayUnit) === null) {
+        return fail('transition-rejection', 'unknown-display-unit', 'Quantity field display unit must be registered.', { displayUnit });
+    }
+    if (!policies.registry.compatible(policies.canonicalUnit, displayUnit)) {
+        return fail('transition-rejection', 'incompatible-display-unit', 'Quantity field display unit must match the canonical dimension.', { displayUnit });
+    }
+    if (displayUnit === state.displayUnit)
+        return createMachineUpdate(state);
+    const displayed = displayValue(state.quantity, displayUnit, policies);
+    if (!displayed.ok)
+        return displayed;
+    const text = displayed.value ?? '';
+    const input = createTextEditingState(text, {
+        anchorCodeUnitOffset: text.length,
+        focusCodeUnitOffset: text.length,
+    });
+    if (!input.ok)
+        return input;
+    return createMachineUpdate(Object.freeze({ ...state, displayUnit, inputState: input.value }), [
+        { type: 'input-state-changed', value: input.value },
+        { type: 'display-unit-changed', unit: displayUnit },
+    ]);
+}
+function displayValue(quantity, displayUnit, policies) {
+    if (quantity === null)
+        return ok(null);
+    const converted = policies.registry.convert(quantity.value, quantity.unit, displayUnit, conversionOptions(policies));
+    return converted.ok ? ok(converted.value.value) : converted;
+}
+function validatePolicies(policies) {
+    if (typeof policies !== 'object' || policies === null
+        || typeof policies.registry !== 'object' || policies.registry === null
+        || typeof policies.registry.get !== 'function'
+        || typeof policies.registry.compatible !== 'function'
+        || typeof policies.registry.convert !== 'function') {
+        return fail('construction', 'invalid-unit-registry', 'Quantity field requires a unit registry.');
+    }
+    if (typeof policies.canonicalUnit !== 'string' || policies.registry.get(policies.canonicalUnit) === null) {
+        return fail('construction', 'unknown-canonical-unit', 'Quantity field canonical unit must be registered.', { canonicalUnit: policies.canonicalUnit });
+    }
+    if (policies.unitSystem !== undefined && (typeof policies.unitSystem !== 'object' || policies.unitSystem === null
+        || typeof policies.unitSystem.getDefaultUnit !== 'function' || typeof policies.unitSystem.getUnits !== 'function')) {
+        return fail('construction', 'invalid-unit-system', 'Quantity field unit system must provide default and compatible display units.');
+    }
+    return ok(true);
+}
+function normalizeBounds(policies) {
+    const min = policies.min === undefined ? null : parseDecimal(policies.min);
+    const max = policies.max === undefined ? null : parseDecimal(policies.max);
+    if (policies.min !== undefined && min === null)
+        return fail('construction', 'invalid-quantity-minimum', 'Quantity minimum must be canonical decimal text.');
+    if (policies.max !== undefined && max === null)
+        return fail('construction', 'invalid-quantity-maximum', 'Quantity maximum must be canonical decimal text.');
+    if (min !== null && max !== null && compareDecimal(min, max) > 0)
+        return fail('construction', 'inverted-quantity-bounds', 'Quantity minimum must not exceed its maximum.');
+    return ok(Object.freeze({ min, max }));
+}
+function conversionOptions(policies) {
+    return Object.freeze({
+        ...(policies.precision === undefined ? {} : { precision: policies.precision }),
+        ...(policies.rounding === undefined ? {} : { rounding: policies.rounding }),
+    });
+}
+function asConstruction(result) {
+    return result.ok ? result : { ok: false, error: { ...result.error, class: 'construction' } };
+}
+//# sourceMappingURL=quantity-field.js.map