@budiauktioner/buildi-primitives 0.1.0

package/dist/swedish-personal-identity-number-BiIg4io3.d.ts

@@ -0,0 +1,149 @@
+import { P as PrimitiveTypeInfo, T as TextCandidate } from './text-candidate-qg2bD9PY.js';
+import { ValidationResult } from './validation/index.js';
+
+/**
+ * Provides the current date/time for date-dependent primitives such as
+ * `SwedishPersonalIdentityNumber` (century derivation), `PersonAge`, and
+ * coordination numbers.
+ *
+ * The .NET equivalent is `IBudiTimeProvider`. JS doesn't have an idiomatic
+ * "ambient clock" abstraction, so date-dependent functions accept an optional
+ * `Clock` parameter and fall back to {@link systemClock} when absent.
+ */
+interface Clock {
+    /** Returns the current date/time. */
+    now(): Date;
+}
+
+/**
+ * Local parser for Swedish personnummer and samordningsnummer.
+ *
+ * Replaces the .NET dependency on ActiveLogin.Identity with an in-house
+ * implementation that supports the same input shapes:
+ *
+ * - 12 digits: `199908072391`
+ * - 10 digits: `9908072391` (century inferred)
+ * - Separator forms: `YYMMDD-NNNC` or `YYYYMMDD-NNNC`. The separator may be
+ *   `-` (standard) or `+` (used when the person is 100 years or older;
+ *   only valid when the input was given in 10-digit form).
+ *
+ * For coordination numbers (`samordningsnummer`) the day-of-month is shifted
+ * by 60 (i.e. real day = day - 60), so valid days for coordination numbers
+ * are 61-91 (or 60 when day-of-month is unknown).
+ */
+
+type PinKind = "personal" | "coordination";
+interface ParsedPin {
+    kind: PinKind;
+    /** Full 4-digit year. */
+    year: number;
+    /** 1-12. */
+    month: number;
+    /**
+     * For personal numbers: 1-31. For coordination numbers: realDay (1-31) or
+     * `0` when the day-of-month is unknown (raw day was 60).
+     */
+    realDay: number;
+    /** Three-digit individual number. */
+    individual: string;
+    /** Single check digit. */
+    checkDigit: string;
+    /** Whether the input had a `+` separator (indicates 100+ years old at parse time). */
+    hadPlusSeparator: boolean;
+}
+declare function parsePin(input: string, clock?: Clock): ParsedPin | null;
+/** Build the canonical 12-digit form. */
+declare function pinTo12Digit(p: ParsedPin): string;
+/** Build the canonical 10-digit display form (`YYMMDD-NNNC` or `YYMMDD+NNNC`). */
+declare function pinTo10Digit(p: ParsedPin, clock?: Clock): string;
+/** Estimate gender. The third digit of the individual portion is even for female, odd for male. */
+declare function pinGender(p: ParsedPin): "female" | "male";
+/** Best-effort date of birth (`null` if coordination day is unknown). */
+declare function pinDateOfBirth(p: ParsedPin): Date | null;
+/** Age in whole years (`null` if coordination day is unknown). */
+declare function pinAgeInYears(p: ParsedPin, clock?: Clock): number | null;
+
+/** A Swedish Coordination Number (`samordningsnummer`). */
+declare class SwedishCoordinationNumber {
+    static readonly typeInfo: PrimitiveTypeInfo;
+    readonly _pin: ParsedPin;
+    readonly _clock: Clock;
+    private constructor();
+    get formatted(): string;
+    get value(): string;
+    get realDay(): number;
+    get dateOfBirthHint(): Date | null;
+    get ageHint(): number | null;
+    get genderHint(): "female" | "male";
+    static tryParse(input: string | null | undefined, options?: {
+        clock?: Clock;
+    }): SwedishCoordinationNumber | null;
+    static parse(input: string, options?: {
+        clock?: Clock;
+    }): SwedishCoordinationNumber;
+    static isValid(input: string | null | undefined): boolean;
+    static format(input: string | null | undefined, options?: {
+        fallbackToTrimmedInputWhenInvalid?: boolean;
+        clock?: Clock;
+    }): string | null;
+    static normalize(input: string | null | undefined, options?: {
+        fallbackToTrimmedInputWhenInvalid?: boolean;
+        clock?: Clock;
+    }): string | null;
+    static isNormalized(input: string | null | undefined): boolean;
+    static validate(input: string | null | undefined): ValidationResult;
+    toNormalizedString(): string;
+    toString(): string;
+    to10DigitString(): string;
+    to12DigitString(): string;
+    static findCandidatesInText(text: string): readonly TextCandidate<SwedishCoordinationNumber>[];
+    equals(other: SwedishCoordinationNumber | null | undefined): boolean;
+    compareTo(other: SwedishCoordinationNumber | null | undefined): number;
+}
+/** Mask a coordination number, e.g. `680164-2395` -> `680164-****`. */
+declare function maskCoordinationNumber(c: SwedishCoordinationNumber, options?: {
+    maskBirthDate?: boolean;
+}): string;
+
+/** A Swedish Personal Identity Number (`personnummer`). */
+declare class SwedishPersonalIdentityNumber {
+    static readonly typeInfo: PrimitiveTypeInfo;
+    readonly _pin: ParsedPin;
+    readonly _clock: Clock;
+    private constructor();
+    get formatted(): string;
+    get value(): string;
+    get dateOfBirthHint(): Date;
+    get ageHint(): number;
+    get genderHint(): "female" | "male";
+    static tryParse(input: string | null | undefined, options?: {
+        clock?: Clock;
+    }): SwedishPersonalIdentityNumber | null;
+    static parse(input: string, options?: {
+        clock?: Clock;
+    }): SwedishPersonalIdentityNumber;
+    static isValid(input: string | null | undefined): boolean;
+    static format(input: string | null | undefined, options?: {
+        fallbackToTrimmedInputWhenInvalid?: boolean;
+        clock?: Clock;
+    }): string | null;
+    static normalize(input: string | null | undefined, options?: {
+        fallbackToTrimmedInputWhenInvalid?: boolean;
+        clock?: Clock;
+    }): string | null;
+    static isNormalized(input: string | null | undefined): boolean;
+    static validate(input: string | null | undefined): ValidationResult;
+    toNormalizedString(): string;
+    toString(): string;
+    to10DigitString(): string;
+    to12DigitString(): string;
+    static findCandidatesInText(text: string): readonly TextCandidate<SwedishPersonalIdentityNumber>[];
+    equals(other: SwedishPersonalIdentityNumber | null | undefined): boolean;
+    compareTo(other: SwedishPersonalIdentityNumber | null | undefined): number;
+}
+/** Mask a personal identity number, e.g. `990807-2391` -> `990807-****`. */
+declare function maskPersonalIdentityNumber(p: SwedishPersonalIdentityNumber, options?: {
+    maskBirthDate?: boolean;
+}): string;
+
+export { type Clock as C, type ParsedPin as P, SwedishCoordinationNumber as S, type PinKind as a, SwedishPersonalIdentityNumber as b, maskPersonalIdentityNumber as c, pinAgeInYears as d, pinDateOfBirth as e, pinGender as f, pinTo10Digit as g, pinTo12Digit as h, maskCoordinationNumber as m, parsePin as p };

