@crowi/api 2.0.0-alpha.0

package/dist/renderer/core/headings.d.ts

@@ -0,0 +1,16 @@
+import type { Root } from 'mdast';
+import type { PipelineEsmDeps, PipelineMetadata } from '../pipeline';
+/**
+ * Core renderer transform — extract a flat TOC from heading nodes and
+ * stamp each heading with a stable `data.hProperties.id` matching the
+ * anchor id (so SSR HTML downstream can use the same id).
+ *
+ * github-slugger handles dedup (`-1`, `-2`, …) and CJK preservation.
+ *
+ * The factory takes the ESM deps because `github-slugger` /
+ * `mdast-util-to-string` are ESM-only and cannot be statically
+ * imported from `packages/api` (CJS). It returns a unified plugin
+ * that accepts `metadata` as its option.
+ */
+export type UnifiedTransformPlugin = (metadata: PipelineMetadata) => (tree: Root) => void;
+export declare const makeRemarkHeadings: (deps: PipelineEsmDeps) => UnifiedTransformPlugin;

package/dist/renderer/core/headings.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.makeRemarkHeadings = void 0;
+const makeRemarkHeadings = (deps) => (metadata) => (tree) => {
+    const slugger = new deps.GithubSlugger();
+    walk(tree);
+    function walk(node) {
+        if (node.type === 'heading') {
+            const heading = node;
+            const text = deps.mdastToString(heading).trim();
+            const anchorId = slugger.slug(text);
+            const entry = {
+                level: heading.depth,
+                text,
+                anchorId,
+            };
+            metadata.toc.push(entry);
+            // Stamp the heading so any downstream SSR renderer (Phase 3)
+            // can use the same id without re-running a slugger.
+            const data = (heading.data ?? (heading.data = {}));
+            data.hProperties = { ...(data.hProperties ?? {}), id: anchorId };
+            return;
+        }
+        if (Array.isArray(node.children)) {
+            for (const child of node.children)
+                walk(child);
+        }
+    }
+};
+exports.makeRemarkHeadings = makeRemarkHeadings;
+//# sourceMappingURL=headings.js.map

package/dist/renderer/core/headings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"headings.js","sourceRoot":"","sources":["../../../src/renderer/core/headings.ts"],"names":[],"mappings":";;;AAkBO,MAAM,kBAAkB,GAC7B,CAAC,IAAqB,EAA0B,EAAE,CAClD,CAAC,QAAQ,EAAE,EAAE,CACb,CAAC,IAAI,EAAE,EAAE;IACP,MAAM,OAAO,GAAG,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;IACzC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEX,SAAS,IAAI,CAAC,IAA6C;QACzD,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC5B,MAAM,OAAO,GAAG,IAAe,CAAC;YAChC,MAAM,IAAI,GAAG,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;YAChD,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACpC,MAAM,KAAK,GAAqB;gBAC9B,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,IAAI;gBACJ,QAAQ;aACT,CAAC;YACF,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAEzB,6DAA6D;YAC7D,oDAAoD;YACpD,MAAM,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,GAAG,EAAE,CAAC,CAA8C,CAAC;YAChG,IAAI,CAAC,WAAW,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,WAAW,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC;YACjE,OAAO;QACT,CAAC;QAED,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YACjC,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ;gBAAE,IAAI,CAAC,KAAgD,CAAC,CAAC;QAC5F,CAAC;IACH,CAAC;AACH,CAAC,CAAC;AA9BS,QAAA,kBAAkB,sBA8B3B"}

package/dist/renderer/core/index.d.ts

