Skip to content

DoHyun468/claw-hwp / plugins/claw-hwp/skills/hwp

FileKindSize
SKILL.mdskill md101.9 KB
references/README.mdmarkdown834 B
references/equation-syntax.mdmarkdown5.9 KB
references/hwp-internals.mdmarkdown4.9 KB
references/hwp-object-placement.mdmarkdown5.8 KB
references/hwpx-edit-ops.mdmarkdown52.8 KB
references/hwpx-format.mdmarkdown14.8 KB
references/hwpx-object-placement.mdmarkdown7.1 KB
references/hwpx-style-spacing.mdmarkdown10.7 KB
references/rhwp-api.mdmarkdown15.8 KB
scripts/README.mdmarkdown2.4 KB
scripts/cell-inspect.jsscript4.9 KB
scripts/cell-patch.jsscript525.8 KB
scripts/create.jsexecutablebinary235.8 KB
scripts/extract_text.jsexecutablescript12.0 KB
scripts/hwpx-edit.jsscript292.7 KB
scripts/launcher/preview-linux.shexecutablescript2.0 KB
scripts/launcher/preview-mac.commandexecutablescript1.9 KB
scripts/launcher/preview-windows.batscript2.1 KB
scripts/make_seal.pyscript3.4 KB
scripts/pack.pyexecutablescript8.0 KB
scripts/package-lock.jsonmanifest2.0 KB
scripts/package.jsonmanifest298 B
scripts/preview-server.jsscript5.3 KB
scripts/preview-viewer.htmlother11.5 KB
scripts/preview-viewer.jsscript17.2 KB
scripts/references/chart-templates/chart-0.jsonconfig6.4 KB
scripts/references/chart-templates/chart-1.jsonconfig6.4 KB
scripts/references/chart-templates/chart-10.jsonconfig6.3 KB
scripts/references/chart-templates/chart-11.jsonconfig6.3 KB
scripts/references/chart-templates/chart-12.jsonconfig6.5 KB
scripts/references/chart-templates/chart-13.jsonconfig6.5 KB
scripts/references/chart-templates/chart-14.jsonconfig6.5 KB
scripts/references/chart-templates/chart-15.jsonconfig6.5 KB
scripts/references/chart-templates/chart-16.jsonconfig5.9 KB
scripts/references/chart-templates/chart-17.jsonconfig5.9 KB
scripts/references/chart-templates/chart-18.jsonconfig6.3 KB
scripts/references/chart-templates/chart-19.jsonconfig6.3 KB
scripts/references/chart-templates/chart-2.jsonconfig6.4 KB
scripts/references/chart-templates/chart-3.jsonconfig6.4 KB
scripts/references/chart-templates/chart-4.jsonconfig6.4 KB
scripts/references/chart-templates/chart-5.jsonconfig6.3 KB
scripts/references/chart-templates/chart-6.jsonconfig5.9 KB
scripts/references/chart-templates/chart-7.jsonconfig5.9 KB
scripts/references/chart-templates/chart-8.jsonconfig5.9 KB
scripts/references/chart-templates/chart-9.jsonconfig6.3 KB
scripts/secure-fill.mjsscript38.0 KB
scripts/templates/hancom_native_stub.hwpxbinary128.0 KB
scripts/unpack.pyexecutablescript2.5 KB
scripts/validate.pyexecutablescript3.7 KB
themes/arctic-frost.mdmarkdown777 B
themes/botanical-garden.mdmarkdown751 B
themes/desert-rose.mdmarkdown748 B
themes/forest-canopy.mdmarkdown755 B
themes/golden-hour.mdmarkdown778 B
themes/midnight-galaxy.mdmarkdown766 B
themes/modern-minimalist.mdmarkdown766 B
themes/ocean-depths.mdmarkdown758 B
themes/sunset-boulevard.mdmarkdown811 B
themes/tech-innovation.mdmarkdown729 B

scripts/preview-viewer.js

