@ethisyscore/core-utils 1.94.1 → 1.95.0

package/dist/money/index.d.ts

@@ -12,6 +12,11 @@
  * (the amount's own currency, or the org's reporting currency) and CONVERTING
  * between currencies are host-aware concerns handled by the plugin-ui `useCurrency`
  * hook, which formats through this module.
+ *
+ * When no currency is given, `formatMoney` falls back to the organisation's
+ * reporting currency via the {@link ./orgCurrency} seam (the same module-ref +
+ * fail-open-to-`GBP` mechanism as the date org-format seam), so a plugin can render
+ * reporting-currency amounts without threading a code or hardcoding one.
  */
 /**
  * Deterministic fallback locale. Matches the date seam's UK fallback so money and
@@ -21,8 +26,12 @@
 declare const MONEY_FALLBACK_LOCALE = "en-GB";
 /** Options for {@link formatMoney}. */
 interface FormatMoneyOptions {
-    /** ISO 4217 code (e.g. `"GBP"`, `"EUR"`) - drives `Intl` currency formatting. */
-    currencyCode: string;
+    /**
+     * ISO 4217 code (e.g. `"GBP"`, `"EUR"`) - drives `Intl` currency formatting.
+     * Optional: when omitted, `formatMoney` resolves the organisation's reporting
+     * currency (see {@link ./orgCurrency}), falling back to `GBP` when none is stamped.
+     */
+    currencyCode?: string;
     /**
      * Fraction digits to show. When null/undefined, `Intl`'s per-currency default is
      * used (GBP -> 2, JPY -> 0). Pass a number to force a currency's decimal-places
@@ -39,12 +48,23 @@ interface FormatMoneyOptions {
     symbol?: string | null;
 }
 /**
- * Formats a monetary amount in the given currency. On an unknown/invalid currency
- * code (which makes `Intl.NumberFormat` throw) it falls back to a symbol/code prefix
- * plus the fixed-decimal amount, so a bad code degrades to a readable string rather
- * than throwing on a render path.
+ * Formats a monetary amount. The currency is resolved in this order:
+ *
+ * - `formatMoney(amount, "EUR")` — a positional ISO code, with the currency's
+ *   natural decimals.
+ * - `formatMoney(amount, { currencyCode, decimalPlaces, locale, symbol })` — the
+ *   options form; any of `currencyCode`/`decimalPlaces` may be omitted.
+ * - `formatMoney(amount)` (or an options object without `currencyCode`) — the
+ *   organisation's reporting currency stamped via the {@link ./orgCurrency} seam,
+ *   including that currency's decimal-places override when the caller gave none.
+ *   When no org currency is stamped it falls back to {@link MONEY_FALLBACK_CURRENCY}
+ *   (`GBP`), the same deterministic fail-open as the date org-format seam.
+ *
+ * On an unknown/invalid currency code (which makes `Intl.NumberFormat` throw) it
+ * falls back to a symbol/code prefix plus the fixed-decimal amount, so a bad code
+ * degrades to a readable string rather than throwing on a render path.
  */
-declare function formatMoney(amount: number, options: FormatMoneyOptions): string;
+declare function formatMoney(amount: number, currency?: string | FormatMoneyOptions): string;
 /** Options for {@link formatCompactMoney}. */
 interface FormatCompactMoneyOptions {
     /** ISO 4217 code (e.g. `"GBP"`, `"EUR"`) - resolves the leading symbol. */
@@ -80,4 +100,105 @@ declare function formatCompactMoney(amount: number, options: FormatCompactMoneyO
  */
 declare function getCurrencySymbol(currencyCode: string, locale?: string, symbol?: string | null): string;
 
-export { type FormatCompactMoneyOptions, type FormatMoneyOptions, MONEY_FALLBACK_LOCALE, formatCompactMoney, formatMoney, getCurrencySymbol };
+/**
+ * Organisation-driven reporting-currency resolution.
+ *
+ * Plugin (and host) surfaces render reporting-currency amounts in whatever the
+ * organisation has configured as its reporting currency, without threading a
+ * currency code through every call site. This module holds the module-level
+ * reporting-currency ref, its setter, and the readers with a deterministic
+ * fallback constant. It is pure — no React, no host access — so it lives in
+ * core-utils behind the `@ethisyscore/core-utils/money` sub-path, mirroring the
+ * date org-format seam (`@ethisyscore/core-utils/date/org-format`).
+ *
+ * The ref is stamped by the surface sync hook — the SDK
+ * `useReportingCurrencySync` reads the host
+ * `settings:get-organisation-reporting-currency` tool and calls
+ * `setOrgReportingCurrency`. When no reporting currency is stamped (a
+ * standalone/mock run, an old host, or a failed fetch) resolution falls back to
+ * the deterministic UK default `GBP`, NOT the OS locale, so output is
+ * machine-stable regardless of the host. This is the exact fail-open contract of
+ * the date seam's UK `dd/MM/yyyy` fallback.
+ *
+ * Deciding WHICH currency an amount is in (its own currency vs the org's
+ * reporting currency) and CONVERTING between currencies stay host-aware concerns
+ * of the plugin-ui `useCurrency` hook. This seam only answers "what is the org's
+ * reporting currency" for the pure {@link formatMoney} default path.
+ */
+/**
+ * Deterministic fallback reporting currency when no org currency is stamped.
+ * Matches the date seam's UK fallback (`ORG_DATE_FALLBACK_FORMAT`) so money and
+ * dates degrade consistently, and so output does not drift with the OS locale of
+ * whatever host renders it.
+ */
+declare const MONEY_FALLBACK_CURRENCY = "GBP";
+/** The organisation's reporting currency as stamped by the surface sync hook. */
+interface OrgReportingCurrency {
+    /** ISO 4217 code (e.g. `"GBP"`, `"EUR"`) drives `Intl` currency formatting. */
+    code: string;
+    /**
+     * Host decimal-places override for the currency, or null to use the currency's
+     * ISO default (GBP -> 2, JPY -> 0). Applied by {@link formatMoney} only when the
+     * caller supplies no explicit decimalPlaces.
+     */
+    decimalPlaces: number | null;
+}
+/**
+ * Stamps the module-level reporting-currency ref. Called by the surface sync hook
+ * each time the organisation's reporting currency resolves. Pass `null` to clear
+ * it and fall back to the deterministic {@link MONEY_FALLBACK_CURRENCY}.
+ */
+declare function setOrgReportingCurrency(currency: OrgReportingCurrency | null): void;
+/** The org's stamped reporting currency, or null to fall back to the UK default. */
+declare function getOrgReportingCurrency(): OrgReportingCurrency | null;
+/**
+ * The org's effective reporting-currency code: the stamped code when present, else
+ * the deterministic {@link MONEY_FALLBACK_CURRENCY} (`GBP`). Never null, so callers
+ * always have a well-formed code to format with.
+ */
+declare function resolveOrgReportingCurrencyCode(): string;
+
+/**
+ * Framework-agnostic money PARSING — the inverse of {@link formatMoney} for form
+ * inputs and editable amount fields.
+ *
+ * A user (or a round-tripped display value) types an amount in the en-GB /
+ * dot-decimal display shape — a currency symbol or ISO code prefix, comma grouping
+ * separators, stray whitespace, and a dot decimal point ("£1,234.56", "GBP 1,234.56").
+ * This turns that back into a plain number, or null when there is no meaningful value
+ * to parse.
+ *
+ * It is deliberately lenient about the symbol, currency-code prefix and grouping so
+ * it tolerates the display forms {@link formatMoney} produces in the en-GB fallback
+ * locale, but it is NOT a locale-universal inverse of {@link formatMoney}. Only the
+ * dot-decimal shape is understood: a comma is always treated as a grouping separator
+ * and dropped, so comma-decimal locales (de-DE `1.234,56`) are OUT OF SCOPE and would
+ * mis-parse. The platform stores and edits amounts in the dot-decimal numeric form.
+ *
+ * Ported from the per-plugin `parseCurrency` helper so consuming plugins drop the
+ * local copy.
+ */
+/**
+ * Parses a formatted currency string back to a number. Returns null for
+ * null/undefined, an empty/whitespace-only string, or the literal `"N/A"`
+ * placeholder; normalises the Unicode minus, strips every non-numeric character
+ * (currency symbols, alpha currency-code prefixes, grouping commas and whitespace),
+ * then `parseFloat`s the remainder, returning null when the result is not a number.
+ *
+ * Parses only the en-GB / dot-decimal display shape (comma thousands, dot decimal);
+ * see the module docs — it is NOT a locale-universal inverse of {@link formatMoney}.
+ * A leading minus is preserved, so `"-£10.00"` parses to `-10`. Garbage that contains
+ * no leading number (`"abc"`) yields null.
+ *
+ * @example
+ * parseMoney("£1,234.56")   // 1234.56
+ * parseMoney("GBP 1,234.56") // 1234.56
+ * parseMoney("−£10.00")     // -10 (Unicode minus U+2212)
+ * parseMoney("ZZZZ10.00")   // 10  (invalid-code fallback prefix)
+ * parseMoney("N/A")         // null
+ * parseMoney("")            // null
+ * parseMoney(null)          // null
+ */
+declare function parseMoney(value: string | null | undefined): number | null;
+
+export { type FormatCompactMoneyOptions, type FormatMoneyOptions, MONEY_FALLBACK_CURRENCY, MONEY_FALLBACK_LOCALE, type OrgReportingCurrency, formatCompactMoney, formatMoney, getCurrencySymbol, getOrgReportingCurrency, parseMoney, resolveOrgReportingCurrencyCode, setOrgReportingCurrency };

package/dist/money/index.js

@@ -1,51 +1,3 @@
-// src/money/format.ts
-var MONEY_FALLBACK_LOCALE = "en-GB";
-function formatMoney(amount, options) {
-  const { currencyCode, decimalPlaces, locale = MONEY_FALLBACK_LOCALE, symbol } = options;
-  const normalizedCode = currencyCode.toUpperCase();
-  try {
-    const formatter = new Intl.NumberFormat(locale, {
-      style: "currency",
-      currency: normalizedCode,
-      // Narrow symbol so a clear currency context renders "$100", not "US$100".
-      currencyDisplay: "narrowSymbol",
-      ...decimalPlaces != null ? { minimumFractionDigits: decimalPlaces, maximumFractionDigits: decimalPlaces } : {}
-    });
-    return formatter.format(amount);
-  } catch {
-    const fractionDigits = decimalPlaces ?? 2;
-    const prefix = symbol ?? normalizedCode;
-    const sign = amount < 0 ? "-" : "";
-    return `${sign}${prefix}${Math.abs(amount).toFixed(fractionDigits)}`;
-  }
-}
-function formatCompactMoney(amount, options) {
-  const { currencyCode, symbol, locale = MONEY_FALLBACK_LOCALE } = options;
-  const sym = getCurrencySymbol(currencyCode, locale, symbol);
-  const sign = amount < 0 ? "-" : "";
-  const abs = Math.abs(amount);
-  if (abs >= 1e6) {
-    return `${sign}${sym}${(abs / 1e6).toFixed(1)}m`;
-  }
-  if (abs >= 1e3) {
-    return `${sign}${sym}${(abs / 1e3).toFixed(0)}k`;
-  }
-  return `${sign}${sym}${abs.toFixed(0)}`;
-}
-function getCurrencySymbol(currencyCode, locale = MONEY_FALLBACK_LOCALE, symbol) {
-  const normalizedCode = currencyCode.toUpperCase();
-  try {
-    const parts = new Intl.NumberFormat(locale, {
-      style: "currency",
-      currency: normalizedCode,
-      currencyDisplay: "narrowSymbol"
-    }).formatToParts(0);
-    return parts.find((part) => part.type === "currency")?.value ?? symbol ?? normalizedCode;
-  } catch {
-    return symbol ?? normalizedCode;
-  }
-}
-
-export { MONEY_FALLBACK_LOCALE, formatCompactMoney, formatMoney, getCurrencySymbol };
+export { MONEY_FALLBACK_CURRENCY, MONEY_FALLBACK_LOCALE, formatCompactMoney, formatMoney, getCurrencySymbol, getOrgReportingCurrency, parseMoney, resolveOrgReportingCurrencyCode, setOrgReportingCurrency } from '../chunk-2F5FENXB.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/money/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/money/format.ts"],"names":[],"mappings":";AAqBO,IAAM,qBAAA,GAAwB;AA4B9B,SAAS,WAAA,CAAY,QAAgB,OAAA,EAAqC;AAC/E,EAAA,MAAM,EAAE,YAAA,EAAc,aAAA,EAAe,MAAA,GAAS,qBAAA,EAAuB,QAAO,GAAI,OAAA;AAIhF,EAAA,MAAM,cAAA,GAAiB,aAAa,WAAA,EAAY;AAEhD,EAAA,IAAI;AACF,IAAA,MAAM,SAAA,GAAY,IAAI,IAAA,CAAK,YAAA,CAAa,MAAA,EAAQ;AAAA,MAC9C,KAAA,EAAO,UAAA;AAAA,MACP,QAAA,EAAU,cAAA;AAAA;AAAA,MAEV,eAAA,EAAiB,cAAA;AAAA,MACjB,GAAI,iBAAiB,IAAA,GACjB,EAAE,uBAAuB,aAAA,EAAe,qBAAA,EAAuB,aAAA,EAAc,GAC7E;AAAC,KACN,CAAA;AACD,IAAA,OAAO,SAAA,CAAU,OAAO,MAAM,CAAA;AAAA,EAChC,CAAA,CAAA,MAAQ;AACN,IAAA,MAAM,iBAAiB,aAAA,IAAiB,CAAA;AACxC,IAAA,MAAM,SAAS,MAAA,IAAU,cAAA;AAEzB,IAAA,MAAM,IAAA,GAAO,MAAA,GAAS,CAAA,GAAI,GAAA,GAAM,EAAA;AAChC,IAAA,OAAO,CAAA,EAAG,IAAI,CAAA,EAAG,MAAM,CAAA,EAAG,IAAA,CAAK,GAAA,CAAI,MAAM,CAAA,CAAE,OAAA,CAAQ,cAAc,CAAC,CAAA,CAAA;AAAA,EACpE;AACF;AA8BO,SAAS,kBAAA,CAAmB,QAAgB,OAAA,EAA4C;AAC7F,EAAA,MAAM,EAAE,YAAA,EAAc,MAAA,EAAQ,MAAA,GAAS,uBAAsB,GAAI,OAAA;AAEjE,EAAA,MAAM,GAAA,GAAM,iBAAA,CAAkB,YAAA,EAAc,MAAA,EAAQ,MAAM,CAAA;AAC1D,EAAA,MAAM,IAAA,GAAO,MAAA,GAAS,CAAA,GAAI,GAAA,GAAM,EAAA;AAChC,EAAA,MAAM,GAAA,GAAM,IAAA,CAAK,GAAA,CAAI,MAAM,CAAA;AAE3B,EAAA,IAAI,OAAO,GAAA,EAAW;AACpB,IAAA,OAAO,CAAA,EAAG,IAAI,CAAA,EAAG,GAAG,IAAI,GAAA,GAAM,GAAA,EAAW,OAAA,CAAQ,CAAC,CAAC,CAAA,CAAA,CAAA;AAAA,EACrD;AACA,EAAA,IAAI,OAAO,GAAA,EAAO;AAChB,IAAA,OAAO,CAAA,EAAG,IAAI,CAAA,EAAG,GAAG,IAAI,GAAA,GAAM,GAAA,EAAO,OAAA,CAAQ,CAAC,CAAC,CAAA,CAAA,CAAA;AAAA,EACjD;AACA,EAAA,OAAO,CAAA,EAAG,IAAI,CAAA,EAAG,GAAG,GAAG,GAAA,CAAI,OAAA,CAAQ,CAAC,CAAC,CAAA,CAAA;AACvC;AAOO,SAAS,iBAAA,CACd,YAAA,EACA,MAAA,GAAiB,qBAAA,EACjB,MAAA,EACQ;AAER,EAAA,MAAM,cAAA,GAAiB,aAAa,WAAA,EAAY;AAEhD,EAAA,IAAI;AACF,IAAA,MAAM,KAAA,GAAQ,IAAI,IAAA,CAAK,YAAA,CAAa,MAAA,EAAQ;AAAA,MAC1C,KAAA,EAAO,UAAA;AAAA,MACP,QAAA,EAAU,cAAA;AAAA,MACV,eAAA,EAAiB;AAAA,KAClB,CAAA,CAAE,aAAA,CAAc,CAAC,CAAA;AAElB,IAAA,OAAO,KAAA,CAAM,KAAK,CAAC,IAAA,KAAS,KAAK,IAAA,KAAS,UAAU,CAAA,EAAG,KAAA,IAAS,MAAA,IAAU,cAAA;AAAA,EAC5E,CAAA,CAAA,MAAQ;AACN,IAAA,OAAO,MAAA,IAAU,cAAA;AAAA,EACnB;AACF","file":"index.js","sourcesContent":["/**\n * Framework-agnostic money DISPLAY formatting.\n *\n * The platform stores amounts as a plain number plus a currency (an ISO 4217 code,\n * optionally a symbol and a decimal-places override from the host `Currency` row).\n * This module turns that into a localized string via `Intl.NumberFormat`, with a\n * deterministic fallback so output is machine-stable regardless of the host OS\n * locale - the same principle as the date org-format seam.\n *\n * It is pure - no React, no host access - so it lives in core-utils behind the\n * `@ethisyscore/core-utils/money` sub-path. Resolving WHICH currency to render in\n * (the amount's own currency, or the org's reporting currency) and CONVERTING\n * between currencies are host-aware concerns handled by the plugin-ui `useCurrency`\n * hook, which formats through this module.\n */\n\n/**\n * Deterministic fallback locale. Matches the date seam's UK fallback so money and\n * dates render consistently when no explicit locale is supplied, and so output does\n * not drift with the OS locale of whatever host renders it.\n */\nexport const MONEY_FALLBACK_LOCALE = \"en-GB\";\n\n/** Options for {@link formatMoney}. */\nexport interface FormatMoneyOptions {\n  /** ISO 4217 code (e.g. `\"GBP\"`, `\"EUR\"`) - drives `Intl` currency formatting. */\n  currencyCode: string;\n  /**\n   * Fraction digits to show. When null/undefined, `Intl`'s per-currency default is\n   * used (GBP -> 2, JPY -> 0). Pass a number to force a currency's decimal-places\n   * override from the host `Currency` row.\n   */\n  decimalPlaces?: number | null;\n  /** BCP-47 locale; defaults to {@link MONEY_FALLBACK_LOCALE} for stable output. */\n  locale?: string;\n  /**\n   * Symbol to use only in the fallback path when `Intl` cannot format the currency\n   * code (e.g. a non-ISO custom code). Ignored on the happy path, where `Intl`\n   * supplies the symbol.\n   */\n  symbol?: string | null;\n}\n\n/**\n * Formats a monetary amount in the given currency. On an unknown/invalid currency\n * code (which makes `Intl.NumberFormat` throw) it falls back to a symbol/code prefix\n * plus the fixed-decimal amount, so a bad code degrades to a readable string rather\n * than throwing on a render path.\n */\nexport function formatMoney(amount: number, options: FormatMoneyOptions): string {\n  const { currencyCode, decimalPlaces, locale = MONEY_FALLBACK_LOCALE, symbol } = options;\n\n  // Intl.NumberFormat requires a well-formed (uppercase) ISO 4217 code; a lowercase\n  // code (e.g. \"usd\") throws and forces the fallback, so normalise up front.\n  const normalizedCode = currencyCode.toUpperCase();\n\n  try {\n    const formatter = new Intl.NumberFormat(locale, {\n      style: \"currency\",\n      currency: normalizedCode,\n      // Narrow symbol so a clear currency context renders \"$100\", not \"US$100\".\n      currencyDisplay: \"narrowSymbol\",\n      ...(decimalPlaces != null\n        ? { minimumFractionDigits: decimalPlaces, maximumFractionDigits: decimalPlaces }\n        : {}),\n    });\n    return formatter.format(amount);\n  } catch {\n    const fractionDigits = decimalPlaces ?? 2;\n    const prefix = symbol ?? normalizedCode;\n    // Keep the minus sign before the symbol/code prefix (\"-£10.00\", not \"£-10.00\").\n    const sign = amount < 0 ? \"-\" : \"\";\n    return `${sign}${prefix}${Math.abs(amount).toFixed(fractionDigits)}`;\n  }\n}\n\n/** Options for {@link formatCompactMoney}. */\nexport interface FormatCompactMoneyOptions {\n  /** ISO 4217 code (e.g. `\"GBP\"`, `\"EUR\"`) - resolves the leading symbol. */\n  currencyCode: string;\n  /**\n   * Fallback symbol used ONLY when `Intl` cannot resolve `currencyCode` (a non-ISO\n   * custom code). For a valid ISO code `Intl`'s own symbol always wins - this option\n   * does not override it. Mirrors {@link FormatMoneyOptions.symbol} and the\n   * {@link getCurrencySymbol} fallback contract.\n   */\n  symbol?: string | null;\n  /** BCP-47 locale used only to resolve the symbol; defaults to {@link MONEY_FALLBACK_LOCALE}. */\n  locale?: string;\n}\n\n/**\n * Formats an amount as an abbreviated currency string for compact display, such\n * as chart axis ticks where space is tight - e.g. `\"£1.3m\"`, `\"£500k\"`, `\"£99\"`.\n *\n * Thresholds on the absolute value: >= 1,000,000 renders in millions with a\n * lowercase `m` and one decimal place; >= 1,000 renders in thousands with a\n * lowercase `k` and no decimals; otherwise the whole amount with no decimals.\n * A leading minus is kept before the symbol (e.g. `\"-£1.3m\"`).\n *\n * Unlike {@link formatMoney} this is NOT org-locale driven beyond resolving the\n * leading symbol via {@link getCurrencySymbol}; the number itself is formatted\n * with fixed abbreviations so axis labels stay short and machine-stable.\n */\nexport function formatCompactMoney(amount: number, options: FormatCompactMoneyOptions): string {\n  const { currencyCode, symbol, locale = MONEY_FALLBACK_LOCALE } = options;\n\n  const sym = getCurrencySymbol(currencyCode, locale, symbol);\n  const sign = amount < 0 ? \"-\" : \"\";\n  const abs = Math.abs(amount);\n\n  if (abs >= 1_000_000) {\n    return `${sign}${sym}${(abs / 1_000_000).toFixed(1)}m`;\n  }\n  if (abs >= 1_000) {\n    return `${sign}${sym}${(abs / 1_000).toFixed(0)}k`;\n  }\n  return `${sign}${sym}${abs.toFixed(0)}`;\n}\n\n/**\n * Resolves the currency symbol for a code in a locale (e.g. `\"GBP\"` -> `\"£\"`),\n * for use in input adornments and labels. Falls back to the supplied `symbol`, then\n * the code itself, when `Intl` cannot resolve it.\n */\nexport function getCurrencySymbol(\n  currencyCode: string,\n  locale: string = MONEY_FALLBACK_LOCALE,\n  symbol?: string | null,\n): string {\n  // Intl needs an uppercase ISO code; a lowercase one throws (see formatMoney).\n  const normalizedCode = currencyCode.toUpperCase();\n\n  try {\n    const parts = new Intl.NumberFormat(locale, {\n      style: \"currency\",\n      currency: normalizedCode,\n      currencyDisplay: \"narrowSymbol\",\n    }).formatToParts(0);\n\n    return parts.find((part) => part.type === \"currency\")?.value ?? symbol ?? normalizedCode;\n  } catch {\n    return symbol ?? normalizedCode;\n  }\n}\n"]}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/number/index.cjs

@@ -1,23 +1,20 @@
 'use strict';
 
-// src/number/format.ts
-var NUMBER_FALLBACK_LOCALE = "en-GB";
-function formatNumber(value, options) {
-  if (value == null) {
-    return "\u2014";
-  }
-  const dp = options?.decimalPlaces ?? 2;
-  return new Intl.NumberFormat(options?.locale ?? NUMBER_FALLBACK_LOCALE, {
-    minimumFractionDigits: dp,
-    maximumFractionDigits: dp
-  }).format(value);
-}
-function formatPercent(ratio, options) {
-  return `${(ratio * 100).toFixed(options?.decimalPlaces ?? 2)}%`;
-}
+var chunkRLPXYKSM_cjs = require('../chunk-RLPXYKSM.cjs');
 
-exports.NUMBER_FALLBACK_LOCALE = NUMBER_FALLBACK_LOCALE;
-exports.formatNumber = formatNumber;
-exports.formatPercent = formatPercent;
+
+
+Object.defineProperty(exports, "NUMBER_FALLBACK_LOCALE", {
+  enumerable: true,
+  get: function () { return chunkRLPXYKSM_cjs.NUMBER_FALLBACK_LOCALE; }
+});
+Object.defineProperty(exports, "formatNumber", {
+  enumerable: true,
+  get: function () { return chunkRLPXYKSM_cjs.formatNumber; }
+});
+Object.defineProperty(exports, "formatPercent", {
+  enumerable: true,
+  get: function () { return chunkRLPXYKSM_cjs.formatPercent; }
+});
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/number/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/number/format.ts"],"names":[],"mappings":";;;AAgBO,IAAM,sBAAA,GAAyB;AAS/B,SAAS,YAAA,CACd,OACA,OAAA,EACQ;AACR,EAAA,IAAI,SAAS,IAAA,EAAM;AACjB,IAAA,OAAO,QAAA;AAAA,EACT;AAEA,EAAA,MAAM,EAAA,GAAK,SAAS,aAAA,IAAiB,CAAA;AACrC,EAAA,OAAO,IAAI,IAAA,CAAK,YAAA,CAAa,OAAA,EAAS,UAAU,sBAAA,EAAwB;AAAA,IACtE,qBAAA,EAAuB,EAAA;AAAA,IACvB,qBAAA,EAAuB;AAAA,GACxB,CAAA,CAAE,MAAA,CAAO,KAAK,CAAA;AACjB;AAWO,SAAS,aAAA,CAAc,OAAe,OAAA,EAA8C;AACzF,EAAA,OAAO,IAAI,KAAA,GAAQ,GAAA,EAAK,QAAQ,OAAA,EAAS,aAAA,IAAiB,CAAC,CAAC,CAAA,CAAA,CAAA;AAC9D","file":"index.cjs","sourcesContent":["/**\n * Framework-agnostic number DISPLAY formatting.\n *\n * Pure helpers for rendering plain numeric values and ratios as strings, with a\n * deterministic `en-GB` fallback locale so output is machine-stable regardless\n * of the host OS locale - the same principle as the money and date seams.\n *\n * It is pure - no React, no host access - so it lives in core-utils behind the\n * `@ethisyscore/core-utils/number` sub-path.\n */\n\n/**\n * Deterministic fallback locale. Matches the money/date seams so numbers render\n * consistently when no explicit locale is supplied, and so output does not drift\n * with the OS locale of whatever host renders it.\n */\nexport const NUMBER_FALLBACK_LOCALE = \"en-GB\";\n\n/**\n * Formats a numeric value with grouping and a fixed number of decimal places via\n * `Intl.NumberFormat`. Returns an em-dash (`\"—\"`) for null/undefined so an\n * absent value renders as a readable placeholder rather than `\"NaN\"` or `\"null\"`.\n *\n * Defaults to two decimal places in {@link NUMBER_FALLBACK_LOCALE}.\n */\nexport function formatNumber(\n  value: number | null | undefined,\n  options?: { decimalPlaces?: number; locale?: string },\n): string {\n  if (value == null) {\n    return \"—\";\n  }\n\n  const dp = options?.decimalPlaces ?? 2;\n  return new Intl.NumberFormat(options?.locale ?? NUMBER_FALLBACK_LOCALE, {\n    minimumFractionDigits: dp,\n    maximumFractionDigits: dp,\n  }).format(value);\n}\n\n/**\n * Formats a RATIO as a percentage string with a fixed number of decimal places -\n * e.g. `0.1234` -> `\"12.34%\"`. The input is a ratio, not an already-scaled\n * percentage.\n *\n * Uses `toFixed` (no grouping) rather than `Intl` percent style so output is a\n * plain fixed-decimal percentage, matching what callers expect on compact labels.\n * Defaults to two decimal places.\n */\nexport function formatPercent(ratio: number, options?: { decimalPlaces?: number }): string {\n  return `${(ratio * 100).toFixed(options?.decimalPlaces ?? 2)}%`;\n}\n"]}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.cjs"}