package/dist/swedish-personal-identity-number-Cp9Coz55.d.cts

@@ -0,0 +1,149 @@
+import { P as PrimitiveTypeInfo, T as TextCandidate } from './text-candidate-qg2bD9PY.cjs';
+import { ValidationResult } from './validation/index.cjs';
+
+/**
+ * Provides the current date/time for date-dependent primitives such as
+ * `SwedishPersonalIdentityNumber` (century derivation), `PersonAge`, and
+ * coordination numbers.
+ *
+ * The .NET equivalent is `IBudiTimeProvider`. JS doesn't have an idiomatic
+ * "ambient clock" abstraction, so date-dependent functions accept an optional
+ * `Clock` parameter and fall back to {@link systemClock} when absent.
+ */
+interface Clock {
+    /** Returns the current date/time. */
+    now(): Date;
+}
+
+/**
+ * Local parser for Swedish personnummer and samordningsnummer.
+ *
+ * Replaces the .NET dependency on ActiveLogin.Identity with an in-house
+ * implementation that supports the same input shapes:
+ *
+ * - 12 digits: `199908072391`
+ * - 10 digits: `9908072391` (century inferred)
+ * - Separator forms: `YYMMDD-NNNC` or `YYYYMMDD-NNNC`. The separator may be
+ *   `-` (standard) or `+` (used when the person is 100 years or older;
+ *   only valid when the input was given in 10-digit form).
+ *
+ * For coordination numbers (`samordningsnummer`) the day-of-month is shifted
+ * by 60 (i.e. real day = day - 60), so valid days for coordination numbers
+ * are 61-91 (or 60 when day-of-month is unknown).
+ */
+
+type PinKind = "personal" | "coordination";
+interface ParsedPin {
+    kind: PinKind;
+    /** Full 4-digit year. */
+    year: number;
+    /** 1-12. */
+    month: number;
+    /**
+     * For personal numbers: 1-31. For coordination numbers: realDay (1-31) or
+     * `0` when the day-of-month is unknown (raw day was 60).
+     */
+    realDay: number;
+    /** Three-digit individual number. */
+    individual: string;
+    /** Single check digit. */
+    checkDigit: string;
+    /** Whether the input had a `+` separator (indicates 100+ years old at parse time). */
+    hadPlusSeparator: boolean;
+}
+declare function parsePin(input: string, clock?: Clock): ParsedPin | null;
+/** Build the canonical 12-digit form. */
+declare function pinTo12Digit(p: ParsedPin): string;
+/** Build the canonical 10-digit display form (`YYMMDD-NNNC` or `YYMMDD+NNNC`). */
+declare function pinTo10Digit(p: ParsedPin, clock?: Clock): string;
+/** Estimate gender. The third digit of the individual portion is even for female, odd for male. */
+declare function pinGender(p: ParsedPin): "female" | "male";
+/** Best-effort date of birth (`null` if coordination day is unknown). */
+declare function pinDateOfBirth(p: ParsedPin): Date | null;
+/** Age in whole years (`null` if coordination day is unknown). */
+declare function pinAgeInYears(p: ParsedPin, clock?: Clock): number | null;
+
+/** A Swedish Coordination Number (`samordningsnummer`). */
+declare class SwedishCoordinationNumber {
+    static readonly typeInfo: PrimitiveTypeInfo;
+    readonly _pin: ParsedPin;
+    readonly _clock: Clock;
+    private constructor();
+    get formatted(): string;
+    get value(): string;
+    get realDay(): number;
+    get dateOfBirthHint(): Date | null;
+    get ageHint(): number | null;
+    get genderHint(): "female" | "male";
+    static tryParse(input: string | null | undefined, options?: {
+        clock?: Clock;
+    }): SwedishCoordinationNumber | null;
+    static parse(input: string, options?: {
+        clock?: Clock;
+    }): SwedishCoordinationNumber;
+    static isValid(input: string | null | undefined): boolean;
+    static format(input: string | null | undefined, options?: {
+        fallbackToTrimmedInputWhenInvalid?: boolean;
+        clock?: Clock;
+    }): string | null;
+    static normalize(input: string | null | undefined, options?: {
+        fallbackToTrimmedInputWhenInvalid?: boolean;
+        clock?: Clock;
+    }): string | null;
+    static isNormalized(input: string | null | undefined): boolean;
+    static validate(input: string | null | undefined): ValidationResult;
+    toNormalizedString(): string;
+    toString(): string;
+    to10DigitString(): string;
+    to12DigitString(): string;
+    static findCandidatesInText(text: string): readonly TextCandidate<SwedishCoordinationNumber>[];
+    equals(other: SwedishCoordinationNumber | null | undefined): boolean;
+    compareTo(other: SwedishCoordinationNumber | null | undefined): number;
+}
+/** Mask a coordination number, e.g. `680164-2395` -> `680164-****`. */
+declare function maskCoordinationNumber(c: SwedishCoordinationNumber, options?: {
+    maskBirthDate?: boolean;
+}): string;
+
+/** A Swedish Personal Identity Number (`personnummer`). */
+declare class SwedishPersonalIdentityNumber {
+    static readonly typeInfo: PrimitiveTypeInfo;
+    readonly _pin: ParsedPin;
+    readonly _clock: Clock;
+    private constructor();
+    get formatted(): string;
+    get value(): string;
+    get dateOfBirthHint(): Date;
+    get ageHint(): number;
+    get genderHint(): "female" | "male";
+    static tryParse(input: string | null | undefined, options?: {
+        clock?: Clock;
+    }): SwedishPersonalIdentityNumber | null;
+    static parse(input: string, options?: {
+        clock?: Clock;
+    }): SwedishPersonalIdentityNumber;
+    static isValid(input: string | null | undefined): boolean;
+    static format(input: string | null | undefined, options?: {
+        fallbackToTrimmedInputWhenInvalid?: boolean;
+        clock?: Clock;
+    }): string | null;
+    static normalize(input: string | null | undefined, options?: {
+        fallbackToTrimmedInputWhenInvalid?: boolean;
+        clock?: Clock;
+    }): string | null;
+    static isNormalized(input: string | null | undefined): boolean;
+    static validate(input: string | null | undefined): ValidationResult;
+    toNormalizedString(): string;
+    toString(): string;
+    to10DigitString(): string;
+    to12DigitString(): string;
+    static findCandidatesInText(text: string): readonly TextCandidate<SwedishPersonalIdentityNumber>[];
+    equals(other: SwedishPersonalIdentityNumber | null | undefined): boolean;
+    compareTo(other: SwedishPersonalIdentityNumber | null | undefined): number;
+}
+/** Mask a personal identity number, e.g. `990807-2391` -> `990807-****`. */
+declare function maskPersonalIdentityNumber(p: SwedishPersonalIdentityNumber, options?: {
+    maskBirthDate?: boolean;
+}): string;
+
+export { type Clock as C, type ParsedPin as P, SwedishCoordinationNumber as S, type PinKind as a, SwedishPersonalIdentityNumber as b, maskPersonalIdentityNumber as c, pinAgeInYears as d, pinDateOfBirth as e, pinGender as f, pinTo10Digit as g, pinTo12Digit as h, maskCoordinationNumber as m, parsePin as p };

package/dist/swedish-property-designation-BM-gdd9x.d.ts

@@ -0,0 +1,46 @@
+import { P as PrimitiveTypeInfo, T as TextCandidate } from './text-candidate-qg2bD9PY.js';
+
+/**
+ * A Swedish property designation (`fastighetsbeteckning`), e.g. `Stockholm Söder 75:2`.
+ * Combines the municipality/tract name with a register number `BLOCK:UNIT`.
+ */
+declare class SwedishPropertyDesignation {
+    static readonly typeInfo: PrimitiveTypeInfo;
+    /** The full designation, e.g. `Stockholm Söder 75:2`. */
+    readonly value: string;
+    /** The capitalized designation name, e.g. `Stockholm Söder`. */
+    readonly designationName: string;
+    /** The register number `BLOCK:UNIT`, e.g. `75:2`. */
+    readonly registerNumber: string;
+    /** Block portion of the register number. */
+    readonly blockNumber: number;
+    /** Unit portion of the register number. */
+    readonly unitNumber: number;
+    private constructor();
+    static tryParse(input: string | null | undefined): SwedishPropertyDesignation | null;
+    static parse(input: string): SwedishPropertyDesignation;
+    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;
+    toString(): string;
+    static findCandidatesInText(text: string): readonly TextCandidate<SwedishPropertyDesignation>[];
+    equals(other: SwedishPropertyDesignation | null | undefined): boolean;
+    compareTo(other: SwedishPropertyDesignation | null | undefined): number;
+}
+/**
+ * Masks the property designation preserving the name, e.g.
+ * `Stockholm Söder 75:2` → `Stockholm Söder **:*`.
+ */
+declare function maskSwedishPropertyDesignation(d: SwedishPropertyDesignation): string;
+/** Returns a Lantmäteriet map search URL for the designation. */
+declare function getLantmaterietUrl(d: SwedishPropertyDesignation): string;
+/** Returns a Hitta.se map search URL for the designation. */
+declare function getPropertyHittaUrl(d: SwedishPropertyDesignation): string;
+
+export { SwedishPropertyDesignation as S, getPropertyHittaUrl as a, getLantmaterietUrl as g, maskSwedishPropertyDesignation as m };

