solve-engine 2.2.0 → 2.4.0

package/dist/chunk-HLBYHXQD.cjs

@@ -1,3 +0,0 @@
-'use strict';var chunkR2SZFJTT_cjs=require('./chunk-R2SZFJTT.cjs'),chunkESUN2THE_cjs=require('./chunk-ESUN2THE.cjs'),chunkN7N7MPMK_cjs=require('./chunk-N7N7MPMK.cjs'),chunkPS272DZJ_cjs=require('./chunk-PS272DZJ.cjs'),chunkMSYX32PF_cjs=require('./chunk-MSYX32PF.cjs');var b={floatResult:{decimalPlaces:2,enableSeperator:true},numberResult:{decimalSeparatorLocale:"en-US"},hexResult:{enablePadding:false,paddingZeros:0},unitOfMeasurementResult:{decimalPlaces:2},percentageResult:{decimalPlaces:2}};function D(t,r,e,o){let n=e.floatResult.enableSeperator,i=e.numberResult.decimalSeparatorLocale;if(o!==void 0&&Number.isFinite(t)){let c=t.toLocaleString(i||"en-US",{minimumFractionDigits:o,maximumFractionDigits:o,useGrouping:n});return `${r.display.resultPrefix}${c}`}let a=e.floatResult.decimalPlaces,s=chunkR2SZFJTT_cjs.a(t,a,n,i);return `${r.display.resultPrefix}${s}`}function R(t,r,e,o){let n=o.floatResult.decimalPlaces,i=o.floatResult.enableSeperator,a=o.numberResult.decimalSeparatorLocale||"en-US",s=Math.max(n,1),c=t.toLocaleString(a,{useGrouping:i,minimumFractionDigits:0,maximumFractionDigits:n}),u=Math.abs(r).toLocaleString(a,{useGrouping:i,minimumFractionDigits:1,maximumFractionDigits:s});return `${e.display.resultPrefix}${c} \xB1 ${u}`}function F(t,r,e){if(typeof t=="number"&&!Number.isFinite(t))return `= ${t}`;let o=typeof t=="bigint"?t<0n:t<0,n=o?"-":"",i=c=>typeof t=="bigint"?(o?-t:t).toString(c):Math.abs(Math.trunc(t)).toString(c);if(e==="bin")return `= ${n}0b${i(2)}`;if(e==="oct")return `= ${n}0o${i(8)}`;let a=r.hexResult.enablePadding?r.hexResult.paddingZeros:0,s=i(16).toUpperCase().padStart(a,"0");return `= ${n}0x${s}`}var L=2e4;function P(t){let r=t<0n?-t:t;if(Number.isFinite(Number(r)))return `= ${t}`;let e=r.toString(16).length*4;if(e*Math.LN2/Math.LN10<=L)return `= ${t}`;let o=e*Math.LN2/Math.LN10,n=Math.floor(o),i=Math.pow(10,o-n);return `= ${t<0n?"-":""}~${i.toFixed(3)}e+${n} (an exact integer of about ${(n+1).toLocaleString("en-US")} digits, too large to print)`}function I(t){return `= ${t}`}function T(t){return `= ${t}`}function w(t,r){let e=new Date(t),o=e.toLocaleDateString(r.code,{weekday:"long",year:"numeric",month:"long",day:"numeric"});return e.getHours()===0&&e.getMinutes()===0&&e.getSeconds()===0&&e.getMilliseconds()===0?`= ${o}`:`= ${o}, ${e.toLocaleTimeString(r.code)}`}function N(t){let r=t<0?"-":"",e=Math.round(Math.abs(t)/1e3),o=Math.floor(e/3600),n=Math.floor(e%3600/60),i=e%60,a=String(n).padStart(2,"0");if(i===0)return `${r}${o}:${a}`;let s=String(i).padStart(2,"0");return `${r}${o}:${a}:${s}`}function U(t,r,e,o,n){if(r==="ms")return `= ${N(t)}`;let i=o.unitOfMeasurementResult.decimalPlaces,s=r&&["days","weeks","months","years","hours","minutes","seconds","day","week","month","year","hour","minute","second"].includes(r),c;s&&t===Math.floor(t)?c=t.toString():c=t.toFixed(i);let u=r?chunkN7N7MPMK_cjs.ua[r.toUpperCase()]:void 0;if(u){let m=n?chunkN7N7MPMK_cjs.sa(n,i):c,$=u.spaced?" ":"";return `= ${u.position==="prefix"?`${u.symbol}${$}${m}`:`${m}${$}${u.symbol}`}`}return `= ${n?chunkN7N7MPMK_cjs.sa(n,i):c} ${r||""}`.trim()}function M(t,r){if(typeof t=="boolean")return t?"true":"false";if(typeof t=="object"&&t!==null)return chunkN7N7MPMK_cjs.R(t);let e=r.floatResult.decimalPlaces,o=r.floatResult.enableSeperator,n=r.numberResult.decimalSeparatorLocale;return chunkR2SZFJTT_cjs.a(t,e,o,n)}function E(t,r,e){let o=chunkN7N7MPMK_cjs.Z(t),n=[];for(let i=0;i<t.rows;i++){let a=[];for(let s=0;s<t.cols;s++)a.push(M(o[i*t.cols+s],e));n.push(a.join(", "));}return `${r.display.resultPrefix}[${n.join("; ")}]`}function Q(t,r){let e=r||b,o=chunkN7N7MPMK_cjs.Z(t),n=[];for(let a=0;a<t.rows;a++){let s=[];for(let c=0;c<t.cols;c++)s.push(M(o[a*t.cols+c],e));n.push(s);}let i=[];for(let a=0;a<t.cols;a++){let s=0;for(let c=0;c<t.rows;c++)s=Math.max(s,n[c][a].length);i.push(s);}return n.map(a=>`[ ${a.map((s,c)=>s.padStart(i[c])).join("  ")} ]`).join(`
-`)}function j(t,r,e){return `${e.display.resultPrefix}${t}:${r}`}function C(t,r,e){let o=e.percentageResult.decimalPlaces;return `= ${(t*100).toFixed(o)}${r.display.percentageSuffix}`}function A(t,r){return `= ${t} ${r||""}`.trim()}function G(t,r,e){let o=r.display.resultPrefix,n=u=>{let l=t.unit!==void 0?new chunkPS272DZJ_cjs.m(6,u.value,t.unit):new chunkPS272DZJ_cjs.m(0,u.value);l.exact=u.exact;let m=_(l,e);return m.startsWith(o)?m.slice(o.length):m},[i,a]=t.shares,s=`${n(i)} each`;if(a===void 0)return `${o}${s}`;let c=a.count===1?"share":"shares";return `${o}${s}, with ${a.count} ${c} paying ${n(a)}`}function _(t,r){let e=r||b,o=e.numberResult.decimalSeparatorLocale||"en",n=chunkMSYX32PF_cjs.a(o);switch(t.type){case 0:return t.uncertainty!==void 0?R(t.value,t.uncertainty,n,e):D(t.value,n,e,t.decimalPlaces);case 1:return F(t.value,e,t.unit);case 2:return P(t.value);case 3:return I(t.value);case 10:return T(t.value);case 4:return w(t.value,n);case 6:return U(t.value,t.unit,n,e,t.exact);case 7:return E(t.value,n,e);case 8:{let i=t.value;return j(i.min,i.max,n)}case 14:return `${n.display.resultPrefix}${chunkESUN2THE_cjs.g(t.value)}`;case 15:return G(t.value,n,e);case 9:return chunkN7N7MPMK_cjs.R(t.value);case 5:return C(t.value,n,e);case 11:return A(t.value,t.unit);case 13:return t.unit??String(t.value);default:return `= ${String(t.value)}`}}exports.a=b;exports.b=Q;exports.c=_;//# sourceMappingURL=chunk-HLBYHXQD.cjs.map
-//# sourceMappingURL=chunk-HLBYHXQD.cjs.map

package/dist/chunk-HLBYHXQD.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/format/FormattingSettings.ts","../src/format/FormatEngine.ts"],"names":["DEFAULT_FORMATTING_SETTINGS","formatNumber","value","locale","settings","decimalPlaces","sep","loc","formatted","dp","autoFormatIntegerOrFloat","formatUncertain","center","uncertainty","useGrouping","spreadMax","centerText","spreadText","formatHex","base","negative","sign","digits","radix","padding","hex","MAX_DISPLAYED_BIGINT_DIGITS","formatBigInt","magnitude","bits","log10","exponent","mantissa","formatString","formatBoolean","formatDatetime","d","dateStr","formatMsDuration","ms","totalSeconds","hours","minutes","seconds","mm","ss","formatUom","unit","exact","isTimeSpan","currencyDisplay","CURRENCY_DISPLAY","moneyText","decimalToFixed","formatMatrixEntry","entry","formatSymbolic","formatMatrix","m","rowMajor","columnMajorToRowMajor","rows","r","cells","c","formatMatrixAligned","us","row","colWidth","width","cell","formatRange","min","max","formatPercentage","formatUnit","formatSplit","data","prefix","render","share","v","Value","text","formatValue","high","each","shareWord","localeCode","getLocale","formatColour"],"mappings":"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","file":"chunk-HLBYHXQD.cjs","sourcesContent":["/**\n * Minimal formatting settings interface for the engine\n * This allows the engine to format values without depending on app-specific settings\n */\nexport interface FormattingSettings {\n  floatResult: {\n    decimalPlaces: number;\n    enableSeperator: boolean;\n  };\n  numberResult: {\n    decimalSeparatorLocale: string;\n  };\n  hexResult: {\n    enablePadding: boolean;\n    paddingZeros: number;\n  };\n  unitOfMeasurementResult: {\n    decimalPlaces: number;\n  };\n  percentageResult: {\n    decimalPlaces: number;\n  };\n}\n\n/** Formatting used when a host supplies none. */\nexport const DEFAULT_FORMATTING_SETTINGS: FormattingSettings = {\n  floatResult: {\n    decimalPlaces: 2,\n    enableSeperator: true,\n  },\n  numberResult: {\n    decimalSeparatorLocale: \"en-US\",\n  },\n  hexResult: {\n    enablePadding: false,\n    paddingZeros: 0,\n  },\n  unitOfMeasurementResult: {\n    decimalPlaces: 2,\n  },\n  percentageResult: {\n    decimalPlaces: 2,\n  },\n};\n","import { Value, ValueType, type MatrixData, type MatrixEntry, type RangeData, type ColourData, type SplitData, type SplitShare } from \"@solve-js/vm/Value\";\nimport { formatColour } from \"@solve-js/packages/colour/ColourMath\";\nimport { decimalToFixed, type DecimalData } from \"@solve-js/decimal\";\nimport { getLocale, type ILocale } from \"@solve-js/constants/locales\";\nimport { autoFormatIntegerOrFloat } from \"@solve-js/utilities/Number\";\nimport { FormattingSettings, DEFAULT_FORMATTING_SETTINGS } from \"./FormattingSettings\";\nimport { CURRENCY_DISPLAY } from \"@solve-js/uom/CurrencyAliases\";\nimport { columnMajorToRowMajor } from \"@solve-js/vm/MatrixOps\";\nimport { formatSymbolic, type SymbolicNode } from \"@solve-js/symbolic\";\n\nfunction formatNumber(value: number, locale: ILocale, settings: FormattingSettings, decimalPlaces?: number): string {\n  const sep = settings.floatResult.enableSeperator;\n  const loc = settings.numberResult.decimalSeparatorLocale;\n  // An explicit precision (`3.14159 to 4 dp`, `round(1.5, 2)`) shows EXACTLY that\n  // many places with trailing zeros kept, where the default trims them and shows\n  // an integer with none. The value was already rounded to this precision when\n  // it was set (see VMBuiltins' roundToPlaces, exact where an exact decimal was\n  // there), so rendering it to the same place count reproduces that rounding.\n  if (decimalPlaces !== undefined && Number.isFinite(value)) {\n    const formatted = value.toLocaleString(loc || \"en-US\", {\n      minimumFractionDigits: decimalPlaces,\n      maximumFractionDigits: decimalPlaces,\n      useGrouping: sep,\n    });\n    return `${locale.display.resultPrefix}${formatted}`;\n  }\n  const dp = settings.floatResult.decimalPlaces;\n  const formatted = autoFormatIntegerOrFloat(value, dp, sep, loc);\n  return `${locale.display.resultPrefix}${formatted}`;\n}\n\n/**\n * Renders a measurement that carries a one-sigma uncertainty as\n * `center ± spread`, e.g. `49.2 ± 2.0`.\n *\n * The center is shown the way any number is, whole numbers as integers and\n * trailing zeros trimmed, so a tolerance-free-looking center still reads\n * cleanly (\"30 ± 2.24\", not \"30.00 ± 2.24\"). The spread is shown to the same\n * decimal-place budget but always keeps at least one fractional digit, which is\n * what distinguishes it as a tolerance and gives \"± 2.0\" rather than \"± 2\".\n * Both use `Intl` with `maximumFractionDigits`, so the trailing-zero trimming is\n * locale-correct (a comma-decimal locale is not string-sliced on \".\").\n *\n * The symbol is always the `±` glyph on output, even when the input was the\n * ASCII `+/-`, since the glyph is the conventional notation and unambiguous to\n * read back.\n */\nfunction formatUncertain(center: number, uncertainty: number, locale: ILocale, settings: FormattingSettings): string {\n  const dp = settings.floatResult.decimalPlaces;\n  const useGrouping = settings.floatResult.enableSeperator;\n  const loc = settings.numberResult.decimalSeparatorLocale || \"en-US\";\n  // The spread needs room for at least one fractional digit, so a zero-decimal\n  // budget cannot leave minimumFractionDigits above maximumFractionDigits.\n  const spreadMax = Math.max(dp, 1);\n  const centerText = center.toLocaleString(loc, { useGrouping, minimumFractionDigits: 0, maximumFractionDigits: dp });\n  const spreadText = Math.abs(uncertainty).toLocaleString(loc, { useGrouping, minimumFractionDigits: 1, maximumFractionDigits: spreadMax });\n  return `${locale.display.resultPrefix}${centerText} ± ${spreadText}`;\n}\n\n/**\n * Renders a number in whichever base it is tagged with.\n *\n * The zero padding is a hexadecimal setting and stays one. Applying it to a\n * binary rendering would pad `0b101` out to the same digit count as a hex\n * value, which is a different quantity of zeros and not what the setting asks\n * for.\n */\nfunction formatHex(value: number | bigint, settings: FormattingSettings, base?: string): string {\n  // An infinity or a NaN has no digits in any base, and asking for them\n  // produced `0xINFINITY`, a literal that reads back as nothing at all. Render\n  // the value itself, which is what every other non-finite result shows.\n  if (typeof value === \"number\" && !Number.isFinite(value)) return `= ${value}`;\n\n  // Truncate and take the sign off before converting. `Number.toString(radix)`\n  // does neither: it renders -255 as \"-ff\", which lands the minus inside the\n  // literal as `0x-FF`, and it renders 255.7 as \"ff.b3333333333\", inventing\n  // fractional hex digits for a notation that has no use for them. Both were\n  // visible on `as hex` until the builtins started sharing this path.\n  //\n  // A bigint needs neither truncation nor a Math call, and must not be routed\n  // through one: passing it to Math.trunc() throws, and converting it to a\n  // double first is exactly the precision loss it is carried as a bigint to\n  // avoid.\n  const negative = typeof value === \"bigint\" ? value < 0n : value < 0;\n  const sign = negative ? \"-\" : \"\";\n  const digits = (radix: number): string =>\n    typeof value === \"bigint\"\n      ? (negative ? -value : value).toString(radix)\n      : Math.abs(Math.trunc(value)).toString(radix);\n\n  if (base === \"bin\") return `= ${sign}0b${digits(2)}`;\n  if (base === \"oct\") return `= ${sign}0o${digits(8)}`;\n  const padding = settings.hexResult.enablePadding ? settings.hexResult.paddingZeros : 0;\n  const hex = digits(16).toUpperCase().padStart(padding, \"0\");\n  return `= ${sign}0x${hex}`;\n}\n\n/**\n * How many decimal digits of an exact integer this will render in full.\n *\n * A little above the ~19,729 digits of the largest bigint the VM will build\n * (`vm/VM.ts`'s MAX_EXACT_POW_BITS / MAX_EXACT_SHIFT_BITS, 65,536 bits), so\n * every value the engine can produce through `^` or `<<` still prints exactly\n * and this ceiling only ever meets a value that came from somewhere else.\n */\nconst MAX_DISPLAYED_BIGINT_DIGITS = 20000;\n\n/**\n * Renders an exact integer, or describes it when writing it out is itself the\n * expensive operation.\n *\n * This used to be a bare `= ${value}` template, which renders whatever it is\n * handed: `1n << 100000000` took 8.5 seconds here turning a 12.5MB integer\n * into a thirty-million-character string, and a host has no way to opt out,\n * since displaying the answer is what it asked the engine for. The VM's own\n * ceiling on `<<` and `^` now stops that value existing, so this is the\n * backstop for every other way a large bigint can arrive (repeated `x * x`,\n * a Value a host built itself), and it costs one comparison for every value\n * that is not absurd.\n *\n * The digit count is estimated from the bit length rather than measured, since\n * measuring means doing the conversion this exists to avoid. Bit length comes\n * off the hexadecimal form, which is linear in the size of the value where the\n * decimal form is not.\n */\nfunction formatBigInt(value: bigint): string {\n  const magnitude = value < 0n ? -value : value;\n  // Every bigint a person actually reads takes this line and nothing else:\n  // anything a double can hold is at most 309 digits, so it is printable\n  // without measuring it at all.\n  if (Number.isFinite(Number(magnitude))) return `= ${value}`;\n  const bits = magnitude.toString(16).length * 4;\n  if (bits * Math.LN2 / Math.LN10 <= MAX_DISPLAYED_BIGINT_DIGITS) return `= ${value}`;\n  const log10 = bits * Math.LN2 / Math.LN10;\n  const exponent = Math.floor(log10);\n  const mantissa = Math.pow(10, log10 - exponent);\n  const sign = value < 0n ? \"-\" : \"\";\n  return `= ${sign}~${mantissa.toFixed(3)}e+${exponent} (an exact integer of about ${(exponent + 1).toLocaleString(\"en-US\")} digits, too large to print)`;\n}\n\nfunction formatString(value: string): string {\n  return `= ${value}`;\n}\n\nfunction formatBoolean(value: boolean): string {\n  return `= ${value}`;\n}\n\n/**\n * Renders a Datetime value locale-aware, the previous implementation\n * called `d.toLocaleString()` with no arguments, which always uses the JS\n * runtime's own default locale and never actually consulted `locale.code`\n * despite receiving it as a parameter (both branches of its old\n * `dateFormat === \"default\"` check were byte-for-byte identical, dead\n * groundwork for a distinction that was never implemented). Concretely,\n * this meant every configured locale (including the shipped German one)\n * always displayed weekday/month names in English. See GitHub issue #77.\n *\n * Uses `weekday`/`month`: \"long\" for a spelled-out date (\"Monday,\n * November 17, 2025\" / \"lundi 17 novembre 2025\") since that's what a\n * literal weekday name is for; a bare numeric date doesn't need\n * localizing beyond the decimal/thousands separators `formatNumber()`\n * already handles. The time-of-day portion is only appended when it's\n * not exactly local midnight, bare date literals (\"today\", \"17/11/2025\")\n * always anchor to local midnight, and showing \"00:00:00\" on every one of\n * those would be noise, not information.\n */\nfunction formatDatetime(value: number, locale: ILocale): string {\n  const d = new Date(value);\n  const dateStr = d.toLocaleDateString(locale.code, { weekday: \"long\", year: \"numeric\", month: \"long\", day: \"numeric\" });\n  const isMidnight = d.getHours() === 0 && d.getMinutes() === 0 && d.getSeconds() === 0 && d.getMilliseconds() === 0;\n  if (isMidnight) return `= ${dateStr}`;\n  return `= ${dateStr}, ${d.toLocaleTimeString(locale.code)}`;\n}\n\n/**\n * Renders a millisecond duration as clock-style `H:MM` (or `H:MM:SS` when\n * there's a non-zero seconds component). `ms` is never a user-typeable\n * unit (confirmed: it appears nowhere in `lexer/units.ts`), it's only\n * ever produced by subtracting two clock times/datetimes (`9:30 - 8:30`,\n * `VM.ts`'s Datetime SUB case), so this is a safe, narrow special case,\n * not a general change to how durations display.\n */\nfunction formatMsDuration(ms: number): string {\n  const sign = ms < 0 ? \"-\" : \"\";\n  const totalSeconds = Math.round(Math.abs(ms) / 1000);\n  const hours = Math.floor(totalSeconds / 3600);\n  const minutes = Math.floor((totalSeconds % 3600) / 60);\n  const seconds = totalSeconds % 60;\n  const mm = String(minutes).padStart(2, \"0\");\n  if (seconds === 0) return `${sign}${hours}:${mm}`;\n  const ss = String(seconds).padStart(2, \"0\");\n  return `${sign}${hours}:${mm}:${ss}`;\n}\n\nfunction formatUom(value: number, unit: string | undefined, locale: ILocale, settings: FormattingSettings, exact?: DecimalData): string {\n  if (unit === \"ms\") return `= ${formatMsDuration(value)}`;\n\n  const dp = settings.unitOfMeasurementResult.decimalPlaces;\n\n  // For TimeSpan values (days, weeks, hours, etc.), format as integer if the value is a whole number\n  const timeSpanUnits = [\"days\", \"weeks\", \"months\", \"years\", \"hours\", \"minutes\", \"seconds\", \"day\", \"week\", \"month\", \"year\", \"hour\", \"minute\", \"second\"];\n  const isTimeSpan = unit && timeSpanUnits.includes(unit);\n\n  let formatted: string;\n  if (isTimeSpan && value === Math.floor(value)) {\n    // For whole number TimeSpan values, format as integer\n    formatted = value.toString();\n  } else {\n    // For other values, use the configured decimal places\n    formatted = value.toFixed(dp);\n  }\n\n  // Currency display: symbol + culturally-conventional placement (e.g.\n  // \"$100.00\" prefix vs \"100.00 kr\" suffix) instead of the generic\n  // \"amount CODE\" fallback below. See uom/CurrencyAliases.ts's\n  // CURRENCY_DISPLAY table for the exact set covered and the reasoning\n  // behind each placement choice. Any currency code NOT in that table\n  // (most of the ~150 `CurrencyExchange.isCurrency()` recognizes) falls\n  // through to the unchanged \"amount CODE\" format below.\n  const currencyDisplay = unit ? CURRENCY_DISPLAY[unit.toUpperCase()] : undefined;\n  if (currencyDisplay) {\n    // An exact money amount rounds from its decimal, not from the double: a\n    // half-cent like \"$1.005\" reads as \"$1.01\" here, where \"(1.005).toFixed(2)\"\n    // answers \"1.00\" because the double it is handed already sits below the\n    // value the user typed. Amounts with no exact decimal (a currency\n    // conversion, whose rate is a double) keep the toFixed rendering above.\n    const moneyText = exact ? decimalToFixed(exact, dp) : formatted;\n    const sep = currencyDisplay.spaced ? \" \" : \"\";\n    const withSymbol = currencyDisplay.position === \"prefix\"\n      ? `${currencyDisplay.symbol}${sep}${moneyText}`\n      : `${moneyText}${sep}${currencyDisplay.symbol}`;\n    return `= ${withSymbol}`;\n  }\n\n  // The unit is written as the symbol the value carries. There used to be a\n  // `unitOfMeasurementResult.unitNames` setting here whose two branches were\n  // the same expression, so it never changed anything, and it was removed\n  // rather than implemented: the engine has no unit-name data to render from.\n  // The generated unit table maps a spelling to [measure, ratio] only, and\n  // names cannot be recovered from it, because units that differ by an OFFSET\n  // share a ratio, so \"20 C\" would come back as \"20 kelvins\". A real\n  // implementation needs a hand-authored name per unit plus pluralization and\n  // per-locale spelling (metre against meter), which is a feature rather than\n  // the repair of a dead ternary.\n  //\n  // An exact currency with no symbol in the display table above (one of the\n  // less common ISO codes) still rounds from its decimal here, so \"1.005 UYW\"\n  // reads the same way \"$1.005\" does. Non-currency Uoms never carry an exact,\n  // so this leaves \"1.50 kg\" exactly as it was.\n  const genericText = exact ? decimalToFixed(exact, dp) : formatted;\n  return `= ${genericText} ${unit || \"\"}`.trim();\n}\n\nfunction formatMatrixEntry(entry: MatrixEntry, settings: FormattingSettings): string {\n  if (typeof entry === \"boolean\") return entry ? \"true\" : \"false\";\n  if (typeof entry === \"object\" && entry !== null) return formatSymbolic(entry);\n  const dp = settings.floatResult.decimalPlaces;\n  const sep = settings.floatResult.enableSeperator;\n  const loc = settings.numberResult.decimalSeparatorLocale;\n  return autoFormatIntegerOrFloat(entry, dp, sep, loc);\n}\n\n/**\n * Renders a Matrix matching its own literal syntax: a single row (1xN,\n * including plain vectors) as `[a, b, c]`, a single column (Nx1) as\n * `[a; b; c]`, and a general shape as `[r0c0, r0c1; r1c0, r1c1]`, row-major\n * textual output read back out of the column-major storage\n * (`columnMajorToRowMajor()`), matching how `[1,2;3,4]` is written.\n */\nfunction formatMatrix(m: MatrixData, locale: ILocale, settings: FormattingSettings): string {\n  const rowMajor = columnMajorToRowMajor(m);\n  const rows: string[] = [];\n  for (let r = 0; r < m.rows; r++) {\n    const cells: string[] = [];\n    for (let c = 0; c < m.cols; c++) {\n      cells.push(formatMatrixEntry(rowMajor[r * m.cols + c], settings));\n    }\n    rows.push(cells.join(\", \"));\n  }\n  return `${locale.display.resultPrefix}[${rows.join(\"; \")}]`;\n}\n\n/**\n * Render a matrix as a multi-line, column-aligned block: one row per line (the\n * newline is where {@link formatValue}'s compact form writes `;`), each column\n * right-padded to its widest cell, and every row wrapped in `[ ... ]`. For\n * display where a grid reads better than a line, e.g. a docs notepad or a REPL:\n *\n * ```text\n * [  1   2 ]\n * [ 30   4 ]\n * ```\n *\n * This is deliberately separate from {@link formatValue}, whose single-line\n * matrix form stays the stable, assertable text the API and the worker DTO use.\n * A 1xN row vector is one line; an Nx1 column vector is N lines.\n */\nexport function formatMatrixAligned(m: MatrixData, settings?: FormattingSettings): string {\n  const us = settings || DEFAULT_FORMATTING_SETTINGS;\n  const rowMajor = columnMajorToRowMajor(m);\n  const cells: string[][] = [];\n  for (let r = 0; r < m.rows; r++) {\n    const row: string[] = [];\n    for (let c = 0; c < m.cols; c++) {\n      row.push(formatMatrixEntry(rowMajor[r * m.cols + c], us));\n    }\n    cells.push(row);\n  }\n  const colWidth: number[] = [];\n  for (let c = 0; c < m.cols; c++) {\n    let width = 0;\n    for (let r = 0; r < m.rows; r++) width = Math.max(width, cells[r][c].length);\n    colWidth.push(width);\n  }\n  return cells\n    .map((row) => `[ ${row.map((cell, c) => cell.padStart(colWidth[c])).join(\"  \")} ]`)\n    .join(\"\\n\");\n}\n\nfunction formatRange(min: number, max: number, locale: ILocale): string {\n  return `${locale.display.resultPrefix}${min}:${max}`;\n}\n\nfunction formatPercentage(value: number, locale: ILocale, settings: FormattingSettings): string {\n  // ValueType.Percentage stores a fraction (0.25 for 25%). See Value.ts's\n  // documented contract and the sole producer, VM.ts's TO_PERCENTAGE opcode\n  // (`right/left - 1`, e.g. 0.25 for \"800 to 1000\"). Multiply by 100 before\n  // formatting; without this every percentage-change result displayed as\n  // e.g. \"0.25%\" instead of \"25.00%\".\n  const dp = settings.percentageResult.decimalPlaces;\n  const formatted = (value * 100).toFixed(dp);\n  return `= ${formatted}${locale.display.percentageSuffix}`;\n}\n\nfunction formatUnit(value: number, unit: string | undefined): string {\n  return `= ${value} ${unit || \"\"}`.trim();\n}\n\n/**\n * Renders a per-person bill split: \"= $45.00 each\", or, when the division is\n * uneven, \"= $33.33 each, with 1 share paying $33.34\". Each share's amount is\n * rendered through the ordinary value formatter (a throwaway {@link Value}), so\n * a currency share honours the same symbol placement, decimal places and locale\n * as any other money and a bare share trims trailing zeros the way a plain\n * number does; the \"= \" prefix is added once, around the whole sentence, not\n * per share.\n */\nfunction formatSplit(data: SplitData, locale: ILocale, settings: FormattingSettings): string {\n  const prefix = locale.display.resultPrefix;\n  const render = (share: SplitShare): string => {\n    const v = data.unit !== undefined\n      ? new Value(ValueType.Uom, share.value, data.unit)\n      : new Value(ValueType.Number, share.value);\n    v.exact = share.exact;\n    const text = formatValue(v, settings);\n    return text.startsWith(prefix) ? text.slice(prefix.length) : text;\n  };\n\n  const [base, high] = data.shares;\n  const each = `${render(base)} each`;\n  if (high === undefined) return `${prefix}${each}`;\n  const shareWord = high.count === 1 ? \"share\" : \"shares\";\n  return `${prefix}${each}, with ${high.count} ${shareWord} paying ${render(high)}`;\n}\n\n/**\n * Render an evaluated {@link Value} as a display string, dispatching on\n * `value.type` to the type-specific formatter (number, hex, datetime, unit\n * of measurement, matrix, range, percentage, ...).\n *\n * Most branches produce a `\"= \"`-prefixed result string (matching the\n * plugin's inline-result convention); `ValueType.Error` is the one\n * exception, it returns the human-readable error message directly\n * (stored in `value.unit`), not an `\"= \"`-prefixed string.\n *\n * @param value - The evaluated value to format.\n * @param settings - Locale/precision/separator options; defaults to\n *   {@link DEFAULT_FORMATTING_SETTINGS} when omitted.\n * @example\n * ```typescript\n * const value = engine.evaluateExpression(\"10 USD to GBP\");\n * formatValue(value); // \"= £7.85\" (exact output depends on live exchange rates)\n * ```\n */\nexport function formatValue(value: Value, settings?: FormattingSettings): string {\n  const us = settings || DEFAULT_FORMATTING_SETTINGS;\n  const localeCode = us.numberResult.decimalSeparatorLocale || \"en\";\n  const locale = getLocale(localeCode);\n\n  switch (value.type) {\n    case ValueType.Number:\n      // A measurement with a tolerance renders as \"center ± spread\"; every\n      // other number is unchanged, so a plain value is byte-for-byte what it was.\n      if (value.uncertainty !== undefined) {\n        return formatUncertain(value.value as number, value.uncertainty, locale, us);\n      }\n      return formatNumber(value.value as number, locale, us, value.decimalPlaces);\n    case ValueType.Hex:\n      return formatHex(value.value as number | bigint, us, value.unit);\n    case ValueType.BigInt:\n      return formatBigInt(value.value as bigint);\n    case ValueType.String:\n      return formatString(value.value as string);\n    case ValueType.Boolean:\n      return formatBoolean(value.value as boolean);\n    case ValueType.Datetime:\n      return formatDatetime(value.value as number, locale);\n    case ValueType.Uom:\n      return formatUom(value.value as number, value.unit, locale, us, value.exact);\n    case ValueType.Matrix:\n      return formatMatrix(value.value as MatrixData, locale, us);\n    case ValueType.Range: {\n      const r = value.value as RangeData;\n      return formatRange(r.min, r.max, locale);\n    }\n    case ValueType.Colour:\n      return `${locale.display.resultPrefix}${formatColour(value.value as ColourData)}`;\n    case ValueType.Split:\n      return formatSplit(value.value as SplitData, locale, us);\n    case ValueType.Symbolic:\n      return formatSymbolic(value.value as SymbolicNode);\n    case ValueType.Percentage:\n      return formatPercentage(value.value as number, locale, us);\n    case ValueType.Unit:\n      return formatUnit(value.value as number, value.unit);\n    case ValueType.Error:\n      // errorValue(code, message) stores the human-readable message in\n      // `.unit` (code goes in `.value`), falling through to the default\n      // case here previously displayed the raw code (e.g.\n      // \"CURRENCY_RATE_UNAVAILABLE\") instead of the actual message.\n      return value.unit ?? String(value.value);\n    default:\n      return `= ${String(value.value)}`;\n  }\n}\n"]}

