@eksml/xml 0.1.0

package/dist/sax.mjs

@@ -0,0 +1,70 @@
+import { n as HTML_VOID_ELEMENTS, t as HTML_RAW_CONTENT_TAGS } from "./htmlConstants-D6fsKbZ-.mjs";
+import { t as saxEngine } from "./saxEngine-BDnD7ruG.mjs";
+//#region src/sax.ts
+/**
+* Create an EventEmitter-style SAX parser.
+*
+* Uses the internal SAX engine, but wraps it with `.on()` / `.off()` methods
+* so handlers can be added and removed dynamically.
+*
+* @param options - Parser options (html mode, selfClosingTags, rawContentTags).
+* @returns A SaxParser with `.on()`, `.off()`, `.write()`, `.close()`.
+*/
+function createSaxParser(options) {
+	const opts = options ?? {};
+	const isHtml = opts.html === true;
+	const selfClosingTags = opts.selfClosingTags ?? (isHtml ? HTML_VOID_ELEMENTS : []);
+	const rawContentTags = opts.rawContentTags ?? (isHtml ? HTML_RAW_CONTENT_TAGS : []);
+	const listeners = {
+		openTag: /* @__PURE__ */ new Set(),
+		closeTag: /* @__PURE__ */ new Set(),
+		text: /* @__PURE__ */ new Set(),
+		cdata: /* @__PURE__ */ new Set(),
+		comment: /* @__PURE__ */ new Set(),
+		processingInstruction: /* @__PURE__ */ new Set(),
+		doctype: /* @__PURE__ */ new Set()
+	};
+	const parser = saxEngine({
+		onOpenTag(tagName, attributes) {
+			for (const handler of listeners.openTag) handler(tagName, attributes);
+		},
+		onCloseTag(tagName) {
+			for (const handler of listeners.closeTag) handler(tagName);
+		},
+		onText(text) {
+			for (const handler of listeners.text) handler(text);
+		},
+		onCdata(data) {
+			for (const handler of listeners.cdata) handler(data);
+		},
+		onComment(comment) {
+			for (const handler of listeners.comment) handler(comment);
+		},
+		onProcessingInstruction(name, body) {
+			for (const handler of listeners.processingInstruction) handler(name, body);
+		},
+		onDoctype(tagName, attributes) {
+			for (const handler of listeners.doctype) handler(tagName, attributes);
+		},
+		selfClosingTags,
+		rawContentTags
+	});
+	return {
+		on(event, handler) {
+			listeners[event].add(handler);
+		},
+		off(event, handler) {
+			listeners[event].delete(handler);
+		},
+		write(chunk) {
+			parser.write(chunk);
+		},
+		close() {
+			parser.close();
+		}
+	};
+}
+//#endregion
+export { createSaxParser };
+
+//# sourceMappingURL=sax.mjs.map

