@budiauktioner/buildi-primitives 0.2.1 → 0.3.0

package/dist/types/text-scanning/index.d.ts

@@ -1,5 +1,5 @@
 import { T as TextCandidate, a as TextCandidateCategory, b as TextMatchConfidence } from '../text-candidate-qg2bD9PY.js';
-import { I as Iban, B as Bic, d as SwedishBankgiroNumber, f as SwedishPostgiroNumber, b as SwedishBankAccount, e as SwedishOcrReferenceNumber, g as SwedishSwishNumber } from '../swedish-swish-number-DDG3mNDg.js';
+import { I as Iban, B as Bic, d as SwedishBankgiroNumber, f as SwedishPostgiroNumber, b as SwedishBankAccount, e as SwedishOcrReferenceNumber, g as SwedishSwishNumber } from '../swedish-swish-number-C2Wccuyr.js';
 import { c as AddressZipCode, A as Address, S as SwedishAddress } from '../swedish-address-GMzjqgxb.js';
 import { a as PhoneNumber } from '../phone-number-C24--ggy.js';
 import { I as Isin } from '../isin-EeVPpNWu.js';
@@ -15,6 +15,7 @@ import { S as SwedishPropertyDesignation } from '../swedish-property-designation
 import { EmailAddress, Url } from '../web/index.js';
 import { h as Gtin8, G as Gtin12, d as Gtin13, f as Gtin14, I as IpRating, E as ElectricalPhase, R as Refrigerant, C as Color, S as ScreenResolution, n as ScreenSize } from '../screen-size-DUmjNjxG.js';
 import { o as SwedishVehicleRegistrationNumber, V as VehicleIdentificationNumber, O as OperatingHours, B as BoltPattern, W as WheelRimDimension, T as TireDimension, e as EuTypeApprovalNumber, c as EnginePower, F as FuelConsumption, E as EmissionRate, g as EuroEmissionClass, m as SwedishEcoVehicleClassification, S as SwedishDrivingLicenseCategory } from '../wheel-rim-dimension-CVCmLASl.js';
+import { W as WatercraftIdentificationNumber } from '../watercraft-identification-number-o8B3C6Nx.js';
 import '../validation/index.js';
 import '../swedish-organization-type-CZOdETwG.js';
 
