@servicetitan/dte-pdf-editor 1.94.0 → 1.96.0

package/dist/utils/field/get-field-max-length.utils.d.ts

@@ -0,0 +1,38 @@
+import { type PdfField } from '../../interface/types';
+import { type FieldTextBox } from './field-text-box.utils';
+/**
+ * Largest `length` in `[0, max]` for which `fits(length)` holds; `fits` must be monotone
+ * (once a length stops fitting, longer ones don't either) and `fits(0)` is taken as true.
+ */
+export declare const findLargestFit: (fits: (length: number) => boolean, max?: number) => number;
+type TextBoxGeometry = Omit<FieldTextBox, 'key'>;
+export type TextCapacityParams = TextBoxGeometry & {
+    /** What is already typed; it counts towards the capacity and uses up some of the room. */
+    value?: string;
+};
+/**
+ * Highest character count a text box can hold, from rendered text widths: the characters
+ * already in `value` plus how many more fit after it.
+ *
+ * - `number`: guaranteed fit, bounded by the widest of the digits, `.` and `-`
+ * - `single-line`: expected fit for typical text, from the mean glyph width of a sample
+ * - `multiline`: expected fit for typical text, from simulated word wrapping into the
+ *   `floor(height / lineHeight)` lines available
+ *
+ * Narrow text leaves more room than wide text, so the answer moves with what is typed. A
+ * value that already overflows has no room left: the capacity is just its own length.
+ * At least 1; `undefined` when `measure` yields no usable text width, since there is then
+ * no basis for a limit.
+ */
+export declare const estimateTextCapacity: ({ value, ...box }: TextCapacityParams) => number | undefined;
+/**
+ * Max character count a fillable `text`/`number` field can hold given what is typed in it, so
+ * the counter can say how much room is left. With no `value` it is the field's capacity when
+ * empty. Input is limited by what actually fits, see `fitFieldTextChange`, not by this count.
+ *
+ * See {@link estimateTextCapacity} for how each field kind is measured. Text is measured
+ * with canvas at the field's own font, so it follows family, weight and size.
+ */
+export declare const getFieldMaxLength: (field: PdfField, value?: string) => number | undefined;
+export {};
+//# sourceMappingURL=get-field-max-length.utils.d.ts.map

package/dist/utils/field/get-field-max-length.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-field-max-length.utils.d.ts","sourceRoot":"","sources":["../../../src/utils/field/get-field-max-length.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAyC,KAAK,YAAY,EAAE,MAAM,wBAAwB,CAAC;AA+BlG;;;GAGG;AACH,eAAO,MAAM,cAAc,GAAI,MAAM,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,EAAE,YAAkB,KAAG,MAsBtF,CAAC;AAkBF,KAAK,eAAe,GAAG,IAAI,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;AA2DjD,MAAM,MAAM,kBAAkB,GAAG,eAAe,GAAG;IAC/C,0FAA0F;IAC1F,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,oBAAoB,GAAI,mBAGlC,kBAAkB,KAAG,MAAM,GAAG,SAqBhC,CAAC;AAKF;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB,GAAI,OAAO,QAAQ,EAAE,cAAU,KAAG,MAAM,GAAG,SAmBxE,CAAC"}

package/dist/utils/field/get-field-max-length.utils.js

@@ -0,0 +1,166 @@
+import { EPSILON, getFieldTextBox, getMaxLines } from './field-text-box.utils';
+import { advanceWrap, INITIAL_WRAP_STATE, } from './text-wrap.utils';
+/**
+ * Typical free-text form entries (names, addresses, emails, short notes) in mixed case.
+ *
+ * Capacity is estimated for this text rather than for a uniform `A-Za-z0-9` alphabet: that one
+ * averages ~0.58em per glyph against ~0.46em here (and ~0.47em for real entries), which is why
+ * the previous estimate under-reported capacity by ~20%. Contains no hyphens or newlines, so
+ * the wrap simulation in `text-wrap.utils` stays exact for it.
+ */
+const TEXT_SAMPLE = 'Jonathan Alexander Smith 1234 Elm Street, Apartment 5B Springfield, IL 62704 ' +
+    'jonathan.smith@example.com Maria Garcia Lopez Estimate #48213 for $1,250.00 ' +
+    'Replace the capacitor and clean the coils. Call before arriving, gate code 4471. ' +
+    'Dana Whitfield, Park Avenue Plumbing ';
+/** Glyphs a user can type into a number field; the capacity is bounded by the widest of them. */
+const NUMBER_GLYPHS = '0123456789.-';
+/** Evenly spaced word-start offsets into the sample that multiline wrapping is averaged over. */
+const MULTILINE_SAMPLE_PHASES = 8;
+/** Hard stop for the search, so a degenerate measurer (zero-width glyphs) can't loop forever. */
+const MAX_CAPACITY = 10000;
+/**
+ * Largest `length` in `[0, max]` for which `fits(length)` holds; `fits` must be monotone
+ * (once a length stops fitting, longer ones don't either) and `fits(0)` is taken as true.
+ */
+export const findLargestFit = (fits, max = MAX_CAPACITY) => {
+    let low = 0;
+    let high = max + 1;
+    for (let probe = 1; probe < high; probe *= 2) {
+        if (!fits(probe)) {
+            high = probe;
+            break;
+        }
+        low = probe;
+    }
+    while (high - low > 1) {
+        const mid = Math.floor((low + high) / 2);
+        if (fits(mid)) {
+            low = mid;
+        }
+        else {
+            high = mid;
+        }
+    }
+    return low;
+};
+/** The sample starting at `start` and wrapping around, repeated to `length` characters. */
+const getSampleText = (start, length) => {
+    const rotated = TEXT_SAMPLE.slice(start) + TEXT_SAMPLE.slice(0, start);
+    return rotated.repeat(Math.ceil(length / rotated.length)).slice(0, length);
+};
+const SAMPLE_WORD_STARTS = Array.from(TEXT_SAMPLE, (char, index) => index).filter(index => {
+    return TEXT_SAMPLE[index] !== ' ' && (index === 0 || TEXT_SAMPLE[index - 1] === ' ');
+});
+const SAMPLE_PHASES = Array.from({ length: MULTILINE_SAMPLE_PHASES }, (_, index) => {
+    return SAMPLE_WORD_STARTS[Math.floor((index * SAMPLE_WORD_STARTS.length) / MULTILINE_SAMPLE_PHASES)];
+});
+const getRemainingWidth = ({ measure, width }, value) => {
+    return Math.max(0, width - measure(value));
+};
+/**
+ * Number inputs only ever hold digits, `.` and `-`, so every value of N characters is at most
+ * N widest-glyphs wide: the room left is a guaranteed fit, not an average.
+ */
+const estimateNumberRoom = (box, value) => {
+    const widestGlyph = Math.max(...Array.from(NUMBER_GLYPHS, glyph => box.measure(glyph)));
+    return Math.floor(getRemainingWidth(box, value) / widestGlyph + EPSILON);
+};
+/** Characters of typical text that fit in the width left: it over the sample's mean glyph. */
+const estimateSingleLineRoom = (box, value) => {
+    const meanGlyphWidth = box.measure(TEXT_SAMPLE) / TEXT_SAMPLE.length;
+    return Math.floor(getRemainingWidth(box, value) / meanGlyphWidth + EPSILON);
+};
+/**
+ * Characters of typical text that fit in the lines left after `value`. Real wrapping is
+ * simulated, so the unused space at the end of each line is accounted for; the result is
+ * averaged over several starting points in the sample because it shifts by a few characters
+ * with where the text begins.
+ */
+const estimateMultilineRoom = (box, value) => {
+    const maxLines = getMaxLines(box);
+    const measureCache = new Map();
+    const measure = text => {
+        let measured = measureCache.get(text);
+        if (measured === undefined) {
+            measured = box.measure(text);
+            measureCache.set(text, measured);
+        }
+        return measured;
+    };
+    const valueState = advanceWrap(INITIAL_WRAP_STATE, value, box.width, measure);
+    if (valueState.lines > maxLines) {
+        return 0;
+    }
+    // typed text goes on after a word, so continue it with a space unless it already ends in one
+    const separator = /(^|[ \n])$/.test(value) ? '' : ' ';
+    const fitsAfterValue = (state, text) => {
+        return advanceWrap(state, text, box.width, measure).lines <= maxLines;
+    };
+    const capacities = SAMPLE_PHASES.map(start => {
+        return findLargestFit(length => {
+            return fitsAfterValue(valueState, separator + getSampleText(start, length));
+        });
+    });
+    return Math.floor(capacities.reduce((sum, value) => sum + value, 0) / capacities.length);
+};
+/**
+ * Highest character count a text box can hold, from rendered text widths: the characters
+ * already in `value` plus how many more fit after it.
+ *
+ * - `number`: guaranteed fit, bounded by the widest of the digits, `.` and `-`
+ * - `single-line`: expected fit for typical text, from the mean glyph width of a sample
+ * - `multiline`: expected fit for typical text, from simulated word wrapping into the
+ *   `floor(height / lineHeight)` lines available
+ *
+ * Narrow text leaves more room than wide text, so the answer moves with what is typed. A
+ * value that already overflows has no room left: the capacity is just its own length.
+ * At least 1; `undefined` when `measure` yields no usable text width, since there is then
+ * no basis for a limit.
+ */
+export const estimateTextCapacity = ({ value = '', ...box }) => {
+    const sampleWidth = box.measure(TEXT_SAMPLE);
+    if (!Number.isFinite(sampleWidth) || sampleWidth <= 0) {
+        return undefined;
+    }
+    let room;
+    switch (box.layout) {
+        case 'number':
+            room = estimateNumberRoom(box, value);
+            break;
+        case 'multiline':
+            room = estimateMultilineRoom(box, value);
+            break;
+        default:
+            room = estimateSingleLineRoom(box, value);
+    }
+    return Number.isNaN(room)
+        ? undefined
+        : Math.max(1, value.length + Math.min(MAX_CAPACITY, room));
+};
+const MAX_LENGTH_CACHE_SIZE = 500;
+const maxLengthCache = new Map();
+/**
+ * Max character count a fillable `text`/`number` field can hold given what is typed in it, so
+ * the counter can say how much room is left. With no `value` it is the field's capacity when
+ * empty. Input is limited by what actually fits, see `fitFieldTextChange`, not by this count.
+ *
+ * See {@link estimateTextCapacity} for how each field kind is measured. Text is measured
+ * with canvas at the field's own font, so it follows family, weight and size.
+ */
+export const getFieldMaxLength = (field, value = '') => {
+    const box = getFieldTextBox(field);
+    if (!box) {
+        return undefined;
+    }
+    const cacheKey = `${box.key}|${value}`;
+    if (maxLengthCache.has(cacheKey)) {
+        return maxLengthCache.get(cacheKey);
+    }
+    const maxLength = estimateTextCapacity({ ...box, value });
+    if (maxLengthCache.size >= MAX_LENGTH_CACHE_SIZE) {
+        maxLengthCache.clear();
+    }
+    maxLengthCache.set(cacheKey, maxLength);
+    return maxLength;
+};
+//# sourceMappingURL=get-field-max-length.utils.js.map

