@origintrail-official/dkg-okf 10.0.2

package/dist/export.d.ts

@@ -0,0 +1,21 @@
+/**
+ * The clean inverse of the importer (ADR 0005): reconstruct a conformant OKF
+ * bundle from imported Knowledge Assets. Designed so that
+ *
+ *   import(bundle) → exportBundle(...) → import(...)
+ *
+ * reproduces an *equivalent graph* (same concepts, frontmatter triples, untyped
+ * edges and citations). It is graph-faithful, not byte-faithful: free-form prose
+ * is not recoverable from triples, so bodies are regenerated structurally (a
+ * `# Related` section of links + a `# Citations` section). Section headings from
+ * the original body are presentational and are not reconstructed — round-trip
+ * equivalence is asserted over the semantic (non-`hasSection`) quad set.
+ *
+ * This module is pure: it consumes a `BundleImport` and returns `BundleFile[]`.
+ * The `dkg okf export` command feeds it quads fetched from a Context Graph via
+ * SPARQL; the same function powers the offline round-trip test.
+ */
+import type { BundleFile, BundleImport, OkfMappingOptions } from './types.js';
+/** Serialise an imported bundle back into a conformant OKF `BundleFile[]`. */
+export declare function exportBundle(imported: BundleImport, opts?: OkfMappingOptions): BundleFile[];
+//# sourceMappingURL=export.d.ts.map

package/dist/export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../src/export.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAmBH,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAkB,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAuL9F,8EAA8E;AAC9E,wBAAgB,YAAY,CAAC,QAAQ,EAAE,YAAY,EAAE,IAAI,GAAE,iBAAsB,GAAG,UAAU,EAAE,CAK/F"}

package/dist/export.js

