akm-cli 0.9.16 → 0.9.17-alpha.10

package/dist/indexer/links/declared-links.js

@@ -0,0 +1,90 @@
+// This Source Code Form is subject to the terms of the Mozilla Public
+// License, v. 2.0. If a copy of the MPL was not distributed with this
+// file, You can obtain one at https://mozilla.org/MPL/2.0/.
+import { stashDirFor } from "../../core/asset/asset-placement.js";
+import { isBundleSlug, parseBundleRef } from "../../core/asset/asset-ref.js";
+/** Channel order is the order links are stored and shown in. */
+const CHANNELS = [
+    ["xref", (doc) => doc.xrefs],
+    ["superseded_by", (doc) => doc.supersededBy],
+    ["contradicted_by", (doc) => doc.contradictedBy],
+    ["belief_peer", (doc) => doc.currentBeliefRefs],
+    ["derived_from", (doc) => doc.derivedFrom],
+    ["cites", (doc) => doc.sources],
+    ["links_to", (doc) => doc.links],
+    ["uses", (doc) => doc.uses],
+];
+/** The links an indexed document declares, in channel then authored order; one per (kind, target). */
+export function declaredLinks(doc, owner) {
+    const links = [];
+    const seen = new Set();
+    for (const [kind, read] of CHANNELS) {
+        for (const raw of stringValues(read(doc))) {
+            const target = linkTarget(raw, owner.conceptId);
+            if (!target)
+                continue;
+            const bundle = target.bundle ?? owner.bundleId;
+            if (bundle === owner.bundleId && target.conceptId === owner.conceptId)
+                continue;
+            const key = `${kind}\0${bundle}\0${target.conceptId}`;
+            if (seen.has(key))
+                continue;
+            seen.add(key);
+            links.push({ kind, raw, ...target });
+        }
+    }
+    return links;
+}
+function stringValues(value) {
+    if (typeof value === "string")
+        return [value];
+    return Array.isArray(value) ? value.filter((item) => typeof item === "string") : [];
+}
+/**
+ * The target a token names, or `undefined` when the token is not an asset ref
+ * (a session id, a URL, prose, a template placeholder). Retired spellings
+ * convert in memory: `<type>:<name>` (`memory:x`), `wiki:<wiki>/<path>` (0.8
+ * wikis, now knowledge under `wikis/`), a `.md` suffix, and a `#fragment`.
+ * Inside a wiki page, `raw/…` and `pages/…` are relative to the wiki root.
+ */
+function linkTarget(raw, ownerConceptId) {
+    const token = raw.trim();
+    if (!token || /[\s<*]/.test(token) || token.includes("$(") || token.includes("${"))
+        return;
+    let bundle;
+    let body = token;
+    const boundary = token.indexOf("//");
+    if (boundary >= 0) {
+        bundle = token.slice(0, boundary);
+        body = token.slice(boundary + 2);
+        if (!isBundleSlug(bundle))
+            return;
+    }
+    const conceptId = legacyConceptId(body.split("#", 1)[0] ?? "", ownerConceptId);
+    if (conceptId === undefined || conceptId.length <= 1 || conceptId.includes("//"))
+        return;
+    try {
+        return { ...(bundle ? { bundle } : {}), conceptId: parseBundleRef(conceptId).conceptId };
+    }
+    catch {
+        return;
+    }
+}
+function legacyConceptId(body, ownerConceptId) {
+    const stripped = body.replace(/\.md$/i, "");
+    const colon = stripped.indexOf(":");
+    if (colon >= 0) {
+        const type = stripped.slice(0, colon);
+        const name = stripped.slice(colon + 1);
+        if (!name || name.includes(":"))
+            return;
+        if (type === "wiki")
+            return `knowledge/wikis/${name}`;
+        const stashDir = stashDirFor(type);
+        return stashDir === undefined ? undefined : `${stashDir}/${name}`;
+    }
+    const wikiRoot = /^((?:[^/]+\/)*?wikis\/[^/]+\/)/.exec(ownerConceptId)?.[1];
+    if (wikiRoot && /^(raw|pages)\//.test(stripped))
+        return `${wikiRoot}${stripped}`;
+    return stripped;
+}