@sectile/core 0.2.0 → 0.2.1

package/dist/multi-thumb-slider.js

@@ -0,0 +1,72 @@
+import { unwrap } from './result.js';
+import { fail, ok } from './internal/kernel/foundation.js';
+import { createMachineUpdate } from './internal/kernel/machine.js';
+import { createCursorState } from './internal/state/cursor.js';
+export function createMultiThumbSliderState(thumbs, range, ticks, current = null, policies = {}) {
+    return unwrap(tryCreateMultiThumbSliderState(thumbs, range, ticks, current, policies));
+}
+export function tryCreateMultiThumbSliderState(thumbs, range, ticks, current = null, policies = {}) {
+    if (ticks.length !== thumbs.size)
+        return fail('construction', 'thumb-value-count-mismatch', 'Every thumb requires one tick.');
+    if (current !== null && !thumbs.contains(current))
+        return fail('construction', 'multi-thumb-cursor-outside-domain', 'Active thumb must exist.');
+    const gap = policies.minGap ?? 0;
+    if (!Number.isSafeInteger(gap) || gap < 0)
+        return fail('construction', 'invalid-thumb-gap', 'minGap must be a non-negative safe integer.');
+    for (let index = 0; index < ticks.length; index += 1) {
+        const tick = ticks[index];
+        if (tick === undefined || !Number.isSafeInteger(tick) || tick < 0 || tick > range.count)
+            return fail('construction', 'thumb-tick-outside-range', 'Every thumb tick must be inside the range.');
+        if (!policies.allowCross && index > 0 && ticks[index - 1] + gap > tick)
+            return fail('construction', 'thumb-order-violation', 'Thumb ticks must preserve order and minimum gap.');
+    }
+    return ok(Object.freeze({ cursor: createCursorState(current), ticks: Object.freeze([...ticks]) }));
+}
+export function applyMultiThumbSliderEvent(thumbs, range, state, event, policies = {}) {
+    const valid = tryCreateMultiThumbSliderState(thumbs, range, state.ticks, state.cursor.current, policies);
+    if (!valid.ok)
+        return { ok: false, error: { ...valid.error, class: 'transition-rejection' } };
+    if (event === 'next-thumb' || event === 'previous-thumb') {
+        if (thumbs.size === 0)
+            return createMachineUpdate(state);
+        const current = state.cursor.current;
+        let id;
+        if (current === null)
+            id = thumbs.at(event === 'next-thumb' ? 0 : thumbs.size - 1);
+        else {
+            const target = thumbs.move(current, event === 'next-thumb' ? 1 : -1, 'wrap');
+            id = target.kind === 'found' ? target.id : null;
+        }
+        if (id === null)
+            return createMachineUpdate(state);
+        return createMachineUpdate(Object.freeze({ cursor: createCursorState(id), ticks: state.ticks }), [{ type: 'focus', id }]);
+    }
+    const id = typeof event === 'object' ? event.id : state.cursor.current;
+    if (id === null)
+        return fail('transition-rejection', 'no-cursor', 'Multi-thumb change requires an active thumb.');
+    const index = thumbs.indexOf(id);
+    if (index === null)
+        return fail('transition-rejection', 'multi-thumb-target-unavailable', 'Thumb target must exist.');
+    if (typeof event === 'object' && event.type === 'focus')
+        return createMachineUpdate(Object.freeze({ cursor: createCursorState(id), ticks: state.ticks }), [{ type: 'focus', id }]);
+    const current = state.ticks[index];
+    let tick = typeof event === 'object' ? event.tick : event === 'increment' ? current + 1 : event === 'decrement' ? current - 1 : event === 'home' ? 0 : range.count;
+    tick = Math.max(0, Math.min(range.count, tick));
+    if (!policies.allowCross) {
+        const gap = policies.minGap ?? 0;
+        const lower = index === 0 ? 0 : state.ticks[index - 1] + gap;
+        const upper = index === state.ticks.length - 1 ? range.count : state.ticks[index + 1] - gap;
+        tick = Math.max(lower, Math.min(upper, tick));
+    }
+    if (!Number.isSafeInteger(tick))
+        return fail('transition-rejection', 'thumb-tick-outside-range', 'Thumb tick must be a safe range tick.');
+    const ticks = [...state.ticks];
+    ticks[index] = tick;
+    const commands = [];
+    if (state.cursor.current !== id)
+        commands.push({ type: 'focus', id });
+    if (current !== tick)
+        commands.push({ type: 'announce-tick', id, tick });
+    return createMachineUpdate(Object.freeze({ cursor: createCursorState(id), ticks: Object.freeze(ticks) }), commands);
+}
+//# sourceMappingURL=multi-thumb-slider.js.map

