@hexclave/shared 1.0.41 → 1.0.42

package/dist/utils/currencies.js.map

@@ -1 +1 @@
-{"version":3,"file":"currencies.js","names":[],"sources":["../../src/utils/currencies.tsx"],"sourcesContent":["import { moneyAmountSchema } from \"../schema-fields\";\nimport { SUPPORTED_CURRENCIES, type Currency, type MoneyAmount } from \"./currency-constants\";\nimport { HexclaveAssertionError } from \"./errors\";\n\nexport type SupportedCurrency = (typeof SUPPORTED_CURRENCIES)[number];\n\nexport function moneyAmountToStripeUnits(amount: MoneyAmount, currency: Currency): number {\n  const validated = moneyAmountSchema(currency).defined().validateSync(amount);\n  if (currency.stripeDecimals !== currency.decimals) {\n    throw new HexclaveAssertionError(\"unimplemented: TODO support different decimal configurations\");\n  }\n  // `moneyAmountSchema` accepts strings with 0..currency.decimals fractional\n  // digits, so we must right-pad the fractional part before stripping the dot.\n  // A naïve `replace('.', '')` underweights inputs like \"5\" → 5 (should be 500\n  // for USD) and \"0.5\" → 5 (should be 50).\n  const [whole, fractional = \"\"] = validated.split(\".\");\n  const paddedFractional = fractional.padEnd(currency.decimals, \"0\");\n  return Number.parseInt(whole + paddedFractional, 10);\n}\n\nimport.meta.vitest?.describe(\"moneyAmountToStripeUnits\", (test) => {\n  const USD = SUPPORTED_CURRENCIES.find((c) => c.code === \"USD\")!;\n\n  test(\"converts fully-padded USD amounts\", ({ expect }) => {\n    expect(moneyAmountToStripeUnits(\"5.00\" as MoneyAmount, USD)).toBe(500);\n    expect(moneyAmountToStripeUnits(\"0.01\" as MoneyAmount, USD)).toBe(1);\n    expect(moneyAmountToStripeUnits(\"12.34\" as MoneyAmount, USD)).toBe(1234);\n  });\n\n  test(\"converts whole-number USD amounts (no decimals)\", ({ expect }) => {\n    expect(moneyAmountToStripeUnits(\"5\" as MoneyAmount, USD)).toBe(500);\n    expect(moneyAmountToStripeUnits(\"10\" as MoneyAmount, USD)).toBe(1000);\n    expect(moneyAmountToStripeUnits(\"0\" as MoneyAmount, USD)).toBe(0);\n  });\n\n  test(\"converts USD amounts with one decimal digit\", ({ expect }) => {\n    expect(moneyAmountToStripeUnits(\"5.5\" as MoneyAmount, USD)).toBe(550);\n    expect(moneyAmountToStripeUnits(\"0.5\" as MoneyAmount, USD)).toBe(50);\n  });\n\n  test(\"matches stripeUnitsToMoneyAmount round-trip\", ({ expect }) => {\n    for (const cents of [0, 1, 5, 50, 99, 100, 1234, 100000]) {\n      const padded = `${Math.floor(cents / 100)}.${(cents % 100).toString().padStart(2, \"0\")}` as MoneyAmount;\n      expect(moneyAmountToStripeUnits(padded, USD)).toBe(cents);\n    }\n  });\n\n  test(\"rejects invalid money strings via schema\", ({ expect }) => {\n    expect(() => moneyAmountToStripeUnits(\"abc\" as MoneyAmount, USD)).toThrow();\n    expect(() => moneyAmountToStripeUnits(\"5.555\" as MoneyAmount, USD)).toThrow();\n    expect(() => moneyAmountToStripeUnits(\"05\" as MoneyAmount, USD)).toThrow();\n  });\n});\n"],"mappings":";;;;;;;AAMA,SAAgB,yBAAyB,QAAqB,UAA4B;CACxF,MAAM,uDAA8B,SAAS,CAAC,SAAS,CAAC,aAAa,OAAO;AAC5E,KAAI,SAAS,mBAAmB,SAAS,SACvC,OAAM,IAAI,mCAAuB,+DAA+D;CAMlG,MAAM,CAAC,OAAO,aAAa,MAAM,UAAU,MAAM,IAAI;CACrD,MAAM,mBAAmB,WAAW,OAAO,SAAS,UAAU,IAAI;AAClE,QAAO,OAAO,SAAS,QAAQ,kBAAkB,GAAG;;CAGtD,SAAW,SAAS,6BAAU,SAA4B;CACxD,MAAM,MAAM,6CAAqB,MAAM,MAAM,EAAE,SAAS,MAAM;AAE9D,MAAK,sCAAsC,EAAE,aAAa;AACxD,SAAO,yBAAyB,QAAuB,IAAI,CAAC,CAAC,KAAK,IAAI;AACtE,SAAO,yBAAyB,QAAuB,IAAI,CAAC,CAAC,KAAK,EAAE;AACpE,SAAO,yBAAyB,SAAwB,IAAI,CAAC,CAAC,KAAK,KAAK;GACxE;AAEF,MAAK,oDAAoD,EAAE,aAAa;AACtE,SAAO,yBAAyB,KAAoB,IAAI,CAAC,CAAC,KAAK,IAAI;AACnE,SAAO,yBAAyB,MAAqB,IAAI,CAAC,CAAC,KAAK,IAAK;AACrE,SAAO,yBAAyB,KAAoB,IAAI,CAAC,CAAC,KAAK,EAAE;GACjE;AAEF,MAAK,gDAAgD,EAAE,aAAa;AAClE,SAAO,yBAAyB,OAAsB,IAAI,CAAC,CAAC,KAAK,IAAI;AACrE,SAAO,yBAAyB,OAAsB,IAAI,CAAC,CAAC,KAAK,GAAG;GACpE;AAEF,MAAK,gDAAgD,EAAE,aAAa;AAClE,OAAK,MAAM,SAAS;GAAC;GAAG;GAAG;GAAG;GAAI;GAAI;GAAK;GAAM;GAAO,CAEtD,QAAO,yBADQ,GAAG,KAAK,MAAM,QAAQ,IAAI,CAAC,IAAI,QAAQ,KAAK,UAAU,CAAC,SAAS,GAAG,IAAI,IAC9C,IAAI,CAAC,CAAC,KAAK,MAAM;GAE3D;AAEF,MAAK,6CAA6C,EAAE,aAAa;AAC/D,eAAa,yBAAyB,OAAsB,IAAI,CAAC,CAAC,SAAS;AAC3E,eAAa,yBAAyB,SAAwB,IAAI,CAAC,CAAC,SAAS;AAC7E,eAAa,yBAAyB,MAAqB,IAAI,CAAC,CAAC,SAAS;GAC1E;EACF"}
+{"version":3,"file":"currencies.js","names":["HexclaveAssertionError"],"sources":["../../src/utils/currencies.tsx"],"sourcesContent":["import { moneyAmountSchema } from \"../schema-fields\";\nimport { SUPPORTED_CURRENCIES, type Currency, type MoneyAmount } from \"./currency-constants\";\nimport { HexclaveAssertionError } from \"./errors\";\n\nexport type SupportedCurrency = (typeof SUPPORTED_CURRENCIES)[number];\n\nexport function moneyAmountToStripeUnits(amount: MoneyAmount, currency: Currency): number {\n  const validated = moneyAmountSchema(currency).defined().validateSync(amount);\n  if (currency.stripeDecimals !== currency.decimals) {\n    throw new HexclaveAssertionError(\"unimplemented: TODO support different decimal configurations\");\n  }\n  // `moneyAmountSchema` accepts strings with 0..currency.decimals fractional\n  // digits, so we must right-pad the fractional part before stripping the dot.\n  // A naïve `replace('.', '')` underweights inputs like \"5\" → 5 (should be 500\n  // for USD) and \"0.5\" → 5 (should be 50).\n  const [whole, fractional = \"\"] = validated.split(\".\");\n  const paddedFractional = fractional.padEnd(currency.decimals, \"0\");\n  return Number.parseInt(whole + paddedFractional, 10);\n}\n\nimport.meta.vitest?.describe(\"moneyAmountToStripeUnits\", (test) => {\n  const USD = SUPPORTED_CURRENCIES.find((c) => c.code === \"USD\")!;\n\n  test(\"converts fully-padded USD amounts\", ({ expect }) => {\n    expect(moneyAmountToStripeUnits(\"5.00\" as MoneyAmount, USD)).toBe(500);\n    expect(moneyAmountToStripeUnits(\"0.01\" as MoneyAmount, USD)).toBe(1);\n    expect(moneyAmountToStripeUnits(\"12.34\" as MoneyAmount, USD)).toBe(1234);\n  });\n\n  test(\"converts whole-number USD amounts (no decimals)\", ({ expect }) => {\n    expect(moneyAmountToStripeUnits(\"5\" as MoneyAmount, USD)).toBe(500);\n    expect(moneyAmountToStripeUnits(\"10\" as MoneyAmount, USD)).toBe(1000);\n    expect(moneyAmountToStripeUnits(\"0\" as MoneyAmount, USD)).toBe(0);\n  });\n\n  test(\"converts USD amounts with one decimal digit\", ({ expect }) => {\n    expect(moneyAmountToStripeUnits(\"5.5\" as MoneyAmount, USD)).toBe(550);\n    expect(moneyAmountToStripeUnits(\"0.5\" as MoneyAmount, USD)).toBe(50);\n  });\n\n  test(\"matches stripeUnitsToMoneyAmount round-trip\", ({ expect }) => {\n    for (const cents of [0, 1, 5, 50, 99, 100, 1234, 100000]) {\n      const padded = `${Math.floor(cents / 100)}.${(cents % 100).toString().padStart(2, \"0\")}` as MoneyAmount;\n      expect(moneyAmountToStripeUnits(padded, USD)).toBe(cents);\n    }\n  });\n\n  test(\"rejects invalid money strings via schema\", ({ expect }) => {\n    expect(() => moneyAmountToStripeUnits(\"abc\" as MoneyAmount, USD)).toThrow();\n    expect(() => moneyAmountToStripeUnits(\"5.555\" as MoneyAmount, USD)).toThrow();\n    expect(() => moneyAmountToStripeUnits(\"05\" as MoneyAmount, USD)).toThrow();\n  });\n});\n"],"mappings":";;;;;AAMA,SAAgB,yBAAyB,QAAqB,UAA4B;CACxF,MAAM,aAAA,GAAA,oBAAA,kBAAA,CAA8B,QAAQ,CAAC,CAAC,QAAQ,CAAC,CAAC,aAAa,MAAM;CAC3E,IAAI,SAAS,mBAAmB,SAAS,UACvC,MAAM,IAAIA,YAAAA,uBAAuB,8DAA8D;CAMjG,MAAM,CAAC,OAAO,aAAa,MAAM,UAAU,MAAM,GAAG;CACpD,MAAM,mBAAmB,WAAW,OAAO,SAAS,UAAU,GAAG;CACjE,OAAO,OAAO,SAAS,QAAQ,kBAAkB,EAAE;AACrD"}

package/dist/utils/currency-constants.d.ts

@@ -1,45 +1,2 @@
-//#region src/utils/currency-constants.d.ts
-/**
- * A decimal string representing a monetary amount, e.g. `"9.99"`, `"0.01"`, or `"1000"`.
- *
- * This is NOT an integer in cents/minor units — it is always a human-readable decimal string.
- * For example, nine dollars and ninety-nine cents is `"9.99"`, not `999`.
- */
-type MoneyAmount = `${number}` | `${number}.${number}`;
-type Currency = {
-  code: Uppercase<string>;
-  decimals: number;
-  stripeDecimals: number;
-};
-declare const SUPPORTED_CURRENCIES: [{
-  readonly code: "USD";
-  readonly decimals: 2;
-  readonly stripeDecimals: 2;
-}, {
-  readonly code: "EUR";
-  readonly decimals: 2;
-  readonly stripeDecimals: 2;
-}, {
-  readonly code: "GBP";
-  readonly decimals: 2;
-  readonly stripeDecimals: 2;
-}, {
-  readonly code: "JPY";
-  readonly decimals: 0;
-  readonly stripeDecimals: 0;
-}, {
-  readonly code: "INR";
-  readonly decimals: 2;
-  readonly stripeDecimals: 2;
-}, {
-  readonly code: "AUD";
-  readonly decimals: 2;
-  readonly stripeDecimals: 2;
-}, {
-  readonly code: "CAD";
-  readonly decimals: 2;
-  readonly stripeDecimals: 2;
-}];
-//#endregion
-export { Currency, MoneyAmount, SUPPORTED_CURRENCIES };
-//# sourceMappingURL=currency-constants.d.ts.map
+import { n as MoneyAmount, r as SUPPORTED_CURRENCIES, t as Currency } from "../currency-constants-Cq_q8twn.js";
+export { Currency, MoneyAmount, SUPPORTED_CURRENCIES };

package/dist/utils/currency-constants.js

