@budiauktioner/buildi-primitives 0.1.1 → 0.2.0

package/dist/cjs/measurement/weight-unit.js

@@ -0,0 +1,158 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var weight_unit_exports = {};
+__export(weight_unit_exports, {
+  WeightUnit: () => WeightUnit
+});
+module.exports = __toCommonJS(weight_unit_exports);
+var import_decimal = require("../internal/decimal.js");
+var import_measurement_unit = require("../internal/measurement-unit.js");
+function factor(literal) {
+  const parsed = import_decimal.Decimal.parse(literal);
+  if (parsed === null) throw new Error(`Invalid conversion factor: ${literal}`);
+  return parsed;
+}
+class WeightUnit extends import_measurement_unit.MeasurementUnit {
+  static typeInfo = Object.freeze({
+    englishName: "Weight Unit",
+    localizedName: "Viktenhet",
+    emoji: "\u2696\uFE0F",
+    sources: Object.freeze([])
+  });
+  static Microgram = new WeightUnit({
+    symbol: "\xB5g",
+    englishName: "microgram",
+    localizedName: "mikrogram",
+    pluralEnglish: "micrograms",
+    pluralSwedish: "mikrogram",
+    toBaseUnitFactor: factor("0.000000001"),
+    aliases: ["ug"]
+  });
+  static Milligram = new WeightUnit({
+    symbol: "mg",
+    englishName: "milligram",
+    localizedName: "milligram",
+    pluralEnglish: "milligrams",
+    pluralSwedish: "milligram",
+    toBaseUnitFactor: factor("0.000001")
+  });
+  static Gram = new WeightUnit({
+    symbol: "g",
+    englishName: "gram",
+    localizedName: "gram",
+    pluralEnglish: "grams",
+    pluralSwedish: "gram",
+    toBaseUnitFactor: factor("0.001")
+  });
+  static Hectogram = new WeightUnit({
+    symbol: "hg",
+    englishName: "hectogram",
+    localizedName: "hektogram",
+    pluralEnglish: "hectograms",
+    pluralSwedish: "hektogram",
+    toBaseUnitFactor: factor("0.1"),
+    aliases: ["hekto"]
+  });
+  static Kilogram = new WeightUnit({
+    symbol: "kg",
+    englishName: "kilogram",
+    localizedName: "kilogram",
+    pluralEnglish: "kilograms",
+    pluralSwedish: "kilogram",
+    toBaseUnitFactor: factor("1"),
+    aliases: ["kilo", "kilos"]
+  });
+  static MetricTon = new WeightUnit({
+    symbol: "t",
+    englishName: "metric ton",
+    localizedName: "ton",
+    pluralEnglish: "metric tons",
+    pluralSwedish: "ton",
+    toBaseUnitFactor: factor("1000"),
+    aliases: ["ton", "tonne", "tonnes", "metric ton", "metric tons"]
+  });
+  static Pound = new WeightUnit({
+    symbol: "lb",
+    englishName: "pound",
+    localizedName: "pund",
+    pluralEnglish: "pounds",
+    pluralSwedish: "pund",
+    toBaseUnitFactor: factor("0.45359237"),
+    aliases: ["pound", "pounds", "lbs"]
+  });
+  static Ounce = new WeightUnit({
+    symbol: "oz",
+    englishName: "ounce",
+    localizedName: "uns",
+    pluralEnglish: "ounces",
+    pluralSwedish: "uns",
+    toBaseUnitFactor: factor("0.028349523125"),
+    aliases: ["ounce", "ounces"]
+  });
+  static Stone = new WeightUnit({
+    symbol: "st",
+    englishName: "stone",
+    localizedName: "stone",
+    pluralEnglish: "stones",
+    pluralSwedish: "stone",
+    toBaseUnitFactor: factor("6.35029318"),
+    aliases: ["stone", "stones"]
+  });
+  /** @internal Shared lookup and natural-scale walk. */
+  static index = new import_measurement_unit.MeasurementUnitIndex(
+    [
+      WeightUnit.Microgram,
+      WeightUnit.Milligram,
+      WeightUnit.Gram,
+      WeightUnit.Hectogram,
+      WeightUnit.Kilogram,
+      WeightUnit.MetricTon,
+      WeightUnit.Pound,
+      WeightUnit.Ounce,
+      WeightUnit.Stone
+    ],
+    WeightUnit.Kilogram,
+    [WeightUnit.Milligram, WeightUnit.Gram, WeightUnit.Kilogram, WeightUnit.MetricTon]
+  );
+  static get all() {
+    return WeightUnit.index.all;
+  }
+  /** The base unit: kg. */
+  static get baseUnit() {
+    return WeightUnit.index.baseUnit;
+  }
+  /** Units ordered small to large, used to auto-scale display. */
+  static get naturalScale() {
+    return WeightUnit.index.naturalScale;
+  }
+  /** Resolves a unit from a symbol, name, plural or alias, case-insensitively. */
+  static tryParse(input) {
+    return WeightUnit.index.tryParse(input);
+  }
+  static parse(input) {
+    const result = WeightUnit.tryParse(input);
+    if (result === null) throw new Error("Unknown weight unit.");
+    return result;
+  }
+  /** Returns the most human-readable unit for a value in kg. */
+  static getNatural(baseValue) {
+    return WeightUnit.index.getNatural(baseValue);
+  }
+}
+//# sourceMappingURL=weight-unit.js.map

