@ifc-lite/ids 3.1.0 → 3.3.1

package/dist/writer/constraint.js

@@ -0,0 +1,142 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+function refuse(what) {
+    throw new Error(`writeIdsXml: ${what} are not supported by this writer`);
+}
+/**
+ * The facet families of one `<xs:restriction>`: the primary constraint and
+ * its conjunctive `and` siblings (see `constraint-types.ts`). One restriction
+ * holds one base and at most one family of each kind, since XSD ORs sibling
+ * patterns and enumerations; anything else has no single-restriction XML and
+ * is refused, never written as a weaker or different check.
+ */
+function restrictionFamilies(constraint) {
+    const families = [constraint];
+    for (const sibling of constraint.and ?? []) {
+        if (sibling.type === 'simpleValue')
+            refuse('simple values inside a conjunctive restriction');
+        if (sibling.and?.length)
+            refuse('nested conjunctive restriction facets');
+        if (families.some((family) => family.type === sibling.type))
+            refuse(`two ${sibling.type} families in one conjunctive restriction`);
+        families.push(sibling);
+    }
+    const bases = new Set(families.map((family) => family.base).filter((base) => base !== undefined));
+    if (bases.size > 1)
+        refuse('conjunctive restriction facets with different bases');
+    return families;
+}
+/** `xs:length`, `xs:minLength`, `xs:maxLength` and the digit counts are `xs:nonNegativeInteger`. */
+function countLexical(facet, value) {
+    if (!Number.isSafeInteger(value) || value < 0) {
+        throw new Error(`writeIdsXml: ${facet} must be a non-negative integer, got ${value}`);
+    }
+    return String(value);
+}
+/** Bases whose lexical space has an exponent: `xs:double` and `xs:float`. */
+const EXPONENT_BASES = new Set(['xs:double', 'xs:float']);
+/**
+ * A bound in its base's lexical space. `String(1e-7)` is `"1e-7"`, which
+ * `xs:decimal` and the integer types cannot read, so the exponent is expanded
+ * into plain digits there; the digits are the same, so `parseFloat` reads
+ * back the identical number.
+ */
+function boundLexical(facet, value, base) {
+    if (!Number.isFinite(value))
+        throw new Error(`writeIdsXml: ${facet} must be a finite number, got ${value}`);
+    const text = String(value);
+    if (EXPONENT_BASES.has(base) || !/e/i.test(text))
+        return text;
+    return expandExponent(text);
+}
+function expandExponent(text) {
+    const match = /^(-?)(\d+)(?:\.(\d+))?e([+-]\d+)$/i.exec(text);
+    if (!match)
+        return text;
+    const [, sign, whole, fraction = '', exponentText] = match;
+    const digits = whole + fraction;
+    const point = whole.length + Number(exponentText);
+    if (point <= 0)
+        return `${sign}0.${'0'.repeat(-point)}${digits}`;
+    if (point >= digits.length)
+        return `${sign}${digits}${'0'.repeat(point - digits.length)}`;
+    return `${sign}${digits.slice(0, point)}.${digits.slice(point)}`;
+}
+function writeBounds(xml, constraint, base) {
+    if (constraint.unparseableFacets?.length)
+        refuse('unparseable bound facets');
+    const bounds = [
+        ['xs:minInclusive', constraint.minInclusive],
+        ['xs:minExclusive', constraint.minExclusive],
+        ['xs:maxInclusive', constraint.maxInclusive],
+        ['xs:maxExclusive', constraint.maxExclusive],
+    ];
+    // Date, time and duration bounds are kept as their validated lexemes, not numbers (#7399).
+    const temporal = constraint.temporalBounds;
+    const temporalBounds = [
+        ['xs:minInclusive', temporal?.minInclusive],
+        ['xs:minExclusive', temporal?.minExclusive],
+        ['xs:maxInclusive', temporal?.maxInclusive],
+        ['xs:maxExclusive', temporal?.maxExclusive],
+    ];
+    const counts = [
+        ['xs:length', constraint.length],
+        ['xs:minLength', constraint.minLength],
+        ['xs:maxLength', constraint.maxLength],
+        ['xs:totalDigits', constraint.totalDigits],
+        ['xs:fractionDigits', constraint.fractionDigits],
+    ];
+    // With no facet the restriction would be empty, which reads back as an empty enumeration.
+    if ([...bounds, ...temporalBounds, ...counts].every(([, value]) => value === undefined))
+        refuse('bounds restrictions without any facet');
+    for (const [facet, value] of bounds) {
+        if (value !== undefined)
+            xml.empty(facet, { value: boundLexical(facet, value, base) });
+    }
+    for (const [facet, value] of temporalBounds) {
+        if (value !== undefined)
+            xml.empty(facet, { value });
+    }
+    for (const [facet, value] of counts) {
+        if (value !== undefined)
+            xml.empty(facet, { value: countLexical(facet, value) });
+    }
+}
+/** The base written when the model carries none: `xs:double` for a numeric bounds restriction, else `xs:string`. */
+function defaultBase(families) {
+    const primary = families[0];
+    if (primary.type !== 'bounds')
+        return 'xs:string';
+    const numeric = [primary.minInclusive, primary.minExclusive, primary.maxInclusive, primary.maxExclusive, primary.totalDigits, primary.fractionDigits];
+    return numeric.some((value) => value !== undefined) ? 'xs:double' : 'xs:string';
+}
+function writeRestriction(xml, constraint) {
+    const families = restrictionFamilies(constraint);
+    const base = families.find((family) => family.base !== undefined)?.base ?? defaultBase(families);
+    xml.open('xs:restriction', { base });
+    for (const family of families) {
+        switch (family.type) {
+            case 'pattern':
+                xml.empty('xs:pattern', { value: family.pattern });
+                break;
+            case 'enumeration':
+                for (const value of family.values)
+                    xml.empty('xs:enumeration', { value });
+                break;
+            case 'bounds':
+                writeBounds(xml, family, base);
+                break;
+        }
+    }
+    xml.close('xs:restriction');
+}
+export function writeConstraint(xml, tag, constraint) {
+    xml.open(tag);
+    if (constraint.type === 'simpleValue')
+        xml.leaf('simpleValue', constraint.value);
+    else
+        writeRestriction(xml, constraint);
+    xml.close(tag);
+}
+//# sourceMappingURL=constraint.js.map