package/dist/sax.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"sax.mjs","names":[],"sources":["../src/sax.ts"],"sourcesContent":["/**\n * createSaxParser — EventEmitter-style SAX parser built on the internal SAX engine.\n *\n * Provides dynamic `.on()` / `.off()` handler management on top of the core\n * SAX tokenizer.\n *\n * @example\n * ```ts\n * import { createSaxParser } from '@eksml/xml/sax';\n *\n * const parser = createSaxParser({ html: true });\n *\n * parser.on('openTag', (tagName, attrs) => console.log(tagName, attrs));\n * parser.on('text', (text) => console.log(text));\n *\n * parser.write('<div><br><p>Hello</p></div>');\n * parser.close();\n * ```\n */\n\nimport type { SaxEngineHandlers, Attributes } from '#src/saxEngine.ts';\nimport { saxEngine } from '#src/saxEngine.ts';\nimport {\n  HTML_VOID_ELEMENTS,\n  HTML_RAW_CONTENT_TAGS,\n} from '#src/utilities/htmlConstants.ts';\n\n// ---------------------------------------------------------------------------\n// SAX event types\n// ---------------------------------------------------------------------------\n\n/** Event name → handler signature map for the SAX parser. */\nexport interface SaxEventMap {\n  openTag: (tagName: string, attributes: Attributes) => void;\n  closeTag: (tagName: string) => void;\n  text: (text: string) => void;\n  cdata: (data: string) => void;\n  comment: (comment: string) => void;\n  processingInstruction: (name: string, body: string) => void;\n  doctype: (tagName: string, attributes: Attributes) => void;\n}\n\n/** SAX event names. */\nexport type SaxEventName = keyof SaxEventMap;\n\n/** EventEmitter-style SAX parser returned by `createSaxParser()`. */\nexport interface SaxParser {\n  /** Register an event handler. */\n  on<E extends SaxEventName>(event: E, handler: SaxEventMap[E]): void;\n  /** Remove an event handler. */\n  off<E extends SaxEventName>(event: E, handler: SaxEventMap[E]): void;\n  /** Feed a chunk of XML to the parser. */\n  write(chunk: string): void;\n  /** Signal end-of-input and flush any remaining buffered data. */\n  close(): void;\n}\n\n// ---------------------------------------------------------------------------\n// SAX parser options\n// ---------------------------------------------------------------------------\n\n/** Options for `createSaxParser()`. */\nexport interface SaxParserOptions {\n  /**\n   * Enable HTML mode. Sets `selfClosingTags` and `rawContentTags` to their\n   * HTML defaults unless explicitly provided.\n   */\n  html?: boolean;\n  /** Tag names that are self-closing (void). Defaults to HTML voids when `html: true`. */\n  selfClosingTags?: string[];\n  /** Tag names whose content is raw text. Defaults to `['script', 'style']` when `html: true`. */\n  rawContentTags?: string[];\n}\n\n// ---------------------------------------------------------------------------\n// createSaxParser\n// ---------------------------------------------------------------------------\n\n/**\n * Create an EventEmitter-style SAX parser.\n *\n * Uses the internal SAX engine, but wraps it with `.on()` / `.off()` methods\n * so handlers can be added and removed dynamically.\n *\n * @param options - Parser options (html mode, selfClosingTags, rawContentTags).\n * @returns A SaxParser with `.on()`, `.off()`, `.write()`, `.close()`.\n */\nexport function createSaxParser(options?: SaxParserOptions): SaxParser {\n  const opts = options ?? {};\n\n  // Resolve HTML-mode defaults (same logic as parse() and XmlParseStream)\n  const isHtml = opts.html === true;\n  const selfClosingTags =\n    opts.selfClosingTags ?? (isHtml ? HTML_VOID_ELEMENTS : []);\n  const rawContentTags =\n    opts.rawContentTags ?? (isHtml ? HTML_RAW_CONTENT_TAGS : []);\n\n  // Listener sets — one Set per event type\n  const listeners: {\n    [E in SaxEventName]: Set<SaxEventMap[E]>;\n  } = {\n    openTag: new Set(),\n    closeTag: new Set(),\n    text: new Set(),\n    cdata: new Set(),\n    comment: new Set(),\n    processingInstruction: new Set(),\n    doctype: new Set(),\n  };\n\n  // Bridge handlers: call all registered listeners for each event\n  const handlers: SaxEngineHandlers = {\n    onOpenTag(tagName: string, attributes: Attributes) {\n      for (const handler of listeners.openTag) handler(tagName, attributes);\n    },\n    onCloseTag(tagName: string) {\n      for (const handler of listeners.closeTag) handler(tagName);\n    },\n    onText(text: string) {\n      for (const handler of listeners.text) handler(text);\n    },\n    onCdata(data: string) {\n      for (const handler of listeners.cdata) handler(data);\n    },\n    onComment(comment: string) {\n      for (const handler of listeners.comment) handler(comment);\n    },\n    onProcessingInstruction(name: string, body: string) {\n      for (const handler of listeners.processingInstruction)\n        handler(name, body);\n    },\n    onDoctype(tagName: string, attributes: Attributes) {\n      for (const handler of listeners.doctype) handler(tagName, attributes);\n    },\n  };\n\n  const parser = saxEngine({\n    ...handlers,\n    selfClosingTags,\n    rawContentTags,\n  });\n\n  return {\n    on<E extends SaxEventName>(event: E, handler: SaxEventMap[E]): void {\n      listeners[event].add(handler);\n    },\n    off<E extends SaxEventName>(event: E, handler: SaxEventMap[E]): void {\n      listeners[event].delete(handler);\n    },\n    write(chunk: string): void {\n      parser.write(chunk);\n    },\n    close(): void {\n      parser.close();\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;AAuFA,SAAgB,gBAAgB,SAAuC;CACrE,MAAM,OAAO,WAAW,EAAE;CAG1B,MAAM,SAAS,KAAK,SAAS;CAC7B,MAAM,kBACJ,KAAK,oBAAoB,SAAS,qBAAqB,EAAE;CAC3D,MAAM,iBACJ,KAAK,mBAAmB,SAAS,wBAAwB,EAAE;CAG7D,MAAM,YAEF;EACF,yBAAS,IAAI,KAAK;EAClB,0BAAU,IAAI,KAAK;EACnB,sBAAM,IAAI,KAAK;EACf,uBAAO,IAAI,KAAK;EAChB,yBAAS,IAAI,KAAK;EAClB,uCAAuB,IAAI,KAAK;EAChC,yBAAS,IAAI,KAAK;EACnB;CA4BD,MAAM,SAAS,UAAU;EAxBvB,UAAU,SAAiB,YAAwB;AACjD,QAAK,MAAM,WAAW,UAAU,QAAS,SAAQ,SAAS,WAAW;;EAEvE,WAAW,SAAiB;AAC1B,QAAK,MAAM,WAAW,UAAU,SAAU,SAAQ,QAAQ;;EAE5D,OAAO,MAAc;AACnB,QAAK,MAAM,WAAW,UAAU,KAAM,SAAQ,KAAK;;EAErD,QAAQ,MAAc;AACpB,QAAK,MAAM,WAAW,UAAU,MAAO,SAAQ,KAAK;;EAEtD,UAAU,SAAiB;AACzB,QAAK,MAAM,WAAW,UAAU,QAAS,SAAQ,QAAQ;;EAE3D,wBAAwB,MAAc,MAAc;AAClD,QAAK,MAAM,WAAW,UAAU,sBAC9B,SAAQ,MAAM,KAAK;;EAEvB,UAAU,SAAiB,YAAwB;AACjD,QAAK,MAAM,WAAW,UAAU,QAAS,SAAQ,SAAS,WAAW;;EAMvE;EACA;EACD,CAAC;AAEF,QAAO;EACL,GAA2B,OAAU,SAA+B;AAClE,aAAU,OAAO,IAAI,QAAQ;;EAE/B,IAA4B,OAAU,SAA+B;AACnE,aAAU,OAAO,OAAO,QAAQ;;EAElC,MAAM,OAAqB;AACzB,UAAO,MAAM,MAAM;;EAErB,QAAc;AACZ,UAAO,OAAO;;EAEjB"}