@@ -0,0 +1,65 @@
+import type { Root } from 'mdast';
+import type { RenderContext } from '@crowi/plugin-api';
+import type { MongoCacheStorage } from '../cache';
+import type { PipelineEsmDeps, PipelineMetadata } from '../pipeline';
+import type { RendererRegistryImpl } from '../registry';
+import { type UnifiedTransformPlugin } from './headings';
+export type { UnifiedTransformPlugin } from './headings';
+export { makeCodeBlockDispatch } from './code-block-dispatch';
+export { makeEmbedTagDispatch } from './embed-tags';
+export { makeMentionResolve, type MentionUsernameResolver } from './mention-resolve';
+export { makeUrlInlineExpandDispatch } from './url-inline-expand';
+/**
+ * Build the bundled core renderer transform plugins, in their fixed
+ * order (headings → wikilinks → mentions → code-blocks → syntax-
+ * highlight). The pipeline prepends these to the registry's external
+ * plugins on every run.
+ *
+ * Order rationale:
+ *   - headings runs first so the slugger sees pristine heading text
+ *     before any text rewrite (wikilinks / mentions inside headings
+ *     would otherwise change the visible label).
+ *   - wikilinks + mentions next, both walking text nodes and skipping
+ *     inside code / inlineCode.
+ *   - code-blocks (the lang aggregator) runs BEFORE syntax-highlight
+ *     because the latter rewrites `code` nodes into `html`, after
+ *     which the aggregator would no longer find them.
+ *   - syntax-highlight runs last among core plugins so wikilinks /
+ *     mentions / heading anchors are already stamped by the time the
+ *     AST gets persisted.
+ *
+ * Bound to the loaded ESM deps because `headings` needs
+ * `GithubSlugger` + `mdast-util-to-string`'s `toString` and
+ * `syntax-highlight` needs `shiki`; neither can be statically
+ * imported from CJS.
+ */
+export declare function buildCorePlugins(deps: PipelineEsmDeps): UnifiedTransformPlugin[];
+/**
+ * Test-only convenience: bind the core plugins to the deps and run
+ * each one in order against a fresh `metadata` bag. Bypasses the
+ * unified processor, which is useful for unit tests that don't want
+ * to wait on dynamic imports of unified.
+ *
+ * Production code path is `runPipeline` in pipeline.ts.
+ */
+export declare function runCorePluginsDirectly(deps: PipelineEsmDeps, tree: unknown, metadata: PipelineMetadata): void;
+/**
+ * Build the Phase 4 + 6 plugin-dispatch transforms — async post-
+ * processors that run AFTER `runSync` because they need to call cache
+ * I/O + plugin `render()` (both async).
+ *
+ * Order: embed-tags first, url-inline-expand second, code-block-
+ * dispatch third. Each walks the tree once and rewrites matched
+ * nodes in-place. Each no-ops when its respective registry is empty.
+ *
+ * Code-block-dispatch runs last on purpose: PlantUML / Mermaid output
+ * SHOULD NOT contain `@[tag](url)` or bare-URL constructs that earlier
+ * dispatchers would re-process, but putting code-block-dispatch last
+ * makes that defensive ordering explicit — the new `html` node it
+ * produces is opaque to the earlier walkers, which only operate on
+ * phrasing content / autolinks.
+ */
+export declare function buildPluginDispatchPlugins(registry: RendererRegistryImpl, ctx: RenderContext, deps: {
+    cache: MongoCacheStorage;
+    pageId: string;
+}): Array<(tree: Root) => Promise<void>>;

