@pathmx/core 0.5.0

package/plugins/code-highlight/client.ts

@@ -0,0 +1,89 @@
+import "./theme.css"
+import { checkIconSvg } from "../../icons/lucide.ts"
+
+const RESET_MS = 2000
+const timers = new WeakMap<Element, ReturnType<typeof setTimeout>>()
+const idleIcons = new WeakMap<Element, string>()
+
+function readCode(block: Element) {
+  const code = block.querySelector("pre code") ?? block.querySelector("pre")
+  let text = code?.textContent ?? ""
+  if (text.endsWith("\n")) text = text.slice(0, -1)
+  return text
+}
+
+function execCommandCopy(text: string) {
+  const body = document.body
+  if (!body || typeof document.execCommand !== "function") return false
+  const area = document.createElement("textarea")
+  area.value = text
+  area.setAttribute("readonly", "")
+  area.style.position = "fixed"
+  area.style.opacity = "0"
+  body.appendChild(area)
+  let ok = false
+  try {
+    area.select()
+    ok = document.execCommand("copy")
+  } catch {
+    ok = false
+  }
+  body.removeChild(area)
+  return ok
+}
+
+async function copy(text: string) {
+  if (navigator.clipboard?.writeText) {
+    try {
+      await navigator.clipboard.writeText(text)
+      return true
+    } catch {
+      return execCommandCopy(text)
+    }
+  }
+  return execCommandCopy(text)
+}
+
+function showCopied(button: Element) {
+  let copyIcon = idleIcons.get(button)
+  if (!copyIcon) {
+    copyIcon = button.innerHTML
+    idleIcons.set(button, copyIcon)
+  }
+  button.innerHTML = checkIconSvg
+  button.classList.add("is-copied")
+  button.setAttribute("aria-label", "Copied")
+  const existing = timers.get(button)
+  if (existing) clearTimeout(existing)
+  timers.set(
+    button,
+    setTimeout(() => {
+      button.classList.remove("is-copied")
+      button.setAttribute("aria-label", "Copy code")
+      if (copyIcon) button.innerHTML = copyIcon
+      timers.delete(button)
+    }, RESET_MS),
+  )
+}
+
+declare global {
+  interface Window {
+    __pathmxCodeCopyInstalled?: boolean
+  }
+}
+
+if (!window.__pathmxCodeCopyInstalled) {
+  window.__pathmxCodeCopyInstalled = true
+  document.addEventListener("click", (event) => {
+    const target = event.target
+    if (!(target instanceof Element)) return
+    const button = target.closest(".pmx-code-copy")
+    const block = button?.closest(".pmx-code-block")
+    if (!button || !block) return
+    const text = readCode(block)
+    if (!text) return
+    void copy(text).then((ok) => {
+      if (ok) showCopied(button)
+    })
+  })
+}

package/plugins/code-highlight/index.ts

@@ -0,0 +1,147 @@
+import hljs from "highlight.js/lib/common"
+import { isFenceClose, matchFenceOpen } from "../../source/index.ts"
+import { decodeHtmlEntities, escapeHtml } from "../../util.ts"
+import type { CompileContext, Plugin } from "../types.ts"
+import { copyIconSvg } from "../../icons/lucide.ts"
+
+type FenceMeta = {
+  noCopy: boolean
+  noSelect: boolean
+  steps?: string
+}
+
+const CODE_META_FLAGS = new Set(["no-copy", "no-select"])
+const CODE_BLOCK = /<pre><code([^>]*)>([\s\S]*?)<\/code><\/pre>/g
+const LANGUAGE = /\blanguage-([^"'\s]+)/
+const PLAIN = new Set(["plain", "plaintext", "text"])
+const CODE_STEPS = /^\[(\d+(?:-\d+)?(?:\|\d+(?:-\d+)?)*)\]$/
+
+const clientEntry = new URL("./client.ts", import.meta.url)
+
+function parseCodeInfo(info: string) {
+  const tokens = info.trim().split(/\s+/).filter(Boolean)
+  const lang = tokens[0]?.toLowerCase() ?? ""
+  const rest = tokens.slice(1)
+  const steps = rest
+    .find((token) => CODE_STEPS.test(token))
+    ?.match(CODE_STEPS)?.[1]
+  return {
+    lang,
+    meta: {
+      noCopy: rest.includes("no-copy"),
+      noSelect: rest.includes("no-select"),
+      ...(steps ? { steps } : {}),
+    } satisfies FenceMeta,
+    nextInfo: [
+      ...tokens.slice(0, 1),
+      ...rest.filter(
+        (token) => !CODE_META_FLAGS.has(token) && !CODE_STEPS.test(token),
+      ),
+    ].join(" "),
+  }
+}
+
+function stripCodeFenceFlags(markdown: string) {
+  const lines = markdown.split(/\r?\n/)
+  const metaByFence: FenceMeta[] = []
+  let marker: string | undefined
+
+  for (let index = 0; index < lines.length; index++) {
+    const line = lines[index] ?? ""
+    if (marker) {
+      if (isFenceClose(line, marker)) marker = undefined
+      continue
+    }
+    const fence = matchFenceOpen(line)
+    if (!fence) continue
+    const parsed = parseCodeInfo(fence.info)
+    metaByFence.push(parsed.meta)
+    lines[index] = `${fence.indent}${fence.marker}${parsed.nextInfo}`
+    marker = fence.marker
+  }
+
+  return { markdown: lines.join("\n"), metaByFence }
+}
+
+function indexedFenceMeta(markdown: string, ctx: CompileContext) {
+  const authored = ctx.block?.body ?? ctx.source.body
+  if (markdown !== authored) return
+  return (ctx.block?.fences ?? ctx.source.fences).map(
+    (fence) => parseCodeInfo(fence.info).meta,
+  )
+}
+
+function isPlainLanguage(lang: string) {
+  return PLAIN.has(lang.toLowerCase())
+}
+
+function wrapCodeBlock(html: string, meta: FenceMeta) {
+  const attrs = [`class="pmx-code-block"`]
+  if (meta.noSelect) attrs.push(`data-code-select="false"`)
+  if (meta.steps) attrs.push(`data-pmx-code-steps="${escapeHtml(meta.steps)}"`)
+  const copyButton = meta.noCopy
+    ? ""
+    : `<button class="pmx-code-copy" aria-label="Copy code">${copyIconSvg}</button>`
+  return `<div ${attrs.join(" ")}>${copyButton}${html}</div>`
+}
+
+function highlightBlock(attrs: string, body: string) {
+  const lang = (attrs.match(LANGUAGE)?.[1] ?? "").toLowerCase()
+  if (!lang || isPlainLanguage(lang) || !hljs.getLanguage(lang)) {
+    return `<pre><code${attrs}>${body}</code></pre>`
+  }
+  try {
+    const highlighted = hljs.highlight(decodeHtmlEntities(body), {
+      language: lang,
+      ignoreIllegals: true,
+    }).value
+    return `<pre><code class="hljs language-${escapeHtml(lang)}">${highlighted}</code></pre>`
+  } catch {
+    return `<pre><code${attrs}>${body}</code></pre>`
+  }
+}
+
+export function CodeHighlightPlugin(): Plugin {
+  const metaByContext = new WeakMap<CompileContext, FenceMeta[]>()
+
+  return {
+    id: "code-highlight",
+    precompile(markdown, ctx) {
+      const indexed = indexedFenceMeta(markdown, ctx)
+      if (indexed) {
+        metaByContext.set(ctx, indexed)
+        if (
+          !indexed.some((meta) => meta.noCopy || meta.noSelect || meta.steps)
+        ) {
+          return markdown
+        }
+      } else if (!markdown.includes("```") && !markdown.includes("~~~")) {
+        metaByContext.set(ctx, [])
+        return markdown
+      }
+      const parsed = stripCodeFenceFlags(markdown)
+      metaByContext.set(ctx, parsed.metaByFence)
+      return parsed.markdown
+    },
+
+    postcompile(html, ctx) {
+      if (!html.includes("<pre><code")) return html
+      const metaByFence = metaByContext.get(ctx) ?? []
+      let fenceIndex = 0
+      return html.replace(CODE_BLOCK, (match, attrs: string, body: string) => {
+        if (/\bhljs\b/.test(attrs)) return match
+        const meta = metaByFence[fenceIndex++] ?? {
+          noCopy: false,
+          noSelect: false,
+        }
+        return wrapCodeBlock(highlightBlock(attrs, body), meta)
+      })
+    },
+
+    async page(html, ctx) {
+      if (!html.includes("pmx-code-block")) return html
+      await ctx.addBrowserBundle(clientEntry, "code-highlight")
+      return html
+    },
+  }
+}

package/plugins/code-highlight/theme.css

@@ -0,0 +1,89 @@
+.pmx-code-block {
+  position: relative;
+}
+
+.pmx-code-block pre {
+  margin: 0;
+  overflow: auto;
+}
+
+.pmx-code-block code {
+  display: block;
+  padding: 1rem 1.25rem;
+  font-family: var(--pmx-font-mono);
+  font-size: 0.875rem;
+  line-height: 1.5;
+  overflow-x: auto;
+  color: var(--pmx-code-fg);
+  background: var(--pmx-code-bg);
+  border-radius: var(--pmx-radius-lg);
+}
+
+.pmx-code-block[data-code-select="false"] {
+  user-select: none;
+}
+
+.pmx-code-copy {
+  position: absolute;
+  top: 0.5rem;
+  right: 0.5rem;
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  width: 1.75rem;
+  height: 1.75rem;
+  padding: 0;
+  border: 0;
+  border-radius: 0.35rem;
+  background: transparent;
+  color: inherit;
+  opacity: 0.55;
+  cursor: pointer;
+}
+
+.pmx-code-copy:hover,
+.pmx-code-copy:focus-visible,
+.pmx-code-copy.is-copied {
+  opacity: 1;
+}
+
+.hljs-comment,
+.hljs-quote,
+.hljs-meta {
+  color: var(--pmx-code-comment);
+}
+.hljs-keyword,
+.hljs-selector-tag,
+.hljs-deletion {
+  color: var(--pmx-code-keyword);
+}
+.hljs-string,
+.hljs-addition,
+.hljs-attr,
+.hljs-attribute,
+.hljs-link {
+  color: var(--pmx-code-string);
+}
+.hljs-number,
+.hljs-literal,
+.hljs-variable,
+.hljs-template-variable,
+.hljs-title,
+.hljs-section,
+.hljs-selector-id,
+.hljs-built_in,
+.hljs-type,
+.hljs-symbol,
+.hljs-bullet,
+.hljs-name,
+.hljs-tag,
+.hljs-selector-class,
+.hljs-punctuation {
+  color: var(--pmx-code-punctuation);
+}
+.hljs-emphasis {
+  font-style: italic;
+}
+.hljs-strong {
+  font-weight: 700;
+}

package/plugins/context.ts

@@ -0,0 +1,131 @@
+import type { Engine } from "../host/engine.ts"
+import type { Log } from "../log.ts"
+import type { SqlDatabase } from "../database.ts"
+import type { Source, SourceBlock } from "../source/index.ts"
+import type { DependencyContext } from "../dependencies.ts"
+import type { HtmlRewriteRule } from "../environment.ts"
+import type { Principal } from "../authority/model.ts"
+import type { QueryRequest } from "../query/model.ts"
+import type { SourceCapability } from "../authority/access.ts"
+import { SourceDiagnosticError } from "../source-diagnostic.ts"
+import type {
+  AppContext,
+  PluginContext,
+  PluginLog,
+  ServerGraph,
+} from "./types.ts"
+
+export function createPluginLog(log: Log, plugin: string): PluginLog {
+  const write =
+    (level: "debug" | "info" | "warn" | "error") =>
+    (message: string, context?: Record<string, unknown>) =>
+      log[level](`${plugin}.${message}`, context)
+  return Object.freeze({
+    debug: write("debug"),
+    info: write("info"),
+    warn: write("warn"),
+    error: write("error"),
+  })
+}
+
+function graphContext(engine: Engine): ServerGraph {
+  return Object.freeze({
+    linksFrom: (path: string) => [...engine.graph.linksFrom(path)],
+    linksTo: (path: string) => [...engine.graph.linksTo(path)],
+    neighbors: (path: string) => engine.graph.neighbors(path),
+    backlinks: (path: string) => engine.graph.backlinks(path),
+  })
+}
+
+function source(engine: Engine, idOrPath: string) {
+  return (
+    engine.resolve(idOrPath) ??
+    engine.repo.get(idOrPath) ??
+    engine.repo.atPath(idOrPath)
+  )
+}
+
+/** @internal Bind one Plugin's lifecycle resources to an Engine. */
+export function createPluginContext(
+  plugin: string,
+  engine: Engine,
+  database?: SqlDatabase,
+): PluginContext {
+  return Object.freeze({
+    plugin,
+    log: createPluginLog(engine.log, plugin),
+    runtime: engine.runtime,
+    database,
+  })
+}
+
+/** @internal Add request-independent application capabilities after setup. */
+export function createAppContext(
+  context: PluginContext,
+  engine: Engine,
+  components: AppContext["components"],
+): AppContext {
+  return Object.freeze({
+    ...context,
+    schema: engine.schema,
+    query: Object.freeze({
+      prepare: (query: string, request?: QueryRequest<unknown>) =>
+        engine.queries.prepare(query, request),
+    }),
+    yaml: engine.environment.yaml,
+    sources: Object.freeze({
+      get: (idOrPath: string) => source(engine, idOrPath),
+      all: () => engine.repo.all(),
+      resolve: (pathname: string) => engine.resolve(pathname),
+      path: (value: string) => engine.repo.graphPath(value),
+      isPage: (candidate: Source) => engine.isPage(candidate),
+      builtPages: () => [...engine.pageCache.values()],
+    }),
+    graph: graphContext(engine),
+    actors: Object.freeze({
+      profile: (actorId: string) => engine.profiles.findById(actorId)?.profile,
+      homeActorId: (path: string) => engine.homeActorId(path),
+    }),
+    access: Object.freeze({
+      read: (principal: Principal, target: Source | string) =>
+        engine.readAccess(principal, target),
+      can: (
+        principal: Principal,
+        target: Source | string,
+        capability: SourceCapability,
+      ) => engine.hasSourceCapability(principal, target, capability),
+      canEmbed: (container: string, dependency: string) =>
+        engine.canEmbed(container, dependency),
+    }),
+    assets: Object.freeze({
+      load: (url: URL) => engine.environment.loadAsset(url),
+      publish: (name: string, blob: Blob, contentType?: string) =>
+        engine.publishAsset(name, blob, contentType),
+    }),
+    html: Object.freeze({
+      rewrite: (html: string, rules: readonly HtmlRewriteRule[]) =>
+        engine.environment.rewriteHtml(html, rules),
+    }),
+    compile: Object.freeze({
+      block: (
+        source: Source,
+        block: SourceBlock,
+        dependencies?: DependencyContext,
+        options?: { id?: string },
+      ) =>
+        engine.compileBlock(source, block, dependencies, options, "embedded"),
+      document: (source: Source, dependencies: DependencyContext) =>
+        engine.compileDocument(source, dependencies, context.plugin),
+    }),
+    components,
+    diagnostics: Object.freeze({
+      invalid(source: Source, message: string): never {
+        throw new SourceDiagnosticError({
+          source: source.path,
+          plugin: context.plugin,
+          message,
+        })
+      },
+    }),
+  })
+}

package/plugins/datatype/OFL.txt

@@ -0,0 +1,96 @@
+Copyright 2026 The Datatype Project Authors (https://github.com/franktisellano/datatype)
+
+This font includes glyphs from IBM Plex™ Mono:
+Copyright 2017 IBM Corp. with Reserved Font Name "Plex"
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+https://openfontlicense.org
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded,
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.