marc-ts 0.1.0 → 0.4.2

package/dist/serializer.d.ts

@@ -1,4 +1,4 @@
-import { MarcRecord, MarcWarning } from './types';
+import { MarcRecord, SerializeBatchResult } from './types';
 /**
  * Options for serializing MARC records.
  */
@@ -11,47 +11,26 @@ export interface SerializeOptions {
      *   to ASCII plus ANSEL Latin/combining characters.
      */
     readonly encoding?: 'utf8' | 'marc8';
+    /**
+     * Maximum number of warnings to collect per record before stopping.
+     * Default: 100
+     */
+    readonly maxWarnings?: number;
 }
 /**
- * Serialize a MARC record to ISO2709 binary format.
- *
- * @param record - The MARC record to serialize
- * @returns Binary representation of the record (Uint8Array for browser compatibility)
+ * Serialize an array of MARC records to a concatenated ISO2709 binary stream.
  *
- * @example
- * ```typescript
- * const record: MarcRecord = {
- *   leader: '00000nam  2200000   4500',
- *   fields: [
- *     { tag: '001', data: 'ocm12345678' },
- *     {
- *       tag: '245',
- *       indicator1: '1',
- *       indicator2: '0',
- *       subfields: [{ code: 'a', value: 'Title' }],
- *     },
- *   ],
- * };
+ * Each record is individually serialized (with its own 0x1D terminator) and
+ * the results are concatenated into a single Uint8Array.
  *
- * const buffer = serializeMarcRecord(record);
- * // Can now be written to file or transmitted
- * ```
+ * @param records - MARC records to serialize
+ * @param options - Encoding options forwarded to the per-record serializer
+ * @returns Concatenated binary representation of all records
  */
-export declare function serializeMarcRecord(record: MarcRecord, options?: SerializeOptions): Uint8Array;
-/**
- * Result of {@link serializeMarcRecordWithWarnings}: the serialized bytes
- * along with any warnings generated by the encoder (e.g. lossy MARC-8
- * substitutions).
- */
-export interface SerializeResult {
-    readonly bytes: Uint8Array;
-    readonly warnings: readonly MarcWarning[];
-}
+export declare function serializeMarcBinary(records: MarcRecord[], options?: SerializeOptions): Uint8Array;
 /**
- * Serialize a MARC record and surface any warnings generated by the encoder.
- * Use this when you need programmatic visibility into lossy encodings — for
- * example, MARC-8 output of records containing characters with no MARC-8
- * equivalent.
+ * Serialize an array of MARC records to a concatenated ISO2709 binary
+ * stream, returning per-record serialization warnings.
  */
-export declare function serializeMarcRecordWithWarnings(record: MarcRecord, options?: SerializeOptions): SerializeResult;
+export declare function serializeMarcBinaryWithWarnings(records: MarcRecord[], options?: SerializeOptions): SerializeBatchResult;
 //# sourceMappingURL=serializer.d.ts.map

package/dist/{types-c4Mo9m9u.js → types-BMKDHD1l.js}

@@ -9,4 +9,4 @@ export {
   i as t
 };
 
-//# sourceMappingURL=types-c4Mo9m9u.js.map
+//# sourceMappingURL=types-BMKDHD1l.js.map