@@ -0,0 +1,210 @@
+/**
+ * The clean inverse of the importer (ADR 0005): reconstruct a conformant OKF
+ * bundle from imported Knowledge Assets. Designed so that
+ *
+ *   import(bundle) → exportBundle(...) → import(...)
+ *
+ * reproduces an *equivalent graph* (same concepts, frontmatter triples, untyped
+ * edges and citations). It is graph-faithful, not byte-faithful: free-form prose
+ * is not recoverable from triples, so bodies are regenerated structurally (a
+ * `# Related` section of links + a `# Citations` section). Section headings from
+ * the original body are presentational and are not reconstructed — round-trip
+ * equivalence is asserted over the semantic (non-`hasSection`) quad set.
+ *
+ * This module is pure: it consumes a `BundleImport` and returns `BundleFile[]`.
+ * The `dkg okf export` command feeds it quads fetched from a Context Graph via
+ * SPARQL; the same function powers the offline round-trip test.
+ */
+import { dump as dumpYaml } from 'js-yaml';
+import { RDF_TYPE, SCHEMA_NS, SCHEMA_NAME, SCHEMA_DESCRIPTION, SCHEMA_KEYWORDS, SCHEMA_MENTIONS, SCHEMA_HAS_PART, SCHEMA_DATE_MODIFIED, SCHEMA_URL, SCHEMA_CITATION, XSD_INTEGER, XSD_DECIMAL, XSD_BOOLEAN, DEFAULT_IRI_BASE, } from './constants.js';
+const LITERAL_RE = /^("(?:\\.|[^"\\])*")(?:\^\^<[^>]*>|@[A-Za-z-]+)?$/;
+const TYPED_LITERAL_RE = /^("(?:\\.|[^"\\])*")\^\^<([^>]*)>$/;
+/** Lexical value of a literal term, or `null` if the term is an IRI / blank node. */
+function literalValue(term) {
+    if (!term.startsWith('"'))
+        return null;
+    const m = term.match(LITERAL_RE);
+    if (!m)
+        return null;
+    return JSON.parse(m[1]);
+}
+/**
+ * Recover the native JS value of a known typed scalar literal so producer-defined
+ * numeric/boolean keys survive the round-trip. Import maps `count: 3` →
+ * `"3"^^xsd:integer`; without this, export would emit YAML string `"3"`, which
+ * re-imports as a plain string literal (datatype lost). Returns `null` for
+ * unknown datatypes / plain literals so callers fall back to lexical handling.
+ */
+function typedScalarValue(term) {
+    const m = term.match(TYPED_LITERAL_RE);
+    if (!m)
+        return null;
+    const lexical = JSON.parse(m[1]);
+    switch (m[2]) {
+        case XSD_INTEGER: {
+            const n = Number(lexical);
+            return Number.isInteger(n) ? n : null;
+        }
+        case XSD_DECIMAL: {
+            const n = Number(lexical);
+            return Number.isFinite(n) ? n : null;
+        }
+        case XSD_BOOLEAN:
+            return lexical === 'true' ? true : lexical === 'false' ? false : null;
+        default:
+            return null;
+    }
+}
+/** Map an rdf:type object IRI back to a writable `type` value. */
+function typeValue(object) {
+    return object.startsWith(SCHEMA_NS) ? object.slice(SCHEMA_NS.length) : object;
+}
+function conceptIdFromIri(iri, iriBase) {
+    return iri.startsWith(iriBase) ? iri.slice(iriBase.length) : null;
+}
+const KNOWN_PREDICATES = new Set([
+    RDF_TYPE,
+    SCHEMA_NAME,
+    SCHEMA_DESCRIPTION,
+    SCHEMA_KEYWORDS,
+    SCHEMA_MENTIONS,
+    SCHEMA_HAS_PART,
+    SCHEMA_DATE_MODIFIED,
+    SCHEMA_URL,
+    SCHEMA_CITATION,
+]);
+function reconstructConcept(c, iriBase) {
+    const frontmatter = {};
+    const tags = [];
+    const edges = [];
+    const citations = [];
+    const extras = {};
+    for (const q of c.quads) {
+        if (q.subject !== c.iri)
+            continue; // skip section nodes (skolemized genid subjects)
+        switch (q.predicate) {
+            case RDF_TYPE:
+                frontmatter.type = typeValue(q.object);
+                break;
+            case SCHEMA_NAME:
+                frontmatter.title = literalValue(q.object) ?? q.object;
+                break;
+            case SCHEMA_DESCRIPTION:
+                frontmatter.description = literalValue(q.object) ?? q.object;
+                break;
+            case SCHEMA_URL:
+                frontmatter.resource = q.object;
+                break;
+            case SCHEMA_DATE_MODIFIED:
+                frontmatter.timestamp = literalValue(q.object) ?? q.object;
+                break;
+            case SCHEMA_KEYWORDS: {
+                const v = literalValue(q.object);
+                if (v !== null)
+                    tags.push(v);
+                break;
+            }
+            case SCHEMA_MENTIONS:
+            case SCHEMA_HAS_PART: {
+                // Both are cross-concept edges → reconstruct as body links. OKF links are
+                // untyped (SPEC §5.3), so a typed relation (e.g. hasPart) deliberately
+                // exports as a plain link; the DKG-side typing is not OKF-expressible.
+                const id = conceptIdFromIri(q.object, iriBase);
+                if (id)
+                    edges.push(id);
+                break;
+            }
+            case SCHEMA_CITATION:
+                citations.push(literalValue(q.object) ?? q.object);
+                break;
+            default: {
+                if (q.predicate.startsWith(SCHEMA_NS) && !KNOWN_PREDICATES.has(q.predicate)) {
+                    const key = q.predicate.slice(SCHEMA_NS.length);
+                    // Preserve known typed scalars (integer/decimal/boolean) as native
+                    // values so the datatype survives re-import; else fall back to lexical.
+                    const scalar = typedScalarValue(q.object);
+                    const v = scalar !== null ? scalar : (literalValue(q.object) ?? q.object);
+                    if (key in extras) {
+                        const cur = extras[key];
+                        extras[key] = Array.isArray(cur) ? [...cur, v] : [cur, v];
+                    }
+                    else {
+                        extras[key] = v;
+                    }
+                }
+            }
+        }
+    }
+    if (tags.length > 0)
+        frontmatter.tags = tags;
+    Object.assign(frontmatter, extras);
+    // Stable key order: required/recommended first, then producer extras.
+    const order = ['type', 'resource', 'title', 'description', 'tags', 'timestamp'];
+    const ordered = {};
+    for (const k of order)
+        if (k in frontmatter)
+            ordered[k] = frontmatter[k];
+    for (const k of Object.keys(frontmatter))
+        if (!(k in ordered))
+            ordered[k] = frontmatter[k];
+    const yaml = dumpYaml(ordered, { sortKeys: false, lineWidth: -1 }).trimEnd();
+    const bodyParts = [];
+    const uniqueEdges = [...new Set(edges)].sort();
+    if (uniqueEdges.length > 0) {
+        bodyParts.push('# Related', '');
+        for (const id of uniqueEdges)
+            bodyParts.push(`* [${id}](/${id}.md)`);
+        bodyParts.push('');
+    }
+    if (citations.length > 0) {
+        bodyParts.push('# Citations', '');
+        citations.forEach((url, i) => bodyParts.push(`[${i + 1}] [${url}](${url})`));
+        bodyParts.push('');
+    }
+    return {
+        path: `${c.conceptId}.md`,
+        content: `---\n${yaml}\n---\n\n${bodyParts.join('\n')}`,
+    };
+}
+/** Regenerate a directory `index.md` listing immediate child concepts/subdirs (SPEC §6). */
+function regenerateIndexes(conceptIds) {
+    const childrenByDir = new Map();
+    const add = (dir, entry) => {
+        if (!childrenByDir.has(dir))
+            childrenByDir.set(dir, new Set());
+        childrenByDir.get(dir).add(entry);
+    };
+    for (const id of conceptIds) {
+        const parts = id.split('/');
+        for (let i = 0; i < parts.length; i++) {
+            const dir = parts.slice(0, i).join('/');
+            const isLeaf = i === parts.length - 1;
+            add(dir, isLeaf ? `concept:${parts[i]}.md` : `dir:${parts[i]}`);
+        }
+    }
+    const files = [];
+    for (const [dir, entries] of [...childrenByDir.entries()].sort()) {
+        const lines = ['# Index', ''];
+        for (const e of [...entries].sort()) {
+            if (e.startsWith('concept:')) {
+                const name = e.slice('concept:'.length);
+                lines.push(`* [${name.replace(/\.md$/, '')}](${name})`);
+            }
+            else {
+                const name = e.slice('dir:'.length);
+                lines.push(`* [${name}](${name}/index.md)`);
+            }
+        }
+        lines.push('');
+        files.push({ path: dir ? `${dir}/index.md` : 'index.md', content: lines.join('\n') });
+    }
+    return files;
+}
+/** Serialise an imported bundle back into a conformant OKF `BundleFile[]`. */
+export function exportBundle(imported, opts = {}) {
+    const iriBase = opts.iriBase ?? DEFAULT_IRI_BASE;
+    const concepts = imported.concepts.map((c) => reconstructConcept(c, iriBase));
+    const indexes = regenerateIndexes(imported.concepts.map((c) => c.conceptId));
+    return [...concepts, ...indexes].sort((a, b) => (a.path < b.path ? -1 : a.path > b.path ? 1 : 0));
+}
+//# sourceMappingURL=export.js.map

