@panyam/tsappkit 0.0.3 → 0.0.4

package/dist/docs/index.js

@@ -0,0 +1,232 @@
+'use strict';
+
+// src/docs/CodeBlock.ts
+var CodeBlock = class {
+  constructor(preElement) {
+    this.codeElement = preElement.querySelector("code") || preElement;
+    this.container = document.createElement("div");
+    this.container.className = "code-block";
+    preElement.parentNode?.insertBefore(this.container, preElement);
+    this.container.appendChild(preElement);
+    this.copyButton = document.createElement("button");
+    this.copyButton.className = "code-block-copy";
+    this.copyButton.setAttribute("aria-label", "Copy code");
+    this.copyButton.innerHTML = this.getCopyIcon();
+    this.copyButton.addEventListener("click", () => this.copyCode());
+    this.container.appendChild(this.copyButton);
+  }
+  getCopyIcon() {
+    return `<svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+      <rect x="9" y="9" width="13" height="13" rx="2" ry="2"></rect>
+      <path d="M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1"></path>
+    </svg>`;
+  }
+  getCheckIcon() {
+    return `<svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+      <polyline points="20 6 9 17 4 12"></polyline>
+    </svg>`;
+  }
+  async copyCode() {
+    const text = this.codeElement.textContent || "";
+    try {
+      await navigator.clipboard.writeText(text);
+      this.showSuccess();
+    } catch (err) {
+      this.fallbackCopy(text);
+    }
+  }
+  fallbackCopy(text) {
+    const textarea = document.createElement("textarea");
+    textarea.value = text;
+    textarea.style.position = "fixed";
+    textarea.style.opacity = "0";
+    document.body.appendChild(textarea);
+    textarea.select();
+    try {
+      document.execCommand("copy");
+      this.showSuccess();
+    } catch (err) {
+      console.error("Failed to copy:", err);
+    }
+    document.body.removeChild(textarea);
+  }
+  showSuccess() {
+    this.copyButton.innerHTML = this.getCheckIcon();
+    this.copyButton.classList.add("copied");
+    setTimeout(() => {
+      this.copyButton.innerHTML = this.getCopyIcon();
+      this.copyButton.classList.remove("copied");
+    }, 2e3);
+  }
+};
+function initCodeBlocks(selector = ".content-body pre") {
+  const preElements = document.querySelectorAll(selector);
+  preElements.forEach((pre) => {
+    if (pre.parentElement?.classList.contains("code-block")) {
+      return;
+    }
+    if (pre.querySelector("pre")) {
+      return;
+    }
+    new CodeBlock(pre);
+  });
+}
+
+// src/docs/pageSetup.ts
+function highlightActiveSidebarLink(sidebarSelector = ".sidebar .section-nav a") {
+  const currentPath = window.location.pathname;
+  const sidebarLinks = document.querySelectorAll(sidebarSelector);
+  sidebarLinks.forEach((link) => {
+    const href = link.getAttribute("href");
+    if (href && currentPath.endsWith(href.replace(/\/$/, "") + "/")) {
+      link.classList.add("active");
+    } else if (href && currentPath === href) {
+      link.classList.add("active");
+    }
+  });
+}
+function initPageSetup(options = {}) {
+  highlightActiveSidebarLink(options.sidebarSelector);
+}
+
+// src/docs/ActionCompiler.ts
+var ActionCompiler = class {
+  constructor(editor, statusEl = null, onCompile = null) {
+    this.editor = null;
+    this.compiledFn = null;
+    this.compileError = null;
+    this.statusEl = null;
+    this.onCompile = null;
+    this.editor = editor;
+    this.statusEl = statusEl;
+    this.onCompile = onCompile;
+    let compileTimeout = null;
+    this.editor.session.on("change", () => {
+      if (compileTimeout) clearTimeout(compileTimeout);
+      compileTimeout = window.setTimeout(() => this.compile(), 300);
+    });
+  }
+  /**
+   * Compile the current editor content
+   */
+  compile() {
+    if (!this.editor) {
+      return { success: false, fn: null, error: "No editor", line: null };
+    }
+    const code = this.editor.getValue().trim();
+    const session = this.editor.session;
+    session.clearAnnotations();
+    this.compiledFn = null;
+    this.compileError = null;
+    if (!code) {
+      this.updateStatus("", "");
+      const result = { success: true, fn: null, error: null, line: null };
+      this.onCompile?.(result);
+      return result;
+    }
+    try {
+      this.compiledFn = new Function("node", code);
+      this.updateStatus("\u2713", "success");
+      const result = { success: true, fn: this.compiledFn, error: null, line: null };
+      this.onCompile?.(result);
+      return result;
+    } catch (e) {
+      this.compileError = e.message;
+      this.updateStatus("\u2717 Compile Error", "error");
+      const lineMatch = e.message.match(/(?:at line |line |:|\()(\d+)(?::|,|\))/i);
+      const line = lineMatch ? parseInt(lineMatch[1], 10) - 1 : 0;
+      session.setAnnotations([
+        {
+          row: line,
+          column: 0,
+          text: e.message,
+          type: "error"
+        }
+      ]);
+      const result = { success: false, fn: null, error: e.message, line };
+      this.onCompile?.(result);
+      return result;
+    }
+  }
+  /**
+   * Run the compiled action on a parse tree node
+   */
+  run(node) {
+    if (!node) {
+      return { success: false, result: null, error: "No parse result available", line: null };
+    }
+    if (this.compileError) {
+      return { success: false, result: null, error: `Compile Error: ${this.compileError}`, line: null };
+    }
+    if (!this.compiledFn) {
+      return { success: true, result: null, error: null, line: null };
+    }
+    try {
+      const result = this.compiledFn(node);
+      if (this.editor) {
+        this.editor.session.clearAnnotations();
+      }
+      this.updateStatus("\u2713", "success");
+      return { success: true, result, error: null, line: null };
+    } catch (e) {
+      const stack = e.stack || "";
+      const lineMatch = stack.match(/<anonymous>:(\d+):/);
+      const line = lineMatch ? parseInt(lineMatch[1], 10) - 1 : null;
+      if (this.editor && line !== null) {
+        this.editor.session.setAnnotations([
+          {
+            row: line,
+            column: 0,
+            text: e.message,
+            type: "error"
+          }
+        ]);
+      }
+      this.updateStatus("\u2717 Runtime Error", "error");
+      return { success: false, result: null, error: e.message, line };
+    }
+  }
+  /**
+   * Get the current compile error (if any)
+   */
+  getCompileError() {
+    return this.compileError;
+  }
+  /**
+   * Check if there's a compiled action function
+   */
+  hasCompiledAction() {
+    return this.compiledFn !== null;
+  }
+  /**
+   * Update status element
+   */
+  updateStatus(text, statusClass) {
+    if (this.statusEl) {
+      this.statusEl.textContent = text;
+      this.statusEl.classList.remove("success", "error");
+      if (statusClass) {
+        this.statusEl.classList.add(statusClass);
+      }
+    }
+  }
+  /**
+   * Clear annotations and status
+   */
+  clear() {
+    if (this.editor) {
+      this.editor.session.clearAnnotations();
+    }
+    this.compiledFn = null;
+    this.compileError = null;
+    this.updateStatus("", "");
+  }
+};
+
+exports.ActionCompiler = ActionCompiler;
+exports.CodeBlock = CodeBlock;
+exports.highlightActiveSidebarLink = highlightActiveSidebarLink;
+exports.initCodeBlocks = initCodeBlocks;
+exports.initPageSetup = initPageSetup;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/docs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/docs/CodeBlock.ts","../../src/docs/pageSetup.ts","../../src/docs/ActionCompiler.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * CodeBlock.ts - Enhances pre/code blocks with copy functionality\n * Automatically finds all pre>code elements and adds a copy button\n */\n\nexport class CodeBlock {\n  private container: HTMLElement;\n  private copyButton: HTMLButtonElement;\n  private codeElement: HTMLElement;\n\n  constructor(preElement: HTMLPreElement) {\n    this.codeElement = preElement.querySelector('code') || preElement;\n\n    // Wrap pre in a container for positioning\n    this.container = document.createElement('div');\n    this.container.className = 'code-block';\n    preElement.parentNode?.insertBefore(this.container, preElement);\n    this.container.appendChild(preElement);\n\n    // Create copy button\n    this.copyButton = document.createElement('button');\n    this.copyButton.className = 'code-block-copy';\n    this.copyButton.setAttribute('aria-label', 'Copy code');\n    this.copyButton.innerHTML = this.getCopyIcon();\n    this.copyButton.addEventListener('click', () => this.copyCode());\n\n    this.container.appendChild(this.copyButton);\n  }\n\n  private getCopyIcon(): string {\n    return `<svg width=\"16\" height=\"16\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\">\n      <rect x=\"9\" y=\"9\" width=\"13\" height=\"13\" rx=\"2\" ry=\"2\"></rect>\n      <path d=\"M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1\"></path>\n    </svg>`;\n  }\n\n  private getCheckIcon(): string {\n    return `<svg width=\"16\" height=\"16\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\">\n      <polyline points=\"20 6 9 17 4 12\"></polyline>\n    </svg>`;\n  }\n\n  private async copyCode(): Promise<void> {\n    const text = this.codeElement.textContent || '';\n\n    try {\n      await navigator.clipboard.writeText(text);\n      this.showSuccess();\n    } catch (err) {\n      // Fallback for older browsers\n      this.fallbackCopy(text);\n    }\n  }\n\n  private fallbackCopy(text: string): void {\n    const textarea = document.createElement('textarea');\n    textarea.value = text;\n    textarea.style.position = 'fixed';\n    textarea.style.opacity = '0';\n    document.body.appendChild(textarea);\n    textarea.select();\n\n    try {\n      document.execCommand('copy');\n      this.showSuccess();\n    } catch (err) {\n      console.error('Failed to copy:', err);\n    }\n\n    document.body.removeChild(textarea);\n  }\n\n  private showSuccess(): void {\n    this.copyButton.innerHTML = this.getCheckIcon();\n    this.copyButton.classList.add('copied');\n\n    setTimeout(() => {\n      this.copyButton.innerHTML = this.getCopyIcon();\n      this.copyButton.classList.remove('copied');\n    }, 2000);\n  }\n}\n\n/**\n * Initialize all code blocks on the page\n * @param selector - CSS selector for finding pre elements (default: '.content-body pre')\n */\nexport function initCodeBlocks(selector: string = '.content-body pre'): void {\n  const preElements = document.querySelectorAll(selector);\n\n  preElements.forEach((pre) => {\n    // Skip if already initialized\n    if (pre.parentElement?.classList.contains('code-block')) {\n      return;\n    }\n    // Skip if this pre contains another pre (outer wrapper of double-wrapped code blocks)\n    // We only want to process the innermost pre that has the actual code\n    if (pre.querySelector('pre')) {\n      return;\n    }\n    new CodeBlock(pre as HTMLPreElement);\n  });\n}\n","/**\n * pageSetup.ts - Common page initialization shared across all doc pages\n */\n\n/**\n * Highlights the currently active link in the sidebar navigation\n * @param sidebarSelector - CSS selector for sidebar links (default: '.sidebar .section-nav a')\n */\nexport function highlightActiveSidebarLink(sidebarSelector: string = '.sidebar .section-nav a'): void {\n  const currentPath = window.location.pathname;\n  const sidebarLinks = document.querySelectorAll(sidebarSelector);\n\n  sidebarLinks.forEach((link) => {\n    const href = link.getAttribute('href');\n    if (href && currentPath.endsWith(href.replace(/\\/$/, '') + '/')) {\n      link.classList.add('active');\n    } else if (href && currentPath === href) {\n      link.classList.add('active');\n    }\n  });\n}\n\n/**\n * Initialize common page features\n * Call this on DOMContentLoaded for all doc pages\n * @param options - Configuration options for page setup\n */\nexport function initPageSetup(options: {\n  sidebarSelector?: string;\n} = {}): void {\n  highlightActiveSidebarLink(options.sidebarSelector);\n}\n","/**\n * ActionCompiler - Shared action code compilation and execution\n * Used by docs components like ExampleRunner and PlaygroundPage\n */\n\nimport ace from \"ace-builds\";\n\nexport interface ActionCompileResult {\n  success: boolean;\n  fn: ((node: any) => any) | null;\n  error: string | null;\n  line: number | null; // 0-indexed line number for error\n}\n\nexport interface ActionRunResult {\n  success: boolean;\n  result: any;\n  error: string | null;\n  line: number | null; // 0-indexed line number for runtime error\n}\n\nexport class ActionCompiler {\n  private editor: ace.Ace.Editor | null = null;\n  private compiledFn: ((node: any) => any) | null = null;\n  private compileError: string | null = null;\n  private statusEl: HTMLElement | null = null;\n  private onCompile: ((result: ActionCompileResult) => void) | null = null;\n\n  constructor(\n    editor: ace.Ace.Editor,\n    statusEl: HTMLElement | null = null,\n    onCompile: ((result: ActionCompileResult) => void) | null = null,\n  ) {\n    this.editor = editor;\n    this.statusEl = statusEl;\n    this.onCompile = onCompile;\n\n    // Setup change listener with debounce\n    let compileTimeout: number | null = null;\n    this.editor.session.on(\"change\", () => {\n      if (compileTimeout) clearTimeout(compileTimeout);\n      compileTimeout = window.setTimeout(() => this.compile(), 300);\n    });\n  }\n\n  /**\n   * Compile the current editor content\n   */\n  compile(): ActionCompileResult {\n    if (!this.editor) {\n      return { success: false, fn: null, error: \"No editor\", line: null };\n    }\n\n    const code = this.editor.getValue().trim();\n    const session = this.editor.session;\n\n    // Clear previous annotations\n    session.clearAnnotations();\n    this.compiledFn = null;\n    this.compileError = null;\n\n    if (!code) {\n      this.updateStatus(\"\", \"\");\n      const result = { success: true, fn: null, error: null, line: null };\n      this.onCompile?.(result);\n      return result;\n    }\n\n    try {\n      // Compile using new Function\n      this.compiledFn = new Function(\"node\", code) as (node: any) => any;\n      this.updateStatus(\"✓\", \"success\");\n      const result = { success: true, fn: this.compiledFn, error: null, line: null };\n      this.onCompile?.(result);\n      return result;\n    } catch (e: any) {\n      this.compileError = e.message;\n      this.updateStatus(\"✗ Compile Error\", \"error\");\n\n      // Try to extract line number from error message\n      // Common patterns: \"at line 5\", \"line 5\", \":5:\", \"(5:\"\n      const lineMatch = e.message.match(/(?:at line |line |:|\\()(\\d+)(?::|,|\\))/i);\n      const line = lineMatch ? parseInt(lineMatch[1], 10) - 1 : 0; // 0-indexed\n\n      session.setAnnotations([\n        {\n          row: line,\n          column: 0,\n          text: e.message,\n          type: \"error\",\n        },\n      ]);\n\n      const result = { success: false, fn: null, error: e.message, line };\n      this.onCompile?.(result);\n      return result;\n    }\n  }\n\n  /**\n   * Run the compiled action on a parse tree node\n   */\n  run(node: any): ActionRunResult {\n    if (!node) {\n      return { success: false, result: null, error: \"No parse result available\", line: null };\n    }\n\n    if (this.compileError) {\n      return { success: false, result: null, error: `Compile Error: ${this.compileError}`, line: null };\n    }\n\n    if (!this.compiledFn) {\n      return { success: true, result: null, error: null, line: null }; // No action code\n    }\n\n    try {\n      const result = this.compiledFn(node);\n      // Clear runtime error annotations\n      if (this.editor) {\n        this.editor.session.clearAnnotations();\n      }\n      this.updateStatus(\"✓\", \"success\");\n      return { success: true, result, error: null, line: null };\n    } catch (e: any) {\n      // Try to extract line number from runtime error stack\n      const stack = e.stack || \"\";\n      const lineMatch = stack.match(/<anonymous>:(\\d+):/);\n      const line = lineMatch ? parseInt(lineMatch[1], 10) - 1 : null; // 0-indexed\n\n      // Set runtime error annotation\n      if (this.editor && line !== null) {\n        this.editor.session.setAnnotations([\n          {\n            row: line,\n            column: 0,\n            text: e.message,\n            type: \"error\",\n          },\n        ]);\n      }\n\n      this.updateStatus(\"✗ Runtime Error\", \"error\");\n      return { success: false, result: null, error: e.message, line };\n    }\n  }\n\n  /**\n   * Get the current compile error (if any)\n   */\n  getCompileError(): string | null {\n    return this.compileError;\n  }\n\n  /**\n   * Check if there's a compiled action function\n   */\n  hasCompiledAction(): boolean {\n    return this.compiledFn !== null;\n  }\n\n  /**\n   * Update status element\n   */\n  private updateStatus(text: string, statusClass: string): void {\n    if (this.statusEl) {\n      this.statusEl.textContent = text;\n      // Clear and set status classes without removing base class\n      this.statusEl.classList.remove(\"success\", \"error\");\n      if (statusClass) {\n        this.statusEl.classList.add(statusClass);\n      }\n    }\n  }\n\n  /**\n   * Clear annotations and status\n   */\n  clear(): void {\n    if (this.editor) {\n      this.editor.session.clearAnnotations();\n    }\n    this.compiledFn = null;\n    this.compileError = null;\n    this.updateStatus(\"\", \"\");\n  }\n}\n"]}

package/dist/docs/index.mjs

@@ -0,0 +1,226 @@
+// src/docs/CodeBlock.ts
+var CodeBlock = class {
+  constructor(preElement) {
+    this.codeElement = preElement.querySelector("code") || preElement;
+    this.container = document.createElement("div");
+    this.container.className = "code-block";
+    preElement.parentNode?.insertBefore(this.container, preElement);
+    this.container.appendChild(preElement);
+    this.copyButton = document.createElement("button");
+    this.copyButton.className = "code-block-copy";
+    this.copyButton.setAttribute("aria-label", "Copy code");
+    this.copyButton.innerHTML = this.getCopyIcon();
+    this.copyButton.addEventListener("click", () => this.copyCode());
+    this.container.appendChild(this.copyButton);
+  }
+  getCopyIcon() {
+    return `<svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+      <rect x="9" y="9" width="13" height="13" rx="2" ry="2"></rect>
+      <path d="M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1"></path>
+    </svg>`;
+  }
+  getCheckIcon() {
+    return `<svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+      <polyline points="20 6 9 17 4 12"></polyline>
+    </svg>`;
+  }
+  async copyCode() {
+    const text = this.codeElement.textContent || "";
+    try {
+      await navigator.clipboard.writeText(text);
+      this.showSuccess();
+    } catch (err) {
+      this.fallbackCopy(text);
+    }
+  }
+  fallbackCopy(text) {
+    const textarea = document.createElement("textarea");
+    textarea.value = text;
+    textarea.style.position = "fixed";
+    textarea.style.opacity = "0";
+    document.body.appendChild(textarea);
+    textarea.select();
+    try {
+      document.execCommand("copy");
+      this.showSuccess();
+    } catch (err) {
+      console.error("Failed to copy:", err);
+    }
+    document.body.removeChild(textarea);
+  }
+  showSuccess() {
+    this.copyButton.innerHTML = this.getCheckIcon();
+    this.copyButton.classList.add("copied");
+    setTimeout(() => {
+      this.copyButton.innerHTML = this.getCopyIcon();
+      this.copyButton.classList.remove("copied");
+    }, 2e3);
+  }
+};
+function initCodeBlocks(selector = ".content-body pre") {
+  const preElements = document.querySelectorAll(selector);
+  preElements.forEach((pre) => {
+    if (pre.parentElement?.classList.contains("code-block")) {
+      return;
+    }
+    if (pre.querySelector("pre")) {
+      return;
+    }
+    new CodeBlock(pre);
+  });
+}
+
+// src/docs/pageSetup.ts
+function highlightActiveSidebarLink(sidebarSelector = ".sidebar .section-nav a") {
+  const currentPath = window.location.pathname;
+  const sidebarLinks = document.querySelectorAll(sidebarSelector);
+  sidebarLinks.forEach((link) => {
+    const href = link.getAttribute("href");
+    if (href && currentPath.endsWith(href.replace(/\/$/, "") + "/")) {
+      link.classList.add("active");
+    } else if (href && currentPath === href) {
+      link.classList.add("active");
+    }
+  });
+}
+function initPageSetup(options = {}) {
+  highlightActiveSidebarLink(options.sidebarSelector);
+}
+
+// src/docs/ActionCompiler.ts
+var ActionCompiler = class {
+  constructor(editor, statusEl = null, onCompile = null) {
+    this.editor = null;
+    this.compiledFn = null;
+    this.compileError = null;
+    this.statusEl = null;
+    this.onCompile = null;
+    this.editor = editor;
+    this.statusEl = statusEl;
+    this.onCompile = onCompile;
+    let compileTimeout = null;
+    this.editor.session.on("change", () => {
+      if (compileTimeout) clearTimeout(compileTimeout);
+      compileTimeout = window.setTimeout(() => this.compile(), 300);
+    });
+  }
+  /**
+   * Compile the current editor content
+   */
+  compile() {
+    if (!this.editor) {
+      return { success: false, fn: null, error: "No editor", line: null };
+    }
+    const code = this.editor.getValue().trim();
+    const session = this.editor.session;
+    session.clearAnnotations();
+    this.compiledFn = null;
+    this.compileError = null;
+    if (!code) {
+      this.updateStatus("", "");
+      const result = { success: true, fn: null, error: null, line: null };
+      this.onCompile?.(result);
+      return result;
+    }
+    try {
+      this.compiledFn = new Function("node", code);
+      this.updateStatus("\u2713", "success");
+      const result = { success: true, fn: this.compiledFn, error: null, line: null };
+      this.onCompile?.(result);
+      return result;
+    } catch (e) {
+      this.compileError = e.message;
+      this.updateStatus("\u2717 Compile Error", "error");
+      const lineMatch = e.message.match(/(?:at line |line |:|\()(\d+)(?::|,|\))/i);
+      const line = lineMatch ? parseInt(lineMatch[1], 10) - 1 : 0;
+      session.setAnnotations([
+        {
+          row: line,
+          column: 0,
+          text: e.message,
+          type: "error"
+        }
+      ]);
+      const result = { success: false, fn: null, error: e.message, line };
+      this.onCompile?.(result);
+      return result;
+    }
+  }
+  /**
+   * Run the compiled action on a parse tree node
+   */
+  run(node) {
+    if (!node) {
+      return { success: false, result: null, error: "No parse result available", line: null };
+    }
+    if (this.compileError) {
+      return { success: false, result: null, error: `Compile Error: ${this.compileError}`, line: null };
+    }
+    if (!this.compiledFn) {
+      return { success: true, result: null, error: null, line: null };
+    }
+    try {
+      const result = this.compiledFn(node);
+      if (this.editor) {
+        this.editor.session.clearAnnotations();
+      }
+      this.updateStatus("\u2713", "success");
+      return { success: true, result, error: null, line: null };
+    } catch (e) {
+      const stack = e.stack || "";
+      const lineMatch = stack.match(/<anonymous>:(\d+):/);
+      const line = lineMatch ? parseInt(lineMatch[1], 10) - 1 : null;
+      if (this.editor && line !== null) {
+        this.editor.session.setAnnotations([
+          {
+            row: line,
+            column: 0,
+            text: e.message,
+            type: "error"
+          }
+        ]);
+      }
+      this.updateStatus("\u2717 Runtime Error", "error");
+      return { success: false, result: null, error: e.message, line };
+    }
+  }
+  /**
+   * Get the current compile error (if any)
+   */
+  getCompileError() {
+    return this.compileError;
+  }
+  /**
+   * Check if there's a compiled action function
+   */
+  hasCompiledAction() {
+    return this.compiledFn !== null;
+  }
+  /**
+   * Update status element
+   */
+  updateStatus(text, statusClass) {
+    if (this.statusEl) {
+      this.statusEl.textContent = text;
+      this.statusEl.classList.remove("success", "error");
+      if (statusClass) {
+        this.statusEl.classList.add(statusClass);
+      }
+    }
+  }
+  /**
+   * Clear annotations and status
+   */
+  clear() {
+    if (this.editor) {
+      this.editor.session.clearAnnotations();
+    }
+    this.compiledFn = null;
+    this.compileError = null;
+    this.updateStatus("", "");
+  }
+};
+
+export { ActionCompiler, CodeBlock, highlightActiveSidebarLink, initCodeBlocks, initPageSetup };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/docs/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/docs/CodeBlock.ts","../../src/docs/pageSetup.ts","../../src/docs/ActionCompiler.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["/**\n * CodeBlock.ts - Enhances pre/code blocks with copy functionality\n * Automatically finds all pre>code elements and adds a copy button\n */\n\nexport class CodeBlock {\n  private container: HTMLElement;\n  private copyButton: HTMLButtonElement;\n  private codeElement: HTMLElement;\n\n  constructor(preElement: HTMLPreElement) {\n    this.codeElement = preElement.querySelector('code') || preElement;\n\n    // Wrap pre in a container for positioning\n    this.container = document.createElement('div');\n    this.container.className = 'code-block';\n    preElement.parentNode?.insertBefore(this.container, preElement);\n    this.container.appendChild(preElement);\n\n    // Create copy button\n    this.copyButton = document.createElement('button');\n    this.copyButton.className = 'code-block-copy';\n    this.copyButton.setAttribute('aria-label', 'Copy code');\n    this.copyButton.innerHTML = this.getCopyIcon();\n    this.copyButton.addEventListener('click', () => this.copyCode());\n\n    this.container.appendChild(this.copyButton);\n  }\n\n  private getCopyIcon(): string {\n    return `<svg width=\"16\" height=\"16\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\">\n      <rect x=\"9\" y=\"9\" width=\"13\" height=\"13\" rx=\"2\" ry=\"2\"></rect>\n      <path d=\"M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1\"></path>\n    </svg>`;\n  }\n\n  private getCheckIcon(): string {\n    return `<svg width=\"16\" height=\"16\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\">\n      <polyline points=\"20 6 9 17 4 12\"></polyline>\n    </svg>`;\n  }\n\n  private async copyCode(): Promise<void> {\n    const text = this.codeElement.textContent || '';\n\n    try {\n      await navigator.clipboard.writeText(text);\n      this.showSuccess();\n    } catch (err) {\n      // Fallback for older browsers\n      this.fallbackCopy(text);\n    }\n  }\n\n  private fallbackCopy(text: string): void {\n    const textarea = document.createElement('textarea');\n    textarea.value = text;\n    textarea.style.position = 'fixed';\n    textarea.style.opacity = '0';\n    document.body.appendChild(textarea);\n    textarea.select();\n\n    try {\n      document.execCommand('copy');\n      this.showSuccess();\n    } catch (err) {\n      console.error('Failed to copy:', err);\n    }\n\n    document.body.removeChild(textarea);\n  }\n\n  private showSuccess(): void {\n    this.copyButton.innerHTML = this.getCheckIcon();\n    this.copyButton.classList.add('copied');\n\n    setTimeout(() => {\n      this.copyButton.innerHTML = this.getCopyIcon();\n      this.copyButton.classList.remove('copied');\n    }, 2000);\n  }\n}\n\n/**\n * Initialize all code blocks on the page\n * @param selector - CSS selector for finding pre elements (default: '.content-body pre')\n */\nexport function initCodeBlocks(selector: string = '.content-body pre'): void {\n  const preElements = document.querySelectorAll(selector);\n\n  preElements.forEach((pre) => {\n    // Skip if already initialized\n    if (pre.parentElement?.classList.contains('code-block')) {\n      return;\n    }\n    // Skip if this pre contains another pre (outer wrapper of double-wrapped code blocks)\n    // We only want to process the innermost pre that has the actual code\n    if (pre.querySelector('pre')) {\n      return;\n    }\n    new CodeBlock(pre as HTMLPreElement);\n  });\n}\n","/**\n * pageSetup.ts - Common page initialization shared across all doc pages\n */\n\n/**\n * Highlights the currently active link in the sidebar navigation\n * @param sidebarSelector - CSS selector for sidebar links (default: '.sidebar .section-nav a')\n */\nexport function highlightActiveSidebarLink(sidebarSelector: string = '.sidebar .section-nav a'): void {\n  const currentPath = window.location.pathname;\n  const sidebarLinks = document.querySelectorAll(sidebarSelector);\n\n  sidebarLinks.forEach((link) => {\n    const href = link.getAttribute('href');\n    if (href && currentPath.endsWith(href.replace(/\\/$/, '') + '/')) {\n      link.classList.add('active');\n    } else if (href && currentPath === href) {\n      link.classList.add('active');\n    }\n  });\n}\n\n/**\n * Initialize common page features\n * Call this on DOMContentLoaded for all doc pages\n * @param options - Configuration options for page setup\n */\nexport function initPageSetup(options: {\n  sidebarSelector?: string;\n} = {}): void {\n  highlightActiveSidebarLink(options.sidebarSelector);\n}\n","/**\n * ActionCompiler - Shared action code compilation and execution\n * Used by docs components like ExampleRunner and PlaygroundPage\n */\n\nimport ace from \"ace-builds\";\n\nexport interface ActionCompileResult {\n  success: boolean;\n  fn: ((node: any) => any) | null;\n  error: string | null;\n  line: number | null; // 0-indexed line number for error\n}\n\nexport interface ActionRunResult {\n  success: boolean;\n  result: any;\n  error: string | null;\n  line: number | null; // 0-indexed line number for runtime error\n}\n\nexport class ActionCompiler {\n  private editor: ace.Ace.Editor | null = null;\n  private compiledFn: ((node: any) => any) | null = null;\n  private compileError: string | null = null;\n  private statusEl: HTMLElement | null = null;\n  private onCompile: ((result: ActionCompileResult) => void) | null = null;\n\n  constructor(\n    editor: ace.Ace.Editor,\n    statusEl: HTMLElement | null = null,\n    onCompile: ((result: ActionCompileResult) => void) | null = null,\n  ) {\n    this.editor = editor;\n    this.statusEl = statusEl;\n    this.onCompile = onCompile;\n\n    // Setup change listener with debounce\n    let compileTimeout: number | null = null;\n    this.editor.session.on(\"change\", () => {\n      if (compileTimeout) clearTimeout(compileTimeout);\n      compileTimeout = window.setTimeout(() => this.compile(), 300);\n    });\n  }\n\n  /**\n   * Compile the current editor content\n   */\n  compile(): ActionCompileResult {\n    if (!this.editor) {\n      return { success: false, fn: null, error: \"No editor\", line: null };\n    }\n\n    const code = this.editor.getValue().trim();\n    const session = this.editor.session;\n\n    // Clear previous annotations\n    session.clearAnnotations();\n    this.compiledFn = null;\n    this.compileError = null;\n\n    if (!code) {\n      this.updateStatus(\"\", \"\");\n      const result = { success: true, fn: null, error: null, line: null };\n      this.onCompile?.(result);\n      return result;\n    }\n\n    try {\n      // Compile using new Function\n      this.compiledFn = new Function(\"node\", code) as (node: any) => any;\n      this.updateStatus(\"✓\", \"success\");\n      const result = { success: true, fn: this.compiledFn, error: null, line: null };\n      this.onCompile?.(result);\n      return result;\n    } catch (e: any) {\n      this.compileError = e.message;\n      this.updateStatus(\"✗ Compile Error\", \"error\");\n\n      // Try to extract line number from error message\n      // Common patterns: \"at line 5\", \"line 5\", \":5:\", \"(5:\"\n      const lineMatch = e.message.match(/(?:at line |line |:|\\()(\\d+)(?::|,|\\))/i);\n      const line = lineMatch ? parseInt(lineMatch[1], 10) - 1 : 0; // 0-indexed\n\n      session.setAnnotations([\n        {\n          row: line,\n          column: 0,\n          text: e.message,\n          type: \"error\",\n        },\n      ]);\n\n      const result = { success: false, fn: null, error: e.message, line };\n      this.onCompile?.(result);\n      return result;\n    }\n  }\n\n  /**\n   * Run the compiled action on a parse tree node\n   */\n  run(node: any): ActionRunResult {\n    if (!node) {\n      return { success: false, result: null, error: \"No parse result available\", line: null };\n    }\n\n    if (this.compileError) {\n      return { success: false, result: null, error: `Compile Error: ${this.compileError}`, line: null };\n    }\n\n    if (!this.compiledFn) {\n      return { success: true, result: null, error: null, line: null }; // No action code\n    }\n\n    try {\n      const result = this.compiledFn(node);\n      // Clear runtime error annotations\n      if (this.editor) {\n        this.editor.session.clearAnnotations();\n      }\n      this.updateStatus(\"✓\", \"success\");\n      return { success: true, result, error: null, line: null };\n    } catch (e: any) {\n      // Try to extract line number from runtime error stack\n      const stack = e.stack || \"\";\n      const lineMatch = stack.match(/<anonymous>:(\\d+):/);\n      const line = lineMatch ? parseInt(lineMatch[1], 10) - 1 : null; // 0-indexed\n\n      // Set runtime error annotation\n      if (this.editor && line !== null) {\n        this.editor.session.setAnnotations([\n          {\n            row: line,\n            column: 0,\n            text: e.message,\n            type: \"error\",\n          },\n        ]);\n      }\n\n      this.updateStatus(\"✗ Runtime Error\", \"error\");\n      return { success: false, result: null, error: e.message, line };\n    }\n  }\n\n  /**\n   * Get the current compile error (if any)\n   */\n  getCompileError(): string | null {\n    return this.compileError;\n  }\n\n  /**\n   * Check if there's a compiled action function\n   */\n  hasCompiledAction(): boolean {\n    return this.compiledFn !== null;\n  }\n\n  /**\n   * Update status element\n   */\n  private updateStatus(text: string, statusClass: string): void {\n    if (this.statusEl) {\n      this.statusEl.textContent = text;\n      // Clear and set status classes without removing base class\n      this.statusEl.classList.remove(\"success\", \"error\");\n      if (statusClass) {\n        this.statusEl.classList.add(statusClass);\n      }\n    }\n  }\n\n  /**\n   * Clear annotations and status\n   */\n  clear(): void {\n    if (this.editor) {\n      this.editor.session.clearAnnotations();\n    }\n    this.compiledFn = null;\n    this.compileError = null;\n    this.updateStatus(\"\", \"\");\n  }\n}\n"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@panyam/tsappkit",
-  "version": "0.0.3",
-  "description": "TypeScript application toolkit with component lifecycle management, event system, and UI utilities",
+  "version": "0.0.4",
+  "description": "TypeScript application toolkit with component lifecycle management, event system, UI utilities, and documentation site components",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
   "types": "dist/index.d.ts",
@@ -10,34 +10,55 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.mjs",
       "require": "./dist/index.js"
-    }
+    },
+    "./docs": {
+      "types": "./dist/docs/index.d.ts",
+      "import": "./dist/docs/index.mjs",
+      "require": "./dist/docs/index.js"
+    },
+    "./styles/*": "./styles/*",
+    "./dist/*": "./dist/*"
   },
   "files": [
     "dist",
-    "src"
+    "src",
+    "styles"
   ],
+  "scripts": {
+    "build": "tsup && npm run build:css",
+    "build:css": "sass styles/docs/DocsPage.scss dist/docs/DocsPage.css --style=expanded && sass styles/docs/DocsPage.scss dist/docs/DocsPage.min.css --style=compressed",
+    "dev": "tsup --watch",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run build",
+    "typecheck": "tsc --noEmit"
+  },
   "keywords": [
     "typescript",
     "component",
     "lifecycle",
     "event-bus",
-    "ui-toolkit"
+    "ui-toolkit",
+    "documentation",
+    "docs-components"
   ],
   "author": "panyam",
   "license": "MIT",
   "devDependencies": {
+    "ace-builds": "^1.43.0",
+    "sass": "^1.77.0",
     "tsup": "^8.0.0",
     "typescript": "^5.0.0"
   },
-  "peerDependencies": {},
+  "peerDependencies": {
+    "ace-builds": "^1.0.0"
+  },
+  "peerDependenciesMeta": {
+    "ace-builds": {
+      "optional": true
+    }
+  },
   "repository": {
     "type": "git",
     "url": ""
-  },
-  "scripts": {
-    "build": "tsup",
-    "dev": "tsup --watch",
-    "clean": "rm -rf dist",
-    "typecheck": "tsc --noEmit"
   }
-}
+}