@aaronellington/vite-plugin-inkwell 0.0.1 → 0.0.5

package/content.d.ts

@@ -1,4 +1,4 @@
-import type { ContentItem } from "./src/types.ts"
+import type { ContentItem } from "./dist/types.js"
 
 declare module "inkwell:*" {
 	const collection: ContentItem[]

package/dist/assets.d.ts

@@ -0,0 +1,5 @@
+import type { AssetReference } from "./types.js";
+export declare function extractAssetReferences(html: string, mdFilePath: string): AssetReference[];
+export declare function replaceAssetsWithPlaceholders(html: string, assets: AssetReference[]): string;
+export declare function generateSlugModuleCode(html: string, assets: AssetReference[]): string;
+//# sourceMappingURL=assets.d.ts.map

package/dist/assets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assets.d.ts","sourceRoot":"","sources":["../src/assets.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAKhD,wBAAgB,sBAAsB,CACrC,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,GAChB,cAAc,EAAE,CA6BlB;AAED,wBAAgB,6BAA6B,CAC5C,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,cAAc,EAAE,GACtB,MAAM,CAMR;AAED,wBAAgB,sBAAsB,CACrC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,cAAc,EAAE,GACtB,MAAM,CA4BR"}

package/dist/assets.js

@@ -0,0 +1,50 @@
+import fs from "node:fs";
+import path from "node:path";
+const ASSET_REGEX = /(?:src|href|poster)=["'](?!(?:https?:|data:|#|\/\/|\/))([^"']+)["']/g;
+export function extractAssetReferences(html, mdFilePath) {
+    const mdDir = path.dirname(mdFilePath);
+    const assets = [];
+    const seen = new Set();
+    ASSET_REGEX.lastIndex = 0;
+    for (let match = ASSET_REGEX.exec(html); match !== null; match = ASSET_REGEX.exec(html)) {
+        const originalPath = match[1];
+        if (seen.has(originalPath))
+            continue;
+        seen.add(originalPath);
+        const absolutePath = path.resolve(mdDir, originalPath);
+        if (!fs.existsSync(absolutePath)) {
+            throw new Error(`Missing asset referenced in ${mdFilePath}: "${originalPath}"\n` +
+                `Resolved to: ${absolutePath}`);
+        }
+        const placeholderToken = `__CONTENT_ASSET_${assets.length}__`;
+        assets.push({ absolutePath, originalPath, placeholderToken });
+    }
+    return assets;
+}
+export function replaceAssetsWithPlaceholders(html, assets) {
+    let result = html;
+    for (const asset of assets) {
+        result = result.split(asset.originalPath).join(asset.placeholderToken);
+    }
+    return result;
+}
+export function generateSlugModuleCode(html, assets) {
+    if (assets.length === 0) {
+        return `export default ${JSON.stringify(html)};`;
+    }
+    const lines = [];
+    for (let i = 0; i < assets.length; i++) {
+        const asset = assets[i];
+        lines.push(`import __asset_${i}__ from ${JSON.stringify(asset.absolutePath)};`);
+    }
+    lines.push("");
+    lines.push(`let html = ${JSON.stringify(html)};`);
+    for (let i = 0; i < assets.length; i++) {
+        const asset = assets[i];
+        lines.push(`html = html.replaceAll(${JSON.stringify(asset.placeholderToken)}, __asset_${i}__);`);
+    }
+    lines.push("");
+    lines.push("export default html;");
+    return lines.join("\n");
+}
+//# sourceMappingURL=assets.js.map

package/dist/assets.js.map

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

package/dist/content.d.ts

@@ -0,0 +1,13 @@
+import type { MarkedExtension } from "marked";
+import { Marked } from "marked";
+import type { ParsedContentItem } from "./types.js";
+export declare function scanDirectory(dir: string, recursive: boolean): string[];
+export declare function parseFrontmatter(fileContent: string, filePath: string): {
+    data: Record<string, unknown>;
+    content: string;
+};
+export declare function computeSlug(frontmatter: Record<string, unknown>, filePath: string): string;
+export declare function checkDuplicateSlugs(items: ParsedContentItem[]): void;
+export declare function createRenderer(extensions: MarkedExtension[]): Marked;
+export declare function parseContentFile(filePath: string, baseDir: string, renderer: Marked, validate?: (frontmatter: Record<string, unknown>, filePath: string) => void): ParsedContentItem;
+//# sourceMappingURL=content.d.ts.map

package/dist/content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.d.ts","sourceRoot":"","sources":["../src/content.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAA;AAC7C,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAE/B,OAAO,KAAK,EAAsB,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAavE,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,MAAM,EAAE,CAcvE;AAED,wBAAgB,gBAAgB,CAC/B,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,GACd;IAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAQpD;AAED,wBAAgB,WAAW,CAC1B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,QAAQ,EAAE,MAAM,GACd,MAAM,CAQR;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,iBAAiB,EAAE,GAAG,IAAI,CAcpE;AAeD,wBAAgB,cAAc,CAAC,UAAU,EAAE,eAAe,EAAE,GAAG,MAAM,CAOpE;AAED,wBAAgB,gBAAgB,CAC/B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,GACzE,iBAAiB,CAsCnB"}

package/dist/content.js

@@ -0,0 +1,110 @@
+import fs from "node:fs";
+import path from "node:path";
+import matter from "gray-matter";
+import { Marked } from "marked";
+import { parse as parseToml } from "smol-toml";
+const matterOptions = {
+    engines: {
+        toml: {
+            parse: parseToml,
+            stringify: () => {
+                throw new Error("TOML stringify not supported");
+            },
+        },
+    },
+};
+export function scanDirectory(dir, recursive) {
+    const results = [];
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        const fullPath = path.join(dir, entry.name);
+        if (entry.isDirectory() && recursive) {
+            results.push(...scanDirectory(fullPath, recursive));
+        }
+        else if (entry.isFile() && entry.name.endsWith(".md")) {
+            results.push(fullPath);
+        }
+    }
+    return results;
+}
+export function parseFrontmatter(fileContent, filePath) {
+    try {
+        const result = matter(fileContent, matterOptions);
+        return { content: result.content, data: result.data };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Invalid frontmatter in ${filePath}: ${message}`);
+    }
+}
+export function computeSlug(frontmatter, filePath) {
+    if (typeof frontmatter.slug === "string" &&
+        frontmatter.slug.trim().length > 0) {
+        return frontmatter.slug.trim();
+    }
+    return path.basename(filePath, ".md");
+}
+export function checkDuplicateSlugs(items) {
+    const seen = new Map();
+    for (const item of items) {
+        const existing = seen.get(item.frontmatter.slug);
+        if (existing) {
+            throw new Error(`Duplicate slug "${item.frontmatter.slug}" found in:\n` +
+                `  - ${existing}\n` +
+                `  - ${item.filePath}\n` +
+                `Provide an explicit "slug" in frontmatter to resolve.`);
+        }
+        seen.set(item.frontmatter.slug, item.filePath);
+    }
+}
+const FILE_EXT_REGEX = /\.\w{1,10}$/;
+const assetLinkExtension = {
+    renderer: {
+        link({ href, text }) {
+            if (href && FILE_EXT_REGEX.test(href)) {
+                return `<a href="${href}" target="_blank" rel="noopener noreferrer">${text}</a>`;
+            }
+            return false;
+        },
+    },
+};
+export function createRenderer(extensions) {
+    const marked = new Marked();
+    marked.use(assetLinkExtension);
+    if (extensions.length > 0) {
+        marked.use(...extensions);
+    }
+    return marked;
+}
+export function parseContentFile(filePath, baseDir, renderer, validate) {
+    const fileContent = fs.readFileSync(filePath, "utf-8");
+    const { data, content } = parseFrontmatter(fileContent, filePath);
+    if (validate) {
+        validate(data, filePath);
+    }
+    const slug = computeSlug(data, filePath);
+    const directoryPath = path.relative(baseDir, path.dirname(filePath));
+    const html = renderer.parse(content);
+    if (typeof html !== "string") {
+        throw new Error(`Async marked extensions are not supported. File: ${filePath}`);
+    }
+    const frontmatter = {
+        ...data,
+        date: typeof data.date === "string"
+            ? data.date
+            : data.date instanceof Date
+                ? data.date.toISOString()
+                : "",
+        draft: data.draft === true,
+        slug,
+        title: typeof data.title === "string" ? data.title : "",
+    };
+    return {
+        assets: [],
+        directoryPath,
+        filePath,
+        frontmatter,
+        html,
+    };
+}
+//# sourceMappingURL=content.js.map

package/dist/content.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { inkwell } from "./plugin.js";
+export type { ContentFrontmatter, ContentItem, ContentPluginOptions, ParsedContentItem, } from "./types.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,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AACrC,YAAY,EACX,kBAAkB,EAClB,WAAW,EACX,oBAAoB,EACpB,iBAAiB,GACjB,MAAM,YAAY,CAAA"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { inkwell } from "./plugin.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,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA"}

package/dist/plugin.d.ts

@@ -0,0 +1,4 @@
+import type { Plugin } from "vite";
+import type { ContentPluginOptions } from "./types.js";
+export declare function inkwell(options?: ContentPluginOptions): Plugin;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAiC,MAAM,MAAM,CAAA;AAYjE,OAAO,KAAK,EAAE,oBAAoB,EAAqB,MAAM,YAAY,CAAA;AAMzE,wBAAgB,OAAO,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,MAAM,CAmO9D"}

package/dist/plugin.js

@@ -0,0 +1,195 @@
+import fs from "node:fs";
+import path from "node:path";
+import { extractAssetReferences, generateSlugModuleCode, replaceAssetsWithPlaceholders, } from "./assets.js";
+import { checkDuplicateSlugs, createRenderer, parseContentFile, scanDirectory, } from "./content.js";
+const CONTENT_PREFIX = "inkwell:";
+const RESOLVED_PREFIX = "\0inkwell:";
+const SLUG_SEPARATOR = "/";
+export function inkwell(options) {
+    const opts = options ?? {};
+    let config;
+    let server;
+    let isProduction = false;
+    const renderer = createRenderer(opts.markedExtensions ?? []);
+    // Map from absolute directory path to its parsed content items
+    const collections = new Map();
+    // Track which directories are in use for HMR
+    const watchedDirs = new Set();
+    function buildCollection(absoluteDir) {
+        if (!fs.existsSync(absoluteDir)) {
+            throw new Error(`Content directory does not exist: ${absoluteDir}`);
+        }
+        const recursive = opts.recursive !== false;
+        const allFiles = scanDirectory(absoluteDir, recursive);
+        const items = [];
+        for (const filePath of allFiles) {
+            const item = parseContentFile(filePath, absoluteDir, renderer, opts.validate);
+            const assets = extractAssetReferences(item.html, filePath);
+            item.assets = assets;
+            item.html = replaceAssetsWithPlaceholders(item.html, assets);
+            items.push(item);
+        }
+        checkDuplicateSlugs(items);
+        return items;
+    }
+    function getVisibleItems(items) {
+        if (isProduction && !opts.includeDrafts) {
+            return items.filter((item) => !item.frontmatter.draft);
+        }
+        return items;
+    }
+    function generateCollectionModule(absoluteDir) {
+        const allItems = collections.get(absoluteDir);
+        if (!allItems) {
+            throw new Error(`No content collection for directory: ${absoluteDir}`);
+        }
+        const items = getVisibleItems(allItems);
+        const slugPrefix = CONTENT_PREFIX + absoluteDir + SLUG_SEPARATOR;
+        const entries = items.map((item) => {
+            const meta = { ...item.frontmatter };
+            delete meta.title;
+            delete meta.slug;
+            delete meta.date;
+            delete meta.draft;
+            return [
+                "  {",
+                `    title: ${JSON.stringify(item.frontmatter.title)},`,
+                `    slug: ${JSON.stringify(item.frontmatter.slug)},`,
+                `    date: ${JSON.stringify(item.frontmatter.date)},`,
+                `    draft: ${JSON.stringify(item.frontmatter.draft)},`,
+                `    directory: ${JSON.stringify(item.directoryPath)},`,
+                `    meta: ${JSON.stringify(meta)},`,
+                `    getHtml: () => import(${JSON.stringify(slugPrefix + item.frontmatter.slug)}).then(m => m.default),`,
+                "  }",
+            ].join("\n");
+        });
+        return `export default [\n${entries.join(",\n")}\n];\n`;
+    }
+    function findItemBySlug(absoluteDir, slug) {
+        const items = collections.get(absoluteDir);
+        return items?.find((i) => i.frontmatter.slug === slug);
+    }
+    return {
+        configResolved(resolvedConfig) {
+            config = resolvedConfig;
+            isProduction = resolvedConfig.command === "build";
+        },
+        configureServer(devServer) {
+            server = devServer;
+        },
+        enforce: "pre",
+        hotUpdate(ctx) {
+            const { file } = ctx;
+            if (!file.endsWith(".md"))
+                return;
+            if (!server)
+                return;
+            // Find which watched directory this file belongs to
+            let matchedDir;
+            for (const dir of watchedDirs) {
+                if (file.startsWith(dir + path.sep) || file.startsWith(`${dir}/`)) {
+                    matchedDir = dir;
+                    break;
+                }
+            }
+            if (!matchedDir)
+                return;
+            try {
+                const items = buildCollection(matchedDir);
+                collections.set(matchedDir, items);
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                server.config.logger.error(message);
+                return [];
+            }
+            // Invalidate the collection module
+            const collectionId = RESOLVED_PREFIX + matchedDir;
+            const mod = this.environment.moduleGraph.getModuleById(collectionId);
+            if (mod) {
+                this.environment.moduleGraph.invalidateModule(mod);
+            }
+            // Invalidate the changed file's slug module
+            const items = collections.get(matchedDir);
+            const changedItem = items?.find((item) => item.filePath === file);
+            if (changedItem) {
+                const slugId = RESOLVED_PREFIX +
+                    matchedDir +
+                    SLUG_SEPARATOR +
+                    changedItem.frontmatter.slug;
+                const slugModule = this.environment.moduleGraph.getModuleById(slugId);
+                if (slugModule) {
+                    this.environment.moduleGraph.invalidateModule(slugModule);
+                }
+            }
+            server.hot.send({ type: "full-reload" });
+            return [];
+        },
+        load(id) {
+            if (!id.startsWith(RESOLVED_PREFIX))
+                return null;
+            const rest = id.slice(RESOLVED_PREFIX.length);
+            // Check if this is a slug module (contains a slug after the directory path)
+            // Slug modules: \0content:/abs/path/to/dir/my-slug
+            // Collection modules: \0content:/abs/path/to/dir
+            for (const [absoluteDir, items] of collections) {
+                const dirPrefix = absoluteDir + SLUG_SEPARATOR;
+                if (rest.startsWith(dirPrefix) && rest.length > dirPrefix.length) {
+                    const slug = rest.slice(dirPrefix.length);
+                    const item = items.find((i) => i.frontmatter.slug === slug);
+                    if (!item) {
+                        throw new Error(`Content item with slug "${slug}" not found`);
+                    }
+                    return generateSlugModuleCode(item.html, item.assets);
+                }
+                if (rest === absoluteDir) {
+                    return generateCollectionModule(absoluteDir);
+                }
+            }
+            // If we get here, the collection hasn't been built yet
+            // This happens on first load — build it now
+            if (rest.includes(SLUG_SEPARATOR)) {
+                // Try to find the directory portion
+                // Walk backward from the end to find a valid directory
+                const lastSlash = rest.lastIndexOf(SLUG_SEPARATOR);
+                const possibleDir = rest.slice(0, lastSlash);
+                const slug = rest.slice(lastSlash + 1);
+                if (collections.has(possibleDir)) {
+                    const item = findItemBySlug(possibleDir, slug);
+                    if (!item) {
+                        throw new Error(`Content item with slug "${slug}" not found`);
+                    }
+                    return generateSlugModuleCode(item.html, item.assets);
+                }
+            }
+            return null;
+        },
+        name: "inkwell",
+        resolveId(source, importer) {
+            if (!source.startsWith(CONTENT_PREFIX))
+                return null;
+            const rawPath = source.slice(CONTENT_PREFIX.length);
+            // If the path is already absolute (resolved from a slug module import), use it directly
+            if (path.isAbsolute(rawPath)) {
+                return RESOLVED_PREFIX + rawPath;
+            }
+            // Resolve relative to the importer's directory
+            const importerDir = importer ? path.dirname(importer) : config.root;
+            // Strip the \0 prefix from importer if it's a virtual module
+            const cleanImporterDir = importerDir.replace(/^\0/, "");
+            const absoluteDir = path.resolve(cleanImporterDir, rawPath);
+            // Build the collection if we haven't yet
+            if (!collections.has(absoluteDir)) {
+                const items = buildCollection(absoluteDir);
+                collections.set(absoluteDir, items);
+                // Watch directory for HMR
+                if (server) {
+                    server.watcher.add(absoluteDir);
+                }
+                watchedDirs.add(absoluteDir);
+            }
+            return RESOLVED_PREFIX + absoluteDir;
+        },
+    };
+}
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,49 @@
+import type { MarkedExtension } from "marked";
+export interface ContentPluginOptions {
+    /** Whether to recursively scan subdirectories (default: true) */
+    recursive?: boolean;
+    /** Custom frontmatter validation function. Throw to fail build. */
+    validate?: (frontmatter: Record<string, unknown>, filePath: string) => void;
+    /** Marked extensions for custom markdown rendering */
+    markedExtensions?: MarkedExtension[];
+    /** Whether to include draft posts in production (default: false) */
+    includeDrafts?: boolean;
+}
+export interface ContentFrontmatter {
+    title: string;
+    slug: string;
+    date: string;
+    draft: boolean;
+    [key: string]: unknown;
+}
+export interface AssetReference {
+    /** Original relative path as written in the markdown */
+    originalPath: string;
+    /** Absolute filesystem path */
+    absolutePath: string;
+    /** Placeholder token used in the HTML template string */
+    placeholderToken: string;
+}
+export interface ParsedContentItem {
+    frontmatter: ContentFrontmatter;
+    filePath: string;
+    /** Directory path relative to the configured content directory */
+    directoryPath: string;
+    /** Rendered HTML with placeholder tokens for assets */
+    html: string;
+    /** Asset references discovered in this content */
+    assets: AssetReference[];
+}
+export interface ContentItem {
+    title: string;
+    slug: string;
+    date: string;
+    draft: boolean;
+    /** Relative directory path within the content source */
+    directory: string;
+    /** All frontmatter key-value pairs (excluding title, slug, date, draft) */
+    meta: Record<string, unknown>;
+    /** Lazy-load the rendered HTML for this content item */
+    getHtml: () => Promise<string>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAA;AAE7C,MAAM,WAAW,oBAAoB;IACpC,iEAAiE;IACjE,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,mEAAmE;IACnE,QAAQ,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAA;IAC3E,sDAAsD;IACtD,gBAAgB,CAAC,EAAE,eAAe,EAAE,CAAA;IACpC,oEAAoE;IACpE,aAAa,CAAC,EAAE,OAAO,CAAA;CACvB;AAED,MAAM,WAAW,kBAAkB;IAClC,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,OAAO,CAAA;IACd,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACtB;AAED,MAAM,WAAW,cAAc;IAC9B,wDAAwD;IACxD,YAAY,EAAE,MAAM,CAAA;IACpB,+BAA+B;IAC/B,YAAY,EAAE,MAAM,CAAA;IACpB,yDAAyD;IACzD,gBAAgB,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,iBAAiB;IACjC,WAAW,EAAE,kBAAkB,CAAA;IAC/B,QAAQ,EAAE,MAAM,CAAA;IAChB,kEAAkE;IAClE,aAAa,EAAE,MAAM,CAAA;IACrB,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAA;IACZ,kDAAkD;IAClD,MAAM,EAAE,cAAc,EAAE,CAAA;CACxB;AAED,MAAM,WAAW,WAAW;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,OAAO,CAAA;IACd,wDAAwD;IACxD,SAAS,EAAE,MAAM,CAAA;IACjB,2EAA2E;IAC3E,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC7B,wDAAwD;IACxD,OAAO,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAA;CAC9B"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@aaronellington/vite-plugin-inkwell",
-	"version": "0.0.1",
+	"version": "0.0.5",
 	"description": "A Vite plugin that transforms directories of markdown files into typed, lazy-loaded content collections with frontmatter parsing, asset hashing, and HMR.",
 	"license": "MIT",
 	"author": "Aaron Ellington",
@@ -20,10 +20,13 @@
 	],
 	"type": "module",
 	"exports": {
-		".": "./src/index.ts"
+		".": {
+			"types": "./dist/index.d.ts",
+			"default": "./dist/index.js"
+		}
 	},
 	"files": [
-		"src/*.ts",
+		"dist",
 		"content.d.ts"
 	],
 	"engines": {
@@ -47,9 +50,11 @@
 		"vite": "^7.0.0"
 	},
 	"scripts": {
+		"build": "tsc",
 		"lint": "tsc -b && biome check . && prettier --check .",
 		"fix": "biome check --write . && prettier --write .",
 		"test": "playwright test",
-		"test:install": "playwright install chromium"
+		"test:install": "playwright install chromium",
+		"prepublishOnly": "npm run build"
 	}
 }

package/src/assets.ts

@@ -1,84 +0,0 @@
-import fs from "node:fs"
-import path from "node:path"
-import type { AssetReference } from "./types.ts"
-
-const ASSET_REGEX =
-	/(?:src|href|poster)=["'](?!(?:https?:|data:|#|\/\/|\/))([^"']+)["']/g
-
-export function extractAssetReferences(
-	html: string,
-	mdFilePath: string,
-): AssetReference[] {
-	const mdDir = path.dirname(mdFilePath)
-	const assets: AssetReference[] = []
-	const seen = new Set<string>()
-
-	ASSET_REGEX.lastIndex = 0
-	for (
-		let match = ASSET_REGEX.exec(html);
-		match !== null;
-		match = ASSET_REGEX.exec(html)
-	) {
-		const originalPath = match[1]
-		if (seen.has(originalPath)) continue
-		seen.add(originalPath)
-
-		const absolutePath = path.resolve(mdDir, originalPath)
-
-		if (!fs.existsSync(absolutePath)) {
-			throw new Error(
-				`Missing asset referenced in ${mdFilePath}: "${originalPath}"\n` +
-					`Resolved to: ${absolutePath}`,
-			)
-		}
-
-		const placeholderToken = `__CONTENT_ASSET_${assets.length}__`
-		assets.push({ absolutePath, originalPath, placeholderToken })
-	}
-
-	return assets
-}
-
-export function replaceAssetsWithPlaceholders(
-	html: string,
-	assets: AssetReference[],
-): string {
-	let result = html
-	for (const asset of assets) {
-		result = result.split(asset.originalPath).join(asset.placeholderToken)
-	}
-	return result
-}
-
-export function generateSlugModuleCode(
-	html: string,
-	assets: AssetReference[],
-): string {
-	if (assets.length === 0) {
-		return `export default ${JSON.stringify(html)};`
-	}
-
-	const lines: string[] = []
-
-	for (let i = 0; i < assets.length; i++) {
-		const asset = assets[i]
-		lines.push(
-			`import __asset_${i}__ from ${JSON.stringify(asset.absolutePath)};`,
-		)
-	}
-
-	lines.push("")
-	lines.push(`let html = ${JSON.stringify(html)};`)
-
-	for (let i = 0; i < assets.length; i++) {
-		const asset = assets[i]
-		lines.push(
-			`html = html.replaceAll(${JSON.stringify(asset.placeholderToken)}, __asset_${i}__);`,
-		)
-	}
-
-	lines.push("")
-	lines.push("export default html;")
-
-	return lines.join("\n")
-}

package/src/content.ts

@@ -1,143 +0,0 @@
-import fs from "node:fs"
-import path from "node:path"
-import matter from "gray-matter"
-import type { MarkedExtension } from "marked"
-import { Marked } from "marked"
-import { parse as parseToml } from "smol-toml"
-import type { ContentFrontmatter, ParsedContentItem } from "./types.ts"
-
-const matterOptions: matter.GrayMatterOption<string, any> = {
-	engines: {
-		toml: {
-			parse: parseToml as unknown as (input: string) => Record<string, unknown>,
-			stringify: () => {
-				throw new Error("TOML stringify not supported")
-			},
-		},
-	},
-}
-
-export function scanDirectory(dir: string, recursive: boolean): string[] {
-	const results: string[] = []
-	const entries = fs.readdirSync(dir, { withFileTypes: true })
-
-	for (const entry of entries) {
-		const fullPath = path.join(dir, entry.name)
-		if (entry.isDirectory() && recursive) {
-			results.push(...scanDirectory(fullPath, recursive))
-		} else if (entry.isFile() && entry.name.endsWith(".md")) {
-			results.push(fullPath)
-		}
-	}
-
-	return results
-}
-
-export function parseFrontmatter(
-	fileContent: string,
-	filePath: string,
-): { data: Record<string, unknown>; content: string } {
-	try {
-		const result = matter(fileContent, matterOptions)
-		return { content: result.content, data: result.data }
-	} catch (error) {
-		const message = error instanceof Error ? error.message : String(error)
-		throw new Error(`Invalid frontmatter in ${filePath}: ${message}`)
-	}
-}
-
-export function computeSlug(
-	frontmatter: Record<string, unknown>,
-	filePath: string,
-): string {
-	if (
-		typeof frontmatter.slug === "string" &&
-		frontmatter.slug.trim().length > 0
-	) {
-		return frontmatter.slug.trim()
-	}
-	return path.basename(filePath, ".md")
-}
-
-export function checkDuplicateSlugs(items: ParsedContentItem[]): void {
-	const seen = new Map<string, string>()
-	for (const item of items) {
-		const existing = seen.get(item.frontmatter.slug)
-		if (existing) {
-			throw new Error(
-				`Duplicate slug "${item.frontmatter.slug}" found in:\n` +
-					`  - ${existing}\n` +
-					`  - ${item.filePath}\n` +
-					`Provide an explicit "slug" in frontmatter to resolve.`,
-			)
-		}
-		seen.set(item.frontmatter.slug, item.filePath)
-	}
-}
-
-const FILE_EXT_REGEX = /\.\w{1,10}$/
-
-const assetLinkExtension: MarkedExtension = {
-	renderer: {
-		link({ href, text }) {
-			if (href && FILE_EXT_REGEX.test(href)) {
-				return `<a href="${href}" target="_blank" rel="noopener noreferrer">${text}</a>`
-			}
-			return false
-		},
-	},
-}
-
-export function createRenderer(extensions: MarkedExtension[]): Marked {
-	const marked = new Marked()
-	marked.use(assetLinkExtension)
-	if (extensions.length > 0) {
-		marked.use(...extensions)
-	}
-	return marked
-}
-
-export function parseContentFile(
-	filePath: string,
-	baseDir: string,
-	renderer: Marked,
-	validate?: (frontmatter: Record<string, unknown>, filePath: string) => void,
-): ParsedContentItem {
-	const fileContent = fs.readFileSync(filePath, "utf-8")
-	const { data, content } = parseFrontmatter(fileContent, filePath)
-
-	if (validate) {
-		validate(data, filePath)
-	}
-
-	const slug = computeSlug(data, filePath)
-	const directoryPath = path.relative(baseDir, path.dirname(filePath))
-
-	const html = renderer.parse(content)
-	if (typeof html !== "string") {
-		throw new Error(
-			`Async marked extensions are not supported. File: ${filePath}`,
-		)
-	}
-
-	const frontmatter: ContentFrontmatter = {
-		...data,
-		date:
-			typeof data.date === "string"
-				? data.date
-				: data.date instanceof Date
-					? data.date.toISOString()
-					: "",
-		draft: data.draft === true,
-		slug,
-		title: typeof data.title === "string" ? data.title : "",
-	}
-
-	return {
-		assets: [],
-		directoryPath,
-		filePath,
-		frontmatter,
-		html,
-	}
-}

package/src/index.ts

@@ -1,7 +0,0 @@
-export { inkwell } from "./plugin.ts"
-export type {
-	ContentFrontmatter,
-	ContentItem,
-	ContentPluginOptions,
-	ParsedContentItem,
-} from "./types.ts"

package/src/plugin.ts

@@ -1,247 +0,0 @@
-import fs from "node:fs"
-import path from "node:path"
-import type { Plugin, ResolvedConfig, ViteDevServer } from "vite"
-import {
-	extractAssetReferences,
-	generateSlugModuleCode,
-	replaceAssetsWithPlaceholders,
-} from "./assets.ts"
-import {
-	checkDuplicateSlugs,
-	createRenderer,
-	parseContentFile,
-	scanDirectory,
-} from "./content.ts"
-import type { ContentPluginOptions, ParsedContentItem } from "./types.ts"
-
-const CONTENT_PREFIX = "inkwell:"
-const RESOLVED_PREFIX = "\0inkwell:"
-const SLUG_SEPARATOR = "/"
-
-export function inkwell(options?: ContentPluginOptions): Plugin {
-	const opts = options ?? {}
-	let config: ResolvedConfig
-	let server: ViteDevServer | undefined
-	let isProduction = false
-
-	const renderer = createRenderer(opts.markedExtensions ?? [])
-
-	// Map from absolute directory path to its parsed content items
-	const collections = new Map<string, ParsedContentItem[]>()
-	// Track which directories are in use for HMR
-	const watchedDirs = new Set<string>()
-
-	function buildCollection(absoluteDir: string): ParsedContentItem[] {
-		if (!fs.existsSync(absoluteDir)) {
-			throw new Error(`Content directory does not exist: ${absoluteDir}`)
-		}
-
-		const recursive = opts.recursive !== false
-		const allFiles = scanDirectory(absoluteDir, recursive)
-		const items: ParsedContentItem[] = []
-
-		for (const filePath of allFiles) {
-			const item = parseContentFile(
-				filePath,
-				absoluteDir,
-				renderer,
-				opts.validate,
-			)
-
-			const assets = extractAssetReferences(item.html, filePath)
-			item.assets = assets
-			item.html = replaceAssetsWithPlaceholders(item.html, assets)
-
-			items.push(item)
-		}
-
-		checkDuplicateSlugs(items)
-		return items
-	}
-
-	function getVisibleItems(items: ParsedContentItem[]): ParsedContentItem[] {
-		if (isProduction && !opts.includeDrafts) {
-			return items.filter((item) => !item.frontmatter.draft)
-		}
-		return items
-	}
-
-	function generateCollectionModule(absoluteDir: string): string {
-		const allItems = collections.get(absoluteDir)
-		if (!allItems) {
-			throw new Error(`No content collection for directory: ${absoluteDir}`)
-		}
-
-		const items = getVisibleItems(allItems)
-		const slugPrefix = CONTENT_PREFIX + absoluteDir + SLUG_SEPARATOR
-
-		const entries = items.map((item) => {
-			const meta: Record<string, unknown> = { ...item.frontmatter }
-			delete meta.title
-			delete meta.slug
-			delete meta.date
-			delete meta.draft
-
-			return [
-				"  {",
-				`    title: ${JSON.stringify(item.frontmatter.title)},`,
-				`    slug: ${JSON.stringify(item.frontmatter.slug)},`,
-				`    date: ${JSON.stringify(item.frontmatter.date)},`,
-				`    draft: ${JSON.stringify(item.frontmatter.draft)},`,
-				`    directory: ${JSON.stringify(item.directoryPath)},`,
-				`    meta: ${JSON.stringify(meta)},`,
-				`    getHtml: () => import(${JSON.stringify(slugPrefix + item.frontmatter.slug)}).then(m => m.default),`,
-				"  }",
-			].join("\n")
-		})
-
-		return `export default [\n${entries.join(",\n")}\n];\n`
-	}
-
-	function findItemBySlug(
-		absoluteDir: string,
-		slug: string,
-	): ParsedContentItem | undefined {
-		const items = collections.get(absoluteDir)
-		return items?.find((i) => i.frontmatter.slug === slug)
-	}
-
-	return {
-		configResolved(resolvedConfig) {
-			config = resolvedConfig
-			isProduction = resolvedConfig.command === "build"
-		},
-
-		configureServer(devServer) {
-			server = devServer
-		},
-		enforce: "pre",
-
-		handleHotUpdate(ctx) {
-			const { file, server: hmrServer } = ctx
-			if (!file.endsWith(".md")) return
-
-			// Find which watched directory this file belongs to
-			let matchedDir: string | undefined
-			for (const dir of watchedDirs) {
-				if (file.startsWith(dir + path.sep) || file.startsWith(`${dir}/`)) {
-					matchedDir = dir
-					break
-				}
-			}
-
-			if (!matchedDir) return
-
-			try {
-				const items = buildCollection(matchedDir)
-				collections.set(matchedDir, items)
-			} catch (error) {
-				const message = error instanceof Error ? error.message : String(error)
-				hmrServer.config.logger.error(message)
-				return []
-			}
-
-			// Invalidate the collection module
-			const collectionId = RESOLVED_PREFIX + matchedDir
-			const collectionModule = hmrServer.moduleGraph.getModuleById(collectionId)
-			if (collectionModule) {
-				hmrServer.moduleGraph.invalidateModule(collectionModule)
-			}
-
-			// Invalidate the changed file's slug module
-			const items = collections.get(matchedDir)
-			const changedItem = items?.find((item) => item.filePath === file)
-			if (changedItem) {
-				const slugId =
-					RESOLVED_PREFIX +
-					matchedDir +
-					SLUG_SEPARATOR +
-					changedItem.frontmatter.slug
-				const slugModule = hmrServer.moduleGraph.getModuleById(slugId)
-				if (slugModule) {
-					hmrServer.moduleGraph.invalidateModule(slugModule)
-				}
-			}
-
-			hmrServer.hot.send({ type: "full-reload" })
-			return []
-		},
-
-		load(id) {
-			if (!id.startsWith(RESOLVED_PREFIX)) return null
-
-			const rest = id.slice(RESOLVED_PREFIX.length)
-
-			// Check if this is a slug module (contains a slug after the directory path)
-			// Slug modules: \0content:/abs/path/to/dir/my-slug
-			// Collection modules: \0content:/abs/path/to/dir
-			for (const [absoluteDir, items] of collections) {
-				const dirPrefix = absoluteDir + SLUG_SEPARATOR
-				if (rest.startsWith(dirPrefix) && rest.length > dirPrefix.length) {
-					const slug = rest.slice(dirPrefix.length)
-					const item = items.find((i) => i.frontmatter.slug === slug)
-					if (!item) {
-						throw new Error(`Content item with slug "${slug}" not found`)
-					}
-					return generateSlugModuleCode(item.html, item.assets)
-				}
-
-				if (rest === absoluteDir) {
-					return generateCollectionModule(absoluteDir)
-				}
-			}
-
-			// If we get here, the collection hasn't been built yet
-			// This happens on first load — build it now
-			if (rest.includes(SLUG_SEPARATOR)) {
-				// Try to find the directory portion
-				// Walk backward from the end to find a valid directory
-				const lastSlash = rest.lastIndexOf(SLUG_SEPARATOR)
-				const possibleDir = rest.slice(0, lastSlash)
-				const slug = rest.slice(lastSlash + 1)
-
-				if (collections.has(possibleDir)) {
-					const item = findItemBySlug(possibleDir, slug)
-					if (!item) {
-						throw new Error(`Content item with slug "${slug}" not found`)
-					}
-					return generateSlugModuleCode(item.html, item.assets)
-				}
-			}
-
-			return null
-		},
-		name: "inkwell",
-
-		resolveId(source, importer) {
-			if (!source.startsWith(CONTENT_PREFIX)) return null
-
-			const rawPath = source.slice(CONTENT_PREFIX.length)
-
-			// If the path is already absolute (resolved from a slug module import), use it directly
-			if (path.isAbsolute(rawPath)) {
-				return RESOLVED_PREFIX + rawPath
-			}
-
-			// Resolve relative to the importer's directory
-			const importerDir = importer ? path.dirname(importer) : config.root
-			// Strip the \0 prefix from importer if it's a virtual module
-			const cleanImporterDir = importerDir.replace(/^\0/, "")
-			const absoluteDir = path.resolve(cleanImporterDir, rawPath)
-
-			// Build the collection if we haven't yet
-			if (!collections.has(absoluteDir)) {
-				const items = buildCollection(absoluteDir)
-				collections.set(absoluteDir, items)
-
-				// Watch directory for HMR
-				if (server) {
-					server.watcher.add(absoluteDir)
-				}
-				watchedDirs.add(absoluteDir)
-			}
-
-			return RESOLVED_PREFIX + absoluteDir
-		},
-	}
-}

package/src/types.ts

@@ -1,53 +0,0 @@
-import type { MarkedExtension } from "marked"
-
-export interface ContentPluginOptions {
-	/** Whether to recursively scan subdirectories (default: true) */
-	recursive?: boolean
-	/** Custom frontmatter validation function. Throw to fail build. */
-	validate?: (frontmatter: Record<string, unknown>, filePath: string) => void
-	/** Marked extensions for custom markdown rendering */
-	markedExtensions?: MarkedExtension[]
-	/** Whether to include draft posts in production (default: false) */
-	includeDrafts?: boolean
-}
-
-export interface ContentFrontmatter {
-	title: string
-	slug: string
-	date: string
-	draft: boolean
-	[key: string]: unknown
-}
-
-export interface AssetReference {
-	/** Original relative path as written in the markdown */
-	originalPath: string
-	/** Absolute filesystem path */
-	absolutePath: string
-	/** Placeholder token used in the HTML template string */
-	placeholderToken: string
-}
-
-export interface ParsedContentItem {
-	frontmatter: ContentFrontmatter
-	filePath: string
-	/** Directory path relative to the configured content directory */
-	directoryPath: string
-	/** Rendered HTML with placeholder tokens for assets */
-	html: string
-	/** Asset references discovered in this content */
-	assets: AssetReference[]
-}
-
-export interface ContentItem {
-	title: string
-	slug: string
-	date: string
-	draft: boolean
-	/** Relative directory path within the content source */
-	directory: string
-	/** All frontmatter key-value pairs (excluding title, slug, date, draft) */
-	meta: Record<string, unknown>
-	/** Lazy-load the rendered HTML for this content item */
-	getHtml: () => Promise<string>
-}