@flighthq/xml 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export type { XmlElement } from './xmlParse';
+export { parseXmlAttributes, parseXmlDocument } from './xmlParse';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { parseXmlAttributes, parseXmlDocument } from './xmlParse';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC"}

package/dist/xmlParse.d.ts

@@ -0,0 +1,16 @@
+export interface XmlElement {
+    attributes: Record<string, string>;
+    /** Direct child elements. Text content and comments are discarded as elements. */
+    children: XmlElement[];
+    name: string;
+    /** Raw text content (trimmed), concatenation of text nodes. */
+    text: string;
+}
+/** Parse all attributes from an element's attribute string.
+ *  Supports double-quoted and single-quoted values and XML entity escapes. */
+export declare function parseXmlAttributes(attrs: string): Record<string, string>;
+/** Parse a simple XML document into a tree of XmlElement objects.
+ *  Returns the root element, or null when the input contains no recognizable element.
+ *  Does not validate DTD, namespaces, or processing instructions. */
+export declare function parseXmlDocument(xml: string): XmlElement | null;
+//# sourceMappingURL=xmlParse.d.ts.map

package/dist/xmlParse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xmlParse.d.ts","sourceRoot":"","sources":["../src/xmlParse.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,kFAAkF;IAClF,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,IAAI,EAAE,MAAM,CAAC;CACd;AAED;8EAC8E;AAC9E,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAWxE;AAED;;qEAEqE;AACrE,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAW/D"}

package/dist/xmlParse.js

@@ -0,0 +1,120 @@
+// Pull-style XML parser sufficient for atlas and plist file formats.
+// Not a general-purpose XML parser, but handles namespaced/extra attributes and elements,
+// both double-quoted and single-quoted attribute values, XML entity escapes
+// (&amp; &lt; &gt; &quot; &apos; plus numeric references), XML comments (<!-- -->),
+// CDATA sections (<![CDATA[...]]>), the XML declaration, and DOCTYPE.
+/** Parse all attributes from an element's attribute string.
+ *  Supports double-quoted and single-quoted values and XML entity escapes. */
+export function parseXmlAttributes(attrs) {
+    const result = {};
+    // Match name="value" or name='value', capturing both quote styles
+    const re = /([\w:.-]+)\s*=\s*(?:"([^"]*)"|'([^']*)')/g;
+    let m;
+    while ((m = re.exec(attrs)) !== null) {
+        const attrName = m[1];
+        const value = m[2] !== undefined ? m[2] : (m[3] ?? '');
+        result[attrName] = decodeXmlEntities(value);
+    }
+    return result;
+}
+/** Parse a simple XML document into a tree of XmlElement objects.
+ *  Returns the root element, or null when the input contains no recognizable element.
+ *  Does not validate DTD, namespaces, or processing instructions. */
+export function parseXmlDocument(xml) {
+    // Normalize: strip comments, process CDATA, normalize line endings
+    let src = stripCdata(stripXmlComments(xml)).replace(/\r\n?/g, '\n');
+    // Strip XML declaration and DOCTYPE if present
+    src = src
+        .replace(/<\?[\s\S]*?\?>/g, '')
+        .replace(/<!DOCTYPE[^>]*>/gi, '')
+        .trim();
+    return parseElement(src, { pos: 0 });
+}
+const XML_ENTITIES = {
+    amp: '&',
+    apos: "'",
+    gt: '>',
+    lt: '<',
+    quot: '"',
+};
+function decodeXmlEntities(s) {
+    return s.replace(/&(?:#(\d+)|#x([\da-fA-F]+)|(\w+));/g, (_, dec, hex, name) => {
+        if (dec)
+            return String.fromCodePoint(parseInt(dec, 10));
+        if (hex)
+            return String.fromCodePoint(parseInt(hex, 16));
+        return XML_ENTITIES[name] ?? _;
+    });
+}
+function parseElement(src, state) {
+    skipWhitespace(src, state);
+    if (state.pos >= src.length || src[state.pos] !== '<')
+        return null;
+    // Find the end of the opening tag
+    state.pos++; // consume '<'
+    // Skip processing instructions
+    if (src[state.pos] === '?') {
+        const end = src.indexOf('?>', state.pos);
+        state.pos = end >= 0 ? end + 2 : src.length;
+        return parseElement(src, state);
+    }
+    // Read element name
+    const nameStart = state.pos;
+    while (state.pos < src.length && !/[\s>/]/.test(src[state.pos]))
+        state.pos++;
+    const name = src.slice(nameStart, state.pos);
+    if (!name)
+        return null;
+    skipWhitespace(src, state);
+    // Read attributes (everything up to '>' or '/')
+    let attrsStr = '';
+    while (state.pos < src.length && src[state.pos] !== '>' && !(src[state.pos] === '/' && src[state.pos + 1] === '>')) {
+        attrsStr += src[state.pos];
+        state.pos++;
+    }
+    const selfClosing = src[state.pos] === '/';
+    state.pos += selfClosing ? 2 : 1; // consume '/>' or '>'
+    const attributes = parseXmlAttributes(attrsStr);
+    const children = [];
+    let text = '';
+    if (!selfClosing) {
+        // Parse children until closing tag
+        while (state.pos < src.length) {
+            skipWhitespace(src, state);
+            if (state.pos >= src.length)
+                break;
+            if (src[state.pos] !== '<') {
+                // Text node
+                const textStart = state.pos;
+                while (state.pos < src.length && src[state.pos] !== '<')
+                    state.pos++;
+                text += decodeXmlEntities(src.slice(textStart, state.pos).trim());
+                continue;
+            }
+            // Check for closing tag
+            if (src[state.pos + 1] === '/') {
+                // Skip to '>'
+                while (state.pos < src.length && src[state.pos] !== '>')
+                    state.pos++;
+                state.pos++; // consume '>'
+                break;
+            }
+            const child = parseElement(src, state);
+            if (child)
+                children.push(child);
+        }
+    }
+    return { attributes, children, name, text };
+}
+function skipWhitespace(src, state) {
+    while (state.pos < src.length && /\s/.test(src[state.pos]))
+        state.pos++;
+}
+function stripCdata(xml) {
+    // Replace CDATA with its raw content
+    return xml.replace(/<!\[CDATA\[[\s\S]*?]]>/g, (m) => m.slice(9, m.length - 3));
+}
+function stripXmlComments(xml) {
+    return xml.replace(/<!--[\s\S]*?-->/g, '');
+}
+//# sourceMappingURL=xmlParse.js.map