@@ -1,5 +1,4 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 //#region src/utils/currency-constants.tsx
 const SUPPORTED_CURRENCIES = [
 	{
@@ -38,7 +37,7 @@ const SUPPORTED_CURRENCIES = [
 		stripeDecimals: 2
 	}
 ];
-
 //#endregion
 exports.SUPPORTED_CURRENCIES = SUPPORTED_CURRENCIES;
+
 //# sourceMappingURL=currency-constants.js.map

package/dist/utils/currency-constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"currency-constants.js","names":[],"sources":["../../src/utils/currency-constants.tsx"],"sourcesContent":["/**\n * A decimal string representing a monetary amount, e.g. `\"9.99\"`, `\"0.01\"`, or `\"1000\"`.\n *\n * This is NOT an integer in cents/minor units — it is always a human-readable decimal string.\n * For example, nine dollars and ninety-nine cents is `\"9.99\"`, not `999`.\n */\nexport type MoneyAmount = `${number}` | `${number}.${number}`;\n\nexport type Currency = {\n  code: Uppercase<string>,\n  decimals: number,\n  stripeDecimals: number,\n};\n\nexport const SUPPORTED_CURRENCIES = [\n  {\n    code: 'USD',\n    decimals: 2,\n    stripeDecimals: 2,\n  },\n  {\n    code: 'EUR',\n    decimals: 2,\n    stripeDecimals: 2,\n  },\n  {\n    code: 'GBP',\n    decimals: 2,\n    stripeDecimals: 2,\n  },\n  {\n    code: 'JPY',\n    decimals: 0,\n    stripeDecimals: 0,\n  },\n  {\n    code: 'INR',\n    decimals: 2,\n    stripeDecimals: 2,\n  },\n  {\n    code: 'AUD',\n    decimals: 2,\n    stripeDecimals: 2,\n  },\n  {\n    code: 'CAD',\n    decimals: 2,\n    stripeDecimals: 2,\n  },\n] as const satisfies Currency[];\n"],"mappings":";;;AAcA,MAAa,uBAAuB;CAClC;EACE,MAAM;EACN,UAAU;EACV,gBAAgB;EACjB;CACD;EACE,MAAM;EACN,UAAU;EACV,gBAAgB;EACjB;CACD;EACE,MAAM;EACN,UAAU;EACV,gBAAgB;EACjB;CACD;EACE,MAAM;EACN,UAAU;EACV,gBAAgB;EACjB;CACD;EACE,MAAM;EACN,UAAU;EACV,gBAAgB;EACjB;CACD;EACE,MAAM;EACN,UAAU;EACV,gBAAgB;EACjB;CACD;EACE,MAAM;EACN,UAAU;EACV,gBAAgB;EACjB;CACF"}
+{"version":3,"file":"currency-constants.js","names":[],"sources":["../../src/utils/currency-constants.tsx"],"sourcesContent":["/**\n * A decimal string representing a monetary amount, e.g. `\"9.99\"`, `\"0.01\"`, or `\"1000\"`.\n *\n * This is NOT an integer in cents/minor units — it is always a human-readable decimal string.\n * For example, nine dollars and ninety-nine cents is `\"9.99\"`, not `999`.\n */\nexport type MoneyAmount = `${number}` | `${number}.${number}`;\n\nexport type Currency = {\n  code: Uppercase<string>,\n  decimals: number,\n  stripeDecimals: number,\n};\n\nexport const SUPPORTED_CURRENCIES = [\n  {\n    code: 'USD',\n    decimals: 2,\n    stripeDecimals: 2,\n  },\n  {\n    code: 'EUR',\n    decimals: 2,\n    stripeDecimals: 2,\n  },\n  {\n    code: 'GBP',\n    decimals: 2,\n    stripeDecimals: 2,\n  },\n  {\n    code: 'JPY',\n    decimals: 0,\n    stripeDecimals: 0,\n  },\n  {\n    code: 'INR',\n    decimals: 2,\n    stripeDecimals: 2,\n  },\n  {\n    code: 'AUD',\n    decimals: 2,\n    stripeDecimals: 2,\n  },\n  {\n    code: 'CAD',\n    decimals: 2,\n    stripeDecimals: 2,\n  },\n] as const satisfies Currency[];\n"],"mappings":";;AAcA,MAAa,uBAAuB;CAClC;EACE,MAAM;EACN,UAAU;EACV,gBAAgB;CAClB;CACA;EACE,MAAM;EACN,UAAU;EACV,gBAAgB;CAClB;CACA;EACE,MAAM;EACN,UAAU;EACV,gBAAgB;CAClB;CACA;EACE,MAAM;EACN,UAAU;EACV,gBAAgB;CAClB;CACA;EACE,MAAM;EACN,UAAU;EACV,gBAAgB;CAClB;CACA;EACE,MAAM;EACN,UAAU;EACV,gBAAgB;CAClB;CACA;EACE,MAAM;EACN,UAAU;EACV,gBAAgB;CAClB;AACF"}

package/dist/utils/dates.d.ts

@@ -1,23 +1,2 @@
-//#region src/utils/dates.d.ts
-declare function isWeekend(date: Date): boolean;
-declare function fromNow(date: Date): string;
-declare function fromNowDetailed(date: Date): {
-  result: string;
-  /**
-   * May be Infinity if the result will never change.
-   */
-  secondsUntilChange: number;
-};
-/**
- * Returns a string representation of the given date in the format expected by the `datetime-local` input type.
- */
-declare function getInputDatetimeLocalString(date: Date): string;
-type Interval = [number, 'millisecond' | 'second' | 'minute' | 'hour' | 'day' | 'week' | 'month' | 'year'];
-type DayInterval = [number, 'day' | 'week' | 'month' | 'year'];
-declare function subtractInterval(date: Date, interval: Interval): Date;
-declare function addInterval(date: Date, interval: Interval): Date;
-declare const FAR_FUTURE_DATE: Date;
-declare function getIntervalsElapsed(anchor: Date, to: Date, repeat: DayInterval): number;
-//#endregion
-export { DayInterval, FAR_FUTURE_DATE, Interval, addInterval, fromNow, fromNowDetailed, getInputDatetimeLocalString, getIntervalsElapsed, isWeekend, subtractInterval };
-//# sourceMappingURL=dates.d.ts.map
+import { a as fromNow, c as getIntervalsElapsed, i as addInterval, l as isWeekend, n as FAR_FUTURE_DATE, o as fromNowDetailed, r as Interval, s as getInputDatetimeLocalString, t as DayInterval, u as subtractInterval } from "../dates-B6ne9iOR.js";
+export { DayInterval, FAR_FUTURE_DATE, Interval, addInterval, fromNow, fromNowDetailed, getInputDatetimeLocalString, getIntervalsElapsed, isWeekend, subtractInterval };

package/dist/utils/dates.js

@@ -1,19 +1,11 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_chunk = require('../chunk-BE-pF4vm.js');
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 let ___schema_fields_js = require("../schema-fields.js");
 let __errors_js = require("./errors.js");
 let __math_js = require("./math.js");
-
 //#region src/utils/dates.tsx
 function isWeekend(date) {
 	return date.getDay() === 0 || date.getDay() === 6;
 }