package/dist/cjs/measurement/weight-unit.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/measurement/weight-unit.ts"],
+  "sourcesContent": ["import { Decimal } from \"../internal/decimal.js\";\nimport { MeasurementUnit, MeasurementUnitIndex } from \"../internal/measurement-unit.js\";\nimport type { PrimitiveTypeInfo } from \"../primitive-type-info.js\";\n\nfunction factor(literal: string): Decimal {\n  const parsed = Decimal.parse(literal);\n  /* c8 ignore next */\n  if (parsed === null) throw new Error(`Invalid conversion factor: ${literal}`);\n  return parsed;\n}\n\n/**\n * A unit of weight identified by its symbol.\n * Each unit carries English and Swedish names, singular and plural forms, and an\n * exact conversion factor to the base unit.\n */\nexport class WeightUnit extends MeasurementUnit {\n  declare private readonly __weightUnitBrand: void;\n\n  static readonly typeInfo: PrimitiveTypeInfo = Object.freeze({\n    englishName: \"Weight Unit\",\n    localizedName: \"Viktenhet\",\n    emoji: \"\u2696\uFE0F\",\n    sources: Object.freeze([]),\n  });\n\n  static readonly Microgram = new WeightUnit({\n    symbol: \"\u00B5g\",\n    englishName: \"microgram\",\n    localizedName: \"mikrogram\",\n    pluralEnglish: \"micrograms\",\n    pluralSwedish: \"mikrogram\",\n    toBaseUnitFactor: factor(\"0.000000001\"),\n    aliases: [\"ug\"],\n  });\n\n  static readonly Milligram = new WeightUnit({\n    symbol: \"mg\",\n    englishName: \"milligram\",\n    localizedName: \"milligram\",\n    pluralEnglish: \"milligrams\",\n    pluralSwedish: \"milligram\",\n    toBaseUnitFactor: factor(\"0.000001\"),\n  });\n\n  static readonly Gram = new WeightUnit({\n    symbol: \"g\",\n    englishName: \"gram\",\n    localizedName: \"gram\",\n    pluralEnglish: \"grams\",\n    pluralSwedish: \"gram\",\n    toBaseUnitFactor: factor(\"0.001\"),\n  });\n\n  static readonly Hectogram = new WeightUnit({\n    symbol: \"hg\",\n    englishName: \"hectogram\",\n    localizedName: \"hektogram\",\n    pluralEnglish: \"hectograms\",\n    pluralSwedish: \"hektogram\",\n    toBaseUnitFactor: factor(\"0.1\"),\n    aliases: [\"hekto\"],\n  });\n\n  static readonly Kilogram = new WeightUnit({\n    symbol: \"kg\",\n    englishName: \"kilogram\",\n    localizedName: \"kilogram\",\n    pluralEnglish: \"kilograms\",\n    pluralSwedish: \"kilogram\",\n    toBaseUnitFactor: factor(\"1\"),\n    aliases: [\"kilo\", \"kilos\"],\n  });\n\n  static readonly MetricTon = new WeightUnit({\n    symbol: \"t\",\n    englishName: \"metric ton\",\n    localizedName: \"ton\",\n    pluralEnglish: \"metric tons\",\n    pluralSwedish: \"ton\",\n    toBaseUnitFactor: factor(\"1000\"),\n    aliases: [\"ton\", \"tonne\", \"tonnes\", \"metric ton\", \"metric tons\"],\n  });\n\n  static readonly Pound = new WeightUnit({\n    symbol: \"lb\",\n    englishName: \"pound\",\n    localizedName: \"pund\",\n    pluralEnglish: \"pounds\",\n    pluralSwedish: \"pund\",\n    toBaseUnitFactor: factor(\"0.45359237\"),\n    aliases: [\"pound\", \"pounds\", \"lbs\"],\n  });\n\n  static readonly Ounce = new WeightUnit({\n    symbol: \"oz\",\n    englishName: \"ounce\",\n    localizedName: \"uns\",\n    pluralEnglish: \"ounces\",\n    pluralSwedish: \"uns\",\n    toBaseUnitFactor: factor(\"0.028349523125\"),\n    aliases: [\"ounce\", \"ounces\"],\n  });\n\n  static readonly Stone = new WeightUnit({\n    symbol: \"st\",\n    englishName: \"stone\",\n    localizedName: \"stone\",\n    pluralEnglish: \"stones\",\n    pluralSwedish: \"stone\",\n    toBaseUnitFactor: factor(\"6.35029318\"),\n    aliases: [\"stone\", \"stones\"],\n  });\n\n  /** @internal Shared lookup and natural-scale walk. */\n  static readonly index: MeasurementUnitIndex<WeightUnit> = new MeasurementUnitIndex<WeightUnit>(\n    [\n      WeightUnit.Microgram,\n      WeightUnit.Milligram,\n      WeightUnit.Gram,\n      WeightUnit.Hectogram,\n      WeightUnit.Kilogram,\n      WeightUnit.MetricTon,\n      WeightUnit.Pound,\n      WeightUnit.Ounce,\n      WeightUnit.Stone,\n    ],\n    WeightUnit.Kilogram,\n    [WeightUnit.Milligram, WeightUnit.Gram, WeightUnit.Kilogram, WeightUnit.MetricTon],\n  );\n\n  static get all(): readonly WeightUnit[] {\n    return WeightUnit.index.all;\n  }\n\n  /** The base unit: kg. */\n  static get baseUnit(): WeightUnit {\n    return WeightUnit.index.baseUnit;\n  }\n\n  /** Units ordered small to large, used to auto-scale display. */\n  static get naturalScale(): readonly WeightUnit[] {\n    return WeightUnit.index.naturalScale;\n  }\n\n  /** Resolves a unit from a symbol, name, plural or alias, case-insensitively. */\n  static tryParse(input: string | null | undefined): WeightUnit | null {\n    return WeightUnit.index.tryParse(input);\n  }\n\n  static parse(input: string): WeightUnit {\n    const result = WeightUnit.tryParse(input);\n    if (result === null) throw new Error(\"Unknown weight unit.\");\n    return result;\n  }\n\n  /** Returns the most human-readable unit for a value in kg. */\n  static getNatural(baseValue: Decimal): WeightUnit {\n    return WeightUnit.index.getNatural(baseValue);\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/cjs/measurement/weight.js

@@ -0,0 +1,183 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var weight_exports = {};
+__export(weight_exports, {
+  Weight: () => Weight,
+  maskWeight: () => maskWeight
+});
+module.exports = __toCommonJS(weight_exports);
+var import_decimal = require("../internal/decimal.js");
+var import_quantity = require("../internal/quantity.js");
+var import_text_candidate = require("../text-scanning/text-candidate.js");
+var import_text_candidate_category = require("../text-scanning/text-candidate-category.js");
+var import_text_match_confidence = require("../text-scanning/text-match-confidence.js");
+var import_weight_unit = require("./weight-unit.js");
+const SCAN_PATTERN = new RegExp(
+  String.raw`(?<!\w)(?:[+-]\s*)?\d+[0-9 .,]*\s*(?:metric\s+ton|microgram|milligram|hectogram|hektogram|kilogram|gram|tonne|ton|ounces|ounce|pounds|pound|stones|stone|hekto|lbs|lb|µg|ug|mg|hg|kg|g|oz|st|t|pund|uns)\b`,
+  "giu"
+);
+class Weight extends import_quantity.Quantity {
+  static typeInfo = Object.freeze({
+    englishName: "Weight",
+    localizedName: "Vikt",
+    emoji: "\u2696\uFE0F",
+    sources: Object.freeze([
+      "https://www.bipm.org/en/measurement-units/si-base-units",
+      "https://en.wikipedia.org/wiki/Conversion_of_units"
+    ])
+  });
+  get units() {
+    return import_weight_unit.WeightUnit.index;
+  }
+  withBaseValue(baseValue, unit) {
+    return new Weight(baseValue, unit);
+  }
+  get micrograms() {
+    return this.in(import_weight_unit.WeightUnit.Microgram);
+  }
+  get milligrams() {
+    return this.in(import_weight_unit.WeightUnit.Milligram);
+  }
+  get grams() {
+    return this.in(import_weight_unit.WeightUnit.Gram);
+  }
+  get hectograms() {
+    return this.in(import_weight_unit.WeightUnit.Hectogram);
+  }
+  get kilograms() {
+    return this.in(import_weight_unit.WeightUnit.Kilogram);
+  }
+  get metricTons() {
+    return this.in(import_weight_unit.WeightUnit.MetricTon);
+  }
+  get pounds() {
+    return this.in(import_weight_unit.WeightUnit.Pound);
+  }
+  get ounces() {
+    return this.in(import_weight_unit.WeightUnit.Ounce);
+  }
+  get stones() {
+    return this.in(import_weight_unit.WeightUnit.Stone);
+  }
+  /** Creates a weight from a value and unit. */
+  static create(value, unit) {
+    import_weight_unit.WeightUnit.index.assertOwns(unit);
+    const amount = value instanceof import_decimal.Decimal ? value : Weight.decimalOf(value);
+    return new Weight(unit.toBase(amount), unit);
+  }
+  static fromMicrograms(value) {
+    return Weight.create(value, import_weight_unit.WeightUnit.Microgram);
+  }
+  static fromMilligrams(value) {
+    return Weight.create(value, import_weight_unit.WeightUnit.Milligram);
+  }
+  static fromGrams(value) {
+    return Weight.create(value, import_weight_unit.WeightUnit.Gram);
+  }
+  static fromHectograms(value) {
+    return Weight.create(value, import_weight_unit.WeightUnit.Hectogram);
+  }
+  static fromKilograms(value) {
+    return Weight.create(value, import_weight_unit.WeightUnit.Kilogram);
+  }
+  static fromMetricTons(value) {
+    return Weight.create(value, import_weight_unit.WeightUnit.MetricTon);
+  }
+  static fromPounds(value) {
+    return Weight.create(value, import_weight_unit.WeightUnit.Pound);
+  }
+  static fromOunces(value) {
+    return Weight.create(value, import_weight_unit.WeightUnit.Ounce);
+  }
+  static fromStones(value) {
+    return Weight.create(value, import_weight_unit.WeightUnit.Stone);
+  }
+  static tryParse(input) {
+    const parsed = (0, import_quantity.tryParseQuantity)(input, import_weight_unit.WeightUnit.index);
+    return parsed === null ? null : new Weight(parsed.baseValue, parsed.unit);
+  }
+  static parse(input) {
+    const result = Weight.tryParse(input);
+    if (result === null) throw new Error("Invalid weight.");
+    return result;
+  }
+  static isValid(input) {
+    return Weight.tryParse(input) !== null;
+  }
+  /** Display form in the parsed unit, or `null` when the input is invalid. */
+  static format(input, options) {
+    const parsed = Weight.tryParse(input);
+    if (parsed !== null) {
+      if (options?.unit !== void 0 || options?.decimals !== void 0) {
+        return parsed.toStringInUnit(options.unit ?? parsed.originalUnit, options.decimals);
+      }
+      return parsed.toString();
+    }
+    return Weight.fallback(input, options);
+  }
+  /** The value in kilograms, or `null` when the input is invalid. */
+  static normalize(input, options) {
+    const parsed = Weight.tryParse(input);
+    if (parsed !== null) return parsed.toNormalizedString();
+    return Weight.fallback(input, options);
+  }
+  static isNormalized(input) {
+    return input != null && Weight.normalize(input) === input;
+  }
+  static findCandidatesInText(text) {
+    if (!text) return [];
+    const out = [];
+    const pattern = new RegExp(SCAN_PATTERN.source, SCAN_PATTERN.flags);
+    let match;
+    while ((match = pattern.exec(text)) !== null) {
+      const value = Weight.tryParse(match[0]);
+      if (value === null) continue;
+      out.push(
+        new import_text_candidate.TextCandidate({
+          startIndex: match.index,
+          length: match[0].length,
+          originalText: match[0],
+          typeName: "Weight",
+          category: import_text_candidate_category.TextCandidateCategory.Measurement,
+          normalizedForm: value.toNormalizedString(),
+          formattedForm: value.toString(),
+          maskedForm: maskWeight(value),
+          confidence: import_text_match_confidence.TextMatchConfidence.Medium,
+          value
+        })
+      );
+    }
+    return out;
+  }
+  static fallback(input, options) {
+    if (options?.fallbackToTrimmedInputWhenInvalid !== true) return null;
+    if (input == null) return null;
+    const trimmed = input.trim();
+    return trimmed.length > 0 ? trimmed : null;
+  }
+  static decimalOf(value) {
+    const parsed = import_decimal.Decimal.fromNumber(value);
+    if (parsed === null) throw new Error(`Value cannot be represented as a weight: ${value}`);
+    return parsed;
+  }
+}
+function maskWeight(value) {
+  return `*** ${value.originalUnit.symbol}`;
+}
+//# sourceMappingURL=weight.js.map

package/dist/cjs/measurement/weight.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/measurement/weight.ts"],
+  "sourcesContent": ["import { Decimal } from \"../internal/decimal.js\";\nimport type { MeasurementUnitIndex } from \"../internal/measurement-unit.js\";\nimport { Quantity, tryParseQuantity } from \"../internal/quantity.js\";\nimport type { PrimitiveTypeInfo } from \"../primitive-type-info.js\";\nimport { TextCandidate } from \"../text-scanning/text-candidate.js\";\nimport { TextCandidateCategory } from \"../text-scanning/text-candidate-category.js\";\nimport { TextMatchConfidence } from \"../text-scanning/text-match-confidence.js\";\nimport { WeightUnit } from \"./weight-unit.js\";\n\n/** Options for {@link Weight.format} and {@link Weight.normalize}. */\nexport interface WeightFormatOptions {\n  fallbackToTrimmedInputWhenInvalid?: boolean;\n  /** Convert to this unit instead of preserving the parsed one. */\n  unit?: WeightUnit;\n  /** Round to this many fractional digits, away from zero. */\n  decimals?: number;\n}\n\nconst SCAN_PATTERN = new RegExp(\n  String.raw`(?<!\\w)(?:[+-]\\s*)?\\d+[0-9 .,]*\\s*(?:metric\\s+ton|microgram|milligram|hectogram|hektogram|kilogram|gram|tonne|ton|ounces|ounce|pounds|pound|stones|stone|hekto|lbs|lb|\u00B5g|ug|mg|hg|kg|g|oz|st|t|pund|uns)\\b`,\n  \"giu\",\n);\n\n/**\n * A weight stored internally in kilograms,\n * parsed from any supported unit and convertible between all of them.\n */\nexport class Weight extends Quantity<WeightUnit> {\n  static readonly typeInfo: PrimitiveTypeInfo = Object.freeze({\n    englishName: \"Weight\",\n    localizedName: \"Vikt\",\n    emoji: \"\u2696\uFE0F\",\n    sources: Object.freeze([\n      \"https://www.bipm.org/en/measurement-units/si-base-units\",\n      \"https://en.wikipedia.org/wiki/Conversion_of_units\",\n    ]),\n  });\n\n  protected get units(): MeasurementUnitIndex<WeightUnit> {\n    return WeightUnit.index;\n  }\n\n  protected withBaseValue(baseValue: Decimal, unit: WeightUnit): this {\n    return new Weight(baseValue, unit) as this;\n  }\n\n  get micrograms(): number {\n    return this.in(WeightUnit.Microgram);\n  }\n  get milligrams(): number {\n    return this.in(WeightUnit.Milligram);\n  }\n  get grams(): number {\n    return this.in(WeightUnit.Gram);\n  }\n  get hectograms(): number {\n    return this.in(WeightUnit.Hectogram);\n  }\n  get kilograms(): number {\n    return this.in(WeightUnit.Kilogram);\n  }\n  get metricTons(): number {\n    return this.in(WeightUnit.MetricTon);\n  }\n  get pounds(): number {\n    return this.in(WeightUnit.Pound);\n  }\n  get ounces(): number {\n    return this.in(WeightUnit.Ounce);\n  }\n  get stones(): number {\n    return this.in(WeightUnit.Stone);\n  }\n\n  /** Creates a weight from a value and unit. */\n  static create(value: number | Decimal, unit: WeightUnit): Weight {\n    WeightUnit.index.assertOwns(unit);\n    const amount = value instanceof Decimal ? value : Weight.decimalOf(value);\n    return new Weight(unit.toBase(amount), unit);\n  }\n\n  static fromMicrograms(value: number | Decimal): Weight {\n    return Weight.create(value, WeightUnit.Microgram);\n  }\n  static fromMilligrams(value: number | Decimal): Weight {\n    return Weight.create(value, WeightUnit.Milligram);\n  }\n  static fromGrams(value: number | Decimal): Weight {\n    return Weight.create(value, WeightUnit.Gram);\n  }\n  static fromHectograms(value: number | Decimal): Weight {\n    return Weight.create(value, WeightUnit.Hectogram);\n  }\n  static fromKilograms(value: number | Decimal): Weight {\n    return Weight.create(value, WeightUnit.Kilogram);\n  }\n  static fromMetricTons(value: number | Decimal): Weight {\n    return Weight.create(value, WeightUnit.MetricTon);\n  }\n  static fromPounds(value: number | Decimal): Weight {\n    return Weight.create(value, WeightUnit.Pound);\n  }\n  static fromOunces(value: number | Decimal): Weight {\n    return Weight.create(value, WeightUnit.Ounce);\n  }\n  static fromStones(value: number | Decimal): Weight {\n    return Weight.create(value, WeightUnit.Stone);\n  }\n\n  static tryParse(input: string | null | undefined): Weight | null {\n    const parsed = tryParseQuantity(input, WeightUnit.index);\n    return parsed === null ? null : new Weight(parsed.baseValue, parsed.unit);\n  }\n\n  static parse(input: string): Weight {\n    const result = Weight.tryParse(input);\n    if (result === null) throw new Error(\"Invalid weight.\");\n    return result;\n  }\n\n  static isValid(input: string | null | undefined): boolean {\n    return Weight.tryParse(input) !== null;\n  }\n\n  /** Display form in the parsed unit, or `null` when the input is invalid. */\n  static format(input: string | null | undefined, options?: WeightFormatOptions): string | null {\n    const parsed = Weight.tryParse(input);\n    if (parsed !== null) {\n      if (options?.unit !== undefined || options?.decimals !== undefined) {\n        return parsed.toStringInUnit(options.unit ?? parsed.originalUnit, options.decimals);\n      }\n      return parsed.toString();\n    }\n    return Weight.fallback(input, options);\n  }\n\n  /** The value in kilograms, or `null` when the input is invalid. */\n  static normalize(input: string | null | undefined, options?: WeightFormatOptions): string | null {\n    const parsed = Weight.tryParse(input);\n    if (parsed !== null) return parsed.toNormalizedString();\n    return Weight.fallback(input, options);\n  }\n\n  static isNormalized(input: string | null | undefined): boolean {\n    return input != null && Weight.normalize(input) === input;\n  }\n\n  static findCandidatesInText(text: string): readonly TextCandidate<Weight>[] {\n    if (!text) return [];\n\n    const out: TextCandidate<Weight>[] = [];\n    const pattern = new RegExp(SCAN_PATTERN.source, SCAN_PATTERN.flags);\n    let match: RegExpExecArray | null;\n\n    while ((match = pattern.exec(text)) !== null) {\n      const value = Weight.tryParse(match[0]);\n      if (value === null) continue;\n      out.push(\n        new TextCandidate<Weight>({\n          startIndex: match.index,\n          length: match[0].length,\n          originalText: match[0],\n          typeName: \"Weight\",\n          category: TextCandidateCategory.Measurement,\n          normalizedForm: value.toNormalizedString(),\n          formattedForm: value.toString(),\n          maskedForm: maskWeight(value),\n          confidence: TextMatchConfidence.Medium,\n          value,\n        }),\n      );\n    }\n\n    return out;\n  }\n\n  private static fallback(\n    input: string | null | undefined,\n    options?: WeightFormatOptions,\n  ): string | null {\n    if (options?.fallbackToTrimmedInputWhenInvalid !== true) return null;\n    if (input == null) return null;\n    const trimmed = input.trim();\n    return trimmed.length > 0 ? trimmed : null;\n  }\n\n  private static decimalOf(value: number): Decimal {\n    const parsed = Decimal.fromNumber(value);\n    if (parsed === null) throw new Error(`Value cannot be represented as a weight: ${value}`);\n    return parsed;\n  }\n}\n\n/** Returns a masked weight, e.g. `10 kg` becomes `*** kg`. */\nexport function maskWeight(value: Weight): string {\n  return `*** ${value.originalUnit.symbol}`;\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/cjs/measurement/year-month.js

@@ -0,0 +1,204 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var year_month_exports = {};
+__export(year_month_exports, {
+  YearMonth: () => YearMonth,
+  maskYearMonth: () => maskYearMonth
+});
+module.exports = __toCommonJS(year_month_exports);
+var import_input_sanitization = require("../internal/input-sanitization.js");
+const MIN_YEAR = 1e3;
+const MAX_YEAR = 9999;
+const ISO_LIKE_PATTERN = /^\s*(?<year>\d{4})[-/](?<month>0?[1-9]|1[0-2])(?:[-/](?<day>0?[1-9]|[12]\d|3[01]))?\s*$/u;
+const MONTH_YEAR_NUMERIC_PATTERN = /^\s*(?<month>0?[1-9]|1[0-2])[-/](?<year>\d{4})\s*$/u;
+const MONTH_NAME_YEAR_PATTERN = /^\s*(?<name>[A-Za-zÅÄÖåäö]+\.?)\s+(?<year>\d{4})\s*$/u;
+const YEAR_MONTH_NAME_PATTERN = /^\s*(?<year>\d{4})\s+(?<name>[A-Za-zÅÄÖåäö]+\.?)\s*$/u;
+const MONTH_NAMES = /* @__PURE__ */ new Map([
+  ["januari", 1],
+  ["februari", 2],
+  ["mars", 3],
+  ["april", 4],
+  ["maj", 5],
+  ["juni", 6],
+  ["juli", 7],
+  ["augusti", 8],
+  ["september", 9],
+  ["oktober", 10],
+  ["november", 11],
+  ["december", 12],
+  ["january", 1],
+  ["february", 2],
+  ["march", 3],
+  ["may", 5],
+  ["june", 6],
+  ["july", 7],
+  ["august", 8],
+  ["october", 10],
+  ["jan", 1],
+  ["feb", 2],
+  ["mar", 3],
+  ["apr", 4],
+  ["jun", 6],
+  ["jul", 7],
+  ["aug", 8],
+  ["sep", 9],
+  ["sept", 9],
+  ["okt", 10],
+  ["oct", 10],
+  ["nov", 11],
+  ["dec", 12]
+]);
+class YearMonth {
+  constructor(year, month) {
+    this.year = year;
+    this.month = month;
+  }
+  year;
+  month;
+  static typeInfo = Object.freeze({
+    englishName: "Year-Month",
+    localizedName: "\xC5rsm\xE5nad",
+    emoji: "\u{1F4C5}",
+    sources: Object.freeze(["https://www.iso.org/iso-8601-date-and-time-format.html"])
+  });
+  /** The earliest supported year. */
+  static minYear = MIN_YEAR;
+  /** The latest supported year. */
+  static maxYear = MAX_YEAR;
+  /** Creates a year-month. Throws when either part is out of range. */
+  static create(year, month) {
+    if (!Number.isInteger(year) || year < MIN_YEAR || year > MAX_YEAR) {
+      throw new Error(`Year must be between ${MIN_YEAR} and ${MAX_YEAR}.`);
+    }
+    if (!Number.isInteger(month) || month < 1 || month > 12) {
+      throw new Error("Month must be between 1 and 12.");
+    }
+    return new YearMonth(year, month);
+  }
+  /** Creates a year-month from a date, discarding the day. */
+  static fromDate(date) {
+    return YearMonth.create(date.getFullYear(), date.getMonth() + 1);
+  }
+  static tryParse(input) {
+    if (input == null) return null;
+    const trimmed = (0, import_input_sanitization.sanitizeInput)(input).trim();
+    if (trimmed.length === 0) return null;
+    const iso = ISO_LIKE_PATTERN.exec(trimmed);
+    if (iso?.groups !== void 0) {
+      const day = iso.groups["day"];
+      if (day !== void 0 && !isValidDay(iso.groups["year"], iso.groups["month"], day)) {
+        return null;
+      }
+      return build(iso.groups["year"], iso.groups["month"]);
+    }
+    const monthYear = MONTH_YEAR_NUMERIC_PATTERN.exec(trimmed);
+    if (monthYear?.groups !== void 0) {
+      return build(monthYear.groups["year"], monthYear.groups["month"]);
+    }
+    const nameYear = MONTH_NAME_YEAR_PATTERN.exec(trimmed);
+    if (nameYear?.groups !== void 0) {
+      const month = tryParseMonthName(nameYear.groups["name"]);
+      if (month !== null) return build(nameYear.groups["year"], String(month));
+    }
+    const yearName = YEAR_MONTH_NAME_PATTERN.exec(trimmed);
+    if (yearName?.groups !== void 0) {
+      const month = tryParseMonthName(yearName.groups["name"]);
+      if (month !== null) return build(yearName.groups["year"], String(month));
+    }
+    return null;
+  }
+  static parse(input) {
+    const result = YearMonth.tryParse(input);
+    if (result === null) throw new Error("Invalid year-month.");
+    return result;
+  }
+  static isValid(input) {
+    return YearMonth.tryParse(input) !== null;
+  }
+  /** The canonical ISO 8601 form, e.g. `2026-07`. */
+  static format(input, options) {
+    const parsed = YearMonth.tryParse(input);
+    if (parsed !== null) return parsed.toString();
+    return fallback(input, options);
+  }
+  /** The canonical ISO 8601 form, e.g. `2026-07`. */
+  static normalize(input, options) {
+    const parsed = YearMonth.tryParse(input);
+    if (parsed !== null) return parsed.toNormalizedString();
+    return fallback(input, options);
+  }
+  static isNormalized(input) {
+    return input != null && YearMonth.normalize(input) === input;
+  }
+  toNormalizedString() {
+    return `${String(this.year).padStart(4, "0")}-${String(this.month).padStart(2, "0")}`;
+  }
+  toString() {
+    return this.toNormalizedString();
+  }
+  /** The first day of the month, as a UTC date. */
+  toFirstDayOfMonth() {
+    return new Date(Date.UTC(this.year, this.month - 1, 1));
+  }
+  /** The last day of the month, as a UTC date. */
+  toLastDayOfMonth() {
+    return new Date(Date.UTC(this.year, this.month, 0));
+  }
+  compareTo(other) {
+    if (other == null) return 1;
+    if (this.year !== other.year) return this.year - other.year;
+    return this.month - other.month;
+  }
+  equals(other) {
+    return other != null && this.year === other.year && this.month === other.month;
+  }
+}
+function maskYearMonth(yearMonth) {
+  void yearMonth;
+  return "****-**";
+}
+function build(yearText, monthText) {
+  const year = Number(yearText);
+  const month = Number(monthText);
+  if (year < MIN_YEAR || year > MAX_YEAR) return null;
+  if (month < 1 || month > 12) return null;
+  return YearMonth.create(year, month);
+}
+function isValidDay(yearText, monthText, dayText) {
+  const year = Number(yearText);
+  const month = Number(monthText);
+  const day = Number(dayText);
+  if (year < MIN_YEAR || year > MAX_YEAR) return false;
+  if (month < 1 || month > 12) return false;
+  return day <= daysInMonth(year, month);
+}
+function daysInMonth(year, month) {
+  return new Date(Date.UTC(year, month, 0)).getUTCDate();
+}
+function tryParseMonthName(name) {
+  const key = name.trim().replace(/\.$/u, "").toLowerCase();
+  return MONTH_NAMES.get(key) ?? null;
+}
+function fallback(input, options) {
+  if (options?.fallbackToTrimmedInputWhenInvalid !== true) return null;
+  if (input == null) return null;
+  const trimmed = input.trim();
+  return trimmed.length > 0 ? trimmed : null;
+}
+//# sourceMappingURL=year-month.js.map

package/dist/cjs/measurement/year-month.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/measurement/year-month.ts"],
+  "sourcesContent": ["import { sanitizeInput } from \"../internal/input-sanitization.js\";\nimport type { PrimitiveTypeInfo } from \"../primitive-type-info.js\";\n\n/** Options for {@link YearMonth.format} and {@link YearMonth.normalize}. */\nexport interface YearMonthFormatOptions {\n  fallbackToTrimmedInputWhenInvalid?: boolean;\n}\n\nconst MIN_YEAR = 1000;\nconst MAX_YEAR = 9999;\n\nconst ISO_LIKE_PATTERN =\n  /^\\s*(?<year>\\d{4})[-/](?<month>0?[1-9]|1[0-2])(?:[-/](?<day>0?[1-9]|[12]\\d|3[01]))?\\s*$/u;\nconst MONTH_YEAR_NUMERIC_PATTERN = /^\\s*(?<month>0?[1-9]|1[0-2])[-/](?<year>\\d{4})\\s*$/u;\nconst MONTH_NAME_YEAR_PATTERN = /^\\s*(?<name>[A-Za-z\u00C5\u00C4\u00D6\u00E5\u00E4\u00F6]+\\.?)\\s+(?<year>\\d{4})\\s*$/u;\nconst YEAR_MONTH_NAME_PATTERN = /^\\s*(?<year>\\d{4})\\s+(?<name>[A-Za-z\u00C5\u00C4\u00D6\u00E5\u00E4\u00F6]+\\.?)\\s*$/u;\n\nconst MONTH_NAMES = new Map<string, number>([\n  [\"januari\", 1],\n  [\"februari\", 2],\n  [\"mars\", 3],\n  [\"april\", 4],\n  [\"maj\", 5],\n  [\"juni\", 6],\n  [\"juli\", 7],\n  [\"augusti\", 8],\n  [\"september\", 9],\n  [\"oktober\", 10],\n  [\"november\", 11],\n  [\"december\", 12],\n  [\"january\", 1],\n  [\"february\", 2],\n  [\"march\", 3],\n  [\"may\", 5],\n  [\"june\", 6],\n  [\"july\", 7],\n  [\"august\", 8],\n  [\"october\", 10],\n  [\"jan\", 1],\n  [\"feb\", 2],\n  [\"mar\", 3],\n  [\"apr\", 4],\n  [\"jun\", 6],\n  [\"jul\", 7],\n  [\"aug\", 8],\n  [\"sep\", 9],\n  [\"sept\", 9],\n  [\"okt\", 10],\n  [\"oct\", 10],\n  [\"nov\", 11],\n  [\"dec\", 12],\n]);\n\n/**\n * A calendar month, held as a year from 1000 to 9999 and a month from 1 to 12.\n *\n * Accepts ISO 8601 (`2026-07`), a full ISO date read at month precision\n * (`2026-07-01`), slash-separated forms (`2026/07`, `07/2026`), and Swedish or\n * English month names (`juli 2026`, `Jul 2026`, `2026 July`).\n *\n * Sources:\n * - https://www.iso.org/iso-8601-date-and-time-format.html\n */\nexport class YearMonth {\n  static readonly typeInfo: PrimitiveTypeInfo = Object.freeze({\n    englishName: \"Year-Month\",\n    localizedName: \"\u00C5rsm\u00E5nad\",\n    emoji: \"\uD83D\uDCC5\",\n    sources: Object.freeze([\"https://www.iso.org/iso-8601-date-and-time-format.html\"]),\n  });\n\n  /** The earliest supported year. */\n  static readonly minYear = MIN_YEAR;\n\n  /** The latest supported year. */\n  static readonly maxYear = MAX_YEAR;\n\n  private constructor(\n    /** The calendar year, e.g. `2026`. */\n    readonly year: number,\n    /** The calendar month, from 1 to 12. */\n    readonly month: number,\n  ) {}\n\n  /** Creates a year-month. Throws when either part is out of range. */\n  static create(year: number, month: number): YearMonth {\n    if (!Number.isInteger(year) || year < MIN_YEAR || year > MAX_YEAR) {\n      throw new Error(`Year must be between ${MIN_YEAR} and ${MAX_YEAR}.`);\n    }\n    if (!Number.isInteger(month) || month < 1 || month > 12) {\n      throw new Error(\"Month must be between 1 and 12.\");\n    }\n    return new YearMonth(year, month);\n  }\n\n  /** Creates a year-month from a date, discarding the day. */\n  static fromDate(date: Date): YearMonth {\n    return YearMonth.create(date.getFullYear(), date.getMonth() + 1);\n  }\n\n  static tryParse(input: string | null | undefined): YearMonth | null {\n    if (input == null) return null;\n\n    const trimmed = sanitizeInput(input).trim();\n    if (trimmed.length === 0) return null;\n\n    const iso = ISO_LIKE_PATTERN.exec(trimmed);\n    if (iso?.groups !== undefined) {\n      const day = iso.groups[\"day\"];\n      if (day !== undefined && !isValidDay(iso.groups[\"year\"]!, iso.groups[\"month\"]!, day)) {\n        return null;\n      }\n      return build(iso.groups[\"year\"]!, iso.groups[\"month\"]!);\n    }\n\n    const monthYear = MONTH_YEAR_NUMERIC_PATTERN.exec(trimmed);\n    if (monthYear?.groups !== undefined) {\n      return build(monthYear.groups[\"year\"]!, monthYear.groups[\"month\"]!);\n    }\n\n    const nameYear = MONTH_NAME_YEAR_PATTERN.exec(trimmed);\n    if (nameYear?.groups !== undefined) {\n      const month = tryParseMonthName(nameYear.groups[\"name\"]!);\n      if (month !== null) return build(nameYear.groups[\"year\"]!, String(month));\n    }\n\n    const yearName = YEAR_MONTH_NAME_PATTERN.exec(trimmed);\n    if (yearName?.groups !== undefined) {\n      const month = tryParseMonthName(yearName.groups[\"name\"]!);\n      if (month !== null) return build(yearName.groups[\"year\"]!, String(month));\n    }\n\n    return null;\n  }\n\n  static parse(input: string): YearMonth {\n    const result = YearMonth.tryParse(input);\n    if (result === null) throw new Error(\"Invalid year-month.\");\n    return result;\n  }\n\n  static isValid(input: string | null | undefined): boolean {\n    return YearMonth.tryParse(input) !== null;\n  }\n\n  /** The canonical ISO 8601 form, e.g. `2026-07`. */\n  static format(input: string | null | undefined, options?: YearMonthFormatOptions): string | null {\n    const parsed = YearMonth.tryParse(input);\n    if (parsed !== null) return parsed.toString();\n    return fallback(input, options);\n  }\n\n  /** The canonical ISO 8601 form, e.g. `2026-07`. */\n  static normalize(\n    input: string | null | undefined,\n    options?: YearMonthFormatOptions,\n  ): string | null {\n    const parsed = YearMonth.tryParse(input);\n    if (parsed !== null) return parsed.toNormalizedString();\n    return fallback(input, options);\n  }\n\n  static isNormalized(input: string | null | undefined): boolean {\n    return input != null && YearMonth.normalize(input) === input;\n  }\n\n  toNormalizedString(): string {\n    return `${String(this.year).padStart(4, \"0\")}-${String(this.month).padStart(2, \"0\")}`;\n  }\n\n  toString(): string {\n    return this.toNormalizedString();\n  }\n\n  /** The first day of the month, as a UTC date. */\n  toFirstDayOfMonth(): Date {\n    return new Date(Date.UTC(this.year, this.month - 1, 1));\n  }\n\n  /** The last day of the month, as a UTC date. */\n  toLastDayOfMonth(): Date {\n    return new Date(Date.UTC(this.year, this.month, 0));\n  }\n\n  compareTo(other: YearMonth | null | undefined): number {\n    if (other == null) return 1;\n    if (this.year !== other.year) return this.year - other.year;\n    return this.month - other.month;\n  }\n\n  equals(other: YearMonth | null | undefined): boolean {\n    return other != null && this.year === other.year && this.month === other.month;\n  }\n}\n\n/** Returns a masked year-month, e.g. `2026-07` becomes `****-**`. */\nexport function maskYearMonth(yearMonth: YearMonth): string {\n  void yearMonth;\n  return \"****-**\";\n}\n\nfunction build(yearText: string, monthText: string): YearMonth | null {\n  const year = Number(yearText);\n  const month = Number(monthText);\n  if (year < MIN_YEAR || year > MAX_YEAR) return null;\n  if (month < 1 || month > 12) return null;\n  return YearMonth.create(year, month);\n}\n\nfunction isValidDay(yearText: string, monthText: string, dayText: string): boolean {\n  const year = Number(yearText);\n  const month = Number(monthText);\n  const day = Number(dayText);\n  if (year < MIN_YEAR || year > MAX_YEAR) return false;\n  if (month < 1 || month > 12) return false;\n  return day <= daysInMonth(year, month);\n}\n\nfunction daysInMonth(year: number, month: number): number {\n  return new Date(Date.UTC(year, month, 0)).getUTCDate();\n}\n\nfunction tryParseMonthName(name: string): number | null {\n  const key = name.trim().replace(/\\.$/u, \"\").toLowerCase();\n  return MONTH_NAMES.get(key) ?? null;\n}\n\nfunction fallback(\n  input: string | null | undefined,\n  options?: YearMonthFormatOptions,\n): string | null {\n  if (options?.fallbackToTrimmedInputWhenInvalid !== true) return null;\n  if (input == null) return null;\n  const trimmed = input.trim();\n  return trimmed.length > 0 ? trimmed : null;\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,gCAA8B;AAQ9B,MAAM,WAAW;AACjB,MAAM,WAAW;AAEjB,MAAM,mBACJ;AACF,MAAM,6BAA6B;AACnC,MAAM,0BAA0B;AAChC,MAAM,0BAA0B;AAEhC,MAAM,cAAc,oBAAI,IAAoB;AAAA,EAC1C,CAAC,WAAW,CAAC;AAAA,EACb,CAAC,YAAY,CAAC;AAAA,EACd,CAAC,QAAQ,CAAC;AAAA,EACV,CAAC,SAAS,CAAC;AAAA,EACX,CAAC,OAAO,CAAC;AAAA,EACT,CAAC,QAAQ,CAAC;AAAA,EACV,CAAC,QAAQ,CAAC;AAAA,EACV,CAAC,WAAW,CAAC;AAAA,EACb,CAAC,aAAa,CAAC;AAAA,EACf,CAAC,WAAW,EAAE;AAAA,EACd,CAAC,YAAY,EAAE;AAAA,EACf,CAAC,YAAY,EAAE;AAAA,EACf,CAAC,WAAW,CAAC;AAAA,EACb,CAAC,YAAY,CAAC;AAAA,EACd,CAAC,SAAS,CAAC;AAAA,EACX,CAAC,OAAO,CAAC;AAAA,EACT,CAAC,QAAQ,CAAC;AAAA,EACV,CAAC,QAAQ,CAAC;AAAA,EACV,CAAC,UAAU,CAAC;AAAA,EACZ,CAAC,WAAW,EAAE;AAAA,EACd,CAAC,OAAO,CAAC;AAAA,EACT,CAAC,OAAO,CAAC;AAAA,EACT,CAAC,OAAO,CAAC;AAAA,EACT,CAAC,OAAO,CAAC;AAAA,EACT,CAAC,OAAO,CAAC;AAAA,EACT,CAAC,OAAO,CAAC;AAAA,EACT,CAAC,OAAO,CAAC;AAAA,EACT,CAAC,OAAO,CAAC;AAAA,EACT,CAAC,QAAQ,CAAC;AAAA,EACV,CAAC,OAAO,EAAE;AAAA,EACV,CAAC,OAAO,EAAE;AAAA,EACV,CAAC,OAAO,EAAE;AAAA,EACV,CAAC,OAAO,EAAE;AACZ,CAAC;AAYM,MAAM,UAAU;AAAA,EAcb,YAEG,MAEA,OACT;AAHS;AAEA;AAAA,EACR;AAAA,EAHQ;AAAA,EAEA;AAAA,EAjBX,OAAgB,WAA8B,OAAO,OAAO;AAAA,IAC1D,aAAa;AAAA,IACb,eAAe;AAAA,IACf,OAAO;AAAA,IACP,SAAS,OAAO,OAAO,CAAC,wDAAwD,CAAC;AAAA,EACnF,CAAC;AAAA;AAAA,EAGD,OAAgB,UAAU;AAAA;AAAA,EAG1B,OAAgB,UAAU;AAAA;AAAA,EAU1B,OAAO,OAAO,MAAc,OAA0B;AACpD,QAAI,CAAC,OAAO,UAAU,IAAI,KAAK,OAAO,YAAY,OAAO,UAAU;AACjE,YAAM,IAAI,MAAM,wBAAwB,QAAQ,QAAQ,QAAQ,GAAG;AAAA,IACrE;AACA,QAAI,CAAC,OAAO,UAAU,KAAK,KAAK,QAAQ,KAAK,QAAQ,IAAI;AACvD,YAAM,IAAI,MAAM,iCAAiC;AAAA,IACnD;AACA,WAAO,IAAI,UAAU,MAAM,KAAK;AAAA,EAClC;AAAA;AAAA,EAGA,OAAO,SAAS,MAAuB;AACrC,WAAO,UAAU,OAAO,KAAK,YAAY,GAAG,KAAK,SAAS,IAAI,CAAC;AAAA,EACjE;AAAA,EAEA,OAAO,SAAS,OAAoD;AAClE,QAAI,SAAS,KAAM,QAAO;AAE1B,UAAM,cAAU,yCAAc,KAAK,EAAE,KAAK;AAC1C,QAAI,QAAQ,WAAW,EAAG,QAAO;AAEjC,UAAM,MAAM,iBAAiB,KAAK,OAAO;AACzC,QAAI,KAAK,WAAW,QAAW;AAC7B,YAAM,MAAM,IAAI,OAAO,KAAK;AAC5B,UAAI,QAAQ,UAAa,CAAC,WAAW,IAAI,OAAO,MAAM,GAAI,IAAI,OAAO,OAAO,GAAI,GAAG,GAAG;AACpF,eAAO;AAAA,MACT;AACA,aAAO,MAAM,IAAI,OAAO,MAAM,GAAI,IAAI,OAAO,OAAO,CAAE;AAAA,IACxD;AAEA,UAAM,YAAY,2BAA2B,KAAK,OAAO;AACzD,QAAI,WAAW,WAAW,QAAW;AACnC,aAAO,MAAM,UAAU,OAAO,MAAM,GAAI,UAAU,OAAO,OAAO,CAAE;AAAA,IACpE;AAEA,UAAM,WAAW,wBAAwB,KAAK,OAAO;AACrD,QAAI,UAAU,WAAW,QAAW;AAClC,YAAM,QAAQ,kBAAkB,SAAS,OAAO,MAAM,CAAE;AACxD,UAAI,UAAU,KAAM,QAAO,MAAM,SAAS,OAAO,MAAM,GAAI,OAAO,KAAK,CAAC;AAAA,IAC1E;AAEA,UAAM,WAAW,wBAAwB,KAAK,OAAO;AACrD,QAAI,UAAU,WAAW,QAAW;AAClC,YAAM,QAAQ,kBAAkB,SAAS,OAAO,MAAM,CAAE;AACxD,UAAI,UAAU,KAAM,QAAO,MAAM,SAAS,OAAO,MAAM,GAAI,OAAO,KAAK,CAAC;AAAA,IAC1E;AAEA,WAAO;AAAA,EACT;AAAA,EAEA,OAAO,MAAM,OAA0B;AACrC,UAAM,SAAS,UAAU,SAAS,KAAK;AACvC,QAAI,WAAW,KAAM,OAAM,IAAI,MAAM,qBAAqB;AAC1D,WAAO;AAAA,EACT;AAAA,EAEA,OAAO,QAAQ,OAA2C;AACxD,WAAO,UAAU,SAAS,KAAK,MAAM;AAAA,EACvC;AAAA;AAAA,EAGA,OAAO,OAAO,OAAkC,SAAiD;AAC/F,UAAM,SAAS,UAAU,SAAS,KAAK;AACvC,QAAI,WAAW,KAAM,QAAO,OAAO,SAAS;AAC5C,WAAO,SAAS,OAAO,OAAO;AAAA,EAChC;AAAA;AAAA,EAGA,OAAO,UACL,OACA,SACe;AACf,UAAM,SAAS,UAAU,SAAS,KAAK;AACvC,QAAI,WAAW,KAAM,QAAO,OAAO,mBAAmB;AACtD,WAAO,SAAS,OAAO,OAAO;AAAA,EAChC;AAAA,EAEA,OAAO,aAAa,OAA2C;AAC7D,WAAO,SAAS,QAAQ,UAAU,UAAU,KAAK,MAAM;AAAA,EACzD;AAAA,EAEA,qBAA6B;AAC3B,WAAO,GAAG,OAAO,KAAK,IAAI,EAAE,SAAS,GAAG,GAAG,CAAC,IAAI,OAAO,KAAK,KAAK,EAAE,SAAS,GAAG,GAAG,CAAC;AAAA,EACrF;AAAA,EAEA,WAAmB;AACjB,WAAO,KAAK,mBAAmB;AAAA,EACjC;AAAA;AAAA,EAGA,oBAA0B;AACxB,WAAO,IAAI,KAAK,KAAK,IAAI,KAAK,MAAM,KAAK,QAAQ,GAAG,CAAC,CAAC;AAAA,EACxD;AAAA;AAAA,EAGA,mBAAyB;AACvB,WAAO,IAAI,KAAK,KAAK,IAAI,KAAK,MAAM,KAAK,OAAO,CAAC,CAAC;AAAA,EACpD;AAAA,EAEA,UAAU,OAA6C;AACrD,QAAI,SAAS,KAAM,QAAO;AAC1B,QAAI,KAAK,SAAS,MAAM,KAAM,QAAO,KAAK,OAAO,MAAM;AACvD,WAAO,KAAK,QAAQ,MAAM;AAAA,EAC5B;AAAA,EAEA,OAAO,OAA8C;AACnD,WAAO,SAAS,QAAQ,KAAK,SAAS,MAAM,QAAQ,KAAK,UAAU,MAAM;AAAA,EAC3E;AACF;AAGO,SAAS,cAAc,WAA8B;AAC1D,OAAK;AACL,SAAO;AACT;AAEA,SAAS,MAAM,UAAkB,WAAqC;AACpE,QAAM,OAAO,OAAO,QAAQ;AAC5B,QAAM,QAAQ,OAAO,SAAS;AAC9B,MAAI,OAAO,YAAY,OAAO,SAAU,QAAO;AAC/C,MAAI,QAAQ,KAAK,QAAQ,GAAI,QAAO;AACpC,SAAO,UAAU,OAAO,MAAM,KAAK;AACrC;AAEA,SAAS,WAAW,UAAkB,WAAmB,SAA0B;AACjF,QAAM,OAAO,OAAO,QAAQ;AAC5B,QAAM,QAAQ,OAAO,SAAS;AAC9B,QAAM,MAAM,OAAO,OAAO;AAC1B,MAAI,OAAO,YAAY,OAAO,SAAU,QAAO;AAC/C,MAAI,QAAQ,KAAK,QAAQ,GAAI,QAAO;AACpC,SAAO,OAAO,YAAY,MAAM,KAAK;AACvC;AAEA,SAAS,YAAY,MAAc,OAAuB;AACxD,SAAO,IAAI,KAAK,KAAK,IAAI,MAAM,OAAO,CAAC,CAAC,EAAE,WAAW;AACvD;AAEA,SAAS,kBAAkB,MAA6B;AACtD,QAAM,MAAM,KAAK,KAAK,EAAE,QAAQ,QAAQ,EAAE,EAAE,YAAY;AACxD,SAAO,YAAY,IAAI,GAAG,KAAK;AACjC;AAEA,SAAS,SACP,OACA,SACe;AACf,MAAI,SAAS,sCAAsC,KAAM,QAAO;AAChE,MAAI,SAAS,KAAM,QAAO;AAC1B,QAAM,UAAU,MAAM,KAAK;AAC3B,SAAO,QAAQ,SAAS,IAAI,UAAU;AACxC;",
+  "names": []
+}