@dialecte/core 0.7.0 → 0.8.0

package/dist/utils/tell-listener.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Tell a listener, never waiting for it: a listener on the far side of a closed port may never answer, and its
+ * failure is not the caller's - reported on the console with what it was told of (`of`), the caller going on: once
+ * per `call` when it names one (a progress listener's import, export or commit), else each time.
+ */
+export declare function tellListener<GenericValue>(params: {
+    listener: ((value: GenericValue) => unknown) | undefined;
+    value: GenericValue;
+    /** What the listener is told of, as the report names it ("an import's progress"). */
+    of: string;
+    /** The call the listener is told for, its failures reported once for it; none: each failure reported. */
+    call?: object;
+}): void;
+/** What a store's subscribers are told of, as the report of a failure names it. */
+export declare function changesOfProject(params: {
+    name: string;
+}): string;
+/** Tell each listener `value`, as the set stood when told: one that fails stops no other. */
+export declare function tellListeners<GenericValue>(params: {
+    listeners: Iterable<(value: GenericValue) => unknown>;
+    value: GenericValue;
+    of: string;
+}): void;
+//# sourceMappingURL=tell-listener.d.ts.map

package/dist/utils/tell-listener.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tell-listener.d.ts","sourceRoot":"","sources":["../../src/utils/tell-listener.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,YAAY,EAAE,MAAM,EAAE;IAClD,QAAQ,EAAE,CAAC,CAAC,KAAK,EAAE,YAAY,KAAK,OAAO,CAAC,GAAG,SAAS,CAAA;IACxD,KAAK,EAAE,YAAY,CAAA;IACnB,qFAAqF;IACrF,EAAE,EAAE,MAAM,CAAA;IACV,yGAAyG;IACzG,IAAI,CAAC,EAAE,MAAM,CAAA;CACb,GAAG,IAAI,CAcP;AAED,mFAAmF;AACnF,wBAAgB,gBAAgB,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAEjE;AAED,6FAA6F;AAC7F,wBAAgB,aAAa,CAAC,YAAY,EAAE,MAAM,EAAE;IACnD,SAAS,EAAE,QAAQ,CAAC,CAAC,KAAK,EAAE,YAAY,KAAK,OAAO,CAAC,CAAA;IACrD,KAAK,EAAE,YAAY,CAAA;IACnB,EAAE,EAAE,MAAM,CAAA;CACV,GAAG,IAAI,CAGP"}

package/dist/utils/xml-characters.constants.d.ts

@@ -0,0 +1,9 @@
+/**
+ * A character XML does not allow in a document, written or as a character reference, that a well-formed string can
+ * hold: a control character below U+0020 other than tab, line feed and carriage return, U+FFFE, U+FFFF. (A lone
+ * surrogate, the rest of what XML forbids, is not well-formed text: every store refuses it.)
+ */
+export declare const NOT_XML_CHARACTER: RegExp;
+/** A byte order mark: a file may begin with it; it is no part of the XML that follows. */
+export declare const BYTE_ORDER_MARK = "\uFEFF";
+//# sourceMappingURL=xml-characters.constants.d.ts.map

package/dist/utils/xml-characters.constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xml-characters.constants.d.ts","sourceRoot":"","sources":["../../src/utils/xml-characters.constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,iBAAiB,QAAyD,CAAA;AAEvF,0FAA0F;AAC1F,eAAO,MAAM,eAAe,WAAa,CAAA"}

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

@@ -0,0 +1,8 @@
+/**
+ * The first character of `text` XML does not allow (a control character below U+0020 other than tab, line feed
+ * and carriage return, U+FFFE, U+FFFF), named as `U+XXXX`; `undefined` when there is none.
+ */
+export declare function notXmlCharacterOf(params: {
+    text: string;
+}): string | undefined;
+//# sourceMappingURL=xml-characters.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"xml-characters.d.ts","sourceRoot":"","sources":["../../src/utils/xml-characters.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,GAAG,SAAS,CAI9E"}

package/dist/utils/xml-whitespace.constants.d.ts

@@ -0,0 +1,8 @@
+/** The four characters XML counts as whitespace, by UTF-16 code unit: no other Unicode space is one. */
+export declare const XML_SPACE = 32;
+export declare const XML_TAB = 9;
+export declare const XML_CARRIAGE_RETURN = 13;
+export declare const XML_LINE_FEED = 10;
+/** A run of XML whitespace: space, tab, carriage return and line feed only. */
+export declare const XML_WHITESPACE_RUN: RegExp;
+//# sourceMappingURL=xml-whitespace.constants.d.ts.map

package/dist/utils/xml-whitespace.constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xml-whitespace.constants.d.ts","sourceRoot":"","sources":["../../src/utils/xml-whitespace.constants.ts"],"names":[],"mappings":"AAAA,wGAAwG;AACxG,eAAO,MAAM,SAAS,KAAO,CAAA;AAC7B,eAAO,MAAM,OAAO,IAAO,CAAA;AAC3B,eAAO,MAAM,mBAAmB,KAAO,CAAA;AACvC,eAAO,MAAM,aAAa,KAAO,CAAA;AAEjC,+EAA+E;AAC/E,eAAO,MAAM,kBAAkB,QAAgB,CAAA"}

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

@@ -0,0 +1,19 @@
+/**
+ * `text` without the XML whitespace (space, tab, carriage return, line feed) at its start and end; every other
+ * character is kept, those JavaScript's `trim` drops too (a no-break space, a byte order mark, U+2028...).
+ */
+export declare function trimXmlWhitespace(params: {
+    text: string;
+}): string;
+/** `text` with each run of XML whitespace written as one space; every other character is kept. */
+export declare function collapseXmlWhitespace(params: {
+    text: string;
+}): string;
+/**
+ * A run of text between two markup events as core's XML reader keeps it: trimmed of XML whitespace, each inner run
+ * of it written as one space. The indentation between elements is XML whitespace only: `''`, nothing to collapse.
+ */
+export declare function readXmlTextRun(params: {
+    text: string;
+}): string;
+//# sourceMappingURL=xml-whitespace.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"xml-whitespace.d.ts","sourceRoot":"","sources":["../../src/utils/xml-whitespace.ts"],"names":[],"mappings":"AAQA;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAQlE;AAED,kGAAkG;AAClG,wBAAgB,qBAAqB,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAEtE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAI/D"}

package/dist/utils/xsi-type.d.ts

@@ -20,6 +20,8 @@ export declare function xsiTypeNameOf(params: {
 /**
  * The type a record names with xsi:type, read as core stores it (`storedNamespaceLookup`); `undefined` without
  * xsi:type or when its prefix is bound nowhere.
+ *
+ * @intent read the type an element names with xsi:type, resolve an xsi:type prefix to its namespace
  */
 export declare function resolveXsiType(params: {
     dialecteConfig: NamespacesConfig;
@@ -40,6 +42,8 @@ export declare function storedNamespaceLookup(params: {
  * dialecte's prefix and the local name for a type in another namespace it declares. A value whose prefix is bound
  * nowhere, or naming a namespace the dialecte does not declare, is kept as written. The value keeps what XML says it
  * means: only the prefix it is written with changes.
+ *
+ * @intent write an xsi:type value the way core stores it, compare xsi:type values written with different prefixes
  */
 export declare function canonicalXsiType(params: {
     dialecteConfig: NamespacesConfig;

package/dist/utils/xsi-type.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"xsi-type.d.ts","sourceRoot":"","sources":["../../src/utils/xsi-type.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AACpE,OAAO,KAAK,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAE3D,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAEpE,KAAK,gBAAgB,GAAG,IAAI,CAAC,iBAAiB,EAAE,YAAY,CAAC,CAAA;AAC7D,KAAK,aAAa,GAAG;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAA;CAC9B,CAAA;AAED,2GAA2G;AAC3G,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,aAAa,GAAG,OAAO,CAIpE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE;IACrC,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,eAAe,CAAA;CAC5B,GAAG,WAAW,GAAG,SAAS,CAe1B;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE;IACtC,cAAc,EAAE,gBAAgB,CAAA;IAChC,MAAM,EAAE;QAAE,QAAQ,CAAC,UAAU,EAAE,SAAS,aAAa,EAAE,CAAA;KAAE,CAAA;CACzD,GAAG,WAAW,GAAG,SAAS,CAM1B;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE;IAC7C,cAAc,EAAE,gBAAgB,CAAA;IAChC,UAAU,EAAE,SAAS,aAAa,EAAE,CAAA;CACpC,GAAG,eAAe,CAelB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE;IACxC,cAAc,EAAE,gBAAgB,CAAA;IAChC,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,eAAe,CAAA;CAC5B,GAAG,MAAM,CAST;AAED,oGAAoG;AACpG,wBAAgB,oBAAoB,CAAC,gBAAgB,SAAS,aAAa,EAAE,MAAM,EAAE;IACpF,cAAc,EAAE,gBAAgB,CAAA;IAChC,UAAU,EAAE,SAAS,gBAAgB,EAAE,CAAA;IACvC,WAAW,EAAE,eAAe,CAAA;CAC5B,GAAG,gBAAgB,EAAE,CAUrB"}
+{"version":3,"file":"xsi-type.d.ts","sourceRoot":"","sources":["../../src/utils/xsi-type.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AACpE,OAAO,KAAK,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAE3D,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAEpE,KAAK,gBAAgB,GAAG,IAAI,CAAC,iBAAiB,EAAE,YAAY,CAAC,CAAA;AAC7D,KAAK,aAAa,GAAG;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAA;CAC9B,CAAA;AAED,2GAA2G;AAC3G,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,aAAa,GAAG,OAAO,CAIpE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE;IACrC,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,eAAe,CAAA;CAC5B,GAAG,WAAW,GAAG,SAAS,CAgB1B;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE;IACtC,cAAc,EAAE,gBAAgB,CAAA;IAChC,MAAM,EAAE;QAAE,QAAQ,CAAC,UAAU,EAAE,SAAS,aAAa,EAAE,CAAA;KAAE,CAAA;CACzD,GAAG,WAAW,GAAG,SAAS,CAM1B;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE;IAC7C,cAAc,EAAE,gBAAgB,CAAA;IAChC,UAAU,EAAE,SAAS,aAAa,EAAE,CAAA;CACpC,GAAG,eAAe,CAelB;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE;IACxC,cAAc,EAAE,gBAAgB,CAAA;IAChC,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,eAAe,CAAA;CAC5B,GAAG,MAAM,CAST;AAED,oGAAoG;AACpG,wBAAgB,oBAAoB,CAAC,gBAAgB,SAAS,aAAa,EAAE,MAAM,EAAE;IACpF,cAAc,EAAE,gBAAgB,CAAA;IAChC,UAAU,EAAE,SAAS,gBAAgB,EAAE,CAAA;IACvC,WAAW,EAAE,eAAe,CAAA;CAC5B,GAAG,gBAAgB,EAAE,CAUrB"}

package/dist/utils/yield-to-queue.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Let the realm's queue run (a message, a commit of another caller) before going on: a macrotask through a
+ * `MessageChannel`, with no timer clamp. Exists in pages, workers and Node.
+ */
+export declare function yieldToQueue(): Promise<void>;
+//# sourceMappingURL=yield-to-queue.d.ts.map

package/dist/utils/yield-to-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yield-to-queue.d.ts","sourceRoot":"","sources":["../../src/utils/yield-to-queue.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAS5C"}