write-language 0.1.296 → 0.1.298

package/src/index.ts

@@ -1,42 +1,42 @@
-/**
- * @fileoverview Language Generation Module
- *
- * Centralized exports for AI language model response generation using Vercel AI SDK.
- * Provides prompt templates, model registries, provider factories, and response
- * generation functions for 10+ LLM providers.
- *
- * @module language-generation
- * @author ai-research-agent contributors
- */
-
-export {
-  writeLanguageResponse,
-  convertMarkdownToHTMLEscaped,
-} from "./generate-response";
-
-export type {
-  LLMProviderName,
-  GenerateLanguageOptions,
-  GenerateLanguageResult,
-  LanguageAttachment,
-} from "./generate-response";
-
-export type {
-  AgentPrompt,
-  AgentTool,
-} from "./generation-types";
-
-export { AGENT_PROMPTS, extractJSONFromLanguageReply } from "./prompt-templates";
-export {
-  LANGUAGE_MODELS,
-  LANGUAGE_PROVIDERS,
-  getModelsByProvider,
-  getAllModels,
-  getModelsByCapability,
-  getTextOnlyModels,
-  getMultimodalModels,
-} from "./language-model-registry";
-export type { ModelCapability, ModelInfo } from "./language-model-registry";
-export { createLLMProvider } from "./provider-factory";
-export { convertMarkdownToHTMLEscaped as markdownToHTML } from "./utils/markdown-to-html";
-export { highlightCode, Prism } from "./utils/prism";
+/**
+ * @fileoverview Language Generation Module
+ *
+ * Centralized exports for AI language model response generation using Vercel AI SDK.
+ * Provides prompt templates, model registries, provider factories, and response
+ * generation functions for 10+ LLM providers.
+ *
+ * @module language-generation
+ * @author ai-research-agent contributors
+ */
+
+export {
+  writeLanguageResponse,
+  convertMarkdownToHTMLEscaped,
+} from "./generate-response";
+
+export type {
+  LLMProviderName,
+  GenerateLanguageOptions,
+  GenerateLanguageResult,
+  LanguageAttachment,
+} from "./generate-response";
+
+export type {
+  AgentPrompt,
+  AgentTool,
+} from "./generation-types";
+
+export { AGENT_PROMPTS, extractJSONFromLanguageReply } from "./prompt-templates";
+export {
+  LANGUAGE_MODELS,
+  LANGUAGE_PROVIDERS,
+  getModelsByProvider,
+  getAllModels,
+  getModelsByCapability,
+  getTextOnlyModels,
+  getMultimodalModels,
+} from "./language-model-registry";
+export type { ModelCapability, ModelInfo } from "./language-model-registry";
+export { createLLMProvider } from "./provider-factory";
+export { convertMarkdownToHTMLEscaped as markdownToHTML } from "./utils/markdown-to-html";
+export { highlightCode, hljs } from "./utils/highlight";

package/src/utils/highlight.ts