package/dist/renderer/core/index.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.makeUrlInlineExpandDispatch = exports.makeMentionResolve = exports.makeEmbedTagDispatch = exports.makeCodeBlockDispatch = void 0;
+exports.buildCorePlugins = buildCorePlugins;
+exports.runCorePluginsDirectly = runCorePluginsDirectly;
+exports.buildPluginDispatchPlugins = buildPluginDispatchPlugins;
+const code_blocks_1 = require("./code-blocks");
+const code_block_dispatch_1 = require("./code-block-dispatch");
+const embed_tags_1 = require("./embed-tags");
+const headings_1 = require("./headings");
+const mentions_1 = require("./mentions");
+const syntax_highlight_1 = require("./syntax-highlight");
+const url_inline_expand_1 = require("./url-inline-expand");
+const wikilinks_1 = require("./wikilinks");
+var code_block_dispatch_2 = require("./code-block-dispatch");
+Object.defineProperty(exports, "makeCodeBlockDispatch", { enumerable: true, get: function () { return code_block_dispatch_2.makeCodeBlockDispatch; } });
+var embed_tags_2 = require("./embed-tags");
+Object.defineProperty(exports, "makeEmbedTagDispatch", { enumerable: true, get: function () { return embed_tags_2.makeEmbedTagDispatch; } });
+var mention_resolve_1 = require("./mention-resolve");
+Object.defineProperty(exports, "makeMentionResolve", { enumerable: true, get: function () { return mention_resolve_1.makeMentionResolve; } });
+var url_inline_expand_2 = require("./url-inline-expand");
+Object.defineProperty(exports, "makeUrlInlineExpandDispatch", { enumerable: true, get: function () { return url_inline_expand_2.makeUrlInlineExpandDispatch; } });
+/**
+ * Build the bundled core renderer transform plugins, in their fixed
+ * order (headings → wikilinks → mentions → code-blocks → syntax-
+ * highlight). The pipeline prepends these to the registry's external
+ * plugins on every run.
+ *
+ * Order rationale:
+ *   - headings runs first so the slugger sees pristine heading text
+ *     before any text rewrite (wikilinks / mentions inside headings
+ *     would otherwise change the visible label).
+ *   - wikilinks + mentions next, both walking text nodes and skipping
+ *     inside code / inlineCode.
+ *   - code-blocks (the lang aggregator) runs BEFORE syntax-highlight
+ *     because the latter rewrites `code` nodes into `html`, after
+ *     which the aggregator would no longer find them.
+ *   - syntax-highlight runs last among core plugins so wikilinks /
+ *     mentions / heading anchors are already stamped by the time the
+ *     AST gets persisted.
+ *
+ * Bound to the loaded ESM deps because `headings` needs
+ * `GithubSlugger` + `mdast-util-to-string`'s `toString` and
+ * `syntax-highlight` needs `shiki`; neither can be statically
+ * imported from CJS.
+ */
+function buildCorePlugins(deps) {
+    return [(0, headings_1.makeRemarkHeadings)(deps), wikilinks_1.remarkWikiLinks, mentions_1.remarkMentions, code_blocks_1.remarkCodeBlockLanguages, (0, syntax_highlight_1.makeRemarkSyntaxHighlight)(deps)];
+}
+/**
+ * Test-only convenience: bind the core plugins to the deps and run
+ * each one in order against a fresh `metadata` bag. Bypasses the
+ * unified processor, which is useful for unit tests that don't want
+ * to wait on dynamic imports of unified.
+ *
+ * Production code path is `runPipeline` in pipeline.ts.
+ */
+function runCorePluginsDirectly(deps, tree, metadata) {
+    for (const plugin of buildCorePlugins(deps)) {
+        const transformer = plugin(metadata);
+        transformer(tree);
+    }
+}
+/**
+ * Build the Phase 4 + 6 plugin-dispatch transforms — async post-
+ * processors that run AFTER `runSync` because they need to call cache
+ * I/O + plugin `render()` (both async).
+ *
+ * Order: embed-tags first, url-inline-expand second, code-block-
+ * dispatch third. Each walks the tree once and rewrites matched
+ * nodes in-place. Each no-ops when its respective registry is empty.
+ *
+ * Code-block-dispatch runs last on purpose: PlantUML / Mermaid output
+ * SHOULD NOT contain `@[tag](url)` or bare-URL constructs that earlier
+ * dispatchers would re-process, but putting code-block-dispatch last
+ * makes that defensive ordering explicit — the new `html` node it
+ * produces is opaque to the earlier walkers, which only operate on
+ * phrasing content / autolinks.
+ */
+function buildPluginDispatchPlugins(registry, ctx, deps) {
+    return [(0, embed_tags_1.makeEmbedTagDispatch)(registry, ctx, deps), (0, url_inline_expand_1.makeUrlInlineExpandDispatch)(registry, ctx, deps), (0, code_block_dispatch_1.makeCodeBlockDispatch)(registry, ctx, deps)];
+}
+//# sourceMappingURL=index.js.map

package/dist/renderer/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/renderer/core/index.ts"],"names":[],"mappings":";;;AA4CA,4CAEC;AAUD,wDAKC;AAkBD,gEAMC;AAhFD,+CAAyD;AACzD,+DAA8D;AAC9D,6CAAoD;AACpD,yCAA6E;AAC7E,yCAA4C;AAC5C,yDAA+D;AAC/D,2DAAkE;AAClE,2CAA8C;AAG9C,6DAA8D;AAArD,4HAAA,qBAAqB,OAAA;AAC9B,2CAAoD;AAA3C,kHAAA,oBAAoB,OAAA;AAC7B,qDAAqF;AAA5E,qHAAA,kBAAkB,OAAA;AAC3B,yDAAkE;AAAzD,gIAAA,2BAA2B,OAAA;AAEpC;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,SAAgB,gBAAgB,CAAC,IAAqB;IACpD,OAAO,CAAC,IAAA,6BAAkB,EAAC,IAAI,CAAC,EAAE,2BAAe,EAAE,yBAAc,EAAE,sCAAwB,EAAE,IAAA,4CAAyB,EAAC,IAAI,CAAC,CAAC,CAAC;AAChI,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,sBAAsB,CAAC,IAAqB,EAAE,IAAa,EAAE,QAA0B;IACrG,KAAK,MAAM,MAAM,IAAI,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5C,MAAM,WAAW,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;QACrC,WAAW,CAAC,IAAyD,CAAC,CAAC;IACzE,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,SAAgB,0BAA0B,CACxC,QAA8B,EAC9B,GAAkB,EAClB,IAAkD;IAElD,OAAO,CAAC,IAAA,iCAAoB,EAAC,QAAQ,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,IAAA,+CAA2B,EAAC,QAAQ,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,IAAA,2CAAqB,EAAC,QAAQ,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC;AACnJ,CAAC"}

package/dist/renderer/core/mention-resolve.d.ts

@@ -0,0 +1,39 @@
+import type { Root } from 'mdast';
+/**
+ * Phase 2 plugin-dispatch transform — async post-processor that, after
+ * `runSync`, demotes `@username` mention link nodes whose username does
+ * NOT belong to a real user back to plain text.
+ *
+ * Why a post-`runSync` dispatch transform instead of teaching
+ * `remarkMentions` itself: `remarkMentions` is a synchronous unified
+ * plugin that only receives the metadata bag — it has no DB access by
+ * design. Username existence is an I/O concern, so it lives in the same
+ * async dispatch layer as the embed-tag / url-inline-expand transforms.
+ *
+ * The flow:
+ *   1. `remarkMentions` (sync core transform) turns EVERY `@username`
+ *      into a `link` node with `data.hProperties.className === 'mention'`
+ *      and pushes the username into `metadata.mentions`.
+ *   2. This transform collects those link nodes, batch-resolves the
+ *      distinct usernames with a single `User.find({ username: { $in } })`
+ *      query (no per-mention N+1), and replaces link nodes whose username
+ *      is unknown with a `text` node `@username`.
+ *
+ * `metadata.mentions` is intentionally left untouched — it is the input
+ * to the mention-notification dispatch (`registerMentionDispatch`), which
+ * is out of scope for this phase. Only the rendered AST link nodes are
+ * demoted.
+ *
+ * Only runs in `mode: 'save'`: the resolved AST is persisted as the
+ * revision's `renderedAst`, so read / view paths reuse it without
+ * re-resolving. The caller (`runPipeline`) gates on mode + resolver
+ * presence.
+ */
+/** Batch existence resolver: maps a username list to the subset that exists. */
+export type MentionUsernameResolver = (usernames: string[]) => Promise<Set<string>>;
+/**
+ * Build the async post-processor. Returns a function that walks the
+ * transformed mdast tree, finds mention link nodes, and rewrites the
+ * unknown-user ones in-place into plain text nodes.
+ */
+export declare const makeMentionResolve: (resolver: MentionUsernameResolver) => (tree: Root) => Promise<void>;

package/dist/renderer/core/mention-resolve.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.makeMentionResolve = void 0;
+const _mdast_walk_1 = require("./_mdast-walk");
+/**
+ * Build the async post-processor. Returns a function that walks the
+ * transformed mdast tree, finds mention link nodes, and rewrites the
+ * unknown-user ones in-place into plain text nodes.
+ */
+const makeMentionResolve = (resolver) => async (tree) => {
+    const matches = collectMentionLinks(tree);
+    if (matches.length === 0)
+        return;
+    const distinctUsernames = [...new Set(matches.map((m) => m.username))];
+    const existing = await resolver(distinctUsernames);
+    // Demote unknown-user mention links to plain text in-place. Indices
+    // stay valid because a link node is swapped for exactly one text
+    // node (1:1 replacement, no splice).
+    for (const match of matches) {
+        if (existing.has(match.username))
+            continue;
+        const textNode = { type: 'text', value: `@${match.username}` };
+        match.parent.children[match.index] = textNode;
+    }
+};
+exports.makeMentionResolve = makeMentionResolve;
+/**
+ * Collect every mention link node (a `link` with
+ * `data.hProperties.className === 'mention'`) together with its parent +
+ * index so the rewrite can swap it without re-walking the tree.
+ */
+function collectMentionLinks(tree) {
+    const out = [];
+    (0, _mdast_walk_1.walkPhrasingTree)(tree, (node) => {
+        const children = node.children;
+        if (!children)
+            return;
+        for (let i = 0; i < children.length; i++) {
+            const child = children[i];
+            if (!isMentionLink(child))
+                continue;
+            const username = mentionUsername(child);
+            if (username === null)
+                continue;
+            out.push({ parent: { children }, index: i, username });
+        }
+    });
+    return out;
+}
+function isMentionLink(node) {
+    if (node.type !== 'link')
+        return false;
+    // `mdast`'s `LinkData` does not declare `hProperties`, but the
+    // headings / wikilinks / mentions core transforms stamp it (it is the
+    // `mdast-util-to-hast` channel for HTML props). Read it through a
+    // narrowed view.
+    const data = node.data;
+    return data?.hProperties?.className === 'mention';
+}
+/**
+ * Recover the username from a mention link. `remarkMentions` builds the
+ * link's single child as `text` with value `@username`; we strip the
+ * leading `@`. Returns `null` for an unexpected shape (defensive — leaves
+ * the node as a link).
+ */
+function mentionUsername(link) {
+    const child = link.children[0];
+    if (!child || child.type !== 'text')
+        return null;
+    const value = child.value;
+    if (!value.startsWith('@'))
+        return null;
+    return value.slice(1);
+}
+//# sourceMappingURL=mention-resolve.js.map

package/dist/renderer/core/mention-resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mention-resolve.js","sourceRoot":"","sources":["../../../src/renderer/core/mention-resolve.ts"],"names":[],"mappings":";;;AACA,+CAAsE;AA6CtE;;;;GAIG;AACI,MAAM,kBAAkB,GAC7B,CAAC,QAAiC,EAAE,EAAE,CACtC,KAAK,EAAE,IAAU,EAAiB,EAAE;IAClC,MAAM,OAAO,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;IAC1C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAEjC,MAAM,iBAAiB,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IACvE,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,iBAAiB,CAAC,CAAC;IAEnD,oEAAoE;IACpE,iEAAiE;IACjE,qCAAqC;IACrC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC;YAAE,SAAS;QAC3C,MAAM,QAAQ,GAAS,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,KAAK,CAAC,QAAQ,EAAE,EAAE,CAAC;QACrE,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,QAAQ,CAAC;IAChD,CAAC;AACH,CAAC,CAAC;AAjBS,QAAA,kBAAkB,sBAiB3B;AAEJ;;;;GAIG;AACH,SAAS,mBAAmB,CAAC,IAAU;IACrC,MAAM,GAAG,GAAuB,EAAE,CAAC;IACnC,IAAA,8BAAgB,EAAC,IAAsB,EAAE,CAAC,IAAI,EAAE,EAAE;QAChD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC/B,IAAI,CAAC,QAAQ;YAAE,OAAO;QACtB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACzC,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;YAC1B,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC;gBAAE,SAAS;YACpC,MAAM,QAAQ,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;YACxC,IAAI,QAAQ,KAAK,IAAI;gBAAE,SAAS;YAChC,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;QACzD,CAAC;IACH,CAAC,CAAC,CAAC;IACH,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,aAAa,CAAC,IAAqB;IAC1C,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM;QAAE,OAAO,KAAK,CAAC;IACvC,+DAA+D;IAC/D,sEAAsE;IACtE,kEAAkE;IAClE,iBAAiB;IACjB,MAAM,IAAI,GAAG,IAAI,CAAC,IAA6D,CAAC;IAChF,OAAO,IAAI,EAAE,WAAW,EAAE,SAAS,KAAK,SAAS,CAAC;AACpD,CAAC;AAED;;;;;GAKG;AACH,SAAS,eAAe,CAAC,IAAU;IACjC,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC/B,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IACjD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;IAC1B,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACxC,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACxB,CAAC"}

package/dist/renderer/core/mentions.d.ts

@@ -0,0 +1,2 @@
+import type { UnifiedTransformPlugin } from './headings';
+export declare const remarkMentions: UnifiedTransformPlugin;

package/dist/renderer/core/mentions.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.remarkMentions = void 0;
+/**
+ * Core renderer transform — detect `@username` inside text nodes,
+ * replace each match with a link node (`/user/<username>`), and push
+ * the username into `metadata.mentions`.
+ *
+ * The matcher is intentionally narrow:
+ *   - username is `[A-Za-z0-9_-]{1,64}`
+ *   - the `@` must be at start-of-string OR after a non-word char
+ *     (so `me@example.com` does NOT mention `example`)
+ *   - text inside `code` / `inlineCode` is skipped
+ *   - text already inside a `link` is skipped (don't double-link)
+ *
+ * Phase 2 does NOT verify the user exists — that's left to Phase 3 if
+ * we decide to add an existence check at all (open question in spec).
+ */
+// `(^|[^A-Za-z0-9_])@([A-Za-z0-9_-]{1,64})` with the prefix preserved
+// so we can rebuild the leading text accurately.
+const MENTION_RE = /(^|[^A-Za-z0-9_])@([A-Za-z0-9_-]{1,64})/g;
+const remarkMentions = (metadata) => (tree) => {
+    walk(tree, /* insideLink */ false);
+    function walk(node, insideLink) {
+        if (node.type === 'code' || node.type === 'inlineCode')
+            return;
+        if (Array.isArray(node.children)) {
+            const isLinkNow = insideLink || node.type === 'link';
+            const replaced = isLinkNow ? node.children : transformChildren(node.children, metadata);
+            node.children = replaced;
+            for (const child of replaced)
+                walk(child, isLinkNow);
+        }
+    }
+};
+exports.remarkMentions = remarkMentions;
+function transformChildren(children, metadata) {
+    const out = [];
+    for (const child of children) {
+        if (child.type !== 'text') {
+            out.push(child);
+            continue;
+        }
+        out.push(...expandText(child, metadata));
+    }
+    return out;
+}
+function expandText(textNode, metadata) {
+    const value = textNode.value;
+    if (!value || !value.includes('@'))
+        return [textNode];
+    const out = [];
+    let lastIndex = 0;
+    MENTION_RE.lastIndex = 0;
+    for (let m; (m = MENTION_RE.exec(value));) {
+        const [matched, prefix, username] = m;
+        const start = m.index;
+        // The prefix character (if any) is part of the match; emit it
+        // as plain text and start the link at `@`.
+        const beforeText = value.slice(lastIndex, start) + prefix;
+        if (beforeText)
+            out.push({ type: 'text', value: beforeText });
+        metadata.mentions.push({ username });
+        out.push(toMentionLink(username));
+        lastIndex = start + matched.length;
+    }
+    if (lastIndex === 0)
+        return [textNode];
+    if (lastIndex < value.length) {
+        out.push({ type: 'text', value: value.slice(lastIndex) });
+    }
+    return out;
+}
+function toMentionLink(username) {
+    return {
+        type: 'link',
+        url: `/user/${username}`,
+        title: null,
+        children: [{ type: 'text', value: `@${username}` }],
+        data: { hProperties: { className: 'mention' } },
+    };
+}
+//# sourceMappingURL=mentions.js.map

package/dist/renderer/core/mentions.js.map

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

package/dist/renderer/core/syntax-highlight.d.ts

@@ -0,0 +1,21 @@
+import type { PipelineEsmDeps } from '../pipeline';
+import type { UnifiedTransformPlugin } from './headings';
+/**
+ * Core renderer transform — replace fenced code-block (`code`) nodes
+ * with `html` nodes carrying shiki-rendered `<pre><code>...</code></pre>`
+ * markup. Inline code (`inlineCode`) is intentionally left alone so the
+ * web `components.code` path keeps owning inline rendering.
+ *
+ * Behaviour for fence languages:
+ *   - shiki-supported lang  → replace with `html` node (shiki output)
+ *   - missing or unknown lang → leave the `code` node intact, web side
+ *     falls back to `<pre><code class="language-x">` rendering
+ *
+ * The factory takes `deps` because shiki itself is ESM-only and is
+ * loaded via the same jiti mechanism as unified / remark-* / slugger.
+ * Sequencing-wise this plugin runs AFTER `remarkCodeBlockLanguages`
+ * (the lang-aggregator) so the pure-observer pass sees the still-mdast
+ * `code` nodes; once we replace them with `html` nodes the aggregator
+ * would no longer find them.
+ */
+export declare const makeRemarkSyntaxHighlight: (deps: PipelineEsmDeps) => UnifiedTransformPlugin;

package/dist/renderer/core/syntax-highlight.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.makeRemarkSyntaxHighlight = void 0;
+/**
+ * Core renderer transform — replace fenced code-block (`code`) nodes
+ * with `html` nodes carrying shiki-rendered `<pre><code>...</code></pre>`
+ * markup. Inline code (`inlineCode`) is intentionally left alone so the
+ * web `components.code` path keeps owning inline rendering.
+ *
+ * Behaviour for fence languages:
+ *   - shiki-supported lang  → replace with `html` node (shiki output)
+ *   - missing or unknown lang → leave the `code` node intact, web side
+ *     falls back to `<pre><code class="language-x">` rendering
+ *
+ * The factory takes `deps` because shiki itself is ESM-only and is
+ * loaded via the same jiti mechanism as unified / remark-* / slugger.
+ * Sequencing-wise this plugin runs AFTER `remarkCodeBlockLanguages`
+ * (the lang-aggregator) so the pure-observer pass sees the still-mdast
+ * `code` nodes; once we replace them with `html` nodes the aggregator
+ * would no longer find them.
+ */
+const makeRemarkSyntaxHighlight = (deps) => (_metadata) => (tree) => {
+    const highlighter = deps.shikiHighlighter;
+    walk(tree, highlighter);
+};
+exports.makeRemarkSyntaxHighlight = makeRemarkSyntaxHighlight;
+function walk(node, highlighter) {
+    if (!Array.isArray(node.children))
+        return;
+    // Replace child code-nodes in place — inline (`inlineCode`) is not in
+    // the iterated parent's child list as a fence anyway, but we also
+    // gate on `type === 'code'` to be defensive.
+    for (let i = 0; i < node.children.length; i++) {
+        const child = node.children[i];
+        if (child.type === 'code') {
+            const replacement = renderCode(child, highlighter);
+            if (replacement) {
+                node.children[i] = replacement;
+            }
+            continue;
+        }
+        walk(child, highlighter);
+    }
+}
+function renderCode(code, highlighter) {
+    const lang = (code.lang ?? '').trim();
+    if (!lang)
+        return null; // no language → web-side plain fallback
+    if (!highlighter.hasLang(lang))
+        return null; // unknown → fallback path
+    const value = code.value ?? '';
+    // shiki output is escaped + wrapped in `<pre class="shiki ..."><code>`;
+    // the `<pre>` carries inline `style="background-color: ..."` for the
+    // bundled theme. We persist this verbatim on the AST as an `html` node.
+    let html;
+    try {
+        html = highlighter.codeToHtml(value, lang);
+    }
+    catch {
+        return null; // shiki internal error → fallback path
+    }
+    return { type: 'html', value: html };
+}
+//# sourceMappingURL=syntax-highlight.js.map

package/dist/renderer/core/syntax-highlight.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"syntax-highlight.js","sourceRoot":"","sources":["../../../src/renderer/core/syntax-highlight.ts"],"names":[],"mappings":";;;AAIA;;;;;;;;;;;;;;;;;GAiBG;AACI,MAAM,yBAAyB,GACpC,CAAC,IAAqB,EAA0B,EAAE,CAClD,CAAC,SAA2B,EAAE,EAAE,CAChC,CAAC,IAAU,EAAQ,EAAE;IACnB,MAAM,WAAW,GAAG,IAAI,CAAC,gBAAgB,CAAC;IAC1C,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;AAC1B,CAAC,CAAC;AANS,QAAA,yBAAyB,6BAMlC;AAOJ,SAAS,IAAI,CAAC,IAAmB,EAAE,WAA6B;IAC9D,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC;QAAE,OAAO;IAC1C,sEAAsE;IACtE,kEAAkE;IAClE,6CAA6C;IAC7C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC9C,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QAC/B,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC1B,MAAM,WAAW,GAAG,UAAU,CAAC,KAAa,EAAE,WAAW,CAAC,CAAC;YAC3D,IAAI,WAAW,EAAE,CAAC;gBAChB,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC;YACjC,CAAC;YACD,SAAS;QACX,CAAC;QACD,IAAI,CAAC,KAAiC,EAAE,WAAW,CAAC,CAAC;IACvD,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CAAC,IAAU,EAAE,WAA6B;IAC3D,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACtC,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC,CAAC,wCAAwC;IAChE,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,CAAC,0BAA0B;IACvE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;IAC/B,wEAAwE;IACxE,qEAAqE;IACrE,wEAAwE;IACxE,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACH,IAAI,GAAG,WAAW,CAAC,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC,CAAC,uCAAuC;IACtD,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AACvC,CAAC"}

package/dist/renderer/core/url-inline-expand.d.ts

@@ -0,0 +1,9 @@
+import type { Root } from 'mdast';
+import type { RenderContext } from '@crowi/plugin-api';
+import { type MongoCacheStorage } from '../cache';
+import { type RendererRegistryImpl } from '../registry';
+export interface UrlExpandDispatchDeps {
+    cache: MongoCacheStorage;
+    pageId: string;
+}
+export declare const makeUrlInlineExpandDispatch: (registry: RendererRegistryImpl, ctx: RenderContext, deps: UrlExpandDispatchDeps) => (tree: Root) => Promise<void>;