package/dist/types-BMKDHD1l.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-BMKDHD1l.js","names":[],"sources":["../src/types.ts"],"sourcesContent":["/**\n * Core type definitions for MARC21 records.\n * All types use readonly modifiers to enforce immutability.\n */\n\n/**\n * A subfield within a MARC data field.\n * Contains a single-character code and its associated value.\n *\n * @example\n * ```typescript\n * const subfield: Subfield = { code: 'a', value: 'The Catcher in the Rye' };\n * ```\n */\nexport interface Subfield {\n  readonly code: string;\n  readonly value: string;\n}\n\n/**\n * A MARC control field (tag 00X).\n * Control fields have no indicators or subfields, only a tag and data.\n *\n * @example\n * ```typescript\n * const controlField: ControlField = { tag: '001', data: 'ocm12345678' };\n * ```\n */\nexport interface ControlField {\n  readonly tag: string;\n  readonly data: string;\n}\n\n/**\n * A MARC data field (tag 01X-9XX).\n * Data fields have a tag, two indicators, and one or more subfields.\n *\n * @example\n * ```typescript\n * const dataField: DataField = {\n *   tag: '245',\n *   indicator1: '1',\n *   indicator2: '0',\n *   subfields: [\n *     { code: 'a', value: 'The Catcher in the Rye /' },\n *     { code: 'c', value: 'J.D. Salinger.' },\n *   ],\n * };\n * ```\n */\nexport interface DataField {\n  readonly tag: string;\n  readonly indicator1: string; // Use ' ' for blank indicator\n  readonly indicator2: string; // Use ' ' for blank indicator\n  readonly subfields: readonly Subfield[];\n}\n\n/**\n * A complete MARC21 record.\n * Contains a 24-character leader and an array of fields (control or data fields).\n *\n * @example\n * ```typescript\n * const record: MarcRecord = {\n *   leader: '00000nam  2200000   4500',\n *   fields: [\n *     { tag: '001', data: 'ocm12345678' },\n *     {\n *       tag: '245',\n *       indicator1: '1',\n *       indicator2: '0',\n *       subfields: [{ code: 'a', value: 'Title' }],\n *     },\n *   ],\n * };\n * ```\n */\nexport interface MarcRecord {\n  readonly leader: string; // Always 24 characters\n  readonly fields: readonly (ControlField | DataField)[];\n}\n\n/**\n * Warning type categories for MARC parsing errors.\n */\nexport type MarcWarningType =\n  | 'invalid_leader'\n  | 'invalid_directory'\n  | 'invalid_field'\n  | 'truncated_record'\n  | 'encoding_error'\n  | 'malformed_xml'\n  | 'missing_element'\n  | 'invalid_attribute';\n\n/**\n * A warning generated during MARC record parsing.\n * Warnings indicate non-fatal issues that were encountered and recovered from.\n */\nexport interface MarcWarning {\n  readonly type: MarcWarningType;\n  readonly message: string;\n  readonly position?: number; // Byte position in the record\n  readonly tag?: string; // Field tag associated with the warning\n}\n\n/**\n * Options for parsing MARC records.\n */\nexport interface ParseOptions {\n  /**\n   * If true, throw errors instead of collecting warnings.\n   * Default: false\n   */\n  readonly strict?: boolean;\n\n  /**\n   * Maximum number of warnings to collect before stopping.\n   * Prevents memory issues with severely malformed records.\n   * Default: 100\n   */\n  readonly maxWarnings?: number;\n}\n\n/**\n * Result of parsing a MARC record.\n * Contains the parsed record (if successful) and any warnings encountered.\n */\nexport interface ParseResult {\n  readonly record: MarcRecord | null;\n  readonly warnings: readonly MarcWarning[];\n}\n\n/**\n * Result of parsing multiple MARC records with warning capture.\n * Each entry pairs a parsed record (or null on failure) with its warnings.\n */\nexport interface ParseBatchResult {\n  readonly results: readonly ParseResult[];\n}\n\n/**\n * Result of serializing a single MARC record with warning capture.\n */\nexport interface SerializeRecordResult {\n  readonly bytes: Uint8Array;\n  readonly warnings: readonly MarcWarning[];\n}\n\n/**\n * Result of serializing multiple MARC records with warning capture.\n * Contains the concatenated bytes and per-record results.\n */\nexport interface SerializeBatchResult {\n  readonly bytes: Uint8Array;\n  readonly results: readonly SerializeRecordResult[];\n}\n\n/**\n * Type guard to check if a field is a control field.\n *\n * @param field - The field to check\n * @returns True if the field is a control field\n *\n * @example\n * ```typescript\n * if (isControlField(field)) {\n *   console.log(field.data); // TypeScript knows field is ControlField\n * }\n * ```\n */\nexport function isControlField(field: ControlField | DataField): field is ControlField {\n  return 'data' in field;\n}\n\n/**\n * Type guard to check if a field is a data field.\n *\n * @param field - The field to check\n * @returns True if the field is a data field\n *\n * @example\n * ```typescript\n * if (isDataField(field)) {\n *   console.log(field.subfields); // TypeScript knows field is DataField\n * }\n * ```\n */\nexport function isDataField(field: ControlField | DataField): field is DataField {\n  return 'subfields' in field;\n}\n"],"mappings":"AA2KA,SAAgB,EAAe,GAAwD;AACrF,SAAO,UAAU;AACnB;AAeA,SAAgB,EAAY,GAAqD;AAC/E,SAAO,eAAe;AACxB"}

package/dist/{types-CJcxHJff.cjs → types-CsOhH4OF.cjs}

@@ -1,3 +1,3 @@
 function t(e){return"data"in e}function n(e){return"subfields"in e}Object.defineProperty(exports,"isControlField",{enumerable:!0,get:function(){return t}});Object.defineProperty(exports,"isDataField",{enumerable:!0,get:function(){return n}});
 
-//# sourceMappingURL=types-CJcxHJff.cjs.map
+//# sourceMappingURL=types-CsOhH4OF.cjs.map

package/dist/types-CsOhH4OF.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-CsOhH4OF.cjs","names":[],"sources":["../src/types.ts"],"sourcesContent":["/**\n * Core type definitions for MARC21 records.\n * All types use readonly modifiers to enforce immutability.\n */\n\n/**\n * A subfield within a MARC data field.\n * Contains a single-character code and its associated value.\n *\n * @example\n * ```typescript\n * const subfield: Subfield = { code: 'a', value: 'The Catcher in the Rye' };\n * ```\n */\nexport interface Subfield {\n  readonly code: string;\n  readonly value: string;\n}\n\n/**\n * A MARC control field (tag 00X).\n * Control fields have no indicators or subfields, only a tag and data.\n *\n * @example\n * ```typescript\n * const controlField: ControlField = { tag: '001', data: 'ocm12345678' };\n * ```\n */\nexport interface ControlField {\n  readonly tag: string;\n  readonly data: string;\n}\n\n/**\n * A MARC data field (tag 01X-9XX).\n * Data fields have a tag, two indicators, and one or more subfields.\n *\n * @example\n * ```typescript\n * const dataField: DataField = {\n *   tag: '245',\n *   indicator1: '1',\n *   indicator2: '0',\n *   subfields: [\n *     { code: 'a', value: 'The Catcher in the Rye /' },\n *     { code: 'c', value: 'J.D. Salinger.' },\n *   ],\n * };\n * ```\n */\nexport interface DataField {\n  readonly tag: string;\n  readonly indicator1: string; // Use ' ' for blank indicator\n  readonly indicator2: string; // Use ' ' for blank indicator\n  readonly subfields: readonly Subfield[];\n}\n\n/**\n * A complete MARC21 record.\n * Contains a 24-character leader and an array of fields (control or data fields).\n *\n * @example\n * ```typescript\n * const record: MarcRecord = {\n *   leader: '00000nam  2200000   4500',\n *   fields: [\n *     { tag: '001', data: 'ocm12345678' },\n *     {\n *       tag: '245',\n *       indicator1: '1',\n *       indicator2: '0',\n *       subfields: [{ code: 'a', value: 'Title' }],\n *     },\n *   ],\n * };\n * ```\n */\nexport interface MarcRecord {\n  readonly leader: string; // Always 24 characters\n  readonly fields: readonly (ControlField | DataField)[];\n}\n\n/**\n * Warning type categories for MARC parsing errors.\n */\nexport type MarcWarningType =\n  | 'invalid_leader'\n  | 'invalid_directory'\n  | 'invalid_field'\n  | 'truncated_record'\n  | 'encoding_error'\n  | 'malformed_xml'\n  | 'missing_element'\n  | 'invalid_attribute';\n\n/**\n * A warning generated during MARC record parsing.\n * Warnings indicate non-fatal issues that were encountered and recovered from.\n */\nexport interface MarcWarning {\n  readonly type: MarcWarningType;\n  readonly message: string;\n  readonly position?: number; // Byte position in the record\n  readonly tag?: string; // Field tag associated with the warning\n}\n\n/**\n * Options for parsing MARC records.\n */\nexport interface ParseOptions {\n  /**\n   * If true, throw errors instead of collecting warnings.\n   * Default: false\n   */\n  readonly strict?: boolean;\n\n  /**\n   * Maximum number of warnings to collect before stopping.\n   * Prevents memory issues with severely malformed records.\n   * Default: 100\n   */\n  readonly maxWarnings?: number;\n}\n\n/**\n * Result of parsing a MARC record.\n * Contains the parsed record (if successful) and any warnings encountered.\n */\nexport interface ParseResult {\n  readonly record: MarcRecord | null;\n  readonly warnings: readonly MarcWarning[];\n}\n\n/**\n * Result of parsing multiple MARC records with warning capture.\n * Each entry pairs a parsed record (or null on failure) with its warnings.\n */\nexport interface ParseBatchResult {\n  readonly results: readonly ParseResult[];\n}\n\n/**\n * Result of serializing a single MARC record with warning capture.\n */\nexport interface SerializeRecordResult {\n  readonly bytes: Uint8Array;\n  readonly warnings: readonly MarcWarning[];\n}\n\n/**\n * Result of serializing multiple MARC records with warning capture.\n * Contains the concatenated bytes and per-record results.\n */\nexport interface SerializeBatchResult {\n  readonly bytes: Uint8Array;\n  readonly results: readonly SerializeRecordResult[];\n}\n\n/**\n * Type guard to check if a field is a control field.\n *\n * @param field - The field to check\n * @returns True if the field is a control field\n *\n * @example\n * ```typescript\n * if (isControlField(field)) {\n *   console.log(field.data); // TypeScript knows field is ControlField\n * }\n * ```\n */\nexport function isControlField(field: ControlField | DataField): field is ControlField {\n  return 'data' in field;\n}\n\n/**\n * Type guard to check if a field is a data field.\n *\n * @param field - The field to check\n * @returns True if the field is a data field\n *\n * @example\n * ```typescript\n * if (isDataField(field)) {\n *   console.log(field.subfields); // TypeScript knows field is DataField\n * }\n * ```\n */\nexport function isDataField(field: ControlField | DataField): field is DataField {\n  return 'subfields' in field;\n}\n"],"mappings":"AA2KA,SAAgB,EAAe,EAAwD,CACrF,MAAO,SAAU,CACnB,CAeA,SAAgB,EAAY,EAAqD,CAC/E,MAAO,cAAe,CACxB"}

package/dist/types.d.ts

@@ -78,7 +78,7 @@ export interface MarcRecord {
 /**
  * Warning type categories for MARC parsing errors.
  */
-export type MarcWarningType = 'invalid_leader' | 'invalid_directory' | 'invalid_field' | 'truncated_record' | 'encoding_error';
+export type MarcWarningType = 'invalid_leader' | 'invalid_directory' | 'invalid_field' | 'truncated_record' | 'encoding_error' | 'malformed_xml' | 'missing_element' | 'invalid_attribute';
 /**
  * A warning generated during MARC record parsing.
  * Warnings indicate non-fatal issues that were encountered and recovered from.
@@ -113,6 +113,28 @@ export interface ParseResult {
     readonly record: MarcRecord | null;
     readonly warnings: readonly MarcWarning[];
 }
+/**
+ * Result of parsing multiple MARC records with warning capture.
+ * Each entry pairs a parsed record (or null on failure) with its warnings.
+ */
+export interface ParseBatchResult {
+    readonly results: readonly ParseResult[];
+}
+/**
+ * Result of serializing a single MARC record with warning capture.
+ */
+export interface SerializeRecordResult {
+    readonly bytes: Uint8Array;
+    readonly warnings: readonly MarcWarning[];
+}
+/**
+ * Result of serializing multiple MARC records with warning capture.
+ * Contains the concatenated bytes and per-record results.
+ */
+export interface SerializeBatchResult {
+    readonly bytes: Uint8Array;
+    readonly results: readonly SerializeRecordResult[];
+}
 /**
  * Type guard to check if a field is a control field.
  *

package/dist/warnings-6yoB06xI.cjs

@@ -0,0 +1,3 @@
+function u(e,n,r,t){return{type:e,message:n,position:r,tag:t}}Object.defineProperty(exports,"createWarning",{enumerable:!0,get:function(){return u}});
+
+//# sourceMappingURL=warnings-6yoB06xI.cjs.map

package/dist/warnings-6yoB06xI.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"warnings-6yoB06xI.cjs","names":[],"sources":["../src/warnings.ts"],"sourcesContent":["/**\n * Warning system for MARC parsing.\n * Re-exports types and provides utility functions.\n */\n\nimport type { MarcWarning, MarcWarningType } from './types';\n\n/**\n * Create a warning object.\n *\n * @param type - The warning type\n * @param message - The warning message\n * @param position - Optional byte position in the record\n * @param tag - Optional field tag associated with the warning\n * @returns A MarcWarning object\n *\n * @example\n * ```typescript\n * const warning = createWarning(\n *   'invalid_leader',\n *   'Leader length is invalid',\n *   0,\n *   undefined\n * );\n * ```\n */\nexport function createWarning(\n  type: MarcWarningType,\n  message: string,\n  position?: number,\n  tag?: string\n): MarcWarning {\n  return { type, message, position, tag };\n}\n"],"mappings":"AA0BA,SAAgB,EACd,EACA,EACA,EACA,EACa,CACb,MAAO,CAAE,KAAA,EAAM,QAAA,EAAS,SAAA,EAAU,IAAA,CAAI,CACxC"}

package/dist/warnings-Bt6wvWFe.js

@@ -0,0 +1,13 @@
+function a(n, r, t, e) {
+  return {
+    type: n,
+    message: r,
+    position: t,
+    tag: e
+  };
+}
+export {
+  a as t
+};
+
+//# sourceMappingURL=warnings-Bt6wvWFe.js.map

package/dist/warnings-Bt6wvWFe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"warnings-Bt6wvWFe.js","names":[],"sources":["../src/warnings.ts"],"sourcesContent":["/**\n * Warning system for MARC parsing.\n * Re-exports types and provides utility functions.\n */\n\nimport type { MarcWarning, MarcWarningType } from './types';\n\n/**\n * Create a warning object.\n *\n * @param type - The warning type\n * @param message - The warning message\n * @param position - Optional byte position in the record\n * @param tag - Optional field tag associated with the warning\n * @returns A MarcWarning object\n *\n * @example\n * ```typescript\n * const warning = createWarning(\n *   'invalid_leader',\n *   'Leader length is invalid',\n *   0,\n *   undefined\n * );\n * ```\n */\nexport function createWarning(\n  type: MarcWarningType,\n  message: string,\n  position?: number,\n  tag?: string\n): MarcWarning {\n  return { type, message, position, tag };\n}\n"],"mappings":"AA0BA,SAAgB,EACd,GACA,GACA,GACA,GACa;AACb,SAAO;AAAA,IAAE,MAAA;AAAA,IAAM,SAAA;AAAA,IAAS,UAAA;AAAA,IAAU,KAAA;AAAA,EAAI;AACxC"}

package/dist/warnings.d.ts

@@ -1,5 +1,4 @@
-import { MarcWarning, MarcWarningType, ParseOptions, ParseResult } from './types';
-export type { MarcWarning, MarcWarningType, ParseOptions, ParseResult };
+import { MarcWarning, MarcWarningType } from './types';
 /**
  * Create a warning object.
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "marc-ts",
-  "version": "0.1.0",
+  "version": "0.4.2",
   "description": "TypeScript MARC21 library for Node.js and browsers",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -69,7 +69,7 @@
   },
   "homepage": "https://github.com/jamesrf/marc-ts#readme",
   "engines": {
-    "node": ">=20.19.0"
+    "node": ">=24"
   },
   "browser": {
     "buffer": false

package/dist/types-CJcxHJff.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"types-CJcxHJff.cjs","names":[],"sources":["../src/types.ts"],"sourcesContent":["/**\n * Core type definitions for MARC21 records.\n * All types use readonly modifiers to enforce immutability.\n */\n\n/**\n * A subfield within a MARC data field.\n * Contains a single-character code and its associated value.\n *\n * @example\n * ```typescript\n * const subfield: Subfield = { code: 'a', value: 'The Catcher in the Rye' };\n * ```\n */\nexport interface Subfield {\n  readonly code: string;\n  readonly value: string;\n}\n\n/**\n * A MARC control field (tag 00X).\n * Control fields have no indicators or subfields, only a tag and data.\n *\n * @example\n * ```typescript\n * const controlField: ControlField = { tag: '001', data: 'ocm12345678' };\n * ```\n */\nexport interface ControlField {\n  readonly tag: string;\n  readonly data: string;\n}\n\n/**\n * A MARC data field (tag 01X-9XX).\n * Data fields have a tag, two indicators, and one or more subfields.\n *\n * @example\n * ```typescript\n * const dataField: DataField = {\n *   tag: '245',\n *   indicator1: '1',\n *   indicator2: '0',\n *   subfields: [\n *     { code: 'a', value: 'The Catcher in the Rye /' },\n *     { code: 'c', value: 'J.D. Salinger.' },\n *   ],\n * };\n * ```\n */\nexport interface DataField {\n  readonly tag: string;\n  readonly indicator1: string; // Use ' ' for blank indicator\n  readonly indicator2: string; // Use ' ' for blank indicator\n  readonly subfields: readonly Subfield[];\n}\n\n/**\n * A complete MARC21 record.\n * Contains a 24-character leader and an array of fields (control or data fields).\n *\n * @example\n * ```typescript\n * const record: MarcRecord = {\n *   leader: '00000nam  2200000   4500',\n *   fields: [\n *     { tag: '001', data: 'ocm12345678' },\n *     {\n *       tag: '245',\n *       indicator1: '1',\n *       indicator2: '0',\n *       subfields: [{ code: 'a', value: 'Title' }],\n *     },\n *   ],\n * };\n * ```\n */\nexport interface MarcRecord {\n  readonly leader: string; // Always 24 characters\n  readonly fields: readonly (ControlField | DataField)[];\n}\n\n/**\n * Warning type categories for MARC parsing errors.\n */\nexport type MarcWarningType =\n  | 'invalid_leader'\n  | 'invalid_directory'\n  | 'invalid_field'\n  | 'truncated_record'\n  | 'encoding_error';\n\n/**\n * A warning generated during MARC record parsing.\n * Warnings indicate non-fatal issues that were encountered and recovered from.\n */\nexport interface MarcWarning {\n  readonly type: MarcWarningType;\n  readonly message: string;\n  readonly position?: number; // Byte position in the record\n  readonly tag?: string; // Field tag associated with the warning\n}\n\n/**\n * Options for parsing MARC records.\n */\nexport interface ParseOptions {\n  /**\n   * If true, throw errors instead of collecting warnings.\n   * Default: false\n   */\n  readonly strict?: boolean;\n\n  /**\n   * Maximum number of warnings to collect before stopping.\n   * Prevents memory issues with severely malformed records.\n   * Default: 100\n   */\n  readonly maxWarnings?: number;\n}\n\n/**\n * Result of parsing a MARC record.\n * Contains the parsed record (if successful) and any warnings encountered.\n */\nexport interface ParseResult {\n  readonly record: MarcRecord | null;\n  readonly warnings: readonly MarcWarning[];\n}\n\n/**\n * Type guard to check if a field is a control field.\n *\n * @param field - The field to check\n * @returns True if the field is a control field\n *\n * @example\n * ```typescript\n * if (isControlField(field)) {\n *   console.log(field.data); // TypeScript knows field is ControlField\n * }\n * ```\n */\nexport function isControlField(field: ControlField | DataField): field is ControlField {\n  return 'data' in field;\n}\n\n/**\n * Type guard to check if a field is a data field.\n *\n * @param field - The field to check\n * @returns True if the field is a data field\n *\n * @example\n * ```typescript\n * if (isDataField(field)) {\n *   console.log(field.subfields); // TypeScript knows field is DataField\n * }\n * ```\n */\nexport function isDataField(field: ControlField | DataField): field is DataField {\n  return 'subfields' in field;\n}\n"],"mappings":"AA+IA,SAAgB,EAAe,EAAwD,CACrF,MAAO,SAAU,CACnB,CAeA,SAAgB,EAAY,EAAqD,CAC/E,MAAO,cAAe,CACxB"}

package/dist/types-c4Mo9m9u.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types-c4Mo9m9u.js","names":[],"sources":["../src/types.ts"],"sourcesContent":["/**\n * Core type definitions for MARC21 records.\n * All types use readonly modifiers to enforce immutability.\n */\n\n/**\n * A subfield within a MARC data field.\n * Contains a single-character code and its associated value.\n *\n * @example\n * ```typescript\n * const subfield: Subfield = { code: 'a', value: 'The Catcher in the Rye' };\n * ```\n */\nexport interface Subfield {\n  readonly code: string;\n  readonly value: string;\n}\n\n/**\n * A MARC control field (tag 00X).\n * Control fields have no indicators or subfields, only a tag and data.\n *\n * @example\n * ```typescript\n * const controlField: ControlField = { tag: '001', data: 'ocm12345678' };\n * ```\n */\nexport interface ControlField {\n  readonly tag: string;\n  readonly data: string;\n}\n\n/**\n * A MARC data field (tag 01X-9XX).\n * Data fields have a tag, two indicators, and one or more subfields.\n *\n * @example\n * ```typescript\n * const dataField: DataField = {\n *   tag: '245',\n *   indicator1: '1',\n *   indicator2: '0',\n *   subfields: [\n *     { code: 'a', value: 'The Catcher in the Rye /' },\n *     { code: 'c', value: 'J.D. Salinger.' },\n *   ],\n * };\n * ```\n */\nexport interface DataField {\n  readonly tag: string;\n  readonly indicator1: string; // Use ' ' for blank indicator\n  readonly indicator2: string; // Use ' ' for blank indicator\n  readonly subfields: readonly Subfield[];\n}\n\n/**\n * A complete MARC21 record.\n * Contains a 24-character leader and an array of fields (control or data fields).\n *\n * @example\n * ```typescript\n * const record: MarcRecord = {\n *   leader: '00000nam  2200000   4500',\n *   fields: [\n *     { tag: '001', data: 'ocm12345678' },\n *     {\n *       tag: '245',\n *       indicator1: '1',\n *       indicator2: '0',\n *       subfields: [{ code: 'a', value: 'Title' }],\n *     },\n *   ],\n * };\n * ```\n */\nexport interface MarcRecord {\n  readonly leader: string; // Always 24 characters\n  readonly fields: readonly (ControlField | DataField)[];\n}\n\n/**\n * Warning type categories for MARC parsing errors.\n */\nexport type MarcWarningType =\n  | 'invalid_leader'\n  | 'invalid_directory'\n  | 'invalid_field'\n  | 'truncated_record'\n  | 'encoding_error';\n\n/**\n * A warning generated during MARC record parsing.\n * Warnings indicate non-fatal issues that were encountered and recovered from.\n */\nexport interface MarcWarning {\n  readonly type: MarcWarningType;\n  readonly message: string;\n  readonly position?: number; // Byte position in the record\n  readonly tag?: string; // Field tag associated with the warning\n}\n\n/**\n * Options for parsing MARC records.\n */\nexport interface ParseOptions {\n  /**\n   * If true, throw errors instead of collecting warnings.\n   * Default: false\n   */\n  readonly strict?: boolean;\n\n  /**\n   * Maximum number of warnings to collect before stopping.\n   * Prevents memory issues with severely malformed records.\n   * Default: 100\n   */\n  readonly maxWarnings?: number;\n}\n\n/**\n * Result of parsing a MARC record.\n * Contains the parsed record (if successful) and any warnings encountered.\n */\nexport interface ParseResult {\n  readonly record: MarcRecord | null;\n  readonly warnings: readonly MarcWarning[];\n}\n\n/**\n * Type guard to check if a field is a control field.\n *\n * @param field - The field to check\n * @returns True if the field is a control field\n *\n * @example\n * ```typescript\n * if (isControlField(field)) {\n *   console.log(field.data); // TypeScript knows field is ControlField\n * }\n * ```\n */\nexport function isControlField(field: ControlField | DataField): field is ControlField {\n  return 'data' in field;\n}\n\n/**\n * Type guard to check if a field is a data field.\n *\n * @param field - The field to check\n * @returns True if the field is a data field\n *\n * @example\n * ```typescript\n * if (isDataField(field)) {\n *   console.log(field.subfields); // TypeScript knows field is DataField\n * }\n * ```\n */\nexport function isDataField(field: ControlField | DataField): field is DataField {\n  return 'subfields' in field;\n}\n"],"mappings":"AA+IA,SAAgB,EAAe,GAAwD;AACrF,SAAO,UAAU;AACnB;AAeA,SAAgB,EAAY,GAAqD;AAC/E,SAAO,eAAe;AACxB"}