@budiauktioner/buildi-primitives 0.1.1 → 0.2.1

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

@@ -0,0 +1,110 @@
+"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 luminance_unit_exports = {};
+__export(luminance_unit_exports, {
+  LuminanceUnit: () => LuminanceUnit
+});
+module.exports = __toCommonJS(luminance_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 LuminanceUnit extends import_measurement_unit.MeasurementUnit {
+  static typeInfo = Object.freeze({
+    englishName: "Luminance Unit",
+    localizedName: "Luminansenhet",
+    emoji: "\u{1F506}",
+    sources: Object.freeze([])
+  });
+  static CandelaPerSquareMetre = new LuminanceUnit({
+    symbol: "cd/m\xB2",
+    englishName: "candela per square metre",
+    localizedName: "candela per kvadratmeter",
+    pluralEnglish: "candela per square metre",
+    pluralSwedish: "candela per kvadratmeter",
+    toBaseUnitFactor: factor("1"),
+    aliases: ["cd/m2", "cd m-2", "cd*m-2", "cd/sqm", "cdm2", "cd/m\xB2", "Cd/m\xB2", "Cd/m2"]
+  });
+  static Nit = new LuminanceUnit({
+    symbol: "nit",
+    englishName: "nit",
+    localizedName: "nit",
+    pluralEnglish: "nits",
+    pluralSwedish: "nit",
+    toBaseUnitFactor: factor("1"),
+    aliases: ["Nit", "NITS", "nits"]
+  });
+  static KilocandelaPerSquareMetre = new LuminanceUnit({
+    symbol: "kcd/m\xB2",
+    englishName: "kilocandela per square metre",
+    localizedName: "kilocandela per kvadratmeter",
+    pluralEnglish: "kilocandela per square metre",
+    pluralSwedish: "kilocandela per kvadratmeter",
+    toBaseUnitFactor: factor("1000"),
+    aliases: ["kcd/m2", "kcdm2", "Kcd/m\xB2", "Kcd/m2"]
+  });
+  static Kilonit = new LuminanceUnit({
+    symbol: "knit",
+    englishName: "kilonit",
+    localizedName: "kilonit",
+    pluralEnglish: "kilonits",
+    pluralSwedish: "kilonit",
+    toBaseUnitFactor: factor("1000"),
+    aliases: ["Knit", "KNIT", "kilonits"]
+  });
+  /** @internal Shared lookup and natural-scale walk. */
+  static index = new import_measurement_unit.MeasurementUnitIndex(
+    [
+      LuminanceUnit.CandelaPerSquareMetre,
+      LuminanceUnit.Nit,
+      LuminanceUnit.KilocandelaPerSquareMetre,
+      LuminanceUnit.Kilonit
+    ],
+    LuminanceUnit.CandelaPerSquareMetre,
+    [LuminanceUnit.CandelaPerSquareMetre, LuminanceUnit.KilocandelaPerSquareMetre]
+  );
+  static get all() {
+    return LuminanceUnit.index.all;
+  }
+  /** The base unit: cd/m². */
+  static get baseUnit() {
+    return LuminanceUnit.index.baseUnit;
+  }
+  /** Units ordered small to large, used to auto-scale display. */
+  static get naturalScale() {
+    return LuminanceUnit.index.naturalScale;
+  }
+  /** Resolves a unit from a symbol, name, plural or alias, case-insensitively. */
+  static tryParse(input) {
+    return LuminanceUnit.index.tryParse(input);
+  }
+  static parse(input) {
+    const result = LuminanceUnit.tryParse(input);
+    if (result === null) throw new Error("Unknown luminance unit.");
+    return result;
+  }
+  /** Returns the most human-readable unit for a value in cd/m². */
+  static getNatural(baseValue) {
+    return LuminanceUnit.index.getNatural(baseValue);
+  }
+}
+//# sourceMappingURL=luminance-unit.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/measurement/luminance-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 luminance 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 LuminanceUnit extends MeasurementUnit {\n  declare private readonly __luminanceUnitBrand: void;\n\n  static readonly typeInfo: PrimitiveTypeInfo = Object.freeze({\n    englishName: \"Luminance Unit\",\n    localizedName: \"Luminansenhet\",\n    emoji: \"\uD83D\uDD06\",\n    sources: Object.freeze([]),\n  });\n\n  static readonly CandelaPerSquareMetre = new LuminanceUnit({\n    symbol: \"cd/m\u00B2\",\n    englishName: \"candela per square metre\",\n    localizedName: \"candela per kvadratmeter\",\n    pluralEnglish: \"candela per square metre\",\n    pluralSwedish: \"candela per kvadratmeter\",\n    toBaseUnitFactor: factor(\"1\"),\n    aliases: [\"cd/m2\", \"cd m-2\", \"cd*m-2\", \"cd/sqm\", \"cdm2\", \"cd/m\u00B2\", \"Cd/m\u00B2\", \"Cd/m2\"],\n  });\n\n  static readonly Nit = new LuminanceUnit({\n    symbol: \"nit\",\n    englishName: \"nit\",\n    localizedName: \"nit\",\n    pluralEnglish: \"nits\",\n    pluralSwedish: \"nit\",\n    toBaseUnitFactor: factor(\"1\"),\n    aliases: [\"Nit\", \"NITS\", \"nits\"],\n  });\n\n  static readonly KilocandelaPerSquareMetre = new LuminanceUnit({\n    symbol: \"kcd/m\u00B2\",\n    englishName: \"kilocandela per square metre\",\n    localizedName: \"kilocandela per kvadratmeter\",\n    pluralEnglish: \"kilocandela per square metre\",\n    pluralSwedish: \"kilocandela per kvadratmeter\",\n    toBaseUnitFactor: factor(\"1000\"),\n    aliases: [\"kcd/m2\", \"kcdm2\", \"Kcd/m\u00B2\", \"Kcd/m2\"],\n  });\n\n  static readonly Kilonit = new LuminanceUnit({\n    symbol: \"knit\",\n    englishName: \"kilonit\",\n    localizedName: \"kilonit\",\n    pluralEnglish: \"kilonits\",\n    pluralSwedish: \"kilonit\",\n    toBaseUnitFactor: factor(\"1000\"),\n    aliases: [\"Knit\", \"KNIT\", \"kilonits\"],\n  });\n\n  /** @internal Shared lookup and natural-scale walk. */\n  static readonly index: MeasurementUnitIndex<LuminanceUnit> =\n    new MeasurementUnitIndex<LuminanceUnit>(\n      [\n        LuminanceUnit.CandelaPerSquareMetre,\n        LuminanceUnit.Nit,\n        LuminanceUnit.KilocandelaPerSquareMetre,\n        LuminanceUnit.Kilonit,\n      ],\n      LuminanceUnit.CandelaPerSquareMetre,\n      [LuminanceUnit.CandelaPerSquareMetre, LuminanceUnit.KilocandelaPerSquareMetre],\n    );\n\n  static get all(): readonly LuminanceUnit[] {\n    return LuminanceUnit.index.all;\n  }\n\n  /** The base unit: cd/m\u00B2. */\n  static get baseUnit(): LuminanceUnit {\n    return LuminanceUnit.index.baseUnit;\n  }\n\n  /** Units ordered small to large, used to auto-scale display. */\n  static get naturalScale(): readonly LuminanceUnit[] {\n    return LuminanceUnit.index.naturalScale;\n  }\n\n  /** Resolves a unit from a symbol, name, plural or alias, case-insensitively. */\n  static tryParse(input: string | null | undefined): LuminanceUnit | null {\n    return LuminanceUnit.index.tryParse(input);\n  }\n\n  static parse(input: string): LuminanceUnit {\n    const result = LuminanceUnit.tryParse(input);\n    if (result === null) throw new Error(\"Unknown luminance unit.\");\n    return result;\n  }\n\n  /** Returns the most human-readable unit for a value in cd/m\u00B2. */\n  static getNatural(baseValue: Decimal): LuminanceUnit {\n    return LuminanceUnit.index.getNatural(baseValue);\n  }\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,qBAAwB;AACxB,8BAAsD;AAGtD,SAAS,OAAO,SAA0B;AACxC,QAAM,SAAS,uBAAQ,MAAM,OAAO;AAEpC,MAAI,WAAW,KAAM,OAAM,IAAI,MAAM,8BAA8B,OAAO,EAAE;AAC5E,SAAO;AACT;AAOO,MAAM,sBAAsB,wCAAgB;AAAA,EAGjD,OAAgB,WAA8B,OAAO,OAAO;AAAA,IAC1D,aAAa;AAAA,IACb,eAAe;AAAA,IACf,OAAO;AAAA,IACP,SAAS,OAAO,OAAO,CAAC,CAAC;AAAA,EAC3B,CAAC;AAAA,EAED,OAAgB,wBAAwB,IAAI,cAAc;AAAA,IACxD,QAAQ;AAAA,IACR,aAAa;AAAA,IACb,eAAe;AAAA,IACf,eAAe;AAAA,IACf,eAAe;AAAA,IACf,kBAAkB,OAAO,GAAG;AAAA,IAC5B,SAAS,CAAC,SAAS,UAAU,UAAU,UAAU,QAAQ,YAAS,YAAS,OAAO;AAAA,EACpF,CAAC;AAAA,EAED,OAAgB,MAAM,IAAI,cAAc;AAAA,IACtC,QAAQ;AAAA,IACR,aAAa;AAAA,IACb,eAAe;AAAA,IACf,eAAe;AAAA,IACf,eAAe;AAAA,IACf,kBAAkB,OAAO,GAAG;AAAA,IAC5B,SAAS,CAAC,OAAO,QAAQ,MAAM;AAAA,EACjC,CAAC;AAAA,EAED,OAAgB,4BAA4B,IAAI,cAAc;AAAA,IAC5D,QAAQ;AAAA,IACR,aAAa;AAAA,IACb,eAAe;AAAA,IACf,eAAe;AAAA,IACf,eAAe;AAAA,IACf,kBAAkB,OAAO,MAAM;AAAA,IAC/B,SAAS,CAAC,UAAU,SAAS,aAAU,QAAQ;AAAA,EACjD,CAAC;AAAA,EAED,OAAgB,UAAU,IAAI,cAAc;AAAA,IAC1C,QAAQ;AAAA,IACR,aAAa;AAAA,IACb,eAAe;AAAA,IACf,eAAe;AAAA,IACf,eAAe;AAAA,IACf,kBAAkB,OAAO,MAAM;AAAA,IAC/B,SAAS,CAAC,QAAQ,QAAQ,UAAU;AAAA,EACtC,CAAC;AAAA;AAAA,EAGD,OAAgB,QACd,IAAI;AAAA,IACF;AAAA,MACE,cAAc;AAAA,MACd,cAAc;AAAA,MACd,cAAc;AAAA,MACd,cAAc;AAAA,IAChB;AAAA,IACA,cAAc;AAAA,IACd,CAAC,cAAc,uBAAuB,cAAc,yBAAyB;AAAA,EAC/E;AAAA,EAEF,WAAW,MAAgC;AACzC,WAAO,cAAc,MAAM;AAAA,EAC7B;AAAA;AAAA,EAGA,WAAW,WAA0B;AACnC,WAAO,cAAc,MAAM;AAAA,EAC7B;AAAA;AAAA,EAGA,WAAW,eAAyC;AAClD,WAAO,cAAc,MAAM;AAAA,EAC7B;AAAA;AAAA,EAGA,OAAO,SAAS,OAAwD;AACtE,WAAO,cAAc,MAAM,SAAS,KAAK;AAAA,EAC3C;AAAA,EAEA,OAAO,MAAM,OAA8B;AACzC,UAAM,SAAS,cAAc,SAAS,KAAK;AAC3C,QAAI,WAAW,KAAM,OAAM,IAAI,MAAM,yBAAyB;AAC9D,WAAO;AAAA,EACT;AAAA;AAAA,EAGA,OAAO,WAAW,WAAmC;AACnD,WAAO,cAAc,MAAM,WAAW,SAAS;AAAA,EACjD;AACF;",
+  "names": []
+}