@@ -94,6 +95,7 @@ declare class TextScanResult {
     get weights(): TextCandidate<Weight>[];
     get vehicleRegistrationNumbers(): TextCandidate<SwedishVehicleRegistrationNumber>[];
     get vehicleIdentificationNumbers(): TextCandidate<VehicleIdentificationNumber>[];
+    get watercraftIdentificationNumbers(): TextCandidate<WatercraftIdentificationNumber>[];
     get operatingHourValues(): TextCandidate<OperatingHours>[];
     get boltPatterns(): TextCandidate<BoltPattern>[];
     get wheelRimDimensions(): TextCandidate<WheelRimDimension>[];

package/dist/types/validation/index.d.cts

@@ -26,6 +26,10 @@ declare const ValidationErrorReason: {
     readonly MissingAtSign: "MissingAtSign";
     readonly InvalidLocalPart: "InvalidLocalPart";
     readonly InvalidDomain: "InvalidDomain";
+    readonly InvalidManufacturerCode: "InvalidManufacturerCode";
+    readonly InvalidSerialNumber: "InvalidSerialNumber";
+    readonly InvalidMonthCode: "InvalidMonthCode";
+    readonly InvalidYearDigits: "InvalidYearDigits";
 };
 type ValidationErrorReason = (typeof ValidationErrorReason)[keyof typeof ValidationErrorReason];
 

package/dist/types/validation/index.d.ts

@@ -26,6 +26,10 @@ declare const ValidationErrorReason: {
     readonly MissingAtSign: "MissingAtSign";
     readonly InvalidLocalPart: "InvalidLocalPart";
     readonly InvalidDomain: "InvalidDomain";
+    readonly InvalidManufacturerCode: "InvalidManufacturerCode";
+    readonly InvalidSerialNumber: "InvalidSerialNumber";
+    readonly InvalidMonthCode: "InvalidMonthCode";
+    readonly InvalidYearDigits: "InvalidYearDigits";
 };
 type ValidationErrorReason = (typeof ValidationErrorReason)[keyof typeof ValidationErrorReason];
 

package/dist/types/vehicle/index.d.cts

@@ -3,7 +3,9 @@ import { o as SwedishVehicleRegistrationNumber, m as SwedishEcoVehicleClassifica
 export { B as BoltPattern, a as BoltPatternFormatOptions, E as EmissionRate, b as EmissionRateFormatOptions, c as EnginePower, d as EnginePowerFormatOptions, e as EuTypeApprovalNumber, f as EuTypeApprovalNumberFormatOptions, g as EuroEmissionClass, h as EuroEmissionClassFormatOptions, F as FuelConsumption, i as FuelConsumptionFormatOptions, O as OperatingHours, j as OperatingHoursFormatOptions, S as SwedishDrivingLicenseCategory, k as SwedishDrivingLicenseCategoryFormatOptions, l as SwedishDrivingLicenseVehicleGroup, n as SwedishEcoVehicleClassificationFormatOptions, p as SwedishVehicleRegistrationNumberFormatOptions, T as TireDimension, q as TireDimensionFormatOptions, V as VehicleIdentificationNumber, r as VehicleIdentificationNumberFormatOptions, W as WheelRimDimension, s as WheelRimDimensionFormatOptions, t as maskBoltPattern, u as maskEmissionRate, v as maskEnginePower, w as maskEuTypeApprovalNumber, x as maskFuelConsumption, y as maskOperatingHours, z as maskSwedishVehicleRegistrationNumber, A as maskTireDimension, C as maskVehicleIdentificationNumber, D as maskWheelRimDimension } from '../wheel-rim-dimension-CdkDrzad.cjs';
 import { D as Decimal, L as Length, b as LengthUnit } from '../length-XRL5Eg7F.cjs';
 import { V as Volume, d as VolumeUnit } from '../volume-CFA4e3dc.cjs';
+export { W as WatercraftIdentificationNumber, a as WatercraftIdentificationNumberFormatOptions, b as WatercraftIdentificationNumberScheme, m as maskWatercraftIdentificationNumber } from '../watercraft-identification-number-Db1I2LQM.cjs';
 import '../validation/index.cjs';
+import '../country-BhD51LDL.cjs';
 
 /** Options shared by the string-in, string-out helpers. */
 interface BoatCeDesignCategoryFormatOptions {

package/dist/types/vehicle/index.d.ts

@@ -3,7 +3,9 @@ import { o as SwedishVehicleRegistrationNumber, m as SwedishEcoVehicleClassifica
 export { B as BoltPattern, a as BoltPatternFormatOptions, E as EmissionRate, b as EmissionRateFormatOptions, c as EnginePower, d as EnginePowerFormatOptions, e as EuTypeApprovalNumber, f as EuTypeApprovalNumberFormatOptions, g as EuroEmissionClass, h as EuroEmissionClassFormatOptions, F as FuelConsumption, i as FuelConsumptionFormatOptions, O as OperatingHours, j as OperatingHoursFormatOptions, S as SwedishDrivingLicenseCategory, k as SwedishDrivingLicenseCategoryFormatOptions, l as SwedishDrivingLicenseVehicleGroup, n as SwedishEcoVehicleClassificationFormatOptions, p as SwedishVehicleRegistrationNumberFormatOptions, T as TireDimension, q as TireDimensionFormatOptions, V as VehicleIdentificationNumber, r as VehicleIdentificationNumberFormatOptions, W as WheelRimDimension, s as WheelRimDimensionFormatOptions, t as maskBoltPattern, u as maskEmissionRate, v as maskEnginePower, w as maskEuTypeApprovalNumber, x as maskFuelConsumption, y as maskOperatingHours, z as maskSwedishVehicleRegistrationNumber, A as maskTireDimension, C as maskVehicleIdentificationNumber, D as maskWheelRimDimension } from '../wheel-rim-dimension-CVCmLASl.js';
 import { D as Decimal, L as Length, b as LengthUnit } from '../length-CceXIJYY.js';
 import { V as Volume, d as VolumeUnit } from '../volume-DGLPQypt.js';
+export { W as WatercraftIdentificationNumber, a as WatercraftIdentificationNumberFormatOptions, b as WatercraftIdentificationNumberScheme, m as maskWatercraftIdentificationNumber } from '../watercraft-identification-number-o8B3C6Nx.js';
 import '../validation/index.js';
+import '../country-p0n0EVQ9.js';
 
 /** Options shared by the string-in, string-out helpers. */
 interface BoatCeDesignCategoryFormatOptions {

package/dist/types/watercraft-identification-number-Db1I2LQM.d.cts

@@ -0,0 +1,123 @@
+import { a as Country } from './country-BhD51LDL.cjs';
+import { P as PrimitiveTypeInfo, T as TextCandidate } from './text-candidate-qg2bD9PY.cjs';
+import { ValidationResult } from './validation/index.cjs';
+
+/** Options for {@link WatercraftIdentificationNumber.format} and `normalize`. */
+interface WatercraftIdentificationNumberFormatOptions {
+    fallbackToTrimmedInputWhenInvalid?: boolean;
+}
+/** The scheme a {@link WatercraftIdentificationNumber} was written in. */
+declare const WatercraftIdentificationNumberScheme: {
+    readonly Unknown: 0;
+    /**
+     * ISO 10087 craft or watercraft identification number (CIN/WIN): a two-letter
+     * country code, a hyphen and twelve characters, e.g. `NL-HXAB7A33G506`.
+     */
+    readonly Iso10087: 1;
+    /**
+     * United States hull identification number (HIN) in the twelve-character format
+     * required since 1 August 1984 by 33 CFR 181.25, e.g. `ZZZ00001A020`.
+     */
+    readonly UnitedStatesHullIdentificationNumber: 2;
+};
+type WatercraftIdentificationNumberScheme = (typeof WatercraftIdentificationNumberScheme)[keyof typeof WatercraftIdentificationNumberScheme];
+/**
+ * A watercraft identification number (`skrovnummer`), the hull marking of a small
+ * craft: either the ISO 10087 craft identification number (CIN, now called WIN by
+ * Transportstyrelsen) of fourteen characters plus a hyphen, or the twelve-character
+ * US hull identification number (HIN).
+ *
+ * The number is assigned by the manufacturer and carries no check digit, so a parsed
+ * value is structurally valid only — it does not prove that the manufacturer code is
+ * registered or that the number belongs to a particular craft. The production year
+ * and model year are encoded as one and two digits respectively, so the century
+ * cannot be derived from the number alone; they are exposed as digits rather than
+ * full years. Older markings that predate these formats (for example US HINs from
+ * before August 1984) are not accepted.
+ *
+ * Sources:
+ * - https://www.iso.org/standard/82383.html
+ * - https://www.ecfr.gov/current/title-33/chapter-I/subchapter-S/part-181/subpart-C/section-181.25
+ * - https://www.transportstyrelsen.se/sv/sjofart/fritidsbatar/lagar-och-regler-for-fritidsbatar/cemarkning/bygga-om-tillverka-distribuera-och-importera/tillverka/instruktionsbok-tillverkarskylt-och-win/
+ */
+declare class WatercraftIdentificationNumber {
+    static readonly typeInfo: PrimitiveTypeInfo;
+    /**
+     * The number in uppercase without separators: fourteen characters for ISO 10087,
+     * e.g. `NLHXAB7A33G506`, or twelve for a US HIN, e.g. `ZZZ00001A020`.
+     */
+    readonly value: string;
+    /**
+     * The number as it is marked on the hull: ISO 10087 with the hyphen after the
+     * country code, e.g. `NL-HXAB7A33G506`, and a US HIN unchanged, e.g. `ZZZ00001A020`.
+     */
+    readonly formatted: string;
+    /** Which of the two supported formats the number follows. */
+    readonly scheme: WatercraftIdentificationNumberScheme;
+    /**
+     * The ISO 3166-1 alpha-2 code of the country where the manufacturer is established,
+     * e.g. `NL`, or `null` for a US HIN, which carries no country.
+     */
+    readonly countryCode: string | null;
+    /** The country of {@link countryCode}, or `null` for a US HIN. */
+    readonly country: Country | null;
+    /** The three-character manufacturer identification code (MIC), e.g. `HXA`. */
+    readonly manufacturerCode: string;
+    /** The five-character serial number assigned by the manufacturer, e.g. `B7A33`. */
+    readonly serialNumber: string;
+    /**
+     * The production month letter, `A` for January through `L` for December. For a US
+     * HIN this is the month of certification when one is required, otherwise the month
+     * of manufacture.
+     */
+    readonly productionMonthCode: string;
+    /** The production month decoded from {@link productionMonthCode}, 1–12. */
+    readonly productionMonth: number;
+    /** The last digit of the production year, 0–9. The decade is not encoded. */
+    readonly productionYearDigit: number;
+    /** The last two digits of the model year as written, e.g. `06`. The century is not encoded. */
+    readonly modelYearDigits: string;
+    private constructor();
+    static tryParse(input: string | null | undefined): WatercraftIdentificationNumber | null;
+    static parse(input: string): WatercraftIdentificationNumber;
+    static isValid(input: string | null | undefined): boolean;
+    /**
+     * Returns the number as it is marked on the hull, e.g. `NL-HXAB7A33G506` or
+     * `ZZZ00001A020`.
+     */
+    static format(input: string | null | undefined, options?: WatercraftIdentificationNumberFormatOptions): string | null;
+    /**
+     * Returns the number in uppercase without separators, e.g. `NLHXAB7A33G506` or
+     * `ZZZ00001A020`.
+     */
+    static normalize(input: string | null | undefined, options?: WatercraftIdentificationNumberFormatOptions): string | null;
+    static isNormalized(input: string | null | undefined): boolean;
+    /**
+     * Describes every invalid segment of the input, one issue per segment, or reports
+     * it as valid.
+     */
+    static validate(input: string | null | undefined): ValidationResult;
+    /**
+     * Finds watercraft identification number candidates in unstructured text. An ISO
+     * 10087 number written with its hyphen is reported with medium confidence; one
+     * without the hyphen, and a US HIN, are bare runs of letters and digits and
+     * reported with low confidence. Results are heuristic and may include false
+     * positives.
+     */
+    static findCandidatesInText(text: string): readonly TextCandidate<WatercraftIdentificationNumber>[];
+    /** Returns the number without separators, e.g. `NLHXAB7A33G506`. */
+    toNormalizedString(): string;
+    /** Returns the number as it is marked on the hull, e.g. `NL-HXAB7A33G506`. */
+    toString(): string;
+    equals(other: WatercraftIdentificationNumber | null | undefined): boolean;
+    compareTo(other: WatercraftIdentificationNumber | null | undefined): number;
+    private static tryParseCore;
+}
+/**
+ * Returns a watercraft identification number with only the country and manufacturer
+ * codes visible, e.g. `NL-HXAB7A33G506` becomes `NL-HXA*********` and
+ * `ZZZ00001A020` becomes `ZZZ*********`.
+ */
+declare function maskWatercraftIdentificationNumber(win: WatercraftIdentificationNumber): string;
+
+export { WatercraftIdentificationNumber as W, type WatercraftIdentificationNumberFormatOptions as a, WatercraftIdentificationNumberScheme as b, maskWatercraftIdentificationNumber as m };

package/dist/types/watercraft-identification-number-o8B3C6Nx.d.ts

@@ -0,0 +1,123 @@
+import { a as Country } from './country-p0n0EVQ9.js';
+import { P as PrimitiveTypeInfo, T as TextCandidate } from './text-candidate-qg2bD9PY.js';
+import { ValidationResult } from './validation/index.js';
+
+/** Options for {@link WatercraftIdentificationNumber.format} and `normalize`. */
+interface WatercraftIdentificationNumberFormatOptions {
+    fallbackToTrimmedInputWhenInvalid?: boolean;
+}
+/** The scheme a {@link WatercraftIdentificationNumber} was written in. */
+declare const WatercraftIdentificationNumberScheme: {
+    readonly Unknown: 0;
+    /**
+     * ISO 10087 craft or watercraft identification number (CIN/WIN): a two-letter
+     * country code, a hyphen and twelve characters, e.g. `NL-HXAB7A33G506`.
+     */
+    readonly Iso10087: 1;
+    /**
+     * United States hull identification number (HIN) in the twelve-character format
+     * required since 1 August 1984 by 33 CFR 181.25, e.g. `ZZZ00001A020`.
+     */
+    readonly UnitedStatesHullIdentificationNumber: 2;
+};
+type WatercraftIdentificationNumberScheme = (typeof WatercraftIdentificationNumberScheme)[keyof typeof WatercraftIdentificationNumberScheme];
+/**
+ * A watercraft identification number (`skrovnummer`), the hull marking of a small
+ * craft: either the ISO 10087 craft identification number (CIN, now called WIN by
+ * Transportstyrelsen) of fourteen characters plus a hyphen, or the twelve-character
+ * US hull identification number (HIN).
+ *
+ * The number is assigned by the manufacturer and carries no check digit, so a parsed
+ * value is structurally valid only — it does not prove that the manufacturer code is
+ * registered or that the number belongs to a particular craft. The production year
+ * and model year are encoded as one and two digits respectively, so the century
+ * cannot be derived from the number alone; they are exposed as digits rather than
+ * full years. Older markings that predate these formats (for example US HINs from
+ * before August 1984) are not accepted.
+ *
+ * Sources:
+ * - https://www.iso.org/standard/82383.html
+ * - https://www.ecfr.gov/current/title-33/chapter-I/subchapter-S/part-181/subpart-C/section-181.25
+ * - https://www.transportstyrelsen.se/sv/sjofart/fritidsbatar/lagar-och-regler-for-fritidsbatar/cemarkning/bygga-om-tillverka-distribuera-och-importera/tillverka/instruktionsbok-tillverkarskylt-och-win/
+ */
+declare class WatercraftIdentificationNumber {
+    static readonly typeInfo: PrimitiveTypeInfo;
+    /**
+     * The number in uppercase without separators: fourteen characters for ISO 10087,
+     * e.g. `NLHXAB7A33G506`, or twelve for a US HIN, e.g. `ZZZ00001A020`.
+     */
+    readonly value: string;
+    /**
+     * The number as it is marked on the hull: ISO 10087 with the hyphen after the
+     * country code, e.g. `NL-HXAB7A33G506`, and a US HIN unchanged, e.g. `ZZZ00001A020`.
+     */
+    readonly formatted: string;
+    /** Which of the two supported formats the number follows. */
+    readonly scheme: WatercraftIdentificationNumberScheme;
+    /**
+     * The ISO 3166-1 alpha-2 code of the country where the manufacturer is established,
+     * e.g. `NL`, or `null` for a US HIN, which carries no country.
+     */
+    readonly countryCode: string | null;
+    /** The country of {@link countryCode}, or `null` for a US HIN. */
+    readonly country: Country | null;
+    /** The three-character manufacturer identification code (MIC), e.g. `HXA`. */
+    readonly manufacturerCode: string;
+    /** The five-character serial number assigned by the manufacturer, e.g. `B7A33`. */
+    readonly serialNumber: string;
+    /**
+     * The production month letter, `A` for January through `L` for December. For a US
+     * HIN this is the month of certification when one is required, otherwise the month
+     * of manufacture.
+     */
+    readonly productionMonthCode: string;
+    /** The production month decoded from {@link productionMonthCode}, 1–12. */
+    readonly productionMonth: number;
+    /** The last digit of the production year, 0–9. The decade is not encoded. */
+    readonly productionYearDigit: number;
+    /** The last two digits of the model year as written, e.g. `06`. The century is not encoded. */
+    readonly modelYearDigits: string;
+    private constructor();
+    static tryParse(input: string | null | undefined): WatercraftIdentificationNumber | null;
+    static parse(input: string): WatercraftIdentificationNumber;
+    static isValid(input: string | null | undefined): boolean;
+    /**
+     * Returns the number as it is marked on the hull, e.g. `NL-HXAB7A33G506` or
+     * `ZZZ00001A020`.
+     */
+    static format(input: string | null | undefined, options?: WatercraftIdentificationNumberFormatOptions): string | null;
+    /**
+     * Returns the number in uppercase without separators, e.g. `NLHXAB7A33G506` or
+     * `ZZZ00001A020`.
+     */
+    static normalize(input: string | null | undefined, options?: WatercraftIdentificationNumberFormatOptions): string | null;
+    static isNormalized(input: string | null | undefined): boolean;
+    /**
+     * Describes every invalid segment of the input, one issue per segment, or reports
+     * it as valid.
+     */
+    static validate(input: string | null | undefined): ValidationResult;
+    /**
+     * Finds watercraft identification number candidates in unstructured text. An ISO
+     * 10087 number written with its hyphen is reported with medium confidence; one
+     * without the hyphen, and a US HIN, are bare runs of letters and digits and
+     * reported with low confidence. Results are heuristic and may include false
+     * positives.
+     */
+    static findCandidatesInText(text: string): readonly TextCandidate<WatercraftIdentificationNumber>[];
+    /** Returns the number without separators, e.g. `NLHXAB7A33G506`. */
+    toNormalizedString(): string;
+    /** Returns the number as it is marked on the hull, e.g. `NL-HXAB7A33G506`. */
+    toString(): string;
+    equals(other: WatercraftIdentificationNumber | null | undefined): boolean;
+    compareTo(other: WatercraftIdentificationNumber | null | undefined): number;
+    private static tryParseCore;
+}
+/**
+ * Returns a watercraft identification number with only the country and manufacturer
+ * codes visible, e.g. `NL-HXAB7A33G506` becomes `NL-HXA*********` and
+ * `ZZZ00001A020` becomes `ZZZ*********`.
+ */
+declare function maskWatercraftIdentificationNumber(win: WatercraftIdentificationNumber): string;
+
+export { WatercraftIdentificationNumber as W, type WatercraftIdentificationNumberFormatOptions as a, WatercraftIdentificationNumberScheme as b, maskWatercraftIdentificationNumber as m };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@budiauktioner/buildi-primitives",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "Swedish, EU and international value-object primitives — validation, normalization, masking, and text scanning. TypeScript port of Buildi.Primitives (.NET).",
   "license": "MIT",
   "author": "Budi Auktioner",
@@ -228,19 +228,24 @@
     "publint": "publint",
     "attw": "attw --pack . --profile node16"
   },
+  "pnpm": {
+    "overrides": {
+      "esbuild@>=0.27.3 <0.28.1": "^0.28.1"
+    }
+  },
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.18.5",
-    "@eslint/js": "^9.18.0",
-    "@types/node": "^22.10.7",
-    "@vitest/coverage-v8": "^2.1.8",
-    "esbuild": "^0.28.1",
-    "eslint": "^9.18.0",
-    "prettier": "^3.4.2",
-    "publint": "^0.3.2",
-    "tsup": "^8.3.5",
-    "tsx": "^4.19.2",
-    "typescript": "^5.7.3",
-    "typescript-eslint": "^8.21.0",
-    "vitest": "^2.1.8"
+    "@eslint/js": "^9.39.5",
+    "@types/node": "^22.20.5",
+    "@vitest/coverage-v8": "^4.1.12",
+    "esbuild": "^0.28.2",
+    "eslint": "^9.39.5",
+    "prettier": "^3.9.10",
+    "publint": "^0.3.25",
+    "tsup": "^8.5.1",
+    "tsx": "^4.23.15",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.72.1",
+    "vitest": "^4.1.12"
   }
 }

package/dist/types/{swedish-swish-number-CL6Gx_h3.d.cts → swedish-swish-number-Bh-UbVoN.d.cts}

@@ -80,6 +80,142 @@ declare class Bic {
  */
 declare function maskBic(bic: Bic): string;
 
+/**
+ * A Swedish Bankgiro number (`bankgironummer`), e.g. `5805-6201`.
+ * 7 or 8 digits with Luhn check digit.
+ */
+declare class SwedishBankgiroNumber {
+    static readonly typeInfo: PrimitiveTypeInfo;
+    static readonly displayName = "Bankgiro";
+    static readonly displayNameShort = "BG";
+    /** Digit-only value, e.g. `58056201`. */
+    readonly digits: string;
+    /** Hyphenated display form, e.g. `5805-6201`. */
+    readonly formatted: string;
+    private constructor();
+    static tryParse(input: string | null | undefined): SwedishBankgiroNumber | null;
+    static parse(input: string): SwedishBankgiroNumber;
+    static isValid(input: string | null | undefined): boolean;
+    static format(input: string | null | undefined, options?: {
+        fallbackToTrimmedInputWhenInvalid?: boolean;
+    }): string | null;
+    static normalize(input: string | null | undefined, options?: {
+        fallbackToTrimmedInputWhenInvalid?: boolean;
+    }): string | null;
+    static isNormalized(input: string | null | undefined): boolean;
+    toNormalizedString(): string;
+    toDisplayString(): string;
+    toShortDisplayString(): string;
+    toString(): string;
+    static validate(input: string | null | undefined): ValidationResult;
+    static findCandidatesInText(text: string): readonly TextCandidate<SwedishBankgiroNumber>[];
+    equals(other: SwedishBankgiroNumber | null | undefined): boolean;
+    compareTo(other: SwedishBankgiroNumber | null | undefined): number;
+}
+/** Returns the Bankgirot search URL for this Bankgiro number. */
+declare function getBankgirotUrl(bg: SwedishBankgiroNumber): string;
+/**
+ * Returns a masked Bankgiro number, e.g. `****-6201` (default) or `5805-****` when
+ * `showLastDigits` is `false`.
+ */
+declare function maskSwedishBankgiroNumber(bg: SwedishBankgiroNumber, options?: {
+    showLastDigits?: boolean;
+}): string;
+
+/**
+ * A Swedish Plusgiro number (`plusgironummer`), e.g. `1234567-9`.
+ * 2–8 digits with Luhn check digit.
+ */
+declare class SwedishPostgiroNumber {
+    static readonly typeInfo: PrimitiveTypeInfo;
+    static readonly displayName = "Plusgiro";
+    static readonly displayNameShort = "PG";
+    /** Digit-only value, e.g. `41313008`. */
+    readonly digits: string;
+    /** Hyphenated display form, e.g. `4131300-8`. */
+    readonly formatted: string;
+    private constructor();
+    static tryParse(input: string | null | undefined): SwedishPostgiroNumber | null;
+    static parse(input: string): SwedishPostgiroNumber;
+    static isValid(input: string | null | undefined): boolean;
+    static format(input: string | null | undefined, options?: {
+        fallbackToTrimmedInputWhenInvalid?: boolean;
+    }): string | null;
+    static normalize(input: string | null | undefined, options?: {
+        fallbackToTrimmedInputWhenInvalid?: boolean;
+    }): string | null;
+    static isNormalized(input: string | null | undefined): boolean;
+    toNormalizedString(): string;
+    toDisplayString(): string;
+    toShortDisplayString(): string;
+    toString(): string;
+    static validate(input: string | null | undefined): ValidationResult;
+    static findCandidatesInText(text: string): readonly TextCandidate<SwedishPostgiroNumber>[];
+    equals(other: SwedishPostgiroNumber | null | undefined): boolean;
+    compareTo(other: SwedishPostgiroNumber | null | undefined): number;
+}
+/**
+ * Returns a masked Plusgiro number, e.g. `******-9` (default, showing the control digit) or
+ * `123456-*` when `showControlDigit` is `false`.
+ */
+declare function maskSwedishPostgiroNumber(pg: SwedishPostgiroNumber, options?: {
+    showControlDigit?: boolean;
+}): string;
+
+/** OCR reference control type. */
+declare const OcrReferenceControlType: {
+    readonly CheckDigitOnly: "CheckDigitOnly";
+    readonly VariableLengthDigit: "VariableLengthDigit";
+    readonly FixedLength: "FixedLength";
+};
+type OcrReferenceControlType = (typeof OcrReferenceControlType)[keyof typeof OcrReferenceControlType];
+/** Options controlling OCR reference parsing. */
+declare class OcrReferenceOptions {
+    static readonly Default: OcrReferenceOptions;
+    static readonly VariableLengthDigit: OcrReferenceOptions;
+    readonly controlType: OcrReferenceControlType;
+    readonly allowedLengths: readonly number[];
+    constructor(controlType?: OcrReferenceControlType, allowedLengths?: readonly number[]);
+    static fixedLength(...allowedLengths: number[]): OcrReferenceOptions;
+}
+/**
+ * A Swedish OCR reference number (`OCR-nummer`), used in payment flows.
+ * 2–25 digits with Luhn check digit; optional length-digit and fixed-length variants.
+ */
+declare class SwedishOcrReferenceNumber {
+    static readonly typeInfo: PrimitiveTypeInfo;
+    static readonly displayName = "OCR";
+    static readonly displayNameShort = "OCR";
+    readonly value: string;
+    readonly formatted: string;
+    readonly lengthDigit: number | null;
+    get length(): number;
+    get checkDigit(): number;
+    private constructor();
+    static tryParse(input: string | null | undefined, options?: OcrReferenceOptions): SwedishOcrReferenceNumber | null;
+    static tryParseVariableLengthDigit(input: string | null | undefined): SwedishOcrReferenceNumber | null;
+    static tryParseFixedLength(input: string | null | undefined, fixedLengths: number | readonly number[]): SwedishOcrReferenceNumber | null;
+    static parse(input: string, options?: OcrReferenceOptions): SwedishOcrReferenceNumber;
+    static isValid(input: string | null | undefined, options?: OcrReferenceOptions): boolean;
+    static format(input: string | null | undefined, options?: {
+        fallbackToTrimmedInputWhenInvalid?: boolean;
+    }): string | null;
+    static normalize(input: string | null | undefined, options?: {
+        fallbackToTrimmedInputWhenInvalid?: boolean;
+    }): string | null;
+    static isNormalized(input: string | null | undefined): boolean;
+    toNormalizedString(): string;
+    toDisplayString(): string;
+    toShortDisplayString(): string;
+    toString(): string;
+    static validate(input: string | null | undefined): ValidationResult;
+    static findCandidatesInText(text: string): readonly TextCandidate<SwedishOcrReferenceNumber>[];
+    equals(other: SwedishOcrReferenceNumber | null | undefined): boolean;
+    compareTo(other: SwedishOcrReferenceNumber | null | undefined): number;
+}
+/** Returns a fully masked OCR reference, e.g. `12345678901` → `***********`. */
+declare function maskSwedishOcrReferenceNumber(ocr: SwedishOcrReferenceNumber): string;
+
 /**
  * Known Swedish banks, identified by clearing number ranges.
  *
@@ -220,142 +356,6 @@ declare function maskSwedishBankAccount(account: SwedishBankAccount, options?: {
     maskClearingNumber?: boolean;
 }): string;
 
-/**
- * A Swedish Bankgiro number (`bankgironummer`), e.g. `5805-6201`.
- * 7 or 8 digits with Luhn check digit.
- */
-declare class SwedishBankgiroNumber {
-    static readonly typeInfo: PrimitiveTypeInfo;
-    static readonly displayName = "Bankgiro";
-    static readonly displayNameShort = "BG";
-    /** Digit-only value, e.g. `58056201`. */
-    readonly digits: string;
-    /** Hyphenated display form, e.g. `5805-6201`. */
-    readonly formatted: string;
-    private constructor();
-    static tryParse(input: string | null | undefined): SwedishBankgiroNumber | null;
-    static parse(input: string): SwedishBankgiroNumber;
-    static isValid(input: string | null | undefined): boolean;
-    static format(input: string | null | undefined, options?: {
-        fallbackToTrimmedInputWhenInvalid?: boolean;
-    }): string | null;
-    static normalize(input: string | null | undefined, options?: {
-        fallbackToTrimmedInputWhenInvalid?: boolean;
-    }): string | null;
-    static isNormalized(input: string | null | undefined): boolean;
-    toNormalizedString(): string;
-    toDisplayString(): string;
-    toShortDisplayString(): string;
-    toString(): string;
-    static validate(input: string | null | undefined): ValidationResult;
-    static findCandidatesInText(text: string): readonly TextCandidate<SwedishBankgiroNumber>[];
-    equals(other: SwedishBankgiroNumber | null | undefined): boolean;
-    compareTo(other: SwedishBankgiroNumber | null | undefined): number;
-}
-/** Returns the Bankgirot search URL for this Bankgiro number. */
-declare function getBankgirotUrl(bg: SwedishBankgiroNumber): string;
-/**
- * Returns a masked Bankgiro number, e.g. `****-6201` (default) or `5805-****` when
- * `showLastDigits` is `false`.
- */
-declare function maskSwedishBankgiroNumber(bg: SwedishBankgiroNumber, options?: {
-    showLastDigits?: boolean;
-}): string;
-
-/** OCR reference control type. */
-declare const OcrReferenceControlType: {
-    readonly CheckDigitOnly: "CheckDigitOnly";
-    readonly VariableLengthDigit: "VariableLengthDigit";
-    readonly FixedLength: "FixedLength";
-};
-type OcrReferenceControlType = (typeof OcrReferenceControlType)[keyof typeof OcrReferenceControlType];
-/** Options controlling OCR reference parsing. */
-declare class OcrReferenceOptions {
-    static readonly Default: OcrReferenceOptions;
-    static readonly VariableLengthDigit: OcrReferenceOptions;
-    readonly controlType: OcrReferenceControlType;
-    readonly allowedLengths: readonly number[];
-    constructor(controlType?: OcrReferenceControlType, allowedLengths?: readonly number[]);
-    static fixedLength(...allowedLengths: number[]): OcrReferenceOptions;
-}
-/**
- * A Swedish OCR reference number (`OCR-nummer`), used in payment flows.
- * 2–25 digits with Luhn check digit; optional length-digit and fixed-length variants.
- */
-declare class SwedishOcrReferenceNumber {
-    static readonly typeInfo: PrimitiveTypeInfo;
-    static readonly displayName = "OCR";
-    static readonly displayNameShort = "OCR";
-    readonly value: string;
-    readonly formatted: string;
-    readonly lengthDigit: number | null;
-    get length(): number;
-    get checkDigit(): number;
-    private constructor();
-    static tryParse(input: string | null | undefined, options?: OcrReferenceOptions): SwedishOcrReferenceNumber | null;
-    static tryParseVariableLengthDigit(input: string | null | undefined): SwedishOcrReferenceNumber | null;
-    static tryParseFixedLength(input: string | null | undefined, fixedLengths: number | readonly number[]): SwedishOcrReferenceNumber | null;
-    static parse(input: string, options?: OcrReferenceOptions): SwedishOcrReferenceNumber;
-    static isValid(input: string | null | undefined, options?: OcrReferenceOptions): boolean;
-    static format(input: string | null | undefined, options?: {
-        fallbackToTrimmedInputWhenInvalid?: boolean;
-    }): string | null;
-    static normalize(input: string | null | undefined, options?: {
-        fallbackToTrimmedInputWhenInvalid?: boolean;
-    }): string | null;
-    static isNormalized(input: string | null | undefined): boolean;
-    toNormalizedString(): string;
-    toDisplayString(): string;
-    toShortDisplayString(): string;
-    toString(): string;
-    static validate(input: string | null | undefined): ValidationResult;
-    static findCandidatesInText(text: string): readonly TextCandidate<SwedishOcrReferenceNumber>[];
-    equals(other: SwedishOcrReferenceNumber | null | undefined): boolean;
-    compareTo(other: SwedishOcrReferenceNumber | null | undefined): number;
-}
-/** Returns a fully masked OCR reference, e.g. `12345678901` → `***********`. */
-declare function maskSwedishOcrReferenceNumber(ocr: SwedishOcrReferenceNumber): string;
-
-/**
- * A Swedish Plusgiro number (`plusgironummer`), e.g. `1234567-9`.
- * 2–8 digits with Luhn check digit.
- */
-declare class SwedishPostgiroNumber {
-    static readonly typeInfo: PrimitiveTypeInfo;
-    static readonly displayName = "Plusgiro";
-    static readonly displayNameShort = "PG";
-    /** Digit-only value, e.g. `41313008`. */
-    readonly digits: string;
-    /** Hyphenated display form, e.g. `4131300-8`. */
-    readonly formatted: string;
-    private constructor();
-    static tryParse(input: string | null | undefined): SwedishPostgiroNumber | null;
-    static parse(input: string): SwedishPostgiroNumber;
-    static isValid(input: string | null | undefined): boolean;
-    static format(input: string | null | undefined, options?: {
-        fallbackToTrimmedInputWhenInvalid?: boolean;
-    }): string | null;
-    static normalize(input: string | null | undefined, options?: {
-        fallbackToTrimmedInputWhenInvalid?: boolean;
-    }): string | null;
-    static isNormalized(input: string | null | undefined): boolean;
-    toNormalizedString(): string;
-    toDisplayString(): string;
-    toShortDisplayString(): string;
-    toString(): string;
-    static validate(input: string | null | undefined): ValidationResult;
-    static findCandidatesInText(text: string): readonly TextCandidate<SwedishPostgiroNumber>[];
-    equals(other: SwedishPostgiroNumber | null | undefined): boolean;
-    compareTo(other: SwedishPostgiroNumber | null | undefined): number;
-}
-/**
- * Returns a masked Plusgiro number, e.g. `******-9` (default, showing the control digit) or
- * `123456-*` when `showControlDigit` is `false`.
- */
-declare function maskSwedishPostgiroNumber(pg: SwedishPostgiroNumber, options?: {
-    showControlDigit?: boolean;
-}): string;
-
 /**
  * A Swedish Swish payment number (`Swish-nummer`).
  * Accepts: