@budiauktioner/buildi-primitives 0.1.0

package/dist/validation/index.cjs

@@ -0,0 +1,83 @@
+'use strict';
+
+// src/validation/validation-error-reason.ts
+var ValidationErrorReason = {
+  // --- Common ---
+  InputIsEmpty: "InputIsEmpty",
+  InputTooLong: "InputTooLong",
+  InputTooShort: "InputTooShort",
+  InvalidLength: "InvalidLength",
+  InvalidFormat: "InvalidFormat",
+  InvalidCharacters: "InvalidCharacters",
+  InvalidCheckDigit: "InvalidCheckDigit",
+  // --- Banking / clearing ---
+  UnknownClearingRange: "UnknownClearingRange",
+  InvalidSwedbankFormat: "InvalidSwedbankFormat",
+  InvalidAccountLengthForBank: "InvalidAccountLengthForBank",
+  InvalidClearingNumber: "InvalidClearingNumber",
+  // --- Identity / organization ---
+  InvalidDate: "InvalidDate",
+  InvalidPrefix: "InvalidPrefix",
+  InvalidEntityPattern: "InvalidEntityPattern",
+  // --- International / country ---
+  UnknownCountryCode: "UnknownCountryCode",
+  InvalidCountryPrefix: "InvalidCountryPrefix",
+  InvalidLengthForCountry: "InvalidLengthForCountry",
+  // --- OCR ---
+  InvalidLengthDigit: "InvalidLengthDigit",
+  // --- Email ---
+  MissingAtSign: "MissingAtSign",
+  InvalidLocalPart: "InvalidLocalPart",
+  InvalidDomain: "InvalidDomain"
+};
+var DEFAULT_UI_CULTURE = "sv-SE";
+var state = {
+  uiCulture: DEFAULT_UI_CULTURE};
+var PrimitivesDefaults = {
+  /**
+   * `true` when {@link uiCulture} is Swedish (`sv` or `sv-*`).
+   * Types use this to select between localized and English display names.
+   */
+  get useLocalizedDisplayNames() {
+    const lang = state.uiCulture.toLowerCase().split("-")[0];
+    return lang === "sv";
+  }};
+
+// src/validation/validation-issue.ts
+var ValidationIssue = class {
+  reason;
+  englishDescription;
+  localizedDescription;
+  constructor(reason, englishDescription, localizedDescription) {
+    this.reason = reason;
+    this.englishDescription = englishDescription;
+    this.localizedDescription = localizedDescription;
+  }
+  /**
+   * Returns {@link localizedDescription} when
+   * {@link PrimitivesDefaults.useLocalizedDisplayNames} is `true`, otherwise
+   * {@link englishDescription}.
+   */
+  get description() {
+    return PrimitivesDefaults.useLocalizedDisplayNames ? this.localizedDescription : this.englishDescription;
+  }
+};
+
+// src/validation/validation-result.ts
+var ValidationResult = class {
+  rawInput;
+  isValid;
+  issues;
+  /** @internal — use `validResult` / `invalidResult` factories. */
+  constructor(rawInput, isValid, issues) {
+    this.rawInput = rawInput ?? null;
+    this.isValid = isValid;
+    this.issues = Object.freeze([...issues]);
+  }
+};
+
+exports.ValidationErrorReason = ValidationErrorReason;
+exports.ValidationIssue = ValidationIssue;
+exports.ValidationResult = ValidationResult;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/validation/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/validation/validation-error-reason.ts","../../src/primitives-defaults.ts","../../src/validation/validation-issue.ts","../../src/validation/validation-result.ts"],"names":[],"mappings":";;;AAMO,IAAM,qBAAA,GAAwB;AAAA;AAAA,EAEnC,YAAA,EAAc,cAAA;AAAA,EACd,YAAA,EAAc,cAAA;AAAA,EACd,aAAA,EAAe,eAAA;AAAA,EACf,aAAA,EAAe,eAAA;AAAA,EACf,aAAA,EAAe,eAAA;AAAA,EACf,iBAAA,EAAmB,mBAAA;AAAA,EACnB,iBAAA,EAAmB,mBAAA;AAAA;AAAA,EAGnB,oBAAA,EAAsB,sBAAA;AAAA,EACtB,qBAAA,EAAuB,uBAAA;AAAA,EACvB,2BAAA,EAA6B,6BAAA;AAAA,EAC7B,qBAAA,EAAuB,uBAAA;AAAA;AAAA,EAGvB,WAAA,EAAa,aAAA;AAAA,EACb,aAAA,EAAe,eAAA;AAAA,EACf,oBAAA,EAAsB,sBAAA;AAAA;AAAA,EAGtB,kBAAA,EAAoB,oBAAA;AAAA,EACpB,oBAAA,EAAsB,sBAAA;AAAA,EACtB,uBAAA,EAAyB,yBAAA;AAAA;AAAA,EAGzB,kBAAA,EAAoB,oBAAA;AAAA;AAAA,EAGpB,aAAA,EAAe,eAAA;AAAA,EACf,gBAAA,EAAkB,kBAAA;AAAA,EAClB,aAAA,EAAe;AACjB;AC7BA,IAAM,kBAAA,GAAqB,OAAA;AAW3B,IAAM,KAAA,GAAiC;AAAA,EAErC,SAAA,EAAW,kBAGb,CAAA;AAWO,IAAM,kBAAA,GAAqB;AAAA,EA4ChC;AAAA;AAAA;AAAA;AAAA,EAMA,IAAI,wBAAA,GAAoC;AACtC,IAAA,MAAM,IAAA,GAAO,MAAM,SAAA,CAAU,WAAA,GAAc,KAAA,CAAM,GAAG,EAAE,CAAC,CAAA;AACvD,IAAA,OAAO,IAAA,KAAS,IAAA;AAAA,EAClB,CASF,CAAA;;;AC3FO,IAAM,kBAAN,MAAsB;AAAA,EAClB,MAAA;AAAA,EACA,kBAAA;AAAA,EACA,oBAAA;AAAA,EAET,WAAA,CACE,MAAA,EACA,kBAAA,EACA,oBAAA,EACA;AACA,IAAA,IAAA,CAAK,MAAA,GAAS,MAAA;AACd,IAAA,IAAA,CAAK,kBAAA,GAAqB,kBAAA;AAC1B,IAAA,IAAA,CAAK,oBAAA,GAAuB,oBAAA;AAAA,EAC9B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,IAAI,WAAA,GAAsB;AACxB,IAAA,OAAO,kBAAA,CAAmB,wBAAA,GACtB,IAAA,CAAK,oBAAA,GACL,IAAA,CAAK,kBAAA;AAAA,EACX;AACF;;;ACzBO,IAAM,mBAAN,MAAuB;AAAA,EACnB,QAAA;AAAA,EACA,OAAA;AAAA,EACA,MAAA;AAAA;AAAA,EAGT,WAAA,CACE,QAAA,EACA,OAAA,EACA,MAAA,EACA;AACA,IAAA,IAAA,CAAK,WAAW,QAAA,IAAY,IAAA;AAC5B,IAAA,IAAA,CAAK,OAAA,GAAU,OAAA;AACf,IAAA,IAAA,CAAK,SAAS,MAAA,CAAO,MAAA,CAAO,CAAC,GAAG,MAAM,CAAC,CAAA;AAAA,EACzC;AACF","file":"index.cjs","sourcesContent":["/**\n * Describes why a value failed validation. Shared across all types that support\n * the `validate` method. Not every reason applies to every type.\n *\n * Maps 1:1 to the .NET `ValidationErrorReason` enum.\n */\nexport const ValidationErrorReason = {\n  // --- Common ---\n  InputIsEmpty: \"InputIsEmpty\",\n  InputTooLong: \"InputTooLong\",\n  InputTooShort: \"InputTooShort\",\n  InvalidLength: \"InvalidLength\",\n  InvalidFormat: \"InvalidFormat\",\n  InvalidCharacters: \"InvalidCharacters\",\n  InvalidCheckDigit: \"InvalidCheckDigit\",\n\n  // --- Banking / clearing ---\n  UnknownClearingRange: \"UnknownClearingRange\",\n  InvalidSwedbankFormat: \"InvalidSwedbankFormat\",\n  InvalidAccountLengthForBank: \"InvalidAccountLengthForBank\",\n  InvalidClearingNumber: \"InvalidClearingNumber\",\n\n  // --- Identity / organization ---\n  InvalidDate: \"InvalidDate\",\n  InvalidPrefix: \"InvalidPrefix\",\n  InvalidEntityPattern: \"InvalidEntityPattern\",\n\n  // --- International / country ---\n  UnknownCountryCode: \"UnknownCountryCode\",\n  InvalidCountryPrefix: \"InvalidCountryPrefix\",\n  InvalidLengthForCountry: \"InvalidLengthForCountry\",\n\n  // --- OCR ---\n  InvalidLengthDigit: \"InvalidLengthDigit\",\n\n  // --- Email ---\n  MissingAtSign: \"MissingAtSign\",\n  InvalidLocalPart: \"InvalidLocalPart\",\n  InvalidDomain: \"InvalidDomain\",\n} as const;\n\nexport type ValidationErrorReason =\n  (typeof ValidationErrorReason)[keyof typeof ValidationErrorReason];\n","/**\n * Configurable defaults that control locale-sensitive behaviour across all\n * primitive types. When not explicitly set, values fall back to safe Swedish\n * defaults (the .NET version derives them from `CultureInfo.CurrentCulture`,\n * which has no direct equivalent in standard JavaScript).\n *\n * Set properties at application startup or override per-request as needed.\n */\n\nconst DEFAULT_CULTURE = \"sv-SE\";\nconst DEFAULT_UI_CULTURE = \"sv-SE\";\nconst DEFAULT_COUNTRY = \"SE\";\nconst DEFAULT_CALLING_CODE = \"46\";\n\ninterface PrimitivesDefaultsState {\n  culture: string;\n  uiCulture: string;\n  countryAlpha2Code: string;\n  defaultCallingCode: string;\n}\n\nconst state: PrimitivesDefaultsState = {\n  culture: DEFAULT_CULTURE,\n  uiCulture: DEFAULT_UI_CULTURE,\n  countryAlpha2Code: DEFAULT_COUNTRY,\n  defaultCallingCode: DEFAULT_CALLING_CODE,\n};\n\n/**\n * Configurable global defaults for locale, UI language, and default country.\n *\n * These mirror the .NET `PrimitivesDefaults` static class. `culture` controls\n * formatting and casing (Swedish-aware character handling for `Å`/`Ä`/`Ö`),\n * `uiCulture` controls display-name language selection (Swedish vs English),\n * and `countryAlpha2Code` is used as the default ISO 3166-1 alpha-2 country\n * when no explicit country is supplied.\n */\nexport const PrimitivesDefaults = {\n  /**\n   * BCP-47 locale tag used for casing and number formatting.\n   * Defaults to `'sv-SE'`.\n   */\n  get culture(): string {\n    return state.culture;\n  },\n  set culture(value: string) {\n    state.culture = value;\n  },\n\n  /**\n   * BCP-47 locale tag used for display-name language selection.\n   * Defaults to `'sv-SE'`.\n   */\n  get uiCulture(): string {\n    return state.uiCulture;\n  },\n  set uiCulture(value: string) {\n    state.uiCulture = value;\n  },\n\n  /**\n   * Default ISO 3166-1 alpha-2 country code. Used by types like\n   * `PhoneNumber` and `SwedishOrganizationIdentifierParser` when no explicit\n   * country is supplied. Defaults to `'SE'`.\n   */\n  get countryAlpha2Code(): string {\n    return state.countryAlpha2Code;\n  },\n  set countryAlpha2Code(value: string) {\n    state.countryAlpha2Code = value;\n  },\n\n  /**\n   * Default phone calling code (digits only, no `+`). Used by {@link PhoneNumber}\n   * for inputs without an explicit country prefix. Defaults to `'46'` (Sweden).\n   */\n  get defaultCallingCode(): string {\n    return state.defaultCallingCode;\n  },\n  set defaultCallingCode(value: string) {\n    state.defaultCallingCode = value;\n  },\n\n  /**\n   * `true` when {@link uiCulture} is Swedish (`sv` or `sv-*`).\n   * Types use this to select between localized and English display names.\n   */\n  get useLocalizedDisplayNames(): boolean {\n    const lang = state.uiCulture.toLowerCase().split(\"-\")[0];\n    return lang === \"sv\";\n  },\n\n  /** Resets all overrides to the package defaults. */\n  reset(): void {\n    state.culture = DEFAULT_CULTURE;\n    state.uiCulture = DEFAULT_UI_CULTURE;\n    state.countryAlpha2Code = DEFAULT_COUNTRY;\n    state.defaultCallingCode = DEFAULT_CALLING_CODE;\n  },\n};\n","import { PrimitivesDefaults } from \"../primitives-defaults.js\";\nimport { ValidationErrorReason } from \"./validation-error-reason.js\";\n\n/**\n * A single validation problem detected during `validate`, carrying a\n * machine-readable {@link reason} and human-readable descriptions in English\n * and the current locale.\n */\nexport class ValidationIssue {\n  readonly reason: ValidationErrorReason;\n  readonly englishDescription: string;\n  readonly localizedDescription: string;\n\n  constructor(\n    reason: ValidationErrorReason,\n    englishDescription: string,\n    localizedDescription: string,\n  ) {\n    this.reason = reason;\n    this.englishDescription = englishDescription;\n    this.localizedDescription = localizedDescription;\n  }\n\n  /**\n   * Returns {@link localizedDescription} when\n   * {@link PrimitivesDefaults.useLocalizedDisplayNames} is `true`, otherwise\n   * {@link englishDescription}.\n   */\n  get description(): string {\n    return PrimitivesDefaults.useLocalizedDisplayNames\n      ? this.localizedDescription\n      : this.englishDescription;\n  }\n}\n","import { ValidationIssue } from \"./validation-issue.js\";\nimport { ValidationErrorReason } from \"./validation-error-reason.js\";\n\n/**\n * The outcome of a `validate` call, carrying the original input, a validity\n * flag, and zero or more {@link ValidationIssue} entries that explain why the\n * input is invalid.\n */\nexport class ValidationResult {\n  readonly rawInput: string | null;\n  readonly isValid: boolean;\n  readonly issues: readonly ValidationIssue[];\n\n  /** @internal — use `validResult` / `invalidResult` factories. */\n  constructor(\n    rawInput: string | null | undefined,\n    isValid: boolean,\n    issues: readonly ValidationIssue[],\n  ) {\n    this.rawInput = rawInput ?? null;\n    this.isValid = isValid;\n    this.issues = Object.freeze([...issues]);\n  }\n}\n\n/** @internal Factory for `validate` implementations. Not part of the public API. */\nexport function validResult(rawInput: string | null | undefined): ValidationResult {\n  return new ValidationResult(rawInput, true, []);\n}\n\n/** @internal Factory for `validate` implementations. Not part of the public API. */\nexport function invalidResult(\n  rawInput: string | null | undefined,\n  reasonOrIssues: ValidationErrorReason | readonly ValidationIssue[],\n  englishDescription?: string,\n  localizedDescription?: string,\n): ValidationResult {\n  if (typeof reasonOrIssues === \"string\") {\n    if (englishDescription === undefined || localizedDescription === undefined) {\n      throw new Error(\"invalidResult requires both english and localized descriptions\");\n    }\n    return new ValidationResult(rawInput, false, [\n      new ValidationIssue(reasonOrIssues, englishDescription, localizedDescription),\n    ]);\n  }\n  return new ValidationResult(rawInput, false, reasonOrIssues);\n}\n"]}

package/dist/validation/index.d.cts

@@ -0,0 +1,63 @@
+/**
+ * Describes why a value failed validation. Shared across all types that support
+ * the `validate` method. Not every reason applies to every type.
+ *
+ * Maps 1:1 to the .NET `ValidationErrorReason` enum.
+ */
+declare const ValidationErrorReason: {
+    readonly InputIsEmpty: "InputIsEmpty";
+    readonly InputTooLong: "InputTooLong";
+    readonly InputTooShort: "InputTooShort";
+    readonly InvalidLength: "InvalidLength";
+    readonly InvalidFormat: "InvalidFormat";
+    readonly InvalidCharacters: "InvalidCharacters";
+    readonly InvalidCheckDigit: "InvalidCheckDigit";
+    readonly UnknownClearingRange: "UnknownClearingRange";
+    readonly InvalidSwedbankFormat: "InvalidSwedbankFormat";
+    readonly InvalidAccountLengthForBank: "InvalidAccountLengthForBank";
+    readonly InvalidClearingNumber: "InvalidClearingNumber";
+    readonly InvalidDate: "InvalidDate";
+    readonly InvalidPrefix: "InvalidPrefix";
+    readonly InvalidEntityPattern: "InvalidEntityPattern";
+    readonly UnknownCountryCode: "UnknownCountryCode";
+    readonly InvalidCountryPrefix: "InvalidCountryPrefix";
+    readonly InvalidLengthForCountry: "InvalidLengthForCountry";
+    readonly InvalidLengthDigit: "InvalidLengthDigit";
+    readonly MissingAtSign: "MissingAtSign";
+    readonly InvalidLocalPart: "InvalidLocalPart";
+    readonly InvalidDomain: "InvalidDomain";
+};
+type ValidationErrorReason = (typeof ValidationErrorReason)[keyof typeof ValidationErrorReason];
+
+/**
+ * A single validation problem detected during `validate`, carrying a
+ * machine-readable {@link reason} and human-readable descriptions in English
+ * and the current locale.
+ */
+declare class ValidationIssue {
+    readonly reason: ValidationErrorReason;
+    readonly englishDescription: string;
+    readonly localizedDescription: string;
+    constructor(reason: ValidationErrorReason, englishDescription: string, localizedDescription: string);
+    /**
+     * Returns {@link localizedDescription} when
+     * {@link PrimitivesDefaults.useLocalizedDisplayNames} is `true`, otherwise
+     * {@link englishDescription}.
+     */
+    get description(): string;
+}
+
+/**
+ * The outcome of a `validate` call, carrying the original input, a validity
+ * flag, and zero or more {@link ValidationIssue} entries that explain why the
+ * input is invalid.
+ */
+declare class ValidationResult {
+    readonly rawInput: string | null;
+    readonly isValid: boolean;
+    readonly issues: readonly ValidationIssue[];
+    /** @internal — use `validResult` / `invalidResult` factories. */
+    constructor(rawInput: string | null | undefined, isValid: boolean, issues: readonly ValidationIssue[]);
+}
+
+export { ValidationErrorReason, ValidationIssue, ValidationResult };

package/dist/validation/index.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Describes why a value failed validation. Shared across all types that support
+ * the `validate` method. Not every reason applies to every type.
+ *
+ * Maps 1:1 to the .NET `ValidationErrorReason` enum.
+ */
+declare const ValidationErrorReason: {
+    readonly InputIsEmpty: "InputIsEmpty";
+    readonly InputTooLong: "InputTooLong";
+    readonly InputTooShort: "InputTooShort";
+    readonly InvalidLength: "InvalidLength";
+    readonly InvalidFormat: "InvalidFormat";
+    readonly InvalidCharacters: "InvalidCharacters";
+    readonly InvalidCheckDigit: "InvalidCheckDigit";
+    readonly UnknownClearingRange: "UnknownClearingRange";
+    readonly InvalidSwedbankFormat: "InvalidSwedbankFormat";
+    readonly InvalidAccountLengthForBank: "InvalidAccountLengthForBank";
+    readonly InvalidClearingNumber: "InvalidClearingNumber";
+    readonly InvalidDate: "InvalidDate";
+    readonly InvalidPrefix: "InvalidPrefix";
+    readonly InvalidEntityPattern: "InvalidEntityPattern";
+    readonly UnknownCountryCode: "UnknownCountryCode";
+    readonly InvalidCountryPrefix: "InvalidCountryPrefix";
+    readonly InvalidLengthForCountry: "InvalidLengthForCountry";
+    readonly InvalidLengthDigit: "InvalidLengthDigit";
+    readonly MissingAtSign: "MissingAtSign";
+    readonly InvalidLocalPart: "InvalidLocalPart";
+    readonly InvalidDomain: "InvalidDomain";
+};
+type ValidationErrorReason = (typeof ValidationErrorReason)[keyof typeof ValidationErrorReason];
+
+/**
+ * A single validation problem detected during `validate`, carrying a
+ * machine-readable {@link reason} and human-readable descriptions in English
+ * and the current locale.
+ */
+declare class ValidationIssue {
+    readonly reason: ValidationErrorReason;
+    readonly englishDescription: string;
+    readonly localizedDescription: string;
+    constructor(reason: ValidationErrorReason, englishDescription: string, localizedDescription: string);
+    /**
+     * Returns {@link localizedDescription} when
+     * {@link PrimitivesDefaults.useLocalizedDisplayNames} is `true`, otherwise
+     * {@link englishDescription}.
+     */
+    get description(): string;
+}
+
+/**
+ * The outcome of a `validate` call, carrying the original input, a validity
+ * flag, and zero or more {@link ValidationIssue} entries that explain why the
+ * input is invalid.
+ */
+declare class ValidationResult {
+    readonly rawInput: string | null;
+    readonly isValid: boolean;
+    readonly issues: readonly ValidationIssue[];
+    /** @internal — use `validResult` / `invalidResult` factories. */
+    constructor(rawInput: string | null | undefined, isValid: boolean, issues: readonly ValidationIssue[]);
+}
+
+export { ValidationErrorReason, ValidationIssue, ValidationResult };

package/dist/validation/index.js

@@ -0,0 +1,79 @@
+// src/validation/validation-error-reason.ts
+var ValidationErrorReason = {
+  // --- Common ---
+  InputIsEmpty: "InputIsEmpty",
+  InputTooLong: "InputTooLong",
+  InputTooShort: "InputTooShort",
+  InvalidLength: "InvalidLength",
+  InvalidFormat: "InvalidFormat",
+  InvalidCharacters: "InvalidCharacters",
+  InvalidCheckDigit: "InvalidCheckDigit",
+  // --- Banking / clearing ---
+  UnknownClearingRange: "UnknownClearingRange",
+  InvalidSwedbankFormat: "InvalidSwedbankFormat",
+  InvalidAccountLengthForBank: "InvalidAccountLengthForBank",
+  InvalidClearingNumber: "InvalidClearingNumber",
+  // --- Identity / organization ---
+  InvalidDate: "InvalidDate",
+  InvalidPrefix: "InvalidPrefix",
+  InvalidEntityPattern: "InvalidEntityPattern",
+  // --- International / country ---
+  UnknownCountryCode: "UnknownCountryCode",
+  InvalidCountryPrefix: "InvalidCountryPrefix",
+  InvalidLengthForCountry: "InvalidLengthForCountry",
+  // --- OCR ---
+  InvalidLengthDigit: "InvalidLengthDigit",
+  // --- Email ---
+  MissingAtSign: "MissingAtSign",
+  InvalidLocalPart: "InvalidLocalPart",
+  InvalidDomain: "InvalidDomain"
+};
+var DEFAULT_UI_CULTURE = "sv-SE";
+var state = {
+  uiCulture: DEFAULT_UI_CULTURE};
+var PrimitivesDefaults = {
+  /**
+   * `true` when {@link uiCulture} is Swedish (`sv` or `sv-*`).
+   * Types use this to select between localized and English display names.
+   */
+  get useLocalizedDisplayNames() {
+    const lang = state.uiCulture.toLowerCase().split("-")[0];
+    return lang === "sv";
+  }};
+
+// src/validation/validation-issue.ts
+var ValidationIssue = class {
+  reason;
+  englishDescription;
+  localizedDescription;
+  constructor(reason, englishDescription, localizedDescription) {
+    this.reason = reason;
+    this.englishDescription = englishDescription;
+    this.localizedDescription = localizedDescription;
+  }
+  /**
+   * Returns {@link localizedDescription} when
+   * {@link PrimitivesDefaults.useLocalizedDisplayNames} is `true`, otherwise
+   * {@link englishDescription}.
+   */
+  get description() {
+    return PrimitivesDefaults.useLocalizedDisplayNames ? this.localizedDescription : this.englishDescription;
+  }
+};
+
+// src/validation/validation-result.ts
+var ValidationResult = class {
+  rawInput;
+  isValid;
+  issues;
+  /** @internal — use `validResult` / `invalidResult` factories. */
+  constructor(rawInput, isValid, issues) {
+    this.rawInput = rawInput ?? null;
+    this.isValid = isValid;
+    this.issues = Object.freeze([...issues]);
+  }
+};
+
+export { ValidationErrorReason, ValidationIssue, ValidationResult };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/validation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/validation/validation-error-reason.ts","../../src/primitives-defaults.ts","../../src/validation/validation-issue.ts","../../src/validation/validation-result.ts"],"names":[],"mappings":";AAMO,IAAM,qBAAA,GAAwB;AAAA;AAAA,EAEnC,YAAA,EAAc,cAAA;AAAA,EACd,YAAA,EAAc,cAAA;AAAA,EACd,aAAA,EAAe,eAAA;AAAA,EACf,aAAA,EAAe,eAAA;AAAA,EACf,aAAA,EAAe,eAAA;AAAA,EACf,iBAAA,EAAmB,mBAAA;AAAA,EACnB,iBAAA,EAAmB,mBAAA;AAAA;AAAA,EAGnB,oBAAA,EAAsB,sBAAA;AAAA,EACtB,qBAAA,EAAuB,uBAAA;AAAA,EACvB,2BAAA,EAA6B,6BAAA;AAAA,EAC7B,qBAAA,EAAuB,uBAAA;AAAA;AAAA,EAGvB,WAAA,EAAa,aAAA;AAAA,EACb,aAAA,EAAe,eAAA;AAAA,EACf,oBAAA,EAAsB,sBAAA;AAAA;AAAA,EAGtB,kBAAA,EAAoB,oBAAA;AAAA,EACpB,oBAAA,EAAsB,sBAAA;AAAA,EACtB,uBAAA,EAAyB,yBAAA;AAAA;AAAA,EAGzB,kBAAA,EAAoB,oBAAA;AAAA;AAAA,EAGpB,aAAA,EAAe,eAAA;AAAA,EACf,gBAAA,EAAkB,kBAAA;AAAA,EAClB,aAAA,EAAe;AACjB;AC7BA,IAAM,kBAAA,GAAqB,OAAA;AAW3B,IAAM,KAAA,GAAiC;AAAA,EAErC,SAAA,EAAW,kBAGb,CAAA;AAWO,IAAM,kBAAA,GAAqB;AAAA,EA4ChC;AAAA;AAAA;AAAA;AAAA,EAMA,IAAI,wBAAA,GAAoC;AACtC,IAAA,MAAM,IAAA,GAAO,MAAM,SAAA,CAAU,WAAA,GAAc,KAAA,CAAM,GAAG,EAAE,CAAC,CAAA;AACvD,IAAA,OAAO,IAAA,KAAS,IAAA;AAAA,EAClB,CASF,CAAA;;;AC3FO,IAAM,kBAAN,MAAsB;AAAA,EAClB,MAAA;AAAA,EACA,kBAAA;AAAA,EACA,oBAAA;AAAA,EAET,WAAA,CACE,MAAA,EACA,kBAAA,EACA,oBAAA,EACA;AACA,IAAA,IAAA,CAAK,MAAA,GAAS,MAAA;AACd,IAAA,IAAA,CAAK,kBAAA,GAAqB,kBAAA;AAC1B,IAAA,IAAA,CAAK,oBAAA,GAAuB,oBAAA;AAAA,EAC9B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,IAAI,WAAA,GAAsB;AACxB,IAAA,OAAO,kBAAA,CAAmB,wBAAA,GACtB,IAAA,CAAK,oBAAA,GACL,IAAA,CAAK,kBAAA;AAAA,EACX;AACF;;;ACzBO,IAAM,mBAAN,MAAuB;AAAA,EACnB,QAAA;AAAA,EACA,OAAA;AAAA,EACA,MAAA;AAAA;AAAA,EAGT,WAAA,CACE,QAAA,EACA,OAAA,EACA,MAAA,EACA;AACA,IAAA,IAAA,CAAK,WAAW,QAAA,IAAY,IAAA;AAC5B,IAAA,IAAA,CAAK,OAAA,GAAU,OAAA;AACf,IAAA,IAAA,CAAK,SAAS,MAAA,CAAO,MAAA,CAAO,CAAC,GAAG,MAAM,CAAC,CAAA;AAAA,EACzC;AACF","file":"index.js","sourcesContent":["/**\n * Describes why a value failed validation. Shared across all types that support\n * the `validate` method. Not every reason applies to every type.\n *\n * Maps 1:1 to the .NET `ValidationErrorReason` enum.\n */\nexport const ValidationErrorReason = {\n  // --- Common ---\n  InputIsEmpty: \"InputIsEmpty\",\n  InputTooLong: \"InputTooLong\",\n  InputTooShort: \"InputTooShort\",\n  InvalidLength: \"InvalidLength\",\n  InvalidFormat: \"InvalidFormat\",\n  InvalidCharacters: \"InvalidCharacters\",\n  InvalidCheckDigit: \"InvalidCheckDigit\",\n\n  // --- Banking / clearing ---\n  UnknownClearingRange: \"UnknownClearingRange\",\n  InvalidSwedbankFormat: \"InvalidSwedbankFormat\",\n  InvalidAccountLengthForBank: \"InvalidAccountLengthForBank\",\n  InvalidClearingNumber: \"InvalidClearingNumber\",\n\n  // --- Identity / organization ---\n  InvalidDate: \"InvalidDate\",\n  InvalidPrefix: \"InvalidPrefix\",\n  InvalidEntityPattern: \"InvalidEntityPattern\",\n\n  // --- International / country ---\n  UnknownCountryCode: \"UnknownCountryCode\",\n  InvalidCountryPrefix: \"InvalidCountryPrefix\",\n  InvalidLengthForCountry: \"InvalidLengthForCountry\",\n\n  // --- OCR ---\n  InvalidLengthDigit: \"InvalidLengthDigit\",\n\n  // --- Email ---\n  MissingAtSign: \"MissingAtSign\",\n  InvalidLocalPart: \"InvalidLocalPart\",\n  InvalidDomain: \"InvalidDomain\",\n} as const;\n\nexport type ValidationErrorReason =\n  (typeof ValidationErrorReason)[keyof typeof ValidationErrorReason];\n","/**\n * Configurable defaults that control locale-sensitive behaviour across all\n * primitive types. When not explicitly set, values fall back to safe Swedish\n * defaults (the .NET version derives them from `CultureInfo.CurrentCulture`,\n * which has no direct equivalent in standard JavaScript).\n *\n * Set properties at application startup or override per-request as needed.\n */\n\nconst DEFAULT_CULTURE = \"sv-SE\";\nconst DEFAULT_UI_CULTURE = \"sv-SE\";\nconst DEFAULT_COUNTRY = \"SE\";\nconst DEFAULT_CALLING_CODE = \"46\";\n\ninterface PrimitivesDefaultsState {\n  culture: string;\n  uiCulture: string;\n  countryAlpha2Code: string;\n  defaultCallingCode: string;\n}\n\nconst state: PrimitivesDefaultsState = {\n  culture: DEFAULT_CULTURE,\n  uiCulture: DEFAULT_UI_CULTURE,\n  countryAlpha2Code: DEFAULT_COUNTRY,\n  defaultCallingCode: DEFAULT_CALLING_CODE,\n};\n\n/**\n * Configurable global defaults for locale, UI language, and default country.\n *\n * These mirror the .NET `PrimitivesDefaults` static class. `culture` controls\n * formatting and casing (Swedish-aware character handling for `Å`/`Ä`/`Ö`),\n * `uiCulture` controls display-name language selection (Swedish vs English),\n * and `countryAlpha2Code` is used as the default ISO 3166-1 alpha-2 country\n * when no explicit country is supplied.\n */\nexport const PrimitivesDefaults = {\n  /**\n   * BCP-47 locale tag used for casing and number formatting.\n   * Defaults to `'sv-SE'`.\n   */\n  get culture(): string {\n    return state.culture;\n  },\n  set culture(value: string) {\n    state.culture = value;\n  },\n\n  /**\n   * BCP-47 locale tag used for display-name language selection.\n   * Defaults to `'sv-SE'`.\n   */\n  get uiCulture(): string {\n    return state.uiCulture;\n  },\n  set uiCulture(value: string) {\n    state.uiCulture = value;\n  },\n\n  /**\n   * Default ISO 3166-1 alpha-2 country code. Used by types like\n   * `PhoneNumber` and `SwedishOrganizationIdentifierParser` when no explicit\n   * country is supplied. Defaults to `'SE'`.\n   */\n  get countryAlpha2Code(): string {\n    return state.countryAlpha2Code;\n  },\n  set countryAlpha2Code(value: string) {\n    state.countryAlpha2Code = value;\n  },\n\n  /**\n   * Default phone calling code (digits only, no `+`). Used by {@link PhoneNumber}\n   * for inputs without an explicit country prefix. Defaults to `'46'` (Sweden).\n   */\n  get defaultCallingCode(): string {\n    return state.defaultCallingCode;\n  },\n  set defaultCallingCode(value: string) {\n    state.defaultCallingCode = value;\n  },\n\n  /**\n   * `true` when {@link uiCulture} is Swedish (`sv` or `sv-*`).\n   * Types use this to select between localized and English display names.\n   */\n  get useLocalizedDisplayNames(): boolean {\n    const lang = state.uiCulture.toLowerCase().split(\"-\")[0];\n    return lang === \"sv\";\n  },\n\n  /** Resets all overrides to the package defaults. */\n  reset(): void {\n    state.culture = DEFAULT_CULTURE;\n    state.uiCulture = DEFAULT_UI_CULTURE;\n    state.countryAlpha2Code = DEFAULT_COUNTRY;\n    state.defaultCallingCode = DEFAULT_CALLING_CODE;\n  },\n};\n","import { PrimitivesDefaults } from \"../primitives-defaults.js\";\nimport { ValidationErrorReason } from \"./validation-error-reason.js\";\n\n/**\n * A single validation problem detected during `validate`, carrying a\n * machine-readable {@link reason} and human-readable descriptions in English\n * and the current locale.\n */\nexport class ValidationIssue {\n  readonly reason: ValidationErrorReason;\n  readonly englishDescription: string;\n  readonly localizedDescription: string;\n\n  constructor(\n    reason: ValidationErrorReason,\n    englishDescription: string,\n    localizedDescription: string,\n  ) {\n    this.reason = reason;\n    this.englishDescription = englishDescription;\n    this.localizedDescription = localizedDescription;\n  }\n\n  /**\n   * Returns {@link localizedDescription} when\n   * {@link PrimitivesDefaults.useLocalizedDisplayNames} is `true`, otherwise\n   * {@link englishDescription}.\n   */\n  get description(): string {\n    return PrimitivesDefaults.useLocalizedDisplayNames\n      ? this.localizedDescription\n      : this.englishDescription;\n  }\n}\n","import { ValidationIssue } from \"./validation-issue.js\";\nimport { ValidationErrorReason } from \"./validation-error-reason.js\";\n\n/**\n * The outcome of a `validate` call, carrying the original input, a validity\n * flag, and zero or more {@link ValidationIssue} entries that explain why the\n * input is invalid.\n */\nexport class ValidationResult {\n  readonly rawInput: string | null;\n  readonly isValid: boolean;\n  readonly issues: readonly ValidationIssue[];\n\n  /** @internal — use `validResult` / `invalidResult` factories. */\n  constructor(\n    rawInput: string | null | undefined,\n    isValid: boolean,\n    issues: readonly ValidationIssue[],\n  ) {\n    this.rawInput = rawInput ?? null;\n    this.isValid = isValid;\n    this.issues = Object.freeze([...issues]);\n  }\n}\n\n/** @internal Factory for `validate` implementations. Not part of the public API. */\nexport function validResult(rawInput: string | null | undefined): ValidationResult {\n  return new ValidationResult(rawInput, true, []);\n}\n\n/** @internal Factory for `validate` implementations. Not part of the public API. */\nexport function invalidResult(\n  rawInput: string | null | undefined,\n  reasonOrIssues: ValidationErrorReason | readonly ValidationIssue[],\n  englishDescription?: string,\n  localizedDescription?: string,\n): ValidationResult {\n  if (typeof reasonOrIssues === \"string\") {\n    if (englishDescription === undefined || localizedDescription === undefined) {\n      throw new Error(\"invalidResult requires both english and localized descriptions\");\n    }\n    return new ValidationResult(rawInput, false, [\n      new ValidationIssue(reasonOrIssues, englishDescription, localizedDescription),\n    ]);\n  }\n  return new ValidationResult(rawInput, false, reasonOrIssues);\n}\n"]}