@ai-gui/plugin-ui 0.4.4 → 0.6.0

package/dist/index.d.cts

@@ -27,9 +27,21 @@ interface ASTNode {
 /** Patch event produced by diffing. */
 
 /** Framework-neutral render descriptor returned by plugin node renderers. */
-type RenderOutput = {
+type RenderOutput =
+/**
+ * `trusted` marks markup the plugin built itself rather than markup taken from the model.
+ *
+ * A plugin that renders a diagram returns SVG, and sanitizing SVG escapes it — the reader gets
+ * the source text instead of the picture. Hosts worked around that by matching the plugin's
+ * internal id prefix with a regular expression, which breaks the moment the plugin renames its
+ * ids and lets any model output wearing that prefix through unsanitized. A plugin is code the
+ * host chose to install, so it can say so itself; a host that disagrees sets
+ * `sanitize: { trustPlugins: false }`.
+ */
+{
   kind: "html";
   html: string;
+  trusted?: boolean;
 } | {
   kind: "element";
   tag: string;
@@ -54,7 +66,18 @@ interface MountedCardSlot {
 interface RenderMountContext {
   mountCard?: (host: HTMLElement, request: MountCardSlotRequest) => MountedCardSlot | undefined;
 }
-type NodeRenderer = (node: ASTNode) => RenderOutput | Promise<RenderOutput>;
+/** What the host can tell a plugin about the surroundings it is rendering into. */
+interface NodeRenderContext {
+  /**
+   * The host's colour scheme, "light" or "dark" by convention.
+   *
+   * A diagram or a chart picks its own palette, and a plugin has no way to read the palette of
+   * the page it is embedded in, so without this an answer rendered on a dark page comes back
+   * with white plot areas.
+   */
+  readonly theme?: string;
+}
+type NodeRenderer = (node: ASTNode, context?: NodeRenderContext) => RenderOutput | Promise<RenderOutput>;
 interface PluginCommitContext {
   readonly generation: number;
   emitDebug(type: string, data?: Record<string, unknown>): void;

package/dist/index.d.ts

@@ -27,9 +27,21 @@ interface ASTNode {
 /** Patch event produced by diffing. */
 
 /** Framework-neutral render descriptor returned by plugin node renderers. */
-type RenderOutput = {
+type RenderOutput =
+/**
+ * `trusted` marks markup the plugin built itself rather than markup taken from the model.
+ *
+ * A plugin that renders a diagram returns SVG, and sanitizing SVG escapes it — the reader gets
+ * the source text instead of the picture. Hosts worked around that by matching the plugin's
+ * internal id prefix with a regular expression, which breaks the moment the plugin renames its
+ * ids and lets any model output wearing that prefix through unsanitized. A plugin is code the
+ * host chose to install, so it can say so itself; a host that disagrees sets
+ * `sanitize: { trustPlugins: false }`.
+ */
+{
   kind: "html";
   html: string;
+  trusted?: boolean;
 } | {
   kind: "element";
   tag: string;
@@ -54,7 +66,18 @@ interface MountedCardSlot {
 interface RenderMountContext {
   mountCard?: (host: HTMLElement, request: MountCardSlotRequest) => MountedCardSlot | undefined;
 }
-type NodeRenderer = (node: ASTNode) => RenderOutput | Promise<RenderOutput>;
+/** What the host can tell a plugin about the surroundings it is rendering into. */
+interface NodeRenderContext {
+  /**
+   * The host's colour scheme, "light" or "dark" by convention.
+   *
+   * A diagram or a chart picks its own palette, and a plugin has no way to read the palette of
+   * the page it is embedded in, so without this an answer rendered on a dark page comes back
+   * with white plot areas.
+   */
+  readonly theme?: string;
+}
+type NodeRenderer = (node: ASTNode, context?: NodeRenderContext) => RenderOutput | Promise<RenderOutput>;
 interface PluginCommitContext {
   readonly generation: number;
   emitDebug(type: string, data?: Record<string, unknown>): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-gui/plugin-ui",
-  "version": "0.4.4",
+  "version": "0.6.0",
   "description": "Bounded declarative AI-generated interfaces for AIGUI.",
   "keywords": [
     "llm",
@@ -49,7 +49,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@ai-gui/core": "0.4.4"
+    "@ai-gui/core": "0.6.0"
   },
   "scripts": {
     "build": "tsdown",