View on GitHub
// preview-viewer.js — Canvas-based HWP/HWPX viewer for the Claude Code
// preview pane. Vanilla-JS canvas renderer driven by rhwp WASM.
//
// Key points to preserve when editing:
//   - Set globalThis.measureTextWidth via a hidden <canvas> 2d context
//     BEFORE initialising rhwp WASM. rhwp calls it during text layout.
//   - Cap canvas pixel area at MAX_CANVAS_PIXELS so very large pages don't
//     blow GPU memory.
//   - In the render loop, run the full geometry sweep first
//     (getPageInfo for every page), THEN the render loop. Doing them
//     interleaved on the same doc handle leaks rhwp's internal borrow.
//   - Each page's <canvas> is position:absolute inside a position:relative
//     wrap sized in NATIVE page pixels. fit() updates only CSS width/height
//     to scale the canvas pixel buffer down to the container — no
//     re-rasterisation on resize.
//   - Call doc.getPageTextLayout(i) AFTER each renderPageToCanvas. It's
//     the side-effect that releases rhwp's per-page borrow; without it the
//     next render panics "attempted to take ownership of Rust value while
//     it was borrowed". We discard the payload — v0.10 doesn't surface a
//     selectable text layer.

// ── 1. measureTextWidth (must register BEFORE rhwp init) ──────────────────
{
  let ctx = null;
  let lastFont = "";
  globalThis.measureTextWidth = (font, text) => {
    if (!ctx) ctx = document.createElement("canvas").getContext("2d");
    if (font !== lastFont) { ctx.font = font; lastFont = font; }
    return ctx.measureText(text).width;
  };
}

// ── 2. rhwp WASM ──────────────────────────────────────────────────────────
// Resolve vendor paths relative to this module so the same bundle works
// under both the local preview-server (root host, served from /) and a
// GitHub Pages sub-path (e.g. /claw-hwp/). Bare `/vendor/...` would break
// under any sub-path host.
const rhwpJsUrl = new URL("vendor/rhwp/rhwp.js", import.meta.url).href;
const rhwpWasmUrl = new URL("vendor/rhwp/rhwp_bg.wasm", import.meta.url).href;
const rhwp = await import(rhwpJsUrl);
await rhwp.default({ module_or_path: rhwpWasmUrl });

// ── 3. DOM lookups ────────────────────────────────────────────────────────
const els = {
  filename: document.getElementById("filename"),
  autofix: document.getElementById("autofix"),
  download: document.getElementById("download"),
  pagenav: document.getElementById("pagenav"),
  pagePrev: document.getElementById("page-prev"),
  pageNext: document.getElementById("page-next"),
  pageInput: document.getElementById("page-input"),
  pageTotal: document.getElementById("page-total"),
  container: document.getElementById("pages-container"),
  status: document.getElementById("status"),
  open: document.getElementById("open"),
  fileInput: document.getElementById("file-input"),
  zoomControls: document.getElementById("zoom-controls"),
  zoomSlider: document.getElementById("zoom-slider"),
  zoomLabel: document.getElementById("zoom-label"),
};

// ── 4. State ──────────────────────────────────────────────────────────────
const state = {
  fileBytes: null,
  filename: "",
  filePath: "",
  // Auto-correction defaults to ON — for the vast majority of agent-emitted
  // and Hancom-saved hwp files, reflowLinesegs() produces the visually
  // expected output. The toolbar toggle still flips it for raw inspection.
  autoFix: true,
  pageCount: 0,
  currentPage: 1,
  // Zoom multiplier on the fit-to-container baseline. 1.0 = fits the pane.
  // CSS-scale only — canvas pixel buffer is set once in render(). Past ~1.5x
  // upscaling becomes visible on standard-DPI screens; we accept that for
  // now to keep slider drags instant. Re-rasterise on demand is a future
  // refinement.
  zoom: 1,
};
const ZOOM_MIN = 0.2;
const ZOOM_MAX = 2;
const ZOOM_STEP = 0.05;

// ── 5. UI helpers ─────────────────────────────────────────────────────────
function syncAutofixButton() {
  const on = state.autoFix === true;
  els.autofix.textContent = `자동 보정 ${on ? "ON" : "OFF"}`;
  els.autofix.classList.toggle("on", on);
}
syncAutofixButton();

function setStatus(text, kind = "info") {
  els.status.textContent = text;
  els.status.className = `status${kind === "error" ? " error" : ""}`;
  els.status.style.display = "block";
}
function clearStatus() { els.status.style.display = "none"; }

function syncPageNav() {
  if (state.pageCount <= 0) {
    els.pagenav.hidden = true;
    els.zoomControls.hidden = true;
    return;
  }
  els.pagenav.hidden = false;
  els.zoomControls.hidden = false;
  els.pageInput.max = String(state.pageCount);
  els.pageInput.value = String(state.currentPage);
  els.pageTotal.textContent = String(state.pageCount);
  els.pagePrev.disabled = state.currentPage <= 1;
  els.pageNext.disabled = state.currentPage >= state.pageCount;
}