package/dist/export.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * `@origintrail-official/dkg-okf` — deterministic Google Open Knowledge Format
+ * (OKF) → DKG Knowledge Asset mapper.
+ *
+ * Turns a portable OKF bundle (Markdown + YAML frontmatter + untyped cross-links)
+ * into owned, verifiable RDF Knowledge Assets, reconstructing the bundle's
+ * cross-concept link graph. Pure, no LLM, no network: same bundle ⇒ identical
+ * triples and IRIs. The `dkg okf` CLI command is a thin wrapper over this.
+ *
+ * See `CONTEXT.md` for the language/relationships/flagged-ambiguities and
+ * `docs/adr/0005-okf-rdf-mapping.md` for the locked OKF→RDF mapping.
+ */
+export type { Quad, OkfDocument, OkfLink, OkfCitation, OkfMappingOptions, TypeRelation, ConceptMapping, OkfWarning, BundleImport, BundleFile, ConformanceReport, } from './types.js';
+export * from './constants.js';
+export { RESERVED_FILENAMES, isValidSegment, basename, isReservedFile, isConceptFile, pathToConceptId, conceptIdToIri, conceptIdToKaName, resolveLinkTarget, } from './paths.js';
+export { parseDocument, OkfDocumentError } from './document.js';
+export { frontmatterQuads, parseBody, mapConcept } from './mapping.js';
+export { importBundle } from './bundle.js';
+export { exportBundle } from './export.js';
+export { validateBundle } from './validation.js';
+export { quadsToNQuads } from './nquads.js';
+export { loadBundleDir, loadBundleDirWithReport } from './loader.js';
+export { isSafeIri, literalTerm, typedLiteralTerm } from './utils.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,YAAY,EACV,IAAI,EACJ,WAAW,EACX,OAAO,EACP,WAAW,EACX,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACd,UAAU,EACV,YAAY,EACZ,UAAU,EACV,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAEpB,cAAc,gBAAgB,CAAC;AAE/B,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,QAAQ,EACR,cAAc,EACd,aAAa,EACb,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,23 @@
+/**
+ * `@origintrail-official/dkg-okf` — deterministic Google Open Knowledge Format
+ * (OKF) → DKG Knowledge Asset mapper.
+ *
+ * Turns a portable OKF bundle (Markdown + YAML frontmatter + untyped cross-links)
+ * into owned, verifiable RDF Knowledge Assets, reconstructing the bundle's
+ * cross-concept link graph. Pure, no LLM, no network: same bundle ⇒ identical
+ * triples and IRIs. The `dkg okf` CLI command is a thin wrapper over this.
+ *
+ * See `CONTEXT.md` for the language/relationships/flagged-ambiguities and
+ * `docs/adr/0005-okf-rdf-mapping.md` for the locked OKF→RDF mapping.
+ */
+export * from './constants.js';
+export { RESERVED_FILENAMES, isValidSegment, basename, isReservedFile, isConceptFile, pathToConceptId, conceptIdToIri, conceptIdToKaName, resolveLinkTarget, } from './paths.js';
+export { parseDocument, OkfDocumentError } from './document.js';
+export { frontmatterQuads, parseBody, mapConcept } from './mapping.js';
+export { importBundle } from './bundle.js';
+export { exportBundle } from './export.js';
+export { validateBundle } from './validation.js';
+export { quadsToNQuads } from './nquads.js';
+export { loadBundleDir, loadBundleDirWithReport } from './loader.js';
+export { isSafeIri, literalTerm, typedLiteralTerm } from './utils.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAgBH,cAAc,gBAAgB,CAAC;AAE/B,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,QAAQ,EACR,cAAc,EACd,aAAa,EACb,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC"}