package/dist/utils/field/get-field-max-length.utils.js.map

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

package/dist/utils/field/index.d.ts

@@ -5,8 +5,10 @@ export * from './field-drag.utils';
 export * from './field-placeholder-text.utils';
 export * from './field-reading-order.utils';
 export * from './field-resize.utils';
+export * from './fit-field-text.utils';
 export * from './get-field-bounds-style.utils';
 export * from './get-field-font-size.utils';
+export * from './get-field-max-length.utils';
 export * from './get-field-text-clip.utils';
 export * from './get-field-type-option.utils';
 export * from './get-field-typography.utils';

package/dist/utils/field/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/field/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,oBAAoB,CAAC;AACnC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,sBAAsB,CAAC;AACrC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,kCAAkC,CAAC;AACjD,cAAc,oCAAoC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/field/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,oBAAoB,CAAC;AACnC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,kCAAkC,CAAC;AACjD,cAAc,oCAAoC,CAAC"}

package/dist/utils/field/index.js

@@ -5,8 +5,10 @@ export * from './field-drag.utils';
 export * from './field-placeholder-text.utils';
 export * from './field-reading-order.utils';
 export * from './field-resize.utils';
+export * from './fit-field-text.utils';
 export * from './get-field-bounds-style.utils';
 export * from './get-field-font-size.utils';
+export * from './get-field-max-length.utils';
 export * from './get-field-text-clip.utils';
 export * from './get-field-type-option.utils';
 export * from './get-field-typography.utils';

package/dist/utils/field/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/field/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,oBAAoB,CAAC;AACnC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,sBAAsB,CAAC;AACrC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,kCAAkC,CAAC;AACjD,cAAc,oCAAoC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/field/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,oBAAoB,CAAC;AACnC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,kCAAkC,CAAC;AACjD,cAAc,oCAAoC,CAAC"}

package/dist/utils/field/text-wrap.utils.d.ts

