@ai-gui/core 0.20.1 → 0.21.0

package/dist/index.cjs

@@ -1721,6 +1721,115 @@ function normalizeLineEndings(src) {
 	return src.replace(/\r\n|\r/g, "\n");
 }
 
+//#endregion
+//#region src/plugin-styles.ts
+/**
+* The stylesheet every renderer needs regardless of which plugins are loaded.
+*
+* Model output is written without knowing the viewport, so a wide table, a long code line or a
+* diagram sized for a desktop will otherwise push the page sideways on a phone. Each block is
+* made to scroll inside its own box instead of widening the column that holds it.
+*/
+const baseCss = [
+	"[data-aigui-renderer]{max-width:100%}",
+	"[data-aigui-renderer] img,[data-aigui-renderer] svg,[data-aigui-renderer] video,[data-aigui-renderer] canvas{max-width:100%;height:auto}",
+	"[data-aigui-renderer] pre{max-width:100%;overflow-x:auto}",
+	"[data-aigui-renderer] code{overflow-wrap:anywhere}",
+	"[data-aigui-renderer] pre code{overflow-wrap:normal}",
+	"[data-aigui-renderer] table{display:block;max-width:100%;overflow-x:auto;border-collapse:collapse}",
+	"[data-aigui-renderer] p,[data-aigui-renderer] li,[data-aigui-renderer] h1,[data-aigui-renderer] h2,[data-aigui-renderer] h3{overflow-wrap:break-word}",
+	"[data-aigui-renderer] a{overflow-wrap:anywhere}",
+	"[data-aigui-renderer] [data-aigui-chart],[data-aigui-renderer] [data-aigui-mermaid],[data-aigui-renderer] [data-aigui-map],[data-aigui-renderer] [data-aigui-molecule]{max-width:100%;overflow-x:auto}"
+].join("");
+/**
+* Collect the stylesheets of the given plugins, base styles first.
+*
+* Plugins declare `css` but cannot inject it themselves — they never see the document. Each
+* plugin appears once even if it is passed twice, and later plugins of the same name win, which
+* matches how `collectNodeRenderers` resolves duplicates.
+*/
+function collectPluginStyles(plugins) {
+	const styles = new Map();
+	styles.set("base", baseCss);
+	for (const plugin of plugins ?? []) {
+		const css = plugin?.css?.trim();
+		if (!css) continue;
+		if (css.startsWith("@import") && !/@import\s+url\(|@import\s+["'](?:https?:)?\/\//.test(css)) continue;
+		styles.set(plugin.name, css);
+	}
+	return [...styles].map(([name, css]) => ({
+		name,
+		css
+	}));
+}
+const STYLE_ATTR = "data-aigui-style";
+/**
+* Put the plugins' stylesheets in the document, once each.
+*
+* Called on every render by every renderer on the page, so it must be idempotent: a stylesheet
+* already present is left alone rather than duplicated. No-ops without a document, which is what
+* server-side rendering gets.
+*/
+function injectPluginStyles(plugins, doc) {
+	const target = doc ?? (typeof document === "undefined" ? void 0 : document);
+	if (!target?.head) return;
+	for (const { name, css } of collectPluginStyles(plugins)) {
+		if (target.querySelector(`style[${STYLE_ATTR}="${CSS_ESCAPE(name)}"]`)) continue;
+		const el = target.createElement("style");
+		el.setAttribute(STYLE_ATTR, name);
+		el.textContent = css;
+		target.head.appendChild(el);
+	}
+}
+/** Quote a plugin name for use inside an attribute selector. */
+function CSS_ESCAPE(name) {
+	return name.replace(/["\\]/g, "\\$&");
+}
+
+//#endregion
+//#region src/i18n.ts
+/** The default locale, used when a host does not say otherwise. */
+const DEFAULT_LOCALE = "en";
+/**
+* Pick the messages for a locale: exact match, then the base language, then English.
+*
+* "zh-CN" therefore finds a "zh-CN" bundle, falls back to "zh", and finally to English — a host
+* asking for a regional variant nobody translated still gets the language.
+*/
+function resolveMessages(bundle, locale) {
+	const en = bundle.en ?? {};
+	if (!locale) return en;
+	const exact = bundle[locale];
+	if (exact) return {
+		...en,
+		...exact
+	};
+	const base = locale.split("-")[0];
+	const language = base && base !== locale ? bundle[base] : void 0;
+	return language ? {
+		...en,
+		...language
+	} : en;
+}
+/** Look up one string, falling back to English and finally to the key itself. */
+function translate(bundle, locale, key) {
+	return resolveMessages(bundle, locale)[key] ?? key;
+}
+/**
+* A lookup function bound to one bundle and locale.
+*
+* Plugins render many strings per node, so resolving the bundle once and closing over it keeps
+* the per-string cost to a map lookup.
+*/
+function translator(bundle, locale) {
+	const messages = resolveMessages(bundle, locale);
+	return (key) => messages[key] ?? key;
+}
+/** The locales a bundle actually carries. */
+function availableLocales(bundle) {
+	return Object.keys(bundle);
+}
+
 //#endregion
 //#region src/export-image.ts
 /** The intrinsic size of an SVG element, falling back to its attributes and then to a default. */
@@ -2396,7 +2505,7 @@ function buildSystemPrompt(options = {}) {
 	const cardSpec = options.registry?.toPromptSpec();
 	if (cardSpec) parts.push(cardSpec);
 	for (const plugin of options.plugins ?? []) {
-		const spec = typeof plugin.promptSpec === "function" ? plugin.promptSpec() : plugin.promptSpec;
+		const spec = typeof plugin.promptSpec === "function" ? plugin.promptSpec(options.locale) : plugin.promptSpec;
 		if (spec) parts.push(spec);
 	}
 	return parts.join("\n\n");
@@ -2711,13 +2820,17 @@ exports.CardStore = CardStore
 exports.CardStoreError = CardStoreError
 exports.CardTypeConflictError = CardTypeConflictError
 exports.CardValidationError = CardValidationError
+exports.DEFAULT_LOCALE = DEFAULT_LOCALE
 exports.DebugEmitter = DebugEmitter
 exports.Renderer = Renderer
 exports.StreamRouter = StreamRouter
 exports.actionOutcome = actionOutcome
 exports.applyPatches = applyPatches
+exports.availableLocales = availableLocales
+exports.baseCss = baseCss
 exports.buildSystemPrompt = buildSystemPrompt
 exports.collectNodeRenderers = collectNodeRenderers
+exports.collectPluginStyles = collectPluginStyles
 exports.contentDeltas = contentDeltas
 exports.createActionRuntime = createActionRuntime
 exports.createParser = createParser
@@ -2728,6 +2841,7 @@ exports.exportRenderedImages = exportRenderedImages
 exports.exportSVGToImage = exportSVGToImage
 exports.getActionKey = getActionKey
 exports.getIdleActionState = getIdleActionState
+exports.injectPluginStyles = injectPluginStyles
 exports.isCardPatchResult = isCardPatchResult
 exports.jsonLines = jsonLines
 exports.mockModelStream = mockModelStream
@@ -2737,8 +2851,11 @@ exports.parseSSE = parseSSE
 exports.pluginNodeTypes = pluginNodeTypes
 exports.readableBytes = readableBytes
 exports.repairMarkdown = repairMarkdown
+exports.resolveMessages = resolveMessages
 exports.safeDebugValue = safeDebugValue
 exports.sanitizeHtml = sanitizeHtml
 exports.sanitizeRenderedHtml = sanitizeRenderedHtml
 exports.textLines = textLines
+exports.translate = translate
+exports.translator = translator
 exports.validateJSONSchema = validateJSONSchema

package/dist/index.d.cts

@@ -203,6 +203,14 @@ interface NodeRenderContext {
    * with white plot areas.
    */
   readonly theme?: string;
+  /**
+   * The host's locale as a BCP-47 tag, e.g. "zh-CN".
+   *
+   * A plugin draws its own labels — a Copy button, an error line — and cannot read the page's
+   * language, so without this a Chinese product renders English chrome around Chinese content.
+   * English is the fallback for anything a plugin has not translated.
+   */
+  readonly locale?: string;
 }
 type NodeRenderer = (node: ASTNode, context?: NodeRenderContext) => RenderOutput | Promise<RenderOutput>;
 interface PluginCommitContext {
@@ -244,8 +252,14 @@ interface AIGuiPlugin {
   /** Runs synchronously after the AST is finalized and before patches are dispatched. */
   onASTCommit?: (nodes: readonly ASTNode[], context: PluginCommitContext) => void;
   css?: string;
-  /** LLM-facing guidance describing this plugin's fence syntax. */
-  promptSpec?: string | (() => string);
+  /**
+   * LLM-facing guidance describing this plugin's fence syntax.
+   *
+   * Receives the locale asked of `buildSystemPrompt`, so the rules can be written in the language
+   * the product answers in — a Chinese persona followed by English rules reads as a contradiction
+   * to the model. Plugins that only ship English simply ignore the argument.
+   */
+  promptSpec?: string | ((locale?: string) => string);
 }
 interface RendererOptions extends DebugOptions {
   registry?: CardRegistry;
@@ -627,6 +641,76 @@ declare function collectNodeRenderers(plugins?: AIGuiPlugin[], debugOptions?: Co
 /** The set of node types claimed by the given plugins. */
 declare function pluginNodeTypes(plugins?: AIGuiPlugin[]): Set<string>;
 
+//#endregion
+//#region src/plugin-styles.d.ts
+/**
+ * The stylesheet every renderer needs regardless of which plugins are loaded.
+ *
+ * Model output is written without knowing the viewport, so a wide table, a long code line or a
+ * diagram sized for a desktop will otherwise push the page sideways on a phone. Each block is
+ * made to scroll inside its own box instead of widening the column that holds it.
+ */
+declare const baseCss: string;
+/** One plugin's stylesheet, keyed by the plugin that owns it. */
+interface PluginStyle {
+  name: string;
+  css: string;
+}
+/**
+ * Collect the stylesheets of the given plugins, base styles first.
+ *
+ * Plugins declare `css` but cannot inject it themselves — they never see the document. Each
+ * plugin appears once even if it is passed twice, and later plugins of the same name win, which
+ * matches how `collectNodeRenderers` resolves duplicates.
+ */
+declare function collectPluginStyles(plugins?: AIGuiPlugin[]): PluginStyle[];
+/**
+ * Put the plugins' stylesheets in the document, once each.
+ *
+ * Called on every render by every renderer on the page, so it must be idempotent: a stylesheet
+ * already present is left alone rather than duplicated. No-ops without a document, which is what
+ * server-side rendering gets.
+ */
+declare function injectPluginStyles(plugins?: AIGuiPlugin[], doc?: Document): void;
+
+//#endregion
+//#region src/i18n.d.ts
+/**
+ * Locale handling for both sides of a rendered answer: the strings a plugin draws on screen, and
+ * the guidance a plugin gives the model.
+ *
+ * Locales are BCP-47 tags ("zh-CN", "pt-BR", "en"). English is the fallback and is always
+ * complete, so a partial translation degrades to English strings rather than to blank UI.
+ */
+/** A locale tag, e.g. "en", "zh-CN". */
+type Locale = string;
+/** The strings of one locale, keyed by a stable id the plugin chooses. */
+type Messages = Record<string, string>;
+/** Every locale a plugin ships, keyed by tag. `en` is required as the fallback. */
+type MessageBundle = Record<Locale, Messages> & {
+  en: Messages;
+};
+/** The default locale, used when a host does not say otherwise. */
+declare const DEFAULT_LOCALE = "en";
+/**
+ * Pick the messages for a locale: exact match, then the base language, then English.
+ *
+ * "zh-CN" therefore finds a "zh-CN" bundle, falls back to "zh", and finally to English — a host
+ * asking for a regional variant nobody translated still gets the language.
+ */
+declare function resolveMessages(bundle: MessageBundle, locale?: Locale): Messages;
+/** Look up one string, falling back to English and finally to the key itself. */
+declare function translate(bundle: MessageBundle, locale: Locale | undefined, key: string): string;
+/**
+ * A lookup function bound to one bundle and locale.
+ *
+ * Plugins render many strings per node, so resolving the bundle once and closing over it keeps
+ * the per-string cost to a map lookup.
+ */
+declare function translator(bundle: MessageBundle, locale?: Locale): (key: string) => string;
+/** The locales a bundle actually carries. */
+declare function availableLocales(bundle: MessageBundle): Locale[];
+
 //#endregion
 //#region src/export-image.d.ts
 /**
@@ -760,6 +844,14 @@ interface BuildSystemPromptOptions {
   base?: string;
   registry?: CardRegistry;
   plugins?: AIGuiPlugin[];
+  /**
+   * The locale to write the guidance in, as a BCP-47 tag, e.g. "zh-CN".
+   *
+   * A product whose persona says "always answer in Chinese" ends up appending English rules to
+   * it, which reads as a contradiction. Plugins fall back to English for locales they have not
+   * been translated into.
+   */
+  locale?: string;
 }
 /**
  * Assembles the LLM system-prompt guidance: an optional base, the registered
@@ -830,4 +922,4 @@ declare function mockModelStream(events: Iterable<ModelStreamEvent> | AsyncItera
 declare function readableBytes(chunks: Iterable<string | Uint8Array> | AsyncIterable<string | Uint8Array>): ReadableStream<Uint8Array>;
 
 //#endregion
-export { AIGuiPlugin, ASTNode, ActionAbortedError, ActionAlreadyRegisteredError, ActionContext, ActionDefinition, ActionDestroyedError, ActionDispatchOptions, ActionErrorEvent, ActionEventBase, ActionExecutionError, ActionNotFoundError, ActionOutcome, ActionRegisterOptions, ActionRegistry, ActionRequest, ActionRuntime, ActionRuntimeError, ActionRuntimeOptions, ActionStartEvent, ActionState, ActionStateListener, ActionStatus, ActionSuccessEvent, ActionTimeoutError, ActionValidationError, BuildSystemPromptOptions, ByteStreamSource, CARD_ID_MAX_LENGTH, CARD_JSON_MAX_DEPTH, CARD_JSON_MAX_NODES, CARD_PATCH_BATCH_MAX_SIZE, CardAction, CardActionError, CardDef, CardJSONError, CardLimitError, CardListener, CardNotFoundError, CardParseResult, CardPatch, CardPatchBatch, CardPatchResult, CardRecord, CardRegistry, CardRevisionConflictError, CardSnapshot, CardSnapshotError, CardStore, CardStoreError, CardStoreListener, CardStoreOptions, CardTypeConflictError, CardValidationError, ChannelSink, Citation, CollectNodeRendererOptions, DebugEmitter, DebugEvent, DebugEventListener, DebugEventTarget, DebugInstrumentationTarget, DebugOptions, DebugRedactContext, DebugSource, ExportImageOptions, ExportedImage, FeedChunk, FeedOptions, FeedSource, JSONSchema, JSONSchemaValidationResult, ModelStreamEvent, MountCardSlotRequest, MountedCardSlot, NodeRenderContext, NodeRenderer, OutcomeTone, ParseResult, ParserOptions, PartialJSONResult, Patch, PluginCommitContext, RenderMountContext, RenderOutput, Renderer, RendererOptions, SSEEvent, SSEOptions, SafeDebugValueOptions, SanitizeHtmlOptions, SanitizeSetting, SourceBlock, StreamParseOptions, StreamRouter, Usage, actionOutcome, applyPatches, buildSystemPrompt, collectNodeRenderers, contentDeltas, createActionRuntime, createParser, createParserWithMetadata, diffAst, downloadImage, exportRenderedImages, exportSVGToImage, getActionKey, getIdleActionState, isCardPatchResult, jsonLines, mockModelStream, ndjson, parsePartialJSON, parseSSE, pluginNodeTypes, readableBytes, repairMarkdown, safeDebugValue, sanitizeHtml, sanitizeRenderedHtml, textLines, validateJSONSchema };
+export { AIGuiPlugin, ASTNode, ActionAbortedError, ActionAlreadyRegisteredError, ActionContext, ActionDefinition, ActionDestroyedError, ActionDispatchOptions, ActionErrorEvent, ActionEventBase, ActionExecutionError, ActionNotFoundError, ActionOutcome, ActionRegisterOptions, ActionRegistry, ActionRequest, ActionRuntime, ActionRuntimeError, ActionRuntimeOptions, ActionStartEvent, ActionState, ActionStateListener, ActionStatus, ActionSuccessEvent, ActionTimeoutError, ActionValidationError, BuildSystemPromptOptions, ByteStreamSource, CARD_ID_MAX_LENGTH, CARD_JSON_MAX_DEPTH, CARD_JSON_MAX_NODES, CARD_PATCH_BATCH_MAX_SIZE, CardAction, CardActionError, CardDef, CardJSONError, CardLimitError, CardListener, CardNotFoundError, CardParseResult, CardPatch, CardPatchBatch, CardPatchResult, CardRecord, CardRegistry, CardRevisionConflictError, CardSnapshot, CardSnapshotError, CardStore, CardStoreError, CardStoreListener, CardStoreOptions, CardTypeConflictError, CardValidationError, ChannelSink, Citation, CollectNodeRendererOptions, DEFAULT_LOCALE, DebugEmitter, DebugEvent, DebugEventListener, DebugEventTarget, DebugInstrumentationTarget, DebugOptions, DebugRedactContext, DebugSource, ExportImageOptions, ExportedImage, FeedChunk, FeedOptions, FeedSource, JSONSchema, JSONSchemaValidationResult, Locale, MessageBundle, Messages, ModelStreamEvent, MountCardSlotRequest, MountedCardSlot, NodeRenderContext, NodeRenderer, OutcomeTone, ParseResult, ParserOptions, PartialJSONResult, Patch, PluginCommitContext, PluginStyle, RenderMountContext, RenderOutput, Renderer, RendererOptions, SSEEvent, SSEOptions, SafeDebugValueOptions, SanitizeHtmlOptions, SanitizeSetting, SourceBlock, StreamParseOptions, StreamRouter, Usage, actionOutcome, applyPatches, availableLocales, baseCss, buildSystemPrompt, collectNodeRenderers, collectPluginStyles, contentDeltas, createActionRuntime, createParser, createParserWithMetadata, diffAst, downloadImage, exportRenderedImages, exportSVGToImage, getActionKey, getIdleActionState, injectPluginStyles, isCardPatchResult, jsonLines, mockModelStream, ndjson, parsePartialJSON, parseSSE, pluginNodeTypes, readableBytes, repairMarkdown, resolveMessages, safeDebugValue, sanitizeHtml, sanitizeRenderedHtml, textLines, translate, translator, validateJSONSchema };

package/dist/index.d.ts

@@ -203,6 +203,14 @@ interface NodeRenderContext {
    * with white plot areas.
    */
   readonly theme?: string;
+  /**
+   * The host's locale as a BCP-47 tag, e.g. "zh-CN".
+   *
+   * A plugin draws its own labels — a Copy button, an error line — and cannot read the page's
+   * language, so without this a Chinese product renders English chrome around Chinese content.
+   * English is the fallback for anything a plugin has not translated.
+   */
+  readonly locale?: string;
 }
 type NodeRenderer = (node: ASTNode, context?: NodeRenderContext) => RenderOutput | Promise<RenderOutput>;
 interface PluginCommitContext {
@@ -244,8 +252,14 @@ interface AIGuiPlugin {
   /** Runs synchronously after the AST is finalized and before patches are dispatched. */
   onASTCommit?: (nodes: readonly ASTNode[], context: PluginCommitContext) => void;
   css?: string;
-  /** LLM-facing guidance describing this plugin's fence syntax. */
-  promptSpec?: string | (() => string);
+  /**
+   * LLM-facing guidance describing this plugin's fence syntax.
+   *
+   * Receives the locale asked of `buildSystemPrompt`, so the rules can be written in the language
+   * the product answers in — a Chinese persona followed by English rules reads as a contradiction
+   * to the model. Plugins that only ship English simply ignore the argument.
+   */
+  promptSpec?: string | ((locale?: string) => string);
 }
 interface RendererOptions extends DebugOptions {
   registry?: CardRegistry;
@@ -627,6 +641,76 @@ declare function collectNodeRenderers(plugins?: AIGuiPlugin[], debugOptions?: Co
 /** The set of node types claimed by the given plugins. */
 declare function pluginNodeTypes(plugins?: AIGuiPlugin[]): Set<string>;
 
+//#endregion
+//#region src/plugin-styles.d.ts
+/**
+ * The stylesheet every renderer needs regardless of which plugins are loaded.
+ *
+ * Model output is written without knowing the viewport, so a wide table, a long code line or a
+ * diagram sized for a desktop will otherwise push the page sideways on a phone. Each block is
+ * made to scroll inside its own box instead of widening the column that holds it.
+ */
+declare const baseCss: string;
+/** One plugin's stylesheet, keyed by the plugin that owns it. */
+interface PluginStyle {
+  name: string;
+  css: string;
+}
+/**
+ * Collect the stylesheets of the given plugins, base styles first.
+ *
+ * Plugins declare `css` but cannot inject it themselves — they never see the document. Each
+ * plugin appears once even if it is passed twice, and later plugins of the same name win, which
+ * matches how `collectNodeRenderers` resolves duplicates.
+ */
+declare function collectPluginStyles(plugins?: AIGuiPlugin[]): PluginStyle[];
+/**
+ * Put the plugins' stylesheets in the document, once each.
+ *
+ * Called on every render by every renderer on the page, so it must be idempotent: a stylesheet
+ * already present is left alone rather than duplicated. No-ops without a document, which is what
+ * server-side rendering gets.
+ */
+declare function injectPluginStyles(plugins?: AIGuiPlugin[], doc?: Document): void;
+
+//#endregion
+//#region src/i18n.d.ts
+/**
+ * Locale handling for both sides of a rendered answer: the strings a plugin draws on screen, and
+ * the guidance a plugin gives the model.
+ *
+ * Locales are BCP-47 tags ("zh-CN", "pt-BR", "en"). English is the fallback and is always
+ * complete, so a partial translation degrades to English strings rather than to blank UI.
+ */
+/** A locale tag, e.g. "en", "zh-CN". */
+type Locale = string;
+/** The strings of one locale, keyed by a stable id the plugin chooses. */
+type Messages = Record<string, string>;
+/** Every locale a plugin ships, keyed by tag. `en` is required as the fallback. */
+type MessageBundle = Record<Locale, Messages> & {
+  en: Messages;
+};
+/** The default locale, used when a host does not say otherwise. */
+declare const DEFAULT_LOCALE = "en";
+/**
+ * Pick the messages for a locale: exact match, then the base language, then English.
+ *
+ * "zh-CN" therefore finds a "zh-CN" bundle, falls back to "zh", and finally to English — a host
+ * asking for a regional variant nobody translated still gets the language.
+ */
+declare function resolveMessages(bundle: MessageBundle, locale?: Locale): Messages;
+/** Look up one string, falling back to English and finally to the key itself. */
+declare function translate(bundle: MessageBundle, locale: Locale | undefined, key: string): string;
+/**
+ * A lookup function bound to one bundle and locale.
+ *
+ * Plugins render many strings per node, so resolving the bundle once and closing over it keeps
+ * the per-string cost to a map lookup.
+ */
+declare function translator(bundle: MessageBundle, locale?: Locale): (key: string) => string;
+/** The locales a bundle actually carries. */
+declare function availableLocales(bundle: MessageBundle): Locale[];
+
 //#endregion
 //#region src/export-image.d.ts
 /**
@@ -760,6 +844,14 @@ interface BuildSystemPromptOptions {
   base?: string;
   registry?: CardRegistry;
   plugins?: AIGuiPlugin[];
+  /**
+   * The locale to write the guidance in, as a BCP-47 tag, e.g. "zh-CN".
+   *
+   * A product whose persona says "always answer in Chinese" ends up appending English rules to
+   * it, which reads as a contradiction. Plugins fall back to English for locales they have not
+   * been translated into.
+   */
+  locale?: string;
 }
 /**
  * Assembles the LLM system-prompt guidance: an optional base, the registered
@@ -830,4 +922,4 @@ declare function mockModelStream(events: Iterable<ModelStreamEvent> | AsyncItera
 declare function readableBytes(chunks: Iterable<string | Uint8Array> | AsyncIterable<string | Uint8Array>): ReadableStream<Uint8Array>;
 
 //#endregion
-export { AIGuiPlugin, ASTNode, ActionAbortedError, ActionAlreadyRegisteredError, ActionContext, ActionDefinition, ActionDestroyedError, ActionDispatchOptions, ActionErrorEvent, ActionEventBase, ActionExecutionError, ActionNotFoundError, ActionOutcome, ActionRegisterOptions, ActionRegistry, ActionRequest, ActionRuntime, ActionRuntimeError, ActionRuntimeOptions, ActionStartEvent, ActionState, ActionStateListener, ActionStatus, ActionSuccessEvent, ActionTimeoutError, ActionValidationError, BuildSystemPromptOptions, ByteStreamSource, CARD_ID_MAX_LENGTH, CARD_JSON_MAX_DEPTH, CARD_JSON_MAX_NODES, CARD_PATCH_BATCH_MAX_SIZE, CardAction, CardActionError, CardDef, CardJSONError, CardLimitError, CardListener, CardNotFoundError, CardParseResult, CardPatch, CardPatchBatch, CardPatchResult, CardRecord, CardRegistry, CardRevisionConflictError, CardSnapshot, CardSnapshotError, CardStore, CardStoreError, CardStoreListener, CardStoreOptions, CardTypeConflictError, CardValidationError, ChannelSink, Citation, CollectNodeRendererOptions, DebugEmitter, DebugEvent, DebugEventListener, DebugEventTarget, DebugInstrumentationTarget, DebugOptions, DebugRedactContext, DebugSource, ExportImageOptions, ExportedImage, FeedChunk, FeedOptions, FeedSource, JSONSchema, JSONSchemaValidationResult, ModelStreamEvent, MountCardSlotRequest, MountedCardSlot, NodeRenderContext, NodeRenderer, OutcomeTone, ParseResult, ParserOptions, PartialJSONResult, Patch, PluginCommitContext, RenderMountContext, RenderOutput, Renderer, RendererOptions, SSEEvent, SSEOptions, SafeDebugValueOptions, SanitizeHtmlOptions, SanitizeSetting, SourceBlock, StreamParseOptions, StreamRouter, Usage, actionOutcome, applyPatches, buildSystemPrompt, collectNodeRenderers, contentDeltas, createActionRuntime, createParser, createParserWithMetadata, diffAst, downloadImage, exportRenderedImages, exportSVGToImage, getActionKey, getIdleActionState, isCardPatchResult, jsonLines, mockModelStream, ndjson, parsePartialJSON, parseSSE, pluginNodeTypes, readableBytes, repairMarkdown, safeDebugValue, sanitizeHtml, sanitizeRenderedHtml, textLines, validateJSONSchema };
+export { AIGuiPlugin, ASTNode, ActionAbortedError, ActionAlreadyRegisteredError, ActionContext, ActionDefinition, ActionDestroyedError, ActionDispatchOptions, ActionErrorEvent, ActionEventBase, ActionExecutionError, ActionNotFoundError, ActionOutcome, ActionRegisterOptions, ActionRegistry, ActionRequest, ActionRuntime, ActionRuntimeError, ActionRuntimeOptions, ActionStartEvent, ActionState, ActionStateListener, ActionStatus, ActionSuccessEvent, ActionTimeoutError, ActionValidationError, BuildSystemPromptOptions, ByteStreamSource, CARD_ID_MAX_LENGTH, CARD_JSON_MAX_DEPTH, CARD_JSON_MAX_NODES, CARD_PATCH_BATCH_MAX_SIZE, CardAction, CardActionError, CardDef, CardJSONError, CardLimitError, CardListener, CardNotFoundError, CardParseResult, CardPatch, CardPatchBatch, CardPatchResult, CardRecord, CardRegistry, CardRevisionConflictError, CardSnapshot, CardSnapshotError, CardStore, CardStoreError, CardStoreListener, CardStoreOptions, CardTypeConflictError, CardValidationError, ChannelSink, Citation, CollectNodeRendererOptions, DEFAULT_LOCALE, DebugEmitter, DebugEvent, DebugEventListener, DebugEventTarget, DebugInstrumentationTarget, DebugOptions, DebugRedactContext, DebugSource, ExportImageOptions, ExportedImage, FeedChunk, FeedOptions, FeedSource, JSONSchema, JSONSchemaValidationResult, Locale, MessageBundle, Messages, ModelStreamEvent, MountCardSlotRequest, MountedCardSlot, NodeRenderContext, NodeRenderer, OutcomeTone, ParseResult, ParserOptions, PartialJSONResult, Patch, PluginCommitContext, PluginStyle, RenderMountContext, RenderOutput, Renderer, RendererOptions, SSEEvent, SSEOptions, SafeDebugValueOptions, SanitizeHtmlOptions, SanitizeSetting, SourceBlock, StreamParseOptions, StreamRouter, Usage, actionOutcome, applyPatches, availableLocales, baseCss, buildSystemPrompt, collectNodeRenderers, collectPluginStyles, contentDeltas, createActionRuntime, createParser, createParserWithMetadata, diffAst, downloadImage, exportRenderedImages, exportSVGToImage, getActionKey, getIdleActionState, injectPluginStyles, isCardPatchResult, jsonLines, mockModelStream, ndjson, parsePartialJSON, parseSSE, pluginNodeTypes, readableBytes, repairMarkdown, resolveMessages, safeDebugValue, sanitizeHtml, sanitizeRenderedHtml, textLines, translate, translator, validateJSONSchema };

package/dist/index.js

@@ -1697,6 +1697,115 @@ function normalizeLineEndings(src) {
 	return src.replace(/\r\n|\r/g, "\n");
 }
 
+//#endregion
+//#region src/plugin-styles.ts
+/**
+* The stylesheet every renderer needs regardless of which plugins are loaded.
+*
+* Model output is written without knowing the viewport, so a wide table, a long code line or a
+* diagram sized for a desktop will otherwise push the page sideways on a phone. Each block is
+* made to scroll inside its own box instead of widening the column that holds it.
+*/
+const baseCss = [
+	"[data-aigui-renderer]{max-width:100%}",
+	"[data-aigui-renderer] img,[data-aigui-renderer] svg,[data-aigui-renderer] video,[data-aigui-renderer] canvas{max-width:100%;height:auto}",
+	"[data-aigui-renderer] pre{max-width:100%;overflow-x:auto}",
+	"[data-aigui-renderer] code{overflow-wrap:anywhere}",
+	"[data-aigui-renderer] pre code{overflow-wrap:normal}",
+	"[data-aigui-renderer] table{display:block;max-width:100%;overflow-x:auto;border-collapse:collapse}",
+	"[data-aigui-renderer] p,[data-aigui-renderer] li,[data-aigui-renderer] h1,[data-aigui-renderer] h2,[data-aigui-renderer] h3{overflow-wrap:break-word}",
+	"[data-aigui-renderer] a{overflow-wrap:anywhere}",
+	"[data-aigui-renderer] [data-aigui-chart],[data-aigui-renderer] [data-aigui-mermaid],[data-aigui-renderer] [data-aigui-map],[data-aigui-renderer] [data-aigui-molecule]{max-width:100%;overflow-x:auto}"
+].join("");
+/**
+* Collect the stylesheets of the given plugins, base styles first.
+*
+* Plugins declare `css` but cannot inject it themselves — they never see the document. Each
+* plugin appears once even if it is passed twice, and later plugins of the same name win, which
+* matches how `collectNodeRenderers` resolves duplicates.
+*/
+function collectPluginStyles(plugins) {
+	const styles = new Map();
+	styles.set("base", baseCss);
+	for (const plugin of plugins ?? []) {
+		const css = plugin?.css?.trim();
+		if (!css) continue;
+		if (css.startsWith("@import") && !/@import\s+url\(|@import\s+["'](?:https?:)?\/\//.test(css)) continue;
+		styles.set(plugin.name, css);
+	}
+	return [...styles].map(([name, css]) => ({
+		name,
+		css
+	}));
+}
+const STYLE_ATTR = "data-aigui-style";
+/**
+* Put the plugins' stylesheets in the document, once each.
+*
+* Called on every render by every renderer on the page, so it must be idempotent: a stylesheet
+* already present is left alone rather than duplicated. No-ops without a document, which is what
+* server-side rendering gets.
+*/
+function injectPluginStyles(plugins, doc) {
+	const target = doc ?? (typeof document === "undefined" ? void 0 : document);
+	if (!target?.head) return;
+	for (const { name, css } of collectPluginStyles(plugins)) {
+		if (target.querySelector(`style[${STYLE_ATTR}="${CSS_ESCAPE(name)}"]`)) continue;
+		const el = target.createElement("style");
+		el.setAttribute(STYLE_ATTR, name);
+		el.textContent = css;
+		target.head.appendChild(el);
+	}
+}
+/** Quote a plugin name for use inside an attribute selector. */
+function CSS_ESCAPE(name) {
+	return name.replace(/["\\]/g, "\\$&");
+}
+
+//#endregion
+//#region src/i18n.ts
+/** The default locale, used when a host does not say otherwise. */
+const DEFAULT_LOCALE = "en";
+/**
+* Pick the messages for a locale: exact match, then the base language, then English.
+*
+* "zh-CN" therefore finds a "zh-CN" bundle, falls back to "zh", and finally to English — a host
+* asking for a regional variant nobody translated still gets the language.
+*/
+function resolveMessages(bundle, locale) {
+	const en = bundle.en ?? {};
+	if (!locale) return en;
+	const exact = bundle[locale];
+	if (exact) return {
+		...en,
+		...exact
+	};
+	const base = locale.split("-")[0];
+	const language = base && base !== locale ? bundle[base] : void 0;
+	return language ? {
+		...en,
+		...language
+	} : en;
+}
+/** Look up one string, falling back to English and finally to the key itself. */
+function translate(bundle, locale, key) {
+	return resolveMessages(bundle, locale)[key] ?? key;
+}
+/**
+* A lookup function bound to one bundle and locale.
+*
+* Plugins render many strings per node, so resolving the bundle once and closing over it keeps
+* the per-string cost to a map lookup.
+*/
+function translator(bundle, locale) {
+	const messages = resolveMessages(bundle, locale);
+	return (key) => messages[key] ?? key;
+}
+/** The locales a bundle actually carries. */
+function availableLocales(bundle) {
+	return Object.keys(bundle);
+}
+
 //#endregion
 //#region src/export-image.ts
 /** The intrinsic size of an SVG element, falling back to its attributes and then to a default. */
@@ -2372,7 +2481,7 @@ function buildSystemPrompt(options = {}) {
 	const cardSpec = options.registry?.toPromptSpec();
 	if (cardSpec) parts.push(cardSpec);
 	for (const plugin of options.plugins ?? []) {
-		const spec = typeof plugin.promptSpec === "function" ? plugin.promptSpec() : plugin.promptSpec;
+		const spec = typeof plugin.promptSpec === "function" ? plugin.promptSpec(options.locale) : plugin.promptSpec;
 		if (spec) parts.push(spec);
 	}
 	return parts.join("\n\n");
@@ -2663,4 +2772,4 @@ function delay(ms, signal) {
 }
 
 //#endregion
-export { ActionAbortedError, ActionAlreadyRegisteredError, ActionDestroyedError, ActionExecutionError, ActionNotFoundError, ActionRegistry, ActionRuntime, ActionRuntimeError, ActionTimeoutError, ActionValidationError, CARD_ID_MAX_LENGTH, CARD_JSON_MAX_DEPTH, CARD_JSON_MAX_NODES, CARD_PATCH_BATCH_MAX_SIZE, CardJSONError, CardLimitError, CardNotFoundError, CardRegistry, CardRevisionConflictError, CardSnapshotError, CardStore, CardStoreError, CardTypeConflictError, CardValidationError, DebugEmitter, Renderer, StreamRouter, actionOutcome, applyPatches, buildSystemPrompt, collectNodeRenderers, contentDeltas, createActionRuntime, createParser, createParserWithMetadata, diffAst, downloadImage, exportRenderedImages, exportSVGToImage, getActionKey, getIdleActionState, isCardPatchResult, jsonLines, mockModelStream, ndjson, parsePartialJSON, parseSSE, pluginNodeTypes, readableBytes, repairMarkdown, safeDebugValue, sanitizeHtml, sanitizeRenderedHtml, textLines, validateJSONSchema };
+export { ActionAbortedError, ActionAlreadyRegisteredError, ActionDestroyedError, ActionExecutionError, ActionNotFoundError, ActionRegistry, ActionRuntime, ActionRuntimeError, ActionTimeoutError, ActionValidationError, CARD_ID_MAX_LENGTH, CARD_JSON_MAX_DEPTH, CARD_JSON_MAX_NODES, CARD_PATCH_BATCH_MAX_SIZE, CardJSONError, CardLimitError, CardNotFoundError, CardRegistry, CardRevisionConflictError, CardSnapshotError, CardStore, CardStoreError, CardTypeConflictError, CardValidationError, DEFAULT_LOCALE, DebugEmitter, Renderer, StreamRouter, actionOutcome, applyPatches, availableLocales, baseCss, buildSystemPrompt, collectNodeRenderers, collectPluginStyles, contentDeltas, createActionRuntime, createParser, createParserWithMetadata, diffAst, downloadImage, exportRenderedImages, exportSVGToImage, getActionKey, getIdleActionState, injectPluginStyles, isCardPatchResult, jsonLines, mockModelStream, ndjson, parsePartialJSON, parseSSE, pluginNodeTypes, readableBytes, repairMarkdown, resolveMessages, safeDebugValue, sanitizeHtml, sanitizeRenderedHtml, textLines, translate, translator, validateJSONSchema };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-gui/core",
-  "version": "0.20.1",
+  "version": "0.21.0",
   "description": "Headless streaming renderer core for LLM-generated UI — markdown/JSON repair, card registry, AST diff, plugin engine, sanitizer.",
   "keywords": [
     "llm",