@zikojs/notebook 0.7.3 → 0.9.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@zikojs/notebook",
-  "version": "0.7.3",
-  "description": "",
+  "version": "0.9.0",
+  "description": "A lightweight, extensible JavaScript notebook component with Markdown, executable cells, persistent state, and pluggable runtimes.",
   "type": "module",
   "publishConfig": {
     "access": "public"

package/src/compiler/evaluate.js

@@ -0,0 +1,97 @@
+import { transformImportsAndScope } from "./transform.js";
+
+export const evaluateCodeAsync = async (
+  code,
+  TARGET,
+  {
+    importMap = {},
+    plugins = [],
+    runtime = null,
+  } = {},
+  scope,
+) => {
+  const validScope =
+    scope || Object.create(null);
+
+  const context = {
+    TARGET,
+    scope: validScope,
+    importMap,
+    plugins,
+    runtime,
+  };
+
+  const selectedPlugin = plugins.find(
+    p => p.name === runtime,
+  );
+
+  // Runtime-specific evaluator
+  if (
+    selectedPlugin &&
+    selectedPlugin.evaluate
+  ) {
+    return await selectedPlugin.evaluate(
+      code,
+      context,
+    );
+  }
+
+  let compiledCode = code;
+
+  for (const plugin of plugins) {
+    if (
+      selectedPlugin &&
+      plugin.name !== runtime
+    ) {
+      continue;
+    }
+
+    if (plugin.transform) {
+      compiledCode = await plugin.transform(
+        compiledCode,
+        context,
+      );
+    }
+  }
+
+  compiledCode =
+    transformImportsAndScope(
+      compiledCode,
+      importMap,
+    );
+
+  const runCell = new Function(
+    "TARGET",
+    "__scope__",
+    `
+      return (async () => {
+        with (__scope__) {
+          ${compiledCode}
+        }
+      })();
+    `,
+  );
+
+  let result = await runCell(
+    TARGET,
+    validScope,
+  );
+
+  for (const plugin of plugins) {
+    if (
+      selectedPlugin &&
+      plugin.name !== runtime
+    ) {
+      continue;
+    }
+
+    if (plugin.afterEvaluate) {
+      result = await plugin.afterEvaluate(
+        result,
+        context,
+      );
+    }
+  }
+
+  return result;
+};

package/src/compiler/imports.js

@@ -0,0 +1,94 @@
+export const resolveImport = (
+  source,
+  {
+    importMap = {},
+    plugins = [],
+  } = {},
+) => {
+  if (importMap[source]) {
+    return importMap[source];
+  }
+
+  for (const plugin of plugins) {
+    if (plugin.resolveImport) {
+      const resolved = plugin.resolveImport(
+        source,
+      );
+
+      if (resolved) {
+        return resolved;
+      }
+    }
+  }
+
+  if (
+    source.startsWith("http://") ||
+    source.startsWith("https://") ||
+    source.startsWith("./") ||
+    source.startsWith("../")
+  ) {
+    return source;
+  }
+
+  return `https://esm.sh/${source}`;
+};
+
+export const rewriteImportNode = (
+  node,
+  code,
+  context,
+) => {
+  const source = resolveImport(
+    node.source.value,
+    context,
+  );
+
+  if (node.specifiers.length === 0) {
+    return `await import("${source}");`;
+  }
+
+  let defaultImportName = null;
+  let namespaceId = null;
+  const namedImports = [];
+
+  node.specifiers.forEach((spec) => {
+    if (spec.type === "ImportNamespaceSpecifier") {
+      namespaceId = spec.local.name;
+    } else if (spec.type === "ImportDefaultSpecifier") {
+      defaultImportName = spec.local.name;
+    } else if (spec.type === "ImportSpecifier") {
+      namedImports.push({
+        imported: spec.imported.name,
+        local: spec.local.name,
+      });
+    }
+  });
+
+  if (namespaceId) {
+    return `__scope__.${namespaceId} = await import("${source}");`;
+  }
+
+  const tmp = `__mod_${node.start}`;
+
+  const lines = [
+    `const ${tmp} = await import("${source}");`,
+  ];
+
+  if (defaultImportName) {
+    lines.push(
+      `__scope__.${defaultImportName} = ` +
+      `${tmp}.default ?? ${tmp};`,
+    );
+  }
+
+  namedImports.forEach(({ imported, local }) => {
+    lines.push(
+      `__scope__.${local} = ` +
+      `${tmp}.${imported} !== undefined ` +
+      `? ${tmp}.${imported} ` +
+      `: (${tmp}.default ?? ${tmp});`,
+    );
+  });
+
+  return lines.join("\n");
+};

package/src/compiler/index.js

@@ -0,0 +1,12 @@
+export {
+  evaluateCodeAsync,
+} from "./evaluate.js";
+
+export {
+  transformImportsAndScope,
+} from "./transform.js";
+
+export {
+  resolveImport,
+  rewriteImportNode,
+} from "./imports.js";

package/src/compiler/scope.js

@@ -0,0 +1,95 @@
+export const rewriteVariableDeclaration = (
+  node,
+  code,
+) => {
+  let replacementCode = "";
+
+  node.declarations.forEach((decl) => {
+    const initCode = decl.init
+      ? code.slice(decl.init.start, decl.init.end)
+      : "undefined";
+
+    if (decl.id.type === "Identifier") {
+      const varName = decl.id.name;
+
+      replacementCode +=
+        `__scope__.${varName} = ${initCode};\n`;
+
+      return;
+    }
+
+    if (decl.id.type === "ObjectPattern") {
+      const tempVar = `__destruct_obj_${decl.start}`;
+
+      replacementCode +=
+        `(() => { const ${tempVar} = ${initCode}; `;
+
+      decl.id.properties.forEach((prop) => {
+        if (
+          prop.value &&
+          prop.value.type === "Identifier"
+        ) {
+          const localName = prop.value.name;
+
+          const keyName =
+            prop.key.type === "Identifier"
+              ? prop.key.name
+              : prop.key.value;
+
+          replacementCode +=
+            `__scope__.${localName} = ` +
+            `${tempVar}.${keyName}; `;
+        }
+      });
+
+      replacementCode += `})();\n`;
+
+      return;
+    }
+
+    if (decl.id.type === "ArrayPattern") {
+      const tempVar = `__destruct_arr_${decl.start}`;
+
+      replacementCode +=
+        `(() => { const ${tempVar} = ${initCode}; `;
+
+      decl.id.elements.forEach((elem, index) => {
+        if (elem && elem.type === "Identifier") {
+          replacementCode +=
+            `__scope__.${elem.name} = ` +
+            `${tempVar}[${index}]; `;
+        }
+      });
+
+      replacementCode += `})();\n`;
+    }
+  });
+
+  return replacementCode;
+};
+
+export const rewriteFunctionDeclaration = (
+  node,
+  code,
+) => {
+  const name = node.id.name;
+  const body = code.slice(node.start, node.end);
+
+  return (
+    `__scope__.${name} = ` +
+    body.replace(/^function\s+\w+/, "function")
+  );
+};
+
+export const rewriteClassDeclaration = (
+  node,
+  code,
+) => {
+  const name = node.id.name;
+  const body = code.slice(node.start, node.end);
+
+  return (
+    `__scope__.${name} = ` +
+    body.replace(/^class\s+\w+/, "class")
+  );
+};

package/src/compiler/transform.js

@@ -0,0 +1,127 @@
+import * as acorn from "acorn";
+
+import {
+  rewriteImportNode,
+} from "./imports.js";
+
+import {
+  rewriteVariableDeclaration,
+  rewriteFunctionDeclaration,
+  rewriteClassDeclaration,
+} from "./scope.js";
+
+export const transformImportsAndScope = (
+  code,
+  {
+    importMap = {},
+    plugins = [],
+  } = {},
+) => {
+  try {
+    const ast = acorn.parse(code, {
+      ecmaVersion: "latest",
+      sourceType: "module",
+      allowReturnOutsideFunction: true,
+    });
+
+    const context = {
+      importMap,
+      plugins,
+    };
+
+    const modifications = [];
+
+    ast.body.forEach((node) => {
+      if (node.type === "ImportDeclaration") {
+        modifications.push({
+          start: node.start,
+          end: node.end,
+          replacement: rewriteImportNode(
+            node,
+            code,
+            context,
+          ),
+        });
+
+        return;
+      }
+
+      if (node.type === "VariableDeclaration") {
+        modifications.push({
+          start: node.start,
+          end: node.end,
+          replacement: rewriteVariableDeclaration(
+            node,
+            code,
+          ),
+        });
+
+        return;
+      }
+
+      if (
+        node.type === "FunctionDeclaration" &&
+        node.id
+      ) {
+        modifications.push({
+          start: node.start,
+          end: node.end,
+          replacement: rewriteFunctionDeclaration(
+            node,
+            code,
+          ),
+        });
+
+        return;
+      }
+
+      if (
+        node.type === "ClassDeclaration" &&
+        node.id
+      ) {
+        modifications.push({
+          start: node.start,
+          end: node.end,
+          replacement: rewriteClassDeclaration(
+            node,
+            code,
+          ),
+        });
+      }
+    });
+
+    modifications.sort(
+      (a, b) => b.start - a.start,
+    );
+
+    let transformedCode = code;
+
+    modifications.forEach((modification) => {
+      transformedCode =
+        transformedCode.slice(
+          0,
+          modification.start,
+        ) +
+        modification.replacement +
+        transformedCode.slice(
+          modification.end,
+        );
+    });
+
+    return transformedCode;
+  } catch (error) {
+    if (
+      code.trim().startsWith("import ") ||
+      code.includes("\nimport ")
+    ) {
+      throw new SyntaxError(
+        "Invalid code module layout syntax.",
+        {
+          cause: error,
+        },
+      );
+    }
+
+    return code;
+  }
+};

package/src/components/Button/index.css

@@ -0,0 +1,55 @@
+/* --- BUTTONS --- */
+
+.ziko-notebook .btn {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  gap: 6px;
+  background: #ffffff;
+  border: 1px solid var(--border-color);
+  padding: 6px 10px;
+  border-radius: 4px;
+  font-size: 12px;
+  font-weight: 500;
+  color: #334155;
+  cursor: pointer;
+  line-height: 1;
+  white-space: nowrap;
+  transition: background 0.12s ease, border-color 0.12s ease;
+}
+
+.ziko-notebook .btn:hover {
+  background: #f1f5f9;
+}
+
+.ziko-notebook .btn:disabled {
+  opacity: 0.5;
+  cursor: not-allowed;
+}
+
+.ziko-notebook .btn-icon {
+  padding: 6px;
+  border-radius: 4px;
+}
+
+.ziko-notebook .btn-primary {
+  background: var(--primary);
+  color: #ffffff;
+  border-color: var(--primary);
+}
+
+.ziko-notebook .btn-primary:hover {
+  background: var(--primary-hover);
+  border-color: var(--primary-hover);
+}
+
+.ziko-notebook .btn-active {
+  background: #e2e8f0;
+  border-color: #cbd5e1;
+}
+
+.ziko-notebook .icon {
+  width: 14px;
+  height: 14px;
+  stroke-width: 2;
+}

package/src/components/Button/index.js

@@ -0,0 +1,4 @@
+import van from "vanjs-core";
+
+export const Button = ({ class: className = "", title = "", disabled = false, onclick }, ...children) =>
+  van.tags.button({ class: `btn ${className}`, title, disabled, onclick }, ...children);

package/src/{components.js → components/CellItem/index.js}

@@ -1,9 +1,6 @@
-import van from "vanjs-core";
-import { remark } from "remark";
-import remarkRehype from "remark-rehype";
-import rehypeStringify from "rehype-stringify";
-import { createCodeEditor } from "./codeEditor.js";
-
+import { createCodeEditor } from "../../code-editor/index.js";
+import { tags } from 'ziko/dom'
+import { useState } from 'ziko/hooks'
 import {
   Check,
   Copy,
@@ -15,68 +12,55 @@ import {
   Play,
   Plus,
   Trash2,
-  PlayForward,
-  Eraser,
-  Download,
-  Loader2
-} from './icons.js';
-
-const { button } = van.tags;
-
-import { tags } from 'ziko/dom'
+} from '../icons/index.js';
+const { div, span } = tags;
 
-const { div, span } = tags
-
-export const Button = ({ class: className = "", title = "", disabled = false, onclick }, ...children) =>
-  button({ class: `btn ${className}`, title, disabled, onclick }, ...children);
-
-export function Header({ store, actions }) {
-  const statusBadge = span({ class: "status-badge" }, Loader2(), span('Loading ...'));
-  const runAllBtn = Button({ class: "btn-primary", onclick: actions.runAll }, PlayForward(), "Run All");
-  const clearBtn = Button({ onclick: actions.clearOutputs }, Eraser(), "Clear Outputs");
-  const addCodeBtn = Button({ onclick: actions.addCode }, Plus(), "Add Code");
-  const addMdBtn = Button({ onclick: actions.addMarkdown }, FileText(), "Add Markdown");
-  const deleteActiveBtn = Button({ onclick: actions.deleteActive }, Trash2(), "Delete Active");
-  const exportBtn = Button({ onclick: actions.exportData }, Download(), "Export Data");
-
-  store.on('change:executionQueueState', (q) => {
-    statusBadge.style({display :q.isRunning ? "inline-flex" : "none" })
-    statusBadge.element.lastChild.textContent = `Executing Queue (${q.currentIndex + 1}/${q.total})`;
-    [runAllBtn, clearBtn, deleteActiveBtn].forEach(b => { b.disabled = q.isRunning; });
-    const maxReached = store.get('cells').length >= store.get('maxCells');
-    addCodeBtn.disabled = q.isRunning || maxReached;
-    addMdBtn.disabled = q.isRunning || maxReached;
-  });
+import { Button } from "../Button/index.js";
 
-  return div({ class: "header" },
-    div({ class: "brand" }, "</>", statusBadge),
-    div({ class: "toolbar" }, 
-      runAllBtn, clearBtn, addCodeBtn, addMdBtn, deleteActiveBtn, exportBtn
-    )
-  ).element;
+export const Prompt = () => {
+  return span({ class: "prompt" })
 }
 
-export function MarkdownView({ cellData, actions }) {
-  const content = div();
+export function CellItem({ cellData, app, store }) {
+  const outputRef = div({ class: "output-area" });
+  if (cellData.outputNode) outputRef.append(cellData.outputNode);
+  cellData._outputRef = outputRef.element;
+
+  const actions = app._cellActions(cellData);
+  cellData._actions = actions;
+  cellData._editor = createCodeEditor(app, cellData, actions);
   
-  // Process Markdown asynchronously using Remark + Rehype
-  remark()
-    .use(remarkRehype, { allowDangerousHtml: true })
-    .use(rehypeStringify)
-    .process(cellData.code || "*Empty Markdown Cell*")
-    .then((file) => {
-      content.element.innerHTML = String(file);
-    })
-    .catch((err) => {
-      content.element.innerHTML = `<div class="error-output">Markdown rendering error: ${err.message}</div>`;
-    });
+  /* Check ziko */
+  const [In, setIn] = useState(0);
+  globalThis.setIn = setIn;
+  const inPrompt = span({ class: "prompt" }, In);
+  const outPrompt = span({ class: "prompt out" });
+  const bodySlot = div().style({ display: 'contents' });
   
-  const wrap = div({ class: "markdown-rendered-cell markdown-body" }, content);
-  wrap.onClick(() => actions.editMarkdown())
-  return wrap.element;
-}
+  // Pass runtimePlugins from app into CellControls
+  const controlsEl = CellControls({ 
+    cellData, 
+    store, 
+    actions, 
+    runtimePlugins: app.runtimePlugins 
+  });
+
+  const outputGrid = div({ class: "cell-output-grid" }, outPrompt, div({ class: "output-wrapper" }, outputRef));
+  const inputGrid = div({ class: "cell-input-grid" }, inPrompt, bodySlot, controlsEl);
+  const root = div({ class: "cell" }, inputGrid, outputGrid);
+  root.onClick(() => app.setActiveCell(cellData.id));
 
-export function CellControls({ cellData, store, actions }) {
+  cellData._dom = root.element;
+  cellData._inPrompt = inPrompt.element;
+  cellData._outPrompt = outPrompt.element;
+  cellData._bodySlot = bodySlot.element;
+  cellData._outputGrid = outputGrid.element;
+  cellData._setIn = setIn;
+
+  app._refreshCell(cellData);
+  return root.element;
+}
+export function CellControls({ cellData, store, actions, runtimePlugins = [] }) {
   const controlsContainer = div({ class: "cell-controls" }).element;
 
   const renderButtons = () => {
@@ -84,7 +68,38 @@ export function CellControls({ cellData, store, actions }) {
     const isMaxCellsReached = store.get('cells').length >= store.get('maxCells');
     const isCopied = cellData._copiedFlag === true;
 
-    controlsContainer.replaceChildren(
+    // Build the runtime selector dropdown for code cells using native DOM options
+    let runtimeSelectEl = null;
+    if (cellData.type === "code") {
+      const selectElement = document.createElement("select");
+      selectElement.className = "runtime-select";
+      selectElement.title = "Select Cell Runtime";
+      selectElement.disabled = cellData.readonly;
+      
+      selectElement.onchange = (e) => {
+        actions.setRuntime(e.target.value === "" ? null : e.target.value);
+      };
+
+      // Default JS option
+      const optJs = document.createElement("option");
+      optJs.value = "";
+      optJs.textContent = "JS";
+      selectElement.appendChild(optJs);
+
+      // Runtime plugin options
+      for (const p of runtimePlugins) {
+        const opt = document.createElement("option");
+        opt.value = p.name;
+        opt.textContent = p.name.charAt(0).toUpperCase() + p.name.slice(1);
+        selectElement.appendChild(opt);
+      }
+
+      // Explicitly set the active value
+      selectElement.value = cellData.runtime || "";
+      runtimeSelectEl = selectElement;
+    }
+
+    const children = [
       Button({ 
         class: `btn-icon ${isCopied ? "btn-active" : ""}`, 
         title: isCopied ? "Copied!" : "Copy Cell Content", 
@@ -140,7 +155,13 @@ export function CellControls({ cellData, store, actions }) {
         disabled: isQueueRunning, 
         onclick: actions.deleteCell 
       }, Trash2())
-    );
+    ];
+
+    if (runtimeSelectEl) {
+      children.unshift(runtimeSelectEl);
+    }
+
+    controlsContainer.replaceChildren(...children);
   };
 
   renderButtons();
@@ -148,32 +169,3 @@ export function CellControls({ cellData, store, actions }) {
 
   return controlsContainer;
 }
-
-export function CellItem({ cellData, app, store }) {
-  const outputRef = div({ class: "output-area" });
-  if (cellData.outputNode) outputRef.append(cellData.outputNode);
-  cellData._outputRef = outputRef.element;
-
-  const actions = app._cellActions(cellData);
-  cellData._actions = actions;
-  cellData._editor = createCodeEditor(app, cellData, actions);
-
-  const inPrompt = span({ class: "prompt" });
-  const outPrompt = span({ class: "prompt out" });
-  const bodySlot = div().style({ display : 'contents'});
-  const controlsEl = CellControls({ cellData, store, actions });
-
-  const outputGrid = div({ class: "cell-output-grid" }, outPrompt, div({ class: "output-wrapper" }, outputRef));
-  const inputGrid = div({ class: "cell-input-grid" }, inPrompt, bodySlot, controlsEl);
-  const root = div({ class: "cell" }, inputGrid, outputGrid);
-  root.onClick(() => app.setActiveCell(cellData.id));
-
-  cellData._dom = root.element;
-  cellData._inPrompt = inPrompt.element;
-  cellData._outPrompt = outPrompt.element;
-  cellData._bodySlot = bodySlot.element;
-  cellData._outputGrid = outputGrid.element;
-
-  app._refreshCell(cellData);
-  return root.element;
-}