@lydt/geogebra-studio 0.0.0-stage → 0.4.0-rc.2

package/mcp.json

@@ -0,0 +1,20 @@
+{
+  "$schema": "https://agent-plugins.org/schemas/1.0.0/mcp.schema.json",
+  "mcpServers": {
+    "geogebra": {
+      "type": "stdio",
+      "command": "npx",
+      "args": [
+        "--yes",
+        "--prefix",
+        "./runtime",
+        "@lydt/geogebra-studio@0.4.0-rc.2",
+        "mcp"
+      ],
+      "env": {
+        "GEOGEBRA_TOOL_PROFILE": "core",
+        "GEOGEBRA_PLUGIN_RUNTIME": "1"
+      }
+    }
+  }
+}

package/package.json

@@ -1,6 +1,109 @@
 {
   "name": "@lydt/geogebra-studio",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.4.0-rc.2",
+  "description": "GeoGebra Studio: editable geometry plugin with MCP, agent skills, interactive HTML and built-in Gikz",
+  "main": "dist/index.js",
+  "private": false,
+  "bin": {
+    "geogebra-studio": "dist/cli.js",
+    "geogebra-mcp": "dist/cli.js",
+    "gikz": "gikz/cli.cjs"
+  },
+  "files": [
+    "dist/**/*",
+    "runtime/package.json",
+    "package.json",
+    "README.md",
+    "LICENSE",
+    "plugin.json",
+    "mcp.json",
+    ".codex-plugin/plugin.json",
+    ".mcp.json",
+    "skills/**/*",
+    "docs/**/*",
+    "widget/**/*",
+    "scripts/build-widget.cjs",
+    "gikz/**/*",
+    "LICENSE-MIT",
+    "THIRD_PARTY_NOTICES.md",
+    "README.zh-CN.md",
+    ".agents/plugins/marketplace.json",
+    "examples/tangent-construction.json",
+    "src/**/*",
+    "tsconfig.json",
+    "scripts/build-plugin.cjs"
+  ],
+  "scripts": {
+    "dev": "ts-node src/index.ts",
+    "build": "npm run clean && tsc && node scripts/build-widget.cjs && node scripts/build-plugin.cjs",
+    "build:watch": "tsc --watch",
+    "start": "node dist/index.js",
+    "clean": "rimraf dist",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:ci": "jest --ci --coverage --watchAll=false",
+    "test:coverage": "jest --coverage",
+    "lint": "eslint src/**/*.ts",
+    "lint:fix": "eslint src/**/*.ts --fix",
+    "format": "prettier --write src/**/*.ts",
+    "format:check": "prettier --check src/**/*.ts",
+    "prepublishOnly": "npm run build",
+    "verify": "npm run build && node scripts/verify-protocol.cjs && node scripts/verify-exports.cjs",
+    "verify:native": "node scripts/verify-native.cjs",
+    "test:unit": "jest --runInBand --testPathIgnorePatterns tests/e2e tests/performance tests/real-geogebra tests/geogebra-integration",
+    "release:artifacts": "npm run build && npm run test:unit && npm run verify:manifests && node scripts/verify-protocol.cjs && node scripts/verify-exports.cjs && node scripts/package-release.cjs",
+    "verify:manifests": "node scripts/verify-manifests.cjs"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "geogebra",
+    "mathematics",
+    "visualization",
+    "ai-tools",
+    "educational-technology",
+    "mathematical-modeling"
+  ],
+  "author": "YZDame",
+  "license": "GPL-2.0-or-later",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/YZDame/geogebra-mcp-server.git"
+  },
+  "homepage": "https://github.com/YZDame/geogebra-mcp-server#readme",
+  "bugs": {
+    "url": "https://github.com/YZDame/geogebra-mcp-server/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/ext-apps": "^2.0.3",
+    "@modelcontextprotocol/sdk": "^1.32.1",
+    "ajv": "^8.20.0",
+    "dotenv": "^16.3.1",
+    "fast-xml-parser": "^5.11.2",
+    "winston": "^3.11.0",
+    "puppeteer-core": "25.13.0",
+    "@puppeteer/browsers": "3.2.4"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.8",
+    "@types/node": "^20.10.0",
+    "@typescript-eslint/eslint-plugin": "^6.12.0",
+    "@typescript-eslint/parser": "^6.12.0",
+    "esbuild": "^0.28.2",
+    "eslint": "^8.54.0",
+    "jest": "^29.7.0",
+    "nodemon": "^3.0.1",
+    "ts-jest": "^29.1.1",
+    "ts-node": "^10.9.1",
+    "typescript": "^5.3.2"
+  },
+  "engines": {
+    "node": ">=22.12.0"
+  },
+  "overrides": {
+    "minimatch": "^9.0.7"
+  }
+}