@@ -0,0 +1,26 @@
+/** Returns the rendered width of `text` in pixels for one fixed font. */
+export type TextMeasurer = (text: string) => number;
+/** Where text wrapping has got to: the line being filled, and how wide it is so far. */
+export interface WrapState {
+    lines: number;
+    lineWidth: number;
+}
+/** An empty box still occupies one line. */
+export declare const INITIAL_WRAP_STATE: WrapState;
+/**
+ * Continues laying out `text` after `state` in a box `maxWidth` wide, simulating browser layout
+ * for `white-space: pre-wrap; overflow-wrap: break-word` (the multiline fillable textarea):
+ *
+ * - `\n` forces a line break; a trailing `\n` still opens a line, as in a textarea
+ * - words wrap at spaces; runs of spaces are preserved and hang past the edge instead of wrapping
+ * - a word wider than a whole line is broken between characters (code points)
+ *
+ * `text` must start at a word boundary of the text already laid out, i.e. not continue a word.
+ *
+ * Not modelled: break opportunities after hyphens and other punctuation, which only ever let
+ * browsers pack lines more tightly, so the line count is never optimistic.
+ */
+export declare const advanceWrap: (state: WrapState, text: string, maxWidth: number, measure: TextMeasurer) => WrapState;
+/** Counts the lines `text` occupies in a box `maxWidth` wide; see {@link advanceWrap}. */
+export declare const countWrappedLines: (text: string, maxWidth: number, measure: TextMeasurer) => number;
+//# sourceMappingURL=text-wrap.utils.d.ts.map

package/dist/utils/field/text-wrap.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-wrap.utils.d.ts","sourceRoot":"","sources":["../../../src/utils/field/text-wrap.utils.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,MAAM,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;AAEpD,wFAAwF;AACxF,MAAM,WAAW,SAAS;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,4CAA4C;AAC5C,eAAO,MAAM,kBAAkB,EAAE,SAAsC,CAAC;AAExE;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,WAAW,GACpB,OAAO,SAAS,EAChB,MAAM,MAAM,EACZ,UAAU,MAAM,EAChB,SAAS,YAAY,KACtB,SAsCF,CAAC;AAEF,0FAA0F;AAC1F,eAAO,MAAM,iBAAiB,GAC1B,MAAM,MAAM,EACZ,UAAU,MAAM,EAChB,SAAS,YAAY,KACtB,MAEF,CAAC"}

package/dist/utils/field/text-wrap.utils.js

@@ -0,0 +1,53 @@
+/** An empty box still occupies one line. */
+export const INITIAL_WRAP_STATE = { lines: 1, lineWidth: 0 };
+/**
+ * Continues laying out `text` after `state` in a box `maxWidth` wide, simulating browser layout
+ * for `white-space: pre-wrap; overflow-wrap: break-word` (the multiline fillable textarea):
+ *
+ * - `\n` forces a line break; a trailing `\n` still opens a line, as in a textarea
+ * - words wrap at spaces; runs of spaces are preserved and hang past the edge instead of wrapping
+ * - a word wider than a whole line is broken between characters (code points)
+ *
+ * `text` must start at a word boundary of the text already laid out, i.e. not continue a word.
+ *
+ * Not modelled: break opportunities after hyphens and other punctuation, which only ever let
+ * browsers pack lines more tightly, so the line count is never optimistic.
+ */
+export const advanceWrap = (state, text, maxWidth, measure) => {
+    var _a;
+    let { lineWidth, lines } = state;
+    for (const token of (_a = text.replace(/\r\n?/g, '\n').match(/\n| +|[^ \n]+/g)) !== null && _a !== void 0 ? _a : []) {
+        if (token === '\n') {
+            lines += 1;
+            lineWidth = 0;
+            continue;
+        }
+        const tokenWidth = measure(token);
+        if (token[0] === ' ' || lineWidth + tokenWidth <= maxWidth) {
+            lineWidth += tokenWidth;
+            continue;
+        }
+        if (lineWidth > 0) {
+            lines += 1;
+            lineWidth = 0;
+        }
+        if (tokenWidth <= maxWidth) {
+            lineWidth = tokenWidth;
+            continue;
+        }
+        for (const char of token) {
+            const charWidth = measure(char);
+            if (lineWidth > 0 && lineWidth + charWidth > maxWidth) {
+                lines += 1;
+                lineWidth = 0;
+            }
+            lineWidth += charWidth;
+        }
+    }
+    return { lines, lineWidth };
+};
+/** Counts the lines `text` occupies in a box `maxWidth` wide; see {@link advanceWrap}. */
+export const countWrappedLines = (text, maxWidth, measure) => {
+    return advanceWrap(INITIAL_WRAP_STATE, text, maxWidth, measure).lines;
+};
+//# sourceMappingURL=text-wrap.utils.js.map

