npm - @clawos-dev/clawd - Versions diffs - 0.2.146 → 0.2.147-beta.312.20be87a - Mend

@clawos-dev/clawd 0.2.146 → 0.2.147-beta.312.20be87a

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 (11) hide show

package/dist/persona-defaults/persona-html-slides/.claude/skills/frontend-slides/html-template.md ADDED Viewed

@@ -0,0 +1,347 @@
+# HTML Presentation Template
+Reference architecture for generating slide presentations. Every presentation follows this structure.
+## Base HTML Structure
+```html
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Presentation Title</title>
+    <!-- Fonts: use Fontshare or Google Fonts — never system fonts -->
+    <link rel="stylesheet" href="https://api.fontshare.com/v2/css?f[]=...">
+    <style>
+        /* ===========================================
+           CSS CUSTOM PROPERTIES (THEME)
+           Change these to change the whole look
+           =========================================== */
+        :root {
+            /* Colors — from chosen style preset */
+            --bg-primary: #0a0f1c;
+            --bg-secondary: #111827;
+            --text-primary: #ffffff;
+            --text-secondary: #9ca3af;
+            --accent: #00ffcc;
+            --accent-glow: rgba(0, 255, 204, 0.3);
+            /* Typography — MUST use clamp() */
+            --font-display: 'Clash Display', sans-serif;
+            --font-body: 'Satoshi', sans-serif;
+            --title-size: clamp(2rem, 6vw, 5rem);
+            --subtitle-size: clamp(0.875rem, 2vw, 1.25rem);
+            --body-size: clamp(0.75rem, 1.2vw, 1rem);
+            /* Spacing — MUST use clamp() */
+            --slide-padding: clamp(1.5rem, 4vw, 4rem);
+            --content-gap: clamp(1rem, 2vw, 2rem);
+            /* Animation */
+            --ease-out-expo: cubic-bezier(0.16, 1, 0.3, 1);
+            --duration-normal: 0.6s;
+        }
+        /* ===========================================
+           BASE STYLES
+           =========================================== */
+        * { margin: 0; padding: 0; box-sizing: border-box; }
+        /* --- PASTE viewport-base.css CONTENTS HERE --- */
+        /* ===========================================
+           ANIMATIONS
+           Trigger via .visible class (added by JS on scroll)
+           =========================================== */
+        .reveal {
+            opacity: 0;
+            transform: translateY(30px);
+            transition: opacity var(--duration-normal) var(--ease-out-expo),
+                        transform var(--duration-normal) var(--ease-out-expo);
+        }
+        .slide.visible .reveal {
+            opacity: 1;
+            transform: translateY(0);
+        }
+        /* Stagger children for sequential reveal */
+        .reveal:nth-child(1) { transition-delay: 0.1s; }
+        .reveal:nth-child(2) { transition-delay: 0.2s; }
+        .reveal:nth-child(3) { transition-delay: 0.3s; }
+        .reveal:nth-child(4) { transition-delay: 0.4s; }
+        /* ... preset-specific styles ... */
+    </style>
+</head>
+<body>
+    <!-- Optional: Progress bar -->
+    <div class="progress-bar"></div>
+    <!-- Optional: Navigation dots -->
+    <nav class="nav-dots"><!-- Generated by JS --></nav>
+    <!-- Slides -->
+    <section class="slide title-slide">
+        <h1 class="reveal">Presentation Title</h1>
+        <p class="reveal">Subtitle or author</p>
+    </section>
+    <section class="slide">
+        <div class="slide-content">
+            <h2 class="reveal">Slide Title</h2>
+            <p class="reveal">Content...</p>
+        </div>
+    </section>
+    <!-- More slides... -->
+    <script>
+        /* ===========================================
+           SLIDE PRESENTATION CONTROLLER
+           =========================================== */
+        class SlidePresentation {
+            constructor() {
+                this.slides = document.querySelectorAll('.slide');
+                this.currentSlide = 0;
+                this.setupIntersectionObserver();
+                this.setupKeyboardNav();
+                this.setupTouchNav();
+                this.setupProgressBar();
+                this.setupNavDots();
+            }
+            setupIntersectionObserver() {
+                // Add .visible class when slides enter viewport
+                // Triggers CSS animations efficiently
+            }
+            setupKeyboardNav() {
+                // Arrow keys, Space, Page Up/Down
+            }
+            setupTouchNav() {
+                // Touch/swipe support for mobile
+            }
+            setupProgressBar() {
+                // Update progress bar on scroll
+            }
+            setupNavDots() {
+                // Generate and manage navigation dots
+            }
+        }
+        new SlidePresentation();
+    </script>
+</body>
+</html>
+```
+## Required JavaScript Features
+Every presentation must include:
+1. **SlidePresentation Class** — Main controller with:
+   - Keyboard navigation (arrows, space, page up/down)
+   - Touch/swipe support
+   - Mouse wheel navigation
+   - Progress bar updates
+   - Navigation dots
+2. **Intersection Observer** — For scroll-triggered animations:
+   - Add `.visible` class when slides enter viewport
+   - Trigger CSS transitions efficiently
+3. **Optional Enhancements** (match to chosen style):
+   - Custom cursor with trail
+   - Particle system background (canvas)
+   - Parallax effects
+   - 3D tilt on hover
+   - Magnetic buttons
+   - Counter animations
+4. **Inline Editing** (only if user opted in during Phase 1 — skip entirely if they said No):
+   - Edit toggle button (hidden by default, revealed via hover hotzone or `E` key)
+   - Auto-save to localStorage
+   - Export/save file functionality
+   - See "Inline Editing Implementation" section below
+## Inline Editing Implementation (Opt-In Only)
+**If the user chose "No" for inline editing in Phase 1, do NOT generate any edit-related HTML, CSS, or JS.**
+**Do NOT use CSS `~` sibling selector for hover-based show/hide.** The CSS-only approach (`edit-hotzone:hover ~ .edit-toggle`) fails because `pointer-events: none` on the toggle button breaks the hover chain: user hovers hotzone -> button becomes visible -> mouse moves toward button -> leaves hotzone -> button disappears before click.
+**Required approach: JS-based hover with 400ms delay timeout.**
+HTML:
+```html
+<div class="edit-hotzone"></div>
+<button class="edit-toggle" id="editToggle" title="Edit mode (E)">✏️</button>
+```
+CSS (visibility controlled by JS classes only):
+```css
+/* Do NOT use CSS ~ sibling selector for this!
+   pointer-events: none breaks the hover chain.
+   Must use JS with delay timeout. */
+.edit-hotzone {
+    position: fixed; top: 0; left: 0;
+    width: 80px; height: 80px;
+    z-index: 10000;
+    cursor: pointer;
+}
+.edit-toggle {
+    opacity: 0;
+    pointer-events: none;
+    transition: opacity 0.3s ease;
+    z-index: 10001;
+}
+.edit-toggle.show,
+.edit-toggle.active {
+    opacity: 1;
+    pointer-events: auto;
+}
+```
+JS (three interaction methods):
+```javascript
+// 1. Click handler on the toggle button
+document.getElementById('editToggle').addEventListener('click', () => {
+    editor.toggleEditMode();
+});
+// 2. Hotzone hover with 400ms grace period
+const hotzone = document.querySelector('.edit-hotzone');
+const editToggle = document.getElementById('editToggle');
+let hideTimeout = null;
+hotzone.addEventListener('mouseenter', () => {
+    clearTimeout(hideTimeout);
+    editToggle.classList.add('show');
+});
+hotzone.addEventListener('mouseleave', () => {
+    hideTimeout = setTimeout(() => {
+        if (!editor.isActive) editToggle.classList.remove('show');
+    }, 400);
+});
+editToggle.addEventListener('mouseenter', () => {
+    clearTimeout(hideTimeout);
+});
+editToggle.addEventListener('mouseleave', () => {
+    hideTimeout = setTimeout(() => {
+        if (!editor.isActive) editToggle.classList.remove('show');
+    }, 400);
+});
+// 3. Hotzone direct click
+hotzone.addEventListener('click', () => {
+    editor.toggleEditMode();
+});
+// 4. Keyboard shortcut (E key, skip when editing text)
+document.addEventListener('keydown', (e) => {
+    if ((e.key === 'e' || e.key === 'E') && !e.target.getAttribute('contenteditable')) {
+        editor.toggleEditMode();
+    }
+});
+```
+## Image Pipeline (Skip If No Images)
+If user chose "No images" in Phase 1, skip this entirely. If images were provided, process them before generating HTML.
+**Dependency:** `pip install Pillow`
+### Image Processing
+```python
+from PIL import Image, ImageDraw
+# Circular crop (for logos on modern/clean styles)
+def crop_circle(input_path, output_path):
+    img = Image.open(input_path).convert('RGBA')
+    w, h = img.size
+    size = min(w, h)
+    left, top = (w - size) // 2, (h - size) // 2
+    img = img.crop((left, top, left + size, top + size))
+    mask = Image.new('L', (size, size), 0)
+    ImageDraw.Draw(mask).ellipse([0, 0, size, size], fill=255)
+    img.putalpha(mask)
+    img.save(output_path, 'PNG')
+# Resize (for oversized images that inflate HTML)
+def resize_max(input_path, output_path, max_dim=1200):
+    img = Image.open(input_path)
+    img.thumbnail((max_dim, max_dim), Image.LANCZOS)
+    img.save(output_path, quality=85)
+```
+| Situation | Operation |
+|-----------|-----------|
+| Square logo on rounded aesthetic | `crop_circle()` |
+| Image > 1MB | `resize_max(max_dim=1200)` |
+| Wrong aspect ratio | Manual crop with `img.crop()` |
+Save processed images with `_processed` suffix. Never overwrite originals.
+### Image Placement
+**Use direct file paths** (not base64) — presentations are viewed locally:
+```html
+<img src="assets/logo_round.png" alt="Logo" class="slide-image logo">
+<img src="assets/screenshot.png" alt="Screenshot" class="slide-image screenshot">
+```
+```css
+.slide-image {
+    max-width: 100%;
+    max-height: min(50vh, 400px);
+    object-fit: contain;
+    border-radius: 8px;
+}
+.slide-image.screenshot {
+    border: 1px solid rgba(255, 255, 255, 0.1);
+    border-radius: 12px;
+    box-shadow: 0 8px 32px rgba(0, 0, 0, 0.3);
+}
+.slide-image.logo {
+    max-height: min(30vh, 200px);
+}
+```
+**Adapt border/shadow colors to match the chosen style's accent.** Never repeat the same image on multiple slides (except logos on title + closing).
+**Placement patterns:** Logo centered on title slide. Screenshots in two-column layouts with text. Full-bleed images as slide backgrounds with text overlay (use sparingly).
+---
+## Code Quality
+**Comments:** Every section needs clear comments explaining what it does and how to modify it.
+**Accessibility:**
+- Semantic HTML (`<section>`, `<nav>`, `<main>`)
+- Keyboard navigation works fully
+- ARIA labels where needed
+- `prefers-reduced-motion` support (included in viewport-base.css)
+## File Structure
+Single presentations:
+```
+presentation.html    # Self-contained, all CSS/JS inline
+assets/              # Images only, if any
+```
+Multiple presentations in one project:
+```
+[name].html
+[name]-assets/
+```

package/dist/persona-defaults/persona-html-slides/.claude/skills/frontend-slides/scripts/extract-pptx.py ADDED Viewed

@@ -0,0 +1,96 @@
+#!/usr/bin/env python3
+"""
+Extract all content from a PowerPoint file (.pptx).
+Returns a JSON structure with slides, text, and images.
+Usage:
+    python extract-pptx.py <input.pptx> [output_dir]
+Requires: pip install python-pptx
+"""
+import json
+import os
+import sys
+from pptx import Presentation
+def extract_pptx(file_path, output_dir="."):
+    """
+    Extract all content from a PowerPoint file.
+    Returns a list of slide data dicts with text, images, and notes.
+    """
+    prs = Presentation(file_path)
+    slides_data = []
+    # Create assets directory for extracted images
+    assets_dir = os.path.join(output_dir, "assets")
+    os.makedirs(assets_dir, exist_ok=True)
+    for slide_num, slide in enumerate(prs.slides):
+        slide_data = {
+            "number": slide_num + 1,
+            "title": "",
+            "content": [],
+            "images": [],
+            "notes": "",
+        }
+        for shape in slide.shapes:
+            # Extract text content
+            if shape.has_text_frame:
+                if shape == slide.shapes.title:
+                    slide_data["title"] = shape.text
+                else:
+                    slide_data["content"].append(
+                        {"type": "text", "content": shape.text}
+                    )
+            # Extract images
+            if shape.shape_type == 13:  # Picture type
+                image = shape.image
+                image_bytes = image.blob
+                image_ext = image.ext
+                image_name = f"slide{slide_num + 1}_img{len(slide_data['images']) + 1}.{image_ext}"
+                image_path = os.path.join(assets_dir, image_name)
+                with open(image_path, "wb") as f:
+                    f.write(image_bytes)
+                slide_data["images"].append(
+                    {
+                        "path": f"assets/{image_name}",
+                        "width": shape.width,
+                        "height": shape.height,
+                    }
+                )
+        # Extract speaker notes
+        if slide.has_notes_slide:
+            notes_frame = slide.notes_slide.notes_text_frame
+            slide_data["notes"] = notes_frame.text
+        slides_data.append(slide_data)
+    return slides_data
+if __name__ == "__main__":
+    if len(sys.argv) < 2:
+        print("Usage: python extract-pptx.py <input.pptx> [output_dir]")
+        sys.exit(1)
+    input_file = sys.argv[1]
+    output_dir = sys.argv[2] if len(sys.argv) > 2 else "."
+    slides = extract_pptx(input_file, output_dir)
+    # Write extracted data as JSON
+    output_path = os.path.join(output_dir, "extracted-slides.json")
+    with open(output_path, "w") as f:
+        json.dump(slides, f, indent=2)
+    print(f"Extracted {len(slides)} slides to {output_path}")
+    for s in slides:
+        img_count = len(s["images"])
+        print(f"  Slide {s['number']}: {s['title'] or '(no title)'} — {img_count} image(s)")

package/dist/persona-defaults/persona-html-slides/.claude/skills/frontend-slides/viewport-base.css ADDED Viewed

@@ -0,0 +1,153 @@
+/* ===========================================
+   VIEWPORT FITTING: MANDATORY BASE STYLES
+   Include this ENTIRE file in every presentation.
+   These styles ensure slides fit exactly in the viewport.
+   =========================================== */
+/* 1. Lock html/body to viewport */
+html, body {
+    height: 100%;
+    overflow-x: hidden;
+}
+html {
+    scroll-snap-type: y mandatory;
+    scroll-behavior: smooth;
+}
+/* 2. Each slide = exact viewport height */
+.slide {
+    width: 100vw;
+    height: 100vh;
+    height: 100dvh; /* Dynamic viewport height for mobile browsers */
+    overflow: hidden; /* CRITICAL: Prevent ANY overflow */
+    scroll-snap-align: start;
+    display: flex;
+    flex-direction: column;
+    position: relative;
+}
+/* 3. Content container with flex for centering */
+.slide-content {
+    flex: 1;
+    display: flex;
+    flex-direction: column;
+    justify-content: center;
+    max-height: 100%;
+    overflow: hidden; /* Double-protection against overflow */
+    padding: var(--slide-padding);
+}
+/* 4. ALL typography uses clamp() for responsive scaling */
+:root {
+    /* Titles scale from mobile to desktop */
+    --title-size: clamp(1.5rem, 5vw, 4rem);
+    --h2-size: clamp(1.25rem, 3.5vw, 2.5rem);
+    --h3-size: clamp(1rem, 2.5vw, 1.75rem);
+    /* Body text */
+    --body-size: clamp(0.75rem, 1.5vw, 1.125rem);
+    --small-size: clamp(0.65rem, 1vw, 0.875rem);
+    /* Spacing scales with viewport */
+    --slide-padding: clamp(1rem, 4vw, 4rem);
+    --content-gap: clamp(0.5rem, 2vw, 2rem);
+    --element-gap: clamp(0.25rem, 1vw, 1rem);
+}
+/* 5. Cards/containers use viewport-relative max sizes */
+.card, .container, .content-box {
+    max-width: min(90vw, 1000px);
+    max-height: min(80vh, 700px);
+}
+/* 6. Lists auto-scale with viewport */
+.feature-list, .bullet-list {
+    gap: clamp(0.4rem, 1vh, 1rem);
+}
+.feature-list li, .bullet-list li {
+    font-size: var(--body-size);
+    line-height: 1.4;
+}
+/* 7. Grids adapt to available space */
+.grid {
+    display: grid;
+    grid-template-columns: repeat(auto-fit, minmax(min(100%, 250px), 1fr));
+    gap: clamp(0.5rem, 1.5vw, 1rem);
+}
+/* 8. Images constrained to viewport */
+img, .image-container {
+    max-width: 100%;
+    max-height: min(50vh, 400px);
+    object-fit: contain;
+}
+/* ===========================================
+   RESPONSIVE BREAKPOINTS
+   Aggressive scaling for smaller viewports
+   =========================================== */
+/* Short viewports (< 700px height) */
+@media (max-height: 700px) {
+    :root {
+        --slide-padding: clamp(0.75rem, 3vw, 2rem);
+        --content-gap: clamp(0.4rem, 1.5vw, 1rem);
+        --title-size: clamp(1.25rem, 4.5vw, 2.5rem);
+        --h2-size: clamp(1rem, 3vw, 1.75rem);
+    }
+}
+/* Very short viewports (< 600px height) */
+@media (max-height: 600px) {
+    :root {
+        --slide-padding: clamp(0.5rem, 2.5vw, 1.5rem);
+        --content-gap: clamp(0.3rem, 1vw, 0.75rem);
+        --title-size: clamp(1.1rem, 4vw, 2rem);
+        --body-size: clamp(0.7rem, 1.2vw, 0.95rem);
+    }
+    /* Hide non-essential elements */
+    .nav-dots, .keyboard-hint, .decorative {
+        display: none;
+    }
+}
+/* Extremely short (landscape phones, < 500px height) */
+@media (max-height: 500px) {
+    :root {
+        --slide-padding: clamp(0.4rem, 2vw, 1rem);
+        --title-size: clamp(1rem, 3.5vw, 1.5rem);
+        --h2-size: clamp(0.9rem, 2.5vw, 1.25rem);
+        --body-size: clamp(0.65rem, 1vw, 0.85rem);
+    }
+}
+/* Narrow viewports (< 600px width) */
+@media (max-width: 600px) {
+    :root {
+        --title-size: clamp(1.25rem, 7vw, 2.5rem);
+    }
+    /* Stack grids vertically */
+    .grid {
+        grid-template-columns: 1fr;
+    }
+}
+/* ===========================================
+   REDUCED MOTION
+   Respect user preferences
+   =========================================== */
+@media (prefers-reduced-motion: reduce) {
+    *, *::before, *::after {
+        animation-duration: 0.01ms !important;
+        transition-duration: 0.2s !important;
+    }
+    html {
+        scroll-behavior: auto;
+    }
+}

package/dist/persona-defaults/persona-html-slides/CLAUDE.md ADDED Viewed

@@ -0,0 +1,77 @@
+你是老板的「HTML PPT 制作师」—— clawd 体系下的一个 persona，专门把老板的想法 / 文字 / 旧 PPT 变成单文件 HTML 演示稿。
+# 何时找你
+- 老板说"做个 PPT / 演示稿 / slides / 幻灯片"
+- 老板要把一段内容（提纲、文章、笔记）变成可演讲的页面
+- 老板把现有 .pptx 扔给你要"转成网页版"
+- 老板要做主题分享、产品介绍、教学讲义的可视化
+不在这个 persona 干的事：写普通文档（找 share-html 或 notes）、写代码项目（找 developer）。
+# 你的核心能力来源
+`frontend-slides` skill 是你的主要工作方式。**每次接到 PPT 任务时，先 invoke 这个 skill**，照它的规范干：
+- 单文件 HTML，零依赖，内联 CSS/JS
+- 固定 1920×1080 的 16:9 stage，整体缩放适配视口
+- 设计上避免"AI slop"——字体、配色、动效都要有辨识度
+- 区分 reading deck（信息密度高，给读者看的）和 speaker deck（信息密度低，给现场讲的），开工前先问老板
+skill 自带 `viewport-base.css` / `bold-template-pack` / 动效模式库等资源，按它的 SKILL.md 走流程即可，不要自己绕开它另起炉灶。
+# 🩺 `frontend-slides` skill 不在就自己装一份
+接到 PPT 任务，直接 invoke `frontend-slides` skill 干活。如果会话开场的可用 skill 列表里**没有它**，或者调用报「找不到这个 skill」——别绕过它硬写 HTML，自己安装：
+1. **上游源**：`https://github.com/zarazhangrui/frontend-slides`（MIT 协议公开仓库，作者 Zara Zhang）
+2. **安装位置**：**当前 persona project 目录**的 `.claude/skills/frontend-slides/` 下（从 cwd / 开场环境信息里推断这个目录在哪，不要写死路径，也**不要**装到全局 `~/.claude/skills/`）
+3. **怎么装**：
+   ```bash
+   git clone https://github.com/zarazhangrui/frontend-slides.git <persona-project>/.claude/skills/frontend-slides
+   ```
+   网络不通 / git 不可用 → 停下告诉老板，不要瞎搞
+4. **装完告诉老板**：「skill 已自动补齐，下次会话生效」——本轮会话的 skill 列表是开场锁定的，装完本轮**调不起来**，按 `SKILL.md` 内容照流程手写也行，但要跟老板说清楚情况
+# 工作方式
+## 开工前必问的两件事（缺一个就问一个，缺两个一起问）
+1. **deck 类型**：reading（自己读的，文字多）还是 speaking（现场讲的，文字少、视觉重）？—— 这决定了信息密度和版式风格
+2. **主题/风格倾向**：商业稳重 / 极简文艺 / 科技未来 / 学术严肃 / 活泼可爱…… 老板给不出方向时，你可以基于内容主题**直接选一个最合适的**先做，让老板看完再调
+老板只给一段内容、没说要几页的话：你自己判断结构（开场 + 主要观点 + 收尾），别问"您想要几页"——这是你的活。
+## 干的过程中
+- 先按 skill 的 progressive disclosure 读 STYLE_PRESETS、再决定走 bold-template-pack 还是从头写
+- 内容是老板给的就用老板的原话，不要"为了 PPT 好看"擅自重写老板的论点
+- 图片、字体优先 inline / data URI / CDN（不依赖本地资源，老板拿走 HTML 就能用）
+- 动效用 CSS-only，照 skill 的 `animation-patterns.md`
+## 干完后
+报告格式：
+```
+✅ PPT 已生成：
+   <产物绝对路径>/index.html
+类型：<reading | speaking>
+页数：<n>
+风格：<一句话风格描述>
+双击打开即可演讲；要改的话告诉我改哪页/哪部分。
+```
+# 红线
+- **不绕过 frontend-slides skill** —— 不要"我自己写个 HTML 模板更快"，skill 的规范（16:9 stage、viewport-base.css、风格规避 slop）是产物质量的保底
+- **不自动重写老板的文案** —— 排版可以你定，文字内容尊重老板原话；要改先问
+- **不依赖外部构建工具** —— 单 HTML 文件，零 npm/webpack/vite，跟 skill 原则一致
+# 行为规范
+- 老板把内容扔过来就开干，别先要"详细需求文档"
+- 写完一稿先给老板看效果，他要改再改，不要一上来就追问 17 个细节
+- 老板说"再花哨点 / 再简洁点 / 换个颜色"这种粗调，你自己拿主意调，不要反过来问"具体什么颜色 RGB 是多少"

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@clawos-dev/clawd",
-  "version": "0.2.146",
+  "version": "0.2.147-beta.312.20be87a",
   "description": "Standalone clawd daemon — Claude Code (and future Codex) session server over WebSocket",
   "type": "module",
   "license": "MIT",