package/dist/loader.d.ts

@@ -0,0 +1,20 @@
+/**
+ * The package's only filesystem surface: read an OKF bundle directory into the
+ * in-memory `BundleFile[]` the pure mapper consumes. Kept separate so the mapper
+ * itself stays I/O-free and unit-testable in isolation.
+ */
+import type { BundleFile } from './types.js';
+/**
+ * Recursively read all `.md` files under `dir` as bundle-relative POSIX paths.
+ *
+ * Symbolic links are NOT followed (`lstat`, not `stat`): a bundle could ship a
+ * `secret.md -> ~/.dkg/auth.token` symlink, and following it would slurp a local
+ * file into the graph and (with `--share`) gossip it. Symlinked entries are
+ * skipped and collected in `skippedSymlinks` so callers can surface them.
+ */
+export declare function loadBundleDir(dir: string): BundleFile[];
+export declare function loadBundleDirWithReport(dir: string): {
+    files: BundleFile[];
+    skippedSymlinks: string[];
+};
+//# sourceMappingURL=loader.d.ts.map

package/dist/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,EAAE,CAEvD;AAED,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG;IACpD,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B,CAqBA"}

package/dist/loader.js

@@ -0,0 +1,42 @@
+/**
+ * The package's only filesystem surface: read an OKF bundle directory into the
+ * in-memory `BundleFile[]` the pure mapper consumes. Kept separate so the mapper
+ * itself stays I/O-free and unit-testable in isolation.
+ */
+import { readdirSync, readFileSync, lstatSync } from 'node:fs';
+import { join, relative, sep } from 'node:path';
+/**
+ * Recursively read all `.md` files under `dir` as bundle-relative POSIX paths.
+ *
+ * Symbolic links are NOT followed (`lstat`, not `stat`): a bundle could ship a
+ * `secret.md -> ~/.dkg/auth.token` symlink, and following it would slurp a local
+ * file into the graph and (with `--share`) gossip it. Symlinked entries are
+ * skipped and collected in `skippedSymlinks` so callers can surface them.
+ */
+export function loadBundleDir(dir) {
+    return loadBundleDirWithReport(dir).files;
+}
+export function loadBundleDirWithReport(dir) {
+    const out = [];
+    const skippedSymlinks = [];
+    const walk = (current) => {
+        for (const entry of readdirSync(current).sort()) {
+            const full = join(current, entry);
+            const st = lstatSync(full);
+            if (st.isSymbolicLink()) {
+                skippedSymlinks.push(relative(dir, full).split(sep).join('/'));
+                continue;
+            }
+            if (st.isDirectory()) {
+                walk(full);
+            }
+            else if (st.isFile() && entry.endsWith('.md')) {
+                const rel = relative(dir, full).split(sep).join('/');
+                out.push({ path: rel, content: readFileSync(full, 'utf8') });
+            }
+        }
+    };
+    walk(dir);
+    return { files: out, skippedSymlinks };
+}
+//# sourceMappingURL=loader.js.map

package/dist/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAGhD;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,OAAO,uBAAuB,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,GAAW;IAIjD,MAAM,GAAG,GAAiB,EAAE,CAAC;IAC7B,MAAM,eAAe,GAAa,EAAE,CAAC;IACrC,MAAM,IAAI,GAAG,CAAC,OAAe,EAAQ,EAAE;QACrC,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;YAChD,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YAClC,MAAM,EAAE,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;YAC3B,IAAI,EAAE,CAAC,cAAc,EAAE,EAAE,CAAC;gBACxB,eAAe,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;gBAC/D,SAAS;YACX,CAAC;YACD,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;gBACrB,IAAI,CAAC,IAAI,CAAC,CAAC;YACb,CAAC;iBAAM,IAAI,EAAE,CAAC,MAAM,EAAE,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBAChD,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACrD,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;YAC/D,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IACF,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,eAAe,EAAE,CAAC;AACzC,CAAC"}

package/dist/mapping.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Deterministic OKF concept → RDF mapping (no LLM, no network).
+ *
+ * One OKF concept document maps to one Knowledge Asset subject IRI plus a set
+ * of content + linkage quads. The mapping reuses the node Markdown extractor's
+ * predicate vocabulary (so an OKF import and a native Markdown import converge),
+ * with the OKF-specific deltas recorded in `docs/adr/0005-okf-rdf-mapping.md`:
+ *
+ *   - body links are real Markdown links `[text](path)` (OKF §5), NOT the
+ *     extractor's `[[wikilinks]]`, so we resolve them with a real Markdown AST
+ *     (`mdast-util-from-markdown`) — which is also what lets us honour the
+ *     CommonMark rule that a link inside an inline code span is literal text;
+ *   - OKF concept titles live in frontmatter, so body headings (including `#`
+ *     H1s like `# Schema`) are genuine sections → `dkg:hasSection`;
+ *   - `timestamp` is OKF's last-modified time → `schema:dateModified`.
+ */
+import type { OkfDocument, OkfMappingOptions, ConceptMapping, Quad, OkfCitation } from './types.js';
+/** Map the YAML frontmatter to quads (SPEC §4.1; see the locked table in ADR 0005). */
+export declare function frontmatterQuads(iri: string, frontmatter: Record<string, unknown>): Quad[];
+interface ParsedBody {
+    headings: string[];
+    /** Real Markdown links found outside the Citations section. */
+    bodyLinks: string[];
+    /** `[label](target)` patterns found inside inline code spans (outside Citations). */
+    codeSpanHrefs: string[];
+    /** Citations gathered from the `# Citations` section (both styles). */
+    citations: OkfCitation[];
+}
+/** Parse a concept body with a real Markdown AST. */
+export declare function parseBody(body: string): ParsedBody;
+/**
+ * Map a single concept to its Knowledge Asset quads + structured link/citation
+ * diagnostics. `conceptExists` decides whether a resolved link target is in the
+ * bundle (a candidate that is not present is a broken link — warned, never fatal).
+ */
+export declare function mapConcept(doc: OkfDocument, iri: string, conceptExists: (conceptId: string) => boolean, opts?: OkfMappingOptions): ConceptMapping;
+export {};
+//# sourceMappingURL=mapping.d.ts.map

package/dist/mapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapping.d.ts","sourceRoot":"","sources":["../src/mapping.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAiCH,OAAO,KAAK,EACV,WAAW,EACX,iBAAiB,EACjB,cAAc,EACd,IAAI,EAEJ,WAAW,EACZ,MAAM,YAAY,CAAC;AAqCpB,uFAAuF;AACvF,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,EAAE,CAmD1F;AAED,UAAU,UAAU;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,+DAA+D;IAC/D,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,qFAAqF;IACrF,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,uEAAuE;IACvE,SAAS,EAAE,WAAW,EAAE,CAAC;CAC1B;AAiBD,qDAAqD;AACrD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAmClD;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,GAAG,EAAE,WAAW,EAChB,GAAG,EAAE,MAAM,EACX,aAAa,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,EAC7C,IAAI,GAAE,iBAAsB,GAC3B,cAAc,CAmFhB"}