package/dist/utils/field/text-wrap.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-wrap.utils.js","sourceRoot":"","sources":["../../../src/utils/field/text-wrap.utils.ts"],"names":[],"mappings":"AASA,4CAA4C;AAC5C,MAAM,CAAC,MAAM,kBAAkB,GAAc,EAAE,KAAK,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;AAExE;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CACvB,KAAgB,EAChB,IAAY,EACZ,QAAgB,EAChB,OAAqB,EACZ,EAAE;;IACX,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC;IAEjC,KAAK,MAAM,KAAK,IAAI,MAAA,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC,mCAAI,EAAE,EAAE,CAAC;QAC7E,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACjB,KAAK,IAAI,CAAC,CAAC;YACX,SAAS,GAAG,CAAC,CAAC;YACd,SAAS;QACb,CAAC;QAED,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;QAElC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,SAAS,GAAG,UAAU,IAAI,QAAQ,EAAE,CAAC;YACzD,SAAS,IAAI,UAAU,CAAC;YACxB,SAAS;QACb,CAAC;QAED,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;YAChB,KAAK,IAAI,CAAC,CAAC;YACX,SAAS,GAAG,CAAC,CAAC;QAClB,CAAC;QAED,IAAI,UAAU,IAAI,QAAQ,EAAE,CAAC;YACzB,SAAS,GAAG,UAAU,CAAC;YACvB,SAAS;QACb,CAAC;QAED,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACvB,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;YAChC,IAAI,SAAS,GAAG,CAAC,IAAI,SAAS,GAAG,SAAS,GAAG,QAAQ,EAAE,CAAC;gBACpD,KAAK,IAAI,CAAC,CAAC;gBACX,SAAS,GAAG,CAAC,CAAC;YAClB,CAAC;YACD,SAAS,IAAI,SAAS,CAAC;QAC3B,CAAC;IACL,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;AAChC,CAAC,CAAC;AAEF,0FAA0F;AAC1F,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC7B,IAAY,EACZ,QAAgB,EAChB,OAAqB,EACf,EAAE;IACR,OAAO,WAAW,CAAC,kBAAkB,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC;AAC1E,CAAC,CAAC"}

package/dist/utils/formula/business-days.utils.d.ts

@@ -0,0 +1,32 @@
+import { type BusinessCalendar } from '../../interface/types';
+/**
+ * The default calendar: Saturday and Sunday plus `holidays` (the host's, DTE's
+ * `GET api/holidays`), for the current year ± DEFAULT_CALENDAR_YEARS. Fields whose schedule toggle
+ * is off use it.
+ */
+export declare function defaultBusinessCalendar(holidays?: string[]): BusinessCalendar;
+/**
+ * Walks `days` business days from a date (epoch ms; negative walks back), the start not counted.
+ * Mirrors DTE's `BusinessDayCalculator.AddBusinessDays`: null for a fractional offset, more than
+ * MAX_DATE_CALC_DAYS, an invalid start, or a start or walk outside the calendar's years.
+ */
+export declare function addBusinessDays(startMs: number, days: number, calendar: BusinessCalendar): number | null;
+/**
+ * Counts the business days from `fromMs` to `toMs`, negative when `toMs` is earlier; the start is
+ * not counted, the end is. Mirrors DTE's `BusinessDayCalculator.CountBusinessDays`: null for an
+ * invalid date, a span over MAX_DATE_CALC_DAYS, or a date outside the calendar's years.
+ */
+export declare function countBusinessDays(fromMs: number, toMs: number, calendar: BusinessCalendar): number | null;
+/**
+ * Adds `days` plain calendar days to a date (epoch ms; negative subtracts) — no weekend or holiday
+ * skipping. Used when a date calculated field's business-day exclusion toggle is off, matching the
+ * pre-DTE-4695 behavior. Null for a fractional offset, more than MAX_DATE_CALC_DAYS, or an invalid
+ * start.
+ */
+export declare function addCalendarDays(startMs: number, days: number): number | null;
+/**
+ * Counts the plain calendar days from `fromMs` to `toMs`, negative when `toMs` is earlier — no
+ * weekend or holiday skipping. Null for an invalid date or a span over MAX_DATE_CALC_DAYS.
+ */
+export declare function countCalendarDays(fromMs: number, toMs: number): number | null;
+//# sourceMappingURL=business-days.utils.d.ts.map

package/dist/utils/formula/business-days.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"business-days.utils.d.ts","sourceRoot":"","sources":["../../../src/utils/formula/business-days.utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAwD9D;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,gBAAgB,CAQ7E;AAWD;;;;GAIG;AACH,wBAAgB,eAAe,CAC3B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,gBAAgB,GAC3B,MAAM,GAAG,IAAI,CA2Bf;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC7B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,gBAAgB,GAC3B,MAAM,GAAG,IAAI,CA2Bf;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAU5E;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQ7E"}

package/dist/utils/formula/business-days.utils.js

@@ -0,0 +1,148 @@
+import { DEFAULT_CALENDAR_YEARS, MAX_DATE_CALC_DAYS } from '../../constants';
+/** Saturday and Sunday: the default calendar's weekend. */
+const DEFAULT_WEEKEND_DAYS = [0, 6];
+const DAY_MS = 24 * 60 * 60 * 1000;
+function toDateOnly(ms) {
+    const d = new Date(ms);
+    d.setUTCHours(0, 0, 0, 0);
+    return d;
+}
+function toDateKey(d) {
+    const y = d.getUTCFullYear();
+    const m = String(d.getUTCMonth() + 1).padStart(2, '0');
+    const day = String(d.getUTCDate()).padStart(2, '0');
+    return `${y}-${m}-${day}`;
+}
+function buildHolidaySet(holidays) {
+    const set = new Set();
+    for (const h of holidays !== null && holidays !== void 0 ? holidays : []) {
+        const d = toDateOnly(new Date(h).getTime());
+        if (!isNaN(d.getTime())) {
+            set.add(toDateKey(d));
+        }
+    }
+    return set;
+}
+// Calendars are passed once and reused by every field, so each is prepared once.
+const preparedCalendars = new WeakMap();
+function prepareCalendar(calendar) {
+    var _a;
+    const cached = preparedCalendars.get(calendar);
+    if (cached) {
+        return cached;
+    }
+    const prepared = {
+        weekendDays: new Set((_a = calendar.weekendDays) !== null && _a !== void 0 ? _a : DEFAULT_WEEKEND_DAYS),
+        holidays: buildHolidaySet(calendar.holidays),
+        firstYear: calendar.firstYear,
+        lastYear: calendar.lastYear,
+    };
+    preparedCalendars.set(calendar, prepared);
+    return prepared;
+}
+/**
+ * The default calendar: Saturday and Sunday plus `holidays` (the host's, DTE's
+ * `GET api/holidays`), for the current year ± DEFAULT_CALENDAR_YEARS. Fields whose schedule toggle
+ * is off use it.
+ */
+export function defaultBusinessCalendar(holidays) {
+    const year = new Date().getUTCFullYear();
+    return {
+        weekendDays: DEFAULT_WEEKEND_DAYS,
+        holidays: holidays !== null && holidays !== void 0 ? holidays : [],
+        firstYear: year - DEFAULT_CALENDAR_YEARS,
+        lastYear: year + DEFAULT_CALENDAR_YEARS,
+    };
+}
+function isBusinessDay(d, calendar) {
+    return !calendar.weekendDays.has(d.getUTCDay()) && !calendar.holidays.has(toDateKey(d));
+}
+function isWithinYears(d, calendar) {
+    const year = d.getUTCFullYear();
+    return year >= calendar.firstYear && year <= calendar.lastYear;
+}
+/**
+ * Walks `days` business days from a date (epoch ms; negative walks back), the start not counted.
+ * Mirrors DTE's `BusinessDayCalculator.AddBusinessDays`: null for a fractional offset, more than
+ * MAX_DATE_CALC_DAYS, an invalid start, or a start or walk outside the calendar's years.
+ */
+export function addBusinessDays(startMs, days, calendar) {
+    const prepared = prepareCalendar(calendar);
+    const start = toDateOnly(startMs);
+    if (!Number.isInteger(days) ||
+        Math.abs(days) > MAX_DATE_CALC_DAYS ||
+        !isFinite(start.getTime()) ||
+        !isWithinYears(start, prepared)) {
+        return null;
+    }
+    const direction = days >= 0 ? 1 : -1;
+    let remaining = Math.abs(days);
+    const current = new Date(start.getTime());
+    while (remaining > 0) {
+        current.setUTCDate(current.getUTCDate() + direction);
+        if (!isWithinYears(current, prepared)) {
+            return null;
+        }
+        if (isBusinessDay(current, prepared)) {
+            remaining--;
+        }
+    }
+    return current.getTime();
+}
+/**
+ * Counts the business days from `fromMs` to `toMs`, negative when `toMs` is earlier; the start is
+ * not counted, the end is. Mirrors DTE's `BusinessDayCalculator.CountBusinessDays`: null for an
+ * invalid date, a span over MAX_DATE_CALC_DAYS, or a date outside the calendar's years.
+ */
+export function countBusinessDays(fromMs, toMs, calendar) {
+    const prepared = prepareCalendar(calendar);
+    const from = toDateOnly(fromMs);
+    const to = toDateOnly(toMs);
+    if (!isFinite(from.getTime()) || !isFinite(to.getTime())) {
+        return null;
+    }
+    if (Math.abs(to.getTime() - from.getTime()) / DAY_MS > MAX_DATE_CALC_DAYS ||
+        !isWithinYears(from, prepared) ||
+        !isWithinYears(to, prepared)) {
+        return null;
+    }
+    const direction = to.getTime() >= from.getTime() ? 1 : -1;
+    const cursor = new Date(from.getTime());
+    let count = 0;
+    while (toDateKey(cursor) !== toDateKey(to)) {
+        cursor.setUTCDate(cursor.getUTCDate() + direction);
+        if (isBusinessDay(cursor, prepared)) {
+            count++;
+        }
+    }
+    return count * direction;
+}
+/**
+ * Adds `days` plain calendar days to a date (epoch ms; negative subtracts) — no weekend or holiday
+ * skipping. Used when a date calculated field's business-day exclusion toggle is off, matching the
+ * pre-DTE-4695 behavior. Null for a fractional offset, more than MAX_DATE_CALC_DAYS, or an invalid
+ * start.
+ */
+export function addCalendarDays(startMs, days) {
+    const start = toDateOnly(startMs);
+    if (!Number.isInteger(days) ||
+        Math.abs(days) > MAX_DATE_CALC_DAYS ||
+        !isFinite(start.getTime())) {
+        return null;
+    }
+    return start.getTime() + days * DAY_MS;
+}
+/**
+ * Counts the plain calendar days from `fromMs` to `toMs`, negative when `toMs` is earlier — no
+ * weekend or holiday skipping. Null for an invalid date or a span over MAX_DATE_CALC_DAYS.
+ */
+export function countCalendarDays(fromMs, toMs) {
+    const from = toDateOnly(fromMs);
+    const to = toDateOnly(toMs);
+    if (!isFinite(from.getTime()) || !isFinite(to.getTime())) {
+        return null;
+    }
+    const diffDays = Math.round((to.getTime() - from.getTime()) / DAY_MS);
+    return Math.abs(diffDays) > MAX_DATE_CALC_DAYS ? null : diffDays;
+}
+//# sourceMappingURL=business-days.utils.js.map