-(void 0)?.test("isWeekend", ({ expect }) => {
-	expect(isWeekend(new Date(2023, 0, 1))).toBe(true);
-	expect(isWeekend(new Date(2023, 0, 7))).toBe(true);
-	expect(isWeekend(new Date(2023, 0, 2))).toBe(false);
-	expect(isWeekend(new Date(2023, 0, 6))).toBe(false);
-});
 const agoUnits = [
 	[60, "second"],
 	[60, "minute"],
@@ -24,23 +16,6 @@ const agoUnits = [
 function fromNow(date) {
 	return fromNowDetailed(date).result;
 }
-(void 0)?.test("fromNow", ({ expect }) => {
-	const fixedDate = /* @__PURE__ */ new Date("2023-01-15T12:00:00.000Z");
-	(void 0)?.vi.useFakeTimers();
-	(void 0)?.vi.setSystemTime(fixedDate);
-	expect(fromNow(/* @__PURE__ */ new Date("2023-01-15T11:59:50.000Z"))).toBe("just now");
-	expect(fromNow(/* @__PURE__ */ new Date("2023-01-15T11:59:00.000Z"))).toBe("1 minute ago");
-	expect(fromNow(/* @__PURE__ */ new Date("2023-01-15T11:00:00.000Z"))).toBe("1 hour ago");
-	expect(fromNow(/* @__PURE__ */ new Date("2023-01-14T12:00:00.000Z"))).toBe("1 day ago");
-	expect(fromNow(/* @__PURE__ */ new Date("2023-01-08T12:00:00.000Z"))).toBe("1 week ago");
-	expect(fromNow(/* @__PURE__ */ new Date("2023-01-15T12:00:10.000Z"))).toBe("just now");
-	expect(fromNow(/* @__PURE__ */ new Date("2023-01-15T12:01:00.000Z"))).toBe("in 1 minute");
-	expect(fromNow(/* @__PURE__ */ new Date("2023-01-15T13:00:00.000Z"))).toBe("in 1 hour");
-	expect(fromNow(/* @__PURE__ */ new Date("2023-01-16T12:00:00.000Z"))).toBe("in 1 day");
-	expect(fromNow(/* @__PURE__ */ new Date("2023-01-22T12:00:00.000Z"))).toBe("in 1 week");
-	expect(fromNow(/* @__PURE__ */ new Date("2022-01-15T12:00:00.000Z"))).toMatch(/Jan 15, 2022/);
-	(void 0)?.vi.useRealTimers();
-});
 function fromNowDetailed(date) {
 	if (!(date instanceof Date)) throw new Error(`fromNow only accepts Date objects (received: ${date})`);
 	const elapsed = (/* @__PURE__ */ new Date()).getTime() - date.getTime();
@@ -80,17 +55,6 @@ function getInputDatetimeLocalString(date) {
 	date.setMinutes(date.getMinutes() - date.getTimezoneOffset());
 	return date.toISOString().slice(0, 19);
 }
-(void 0)?.test("getInputDatetimeLocalString", ({ expect }) => {
-	(void 0)?.vi.useFakeTimers();
-	expect(getInputDatetimeLocalString(/* @__PURE__ */ new Date("2023-01-15T12:30:45.000Z"))).toMatch(/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}$/);
-	const dates = [
-		/* @__PURE__ */ new Date("2023-01-01T00:00:00.000Z"),
-		/* @__PURE__ */ new Date("2023-06-15T23:59:59.000Z"),
-		/* @__PURE__ */ new Date("2023-12-31T12:34:56.000Z")
-	];
-	for (const date of dates) expect(getInputDatetimeLocalString(date)).toMatch(/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}$/);
-	(void 0)?.vi.useRealTimers();
-});
 function applyInterval(date, times, interval) {
 	if (!___schema_fields_js.intervalSchema.isValidSync(interval)) throw new __errors_js.HexclaveAssertionError(`Invalid interval`, { interval });
 	const [amount, unit] = interval;
@@ -155,15 +119,6 @@ function getIntervalsElapsed(anchor, to, repeat) {
 	}
 	return 0;
 }
-(void 0)?.test("getIntervalsElapsed", ({ expect }) => {
-	const anchor = /* @__PURE__ */ new Date("2025-01-01T00:00:00.000Z");
-	const to = /* @__PURE__ */ new Date("2025-01-15T00:00:00.000Z");
-	expect(getIntervalsElapsed(anchor, to, [1, "week"])).toBe(2);
-	expect(getIntervalsElapsed(anchor, to, [3, "day"])).toBe(4);
-	expect(getIntervalsElapsed(/* @__PURE__ */ new Date("2023-01-31T00:00:00.000Z"), /* @__PURE__ */ new Date("2023-03-01T00:00:00.000Z"), [1, "month"])).toBe(0);
-	expect(getIntervalsElapsed(/* @__PURE__ */ new Date("2020-01-01T00:00:00.000Z"), /* @__PURE__ */ new Date("2022-06-01T00:00:00.000Z"), [1, "year"])).toBe(2);
-});
-
 //#endregion
 exports.FAR_FUTURE_DATE = FAR_FUTURE_DATE;
 exports.addInterval = addInterval;
@@ -173,4 +128,5 @@ exports.getInputDatetimeLocalString = getInputDatetimeLocalString;
 exports.getIntervalsElapsed = getIntervalsElapsed;
 exports.isWeekend = isWeekend;
 exports.subtractInterval = subtractInterval;
+
 //# sourceMappingURL=dates.js.map

package/dist/utils/dates.js.map

@@ -1 +1 @@
-{"version":3,"file":"dates.js","names":[],"sources":["../../src/utils/dates.tsx"],"sourcesContent":["import { intervalSchema } from \"../schema-fields\";\nimport { HexclaveAssertionError } from \"./errors\";\nimport { remainder } from \"./math\";\n\nexport function isWeekend(date: Date): boolean {\n  return date.getDay() === 0 || date.getDay() === 6;\n}\n\nimport.meta.vitest?.test(\"isWeekend\", ({ expect }) => {\n  // Sunday (day 0)\n  expect(isWeekend(new Date(2023, 0, 1))).toBe(true);\n  // Saturday (day 6)\n  expect(isWeekend(new Date(2023, 0, 7))).toBe(true);\n  // Monday (day 1)\n  expect(isWeekend(new Date(2023, 0, 2))).toBe(false);\n  // Friday (day 5)\n  expect(isWeekend(new Date(2023, 0, 6))).toBe(false);\n});\n\nconst agoUnits = [\n  [60, 'second'],\n  [60, 'minute'],\n  [24, 'hour'],\n  [7, 'day'],\n  [5, 'week'],\n] as const;\n\nexport function fromNow(date: Date): string {\n  return fromNowDetailed(date).result;\n}\n\nimport.meta.vitest?.test(\"fromNow\", ({ expect }) => {\n  // Set a fixed date for testing\n  const fixedDate = new Date(\"2023-01-15T12:00:00.000Z\");\n\n  // Use Vitest's fake timers\n  import.meta.vitest?.vi.useFakeTimers();\n  import.meta.vitest?.vi.setSystemTime(fixedDate);\n\n  // Test past times\n  expect(fromNow(new Date(\"2023-01-15T11:59:50.000Z\"))).toBe(\"just now\");\n  expect(fromNow(new Date(\"2023-01-15T11:59:00.000Z\"))).toBe(\"1 minute ago\");\n  expect(fromNow(new Date(\"2023-01-15T11:00:00.000Z\"))).toBe(\"1 hour ago\");\n  expect(fromNow(new Date(\"2023-01-14T12:00:00.000Z\"))).toBe(\"1 day ago\");\n  expect(fromNow(new Date(\"2023-01-08T12:00:00.000Z\"))).toBe(\"1 week ago\");\n\n  // Test future times\n  expect(fromNow(new Date(\"2023-01-15T12:00:10.000Z\"))).toBe(\"just now\");\n  expect(fromNow(new Date(\"2023-01-15T12:01:00.000Z\"))).toBe(\"in 1 minute\");\n  expect(fromNow(new Date(\"2023-01-15T13:00:00.000Z\"))).toBe(\"in 1 hour\");\n  expect(fromNow(new Date(\"2023-01-16T12:00:00.000Z\"))).toBe(\"in 1 day\");\n  expect(fromNow(new Date(\"2023-01-22T12:00:00.000Z\"))).toBe(\"in 1 week\");\n\n  // Test very old dates (should use date format)\n  expect(fromNow(new Date(\"2022-01-15T12:00:00.000Z\"))).toMatch(/Jan 15, 2022/);\n\n  // Restore real timers\n  import.meta.vitest?.vi.useRealTimers();\n});\n\nexport function fromNowDetailed(date: Date): {\n  result: string,\n  /**\n   * May be Infinity if the result will never change.\n   */\n  secondsUntilChange: number,\n} {\n  if (!(date instanceof Date)) {\n    throw new Error(`fromNow only accepts Date objects (received: ${date})`);\n  }\n\n  const now = new Date();\n  const elapsed = now.getTime() - date.getTime();\n\n  let remainingInUnit = Math.abs(elapsed) / 1000;\n  if (remainingInUnit < 15) {\n    return {\n      result: 'just now',\n      secondsUntilChange: 15 - remainingInUnit,\n    };\n  }\n  let unitInSeconds = 1;\n  for (const [nextUnitSize, unitName] of agoUnits) {\n    const rounded = Math.round(remainingInUnit);\n    if (rounded < nextUnitSize) {\n      if (elapsed < 0) {\n        return {\n          result: `in ${rounded} ${unitName}${rounded === 1 ? '' : 's'}`,\n          secondsUntilChange: remainder((remainingInUnit - rounded + 0.5) * unitInSeconds, unitInSeconds),\n        };\n      } else {\n        return {\n          result: `${rounded} ${unitName}${rounded === 1 ? '' : 's'} ago`,\n          secondsUntilChange: remainder((rounded - remainingInUnit - 0.5) * unitInSeconds, unitInSeconds),\n        };\n      }\n    }\n    unitInSeconds *= nextUnitSize;\n    remainingInUnit /= nextUnitSize;\n  }\n\n  return {\n    result: date.toLocaleDateString('en-US', { year: 'numeric', month: 'short', day: 'numeric' }),\n    secondsUntilChange: Infinity,\n  };\n}\n\n/**\n * Returns a string representation of the given date in the format expected by the `datetime-local` input type.\n */\nexport function getInputDatetimeLocalString(date: Date): string {\n  date = new Date(date);\n  date.setMinutes(date.getMinutes() - date.getTimezoneOffset());\n  return date.toISOString().slice(0, 19);\n}\n\nimport.meta.vitest?.test(\"getInputDatetimeLocalString\", ({ expect }) => {\n  // Use Vitest's fake timers to ensure consistent timezone behavior\n  import.meta.vitest?.vi.useFakeTimers();\n\n  // Test with a specific date\n  const mockDate = new Date(\"2023-01-15T12:30:45.000Z\");\n  const result = getInputDatetimeLocalString(mockDate);\n\n  // The result should be in the format YYYY-MM-DDTHH:MM:SS\n  expect(result).toMatch(/^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}$/);\n\n  // Test with different dates\n  const dates = [\n    new Date(\"2023-01-01T00:00:00.000Z\"),\n    new Date(\"2023-06-15T23:59:59.000Z\"),\n    new Date(\"2023-12-31T12:34:56.000Z\"),\n  ];\n\n  for (const date of dates) {\n    const result = getInputDatetimeLocalString(date);\n    expect(result).toMatch(/^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}$/);\n  }\n\n  // Restore real timers\n  import.meta.vitest?.vi.useRealTimers();\n});\n\n\nexport type Interval = [number, 'millisecond' | 'second' | 'minute' | 'hour' | 'day' | 'week' | 'month' | 'year'];\nexport type DayInterval = [number, 'day' | 'week' | 'month' | 'year'];\n\nfunction applyInterval(date: Date, times: number, interval: Interval): Date {\n  if (!intervalSchema.isValidSync(interval)) {\n    throw new HexclaveAssertionError(`Invalid interval`, { interval });\n  }\n  const [amount, unit] = interval;\n  switch (unit) {\n    case 'millisecond': {\n      date.setMilliseconds(date.getMilliseconds() + amount * times);\n      break;\n    }\n    case 'second': {\n      date.setSeconds(date.getSeconds() + amount * times);\n      break;\n    }\n    case 'minute': {\n      date.setMinutes(date.getMinutes() + amount * times);\n      break;\n    }\n    case 'hour': {\n      date.setHours(date.getHours() + amount * times);\n      break;\n    }\n    case 'day': {\n      date.setDate(date.getDate() + amount * times);\n      break;\n    }\n    case 'week': {\n      date.setDate(date.getDate() + amount * times * 7);\n      break;\n    }\n    case 'month': {\n      date.setMonth(date.getMonth() + amount * times);\n      break;\n    }\n    case 'year': {\n      date.setFullYear(date.getFullYear() + amount * times);\n      break;\n    }\n    default: {\n      throw new HexclaveAssertionError(`Invalid interval despite schema validation`, { interval });\n    }\n  }\n  return date;\n}\n\nexport function subtractInterval(date: Date, interval: Interval): Date {\n  return applyInterval(date, -1, interval);\n}\n\nexport function addInterval(date: Date, interval: Interval): Date {\n  return applyInterval(date, 1, interval);\n}\n\nexport const FAR_FUTURE_DATE = new Date(8640000000000000); // 13 Sep 275760 00:00:00 UTC\n\nfunction getMsPerDayIntervalUnit(unit: 'day' | 'week'): number {\n  if (unit === 'day') {\n    return 24 * 60 * 60 * 1000;\n  }\n  return 7 * 24 * 60 * 60 * 1000;\n}\n\n\nexport function getIntervalsElapsed(anchor: Date, to: Date, repeat: DayInterval): number {\n  const [amount, unit] = repeat;\n  if (to <= anchor) return 0;\n  if (unit === 'day' || unit === 'week') {\n    const msPerUnit = getMsPerDayIntervalUnit(unit);\n    const diffMs = to.getTime() - anchor.getTime();\n    return Math.floor(diffMs / (msPerUnit * amount));\n  }\n  if ([\"month\", \"year\"].includes(unit)) {\n    let count = 0;\n    let current = new Date(anchor);\n    for (; ;) {\n      const next = addInterval(new Date(current), [amount, unit]);\n      if (next > to) break;\n      current = next;\n      count += 1;\n    }\n    return count;\n  }\n  return 0;\n}\n\nimport.meta.vitest?.test(\"getIntervalsElapsed\", ({ expect }) => {\n  const anchor = new Date('2025-01-01T00:00:00.000Z');\n  const to = new Date('2025-01-15T00:00:00.000Z');\n  expect(getIntervalsElapsed(anchor, to, [1, 'week'])).toBe(2);\n  expect(getIntervalsElapsed(anchor, to, [3, 'day'])).toBe(4);\n\n  const mAnchor = new Date('2023-01-31T00:00:00.000Z');\n  const mTo = new Date('2023-03-01T00:00:00.000Z');\n  expect(getIntervalsElapsed(mAnchor, mTo, [1, 'month'])).toBe(0);\n\n  const yAnchor = new Date('2020-01-01T00:00:00.000Z');\n  const yTo = new Date('2022-06-01T00:00:00.000Z');\n  expect(getIntervalsElapsed(yAnchor, yTo, [1, 'year'])).toBe(2);\n});\n"],"mappings":"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"}
+{"version":3,"file":"dates.js","names":["intervalSchema","HexclaveAssertionError"],"sources":["../../src/utils/dates.tsx"],"sourcesContent":["import { intervalSchema } from \"../schema-fields\";\nimport { HexclaveAssertionError } from \"./errors\";\nimport { remainder } from \"./math\";\n\nexport function isWeekend(date: Date): boolean {\n  return date.getDay() === 0 || date.getDay() === 6;\n}\n\nimport.meta.vitest?.test(\"isWeekend\", ({ expect }) => {\n  // Sunday (day 0)\n  expect(isWeekend(new Date(2023, 0, 1))).toBe(true);\n  // Saturday (day 6)\n  expect(isWeekend(new Date(2023, 0, 7))).toBe(true);\n  // Monday (day 1)\n  expect(isWeekend(new Date(2023, 0, 2))).toBe(false);\n  // Friday (day 5)\n  expect(isWeekend(new Date(2023, 0, 6))).toBe(false);\n});\n\nconst agoUnits = [\n  [60, 'second'],\n  [60, 'minute'],\n  [24, 'hour'],\n  [7, 'day'],\n  [5, 'week'],\n] as const;\n\nexport function fromNow(date: Date): string {\n  return fromNowDetailed(date).result;\n}\n\nimport.meta.vitest?.test(\"fromNow\", ({ expect }) => {\n  // Set a fixed date for testing\n  const fixedDate = new Date(\"2023-01-15T12:00:00.000Z\");\n\n  // Use Vitest's fake timers\n  import.meta.vitest?.vi.useFakeTimers();\n  import.meta.vitest?.vi.setSystemTime(fixedDate);\n\n  // Test past times\n  expect(fromNow(new Date(\"2023-01-15T11:59:50.000Z\"))).toBe(\"just now\");\n  expect(fromNow(new Date(\"2023-01-15T11:59:00.000Z\"))).toBe(\"1 minute ago\");\n  expect(fromNow(new Date(\"2023-01-15T11:00:00.000Z\"))).toBe(\"1 hour ago\");\n  expect(fromNow(new Date(\"2023-01-14T12:00:00.000Z\"))).toBe(\"1 day ago\");\n  expect(fromNow(new Date(\"2023-01-08T12:00:00.000Z\"))).toBe(\"1 week ago\");\n\n  // Test future times\n  expect(fromNow(new Date(\"2023-01-15T12:00:10.000Z\"))).toBe(\"just now\");\n  expect(fromNow(new Date(\"2023-01-15T12:01:00.000Z\"))).toBe(\"in 1 minute\");\n  expect(fromNow(new Date(\"2023-01-15T13:00:00.000Z\"))).toBe(\"in 1 hour\");\n  expect(fromNow(new Date(\"2023-01-16T12:00:00.000Z\"))).toBe(\"in 1 day\");\n  expect(fromNow(new Date(\"2023-01-22T12:00:00.000Z\"))).toBe(\"in 1 week\");\n\n  // Test very old dates (should use date format)\n  expect(fromNow(new Date(\"2022-01-15T12:00:00.000Z\"))).toMatch(/Jan 15, 2022/);\n\n  // Restore real timers\n  import.meta.vitest?.vi.useRealTimers();\n});\n\nexport function fromNowDetailed(date: Date): {\n  result: string,\n  /**\n   * May be Infinity if the result will never change.\n   */\n  secondsUntilChange: number,\n} {\n  if (!(date instanceof Date)) {\n    throw new Error(`fromNow only accepts Date objects (received: ${date})`);\n  }\n\n  const now = new Date();\n  const elapsed = now.getTime() - date.getTime();\n\n  let remainingInUnit = Math.abs(elapsed) / 1000;\n  if (remainingInUnit < 15) {\n    return {\n      result: 'just now',\n      secondsUntilChange: 15 - remainingInUnit,\n    };\n  }\n  let unitInSeconds = 1;\n  for (const [nextUnitSize, unitName] of agoUnits) {\n    const rounded = Math.round(remainingInUnit);\n    if (rounded < nextUnitSize) {\n      if (elapsed < 0) {\n        return {\n          result: `in ${rounded} ${unitName}${rounded === 1 ? '' : 's'}`,\n          secondsUntilChange: remainder((remainingInUnit - rounded + 0.5) * unitInSeconds, unitInSeconds),\n        };\n      } else {\n        return {\n          result: `${rounded} ${unitName}${rounded === 1 ? '' : 's'} ago`,\n          secondsUntilChange: remainder((rounded - remainingInUnit - 0.5) * unitInSeconds, unitInSeconds),\n        };\n      }\n    }\n    unitInSeconds *= nextUnitSize;\n    remainingInUnit /= nextUnitSize;\n  }\n\n  return {\n    result: date.toLocaleDateString('en-US', { year: 'numeric', month: 'short', day: 'numeric' }),\n    secondsUntilChange: Infinity,\n  };\n}\n\n/**\n * Returns a string representation of the given date in the format expected by the `datetime-local` input type.\n */\nexport function getInputDatetimeLocalString(date: Date): string {\n  date = new Date(date);\n  date.setMinutes(date.getMinutes() - date.getTimezoneOffset());\n  return date.toISOString().slice(0, 19);\n}\n\nimport.meta.vitest?.test(\"getInputDatetimeLocalString\", ({ expect }) => {\n  // Use Vitest's fake timers to ensure consistent timezone behavior\n  import.meta.vitest?.vi.useFakeTimers();\n\n  // Test with a specific date\n  const mockDate = new Date(\"2023-01-15T12:30:45.000Z\");\n  const result = getInputDatetimeLocalString(mockDate);\n\n  // The result should be in the format YYYY-MM-DDTHH:MM:SS\n  expect(result).toMatch(/^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}$/);\n\n  // Test with different dates\n  const dates = [\n    new Date(\"2023-01-01T00:00:00.000Z\"),\n    new Date(\"2023-06-15T23:59:59.000Z\"),\n    new Date(\"2023-12-31T12:34:56.000Z\"),\n  ];\n\n  for (const date of dates) {\n    const result = getInputDatetimeLocalString(date);\n    expect(result).toMatch(/^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}$/);\n  }\n\n  // Restore real timers\n  import.meta.vitest?.vi.useRealTimers();\n});\n\n\nexport type Interval = [number, 'millisecond' | 'second' | 'minute' | 'hour' | 'day' | 'week' | 'month' | 'year'];\nexport type DayInterval = [number, 'day' | 'week' | 'month' | 'year'];\n\nfunction applyInterval(date: Date, times: number, interval: Interval): Date {\n  if (!intervalSchema.isValidSync(interval)) {\n    throw new HexclaveAssertionError(`Invalid interval`, { interval });\n  }\n  const [amount, unit] = interval;\n  switch (unit) {\n    case 'millisecond': {\n      date.setMilliseconds(date.getMilliseconds() + amount * times);\n      break;\n    }\n    case 'second': {\n      date.setSeconds(date.getSeconds() + amount * times);\n      break;\n    }\n    case 'minute': {\n      date.setMinutes(date.getMinutes() + amount * times);\n      break;\n    }\n    case 'hour': {\n      date.setHours(date.getHours() + amount * times);\n      break;\n    }\n    case 'day': {\n      date.setDate(date.getDate() + amount * times);\n      break;\n    }\n    case 'week': {\n      date.setDate(date.getDate() + amount * times * 7);\n      break;\n    }\n    case 'month': {\n      date.setMonth(date.getMonth() + amount * times);\n      break;\n    }\n    case 'year': {\n      date.setFullYear(date.getFullYear() + amount * times);\n      break;\n    }\n    default: {\n      throw new HexclaveAssertionError(`Invalid interval despite schema validation`, { interval });\n    }\n  }\n  return date;\n}\n\nexport function subtractInterval(date: Date, interval: Interval): Date {\n  return applyInterval(date, -1, interval);\n}\n\nexport function addInterval(date: Date, interval: Interval): Date {\n  return applyInterval(date, 1, interval);\n}\n\nexport const FAR_FUTURE_DATE = new Date(8640000000000000); // 13 Sep 275760 00:00:00 UTC\n\nfunction getMsPerDayIntervalUnit(unit: 'day' | 'week'): number {\n  if (unit === 'day') {\n    return 24 * 60 * 60 * 1000;\n  }\n  return 7 * 24 * 60 * 60 * 1000;\n}\n\n\nexport function getIntervalsElapsed(anchor: Date, to: Date, repeat: DayInterval): number {\n  const [amount, unit] = repeat;\n  if (to <= anchor) return 0;\n  if (unit === 'day' || unit === 'week') {\n    const msPerUnit = getMsPerDayIntervalUnit(unit);\n    const diffMs = to.getTime() - anchor.getTime();\n    return Math.floor(diffMs / (msPerUnit * amount));\n  }\n  if ([\"month\", \"year\"].includes(unit)) {\n    let count = 0;\n    let current = new Date(anchor);\n    for (; ;) {\n      const next = addInterval(new Date(current), [amount, unit]);\n      if (next > to) break;\n      current = next;\n      count += 1;\n    }\n    return count;\n  }\n  return 0;\n}\n\nimport.meta.vitest?.test(\"getIntervalsElapsed\", ({ expect }) => {\n  const anchor = new Date('2025-01-01T00:00:00.000Z');\n  const to = new Date('2025-01-15T00:00:00.000Z');\n  expect(getIntervalsElapsed(anchor, to, [1, 'week'])).toBe(2);\n  expect(getIntervalsElapsed(anchor, to, [3, 'day'])).toBe(4);\n\n  const mAnchor = new Date('2023-01-31T00:00:00.000Z');\n  const mTo = new Date('2023-03-01T00:00:00.000Z');\n  expect(getIntervalsElapsed(mAnchor, mTo, [1, 'month'])).toBe(0);\n\n  const yAnchor = new Date('2020-01-01T00:00:00.000Z');\n  const yTo = new Date('2022-06-01T00:00:00.000Z');\n  expect(getIntervalsElapsed(yAnchor, yTo, [1, 'year'])).toBe(2);\n});\n"],"mappings":"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"}

package/dist/utils/dev-env-state-path.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dev-env-state-path.d.ts","names":[],"sources":["../../src/utils/dev-env-state-path.ts"],"mappings":";iBAGgB,8BAAA,CAAA;AAAA,iBAQA,uBAAA,CAAA"}
+{"version":3,"file":"dev-env-state-path.d.ts","names":[],"sources":["../../src/utils/dev-env-state-path.ts"],"mappings":";iBAGgB,8BAAA;AAAA,iBAQA,uBAAA"}

package/dist/utils/dev-env-state-path.js

@@ -1,8 +1,6 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_chunk = require('../chunk-BE-pF4vm.js');
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 let path = require("path");
 let os = require("os");
-
 //#region src/utils/dev-env-state-path.ts
 function defaultHexclaveDevEnvStatePath() {
 	if (process.platform === "win32") return (0, path.join)(process.env.LOCALAPPDATA ?? (0, path.join)((0, os.homedir)(), "AppData", "Local"), "Hexclave", "dev-envs.json");
@@ -11,8 +9,8 @@ function defaultHexclaveDevEnvStatePath() {
 function hexclaveDevEnvStatePath() {
 	return process.env.STACK_DEV_ENVS_PATH ?? defaultHexclaveDevEnvStatePath();
 }
-
 //#endregion
 exports.defaultHexclaveDevEnvStatePath = defaultHexclaveDevEnvStatePath;
 exports.hexclaveDevEnvStatePath = hexclaveDevEnvStatePath;
+
 //# sourceMappingURL=dev-env-state-path.js.map

package/dist/utils/dev-env-state-path.js.map

@@ -1 +1 @@
-{"version":3,"file":"dev-env-state-path.js","names":[],"sources":["../../src/utils/dev-env-state-path.ts"],"sourcesContent":["import { homedir } from \"os\";\nimport { join } from \"path\";\n\nexport function defaultHexclaveDevEnvStatePath(): string {\n  if (process.platform === \"win32\") {\n    const localAppData = process.env.LOCALAPPDATA ?? join(homedir(), \"AppData\", \"Local\");\n    return join(localAppData, \"Hexclave\", \"dev-envs.json\");\n  }\n  return join(homedir(), \".stack\", \"dev-envs.json\");\n}\n\nexport function hexclaveDevEnvStatePath(): string {\n  return process.env.STACK_DEV_ENVS_PATH ?? defaultHexclaveDevEnvStatePath();\n}\n"],"mappings":";;;;;;AAGA,SAAgB,iCAAyC;AACvD,KAAI,QAAQ,aAAa,QAEvB,uBADqB,QAAQ,IAAI,gDAA8B,EAAE,WAAW,QAAQ,EAC1D,YAAY,gBAAgB;AAExD,wCAAqB,EAAE,UAAU,gBAAgB;;AAGnD,SAAgB,0BAAkC;AAChD,QAAO,QAAQ,IAAI,uBAAuB,gCAAgC"}
+{"version":3,"file":"dev-env-state-path.js","names":[],"sources":["../../src/utils/dev-env-state-path.ts"],"sourcesContent":["import { homedir } from \"os\";\nimport { join } from \"path\";\n\nexport function defaultHexclaveDevEnvStatePath(): string {\n  if (process.platform === \"win32\") {\n    const localAppData = process.env.LOCALAPPDATA ?? join(homedir(), \"AppData\", \"Local\");\n    return join(localAppData, \"Hexclave\", \"dev-envs.json\");\n  }\n  return join(homedir(), \".stack\", \"dev-envs.json\");\n}\n\nexport function hexclaveDevEnvStatePath(): string {\n  return process.env.STACK_DEV_ENVS_PATH ?? defaultHexclaveDevEnvStatePath();\n}\n"],"mappings":";;;;AAGA,SAAgB,iCAAyC;CACvD,IAAI,QAAQ,aAAa,SAEvB,QAAA,GAAA,KAAA,KAAA,CADqB,QAAQ,IAAI,iBAAA,GAAA,KAAA,KAAA,EAAA,GAAA,GAAA,QAAA,CAA6B,GAAG,WAAW,OAAO,GACzD,YAAY,eAAe;CAEvD,QAAA,GAAA,KAAA,KAAA,EAAA,GAAA,GAAA,QAAA,CAAoB,GAAG,UAAU,eAAe;AAClD;AAEA,SAAgB,0BAAkC;CAChD,OAAO,QAAQ,IAAI,uBAAuB,+BAA+B;AAC3E"}

package/dist/utils/dev-tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dev-tool.d.ts","names":[],"sources":["../../src/utils/dev-tool.tsx"],"mappings":";;AAeA;;;;;AAQA;;;;;AAGA;;;;cAXa,gBAAA;AAcb;;;;;;AAAA,cANa,gBAAA;;cAGA,qBAAA;;cAGA,qBAAA"}
+{"version":3,"file":"dev-tool.d.ts","names":[],"sources":["../../src/utils/dev-tool.tsx"],"mappings":";;AAeA;;;;AAA6B;AAQ7B;;;;AAA6B;AAG7B;;;;cAXa,gBAAA;AAcb;;;;AAAkC;;AAAlC,cANa,gBAAA;;cAGA,qBAAA;;cAGA,qBAAA"}

package/dist/utils/dev-tool.js

@@ -1,5 +1,4 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 //#region src/utils/dev-tool.tsx
 /**
 * Shared identity of the Hexclave in-page dev tool / clickmap overlay.
@@ -28,10 +27,10 @@ const CLICKMAP_ROOT_ID = "__hexclave-clickmap-root";
 const DEV_TOOL_CLASS_PREFIX = "sdt-";
 /** Legacy class marker still present on older dev-tool builds. */
 const DEV_TOOL_LEGACY_CLASS = "stack-devtool";
-
 //#endregion
 exports.CLICKMAP_ROOT_ID = CLICKMAP_ROOT_ID;
 exports.DEV_TOOL_CLASS_PREFIX = DEV_TOOL_CLASS_PREFIX;
 exports.DEV_TOOL_LEGACY_CLASS = DEV_TOOL_LEGACY_CLASS;
 exports.DEV_TOOL_ROOT_ID = DEV_TOOL_ROOT_ID;
+
 //# sourceMappingURL=dev-tool.js.map

package/dist/utils/dev-tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"dev-tool.js","names":[],"sources":["../../src/utils/dev-tool.tsx"],"sourcesContent":["/**\n * Shared identity of the Hexclave in-page dev tool / clickmap overlay.\n *\n * These constants are the single source of truth for \"is this DOM / event /\n * stored click part of the dev tool itself?\". They are consumed across package\n * boundaries:\n *  - the dev tool mounts its root element with {@link DEV_TOOL_ROOT_ID} and\n *    prefixes every generated class with {@link DEV_TOOL_CLASS_PREFIX};\n *  - the event tracker uses them to skip self-clicks at ingest;\n *  - the backend clickmap query uses them to filter dev-tool clicks out of\n *    aggregate clickmaps server-side.\n *\n * Keep them here so a rename can never silently desync the SQL filter from the\n * actual DOM identity.\n */\nexport const DEV_TOOL_ROOT_ID = \"__hexclave-dev-tool-root\";\n\n/**\n * Root element id of the standalone clickmap overlay. The clickmap is an\n * independent feature with its own mount (it must survive the dev tool being\n * removed), so it gets its own root — but its self-clicks need the exact same\n * ingest/query exclusions as the dev tool's.\n */\nexport const CLICKMAP_ROOT_ID = \"__hexclave-clickmap-root\";\n\n/** Prefix applied to every class/generated id the dev tool renders. */\nexport const DEV_TOOL_CLASS_PREFIX = \"sdt-\";\n\n/** Legacy class marker still present on older dev-tool builds. */\nexport const DEV_TOOL_LEGACY_CLASS = \"stack-devtool\";\n"],"mappings":";;;;;;;;;;;;;;;;;;AAeA,MAAa,mBAAmB;;;;;;;AAQhC,MAAa,mBAAmB;;AAGhC,MAAa,wBAAwB;;AAGrC,MAAa,wBAAwB"}
+{"version":3,"file":"dev-tool.js","names":[],"sources":["../../src/utils/dev-tool.tsx"],"sourcesContent":["/**\n * Shared identity of the Hexclave in-page dev tool / clickmap overlay.\n *\n * These constants are the single source of truth for \"is this DOM / event /\n * stored click part of the dev tool itself?\". They are consumed across package\n * boundaries:\n *  - the dev tool mounts its root element with {@link DEV_TOOL_ROOT_ID} and\n *    prefixes every generated class with {@link DEV_TOOL_CLASS_PREFIX};\n *  - the event tracker uses them to skip self-clicks at ingest;\n *  - the backend clickmap query uses them to filter dev-tool clicks out of\n *    aggregate clickmaps server-side.\n *\n * Keep them here so a rename can never silently desync the SQL filter from the\n * actual DOM identity.\n */\nexport const DEV_TOOL_ROOT_ID = \"__hexclave-dev-tool-root\";\n\n/**\n * Root element id of the standalone clickmap overlay. The clickmap is an\n * independent feature with its own mount (it must survive the dev tool being\n * removed), so it gets its own root — but its self-clicks need the exact same\n * ingest/query exclusions as the dev tool's.\n */\nexport const CLICKMAP_ROOT_ID = \"__hexclave-clickmap-root\";\n\n/** Prefix applied to every class/generated id the dev tool renders. */\nexport const DEV_TOOL_CLASS_PREFIX = \"sdt-\";\n\n/** Legacy class marker still present on older dev-tool builds. */\nexport const DEV_TOOL_LEGACY_CLASS = \"stack-devtool\";\n"],"mappings":";;;;;;;;;;;;;;;;;AAeA,MAAa,mBAAmB;;;;;;;AAQhC,MAAa,mBAAmB;;AAGhC,MAAa,wBAAwB;;AAGrC,MAAa,wBAAwB"}

package/dist/utils/dom.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dom.d.ts","names":[],"sources":["../../src/utils/dom.tsx"],"mappings":";iBAAgB,kBAAA,CAAmB,OAAA,EAAS,WAAA;AAA5C;;;;;AAAA,iBAagB,cAAA,CAAe,KAAA"}
+{"version":3,"file":"dom.d.ts","names":[],"sources":["../../src/utils/dom.tsx"],"mappings":";iBAAgB,kBAAA,CAAmB,OAAoB,EAAX,WAAW;AAAvD;;;;AAAuD;AAAvD,iBAagB,cAAA,CAAe,KAAa"}

package/dist/utils/dom.js

@@ -1,5 +1,4 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 //#region src/utils/dom.tsx
 function hasClickableParent(element) {
 	const parent = element.parentElement;
@@ -26,8 +25,8 @@ function cssEscapeIdent(value) {
 	}
 	return escaped;
 }
-
 //#endregion
 exports.cssEscapeIdent = cssEscapeIdent;
 exports.hasClickableParent = hasClickableParent;
+
 //# sourceMappingURL=dom.js.map

package/dist/utils/dom.js.map

@@ -1 +1 @@
-{"version":3,"file":"dom.js","names":[],"sources":["../../src/utils/dom.tsx"],"sourcesContent":["export function hasClickableParent(element: HTMLElement): boolean {\n  const parent = element.parentElement;\n  if (!parent) return false;\n  if (parent.dataset.n2Clickable) return true;\n\n  return hasClickableParent(element.parentElement);\n}\n\n/**\n * Escape a string so it is safe to use as a CSS identifier (id/class) inside a selector.\n * Prefers the native `CSS.escape` when available, falling back to a conservative\n * backslash-escape for non-DOM environments (SSR, tests, older runtimes).\n */\nexport function cssEscapeIdent(value: string): string {\n  if (typeof CSS !== \"undefined\" && typeof CSS.escape === \"function\") {\n    return CSS.escape(value);\n  }\n\n  let escaped = \"\";\n  for (let i = 0; i < value.length; i += 1) {\n    const char = value.charAt(i);\n    const codeUnit = value.charCodeAt(i);\n\n    if (codeUnit === 0x0000) {\n      escaped += \"\\uFFFD\";\n    } else if (\n      (codeUnit >= 0x0001 && codeUnit <= 0x001f) ||\n      codeUnit === 0x007f ||\n      (i === 0 && codeUnit >= 0x0030 && codeUnit <= 0x0039) ||\n      (i === 1 && codeUnit >= 0x0030 && codeUnit <= 0x0039 && value.charCodeAt(0) === 0x002d)\n    ) {\n      escaped += `\\\\${codeUnit.toString(16)} `;\n    } else if (i === 0 && codeUnit === 0x002d && value.length === 1) {\n      escaped += \"\\\\-\";\n    } else if (\n      codeUnit >= 0x0080 ||\n      codeUnit === 0x002d ||\n      codeUnit === 0x005f ||\n      (codeUnit >= 0x0030 && codeUnit <= 0x0039) ||\n      (codeUnit >= 0x0041 && codeUnit <= 0x005a) ||\n      (codeUnit >= 0x0061 && codeUnit <= 0x007a)\n    ) {\n      escaped += char;\n    } else {\n      escaped += `\\\\${char}`;\n    }\n  }\n  return escaped;\n}\n"],"mappings":";;;AAAA,SAAgB,mBAAmB,SAA+B;CAChE,MAAM,SAAS,QAAQ;AACvB,KAAI,CAAC,OAAQ,QAAO;AACpB,KAAI,OAAO,QAAQ,YAAa,QAAO;AAEvC,QAAO,mBAAmB,QAAQ,cAAc;;;;;;;AAQlD,SAAgB,eAAe,OAAuB;AACpD,KAAI,OAAO,QAAQ,eAAe,OAAO,IAAI,WAAW,WACtD,QAAO,IAAI,OAAO,MAAM;CAG1B,IAAI,UAAU;AACd,MAAK,IAAI,IAAI,GAAG,IAAI,MAAM,QAAQ,KAAK,GAAG;EACxC,MAAM,OAAO,MAAM,OAAO,EAAE;EAC5B,MAAM,WAAW,MAAM,WAAW,EAAE;AAEpC,MAAI,aAAa,EACf,YAAW;WAEV,YAAY,KAAU,YAAY,MACnC,aAAa,OACZ,MAAM,KAAK,YAAY,MAAU,YAAY,MAC7C,MAAM,KAAK,YAAY,MAAU,YAAY,MAAU,MAAM,WAAW,EAAE,KAAK,GAEhF,YAAW,KAAK,SAAS,SAAS,GAAG,CAAC;WAC7B,MAAM,KAAK,aAAa,MAAU,MAAM,WAAW,EAC5D,YAAW;WAEX,YAAY,OACZ,aAAa,MACb,aAAa,MACZ,YAAY,MAAU,YAAY,MAClC,YAAY,MAAU,YAAY,MAClC,YAAY,MAAU,YAAY,IAEnC,YAAW;MAEX,YAAW,KAAK;;AAGpB,QAAO"}
+{"version":3,"file":"dom.js","names":[],"sources":["../../src/utils/dom.tsx"],"sourcesContent":["export function hasClickableParent(element: HTMLElement): boolean {\n  const parent = element.parentElement;\n  if (!parent) return false;\n  if (parent.dataset.n2Clickable) return true;\n\n  return hasClickableParent(element.parentElement);\n}\n\n/**\n * Escape a string so it is safe to use as a CSS identifier (id/class) inside a selector.\n * Prefers the native `CSS.escape` when available, falling back to a conservative\n * backslash-escape for non-DOM environments (SSR, tests, older runtimes).\n */\nexport function cssEscapeIdent(value: string): string {\n  if (typeof CSS !== \"undefined\" && typeof CSS.escape === \"function\") {\n    return CSS.escape(value);\n  }\n\n  let escaped = \"\";\n  for (let i = 0; i < value.length; i += 1) {\n    const char = value.charAt(i);\n    const codeUnit = value.charCodeAt(i);\n\n    if (codeUnit === 0x0000) {\n      escaped += \"\\uFFFD\";\n    } else if (\n      (codeUnit >= 0x0001 && codeUnit <= 0x001f) ||\n      codeUnit === 0x007f ||\n      (i === 0 && codeUnit >= 0x0030 && codeUnit <= 0x0039) ||\n      (i === 1 && codeUnit >= 0x0030 && codeUnit <= 0x0039 && value.charCodeAt(0) === 0x002d)\n    ) {\n      escaped += `\\\\${codeUnit.toString(16)} `;\n    } else if (i === 0 && codeUnit === 0x002d && value.length === 1) {\n      escaped += \"\\\\-\";\n    } else if (\n      codeUnit >= 0x0080 ||\n      codeUnit === 0x002d ||\n      codeUnit === 0x005f ||\n      (codeUnit >= 0x0030 && codeUnit <= 0x0039) ||\n      (codeUnit >= 0x0041 && codeUnit <= 0x005a) ||\n      (codeUnit >= 0x0061 && codeUnit <= 0x007a)\n    ) {\n      escaped += char;\n    } else {\n      escaped += `\\\\${char}`;\n    }\n  }\n  return escaped;\n}\n"],"mappings":";;AAAA,SAAgB,mBAAmB,SAA+B;CAChE,MAAM,SAAS,QAAQ;CACvB,IAAI,CAAC,QAAQ,OAAO;CACpB,IAAI,OAAO,QAAQ,aAAa,OAAO;CAEvC,OAAO,mBAAmB,QAAQ,aAAa;AACjD;;;;;;AAOA,SAAgB,eAAe,OAAuB;CACpD,IAAI,OAAO,QAAQ,eAAe,OAAO,IAAI,WAAW,YACtD,OAAO,IAAI,OAAO,KAAK;CAGzB,IAAI,UAAU;CACd,KAAK,IAAI,IAAI,GAAG,IAAI,MAAM,QAAQ,KAAK,GAAG;EACxC,MAAM,OAAO,MAAM,OAAO,CAAC;EAC3B,MAAM,WAAW,MAAM,WAAW,CAAC;EAEnC,IAAI,aAAa,GACf,WAAW;OACN,IACJ,YAAY,KAAU,YAAY,MACnC,aAAa,OACZ,MAAM,KAAK,YAAY,MAAU,YAAY,MAC7C,MAAM,KAAK,YAAY,MAAU,YAAY,MAAU,MAAM,WAAW,CAAC,MAAM,IAEhF,WAAW,KAAK,SAAS,SAAS,EAAE,EAAE;OACjC,IAAI,MAAM,KAAK,aAAa,MAAU,MAAM,WAAW,GAC5D,WAAW;OACN,IACL,YAAY,OACZ,aAAa,MACb,aAAa,MACZ,YAAY,MAAU,YAAY,MAClC,YAAY,MAAU,YAAY,MAClC,YAAY,MAAU,YAAY,KAEnC,WAAW;OAEX,WAAW,KAAK;CAEpB;CACA,OAAO;AACT"}

package/dist/utils/elements-chain.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"elements-chain.d.ts","names":[],"sources":["../../src/utils/elements-chain.tsx"],"mappings":";;AAeA;;;;;;;;;;;;;KAAY,oBAAA;EACV,GAAA;EACA,OAAA;EACA,KAAA,EAAO,MAAA;EACP,IAAA;EACA,QAAA;EACA,SAAA;EACA,IAAA;AAAA;AAAA,cAGW,wBAAA;AAAA,cACA,uBAAA;AAAA,cACA,uBAAA;AAAA,cAKA,oBAAA;;;;AAAb;iBAyFgB,kBAAA,CAAmB,OAAA,EAAS,OAAA;;iBA0K5B,kBAAA,CAAmB,KAAA,WAAgB,oBAAA"}
+{"version":3,"file":"elements-chain.d.ts","names":[],"sources":["../../src/utils/elements-chain.tsx"],"mappings":";;AAeA;;;;;;;;;;;;;KAAY,oBAAA;EACV,GAAA;EACA,OAAA;EACA,KAAA,EAAO,MAAM;EACb,IAAA;EACA,QAAA;EACA,SAAA;EACA,IAAA;AAAA;AAAA,cAGW,wBAAA;AAAA,cACA,uBAAA;AAAA,cACA,uBAAA;AAAA,cAKA,oBAAA;;;AALuB;AAKpC;iBAyFgB,kBAAA,CAAmB,OAAgB,EAAP,OAAO;;iBA0KnC,kBAAA,CAAmB,KAAA,WAAgB,oBAAoB"}

package/dist/utils/elements-chain.js

@@ -1,5 +1,4 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 //#region src/utils/elements-chain.tsx
 const ELEMENTS_CHAIN_MAX_DEPTH = 8;
 const ELEMENTS_CHAIN_TEXT_MAX = 80;
@@ -47,7 +46,7 @@ function serializeElementsChainSegment(element) {
 	parts.push(element.tagName.toLowerCase());
 	const classes = getElementClasses(element);
 	if (classes.length > 0) parts.push(`.${classes.map(escapeElementsChainClass).join(".")}`);
-	const text = element.textContent.trim().replace(/\s+/g, " ").slice(0, ELEMENTS_CHAIN_TEXT_MAX);
+	const text = element.textContent.trim().replace(/\s+/g, " ").slice(0, 80);
 	const nthChild = getNthChildIndex(element);
 	const nthOfType = getNthOfTypeIndex(element);
 	const attrPairs = [];
@@ -57,11 +56,11 @@ function serializeElementsChainSegment(element) {
 	for (const attrName of ELEMENTS_CHAIN_ATTRS) {
 		const value = element.getAttribute(attrName);
 		if (value == null || value === "") continue;
-		attrPairs.push(`attr__${attrName}="${escapeElementsChainValue(value.slice(0, ELEMENTS_CHAIN_ATTR_MAX))}"`);
+		attrPairs.push(`attr__${attrName}="${escapeElementsChainValue(value.slice(0, 200))}"`);
 	}
 	if (element.tagName === "A") {
 		const href = element.getAttribute("href");
-		if (href != null && href !== "") attrPairs.push(`href="${escapeElementsChainValue(href.slice(0, ELEMENTS_CHAIN_ATTR_MAX))}"`);
+		if (href != null && href !== "") attrPairs.push(`href="${escapeElementsChainValue(href.slice(0, 200))}"`);
 	}
 	if (attrPairs.length > 0) parts.push(`:${attrPairs.join(":")}`);
 	return parts.join("");
@@ -74,7 +73,7 @@ function buildElementsChain(element) {
 	const segments = [];
 	let current = element;
 	let depth = 0;
-	while (current != null && depth < ELEMENTS_CHAIN_MAX_DEPTH && current !== document.documentElement) {
+	while (current != null && depth < 8 && current !== document.documentElement) {
 		segments.push(serializeElementsChainSegment(current));
 		current = current.parentElement;
 		depth += 1;
@@ -248,52 +247,6 @@ function parseElementsChain(chain) {
 	if (current.length > 0) segments.push(current);
 	return segments.map(parseElementsChainSegment).filter((segment) => segment != null);
 }
-(void 0)?.test("parseElementsChain parses a simple leaf+ancestor chain", ({ expect }) => {
-	expect(parseElementsChain("button.btn.btn-primary:nth-of-type=\"1\":text=\"Save\":attr__id=\"save-btn\";div.container")).toEqual([{
-		tag: "button",
-		classes: ["btn", "btn-primary"],
-		attrs: { id: "save-btn" },
-		text: "Save",
-		nthChild: null,
-		nthOfType: 1,
-		href: null
-	}, {
-		tag: "div",
-		classes: ["container"],
-		attrs: {},
-		text: null,
-		nthChild: null,
-		nthOfType: null,
-		href: null
-	}]);
-});
-(void 0)?.test("parseElementsChain reverses class escaping for Tailwind-style tokens", ({ expect }) => {
-	expect(parseElementsChain("a.md\\:hover\\:bg-blue-500.w-\\[1\\.5rem\\]:href=\"/p?a=1\"")).toEqual([{
-		tag: "a",
-		classes: ["md:hover:bg-blue-500", "w-[1.5rem]"],
-		attrs: { href: "/p?a=1" },
-		text: null,
-		nthChild: null,
-		nthOfType: null,
-		href: "/p?a=1"
-	}]);
-});
-(void 0)?.test("parseElementsChain unescapes quotes/backslashes and ignores ';' inside quoted values", ({ expect }) => {
-	expect(parseElementsChain("span:text=\"a \\\"b\\\"; c \\\\ d\"")).toEqual([{
-		tag: "span",
-		classes: [],
-		attrs: {},
-		text: "a \"b\"; c \\ d",
-		nthChild: null,
-		nthOfType: null,
-		href: null
-	}]);
-});
-(void 0)?.test("parseElementsChain drops empty/tagless segments", ({ expect }) => {
-	expect(parseElementsChain("")).toEqual([]);
-	expect(parseElementsChain(";;")).toEqual([]);
-});
-
 //#endregion
 exports.ELEMENTS_CHAIN_ATTRS = ELEMENTS_CHAIN_ATTRS;
 exports.ELEMENTS_CHAIN_ATTR_MAX = ELEMENTS_CHAIN_ATTR_MAX;
@@ -301,4 +254,5 @@ exports.ELEMENTS_CHAIN_MAX_DEPTH = ELEMENTS_CHAIN_MAX_DEPTH;
 exports.ELEMENTS_CHAIN_TEXT_MAX = ELEMENTS_CHAIN_TEXT_MAX;
 exports.buildElementsChain = buildElementsChain;
 exports.parseElementsChain = parseElementsChain;
+
 //# sourceMappingURL=elements-chain.js.map

package/dist/utils/elements-chain.js.map

@@ -1 +1 @@
-{"version":3,"file":"elements-chain.js","names":[],"sources":["../../src/utils/elements-chain.tsx"],"sourcesContent":["/**\n * PostHog-style `elements_chain` format — the single owner of both halves of the\n * contract. The event tracker {@link buildElementsChain serializes} a clicked\n * element (and its ancestors) into a string; the clickmap overlay\n * {@link parseElementsChain parses} that string back into structured segments so\n * it can re-locate the element in a live DOM.\n *\n * Encode and decode MUST round-trip exactly, which is why they live together:\n * the escaping applied here on the write side is reversed by the parser below,\n * and a single round-trip test in `elements-chain.test.tsx` guards the pair.\n *\n * Segment shape (leaf-first, joined by `;`):\n *   tag.class1.class2:nth-child=\"2\":nth-of-type=\"1\":text=\"Save\":attr__id=\"x\":href=\"...\"\n */\n\nexport type ElementsChainSegment = {\n  tag: string,\n  classes: string[],\n  attrs: Record<string, string>,\n  text: string | null,\n  nthChild: number | null,\n  nthOfType: number | null,\n  href: string | null,\n};\n\nexport const ELEMENTS_CHAIN_MAX_DEPTH = 8;\nexport const ELEMENTS_CHAIN_TEXT_MAX = 80;\nexport const ELEMENTS_CHAIN_ATTR_MAX = 200;\n\n// Attributes we serialise into elements_chain. Mirrors the set PostHog persists:\n// stable identifiers (id, data-testid), semantics (role, type, name, aria-label),\n// and a few we expect downstream tooling to want to match against.\nexport const ELEMENTS_CHAIN_ATTRS = [\n  \"id\",\n  \"data-testid\",\n  \"data-test-id\",\n  \"data-hexclave-id\",\n  \"name\",\n  \"type\",\n  \"role\",\n  \"aria-label\",\n  \"placeholder\",\n  \"title\",\n] as const;\n\n// ---------------------------------------------------------------------------\n// Serialization (DOM element -> elements_chain string)\n// ---------------------------------------------------------------------------\n\nfunction escapeElementsChainValue(value: string): string {\n  return value.replace(/\\\\/g, \"\\\\\\\\\").replace(/\"/g, '\\\\\"');\n}\n\n// Class tokens are written into the unquoted, dot-joined prefix of a segment, so\n// any \".\" or \":\" inside a class (e.g. Tailwind variants like `md:hover:bg-blue-500`\n// or arbitrary values like `w-[1.5rem]`) must be escaped to round-trip through the\n// parser, which splits the prefix on unescaped \".\" and the segment on unescaped \":\".\nfunction escapeElementsChainClass(value: string): string {\n  return value.replace(/\\\\/g, \"\\\\\\\\\").replace(/\\./g, \"\\\\.\").replace(/:/g, \"\\\\:\");\n}\n\nfunction getElementClasses(element: Element): string[] {\n  const className = (element as HTMLElement).className;\n  if (typeof className !== \"string\" || className.trim() === \"\") {\n    return [];\n  }\n  return className.trim().split(/\\s+/).filter(Boolean).slice(0, 4);\n}\n\nfunction getNthChildIndex(element: Element): number | null {\n  const parent = element.parentElement;\n  if (parent == null) return null;\n  const index = Array.prototype.indexOf.call(parent.children, element);\n  return index >= 0 ? index + 1 : null;\n}\n\nfunction getNthOfTypeIndex(element: Element): number | null {\n  const parent = element.parentElement;\n  if (parent == null) return null;\n  const tagName = element.tagName;\n  const siblings = Array.from(parent.children).filter((child) => child.tagName === tagName);\n  if (siblings.length <= 1) return null;\n  const index = siblings.indexOf(element);\n  return index >= 0 ? index + 1 : null;\n}\n\nfunction serializeElementsChainSegment(element: Element): string {\n  const parts: string[] = [];\n  parts.push(element.tagName.toLowerCase());\n  const classes = getElementClasses(element);\n  if (classes.length > 0) {\n    parts.push(`.${classes.map(escapeElementsChainClass).join(\".\")}`);\n  }\n  const text = element.textContent.trim().replace(/\\s+/g, \" \").slice(0, ELEMENTS_CHAIN_TEXT_MAX);\n  const nthChild = getNthChildIndex(element);\n  const nthOfType = getNthOfTypeIndex(element);\n  const attrPairs: string[] = [];\n  if (nthChild != null) attrPairs.push(`nth-child=\"${nthChild}\"`);\n  if (nthOfType != null) attrPairs.push(`nth-of-type=\"${nthOfType}\"`);\n  if (text !== \"\") attrPairs.push(`text=\"${escapeElementsChainValue(text)}\"`);\n  for (const attrName of ELEMENTS_CHAIN_ATTRS) {\n    const value = element.getAttribute(attrName);\n    if (value == null || value === \"\") continue;\n    attrPairs.push(`attr__${attrName}=\"${escapeElementsChainValue(value.slice(0, ELEMENTS_CHAIN_ATTR_MAX))}\"`);\n  }\n  if (element.tagName === \"A\") {\n    const href = element.getAttribute(\"href\");\n    if (href != null && href !== \"\") {\n      attrPairs.push(`href=\"${escapeElementsChainValue(href.slice(0, ELEMENTS_CHAIN_ATTR_MAX))}\"`);\n    }\n  }\n  if (attrPairs.length > 0) {\n    parts.push(`:${attrPairs.join(\":\")}`);\n  }\n  return parts.join(\"\");\n}\n\n/**\n * Serialise a clicked element and up to {@link ELEMENTS_CHAIN_MAX_DEPTH}\n * ancestors (leaf-first) into an `elements_chain` string.\n */\nexport function buildElementsChain(element: Element): string {\n  const segments: string[] = [];\n  let current: Element | null = element;\n  let depth = 0;\n  while (current != null && depth < ELEMENTS_CHAIN_MAX_DEPTH && current !== document.documentElement) {\n    segments.push(serializeElementsChainSegment(current));\n    current = current.parentElement;\n    depth += 1;\n  }\n  return segments.join(\";\");\n}\n\n// ---------------------------------------------------------------------------\n// Parsing (elements_chain string -> structured segments)\n// ---------------------------------------------------------------------------\n\n// Split a string on unescaped occurrences of `.`, unescaping `\\.`, `\\:` and `\\\\`\n// back to their literal characters. Reverses `escapeElementsChainClass`.\nfunction splitEscapedDots(input: string): string[] {\n  const out: string[] = [];\n  let cur = '';\n  for (let i = 0; i < input.length; i++) {\n    const ch = input[i];\n    if (ch === '\\\\' && i + 1 < input.length) {\n      cur += input[i + 1];\n      i += 1;\n      continue;\n    }\n    if (ch === '.') {\n      out.push(cur);\n      cur = '';\n      continue;\n    }\n    cur += ch;\n  }\n  out.push(cur);\n  return out;\n}\n\ntype ElementsChainAttrResult = {\n  nthChild?: number,\n  nthOfType?: number,\n  text?: string,\n  href?: string,\n  attrKey?: string,\n  attrValue?: string,\n};\n\nfunction applyElementsChainAttr(key: string, value: string): ElementsChainAttrResult {\n  if (key === 'nth-child') {\n    const n = Number.parseInt(value, 10);\n    return Number.isFinite(n) ? { nthChild: n } : {};\n  }\n  if (key === 'nth-of-type') {\n    const n = Number.parseInt(value, 10);\n    return Number.isFinite(n) ? { nthOfType: n } : {};\n  }\n  if (key === 'text') {\n    return { text: value };\n  }\n  if (key === 'href') {\n    return { href: value, attrKey: key, attrValue: value };\n  }\n  if (key.startsWith('attr__')) {\n    return { attrKey: key.slice('attr__'.length), attrValue: value };\n  }\n  return { attrKey: key, attrValue: value };\n}\n\nfunction parseElementsChainSegment(segment: string): ElementsChainSegment | null {\n  const trimmed = segment.trim();\n  if (trimmed === '') return null;\n\n  // Find first ':' at top level — separates tag/classes prefix from attribute pairs.\n  let prefixEnd = trimmed.length;\n  let inQuotes = false;\n  for (let i = 0; i < trimmed.length; i++) {\n    const ch = trimmed[i];\n    if (ch === '\\\\' && i + 1 < trimmed.length) {\n      i += 1;\n      continue;\n    }\n    if (ch === '\"') {\n      inQuotes = !inQuotes;\n      continue;\n    }\n    if (ch === ':' && !inQuotes) {\n      prefixEnd = i;\n      break;\n    }\n  }\n\n  const prefix = trimmed.slice(0, prefixEnd);\n  const rest = trimmed.slice(prefixEnd);\n  const prefixParts = splitEscapedDots(prefix);\n  const tag = prefixParts[0].trim().toLowerCase();\n  if (tag === '') return null;\n  const classes = prefixParts.slice(1).map((c) => c.trim()).filter((c) => c !== '');\n\n  const attrs: Record<string, string> = {};\n  let nthChild: number | null = null;\n  let nthOfType: number | null = null;\n  let text: string | null = null;\n  let href: string | null = null;\n\n  // Parse :key=\"value\" pairs from rest.\n  let i = 0;\n  while (i < rest.length) {\n    if (rest[i] !== ':') {\n      i += 1;\n      continue;\n    }\n    i += 1; // skip ':'\n    // read key up to '='\n    let keyEnd = i;\n    while (keyEnd < rest.length && rest[keyEnd] !== '=' && rest[keyEnd] !== ':') keyEnd += 1;\n    const key = rest.slice(i, keyEnd).trim();\n    if (keyEnd >= rest.length || rest[keyEnd] !== '=') {\n      i = keyEnd;\n      continue;\n    }\n    let valStart = keyEnd + 1;\n    if (rest[valStart] !== '\"') {\n      // unquoted — read until next ':' at top level\n      let end = valStart;\n      while (end < rest.length && rest[end] !== ':') end += 1;\n      const value = rest.slice(valStart, end);\n      const result = applyElementsChainAttr(key, value);\n      if (result.nthChild != null) nthChild = result.nthChild;\n      if (result.nthOfType != null) nthOfType = result.nthOfType;\n      if (result.text != null) text = result.text;\n      if (result.href != null) href = result.href;\n      if (result.attrKey != null) attrs[result.attrKey] = result.attrValue ?? '';\n      i = end;\n      continue;\n    }\n    // quoted value — find unescaped closing quote\n    valStart += 1;\n    let end = valStart;\n    let value = '';\n    while (end < rest.length) {\n      const ch = rest[end];\n      if (ch === '\\\\' && end + 1 < rest.length) {\n        const next = rest[end + 1];\n        if (next === '\"' || next === '\\\\') {\n          value += next;\n          end += 2;\n          continue;\n        }\n        value += ch;\n        end += 1;\n        continue;\n      }\n      if (ch === '\"') break;\n      value += ch;\n      end += 1;\n    }\n    const result = applyElementsChainAttr(key, value);\n    if (result.nthChild != null) nthChild = result.nthChild;\n    if (result.nthOfType != null) nthOfType = result.nthOfType;\n    if (result.text != null) text = result.text;\n    if (result.href != null) href = result.href;\n    if (result.attrKey != null) attrs[result.attrKey] = result.attrValue ?? '';\n    i = end + 1; // skip closing quote\n  }\n\n  return { tag, classes, attrs, text, nthChild, nthOfType, href };\n}\n\n/** Parse an `elements_chain` string into structured, leaf-first segments. */\nexport function parseElementsChain(chain: string): ElementsChainSegment[] {\n  // Split top-level by ';' respecting quoted strings.\n  const segments: string[] = [];\n  let current = '';\n  let inQuotes = false;\n  for (let i = 0; i < chain.length; i++) {\n    const ch = chain[i];\n    if (ch === '\\\\' && i + 1 < chain.length) {\n      current += ch + chain[i + 1];\n      i += 1;\n      continue;\n    }\n    if (ch === '\"') {\n      inQuotes = !inQuotes;\n      current += ch;\n      continue;\n    }\n    if (ch === ';' && !inQuotes) {\n      segments.push(current);\n      current = '';\n      continue;\n    }\n    current += ch;\n  }\n  if (current.length > 0) {\n    segments.push(current);\n  }\n  return segments.map(parseElementsChainSegment).filter((segment): segment is ElementsChainSegment => segment != null);\n}\n\nimport.meta.vitest?.test(\"parseElementsChain parses a simple leaf+ancestor chain\", ({ expect }) => {\n  const parsed = parseElementsChain('button.btn.btn-primary:nth-of-type=\"1\":text=\"Save\":attr__id=\"save-btn\";div.container');\n  expect(parsed).toEqual([\n    { tag: \"button\", classes: [\"btn\", \"btn-primary\"], attrs: { id: \"save-btn\" }, text: \"Save\", nthChild: null, nthOfType: 1, href: null },\n    { tag: \"div\", classes: [\"container\"], attrs: {}, text: null, nthChild: null, nthOfType: null, href: null },\n  ]);\n});\n\nimport.meta.vitest?.test(\"parseElementsChain reverses class escaping for Tailwind-style tokens\", ({ expect }) => {\n  // `md:hover:bg-blue-500` and `w-[1.5rem]` contain the prefix delimiters `:`/`.`,\n  // so the serializer escapes them; the parser must recover the literal classes.\n  const parsed = parseElementsChain('a.md\\\\:hover\\\\:bg-blue-500.w-\\\\[1\\\\.5rem\\\\]:href=\"/p?a=1\"');\n  expect(parsed).toEqual([\n    { tag: \"a\", classes: [\"md:hover:bg-blue-500\", \"w-[1.5rem]\"], attrs: { href: \"/p?a=1\" }, text: null, nthChild: null, nthOfType: null, href: \"/p?a=1\" },\n  ]);\n});\n\nimport.meta.vitest?.test(\"parseElementsChain unescapes quotes/backslashes and ignores ';' inside quoted values\", ({ expect }) => {\n  const parsed = parseElementsChain('span:text=\"a \\\\\"b\\\\\"; c \\\\\\\\ d\"');\n  expect(parsed).toEqual([\n    { tag: \"span\", classes: [], attrs: {}, text: 'a \"b\"; c \\\\ d', nthChild: null, nthOfType: null, href: null },\n  ]);\n});\n\nimport.meta.vitest?.test(\"parseElementsChain drops empty/tagless segments\", ({ expect }) => {\n  expect(parseElementsChain(\"\")).toEqual([]);\n  expect(parseElementsChain(\";;\")).toEqual([]);\n});\n"],"mappings":"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"}
+{"version":3,"file":"elements-chain.js","names":[],"sources":["../../src/utils/elements-chain.tsx"],"sourcesContent":["/**\n * PostHog-style `elements_chain` format — the single owner of both halves of the\n * contract. The event tracker {@link buildElementsChain serializes} a clicked\n * element (and its ancestors) into a string; the clickmap overlay\n * {@link parseElementsChain parses} that string back into structured segments so\n * it can re-locate the element in a live DOM.\n *\n * Encode and decode MUST round-trip exactly, which is why they live together:\n * the escaping applied here on the write side is reversed by the parser below,\n * and a single round-trip test in `elements-chain.test.tsx` guards the pair.\n *\n * Segment shape (leaf-first, joined by `;`):\n *   tag.class1.class2:nth-child=\"2\":nth-of-type=\"1\":text=\"Save\":attr__id=\"x\":href=\"...\"\n */\n\nexport type ElementsChainSegment = {\n  tag: string,\n  classes: string[],\n  attrs: Record<string, string>,\n  text: string | null,\n  nthChild: number | null,\n  nthOfType: number | null,\n  href: string | null,\n};\n\nexport const ELEMENTS_CHAIN_MAX_DEPTH = 8;\nexport const ELEMENTS_CHAIN_TEXT_MAX = 80;\nexport const ELEMENTS_CHAIN_ATTR_MAX = 200;\n\n// Attributes we serialise into elements_chain. Mirrors the set PostHog persists:\n// stable identifiers (id, data-testid), semantics (role, type, name, aria-label),\n// and a few we expect downstream tooling to want to match against.\nexport const ELEMENTS_CHAIN_ATTRS = [\n  \"id\",\n  \"data-testid\",\n  \"data-test-id\",\n  \"data-hexclave-id\",\n  \"name\",\n  \"type\",\n  \"role\",\n  \"aria-label\",\n  \"placeholder\",\n  \"title\",\n] as const;\n\n// ---------------------------------------------------------------------------\n// Serialization (DOM element -> elements_chain string)\n// ---------------------------------------------------------------------------\n\nfunction escapeElementsChainValue(value: string): string {\n  return value.replace(/\\\\/g, \"\\\\\\\\\").replace(/\"/g, '\\\\\"');\n}\n\n// Class tokens are written into the unquoted, dot-joined prefix of a segment, so\n// any \".\" or \":\" inside a class (e.g. Tailwind variants like `md:hover:bg-blue-500`\n// or arbitrary values like `w-[1.5rem]`) must be escaped to round-trip through the\n// parser, which splits the prefix on unescaped \".\" and the segment on unescaped \":\".\nfunction escapeElementsChainClass(value: string): string {\n  return value.replace(/\\\\/g, \"\\\\\\\\\").replace(/\\./g, \"\\\\.\").replace(/:/g, \"\\\\:\");\n}\n\nfunction getElementClasses(element: Element): string[] {\n  const className = (element as HTMLElement).className;\n  if (typeof className !== \"string\" || className.trim() === \"\") {\n    return [];\n  }\n  return className.trim().split(/\\s+/).filter(Boolean).slice(0, 4);\n}\n\nfunction getNthChildIndex(element: Element): number | null {\n  const parent = element.parentElement;\n  if (parent == null) return null;\n  const index = Array.prototype.indexOf.call(parent.children, element);\n  return index >= 0 ? index + 1 : null;\n}\n\nfunction getNthOfTypeIndex(element: Element): number | null {\n  const parent = element.parentElement;\n  if (parent == null) return null;\n  const tagName = element.tagName;\n  const siblings = Array.from(parent.children).filter((child) => child.tagName === tagName);\n  if (siblings.length <= 1) return null;\n  const index = siblings.indexOf(element);\n  return index >= 0 ? index + 1 : null;\n}\n\nfunction serializeElementsChainSegment(element: Element): string {\n  const parts: string[] = [];\n  parts.push(element.tagName.toLowerCase());\n  const classes = getElementClasses(element);\n  if (classes.length > 0) {\n    parts.push(`.${classes.map(escapeElementsChainClass).join(\".\")}`);\n  }\n  const text = element.textContent.trim().replace(/\\s+/g, \" \").slice(0, ELEMENTS_CHAIN_TEXT_MAX);\n  const nthChild = getNthChildIndex(element);\n  const nthOfType = getNthOfTypeIndex(element);\n  const attrPairs: string[] = [];\n  if (nthChild != null) attrPairs.push(`nth-child=\"${nthChild}\"`);\n  if (nthOfType != null) attrPairs.push(`nth-of-type=\"${nthOfType}\"`);\n  if (text !== \"\") attrPairs.push(`text=\"${escapeElementsChainValue(text)}\"`);\n  for (const attrName of ELEMENTS_CHAIN_ATTRS) {\n    const value = element.getAttribute(attrName);\n    if (value == null || value === \"\") continue;\n    attrPairs.push(`attr__${attrName}=\"${escapeElementsChainValue(value.slice(0, ELEMENTS_CHAIN_ATTR_MAX))}\"`);\n  }\n  if (element.tagName === \"A\") {\n    const href = element.getAttribute(\"href\");\n    if (href != null && href !== \"\") {\n      attrPairs.push(`href=\"${escapeElementsChainValue(href.slice(0, ELEMENTS_CHAIN_ATTR_MAX))}\"`);\n    }\n  }\n  if (attrPairs.length > 0) {\n    parts.push(`:${attrPairs.join(\":\")}`);\n  }\n  return parts.join(\"\");\n}\n\n/**\n * Serialise a clicked element and up to {@link ELEMENTS_CHAIN_MAX_DEPTH}\n * ancestors (leaf-first) into an `elements_chain` string.\n */\nexport function buildElementsChain(element: Element): string {\n  const segments: string[] = [];\n  let current: Element | null = element;\n  let depth = 0;\n  while (current != null && depth < ELEMENTS_CHAIN_MAX_DEPTH && current !== document.documentElement) {\n    segments.push(serializeElementsChainSegment(current));\n    current = current.parentElement;\n    depth += 1;\n  }\n  return segments.join(\";\");\n}\n\n// ---------------------------------------------------------------------------\n// Parsing (elements_chain string -> structured segments)\n// ---------------------------------------------------------------------------\n\n// Split a string on unescaped occurrences of `.`, unescaping `\\.`, `\\:` and `\\\\`\n// back to their literal characters. Reverses `escapeElementsChainClass`.\nfunction splitEscapedDots(input: string): string[] {\n  const out: string[] = [];\n  let cur = '';\n  for (let i = 0; i < input.length; i++) {\n    const ch = input[i];\n    if (ch === '\\\\' && i + 1 < input.length) {\n      cur += input[i + 1];\n      i += 1;\n      continue;\n    }\n    if (ch === '.') {\n      out.push(cur);\n      cur = '';\n      continue;\n    }\n    cur += ch;\n  }\n  out.push(cur);\n  return out;\n}\n\ntype ElementsChainAttrResult = {\n  nthChild?: number,\n  nthOfType?: number,\n  text?: string,\n  href?: string,\n  attrKey?: string,\n  attrValue?: string,\n};\n\nfunction applyElementsChainAttr(key: string, value: string): ElementsChainAttrResult {\n  if (key === 'nth-child') {\n    const n = Number.parseInt(value, 10);\n    return Number.isFinite(n) ? { nthChild: n } : {};\n  }\n  if (key === 'nth-of-type') {\n    const n = Number.parseInt(value, 10);\n    return Number.isFinite(n) ? { nthOfType: n } : {};\n  }\n  if (key === 'text') {\n    return { text: value };\n  }\n  if (key === 'href') {\n    return { href: value, attrKey: key, attrValue: value };\n  }\n  if (key.startsWith('attr__')) {\n    return { attrKey: key.slice('attr__'.length), attrValue: value };\n  }\n  return { attrKey: key, attrValue: value };\n}\n\nfunction parseElementsChainSegment(segment: string): ElementsChainSegment | null {\n  const trimmed = segment.trim();\n  if (trimmed === '') return null;\n\n  // Find first ':' at top level — separates tag/classes prefix from attribute pairs.\n  let prefixEnd = trimmed.length;\n  let inQuotes = false;\n  for (let i = 0; i < trimmed.length; i++) {\n    const ch = trimmed[i];\n    if (ch === '\\\\' && i + 1 < trimmed.length) {\n      i += 1;\n      continue;\n    }\n    if (ch === '\"') {\n      inQuotes = !inQuotes;\n      continue;\n    }\n    if (ch === ':' && !inQuotes) {\n      prefixEnd = i;\n      break;\n    }\n  }\n\n  const prefix = trimmed.slice(0, prefixEnd);\n  const rest = trimmed.slice(prefixEnd);\n  const prefixParts = splitEscapedDots(prefix);\n  const tag = prefixParts[0].trim().toLowerCase();\n  if (tag === '') return null;\n  const classes = prefixParts.slice(1).map((c) => c.trim()).filter((c) => c !== '');\n\n  const attrs: Record<string, string> = {};\n  let nthChild: number | null = null;\n  let nthOfType: number | null = null;\n  let text: string | null = null;\n  let href: string | null = null;\n\n  // Parse :key=\"value\" pairs from rest.\n  let i = 0;\n  while (i < rest.length) {\n    if (rest[i] !== ':') {\n      i += 1;\n      continue;\n    }\n    i += 1; // skip ':'\n    // read key up to '='\n    let keyEnd = i;\n    while (keyEnd < rest.length && rest[keyEnd] !== '=' && rest[keyEnd] !== ':') keyEnd += 1;\n    const key = rest.slice(i, keyEnd).trim();\n    if (keyEnd >= rest.length || rest[keyEnd] !== '=') {\n      i = keyEnd;\n      continue;\n    }\n    let valStart = keyEnd + 1;\n    if (rest[valStart] !== '\"') {\n      // unquoted — read until next ':' at top level\n      let end = valStart;\n      while (end < rest.length && rest[end] !== ':') end += 1;\n      const value = rest.slice(valStart, end);\n      const result = applyElementsChainAttr(key, value);\n      if (result.nthChild != null) nthChild = result.nthChild;\n      if (result.nthOfType != null) nthOfType = result.nthOfType;\n      if (result.text != null) text = result.text;\n      if (result.href != null) href = result.href;\n      if (result.attrKey != null) attrs[result.attrKey] = result.attrValue ?? '';\n      i = end;\n      continue;\n    }\n    // quoted value — find unescaped closing quote\n    valStart += 1;\n    let end = valStart;\n    let value = '';\n    while (end < rest.length) {\n      const ch = rest[end];\n      if (ch === '\\\\' && end + 1 < rest.length) {\n        const next = rest[end + 1];\n        if (next === '\"' || next === '\\\\') {\n          value += next;\n          end += 2;\n          continue;\n        }\n        value += ch;\n        end += 1;\n        continue;\n      }\n      if (ch === '\"') break;\n      value += ch;\n      end += 1;\n    }\n    const result = applyElementsChainAttr(key, value);\n    if (result.nthChild != null) nthChild = result.nthChild;\n    if (result.nthOfType != null) nthOfType = result.nthOfType;\n    if (result.text != null) text = result.text;\n    if (result.href != null) href = result.href;\n    if (result.attrKey != null) attrs[result.attrKey] = result.attrValue ?? '';\n    i = end + 1; // skip closing quote\n  }\n\n  return { tag, classes, attrs, text, nthChild, nthOfType, href };\n}\n\n/** Parse an `elements_chain` string into structured, leaf-first segments. */\nexport function parseElementsChain(chain: string): ElementsChainSegment[] {\n  // Split top-level by ';' respecting quoted strings.\n  const segments: string[] = [];\n  let current = '';\n  let inQuotes = false;\n  for (let i = 0; i < chain.length; i++) {\n    const ch = chain[i];\n    if (ch === '\\\\' && i + 1 < chain.length) {\n      current += ch + chain[i + 1];\n      i += 1;\n      continue;\n    }\n    if (ch === '\"') {\n      inQuotes = !inQuotes;\n      current += ch;\n      continue;\n    }\n    if (ch === ';' && !inQuotes) {\n      segments.push(current);\n      current = '';\n      continue;\n    }\n    current += ch;\n  }\n  if (current.length > 0) {\n    segments.push(current);\n  }\n  return segments.map(parseElementsChainSegment).filter((segment): segment is ElementsChainSegment => segment != null);\n}\n\nimport.meta.vitest?.test(\"parseElementsChain parses a simple leaf+ancestor chain\", ({ expect }) => {\n  const parsed = parseElementsChain('button.btn.btn-primary:nth-of-type=\"1\":text=\"Save\":attr__id=\"save-btn\";div.container');\n  expect(parsed).toEqual([\n    { tag: \"button\", classes: [\"btn\", \"btn-primary\"], attrs: { id: \"save-btn\" }, text: \"Save\", nthChild: null, nthOfType: 1, href: null },\n    { tag: \"div\", classes: [\"container\"], attrs: {}, text: null, nthChild: null, nthOfType: null, href: null },\n  ]);\n});\n\nimport.meta.vitest?.test(\"parseElementsChain reverses class escaping for Tailwind-style tokens\", ({ expect }) => {\n  // `md:hover:bg-blue-500` and `w-[1.5rem]` contain the prefix delimiters `:`/`.`,\n  // so the serializer escapes them; the parser must recover the literal classes.\n  const parsed = parseElementsChain('a.md\\\\:hover\\\\:bg-blue-500.w-\\\\[1\\\\.5rem\\\\]:href=\"/p?a=1\"');\n  expect(parsed).toEqual([\n    { tag: \"a\", classes: [\"md:hover:bg-blue-500\", \"w-[1.5rem]\"], attrs: { href: \"/p?a=1\" }, text: null, nthChild: null, nthOfType: null, href: \"/p?a=1\" },\n  ]);\n});\n\nimport.meta.vitest?.test(\"parseElementsChain unescapes quotes/backslashes and ignores ';' inside quoted values\", ({ expect }) => {\n  const parsed = parseElementsChain('span:text=\"a \\\\\"b\\\\\"; c \\\\\\\\ d\"');\n  expect(parsed).toEqual([\n    { tag: \"span\", classes: [], attrs: {}, text: 'a \"b\"; c \\\\ d', nthChild: null, nthOfType: null, href: null },\n  ]);\n});\n\nimport.meta.vitest?.test(\"parseElementsChain drops empty/tagless segments\", ({ expect }) => {\n  expect(parseElementsChain(\"\")).toEqual([]);\n  expect(parseElementsChain(\";;\")).toEqual([]);\n});\n"],"mappings":";;AAyBA,MAAa,2BAA2B;AACxC,MAAa,0BAA0B;AACvC,MAAa,0BAA0B;AAKvC,MAAa,uBAAuB;CAClC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;AAMA,SAAS,yBAAyB,OAAuB;CACvD,OAAO,MAAM,QAAQ,OAAO,MAAM,CAAC,CAAC,QAAQ,MAAM,MAAK;AACzD;AAMA,SAAS,yBAAyB,OAAuB;CACvD,OAAO,MAAM,QAAQ,OAAO,MAAM,CAAC,CAAC,QAAQ,OAAO,KAAK,CAAC,CAAC,QAAQ,MAAM,KAAK;AAC/E;AAEA,SAAS,kBAAkB,SAA4B;CACrD,MAAM,YAAa,QAAwB;CAC3C,IAAI,OAAO,cAAc,YAAY,UAAU,KAAK,MAAM,IACxD,OAAO,CAAC;CAEV,OAAO,UAAU,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,OAAO,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC;AACjE;AAEA,SAAS,iBAAiB,SAAiC;CACzD,MAAM,SAAS,QAAQ;CACvB,IAAI,UAAU,MAAM,OAAO;CAC3B,MAAM,QAAQ,MAAM,UAAU,QAAQ,KAAK,OAAO,UAAU,OAAO;CACnE,OAAO,SAAS,IAAI,QAAQ,IAAI;AAClC;AAEA,SAAS,kBAAkB,SAAiC;CAC1D,MAAM,SAAS,QAAQ;CACvB,IAAI,UAAU,MAAM,OAAO;CAC3B,MAAM,UAAU,QAAQ;CACxB,MAAM,WAAW,MAAM,KAAK,OAAO,QAAQ,CAAC,CAAC,QAAQ,UAAU,MAAM,YAAY,OAAO;CACxF,IAAI,SAAS,UAAU,GAAG,OAAO;CACjC,MAAM,QAAQ,SAAS,QAAQ,OAAO;CACtC,OAAO,SAAS,IAAI,QAAQ,IAAI;AAClC;AAEA,SAAS,8BAA8B,SAA0B;CAC/D,MAAM,QAAkB,CAAC;CACzB,MAAM,KAAK,QAAQ,QAAQ,YAAY,CAAC;CACxC,MAAM,UAAU,kBAAkB,OAAO;CACzC,IAAI,QAAQ,SAAS,GACnB,MAAM,KAAK,IAAI,QAAQ,IAAI,wBAAwB,CAAC,CAAC,KAAK,GAAG,GAAG;CAElE,MAAM,OAAO,QAAQ,YAAY,KAAK,CAAC,CAAC,QAAQ,QAAQ,GAAG,CAAC,CAAC,MAAM,GAAA,EAA0B;CAC7F,MAAM,WAAW,iBAAiB,OAAO;CACzC,MAAM,YAAY,kBAAkB,OAAO;CAC3C,MAAM,YAAsB,CAAC;CAC7B,IAAI,YAAY,MAAM,UAAU,KAAK,cAAc,SAAS,EAAE;CAC9D,IAAI,aAAa,MAAM,UAAU,KAAK,gBAAgB,UAAU,EAAE;CAClE,IAAI,SAAS,IAAI,UAAU,KAAK,SAAS,yBAAyB,IAAI,EAAE,EAAE;CAC1E,KAAK,MAAM,YAAY,sBAAsB;EAC3C,MAAM,QAAQ,QAAQ,aAAa,QAAQ;EAC3C,IAAI,SAAS,QAAQ,UAAU,IAAI;EACnC,UAAU,KAAK,SAAS,SAAS,IAAI,yBAAyB,MAAM,MAAM,GAAA,GAA0B,CAAC,EAAE,EAAE;CAC3G;CACA,IAAI,QAAQ,YAAY,KAAK;EAC3B,MAAM,OAAO,QAAQ,aAAa,MAAM;EACxC,IAAI,QAAQ,QAAQ,SAAS,IAC3B,UAAU,KAAK,SAAS,yBAAyB,KAAK,MAAM,GAAA,GAA0B,CAAC,EAAE,EAAE;CAE/F;CACA,IAAI,UAAU,SAAS,GACrB,MAAM,KAAK,IAAI,UAAU,KAAK,GAAG,GAAG;CAEtC,OAAO,MAAM,KAAK,EAAE;AACtB;;;;;AAMA,SAAgB,mBAAmB,SAA0B;CAC3D,MAAM,WAAqB,CAAC;CAC5B,IAAI,UAA0B;CAC9B,IAAI,QAAQ;CACZ,OAAO,WAAW,QAAQ,QAAA,KAAoC,YAAY,SAAS,iBAAiB;EAClG,SAAS,KAAK,8BAA8B,OAAO,CAAC;EACpD,UAAU,QAAQ;EAClB,SAAS;CACX;CACA,OAAO,SAAS,KAAK,GAAG;AAC1B;AAQA,SAAS,iBAAiB,OAAyB;CACjD,MAAM,MAAgB,CAAC;CACvB,IAAI,MAAM;CACV,KAAK,IAAI,IAAI,GAAG,IAAI,MAAM,QAAQ,KAAK;EACrC,MAAM,KAAK,MAAM;EACjB,IAAI,OAAO,QAAQ,IAAI,IAAI,MAAM,QAAQ;GACvC,OAAO,MAAM,IAAI;GACjB,KAAK;GACL;EACF;EACA,IAAI,OAAO,KAAK;GACd,IAAI,KAAK,GAAG;GACZ,MAAM;GACN;EACF;EACA,OAAO;CACT;CACA,IAAI,KAAK,GAAG;CACZ,OAAO;AACT;AAWA,SAAS,uBAAuB,KAAa,OAAwC;CACnF,IAAI,QAAQ,aAAa;EACvB,MAAM,IAAI,OAAO,SAAS,OAAO,EAAE;EACnC,OAAO,OAAO,SAAS,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC;CACjD;CACA,IAAI,QAAQ,eAAe;EACzB,MAAM,IAAI,OAAO,SAAS,OAAO,EAAE;EACnC,OAAO,OAAO,SAAS,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC;CAClD;CACA,IAAI,QAAQ,QACV,OAAO,EAAE,MAAM,MAAM;CAEvB,IAAI,QAAQ,QACV,OAAO;EAAE,MAAM;EAAO,SAAS;EAAK,WAAW;CAAM;CAEvD,IAAI,IAAI,WAAW,QAAQ,GACzB,OAAO;EAAE,SAAS,IAAI,MAAM,CAAe;EAAG,WAAW;CAAM;CAEjE,OAAO;EAAE,SAAS;EAAK,WAAW;CAAM;AAC1C;AAEA,SAAS,0BAA0B,SAA8C;CAC/E,MAAM,UAAU,QAAQ,KAAK;CAC7B,IAAI,YAAY,IAAI,OAAO;CAG3B,IAAI,YAAY,QAAQ;CACxB,IAAI,WAAW;CACf,KAAK,IAAI,IAAI,GAAG,IAAI,QAAQ,QAAQ,KAAK;EACvC,MAAM,KAAK,QAAQ;EACnB,IAAI,OAAO,QAAQ,IAAI,IAAI,QAAQ,QAAQ;GACzC,KAAK;GACL;EACF;EACA,IAAI,OAAO,MAAK;GACd,WAAW,CAAC;GACZ;EACF;EACA,IAAI,OAAO,OAAO,CAAC,UAAU;GAC3B,YAAY;GACZ;EACF;CACF;CAEA,MAAM,SAAS,QAAQ,MAAM,GAAG,SAAS;CACzC,MAAM,OAAO,QAAQ,MAAM,SAAS;CACpC,MAAM,cAAc,iBAAiB,MAAM;CAC3C,MAAM,MAAM,YAAY,EAAE,CAAC,KAAK,CAAC,CAAC,YAAY;CAC9C,IAAI,QAAQ,IAAI,OAAO;CACvB,MAAM,UAAU,YAAY,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,MAAM,MAAM,EAAE;CAEhF,MAAM,QAAgC,CAAC;CACvC,IAAI,WAA0B;CAC9B,IAAI,YAA2B;CAC/B,IAAI,OAAsB;CAC1B,IAAI,OAAsB;CAG1B,IAAI,IAAI;CACR,OAAO,IAAI,KAAK,QAAQ;EACtB,IAAI,KAAK,OAAO,KAAK;GACnB,KAAK;GACL;EACF;EACA,KAAK;EAEL,IAAI,SAAS;EACb,OAAO,SAAS,KAAK,UAAU,KAAK,YAAY,OAAO,KAAK,YAAY,KAAK,UAAU;EACvF,MAAM,MAAM,KAAK,MAAM,GAAG,MAAM,CAAC,CAAC,KAAK;EACvC,IAAI,UAAU,KAAK,UAAU,KAAK,YAAY,KAAK;GACjD,IAAI;GACJ;EACF;EACA,IAAI,WAAW,SAAS;EACxB,IAAI,KAAK,cAAc,MAAK;GAE1B,IAAI,MAAM;GACV,OAAO,MAAM,KAAK,UAAU,KAAK,SAAS,KAAK,OAAO;GAEtD,MAAM,SAAS,uBAAuB,KADxB,KAAK,MAAM,UAAU,GACY,CAAC;GAChD,IAAI,OAAO,YAAY,MAAM,WAAW,OAAO;GAC/C,IAAI,OAAO,aAAa,MAAM,YAAY,OAAO;GACjD,IAAI,OAAO,QAAQ,MAAM,OAAO,OAAO;GACvC,IAAI,OAAO,QAAQ,MAAM,OAAO,OAAO;GACvC,IAAI,OAAO,WAAW,MAAM,MAAM,OAAO,WAAW,OAAO,aAAa;GACxE,IAAI;GACJ;EACF;EAEA,YAAY;EACZ,IAAI,MAAM;EACV,IAAI,QAAQ;EACZ,OAAO,MAAM,KAAK,QAAQ;GACxB,MAAM,KAAK,KAAK;GAChB,IAAI,OAAO,QAAQ,MAAM,IAAI,KAAK,QAAQ;IACxC,MAAM,OAAO,KAAK,MAAM;IACxB,IAAI,SAAS,QAAO,SAAS,MAAM;KACjC,SAAS;KACT,OAAO;KACP;IACF;IACA,SAAS;IACT,OAAO;IACP;GACF;GACA,IAAI,OAAO,MAAK;GAChB,SAAS;GACT,OAAO;EACT;EACA,MAAM,SAAS,uBAAuB,KAAK,KAAK;EAChD,IAAI,OAAO,YAAY,MAAM,WAAW,OAAO;EAC/C,IAAI,OAAO,aAAa,MAAM,YAAY,OAAO;EACjD,IAAI,OAAO,QAAQ,MAAM,OAAO,OAAO;EACvC,IAAI,OAAO,QAAQ,MAAM,OAAO,OAAO;EACvC,IAAI,OAAO,WAAW,MAAM,MAAM,OAAO,WAAW,OAAO,aAAa;EACxE,IAAI,MAAM;CACZ;CAEA,OAAO;EAAE;EAAK;EAAS;EAAO;EAAM;EAAU;EAAW;CAAK;AAChE;;AAGA,SAAgB,mBAAmB,OAAuC;CAExE,MAAM,WAAqB,CAAC;CAC5B,IAAI,UAAU;CACd,IAAI,WAAW;CACf,KAAK,IAAI,IAAI,GAAG,IAAI,MAAM,QAAQ,KAAK;EACrC,MAAM,KAAK,MAAM;EACjB,IAAI,OAAO,QAAQ,IAAI,IAAI,MAAM,QAAQ;GACvC,WAAW,KAAK,MAAM,IAAI;GAC1B,KAAK;GACL;EACF;EACA,IAAI,OAAO,MAAK;GACd,WAAW,CAAC;GACZ,WAAW;GACX;EACF;EACA,IAAI,OAAO,OAAO,CAAC,UAAU;GAC3B,SAAS,KAAK,OAAO;GACrB,UAAU;GACV;EACF;EACA,WAAW;CACb;CACA,IAAI,QAAQ,SAAS,GACnB,SAAS,KAAK,OAAO;CAEvB,OAAO,SAAS,IAAI,yBAAyB,CAAC,CAAC,QAAQ,YAA6C,WAAW,IAAI;AACrH"}

package/dist/utils/env.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"env.d.ts","names":[],"sources":["../../src/utils/env.tsx"],"mappings":";iBAGgB,aAAA,CAAA;AAAA,iBASA,+BAAA,CAAgC,YAAA,UAAsB,SAAA,UAAmB,aAAA,sBAAmC,UAAA;;;;iBAgC5G,cAAA,CAAe,IAAA,UAAc,YAAA;AAAA,iBAgD7B,aAAA,CAAc,IAAA;AAAA,iBAWd,cAAA,CAAA;AAAA,iBAKA,kBAAA,CAAA;;;;;;;;AAhEhB;;;;;iBAgFgB,aAAA,CAAc,IAAA"}
+{"version":3,"file":"env.d.ts","names":[],"sources":["../../src/utils/env.tsx"],"mappings":";iBAGgB,aAAA;AAAA,iBASA,+BAAA,CAAgC,YAAA,UAAsB,SAAA,UAAmB,aAAA,sBAAmC,UAAA;;;;iBAgC5G,cAAA,CAAe,IAAA,UAAc,YAAiC;AAAA,iBAgD9D,aAAA,CAAc,IAAY;AAAA,iBAW1B,cAAA;AAAA,iBAKA,kBAAA;;;;;;;AAhG0I;AAgC1J;;;;AAA8E;iBAgF9D,aAAA,CAAc,IAAY"}

package/dist/utils/env.js

@@ -1,8 +1,6 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_chunk = require('../chunk-BE-pF4vm.js');
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 let __errors_js = require("./errors.js");
 let __strings_js = require("./strings.js");
-
 //#region src/utils/env.tsx
 function isBrowserLike() {
 	return typeof window !== "undefined" && typeof document !== "undefined" && typeof document.createElement !== "undefined";
@@ -86,7 +84,6 @@ function getProcessEnv(name) {
 	if (typeof process === "undefined" || typeof process.env === "undefined") return;
 	return getEnvVarWithHexclaveFallback(name);
 }
-
 //#endregion
 exports.getEnvBoolean = getEnvBoolean;
 exports.getEnvVariable = getEnvVariable;
@@ -95,4 +92,5 @@ exports.getNodeEnvironment = getNodeEnvironment;
 exports.getProcessEnv = getProcessEnv;
 exports.isBrowserLike = isBrowserLike;
 exports.resolveHexclaveStackEnvVarValue = resolveHexclaveStackEnvVarValue;
+
 //# sourceMappingURL=env.js.map