package/dist/xmlParse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"xmlParse.js","sourceRoot":"","sources":["../src/xmlParse.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@flighthq/xml",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src/**/*.test.ts",
+    "!dist/**/*.test.js",
+    "!dist/**/*.test.d.ts",
+    "!dist/**/*.test.js.map",
+    "!dist/**/*.test.d.ts.map"
+  ],
+  "scripts": {
+    "build": "tsc -b",
+    "clean": "tsc -b --clean",
+    "test": "vitest run --config vitest.config.ts",
+    "test:watch": "vitest --watch --config vitest.config.ts",
+    "prepack": "npm run clean && npm run clean:dist && npm run build",
+    "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
+  },
+  "devDependencies": {
+    "typescript": "^5.3.0"
+  },
+  "description": "Lightweight pull-style XML parser: parseXmlDocument and parseXmlAttributes for atlas, plist, and sprite-sheet format files",
+  "sideEffects": false
+}

package/src/xmlParse.test.ts

@@ -0,0 +1,138 @@
+import { parseXmlAttributes, parseXmlDocument } from './xmlParse';
+
+describe('parseXmlAttributes', () => {
+  it('parses double-quoted attributes', () => {
+    const attrs = parseXmlAttributes('name="hero" x="10" y="20"');
+    expect(attrs['name']).toBe('hero');
+    expect(attrs['x']).toBe('10');
+    expect(attrs['y']).toBe('20');
+  });
+
+  it('parses single-quoted attributes', () => {
+    const attrs = parseXmlAttributes("name='hero' x='10'");
+    expect(attrs['name']).toBe('hero');
+    expect(attrs['x']).toBe('10');
+  });
+
+  it('decodes XML entity &', () => {
+    const attrs = parseXmlAttributes('name="a&b"');
+    expect(attrs['name']).toBe('a&b');
+  });
+
+  it('decodes XML entity < and >', () => {
+    const attrs = parseXmlAttributes('name="a<b>c"');
+    expect(attrs['name']).toBe('a<b>c');
+  });
+
+  it('decodes XML entity &quot;', () => {
+    const attrs = parseXmlAttributes("name='say &quot;hi&quot;'");
+    expect(attrs['name']).toBe('say "hi"');
+  });
+
+  it('decodes XML entity &apos;', () => {
+    const attrs = parseXmlAttributes('name="it&apos;s"');
+    expect(attrs['name']).toBe("it's");
+  });
+
+  it('decodes numeric character references', () => {
+    const attrs = parseXmlAttributes('name="&#65;"');
+    expect(attrs['name']).toBe('A');
+  });
+
+  it('returns empty object for empty string', () => {
+    expect(parseXmlAttributes('')).toEqual({});
+  });
+});
+
+describe('parseXmlDocument', () => {
+  it('returns the first top-level element as the root', () => {
+    const root = parseXmlDocument('<TextureAtlas imagePath="sheet.png"></TextureAtlas>');
+    expect(root).not.toBeNull();
+    expect(root?.name).toBe('TextureAtlas');
+    expect(root?.attributes.imagePath).toBe('sheet.png');
+    expect(root?.children).toEqual([]);
+  });
+
+  it('parses multiple attributes on a single element', () => {
+    const root = parseXmlDocument('<sub x="10" y="20" width="32" height="64"/>');
+    expect(root?.attributes).toEqual({ x: '10', y: '20', width: '32', height: '64' });
+  });
+
+  it('accepts both single and double quoted attribute values', () => {
+    const root = parseXmlDocument(`<node a='single' b="double"/>`);
+    expect(root?.attributes).toEqual({ a: 'single', b: 'double' });
+  });
+
+  it('nests children under their parent open tag', () => {
+    const xml =
+      '<TextureAtlas imagePath="s.png">' +
+      '<SubTexture name="a" x="0" y="0"/>' +
+      '<SubTexture name="b" x="8" y="8"/>' +
+      '</TextureAtlas>';
+    const root = parseXmlDocument(xml);
+    expect(root?.name).toBe('TextureAtlas');
+    expect(root?.children.length).toBe(2);
+    expect(root?.children[0].name).toBe('SubTexture');
+    expect(root?.children[0].attributes.name).toBe('a');
+    expect(root?.children[1].attributes.name).toBe('b');
+  });
+
+  it('treats self-closing tags as leaves rather than opening a scope', () => {
+    const xml = '<root><leaf/><sibling/></root>';
+    const root = parseXmlDocument(xml);
+    // Both leaf and sibling are direct children of root, not nested.
+    expect(root?.children.map((c) => c.name)).toEqual(['leaf', 'sibling']);
+  });
+
+  it('supports deep nesting across multiple levels', () => {
+    const xml = '<a><b><c value="deep"/></b></a>';
+    const root = parseXmlDocument(xml);
+    expect(root?.name).toBe('a');
+    const b = root?.children[0];
+    expect(b?.name).toBe('b');
+    const c = b?.children[0];
+    expect(c?.name).toBe('c');
+    expect(c?.attributes.value).toBe('deep');
+  });
+
+  it('returns null when the input contains no recognizable element', () => {
+    expect(parseXmlDocument('')).toBeNull();
+    expect(parseXmlDocument('   just text, no tags   ')).toBeNull();
+  });
+
+  it('tolerates unbalanced close tags without underflowing the stack', () => {
+    // An extra close tag must not pop past the implicit root or throw.
+    const root = parseXmlDocument('<a></a></b>');
+    expect(root?.name).toBe('a');
+  });
+
+  it('returns the first element when several share the top level', () => {
+    const root = parseXmlDocument('<first/><second/>');
+    expect(root?.name).toBe('first');
+  });
+
+  it('allows dots, hyphens, and underscores in tag and attribute names', () => {
+    const root = parseXmlDocument('<my-tag.v2 data_key="x"/>');
+    expect(root?.name).toBe('my-tag.v2');
+    expect(root?.attributes.data_key).toBe('x');
+  });
+
+  it('strips XML comments', () => {
+    const xml = '<root><!-- This is a comment --><child/></root>';
+    const doc = parseXmlDocument(xml);
+    expect(doc?.children).toHaveLength(1);
+    expect(doc?.children[0]?.name).toBe('child');
+  });
+
+  it('strips the XML declaration', () => {
+    const xml = '<?xml version="1.0" encoding="UTF-8"?><root/>';
+    const doc = parseXmlDocument(xml);
+    expect(doc?.name).toBe('root');
+  });
+
+  it('parses text content', () => {
+    const xml = '<root><key>hello</key></root>';
+    const doc = parseXmlDocument(xml);
+    expect(doc?.children[0]?.text).toBe('hello');
+  });
+});