package/dist/utils/formula/business-days.utils.js.map

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

package/dist/utils/formula/caret.utils.js

@@ -26,7 +26,7 @@ function getExpressionBeforeCaret(element) {
         while (current && current.parentNode !== element) {
             current = current.parentNode;
         }
-        return current && current.parentNode === element ? current : null;
+        return (current === null || current === void 0 ? void 0 : current.parentNode) === element ? current : null;
     };
     if (endContainer === element) {
         element.childNodes.forEach((node, index) => {

package/dist/utils/formula/caret.utils.js.map

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

package/dist/utils/formula/evaluate-formula.utils.d.ts

@@ -1,4 +1,21 @@
-import { type DataModelValues, type StructuredFormula } from '../../interface/types';
+import { type BusinessCalendar, type DataModelValues, type FieldScheduleBinding, type StructuredFormula } from '../../interface/types';
+/**
+ * Which calendar a date formula uses. `enabled` is the field's custom business-day exclusion
+ * toggle (DTE's schedule binding): off uses plain calendar-day arithmetic (no weekend/holiday
+ * skipping, the pre-DTE-4695 behavior); on uses the field's own calendar (`calendar`, a field
+ * bound to a schedule) or the default one, Saturday and Sunday plus `holidays`.
+ */
+export interface DateCalcOptions {
+    enabled?: boolean;
+    calendar?: BusinessCalendar;
+    holidays?: string[];
+}
+/**
+ * A field's options: disabled (plain calendar-day math) unless it has a binding in
+ * `scheduleBindings` (DTE's `fieldKey` = `PdfField.id`), in which case it uses its own calendar
+ * when the host passed one for its id, else the default calendar.
+ */
+export declare function getFieldDateCalcOptions(fieldId: string | undefined, scheduleBindings: FieldScheduleBinding[] | undefined, holidays: string[] | undefined, fieldCalendars: Record<string, BusinessCalendar> | undefined): DateCalcOptions;
 /**
  * Convert formula operand to number. Merge tags and fillable only ever give:
  * empty '', a number, or a string number (e.g. '1.2'). Only those are converted to number for calculation.
@@ -15,14 +32,16 @@ export declare function valueToNumber(raw: unknown): number;
  * field is omitted rather than showing 0.
  *
  * Date fields are identified by `fieldType: 'date'` on field tokens. When date
- * fields are present, arithmetic follows business-day semantics — weekends and
- * holidays are skipped when adding/subtracting days, and date diffs count only
- * business days.
+ * fields are present and `options.enabled` is on, arithmetic follows business-day
+ * semantics — the calendar's weekend days and holidays are skipped when adding/subtracting
+ * days, and date diffs count only business days, with a result outside the calendar's years
+ * blank. Otherwise (the field's exclusion toggle is off) it's plain calendar-day arithmetic.
+ * Either way, as in DTE, a fractional offset or a difference over 365 days is `null` (blank).
  */
-export declare function evaluateFormula(formula: StructuredFormula | undefined | null, data: DataModelValues | undefined, holidays?: string[]): number | null;
+export declare function evaluateFormula(formula: StructuredFormula | undefined | null, data: DataModelValues | undefined, options?: DateCalcOptions): number | null;
 /**
  * Returns true when the formula divides by zero with the given data
  * (literal `… / 0` or a divisor that resolves to 0). Matches backend null result.
  */
-export declare function hasDivisionByZero(formula: StructuredFormula | undefined | null, data?: DataModelValues, holidays?: string[]): boolean;
+export declare function hasDivisionByZero(formula: StructuredFormula | undefined | null, data?: DataModelValues, options?: DateCalcOptions): boolean;
 //# sourceMappingURL=evaluate-formula.utils.d.ts.map

package/dist/utils/formula/evaluate-formula.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"evaluate-formula.utils.d.ts","sourceRoot":"","sources":["../../../src/utils/formula/evaluate-formula.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,KAAK,eAAe,EAGpB,KAAK,iBAAiB,EACzB,MAAM,uBAAuB,CAAC;AAG/B;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAgBlD;AAiXD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAC3B,OAAO,EAAE,iBAAiB,GAAG,SAAS,GAAG,IAAI,EAC7C,IAAI,EAAE,eAAe,GAAG,SAAS,EACjC,QAAQ,CAAC,EAAE,MAAM,EAAE,GACpB,MAAM,GAAG,IAAI,CAsBf;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC7B,OAAO,EAAE,iBAAiB,GAAG,SAAS,GAAG,IAAI,EAC7C,IAAI,CAAC,EAAE,eAAe,EACtB,QAAQ,CAAC,EAAE,MAAM,EAAE,WActB"}
+{"version":3,"file":"evaluate-formula.utils.d.ts","sourceRoot":"","sources":["../../../src/utils/formula/evaluate-formula.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,oBAAoB,EAGzB,KAAK,iBAAiB,EACzB,MAAM,uBAAuB,CAAC;AAU/B;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CACnC,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,gBAAgB,EAAE,oBAAoB,EAAE,GAAG,SAAS,EACpD,QAAQ,EAAE,MAAM,EAAE,GAAG,SAAS,EAC9B,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,GAAG,SAAS,GAC7D,eAAe,CAOjB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAgBlD;AAiTD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,CAC3B,OAAO,EAAE,iBAAiB,GAAG,SAAS,GAAG,IAAI,EAC7C,IAAI,EAAE,eAAe,GAAG,SAAS,EACjC,OAAO,CAAC,EAAE,eAAe,GAC1B,MAAM,GAAG,IAAI,CAwBf;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC7B,OAAO,EAAE,iBAAiB,GAAG,SAAS,GAAG,IAAI,EAC7C,IAAI,CAAC,EAAE,eAAe,EACtB,OAAO,CAAC,EAAE,eAAe,WAc5B"}