Skip to content

docs: add framework-agnostic Region & Text Capture concept guide - #350

Merged
vamgan merged 1 commit into
mainfrom
claude/capture-concept-guide
Jun 28, 2026
Merged

vamgan merged 1 commit into
mainfrom
claude/capture-concept-guide

Conversation

@vamgan

@vamgan vamgan commented Jun 28, 2026

Copy link
Copy Markdown
Collaborator

Summary

Adds a dedicated Capture concept guide. Region / square / circle / lasso and text-selection capture is a headline feature, but there was no framework-agnostic concept page for it — only per-framework mentions inside the React/Vue guides.

What's included

  • New site/docs/guide/capture.md documenting the core primitives:
    • createAskableRegionCapture(ctx, options) — the four shapes, key options (minSize, once, selectionAffordance, theme, callbacks), and the handle (start / cancel / clearSelection / getSelection / destroy / isActive)
    • createAskableTextSelectionCapture(ctx, options) — captureNow(), minLength, debounce, dedupe, etc.
    • Framework-hook table (useAskableRegionCapture / useAskableTextSelectionCapture across React/Vue/Svelte/Solid) with a React example
    • SSR-inert behavior and Context-packet output
  • Wired into the Concepts sidebar (after "Ask AI Buttons").

Notes

  • Every option, handle method, and the React hook's { start, active, lastPacket } return shape was verified against packages/core/src/capture.ts, selection.ts, and the framework hooks. Docs-only; no code changes.

Test plan

  • vitepress build clean (no dead links) — the same check the CI preview job runs
  • CI preview/build green

🤖 Generated with Claude Code


Generated by Claude Code

Capture (region/square/circle/lasso + text selection) is a headline feature but
had no dedicated concept page — only per-framework mentions. Documents the core
primitives createAskableRegionCapture and createAskableTextSelectionCapture
(shapes, options, handle, SSR-inert behavior), the framework hook table, and the
Context-packet output. Wires it into the Concepts sidebar.
@vercel

vercel Bot commented Jun 28, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
askable Ready Ready Preview, Comment Jun 28, 2026 6:33pm

@vamgan
vamgan merged commit d1c4c75 into main Jun 28, 2026
3 checks passed
@vamgan
vamgan deleted the claude/capture-concept-guide branch June 28, 2026 18:34

This branch was successfully deployed

1 active deployment
Preview — 285501a2 Deployed Jun 28, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants