@pubid/pubid 0.1.30 → 0.1.31

package/dist/model/identifier.d.ts

@@ -84,3 +84,12 @@ export declare abstract class BaseIdentifier {
     /** Apply custom `fromWire` converters to the inflated hash. */
     protected static applyMappings(data: Record<string, unknown>): Record<string, unknown>;
 }
+export declare function wrappedDocument(id: BaseIdentifier): BaseIdentifier | undefined;
+/** The underlying standard, peeled recursively through the view layers. */
+export declare function baseDocument(id: BaseIdentifier): BaseIdentifier;
+/**
+ * Self is a wrapped record of exactly the edition `edition` names: the
+ * wrapped document resolves to that edition. Only wrappers answer true —
+ * a bare record is its own edition and is matched by the subset match.
+ */
+export declare function wrappedEditionOf(candidate: BaseIdentifier, edition: BaseIdentifier): boolean;

package/dist/model/identifier.js

@@ -78,6 +78,7 @@ function isEmptyValue(value) {
 function resolveDefault(spec) {
     return typeof spec.default === "function" ? spec.default() : spec.default;
 }
+import { canonicalKey } from "../internal/compare.js";
 export class BaseIdentifier {
     /** The root table; subclasses compose via extendAttributes(BaseIdentifier, …). */
     static attributes = BASE_ATTRIBUTES;
@@ -272,3 +273,52 @@ export class BaseIdentifier {
 function deepEqual(a, b) {
     return JSON.stringify(a) === JSON.stringify(b);
 }
+// --- the wrapped-edition relationship (pubid#580, gem#606) -------------------
+//
+// The document a wrapper stands in front of: a declared `base` slot, or
+// the leading member of a consolidated collection. Undefined for a plain
+// identifier.
+export function wrappedDocument(id) {
+    const attrs = id;
+    if (attrs["base"] instanceof BaseIdentifier)
+        return attrs["base"];
+    const ids = attrs["identifiers"];
+    if (Array.isArray(ids) && ids[0] instanceof BaseIdentifier) {
+        return ids[0];
+    }
+    return undefined;
+}
+// The classes whose Ruby counterparts override base_document — the
+// records that are VIEWS of the document they wrap (the IEC VAP/CSV
+// record, the consolidated bundles). A supplement (an ISO/IEC amendment,
+// a corrigendum) is a separate document, not a view, so the peel stops
+// at it; the cen/csa view wrappers join when the algebra ports them.
+const BASE_DOCUMENT_VIEW_CLASSES = new Set([
+    "pubid:iec:vap-identifier",
+    "pubid:iec:consolidated-identifier",
+]);
+/** The underlying standard, peeled recursively through the view layers. */
+export function baseDocument(id) {
+    const attrs = id;
+    const ids = attrs["identifiers"];
+    if (Array.isArray(ids) && ids[0] instanceof BaseIdentifier) {
+        return baseDocument(ids[0]);
+    }
+    const ctor = id.constructor.polymorphicName;
+    if (ctor !== undefined && BASE_DOCUMENT_VIEW_CLASSES.has(ctor) &&
+        attrs["base"] instanceof BaseIdentifier) {
+        return baseDocument(attrs["base"]);
+    }
+    return id;
+}
+/**
+ * Self is a wrapped record of exactly the edition `edition` names: the
+ * wrapped document resolves to that edition. Only wrappers answer true —
+ * a bare record is its own edition and is matched by the subset match.
+ */
+export function wrappedEditionOf(candidate, edition) {
+    if (wrappedDocument(candidate) === undefined)
+        return false;
+    return canonicalKey(baseDocument(candidate).toHash()) ===
+        canonicalKey(edition.toHash());
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pubid/pubid",
-  "version": "0.1.30",
+  "version": "0.1.31",
   "description": "TypeScript PubID identifiers: resolution, normalization and canonical hashes for every identifier in the pubid-testsuite corpus (41 standards bodies), with a conformance runner mirroring the Ruby reference",
   "type": "module",
   "license": "MIT",