package/dist/swedish-property-designation-BaHXufqV.d.cts

@@ -0,0 +1,46 @@
+import { P as PrimitiveTypeInfo, T as TextCandidate } from './text-candidate-qg2bD9PY.cjs';
+
+/**
+ * A Swedish property designation (`fastighetsbeteckning`), e.g. `Stockholm Söder 75:2`.
+ * Combines the municipality/tract name with a register number `BLOCK:UNIT`.
+ */
+declare class SwedishPropertyDesignation {
+    static readonly typeInfo: PrimitiveTypeInfo;
+    /** The full designation, e.g. `Stockholm Söder 75:2`. */
+    readonly value: string;
+    /** The capitalized designation name, e.g. `Stockholm Söder`. */
+    readonly designationName: string;
+    /** The register number `BLOCK:UNIT`, e.g. `75:2`. */
+    readonly registerNumber: string;
+    /** Block portion of the register number. */
+    readonly blockNumber: number;
+    /** Unit portion of the register number. */
+    readonly unitNumber: number;
+    private constructor();
+    static tryParse(input: string | null | undefined): SwedishPropertyDesignation | null;
+    static parse(input: string): SwedishPropertyDesignation;
+    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;
+    toString(): string;
+    static findCandidatesInText(text: string): readonly TextCandidate<SwedishPropertyDesignation>[];
+    equals(other: SwedishPropertyDesignation | null | undefined): boolean;
+    compareTo(other: SwedishPropertyDesignation | null | undefined): number;
+}
+/**
+ * Masks the property designation preserving the name, e.g.
+ * `Stockholm Söder 75:2` → `Stockholm Söder **:*`.
+ */
+declare function maskSwedishPropertyDesignation(d: SwedishPropertyDesignation): string;
+/** Returns a Lantmäteriet map search URL for the designation. */
+declare function getLantmaterietUrl(d: SwedishPropertyDesignation): string;
+/** Returns a Hitta.se map search URL for the designation. */
+declare function getPropertyHittaUrl(d: SwedishPropertyDesignation): string;
+
+export { SwedishPropertyDesignation as S, getPropertyHittaUrl as a, getLantmaterietUrl as g, maskSwedishPropertyDesignation as m };