package/dist/writer/constraint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constraint.js","sourceRoot":"","sources":["../../src/writer/constraint.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAY/D,SAAS,MAAM,CAAC,IAAY;IAC1B,MAAM,IAAI,KAAK,CAAC,gBAAgB,IAAI,mCAAmC,CAAC,CAAC;AAC3E,CAAC;AAED;;;;;;GAMG;AACH,SAAS,mBAAmB,CAAC,UAA6B;IACxD,MAAM,QAAQ,GAAwB,CAAC,UAAU,CAAC,CAAC;IACnD,KAAK,MAAM,OAAO,IAAI,UAAU,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC;QAC3C,IAAI,OAAO,CAAC,IAAI,KAAK,aAAa;YAAE,MAAM,CAAC,gDAAgD,CAAC,CAAC;QAC7F,IAAI,OAAO,CAAC,GAAG,EAAE,MAAM;YAAE,MAAM,CAAC,uCAAuC,CAAC,CAAC;QACzE,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC;YAAE,MAAM,CAAC,OAAO,OAAO,CAAC,IAAI,0CAA0C,CAAC,CAAC;QACnI,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACzB,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC;IAClG,IAAI,KAAK,CAAC,IAAI,GAAG,CAAC;QAAE,MAAM,CAAC,qDAAqD,CAAC,CAAC;IAClF,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,oGAAoG;AACpG,SAAS,YAAY,CAAC,KAAa,EAAE,KAAa;IAChD,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CAAC,gBAAgB,KAAK,wCAAwC,KAAK,EAAE,CAAC,CAAC;IACxF,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAED,6EAA6E;AAC7E,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC,CAAC;AAE1D;;;;;GAKG;AACH,SAAS,YAAY,CAAC,KAAa,EAAE,KAAa,EAAE,IAAY;IAC9D,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,gBAAgB,KAAK,iCAAiC,KAAK,EAAE,CAAC,CAAC;IAC5G,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC3B,IAAI,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9D,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC;AAC9B,CAAC;AAED,SAAS,cAAc,CAAC,IAAY;IAClC,MAAM,KAAK,GAAG,oCAAoC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9D,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,MAAM,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,GAAG,EAAE,EAAE,YAAY,CAAC,GAAG,KAAK,CAAC;IAC3D,MAAM,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAC;IAChC,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC;IAClD,IAAI,KAAK,IAAI,CAAC;QAAE,OAAO,GAAG,IAAI,KAAK,GAAG,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,MAAM,EAAE,CAAC;IACjE,IAAI,KAAK,IAAI,MAAM,CAAC,MAAM;QAAE,OAAO,GAAG,IAAI,GAAG,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;IAC1F,OAAO,GAAG,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;AACnE,CAAC;AAED,SAAS,WAAW,CAAC,GAAa,EAAE,UAAsD,EAAE,IAAY;IACtG,IAAI,UAAU,CAAC,iBAAiB,EAAE,MAAM;QAAE,MAAM,CAAC,0BAA0B,CAAC,CAAC;IAC7E,MAAM,MAAM,GAAwC;QAClD,CAAC,iBAAiB,EAAE,UAAU,CAAC,YAAY,CAAC;QAC5C,CAAC,iBAAiB,EAAE,UAAU,CAAC,YAAY,CAAC;QAC5C,CAAC,iBAAiB,EAAE,UAAU,CAAC,YAAY,CAAC;QAC5C,CAAC,iBAAiB,EAAE,UAAU,CAAC,YAAY,CAAC;KAC7C,CAAC;IACF,2FAA2F;IAC3F,MAAM,QAAQ,GAAG,UAAU,CAAC,cAAc,CAAC;IAC3C,MAAM,cAAc,GAAwC;QAC1D,CAAC,iBAAiB,EAAE,QAAQ,EAAE,YAAY,CAAC;QAC3C,CAAC,iBAAiB,EAAE,QAAQ,EAAE,YAAY,CAAC;QAC3C,CAAC,iBAAiB,EAAE,QAAQ,EAAE,YAAY,CAAC;QAC3C,CAAC,iBAAiB,EAAE,QAAQ,EAAE,YAAY,CAAC;KAC5C,CAAC;IACF,MAAM,MAAM,GAAwC;QAClD,CAAC,WAAW,EAAE,UAAU,CAAC,MAAM,CAAC;QAChC,CAAC,cAAc,EAAE,UAAU,CAAC,SAAS,CAAC;QACtC,CAAC,cAAc,EAAE,UAAU,CAAC,SAAS,CAAC;QACtC,CAAC,gBAAgB,EAAE,UAAU,CAAC,WAAW,CAAC;QAC1C,CAAC,mBAAmB,EAAE,UAAU,CAAC,cAAc,CAAC;KACjD,CAAC;IACF,0FAA0F;IAC1F,IAAI,CAAC,GAAG,MAAM,EAAE,GAAG,cAAc,EAAE,GAAG,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC;QAAE,MAAM,CAAC,uCAAuC,CAAC,CAAC;IACzI,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,MAAM,EAAE,CAAC;QACpC,IAAI,KAAK,KAAK,SAAS;YAAE,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;IACzF,CAAC;IACD,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,cAAc,EAAE,CAAC;QAC5C,IAAI,KAAK,KAAK,SAAS;YAAE,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IACvD,CAAC;IACD,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,MAAM,EAAE,CAAC;QACpC,IAAI,KAAK,KAAK,SAAS;YAAE,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC;IACnF,CAAC;AACH,CAAC;AAED,oHAAoH;AACpH,SAAS,WAAW,CAAC,QAAsC;IACzD,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC5B,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,WAAW,CAAC;IAClD,MAAM,OAAO,GAAG,CAAC,OAAO,CAAC,YAAY,EAAE,OAAO,CAAC,YAAY,EAAE,OAAO,CAAC,YAAY,EAAE,OAAO,CAAC,YAAY,EAAE,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IACtJ,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC;AAClF,CAAC;AAED,SAAS,gBAAgB,CAAC,GAAa,EAAE,UAA6B;IACpE,MAAM,QAAQ,GAAG,mBAAmB,CAAC,UAAU,CAAC,CAAC;IACjD,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,SAAS,CAAC,EAAE,IAAI,IAAI,WAAW,CAAC,QAAQ,CAAC,CAAC;IACjG,GAAG,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IACrC,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;QAC9B,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;YACpB,KAAK,SAAS;gBACZ,GAAG,CAAC,KAAK,CAAC,YAAY,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;gBACnD,MAAM;YACR,KAAK,aAAa;gBAChB,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM;oBAAE,GAAG,CAAC,KAAK,CAAC,gBAAgB,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;gBAC1E,MAAM;YACR,KAAK,QAAQ;gBACX,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;gBAC/B,MAAM;QACV,CAAC;IACH,CAAC;IACD,GAAG,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,GAAa,EAAE,GAAW,EAAE,UAAyB;IACnF,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACd,IAAI,UAAU,CAAC,IAAI,KAAK,aAAa;QAAE,GAAG,CAAC,IAAI,CAAC,aAAa,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC;;QAC5E,gBAAgB,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IACvC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;AACjB,CAAC"}

package/dist/writer/index.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Serialise an `IDSDocument` as IDS 1.0 XML (#5225). Covers entity,
+ * attribute, property (with `dataType`), classification, material and
+ * partOf facets, requirement `instructions`, and every `IDSConstraint`
+ * shape: simple values, patterns, enumerations, numeric/length/digit bounds
+ * and conjunctive (`and`) restrictions. Element order within a facet
+ * follows `ids.xsd`, so `parseIDS` and `auditIDSDocument` read the result
+ * back; applicability facets are written in the order given (the caller
+ * owns the XSD's entity, partOf, classification, attribute, property,
+ * material sequence there). `@ifc-lite/rules`' `ruleSetToIds` and the
+ * viewer's reviewed IDS drafts (#6915) serialise through here (moved from
+ * `@ifc-lite/rules` by ADR-005).
+ */
+import type { IDSDocument } from '../types.js';
+import type { IDSPreviewFlags } from '../preview/types.js';
+/** Formatting of `writeIdsXml`'s output. Every option changes layout or order only, never meaning. */
+export interface IdsXmlFormat {
+    /** Indentation of one nesting level: a number of spaces (0–8) or `'\t'`. Default `2`. */
+    indent?: number | '\t';
+    /** Line ending. Default `'\n'`. */
+    newline?: '\n' | '\r\n';
+    /**
+     * Canonical order, so two documents with the same checks write the same
+     * bytes: applicability facets in the `ids.xsd` sequence (entity, partOf,
+     * classification, attribute, property, material; stable within a kind)
+     * and `ifcVersion` tokens in schema order without duplicates. Both are
+     * order-insensitive in IDS. Requirements keep their authored order, which
+     * reports show. Default `false`: everything is written in the order given.
+     */
+    canonical?: boolean;
+}
+/** What `writeIdsXml` may write, as opposed to how (`IdsXmlFormat`). */
+export interface IdsXmlWriteOptions {
+    /**
+     * IDS 1.1 PREVIEW (unstable). Without `ids11`, a document using a 1.1
+     * candidate feature is refused with `IDS11PreviewRequiredError`; with it,
+     * such a document is written against the 1.1 schema location. A document
+     * using no 1.1 feature is written as IDS 1.0 either way, byte for byte.
+     */
+    preview?: IDSPreviewFlags;
+}
+/**
+ * `doc` as an IDS 1.0 XML string, laid out per `fmt` (two-space indent,
+ * `\n`, authored order by default). IDS 1.1 PREVIEW output needs
+ * `options.preview.ids11`.
+ */
+export declare function writeIdsXml(doc: IDSDocument, fmt?: IdsXmlFormat, options?: IdsXmlWriteOptions): string;
+//# sourceMappingURL=index.d.ts.map

package/dist/writer/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/writer/index.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EACV,WAAW,EAMZ,MAAM,aAAa,CAAC;AAIrB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAoH3D,sGAAsG;AACtG,MAAM,WAAW,YAAY;IAC3B,yFAAyF;IACzF,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,mCAAmC;IACnC,OAAO,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;IACxB;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAqDD,wEAAwE;AACxE,MAAM,WAAW,kBAAkB;IACjC;;;;;OAKG;IACH,OAAO,CAAC,EAAE,eAAe,CAAC;CAC3B;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,WAAW,EAAE,GAAG,GAAE,YAAiB,EAAE,OAAO,GAAE,kBAAuB,GAAG,MAAM,CA8B9G"}

package/dist/writer/index.js

@@ -0,0 +1,209 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+import { XmlLines } from './xml-lines.js';
+import { writeConstraint } from './constraint.js';
+import { assertIds11Allowed } from '../preview/features.js';
+const IDS_NS = 'http://standards.buildingsmart.org/IDS';
+const XS_NS = 'http://www.w3.org/2001/XMLSchema';
+const XSI_NS = 'http://www.w3.org/2001/XMLSchema-instance';
+const SCHEMA_LOCATION = `${IDS_NS} http://standards.buildingsmart.org/IDS/1.0/ids.xsd`;
+/**
+ * IDS 1.1 PREVIEW. buildingSMART has not published a 1.1 schema URL; this
+ * follows the 1.0 pattern and the `version="1.1.0"` of the upstream
+ * `ver/1.1.x` branch's `ids.xsd`. An assumption, recorded in the P-12 worklog.
+ */
+const SCHEMA_LOCATION_11_PREVIEW = `${IDS_NS} http://standards.buildingsmart.org/IDS/1.1/ids.xsd`;
+const IDS11_PREVIEW_NOTE = 'IDS 1.1 PREVIEW: uses unreleased candidate features; not valid IDS 1.0.';
+/**
+ * `IfcRelContainedInSpatialStructure` -> the XSD's upper-case `relations`
+ * token. Voids and fills exist in IDS 1.0 only as the combined token, so
+ * either alone has no valid XML and is refused.
+ */
+function relationToken(relation) {
+    if (relation === 'IfcRelVoidsElement' || relation === 'IfcRelFillsElement') {
+        throw new Error(`writeIdsXml: partOf relation ${relation} on its own is not supported by this writer (IDS 1.0 has only "IFCRELVOIDSELEMENT IFCRELFILLSELEMENT")`);
+    }
+    return relation.toUpperCase();
+}
+function writeEntity(xml, facet, attrs = {}) {
+    xml.open('entity', attrs);
+    writeConstraint(xml, 'name', facet.name);
+    if (facet.predefinedType)
+        writeConstraint(xml, 'predefinedType', facet.predefinedType);
+    xml.close('entity');
+}
+/** `dataType` is an XSD attribute holding one upper-case name, never a restriction. */
+function dataTypeAttr(facet) {
+    if (!facet.dataType)
+        return undefined;
+    if (facet.dataType.type !== 'simpleValue')
+        throw new Error('writeIdsXml: a property dataType must be a simple value');
+    return facet.dataType.value;
+}
+/**
+ * The facet's `instructions` attribute. A requirement's comes from
+ * `IDSRequirement.instructions` (IDS 1.0); an applicability facet's from the
+ * facet itself (IDS 1.1 PREVIEW, #154). The facet-level field anywhere else
+ * has no XML home and is refused rather than dropped.
+ */
+function instructionsFor(facet, context, requirementInstructions) {
+    if (context === 'applicability')
+        return facet.instructions;
+    if (facet.instructions !== undefined) {
+        throw new Error(`writeIdsXml: a ${context} ${facet.type} facet cannot carry facet-level instructions${context === 'requirement' ? '; use IDSRequirement.instructions' : ''}`);
+    }
+    return requirementInstructions;
+}
+function writeFacet(xml, facet, cardinality, context, requirementInstructions) {
+    const instructions = instructionsFor(facet, context, requirementInstructions);
+    switch (facet.type) {
+        case 'entity':
+            writeEntity(xml, facet, { instructions });
+            return;
+        case 'attribute':
+            xml.open('attribute', { cardinality, instructions });
+            writeConstraint(xml, 'name', facet.name);
+            if (facet.value)
+                writeConstraint(xml, 'value', facet.value);
+            xml.close('attribute');
+            return;
+        case 'property':
+            xml.open('property', { dataType: dataTypeAttr(facet), cardinality, instructions, uri: facet.uri });
+            writeConstraint(xml, 'propertySet', facet.propertySet);
+            writeConstraint(xml, 'baseName', facet.baseName);
+            if (facet.value)
+                writeConstraint(xml, 'value', facet.value);
+            xml.close('property');
+            return;
+        case 'classification':
+            xml.open('classification', { cardinality, instructions, uri: facet.uri });
+            if (facet.value)
+                writeConstraint(xml, 'value', facet.value);
+            if (facet.system)
+                writeConstraint(xml, 'system', facet.system);
+            xml.close('classification');
+            return;
+        case 'material':
+            xml.open('material', { cardinality, instructions, uri: facet.uri });
+            if (facet.value)
+                writeConstraint(xml, 'value', facet.value);
+            xml.close('material');
+            return;
+        case 'partOf':
+            // `ruleSetToIds` never produces one (a rule's `parent` subject matches
+            // an ancestor's Name, not its class). The XSD requires the related
+            // entity, so a partOf without one is refused rather than written invalid.
+            if (!facet.entity)
+                throw new Error('writeIdsXml: a partOf facet needs its related entity');
+            // No relation means any part-of relation (#7401), so it stays unwritten;
+            // an unrecognised one is written as read, for the auditor to flag.
+            xml.open('partOf', {
+                relation: facet.anyRelation ? undefined : facet.rawRelation ?? relationToken(facet.relation),
+                cardinality,
+                instructions,
+            });
+            writeEntity(xml, facet.entity);
+            // IDS 1.1 PREVIEW (#379/#380): conditions on the related parent.
+            for (const nested of facet.facets ?? [])
+                writeFacet(xml, nested, undefined, 'nested');
+            xml.close('partOf');
+            return;
+    }
+}
+function writeRequirement(xml, requirement) {
+    // IDS 1.0 has no cardinality on an entity facet inside requirements.
+    const cardinality = requirement.facet.type === 'entity' ? undefined : requirement.optionality;
+    writeFacet(xml, requirement.facet, cardinality, 'requirement', requirement.instructions);
+}
+/** The `ids.xsd` applicability sequence; an applicability in another order is not schema-valid. */
+const FACET_ORDER = {
+    entity: 0, partOf: 1, classification: 2, attribute: 3, property: 4, material: 5,
+};
+/** `ids.xsd`'s `ifcVersion` tokens, in schema order. The parser reads `IFC4X3_ADD2` as `IFC4X3`. */
+const VERSION_TOKENS = ['IFC2X3', 'IFC4', 'IFC4X3_ADD2'];
+/** `IFC4X3` has no token of its own in IDS 1.0: it is written as `IFC4X3_ADD2`, which reads back as `IFC4X3`. */
+function versionToken(version) {
+    return version === 'IFC4X3' ? 'IFC4X3_ADD2' : version;
+}
+function versionTokens(versions, canonical) {
+    const tokens = versions.map(versionToken);
+    if (!canonical)
+        return tokens;
+    return VERSION_TOKENS.filter((token) => tokens.includes(token));
+}
+function indentUnit(indent) {
+    if (indent === undefined)
+        return '  ';
+    if (indent === '\t')
+        return '\t';
+    if (!Number.isInteger(indent) || indent < 0 || indent > 8) {
+        throw new Error(`writeIdsXml: indent must be '\\t' or an integer from 0 to 8, got ${indent}`);
+    }
+    return ' '.repeat(indent);
+}
+function writeSpecification(xml, spec, canonical) {
+    const versions = versionTokens(spec.ifcVersions, canonical);
+    const facets = canonical
+        ? [...spec.applicability.facets].sort((a, b) => FACET_ORDER[a.type] - FACET_ORDER[b.type])
+        : spec.applicability.facets;
+    xml.open('specification', {
+        name: spec.name,
+        ifcVersion: versions.join(' '),
+        identifier: spec.identifier,
+        description: spec.description,
+        instructions: spec.instructions,
+    });
+    const maxOccurs = spec.maxOccurs === undefined ? 'unbounded' : String(spec.maxOccurs);
+    xml.open('applicability', { minOccurs: String(spec.minOccurs ?? 0), maxOccurs });
+    for (const facet of facets)
+        writeFacet(xml, facet, undefined, 'applicability');
+    xml.close('applicability');
+    if (spec.requirements.length > 0) {
+        xml.open('requirements');
+        for (const requirement of spec.requirements)
+            writeRequirement(xml, requirement);
+        xml.close('requirements');
+    }
+    xml.close('specification');
+}
+/**
+ * `doc` as an IDS 1.0 XML string, laid out per `fmt` (two-space indent,
+ * `\n`, authored order by default). IDS 1.1 PREVIEW output needs
+ * `options.preview.ids11`.
+ */
+export function writeIdsXml(doc, fmt = {}, options = {}) {
+    const ids11 = assertIds11Allowed(doc, options.preview, 'writeIdsXml', true).length > 0;
+    const xml = new XmlLines(indentUnit(fmt.indent));
+    const newline = fmt.newline ?? '\n';
+    const canonical = fmt.canonical ?? false;
+    xml.open('ids', {
+        xmlns: IDS_NS,
+        'xmlns:xs': XS_NS,
+        'xmlns:xsi': XSI_NS,
+        'xsi:schemaLocation': ids11 ? SCHEMA_LOCATION_11_PREVIEW : SCHEMA_LOCATION,
+    });
+    if (ids11)
+        xml.comment(IDS11_PREVIEW_NOTE);
+    xml.open('info');
+    // The `ids.xsd` info sequence. `date` (xs:date) and `author` (an e-mail
+    // pattern) are written as given; `auditIDSDocument` reports malformed ones.
+    const { title, copyright, version, description, author, date, purpose, milestone } = doc.info;
+    xml.leaf('title', title);
+    const optional = [
+        ['copyright', copyright], ['version', version], ['description', description], ['author', author],
+        ['date', date], ['purpose', purpose], ['milestone', milestone],
+    ];
+    for (const [tag, text] of optional) {
+        if (text)
+            xml.leaf(tag, text);
+    }
+    xml.close('info');
+    xml.open('specifications');
+    for (const spec of doc.specifications)
+        writeSpecification(xml, spec, canonical);
+    xml.close('specifications');
+    xml.close('ids');
+    return ['<?xml version="1.0" encoding="UTF-8"?>', ...xml.lines, ''].join(newline);
+}
+//# sourceMappingURL=index.js.map

package/dist/writer/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/writer/index.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAwB/D,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAG5D,MAAM,MAAM,GAAG,wCAAwC,CAAC;AACxD,MAAM,KAAK,GAAG,kCAAkC,CAAC;AACjD,MAAM,MAAM,GAAG,2CAA2C,CAAC;AAC3D,MAAM,eAAe,GAAG,GAAG,MAAM,qDAAqD,CAAC;AACvF;;;;GAIG;AACH,MAAM,0BAA0B,GAAG,GAAG,MAAM,qDAAqD,CAAC;AAClG,MAAM,kBAAkB,GAAG,yEAAyE,CAAC;AAErG;;;;GAIG;AACH,SAAS,aAAa,CAAC,QAAwB;IAC7C,IAAI,QAAQ,KAAK,oBAAoB,IAAI,QAAQ,KAAK,oBAAoB,EAAE,CAAC;QAC3E,MAAM,IAAI,KAAK,CAAC,gCAAgC,QAAQ,wGAAwG,CAAC,CAAC;IACpK,CAAC;IACD,OAAO,QAAQ,CAAC,WAAW,EAAE,CAAC;AAChC,CAAC;AAED,SAAS,WAAW,CAAC,GAAa,EAAE,KAA4C,EAAE,QAA4C,EAAE;IAC9H,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC1B,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IACzC,IAAI,KAAK,CAAC,cAAc;QAAE,eAAe,CAAC,GAAG,EAAE,gBAAgB,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;IACvF,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;AACtB,CAAC;AAED,uFAAuF;AACvF,SAAS,YAAY,CAAC,KAA8C;IAClE,IAAI,CAAC,KAAK,CAAC,QAAQ;QAAE,OAAO,SAAS,CAAC;IACtC,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,KAAK,aAAa;QAAE,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;IACtH,OAAO,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC;AAC9B,CAAC;AAQD;;;;;GAKG;AACH,SAAS,eAAe,CAAC,KAAe,EAAE,OAAqB,EAAE,uBAAgC;IAC/F,IAAI,OAAO,KAAK,eAAe;QAAE,OAAO,KAAK,CAAC,YAAY,CAAC;IAC3D,IAAI,KAAK,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CAAC,kBAAkB,OAAO,IAAI,KAAK,CAAC,IAAI,+CAA+C,OAAO,KAAK,aAAa,CAAC,CAAC,CAAC,mCAAmC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAChL,CAAC;IACD,OAAO,uBAAuB,CAAC;AACjC,CAAC;AAED,SAAS,UAAU,CAAC,GAAa,EAAE,KAAe,EAAE,WAA+B,EAAE,OAAqB,EAAE,uBAAgC;IAC1I,MAAM,YAAY,GAAG,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,uBAAuB,CAAC,CAAC;IAC9E,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,QAAQ;YACX,WAAW,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,YAAY,EAAE,CAAC,CAAC;YAC1C,OAAO;QACT,KAAK,WAAW;YACd,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,WAAW,EAAE,YAAY,EAAE,CAAC,CAAC;YACrD,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YACzC,IAAI,KAAK,CAAC,KAAK;gBAAE,eAAe,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;YAC5D,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;YACvB,OAAO;QACT,KAAK,UAAU;YACb,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,QAAQ,EAAE,YAAY,CAAC,KAAK,CAAC,EAAE,WAAW,EAAE,YAAY,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC;YACnG,eAAe,CAAC,GAAG,EAAE,aAAa,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;YACvD,eAAe,CAAC,GAAG,EAAE,UAAU,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;YACjD,IAAI,KAAK,CAAC,KAAK;gBAAE,eAAe,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;YAC5D,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;YACtB,OAAO;QACT,KAAK,gBAAgB;YACnB,GAAG,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE,WAAW,EAAE,YAAY,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC;YAC1E,IAAI,KAAK,CAAC,KAAK;gBAAE,eAAe,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;YAC5D,IAAI,KAAK,CAAC,MAAM;gBAAE,eAAe,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;YAC/D,GAAG,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;YAC5B,OAAO;QACT,KAAK,UAAU;YACb,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,WAAW,EAAE,YAAY,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC;YACpE,IAAI,KAAK,CAAC,KAAK;gBAAE,eAAe,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;YAC5D,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;YACtB,OAAO;QACT,KAAK,QAAQ;YACX,uEAAuE;YACvE,mEAAmE;YACnE,0EAA0E;YAC1E,IAAI,CAAC,KAAK,CAAC,MAAM;gBAAE,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;YAC3F,yEAAyE;YACzE,mEAAmE;YACnE,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE;gBACjB,QAAQ,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,IAAI,aAAa,CAAC,KAAK,CAAC,QAAQ,CAAC;gBAC5F,WAAW;gBACX,YAAY;aACb,CAAC,CAAC;YACH,WAAW,CAAC,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;YAC/B,iEAAiE;YACjE,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,MAAM,IAAI,EAAE;gBAAE,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;YACtF,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YACpB,OAAO;IACX,CAAC;AACH,CAAC;AAED,SAAS,gBAAgB,CAAC,GAAa,EAAE,WAA2B;IAClE,qEAAqE;IACrE,MAAM,WAAW,GAAG,WAAW,CAAC,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,WAAW,CAAC;IAC9F,UAAU,CAAC,GAAG,EAAE,WAAW,CAAC,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,WAAW,CAAC,YAAY,CAAC,CAAC;AAC3F,CAAC;AAmBD,mGAAmG;AACnG,MAAM,WAAW,GAA+C;IAC9D,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,cAAc,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC;CAChF,CAAC;AACF,oGAAoG;AACpG,MAAM,cAAc,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,CAAU,CAAC;AAElE,iHAAiH;AACjH,SAAS,YAAY,CAAC,OAAmB;IACvC,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC;AACxD,CAAC;AAED,SAAS,aAAa,CAAC,QAA+B,EAAE,SAAkB;IACxE,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IAC1C,IAAI,CAAC,SAAS;QAAE,OAAO,MAAM,CAAC;IAC9B,OAAO,cAAc,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;AAClE,CAAC;AAED,SAAS,UAAU,CAAC,MAA8B;IAChD,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACtC,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACjC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1D,MAAM,IAAI,KAAK,CAAC,oEAAoE,MAAM,EAAE,CAAC,CAAC;IAChG,CAAC;IACD,OAAO,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC;AAED,SAAS,kBAAkB,CAAC,GAAa,EAAE,IAAsB,EAAE,SAAkB;IACnF,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IAC5D,MAAM,MAAM,GAAG,SAAS;QACtB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC1F,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC;IAC9B,GAAG,CAAC,IAAI,CAAC,eAAe,EAAE;QACxB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,UAAU,EAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC;QAC9B,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,YAAY,EAAE,IAAI,CAAC,YAAY;KAChC,CAAC,CAAC;IACH,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACtF,GAAG,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;IACjF,KAAK,MAAM,KAAK,IAAI,MAAM;QAAE,UAAU,CAAC,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,eAAe,CAAC,CAAC;IAC/E,GAAG,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IAC3B,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACjC,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACzB,KAAK,MAAM,WAAW,IAAI,IAAI,CAAC,YAAY;YAAE,gBAAgB,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;QAChF,GAAG,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IAC5B,CAAC;IACD,GAAG,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;AAC7B,CAAC;AAaD;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,GAAgB,EAAE,MAAoB,EAAE,EAAE,UAA8B,EAAE;IACpG,MAAM,KAAK,GAAG,kBAAkB,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,EAAE,aAAa,EAAE,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;IACvF,MAAM,GAAG,GAAG,IAAI,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IACjD,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,IAAI,IAAI,CAAC;IACpC,MAAM,SAAS,GAAG,GAAG,CAAC,SAAS,IAAI,KAAK,CAAC;IACzC,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE;QACd,KAAK,EAAE,MAAM;QACb,UAAU,EAAE,KAAK;QACjB,WAAW,EAAE,MAAM;QACnB,oBAAoB,EAAE,KAAK,CAAC,CAAC,CAAC,0BAA0B,CAAC,CAAC,CAAC,eAAe;KAC3E,CAAC,CAAC;IACH,IAAI,KAAK;QAAE,GAAG,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC3C,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACjB,wEAAwE;IACxE,4EAA4E;IAC5E,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,GAAG,CAAC,IAAI,CAAC;IAC9F,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACzB,MAAM,QAAQ,GAAwC;QACpD,CAAC,WAAW,EAAE,SAAS,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,CAAC,EAAE,CAAC,aAAa,EAAE,WAAW,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC;QAChG,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,CAAC,EAAE,CAAC,WAAW,EAAE,SAAS,CAAC;KAC/D,CAAC;IACF,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,QAAQ,EAAE,CAAC;QACnC,IAAI,IAAI;YAAE,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAChC,CAAC;IACD,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAClB,GAAG,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAC3B,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,cAAc;QAAE,kBAAkB,CAAC,GAAG,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;IAChF,GAAG,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;IAC5B,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACjB,OAAO,CAAC,wCAAwC,EAAE,GAAG,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AACpF,CAAC"}

