npm - @portel/photon - Versions diffs - 1.14.0 → 1.16.1 - Mend

@portel/photon 1.14.0 → 1.16.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (125) hide show

package/dist/auto-ui/beam/photon-management.d.ts +1 -1
package/dist/auto-ui/beam/photon-management.d.ts.map +1 -1
package/dist/auto-ui/beam/photon-management.js +5 -1
package/dist/auto-ui/beam/photon-management.js.map +1 -1
package/dist/auto-ui/beam/routes/api-config.d.ts.map +1 -1
package/dist/auto-ui/beam/routes/api-config.js +31 -9
package/dist/auto-ui/beam/routes/api-config.js.map +1 -1
package/dist/auto-ui/beam/routes/api-marketplace.d.ts.map +1 -1
package/dist/auto-ui/beam/routes/api-marketplace.js +3 -0
package/dist/auto-ui/beam/routes/api-marketplace.js.map +1 -1
package/dist/auto-ui/beam.d.ts.map +1 -1
package/dist/auto-ui/beam.js +205 -56
package/dist/auto-ui/beam.js.map +1 -1
package/dist/auto-ui/bridge/index.d.ts.map +1 -1
package/dist/auto-ui/bridge/index.js +578 -0
package/dist/auto-ui/bridge/index.js.map +1 -1
package/dist/auto-ui/bridge/renderers.d.ts.map +1 -1
package/dist/auto-ui/bridge/renderers.js +7 -3
package/dist/auto-ui/bridge/renderers.js.map +1 -1
package/dist/auto-ui/bridge/types.d.ts +6 -0
package/dist/auto-ui/bridge/types.d.ts.map +1 -1
package/dist/auto-ui/frontend/pure-view.html +289 -0
package/dist/auto-ui/photon-bridge.d.ts +11 -0
package/dist/auto-ui/photon-bridge.d.ts.map +1 -1
package/dist/auto-ui/photon-bridge.js +75 -1
package/dist/auto-ui/photon-bridge.js.map +1 -1
package/dist/auto-ui/streamable-http-transport.d.ts.map +1 -1
package/dist/auto-ui/streamable-http-transport.js +29 -3
package/dist/auto-ui/streamable-http-transport.js.map +1 -1
package/dist/beam-form.bundle.js +5707 -0
package/dist/beam-form.bundle.js.map +7 -0
package/dist/beam.bundle.js +2863 -895
package/dist/beam.bundle.js.map +4 -4
package/dist/claude-code-plugin.js +11 -3
package/dist/claude-code-plugin.js.map +1 -1
package/dist/cli/commands/build.js +1 -1
package/dist/cli/commands/build.js.map +1 -1
package/dist/cli/commands/doctor.d.ts.map +1 -1
package/dist/cli/commands/doctor.js +7 -5
package/dist/cli/commands/doctor.js.map +1 -1
package/dist/cli/commands/info.d.ts.map +1 -1
package/dist/cli/commands/info.js +18 -4
package/dist/cli/commands/info.js.map +1 -1
package/dist/cli/commands/mcp.js +2 -2
package/dist/cli/commands/mcp.js.map +1 -1
package/dist/cli/commands/update.d.ts.map +1 -1
package/dist/cli/commands/update.js +6 -2
package/dist/cli/commands/update.js.map +1 -1
package/dist/cli-alias.d.ts.map +1 -1
package/dist/cli-alias.js +3 -2
package/dist/cli-alias.js.map +1 -1
package/dist/daemon/client.d.ts +5 -0
package/dist/daemon/client.d.ts.map +1 -1
package/dist/daemon/client.js +50 -0
package/dist/daemon/client.js.map +1 -1
package/dist/daemon/manager.d.ts +15 -0
package/dist/daemon/manager.d.ts.map +1 -1
package/dist/daemon/manager.js +142 -11
package/dist/daemon/manager.js.map +1 -1
package/dist/daemon/worker-manager.js +1 -1
package/dist/daemon/worker-manager.js.map +1 -1
package/dist/deploy/cloudflare.d.ts.map +1 -1
package/dist/deploy/cloudflare.js +12 -10
package/dist/deploy/cloudflare.js.map +1 -1
package/dist/loader.d.ts.map +1 -1
package/dist/loader.js +37 -2
package/dist/loader.js.map +1 -1
package/dist/marketplace-manager.d.ts +9 -0
package/dist/marketplace-manager.d.ts.map +1 -1
package/dist/marketplace-manager.js +115 -42
package/dist/marketplace-manager.js.map +1 -1
package/dist/meta.d.ts +51 -0
package/dist/meta.d.ts.map +1 -0
package/dist/meta.js +320 -0
package/dist/meta.js.map +1 -0
package/dist/photon-cli-runner.d.ts.map +1 -1
package/dist/photon-cli-runner.js +30 -5
package/dist/photon-cli-runner.js.map +1 -1
package/dist/photon-doc-extractor.d.ts +1 -0
package/dist/photon-doc-extractor.d.ts.map +1 -1
package/dist/photon-doc-extractor.js +33 -21
package/dist/photon-doc-extractor.js.map +1 -1
package/dist/photons/builder-compass.photon.d.ts +167 -0
package/dist/photons/builder-compass.photon.d.ts.map +1 -0
package/dist/photons/builder-compass.photon.js +816 -0
package/dist/photons/builder-compass.photon.js.map +1 -0
package/dist/photons/builder-compass.photon.ts +1129 -0
package/dist/photons/docs/ui/docs.html +441 -0
package/dist/photons/docs.photon.d.ts +237 -0
package/dist/photons/docs.photon.d.ts.map +1 -0
package/dist/photons/docs.photon.js +483 -0
package/dist/photons/docs.photon.js.map +1 -0
package/dist/photons/docs.photon.ts +536 -0
package/dist/photons/maker.photon.d.ts.map +1 -1
package/dist/photons/maker.photon.js +19 -2
package/dist/photons/maker.photon.js.map +1 -1
package/dist/photons/maker.photon.ts +18 -2
package/dist/photons/slides.photon.d.ts +212 -0
package/dist/photons/slides.photon.d.ts.map +1 -0
package/dist/photons/slides.photon.js +355 -0
package/dist/photons/slides.photon.js.map +1 -0
package/dist/photons/slides.photon.ts +370 -0
package/dist/photons/spreadsheet/ui/spreadsheet.html +779 -0
package/dist/photons/spreadsheet.photon.d.ts +554 -0
package/dist/photons/spreadsheet.photon.d.ts.map +1 -0
package/dist/photons/spreadsheet.photon.js +1050 -0
package/dist/photons/spreadsheet.photon.js.map +1 -0
package/dist/photons/spreadsheet.photon.ts +1239 -0
package/dist/photons/ui/builder-compass.html +1199 -0
package/dist/photons/ui/builder-compass.photon.html +380 -0
package/dist/server.d.ts.map +1 -1
package/dist/server.js +33 -59
package/dist/server.js.map +1 -1
package/dist/shared/error-handler.d.ts +8 -0
package/dist/shared/error-handler.d.ts.map +1 -1
package/dist/shared/error-handler.js +50 -0
package/dist/shared/error-handler.js.map +1 -1
package/dist/shared-utils.d.ts +16 -2
package/dist/shared-utils.d.ts.map +1 -1
package/dist/shared-utils.js +37 -3
package/dist/shared-utils.js.map +1 -1
package/dist/template-manager.d.ts.map +1 -1
package/dist/template-manager.js +2 -1
package/dist/template-manager.js.map +1 -1
package/package.json +8 -3

package/dist/photons/docs/ui/docs.html ADDED Viewed

@@ -0,0 +1,441 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Docs</title>
+  <style>
+    :root {
+      --bg: #0a0e1a;
+      --surface: rgba(15, 20, 35, 0.95);
+      --line: rgba(255,255,255,0.08);
+      --text: #e5e5e5;
+      --muted: rgba(255,255,255,0.4);
+      --accent: #67c7ff;
+      --page-bg: #ffffff;
+      --page-text: #1a1a2e;
+      --page-shadow: 0 2px 20px rgba(0,0,0,0.4);
+      --spring: cubic-bezier(0.16, 1, 0.3, 1);
+    }
+    * { box-sizing: border-box; margin: 0; }
+    body {
+      background: var(--bg);
+      color: var(--text);
+      font-family: system-ui, -apple-system, sans-serif;
+      height: 100vh;
+      display: grid;
+      grid-template-columns: 240px 1fr;
+      grid-template-rows: auto 1fr;
+      overflow: hidden;
+    }
+    /* ── Top Bar ── */
+    .topbar {
+      grid-column: 1 / -1;
+      display: flex;
+      align-items: center;
+      gap: 12px;
+      padding: 10px 20px;
+      border-bottom: 1px solid var(--line);
+      background: var(--surface);
+      font-size: 13px;
+    }
+    .topbar .title {
+      font-weight: 600;
+      flex: 1;
+      white-space: nowrap;
+      overflow: hidden;
+      text-overflow: ellipsis;
+    }
+    .topbar .stats {
+      color: var(--muted);
+      font-size: 12px;
+      white-space: nowrap;
+    }
+    .topbar button {
+      background: rgba(255,255,255,0.06);
+      border: 1px solid var(--line);
+      color: var(--text);
+      padding: 6px 14px;
+      border-radius: 6px;
+      cursor: pointer;
+      font-size: 12px;
+      transition: background 0.15s;
+    }
+    .topbar button:hover { background: rgba(255,255,255,0.12); }
+    .topbar button.primary { background: rgba(103,199,255,0.15); border-color: rgba(103,199,255,0.3); }
+    /* ── Sidebar (Outline) ── */
+    .sidebar {
+      background: var(--surface);
+      border-right: 1px solid var(--line);
+      padding: 16px;
+      overflow-y: auto;
+      display: flex;
+      flex-direction: column;
+      gap: 8px;
+    }
+    .sidebar-label {
+      font-size: 10px;
+      text-transform: uppercase;
+      letter-spacing: 0.12em;
+      color: var(--muted);
+      margin-bottom: 4px;
+    }
+    .outline-item {
+      display: block;
+      width: 100%;
+      text-align: left;
+      background: none;
+      border: none;
+      color: var(--text);
+      padding: 6px 8px;
+      border-radius: 6px;
+      cursor: pointer;
+      font-size: 13px;
+      transition: background 0.15s;
+      white-space: nowrap;
+      overflow: hidden;
+      text-overflow: ellipsis;
+    }
+    .outline-item:hover { background: rgba(255,255,255,0.06); }
+    .outline-item.h2 { padding-left: 20px; font-size: 12px; }
+    .outline-item.h3 { padding-left: 36px; font-size: 11px; color: var(--muted); }
+    .doc-list {
+      margin-top: 12px;
+      display: flex;
+      flex-direction: column;
+      gap: 4px;
+    }
+    .doc-item {
+      display: block;
+      width: 100%;
+      text-align: left;
+      background: none;
+      border: none;
+      color: var(--muted);
+      padding: 6px 8px;
+      border-radius: 6px;
+      cursor: pointer;
+      font-size: 12px;
+      transition: background 0.15s;
+    }
+    .doc-item:hover { background: rgba(255,255,255,0.06); color: var(--text); }
+    .doc-item.active { background: rgba(103,199,255,0.1); color: var(--accent); }
+    /* ── Main Editor Area ── */
+    .editor-area {
+      display: grid;
+      grid-template-columns: 1fr 1fr;
+      gap: 0;
+      overflow: hidden;
+    }
+    .editor-pane {
+      display: flex;
+      flex-direction: column;
+      border-right: 1px solid var(--line);
+      overflow: hidden;
+    }
+    .pane-header {
+      padding: 8px 16px;
+      font-size: 11px;
+      text-transform: uppercase;
+      letter-spacing: 0.1em;
+      color: var(--muted);
+      border-bottom: 1px solid var(--line);
+      background: rgba(255,255,255,0.02);
+      flex-shrink: 0;
+    }
+    textarea {
+      flex: 1;
+      width: 100%;
+      border: none;
+      outline: none;
+      resize: none;
+      background: rgba(6, 10, 20, 0.9);
+      color: var(--text);
+      padding: 20px 24px;
+      font-family: 'JetBrains Mono', ui-monospace, monospace;
+      font-size: 13px;
+      line-height: 1.7;
+      tab-size: 2;
+    }
+    /* ── Preview Pane ── */
+    .preview-pane {
+      overflow-y: auto;
+      background: #1a1e2e;
+      padding: 32px;
+      display: flex;
+      flex-direction: column;
+      align-items: center;
+      gap: 24px;
+    }
+    .page {
+      width: 210mm;
+      max-width: 100%;
+      min-height: 297mm;
+      background: var(--page-bg);
+      color: var(--page-text);
+      box-shadow: var(--page-shadow);
+      border-radius: 4px;
+      padding: 60px 50px;
+      font-family: 'Inter', 'Georgia', serif;
+      font-size: 11pt;
+      line-height: 1.7;
+      animation: page-fade-in 0.3s ease-out both;
+    }
+    @keyframes page-fade-in {
+      from { opacity: 0; transform: translateY(8px); }
+      to { opacity: 1; transform: translateY(0); }
+    }
+    .page h1 { font-size: 2em; margin: 0 0 0.5em; color: #111; font-weight: 700; }
+    .page h2 { font-size: 1.5em; margin: 1.2em 0 0.4em; color: #222; font-weight: 600; border-bottom: 1px solid #e5e5e5; padding-bottom: 0.3em; }
+    .page h3 { font-size: 1.2em; margin: 1em 0 0.3em; color: #333; }
+    .page p { margin: 0.6em 0; }
+    .page ul, .page ol { margin: 0.6em 0; padding-left: 1.8em; }
+    .page li { margin: 0.3em 0; }
+    .page code { background: #f0f0f0; padding: 2px 6px; border-radius: 3px; font-size: 0.9em; font-family: 'JetBrains Mono', monospace; }
+    .page pre { background: #f5f5f5; padding: 16px; border-radius: 6px; overflow-x: auto; margin: 0.8em 0; }
+    .page pre code { background: none; padding: 0; }
+    .page blockquote { border-left: 3px solid #ccc; padding-left: 16px; margin: 0.8em 0; color: #555; }
+    .page img { max-width: 100%; border-radius: 4px; }
+    .page table { border-collapse: collapse; width: 100%; margin: 0.8em 0; }
+    .page th, .page td { border: 1px solid #ddd; padding: 8px 12px; text-align: left; }
+    .page th { background: #f8f8f8; font-weight: 600; }
+    .page hr { border: none; border-top: 1px solid #e5e5e5; margin: 2em 0; }
+    /* Callout containers */
+    .page .callout { padding: 16px 20px; border-radius: 6px; margin: 1em 0; border-left: 4px solid; }
+    .page .callout-note { background: #eff6ff; border-color: #3b82f6; }
+    .page .callout-warning { background: #fffbeb; border-color: #f59e0b; }
+    .page .callout-tip { background: #f0fdf4; border-color: #22c55e; }
+    .page .callout-title { font-weight: 600; margin-bottom: 4px; }
+    /* Footnotes */
+    .page .footnote { font-size: 0.85em; color: #666; border-top: 1px solid #e5e5e5; padding-top: 8px; margin-top: 2em; }
+    /* Page break indicator */
+    .page-break-indicator {
+      width: 100%;
+      text-align: center;
+      color: var(--muted);
+      font-size: 11px;
+      padding: 4px 0;
+    }
+    @media (max-width: 1200px) {
+      body { grid-template-columns: 1fr; }
+      .sidebar { display: none; }
+      .editor-area { grid-template-columns: 1fr; }
+      .preview-pane { display: none; }
+    }
+  </style>
+</head>
+<body>
+  <div class="topbar">
+    <span class="title" id="doc-title">Untitled Document</span>
+    <span class="stats" id="doc-stats"></span>
+    <button class="primary" id="save-btn">Save</button>
+  </div>
+  <aside class="sidebar">
+    <div class="sidebar-label">Outline</div>
+    <div id="outline"></div>
+    <div class="sidebar-label" style="margin-top:16px;">Documents</div>
+    <div class="doc-list" id="doc-list"></div>
+  </aside>
+  <div class="editor-area">
+    <div class="editor-pane">
+      <div class="pane-header">Markdown</div>
+      <textarea id="editor" spellcheck="false"></textarea>
+    </div>
+    <div class="preview-pane" id="preview"></div>
+  </div>
+  <script>
+    const docsApp = window["docs"];
+    let state = { markdown: '', frontmatter: {}, outline: [], stats: {} };
+    function parseMCP(raw) {
+      if (raw && raw.content && Array.isArray(raw.content)) {
+        const item = raw.content.find(c => c.type === "text" && c.text);
+        if (item) { try { return JSON.parse(item.text); } catch { return item.text; } }
+      }
+      return raw;
+    }
+    function renderPreview(markdown) {
+      const preview = document.getElementById("preview");
+      // Split on page breaks
+      const { body } = splitFrontmatter(markdown);
+      const pages = body.split(/---pagebreak---/);
+      preview.innerHTML = pages.map((pageContent, i) => {
+        const html = renderMarkdown(pageContent.trim());
+        return `<div class="page">${html}</div>` +
+          (i < pages.length - 1 ? '<div class="page-break-indicator">--- page break ---</div>' : '');
+      }).join('');
+    }
+    function splitFrontmatter(md) {
+      const match = md.match(/^---\n[\s\S]*?\n---\n?/);
+      return { frontmatter: match ? match[0] : '', body: match ? md.slice(match[0].length) : md };
+    }
+    function renderMarkdown(text) {
+      // Simple markdown renderer — handles common elements
+      let html = text
+        // Code blocks
+        .replace(/```(\w*)\n([\s\S]*?)```/g, '<pre><code>$2</code></pre>')
+        // Callout containers
+        .replace(/::: (note|warning|tip)\n([\s\S]*?):::/g, (_, type, content) =>
+          `<div class="callout callout-${type}"><div class="callout-title">${type.charAt(0).toUpperCase() + type.slice(1)}</div>${renderInline(content.trim())}</div>`)
+        // Headings
+        .replace(/^### (.+)$/gm, '<h3>$1</h3>')
+        .replace(/^## (.+)$/gm, '<h2>$1</h2>')
+        .replace(/^# (.+)$/gm, '<h1>$1</h1>')
+        // Horizontal rules
+        .replace(/^---$/gm, '<hr>')
+        // Blockquotes
+        .replace(/^> (.+)$/gm, '<blockquote>$1</blockquote>')
+        // Unordered lists
+        .replace(/^- (.+)$/gm, '<li>$1</li>')
+        // Ordered lists
+        .replace(/^\d+\. (.+)$/gm, '<li>$1</li>')
+        // Footnotes
+        .replace(/\[\^(\d+)\]:\s*(.+)$/gm, '<div class="footnote"><sup>$1</sup> $2</div>')
+        .replace(/\[\^(\d+)\]/g, '<sup>$1</sup>')
+        // Paragraphs
+        .replace(/\n\n+/g, '</p><p>')
+        // Wrap lists
+        .replace(/(<li>[\s\S]*?<\/li>)/g, '<ul>$1</ul>')
+        // Clean up double-wrapped lists
+        .replace(/<\/ul>\s*<ul>/g, '');
+      html = renderInline(html);
+      return `<p>${html}</p>`.replace(/<p><\/p>/g, '').replace(/<p>(<h[1-6])/g, '$1').replace(/(<\/h[1-6]>)<\/p>/g, '$1');
+    }
+    function renderInline(text) {
+      return text
+        .replace(/\*\*(.+?)\*\*/g, '<strong>$1</strong>')
+        .replace(/\*(.+?)\*/g, '<em>$1</em>')
+        .replace(/`(.+?)`/g, '<code>$1</code>')
+        .replace(/\[(.+?)\]\((.+?)\)/g, '<a href="$2">$1</a>');
+    }
+    function renderOutline(outline) {
+      const el = document.getElementById("outline");
+      if (!outline || !outline.length) { el.innerHTML = '<span style="color:var(--muted);font-size:12px;">No headings</span>'; return; }
+      el.innerHTML = outline.map(h =>
+        `<button class="outline-item h${h.level}" data-line="${h.line}">${h.text}</button>`
+      ).join('');
+      el.querySelectorAll("[data-line]").forEach(btn => {
+        btn.addEventListener("click", () => {
+          const editor = document.getElementById("editor");
+          const lines = editor.value.split('\n');
+          let charPos = 0;
+          for (let i = 0; i < parseInt(btn.dataset.line) - 1 && i < lines.length; i++) {
+            charPos += lines[i].length + 1;
+          }
+          editor.focus();
+          editor.setSelectionRange(charPos, charPos);
+        });
+      });
+    }
+    function updateUI(data) {
+      if (!data || data.error) return;
+      state = data;
+      const fm = data.frontmatter || {};
+      document.getElementById("doc-title").textContent = fm.title || data.file || 'Untitled';
+      document.getElementById("editor").value = data.markdown || '';
+      const s = data.stats || {};
+      document.getElementById("doc-stats").textContent =
+        `${s.words || 0} words · ${s.readingTime || 1} min read · ${s.headings || 0} sections`;
+      renderOutline(data.outline);
+      renderPreview(data.markdown || '');
+    }
+    // ── Event Handlers ──
+    document.getElementById("save-btn").addEventListener("click", async () => {
+      const markdown = document.getElementById("editor").value;
+      if (docsApp) {
+        const result = parseMCP(await docsApp.save({ markdown }));
+        updateUI(result);
+      }
+    });
+    // Live preview on typing (debounced)
+    let previewTimeout;
+    document.getElementById("editor").addEventListener("input", () => {
+      clearTimeout(previewTimeout);
+      previewTimeout = setTimeout(() => {
+        renderPreview(document.getElementById("editor").value);
+      }, 300);
+    });
+    // Keyboard shortcut: Cmd/Ctrl+S to save
+    document.addEventListener("keydown", (e) => {
+      if ((e.metaKey || e.ctrlKey) && e.key === "s") {
+        e.preventDefault();
+        document.getElementById("save-btn").click();
+      }
+    });
+    // ── Bridge ──
+    if (docsApp) {
+      window.photon?.onResult?.((result) => {
+        const data = parseMCP(result);
+        if (data && data.markdown) updateUI(data);
+      });
+      window.photon?.onEmit?.((event) => {
+        if (event?.event === "docChanged") {
+          docsApp.main().then(r => updateUI(parseMCP(r)));
+        }
+      });
+      // Load doc list
+      docsApp.list().then(r => {
+        const data = parseMCP(r);
+        if (data && data.docs) {
+          const list = document.getElementById("doc-list");
+          list.innerHTML = data.docs.map(d =>
+            `<button class="doc-item" data-file="${d.file}">${d.title || d.file}</button>`
+          ).join('');
+        }
+      });
+      // Initial load
+      docsApp.main().then(r => updateUI(parseMCP(r)));
+    }
+  </script>
+</body>
+</html>

package/dist/photons/docs.photon.d.ts ADDED Viewed

@@ -0,0 +1,237 @@
+export default class Docs {
+    protected settings: {
+        /** @property Directory where document files are stored */
+        folder: string;
+    };
+    memory: {
+        get<T>(key: string): Promise<T | null>;
+        set(key: string, value: unknown): Promise<void>;
+    };
+    emit: (payload: {
+        event: string;
+        data: unknown;
+    }) => void;
+    instanceName: string;
+    private get defaultFolder();
+    private get docPath();
+    onInitialize(): Promise<void>;
+    /**
+     * Open the document editor UI
+     * @ui editor
+     * @autorun
+     */
+    main(): Promise<{
+        file: string;
+        markdown: string;
+        frontmatter: Record<string, any>;
+        outline: HeadingEntry[];
+        stats: {
+            words: number;
+            chars: number;
+            paragraphs: number;
+            headings: number;
+            readingTime: number;
+            sections: {
+                heading: string;
+                level: number;
+                words: number;
+            }[];
+        };
+    }>;
+    /**
+     * Read the document markdown
+     * @readOnly
+     */
+    read(): Promise<{
+        file: string;
+        markdown: string;
+    }>;
+    /**
+     * Save the full document markdown
+     * @param markdown Full markdown content with YAML frontmatter
+     * @ui editor
+     */
+    save({ markdown }: {
+        markdown: string;
+    }): Promise<{
+        file: string;
+        markdown: string;
+        frontmatter: Record<string, any>;
+        outline: HeadingEntry[];
+        stats: {
+            words: number;
+            chars: number;
+            paragraphs: number;
+            headings: number;
+            readingTime: number;
+            sections: {
+                heading: string;
+                level: number;
+                words: number;
+            }[];
+        };
+    }>;
+    /**
+     * Get the document's heading structure for navigation
+     * @readOnly
+     */
+    outline(): Promise<{
+        outline: HeadingEntry[];
+    }>;
+    /**
+     * Edit a specific section by heading path
+     * @param section Heading text or path like "Chapter 3/Introduction"
+     * @param markdown New content for that section (everything under the heading until next same-level heading)
+     * @ui editor
+     */
+    edit({ section, markdown: newContent }: {
+        section: string;
+        markdown: string;
+    }): Promise<{
+        file: string;
+        markdown: string;
+        frontmatter: Record<string, any>;
+        outline: HeadingEntry[];
+        stats: {
+            words: number;
+            chars: number;
+            paragraphs: number;
+            headings: number;
+            readingTime: number;
+            sections: {
+                heading: string;
+                level: number;
+                words: number;
+            }[];
+        };
+    } | {
+        error: string;
+    }>;
+    /**
+     * Append content at the end of the document or after a specific section
+     * @param markdown Content to append
+     * @param after Optional heading text — inserts after that section instead of end
+     * @ui editor
+     */
+    append({ markdown: content, after }: {
+        markdown: string;
+        after?: string;
+    }): Promise<{
+        file: string;
+        markdown: string;
+        frontmatter: Record<string, any>;
+        outline: HeadingEntry[];
+        stats: {
+            words: number;
+            chars: number;
+            paragraphs: number;
+            headings: number;
+            readingTime: number;
+            sections: {
+                heading: string;
+                level: number;
+                words: number;
+            }[];
+        };
+    }>;
+    /**
+     * Find text in the document with optional fuzzy matching
+     * @param query Search text
+     * @param fuzzy Enable fuzzy matching {@default false}
+     * @param scope Limit search to a section heading
+     * @readOnly
+     */
+    find({ query, fuzzy, scope }: {
+        query: string;
+        fuzzy?: boolean;
+        scope?: string;
+    }): Promise<{
+        query: string;
+        fuzzy: boolean;
+        scope: string | null;
+        matches: {
+            line: number;
+            text: string;
+            context: string;
+        }[];
+        total: number;
+    }>;
+    /**
+     * Find and replace text in the document
+     * @param pattern Text to find (string or regex pattern)
+     * @param replacement Replacement text
+     * @param scope Limit to a section heading
+     * @param all Replace all occurrences {@default true}
+     * @ui editor
+     */
+    replace({ pattern, replacement, scope, all, }: {
+        pattern: string;
+        replacement: string;
+        scope?: string;
+        all?: boolean;
+    }): Promise<{
+        file: string;
+        markdown: string;
+        frontmatter: Record<string, any>;
+        outline: HeadingEntry[];
+        stats: {
+            words: number;
+            chars: number;
+            paragraphs: number;
+            headings: number;
+            readingTime: number;
+            sections: {
+                heading: string;
+                level: number;
+                words: number;
+            }[];
+        };
+        replacements: number;
+    }>;
+    /**
+     * List saved documents in the docs folder
+     * @readOnly
+     */
+    list(): Promise<{
+        folder: string;
+        docs: {
+            file: string;
+            title: any;
+            author: any;
+            updatedAt: string;
+            wordCount: number;
+        }[];
+    }>;
+    /**
+     * Generate table of contents from the document structure
+     * @readOnly
+     */
+    toc(): Promise<{
+        outline: HeadingEntry[];
+        markdown: string;
+    }>;
+    /**
+     * Document statistics: word count, reading time, section breakdown
+     * @readOnly
+     */
+    stats(): Promise<{
+        words: number;
+        chars: number;
+        paragraphs: number;
+        headings: number;
+        readingTime: number;
+        sections: {
+            heading: string;
+            level: number;
+            words: number;
+        }[];
+    }>;
+    private readDoc;
+}
+interface HeadingEntry {
+    level: number;
+    text: string;
+    line: number;
+}
+export {};
+//# sourceMappingURL=docs.photon.d.ts.map

package/dist/photons/docs.photon.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"docs.photon.d.ts","sourceRoot":"","sources":["../../src/photons/docs.photon.ts"],"names":[],"mappings":"AA4DA,MAAM,CAAC,OAAO,OAAO,IAAI;IACvB,SAAS,CAAC,QAAQ;QAChB,0DAA0D;;MAE1D;IAEM,MAAM,EAAE;QACd,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;QACvC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KACjD,CAAC;IACM,IAAI,EAAE,CAAC,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;IAC1D,YAAY,EAAE,MAAM,CAAC;IAI7B,OAAO,KAAK,aAAa,GAExB;IAED,OAAO,KAAK,OAAO,GAUlB;IAEK,YAAY;IAUlB;;;;OAIG;IACG,IAAI;;;;;;;;;;;;;;;;;;IAaV;;;OAGG;IACG,IAAI;;;;IAIV;;;;OAIG;IACG,IAAI,CAAC,EAAE,QAAQ,EAAE,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE;;;;;;;;;;;;;;;;;;IAgB7C;;;OAGG;IACG,OAAO;;;IAKb;;;;;OAKG;IACG,IAAI,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE;;;;;;;;;;;;;;;;;;;;IAmBnF;;;;;OAKG;IACG,MAAM,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;;;;;;;;;;;;;;;;;;IAyB/E;;;;;;OAMG;IACG,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;;;;;kBAM7D,MAAM;kBAAQ,MAAM;qBAAW,MAAM;;;;IAe9D;;;;;;;OAOG;IACG,OAAO,CAAC,EACZ,OAAO,EACP,WAAW,EACX,KAAK,EACL,GAAG,GACJ,EAAE;QACD,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;QACpB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,GAAG,CAAC,EAAE,OAAO,CAAC;KACf;;;;;;;;;;;;;;;;;;;IAqCD;;;OAGG;IACG,IAAI;;;;;;;;;;IAwBV;;;OAGG;IACG,GAAG;;;;IAOT;;;OAGG;IACG,KAAK;;;;;;;;;;;;YAOG,OAAO;CAOtB;AA8CD,UAAU,YAAY;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd"}