@gram-ai/elements 1.29.0 → 1.30.1

package/src/plugins/generative-ui/index.ts

@@ -6,6 +6,7 @@ import { GenerativeUIRenderer } from "./component";
  * Use the language identifier 'ui' or 'json-render' in code blocks.
  */
 export const generativeUI: Plugin = {
+  id: "generative-ui",
   language: "ui",
   prompt: `Render structured data as visual UI using \`\`\`ui code blocks with valid JSON.
 

package/src/plugins/index.test.ts

@@ -0,0 +1,62 @@
+import { describe, it, expect } from "vitest";
+import { recommended, type Plugin } from "./index";
+import { chart } from "./chart";
+import { generativeUI } from "./generative-ui";
+
+describe("recommended", () => {
+  it("contains chart and generative-ui plugins", () => {
+    expect(recommended).toHaveLength(2);
+    expect(recommended).toContain(chart);
+    expect(recommended).toContain(generativeUI);
+  });
+
+  it("is usable as a plain array", () => {
+    const ids = recommended.map((p) => p.id);
+    expect(ids).toEqual(["chart", "generative-ui"]);
+  });
+});
+
+describe("recommended.except", () => {
+  it("excludes a plugin by id", () => {
+    const result = recommended.except("generative-ui");
+    expect(result).toHaveLength(1);
+    expect(result[0]).toBe(chart);
+  });
+
+  it("excludes multiple plugins", () => {
+    const result = recommended.except("chart", "generative-ui");
+    expect(result).toHaveLength(0);
+  });
+
+  it("returns all plugins when no ids match", () => {
+    const result = recommended.except("nonexistent");
+    expect(result).toHaveLength(2);
+  });
+
+  it("returns all plugins when called with no arguments", () => {
+    const result = recommended.except();
+    expect(result).toHaveLength(2);
+  });
+
+  it("is assignable to Plugin[] for backwards compatibility", () => {
+    // Consumers may have typed variables as Plugin[]
+    const plugins: Plugin[] = recommended.except("chart");
+    expect(plugins).toHaveLength(1);
+
+    // Spread into a plain array
+    const spread: Plugin[] = [...recommended];
+    expect(spread).toHaveLength(2);
+
+    // Nullish coalescing fallback (common pattern in ElementsProvider)
+    const config: { plugins?: Plugin[] } = {};
+    const resolved = config.plugins ?? recommended;
+    expect(resolved).toHaveLength(2);
+  });
+
+  it("does not match on language when id is set", () => {
+    // generative-ui has id="generative-ui" and language="ui"
+    // Excluding by language value "ui" should not match because id takes precedence
+    const result = recommended.except("ui");
+    expect(result).toHaveLength(2);
+  });
+});

package/src/plugins/index.ts

@@ -2,7 +2,20 @@ import type { Plugin } from "@/types/plugins";
 import { chart } from "./chart";
 import { generativeUI } from "./generative-ui";
 
-export const recommended: Plugin[] = [chart, generativeUI];
+export type PluginList = Plugin[] & {
+  except(...ids: string[]): Plugin[];
+};
+
+function createPluginList(plugins: Plugin[]): PluginList {
+  const arr = [...plugins] as PluginList;
+  arr.except = (...ids: string[]) => {
+    const excluded = new Set(ids);
+    return arr.filter((p) => !excluded.has(p.id ?? p.language));
+  };
+  return arr;
+}
+
+export const recommended: PluginList = createPluginList([chart, generativeUI]);
 export { chart } from "./chart";
 export { generativeUI } from "./generative-ui";
 

package/src/types/plugins.ts

@@ -15,6 +15,12 @@ import { ComponentType } from "react";
  * 3. The code fence is rendered using the custom renderer
  */
 export interface Plugin {
+  /**
+   * Unique identifier for the plugin. Used by `recommended.except()` to
+   * selectively exclude plugins. Defaults to `language` if not set.
+   */
+  id?: string;
+
   /**
    * Any prompt that the plugin may need to add to the system prompt.
    * Will be appended to the built-in system prompt.