marc-ts 0.1.0 → 0.2.0

package/dist/marcxml.js

@@ -1,5 +1,5 @@
 import { t as $ } from "./types-c4Mo9m9u.js";
-var M = /* @__PURE__ */ new Map([
+var v = /* @__PURE__ */ new Map([
   ["amp", "&"],
   ["lt", "<"],
   ["gt", ">"],
@@ -7,16 +7,16 @@ var M = /* @__PURE__ */ new Map([
   ["apos", "'"]
 ]);
 function h(e) {
-  return e.replace(/&(?:#x([0-9a-fA-F]+)|#([0-9]+)|([a-zA-Z]+));/g, (i, r, o, t) => {
-    if (r !== void 0) {
-      const n = parseInt(r, 16);
+  return e.replace(/&(?:#x([0-9a-fA-F]+)|#([0-9]+)|([a-zA-Z]+));/g, (i, s, c, t) => {
+    if (s !== void 0) {
+      const n = parseInt(s, 16);
       return n >= 0 && n <= 1114111 ? String.fromCodePoint(n) : "�";
     }
-    if (o !== void 0) {
-      const n = parseInt(o, 10);
+    if (c !== void 0) {
+      const n = parseInt(c, 10);
       return n >= 0 && n <= 1114111 ? String.fromCodePoint(n) : "�";
     }
-    return M.get(t) ?? i;
+    return v.get(t) ?? i;
   });
 }
 function u(e) {
@@ -27,38 +27,38 @@ function f(e) {
   return i === -1 ? e : e.slice(i + 1);
 }
 function m(e) {
-  const i = {}, r = /([a-zA-Z_:][^\s=]*)\s*=\s*(?:"([^"]*)"|'([^']*)')/g;
-  let o;
-  for (; (o = r.exec(e)) !== null; ) {
-    const t = f(o[1]);
-    i[t] = h(o[2] ?? o[3] ?? "");
+  const i = {}, s = /([a-zA-Z_:][^\s=]*)\s*=\s*(?:"([^"]*)"|'([^']*)')/g;
+  let c;
+  for (; (c = s.exec(e)) !== null; ) {
+    const t = f(c[1]);
+    i[t] = h(c[2] ?? c[3] ?? "");
   }
   return i;
 }
-function v(e) {
+function b(e) {
   const i = [];
-  let r = 0;
-  for (; r < e.length; ) {
-    const o = e.indexOf("<", r);
-    if (o === -1) {
-      e.slice(r).trim() && i.push({
+  let s = 0;
+  for (; s < e.length; ) {
+    const c = e.indexOf("<", s);
+    if (c === -1) {
+      e.slice(s).trim() && i.push({
         type: "text",
-        text: h(e.slice(r))
+        text: h(e.slice(s))
       });
       break;
     }
-    if (o > r) {
-      const s = e.slice(r, o);
-      s.trim() && i.push({
+    if (c > s) {
+      const o = e.slice(s, c);
+      o.trim() && i.push({
         type: "text",
-        text: h(s)
+        text: h(o)
       });
     }
-    const t = e.indexOf(">", o);
+    const t = e.indexOf(">", c);
     if (t === -1) break;
-    const n = e.slice(o + 1, t);
+    const n = e.slice(c + 1, t);
     if (n.startsWith("!") || n.startsWith("?")) {
-      r = t + 1;
+      s = t + 1;
       continue;
     }
     if (n.startsWith("/")) i.push({
@@ -66,60 +66,60 @@ function v(e) {
       name: f(n.slice(1).trim())
     });
     else if (n.endsWith("/")) {
-      const s = n.slice(0, -1).trim(), c = s.search(/\s/), l = c === -1 ? s : s.slice(0, c), p = c === -1 ? "" : s.slice(c);
+      const o = n.slice(0, -1).trim(), r = o.search(/\s/), l = r === -1 ? o : o.slice(0, r), p = r === -1 ? "" : o.slice(r);
       i.push({
         type: "self-close",
         name: f(l),
         attrs: m(p)
       });
     } else {
-      const s = n.search(/\s/), c = s === -1 ? n : n.slice(0, s), l = s === -1 ? "" : n.slice(s);
+      const o = n.search(/\s/), r = o === -1 ? n : n.slice(0, o), l = o === -1 ? "" : n.slice(o);
       i.push({
         type: "open",
-        name: f(c),
+        name: f(r),
         attrs: m(l)
       });
     }
-    r = t + 1;
+    s = t + 1;
   }
   return i;
 }
 function w(e, i) {
-  let r = "";
-  const o = [];
+  let s = "";
+  const c = [];
   let t = i;
   for (; t < e.length; ) {
     const n = e[t];
     if (n.type === "close" && n.name === "record") return {
       record: {
-        leader: r,
-        fields: o
+        leader: s,
+        fields: c
       },
       end: t + 1
     };
     if (n.type === "open" && n.name === "leader") {
-      t++, t < e.length && e[t].type === "text" && (r = e[t].text.trim(), t++), t < e.length && e[t].type === "close" && t++;
+      t++, t < e.length && e[t].type === "text" && (s = e[t].text.trim(), t++), t < e.length && e[t].type === "close" && t++;
       continue;
     }
     if (n.type === "self-close" && n.name === "controlfield") {
-      o.push({
+      c.push({
         tag: n.attrs?.tag ?? "",
         data: ""
       }), t++;
       continue;
     }
     if (n.type === "open" && n.name === "controlfield") {
-      const s = n.attrs?.tag ?? "";
+      const o = n.attrs?.tag ?? "";
       t++;
-      let c = "";
-      t < e.length && e[t].type === "text" && (c = e[t].text ?? "", t++), t < e.length && e[t].type === "close" && t++, o.push({
-        tag: s,
-        data: c
+      let r = "";
+      t < e.length && e[t].type === "text" && (r = e[t].text ?? "", t++), t < e.length && e[t].type === "close" && t++, c.push({
+        tag: o,
+        data: r
       });
       continue;
     }
     if (n.type === "self-close" && n.name === "datafield") {
-      o.push({
+      c.push({
         tag: n.attrs?.tag ?? "",
         indicator1: n.attrs?.ind1 ?? " ",
         indicator2: n.attrs?.ind2 ?? " ",
@@ -128,7 +128,7 @@ function w(e, i) {
       continue;
     }
     if (n.type === "open" && n.name === "datafield") {
-      const s = n.attrs?.tag ?? "", c = n.attrs?.ind1 ?? " ", l = n.attrs?.ind2 ?? " ", p = [];
+      const o = n.attrs?.tag ?? "", r = n.attrs?.ind1 ?? " ", l = n.attrs?.ind2 ?? " ", p = [];
       for (t++; t < e.length; ) {
         const d = e[t];
         if (d.type === "close" && d.name === "datafield") {
@@ -147,9 +147,9 @@ function w(e, i) {
         }
         t++;
       }
-      o.push({
-        tag: s,
-        indicator1: c,
+      c.push({
+        tag: o,
+        indicator1: r,
         indicator2: l,
         subfields: p
       });
@@ -159,62 +159,55 @@ function w(e, i) {
   }
   return {
     record: {
-      leader: r,
-      fields: o
+      leader: s,
+      fields: c
     },
     end: t
   };
 }
-function b(e) {
-  const i = v(e), r = [];
-  let o = 0;
-  for (; o < i.length; ) {
-    const t = i[o];
+function M(e) {
+  const i = b(e), s = [];
+  let c = 0;
+  for (; c < i.length; ) {
+    const t = i[c];
     if (t.type === "open" && t.name === "record") {
-      const { record: n, end: s } = w(i, o + 1);
-      r.push(n), o = s;
+      const { record: n, end: o } = w(i, c + 1);
+      s.push(n), c = o;
       continue;
     }
-    o++;
+    c++;
   }
-  return r;
-}
-function E(e) {
-  const i = b(e);
-  if (i.length === 0) throw new Error("No MARC record found in MARCXML input");
-  return i[0];
+  return s;
 }
 var A = `<?xml version="1.0" encoding="UTF-8"?>
 `, y = 'xmlns="http://www.loc.gov/MARC21/slim"', a = "  ";
 function C(e) {
   const i = [`<record ${y}>`];
   i.push(`${a}<leader>${u(e.leader)}</leader>`);
-  for (const r of e.fields) if ($(r)) i.push(`${a}<controlfield tag="${r.tag}">${u(r.data)}</controlfield>`);
+  for (const s of e.fields) if ($(s)) i.push(`${a}<controlfield tag="${s.tag}">${u(s.data)}</controlfield>`);
   else {
-    const o = r.indicator1 === " " ? " " : r.indicator1, t = r.indicator2 === " " ? " " : r.indicator2;
-    i.push(`${a}<datafield tag="${r.tag}" ind1="${o}" ind2="${t}">`);
-    for (const n of r.subfields) i.push(`${a}${a}<subfield code="${n.code}">${u(n.value)}</subfield>`);
+    const c = s.indicator1 === " " ? " " : s.indicator1, t = s.indicator2 === " " ? " " : s.indicator2;
+    i.push(`${a}<datafield tag="${s.tag}" ind1="${c}" ind2="${t}">`);
+    for (const n of s.subfields) i.push(`${a}${a}<subfield code="${n.code}">${u(n.value)}</subfield>`);
     i.push(`${a}</datafield>`);
   }
   return i.push("</record>"), i.join(`
 `);
 }
-function I(e) {
+function X(e) {
   const i = [A, `<collection ${y}>`];
-  for (const r of e) {
-    const o = C(r).split(`
+  for (const s of e) {
+    const c = C(s).split(`
 `).map((t) => a + t).join(`
 `);
-    i.push(o);
+    i.push(c);
   }
   return i.push("</collection>"), i.join(`
 `);
 }
 export {
-  b as parseMarcXml,
-  E as parseMarcXmlRecord,
-  I as serializeMarcXml,
-  C as serializeMarcXmlRecord
+  M as parseMarcXml,
+  X as serializeMarcXml
 };
 
 //# sourceMappingURL=marcxml.js.map

package/dist/marcxml.js.map

@@ -1 +1 @@
-{"version":3,"file":"marcxml.js","names":[],"sources":["../src/marcxml.ts"],"sourcesContent":["/**\n * MARCXML parser and serializer.\n *\n * Supports the Library of Congress MARCXML schema:\n * http://www.loc.gov/MARC21/slim\n *\n * Parsing is done with a hand-rolled state machine — no XML library needed.\n * The MARCXML format is sufficiently regular (fixed element names, no arbitrary\n * nesting) that a full DOM parser is unnecessary.\n */\n\nimport type { MarcRecord, ControlField, DataField, Subfield } from './types';\nimport { isControlField } from './types';\n\n// ─── XML entity handling ─────────────────────────────────────────────────────\n\nconst ENTITY_MAP: ReadonlyMap<string, string> = new Map([\n  ['amp', '&'],\n  ['lt', '<'],\n  ['gt', '>'],\n  ['quot', '\"'],\n  ['apos', \"'\"],\n]);\n\nfunction unescapeXml(text: string): string {\n  return text.replace(/&(?:#x([0-9a-fA-F]+)|#([0-9]+)|([a-zA-Z]+));/g, (_, hex, dec, name) => {\n    if (hex !== undefined) {\n      const cp = parseInt(hex, 16);\n      return cp >= 0 && cp <= 0x10ffff ? String.fromCodePoint(cp) : '�';\n    }\n    if (dec !== undefined) {\n      const cp = parseInt(dec, 10);\n      return cp >= 0 && cp <= 0x10ffff ? String.fromCodePoint(cp) : '�';\n    }\n    return ENTITY_MAP.get(name) ?? _;\n  });\n}\n\nfunction escapeXml(text: string): string {\n  return text\n    // XML 1.0 forbids most C0 control characters in document text. There is no\n    // valid XML 1.0 representation for them, so substitute the Unicode\n    // replacement character to keep the output well-formed.\n    .replace(/[\\x00-\\x08\\x0B\\x0C\\x0E-\\x1F]/g, '�')\n    .replace(/&/g, '&amp;')\n    .replace(/</g, '&lt;')\n    .replace(/>/g, '&gt;')\n    .replace(/\"/g, '&quot;')\n    // Preserve literal CR through the XML round-trip: XML parsers normalize\n    // bare \\r and \\r\\n to \\n, so we must encode CR as a numeric reference.\n    .replace(/\\r/g, '&#13;');\n}\n\n// ─── Minimal tokeniser ────────────────────────────────────────────────────────\n\ninterface Token {\n  type: 'open' | 'close' | 'self-close' | 'text';\n  /** Local name (no namespace prefix) */\n  name?: string;\n  attrs?: Record<string, string>;\n  text?: string;\n}\n\n/**\n * Strip namespace prefix from a tag name, e.g. \"marc:record\" → \"record\".\n */\nfunction localName(raw: string): string {\n  const colon = raw.indexOf(':');\n  return colon === -1 ? raw : raw.slice(colon + 1);\n}\n\n/**\n * Parse `key=\"value\"` pairs out of an attribute string.\n */\nfunction parseAttrs(attrStr: string): Record<string, string> {\n  const attrs: Record<string, string> = {};\n  const re = /([a-zA-Z_:][^\\s=]*)\\s*=\\s*(?:\"([^\"]*)\"|'([^']*)')/g;\n  let m: RegExpExecArray | null;\n  while ((m = re.exec(attrStr)) !== null) {\n    const key = localName(m[1]!);\n    attrs[key] = unescapeXml(m[2] ?? m[3] ?? '');\n  }\n  return attrs;\n}\n\n/**\n * Tokenise an XML string into a flat stream of open/close/text tokens.\n * Skips processing instructions, comments, and DOCTYPE declarations.\n * Sufficient for the well-constrained MARCXML format.\n */\nfunction tokenise(xml: string): Token[] {\n  const tokens: Token[] = [];\n  let i = 0;\n\n  while (i < xml.length) {\n    const ltPos = xml.indexOf('<', i);\n\n    // Text node before next tag\n    if (ltPos === -1) {\n      const text = xml.slice(i).trim();\n      if (text) tokens.push({ type: 'text', text: unescapeXml(xml.slice(i)) });\n      break;\n    }\n\n    if (ltPos > i) {\n      const raw = xml.slice(i, ltPos);\n      const text = raw.trim();\n      if (text) tokens.push({ type: 'text', text: unescapeXml(raw) });\n    }\n\n    const gtPos = xml.indexOf('>', ltPos);\n    if (gtPos === -1) break;\n\n    const tag = xml.slice(ltPos + 1, gtPos);\n\n    // Skip comments, PIs, DOCTYPE\n    if (tag.startsWith('!') || tag.startsWith('?')) {\n      i = gtPos + 1;\n      continue;\n    }\n\n    if (tag.startsWith('/')) {\n      tokens.push({ type: 'close', name: localName(tag.slice(1).trim()) });\n    } else if (tag.endsWith('/')) {\n      const inner = tag.slice(0, -1).trim();\n      const spaceIdx = inner.search(/\\s/);\n      const name = spaceIdx === -1 ? inner : inner.slice(0, spaceIdx);\n      const attrStr = spaceIdx === -1 ? '' : inner.slice(spaceIdx);\n      tokens.push({ type: 'self-close', name: localName(name), attrs: parseAttrs(attrStr) });\n    } else {\n      const spaceIdx = tag.search(/\\s/);\n      const name = spaceIdx === -1 ? tag : tag.slice(0, spaceIdx);\n      const attrStr = spaceIdx === -1 ? '' : tag.slice(spaceIdx);\n      tokens.push({ type: 'open', name: localName(name), attrs: parseAttrs(attrStr) });\n    }\n\n    i = gtPos + 1;\n  }\n\n  return tokens;\n}\n\n// ─── MARCXML parser ───────────────────────────────────────────────────────────\n\n/**\n * Parse one `<record>` element's worth of tokens into a MarcRecord.\n * Mutates `pos` via the returned index.\n */\nfunction parseRecordTokens(tokens: Token[], start: number): { record: MarcRecord; end: number } {\n  let leader = '';\n  const fields: (ControlField | DataField)[] = [];\n  let i = start;\n\n  while (i < tokens.length) {\n    const tok = tokens[i]!;\n\n    if (tok.type === 'close' && tok.name === 'record') {\n      return { record: { leader, fields }, end: i + 1 };\n    }\n\n    if (tok.type === 'open' && tok.name === 'leader') {\n      i++;\n      if (i < tokens.length && tokens[i]!.type === 'text') {\n        leader = tokens[i]!.text!.trim();\n        i++;\n      }\n      // consume </leader>\n      if (i < tokens.length && tokens[i]!.type === 'close') i++;\n      continue;\n    }\n\n    if (tok.type === 'self-close' && tok.name === 'controlfield') {\n      fields.push({ tag: tok.attrs?.['tag'] ?? '', data: '' });\n      i++;\n      continue;\n    }\n\n    if (tok.type === 'open' && tok.name === 'controlfield') {\n      const tag = tok.attrs?.['tag'] ?? '';\n      i++;\n      let data = '';\n      if (i < tokens.length && tokens[i]!.type === 'text') {\n        data = tokens[i]!.text ?? '';\n        i++;\n      }\n      // consume </controlfield>\n      if (i < tokens.length && tokens[i]!.type === 'close') i++;\n      fields.push({ tag, data });\n      continue;\n    }\n\n    if (tok.type === 'self-close' && tok.name === 'datafield') {\n      fields.push({\n        tag: tok.attrs?.['tag'] ?? '',\n        indicator1: tok.attrs?.['ind1'] ?? ' ',\n        indicator2: tok.attrs?.['ind2'] ?? ' ',\n        subfields: [],\n      });\n      i++;\n      continue;\n    }\n\n    if (tok.type === 'open' && tok.name === 'datafield') {\n      const tag = tok.attrs?.['tag'] ?? '';\n      const indicator1 = tok.attrs?.['ind1'] ?? ' ';\n      const indicator2 = tok.attrs?.['ind2'] ?? ' ';\n      const subfields: Subfield[] = [];\n      i++;\n\n      while (i < tokens.length) {\n        const stok = tokens[i]!;\n        if (stok.type === 'close' && stok.name === 'datafield') {\n          i++;\n          break;\n        }\n        if (stok.type === 'open' && stok.name === 'subfield') {\n          const code = stok.attrs?.['code'] ?? '';\n          i++;\n          let value = '';\n          if (i < tokens.length && tokens[i]!.type === 'text') {\n            value = tokens[i]!.text ?? '';\n            i++;\n          }\n          // consume </subfield>\n          if (i < tokens.length && tokens[i]!.type === 'close') i++;\n          subfields.push({ code, value });\n          continue;\n        }\n        i++;\n      }\n\n      fields.push({ tag, indicator1, indicator2, subfields });\n      continue;\n    }\n\n    i++;\n  }\n\n  return { record: { leader, fields }, end: i };\n}\n\n/**\n * Parse a MARCXML string containing one `<collection>` or one bare `<record>`.\n * Returns all records found.\n */\nexport function parseMarcXml(xml: string): MarcRecord[] {\n  const tokens = tokenise(xml);\n  const records: MarcRecord[] = [];\n  let i = 0;\n\n  while (i < tokens.length) {\n    const tok = tokens[i]!;\n    if (tok.type === 'open' && tok.name === 'record') {\n      const { record, end } = parseRecordTokens(tokens, i + 1);\n      records.push(record);\n      i = end;\n      continue;\n    }\n    i++;\n  }\n\n  return records;\n}\n\n/**\n * Parse a MARCXML string expected to contain exactly one `<record>`.\n * Throws if no record is found.\n */\nexport function parseMarcXmlRecord(xml: string): MarcRecord {\n  const records = parseMarcXml(xml);\n  if (records.length === 0) throw new Error('No MARC record found in MARCXML input');\n  return records[0]!;\n}\n\n// ─── MARCXML serializer ───────────────────────────────────────────────────────\n\nconst XML_HEADER = '<?xml version=\"1.0\" encoding=\"UTF-8\"?>\\n';\nconst COLLECTION_NS = 'xmlns=\"http://www.loc.gov/MARC21/slim\"';\nconst INDENT = '  ';\n\n/**\n * Serialize a single MarcRecord to a `<record>` XML element string (no collection wrapper).\n */\nexport function serializeMarcXmlRecord(record: MarcRecord): string {\n  const lines: string[] = [`<record ${COLLECTION_NS}>`];\n  lines.push(`${INDENT}<leader>${escapeXml(record.leader)}</leader>`);\n\n  for (const field of record.fields) {\n    if (isControlField(field)) {\n      lines.push(`${INDENT}<controlfield tag=\"${field.tag}\">${escapeXml(field.data)}</controlfield>`);\n    } else {\n      const ind1 = field.indicator1 === ' ' ? ' ' : field.indicator1;\n      const ind2 = field.indicator2 === ' ' ? ' ' : field.indicator2;\n      lines.push(`${INDENT}<datafield tag=\"${field.tag}\" ind1=\"${ind1}\" ind2=\"${ind2}\">`);\n      for (const sf of field.subfields) {\n        lines.push(\n          `${INDENT}${INDENT}<subfield code=\"${sf.code}\">${escapeXml(sf.value)}</subfield>`\n        );\n      }\n      lines.push(`${INDENT}</datafield>`);\n    }\n  }\n\n  lines.push('</record>');\n  return lines.join('\\n');\n}\n\n/**\n * Serialize one or more MarcRecords into a MARCXML `<collection>` document.\n */\nexport function serializeMarcXml(records: MarcRecord[]): string {\n  const parts: string[] = [\n    XML_HEADER,\n    `<collection ${COLLECTION_NS}>`,\n  ];\n\n  for (const record of records) {\n    // Indent each record element by one level inside <collection>\n    const recordXml = serializeMarcXmlRecord(record)\n      .split('\\n')\n      .map((line) => INDENT + line)\n      .join('\\n');\n    parts.push(recordXml);\n  }\n\n  parts.push('</collection>');\n  return parts.join('\\n');\n}\n"],"mappings":";AAgBA,IAAM,IAA0C,oBAAI,IAAI;AAAA,EACtD,CAAC,OAAO,GAAG;AAAA,EACX,CAAC,MAAM,GAAG;AAAA,EACV,CAAC,MAAM,GAAG;AAAA,EACV,CAAC,QAAQ,GAAG;AAAA,EACZ,CAAC,QAAQ,GAAG;AACd,CAAC;AAED,SAAS,EAAY,GAAsB;AACzC,SAAO,EAAK,QAAQ,iDAAA,CAAkD,GAAG,GAAK,GAAK,MAAS;AAC1F,QAAI,MAAQ,QAAW;AACrB,YAAM,IAAK,SAAS,GAAK,EAAE;AAC3B,aAAO,KAAM,KAAK,KAAM,UAAW,OAAO,cAAc,CAAE,IAAI;AAAA,IAChE;AACA,QAAI,MAAQ,QAAW;AACrB,YAAM,IAAK,SAAS,GAAK,EAAE;AAC3B,aAAO,KAAM,KAAK,KAAM,UAAW,OAAO,cAAc,CAAE,IAAI;AAAA,IAChE;AACA,WAAO,EAAW,IAAI,CAAI,KAAK;AAAA,EACjC,CAAC;AACH;AAEA,SAAS,EAAU,GAAsB;AACvC,SAAO,EAIJ,QAAQ,iCAAiC,GAAG,EAC5C,QAAQ,MAAM,OAAO,EACrB,QAAQ,MAAM,MAAM,EACpB,QAAQ,MAAM,MAAM,EACpB,QAAQ,MAAM,QAAQ,EAGtB,QAAQ,OAAO,OAAO;AAC3B;AAeA,SAAS,EAAU,GAAqB;AACtC,QAAM,IAAQ,EAAI,QAAQ,GAAG;AAC7B,SAAO,MAAU,KAAK,IAAM,EAAI,MAAM,IAAQ,CAAC;AACjD;AAKA,SAAS,EAAW,GAAyC;AAC3D,QAAM,IAAgC,CAAC,GACjC,IAAK;AACX,MAAI;AACJ,UAAQ,IAAI,EAAG,KAAK,CAAO,OAAO,QAAM;AACtC,UAAM,IAAM,EAAU,EAAE,CAAA,CAAG;AAC3B,IAAA,EAAM,CAAA,IAAO,EAAY,EAAE,CAAA,KAAM,EAAE,CAAA,KAAM,EAAE;AAAA,EAC7C;AACA,SAAO;AACT;AAOA,SAAS,EAAS,GAAsB;AACtC,QAAM,IAAkB,CAAC;AACzB,MAAI,IAAI;AAER,SAAO,IAAI,EAAI,UAAQ;AACrB,UAAM,IAAQ,EAAI,QAAQ,KAAK,CAAC;AAGhC,QAAI,MAAU,IAAI;AAEhB,MADa,EAAI,MAAM,CAAC,EAAE,KACtB,KAAM,EAAO,KAAK;AAAA,QAAE,MAAM;AAAA,QAAQ,MAAM,EAAY,EAAI,MAAM,CAAC,CAAC;AAAA,MAAE,CAAC;AACvE;AAAA,IACF;AAEA,QAAI,IAAQ,GAAG;AACb,YAAM,IAAM,EAAI,MAAM,GAAG,CAAK;AAE9B,MADa,EAAI,KACb,KAAM,EAAO,KAAK;AAAA,QAAE,MAAM;AAAA,QAAQ,MAAM,EAAY,CAAG;AAAA,MAAE,CAAC;AAAA,IAChE;AAEA,UAAM,IAAQ,EAAI,QAAQ,KAAK,CAAK;AACpC,QAAI,MAAU,GAAI;AAElB,UAAM,IAAM,EAAI,MAAM,IAAQ,GAAG,CAAK;AAGtC,QAAI,EAAI,WAAW,GAAG,KAAK,EAAI,WAAW,GAAG,GAAG;AAC9C,MAAA,IAAI,IAAQ;AACZ;AAAA,IACF;AAEA,QAAI,EAAI,WAAW,GAAG,EACpB,CAAA,EAAO,KAAK;AAAA,MAAE,MAAM;AAAA,MAAS,MAAM,EAAU,EAAI,MAAM,CAAC,EAAE,KAAK,CAAC;AAAA,IAAE,CAAC;AAAA,aAC1D,EAAI,SAAS,GAAG,GAAG;AAC5B,YAAM,IAAQ,EAAI,MAAM,GAAG,EAAE,EAAE,KAAK,GAC9B,IAAW,EAAM,OAAO,IAAI,GAC5B,IAAO,MAAa,KAAK,IAAQ,EAAM,MAAM,GAAG,CAAQ,GACxD,IAAU,MAAa,KAAK,KAAK,EAAM,MAAM,CAAQ;AAC3D,MAAA,EAAO,KAAK;AAAA,QAAE,MAAM;AAAA,QAAc,MAAM,EAAU,CAAI;AAAA,QAAG,OAAO,EAAW,CAAO;AAAA,MAAE,CAAC;AAAA,IACvF,OAAO;AACL,YAAM,IAAW,EAAI,OAAO,IAAI,GAC1B,IAAO,MAAa,KAAK,IAAM,EAAI,MAAM,GAAG,CAAQ,GACpD,IAAU,MAAa,KAAK,KAAK,EAAI,MAAM,CAAQ;AACzD,MAAA,EAAO,KAAK;AAAA,QAAE,MAAM;AAAA,QAAQ,MAAM,EAAU,CAAI;AAAA,QAAG,OAAO,EAAW,CAAO;AAAA,MAAE,CAAC;AAAA,IACjF;AAEA,IAAA,IAAI,IAAQ;AAAA,EACd;AAEA,SAAO;AACT;AAQA,SAAS,EAAkB,GAAiB,GAAoD;AAC9F,MAAI,IAAS;AACb,QAAM,IAAuC,CAAC;AAC9C,MAAI,IAAI;AAER,SAAO,IAAI,EAAO,UAAQ;AACxB,UAAM,IAAM,EAAO,CAAA;AAEnB,QAAI,EAAI,SAAS,WAAW,EAAI,SAAS,SACvC,QAAO;AAAA,MAAE,QAAQ;AAAA,QAAE,QAAA;AAAA,QAAQ,QAAA;AAAA,MAAO;AAAA,MAAG,KAAK,IAAI;AAAA,IAAE;AAGlD,QAAI,EAAI,SAAS,UAAU,EAAI,SAAS,UAAU;AAChD,MAAA,KACI,IAAI,EAAO,UAAU,EAAO,CAAA,EAAI,SAAS,WAC3C,IAAS,EAAO,CAAA,EAAI,KAAM,KAAK,GAC/B,MAGE,IAAI,EAAO,UAAU,EAAO,CAAA,EAAI,SAAS,WAAS;AACtD;AAAA,IACF;AAEA,QAAI,EAAI,SAAS,gBAAgB,EAAI,SAAS,gBAAgB;AAC5D,MAAA,EAAO,KAAK;AAAA,QAAE,KAAK,EAAI,OAAQ,OAAU;AAAA,QAAI,MAAM;AAAA,MAAG,CAAC,GACvD;AACA;AAAA,IACF;AAEA,QAAI,EAAI,SAAS,UAAU,EAAI,SAAS,gBAAgB;AACtD,YAAM,IAAM,EAAI,OAAQ,OAAU;AAClC,MAAA;AACA,UAAI,IAAO;AACX,MAAI,IAAI,EAAO,UAAU,EAAO,CAAA,EAAI,SAAS,WAC3C,IAAO,EAAO,CAAA,EAAI,QAAQ,IAC1B,MAGE,IAAI,EAAO,UAAU,EAAO,CAAA,EAAI,SAAS,WAAS,KACtD,EAAO,KAAK;AAAA,QAAE,KAAA;AAAA,QAAK,MAAA;AAAA,MAAK,CAAC;AACzB;AAAA,IACF;AAEA,QAAI,EAAI,SAAS,gBAAgB,EAAI,SAAS,aAAa;AACzD,MAAA,EAAO,KAAK;AAAA,QACV,KAAK,EAAI,OAAQ,OAAU;AAAA,QAC3B,YAAY,EAAI,OAAQ,QAAW;AAAA,QACnC,YAAY,EAAI,OAAQ,QAAW;AAAA,QACnC,WAAW,CAAC;AAAA,MACd,CAAC,GACD;AACA;AAAA,IACF;AAEA,QAAI,EAAI,SAAS,UAAU,EAAI,SAAS,aAAa;AACnD,YAAM,IAAM,EAAI,OAAQ,OAAU,IAC5B,IAAa,EAAI,OAAQ,QAAW,KACpC,IAAa,EAAI,OAAQ,QAAW,KACpC,IAAwB,CAAC;AAG/B,WAFA,KAEO,IAAI,EAAO,UAAQ;AACxB,cAAM,IAAO,EAAO,CAAA;AACpB,YAAI,EAAK,SAAS,WAAW,EAAK,SAAS,aAAa;AACtD,UAAA;AACA;AAAA,QACF;AACA,YAAI,EAAK,SAAS,UAAU,EAAK,SAAS,YAAY;AACpD,gBAAM,IAAO,EAAK,OAAQ,QAAW;AACrC,UAAA;AACA,cAAI,IAAQ;AACZ,UAAI,IAAI,EAAO,UAAU,EAAO,CAAA,EAAI,SAAS,WAC3C,IAAQ,EAAO,CAAA,EAAI,QAAQ,IAC3B,MAGE,IAAI,EAAO,UAAU,EAAO,CAAA,EAAI,SAAS,WAAS,KACtD,EAAU,KAAK;AAAA,YAAE,MAAA;AAAA,YAAM,OAAA;AAAA,UAAM,CAAC;AAC9B;AAAA,QACF;AACA,QAAA;AAAA,MACF;AAEA,MAAA,EAAO,KAAK;AAAA,QAAE,KAAA;AAAA,QAAK,YAAA;AAAA,QAAY,YAAA;AAAA,QAAY,WAAA;AAAA,MAAU,CAAC;AACtD;AAAA,IACF;AAEA,IAAA;AAAA,EACF;AAEA,SAAO;AAAA,IAAE,QAAQ;AAAA,MAAE,QAAA;AAAA,MAAQ,QAAA;AAAA,IAAO;AAAA,IAAG,KAAK;AAAA,EAAE;AAC9C;AAMA,SAAgB,EAAa,GAA2B;AACtD,QAAM,IAAS,EAAS,CAAG,GACrB,IAAwB,CAAC;AAC/B,MAAI,IAAI;AAER,SAAO,IAAI,EAAO,UAAQ;AACxB,UAAM,IAAM,EAAO,CAAA;AACnB,QAAI,EAAI,SAAS,UAAU,EAAI,SAAS,UAAU;AAChD,YAAM,EAAE,QAAA,GAAQ,KAAA,EAAA,IAAQ,EAAkB,GAAQ,IAAI,CAAC;AACvD,MAAA,EAAQ,KAAK,CAAM,GACnB,IAAI;AACJ;AAAA,IACF;AACA,IAAA;AAAA,EACF;AAEA,SAAO;AACT;AAMA,SAAgB,EAAmB,GAAyB;AAC1D,QAAM,IAAU,EAAa,CAAG;AAChC,MAAI,EAAQ,WAAW,EAAG,OAAM,IAAI,MAAM,uCAAuC;AACjF,SAAO,EAAQ,CAAA;AACjB;AAIA,IAAM,IAAa;AAAA,GACb,IAAgB,0CAChB,IAAS;AAKf,SAAgB,EAAuB,GAA4B;AACjE,QAAM,IAAkB,CAAC,WAAW,CAAA,GAAgB;AACpD,EAAA,EAAM,KAAK,GAAG,CAAA,WAAiB,EAAU,EAAO,MAAM,CAAA,WAAY;AAElE,aAAW,KAAS,EAAO,OACzB,KAAI,EAAe,CAAK,EACtB,CAAA,EAAM,KAAK,GAAG,CAAA,sBAA4B,EAAM,GAAA,KAAQ,EAAU,EAAM,IAAI,CAAA,iBAAkB;AAAA,OACzF;AACL,UAAM,IAAO,EAAM,eAAe,MAAM,MAAM,EAAM,YAC9C,IAAO,EAAM,eAAe,MAAM,MAAM,EAAM;AACpD,IAAA,EAAM,KAAK,GAAG,CAAA,mBAAyB,EAAM,GAAA,WAAc,CAAA,WAAe,CAAA,IAAQ;AAClF,eAAW,KAAM,EAAM,UACrB,CAAA,EAAM,KACJ,GAAG,CAAA,GAAS,CAAA,mBAAyB,EAAG,IAAA,KAAS,EAAU,EAAG,KAAK,CAAA,aACrE;AAEF,IAAA,EAAM,KAAK,GAAG,CAAA,cAAoB;AAAA,EACpC;AAGF,SAAA,EAAM,KAAK,WAAW,GACf,EAAM,KAAK;AAAA,CAAI;AACxB;AAKA,SAAgB,EAAiB,GAA+B;AAC9D,QAAM,IAAkB,CACtB,GACA,eAAe,CAAA,GACjB;AAEA,aAAW,KAAU,GAAS;AAE5B,UAAM,IAAY,EAAuB,CAAM,EAC5C,MAAM;AAAA,CAAI,EACV,IAAA,CAAK,MAAS,IAAS,CAAI,EAC3B,KAAK;AAAA,CAAI;AACZ,IAAA,EAAM,KAAK,CAAS;AAAA,EACtB;AAEA,SAAA,EAAM,KAAK,eAAe,GACnB,EAAM,KAAK;AAAA,CAAI;AACxB"}
+{"version":3,"file":"marcxml.js","names":[],"sources":["../src/marcxml.ts"],"sourcesContent":["/**\n * MARCXML parser and serializer.\n *\n * Supports the Library of Congress MARCXML schema:\n * http://www.loc.gov/MARC21/slim\n *\n * Parsing is done with a hand-rolled state machine — no XML library needed.\n * The MARCXML format is sufficiently regular (fixed element names, no arbitrary\n * nesting) that a full DOM parser is unnecessary.\n */\n\nimport type { MarcRecord, ControlField, DataField, Subfield } from './types';\nimport { isControlField } from './types';\n\n// ─── XML entity handling ─────────────────────────────────────────────────────\n\nconst ENTITY_MAP: ReadonlyMap<string, string> = new Map([\n  ['amp', '&'],\n  ['lt', '<'],\n  ['gt', '>'],\n  ['quot', '\"'],\n  ['apos', \"'\"],\n]);\n\nfunction unescapeXml(text: string): string {\n  return text.replace(/&(?:#x([0-9a-fA-F]+)|#([0-9]+)|([a-zA-Z]+));/g, (_, hex, dec, name) => {\n    if (hex !== undefined) {\n      const cp = parseInt(hex, 16);\n      return cp >= 0 && cp <= 0x10ffff ? String.fromCodePoint(cp) : '�';\n    }\n    if (dec !== undefined) {\n      const cp = parseInt(dec, 10);\n      return cp >= 0 && cp <= 0x10ffff ? String.fromCodePoint(cp) : '�';\n    }\n    return ENTITY_MAP.get(name) ?? _;\n  });\n}\n\nfunction escapeXml(text: string): string {\n  return text\n    // XML 1.0 forbids most C0 control characters in document text. There is no\n    // valid XML 1.0 representation for them, so substitute the Unicode\n    // replacement character to keep the output well-formed.\n    .replace(/[\\x00-\\x08\\x0B\\x0C\\x0E-\\x1F]/g, '�')\n    .replace(/&/g, '&amp;')\n    .replace(/</g, '&lt;')\n    .replace(/>/g, '&gt;')\n    .replace(/\"/g, '&quot;')\n    // Preserve literal CR through the XML round-trip: XML parsers normalize\n    // bare \\r and \\r\\n to \\n, so we must encode CR as a numeric reference.\n    .replace(/\\r/g, '&#13;');\n}\n\n// ─── Minimal tokeniser ────────────────────────────────────────────────────────\n\ninterface Token {\n  type: 'open' | 'close' | 'self-close' | 'text';\n  /** Local name (no namespace prefix) */\n  name?: string;\n  attrs?: Record<string, string>;\n  text?: string;\n}\n\n/**\n * Strip namespace prefix from a tag name, e.g. \"marc:record\" → \"record\".\n */\nfunction localName(raw: string): string {\n  const colon = raw.indexOf(':');\n  return colon === -1 ? raw : raw.slice(colon + 1);\n}\n\n/**\n * Parse `key=\"value\"` pairs out of an attribute string.\n */\nfunction parseAttrs(attrStr: string): Record<string, string> {\n  const attrs: Record<string, string> = {};\n  const re = /([a-zA-Z_:][^\\s=]*)\\s*=\\s*(?:\"([^\"]*)\"|'([^']*)')/g;\n  let m: RegExpExecArray | null;\n  while ((m = re.exec(attrStr)) !== null) {\n    const key = localName(m[1]!);\n    attrs[key] = unescapeXml(m[2] ?? m[3] ?? '');\n  }\n  return attrs;\n}\n\n/**\n * Tokenise an XML string into a flat stream of open/close/text tokens.\n * Skips processing instructions, comments, and DOCTYPE declarations.\n * Sufficient for the well-constrained MARCXML format.\n */\nfunction tokenise(xml: string): Token[] {\n  const tokens: Token[] = [];\n  let i = 0;\n\n  while (i < xml.length) {\n    const ltPos = xml.indexOf('<', i);\n\n    // Text node before next tag\n    if (ltPos === -1) {\n      const text = xml.slice(i).trim();\n      if (text) tokens.push({ type: 'text', text: unescapeXml(xml.slice(i)) });\n      break;\n    }\n\n    if (ltPos > i) {\n      const raw = xml.slice(i, ltPos);\n      const text = raw.trim();\n      if (text) tokens.push({ type: 'text', text: unescapeXml(raw) });\n    }\n\n    const gtPos = xml.indexOf('>', ltPos);\n    if (gtPos === -1) break;\n\n    const tag = xml.slice(ltPos + 1, gtPos);\n\n    // Skip comments, PIs, DOCTYPE\n    if (tag.startsWith('!') || tag.startsWith('?')) {\n      i = gtPos + 1;\n      continue;\n    }\n\n    if (tag.startsWith('/')) {\n      tokens.push({ type: 'close', name: localName(tag.slice(1).trim()) });\n    } else if (tag.endsWith('/')) {\n      const inner = tag.slice(0, -1).trim();\n      const spaceIdx = inner.search(/\\s/);\n      const name = spaceIdx === -1 ? inner : inner.slice(0, spaceIdx);\n      const attrStr = spaceIdx === -1 ? '' : inner.slice(spaceIdx);\n      tokens.push({ type: 'self-close', name: localName(name), attrs: parseAttrs(attrStr) });\n    } else {\n      const spaceIdx = tag.search(/\\s/);\n      const name = spaceIdx === -1 ? tag : tag.slice(0, spaceIdx);\n      const attrStr = spaceIdx === -1 ? '' : tag.slice(spaceIdx);\n      tokens.push({ type: 'open', name: localName(name), attrs: parseAttrs(attrStr) });\n    }\n\n    i = gtPos + 1;\n  }\n\n  return tokens;\n}\n\n// ─── MARCXML parser ───────────────────────────────────────────────────────────\n\n/**\n * Parse one `<record>` element's worth of tokens into a MarcRecord.\n * Mutates `pos` via the returned index.\n */\nfunction parseRecordTokens(tokens: Token[], start: number): { record: MarcRecord; end: number } {\n  let leader = '';\n  const fields: (ControlField | DataField)[] = [];\n  let i = start;\n\n  while (i < tokens.length) {\n    const tok = tokens[i]!;\n\n    if (tok.type === 'close' && tok.name === 'record') {\n      return { record: { leader, fields }, end: i + 1 };\n    }\n\n    if (tok.type === 'open' && tok.name === 'leader') {\n      i++;\n      if (i < tokens.length && tokens[i]!.type === 'text') {\n        leader = tokens[i]!.text!.trim();\n        i++;\n      }\n      // consume </leader>\n      if (i < tokens.length && tokens[i]!.type === 'close') i++;\n      continue;\n    }\n\n    if (tok.type === 'self-close' && tok.name === 'controlfield') {\n      fields.push({ tag: tok.attrs?.['tag'] ?? '', data: '' });\n      i++;\n      continue;\n    }\n\n    if (tok.type === 'open' && tok.name === 'controlfield') {\n      const tag = tok.attrs?.['tag'] ?? '';\n      i++;\n      let data = '';\n      if (i < tokens.length && tokens[i]!.type === 'text') {\n        data = tokens[i]!.text ?? '';\n        i++;\n      }\n      // consume </controlfield>\n      if (i < tokens.length && tokens[i]!.type === 'close') i++;\n      fields.push({ tag, data });\n      continue;\n    }\n\n    if (tok.type === 'self-close' && tok.name === 'datafield') {\n      fields.push({\n        tag: tok.attrs?.['tag'] ?? '',\n        indicator1: tok.attrs?.['ind1'] ?? ' ',\n        indicator2: tok.attrs?.['ind2'] ?? ' ',\n        subfields: [],\n      });\n      i++;\n      continue;\n    }\n\n    if (tok.type === 'open' && tok.name === 'datafield') {\n      const tag = tok.attrs?.['tag'] ?? '';\n      const indicator1 = tok.attrs?.['ind1'] ?? ' ';\n      const indicator2 = tok.attrs?.['ind2'] ?? ' ';\n      const subfields: Subfield[] = [];\n      i++;\n\n      while (i < tokens.length) {\n        const stok = tokens[i]!;\n        if (stok.type === 'close' && stok.name === 'datafield') {\n          i++;\n          break;\n        }\n        if (stok.type === 'open' && stok.name === 'subfield') {\n          const code = stok.attrs?.['code'] ?? '';\n          i++;\n          let value = '';\n          if (i < tokens.length && tokens[i]!.type === 'text') {\n            value = tokens[i]!.text ?? '';\n            i++;\n          }\n          // consume </subfield>\n          if (i < tokens.length && tokens[i]!.type === 'close') i++;\n          subfields.push({ code, value });\n          continue;\n        }\n        i++;\n      }\n\n      fields.push({ tag, indicator1, indicator2, subfields });\n      continue;\n    }\n\n    i++;\n  }\n\n  return { record: { leader, fields }, end: i };\n}\n\n/**\n * Parse a MARCXML string containing one `<collection>` or one bare `<record>`.\n * Returns all records found.\n */\nexport function parseMarcXml(xml: string): MarcRecord[] {\n  const tokens = tokenise(xml);\n  const records: MarcRecord[] = [];\n  let i = 0;\n\n  while (i < tokens.length) {\n    const tok = tokens[i]!;\n    if (tok.type === 'open' && tok.name === 'record') {\n      const { record, end } = parseRecordTokens(tokens, i + 1);\n      records.push(record);\n      i = end;\n      continue;\n    }\n    i++;\n  }\n\n  return records;\n}\n\n// ─── MARCXML serializer ───────────────────────────────────────────────────────\n\nconst XML_HEADER = '<?xml version=\"1.0\" encoding=\"UTF-8\"?>\\n';\nconst COLLECTION_NS = 'xmlns=\"http://www.loc.gov/MARC21/slim\"';\nconst INDENT = '  ';\n\nfunction serializeMarcXmlRecord(record: MarcRecord): string {\n  const lines: string[] = [`<record ${COLLECTION_NS}>`];\n  lines.push(`${INDENT}<leader>${escapeXml(record.leader)}</leader>`);\n\n  for (const field of record.fields) {\n    if (isControlField(field)) {\n      lines.push(`${INDENT}<controlfield tag=\"${field.tag}\">${escapeXml(field.data)}</controlfield>`);\n    } else {\n      const ind1 = field.indicator1 === ' ' ? ' ' : field.indicator1;\n      const ind2 = field.indicator2 === ' ' ? ' ' : field.indicator2;\n      lines.push(`${INDENT}<datafield tag=\"${field.tag}\" ind1=\"${ind1}\" ind2=\"${ind2}\">`);\n      for (const sf of field.subfields) {\n        lines.push(\n          `${INDENT}${INDENT}<subfield code=\"${sf.code}\">${escapeXml(sf.value)}</subfield>`\n        );\n      }\n      lines.push(`${INDENT}</datafield>`);\n    }\n  }\n\n  lines.push('</record>');\n  return lines.join('\\n');\n}\n\n/**\n * Serialize one or more MarcRecords into a MARCXML `<collection>` document.\n */\nexport function serializeMarcXml(records: MarcRecord[]): string {\n  const parts: string[] = [\n    XML_HEADER,\n    `<collection ${COLLECTION_NS}>`,\n  ];\n\n  for (const record of records) {\n    // Indent each record element by one level inside <collection>\n    const recordXml = serializeMarcXmlRecord(record)\n      .split('\\n')\n      .map((line) => INDENT + line)\n      .join('\\n');\n    parts.push(recordXml);\n  }\n\n  parts.push('</collection>');\n  return parts.join('\\n');\n}\n"],"mappings":"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"}

package/dist/parser.d.ts

@@ -1,43 +1,14 @@
-import { MarcRecord, ParseOptions, ParseResult } from './types';
+import { MarcRecord, ParseOptions } from './types';
 /**
- * Parse a MARC21 record from ISO2709 binary format.
+ * Parse a concatenated ISO2709 binary stream into an array of MARC records.
  *
- * @param buffer - The binary data to parse (use Uint8Array for browser compatibility)
- * @param options - Parsing options (strict mode, max warnings)
- * @returns Parse result containing the record and any warnings
+ * Records in the stream are separated by 0x1D (RECORD_TERMINATOR). Each slice
+ * is parsed with {@link parseMarcRecord}; slices that produce a null record
+ * (e.g. due to encoding errors in lenient mode) are silently skipped.
  *
- * @example
- * ```typescript
- * const buffer = new Uint8Array([...]); // MARC21 binary data
- * const result = parseMarcRecord(buffer);
- *
- * if (result.record) {
- *   console.log('Parsed successfully');
- * }
- *
- * if (result.warnings.length > 0) {
- *   console.warn('Warnings:', result.warnings);
- * }
- * ```
- */
-export declare function parseMarcRecord(buffer: Uint8Array, options?: ParseOptions): ParseResult;
-/**
- * Convenience wrapper for strict parsing.
- * Throws an error if parsing fails.
- *
- * @param buffer - The binary data to parse
- * @returns The parsed MARC record
- * @throws Error if parsing fails
- *
- * @example
- * ```typescript
- * try {
- *   const record = parseMarcRecordStrict(buffer);
- *   console.log('Title:', title(record));
- * } catch (error) {
- *   console.error('Parsing failed:', error);
- * }
- * ```
+ * @param buffer - Binary data containing one or more concatenated MARC records
+ * @param options - Parsing options forwarded to the per-record parser
+ * @returns Array of successfully parsed MARC records
  */
-export declare function parseMarcRecordStrict(buffer: Uint8Array): MarcRecord;
+export declare function parseMarcBinary(buffer: Uint8Array, options?: ParseOptions): MarcRecord[];
 //# sourceMappingURL=parser.d.ts.map

package/dist/serializer.d.ts

@@ -1,4 +1,4 @@
-import { MarcRecord, MarcWarning } from './types';
+import { MarcRecord } from './types';
 /**
  * Options for serializing MARC records.
  */
@@ -13,45 +13,14 @@ export interface SerializeOptions {
     readonly encoding?: 'utf8' | 'marc8';
 }
 /**
- * Serialize a MARC record to ISO2709 binary format.
+ * Serialize an array of MARC records to a concatenated ISO2709 binary stream.
  *
- * @param record - The MARC record to serialize
- * @returns Binary representation of the record (Uint8Array for browser compatibility)
+ * Each record is individually serialized (with its own 0x1D terminator) and
+ * the results are concatenated into a single Uint8Array.
  *
- * @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' }],
- *     },
- *   ],
- * };
- *
- * const buffer = serializeMarcRecord(record);
- * // Can now be written to file or transmitted
- * ```
- */
-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[];
-}
-/**
- * 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.
+ * @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 serializeMarcRecordWithWarnings(record: MarcRecord, options?: SerializeOptions): SerializeResult;
+export declare function serializeMarcBinary(records: MarcRecord[], options?: SerializeOptions): Uint8Array;
 //# sourceMappingURL=serializer.d.ts.map

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.2.0",
   "description": "TypeScript MARC21 library for Node.js and browsers",
   "type": "module",
   "main": "./dist/index.cjs",