package/plugin.json

@@ -0,0 +1,35 @@
+{
+  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
+  "name": "geogebra-studio",
+  "version": "0.4.0-rc.2",
+  "description": "GeoGebra Studio: editable geometry plugin with MCP, agent skills, interactive HTML and built-in Gikz",
+  "author": {
+    "name": "YZDame"
+  },
+  "repository": "https://github.com/YZDame/geogebra-mcp-server",
+  "license": "GPL-2.0-or-later",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "geogebra",
+    "mathematics",
+    "visualization",
+    "ai-tools",
+    "educational-technology",
+    "mathematical-modeling"
+  ],
+  "extensions": {
+    "com.openai": {
+      "onboardingSkill": "./skills/geogebra-setup/SKILL.md",
+      "interface": {
+        "displayName": "GeoGebra Studio",
+        "shortDescription": "Editable geometry, interactive HTML and cleaned TikZ",
+        "developerName": "YZDame",
+        "category": "Education",
+        "defaultPrompt": [
+          "Construct an editable GeoGebra diagram from this problem and deliver a local HTML."
+        ]
+      }
+    }
+  }
+}

package/runtime/package.json

@@ -0,0 +1,4 @@
+{
+  "name": "geogebra-studio-runtime-launcher",
+  "private": true
+}

package/scripts/build-plugin.cjs

@@ -0,0 +1,15 @@
+const fs=require('node:fs/promises');
+const {build}=require('esbuild');
+const p=require('../package.json');
+(async()=>{
+ await build({entryPoints:['gikz/browser.cjs'],outfile:'dist/gikz-browser.js',bundle:true,format:'iife',platform:'browser',target:'es2022',minify:false,legalComments:'inline'});
+ const plugin={"$schema":"https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",name:'geogebra-studio',version:p.version,description:p.description,author:{name:p.author},repository:p.repository.url.replace(/\.git$/,''),license:p.license,keywords:p.keywords,extensions:{'com.openai':{onboardingSkill:'./skills/geogebra-setup/SKILL.md',interface:{displayName:'GeoGebra Studio',shortDescription:'Editable geometry, interactive HTML and cleaned TikZ',developerName:p.author,category:'Education',defaultPrompt:['Construct an editable GeoGebra diagram from this problem and deliver a local HTML.']}}}};
+ const server={command:'npx',args:['--yes','--prefix','./runtime',p.name+'@'+p.version,'mcp'],env:{GEOGEBRA_TOOL_PROFILE:'core',GEOGEBRA_PLUGIN_RUNTIME:'1'}};
+ const mcp={"$schema":"https://agent-plugins.org/schemas/1.0.0/mcp.schema.json",mcpServers:{geogebra:{type:'stdio',...server}}};
+ const write=(file,value)=>fs.writeFile(file,JSON.stringify(value,null,2)+'\n');
+ await fs.mkdir('.codex-plugin',{recursive:true});await fs.mkdir('.agents/plugins',{recursive:true});
+ await write('plugin.json',plugin);await write('mcp.json',mcp);
+ await write('.codex-plugin/plugin.json',{name:plugin.name,version:p.version,description:p.description,skills:'./skills/',mcpServers:'./.mcp.json',extensions:plugin.extensions});
+ await write('.mcp.json',{mcpServers:{geogebra:server}});
+ await write('.agents/plugins/marketplace.json',{name:'geogebra-studio',interface:{displayName:'GeoGebra Studio'},plugins:[{name:'geogebra-studio',source:{source:'npm',package:p.name,version:p.version},policy:{installation:'AVAILABLE',authentication:'ON_INSTALL'},category:'Education'}]});
+})().catch(error=>{console.error(error);process.exitCode=1});

package/scripts/build-widget.cjs

@@ -0,0 +1,7 @@
+const {build}=require('esbuild');
+const fs=require('node:fs/promises');
+(async()=>{
+  const result=await build({entryPoints:['widget/main.ts'],bundle:true,write:false,define:{__STUDIO_VERSION__:JSON.stringify(require('../package.json').version)},format:'iife',platform:'browser',target:'es2022',minify:true});
+  const js=result.outputFiles[0].text.replace(/<\/script/gi,'<\\/script');
+  await fs.writeFile('dist/widget.html',`<!doctype html><html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><style>body{margin:0;font:14px system-ui}#status{padding:8px}iframe{width:100%;height:780px;border:0}</style></head><body><p id="status" role="status">Waiting for a GeoGebra construction…</p><iframe id="preview" title="GeoGebra construction" sandbox="allow-scripts allow-downloads allow-same-origin"></iframe><script>${js}</script></body></html>`);
+})().catch(e=>{console.error(e);process.exitCode=1});

package/skills/geogebra-construct/SKILL.md

@@ -0,0 +1,40 @@
+---
+name: geogebra-construct
+description: Build editable GeoGebra geometry from a problem, delivering a checked local HTML with embedded GGB, a preview, and current-state downloads.
+---
+
+Understand the user's mathematical definitions, free inputs, dependent objects and
+requested deliverables. Ask only when ambiguity changes the construction. Prefer
+GeoGebra relations over frozen coordinates for constrained points and intersections.
+
+Default to `geogebra_build_artifact`: supply commands in dependency order,
+`visibleLabels`, `captionOverrides` where useful, and a new workspace `.html` filename.
+Always pass `workspace` as the absolute path of the user's current project directory
+when saving files. Codex starts the plugin in its cache directory; that directory
+must not become the output destination. MCP roots are used when provided by a client.
+This tool uses an isolated native engine, packs a real GGB, reopens the final viewer,
+checks equal axes and returns a preview. Inspect that preview before claiming visual
+quality; engineVerified and packedGgbVerified are separate from renderVerified.
+Do not call geogebra_clear_construction for this isolated workflow.
+
+Read [visual standards](../../docs/VISUAL-STANDARD.md) when adjusting presentation.
+For tangents/intersections, read [the two-circle regression](../../docs/TANGENT-REGRESSION.md)
+to avoid selecting A again when intersection branches swap. The case is a regression,
+not a requirement to use that construction or sample coordinates for other problems.
+
+Deliver the local HTML path and describe how to open the object sidebar, drag free
+points and download the current state. The viewer uses the official GeoGebra engine;
+do not replace it with a custom-drawn canvas/SVG or a desktop GeoGebra workflow.
+It requires internet for official GeoGebra assets; Gikz cleanup runs locally.
+
+`geogebra_create_html` is a lightweight command-template alternative when explicitly
+appropriate. It does not execute/check commands or embed a prebuilt GGB by default;
+never describe template generation alone as verified geometry.
+
+For advanced server-side work, the older focused tools share one construction:
+keep each diagram's calls together. Use geogebra_api_list_methods before unfamiliar
+API calls; persistent callbacks use $ggbCallbackId and event polling. Prefer focused
+tools for routine construction and export.
+
+For source export, read geometry-export. Every TikZ export uses native PGF followed
+by built-in Gikz; no raw fallback. Retain GGB/XML for construction dependencies.

package/skills/geogebra-setup/SKILL.md

@@ -0,0 +1,37 @@
+---
+name: geogebra-setup
+description: Install or diagnose the local GeoGebra Studio Codex plugin, its built-in Gikz, Chrome runtime, and geometry export workflow.
+---
+
+GeoGebra Studio includes MCP, three skills, the HTML viewer and built-in Gikz.
+Node >=22.12.0 and npm/npx are required. A full plugin installation is:
+
+```sh
+npx @lydt/geogebra-studio install
+```
+
+This registers a persistent version-pinned marketplace and installs the complete
+plugin through Codex. It probes existing Chrome and prepares managed Chromium when
+needed. Start a new session and invoke @geogebra-studio. Verify both skills and MCP
+tool availability; a standalone SDK connection alone does not verify plugin loading.
+For candidate versions, use the exact installed version or the npm `next` tag.
+The packaged launcher uses a neutral npm prefix so an unpacked plugin without
+node_modules does not shadow the version-pinned npm runtime. For file output, pass
+the absolute user project directory in `workspace`, or use client-provided MCP roots.
+Old geogebra-geometry plugins are not removed automatically. Avoid using both against
+the same diagram; remove the old plugin only when the user asks.
+
+`npx @lydt/geogebra-studio mcp` (also the no-argument default) starts only stdio MCP.
+Use `doctor` for a browser-launch and built-in-cleaner check; `browser install`
+prepares a usable browser. PUPPETEER_EXECUTABLE_PATH selects an explicit executable.
+No GeoGebra desktop client and no GIKZ_CLI installation are required.
+
+Default artifact creation needs Chrome and network access to official GeoGebra
+assets. Browser downloads and generated HTML also need GeoGebra network assets.
+Do not bypass load errors with a custom drawing. Diagnose missing browser, network,
+command, and plugin-loading failures separately.
+
+Read [visual standards](../../docs/VISUAL-STANDARD.md) for the delivered viewer and
+[the regression](../../docs/TANGENT-REGRESSION.md) when diagnosing its geometry.
+This release targets local Codex; it does not publish a remote endpoint or submit
+to the public ChatGPT directory. No credentials are stored in the package.

package/skills/geometry-export/SKILL.md

@@ -0,0 +1,31 @@
+---
+name: geometry-export
+description: Export GeoGebra geometry to GGB, vector/image formats, cleaned TikZ, Asymptote or mixed TSQX/Asymptote, with explicit construction-provenance limits.
+---
+
+The default HTML viewer downloads the current edited applet as GGB, PNG, SVG,
+TikZ (.tex), PDF, XML or another self-contained viewer HTML. Use native GGB/XML
+when users need editable construction definitions; decode GGB base64 into ZIP bytes.
+When a tool saves a file, pass `workspace` as the absolute user project directory,
+with `filename` relative to that directory. Never save into the installed plugin cache.
+
+Every TikZ path MUST use GeoGebra native PGF followed by built-in Gikz. Use
+geogebra_export_tikz or geogebra_export_source(format=tikz); the generic exportPGF
+bridge and viewer download follow the same policy. A cleaner failure is an error,
+never an excuse to return raw PGF. Gikz is included; do not install an external CLI.
+Its cleaning normalizes precision, colors, widths and labels. TikZ is a static
+visual snapshot, not a guaranteed dependency-preserving replacement for GGB.
+Use geogebra_clean_tikz for existing native PGF or explicit XML conversion.
+
+For Asymptote/TSQX, start from geogebra_get_semantic_scene and retain original XML,
+commands, captions, styles and coordinates. geogebra_export_source strict=true
+supports independent finite points, midpoints, segments, polygons and basic circles.
+Inspect all warnings. strict=false yields an explicit partial draft. Reconstruct
+unsupported relations using the XML; do not silently freeze dependent points.
+TSQX with injected Asymptote is mixed TSQX/Asymptote, not pure TSQX.
+
+Compile source when a toolchain is available/requested and inspect the figure.
+For an open .tex editor, edit that file in place and use its built-in compiler.
+Check point incidence, tangency, equal-axis scale, clipping, branches and labels.
+Report actual checks and remaining limitations; successful compilation is not proof
+of mathematical or visual correctness. See [regression](../../docs/TANGENT-REGRESSION.md).

package/src/cli.ts

@@ -0,0 +1,212 @@
+#!/usr/bin/env node
+
+/**
+ * CLI entry point for GeoGebra Studio
+ * Enables npx usage: npx @lydt/geogebra-studio
+ */
+
+/**
+ * Display help information
+ */
+function showHelp() {
+  const packageJson = require('../package.json');
+  const homepage = packageJson.homepage || 'https://github.com/YZDame/geogebra-mcp-server';
+
+  console.log(`
+GeoGebra Studio - Mathematical Visualization via Model Context Protocol
+
+Usage:
+  npx @lydt/geogebra-studio [options]
+
+Options:
+  install          Install the complete Codex plugin (skills + MCP)
+  doctor           Check built-in Gikz and browser launch
+  browser install  Prepare Chrome or managed Chromium
+  mcp              Start only the MCP server (also the no-argument default)
+
+  -h, --help        Show this help message
+  -v, --version     Show version information
+  --log-level LEVEL Set log level (error, warn, info, debug) [default: info]
+  --port PORT       Serve Streamable HTTP at http://127.0.0.1:PORT/mcp
+
+Examples:
+  npx @lydt/geogebra-studio                    # Start MCP server on stdin/stdout
+  npx @lydt/geogebra-studio --log-level debug  # Start with debug logging
+  npx @lydt/geogebra-studio --help             # Show this help
+
+For more information, visit: ${homepage}
+`);
+}
+
+/**
+ * Display version information
+ */
+function showVersion() {
+  const packageJson = require('../package.json');
+  console.log(`GeoGebra Studio v${packageJson.version}`);
+}
+
+/**
+ * Parse command line arguments
+ */
+function parseArgs(args: string[]) {
+  const options = {
+    help: false,
+    version: false,
+    logLevel: process.env['LOG_LEVEL'] || 'info',
+    port: process.env['PORT'] || undefined
+  };
+
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    
+    // Type guard to ensure arg is defined
+    if (!arg) continue;
+    
+    switch (arg) {
+      case '-h':
+      case '--help':
+        options.help = true;
+        break;
+      
+      case '-v':
+      case '--version':
+        options.version = true;
+        break;
+      
+      case '--log-level':
+        if (i + 1 < args.length && args[i + 1]) {
+          const level = args[i + 1]!; // Non-null assertion since we checked above
+          if (['error', 'warn', 'info', 'debug'].includes(level)) {
+            options.logLevel = level;
+            i++; // Skip next argument
+          } else {
+            console.error(`Invalid log level: ${level}`);
+            process.exit(1);
+          }
+        } else {
+          console.error('--log-level requires a value');
+          process.exit(1);
+        }
+        break;
+      
+      case '--port':
+        if (i + 1 < args.length && args[i + 1]) {
+          options.port = args[i + 1]!; // Non-null assertion since we checked above
+          i++; // Skip next argument
+        } else {
+          console.error('--port requires a value');
+          process.exit(1);
+        }
+        break;
+      
+      default:
+        if (arg.startsWith('-')) {
+          console.error(`Unknown option: ${arg}`);
+          console.error('Use --help for usage information');
+          process.exit(1);
+        }
+        break;
+    }
+  }
+
+  return options;
+}
+
+/**
+ * Main CLI function
+ */
+async function main() {
+  try {
+    // Parse command line arguments first
+    const args = process.argv.slice(2);
+    if(args[0]==='install'){
+      if(args.slice(1).some(arg=>arg!=='--local'))throw new Error('Usage: install [--local]');
+      await (await import('./studio/install')).installPlugin(args.includes('--local'));return;
+    }
+    if(args[0]==='doctor'||args[0]==='browser'){
+      if(args[0]==='browser'&&(args.length!==2||args[1]!=='install'))throw new Error('Usage: browser install');
+      const {prepareBrowser}=await import('./studio/browser');
+      const {cleanWithGikz}=await import('./export/gikz');
+      await cleanWithGikz(String.raw`\begin{tikzpicture}\end{tikzpicture}`);
+      const executablePath=await prepareBrowser(args[0]==='browser');
+      console.log(JSON.stringify({success:true,version:require('../package.json').version,gikz:'built-in',executablePath}));return;
+    }
+    if(args[0]==='mcp')args.shift();
+    if(args[0]&&!args[0].startsWith('-'))throw new Error('Unknown command: '+args[0]);
+    const options = parseArgs(args);
+
+    // Handle help and version BEFORE loading any dependencies
+    if (options.help) {
+      showHelp();
+      process.exit(0);
+    }
+
+    if (options.version) {
+      showVersion();
+      process.exit(0);
+    }
+
+    // Only import heavy dependencies if we're actually starting the server
+    await import('dotenv/config');
+    const { McpServer } = await import('./server');
+    const { getAppInfo } = await import('./utils/app-info');
+    const { default: logger } = await import('./utils/logger');
+    const appInfo = getAppInfo();
+
+    // Server configuration
+    const config = {
+      name: 'GeoGebra Studio',
+      version: appInfo.version,
+      description: appInfo.description,
+      logLevel: options.logLevel as 'error' | 'warn' | 'info' | 'debug'
+    };
+
+    logger.info('Starting GeoGebra Studio...');
+    logger.info(`Log level: ${config.logLevel}`);
+
+    // Create and start the MCP server
+    const server = new McpServer(config);
+
+    // Set up graceful shutdown
+    const shutdown = async (signal: string) => {
+      logger.info(`Received ${signal}, shutting down gracefully...`);
+      try {
+        await server.stop();
+        process.exit(0);
+      } catch (error) {
+        logger.error('Error during shutdown:', error);
+        process.exit(1);
+      }
+    };
+
+    // Handle shutdown signals
+    process.on('SIGTERM', () => shutdown('SIGTERM'));
+    process.on('SIGINT', () => shutdown('SIGINT'));
+
+    // Handle uncaught exceptions
+    process.on('uncaughtException', (error) => {
+      logger.error('Uncaught exception:', error);
+      process.exit(1);
+    });
+
+    process.on('unhandledRejection', (reason, promise) => {
+      logger.error('Unhandled rejection at:', promise, 'reason:', reason);
+      process.exit(1);
+    });
+
+    // Start the server
+    if (options.port) await server.startHttp(Number(options.port));
+    else await server.start();
+
+  } catch (error) {
+    console.error('Failed to start server:', error);
+    process.exit(1);
+  }
+}
+
+// Start the CLI application
+main().catch((error) => {
+  console.error('CLI startup failed:', error);
+  process.exit(1);
+}); 

package/src/export/files.ts

@@ -0,0 +1,26 @@
+import { mkdir, realpath, lstat, writeFile } from 'fs/promises';
+import path from 'path';
+import { currentWorkspace } from './workspace';
+
+/** Restrict new export destinations, including existing ancestor symlinks, to workspace. */
+export async function saveFile(filename: unknown, content: string | Uint8Array): Promise<string | undefined> {
+  if (filename === undefined) return undefined;
+  if (typeof filename !== 'string' || !filename.trim()) throw new Error('filename must be a nonempty string');
+  const root = await realpath(currentWorkspace());
+  const target = path.resolve(root,filename);
+  const inside = (s: string) => s.startsWith(root+path.sep);
+  if (!inside(target)) throw new Error('Export path is outside workspace');
+  // Validate every existing component before creating directories.
+  let current=root;
+  for (const part of path.relative(root,target).split(path.sep)) {
+    current=path.join(current,part);
+    try { const stat=await lstat(current); if(stat.isSymbolicLink()) throw new Error('Export paths may not contain symbolic links'); }
+    catch(e) { if ((e as NodeJS.ErrnoException).code !== 'ENOENT') throw e; }
+  }
+  await mkdir(path.dirname(target),{recursive:true});
+  if (!inside(await realpath(path.dirname(target))) && path.dirname(target)!==root) throw new Error('Export parent is outside workspace');
+  await writeFile(target,content,{flag:'wx'});
+  return target;
+}
+
+export const saveText = (filename: unknown, content: string) => saveFile(filename,content);

package/src/export/gikz.ts

@@ -0,0 +1,22 @@
+import path from 'path';
+import { readFileSync } from 'fs';
+interface GikzOptions {standalone?:boolean;points?:boolean;labels?:boolean;round?:boolean}
+const core = require('../../gikz/core.cjs') as {
+  cleanTikZCode(source:string,options:GikzOptions):string;
+  convertGeoGebraXML(source:string,options:GikzOptions):string;
+  wrapStandalone(source:string):string;
+};
+/** Source and GPL license travel with the viewer; no eval or external cleaner. */
+export function gikzBrowserScripts(): string {
+  const source=readFileSync(path.join(__dirname,'../../dist/gikz-browser.js'),'utf8').replace(/<\/script/gi,'<\\/script');
+  const license=JSON.stringify(readFileSync(path.join(__dirname,'../../gikz/LICENSE'),'utf8')).replace(/</g,'\\u003c');
+  return `<script id="gikz-license" type="application/json">${license}</script>\n<script id="gikz-browser">${source}</script>`;
+}
+export async function cleanWithGikz(source:string,options:GikzOptions={}):Promise<string>{
+  if(source.length>10_000_000)throw new Error('Gikz input exceeds 10 MB');
+  let code=source.includes('<geogebra')&&source.includes('<construction')
+    ?core.convertGeoGebraXML(source,options):core.cleanTikZCode(source,options);
+  if(options.standalone)code=core.wrapStandalone(code);
+  if(!code.includes('\\begin{tikzpicture}'))throw new Error('Gikz returned invalid TikZ');
+  return code;
+}