package/dist/number/index.js

@@ -1,19 +1,3 @@
-// src/number/format.ts
-var NUMBER_FALLBACK_LOCALE = "en-GB";
-function formatNumber(value, options) {
-  if (value == null) {
-    return "\u2014";
-  }
-  const dp = options?.decimalPlaces ?? 2;
-  return new Intl.NumberFormat(options?.locale ?? NUMBER_FALLBACK_LOCALE, {
-    minimumFractionDigits: dp,
-    maximumFractionDigits: dp
-  }).format(value);
-}
-function formatPercent(ratio, options) {
-  return `${(ratio * 100).toFixed(options?.decimalPlaces ?? 2)}%`;
-}
-
-export { NUMBER_FALLBACK_LOCALE, formatNumber, formatPercent };
+export { NUMBER_FALLBACK_LOCALE, formatNumber, formatPercent } from '../chunk-ZQCGDT7D.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/number/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/number/format.ts"],"names":[],"mappings":";AAgBO,IAAM,sBAAA,GAAyB;AAS/B,SAAS,YAAA,CACd,OACA,OAAA,EACQ;AACR,EAAA,IAAI,SAAS,IAAA,EAAM;AACjB,IAAA,OAAO,QAAA;AAAA,EACT;AAEA,EAAA,MAAM,EAAA,GAAK,SAAS,aAAA,IAAiB,CAAA;AACrC,EAAA,OAAO,IAAI,IAAA,CAAK,YAAA,CAAa,OAAA,EAAS,UAAU,sBAAA,EAAwB;AAAA,IACtE,qBAAA,EAAuB,EAAA;AAAA,IACvB,qBAAA,EAAuB;AAAA,GACxB,CAAA,CAAE,MAAA,CAAO,KAAK,CAAA;AACjB;AAWO,SAAS,aAAA,CAAc,OAAe,OAAA,EAA8C;AACzF,EAAA,OAAO,IAAI,KAAA,GAAQ,GAAA,EAAK,QAAQ,OAAA,EAAS,aAAA,IAAiB,CAAC,CAAC,CAAA,CAAA,CAAA;AAC9D","file":"index.js","sourcesContent":["/**\n * Framework-agnostic number DISPLAY formatting.\n *\n * Pure helpers for rendering plain numeric values and ratios as strings, with a\n * deterministic `en-GB` fallback locale so output is machine-stable regardless\n * of the host OS locale - the same principle as the money and date seams.\n *\n * It is pure - no React, no host access - so it lives in core-utils behind the\n * `@ethisyscore/core-utils/number` sub-path.\n */\n\n/**\n * Deterministic fallback locale. Matches the money/date seams so numbers render\n * consistently when no explicit locale is supplied, and so output does not drift\n * with the OS locale of whatever host renders it.\n */\nexport const NUMBER_FALLBACK_LOCALE = \"en-GB\";\n\n/**\n * Formats a numeric value with grouping and a fixed number of decimal places via\n * `Intl.NumberFormat`. Returns an em-dash (`\"—\"`) for null/undefined so an\n * absent value renders as a readable placeholder rather than `\"NaN\"` or `\"null\"`.\n *\n * Defaults to two decimal places in {@link NUMBER_FALLBACK_LOCALE}.\n */\nexport function formatNumber(\n  value: number | null | undefined,\n  options?: { decimalPlaces?: number; locale?: string },\n): string {\n  if (value == null) {\n    return \"—\";\n  }\n\n  const dp = options?.decimalPlaces ?? 2;\n  return new Intl.NumberFormat(options?.locale ?? NUMBER_FALLBACK_LOCALE, {\n    minimumFractionDigits: dp,\n    maximumFractionDigits: dp,\n  }).format(value);\n}\n\n/**\n * Formats a RATIO as a percentage string with a fixed number of decimal places -\n * e.g. `0.1234` -> `\"12.34%\"`. The input is a ratio, not an already-scaled\n * percentage.\n *\n * Uses `toFixed` (no grouping) rather than `Intl` percent style so output is a\n * plain fixed-decimal percentage, matching what callers expect on compact labels.\n * Defaults to two decimal places.\n */\nexport function formatPercent(ratio: number, options?: { decimalPlaces?: number }): string {\n  return `${(ratio * 100).toFixed(options?.decimalPlaces ?? 2)}%`;\n}\n"]}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/patch/index.cjs

@@ -1,127 +1,28 @@
 'use strict';
 
-var mutative = require('mutative');
+var chunkP5FSVRZO_cjs = require('../chunk-P5FSVRZO.cjs');
 
-// src/patch/index.ts
-function generateJsonPatch(original, modified) {
-  if (!isSameType(original, modified)) {
-    if (original === modified) return [];
-    return [{ op: "replace", path: "", value: modified }];
-  }
-  const [, patches] = mutative.create(
-    original,
-    (draft) => {
-      applyChanges(draft, modified);
-    },
-    {
-      enablePatches: {
-        pathAsArray: false
-      }
-    }
-  );
-  return patches.map(
-    (patch) => ({
-      op: patch.op,
-      path: patch.path,
-      // explicitly check for value existence to satisfy strict null checks if needed
-      ...patch.op !== "remove" ? { value: patch.value } : {}
-    })
-  );
-}
-function applyChanges(draft, modified) {
-  if (isDeepEqual(draft, modified)) {
-    return;
-  }
-  if (Array.isArray(draft) && Array.isArray(modified)) {
-    const draftArray = draft;
-    draftArray.length = 0;
-    draftArray.push(...modified);
-    return;
-  }
-  if (isPlainObject(draft) && isPlainObject(modified)) {
-    const draftObj = draft;
-    const modifiedObj = modified;
-    for (const key of Object.keys(draftObj)) {
-      if (!Object.prototype.hasOwnProperty.call(modifiedObj, key)) {
-        delete draftObj[key];
-      }
-    }
-    for (const key of Object.keys(modifiedObj)) {
-      if (!isDeepEqual(draftObj[key], modifiedObj[key])) {
-        draftObj[key] = modifiedObj[key];
-      }
-    }
-    return;
-  }
-}
-function isDeepEqual(a, b) {
-  if (a === b) return true;
-  if (a === null || a === void 0 || b === null || b === void 0) {
-    return a === b;
-  }
-  if (typeof a !== typeof b) return false;
-  if (a instanceof Date && b instanceof Date) {
-    return a.getTime() === b.getTime();
-  }
-  if (Array.isArray(a) && Array.isArray(b)) {
-    if (a.length !== b.length) return false;
-    for (let i = 0; i < a.length; i++) {
-      if (!isDeepEqual(a[i], b[i])) return false;
-    }
-    return true;
-  }
-  if (typeof a === "object" && typeof b === "object") {
-    const objA = a;
-    const objB = b;
-    const keysA = Object.keys(objA);
-    const keysB = Object.keys(objB);
-    if (keysA.length !== keysB.length) return false;
-    for (const key of keysA) {
-      if (!Object.prototype.hasOwnProperty.call(objB, key)) return false;
-      if (!isDeepEqual(objA[key], objB[key])) return false;
-    }
-    return true;
-  }
-  return false;
-}
-function isPlainObject(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value) && !(value instanceof Date);
-}
-function isSameType(a, b) {
-  if (Array.isArray(a)) return Array.isArray(b);
-  if (Array.isArray(b)) return false;
-  if (a instanceof Date) return b instanceof Date;
-  if (a && typeof a === "object" && b && typeof b === "object") return true;
-  return typeof a === typeof b;
-}
-function applyJsonPatch(original, patches) {
-  const rootReplacement = patches.find((patch) => patch.path === "" && patch.op === "replace");
-  if (rootReplacement) {
-    return rootReplacement.value;
-  }
-  const nonRootPatches = patches.filter((patch) => patch.path !== "");
-  if (nonRootPatches.length === 0) {
-    return original;
-  }
-  return mutative.apply(original, nonRootPatches);
-}
-function isNullOrEmpty(patches) {
-  return !patches || patches.length === 0;
-}
-function hasPatches(patches) {
-  return patches.length > 0;
-}
-function deepClone(obj) {
-  if (typeof structuredClone === "function") {
-    return structuredClone(obj);
-  }
-  return JSON.parse(JSON.stringify(obj));
-}
 
