lens-content-processor 0.43.0 → 0.45.0

package/dist/skill-tree.js

@@ -1,92 +1,97 @@
 // src/skill-tree.ts — assembles the skill-tree structure from parsed content.
 //
-// The processor emits relationships (LO ↔ module ↔ course); presentation
-// decisions live in the frontend. Cards reference each other by LO id and
-// reference domains by slug.
-import { parseFrontmatter } from "./parser/frontmatter.js";
+// The processor emits relationships (LO ↔ topic ↔ domain, LO ↔ module ↔
+// course); presentation decisions live in the frontend. Cards reference each
+// other by LO id, topics by slug, and domains by slug.
+import { DOMAIN_METADATA_FILE, fileStem, } from "./parser/domain.js";
 import { findFileWithExtension } from "./parser/wikilink.js";
+/**
+ * Frontmatter tag that lets a course or module show up in the skill tree's
+ * "Included in" links. A module inherits it from any course that has it
+ * (shown inside that course); a module tagged on its own shows standalone.
+ * Untagged modules and courses are left out of `taughtBy` entirely.
+ */
+export const SKILL_TREE_VISIBLE_TAG = "visible-in-skilltree";
+/** Kebab-case: apostrophes vanish ("You don't" → "you-dont"), every other
+ * non-alphanumeric run becomes one hyphen. */
 export function slugifyTitle(title) {
     return title
         .toLowerCase()
+        .replace(/['’]/g, "")
         .replace(/[^a-z0-9]+/g, "-")
         .replace(/^-+|-+$/g, "");
 }
-function fileStem(path) {
-    const base = path.split("/").pop() ?? path;
-    return base.replace(/\.md$/, "");
-}
-/** Parse a Domains/ placeholder file: `domain-number:` frontmatter is the
- * only content that matters; the title is the filename. */
-export function parseDomainFile(content, file) {
+export function buildSkillTree(input) {
     const errors = [];
-    const frontmatterResult = parseFrontmatter(content, file);
-    if (frontmatterResult.error) {
-        errors.push(frontmatterResult.error);
-        return { domain: null, errors };
-    }
-    const rawNumber = frontmatterResult.frontmatter["domain-number"];
-    if (typeof rawNumber !== "number" || !Number.isInteger(rawNumber)) {
-        errors.push({
-            file,
-            line: 2,
-            message: `Domain file must have an integer 'domain-number' field, got: ${JSON.stringify(rawNumber)}`,
-            suggestion: "Add domain-number: <n> to the frontmatter",
-            severity: "error",
-        });
-        return { domain: null, errors };
-    }
-    const rawStart = frontmatterResult.frontmatter["start-stage"];
-    let startStage;
-    if (rawStart !== undefined && rawStart !== null) {
-        if (typeof rawStart === "string" &&
-            ["beginner", "intermediate", "advanced"].includes(rawStart)) {
-            startStage = rawStart;
-        }
-        else {
+    // --- Domains ---
+    const numberToDir = new Map();
+    const slugToDir = new Map();
+    const dirToDomain = new Map();
+    const folders = [...input.domainFolders].sort(([a], [b]) => a.localeCompare(b));
+    for (const [dir, folder] of folders) {
+        const slug = slugifyTitle(folder.title);
+        const sameNumber = numberToDir.get(folder.number);
+        const sameSlug = slugToDir.get(slug);
+        if (sameNumber || sameSlug) {
             errors.push({
-                file,
-                line: 2,
-                message: `Field 'start-stage' must be beginner, intermediate or advanced, got: ${JSON.stringify(rawStart)}`,
-                suggestion: "Use start-stage: beginner | intermediate | advanced",
+                file: folder.declaredBy,
+                line: 1,
+                message: sameNumber
+                    ? `Duplicate domain number ${folder.number}: '${dir}' and '${sameNumber}'`
+                    : `Duplicate domain '${slug}': '${dir}' and '${sameSlug}' have the same title`,
+                suggestion: "Give each domain folder a unique number and title",
                 severity: "error",
             });
+            continue;
         }
+        numberToDir.set(folder.number, dir);
+        slugToDir.set(slug, dir);
+        dirToDomain.set(dir, {
+            slug,
+            title: folder.title,
+            number: folder.number,
+            ...(folder.metadata?.startStage
+                ? { startStage: folder.metadata.startStage }
+                : {}),
+            ...(folder.metadata?.description
+                ? { description: folder.metadata.description }
+                : {}),
+        });
     }
-    return {
-        domain: {
-            title: fileStem(file),
-            number: rawNumber,
-            ...(startStage ? { startStage } : {}),
-        },
-        errors,
-    };
-}
-export function buildSkillTree(input) {
-    const errors = [];
-    // --- Domains ---
-    const numberToPath = new Map();
-    const pathToDomain = new Map();
-    for (const [path, parsed] of input.domainFiles) {
-        const existing = numberToPath.get(parsed.number);
+    const domains = [...dirToDomain.values()].sort((a, b) => a.number - b.number);
+    // --- Topics ---
+    const pathToTopic = new Map();
+    const slugToTopicPath = new Map();
+    const topicEntries = [...input.topicFiles].sort(([a], [b]) => a.localeCompare(b));
+    for (const [path, parsed] of topicEntries) {
+        const domain = dirToDomain.get(parsed.domainDir);
+        if (!domain)
+            continue; // the folder itself was rejected above
+        const slug = slugifyTitle(parsed.title);
+        const existing = slugToTopicPath.get(slug);
         if (existing) {
             errors.push({
                 file: path,
-                line: 2,
-                message: `Duplicate domain-number ${parsed.number} — already used by ${existing}`,
-                suggestion: "Give each domain file a unique domain-number",
+                line: 1,
+                message: `Duplicate topic slug '${slug}': '${path}' and '${existing}' have the same title`,
+                suggestion: "Topic titles must be unique across all domains — rename one of the files",
                 severity: "error",
             });
             continue;
         }
-        numberToPath.set(parsed.number, path);
-        pathToDomain.set(path, {
-            slug: slugifyTitle(parsed.title),
+        slugToTopicPath.set(slug, path);
+        pathToTopic.set(path, {
+            id: parsed.id,
+            slug,
             title: parsed.title,
-            number: parsed.number,
-            ...(parsed.startStage ? { startStage: parsed.startStage } : {}),
+            domain: domain.slug,
+            ...(parsed.order !== undefined ? { order: parsed.order } : {}),
+            ...(parsed.description ? { description: parsed.description } : {}),
         });
     }
-    const domains = [...pathToDomain.values()].sort((a, b) => a.number - b.number);
+    const domainNumber = new Map(domains.map((d) => [d.slug, d.number]));
+    const topics = [...pathToTopic.values()].sort((a, b) => domainNumber.get(a.domain) - domainNumber.get(b.domain) ||
+        compareTopicOrder(a, b));
     // --- Cards ---
     // First pass: which LO paths become cards (needed to validate requires
     // edges — an edge must point at another card, not at an excluded or
@@ -94,38 +99,56 @@ export function buildSkillTree(input) {
     const cardPaths = new Map();
     const untriaged = [];
     for (const [path, lo] of input.learningOutcomes) {
-        if (lo.domains === undefined) {
+        if (lo.topics === undefined) {
             // Not yet triaged. Reported via skillTree.untriaged (a TODO list for
             // editors), not as a per-file warning — most LOs were written before
             // the skill tree existed and blanket warnings would drown /validate.
             untriaged.push(path);
             continue;
         }
-        if (lo.domains === "none")
+        if (lo.topics === "none")
             continue;
         cardPaths.set(path, lo);
     }
     untriaged.sort();
     const cards = [];
     for (const [path, lo] of cardPaths) {
-        const domainRefs = lo.domains;
+        const topicRefs = lo.topics;
+        const topicSlugs = [];
         const domainSlugs = [];
-        for (const domainRef of domainRefs) {
-            const domainPath = findFileWithExtension(domainRef.resolvedPath, input.files);
-            const domain = domainPath ? pathToDomain.get(domainPath) : undefined;
-            if (!domain) {
+        for (const ref of topicRefs) {
+            const topicPath = findFileWithExtension(ref.resolvedPath, input.files);
+            const topic = topicPath ? pathToTopic.get(topicPath) : undefined;
+            if (!topic) {
+                const reason = topicPath && fileStem(topicPath) === fileStem(DOMAIN_METADATA_FILE)
+                    ? "points at a domain's metadata file, not a topic"
+                    : topicPath
+                        ? "does not resolve to a topic file inside a numbered domain folder"
+                        : "does not resolve to a file";
                 errors.push({
                     file: path,
                     line: 2,
-                    message: `Domain link does not resolve to a domain file: ${domainRef.resolvedPath}`,
-                    suggestion: "Check the file name under Domains/",
+                    message: `'topic' link ${reason}: ${ref.resolvedPath}`,
+                    suggestion: 'Point at a topic file: topic: "[[../Domains and Topics/<N> <Domain title>/<Topic title>]]"',
                     severity: "error",
                 });
                 continue;
             }
-            domainSlugs.push(domain.slug);
+            if (topicSlugs.includes(topic.slug)) {
+                errors.push({
+                    file: path,
+                    line: 2,
+                    message: `Duplicate 'topic' entry: ${ref.source}`,
+                    suggestion: "List each topic once",
+                    severity: "error",
+                });
+                continue;
+            }
+            topicSlugs.push(topic.slug);
+            if (!domainSlugs.includes(topic.domain))
+                domainSlugs.push(topic.domain);
         }
-        if (domainSlugs.length === 0)
+        if (topicSlugs.length === 0)
             continue;
         if (lo.stage === undefined)
             continue; // already reported by the parser
@@ -149,14 +172,22 @@ export function buildSkillTree(input) {
             requires.push(target.id);
         }
         const taughtBy = [];
-        for (const modulePath of input.moduleLoRefs.get(path) ?? []) {
+        for (const [modulePath, submodules] of input.moduleLoRefs.get(path) ?? []) {
             const info = input.moduleInfo.get(modulePath);
             if (!info)
                 continue;
+            // moduleCourses already holds only tagged courses.
+            const courses = input.moduleCourses.get(info.slug) ?? [];
+            if (courses.length === 0 && !info.visible)
+                continue;
             taughtBy.push({
                 moduleSlug: info.slug,
                 moduleTitle: info.title,
-                courses: input.moduleCourses.get(info.slug) ?? [],
+                courses,
+                submodules: [...submodules].map(([slug, title]) => ({
+                    slug: `${info.slug}/${slug}`,
+                    title,
+                })),
             });
         }
         taughtBy.sort((a, b) => a.moduleSlug.localeCompare(b.moduleSlug));
@@ -164,6 +195,8 @@ export function buildSkillTree(input) {
             id: lo.id,
             title: fileStem(path),
             domains: domainSlugs,
+            topic: topicSlugs[0],
+            topics: topicSlugs,
             stage: lo.stage,
             requires,
             ...(lo.outcomeStatement ? { outcome: lo.outcomeStatement } : {}),
@@ -172,6 +205,11 @@ export function buildSkillTree(input) {
         });
     }
     cards.sort((a, b) => a.title.localeCompare(b.title));
-    return { skillTree: { domains, cards, untriaged }, errors };
+    return { skillTree: { domains, topics, cards, untriaged }, errors };
+}
+/** `order` first (lower wins, absent last), then title. */
+export function compareTopicOrder(a, b) {
+    return ((a.order ?? Number.POSITIVE_INFINITY) -
+        (b.order ?? Number.POSITIVE_INFINITY) || a.title.localeCompare(b.title));
 }
 //# sourceMappingURL=skill-tree.js.map

package/dist/skill-tree.js.map

@@ -1 +1 @@
-{"version":3,"file":"skill-tree.js","sourceRoot":"","sources":["../src/skill-tree.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,EAAE;AACF,yEAAyE;AACzE,0EAA0E;AAC1E,6BAA6B;AAI7B,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAuD7D,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,OAAO,KAAK;SACT,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;AAC7B,CAAC;AAED,SAAS,QAAQ,CAAC,IAAY;IAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC;IAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;AACnC,CAAC;AAQD;2DAC2D;AAC3D,MAAM,UAAU,eAAe,CAC7B,OAAe,EACf,IAAY;IAEZ,MAAM,MAAM,GAAmB,EAAE,CAAC;IAClC,MAAM,iBAAiB,GAAG,gBAAgB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC1D,IAAI,iBAAiB,CAAC,KAAK,EAAE,CAAC;QAC5B,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;QACrC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAClC,CAAC;IACD,MAAM,SAAS,GAAG,iBAAiB,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC;IACjE,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC;QAClE,MAAM,CAAC,IAAI,CAAC;YACV,IAAI;YACJ,IAAI,EAAE,CAAC;YACP,OAAO,EAAE,gEAAgE,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE;YACpG,UAAU,EAAE,2CAA2C;YACvD,QAAQ,EAAE,OAAO;SAClB,CAAC,CAAC;QACH,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAClC,CAAC;IACD,MAAM,QAAQ,GAAG,iBAAiB,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC;IAC9D,IAAI,UAA8B,CAAC;IACnC,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QAChD,IACE,OAAO,QAAQ,KAAK,QAAQ;YAC5B,CAAC,UAAU,EAAE,cAAc,EAAE,UAAU,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAC3D,CAAC;YACD,UAAU,GAAG,QAAQ,CAAC;QACxB,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI;gBACJ,IAAI,EAAE,CAAC;gBACP,OAAO,EAAE,wEAAwE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE;gBAC3G,UAAU,EAAE,qDAAqD;gBACjE,QAAQ,EAAE,OAAO;aAClB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,OAAO;QACL,MAAM,EAAE;YACN,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC;YACrB,MAAM,EAAE,SAAS;YACjB,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACtC;QACD,MAAM;KACP,CAAC;AACJ,CAAC;AAiBD,MAAM,UAAU,cAAc,CAAC,KAAqB;IAIlD,MAAM,MAAM,GAAmB,EAAE,CAAC;IAElC,kBAAkB;IAClB,MAAM,YAAY,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC/C,MAAM,YAAY,GAAG,IAAI,GAAG,EAA2B,CAAC;IACxD,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;QAC/C,MAAM,QAAQ,GAAG,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACjD,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,IAAI;gBACV,IAAI,EAAE,CAAC;gBACP,OAAO,EAAE,2BAA2B,MAAM,CAAC,MAAM,sBAAsB,QAAQ,EAAE;gBACjF,UAAU,EAAE,8CAA8C;gBAC1D,QAAQ,EAAE,OAAO;aAClB,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QACD,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QACtC,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE;YACrB,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC;YAChC,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAChE,CAAC,CAAC;IACL,CAAC;IACD,MAAM,OAAO,GAAG,CAAC,GAAG,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAC7C,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAC9B,CAAC;IAEF,gBAAgB;IAChB,uEAAuE;IACvE,oEAAoE;IACpE,iBAAiB;IACjB,MAAM,SAAS,GAAG,IAAI,GAAG,EAAiC,CAAC;IAC3D,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,KAAK,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,CAAC,gBAAgB,EAAE,CAAC;QAChD,IAAI,EAAE,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YAC7B,qEAAqE;YACrE,qEAAqE;YACrE,qEAAqE;YACrE,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACrB,SAAS;QACX,CAAC;QACD,IAAI,EAAE,CAAC,OAAO,KAAK,MAAM;YAAE,SAAS;QACpC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAC1B,CAAC;IACD,SAAS,CAAC,IAAI,EAAE,CAAC;IAEjB,MAAM,KAAK,GAAoB,EAAE,CAAC;IAClC,KAAK,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,SAAS,EAAE,CAAC;QACnC,MAAM,UAAU,GAAG,EAAE,CAAC,OAGrB,CAAC;QACF,MAAM,WAAW,GAAa,EAAE,CAAC;QACjC,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACnC,MAAM,UAAU,GAAG,qBAAqB,CACtC,SAAS,CAAC,YAAY,EACtB,KAAK,CAAC,KAAK,CACZ,CAAC;YACF,MAAM,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YACrE,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI,EAAE,IAAI;oBACV,IAAI,EAAE,CAAC;oBACP,OAAO,EAAE,kDAAkD,SAAS,CAAC,YAAY,EAAE;oBACnF,UAAU,EAAE,oCAAoC;oBAChD,QAAQ,EAAE,OAAO;iBAClB,CAAC,CAAC;gBACH,SAAS;YACX,CAAC;YACD,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAChC,CAAC;QACD,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QACvC,IAAI,EAAE,CAAC,KAAK,KAAK,SAAS;YAAE,SAAS,CAAC,iCAAiC;QAEvE,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,KAAK,MAAM,GAAG,IAAI,EAAE,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;YACpC,MAAM,UAAU,GAAG,qBAAqB,CAAC,GAAG,CAAC,YAAY,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;YACxE,MAAM,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAClE,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,MAAM,GAAG,UAAU;oBACvB,CAAC,CAAC,8DAA8D;oBAChE,CAAC,CAAC,6CAA6C,CAAC;gBAClD,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI,EAAE,IAAI;oBACV,IAAI,EAAE,CAAC;oBACP,OAAO,EAAE,mBAAmB,MAAM,KAAK,GAAG,CAAC,YAAY,EAAE;oBACzD,UAAU,EACR,sEAAsE;oBACxE,QAAQ,EAAE,OAAO;iBAClB,CAAC,CAAC;gBACH,SAAS;YACX,CAAC;YACD,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC3B,CAAC;QAED,MAAM,QAAQ,GAAqB,EAAE,CAAC;QACtC,KAAK,MAAM,UAAU,IAAI,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;YAC5D,MAAM,IAAI,GAAG,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;YAC9C,IAAI,CAAC,IAAI;gBAAE,SAAS;YACpB,QAAQ,CAAC,IAAI,CAAC;gBACZ,UAAU,EAAE,IAAI,CAAC,IAAI;gBACrB,WAAW,EAAE,IAAI,CAAC,KAAK;gBACvB,OAAO,EAAE,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;aAClD,CAAC,CAAC;QACL,CAAC;QACD,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;QAElE,KAAK,CAAC,IAAI,CAAC;YACT,EAAE,EAAE,EAAE,CAAC,EAAE;YACT,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC;YACrB,OAAO,EAAE,WAAW;YACpB,KAAK,EAAE,EAAE,CAAC,KAAK;YACf,QAAQ;YACR,GAAG,CAAC,EAAE,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAChE,GAAG,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAChD,QAAQ;SACT,CAAC,CAAC;IACL,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;IAErD,OAAO,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,MAAM,EAAE,CAAC;AAC9D,CAAC"}
+{"version":3,"file":"skill-tree.js","sourceRoot":"","sources":["../src/skill-tree.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,EAAE;AACF,wEAAwE;AACxE,6EAA6E;AAC7E,uDAAuD;AAIvD,OAAO,EACL,oBAAoB,EACpB,QAAQ,GAGT,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAgC7D;;;;;GAKG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,sBAAsB,CAAC;AAyD7D;8CAC8C;AAC9C,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,OAAO,KAAK;SACT,WAAW,EAAE;SACb,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;SACpB,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;AAC7B,CAAC;AA+BD,MAAM,UAAU,cAAc,CAAC,KAAqB;IAIlD,MAAM,MAAM,GAAmB,EAAE,CAAC;IAElC,kBAAkB;IAClB,MAAM,WAAW,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC9C,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC5C,MAAM,WAAW,GAAG,IAAI,GAAG,EAA2B,CAAC;IACvD,MAAM,OAAO,GAAG,CAAC,GAAG,KAAK,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CACzD,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CACnB,CAAC;IACF,KAAK,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACpC,MAAM,IAAI,GAAG,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACxC,MAAM,UAAU,GAAG,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAClD,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,UAAU,IAAI,QAAQ,EAAE,CAAC;YAC3B,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,MAAM,CAAC,UAAU;gBACvB,IAAI,EAAE,CAAC;gBACP,OAAO,EAAE,UAAU;oBACjB,CAAC,CAAC,2BAA2B,MAAM,CAAC,MAAM,MAAM,GAAG,UAAU,UAAU,GAAG;oBAC1E,CAAC,CAAC,qBAAqB,IAAI,OAAO,GAAG,UAAU,QAAQ,uBAAuB;gBAChF,UAAU,EAAE,mDAAmD;gBAC/D,QAAQ,EAAE,OAAO;aAClB,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QACD,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QACpC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QACzB,WAAW,CAAC,GAAG,CAAC,GAAG,EAAE;YACnB,IAAI;YACJ,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,UAAU;gBAC7B,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE;gBAC5C,CAAC,CAAC,EAAE,CAAC;YACP,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,WAAW;gBAC9B,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE;gBAC9C,CAAC,CAAC,EAAE,CAAC;SACR,CAAC,CAAC;IACL,CAAC;IACD,MAAM,OAAO,GAAG,CAAC,GAAG,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC;IAE9E,iBAAiB;IACjB,MAAM,WAAW,GAAG,IAAI,GAAG,EAA0B,CAAC;IACtD,MAAM,eAAe,GAAG,IAAI,GAAG,EAAkB,CAAC;IAClD,MAAM,YAAY,GAAG,CAAC,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAC3D,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CACnB,CAAC;IACF,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,YAAY,EAAE,CAAC;QAC1C,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACjD,IAAI,CAAC,MAAM;YAAE,SAAS,CAAC,uCAAuC;QAC9D,MAAM,IAAI,GAAG,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACxC,MAAM,QAAQ,GAAG,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC3C,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,IAAI;gBACV,IAAI,EAAE,CAAC;gBACP,OAAO,EAAE,yBAAyB,IAAI,OAAO,IAAI,UAAU,QAAQ,uBAAuB;gBAC1F,UAAU,EACR,0EAA0E;gBAC5E,QAAQ,EAAE,OAAO;aAClB,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QACD,eAAe,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAChC,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE;YACpB,EAAE,EAAE,MAAM,CAAC,EAAE;YACb,IAAI;YACJ,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,MAAM,EAAE,MAAM,CAAC,IAAI;YACnB,GAAG,CAAC,MAAM,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9D,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACnE,CAAC,CAAC;IACL,CAAC;IACD,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACrE,MAAM,MAAM,GAAG,CAAC,GAAG,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAC3C,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACP,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAE,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAE;QACzD,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAAC,CAC1B,CAAC;IAEF,gBAAgB;IAChB,uEAAuE;IACvE,oEAAoE;IACpE,iBAAiB;IACjB,MAAM,SAAS,GAAG,IAAI,GAAG,EAAiC,CAAC;IAC3D,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,KAAK,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,CAAC,gBAAgB,EAAE,CAAC;QAChD,IAAI,EAAE,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC5B,qEAAqE;YACrE,qEAAqE;YACrE,qEAAqE;YACrE,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACrB,SAAS;QACX,CAAC;QACD,IAAI,EAAE,CAAC,MAAM,KAAK,MAAM;YAAE,SAAS;QACnC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAC1B,CAAC;IACD,SAAS,CAAC,IAAI,EAAE,CAAC;IAEjB,MAAM,KAAK,GAAoB,EAAE,CAAC;IAClC,KAAK,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,SAAS,EAAE,CAAC;QACnC,MAAM,SAAS,GAAG,EAAE,CAAC,MAGpB,CAAC;QACF,MAAM,UAAU,GAAa,EAAE,CAAC;QAChC,MAAM,WAAW,GAAa,EAAE,CAAC;QACjC,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;YAC5B,MAAM,SAAS,GAAG,qBAAqB,CAAC,GAAG,CAAC,YAAY,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;YACvE,MAAM,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YACjE,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,MAAM,MAAM,GACV,SAAS,IAAI,QAAQ,CAAC,SAAS,CAAC,KAAK,QAAQ,CAAC,oBAAoB,CAAC;oBACjE,CAAC,CAAC,iDAAiD;oBACnD,CAAC,CAAC,SAAS;wBACT,CAAC,CAAC,kEAAkE;wBACpE,CAAC,CAAC,4BAA4B,CAAC;gBACrC,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI,EAAE,IAAI;oBACV,IAAI,EAAE,CAAC;oBACP,OAAO,EAAE,gBAAgB,MAAM,KAAK,GAAG,CAAC,YAAY,EAAE;oBACtD,UAAU,EACR,4FAA4F;oBAC9F,QAAQ,EAAE,OAAO;iBAClB,CAAC,CAAC;gBACH,SAAS;YACX,CAAC;YACD,IAAI,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;gBACpC,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI,EAAE,IAAI;oBACV,IAAI,EAAE,CAAC;oBACP,OAAO,EAAE,4BAA4B,GAAG,CAAC,MAAM,EAAE;oBACjD,UAAU,EAAE,sBAAsB;oBAClC,QAAQ,EAAE,OAAO;iBAClB,CAAC,CAAC;gBACH,SAAS;YACX,CAAC;YACD,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC5B,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC;gBAAE,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC1E,CAAC;QACD,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QACtC,IAAI,EAAE,CAAC,KAAK,KAAK,SAAS;YAAE,SAAS,CAAC,iCAAiC;QAEvE,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,KAAK,MAAM,GAAG,IAAI,EAAE,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;YACpC,MAAM,UAAU,GAAG,qBAAqB,CAAC,GAAG,CAAC,YAAY,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;YACxE,MAAM,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAClE,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,MAAM,GAAG,UAAU;oBACvB,CAAC,CAAC,8DAA8D;oBAChE,CAAC,CAAC,6CAA6C,CAAC;gBAClD,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI,EAAE,IAAI;oBACV,IAAI,EAAE,CAAC;oBACP,OAAO,EAAE,mBAAmB,MAAM,KAAK,GAAG,CAAC,YAAY,EAAE;oBACzD,UAAU,EACR,sEAAsE;oBACxE,QAAQ,EAAE,OAAO;iBAClB,CAAC,CAAC;gBACH,SAAS;YACX,CAAC;YACD,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC3B,CAAC;QAED,MAAM,QAAQ,GAAqB,EAAE,CAAC;QACtC,KAAK,MAAM,CAAC,UAAU,EAAE,UAAU,CAAC,IAAI,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;YAC1E,MAAM,IAAI,GAAG,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;YAC9C,IAAI,CAAC,IAAI;gBAAE,SAAS;YACpB,mDAAmD;YACnD,MAAM,OAAO,GAAG,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACzD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO;gBAAE,SAAS;YACpD,QAAQ,CAAC,IAAI,CAAC;gBACZ,UAAU,EAAE,IAAI,CAAC,IAAI;gBACrB,WAAW,EAAE,IAAI,CAAC,KAAK;gBACvB,OAAO;gBACP,UAAU,EAAE,CAAC,GAAG,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;oBAClD,IAAI,EAAE,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,EAAE;oBAC5B,KAAK;iBACN,CAAC,CAAC;aACJ,CAAC,CAAC;QACL,CAAC;QACD,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;QAElE,KAAK,CAAC,IAAI,CAAC;YACT,EAAE,EAAE,EAAE,CAAC,EAAE;YACT,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC;YACrB,OAAO,EAAE,WAAW;YACpB,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC;YACpB,MAAM,EAAE,UAAU;YAClB,KAAK,EAAE,EAAE,CAAC,KAAK;YACf,QAAQ;YACR,GAAG,CAAC,EAAE,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAChE,GAAG,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAChD,QAAQ;SACT,CAAC,CAAC;IACL,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;IAErD,OAAO,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,MAAM,EAAE,CAAC;AACtE,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,iBAAiB,CAC/B,CAAoC,EACpC,CAAoC;IAEpC,OAAO,CACL,CAAC,CAAC,CAAC,KAAK,IAAI,MAAM,CAAC,iBAAiB,CAAC;QACnC,CAAC,CAAC,CAAC,KAAK,IAAI,MAAM,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAC1E,CAAC;AACJ,CAAC"}

package/dist/validator/article-imports.d.ts

@@ -0,0 +1,68 @@
+import type { ContentError } from "../index.js";
+export interface VideoImportSyntax {
+    kind: "video";
+    /** Wikilink target, e.g. "../video_transcripts/name" */
+    target: string;
+    from?: string;
+    to?: string;
+}
+export interface WidgetEmbedSyntax {
+    kind: "widget";
+    /** Wikilink target, e.g. "../widgets/name" */
+    target: string;
+    /** `|height=480px` modifier: overrides the widget file's height here. */
+    height?: string;
+}
+export type ArticleImportSyntax = VideoImportSyntax | WidgetEmbedSyntax;
+export type ArticleImportParse = {
+    kind: "import";
+    import: ArticleImportSyntax;
+} | {
+    kind: "invalid";
+    kindName: "video" | "widget";
+    reason: string;
+    suggestion: string;
+} | {
+    kind: "none";
+};
+/**
+ * Classify a single line of article body text as a ::video import.
+ * - "import": a valid own-line ::video import
+ * - "invalid": an attempted import with broken syntax
+ * - "none": not a video import at all
+ */
+export declare function parseVideoImportLine(line: string): ArticleImportParse;
+/** True when a wikilink target names a file directly under a widgets/ folder. */
+export declare function isWidgetEmbedTarget(target: string): boolean;
+/**
+ * Classify a single line of article body text as a widget embed.
+ * - "import": a valid own-line ![[../widgets/name]] embed
+ * - "invalid": a widget embed with broken syntax or buried in prose
+ * - "none": not a widget embed (other ![[...]] embeds included)
+ */
+export declare function parseWidgetEmbedLine(line: string): ArticleImportParse;
+/** Classify a line as any of the inline article imports. */
+export declare function parseArticleImportLine(line: string): ArticleImportParse;
+export interface ScannedArticleLine {
+    line: string;
+    /** False inside fenced code and on fence/container marker lines. */
+    prose: boolean;
+    /** Innermost open `:::hide` / `:::collapse` container, if any. */
+    hiddenIn?: string;
+}
+/**
+ * Walk an article body line by line, tracking fenced code and container
+ * directives, so every consumer of import lines skips the same regions.
+ */
+export declare function scanArticleLines(body: string): ScannedArticleLine[];
+/**
+ * Parse-time validation of inline imports in an article body.
+ * Resolution errors (missing file, bad range) are reported later by the
+ * flattener, which has the file map.
+ */
+export declare function validateArticleImports(body: string, file: string, bodyStartLine: number): ContentError[];
+/**
+ * Lens text segments do not resolve inline article imports — catch attempts
+ * there with a pointer to the supported mechanisms.
+ */
+export declare function validateNoArticleImportsInLensText(content: string, file: string, line: number): ContentError[];

package/dist/validator/article-imports.js

@@ -0,0 +1,265 @@
+import { parseTimestamp } from "../bundler/video.js";
+import { isValidHeight } from "../parser/widget.js";
+// ::video{attr}[[path|alias]] or ::video[[path|alias]]{attr}, anchored to a
+// full (trimmed) line. Alias is accepted for wikilink-tooling compatibility
+// but unused — the display title comes from the transcript frontmatter.
+const VIDEO_IMPORT_LINE_RE = /^::video(?:\{([^}]*)\})?\[\[([^\]|]+)(?:\|[^\]]+)?\]\](?:\{([^}]*)\})?$/;
+// Anything that looks like an attempted ::video import (used to flag
+// malformed/misplaced usages without false-positives on prose that merely
+// mentions "::video").
+const VIDEO_IMPORT_CANDIDATE_RE = /::video[[{]/;
+// ![[path]] or ![[path|modifier]], anchored to a full (trimmed) line.
+const WIDGET_EMBED_LINE_RE = /^!\[\[([^\]|]+)(?:\|([^\]]*))?\]\]$/;
+// Every ![[...]] on a line; the target decides whether it is a widget embed.
+const WIDGET_EMBED_CANDIDATE_RE = /!\[\[([^\]|]+)(?:\|[^\]]*)?\]\]/g;
+// A file directly under a widgets/ folder, written relative to the article
+// (`../widgets/name`) or to the vault root (`widgets/name`), no fragment.
+const WIDGET_TARGET_RE = /^(?:\.\.?\/)*widgets\/[^/#|]+$/;
+// Inline code is not prose: an import mentioned in backticks is neither an
+// import nor a mistake.
+const INLINE_CODE_RE = /`[^`]*`/g;
+// CommonMark permits up to three leading spaces before a fenced code block.
+const CODE_FENCE = /^ {0,3}(?:```|~~~)/;
+const CONTAINER_OPEN = /^(:{3,})([\w-]+)/;
+const CONTAINER_CLOSE = /^(:{3,})\s*(?:\{[^}]*\})?\s*$/;
+/** Parse `from="..." to="..."` attribute text. */
+function parseAttrs(attr) {
+    if (attr === undefined || attr.trim() === "")
+        return {};
+    const tokens = [...attr.matchAll(/([\w-]+)\s*=\s*"([^"]*)"/g)];
+    const consumed = tokens.map((m) => m[0]).join(" ");
+    if (consumed.replace(/\s+/g, " ").trim() !== attr.replace(/\s+/g, " ").trim()) {
+        return {
+            reason: `invalid attributes '{${attr}}'`,
+            suggestion: 'Use key="value" attributes: from and/or to',
+        };
+    }
+    const result = {};
+    for (const token of tokens) {
+        const key = token[1];
+        const value = token[2];
+        if (key !== "from" && key !== "to") {
+            return {
+                reason: `unrecognized attribute '${key}'`,
+                suggestion: "Only from and to attributes are supported",
+            };
+        }
+        if (result[key] !== undefined) {
+            return {
+                reason: `duplicate attribute '${key}'`,
+                suggestion: `Keep only one ${key} attribute`,
+            };
+        }
+        if (parseTimestamp(value) === null) {
+            return {
+                reason: `invalid timestamp in '${key}="${value}"'`,
+                suggestion: "Use M:SS (e.g. 1:30) or H:MM:SS (e.g. 1:30:00)",
+            };
+        }
+        result[key] = value;
+    }
+    return result;
+}
+/**
+ * Classify a single line of article body text as a ::video import.
+ * - "import": a valid own-line ::video import
+ * - "invalid": an attempted import with broken syntax
+ * - "none": not a video import at all
+ */
+export function parseVideoImportLine(line) {
+    const trimmed = line.trim();
+    if (!VIDEO_IMPORT_CANDIDATE_RE.test(trimmed.replace(INLINE_CODE_RE, ""))) {
+        return { kind: "none" };
+    }
+    const invalid = (reason, suggestion) => ({
+        kind: "invalid",
+        kindName: "video",
+        reason,
+        suggestion,
+    });
+    const match = trimmed.match(VIDEO_IMPORT_LINE_RE);
+    if (!match) {
+        if (trimmed.startsWith("::video")) {
+            return invalid("malformed ::video import", 'Use ::video[[../video_transcripts/name]] with optional {from="1:30" to="4:10"}, alone on its own line');
+        }
+        // ::video appears mid-line — an import buried in prose.
+        return invalid("::video import must be alone on its own line", "Move the ::video[[...]] import to its own line");
+    }
+    const preAttr = match[1];
+    const target = match[2].trim();
+    const postAttr = match[3];
+    if (preAttr !== undefined && postAttr !== undefined) {
+        return invalid("attributes given both before and after the wikilink", "Use a single {from=... to=...} block after the ]]");
+    }
+    const attrs = parseAttrs(preAttr ?? postAttr);
+    if ("reason" in attrs)
+        return invalid(attrs.reason, attrs.suggestion);
+    if (target === "") {
+        return invalid("empty wikilink target", "Reference a transcript: ::video[[../video_transcripts/name]]");
+    }
+    return { kind: "import", import: { kind: "video", target, ...attrs } };
+}
+/** True when a wikilink target names a file directly under a widgets/ folder. */
+export function isWidgetEmbedTarget(target) {
+    return WIDGET_TARGET_RE.test(target.trim());
+}
+/** True when a line mentions a widget embed anywhere outside inline code. */
+function hasWidgetEmbedCandidate(line) {
+    return [
+        ...line.replace(INLINE_CODE_RE, "").matchAll(WIDGET_EMBED_CANDIDATE_RE),
+    ].some((m) => isWidgetEmbedTarget(m[1]));
+}
+/**
+ * Classify a single line of article body text as a widget embed.
+ * - "import": a valid own-line ![[../widgets/name]] embed
+ * - "invalid": a widget embed with broken syntax or buried in prose
+ * - "none": not a widget embed (other ![[...]] embeds included)
+ */
+export function parseWidgetEmbedLine(line) {
+    const trimmed = line.trim();
+    if (!hasWidgetEmbedCandidate(trimmed))
+        return { kind: "none" };
+    const invalid = (reason, suggestion) => ({
+        kind: "invalid",
+        kindName: "widget",
+        reason,
+        suggestion,
+    });
+    const match = trimmed.match(WIDGET_EMBED_LINE_RE);
+    if (!match || !isWidgetEmbedTarget(match[1])) {
+        return invalid("widget embed must be alone on its own line", "Move the ![[../widgets/name]] embed to its own line");
+    }
+    const target = match[1].trim();
+    const modifier = match[2]?.trim();
+    if (modifier === undefined || modifier === "") {
+        return { kind: "import", import: { kind: "widget", target } };
+    }
+    const heightMatch = modifier.match(/^height\s*=\s*(\S+)$/);
+    if (!heightMatch || !isValidHeight(heightMatch[1])) {
+        return invalid(`invalid modifier '|${modifier}'`, 'The only modifier is height, e.g. ![[../widgets/name|height=480px]] ("auto" or a CSS length)');
+    }
+    return {
+        kind: "import",
+        import: { kind: "widget", target, height: heightMatch[1] },
+    };
+}
+/** Classify a line as any of the inline article imports. */
+export function parseArticleImportLine(line) {
+    const video = parseVideoImportLine(line);
+    return video.kind === "none" ? parseWidgetEmbedLine(line) : video;
+}
+/**
+ * Walk an article body line by line, tracking fenced code and container
+ * directives, so every consumer of import lines skips the same regions.
+ */
+export function scanArticleLines(body) {
+    const out = [];
+    let inCodeBlock = false;
+    // Names of open container directives, innermost last.
+    const containerStack = [];
+    for (const line of body.split("\n")) {
+        if (CODE_FENCE.test(line)) {
+            inCodeBlock = !inCodeBlock;
+            out.push({ line, prose: false });
+            continue;
+        }
+        if (inCodeBlock) {
+            out.push({ line, prose: false });
+            continue;
+        }
+        const openMatch = line.match(CONTAINER_OPEN);
+        if (openMatch) {
+            containerStack.push(openMatch[2]);
+            out.push({ line, prose: false });
+            continue;
+        }
+        if (CONTAINER_CLOSE.test(line)) {
+            containerStack.pop();
+            out.push({ line, prose: false });
+            continue;
+        }
+        const hiddenIn = containerStack.find((name) => name === "hide" || name === "collapse");
+        out.push(hiddenIn ? { line, prose: true, hiddenIn } : { line, prose: true });
+    }
+    return out;
+}
+const IMPORT_LABEL = {
+    video: { code: "video-import", label: "::video import" },
+    widget: { code: "widget-embed", label: "widget embed" },
+};
+/**
+ * Parse-time validation of inline imports in an article body.
+ * Resolution errors (missing file, bad range) are reported later by the
+ * flattener, which has the file map.
+ */
+export function validateArticleImports(body, file, bodyStartLine) {
+    const errors = [];
+    const scanned = scanArticleLines(body);
+    for (let i = 0; i < scanned.length; i++) {
+        const { line, prose, hiddenIn } = scanned[i];
+        if (!prose)
+            continue;
+        const absLine = bodyStartLine + i;
+        const parsed = parseArticleImportLine(line);
+        if (parsed.kind === "none")
+            continue;
+        if (parsed.kind === "invalid") {
+            const { code, label } = IMPORT_LABEL[parsed.kindName];
+            const notOwnLine = parsed.reason.includes("own line");
+            errors.push({
+                file,
+                line: absLine,
+                code: `article.${code}-${notOwnLine ? "not-own-line" : "invalid"}`,
+                message: `Invalid ${label}: ${parsed.reason}`,
+                suggestion: parsed.suggestion,
+                severity: "error",
+            });
+            continue;
+        }
+        // Imports inside hide/collapse would silently vanish from rendered output
+        // (the collapsed string strips them), so they are rejected outright.
+        if (hiddenIn) {
+            const { code, label } = IMPORT_LABEL[parsed.import.kind];
+            errors.push({
+                file,
+                line: absLine,
+                code: `article.${code}-in-hide`,
+                message: `${label} inside a ':::${hiddenIn}' container`,
+                suggestion: `Move the import outside the hidden block — hidden text is collapsed and the ${parsed.import.kind} would never render`,
+                severity: "error",
+            });
+        }
+    }
+    return errors;
+}
+/**
+ * Lens text segments do not resolve inline article imports — catch attempts
+ * there with a pointer to the supported mechanisms.
+ */
+export function validateNoArticleImportsInLensText(content, file, line) {
+    const errors = [];
+    const lines = content.split("\n");
+    for (let i = 0; i < lines.length; i++) {
+        const prose = lines[i].replace(INLINE_CODE_RE, "");
+        if (VIDEO_IMPORT_CANDIDATE_RE.test(prose)) {
+            errors.push({
+                file,
+                line: line + i,
+                message: "::video imports are only supported in article bodies",
+                suggestion: "Use a '#### Video' segment in the lens, or move the import into the article file",
+                severity: "error",
+            });
+        }
+        else if (hasWidgetEmbedCandidate(prose)) {
+            errors.push({
+                file,
+                line: line + i,
+                message: "Widget embeds (![[../widgets/...]]) are only supported in article bodies",
+                suggestion: "Use a '#### Widget' segment in the lens, or move the embed into the article file",
+                severity: "error",
+            });
+        }
+    }
+    return errors;
+}
+//# sourceMappingURL=article-imports.js.map