package/dist/chunk-J4LZD4ZY.js

@@ -1,3 +0,0 @@
-import {a as a$1}from'./chunk-XEIDV5JP.js';import {g}from'./chunk-R2ENWQ76.js';import {Z,R as R$1,ua,sa}from'./chunk-RSF25YSJ.js';import {m}from'./chunk-EVAOPEO4.js';import {a}from'./chunk-62LMTO4F.js';var b={floatResult:{decimalPlaces:2,enableSeperator:true},numberResult:{decimalSeparatorLocale:"en-US"},hexResult:{enablePadding:false,paddingZeros:0},unitOfMeasurementResult:{decimalPlaces:2},percentageResult:{decimalPlaces:2}};function D(t,r,e,o){let n=e.floatResult.enableSeperator,i=e.numberResult.decimalSeparatorLocale;if(o!==void 0&&Number.isFinite(t)){let c=t.toLocaleString(i||"en-US",{minimumFractionDigits:o,maximumFractionDigits:o,useGrouping:n});return `${r.display.resultPrefix}${c}`}let a=e.floatResult.decimalPlaces,s=a$1(t,a,n,i);return `${r.display.resultPrefix}${s}`}function R(t,r,e,o){let n=o.floatResult.decimalPlaces,i=o.floatResult.enableSeperator,a=o.numberResult.decimalSeparatorLocale||"en-US",s=Math.max(n,1),c=t.toLocaleString(a,{useGrouping:i,minimumFractionDigits:0,maximumFractionDigits:n}),u=Math.abs(r).toLocaleString(a,{useGrouping:i,minimumFractionDigits:1,maximumFractionDigits:s});return `${e.display.resultPrefix}${c} \xB1 ${u}`}function F(t,r,e){if(typeof t=="number"&&!Number.isFinite(t))return `= ${t}`;let o=typeof t=="bigint"?t<0n:t<0,n=o?"-":"",i=c=>typeof t=="bigint"?(o?-t:t).toString(c):Math.abs(Math.trunc(t)).toString(c);if(e==="bin")return `= ${n}0b${i(2)}`;if(e==="oct")return `= ${n}0o${i(8)}`;let a=r.hexResult.enablePadding?r.hexResult.paddingZeros:0,s=i(16).toUpperCase().padStart(a,"0");return `= ${n}0x${s}`}var L=2e4;function P(t){let r=t<0n?-t:t;if(Number.isFinite(Number(r)))return `= ${t}`;let e=r.toString(16).length*4;if(e*Math.LN2/Math.LN10<=L)return `= ${t}`;let o=e*Math.LN2/Math.LN10,n=Math.floor(o),i=Math.pow(10,o-n);return `= ${t<0n?"-":""}~${i.toFixed(3)}e+${n} (an exact integer of about ${(n+1).toLocaleString("en-US")} digits, too large to print)`}function I(t){return `= ${t}`}function T(t){return `= ${t}`}function w(t,r){let e=new Date(t),o=e.toLocaleDateString(r.code,{weekday:"long",year:"numeric",month:"long",day:"numeric"});return e.getHours()===0&&e.getMinutes()===0&&e.getSeconds()===0&&e.getMilliseconds()===0?`= ${o}`:`= ${o}, ${e.toLocaleTimeString(r.code)}`}function N(t){let r=t<0?"-":"",e=Math.round(Math.abs(t)/1e3),o=Math.floor(e/3600),n=Math.floor(e%3600/60),i=e%60,a=String(n).padStart(2,"0");if(i===0)return `${r}${o}:${a}`;let s=String(i).padStart(2,"0");return `${r}${o}:${a}:${s}`}function U(t,r,e,o,n){if(r==="ms")return `= ${N(t)}`;let i=o.unitOfMeasurementResult.decimalPlaces,s=r&&["days","weeks","months","years","hours","minutes","seconds","day","week","month","year","hour","minute","second"].includes(r),c;s&&t===Math.floor(t)?c=t.toString():c=t.toFixed(i);let u=r?ua[r.toUpperCase()]:void 0;if(u){let m=n?sa(n,i):c,$=u.spaced?" ":"";return `= ${u.position==="prefix"?`${u.symbol}${$}${m}`:`${m}${$}${u.symbol}`}`}return `= ${n?sa(n,i):c} ${r||""}`.trim()}function M(t,r){if(typeof t=="boolean")return t?"true":"false";if(typeof t=="object"&&t!==null)return R$1(t);let e=r.floatResult.decimalPlaces,o=r.floatResult.enableSeperator,n=r.numberResult.decimalSeparatorLocale;return a$1(t,e,o,n)}function E(t,r,e){let o=Z(t),n=[];for(let i=0;i<t.rows;i++){let a=[];for(let s=0;s<t.cols;s++)a.push(M(o[i*t.cols+s],e));n.push(a.join(", "));}return `${r.display.resultPrefix}[${n.join("; ")}]`}function Q(t,r){let e=r||b,o=Z(t),n=[];for(let a=0;a<t.rows;a++){let s=[];for(let c=0;c<t.cols;c++)s.push(M(o[a*t.cols+c],e));n.push(s);}let i=[];for(let a=0;a<t.cols;a++){let s=0;for(let c=0;c<t.rows;c++)s=Math.max(s,n[c][a].length);i.push(s);}return n.map(a=>`[ ${a.map((s,c)=>s.padStart(i[c])).join("  ")} ]`).join(`
-`)}function j(t,r,e){return `${e.display.resultPrefix}${t}:${r}`}function C(t,r,e){let o=e.percentageResult.decimalPlaces;return `= ${(t*100).toFixed(o)}${r.display.percentageSuffix}`}function A(t,r){return `= ${t} ${r||""}`.trim()}function G(t,r,e){let o=r.display.resultPrefix,n=u=>{let l=t.unit!==void 0?new m(6,u.value,t.unit):new m(0,u.value);l.exact=u.exact;let m$1=_(l,e);return m$1.startsWith(o)?m$1.slice(o.length):m$1},[i,a]=t.shares,s=`${n(i)} each`;if(a===void 0)return `${o}${s}`;let c=a.count===1?"share":"shares";return `${o}${s}, with ${a.count} ${c} paying ${n(a)}`}function _(t,r){let e=r||b,o=e.numberResult.decimalSeparatorLocale||"en",n=a(o);switch(t.type){case 0:return t.uncertainty!==void 0?R(t.value,t.uncertainty,n,e):D(t.value,n,e,t.decimalPlaces);case 1:return F(t.value,e,t.unit);case 2:return P(t.value);case 3:return I(t.value);case 10:return T(t.value);case 4:return w(t.value,n);case 6:return U(t.value,t.unit,n,e,t.exact);case 7:return E(t.value,n,e);case 8:{let i=t.value;return j(i.min,i.max,n)}case 14:return `${n.display.resultPrefix}${g(t.value)}`;case 15:return G(t.value,n,e);case 9:return R$1(t.value);case 5:return C(t.value,n,e);case 11:return A(t.value,t.unit);case 13:return t.unit??String(t.value);default:return `= ${String(t.value)}`}}export{b as a,Q as b,_ as c};//# sourceMappingURL=chunk-J4LZD4ZY.js.map
-//# sourceMappingURL=chunk-J4LZD4ZY.js.map