package/dist/multi-thumb-slider.js.map

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

package/dist/navigation-menu.d.ts

@@ -0,0 +1,6 @@
+export { applyMenuEvent as applyNavigationMenuEvent, createMenuState as createNavigationMenuState, type MenuCommand as NavigationMenuCommand, type MenuEvent as NavigationMenuEvent, type MenuPolicies as NavigationMenuPolicies, type MenuState as NavigationMenuState, type MenuUpdate as NavigationMenuUpdate, } from './internal/composites/menu.js';
+export { createMenuModel as createNavigationMenuModel, type MenuModel as NavigationMenuModel, } from './menu.js';
+export type { TreeNodeInput as NavigationMenuItemDefinition } from './structures/tree.js';
+export { tryCreateMenuModel as tryCreateNavigationMenuModel } from './menu.js';
+export { tryCreateMenuState as tryCreateNavigationMenuState } from './internal/composites/menu.js';
+//# sourceMappingURL=navigation-menu.d.ts.map

package/dist/navigation-menu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation-menu.d.ts","sourceRoot":"","sources":["../src/navigation-menu.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,IAAI,wBAAwB,EAC1C,eAAe,IAAI,yBAAyB,EAC5C,KAAK,WAAW,IAAI,qBAAqB,EACzC,KAAK,SAAS,IAAI,mBAAmB,EACrC,KAAK,YAAY,IAAI,sBAAsB,EAC3C,KAAK,SAAS,IAAI,mBAAmB,EACrC,KAAK,UAAU,IAAI,oBAAoB,GACxC,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,eAAe,IAAI,yBAAyB,EAC5C,KAAK,SAAS,IAAI,mBAAmB,GACtC,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,aAAa,IAAI,4BAA4B,EAAE,MAAM,sBAAsB,CAAC;AAE1F,OAAO,EAAE,kBAAkB,IAAI,4BAA4B,EAAE,MAAM,WAAW,CAAC;AAC/E,OAAO,EAAE,kBAAkB,IAAI,4BAA4B,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/navigation-menu.js

@@ -0,0 +1,5 @@
+export { applyMenuEvent as applyNavigationMenuEvent, createMenuState as createNavigationMenuState, } from './internal/composites/menu.js';
+export { createMenuModel as createNavigationMenuModel, } from './menu.js';
+export { tryCreateMenuModel as tryCreateNavigationMenuModel } from './menu.js';
+export { tryCreateMenuState as tryCreateNavigationMenuState } from './internal/composites/menu.js';
+//# sourceMappingURL=navigation-menu.js.map

package/dist/navigation-menu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation-menu.js","sourceRoot":"","sources":["../src/navigation-menu.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,IAAI,wBAAwB,EAC1C,eAAe,IAAI,yBAAyB,GAM7C,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,eAAe,IAAI,yBAAyB,GAE7C,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,kBAAkB,IAAI,4BAA4B,EAAE,MAAM,WAAW,CAAC;AAC/E,OAAO,EAAE,kBAAkB,IAAI,4BAA4B,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/number-field.d.ts

