persian-data-grid 0.5.0 → 0.7.0

package/dist/finance.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Iranian money units (PR-140).
+ * Canonical storage is integer **rials** (same convention as `toMinorUnits`).
+ * 1 toman = 10 rials.
+ */
+type CurrencyUnit = 'rial' | 'toman';
+declare const RIALS_PER_TOMAN = 10;
+declare function rialToToman(rial: number): number;
+declare function tomanToRial(toman: number): number;
+declare function convertCurrency(amount: number, from: CurrencyUnit, to: CurrencyUnit): number;
+type FormatPriceOptions = {
+    /** Unit of the numeric `amount` argument. Default `rial`. */
+    unit?: CurrencyUnit;
+    /** Unit shown in the label suffix. Defaults to `unit`. */
+    displayUnit?: CurrencyUnit;
+    /** Append unit label (`ریال` / `تومان`). Default true. */
+    withLabel?: boolean;
+    /** Use Persian digits via Intl. Default true. */
+    persianDigits?: boolean;
+    locale?: string;
+};
+/**
+ * Format a money amount. Converts when `unit` ≠ `displayUnit`.
+ * Values are truncated to integers before conversion.
+ */
+declare function formatPrice(amount: number, options?: FormatPriceOptions): string;
+
+/**
+ * Integer → Persian words for document printing (PR-140).
+ * Covers non-negative integers up to 10^15 − 1 (تریلیون scale).
+ */
+type NumberToPersianWordsOptions = {
+    /** Append currency word (`ریال` / `تومان`). */
+    currency?: 'rial' | 'toman';
+    /** Prefix for negative numbers. Default `منفی`. */
+    negativeWord?: string;
+};
+/**
+ * Convert an integer (or truncatable number) to Persian words.
+ * Fractional parts are truncated toward zero.
+ */
+declare function numberToPersianWords(value: number | bigint, options?: NumberToPersianWordsOptions): string;
+
+/**
+ * Iranian financial (fiscal) periods on the Jalali calendar (PR-140).
+ * Iranian FY = 1 Farvardin … 29/30 Esfand of the same Jalali year.
+ */
+type FinancialPeriod = {
+    /** e.g. `fy-1404` */
+    id: string;
+    /** e.g. `سال مالی ۱۴۰۴` */
+    label: string;
+    /** Jalali year of the period */
+    jalaliYear: number;
+    start: Date;
+    end: Date;
+};
+/** Jalali year that owns this civil date for Iranian FY purposes. */
+declare function jalaliFinancialYear(date: Date): number;
+declare function financialPeriodForYear(jalaliYear: number): FinancialPeriod;
+declare function financialPeriodForDate(date: Date): FinancialPeriod;
+declare function listFinancialPeriods(fromJalaliYear: number, toJalaliYear: number): FinancialPeriod[];
+declare function isInFinancialPeriod(date: Date, period: FinancialPeriod): boolean;
+/** Inclusive list of month starts (1 … 12) for a FY. */
+declare function financialMonths(jalaliYear: number): Date[];
+
+/**
+ * Iranian official holidays (Jalali fixed dates) (PR-140).
+ * Lunar/Islamic moveable holidays can be merged via `extra`.
+ */
+type IranHoliday = {
+    /** Jalali month 1–12 */
+    jm: number;
+    /** Jalali day */
+    jd: number;
+    title: string;
+    /** When set, holiday applies only to that Jalali year */
+    jy?: number;
+};
+/** Civil / solar fixed holidays observed every Jalali year. */
+declare const IRAN_FIXED_HOLIDAYS: readonly IranHoliday[];
+declare function iranHolidaysForYear(jalaliYear: number, extra?: readonly IranHoliday[]): Array<IranHoliday & {
+    date: Date;
+}>;
+declare function isIranHoliday(date: Date, extra?: readonly IranHoliday[]): boolean;
+declare function holidayTitle(date: Date, extra?: readonly IranHoliday[]): string | null;
+/** Skip Fridays (Iran weekend) and holidays; returns next open day. */
+declare function nextBusinessDay(date: Date, extra?: readonly IranHoliday[]): Date;
+
+export { type CurrencyUnit, type FinancialPeriod, type FormatPriceOptions, IRAN_FIXED_HOLIDAYS, type IranHoliday, type NumberToPersianWordsOptions, RIALS_PER_TOMAN, convertCurrency, financialMonths, financialPeriodForDate, financialPeriodForYear, formatPrice, holidayTitle, iranHolidaysForYear, isInFinancialPeriod, isIranHoliday, jalaliFinancialYear, listFinancialPeriods, nextBusinessDay, numberToPersianWords, rialToToman, tomanToRial };

package/dist/finance.js

@@ -0,0 +1,157 @@
+export { IRAN_FIXED_HOLIDAYS, holidayTitle, iranHolidaysForYear, isIranHoliday, nextBusinessDay } from './chunk-W5256BJ4.js';
+export { RIALS_PER_TOMAN, convertCurrency, formatPrice, rialToToman, tomanToRial } from './chunk-RKVSJU46.js';
+import { gregorianDateToJalali, jalaliToGregorianDate, jalaliMonthLength } from './chunk-GQEDLUMB.js';
+import './chunk-AU3RDJYQ.js';
+
+// infrastructure/finance/numberToPersianWords.ts
+var ONES = [
+  "",
+  "\u06CC\u06A9",
+  "\u062F\u0648",
+  "\u0633\u0647",
+  "\u0686\u0647\u0627\u0631",
+  "\u067E\u0646\u062C",
+  "\u0634\u0634",
+  "\u0647\u0641\u062A",
+  "\u0647\u0634\u062A",
+  "\u0646\u0647",
+  "\u062F\u0647",
+  "\u06CC\u0627\u0632\u062F\u0647",
+  "\u062F\u0648\u0627\u0632\u062F\u0647",
+  "\u0633\u06CC\u0632\u062F\u0647",
+  "\u0686\u0647\u0627\u0631\u062F\u0647",
+  "\u067E\u0627\u0646\u0632\u062F\u0647",
+  "\u0634\u0627\u0646\u0632\u062F\u0647",
+  "\u0647\u0641\u062F\u0647",
+  "\u0647\u062C\u062F\u0647",
+  "\u0646\u0648\u0632\u062F\u0647"
+];
+var TENS = [
+  "",
+  "",
+  "\u0628\u06CC\u0633\u062A",
+  "\u0633\u06CC",
+  "\u0686\u0647\u0644",
+  "\u067E\u0646\u062C\u0627\u0647",
+  "\u0634\u0635\u062A",
+  "\u0647\u0641\u062A\u0627\u062F",
+  "\u0647\u0634\u062A\u0627\u062F",
+  "\u0646\u0648\u062F"
+];
+var HUNDREDS = [
+  "",
+  "\u0635\u062F",
+  "\u062F\u0648\u06CC\u0633\u062A",
+  "\u0633\u06CC\u0635\u062F",
+  "\u0686\u0647\u0627\u0631\u0635\u062F",
+  "\u067E\u0627\u0646\u0635\u062F",
+  "\u0634\u0634\u0635\u062F",
+  "\u0647\u0641\u062A\u0635\u062F",
+  "\u0647\u0634\u062A\u0635\u062F",
+  "\u0646\u0647\u0635\u062F"
+];
+var SCALES = ["", "\u0647\u0632\u0627\u0631", "\u0645\u06CC\u0644\u06CC\u0648\u0646", "\u0645\u06CC\u0644\u06CC\u0627\u0631\u062F", "\u062A\u0631\u06CC\u0644\u06CC\u0648\u0646"];
+function joinAnd(parts) {
+  return parts.filter(Boolean).join(" \u0648 ");
+}
+function underThousand(n) {
+  if (n <= 0) return "";
+  if (n < 20) return ONES[n];
+  if (n < 100) {
+    const ten = Math.floor(n / 10);
+    const one = n % 10;
+    return joinAnd([TENS[ten], ONES[one]]);
+  }
+  const hundred = Math.floor(n / 100);
+  const rest = n % 100;
+  return joinAnd([HUNDREDS[hundred], underThousand(rest)]);
+}
+function numberToPersianWords(value, options = {}) {
+  let n;
+  if (typeof value === "bigint") {
+    n = value;
+  } else {
+    if (!Number.isFinite(value)) return "";
+    n = BigInt(Math.trunc(value));
+  }
+  const negative = n < 0n;
+  if (negative) n = -n;
+  let words;
+  if (n === 0n) {
+    words = "\u0635\u0641\u0631";
+  } else {
+    const chunks = [];
+    let scale = 0;
+    let remaining = n;
+    while (remaining > 0n && scale < SCALES.length) {
+      const chunk = Number(remaining % 1000n);
+      remaining /= 1000n;
+      if (chunk > 0) {
+        const body = underThousand(chunk);
+        const scaleWord = SCALES[scale];
+        chunks.unshift(scaleWord ? `${body} ${scaleWord}` : body);
+      }
+      scale += 1;
+    }
+    if (remaining > 0n) {
+      words = n.toString();
+    } else {
+      words = joinAnd(chunks);
+    }
+  }
+  if (negative) {
+    words = `${options.negativeWord ?? "\u0645\u0646\u0641\u06CC"} ${words}`;
+  }
+  if (options.currency === "rial") return `${words} \u0631\u06CC\u0627\u0644`;
+  if (options.currency === "toman") return `${words} \u062A\u0648\u0645\u0627\u0646`;
+  return words;
+}
+
+// infrastructure/finance/financialPeriods.ts
+function utcDay(date) {
+  return new Date(
+    Date.UTC(date.getUTCFullYear(), date.getUTCMonth(), date.getUTCDate(), 12)
+  );
+}
+function jalaliFinancialYear(date) {
+  return gregorianDateToJalali(utcDay(date)).jy;
+}
+function financialPeriodForYear(jalaliYear) {
+  const start = jalaliToGregorianDate(jalaliYear, 1, 1);
+  const lastDay = jalaliMonthLength(jalaliYear, 12);
+  const end = jalaliToGregorianDate(jalaliYear, 12, lastDay);
+  return {
+    id: `fy-${jalaliYear}`,
+    label: `\u0633\u0627\u0644 \u0645\u0627\u0644\u06CC ${jalaliYear}`,
+    jalaliYear,
+    start,
+    end
+  };
+}
+function financialPeriodForDate(date) {
+  return financialPeriodForYear(jalaliFinancialYear(date));
+}
+function listFinancialPeriods(fromJalaliYear, toJalaliYear) {
+  const from = Math.min(fromJalaliYear, toJalaliYear);
+  const to = Math.max(fromJalaliYear, toJalaliYear);
+  const out = [];
+  for (let y = from; y <= to; y += 1) {
+    out.push(financialPeriodForYear(y));
+  }
+  return out;
+}
+function isInFinancialPeriod(date, period) {
+  const t = utcDay(date).getTime();
+  return t >= period.start.getTime() && t <= period.end.getTime();
+}
+function financialMonths(jalaliYear) {
+  const months = [];
+  for (let m = 1; m <= 12; m += 1) {
+    months.push(jalaliToGregorianDate(jalaliYear, m, 1));
+  }
+  return months;
+}
+
+export { financialMonths, financialPeriodForDate, financialPeriodForYear, isInFinancialPeriod, jalaliFinancialYear, listFinancialPeriods, numberToPersianWords };
+//# sourceMappingURL=finance.js.map
+//# sourceMappingURL=finance.js.map

package/dist/finance.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../infrastructure/finance/numberToPersianWords.ts","../infrastructure/finance/financialPeriods.ts"],"names":[],"mappings":"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","file":"finance.js","sourcesContent":["/**\r\n * Integer → Persian words for document printing (PR-140).\r\n * Covers non-negative integers up to 10^15 − 1 (تریلیون scale).\r\n */\r\n\r\nconst ONES = [\r\n  '',\r\n  'یک',\r\n  'دو',\r\n  'سه',\r\n  'چهار',\r\n  'پنج',\r\n  'شش',\r\n  'هفت',\r\n  'هشت',\r\n  'نه',\r\n  'ده',\r\n  'یازده',\r\n  'دوازده',\r\n  'سیزده',\r\n  'چهارده',\r\n  'پانزده',\r\n  'شانزده',\r\n  'هفده',\r\n  'هجده',\r\n  'نوزده',\r\n];\r\n\r\nconst TENS = [\r\n  '',\r\n  '',\r\n  'بیست',\r\n  'سی',\r\n  'چهل',\r\n  'پنجاه',\r\n  'شصت',\r\n  'هفتاد',\r\n  'هشتاد',\r\n  'نود',\r\n];\r\n\r\nconst HUNDREDS = [\r\n  '',\r\n  'صد',\r\n  'دویست',\r\n  'سیصد',\r\n  'چهارصد',\r\n  'پانصد',\r\n  'ششصد',\r\n  'هفتصد',\r\n  'هشتصد',\r\n  'نهصد',\r\n];\r\n\r\nconst SCALES = ['', 'هزار', 'میلیون', 'میلیارد', 'تریلیون'] as const;\r\n\r\nfunction joinAnd(parts: string[]): string {\r\n  return parts.filter(Boolean).join(' و ');\r\n}\r\n\r\nfunction underThousand(n: number): string {\r\n  if (n <= 0) return '';\r\n  if (n < 20) return ONES[n]!;\r\n  if (n < 100) {\r\n    const ten = Math.floor(n / 10);\r\n    const one = n % 10;\r\n    return joinAnd([TENS[ten]!, ONES[one]!]);\r\n  }\r\n  const hundred = Math.floor(n / 100);\r\n  const rest = n % 100;\r\n  return joinAnd([HUNDREDS[hundred]!, underThousand(rest)]);\r\n}\r\n\r\nexport type NumberToPersianWordsOptions = {\r\n  /** Append currency word (`ریال` / `تومان`). */\r\n  currency?: 'rial' | 'toman';\r\n  /** Prefix for negative numbers. Default `منفی`. */\r\n  negativeWord?: string;\r\n};\r\n\r\n/**\r\n * Convert an integer (or truncatable number) to Persian words.\r\n * Fractional parts are truncated toward zero.\r\n */\r\nexport function numberToPersianWords(\r\n  value: number | bigint,\r\n  options: NumberToPersianWordsOptions = {},\r\n): string {\r\n  let n: bigint;\r\n  if (typeof value === 'bigint') {\r\n    n = value;\r\n  } else {\r\n    if (!Number.isFinite(value)) return '';\r\n    n = BigInt(Math.trunc(value));\r\n  }\r\n\r\n  const negative = n < 0n;\r\n  if (negative) n = -n;\r\n\r\n  let words: string;\r\n  if (n === 0n) {\r\n    words = 'صفر';\r\n  } else {\r\n    const chunks: string[] = [];\r\n    let scale = 0;\r\n    let remaining = n;\r\n    while (remaining > 0n && scale < SCALES.length) {\r\n      const chunk = Number(remaining % 1000n);\r\n      remaining /= 1000n;\r\n      if (chunk > 0) {\r\n        const body = underThousand(chunk);\r\n        const scaleWord = SCALES[scale]!;\r\n        chunks.unshift(scaleWord ? `${body} ${scaleWord}` : body);\r\n      }\r\n      scale += 1;\r\n    }\r\n    if (remaining > 0n) {\r\n      // Beyond documented range — fall back to digit string\r\n      words = n.toString();\r\n    } else {\r\n      words = joinAnd(chunks);\r\n    }\r\n  }\r\n\r\n  if (negative) {\r\n    words = `${options.negativeWord ?? 'منفی'} ${words}`;\r\n  }\r\n\r\n  if (options.currency === 'rial') return `${words} ریال`;\r\n  if (options.currency === 'toman') return `${words} تومان`;\r\n  return words;\r\n}\r\n","/**\r\n * Iranian financial (fiscal) periods on the Jalali calendar (PR-140).\r\n * Iranian FY = 1 Farvardin … 29/30 Esfand of the same Jalali year.\r\n */\r\n\r\nimport {\r\n  gregorianDateToJalali,\r\n  jalaliMonthLength,\r\n  jalaliToGregorianDate,\r\n} from '../date/jalaliMath';\r\n\r\nexport type FinancialPeriod = {\r\n  /** e.g. `fy-1404` */\r\n  id: string;\r\n  /** e.g. `سال مالی ۱۴۰۴` */\r\n  label: string;\r\n  /** Jalali year of the period */\r\n  jalaliYear: number;\r\n  start: Date;\r\n  end: Date;\r\n};\r\n\r\nfunction utcDay(date: Date): Date {\r\n  return new Date(\r\n    Date.UTC(date.getUTCFullYear(), date.getUTCMonth(), date.getUTCDate(), 12),\r\n  );\r\n}\r\n\r\n/** Jalali year that owns this civil date for Iranian FY purposes. */\r\nexport function jalaliFinancialYear(date: Date): number {\r\n  return gregorianDateToJalali(utcDay(date)).jy;\r\n}\r\n\r\nexport function financialPeriodForYear(jalaliYear: number): FinancialPeriod {\r\n  const start = jalaliToGregorianDate(jalaliYear, 1, 1);\r\n  const lastDay = jalaliMonthLength(jalaliYear, 12);\r\n  const end = jalaliToGregorianDate(jalaliYear, 12, lastDay);\r\n  return {\r\n    id: `fy-${jalaliYear}`,\r\n    label: `سال مالی ${jalaliYear}`,\r\n    jalaliYear,\r\n    start,\r\n    end,\r\n  };\r\n}\r\n\r\nexport function financialPeriodForDate(date: Date): FinancialPeriod {\r\n  return financialPeriodForYear(jalaliFinancialYear(date));\r\n}\r\n\r\nexport function listFinancialPeriods(\r\n  fromJalaliYear: number,\r\n  toJalaliYear: number,\r\n): FinancialPeriod[] {\r\n  const from = Math.min(fromJalaliYear, toJalaliYear);\r\n  const to = Math.max(fromJalaliYear, toJalaliYear);\r\n  const out: FinancialPeriod[] = [];\r\n  for (let y = from; y <= to; y += 1) {\r\n    out.push(financialPeriodForYear(y));\r\n  }\r\n  return out;\r\n}\r\n\r\nexport function isInFinancialPeriod(\r\n  date: Date,\r\n  period: FinancialPeriod,\r\n): boolean {\r\n  const t = utcDay(date).getTime();\r\n  return t >= period.start.getTime() && t <= period.end.getTime();\r\n}\r\n\r\n/** Inclusive list of month starts (1 … 12) for a FY. */\r\nexport function financialMonths(jalaliYear: number): Date[] {\r\n  const months: Date[] = [];\r\n  for (let m = 1; m <= 12; m += 1) {\r\n    months.push(jalaliToGregorianDate(jalaliYear, m, 1));\r\n  }\r\n  return months;\r\n}\r\n"]}

package/dist/foldedColumn-IHDT4ARZ.cjs

@@ -0,0 +1,66 @@
+'use strict';
+
+// infrastructure/Repositories/paged/foldedColumn.ts
+function foldColumnSubscription(args) {
+  const { subscribe, iterate, reducer, seed, cb, onError } = args;
+  const mixHash = (h1, h2, token) => {
+    for (let i = 0; i < token.length; i++) {
+      const c = token.charCodeAt(i);
+      h1 = Math.imul(h1 ^ c, 16777619) >>> 0;
+      h2 = Math.imul(h2 ^ c, 2654435761) >>> 0;
+    }
+    return [h1, h2];
+  };
+  let cancelled = false;
+  let prev = "";
+  let inFlight = false;
+  let pending = false;
+  const notify = async () => {
+    if (cancelled) return;
+    if (inFlight) {
+      pending = true;
+      return;
+    }
+    inFlight = true;
+    try {
+      let acc = seed;
+      let hash = [2166136261, 5381];
+      let sawAny = false;
+      await iterate((item) => {
+        sawAny = true;
+        acc = reducer(acc, item);
+        hash = mixHash(
+          hash[0],
+          hash[1],
+          `${item.id}:${String(item.rowNum)}:${String(item.value)}`
+        );
+      });
+      if (cancelled) return;
+      const sig = sawAny ? `${hash[0]}:${hash[1]}` : "empty";
+      if (sig !== prev) {
+        prev = sig;
+        cb(acc);
+      }
+    } catch (e) {
+      onError?.(e);
+    } finally {
+      inFlight = false;
+      if (pending && !cancelled) {
+        pending = false;
+        void notify();
+      }
+    }
+  };
+  const unsubscribe = subscribe(() => {
+    void notify();
+  });
+  void notify();
+  return () => {
+    cancelled = true;
+    unsubscribe?.();
+  };
+}
+
+exports.foldColumnSubscription = foldColumnSubscription;
+//# sourceMappingURL=foldedColumn-IHDT4ARZ.cjs.map
+//# sourceMappingURL=foldedColumn-IHDT4ARZ.cjs.map

package/dist/foldedColumn-IHDT4ARZ.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../infrastructure/Repositories/paged/foldedColumn.ts"],"names":[],"mappings":";;;AAMO,SAAS,uBAA0B,IAAA,EAS3B;AACb,EAAA,MAAM,EAAE,SAAA,EAAW,OAAA,EAAS,SAAS,IAAA,EAAM,EAAA,EAAI,SAAQ,GAAI,IAAA;AAG3D,EAAA,MAAM,OAAA,GAAU,CAAC,EAAA,EAAY,EAAA,EAAY,KAAA,KAAoC;AAC3E,IAAA,KAAA,IAAS,CAAA,GAAI,CAAA,EAAG,CAAA,GAAI,KAAA,CAAM,QAAQ,CAAA,EAAA,EAAK;AACrC,MAAA,MAAM,CAAA,GAAI,KAAA,CAAM,UAAA,CAAW,CAAC,CAAA;AAC5B,MAAA,EAAA,GAAK,IAAA,CAAK,IAAA,CAAK,EAAA,GAAK,CAAA,EAAG,QAAQ,CAAA,KAAM,CAAA;AACrC,MAAA,EAAA,GAAK,IAAA,CAAK,IAAA,CAAK,EAAA,GAAK,CAAA,EAAG,UAAU,CAAA,KAAM,CAAA;AAAA,IACzC;AACA,IAAA,OAAO,CAAC,IAAI,EAAE,CAAA;AAAA,EAChB,CAAA;AAEA,EAAA,IAAI,SAAA,GAAY,KAAA;AAChB,EAAA,IAAI,IAAA,GAAO,EAAA;AACX,EAAA,IAAI,QAAA,GAAW,KAAA;AACf,EAAA,IAAI,OAAA,GAAU,KAAA;AAEd,EAAA,MAAM,SAAS,YAA2B;AACxC,IAAA,IAAI,SAAA,EAAW;AACf,IAAA,IAAI,QAAA,EAAU;AACZ,MAAA,OAAA,GAAU,IAAA;AACV,MAAA;AAAA,IACF;AACA,IAAA,QAAA,GAAW,IAAA;AACX,IAAA,IAAI;AACF,MAAA,IAAI,GAAA,GAAM,IAAA;AACV,MAAA,IAAI,IAAA,GAAyB,CAAC,UAAA,EAAY,IAAI,CAAA;AAC9C,MAAA,IAAI,MAAA,GAAS,KAAA;AACb,MAAA,MAAM,OAAA,CAAQ,CAAC,IAAA,KAAS;AACtB,QAAA,MAAA,GAAS,IAAA;AACT,QAAA,GAAA,GAAM,OAAA,CAAQ,KAAK,IAAI,CAAA;AACvB,QAAA,IAAA,GAAO,OAAA;AAAA,UACL,KAAK,CAAC,CAAA;AAAA,UACN,KAAK,CAAC,CAAA;AAAA,UACN,CAAA,EAAG,IAAA,CAAK,EAAE,CAAA,CAAA,EAAI,MAAA,CAAO,IAAA,CAAK,MAAM,CAAC,CAAA,CAAA,EAAI,MAAA,CAAO,IAAA,CAAK,KAAK,CAAC,CAAA;AAAA,SACzD;AAAA,MACF,CAAC,CAAA;AACD,MAAA,IAAI,SAAA,EAAW;AACf,MAAA,MAAM,GAAA,GAAM,MAAA,GAAS,CAAA,EAAG,IAAA,CAAK,CAAC,CAAC,CAAA,CAAA,EAAI,IAAA,CAAK,CAAC,CAAC,CAAA,CAAA,GAAK,OAAA;AAC/C,MAAA,IAAI,QAAQ,IAAA,EAAM;AAChB,QAAA,IAAA,GAAO,GAAA;AACP,QAAA,EAAA,CAAG,GAAG,CAAA;AAAA,MACR;AAAA,IACF,SAAS,CAAA,EAAG;AACV,MAAA,OAAA,GAAU,CAAC,CAAA;AAAA,IACb,CAAA,SAAE;AACA,MAAA,QAAA,GAAW,KAAA;AACX,MAAA,IAAI,OAAA,IAAW,CAAC,SAAA,EAAW;AACzB,QAAA,OAAA,GAAU,KAAA;AACV,QAAA,KAAK,MAAA,EAAO;AAAA,MACd;AAAA,IACF;AAAA,EACF,CAAA;AAEA,EAAA,MAAM,WAAA,GAAc,UAAU,MAAM;AAClC,IAAA,KAAK,MAAA,EAAO;AAAA,EACd,CAAC,CAAA;AACD,EAAA,KAAK,MAAA,EAAO;AAEZ,EAAA,OAAO,MAAM;AACX,IAAA,SAAA,GAAY,IAAA;AACZ,IAAA,WAAA,IAAc;AAAA,EAChB,CAAA;AACF","file":"foldedColumn-IHDT4ARZ.cjs","sourcesContent":["// Streamed column fold (Memory Iron Rule): folds every non-deleted item of a\r\n// column into a small accumulator and re-emits only when the data changed.\r\n// Loaded lazily with the paged kit — see `TableEngine.subscribeColumn`.\r\n\r\nexport type ColumnItem = { id: number; rowNum: unknown; value: unknown };\r\n\r\nexport function foldColumnSubscription<T>(args: {\r\n  /** Store tick source (any state change re-evaluates the fold). */\r\n  subscribe: (listener: () => void) => (() => void) | undefined;\r\n  /** Feeds every non-deleted item (streamed in batches by the caller). */\r\n  iterate: (onItem: (item: ColumnItem) => void) => Promise<void>;\r\n  reducer: (acc: T, item: ColumnItem) => T;\r\n  seed: T;\r\n  cb: (acc: T) => void;\r\n  onError?: (error: unknown) => void;\r\n}): () => void {\r\n  const { subscribe, iterate, reducer, seed, cb, onError } = args;\r\n\r\n  // Two independent FNV-style hashes over a per-item token — O(1) heap.\r\n  const mixHash = (h1: number, h2: number, token: string): [number, number] => {\r\n    for (let i = 0; i < token.length; i++) {\r\n      const c = token.charCodeAt(i);\r\n      h1 = Math.imul(h1 ^ c, 16777619) >>> 0;\r\n      h2 = Math.imul(h2 ^ c, 2654435761) >>> 0;\r\n    }\r\n    return [h1, h2];\r\n  };\r\n\r\n  let cancelled = false;\r\n  let prev = '';\r\n  let inFlight = false;\r\n  let pending = false;\r\n\r\n  const notify = async (): Promise<void> => {\r\n    if (cancelled) return;\r\n    if (inFlight) {\r\n      pending = true;\r\n      return;\r\n    }\r\n    inFlight = true;\r\n    try {\r\n      let acc = seed;\r\n      let hash: [number, number] = [2166136261, 5381];\r\n      let sawAny = false;\r\n      await iterate((item) => {\r\n        sawAny = true;\r\n        acc = reducer(acc, item);\r\n        hash = mixHash(\r\n          hash[0],\r\n          hash[1],\r\n          `${item.id}:${String(item.rowNum)}:${String(item.value)}`,\r\n        );\r\n      });\r\n      if (cancelled) return;\r\n      const sig = sawAny ? `${hash[0]}:${hash[1]}` : 'empty';\r\n      if (sig !== prev) {\r\n        prev = sig;\r\n        cb(acc);\r\n      }\r\n    } catch (e) {\r\n      onError?.(e);\r\n    } finally {\r\n      inFlight = false;\r\n      if (pending && !cancelled) {\r\n        pending = false;\r\n        void notify();\r\n      }\r\n    }\r\n  };\r\n\r\n  const unsubscribe = subscribe(() => {\r\n    void notify();\r\n  });\r\n  void notify();\r\n\r\n  return () => {\r\n    cancelled = true;\r\n    unsubscribe?.();\r\n  };\r\n}\r\n"]}

package/dist/foldedColumn-TFURUKFG.js

@@ -0,0 +1,64 @@
+// infrastructure/Repositories/paged/foldedColumn.ts
+function foldColumnSubscription(args) {
+  const { subscribe, iterate, reducer, seed, cb, onError } = args;
+  const mixHash = (h1, h2, token) => {
+    for (let i = 0; i < token.length; i++) {
+      const c = token.charCodeAt(i);
+      h1 = Math.imul(h1 ^ c, 16777619) >>> 0;
+      h2 = Math.imul(h2 ^ c, 2654435761) >>> 0;
+    }
+    return [h1, h2];
+  };
+  let cancelled = false;
+  let prev = "";
+  let inFlight = false;
+  let pending = false;
+  const notify = async () => {
+    if (cancelled) return;
+    if (inFlight) {
+      pending = true;
+      return;
+    }
+    inFlight = true;
+    try {
+      let acc = seed;
+      let hash = [2166136261, 5381];
+      let sawAny = false;
+      await iterate((item) => {
+        sawAny = true;
+        acc = reducer(acc, item);
+        hash = mixHash(
+          hash[0],
+          hash[1],
+          `${item.id}:${String(item.rowNum)}:${String(item.value)}`
+        );
+      });
+      if (cancelled) return;
+      const sig = sawAny ? `${hash[0]}:${hash[1]}` : "empty";
+      if (sig !== prev) {
+        prev = sig;
+        cb(acc);
+      }
+    } catch (e) {
+      onError?.(e);
+    } finally {
+      inFlight = false;
+      if (pending && !cancelled) {
+        pending = false;
+        void notify();
+      }
+    }
+  };
+  const unsubscribe = subscribe(() => {
+    void notify();
+  });
+  void notify();
+  return () => {
+    cancelled = true;
+    unsubscribe?.();
+  };
+}
+
+export { foldColumnSubscription };
+//# sourceMappingURL=foldedColumn-TFURUKFG.js.map
+//# sourceMappingURL=foldedColumn-TFURUKFG.js.map

package/dist/foldedColumn-TFURUKFG.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../infrastructure/Repositories/paged/foldedColumn.ts"],"names":[],"mappings":";AAMO,SAAS,uBAA0B,IAAA,EAS3B;AACb,EAAA,MAAM,EAAE,SAAA,EAAW,OAAA,EAAS,SAAS,IAAA,EAAM,EAAA,EAAI,SAAQ,GAAI,IAAA;AAG3D,EAAA,MAAM,OAAA,GAAU,CAAC,EAAA,EAAY,EAAA,EAAY,KAAA,KAAoC;AAC3E,IAAA,KAAA,IAAS,CAAA,GAAI,CAAA,EAAG,CAAA,GAAI,KAAA,CAAM,QAAQ,CAAA,EAAA,EAAK;AACrC,MAAA,MAAM,CAAA,GAAI,KAAA,CAAM,UAAA,CAAW,CAAC,CAAA;AAC5B,MAAA,EAAA,GAAK,IAAA,CAAK,IAAA,CAAK,EAAA,GAAK,CAAA,EAAG,QAAQ,CAAA,KAAM,CAAA;AACrC,MAAA,EAAA,GAAK,IAAA,CAAK,IAAA,CAAK,EAAA,GAAK,CAAA,EAAG,UAAU,CAAA,KAAM,CAAA;AAAA,IACzC;AACA,IAAA,OAAO,CAAC,IAAI,EAAE,CAAA;AAAA,EAChB,CAAA;AAEA,EAAA,IAAI,SAAA,GAAY,KAAA;AAChB,EAAA,IAAI,IAAA,GAAO,EAAA;AACX,EAAA,IAAI,QAAA,GAAW,KAAA;AACf,EAAA,IAAI,OAAA,GAAU,KAAA;AAEd,EAAA,MAAM,SAAS,YAA2B;AACxC,IAAA,IAAI,SAAA,EAAW;AACf,IAAA,IAAI,QAAA,EAAU;AACZ,MAAA,OAAA,GAAU,IAAA;AACV,MAAA;AAAA,IACF;AACA,IAAA,QAAA,GAAW,IAAA;AACX,IAAA,IAAI;AACF,MAAA,IAAI,GAAA,GAAM,IAAA;AACV,MAAA,IAAI,IAAA,GAAyB,CAAC,UAAA,EAAY,IAAI,CAAA;AAC9C,MAAA,IAAI,MAAA,GAAS,KAAA;AACb,MAAA,MAAM,OAAA,CAAQ,CAAC,IAAA,KAAS;AACtB,QAAA,MAAA,GAAS,IAAA;AACT,QAAA,GAAA,GAAM,OAAA,CAAQ,KAAK,IAAI,CAAA;AACvB,QAAA,IAAA,GAAO,OAAA;AAAA,UACL,KAAK,CAAC,CAAA;AAAA,UACN,KAAK,CAAC,CAAA;AAAA,UACN,CAAA,EAAG,IAAA,CAAK,EAAE,CAAA,CAAA,EAAI,MAAA,CAAO,IAAA,CAAK,MAAM,CAAC,CAAA,CAAA,EAAI,MAAA,CAAO,IAAA,CAAK,KAAK,CAAC,CAAA;AAAA,SACzD;AAAA,MACF,CAAC,CAAA;AACD,MAAA,IAAI,SAAA,EAAW;AACf,MAAA,MAAM,GAAA,GAAM,MAAA,GAAS,CAAA,EAAG,IAAA,CAAK,CAAC,CAAC,CAAA,CAAA,EAAI,IAAA,CAAK,CAAC,CAAC,CAAA,CAAA,GAAK,OAAA;AAC/C,MAAA,IAAI,QAAQ,IAAA,EAAM;AAChB,QAAA,IAAA,GAAO,GAAA;AACP,QAAA,EAAA,CAAG,GAAG,CAAA;AAAA,MACR;AAAA,IACF,SAAS,CAAA,EAAG;AACV,MAAA,OAAA,GAAU,CAAC,CAAA;AAAA,IACb,CAAA,SAAE;AACA,MAAA,QAAA,GAAW,KAAA;AACX,MAAA,IAAI,OAAA,IAAW,CAAC,SAAA,EAAW;AACzB,QAAA,OAAA,GAAU,KAAA;AACV,QAAA,KAAK,MAAA,EAAO;AAAA,MACd;AAAA,IACF;AAAA,EACF,CAAA;AAEA,EAAA,MAAM,WAAA,GAAc,UAAU,MAAM;AAClC,IAAA,KAAK,MAAA,EAAO;AAAA,EACd,CAAC,CAAA;AACD,EAAA,KAAK,MAAA,EAAO;AAEZ,EAAA,OAAO,MAAM;AACX,IAAA,SAAA,GAAY,IAAA;AACZ,IAAA,WAAA,IAAc;AAAA,EAChB,CAAA;AACF","file":"foldedColumn-TFURUKFG.js","sourcesContent":["// Streamed column fold (Memory Iron Rule): folds every non-deleted item of a\r\n// column into a small accumulator and re-emits only when the data changed.\r\n// Loaded lazily with the paged kit — see `TableEngine.subscribeColumn`.\r\n\r\nexport type ColumnItem = { id: number; rowNum: unknown; value: unknown };\r\n\r\nexport function foldColumnSubscription<T>(args: {\r\n  /** Store tick source (any state change re-evaluates the fold). */\r\n  subscribe: (listener: () => void) => (() => void) | undefined;\r\n  /** Feeds every non-deleted item (streamed in batches by the caller). */\r\n  iterate: (onItem: (item: ColumnItem) => void) => Promise<void>;\r\n  reducer: (acc: T, item: ColumnItem) => T;\r\n  seed: T;\r\n  cb: (acc: T) => void;\r\n  onError?: (error: unknown) => void;\r\n}): () => void {\r\n  const { subscribe, iterate, reducer, seed, cb, onError } = args;\r\n\r\n  // Two independent FNV-style hashes over a per-item token — O(1) heap.\r\n  const mixHash = (h1: number, h2: number, token: string): [number, number] => {\r\n    for (let i = 0; i < token.length; i++) {\r\n      const c = token.charCodeAt(i);\r\n      h1 = Math.imul(h1 ^ c, 16777619) >>> 0;\r\n      h2 = Math.imul(h2 ^ c, 2654435761) >>> 0;\r\n    }\r\n    return [h1, h2];\r\n  };\r\n\r\n  let cancelled = false;\r\n  let prev = '';\r\n  let inFlight = false;\r\n  let pending = false;\r\n\r\n  const notify = async (): Promise<void> => {\r\n    if (cancelled) return;\r\n    if (inFlight) {\r\n      pending = true;\r\n      return;\r\n    }\r\n    inFlight = true;\r\n    try {\r\n      let acc = seed;\r\n      let hash: [number, number] = [2166136261, 5381];\r\n      let sawAny = false;\r\n      await iterate((item) => {\r\n        sawAny = true;\r\n        acc = reducer(acc, item);\r\n        hash = mixHash(\r\n          hash[0],\r\n          hash[1],\r\n          `${item.id}:${String(item.rowNum)}:${String(item.value)}`,\r\n        );\r\n      });\r\n      if (cancelled) return;\r\n      const sig = sawAny ? `${hash[0]}:${hash[1]}` : 'empty';\r\n      if (sig !== prev) {\r\n        prev = sig;\r\n        cb(acc);\r\n      }\r\n    } catch (e) {\r\n      onError?.(e);\r\n    } finally {\r\n      inFlight = false;\r\n      if (pending && !cancelled) {\r\n        pending = false;\r\n        void notify();\r\n      }\r\n    }\r\n  };\r\n\r\n  const unsubscribe = subscribe(() => {\r\n    void notify();\r\n  });\r\n  void notify();\r\n\r\n  return () => {\r\n    cancelled = true;\r\n    unsubscribe?.();\r\n  };\r\n}\r\n"]}