package/dist/writer/xml-lines.d.ts

@@ -0,0 +1,17 @@
+/** `field` names the element or attribute, so a refusal says what to fix. */
+export declare function escapeXml(text: string, field: string): string;
+export declare class XmlLines {
+    private readonly unit;
+    readonly lines: string[];
+    private depth;
+    /** `unit` is the indentation of one nesting level. */
+    constructor(unit?: string);
+    open(tag: string, attrs?: Record<string, string | undefined>): void;
+    close(tag: string): void;
+    leaf(tag: string, text: string, attrs?: Record<string, string | undefined>): void;
+    /** An XML comment line; `--` cannot appear inside one and is refused. */
+    comment(text: string): void;
+    empty(tag: string, attrs?: Record<string, string | undefined>): void;
+    private indent;
+}
+//# sourceMappingURL=xml-lines.d.ts.map

package/dist/writer/xml-lines.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xml-lines.d.ts","sourceRoot":"","sources":["../../src/writer/xml-lines.ts"],"names":[],"mappings":"AAWA,6EAA6E;AAC7E,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAc7D;AAOD,qBAAa,QAAQ;IAKP,OAAO,CAAC,QAAQ,CAAC,IAAI;IAJjC,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,CAAM;IAC9B,OAAO,CAAC,KAAK,CAAK;IAElB,sDAAsD;gBACzB,IAAI,SAAO;IAExC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAM,GAAG,IAAI;IAKvE,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAKxB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAM,GAAG,IAAI;IAIrF,yEAAyE;IACzE,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK3B,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAM,GAAG,IAAI;IAIxE,OAAO,CAAC,MAAM;CAGf"}