@@ -0,0 +1,51 @@
+import type { Result } from './shared.js';
+import { type DecimalRounding } from './internal/kernel/decimal.js';
+import { type TextEditingState, type TextEvent } from './text.js';
+export interface NumericExpressionResult {
+    readonly expression: string;
+    readonly value: string;
+}
+export interface NumericExpressionEvaluator {
+    evaluate(expression: string): Result<NumericExpressionResult>;
+}
+export interface CalculatorExpressionOptions {
+    readonly precision?: number;
+    readonly rounding?: DecimalRounding;
+    readonly maxCodeUnits?: number;
+    readonly maxTokens?: number;
+    readonly maxDepth?: number;
+    readonly maxOperations?: number;
+    readonly maxExponent?: number;
+}
+export interface NumberFieldState {
+    readonly value: string | null;
+    readonly inputState: TextEditingState;
+}
+export type NumberFieldEvent = {
+    readonly type: 'text';
+    readonly event: TextEvent;
+} | 'commit' | 'cancel';
+export type NumberFieldCommand = {
+    readonly type: 'input-state-changed';
+    readonly value: TextEditingState;
+} | {
+    readonly type: 'value-committed';
+    readonly value: string | null;
+    readonly expression: string;
+};
+export interface NumberFieldPolicies {
+    readonly evaluator?: NumericExpressionEvaluator;
+    readonly min?: string;
+    readonly max?: string;
+    readonly required?: boolean;
+}
+export interface NumberFieldUpdate {
+    readonly state: NumberFieldState;
+    readonly commands: readonly NumberFieldCommand[];
+}
+export declare function createCalculatorExpression(options?: CalculatorExpressionOptions): NumericExpressionEvaluator;
+export declare function tryCreateCalculatorExpression(options?: CalculatorExpressionOptions): Result<NumericExpressionEvaluator>;
+export declare function createNumberFieldState(value?: string | null, inputState?: TextEditingState): NumberFieldState;
+export declare function tryCreateNumberFieldState(value?: string | null, inputState?: TextEditingState): Result<NumberFieldState>;
+export declare function applyNumberFieldEvent(state: NumberFieldState, event: NumberFieldEvent, policies?: NumberFieldPolicies): Result<NumberFieldUpdate>;
+//# sourceMappingURL=number-field.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"number-field.d.ts","sourceRoot":"","sources":["../src/number-field.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EASL,KAAK,eAAe,EAErB,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EAIL,KAAK,gBAAgB,EACrB,KAAK,SAAS,EAEf,MAAM,WAAW,CAAC;AAEnB,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC,uBAAuB,CAAC,CAAC;CAC/D;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,eAAe,CAAC;IACpC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAC;CACvC;AAED,MAAM,MAAM,gBAAgB,GACxB;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAA;CAAE,GACpD,QAAQ,GACR,QAAQ,CAAC;AAEb,MAAM,MAAM,kBAAkB,GAC1B;IAAE,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAA;CAAE,GAC1E;IAAE,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC;AAErG,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,SAAS,CAAC,EAAE,0BAA0B,CAAC;IAChD,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,SAAS,kBAAkB,EAAE,CAAC;CAClD;AAyBD,wBAAgB,0BAA0B,CACxC,OAAO,GAAE,2BAAgC,GACxC,0BAA0B,CAE5B;AAED,wBAAgB,6BAA6B,CAC3C,OAAO,GAAE,2BAAgC,GACxC,MAAM,CAAC,0BAA0B,CAAC,CAQpC;AAED,wBAAgB,sBAAsB,CACpC,KAAK,GAAE,MAAM,GAAG,IAAW,EAC3B,UAAU,CAAC,EAAE,gBAAgB,GAC5B,gBAAgB,CAElB;AAED,wBAAgB,yBAAyB,CACvC,KAAK,GAAE,MAAM,GAAG,IAAW,EAC3B,UAAU,CAAC,EAAE,gBAAgB,GAC5B,MAAM,CAAC,gBAAgB,CAAC,CAiB1B;AAED,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,gBAAgB,EACvB,KAAK,EAAE,gBAAgB,EACvB,QAAQ,GAAE,mBAAwB,GACjC,MAAM,CAAC,iBAAiB,CAAC,CAoE3B"}

package/dist/number-field.js

