glossarist 0.4.50 → 0.4.52

package/dist/concept-reader.d.ts

@@ -0,0 +1,55 @@
+import type { Concept } from './models/concept.js';
+import { Register } from './models/register.js';
+/**
+ * Read all v2 glossarist concept YAML files from a directory, then
+ * merge in any per-file hyperedge YAMLs from `<dir>/relations/`.
+ *
+ * Per-file hyperedge storage (concept-model PR #83): each file at
+ * `relations/<comprehensive-id>/<slug>.yaml` is loaded and merged
+ * into the corresponding Concept.relations array. If the directory
+ * does not exist, no per-file hyperedges are loaded (concepts still
+ * get any inline hyperedges from their own YAML).
+ *
+ * @param {string} dir - path to directory containing concept YAML files
+ * @returns {import('./models/concept.js').Concept[]}
+ * @throws {InvalidInputError} if dir is missing or empty
+ *
+ * @example
+ * const concepts = readConcepts('./geolexica-v2/');
+ * console.log(concepts[0].localization('eng').terms[0].designation);
+ */
+export declare function readConcepts(dir: string): Concept[];
+/**
+ * Read a single concept file by ID from a directory, then merge in
+ * any per-file hyperedge YAMLs for that concept from
+ * `<dir>/relations/<id>/`.
+ *
+ * @param {string} dir - path to directory containing concept YAML files
+ * @param {string} id - concept identifier (filename without .yaml)
+ * @returns {import('./models/concept.js').Concept | null}
+ * @throws {InvalidInputError} if dir or id is missing or empty
+ *
+ * @example
+ * const concept = readConcept('./geolexica-v2/', '3.1.1.1');
+ * if (concept) console.log(concept.termid);
+ */
+export declare function readConcept(dir: string, id: string): Concept | null;
+/**
+ * List all concept IDs in a directory, optionally filtered by prefix.
+ * @param {string} dir - path to directory
+ * @param {string} [prefix] - optional prefix filter
+ * @returns {string[]}
+ * @throws {InvalidInputError} if dir is missing or empty
+ *
+ * @example
+ * const ids = listConceptIds('./geolexica-v2/', '3.1.'); // ['3.1.1.1', '3.1.1.2', ...]
+ */
+export declare function listConceptIds(dir: string, prefix?: string): string[];
+/**
+ * Read register.yaml from a dataset directory (if present).
+ * @param {string} dir - path to directory
+ * @returns {Record<string, unknown> | null}
+ * @throws {InvalidInputError} if dir is missing or empty
+ */
+export declare function readRegister(dir: string): Register | null;
+//# sourceMappingURL=concept-reader.d.ts.map

package/dist/concept-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"concept-reader.d.ts","sourceRoot":"","sources":["../src/concept-reader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AASnD,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAGhD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,aAiBvC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,kBAWlD;AAgDD;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,YAS1D;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,mBAMvC"}

package/{src/concept-reader.ts → dist/concept-reader.js}

@@ -1,5 +1,3 @@
-import type { Concept } from './models/concept.js';
-import type { RegisterJson } from './models/register.js';
 import fs from 'fs';
 import path from 'path';
 import * as yaml from 'js-yaml';
@@ -8,13 +6,7 @@ import { RelationLoader } from './models/relation-loader.js';
 import { naturalSort } from './sort.js';
 import { InvalidInputError } from './errors.js';
 import { Register } from './models/register.js';
-
-function assertDir(dir, fnName) {
-  if (typeof dir !== 'string' || dir.trim() === '') {
-    throw new InvalidInputError(`${fnName} requires a directory path`, 'non-empty string');
-  }
-}
-
+import { assertDir } from './utils/assertions.js';
 /**
  * Read all v2 glossarist concept YAML files from a directory, then
  * merge in any per-file hyperedge YAMLs from `<dir>/relations/`.
@@ -34,24 +26,21 @@ function assertDir(dir, fnName) {
  * console.log(concepts[0].localization('eng').terms[0].designation);
  */
 export function readConcepts(dir) {
-  assertDir(dir, 'readConcepts');
-  const files = fs.readdirSync(dir)
-    .filter(f => f.endsWith('.yaml') && f !== 'register.yaml')
-    .sort(naturalSort);
-
-  const concepts: Concept[] = [];
-  for (const file of files) {
-    const raw = fs.readFileSync(path.join(dir, file), 'utf8');
-    const concept = conceptParser.parse(raw, file);
-    if (concept && concept.id) {
-      concepts.push(concept);
+    assertDir(dir, 'readConcepts');
+    const files = fs.readdirSync(dir)
+        .filter(f => f.endsWith('.yaml') && f !== 'register.yaml')
+        .sort(naturalSort);
+    const concepts = [];
+    for (const file of files) {
+        const raw = fs.readFileSync(path.join(dir, file), 'utf8');
+        const concept = conceptParser.parse(raw, file);
+        if (concept && concept.id) {
+            concepts.push(concept);
+        }
     }
-  }
-
-  _mergePerFileHyperedges(dir, concepts);
-  return concepts;
+    _mergePerFileHyperedges(dir, concepts);
+    return concepts;
 }
-
 /**
  * Read a single concept file by ID from a directory, then merge in
  * any per-file hyperedge YAMLs for that concept from
@@ -67,18 +56,18 @@ export function readConcepts(dir) {
  * if (concept) console.log(concept.termid);
  */
 export function readConcept(dir, id) {
-  assertDir(dir, 'readConcept');
-  if (typeof id !== 'string' || id.trim() === '') {
-    throw new InvalidInputError('readConcept requires a concept ID', 'non-empty string');
-  }
-  const filePath = path.join(dir, `${id}.yaml`);
-  if (!fs.existsSync(filePath)) return null;
-  const raw = fs.readFileSync(filePath, 'utf8');
-  const concept = conceptParser.parse(raw, `${id}.yaml`);
-  _mergePerFileHyperedges(dir, [concept]);
-  return concept;
+    assertDir(dir, 'readConcept');
+    if (typeof id !== 'string' || id.trim() === '') {
+        throw new InvalidInputError('readConcept requires a concept ID', 'non-empty string');
+    }
+    const filePath = path.join(dir, `${id}.yaml`);
+    if (!fs.existsSync(filePath))
+        return null;
+    const raw = fs.readFileSync(filePath, 'utf8');
+    const concept = conceptParser.parse(raw, `${id}.yaml`);
+    _mergePerFileHyperedges(dir, [concept]);
+    return concept;
 }
-
 // Load `relations/` directory and merge per-file hyperedges into the
 // matching Concept.relations arrays. Concepts are matched by id.
 // Inline hyperedges from the concept YAML are preserved alongside the
@@ -89,36 +78,40 @@ export function readConcept(dir, id) {
 // type, invalid members) — surfaces corruption loudly per the
 // RelationLoader contract.
 function _mergePerFileHyperedges(dir, concepts) {
-  const relationsDir = path.join(dir, 'relations');
-  if (!fs.existsSync(relationsDir)) return;
-
-  const byComprehensive = RelationLoader.loadAll(relationsDir);
-  if (byComprehensive.size === 0) return;
-
-  for (const concept of concepts) {
-    const rels = byComprehensive.get(concept.id);
-    if (!rels || rels.length === 0) continue;
-    // Merge per-file hyperedges with any inline ones from the concept
-    // YAML. Per-file wins on identity collision — they're the newer,
-    // more authoritative source.
-    const inline = concept.relations;
-    const merged = [...inline];
-    for (const r of rels) {
-      const exists = inline.some(x => _sameHyperedge(x, r));
-      if (!exists) merged.push(r);
+    const relationsDir = path.join(dir, 'relations');
+    if (!fs.existsSync(relationsDir))
+        return;
+    const byComprehensive = RelationLoader.loadAll(relationsDir);
+    if (byComprehensive.size === 0)
+        return;
+    for (const concept of concepts) {
+        const rels = byComprehensive.get(concept.id);
+        if (!rels || rels.length === 0)
+            continue;
+        // Merge per-file hyperedges with any inline ones from the concept
+        // YAML. Per-file wins on identity collision — they're the newer,
+        // more authoritative source.
+        const inline = concept.relations;
+        const merged = [...inline];
+        for (const r of rels) {
+            const exists = inline.some(x => _sameHyperedge(x, r));
+            if (!exists)
+                merged.push(r);
+        }
+        concept.relations = merged;
     }
-    concept.relations = merged;
-  }
 }
-
 function _sameHyperedge(a, b) {
-  const aCls = a?.constructor;
-  const bCls = b?.constructor;
-  if (aCls !== bCls) return false;
-  if (typeof aCls.identityOf !== 'function') return false;
-  return aCls.identityOf(a) === bCls.identityOf(b);
+    const ax = a;
+    const bx = b;
+    const aCls = ax?.constructor;
+    const bCls = bx?.constructor;
+    if (aCls !== bCls)
+        return false;
+    if (typeof aCls?.identityOf !== 'function')
+        return false;
+    return aCls.identityOf(a) === aCls.identityOf(b);
 }
-
 /**
  * List all concept IDs in a directory, optionally filtered by prefix.
  * @param {string} dir - path to directory
@@ -130,16 +123,15 @@ function _sameHyperedge(a, b) {
  * const ids = listConceptIds('./geolexica-v2/', '3.1.'); // ['3.1.1.1', '3.1.1.2', ...]
  */
 export function listConceptIds(dir, prefix) {
-  assertDir(dir, 'listConceptIds');
-  let files = fs.readdirSync(dir).filter(f => f.endsWith('.yaml') && f !== 'register.yaml');
-  if (prefix) {
-    files = files.filter(f => f.startsWith(prefix));
-  }
-  return files
-    .map(f => f.slice(0, -'.yaml'.length))
-    .sort(naturalSort);
+    assertDir(dir, 'listConceptIds');
+    let files = fs.readdirSync(dir).filter(f => f.endsWith('.yaml') && f !== 'register.yaml');
+    if (prefix) {
+        files = files.filter(f => f.startsWith(prefix));
+    }
+    return files
+        .map(f => f.slice(0, -'.yaml'.length))
+        .sort(naturalSort);
 }
-
 /**
  * Read register.yaml from a dataset directory (if present).
  * @param {string} dir - path to directory
@@ -147,9 +139,11 @@ export function listConceptIds(dir, prefix) {
  * @throws {InvalidInputError} if dir is missing or empty
  */
 export function readRegister(dir) {
-  assertDir(dir, 'readRegister');
-  const p = path.join(dir, 'register.yaml');
-  if (!fs.existsSync(p)) return null;
-  const raw = yaml.load(fs.readFileSync(p, 'utf8'));
-  return Register.fromJSON(raw as RegisterJson);
+    assertDir(dir, 'readRegister');
+    const p = path.join(dir, 'register.yaml');
+    if (!fs.existsSync(p))
+        return null;
+    const raw = yaml.load(fs.readFileSync(p, 'utf8'));
+    return Register.fromJSON(raw);
 }
+//# sourceMappingURL=concept-reader.js.map

package/dist/concept-reader.js.map

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

package/dist/concept-serializer.d.ts

@@ -0,0 +1,9 @@
+import type { Concept } from './models/concept.js';
+export declare class ConceptSerializer {
+    toCanonicalYaml(concept: Concept): string;
+    toManagedYaml(concept: Concept, uuidFn?: () => string): string;
+    toYaml(concept: Concept, uuidFn?: () => string): string;
+    toRegisterYaml(data: unknown): string;
+}
+export declare const conceptSerializer: ConceptSerializer;
+//# sourceMappingURL=concept-serializer.d.ts.map

package/dist/concept-serializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"concept-serializer.d.ts","sourceRoot":"","sources":["../src/concept-serializer.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAanD,qBAAa,iBAAiB;IAC5B,eAAe,CAAC,OAAO,EAAE,OAAO;IAoBhC,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,MAAM;IA8CrD,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,MAAM;IAM9C,cAAc,CAAC,IAAI,EAAE,OAAO;CAG7B;AAED,eAAO,MAAM,iBAAiB,mBAA0B,CAAC"}

package/dist/concept-serializer.js

@@ -0,0 +1,87 @@
+import * as yaml from 'js-yaml';
+import { PartitiveHyperedge } from './models/partitive-hyperedge.js';
+import { GenericHyperedge } from './models/generic-hyperedge.js';
+const DUMP_OPTS = { lineWidth: -1, noRefs: true, sortKeys: false, skipInvalid: true };
+function _emitTypedRelations(concept) {
+    const partitiveRels = concept.relations.filter(r => r instanceof PartitiveHyperedge);
+    const genericRels = concept.relations.filter(r => r instanceof GenericHyperedge);
+    return {
+        partitive: partitiveRels.map(r => r.toJSON()),
+        generic: genericRels.map(r => r.toJSON()),
+    };
+}
+export class ConceptSerializer {
+    toCanonicalYaml(concept) {
+        const doc = { termid: concept.id };
+        if (concept.term)
+            doc.term = concept.term;
+        const { partitive, generic } = _emitTypedRelations(concept);
+        if (partitive.length > 0)
+            doc.partitive_relations = partitive;
+        if (generic.length > 0)
+            doc.generic_relations = generic;
+        for (const lang of concept.languages) {
+            const lc = concept.localization(lang);
+            if (lc) {
+                const lcObj = lc.toJSON();
+                delete lcObj.language_code;
+                doc[lang] = lcObj;
+            }
+        }
+        return yaml.dump(doc, DUMP_OPTS);
+    }
+    toManagedYaml(concept, uuidFn) {
+        const genId = uuidFn ?? (() => crypto.randomUUID());
+        const localizedConcepts = {};
+        const langDocs = [];
+        for (const lang of concept.languages) {
+            const lc = concept.localization(lang);
+            if (!lc)
+                continue;
+            const lcId = genId();
+            localizedConcepts[lang] = lcId;
+            const lcObj = lc.toJSON();
+            langDocs.push({ data: lcObj, id: lcId });
+        }
+        const mainDoc = {
+            data: { identifier: concept.id, localized_concepts: localizedConcepts },
+            id: genId(),
+        };
+        if (concept.domains.length > 0) {
+            mainDoc.data.domains = concept.domains.map(d => d.toJSON());
+        }
+        if (concept.relatedConcepts.length > 0) {
+            mainDoc.related = concept.relatedConcepts.map(rc => rc.toJSON());
+        }
+        const { partitive, generic } = _emitTypedRelations(concept);
+        if (partitive.length > 0)
+            mainDoc.partitive_relations = partitive;
+        if (generic.length > 0)
+            mainDoc.generic_relations = generic;
+        if (concept.sources.length > 0) {
+            mainDoc.sources = concept.sources.map(s => s.toJSON());
+        }
+        if (concept.dates.length > 0) {
+            mainDoc.dates = concept.dates.map(d => d.toJSON());
+        }
+        if (concept.status)
+            mainDoc.status = concept.status;
+        if (concept.schemaVersion)
+            mainDoc.schema_version = concept.schemaVersion;
+        const parts = [
+            '---\n' + yaml.dump(mainDoc, DUMP_OPTS),
+            ...langDocs.map(d => '---\n' + yaml.dump(d, DUMP_OPTS)),
+        ];
+        return parts.join('');
+    }
+    toYaml(concept, uuidFn) {
+        return concept.term
+            ? this.toCanonicalYaml(concept)
+            : this.toManagedYaml(concept, uuidFn);
+    }
+    toRegisterYaml(data) {
+        return yaml.dump(data, DUMP_OPTS);
+    }
+}
+export const conceptSerializer = new ConceptSerializer();
+//# sourceMappingURL=concept-serializer.js.map

package/dist/concept-serializer.js.map

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

package/dist/concept-writer.d.ts

@@ -0,0 +1,10 @@
+import type { Concept } from './models/concept.js';
+import type { Register } from './models/register.js';
+export type ConceptFormat = 'canonical' | 'managed' | 'auto';
+export declare function writeConcept(dir: string, concept: Concept, format?: ConceptFormat): void;
+export interface WriteConceptsOptions {
+    format?: ConceptFormat;
+    register?: Register | null;
+}
+export declare function writeConcepts(dir: string, concepts: Iterable<Concept>, options?: WriteConceptsOptions): void;
+//# sourceMappingURL=concept-writer.d.ts.map

package/dist/concept-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"concept-writer.d.ts","sourceRoot":"","sources":["../src/concept-writer.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAGrD,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,SAAS,GAAG,MAAM,CAAC;AAE7D,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAE,aAAsB,QAazF;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,QAAQ,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC;CAC5B;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,GAAE,oBAAyB,QAezG"}

package/dist/concept-writer.js

@@ -0,0 +1,28 @@
+import fs from 'fs';
+import path from 'path';
+import { conceptSerializer } from './concept-serializer.js';
+import { InvalidInputError } from './errors.js';
+import { assertDir } from './utils/assertions.js';
+export function writeConcept(dir, concept, format = 'auto') {
+    assertDir(dir, 'writeConcept');
+    if (!concept?.id) {
+        throw new InvalidInputError('writeConcept requires a Concept with an id', 'Concept');
+    }
+    const y = format === 'canonical'
+        ? conceptSerializer.toCanonicalYaml(concept)
+        : format === 'managed'
+            ? conceptSerializer.toManagedYaml(concept)
+            : conceptSerializer.toYaml(concept);
+    fs.writeFileSync(path.join(dir, `${concept.id}.yaml`), y, 'utf8');
+}
+export function writeConcepts(dir, concepts, options = {}) {
+    assertDir(dir, 'writeConcepts');
+    fs.mkdirSync(dir, { recursive: true });
+    for (const concept of concepts) {
+        writeConcept(dir, concept, options.format);
+    }
+    if (options.register) {
+        fs.writeFileSync(path.join(dir, 'register.yaml'), conceptSerializer.toRegisterYaml(options.register), 'utf8');
+    }
+}
+//# sourceMappingURL=concept-writer.js.map

package/dist/concept-writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"concept-writer.js","sourceRoot":"","sources":["../src/concept-writer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGhD,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAIlD,MAAM,UAAU,YAAY,CAAC,GAAW,EAAE,OAAgB,EAAE,SAAwB,MAAM;IACxF,SAAS,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;IAC/B,IAAI,CAAC,OAAO,EAAE,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,iBAAiB,CAAC,4CAA4C,EAAE,SAAS,CAAC,CAAC;IACvF,CAAC;IAED,MAAM,CAAC,GAAG,MAAM,KAAK,WAAW;QAC9B,CAAC,CAAC,iBAAiB,CAAC,eAAe,CAAC,OAAO,CAAC;QAC5C,CAAC,CAAC,MAAM,KAAK,SAAS;YACpB,CAAC,CAAC,iBAAiB,CAAC,aAAa,CAAC,OAAO,CAAC;YAC1C,CAAC,CAAC,iBAAiB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAExC,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;AACpE,CAAC;AAOD,MAAM,UAAU,aAAa,CAAC,GAAW,EAAE,QAA2B,EAAE,UAAgC,EAAE;IACxG,SAAS,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC;IAChC,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEvC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,YAAY,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7C,CAAC;IAED,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QACrB,EAAE,CAAC,aAAa,CACd,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,EAC/B,iBAAiB,CAAC,cAAc,CAAC,OAAO,CAAC,QAAQ,CAAC,EAClD,MAAM,CACP,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/dataset-asset.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Registry of dataset assets that can be bundled inside a GCR package.
+ *
+ * Mirrors the Ruby glossarist gem's GcrPackage::DATASET_ASSETS.
+ * Asset types:
+ *   - file: a single named file at the GCR root (e.g. bibliography.yaml)
+ *   - directory: a named directory with arbitrary nested files (e.g. images/)
+ *
+ * New asset types can be added by appending to DATASET_ASSETS (open/closed).
+ */
+declare const DATASET_ASSETS: readonly {
+    path: string;
+    type: string;
+}[];
+declare const FILE_ASSETS: readonly {
+    path: string;
+    type: string;
+}[];
+declare const DIRECTORY_ASSETS: readonly {
+    path: string;
+    type: string;
+}[];
+/**
+ * Find a file asset descriptor by its ZIP path.
+ * @param {string} path
+ * @returns {{ path: string, type: string } | undefined}
+ */
+declare function findFileAsset(path: string): {
+    path: string;
+    type: string;
+} | undefined;
+/**
+ * Check whether a ZIP path belongs to a directory asset.
+ * Returns the asset descriptor if so, undefined otherwise.
+ * @param {string} zipPath
+ * @returns {{ path: string, type: string } | undefined}
+ */
+declare function findDirectoryAssetPath(zipPath: string): {
+    path: string;
+    type: string;
+} | undefined;
+/**
+ * Check if a ZIP path is a dataset asset entry.
+ * @param {string} zipPath
+ * @returns {boolean}
+ */
+declare function isDatasetAssetPath(zipPath: string): boolean;
+export { DATASET_ASSETS, FILE_ASSETS, DIRECTORY_ASSETS, findFileAsset, findDirectoryAssetPath, isDatasetAssetPath, };
+//# sourceMappingURL=dataset-asset.d.ts.map

package/dist/dataset-asset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataset-asset.d.ts","sourceRoot":"","sources":["../src/dataset-asset.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,QAAA,MAAM,cAAc;;;GAMlB,CAAC;AAEH,QAAA,MAAM,WAAW;;;GAEhB,CAAC;AAEF,QAAA,MAAM,gBAAgB;;;GAErB,CAAC;AAEF;;;;GAIG;AACH,iBAAS,aAAa,CAAC,IAAI,EAAE,MAAM;;;cAElC;AAED;;;;;GAKG;AACH,iBAAS,sBAAsB,CAAC,OAAO,EAAE,MAAM;;;cAO9C;AAED;;;;GAIG;AACH,iBAAS,kBAAkB,CAAC,OAAO,EAAE,MAAM,WAE1C;AAED,OAAO,EACL,cAAc,EACd,WAAW,EACX,gBAAgB,EAChB,aAAa,EACb,sBAAsB,EACtB,kBAAkB,GACnB,CAAC"}

package/{src/dataset-asset.ts → dist/dataset-asset.js}

@@ -8,32 +8,23 @@
  *
  * New asset types can be added by appending to DATASET_ASSETS (open/closed).
  */
-
 const DATASET_ASSETS = Object.freeze([
-  { path: 'bibliography.yaml', type: 'file' },
-  { path: 'images', type: 'directory' },
-  { path: 'figures', type: 'directory' },
-  { path: 'tables', type: 'directory' },
-  { path: 'formulas', type: 'directory' },
+    { path: 'bibliography.yaml', type: 'file' },
+    { path: 'images', type: 'directory' },
+    { path: 'figures', type: 'directory' },
+    { path: 'tables', type: 'directory' },
+    { path: 'formulas', type: 'directory' },
 ]);
-
-const FILE_ASSETS = Object.freeze(
-  DATASET_ASSETS.filter((a) => a.type === 'file'),
-);
-
-const DIRECTORY_ASSETS = Object.freeze(
-  DATASET_ASSETS.filter((a) => a.type === 'directory'),
-);
-
+const FILE_ASSETS = Object.freeze(DATASET_ASSETS.filter((a) => a.type === 'file'));
+const DIRECTORY_ASSETS = Object.freeze(DATASET_ASSETS.filter((a) => a.type === 'directory'));
 /**
  * Find a file asset descriptor by its ZIP path.
  * @param {string} path
  * @returns {{ path: string, type: string } | undefined}
  */
 function findFileAsset(path) {
-  return FILE_ASSETS.find((a) => a.path === path);
+    return FILE_ASSETS.find((a) => a.path === path);
 }
-
 /**
  * Check whether a ZIP path belongs to a directory asset.
  * Returns the asset descriptor if so, undefined otherwise.
@@ -41,28 +32,20 @@ function findFileAsset(path) {
  * @returns {{ path: string, type: string } | undefined}
  */
 function findDirectoryAssetPath(zipPath) {
-  for (const asset of DIRECTORY_ASSETS) {
-    if (zipPath === asset.path || zipPath.startsWith(`${asset.path}/`)) {
-      return asset;
+    for (const asset of DIRECTORY_ASSETS) {
+        if (zipPath === asset.path || zipPath.startsWith(`${asset.path}/`)) {
+            return asset;
+        }
     }
-  }
-  return undefined;
+    return undefined;
 }
-
 /**
  * Check if a ZIP path is a dataset asset entry.
  * @param {string} zipPath
  * @returns {boolean}
  */
 function isDatasetAssetPath(zipPath) {
-  return findFileAsset(zipPath) !== undefined || findDirectoryAssetPath(zipPath) !== undefined;
+    return findFileAsset(zipPath) !== undefined || findDirectoryAssetPath(zipPath) !== undefined;
 }
-
-export {
-  DATASET_ASSETS,
-  FILE_ASSETS,
-  DIRECTORY_ASSETS,
-  findFileAsset,
-  findDirectoryAssetPath,
-  isDatasetAssetPath,
-};
+export { DATASET_ASSETS, FILE_ASSETS, DIRECTORY_ASSETS, findFileAsset, findDirectoryAssetPath, isDatasetAssetPath, };
+//# sourceMappingURL=dataset-asset.js.map

package/dist/dataset-asset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataset-asset.js","sourceRoot":"","sources":["../src/dataset-asset.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC;IACnC,EAAE,IAAI,EAAE,mBAAmB,EAAE,IAAI,EAAE,MAAM,EAAE;IAC3C,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE;IACrC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE;IACtC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE;IACrC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,WAAW,EAAE;CACxC,CAAC,CAAC;AAEH,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAC/B,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAChD,CAAC;AAEF,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,CACpC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC,CACrD,CAAC;AAEF;;;;GAIG;AACH,SAAS,aAAa,CAAC,IAAY;IACjC,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AAClD,CAAC;AAED;;;;;GAKG;AACH,SAAS,sBAAsB,CAAC,OAAe;IAC7C,KAAK,MAAM,KAAK,IAAI,gBAAgB,EAAE,CAAC;QACrC,IAAI,OAAO,KAAK,KAAK,CAAC,IAAI,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,KAAK,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;YACnE,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;GAIG;AACH,SAAS,kBAAkB,CAAC,OAAe;IACzC,OAAO,aAAa,CAAC,OAAO,CAAC,KAAK,SAAS,IAAI,sBAAsB,CAAC,OAAO,CAAC,KAAK,SAAS,CAAC;AAC/F,CAAC;AAED,OAAO,EACL,cAAc,EACd,WAAW,EACX,gBAAgB,EAChB,aAAa,EACb,sBAAsB,EACtB,kBAAkB,GACnB,CAAC"}

package/dist/diff/canonical-json.d.ts

@@ -0,0 +1,7 @@
+type JsonInput = null | undefined | string | number | boolean | JsonInput[] | {
+    [k: string]: JsonInput;
+};
+export declare function canonicalJson(value: JsonInput | unknown): string;
+export declare function deepEqualCanonical(a: JsonInput | unknown, b: JsonInput | unknown): boolean;
+export {};
+//# sourceMappingURL=canonical-json.d.ts.map

package/dist/diff/canonical-json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical-json.d.ts","sourceRoot":"","sources":["../../src/diff/canonical-json.ts"],"names":[],"mappings":"AAMA,KAAK,SAAS,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,EAAE,GAAG;IAAE,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAEzG,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,GAAG,MAAM,CAEhE;AAED,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,SAAS,GAAG,OAAO,EAAE,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,OAAO,CAE1F"}

package/dist/diff/canonical-json.js

@@ -0,0 +1,28 @@
+// Canonical JSON for equality comparison.
+//
+// Sorts object keys recursively so two semantically-equal values produce
+// identical strings regardless of insertion order. Arrays preserve order
+// (they're ordered in domain semantics). Undefined values are dropped.
+export function canonicalJson(value) {
+    return JSON.stringify(toCanonical(value));
+}
+export function deepEqualCanonical(a, b) {
+    return canonicalJson(a) === canonicalJson(b);
+}
+function toCanonical(value) {
+    if (value == null)
+        return null;
+    if (Array.isArray(value))
+        return value.map(toCanonical);
+    if (typeof value === 'object') {
+        const out = {};
+        for (const k of Object.keys(value).sort()) {
+            const v = toCanonical(value[k]);
+            if (v !== undefined)
+                out[k] = v;
+        }
+        return out;
+    }
+    return value;
+}
+//# sourceMappingURL=canonical-json.js.map

package/dist/diff/canonical-json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical-json.js","sourceRoot":"","sources":["../../src/diff/canonical-json.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAC1C,EAAE;AACF,yEAAyE;AACzE,yEAAyE;AACzE,uEAAuE;AAIvE,MAAM,UAAU,aAAa,CAAC,KAA0B;IACtD,OAAO,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,KAAkB,CAAC,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,CAAsB,EAAE,CAAsB;IAC/E,OAAO,aAAa,CAAC,CAAC,CAAC,KAAK,aAAa,CAAC,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED,SAAS,WAAW,CAAC,KAAgB;IACnC,IAAI,KAAK,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC;IAC/B,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IACxD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,GAAG,GAA4B,EAAE,CAAC;QACxC,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;YAC1C,MAAM,CAAC,GAAG,WAAW,CAAE,KAAmC,CAAC,CAAC,CAAc,CAAC,CAAC;YAC5E,IAAI,CAAC,KAAK,SAAS;gBAAE,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QAClC,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}