@eclipsa/content 0.0.0

package/dist/vite.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite.mjs","names":[],"sources":["../vite.ts"],"sourcesContent":["import * as fs from 'node:fs/promises'\nimport { pathToFileURL } from 'node:url'\nimport path from 'node:path'\nimport type { Plugin, PluginOption, ResolvedConfig, ViteDevServer } from 'vite'\nimport { createContentSearch } from './internal.ts'\nimport { generateContentSearchRuntimeModule, resolveContentSearchOptions } from './search.ts'\nimport type { ResolvedContentSearchOptions } from './types.ts'\n\nconst DEV_APP_INVALIDATORS_KEY = Symbol.for('eclipsa.dev-app-invalidators')\nconst CONTENT_HMR_EVENT = 'eclipsa:content-update'\nconst VIRTUAL_RUNTIME_ID = 'virtual:eclipsa-content:runtime'\nconst RESOLVED_VIRTUAL_RUNTIME_ID = '\\0eclipsa-content:runtime'\nconst VIRTUAL_SEARCH_ID = 'virtual:eclipsa-content:search'\nconst RESOLVED_VIRTUAL_SEARCH_ID = '\\0eclipsa-content:search'\nconst CONTENT_CONFIG_PATH = 'app/content.config.ts'\nconst CONTENT_COLLECTION_MARKER = '__eclipsa_content_collection__'\nconst CONTENT_SEARCH_ASSET = '__eclipsa_content_search__.json'\n\nconst normalizeSlashes = (value: string) => value.replaceAll('\\\\', '/')\nconst stripQuery = (id: string) => id.split('?', 1)[0] ?? id\n\nconst fileExists = async (filePath: string) => {\n  try {\n    await fs.access(filePath)\n    return true\n  } catch {\n    return false\n  }\n}\n\nconst getConfigPath = (root: string) => path.join(root, CONTENT_CONFIG_PATH)\nconst getSearchAssetPath = (base: string) => {\n  const normalizedBase = base === '' ? '/' : base.endsWith('/') ? base : `${base}/`\n  return `${normalizedBase}${CONTENT_SEARCH_ASSET}`\n}\nconst isContentConfigId = (root: string, id: string) =>\n  normalizeSlashes(path.resolve(stripQuery(id))) === normalizeSlashes(getConfigPath(root))\n\nconst getNamedCollectionExports = (source: string) =>\n  [...source.matchAll(/^\\s*export\\s+const\\s+([A-Za-z_$][\\w$]*)\\s*=/gm)].map((match) => match[1]!)\n\nconst invalidateVirtualRuntime = (server: ViteDevServer) => {\n  const graphs = [\n    (server as ViteDevServer & { moduleGraph?: any }).moduleGraph,\n    ...Object.values(\n      (server as ViteDevServer & { environments?: Record<string, { moduleGraph?: any }> })\n        .environments ?? {},\n    ).map((environment) => environment.moduleGraph),\n  ]\n  for (const graph of graphs) {\n    if (!graph) {\n      continue\n    }\n    for (const id of [\n      VIRTUAL_RUNTIME_ID,\n      RESOLVED_VIRTUAL_RUNTIME_ID,\n      VIRTUAL_SEARCH_ID,\n      RESOLVED_VIRTUAL_SEARCH_ID,\n    ]) {\n      const mod = graph.getModuleById?.(id)\n      if (mod) {\n        graph.invalidateModule?.(mod)\n      }\n    }\n  }\n}\n\nconst invalidateRegisteredDevApps = (server: ViteDevServer) => {\n  const invalidators = (\n    server as ViteDevServer & {\n      [DEV_APP_INVALIDATORS_KEY]?: Set<() => void>\n    }\n  )[DEV_APP_INVALIDATORS_KEY]\n  if (!invalidators) {\n    return\n  }\n  for (const invalidate of invalidators) {\n    invalidate()\n  }\n}\n\nconst shouldInvalidateForFile = (root: string, filePath: string) => {\n  const normalizedFilePath = normalizeSlashes(path.resolve(filePath))\n  const normalizedRoot = normalizeSlashes(path.resolve(root))\n  if (!normalizedFilePath.startsWith(normalizedRoot)) {\n    return false\n  }\n  if (normalizedFilePath === normalizeSlashes(path.join(root, CONTENT_CONFIG_PATH))) {\n    return true\n  }\n  return normalizedFilePath.endsWith('.md')\n}\n\nconst createMissingRuntimeModule = (root: string) => {\n  const message = `Missing ${CONTENT_CONFIG_PATH} in ${root}.`\n  return `\nconst error = new Error(${JSON.stringify(message)});\nexport const getCollection = async () => { throw error; };\nexport const getEntries = async () => { throw error; };\nexport const getEntry = async () => { throw error; };\nexport const render = async () => { throw error; };\n`\n}\n\nconst createClientRuntimeModule = () => `\nconst error = new Error(\"@eclipsa/content query APIs are server-only.\");\nexport const getCollection = async () => { throw error; };\nexport const getEntries = async () => { throw error; };\nexport const getEntry = async () => { throw error; };\nexport const render = async () => { throw error; };\n`\n\nconst createDisabledSearchModule = () => `\nexport const searchOptions = ${JSON.stringify(resolveContentSearchOptions(false))};\nexport const search = async () => [];\nexport default { search, searchOptions };\n`\n\nconst createClientContentConfigModule = async (configPath: string) => {\n  const source = await fs.readFile(configPath, 'utf8')\n  const exportNames = getNamedCollectionExports(source)\n  if (exportNames.length === 0) {\n    return ''\n  }\n  return exportNames\n    .map(\n      (name) =>\n        `export const ${name} = Object.freeze({ ${JSON.stringify(CONTENT_COLLECTION_MARKER)}: true });`,\n    )\n    .join('\\n')\n}\n\nconst createRuntimeModule = (root: string, configPath: string) => `\nimport * as collectionsModule from ${JSON.stringify(normalizeSlashes(configPath))};\nimport { createContentRuntime } from '@eclipsa/content/internal';\n\nconst runtime = createContentRuntime({\n  collectionsModule,\n  configPath: ${JSON.stringify(normalizeSlashes(configPath))},\n  root: ${JSON.stringify(normalizeSlashes(root))},\n});\n\nexport const getCollection = runtime.getCollection;\nexport const getEntries = runtime.getEntries;\nexport const getEntry = runtime.getEntry;\nexport const render = runtime.render;\n`\n\nconst loadCollectionsModule = async (configPath: string) => {\n  const href = pathToFileURL(configPath).href\n  return import(`${href}?t=${Date.now()}`)\n}\n\nconst handleInvalidation = (server: ViteDevServer, root: string, filePath: string) => {\n  if (!shouldInvalidateForFile(root, filePath)) {\n    return false\n  }\n  invalidateVirtualRuntime(server)\n  invalidateRegisteredDevApps(server)\n  ;(\n    server as ViteDevServer & { ws?: { send?: (event: string, payload?: unknown) => void } }\n  ).ws?.send?.(CONTENT_HMR_EVENT)\n  return true\n}\n\nconst contentPlugin = (): Plugin => {\n  let config: ResolvedConfig\n  let searchStatePromise: Promise<{\n    indexJson: string\n    options: ResolvedContentSearchOptions\n  } | null> | null = null\n\n  const resolveSearchState = async () => {\n    if (searchStatePromise) {\n      return searchStatePromise\n    }\n    searchStatePromise = (async () => {\n      const configPath = getConfigPath(config.root)\n      if (!(await fileExists(configPath))) {\n        return null\n      }\n      const collectionsModule = await loadCollectionsModule(configPath)\n      const result = await createContentSearch({\n        base: config.base,\n        collectionsModule,\n        configPath,\n        root: config.root,\n      })\n      if (!result.options.enabled || result.index.documents.length === 0) {\n        return null\n      }\n      return {\n        indexJson: JSON.stringify(result.index),\n        options: result.options,\n      }\n    })()\n    return searchStatePromise\n  }\n\n  return {\n    enforce: 'pre',\n    name: 'vite-plugin-eclipsa-content',\n    configResolved(resolvedConfig) {\n      config = resolvedConfig\n    },\n    configureServer(server) {\n      const searchPath = getSearchAssetPath(config.base)\n      server.middlewares.use(async (req, res, next) => {\n        const requestPath = req.url?.split('?', 1)[0] ?? ''\n        if (requestPath !== searchPath) {\n          next()\n          return\n        }\n        const state = await resolveSearchState()\n        if (!state) {\n          res.statusCode = 404\n          res.end('Not found')\n          return\n        }\n        res.setHeader('Content-Type', 'application/json; charset=utf-8')\n        res.end(state.indexJson)\n      })\n    },\n    hotUpdate(options) {\n      searchStatePromise = null\n      if (handleInvalidation(options.server, config.root, options.file)) {\n        return []\n      }\n    },\n    resolveId(id) {\n      if (id === VIRTUAL_RUNTIME_ID) {\n        return RESOLVED_VIRTUAL_RUNTIME_ID\n      }\n      if (id === VIRTUAL_SEARCH_ID) {\n        return RESOLVED_VIRTUAL_SEARCH_ID\n      }\n      return null\n    },\n    async load(id) {\n      if (id === RESOLVED_VIRTUAL_SEARCH_ID) {\n        const state = await resolveSearchState()\n        if (!state) {\n          return createDisabledSearchModule()\n        }\n        return generateContentSearchRuntimeModule(getSearchAssetPath(config.base), state.options)\n      }\n      if (id !== RESOLVED_VIRTUAL_RUNTIME_ID) {\n        if (this.environment?.name === 'client' && isContentConfigId(config.root, id)) {\n          return createClientContentConfigModule(getConfigPath(config.root))\n        }\n        return null\n      }\n      if (this.environment?.name === 'client') {\n        return createClientRuntimeModule()\n      }\n      const configPath = getConfigPath(config.root)\n      if (!(await fileExists(configPath))) {\n        return createMissingRuntimeModule(config.root)\n      }\n      return createRuntimeModule(config.root, configPath)\n    },\n    async generateBundle() {\n      const state = await resolveSearchState()\n      if (!state) {\n        return\n      }\n      this.emitFile({\n        fileName: CONTENT_SEARCH_ASSET,\n        source: state.indexJson,\n        type: 'asset',\n      })\n    },\n  }\n}\n\nexport const eclipsaContent = (): PluginOption => [contentPlugin()]\n"],"mappings":"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"}

package/highlight.ts

@@ -0,0 +1,125 @@
+import { createHighlighter, type Highlighter } from 'shiki'
+import type { ContentHighlightOptions } from './types.ts'
+
+const DEFAULT_THEME = 'github-dark'
+const CODE_BLOCK_RE = /<pre\b[^>]*>\s*<code\b([^>]*)>([\s\S]*?)<\/code>\s*<\/pre>/giu
+const CLASS_ATTR_RE = /\bclass=(['"])(.*?)\1/iu
+const HTML_ENTITY_RE = /&(?:#(\d+)|#x([\da-fA-F]+)|amp|lt|gt|quot|#39);/g
+const highlighterCache = new Map<string, Promise<Highlighter>>()
+const loadedLanguagesByTheme = new Map<string, Set<string>>()
+
+const decodeHtmlEntities = (value: string) =>
+  value.replace(HTML_ENTITY_RE, (entity, decimal, hex) => {
+    if (decimal) {
+      return String.fromCodePoint(Number(decimal))
+    }
+    if (hex) {
+      return String.fromCodePoint(Number.parseInt(hex, 16))
+    }
+    switch (entity) {
+      case '&amp;':
+        return '&'
+      case '&lt;':
+        return '<'
+      case '&gt;':
+        return '>'
+      case '&quot;':
+        return '"'
+      case '&#39;':
+        return "'"
+      default:
+        return entity
+    }
+  })
+
+const getLanguageFromCodeAttributes = (attributes: string) => {
+  const classAttr = CLASS_ATTR_RE.exec(attributes)?.[2]
+  if (!classAttr) {
+    return null
+  }
+  for (const token of classAttr.split(/\s+/)) {
+    if (token.startsWith('language-')) {
+      return token.slice('language-'.length)
+    }
+  }
+  return null
+}
+
+const resolveTheme = (options: boolean | ContentHighlightOptions | undefined) => {
+  if (!options) {
+    return null
+  }
+  return options === true ? DEFAULT_THEME : (options.theme ?? DEFAULT_THEME)
+}
+
+const getHighlighter = (theme: string) => {
+  const cached = highlighterCache.get(theme)
+  if (cached) {
+    return cached
+  }
+  const next = createHighlighter({
+    langs: [],
+    themes: [theme],
+  })
+  highlighterCache.set(theme, next)
+  loadedLanguagesByTheme.set(theme, new Set())
+  return next
+}
+
+const ensureLanguageLoaded = async (theme: string, language: string) => {
+  const loadedLanguages = loadedLanguagesByTheme.get(theme) ?? new Set<string>()
+  loadedLanguagesByTheme.set(theme, loadedLanguages)
+  if (loadedLanguages.has(language)) {
+    return
+  }
+  const highlighter = await getHighlighter(theme)
+  await highlighter.loadLanguage(language as any)
+  loadedLanguages.add(language)
+}
+
+export const highlightHtml = async (
+  html: string,
+  options: boolean | ContentHighlightOptions | undefined,
+) => {
+  const theme = resolveTheme(options)
+  if (!theme) {
+    return html
+  }
+
+  const highlighter = await getHighlighter(theme)
+  let highlightedHtml = ''
+  let lastIndex = 0
+
+  for (const match of html.matchAll(CODE_BLOCK_RE)) {
+    const index = match.index ?? 0
+    const fullMatch = match[0]
+    const codeAttributes = match[1] ?? ''
+    const encodedCode = match[2] ?? ''
+    const language = getLanguageFromCodeAttributes(codeAttributes)
+
+    highlightedHtml += html.slice(lastIndex, index)
+    lastIndex = index + fullMatch.length
+
+    if (!language) {
+      highlightedHtml += fullMatch
+      continue
+    }
+
+    try {
+      await ensureLanguageLoaded(theme, language)
+      highlightedHtml += highlighter.codeToHtml(decodeHtmlEntities(encodedCode), {
+        lang: language,
+        theme,
+      })
+    } catch {
+      highlightedHtml += fullMatch
+    }
+  }
+
+  if (lastIndex === 0) {
+    return html
+  }
+
+  highlightedHtml += html.slice(lastIndex)
+  return highlightedHtml
+}

package/internal.test.ts

@@ -0,0 +1,263 @@
+import * as fs from 'node:fs/promises'
+import * as os from 'node:os'
+import path from 'node:path'
+import { afterEach, describe, expect, it } from 'vitest'
+import {
+  createContentRuntime,
+  createContentSearch,
+  parseFrontmatter,
+  toEntryIdFromRelativePath,
+} from './internal.ts'
+import { defineCollection, glob } from './mod.ts'
+
+const createdRoots: string[] = []
+
+const createTempRoot = async () => {
+  const root = await fs.mkdtemp(path.join(os.tmpdir(), 'eclipsa-content-'))
+  createdRoots.push(root)
+  await fs.mkdir(path.join(root, 'app', 'content', 'docs', 'guide'), {
+    recursive: true,
+  })
+  return root
+}
+
+afterEach(async () => {
+  await Promise.all(
+    createdRoots.splice(0).map((root) => fs.rm(root, { force: true, recursive: true })),
+  )
+})
+
+describe('@eclipsa/content internals', () => {
+  it('parses YAML frontmatter and strips the delimiter block', () => {
+    expect(
+      parseFrontmatter(`---
+title: Hello
+order: 1
+---
+# Heading
+`),
+    ).toEqual({
+      body: '# Heading\n',
+      data: {
+        order: 1,
+        title: 'Hello',
+      },
+    })
+  })
+
+  it('normalizes file paths into stable entry ids', () => {
+    expect(toEntryIdFromRelativePath('guide/getting started.md')).toBe('guide/getting-started')
+    expect(toEntryIdFromRelativePath('guide/index.md')).toBe('guide')
+  })
+
+  it('loads markdown entries, honors slug overrides, and renders headings', async () => {
+    const root = await createTempRoot()
+    const configPath = path.join(root, 'app', 'content.config.ts')
+    await fs.writeFile(
+      path.join(root, 'app', 'content', 'docs', 'guide', 'getting-started.md'),
+      `---
+title: Getting Started
+description: Intro page
+order: 2
+slug: guide/start-here
+---
+# Getting Started
+
+Welcome to **content**.
+
+\`\`\`ts
+const answer = 42
+\`\`\`
+`,
+    )
+    await fs.writeFile(
+      path.join(root, 'app', 'content', 'docs', 'guide', 'overview.md'),
+      `---
+title: Overview
+description: Overview page
+order: 1
+---
+# Overview
+`,
+    )
+    const schema = {
+      '~standard': {
+        types: undefined as unknown as {
+          input: {
+            description: string
+            order: number
+            title: string
+          }
+          output: {
+            description: string
+            order: number
+            title: string
+          }
+        },
+        validate(value: unknown) {
+          return {
+            value: value as {
+              description: string
+              order: number
+              title: string
+            },
+          }
+        },
+        vendor: 'test',
+        version: 1 as const,
+      },
+    }
+    const docs = defineCollection({
+      loader: glob({
+        base: './content/docs',
+        pattern: '**/*.md',
+      }),
+      markdown: {
+        highlight: {
+          theme: 'github-dark',
+        },
+      },
+      schema,
+    })
+    const runtime = createContentRuntime({
+      collectionsModule: {
+        docs,
+      },
+      configPath,
+      root,
+    })
+
+    const entries = await runtime.getCollection(docs)
+
+    expect(entries.map((entry) => entry.id)).toEqual(['guide/overview', 'guide/start-here'])
+    expect(entries[1]?.data).toEqual({
+      description: 'Intro page',
+      order: 2,
+      title: 'Getting Started',
+    })
+
+    const entry = await runtime.getEntry(docs, 'guide/start-here')
+    expect(entry?.body).toContain('Welcome to **content**.')
+
+    const rendered = await runtime.render(entry!)
+    expect(rendered.html).toContain('<h1>Getting Started</h1>')
+    expect(rendered.html).toContain('class="shiki')
+    expect(rendered.html).toContain('answer')
+    expect(rendered.headings).toEqual([
+      {
+        depth: 1,
+        slug: 'getting-started',
+        text: 'Getting Started',
+      },
+    ])
+  })
+
+  it('surfaces frontmatter validation errors with file context', async () => {
+    const root = await createTempRoot()
+    const configPath = path.join(root, 'app', 'content.config.ts')
+    await fs.writeFile(
+      path.join(root, 'app', 'content', 'docs', 'guide', 'bad.md'),
+      `---
+title: Bad
+---
+# Bad
+`,
+    )
+    const schema = {
+      '~standard': {
+        types: undefined as unknown as {
+          input: {
+            title: string
+          }
+          output: {
+            title: string
+          }
+        },
+        validate() {
+          return {
+            issues: [
+              {
+                message: 'description is required',
+                path: ['description'],
+              },
+            ],
+          } as const
+        },
+        vendor: 'test',
+        version: 1 as const,
+      },
+    }
+    const docs = defineCollection({
+      loader: glob({
+        base: './content/docs',
+        pattern: '**/*.md',
+      }),
+      schema,
+    })
+    const runtime = createContentRuntime({
+      collectionsModule: {
+        docs,
+      },
+      configPath,
+      root,
+    })
+
+    await expect(runtime.getCollection(docs)).rejects.toThrow(
+      /Invalid frontmatter in collection "docs".*description is required/u,
+    )
+  })
+
+  it('builds a search index from searchable markdown collections', async () => {
+    const root = await createTempRoot()
+    const configPath = path.join(root, 'app', 'content.config.ts')
+    await fs.writeFile(
+      path.join(root, 'app', 'content', 'docs', 'guide', 'quick-start.md'),
+      `---
+title: Quick Start
+---
+# Quick Start
+
+Searchable nebula token.
+
+\`\`\`ts
+const searchNeedle = 'nebula'
+\`\`\`
+`,
+    )
+    const docs = defineCollection({
+      loader: glob({
+        base: './content/docs',
+        pattern: '**/*.md',
+      }),
+      search: {
+        hotkey: 'k',
+        limit: 5,
+        placeholder: 'Search docs',
+      },
+    })
+
+    const result = await createContentSearch({
+      base: '/',
+      collectionsModule: { docs },
+      configPath,
+      root,
+    })
+
+    expect(result.options).toMatchObject({
+      enabled: true,
+      hotkey: 'k',
+      limit: 5,
+      placeholder: 'Search docs',
+    })
+    expect(result.index.documents).toHaveLength(1)
+    expect(result.index.documents[0]).toMatchObject({
+      collection: 'docs',
+      id: 'guide/quick-start',
+      title: 'Quick Start',
+      url: '/docs/guide/quick-start',
+    })
+    expect(result.index.documents[0]?.body).toContain('Searchable nebula token.')
+    expect(result.index.documents[0]?.code).toContain("const searchNeedle = 'nebula'")
+    expect(result.index.documents[0]?.headings).toContain('Quick Start')
+  })
+})