@@ -0,0 +1,461 @@
+import { unwrap } from './result.js';
+import { addDecimal, compareDecimal, decimalToString, divideDecimal, multiplyDecimal, negateDecimal, parseDecimal, subtractDecimal, } from './internal/kernel/decimal.js';
+import { fail, ok, validateSafeCeiling } from './internal/kernel/foundation.js';
+import { createMachineUpdate } from './internal/kernel/machine.js';
+import { applyTextEvent, createTextEditingState, normalizeTextEditingState, tryCreateTextEditingState, } from './text.js';
+export function createCalculatorExpression(options = {}) {
+    return unwrap(tryCreateCalculatorExpression(options));
+}
+export function tryCreateCalculatorExpression(options = {}) {
+    const limits = normalizeCalculatorLimits(options);
+    if (!limits.ok)
+        return limits;
+    return ok(Object.freeze({
+        evaluate(expression) {
+            return evaluateCalculator(expression, limits.value);
+        },
+    }));
+}
+export function createNumberFieldState(value = null, inputState) {
+    return unwrap(tryCreateNumberFieldState(value, inputState));
+}
+export function tryCreateNumberFieldState(value = null, inputState) {
+    if (value !== null && typeof value !== 'string') {
+        return fail('construction', 'invalid-number-field-value', 'Number field value must be decimal text or null.');
+    }
+    const parsed = value === null ? null : parseDecimal(value);
+    if (value !== null && parsed === null) {
+        return fail('construction', 'invalid-number-field-value', 'Number field value must be finite decimal text.', { value });
+    }
+    const canonicalValue = parsed === null ? null : decimalToString(parsed);
+    const input = inputState === undefined
+        ? createCommittedInput(canonicalValue)
+        : normalizeTextEditingState(inputState);
+    if (!input.ok)
+        return input;
+    return ok(Object.freeze({
+        value: canonicalValue,
+        inputState: input.value,
+    }));
+}
+export function applyNumberFieldEvent(state, event, policies = {}) {
+    const valid = tryCreateNumberFieldState(state.value, 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') {
+        if (event.type !== 'text' || typeof event.event !== 'object' || event.event === null) {
+            return fail('transition-rejection', 'invalid-number-field-text-event', 'Number field input must be a semantic text event.');
+        }
+        const edited = applyTextEvent(valid.value.inputState, event.event);
+        if (!edited.ok)
+            return edited;
+        return createMachineUpdate(Object.freeze({ value: valid.value.value, inputState: edited.value.state }), [{ type: 'input-state-changed', value: edited.value.state }]);
+    }
+    if (event === 'cancel') {
+        const restored = createCommittedInput(valid.value.value);
+        if (!restored.ok)
+            return restored;
+        if (sameTextState(restored.value, valid.value.inputState))
+            return createMachineUpdate(valid.value);
+        return createMachineUpdate(Object.freeze({ value: valid.value.value, inputState: restored.value }), [{ type: 'input-state-changed', value: restored.value }]);
+    }
+    if (event !== 'commit') {
+        return fail('transition-rejection', 'unsupported-number-field-event', 'Number field event is unsupported.');
+    }
+    if (valid.value.inputState.composition !== null) {
+        return fail('transition-rejection', 'number-field-composition-active', 'Number field cannot commit while text composition is active.');
+    }
+    const expression = valid.value.inputState.snapshot.text.trim();
+    if (expression.length === 0) {
+        if (policies.required === true) {
+            return fail('transition-rejection', 'number-field-value-required', 'Number field requires a value.');
+        }
+        const input = createCommittedInput(null);
+        if (!input.ok)
+            return input;
+        return createMachineUpdate(Object.freeze({ value: null, inputState: input.value }), [
+            { type: 'input-state-changed', value: input.value },
+            { type: 'value-committed', value: null, expression },
+        ]);
+    }
+    const evaluated = safelyEvaluate(policies.evaluator ?? literalEvaluator, expression);
+    if (!evaluated.ok)
+        return evaluated;
+    const parsed = parseDecimal(evaluated.value.value);
+    if (parsed === null) {
+        return fail('transition-rejection', 'invalid-number-field-evaluation', 'Number evaluator must return finite decimal text.');
+    }
+    if (bounds.value.min !== null && compareDecimal(parsed, bounds.value.min) < 0) {
+        return fail('transition-rejection', 'number-field-value-below-minimum', 'Number field value is below its minimum.', { value: evaluated.value.value, min: policies.min });
+    }
+    if (bounds.value.max !== null && compareDecimal(parsed, bounds.value.max) > 0) {
+        return fail('transition-rejection', 'number-field-value-above-maximum', 'Number field value is above its maximum.', { value: evaluated.value.value, max: policies.max });
+    }
+    const value = decimalToString(parsed);
+    const input = createCommittedInput(value);
+    if (!input.ok)
+        return input;
+    return createMachineUpdate(Object.freeze({ value, inputState: input.value }), [
+        { type: 'input-state-changed', value: input.value },
+        { type: 'value-committed', value, expression: evaluated.value.expression },
+    ]);
+}
+function createCommittedInput(value) {
+    const text = value ?? '';
+    return tryCreateTextEditingState(text, {
+        anchorCodeUnitOffset: text.length,
+        focusCodeUnitOffset: text.length,
+    });
+}
+function sameTextState(left, right) {
+    return JSON.stringify(left) === JSON.stringify(right);
+}
+const literalEvaluator = Object.freeze({
+    evaluate(expression) {
+        const value = parseDecimal(expression);
+        return value === null
+            ? fail('transition-rejection', 'invalid-number-literal', 'Number field draft must be a finite decimal literal.', { expression })
+            : ok(Object.freeze({ expression, value: decimalToString(value) }));
+    },
+});
+function safelyEvaluate(evaluator, expression) {
+    if (typeof evaluator !== 'object' || evaluator === null || typeof evaluator.evaluate !== 'function') {
+        return fail('construction', 'invalid-number-evaluator', 'Number field evaluator must expose evaluate(expression).');
+    }
+    try {
+        return evaluator.evaluate(expression);
+    }
+    catch (error) {
+        return fail('transition-rejection', 'number-evaluator-threw', 'Number field evaluator threw while evaluating its draft.', { cause: error instanceof Error ? error.message : String(error) });
+    }
+}
+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-number-field-minimum', 'Number field minimum must be finite decimal text.');
+    if (policies.max !== undefined && max === null)
+        return fail('construction', 'invalid-number-field-maximum', 'Number field maximum must be finite decimal text.');
+    if (min !== null && max !== null && compareDecimal(min, max) > 0)
+        return fail('construction', 'inverted-number-field-bounds', 'Number field minimum must not exceed its maximum.');
+    return ok(Object.freeze({ min, max }));
+}
+function normalizeCalculatorLimits(options) {
+    const values = {
+        precision: options.precision ?? 12,
+        maxCodeUnits: options.maxCodeUnits ?? 1_024,
+        maxTokens: options.maxTokens ?? 256,
+        maxDepth: options.maxDepth ?? 32,
+        maxOperations: options.maxOperations ?? 256,
+        maxExponent: options.maxExponent ?? 1_000,
+    };
+    for (const [name, value, minimum] of [
+        ['precision', values.precision, 0],
+        ['maxCodeUnits', values.maxCodeUnits, 1],
+        ['maxTokens', values.maxTokens, 1],
+        ['maxDepth', values.maxDepth, 1],
+        ['maxOperations', values.maxOperations, 1],
+        ['maxExponent', values.maxExponent, 0],
+    ]) {
+        const error = validateSafeCeiling(value, name, minimum);
+        if (error !== null)
+            return { ok: false, error };
+    }
+    const rounding = options.rounding ?? 'half-even';
+    if (rounding !== 'half-even' && rounding !== 'half-up' && rounding !== 'toward-zero') {
+        return fail('construction', 'invalid-decimal-rounding', 'Calculator rounding must be half-even, half-up, or toward-zero.');
+    }
+    return ok(Object.freeze({ ...values, rounding }));
+}
+function evaluateCalculator(expression, limits) {
+    if (typeof expression !== 'string') {
+        return fail('transition-rejection', 'invalid-calculator-expression', 'Calculator expression must be text.');
+    }
+    if (expression.length === 0) {
+        return fail('transition-rejection', 'empty-calculator-expression', 'Calculator expression must not be empty.');
+    }
+    if (expression.length > limits.maxCodeUnits) {
+        return fail('resource-rejection', 'calculator-code-unit-ceiling-exceeded', 'Calculator expression exceeds maxCodeUnits.', { codeUnits: expression.length, maxCodeUnits: limits.maxCodeUnits });
+    }
+    const tokens = tokenize(expression, limits.maxTokens);
+    if (!tokens.ok)
+        return tokens;
+    const parser = new ExpressionParser(tokens.value, limits);
+    const parsed = parser.parse();
+    if (!parsed.ok)
+        return parsed;
+    const evaluated = evaluateNode(parsed.value, limits, { operations: 0 });
+    if (!evaluated.ok)
+        return evaluated;
+    const value = decimalToString(evaluated.value);
+    if (value.length > limits.maxCodeUnits) {
+        return fail('resource-rejection', 'calculator-result-ceiling-exceeded', 'Calculator result exceeds maxCodeUnits.', { codeUnits: value.length, maxCodeUnits: limits.maxCodeUnits });
+    }
+    return ok(Object.freeze({ expression, value }));
+}
+function tokenize(expression, maxTokens) {
+    const tokens = [];
+    let offset = 0;
+    while (offset < expression.length) {
+        const character = expression[offset] ?? '';
+        if (/\s/u.test(character)) {
+            offset += 1;
+            continue;
+        }
+        if (/\d|\./u.test(character)) {
+            const start = offset;
+            let dots = 0;
+            while (offset < expression.length && /\d|\./u.test(expression[offset] ?? '')) {
+                if (expression[offset] === '.')
+                    dots += 1;
+                offset += 1;
+            }
+            const text = expression.slice(start, offset);
+            if (dots > 1 || parseDecimal(text) === null) {
+                return fail('transition-rejection', 'invalid-calculator-number', 'Calculator expression contains an invalid number.', { text, offset: start });
+            }
+            tokens.push(Object.freeze({ type: 'number', text, offset: start }));
+        }
+        else if ('+-*/^'.includes(character) || character === '×' || character === '÷' || character === '−') {
+            const operator = character === '×' ? '*' : character === '÷' ? '/' : character === '−' ? '-' : character;
+            tokens.push(Object.freeze({ type: 'operator', operator, offset }));
+            offset += 1;
+        }
+        else if (character === '%') {
+            tokens.push(Object.freeze({ type: 'percent', offset }));
+            offset += 1;
+        }
+        else if (character === '(') {
+            tokens.push(Object.freeze({ type: 'left', offset }));
+            offset += 1;
+        }
+        else if (character === ')') {
+            tokens.push(Object.freeze({ type: 'right', offset }));
+            offset += 1;
+        }
+        else
+            return fail('transition-rejection', 'unsupported-calculator-token', 'Calculator expression contains an unsupported token.', { character, offset });
+        if (tokens.length > maxTokens)
+            return fail('resource-rejection', 'calculator-token-ceiling-exceeded', 'Calculator expression exceeds maxTokens.', { maxTokens });
+    }
+    tokens.push(Object.freeze({ type: 'end', offset }));
+    return ok(Object.freeze(tokens));
+}
+class ExpressionParser {
+    #tokens;
+    #limits;
+    #index = 0;
+    #depth = 0;
+    #operations = 0;
+    constructor(tokens, limits) {
+        this.#tokens = tokens;
+        this.#limits = limits;
+    }
+    parse() {
+        const expression = this.#parseAdditive();
+        if (!expression.ok)
+            return expression;
+        const token = this.#current();
+        return token.type === 'end'
+            ? expression
+            : fail('transition-rejection', 'unexpected-calculator-token', 'Calculator expression has an unexpected trailing token.', { offset: token.offset });
+    }
+    #parseAdditive() {
+        let left = this.#parseMultiplicative();
+        if (!left.ok)
+            return left;
+        while (this.#operator('+') || this.#operator('-')) {
+            const operator = this.#take().operator;
+            const right = this.#parseMultiplicative();
+            if (!right.ok)
+                return right;
+            const combined = this.#binary(operator, left.value, right.value);
+            if (!combined.ok)
+                return combined;
+            left = combined;
+        }
+        return left;
+    }
+    #parseMultiplicative() {
+        let left = this.#parseUnary();
+        if (!left.ok)
+            return left;
+        while (this.#operator('*') || this.#operator('/')) {
+            const operator = this.#take().operator;
+            const right = this.#parseUnary();
+            if (!right.ok)
+                return right;
+            const combined = this.#binary(operator, left.value, right.value);
+            if (!combined.ok)
+                return combined;
+            left = combined;
+        }
+        return left;
+    }
+    #parseUnary() {
+        if (this.#operator('+') || this.#operator('-')) {
+            const operator = this.#take().operator;
+            const operand = this.#parseUnary();
+            if (!operand.ok)
+                return operand;
+            const operation = this.#countOperation();
+            return operation.ok ? ok(Object.freeze({ type: 'unary', operator, operand: operand.value })) : operation;
+        }
+        return this.#parsePower();
+    }
+    #parsePower() {
+        const left = this.#parsePostfix();
+        if (!left.ok || !this.#operator('^'))
+            return left;
+        this.#take();
+        const right = this.#parseUnary();
+        if (!right.ok)
+            return right;
+        return this.#binary('^', left.value, right.value);
+    }
+    #parsePostfix() {
+        const primary = this.#parsePrimary();
+        if (!primary.ok)
+            return primary;
+        let operand = primary.value;
+        while (this.#current().type === 'percent') {
+            this.#take();
+            const operation = this.#countOperation();
+            if (!operation.ok)
+                return operation;
+            operand = Object.freeze({ type: 'percent', operand });
+        }
+        return ok(operand);
+    }
+    #parsePrimary() {
+        const token = this.#current();
+        if (token.type === 'number') {
+            this.#take();
+            return ok(Object.freeze({ type: 'number', value: parseDecimal(token.text) }));
+        }
+        if (token.type !== 'left') {
+            return fail('transition-rejection', 'calculator-operand-expected', 'Calculator expression requires a number or parenthesized expression.', { offset: token.offset });
+        }
+        this.#take();
+        this.#depth += 1;
+        if (this.#depth > this.#limits.maxDepth) {
+            return fail('resource-rejection', 'calculator-depth-ceiling-exceeded', 'Calculator expression exceeds maxDepth.', { maxDepth: this.#limits.maxDepth });
+        }
+        const expression = this.#parseAdditive();
+        this.#depth -= 1;
+        if (!expression.ok)
+            return expression;
+        const closing = this.#current();
+        if (closing.type !== 'right') {
+            return fail('transition-rejection', 'calculator-closing-parenthesis-expected', 'Calculator expression is missing a closing parenthesis.', { offset: closing.offset });
+        }
+        this.#take();
+        return expression;
+    }
+    #binary(operator, left, right) {
+        const operation = this.#countOperation();
+        return operation.ok ? ok(Object.freeze({ type: 'binary', operator, left, right })) : operation;
+    }
+    #countOperation() {
+        this.#operations += 1;
+        return this.#operations > this.#limits.maxOperations
+            ? fail('resource-rejection', 'calculator-operation-ceiling-exceeded', 'Calculator expression exceeds maxOperations.', { maxOperations: this.#limits.maxOperations })
+            : ok(true);
+    }
+    #operator(operator) {
+        const token = this.#current();
+        return token.type === 'operator' && token.operator === operator;
+    }
+    #current() { return this.#tokens[this.#index]; }
+    #take() { const token = this.#current(); this.#index += 1; return token; }
+}
+function evaluateNode(node, limits, budget) {
+    if (node.type === 'number')
+        return ok(node.value);
+    budget.operations += 1;
+    if (budget.operations > limits.maxOperations) {
+        return fail('resource-rejection', 'calculator-operation-ceiling-exceeded', 'Calculator evaluation exceeds maxOperations.', { maxOperations: limits.maxOperations });
+    }
+    if (node.type === 'unary') {
+        const operand = evaluateNode(node.operand, limits, budget);
+        return operand.ok ? ok(node.operator === '-' ? negateDecimal(operand.value) : operand.value) : operand;
+    }
+    if (node.type === 'percent') {
+        const operand = evaluateNode(node.operand, limits, budget);
+        if (!operand.ok)
+            return operand;
+        return divide(operand.value, { coefficient: 100n, scale: 0 }, limits);
+    }
+    const left = evaluateNode(node.left, limits, budget);
+    if (!left.ok)
+        return left;
+    if ((node.operator === '+' || node.operator === '-') && node.right.type === 'percent') {
+        const percentage = evaluateNode(node.right.operand, limits, budget);
+        if (!percentage.ok)
+            return percentage;
+        const ratio = divide(percentage.value, { coefficient: 100n, scale: 0 }, limits);
+        if (!ratio.ok)
+            return ratio;
+        const delta = multiplyDecimal(left.value, ratio.value);
+        return checkedDecimal(node.operator === '+' ? addDecimal(left.value, delta) : subtractDecimal(left.value, delta), limits);
+    }
+    const right = evaluateNode(node.right, limits, budget);
+    if (!right.ok)
+        return right;
+    if (node.operator === '+')
+        return checkedDecimal(addDecimal(left.value, right.value), limits);
+    if (node.operator === '-')
+        return checkedDecimal(subtractDecimal(left.value, right.value), limits);
+    if (node.operator === '*')
+        return checkedDecimal(multiplyDecimal(left.value, right.value), limits);
+    if (node.operator === '/')
+        return divide(left.value, right.value, limits);
+    return power(left.value, right.value, limits);
+}
+function divide(numerator, denominator, limits) {
+    const value = divideDecimal(numerator, denominator, limits.precision, limits.rounding);
+    return value === null
+        ? fail('transition-rejection', 'calculator-division-by-zero', 'Calculator expression cannot divide by zero.')
+        : checkedDecimal(value, limits);
+}
+function power(base, exponent, limits) {
+    if (exponent.scale !== 0) {
+        return fail('transition-rejection', 'calculator-fractional-exponent', 'Calculator exponent must be an integer.', { exponent: decimalToString(exponent) });
+    }
+    const maximum = BigInt(limits.maxExponent);
+    const absolute = exponent.coefficient < 0n ? -exponent.coefficient : exponent.coefficient;
+    if (absolute > maximum) {
+        return fail('resource-rejection', 'calculator-exponent-ceiling-exceeded', 'Calculator exponent exceeds maxExponent.', { exponent: exponent.coefficient.toString(), maxExponent: limits.maxExponent });
+    }
+    let result = { coefficient: 1n, scale: 0 };
+    let factor = base;
+    let remaining = absolute;
+    while (remaining > 0n) {
+        if (remaining % 2n === 1n) {
+            result = multiplyDecimal(result, factor);
+            const checked = checkedDecimal(result, limits);
+            if (!checked.ok)
+                return checked;
+        }
+        remaining /= 2n;
+        if (remaining > 0n) {
+            factor = multiplyDecimal(factor, factor);
+            const checked = checkedDecimal(factor, limits);
+            if (!checked.ok)
+                return checked;
+        }
+    }
+    return exponent.coefficient < 0n
+        ? divide({ coefficient: 1n, scale: 0 }, result, limits)
+        : checkedDecimal(result, limits);
+}
+function checkedDecimal(value, limits) {
+    const text = decimalToString(value);
+    return text.length > limits.maxCodeUnits
+        ? fail('resource-rejection', 'calculator-result-ceiling-exceeded', 'Calculator intermediate result exceeds maxCodeUnits.', { codeUnits: text.length, maxCodeUnits: limits.maxCodeUnits })
+        : ok(value);
+}
+//# sourceMappingURL=number-field.js.map