@dialecte/core 0.6.4 → 0.8.0

package/dist/types/dialecte-config.d.ts

@@ -38,6 +38,12 @@ export type RawDialecteConfig<GenericElementNames extends readonly string[], Gen
  */
 export type DialecteHooks<GenericConfig extends AnyDialecteConfig> = IOHooks & TransactionHooks<GenericConfig>;
 export type IOConfig = {
+    /**
+     * The file extensions the dialecte reads, with their dot (`['.scd', '.ssd']`). `.xml` is always read besides them,
+     * listed or not (a dialecte's own extension is still XML): an import's file name, an import's `path` and a new
+     * document's `path`, compared lower-cased. The first entry (`.xml` for an empty list) is the extension core gives a
+     * new document without a path.
+     */
     supportedFileExtensions: readonly string[];
     importOptions?: Partial<ImportOptions>;
     exportOptions?: Partial<ExportOptions>;

package/dist/types/dialecte-config.d.ts.map

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

package/dist/types/io.d.ts

@@ -1,4 +1,5 @@
 import { AnyRawRecord } from './records';
+import { Diagnostic } from '../diagnostics';
 /**
  * Options for chunking during import/export
  */
@@ -28,41 +29,32 @@ export type RecordPatch = {
     removeAttributes?: readonly string[];
 };
 /**
- * A warning produced during import.
- *
- * `type` is a discriminant string owned by the dialecte (e.g. `'unresolved-reference'`).
- * `recordId` identifies the record that triggered the warning.
- * `details` carries dialecte-specific context — its shape is defined by the dialecte.
+ * What an import session gives back once the last record is stored.
+ * Core applies each collection in order: creates → updates → deletes; the diagnostics are returned
+ * to the caller of the import with the document.
  */
-export type ImportWarning = {
-    type: string;
-    recordId: string;
-    details?: Record<string, unknown>;
-};
-/**
- * Return value of the afterImport hook.
- * Core applies each collection in order: creates → updates → deletes.
- */
-export type AfterImportResult = {
+export type AfterImportResult<GenericDiagnostic extends Diagnostic = Diagnostic> = {
     /** New records to insert */
     creates?: AnyRawRecord[];
     /** Patches to merge into existing records */
     updates?: RecordPatch[];
     /** IDs of records to remove */
     deletes?: string[];
-    /** Warnings collected during resolution — unresolved refs, unknown paths, etc. */
-    warnings?: ImportWarning[];
+    /** What the import has to say about the file - unresolved references, values rewritten, … */
+    diagnostics?: GenericDiagnostic[];
 };
 /**
- * IO hooks for import/export lifecycle.
+ * The hooks of one file's import. Core creates a session per file (`IOHooks.createImportSession`)
+ * and drops it after `afterImport`: whatever state the session keeps between records is that file's
+ * only. Typed on the diagnostics it emits so a dialecte's tests check them exactly; the project does
+ * not carry the type (a document's diagnostics come from several producers).
  */
-export type IOHooks = {
+export type ImportSession<GenericDiagnostic extends Diagnostic = Diagnostic> = {
     /**
-     * Called once with the raw XML string before any parsing begins.
-     * Return a (possibly modified) XML string. Useful for pre-parse normalization,
-     * e.g. transforming a legacy schema to the canonical form expected by this config.
+     * The tag names whose records `beforeImportRecord` is handed; absent, every record is. A record of
+     * another tag passes the session by, its ancestry not built for it: the cheaper the fewer tags.
      */
-    beforeImport?: (xml: string) => string;
+    recordTagNames?: readonly string[];
     /**
      * Called once per record as its closing tag is parsed, AFTER the record has
      * been standardized (attributes canonicalized, `afterStandardizedRecord`
@@ -74,7 +66,23 @@ export type IOHooks = {
         record: AnyRawRecord;
         ancestry: readonly AnyRawRecord[];
     }) => void;
-    /** Returns records to create/update/delete after all records are stored. */
-    afterImport?: () => Promise<AfterImportResult>;
+    /** Called once after all records are stored: the writes to apply and the diagnostics of this file. */
+    afterImport?: () => Promise<AfterImportResult<GenericDiagnostic>>;
+};
+/**
+ * IO hooks for import/export lifecycle.
+ */
+export type IOHooks = {
+    /**
+     * Called once with the raw XML string before any parsing begins.
+     * Return a (possibly modified) XML string. Useful for pre-parse normalization,
+     * e.g. transforming a legacy schema to the canonical form expected by this config.
+     */
+    beforeImport?: (xml: string) => string;
+    /** Called once per file imported; the session it returns lives for that file only. */
+    createImportSession?: (params: {
+        documentId: string;
+        configKey: string;
+    }) => ImportSession;
 };
 //# sourceMappingURL=io.d.ts.map

package/dist/types/io.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"io.d.ts","sourceRoot":"","sources":["../../src/types/io.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAE7C;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG;IAC1B,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;CACjB,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,YAAY,GAAG;IAC1C,aAAa,EAAE,OAAO,CAAA;CACtB,CAAA;AAED,MAAM,MAAM,aAAa,GAAG;IAC3B,aAAa,EAAE,OAAO,CAAA;CACtB,CAAA;AAED;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC,GAAG;IACnF,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CACpC,CAAA;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACjC,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC/B,4BAA4B;IAC5B,OAAO,CAAC,EAAE,YAAY,EAAE,CAAA;IACxB,6CAA6C;IAC7C,OAAO,CAAC,EAAE,WAAW,EAAE,CAAA;IACvB,+BAA+B;IAC/B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,kFAAkF;IAClF,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAA;CAC1B,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG;IACrB;;;;OAIG;IACH,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAA;IACtC;;;;;;OAMG;IACH,kBAAkB,CAAC,EAAE,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,YAAY,CAAC;QAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,CAAA;KAAE,KAAK,IAAI,CAAA;IAClG,4EAA4E;IAC5E,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC,iBAAiB,CAAC,CAAA;CAC9C,CAAA"}
+{"version":3,"file":"io.d.ts","sourceRoot":"","sources":["../../src/types/io.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAC7C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAE/C;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG;IAC1B,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;CACjB,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,YAAY,GAAG;IAC1C,aAAa,EAAE,OAAO,CAAA;CACtB,CAAA;AAED,MAAM,MAAM,aAAa,GAAG;IAC3B,aAAa,EAAE,OAAO,CAAA;CACtB,CAAA;AAED;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC,GAAG;IACnF,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CACpC,CAAA;AAEF;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,CAAC,iBAAiB,SAAS,UAAU,GAAG,UAAU,IAAI;IAClF,4BAA4B;IAC5B,OAAO,CAAC,EAAE,YAAY,EAAE,CAAA;IACxB,6CAA6C;IAC7C,OAAO,CAAC,EAAE,WAAW,EAAE,CAAA;IACvB,+BAA+B;IAC/B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,6FAA6F;IAC7F,WAAW,CAAC,EAAE,iBAAiB,EAAE,CAAA;CACjC,CAAA;AAED;;;;;GAKG;AACH,MAAM,MAAM,aAAa,CAAC,iBAAiB,SAAS,UAAU,GAAG,UAAU,IAAI;IAC9E;;;OAGG;IACH,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAClC;;;;;;OAMG;IACH,kBAAkB,CAAC,EAAE,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,YAAY,CAAC;QAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,CAAA;KAAE,KAAK,IAAI,CAAA;IAClG,sGAAsG;IACtG,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC,iBAAiB,CAAC,iBAAiB,CAAC,CAAC,CAAA;CACjE,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG;IACrB;;;;OAIG;IACH,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAA;IACtC,sFAAsF;IACtF,mBAAmB,CAAC,EAAE,CAAC,MAAM,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,KAAK,aAAa,CAAA;CAC1F,CAAA"}

package/dist/utils/attribute-rules.d.ts

@@ -2,6 +2,13 @@ import { AttributeDefaults, AttributeRules } from './attribute-rules.types';
 import { ResolvableRecord } from './resolve-definition.types';
 import { AnyDialecteConfig } from '../types';
 export type { AttributeDefaults, AttributeRules } from './attribute-rules.types';
+/**
+ * The schema rules of one attribute of an element where it sits: whether the element and the attribute are
+ * declared, whether the attribute is required or an identity field, its `fixed` and `default` values and its
+ * namespace.
+ *
+ * @intent know whether an attribute is required, read an attribute's default or fixed value, check whether an attribute is declared for an element
+ */
 export declare function getAttributeRules(params: {
     dialecteConfig: AnyDialecteConfig;
     /** The element and its parent: the rules are those of its definition there. */
@@ -13,6 +20,8 @@ export declare function getAttributeRules(params: {
  * Derived entirely from {@link getAttributeRules}, so read, compare, and export share
  * one source of truth. Returns `undefined` when nothing should be injected. A stored
  * value always wins and is handled by the caller before this is consulted.
+ *
+ * @intent know which schema value an absent attribute takes, fill an absent attribute with its schema default or fixed value
  */
 export declare function resolveSchemaAttributeValue(params: {
     dialecteConfig: AnyDialecteConfig;
@@ -25,6 +34,8 @@ export declare function resolveSchemaAttributeValue(params: {
  * `fixed` value if any, else the `default` (including an empty-string default).
  * Compare sites drop attributes for which this is true so that an authored
  * default-equal value and an absent attribute fold to the same thing.
+ *
+ * @intent compare attributes ignoring schema defaults, tell whether a value equals an attribute's default
  */
 export declare function isSchemaDefaultValue(params: {
     dialecteConfig: AnyDialecteConfig;
@@ -32,6 +43,10 @@ export declare function isSchemaDefaultValue(params: {
     attributeName: string;
     value: string;
 }): boolean;
-/** Local part of an attribute name — strips a namespace prefix if present (`a:b` → `b`). */
+/**
+ * Local part of an attribute name — strips a namespace prefix if present (`a:b` → `b`).
+ *
+ * @intent strip the prefix from an attribute name, get the local name of a qualified name
+ */
 export declare function extractLocalName(name: string): string;
 //# sourceMappingURL=attribute-rules.d.ts.map

package/dist/utils/attribute-rules.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"attribute-rules.d.ts","sourceRoot":"","sources":["../../src/utils/attribute-rules.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAChF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAA;AAClE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAEhD,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAEhF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE;IACzC,cAAc,EAAE,iBAAiB,CAAA;IACjC,+EAA+E;IAC/E,MAAM,EAAE,gBAAgB,CAAA;IACxB,aAAa,EAAE,MAAM,CAAA;CACrB,GAAG,cAAc,CAgBjB;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE;IACnD,cAAc,EAAE,iBAAiB,CAAA;IACjC,MAAM,EAAE,gBAAgB,CAAA;IACxB,aAAa,EAAE,MAAM,CAAA;IACrB,QAAQ,EAAE,iBAAiB,CAAA;CAC3B,GAAG,MAAM,GAAG,SAAS,CAerB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE;IAC5C,cAAc,EAAE,iBAAiB,CAAA;IACjC,MAAM,EAAE,gBAAgB,CAAA;IACxB,aAAa,EAAE,MAAM,CAAA;IACrB,KAAK,EAAE,MAAM,CAAA;CACb,GAAG,OAAO,CAKV;AAED,4FAA4F;AAC5F,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGrD"}
+{"version":3,"file":"attribute-rules.d.ts","sourceRoot":"","sources":["../../src/utils/attribute-rules.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAChF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAA;AAClE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAEhD,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAEhF;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE;IACzC,cAAc,EAAE,iBAAiB,CAAA;IACjC,+EAA+E;IAC/E,MAAM,EAAE,gBAAgB,CAAA;IACxB,aAAa,EAAE,MAAM,CAAA;CACrB,GAAG,cAAc,CAgBjB;AAED;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE;IACnD,cAAc,EAAE,iBAAiB,CAAA;IACjC,MAAM,EAAE,gBAAgB,CAAA;IACxB,aAAa,EAAE,MAAM,CAAA;IACrB,QAAQ,EAAE,iBAAiB,CAAA;CAC3B,GAAG,MAAM,GAAG,SAAS,CAerB;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE;IAC5C,cAAc,EAAE,iBAAiB,CAAA;IACjC,MAAM,EAAE,gBAAgB,CAAA;IACxB,aAAa,EAAE,MAAM,CAAA;IACrB,KAAK,EAAE,MAAM,CAAA;CACb,GAAG,OAAO,CAKV;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGrD"}

package/dist/utils/child-occurrences.constants.d.ts

@@ -0,0 +1,4 @@
+import { ChildOccurrences } from './child-occurrences.types';
+/** A child the content model does not constrain: optional, unbounded. */
+export declare const UNCONSTRAINED: ChildOccurrences;
+//# sourceMappingURL=child-occurrences.constants.d.ts.map

package/dist/utils/child-occurrences.constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"child-occurrences.constants.d.ts","sourceRoot":"","sources":["../../src/utils/child-occurrences.constants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAA;AAEjE,yEAAyE;AACzE,eAAO,MAAM,aAAa,EAAE,gBAA6C,CAAA"}

package/dist/utils/child-occurrences.d.ts

@@ -0,0 +1,17 @@
+import { ChildOccurrences } from './child-occurrences.types';
+import { ContentDefinition } from '../types';
+export type { ChildOccurrences } from './child-occurrences.types';
+/**
+ * How often each child may appear under an element, read from its resolved definition (`resolveDefinition`,
+ * or `query.getDefinition`): per child in `children.sequence` order, `{ min, max }` with `max` undefined for
+ * unbounded. An absent `minOccurs` is 0 and an absent `maxOccurs` unbounded, as the generator writes them; a
+ * sequence adds what its particles allow, a choice keeps the widest of its branches (0 when a branch lacks the
+ * child), a group's own occurrences multiply what it holds. A child the content model does not name (no model,
+ * or one only a variant holds) is optional and unbounded.
+ *
+ * @intent how many times a child may appear, required or optional children of an element, cardinality of children
+ */
+export declare function childOccurrences(params: {
+    definition: Pick<ContentDefinition, 'children' | 'contentModel'>;
+}): Readonly<Record<string, ChildOccurrences>>;
+//# sourceMappingURL=child-occurrences.d.ts.map

package/dist/utils/child-occurrences.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"child-occurrences.d.ts","sourceRoot":"","sources":["../../src/utils/child-occurrences.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAA;AACjE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAEhD,YAAY,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAA;AAEjE;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE;IACxC,UAAU,EAAE,IAAI,CAAC,iBAAiB,EAAE,UAAU,GAAG,cAAc,CAAC,CAAA;CAChE,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAM7C"}

package/dist/utils/child-occurrences.types.d.ts

@@ -0,0 +1,6 @@
+/** How often a child may appear under an element: `max` undefined = unbounded. */
+export type ChildOccurrences = {
+    readonly min: number;
+    readonly max: number | undefined;
+};
+//# sourceMappingURL=child-occurrences.types.d.ts.map

package/dist/utils/child-occurrences.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"child-occurrences.types.d.ts","sourceRoot":"","sources":["../../src/utils/child-occurrences.types.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,MAAM,MAAM,gBAAgB,GAAG;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAChC,CAAA"}

package/dist/utils/datatype.d.ts

@@ -2,11 +2,15 @@ import { DataType } from '../types';
 /**
  * The values a datatype enumerates: its own enumeration, else those its union members enumerate - a member
  * restricted by a pattern alone enumerates none. A qualified name's values are written `{uri}local`.
+ *
+ * @intent list the allowed values of an attribute, read the enumeration of a datatype, fill a dropdown with allowed values
  */
 export declare function enumeratedValues(datatype: DataType | undefined): readonly string[];
 /**
  * The patterns of a datatype's own levels, each anchored to the whole value and compiled with the `u` flag the
  * definition writes them for: a value must match every one (one pattern of a level is enough within it).
+ *
+ * @intent validate an attribute value against its datatype patterns, get the regular expressions an attribute value must match
  */
 export declare function valuePatterns(datatype: DataType | undefined): readonly RegExp[];
 //# sourceMappingURL=datatype.d.ts.map

package/dist/utils/datatype.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"datatype.d.ts","sourceRoot":"","sources":["../../src/utils/datatype.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAEvC;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,GAAG,SAAS,GAAG,SAAS,MAAM,EAAE,CAKlF;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,QAAQ,GAAG,SAAS,GAAG,SAAS,MAAM,EAAE,CAI/E"}
+{"version":3,"file":"datatype.d.ts","sourceRoot":"","sources":["../../src/utils/datatype.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAEvC;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,GAAG,SAAS,GAAG,SAAS,MAAM,EAAE,CAKlF;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,QAAQ,GAAG,SAAS,GAAG,SAAS,MAAM,EAAE,CAI/E"}

package/dist/utils/format-xml.d.ts

@@ -8,6 +8,8 @@
  * whitespace *between* elements: attribute text and leaf text are preserved verbatim, and an element with
  * mixed text + element content is emitted with its original inner content untouched, so no significant
  * value is ever altered. Idempotent.
+ *
+ * @intent pretty-print an XML string, format XML for a snapshot or a fixture, indent XML without changing values
  */
 export declare function formatXml(source: string, options?: {
     indent?: string;
@@ -18,6 +20,8 @@ export declare function formatXml(source: string, options?: {
  * `/* xml *\/` marker comment — with {@link formatXml}, re-indented under the marker's own line with the
  * closing backtick aligned to the statement. Leaves the rest of the source untouched. The reusable core
  * of an `xmlfmt`-style step for test fixtures (see the `dialecte-xmlfmt` bin).
+ *
+ * @intent format XML fixtures inside test files, reindent xml template literals in source code
  */
 export declare function formatEmbeddedXml(sourceCode: string, options?: {
     indent?: string;

package/dist/utils/format-xml.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"format-xml.d.ts","sourceRoot":"","sources":["../../src/utils/format-xml.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CACxB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAO,GACpD,MAAM,CAOR;AAyJD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,MAAM,CAW/F"}
+{"version":3,"file":"format-xml.d.ts","sourceRoot":"","sources":["../../src/utils/format-xml.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CACxB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAO,GACpD,MAAM,CAUR;AA0JD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,MAAM,CAY/F"}

package/dist/utils/index.d.ts

@@ -1,11 +1,15 @@
 export * from './attribute-rules';
+export * from './child-occurrences';
 export * from './datatype';
 export * from './format-xml';
 export * from './invariant';
 export * from './namespaces';
 export * from './order-children';
-export * from './save-to-disk';
+export * from './required-choices';
+export { saveToDisk } from './save-to-disk';
 export * from './resolve-definition';
 export { canonicalXsiType, resolveXsiType } from './xsi-type';
 export type { NamespaceLookup, XsiTypeName } from './xsi-type';
+export * from './seeded-uuid';
+export type * from './seeded-uuid.types';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAA;AACjC,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,kBAAkB,CAAA;AAChC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,sBAAsB,CAAA;AACpC,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAC7D,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAA;AACjC,cAAc,qBAAqB,CAAA;AACnC,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,kBAAkB,CAAA;AAChC,cAAc,oBAAoB,CAAA;AAClC,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAC3C,cAAc,sBAAsB,CAAA;AACpC,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAC7D,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAC9D,cAAc,eAAe,CAAA;AAC7B,mBAAmB,qBAAqB,CAAA"}

package/dist/utils/invariant.d.ts

@@ -5,6 +5,8 @@ import { DialecteErrorDefinition, DialecteErrorKey } from '../errors';
  * `key` is a key of the core catalogue or an error a dialecte declared with `defineErrors`;
  * `meta` says what the error is about, as data a consumer can build its own wording from.
  *
+ * @intent assert a condition and throw a structured error, guard against a missing record, fail with a dialecte error key
+ *
  * @example
  * invariant(record, { detail: 'addChild: parent not found' })
  * invariant(ref.id, { detail: 'Singleton element has no id', key: 'ELEMENT_NOT_FOUND' })

package/dist/utils/invariant.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"invariant.d.ts","sourceRoot":"","sources":["../../src/utils/invariant.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAEzE;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CACxB,SAAS,EAAE,OAAO,EAClB,KAAK,EAAE;IACN,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,CAAC,EAAE,gBAAgB,GAAG,uBAAuB,CAAA;IAChD,GAAG,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IACtC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC9B,GACC,OAAO,CAAC,SAAS,CAInB"}
+{"version":3,"file":"invariant.d.ts","sourceRoot":"","sources":["../../src/utils/invariant.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAEzE;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CACxB,SAAS,EAAE,OAAO,EAClB,KAAK,EAAE;IACN,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,CAAC,EAAE,gBAAgB,GAAG,uBAAuB,CAAA;IAChD,GAAG,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IACtC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC9B,GACC,OAAO,CAAC,SAAS,CAInB"}

package/dist/utils/namespaces.d.ts

@@ -3,6 +3,8 @@ import { AnyDialecteConfig, Namespace, Wildcard } from '../types';
  * Resolve a namespace declared in the config by its prefix (e.g. `ext`,
  * `dev`). Returns `undefined` for an empty prefix or an unknown one —
  * consumers cannot extend `config.namespaces`, so an unknown prefix is a caller error.
+ *
+ * @intent find a declared namespace by its prefix, map a prefix to its namespace URI
  */
 export declare function resolveNamespaceByPrefix(dialecteConfig: Pick<AnyDialecteConfig, 'namespaces'>, prefix: string): Namespace | undefined;
 /**
@@ -11,6 +13,8 @@ export declare function resolveNamespaceByPrefix(dialecteConfig: Pick<AnyDialect
  * against declared prefixes. Returns `undefined` when the scope is neither a known
  * key nor a known prefix — an authoring error, since a registered namespace must be
  * referenced by key (use a full `{ prefix, uri }` object for custom namespaces).
+ *
+ * @intent find a namespace by its config key, resolve a namespace scope to its prefix and URI
  */
 export declare function resolveNamespaceByScope(dialecteConfig: Pick<AnyDialecteConfig, 'namespaces'>, scope: string): Namespace | undefined;
 /**
@@ -18,6 +22,8 @@ export declare function resolveNamespaceByScope(dialecteConfig: Pick<AnyDialecte
  * The scope is normally a config namespace **key** (e.g. `ext`, `dev`), which we map
  * to its declared prefix. If the scope is not a declared key it is treated as a raw
  * prefix, so callers can still target custom namespaces the config is unaware of.
+ *
+ * @intent find the prefix to store an attribute under, write an attribute in a declared or custom namespace
  */
 export declare function resolvePrefixByNamespaceScope(dialecteConfig: Pick<AnyDialecteConfig, 'namespaces'>, namespaceScope: string): string;
 /**
@@ -26,6 +32,8 @@ export declare function resolvePrefixByNamespaceScope(dialecteConfig: Pick<AnyDi
  * foreign-namespace attributes). Sorted by namespace URI, then name, so two
  * records carrying the same attribute set compare equal regardless of the order
  * they were parsed, cloned, or updated in.
+ *
+ * @internal the comparator `orderAttributesBySequence` sorts extra attributes with
  */
 export declare function compareQualifiedAttributes(a: {
     name: string;
@@ -39,12 +47,18 @@ export declare function compareQualifiedAttributes(a: {
  * first (in `sequence` order), then everything else sorted deterministically.
  * Never drops attributes — reorders only — so it is safe to re-apply after an
  * `afterStandardizedRecord` hook to normalize whatever the hook added or moved.
+ *
+ * @intent put attributes in schema order, normalize attribute order after a hook
  */
 export declare function orderAttributesBySequence<GenericAttribute extends {
     name: string;
     namespace?: Namespace;
 }>(attributes: readonly GenericAttribute[], sequence: readonly string[]): GenericAttribute[];
-/** Whether a wildcard allows a namespace (`''` = none): the namespaces it lists, or every one it does not exclude. */
+/**
+ * Whether a wildcard allows a namespace (`''` = none): the namespaces it lists, or every one it does not exclude.
+ *
+ * @intent check whether a wildcard admits a namespace, tell whether foreign attributes or elements are allowed
+ */
 export declare function isNamespaceAllowedByWildcard(params: {
     wildcard: Wildcard | undefined;
     namespaceUri: string;

package/dist/utils/namespaces.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"namespaces.d.ts","sourceRoot":"","sources":["../../src/utils/namespaces.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAErE;;;;GAIG;AACH,wBAAgB,wBAAwB,CACvC,cAAc,EAAE,IAAI,CAAC,iBAAiB,EAAE,YAAY,CAAC,EACrD,MAAM,EAAE,MAAM,GACZ,SAAS,GAAG,SAAS,CAIvB;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACtC,cAAc,EAAE,IAAI,CAAC,iBAAiB,EAAE,YAAY,CAAC,EACrD,KAAK,EAAE,MAAM,GACX,SAAS,GAAG,SAAS,CAGvB;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAC5C,cAAc,EAAE,IAAI,CAAC,iBAAiB,EAAE,YAAY,CAAC,EACrD,cAAc,EAAE,MAAM,GACpB,MAAM,CAER;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACzC,CAAC,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,SAAS,CAAA;CAAE,EAC1C,CAAC,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,SAAS,CAAA;CAAE,GACxC,MAAM,CAMR;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACxC,gBAAgB,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,SAAS,CAAA;CAAE,EAC/D,UAAU,EAAE,SAAS,gBAAgB,EAAE,EAAE,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,gBAAgB,EAAE,CAS1F;AAED,sHAAsH;AACtH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE;IACpD,QAAQ,EAAE,QAAQ,GAAG,SAAS,CAAA;IAC9B,YAAY,EAAE,MAAM,CAAA;CACpB,GAAG,OAAO,CAMV"}
+{"version":3,"file":"namespaces.d.ts","sourceRoot":"","sources":["../../src/utils/namespaces.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAErE;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACvC,cAAc,EAAE,IAAI,CAAC,iBAAiB,EAAE,YAAY,CAAC,EACrD,MAAM,EAAE,MAAM,GACZ,SAAS,GAAG,SAAS,CAIvB;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACtC,cAAc,EAAE,IAAI,CAAC,iBAAiB,EAAE,YAAY,CAAC,EACrD,KAAK,EAAE,MAAM,GACX,SAAS,GAAG,SAAS,CAGvB;AAED;;;;;;;GAOG;AACH,wBAAgB,6BAA6B,CAC5C,cAAc,EAAE,IAAI,CAAC,iBAAiB,EAAE,YAAY,CAAC,EACrD,cAAc,EAAE,MAAM,GACpB,MAAM,CAER;AAED;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CACzC,CAAC,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,SAAS,CAAA;CAAE,EAC1C,CAAC,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,SAAS,CAAA;CAAE,GACxC,MAAM,CAMR;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACxC,gBAAgB,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,SAAS,CAAA;CAAE,EAC/D,UAAU,EAAE,SAAS,gBAAgB,EAAE,EAAE,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,gBAAgB,EAAE,CAS1F;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE;IACpD,QAAQ,EAAE,QAAQ,GAAG,SAAS,CAAA;IAC9B,YAAY,EAAE,MAAM,CAAA;CACpB,GAAG,OAAO,CAMV"}

package/dist/utils/order-children.d.ts

@@ -1,13 +1,23 @@
+import { AnyDefinition } from '../types';
 /**
  * Order a parent's child nodes by the config-declared child sequence.
  *
  * Generic over node type (anything with a `tagName`) so the same logic serves
  * both record-level XML building and TreeRecord post-processing — a single
- * source of truth for "config order". Children whose tagName is not in the
- * sequence are appended last, preserving their relative order. When the parent
- * has no declared sequence, the input order is returned unchanged.
+ * source of truth for "config order". With the dialecte's `definition`, a child
+ * outside the sequence whose tag the definition declares, and that a wildcard of
+ * the parent's content model admits (by its declared tag's namespace: a node
+ * carries no namespace), takes that wildcard's slot: the first admitting
+ * wildcard with room left (its maxOccurs, times those of the groups holding it).
+ * The other children outside the sequence are appended last, preserving their
+ * relative order. The parent's content model is its tag level's; a wildcard
+ * before a child declared again further on (`A, any, A`) sits after that child's
+ * group, as a declared tag has one place. When the parent has no declared
+ * sequence, the input order is returned unchanged.
  *
  * Pure function — no side effects.
+ *
+ * @intent sort children in schema order, order nodes the way the export writes them
  */
 export declare function orderByConfigSequence<GenericNode extends {
     tagName: string;
@@ -15,5 +25,6 @@ export declare function orderByConfigSequence<GenericNode extends {
     parentTagName: string;
     children: GenericNode[];
     childrenConfig: Record<string, readonly string[]>;
+    definition?: AnyDefinition;
 }): GenericNode[];
 //# sourceMappingURL=order-children.d.ts.map

package/dist/utils/order-children.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"order-children.d.ts","sourceRoot":"","sources":["../../src/utils/order-children.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,SAAS;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,EAAE,MAAM,EAAE;IACtF,aAAa,EAAE,MAAM,CAAA;IACrB,QAAQ,EAAE,WAAW,EAAE,CAAA;IACvB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAA;CACjD,GAAG,WAAW,EAAE,CAwBhB"}
+{"version":3,"file":"order-children.d.ts","sourceRoot":"","sources":["../../src/utils/order-children.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAY,MAAM,SAAS,CAAA;AAEtD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,SAAS;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,EAAE,MAAM,EAAE;IACtF,aAAa,EAAE,MAAM,CAAA;IACrB,QAAQ,EAAE,WAAW,EAAE,CAAA;IACvB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAA;IACjD,UAAU,CAAC,EAAE,aAAa,CAAA;CAC1B,GAAG,WAAW,EAAE,CAyChB"}

package/dist/utils/order-children.types.d.ts

@@ -0,0 +1,10 @@
+import { Wildcard } from '../types';
+/** A wildcard of a content model, where its children go and how many it takes. */
+export type WildcardSlot = {
+    wildcard: Wildcard;
+    /** The declared child it sits before (`undefined` = after them all). */
+    before: string | undefined;
+    /** Its maxOccurs times those of the groups holding it (`Infinity` = unbounded). */
+    capacity: number;
+};
+//# sourceMappingURL=order-children.types.d.ts.map

package/dist/utils/order-children.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"order-children.types.d.ts","sourceRoot":"","sources":["../../src/utils/order-children.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAEvC,kFAAkF;AAClF,MAAM,MAAM,YAAY,GAAG;IAC1B,QAAQ,EAAE,QAAQ,CAAA;IAClB,wEAAwE;IACxE,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1B,mFAAmF;IACnF,QAAQ,EAAE,MAAM,CAAA;CAChB,CAAA"}

package/dist/utils/particle-occurrences.d.ts

@@ -0,0 +1,4 @@
+import { ChildOccurrences } from './child-occurrences.types';
+import { Particle } from '../types';
+export declare function occurrencesOf(particle: Particle): Map<string, ChildOccurrences>;
+//# sourceMappingURL=particle-occurrences.d.ts.map

package/dist/utils/particle-occurrences.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"particle-occurrences.d.ts","sourceRoot":"","sources":["../../src/utils/particle-occurrences.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAA;AACjE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAEvC,wBAAgB,aAAa,CAAC,QAAQ,EAAE,QAAQ,GAAG,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAkB/E"}

package/dist/utils/required-choices.d.ts

@@ -0,0 +1,17 @@
+import { RequiredChoice } from './required-choices.types';
+import { ContentDefinition } from '../types';
+export type { ChoiceBranch, RequiredChoice } from './required-choices.types';
+/**
+ * The choices an element's content model requires (`resolveDefinition`, or `query.getDefinition`): each one
+ * reached through groups that are all required, with how many times it is taken (the groups' own minimum
+ * occurrences multiplied) and its branches in order - per branch, how often it holds each child (as
+ * `childOccurrences` counts them) and the choices it requires in turn. `childOccurrences` reads a child of a
+ * choice of several branches as optional; this is where a valid instance learns it must take one branch. An
+ * optional choice, or one inside an optional group, is not listed.
+ *
+ * @intent which children an element must hold where its content model offers a choice, the branches of a required choice, build a valid element from its content model
+ */
+export declare function requiredChoices(params: {
+    definition: Pick<ContentDefinition, 'contentModel'>;
+}): readonly RequiredChoice[];
+//# sourceMappingURL=required-choices.d.ts.map

package/dist/utils/required-choices.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"required-choices.d.ts","sourceRoot":"","sources":["../../src/utils/required-choices.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAgB,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAC5E,OAAO,KAAK,EAAE,iBAAiB,EAAY,MAAM,SAAS,CAAA;AAE1D,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAE5E;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE;IACvC,UAAU,EAAE,IAAI,CAAC,iBAAiB,EAAE,cAAc,CAAC,CAAA;CACnD,GAAG,SAAS,cAAc,EAAE,CAG5B"}

package/dist/utils/required-choices.types.d.ts

@@ -0,0 +1,15 @@
+import { ChildOccurrences } from './child-occurrences.types';
+/**
+ * A choice a content model requires: taken at least `min` times wherever the element is, one of its
+ * `branches` each time.
+ */
+export type RequiredChoice = {
+    readonly min: number;
+    readonly branches: readonly ChoiceBranch[];
+};
+/** One branch of a choice: how often it holds each child, and the choices it requires in turn when taken. */
+export type ChoiceBranch = {
+    readonly children: Readonly<Record<string, ChildOccurrences>>;
+    readonly choices: readonly RequiredChoice[];
+};
+//# sourceMappingURL=required-choices.types.d.ts.map

package/dist/utils/required-choices.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"required-choices.types.d.ts","sourceRoot":"","sources":["../../src/utils/required-choices.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAA;AAEjE;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,CAAA;CAC1C,CAAA;AAED,6GAA6G;AAC7G,MAAM,MAAM,YAAY,GAAG;IAC1B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAA;IAC7D,QAAQ,CAAC,OAAO,EAAE,SAAS,cAAc,EAAE,CAAA;CAC3C,CAAA"}

package/dist/utils/resolve-definition.d.ts

@@ -14,6 +14,8 @@ type DefinitionConfig = Pick<AnyDialecteConfig, 'definition' | 'types' | 'namesp
  * when its declaration admits the type, gives what the type lets it hold.
  * It takes a record, whose `parent` is always known (`null` for the root); a ref carries no parent,
  * so a caller holding one uses `query.getDefinition(ref)`, which fetches the record first.
+ *
+ * @intent read the definition of a record you hold without a query, know what an element may hold under its parent, walk definitions top-down
  */
 export declare function resolveDefinition(params: {
     dialecteConfig: DefinitionConfig;
@@ -24,6 +26,8 @@ export declare function resolveDefinition(params: {
  * The types the record may name with xsi:type (Clark names): its declared type when named and not abstract, and its
  * variants; where its parent leaves the declaration open, those any declaration of the tag admits. The record's own
  * xsi:type is not read.
+ *
+ * @intent list the xsi:type values an element may take, offer type choices for an element
  */
 export declare function admittedXsiTypes(params: {
     dialecteConfig: DefinitionConfig;

package/dist/utils/resolve-definition.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-definition.d.ts","sourceRoot":"","sources":["../../src/utils/resolve-definition.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAA;AAClE,OAAO,KAAK,EACX,iBAAiB,EAEjB,qBAAqB,EAErB,kBAAkB,EAClB,MAAM,SAAS,CAAA;AAEhB,YAAY,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAA;AAElE,wFAAwF;AACxF,KAAK,gBAAgB,GAAG,IAAI,CAAC,iBAAiB,EAAE,YAAY,GAAG,OAAO,GAAG,YAAY,CAAC,CAAA;AAEtF;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE;IACzC,cAAc,EAAE,gBAAgB,CAAA;IAChC,MAAM,EAAE,gBAAgB,CAAA;IACxB,gBAAgB,CAAC,EAAE,qBAAqB,CAAA;CACxC,GAAG,kBAAkB,GAAG,SAAS,CAoBjC;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE;IACxC,cAAc,EAAE,gBAAgB,CAAA;IAChC,MAAM,EAAE,gBAAgB,CAAA;IACxB,gBAAgB,CAAC,EAAE,qBAAqB,CAAA;CACxC,GAAG,SAAS,MAAM,EAAE,CAcpB"}
+{"version":3,"file":"resolve-definition.d.ts","sourceRoot":"","sources":["../../src/utils/resolve-definition.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAA;AAClE,OAAO,KAAK,EACX,iBAAiB,EAEjB,qBAAqB,EAErB,kBAAkB,EAClB,MAAM,SAAS,CAAA;AAEhB,YAAY,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAA;AAElE,wFAAwF;AACxF,KAAK,gBAAgB,GAAG,IAAI,CAAC,iBAAiB,EAAE,YAAY,GAAG,OAAO,GAAG,YAAY,CAAC,CAAA;AAEtF;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE;IACzC,cAAc,EAAE,gBAAgB,CAAA;IAChC,MAAM,EAAE,gBAAgB,CAAA;IACxB,gBAAgB,CAAC,EAAE,qBAAqB,CAAA;CACxC,GAAG,kBAAkB,GAAG,SAAS,CAoBjC;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE;IACxC,cAAc,EAAE,gBAAgB,CAAA;IAChC,MAAM,EAAE,gBAAgB,CAAA;IACxB,gBAAgB,CAAC,EAAE,qBAAqB,CAAA;CACxC,GAAG,SAAS,MAAM,EAAE,CAcpB"}

package/dist/utils/save-to-disk.constants.d.ts

@@ -0,0 +1,3 @@
+/** What a save dialog throws when the user's gesture has lapsed: the save then goes through a download. */
+export declare const LAPSED_GESTURE_ERRORS: readonly string[];
+//# sourceMappingURL=save-to-disk.constants.d.ts.map

package/dist/utils/save-to-disk.constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"save-to-disk.constants.d.ts","sourceRoot":"","sources":["../../src/utils/save-to-disk.constants.ts"],"names":[],"mappings":"AAAA,2GAA2G;AAC3G,eAAO,MAAM,qBAAqB,EAAE,SAAS,MAAM,EAAyC,CAAA"}

package/dist/utils/save-to-disk.d.ts

@@ -1,17 +1,29 @@
+import { SavePickerType, SaveTarget } from './save-to-disk.types';
+export type { SavePickerType, SaveTarget } from './save-to-disk.types';
 /**
  * Save a Blob to disk using the native File System Access API when available
  * (Chrome / Edge) and falling back to a hidden anchor download (Safari /
- * Firefox).
+ * Firefox), also when the dialog is refused because the user's gesture lapsed. The user cancelling the dialog
+ * saves nothing; any other failure is thrown.
  *
  * Browser-only: relies on `window`, `document`, and `URL`.
+ *
+ * @intent save a Blob as a file, download an exported document, open a save dialog in the browser
  */
 export declare function saveToDisk(params: {
     data: Blob;
     filename: string;
     /** Optional picker type descriptor for `showSaveFilePicker`. */
-    pickerType?: {
-        description: string;
-        accept: Record<string, string[]>;
-    };
+    pickerType?: SavePickerType;
 }): Promise<void>;
+/**
+ * Where a file will be saved, asked BEFORE the file is made: the save dialog needs the user's gesture, which
+ * lapses after a few seconds - shorter than a large export. `undefined` when the user cancels the dialog; a dialog
+ * refused because the gesture lapsed, or no File System Access API, gives a browser download; any other failure is
+ * thrown.
+ */
+export declare function openSaveTarget(params: {
+    filename: string;
+    pickerType?: SavePickerType;
+}): Promise<SaveTarget | undefined>;
 //# sourceMappingURL=save-to-disk.d.ts.map

package/dist/utils/save-to-disk.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"save-to-disk.d.ts","sourceRoot":"","sources":["../../src/utils/save-to-disk.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAsB,UAAU,CAAC,MAAM,EAAE;IACxC,IAAI,EAAE,IAAI,CAAA;IACV,QAAQ,EAAE,MAAM,CAAA;IAChB,gEAAgE;IAChE,UAAU,CAAC,EAAE;QACZ,WAAW,EAAE,MAAM,CAAA;QACnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;KAChC,CAAA;CACD,GAAG,OAAO,CAAC,IAAI,CAAC,CA4BhB"}
+{"version":3,"file":"save-to-disk.d.ts","sourceRoot":"","sources":["../../src/utils/save-to-disk.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAwB,cAAc,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AAE5F,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AAEtE;;;;;;;;;GASG;AACH,wBAAsB,UAAU,CAAC,MAAM,EAAE;IACxC,IAAI,EAAE,IAAI,CAAA;IACV,QAAQ,EAAE,MAAM,CAAA;IAChB,gEAAgE;IAChE,UAAU,CAAC,EAAE,cAAc,CAAA;CAC3B,GAAG,OAAO,CAAC,IAAI,CAAC,CAIhB;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE;IAC5C,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,cAAc,CAAA;CAC3B,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAkBlC"}

package/dist/utils/save-to-disk.types.d.ts

@@ -0,0 +1,17 @@
+/** The file types a save dialog offers (`showSaveFilePicker`'s `types` entry). */
+export type SavePickerType = {
+    description: string;
+    accept: Record<string, string[]>;
+};
+/** Where a file goes once it is ready: the file chosen in the save dialog, or a browser download. */
+export type SaveTarget = {
+    write: (data: Blob) => Promise<void>;
+};
+/** The page's `showSaveFilePicker` (File System Access API; Chrome and Edge). */
+export type SaveFilePickerWindow = {
+    showSaveFilePicker: (options: {
+        suggestedName: string;
+        types?: SavePickerType[];
+    }) => Promise<FileSystemFileHandle>;
+};
+//# sourceMappingURL=save-to-disk.types.d.ts.map