package/dist/cjs/measurement/luminance.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 luminance_exports = {};
+__export(luminance_exports, {
+  Luminance: () => Luminance,
+  maskLuminance: () => maskLuminance
+});
+module.exports = __toCommonJS(luminance_exports);
+var import_decimal = require("../internal/decimal.js");
+var import_measurement_unit_parser = require("../internal/measurement-unit-parser.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_luminance_unit = require("./luminance-unit.js");
+const SCAN_PATTERN = new RegExp(
+  String.raw`(?<![\p{L}\p{N}_])(?:[+-]\s*)?\d+[0-9 .,]*\s*(?:kcd/m²|kcd/m2|cd/m²|cd/m2|knits?|nits?)(?![\p{L}\p{N}_])`,
+  "giu"
+);
+class Luminance extends import_quantity.Quantity {
+  static typeInfo = Object.freeze({
+    englishName: "Luminance",
+    localizedName: "Luminans",
+    emoji: "\u{1F506}",
+    sources: Object.freeze([
+      "https://www.bipm.org/en/measurement-units/si-derived-units",
+      "https://en.wikipedia.org/wiki/Luminance",
+      "https://en.wikipedia.org/wiki/Candela_per_square_metre"
+    ])
+  });
+  get units() {
+    return import_luminance_unit.LuminanceUnit.index;
+  }
+  withBaseValue(baseValue, unit) {
+    return new Luminance(baseValue, unit);
+  }
+  get candelaPerSquareMetre() {
+    return this.in(import_luminance_unit.LuminanceUnit.CandelaPerSquareMetre);
+  }
+  get nits() {
+    return this.in(import_luminance_unit.LuminanceUnit.Nit);
+  }
+  get kilocandelaPerSquareMetre() {
+    return this.in(import_luminance_unit.LuminanceUnit.KilocandelaPerSquareMetre);
+  }
+  /** Creates a luminance from a value and unit. */
+  static create(value, unit) {
+    import_luminance_unit.LuminanceUnit.index.assertOwns(unit);
+    const amount = value instanceof import_decimal.Decimal ? value : Luminance.decimalOf(value);
+    return new Luminance(unit.toBase(amount), unit);
+  }
+  static fromCandelaPerSquareMetre(value) {
+    return Luminance.create(value, import_luminance_unit.LuminanceUnit.CandelaPerSquareMetre);
+  }
+  static fromNits(value) {
+    return Luminance.create(value, import_luminance_unit.LuminanceUnit.Nit);
+  }
+  static fromKilocandelaPerSquareMetre(value) {
+    return Luminance.create(value, import_luminance_unit.LuminanceUnit.KilocandelaPerSquareMetre);
+  }
+  /**
+   * A bare number is read as candela per square metre, since screen brightness
+   * is quoted that way. Negative luminance is rejected.
+   */
+  static tryParse(input) {
+    const bare = (0, import_measurement_unit_parser.tryParseNumberOnly)(input);
+    if (bare !== null) {
+      if (bare.isNegative) return null;
+      return new Luminance(bare, import_luminance_unit.LuminanceUnit.CandelaPerSquareMetre);
+    }
+    const parsed = (0, import_quantity.tryParseQuantity)(input, import_luminance_unit.LuminanceUnit.index);
+    return parsed === null ? null : new Luminance(parsed.baseValue, parsed.unit);
+  }
+  static parse(input) {
+    const result = Luminance.tryParse(input);
+    if (result === null) throw new Error("Invalid luminance.");
+    return result;
+  }
+  static isValid(input) {
+    return Luminance.tryParse(input) !== null;
+  }
+  /** Display form in the parsed unit, or `null` when the input is invalid. */
+  static format(input, options) {
+    const parsed = Luminance.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 Luminance.fallback(input, options);
+  }
+  /** The value in candela per square metre, or `null` when the input is invalid. */
+  static normalize(input, options) {
+    const parsed = Luminance.tryParse(input);
+    if (parsed !== null) return parsed.toNormalizedString();
+    return Luminance.fallback(input, options);
+  }
+  static isNormalized(input) {
+    return input != null && Luminance.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 = Luminance.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: "Luminance",
+          category: import_text_candidate_category.TextCandidateCategory.Measurement,
+          normalizedForm: value.toNormalizedString(),
+          formattedForm: value.toString(),
+          maskedForm: maskLuminance(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 luminance: ${value}`);
+    return parsed;
+  }
+}
+function maskLuminance(value) {
+  return `*** ${value.originalUnit.symbol}`;
+}
+//# sourceMappingURL=luminance.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/measurement/luminance.ts"],
+  "sourcesContent": ["import { Decimal } from \"../internal/decimal.js\";\nimport type { MeasurementUnitIndex } from \"../internal/measurement-unit.js\";\nimport { tryParseNumberOnly } from \"../internal/measurement-unit-parser.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 { LuminanceUnit } from \"./luminance-unit.js\";\n\n/** Options for {@link Luminance.format} and {@link Luminance.normalize}. */\nexport interface LuminanceFormatOptions {\n  fallbackToTrimmedInputWhenInvalid?: boolean;\n  /** Convert to this unit instead of preserving the parsed one. */\n  unit?: LuminanceUnit;\n  /** Round to this many fractional digits, away from zero. */\n  decimals?: number;\n}\n\nconst SCAN_PATTERN = new RegExp(\n  String.raw`(?<![\\p{L}\\p{N}_])(?:[+-]\\s*)?\\d+[0-9 .,]*\\s*(?:kcd/m\u00B2|kcd/m2|cd/m\u00B2|cd/m2|knits?|nits?)(?![\\p{L}\\p{N}_])`,\n  \"giu\",\n);\n\n/**\n * A luminance stored internally in candela per square metre,\n * parsed from any supported unit and convertible between all of them.\n */\nexport class Luminance extends Quantity<LuminanceUnit> {\n  static readonly typeInfo: PrimitiveTypeInfo = Object.freeze({\n    englishName: \"Luminance\",\n    localizedName: \"Luminans\",\n    emoji: \"\uD83D\uDD06\",\n    sources: Object.freeze([\n      \"https://www.bipm.org/en/measurement-units/si-derived-units\",\n      \"https://en.wikipedia.org/wiki/Luminance\",\n      \"https://en.wikipedia.org/wiki/Candela_per_square_metre\",\n    ]),\n  });\n\n  protected get units(): MeasurementUnitIndex<LuminanceUnit> {\n    return LuminanceUnit.index;\n  }\n\n  protected withBaseValue(baseValue: Decimal, unit: LuminanceUnit): this {\n    return new Luminance(baseValue, unit) as this;\n  }\n\n  get candelaPerSquareMetre(): number {\n    return this.in(LuminanceUnit.CandelaPerSquareMetre);\n  }\n  get nits(): number {\n    return this.in(LuminanceUnit.Nit);\n  }\n  get kilocandelaPerSquareMetre(): number {\n    return this.in(LuminanceUnit.KilocandelaPerSquareMetre);\n  }\n\n  /** Creates a luminance from a value and unit. */\n  static create(value: number | Decimal, unit: LuminanceUnit): Luminance {\n    LuminanceUnit.index.assertOwns(unit);\n    const amount = value instanceof Decimal ? value : Luminance.decimalOf(value);\n    return new Luminance(unit.toBase(amount), unit);\n  }\n\n  static fromCandelaPerSquareMetre(value: number | Decimal): Luminance {\n    return Luminance.create(value, LuminanceUnit.CandelaPerSquareMetre);\n  }\n  static fromNits(value: number | Decimal): Luminance {\n    return Luminance.create(value, LuminanceUnit.Nit);\n  }\n  static fromKilocandelaPerSquareMetre(value: number | Decimal): Luminance {\n    return Luminance.create(value, LuminanceUnit.KilocandelaPerSquareMetre);\n  }\n\n  /**\n   * A bare number is read as candela per square metre, since screen brightness\n   * is quoted that way. Negative luminance is rejected.\n   */\n  static tryParse(input: string | null | undefined): Luminance | null {\n    const bare = tryParseNumberOnly(input);\n    if (bare !== null) {\n      if (bare.isNegative) return null;\n      return new Luminance(bare, LuminanceUnit.CandelaPerSquareMetre);\n    }\n\n    const parsed = tryParseQuantity(input, LuminanceUnit.index);\n    return parsed === null ? null : new Luminance(parsed.baseValue, parsed.unit);\n  }\n\n  static parse(input: string): Luminance {\n    const result = Luminance.tryParse(input);\n    if (result === null) throw new Error(\"Invalid luminance.\");\n    return result;\n  }\n\n  static isValid(input: string | null | undefined): boolean {\n    return Luminance.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?: LuminanceFormatOptions): string | null {\n    const parsed = Luminance.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 Luminance.fallback(input, options);\n  }\n\n  /** The value in candela per square metre, or `null` when the input is invalid. */\n  static normalize(\n    input: string | null | undefined,\n    options?: LuminanceFormatOptions,\n  ): string | null {\n    const parsed = Luminance.tryParse(input);\n    if (parsed !== null) return parsed.toNormalizedString();\n    return Luminance.fallback(input, options);\n  }\n\n  static isNormalized(input: string | null | undefined): boolean {\n    return input != null && Luminance.normalize(input) === input;\n  }\n\n  static findCandidatesInText(text: string): readonly TextCandidate<Luminance>[] {\n    if (!text) return [];\n\n    const out: TextCandidate<Luminance>[] = [];\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 = Luminance.tryParse(match[0]);\n      if (value === null) continue;\n      out.push(\n        new TextCandidate<Luminance>({\n          startIndex: match.index,\n          length: match[0].length,\n          originalText: match[0],\n          typeName: \"Luminance\",\n          category: TextCandidateCategory.Measurement,\n          normalizedForm: value.toNormalizedString(),\n          formattedForm: value.toString(),\n          maskedForm: maskLuminance(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?: LuminanceFormatOptions,\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 luminance: ${value}`);\n    return parsed;\n  }\n}\n\n/** Returns a masked luminance, e.g. `10 cd/m\u00B2` becomes `*** cd/m\u00B2`. */\nexport function maskLuminance(value: Luminance): string {\n  return `*** ${value.originalUnit.symbol}`;\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/cjs/measurement/luminous-flux-unit.js

@@ -0,0 +1,86 @@
+"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 luminous_flux_unit_exports = {};
+__export(luminous_flux_unit_exports, {
+  LuminousFluxUnit: () => LuminousFluxUnit
+});
+module.exports = __toCommonJS(luminous_flux_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 LuminousFluxUnit extends import_measurement_unit.MeasurementUnit {
+  static typeInfo = Object.freeze({
+    englishName: "Luminous Flux Unit",
+    localizedName: "Ljusfl\xF6desenhet",
+    emoji: "\u{1F4A1}",
+    sources: Object.freeze([])
+  });
+  static Lumen = new LuminousFluxUnit({
+    symbol: "lm",
+    englishName: "lumen",
+    localizedName: "lumen",
+    pluralEnglish: "lumens",
+    pluralSwedish: "lumen",
+    toBaseUnitFactor: factor("1")
+  });
+  static Kilolumen = new LuminousFluxUnit({
+    symbol: "klm",
+    englishName: "kilolumen",
+    localizedName: "kilolumen",
+    pluralEnglish: "kilolumens",
+    pluralSwedish: "kilolumen",
+    toBaseUnitFactor: factor("1000"),
+    aliases: ["Klm", "kLm"]
+  });
+  /** @internal Shared lookup and natural-scale walk. */
+  static index = new import_measurement_unit.MeasurementUnitIndex(
+    [LuminousFluxUnit.Lumen, LuminousFluxUnit.Kilolumen],
+    LuminousFluxUnit.Lumen,
+    [LuminousFluxUnit.Lumen, LuminousFluxUnit.Kilolumen]
+  );
+  static get all() {
+    return LuminousFluxUnit.index.all;
+  }
+  /** The base unit: lm. */
+  static get baseUnit() {
+    return LuminousFluxUnit.index.baseUnit;
+  }
+  /** Units ordered small to large, used to auto-scale display. */
+  static get naturalScale() {
+    return LuminousFluxUnit.index.naturalScale;
+  }
+  /** Resolves a unit from a symbol, name, plural or alias, case-insensitively. */
+  static tryParse(input) {
+    return LuminousFluxUnit.index.tryParse(input);
+  }
+  static parse(input) {
+    const result = LuminousFluxUnit.tryParse(input);
+    if (result === null) throw new Error("Unknown luminous flux unit.");
+    return result;
+  }
+  /** Returns the most human-readable unit for a value in lm. */
+  static getNatural(baseValue) {
+    return LuminousFluxUnit.index.getNatural(baseValue);
+  }
+}
+//# sourceMappingURL=luminous-flux-unit.js.map

package/dist/cjs/measurement/luminous-flux-unit.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/measurement/luminous-flux-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 luminous flux 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 LuminousFluxUnit extends MeasurementUnit {\n  declare private readonly __luminousFluxUnitBrand: void;\n\n  static readonly typeInfo: PrimitiveTypeInfo = Object.freeze({\n    englishName: \"Luminous Flux Unit\",\n    localizedName: \"Ljusfl\u00F6desenhet\",\n    emoji: \"\uD83D\uDCA1\",\n    sources: Object.freeze([]),\n  });\n\n  static readonly Lumen = new LuminousFluxUnit({\n    symbol: \"lm\",\n    englishName: \"lumen\",\n    localizedName: \"lumen\",\n    pluralEnglish: \"lumens\",\n    pluralSwedish: \"lumen\",\n    toBaseUnitFactor: factor(\"1\"),\n  });\n\n  static readonly Kilolumen = new LuminousFluxUnit({\n    symbol: \"klm\",\n    englishName: \"kilolumen\",\n    localizedName: \"kilolumen\",\n    pluralEnglish: \"kilolumens\",\n    pluralSwedish: \"kilolumen\",\n    toBaseUnitFactor: factor(\"1000\"),\n    aliases: [\"Klm\", \"kLm\"],\n  });\n\n  /** @internal Shared lookup and natural-scale walk. */\n  static readonly index: MeasurementUnitIndex<LuminousFluxUnit> =\n    new MeasurementUnitIndex<LuminousFluxUnit>(\n      [LuminousFluxUnit.Lumen, LuminousFluxUnit.Kilolumen],\n      LuminousFluxUnit.Lumen,\n      [LuminousFluxUnit.Lumen, LuminousFluxUnit.Kilolumen],\n    );\n\n  static get all(): readonly LuminousFluxUnit[] {\n    return LuminousFluxUnit.index.all;\n  }\n\n  /** The base unit: lm. */\n  static get baseUnit(): LuminousFluxUnit {\n    return LuminousFluxUnit.index.baseUnit;\n  }\n\n  /** Units ordered small to large, used to auto-scale display. */\n  static get naturalScale(): readonly LuminousFluxUnit[] {\n    return LuminousFluxUnit.index.naturalScale;\n  }\n\n  /** Resolves a unit from a symbol, name, plural or alias, case-insensitively. */\n  static tryParse(input: string | null | undefined): LuminousFluxUnit | null {\n    return LuminousFluxUnit.index.tryParse(input);\n  }\n\n  static parse(input: string): LuminousFluxUnit {\n    const result = LuminousFluxUnit.tryParse(input);\n    if (result === null) throw new Error(\"Unknown luminous flux unit.\");\n    return result;\n  }\n\n  /** Returns the most human-readable unit for a value in lm. */\n  static getNatural(baseValue: Decimal): LuminousFluxUnit {\n    return LuminousFluxUnit.index.getNatural(baseValue);\n  }\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,qBAAwB;AACxB,8BAAsD;AAGtD,SAAS,OAAO,SAA0B;AACxC,QAAM,SAAS,uBAAQ,MAAM,OAAO;AAEpC,MAAI,WAAW,KAAM,OAAM,IAAI,MAAM,8BAA8B,OAAO,EAAE;AAC5E,SAAO;AACT;AAOO,MAAM,yBAAyB,wCAAgB;AAAA,EAGpD,OAAgB,WAA8B,OAAO,OAAO;AAAA,IAC1D,aAAa;AAAA,IACb,eAAe;AAAA,IACf,OAAO;AAAA,IACP,SAAS,OAAO,OAAO,CAAC,CAAC;AAAA,EAC3B,CAAC;AAAA,EAED,OAAgB,QAAQ,IAAI,iBAAiB;AAAA,IAC3C,QAAQ;AAAA,IACR,aAAa;AAAA,IACb,eAAe;AAAA,IACf,eAAe;AAAA,IACf,eAAe;AAAA,IACf,kBAAkB,OAAO,GAAG;AAAA,EAC9B,CAAC;AAAA,EAED,OAAgB,YAAY,IAAI,iBAAiB;AAAA,IAC/C,QAAQ;AAAA,IACR,aAAa;AAAA,IACb,eAAe;AAAA,IACf,eAAe;AAAA,IACf,eAAe;AAAA,IACf,kBAAkB,OAAO,MAAM;AAAA,IAC/B,SAAS,CAAC,OAAO,KAAK;AAAA,EACxB,CAAC;AAAA;AAAA,EAGD,OAAgB,QACd,IAAI;AAAA,IACF,CAAC,iBAAiB,OAAO,iBAAiB,SAAS;AAAA,IACnD,iBAAiB;AAAA,IACjB,CAAC,iBAAiB,OAAO,iBAAiB,SAAS;AAAA,EACrD;AAAA,EAEF,WAAW,MAAmC;AAC5C,WAAO,iBAAiB,MAAM;AAAA,EAChC;AAAA;AAAA,EAGA,WAAW,WAA6B;AACtC,WAAO,iBAAiB,MAAM;AAAA,EAChC;AAAA;AAAA,EAGA,WAAW,eAA4C;AACrD,WAAO,iBAAiB,MAAM;AAAA,EAChC;AAAA;AAAA,EAGA,OAAO,SAAS,OAA2D;AACzE,WAAO,iBAAiB,MAAM,SAAS,KAAK;AAAA,EAC9C;AAAA,EAEA,OAAO,MAAM,OAAiC;AAC5C,UAAM,SAAS,iBAAiB,SAAS,KAAK;AAC9C,QAAI,WAAW,KAAM,OAAM,IAAI,MAAM,6BAA6B;AAClE,WAAO;AAAA,EACT;AAAA;AAAA,EAGA,OAAO,WAAW,WAAsC;AACtD,WAAO,iBAAiB,MAAM,WAAW,SAAS;AAAA,EACpD;AACF;",
+  "names": []
+}

package/dist/cjs/measurement/luminous-flux.js

@@ -0,0 +1,142 @@
+"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 luminous_flux_exports = {};
+__export(luminous_flux_exports, {
+  LuminousFlux: () => LuminousFlux,
+  maskLuminousFlux: () => maskLuminousFlux
+});
+module.exports = __toCommonJS(luminous_flux_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_luminous_flux_unit = require("./luminous-flux-unit.js");
+const SCAN_PATTERN = new RegExp(
+  String.raw`(?<![\p{L}\p{N}_])(?:[+-]\s*)?\d+[0-9 .,]*\s*(?:klm|lm)(?![\p{L}\p{N}_])`,
+  "giu"
+);
+class LuminousFlux extends import_quantity.Quantity {
+  static typeInfo = Object.freeze({
+    englishName: "Luminous Flux",
+    localizedName: "Ljusfl\xF6de",
+    emoji: "\u{1F4A1}",
+    sources: Object.freeze([
+      "https://www.bipm.org/en/measurement-units/si-derived-units",
+      "https://en.wikipedia.org/wiki/Lumen_(unit)"
+    ])
+  });
+  get units() {
+    return import_luminous_flux_unit.LuminousFluxUnit.index;
+  }
+  withBaseValue(baseValue, unit) {
+    return new LuminousFlux(baseValue, unit);
+  }
+  get lumens() {
+    return this.in(import_luminous_flux_unit.LuminousFluxUnit.Lumen);
+  }
+  get kilolumens() {
+    return this.in(import_luminous_flux_unit.LuminousFluxUnit.Kilolumen);
+  }
+  /** Creates a luminous flux from a value and unit. */
+  static create(value, unit) {
+    import_luminous_flux_unit.LuminousFluxUnit.index.assertOwns(unit);
+    const amount = value instanceof import_decimal.Decimal ? value : LuminousFlux.decimalOf(value);
+    return new LuminousFlux(unit.toBase(amount), unit);
+  }
+  static fromLumens(value) {
+    return LuminousFlux.create(value, import_luminous_flux_unit.LuminousFluxUnit.Lumen);
+  }
+  static fromKilolumens(value) {
+    return LuminousFlux.create(value, import_luminous_flux_unit.LuminousFluxUnit.Kilolumen);
+  }
+  static tryParse(input) {
+    const parsed = (0, import_quantity.tryParseQuantity)(input, import_luminous_flux_unit.LuminousFluxUnit.index);
+    return parsed === null ? null : new LuminousFlux(parsed.baseValue, parsed.unit);
+  }
+  static parse(input) {
+    const result = LuminousFlux.tryParse(input);
+    if (result === null) throw new Error("Invalid luminous flux.");
+    return result;
+  }
+  static isValid(input) {
+    return LuminousFlux.tryParse(input) !== null;
+  }
+  /** Display form in the parsed unit, or `null` when the input is invalid. */
+  static format(input, options) {
+    const parsed = LuminousFlux.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 LuminousFlux.fallback(input, options);
+  }
+  /** The value in lumens, or `null` when the input is invalid. */
+  static normalize(input, options) {
+    const parsed = LuminousFlux.tryParse(input);
+    if (parsed !== null) return parsed.toNormalizedString();
+    return LuminousFlux.fallback(input, options);
+  }
+  static isNormalized(input) {
+    return input != null && LuminousFlux.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 = LuminousFlux.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: "LuminousFlux",
+          category: import_text_candidate_category.TextCandidateCategory.Measurement,
+          normalizedForm: value.toNormalizedString(),
+          formattedForm: value.toString(),
+          maskedForm: maskLuminousFlux(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 luminous flux: ${value}`);
+    return parsed;
+  }
+}
+function maskLuminousFlux(value) {
+  return `*** ${value.originalUnit.symbol}`;
+}
+//# sourceMappingURL=luminous-flux.js.map

package/dist/cjs/measurement/luminous-flux.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/measurement/luminous-flux.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 { LuminousFluxUnit } from \"./luminous-flux-unit.js\";\n\n/** Options for {@link LuminousFlux.format} and {@link LuminousFlux.normalize}. */\nexport interface LuminousFluxFormatOptions {\n  fallbackToTrimmedInputWhenInvalid?: boolean;\n  /** Convert to this unit instead of preserving the parsed one. */\n  unit?: LuminousFluxUnit;\n  /** Round to this many fractional digits, away from zero. */\n  decimals?: number;\n}\n\nconst SCAN_PATTERN = new RegExp(\n  String.raw`(?<![\\p{L}\\p{N}_])(?:[+-]\\s*)?\\d+[0-9 .,]*\\s*(?:klm|lm)(?![\\p{L}\\p{N}_])`,\n  \"giu\",\n);\n\n/**\n * A luminous flux stored internally in lumens,\n * parsed from any supported unit and convertible between all of them.\n */\nexport class LuminousFlux extends Quantity<LuminousFluxUnit> {\n  static readonly typeInfo: PrimitiveTypeInfo = Object.freeze({\n    englishName: \"Luminous Flux\",\n    localizedName: \"Ljusfl\u00F6de\",\n    emoji: \"\uD83D\uDCA1\",\n    sources: Object.freeze([\n      \"https://www.bipm.org/en/measurement-units/si-derived-units\",\n      \"https://en.wikipedia.org/wiki/Lumen_(unit)\",\n    ]),\n  });\n\n  protected get units(): MeasurementUnitIndex<LuminousFluxUnit> {\n    return LuminousFluxUnit.index;\n  }\n\n  protected withBaseValue(baseValue: Decimal, unit: LuminousFluxUnit): this {\n    return new LuminousFlux(baseValue, unit) as this;\n  }\n\n  get lumens(): number {\n    return this.in(LuminousFluxUnit.Lumen);\n  }\n  get kilolumens(): number {\n    return this.in(LuminousFluxUnit.Kilolumen);\n  }\n\n  /** Creates a luminous flux from a value and unit. */\n  static create(value: number | Decimal, unit: LuminousFluxUnit): LuminousFlux {\n    LuminousFluxUnit.index.assertOwns(unit);\n    const amount = value instanceof Decimal ? value : LuminousFlux.decimalOf(value);\n    return new LuminousFlux(unit.toBase(amount), unit);\n  }\n\n  static fromLumens(value: number | Decimal): LuminousFlux {\n    return LuminousFlux.create(value, LuminousFluxUnit.Lumen);\n  }\n  static fromKilolumens(value: number | Decimal): LuminousFlux {\n    return LuminousFlux.create(value, LuminousFluxUnit.Kilolumen);\n  }\n\n  static tryParse(input: string | null | undefined): LuminousFlux | null {\n    const parsed = tryParseQuantity(input, LuminousFluxUnit.index);\n    return parsed === null ? null : new LuminousFlux(parsed.baseValue, parsed.unit);\n  }\n\n  static parse(input: string): LuminousFlux {\n    const result = LuminousFlux.tryParse(input);\n    if (result === null) throw new Error(\"Invalid luminous flux.\");\n    return result;\n  }\n\n  static isValid(input: string | null | undefined): boolean {\n    return LuminousFlux.tryParse(input) !== null;\n  }\n\n  /** Display form in the parsed unit, or `null` when the input is invalid. */\n  static format(\n    input: string | null | undefined,\n    options?: LuminousFluxFormatOptions,\n  ): string | null {\n    const parsed = LuminousFlux.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 LuminousFlux.fallback(input, options);\n  }\n\n  /** The value in lumens, or `null` when the input is invalid. */\n  static normalize(\n    input: string | null | undefined,\n    options?: LuminousFluxFormatOptions,\n  ): string | null {\n    const parsed = LuminousFlux.tryParse(input);\n    if (parsed !== null) return parsed.toNormalizedString();\n    return LuminousFlux.fallback(input, options);\n  }\n\n  static isNormalized(input: string | null | undefined): boolean {\n    return input != null && LuminousFlux.normalize(input) === input;\n  }\n\n  static findCandidatesInText(text: string): readonly TextCandidate<LuminousFlux>[] {\n    if (!text) return [];\n\n    const out: TextCandidate<LuminousFlux>[] = [];\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 = LuminousFlux.tryParse(match[0]);\n      if (value === null) continue;\n      out.push(\n        new TextCandidate<LuminousFlux>({\n          startIndex: match.index,\n          length: match[0].length,\n          originalText: match[0],\n          typeName: \"LuminousFlux\",\n          category: TextCandidateCategory.Measurement,\n          normalizedForm: value.toNormalizedString(),\n          formattedForm: value.toString(),\n          maskedForm: maskLuminousFlux(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?: LuminousFluxFormatOptions,\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)\n      throw new Error(`Value cannot be represented as a luminous flux: ${value}`);\n    return parsed;\n  }\n}\n\n/** Returns a masked luminous flux, e.g. `10 lm` becomes `*** lm`. */\nexport function maskLuminousFlux(value: LuminousFlux): string {\n  return `*** ${value.originalUnit.symbol}`;\n}\n"],
+  "mappings": "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",
+  "names": []
+}