function scrollToPage(n) {
  const idx = Math.max(1, Math.min(state.pageCount, n));
  const wrap = els.container.querySelector(`.hwp-page[data-page-num="${idx}"]`);
  if (wrap) wrap.scrollIntoView({ behavior: "smooth", block: "start" });
  state.currentPage = idx;
  syncPageNav();
}

// ── 6. Layout helpers ─────────────────────────────────────────────────────
const MAX_CANVAS_PIXELS = 67_108_864; // ≈ 8192 × 8192
function pickEffectiveDpr(pageW, pageH, zoom, rawDpr) {
  const phys = pageW * zoom * rawDpr * pageH * zoom * rawDpr;
  if (phys <= MAX_CANVAS_PIXELS) return rawDpr;
  const limited = Math.sqrt(MAX_CANVAS_PIXELS / (pageW * zoom * pageH * zoom));
  return Math.max(1, Math.floor(limited));
}

function fit() {
  const wraps = els.container.querySelectorAll(".hwp-page");
  if (wraps.length === 0) return;
  // At zoom=1 we want the page rendered at its NATURAL width (or fit-to-pane,
  // whichever is smaller). The earlier "always fill 1100px" rule made A4
  // (~595px native) look bloated on wide Code panes — 100% felt too big.
  // Now 100% = 1:1, zoom in to enlarge, zoom out to shrink. 1100px is kept
  // as a final ceiling for pathological wide pages.
  let maxPageW = 0;
  wraps.forEach((wrap) => {
    const canvas = wrap.querySelector("canvas");
    if (!canvas) return;
    const pw = parseFloat(canvas.dataset.pageWidth || "0");
    if (pw > maxPageW) maxPageW = pw;
  });
  const containerW = Math.max(0, els.container.clientWidth - 32);
  const naturalCap = maxPageW > 0 ? maxPageW : 1100;
  const baseAvail = Math.max(
    280,
    Math.min(naturalCap, containerW || naturalCap, 1100),
  );
  const avail = baseAvail * state.zoom;
  wraps.forEach((wrap) => {
    const canvas = wrap.querySelector("canvas");
    if (!canvas) return;
    const pageW = parseFloat(canvas.dataset.pageWidth || "0");
    const pageH = parseFloat(canvas.dataset.pageHeight || "0");
    if (pageW <= 0 || pageH <= 0) return;
    const ratio = avail / pageW;
    const scaledH = pageH * ratio;
    wrap.style.width = `${avail}px`;
    wrap.style.height = `${scaledH}px`;
    canvas.style.width = `${avail}px`;
    canvas.style.height = `${scaledH}px`;
  });
}

function syncZoomUi() {
  els.zoomSlider.value = String(state.zoom);
  els.zoomLabel.textContent = `${Math.round(state.zoom * 100)}%`;
}

function setZoom(z) {
  const clamped = Math.max(ZOOM_MIN, Math.min(ZOOM_MAX, z));
  if (clamped === state.zoom) return;
  state.zoom = clamped;
  syncZoomUi();
  fit();
}

const ro = new ResizeObserver(() => fit());
ro.observe(els.container);

const pageObserver = new IntersectionObserver(
  (entries) => {
    let bestIdx = state.currentPage;
    let bestRatio = 0;
    entries.forEach((e) => {
      if (e.intersectionRatio > bestRatio) {
        bestRatio = e.intersectionRatio;
        const num = Number(e.target.dataset.pageNum);
        if (Number.isFinite(num)) bestIdx = num;
      }
    });
    if (bestRatio > 0 && bestIdx !== state.currentPage) {
      state.currentPage = bestIdx;
      syncPageNav();
    }
  },
  { root: els.container, threshold: [0.1, 0.5, 0.9] },
);