@@ -0,0 +1,58 @@
+/**
+ * @fileoverview Syntax highlighting for fenced code blocks, on highlight.js'
+ * core build with an explicit set of languages.
+ *
+ * Every language below is an ordinary ES module import, registered
+ * synchronously when this module loads, so there is no global to publish and
+ * no load order to protect. Only the core and the listed grammars are bundled,
+ * not highlight.js' full set of ~190 languages, which keeps the Worker bundles
+ * that pull this package in small.
+ */
+import hljs from "highlight.js/lib/core";
+import bash from "highlight.js/lib/languages/bash";
+import c from "highlight.js/lib/languages/c";
+import cpp from "highlight.js/lib/languages/cpp";
+import css from "highlight.js/lib/languages/css";
+import go from "highlight.js/lib/languages/go";
+import java from "highlight.js/lib/languages/java";
+import javascript from "highlight.js/lib/languages/javascript";
+import json from "highlight.js/lib/languages/json";
+import markdown from "highlight.js/lib/languages/markdown";
+import python from "highlight.js/lib/languages/python";
+import rust from "highlight.js/lib/languages/rust";
+import sql from "highlight.js/lib/languages/sql";
+import typescript from "highlight.js/lib/languages/typescript";
+import xml from "highlight.js/lib/languages/xml";
+import yaml from "highlight.js/lib/languages/yaml";
+
+hljs.registerLanguage("bash", bash);
+hljs.registerLanguage("c", c);
+hljs.registerLanguage("cpp", cpp);
+hljs.registerLanguage("css", css);
+hljs.registerLanguage("go", go);
+hljs.registerLanguage("java", java);
+hljs.registerLanguage("javascript", javascript);
+hljs.registerLanguage("json", json);
+hljs.registerLanguage("markdown", markdown);
+hljs.registerLanguage("python", python);
+hljs.registerLanguage("rust", rust);
+hljs.registerLanguage("sql", sql);
+hljs.registerLanguage("typescript", typescript);
+hljs.registerLanguage("xml", xml);
+hljs.registerLanguage("yaml", yaml);
+// highlight.js' JavaScript and TypeScript grammars already understand JSX.
+hljs.registerAliases(["jsx"], { languageName: "javascript" });
+hljs.registerAliases(["tsx"], { languageName: "typescript" });
+hljs.registerAliases(["markup"], { languageName: "xml" });
+
+/**
+ * Highlights `code` as `lang`, returning HTML made of `hljs-*` spans, or
+ * `null` when `lang` is not a registered language or alias — callers render
+ * that block escaped and unhighlighted.
+ */
+export function highlightCode(code: string, lang: string): string | null {
+  if (!lang || !hljs.getLanguage(lang)) return null;
+  return hljs.highlight(code, { language: lang, ignoreIllegals: true }).value;
+}
+
+export { hljs };

package/src/utils/markdown-to-html.ts

@@ -1,9 +1,9 @@
 /**
  * @module research/agents/markdown-to-html
- * @description Converts Markdown to HTML with Prism.js syntax highlighting.
+ * @description Converts Markdown to HTML with highlight.js syntax highlighting.
  */
 import { marked } from "marked";
-import { highlightCode } from "./prism";
+import { highlightCode } from "./highlight";
 import { encode, decode } from "html-entities";
 
 // Inline onclick: self-contained per button, works in dangerouslySetInnerHTML contexts
@@ -40,7 +40,7 @@ marked.use({
 });
 
 /**
- * Convert markdown text to HTML with Prism.js syntax highlighting.
+ * Convert markdown text to HTML with highlight.js syntax highlighting.
  * Unescapes HTML entities like `&` → `&`.
  */
 export async function convertMarkdownToHTMLEscaped(

package/dist/utils/prism-global.d.ts

@@ -1,12 +0,0 @@
-import { default as Prism } from 'prismjs';
-/**
- * Registers the grammars above, once per runtime. Cheap to call repeatedly —
- * callers are meant to invoke it wherever they are about to highlight, so that
- * the work does not hinge on a module-level statement surviving tree-shaking.
- *
- * Never rejects: a grammar that fails to load just leaves its language out of
- * `Prism.languages`, which every caller already treats as "render this block
- * unhighlighted".
- */
-export declare function loadPrismGrammars(): Promise<void>;
-export default Prism;

package/dist/utils/prism.d.ts

@@ -1,3 +0,0 @@
-import { default as Prism } from './prism-global';
-export declare function highlightCode(code: string, lang: string): string | null;
-export { Prism };

package/src/utils/prism-global.ts

@@ -1,81 +0,0 @@
-/**
- * @fileoverview Owns the Prism instance: publishes it on `globalThis`, then
- * registers the language grammars that prismjs' own entry point leaves out —
- * without ever depending on module evaluation order.
- *
- * The `prismjs/components/*` files are plain browser scripts, not modules:
- * `prism-markup.js` literally opens with `Prism.languages.markup = {...}`,
- * resolving `Prism` as a free variable off the global object. Someone has to
- * put it there first. prismjs' own entry point does that for `window`
- * (browser) and `global` (Node); on Cloudflare Workers / edge runtimes it sees
- * neither, which is what the assignment below is for.
- *
- * Publishing it is only half the job, though: it has to happen *before* the
- * grammar scripts run, and a static `import "prismjs/components/..."` cannot
- * promise that once a bundler is in the loop. Those files declare no
- * dependency on Prism — reading a global is invisible to the module graph — so
- * nothing pins them after whoever publishes it, and a bundler is free to hoist
- * them, split them into another chunk, or drop the publishing statement as a
- * dead `globalThis` write. When that happens the chunk dies on load with
- * `ReferenceError: Prism is not defined`, which takes down the whole route
- * that lazily imported it rather than just the syntax highlighting.
- *
- * So the grammars are loaded with `import()` from inside `loadPrismGrammars()`
- * instead. The global is published by a statement earlier in that same
- * function body, which makes the ordering a runtime fact rather than a promise
- * the bundler has to keep.
- */
-import Prism from "prismjs";
-
-/**
- * The grammars to register, in order — several extend an earlier one, so this
- * list is loaded sequentially rather than in parallel (`tsx` needs `jsx` and
- * `typescript`; `cpp` needs `c`). Markup, CSS, C-like and JavaScript are
- * absent because prismjs' entry point already bundles them.
- */
-const GRAMMARS: ReadonlyArray<() => Promise<unknown>> = [
-  () => import("prismjs/components/prism-typescript.js"),
-  () => import("prismjs/components/prism-jsx.js"),
-  () => import("prismjs/components/prism-tsx.js"),
-  () => import("prismjs/components/prism-python.js"),
-  () => import("prismjs/components/prism-bash.js"),
-  () => import("prismjs/components/prism-json.js"),
-  () => import("prismjs/components/prism-yaml.js"),
-  () => import("prismjs/components/prism-markdown.js"),
-  () => import("prismjs/components/prism-sql.js"),
-  () => import("prismjs/components/prism-rust.js"),
-  () => import("prismjs/components/prism-go.js"),
-  () => import("prismjs/components/prism-java.js"),
-  () => import("prismjs/components/prism-c.js"),
-  () => import("prismjs/components/prism-cpp.js"),
-];
-
-/** Puts Prism where the grammar scripts look for it. Idempotent. */
-function publishPrismGlobal(): void {
-  (globalThis as typeof globalThis & { Prism?: typeof Prism }).Prism ??= Prism;
-}
-
-publishPrismGlobal();
-
-let loading: Promise<void> | undefined;
-
-/**
- * Registers the grammars above, once per runtime. Cheap to call repeatedly —
- * callers are meant to invoke it wherever they are about to highlight, so that
- * the work does not hinge on a module-level statement surviving tree-shaking.
- *
- * Never rejects: a grammar that fails to load just leaves its language out of
- * `Prism.languages`, which every caller already treats as "render this block
- * unhighlighted".
- */
-export function loadPrismGrammars(): Promise<void> {
-  loading ??= (async () => {
-    publishPrismGlobal();
-    for (const load of GRAMMARS) {
-      await load();
-    }
-  })().catch(() => {});
-  return loading;
-}
-
-export default Prism;

package/src/utils/prism.ts

@@ -1,20 +0,0 @@
-/**
- * @fileoverview Exposes a small `highlightCode` helper used by
- * markdown-to-html.ts for code-block syntax highlighting. The Prism instance
- * and its language grammars are owned by `prism-global.ts`.
- */
-import Prism, { loadPrismGrammars } from "./prism-global";
-
-// Start the grammars loading now, and again from `highlightCode` below — the
-// second call is what guarantees they are requested at all, since a bundler is
-// free to drop this one as a side effect of a module it thinks is pure.
-void loadPrismGrammars();
-
-export function highlightCode(code: string, lang: string): string | null {
-  void loadPrismGrammars();
-  const grammar = Prism.languages[lang];
-  if (!grammar) return null;
-  return Prism.highlight(code, grammar, lang);
-}
-
-export { Prism };