-exports.applyJsonPatch = applyJsonPatch;
-exports.deepClone = deepClone;
-exports.generateJsonPatch = generateJsonPatch;
-exports.hasPatches = hasPatches;
-exports.isNullOrEmpty = isNullOrEmpty;
+
+Object.defineProperty(exports, "applyJsonPatch", {
+  enumerable: true,
+  get: function () { return chunkP5FSVRZO_cjs.applyJsonPatch; }
+});
+Object.defineProperty(exports, "deepClone", {
+  enumerable: true,
+  get: function () { return chunkP5FSVRZO_cjs.deepClone; }
+});
+Object.defineProperty(exports, "generateJsonPatch", {
+  enumerable: true,
+  get: function () { return chunkP5FSVRZO_cjs.generateJsonPatch; }
+});
+Object.defineProperty(exports, "hasPatches", {
+  enumerable: true,
+  get: function () { return chunkP5FSVRZO_cjs.hasPatches; }
+});
+Object.defineProperty(exports, "isNullOrEmpty", {
+  enumerable: true,
+  get: function () { return chunkP5FSVRZO_cjs.isNullOrEmpty; }
+});
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/patch/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/patch/index.ts"],"names":["create","apply"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * RFC 6902 JSON Patch helpers shared by the EthisysCore monolith and plugins.\n *\n * The wire shape (`JsonPatchOperation`) matches the backend SDK's\n * `EthisysCore.Plugin.Sdk.JsonPatchOperation` record, so a patch produced here by\n * {@link generateJsonPatch} is applied by `IEntityPatchService` on the server.\n */\nimport { apply, create } from \"mutative\";\n\n/** JSON Patch operation type. */\nexport type PatchOperation = \"add\" | \"remove\" | \"replace\";\n\n/**\n * A single JSON Patch operation (RFC 6902 compatible; mutative's format with a string path).\n */\nexport interface JsonPatchOperation {\n  /** The operation to be performed. */\n  op: PatchOperation;\n  /** JSON Pointer path (RFC 6902 format). */\n  path: string;\n  /** The value for add/replace operations. */\n  value?: unknown;\n  /** Source pointer for move/copy operations (backend `From`); unused by the generate/apply helpers. */\n  from?: string;\n}\n\n/** Array of JSON Patch operations. */\nexport type JsonPatch = JsonPatchOperation[];\n\n/**\n * Generates JSON Patch operations (RFC 6902).\n * Strictly typed, handles Date objects, and ignores key order.\n */\nexport function generateJsonPatch<T>(original: T, modified: T): JsonPatch {\n  // If types are completely different (e.g. Array vs Object), strict replacement.\n  if (!isSameType(original, modified)) {\n    // If both are strictly equal (e.g. both null), returns empty\n    if (original === modified) return [];\n    // If different, replace root\n    return [{ op: \"replace\", path: \"\", value: modified }];\n  }\n\n  const [, patches] = create(\n    original,\n    (draft) => {\n      // We can safely cast draft to unknown here because we control the recursion\n      applyChanges(draft, modified);\n    },\n    {\n      enablePatches: {\n        pathAsArray: false,\n      },\n    },\n  );\n\n  return patches.map(\n    (patch): JsonPatchOperation => ({\n      op: patch.op as \"add\" | \"remove\" | \"replace\",\n      path: patch.path as string,\n      // explicitly check for value existence to satisfy strict null checks if needed\n      ...(patch.op !== \"remove\" ? { value: patch.value } : {}),\n    }),\n  );\n}\n\n/**\n * Recursively applies changes to the Mutative draft.\n * Uses 'unknown' and Type Guards instead of 'any'.\n */\nfunction applyChanges(draft: unknown, modified: unknown): void {\n  // This handles Primitives, Dates, and identical References early\n  if (isDeepEqual(draft, modified)) {\n    return;\n  }\n\n  // We explicitly check isArray to safely access .length and .push\n  if (Array.isArray(draft) && Array.isArray(modified)) {\n    const draftArray = draft as Array<unknown>;\n    // Clear and Replace approach (safer for DTOs than diffing indices)\n    draftArray.length = 0;\n    draftArray.push(...modified);\n    return;\n  }\n\n  // We use type guards to ensure we can treat them as dictionaries\n  if (isPlainObject(draft) && isPlainObject(modified)) {\n    const draftObj = draft;\n    const modifiedObj = modified;\n\n    // A. Remove keys that don't exist in modified\n    for (const key of Object.keys(draftObj)) {\n      if (!Object.prototype.hasOwnProperty.call(modifiedObj, key)) {\n        delete draftObj[key];\n      }\n    }\n\n    // B. Add or update top-level keys. We deliberately do NOT recurse into nested objects: the backend\n    // patch applier (IEntityPatchService) supports only top-level property operations, so a changed\n    // nested object is replaced wholesale (path \"/key\"), never diffed into \"/key/child\" paths that the\n    // server would reject.\n    for (const key of Object.keys(modifiedObj)) {\n      if (!isDeepEqual(draftObj[key], modifiedObj[key])) {\n        draftObj[key] = modifiedObj[key];\n      }\n    }\n    return;\n  }\n}\n\n/**\n * Handles: Primitives, Arrays, Dates, Objects (order-independent), null/undefined\n */\nfunction isDeepEqual(a: unknown, b: unknown): boolean {\n  // Strict Reference & Primitive Check\n  if (a === b) return true;\n\n  // Null/Undefined Checks\n  if (a === null || a === undefined || b === null || b === undefined) {\n    return a === b;\n  }\n\n  // Type Mismatch\n  if (typeof a !== typeof b) return false;\n\n  // Date Objects\n  if (a instanceof Date && b instanceof Date) {\n    return a.getTime() === b.getTime();\n  }\n\n  // Arrays\n  if (Array.isArray(a) && Array.isArray(b)) {\n    if (a.length !== b.length) return false;\n    for (let i = 0; i < a.length; i++) {\n      if (!isDeepEqual(a[i], b[i])) return false;\n    }\n    return true;\n  }\n\n  // Objects\n  if (typeof a === \"object\" && typeof b === \"object\") {\n    // Treat as Record<string, unknown> safely\n    const objA = a as Record<string, unknown>;\n    const objB = b as Record<string, unknown>;\n\n    const keysA = Object.keys(objA);\n    const keysB = Object.keys(objB);\n\n    if (keysA.length !== keysB.length) return false;\n\n    for (const key of keysA) {\n      if (!Object.prototype.hasOwnProperty.call(objB, key)) return false;\n      if (!isDeepEqual(objA[key], objB[key])) return false;\n    }\n    return true;\n  }\n\n  return false;\n}\n\n/**\n * Type Guard: Checks if value is a plain object (not null, array, or Date)\n * Allows safe casting to Record<string, unknown>\n */\nfunction isPlainObject(value: unknown): value is Record<string, unknown> {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    !Array.isArray(value) &&\n    !(value instanceof Date)\n  );\n}\n\n/**\n * Helper: Checks if two values share a high-level type category\n */\nfunction isSameType(a: unknown, b: unknown): boolean {\n  if (Array.isArray(a)) return Array.isArray(b);\n  if (Array.isArray(b)) return false;\n  if (a instanceof Date) return b instanceof Date;\n  if (a && typeof a === \"object\" && b && typeof b === \"object\") return true;\n  return typeof a === typeof b;\n}\n\n/**\n * Applies JSON Patch operations to an object using Mutative.\n * @param original - The original object\n * @param patches - Array of JSON Patch operations to apply\n * @returns The patched object (immutable)\n */\nexport function applyJsonPatch<T>(original: T, patches: JsonPatch): T {\n  // Check for root replacement first - if found, it should be the only operation\n  const rootReplacement = patches.find((patch) => patch.path === \"\" && patch.op === \"replace\");\n  if (rootReplacement) {\n    return rootReplacement.value as T;\n  }\n\n  // Filter out any root operations that might interfere and apply the rest\n  const nonRootPatches = patches.filter((patch) => patch.path !== \"\");\n  if (nonRootPatches.length === 0) {\n    return original;\n  }\n\n  // Mutative's apply function expects patches in RFC 6902 format, which is what we have\n  return apply(original as Record<string, unknown>, nonRootPatches) as T;\n}\n\n/**\n * Checks if a patch array is empty (null, undefined, or empty array).\n * @param patches - Array of patch operations or null/undefined\n * @returns True if patches is null, undefined, or empty array\n */\nexport function isNullOrEmpty(patches: JsonPatch | null | undefined): boolean {\n  return !patches || patches.length === 0;\n}\n\n/**\n * Checks if a patch array has any operations.\n * @param patches - Array of patch operations\n * @returns True if patches array has operations, false if empty\n */\nexport function hasPatches(patches: JsonPatch): boolean {\n  return patches.length > 0;\n}\n\n/**\n * Creates a deep clone of an object.\n * Useful for creating the \"modified\" version before generating patches.\n * @param obj - Object to clone\n * @returns Deep cloned object\n */\nexport function deepClone<T>(obj: T): T {\n  // structuredClone preserves Dates (and undefined); fall back to JSON clone on legacy runtimes.\n  if (typeof structuredClone === \"function\") {\n    return structuredClone(obj);\n  }\n  return JSON.parse(JSON.stringify(obj));\n}\n"]}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.cjs"}