package/dist/writer/xml-lines.js

@@ -0,0 +1,69 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+/** XML escaping and the indented line buffer behind `writeIdsXml`. */
+/** Characters XML 1.0 cannot carry, even as character references. */
+// Matching control characters is the point: they are refused, not allowed through.
+// eslint-disable-next-line no-control-regex
+const NOT_XML = /[\u0000-\u0008\u000B\u000C\u000E-\u001F\uFFFE\uFFFF]/;
+/** `field` names the element or attribute, so a refusal says what to fix. */
+export function escapeXml(text, field) {
+    const bad = NOT_XML.exec(text);
+    if (bad) {
+        const code = bad[0].charCodeAt(0).toString(16).toUpperCase().padStart(4, '0');
+        throw new Error(`writeIdsXml: ${field} contains control character U+${code}, which XML 1.0 cannot carry`);
+    }
+    return text
+        .replace(/&/g, '&')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&apos;')
+        // A raw CR is normalised away by every XML reader; a reference survives.
+        .replace(/\r/g, '&#13;');
+}
+/** Attribute-value normalisation turns raw line breaks and tabs into spaces; references keep them. */
+function escapeAttr(text, field) {
+    return escapeXml(text, field).replace(/\n/g, '&#10;').replace(/\t/g, '&#9;');
+}
+export class XmlLines {
+    unit;
+    lines = [];
+    depth = 0;
+    /** `unit` is the indentation of one nesting level. */
+    constructor(unit = '  ') {
+        this.unit = unit;
+    }
+    open(tag, attrs = {}) {
+        this.lines.push(`${this.indent()}<${tag}${renderAttrs(tag, attrs)}>`);
+        this.depth++;
+    }
+    close(tag) {
+        this.depth--;
+        this.lines.push(`${this.indent()}</${tag}>`);
+    }
+    leaf(tag, text, attrs = {}) {
+        this.lines.push(`${this.indent()}<${tag}${renderAttrs(tag, attrs)}>${escapeXml(text, tag)}</${tag}>`);
+    }
+    /** An XML comment line; `--` cannot appear inside one and is refused. */
+    comment(text) {
+        if (text.includes('--'))
+            throw new Error('writeIdsXml: an XML comment cannot contain "--"');
+        this.lines.push(`${this.indent()}<!-- ${escapeXml(text, 'comment')} -->`);
+    }
+    empty(tag, attrs = {}) {
+        this.lines.push(`${this.indent()}<${tag}${renderAttrs(tag, attrs)}/>`);
+    }
+    indent() {
+        return this.unit.repeat(this.depth);
+    }
+}
+function renderAttrs(tag, attrs) {
+    let out = '';
+    for (const [key, value] of Object.entries(attrs)) {
+        if (value !== undefined)
+            out += ` ${key}="${escapeAttr(value, `${tag} "${key}"`)}"`;
+    }
+    return out;
+}
+//# sourceMappingURL=xml-lines.js.map

package/dist/writer/xml-lines.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ifc-lite/ids",
-  "version": "3.1.0",
+  "version": "3.3.1",
   "description": "IDS (Information Delivery Specification) support for IFC-Lite",
   "type": "module",
   "main": "./dist/index.js",
@@ -19,15 +19,15 @@
   "dependencies": {
     "@xmldom/xmldom": "^0.9.12",
     "@ifc-lite/codegen": "1.18.1",
-    "@ifc-lite/data": "6.1.0",
+    "@ifc-lite/data": "6.2.0",
     "@ifc-lite/encoding": "2.3.0",
-    "@ifc-lite/parser": "9.1.0",
+    "@ifc-lite/parser": "9.4.0",
     "@ifc-lite/regex-guard": "0.3.0"
   },
   "devDependencies": {
-    "happy-dom": "^20.14.5",
+    "happy-dom": "^20.14.6",
     "typescript": "^6.0.3",
-    "vitest": "^5.0.2",
+    "vitest": "^5.0.3",
     "xmllint-wasm": "5.3.0",
     "@ifc-lite/timing-ladder": "^0.1.0"
   },