package/dist/chunk-J4LZD4ZY.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/format/FormattingSettings.ts","../src/format/FormatEngine.ts"],"names":["DEFAULT_FORMATTING_SETTINGS","formatNumber","value","locale","settings","decimalPlaces","sep","loc","formatted","dp","autoFormatIntegerOrFloat","formatUncertain","center","uncertainty","useGrouping","spreadMax","centerText","spreadText","formatHex","base","negative","sign","digits","radix","padding","hex","MAX_DISPLAYED_BIGINT_DIGITS","formatBigInt","magnitude","bits","log10","exponent","mantissa","formatString","formatBoolean","formatDatetime","d","dateStr","formatMsDuration","ms","totalSeconds","hours","minutes","seconds","mm","ss","formatUom","unit","exact","isTimeSpan","currencyDisplay","CURRENCY_DISPLAY","moneyText","decimalToFixed","formatMatrixEntry","entry","formatSymbolic","formatMatrix","m","rowMajor","columnMajorToRowMajor","rows","r","cells","c","formatMatrixAligned","us","row","colWidth","width","cell","formatRange","min","max","formatPercentage","formatUnit","formatSplit","data","prefix","render","share","v","Value","text","formatValue","high","each","shareWord","localeCode","getLocale","formatColour"],"mappings":"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","file":"chunk-J4LZD4ZY.js","sourcesContent":["/**\n * Minimal formatting settings interface for the engine\n * This allows the engine to format values without depending on app-specific settings\n */\nexport interface FormattingSettings {\n  floatResult: {\n    decimalPlaces: number;\n    enableSeperator: boolean;\n  };\n  numberResult: {\n    decimalSeparatorLocale: string;\n  };\n  hexResult: {\n    enablePadding: boolean;\n    paddingZeros: number;\n  };\n  unitOfMeasurementResult: {\n    decimalPlaces: number;\n  };\n  percentageResult: {\n    decimalPlaces: number;\n  };\n}\n\n/** Formatting used when a host supplies none. */\nexport const DEFAULT_FORMATTING_SETTINGS: FormattingSettings = {\n  floatResult: {\n    decimalPlaces: 2,\n    enableSeperator: true,\n  },\n  numberResult: {\n    decimalSeparatorLocale: \"en-US\",\n  },\n  hexResult: {\n    enablePadding: false,\n    paddingZeros: 0,\n  },\n  unitOfMeasurementResult: {\n    decimalPlaces: 2,\n  },\n  percentageResult: {\n    decimalPlaces: 2,\n  },\n};\n","import { Value, ValueType, type MatrixData, type MatrixEntry, type RangeData, type ColourData, type SplitData, type SplitShare } from \"@solve-js/vm/Value\";\nimport { formatColour } from \"@solve-js/packages/colour/ColourMath\";\nimport { decimalToFixed, type DecimalData } from \"@solve-js/decimal\";\nimport { getLocale, type ILocale } from \"@solve-js/constants/locales\";\nimport { autoFormatIntegerOrFloat } from \"@solve-js/utilities/Number\";\nimport { FormattingSettings, DEFAULT_FORMATTING_SETTINGS } from \"./FormattingSettings\";\nimport { CURRENCY_DISPLAY } from \"@solve-js/uom/CurrencyAliases\";\nimport { columnMajorToRowMajor } from \"@solve-js/vm/MatrixOps\";\nimport { formatSymbolic, type SymbolicNode } from \"@solve-js/symbolic\";\n\nfunction formatNumber(value: number, locale: ILocale, settings: FormattingSettings, decimalPlaces?: number): string {\n  const sep = settings.floatResult.enableSeperator;\n  const loc = settings.numberResult.decimalSeparatorLocale;\n  // An explicit precision (`3.14159 to 4 dp`, `round(1.5, 2)`) shows EXACTLY that\n  // many places with trailing zeros kept, where the default trims them and shows\n  // an integer with none. The value was already rounded to this precision when\n  // it was set (see VMBuiltins' roundToPlaces, exact where an exact decimal was\n  // there), so rendering it to the same place count reproduces that rounding.\n  if (decimalPlaces !== undefined && Number.isFinite(value)) {\n    const formatted = value.toLocaleString(loc || \"en-US\", {\n      minimumFractionDigits: decimalPlaces,\n      maximumFractionDigits: decimalPlaces,\n      useGrouping: sep,\n    });\n    return `${locale.display.resultPrefix}${formatted}`;\n  }\n  const dp = settings.floatResult.decimalPlaces;\n  const formatted = autoFormatIntegerOrFloat(value, dp, sep, loc);\n  return `${locale.display.resultPrefix}${formatted}`;\n}\n\n/**\n * Renders a measurement that carries a one-sigma uncertainty as\n * `center ± spread`, e.g. `49.2 ± 2.0`.\n *\n * The center is shown the way any number is, whole numbers as integers and\n * trailing zeros trimmed, so a tolerance-free-looking center still reads\n * cleanly (\"30 ± 2.24\", not \"30.00 ± 2.24\"). The spread is shown to the same\n * decimal-place budget but always keeps at least one fractional digit, which is\n * what distinguishes it as a tolerance and gives \"± 2.0\" rather than \"± 2\".\n * Both use `Intl` with `maximumFractionDigits`, so the trailing-zero trimming is\n * locale-correct (a comma-decimal locale is not string-sliced on \".\").\n *\n * The symbol is always the `±` glyph on output, even when the input was the\n * ASCII `+/-`, since the glyph is the conventional notation and unambiguous to\n * read back.\n */\nfunction formatUncertain(center: number, uncertainty: number, locale: ILocale, settings: FormattingSettings): string {\n  const dp = settings.floatResult.decimalPlaces;\n  const useGrouping = settings.floatResult.enableSeperator;\n  const loc = settings.numberResult.decimalSeparatorLocale || \"en-US\";\n  // The spread needs room for at least one fractional digit, so a zero-decimal\n  // budget cannot leave minimumFractionDigits above maximumFractionDigits.\n  const spreadMax = Math.max(dp, 1);\n  const centerText = center.toLocaleString(loc, { useGrouping, minimumFractionDigits: 0, maximumFractionDigits: dp });\n  const spreadText = Math.abs(uncertainty).toLocaleString(loc, { useGrouping, minimumFractionDigits: 1, maximumFractionDigits: spreadMax });\n  return `${locale.display.resultPrefix}${centerText} ± ${spreadText}`;\n}\n\n/**\n * Renders a number in whichever base it is tagged with.\n *\n * The zero padding is a hexadecimal setting and stays one. Applying it to a\n * binary rendering would pad `0b101` out to the same digit count as a hex\n * value, which is a different quantity of zeros and not what the setting asks\n * for.\n */\nfunction formatHex(value: number | bigint, settings: FormattingSettings, base?: string): string {\n  // An infinity or a NaN has no digits in any base, and asking for them\n  // produced `0xINFINITY`, a literal that reads back as nothing at all. Render\n  // the value itself, which is what every other non-finite result shows.\n  if (typeof value === \"number\" && !Number.isFinite(value)) return `= ${value}`;\n\n  // Truncate and take the sign off before converting. `Number.toString(radix)`\n  // does neither: it renders -255 as \"-ff\", which lands the minus inside the\n  // literal as `0x-FF`, and it renders 255.7 as \"ff.b3333333333\", inventing\n  // fractional hex digits for a notation that has no use for them. Both were\n  // visible on `as hex` until the builtins started sharing this path.\n  //\n  // A bigint needs neither truncation nor a Math call, and must not be routed\n  // through one: passing it to Math.trunc() throws, and converting it to a\n  // double first is exactly the precision loss it is carried as a bigint to\n  // avoid.\n  const negative = typeof value === \"bigint\" ? value < 0n : value < 0;\n  const sign = negative ? \"-\" : \"\";\n  const digits = (radix: number): string =>\n    typeof value === \"bigint\"\n      ? (negative ? -value : value).toString(radix)\n      : Math.abs(Math.trunc(value)).toString(radix);\n\n  if (base === \"bin\") return `= ${sign}0b${digits(2)}`;\n  if (base === \"oct\") return `= ${sign}0o${digits(8)}`;\n  const padding = settings.hexResult.enablePadding ? settings.hexResult.paddingZeros : 0;\n  const hex = digits(16).toUpperCase().padStart(padding, \"0\");\n  return `= ${sign}0x${hex}`;\n}\n\n/**\n * How many decimal digits of an exact integer this will render in full.\n *\n * A little above the ~19,729 digits of the largest bigint the VM will build\n * (`vm/VM.ts`'s MAX_EXACT_POW_BITS / MAX_EXACT_SHIFT_BITS, 65,536 bits), so\n * every value the engine can produce through `^` or `<<` still prints exactly\n * and this ceiling only ever meets a value that came from somewhere else.\n */\nconst MAX_DISPLAYED_BIGINT_DIGITS = 20000;\n\n/**\n * Renders an exact integer, or describes it when writing it out is itself the\n * expensive operation.\n *\n * This used to be a bare `= ${value}` template, which renders whatever it is\n * handed: `1n << 100000000` took 8.5 seconds here turning a 12.5MB integer\n * into a thirty-million-character string, and a host has no way to opt out,\n * since displaying the answer is what it asked the engine for. The VM's own\n * ceiling on `<<` and `^` now stops that value existing, so this is the\n * backstop for every other way a large bigint can arrive (repeated `x * x`,\n * a Value a host built itself), and it costs one comparison for every value\n * that is not absurd.\n *\n * The digit count is estimated from the bit length rather than measured, since\n * measuring means doing the conversion this exists to avoid. Bit length comes\n * off the hexadecimal form, which is linear in the size of the value where the\n * decimal form is not.\n */\nfunction formatBigInt(value: bigint): string {\n  const magnitude = value < 0n ? -value : value;\n  // Every bigint a person actually reads takes this line and nothing else:\n  // anything a double can hold is at most 309 digits, so it is printable\n  // without measuring it at all.\n  if (Number.isFinite(Number(magnitude))) return `= ${value}`;\n  const bits = magnitude.toString(16).length * 4;\n  if (bits * Math.LN2 / Math.LN10 <= MAX_DISPLAYED_BIGINT_DIGITS) return `= ${value}`;\n  const log10 = bits * Math.LN2 / Math.LN10;\n  const exponent = Math.floor(log10);\n  const mantissa = Math.pow(10, log10 - exponent);\n  const sign = value < 0n ? \"-\" : \"\";\n  return `= ${sign}~${mantissa.toFixed(3)}e+${exponent} (an exact integer of about ${(exponent + 1).toLocaleString(\"en-US\")} digits, too large to print)`;\n}\n\nfunction formatString(value: string): string {\n  return `= ${value}`;\n}\n\nfunction formatBoolean(value: boolean): string {\n  return `= ${value}`;\n}\n\n/**\n * Renders a Datetime value locale-aware, the previous implementation\n * called `d.toLocaleString()` with no arguments, which always uses the JS\n * runtime's own default locale and never actually consulted `locale.code`\n * despite receiving it as a parameter (both branches of its old\n * `dateFormat === \"default\"` check were byte-for-byte identical, dead\n * groundwork for a distinction that was never implemented). Concretely,\n * this meant every configured locale (including the shipped German one)\n * always displayed weekday/month names in English. See GitHub issue #77.\n *\n * Uses `weekday`/`month`: \"long\" for a spelled-out date (\"Monday,\n * November 17, 2025\" / \"lundi 17 novembre 2025\") since that's what a\n * literal weekday name is for; a bare numeric date doesn't need\n * localizing beyond the decimal/thousands separators `formatNumber()`\n * already handles. The time-of-day portion is only appended when it's\n * not exactly local midnight, bare date literals (\"today\", \"17/11/2025\")\n * always anchor to local midnight, and showing \"00:00:00\" on every one of\n * those would be noise, not information.\n */\nfunction formatDatetime(value: number, locale: ILocale): string {\n  const d = new Date(value);\n  const dateStr = d.toLocaleDateString(locale.code, { weekday: \"long\", year: \"numeric\", month: \"long\", day: \"numeric\" });\n  const isMidnight = d.getHours() === 0 && d.getMinutes() === 0 && d.getSeconds() === 0 && d.getMilliseconds() === 0;\n  if (isMidnight) return `= ${dateStr}`;\n  return `= ${dateStr}, ${d.toLocaleTimeString(locale.code)}`;\n}\n\n/**\n * Renders a millisecond duration as clock-style `H:MM` (or `H:MM:SS` when\n * there's a non-zero seconds component). `ms` is never a user-typeable\n * unit (confirmed: it appears nowhere in `lexer/units.ts`), it's only\n * ever produced by subtracting two clock times/datetimes (`9:30 - 8:30`,\n * `VM.ts`'s Datetime SUB case), so this is a safe, narrow special case,\n * not a general change to how durations display.\n */\nfunction formatMsDuration(ms: number): string {\n  const sign = ms < 0 ? \"-\" : \"\";\n  const totalSeconds = Math.round(Math.abs(ms) / 1000);\n  const hours = Math.floor(totalSeconds / 3600);\n  const minutes = Math.floor((totalSeconds % 3600) / 60);\n  const seconds = totalSeconds % 60;\n  const mm = String(minutes).padStart(2, \"0\");\n  if (seconds === 0) return `${sign}${hours}:${mm}`;\n  const ss = String(seconds).padStart(2, \"0\");\n  return `${sign}${hours}:${mm}:${ss}`;\n}\n\nfunction formatUom(value: number, unit: string | undefined, locale: ILocale, settings: FormattingSettings, exact?: DecimalData): string {\n  if (unit === \"ms\") return `= ${formatMsDuration(value)}`;\n\n  const dp = settings.unitOfMeasurementResult.decimalPlaces;\n\n  // For TimeSpan values (days, weeks, hours, etc.), format as integer if the value is a whole number\n  const timeSpanUnits = [\"days\", \"weeks\", \"months\", \"years\", \"hours\", \"minutes\", \"seconds\", \"day\", \"week\", \"month\", \"year\", \"hour\", \"minute\", \"second\"];\n  const isTimeSpan = unit && timeSpanUnits.includes(unit);\n\n  let formatted: string;\n  if (isTimeSpan && value === Math.floor(value)) {\n    // For whole number TimeSpan values, format as integer\n    formatted = value.toString();\n  } else {\n    // For other values, use the configured decimal places\n    formatted = value.toFixed(dp);\n  }\n\n  // Currency display: symbol + culturally-conventional placement (e.g.\n  // \"$100.00\" prefix vs \"100.00 kr\" suffix) instead of the generic\n  // \"amount CODE\" fallback below. See uom/CurrencyAliases.ts's\n  // CURRENCY_DISPLAY table for the exact set covered and the reasoning\n  // behind each placement choice. Any currency code NOT in that table\n  // (most of the ~150 `CurrencyExchange.isCurrency()` recognizes) falls\n  // through to the unchanged \"amount CODE\" format below.\n  const currencyDisplay = unit ? CURRENCY_DISPLAY[unit.toUpperCase()] : undefined;\n  if (currencyDisplay) {\n    // An exact money amount rounds from its decimal, not from the double: a\n    // half-cent like \"$1.005\" reads as \"$1.01\" here, where \"(1.005).toFixed(2)\"\n    // answers \"1.00\" because the double it is handed already sits below the\n    // value the user typed. Amounts with no exact decimal (a currency\n    // conversion, whose rate is a double) keep the toFixed rendering above.\n    const moneyText = exact ? decimalToFixed(exact, dp) : formatted;\n    const sep = currencyDisplay.spaced ? \" \" : \"\";\n    const withSymbol = currencyDisplay.position === \"prefix\"\n      ? `${currencyDisplay.symbol}${sep}${moneyText}`\n      : `${moneyText}${sep}${currencyDisplay.symbol}`;\n    return `= ${withSymbol}`;\n  }\n\n  // The unit is written as the symbol the value carries. There used to be a\n  // `unitOfMeasurementResult.unitNames` setting here whose two branches were\n  // the same expression, so it never changed anything, and it was removed\n  // rather than implemented: the engine has no unit-name data to render from.\n  // The generated unit table maps a spelling to [measure, ratio] only, and\n  // names cannot be recovered from it, because units that differ by an OFFSET\n  // share a ratio, so \"20 C\" would come back as \"20 kelvins\". A real\n  // implementation needs a hand-authored name per unit plus pluralization and\n  // per-locale spelling (metre against meter), which is a feature rather than\n  // the repair of a dead ternary.\n  //\n  // An exact currency with no symbol in the display table above (one of the\n  // less common ISO codes) still rounds from its decimal here, so \"1.005 UYW\"\n  // reads the same way \"$1.005\" does. Non-currency Uoms never carry an exact,\n  // so this leaves \"1.50 kg\" exactly as it was.\n  const genericText = exact ? decimalToFixed(exact, dp) : formatted;\n  return `= ${genericText} ${unit || \"\"}`.trim();\n}\n\nfunction formatMatrixEntry(entry: MatrixEntry, settings: FormattingSettings): string {\n  if (typeof entry === \"boolean\") return entry ? \"true\" : \"false\";\n  if (typeof entry === \"object\" && entry !== null) return formatSymbolic(entry);\n  const dp = settings.floatResult.decimalPlaces;\n  const sep = settings.floatResult.enableSeperator;\n  const loc = settings.numberResult.decimalSeparatorLocale;\n  return autoFormatIntegerOrFloat(entry, dp, sep, loc);\n}\n\n/**\n * Renders a Matrix matching its own literal syntax: a single row (1xN,\n * including plain vectors) as `[a, b, c]`, a single column (Nx1) as\n * `[a; b; c]`, and a general shape as `[r0c0, r0c1; r1c0, r1c1]`, row-major\n * textual output read back out of the column-major storage\n * (`columnMajorToRowMajor()`), matching how `[1,2;3,4]` is written.\n */\nfunction formatMatrix(m: MatrixData, locale: ILocale, settings: FormattingSettings): string {\n  const rowMajor = columnMajorToRowMajor(m);\n  const rows: string[] = [];\n  for (let r = 0; r < m.rows; r++) {\n    const cells: string[] = [];\n    for (let c = 0; c < m.cols; c++) {\n      cells.push(formatMatrixEntry(rowMajor[r * m.cols + c], settings));\n    }\n    rows.push(cells.join(\", \"));\n  }\n  return `${locale.display.resultPrefix}[${rows.join(\"; \")}]`;\n}\n\n/**\n * Render a matrix as a multi-line, column-aligned block: one row per line (the\n * newline is where {@link formatValue}'s compact form writes `;`), each column\n * right-padded to its widest cell, and every row wrapped in `[ ... ]`. For\n * display where a grid reads better than a line, e.g. a docs notepad or a REPL:\n *\n * ```text\n * [  1   2 ]\n * [ 30   4 ]\n * ```\n *\n * This is deliberately separate from {@link formatValue}, whose single-line\n * matrix form stays the stable, assertable text the API and the worker DTO use.\n * A 1xN row vector is one line; an Nx1 column vector is N lines.\n */\nexport function formatMatrixAligned(m: MatrixData, settings?: FormattingSettings): string {\n  const us = settings || DEFAULT_FORMATTING_SETTINGS;\n  const rowMajor = columnMajorToRowMajor(m);\n  const cells: string[][] = [];\n  for (let r = 0; r < m.rows; r++) {\n    const row: string[] = [];\n    for (let c = 0; c < m.cols; c++) {\n      row.push(formatMatrixEntry(rowMajor[r * m.cols + c], us));\n    }\n    cells.push(row);\n  }\n  const colWidth: number[] = [];\n  for (let c = 0; c < m.cols; c++) {\n    let width = 0;\n    for (let r = 0; r < m.rows; r++) width = Math.max(width, cells[r][c].length);\n    colWidth.push(width);\n  }\n  return cells\n    .map((row) => `[ ${row.map((cell, c) => cell.padStart(colWidth[c])).join(\"  \")} ]`)\n    .join(\"\\n\");\n}\n\nfunction formatRange(min: number, max: number, locale: ILocale): string {\n  return `${locale.display.resultPrefix}${min}:${max}`;\n}\n\nfunction formatPercentage(value: number, locale: ILocale, settings: FormattingSettings): string {\n  // ValueType.Percentage stores a fraction (0.25 for 25%). See Value.ts's\n  // documented contract and the sole producer, VM.ts's TO_PERCENTAGE opcode\n  // (`right/left - 1`, e.g. 0.25 for \"800 to 1000\"). Multiply by 100 before\n  // formatting; without this every percentage-change result displayed as\n  // e.g. \"0.25%\" instead of \"25.00%\".\n  const dp = settings.percentageResult.decimalPlaces;\n  const formatted = (value * 100).toFixed(dp);\n  return `= ${formatted}${locale.display.percentageSuffix}`;\n}\n\nfunction formatUnit(value: number, unit: string | undefined): string {\n  return `= ${value} ${unit || \"\"}`.trim();\n}\n\n/**\n * Renders a per-person bill split: \"= $45.00 each\", or, when the division is\n * uneven, \"= $33.33 each, with 1 share paying $33.34\". Each share's amount is\n * rendered through the ordinary value formatter (a throwaway {@link Value}), so\n * a currency share honours the same symbol placement, decimal places and locale\n * as any other money and a bare share trims trailing zeros the way a plain\n * number does; the \"= \" prefix is added once, around the whole sentence, not\n * per share.\n */\nfunction formatSplit(data: SplitData, locale: ILocale, settings: FormattingSettings): string {\n  const prefix = locale.display.resultPrefix;\n  const render = (share: SplitShare): string => {\n    const v = data.unit !== undefined\n      ? new Value(ValueType.Uom, share.value, data.unit)\n      : new Value(ValueType.Number, share.value);\n    v.exact = share.exact;\n    const text = formatValue(v, settings);\n    return text.startsWith(prefix) ? text.slice(prefix.length) : text;\n  };\n\n  const [base, high] = data.shares;\n  const each = `${render(base)} each`;\n  if (high === undefined) return `${prefix}${each}`;\n  const shareWord = high.count === 1 ? \"share\" : \"shares\";\n  return `${prefix}${each}, with ${high.count} ${shareWord} paying ${render(high)}`;\n}\n\n/**\n * Render an evaluated {@link Value} as a display string, dispatching on\n * `value.type` to the type-specific formatter (number, hex, datetime, unit\n * of measurement, matrix, range, percentage, ...).\n *\n * Most branches produce a `\"= \"`-prefixed result string (matching the\n * plugin's inline-result convention); `ValueType.Error` is the one\n * exception, it returns the human-readable error message directly\n * (stored in `value.unit`), not an `\"= \"`-prefixed string.\n *\n * @param value - The evaluated value to format.\n * @param settings - Locale/precision/separator options; defaults to\n *   {@link DEFAULT_FORMATTING_SETTINGS} when omitted.\n * @example\n * ```typescript\n * const value = engine.evaluateExpression(\"10 USD to GBP\");\n * formatValue(value); // \"= £7.85\" (exact output depends on live exchange rates)\n * ```\n */\nexport function formatValue(value: Value, settings?: FormattingSettings): string {\n  const us = settings || DEFAULT_FORMATTING_SETTINGS;\n  const localeCode = us.numberResult.decimalSeparatorLocale || \"en\";\n  const locale = getLocale(localeCode);\n\n  switch (value.type) {\n    case ValueType.Number:\n      // A measurement with a tolerance renders as \"center ± spread\"; every\n      // other number is unchanged, so a plain value is byte-for-byte what it was.\n      if (value.uncertainty !== undefined) {\n        return formatUncertain(value.value as number, value.uncertainty, locale, us);\n      }\n      return formatNumber(value.value as number, locale, us, value.decimalPlaces);\n    case ValueType.Hex:\n      return formatHex(value.value as number | bigint, us, value.unit);\n    case ValueType.BigInt:\n      return formatBigInt(value.value as bigint);\n    case ValueType.String:\n      return formatString(value.value as string);\n    case ValueType.Boolean:\n      return formatBoolean(value.value as boolean);\n    case ValueType.Datetime:\n      return formatDatetime(value.value as number, locale);\n    case ValueType.Uom:\n      return formatUom(value.value as number, value.unit, locale, us, value.exact);\n    case ValueType.Matrix:\n      return formatMatrix(value.value as MatrixData, locale, us);\n    case ValueType.Range: {\n      const r = value.value as RangeData;\n      return formatRange(r.min, r.max, locale);\n    }\n    case ValueType.Colour:\n      return `${locale.display.resultPrefix}${formatColour(value.value as ColourData)}`;\n    case ValueType.Split:\n      return formatSplit(value.value as SplitData, locale, us);\n    case ValueType.Symbolic:\n      return formatSymbolic(value.value as SymbolicNode);\n    case ValueType.Percentage:\n      return formatPercentage(value.value as number, locale, us);\n    case ValueType.Unit:\n      return formatUnit(value.value as number, value.unit);\n    case ValueType.Error:\n      // errorValue(code, message) stores the human-readable message in\n      // `.unit` (code goes in `.value`), falling through to the default\n      // case here previously displayed the raw code (e.g.\n      // \"CURRENCY_RATE_UNAVAILABLE\") instead of the actual message.\n      return value.unit ?? String(value.value);\n    default:\n      return `= ${String(value.value)}`;\n  }\n}\n"]}

package/dist/chunk-KVTOV3TZ.js

@@ -1,2 +0,0 @@
-import {c as c$1}from'./chunk-MPB7KUN5.js';var d="2.2.0";var g=d;var l={date:{maxOffsetYears:100,minOffsetYears:-100,defaultFormat:"YYYY-MM-DD"},performance:{defaultCacheSize:2e3,maxDocumentLines:1e5},validation:{maxExpressionLength:2e3,maxComplexity:500,maxNestingDepth:50,autoBalanceParens:false},vm:{maxStackDepth:200,maxInstructions:5e4,maxCollectionSize:1e5,maxAllocatedElements:2e6,maxFunctionCalls:1e4,maxGoalSeekIterations:100},worker:{maxConcurrentWorkers:4,idleTimeoutMs:3e4,maxRetries:3,baseBackoffMs:1e3},diagnostic:{enabled:false,vmTraceEnabled:false}};function r(s,e){return {date:{...s.date,...e.date},performance:{...s.performance,...e.performance},validation:{...s.validation,...e.validation},vm:{...s.vm,...e.vm},worker:{...s.worker,...e.worker},diagnostic:{...s.diagnostic,...e.diagnostic}}}var c=class{constructor(e={}){this.config=r(l,e);}get(e){let o=e.split("."),t=this.config;for(let i of o)if(t&&typeof t=="object"&&i in t)t=t[i];else throw c$1.config("CONFIG_PATH_NOT_FOUND",`Configuration path not found: ${e}`,{path:e});return t}set(e,o){let t=e.split(".");if(t.length<2)throw c$1.config("INVALID_CONFIG_PATH",`Invalid path: ${e}. Must be in format 'section.property'`,{path:e});let i=t[0],u=t[1];if(!(i in this.config))throw c$1.config("CONFIG_SECTION_NOT_FOUND",`Configuration section not found: ${i}`,{section:i,path:e});let a=this.config[i];if(a&&typeof a=="object")a[u]=o;else throw c$1.config("CONFIG_PROPERTY_NOT_FOUND",`Configuration property not found: ${e}`,{path:e})}getConfig(){return r(this.config,{})}update(e){this.config=r(this.config,e);}reset(){this.config=r(l,{});}validate(){let e=[];return this.config.performance.maxDocumentLines>1e5&&e.push("maxDocumentLines cannot exceed 100,000"),this.config.date.maxOffsetYears>1e3&&e.push("maxOffsetYears cannot exceed 1000"),{valid:e.length===0,error:e.join("; "),warnings:[]}}};export{g as a,l as b,r as c,c as d};//# sourceMappingURL=chunk-KVTOV3TZ.js.map
-//# sourceMappingURL=chunk-KVTOV3TZ.js.map

package/dist/chunk-KVTOV3TZ.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../package.json","../src/constants/version.ts","../src/constants/Configuration.ts"],"names":["version","ENGINE_VERSION","DEFAULT_CONFIG","mergeEngineConfig","base","override","ConfigManager","config","path","keys","current","key","ErrorFactory","value","section","property","sectionConfig","errors"],"mappings":"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","file":"chunk-KVTOV3TZ.js","sourcesContent":["{\n  \"name\": \"solve-engine\",\n  \"version\": \"2.2.0\",\n  \"description\": \"An embeddable expression engine for natural-language calculations: units, currencies, percentages, dates and matrices, with the parsing and evaluation plumbing already built.\",\n  \"keywords\": [\n    \"expression-evaluator\",\n    \"calculator\",\n    \"bytecode-vm\",\n    \"parser\",\n    \"lexer\",\n    \"dsl\",\n    \"markdown\",\n    \"obsidian\"\n  ],\n  \"license\": \"MIT\",\n  \"author\": \"Liam Riddell\",\n  \"homepage\": \"https://liamriddell.github.io/solve-engine/\",\n  \"repository\": {\n    \"type\": \"git\",\n    \"url\": \"git+https://github.com/LiamRiddell/solve-engine.git\",\n    \"directory\": \"packages/engine\"\n  },\n  \"bugs\": {\n    \"url\": \"https://github.com/LiamRiddell/solve-engine/issues\"\n  },\n  \"publishConfig\": {\n    \"access\": \"public\"\n  },\n  \"type\": \"module\",\n  \"engines\": {\n    \"node\": \">=22\"\n  },\n  \"files\": [\n    \"dist\",\n    \"LICENSE\"\n  ],\n  \"main\": \"./dist/index.cjs\",\n  \"module\": \"./dist/index.js\",\n  \"types\": \"./dist/index.d.ts\",\n  \"exports\": {\n    \".\": {\n      \"import\": {\n        \"types\": \"./dist/index.d.ts\",\n        \"default\": \"./dist/index.js\"\n      },\n      \"require\": {\n        \"types\": \"./dist/index.d.cts\",\n        \"default\": \"./dist/index.cjs\"\n      }\n    },\n    \"./engine\": {\n      \"import\": {\n        \"types\": \"./dist/engine.d.ts\",\n        \"default\": \"./dist/engine.js\"\n      },\n      \"require\": {\n        \"types\": \"./dist/engine.d.cts\",\n        \"default\": \"./dist/engine.cjs\"\n      }\n    },\n    \"./vm\": {\n      \"import\": {\n        \"types\": \"./dist/vm.d.ts\",\n        \"default\": \"./dist/vm.js\"\n      },\n      \"require\": {\n        \"types\": \"./dist/vm.d.cts\",\n        \"default\": \"./dist/vm.cjs\"\n      }\n    },\n    \"./format\": {\n      \"import\": {\n        \"types\": \"./dist/format.d.ts\",\n        \"default\": \"./dist/format.js\"\n      },\n      \"require\": {\n        \"types\": \"./dist/format.d.cts\",\n        \"default\": \"./dist/format.cjs\"\n      }\n    },\n    \"./language\": {\n      \"import\": {\n        \"types\": \"./dist/language.d.ts\",\n        \"default\": \"./dist/language.js\"\n      },\n      \"require\": {\n        \"types\": \"./dist/language.d.cts\",\n        \"default\": \"./dist/language.cjs\"\n      }\n    },\n    \"./packages\": {\n      \"import\": {\n        \"types\": \"./dist/packages.d.ts\",\n        \"default\": \"./dist/packages.js\"\n      },\n      \"require\": {\n        \"types\": \"./dist/packages.d.cts\",\n        \"default\": \"./dist/packages.cjs\"\n      }\n    },\n    \"./constants\": {\n      \"import\": {\n        \"types\": \"./dist/constants.d.ts\",\n        \"default\": \"./dist/constants.js\"\n      },\n      \"require\": {\n        \"types\": \"./dist/constants.d.cts\",\n        \"default\": \"./dist/constants.cjs\"\n      }\n    },\n    \"./lexer\": {\n      \"import\": {\n        \"types\": \"./dist/lexer.d.ts\",\n        \"default\": \"./dist/lexer.js\"\n      },\n      \"require\": {\n        \"types\": \"./dist/lexer.d.cts\",\n        \"default\": \"./dist/lexer.cjs\"\n      }\n    },\n    \"./parser\": {\n      \"import\": {\n        \"types\": \"./dist/parser.d.ts\",\n        \"default\": \"./dist/parser.js\"\n      },\n      \"require\": {\n        \"types\": \"./dist/parser.d.cts\",\n        \"default\": \"./dist/parser.cjs\"\n      }\n    },\n    \"./normalizer\": {\n      \"import\": {\n        \"types\": \"./dist/normalizer.d.ts\",\n        \"default\": \"./dist/normalizer.js\"\n      },\n      \"require\": {\n        \"types\": \"./dist/normalizer.d.cts\",\n        \"default\": \"./dist/normalizer.cjs\"\n      }\n    },\n    \"./resolvers\": {\n      \"import\": {\n        \"types\": \"./dist/resolvers.d.ts\",\n        \"default\": \"./dist/resolvers.js\"\n      },\n      \"require\": {\n        \"types\": \"./dist/resolvers.d.cts\",\n        \"default\": \"./dist/resolvers.cjs\"\n      }\n    },\n    \"./errors\": {\n      \"import\": {\n        \"types\": \"./dist/errors.d.ts\",\n        \"default\": \"./dist/errors.js\"\n      },\n      \"require\": {\n        \"types\": \"./dist/errors.d.cts\",\n        \"default\": \"./dist/errors.cjs\"\n      }\n    },\n    \"./utilities\": {\n      \"import\": {\n        \"types\": \"./dist/utilities.d.ts\",\n        \"default\": \"./dist/utilities.js\"\n      },\n      \"require\": {\n        \"types\": \"./dist/utilities.d.cts\",\n        \"default\": \"./dist/utilities.cjs\"\n      }\n    },\n    \"./uom\": {\n      \"import\": {\n        \"types\": \"./dist/uom.d.ts\",\n        \"default\": \"./dist/uom.js\"\n      },\n      \"require\": {\n        \"types\": \"./dist/uom.d.cts\",\n        \"default\": \"./dist/uom.cjs\"\n      }\n    },\n    \"./services\": {\n      \"import\": {\n        \"types\": \"./dist/services.d.ts\",\n        \"default\": \"./dist/services.js\"\n      },\n      \"require\": {\n        \"types\": \"./dist/services.d.cts\",\n        \"default\": \"./dist/services.cjs\"\n      }\n    },\n    \"./worker\": {\n      \"import\": {\n        \"types\": \"./dist/worker.d.ts\",\n        \"default\": \"./dist/worker.js\"\n      },\n      \"require\": {\n        \"types\": \"./dist/worker.d.cts\",\n        \"default\": \"./dist/worker.cjs\"\n      }\n    },\n    \"./testing\": {\n      \"import\": {\n        \"types\": \"./dist/testing.d.ts\",\n        \"default\": \"./dist/testing.js\"\n      },\n      \"require\": {\n        \"types\": \"./dist/testing.d.cts\",\n        \"default\": \"./dist/testing.cjs\"\n      }\n    }\n  },\n  \"scripts\": {\n    \"build\": \"tsup\",\n    \"prepublishOnly\": \"npm run build && node ../../scripts/assert-publishable.mjs .\",\n    \"dev\": \"tsup --watch\",\n    \"test\": \"jest --config jest.config.cjs --no-coverage\",\n    \"typecheck\": \"tsgo --noEmit --skipLibCheck\",\n    \"typecheck:tsc\": \"tsc --noEmit --skipLibCheck\"\n  },\n  \"dependencies\": {\n    \"@tanstack/query-core\": \"^5.100.10\"\n  },\n  \"devDependencies\": {\n    \"@jest/globals\": \"^30.4.1\",\n    \"@types/node\": \"^26.2.0\",\n    \"convert\": \"^7.0.0\",\n    \"jest\": \"^30.4.2\",\n    \"ts-jest\": \"^29.4.12\",\n    \"tsup\": \"8.5.1\",\n    \"typescript\": \"5.9.3\"\n  },\n  \"//sideEffects\": \"Load-bearing claim, not boilerplate. tsup's splitting emits bare chunk imports at the top of dist/index.js, and this field tells Rollup, webpack and Vite they may delete them, which esbuild reports as [ignored-bare-import] once per import during `npm run size`. The engine does have module-level work to lose: registerAllTokenTypes(), _PrecedenceParser.BP_TABLE and its cached token ids, and several process-wide registries. It is safe because every chunk doing that work is also imported for its bindings somewhere, so no bundler can drop it. That is a property of how tsup currently splits the code rather than a design guarantee, so `npm run smoke:bundled` (scripts/check-tree-shaking.mjs) proves it on every run of `npm run verify` instead of assuming it, and its header explains the two fixes if it ever stops holding.\",\n  \"sideEffects\": false\n}\n","/**\n * The running engine's own semver version, sourced directly from this\n * package's package.json so it can never drift from what's actually\n * published. Exists so IEnginePackage.engineVersion range checks\n * (api/EngineVersionCompatibility.ts) have something real to check\n * against.\n */\nimport { version } from \"../../package.json\";\n\n/**\n * The running engine's version, taken from package.json.\n *\n * What a package's `engineVersion` range is checked against at registration.\n * A prerelease is compared by its coerced release version, so a 1.0.0 beta\n * satisfies `^1.0.0`. See `api/EngineVersionCompatibility.ts`.\n */\nexport const ENGINE_VERSION: string = version;\n","/**\n * Configuration Module for solve-js Engine\n * \n * This module provides the **single source of truth** for all engine configuration.\n * Every configurable aspect of the engine, from safety limits and performance\n * budgets to VM constraints and worker pool sizing, is defined here.\n * \n * ### Design principles\n * \n * 1. **Engine owns its config.** The engine defines its own config shape and defaults.\n *    Consumers (e.g., the Obsidian plugin) pass partial overrides; all unspecified\n *    fields fall back to `DEFAULT_CONFIG`.\n * \n * 2. **Self-documenting.** Every interface and field has descriptive JSDoc so the\n *    config is understandable at a glance, whether you're using the engine as an\n *    npm package or reading the source.\n * \n * 3. **Minimal consumer knowledge.** Consumers only need to pass `Partial<EngineConfig>`.\n *    They don't need to replicate the full config shape, just the fields they\n *    want to override.\n * \n * @module Configuration\n */\n\nimport { ErrorFactory } from \"@solve-js/errors/UnifiedErrorFramework\";\n\n/**\n * A host's test for whether a calendar date is a public holiday, given the\n * `Date` for that day at local midnight. Return `true` to exclude it from\n * working-day arithmetic.\n */\nexport type HolidayPredicate = (date: Date) => boolean;\n\n/**\n * The host-supplied public-holiday calendar, in the same \"bring your own data\"\n * shape the stocks and weather packages already use for a host callback (see\n * `packages/stocks/StocksPackage.ts`): weekends are decidable from the date\n * alone, holidays are not, so they come from the host or not at all.\n *\n * Either a {@link HolidayPredicate}, for a host that computes holidays itself\n * (an existing library, a region rule), or an iterable of specific dates as\n * `YYYY-MM-DD` strings, epoch-millisecond numbers or `Date` objects, for a host\n * that just has a list. Resolved to one internal predicate by\n * `vm/HolidayCalendar.ts`'s `resolveHolidayPredicate()`.\n *\n * Left unset, working-day arithmetic skips weekends only, which is the honest\n * default: the engine excludes exactly the days it can prove are non-working.\n */\nexport type HolidayCalendar = HolidayPredicate | Iterable<string | number | Date>;\n\n/**\n * Date-related configuration.\n * Controls the bounds and formatting for date/time expression evaluation\n * (e.g., `today + 20 days`, `last monday`).\n */\nexport interface DateConfig {\n  /**\n   * How far forward a date offset whose COST grows with the offset may reach,\n   * in years. Enforced by `vm/VM.ts`'s `addBusinessDays()`.\n   *\n   * Bounds the walk, not the calendar. Every other date offset in the engine\n   * is arithmetic on a Date field, so `today + 100000 days` costs exactly what\n   * one day costs and needs no ceiling; workdays are the one offset that has\n   * to step day by day, because which days are skipped depends on where each\n   * step lands. `today + 100000000 workdays` therefore froze the host for\n   * thirteen seconds inside a single ADD opcode (where `vm.maxInstructions`\n   * cannot see it) and then answered \"Invalid Date\", and a trillion never\n   * returned at all.\n   *\n   * Release hardening: this field was declared, documented as a \"safety\n   * limit\", and read nowhere, so it bounded nothing. A limit a host can\n   * configure and the engine ignores is worse than no limit, because it reads\n   * as protection that is not there.\n   */\n  readonly maxOffsetYears: number;\n  /** How far BACK the same walk may reach, in years, as a negative number. See {@link maxOffsetYears}. */\n  readonly minOffsetYears: number;\n  /** Default date string format for display (moment.js format string) */\n  readonly defaultFormat: string;\n  /**\n   * Public-holiday calendar for working-day arithmetic (`N working days after\n   * <date>`, `working days between <date> and <date>`, `<date> + N workdays`).\n   * See {@link HolidayCalendar}.\n   *\n   * Optional and unset by default: with no calendar, working-day arithmetic\n   * skips weekends only. A host that wants holidays excluded too supplies one\n   * here (`new ExpressionEngine({ config: { date: { holidays } } })`), the\n   * same way stocks and weather take a host data source. Threaded into the VM\n   * by `engine/ExpressionEngine.ts` exactly as {@link maxOffsetYears} is,\n   * because working-day math is a VM operation several grammar forms share, so\n   * the calendar has to be one source the VM owns rather than per-package state\n   * the VM cannot see.\n   */\n  readonly holidays?: HolidayCalendar;\n}\n\n/**\n * Performance-related configuration.\n * Controls caching, timeouts, and processing limits to prevent runaway\n * resource consumption on large documents.\n */\nexport interface PerformanceConfig {\n  /**\n   * Maximum number of entries in {@link ExpressionEngine}'s bytecode cache\n   * (per-instance, keyed by expression text) before the oldest entry is\n   * evicted. Raise this for documents with many distinct expressions if\n   * repeated re-evaluation (e.g. scrolling) is re-parsing instead of\n   * hitting cache, bug fix (release hardening pass): this field used to\n   * be read nowhere; the cache size was a hardcoded, unconfigurable\n   * constant. Note this does NOT bound {@link LineCache}, which has no\n   * size limit of its own.\n   */\n  readonly defaultCacheSize: number;\n  /**\n   * Maximum lines a document may have for the engine to process it in one\n   * pass. Enforced by `ExpressionEngine.parseDocument()` and by\n   * `engine/DocumentModel.ts`'s `setDocument()`, the two entry points that\n   * take a whole document.\n   *\n   * A document costs memory per line whatever each line says: a parsed line\n   * record, a cache entry, a dependency-graph node. Two hundred thousand\n   * lines of `1 + 1` therefore exhausted the heap and aborted the process\n   * before any per-line limit had anything to object to, which is the same\n   * shape of hole as an unbounded expression and needs the same kind of\n   * ceiling. Refusing the document names the limit; a host that genuinely has\n   * a larger one raises this field.\n   *\n   * Release hardening: declared and read nowhere until now.\n   */\n  readonly maxDocumentLines: number;\n}\n\n/**\n * Validation / safety-limit configuration.\n * Protects against runaway expressions that could cause excessive memory use\n * or stack overflow. These limits are checked during lexing and parsing.\n */\n/** Bounds on untrusted input: expression length and nesting depth. */\nexport interface ValidationConfig {\n  /** Maximum expression length in characters. Prevents excessively long strings from entering the pipeline. */\n  readonly maxExpressionLength: number;\n  /** Maximum expression complexity score (`tokens + functionCalls×5 + nestingDepth×10`). Protects against deeply nested or combinatorially complex expressions. */\n  readonly maxComplexity: number;\n  /** Maximum parentheses nesting depth. Prevents stack overflow in the recursive-descent parser. */\n  readonly maxNestingDepth: number;\n  /**\n   * Auto-balance unmatched parentheses by appending missing closing parens\n   * or prepending missing opening parens. When disabled, unbalanced expressions\n   * cause parse errors instead of being silently corrected.\n   *\n   * Disabled by default for strict parsing. Enable for forgiving user input\n   * (e.g., chat-style calculators where users often omit closing parens).\n   * Has zero overhead when disabled, the O(n) paren-count scan is skipped.\n   */\n  readonly autoBalanceParens: boolean;\n}\n\n/**\n * Worker pool configuration.\n * Controls the parallel execution workers used for batch evaluation.\n */\nexport interface WorkerConfig {\n  /** Maximum number of concurrent Web Workers allowed */\n  readonly maxConcurrentWorkers: number;\n  /** Time (ms) a worker stays alive while idle before being terminated */\n  readonly idleTimeoutMs: number;\n  /** Maximum retry attempts for a failed worker operation */\n  readonly maxRetries: number;\n  /** Base backoff delay (ms) between retries (exponential backoff applied on top) */\n  readonly baseBackoffMs: number;\n}  /**\n   * Diagnostic / telemetry configuration.\n   * Controls the diagnostic event pipeline for profiling and debugging.\n   * All diagnostics are disabled by default for maximum production performance.\n   */\n  export interface DiagnosticConfig {\n    /** Master switch: enable the diagnostic pipeline (collectors receive events for all pipeline stages) */\n    readonly enabled: boolean;\n    /** Enable VM trace mode, emits per-opcode execution events (very verbose; disables some optimizations) */\n    readonly vmTraceEnabled: boolean;\n  }\n\n  /**\n   * Virtual Machine configuration.\n   * Controls the internal bytecode VM that executes compiled expressions.\n   */\n  export interface VMConfig {\n    /** Maximum stack depth (value slots) for VM execution, prevents stack overflow in recursive/pratt-parser generated bytecode */\n    readonly maxStackDepth: number;\n    /** Maximum opcodes executed per expression, halts runaway infinite loops */\n    readonly maxInstructions: number;\n    /**\n     * Maximum elements a collection may be expanded to before `map`/`reduce`/\n     * `sum`/`prod` will iterate it.\n     *\n     * A Range is stored as its two bounds and costs nothing until something\n     * materializes it, at which point it becomes one Value per element. Twenty\n     * characters (`sum(x, 1:100000000)`) therefore asked for a hundred million\n     * of them, and neither `maxInstructions` nor `maxStackDepth` could see it:\n     * the expansion happens inside a single opcode, so the instruction counter\n     * is never consulted while it runs, and the elements never reach the value\n     * stack. V8 aborted the whole process with \"Reached heap limit\", which a\n     * host embedding the engine cannot catch.\n     */\n    readonly maxCollectionSize: number;\n    /**\n     * Maximum elements (collection Values, matrix cells) one evaluation may\n     * materialize in total.\n     *\n     * `maxCollectionSize` above bounds a single collection. This bounds the sum\n     * of everything an expression asks for, which is a different question and\n     * the one that actually protects the host: two collections that are\n     * individually legal are legal together, and an operation whose result is\n     * the PRODUCT of two legal operands is bounded by neither of them. A matrix\n     * multiply is exactly that shape, so three lines within every other limit\n     * (`:a = map(1*x, 0:20000)`, `:b = transpose(a)`, `b * a`) asked for four\n     * hundred million cells and aborted the process.\n     *\n     * Counted in elements rather than bytes, because a count is what a call\n     * site has before it allocates. An element is 8 bytes as a numeric matrix\n     * cell and closer to a hundred as a full Value, so the default is worth\n     * roughly 16 MB of matrix or 200 MB of expanded collection: far past any\n     * document and far short of what an editor cannot survive.\n     */\n    readonly maxAllocatedElements: number;\n    /**\n     * Maximum user-defined-function calls one evaluation may make in TOTAL,\n     * however deeply or widely they nest.\n     *\n     * `maxFunctionRecursionDepth` bounds how DEEP calls nest and cannot see\n     * how MANY there are, and those are different numbers. Twenty-two lines of\n     * `f(n)(v) = f(n-1)(v) + f(n-1)(v)` reach a depth of only 22 against a\n     * limit of 50, and make 2,097,152 calls doing it: a fatal heap abort in\n     * under a second. `maxInstructions` cannot bound it either, because\n     * `executeBytecode()` re-enters itself per call and each reentrant call\n     * gets its OWN instruction count, so recursion refreshes its allowance on\n     * the way in. This is the tally that does not refresh; see\n     * `vm/AllocationBudget.ts`, which holds it for the same reason it holds\n     * the element tally.\n     *\n     * Counted in calls rather than in the instructions they run, because the\n     * call is the thing that multiplies: every call allocates a frame, its\n     * arguments and its result whatever its body says.\n     */\n    readonly maxFunctionCalls: number;\n    /**\n     * Hard ceiling on how many bisection steps goal seek (`solve line N for\n     * <var> = <target>`, see `packages/goalseek/`) may take before it gives up\n     * with a structured error rather than continuing.\n     *\n     * Goal seek re-evaluates the target line's expression once per step while\n     * narrowing an interval, and an untrusted document must never be able to\n     * make that loop spin. `maxInstructions` bounds each individual\n     * re-evaluation, but not how many of them the search performs, so this is\n     * the tally that bounds the search itself, the same reason `maxFunctionCalls`\n     * exists alongside `maxInstructions`. Bisection halves the interval every\n     * step, so a hundred steps resolves an input to roughly one part in 2^100:\n     * far past any precision a document needs, and a definite stop either way.\n     */\n    readonly maxGoalSeekIterations: number;\n  }\n\n/**\n * Complete engine configuration.\n *\n * Every field has a default in `DEFAULT_CONFIG`. To customize, pass a\n * `Partial<EngineConfig>` when constructing `ExpressionEngine`. Only the\n * sections/fields you supply are overridden; all others use their defaults.\n *\n * @example\n * ```typescript\n * import { ExpressionEngine } from \"solve-js\";\n *\n * const engine = new ExpressionEngine({ config: {\n *   validation: {\n *     maxExpressionLength: 1000,\n *     maxComplexity: 200,\n *   },\n *   // date, performance, vm, worker, diagnostic all use defaults\n * } });\n * ```\n */\nexport interface EngineConfig {\n    /** Date/time expression evaluation bounds and formatting */\n    readonly date: DateConfig;\n    /** Performance budgets and cache sizing */\n    readonly performance: PerformanceConfig;\n    /** Safety limits for expression complexity */\n    readonly validation: ValidationConfig;\n    /** Internal bytecode VM configuration */\n    readonly vm: VMConfig;\n    /** Parallel worker pool configuration */\n    readonly worker: WorkerConfig;\n    /** Diagnostic pipeline configuration */\n    readonly diagnostic: DiagnosticConfig;\n  }\n\n/**\n * A partial {@link EngineConfig} override, one section at a time.\n *\n * Overrides are merged per section over {@link DEFAULT_CONFIG}, so you can set a\n * single field of one section (`{ validation: { maxExpressionLength: 1000 } }`)\n * and keep every other default in that section. A plain `Partial<EngineConfig>`\n * cannot express that, it demands a whole section object, which is why the\n * documented overrides never typechecked against it. This is the type the\n * constructor and {@link createEngine} accept.\n */\nexport type EngineConfigOverride = {\n  readonly [K in keyof EngineConfig]?: Partial<EngineConfig[K]>;\n};\n\n/**\n * Default configuration values\n */\nexport const DEFAULT_CONFIG: EngineConfig = {\n   date: {\n     // A century of workdays is about 26,000 steps, which is microseconds,\n     // and past any offset a person means. The walk is what these bound; see\n     // DateConfig above for why no other date offset needs a ceiling.\n     maxOffsetYears: 100,\n     minOffsetYears: -100,\n     defaultFormat: 'YYYY-MM-DD'\n   },\n   performance: {\n     // Preserves the effective cache size the hardcoded (now-removed)\n     // BYTECODE_CACHE_MAX_ENTRIES constant had, so wiring this field up\n     // doesn't silently shrink the default cache for existing consumers.\n     defaultCacheSize: 2000,\n     // Raised from the 10,000 this field was declared with, which was never\n     // enforced and turned out to be under what this engine already supports:\n     // its paging design is tested against a 20,000-line document\n     // (`engine/PageManager.ts` and its spec) and its throughput benchmark\n     // parses a 50,000-line one. Twice the largest of those, and the same\n     // number `ConfigManager.validate()` already refuses to go above.\n     //\n     // Measured under a 256MB heap: setting a 100,000-line document costs\n     // 64MB, evaluating every line of a 20,000-line one costs 106MB, and\n     // 200,000 lines aborts the process before a single expression is looked\n     // at. A host with a small heap should lower this; the ceiling is here to\n     // stop the size that cannot work anywhere.\n     maxDocumentLines: 100000,\n   },\n    validation: {\n      maxExpressionLength: 2000,\n      maxComplexity: 500,\n      maxNestingDepth: 50,\n      autoBalanceParens: false,\n    },\n    vm: {\n      maxStackDepth: 200,\n      maxInstructions: 50000,\n      // Two orders of magnitude above anything a person types by hand (the\n      // longest range in the test suite is 1000 elements) and small enough\n      // that expanding it is measured in milliseconds rather than in whether\n      // the host survives.\n      maxCollectionSize: 100000,\n      // Twenty times the single-collection ceiling above, so an expression may\n      // legitimately handle a number of large collections, and two hundred\n      // times below the allocation that took the process down.\n      maxAllocatedElements: 2000000,\n      // Six hundred times the largest call count any test or example makes\n      // (five levels of composition is sixteen calls), and small enough that\n      // the calls it does allow cost single-digit megabytes rather than the\n      // heap. A document that needs more than ten thousand calls on one line\n      // is doing something a calculator was not built for.\n      maxFunctionCalls: 10000,\n      // A hundred bisection steps resolve an input to one part in 2^100, far\n      // finer than any document needs and a firm stop for an untrusted one. A\n      // continuous, monotonic relationship converges in tens of steps, well\n      // under this; hitting it means the target is unreachable or the\n      // relationship is not the smooth one goal seek assumes.\n      maxGoalSeekIterations: 100,\n    },\n    worker: {\n      maxConcurrentWorkers: 4,\n      idleTimeoutMs: 30000,\n      maxRetries: 3,\n      baseBackoffMs: 1000,\n    },\n    diagnostic: {\n      enabled: false,\n      vmTraceEnabled: false,\n    },\n  };\n\n/**\n * Merge a partial config override onto a base `EngineConfig`, section by\n * section, `{ ...base.section, ...override.section }` for each of the 7\n * top-level sections, not a single top-level spread.\n *\n * A shallow `{ ...base, ...override }` at the TOP level replaces an entire\n * section wholesale the moment a caller overrides even one field in it\n * (e.g. `{ performance: { defaultCacheSize: 500 } }` would silently drop\n * every other `performance.*` field back to `undefined`, not to its\n * default). This function exists specifically so every config consumer\n * shares one correct merge instead of each hand-rolling (and risking) its\n * own. `ConfigManager` and `ExpressionEngine` both call this rather than\n * either duplicating the section list or instantiating a whole\n * `ConfigManager` just to reuse its private merge logic.\n */\nexport function mergeEngineConfig(\n  base: EngineConfig,\n  override: EngineConfigOverride\n): EngineConfig {\n  return {\n    date: { ...base.date, ...override.date },\n    performance: { ...base.performance, ...override.performance },\n    validation: { ...base.validation, ...override.validation },\n    vm: { ...base.vm, ...override.vm },\n    worker: { ...base.worker, ...override.worker },\n    diagnostic: { ...base.diagnostic, ...override.diagnostic },\n  };\n}\n\n/**\n * Configuration manager for engine settings\n *\n * @example\n * ```typescript\n * const configManager = new ConfigManager();\n * configManager.set('performance.defaultCacheSize', 2000);\n * const cacheSize = configManager.get('performance.defaultCacheSize');\n * ```\n */\nexport class ConfigManager {\n  private config: EngineConfig;\n\n  constructor(config: Partial<EngineConfig> = {}) {\n    this.config = mergeEngineConfig(DEFAULT_CONFIG, config);\n  }\n\n  /**\n   * Get configuration value by path\n   * \n   * @param path - Dot-notation path to config value\n   * @returns Configuration value\n   */\n  get<T>(path: string): T {\n    const keys = path.split('.');\n    let current: unknown = this.config;\n\n    for (const key of keys) {\n      if (current && typeof current === 'object' && key in current) {\n        current = (current as Record<string, unknown>)[key];\n      } else {\n        throw ErrorFactory.config(\n          \"CONFIG_PATH_NOT_FOUND\",\n          `Configuration path not found: ${path}`,\n          { path }\n        );\n      }\n    }\n\n    return current as T;\n  }\n\n  /**\n   * Set configuration value by path\n   * \n   * @param path - Dot-notation path to config value\n   * @param value - New value\n   */\n  set<T>(path: string, value: T): void {\n    const keys = path.split('.');\n    if (keys.length < 2) {\n      throw ErrorFactory.config(\n        \"INVALID_CONFIG_PATH\",\n        `Invalid path: ${path}. Must be in format 'section.property'`,\n        { path }\n      );\n    }\n    \n    const section = keys[0];\n    const property = keys[1];\n    \n    if (!(section in this.config)) {\n      throw ErrorFactory.config(\n        \"CONFIG_SECTION_NOT_FOUND\",\n        `Configuration section not found: ${section}`,\n        { section, path }\n      );\n    }\n    \n    const sectionConfig = this.config[section as keyof EngineConfig];\n    if (sectionConfig && typeof sectionConfig === 'object') {\n      (sectionConfig as unknown as Record<string, unknown>)[property] = value;\n    } else {\n      throw ErrorFactory.config(\n        \"CONFIG_PROPERTY_NOT_FOUND\",\n        `Configuration property not found: ${path}`,\n        { path }\n      );\n    }\n  }\n\n  /**\n   * Get complete configuration.\n   *\n   * A detached copy, section objects included. A top-level spread would hand\n   * the caller this manager's own section objects, so `getConfig().vm.x = 1`\n   * would be an undeclared back door into {@link set}, bypassing its path\n   * validation and reaching every later {@link get}.\n   */\n  getConfig(): EngineConfig {\n    return mergeEngineConfig(this.config, {});\n  }\n\n  /**\n   * Update multiple configuration values\n   */\n  update(config: Partial<EngineConfig>): void {\n    this.config = mergeEngineConfig(this.config, config);\n  }\n\n  /**\n   * Reset to default configuration.\n   *\n   * Goes through {@link mergeEngineConfig} for the same reason the constructor\n   * does. A top-level `{ ...DEFAULT_CONFIG }` copies the six section\n   * references, not the sections, so after a reset this manager's\n   * `performance` object WAS `DEFAULT_CONFIG.performance` and the next\n   * `set('performance.x', ...)` wrote into the module constant. That constant\n   * is what every `ExpressionEngine` is built from, so one manager's reset\n   * could change the cache size, instruction ceiling or allocation budget of\n   * every engine constructed later in the process.\n   */\n  reset(): void {\n    this.config = mergeEngineConfig(DEFAULT_CONFIG, {});\n  }\n\n  /**\n   * Validate configuration values\n   */\n  validate(): ValidationResult {\n    const errors: string[] = [];\n\n    // Validate performance config\n    if (this.config.performance.maxDocumentLines > 100000) {\n      errors.push('maxDocumentLines cannot exceed 100,000');\n    }\n\n    // Validate date config\n    if (this.config.date.maxOffsetYears > 1000) {\n      errors.push('maxOffsetYears cannot exceed 1000');\n    }\n\n    return {\n      valid: errors.length === 0,\n      error: errors.join('; '),\n      warnings: []\n    };\n  }\n}\n\n/**\n * Result type for {@link ConfigManager.validate}.\n */\nexport interface ValidationResult {\n  valid: boolean;\n  error?: string;\n  warnings?: string[];\n}\n\n"]}