package/dist/swedish-sni-code-Ccsswpni.d.ts

@@ -0,0 +1,53 @@
+import { P as PrimitiveTypeInfo } from './text-candidate-qg2bD9PY.js';
+
+/** ISO 20275 Entity Legal Form code. */
+declare class ElfCode {
+    static readonly typeInfo: PrimitiveTypeInfo;
+    readonly code: string;
+    readonly englishName: string | null;
+    readonly localizedName: string | null;
+    get displayName(): string;
+    get isKnown(): boolean;
+    private constructor();
+    static tryParse(input: string | null | undefined): ElfCode | null;
+    static parse(input: string): ElfCode;
+    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;
+    toString(): string;
+    equals(other: ElfCode | null | undefined): boolean;
+    compareTo(other: ElfCode | null | undefined): number;
+}
+
+/** Swedish SNI code (`SNI-kod`). */
+declare class SwedishSniCode {
+    static readonly typeInfo: PrimitiveTypeInfo;
+    readonly code: string;
+    readonly formatted: string;
+    get divisionCode(): string;
+    get groupCode(): string;
+    get subGroupCode(): string;
+    private constructor();
+    static tryParse(input: string | null | undefined): SwedishSniCode | null;
+    static parse(input: string): SwedishSniCode;
+    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;
+    toString(): string;
+    equals(other: SwedishSniCode | null | undefined): boolean;
+    compareTo(other: SwedishSniCode | null | undefined): number;
+}
+
+export { ElfCode as E, SwedishSniCode as S };

package/dist/swedish-sni-code-CuJFyM6l.d.cts

@@ -0,0 +1,53 @@
+import { P as PrimitiveTypeInfo } from './text-candidate-qg2bD9PY.cjs';
+
+/** ISO 20275 Entity Legal Form code. */
+declare class ElfCode {
+    static readonly typeInfo: PrimitiveTypeInfo;
+    readonly code: string;
+    readonly englishName: string | null;
+    readonly localizedName: string | null;
+    get displayName(): string;
+    get isKnown(): boolean;
+    private constructor();
+    static tryParse(input: string | null | undefined): ElfCode | null;
+    static parse(input: string): ElfCode;
+    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;
+    toString(): string;
+    equals(other: ElfCode | null | undefined): boolean;
+    compareTo(other: ElfCode | null | undefined): number;
+}
+
+/** Swedish SNI code (`SNI-kod`). */
+declare class SwedishSniCode {
+    static readonly typeInfo: PrimitiveTypeInfo;
+    readonly code: string;
+    readonly formatted: string;
+    get divisionCode(): string;
+    get groupCode(): string;
+    get subGroupCode(): string;
+    private constructor();
+    static tryParse(input: string | null | undefined): SwedishSniCode | null;
+    static parse(input: string): SwedishSniCode;
+    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;
+    toString(): string;
+    equals(other: SwedishSniCode | null | undefined): boolean;
+    compareTo(other: SwedishSniCode | null | undefined): number;
+}
+
+export { ElfCode as E, SwedishSniCode as S };