package/dist/patch/index.js

@@ -1,121 +1,3 @@
-import { create, apply } from 'mutative';
-
-// src/patch/index.ts
-function generateJsonPatch(original, modified) {
-  if (!isSameType(original, modified)) {
-    if (original === modified) return [];
-    return [{ op: "replace", path: "", value: modified }];
-  }
-  const [, patches] = create(
-    original,
-    (draft) => {
-      applyChanges(draft, modified);
-    },
-    {
-      enablePatches: {
-        pathAsArray: false
-      }
-    }
-  );
-  return patches.map(
-    (patch) => ({
-      op: patch.op,
-      path: patch.path,
-      // explicitly check for value existence to satisfy strict null checks if needed
-      ...patch.op !== "remove" ? { value: patch.value } : {}
-    })
-  );
-}
-function applyChanges(draft, modified) {
-  if (isDeepEqual(draft, modified)) {
-    return;
-  }
-  if (Array.isArray(draft) && Array.isArray(modified)) {
-    const draftArray = draft;
-    draftArray.length = 0;
-    draftArray.push(...modified);
-    return;
-  }
-  if (isPlainObject(draft) && isPlainObject(modified)) {
-    const draftObj = draft;
-    const modifiedObj = modified;
-    for (const key of Object.keys(draftObj)) {
-      if (!Object.prototype.hasOwnProperty.call(modifiedObj, key)) {
-        delete draftObj[key];
-      }
-    }
-    for (const key of Object.keys(modifiedObj)) {
-      if (!isDeepEqual(draftObj[key], modifiedObj[key])) {
-        draftObj[key] = modifiedObj[key];
-      }
-    }
-    return;
-  }
-}
-function isDeepEqual(a, b) {
-  if (a === b) return true;
-  if (a === null || a === void 0 || b === null || b === void 0) {
-    return a === b;
-  }
-  if (typeof a !== typeof b) return false;
-  if (a instanceof Date && b instanceof Date) {
-    return a.getTime() === b.getTime();
-  }
-  if (Array.isArray(a) && Array.isArray(b)) {
-    if (a.length !== b.length) return false;
-    for (let i = 0; i < a.length; i++) {
-      if (!isDeepEqual(a[i], b[i])) return false;
-    }
-    return true;
-  }
-  if (typeof a === "object" && typeof b === "object") {
-    const objA = a;
-    const objB = b;
-    const keysA = Object.keys(objA);
-    const keysB = Object.keys(objB);
-    if (keysA.length !== keysB.length) return false;
-    for (const key of keysA) {
-      if (!Object.prototype.hasOwnProperty.call(objB, key)) return false;
-      if (!isDeepEqual(objA[key], objB[key])) return false;
-    }
-    return true;
-  }
-  return false;
-}
-function isPlainObject(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value) && !(value instanceof Date);
-}
-function isSameType(a, b) {
-  if (Array.isArray(a)) return Array.isArray(b);
-  if (Array.isArray(b)) return false;
-  if (a instanceof Date) return b instanceof Date;
-  if (a && typeof a === "object" && b && typeof b === "object") return true;
-  return typeof a === typeof b;
-}
-function applyJsonPatch(original, patches) {
-  const rootReplacement = patches.find((patch) => patch.path === "" && patch.op === "replace");
-  if (rootReplacement) {
-    return rootReplacement.value;
-  }
-  const nonRootPatches = patches.filter((patch) => patch.path !== "");
-  if (nonRootPatches.length === 0) {
-    return original;
-  }
-  return apply(original, nonRootPatches);
-}
-function isNullOrEmpty(patches) {
-  return !patches || patches.length === 0;
-}
-function hasPatches(patches) {
-  return patches.length > 0;
-}
-function deepClone(obj) {
-  if (typeof structuredClone === "function") {
-    return structuredClone(obj);
-  }
-  return JSON.parse(JSON.stringify(obj));
-}
-
-export { applyJsonPatch, deepClone, generateJsonPatch, hasPatches, isNullOrEmpty };
+export { applyJsonPatch, deepClone, generateJsonPatch, hasPatches, isNullOrEmpty } from '../chunk-OEDAX6WN.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/patch/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/patch/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * RFC 6902 JSON Patch helpers shared by the EthisysCore monolith and plugins.\n *\n * The wire shape (`JsonPatchOperation`) matches the backend SDK's\n * `EthisysCore.Plugin.Sdk.JsonPatchOperation` record, so a patch produced here by\n * {@link generateJsonPatch} is applied by `IEntityPatchService` on the server.\n */\nimport { apply, create } from \"mutative\";\n\n/** JSON Patch operation type. */\nexport type PatchOperation = \"add\" | \"remove\" | \"replace\";\n\n/**\n * A single JSON Patch operation (RFC 6902 compatible; mutative's format with a string path).\n */\nexport interface JsonPatchOperation {\n  /** The operation to be performed. */\n  op: PatchOperation;\n  /** JSON Pointer path (RFC 6902 format). */\n  path: string;\n  /** The value for add/replace operations. */\n  value?: unknown;\n  /** Source pointer for move/copy operations (backend `From`); unused by the generate/apply helpers. */\n  from?: string;\n}\n\n/** Array of JSON Patch operations. */\nexport type JsonPatch = JsonPatchOperation[];\n\n/**\n * Generates JSON Patch operations (RFC 6902).\n * Strictly typed, handles Date objects, and ignores key order.\n */\nexport function generateJsonPatch<T>(original: T, modified: T): JsonPatch {\n  // If types are completely different (e.g. Array vs Object), strict replacement.\n  if (!isSameType(original, modified)) {\n    // If both are strictly equal (e.g. both null), returns empty\n    if (original === modified) return [];\n    // If different, replace root\n    return [{ op: \"replace\", path: \"\", value: modified }];\n  }\n\n  const [, patches] = create(\n    original,\n    (draft) => {\n      // We can safely cast draft to unknown here because we control the recursion\n      applyChanges(draft, modified);\n    },\n    {\n      enablePatches: {\n        pathAsArray: false,\n      },\n    },\n  );\n\n  return patches.map(\n    (patch): JsonPatchOperation => ({\n      op: patch.op as \"add\" | \"remove\" | \"replace\",\n      path: patch.path as string,\n      // explicitly check for value existence to satisfy strict null checks if needed\n      ...(patch.op !== \"remove\" ? { value: patch.value } : {}),\n    }),\n  );\n}\n\n/**\n * Recursively applies changes to the Mutative draft.\n * Uses 'unknown' and Type Guards instead of 'any'.\n */\nfunction applyChanges(draft: unknown, modified: unknown): void {\n  // This handles Primitives, Dates, and identical References early\n  if (isDeepEqual(draft, modified)) {\n    return;\n  }\n\n  // We explicitly check isArray to safely access .length and .push\n  if (Array.isArray(draft) && Array.isArray(modified)) {\n    const draftArray = draft as Array<unknown>;\n    // Clear and Replace approach (safer for DTOs than diffing indices)\n    draftArray.length = 0;\n    draftArray.push(...modified);\n    return;\n  }\n\n  // We use type guards to ensure we can treat them as dictionaries\n  if (isPlainObject(draft) && isPlainObject(modified)) {\n    const draftObj = draft;\n    const modifiedObj = modified;\n\n    // A. Remove keys that don't exist in modified\n    for (const key of Object.keys(draftObj)) {\n      if (!Object.prototype.hasOwnProperty.call(modifiedObj, key)) {\n        delete draftObj[key];\n      }\n    }\n\n    // B. Add or update top-level keys. We deliberately do NOT recurse into nested objects: the backend\n    // patch applier (IEntityPatchService) supports only top-level property operations, so a changed\n    // nested object is replaced wholesale (path \"/key\"), never diffed into \"/key/child\" paths that the\n    // server would reject.\n    for (const key of Object.keys(modifiedObj)) {\n      if (!isDeepEqual(draftObj[key], modifiedObj[key])) {\n        draftObj[key] = modifiedObj[key];\n      }\n    }\n    return;\n  }\n}\n\n/**\n * Handles: Primitives, Arrays, Dates, Objects (order-independent), null/undefined\n */\nfunction isDeepEqual(a: unknown, b: unknown): boolean {\n  // Strict Reference & Primitive Check\n  if (a === b) return true;\n\n  // Null/Undefined Checks\n  if (a === null || a === undefined || b === null || b === undefined) {\n    return a === b;\n  }\n\n  // Type Mismatch\n  if (typeof a !== typeof b) return false;\n\n  // Date Objects\n  if (a instanceof Date && b instanceof Date) {\n    return a.getTime() === b.getTime();\n  }\n\n  // Arrays\n  if (Array.isArray(a) && Array.isArray(b)) {\n    if (a.length !== b.length) return false;\n    for (let i = 0; i < a.length; i++) {\n      if (!isDeepEqual(a[i], b[i])) return false;\n    }\n    return true;\n  }\n\n  // Objects\n  if (typeof a === \"object\" && typeof b === \"object\") {\n    // Treat as Record<string, unknown> safely\n    const objA = a as Record<string, unknown>;\n    const objB = b as Record<string, unknown>;\n\n    const keysA = Object.keys(objA);\n    const keysB = Object.keys(objB);\n\n    if (keysA.length !== keysB.length) return false;\n\n    for (const key of keysA) {\n      if (!Object.prototype.hasOwnProperty.call(objB, key)) return false;\n      if (!isDeepEqual(objA[key], objB[key])) return false;\n    }\n    return true;\n  }\n\n  return false;\n}\n\n/**\n * Type Guard: Checks if value is a plain object (not null, array, or Date)\n * Allows safe casting to Record<string, unknown>\n */\nfunction isPlainObject(value: unknown): value is Record<string, unknown> {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    !Array.isArray(value) &&\n    !(value instanceof Date)\n  );\n}\n\n/**\n * Helper: Checks if two values share a high-level type category\n */\nfunction isSameType(a: unknown, b: unknown): boolean {\n  if (Array.isArray(a)) return Array.isArray(b);\n  if (Array.isArray(b)) return false;\n  if (a instanceof Date) return b instanceof Date;\n  if (a && typeof a === \"object\" && b && typeof b === \"object\") return true;\n  return typeof a === typeof b;\n}\n\n/**\n * Applies JSON Patch operations to an object using Mutative.\n * @param original - The original object\n * @param patches - Array of JSON Patch operations to apply\n * @returns The patched object (immutable)\n */\nexport function applyJsonPatch<T>(original: T, patches: JsonPatch): T {\n  // Check for root replacement first - if found, it should be the only operation\n  const rootReplacement = patches.find((patch) => patch.path === \"\" && patch.op === \"replace\");\n  if (rootReplacement) {\n    return rootReplacement.value as T;\n  }\n\n  // Filter out any root operations that might interfere and apply the rest\n  const nonRootPatches = patches.filter((patch) => patch.path !== \"\");\n  if (nonRootPatches.length === 0) {\n    return original;\n  }\n\n  // Mutative's apply function expects patches in RFC 6902 format, which is what we have\n  return apply(original as Record<string, unknown>, nonRootPatches) as T;\n}\n\n/**\n * Checks if a patch array is empty (null, undefined, or empty array).\n * @param patches - Array of patch operations or null/undefined\n * @returns True if patches is null, undefined, or empty array\n */\nexport function isNullOrEmpty(patches: JsonPatch | null | undefined): boolean {\n  return !patches || patches.length === 0;\n}\n\n/**\n * Checks if a patch array has any operations.\n * @param patches - Array of patch operations\n * @returns True if patches array has operations, false if empty\n */\nexport function hasPatches(patches: JsonPatch): boolean {\n  return patches.length > 0;\n}\n\n/**\n * Creates a deep clone of an object.\n * Useful for creating the \"modified\" version before generating patches.\n * @param obj - Object to clone\n * @returns Deep cloned object\n */\nexport function deepClone<T>(obj: T): T {\n  // structuredClone preserves Dates (and undefined); fall back to JSON clone on legacy runtimes.\n  if (typeof structuredClone === \"function\") {\n    return structuredClone(obj);\n  }\n  return JSON.parse(JSON.stringify(obj));\n}\n"]}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}