// ── 7. Render pipeline ────────────────────────────────────────────────────
async function loadFromUrl() {
  const params = new URLSearchParams(window.location.search);
  const p = params.get("path");
  if (!p) {
    setStatus("우측 상단 폴더 아이콘으로 .hwp / .hwpx 파일을 선택하세요.");
    els.filename.textContent = "";
    return;
  }
  setStatus("파일 불러오는 중…");
  try {
    const res = await fetch(`/file?path=${encodeURIComponent(p)}`);
    if (!res.ok) throw new Error(`서버 응답 ${res.status}: ${await res.text()}`);
    state.fileBytes = new Uint8Array(await res.arrayBuffer());
    state.filePath = p;
    const headerName = res.headers.get("x-filename");
    state.filename = headerName
      ? (() => { try { return decodeURIComponent(headerName); } catch { return headerName; } })()
      : (p.split("/").pop() || "untitled");
    els.filename.textContent = state.filename;
    els.download.href = `/file?path=${encodeURIComponent(p)}`;
    els.download.setAttribute("download", state.filename);
    await render();
  } catch (err) {
    setStatus(`불러오기 실패: ${err.message}`, "error");
  }
}

async function loadFromFile(file) {
  setStatus("파일 불러오는 중…");
  try {
    state.fileBytes = new Uint8Array(await file.arrayBuffer());
    state.filename = file.name || "untitled";
    state.filePath = file.name || "";
    // Reset page position so the new doc starts at page 1, not wherever the
    // previous doc was scrolled to. Without this, opening a 3-page doc after
    // browsing to page 12 of a long doc would land on the last page.
    state.currentPage = 1;
    els.filename.textContent = state.filename;
    if (els.download.dataset.blobUrl) URL.revokeObjectURL(els.download.dataset.blobUrl);
    const url = URL.createObjectURL(new Blob([state.fileBytes]));
    els.download.dataset.blobUrl = url;
    els.download.href = url;
    els.download.setAttribute("download", state.filename);
    els.container.scrollTo(0, 0);
    await render();
  } catch (err) {
    setStatus(`불러오기 실패: ${err.message}`, "error");
  }
}

async function render() {
  if (!state.fileBytes) return;

  // Tear down previous canvases + observer attachments.
  els.container.querySelectorAll(".hwp-page").forEach((n) => {
    pageObserver.unobserve(n);
    n.remove();
  });

  let doc;
  try {
    doc = new rhwp.HwpDocument(state.fileBytes);
  } catch (err) {
    setStatus(`문서 파싱 실패: ${err.message}`, "error");
    return;
  }

  try {
    if (state.autoFix === true) {
      try { doc.reflowLinesegs(); }
      catch (err) { console.warn("[claw-hwp] reflowLinesegs failed:", err); }
    }

    state.pageCount = doc.pageCount();
    state.currentPage = Math.min(state.currentPage || 1, state.pageCount);
    syncPageNav();

    // Geometry first — every getPageInfo call before any renderPageToCanvas.
    const geoms = [];
    for (let i = 0; i < state.pageCount; i++) {
      try {
        const info = JSON.parse(doc.getPageInfo(i));
        geoms.push({ width: Number(info.width) || 0, height: Number(info.height) || 0 });
      } catch (err) {
        console.error(`[claw-hwp] getPageInfo(${i}) failed:`, err);
        geoms.push({ width: 0, height: 0 });
      }
    }

    const rawDpr = window.devicePixelRatio || 1;
    const zoom = 1;
    const frag = document.createDocumentFragment();
    const wraps = [];

    for (let i = 0; i < state.pageCount; i++) {
      const { width: pageW, height: pageH } = geoms[i];
      if (pageW <= 0 || pageH <= 0) continue;
      const dpr = pickEffectiveDpr(pageW, pageH, zoom, rawDpr);
      const renderScale = zoom * dpr;

      const canvas = document.createElement("canvas");
      canvas.width = Math.round(pageW * renderScale);
      canvas.height = Math.round(pageH * renderScale);
      canvas.dataset.pageWidth = String(pageW);
      canvas.dataset.pageHeight = String(pageH);
      canvas.style.display = "block";
      canvas.style.position = "absolute";
      canvas.style.top = "0";
      canvas.style.left = "0";
      canvas.style.width = `${pageW}px`;
      canvas.style.height = `${pageH}px`;
      canvas.style.background = "#fff";

      try {
        doc.renderPageToCanvas(i, canvas, renderScale);
      } catch (err) {
        console.error(`[claw-hwp] renderPageToCanvas(${i}) failed:`, err);
        continue;
      }

      // Always call getPageTextLayout (and discard) — without it rhwp keeps
      // its internal borrow on the doc and the next render panics.
      try { JSON.parse(doc.getPageTextLayout(i)); } catch {}

      const wrap = document.createElement("div");
      wrap.className = "hwp-page";
      wrap.dataset.pageNum = String(i + 1);
      wrap.style.position = "relative";
      wrap.style.background = "#fff";
      wrap.style.boxShadow = "0 1px 4px rgba(0, 0, 0, 0.45)";
      wrap.style.width = `${pageW}px`;
      wrap.style.height = `${pageH}px`;
      wrap.appendChild(canvas);
      frag.appendChild(wrap);
      wraps.push(wrap);
    }

    els.container.appendChild(frag);
    wraps.forEach((wrap) => pageObserver.observe(wrap));
    requestAnimationFrame(() => fit());
    clearStatus();
  } finally {
    if (typeof doc.free === "function") doc.free();
  }
}

// ── 8. Event wiring ───────────────────────────────────────────────────────
els.autofix.addEventListener("click", () => {
  state.autoFix = !state.autoFix;
  syncAutofixButton();
  render();
});

els.pagePrev.addEventListener("click", () => scrollToPage(state.currentPage - 1));
els.pageNext.addEventListener("click", () => scrollToPage(state.currentPage + 1));
els.pageInput.addEventListener("change", () => {
  const v = Number(els.pageInput.value);
  if (Number.isFinite(v)) scrollToPage(v);
});
els.open.addEventListener("click", () => els.fileInput.click());
els.fileInput.addEventListener("change", (e) => {
  const f = e.target.files && e.target.files[0];
  if (f) loadFromFile(f);
  e.target.value = "";
});

// ── 8b. Drag-and-drop ─────────────────────────────────────────────────────
// dragenter/dragleave fire once per descendant the cursor crosses, so a
// naive add/remove of the .dragging class flickers as the cursor moves
// between child elements. Counter pattern keeps the overlay stable until
// the drag truly leaves the window.
let dragDepth = 0;
window.addEventListener("dragenter", (e) => {
  e.preventDefault();
  dragDepth++;
  document.body.classList.add("dragging");
});
window.addEventListener("dragover", (e) => {
  // Required: without preventDefault the browser refuses the drop.
  e.preventDefault();
});
window.addEventListener("dragleave", () => {
  dragDepth = Math.max(0, dragDepth - 1);
  if (dragDepth === 0) document.body.classList.remove("dragging");
});
window.addEventListener("drop", (e) => {
  e.preventDefault();
  dragDepth = 0;
  document.body.classList.remove("dragging");
  const f = e.dataTransfer && e.dataTransfer.files && e.dataTransfer.files[0];
  if (!f) return;
  const lower = f.name.toLowerCase();
  if (!lower.endsWith(".hwp") && !lower.endsWith(".hwpx")) {
    setStatus(`.hwp / .hwpx 파일만 지원합니다 (받은 파일: ${f.name})`, "error");
    return;
  }
  loadFromFile(f);
});
els.pageInput.addEventListener("keydown", (e) => {
  if (e.key === "Enter") {
    e.preventDefault();
    const v = Number(els.pageInput.value);
    if (Number.isFinite(v)) scrollToPage(v);
  }
});

// Zoom — slider drag, label click for reset, Ctrl/Cmd+wheel.
els.zoomSlider.addEventListener("input", (e) => {
  const v = Number(e.target.value);
  if (Number.isFinite(v)) setZoom(v);
});
els.zoomLabel.addEventListener("click", () => setZoom(1));
els.container.addEventListener("wheel", (e) => {
  // Ctrl on Win/Linux, Cmd on macOS. Trackpad pinch-zoom also surfaces as
  // wheel + ctrlKey on macOS, so this picks up both gestures.
  if (!(e.ctrlKey || e.metaKey)) return;
  e.preventDefault();
  const delta = e.deltaY < 0 ? ZOOM_STEP : -ZOOM_STEP;
  setZoom(state.zoom + delta);
}, { passive: false });
syncZoomUi();

// ── 9. Heartbeat ──────────────────────────────────────────────────────────
// While this tab is open, ping the server so it knows we're alive. When the
// tab closes the pings stop, the server's idle timer fires, and the process
// self-kills — sparing the user from having to remember to stop it. Only
// applies when running under preview-server (port 3737); under static
// hosting (GitHub Pages) there's nothing on the other end of the heartbeat.
if (location.port === "3737") {
  setInterval(() => {
    fetch("/__heartbeat", { method: "GET", cache: "no-store" }).catch(() => {});
  }, 30_000);
}

loadFromUrl();
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 197kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall