@lapis-notes/lapis-plugin-docs 0.0.0-stage → 0.1.0

package/dist/model/graph.js

@@ -0,0 +1,169 @@
+import {} from "./types";
+import { renderDocsNoteMarkdown } from "./markdown";
+const WIKILINK_PATTERN = /\[\[([^\]|]+?)(?:\|([^\]]+?))?\]\]/g;
+const TAG_PATTERN = /(^|[\s([{])#([A-Za-z0-9][A-Za-z0-9_-]*(?:\/[A-Za-z0-9][A-Za-z0-9_-]*)*)\b/g;
+function normalizeLookup(value) {
+    return value.trim().replace(/\s+/g, " ").toLowerCase();
+}
+function compactText(value) {
+    return value.replace(/\s+/g, " ").trim();
+}
+function wikiLinkTargetNote(value) {
+    return compactText(value).split("#", 1)[0].trim();
+}
+function excerptAround(value, index) {
+    const compact = compactText(value);
+    if (!compact)
+        return "";
+    const start = Math.max(0, index - 70);
+    const excerpt = compact.slice(start, start + 180).trim();
+    return `${start > 0 ? "..." : ""}${excerpt}`;
+}
+export function extractDocsWikiLinks(note) {
+    const content = renderDocsNoteMarkdown(note);
+    return [...content.matchAll(WIKILINK_PATTERN)].map((match) => ({
+        sourceNoteId: note.id,
+        raw: match[0],
+        target: compactText(match[1] ?? ""),
+        ...(match[2] ? { label: compactText(match[2]) } : {}),
+        index: match.index ?? 0,
+    }));
+}
+export function extractDocsTags(value) {
+    return Array.from(new Set([...value.matchAll(TAG_PATTERN)]
+        .map((match) => match[2].trim())
+        .filter(Boolean))).sort((left, right) => left.localeCompare(right));
+}
+export function normalizeDocsTag(tag) {
+    return tag
+        .trim()
+        .replace(/^#+/, "")
+        .replace(/^\/+|\/+$/g, "");
+}
+export function docsTagMatchesFolder(tag, folder) {
+    const normalizedTag = normalizeDocsTag(tag).toLowerCase();
+    const normalizedFolder = normalizeDocsTag(folder).toLowerCase();
+    if (!normalizedTag || !normalizedFolder)
+        return false;
+    return (normalizedTag === normalizedFolder ||
+        normalizedTag.startsWith(`${normalizedFolder}/`));
+}
+/** Note, card, and inline body tags used for folder membership and filtering. */
+export function docsNoteTagValues(note) {
+    const cardTags = Array.isArray(note.cards) ? note.cards.flatMap((card) => card.tags) : [];
+    const inlineTags = Array.isArray(note.blocks) && typeof note.body === "string"
+        ? extractDocsTags(renderDocsNoteMarkdown(note))
+        : [];
+    return [...note.tags, ...cardTags, ...inlineTags];
+}
+export function docsNoteMatchesTagFolder(note, folder) {
+    return docsNoteTagValues(note).some((tag) => docsTagMatchesFolder(tag, folder));
+}
+function tagHierarchy(tag) {
+    const parts = normalizeDocsTag(tag)
+        .split("/")
+        .map((part) => part.trim())
+        .filter(Boolean);
+    return parts.map((_, index) => parts.slice(0, index + 1).join("/"));
+}
+function addLookup(lookup, key, noteId) {
+    const normalized = normalizeLookup(key);
+    if (!normalized)
+        return;
+    lookup.set(normalized, [...(lookup.get(normalized) ?? []), noteId]);
+}
+function noteLookup(notes) {
+    const lookup = new Map();
+    for (const note of notes) {
+        addLookup(lookup, note.title, note.id);
+        for (const alias of note.aliases)
+            addLookup(lookup, alias, note.id);
+    }
+    return lookup;
+}
+export function resolveDocsNoteId(notes, target) {
+    const targetNote = wikiLinkTargetNote(target ?? "");
+    if (!targetNote)
+        return null;
+    if (notes.some((note) => note.id === targetNote))
+        return targetNote;
+    const lookup = noteLookup(notes);
+    const matches = Array.from(new Set(lookup.get(normalizeLookup(targetNote)) ?? []));
+    return matches.length === 1 ? matches[0] : null;
+}
+function resolveLink(link, notesById, lookup) {
+    const targetNote = wikiLinkTargetNote(link.target);
+    if (notesById.has(targetNote))
+        return { ...link, resolvedNoteId: targetNote };
+    const matches = Array.from(new Set(lookup.get(normalizeLookup(targetNote)) ?? []));
+    if (matches.length === 1)
+        return { ...link, resolvedNoteId: matches[0] };
+    if (matches.length > 1)
+        return { ...link, ambiguousNoteIds: matches };
+    return link;
+}
+function buildTagSummaries(notes) {
+    const byTag = new Map();
+    const ensure = (tag) => {
+        const normalized = tag.trim();
+        if (!normalized)
+            return null;
+        const existing = byTag.get(normalized) ?? {
+            notes: new Set(),
+            cards: new Set(),
+        };
+        byTag.set(normalized, existing);
+        return existing;
+    };
+    for (const note of notes) {
+        for (const tag of docsNoteTagValues(note)) {
+            for (const tagPrefix of tagHierarchy(tag)) {
+                ensure(tagPrefix)?.notes.add(note.id);
+            }
+        }
+        for (const card of note.cards) {
+            for (const tag of card.tags) {
+                for (const tagPrefix of tagHierarchy(tag)) {
+                    ensure(tagPrefix)?.cards.add(`${note.id}/${card.id}`);
+                }
+            }
+        }
+    }
+    return [...byTag.entries()]
+        .map(([tag, value]) => ({
+        tag,
+        noteCount: value.notes.size,
+        cardCount: value.cards.size,
+    }))
+        .sort((left, right) => left.tag.localeCompare(right.tag));
+}
+export function buildDocsGraph(notes) {
+    const notesById = new Map(notes.map((note) => [note.id, note]));
+    const lookup = noteLookup(notes);
+    const links = notes
+        .flatMap(extractDocsWikiLinks)
+        .map((link) => resolveLink(link, notesById, lookup));
+    const backlinks = Object.fromEntries(notes.map((note) => [note.id, []]));
+    for (const link of links) {
+        if (!link.resolvedNoteId)
+            continue;
+        const source = notesById.get(link.sourceNoteId);
+        if (!source)
+            continue;
+        backlinks[link.resolvedNoteId] ??= [];
+        backlinks[link.resolvedNoteId].push({
+            sourceNoteId: source.id,
+            sourceTitle: source.title,
+            raw: link.raw,
+            label: link.label,
+            excerpt: excerptAround(renderDocsNoteMarkdown(source), link.index),
+        });
+    }
+    return {
+        links,
+        backlinks,
+        unresolvedLinks: links.filter((link) => !link.resolvedNoteId && !link.ambiguousNoteIds?.length),
+        ambiguousLinks: links.filter((link) => Boolean(link.ambiguousNoteIds?.length)),
+        tags: buildTagSummaries(notes),
+    };
+}

package/dist/model/index.d.ts

@@ -0,0 +1,14 @@
+export { DOCS_NOTE_SCHEMA_VERSION, type DocsBookChapter, type DocsBookChapterNavigation, type DocsBookChapterRef, type DocsBookMetadata, type DocsBookNavigation, type CreateDocsNoteInput, type DocsBacklink, type DocsCalloutBlock, type DocsCalloutTone, type DocsCard, type DocsCardStackItem, type DocsCardStackMode, type DocsCardStatus, type DocsCardType, type DocsCodeBlock, type DocsConceptBlock, type DocsDocType, type DocsFsrsState, type DocsFsrsStateName, type DocsGraph, type DocsMarkdownBlock, type DocsMarkdownFile, type DocsNote, type DocsNoteSummary, type DocsNotePanel, type DocsProcedureBlock, type DocsPromptBlock, type DocsResourceItem, type DocsResourcesBlock, type DocsRevisionBlock, type DocsReviewLog, type DocsReviewQueueItem, type DocsReviewQueueSummaryItem, type DocsReviewRating, type DocsReviewScope, type DocsStoryBlock, type DocsTableBlock, type DocsTagSummary, type DocsTextBlock, type DocsWikiLink, type DocsWorkspace, type DocsWorkspaceIndex, } from "./types";
+export { CODING_RUNTIME_VERSIONS, codingRuntimeVersion, } from "./coding-runtime";
+export { assertDocsId, createDocsCodingExercise, createDocsNote, docsNoteToFrontmatter, docsNoteToMarkdown, isValidDocsId, normalizeDocsBlock, normalizeDocsCodingExercise, normalizeDocsCard, parseDocsNoteMarkdownFile, renderDocsBlockMarkdown, renderDocsNoteMarkdown, slugifyDocsId, } from "./markdown";
+export { extractDocsTags, extractDocsWikiLinks, buildDocsGraph, docsNoteMatchesTagFolder, docsNoteTagValues, docsTagMatchesFolder, normalizeDocsTag, resolveDocsNoteId, } from "./graph";
+export { buildDocsReviewQueue, docsFsrsParameters, formatDocsReviewInterval, fsrsCardFromState, fsrsStateFromCard, previewDocsCardRatings, reviewDocsCard, } from "./fsrs";
+export { REVIEW_RATING_KEYS, REVIEW_RATING_LABELS, REVIEW_RATINGS, } from "./docs-review-constants";
+export { SAMPLE_DOCS_BOOK_FOLDER, SAMPLE_DOCS_BOOK_INDEX_ID, SAMPLE_DOCS_BOOK_TAG, SAMPLE_DOCS_CHAPTER_IDS, SAMPLE_DOCS_NOTE_IDS, sampleDocsNotes, } from "./sample";
+export { buildDocsBooks, resolveDocsBookNavigation } from "./book";
+export { buildDocsWorkspace, buildDocsWorkspaceIndex, docsNoteToSummary, docsSummariesToStubNotes, } from "./workspace";
+export { docsNoteBlockCount, docsNoteBodyLength, docsNoteCardCount, docsNoteListKey, isDocsNoteSummary, type DocsNoteListItem, } from "./docs-note-list";
+export { cardHasBackMatter, docsBlockIdFromRef, docsBlockPlainText, docsBlockReferenceIndex, docsBlockRefMarker, docsBlockSnippet, resolveCardBlockRefs, type CardBlockRefResolution, type MissingCardBlockRef, type ResolvedCardBlockRef, } from "./docs-card-context";
+export { DOCS_MEDIA_SENTINEL_PREFIX, decodeDocsMediaSentinel, encodeDocsMediaSentinel, resolveDocsMediaRelativePath, rewriteDocsRelativeMediaSrc, serverDocsMediaUrl, type DocsMediaUrlResolver, } from "./docs-relative-media";
+export { getDocsMediaResolver, setDocsMediaResolver, type DocsMediaResolver, } from "./docs-media-context";
+export { CARD_STACK_MOTION, CARD_STACK_KICK, CARD_STACK_ANIMATION_NAMES, CARD_STACK_SWIPE, swipeDragPose, fanPose, fanStackOpacity, fanStackZIndex, fanTransform, wrappedCardIndex, clampCardIndex, resolveStackIndex, nextStackIndex, canNavigateStack, cardDepthInStack, incomingFanDepth, type CardStackMode, } from "./docs-card-preview-stack-motion";

package/dist/model/index.js

@@ -0,0 +1,14 @@
+export { DOCS_NOTE_SCHEMA_VERSION, } from "./types";
+export { CODING_RUNTIME_VERSIONS, codingRuntimeVersion, } from "./coding-runtime";
+export { assertDocsId, createDocsCodingExercise, createDocsNote, docsNoteToFrontmatter, docsNoteToMarkdown, isValidDocsId, normalizeDocsBlock, normalizeDocsCodingExercise, normalizeDocsCard, parseDocsNoteMarkdownFile, renderDocsBlockMarkdown, renderDocsNoteMarkdown, slugifyDocsId, } from "./markdown";
+export { extractDocsTags, extractDocsWikiLinks, buildDocsGraph, docsNoteMatchesTagFolder, docsNoteTagValues, docsTagMatchesFolder, normalizeDocsTag, resolveDocsNoteId, } from "./graph";
+export { buildDocsReviewQueue, docsFsrsParameters, formatDocsReviewInterval, fsrsCardFromState, fsrsStateFromCard, previewDocsCardRatings, reviewDocsCard, } from "./fsrs";
+export { REVIEW_RATING_KEYS, REVIEW_RATING_LABELS, REVIEW_RATINGS, } from "./docs-review-constants";
+export { SAMPLE_DOCS_BOOK_FOLDER, SAMPLE_DOCS_BOOK_INDEX_ID, SAMPLE_DOCS_BOOK_TAG, SAMPLE_DOCS_CHAPTER_IDS, SAMPLE_DOCS_NOTE_IDS, sampleDocsNotes, } from "./sample";
+export { buildDocsBooks, resolveDocsBookNavigation } from "./book";
+export { buildDocsWorkspace, buildDocsWorkspaceIndex, docsNoteToSummary, docsSummariesToStubNotes, } from "./workspace";
+export { docsNoteBlockCount, docsNoteBodyLength, docsNoteCardCount, docsNoteListKey, isDocsNoteSummary, } from "./docs-note-list";
+export { cardHasBackMatter, docsBlockIdFromRef, docsBlockPlainText, docsBlockReferenceIndex, docsBlockRefMarker, docsBlockSnippet, resolveCardBlockRefs, } from "./docs-card-context";
+export { DOCS_MEDIA_SENTINEL_PREFIX, decodeDocsMediaSentinel, encodeDocsMediaSentinel, resolveDocsMediaRelativePath, rewriteDocsRelativeMediaSrc, serverDocsMediaUrl, } from "./docs-relative-media";
+export { getDocsMediaResolver, setDocsMediaResolver, } from "./docs-media-context";
+export { CARD_STACK_MOTION, CARD_STACK_KICK, CARD_STACK_ANIMATION_NAMES, CARD_STACK_SWIPE, swipeDragPose, fanPose, fanStackOpacity, fanStackZIndex, fanTransform, wrappedCardIndex, clampCardIndex, resolveStackIndex, nextStackIndex, canNavigateStack, cardDepthInStack, incomingFanDepth, } from "./docs-card-preview-stack-motion";

package/dist/model/markdown-normalize.d.ts

@@ -0,0 +1,11 @@
+import { type CreateDocsNoteInput, type DocsCard, type DocsCodingExercise, type DocsMarkdownFile, type DocsNote, type DocsRevisionBlock } from "./types";
+export declare function isValidDocsId(value: string): boolean;
+export declare function assertDocsId(value: string): string;
+export declare function slugifyDocsId(value: string, fallback?: string): string;
+export declare function compactObject<T extends Record<string, unknown>>(record: T): Partial<T>;
+export declare function createDocsCodingExercise(exerciseId: string): DocsCodingExercise;
+export declare function normalizeDocsCodingExercise(value: unknown, cardId: string): DocsCodingExercise;
+export declare function normalizeDocsBlock(input: unknown, index: number): DocsRevisionBlock;
+export declare function normalizeDocsCard(input: unknown, index: number, timestamp: string): DocsCard;
+export declare function createDocsNote(input?: CreateDocsNoteInput, now?: Date): DocsNote;
+export declare function parseDocsNoteMarkdownFile(file: DocsMarkdownFile): DocsNote;