Production-ready animations, transitions, backgrounds, and scenes for Remotion
TypeScript ai-agentsclaude-codedemo-videomcpmcp-servermodel-context-protocolmotion-designproduct-demoreactremotionshadcnvideo
feat: search components by described need, with search analytics (#335)
KapishDima45f37c04d816
diff --git a/.dockerignore b/.dockerignoreindex 6fdbedd5..037ee719 100644--- a/.dockerignore+++ b/.dockerignore@@ -12,3 +12,4 @@ node_modulescoverage.vercel.source+.searchdiff --git a/.gitignore b/.gitignoreindex 062f06f5..5e69bcef 100644--- a/.gitignore+++ b/.gitignore@@ -43,6 +43,9 @@ next-env.d.ts# fumadocs generated source.source/+# semantic search index + embedding model (bun run search:build)+.search/+.omcarticlesdiff --git a/CLAUDE.md b/CLAUDE.mdindex 450bba6b..b2c7696b 100644--- a/CLAUDE.md+++ b/CLAUDE.md@@ -41,12 +41,25 @@ Solo builders и маленькие команды (1-2 чел), фронтенДоки описывают компоненты и для людей, и для AI-агентов. Скилл `remocn` не хранит свою копию каталога, а читает документацию по URL, поэтому страница компонента — единственное место, где живут его пропсы, пример и сигнал выбора.- Каждый item из registry обязан иметь страницу с `component: <name>` во frontmatter. Исключения перечислены в `UNDOCUMENTED` в `lib/docs-meta.test.ts` и требуют причины — это либы, внутренние примитивы и sub-item'ы, свёрнутые в страницу контейнера. Иконки документируются галереей, а не страницей на штуку-- Frontmatter компонента: `component`, `vibe` (одно из семи значений в `lib/docs-schema.ts`), `length`, `useWhen` и `avoidWhen` — списки строк в двойных кавычках. Поля машинные, на странице не рендерятся+- Frontmatter компонента: `component`, `vibe` (одно из семи значений в `lib/docs-schema.ts`), `length`, `useWhen`, `avoidWhen` и `askedAs` — списки строк в двойных кавычках. Поля машинные, на странице не рендерятся+- `askedAs` — 5–8 формулировок, которыми компонент попросит человек, не видевший каталога: пара коротких запросов в 2–5 слов, пара фраз «хочу…», пара про задачу сцены. Без имени компонента и без слов из `description` там, где есть бытовой синоним («subtitles», а не «captions») — поле ценно именно словарём, которого в описании нет. На английском, до 90 символов, без двойных кавычек внутри. По этим строкам работает поиск, см. «Поиск компонентов»- `length` — кадры **собственного движения** компонента при 30fps: у перехода это значение для `linearTiming`/`springTiming`, у остальных — момент, когда анимация закончилась. Это нижняя граница `Sequence`, а не длина бита: холд сверху добавляется отдельно. Поэтому `length` намеренно расходится с `durationInFrames` в `config.ts` — там длина демо-композиции вместе с холдом. `"state-driven"` — компонент рендерится из пропа `state` и своей длительности не имеет- В `avoidWhen` называй компонент-замену в бэктиках. Тест валит сборку, если такого имени нет в registry- `bun test lib/docs-meta.test.ts` — блокирующий шаг CI, отдельный от основного прогона тестов (тот пока `continue-on-error`)- Агентские артефакты генерируются из этого frontmatter: `/llms-components.txt` (роутер по всем компонентам) и `/docs/**.md` (страница как чистый markdown, см. `lib/mdx-to-markdown.ts`)+## Поиск компонентов++Один поиск на два входа: `searchCatalog` в `lib/search/components.ts` обслуживает и MCP-тул `search_components`, и `/api/search` (диалог ⌘K в доках). Запрос — описание потребности на любом языке, а не только имя.++- Ранжирование гибридное (`lib/search/hybrid.ts`): лексический скор по `name`/`title`/`description`/`useWhen`/`askedAs` и семантика, слитые через reciprocal rank fusion. Слова держат точные имена, смысл — запросы, у которых с каталогом нет общих слов+- Семантика — локальная модель `multilingual-e5-small` в процессе сервера (`@huggingface/transformers`), без API-ключей и платы за запрос. Модель и размерность зашиты в `lib/search/model.ts`+- `bun run search:build` считает векторы (описание + каждая строка `askedAs`) в `.search/` и туда же кладёт модель. Каталог в git не попадает; Dockerfile собирает его перед `next build`. Нет индекса или модель не загрузилась — поиск молча работает по словам, поэтому в dev запускать сборку индекса не обязательно+- `/api/search` отдаёт результат в формате fumadocs: сначала гайды с совпадением в заголовке, потом компоненты, потом остальные полнотекстовые совпадения (`lib/search/docs-merge.ts`)+- Аналитика поиска идёт в OpenPanel одним событием `search_performed` для всех, со свойствами `actor` (`human` / `agent`) и `surface` (`docs_dialog` / `mcp` / `api`). Человек: диалог (`components/docs/search-dialog.tsx`) шлёт события из браузера — запрос считается, когда на нём остановились (правила в `lib/search/dialog-session.ts`), плюс `search_result_selected` и `search_abandoned`. Агент: сервер шлёт `search_performed` из MCP-тула и из `/api/search` (всё, что пришло не из диалога) и `component_fetched` на `get_component` / `preview_component` — это аналог клика+- Текст запроса агента в аналитику не пишется: политика конфиденциальности (`app/(home)/legal/content.tsx`) обещает, что присланное MCP-серверу не хранится. Пишутся только длина, письменность и вернувшиеся компоненты. Флаг `LOG_AGENT_QUERY_TEXT` в `lib/server/analytics.ts` включать только вместе с правкой политики+- `bun run search:eval` меряет поиск на `evals/search/golden.json` (топ-1/5/10 для слов и для гибрида). Меняешь ранжирование, модель или правила `askedAs` — сверяйся с ним; новые запросы в эталон приветствуются+## ChangelogЛюбая ветка, которая добавляет или заметно меняет компоненты registry, обязана содержать запись ченджлога — в том же PR, что и сама фича.@@ -80,6 +93,8 @@ bun run build # production-сборка сайтаbun run typecheck # tsc --noEmitbun run lint # biome checkbun run registry:build # пересборка registry-artifacts из registry/+bun run search:build # семантический индекс поиска + модель в .search/+bun run search:eval # качество поиска на evals/search/golden.json<!-- BEGIN:nextjs-agent-rules -->diff --git a/Dockerfile b/Dockerfileindex 14edb936..1987c384 100644--- a/Dockerfile+++ b/Dockerfile@@ -20,6 +20,19 @@ RUN --mount=type=cache,target=/root/.bun/install/cache \COPY . .RUN bun run postinstall+# Semantic search: embeds the component catalog into .search/ and downloads the+# embedding model there (about 120 MB from huggingface.co); the server reads+# both at runtime and never downloads anything itself. The model is kept in a+# build cache, so only the first build on a server needs that download. A+# failure here does not stop the deploy: without the index the site searches+# by keywords only.+RUN --mount=type=cache,target=/var/cache/remocn-search \+ mkdir -p .search/models \+ && cp -a /var/cache/remocn-search/. .search/models/ \+ && (bun run search:build \+ && cp -a .search/models/. /var/cache/remocn-search/ \+ || echo "WARNING: search index not built, the site will search by keywords only")+# Read while prerendering. Coolify passes these only when they are marked as# *build* variables in its UI. /showcases fails the build without# SHOWCASES_API_URL; the OpenPanel keys feed the sponsors traffic numbers.diff --git a/app/(home)/legal/content.tsx b/app/(home)/legal/content.tsxindex ea4cf7be..c314c7a7 100644--- a/app/(home)/legal/content.tsx+++ b/app/(home)/legal/content.tsx@@ -1,7 +1,7 @@import type { ReactNode } from "react";import { GITHUB_URL, SUPPORT_EMAIL } from "@/config/site";-export const LAST_UPDATED = "October 10, 2026";+export const LAST_UPDATED = "November 14, 2026";export type LegalItem = { title: ReactNode; body: ReactNode };@@ -66,7 +66,10 @@ export const LEGAL_PARTS: LegalPart[] = [We use <A href="https://openpanel.dev">OpenPanel</A> to collectanonymous usage data: pages visited, referrer, browser anddevice type, and coarse location (country level). This tells us- which components people actually use. We do not use advertising+ which components people actually use. When you use the docs+ search, we also record what you searched for, how many results+ came back and which one you opened, so we can tell whether the+ search finds what people look for. We do not use advertisingtrackers, we do not build cross-site profiles, and we never selldata.</>@@ -111,7 +114,7 @@ export const LEGAL_PARTS: LegalPart[] = [items: [{title: "MCP server.",- body: "The server is stateless. It answers each request from the public component catalog and does not store or log what you send it: search queries, video briefs and component props are used to build the answer and then discarded. The standard access logs described above apply, as for the rest of the site.",+ body: "The server is stateless. It answers each request from the public component catalog and does not store or log what you send it: search queries, video briefs and component props are used to build the answer and then discarded. We do count tool calls, to see whether the search works: which tool ran, which client called it, how long a query was and which catalog components came back. Those counts hold none of the text you sent. The standard access logs described above apply, as for the rest of the site.",},{title: "Previews in chat.",diff --git a/app/api/search/route.ts b/app/api/search/route.tsindex c564802e..0be72da9 100644--- a/app/api/search/route.ts+++ b/app/api/search/route.ts@@ -1,4 +1,79 @@import { createFromSource } from "fumadocs-core/search/server";+import { getCatalog } from "@/lib/mcp/catalog";+import { searchCatalog } from "@/lib/search/components";+import { type ComponentHit, mergeDocsResults } from "@/lib/search/docs-merge";+import { trackAgentSearch } from "@/lib/server/analytics";import { source } from "@/source";-export const { GET } = createFromSource(source);+const docsSearch = createFromSource(source);++/** How many components lead the results of the docs search dialog. */+const COMPONENT_RESULTS = 6;++let componentUrls: Set<string> | undefined;++/**+ * The docs search: full-text matches from fumadocs, with the components that+ * fit the query by meaning placed among them. The response keeps the fumadocs+ * shape, so the stock search dialog renders it unchanged.+ */+export async function GET(request: Request) {+ const url = new URL(request.url);+ const query = url.searchParams.get("query");+ if (!query) return Response.json([]);++ const limitParam = Number(url.searchParams.get("limit"));+ const limit =+ url.searchParams.has("limit") && Number.isInteger(limitParam)+ ? limitParam+ : undefined;+ const tag = url.searchParams.get("tag")?.split(",");++ const catalog = getCatalog();+ const started = performance.now();+ const [docs, { results: components, mode }] = await Promise.all([+ docsSearch.search(query, {+ tag,+ locale: url.searchParams.get("locale") ?? undefined,+ limit,+ }),+ // A tag narrows the search to one slice of the docs; the component+ // ranking knows nothing about tags, so it stays out of a tagged search.+ tag+ ? { results: [], mode: undefined }+ : searchCatalog({ query, limit: COMPONENT_RESULTS }),+ ]);++ // The search dialog reports its own searches from the browser, where it+ // knows which ones the visitor settled on and what they opened. Any other+ // caller is a program using the documented API, and is counted here.+ if (request.headers.get("sec-fetch-site") !== "same-origin") {+ trackAgentSearch({+ surface: "api",+ userAgent: request.headers.get("user-agent") ?? "",+ query,+ results: components.map((record) => record.name),+ mode,+ latencyMs: performance.now() - started,+ });+ }++ const hits = components.flatMap((record): ComponentHit[] => {+ const page = catalog.pages.get(record.name);+ return page+ ? [+ {+ name: record.name,+ title: record.title,+ description: record.description,+ url: page.url,+ section: record.section,+ },+ ]+ : [];+ });+ componentUrls ??= new Set([...catalog.pages.values()].map((p) => p.url));++ const merged = mergeDocsResults(query, docs, hits, componentUrls);+ return Response.json(limit === undefined ? merged : merged.slice(0, limit));+}diff --git a/app/docs/layout.tsx b/app/docs/layout.tsxindex 192296bd..3e9807ae 100644--- a/app/docs/layout.tsx+++ b/app/docs/layout.tsx@@ -4,6 +4,7 @@ import { PageShell } from "@/app/(home)/components/page-shell";import { SiteFooter } from "@/app/(home)/components/site-footer";import { SiteHeader } from "@/app/(home)/components/site-header";import { DocsShell } from "@/components/docs/docs-shell";+import DocsSearchDialog from "@/components/docs/search-dialog";import { HeaderSearch } from "@/components/docs/shell/header-search";import {buildSidebarModel,@@ -35,7 +36,10 @@ export default function Layout({ children }: { children: ReactNode }) {// fumadocs search context lives here (docs-only) instead of the root// layout, so non-docs routes never compile fumadocs-ui. `theme.enabled:// false` defers to the root next-themes ThemeProvider.- <RootProvider theme={{ enabled: false }}>+ <RootProvider+ theme={{ enabled: false }}+ search={{ SearchDialog: DocsSearchDialog }}+ ><PageShell>{/* Frame sizes as CSS variables (`lib/docs-layout.ts`); `contents`keeps the flex column of the page shell intact. The docs layoutdiff --git a/app/mcp/route.ts b/app/mcp/route.tsindex edaa2081..5c3b4934 100644--- a/app/mcp/route.ts+++ b/app/mcp/route.ts@@ -1,4 +1,5 @@import { createMcpHandler } from "@modelcontextprotocol/server";+import { mcpRequestContext } from "@/lib/mcp/request-context";import { createRemocnMcpServer } from "@/lib/mcp/server";/**@@ -38,7 +39,10 @@ function corsHeaders(request: Request): Headers {}async function serve(request: Request): Promise<Response> {- const response = await handler.fetch(request);+ const response = await mcpRequestContext.run(+ { userAgent: request.headers.get("user-agent") ?? "" },+ () => handler.fetch(request),+ );const headers = new Headers(response.headers);for (const [key, value] of corsHeaders(request)) headers.set(key, value);return new Response(response.body, {diff --git a/bun.lock b/bun.lockindex 8cb842d8..9a9d9962 100644--- a/bun.lock+++ b/bun.lock@@ -11,6 +11,7 @@"@fontsource/roboto-mono": "^5.3.0","@hugeicons/core-free-icons": "^4.3.0","@hugeicons/react": "^1.1.10",+ "@huggingface/transformers": "^4.3.2","@modelcontextprotocol/server": "^2.3.1","@openpanel/nextjs": "^1.0.13","@openpanel/sdk": "^1.3.1",@@ -248,59 +249,65 @@"@hugeicons/react": ["@hugeicons/[email protected]", "", { "peerDependencies": { "react": ">=16.0.0" } }, "sha512-9tAsd92yMVVGP+E+d8cM+wc0VnXuYZHNbWQi7TOe8k2neawmhiaFmVFbzyruejhOMa197/LbgvSED32ayUo3ZA=="],+ "@huggingface/jinja": ["@huggingface/[email protected]", "", {}, "sha512-jM17MqFily1iyT/1LD3r5w8/CZiyapVB0+7vOw48PfVtzyKsXStmHE4jVTyDAD05Tqv3un1xrS9ILUU1ugQAYQ=="],++ "@huggingface/tokenizers": ["@huggingface/[email protected]", "", {}, "sha512-LidMHe1FpcSYH4vcSjXooda34pC0M8m1gmDOv7SQi6Iv+ib1zX7J3sHBCC9/3FPCkn2k1b55FneVqMRxrr99pg=="],++ "@huggingface/transformers": ["@huggingface/[email protected]", "", { "dependencies": { "@huggingface/jinja": "^0.5.10", "@huggingface/tokenizers": "^0.2.0", "onnxruntime-node": "1.30.0", "onnxruntime-web": "1.31.0-dev.20260914-8d85527a0", "sharp": "^0.35.4" } }, "sha512-V3+dqf3iWlRYJ9I9GreM3zGQd0lAXnnoPeddmkOQYWAEE4l/+Fi6p7tx/qVUJlKQgLXGim2W76rTOzz+eC0i7g=="],+"@img/colour": ["@img/[email protected]", "", {}, "sha512-Td76q7j57o/tLVdgS746cYARfSyxk8iEfRxewL9h4OMzYhbW4TAcppl0mT4eyqXddh6L/jwoM75mo7ixa/pCeQ=="],- "@img/sharp-darwin-arm64": ["@img/[email protected]", "", { "optionalDependencies": { "@img/sharp-libvips-darwin-arm64": "1.3.2" }, "os": "darwin", "cpu": "arm64" }, "sha512-RMnFX7YQsMoh7lWfcM4NEHHymBX/rLuKNPVM84XE9ONPcaSCDgE7CHIHpSgPcO2xcRthgBy1HfNO319mwhIAkg=="],+ "@img/sharp-darwin-arm64": ["@img/[email protected]", "", { "optionalDependencies": { "@img/sharp-libvips-darwin-arm64": "1.3.4" }, "os": "darwin", "cpu": "arm64" }, "sha512-QRUlFQ0WxvdWyqqG/WtI3iupfD5rBzmCHXSdPsY91sAtVtTo7Q4cb6zOccZ3gqEqkr0f1As1ehLqmEpDsRf+lg=="],- "@img/sharp-darwin-x64": ["@img/[email protected]", "", { "optionalDependencies": { "@img/sharp-libvips-darwin-x64": "1.3.2" }, "os": "darwin", "cpu": "x64" }, "sha512-Xo+5uFBtLN0BKqieTxiFzFPQAUlBbbH5iBKyRX/z1JrbnYsHTfKJnUfL8+p2TPXr1pXqao4eeL4Rl144uDpK9w=="],+ "@img/sharp-darwin-x64": ["@img/[email protected]", "", { "optionalDependencies": { "@img/sharp-libvips-darwin-x64": "1.3.4" }, "os": "darwin", "cpu": "x64" }, "sha512-+BR255RhDlpygUpOc/Jdt1nT6DQ3XG/ERo5wbcdOf5Q320dKtPCKPLR1LJs9VGXRaMa8l1uUa0tkCNOXiAxZUw=="],- "@img/sharp-freebsd-wasm32": ["@img/[email protected]", "", { "dependencies": { "@img/sharp-wasm32": "0.35.3" }, "os": "freebsd" }, "sha512-lUxcqWIj2wMQ9BrwNjngcr1gWUr5xgaGThBRqPPalIC2n67Cqj1uPh8NnA/ZhAg8hUbKl+kVHKwgUIwe6ZYPrg=="],+ "@img/sharp-freebsd-wasm32": ["@img/[email protected]", "", { "dependencies": { "@img/sharp-wasm32": "0.35.5" }, "os": "freebsd" }, "sha512-Y/z91nEZ4uIBX5X3nfTovjU9lHNKFYbL2lpHCLVNmXQK03VIZvXBBt0KxbPGp2SdGSF+2mQU4e+hQaWOt86iAw=="],- "@img/sharp-libvips-darwin-arm64": ["@img/[email protected]", "", { "os": "darwin", "cpu": "arm64" }, "sha512-9J6ypZFpQBj4YnePGoq/S38w6nz+vqg5WZLrLGY4YuSemdMq47GMLBPO42MzwdGwpg/agZ7xzZcFHa48xlywfg=="],+ "@img/sharp-libvips-darwin-arm64": ["@img/[email protected]", "", { "os": "darwin", "cpu": "arm64" }, "sha512-5R89nBYiRdUlSWJxPhO+GVtaXzXSxKnRu/xqMn3KTA3L9EB9Oy/P+Nn2f2vlhPuUdy/Zusb2DarbyTpGCfEDuw=="],- "@img/sharp-libvips-darwin-x64": ["@img/[email protected]", "", { "os": "darwin", "cpu": "x64" }, "sha512-m2pW1n6cns9VaubNwsZ+c3CRYjxNQWgJ5gPlnL1nbBcpkBvFm6SCFN5o0psFHI8w9n11NKhFkeEDns98tiqbEw=="],+ "@img/sharp-libvips-darwin-x64": ["@img/[email protected]", "", { "os": "darwin", "cpu": "x64" }, "sha512-iR2OKH80yi0U+dUplyh3/xdpFvps6YkCwsXenIJxqxR1v9o+xtKTGbS9H7cps+2Vxjc8B1j96p75NmTGjIhtpQ=="],- "@img/sharp-libvips-linux-arm": ["@img/[email protected]", "", { "os": "linux", "cpu": "arm" }, "sha512-1eMLzy92I4J6rmi4mAT8yC3HxOtniyGELlzGbNMLLeqe052ahFQ0h6LFq+lh5DsDIdYViIDst08abvSbcEdLXQ=="],+ "@img/sharp-libvips-linux-arm": ["@img/[email protected]", "", { "os": "linux", "cpu": "arm" }, "sha512-LmRtTsOHuvM2+wlO2Db37dx5MiZhB0FvSunciw48YjdOkZz9KAiRbm8ujeMOA1INqmei5NapFxYEK1D1ZSidmw=="],- "@img/sharp-libvips-linux-arm64": ["@img/[email protected]", "", { "os": "linux", "cpu": "arm64" }, "sha512-dqVSFynCox4C/J8kT16V7SIFAns0IjgLwkvYT7p8LQVmJ5OS5b6tI9IGflxTeuBS//zXeFIUbwt5dwxyZ17cnA=="],+ "@img/sharp-libvips-linux-arm64": ["@img/[email protected]", "", { "os": "linux", "cpu": "arm64" }, "sha512-Y3dgX/6lE2QhQb+Gxy0WZxfg9MEm/JBjamZpS2IklP7xIQoKN4hzAm7KcMVGtaVDt3neE9OKBC7vAfonA/Lr1A=="],- "@img/sharp-libvips-linux-ppc64": ["@img/[email protected]", "", { "os": "linux", "cpu": "ppc64" }, "sha512-3z0NHDxD6n5I9gc05U1eW1AyRm+Gznzq3naMrthPNqE6oYykcogW0l/jfpJdjYnuNl8R7yI9pNbE1XiUeyq0Aw=="],+ "@img/sharp-libvips-linux-ppc64": ["@img/[email protected]", "", { "os": "linux", "cpu": "ppc64" }, "sha512-Le6boB8Tai0Nis+gIxIpKx68UDVVIqdR8Tin5Yf1z2LJJQLDJvCDRqRu+jC2qCoD+eIomonmOwB4smBRxfVpYQ=="],- "@img/sharp-libvips-linux-riscv64": ["@img/[email protected]", "", { "os": "linux", "cpu": "none" }, "sha512-bsb4rI+NldGOsXuej2r8OdSS8+zXDVaCWxyWrcv6kneTOlgAHtZABRzBBCwdsPiD90J4myNJuHpg6kA20ImW/w=="],+ "@img/sharp-libvips-linux-riscv64": ["@img/[email protected]", "", { "os": "linux", "cpu": "none" }, "sha512-aHkkIEHPRdQEegJN20MLmGtxYD9R2wQr3Cwpddnu5+YKMt6Uzax7S9h5gpZTo8wyrGuZSlfQ63OevL5mTyOC7Q=="],- "@img/sharp-libvips-linux-s390x": ["@img/[email protected]", "", { "os": "linux", "cpu": "s390x" }, "sha512-/ABshyj8gCpyIrNXnHn4LorDJ0HHm1VhXPBlxZ8zAtfVPAaSafXPGn+sUSIRiwaSBy0mmFjSjiXI5mkcwdChKQ=="],+ "@img/sharp-libvips-linux-s390x": ["@img/[email protected]", "", { "os": "linux", "cpu": "s390x" }, "sha512-ra/mB6MikESDUO7Yg+Mi95bFBb9GsObURuhnOv3OqknjGe9sZrG8tCe9q0xSIGrtLgvgw0gKnFWcK4blSgQOuQ=="],- "@img/sharp-libvips-linux-x64": ["@img/[email protected]", "", { "os": "linux", "cpu": "x64" }, "sha512-ITPEtgffGJ0S6G9dRyw/366tJQqFRcHWPHhC+Stpg3Z8AEMrDrTr2lhdz4f/Y/HMbRh//7Z5mBzEpVdi62Oc3w=="],+ "@img/sharp-libvips-linux-x64": ["@img/[email protected]", "", { "os": "linux", "cpu": "x64" }, "sha512-GJ//SSXbnwSDes02umB3nDJLFcQzw8a18V8fyhqr6tV515tOEMdImjjxj1AoafMRz56F3PHgftnj1QEKSU1zkw=="],- "@img/sharp-libvips-linuxmusl-arm64": ["@img/[email protected]", "", { "os": "linux", "cpu": "arm64" }, "sha512-zE9EdiUzUmg5mDT5a1rk5fYJ6GWPloTwWBYDS14naqHsL+EaMpDj1AWnpLgh3u0YCORv2Tt50wrcrpYqkP97Kw=="],+ "@img/sharp-libvips-linuxmusl-arm64": ["@img/[email protected]", "", { "os": "linux", "cpu": "arm64" }, "sha512-hvulFwtjUcagsis6BBxHwGFwWoNZjgYmULGVrZcyfNbjA8hKILbRxGg15/7w5HDyXHXUos/j6baAWqnCyQ2DWA=="],- "@img/sharp-libvips-linuxmusl-x64": ["@img/[email protected]", "", { "os": "linux", "cpu": "x64" }, "sha512-m0lrLiUt+lBYnCFr8qV/65yMR4E/c7/wf78I5eKTdkEakFAlZ9QlzEM3QIhhAwVeUhLAHLcCq7a7Vszq/oFNZQ=="],+ "@img/sharp-libvips-linuxmusl-x64": ["@img/[email protected]", "", { "os": "linux", "cpu": "x64" }, "sha512-6zXKeE/p39I1AmA3cJG35eyBGNqNddLnUXjhwBnsGjFPWqf5VKkDBEqaEkPDoTEtkxwi2vv8Tcr2mDyP4So7Fg=="],- "@img/sharp-linux-arm": ["@img/[email protected]", "", { "optionalDependencies": { "@img/sharp-libvips-linux-arm": "1.3.2" }, "os": "linux", "cpu": "arm" }, "sha512-affVWCTLooy8TSxbDx2qkzuDeaWLNVBA+P//FNBirHsXpP2fuBhk5AuboYUnrDnzoXes8GFjpTx0SBFOCRg+FA=="],+ "@img/sharp-linux-arm": ["@img/[email protected]", "", { "optionalDependencies": { "@img/sharp-libvips-linux-arm": "1.3.4" }, "os": "linux", "cpu": "arm" }, "sha512-LEaXK2WdXVK5ykcw0buWyPMsmLLL2vpHLD6yrNSW+JGEL3BZPA4tpKN6iaMc4AxTTAoaX/sU1rOL51lcIz48ZQ=="],- "@img/sharp-linux-arm64": ["@img/[email protected]", "", { "optionalDependencies": { "@img/sharp-libvips-linux-arm64": "1.3.2" }, "os": "linux", "cpu": "arm64" }, "sha512-QgKDspHPnrU+GQ55XPhGwyhC8acLVOOSyAvo1oVfFmrIXLkDNmGWzAfDZ4xK8oSA1qBQrALcHX0G5UZni/SuFQ=="],+ "@img/sharp-linux-arm64": ["@img/[email protected]", "", { "optionalDependencies": { "@img/sharp-libvips-linux-arm64": "1.3.4" }, "os": "linux", "cpu": "arm64" }, "sha512-LYVx5JTsOM2CBzmxreh+nl64/3H6Xb09iSLknqH47z2T2DFFxDeFLP5y4dJwe6H7uGQlHPyEEtIqyo3DYsRwdQ=="],- "@img/sharp-linux-ppc64": ["@img/[email protected]", "", { "optionalDependencies": { "@img/sharp-libvips-linux-ppc64": "1.3.2" }, "os": "linux", "cpu": "ppc64" }, "sha512-sMd8rDxmpLOwv/7N44klFjOD5DUO7FLdjiXDI0hoxYaf7Ar262dQIEkosE98bps+5HPLtp/EvNqeqQtOycP/IA=="],+ "@img/sharp-linux-ppc64": ["@img/[email protected]", "", { "optionalDependencies": { "@img/sharp-libvips-linux-ppc64": "1.3.4" }, "os": "linux", "cpu": "ppc64" }, "sha512-QVxAAq8evVRI9ia2vqgwrmWucn5Dfv+JdWzj75pD8omHLPSP7f8p20O8jxzjCcuCEQEOtYOZUmX1hkiZ0kdevA=="],- "@img/sharp-linux-riscv64": ["@img/[email protected]", "", { "optionalDependencies": { "@img/sharp-libvips-linux-riscv64": "1.3.2" }, "os": "linux", "cpu": "none" }, "sha512-0Eob78yjlYPfL5vMNWAW55l3R9Y6BQS/gOfe0ZcP9mEz9ohhKSt4im1hayiknXgf8AWrFqMvJcKIdmLmEe7yeQ=="],+ "@img/sharp-linux-riscv64": ["@img/[email protected]", "", { "optionalDependencies": { "@img/sharp-libvips-linux-riscv64": "1.3.4" }, "os": "linux", "cpu": "none" }, "sha512-LtdreXguaavKODPIfzJ4kffx7UNt1omwtK0rch4EBbbSTXPnxWmYSayXdLJw0fJzQ97kHt1gL/yh4tvU+nCyRQ=="],- "@img/sharp-linux-s390x": ["@img/[email protected]", "", { "optionalDependencies": { "@img/sharp-libvips-linux-s390x": "1.3.2" }, "os": "linux", "cpu": "s390x" }, "sha512-KgAxQ0DxpNOq1rG2t5cgTgShJFGSuU7XO45cqC+1NVOuZnP6tlgZRuSYOfNupGkHID0o3cJOsw4DVeJpMovcGw=="],+ "@img/sharp-linux-s390x": ["@img/[email protected]", "", { "optionalDependencies": { "@img/sharp-libvips-linux-s390x": "1.3.4" }, "os": "linux", "cpu": "s390x" }, "sha512-UZasTOFiYzotTsGOCu42BfUzP6Tu6Do/947iRm1RsLKvlllxwGcn4RN27LibGWceix4Y+Pmw3jsnTcCQIgWjqA=="],- "@img/sharp-linux-x64": ["@img/[email protected]", "", { "optionalDependencies": { "@img/sharp-libvips-linux-x64": "1.3.2" }, "os": "linux", "cpu": "x64" }, "sha512-8pqvxubL2PGdhlPy6GLqzDYMUjyRmKAwKHYKixpdJYBUK7PJ0C029XdsnpFIdgRZG68fZiGdHVWcKPvtiPB4cA=="],+ "@img/sharp-linux-x64": ["@img/[email protected]", "", { "optionalDependencies": { "@img/sharp-libvips-linux-x64": "1.3.4" }, "os": "linux", "cpu": "x64" }, "sha512-SxFtLTeJInhAA9Q836kux2vZNeOBQEx658qvbboZScr0wIARym3IcGmW7KpVD5sbVg0Ojy+udFQdayYIZyoNog=="],- "@img/sharp-linuxmusl-arm64": ["@img/[email protected]", "", { "optionalDependencies": { "@img/sharp-libvips-linuxmusl-arm64": "1.3.2" }, "os": "linux", "cpu": "arm64" }, "sha512-Vz0iQjzzcSX3HCbfwFfCSG/9SCIqyO0mH2sXyiHaAYfBk0cRsCWXRyQYX0ovCK/PAQBbTzQ0dsPQHh5MAFL59w=="],+ "@img/sharp-linuxmusl-arm64": ["@img/[email protected]", "", { "optionalDependencies": { "@img/sharp-libvips-linuxmusl-arm64": "1.3.4" }, "os": "linux", "cpu": "arm64" }, "sha512-9HbMclmI1zlNkFRs3z9/eBtDjfD0sGlrX1z6b1qwmiFY5ElDLh4BC0LPBdVp7z1DXFiKlIcznf+ZlsuZzLxQqg=="],- "@img/sharp-linuxmusl-x64": ["@img/[email protected]", "", { "optionalDependencies": { "@img/sharp-libvips-linuxmusl-x64": "1.3.2" }, "os": "linux", "cpu": "x64" }, "sha512-6O1NPKcDVj9QEdg7Hx549EX8U0rp6yXQERqru6yRN7fGBn32UvIRJUlWnk+8xDCiG76hXVBbX82NZ/ZKr0euIg=="],+ "@img/sharp-linuxmusl-x64": ["@img/[email protected]", "", { "optionalDependencies": { "@img/sharp-libvips-linuxmusl-x64": "1.3.4" }, "os": "linux", "cpu": "x64" }, "sha512-4KOphqB035HrVdqLZfCgMzzERrQkkzOwRhl4OAkRO1YCldbaFjySXMaK534Mo0V+LndnlJk+sbUyLeU0ULyD1A=="],- "@img/sharp-wasm32": ["@img/[email protected]", "", { "dependencies": { "@emnapi/runtime": "^1.11.1" } }, "sha512-cZ0XkcYGpHZkqW6iCkqTcmUC0CD9DhD5d/qeZlZkfRBn6GnHniZXLUo5+9xw8Iv76YE6LQFN9YNBlKREcCG76w=="],+ "@img/sharp-wasm32": ["@img/[email protected]", "", { "dependencies": { "@emnapi/runtime": "^1.11.3" } }, "sha512-Ptsga1su4tQx+LLF1ECS9U6nz5kmrXKo6XVbtR48Ke3ZRxxgaWBu7IDtEe1quo8hiupwm6WFqxVlXaSf7IINGQ=="],- "@img/sharp-webcontainers-wasm32": ["@img/[email protected]", "", { "dependencies": { "@img/sharp-wasm32": "0.35.3" }, "cpu": "none" }, "sha512-2rnq7bX3NzeR2T4YWgz8qiG4h3TSdMe+vN1iQXpJleSJ3SM5zQ8Fy2SyyXAWlbxpEZ2Y+Z4u1BePgJEYbSy80Q=="],+ "@img/sharp-webcontainers-wasm32": ["@img/[email protected]", "", { "dependencies": { "@img/sharp-wasm32": "0.35.5" }, "cpu": "none" }, "sha512-hfhF/FmoQyTUkA0bIKFOtw536BQSeBMe6BF6QyWlrPxT754+TFLaZ7sKKTfvvM0yJgKgaYTwnFCIZ/GuDw5SUA=="],- "@img/sharp-win32-arm64": ["@img/[email protected]", "", { "os": "win32", "cpu": "arm64" }, "sha512-4bPwFdMbeC4JQ8L8LOyWp6nsHcboP5fxkp6iPOXz2Vg49R42TuMs2whkJ5OAP4/Ul035qOzy0AecOF9VOscn4w=="],+ "@img/sharp-win32-arm64": ["@img/[email protected]", "", { "os": "win32", "cpu": "arm64" }, "sha512-X4t7g+7ZA5DKblCBEXGjUqqemj4vczING/5viFwAL8h4N3qYeyjwdCvRLHi4EdOUI+2Z7UFlp1VM+p/AuEtm6Q=="],- "@img/sharp-win32-ia32": ["@img/[email protected]", "", { "os": "win32", "cpu": "ia32" }, "sha512-r53mXsBN6lFUDiST764SvgwUdHAqM4rPAiDzAmf4fLoB6X/rkfyTrLCg6+g17wJJiCmB3JYgHuUldCWUIRFSXw=="],+ "@img/sharp-win32-ia32": ["@img/[email protected]", "", { "os": "win32", "cpu": "ia32" }, "sha512-5Zm82LoBc43nhwNybZlG7Y1KO//Zhsn306fQl29ZOuStHLGTo3BWL83q3cznX0poxSAMuYL1On/BHBxkBeKr6A=="],- "@img/sharp-win32-x64": ["@img/[email protected]", "", { "os": "win32", "cpu": "x64" }, "sha512-D4y1vNeZrIIJCN+uHaWVtH86B+aCrdMYYjicy9pXHvbGZeGYLLSd3wdVuC37FxVXlU1ARsk84eKWfWMXGYEqvA=="],+ "@img/sharp-win32-x64": ["@img/[email protected]", "", { "os": "win32", "cpu": "x64" }, "sha512-x76eH0vEiHlcMQu8Y8IenntaACtddpT6W0wmXtWrnKcnKI7ME5DdgqhAD6SEWOEl1v2zDvkZDhFA9KnURwpfqg=="],"@jridgewell/gen-mapping": ["@jridgewell/[email protected]", "", { "dependencies": { "@jridgewell/sourcemap-codec": "^1.5.0", "@jridgewell/trace-mapping": "^0.3.24" } }, "sha512-2kkt/7niJ6MgEPxF0bYdQ6etZaA+fQvDcLKckhy1yIQOzaoKjBBjSj63/aLVjYE3qhRt5dvM+uUyfCg6UKCBbA=="],@@ -384,6 +391,24 @@"@paper-design/shaders-react": ["@paper-design/[email protected]", "", { "dependencies": { "@paper-design/shaders": "0.0.76" }, "peerDependencies": { "@types/react": "^18 || ^19", "react": "^18 || ^19" }, "optionalPeers": ["@types/react"] }, "sha512-uPJWrYRf6cJdO2H+fuXlahaqz0QjYglNAyUTaRfIInpzCa/d6guxBIK003soAZQFuQ035yg9FhtfFzKNWm+a5A=="],+ "@protobufjs/aspromise": ["@protobufjs/[email protected]", "", {}, "sha512-j+gKExEuLmKwvz3OgROXtrJ2UG2x8Ch2YZUxahh+s1F2HZ+wAceUNLkvy6zKCPVRkU++ZWQrdxsUeQXmcg4uoQ=="],++ "@protobufjs/base64": ["@protobufjs/[email protected]", "", {}, "sha512-AZkcAA5vnN/v4PDqKyMR5lx7hZttPDgClv83E//FMNhR2TMcLUhfRUBHCmSl0oi9zMgDDqRUJkSxO3wm85+XLg=="],++ "@protobufjs/codegen": ["@protobufjs/[email protected]", "", {}, "sha512-zgXFLzW3Ap33e6d0Wlj4MGIm6Ce8O89n/apUaGNB/jx+hw+ruWEp7EwGUshdLKVRCxZW12fp9r40E1mQrf/34g=="],++ "@protobufjs/eventemitter": ["@protobufjs/[email protected]", "", {}, "sha512-vW1GmwMZNnL+gMRaovlh9yZX74kc+TTU3FObkkurpMaRtBfLP3ldjS9KQWlwZgraRE0+dheEEoAxdzcJQ8eXZg=="],++ "@protobufjs/fetch": ["@protobufjs/[email protected]", "", { "dependencies": { "@protobufjs/aspromise": "^1.1.1" } }, "sha512-GpptLrs57adMSuHi3VNj0mAF8dwh36LMaYF6XyJ6JMWlVsc+t42tm1HSEDmOs3A8fC9yyeisgLhsTVQokOZ0zw=="],++ "@protobufjs/float": ["@protobufjs/[email protected]", "", {}, "sha512-Ddb+kVXlXst9d+R9PfTIxh1EdNkgoRe5tOX6t01f1lYWOvJnSPDBlG241QLzcyPdoNTsblLUdujGSE4RzrTZGQ=="],++ "@protobufjs/path": ["@protobufjs/[email protected]", "", {}, "sha512-6JOcJ5Tm08dOHAbdR3GrvP+yUUfkjG5ePsHYczMFLq3ZmMkAD98cDgcT2iA1lJ9NVwFd4tH/iSSoe44YWkltEA=="],++ "@protobufjs/pool": ["@protobufjs/[email protected]", "", {}, "sha512-0kELaGSIDBKvcgS4zkjz1PeddatrjYcmMWOlAuAPwAeccUrPHdUqo/J6LiymHHEiJT5NrF1UVwxY14f+fy4WQw=="],++ "@protobufjs/utf8": ["@protobufjs/[email protected]", "", {}, "sha512-b1UQwcEZ4yCnMCD8DAL1VlbvBJE9/IX4FTIp7BG1xYpf29SLazLSrqUkj4w7Y5y7cCVP6E5tcqqcI0xemPkHug=="],+"@radix-ui/number": ["@radix-ui/[email protected]", "", {}, "sha512-MkKCwxlXTgz6CFoJx3pCwn07GKp36+aZyu/u2Ln2VrA5DcdyCZkASEDBTd8x5whTQQL5CiYf4prXKLcgQdv29g=="],"@radix-ui/primitive": ["@radix-ui/[email protected]", "", {}, "sha512-JTF99U/6XIjCBo0wqkU5sK10glYe27MRRsfwoiq5zzOEZLHU3A3KCMa5X/azekYRCJ0HlwI0crAXS/5dEHTzDg=="],@@ -752,6 +777,8 @@"acorn-jsx": ["[email protected]", "", { "peerDependencies": { "acorn": "^6.0.0 || ^7.0.0 || ^8.0.0" } }, "sha512-rq9s+JNhf0IChjtDXxllJ7g41oZk5SlXtp0LHwyA5cejwn7vKmKp4pPri6YEePv2PU65sAsegbXtIinmDFDXgQ=="],+ "adm-zip": ["[email protected]", "", {}, "sha512-Xwrja8nx9e5o2N1my4DsKCeKpdrnACyr1wtbPxBDgGzKzKyE9kRtBFA8mWldI+RVlD7CBZNWY/wQ2+ydwOR6kQ=="],+"agent-base": ["[email protected]", "", {}, "sha512-MnA+YT8fwfJPgBx3m60MNqakm30XOkyIoH1y6huTQvC0PwZG7ki8NacLBcrPbNoo8vEZy7Jpuk7+jMO+CUovTQ=="],"ajv": ["[email protected]", "", { "dependencies": { "fast-deep-equal": "^3.1.3", "fast-uri": "^3.0.1", "json-schema-traverse": "^1.0.0", "require-from-string": "^2.0.2" } }, "sha512-PlXPeEWMXMZ7sPYOHqmDyCJzcfNrUr3fGNKtezX14ykXOEIvyK81d+qydx89KY5O71FKMPaQ2vBfBFI5NHR63A=="],@@ -882,8 +909,12 @@"default-browser-id": ["[email protected]", "", {}, "sha512-x1VCxdX4t+8wVfd1so/9w+vQ4vx7lKd2Qp5tDRutErwmR85OgmfX7RlLRMWafRMY7hbEiXIbudNrjOAPa/hL8Q=="],+ "define-data-property": ["[email protected]", "", { "dependencies": { "es-define-property": "^1.0.0", "es-errors": "^1.3.0", "gopd": "^1.0.1" } }, "sha512-rBMvIzlpA8v6E+SJZoo++HAYqsLrkg7MSfIinMPFhmkorw7X+dOXVJQs+QT69zGkzMyfDnIMN2Wid1+NbL3T+A=="],+"define-lazy-prop": ["[email protected]", "", {}, "sha512-N+MeXYoqr3pOgn8xfyRPREN7gHakLYjhsHhWGT3fWAiL4IkAt0iDw14QiiEm2bE30c5XX5q0FtAA3CK5f9/BUg=="],+ "define-properties": ["[email protected]", "", { "dependencies": { "define-data-property": "^1.0.1", "has-property-descriptors": "^1.0.0", "object-keys": "^1.1.1" } }, "sha512-8QmQKqEASLd5nx0U1B1okLElbUuuttJ/AnYmRXbbbGDWh6uS208EjD4Xqq/I9wK7u0v6O08XhTWnt5XtEbR6Dg=="],+"depd": ["[email protected]", "", {}, "sha512-g7nH6P6dyDioJogAAGprGpCtVImJhpPk/roCzdb3fIh61/s/nPsfR6onyMwkCAR/OlC3yBC0lESvUoQEAssIrw=="],"dequal": ["[email protected]", "", {}, "sha512-0je+qPKHEMohvfRTCEo3CrPG6cAzAYgmzKyxRiYSSDkS6eGJdyVJm7WaYA5ECaAD9wLB2T4EEeymA5aFVcYXCA=="],@@ -940,7 +971,7 @@"escape-html": ["[email protected]", "", {}, "sha512-NiSupZ4OeuGwr68lGIeym/ksIZMJodUGOSCZ/FSnTxcrekbvqrgdUxlJOMpijaKZVjAJrWrGs/6Jy8OMuyj9ow=="],- "escape-string-regexp": ["[email protected]", "", {}, "sha512-/veY75JbMK4j1yjvuUxuVsiS/hr/4iHs9FTT6cgTexxdE0Ly/glccBAkloH/DofkjRbZU3bnoj38mOmhkZ0lHw=="],+ "escape-string-regexp": ["[email protected]", "", {}, "sha512-TtpcNJ3XAzx3Gq8sWRzJaVajRs0uVxA2YAkdb1jm2YkPz4G6egUFAyA3n5vtEIZefPk5Wa4UXbKuS5fKkJWdgA=="],"eslint-scope": ["[email protected]", "", { "dependencies": { "esrecurse": "^4.3.0", "estraverse": "^4.1.1" } }, "sha512-2NxwbF/hZ0KpepYN0cNbo+FN6XoK7GaHlQhgx/hIZl6Va0bF45RQOOwhLIy8lQDbuCiadSLCBnH2CFYquit5bw=="],@@ -1000,6 +1031,8 @@"finalhandler": ["[email protected]", "", { "dependencies": { "debug": "^4.4.0", "encodeurl": "^2.0.0", "escape-html": "^1.0.3", "on-finished": "^2.4.1", "parseurl": "^1.3.3", "statuses": "^2.0.1" } }, "sha512-S8KoZgRZN+a5rNwqTxlZZePjT/4cnm0ROV70LedRHZ0p8u9fRID0hJUZQpkKLzro8LfmC8sx23bY6tVNxv8pQA=="],+ "flatbuffers": ["[email protected]", "", {}, "sha512-MI1qs7Lo4Syw0EOzUl0xjs2lsoeqFku44KpngfIduHBYvzm8h2+7K8YMQh1JtVVVrUvhLpNwqVi4DERegUJhPQ=="],+"formdata-polyfill": ["[email protected]", "", { "dependencies": { "fetch-blob": "^3.1.2" } }, "sha512-buewHzMvYL29jdeQTVILecSaZKnt/RJWjoZCF5OW60Z67/GmSLBkOFM7qh1PI3zFNtJbaZL5eQu1vLfazOwj4g=="],"forwarded": ["[email protected]", "", {}, "sha512-buRG0fpBtRHSTCOASe6hD258tEubFoRLb4ZNA6NxMVHNw2gOcwHo9wyablzMzOA5z9xA9L1KNjk/Nt6MT9aYow=="],@@ -1044,12 +1077,20 @@"glob-to-regexp": ["[email protected]", "", {}, "sha512-lkX1HJXwyMcprw/5YUZc2s7DrpAiHB21/V+E1rHUrVNokkvB6bqMzT0VfV6/86ZNabt1k14YOIaT7nDvOX3Iiw=="],+ "global-agent": ["[email protected]", "", { "dependencies": { "globalthis": "^1.0.2", "matcher": "^4.0.0", "semver": "^7.3.5", "serialize-error": "^8.1.0" } }, "sha512-pxaZqdsMwPA4i7TuRKpDUONm2xGRjvYdRoidCQz7VleUKVuUfh/4p5Q3QDTGrpAE5Kz5TxxcZ+uqEgTkoKRNtg=="],++ "globalthis": ["[email protected]", "", { "dependencies": { "define-properties": "^1.2.1", "gopd": "^1.0.1" } }, "sha512-DpLKbNU4WylpxJykQujfCcwYWiV/Jhm50Goo0wrVILAv5jOr9d+H+UR3PhSCD2rCCEIg0uc+G+muBTwD54JhDQ=="],+"gopd": ["[email protected]", "", {}, "sha512-ZUKRh6/kUFoAiTAtTYPZJ3hw9wNxx+BIBOijnlG9PnrJsCcSjs1wyyD6vJpaYtgnzDrKYRSqf3OO6Rfa93xsRg=="],"graceful-fs": ["[email protected]", "", {}, "sha512-RbJ5/jmFcNNCcDV5o9eTnBLJ/HszWV0P73bc+Ff4nS/rJj+YaS6IGyiOL0VoBYX+l1Wrl3k63h/KrH+nhJ0XvQ=="],+ "guid-typescript": ["[email protected]", "", {}, "sha512-Y8T4vYhEfwJOTbouREvG+3XDsjr8E3kIr7uf+JZ0BYloFsttiHU0WfvANVsR7TxNUJa/WpCnw/Ino/p+DeBhBQ=="],+"has-flag": ["[email protected]", "", {}, "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ=="],+ "has-property-descriptors": ["[email protected]", "", { "dependencies": { "es-define-property": "^1.0.0" } }, "sha512-55JNKuIW+vq4Ke1BjOTjM2YctQIvCT7GFzHwmfZPGo5wnrgkid0YQtnAleFSqumZm4az3n2BS+erby5ipJdgrg=="],+"has-symbols": ["[email protected]", "", {}, "sha512-1cDNdwJ2Jaohmb3sg4OmKaMBwuC48sYni5HUw2DvsC8LjGTLK9h+eb1X6RyuOHe4hT0ULCW68iomhjUoKUqlPQ=="],"hasown": ["[email protected]", "", { "dependencies": { "function-bind": "^1.1.2" } }, "sha512-0hJU9SCPvmMzIBdZFqNPXWa6dqh7WdH0cII9y+CyS8rG3nL48Bclra9HmKhVVUHyPWNH5Y7xDwAB7bfgSjkUMQ=="],@@ -1204,6 +1245,8 @@"log-symbols": ["[email protected]", "", { "dependencies": { "chalk": "^5.3.0", "is-unicode-supported": "^1.3.0" } }, "sha512-i24m8rpwhmPIS4zscNzK6MSEhk0DUWa/8iYQWxhffV8jkI4Phvs3F+quL5xvS0gdQR0FyTCMMH33Y78dDTzzIw=="],+ "long": ["[email protected]", "", {}, "sha512-mNAgZ1GmyNhD7AuqnTG3/VQ26o760+ZYBPKjPvugO8+nLbYfX6TVpJPseBvopbdY+qpZ/lKUnmEc1LeZYS3QAA=="],+"longest-streak": ["[email protected]", "", {}, "sha512-9Ri+o0JYgehTaVBBDoMqIl8GXtbWg711O3srftcHhZ0dqnETqLaoIK0x17fUw9rFSlK/0NlsKe0Ahhyl5pXE2g=="],"lower-case": ["[email protected]", "", { "dependencies": { "tslib": "^2.0.3" } }, "sha512-7fm3l3NAF9WfN6W3JOmf5drwpVqX78JtoGJ3A6W0a6ZnldM41w2fV5D490psKFTpMds8TJse/eHLFFsNHHjHgg=="],@@ -1218,6 +1261,8 @@"markdown-table": ["[email protected]", "", {}, "sha512-wiYz4+JrLyb/DqW2hkFJxP7Vd7JuTDm77fvbM8VfEQdmSMqcImWeeRbHwZjBjIFki/VaMK2BhFi7oUUZeM5bqw=="],+ "matcher": ["[email protected]", "", { "dependencies": { "escape-string-regexp": "^4.0.0" } }, "sha512-S6x5wmcDmsDRRU/c2dkccDwQPXoFczc5+HpQ2lON8pnvHlnvHAHj5WlLVvw6n6vNyHuVugYrFohYxbS+pvFpKQ=="],+"math-intrinsics": ["[email protected]", "", {}, "sha512-/IXtbwEk5HTPyEwyKX6hGkYXxM9nbj64B+ilVJnC/R6B0pH5G4V3b0pVbL7DBj4tkhBAppbQUlf6F6Xl9LHu1g=="],"mdast-util-find-and-replace": ["[email protected]", "", { "dependencies": { "@types/mdast": "^4.0.0", "escape-string-regexp": "^5.0.0", "unist-util-is": "^6.0.0", "unist-util-visit-parents": "^6.0.0" } }, "sha512-Tmd1Vg/m3Xz43afeNxDIhWRtFZgM2VLyaf4vSTYwudTyeuTneoL3qtWMA5jeLyz/O1vDJmmV4QuScFCA2tBPwg=="],@@ -1386,6 +1431,8 @@"object-inspect": ["[email protected]", "", {}, "sha512-W67iLl4J2EXEGTbfeHCffrjDfitvLANg0UlX3wFUUSTx92KXRFegMHUVgSqE+wvhAbi4WqjGg9czysTV2Epbew=="],+ "object-keys": ["[email protected]", "", {}, "sha512-NuAESUOUMrlIXOfHKzD6bpPu3tYt3xvjNdRIQ+FeT0lNb4K8WR70CaDxhuNguS2XG+GjkyMwOzsN5ZktImfhLA=="],+"object-treeify": ["[email protected]", "", {}, "sha512-EFVjAYfzWqWsBMRHPMAXLCDIJnpMhdWAqR7xG6M6a2cs6PMFpl/+Z20w9zDW4vkxOFfddegBKq9Rehd0bxWE7A=="],"ogl": ["[email protected]", "", {}, "sha512-kUpC154AFfxi16pmZUK4jk3J+8zxwTWGPo03EoYA8QPbzikHoaC82n6pNTbd+oEaJonaE8aPWBlX7ad9zrqLsA=="],@@ -1400,6 +1447,12 @@"oniguruma-to-es": ["[email protected]", "", { "dependencies": { "oniguruma-parser": "^0.12.1", "regex": "^6.1.0", "regex-recursion": "^6.0.2" } }, "sha512-Zjygswjpsewa0NLTsiizVuMQZbp0MDyM6lIt66OxsF21npUDlzpHi1Mgb/qhQdkb+dWFTzJmFbEWdvZgRho8eQ=="],+ "onnxruntime-common": ["[email protected]", "", {}, "sha512-7fdVWjAID1dVhH/G8qK3APARunV4VkBFoCQAP7qp4Wkab0mrorvmc+sqiT+mKXOzDqdjN5j+/Z9nb4gzNPWcyA=="],++ "onnxruntime-node": ["[email protected]", "", { "dependencies": { "adm-zip": "^0.6.0", "global-agent": "^4.1.3", "onnxruntime-common": "1.30.0" }, "os": [ "linux", "win32", "darwin", ] }, "sha512-twhs1C2C/BFkz1yc5OY0KIU2GUq6DURO7hD4bx5Q2Qy3nAMJwRXW8xU3NVczE29VA9lolLOYepoD8fjTGOfIqw=="],++ "onnxruntime-web": ["[email protected]", "", { "dependencies": { "flatbuffers": "^25.1.24", "guid-typescript": "^1.0.9", "long": "^5.2.3", "onnxruntime-common": "1.31.0-dev.20260911-2a43ec07e", "platform": "^1.3.6", "protobufjs": "^7.2.4" } }, "sha512-Iy7rtadoBgxS/LLvDr3QW38DB1PNXRnr0GJMcL0TAt7c9qjgVQl83UlGCVyeAnK2InpmW8Uc3PL8XIuqtDeF6g=="],+"open": ["[email protected]", "", { "dependencies": { "default-browser": "^5.4.0", "define-lazy-prop": "^3.0.0", "is-in-ssh": "^1.0.0", "is-inside-container": "^1.0.0", "powershell-utils": "^0.1.0", "wsl-utils": "^0.3.0" } }, "sha512-smsWv2LzFjP03xmvFoJ331ss6h+jixfA4UUV/Bsiyuu4YJPfN+FIQGOIiv4w9/+MoHkfkJ22UIaQWRVFRfH6Vw=="],"opentype.js": ["[email protected]", "", { "bin": { "ot": "bin/ot" } }, "sha512-kCyjv6xdDY1W/jLWZ/L3QhhTlKUqDZMQ5+Jdlw12b3dXkKNpYBqqlMMj0YDQPShWFTMwgZI1hG14kN3XUDSg/A=="],@@ -1436,6 +1489,8 @@"pkce-challenge": ["[email protected]", "", {}, "sha512-wQ0b/W4Fr01qtpHlqSqspcj3EhBvimsdh0KlHhH8HRZnMsEa0ea2fTULOXOS9ccQr3om+GcGRk4e+isrZWV8qQ=="],+ "platform": ["[email protected]", "", {}, "sha512-fnWVljUchTro6RiCFvCXBbNhJc2NijN7oIQxbwsyL0buWJPG85v81ehlHI9fXrJsMNgTofEoWIQeClKpgxFLrg=="],+"postcss": ["[email protected]", "", { "dependencies": { "nanoid": "^3.3.11", "picocolors": "^1.1.1", "source-map-js": "^1.2.1" } }, "sha512-OW/rX8O/jXnm82Ey1k44pObPtdblfiuWnrd8X7GJ7emImCOstunGbXUpp7HdBrFQX6rJzn3sPT397Wp5aCwCHg=="],"postcss-modules-extract-imports": ["[email protected]", "", { "peerDependencies": { "postcss": "^8.1.0" } }, "sha512-k3kNe0aNFQDAZGbin48pL2VNidTF0w4/eASDsxlyspobzU3wZQLOGj7L9gfRe0Jo9/4uud09DsjFNH7winGv8Q=="],@@ -1460,6 +1515,8 @@"property-information": ["[email protected]", "", {}, "sha512-TwEZ+X+yCJmYfL7TPUOcvBZ4QfoT5YenQiJuX//0th53DE6w0xxLEtfK3iyryQFddXuvkIk51EEgrJQ0WJkOmQ=="],+ "protobufjs": ["[email protected]", "", { "dependencies": { "@protobufjs/aspromise": "^1.1.2", "@protobufjs/base64": "^1.1.2", "@protobufjs/codegen": "^2.0.5", "@protobufjs/eventemitter": "^1.1.1", "@protobufjs/fetch": "^1.1.1", "@protobufjs/float": "^1.0.2", "@protobufjs/path": "^1.1.2", "@protobufjs/pool": "^1.1.0", "@protobufjs/utf8": "^1.1.1", "@types/node": ">=13.7.0", "long": "^5.3.2" } }, "sha512-dYDWdjSl5RNb7SgPxGQcRU+GtvP7s2fpkrY0r432PcOIaZ0/rBcxEZnQN67iJhFuQiVw754JDoPruPCNdGsbjg=="],+"proxy-addr": ["[email protected]", "", { "dependencies": { "forwarded": "0.2.0", "ipaddr.js": "1.9.1" } }, "sha512-llQsMLSUDUPT44jdrU/O37qlnifitDP+ZwrmmZcoSKyLKvtZxpyV0n2/bD/N4tBAAZ/gJEdZU7KMraoK1+XYAg=="],"qs": ["[email protected]", "", { "dependencies": { "side-channel": "^1.1.0" } }, "sha512-mAZTtNCeetKMH+pSjrb76NAM8V9a05I9aBZOHztWy/UqcJdQYNsf59vrRKWnojAT9Y+GbIvoTBC++CPHqpDBhQ=="],@@ -1560,6 +1617,8 @@"send": ["[email protected]", "", { "dependencies": { "debug": "^4.4.3", "encodeurl": "^2.0.0", "escape-html": "^1.0.3", "etag": "^1.8.1", "fresh": "^2.0.0", "http-errors": "^2.0.1", "mime-types": "^3.0.2", "ms": "^2.1.3", "on-finished": "^2.4.1", "range-parser": "^1.2.1", "statuses": "^2.0.2" } }, "sha512-1gnZf7DFcoIcajTjTwjwuDjzuz4PPcY2StKPlsGAQ1+YH20IRVrBaXSWmdjowTJ6u8Rc01PoYOGHXfP1mYcZNQ=="],+ "serialize-error": ["[email protected]", "", { "dependencies": { "type-fest": "^0.20.2" } }, "sha512-3NnuWfM6vBYoy5gZFvHiYsVbafvI9vZv/+jlIigFn4oP4zjNPK3LhcY0xSCgeb1a5L8jO71Mit9LlNoi2UfDDQ=="],+"serve-static": ["[email protected]", "", { "dependencies": { "encodeurl": "^2.0.0", "escape-html": "^1.0.3", "parseurl": "^1.3.3", "send": "^1.2.0" } }, "sha512-xRXBn0pPqQTVQiC8wyQrKs2MOlX24zQ0POGaj0kultvoOCstBQM5yvOhAVSUwOMjQtTvsPWoNCHfPGwaaQJhTw=="],"server-only": ["[email protected]", "", {}, "sha512-qepMx2JxAa5jjfzxG79yPPq+8BuFToHd1hm7kI+Z4zAq1ftQiP7HcxMhDDItrbtwVeLg/cY2JnKnrcFkmiswNA=="],@@ -1568,7 +1627,7 @@"shadcn": ["[email protected]", "", { "dependencies": { "@babel/core": "^7.28.0", "@babel/parser": "^7.28.0", "@babel/plugin-transform-typescript": "^7.28.0", "@babel/preset-typescript": "^7.27.1", "@dotenvx/dotenvx": "^1.48.4", "@modelcontextprotocol/sdk": "^1.26.0", "@types/validate-npm-package-name": "^4.0.2", "browserslist": "^4.26.2", "commander": "^14.0.0", "cosmiconfig": "^9.0.0", "dedent": "^1.6.0", "deepmerge": "^4.3.1", "diff": "^8.0.2", "execa": "^9.6.0", "fast-glob": "^3.3.3", "fs-extra": "^11.3.1", "fuzzysort": "^3.1.0", "https-proxy-agent": "^7.0.6", "kleur": "^4.1.5", "node-fetch": "^3.3.2", "open": "^11.0.0", "ora": "^8.2.0", "postcss": "^8.5.6", "postcss-selector-parser": "^7.1.0", "prompts": "^2.4.2", "recast": "^0.23.11", "stringify-object": "^5.0.0", "tailwind-merge": "^3.0.1", "ts-morph": "^26.0.0", "tsconfig-paths": "^4.2.0", "validate-npm-package-name": "^7.0.1", "zod": "^3.24.1", "zod-to-json-schema": "^3.24.6" }, "bin": { "shadcn": "dist/index.js" } }, "sha512-UV0cchFea9hO7poV1CuEP0wvmYjpAqcxCKdy23bndl2Du2ARtDs8A4xdzfhUjDBeOW1nNpJ6lXmsEpsply2SfQ=="],- "sharp": ["[email protected]", "", { "dependencies": { "@img/colour": "^1.1.0", "detect-libc": "^2.1.2", "semver": "^7.8.5" }, "optionalDependencies": { "@img/sharp-darwin-arm64": "0.35.3", "@img/sharp-darwin-x64": "0.35.3", "@img/sharp-freebsd-wasm32": "0.35.3", "@img/sharp-libvips-darwin-arm64": "1.3.2", "@img/sharp-libvips-darwin-x64": "1.3.2", "@img/sharp-libvips-linux-arm": "1.3.2", "@img/sharp-libvips-linux-arm64": "1.3.2", "@img/sharp-libvips-linux-ppc64": "1.3.2", "@img/sharp-libvips-linux-riscv64": "1.3.2", "@img/sharp-libvips-linux-s390x": "1.3.2", "@img/sharp-libvips-linux-x64": "1.3.2", "@img/sharp-libvips-linuxmusl-arm64": "1.3.2", "@img/sharp-libvips-linuxmusl-x64": "1.3.2", "@img/sharp-linux-arm": "0.35.3", "@img/sharp-linux-arm64": "0.35.3", "@img/sharp-linux-ppc64": "0.35.3", "@img/sharp-linux-riscv64": "0.35.3", "@img/sharp-linux-s390x": "0.35.3", "@img/sharp-linux-x64": "0.35.3", "@img/sharp-linuxmusl-arm64": "0.35.3", "@img/sharp-linuxmusl-x64": "0.35.3", "@img/sharp-webcontainers-wasm32": "0.35.3", "@img/sharp-win32-arm64": "0.35.3", "@img/sharp-win32-ia32": "0.35.3", "@img/sharp-win32-x64": "0.35.3" } }, "sha512-ej0zVHuZGHCiABXcNxeYhpRnPNPAcvbG8RMdBAhDAxLKkCRVSpK3Iyu7qbqw3JMzoj0REeM6f3tJLtVwl0023Q=="],+ "sharp": ["[email protected]", "", { "dependencies": { "@img/colour": "^1.1.0", "detect-libc": "^2.1.2", "semver": "^7.8.5" }, "optionalDependencies": { "@img/sharp-darwin-arm64": "0.35.5", "@img/sharp-darwin-x64": "0.35.5", "@img/sharp-freebsd-wasm32": "0.35.5", "@img/sharp-libvips-darwin-arm64": "1.3.4", "@img/sharp-libvips-darwin-x64": "1.3.4", "@img/sharp-libvips-linux-arm": "1.3.4", "@img/sharp-libvips-linux-arm64": "1.3.4", "@img/sharp-libvips-linux-ppc64": "1.3.4", "@img/sharp-libvips-linux-riscv64": "1.3.4", "@img/sharp-libvips-linux-s390x": "1.3.4", "@img/sharp-libvips-linux-x64": "1.3.4", "@img/sharp-libvips-linuxmusl-arm64": "1.3.4", "@img/sharp-libvips-linuxmusl-x64": "1.3.4", "@img/sharp-linux-arm": "0.35.5", "@img/sharp-linux-arm64": "0.35.5", "@img/sharp-linux-ppc64": "0.35.5", "@img/sharp-linux-riscv64": "0.35.5", "@img/sharp-linux-s390x": "0.35.5", "@img/sharp-linux-x64": "0.35.5", "@img/sharp-linuxmusl-arm64": "0.35.5", "@img/sharp-linuxmusl-x64": "0.35.5", "@img/sharp-webcontainers-wasm32": "0.35.5", "@img/sharp-win32-arm64": "0.35.5", "@img/sharp-win32-ia32": "0.35.5", "@img/sharp-win32-x64": "0.35.5" }, "peerDependencies": { "@types/node": "*" }, "optionalPeers": ["@types/node"] }, "sha512-Ywn4OnzGukp7CDMrp08RQ50YKmuwG47brZgIVPTvBaaAfQlRlygrRqSrxdCiL9M+LlzLBiJ68IR1QqvzHyjC7g=="],"shebang-command": ["[email protected]", "", { "dependencies": { "shebang-regex": "^3.0.0" } }, "sha512-kHxr2zZpYtdmrN1qDjrrX/Z1rR1kG8Dx+gkpK1G4eXmvXswmcE1hTWBWYUzlraYw1/yZp6YuDY77YtvbN0dmDA=="],@@ -1668,6 +1727,8 @@"tw-animate-css": ["[email protected]", "", {}, "sha512-7bziOlRqH0hJx80h/3mbicLW7o8qLsH5+RaLR2t+OHM3D0JlWGODQKQ4cxbK7WlvmUxpcj6Kgu6EKqjrGFe3QQ=="],+ "type-fest": ["[email protected]", "", {}, "sha512-Ne+eE4r0/iWnpAxD852z3A+N0Bt5RN//NjJwRd2VFHEmrywxf5vsZlh4R6lixl6B+wz/8d+maTSAkN1FIkI3LQ=="],+"type-is": ["[email protected]", "", { "dependencies": { "content-type": "^1.0.5", "media-typer": "^1.1.0", "mime-types": "^3.0.0" } }, "sha512-OZs6gsjF4vMp32qrCbiVSkrFmXtG/AZhY3t0iAMrMBiAZyV9oALtXO8hsrHbMXF9x6L3grlFuwW2oAz7cav+Gw=="],"typescript": ["[email protected]", "", { "bin": { "tsc": "bin/tsc", "tsserver": "bin/tsserver" } }, "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw=="],@@ -1852,18 +1913,26 @@"fumadocs-ui/motion": ["[email protected]", "", { "dependencies": { "framer-motion": "^12.38.0", "tslib": "^2.4.0" }, "peerDependencies": { "@emotion/is-prop-valid": "*", "react": "^18.0.0 || ^19.0.0", "react-dom": "^18.0.0 || ^19.0.0" }, "optionalPeers": ["@emotion/is-prop-valid", "react", "react-dom"] }, "sha512-uYfXzeHlgThchzwz5Te47dlv5JOUC7OB4rjJ/7XTUgtBZD8CchMN8qEJ4ZVsUmTyYA44zjV0fBwsiktRuFnn+w=="],+ "global-agent/semver": ["[email protected]", "", { "bin": { "semver": "bin/semver.js" } }, "sha512-Y7/KDsb8LjooZpwaqGyulO6DQlksgCncchHGk+sZIY4SBvUocMBEFH5Ur1fI4dV+Jvl0w6cjvucaIi40puRioA=="],+"is-inside-container/is-docker": ["[email protected]", "", { "bin": { "is-docker": "cli.js" } }, "sha512-eljcgEDlEns/7AXFosB5K/2nCM4P7FQPkGc/DWLy5rmFEWvZayGrik1d9/QIY5nJ4f9YsVvBkA6kJpHn9rISdQ=="],"log-symbols/is-unicode-supported": ["[email protected]", "", {}, "sha512-43r2mRvz+8JRIKnWJ+3j8JtjRKZ6GmjzfaE/qiBJnikNnYv/6bagRJ1kUhNk8R5EX/GkobD+r+sfxCPJsiKBLQ=="],+ "mdast-util-find-and-replace/escape-string-regexp": ["[email protected]", "", {}, "sha512-/veY75JbMK4j1yjvuUxuVsiS/hr/4iHs9FTT6cgTexxdE0Ly/glccBAkloH/DofkjRbZU3bnoj38mOmhkZ0lHw=="],+"micromatch/picomatch": ["[email protected]", "", {}, "sha512-V7+vQEJ06Z+c5tSye8S+nHUfI51xoXIXjHQ99cQtKUkQqqO1kO/KCJUfZXuB47h/YBlDhah2H3hdUGXn8ie0oA=="],"next/postcss": ["[email protected]", "", { "dependencies": { "nanoid": "^3.3.16", "picocolors": "^1.1.1", "source-map-js": "^1.2.1" } }, "sha512-g50586zr4bZmwFiTlflMu8E0bDTb5I5gertgwAKmsdUlTQIhZtunzUlD1WSzwcVWPoAVpsrA6vlfCD7oXvRwgg=="],+ "next/sharp": ["[email protected]", "", { "dependencies": { "@img/colour": "^1.1.0", "detect-libc": "^2.1.2", "semver": "^7.8.5" }, "optionalDependencies": { "@img/sharp-darwin-arm64": "0.35.3", "@img/sharp-darwin-x64": "0.35.3", "@img/sharp-freebsd-wasm32": "0.35.3", "@img/sharp-libvips-darwin-arm64": "1.3.2", "@img/sharp-libvips-darwin-x64": "1.3.2", "@img/sharp-libvips-linux-arm": "1.3.2", "@img/sharp-libvips-linux-arm64": "1.3.2", "@img/sharp-libvips-linux-ppc64": "1.3.2", "@img/sharp-libvips-linux-riscv64": "1.3.2", "@img/sharp-libvips-linux-s390x": "1.3.2", "@img/sharp-libvips-linux-x64": "1.3.2", "@img/sharp-libvips-linuxmusl-arm64": "1.3.2", "@img/sharp-libvips-linuxmusl-x64": "1.3.2", "@img/sharp-linux-arm": "0.35.3", "@img/sharp-linux-arm64": "0.35.3", "@img/sharp-linux-ppc64": "0.35.3", "@img/sharp-linux-riscv64": "0.35.3", "@img/sharp-linux-s390x": "0.35.3", "@img/sharp-linux-x64": "0.35.3", "@img/sharp-linuxmusl-arm64": "0.35.3", "@img/sharp-linuxmusl-x64": "0.35.3", "@img/sharp-webcontainers-wasm32": "0.35.3", "@img/sharp-win32-arm64": "0.35.3", "@img/sharp-win32-ia32": "0.35.3", "@img/sharp-win32-x64": "0.35.3" } }, "sha512-ej0zVHuZGHCiABXcNxeYhpRnPNPAcvbG8RMdBAhDAxLKkCRVSpK3Iyu7qbqw3JMzoj0REeM6f3tJLtVwl0023Q=="],+"npm-run-path/path-key": ["[email protected]", "", {}, "sha512-haREypq7xkM7ErfgIyA0z+Bj4AGKlMSdlQE2jvJo6huWD1EdkKYV+G/T4nq0YEF2vgTT8kqMFKo1uHn950r4SQ=="],"nuqs/@standard-schema/spec": ["@standard-schema/[email protected]", "", {}, "sha512-m2bOd0f2RT9k8QJx1JN85cZYyH1RqFBdlwtkSlf4tBDYLCiiZnv1fIIwacK6cqwXavOydf0NPToMQgpKq+dVlA=="],+ "onnxruntime-web/onnxruntime-common": ["[email protected]", "", {}, "sha512-gBuF6U32YErKIAt+yD7DeGBpjRxhJ1uJwako6ygjokSZULDU6Pd+KWComX8Tumk1hYVHRxjPj7mdMnD0ryAPOw=="],+"parse-entities/@types/unist": ["@types/[email protected]", "", {}, "sha512-CmBKiL6NNo/OqgmMn95Fk9Whlp2mtvIv+KNpQKN2F4SjvrEesubTRWGYSg+BnWZOnlCaSTU1sMpsBOzgbYhnsA=="],"parse5/entities": ["[email protected]", "", {}, "sha512-aN97NXWF6AWBTahfVOIrB/NShkzi5H7F9r1s9mD3cDj4Ko5f2qhhVoYMibXF7GlLveb/D2ioWay8lxI97Ven3g=="],@@ -1990,6 +2059,58 @@"next/postcss/nanoid": ["[email protected]", "", { "bin": { "nanoid": "bin/nanoid.cjs" } }, "sha512-xQLf0A3HOMlgHq0n247/LRuAOYmB7dXJ/DvAxGvsSBij45XtBSmQycu+F8ODbHwns/XyFZagyL1+J0Offw1E0g=="],+ "next/sharp/@img/sharp-darwin-arm64": ["@img/[email protected]", "", { "optionalDependencies": { "@img/sharp-libvips-darwin-arm64": "1.3.2" }, "os": "darwin", "cpu": "arm64" }, "sha512-RMnFX7YQsMoh7lWfcM4NEHHymBX/rLuKNPVM84XE9ONPcaSCDgE7CHIHpSgPcO2xcRthgBy1HfNO319mwhIAkg=="],++ "next/sharp/@img/sharp-darwin-x64": ["@img/[email protected]", "", { "optionalDependencies": { "@img/sharp-libvips-darwin-x64": "1.3.2" }, "os": "darwin", "cpu": "x64" }, "sha512-Xo+5uFBtLN0BKqieTxiFzFPQAUlBbbH5iBKyRX/z1JrbnYsHTfKJnUfL8+p2TPXr1pXqao4eeL4Rl144uDpK9w=="],++ "next/sharp/@img/sharp-freebsd-wasm32": ["@img/[email protected]", "", { "dependencies": { "@img/sharp-wasm32": "0.35.3" }, "os": "freebsd" }, "sha512-lUxcqWIj2wMQ9BrwNjngcr1gWUr5xgaGThBRqPPalIC2n67Cqj1uPh8NnA/ZhAg8hUbKl+kVHKwgUIwe6ZYPrg=="],++ "next/sharp/@img/sharp-libvips-darwin-arm64": ["@img/[email protected]", "", { "os": "darwin", "cpu": "arm64" }, "sha512-9J6ypZFpQBj4YnePGoq/S38w6nz+vqg5WZLrLGY4YuSemdMq47GMLBPO42MzwdGwpg/agZ7xzZcFHa48xlywfg=="],++ "next/sharp/@img/sharp-libvips-darwin-x64": ["@img/[email protected]", "", { "os": "darwin", "cpu": "x64" }, "sha512-m2pW1n6cns9VaubNwsZ+c3CRYjxNQWgJ5gPlnL1nbBcpkBvFm6SCFN5o0psFHI8w9n11NKhFkeEDns98tiqbEw=="],++ "next/sharp/@img/sharp-libvips-linux-arm": ["@img/[email protected]", "", { "os": "linux", "cpu": "arm" }, "sha512-1eMLzy92I4J6rmi4mAT8yC3HxOtniyGELlzGbNMLLeqe052ahFQ0h6LFq+lh5DsDIdYViIDst08abvSbcEdLXQ=="],++ "next/sharp/@img/sharp-libvips-linux-arm64": ["@img/[email protected]", "", { "os": "linux", "cpu": "arm64" }, "sha512-dqVSFynCox4C/J8kT16V7SIFAns0IjgLwkvYT7p8LQVmJ5OS5b6tI9IGflxTeuBS//zXeFIUbwt5dwxyZ17cnA=="],++ "next/sharp/@img/sharp-libvips-linux-ppc64": ["@img/[email protected]", "", { "os": "linux", "cpu": "ppc64" }, "sha512-3z0NHDxD6n5I9gc05U1eW1AyRm+Gznzq3naMrthPNqE6oYykcogW0l/jfpJdjYnuNl8R7yI9pNbE1XiUeyq0Aw=="],++ "next/sharp/@img/sharp-libvips-linux-riscv64": ["@img/[email protected]", "", { "os": "linux", "cpu": "none" }, "sha512-bsb4rI+NldGOsXuej2r8OdSS8+zXDVaCWxyWrcv6kneTOlgAHtZABRzBBCwdsPiD90J4myNJuHpg6kA20ImW/w=="],++ "next/sharp/@img/sharp-libvips-linux-s390x": ["@img/[email protected]", "", { "os": "linux", "cpu": "s390x" }, "sha512-/ABshyj8gCpyIrNXnHn4LorDJ0HHm1VhXPBlxZ8zAtfVPAaSafXPGn+sUSIRiwaSBy0mmFjSjiXI5mkcwdChKQ=="],++ "next/sharp/@img/sharp-libvips-linux-x64": ["@img/[email protected]", "", { "os": "linux", "cpu": "x64" }, "sha512-ITPEtgffGJ0S6G9dRyw/366tJQqFRcHWPHhC+Stpg3Z8AEMrDrTr2lhdz4f/Y/HMbRh//7Z5mBzEpVdi62Oc3w=="],++ "next/sharp/@img/sharp-libvips-linuxmusl-arm64": ["@img/[email protected]", "", { "os": "linux", "cpu": "arm64" }, "sha512-zE9EdiUzUmg5mDT5a1rk5fYJ6GWPloTwWBYDS14naqHsL+EaMpDj1AWnpLgh3u0YCORv2Tt50wrcrpYqkP97Kw=="],++ "next/sharp/@img/sharp-libvips-linuxmusl-x64": ["@img/[email protected]", "", { "os": "linux", "cpu": "x64" }, "sha512-m0lrLiUt+lBYnCFr8qV/65yMR4E/c7/wf78I5eKTdkEakFAlZ9QlzEM3QIhhAwVeUhLAHLcCq7a7Vszq/oFNZQ=="],++ "next/sharp/@img/sharp-linux-arm": ["@img/[email protected]", "", { "optionalDependencies": { "@img/sharp-libvips-linux-arm": "1.3.2" }, "os": "linux", "cpu": "arm" }, "sha512-affVWCTLooy8TSxbDx2qkzuDeaWLNVBA+P//FNBirHsXpP2fuBhk5AuboYUnrDnzoXes8GFjpTx0SBFOCRg+FA=="],++ "next/sharp/@img/sharp-linux-arm64": ["@img/[email protected]", "", { "optionalDependencies": { "@img/sharp-libvips-linux-arm64": "1.3.2" }, "os": "linux", "cpu": "arm64" }, "sha512-QgKDspHPnrU+GQ55XPhGwyhC8acLVOOSyAvo1oVfFmrIXLkDNmGWzAfDZ4xK8oSA1qBQrALcHX0G5UZni/SuFQ=="],++ "next/sharp/@img/sharp-linux-ppc64": ["@img/[email protected]", "", { "optionalDependencies": { "@img/sharp-libvips-linux-ppc64": "1.3.2" }, "os": "linux", "cpu": "ppc64" }, "sha512-sMd8rDxmpLOwv/7N44klFjOD5DUO7FLdjiXDI0hoxYaf7Ar262dQIEkosE98bps+5HPLtp/EvNqeqQtOycP/IA=="],++ "next/sharp/@img/sharp-linux-riscv64": ["@img/[email protected]", "", { "optionalDependencies": { "@img/sharp-libvips-linux-riscv64": "1.3.2" }, "os": "linux", "cpu": "none" }, "sha512-0Eob78yjlYPfL5vMNWAW55l3R9Y6BQS/gOfe0ZcP9mEz9ohhKSt4im1hayiknXgf8AWrFqMvJcKIdmLmEe7yeQ=="],++ "next/sharp/@img/sharp-linux-s390x": ["@img/[email protected]", "", { "optionalDependencies": { "@img/sharp-libvips-linux-s390x": "1.3.2" }, "os": "linux", "cpu": "s390x" }, "sha512-KgAxQ0DxpNOq1rG2t5cgTgShJFGSuU7XO45cqC+1NVOuZnP6tlgZRuSYOfNupGkHID0o3cJOsw4DVeJpMovcGw=="],++ "next/sharp/@img/sharp-linux-x64": ["@img/[email protected]", "", { "optionalDependencies": { "@img/sharp-libvips-linux-x64": "1.3.2" }, "os": "linux", "cpu": "x64" }, "sha512-8pqvxubL2PGdhlPy6GLqzDYMUjyRmKAwKHYKixpdJYBUK7PJ0C029XdsnpFIdgRZG68fZiGdHVWcKPvtiPB4cA=="],++ "next/sharp/@img/sharp-linuxmusl-arm64": ["@img/[email protected]", "", { "optionalDependencies": { "@img/sharp-libvips-linuxmusl-arm64": "1.3.2" }, "os": "linux", "cpu": "arm64" }, "sha512-Vz0iQjzzcSX3HCbfwFfCSG/9SCIqyO0mH2sXyiHaAYfBk0cRsCWXRyQYX0ovCK/PAQBbTzQ0dsPQHh5MAFL59w=="],++ "next/sharp/@img/sharp-linuxmusl-x64": ["@img/[email protected]", "", { "optionalDependencies": { "@img/sharp-libvips-linuxmusl-x64": "1.3.2" }, "os": "linux", "cpu": "x64" }, "sha512-6O1NPKcDVj9QEdg7Hx549EX8U0rp6yXQERqru6yRN7fGBn32UvIRJUlWnk+8xDCiG76hXVBbX82NZ/ZKr0euIg=="],++ "next/sharp/@img/sharp-webcontainers-wasm32": ["@img/[email protected]", "", { "dependencies": { "@img/sharp-wasm32": "0.35.3" }, "cpu": "none" }, "sha512-2rnq7bX3NzeR2T4YWgz8qiG4h3TSdMe+vN1iQXpJleSJ3SM5zQ8Fy2SyyXAWlbxpEZ2Y+Z4u1BePgJEYbSy80Q=="],++ "next/sharp/@img/sharp-win32-arm64": ["@img/[email protected]", "", { "os": "win32", "cpu": "arm64" }, "sha512-4bPwFdMbeC4JQ8L8LOyWp6nsHcboP5fxkp6iPOXz2Vg49R42TuMs2whkJ5OAP4/Ul035qOzy0AecOF9VOscn4w=="],++ "next/sharp/@img/sharp-win32-ia32": ["@img/[email protected]", "", { "os": "win32", "cpu": "ia32" }, "sha512-r53mXsBN6lFUDiST764SvgwUdHAqM4rPAiDzAmf4fLoB6X/rkfyTrLCg6+g17wJJiCmB3JYgHuUldCWUIRFSXw=="],++ "next/sharp/@img/sharp-win32-x64": ["@img/[email protected]", "", { "os": "win32", "cpu": "x64" }, "sha512-D4y1vNeZrIIJCN+uHaWVtH86B+aCrdMYYjicy9pXHvbGZeGYLLSd3wdVuC37FxVXlU1ARsk84eKWfWMXGYEqvA=="],++ "next/sharp/semver": ["[email protected]", "", { "bin": { "semver": "bin/semver.js" } }, "sha512-Y7/KDsb8LjooZpwaqGyulO6DQlksgCncchHGk+sZIY4SBvUocMBEFH5Ur1fI4dV+Jvl0w6cjvucaIi40puRioA=="],+"send/mime-types/mime-db": ["[email protected]", "", {}, "sha512-aU5EJuIN2WDemCcAp2vFBfp/m4EAhWJnUNSSw0ixs7/kXbd6Pg64EmwJkNdFhB8aWt1sH2CTXrLxo/iAGV3oPQ=="],"shadcn/@babel/parser/@babel/types": ["@babel/[email protected]", "", { "dependencies": { "@babel/helper-string-parser": "^7.27.1", "@babel/helper-validator-identifier": "^7.28.5" } }, "sha512-LwdZHpScM4Qz8Xw2iKSzS+cfglZzJGvofQICy7W7v4caru4EaAmyUuO6BGrbyQ2mYV11W0U8j5mBhd14dd3B0A=="],@@ -1999,5 +2120,9 @@"fumadocs-ui/motion/framer-motion/motion-dom": ["[email protected]", "", { "dependencies": { "motion-utils": "^12.36.0" } }, "sha512-pdkHLD8QYRp8VfiNLb8xIBJis1byQ9gPT3Jnh2jqfFtAsWUA3dEepDlsWe/xMpO8McV+VdpKVcp+E+TGJEtOoA=="],"fumadocs-ui/motion/framer-motion/motion-utils": ["[email protected]", "", {}, "sha512-eHWisygbiwVvf6PZ1vhaHCLamvkSbPIeAYxWUuL3a2PD/TROgE7FvfHWTIH4vMl798QLfMw15nRqIaRDXTlYRg=="],++ "next/sharp/@img/sharp-freebsd-wasm32/@img/sharp-wasm32": ["@img/[email protected]", "", { "dependencies": { "@emnapi/runtime": "^1.11.1" } }, "sha512-cZ0XkcYGpHZkqW6iCkqTcmUC0CD9DhD5d/qeZlZkfRBn6GnHniZXLUo5+9xw8Iv76YE6LQFN9YNBlKREcCG76w=="],++ "next/sharp/@img/sharp-webcontainers-wasm32/@img/sharp-wasm32": ["@img/[email protected]", "", { "dependencies": { "@emnapi/runtime": "^1.11.1" } }, "sha512-cZ0XkcYGpHZkqW6iCkqTcmUC0CD9DhD5d/qeZlZkfRBn6GnHniZXLUo5+9xw8Iv76YE6LQFN9YNBlKREcCG76w=="],}}diff --git a/components/docs/search-dialog.tsx b/components/docs/search-dialog.tsxnew file mode 100644index 00000000..2b435451--- /dev/null+++ b/components/docs/search-dialog.tsx@@ -0,0 +1,77 @@+"use client";++import { useOpenPanel } from "@openpanel/nextjs";+import { useDocsSearch } from "fumadocs-core/search/client";+import {+ SearchDialog,+ SearchDialogClose,+ SearchDialogContent,+ SearchDialogHeader,+ SearchDialogIcon,+ SearchDialogInput,+ SearchDialogList,+ SearchDialogOverlay,+ type SearchItemType,+ type SharedProps,+} from "fumadocs-ui/components/dialog/search";+import { useI18n } from "fumadocs-ui/contexts/i18n";+import { useEffect, useRef } from "react";+import { browserActor } from "@/lib/search/analytics-shape";+import { SearchDialogSession } from "@/lib/search/dialog-session";++/**+ * The docs search dialog: the stock fumadocs dialog, composed from the same+ * parts, plus analytics on what people search for and whether they open a+ * result (`SearchDialogSession` holds the rules).+ */+export default function DocsSearchDialog({ open, onOpenChange }: SharedProps) {+ const { locale } = useI18n();+ const { search, setSearch, query } = useDocsSearch({ type: "fetch", locale });+ const op = useOpenPanel();++ const session = useRef<SearchDialogSession | null>(null);+ if (!session.current) {+ session.current = new SearchDialogSession(+ (event, properties) => op.track(event, properties),+ typeof navigator === "undefined"+ ? "human"+ : browserActor(navigator.userAgent, navigator.webdriver === true),+ );+ }++ const results = query.data === "empty" ? null : query.data;+ // `search` runs ahead of `results` while a request is in flight, so results+ // are only attributed to a query once they are the answer to it.+ const settled = !query.isLoading && results != null;+ useEffect(() => {+ if (settled && results) session.current?.results(search, results);+ }, [settled, results, search]);++ return (+ <SearchDialog+ open={open}+ onOpenChange={(next) => {+ onOpenChange(next);+ // Selecting a result closes the dialog first and reports the+ // selection second; wait a tick so the close sees it.+ if (!next) setTimeout(() => session.current?.close(), 0);+ }}+ search={search}+ onSearchChange={setSearch}+ isLoading={query.isLoading}+ onSelect={(item: SearchItemType) => {+ if (item.type !== "action") session.current?.select(item);+ }}+ >+ <SearchDialogOverlay />+ <SearchDialogContent>+ <SearchDialogHeader>+ <SearchDialogIcon />+ <SearchDialogInput />+ <SearchDialogClose />+ </SearchDialogHeader>+ <SearchDialogList items={results} />+ </SearchDialogContent>+ </SearchDialog>+ );+}diff --git a/content/docs/ai/agent-run.mdx b/content/docs/ai/agent-run.mdxindex 99d291ec..ddd050a4 100644--- a/content/docs/ai/agent-run.mdx+++ b/content/docs/ai/agent-run.mdx@@ -14,6 +14,13 @@ avoidWhen:- "The agent is a coding CLI in a terminal — use `claude-code` or `terminal-simulator`."- "Only a code snippet should appear or change, with no chat around it — use `code-morph` or `glass-code-block`."- "A single line should type itself out with no interface around it — use `typewriter`."+askedAs:+ - "ai agent working demo"+ - "agent calling tools"+ - "I want to show an AI agent thinking, running tools, then answering"+ - "show an assistant planning steps and streaming a reply after the prompt"+ - "the moment after the user hits send where the bot does its work"+ - "viewer should see autonomous AI doing real work with a live timer"---<ComponentPreview name="agent-run" />diff --git a/content/docs/ai/chat-gpt.mdx b/content/docs/ai/chat-gpt.mdxindex f2593d65..fbb71a6e 100644--- a/content/docs/ai/chat-gpt.mdx+++ b/content/docs/ai/chat-gpt.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The product being demoed is Claude — use `claude-chat` instead to match Anthropic's UI and warm color palette."- "The product is Vercel's v0 — use `v0` instead, which replicates the v0 dark textarea and mic-to-send morph."- "The product is a CLI/terminal AI agent — use `claude-code` or `opencode` instead."+askedAs:+ - "openai chat box typing"+ - "gpt prompt input animation"+ - "I want the ChatGPT message bar typing a question then sending"+ - "announce our GPT integration with the familiar OpenAI input field"+ - "voice icon turning into send arrow in a chatbot box"+ - "opening beat where a user asks ChatGPT something"---<ComponentPreview name="chat-gpt" />diff --git a/content/docs/ai/claude-chat.mdx b/content/docs/ai/claude-chat.mdxindex 0a4f3b74..5d1f9d8e 100644--- a/content/docs/ai/claude-chat.mdx+++ b/content/docs/ai/claude-chat.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The product is Claude Code CLI — use `claude-code` instead, which shows the terminal welcome screen with `cwd` and agent context."- "The product is ChatGPT — use `chat-gpt` instead for the correct pill-input and blue accent."- "The integration is with OpenCode's TUI — use `opencode` instead."+askedAs:+ - "anthropic chat input"+ - "claude message box typing"+ - "I want the Claude chat bar typing a prompt and hitting send"+ - "show our Anthropic powered feature starting with a Claude question"+ - "waveform icon becoming a send arrow"+ - "beat where someone asks Claude for help before the answer"---<ComponentPreview name="claude-chat" />diff --git a/content/docs/ai/claude-code.mdx b/content/docs/ai/claude-code.mdxindex 1c601cc4..3812ad9b 100644--- a/content/docs/ai/claude-code.mdx+++ b/content/docs/ai/claude-code.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You need a generic, unbranded terminal — use `terminal-simulator`."- "You're depicting a different product's UI — use the matching card (`opencode`, `v0`, `chat-gpt`, `claude-chat`)."- "You only need a typed command line with a cursor and no app frame — use `typewriter` over a plain surface."+askedAs:+ - "claude code terminal"+ - "agentic CLI welcome screen"+ - "I want a terminal showing Claude Code starting up and a command typed"+ - "demo a coding agent in the command line for developers"+ - "dev tool video opening on an AI terminal prompt"+ - "the moment a developer types a task into their agent shell"---<ComponentPreview name="claude-code" />diff --git a/content/docs/ai/opencode.mdx b/content/docs/ai/opencode.mdxindex 6a9f3930..0b8e4b5c 100644--- a/content/docs/ai/opencode.mdx+++ b/content/docs/ai/opencode.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You're depicting a different product — use the matching card (`claude-code`, `v0`, `chat-gpt`, `claude-chat`)."- "You need a generic, unbranded terminal — use `terminal-simulator`."- "You only need a typed line with a cursor and no app chrome — use `typewriter`."+askedAs:+ - "opencode terminal ui"+ - "coding agent TUI typing"+ - "I want the OpenCode text interface with a query typed in"+ - "show an open source terminal coding agent starting up"+ - "dev video beat where a TUI welcome screen appears"+ - "viewer sees a developer ask the terminal agent a question"---<ComponentPreview name="opencode" />diff --git a/content/docs/ai/v0.mdx b/content/docs/ai/v0.mdxindex aa842037..e32a5391 100644--- a/content/docs/ai/v0.mdx+++ b/content/docs/ai/v0.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You're depicting a different product — use the matching card (`chat-gpt`, `claude-chat`, `claude-code`, `opencode`)."- "You need a general AI chat exchange rather than a prompt composer — use `chat-gpt` or `claude-chat`."- "You only need a typed input with a cursor and no app chrome — use `typewriter`."+askedAs:+ - "vercel v0 prompt box"+ - "generative UI composer"+ - "I want the v0 input typing a prompt and the mic becoming send"+ - "show prompt to interface tool from Vercel starting a build"+ - "opening a generate-a-UI demo with a typed request"+ - "beat where someone describes an app to v0"---<ComponentPreview name="v0" />diff --git a/content/docs/camera/cloth-reveal.mdx b/content/docs/camera/cloth-reveal.mdxindex c0c87547..c5a1b859 100644--- a/content/docs/camera/cloth-reveal.mdx+++ b/content/docs/camera/cloth-reveal.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The reveal is a move from one scene to the next rather than content under a sheet — use `page-turn`."- "A light should search the dark stage and land on the logo — use `spotlight`."- "Lines of text only need to rise into place — use `mask-reveal-up`."+askedAs:+ - "cloth pulled off reveal"+ - "silk sheet unveil"+ - "I want a fabric cover yanked away to uncover my logo"+ - "unveil the product like a launch event curtain drop"+ - "big reveal of the headline at the start of the video"+ - "moment the covered product is finally shown to the audience"---<ComponentPreview name="cloth-reveal" />diff --git a/content/docs/camera/dolly-zoom.mdx b/content/docs/camera/dolly-zoom.mdxindex 9e4f0faf..6f919fc6 100644--- a/content/docs/camera/dolly-zoom.mdx+++ b/content/docs/camera/dolly-zoom.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You need to move from one scene to the next, not a held shot — use `push-through`."- "The move should feel calm and simply show depth — use `parallax-depth`."- "The subject is a UI screen the camera should move across — use `stage`."+askedAs:+ - "vertigo shot"+ - "hitchcock zoom effect"+ - "I want a cinematic background stretch while the subject stays same size"+ - "one unsettling cinematic beat for a plot twist"+ - "the moment of realization in a story"+ - "dramatic turning point where the world warps behind the hero"---<ComponentPreview name="dolly-zoom" />diff --git a/content/docs/camera/exploded-view.mdx b/content/docs/camera/exploded-view.mdxindex ce1a1609..4abeab40 100644--- a/content/docs/camera/exploded-view.mdx+++ b/content/docs/camera/exploded-view.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The object should turn to show its front and back rather than come apart — use `turntable`."- "The scene should grow a whole city of towers from a grid — use `isometric-build`."- "The layers are numbers to compare rather than parts of one thing — use `animated-bar-chart`."+askedAs:+ - "layers pulling apart diagram"+ - "isometric stack breakdown"+ - "I want to explain an architecture layer by layer with labels"+ - "show product parts separating then snapping back together"+ - "explain the tech stack: interface, engine, storage"+ - "viewer understands what the product is made of"---<ComponentPreview name="exploded-view" />diff --git a/content/docs/camera/gravity-pile.mdx b/content/docs/camera/gravity-pile.mdxindex 18fa789f..68914a33 100644--- a/content/docs/camera/gravity-pile.mdx+++ b/content/docs/camera/gravity-pile.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The moment is a celebration that should shower the frame with color — use `confetti`."- "Icons should scatter over a cut to hide a scene change — use `icon-scatter`."- "Pieces should fly together into a logo instead of falling into a heap — use `puzzle-snap`."+askedAs:+ - "falling shapes pile up"+ - "physics objects dropping"+ - "I want shapes raining down and bouncing into a heap"+ - "show a huge amount of tasks piling up physically"+ - "a beat about volume where things stack and settle"+ - "viewer feels the weight of too many tickets or features"---<ComponentPreview name="gravity-pile" />diff --git a/content/docs/camera/impact-shake.mdx b/content/docs/camera/impact-shake.mdxindex a80fcfc5..5db3574b 100644--- a/content/docs/camera/impact-shake.mdx+++ b/content/docs/camera/impact-shake.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The landing only needs a light accent around a small element — use `trim-burst`."- "The element should fly in sideways with motion streaks — use `speed-lines`."- "The jolt should hide a cut between two scenes — use `lens-zoom`."+askedAs:+ - "slam down with screen shake"+ - "heavy hit text"+ - "I want my logo to crash down like it weighs a ton"+ - "price or launch word landing with a punch and dust"+ - "hype teaser beat that hits hard"+ - "viewer should feel a thud as the key word lands"---<ComponentPreview name="impact-shake" />diff --git a/content/docs/camera/layered-cutout.mdx b/content/docs/camera/layered-cutout.mdxindex 81937fe5..f23022d3 100644--- a/content/docs/camera/layered-cutout.mdx+++ b/content/docs/camera/layered-cutout.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You need a landscape of depth layers with a sideways truck — use `parallax-depth`."- "The effect should be a vertigo stretch, not a push through openings — use `dolly-zoom`."- "The reveal should happen on a product screenshot — use `stage`."+askedAs:+ - "paper cutout depth"+ - "papercraft logo reveal"+ - "I want a camera moving through layers of cut paper to my logo"+ - "handmade tactile brand reveal with dimension"+ - "closing frame that feels like a paper diorama"+ - "logo and tagline arriving after flying through paper sheets"---<ComponentPreview name="layered-cutout" />diff --git a/content/docs/camera/parallax-depth.mdx b/content/docs/camera/parallax-depth.mdxindex f58a81ef..f22dbcab 100644--- a/content/docs/camera/parallax-depth.mdx+++ b/content/docs/camera/parallax-depth.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The subject is a screenshot, recording or long page the camera should travel across — use `stage`."- "The subject should hold its size while the space behind it stretches — use `dolly-zoom`."- "You only need a slow push-in on an existing scene so no frame sits still — use `drift`."+askedAs:+ - "parallax landscape pan"+ - "layered scenery slow pan"+ - "I want a slow sideways camera move over layered hills"+ - "cinematic establishing shot with near layers moving faster"+ - "quiet opening beat with depth and a gentle push in"+ - "viewer settles into a calm scenic opener before the message"---<ComponentPreview name="parallax-depth" />diff --git a/content/docs/camera/tiny-planet.mdx b/content/docs/camera/tiny-planet.mdxindex f6f6f0e0..852bea77 100644--- a/content/docs/camera/tiny-planet.mdx+++ b/content/docs/camera/tiny-planet.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The city should rise out of a grid tile by tile instead of bending — use `isometric-build`."- "You want a calm cinematic landscape with depth, not a stylized planet — use `parallax-depth`."- "The background should be abstract and stay out of the way of the copy — use `shader-mesh-gradient`."+askedAs:+ - "tiny planet effect"+ - "skyline curled into a globe"+ - "I want a city skyline bending into a little round world"+ - "playful world-building beat for a community or global product"+ - "opener showing our product has a whole world around it"+ - "viewer sees a flat city wrap into a spinning planet with a red sun"---<ComponentPreview name="tiny-planet" />diff --git a/content/docs/camera/turntable.mdx b/content/docs/camera/turntable.mdxindex deb19dbd..9024cc3a 100644--- a/content/docs/camera/turntable.mdx+++ b/content/docs/camera/turntable.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The content is a long page or recording the camera should travel across — use `stage`."- "A flat word should pop out of the plane into 3D — use `extrude-pop`."- "The object should come apart into labelled layers — use `exploded-view`."+askedAs:+ - "spinning card 3D"+ - "rotating product card"+ - "I want a credit card or ticket spinning to show front edge and back"+ - "show a membership pass as a physical object from all sides"+ - "a card turning with a moving sheen and floor shadow"+ - "beat to show off a physical-looking object in 3D"---<ComponentPreview name="turntable" />diff --git a/content/docs/captions/components/caption-active-pop.mdx b/content/docs/captions/components/caption-active-pop.mdxindex f0198cd0..b757598c 100644--- a/content/docs/captions/components/caption-active-pop.mdx+++ b/content/docs/captions/components/caption-active-pop.mdx@@ -11,6 +11,13 @@ avoidWhen:- "One word should own the whole frame at a time — use `caption-word-pop`."- "The highlight has to read over busy footage from across the room — use `caption-highlight-box`."- "There is no voiceover and the text is scripted — use `word-stream`."+askedAs:+ - "subtitles current word pops"+ - "tiktok style captions"+ - "I want subtitles where the spoken word turns accent colour and bounces bigger"+ - "everyday short-form captions with the full phrase shown"+ - "talking head video needing lively highlighted words"+ - "viewer follows the voice as each word springs up in colour"---<ComponentPreview name="caption-active-pop" />diff --git a/content/docs/captions/components/caption-blur-in.mdx b/content/docs/captions/components/caption-blur-in.mdxindex 15d9ad9f..2fdf0b2f 100644--- a/content/docs/captions/components/caption-blur-in.mdx+++ b/content/docs/captions/components/caption-blur-in.mdx@@ -11,6 +11,13 @@ avoidWhen:- "The video is short-form and high-energy — use `caption-bounce-in`, which gives each word a springy hop."- "You want crisp, editorial motion with a hard edge — use `caption-rise`, which slides words up from a baseline mask."- "The viewer should be able to read the whole phrase ahead of the voice — use `caption-karaoke`, which shows the full page and fills it as it is spoken."+askedAs:+ - "blurry word reveal subtitles"+ - "soft focus captions"+ - "I want subtitles where each word sharpens out of blur as spoken"+ - "calm elegant captions for a product film"+ - "narration that should feel considered not loud"+ - "words fade into focus quietly as the narrator speaks"---<ComponentPreview name="caption-blur-in" />diff --git a/content/docs/captions/components/caption-bounce-in.mdx b/content/docs/captions/components/caption-bounce-in.mdxindex 8696966b..4ea2fdd7 100644--- a/content/docs/captions/components/caption-bounce-in.mdx+++ b/content/docs/captions/components/caption-bounce-in.mdx@@ -11,6 +11,13 @@ avoidWhen:- "The tone is calm or premium and a bounce would feel cheap — use `caption-blur-in`, which resolves each word out of focus instead."- "The video is editorial or brand-led and wants clean, confident motion — use `caption-rise`, which slides words up from a baseline mask with no overshoot."- "There is no voiceover and the words are scripted on-screen copy — use `word-stream`."+askedAs:+ - "bouncy subtitles"+ - "words hop in captions"+ - "I want each spoken word to spring in with a little overshoot"+ - "energetic subtitles that build the sentence word by word"+ - "fun short-form video with hoppy lively text"+ - "the phrase assembles itself as the voice speaks, each word bouncing"---<ComponentPreview name="caption-bounce-in" />diff --git a/content/docs/captions/components/caption-cube.mdx b/content/docs/captions/components/caption-cube.mdxindex 06d85fcc..9cedf656 100644--- a/content/docs/captions/components/caption-cube.mdx+++ b/content/docs/captions/components/caption-cube.mdx@@ -11,6 +11,13 @@ avoidWhen:- "The phrase change should be a flat roll with no depth — use `caption-slot`."- "Pages are long or need two lines — the cube turns a single line; use `caption-subtitle`."- "The viewer should see which word is being spoken — use `caption-karaoke` or `caption-active-pop`."+askedAs:+ - "3D cube subtitles"+ - "rotating phrase captions"+ - "I want each new subtitle line to flip in like a cube face"+ - "punchy social video where caption changes turn physically"+ - "previous line rotating away on a hinge as the next appears"+ - "caption change that feels like a beat in an explainer"---<ComponentPreview name="caption-cube" />diff --git a/content/docs/captions/components/caption-dim-progress.mdx b/content/docs/captions/components/caption-dim-progress.mdxindex 325360fa..ae4482e7 100644--- a/content/docs/captions/components/caption-dim-progress.mdx+++ b/content/docs/captions/components/caption-dim-progress.mdx@@ -11,6 +11,13 @@ avoidWhen:- "You want the position of the voice to feel physical, filling through each word at speaking pace — use `caption-karaoke`."- "You want a coloured marker that travels from word to word — use `caption-underline` or `caption-highlight-box`."- "The phrase should stay completely static, with no per-word change at all — use `caption-subtitle`."+askedAs:+ - "subtitles brighten as spoken"+ - "no motion captions"+ - "I want the whole line visible and each word lighting up as said"+ - "captions for tutorials that are read not watched"+ - "accessibility friendly subtitles with zero movement"+ - "viewer reads the sentence in dim text while words light up with the voice"---<ComponentPreview name="caption-dim-progress" />diff --git a/content/docs/captions/components/caption-drop.mdx b/content/docs/captions/components/caption-drop.mdxindex 5a1cf3ef..c55f7717 100644--- a/content/docs/captions/components/caption-drop.mdx+++ b/content/docs/captions/components/caption-drop.mdx@@ -11,6 +11,13 @@ avoidWhen:- "You want words to pop up from below with a small hop rather than fall from above — use `caption-bounce-in`."- "The tone is calm, premium or editorial — use `caption-blur-in` or `caption-rise`."- "There is no voiceover and the words are scripted on-screen copy — use `word-stream`."+askedAs:+ - "falling word subtitles"+ - "words drop with bounce"+ - "I want each spoken word to fall in from above and bounce"+ - "playful captions with weight that all fall away on pauses"+ - "short-form video where text lands with a thud"+ - "phrase drops out of frame when the speaker stops"---<ComponentPreview name="caption-drop" />diff --git a/content/docs/captions/components/caption-emoji.mdx b/content/docs/captions/components/caption-emoji.mdxindex 4bb299cd..34862b64 100644--- a/content/docs/captions/components/caption-emoji.mdx+++ b/content/docs/captions/components/caption-emoji.mdx@@ -11,6 +11,13 @@ avoidWhen:- "The video is a calm explainer or a product walkthrough — use `caption-subtitle`, which keeps attention on the words."- "You want the spoken word itself to stand out rather than an add-on above it — use `caption-active-pop`."- "You want the key words marked inside the line rather than decorated — use `caption-marker`."+askedAs:+ - "emoji on subtitles"+ - "caption with emoji pop"+ - "I want an emoji popping above a word when it is spoken"+ - "a few words in my video deserve an emoji punchline"+ - "social video where an emoji lands on the beat of a joke"+ - "emoji stays over the caption until the phrase leaves"---<ComponentPreview name="caption-emoji" />diff --git a/content/docs/captions/components/caption-handwrite.mdx b/content/docs/captions/components/caption-handwrite.mdxindex 9caf4810..3e26331d 100644--- a/content/docs/captions/components/caption-handwrite.mdx+++ b/content/docs/captions/components/caption-handwrite.mdx@@ -11,6 +11,13 @@ avoidWhen:- "There is no voiceover and the handwritten line is scripted on-screen copy — use `handwrite`."- "You want the reveal to read as typed rather than written — use `caption-typewriter`."- "The captions should stay plain and readable at small sizes over busy footage — use `caption-subtitle`."+askedAs:+ - "handwritten subtitles"+ - "pen written captions"+ - "I want words to be inked by hand as the person speaks"+ - "personal vlog or founder story with journal-like text"+ - "voice memo feel where each word sits at a slight angle"+ - "viewer feels the captions were scribbled in real time"---<ComponentPreview name="caption-handwrite" />diff --git a/content/docs/captions/components/caption-highlight-box.mdx b/content/docs/captions/components/caption-highlight-box.mdxindex d455db4f..8fb8be88 100644--- a/content/docs/captions/components/caption-highlight-box.mdx+++ b/content/docs/captions/components/caption-highlight-box.mdx@@ -11,6 +11,13 @@ avoidWhen:- "You want the voice's progress inside each word rather than a jump from word to word — use `caption-karaoke`."- "A solid block would fight the picture and colour alone is enough — use `caption-active-pop`."- "There is no voiceover and the text is scripted — use `word-stream`."+askedAs:+ - "moving box behind word"+ - "block highlight subtitles"+ - "I want a solid box sliding behind the word being spoken"+ - "captions that read at a glance with a bold block"+ - "short-form video with a chip jumping from word to word"+ - "viewer tracks the voice by a coloured block hopping along the line"---<ComponentPreview name="caption-highlight-box" />diff --git a/content/docs/captions/components/caption-karaoke.mdx b/content/docs/captions/components/caption-karaoke.mdxindex 075d9226..706147a8 100644--- a/content/docs/captions/components/caption-karaoke.mdx+++ b/content/docs/captions/components/caption-karaoke.mdx@@ -10,6 +10,13 @@ useWhen:avoidWhen:- "There is no voiceover and the text is scripted — use `word-stream`, which paces phrases with its own timing."- "You want letters typed out on their own clock rather than following a recording — use `typewriter`."+askedAs:+ - "karaoke subtitles"+ - "lyrics fill colour"+ - "I want each word filling with colour left to right as sung or spoken"+ - "viewer should read ahead while the colour sweeps over words"+ - "voiceover where the full line shows before the voice arrives"+ - "sing-along style highlight sweeping across the text"---<ComponentPreview name="caption-karaoke" />diff --git a/content/docs/captions/components/caption-knockout.mdx b/content/docs/captions/components/caption-knockout.mdxindex f1242363..6b993e13 100644--- a/content/docs/captions/components/caption-knockout.mdx+++ b/content/docs/captions/components/caption-knockout.mdx@@ -11,6 +11,13 @@ avoidWhen:- "The footage behind is flat or the same tone as the plate — the holes vanish; use `caption-subtitle`, whose plate carries solid text."- "The viewer should read ahead of the voice in plain type — use `caption-karaoke` or `caption-dim-progress`."- "You want a box that follows the spoken word instead of a plate behind the whole phrase — use `caption-highlight-box`."+askedAs:+ - "text cut out of a plate"+ - "see footage through letters"+ - "I want a solid plate with the words punched out showing video behind"+ - "captions that frame the footage instead of covering it"+ - "stylish cutout lettering over a worthwhile scene"+ - "letters reveal the background clip as each word is said"---<ComponentPreview name="caption-knockout" />diff --git a/content/docs/captions/components/caption-label-maker.mdx b/content/docs/captions/components/caption-label-maker.mdxindex bf310245..6735f274 100644--- a/content/docs/captions/components/caption-label-maker.mdx+++ b/content/docs/captions/components/caption-label-maker.mdx@@ -11,6 +11,13 @@ avoidWhen:- "You want typed characters with a caret and no surface behind them — use `caption-typewriter`."- "The video is clean or premium and a craft object would feel off-brand — use `caption-rise` or `caption-subtitle`."- "Pages run long — a label is one line, so keep phrases short or use `caption-subtitle`, which balances two lines."+askedAs:+ - "embossed tape captions"+ - "label maker text"+ - "I want words punched into a strip of label tape as spoken"+ - "handmade DIY video with a physical caption object"+ - "analog retro captions with tape feeding out"+ - "viewer sees a label printer typing the sentence letter by letter"---<ComponentPreview name="caption-label-maker" />diff --git a/content/docs/captions/components/caption-marker.mdx b/content/docs/captions/components/caption-marker.mdxindex 41c80c29..d512b45e 100644--- a/content/docs/captions/components/caption-marker.mdx+++ b/content/docs/captions/components/caption-marker.mdx@@ -11,6 +11,13 @@ avoidWhen:- "Every word should be marked as it is spoken, not just the keywords — use `caption-highlight-box`, whose box travels across the whole phrase."- "There is no voiceover and the highlighted line is scripted on-screen copy — use `marker-highlight`."- "You want the spoken position shown on every word without singling any out — use `caption-karaoke`."+askedAs:+ - "highlighter on key words"+ - "marker swipe subtitles"+ - "I want plain captions where only important words get highlighted"+ - "talking head where a few words carry the point"+ - "a neon highlighter swipe lands on the keyword as said"+ - "viewer sees emphasis exactly on the words that matter"---<ComponentPreview name="caption-marker" />diff --git a/content/docs/captions/components/caption-outline.mdx b/content/docs/captions/components/caption-outline.mdxindex d2950e63..698ef05c 100644--- a/content/docs/captions/components/caption-outline.mdx+++ b/content/docs/captions/components/caption-outline.mdx@@ -11,6 +11,13 @@ avoidWhen:- "The spoken word should also spring in scale — use `caption-active-pop`, the motion counterpart of this style."- "The tone is calm or editorial and a heavy outline would shout — use `caption-subtitle`."- "The marker should be a box travelling behind the spoken word rather than a colour change — use `caption-highlight-box`."+askedAs:+ - "thick outline subtitles"+ - "readable over busy footage"+ - "I want bold stroked captions that stay legible on any video"+ - "subtitles over bright fast-cut clips with no movement"+ - "only the spoken word changes colour"+ - "viewer can always read the text even on chaotic backgrounds"---<ComponentPreview name="caption-outline" />diff --git a/content/docs/captions/components/caption-prosody.mdx b/content/docs/captions/components/caption-prosody.mdxindex 1d8c464d..f94b5abf 100644--- a/content/docs/captions/components/caption-prosody.mdx+++ b/content/docs/captions/components/caption-prosody.mdx@@ -11,6 +11,13 @@ avoidWhen:- "You want to choose which word is emphasised yourself — use `caption-stack`, which enlarges the keywords you pass."- "The captions should read calmly at one size — use `caption-karaoke` or `caption-subtitle`."- "There is no voiceover and the text is scripted — use `word-stream`."+askedAs:+ - "subtitles sized by emphasis"+ - "captions show voice tone"+ - "I want word size to follow how the speaker delivers it"+ - "drawn-out words big and rushed words small"+ - "visible rhythm of speech with the sound off"+ - "how something is said matters, so slow words should look huge"---<ComponentPreview name="caption-prosody" />diff --git a/content/docs/captions/components/caption-redact.mdx b/content/docs/captions/components/caption-redact.mdxindex 741e2486..5427ce72 100644--- a/content/docs/captions/components/caption-redact.mdx+++ b/content/docs/captions/components/caption-redact.mdx@@ -11,6 +11,13 @@ avoidWhen:- "The phrase should be readable before the voice reaches it — use `caption-dim-progress`, which shows every word dimmed instead of hidden."- "Words should decode rather than uncover — use `caption-scramble`."- "Part of the picture needs hiding for privacy, not the caption — use `pixelate-region`."+askedAs:+ - "blacked out subtitles"+ - "classified document text"+ - "I want the sentence blacked out then each bar pulling away as said"+ - "true crime or investigative storytelling with withheld lines"+ - "declassified file look for a reveal"+ - "line stays hidden until the word is spoken"---<ComponentPreview name="caption-redact" />diff --git a/content/docs/captions/components/caption-rise.mdx b/content/docs/captions/components/caption-rise.mdxindex 80abff5f..632a6134 100644--- a/content/docs/captions/components/caption-rise.mdx+++ b/content/docs/captions/components/caption-rise.mdx@@ -11,6 +11,13 @@ avoidWhen:- "The video is playful short-form and wants energy — use `caption-bounce-in`."- "The tone is soft and dreamy rather than crisp — use `caption-blur-in`, which resolves each word out of focus."- "The text is a scripted title with no voiceover — use `per-word-crossfade` or `word-stream`."+askedAs:+ - "words slide up from baseline"+ - "editorial subtitles"+ - "I want each word to rise out of a mask with no bounce"+ - "brand film or interview with typeset-feeling captions"+ - "clean refined captions that never overshoot"+ - "words glide up into place like a title sequence"---<ComponentPreview name="caption-rise" />diff --git a/content/docs/captions/components/caption-scramble.mdx b/content/docs/captions/components/caption-scramble.mdxindex 909a57c4..dce141b1 100644--- a/content/docs/captions/components/caption-scramble.mdx+++ b/content/docs/captions/components/caption-scramble.mdx@@ -11,6 +11,13 @@ avoidWhen:- "The tone is calm or editorial and the glyph noise would read as a glitch — use `caption-rise` or `caption-blur-in`."- "You want characters to appear one by one in order rather than decode from noise — use `caption-typewriter`."- "The text is scripted on-screen copy with no voiceover behind it — use `word-stream`."+askedAs:+ - "decoding text subtitles"+ - "random glyphs to letters"+ - "I want each word to arrive as gibberish then decode into real letters"+ - "captions for an AI or security video with a hacker feel"+ - "terminal-style decryption of the spoken text"+ - "viewer sees words unscramble as the narrator says them"---<ComponentPreview name="caption-scramble" />diff --git a/content/docs/captions/components/caption-slice.mdx b/content/docs/captions/components/caption-slice.mdxindex b8b0582d..4d5e0ec5 100644--- a/content/docs/captions/components/caption-slice.mdx+++ b/content/docs/captions/components/caption-slice.mdx@@ -11,6 +11,13 @@ avoidWhen:- "The arrival should be soft and quiet — use `caption-blur-in`."- "Words should land with playful overshoot — use `caption-bounce-in`."- "You want a clean editorial reveal with no sideways motion — use `caption-rise`."+askedAs:+ - "split word subtitles"+ - "cut in half text reveal"+ - "I want each word to come in as two halves locking together"+ - "engineered captions for a tech product launch"+ - "top half from the left bottom half from the right"+ - "words that assemble precisely at the moment they are spoken"---<ComponentPreview name="caption-slice" />diff --git a/content/docs/captions/components/caption-slot.mdx b/content/docs/captions/components/caption-slot.mdxindex c309b948..4dc95e57 100644--- a/content/docs/captions/components/caption-slot.mdx+++ b/content/docs/captions/components/caption-slot.mdx@@ -11,6 +11,13 @@ avoidWhen:- "The viewer should see which word is being spoken — use `caption-karaoke` or `caption-active-pop`."- "Long, calm sentences that need to stay readable as a whole — use `caption-subtitle`."- "There is no voiceover and the phrases are scripted — use `word-stream`."+askedAs:+ - "one line rolling captions"+ - "slot machine subtitles"+ - "I want one short line at a time rolling up and out"+ - "fast talking head captions that keep moving with the speaker"+ - "social video where the text scrolls vertically per phrase"+ - "single-line caption replaced by the next without word effects"---<ComponentPreview name="caption-slot" />diff --git a/content/docs/captions/components/caption-speaker.mdx b/content/docs/captions/components/caption-speaker.mdxindex 70d051d2..15673934 100644--- a/content/docs/captions/components/caption-speaker.mdx+++ b/content/docs/captions/components/caption-speaker.mdx@@ -11,6 +11,13 @@ avoidWhen:- "Only one person speaks — use `caption-karaoke`, which spends the colour on the voice's progress instead."- "You want plain, neutral subtitles for an explainer — use `caption-subtitle`."- "There is no voiceover and the text is scripted — use `word-stream`."+askedAs:+ - "speaker colour subtitles"+ - "who is talking captions"+ - "I want each speaker's lines in their own colour"+ - "podcast clip or interview where viewers know who speaks"+ - "two-person dialogue that reads like a script"+ - "viewer identifies the speaker without name labels"---<ComponentPreview name="caption-speaker" />diff --git a/content/docs/captions/components/caption-split-flap.mdx b/content/docs/captions/components/caption-split-flap.mdxindex 12aa34c4..bb2c6c1e 100644--- a/content/docs/captions/components/caption-split-flap.mdx+++ b/content/docs/captions/components/caption-split-flap.mdx@@ -11,6 +11,13 @@ avoidWhen:- "You want letters to decode in place without tiles or a board look — use `caption-scramble`."- "The captions sit over a busy talking head for a long video and should stay quiet — use `caption-subtitle`."- "The text is scripted on-screen copy with no voiceover — use `typewriter` or `word-stream`."+askedAs:+ - "departure board subtitles"+ - "flip tile letters text"+ - "I want every letter clattering on a flap before landing"+ - "airport style mechanical captions for a travel or tech video"+ - "announcement board feel for spoken words"+ - "letters shuffle through characters then settle as the word is said"---<ComponentPreview name="caption-split-flap" />diff --git a/content/docs/captions/components/caption-stack.mdx b/content/docs/captions/components/caption-stack.mdxindex ad5717f6..86181490 100644--- a/content/docs/captions/components/caption-stack.mdx+++ b/content/docs/captions/components/caption-stack.mdx@@ -11,6 +11,13 @@ avoidWhen:- "The voice should be followed one word at a time in the middle of the frame — use `caption-word-pop`."- "Captions must sit quietly in the bottom third and never grow taller than a line or two — use `caption-subtitle`."- "Every word should arrive the same way with no hierarchy — use `caption-bounce-in`, which builds a single line in place."+askedAs:+ - "kinetic typography captions"+ - "stacked words per line"+ - "I want captions stacked a couple of words per line with a big keyword"+ - "short-form video where subtitles are part of the design"+ - "each caption page reading like a mini poster"+ - "key word of every phrase set large on its own line"---<ComponentPreview name="caption-stack" />diff --git a/content/docs/captions/components/caption-stamp.mdx b/content/docs/captions/components/caption-stamp.mdxindex 7ecf00f4..f0999625 100644--- a/content/docs/captions/components/caption-stamp.mdx+++ b/content/docs/captions/components/caption-stamp.mdx@@ -11,6 +11,13 @@ avoidWhen:- "The emphasis should feel drawn rather than struck — use `caption-marker`, which swipes a highlighter behind the keyword."- "Every word should get the accent as it is spoken, not one per phrase — use `caption-active-pop`."- "The keyword should grow out of the layout instead of landing on top of it — use `caption-stack`."+askedAs:+ - "rubber stamp words"+ - "stamped subtitles"+ - "I want important words to slam down like an ink stamp"+ - "punchy reaction video with one impactful word per phrase"+ - "plain captions plus a stamp hit on emphasis"+ - "viewer feels a thump as the key word is stamped on screen"---<ComponentPreview name="caption-stamp" />diff --git a/content/docs/captions/components/caption-subtitle.mdx b/content/docs/captions/components/caption-subtitle.mdxindex d6d48ad9..22e052e3 100644--- a/content/docs/captions/components/caption-subtitle.mdx+++ b/content/docs/captions/components/caption-subtitle.mdx@@ -11,6 +11,13 @@ avoidWhen:- "Short-form social video that needs the caption to carry energy — use `caption-karaoke` or `caption-active-pop`."- "One short line at a time that keeps moving with the speaker — use `caption-slot`."- "On-screen copy with no voiceover — use `word-stream`."+askedAs:+ - "classic subtitles"+ - "plain subtitle bar"+ - "I want standard broadcast subtitles on a translucent plate"+ - "interview captions to be read and not watched"+ - "simple whole-phrase text with no word animation"+ - "accessibility captions that stay calm and unobtrusive"---<ComponentPreview name="caption-subtitle" />diff --git a/content/docs/captions/components/caption-teleprompter.mdx b/content/docs/captions/components/caption-teleprompter.mdxindex 5bfd55ff..8d9b82bb 100644--- a/content/docs/captions/components/caption-teleprompter.mdx+++ b/content/docs/captions/components/caption-teleprompter.mdx@@ -11,6 +11,13 @@ avoidWhen:- "You want one phrase at a time that replaces the last — use `caption-subtitle` for broadcast-style pages or `caption-slot` for a one-line roll."- "The captions should feel energetic and social — use `caption-karaoke` or `caption-highlight-box`."- "There is no voiceover and the text is scripted — use `word-stream`."+askedAs:+ - "scrolling transcript"+ - "teleprompter text"+ - "I want the full transcript scrolling with the current line centred"+ - "long continuous narration where viewers read along"+ - "past lines fade above and next line waits below"+ - "talk or walkthrough with a smooth reading window"---<ComponentPreview name="caption-teleprompter" />diff --git a/content/docs/captions/components/caption-timeline.mdx b/content/docs/captions/components/caption-timeline.mdxindex 1a9dc018..2b42d534 100644--- a/content/docs/captions/components/caption-timeline.mdx+++ b/content/docs/captions/components/caption-timeline.mdx@@ -11,6 +11,13 @@ avoidWhen:- "The captions need to be read comfortably for a long time — a moving strip is harder to follow; use `caption-subtitle` or `caption-teleprompter`."- "You want one short phrase at a time rather than a continuous strip — use `caption-karaoke` or `caption-slot`."- "There is no voiceover and the text is scripted — use `word-stream`."+askedAs:+ - "transcript on a time strip"+ - "audio waveform style captions"+ - "I want words on a scrolling timeline under a fixed playhead"+ - "podcast or voice tool video where pauses show as gaps"+ - "editing software feel for the spoken words"+ - "viewer sees the timing of speech as spacing on a strip"---<ComponentPreview name="caption-timeline" />diff --git a/content/docs/captions/components/caption-typewriter.mdx b/content/docs/captions/components/caption-typewriter.mdxindex f50dd022..41544749 100644--- a/content/docs/captions/components/caption-typewriter.mdx+++ b/content/docs/captions/components/caption-typewriter.mdx@@ -11,6 +11,13 @@ avoidWhen:- "The text is scripted on-screen copy with no recording behind it — use `typewriter`, which types on its own clock."- "The viewer should be able to read ahead of the voice — use `caption-karaoke`, which shows the whole phrase and fills it as it is spoken."- "The video needs calm, broadcast-style subtitles — use `caption-subtitle`."+askedAs:+ - "typing subtitles"+ - "typed out words with caret"+ - "I want each word typed letter by letter with a blinking cursor"+ - "voiceover walking through a terminal or code editor"+ - "captions that feel like someone typing live"+ - "caret blinks while the speaker pauses"---<ComponentPreview name="caption-typewriter" />diff --git a/content/docs/captions/components/caption-underline.mdx b/content/docs/captions/components/caption-underline.mdxindex 14d5bb0c..e0231a99 100644--- a/content/docs/captions/components/caption-underline.mdx+++ b/content/docs/captions/components/caption-underline.mdx@@ -11,6 +11,13 @@ avoidWhen:- "You want the active word itself to be loud, on a solid plate that travels with the voice — use `caption-highlight-box`."- "You want no moving mark at all, just upcoming words dimmed until they are spoken — use `caption-dim-progress`."- "Only chosen keywords should get a mark, drawn on as they are said — use `caption-marker`."+askedAs:+ - "underline follows speech"+ - "sliding bar under word"+ - "I want a bar sliding under the word being spoken"+ - "lightest possible marker of where the voice is"+ - "text keeps its colour and only a line travels"+ - "clean minimal captions that track the speaker with a line"---<ComponentPreview name="caption-underline" />diff --git a/content/docs/captions/components/caption-weight.mdx b/content/docs/captions/components/caption-weight.mdxindex 33f5fc04..bf36e30e 100644--- a/content/docs/captions/components/caption-weight.mdx+++ b/content/docs/captions/components/caption-weight.mdx@@ -11,6 +11,13 @@ avoidWhen:- "You need emphasis that reads at a glance on small vertical screens — use `caption-active-pop`, which adds colour and scale."- "The font has only one or two static weights — the ramp will step. Use `caption-karaoke`, which works with any font."- "There is no voiceover and the text is scripted — use `word-stream`."+askedAs:+ - "font weight subtitles"+ - "bold swell word"+ - "I want the spoken word to get heavier and then relax"+ - "captions that follow the voice with typography only"+ - "no colour or box, just weight changing with speech"+ - "viewer sees the current word thicken without layout jump"---<ComponentPreview name="caption-weight" />diff --git a/content/docs/captions/components/caption-word-pop.mdx b/content/docs/captions/components/caption-word-pop.mdxindex c5cb9a8a..aca233b0 100644--- a/content/docs/captions/components/caption-word-pop.mdx+++ b/content/docs/captions/components/caption-word-pop.mdx@@ -11,6 +11,13 @@ avoidWhen:- "The viewer needs to read ahead of the voice — use `caption-karaoke`, which keeps the whole phrase on screen."- "Long or reading-heavy content such as explainers and interviews — use `caption-subtitle`."- "Punchy scripted words with no recording behind them — use `zoom-words`."+askedAs:+ - "one big word at a time"+ - "single word subtitles"+ - "I want one huge word centred popping in as it is spoken"+ - "punchy short-form talking head where every word hits"+ - "frame filled by the current word on a spring"+ - "fast pacing subtitles with one word on screen at once"---<ComponentPreview name="caption-word-pop" />diff --git a/content/docs/compositions/ecosystem-constellation.mdx b/content/docs/compositions/ecosystem-constellation.mdxindex 54cc6e53..1fdc8910 100644--- a/content/docs/compositions/ecosystem-constellation.mdx+++ b/content/docs/compositions/ecosystem-constellation.mdx@@ -11,6 +11,13 @@ useWhen:avoidWhen:- "You need your own integration logos; the eight marks are hardcoded in the file, so swapping them means editing the copied component."- "You just want a set of brand chips to arrive and hold with no orbit; `logo-enter` springs a stacked group in one-by-one."+askedAs:+ - "integrations orbiting logo"+ - "hub and satellites"+ - "I want our product in the centre with integration logos orbiting"+ - "show we connect with every tool"+ - "pulsing lines linking a core to many partners"+ - "viewer gets the message: we plug into everything"---<ComponentPreview name="ecosystem-constellation" />diff --git a/content/docs/compositions/infinite-bento-pan.mdx b/content/docs/compositions/infinite-bento-pan.mdxindex 50d00d49..7e98bc20 100644--- a/content/docs/compositions/infinite-bento-pan.mdx+++ b/content/docs/compositions/infinite-bento-pan.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The figures on screen have to mean something — every counter, stat and chart here is sine-driven filler, so use `animated-line-chart` or `animated-bar-chart` for a number the viewer should actually read."- "You need the camera to slow down, hold, or land on one specific card; the pan is a single linear diagonal with no easing and no dwell."- "You want a horizontal loop rather than a camera over a grid; `infinite-marquee` and `perspective-marquee` scroll a strip seamlessly instead."+askedAs:+ - "bento grid camera glide"+ - "endless card grid pan"+ - "I want a slow diagonal pan across a huge grid of cards"+ - "ambient establishing shot that says a lot is happening"+ - "background beat of many features without reading each"+ - "viewer senses a rich product with plenty of features"---<ComponentPreview name="infinite-bento-pan" />diff --git a/content/docs/compositions/live-code-compilation.mdx b/content/docs/compositions/live-code-compilation.mdxindex 7d96ca7d..ab9fc869 100644--- a/content/docs/compositions/live-code-compilation.mdx+++ b/content/docs/compositions/live-code-compilation.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The code on screen has to be yours — the eight typed fragments and the resulting button are hardcoded, while `glass-code-block` and `glass-code-walk` take arbitrary code as a `code` prop."- "The shot is about commands and their output rather than an editor next to a preview; `terminal-simulator` types commands and rolls older lines off the top."- "The split should read as a conversation driving the result; `chat-to-preview-layout` shrinks a chat column while the preview column expands."+askedAs:+ - "code to UI split screen"+ - "typing code live preview"+ - "I want code typing on the left and the UI updating on the right"+ - "show cause and effect for developers"+ - "a style prop finishing and the interface snapping to match"+ - "developer audience sees instant result of the code"---<ComponentPreview name="live-code-compilation" />diff --git a/content/docs/effects/confetti.mdx b/content/docs/effects/confetti.mdxindex 7911fc02..3502cc54 100644--- a/content/docs/effects/confetti.mdx+++ b/content/docs/effects/confetti.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The video has a clean, minimal, or corporate tone — confetti reads as celebration-specific and breaks professional pacing; use a subtle shader backdrop like `shader-grain-gradient` instead."- "You need a looping ambient particle background — confetti is a one-shot burst with gravity falloff, not a loop; use `shader-dot-orbit` for sustained motion."- "The burst should originate from a specific UI element offscreen — `originX`/`originY` are normalized 0–1 to the frame, not element-relative; compose with `AbsoluteFill` positioning instead."+askedAs:+ - "confetti burst"+ - "celebration particles"+ - "I want confetti exploding for a launch"+ - "success screen needs a celebratory payoff"+ - "milestone or plan completed beat"+ - "viewer should feel party mood when the goal is reached"---<ComponentPreview name="confetti" />diff --git a/content/docs/effects/crumple-toss.mdx b/content/docs/effects/crumple-toss.mdxindex 8485f588..10a28581 100644--- a/content/docs/effects/crumple-toss.mdx+++ b/content/docs/effects/crumple-toss.mdx@@ -11,6 +11,13 @@ avoidWhen:- "You want a general element exit in a clean UI scene — this one is loud and physical; use a fade instead."- "You need a scene-level exit that replaces the whole frame — that is `page-turn`. This is **not** a `TransitionPresentation` and does not belong in a `<TransitionSeries>`."- "You want the ball to land, bounce, or hit a wastebasket; none of that is here."+askedAs:+ - "crumple paper and throw"+ - "trash it animation"+ - "I want an element crushed into a paper ball and tossed out"+ - "discard the old plan or wrong answer on screen"+ - "before and after story where the old way gets binned"+ - "viewer sees the previous version thrown away"---<ComponentPreview name="crumple-toss" />diff --git a/content/docs/effects/cursor-gravity.mdx b/content/docs/effects/cursor-gravity.mdxindex dde9afb0..bd755890 100644--- a/content/docs/effects/cursor-gravity.mdx+++ b/content/docs/effects/cursor-gravity.mdx@@ -10,6 +10,13 @@ useWhen:avoidWhen:- "A cursor must accurately demonstrate an existing interface — use simulated-cursor."- "Two complete scenes need to swap — this reveals one element rather than replacing the whole frame."+askedAs:+ - "cursor pulls button"+ - "button dragged from edge"+ - "I want a cursor tugging a button onto the screen with elastic resistance"+ - "empty scene revealing the call to action by pulling it in"+ - "button entrance driven by a physical tug"+ - "viewer watches the CTA get pulled into frame"---<ComponentPreview name="cursor-gravity" />diff --git a/content/docs/effects/glass-lens.mdx b/content/docs/effects/glass-lens.mdxindex 093baca2..3a872a68 100644--- a/content/docs/effects/glass-lens.mdx+++ b/content/docs/effects/glass-lens.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You only need the magnified word in a headline — use `glass-capsule`."- "You want a product screen revealed with a hairline of light, not a lens — use `slit-reveal`."- "You need a longer walk through several regions of a screenshot — use `screenshot-tour`."+askedAs:+ - "magnifying glass headline"+ - "lens drop to button"+ - "I want a glass lens magnifying a word then turning into a button"+ - "launch video moving from headline to product to CTA smoothly"+ - "one continuous move ending on a call to action pill"+ - "viewer follows a lens from the title to the signup"---<ComponentPreview name="glass-lens" />diff --git a/content/docs/effects/ink-arrow.mdx b/content/docs/effects/ink-arrow.mdxindex cc9133fc..6e210116 100644--- a/content/docs/effects/ink-arrow.mdx+++ b/content/docs/effects/ink-arrow.mdx@@ -10,6 +10,13 @@ useWhen:avoidWhen:- "You need a straight technical connector or a diagram edge — this is a wobbly pen line with a personality, not a flowchart arrow."- "The arrow must anchor itself to another component's live position: `from`/`to` are fixed coordinates you supply."+askedAs:+ - "hand drawn arrow"+ - "self drawing arrow annotation"+ - "I want a sketchy arrow drawing itself from one thing to another"+ - "callout over a scrapbook or paper scene"+ - "stop-motion style pointer between two items"+ - "viewer's eye is guided by a doodled arrow"---<ComponentPreview name="ink-arrow" />diff --git a/content/docs/effects/keystroke.mdx b/content/docs/effects/keystroke.mdxindex da79fe99..1657cc24 100644--- a/content/docs/effects/keystroke.mdx+++ b/content/docs/effects/keystroke.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The interaction is pointing and clicking rather than pressing shortcuts — use `simulated-cursor`."- "The viewer should read text being typed into a field or a terminal, not individual shortcuts — use `typewriter`."- "The shortcut only needs to appear as a static hint next to a menu item — use `command-menu`."+askedAs:+ - "keyboard shortcut overlay"+ - "keycap press animation"+ - "I want keycaps pressing in order to show a shortcut"+ - "keyboard-first product demo like a command palette"+ - "show cmd plus K style key combos"+ - "viewer learns which keys to hit"---<ComponentPreview name="keystroke" />diff --git a/content/docs/effects/paper-wobble.mdx b/content/docs/effects/paper-wobble.mdxindex c62c07a6..d78455a2 100644--- a/content/docs/effects/paper-wobble.mdx+++ b/content/docs/effects/paper-wobble.mdx@@ -11,6 +11,13 @@ avoidWhen:- "The content should sit rock-still — UI simulations, code blocks being read."- "You want smooth floating motion rather than discrete poses — use `drift`."- "The component already jitters itself, like `paper-sticker`; wrapping it just doubles the shake."+askedAs:+ - "stop motion jitter"+ - "hand placed wobble"+ - "I want any card or headline to jitter like stop motion on a desk"+ - "handmade reshoot feel for content"+ - "subtle frame-by-frame shake that looks hand-placed"+ - "viewer feels the scene was animated with paper by hand"---<ComponentPreview name="paper-wobble" />diff --git a/content/docs/effects/radial-burst.mdx b/content/docs/effects/radial-burst.mdxindex 91a50d22..8a91b12a 100644--- a/content/docs/effects/radial-burst.mdx+++ b/content/docs/effects/radial-burst.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The effect should celebrate an action with scattered particles — use `confetti`."- "Two complete scenes need a camera move through concentric rings — use `ripple-zoom`."- "The introduction should be driven by editable words — use `kinetic-morph-text`."+askedAs:+ - "twisting ribbons ring"+ - "abstract geometric opener"+ - "I want ribbons twisting into a ring that sweeps outward"+ - "short abstract motion-design intro before the title"+ - "contour echo burst for a product introduction"+ - "viewer gets a sculptural opening flourish"---<ComponentPreview name="radial-burst" />diff --git a/content/docs/effects/scribble-circle.mdx b/content/docs/effects/scribble-circle.mdxindex 57d15f57..b92bb2ca 100644--- a/content/docs/effects/scribble-circle.mdx+++ b/content/docs/effects/scribble-circle.mdx@@ -11,6 +11,13 @@ avoidWhen:- "You need a permanent border or a focus ring. This is a gesture that happens once, not a state."- "You want a rectangular or bracket-shaped annotation, or to cross something out."- "The target's size is not known at author time — this component cannot measure it."+askedAs:+ - "circle the important thing"+ - "hand drawn circle highlight"+ - "I want a brush circle drawn around a button or number"+ - "draw attention to one row in a screenshot"+ - "thin start thick finish marker ring"+ - "viewer's eye lands on the circled detail"---<ComponentPreview name="scribble-circle" />diff --git a/content/docs/effects/simulated-cursor.mdx b/content/docs/effects/simulated-cursor.mdxindex 3692d722..9b221e9f 100644--- a/content/docs/effects/simulated-cursor.mdx+++ b/content/docs/effects/simulated-cursor.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You need a real screen recording — this draws a synthetic overlay, not a capture of actual mouse movement"- "The video is abstract or non-UI (motion graphics, product reveal, pure text) — a floating arrow reads as a tutorial and breaks the mood"- "The underlying layout shifts between scenes — waypoints are absolute canvas pixels, so the cursor will land in the wrong place"+askedAs:+ - "fake mouse pointer"+ - "cursor moves and clicks"+ - "I want a mouse cursor travelling across the UI and clicking"+ - "narrating a screen demo with a predictable pointer"+ - "click ripple on a button in a walkthrough"+ - "viewer follows the pointer through the interface steps"---<ComponentPreview name="simulated-cursor" />diff --git a/content/docs/effects/tv-power-off.mdx b/content/docs/effects/tv-power-off.mdxindex 365554bc..9b10ce8e 100644--- a/content/docs/effects/tv-power-off.mdx+++ b/content/docs/effects/tv-power-off.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The tube look should hold for the whole scene instead of ending it — use `crt-screen`, which is a sustained filter with no duration of its own."- "Both scenes should be visible while the change happens — this plays over one scene at a time, so reach for a transition such as `glitch-cut`."- "The frame has to stay transparent over a backdrop once the scene is gone, since what this leaves behind is opaque black."+askedAs:+ - "old TV shutting off"+ - "screen collapses to a dot"+ - "I want the picture shrinking to a line then a dot like a CRT"+ - "end a scene like a device switched off instead of fading"+ - "final black after a retro tube powers down"+ - "viewer sees the screen die with a glowing dot"---<ComponentPreview name="tv-power-off" />diff --git a/content/docs/filters/components/ascii-render.mdx b/content/docs/filters/components/ascii-render.mdxindex ced67321..531b3501 100644--- a/content/docs/filters/components/ascii-render.mdx+++ b/content/docs/filters/components/ascii-render.mdx@@ -13,6 +13,13 @@ avoidWhen:- "The ASCII should only cover the cut between two scenes — use `ascii-dissolve`."- "You want cascading code rain as a motif rather than the scene itself turned into characters — use `matrix-decode`."- "The scene carries fine detail or small type that has to stay readable, since a glyph cell throws away everything inside it but its average brightness."+askedAs:+ - "scene as text characters"+ - "ASCII art filter"+ - "I want my UI to resolve out of letters and symbols"+ - "text-mode look that tracks the moving picture"+ - "hacker aesthetic where the scene is made of characters"+ - "viewer watches the image materialise from ASCII"---<ComponentPreview name="ascii-render" />diff --git a/content/docs/filters/components/camera-lens.mdx b/content/docs/filters/components/camera-lens.mdxindex c15bca1f..95cae0c8 100644--- a/content/docs/filters/components/camera-lens.mdx+++ b/content/docs/filters/components/camera-lens.mdx@@ -13,6 +13,13 @@ avoidWhen:- "The story is a worn signal rather than the optics carrying it — use `vhs-filter`."- "The story is the recorder the shot was written to rather than the glass it came through — use `security-cam`."- "You want a band of the frame sharp and the rest thrown out — that is depth of field, not lens character."+askedAs:+ - "filmed look filter"+ - "lens bloom and fringe"+ - "I want my screen recording to look shot through a real camera"+ - "stop the screencast looking sterile"+ - "glow on highlights with softer corners"+ - "viewer perceives real optics rather than a flat render"---<ComponentPreview name="camera-lens" />diff --git a/content/docs/filters/components/crt-screen.mdx b/content/docs/filters/components/crt-screen.mdxindex 06b0e7af..f874b4d0 100644--- a/content/docs/filters/components/crt-screen.mdx+++ b/content/docs/filters/components/crt-screen.mdx@@ -14,6 +14,13 @@ avoidWhen:- "The image should stand in the air as light rather than sit on a physical surface — use `hologram`."- "The tube should die rather than run — use `tv-power-off`, which collapses the picture into a line and a phosphor dot over a set number of frames instead of holding a look."- "Content sits close to the frame edge, since the barrel warp pushes the corners past the picture and they fall into the rim."+askedAs:+ - "old monitor effect"+ - "curved tube scanlines"+ - "I want the scene on a curved CRT with scanlines"+ - "retro terminal or arcade look"+ - "barrel distortion and phosphor glow filter"+ - "viewer feels it is a vintage display"---<ComponentPreview name="crt-screen" />diff --git a/content/docs/filters/components/halftone-print.mdx b/content/docs/filters/components/halftone-print.mdxindex 05ef4535..4df95763 100644--- a/content/docs/filters/components/halftone-print.mdx+++ b/content/docs/filters/components/halftone-print.mdx@@ -13,6 +13,13 @@ avoidWhen:- "Only one element should feel papery while the rest of the scene stays clean — use `paper-sticker` or `paper-wobble`."- "The scene is dark, since almost every cell saturates to full ink and the screen disappears into a solid field."- "Small type has to stay readable — a dot screen throws away everything inside a cell but its colour."+askedAs:+ - "dot print effect"+ - "newspaper dots filter"+ - "I want the scene printed with coloured halftone dots slightly misregistered"+ - "zine style intro looking printed on paper"+ - "riso poster flavour on live footage"+ - "viewer sees ink dots rather than pixels"---<ComponentPreview name="halftone-print" />diff --git a/content/docs/filters/components/hologram.mdx b/content/docs/filters/components/hologram.mdxindex c5286da1..44e69b74 100644--- a/content/docs/filters/components/hologram.mdx+++ b/content/docs/filters/components/hologram.mdx@@ -11,6 +11,13 @@ useWhen:avoidWhen:- "The story is a physical display being watched rather than light standing in the air — use `crt-screen`."- "You want damage rather than projection — use `sustained-glitch`."+askedAs:+ - "hologram projection effect"+ - "sci-fi ghost image"+ - "I want the scene to look like a floating projection with scan lines"+ - "futuristic reveal of a feature as hologram"+ - "double ghost and emission lines over bright parts"+ - "viewer thinks of a her-style projected interface"---<ComponentPreview name="hologram" />diff --git a/content/docs/filters/components/pixelate-region.mdx b/content/docs/filters/components/pixelate-region.mdxindex 67c9a964..28069c4d 100644--- a/content/docs/filters/components/pixelate-region.mdx+++ b/content/docs/filters/components/pixelate-region.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The whole frame wants a treatment rather than a covered rectangle — `vhs-filter` and `crt-screen` work edge to edge."- "What you are covering moves around the frame, since a region is a fixed rectangle and will slide off whatever it was over."- "You only want to de-emphasise something — a mosaic dense enough to redact is not a soft focus, and a soft focus is not a redaction."+askedAs:+ - "blur sensitive info"+ - "hide api keys mosaic"+ - "I want to pixelate emails and tokens in my demo"+ - "cover private data in a screen recording with a mosaic"+ - "redact only some rectangles and leave the rest"+ - "viewer cannot read secrets but sees the rest of the UI"---<ComponentPreview name="pixelate-region" />diff --git a/content/docs/filters/components/security-cam.mdx b/content/docs/filters/components/security-cam.mdxindex 214fdfd4..c41ce098 100644--- a/content/docs/filters/components/security-cam.mdx+++ b/content/docs/filters/components/security-cam.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The story is the glass a shot was taken through rather than the recorder it was written to — use `camera-lens`."- "The story is a tube being watched — use `crt-screen`, which is a display rather than a codec."- "You want analog wear — tape smears colour sideways along the scanline; this quantizes it into blocks, which is a different century."+askedAs:+ - "cctv footage look"+ - "surveillance camera filter"+ - "I want the scene to look like cheap security camera video"+ - "meanwhile in production aside with grainy footage"+ - "compression blocks and crushed blacks"+ - "cold open that feels like watched footage"---<ComponentPreview name="security-cam" />diff --git a/content/docs/filters/components/sustained-glitch.mdx b/content/docs/filters/components/sustained-glitch.mdxindex 5b4dcf83..af5f9ad9 100644--- a/content/docs/filters/components/sustained-glitch.mdx+++ b/content/docs/filters/components/sustained-glitch.mdx@@ -13,6 +13,13 @@ avoidWhen:- "Only a headline should break up while the scene behind it stays intact — use `rgb-glitch-text`."- "You want continuous analog wear rather than intermittent digital faults — use `vhs-filter`."- "The instability should read as a projection struggling to hold rather than as damage — use `hologram`."+askedAs:+ - "glitch bursts"+ - "digital corruption effect"+ - "I want periodic glitch spikes that settle clean between"+ - "tech scene feeling unstable throughout"+ - "broadcast corruption on a developer video"+ - "viewer senses a system under strain but still readable"---<ComponentPreview name="sustained-glitch" />diff --git a/content/docs/filters/components/underwater-ripple.mdx b/content/docs/filters/components/underwater-ripple.mdxindex 198c6654..6863f8f6 100644--- a/content/docs/filters/components/underwater-ripple.mdx+++ b/content/docs/filters/components/underwater-ripple.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The water should be its own layer rather than something the scene is seen through — use `shader-caustics` behind a crisp scene."- "The scene carries small type that has to stay legible, since refraction bends every edge it touches."- "You want a single travelling wave rather than a field that moves everywhere at once — nothing here sweeps."+askedAs:+ - "underwater distortion"+ - "water refraction filter"+ - "I want the scene seen through moving water"+ - "calm premium hero loop with ripples"+ - "ambient backdrop with gentle watery wobble"+ - "viewer feels submerged and relaxed"---<ComponentPreview name="underwater-ripple" />diff --git a/content/docs/filters/components/vhs-filter.mdx b/content/docs/filters/components/vhs-filter.mdxindex c5e8c834..db8171d8 100644--- a/content/docs/filters/components/vhs-filter.mdx+++ b/content/docs/filters/components/vhs-filter.mdx@@ -13,6 +13,13 @@ avoidWhen:- "Only a headline should break up while the scene behind it stays clean — use `rgb-glitch-text`."- "The story is the display the scene sits on or the glass it was shot through, rather than the signal reaching it — use `crt-screen` or `camera-lens`."- "You want intermittent digital faults rather than continuous analog wear — use `sustained-glitch`."+askedAs:+ - "vhs tape look"+ - "retro camcorder effect"+ - "I want the scene to look like old tape with colour bleed"+ - "retro product spot with analog noise"+ - "recovered footage with a tracking tear"+ - "viewer feels nostalgia of an old video tape"---<ComponentPreview name="vhs-filter" />diff --git a/content/docs/getting-started/mcp-server.mdx b/content/docs/getting-started/mcp-server.mdxindex 1ad9d430..bffeba96 100644--- a/content/docs/getting-started/mcp-server.mdx+++ b/content/docs/getting-started/mcp-server.mdx@@ -50,6 +50,10 @@ session looks like this:| `plan_video` | `brief` (required). Optional: `archetype` (`product-demo`, `changelog`, `feature-announcement`, `oss-showcase`, `cli-tool-demo`, `testimonial-reel`, `year-in-review`, `pricing-reveal` or `logo-bumper`), `durationSeconds` (up to 600) | A storyboard: the archetype and why it was picked, beats with frame ranges and component options, transitions, one install command for the suggested picks, and the archetype's full recipe || `preview_component` | `name` (required). Optional: `props`, merged over the component's demo defaults | A live preview link with length, frame rate and size, plus docs URL and install command. In clients that support MCP Apps, the preview plays in the chat |+`search_components` matches by meaning as well as by words, so `query` can be a name+(`typewriter`), a couple of keywords, or the need itself in any language+(`show that setup takes five minutes`).+When a name doesn't match, `get_component` and `preview_component` answer with the closestcomponent names instead of an empty result.diff --git a/content/docs/graphic-looks/blueprint.mdx b/content/docs/graphic-looks/blueprint.mdxindex f58bd69b..c2736c0d 100644--- a/content/docs/graphic-looks/blueprint.mdx+++ b/content/docs/graphic-looks/blueprint.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The product should come apart into labelled layers instead of being measured — use `exploded-view`."- "The reveal should show what is inside the device rather than its outline — use `x-ray-scan`."- "The subject is a word whose outlines should draw themselves — use `outline-trace`."+askedAs:+ - "technical drawing reveal"+ - "engineering schematic look"+ - "I want the product turning into a blueprint with dimension lines"+ - "hardware launch showing measured labelled drawing"+ - "white linework on blue grid with a red callout"+ - "viewer sees the precise engineering behind the object"---<ComponentPreview name="blueprint" />diff --git a/content/docs/graphic-looks/brick-mosaic.mdx b/content/docs/graphic-looks/brick-mosaic.mdxindex 630bf454..fce852c8 100644--- a/content/docs/graphic-looks/brick-mosaic.mdx+++ b/content/docs/graphic-looks/brick-mosaic.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The mark should assemble from a few geometric pieces that spin and snap into place — use `puzzle-snap`."- "The build should rise as an isometric 3D city rather than a flat mosaic — use `isometric-build`."- "The scene should melt into pixel streaks as a transition — use `pixel-sort`."+askedAs:+ - "toy brick logo"+ - "lego style pixel art"+ - "I want my logo built from toy bricks row by row"+ - "playful reveal of an icon assembled on a baseplate"+ - "bricks dropping and bouncing into an image"+ - "viewer enjoys a building-blocks reveal"---<ComponentPreview name="brick-mosaic" />diff --git a/content/docs/graphic-looks/comic-panels.mdx b/content/docs/graphic-looks/comic-panels.mdxindex 0dab6dab..3c56c0b3 100644--- a/content/docs/graphic-looks/comic-panels.mdx+++ b/content/docs/graphic-looks/comic-panels.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You only need the manga-style impact lines around an element, without the page — use `speed-lines`."- "The hit should be a heavy slam with a camera jolt rather than a page cracking — use `impact-shake`."- "The burst should be a sculptural ribbon opener rather than a printed comic page — use `radial-burst`."+askedAs:+ - "comic book page"+ - "pow burst panel"+ - "I want the frame splitting into comic panels with speed lines"+ - "logo landing with comic-book energy"+ - "halftone comic style then a full-frame POW"+ - "viewer feels a superhero action moment"---<ComponentPreview name="comic-panels" />diff --git a/content/docs/graphic-looks/duotone-beat.mdx b/content/docs/graphic-looks/duotone-beat.mdxindex 0ae0959f..51ba87ae 100644--- a/content/docs/graphic-looks/duotone-beat.mdx+++ b/content/docs/graphic-looks/duotone-beat.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The print look should hold steady on a live scene with full color separation — use `halftone-print`."- "The image should print once and settle, without a beat — use `riso-print`."- "The beat should drive a camera jolt on heavy content rather than a color swap — use `impact-shake`."+askedAs:+ - "two colour portrait on beat"+ - "music poster portrait"+ - "I want a portrait swapping ink colours on every beat"+ - "artist or team photo hitting with the track"+ - "promo with a punching-in halftone face and bar meter"+ - "viewer feels rhythm in the poster-style image"---<ComponentPreview name="duotone-beat" />diff --git a/content/docs/graphic-looks/embossed-mark.mdx b/content/docs/graphic-looks/embossed-mark.mdxindex 5c980679..1f287197 100644--- a/content/docs/graphic-looks/embossed-mark.mdx+++ b/content/docs/graphic-looks/embossed-mark.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a fast, simple logo entrance — use `logo-enter`."- "The logo should be written like a signature line — use `light-signature`."- "You want the logo shown on a reflective floor — use `studio-reflection`."+askedAs:+ - "debossed logo"+ - "pressed into metal logo"+ - "I want the logo pressed into brushed grey with a light sweep"+ - "premium sign-off looking stamped into paper"+ - "tactile end card with raking light"+ - "viewer sees the brand carved into a surface"---<ComponentPreview name="embossed-mark" />diff --git a/content/docs/graphic-looks/fluted-glass.mdx b/content/docs/graphic-looks/fluted-glass.mdxindex ae8c2249..4602714a 100644--- a/content/docs/graphic-looks/fluted-glass.mdx+++ b/content/docs/graphic-looks/fluted-glass.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The reveal should be a frosted panel clearing around a stat — use `frosted-clear`."- "You want a lens that magnifies part of the frame — use `glass-lens`."- "A simple blur-to-sharp text entrance is enough — use `focus-blur-resolve`."+askedAs:+ - "ribbed glass blur reveal"+ - "reeded glass headline"+ - "I want a headline seen through fluted glass then sliding clear"+ - "premium title that starts distorted and sharpens"+ - "gradient orb behind ridged glass"+ - "viewer sees blurred streaks resolving into a clean title"---<ComponentPreview name="fluted-glass" />diff --git a/content/docs/graphic-looks/frosted-clear.mdx b/content/docs/graphic-looks/frosted-clear.mdxindex 44935a29..4e6999a0 100644--- a/content/docs/graphic-looks/frosted-clear.mdx+++ b/content/docs/graphic-looks/frosted-clear.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The reveal should use ribbed glass that slides away — use `fluted-glass`."- "You need several stats in a row — use `stat-sequence`."- "You want a plain big number with a small caption — use `compact-stat`."+askedAs:+ - "frosted glass big stat"+ - "stat reveal behind frost"+ - "I want a frosted card wiping clear to show a huge number"+ - "reveal one headline number like 10x with a label"+ - "build suspense behind misted glass"+ - "viewer waits then sees the key metric appear"---<ComponentPreview name="frosted-clear" />diff --git a/content/docs/graphic-looks/led-ticker.mdx b/content/docs/graphic-looks/led-ticker.mdxindex 4ac6c568..123d839b 100644--- a/content/docs/graphic-looks/led-ticker.mdx+++ b/content/docs/graphic-looks/led-ticker.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The text should loop continuously as a marquee — use `infinite-marquee`."- "You want a data ticker with changing values — use `live-ticker`."- "You want a stock-tape style strip of items — use `ticker-tape`."+askedAs:+ - "scrolling LED sign"+ - "dot matrix marquee"+ - "I want a short announcement scrolling on a retro LED board"+ - "stadium or station sign with a flashing highlighted word"+ - "playful ticker line for a launch message"+ - "viewer reads a message rolling by in glowing dots"---<ComponentPreview name="led-ticker" />diff --git a/content/docs/graphic-looks/line-boil.mdx b/content/docs/graphic-looks/line-boil.mdxindex 3a753c0b..561c85c9 100644--- a/content/docs/graphic-looks/line-boil.mdx+++ b/content/docs/graphic-looks/line-boil.mdx@@ -13,6 +13,13 @@ avoidWhen:- "The line should circle or mark up an existing part of the frame rather than be the subject — use `scribble-circle`."- "Handwritten text should appear letter by letter — use `handwrite`."- "Existing content should just feel hand-placed and jittery, without being redrawn — use `paper-wobble`."+askedAs:+ - "wobbly hand drawn outline"+ - "cel animation boil"+ - "I want an outline that draws itself and keeps jittering like cartoons"+ - "simple icon that feels hand animated"+ - "shape filling with colour while the line keeps wiggling"+ - "viewer sees the restless line of traditional animation"---<ComponentPreview name="line-boil" />diff --git a/content/docs/graphic-looks/long-shadow.mdx b/content/docs/graphic-looks/long-shadow.mdxindex 97b6d154..0a961ad1 100644--- a/content/docs/graphic-looks/long-shadow.mdx+++ b/content/docs/graphic-looks/long-shadow.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The subject is a word that should rise out of the plane on a solid 3D body — use `extrude-pop`."- "A line of text should be uncovered and wiped by moving shadows — use `shadow-sweep-text`."- "The mark should land with a heavy impact rather than a soft pop — use `impact-shake`."+askedAs:+ - "flat design long shadow"+ - "icon with shadow sweep"+ - "I want a flat icon casting a long shadow to the frame edge"+ - "badge that pops and the shadow swings round on a spring"+ - "classic flat design logo mark with motion"+ - "viewer sees light moving and the shadow following"---<ComponentPreview name="long-shadow" />diff --git a/content/docs/graphic-looks/riso-print.mdx b/content/docs/graphic-looks/riso-print.mdxindex 2802c45b..f5ab3439 100644--- a/content/docs/graphic-looks/riso-print.mdx+++ b/content/docs/graphic-looks/riso-print.mdx@@ -12,6 +12,13 @@ avoidWhen:- "An existing live scene, photo or video should be re-screened as a printed page for its whole duration — use `halftone-print`."- "The print should pulse to music and swap its ink pair on every beat — use `duotone-beat`."- "Only one element should feel hand-placed on paper while the rest stays clean — use `paper-wobble`."+askedAs:+ - "risograph poster"+ - "off-register two ink print"+ - "I want a title printed in two inks with the accent misaligned"+ - "grainy paper poster look for a logo"+ - "accent layer sliding in and settling slightly off"+ - "viewer feels a handmade screenprint"---<ComponentPreview name="riso-print" />diff --git a/content/docs/graphic-looks/synthwave.mdx b/content/docs/graphic-looks/synthwave.mdxindex 494500d7..16fe0022 100644--- a/content/docs/graphic-looks/synthwave.mdx+++ b/content/docs/graphic-looks/synthwave.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The camera should fly forward through space into the next scene — use `hyperspace`."- "The backdrop should be a calm landscape that trucks sideways in layers — use `parallax-depth`."- "The moving floor should be a tunnel you travel through rather than a horizon — use `shader-light-tunnel`."+askedAs:+ - "80s neon sunset"+ - "retro grid horizon"+ - "I want a neon horizon with a scrolling grid and striped sun"+ - "music drop or gaming nostalgia backdrop"+ - "late-night product launch with outrun vibes"+ - "viewer feels 1980s retro-futurism"---<ComponentPreview name="synthwave" />diff --git a/content/docs/graphic-looks/x-ray-scan.mdx b/content/docs/graphic-looks/x-ray-scan.mdxindex d509098a..f66544df 100644--- a/content/docs/graphic-looks/x-ray-scan.mdx+++ b/content/docs/graphic-looks/x-ray-scan.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The product should come apart into labelled layers — use `exploded-view`."- "The product should be measured and annotated from the outside — use `blueprint`."- "The subject should read as a printed poster rather than a device scan — use `riso-print`."+askedAs:+ - "xray device internals"+ - "scanner reveals insides"+ - "I want a scanning bar showing the inside of a gadget"+ - "hardware launch revealing the chip and battery"+ - "white line internals with one part in red"+ - "viewer sees what is inside the device"---<ComponentPreview name="x-ray-scan" />diff --git a/content/docs/layout/backdrop.mdx b/content/docs/layout/backdrop.mdxindex 26725c3f..7faa047e 100644--- a/content/docs/layout/backdrop.mdx+++ b/content/docs/layout/backdrop.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You need an infinitely looping ambient background as a standalone track — use a shader backdrop directly and let the composition handle framing."- "You want a raw full-bleed color with no frame treatment — set `padding={0}` and `radius={0}`, or just set `backgroundColor` in the Remotion composition root."- "You're inside a transition presentation — transitions like `whip-pan` manage their own full-frame layout; nesting Backdrop inside them creates double-framing."+askedAs:+ - "scene background wrapper"+ - "frame with rounded content"+ - "I want a full-frame fill with a rounded shadowed card inside"+ - "color gradient or image behind my composition"+ - "wrap every scene in a consistent background"+ - "base layer that holds the content on a nice backdrop"---<ComponentPreview name="backdrop" />diff --git a/content/docs/layout/chat-to-preview-layout.mdx b/content/docs/layout/chat-to-preview-layout.mdxindex 3fa9a7a7..437d339c 100644--- a/content/docs/layout/chat-to-preview-layout.mdx+++ b/content/docs/layout/chat-to-preview-layout.mdx@@ -12,6 +12,13 @@ avoidWhen:- "Both columns should stay the same size — this component exists for the ratio change; use a plain flex row"- "The transition between the two states is a cut rather than a squeeze — use a transition from `TransitionSeries` instead"- "You need more than two columns, or a vertical split — the layout is horizontal and two-up by construction"+askedAs:+ - "chat then preview split"+ - "two column agent building"+ - "I want the chat column shrinking while the preview grows"+ - "show an AI agent building something with the result taking over"+ - "conversation yields the frame to the output"+ - "viewer sees the build appear next to the chat"---<ComponentPreview name="chat-to-preview-layout" />diff --git a/content/docs/layout/drift.mdx b/content/docs/layout/drift.mdxindex 6a37ba55..c866e1a7 100644--- a/content/docs/layout/drift.mdx+++ b/content/docs/layout/drift.mdx@@ -10,6 +10,13 @@ useWhen:avoidWhen:- "The content is already animated with strong motion — layering drift on top of it doubles the movement and muddies the read."- "You need a noticeable, dramatic zoom — this is a creep, not a statement; use a real scale animation or `zoom-blur` for punch."+askedAs:+ - "slow push in"+ - "subtle camera zoom"+ - "I want any static scene to creep slowly forward"+ - "keep a hero card or dashboard from feeling frozen"+ - "slight movement between transitions"+ - "viewer never sees a completely still frame"---<ComponentPreview name="drift" />diff --git a/content/docs/layout/stage.mdx b/content/docs/layout/stage.mdxindex dcdf9668..a9a88d4e 100644--- a/content/docs/layout/stage.mdx+++ b/content/docs/layout/stage.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You only need a full-frame fill or rounded inset with no 3D presentation — use `backdrop`."- "You are moving between two scenes — use a transition such as `whip-pan` or `focus-pull`."- "Elements inside the subject need independent depth or parallax — Stage treats all children as one flat plane."+askedAs:+ - "screenshot on 3D plane"+ - "camera moves over a screenshot"+ - "I want a recording on a perspective surface with keyframed camera"+ - "product page shown like a photographed object"+ - "long webpage the camera sweeps across"+ - "viewer sees a screen as a physical studio shot"---<ComponentPreview name="stage" />diff --git a/content/docs/logo-stings/accordion-unfold.mdx b/content/docs/logo-stings/accordion-unfold.mdxindex f2f319b2..7d61aea7 100644--- a/content/docs/logo-stings/accordion-unfold.mdx+++ b/content/docs/logo-stings/accordion-unfold.mdx@@ -13,6 +13,13 @@ avoidWhen:- "You want a stop-motion paper feel with hand-placed jitter — use `paper-sticker`."- "The paper motion is a scene change, not a logo reveal — use `page-turn`."- "The content should be revealed by pulling a cloth off it — use `cloth-reveal`."+askedAs:+ - "folded paper logo reveal"+ - "brochure unfolding"+ - "I want a zigzag paper unfolding into a card with my logo"+ - "print or stationery brand reveal"+ - "tactile opening like a travel leaflet"+ - "viewer sees a folded sheet open flat"---<ComponentPreview name="accordion-unfold" />diff --git a/content/docs/logo-stings/anamorphic-flare.mdx b/content/docs/logo-stings/anamorphic-flare.mdxindex bd985fc1..bf919f60 100644--- a/content/docs/logo-stings/anamorphic-flare.mdx+++ b/content/docs/logo-stings/anamorphic-flare.mdx@@ -13,6 +13,13 @@ avoidWhen:- "You want warm light flooding a cut between two scenes, not a logo reveal — use `light-leak`."- "The moment calls for a kinetic impact rather than a sweep — use `orbit-lock`."- "Text, not a logo, should get a single shine across it — use `shimmer-sweep`."+askedAs:+ - "cinematic lens flare logo"+ - "horizontal light streak"+ - "I want a light dot stretching into a streak that reveals the logo"+ - "film studio or automotive opener"+ - "premium lens flare sweep"+ - "viewer feels a blockbuster title moment"---<ComponentPreview name="anamorphic-flare" />diff --git a/content/docs/logo-stings/bass-drop.mdx b/content/docs/logo-stings/bass-drop.mdxindex 8d776e89..5670e1ac 100644--- a/content/docs/logo-stings/bass-drop.mdx+++ b/content/docs/logo-stings/bass-drop.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a soft, quiet reveal — use `first-light`."- "You need a stylised logo flip rather than a slam — use `flip-sting`."- "The sting should be a fast run of word cuts — use `blink-cut`."+askedAs:+ - "trailer build then drop"+ - "tension then logo"+ - "I want a quiet build then a loud gradient logo drop"+ - "trailer-style opener before the product name"+ - "teaser for a release with silence before the hit"+ - "viewer feels anticipation released at the reveal"---<ComponentPreview name="bass-drop" />diff --git a/content/docs/logo-stings/blink-cut.mdx b/content/docs/logo-stings/blink-cut.mdxindex 683f2898..ba9c6c55 100644--- a/content/docs/logo-stings/blink-cut.mdx+++ b/content/docs/logo-stings/blink-cut.mdx@@ -12,6 +12,13 @@ avoidWhen:- "Words should lock one at a time on reels — use `split-match`."- "The words should step through indexed brackets — use `bracket-index`."- "You want a slow, calm reveal — use `first-light`."+askedAs:+ - "fast word montage"+ - "rhythmic words then logo"+ - "I want words blinking on the beat then a cut to the logo"+ - "loud word montage ending on the product name"+ - "music-driven hype intro with changing layouts"+ - "viewer is hit by quick words before the brand"---<ComponentPreview name="blink-cut" />diff --git a/content/docs/logo-stings/bounce-logo.mdx b/content/docs/logo-stings/bounce-logo.mdxindex af5fd750..92e967f0 100644--- a/content/docs/logo-stings/bounce-logo.mdx+++ b/content/docs/logo-stings/bounce-logo.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You need a serious, premium reveal — use `first-light`."- "The playful beat is a banner and stat, not a logo — use `play-of-the-game`."- "You want a short click instead of a long bounce — use `snap-click`."+askedAs:+ - "dvd screensaver logo"+ - "bouncing wordmark corner"+ - "I want the logo bouncing around until it hits the corner"+ - "meme-aware playful sting"+ - "tongue-in-cheek brand moment for a community video"+ - "viewer waits for the corner hit like the old DVD screen"---<ComponentPreview name="bounce-logo" />diff --git a/content/docs/logo-stings/bracket-index.mdx b/content/docs/logo-stings/bracket-index.mdxindex aa4865d1..ebfe7e23 100644--- a/content/docs/logo-stings/bracket-index.mdx+++ b/content/docs/logo-stings/bracket-index.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want full-frame word flashes instead of brackets — use `blink-cut`."- "Words should lock on mechanical reels — use `split-match`."- "One statement and a logo is enough — use `introducing`."+askedAs:+ - "for X for Y for Z intro"+ - "bracketed labels naming product"+ - "I want use cases listed in brackets then the product name"+ - "list who it is for before revealing the name"+ - "tech product line stepping through words"+ - "viewer sees brackets close around the brand"---<ComponentPreview name="bracket-index" />diff --git a/content/docs/logo-stings/collab-lockup.mdx b/content/docs/logo-stings/collab-lockup.mdxindex fabeacbe..035e280d 100644--- a/content/docs/logo-stings/collab-lockup.mdx+++ b/content/docs/logo-stings/collab-lockup.mdx@@ -12,6 +12,13 @@ avoidWhen:- "Only one brand is shown — use `first-light`."- "The end card is a call to action with a URL — use `cta-collapse-mark`."- "Photos of people should sit beside the logo — use `photo-halo`."+askedAs:+ - "two logos partnership"+ - "logo x logo announcement"+ - "I want two brand logos joining with a multiplication sign"+ - "partnership or integration announcement end card"+ - "co-marketing lockup with a one-line caption"+ - "viewer sees two companies teaming up"---<ComponentPreview name="collab-lockup" />diff --git a/content/docs/logo-stings/cta-collapse-mark.mdx b/content/docs/logo-stings/cta-collapse-mark.mdxindex c3e09982..52d7be47 100644--- a/content/docs/logo-stings/cta-collapse-mark.mdx+++ b/content/docs/logo-stings/cta-collapse-mark.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The logo should come first and the message after — use `introducing`."- "You want a clean logo reveal with no text to read first — use `noise-forge-sting`."- "The end card is a partnership between two brands — use `collab-lockup`."+askedAs:+ - "call to action into logo"+ - "outro with url"+ - "I want the CTA breaking into pixels that rebuild the wordmark"+ - "final beat of a launch film with a URL under the logo"+ - "sign-off that resolves the ask into the brand"+ - "viewer ends on the logo and the link to visit"---<ComponentPreview name="cta-collapse-mark" />diff --git a/content/docs/logo-stings/dynamic-letter.mdx b/content/docs/logo-stings/dynamic-letter.mdxindex c1310c0b..4d632ccf 100644--- a/content/docs/logo-stings/dynamic-letter.mdx+++ b/content/docs/logo-stings/dynamic-letter.mdx@@ -12,6 +12,13 @@ avoidWhen:- "A single shape should morph into the letter — use `shape-morph-o`."- "You want a quiet reveal with no style cuts — use `first-light`."- "The changing part should be words, not one letter — use `bracket-index`."+askedAs:+ - "flexible identity letter"+ - "letter style cycling"+ - "I want one letter of the logo changing style on the beat"+ - "logo sting for a type or design product"+ - "shows the brand identity can morph"+ - "viewer sees one glyph flex through treatments"---<ComponentPreview name="dynamic-letter" />diff --git a/content/docs/logo-stings/first-light.mdx b/content/docs/logo-stings/first-light.mdxindex 88ef677a..ad891791 100644--- a/content/docs/logo-stings/first-light.mdx+++ b/content/docs/logo-stings/first-light.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want an eyebrow line before the name — use `introducing`."- "The reveal should feel hot and forged — use `noise-forge-sting`."- "The name should be spelled out letter by letter — use `spell-out`."+askedAs:+ - "light sweeps across wordmark"+ - "glow climbing baseline"+ - "I want a band of light travelling and lighting the logo letters"+ - "calm premium reveal at the start or end"+ - "wordmark lit as the light passes with a tagline"+ - "viewer sees a quiet elegant brand reveal"---<ComponentPreview name="first-light" />diff --git a/content/docs/logo-stings/flip-sting.mdx b/content/docs/logo-stings/flip-sting.mdxindex ab9866fd..bae5df77 100644--- a/content/docs/logo-stings/flip-sting.mdx+++ b/content/docs/logo-stings/flip-sting.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a single hard slam rather than a flip-book — use `bass-drop`."- "The reveal should be calm and quiet — use `first-light`."- "Words, not frames, should drive the rhythm — use `blink-cut`."+askedAs:+ - "flipbook inside logo letters"+ - "pull out from frames in the logo"+ - "I want rapid frames inside the letters then a zoom out to the logo"+ - "energetic kinetic opener using the logo as a stencil"+ - "camera pulls back from a flip-book into a gradient logo"+ - "viewer sees fast flat frames resolving into the brand"---<ComponentPreview name="flip-sting" />diff --git a/content/docs/logo-stings/flood-sting.mdx b/content/docs/logo-stings/flood-sting.mdxindex ed435ca3..64847160 100644--- a/content/docs/logo-stings/flood-sting.mdx+++ b/content/docs/logo-stings/flood-sting.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want the logo to ease in with no UI metaphor — use `first-light`."- "A tagline must sit under the logo — use `introducing`."- "The rhythm should come from words rather than icons — use `blink-cut`."+askedAs:+ - "icons then colour flood"+ - "colour fill reveals logo"+ - "I want a row of icons picked through then colour flooding the frame"+ - "tool picker beat ending on the brand"+ - "playful integrations moment that floods into the logo"+ - "viewer sees a choice among apps turning into our colour"---<ComponentPreview name="flood-sting" />diff --git a/content/docs/logo-stings/giant-mark-backdrop.mdx b/content/docs/logo-stings/giant-mark-backdrop.mdxindex 4c0c50a0..fb51f95e 100644--- a/content/docs/logo-stings/giant-mark-backdrop.mdx+++ b/content/docs/logo-stings/giant-mark-backdrop.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a plain logo reveal with no UI card — use `introducing`."- "The prompt should resolve into the brand through a network of nodes — use `neural-pulse`."- "You only need a tagline under a quiet logo — use `first-light`."+askedAs:+ - "huge logo behind prompt card"+ - "small logo grows into backdrop"+ - "I want a wordmark ballooning huge while a prompt box types"+ - "prompt-to-video or assistant request over a giant brand"+ - "typed request landing on a big brand background"+ - "viewer sees a prompt typed over a giant logo"---<ComponentPreview name="giant-mark-backdrop" />diff --git a/content/docs/logo-stings/glyph-block-decode.mdx b/content/docs/logo-stings/glyph-block-decode.mdxindex d0e205bd..a619cf10 100644--- a/content/docs/logo-stings/glyph-block-decode.mdx+++ b/content/docs/logo-stings/glyph-block-decode.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want plain letters spelling out with no glitch — use `spell-out`."- "The reveal should be the actual logo, not typed text — use `title-converge`."- "You need many words cutting in at a fast rhythm — use `blink-cut`."+askedAs:+ - "blocky characters decode name"+ - "url decoding underline"+ - "I want blocky glyphs flickering into the product name"+ - "name reveal with a URL people should remember"+ - "tech-forward intro with decoded text"+ - "viewer sees the name and web address decode on screen"---<ComponentPreview name="glyph-block-decode" />diff --git a/content/docs/logo-stings/glyph-matrix.mdx b/content/docs/logo-stings/glyph-matrix.mdxindex b45a0382..a5c31531 100644--- a/content/docs/logo-stings/glyph-matrix.mdx+++ b/content/docs/logo-stings/glyph-matrix.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want pixels that refine out of squares without a countdown — use `quadtree-mark`."- "You want dots that ripple across the frame — use `ripple-mark`."- "A plain quiet reveal is enough — use `first-light`."+askedAs:+ - "led dot countdown"+ - "3 2 1 then logo"+ - "I want a round dot matrix counting down and hopping into a pixel logo"+ - "countdown to launch that ends in the brand"+ - "retro hardware-flavoured developer sting"+ - "viewer counts down with glowing dots before the name types"---<ComponentPreview name="glyph-matrix" />diff --git a/content/docs/logo-stings/gravity-grid.mdx b/content/docs/logo-stings/gravity-grid.mdxindex 46808af7..52a7ad76 100644--- a/content/docs/logo-stings/gravity-grid.mdx+++ b/content/docs/logo-stings/gravity-grid.mdx@@ -12,6 +12,13 @@ avoidWhen:- "A calm, flat reveal is enough — use `first-light`."- "A dotted route should lead to the logo — use `paper-plane`."- "The logo should be built from nodes — use `neural-pulse`."+askedAs:+ - "grid bending gravity well"+ - "warped grid logo"+ - "I want a grid sagging as a mass falls and the logo lands"+ - "physics flavoured reveal for a platform with weight"+ - "3D-feeling logo landing at the bottom of a well"+ - "viewer sees space-time warp before the brand appears"---<ComponentPreview name="gravity-grid" />diff --git a/content/docs/logo-stings/heat-trace.mdx b/content/docs/logo-stings/heat-trace.mdxindex 327c0244..8ae5167d 100644--- a/content/docs/logo-stings/heat-trace.mdx+++ b/content/docs/logo-stings/heat-trace.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a cool, calm reveal — use `first-light`."- "The logo should be written by a moving point of light — use `light-trail-write`."- "You want the mark forged out of noise — use `noise-forge-sting`."+askedAs:+ - "thermal glow wordmark"+ - "heat line tracing logo"+ - "I want a warm-to-cool heat line tracing the wordmark"+ - "developer tool or hardware launch with thermal look"+ - "logo reveal with a gradient glow outline and tagline"+ - "viewer sees the name drawn in heat colours"---<ComponentPreview name="heat-trace" />diff --git a/content/docs/logo-stings/inflate.mdx b/content/docs/logo-stings/inflate.mdxindex 1a6fe5e7..9ad1e912 100644--- a/content/docs/logo-stings/inflate.mdx+++ b/content/docs/logo-stings/inflate.mdx@@ -13,6 +13,13 @@ avoidWhen:- "You want a word, not a mark, to pop up with a solid 3D body — use `extrude-pop`."- "The mark should assemble from crisp geometric parts rather than inflate — use `puzzle-snap`."- "The brand is serious or premium and the bounce reads as too playful — use `anamorphic-flare`."+askedAs:+ - "balloon logo intro"+ - "bouncy toy logo"+ - "playful app logo that puffs up like a balloon"+ - "kids app brand reveal with squash and stretch"+ - "soft glossy inflatable feel for the start of my video"+ - "logo that pops out cute and rubbery, then name slides out"---<ComponentPreview name="inflate" />diff --git a/content/docs/logo-stings/ink-bloom.mdx b/content/docs/logo-stings/ink-bloom.mdxindex b95def88..cb78d6b8 100644--- a/content/docs/logo-stings/ink-bloom.mdx+++ b/content/docs/logo-stings/ink-bloom.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want technical construction lines instead — use `logo-construct`."- "A liquid fill inside an outlined mark is wanted — use `liquid-fill`."- "A fast, snappy sting is needed — use `snap-click`."+askedAs:+ - "ink drop logo reveal"+ - "watercolor splash brand intro"+ - "I want the logo to appear from a spreading ink stain"+ - "analogue paper-texture brand reveal for an editorial studio"+ - "a handmade, crafty opener where a drop of black ink becomes our mark"+ - "logo emerging from ink bleeding across paper"---<ComponentPreview name="ink-bloom" />diff --git a/content/docs/logo-stings/introducing.mdx b/content/docs/logo-stings/introducing.mdxindex 984b777f..51038bef 100644--- a/content/docs/logo-stings/introducing.mdx+++ b/content/docs/logo-stings/introducing.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The version number should be the hero — use `sequel-numeral`."- "You want a streak of light instead of a settling eyebrow — use `light-signature`."- "The rhythm should come from fast word cuts — use `blink-cut`."+askedAs:+ - "product announcement opener"+ - "introducing tagline logo reveal"+ - "say introducing then show the name with a light sweep"+ - "launch video opening with a small label above the brand and a one-line slogan"+ - "first seconds of the launch: eyebrow text, sweep of light, then the product name"+ - "apple-style product reveal title card"---<ComponentPreview name="introducing" />diff --git a/content/docs/logo-stings/light-signature.mdx b/content/docs/logo-stings/light-signature.mdxindex 2f5fb8cb..a83cd5c3 100644--- a/content/docs/logo-stings/light-signature.mdx+++ b/content/docs/logo-stings/light-signature.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want the eyebrow to settle and lift into place — use `introducing`."- "A full-frame anamorphic flare is wanted — use `anamorphic-flare`."- "A quieter band of light with no eyebrow — use `first-light`."+askedAs:+ - "the all-new version reveal"+ - "red light streak over logo"+ - "I want a glint of red light to run across our name and a tagline below"+ - "cinematic sting for a new release with a small label above the wordmark"+ - "moment announcing a refreshed product, light racing over the title"+ - "new version title with red shine"---<ComponentPreview name="light-signature" />diff --git a/content/docs/logo-stings/light-trail-write.mdx b/content/docs/logo-stings/light-trail-write.mdxindex 9630b6f3..0b47dd93 100644--- a/content/docs/logo-stings/light-trail-write.mdx+++ b/content/docs/logo-stings/light-trail-write.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The wordmark is traced as a heat gradient instead — use `heat-trace`."- "You want a single broad streak that lights the name — use `light-signature`."- "A cinematic lens flare is wanted — use `anamorphic-flare`."+askedAs:+ - "handwritten logo with light"+ - "signature written by glowing pen"+ - "I want a glowing dot to draw our script logo like a sparkler"+ - "light painting cursive name reveal"+ - "creator brand sting where the signature is drawn in a fading light trail"+ - "calligraphy logo draw-on with glow"---<ComponentPreview name="light-trail-write" />diff --git a/content/docs/logo-stings/liquid-fill.mdx b/content/docs/logo-stings/liquid-fill.mdxindex 1cb973fc..30166233 100644--- a/content/docs/logo-stings/liquid-fill.mdx+++ b/content/docs/logo-stings/liquid-fill.mdx@@ -13,6 +13,13 @@ avoidWhen:- "Letters, not a mark, should draw as outlines and then fill — use `outline-trace`."- "The mark should feel bouncy and soft rather than fluid — use `inflate`."- "You need a fluid look as a looping background, not a reveal — use `shader-water`."+askedAs:+ - "logo filling with liquid"+ - "water pouring into logo outline"+ - "I want the logo to fill up like a glass with sloshing liquid and bubbles"+ - "drink or fintech brand reveal where the mark fills to the top"+ - "a beat about topping up or loading that ends solid on the brand"+ - "drop falls then liquid rises inside the mark"---<ComponentPreview name="liquid-fill" />diff --git a/content/docs/logo-stings/logo-construct.mdx b/content/docs/logo-stings/logo-construct.mdxindex 7fe45369..8c1bf61f 100644--- a/content/docs/logo-stings/logo-construct.mdx+++ b/content/docs/logo-stings/logo-construct.mdx@@ -12,6 +12,13 @@ avoidWhen:- "A short sting under five seconds is needed — use `snap-click`."- "The mark should refine from pixels — use `quadtree-mark`."- "A neat ink-on-paper feel without geometry is enough — use `ink-bloom`."+askedAs:+ - "blueprint logo animation"+ - "logo drawn with construction lines"+ - "show how our logo is built with grid guides"+ - "design system launch opener revealing the geometry of the mark"+ - "brand identity video showing the grid and curves before the logo inks in"+ - "technical drawing style brand intro"---<ComponentPreview name="logo-construct" />diff --git a/content/docs/logo-stings/neon-sign.mdx b/content/docs/logo-stings/neon-sign.mdxindex a7b590c8..b2e23a5c 100644--- a/content/docs/logo-stings/neon-sign.mdx+++ b/content/docs/logo-stings/neon-sign.mdx@@ -13,6 +13,13 @@ avoidWhen:- "Letters should draw on as clean outlines and then fill, without the neon look — use `outline-trace`."- "The word should be written by hand on paper, not lit in glass — use `handwrite`."- "You want a full retro neon landscape behind your content rather than a sign — use `synthwave`."+askedAs:+ - "flickering neon logo"+ - "neon tube lettering intro"+ - "I want our name to light up like a buzzing bar sign"+ - "retro nightlife venue brand reveal with glowing glass tubes"+ - "event or club promo opening where the sign stutters on then glows on a wall"+ - "neon light flicker on text"---<ComponentPreview name="neon-sign" />diff --git a/content/docs/logo-stings/neural-pulse.mdx b/content/docs/logo-stings/neural-pulse.mdxindex 66553c50..769686b7 100644--- a/content/docs/logo-stings/neural-pulse.mdx+++ b/content/docs/logo-stings/neural-pulse.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The prompt should be typed into a UI card — use `giant-mark-backdrop`."- "The metaphor should be a map, not a network — use `transit-lines`."- "You need a short sting under five seconds — use `snap-click`."+askedAs:+ - "AI logo reveal"+ - "prompt goes in, brand comes out"+ - "I want a neural network animation that ends with our logo"+ - "AI product launch opener where a prompt travels through nodes and becomes the brand"+ - "long deliberate intro showing intelligence processing before the name appears"+ - "glowing nodes and connections logo sting"---<ComponentPreview name="neural-pulse" />diff --git a/content/docs/logo-stings/noise-forge-sting.mdx b/content/docs/logo-stings/noise-forge-sting.mdxindex 8cadc081..d4a74397 100644--- a/content/docs/logo-stings/noise-forge-sting.mdx+++ b/content/docs/logo-stings/noise-forge-sting.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a calm, quiet reveal with no heat — use `first-light`."- "The logo should be drawn by a travelling light rather than forged — use `light-trail-write`."- "You need the mark built from pixels instead of noise — use `quadtree-mark`."+askedAs:+ - "forged logo from hot noise"+ - "molten metal brand reveal"+ - "I want a seam of light to burn the wordmark out of grain"+ - "developer tool or hardware launch opener with a heated glowing reveal"+ - "title that forms in static then cools under a tagline"+ - "fiery noise texture logo intro"---<ComponentPreview name="noise-forge-sting" />diff --git a/content/docs/logo-stings/orbit-lock.mdx b/content/docs/logo-stings/orbit-lock.mdxindex ef4b0acb..09db2042 100644--- a/content/docs/logo-stings/orbit-lock.mdx+++ b/content/docs/logo-stings/orbit-lock.mdx@@ -13,6 +13,13 @@ avoidWhen:- "The reveal should feel cinematic and calm rather than kinetic — use `anamorphic-flare` or `spotlight`."- "The brand is a word with no mark and the reveal should be pure type — use `mask-reveal-up` or `spring-scale-in`."- "The moment should explode outward to clear the frame for a title, with no logo at the end — use `radial-burst`."+askedAs:+ - "orbiting moons logo intro"+ - "logo arrives from spinning orbits"+ - "I want small planets circling into a core that flashes and reveals our mark"+ - "infrastructure product opener or closer with orbits converging to a burst"+ - "space-like logo landing with a ring flash"+ - "orbit animation ending in brand logo"---<ComponentPreview name="orbit-lock" />diff --git a/content/docs/logo-stings/paper-plane.mdx b/content/docs/logo-stings/paper-plane.mdxindex 12350234..e5b77cde 100644--- a/content/docs/logo-stings/paper-plane.mdx+++ b/content/docs/logo-stings/paper-plane.mdx@@ -12,6 +12,13 @@ avoidWhen:- "A map of converging lines is wanted — use `transit-lines`."- "A short sting under five seconds is needed — use `snap-click`."- "You want a physical drop into a grid — use `gravity-grid`."+askedAs:+ - "paper airplane logo animation"+ - "plane flying a dotted route to the brand"+ - "I want a paper plane to fly through steps and land as the end of our name"+ - "friendly workflow beat: write, render, launch, then the brand"+ - "craft-feeling sendoff that ends the video on the wordmark"+ - "dotted flight path to logo"---<ComponentPreview name="paper-plane" />diff --git a/content/docs/logo-stings/photo-halo.mdx b/content/docs/logo-stings/photo-halo.mdxindex edf27edd..31b6621b 100644--- a/content/docs/logo-stings/photo-halo.mdx+++ b/content/docs/logo-stings/photo-halo.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You have no imagery to show — use `spell-out`."- "Cards should explode through 3D space around a headline — use `word-burst-cards`."- "The closing lockup is a partnership between two brands — use `collab-lockup`."+askedAs:+ - "customer photos around logo"+ - "headline over scattered photos gathering into a circle"+ - "I want faces or screenshots to gather beside our logo"+ - "community beat: loved by real people, thumbnails forming a ring next to the brand"+ - "social proof moment before the logo end card"+ - "avatars circle logo reveal"---<ComponentPreview name="photo-halo" />diff --git a/content/docs/logo-stings/play-of-the-game.mdx b/content/docs/logo-stings/play-of-the-game.mdxindex bdc68c75..849e5316 100644--- a/content/docs/logo-stings/play-of-the-game.mdx+++ b/content/docs/logo-stings/play-of-the-game.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You need a calm, premium brand reveal — use `introducing`."- "A single large numeral should be the hero — use `sequel-numeral`."- "You want fast rhythmic word cuts instead of a banner — use `blink-cut`."+askedAs:+ - "overwatch style highlight"+ - "gaming recap logo and stat plate"+ - "I want a game highlight banner slicing in with our logo as the player"+ - "playful solo-builder beat like shipped in 6 hours with a flashing stat card"+ - "funny hero-stat moment in a launch video with esports energy"+ - "video game replay title card"---<ComponentPreview name="play-of-the-game" />diff --git a/content/docs/logo-stings/puzzle-snap.mdx b/content/docs/logo-stings/puzzle-snap.mdxindex 7f9402bb..993b07da 100644--- a/content/docs/logo-stings/puzzle-snap.mdx+++ b/content/docs/logo-stings/puzzle-snap.mdx@@ -13,6 +13,13 @@ avoidWhen:- "The brand is calm or luxurious and the snapping reads as too toy-like — use `anamorphic-flare`."- "You want flat shapes tumbling into a full-frame frieze rather than a compact mark — use `bauhaus-build`."- "The mark should feel soft and squishy rather than mechanical — use `inflate`."+askedAs:+ - "pieces snapping into logo"+ - "jigsaw shapes forming a mark"+ - "I only have a wordmark, build a simple geometric symbol for it"+ - "fun brand intro where scattered shapes spin in and click together with sparks"+ - "assembly animation that builds a mark then slides the name beside it"+ - "geometric tangram logo build"---<ComponentPreview name="puzzle-snap" />diff --git a/content/docs/logo-stings/quadtree-mark.mdx b/content/docs/logo-stings/quadtree-mark.mdxindex 038ba111..ab3ee125 100644--- a/content/docs/logo-stings/quadtree-mark.mdx+++ b/content/docs/logo-stings/quadtree-mark.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want dots that ripple rather than squares that subdivide — use `ripple-mark`."- "A wave across a grid should leave the mark behind — use `squircle-wave`."- "A tagline must be readable at the end — use `introducing`."+askedAs:+ - "pixelated logo that sharpens"+ - "pixels resolving into logo"+ - "I want big squares to subdivide until the logo is crisp"+ - "reveal for an image, graphics or codec product where resolution refines"+ - "low-res to high-res logo moment before the name appears"+ - "mosaic blocks refining into mark"---<ComponentPreview name="quadtree-mark" />diff --git a/content/docs/logo-stings/ripple-mark.mdx b/content/docs/logo-stings/ripple-mark.mdxindex 71cb43ad..34ec5119 100644--- a/content/docs/logo-stings/ripple-mark.mdx+++ b/content/docs/logo-stings/ripple-mark.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want squares that subdivide into the mark — use `quadtree-mark`."- "The reveal should be wordless — use `squircle-wave`."- "A countdown should lead into the logo — use `glyph-matrix`."+askedAs:+ - "dot grid ripple logo"+ - "dots light up into logo"+ - "I want waves moving across a field of dots that reveal our mark"+ - "short data or infrastructure brand sting starting from a dot matrix"+ - "logo emerging from a rippling dot pattern with name beside it"+ - "radial dot wave reveal"---<ComponentPreview name="ripple-mark" />diff --git a/content/docs/logo-stings/sequel-numeral.mdx b/content/docs/logo-stings/sequel-numeral.mdxindex 6e936882..179bfe62 100644--- a/content/docs/logo-stings/sequel-numeral.mdx+++ b/content/docs/logo-stings/sequel-numeral.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The name matters more than the number — use `introducing`."- "You want a countdown ending in the logo — use `glyph-matrix`."- "A plain tagline close with no numeral — use `first-light`."+askedAs:+ - "v2 announcement"+ - "big number two reveal"+ - "I want a huge version number dropping in next to our name"+ - "part two or second edition launch with a giant numeral and tagline"+ - "season 2 style title for a new release"+ - "sequel title card with huge digit"---<ComponentPreview name="sequel-numeral" />diff --git a/content/docs/logo-stings/shape-morph-o.mdx b/content/docs/logo-stings/shape-morph-o.mdxindex b732549f..a0d3b70c 100644--- a/content/docs/logo-stings/shape-morph-o.mdx+++ b/content/docs/logo-stings/shape-morph-o.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The letter should switch between styles rather than shapes — use `dynamic-letter`."- "You want a quick reveal under three seconds — use `snap-click`."- "A calm light reveal fits better — use `first-light`."+askedAs:+ - "shape morphing into letter O"+ - "logo where the O transforms"+ - "I want a circle to turn into different shapes before becoming a letter in our name"+ - "playful design-tool launch where one letter starts as a changing shape"+ - "brand reveal with a morphing blob settling into the wordmark"+ - "morphing o logo"---<ComponentPreview name="shape-morph-o" />diff --git a/content/docs/logo-stings/signal-resolve.mdx b/content/docs/logo-stings/signal-resolve.mdxindex 09fd645d..a25c7230 100644--- a/content/docs/logo-stings/signal-resolve.mdx+++ b/content/docs/logo-stings/signal-resolve.mdx@@ -12,6 +12,13 @@ avoidWhen:- "A short sting under five seconds is needed — use `snap-click`."- "A prompt should resolve into the brand through a network — use `neural-pulse`."- "Dots, not waves, should form the mark — use `ripple-mark`."+askedAs:+ - "noise cleared into one line"+ - "oscilloscope logo reveal"+ - "I want messy signals to sweep into a clean line that becomes our logo"+ - "monitoring or search product message about cutting through noise"+ - "calm resolve from chaos to clarity ending on the brand and a caption"+ - "waveform to logo"---<ComponentPreview name="signal-resolve" />diff --git a/content/docs/logo-stings/snap-click.mdx b/content/docs/logo-stings/snap-click.mdxindex c090d47b..16955625 100644--- a/content/docs/logo-stings/snap-click.mdx+++ b/content/docs/logo-stings/snap-click.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want soft, slow light instead of a slam — use `first-light`."- "Several words should lock in turn before the logo — use `split-match`."- "The sting needs a louder trailer-style drop — use `bass-drop`."+askedAs:+ - "logo halves slam together"+ - "clicky logo sting"+ - "I want the two halves of our mark to snap shut with a click sound"+ - "punchy short brand beat that types a one-line descriptor below"+ - "tactile moment where the logo locks together then a label types out"+ - "magnet snap logo reveal"---<ComponentPreview name="snap-click" />diff --git a/content/docs/logo-stings/spell-out.mdx b/content/docs/logo-stings/spell-out.mdxindex 636469ae..d2b11deb 100644--- a/content/docs/logo-stings/spell-out.mdx+++ b/content/docs/logo-stings/spell-out.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a glitchy decode rather than a clean drop — use `glyph-block-decode`."- "The sting needs the actual logo mark, not typed text — use `snap-click`."- "Many words should cut in at a fast rhythm — use `blink-cut`."+askedAs:+ - "spell the brand name letter by letter"+ - "hyphenated name spelling"+ - "I want our name spelled out like p-i-x-e-l with letters dropping in"+ - "intro for a name people mispronounce, then a slogan underneath"+ - "spelling bee style brand introduction"+ - "dropping letters with dashes"---<ComponentPreview name="spell-out" />diff --git a/content/docs/logo-stings/split-match.mdx b/content/docs/logo-stings/split-match.mdxindex d2e30b0d..6647778d 100644--- a/content/docs/logo-stings/split-match.mdx+++ b/content/docs/logo-stings/split-match.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want rapid full-frame word flashes — use `blink-cut`."- "The words should sit in indexed brackets — use `bracket-index`."- "Only one name needs to land — use `snap-click`."+askedAs:+ - "split-flap board tagline"+ - "airport departure board words"+ - "I want a few short words flipping on a mechanical board ending on our logo"+ - "tagline like build, ship, launch that lands on the brand"+ - "feature list beat where each word clicks into place then merges into a big mark"+ - "flip clock text reveal"---<ComponentPreview name="split-match" />diff --git a/content/docs/logo-stings/spotlight.mdx b/content/docs/logo-stings/spotlight.mdxindex 9b82b077..eea63f2c 100644--- a/content/docs/logo-stings/spotlight.mdx+++ b/content/docs/logo-stings/spotlight.mdx@@ -13,6 +13,13 @@ avoidWhen:- "The reveal needs energy and an impact hit rather than a search — use `orbit-lock`."- "You need light rays as a looping background bed, not a one-shot reveal — use `shader-god-rays`."- "The scene is a product screen on a stage with a moving camera, not a logo — use `stage`."+askedAs:+ - "stage spotlight logo reveal"+ - "theatrical light finds the logo"+ - "I want a spotlight sweeping the dark and landing on our brand"+ - "keynote or event opener where the logo waits in darkness and the lights come up"+ - "dramatic reveal with a searching beam that overshoots"+ - "dark stage logo intro"---<ComponentPreview name="spotlight" />diff --git a/content/docs/logo-stings/squircle-wave.mdx b/content/docs/logo-stings/squircle-wave.mdxindex 3fe33b09..def52d38 100644--- a/content/docs/logo-stings/squircle-wave.mdx+++ b/content/docs/logo-stings/squircle-wave.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want the name shown beside the mark — use `ripple-mark`."- "The mark should refine from large pixel squares — use `quadtree-mark`."- "A tagline must accompany the reveal — use `first-light`."+askedAs:+ - "wave of rounded squares reveals logo"+ - "text-free logo reveal"+ - "I want a motion wave across a dot grid that leaves only our mark"+ - "design-system opener with no words, just the symbol"+ - "app icon style cells sweeping to form the logo"+ - "squircle grid logo intro"---<ComponentPreview name="squircle-wave" />diff --git a/content/docs/logo-stings/title-converge.mdx b/content/docs/logo-stings/title-converge.mdxindex 20c6ec7f..c29f066b 100644--- a/content/docs/logo-stings/title-converge.mdx+++ b/content/docs/logo-stings/title-converge.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You need a quick sting under three seconds — use `snap-click`."- "The name should be spelled out with a slogan — use `spell-out`."- "Several words should lock in turn — use `split-match`."+askedAs:+ - "letters flying together into title"+ - "cinematic title card"+ - "I want letters drifting in from outside the frame to form our name"+ - "slow elegant opener for a launch film between two thin lines"+ - "movie-style name reveal with scattered characters gathering"+ - "slow typography assembly"---<ComponentPreview name="title-converge" />diff --git a/content/docs/logo-stings/transit-lines.mdx b/content/docs/logo-stings/transit-lines.mdxindex 76ceb93e..979f759c 100644--- a/content/docs/logo-stings/transit-lines.mdx+++ b/content/docs/logo-stings/transit-lines.mdx@@ -12,6 +12,13 @@ avoidWhen:- "A prompt should resolve into the brand through nodes — use `neural-pulse`."- "A single dotted route is enough — use `paper-plane`."- "You only need a name and a tagline — use `first-light`."+askedAs:+ - "metro map logo reveal"+ - "subway lines converging"+ - "I want train lines meeting at a station that becomes our logo"+ - "platform or integrations product where many routes join in one hub"+ - "roadmap or release train beat ending on the next stop"+ - "transit map animation"---<ComponentPreview name="transit-lines" />diff --git a/content/docs/logo-stings/word-burst-cards.mdx b/content/docs/logo-stings/word-burst-cards.mdxindex 8327e52f..a260ed5a 100644--- a/content/docs/logo-stings/word-burst-cards.mdx+++ b/content/docs/logo-stings/word-burst-cards.mdx@@ -12,6 +12,13 @@ avoidWhen:- "A handful of photos should gather beside the logo instead — use `photo-halo`."- "You have no imagery and just need a text reveal — use `spell-out`."- "You want a quiet logo end card — use `first-light`."+askedAs:+ - "headline exploding into cards"+ - "text bursting into photos"+ - "I want a line of text to burst word by word into floating screens and images"+ - "everything we built beat: many visuals fly out from the headline then the logo lands"+ - "feature recap opener with a collage of cards and a caption"+ - "floating cards collage reveal"---<ComponentPreview name="word-burst-cards" />diff --git a/content/docs/media/before-after.mdx b/content/docs/media/before-after.mdxindex c2f815fc..dbe9e48f 100644--- a/content/docs/media/before-after.mdx+++ b/content/docs/media/before-after.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The change is a whole UI switching theme — use `theme-flip`."- "You want a scene-to-scene wipe rather than a comparison — use `wave-wipe`."- "The change is in text, not an image — use `diff-swap`."+askedAs:+ - "before and after slider"+ - "image comparison reveal"+ - "I want a divider wiping across a photo to show the edited version"+ - "show a color grade, retouch or redesign result side by side"+ - "comparison beat where the viewer sees the transformation"+ - "wipe compare two images"---<ComponentPreview name="before-after" />diff --git a/content/docs/media/device-morph.mdx b/content/docs/media/device-morph.mdxindex d1185911..194a6661 100644--- a/content/docs/media/device-morph.mdx+++ b/content/docs/media/device-morph.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The change is a light and dark theme switch — use `theme-flip`."- "You want a rendered set of phone screens side by side — use `phone-trio`."- "A fixed screenshot should be toured region by region — use `screenshot-tour`."+askedAs:+ - "responsive design demo"+ - "desktop to phone layout"+ - "I want a device frame shrinking from desktop to tablet to mobile with the layout reflowing"+ - "show our site works on every screen size"+ - "feature beat proving the design adapts, no separate mockups"+ - "responsive breakpoints animation"---<ComponentPreview name="device-morph" />diff --git a/content/docs/media/grid-montage.mdx b/content/docs/media/grid-montage.mdxindex 9ed1d3e8..24995e05 100644--- a/content/docs/media/grid-montage.mdx+++ b/content/docs/media/grid-montage.mdx@@ -12,6 +12,13 @@ avoidWhen:- "Image shards should converge into a labelled layout — use `shards-to-grid`."- "You need fast full-frame cuts rather than a grid — use `strobe-montage`."- "A single image should be examined closely — use `up-close`."+askedAs:+ - "split screen montage"+ - "2x2 then 3x3 grid cuts"+ - "I want one shot to split into a grid and cut on the beat"+ - "rhythmic recap of many scenes or screenshots on music"+ - "opener or closer that fans a single clip into many tiles"+ - "multi-screen video wall"---<ComponentPreview name="grid-montage" />diff --git a/content/docs/media/looks-like-this.mdx b/content/docs/media/looks-like-this.mdxindex 16b7d3b8..30711820 100644--- a/content/docs/media/looks-like-this.mdx+++ b/content/docs/media/looks-like-this.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The text is a question that rewrites itself into an answer beside the screenshot — use `shot-answers`."- "You want to zoom into a detail of the image first and pull back — use `up-close`."- "The image should be toured region by region — use `screenshot-tour`."+askedAs:+ - "small thumbnail grows into video frame"+ - "what your next launch looks like"+ - "I want a sentence to end with a tiny image that expands to full player"+ - "promise line where the picture is the answer"+ - "reveal the final result inline in a headline"+ - "text with inline image expanding"---<ComponentPreview name="looks-like-this" />diff --git a/content/docs/media/panel-split.mdx b/content/docs/media/panel-split.mdxindex ea167b37..7cccd27e 100644--- a/content/docs/media/panel-split.mdx+++ b/content/docs/media/panel-split.mdx@@ -12,6 +12,13 @@ avoidWhen:- "Only two sides are compared against each other — use `versus-split`."- "You want feature tiles building up rather than a hero splitting — use `bento-build`."- "A montage of shots cutting on the beat is the goal — use `grid-montage`."+askedAs:+ - "bento intro about me"+ - "portfolio panel splitting into four"+ - "I want one hero card to divide into bio, work, question and reel cards"+ - "studio or personal intro that grows from a single box into a bento layout"+ - "about-me beat showing who I am and what I made"+ - "bento grid reveal"---<ComponentPreview name="panel-split" />diff --git a/content/docs/media/screenshot-tour.mdx b/content/docs/media/screenshot-tour.mdxindex 5a800b97..2d9cec38 100644--- a/content/docs/media/screenshot-tour.mdx+++ b/content/docs/media/screenshot-tour.mdx@@ -12,6 +12,13 @@ avoidWhen:- "All annotations should be visible together on a fixed frame — use `ui-callout`."- "You only need one close-up and a pull back — use `up-close`."- "The story is the layout adapting to screen sizes — use `device-morph`."+askedAs:+ - "zoom into parts of a screenshot"+ - "guided product walkthrough"+ - "I want the camera to push into regions of a screenshot with labels while the rest dims"+ - "product tour of one screen with three labelled highlights"+ - "feature explainer pointing out where each thing lives"+ - "annotated screenshot spotlight"---<ComponentPreview name="screenshot-tour" />diff --git a/content/docs/media/shards-to-grid.mdx b/content/docs/media/shards-to-grid.mdxindex 6103afaa..badba779 100644--- a/content/docs/media/shards-to-grid.mdx+++ b/content/docs/media/shards-to-grid.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a beat-cut montage of full-frame shots — use `grid-montage`."- "A mixed-size grid of feature tiles should build up piece by piece — use `bento-build`."- "A vertical wall of images should pan endlessly — use `infinite-bento-pan`."+askedAs:+ - "tilted images forming a grid"+ - "3D photo shards snapping together"+ - "I want floating angled images to settle into a neat media grid with a headline"+ - "media-heavy feature beat going from chaos to organized layout"+ - "visuals scattered in space then arranged with captions"+ - "image grid assembly in 3D"---<ComponentPreview name="shards-to-grid" />diff --git a/content/docs/media/shot-answers.mdx b/content/docs/media/shot-answers.mdxindex 65d2f057..d51530b0 100644--- a/content/docs/media/shot-answers.mdx+++ b/content/docs/media/shot-answers.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The sentence should end by growing a thumbnail into the image — use `looks-like-this`, the inline-thumbnail twin of this scene."- "You want to zoom into one detail of the image — use `up-close`."- "There is no question and answer, only a product tour — use `screenshot-tour`."+askedAs:+ - "question turns into its answer"+ - "text morphing word by word beside screenshot"+ - "I want a question to rewrite itself into the answer while an image slides in"+ - "Q and A beat pairing a bold claim with a framed product shot"+ - "show a problem statement becoming the solution"+ - "question to answer text swap"---<ComponentPreview name="shot-answers" />diff --git a/content/docs/media/theme-flip.mdx b/content/docs/media/theme-flip.mdxindex 933d0628..8cdc7789 100644--- a/content/docs/media/theme-flip.mdx+++ b/content/docs/media/theme-flip.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The change is a photo being graded rather than a UI theme — use `before-after`."- "The change is the layout adapting to screen sizes — use `device-morph`."- "You want to visit several parts of one screen — use `screenshot-tour`."+askedAs:+ - "dark mode toggle demo"+ - "light to dark switch"+ - "I want a cursor clicking a theme toggle and the app flooding to dark"+ - "feature beat showing dark mode with a circular reveal"+ - "show that our product supports both themes"+ - "theme switch animation"---<ComponentPreview name="theme-flip" />diff --git a/content/docs/media/up-close.mdx b/content/docs/media/up-close.mdxindex 744fe5f1..4e1da59a 100644--- a/content/docs/media/up-close.mdx+++ b/content/docs/media/up-close.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The sentence should end with a thumbnail growing into the image — use `looks-like-this`."- "A question should turn into an answer next to the image — use `shot-answers`."- "Several regions need visiting in turn — use `screenshot-tour`."+askedAs:+ - "zoom out from a detail"+ - "close up then wide shot"+ - "I want an image to start zoomed on a detail and pull back to the full frame"+ - "two-part line like up close it is X, from afar it is Y"+ - "highlight craft in a detail before revealing the whole picture"+ - "macro to wide reveal"---<ComponentPreview name="up-close" />diff --git a/content/docs/motion-graphics/bauhaus-build.mdx b/content/docs/motion-graphics/bauhaus-build.mdxindex aeeb0a67..ffd7aa0e 100644--- a/content/docs/motion-graphics/bauhaus-build.mdx+++ b/content/docs/motion-graphics/bauhaus-build.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The opener should burst and clear the whole frame instead of leaving shapes around the title — use `radial-burst`."- "The motion should be a pattern of tiles turning in place rather than a composed poster — use `truchet-flip`."- "The graphic should become the cut into the next scene instead of framing a title — use `mondrian-split`."+askedAs:+ - "bauhaus geometric opener"+ - "tumbling flat shapes poster"+ - "I want colorful shapes to tumble into a bauhaus-style composition"+ - "launch or chapter opener that builds an abstract poster then makes room for the title"+ - "art-school geometric intro with an open band for text"+ - "modernist shapes build"---<ComponentPreview name="bauhaus-build" />diff --git a/content/docs/motion-graphics/chord-ring.mdx b/content/docs/motion-graphics/chord-ring.mdxindex f20e30b9..3664cd44 100644--- a/content/docs/motion-graphics/chord-ring.mdx+++ b/content/docs/motion-graphics/chord-ring.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The tools should orbit in a constellation with depth — use `ecosystem-constellation`."- "The connections carry quantities between two sides — use `sankey-flow`."- "You want many items packed into clustered bubbles — use `bubble-pack`."+askedAs:+ - "integrations around a hub"+ - "connects with all your tools"+ - "I want tool names arranged in a circle linked by curves to a glowing center"+ - "platform beat showing many integrations plugged into one core"+ - "ecosystem compatibility moment with a caption in the middle"+ - "chord diagram of apps"---<ComponentPreview name="chord-ring" />diff --git a/content/docs/motion-graphics/dot-field-morph.mdx b/content/docs/motion-graphics/dot-field-morph.mdxindex c73729c8..6794f042 100644--- a/content/docs/motion-graphics/dot-field-morph.mdx+++ b/content/docs/motion-graphics/dot-field-morph.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want birds flying into an arrow and then the mark — use `flock-form`."- "The particles should come from a counter or waitlist — use `waitlist-swarm`."- "You want a quick dissolve of an existing element into particles — use `particle-dissolve`."+askedAs:+ - "dots forming icons"+ - "particle dots to logo"+ - "I want a swarm of dots to swirl into feature icons and finally our logo"+ - "feature tour where each capability appears as a dot-built icon"+ - "logo reveal from drifting particles"+ - "dots turning into shapes"---<ComponentPreview name="dot-field-morph" />diff --git a/content/docs/motion-graphics/flock-form.mdx b/content/docs/motion-graphics/flock-form.mdxindex 1438e307..4b5fea40 100644--- a/content/docs/motion-graphics/flock-form.mdx+++ b/content/docs/motion-graphics/flock-form.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The shape should cycle through icons before the logo — use `dot-field-morph`."- "You want dots tied to a growing counter — use `waitlist-swarm`."- "You need a quick, clean logo entrance without particles — use `logo-enter`."+askedAs:+ - "birds forming logo"+ - "flock of shapes making an arrow"+ - "I want hundreds of small birds to fly in and settle into our mark"+ - "tech or AI launch intro with a swarm assembling the brand"+ - "boids flocking animation"+ - "starling murmuration logo"---<ComponentPreview name="flock-form" />diff --git a/content/docs/motion-graphics/flow-field.mdx b/content/docs/motion-graphics/flow-field.mdxindex 8ba50e06..2008e69e 100644--- a/content/docs/motion-graphics/flow-field.mdx+++ b/content/docs/motion-graphics/flow-field.mdx@@ -13,6 +13,13 @@ avoidWhen:- "The motion should read as clouds or smoke rather than strands — use `shader-perlin-noise`."- "The loop should be geometric and rule-based rather than organic — use `pendulum-wave`."- "The particles should break up an element and carry the cut — use `particle-dissolve`."+askedAs:+ - "moving line texture background"+ - "particle trails background"+ - "I want a quiet organic background with thin flowing lines behind my quote"+ - "calm looping texture for a title card or hero shot"+ - "seamless loop of drifting particles leaving soft trails"+ - "generative flow background"---<ComponentPreview name="flow-field" />diff --git a/content/docs/motion-graphics/fourier-sum.mdx b/content/docs/motion-graphics/fourier-sum.mdxindex 658cc6a8..ece15264 100644--- a/content/docs/motion-graphics/fourier-sum.mdx+++ b/content/docs/motion-graphics/fourier-sum.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want to show a real data series over time — use `animated-line-chart`."- "The idea is rhythm or phase between many moving items — use `pendulum-wave`."- "You need parts adding up to a total with labels — use `core-sum`."+askedAs:+ - "sine waves combine into square wave"+ - "many parts one signal"+ - "I want to explain that simple waves add up to one result"+ - "technical explainer showing harmonics merging with a serif caption"+ - "signal processing math visual for a developer audience"+ - "fourier series animation"---<ComponentPreview name="fourier-sum" />diff --git a/content/docs/motion-graphics/isometric-build.mdx b/content/docs/motion-graphics/isometric-build.mdxindex 69e299d8..62828f97 100644--- a/content/docs/motion-graphics/isometric-build.mdx+++ b/content/docs/motion-graphics/isometric-build.mdx@@ -13,6 +13,13 @@ avoidWhen:- "The blocks should rebuild a logo or pixel art — use `brick-mosaic`."- "Blocks should rise across the whole frame and carry the cut into the next scene — use `grid-wave`."- "The build should be flat 2D shapes rather than isometric volume — use `bauhaus-build`."+askedAs:+ - "isometric blocks building up"+ - "tiny city made of tiles"+ - "I want an isometric grid to spring up into a stepped sculpture with one accent tower"+ - "quick section break that builds something in about a second"+ - "isometric stack animation"+ - "low-poly block city build"---<ComponentPreview name="isometric-build" />diff --git a/content/docs/motion-graphics/life-grid.mdx b/content/docs/motion-graphics/life-grid.mdxindex 01890d38..9d41b446 100644--- a/content/docs/motion-graphics/life-grid.mdx+++ b/content/docs/motion-graphics/life-grid.mdx@@ -13,6 +13,13 @@ avoidWhen:- "The cells should rebuild a specific logo or image — use `brick-mosaic`."- "The motion should feel organic and continuous rather than stepped — use `flow-field`."- "Text should resolve out of scrambled characters — use `matrix-decode`."+askedAs:+ - "game of life background"+ - "cellular automaton animation"+ - "I want a grid of cells that visibly computes and evolves"+ - "tech or AI story with a simulation running behind the text"+ - "conway cells blinking in accent colour"+ - "rule-based pixel background"---<ComponentPreview name="life-grid" />diff --git a/content/docs/motion-graphics/mondrian-split.mdx b/content/docs/motion-graphics/mondrian-split.mdxindex dd5ffbab..204eac0e 100644--- a/content/docs/motion-graphics/mondrian-split.mdx+++ b/content/docs/motion-graphics/mondrian-split.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The opener should feel round and energetic rather than rectilinear — use `radial-burst`."- "Both scenes should stay whole on screen while the cut happens, with no graphic interlude — use `slide-swap` or `whip-pan`."- "The old picture itself should break into blocks and set down as the new one — use `grid-wave`."+askedAs:+ - "mondrian style opener"+ - "de stijl red blue yellow grid"+ - "I want black lines cutting the frame into primary-coloured cells"+ - "bold flat geometric intro that ends on one cell filling the screen"+ - "section break with art-movement grid that reflows like rubber"+ - "piet mondrian animation"---<ComponentPreview name="mondrian-split" />diff --git a/content/docs/motion-graphics/path-search.mdx b/content/docs/motion-graphics/path-search.mdxindex 6fda0ea4..c1b466da 100644--- a/content/docs/motion-graphics/path-search.mdx+++ b/content/docs/motion-graphics/path-search.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a simple arrow showing flow between boxes — use `flow-arrow`."- "The path should be a trail of nodes in a graph — use `node-trail`."- "You are showing a multi-step pipeline, not a grid search — use `deploy-pipeline`."+askedAs:+ - "pathfinding algorithm animation"+ - "a-star shortest route grid"+ - "I want to show a search flooding a grid around walls then tracing the best route"+ - "explain routing or an AI agent navigating obstacles"+ - "dev tool beat showing how it finds the shortest path"+ - "maze solver visual"---<ComponentPreview name="path-search" />diff --git a/content/docs/motion-graphics/pattern-tile.mdx b/content/docs/motion-graphics/pattern-tile.mdxindex 3e078755..0095ae99 100644--- a/content/docs/motion-graphics/pattern-tile.mdx+++ b/content/docs/motion-graphics/pattern-tile.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The tiles should flip like Truchet cards, not build a wall — use `truchet-flip`."- "You want a ripple of cells across a grid — use `grid-wave`."- "You want a brick wall assembling into a mosaic — use `brick-mosaic`."+askedAs:+ - "one tile repeated into pattern"+ - "quarter circle tile wall"+ - "I want one shape rotated and mirrored until it fills the screen"+ - "explain how a design system or pattern grows from a single rule"+ - "geometric tile pattern building up"+ - "tessellation animation"---<ComponentPreview name="pattern-tile" />diff --git a/content/docs/motion-graphics/pendulum-wave.mdx b/content/docs/motion-graphics/pendulum-wave.mdxindex 284c52c1..16f191e5 100644--- a/content/docs/motion-graphics/pendulum-wave.mdx+++ b/content/docs/motion-graphics/pendulum-wave.mdx@@ -13,6 +13,13 @@ avoidWhen:- "The scene needs a one-shot accent that fires and clears rather than a running loop — use `trim-burst`."- "The background should be soft color rather than drawn geometry — use `shader-mesh-gradient`."- "The rhythm should read as a structure that builds and settles — use `truchet-flip`."+askedAs:+ - "pendulums swinging in waves"+ - "hypnotic loop background"+ - "I want a row of pendulums drifting from a line into waves and back"+ - "calm looping background that is clearly rule-based"+ - "order dissolving into chaos then realigning"+ - "pendulum wave physics"---<ComponentPreview name="pendulum-wave" />diff --git a/content/docs/motion-graphics/phyllotaxis.mdx b/content/docs/motion-graphics/phyllotaxis.mdxindex 824b7d83..5bba75f2 100644--- a/content/docs/motion-graphics/phyllotaxis.mdx+++ b/content/docs/motion-graphics/phyllotaxis.mdx@@ -13,6 +13,13 @@ avoidWhen:- "The dots should orbit on concentric rings as a shader background — use `shader-dot-orbit`."- "The moment calls for a one-shot burst that clears the frame — use `radial-burst`."- "The scene needs a texture with no focal point — use `flow-field`."+askedAs:+ - "sunflower spiral"+ - "golden angle seeds"+ - "I want dots spiralling out like a sunflower head and slowly turning"+ - "opener that grows something natural and precise in two seconds"+ - "fibonacci spiral with one highlighted arm pulsing"+ - "spiral dot pattern background"---<ComponentPreview name="phyllotaxis" />diff --git a/content/docs/motion-graphics/ring-align.mdx b/content/docs/motion-graphics/ring-align.mdxindex 44ca4223..22c603f4 100644--- a/content/docs/motion-graphics/ring-align.mdx+++ b/content/docs/motion-graphics/ring-align.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a physical lock-in of parts into a shape — use `orbit-lock`."- "The word should be revealed through a gate or slot — use `letter-gate`."- "You want a soft glass reveal rather than rings — use `fluted-glass`."+askedAs:+ - "rings rotating into alignment"+ - "aligned lock-in reveal"+ - "I want dotted circles to turn until their slots line up and a beam shows one word"+ - "a single word reveal that feels like a lock clicking"+ - "product beat about everything being in sync"+ - "concentric dials aligning"---<ComponentPreview name="ring-align" />diff --git a/content/docs/motion-graphics/speed-lines.mdx b/content/docs/motion-graphics/speed-lines.mdxindex b1c56118..9c0748ad 100644--- a/content/docs/motion-graphics/speed-lines.mdx+++ b/content/docs/motion-graphics/speed-lines.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The landing needs a small burst of strokes popping outward from the point rather than lines converging from the frame edges — use `trim-burst`."- "The whole scene should change with a fast camera move rather than one element flying in — use `whip-pan`."- "The element should be circled by hand rather than hit with motion — use `scribble-circle`."+askedAs:+ - "manga speed lines"+ - "fast entrance with motion streaks"+ - "I want an element to fly in with streaks behind it and land with a bounce"+ - "sharp entrance for a card, logo or number with squash on landing"+ - "radial focus lines snapping to one point for emphasis"+ - "anime impact lines"---<ComponentPreview name="speed-lines" />diff --git a/content/docs/motion-graphics/squiggle.mdx b/content/docs/motion-graphics/squiggle.mdxindex 7a5ec623..5274a9b1 100644--- a/content/docs/motion-graphics/squiggle.mdx+++ b/content/docs/motion-graphics/squiggle.mdx@@ -13,6 +13,13 @@ avoidWhen:- "The moment needs short lines bursting out of a point, like a click or a pop, rather than one line along a course — use `trim-burst`."- "The accent should convey speed, with streaks rushing past an element — use `speed-lines`."- "The element should be circled rather than underlined or linked — use `scribble-circle`."+askedAs:+ - "animated wavy underline"+ - "hand drawn line under text"+ - "I want a line to draw itself under a word and wiggle then calm"+ - "live accent under a number, word or button as it lands"+ - "click highlight with a swimming wave line"+ - "wavy underline animation"---<ComponentPreview name="squiggle" />diff --git a/content/docs/motion-graphics/string-art.mdx b/content/docs/motion-graphics/string-art.mdxindex 6a7588bb..99d4ef67 100644--- a/content/docs/motion-graphics/string-art.mdx+++ b/content/docs/motion-graphics/string-art.mdx@@ -13,6 +13,13 @@ avoidWhen:- "The scene needs a looping background with no build-up — use `flow-field`."- "The linework should look like a technical drawing of a product — use `blueprint`."- "The data is real and should be read as a chart — use `animated-line-chart`."+askedAs:+ - "string art cardioid"+ - "times table circle pattern"+ - "I want threads strung around a circle that morph into new curves"+ - "math or algorithm story with a precise generative figure that builds itself"+ - "engineering explainer visual of a line pattern evolving"+ - "mathematical string curves"---<ComponentPreview name="string-art" />diff --git a/content/docs/motion-graphics/topo-lines.mdx b/content/docs/motion-graphics/topo-lines.mdxindex bde3c0b1..11f9dbf5 100644--- a/content/docs/motion-graphics/topo-lines.mdx+++ b/content/docs/motion-graphics/topo-lines.mdx@@ -13,6 +13,13 @@ avoidWhen:- "The layers should read as horizontal sediment rather than a map — use `shader-strata`."- "The background should be soft color with no lines — use `shader-mesh-gradient`."- "The scene needs a rule-based geometric loop with distinct objects — use `pendulum-wave`."+askedAs:+ - "topographic contour background"+ - "map elevation lines"+ - "I want slow drifting contour lines behind a quote or title"+ - "quiet line texture that moves slowly enough to read over"+ - "looping terrain map background with one highlighted line"+ - "contour line loop"---<ComponentPreview name="topo-lines" />diff --git a/content/docs/motion-graphics/trim-burst.mdx b/content/docs/motion-graphics/trim-burst.mdxindex 88f2ffe2..49a64003 100644--- a/content/docs/motion-graphics/trim-burst.mdx+++ b/content/docs/motion-graphics/trim-burst.mdx@@ -14,6 +14,13 @@ avoidWhen:- "The lines should trail a moving element or converge on a point from the frame edges rather than burst out of it — use `speed-lines`."- "One line should draw itself along a course, like a live underline or a connector — use `squiggle`."- "The emphasis should look hand-drawn on paper rather than clean vector — use `scribble-circle`."+askedAs:+ - "strokes shooting out from a point"+ - "click burst effect"+ - "I want little lines zipping outward when something is clicked"+ - "punctuate a tap, toggle or landing number with a quick ring of strokes"+ - "burst of sparks lines on a beat"+ - "radial stroke pop"---<ComponentPreview name="trim-burst" />diff --git a/content/docs/motion-graphics/truchet-flip.mdx b/content/docs/motion-graphics/truchet-flip.mdxindex 70ce360c..fa7ee9e0 100644--- a/content/docs/motion-graphics/truchet-flip.mdx+++ b/content/docs/motion-graphics/truchet-flip.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The moment calls for a one-shot abstract burst that clears the frame for a title — use `radial-burst`."- "The background should feel soft and organic rather than drawn with lines — use `shader-mesh-gradient`."- "The pattern should carry the cut into the next scene rather than sit behind it — use `grid-wave`."+askedAs:+ - "truchet tile pattern"+ - "flipping quarter-circle tiles"+ - "I want tiles turning a quarter as a wave crosses the grid and joining into curves"+ - "flat geometric pattern bed that moves by one rule"+ - "tile grid that settles into rings or a circle"+ - "rotating tile wave background"---<ComponentPreview name="truchet-flip" />diff --git a/content/docs/motion-graphics/venn-merge.mdx b/content/docs/motion-graphics/venn-merge.mdxindex ef9230fa..18350da9 100644--- a/content/docs/motion-graphics/venn-merge.mdx+++ b/content/docs/motion-graphics/venn-merge.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The idea is two pieces merging into one new shape — use `pill-morph`."- "The overlap is a partnership of two brands — use `collab-lockup`."- "You want one shape to morph into another letter or form — use `shape-morph-o`."+askedAs:+ - "two circles overlapping"+ - "venn diagram intro"+ - "I want two labelled circles to overlap and the logo fill the middle"+ - "positioning beat: we sit between design and code"+ - "product at the intersection of disciplines"+ - "venn diagram animation"---<ComponentPreview name="venn-merge" />diff --git a/content/docs/numbers/abacus-count.mdx b/content/docs/numbers/abacus-count.mdxindex 48e87236..7f415bae 100644--- a/content/docs/numbers/abacus-count.mdx+++ b/content/docs/numbers/abacus-count.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want digits that roll like a live odometer — use `live-ticker`."- "You want a number that adds with visible carries between columns — use `carry-count`."- "You want a clean, minimal figure with no illustration — use `compact-stat`."+askedAs:+ - "abacus counting up"+ - "beads sliding on rods"+ - "I want a number counted on an abacus before it appears"+ - "usage stat like renders this week with a tactile counting feel"+ - "analog counting metaphor for a stat"+ - "bead counter number"---<ComponentPreview name="abacus-count" />diff --git a/content/docs/numbers/activity-rings.mdx b/content/docs/numbers/activity-rings.mdxindex 6a13c185..0b9a2ad1 100644--- a/content/docs/numbers/activity-rings.mdx+++ b/content/docs/numbers/activity-rings.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You have one headline percentage to land, not three metrics — use `share-donut`."- "You need a single big number with no chart — use `compact-stat`."- "You are comparing many categories side by side — use `spring-bars`."+askedAs:+ - "apple watch rings"+ - "three metrics beating goals"+ - "I want concentric rings closing past their goal with numbers counting beside"+ - "monthly or quarterly recap where usage metrics all hit targets"+ - "fitness-style progress rings stat beat"+ - "triple ring progress"---<ComponentPreview name="activity-rings" />diff --git a/content/docs/numbers/area-compare.mdx b/content/docs/numbers/area-compare.mdxindex 881365a5..349ccba2 100644--- a/content/docs/numbers/area-compare.mdx+++ b/content/docs/numbers/area-compare.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You have more than two values to compare — use `spring-bars`."- "You want the measurement drawn with dimension lines — use `measure-dim`."- "You want a duration comparison — use `timer-duel`."+askedAs:+ - "two circles size comparison"+ - "14x smaller"+ - "I want to show our bundle is much smaller using discs of different area"+ - "size or footprint claim like 1200 KB down to 84 KB"+ - "visual proof that one thing is tiny next to another"+ - "big circle small circle stat"---<ComponentPreview name="area-compare" />diff --git a/content/docs/numbers/balance-beam.mdx b/content/docs/numbers/balance-beam.mdxindex dcde466d..357fbd4a 100644--- a/content/docs/numbers/balance-beam.mdx+++ b/content/docs/numbers/balance-beam.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You have real measured values to compare — use `area-compare`."- "You want two stopwatches racing — use `timer-duel`."- "You want a two-sided stat comparison — use `versus-split`."+askedAs:+ - "seesaw weighing comparison"+ - "one thing outweighs everything"+ - "I want a scale tipping to show our product beats hours, tools and revisions"+ - "playful value claim where a pile of costs is lighter than our solution"+ - "tipping balance animation"+ - "weighing scale value"---<ComponentPreview name="balance-beam" />diff --git a/content/docs/numbers/beat-count.mdx b/content/docs/numbers/beat-count.mdxindex 63d70a60..8b269cac 100644--- a/content/docs/numbers/beat-count.mdx+++ b/content/docs/numbers/beat-count.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a smooth continuous count rather than discrete steps on a beat — use `live-ticker`."- "You want the number to build with visible carries between digits — use `carry-count`."- "The count should feel heavy and slam in from zero — use `smash-count`."+askedAs:+ - "number counting to the beat"+ - "bpm synced counter"+ - "I want a thin big numeral stepping up in time with the music"+ - "beat-synced number reveal that squashes on every kick"+ - "music video style stat counting"+ - "rhythmic counter"---<ComponentPreview name="beat-count" />diff --git a/content/docs/numbers/beeswarm.mdx b/content/docs/numbers/beeswarm.mdxindex 1caffa3e..3b18116b 100644--- a/content/docs/numbers/beeswarm.mdx+++ b/content/docs/numbers/beeswarm.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want one smooth curve moving left — use `distribution-shift`."- "You want each item's before and after in its own row — use `dumbbell-shift`."- "You want dots falling into a bell curve — use `galton-stack`."+askedAs:+ - "dot swarm before and after"+ - "distribution of dots on an axis"+ - "I want many individual dots settling to show 3.4 versus 10.6"+ - "compare two groups with a dot plot, before and after"+ - "scatter of dots shifting to a higher value"+ - "swarm plot comparison"---<ComponentPreview name="beeswarm" />diff --git a/content/docs/numbers/benchmark-race.mdx b/content/docs/numbers/benchmark-race.mdxindex 50ba17df..0e5bba60 100644--- a/content/docs/numbers/benchmark-race.mdx+++ b/content/docs/numbers/benchmark-race.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want two stopwatches side by side with no lanes — use `timer-duel`."- "You want a single bar that shrinks — use `cut-stat`."- "You want a score-style head-to-head — use `versus-split`."+askedAs:+ - "speed race bars"+ - "12x faster"+ - "I want lanes racing on one clock with our product finishing first"+ - "performance claim where the multiplier lands above the winner"+ - "benchmark result in a video, competitors left behind"+ - "racing lanes stat"---<ComponentPreview name="benchmark-race" />diff --git a/content/docs/numbers/block-city.mdx b/content/docs/numbers/block-city.mdxindex 3d5d2d77..290859ba 100644--- a/content/docs/numbers/block-city.mdx+++ b/content/docs/numbers/block-city.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You need a flat bar chart with readable category labels — use `spring-bars`."- "The story is a trend over time, not a skyline — use `growth-line`."- "You only have time for a short stat beat — use `compact-stat`."+askedAs:+ - "3D skyline of blocks"+ - "growth percentage over a cityscape"+ - "I want blocks rising like skyscrapers while a big percent counts up"+ - "growth beat that lands one number after a cinematic flyover"+ - "launch results shown as a growing skyline"+ - "bar city 3D"---<ComponentPreview name="block-city" />diff --git a/content/docs/numbers/bracket-focus.mdx b/content/docs/numbers/bracket-focus.mdxindex 7d52b8aa..262fce2e 100644--- a/content/docs/numbers/bracket-focus.mdx+++ b/content/docs/numbers/bracket-focus.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a crosshair lock on a chart peak - use `crosshair-lock`."- "The number should count up before it lands - use `lumen-count`."- "A bold gradient headline number is the look - use `magnitude-push`."+askedAs:+ - "viewfinder brackets around a number"+ - "camera focus corners on stat"+ - "I want corner brackets snapping around a big value over a grid"+ - "technical beat for latency or render time that feels measured"+ - "captured metric with a small tag chip"+ - "hud frame highlight"---<ComponentPreview name="bracket-focus" />diff --git a/content/docs/numbers/branch-tree.mdx b/content/docs/numbers/branch-tree.mdxindex 4cdcc2e1..405952e5 100644--- a/content/docs/numbers/branch-tree.mdx+++ b/content/docs/numbers/branch-tree.mdx@@ -12,6 +12,13 @@ avoidWhen:- "Cells should divide on a grid rather than branch - use `cell-divide`."- "The sizes of categories matter more than the count - use `treemap-split`."- "A simple multiplier number is enough - use `magnitude-push`."+askedAs:+ - "tree growing from root to leaves"+ - "one becomes many variants"+ - "I want a tree branching out level by level then showing the leaf count"+ - "beat about combinations or variety from one component"+ - "scale story where one root explodes into dozens"+ - "branching diagram stat"---<ComponentPreview name="branch-tree" />diff --git a/content/docs/numbers/bubble-pack.mdx b/content/docs/numbers/bubble-pack.mdxindex 5db60237..63d2d78c 100644--- a/content/docs/numbers/bubble-pack.mdx+++ b/content/docs/numbers/bubble-pack.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The parts add up to a whole and you want a percentage reading — use `share-donut`."- "You want every category labeled in a tidy rectangle layout — use `treemap-split`."- "Order and rank matter more than size — use `rank-climb`."+askedAs:+ - "bubbles of different sizes"+ - "one big bubble dominates"+ - "I want category bubbles growing around one large gradient bubble with a number"+ - "show what the product is used for, one use clearly winning"+ - "usage breakdown as circles"+ - "packed circles chart"---<ComponentPreview name="bubble-pack" />diff --git a/content/docs/numbers/calendar-pick.mdx b/content/docs/numbers/calendar-pick.mdxindex 29c96748..f5866e6e 100644--- a/content/docs/numbers/calendar-pick.mdx+++ b/content/docs/numbers/calendar-pick.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You only want to announce a date with a calendar drawing itself and a glowing ring — use `launch-date`."- "You need a live countdown to the date rather than a picked day — use `countdown`."- "You want to show a year or number landing on a ruler — use `ruler-scrub`."+askedAs:+ - "launch date on a calendar"+ - "month grid with a clicked day"+ - "I want a calendar where a cursor clicks the launch date and event tags appear"+ - "save the date beat announcing when we ship"+ - "release date reveal"+ - "calendar date highlight"---<ComponentPreview name="calendar-pick" />diff --git a/content/docs/numbers/candle-rally.mdx b/content/docs/numbers/candle-rally.mdxindex 0034a2d1..0f60654a 100644--- a/content/docs/numbers/candle-rally.mdx+++ b/content/docs/numbers/candle-rally.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a smooth trend line rather than candles — use `growth-line`."- "The story is gains and losses stepping to a total — use `waterfall-chart`."- "You want a compact glowing trend beside a stat — use `sparkline-thread`."+askedAs:+ - "stock chart all-time high"+ - "candlestick chart rally"+ - "I want candles climbing past the old high with a price tag beside"+ - "milestone beat for record revenue, usage or growth"+ - "finance-style chart moment, tradingview vibe"+ - "green candlesticks breakout"---<ComponentPreview name="candle-rally" />diff --git a/content/docs/numbers/carry-count.mdx b/content/docs/numbers/carry-count.mdxindex 41c87979..cbff8dec 100644--- a/content/docs/numbers/carry-count.mdx+++ b/content/docs/numbers/carry-count.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want digits that roll continuously like a live feed — use `live-ticker`."- "You want rods and beads instead of carry discs — use `abacus-count`."- "You want the count to land on beats of music — use `beat-count`."+askedAs:+ - "counter with carry digit"+ - "odometer ticking over"+ - "I want a big number climbing where a disc carries a one to the next place"+ - "usage stat like scenes students built in week one"+ - "numbers rolling in chunks"+ - "carry the one counter"---<ComponentPreview name="carry-count" />diff --git a/content/docs/numbers/cell-divide.mdx b/content/docs/numbers/cell-divide.mdxindex 0853730b..bbce9804 100644--- a/content/docs/numbers/cell-divide.mdx+++ b/content/docs/numbers/cell-divide.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a grid of discrete dots lit up to show a share of 100 — use `unit-grid`."- "You want a smooth rising curve for exponential growth — use `growth-line`."- "You want a branching structure rather than a doubling grid — use `branch-tree`."+askedAs:+ - "dots doubling"+ - "exponential growth cells"+ - "I want one dot to split into two, four, eight up to sixty-four"+ - "doubling or compounding story with a rising count"+ - "biology style cell division stat"+ - "power of two animation"---<ComponentPreview name="cell-divide" />diff --git a/content/docs/numbers/chart-morph.mdx b/content/docs/numbers/chart-morph.mdxindex e91af078..839b2260 100644--- a/content/docs/numbers/chart-morph.mdx+++ b/content/docs/numbers/chart-morph.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You just need a clean line that draws on — use `growth-line`."- "You want a glowing sparkline next to a stat — use `sparkline-thread`."- "You need bars that overshoot with spring physics — use `spring-bars`."+askedAs:+ - "ring turns into bar chart"+ - "chart changing type"+ - "I want the same data to morph from a donut into bars then a line chart"+ - "data reveal where numbers visibly transform into a trend ending on 46k"+ - "monthly metrics recap with a chart that keeps changing form"+ - "donut to area chart"---<ComponentPreview name="chart-morph" />diff --git a/content/docs/numbers/chevron-run.mdx b/content/docs/numbers/chevron-run.mdxindex f4ad5012..a718de8f 100644--- a/content/docs/numbers/chevron-run.mdx+++ b/content/docs/numbers/chevron-run.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The number should come from a graph that draws itself - use `growth-line`."- "You want an arrow that zigzags beside a multiplier - use `flow-arrow`."- "A plain figure with a caption is enough - use `compact-stat`."+askedAs:+ - "giant chevron arrow"+ - "upward momentum growth stat"+ - "I want a wall of chevrons locking into one big gradient arrow with a figure"+ - "percentage increase that deserves a pushy upward entrance"+ - "growth beat with serif caption under the number"+ - "chevron arrows rising"---<ComponentPreview name="chevron-run" />diff --git a/content/docs/numbers/churn-count.mdx b/content/docs/numbers/churn-count.mdxindex 0394472c..0b740a44 100644--- a/content/docs/numbers/churn-count.mdx+++ b/content/docs/numbers/churn-count.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a slower number that builds with carries — use `carry-count`."- "You want a number with a spring landing and a punch — use `smash-count`."- "You want a number that rolls its digits like a live feed — use `live-ticker`."+askedAs:+ - "huge number counting up fast"+ - "blue thin digits on black"+ - "I want a giant counter racing up with flashing digits then settling under a caption"+ - "big-figure beat on a black background with a small blue label"+ - "dramatic high-number stat"+ - "fast counter black blue"---<ComponentPreview name="churn-count" />diff --git a/content/docs/numbers/clock-sweep.mdx b/content/docs/numbers/clock-sweep.mdxindex 6562622a..6a2ceaf0 100644--- a/content/docs/numbers/clock-sweep.mdx+++ b/content/docs/numbers/clock-sweep.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want two competing timers rather than one dial — use `timer-duel`."- "The time is a countdown to an event, not an elapsed duration — use `countdown`."- "You want a big counted number with no clock imagery — use `compact-stat`."+askedAs:+ - "clock hand sweeping time saved"+ - "from idea to video in 4 minutes"+ - "I want a clock hand sweeping a glowing wedge as the time claim appears"+ - "time-saved moment showing speed of the workflow"+ - "stopwatch style duration reveal"+ - "minutes saved animation"---<ComponentPreview name="clock-sweep" />diff --git a/content/docs/numbers/combo-counter.mdx b/content/docs/numbers/combo-counter.mdxindex 97f7cbd8..1ecbeb1c 100644--- a/content/docs/numbers/combo-counter.mdx+++ b/content/docs/numbers/combo-counter.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a calm, readable list of features rather than rapid hits — use `stat-sequence`."- "The moment is a single new record with a leaderboard — use `high-score`."- "You want one number counting up on a beat without feature names — use `beat-count`."+askedAs:+ - "fighting game combo meter"+ - "12 hit combo perfect"+ - "I want each feature to slam in like a hit with a combo counter climbing"+ - "feature rundown with arcade rating words like perfect"+ - "gamified features list"+ - "street fighter style counter"---<ComponentPreview name="combo-counter" />diff --git a/content/docs/numbers/compact-stat.mdx b/content/docs/numbers/compact-stat.mdxindex 459fcf72..90889f9d 100644--- a/content/docs/numbers/compact-stat.mdx+++ b/content/docs/numbers/compact-stat.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The count should stay as a full long number - use `row-count`."- "You want a count on a ruled scale - use `pitch-over`."- "Several stats should sit in a row - use `stat-sequence`."+askedAs:+ - "1.2M abbreviated number"+ - "long number shrinking to k m b"+ - "I want a full number to retract into a short form with a gradient suffix"+ - "big total like frames rendered shortened to a headline figure"+ - "stat that goes from exact to compact"+ - "number suffix animation"---<ComponentPreview name="compact-stat" />diff --git a/content/docs/numbers/concentric-scale.mdx b/content/docs/numbers/concentric-scale.mdxindex dd19b110..592e8e1f 100644--- a/content/docs/numbers/concentric-scale.mdx+++ b/content/docs/numbers/concentric-scale.mdx@@ -12,6 +12,13 @@ avoidWhen:- "Only two values are compared as discs - use `area-compare`."- "The scale should read as a rescaling axis of bars - use `log-rescale`."- "A tree of multiplying branches is closer to the idea - use `branch-tree`."+askedAs:+ - "orders of magnitude"+ - "from one user to a hundred thousand"+ - "I want dotted discs growing step by step until a final glowing one lands a figure"+ - "scale story that jumps by tens"+ - "growth sequence with rings"+ - "expanding circles stat"---<ComponentPreview name="concentric-scale" />diff --git a/content/docs/numbers/contribution-heatmap.mdx b/content/docs/numbers/contribution-heatmap.mdxindex b48052c5..72a6b0cf 100644--- a/content/docs/numbers/contribution-heatmap.mdx+++ b/content/docs/numbers/contribution-heatmap.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a plain big number with no supporting graphic — use `compact-stat`."- "You want a single line trending upward rather than a grid of cells — use `growth-line`."- "You want a grid lit up to show a share of 100 — use `unit-grid`."+askedAs:+ - "github contribution graph"+ - "year of activity squares"+ - "I want a grid of daily cells filling in while a counter rolls to 12,480"+ - "usage or activity beat that looks like a commit heatmap"+ - "show consistent daily use"+ - "green squares calendar"---<ComponentPreview name="contribution-heatmap" />diff --git a/content/docs/numbers/core-sum.mdx b/content/docs/numbers/core-sum.mdxindex 88db1015..add38944 100644--- a/content/docs/numbers/core-sum.mdx+++ b/content/docs/numbers/core-sum.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want one number simply counting up with no parts — use `carry-count`."- "You want a digit-by-digit odometer feel — use `live-ticker`."- "The point is a share or breakdown of a whole rather than a sum — use `number-split`."+askedAs:+ - "cpu cores adding up"+ - "parallel workers merging into a total"+ - "I want parallel counters merging row by row into one big figure"+ - "scale claim with many cores or workers"+ - "monospace tech number sum"+ - "sum of parts total"---<ComponentPreview name="core-sum" />diff --git a/content/docs/numbers/countdown.mdx b/content/docs/numbers/countdown.mdxindex 5a9708d6..7e2d0549 100644--- a/content/docs/numbers/countdown.mdx+++ b/content/docs/numbers/countdown.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a countdown to a specific calendar date, not 3-2-1 — use `launch-date`."- "You need a mission-clock style T-minus readout with rolling characters — use `t-minus`."- "You want a small sports-style clock running down to zero — use `shot-clock`."+askedAs:+ - "3 2 1 countdown"+ - "go live countdown"+ - "I want a giant numeral counting down inside a ring then showing Live"+ - "opening beat that counts down and lands on the product name"+ - "livestream or launch countdown intro"+ - "big timer numbers"---<ComponentPreview name="countdown" />diff --git a/content/docs/numbers/crosshair-lock.mdx b/content/docs/numbers/crosshair-lock.mdxindex 17ada68a..b0f08dbd 100644--- a/content/docs/numbers/crosshair-lock.mdx+++ b/content/docs/numbers/crosshair-lock.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You need a full chart that draws in and trends — use `growth-line`."- "You want a bar chart that climbs to a final number — use `pixel-bars`."- "The story is a before-and-after distribution — use `distribution-shift`."+askedAs:+ - "crosshair on a peak"+ - "target lock on dot plot"+ - "I want a crosshair snapping onto the highest dot and calling out the value"+ - "call out one outlier or peak with a precise readout"+ - "performance scene highlighting 2.4k per minute"+ - "aim reticle data point"---<ComponentPreview name="crosshair-lock" />diff --git a/content/docs/numbers/cut-stat.mdx b/content/docs/numbers/cut-stat.mdxindex 452626f0..0ed5ec7a 100644--- a/content/docs/numbers/cut-stat.mdx+++ b/content/docs/numbers/cut-stat.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You have several segments that shrink, not one bar — use `time-breakdown`."- "You want the savings framed as a race between tools — use `benchmark-race`."- "You need a plain big number with a caption — use `compact-stat`."+askedAs:+ - "minus 44% time saved"+ - "bar graph shrinking"+ - "I want a blue bar chart wiping up beside a big negative percentage"+ - "cost or time cut claim with a falling bar visual"+ - "benefit beat less time to a finished cut"+ - "reduction stat blue"---<ComponentPreview name="cut-stat" />diff --git a/content/docs/numbers/diminuendo.mdx b/content/docs/numbers/diminuendo.mdxindex 5d7dd0a1..9c357107 100644--- a/content/docs/numbers/diminuendo.mdx+++ b/content/docs/numbers/diminuendo.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a plain, evenly weighted figure — use `compact-stat`."- "You want a thin-to-heavy weight change on digits that are still changing — use `churn-count`."- "You want the number to slam in with impact — use `smash-count`."+askedAs:+ - "number fading digits"+ - "big number with quieter trailing groups"+ - "I want a huge counter where each trailing digit group is smaller and fainter"+ - "giant figure that grows as it climbs, 860,000"+ - "elegant number reveal with fading tail"+ - "descending digit opacity"---<ComponentPreview name="diminuendo" />diff --git a/content/docs/numbers/distribution-shift.mdx b/content/docs/numbers/distribution-shift.mdxindex 9b1097d0..9666cae2 100644--- a/content/docs/numbers/distribution-shift.mdx+++ b/content/docs/numbers/distribution-shift.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You have two groups of individual samples to compare — use `beeswarm`."- "You want lanes racing to a finish line — use `benchmark-race`."- "You only need the headline multiplier — use `compact-stat`."+askedAs:+ - "latency curve moving left"+ - "faster load times chart"+ - "I want a wide curve to collapse toward a lower value with 120ms shown"+ - "performance beat showing response time improved by 86%"+ - "bell curve shifting"+ - "latency distribution improvement"---<ComponentPreview name="distribution-shift" />diff --git a/content/docs/numbers/domino-run.mdx b/content/docs/numbers/domino-run.mdxindex e052a3ec..5099df88 100644--- a/content/docs/numbers/domino-run.mdx+++ b/content/docs/numbers/domino-run.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The multiplication should be shown with a flipping sign - use `times-turn`."- "You want bars that overshoot with spring - use `spring-bars`."- "A plain multiplier headline is enough - use `magnitude-push`."+askedAs:+ - "dominoes falling chain reaction"+ - "small step leads to 10x"+ - "I want dominoes tipping, each bigger, until the last triggers a big stat"+ - "compounding effect story"+ - "playful beat showing one thing causing a huge result"+ - "domino effect"---<ComponentPreview name="domino-run" />diff --git a/content/docs/numbers/dot-globe.mdx b/content/docs/numbers/dot-globe.mdxindex 867d2030..0fcf976d 100644--- a/content/docs/numbers/dot-globe.mdx+++ b/content/docs/numbers/dot-globe.mdx@@ -12,6 +12,13 @@ avoidWhen:- "A flat map lighting up city by city is the look - use `dot-map`."- "The stat is one number with no geography - use `compact-stat`."- "The count should be built from a sentence - use `stat-inline`."+askedAs:+ - "spinning dotted earth"+ - "arcs between cities"+ - "I want a globe with arcs flying between cities and a counter ticking up"+ - "global reach beat, countries served"+ - "tech launch showing worldwide users"+ - "world connections animation"---<ComponentPreview name="dot-globe" />diff --git a/content/docs/numbers/dot-map.mdx b/content/docs/numbers/dot-map.mdxindex f458db38..b8514ef0 100644--- a/content/docs/numbers/dot-map.mdx+++ b/content/docs/numbers/dot-map.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a rotating globe with flight arcs - use `dot-globe`."- "The stat is not geographic - use `compact-stat`."- "The data is flows between sources and a target - use `sankey-flow`."+askedAs:+ - "world map lighting up"+ - "dotted map coverage"+ - "I want a dot world map where cities light up one by one with a rising number"+ - "coverage beat of regions or countries served"+ - "map of presence with a counter"+ - "points on map"---<ComponentPreview name="dot-map" />diff --git a/content/docs/numbers/dot-sort.mdx b/content/docs/numbers/dot-sort.mdxindex 53e4a8ba..b75b959b 100644--- a/content/docs/numbers/dot-sort.mdx+++ b/content/docs/numbers/dot-sort.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a gradient ring and one percentage — use `share-donut`."- "You want a 10 by 10 grid reading a single percent — use `unit-grid`."- "You want rectangles sized by value — use `treemap-split`."+askedAs:+ - "dots sorting into rows"+ - "share of choice 41%"+ - "I want hundreds of dots sorting into groups with our row the largest"+ - "survey or share beat where the winner is the longest row"+ - "percentage of users shown as dots"+ - "dot unit chart"---<ComponentPreview name="dot-sort" />diff --git a/content/docs/numbers/dumbbell-shift.mdx b/content/docs/numbers/dumbbell-shift.mdxindex 9c86402b..2009b74e 100644--- a/content/docs/numbers/dumbbell-shift.mdx+++ b/content/docs/numbers/dumbbell-shift.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You have only two time points and want slanted lines — use `slope-chart`."- "You want a whole population of dots — use `beeswarm`."- "You want a single saved-time bar — use `time-breakdown`."+askedAs:+ - "dumbbell chart before after"+ - "dots sliding apart per row"+ - "I want rows where before and after dots move apart with a plus 16 summary"+ - "launch recap across categories showing improvement"+ - "gap chart improvement"+ - "before and after per category"---<ComponentPreview name="dumbbell-shift" />diff --git a/content/docs/numbers/figure-reels.mdx b/content/docs/numbers/figure-reels.mdxindex c2130a40..9a1a3a22 100644--- a/content/docs/numbers/figure-reels.mdx+++ b/content/docs/numbers/figure-reels.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You have no images and want a number on a clean ground - use `figure-to-label`."- "The figure should be one of several stats counting in a row - use `stat-sequence`."- "A plain animated count is enough - use `compact-stat`."+askedAs:+ - "odometer between image reels"+ - "funding announcement number"+ - "I want a figure rolling up like an odometer between scrolling rows of images"+ - "milestone announcement with product imagery behind the number"+ - "raised amount reveal with a label and mark"+ - "slot machine number photos"---<ComponentPreview name="figure-reels" />diff --git a/content/docs/numbers/figure-to-label.mdx b/content/docs/numbers/figure-to-label.mdxindex 4f24cb17..106b5138 100644--- a/content/docs/numbers/figure-to-label.mdx+++ b/content/docs/numbers/figure-to-label.mdx@@ -12,6 +12,13 @@ avoidWhen:- "Imagery should scroll behind the number - use `figure-reels`."- "The number should simply count up - use `lumen-count`."- "A caption-led stat on a dark ground is enough - use `compact-stat`."+askedAs:+ - "halftone number turning into a word"+ - "valuation reveal"+ - "I want a dotted figure that collapses so a label word types beside it"+ - "revenue announcement where the number becomes the word naming it"+ - "premium look figure on a ruled card"+ - "halftone dots stat"---<ComponentPreview name="figure-to-label" />diff --git a/content/docs/numbers/flash-count.mdx b/content/docs/numbers/flash-count.mdxindex c8923979..59a53821 100644--- a/content/docs/numbers/flash-count.mdx+++ b/content/docs/numbers/flash-count.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a heavy slam-in with no photography metaphor — use `smash-count`."- "You want a steady, calm figure with no flash — use `compact-stat`."- "You want the figure to glow with a floor reflection instead of a flash — use `lumen-count`."+askedAs:+ - "camera flash number reveal"+ - "photo exposure counter"+ - "I want a count racing up with a flash pop on the final value"+ - "photo-themed stat like shots taken with an exposure label"+ - "number lands with a bright flash"+ - "camera shutter stat"---<ComponentPreview name="flash-count" />diff --git a/content/docs/numbers/flow-arrow.mdx b/content/docs/numbers/flow-arrow.mdxindex 5aa1714d..e22493dc 100644--- a/content/docs/numbers/flow-arrow.mdx+++ b/content/docs/numbers/flow-arrow.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You need real data on axes — use `growth-line`."- "You want a bold multiplier on its own — use `compact-stat`."- "You need a glowing trend that draws to a point — use `sparkline-thread`."+askedAs:+ - "dotted arrow going up"+ - "3x growth arrow"+ - "I want a zigzag gradient arrow rising beside a growth stat"+ - "short momentum beat carrying upward energy"+ - "growth number with an arrow made of dots"+ - "upward trend arrow"---<ComponentPreview name="flow-arrow" />diff --git a/content/docs/numbers/fraction-split.mdx b/content/docs/numbers/fraction-split.mdxindex ff70a6c5..5c6b6379 100644--- a/content/docs/numbers/fraction-split.mdx+++ b/content/docs/numbers/fraction-split.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The share should be a pie-like ring - use `share-donut`."- "The proportion is a grid of dots - use `unit-grid`."- "A segmented bar that shrinks while a number counts is closer - use `time-breakdown`."+askedAs:+ - "bar splitting into fractions"+ - "one eighth of the time"+ - "I want a bar of boxes dividing into halves, quarters, eighths and one left filled"+ - "speed or efficiency claim where the fraction is the visual"+ - "clean beat showing 1/8"+ - "fractions diagram"---<ComponentPreview name="fraction-split" />diff --git a/content/docs/numbers/free-as-in.mdx b/content/docs/numbers/free-as-in.mdxindex a59685fa..7e5492c8 100644--- a/content/docs/numbers/free-as-in.mdx+++ b/content/docs/numbers/free-as-in.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The point is a list of fine print dropping away to one price - use `price-page`."- "You want a receipt that totals what the viewer saves - use `the-tab`."- "Lines should step in with growing indents like code - use `indent-steps`."+askedAs:+ - "word with qualifications"+ - "free as in beer"+ - "I want a big word explained by short lines, each pushing the last up"+ - "pricing or openness beat with several qualifiers"+ - "typographic list that stacks meaning"+ - "gloss line by line"---<ComponentPreview name="free-as-in" />diff --git a/content/docs/numbers/fuchidori-count.mdx b/content/docs/numbers/fuchidori-count.mdxindex ebf29e80..85dfeb92 100644--- a/content/docs/numbers/fuchidori-count.mdx+++ b/content/docs/numbers/fuchidori-count.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a plain figure with no outline effect — use `compact-stat`."- "You want the count to land with a camera flash — use `flash-count`."- "You want digits whose weight and colour change while they churn — use `churn-count`."+askedAs:+ - "japanese variety show text"+ - "sticker outline counter"+ - "I want a number with stacked colourful outlines like a TV caption"+ - "sticker-style stat where each count adds another red border"+ - "pop sticker numbers"+ - "outlined cartoon digits"---<ComponentPreview name="fuchidori-count" />diff --git a/content/docs/numbers/galton-stack.mdx b/content/docs/numbers/galton-stack.mdxindex 19512b75..4be8dbf9 100644--- a/content/docs/numbers/galton-stack.mdx+++ b/content/docs/numbers/galton-stack.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want two sample groups compared on one axis — use `beeswarm`."- "You want a smooth before-and-after curve — use `distribution-shift`."- "You only need the stat — use `compact-stat`."+askedAs:+ - "galton board bell curve"+ - "dots falling into a histogram"+ - "I want dots dropping through pegs into a bell curve marked at 95%"+ - "reliability claim such as 95% under 2 seconds"+ - "probability visual for a speed stat"+ - "plinko bell curve"---<ComponentPreview name="galton-stack" />diff --git a/content/docs/numbers/gear-shift.mdx b/content/docs/numbers/gear-shift.mdxindex 3a6277a8..dcae5ec0 100644--- a/content/docs/numbers/gear-shift.mdx+++ b/content/docs/numbers/gear-shift.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a single smooth ease with no stepped feel — use `compact-stat`."- "You want the count to land on musical beats — use `beat-count`."- "You want a slam-in from zero with no stepping — use `smash-count`."+askedAs:+ - "gear shifting number"+ - "accelerating through gears"+ - "I want a big number shifting up numbered gears on a teal panel"+ - "speed beat getting heavier with each gear"+ - "car transmission stat"+ - "gear steps counter"---<ComponentPreview name="gear-shift" />diff --git a/content/docs/numbers/grid-snap-poster.mdx b/content/docs/numbers/grid-snap-poster.mdxindex 50469800..fad205c6 100644--- a/content/docs/numbers/grid-snap-poster.mdx+++ b/content/docs/numbers/grid-snap-poster.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The version numeral should rise inside a glowing ring - use `version-hero`."- "The number should be shown as an edition on a colored band - use `roman-edition`."- "Tiles should pack into a poster grid around one stat - use `shape-pack`."+askedAs:+ - "poster layout snapping together"+ - "release poster with giant number"+ - "I want a poster whose elements snap onto a column grid one by one"+ - "version announcement laid out like a swiss poster"+ - "premium editorial release layout"+ - "grid poster build"---<ComponentPreview name="grid-snap-poster" />diff --git a/content/docs/numbers/growth-line.mdx b/content/docs/numbers/growth-line.mdxindex fc4c8ddd..06bfb063 100644--- a/content/docs/numbers/growth-line.mdx+++ b/content/docs/numbers/growth-line.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a compact glowing trend beside a stat — use `sparkline-thread`."- "You have real categories on an axis — use `spring-bars`."- "You want the chart to transform between shapes — use `chart-morph`."+askedAs:+ - "growth curve to 100k"+ - "exponential line chart"+ - "I want a curve drawing through milestones to a big endpoint"+ - "first-year growth story ending on 100k"+ - "startup traction line"+ - "hockey stick graph"---<ComponentPreview name="growth-line" />diff --git a/content/docs/numbers/hatch-shade.mdx b/content/docs/numbers/hatch-shade.mdxindex edecd765..61fcf2a1 100644--- a/content/docs/numbers/hatch-shade.mdx+++ b/content/docs/numbers/hatch-shade.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The number should be woven from threads - use `thread-weave`."- "A single-stroke handwritten figure is the look - use `single-stroke`."- "You want pixel tiles painting the figure - use `raster-paint`."+askedAs:+ - "engraved number"+ - "pen sketch stat"+ - "I want a big stat that looks hand-inked with crosshatch lines"+ - "show a number shaded in like an etching on paper"+ - "quiet editorial stat moment in a magazine style video"+ - "a calm paper-craft beat where one figure feels drawn, not typed"---<ComponentPreview name="hatch-shade" />diff --git a/content/docs/numbers/hex-fill.mdx b/content/docs/numbers/hex-fill.mdxindex 035a0d2e..2f0516eb 100644--- a/content/docs/numbers/hex-fill.mdx+++ b/content/docs/numbers/hex-fill.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The share should be a ring sweep - use `share-donut`."- "The share should be a square grid of dots - use `unit-grid`."- "Tiles should split by category size - use `treemap-split`."+askedAs:+ - "honeycomb percentage"+ - "hexagon grid stat"+ - "I want a percent shown as hexagon cells filling up around a ring"+ - "show cache hit rate as a hive of cells lighting up"+ - "a data beat where the filled share of a grid is the picture"+ - "viewer should see how much of the whole is covered by a hex pattern"---<ComponentPreview name="hex-fill" />diff --git a/content/docs/numbers/high-score.mdx b/content/docs/numbers/high-score.mdxindex 1433d541..3f153c2e 100644--- a/content/docs/numbers/high-score.mdx+++ b/content/docs/numbers/high-score.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The rank change should read as a real-world leaderboard or product ranking, not a retro arcade — use `rank-climb`."- "You want a single hero number counting up with no table around it — use `combo-counter`."- "The scene needs a calm, premium tone rather than pixel-arcade energy — use `stat-sequence`."+askedAs:+ - "arcade leaderboard"+ - "new high score screen"+ - "I want our launch to look like beating the arcade record"+ - "pixel game scoreboard where our name jumps to the top"+ - "a playful beat saying we just topped the old record"+ - "retro video game moment where the player climbs to first place"---<ComponentPreview name="high-score" />diff --git a/content/docs/numbers/ipo-open.mdx b/content/docs/numbers/ipo-open.mdxindex 21872d2c..bdb2def2 100644--- a/content/docs/numbers/ipo-open.mdx+++ b/content/docs/numbers/ipo-open.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a ticker row with a scrolling tape rather than a market open - use `ticker-tape`."- "The beat is a price change rather than a listing - use `price-slate`."- "A plain headline number needs no market framing - use `compact-stat`."+askedAs:+ - "stock market open bell"+ - "ticker symbol price jump"+ - "I want a launch that looks like a stock exchange opening day"+ - "show a first trade price racing up with a green percent chip"+ - "funding or launch-day announcement dressed as ringing the bell"+ - "viewer feels the excitement of going public on day one"---<ComponentPreview name="ipo-open" />diff --git a/content/docs/numbers/launch-date.mdx b/content/docs/numbers/launch-date.mdxindex dd8bb82a..c6f87e07 100644--- a/content/docs/numbers/launch-date.mdx+++ b/content/docs/numbers/launch-date.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a cursor clicking a day and typing an event into a realistic calendar UI — use `calendar-pick`."- "You want the build-up as a 3-2-1 count instead of a date — use `countdown`."- "The year alone is the message and it should land on a scale — use `ruler-scrub`."+askedAs:+ - "calendar date announcement"+ - "save the date month"+ - "I want a calendar that draws itself and circles our launch day"+ - "reveal the release date on a month grid with a glowing ring"+ - "end of the teaser: tell viewers exactly which day we ship"+ - "date drop moment where one day lights up on the calendar"---<ComponentPreview name="launch-date" />diff --git a/content/docs/numbers/lean-count.mdx b/content/docs/numbers/lean-count.mdxindex 709c65f8..011df896 100644--- a/content/docs/numbers/lean-count.mdx+++ b/content/docs/numbers/lean-count.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The figure is a large integer that should roll like an odometer — use `carry-count`."- "You need a calm static headline number with no motion on the digits — use `compact-stat`."- "Several stats should appear one after another — use `stat-sequence`."+askedAs:+ - "3.2x speed headline"+ - "multiplier counting up"+ - "I want a heavy multiplier number that surges up in steps"+ - "benchmark result as one punchy bold figure with a short label"+ - "the hero result of the video is how many times faster we are"+ - "a speed-up stat that lands with a slanted snapping rhythm"---<ComponentPreview name="lean-count" />diff --git a/content/docs/numbers/level-up.mdx b/content/docs/numbers/level-up.mdxindex 93d45e12..55e4a74e 100644--- a/content/docs/numbers/level-up.mdx+++ b/content/docs/numbers/level-up.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The milestone is a plain version number — use `version-hero`."- "You want a quiet, premium reveal instead of a burst — use `plus-open`."- "The moment is a leaderboard or ranking climb — use `rank-climb`."+askedAs:+ - "xp bar level up"+ - "gaming progress bar"+ - "I want a game-style experience bar that fills and says level up"+ - "frame our major release as unlocking the next level"+ - "milestone moment where chips fly into a bar and the level digit rolls"+ - "viewer feels leveling up in an RPG when the new version lands"---<ComponentPreview name="level-up" />diff --git a/content/docs/numbers/line-cascade.mdx b/content/docs/numbers/line-cascade.mdxindex 45d1b9a4..0f2cd5b5 100644--- a/content/docs/numbers/line-cascade.mdx+++ b/content/docs/numbers/line-cascade.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The number must be readable from the first frame — use `compact-stat`."- "You want the number to count up — use `tall-count`."- "The figure carries a decimal and a multiplier sign — use `lean-count`."+askedAs:+ - "number built from lines"+ - "gradient lines forming digits"+ - "I want a huge figure assembled from falling gradient strokes"+ - "hero stat that feels built from raw material, not faded in"+ - "a big count that piles up from streaks and snaps into place"+ - "dramatic opening number where lines rain down and form the figure"---<ComponentPreview name="line-cascade" />diff --git a/content/docs/numbers/live-ticker.mdx b/content/docs/numbers/live-ticker.mdxindex 8461d21f..36f962e2 100644--- a/content/docs/numbers/live-ticker.mdx+++ b/content/docs/numbers/live-ticker.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a quiet, static figure with no streaming feed — use `compact-stat`."- "You want a count that adds in visible steps with carries — use `carry-count`."- "You want beat-locked steps on a music track — use `beat-count`."+askedAs:+ - "live user counter"+ - "giant ticking number"+ - "I want a huge counter rolling up like it is live with customers streaming in"+ - "show scale with a big comma number and a feed of people above it"+ - "a usage beat where the viewer sees real-time activity piling up"+ - "social proof moment: thousands of users joining while the count climbs"---<ComponentPreview name="live-ticker" />diff --git a/content/docs/numbers/log-rescale.mdx b/content/docs/numbers/log-rescale.mdxindex 24b95f5d..d26797c8 100644--- a/content/docs/numbers/log-rescale.mdx+++ b/content/docs/numbers/log-rescale.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The values are close in size and need no rescale — use `spring-bars`."- "You want a smooth curve through milestones — use `growth-line`."- "You need the last bar to burst through a target line — use `off-the-charts`."+askedAs:+ - "logarithmic bar chart"+ - "340 to 2.4M growth"+ - "I want a bar chart that switches scale so a huge last bar stands out"+ - "show growth by orders of magnitude where early bars are tiny"+ - "growth story where the final number dwarfs the first one"+ - "viewer should grasp how enormous the latest value is next to the start"---<ComponentPreview name="log-rescale" />diff --git a/content/docs/numbers/lumen-count.mdx b/content/docs/numbers/lumen-count.mdxindex 31b14e3d..a98cb076 100644--- a/content/docs/numbers/lumen-count.mdx+++ b/content/docs/numbers/lumen-count.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The number should land with a hard, punchy cut instead of a smooth glow - use `smash-count`."- "You want a chrome, studio-lit look on a figure with a plus sign - use `studio-reflection`."- "Several stats need to count in one beat - use `stat-sequence`."+askedAs:+ - "glowing number"+ - "metric with floor reflection"+ - "I want one big glowing metric on a dark stage with a soft reflection"+ - "show a user count lit up like a spotlight on a shiny floor"+ - "hero stat moment that feels premium and moody"+ - "ending a section on a single luminous figure with a caption below"---<ComponentPreview name="lumen-count" />diff --git a/content/docs/numbers/magnitude-push.mdx b/content/docs/numbers/magnitude-push.mdxindex 8361f68c..4d9dd93c 100644--- a/content/docs/numbers/magnitude-push.mdx+++ b/content/docs/numbers/magnitude-push.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The number is a plain count that should tick up smoothly — use `tall-count`."- "You want the number to appear in one piece — use `compact-stat`."- "The result is a small decimal multiplier — use `lean-count`."+askedAs:+ - "digit by digit zoom out"+ - "1000x scale claim"+ - "I want a number that adds a digit and the camera pulls back each time"+ - "emphasize how many zeros a figure has"+ - "the point is the sheer size, like 10,000, growing step by step"+ - "viewer should feel the number keep getting bigger beyond the frame"---<ComponentPreview name="magnitude-push" />diff --git a/content/docs/numbers/max-q.mdx b/content/docs/numbers/max-q.mdxindex 04618458..e071512e 100644--- a/content/docs/numbers/max-q.mdx+++ b/content/docs/numbers/max-q.mdx@@ -12,6 +12,13 @@ avoidWhen:- "One headline number is enough — use `magnitude-push`."- "You compare two things head to head — use `versus-split`."- "The metrics should read as a market feed — use `ticker-tape`."+askedAs:+ - "rocket launch stats"+ - "speed and altitude readout"+ - "I want two metrics climbing along a rocket trajectory line"+ - "tell a dev tool launch as a space mission with a status at the end"+ - "performance story as mission control with a peak banner flashing"+ - "viewer feels liftoff energy while speed and scale numbers race up"---<ComponentPreview name="max-q" />diff --git a/content/docs/numbers/measure-dim.mdx b/content/docs/numbers/measure-dim.mdxindex 5c2f75b2..b4f7099d 100644--- a/content/docs/numbers/measure-dim.mdx+++ b/content/docs/numbers/measure-dim.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You have more than two values to compare or need categories on an axis — use `benchmark-race`."- "The point is a before-and-after shift per row rather than one measured bar — use `dumbbell-shift`."- "You only need one big counted figure with no comparison — use `compact-stat`."+askedAs:+ - "technical dimension lines"+ - "fps bar comparison"+ - "I want a bar measured with engineering blueprint dimension lines"+ - "show 184 fps beating 60 fps as drawn measurements"+ - "performance beat in a blueprint or CAD drawing style"+ - "viewer sees the frame-rate gap literally measured out"---<ComponentPreview name="measure-dim" />diff --git a/content/docs/numbers/module-count.mdx b/content/docs/numbers/module-count.mdxindex 62326c48..19450c6b 100644--- a/content/docs/numbers/module-count.mdx+++ b/content/docs/numbers/module-count.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You need a smooth rolling, odometer-style count - use `live-ticker`."- "The number should be quiet typography rather than blocky pixels - use `packed-count`."- "The steps should lock to a music tempo - use `beat-count`."+askedAs:+ - "led pixel digits"+ - "retro block number"+ - "I want digits made of chunky pixel blocks that step through values"+ - "a playful stat that looks like an old LED display on a grid"+ - "retro count beat where the number ticks in stepped jumps"+ - "a count with a gridded ground and block-pixel numerals before a short caption"---<ComponentPreview name="module-count" />diff --git a/content/docs/numbers/moire-reveal.mdx b/content/docs/numbers/moire-reveal.mdxindex 12f40d91..a5562bcd 100644--- a/content/docs/numbers/moire-reveal.mdx+++ b/content/docs/numbers/moire-reveal.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The number should count up — use `tall-count`."- "You want a clean, quiet headline stat — use `compact-stat`."- "You want a figure assembled from loose pixels — use `number-mosaic`."+askedAs:+ - "figure emerging from noise"+ - "rotating line pattern number"+ - "I want a number that comes into focus out of spinning interference lines"+ - "speed-up claim resolving from visual static into a crisp figure"+ - "a brand mark or stat that appears out of a hypnotic stripe pattern"+ - "moment where chaos of lines settles and the headline locks sharp"---<ComponentPreview name="moire-reveal" />diff --git a/content/docs/numbers/mvp-card.mdx b/content/docs/numbers/mvp-card.mdxindex d173041e..cde9e0e4 100644--- a/content/docs/numbers/mvp-card.mdx+++ b/content/docs/numbers/mvp-card.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The beat is a ranking against competitors — use `timing-tower`."- "You only need a single stat — use `compact-stat`."- "You want a head-to-head result — use `score-bug`."+askedAs:+ - "sports player card"+ - "mvp award"+ - "I want a trading card slamming open with a giant MVP word and stats"+ - "spotlight a top contributor like an athlete of the season"+ - "celebrate a community member with a sports award card moment"+ - "viewer sees a hero stat card where three numbers count up on a player card"---<ComponentPreview name="mvp-card" />diff --git a/content/docs/numbers/number-mosaic.mdx b/content/docs/numbers/number-mosaic.mdxindex 39a410db..e610ce4b 100644--- a/content/docs/numbers/number-mosaic.mdx+++ b/content/docs/numbers/number-mosaic.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You need a quick, simple stat with no lockup - use `compact-stat`."- "The point is growth over time rather than sheer scale - use `growth-line`."- "The number should read as a pixel-block display - use `module-count`."+askedAs:+ - "sea of digits"+ - "number emerging from data cells"+ - "I want a field of ticking digits where some cells light up to form the figure"+ - "milestone like total renders appearing out of a matrix of numbers"+ - "the headline total emerges from raw data noise then gets a lockup"+ - "viewer feels scale because the number is formed by thousands of small digits"---<ComponentPreview name="number-mosaic" />diff --git a/content/docs/numbers/number-split.mdx b/content/docs/numbers/number-split.mdxindex bd12fca0..738b3521 100644--- a/content/docs/numbers/number-split.mdx+++ b/content/docs/numbers/number-split.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The parts should read as proportions of a whole — use `share-donut`."- "You only have one number — use `compact-stat`."- "The split should shift across years as a stacked bar — use `stacked-shift`."+askedAs:+ - "total broken into categories"+ - "stat splitting into bars"+ - "I want a big total to split into colored bars with their own counts"+ - "show a library count divided by type with labels"+ - "a usage or pricing total that fans out into its parts"+ - "viewer understands what the big number is made of"---<ComponentPreview name="number-split" />diff --git a/content/docs/numbers/off-the-charts.mdx b/content/docs/numbers/off-the-charts.mdxindex ea8059fc..8e05909a 100644--- a/content/docs/numbers/off-the-charts.mdx+++ b/content/docs/numbers/off-the-charts.mdx@@ -12,6 +12,13 @@ avoidWhen:- "Everything fits comfortably on one axis — use `spring-bars`."- "The huge value needs a log rescale to read the smaller bars — use `log-rescale`."- "You want a stepped total of gains and losses — use `waterfall-chart`."+askedAs:+ - "bar breaks the axis"+ - "260% of target"+ - "I want quarterly bars where the last one bursts through the top of the chart"+ - "show we blew past the goal line by a mile"+ - "results moment where the final bar overshoots the target"+ - "viewer feels results are literally off the chart"---<ComponentPreview name="off-the-charts" />diff --git a/content/docs/numbers/packed-count.mdx b/content/docs/numbers/packed-count.mdxindex 6e6e1720..3f54354a 100644--- a/content/docs/numbers/packed-count.mdx+++ b/content/docs/numbers/packed-count.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The figure should lean forward with italic energy - use `lean-count`."- "Trailing digit groups should fade quieter than the first - use `diminuendo`."- "The number should hard-cut upward instead of rolling - use `smash-count`."+askedAs:+ - "views counter tight digits"+ - "downloads number sweep"+ - "I want a counter whose digits pack tightly and gains one digit at a time"+ - "big audience number with a blue color fill sweeping across"+ - "show total replays or downloads reaching a huge round figure"+ - "bragging beat about audience size with a clean caption under"---<ComponentPreview name="packed-count" />diff --git a/content/docs/numbers/pitch-over.mdx b/content/docs/numbers/pitch-over.mdxindex acfbde75..0a0c1dff 100644--- a/content/docs/numbers/pitch-over.mdx+++ b/content/docs/numbers/pitch-over.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a dimension-line comparison of two values - use `measure-dim`."- "The year or version is the star and should be scrubbed to - use `ruler-scrub`."- "A plain count with no scale device is enough - use `compact-stat`."+askedAs:+ - "number above a ruler"+ - "gauge marker on a scale"+ - "I want a count with a marker sliding along a tick ruler under it"+ - "show frames rendered or seconds saved measured on a scale"+ - "a value that should feel gauged against a measuring scale"+ - "viewer sees the number and a pointer settling on the measurement"---<ComponentPreview name="pitch-over" />diff --git a/content/docs/numbers/pixel-bars.mdx b/content/docs/numbers/pixel-bars.mdxindex a4a7325e..a79d83c5 100644--- a/content/docs/numbers/pixel-bars.mdx+++ b/content/docs/numbers/pixel-bars.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want smooth springy bars with an overshoot — use `spring-bars`."- "You need labeled categories on the axis — use `log-rescale`."- "You want a bold stat with no chart — use `compact-stat`."+askedAs:+ - "led bar chart"+ - "retro growth bars"+ - "I want a tiny pixelated bar chart where the last column pops orange and blue"+ - "short growth beat with plus 64 percent in LED style"+ - "retro dashboard moment where the final bar lands a stat"+ - "a nostalgic digital display showing one column outgrowing the rest"---<ComponentPreview name="pixel-bars" />diff --git a/content/docs/numbers/plus-open.mdx b/content/docs/numbers/plus-open.mdxindex d08af25c..2d805623 100644--- a/content/docs/numbers/plus-open.mdx+++ b/content/docs/numbers/plus-open.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a static headline stat — use `compact-stat`."- "You want the count itself to animate — use `tall-count`."- "The next beat is a table of facts — use `spec-sheet`."+askedAs:+ - "number with plus sign opening"+ - "150 plus updates"+ - "I want a count with a plus that swings open like a door"+ - "transition from a number into the release recap first line"+ - "release notes intro: many updates, then the details"+ - "the plus sign becomes the way into the next statement"---<ComponentPreview name="plus-open" />diff --git a/content/docs/numbers/point-hop.mdx b/content/docs/numbers/point-hop.mdxindex f9c23aba..e2c9fc46 100644--- a/content/docs/numbers/point-hop.mdx+++ b/content/docs/numbers/point-hop.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The number is an ordinary count — use `tall-count`."- "You compare two values side by side — use `measure-dim`."- "You want a speed readout with a delta — use `speed-trap`."+askedAs:+ - "decimal point moving"+ - "unit conversion latency"+ - "I want a decimal point hopping between digits to change units"+ - "seconds turning into milliseconds then microseconds"+ - "latency claim where scaling units is the whole story"+ - "viewer watches the value shrink into a tiny time with a metric prefix"---<ComponentPreview name="point-hop" />diff --git a/content/docs/numbers/press-stat.mdx b/content/docs/numbers/press-stat.mdxindex 694ca7bc..6ade22c3 100644--- a/content/docs/numbers/press-stat.mdx+++ b/content/docs/numbers/press-stat.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The headline is a multiplier — use `lean-count`."- "Several stats should appear in a row — use `stat-sequence`."- "The number must sit inside a sentence — use `stat-inline`."+askedAs:+ - "percentage improvement stat"+ - "edit time down 73 percent"+ - "I want a mono caption pressing out beside a big counting percentage"+ - "single improvement claim with a quick count up"+ - "quick stat beat between feature scenes"+ - "show one headline reduction number with a typewriter-like label"---<ComponentPreview name="press-stat" />diff --git a/content/docs/numbers/price-page.mdx b/content/docs/numbers/price-page.mdxindex f0ac60de..124b41a9 100644--- a/content/docs/numbers/price-page.mdx+++ b/content/docs/numbers/price-page.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a receipt that totals to a single line - use `the-tab`."- "The old price should be struck through and replaced - use `price-slate`."- "A single word needs several short glosses instead - use `free-as-in`."+askedAs:+ - "fine print pricing falling away"+ - "free product joke"+ - "I want a pile of pricing tier lines to drop away leaving a huge price"+ - "comedic setup where all the complex plans vanish for one simple price"+ - "pricing beat that sets up the message that it is free"+ - "viewer sees the clutter disappear and one clean price remain"---<ComponentPreview name="price-page" />diff --git a/content/docs/numbers/price-slate.mdx b/content/docs/numbers/price-slate.mdxindex 1763d6a2..aa541d9b 100644--- a/content/docs/numbers/price-slate.mdx+++ b/content/docs/numbers/price-slate.mdx@@ -12,6 +12,13 @@ avoidWhen:- "Dozens of fine-print lines should disappear to leave the price - use `price-page`."- "The beat is a market listing with a ticker - use `ipo-open`."- "The price is a receipt-style total - use `the-tab`."+askedAs:+ - "old price crossed out"+ - "new price digit reels"+ - "I want the old price struck through and a new one spinning in"+ - "price drop reveal with slot machine digits"+ - "launch day offer where the lower price lands with a shine"+ - "viewer sees the discount hit with a satisfying spin"---<ComponentPreview name="price-slate" />diff --git a/content/docs/numbers/quadrant-plot.mdx b/content/docs/numbers/quadrant-plot.mdxindex d46557c2..6712e382 100644--- a/content/docs/numbers/quadrant-plot.mdx+++ b/content/docs/numbers/quadrant-plot.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You compare against one rival across several attributes — use `radar-compare`."- "You need competitors ranked on a single measure — use `rank-climb`."- "You want a numeric before-and-after across many rows — use `dumbbell-shift`."+askedAs:+ - "2x2 competitor map"+ - "positioning matrix"+ - "I want competitors scattered on a two-axis chart and our dot landing top corner"+ - "show we sit in the best quadrant versus alternatives"+ - "market positioning beat comparing us to the field"+ - "viewer sees everyone else clustered while our product claims the ideal spot"---<ComponentPreview name="quadrant-plot" />diff --git a/content/docs/numbers/radar-compare.mdx b/content/docs/numbers/radar-compare.mdxindex ad20cac0..a743802a 100644--- a/content/docs/numbers/radar-compare.mdx+++ b/content/docs/numbers/radar-compare.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You only have one measure to compare and want a bar — use `measure-dim`."- "Competitors should be spread across two axes rather than overlaid on one shape — use `quadrant-plot`."- "You want rows of before and after values — use `dumbbell-shift`."+askedAs:+ - "spider chart comparison"+ - "feature polygon vs competitor"+ - "I want a radar chart where our shape bulges past a competitor outline"+ - "compare strengths across six axes with name and tagline"+ - "feature comparison beat showing we cover more ground"+ - "viewer sees our polygon grow over theirs and dominate"---<ComponentPreview name="radar-compare" />diff --git a/content/docs/numbers/radial-bars.mdx b/content/docs/numbers/radial-bars.mdxindex c5451ab0..e3d48a6a 100644--- a/content/docs/numbers/radial-bars.mdx+++ b/content/docs/numbers/radial-bars.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You show progress toward goals — use `activity-rings`."- "You show a share of a whole — use `share-donut`."- "You show a trend over time as a line — use `sparkline-thread`."+askedAs:+ - "circular bar chart peak"+ - "usage by hour dial"+ - "I want bars arranged around a dial that sweep up to a peak"+ - "show busiest hour or day as a radial chart with a center figure"+ - "rhythmic metric where the peak is the headline"+ - "viewer sees a clock-like chart and the center number counting up"---<ComponentPreview name="radial-bars" />diff --git a/content/docs/numbers/rank-climb.mdx b/content/docs/numbers/rank-climb.mdxindex da1239b3..22988e58 100644--- a/content/docs/numbers/rank-climb.mdx+++ b/content/docs/numbers/rank-climb.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You show a live race with gaps and laps — use `timing-tower`."- "You show a new top entry in an arcade table — use `high-score`."- "You show growth over time on a curve — use `growth-line`."+askedAs:+ - "leaderboard climbing to first"+ - "product of the day number one"+ - "I want a ranked list reordering as we rise to the top spot"+ - "show launch day ranking with vote counts climbing"+ - "beat showing our product reaching number one on a chart"+ - "viewer cheers as other entries get overtaken one by one"---<ComponentPreview name="rank-climb" />diff --git a/content/docs/numbers/raster-paint.mdx b/content/docs/numbers/raster-paint.mdxindex 36a4a5ce..48a4812e 100644--- a/content/docs/numbers/raster-paint.mdx+++ b/content/docs/numbers/raster-paint.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You need a crisp, clean stat from the first frame — use `compact-stat`."- "The figure should assemble out of loose squares — use `number-mosaic`."- "The reveal should scrub a ruler to a year — use `ruler-scrub`."+askedAs:+ - "pixelated number being painted"+ - "scan line render"+ - "I want a blocky figure painted in tile by tile by a sweeping scan line"+ - "big multiplier that looks like it is rendering on screen"+ - "render speed claim where the number visibly draws itself in pixels"+ - "warm to blue colors filling a pixelated 10x"---<ComponentPreview name="raster-paint" />diff --git a/content/docs/numbers/res-climb.mdx b/content/docs/numbers/res-climb.mdxindex a2b3c7d1..c3567f71 100644--- a/content/docs/numbers/res-climb.mdx+++ b/content/docs/numbers/res-climb.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You need the digits to roll from a lower value to a higher one - use `packed-count`."- "The figure should resolve out of a line pattern instead of pixels - use `moire-reveal`."- "You want a painted, tile-by-tile pixel reveal - use `raster-paint`."+askedAs:+ - "pixelated to sharp number"+ - "resolution upgrade effect"+ - "I want a number resolving from chunky blocks into a crisp glowing figure"+ - "beat about quality or fidelity where the figure sharpens into focus"+ - "a count that gains resolution as it appears"+ - "viewer feels the picture getting clearer from coarse to HD"---<ComponentPreview name="res-climb" />diff --git a/content/docs/numbers/ridgeline.mdx b/content/docs/numbers/ridgeline.mdxindex 5e817b6e..57813daa 100644--- a/content/docs/numbers/ridgeline.mdx+++ b/content/docs/numbers/ridgeline.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You have only two groups to compare — use `beeswarm`."- "You want flowing layers that change over time — use `streamgraph`."- "You need one before-and-after curve — use `distribution-shift`."+askedAs:+ - "joyplot distributions"+ - "stacked mountain chart over years"+ - "I want stacked distribution curves per year with the latest lit up"+ - "before and after across several periods, newest in gradient"+ - "show a shift in distribution with a 2.6x callout"+ - "viewer sees old years faded and the newest ridge standing out"---<ComponentPreview name="ridgeline" />diff --git a/content/docs/numbers/roman-edition.mdx b/content/docs/numbers/roman-edition.mdxindex 794d086d..9a623310 100644--- a/content/docs/numbers/roman-edition.mdx+++ b/content/docs/numbers/roman-edition.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The number is a plain software version — use `version-hero`."- "The number counts down to a date — use `countdown`."- "The figure is an ordinary large count — use `carry-count`."+askedAs:+ - "roman numeral count"+ - "edition number banner"+ - "I want a giant Roman numeral counting up on a colored band"+ - "show a numbered launch week or release series like an edition"+ - "recurring announcement where the issue number is the hero"+ - "viewer feels a series with history like volume or edition numbers"---<ComponentPreview name="roman-edition" />diff --git a/content/docs/numbers/row-count.mdx b/content/docs/numbers/row-count.mdxindex edd892f3..252c978c 100644--- a/content/docs/numbers/row-count.mdx+++ b/content/docs/numbers/row-count.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The number is small and needs no stacked rows - use `compact-stat`."- "You want trailing groups to fade quieter than the lead group - use `diminuendo`."- "The count should tick like a live feed - use `live-ticker`."+askedAs:+ - "millions counter ruled rows"+ - "large number digit groups"+ - "I want a very large figure rolling up across stacked ruled rows"+ - "show millions of frames rendered with rows added per thousands group"+ - "scale moment where the grouping of digits is part of the story"+ - "viewer sees a ledger-like count climbing into the millions"---<ComponentPreview name="row-count" />diff --git a/content/docs/numbers/ruler-scrub.mdx b/content/docs/numbers/ruler-scrub.mdxindex f4366b5e..580037b4 100644--- a/content/docs/numbers/ruler-scrub.mdx+++ b/content/docs/numbers/ruler-scrub.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The target is a calendar date rather than a single number — use `launch-date`."- "You want a number counting up with digits rolling, not a scale scrubbing under a marker — use `compact-stat`."- "You want a mission-clock countdown to zero — use `t-minus`."+askedAs:+ - "year reveal measuring tape"+ - "ruler slowing to a number"+ - "I want a ruler scrolling past ticks and slowing to land on 2026"+ - "version or year reveal with a decelerating scrub"+ - "headline number found by sliding along a scale"+ - "viewer watches ticks blur by then settle on the year"---<ComponentPreview name="ruler-scrub" />diff --git a/content/docs/numbers/sankey-flow.mdx b/content/docs/numbers/sankey-flow.mdxindex f1d22ded..82d0229d 100644--- a/content/docs/numbers/sankey-flow.mdx+++ b/content/docs/numbers/sankey-flow.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want shares of a whole as a percentage — use `share-donut`."- "You want the parts as rectangles sized by value — use `treemap-split`."- "You want one headline metric with no breakdown — use `compact-stat`."+askedAs:+ - "sources merging into one total"+ - "flow diagram channels"+ - "I want flows from several sources merging into a single block"+ - "show different channels adding up to 12.4k videos"+ - "a beat showing many inputs combining into one outcome"+ - "viewer sees streams join and the total light up at the end"---<ComponentPreview name="sankey-flow" />diff --git a/content/docs/numbers/score-bug.mdx b/content/docs/numbers/score-bug.mdxindex b091f22c..b4df5f7d 100644--- a/content/docs/numbers/score-bug.mdx+++ b/content/docs/numbers/score-bug.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a plain animated number with no sports framing — use `combo-counter`."- "The comparison is a diagonal two-sided layout with stat rows for time and cost — use `versus-split`."- "The video is serious or enterprise in tone, where a sports metaphor would feel off — use `timer-duel`."+askedAs:+ - "sports broadcast scoreboard"+ - "full time result 2-0"+ - "I want a TV match score overlay showing we beat the old way"+ - "launch framed as a game result versus the competition"+ - "a final-score moment where the product wins"+ - "viewer feels the thrill of a broadcast scoreline ending in our favour"---<ComponentPreview name="score-bug" />diff --git a/content/docs/numbers/shape-pack.mdx b/content/docs/numbers/shape-pack.mdxindex eefec212..9b5edf64 100644--- a/content/docs/numbers/shape-pack.mdx+++ b/content/docs/numbers/shape-pack.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a clean headline number — use `compact-stat`."- "You want a gradient number snapped onto a grid with a headline — use `grid-snap-poster`."- "You want to break a total into categories — use `number-split`."+askedAs:+ - "poster style collage stat"+ - "colored tiles packing"+ - "I want bold colored blocks dropping into a poster grid with one stat"+ - "multiplier result with a logo inside the locking tile"+ - "collage-look stat beat with a graphic poster feel"+ - "viewer sees shapes tetris into place and one block reveals the number"---<ComponentPreview name="shape-pack" />diff --git a/content/docs/numbers/share-donut.mdx b/content/docs/numbers/share-donut.mdxindex adde5bdb..c2973b56 100644--- a/content/docs/numbers/share-donut.mdx+++ b/content/docs/numbers/share-donut.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want rectangles sized by value with room for labels — use `treemap-split`."- "You want shares shifting across several years — use `stacked-shift`."- "You want loose bubbles instead of a ring — use `bubble-pack`."+askedAs:+ - "market share pie chart"+ - "38 percent donut"+ - "I want a gradient donut sweeping to a share with competitors labeled"+ - "show one slice as the headline of a market share beat"+ - "poll or survey result with the winning slice highlighted"+ - "viewer sees a ring fill to 38 percent and compare against rivals"---<ComponentPreview name="share-donut" />diff --git a/content/docs/numbers/shot-clock.mdx b/content/docs/numbers/shot-clock.mdxindex 858cb169..970358ed 100644--- a/content/docs/numbers/shot-clock.mdx+++ b/content/docs/numbers/shot-clock.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a rocket-launch style mission clock with telemetry — use `t-minus`."- "You want the big cinematic 3-2-1 numerals instead of a scoreboard clock — use `countdown`."- "The clock should freeze on a lap time with a delta, not run to zero — use `split-flash`."+askedAs:+ - "basketball countdown red"+ - "buzzer beater shipped"+ - "I want a shot clock counting down to zero then the word shipped"+ - "deadline beat framed as a last-second basketball finish"+ - "countdown that turns red in tenths of a second"+ - "viewer feels the tension of a buzzer and relief when we make it"---<ComponentPreview name="shot-clock" />diff --git a/content/docs/numbers/single-stroke.mdx b/content/docs/numbers/single-stroke.mdxindex 0a52984c..c7c6f95a 100644--- a/content/docs/numbers/single-stroke.mdx+++ b/content/docs/numbers/single-stroke.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a full calendar drawn and the launch day highlighted — use `launch-date`."- "You want the number to count up rather than be drawn — use `compact-stat`."- "You want a sports-broadcast or arcade feel for the figure — use `high-score`."+askedAs:+ - "hand drawn giant numeral"+ - "date on teal panel"+ - "I want a huge number drawn in one continuous pen line"+ - "demo day date reveal with a coral month panel"+ - "a date or number reveal that feels sketched in a single stroke"+ - "viewer sees a loose hand-lettered 27 next to the event info"---<ComponentPreview name="single-stroke" />diff --git a/content/docs/numbers/slim-count.mdx b/content/docs/numbers/slim-count.mdxindex 891df964..5b239365 100644--- a/content/docs/numbers/slim-count.mdx+++ b/content/docs/numbers/slim-count.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The count rises to a big achievement figure - use `tall-count`."- "You want a literal timer ticking to zero - use `shot-clock`."- "The number should hard-cut rather than drain smoothly - use `smash-count`."+askedAs:+ - "countdown outlined numeral"+ - "wavy liquid draining number"+ - "I want a thin outline number counting down as liquid drains out of it"+ - "show work removed down to zero like keyframes left to do by hand"+ - "playful countdown ending on zero with a condensed label"+ - "viewer watches the effort number empty out to nothing"---<ComponentPreview name="slim-count" />diff --git a/content/docs/numbers/slope-chart.mdx b/content/docs/numbers/slope-chart.mdxindex b3ac599d..5b78bccd 100644--- a/content/docs/numbers/slope-chart.mdx+++ b/content/docs/numbers/slope-chart.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want each row's before and after as dots on a track — use `dumbbell-shift`."- "You have more than two time points — use `stacked-shift`."- "You want the improvement as a single curve — use `growth-line`."+askedAs:+ - "before after line chart"+ - "6.8x rising line"+ - "I want two time points joined by lines with our line shooting up"+ - "before and after across two periods, one line far above the rest"+ - "claim backed by a slope where the hero line climbs to 6.8x"+ - "viewer sees most lines barely move while ours rises steeply"---<ComponentPreview name="slope-chart" />diff --git a/content/docs/numbers/smash-count.mdx b/content/docs/numbers/smash-count.mdxindex 514972fb..720cccd3 100644--- a/content/docs/numbers/smash-count.mdx+++ b/content/docs/numbers/smash-count.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a smooth, glowing count - use `lumen-count`."- "The number should pause on each reading in blocky steps - use `module-count`."- "A sticker-style outlined number is the look - use `fuchidori-count`."+askedAs:+ - "slammed number reveal"+ - "hard cut counter"+ - "I want a giant numeral that hard-cuts through bigger values and slams in"+ - "punchy stat like scenes made, snapping into place with a small caption"+ - "a bold number beat with no easing, just impact"+ - "viewer feels a percussive cut-by-cut climb to the final number"---<ComponentPreview name="smash-count" />diff --git a/content/docs/numbers/sparkline-thread.mdx b/content/docs/numbers/sparkline-thread.mdxindex 781841bf..e7fb9ccf 100644--- a/content/docs/numbers/sparkline-thread.mdx+++ b/content/docs/numbers/sparkline-thread.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a full chart with milestones and a big endpoint — use `growth-line`."- "You want labeled bars rather than a line — use `spring-bars`."- "You want the chart to reshape into something else — use `chart-morph`."+askedAs:+ - "glowing trend line"+ - "plus 212 percent growth"+ - "I want a glowing line climbing to a dot with a percent stat counting beside it"+ - "compact growth beat with a thin trend line"+ - "weekly or monthly growth shown as a little glowing chart"+ - "viewer sees a trend end on a point and the gain tick up"---<ComponentPreview name="sparkline-thread" />diff --git a/content/docs/numbers/spec-sheet.mdx b/content/docs/numbers/spec-sheet.mdxindex 1cbba2ad..e7e85388 100644--- a/content/docs/numbers/spec-sheet.mdx+++ b/content/docs/numbers/spec-sheet.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You compare two options side by side — use `versus-split`."- "Only one number matters — use `compact-stat`."- "The numbers should count up one after another — use `stat-sequence`."+askedAs:+ - "product specs table"+ - "hairline rows facts"+ - "I want a clean specs list that reveals values one by one"+ - "a beat listing resolution, frame rate and license"+ - "technical summary where one row expands as the highlight"+ - "viewer reads a spec sheet and one key value gets featured"---<ComponentPreview name="spec-sheet" />diff --git a/content/docs/numbers/speed-trap.mdx b/content/docs/numbers/speed-trap.mdxindex 552e00c2..d4ea66d1 100644--- a/content/docs/numbers/speed-trap.mdx+++ b/content/docs/numbers/speed-trap.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a single quiet figure with no bar or comparison — use `compact-stat`."- "The comparison is between two timers racing each other — use `timer-duel`."- "The value is a percentage or a score on a dial rather than a speed — use `radial-bars`."+askedAs:+ - "top speed readout"+ - "348 km/h delta"+ - "I want a speed gauge locking on our top number over a segmented bar"+ - "show a performance record versus last year with a marker"+ - "racing style speed readout with the gain highlighted"+ - "viewer sees the readout lock and a delta against the previous best"---<ComponentPreview name="speed-trap" />diff --git a/content/docs/numbers/split-flash.mdx b/content/docs/numbers/split-flash.mdxindex fe76c4f4..3e3f5908 100644--- a/content/docs/numbers/split-flash.mdx+++ b/content/docs/numbers/split-flash.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want two clocks racing each other with a multiplier — use `timer-duel`."- "You want a shot-clock style countdown to a buzzer with a title — use `shot-clock`."- "You want a readout that locks on a speed against a bar and last year's mark — use `speed-trap`."+askedAs:+ - "lap time purple sector"+ - "stopwatch freeze delta"+ - "I want a lap clock that races then freezes with a purple flash and minus delta"+ - "record-time beat in a motorsport timing style"+ - "show we cut our time and got the fastest lap"+ - "viewer sees a purple bar flash meaning a personal best"---<ComponentPreview name="split-flash" />diff --git a/content/docs/numbers/spring-bars.mdx b/content/docs/numbers/spring-bars.mdxindex 7ed95bb7..856f55a0 100644--- a/content/docs/numbers/spring-bars.mdx+++ b/content/docs/numbers/spring-bars.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You need labeled category axes and real units — use `log-rescale`."- "You want an LED, retro bar style — use `pixel-bars`."- "You want a bar that breaks through a target — use `off-the-charts`."+askedAs:+ - "bouncy bar chart"+ - "one winning bar highlighted"+ - "I want bars that spring up with overshoot and one gradient winner"+ - "compare several options where ours is strongest at 3.4x"+ - "a comparison where one bar clearly wins"+ - "viewer feels a lively chart and the best option glowing"---<ComponentPreview name="spring-bars" />diff --git a/content/docs/numbers/stacked-shift.mdx b/content/docs/numbers/stacked-shift.mdxindex 3345f96c..d85aab4e 100644--- a/content/docs/numbers/stacked-shift.mdx+++ b/content/docs/numbers/stacked-shift.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You only have one moment in time — use `share-donut`."- "You want a flowing layered area over time — use `streamgraph`."- "You want two time points with a line per item — use `slope-chart`."+askedAs:+ - "market share over years"+ - "stacked bar shifting to 52 percent"+ - "I want a stacked share bar that changes over years until we lead"+ - "show our logo series growing past half of the market"+ - "story of one segment taking over across time"+ - "viewer watches the shares shift and ours grow to majority"---<ComponentPreview name="stacked-shift" />diff --git a/content/docs/numbers/stat-inline.mdx b/content/docs/numbers/stat-inline.mdxindex c44a0d71..2bc19376 100644--- a/content/docs/numbers/stat-inline.mdx+++ b/content/docs/numbers/stat-inline.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The number alone is the message — use `compact-stat`."- "Several stats should appear in turn — use `stat-sequence`."- "The number should count up — use `tall-count`."+askedAs:+ - "number in a sentence"+ - "statement with highlighted figure"+ - "I want the number to appear alone then slide into a sentence"+ - "builders shipped 12,480 videos, with the number kept in context"+ - "a statement stat where the figure leads and words rise around it"+ - "viewer reads the full claim after the number has its moment"---<ComponentPreview name="stat-inline" />diff --git a/content/docs/numbers/stat-rail.mdx b/content/docs/numbers/stat-rail.mdxindex 8ff21950..e489b2ec 100644--- a/content/docs/numbers/stat-rail.mdx+++ b/content/docs/numbers/stat-rail.mdx@@ -12,6 +12,13 @@ avoidWhen:- "Each stat should count up big, one per beat — use `stat-sequence`."- "Only one headline number is needed — use `compact-stat`."- "You have no image and want a plain table — use `spec-sheet`."+askedAs:+ - "headline with stats sidebar"+ - "proof stats beside photo"+ - "I want a headline card shrinking over a photo while stats step in on the side"+ - "launch recap with up to four proof numbers"+ - "a proof beat where numbers step through next to the message"+ - "viewer sees scenery behind and a column of numbers listing results"---<ComponentPreview name="stat-rail" />diff --git a/content/docs/numbers/stat-sequence.mdx b/content/docs/numbers/stat-sequence.mdxindex 9124d910..09dc0e4c 100644--- a/content/docs/numbers/stat-sequence.mdx+++ b/content/docs/numbers/stat-sequence.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You have only one stat — use `compact-stat`."- "The stats should sit beside a headline and photo — use `stat-rail`."- "You list facts as a table — use `spec-sheet`."+askedAs:+ - "three stats in a row"+ - "social proof numbers"+ - "I want three big numbers cutting in one after another then forming a row"+ - "a numbers recap closing the product video"+ - "show two to four headline stats as quick social proof"+ - "viewer gets a rapid-fire summary of results that collapse together"---<ComponentPreview name="stat-sequence" />diff --git a/content/docs/numbers/stem-stretch.mdx b/content/docs/numbers/stem-stretch.mdxindex 4584aca2..9990990c 100644--- a/content/docs/numbers/stem-stretch.mdx+++ b/content/docs/numbers/stem-stretch.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a clean number with no stretching — use `compact-stat`."- "You want a glossy pill that holds a word inside the number — use `zero-stretch`."- "You want a weight change on a counting figure — use `weight-cut`."+askedAs:+ - "tall striped numerals"+ - "hours saved every week"+ - "I want the strokes of a number to stretch into tall gradient stripes"+ - "time-saved claim like 4 hours back each week"+ - "text-forward stat with a dramatic vertical stretch"+ - "viewer sees a figure elongate into color bars before the caption"---<ComponentPreview name="stem-stretch" />diff --git a/content/docs/numbers/streamgraph.mdx b/content/docs/numbers/streamgraph.mdxindex ab277e65..02b50ace 100644--- a/content/docs/numbers/streamgraph.mdx+++ b/content/docs/numbers/streamgraph.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You need exact values at a few time points — use `stacked-shift`."- "You want separate distribution rows per period — use `ridgeline`."- "You only have one snapshot of shares — use `share-donut`."+askedAs:+ - "flowing layers chart"+ - "48 percent share wave"+ - "I want stacked flowing layers across time with one layer swelling"+ - "a trend over time where one band becomes the headline share"+ - "market or usage trend drawn as organic waves"+ - "viewer sees smooth bands rise and one grows into a 48 percent claim"---<ComponentPreview name="streamgraph" />diff --git a/content/docs/numbers/stripe-count.mdx b/content/docs/numbers/stripe-count.mdxindex 003898c5..fa1c1fdf 100644--- a/content/docs/numbers/stripe-count.mdx+++ b/content/docs/numbers/stripe-count.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a quiet, dark stage rather than a full-bleed color - use `lumen-count`."- "The big number should be framed by a yellow band with a roman numeral - use `roman-edition`."- "The number belongs on a teal panel with gear steps - use `gear-shift`."+askedAs:+ - "bold color field number"+ - "striped outline counter"+ - "I want a loud full-screen brand color with a number filling with stripes"+ - "a count that fills its outline with stripes under a caption band"+ - "loud brand colored stat beat where the whole frame is the accent"+ - "viewer gets a poster-like punchy statistic"---<ComponentPreview name="stripe-count" />diff --git a/content/docs/numbers/studio-reflection.mdx b/content/docs/numbers/studio-reflection.mdxindex 0d03c694..81430250 100644--- a/content/docs/numbers/studio-reflection.mdx+++ b/content/docs/numbers/studio-reflection.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The number should count up with a glow — use `lumen-count`."- "You need a plain stat with no effects — use `compact-stat`."- "The figure is a release version — use `version-hero`."+askedAs:+ - "chrome number on glossy floor"+ - "premium hero stat"+ - "I want a metallic number catching sweeping light over a reflective floor"+ - "product shot style figure like library size with an eyebrow label"+ - "premium milestone count that looks like a studio photo"+ - "viewer sees expensive lighting glide across a polished figure"---<ComponentPreview name="studio-reflection" />diff --git a/content/docs/numbers/t-minus.mdx b/content/docs/numbers/t-minus.mdxindex df4da2ff..b1833983 100644--- a/content/docs/numbers/t-minus.mdx+++ b/content/docs/numbers/t-minus.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want large cinematic 3-2-1 numerals with ring and slice transitions — use `countdown`."- "You want a sports shot clock with tenths and a buzzer — use `shot-clock`."- "The countdown is toward a calendar date, not zero — use `launch-date`."+askedAs:+ - "rocket countdown liftoff"+ - "mission clock"+ - "I want a T-minus countdown ticking to zero then LIFTOFF slamming in"+ - "release day framed as a launch sequence with a sunrise glow"+ - "a release beat with rolling characters counting to ignition"+ - "viewer feels space launch drama as we go live"---<ComponentPreview name="t-minus" />diff --git a/content/docs/numbers/tall-count.mdx b/content/docs/numbers/tall-count.mdxindex b07d8ddd..eaa7a6ff 100644--- a/content/docs/numbers/tall-count.mdx+++ b/content/docs/numbers/tall-count.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The headline is a multiplier — use `lean-count`."- "The figure is a huge raw count — use `carry-count`."- "The number sits inside a sentence — use `stat-inline`."+askedAs:+ - "condensed tall percent"+ - "plus 240 percent growth"+ - "I want a tall narrow figure counting up beside a short caption"+ - "percentage gain headline with a stretch and lift"+ - "growth claim with a short supporting line"+ - "viewer sees a skyscraper-like number open up and settle"---<ComponentPreview name="tall-count" />diff --git a/content/docs/numbers/tally-marks.mdx b/content/docs/numbers/tally-marks.mdxindex 81c2d1db..09f3b5fb 100644--- a/content/docs/numbers/tally-marks.mdx+++ b/content/docs/numbers/tally-marks.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You need the number to arrive fast and clean - use `compact-stat`."- "The number should be built from drawn pen strokes of its own digits - use `single-stroke`."- "A pixel field organizing into the number is the look - use `number-mosaic`."+askedAs:+ - "hand drawn tally count"+ - "five-bar gate marks"+ - "I want scratch tally marks filling rows and resolving into a total"+ - "a count earned one stroke at a time, paper and hand-made"+ - "launch day total shown as marks counting up"+ - "viewer feels the effort of counting by hand before the number appears"---<ComponentPreview name="tally-marks" />diff --git a/content/docs/numbers/the-tab.mdx b/content/docs/numbers/the-tab.mdxindex 53911a07..90e8af9b 100644--- a/content/docs/numbers/the-tab.mdx+++ b/content/docs/numbers/the-tab.mdx@@ -12,6 +12,13 @@ avoidWhen:- "Fine print should be removed one line at a time - use `price-page`."- "A single price needs a strikethrough and a spin - use `price-slate`."- "A technical spec table with hairline rows is the look - use `spec-sheet`."+askedAs:+ - "receipt with dotted leaders"+ - "everything costs zero"+ - "I want a receipt where every item has the same price then a total"+ - "what-you-get list where each line is free"+ - "pricing close showing all included items at zero"+ - "viewer sees a long bill that ends at nothing to pay"---<ComponentPreview name="the-tab" />diff --git a/content/docs/numbers/thin-slab.mdx b/content/docs/numbers/thin-slab.mdxindex 93920c71..190aaf1f 100644--- a/content/docs/numbers/thin-slab.mdx+++ b/content/docs/numbers/thin-slab.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a bar race between several contenders on a shared clock — use `benchmark-race`."- "The two values should be two live stopwatches rather than a shrinking slab — use `timer-duel`."- "You need a single big counted number with no comparison shape — use `compact-stat`."+askedAs:+ - "14x faster than by hand"+ - "thick bar squeezed thin"+ - "I want a thick slab for the old time shrinking to a thin one for the new"+ - "time-saved beat comparing one day against minutes"+ - "show duration drastically reduced with a squeezed bar"+ - "viewer sees a big 1 day contrasted with a sliver labeled faster"---<ComponentPreview name="thin-slab" />diff --git a/content/docs/numbers/thread-weave.mdx b/content/docs/numbers/thread-weave.mdxindex 568d34be..b9557e46 100644--- a/content/docs/numbers/thread-weave.mdx+++ b/content/docs/numbers/thread-weave.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a clean digital stat — use `compact-stat`."- "You want a figure made of loose pixels — use `number-mosaic`."- "You want a hand-drawn counting feel — use `tally-marks`."+askedAs:+ - "woven number loom"+ - "knit logo reveal"+ - "I want a figure woven row by row like fabric on a loom"+ - "craft-flavoured stat that looks stitched together"+ - "brand mark reveal made of cream-colored woven cells"+ - "viewer sees a handmade textile feeling as the pattern builds"---<ComponentPreview name="thread-weave" />diff --git a/content/docs/numbers/ticker-tape.mdx b/content/docs/numbers/ticker-tape.mdxindex b5f4fff3..a0b86630 100644--- a/content/docs/numbers/ticker-tape.mdx+++ b/content/docs/numbers/ticker-tape.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The beat is an IPO price print — use `ipo-open`."- "You show a price rally on a chart — use `candle-rally`."- "You want a rolling live counter — use `live-ticker`."+askedAs:+ - "scrolling stock quotes"+ - "fake market ticker poster"+ - "I want bands of stock quotes scrolling and braking on our symbol"+ - "funding or valuation moment told as a market quote"+ - "a fictional ticker as the hero of a launch announcement"+ - "viewer sees quotes zoom by then one symbol scales into a price poster"---<ComponentPreview name="ticker-tape" />diff --git a/content/docs/numbers/time-breakdown.mdx b/content/docs/numbers/time-breakdown.mdxindex 32aaccf4..b5b20f49 100644--- a/content/docs/numbers/time-breakdown.mdx+++ b/content/docs/numbers/time-breakdown.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You have a single bar and a single percentage — use `cut-stat`."- "You want the comparison framed as a race — use `benchmark-race`."- "You want each row's before and after as dots — use `dumbbell-shift`."+askedAs:+ - "workflow segments shrinking"+ - "56 percent less time"+ - "I want a segmented time bar whose editing, rendering and export parts shrink"+ - "time-saved claim showing which steps got shorter"+ - "show the process stages getting visibly smaller with a percent count"+ - "viewer sees the bar contract while the saving counts up"---<ComponentPreview name="time-breakdown" />diff --git a/content/docs/numbers/timer-duel.mdx b/content/docs/numbers/timer-duel.mdxindex 0929e935..758f447a 100644--- a/content/docs/numbers/timer-duel.mdx+++ b/content/docs/numbers/timer-duel.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The two values should be shown as one slab that physically squeezes — use `thin-slab`."- "You need more than two contenders racing on a shared clock — use `benchmark-race`."- "You want a sports-broadcast framing with a final scoreline — use `score-bug`."+askedAs:+ - "two stopwatches racing"+ - "38x faster comparison"+ - "I want two stopwatches starting together and ours stops first"+ - "speed comparison with the faster timer ending on a multiplier"+ - "show the slow way against our way in a race"+ - "viewer sees one clock keep running while ours finishes"---<ComponentPreview name="timer-duel" />diff --git a/content/docs/numbers/times-turn.mdx b/content/docs/numbers/times-turn.mdxindex ba70bf40..2508d9f2 100644--- a/content/docs/numbers/times-turn.mdx+++ b/content/docs/numbers/times-turn.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want the multiplier to count up — use `lean-count`."- "The claim is a percentage — use `press-stat`."- "You want a plain stat with no turn — use `compact-stat`."+askedAs:+ - "percent turning into multiply sign"+ - "3x multiplier"+ - "I want a percent sign to flip into a times sign and the figure swell"+ - "multiplier claim like 3x where the unit changes from percent"+ - "a turn from percentage thinking to times faster"+ - "viewer sees the symbol rotate and the number grow"---<ComponentPreview name="times-turn" />diff --git a/content/docs/numbers/timing-tower.mdx b/content/docs/numbers/timing-tower.mdxindex 02e2b0d8..5d03c7f4 100644--- a/content/docs/numbers/timing-tower.mdx+++ b/content/docs/numbers/timing-tower.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You rank products in a plain list — use `rank-climb`."- "Two timers race side by side — use `timer-duel`."- "A single lap time should freeze with a delta — use `split-flash`."+askedAs:+ - "f1 leaderboard"+ - "racing positions overtakes"+ - "I want a motorsport timing tower reordering until we reach P1"+ - "we-moved-up-the-ranking beat with a race feel"+ - "competitive comparison as overtakes lap by lap"+ - "viewer sees the tower shuffle and we end on top with the gap shown"---<ComponentPreview name="timing-tower" />diff --git a/content/docs/numbers/treemap-split.mdx b/content/docs/numbers/treemap-split.mdxindex 8f3254d4..b70e543e 100644--- a/content/docs/numbers/treemap-split.mdx+++ b/content/docs/numbers/treemap-split.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a ring with a single percentage in the center — use `share-donut`."- "You want free-floating bubbles instead of tiles — use `bubble-pack`."- "You want shares changing across years — use `stacked-shift`."+askedAs:+ - "rectangle breakdown tiles"+ - "biggest category 38 percent"+ - "I want a block that splits into category tiles with the biggest highlighted"+ - "usage or catalog breakdown with one category as the headline"+ - "show proportions as nested rectangles"+ - "viewer sees the whole subdivided and one tile glowing"---<ComponentPreview name="treemap-split" />diff --git a/content/docs/numbers/unit-grid.mdx b/content/docs/numbers/unit-grid.mdxindex 2d5a2211..d0458ef2 100644--- a/content/docs/numbers/unit-grid.mdx+++ b/content/docs/numbers/unit-grid.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You compare shares among competitors — use `share-donut`."- "You want a hex-cell fill with a percent reading — use `hex-fill`."- "You just need a big plain stat — use `compact-stat`."+askedAs:+ - "dots grid share"+ - "1 in 3 people"+ - "I want a grid of dots where a portion lights up for a share"+ - "show 33 percent as a countable number of dots"+ - "a proportion that should feel like individual people"+ - "viewer sees one in three highlighted among many dots with a caption"---<ComponentPreview name="unit-grid" />diff --git a/content/docs/numbers/uptime-strip.mdx b/content/docs/numbers/uptime-strip.mdxindex 3d44b16b..55ac21d5 100644--- a/content/docs/numbers/uptime-strip.mdx+++ b/content/docs/numbers/uptime-strip.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You show a metric climbing over time — use `sparkline-thread`."- "You show activity over a calendar — use `contribution-heatmap`."- "You only need the number — use `compact-stat`."+askedAs:+ - "status page uptime bar"+ - "99.99 percent reliability"+ - "I want a strip of green ticks with a few incident bars and an uptime figure"+ - "reliability proof for an API or hosting product"+ - "status-page style evidence over many days"+ - "viewer sees days pass green and the uptime number typed out"---<ComponentPreview name="uptime-strip" />diff --git a/content/docs/numbers/version-hero.mdx b/content/docs/numbers/version-hero.mdxindex bc680d1d..97e5e148 100644--- a/content/docs/numbers/version-hero.mdx+++ b/content/docs/numbers/version-hero.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The number is an edition counter — use `roman-edition`."- "The headline is a statistic — use `compact-stat`."- "You want a gradient number snapped onto a poster grid — use `grid-snap-poster`."+askedAs:+ - "version number reveal"+ - "2.0 release announcement"+ - "I want a chrome numeral built from slices docking inside a glowing disc"+ - "release announcement where the version is the hero"+ - "a major version close with a light sweep and label"+ - "viewer sees the new version assemble and glow as the finale"---<ComponentPreview name="version-hero" />diff --git a/content/docs/numbers/versus-split.mdx b/content/docs/numbers/versus-split.mdxindex 00a6bb33..93c608f4 100644--- a/content/docs/numbers/versus-split.mdx+++ b/content/docs/numbers/versus-split.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The contest should read as a football-style scoreline — use `score-bug`."- "You only compare one measurement on a shared axis — use `measure-dim`."- "You compare across many attributes at once and want an overlay shape — use `radar-compare`."+askedAs:+ - "us vs old way diagonal"+ - "head to head comparison"+ - "I want a diagonal split pitting the product against the old way"+ - "a tale of the tape with time, cost and rounds rows"+ - "show our stats against the manual approach side by side"+ - "viewer sees two sides clash and ours win each metric"---<ComponentPreview name="versus-split" />diff --git a/content/docs/numbers/waterfall-chart.mdx b/content/docs/numbers/waterfall-chart.mdxindex 788934be..f66b7484 100644--- a/content/docs/numbers/waterfall-chart.mdx+++ b/content/docs/numbers/waterfall-chart.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You have simple category values with no running total — use `spring-bars`."- "You want the total framed as a share of a whole — use `share-donut`."- "You want a trend over time — use `growth-line`."+askedAs:+ - "revenue bridge"+ - "mrr gains and losses"+ - "I want a waterfall where gains and losses step up to a total of 84k MRR"+ - "show how revenue builds from start to end value"+ - "a metric bridge ending in a gradient total"+ - "viewer follows each step up or down until the final figure"---<ComponentPreview name="waterfall-chart" />diff --git a/content/docs/numbers/weight-cut.mdx b/content/docs/numbers/weight-cut.mdxindex cb6d939f..773c1692 100644--- a/content/docs/numbers/weight-cut.mdx+++ b/content/docs/numbers/weight-cut.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The number should grow rather than shrink - use `lean-count`."- "You want a draining tank effect for a countdown - use `slim-count`."- "A tall, condensed gradient figure suits the brand better - use `tall-count`."+askedAs:+ - "number getting lighter"+ - "kilobytes saved"+ - "I want a heavy figure counting down as its strokes slim to a thin font"+ - "size or weight stat where the type itself gets lighter"+ - "bundle size reduction shown by text shedding weight"+ - "viewer feels something losing weight as the number drops"---<ComponentPreview name="weight-cut" />diff --git a/content/docs/numbers/zero-stretch.mdx b/content/docs/numbers/zero-stretch.mdxindex 3596f873..7e385d63 100644--- a/content/docs/numbers/zero-stretch.mdx+++ b/content/docs/numbers/zero-stretch.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The stat is a duration with a unit word — use `stem-stretch`."- "You want a plain figure with no integrated word — use `compact-stat`."- "The number should count up — use `tall-count`."+askedAs:+ - "glossy pill inside number"+ - "200 components"+ - "I want the zero in a number to stretch into a pill holding a word"+ - "count claim where the unit word sits inside the figure"+ - "hero number with a glossy capsule inside the digits"+ - "viewer sees a digit become a container for the label"---<ComponentPreview name="zero-stretch" />diff --git a/content/docs/product-scenes/ai-answer-sources.mdx b/content/docs/product-scenes/ai-answer-sources.mdxindex 64ec8d87..2ae3b17c 100644--- a/content/docs/product-scenes/ai-answer-sources.mdx+++ b/content/docs/product-scenes/ai-answer-sources.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The AI should run tools and show a step-by-step plan rather than cite sources — use `agent-run`."- "You want a simple chat reply bubble in a messaging UI — use `chat-flow`."- "You need a prompt typing into a generator that produces an output — use `ai-prompt-flow`."+askedAs:+ - "ai search with citations"+ - "perplexity style answer"+ - "I want an AI answer streaming in with numbered source references"+ - "show a research assistant citing sources and opening a source panel"+ - "product beat where the chatbot proves its answer"+ - "viewer trusts the answer because a cited source slides open"---<ComponentPreview name="ai-answer-sources" />diff --git a/content/docs/product-scenes/ai-image-grid.mdx b/content/docs/product-scenes/ai-image-grid.mdxindex 06b047bb..1863a315 100644--- a/content/docs/product-scenes/ai-image-grid.mdx+++ b/content/docs/product-scenes/ai-image-grid.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a generic AI prompt-to-result flow with a button and loading skeleton — use `ai-prompt-flow`."- "The AI output is a working app or site, not images — use `prompt-to-app`."- "You need a chat conversation with an assistant — use `chat-flow`."+askedAs:+ - "image generator prompt"+ - "midjourney style grid"+ - "I want a prompt typed and a grid of generated images resolving"+ - "show picking one variation and zooming into its details"+ - "text to image product launch beat"+ - "viewer sees a prompt turn into many options then one chosen"---<ComponentPreview name="ai-image-grid" />diff --git a/content/docs/product-scenes/analytics-funnel.mdx b/content/docs/product-scenes/analytics-funnel.mdxindex e16ca313..eaaf0505 100644--- a/content/docs/product-scenes/analytics-funnel.mdx+++ b/content/docs/product-scenes/analytics-funnel.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a single chart line growing to a headline value — use `chart-morph` instead."- "The story is a live revenue dashboard with a feed, not a funnel — use `live-dashboard` instead."- "You only need big count-up numbers with no chart — use `stat-sequence` instead."+askedAs:+ - "conversion funnel chart"+ - "drop-off steps"+ - "I want an activation funnel stepping down with a tooltip of breakdowns"+ - "growth product showing where users drop off"+ - "analytics dashboard demo with realistic conversion numbers"+ - "viewer sees each stage narrow and details on hover"---<ComponentPreview name="analytics-funnel" />diff --git a/content/docs/product-scenes/app-store-listing.mdx b/content/docs/product-scenes/app-store-listing.mdxindex 3b138df9..cdbac9d8 100644--- a/content/docs/product-scenes/app-store-listing.mdx+++ b/content/docs/product-scenes/app-store-listing.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want the app's home screen and a placed widget after install — use `home-widget`."- "You need a scrolling in-app screen, not a store page — use `phone-scroll`."- "You need several phones in one frame — use `phone-trio`."+askedAs:+ - "app store download"+ - "get then open button"+ - "I want a phone store page where Get downloads and becomes Open"+ - "now available on the app store with rating and screenshots"+ - "mobile app launch moment showing the store listing"+ - "viewer sees screenshots swipe past as the app installs"---<ComponentPreview name="app-store-listing" />diff --git a/content/docs/product-scenes/audit-boxes.mdx b/content/docs/product-scenes/audit-boxes.mdxindex 50556dae..016dfcdc 100644--- a/content/docs/product-scenes/audit-boxes.mdx+++ b/content/docs/product-scenes/audit-boxes.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The marks should be neutral measurements rather than problems — use `redline-measure`."- "The next beat should be the screen getting fixed — use `scan-fix`."- "The camera should tour regions of a screenshot with captions — use `screenshot-tour`."+askedAs:+ - "red boxes on ui problems"+ - "design lint overlay"+ - "I want red outlines tracing off-spec elements with a fix label each"+ - "accessibility or QA tool showing issues it finds on a real screen"+ - "design linting demo with annotated flaws"+ - "viewer sees problems flagged across an interface"---<ComponentPreview name="audit-boxes" />diff --git a/content/docs/product-scenes/bento-build.mdx b/content/docs/product-scenes/bento-build.mdxindex dbf23519..c64b0408 100644--- a/content/docs/product-scenes/bento-build.mdx+++ b/content/docs/product-scenes/bento-build.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You only have three short feature words — use `feature-trio`."- "You want pills streaming around a logo — use `feature-chips-flow`."- "You want an existing screen annotated instead of a grid — use `ui-callout`."+askedAs:+ - "feature grid tiles"+ - "bento layout overview"+ - "I want a bento grid of feature tiles building in then highlighting each"+ - "features overview that reads as one organized product"+ - "a beat spotlighting capabilities one tile at a time"+ - "viewer sees many features snap into a neat apple-style grid"---<ComponentPreview name="bento-build" />diff --git a/content/docs/product-scenes/bracket-win.mdx b/content/docs/product-scenes/bracket-win.mdxindex 7c036a95..b3e82390 100644--- a/content/docs/product-scenes/bracket-win.mdx+++ b/content/docs/product-scenes/bracket-win.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The win is a ranking climb up a list, not a bracket — use `upvote-burst` instead."- "You want bracket-shaped framing around a product name with no match play — use `bracket-index` instead."- "You need a data-rich dashboard to prove results — use `live-dashboard` instead."+askedAs:+ - "tournament bracket champion"+ - "we win every round"+ - "I want a bracket resolving match by match until we are crowned champion"+ - "launch hook framed as a competition our product wins"+ - "knockout style comparison with a winner at the end"+ - "viewer sees rivals eliminated and our name at the top"---<ComponentPreview name="bracket-win" />diff --git a/content/docs/product-scenes/browser-extension.mdx b/content/docs/product-scenes/browser-extension.mdxindex a8ba3a12..b696ffd4 100644--- a/content/docs/product-scenes/browser-extension.mdx+++ b/content/docs/product-scenes/browser-extension.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The product is a web app with its own UI, not an overlay on another page — use `url-bar-cta`."- "You want a zoom tour over a screenshot — use `screenshot-tour`."- "You want a data table with filters and bulk actions — use `table-filter`."+askedAs:+ - "chrome extension demo"+ - "web clipper summary"+ - "I want an extension highlighting article lines and saving a summary"+ - "summarizer tool acting on the page you are already reading"+ - "browser add-on launch beat with a reading list"+ - "viewer sees a page get marked up and the summary saved"---<ComponentPreview name="browser-extension" />diff --git a/content/docs/product-scenes/button-to-card.mdx b/content/docs/product-scenes/button-to-card.mdxindex 9abf2941..7e9ee70c 100644--- a/content/docs/product-scenes/button-to-card.mdx+++ b/content/docs/product-scenes/button-to-card.mdx@@ -11,6 +11,13 @@ useWhen:avoidWhen:- "You want the product grid to grow into a full admin app with sidebar — use `grid-to-app`."- "The beat is a shopper adding to a cart rather than a merchant adding a product — use `cart-add`."+askedAs:+ - "add item becomes product listing"+ - "storefront builder"+ - "I want a button that expands into a product card row with prices"+ - "show how adding an item turns into a finished listing"+ - "store setup beat where the product appears from a click"+ - "viewer sees one tap create a full catalogue entry"---<ComponentPreview name="button-to-card" />diff --git a/content/docs/product-scenes/calendar-booking.mdx b/content/docs/product-scenes/calendar-booking.mdxindex 0b905d1d..2ff1995c 100644--- a/content/docs/product-scenes/calendar-booking.mdx+++ b/content/docs/product-scenes/calendar-booking.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a calendar that tags launch dates with event labels — use `calendar-pick`."- "You want a heat-themed launch calendar — use `heat-drain-reveal`."- "You want a team timeline with draggable bars — use `roadmap-timeline`."+askedAs:+ - "schedule a meeting demo"+ - "pick a day and time slot"+ - "I want a cursor choosing a date and time and a confirmed card appearing"+ - "scheduling product beat with booking confirmation"+ - "demo booking flow shown as quick as possible"+ - "viewer sees how easy it is to get a meeting on the calendar"---<ComponentPreview name="calendar-booking" />diff --git a/content/docs/product-scenes/card-create.mdx b/content/docs/product-scenes/card-create.mdxindex 4284873a..223757dd 100644--- a/content/docs/product-scenes/card-create.mdx+++ b/content/docs/product-scenes/card-create.mdx@@ -11,6 +11,13 @@ useWhen:avoidWhen:- "The moment is sending money, not issuing a card — use `money-send`, which confirms a payment with a receipt."- "You want the phone to land on a subscription upsell — use `mobile-paywall`, which selects a plan and confirms."+askedAs:+ - "virtual debit card issue"+ - "fintech card printing"+ - "I want a phone app printing a new card with finishes and an engraved name"+ - "show issuing a card and adding it to the wallet"+ - "fintech launch beat on personalised cards"+ - "viewer sees a card appear fast and ready for apple wallet"---<ComponentPreview name="card-create" />diff --git a/content/docs/product-scenes/cart-add.mdx b/content/docs/product-scenes/cart-add.mdxindex 68dc9b0e..a648be2e 100644--- a/content/docs/product-scenes/cart-add.mdx+++ b/content/docs/product-scenes/cart-add.mdx@@ -11,6 +11,13 @@ useWhen:avoidWhen:- "The story starts at payment, not the product page — use `coupon-apply`, which works on an order summary."- "You want a store admin or catalogue view instead of the shopper side — use `grid-to-app`."+askedAs:+ - "add to cart checkout"+ - "ecommerce product page"+ - "I want a shop page choosing color and size then a cart drawer sliding in"+ - "online store launch beat turning a product view into a sale"+ - "show the path from browsing to checkout"+ - "viewer sees a purchase flow in a few seconds"---<ComponentPreview name="cart-add" />diff --git a/content/docs/product-scenes/channel-reactions.mdx b/content/docs/product-scenes/channel-reactions.mdxindex 17ce83b2..d4945999 100644--- a/content/docs/product-scenes/channel-reactions.mdx+++ b/content/docs/product-scenes/channel-reactions.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want several collaborators moving around a shared canvas — use `multiplayer-cursors`."- "The beat is a video call with participants and controls — use `video-call`."- "You want a hero stat or leaderboard moment instead of chat — use `leaderboard-climb`."+askedAs:+ - "slack message with emoji"+ - "team chat reactions"+ - "I want a launch announcement in a chat channel collecting emoji and replies"+ - "social proof from teammates reacting to the news"+ - "internal announcement getting celebrated"+ - "viewer sees excitement in a workspace as reactions pile up"---<ComponentPreview name="channel-reactions" />diff --git a/content/docs/product-scenes/chaos-to-order.mdx b/content/docs/product-scenes/chaos-to-order.mdxindex ada9c1ec..1a30d736 100644--- a/content/docs/product-scenes/chaos-to-order.mdx+++ b/content/docs/product-scenes/chaos-to-order.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The chaos is only notifications on a phone — use `notification-avalanche`."- "You want a wireframe that resolves into the finished UI — use `wireframe-to-final`."- "You want a calm tour of a finished screen — use `screenshot-tour`."+askedAs:+ - "messy windows organized"+ - "too many tabs to one tool"+ - "I want scattered windows and notes snapping into a clean issue tracker"+ - "problem then solution opener about tool sprawl"+ - "project management launch from clutter to clarity"+ - "viewer feels relief as the mess turns into one workspace"---<ComponentPreview name="chaos-to-order" />diff --git a/content/docs/product-scenes/coupon-apply.mdx b/content/docs/product-scenes/coupon-apply.mdxindex 7cdb91c7..7a99facf 100644--- a/content/docs/product-scenes/coupon-apply.mdx+++ b/content/docs/product-scenes/coupon-apply.mdx@@ -11,6 +11,13 @@ useWhen:avoidWhen:- "The story is the shopper picking a product and adding it to a cart — use `cart-add`."- "You only need a settled invoice with a PAID stamp, no code entry — use `invoice-paid`."+askedAs:+ - "promo code checkout"+ - "discount code total drops"+ - "I want a checkout where one code fails and another lowers the total"+ - "billing launch beat with a visible discount"+ - "show applying a coupon and the price updating"+ - "viewer sees the order summary shrink after a valid code"---<ComponentPreview name="coupon-apply" />diff --git a/content/docs/product-scenes/deploy-pipeline.mdx b/content/docs/product-scenes/deploy-pipeline.mdxindex f8cdc31f..414c8281 100644--- a/content/docs/product-scenes/deploy-pipeline.mdx+++ b/content/docs/product-scenes/deploy-pipeline.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a typed terminal session instead of a deployment page — use `terminal-simulator`."- "The story is a pull request being merged — use `pr-merge`."- "You need a status page with uptime strips — use `status-page`."+askedAs:+ - "build logs ready"+ - "vercel style deployment"+ - "I want a deployment running a build, streaming logs and flipping to Ready"+ - "developer platform beat showing push to production"+ - "CI or hosting demo ending on a ready status"+ - "viewer sees code turn into a live site quickly"---<ComponentPreview name="deploy-pipeline" />diff --git a/content/docs/product-scenes/design-audit.mdx b/content/docs/product-scenes/design-audit.mdxindex fd8b0005..ac6183ed 100644--- a/content/docs/product-scenes/design-audit.mdx+++ b/content/docs/product-scenes/design-audit.mdx@@ -12,6 +12,13 @@ avoidWhen:- "Only the before-to-after sweep is needed — use `scan-fix`."- "Only the flagged problems are needed — use `audit-boxes`."- "The camera should tour several regions of a screenshot with captions — use `screenshot-tour`."+askedAs:+ - "design review redlines"+ - "ship the fix scan"+ - "I want a whole design review from issue boxes to a scan that fixes them"+ - "design system launch hero sequence about catching and fixing issues"+ - "UI kit story from redlines to a clean result"+ - "viewer sees problems found then resolved in one scene"---<ComponentPreview name="design-audit" />diff --git a/content/docs/product-scenes/device-grows-around.mdx b/content/docs/product-scenes/device-grows-around.mdxindex 7e8eef4f..1e0de036 100644--- a/content/docs/product-scenes/device-grows-around.mdx+++ b/content/docs/product-scenes/device-grows-around.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a phone screen scrolling through several app states — use `phone-scroll` instead."- "The focus is a funnel or breakdown chart rather than a growing device — use `analytics-funnel` instead."- "You want a fast headline counter with no device frame — use `live-ticker` instead."+askedAs:+ - "metric card becoming app screen"+ - "plays counter analytics"+ - "I want a single metric card zooming out into a full device with the app"+ - "creator analytics launch revealing the whole dashboard"+ - "media stats app with range tabs and deltas"+ - "viewer sees a number card grow a phone frame around it"---<ComponentPreview name="device-grows-around" />diff --git a/content/docs/product-scenes/feature-flag-rollout.mdx b/content/docs/product-scenes/feature-flag-rollout.mdxindex 8344b46e..f501cb51 100644--- a/content/docs/product-scenes/feature-flag-rollout.mdx+++ b/content/docs/product-scenes/feature-flag-rollout.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a build-and-deploy story with logs ending in Ready — use `deploy-pipeline`."- "The point is merging code with passing checks, not controlling exposure — use `pr-merge`."- "You need a plain live-metrics wall without a rollout interaction — use `live-dashboard`."+askedAs:+ - "gradual release percentage"+ - "toggle on 5 25 100"+ - "I want a flag switching on and ramping 5, 25 then 100 percent"+ - "release engineering beat with guardrail charts and an audit log"+ - "show a safe staged rollout with metrics watching"+ - "viewer sees confidence rise as the percentage climbs"---<ComponentPreview name="feature-flag-rollout" />diff --git a/content/docs/product-scenes/file-dropzone.mdx b/content/docs/product-scenes/file-dropzone.mdxindex e16c0287..e83ede21 100644--- a/content/docs/product-scenes/file-dropzone.mdx+++ b/content/docs/product-scenes/file-dropzone.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want one file card filling an upload bar on a plain stage — use `drop-upload`."- "Files go into a prompt box as chips — use `multi-file-drop`."- "You want a table with filtering rather than uploads — use `table-filter`."+askedAs:+ - "upload files dialog"+ - "drag and drop progress"+ - "I want files dropping into an upload box with progress bars filling"+ - "knowledge base or asset tool where upload is the first action"+ - "show documents arriving with a confirmation toast"+ - "viewer sees how simple it is to add files"---<ComponentPreview name="file-dropzone" />diff --git a/content/docs/product-scenes/flow-builder.mdx b/content/docs/product-scenes/flow-builder.mdxindex 888c3263..070fb5d8 100644--- a/content/docs/product-scenes/flow-builder.mdx+++ b/content/docs/product-scenes/flow-builder.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The graph is generated from a prompt with dotted trail lines — use `node-trail`."- "You want an existing graph to re-arrange itself — use `graph-relayout`."- "You want build logs and a deploy status — use `deploy-pipeline`."+askedAs:+ - "workflow automation canvas"+ - "connect nodes and publish"+ - "I want a canvas dropping nodes, wiring them and running a packet through"+ - "automation product beat where a graph is buildable in seconds"+ - "no-code workflow built and published with a toast"+ - "viewer sees a pipeline get assembled and run end to end"---<ComponentPreview name="flow-builder" />diff --git a/content/docs/product-scenes/graph-relayout.mdx b/content/docs/product-scenes/graph-relayout.mdxindex 1d073481..e917739b 100644--- a/content/docs/product-scenes/graph-relayout.mdx+++ b/content/docs/product-scenes/graph-relayout.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You only need one prompt trailing dotted lines into a fixed chain of steps — use `node-trail`."- "The nodes should be a build-it-yourself canvas rather than a re-layout — use `flow-builder`."- "The result should be an actual app being generated — use `prompt-to-app`."+askedAs:+ - "node graph rearranging"+ - "one prompt fans into many outputs"+ - "I want a node graph that reshapes itself through several layouts"+ - "explain how one input branches into a pipeline of results"+ - "AI agent workflow with nodes sliding and reconnecting"+ - "viewer sees structure evolve step by step"---<ComponentPreview name="graph-relayout" />diff --git a/content/docs/product-scenes/grid-to-app.mdx b/content/docs/product-scenes/grid-to-app.mdxindex 4346014f..907ca794 100644--- a/content/docs/product-scenes/grid-to-app.mdx+++ b/content/docs/product-scenes/grid-to-app.mdx@@ -11,6 +11,13 @@ useWhen:avoidWhen:- "You want a single button to morph into a new product card — use `button-to-card`."- "The story is a payments or stats dashboard rather than a catalogue — use `live-dashboard`."+askedAs:+ - "product tiles zoom into dashboard"+ - "shopify style admin"+ - "I want a product grid expanding into a full store admin app"+ - "commerce platform beat zooming from items to the back office"+ - "show a catalogue growing into an entire management tool"+ - "viewer sees a few tiles become a complete admin with sidebar"---<ComponentPreview name="grid-to-app" />diff --git a/content/docs/product-scenes/heat-drain-reveal.mdx b/content/docs/product-scenes/heat-drain-reveal.mdxindex 6c748af6..1fcb1116 100644--- a/content/docs/product-scenes/heat-drain-reveal.mdx+++ b/content/docs/product-scenes/heat-drain-reveal.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a plain calendar picking a day and tagging dates — use `calendar-pick`."- "You want a calendar that draws itself with a glowing ring on the date — use `launch-date`."- "You want a booking flow with time slots — use `calendar-booking`."+askedAs:+ - "glowing calendar dithered"+ - "launch day highlighted chip"+ - "I want a glowing month calendar draining its heat into a dithered glow"+ - "planning product beat ending with the launch day marked"+ - "moody dark hero with a calendar and a spotlight on one date"+ - "viewer sees the heat fade and a single day highlighted"---<ComponentPreview name="heat-drain-reveal" />diff --git a/content/docs/product-scenes/home-widget.mdx b/content/docs/product-scenes/home-widget.mdxindex 5021b0d2..4e7fd2e0 100644--- a/content/docs/product-scenes/home-widget.mdx+++ b/content/docs/product-scenes/home-widget.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a lock-screen status that counts down in real time — use `live-activity`."- "The scene is a store page and install flow — use `app-store-listing`."- "You want incoming alerts piling up instead — use `notification-avalanche`."+askedAs:+ - "ios home screen widget"+ - "add widget from gallery"+ - "I want a phone home screen jiggling and a widget dropped in with numbers counting"+ - "app launch with a widget where setup looks effortless"+ - "feature announcement showing the widget on the home screen"+ - "viewer sees how easy it is to put the app on their phone front page"---<ComponentPreview name="home-widget" />diff --git a/content/docs/product-scenes/invite-team.mdx b/content/docs/product-scenes/invite-team.mdxindex f95f75c3..e6391590 100644--- a/content/docs/product-scenes/invite-team.mdx+++ b/content/docs/product-scenes/invite-team.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want several people working live on one canvas — use `multiplayer-cursors`."- "The confirmation is a payment or checkout, not an invite — use `invoice-paid`."- "You need a cursor opening a card from a button — use `button-to-card`."+askedAs:+ - "invite teammates scene"+ - "add collaborators email"+ - "I want to show typing a coworker's email and sending an invite"+ - "show how easy it is to add people to a workspace, with a sent toast"+ - "onboarding beat where the viewer sees the team growing in seconds"+ - "team plan launch moment: invite the whole squad in one step"---<ComponentPreview name="invite-team" />diff --git a/content/docs/product-scenes/invoice-paid.mdx b/content/docs/product-scenes/invoice-paid.mdxindex b61edbe3..aa6fc8bf 100644--- a/content/docs/product-scenes/invoice-paid.mdx+++ b/content/docs/product-scenes/invoice-paid.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a checkout total changing with a promo code — use `coupon-apply`."- "The money moves phone to phone instead of a document being settled — use `money-send`."- "You need live revenue numbers and a recent activity feed — use `live-dashboard`."+askedAs:+ - "invoice paid stamp"+ - "freelancer billing demo"+ - "show an invoice getting marked as paid and a payout notification arriving"+ - "I want a billing scene that goes from sent to viewed to paid"+ - "the satisfying moment when the client pays and money lands"+ - "finance app video ending on a payout notification"---<ComponentPreview name="invoice-paid" />diff --git a/content/docs/product-scenes/layout-guides.mdx b/content/docs/product-scenes/layout-guides.mdxindex adfe9ccb..12f401c4 100644--- a/content/docs/product-scenes/layout-guides.mdx+++ b/content/docs/product-scenes/layout-guides.mdx@@ -12,6 +12,13 @@ avoidWhen:- "Single distances and sizes should be measured — use `redline-measure`."- "Elements should be tagged with design token names — use `token-tags`."- "The beat should be a gray wireframe filling in — use `wireframe-to-final`."+askedAs:+ - "grid column guides"+ - "dashed guides over screen"+ - "show the grid structure under a UI with dashed columns and a current-time line"+ - "I want to explain a calendar layout with columns and a now marker"+ - "reveal the hidden skeleton of a responsive layout"+ - "schedule app beat that shows days as columns with a line sliding across"---<ComponentPreview name="layout-guides" />diff --git a/content/docs/product-scenes/leaderboard-climb.mdx b/content/docs/product-scenes/leaderboard-climb.mdxindex 5206d49f..3933f347 100644--- a/content/docs/product-scenes/leaderboard-climb.mdx+++ b/content/docs/product-scenes/leaderboard-climb.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want the climb to end with a number one badge stamp — use `upvote-burst` instead."- "You need a bracket-style elimination story, not a ranked list — use `bracket-win` instead."- "You want large animated stats with no table — use `stat-sequence` instead."+askedAs:+ - "ranking climb animation"+ - "product hunt rank rising"+ - "show our row moving up a daily ranking table to number one"+ - "I want a highlighted row overtaking competitors in a list"+ - "launch day recap where we beat everyone and reach the top spot"+ - "social proof moment: watch the product rise through the charts"---<ComponentPreview name="leaderboard-climb" />diff --git a/content/docs/product-scenes/live-activity.mdx b/content/docs/product-scenes/live-activity.mdxindex b74abe13..99e3fc7c 100644--- a/content/docs/product-scenes/live-activity.mdx+++ b/content/docs/product-scenes/live-activity.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a home-screen widget with a chart — use `home-widget`."- "You want a map and a driver arriving — use `ride-tracking`."- "You want a stack of incoming alerts — use `notification-avalanche`."+askedAs:+ - "iphone dynamic island"+ - "lock screen live status"+ - "a phone pill expands into a progress bar with a countdown and a checkmark"+ - "I want an ETA ticking down on the lock screen then finishing"+ - "show a delivery or render status you can glance at without opening the app"+ - "app launch beat where background progress completes with a tick"---<ComponentPreview name="live-activity" />diff --git a/content/docs/product-scenes/live-dashboard.mdx b/content/docs/product-scenes/live-dashboard.mdxindex 59adb2b9..a4446739 100644--- a/content/docs/product-scenes/live-dashboard.mdx+++ b/content/docs/product-scenes/live-dashboard.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The story is conversion drop-off between steps — use `analytics-funnel` instead."- "You want a single big counter ticking up with no dashboard chrome — use `live-ticker` instead."- "You need to show a deploy or build running rather than metrics — use `deploy-pipeline` instead."+askedAs:+ - "payments dashboard demo"+ - "revenue kpi cards chart"+ - "I want a believable SaaS dashboard with a growing chart and new payments"+ - "show money coming in live with stat tiles and a recent activity feed"+ - "fintech launch beat proving the product shows revenue in real time"+ - "stripe style analytics screen with numbers climbing"---<ComponentPreview name="live-dashboard" />diff --git a/content/docs/product-scenes/macro-click.mdx b/content/docs/product-scenes/macro-click.mdxindex 2f0e5533..b15af250 100644--- a/content/docs/product-scenes/macro-click.mdx+++ b/content/docs/product-scenes/macro-click.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a browser window with a landing page whose CTA is clicked — use `url-bar-cta`."- "You want the whole editor with a timeline and export — use `timeline-editor`."- "You want a build log and deploy status — use `deploy-pipeline`."+askedAs:+ - "macro close-up click"+ - "publish button then pull back"+ - "start tight on a button, click it, status turns Live and the camera zooms out"+ - "I want a one-click publish moment shown as a cinematic close-up"+ - "opener where a tiny control reveals the whole product as the view widens"+ - "site builder pitch: one click and your site goes live"---<ComponentPreview name="macro-click" />diff --git a/content/docs/product-scenes/mobile-paywall.mdx b/content/docs/product-scenes/mobile-paywall.mdxindex 9051163b..53f8adef 100644--- a/content/docs/product-scenes/mobile-paywall.mdx+++ b/content/docs/product-scenes/mobile-paywall.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a full pricing table comparing several tiers on a web page — use `pricing-reveal`."- "The flow is a payment amount and receipt rather than a plan upgrade — use `money-send`."- "You need a web checkout with a promo code — use `coupon-apply`."+askedAs:+ - "app subscription paywall"+ - "pick a plan upgrade to pro"+ - "I want to show choosing a subscription plan and a welcome to pro screen"+ - "phone scene where a free trial starts after selecting a plan"+ - "beat that makes upgrading in a mobile app look effortless"+ - "subscription app launch showing the premium upsell and confirmation"---<ComponentPreview name="mobile-paywall" />diff --git a/content/docs/product-scenes/money-send.mdx b/content/docs/product-scenes/money-send.mdxindex 3ea82998..0cd00e3d 100644--- a/content/docs/product-scenes/money-send.mdx+++ b/content/docs/product-scenes/money-send.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The scene is a subscription upgrade with plan cards — use `mobile-paywall`."- "You are settling a business invoice on a desktop layout — use `invoice-paid`."- "You need a stock or portfolio screen with a chart — use `stock-scrub`."+askedAs:+ - "send money phone screen"+ - "peer to peer payment"+ - "show typing an amount with a note and ending on a Sent receipt"+ - "I want a fintech phone demo of paying a friend in seconds"+ - "beat that conveys sending money is fast and simple"+ - "venmo style transfer ending on a confirmation receipt"---<ComponentPreview name="money-send" />diff --git a/content/docs/product-scenes/multiplayer-cursors.mdx b/content/docs/product-scenes/multiplayer-cursors.mdxindex a07f949e..e420c34d 100644--- a/content/docs/product-scenes/multiplayer-cursors.mdx+++ b/content/docs/product-scenes/multiplayer-cursors.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The beat is a chat thread with reactions and replies — use `channel-reactions`."- "You only want one cursor moving through a task flow — use `flow-builder`."- "You want a single teammate invite and confirmation — use `invite-team`."+askedAs:+ - "figma style live cursors"+ - "real-time collaboration board"+ - "several named cursors dropping sticky notes and commenting together"+ - "I want to show teammates editing one whiteboard at the same time"+ - "collab tool moment where the canvas feels alive with people"+ - "design or planning app demo with many users working in parallel"---<ComponentPreview name="multiplayer-cursors" />diff --git a/content/docs/product-scenes/node-trail.mdx b/content/docs/product-scenes/node-trail.mdxindex d494a849..49abe9ad 100644--- a/content/docs/product-scenes/node-trail.mdx+++ b/content/docs/product-scenes/node-trail.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The graph should reshuffle between several layouts rather than grow once — use `graph-relayout`."- "You want a finished app to appear from the prompt, not a pipeline diagram — use `prompt-to-app`."- "The viewer should watch a prompt animate inside a chat composer — use `ai-prompt-flow`."+askedAs:+ - "prompt to workflow nodes"+ - "dotted lines connecting steps"+ - "a typed prompt branches into script, scenes, render and publish nodes"+ - "I want to show one instruction fanning out into a multi-step pipeline"+ - "automation or agent intro that ends with the camera pulling back to the whole graph"+ - "explain that one idea triggers a full automated chain"---<ComponentPreview name="node-trail" />diff --git a/content/docs/product-scenes/notification-avalanche.mdx b/content/docs/product-scenes/notification-avalanche.mdxindex 15a6a87a..212dea8f 100644--- a/content/docs/product-scenes/notification-avalanche.mdx+++ b/content/docs/product-scenes/notification-avalanche.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The chaos is desktop windows and chat toasts resolving into an app — use `chaos-to-order`."- "You want a single ongoing status, not a pile — use `live-activity`."- "You want a screen to scroll rather than alerts to arrive — use `phone-scroll`."+askedAs:+ - "notification overload"+ - "too many alerts phone"+ - "pings pile up faster and faster, then everything clears to all caught up"+ - "I want chaos first with a runaway unread badge, then calm inbox zero"+ - "problem and solution beat for a notification management app"+ - "show the relief of silence after a flood of messages"---<ComponentPreview name="notification-avalanche" />diff --git a/content/docs/product-scenes/now-playing.mdx b/content/docs/product-scenes/now-playing.mdxindex 2fda64bc..3429e5fb 100644--- a/content/docs/product-scenes/now-playing.mdx+++ b/content/docs/product-scenes/now-playing.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want incoming alerts instead of playback — use `notification-avalanche`."- "You want a video player with subscribe and like — use `video-watch-page`."- "You need a lock-screen status with a progress bar — use `live-activity`."+askedAs:+ - "music player with lyrics"+ - "spotify style player screen"+ - "tap play, like the song and watch lyrics highlight line by line"+ - "I want a podcast or music app scene with a warm gradient and synced words"+ - "launch video where the audio player UI tells the story"+ - "karaoke style lyric scroll on a phone player"---<ComponentPreview name="now-playing" />diff --git a/content/docs/product-scenes/phone-scroll.mdx b/content/docs/product-scenes/phone-scroll.mdxindex e8b0b67b..0a7e0653 100644--- a/content/docs/product-scenes/phone-scroll.mdx+++ b/content/docs/product-scenes/phone-scroll.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want three phones for a notification, a feed and a profile — use `phone-trio`."- "The story is install and Open rather than scrolling — use `app-store-listing`."- "You need the camera to tour regions of a desktop screenshot — use `screenshot-tour`."+askedAs:+ - "phone scrolling long page"+ - "scroll mockup with headline"+ - "a phone rises and swipes through a tall screen with a headline beside it"+ - "I want to show a long feed being scrolled with one-line promise next to it"+ - "vertical clip that walks the viewer down an app screen section by section"+ - "mobile showcase where the page stops at key points as text slides in"---<ComponentPreview name="phone-scroll" />diff --git a/content/docs/product-scenes/phone-trio.mdx b/content/docs/product-scenes/phone-trio.mdxindex 685228b9..31b0b870 100644--- a/content/docs/product-scenes/phone-trio.mdx+++ b/content/docs/product-scenes/phone-trio.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You only need one phone and a long scrolling screen — use `phone-scroll`."- "The story is install and download progress — use `app-store-listing`."- "The product is a desktop web app, not mobile — use `url-bar-cta`."+askedAs:+ - "three phones side by side"+ - "portfolio launch phones"+ - "three phone mockups rising: profile, photo feed and a we are live banner"+ - "I want a creator hero with several devices and a bold headline"+ - "personal brand launch showing profile, feed and notification in one frame"+ - "editorial hero where multiple screens appear together"---<ComponentPreview name="phone-trio" />diff --git a/content/docs/product-scenes/pr-merge.mdx b/content/docs/product-scenes/pr-merge.mdxindex 1d5494eb..da1c3a24 100644--- a/content/docs/product-scenes/pr-merge.mdx+++ b/content/docs/product-scenes/pr-merge.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a build streaming logs and flipping to Ready — use `deploy-pipeline`."- "The story is a gradual percentage rollout with metric charts — use `feature-flag-rollout`."- "You only need a short typed-code-to-UI moment, not a review flow — use `live-code-compilation`."+askedAs:+ - "pull request merged"+ - "ci checks turning green"+ - "checks pass one by one then a cursor clicks merge and status becomes Merged"+ - "I want a developer tool scene about code review going green"+ - "ship faster beat: tests pass, one click merge, branch deleted"+ - "github pull request flow for a dev workflow launch"---<ComponentPreview name="pr-merge" />diff --git a/content/docs/product-scenes/pricing-reveal.mdx b/content/docs/product-scenes/pricing-reveal.mdxindex cee233dd..225bac75 100644--- a/content/docs/product-scenes/pricing-reveal.mdx+++ b/content/docs/product-scenes/pricing-reveal.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You only need one plan on a phone with a trial flow — use `mobile-paywall`."- "The pricing is a single huge statement rather than a table — use `price-page`."- "The point is a checkout total dropping after a code — use `coupon-apply`."+askedAs:+ - "pricing table highlight"+ - "discount price swap"+ - "three plan cards with the pro tier spotlighted and the old price crossed out"+ - "I want to announce a launch discount on a pricing page"+ - "saas beat where the viewer sees which tier to choose"+ - "new lower price replaces the old one with emphasis on the pro plan"---<ComponentPreview name="pricing-reveal" />diff --git a/content/docs/product-scenes/prompt-swell.mdx b/content/docs/product-scenes/prompt-swell.mdxindex cc9be4e5..ff633424 100644--- a/content/docs/product-scenes/prompt-swell.mdx+++ b/content/docs/product-scenes/prompt-swell.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a chat-driven build with files being written and a deploy step — use `prompt-to-app`."- "The prompt should just collapse or push into the next scene — use `caret-collapse`."- "You want a pipeline diagram rather than a window preview — use `node-trail`."+askedAs:+ - "prompt box expands to builder"+ - "ai page builder launch"+ - "a small prompt card grows into a full app window that makes a pricing page"+ - "I want one input to blossom into the whole product screen"+ - "prompt in, finished landing page out, shipped"+ - "moment where a single sentence turns into a complete website"---<ComponentPreview name="prompt-swell" />diff --git a/content/docs/product-scenes/prompt-to-app.mdx b/content/docs/product-scenes/prompt-to-app.mdxindex 36454d38..43f2fa72 100644--- a/content/docs/product-scenes/prompt-to-app.mdx+++ b/content/docs/product-scenes/prompt-to-app.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a short prompt-to-page swell without chat or files — use `prompt-swell`."- "The tool outputs images, not a site — use `ai-image-grid`."- "You want an agent plan with tool calls and checks rather than a site preview — use `agent-run`."+askedAs:+ - "ai app builder demo"+ - "chat prompt writes files and deploys"+ - "type a prompt, watch files being written, then a site preview builds and goes live"+ - "I want proof that the AI output is a real working site"+ - "one take from idea to deployed app for a vibe coding tool"+ - "lovable or v0 style launch with chat, file writes and deploy"---<ComponentPreview name="prompt-to-app" />diff --git a/content/docs/product-scenes/redline-measure.mdx b/content/docs/product-scenes/redline-measure.mdxindex 85c5841b..1bb9d730 100644--- a/content/docs/product-scenes/redline-measure.mdx+++ b/content/docs/product-scenes/redline-measure.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The marks should flag what is wrong with the fix next to it — use `audit-boxes`."- "The scene should move from the marked-up screen to the fixed one — use `scan-fix`."- "A product object, not a UI, should turn into a technical drawing — use `blueprint`."+askedAs:+ - "design spacing annotations"+ - "pixel measurements over ui"+ - "red measurement lines draw over a screen and spacing values pop in one by one"+ - "I want to show our UI kit is precisely measured, not eyeballed"+ - "design system beat with a handoff spec markup look"+ - "figma inspect style spacing and size overlay"---<ComponentPreview name="redline-measure" />diff --git a/content/docs/product-scenes/ride-tracking.mdx b/content/docs/product-scenes/ride-tracking.mdxindex 6ec13dc2..694ffcce 100644--- a/content/docs/product-scenes/ride-tracking.mdx+++ b/content/docs/product-scenes/ride-tracking.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a lock-screen countdown instead of a map — use `live-activity`."- "You want a payment confirmation with a receipt — use `money-send`."- "You want a store listing and install flow — use `app-store-listing`."+askedAs:+ - "ride hailing map route"+ - "uber style tracking"+ - "a car drives along a drawn route while the ETA drops and arrival is confirmed"+ - "I want a delivery or mobility app showing watch it come to you"+ - "vertical cut with book, track, arrive captions on a phone map"+ - "live driver location on a map ending with an arrived check"---<ComponentPreview name="ride-tracking" />diff --git a/content/docs/product-scenes/roadmap-timeline.mdx b/content/docs/product-scenes/roadmap-timeline.mdxindex 1bc7f96a..513f6014 100644--- a/content/docs/product-scenes/roadmap-timeline.mdx+++ b/content/docs/product-scenes/roadmap-timeline.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a launch-date calendar, not a Gantt chart — use `calendar-pick`."- "You want a video editor timeline — use `timeline-editor`."- "You want a ranked list that reorders itself — use `leaderboard-climb`."+askedAs:+ - "project roadmap gantt"+ - "drag task to new date"+ - "timeline bars draw, a cursor moves one later and dependent bars shift"+ - "I want to show rescheduling that updates linked tasks automatically"+ - "project management launch where planning feels effortless"+ - "gantt chart demo ending on a saved confirmation toast"---<ComponentPreview name="roadmap-timeline" />diff --git a/content/docs/product-scenes/scan-fix.mdx b/content/docs/product-scenes/scan-fix.mdxindex ef83cbc0..8ae8f3ee 100644--- a/content/docs/product-scenes/scan-fix.mdx+++ b/content/docs/product-scenes/scan-fix.mdx@@ -12,6 +12,13 @@ avoidWhen:- "A divider should sweep sideways across an image — use `before-after`."- "A gray wireframe should fill in with the finished UI — use `wireframe-to-final`."- "The whole review, from audit to tokens, should play as one scene — use `design-audit`."+askedAs:+ - "scan line fixes the ui"+ - "before and after bug sweep"+ - "a band sweeps down the screen leaving the corrected version behind it"+ - "I want red issues turning blue as everything gets fixed in one pass"+ - "release beat where the old build becomes the new build"+ - "design review payoff: every flagged problem resolved and version bumped"---<ComponentPreview name="scan-fix" />diff --git a/content/docs/product-scenes/send-fountain.mdx b/content/docs/product-scenes/send-fountain.mdxindex 23e790b7..ebff9b8e 100644--- a/content/docs/product-scenes/send-fountain.mdx+++ b/content/docs/product-scenes/send-fountain.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a prompt to become a full app screen, not a dashboard of tiles — use `prompt-to-app`."- "The beat is only about a live stats panel with a chart and activity feed — use `live-dashboard`."- "You just need a cursor click to expand a card — use `button-to-card`."+askedAs:+ - "ai builds a launch dashboard"+ - "prompt creates full board"+ - "one prompt fills a dashboard with a video, signup bars, a metric and asset tiles"+ - "I want a no-code demo where a single request produces a finished launch page"+ - "moment where an empty screen is populated with everything for launch day"+ - "builder output reveal with many tiles bursting onto the board"---<ComponentPreview name="send-fountain" />diff --git a/content/docs/product-scenes/sheet-formula.mdx b/content/docs/product-scenes/sheet-formula.mdxindex e17d9392..6798a24f 100644--- a/content/docs/product-scenes/sheet-formula.mdx+++ b/content/docs/product-scenes/sheet-formula.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The chart is the star and no spreadsheet is needed — use `animated-bar-chart`."- "You want a filtered table with bulk actions — use `table-filter`."- "You want a dashboard with live stats and a feed — use `live-dashboard`."+askedAs:+ - "spreadsheet formula fill down"+ - "excel style demo"+ - "type a formula once, fill it down the column, then drop a bar chart"+ - "I want a no-code data tool going from raw columns to a chart"+ - "analytics launch beat: write once, apply to all rows, visualize"+ - "google sheets look with automatic chart appearing"---<ComponentPreview name="sheet-formula" />diff --git a/content/docs/product-scenes/social-scheduler.mdx b/content/docs/product-scenes/social-scheduler.mdxindex 2a083dd3..77fef553 100644--- a/content/docs/product-scenes/social-scheduler.mdx+++ b/content/docs/product-scenes/social-scheduler.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a phone video feed with a double-tap heart — use `reels-feed`."- "You want emoji reactions on a team message — use `channel-reactions`."- "You want a meeting booking flow — use `calendar-booking`."+askedAs:+ - "schedule social post"+ - "post composer calendar"+ - "write a draft, attach media, pick a time slot and a scheduled toast appears"+ - "I want a content planning tool demo where posting later takes one click"+ - "creator workflow beat: compose, queue, done"+ - "buffer or hootsuite style scheduling scene"---<ComponentPreview name="social-scheduler" />diff --git a/content/docs/product-scenes/status-page.mdx b/content/docs/product-scenes/status-page.mdxindex ec6b07f7..0364a8e2 100644--- a/content/docs/product-scenes/status-page.mdx+++ b/content/docs/product-scenes/status-page.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want live, ticking metrics and an activity feed — use `live-dashboard`."- "The story is a deploy going live, not an incident history — use `deploy-pipeline`."- "You need a rollout with guardrail charts and a toggle — use `feature-flag-rollout`."+askedAs:+ - "uptime history strips"+ - "service status page"+ - "90 day uptime bars build, the banner resolves and a cursor hovers incidents"+ - "I want to show transparent reliability with an all systems operational look"+ - "infrastructure launch scene that builds trust through uptime"+ - "security and trust beat inspecting past outages"---<ComponentPreview name="status-page" />diff --git a/content/docs/product-scenes/stock-scrub.mdx b/content/docs/product-scenes/stock-scrub.mdxindex d0e3924a..c66a7caa 100644--- a/content/docs/product-scenes/stock-scrub.mdx+++ b/content/docs/product-scenes/stock-scrub.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The data lives in a desktop analytics chart with tooltips — use `analytics-funnel`."- "You want a payments dashboard with stats and a feed — use `live-dashboard`."- "The flow is sending money rather than buying an asset — use `money-send`."+askedAs:+ - "stock price chart phone"+ - "trading app buy"+ - "drag through an intraday price chart then a buy sheet slides up"+ - "I want an investing app demo with live price data and a quick purchase"+ - "fintech beat that ends on tapping buy after exploring the chart"+ - "robinhood style stock page"---<ComponentPreview name="stock-scrub" />diff --git a/content/docs/product-scenes/streak-reward.mdx b/content/docs/product-scenes/streak-reward.mdxindex b89ab77f..ca2bd9f4 100644--- a/content/docs/product-scenes/streak-reward.mdx+++ b/content/docs/product-scenes/streak-reward.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a gesture-driven card interaction — use `swipe-deck`."- "You want an achievement popup in a game-style UI, not a phone app — use `achievement-pop`."- "You want concentric rings and metrics counting up instead — use `activity-rings`."+askedAs:+ - "daily streak counter"+ - "habit app celebration"+ - "a streak counts up with week dots, then a lesson complete medal with stats"+ - "I want a learning or fitness app moment with XP and accuracy rolling up"+ - "retention pitch: keep coming back and get rewarded"+ - "duolingo style streak and reward screen"---<ComponentPreview name="streak-reward" />diff --git a/content/docs/product-scenes/swipe-deck.mdx b/content/docs/product-scenes/swipe-deck.mdxindex 0f6be4ca..7fda3531 100644--- a/content/docs/product-scenes/swipe-deck.mdx+++ b/content/docs/product-scenes/swipe-deck.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a store page and install flow — use `app-store-listing`."- "You want a reward screen with counters — use `streak-reward`."- "You want a stack that fans out of a pile without gestures — use `card-fan`."+askedAs:+ - "swipe cards left right"+ - "tinder style matching"+ - "a stack of cards swiped in different directions ending on a match popup with install"+ - "I want a discovery app where swiping is the main interaction"+ - "beat that curates options like templates or styles and lands on a choice"+ - "card deck gesture demo with a final its a match modal"---<ComponentPreview name="swipe-deck" />diff --git a/content/docs/product-scenes/table-filter.mdx b/content/docs/product-scenes/table-filter.mdxindex a8a74318..2f494d0b 100644--- a/content/docs/product-scenes/table-filter.mdx+++ b/content/docs/product-scenes/table-filter.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want to compute and chart columns — use `sheet-formula`."- "You want a ranking that reorders on its own — use `leaderboard-climb`."- "You want stats and a chart feed that update live — use `live-dashboard`."+askedAs:+ - "crm table filtering"+ - "bulk actions on rows"+ - "filter a table by stage, sort it, select rows and a bulk action bar slides up"+ - "I want to show a database tool handling many records at once"+ - "ops tool beat: filter, select, act"+ - "airtable or hubspot style list view demo"---<ComponentPreview name="table-filter" />diff --git a/content/docs/product-scenes/tile-snake-loader.mdx b/content/docs/product-scenes/tile-snake-loader.mdxindex 27ee6068..b78d00dd 100644--- a/content/docs/product-scenes/tile-snake-loader.mdx+++ b/content/docs/product-scenes/tile-snake-loader.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a gray wireframe that fills into the finished UI — use `wireframe-to-final`."- "You want file-by-file upload progress bars — use `file-dropzone`."- "You only need a small looping spinner — use `spinner`."+askedAs:+ - "media tiles loading intro"+ - "thumbnail snake animation"+ - "tiles slither across the screen and settle into a studio landing page with hero video"+ - "I want a creative tool opener where thumbnails become the product"+ - "brand opener built from media thumbnails turning into a polished site"+ - "loading screen that morphs into the finished studio homepage"---<ComponentPreview name="tile-snake-loader" />diff --git a/content/docs/product-scenes/tilt-settle-list.mdx b/content/docs/product-scenes/tilt-settle-list.mdxindex 07673142..0270ec1b 100644--- a/content/docs/product-scenes/tilt-settle-list.mdx+++ b/content/docs/product-scenes/tilt-settle-list.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The point is a leaderboard where one row climbs to first place — use `leaderboard-climb`."- "You need only a ranked list reordering with no hero card — use `rank-climb`."- "You want a sequence of phone screens rather than a card and list — use `phone-trio`."+askedAs:+ - "wrapped style top list"+ - "top tracks recap"+ - "a tilted player card settles next to a ranked list of most used scenes"+ - "I want a year in review moment with a ranked list of favorites"+ - "recap beat showing what the user used most"+ - "spotify wrapped look with a card beside a top five"---<ComponentPreview name="tilt-settle-list" />diff --git a/content/docs/product-scenes/timeline-editor.mdx b/content/docs/product-scenes/timeline-editor.mdxindex 2bdd9d74..588ad22a 100644--- a/content/docs/product-scenes/timeline-editor.mdx+++ b/content/docs/product-scenes/timeline-editor.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a project roadmap with draggable bars — use `roadmap-timeline`."- "You want one big publish click and a camera pull-back — use `macro-click`."- "You want a player page with subscribe and like — use `video-watch-page`."+askedAs:+ - "video editor interface demo"+ - "clips dropped on timeline"+ - "clips land on tracks, the preview scrubs and an export progress panel finishes"+ - "I want the editing app itself to be the demo from empty to exported film"+ - "motion tool launch showing the whole edit workflow in one take"+ - "capcut or premiere style timeline animation"---<ComponentPreview name="timeline-editor" />diff --git a/content/docs/product-scenes/token-tags.mdx b/content/docs/product-scenes/token-tags.mdxindex 0280811f..d434a453 100644--- a/content/docs/product-scenes/token-tags.mdx+++ b/content/docs/product-scenes/token-tags.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The labels are measurements rather than names — use `redline-measure`."- "The labels describe problems to fix — use `audit-boxes`."- "A product object should get one labelled callout — use `blueprint`."+askedAs:+ - "design tokens annotation"+ - "color variable labels on ui"+ - "the screen fades and leader lines point from elements to dark chips with token names"+ - "I want to show every color comes from a named design token"+ - "theming launch beat that links UI parts to code variables"+ - "design system explainer with callout labels"---<ComponentPreview name="token-tags" />diff --git a/content/docs/product-scenes/video-call.mdx b/content/docs/product-scenes/video-call.mdxindex 6f1a9020..f8fd7b8d 100644--- a/content/docs/product-scenes/video-call.mdx+++ b/content/docs/product-scenes/video-call.mdx@@ -11,6 +11,13 @@ useWhen:avoidWhen:- "The product is a chat, not a call — use `channel-reactions`, which shows reactions in a message thread."- "You want cursors and sticky notes on a shared canvas rather than faces — use `multiplayer-cursors`."+askedAs:+ - "video meeting scene"+ - "zoom style call participants"+ - "participants join a call, one shares a screen and emoji reactions float up"+ - "I want a team collaboration demo with a presenter sharing a dashboard"+ - "social live moment where people hop on and react together"+ - "google meet look with screen share and floating hearts"---<ComponentPreview name="video-call" />diff --git a/content/docs/product-scenes/video-watch-page.mdx b/content/docs/product-scenes/video-watch-page.mdxindex 02adcba8..4c134c31 100644--- a/content/docs/product-scenes/video-watch-page.mdx+++ b/content/docs/product-scenes/video-watch-page.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a vertical reels feed with a double-tap heart — use `reels-feed`."- "You want a live call with participants — use `video-call`."- "You want to show editing rather than watching — use `timeline-editor`."+askedAs:+ - "youtube watch page"+ - "subscribe and like counts rising"+ - "a cursor subscribes and likes while views, likes and subscribers count up"+ - "I want creator platform social proof with engagement growing"+ - "video platform beat where audience numbers are the payoff"+ - "viral video page with ticking stats"---<ComponentPreview name="video-watch-page" />diff --git a/content/docs/product-scenes/voice-agent.mdx b/content/docs/product-scenes/voice-agent.mdxindex fd6de896..fc1e903b 100644--- a/content/docs/product-scenes/voice-agent.mdx+++ b/content/docs/product-scenes/voice-agent.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The product is a text chat assistant, not a call — use `chat-flow` instead."- "You want an AI answer with citations rather than a spoken conversation — use `ai-answer-sources` instead."- "You only need a short kinetic text line about voice, no call UI — use `mono-voice` instead."+askedAs:+ - "ai phone call agent"+ - "voice assistant booking"+ - "a call transcript streams, the agent gets interrupted and then books a table"+ - "I want to show a voice AI handling a live conversation and a tool call"+ - "launch video proving a voice bot can be cut off and still finish the task"+ - "conversational ai restaurant reservation demo"---<ComponentPreview name="voice-agent" />diff --git a/content/docs/product-scenes/whats-new-modal.mdx b/content/docs/product-scenes/whats-new-modal.mdxindex 6a108146..069fc493 100644--- a/content/docs/product-scenes/whats-new-modal.mdx+++ b/content/docs/product-scenes/whats-new-modal.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a full changelog list scrolling — use `changelog-scroll`."- "You want camera moves through one screenshot — use `screenshot-tour`."- "You want callouts pointing at UI targets — use `ui-callout`."+askedAs:+ - "product update popup"+ - "release announcement slides"+ - "a dimmed dashboard with a modal paging through feature slides ending on a button click"+ - "I want an in-app changelog style announcement video"+ - "multi-feature recap in a few slides with a clear call to action"+ - "new features popup like linear or notion updates"---<ComponentPreview name="whats-new-modal" />diff --git a/content/docs/product-scenes/wireframe-to-final.mdx b/content/docs/product-scenes/wireframe-to-final.mdxindex 415e6c0e..dc8b099a 100644--- a/content/docs/product-scenes/wireframe-to-final.mdx+++ b/content/docs/product-scenes/wireframe-to-final.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want scattered windows collapsing into a tracker — use `chaos-to-order`."- "You want a loader that settles into a landing page — use `tile-snake-loader`."- "You want a camera tour of regions on a screenshot — use `screenshot-tour`."+askedAs:+ - "wireframe to finished ui"+ - "blueprint sketch becomes design"+ - "a grey wireframe with measurement lines gets swept into the real screenshot"+ - "I want idea to product shown as one transformation"+ - "design or no-code launch that reveals the polished result over a sketch"+ - "low fidelity layout turning into the final app"---<ComponentPreview name="wireframe-to-final" />diff --git a/content/docs/product-scenes/world-signups.mdx b/content/docs/product-scenes/world-signups.mdxindex b26dc753..139acfc0 100644--- a/content/docs/product-scenes/world-signups.mdx+++ b/content/docs/product-scenes/world-signups.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a single metric chart stepping through stages, not a map — use `analytics-funnel`."- "The beat is a general stats dashboard with a chart and activity list — use `live-dashboard`."- "You need a metric counting up in huge type with no map — use `row-count`."+askedAs:+ - "world map signups"+ - "global user pings"+ - "a dotted map pings city locations next to a rolling signup counter and live feed"+ - "I want to show users joining from all over the world in real time"+ - "growth slide proving worldwide traction"+ - "dotted globe with new customer dots appearing"---<ComponentPreview name="world-signups" />diff --git a/content/docs/shaders/components/shader-caustics.mdx b/content/docs/shaders/components/shader-caustics.mdxindex c40105c4..66b90406 100644--- a/content/docs/shaders/components/shader-caustics.mdx+++ b/content/docs/shaders/components/shader-caustics.mdx@@ -11,6 +11,13 @@ useWhen:avoidWhen:- "You want structured cellular noise — use `shader-voronoi`."- "You want soft fog instead of filaments — use `shader-perlin-noise`."+askedAs:+ - "light ripple filaments background"+ - "underwater light pattern"+ - "I want a calm elegant background of bright refracted light lines"+ - "pool bottom shimmer backdrop without strong direction"+ - "premium ambient scene that feels like sunlight through water"+ - "soft motion behind a title with glowing web-like light threads"---<ComponentPreview name="shader-caustics" />diff --git a/content/docs/shaders/components/shader-color-panels.mdx b/content/docs/shaders/components/shader-color-panels.mdxindex f07b2f7d..cdba9e5e 100644--- a/content/docs/shaders/components/shader-color-panels.mdx+++ b/content/docs/shaders/components/shader-color-panels.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want organic, flowing motion — use `shader-warp` or `shader-metaballs`."- "The overlap patterns would clutter dense foreground content — lower `density`."- "You need a single smooth gradient — use `shader-mesh-gradient`."+askedAs:+ - "glass panes background"+ - "sliding translucent panels"+ - "I want overlapping see-through color slabs gliding past each other"+ - "layered architectural backdrop, geometric not blobby"+ - "clean modern scene with depth from stacked colored panes"+ - "abstract frosted glass sheets moving behind product text"---<ComponentPreview name="shader-color-panels" />diff --git a/content/docs/shaders/components/shader-dithering.mdx b/content/docs/shaders/components/shader-dithering.mdxindex ad4b22c5..a7368261 100644--- a/content/docs/shaders/components/shader-dithering.mdx+++ b/content/docs/shaders/components/shader-dithering.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a centered dithered sphere — override `shape` (this wrapper defaults to full-bleed `\"wave\"`)."- "You want smooth, non-textured color — use `shader-mesh-gradient`."- "The dot pattern would reduce legibility of small text — raise `size` or use a solid `backdrop`."+askedAs:+ - "retro dither texture"+ - "1-bit halftone background"+ - "I want a pixelated dotted gradient like old print or bitmap"+ - "lo-fi tech backdrop with visible bayer dots"+ - "scene that feels like an early computer or newspaper print"+ - "moving gradient made of coarse dither pattern"---<ComponentPreview name="shader-dithering" />diff --git a/content/docs/shaders/components/shader-dot-orbit.mdx b/content/docs/shaders/components/shader-dot-orbit.mdxindex ea0be730..cf2e0fc5 100644--- a/content/docs/shaders/components/shader-dot-orbit.mdx+++ b/content/docs/shaders/components/shader-dot-orbit.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a static dot grid — the static `dot-grid` shader is intentionally not shipped; use a CSS grid."- "You want organic, flowing motion — use `shader-warp` or `shader-metaballs`."- "The regular pattern would clash with dense foreground content."+askedAs:+ - "orbiting dots background"+ - "dot grid motion"+ - "I want small dots circling on rings across the whole frame"+ - "tech backdrop that suggests a network or solar system"+ - "structured pattern of points moving gently behind a headline"+ - "concentric rings of dots for a systems themed intro"---<ComponentPreview name="shader-dot-orbit" />diff --git a/content/docs/shaders/components/shader-gem-smoke.mdx b/content/docs/shaders/components/shader-gem-smoke.mdxindex e6455d9f..69dd22db 100644--- a/content/docs/shaders/components/shader-gem-smoke.mdx+++ b/content/docs/shaders/components/shader-gem-smoke.mdx@@ -11,6 +11,13 @@ useWhen:avoidWhen:- "You have no logo or mark to feed as `image` — use `shader-smoke-ring` or `shader-neuro-noise` for a shapeless field instead."- "The brand mark should stay static and legible — the smoke will distort its read."+askedAs:+ - "smoke inside logo"+ - "logo filled with color flow"+ - "I want my logo shape to be glassy with colored fog moving in and around it"+ - "brand reveal where a static svg looks like crystal with swirling color"+ - "hero for a mark with living gradient inside the silhouette"+ - "logo silhouette as a window onto flowing color"---<ComponentPreview name="shader-gem-smoke" />diff --git a/content/docs/shaders/components/shader-god-rays.mdx b/content/docs/shaders/components/shader-god-rays.mdxindex ef9bd5fd..3fddb895 100644--- a/content/docs/shaders/components/shader-god-rays.mdx+++ b/content/docs/shaders/components/shader-god-rays.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The brief bans decorative glow — this is a genuine volumetric shader, but keep `bloom`/`intensity` restrained so it does not read as an AI-slop glow."- "You want structured or cellular motion — use `shader-dot-orbit` or `shader-voronoi`."- "Bright rays would wash out foreground text — lower `intensity`/`bloom`."+askedAs:+ - "light beams from corner"+ - "cinematic sun rays"+ - "I want volumetric rays shining in from off screen behind my title"+ - "moody atmospheric backdrop with beams of light and depth"+ - "reveal scene where light streams through haze"+ - "dramatic spotlight shafts for a movie style hero"---<ComponentPreview name="shader-god-rays" />diff --git a/content/docs/shaders/components/shader-grain-gradient/arcade.mdx b/content/docs/shaders/components/shader-grain-gradient/arcade.mdxindex 2a2c21b1..9a188dfd 100644--- a/content/docs/shaders/components/shader-grain-gradient/arcade.mdx+++ b/content/docs/shaders/components/shader-grain-gradient/arcade.mdx@@ -11,6 +11,13 @@ useWhen:avoidWhen:- "The video must use your brand colors — start from `shader-grain-gradient` and set `colors`."- "You want a lighter, contrasting mood from the same shader — use `shader-grain-gradient-blush`."+askedAs:+ - "retro game dots black background"+ - "orange yellow green grainy dots"+ - "I want an arcade style grainy dot pattern in orange, yellow and green on black"+ - "dark backdrop for light text with bold retro colors"+ - "game-like intro with speckled neon dots"+ - "8-bit vibe grainy backdrop for a playful launch"---<ComponentPreview name="shader-grain-gradient-arcade" />diff --git a/content/docs/shaders/components/shader-grain-gradient/blush.mdx b/content/docs/shaders/components/shader-grain-gradient/blush.mdxindex 6add7986..6ae1c359 100644--- a/content/docs/shaders/components/shader-grain-gradient/blush.mdx+++ b/content/docs/shaders/components/shader-grain-gradient/blush.mdx@@ -11,6 +11,13 @@ useWhen:avoidWhen:- "The video must use your brand colors — start from `shader-grain-gradient` and set `colors`."- "You want a darker, contrasting mood from the same shader — use `shader-grain-gradient-ultraviolet`."+askedAs:+ - "pastel pink grainy background"+ - "soft pink apricot blob"+ - "I want a light warm off-white scene with a blurry pink and peach blob"+ - "friendly consumer product backdrop where dark text stays readable"+ - "gentle morphing pastel shape for creator brands"+ - "blush peach grain gradient"---<ComponentPreview name="shader-grain-gradient-blush" />diff --git a/content/docs/shaders/components/shader-grain-gradient/dune.mdx b/content/docs/shaders/components/shader-grain-gradient/dune.mdxindex a4db64d1..0356d74d 100644--- a/content/docs/shaders/components/shader-grain-gradient/dune.mdx+++ b/content/docs/shaders/components/shader-grain-gradient/dune.mdx@@ -11,6 +11,13 @@ useWhen:avoidWhen:- "The video must use your brand colors — start from `shader-grain-gradient` and set `colors`."- "You want a lighter, contrasting mood from the same shader — use `shader-grain-gradient-nebula`."+askedAs:+ - "sand grain background"+ - "desert tan gradient"+ - "I want an earthy backdrop in tan, caramel and rust with heavy grain"+ - "analog sandy wave texture behind light text"+ - "warm desert dune mood for an organic brand"+ - "sandy rust grainy waves"---<ComponentPreview name="shader-grain-gradient-dune" />diff --git a/content/docs/shaders/components/shader-grain-gradient/horizon.mdx b/content/docs/shaders/components/shader-grain-gradient/horizon.mdxindex 4ce60013..a904c52e 100644--- a/content/docs/shaders/components/shader-grain-gradient/horizon.mdx+++ b/content/docs/shaders/components/shader-grain-gradient/horizon.mdx@@ -11,6 +11,13 @@ useWhen:avoidWhen:- "The video must use your brand colors — start from `shader-grain-gradient` and set `colors`."- "You want a lighter, contrasting mood from the same shader — use `shader-grain-gradient-arcade`."+askedAs:+ - "sunset horizon band"+ - "peach stripe navy sky"+ - "I want a wide landscape feel with a warm peach band between navy and pale sky"+ - "horizon line backdrop with grain for a calm landscape mood"+ - "dusk sky layers with film texture behind a title"+ - "navy and peach grainy horizon"---<ComponentPreview name="shader-grain-gradient-horizon" />diff --git a/content/docs/shaders/components/shader-grain-gradient/index.mdx b/content/docs/shaders/components/shader-grain-gradient/index.mdxindex 4e94d992..89ec4f04 100644--- a/content/docs/shaders/components/shader-grain-gradient/index.mdx+++ b/content/docs/shaders/components/shader-grain-gradient/index.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You need crisp, clean color with no texture — use `shader-mesh-gradient`."- "Foreground content is tiny text — heavy grain can reduce contrast; lower `intensity`/`noise` or pick a solid `backdrop`."- "You want structured geometry — use `shader-dot-orbit` or `shader-voronoi`."+askedAs:+ - "grainy gradient background"+ - "film grain gradient"+ - "I want an analog looking drifting color blend with noise texture"+ - "premium editorial backdrop that reads as print, not flat digital"+ - "slow moving grainy colors for a stylish title card"+ - "noisy multi color gradient wash"---<ComponentPreview name="shader-grain-gradient" />diff --git a/content/docs/shaders/components/shader-grain-gradient/nebula.mdx b/content/docs/shaders/components/shader-grain-gradient/nebula.mdxindex c81ae383..e73f2e69 100644--- a/content/docs/shaders/components/shader-grain-gradient/nebula.mdx+++ b/content/docs/shaders/components/shader-grain-gradient/nebula.mdx@@ -11,6 +11,13 @@ useWhen:avoidWhen:- "The video must use your brand colors — start from `shader-grain-gradient` and set `colors`."- "You want a lighter, contrasting mood from the same shader — use `shader-grain-gradient-blush`."+askedAs:+ - "space nebula background"+ - "magenta cyan cosmic glow"+ - "I want deep space with magenta and cyan light blooming from the corners"+ - "mysterious cosmic intro for an AI product"+ - "dark grainy galaxy backdrop for bright text"+ - "purple blue starless nebula haze"---<ComponentPreview name="shader-grain-gradient-nebula" />diff --git a/content/docs/shaders/components/shader-grain-gradient/orb.mdx b/content/docs/shaders/components/shader-grain-gradient/orb.mdxindex 3490188c..623f0b53 100644--- a/content/docs/shaders/components/shader-grain-gradient/orb.mdx+++ b/content/docs/shaders/components/shader-grain-gradient/orb.mdx@@ -11,6 +11,13 @@ useWhen:avoidWhen:- "The video must use your brand colors — start from `shader-grain-gradient` and set `colors`."- "You want a lighter, contrasting mood from the same shader — use `shader-grain-gradient-dune`."+askedAs:+ - "glowing orb background"+ - "periwinkle violet sphere"+ - "I want a big grainy ball in periwinkle, violet and pink behind my logo"+ - "single glowing object centered behind a title"+ - "soft sphere of color that frames a centered headline"+ - "grainy purple moon orb"---<ComponentPreview name="shader-grain-gradient-orb" />diff --git a/content/docs/shaders/components/shader-grain-gradient/sunrise.mdx b/content/docs/shaders/components/shader-grain-gradient/sunrise.mdxindex cd65c636..468532d1 100644--- a/content/docs/shaders/components/shader-grain-gradient/sunrise.mdx+++ b/content/docs/shaders/components/shader-grain-gradient/sunrise.mdx@@ -11,6 +11,13 @@ useWhen:avoidWhen:- "The video must use your brand colors — start from `shader-grain-gradient` and set `colors`."- "You want a lighter, contrasting mood from the same shader — use `shader-grain-gradient-tide`."+askedAs:+ - "sunrise gradient grain"+ - "coral gold over plum"+ - "I want a rising wave of coral and gold above a dark plum night"+ - "hopeful launch day backdrop, new beginning mood"+ - "dawn colors with grain for a new chapter announcement"+ - "orange yellow glow rising on purple"---<ComponentPreview name="shader-grain-gradient-sunrise" />diff --git a/content/docs/shaders/components/shader-grain-gradient/tide.mdx b/content/docs/shaders/components/shader-grain-gradient/tide.mdxindex 1891ff8f..c00159c6 100644--- a/content/docs/shaders/components/shader-grain-gradient/tide.mdx+++ b/content/docs/shaders/components/shader-grain-gradient/tide.mdx@@ -11,6 +11,13 @@ useWhen:avoidWhen:- "The video must use your brand colors — start from `shader-grain-gradient` and set `colors`."- "You want a lighter, contrasting mood from the same shader — use `shader-grain-gradient-blush`."+askedAs:+ - "teal ripple ring background"+ - "sonar pulse circles"+ - "I want a teal ring pulsing outward from a dark green center"+ - "ripple behind a centered number or logo"+ - "pulsing sea-green wave for a stat reveal"+ - "grainy sonar rings in dark teal"---<ComponentPreview name="shader-grain-gradient-tide" />diff --git a/content/docs/shaders/components/shader-grain-gradient/ultraviolet.mdx b/content/docs/shaders/components/shader-grain-gradient/ultraviolet.mdxindex d439be14..e625510e 100644--- a/content/docs/shaders/components/shader-grain-gradient/ultraviolet.mdx+++ b/content/docs/shaders/components/shader-grain-gradient/ultraviolet.mdx@@ -11,6 +11,13 @@ useWhen:avoidWhen:- "The video must use your brand colors — start from `shader-grain-gradient` and set `colors`."- "You want a lighter, contrasting mood from the same shader — use `shader-grain-gradient-blush`."+askedAs:+ - "electric magenta blue background"+ - "neon purple grainy blob"+ - "I want a loud ultraviolet blob in hot magenta and blue on black"+ - "bold nightlife style backdrop for a music edit"+ - "high energy hero for a daring launch"+ - "blacklight purple grainy gradient"---<ComponentPreview name="shader-grain-gradient-ultraviolet" />diff --git a/content/docs/shaders/components/shader-light-tunnel.mdx b/content/docs/shaders/components/shader-light-tunnel.mdxindex 54985fd0..a1986a11 100644--- a/content/docs/shaders/components/shader-light-tunnel.mdx+++ b/content/docs/shaders/components/shader-light-tunnel.mdx@@ -10,6 +10,13 @@ useWhen:avoidWhen:- "A quiet background should leave attention on dense UI — use `shader-mesh-gradient`."- "You need a flat liquid distortion instead of forward flight — use `shader-warp`."+askedAs:+ - "flying through light tunnel"+ - "hyperspace tunnel background"+ - "I want to travel forward through a glowing tunnel of light ribbons"+ - "title reveal with depth and speed through luminous streaks"+ - "warp speed intro with soft atmosphere"+ - "tunnel of light for a product intro"---<ComponentPreview name="shader-light-tunnel" />diff --git a/content/docs/shaders/components/shader-liquid-metal.mdx b/content/docs/shaders/components/shader-liquid-metal.mdxindex 1648f281..62d99b19 100644--- a/content/docs/shaders/components/shader-liquid-metal.mdx+++ b/content/docs/shaders/components/shader-liquid-metal.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a centered metallic emblem — override `shape` back to a paper shape (this wrapper defaults to full-bleed `\"none\"`)."- "The brief calls for color — liquid-metal is tonal; use `shader-warp` or `shader-mesh-gradient`."- "High contrast highlights would fight fine text — lower `contour`/`repetition`."+askedAs:+ - "chrome liquid background"+ - "molten metal surface"+ - "I want a flowing silver reflective surface with moving highlights"+ - "luxury industrial backdrop that looks like brushed metal"+ - "premium scene with shiny mercury-like material"+ - "liquid chrome shader"---<ComponentPreview name="shader-liquid-metal" />diff --git a/content/docs/shaders/components/shader-mesh-gradient/aurora.mdx b/content/docs/shaders/components/shader-mesh-gradient/aurora.mdxindex 7a8a86c5..be433647 100644--- a/content/docs/shaders/components/shader-mesh-gradient/aurora.mdx+++ b/content/docs/shaders/components/shader-mesh-gradient/aurora.mdx@@ -11,6 +11,13 @@ useWhen:avoidWhen:- "The video must use your brand colors — start from `shader-mesh-gradient` and set `colors`."- "You want a lighter, contrasting mood from the same shader — use `shader-mesh-gradient-peach`."+askedAs:+ - "northern lights background"+ - "cyan violet ribbons dark sky"+ - "I want swirling cyan and violet ribbons on a near-black night sky"+ - "dark backdrop for an AI or developer tool launch"+ - "aurora glow behind light text"+ - "teal purple night sky waves"---<ComponentPreview name="shader-mesh-gradient-aurora" />diff --git a/content/docs/shaders/components/shader-mesh-gradient/dusk.mdx b/content/docs/shaders/components/shader-mesh-gradient/dusk.mdxindex 20479e6f..9d43f1ef 100644--- a/content/docs/shaders/components/shader-mesh-gradient/dusk.mdx+++ b/content/docs/shaders/components/shader-mesh-gradient/dusk.mdx@@ -11,6 +11,13 @@ useWhen:avoidWhen:- "The video must use your brand colors — start from `shader-mesh-gradient` and set `colors`."- "You want a lighter, contrasting mood from the same shader — use `shader-mesh-gradient-peach`."+askedAs:+ - "evening twilight gradient"+ - "violet dusk coral peach"+ - "I want dusky indigo with coral and peach light drifting through"+ - "end of day mood for a closing card"+ - "soft sunset sky behind a launch title"+ - "purple twilight with warm light"---<ComponentPreview name="shader-mesh-gradient-dusk" />diff --git a/content/docs/shaders/components/shader-mesh-gradient/ember.mdx b/content/docs/shaders/components/shader-mesh-gradient/ember.mdxindex bef40c50..a704a966 100644--- a/content/docs/shaders/components/shader-mesh-gradient/ember.mdx+++ b/content/docs/shaders/components/shader-mesh-gradient/ember.mdx@@ -11,6 +11,13 @@ useWhen:avoidWhen:- "The video must use your brand colors — start from `shader-mesh-gradient` and set `colors`."- "You want a lighter, contrasting mood from the same shader — use `shader-mesh-gradient-mint`."+askedAs:+ - "molten orange background"+ - "fiery amber on dark red"+ - "I want glowing orange and amber pooling in deep oxblood"+ - "bold warm hero for an energetic announcement"+ - "lava heat gradient behind white text"+ - "burnt orange dark maroon mesh"---<ComponentPreview name="shader-mesh-gradient-ember" />diff --git a/content/docs/shaders/components/shader-mesh-gradient/index.mdx b/content/docs/shaders/components/shader-mesh-gradient/index.mdxindex 34c21daf..943e5807 100644--- a/content/docs/shaders/components/shader-mesh-gradient/index.mdx+++ b/content/docs/shaders/components/shader-mesh-gradient/index.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a structured, geometric background — use `shader-dot-orbit` or `shader-voronoi`."- "The shader must animate on a wall clock rather than the timeline — these wrappers are frame-driven by design; that is what keeps renders deterministic."- "You need a static, single-frame image — a solid `backdrop` fill is lighter."+askedAs:+ - "animated gradient backdrop"+ - "flowing color mesh"+ - "I want a high quality slowly shifting multicolor background"+ - "hero scene with living color behind text that does not compete"+ - "smooth blended gradient for a title or product intro"+ - "aurora style color blobs that drift"---<ComponentPreview name="shader-mesh-gradient" />diff --git a/content/docs/shaders/components/shader-mesh-gradient/ink.mdx b/content/docs/shaders/components/shader-mesh-gradient/ink.mdxindex ebc67db2..55ae6332 100644--- a/content/docs/shaders/components/shader-mesh-gradient/ink.mdx+++ b/content/docs/shaders/components/shader-mesh-gradient/ink.mdx@@ -11,6 +11,13 @@ useWhen:avoidWhen:- "The video must use your brand colors — start from `shader-mesh-gradient` and set `colors`."- "You want a lighter, contrasting mood from the same shader — use `shader-mesh-gradient-lagoon`."+askedAs:+ - "black and white ink background"+ - "charcoal silver monochrome"+ - "I want gray ink-like folds with grain, no color"+ - "editorial monochrome backdrop so a colorful product shot stands out"+ - "neutral dark smoky texture for light text"+ - "grayscale marbled gradient"---<ComponentPreview name="shader-mesh-gradient-ink" />diff --git a/content/docs/shaders/components/shader-mesh-gradient/lagoon.mdx b/content/docs/shaders/components/shader-mesh-gradient/lagoon.mdxindex 23c5a60b..3ae75d4a 100644--- a/content/docs/shaders/components/shader-mesh-gradient/lagoon.mdx+++ b/content/docs/shaders/components/shader-mesh-gradient/lagoon.mdx@@ -11,6 +11,13 @@ useWhen:avoidWhen:- "The video must use your brand colors — start from `shader-mesh-gradient` and set `colors`."- "You want a darker, contrasting mood from the same shader — use `shader-mesh-gradient-ember`."+askedAs:+ - "bright aqua teal background"+ - "tropical lagoon gradient"+ - "I want fresh turquoise shallows fading into deep blue"+ - "calm open product intro with a light palette"+ - "clear water colors with dark text on top"+ - "aqua and teal gradient"---<ComponentPreview name="shader-mesh-gradient-lagoon" />diff --git a/content/docs/shaders/components/shader-mesh-gradient/lavender.mdx b/content/docs/shaders/components/shader-mesh-gradient/lavender.mdxindex 9273e6ec..4df12d2f 100644--- a/content/docs/shaders/components/shader-mesh-gradient/lavender.mdx+++ b/content/docs/shaders/components/shader-mesh-gradient/lavender.mdx@@ -11,6 +11,13 @@ useWhen:avoidWhen:- "The video must use your brand colors — start from `shader-mesh-gradient` and set `colors`."- "You want a darker, contrasting mood from the same shader — use `shader-mesh-gradient-ember`."+askedAs:+ - "soft lilac pink haze"+ - "dreamy pastel background"+ - "I want a gentle lavender and pink fog that stays quiet behind copy"+ - "light airy title card, soft and calm"+ - "pale purple gradient with soft edges"+ - "dreamy pink lilac wash"---<ComponentPreview name="shader-mesh-gradient-lavender" />diff --git a/content/docs/shaders/components/shader-mesh-gradient/mint.mdx b/content/docs/shaders/components/shader-mesh-gradient/mint.mdxindex ff39e9ee..086685ee 100644--- a/content/docs/shaders/components/shader-mesh-gradient/mint.mdx+++ b/content/docs/shaders/components/shader-mesh-gradient/mint.mdx@@ -11,6 +11,13 @@ useWhen:avoidWhen:- "The video must use your brand colors — start from `shader-mesh-gradient` and set `colors`."- "You want a darker, contrasting mood from the same shader — use `shader-mesh-gradient-ink`."+askedAs:+ - "mint green pastel background"+ - "fresh sky blue green wash"+ - "I want a light mint and sky-blue backdrop with a greener center"+ - "clean intro for a health, finance or productivity app"+ - "airy pastel scene where dark text is readable"+ - "minty pastel gradient"---<ComponentPreview name="shader-mesh-gradient-mint" />diff --git a/content/docs/shaders/components/shader-mesh-gradient/peach.mdx b/content/docs/shaders/components/shader-mesh-gradient/peach.mdxindex 8b70d01a..d145502e 100644--- a/content/docs/shaders/components/shader-mesh-gradient/peach.mdx+++ b/content/docs/shaders/components/shader-mesh-gradient/peach.mdx@@ -11,6 +11,13 @@ useWhen:avoidWhen:- "The video must use your brand colors — start from `shader-mesh-gradient` and set `colors`."- "You want a darker, contrasting mood from the same shader — use `shader-mesh-gradient-synthwave`."+askedAs:+ - "peach cream background"+ - "warm soft glow with film grain"+ - "I want a cozy peach and cream backdrop with a hint of grain"+ - "friendly wellness or lifestyle scene"+ - "gentle warm light for a calm brand video"+ - "light peach gradient"---<ComponentPreview name="shader-mesh-gradient-peach" />diff --git a/content/docs/shaders/components/shader-mesh-gradient/synthwave.mdx b/content/docs/shaders/components/shader-mesh-gradient/synthwave.mdxindex d99dfa24..7ec34319 100644--- a/content/docs/shaders/components/shader-mesh-gradient/synthwave.mdx+++ b/content/docs/shaders/components/shader-mesh-gradient/synthwave.mdx@@ -11,6 +11,13 @@ useWhen:avoidWhen:- "The video must use your brand colors — start from `shader-mesh-gradient` and set `colors`."- "You want a lighter, contrasting mood from the same shader — use `shader-mesh-gradient-lagoon`."+askedAs:+ - "synthwave night background"+ - "purple with orange sunset glow"+ - "I want a dark purple field lit by a coral glow at one edge"+ - "retro futuristic vaporwave scene"+ - "80s outrun mood behind light text"+ - "night purple and warm pink glow"---<ComponentPreview name="shader-mesh-gradient-synthwave" />diff --git a/content/docs/shaders/components/shader-metaballs.mdx b/content/docs/shaders/components/shader-metaballs.mdxindex 1851d99e..3804eceb 100644--- a/content/docs/shaders/components/shader-metaballs.mdx+++ b/content/docs/shaders/components/shader-metaballs.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The brand is strictly serious/corporate — metaballs read playful."- "You want structured or geometric motion — use `shader-dot-orbit` or `shader-voronoi`."- "Blobs would obscure dense foreground content — lower `count`/`size`."+askedAs:+ - "lava lamp blobs"+ - "merging blobs background"+ - "I want soft round blobs that join and split apart"+ - "playful organic motion that is fun but not childish"+ - "goo like shapes drifting behind a title"+ - "bubbly liquid blobs backdrop"---<ComponentPreview name="shader-metaballs" />diff --git a/content/docs/shaders/components/shader-neuro-noise.mdx b/content/docs/shaders/components/shader-neuro-noise.mdxindex cc17f1de..3c9c10a1 100644--- a/content/docs/shaders/components/shader-neuro-noise.mdx+++ b/content/docs/shaders/components/shader-neuro-noise.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want smooth cloud noise instead of web filaments — use `shader-perlin-noise` or `shader-simplex-noise`."- "The brief is playful or warm — neuro-noise reads technical."- "Bright filaments would fight small text — lower `brightness`/`contrast`."+askedAs:+ - "neural network texture"+ - "ai brain web background"+ - "I want an organic web of branching lines that slowly morphs"+ - "intelligence themed backdrop for an AI or ML product"+ - "slow evolving structure behind text with soft edges"+ - "brain synapse like pattern"---<ComponentPreview name="shader-neuro-noise" />diff --git a/content/docs/shaders/components/shader-perlin-noise.mdx b/content/docs/shaders/components/shader-perlin-noise.mdxindex e276cd4e..63206d7b 100644--- a/content/docs/shaders/components/shader-perlin-noise.mdx+++ b/content/docs/shaders/components/shader-perlin-noise.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a smoother, more flowing field — use `shader-simplex-noise`."- "You want neural-web filaments — use `shader-neuro-noise`."- "You need sharp cellular structure — use `shader-voronoi`."+askedAs:+ - "cloudy noise background"+ - "soft drifting clouds"+ - "I want a calm cloud-like texture with no strong color"+ - "clean scene that needs texture without structure"+ - "dusty smoky haze that moves slowly"+ - "classic noise clouds"---<ComponentPreview name="shader-perlin-noise" />diff --git a/content/docs/shaders/components/shader-pulsing-border.mdx b/content/docs/shaders/components/shader-pulsing-border.mdxindex 9dbba778..cb36612c 100644--- a/content/docs/shaders/components/shader-pulsing-border.mdx+++ b/content/docs/shaders/components/shader-pulsing-border.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The brief bans decorative glow — keep `bloom`/`intensity` restrained so the border does not read as AI-slop neon."- "You want a full-field texture — the interior stays mostly `colorBack`; use a noise or gradient shader."- "The scene already has a strong border/frame in the layout."+askedAs:+ - "glowing frame edge"+ - "pulsing screen border"+ - "I want a light-up border pulsing around the edges of the frame"+ - "premium reveal with edge glow and a clear center"+ - "neon outline framing the content"+ - "glowing vignette frame"---<ComponentPreview name="shader-pulsing-border" />diff --git a/content/docs/shaders/components/shader-simplex-noise.mdx b/content/docs/shaders/components/shader-simplex-noise.mdxindex af4ac66d..65765115 100644--- a/content/docs/shaders/components/shader-simplex-noise.mdx+++ b/content/docs/shaders/components/shader-simplex-noise.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want cloudier, softer fog — use `shader-perlin-noise`."- "You want cellular structure — use `shader-voronoi`."- "You want neural-web filaments — use `shader-neuro-noise`."+askedAs:+ - "smooth noise flow background"+ - "minimal color drift"+ - "I want the smoothest noise backdrop with gentle multi color drift"+ - "clean minimal scene with soft flowing color"+ - "subtle moving gradient with no directional artifacts"+ - "silky flow field"---<ComponentPreview name="shader-simplex-noise" />diff --git a/content/docs/shaders/components/shader-smoke-ring.mdx b/content/docs/shaders/components/shader-smoke-ring.mdxindex c080fdb7..b1f08a87 100644--- a/content/docs/shaders/components/shader-smoke-ring.mdx+++ b/content/docs/shaders/components/shader-smoke-ring.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You need a full-bleed edge-to-edge texture — this is a centered object; use a noise or gradient shader."- "The center sits behind key text — the ring draws the eye inward."- "You want multiple elements or busy motion — smoke-ring is deliberately singular."+askedAs:+ - "smoke ring background"+ - "single curling smoke shape"+ - "I want one soft ring of smoke in the center on a dark field"+ - "minimal premium scene with a hazy circle dissipating"+ - "focal atmospheric halo behind a logo"+ - "vapor ring"---<ComponentPreview name="shader-smoke-ring" />diff --git a/content/docs/shaders/components/shader-spiral.mdx b/content/docs/shaders/components/shader-spiral.mdxindex 9f65a0b9..5c1bae24 100644--- a/content/docs/shaders/components/shader-spiral.mdx+++ b/content/docs/shaders/components/shader-spiral.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want closed concentric rings rather than open arms — use `shader-swirl`."- "The center sits behind key text — the convergence point competes for attention."- "You need multi-color richness — spiral is duotone by default; use `shader-warp`."+askedAs:+ - "rotating spiral arms"+ - "hypnotic radial background"+ - "I want spiral arms spinning outward from the center"+ - "transition-like intro pulling the eye inward"+ - "dizzy rotating pinwheel pattern"+ - "spinning galaxy arms"---<ComponentPreview name="shader-spiral" />diff --git a/content/docs/shaders/components/shader-strata.mdx b/content/docs/shaders/components/shader-strata.mdxindex c98d4363..1f1d2c10 100644--- a/content/docs/shaders/components/shader-strata.mdx+++ b/content/docs/shaders/components/shader-strata.mdx@@ -11,6 +11,13 @@ useWhen:avoidWhen:- "You want motion with a clear direction or flow — use `shader-warp`."- "You want cellular texture instead of layered sediment — use `shader-voronoi`."+askedAs:+ - "layered sediment background"+ - "horizontal rock layers"+ - "I want fine horizontal stripes of different depth drifting slowly"+ - "grounded geological backdrop for built on stability stories"+ - "calm scene with layered texture and no directional motion"+ - "earth strata lines"---<ComponentPreview name="shader-strata" />diff --git a/content/docs/shaders/components/shader-swirl/candy.mdx b/content/docs/shaders/components/shader-swirl/candy.mdxindex a4000827..ac5d2ecf 100644--- a/content/docs/shaders/components/shader-swirl/candy.mdx+++ b/content/docs/shaders/components/shader-swirl/candy.mdx@@ -11,6 +11,13 @@ useWhen:avoidWhen:- "The video must use your brand colors — start from `shader-swirl` and set `colors`."- "You want a darker, contrasting mood from the same shader — use `shader-swirl-hypno`."+askedAs:+ - "candy swirl pastel"+ - "pink lilac blue spiral"+ - "I want a sweet pastel spiral in pink, lilac and sky blue"+ - "playful opener for a consumer product with light colors"+ - "soft cotton candy vortex"+ - "bubblegum pastel swirl"---<ComponentPreview name="shader-swirl-candy" />diff --git a/content/docs/shaders/components/shader-swirl/citrus.mdx b/content/docs/shaders/components/shader-swirl/citrus.mdxindex 5341ae58..e056bd47 100644--- a/content/docs/shaders/components/shader-swirl/citrus.mdx+++ b/content/docs/shaders/components/shader-swirl/citrus.mdx@@ -11,6 +11,13 @@ useWhen:avoidWhen:- "The video must use your brand colors — start from `shader-swirl` and set `colors`."- "You want a darker, contrasting mood from the same shader — use `shader-swirl-tide`."+askedAs:+ - "citrus colors swirl"+ - "yellow pink green bands on cream"+ - "I want juicy bands of yellow, pink and green spiraling on cream"+ - "upbeat summer opener"+ - "fruity colorful spiral"+ - "lemon lime swirl"---<ComponentPreview name="shader-swirl-citrus" />diff --git a/content/docs/shaders/components/shader-swirl/ember.mdx b/content/docs/shaders/components/shader-swirl/ember.mdxindex 3b8b0c41..736be363 100644--- a/content/docs/shaders/components/shader-swirl/ember.mdx+++ b/content/docs/shaders/components/shader-swirl/ember.mdx@@ -11,6 +11,13 @@ useWhen:avoidWhen:- "The video must use your brand colors — start from `shader-swirl` and set `colors`."- "You want a lighter, contrasting mood from the same shader — use `shader-swirl-lilac`."+askedAs:+ - "fire vortex"+ - "gold orange spinning"+ - "I want fire-colored gold and orange bands spinning around a dark center"+ - "intense energetic beat with a fiery whirl"+ - "burning spiral behind white text"+ - "orange flame swirl"---<ComponentPreview name="shader-swirl-ember" />diff --git a/content/docs/shaders/components/shader-swirl/hypno.mdx b/content/docs/shaders/components/shader-swirl/hypno.mdxindex bd4d5e38..17e7b866 100644--- a/content/docs/shaders/components/shader-swirl/hypno.mdx+++ b/content/docs/shaders/components/shader-swirl/hypno.mdx@@ -11,6 +11,13 @@ useWhen:avoidWhen:- "The video must use your brand colors — start from `shader-swirl` and set `colors`."- "You want a lighter, contrasting mood from the same shader — use `shader-swirl-candy`."+askedAs:+ - "black white spiral"+ - "hypnotic optical illusion"+ - "I want a high contrast monochrome spiral pulling the eye to the middle"+ - "attention-grabbing beat with stark lines"+ - "optical illusion style background"+ - "hypnosis spiral"---<ComponentPreview name="shader-swirl-hypno" />diff --git a/content/docs/shaders/components/shader-swirl/index.mdx b/content/docs/shaders/components/shader-swirl/index.mdxindex 4fc5bffc..0e44bf9a 100644--- a/content/docs/shaders/components/shader-swirl/index.mdx+++ b/content/docs/shaders/components/shader-swirl/index.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want free-flowing liquid folds rather than concentric bands — use `shader-warp`."- "The center would sit behind critical text — the convergence point draws the eye."- "You want spiral arms instead of closed rings — use `shader-spiral`."+askedAs:+ - "spinning concentric bands"+ - "radial banded background"+ - "I want bands rotating around a center point"+ - "hypnotic radial scene with clear stripes"+ - "rotational motion that reads as spinning"+ - "vortex bands"---<ComponentPreview name="shader-swirl" />diff --git a/content/docs/shaders/components/shader-swirl/lilac.mdx b/content/docs/shaders/components/shader-swirl/lilac.mdxindex 5e670a10..86ccbc8f 100644--- a/content/docs/shaders/components/shader-swirl/lilac.mdx+++ b/content/docs/shaders/components/shader-swirl/lilac.mdx@@ -11,6 +11,13 @@ useWhen:avoidWhen:- "The video must use your brand colors — start from `shader-swirl` and set `colors`."- "You want a darker, contrasting mood from the same shader — use `shader-swirl-ember`."+askedAs:+ - "lilac baby blue swirl"+ - "dreamy soft vortex"+ - "I want a gentle lilac and light blue swirl around a dark eye"+ - "soft background that stays out of the way of copy"+ - "pastel whirl with light mood"+ - "pale purple spiral"---<ComponentPreview name="shader-swirl-lilac" />diff --git a/content/docs/shaders/components/shader-swirl/neon.mdx b/content/docs/shaders/components/shader-swirl/neon.mdxindex 5ce62a2f..8bc729d0 100644--- a/content/docs/shaders/components/shader-swirl/neon.mdx+++ b/content/docs/shaders/components/shader-swirl/neon.mdx@@ -11,6 +11,13 @@ useWhen:avoidWhen:- "The video must use your brand colors — start from `shader-swirl` and set `colors`."- "You want a lighter, contrasting mood from the same shader — use `shader-swirl-candy`."+askedAs:+ - "neon vortex"+ - "teal purple pink spiral"+ - "I want a glowing neon swirl in teal, purple and pink around a dark core"+ - "logo reveal over a vivid vortex"+ - "cyberpunk spiral behind a centered mark"+ - "neon whirlpool"---<ComponentPreview name="shader-swirl-neon" />diff --git a/content/docs/shaders/components/shader-swirl/retro.mdx b/content/docs/shaders/components/shader-swirl/retro.mdxindex 76227534..b590bbd4 100644--- a/content/docs/shaders/components/shader-swirl/retro.mdx+++ b/content/docs/shaders/components/shader-swirl/retro.mdx@@ -11,6 +11,13 @@ useWhen:avoidWhen:- "The video must use your brand colors — start from `shader-swirl` and set `colors`."- "You want a darker, contrasting mood from the same shader — use `shader-swirl-neon`."+askedAs:+ - "seventies spiral"+ - "orange sand teal swirl"+ - "I want a vintage 70s swirl in orange, sand and teal"+ - "nostalgic edit with retro colors"+ - "old poster style spiral"+ - "retro groovy vortex"---<ComponentPreview name="shader-swirl-retro" />diff --git a/content/docs/shaders/components/shader-swirl/sunburst.mdx b/content/docs/shaders/components/shader-swirl/sunburst.mdxindex 69fc4652..910aa4fb 100644--- a/content/docs/shaders/components/shader-swirl/sunburst.mdx+++ b/content/docs/shaders/components/shader-swirl/sunburst.mdx@@ -11,6 +11,13 @@ useWhen:avoidWhen:- "The video must use your brand colors — start from `shader-swirl` and set `colors`."- "You want a darker, contrasting mood from the same shader — use `shader-swirl-neon`."+askedAs:+ - "retro sunburst background"+ - "cream orange sun rays"+ - "I want cream and orange bands sweeping in from the top"+ - "sunny retro burst behind a title"+ - "vintage sunshine beams"+ - "retro orange radial"---<ComponentPreview name="shader-swirl-sunburst" />diff --git a/content/docs/shaders/components/shader-swirl/tide.mdx b/content/docs/shaders/components/shader-swirl/tide.mdxindex 24f84ed5..ed6da673 100644--- a/content/docs/shaders/components/shader-swirl/tide.mdx+++ b/content/docs/shaders/components/shader-swirl/tide.mdx@@ -11,6 +11,13 @@ useWhen:avoidWhen:- "The video must use your brand colors — start from `shader-swirl` and set `colors`."- "You want a lighter, contrasting mood from the same shader — use `shader-swirl-citrus`."+askedAs:+ - "blue whirlpool"+ - "navy silky spiral"+ - "I want smooth blue bands twisting into a deep navy whirlpool"+ - "calm deep silky motion, not loud"+ - "ocean vortex behind light text"+ - "dark blue swirl"---<ComponentPreview name="shader-swirl-tide" />diff --git a/content/docs/shaders/components/shader-voronoi.mdx b/content/docs/shaders/components/shader-voronoi.mdxindex fcb1b436..1e4cab9c 100644--- a/content/docs/shaders/components/shader-voronoi.mdx+++ b/content/docs/shaders/components/shader-voronoi.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want soft, structureless fog — use `shader-perlin-noise` or `shader-simplex-noise`."- "You want a glow-heavy look — `glow` defaults to `0` on purpose; keep it low to avoid decorative bloom."- "Busy cells would clutter dense foreground content — lower `distortion` or use a solid `backdrop`."+askedAs:+ - "cell pattern background"+ - "crystal tessellation"+ - "I want shifting cells with dark gaps between them"+ - "tech scene with clear crystalline structure"+ - "cracked glass or mosaic that re-forms"+ - "voronoi cells"---<ComponentPreview name="shader-voronoi" />diff --git a/content/docs/shaders/components/shader-warp/acid.mdx b/content/docs/shaders/components/shader-warp/acid.mdxindex e190b2e8..9f925625 100644--- a/content/docs/shaders/components/shader-warp/acid.mdx+++ b/content/docs/shaders/components/shader-warp/acid.mdx@@ -11,6 +11,13 @@ useWhen:avoidWhen:- "The video must use your brand colors — start from `shader-warp` and set `colors`."- "You want a lighter, contrasting mood from the same shader — use `shader-warp-cream`."+askedAs:+ - "lime cyan fluid"+ - "acid green background"+ - "I want a loud lime and cyan liquid swirling on black"+ - "hype cut with attention-grabbing neon fluid"+ - "toxic bright marble backdrop"+ - "acid liquid"---<ComponentPreview name="shader-warp-acid" />diff --git a/content/docs/shaders/components/shader-warp/cream.mdx b/content/docs/shaders/components/shader-warp/cream.mdxindex 91129317..ea31d63a 100644--- a/content/docs/shaders/components/shader-warp/cream.mdx+++ b/content/docs/shaders/components/shader-warp/cream.mdx@@ -11,6 +11,13 @@ useWhen:avoidWhen:- "The video must use your brand colors — start from `shader-warp` and set `colors`."- "You want a darker, contrasting mood from the same shader — use `shader-warp-acid`."+askedAs:+ - "soft peach coral gradient"+ - "barely moving warm background"+ - "I want a very gentle peach to coral cream drift behind dense text"+ - "light backdrop that does not distract from UI"+ - "calm warm wash for a text heavy scene"+ - "cream coral liquid"---<ComponentPreview name="shader-warp-cream" />diff --git a/content/docs/shaders/components/shader-warp/deep-sea.mdx b/content/docs/shaders/components/shader-warp/deep-sea.mdxindex 5975a35f..6b09a675 100644--- a/content/docs/shaders/components/shader-warp/deep-sea.mdx+++ b/content/docs/shaders/components/shader-warp/deep-sea.mdx@@ -11,6 +11,13 @@ useWhen:avoidWhen:- "The video must use your brand colors — start from `shader-warp` and set `colors`."- "You want a lighter, contrasting mood from the same shader — use `shader-warp-sunset`."+askedAs:+ - "teal bands midnight blue"+ - "diagonal ripple stripes"+ - "I want diagonal teal bands rippling through midnight blue"+ - "rhythmic steady banded background"+ - "deep ocean stripes behind light text"+ - "dark teal waves"---<ComponentPreview name="shader-warp-deep-sea" />diff --git a/content/docs/shaders/components/shader-warp/index.mdx b/content/docs/shaders/components/shader-warp/index.mdxindex 145113c5..87c932c7 100644--- a/content/docs/shaders/components/shader-warp/index.mdx+++ b/content/docs/shaders/components/shader-warp/index.mdx@@ -12,6 +12,13 @@ avoidWhen:- "Text legibility over the whole frame is critical — raise `softness` and keep `distortion` low, or use a solid `backdrop`."- "You want tight, repeating structure — use `shader-swirl` (banded) or `shader-spiral`."- "You need a metallic sheen rather than color folds — use `shader-liquid-metal`."+askedAs:+ - "liquid color background"+ - "flowing fluid gradient"+ - "I want a color field that folds and stretches like liquid"+ - "hero scene with organic motion that stays out of the way"+ - "alive alternative to a static gradient"+ - "melting colors"---<ComponentPreview name="shader-warp" />diff --git a/content/docs/shaders/components/shader-warp/marble.mdx b/content/docs/shaders/components/shader-warp/marble.mdxindex ea62c3c9..8c114408 100644--- a/content/docs/shaders/components/shader-warp/marble.mdx+++ b/content/docs/shaders/components/shader-warp/marble.mdx@@ -11,6 +11,13 @@ useWhen:avoidWhen:- "The video must use your brand colors — start from `shader-warp` and set `colors`."- "You want a darker, contrasting mood from the same shader — use `shader-warp-acid`."+askedAs:+ - "marble texture background"+ - "cream charcoal veins"+ - "I want swirling marble veins in cream and charcoal"+ - "editorial neutral material backdrop"+ - "luxury stone look with dark text"+ - "black and cream marble"---<ComponentPreview name="shader-warp-marble" />diff --git a/content/docs/shaders/components/shader-warp/ocean.mdx b/content/docs/shaders/components/shader-warp/ocean.mdxindex 2cc42a6e..f52cf8a4 100644--- a/content/docs/shaders/components/shader-warp/ocean.mdx+++ b/content/docs/shaders/components/shader-warp/ocean.mdx@@ -11,6 +11,13 @@ useWhen:avoidWhen:- "The video must use your brand colors — start from `shader-warp` and set `colors`."- "You want a darker, contrasting mood from the same shader — use `shader-warp-cream`."+askedAs:+ - "glossy aqua background"+ - "ink outlined water currents"+ - "I want glossy aqua currents traced with dark ink edges"+ - "high contrast fluid scene with crisp lines"+ - "cartoonish water flow backdrop"+ - "aqua ink swirl"---<ComponentPreview name="shader-warp-ocean" />diff --git a/content/docs/shaders/components/shader-warp/rose-gold.mdx b/content/docs/shaders/components/shader-warp/rose-gold.mdxindex 51e5f01e..b46bc5e1 100644--- a/content/docs/shaders/components/shader-warp/rose-gold.mdx+++ b/content/docs/shaders/components/shader-warp/rose-gold.mdx@@ -11,6 +11,13 @@ useWhen:avoidWhen:- "The video must use your brand colors — start from `shader-warp` and set `colors`."- "You want a darker, contrasting mood from the same shader — use `shader-warp-acid`."+askedAs:+ - "rose gold satin background"+ - "pink gold folds"+ - "I want soft satin rose-gold folds with a sheen"+ - "beauty or fashion brand backdrop"+ - "metallic fabric look for lifestyle products"+ - "rose gold silk"---<ComponentPreview name="shader-warp-rose-gold" />diff --git a/content/docs/shaders/components/shader-warp/silk.mdx b/content/docs/shaders/components/shader-warp/silk.mdxindex 786a5274..a3059a9b 100644--- a/content/docs/shaders/components/shader-warp/silk.mdx+++ b/content/docs/shaders/components/shader-warp/silk.mdx@@ -11,6 +11,13 @@ useWhen:avoidWhen:- "The video must use your brand colors — start from `shader-warp` and set `colors`."- "You want a darker, contrasting mood from the same shader — use `shader-warp-acid`."+askedAs:+ - "violet pink silk"+ - "luxury fabric background"+ - "I want slow liquid silk waves in violet and pink"+ - "premium brand moment with soft motion"+ - "elegant draped cloth backdrop"+ - "purple satin waves"---<ComponentPreview name="shader-warp-silk" />diff --git a/content/docs/shaders/components/shader-warp/storm.mdx b/content/docs/shaders/components/shader-warp/storm.mdxindex 731468f3..d938fd69 100644--- a/content/docs/shaders/components/shader-warp/storm.mdx+++ b/content/docs/shaders/components/shader-warp/storm.mdx@@ -11,6 +11,13 @@ useWhen:avoidWhen:- "The video must use your brand colors — start from `shader-warp` and set `colors`."- "You want a lighter, contrasting mood from the same shader — use `shader-warp-cream`."+askedAs:+ - "violet storm clouds"+ - "dramatic purple marbled fluid"+ - "I want a turbulent deep violet and lavender storm"+ - "dramatic intro with swirling dark purple"+ - "brooding stormy sky backdrop"+ - "purple tempest"---<ComponentPreview name="shader-warp-storm" />diff --git a/content/docs/shaders/components/shader-warp/sunset.mdx b/content/docs/shaders/components/shader-warp/sunset.mdxindex 0cf544e2..f7374a06 100644--- a/content/docs/shaders/components/shader-warp/sunset.mdx+++ b/content/docs/shaders/components/shader-warp/sunset.mdx@@ -11,6 +11,13 @@ useWhen:avoidWhen:- "The video must use your brand colors — start from `shader-warp` and set `colors`."- "You want a darker, contrasting mood from the same shader — use `shader-warp-deep-sea`."+askedAs:+ - "coral peach wine liquid"+ - "warm marbled sunset"+ - "I want coral, peach and wine colors flowing like warm liquid"+ - "warm living backdrop with no hard edges"+ - "sunset swirled paint"+ - "orange pink marbled flow"---<ComponentPreview name="shader-warp-sunset" />diff --git a/content/docs/shaders/components/shader-water.mdx b/content/docs/shaders/components/shader-water.mdxindex c38539b2..0724fb1a 100644--- a/content/docs/shaders/components/shader-water.mdx+++ b/content/docs/shaders/components/shader-water.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The palette must be warm or vibrant — water reads cool by design; recolor via `colorHighlight`/`colorBack` or choose another shader."- "You want sharp geometric motion — use `shader-swirl` or `shader-dot-orbit`."- "Bright caustics would fight small text — lower `caustic`/`highlights` or use a solid `backdrop`."+askedAs:+ - "water surface ripples"+ - "pool water background"+ - "I want calm dark blue water with gentle light refraction"+ - "aquatic atmosphere that moves slowly"+ - "cool ocean backdrop that does not pull focus"+ - "rippling lake"---<ComponentPreview name="shader-water" />diff --git a/content/docs/shaders/components/shader-weave.mdx b/content/docs/shaders/components/shader-weave.mdxindex ff9efcdd..a2bf66f3 100644--- a/content/docs/shaders/components/shader-weave.mdx+++ b/content/docs/shaders/components/shader-weave.mdx@@ -11,6 +11,13 @@ useWhen:avoidWhen:- "You want a smooth gradient field — use `shader-mesh-gradient`."- "You want organic noise instead of a woven structure — use `shader-neuro-noise`."+askedAs:+ - "woven fabric background"+ - "thread mesh texture"+ - "I want crossing threads forming a woven surface with a light sheen"+ - "tactile crafted look for made-of metaphors"+ - "slow glow traveling across textured cloth"+ - "warp and weft grid"---<ComponentPreview name="shader-weave" />diff --git a/content/docs/social/crash-zoom.mdx b/content/docs/social/crash-zoom.mdxindex 793a3d21..fd58c6a6 100644--- a/content/docs/social/crash-zoom.mdx+++ b/content/docs/social/crash-zoom.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The claim needs two separate slams in a row (stop, then payoff) — use `hook-punch`."- "You want a calm editorial intro with no camera shake or speed lines — use `focus-blur-resolve`."- "You need a setup line that reads as a social post format before the punchline — use `pov-setup`."+askedAs:+ - "crash zoom reveal"+ - "shaky zoom with speed lines"+ - "a calm serif line then a violent zoom into a huge 1 DAY claim"+ - "I want a loud hook that punches in on one big number"+ - "short-form opener where a quiet tease explodes into the main promise"+ - "punctuation before the demo with camera shake and a tagline"---<ComponentPreview name="crash-zoom" />diff --git a/content/docs/social/duet-split.mdx b/content/docs/social/duet-split.mdxindex 7c824de5..afbb538d 100644--- a/content/docs/social/duet-split.mdx+++ b/content/docs/social/duet-split.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You are comparing two images or screenshots with a sweeping divider — use `before-after`."- "The contrast is a head-to-head with a clash effect rather than paired rows — use `versus-split`."- "A single old value should be crossed out and replaced inline — use `strikethrough-replace`."+askedAs:+ - "before after rows"+ - "3 weeks vs 1 day"+ - "split screen with a dull old side and a crisp new side row by row"+ - "I want to compare old way and our product on a few metrics"+ - "pricing or time saving claim ending on a brand sign-off"+ - "paired rows contrasting $12K vs $0"---<ComponentPreview name="duet-split" />diff --git a/content/docs/social/github-sponsors.mdx b/content/docs/social/github-sponsors.mdxindex e7c062d3..bb54b101 100644--- a/content/docs/social/github-sponsors.mdx+++ b/content/docs/social/github-sponsors.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The milestone is a star count rather than funding — use `github-stars`, whose odometer counts up to a total."- "The subject is one person's profile instead of a group of supporters — use `x-follow-card`."- "You need a neutral partner or integration lineup without the Sponsors heart and pink CTA — use `logo-enter`."+askedAs:+ - "sponsors thank you wall"+ - "open source funding supporters"+ - "a heart draws itself then sponsor avatars fade in as a grid with a become a sponsor button"+ - "I want to thank the people funding my OSS project"+ - "end card asking for support with a github.com/sponsors line"+ - "grid of backer faces that resizes to the supporter list"---<ComponentPreview name="github-sponsors" />diff --git a/content/docs/social/github-stars.mdx b/content/docs/social/github-stars.mdxindex cb4eeb31..2118ef90 100644--- a/content/docs/social/github-stars.mdx+++ b/content/docs/social/github-stars.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You only need the number to roll up without the stargazer fly-through — use `number-wheel` or `rolling-number`."- "The metric isn't GitHub stars — use a generic counter (`rolling-number`) or `animated-bar-chart` for compared values."- "You're depicting follower growth on X — use `x-followers-overview`."+askedAs:+ - "github star counter"+ - "stargazer avatars flying by"+ - "count up odometer landing on total stars while faces fly past"+ - "I want to celebrate hitting an open source star milestone"+ - "repo showcase social proof with real stargazer profiles"+ - "star count payoff beat for a developer launch"---<ComponentPreview name="github-stars" />diff --git a/content/docs/social/hook-punch.mdx b/content/docs/social/hook-punch.mdxindex 5e73b950..5acbc731 100644--- a/content/docs/social/hook-punch.mdx+++ b/content/docs/social/hook-punch.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The tease should build quietly before one slam, with speed lines — use `crash-zoom`."- "You want a conversational setup and a soft punchline, no shake — use `pov-setup`."- "A single headline should drift in without any impact effects — use `staggered-fade-up`."+askedAs:+ - "scroll stopping hook"+ - "two word slam opener"+ - "I want a punchy first second with huge gradient words"+ - "start my vertical clip with a hook that ends on took 1 day"+ - "grab attention in the first second of a tiktok launch video"+ - "setup then big colourful payoff line telling how fast it was built"---<ComponentPreview name="hook-punch" />diff --git a/content/docs/social/logo-enter.mdx b/content/docs/social/logo-enter.mdxindex 9786912b..0ffac204 100644--- a/content/docs/social/logo-enter.mdx+++ b/content/docs/social/logo-enter.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You need a single product logo or wordmark lockup — this is a multi-chip cluster, not one mark; use a logo sting (`orbit-lock`, `spotlight`, `anamorphic-flare`) or resolve kinetic text (`kinetic-center-build`, `per-character-rise`) into the name."- "You're depicting one specific brand's product UI — use the matching card (`chat-gpt`, `claude-code`, `v0`, `opencode`)."- "The logos must orbit or scatter in 3D rather than stack — compose your own layout; this one stacks on a single axis."+askedAs:+ - "integration logos pop in"+ - "round brand icons cluster"+ - "I want partner logos to bounce in together as a group"+ - "show it works with all these tools using a stack of circular icons"+ - "works with section of the video listing the AI tools supported"+ - "viewer should see my app plugs into everything they already use"---<ComponentPreview name="logo-enter" />diff --git a/content/docs/social/milestone-roll.mdx b/content/docs/social/milestone-roll.mdxindex 96ad7db4..169aa5a8 100644--- a/content/docs/social/milestone-roll.mdx+++ b/content/docs/social/milestone-roll.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You need several unrelated stats shown at once — use `stat-sequence`."- "One number should roll like an odometer instead of racing — use `number-wheel`."- "The metric is repository stars or sponsors — use `github-stars`."+askedAs:+ - "growth counter 1K to 1M"+ - "downloads milestone flash"+ - "I want a number that climbs through 10K 100K and lands on 1M"+ - "celebrate user count hitting big thresholds one after another"+ - "brag about traction near the end of the launch video"+ - "viewer should feel momentum as the count blasts past each round number"---<ComponentPreview name="milestone-roll" />diff --git a/content/docs/social/pov-setup.mdx b/content/docs/social/pov-setup.mdxindex aa51efce..9009e1ad 100644--- a/content/docs/social/pov-setup.mdx+++ b/content/docs/social/pov-setup.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The setup should be typed character by character with a caret — use `typewriter`."- "You want a loud shaky hook with a huge number payoff — use `hook-punch`."- "The line should sit on highlighted bubbles like a story caption — use `story-text`."+askedAs:+ - "POV text joke"+ - "relatable meme caption punchline"+ - "I want a pov line then a one word italic punchline"+ - "tiktok style setup and payoff caption for my product"+ - "open with a relatable situation so the viewer nods before the reveal"+ - "comedic beat where the joke lands on a single serif word"---<ComponentPreview name="pov-setup" />diff --git a/content/docs/social/rating-laurel.mdx b/content/docs/social/rating-laurel.mdxindex 997af285..875bb722 100644--- a/content/docs/social/rating-laurel.mdx+++ b/content/docs/social/rating-laurel.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want pile-up social post cards rather than a rating — use `testimonial-stack`."- "The proof is several stats counting up, not reviews — use `stat-sequence`."- "The proof is a repository star count — use `github-stars`."+askedAs:+ - "app store rating badge"+ - "laurel wreath 4.96 stars"+ - "I want a big star rating with a wreath and review snippets"+ - "show that users love the app with score and gliding review cards"+ - "social proof moment with category scores like design and ease of use"+ - "viewer should trust us after seeing an award style rating"---<ComponentPreview name="rating-laurel" />diff --git a/content/docs/social/reels-feed.mdx b/content/docs/social/reels-feed.mdxindex 847e80da..c3ee92bf 100644--- a/content/docs/social/reels-feed.mdx+++ b/content/docs/social/reels-feed.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want several phone screens side by side — use `phone-trio`."- "The video is a single scrolling app screen — use `phone-scroll`."- "You want a swipeable card deck instead of a feed — use `swipe-deck`."+askedAs:+ - "instagram stories phone mockup"+ - "reels swipe and double tap heart"+ - "I want a phone feed with a poll sticker and a liking burst"+ - "show content going viral in a stories and reels style app"+ - "demonstrate audience engagement like votes and hearts on a phone"+ - "viewer should see my content living inside an instagram like feed"---<ComponentPreview name="reels-feed" />diff --git a/content/docs/social/speedrun-timer.mdx b/content/docs/social/speedrun-timer.mdxindex ae39e736..00e534b7 100644--- a/content/docs/social/speedrun-timer.mdx+++ b/content/docs/social/speedrun-timer.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You only need one counting number, not a split table — use `rolling-number`."- "You want two timers racing side by side instead of splits — use `timer-duel`."- "The data is a ranking that climbs a list, not elapsed time — use `leaderboard-climb`."+askedAs:+ - "speedrun split table"+ - "world record gold banner"+ - "I want a livesplit style timer showing each step against personal best"+ - "show that shipping is fast by racing through script edit render"+ - "frame my workflow as a gaming speedrun that ends in a record"+ - "viewer should feel how few minutes the whole process takes"---<ComponentPreview name="speedrun-timer" />diff --git a/content/docs/social/story-text.mdx b/content/docs/social/story-text.mdxindex db93eabe..5a5c20d5 100644--- a/content/docs/social/story-text.mdx+++ b/content/docs/social/story-text.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The words should follow a voiceover with a karaoke highlight — use `caption-karaoke`."- "You want plain character-by-character typing with no bubbles — use `typewriter`."- "A short phrase should build in the center, pushing earlier words aside — use `kinetic-center-build`."+askedAs:+ - "story text sticker bubbles"+ - "okay it's live caption"+ - "I want words typed onto rounded highlighted bubbles like a story"+ - "casual announcement text styled like a social story"+ - "vertical clip needs a chatty overlay caption that changes style per word"+ - "make launch news feel like a friend posting on their story"---<ComponentPreview name="story-text" />diff --git a/content/docs/social/testimonial-stack.mdx b/content/docs/social/testimonial-stack.mdxindex c36e24f6..5b9e8748 100644--- a/content/docs/social/testimonial-stack.mdx+++ b/content/docs/social/testimonial-stack.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want one big quote as the hero line — use `quote-hero`."- "The proof is a single rating number with reviews scrolling by — use `rating-laurel`."- "The testimonial is one social account card with follower counts — use `x-follow-card`."+askedAs:+ - "customer quotes pile up"+ - "social post reviews stacking"+ - "I want three or four customer tweets flying in one on top of another"+ - "show real user praise with name role and handle on cards"+ - "proof section where reviews arrive and pile into a stack"+ - "viewer should see a wall of happy customers building up"---<ComponentPreview name="testimonial-stack" />diff --git a/content/docs/social/upvote-burst.mdx b/content/docs/social/upvote-burst.mdxindex 884f383b..9ebdca0f 100644--- a/content/docs/social/upvote-burst.mdx+++ b/content/docs/social/upvote-burst.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The list is a generic ranked table with no vote button or badge — use `leaderboard-climb`."- "You only want the rank to move up a chart — use `rank-climb`."- "The win is a repository star count — use `github-stars`."+askedAs:+ - "product hunt ranking climb"+ - "leaderboard number one badge"+ - "I want my product to overtake rivals as votes tick up"+ - "show launch day vote count rising to first place"+ - "celebrate topping the daily chart with a stamped badge"+ - "viewer should feel the thrill of winning the launch day race"---<ComponentPreview name="upvote-burst" />diff --git a/content/docs/social/waitlist-swarm.mdx b/content/docs/social/waitlist-swarm.mdxindex 293b25b6..aa69ea94 100644--- a/content/docs/social/waitlist-swarm.mdx+++ b/content/docs/social/waitlist-swarm.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The shape should morph through several icons before the logo — use `dot-field-morph`."- "You only need the number rolling up, with no swarm — use `rolling-number`."- "The focus is live collaboration cursors moving around a screen — use `multiplayer-cursors`."+askedAs:+ - "waitlist counter people join"+ - "avatars assemble into logo"+ - "I want cursors flying in from edges to form my logo"+ - "show a crowd of people arriving while the signup count rolls up"+ - "community milestone moment with many users converging on the brand"+ - "viewer should sense a crowd gathering around the product before launch"---<ComponentPreview name="waitlist-swarm" />diff --git a/content/docs/social/x-follow-card.mdx b/content/docs/social/x-follow-card.mdxindex e44a78c0..4a2f6304 100644--- a/content/docs/social/x-follow-card.mdx+++ b/content/docs/social/x-follow-card.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You're aggregating follower growth or notifications rather than one profile — use `x-followers-overview`."- "The brand is GitHub, not X — use `github-stars`."- "You need a generic testimonial/quote card, not an X profile — compose a plain card."+askedAs:+ - "twitter profile follow button click"+ - "X profile card with cursor"+ - "I want a profile card that bounces in and a cursor clicking follow"+ - "ask viewers to follow me on X with the real button click"+ - "creator outro where the cursor presses follow on my account"+ - "end of video call to action to follow the founder on twitter"---<ComponentPreview name="x-follow-card" />diff --git a/content/docs/social/x-followers-overview.mdx b/content/docs/social/x-followers-overview.mdxindex 18312841..dc1b69a6 100644--- a/content/docs/social/x-followers-overview.mdx+++ b/content/docs/social/x-followers-overview.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You're highlighting one profile and a Follow click — use `x-follow-card`."- "The metric is GitHub stars — use `github-stars`."- "You only need a bare count-up with no notification feed or confetti — use `rolling-number` or `number-wheel`."+askedAs:+ - "new follower notifications flip"+ - "twitter follower total reveal"+ - "I want follow alerts flipping in 3D then the big total number"+ - "show audience growth as a stream of new followers adding up"+ - "social proof beat building to the total follower count with confetti"+ - "viewer should feel my audience growing notification by notification"---<ComponentPreview name="x-followers-overview" />diff --git a/content/docs/social/year-in-review.mdx b/content/docs/social/year-in-review.mdxindex 510198c1..09477169 100644--- a/content/docs/social/year-in-review.mdx+++ b/content/docs/social/year-in-review.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a short stats beat with large counting numbers — use `stat-sequence`."- "The recap is a streak or daily-habit reward — use `streak-reward`."- "You want progress rings for goals instead of a slide story — use `activity-rings`."+askedAs:+ - "wrapped style recap"+ - "yearly stats story cards"+ - "I want a spotify wrapped style summary of the year for my product"+ - "recap videos shipped top feature and builder rank in chapters"+ - "end of year personalised stats video ending on a share tap"+ - "viewer should feel proud looking back at what they made this year"---<ComponentPreview name="year-in-review" />diff --git a/content/docs/templates/brand-guidelines.mdx b/content/docs/templates/brand-guidelines.mdxindex e14460d1..d05f62a6 100644--- a/content/docs/templates/brand-guidelines.mdx+++ b/content/docs/templates/brand-guidelines.mdx@@ -10,6 +10,13 @@ useWhen:avoidWhen:- "You need a multi-feature software demo rather than an identity film; use `launch-anything`."- "You only need a short typed title with an exit; use `typed-split-wipe`."+askedAs:+ - "brand identity film"+ - "color palette typography showcase"+ - "I want a full video introducing our brand system and mark"+ - "present logo colours fonts and photography in one editorial piece"+ - "complete brand book style video to share with the team"+ - "viewer should understand the whole visual identity in under twenty seconds"---<ComponentPreview name="brand-guidelines" />diff --git a/content/docs/templates/fomo-limit-orders.mdx b/content/docs/templates/fomo-limit-orders.mdxindex 1ca9414b..f980fb1d 100644--- a/content/docs/templates/fomo-limit-orders.mdx+++ b/content/docs/templates/fomo-limit-orders.mdx@@ -10,6 +10,13 @@ useWhen:avoidWhen:- "You need a general product launch story; use `launch-anything`."- "You only need a text transition; use `word-push`."+askedAs:+ - "trading app demo video"+ - "crypto exchange interface walkthrough"+ - "I want a finance order screen demo with close camera moves"+ - "show a trading dashboard with amber buttons and fake data"+ - "fintech launch video focusing on placing a limit order"+ - "viewer should feel the speed and precision of trading in the app"---<ComponentPreview name="fomo-limit-orders" />diff --git a/content/docs/templates/launch-anything.mdx b/content/docs/templates/launch-anything.mdxindex 49bf9a51..93f5547f 100644--- a/content/docs/templates/launch-anything.mdx+++ b/content/docs/templates/launch-anything.mdx@@ -10,6 +10,13 @@ useWhen:avoidWhen:- "You want to introduce a complete visual identity; use `brand-guidelines`."- "You only need a chrome headline; use `shader-text-reveal`."+askedAs:+ - "full product launch film"+ - "editorial product showcase template"+ - "I want a ready made product video with photography and several demos"+ - "complete forest green launch video I can edit text in"+ - "portfolio piece showing a product across many features in one flow"+ - "viewer should watch one continuous polished tour of the whole product"---<ComponentPreview name="launch-anything" />diff --git a/content/docs/templates/release-teaser.mdx b/content/docs/templates/release-teaser.mdxindex 658cbfe6..59607dd5 100644--- a/content/docs/templates/release-teaser.mdx+++ b/content/docs/templates/release-teaser.mdx@@ -10,6 +10,13 @@ useWhen:avoidWhen:- "You need to show actual product interactions and workflows; use `launch-anything`."- "You want to introduce a complete palette, typography, and photography system; use `brand-guidelines`."+askedAs:+ - "cinematic release announcement"+ - "coming soon teaser template"+ - "I want a moody teaser that builds anticipation for a release"+ - "quiet type then a glowing ring logo reveal at the end"+ - "sixteen second pre launch teaser before the big drop"+ - "viewer should feel curiosity and hype before the product appears"---<ComponentPreview name="release-teaser" />diff --git a/content/docs/templates/workflow-console.mdx b/content/docs/templates/workflow-console.mdxindex 27e7b501..79dcee50 100644--- a/content/docs/templates/workflow-console.mdx+++ b/content/docs/templates/workflow-console.mdx@@ -10,6 +10,13 @@ useWhen:avoidWhen:- "You only need one scrolling command; use `terminal-cursor-zoom`."- "You want a photographic product montage; use `launch-anything`."+askedAs:+ - "CLI automation demo video"+ - "terminal commands pipeline film"+ - "I want a developer tool video with typed commands and results"+ - "show deployment pipeline stages and metrics in a console style"+ - "release automation story from manual pain to one command"+ - "viewer should see a messy process turned into a single automated run"---<ComponentPreview name="workflow-console" />diff --git a/content/docs/transitions/ascii-dissolve.mdx b/content/docs/transitions/ascii-dissolve.mdxindex 2dbf34fb..ea3b09e0 100644--- a/content/docs/transitions/ascii-dissolve.mdx+++ b/content/docs/transitions/ascii-dissolve.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The tone is soft or organic — use `grain-dissolve` or `perlin-dissolve` for a gentler texture instead."- "You need a camera move rather than a dissolve — use `whip-pan` or `push-through`."- "The brand is clean and minimal — the character grid reads as deliberately rough, not polished."+askedAs:+ - "ascii character scene change"+ - "text glyph fade between scenes"+ - "I want one scene to melt into the next through drifting letters and symbols"+ - "retro terminal look for a cut using a field of characters"+ - "CRT or risograph texture when switching between two screens"+ - "cut that feels like the picture turns into a text grid"---<ComponentPreview name="ascii-dissolve" />diff --git a/content/docs/transitions/band-open.mdx b/content/docs/transitions/band-open.mdxindex 7dbc9dc9..ff41e79a 100644--- a/content/docs/transitions/band-open.mdx+++ b/content/docs/transitions/band-open.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You need a vertical reveal rather than a horizontal one — use `column-slide`."- "The reveal should be a thin line of light, not a thick band — use `hairline-open`."- "The reveal should come from a point rather than a band — use `ring-cut`."+askedAs:+ - "headline splits open to photo"+ - "center slit reveals image"+ - "I want a stacked title that opens in the middle onto a full photo"+ - "bold typographic start to a chapter with a picture behind it"+ - "title card where the words part to show the photo underneath"+ - "viewer sees big text then it unzips into a full frame image"---<ComponentPreview name="band-open" />diff --git a/content/docs/transitions/band-shift.mdx b/content/docs/transitions/band-shift.mdxindex 99571622..0176cd33 100644--- a/content/docs/transitions/band-shift.mdx+++ b/content/docs/transitions/band-shift.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The reveal should split vertically into columns — use `column-slide`."- "You want the reveal to expand from a single point — use `ring-burst`."- "A soft, slow swap is needed, not a rhythmic one — use `grain-dissolve`."+askedAs:+ - "striped bars swap scenes"+ - "horizontal bars slide in staggered"+ - "I want colored bars sweeping across to swap a headline for a logo"+ - "fast rhythmic cut using sliding stripes carrying color blocks"+ - "closing line change where bars push the old text away"+ - "scene changes as bars slide across one after another"---<ComponentPreview name="band-shift" />diff --git a/content/docs/transitions/baton-word.mdx b/content/docs/transitions/baton-word.mdxindex 93e57aed..d6a9d223 100644--- a/content/docs/transitions/baton-word.mdx+++ b/content/docs/transitions/baton-word.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You need a single headline that appears once — use `staggered-fade-up`."- "The lines are unrelated and share no linking word — use `per-word-crossfade` for independent lines."- "You want each line to swap with a hard directional move rather than a word hand-off — use `cue-word`."+askedAs:+ - "last word passes to next line"+ - "kinetic sentences flowing together"+ - "I want each line to hand its final word onto the next line in color"+ - "manifesto text where short sentences chain word by word"+ - "script driven video where phrases hook into each other"+ - "words relay from one sentence to the next with an accent colour"---<ComponentPreview name="baton-word" />diff --git a/content/docs/transitions/beam-sweep.mdx b/content/docs/transitions/beam-sweep.mdxindex fcb761e8..740ab938 100644--- a/content/docs/transitions/beam-sweep.mdx+++ b/content/docs/transitions/beam-sweep.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You need a hard, flat edge between scenes with no glow — use `diagonal-split`."- "You want a quick tilted band of light, not a long glowing sweep — use `flash-sweep`."- "You want a plain lateral swap with no light effect — use `slide-swap`."+askedAs:+ - "light beam reveals tagline"+ - "glowing horizon closing headline"+ - "I want a beam of light to wipe from a product screen to a statement"+ - "move from feature demo to a single confident line over a glow"+ - "end of demo where a sweep of light brings in the tagline"+ - "a light bar wipes across and the final message appears on a horizon"---<ComponentPreview name="beam-sweep" />diff --git a/content/docs/transitions/bloom-ring.mdx b/content/docs/transitions/bloom-ring.mdxindex 2c34a350..a0c61c27 100644--- a/content/docs/transitions/bloom-ring.mdx+++ b/content/docs/transitions/bloom-ring.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a crisp geometric reveal with no glow — use `ring-cut`."- "The reveal should expand from an impact point with a sharper shockwave — use `ring-burst`."- "The outgoing scene is bright and busy and the warm bloom will clash with it — use `light-leak`."+askedAs:+ - "warm striped ring expands"+ - "light burst headline to logo"+ - "I want a glowing orange ring blooming from the middle into my logo"+ - "closing reveal where a warm radial burst swaps text for the brand mark"+ - "hero ending with an expanding halo of light"+ - "scene change where striped warm rings grow out and logo appears"---<ComponentPreview name="bloom-ring" />diff --git a/content/docs/transitions/card-swipe-cover.mdx b/content/docs/transitions/card-swipe-cover.mdxindex 1cab9fa5..21836498 100644--- a/content/docs/transitions/card-swipe-cover.mdx+++ b/content/docs/transitions/card-swipe-cover.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The next scene is a single hero shot, not a card or gallery — use `diagonal-split`."- "You need a flat, graphic wipe with no depth or tilt — use `column-slide`."- "The two scenes should crossfade softly — use `zoom-blur`."+askedAs:+ - "tilted card wipes the screen"+ - "card slides across to grid of cards"+ - "I want a card to swipe over the headline and show a set of templates"+ - "move from a statement to a catalogue of kit items"+ - "introduce deliverables or case studies after a big claim"+ - "an angled card sweeps across the frame and a grid of cards is revealed"---<ComponentPreview name="card-swipe-cover" />diff --git a/content/docs/transitions/caret-collapse.mdx b/content/docs/transitions/caret-collapse.mdxindex 6f2f6753..c3eaa5fa 100644--- a/content/docs/transitions/caret-collapse.mdx+++ b/content/docs/transitions/caret-collapse.mdx@@ -12,6 +12,13 @@ avoidWhen:- "There is no typed text in the outgoing scene to anchor the caret — use `ring-cut` for a generic reveal."- "You want the caret to sweep across the frame and wipe the scene — use `caret-wipe`."- "The cut should be a fast dramatic dive, not a quiet collapse — use `press-warp-dive`."+askedAs:+ - "typed text shrinks to cursor"+ - "blinking cursor becomes input box"+ - "I want a typed line to crop down to the cursor which turns into a prompt"+ - "move from a typed URL to a field where the viewer takes action"+ - "beat where typing ends and the next step input screen opens"+ - "line of text collapses to a blinking caret that slides and expands into a screen"---<ComponentPreview name="caret-collapse" />diff --git a/content/docs/transitions/caret-wipe.mdx b/content/docs/transitions/caret-wipe.mdxindex bdc3c9c9..8f4b3eeb 100644--- a/content/docs/transitions/caret-wipe.mdx+++ b/content/docs/transitions/caret-wipe.mdx@@ -11,6 +11,13 @@ useWhen:avoidWhen:- "The scenes aren't text or UI surfaces — the caret metaphor has nothing to type over."- "You want a textured dissolve instead of a directional wipe — use `ascii-dissolve` or `dither-dissolve`."+askedAs:+ - "typing cursor wipes scene"+ - "text cursor sweeps across frame"+ - "I want a blinking cursor to drag across and replace one screen with the next"+ - "code editor or terminal scenes joined by a typing cursor"+ - "dev tool demo where the cursor itself is the scene change"+ - "a cursor line sweeps over the old screen and the next one types in"---<ComponentPreview name="caret-wipe" />diff --git a/content/docs/transitions/color-bars.mdx b/content/docs/transitions/color-bars.mdxindex f7b72777..fc86fa20 100644--- a/content/docs/transitions/color-bars.mdx+++ b/content/docs/transitions/color-bars.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a single band of light rather than several colored bars — use `flash-sweep`."- "You need a clean seam with no color — use `diagonal-split`."- "A soft, slow swap is better than a whip — use `grain-dissolve`."+askedAs:+ - "slanted colorful stripes whip"+ - "fluted rainbow bars cut"+ - "I want bold angled color bars to whip across between two screenshots"+ - "high energy swap with striped colours flashing over the frame"+ - "quick montage cut with bright slanted glass like bars"+ - "bars of colour sweep fast across the frame and the new shot is underneath"---<ComponentPreview name="color-bars" />diff --git a/content/docs/transitions/column-slide.mdx b/content/docs/transitions/column-slide.mdxindex 1bb96278..e2615ba0 100644--- a/content/docs/transitions/column-slide.mdx+++ b/content/docs/transitions/column-slide.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want horizontal bands instead of vertical columns — use `band-shift`."- "The scenes are full UI shots rather than headlines — use `color-bars`."- "A single smooth push is enough — use `slide-swap`."+askedAs:+ - "vertical strips swap headline"+ - "columns slide to change text"+ - "I want tall vertical bars to slide in and replace one headline with another"+ - "clean rhythmic swap between plan and launch headlines"+ - "architectural look where the frame is cut into vertical slats that slide"+ - "scene is replaced by columns moving across in a staggered order"---<ComponentPreview name="column-slide" />diff --git a/content/docs/transitions/cue-word.mdx b/content/docs/transitions/cue-word.mdxindex e9f96fda..0baeb6e2 100644--- a/content/docs/transitions/cue-word.mdx+++ b/content/docs/transitions/cue-word.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The lines should hand a word from one to the next — use `baton-word`."- "You only need a single sentence with a highlighted word — use `inline-highlight`."- "You want a softer, non-directional change between lines — use `per-word-crossfade`."+askedAs:+ - "kinetic text one coloured word"+ - "short claims each exits differently"+ - "I want quick lines where one word pops in color then the line slides away"+ - "feature list told in sentences with varied moves for each line"+ - "fast run of punchy claims with a different exit each time"+ - "each statement highlights a key word then drops lifts or cuts away"---<ComponentPreview name="cue-word" />diff --git a/content/docs/transitions/diagonal-split.mdx b/content/docs/transitions/diagonal-split.mdxindex fda213e4..14112489 100644--- a/content/docs/transitions/diagonal-split.mdx+++ b/content/docs/transitions/diagonal-split.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want an opening that is straight and symmetrical rather than angled — use `hairline-open`."- "You need several slanted bars instead of one seam — use `color-bars`."- "A plain lateral shove between full scenes is enough — use `slide-swap`."+askedAs:+ - "angled seam slides scene away"+ - "before and after diagonal reveal"+ - "I want a diagonal edge to slide the old screen off and show the next"+ - "built in a weekend then launched on Monday swap of two statements"+ - "confident change between two sentences with a glowing edge"+ - "a slanted line with light along it pushes one scene out"---<ComponentPreview name="diagonal-split" />diff --git a/content/docs/transitions/disc-pop.mdx b/content/docs/transitions/disc-pop.mdxindex 7b463917..f3c93dcb 100644--- a/content/docs/transitions/disc-pop.mdx+++ b/content/docs/transitions/disc-pop.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The tone is restrained and editorial — use `hairline-open`."- "You want a single expanding shape instead of a field of discs — use `ring-cut`."- "The scenes should be joined by a light effect, not colored shapes — use `bloom-ring`."+askedAs:+ - "colored circles pop across screen"+ - "dots swap prompt for video"+ - "I want a grid of round discs popping to go from typing to the finished video"+ - "AI tool request turning into the generated result with playful circles"+ - "playful graphic cut using bubble like glyph discs"+ - "viewer types a prompt and a burst of discs reveals the video player"---<ComponentPreview name="disc-pop" />diff --git a/content/docs/transitions/displacement.mdx b/content/docs/transitions/displacement.mdxindex e0141c6a..03850bd8 100644--- a/content/docs/transitions/displacement.mdx+++ b/content/docs/transitions/displacement.mdx@@ -11,6 +11,13 @@ useWhen:avoidWhen:- "You want the tearing concentrated in horizontal bands with a hard cut — use `glitch-cut`."- "The moment should feel calm or premium — this is a deliberate malfunction; use `zoom-blur`."+askedAs:+ - "glitchy tiles with color fringe"+ - "frame knocked out of register"+ - "I want the picture sheared into offset tiles with film grain then settling"+ - "tech demo cut that feels like the screen is misaligned not faded"+ - "rgb split tiles snapping into the next scene"+ - "image breaks into shifted blocks with chromatic edges and lands on next view"---<ComponentPreview name="displacement" />diff --git a/content/docs/transitions/dither-dissolve.mdx b/content/docs/transitions/dither-dissolve.mdxindex 4d081179..afe0b0eb 100644--- a/content/docs/transitions/dither-dissolve.mdx+++ b/content/docs/transitions/dither-dissolve.mdx@@ -11,6 +11,13 @@ useWhen:avoidWhen:- "The tone is soft and organic — the pixel grid reads technical; use `grain-dissolve` or `perlin-dissolve`."- "Brand colors clash with a two-color reduction — the field is strictly `colorBack`/`colorFront`."+askedAs:+ - "dither pixel scene fade"+ - "retro dotted dissolve"+ - "I want an old computer dither pattern to fade one scene into another"+ - "CLI or dev tool video with a pixelated stipple cut"+ - "print or CRT texture while changing between screens"+ - "scene melts away through a drifting field of dots"---<ComponentPreview name="dither-dissolve" />diff --git a/content/docs/transitions/ember-burn.mdx b/content/docs/transitions/ember-burn.mdxindex 6ffb4fb1..f573848e 100644--- a/content/docs/transitions/ember-burn.mdx+++ b/content/docs/transitions/ember-burn.mdx@@ -11,6 +11,13 @@ useWhen:avoidWhen:- "The cut has to be quick — a burn compressed under 24 frames reads as a smear; use `zoom-blur`."- "The scenes are cool-toned or clinical and a warm flare would fight the palette — use `grain-dissolve`."+askedAs:+ - "frame catches fire and burns away"+ - "burning paper sparks cut"+ - "I want the old scene to char and blow off as embers"+ - "cinematic physical scene change where the picture is destroyed"+ - "dramatic moment where fire consumes the shot before the next"+ - "flames boil the screen and sparks carry off its colours"---<ComponentPreview name="ember-burn" />diff --git a/content/docs/transitions/flash-sweep.mdx b/content/docs/transitions/flash-sweep.mdxindex 20c3be18..b53f0c67 100644--- a/content/docs/transitions/flash-sweep.mdx+++ b/content/docs/transitions/flash-sweep.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want colored bars instead of a single light band — use `color-bars`."- "The light should linger as a warm, analog glow — use `light-leak`."- "You want the cut to be a hard sideways camera move — use `whip-pan`."+askedAs:+ - "tilted light streak between shots"+ - "quick light pass cut"+ - "I want a slanted band of light to flash across and swap shots"+ - "cutting through several product screens with a repeated light sweep"+ - "feature tour where every screen change gets a flash of light"+ - "a bright bar zips diagonally and the next shot appears"---<ComponentPreview name="flash-sweep" />diff --git a/content/docs/transitions/focus-pull.mdx b/content/docs/transitions/focus-pull.mdxindex bb722773..1fd11b7d 100644--- a/content/docs/transitions/focus-pull.mdx+++ b/content/docs/transitions/focus-pull.mdx@@ -11,6 +11,13 @@ useWhen:avoidWhen:- "The cut needs energy or direction — use `whip-pan` or `push-through`."- "Fine text must stay legible up to the cut — the defocus starts eating detail early."+askedAs:+ - "rack focus blur between scenes"+ - "soft defocus scene change"+ - "I want the camera to go out of focus then sharpen on the next scene"+ - "calm premium cut for brand film or testimonial"+ - "shift attention gently like a lens refocusing"+ - "scene blurs softly and the next one comes into sharp focus"---<ComponentPreview name="focus-pull" />diff --git a/content/docs/transitions/glitch-cut.mdx b/content/docs/transitions/glitch-cut.mdxindex 6e8d9cf5..2021b1ca 100644--- a/content/docs/transitions/glitch-cut.mdx+++ b/content/docs/transitions/glitch-cut.mdx@@ -11,6 +11,13 @@ useWhen:avoidWhen:- "Only a headline should glitch while the scene around it stays intact — use `rgb-glitch-text`."- "The demo needs a calm, general-purpose cut — use `zoom-blur`."+askedAs:+ - "digital glitch scene cut"+ - "rgb split corrupted blocks"+ - "I want a hard cut torn into displaced slices with colour split"+ - "dev demo cut that looks like a broadcast error"+ - "intentional signal corruption between two screens"+ - "frame tears into shifted strips and broken blocks then the next scene"---<ComponentPreview name="glitch-cut" />diff --git a/content/docs/transitions/grain-dissolve.mdx b/content/docs/transitions/grain-dissolve.mdxindex df9b1a17..c731923a 100644--- a/content/docs/transitions/grain-dissolve.mdx+++ b/content/docs/transitions/grain-dissolve.mdx@@ -11,6 +11,13 @@ useWhen:avoidWhen:- "The transition must be fast — under ~50 frames the intensity/softness sweep has no room to read."- "The tone is crisp and minimal — the grain texture adds visual noise by design."+askedAs:+ - "grainy noise dissolve"+ - "film grain scene fade"+ - "I want the old scene to crumble into soft grain and the new one to form from noise"+ - "analog textured chapter change with print feel"+ - "mood shift where the picture breaks into speckled shapes"+ - "scene turns to grainy blobs then condenses into the next"---<ComponentPreview name="grain-dissolve" />diff --git a/content/docs/transitions/grid-wave.mdx b/content/docs/transitions/grid-wave.mdxindex 7e117f10..0c1b266d 100644--- a/content/docs/transitions/grid-wave.mdx+++ b/content/docs/transitions/grid-wave.mdx@@ -11,6 +11,13 @@ useWhen:avoidWhen:- "The cut needs to be quick or invisible — this one asks to be watched; use `zoom-blur`."- "You want the frame to come apart into matter rather than be handled as tiles — use `particle-dissolve`."+askedAs:+ - "wave raises blocks of picture"+ - "pixel blocks pop up and settle"+ - "I want a wave to turn the screen into solid tiles that set back down as the next scene"+ - "craftsmanlike interface demo cut handling the frame like a surface"+ - "blocky 3D tile ripple from one view to another"+ - "ripple travels across and lifts the image into squares showing a new scene"---<ComponentPreview name="grid-wave" />diff --git a/content/docs/transitions/hairline-open.mdx b/content/docs/transitions/hairline-open.mdxindex 89151593..987dcc16 100644--- a/content/docs/transitions/hairline-open.mdx+++ b/content/docs/transitions/hairline-open.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a screenshot or product scene revealed inside the slit — use `slit-reveal`."- "The opening should be a thick band across the middle — use `band-open`."- "The cut must be fast and energetic — use `flash-sweep`."+askedAs:+ - "thin line of light opens to reveal"+ - "slit opens onto serif statement"+ - "I want a thin glowing line that opens like a curtain onto the next text"+ - "calm editorial swap between a plan and its result"+ - "premium beat that feels like a theatre curtain parting"+ - "a hairline draws across and splits open to show the next statement"---<ComponentPreview name="hairline-open" />diff --git a/content/docs/transitions/halftone-cut.mdx b/content/docs/transitions/halftone-cut.mdxindex ea552339..c2da27d0 100644--- a/content/docs/transitions/halftone-cut.mdx+++ b/content/docs/transitions/halftone-cut.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want to turn a whole existing scene into halftone print — use `halftone-print`."- "The cut should be clean and vector-sharp, with no dot texture — use `ring-cut`."- "You need a soft photographic dissolve between full scenes — use `grain-dissolve`."+askedAs:+ - "halftone dots swap headline"+ - "comic print dot wave"+ - "I want dots that shrink the first serif headline and grow the next"+ - "print flavoured swap between draft and final version"+ - "editorial craft cut using a diagonal wave of dots"+ - "dot pattern sweeps diagonally and one title becomes another"---<ComponentPreview name="halftone-cut" />diff --git a/content/docs/transitions/hot-slab-morph.mdx b/content/docs/transitions/hot-slab-morph.mdxindex d3603182..5240864b 100644--- a/content/docs/transitions/hot-slab-morph.mdx+++ b/content/docs/transitions/hot-slab-morph.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The two scenes share no panel to morph between — use `zoom-blur` for a general-purpose cut."- "You want a clean geometric reveal with no glow — use `ring-cut`."- "The cut should read as light, not a solid slab — use `bloom-ring`."+askedAs:+ - "glowing blue panel morphs into prompt box"+ - "template card becomes input"+ - "I want a glowing blue shape morphing from a template picker into a text box"+ - "go from choosing a template to describing your own video"+ - "one UI panel transforming into another in a launch demo"+ - "a luminous slab reshapes and becomes the prompt input card"---<ComponentPreview name="hot-slab-morph" />diff --git a/content/docs/transitions/hyperspace.mdx b/content/docs/transitions/hyperspace.mdxindex 4814dab8..53dd72be 100644--- a/content/docs/transitions/hyperspace.mdx+++ b/content/docs/transitions/hyperspace.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The cut needs to be quick: the jump takes 56 frames to read; use `zoom-blur` or `whip-pan`."- "You want a spiral or shader tunnel instead of streaking stars; use `shader-spiral-pass`."- "The video is calm or editorial; use `fade-through` or `focus-pull`."+askedAs:+ - "star streaks warp jump"+ - "light speed tunnel cut"+ - "I want stars stretching into lines then a white flash into the next scene"+ - "release or what's next moment that feels like jumping to a new place"+ - "sci fi tech video travelling forward into the next section"+ - "tunnel through radial star trails ending in a bright flash"---<ComponentPreview name="hyperspace" />diff --git a/content/docs/transitions/icon-scatter.mdx b/content/docs/transitions/icon-scatter.mdxindex 59fcebd9..e5d19bcd 100644--- a/content/docs/transitions/icon-scatter.mdx+++ b/content/docs/transitions/icon-scatter.mdx@@ -11,6 +11,13 @@ useWhen:avoidWhen:- "The piece is minimal or serious — use `fade-through` for a quieter cut instead."- "The brand has no icon system to draw from — a generic icon field would look unrelated to the product."+askedAs:+ - "icons fly over the cut"+ - "emoji style icon burst scene change"+ - "I want a swarm of icons covering the screen while the scene swaps"+ - "playful app transition where icons are the visual language"+ - "feature to feature cut hidden by flying symbols"+ - "field of icons peaks and the next screen is underneath"---<ComponentPreview name="icon-scatter" />diff --git a/content/docs/transitions/iris-wipe.mdx b/content/docs/transitions/iris-wipe.mdxindex d0c02301..4d374c32 100644--- a/content/docs/transitions/iris-wipe.mdx+++ b/content/docs/transitions/iris-wipe.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The tone is serious or premium: the iris reads as a gag; use `fade-through` or `focus-pull`."- "The cut should feel fast and kinetic: the iris spends half its length closing; use `whip-pan`."- "You want the next scene to grow out of a shape with texture rather than a clean circle; use `smoke-dissolve`."+askedAs:+ - "old cartoon circle closing"+ - "that's all folks iris out"+ - "I want a circle to shrink on the subject, linger as a dot then reopen elsewhere"+ - "classic looney tunes style scene end"+ - "retro cartoon ending beat before moving to the next scene"+ - "black circle closes down to a dot and opens on the new scene"---<ComponentPreview name="iris-wipe" />diff --git a/content/docs/transitions/lens-zoom.mdx b/content/docs/transitions/lens-zoom.mdxindex 1ee92c48..bda8c1f5 100644--- a/content/docs/transitions/lens-zoom.mdx+++ b/content/docs/transitions/lens-zoom.mdx@@ -13,6 +13,13 @@ avoidWhen:- "You want static lens optics on a single scene rather than a transition — use `camera-lens`."- "The scenes are heavy React subtrees — every frame paints `blurSamples × (lensSteps + 1)` copies of the scene (×3 with the chromatic split); keep scenes light or turn the counts down."- "The pacing is calm or the brand is minimal — this is an aggressive, showy move."+askedAs:+ - "camera punch in with distortion"+ - "zoom blur shake cut"+ - "I want a fast lens push with warped edges and chromatic split"+ - "beat drop moment with a cinematic camera move hiding the cut"+ - "high energy reveal with camera shake and barrel distortion"+ - "screen bulges and zooms in violently then the next scene is shown"---<ComponentPreview name="lens-zoom" />diff --git a/content/docs/transitions/letter-gate.mdx b/content/docs/transitions/letter-gate.mdxindex a2241f96..e1ee525d 100644--- a/content/docs/transitions/letter-gate.mdx+++ b/content/docs/transitions/letter-gate.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The outgoing headline is short or has no two adjacent letters worth enlarging — use `ring-cut` for a generic circular cut."- "The cut should be fast and lateral — use `whip-pan`."- "You need a quiet reveal of a single line of text — use `hairline-open`."+askedAs:+ - "giant letters open like a gate"+ - "camera pushes into letter gap"+ - "I want to zoom into big letters and pass through the space between them"+ - "call to action headline handing off to an editor screen with a letter match cut"+ - "move from a headline into a prompt screen through its own letters"+ - "camera dives into huge type and the gap opens onto the next scene"---<ComponentPreview name="letter-gate" />diff --git a/content/docs/transitions/light-burn-to-line.mdx b/content/docs/transitions/light-burn-to-line.mdxindex ff2b90de..064ef288 100644--- a/content/docs/transitions/light-burn-to-line.mdx+++ b/content/docs/transitions/light-burn-to-line.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The cut must be quick and clean — a light burn needs about 36 frames; use `flash-sweep` for a faster light swap."- "The scenes are bright and low-contrast so the burn will wash out — use `light-leak`."- "You only need a gentle line reveal without the burn — use `hairline-open`."+askedAs:+ - "browser shrinks to a light line"+ - "screen collapses to glowing line"+ - "I want a busy product screen to burn down to one line that opens to a closing CTA"+ - "calm resolution from app UI to final headline and button"+ - "end of video where the interface compresses into a bright stripe"+ - "browser window burns down to a line of light and opens on the closing message"---<ComponentPreview name="light-burn-to-line" />diff --git a/content/docs/transitions/light-leak.mdx b/content/docs/transitions/light-leak.mdxindex f97f6c15..0abb0415 100644--- a/content/docs/transitions/light-leak.mdx+++ b/content/docs/transitions/light-leak.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The video is a crisp UI or data piece where a warm burn looks out of place; use `fade-through`."- "You want the cut to feel like a camera move rather than light; use `whip-pan`."- "The scenes are both very bright: the blow-out loses contrast; use `focus-pull`."+askedAs:+ - "warm film light leak transition"+ - "analog orange glow cut"+ - "I want a nostalgic light leak to wash over and blow out at the cut"+ - "lifestyle or film look scene change like light hitting negative"+ - "warm glow flares across then cools on the new shot"+ - "vintage camera light leak between two scenes"---<ComponentPreview name="light-leak" />diff --git a/content/docs/transitions/page-turn.mdx b/content/docs/transitions/page-turn.mdxindex 468482c4..ea510ad8 100644--- a/content/docs/transitions/page-turn.mdx+++ b/content/docs/transitions/page-turn.mdx@@ -11,6 +11,13 @@ avoidWhen:- "You need a smooth cinematic cut between UI scenes — use `whip-pan` or `push-through`."- "You want a dissolve — use the shader dissolve family."- "The entering scene needs its own entrance animation: here the reveal IS the entrance, and the entering scene is rendered untouched."+askedAs:+ - "notebook page flips away"+ - "stop motion paper page turn"+ - "I want the scene to swing up like a page of a notebook revealing the next"+ - "scrapbook style act break"+ - "paper craft video where current page leaves physically"+ - "page lifts in choppy stop motion poses showing next page below"---<ComponentPreview name="page-turn" />diff --git a/content/docs/transitions/paper-tear.mdx b/content/docs/transitions/paper-tear.mdxindex d2514233..70f9993e 100644--- a/content/docs/transitions/paper-tear.mdx+++ b/content/docs/transitions/paper-tear.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The cut is routine and repeats often: the impact gets old fast; use `fade-through` or `whip-pan`."- "You want the old scene to destroy itself more slowly and organically; use `ember-burn`."- "The page should turn over rather than tear; use `page-turn`."+askedAs:+ - "torn paper reveal"+ - "rip screen in half"+ - "I want the frame ripped down the middle with halves flung apart"+ - "reveal a price or product punching through the old scene"+ - "physical hit for a headline reveal with ragged paper edges"+ - "screen tears open with fibrous edges and the next scene is behind"---<ComponentPreview name="paper-tear" />diff --git a/content/docs/transitions/particle-dissolve.mdx b/content/docs/transitions/particle-dissolve.mdxindex 9a5c5bc7..05dc9b19 100644--- a/content/docs/transitions/particle-dissolve.mdx+++ b/content/docs/transitions/particle-dissolve.mdx@@ -11,6 +11,13 @@ useWhen:avoidWhen:- "You only need texture over a plain crossfade — use `grain-dissolve`."- "You want an organic flowing break-up rather than a granular one — use `perlin-dissolve`."+askedAs:+ - "dust particles scene change"+ - "image turns to grey powder"+ - "I want the picture to grind into drifting dust and reform as the next scene"+ - "scene breaks down into matter and reassembles"+ - "disintegration effect like thanos snap between shots"+ - "frame crumbles into floating specks that gather into new scene"---<ComponentPreview name="particle-dissolve" />diff --git a/content/docs/transitions/perlin-dissolve.mdx b/content/docs/transitions/perlin-dissolve.mdxindex 79e07243..f6b07d3c 100644--- a/content/docs/transitions/perlin-dissolve.mdx+++ b/content/docs/transitions/perlin-dissolve.mdx@@ -11,6 +11,13 @@ useWhen:avoidWhen:- "Fast cuts — the threshold sweep needs ~100 frames to read as a sweep, not a flicker."- "Sharp geometric brand language — the noise is deliberately unstructured; use `dither-dissolve`."+askedAs:+ - "organic noise fade between scenes"+ - "cloudy blob dissolve"+ - "I want an organic noise based wipe that dissolves into the next scene"+ - "calm atmospheric chapter change for nature or ambient product films"+ - "soft blotchy threshold reveal rather than a crossfade"+ - "scene eaten away by cloud like noise patterns showing new one"---<ComponentPreview name="perlin-dissolve" />diff --git a/content/docs/transitions/pixel-sort.mdx b/content/docs/transitions/pixel-sort.mdxindex 9fafb1e5..85d77daa 100644--- a/content/docs/transitions/pixel-sort.mdx+++ b/content/docs/transitions/pixel-sort.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The scenes are heavy React subtrees: each scene is painted once per column; lower columns or use `dither-dissolve`."- "You want a short, violent digital cut instead of a melt; use `glitch-cut`."- "The brand is calm or editorial; use `fade-through` or `venetian-blinds`."+askedAs:+ - "glitch art streaks cut"+ - "I want the image to melt into glowing vertical streaks, then the next scene drops in"+ - "bring in the new scene column by column after a glitch art pixel melt"+ - "generative or data art look for a scene change"+ - "tech video where the picture appears to be processed by an algorithm"+ - "scene smears into vertical colour stripes and next one falls in"---<ComponentPreview name="pixel-sort" />diff --git a/content/docs/transitions/press-warp-dive.mdx b/content/docs/transitions/press-warp-dive.mdxindex aee1cd83..3f7f81cf 100644--- a/content/docs/transitions/press-warp-dive.mdx+++ b/content/docs/transitions/press-warp-dive.mdx@@ -12,6 +12,13 @@ avoidWhen:- "There is no button or clickable control to anchor the cut — use `zoom-blur` for a general push into the next scene."- "The cut should feel calm and editorial rather than a dramatic dive — use `iris-wipe`."- "You need a lateral, directional move between two shots — use `whip-pan`."+askedAs:+ - "send button press launches result"+ - "dive through orb into generated screen"+ - "I want a send button to be clicked and the screen sucked into it to the result"+ - "AI prompt demo where hitting enter visibly creates the output"+ - "moment after submit where the viewer zooms into the finished result"+ - "frame pinches into the button and dives through a glowing orb"---<ComponentPreview name="press-warp-dive" />diff --git a/content/docs/transitions/push-through.mdx b/content/docs/transitions/push-through.mdxindex 297fc674..1dcf4c9f 100644--- a/content/docs/transitions/push-through.mdx+++ b/content/docs/transitions/push-through.mdx@@ -11,6 +11,13 @@ useWhen:avoidWhen:- "Scenes are peers moving sideways — use `whip-pan`; the push implies hierarchy (outer → inner)."- "Dense text fills the outgoing scene edge-to-edge — the scale-up crops it awkwardly mid-flight."+askedAs:+ - "dolly forward into next scene"+ - "fly through the scene depth"+ - "I want the camera to push through the old scene as the next approaches from far"+ - "zooming deeper into a feature or product chapter"+ - "climactic arrival into the main product screen"+ - "move forward through layers and arrive at the new scene"---<ComponentPreview name="push-through" />diff --git a/content/docs/transitions/replay-wipe.mdx b/content/docs/transitions/replay-wipe.mdxindex e69cb899..9f280bbc 100644--- a/content/docs/transitions/replay-wipe.mdx+++ b/content/docs/transitions/replay-wipe.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The scenes need a quiet or editorial change — use `hairline-open`."- "You want a lateral camera move between shots — use `whip-pan`."- "You need a single clean swap with no stinger graphic — use `slide-swap`."+askedAs:+ - "sports broadcast replay stinger"+ - "live to slow motion replay"+ - "I want a tv graphic wipe jumping from a live shot to its replay"+ - "event recap style cut in a launch video"+ - "high energy broadcast style transition between two moments"+ - "a stinger sweeps the frame like instant replay on a game show"---<ComponentPreview name="replay-wipe" />diff --git a/content/docs/transitions/ring-burst.mdx b/content/docs/transitions/ring-burst.mdxindex 33e903cb..44a5fdc6 100644--- a/content/docs/transitions/ring-burst.mdx+++ b/content/docs/transitions/ring-burst.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a soft glow rather than solid rings — use `bloom-ring`."- "You need a cut that expands cleanly with no color rings — use `ring-cut`."- "The reveal should come from horizontal bands rather than a point — use `band-shift`."+askedAs:+ - "concentric circles burst from center"+ - "colored rings explode outward"+ - "I want colourful rings expanding from the middle to bring in the closing logo"+ - "punchy centered swap of a short headline for the brand mark"+ - "ending of the launch video with a burst that lands the final statement"+ - "rings shoot out one inside another and the last one holds the new scene"---<ComponentPreview name="ring-burst" />diff --git a/content/docs/transitions/ring-cut.mdx b/content/docs/transitions/ring-cut.mdxindex cf04e74d..4fa7c9b4 100644--- a/content/docs/transitions/ring-cut.mdx+++ b/content/docs/transitions/ring-cut.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a soft glow of light rather than hard rings — use `bloom-ring`."- "You want a burst of filled color rings from the center — use `ring-burst`."- "A single shape growing out of the text is a better fit — use `shape-cut`."+askedAs:+ - "circular reveal from chosen point"+ - "expanding rings from click position"+ - "I want rings to expand from a spot I choose and carry in the next scene"+ - "swap a statement for a logo with a circular reveal origin where I point"+ - "cut that grows from a specific position like a button or cursor"+ - "concentric coloured circles grow from an off center point to the new view"---<ComponentPreview name="ring-cut" />diff --git a/content/docs/transitions/ripple-zoom.mdx b/content/docs/transitions/ripple-zoom.mdxindex d16fe4c5..459ca115 100644--- a/content/docs/transitions/ripple-zoom.mdx+++ b/content/docs/transitions/ripple-zoom.mdx@@ -11,6 +11,13 @@ useWhen:avoidWhen:- "The incoming scene has an opaque full-frame background — it hides the field and kills the depth illusion."- "Scenes chain rapidly — the fly-through needs ~88 frames; shorter reads as a scale pop."+askedAs:+ - "fly through grainy rings"+ - "camera goes through ripple circles"+ - "I want the camera to dolly into the center of grainy ripples to the next scene"+ - "hero statement or logo arrival with a tunnel of rings"+ - "arriving at the point of the story with a pulsing zoom"+ - "rings of grain ripple outward as we fly through the middle"---<ComponentPreview name="ripple-zoom" />diff --git a/content/docs/transitions/shader-seam.mdx b/content/docs/transitions/shader-seam.mdxindex f9a6bb6a..fbe2e125 100644--- a/content/docs/transitions/shader-seam.mdx+++ b/content/docs/transitions/shader-seam.mdx@@ -10,6 +10,13 @@ useWhen:avoidWhen:- "A minimal typographic cut is enough — use `caret-wipe`."- "The scenes themselves should be distorted at pixel level — use `displacement`."+askedAs:+ - "openshaders material dissolve"+ - "organic shader texture reveals next scene"+ - "I want a shader surface to appear then dissolve in place into the next scene"+ - "scene change where a material gradually disappears"+ - "natural fluid disappearance uncovering new content"+ - "colourful shader fills the frame and then erodes away"---<ComponentPreview name="shader-seam" />diff --git a/content/docs/transitions/shader-spiral-pass.mdx b/content/docs/transitions/shader-spiral-pass.mdxindex a1bf00bb..5041440a 100644--- a/content/docs/transitions/shader-spiral-pass.mdx+++ b/content/docs/transitions/shader-spiral-pass.mdx@@ -10,6 +10,13 @@ useWhen:avoidWhen:- "You need a continuous background without a scene change — use `shader-light-tunnel`."- "A subtle camera push is enough — use `push-through`."+askedAs:+ - "fly through luminous spiral"+ - "spiral tunnel into next scene"+ - "I want to dive into a glowing spiral and come out its soft middle"+ - "product reveal with a fast centered swirl travel"+ - "hypnotic move into the center of a spiral hero background"+ - "camera flies into the spiral and exits into the new scene"---<ComponentPreview name="shader-spiral-pass" />diff --git a/content/docs/transitions/shape-cut.mdx b/content/docs/transitions/shape-cut.mdxindex 67302acc..13fa0951 100644--- a/content/docs/transitions/shape-cut.mdx+++ b/content/docs/transitions/shape-cut.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want multiple rings expanding from a point — use `ring-cut`."- "The reveal should open from a band across the middle — use `band-open`."- "You need a soft change with no hard-edged shape — use `grain-dissolve`."+askedAs:+ - "circle swells then shrinks to dot"+ - "I want a big circle or pill to cover the headline then shrink to a small mark"+ - "one bold shape swallows the old line and ends as a small mark by the new one"+ - "swap a short statement for a logo with one geometric shape"+ - "closing line that appears after a shape wipes over the old text"+ - "shape grows over the screen then reduces to a punctuation like badge beside new text"---<ComponentPreview name="shape-cut" />diff --git a/content/docs/transitions/slide-swap.mdx b/content/docs/transitions/slide-swap.mdxindex a5663a88..2c717d3f 100644--- a/content/docs/transitions/slide-swap.mdx+++ b/content/docs/transitions/slide-swap.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The stage colour has to change between scenes — this sequencer paints one constant canvas, while `spring-settle` crossfades the background inside a dedicated gap."- "You need a presentation to drop into a `TransitionSeries` between two `<Sequence>`s; this owns its own scene list, so reach for `push-through` or `whip-pan` instead."- "What is swapping is a single phrase rather than a whole scene — `shared-axis-y` or `fade-through` replace text without moving the entire stage."+askedAs:+ - "push scene off canvas"+ - "next scene springs in from opposite side"+ - "I want the old scene to leave completely before the new one slides in"+ - "clean sequential change with no overlap"+ - "slide the whole screen away and bounce the next in"+ - "scene is shoved out one edge and the new scene arrives from the other"---<ComponentPreview name="slide-swap" />diff --git a/content/docs/transitions/slit-reveal.mdx b/content/docs/transitions/slit-reveal.mdxindex 84195ef3..9bf0dd76 100644--- a/content/docs/transitions/slit-reveal.mdx+++ b/content/docs/transitions/slit-reveal.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You only need to swap two text statements — use `hairline-open`."- "The reveal should be a thick title band rather than a thin slit — use `band-open`."- "You need a quick cut between two existing shots, not a reveal — use `flash-sweep`."+askedAs:+ - "point of light draws line then opens"+ - "product reveal through a glowing slit"+ - "I want a spark to draw a line that opens onto my product screen"+ - "cinematic opener with the title riding a line of light"+ - "launch intro where a glow ring sits under the opening"+ - "thin beam splits the dark and reveals the app"---<ComponentPreview name="slit-reveal" />diff --git a/content/docs/transitions/smoke-dissolve.mdx b/content/docs/transitions/smoke-dissolve.mdxindex 7e182348..7ad5fd4f 100644--- a/content/docs/transitions/smoke-dissolve.mdx+++ b/content/docs/transitions/smoke-dissolve.mdx@@ -11,6 +11,13 @@ useWhen:avoidWhen:- "Fast cuts — the ring expansion needs ~100 frames of runway."- "Bright, flat, poster-like scenes — the smoke loses definition on light backgrounds."+askedAs:+ - "smoke ring reveals scene"+ - "mist emerging cinematic reveal"+ - "I want a ring of smoke to expand and reveal the next scene"+ - "moody mysterious opening from fog"+ - "center out cloudy reveal for a dark cinematic video"+ - "smoke spreads outward and the new scene appears inside"---<ComponentPreview name="smoke-dissolve" />diff --git a/content/docs/transitions/spring-settle.mdx b/content/docs/transitions/spring-settle.mdxindex e6df107c..ec2746c2 100644--- a/content/docs/transitions/spring-settle.mdx+++ b/content/docs/transitions/spring-settle.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want directional momentum between scenes; `slide-swap` shoves the outgoing content off one edge and springs the next in from the opposite one."- "You need a presentation to drop into a `TransitionSeries` between two `<Sequence>`s; this owns its own scene list, so use `push-through` or `zoom-blur` instead."- "The scene should keep breathing while it holds — content is perfectly still between boundaries here, so wrap it in `drift` if you want a constant camera push."+askedAs:+ - "scene shrinks away then next drops in"+ - "empty stage between scenes"+ - "I want everything to shrink away, pause on empty, then the next drops from above"+ - "backgrounds change colour between scenes without muddy blending"+ - "bouncy handoff where the stage clears before the next scene lands"+ - "old group scales down, blank beat, new scene falls in with a settle"---<ComponentPreview name="spring-settle" />diff --git a/content/docs/transitions/strobe-montage.mdx b/content/docs/transitions/strobe-montage.mdxindex 7fd231ca..64e1fc19 100644--- a/content/docs/transitions/strobe-montage.mdx+++ b/content/docs/transitions/strobe-montage.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The cut should be quiet and slow — use `hairline-open`."- "You have no images to flash and want a plain light-based swap — use `flash-sweep`."- "You need accessibility-safe motion without flicker — use `zoom-blur`."+askedAs:+ - "rapid flicker of photos into prompt box"+ - "flashing images between claim and product"+ - "I want a fast strobe of pictures then landing on a prompt input"+ - "high energy cut from opening claim to the product box"+ - "burst of imagery before showing the AI prompt"+ - "photo frames flicker quickly and settle on the prompt screen"---<ComponentPreview name="strobe-montage" />diff --git a/content/docs/transitions/swirl-dissolve.mdx b/content/docs/transitions/swirl-dissolve.mdxindex 694f0a59..bbf34c29 100644--- a/content/docs/transitions/swirl-dissolve.mdx+++ b/content/docs/transitions/swirl-dissolve.mdx@@ -11,6 +11,13 @@ useWhen:avoidWhen:- "Fast cuts — under ~80 frames the twist arc collapses into noise."- "Repeated use within one video — the vortex is a statement move, one per video."+askedAs:+ - "twirl spiral dissolve"+ - "swirling vortex scene change"+ - "I want the frame to twist open in a swirl and wind shut on the next scene"+ - "dramatic act change where the picture visibly transforms"+ - "hypnotic dreamy cut for creative brands"+ - "image winds up like a whirlpool revealing the next scene"---<ComponentPreview name="swirl-dissolve" />diff --git a/content/docs/transitions/tile-wave.mdx b/content/docs/transitions/tile-wave.mdxindex ed2e090a..c5e80e9a 100644--- a/content/docs/transitions/tile-wave.mdx+++ b/content/docs/transitions/tile-wave.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a grid that lifts into solid blocks and carries a full-frame scene — use `grid-wave`."- "The change should be a few large moves rather than many small tiles — use `column-slide`."- "You need an organic, soft dissolve instead of a hard grid — use `grain-dissolve`."+askedAs:+ - "tiles shrink away diagonally"+ - "grid of squares changes scene on blue"+ - "I want a wave that shrinks a grid of tiles then regrows them as the new scene"+ - "swap idea for shipped result with a tactile tile motion"+ - "product beat with blue gradient and tile grid cut"+ - "diagonal wave pops tiles out and back in showing the next screen"---<ComponentPreview name="tile-wave" />diff --git a/content/docs/transitions/venetian-blinds.mdx b/content/docs/transitions/venetian-blinds.mdxindex 4cd69b8d..682a3fa6 100644--- a/content/docs/transitions/venetian-blinds.mdx+++ b/content/docs/transitions/venetian-blinds.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The scene is a heavy React subtree: the outgoing scene is painted once per slat; keep slats low or use `fade-through`."- "The cut should feel like a camera move rather than a graphic device; use `push-through`."- "You want the slats to carry glitch energy instead of a clean turn; use `glitch-cut`."+askedAs:+ - "window blinds scene change"+ - "horizontal slats turn to reveal"+ - "I want the scene cut into slats that flip like blinds to show the next"+ - "editorial magazine spread feel with visible structure"+ - "brand reel cut where horizontal strips rotate one after another"+ - "slats turn edge on in a ripple and the new scene shows through"---<ComponentPreview name="venetian-blinds" />diff --git a/content/docs/transitions/warp-dissolve.mdx b/content/docs/transitions/warp-dissolve.mdxindex f2721055..00d88adf 100644--- a/content/docs/transitions/warp-dissolve.mdx+++ b/content/docs/transitions/warp-dissolve.mdx@@ -11,6 +11,13 @@ useWhen:avoidWhen:- "The transition must be fast — under ~50 frames the melt has no room to read and looks like a smeared crossfade."- "Scenes are spatially related steps of one flow — use a directional move instead of a dissolve."+askedAs:+ - "liquid warp melt transition"+ - "folding distortion fade"+ - "I want the scene to melt in a wavy distorted field and straighten as the next scene"+ - "mood change that suggests time passing"+ - "organic creative brand chapter change with warping"+ - "picture folds and flows like liquid then settles into a new one"---<ComponentPreview name="warp-dissolve" />diff --git a/content/docs/transitions/wave-wipe.mdx b/content/docs/transitions/wave-wipe.mdxindex 739ada6e..759a66b2 100644--- a/content/docs/transitions/wave-wipe.mdx+++ b/content/docs/transitions/wave-wipe.mdx@@ -11,6 +11,13 @@ useWhen:avoidWhen:- "Scenes relate horizontally (steps in a flow) — the vertical sweep fights the reading direction."- "The tone is crisp and minimal — the grain texture adds visual noise by design."+askedAs:+ - "grainy wave rising up"+ - "tide washing over frame"+ - "I want a textured wave that sweeps up from the bottom covering the scene"+ - "physical swell motion between stacked scenes"+ - "reveal the next scene from below like water"+ - "sandy wave surges up over the old screen and uncovers the next"---<ComponentPreview name="wave-wipe" />diff --git a/content/docs/transitions/whip-pan.mdx b/content/docs/transitions/whip-pan.mdxindex 14893102..50e423f1 100644--- a/content/docs/transitions/whip-pan.mdx+++ b/content/docs/transitions/whip-pan.mdx@@ -11,6 +11,13 @@ useWhen:avoidWhen:- "The moment is calm or contemplative — the whip reads as urgency; use `focus-pull`."- "More than ~3 whips in a row in the same direction — vary direction or alternate with `fade-through`."+askedAs:+ - "fast sideways camera whip"+ - "motion blur swipe cut"+ - "I want the camera to whip sideways with blur so both scenes fly past"+ - "energetic feature to feature jump in a montage"+ - "tech demo rhythm with quick horizontal blur cuts"+ - "everything streaks sideways in blur and the next scene stops"---<ComponentPreview name="whip-pan" />diff --git a/content/docs/transitions/window-trail.mdx b/content/docs/transitions/window-trail.mdxindex 53c7fc0d..811ed38a 100644--- a/content/docs/transitions/window-trail.mdx+++ b/content/docs/transitions/window-trail.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The old text should be visibly struck out rather than painted over — use `strikethrough-replace`."- "You want a wipe that splits the frame between two scenes — use `diagonal-split`."- "The new line should type in rather than sweep — use `typewriter`."+askedAs:+ - "orange block drags new line"+ - "colour window sweeps up replacing text"+ - "I want an orange panel to sweep over the old line and pull the new line behind it"+ - "old look versus new look or rename rebrand reveal"+ - "swap a single sentence for its replacement with a coloured wipe"+ - "a coloured window rises over the text and trails the new text in"---<ComponentPreview name="window-trail" />diff --git a/content/docs/transitions/zoom-blur.mdx b/content/docs/transitions/zoom-blur.mdxindex bedd673e..be02ede1 100644--- a/content/docs/transitions/zoom-blur.mdx+++ b/content/docs/transitions/zoom-blur.mdx@@ -11,6 +11,13 @@ useWhen:avoidWhen:- "The cut needs lateral direction — use `whip-pan`."- "The moment needs explicit hierarchy descent (outer → inner) — use `push-through`."+askedAs:+ - "default zoom transition"+ - "push through blur cut"+ - "I want a general purpose cut that zooms out of the old scene into the new with blur"+ - "reliable scene change for a product demo"+ - "workhorse transition between screens"+ - "old scene rushes toward the viewer and new one sharpens out of blur"---<ComponentPreview name="zoom-blur" />diff --git a/content/docs/typography/a-to-z.mdx b/content/docs/typography/a-to-z.mdxindex ce247f09..f2bc8bdb 100644--- a/content/docs/typography/a-to-z.mdx+++ b/content/docs/typography/a-to-z.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The items are not alphabetical or the alphabet joke does not fit — use `index-list`."- "You want a rolling effect on a single value, not a letter column — use `slot-machine-roll`."- "You need a plain stacked list of features without the roll — use `staggered-fade-up`."+askedAs:+ - "alphabet list animation"+ - "letter column scrolls A to Z"+ - "I want each feature to start with the next letter of the alphabet"+ - "playful alphabet joke where letters roll up to Z"+ - "abc style recap of everything the product does ending on the last letter"+ - "a tall column of letters spins through the alphabet and stops on the punchline"---<ComponentPreview name="a-to-z" />diff --git a/content/docs/typography/absorb-stack.mdx b/content/docs/typography/absorb-stack.mdxindex 22d8530f..8a79c6fd 100644--- a/content/docs/typography/absorb-stack.mdx+++ b/content/docs/typography/absorb-stack.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You need one big loud headline rather than a stack — use `full-bleed-type`."- "The lines should reveal one at a time with a delay — use `line-by-line-slide`."- "You want the stack to dim line by line toward one highlighted claim — use `what-sticks`."+askedAs:+ - "centered lines with red last line"+ - "poetic slogan stack on dark brown"+ - "I want a short statement stacked in the middle with the final line in red"+ - "brand film closing slogan with a final emphasised line"+ - "quiet minimal lines that settle on a red on top"+ - "viewer reads a few small lines and the last one lands with force"---<ComponentPreview name="absorb-stack" />diff --git a/content/docs/typography/acronym-expand.mdx b/content/docs/typography/acronym-expand.mdxindex cd8cd837..026d03e9 100644--- a/content/docs/typography/acronym-expand.mdx+++ b/content/docs/typography/acronym-expand.mdx@@ -11,6 +11,13 @@ avoidWhen:- "The headline is a plain sentence with nothing to expand - use `tracking-in`."- "You want text typed on with a caret rather than letters unfolding - use `typewriter`."- "The full name is very long and would shrink to small type - use `line-by-line-slide`."+askedAs:+ - "spell out an acronym"+ - "letters expand to full name"+ - "I want MCP or SDK to unfold letter by letter into its meaning"+ - "explain what an abbreviation stands for with a label above and text below"+ - "feature naming moment where short initials are explained"+ - "viewer sees initials grow into the full words"---<ComponentPreview name="acronym-expand" />diff --git a/content/docs/typography/anagram-shuffle.mdx b/content/docs/typography/anagram-shuffle.mdxindex 27ab500b..0a6a8b4b 100644--- a/content/docs/typography/anagram-shuffle.mdx+++ b/content/docs/typography/anagram-shuffle.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The words differ by a letter or two per step — use `word-ladder`."- "The new word is unrelated and should just replace the old one — use `ruby-press`."- "You want a typo corrected in place — use `typo-fix`."+askedAs:+ - "letters rearrange into new word"+ - "anagram wordplay"+ - "I want the letters of a word to slide around and spell another word"+ - "clever hook where before and after share the same letters"+ - "playful word game moment in the video"+ - "letters swap places so one word becomes another"---<ComponentPreview name="anagram-shuffle" />diff --git a/content/docs/typography/and-you.mdx b/content/docs/typography/and-you.mdxindex 032b2dba..0d059f9d 100644--- a/content/docs/typography/and-you.mdx+++ b/content/docs/typography/and-you.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want three short benefit words instead of audiences — use `feature-trio`."- "The lines are separate claims that should dim toward one — use `what-sticks`."- "Each line should be a full-screen beat — use `point-expand`."+askedAs:+ - "for the founder who list"+ - "who it's for audiences then and you"+ - "I want a list of audience types ending with a big and you"+ - "inclusive closing line that speaks to the viewer"+ - "near the end of video address everyone who could use the product"+ - "list of personas that finishes by pointing at the viewer"---<ComponentPreview name="and-you" />diff --git a/content/docs/typography/answer-first.mdx b/content/docs/typography/answer-first.mdxindex 68678b3c..06709969 100644--- a/content/docs/typography/answer-first.mdx+++ b/content/docs/typography/answer-first.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You need a back-and-forth between two speakers — use `overheard`."- "The answer is a sheepish aside rather than a headline — use `coy-denial`."- "You want a series of objections each answered in turn — use `exactly`."+askedAs:+ - "answer before question text"+ - "who made this video a pull request"+ - "I want a big answer to appear first and then the question that explains it"+ - "punchy Q and A where the reply lands before the question"+ - "founder style claim like a pull request made it"+ - "show the surprising answer then reveal what was asked"---<ComponentPreview name="answer-first" />diff --git a/content/docs/typography/aspect-slit.mdx b/content/docs/typography/aspect-slit.mdxindex d05ffef5..3d63309c 100644--- a/content/docs/typography/aspect-slit.mdx+++ b/content/docs/typography/aspect-slit.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a clean text reveal without letterbox bars — use `soft-blur-in`."- "The title needs a gradient or dramatic camera move — use `macro-pan`."- "You need a title that appears through a fluted scan — use `slit-scan`."+askedAs:+ - "film title card widescreen slit"+ - "cinematic title opens in letterbox"+ - "I want a movie style title card with serif headline and small caption"+ - "frame my launch like a feature film"+ - "opening beat that opens through a slit with credits like text"+ - "viewer feels they are watching a movie trailer title"---<ComponentPreview name="aspect-slit" />diff --git a/content/docs/typography/axis-flex.mdx b/content/docs/typography/axis-flex.mdxindex c7b624e0..43785a83 100644--- a/content/docs/typography/axis-flex.mdx+++ b/content/docs/typography/axis-flex.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You only want a weight swell across the letters with no width change — use `weight-wave`."- "You want to show different typefaces rather than one family flexing — use `font-cycle`."- "The word should simply fade or slide in without a wave — use `soft-blur-in`."+askedAs:+ - "variable font stretch animation"+ - "word gets wider and bolder"+ - "I want a gradient word that flexes its width and weight like elastic"+ - "show off flexibility with a single stretching word"+ - "type forward title that snaps to final style after morphing"+ - "viewer watches the letters stretch and thicken then settle"---<ComponentPreview name="axis-flex" />diff --git a/content/docs/typography/baseline-drop.mdx b/content/docs/typography/baseline-drop.mdxindex 878055b2..c26455f8 100644--- a/content/docs/typography/baseline-drop.mdx+++ b/content/docs/typography/baseline-drop.mdx@@ -11,6 +11,13 @@ avoidWhen:- "The line is long enough to need several rows - use `line-by-line-slide`."- "You want soft letter-level motion instead of falling words - use `per-character-rise`."- "The text should arrive and leave with blur rather than drop - use `blur-out-up`."+askedAs:+ - "words fall onto a line"+ - "slogan with glowing streak underneath"+ - "I want each word to drop onto the same baseline one at a time"+ - "closing tagline of three or four words landing heavy"+ - "last beat where each word lands with weight above a gradient glow"+ - "words thud down in sequence while a light streak glows below"---<ComponentPreview name="baseline-drop" />diff --git a/content/docs/typography/beam-split.mdx b/content/docs/typography/beam-split.mdxindex e92064d7..44797259 100644--- a/content/docs/typography/beam-split.mdx+++ b/content/docs/typography/beam-split.mdx@@ -11,6 +11,13 @@ avoidWhen:- "There is no second phrase to place in the gap - use `blur-out-up`."- "You want a simple word-by-word entrance - use `staggered-fade-up`."- "The scene needs a swap between two lines of equal weight - use `strikethrough-replace`."+askedAs:+ - "light beam cuts headline in two"+ - "serif italic appears in the gap"+ - "I want a beam to slice a bold headline and show an italic phrase in the opening"+ - "headline setup with punchline revealed inside the split"+ - "premium reveal pairing sans bold with serif italic"+ - "title slices apart and a second phrase appears between the halves"---<ComponentPreview name="beam-split" />diff --git a/content/docs/typography/beta-thanks.mdx b/content/docs/typography/beta-thanks.mdxindex 19608bc1..f1c8bfc5 100644--- a/content/docs/typography/beta-thanks.mdx+++ b/content/docs/typography/beta-thanks.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You are announcing a launch with a long list of features — use `embargo-lift`."- "You want a simple closing line with no logo — use `plain-license`."- "You want a thanks and next-step card — use `post-script`."+askedAs:+ - "thank beta testers"+ - "is out announcement with green word"+ - "I want a release is out text with thanks to the early testers below"+ - "closing thanks to the early access community"+ - "status announcement where one word like beta is highlighted green"+ - "end of release video thanking the people who tested early"---<ComponentPreview name="beta-thanks" />diff --git a/content/docs/typography/block-swap.mdx b/content/docs/typography/block-swap.mdxindex b4adf20c..1392ce25 100644--- a/content/docs/typography/block-swap.mdx+++ b/content/docs/typography/block-swap.mdx@@ -11,6 +11,13 @@ avoidWhen:- "You only have a single line to reveal - use `mask-reveal-up`."- "You want the old text struck out and replaced in place - use `strikethrough-replace`."- "You need a soft crossfade between lines rather than a block wipe - use `per-word-crossfade`."+askedAs:+ - "solid block wipes line replaced"+ - "problem line replaced by answer"+ - "I want a coloured block to cover each line and the next line to take its place"+ - "rewrite a statement into a better one with a pill highlight at end"+ - "two step message from problem to solution text"+ - "block slides across the text and new text appears with a highlighted word"---<ComponentPreview name="block-swap" />diff --git a/content/docs/typography/blur-out-up.mdx b/content/docs/typography/blur-out-up.mdxindex f5f7eed3..094c9a93 100644--- a/content/docs/typography/blur-out-up.mdx+++ b/content/docs/typography/blur-out-up.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a blurred entrance that resolves to crisp — that is `focus-blur-resolve`, which opens blurry and sharpens in."- "The text is a paragraph or multi-line block where per-word stagger would drag too long; use `line-by-line-slide` for multi-line exits instead."- "The scene needs a hard cut or a simple opacity fade, not an upward drift — use `fade-through` for a clean A→B replacement."+askedAs:+ - "words float up and blur out"+ - "airy text exit"+ - "I want words to arrive clean and leave upward getting blurry"+ - "tagline needs a graceful exit before next scene"+ - "light editorial tone where text drifts away"+ - "text rises and fades into blur"---<ComponentPreview name="blur-out-up" />diff --git a/content/docs/typography/bokeh-title.mdx b/content/docs/typography/bokeh-title.mdxindex b8fcb523..427e2c76 100644--- a/content/docs/typography/bokeh-title.mdx+++ b/content/docs/typography/bokeh-title.mdx@@ -11,6 +11,13 @@ avoidWhen:- "The scene needs crisp, fast type with no atmosphere - use `tracking-in`."- "You only want a blur-to-sharp text resolve with no lights - use `focus-blur-resolve`."- "You want a simple fade-up of a title - use `staggered-fade-up`."+askedAs:+ - "title from out of focus lights"+ - "serif headline sharpens from bokeh"+ - "I want glowing bokeh dots that settle into a sharp headline"+ - "premium lifestyle opening title with blurred lights"+ - "cinematic opener where lights form a pattern first"+ - "headline resolves from soft drifting light circles"---<ComponentPreview name="bokeh-title" />diff --git a/content/docs/typography/boss-bar.mdx b/content/docs/typography/boss-bar.mdxindex 1fc28aab..046697ae 100644--- a/content/docs/typography/boss-bar.mdx+++ b/content/docs/typography/boss-bar.mdx@@ -10,6 +10,13 @@ useWhen:avoidWhen:- "You want a streak of eliminations ending in a banner — use `kill-feed`."- "You want a simple countdown to a reveal — use `drop-timer`."+askedAs:+ - "video game boss health bar"+ - "defeated text slam"+ - "I want an HP bar drained by hits ending with DEFEATED over the old workflow"+ - "playful gaming framing where features beat a legacy process"+ - "feature recap where each one hits the boss for damage"+ - "viewer sees the old way get knocked out like a final boss"---<ComponentPreview name="boss-bar" />diff --git a/content/docs/typography/bottom-up-letters.mdx b/content/docs/typography/bottom-up-letters.mdxindex a2259a0a..76dd7dc8 100644--- a/content/docs/typography/bottom-up-letters.mdx+++ b/content/docs/typography/bottom-up-letters.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The text is a full sentence or phrase — the high stagger makes long strings feel sluggish; use `per-character-rise` (faster, more even) or `mask-reveal-up` (line-level) instead."- "You want blur or softness in the reveal — `blur-out-up` or `focus-blur-resolve` add atmosphere that this component deliberately omits."- "The entrance should read as smooth and unified rather than letter-by-letter theatrical; use `micro-scale-fade` for a single calm pop."+askedAs:+ - "letters rise one by one"+ - "staircase letter reveal"+ - "I want each character to rise from below in a visible staircase"+ - "short punchy word with clear per letter energy"+ - "acronym landing letter by letter from the bottom"+ - "text builds with every symbol climbing up in sequence"---<ComponentPreview name="bottom-up-letters" />diff --git a/content/docs/typography/bug-dock.mdx b/content/docs/typography/bug-dock.mdxindex 6d30838a..ee30ceae 100644--- a/content/docs/typography/bug-dock.mdx+++ b/content/docs/typography/bug-dock.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want the headline alone with no logo lockup — use `soft-blur-in`."- "The brand should stay centered with a status word — use `beta-thanks`."- "You need a logo reveal on its own — use `flip-sting`."+askedAs:+ - "tv channel logo corner bug"+ - "brand shrinks to corner"+ - "I want a broadcast style logo to dock in the bottom corner while the message takes over"+ - "title that feels like a tv show with the brand bug"+ - "intro beat where the logo becomes a small watermark"+ - "playing on every screen text with a little logo settling at the bottom"---<ComponentPreview name="bug-dock" />diff --git a/content/docs/typography/caret-letter.mdx b/content/docs/typography/caret-letter.mdxindex 349770e4..827bcdfb 100644--- a/content/docs/typography/caret-letter.mdx+++ b/content/docs/typography/caret-letter.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You just need a typed line with no morph — use `typewriter`."- "The caret should swap one word for another — use `caret-swap`."- "You want a caret that wipes content on or off instead of becoming a letter — use `caret-wipe`."+askedAs:+ - "cursor becomes a letter"+ - "typed name with caret morph"+ - "I want a blinking cursor to type a word then turn into the missing letter"+ - "brand name reveal where the cursor is part of the name"+ - "clean intro with typing leading into the logo wordmark"+ - "caret slides in and transforms into one letter of the product name"---<ComponentPreview name="caret-letter" />diff --git a/content/docs/typography/caret-swap.mdx b/content/docs/typography/caret-swap.mdxindex 5e7fdcb7..649d0c67 100644--- a/content/docs/typography/caret-swap.mdx+++ b/content/docs/typography/caret-swap.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You only need one phrase typed from empty — use `typewriter`."- "The swap should happen word by word rather than through a caret block — use `word-stream` or `value-swap`."- "You need a full-frame scene transition driven by a caret — use the `caret-wipe` transition."+askedAs:+ - "cursor block eats text then retypes"+ - "replace phrase with typing"+ - "I want a cursor to swell into a block that deletes the old words and types new ones"+ - "swap one phrase for another with a typing gesture"+ - "editing effect like selecting text and writing over it"+ - "gradient block grows over the first text and the second types in"---<ComponentPreview name="caret-swap" />diff --git a/content/docs/typography/case-flip.mdx b/content/docs/typography/case-flip.mdxindex d14a2c5d..6243bc6e 100644--- a/content/docs/typography/case-flip.mdx+++ b/content/docs/typography/case-flip.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want letters decoding from random characters instead of flipping case — use `matrix-decode`."- "The text should simply fade up with no casing gag — use `staggered-fade-up`."- "You want one smooth morph between two phrases — use `kinetic-morph-text`."+askedAs:+ - "lowercase to uppercase flip"+ - "text turns LOUD letter by letter"+ - "I want a headline to flip from small caps to capitals glyph by glyph"+ - "casing joke like a quiet word turning loud"+ - "title with a fun letter flipping landing on final case"+ - "letters flip one at a time between lower and upper case"---<ComponentPreview name="case-flip" />diff --git a/content/docs/typography/centered-word-build.mdx b/content/docs/typography/centered-word-build.mdxindex 91b95649..14ab1375 100644--- a/content/docs/typography/centered-word-build.mdx+++ b/content/docs/typography/centered-word-build.mdx@@ -12,6 +12,13 @@ avoidWhen:- "Each new word should physically drive the existing line aside — use `word-push`."- "Words should replace one another in the same fixed slot — use `per-word-crossfade`."- "You need character-by-character input with a caret — use `typewriter`."+askedAs:+ - "words build centered phrase"+ - "phrase pushes closer each word"+ - "I want words to appear one at a time from below while the centred line gets bigger"+ - "short statement assembled word by word and always centered"+ - "slow reveal where the camera keeps pushing in on the sentence"+ - "each new word pops in and the whole phrase zooms in a bit"---<ComponentPreview name="centered-word-build" />diff --git a/content/docs/typography/changed-mind.mdx b/content/docs/typography/changed-mind.mdxindex 1a5faa3d..4aa90e46 100644--- a/content/docs/typography/changed-mind.mdx+++ b/content/docs/typography/changed-mind.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You have several different testimonials from different people — use `quote-hero`."- "You only need one static pull quote with an attribution — use `said-who`."- "The quotes share almost no words, so nothing carries over between steps — use `overheard`."+askedAs:+ - "quote edited in place"+ - "pull quote with solo founder"+ - "I want a testimonial quote that changes its words to show the customer changed their mind"+ - "before and after opinion shown in a single big serif quote"+ - "customer story where the quote gets rewritten to the final praise"+ - "viewer sees a review evolve into the only tool I use now"---<ComponentPreview name="changed-mind" />diff --git a/content/docs/typography/changelog-scroll.mdx b/content/docs/typography/changelog-scroll.mdxindex eb6d9208..597758ea 100644--- a/content/docs/typography/changelog-scroll.mdx+++ b/content/docs/typography/changelog-scroll.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a live terminal-style log instead of a list — use `terminal-simulator`."- "You want a short numbered feature list — use `index-list`."- "You have three headline benefits, not a history — use `feature-trio`."+askedAs:+ - "release notes list scrolling"+ - "what's new highlight latest entry"+ - "I want a list of versions scrolling and the newest one enlarging"+ - "zoom into the latest release from a long history"+ - "release notes video featuring one key update"+ - "viewer sees many past releases then focus lands on the new one"---<ComponentPreview name="changelog-scroll" />diff --git a/content/docs/typography/chore-fold.mdx b/content/docs/typography/chore-fold.mdxindex 8a3b609e..1d129d45 100644--- a/content/docs/typography/chore-fold.mdx+++ b/content/docs/typography/chore-fold.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want pain points to dim toward one claim rather than fold away — use `what-sticks`."- "The objections need answers one at a time — use `exactly`."- "You want a simple three-item benefit list — use `feature-trio`."+askedAs:+ - "chores folded away product line"+ - "you just talk"+ - "I want a list of annoying tasks to fold up and be replaced by one product line"+ - "pain point montage ending on the easy way"+ - "before and after where the product takes care of everything"+ - "teal text shows all that work disappears and you only speak"---<ComponentPreview name="chore-fold" />diff --git a/content/docs/typography/chromatic-wave.mdx b/content/docs/typography/chromatic-wave.mdxindex 99c24764..30d707df 100644--- a/content/docs/typography/chromatic-wave.mdx+++ b/content/docs/typography/chromatic-wave.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You need a quick glitch accent rather than a five-second traveling wave — use `rgb-glitch-text`."- "The background is light — the screen blend that reassembles the channels breaks over anything but dark fills."- "The copy changes or enters mid-scene — the type is static; this is a treatment, not a reveal; use `soft-blur-in` first."+askedAs:+ - "rgb ripple through text"+ - "soft wave distorts title"+ - "I want a slow wave to pass through a held title with colour fringes"+ - "ambient looping poster style type distortion"+ - "album cover title that gently ripples and returns to white"+ - "letters split into red green blue as a wave travels down"---<ComponentPreview name="chromatic-wave" />diff --git a/content/docs/typography/chunk-stack.mdx b/content/docs/typography/chunk-stack.mdxindex 73929b3f..45684190 100644--- a/content/docs/typography/chunk-stack.mdx+++ b/content/docs/typography/chunk-stack.mdx@@ -10,6 +10,13 @@ useWhen:avoidWhen:- "You want one giant word filling the frame — use `edge-fit`."- "You want words slamming in with condensed caps — use `full-bleed-type`."+askedAs:+ - "one word per line slogan"+ - "yellow highlighter on a word"+ - "I want a slogan stacked one word per line with a highlight marker on one word"+ - "bold readable statement like learn motion by making it"+ - "short claim where a single word is marked in yellow"+ - "words stack down the screen and a highlighter swipes across the key word"---<ComponentPreview name="chunk-stack" />diff --git a/content/docs/typography/column-reflow.mdx b/content/docs/typography/column-reflow.mdxindex 75cee921..6bc69788 100644--- a/content/docs/typography/column-reflow.mdx+++ b/content/docs/typography/column-reflow.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You need a short punchy headline rather than a paragraph — use `soft-blur-in`."- "You want a paragraph to set itself into a column once — use `tagline-justify`."- "The text should be revealed line by line — use `line-by-line-slide`."+askedAs:+ - "justified paragraph resizing"+ - "I want a block of text to reflow as its width changes"+ - "show a responsive layout with body copy rewrapping live"+ - "text column getting wider and narrower with even spacing"+ - "editorial typography demo for a layout or publishing tool"+ - "a beat where the paragraph itself adapts to the screen size"---<ComponentPreview name="column-reflow" />diff --git a/content/docs/typography/comet-headline.mdx b/content/docs/typography/comet-headline.mdxindex 9a42efce..2872c137 100644--- a/content/docs/typography/comet-headline.mdx+++ b/content/docs/typography/comet-headline.mdx@@ -11,6 +11,13 @@ avoidWhen:- "The headline is a single short word - use `spring-scale-in`."- "You want calm, text-only motion with no streaks - use `staggered-fade-up`."- "The scene is just a typed line - use `typewriter`."+askedAs:+ - "headline with light trails"+ - "I want each word to arrive trailing a shooting star"+ - "feature announcement where words streak in on glowing arcs"+ - "hero line with comet tails behind the words and one highlighted phrase"+ - "a bright, energetic moment announcing something new and fast"+ - "shooting star text intro"---<ComponentPreview name="comet-headline" />diff --git a/content/docs/typography/cool-down.mdx b/content/docs/typography/cool-down.mdxindex 8ebffe85..1b0c0f42 100644--- a/content/docs/typography/cool-down.mdx+++ b/content/docs/typography/cool-down.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want to show a number counting up — use `rolling-number`."- "The claim needs a code-style reveal — use `uncomment-line`."- "You need a longer line with several words animating in — use `staggered-fade-up`."+askedAs:+ - "calm short statement"+ - "I want a two-word claim to settle in big over a faint grid"+ - "a quiet efficiency or low-power message with a tiny mono caption"+ - "show that the product stays cool and unbothered under load"+ - "performance beat that should feel relaxed rather than loud"+ - "large settled phrase technical grid"---<ComponentPreview name="cool-down" />diff --git a/content/docs/typography/cooling-type.mdx b/content/docs/typography/cooling-type.mdxindex 489841ce..4b5f082a 100644--- a/content/docs/typography/cooling-type.mdx+++ b/content/docs/typography/cooling-type.mdx@@ -11,6 +11,13 @@ avoidWhen:- "You want a plain typed line with a blinking caret - use `typewriter`."- "You want every letter to land with a bounce - use `per-character-rise`."- "The text is a short label, not a sentence - use `tracking-in`."+askedAs:+ - "hot text cooling down"+ - "I want a sentence typed live that glows then turns to ink"+ - "question hook written in real time ending on an italic serif word"+ - "cinematic title where letters start glowing orange and settle"+ - "typing line with caret ending in an emphasized word"+ - "glowing typewriter cooling"---<ComponentPreview name="cooling-type" />diff --git a/content/docs/typography/counter-reveal.mdx b/content/docs/typography/counter-reveal.mdxindex b7980ac2..49df7ec5 100644--- a/content/docs/typography/counter-reveal.mdx+++ b/content/docs/typography/counter-reveal.mdx@@ -11,6 +11,13 @@ avoidWhen:- "The front word has few closed letterforms to reveal through - use `mask-reveal-up`."- "You want both lines visible at once - use `staggered-fade-up`."- "You need a simple word-by-word exit - use `blur-out-up`."+askedAs:+ - "text hidden inside letters"+ - "I want a big word with a second line showing through its holes"+ - "bold one-word status like Beta or Live hiding a secondary message"+ - "announcement where the letter counters reveal a subline over a gradient"+ - "a surprise detail discovered inside a huge word"+ - "letter holes reveal"---<ComponentPreview name="counter-reveal" />diff --git a/content/docs/typography/cover-ring.mdx b/content/docs/typography/cover-ring.mdxindex dd478a97..770ba92a 100644--- a/content/docs/typography/cover-ring.mdx+++ b/content/docs/typography/cover-ring.mdx@@ -11,6 +11,13 @@ avoidWhen:- "You have no photos and want text only - use `staggered-fade-up`."- "You want a typed caption instead of a collapse - use `cooling-type`."- "The scene is a single line with no setup - use `tracking-in`."+askedAs:+ - "audio meter above headline"+ - "I want a launch line over product photos that collapses into a punchline"+ - "bar equalizer then a caption closing a collage montage"+ - "a beat that goes from loud montage to a quiet closing line"+ - "green glow ending caption with sound bars"+ - "voice level bars caption"---<ComponentPreview name="cover-ring" />diff --git a/content/docs/typography/coy-denial.mdx b/content/docs/typography/coy-denial.mdxindex 2b3bca51..ef8cd9d6 100644--- a/content/docs/typography/coy-denial.mdx+++ b/content/docs/typography/coy-denial.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The punchline is an attribution below a quote — use `deadpan-box`."- "You want the answer to come first, big — use `answer-first`."- "You need a hesitant start answered by a bold reply — use `no-buts`."+askedAs:+ - "joke text with tiny aside"+ - "I want a loud statement undone by a sheepish parenthetical"+ - "teaser that says dont visit the site then quietly admits do"+ - "comedic launch beat with a huge denial and a small corner note"+ - "funny reverse psychology tease before release day"+ - "big line small punchline in corner"---<ComponentPreview name="coy-denial" />diff --git a/content/docs/typography/crew-of-one.mdx b/content/docs/typography/crew-of-one.mdxindex cc234f83..8eaf904a 100644--- a/content/docs/typography/crew-of-one.mdx+++ b/content/docs/typography/crew-of-one.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a list of benefits rather than credits — use `feature-trio`."- "The list should end on the audience, not a name — use `and-you`."- "You want the viewer addressed in several lines — use `they-are-you`."+askedAs:+ - "movie credits joke"+ - "I want credits roll where every role is the same person"+ - "solo builder message listing writer director and shipper"+ - "show that one person did everything, ending on you"+ - "closing credits gag for an indie maker video"+ - "one man crew credits"---<ComponentPreview name="crew-of-one" />diff --git a/content/docs/typography/crunch.mdx b/content/docs/typography/crunch.mdxindex 17d51a1c..29c3fee0 100644--- a/content/docs/typography/crunch.mdx+++ b/content/docs/typography/crunch.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want several timestamped lines drifting past rather than one squeeze — use `story-dip`."- "The story is a single dated line — use `overnight`."- "You need a plain statement with no narrative arc — use `soft-blur-in`."+askedAs:+ - "deadline story timestamps"+ - "I want timestamped lines that build pressure then relief"+ - "short story about a crunch ending with it shipped in time"+ - "problem to relief arc told with clock times on dark brown"+ - "late night working log text"+ - "time stamped story lines"---<ComponentPreview name="crunch" />diff --git a/content/docs/typography/cursor-frame.mdx b/content/docs/typography/cursor-frame.mdxindex 16bc07ba..ea7225be 100644--- a/content/docs/typography/cursor-frame.mdx+++ b/content/docs/typography/cursor-frame.mdx@@ -11,6 +11,13 @@ avoidWhen:- "You want the headline to just appear - use `staggered-fade-up`."- "You want a typing effect rather than a drag interaction - use `typewriter`."- "You want a highlighter pass over a phrase - use `marker-highlight`."+askedAs:+ - "design tool selection box"+ - "I want a selected headline dragged and resized with handles"+ - "show text being edited like in a design editor with a size badge"+ - "product video about layout where the text rewraps as the frame resizes"+ - "Figma style resize handles on text"+ - "drag handles resize headline"---<ComponentPreview name="cursor-frame" />diff --git a/content/docs/typography/cut-off.mdx b/content/docs/typography/cut-off.mdxindex b0b8bd6c..65789d85 100644--- a/content/docs/typography/cut-off.mdx+++ b/content/docs/typography/cut-off.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The setup should be answered with a sheepish aside, not a hard cut — use `coy-denial`."- "You want a hesitant start answered by a bold reply — use `no-buts`."- "You need a shutter-style cut off of a line — use `peek-shut`."+askedAs:+ - "interrupted sentence joke"+ - "I want a long line cut off by a short reply card"+ - "show a tedious explanation interrupted by a better answer"+ - "before and after where a slow way is cut short by the code"+ - "reply bubble interrupting text"+ - "text interrupted by white card"---<ComponentPreview name="cut-off" />diff --git a/content/docs/typography/deadpan-box.mdx b/content/docs/typography/deadpan-box.mdxindex 19d35df6..4a2b285c 100644--- a/content/docs/typography/deadpan-box.mdx+++ b/content/docs/typography/deadpan-box.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The quote is sincere praise from a real customer — use `quote-hero`."- "You want a quick one-line reveal with no setup and punchline — use `soft-blur-in`."- "The setup needs a follow-up aside in a corner rather than a flood — use `coy-denial`."+askedAs:+ - "flat quote in blue box"+ - "I want a dry quote card with a small attribution"+ - "punchline where the attribution flips the setup"+ - "minimal bold testimonial style card with a deadpan tone"+ - "a joke moment in a launch video with a quiet quote"+ - "blue quote box attribution"---<ComponentPreview name="deadpan-box" />diff --git a/content/docs/typography/depth-headline.mdx b/content/docs/typography/depth-headline.mdxindex 26d56400..74db0fdc 100644--- a/content/docs/typography/depth-headline.mdx+++ b/content/docs/typography/depth-headline.mdx@@ -11,6 +11,13 @@ avoidWhen:- "The headline needs to read clearly with nothing overlapping it - use `staggered-fade-up`."- "You want letters to rise individually - use `per-character-rise`."- "You want a calm blur-in title - use `soft-blur-in`."+askedAs:+ - "text behind a sphere"+ - "I want a big serif title with a gradient ball sliding in front"+ - "layered hero word with an object passing in front of it"+ - "opening title that feels three dimensional through depth layering"+ - "premium product name with a floating orb overlapping the letters"+ - "title with orb in front"---<ComponentPreview name="depth-headline" />diff --git a/content/docs/typography/diff-swap.mdx b/content/docs/typography/diff-swap.mdxindex fd6f7641..fcac2417 100644--- a/content/docs/typography/diff-swap.mdx+++ b/content/docs/typography/diff-swap.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The change is a single word inside a sentence — use `strikethrough-replace`."- "Text should be selected then retyped like an editor — use `select-replace`."- "The audience is non-technical and a diff would confuse — use `layout-swap`."+askedAs:+ - "code diff style edit"+ - "I want an old line replaced by a new line like a git diff"+ - "dev tool scene showing the painful old way swapped for the new"+ - "changelog moment with one line removed and one added highlighted"+ - "red and green line change"+ - "before line rewritten to after"---<ComponentPreview name="diff-swap" />diff --git a/content/docs/typography/dot-type.mdx b/content/docs/typography/dot-type.mdxindex a0a53f92..b3657a58 100644--- a/content/docs/typography/dot-type.mdx+++ b/content/docs/typography/dot-type.mdx@@ -11,6 +11,13 @@ avoidWhen:- "The words must stay readable at small sizes - use `typewriter`."- "You want a glitchy decode instead of dots - use `matrix-decode`."- "You want one word swapping through options - use `slot-machine-roll`."+askedAs:+ - "text made of dots"+ - "I want words formed from round dots in a gradient"+ - "rapid sequence of single words like Think Make Ship drawn from dots"+ - "tech title card where letters assemble out of a dot field"+ - "halftone dot lettering"+ - "dot matrix word reveal"---<ComponentPreview name="dot-type" />diff --git a/content/docs/typography/double-take.mdx b/content/docs/typography/double-take.mdxindex f19a0680..afb80e74 100644--- a/content/docs/typography/double-take.mdx+++ b/content/docs/typography/double-take.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The surprise is the answer to a question — use `answer-first`."- "You want a phrase lifted out of a sentence as a title — use `hidden-word`."- "The line should rewrite itself instead of rewinding — use `changed-mind`."+askedAs:+ - "read that again claim"+ - "I want a surprising stat that makes viewers look twice"+ - "oversized pink phrase on blue under a small prompt"+ - "team size or time to build shock claim moment"+ - "one person did this emphasis"+ - "read that again"---<ComponentPreview name="double-take" />diff --git a/content/docs/typography/drop-timer.mdx b/content/docs/typography/drop-timer.mdxindex 70e02c9b..9cca159f 100644--- a/content/docs/typography/drop-timer.mdx+++ b/content/docs/typography/drop-timer.mdx@@ -10,6 +10,13 @@ useWhen:avoidWhen:- "You want an escalating word sequence instead of a clock — use `escalate-cards`."- "You want a rolling number, not a countdown — use `rolling-number`."+askedAs:+ - "product drop countdown"+ - "I want a countdown that ends in a huge live now banner"+ - "release day teaser smashing into a URL and logo"+ - "build hype before a launch then reveal it is live"+ - "countdown to live now"+ - "launch day timer payoff"---<ComponentPreview name="drop-timer" />diff --git a/content/docs/typography/echo-stack.mdx b/content/docs/typography/echo-stack.mdxindex b3d6ede1..e7d6a540 100644--- a/content/docs/typography/echo-stack.mdx+++ b/content/docs/typography/echo-stack.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The word should just appear and stay still — use `focus-blur-resolve`."- "The repeats should run sideways as a strip of text — use `infinite-marquee`."- "The screen should fill with rows of text rather than a column around one word — use `type-wall`."+askedAs:+ - "word repeated as outline copies"+ - "I want one word held on screen that still feels alive"+ - "single value or promise word with ghost copies drifting above and below"+ - "a lasting one-word statement with a spinning drum feel"+ - "outline echoes of a word"+ - "repeating ghost text stack"---<ComponentPreview name="echo-stack" />diff --git a/content/docs/typography/edge-fit.mdx b/content/docs/typography/edge-fit.mdxindex bb10d9a2..daa2ebd2 100644--- a/content/docs/typography/edge-fit.mdx+++ b/content/docs/typography/edge-fit.mdx@@ -10,6 +10,13 @@ useWhen:avoidWhen:- "You want a stacked multi-word slogan — use `chunk-stack`."- "You want hard slams with condensed caps — use `full-bleed-type`."+askedAs:+ - "word fills the whole frame"+ - "I want one huge word stretched edge to edge"+ - "rapid word montage where each word fills the screen"+ - "closing beat naming kinds of outputs with a caption and logo"+ - "full width single word"+ - "giant cream word frame filling"---<ComponentPreview name="edge-fit" />diff --git a/content/docs/typography/edit-ripple.mdx b/content/docs/typography/edit-ripple.mdxindex 11ca1c19..e1f998a5 100644--- a/content/docs/typography/edit-ripple.mdx+++ b/content/docs/typography/edit-ripple.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want objections each answered in turn — use `exactly`."- "You need one sentence to edit itself in place — use `changed-mind`."- "You want a word-by-word diff of before and after — use `diff-swap`."+askedAs:+ - "change it and re-run message"+ - "I want lines showing one edit changing everything after"+ - "cause and effect lines with the second indented and colored"+ - "if this then that statements about editing a video"+ - "ripple effect text"+ - "show that a tweak updates the whole render"---<ComponentPreview name="edit-ripple" />diff --git a/content/docs/typography/ellipsis-resolve.mdx b/content/docs/typography/ellipsis-resolve.mdxindex 84cc643d..10e2a805 100644--- a/content/docs/typography/ellipsis-resolve.mdx+++ b/content/docs/typography/ellipsis-resolve.mdx@@ -11,6 +11,13 @@ avoidWhen:- "The payoff is a full sentence - use `typewriter`."- "You want a swap between two words - use `slot-machine-roll`."- "You want letters to stagger in with no dots - use `per-character-rise`."+askedAs:+ - "three dots turning into a word"+ - "I want a thinking indicator that becomes a result word"+ - "loading to done beat ending on Shipped with a period"+ - "punchy one-word payoff after a typing indicator"+ - "pulsing dots then word"+ - "wait then reveal finished word"---<ComponentPreview name="ellipsis-resolve" />diff --git a/content/docs/typography/embargo-lift.mdx b/content/docs/typography/embargo-lift.mdxindex 19854463..8eebe1b5 100644--- a/content/docs/typography/embargo-lift.mdx+++ b/content/docs/typography/embargo-lift.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a plain one-line reveal with no redaction look — use `mask-reveal-up`."- "You are thanking testers instead of announcing — use `beta-thanks`."- "The reveal should come from a transition between two scenes — use `fade-through`."+askedAs:+ - "redacted text revealed"+ - "I want launch facts uncovered from behind black bars"+ - "press embargo style announcement out today"+ - "launch day message revealing free and open source in condensed type"+ - "redaction bars lifting"+ - "censor bars removed reveal"---<ComponentPreview name="embargo-lift" />diff --git a/content/docs/typography/enhance-count.mdx b/content/docs/typography/enhance-count.mdxindex 66fb70ac..0defd295 100644--- a/content/docs/typography/enhance-count.mdx+++ b/content/docs/typography/enhance-count.mdx@@ -11,6 +11,13 @@ avoidWhen:- "You want a blur-in entrance only - use `focus-blur-resolve`."- "You need the text to change content, not weight - use `strikethrough-replace`."- "You want a simple fade-up - use `staggered-fade-up`."+askedAs:+ - "blurry text sharpening up"+ - "I want a thin soft line to become heavier and crisp"+ - "before and after about quality, rough draft to finished piece"+ - "a two line statement where the second gets bolder in accent color"+ - "enhance image effect on text"+ - "thin to bold sharpen"---<ComponentPreview name="enhance-count" />diff --git a/content/docs/typography/escalate-cards.mdx b/content/docs/typography/escalate-cards.mdxindex 9ef60341..ba711021 100644--- a/content/docs/typography/escalate-cards.mdx+++ b/content/docs/typography/escalate-cards.mdx@@ -10,6 +10,13 @@ useWhen:avoidWhen:- "You want a countdown clock — use `drop-timer`."- "You want slams of condensed caps without cards — use `full-bleed-type`."+askedAs:+ - "flashing word cards faster"+ - "I want single words flashing on cards accelerating to a finale"+ - "build up where the last word fills the frame over a date"+ - "release date reveal after rapid cards"+ - "accelerating word flashes"+ - "cards speed up date reveal"---<ComponentPreview name="escalate-cards" />diff --git a/content/docs/typography/exactly.mdx b/content/docs/typography/exactly.mdxindex 1756c32f..b36c441b 100644--- a/content/docs/typography/exactly.mdx+++ b/content/docs/typography/exactly.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want the answer to appear before the question — use `answer-first`."- "The reply is a hard cut over the objection — use `cut-off`."- "The objections are small and the answer is one big sentence — use `in-proportion`."+askedAs:+ - "one word agreement reply"+ - "I want a yellow Exactly answering an objection"+ - "back and forth where the reply flips the objection into a positive"+ - "short confirmation line then a simple follow up statement"+ - "yes exactly reply text"+ - "answer objections it is just code"---<ComponentPreview name="exactly" />diff --git a/content/docs/typography/extrude-pop.mdx b/content/docs/typography/extrude-pop.mdxindex 69bd2f64..147fa8f0 100644--- a/content/docs/typography/extrude-pop.mdx+++ b/content/docs/typography/extrude-pop.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The text is long or small — the extruded body doubles the ink and turns a sentence into mush; keep it to one short word."- "You need real perspective or a moving camera — the extrusion angle is fixed; this sells one static viewpoint."- "The style is minimal or elegant — the effect is loud by design; use `spring-scale-in` for a softer pop."+askedAs:+ - "3D word popping up"+ - "I want a flat word to rise with a solid colored body"+ - "short verdict or CTA landing with physical weight like a stamp"+ - "a punchy extruded block letter pop with no camera movement"+ - "3D extruded text"+ - "stamp rising off the page"---<ComponentPreview name="extrude-pop" />diff --git a/content/docs/typography/factor-out.mdx b/content/docs/typography/factor-out.mdxindex 9d60cd43..fdb2366f 100644--- a/content/docs/typography/factor-out.mdx+++ b/content/docs/typography/factor-out.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The lines are separate claims to be dimmed toward one — use `what-sticks`."- "You want three single feature words with notes — use `feature-trio`."- "You need a long list of steps to be folded away — use `chore-fold`."+askedAs:+ - "three commands one location"+ - "I want three short verbs stacked over a shared phrase"+ - "feature beat where several actions all happen in your editor"+ - "list of imperatives sharing one tool or result"+ - "stacked verbs shared ending"+ - "write render ship in one place"---<ComponentPreview name="factor-out" />diff --git a/content/docs/typography/fade-through.mdx b/content/docs/typography/fade-through.mdxindex 57b67122..916fe9eb 100644--- a/content/docs/typography/fade-through.mdx+++ b/content/docs/typography/fade-through.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want the incoming words to arrive one by one — use `per-word-crossfade` for a sequential word-level fade instead."- "The A→B swap should carry kinetic weight or directional momentum — use `line-by-line-slide` (slide direction) or `blur-out-up` (upward drift)."- "There is no outgoing text (first entrance only) — skip the \"from\" slot and use `micro-scale-fade` or `mask-reveal-up` for a single entrance."+askedAs:+ - "swap one label for another"+ - "I want old text fading out as new text fades in"+ - "clean neutral text replacement in the same spot"+ - "stat or short phrase changing without drama"+ - "crossfade text change"+ - "soft text swap material design"---<ComponentPreview name="fade-through" />diff --git a/content/docs/typography/feather-settle.mdx b/content/docs/typography/feather-settle.mdxindex 76f67c0f..ae9e52f4 100644--- a/content/docs/typography/feather-settle.mdx+++ b/content/docs/typography/feather-settle.mdx@@ -11,6 +11,13 @@ avoidWhen:- "You need a fast, energetic entrance - use `rush-type`."- "You want words to drop and bounce rather than float - use `baseline-drop`."- "You want a controlled blur reveal - use `soft-blur-in`."+askedAs:+ - "words floating down softly"+ - "I want words drifting like feathers into a sentence"+ - "calm reassuring closing line with a gentle landing"+ - "slow soft sign off that feels light and safe"+ - "swaying falling words"+ - "gentle drifting text arrival"---<ComponentPreview name="feather-settle" />diff --git a/content/docs/typography/feature-chips-flow.mdx b/content/docs/typography/feature-chips-flow.mdxindex 06ed2639..bf5b8dee 100644--- a/content/docs/typography/feature-chips-flow.mdx+++ b/content/docs/typography/feature-chips-flow.mdx@@ -10,6 +10,13 @@ useWhen:avoidWhen:- "You only have three features to show properly — use `feature-trio`."- "You want features as a list that scrolls — use `index-list`."+askedAs:+ - "feature pills streaming"+ - "I want rows of tag pills scrolling then clustering around the logo"+ - "feature overview montage ending on the product logo"+ - "show how many capabilities the product has in a flowing wall of chips"+ - "pill tags around logo"+ - "streaming badges cluster"---<ComponentPreview name="feature-chips-flow" />diff --git a/content/docs/typography/feature-headline.mdx b/content/docs/typography/feature-headline.mdxindex c1c901fc..8c435296 100644--- a/content/docs/typography/feature-headline.mdx+++ b/content/docs/typography/feature-headline.mdx@@ -11,6 +11,13 @@ avoidWhen:- "You need a centered cinematic title with no tag - use `tracking-in`."- "You want only a bare text exit - use `blur-out-up`."- "The headline needs a typed feel - use `typewriter`."+askedAs:+ - "new tag with headline"+ - "I want a New badge opening then a headline rising word by word"+ - "feature spotlight with title and short subtitle"+ - "chapter title in a product tour introducing a feature"+ - "badge pill headline subhead"+ - "announce a new feature title card"---<ComponentPreview name="feature-headline" />diff --git a/content/docs/typography/feature-trio.mdx b/content/docs/typography/feature-trio.mdxindex 802fc852..3fb7a48d 100644--- a/content/docs/typography/feature-trio.mdx+++ b/content/docs/typography/feature-trio.mdx@@ -12,6 +12,13 @@ avoidWhen:- "Each feature needs a screenshot or UI view — use `feature-headline`."- "The benefits are a numbered how-it-works flow — use `three-steps`."- "You want a numbered index of features with hairline rows — use `index-list`."+askedAs:+ - "three benefits in a row"+ - "I want three short words like Fast Composable Open source"+ - "features recap near the end of a launch video"+ - "list of three selling points rising from masks with small notes"+ - "three word tagline"+ - "benefit summary with progress ticks"---<ComponentPreview name="feature-trio" />diff --git a/content/docs/typography/filler-cut.mdx b/content/docs/typography/filler-cut.mdxindex 14955e89..b02c6e31 100644--- a/content/docs/typography/filler-cut.mdx+++ b/content/docs/typography/filler-cut.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a before line diffed into an after line — use `diff-swap`."- "A misspelled word should be corrected in place — use `typo-fix`."- "You want a block to overwrite each line with the next — use `block-swap`."+askedAs:+ - "remove filler words from transcript"+ - "I want umm and uh words struck out leaving a clean line"+ - "captions editing tool demo showing speech being cleaned"+ - "messy sentence before and after cleanup"+ - "transcript cleanup"+ - "delete ums from subtitles"---<ComponentPreview name="filler-cut" />diff --git a/content/docs/typography/fine-print-up.mdx b/content/docs/typography/fine-print-up.mdxindex 3ded0215..0ad5ef50 100644--- a/content/docs/typography/fine-print-up.mdx+++ b/content/docs/typography/fine-print-up.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want claims to dim toward one highlight instead of moving to the footer — use `what-sticks`."- "You have a single license promise in big type — use `plain-license`."- "The claims are three benefit words — use `feature-trio`."+askedAs:+ - "promise with tiny fine print"+ - "I want a big serif promise and small legal text below"+ - "terms or licensing beat turning promises into small lines"+ - "reassurance ending with no account no watermark"+ - "fine print line"+ - "small print under big claim"---<ComponentPreview name="fine-print-up" />diff --git a/content/docs/typography/flank-roll-swap.mdx b/content/docs/typography/flank-roll-swap.mdxindex dae7f870..87314c1e 100644--- a/content/docs/typography/flank-roll-swap.mdx+++ b/content/docs/typography/flank-roll-swap.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You have no images and want a plain text swap — use `width-lock`."- "The photo should sit behind the text as a fill — use `photo-fill-type`."- "You want the headline to change by shifting layout, not rolling — use `layout-swap`."+askedAs:+ - "words rolling around a photo"+ - "I want two words on each side of an image changing like a slot"+ - "release announcement swapping studio name for out now around a hero image"+ - "brand line with a picture sitting in the middle of the sentence"+ - "image between words"+ - "inline photo with rolling words"---<ComponentPreview name="flank-roll-swap" />diff --git a/content/docs/typography/flick-swap.mdx b/content/docs/typography/flick-swap.mdxindex c46462de..a88983bc 100644--- a/content/docs/typography/flick-swap.mdx+++ b/content/docs/typography/flick-swap.mdx@@ -11,6 +11,13 @@ avoidWhen:- "You only have a single headline - use `feature-headline`."- "You want items to change in place with a crossfade - use `per-word-crossfade`."- "You want one word to roll through options - use `slot-machine-roll`."+askedAs:+ - "scrolling headline rail"+ - "I want a headline flicking up to swap between items with labels"+ - "feature rundown cycling several one line claims in one scene"+ - "categories listed one by one each with a highlighted phrase"+ - "flick through taglines"+ - "slot style line changing"---<ComponentPreview name="flick-swap" />diff --git a/content/docs/typography/focus-blur-resolve.mdx b/content/docs/typography/focus-blur-resolve.mdxindex 2fcbb00d..2993b808 100644--- a/content/docs/typography/focus-blur-resolve.mdx+++ b/content/docs/typography/focus-blur-resolve.mdx@@ -13,6 +13,13 @@ avoidWhen:- "The text is multiple lines or a paragraph — the blur radius is designed for a single short phrase; use `mask-reveal-up` or `line-by-line-slide` for multi-line reveals."- "The entrance should be sharp from frame one — use `kinetic-center-build` or `per-character-rise` when there should be no blurry opener."- "You want a blur entrance that holds crisp with no exit — `focus-blur-resolve` forces a blur-out departure; use `soft-blur-in` for an entrance-only blur reveal."+askedAs:+ - "blur to sharp text"+ - "I want a camera lens focus pull on a hero word"+ - "premium in and out arc from heavy blur to crisp then blur away"+ - "title that feels like a lens snapping into focus"+ - "rack focus title"+ - "blurry text coming into focus"---<ComponentPreview name="focus-blur-resolve" />diff --git a/content/docs/typography/focus-front-swap.mdx b/content/docs/typography/focus-front-swap.mdxindex 233ecd0c..7ebb92bb 100644--- a/content/docs/typography/focus-front-swap.mdx+++ b/content/docs/typography/focus-front-swap.mdx@@ -12,6 +12,13 @@ avoidWhen:- "Lines should swap by shifting layout rather than depth — use `layout-swap`."- "You need an object sweeping across the frame — use `pass-swap`."- "You want one word changed while the rest stays put — use `pinned-word`."+askedAs:+ - "headline pulling focus between lines"+ - "I want each line to blur out as the next comes forward"+ - "rhythmic three line pitch ending on a logo and ship now"+ - "cinematic headline sequence over a soft gradient"+ - "depth of field text swap"+ - "lines blurring in turn"---<ComponentPreview name="focus-front-swap" />diff --git a/content/docs/typography/focus-pan-text.mdx b/content/docs/typography/focus-pan-text.mdxindex 13f12067..7e198240 100644--- a/content/docs/typography/focus-pan-text.mdx+++ b/content/docs/typography/focus-pan-text.mdx@@ -11,6 +11,13 @@ avoidWhen:- "You have only one sentence - use `focus-blur-resolve`."- "You want the lines to be typed - use `typewriter`."- "You want lines to replace each other in place - use `per-word-crossfade`."+askedAs:+ - "lines stacking blurred then clear"+ - "I want focus to move down a list of lines to the last sentence"+ - "step by step status ending on ready with a toolbar"+ - "checks passing story that finishes on a ready message"+ - "focus pan down text"+ - "earlier lines blurred final line sharp"---<ComponentPreview name="focus-pan-text" />diff --git a/content/docs/typography/fog-rise.mdx b/content/docs/typography/fog-rise.mdxindex c17a35c4..fd23d469 100644--- a/content/docs/typography/fog-rise.mdx+++ b/content/docs/typography/fog-rise.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The whole line should sharpen at once without per-character order — use `focus-blur-resolve`."- "Characters should travel up from below the baseline — use `per-character-rise` or `bottom-up-letters`."- "You need a soft, small-scale heading entrance — use `soft-blur-in`; fog-rise is tuned for large display sizes."+askedAs:+ - "text emerging from fog"+ - "I want a big word materializing out of mist"+ - "display title resolving from heavy blur with vertical streaks"+ - "atmospheric opening where text appears from haze"+ - "foggy reveal"+ - "misty title appear"---<ComponentPreview name="fog-rise" />diff --git a/content/docs/typography/font-cycle.mdx b/content/docs/typography/font-cycle.mdxindex 8475b1f5..cb0689c4 100644--- a/content/docs/typography/font-cycle.mdx+++ b/content/docs/typography/font-cycle.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want one family flexing in width and weight, not different faces — use `axis-flex`."- "You want a casing change rather than a typeface change — use `case-flip`."- "The word should simply land with no cycling — use `focus-blur-resolve`."+askedAs:+ - "word changing fonts"+ - "I want one word flipping through typefaces with labels"+ - "branding beat showing the same word in many fonts before the chosen one"+ - "type customization demo that settles on the final font"+ - "typeface slot machine"+ - "font showcase cycling"---<ComponentPreview name="font-cycle" />diff --git a/content/docs/typography/full-bleed-type.mdx b/content/docs/typography/full-bleed-type.mdxindex 7020d2f0..469aa984 100644--- a/content/docs/typography/full-bleed-type.mdx+++ b/content/docs/typography/full-bleed-type.mdx@@ -10,6 +10,13 @@ useWhen:avoidWhen:- "You want one word fitted edge to edge with a caption — use `edge-fit`."- "You want a softer stacked slogan with a highlighter — use `chunk-stack`."+askedAs:+ - "huge condensed caps slamming in"+ - "I want big slogan words hitting one at a time"+ - "hard hitting poster style beat with the last word lit by a sunrise"+ - "fast slogan with giant caps filling the screen"+ - "bold caps slam"+ - "sunrise gradient final word"---<ComponentPreview name="full-bleed-type" />diff --git a/content/docs/typography/glass-capsule.mdx b/content/docs/typography/glass-capsule.mdxindex 7e17bac5..30fee8e7 100644--- a/content/docs/typography/glass-capsule.mdx+++ b/content/docs/typography/glass-capsule.mdx@@ -11,6 +11,13 @@ avoidWhen:- "You want a flat highlight instead of glass - use `marker-highlight`."- "You want the whole line to change - use `blur-out-up`."- "You want a simple underline - use `inline-highlight`."+askedAs:+ - "glass lens over a word"+ - "I want a frosted capsule sliding over a key word and magnifying it"+ - "headline where one word is enlarged in italic as the point"+ - "premium title with a magnifier glass highlight"+ - "glass pill magnify"+ - "lens effect on keyword"---<ComponentPreview name="glass-capsule" />diff --git a/content/docs/typography/glyph-anatomy.mdx b/content/docs/typography/glyph-anatomy.mdxindex ab1a7110..c4610820 100644--- a/content/docs/typography/glyph-anatomy.mdx+++ b/content/docs/typography/glyph-anatomy.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The outline should simply draw itself without points or handles — use `outline-trace`."- "The design-tool feel should come from a selection box around the word instead of its construction — use `selection-snap`."- "The word only needs a quiet reveal — use `soft-blur-in`."+askedAs:+ - "letters built from bezier points"+ - "I want a word drawn like in a font editor with handles"+ - "design tool or type product showing craft with anchors and curves"+ - "behind the scenes of letter construction before the glyph fills"+ - "vector path anchors on text"+ - "font editor animation"---<ComponentPreview name="glyph-anatomy" />diff --git a/content/docs/typography/glyph-relay.mdx b/content/docs/typography/glyph-relay.mdxindex e1bd1da8..43aea58f 100644--- a/content/docs/typography/glyph-relay.mdx+++ b/content/docs/typography/glyph-relay.mdx@@ -10,6 +10,13 @@ useWhen:avoidWhen:- "You only need a simple question and answer swap — use `hook-uncurl`."- "You want a straight sequence of lines — use `slide-doors`."+askedAs:+ - "question mark twist line"+ - "I want a phrase handing off between lines ending on a giant question mark"+ - "setup and twist story like building a product then launching it"+ - "rhetorical question reveal that resolves into the answer"+ - "text handoff giant question mark"+ - "building vs launching twist"---<ComponentPreview name="glyph-relay" />diff --git a/content/docs/typography/gooey-morph.mdx b/content/docs/typography/gooey-morph.mdxindex 2468e2db..be661fa4 100644--- a/content/docs/typography/gooey-morph.mdx+++ b/content/docs/typography/gooey-morph.mdx@@ -13,6 +13,13 @@ avoidWhen:- "You need a plain text entrance without the shape build-up — use `soft-blur-in` or `mask-reveal-up`."- "The text is long or thin-stroked — the blur-threshold eats thin strokes and long words don't match the four-bar row."- "The style is crisp and geometric rather than liquid — use `kinetic-center-build`."+askedAs:+ - "liquid blobs forming text"+ - "I want bars landing like Tetris then melting into a word"+ - "title reveal that feels organic with shapes fusing into letters"+ - "metaball goo transition into a headline"+ - "gooey text reveal"+ - "tetris blocks become word"---<ComponentPreview name="gooey-morph" />diff --git a/content/docs/typography/got-em.mdx b/content/docs/typography/got-em.mdxindex 74d03112..9379780d 100644--- a/content/docs/typography/got-em.mdx+++ b/content/docs/typography/got-em.mdx@@ -10,6 +10,13 @@ useWhen:avoidWhen:- "You want a countdown build-up to the reveal — use `drop-timer`."- "You want a calm reveal with no explosion — use `blur-out-up`."+askedAs:+ - "meme style payoff"+ - "I want a suspense line exploding into a huge GOT EM"+ - "giveaway or entry reveal over a sunburst gradient"+ - "playful win moment with exploded letters"+ - "sunburst text explosion"+ - "gotcha reveal text"---<ComponentPreview name="got-em" />diff --git a/content/docs/typography/gradient-scale-cut-text.mdx b/content/docs/typography/gradient-scale-cut-text.mdxindex ba05861c..9c4fcfee 100644--- a/content/docs/typography/gradient-scale-cut-text.mdx+++ b/content/docs/typography/gradient-scale-cut-text.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The scale change must feel continuous — use `scale-down-fade` or `zoom-words`."- "The text should remain one size while a gradient passes over it — use `shimmer-sweep`."- "The background must remain transparent because the unrevealed ghost relies on a black field."+askedAs:+ - "big gradient title snapping smaller"+ - "I want an imposing oversized reveal that cuts to a compact line"+ - "abrupt editorial cut from huge to small text"+ - "gradient headline that jump cuts and settles in focus"+ - "scale cut headline"+ - "huge to tiny text snap"---<ComponentPreview name="gradient-scale-cut-text" />diff --git a/content/docs/typography/grid-cell.mdx b/content/docs/typography/grid-cell.mdxindex ba1c253d..07b6819e 100644--- a/content/docs/typography/grid-cell.mdx+++ b/content/docs/typography/grid-cell.mdx@@ -11,6 +11,13 @@ avoidWhen:- "You want a plain typed line with no grid - use `typewriter`."- "You want the headline to appear with blur - use `focus-blur-resolve`."- "You want the text selected and resized - use `cursor-frame`."+askedAs:+ - "graph paper highlighted cell"+ - "I want a headline typed into a lit grid square with a mono label"+ - "version or product name framed like a design tool cell"+ - "technical announcement on a blueprint grid"+ - "typed in a grid box"+ - "graph paper title"---<ComponentPreview name="grid-cell" />diff --git a/content/docs/typography/half-built.mdx b/content/docs/typography/half-built.mdxindex e76f5f1b..0009d141 100644--- a/content/docs/typography/half-built.mdx+++ b/content/docs/typography/half-built.mdx@@ -12,6 +12,13 @@ avoidWhen:- "Everything is shipped and you want a recap — use `week-shipped`."- "You want items listed as chips rather than inline words — use `feature-chips-flow`."- "You want text to appear complete word by word — use `word-insert`."+askedAs:+ - "outline text filling in"+ - "I want unfinished verbs shown as outlines that fill as they ship"+ - "roadmap beat showing what works now and what is coming"+ - "honest status scene with some capabilities still in progress"+ - "outline to solid text"+ - "work in progress roadmap"---<ComponentPreview name="half-built" />diff --git a/content/docs/typography/hand-count.mdx b/content/docs/typography/hand-count.mdxindex c70cc037..bde330b5 100644--- a/content/docs/typography/hand-count.mdx+++ b/content/docs/typography/hand-count.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The scene is a slick product UI or a dashboard metric — use `rolling-number` or `number-wheel`, which glide a mechanical typeface."- "You need per-digit odometer choreography — that is `number-wheel`'s job."- "You need locale grouping separators (`1,000`) or full currency formatting; `prefix` and `decimals` are the whole surface here."+askedAs:+ - "hand written counting number"+ - "I want a number rewritten by hand each step as it counts up"+ - "stat or price in a paper scrapbook scene"+ - "stop motion number counting"+ - "handmade counter"+ - "count up in pen"---<ComponentPreview name="hand-count" />diff --git a/content/docs/typography/handwrite.mdx b/content/docs/typography/handwrite.mdxindex 593be1b6..9283a8fd 100644--- a/content/docs/typography/handwrite.mdx+++ b/content/docs/typography/handwrite.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You are simulating a terminal or an input being typed into — use `typewriter`."- "The reveal should be smooth on the real 30fps clock — use `soft-blur-in` or `per-character-rise`."- "The whole sheet should wobble too: that is `paper-wobble` wrapped around this, not a prop here."+askedAs:+ - "handwritten text appearing"+ - "I want letters written by pen on paper in stop motion"+ - "captions and labels that look hand drawn on a scrapbook"+ - "headline that writes itself in a hand made scene"+ - "stop motion handwriting"+ - "pen written letters"---<ComponentPreview name="handwrite" />diff --git a/content/docs/typography/headline-to-line.mdx b/content/docs/typography/headline-to-line.mdxindex 7464b083..a71b9ca9 100644--- a/content/docs/typography/headline-to-line.mdx+++ b/content/docs/typography/headline-to-line.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The headline should only type, with no collapse — use `typewriter`."- "You want a headline that pulls focus to swap its last word — use `focus-front-swap`."- "The headline should be revealed over drifting lights — use `bokeh-title`."+askedAs:+ - "headline collapsing into a sentence"+ - "I want a big title to shrink into a line and keep typing a description"+ - "hero headline over a glowing horizon becoming a subtitle"+ - "introduction that goes from title to a longer explanation"+ - "title shrinks into one line"+ - "horizon glow headline"---<ComponentPreview name="headline-to-line" />diff --git a/content/docs/typography/hidden-word.mdx b/content/docs/typography/hidden-word.mdxindex b2db1ae0..f24f8800 100644--- a/content/docs/typography/hidden-word.mdx+++ b/content/docs/typography/hidden-word.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a word highlighted in place without moving letters — use `inline-highlight`."- "The text should simply appear and stay as a paragraph — use `word-stream`."- "You need a fast single-line headline entrance — use `focus-blur-resolve`."+askedAs:+ - "word found inside a sentence"+ - "I want a key word discovered letter by letter and pulled out as the title"+ - "editorial reveal where a hidden word becomes the headline"+ - "premium wordplay beat extracting a word in italic"+ - "find the word in the sentence"+ - "word lifted out of a phrase"---<ComponentPreview name="hidden-word" />diff --git a/content/docs/typography/hook-uncurl.mdx b/content/docs/typography/hook-uncurl.mdxindex 192bd774..4b712a56 100644--- a/content/docs/typography/hook-uncurl.mdx+++ b/content/docs/typography/hook-uncurl.mdx@@ -10,6 +10,13 @@ useWhen:avoidWhen:- "You want a bigger story with a punchline glyph — use `glyph-relay`."- "You want single words slamming in — use `full-bleed-type`."+askedAs:+ - "stacked caps question hook"+ - "I want condensed caps lines uncurling into place answering a question"+ - "short social opener ending on just make the video"+ - "vertical video hook with bold stacked lines"+ - "uncurling caps lines"+ - "tiktok hook text"---<ComponentPreview name="hook-uncurl" />diff --git a/content/docs/typography/hot-stage.mdx b/content/docs/typography/hot-stage.mdxindex f1839f27..cf0b6455 100644--- a/content/docs/typography/hot-stage.mdx+++ b/content/docs/typography/hot-stage.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You have one short line and want a calm caption instead of a staged log — use `cool-down`."- "The lines should stay on screen and step in like code — use `indent-steps`."- "You want a plain staggered paragraph with no log or vents — use `line-by-line-slide`."+askedAs:+ - "lines pushing each other away"+ - "I want each headline to fall away as the next one arrives with a mono log"+ - "closing beat walking through build render ship stages"+ - "developer tool launch with a faint mission log"+ - "stage by stage text"+ - "headline dropping out"---<ComponentPreview name="hot-stage" />diff --git a/content/docs/typography/idea-set.mdx b/content/docs/typography/idea-set.mdxindex 2b6b2b5e..c52e66c3 100644--- a/content/docs/typography/idea-set.mdx+++ b/content/docs/typography/idea-set.mdx@@ -11,6 +11,13 @@ avoidWhen:- "One line should change voice mid-line without rules or a ledger look — use `mono-voice`."- "You only need a clean masked reveal with no typeface change — use `mask-reveal-up`."- "The change should read as a visible edit of old text into new — use `diff-swap`."+askedAs:+ - "italic lines turning into type"+ - "I want two ruled lines that change typeface letter by letter"+ - "rough to finished beat where the second line is the payoff"+ - "typeset product story with one accent colored phrase"+ - "letters switching fonts"+ - "draft becomes polished text"---<ComponentPreview name="idea-set" />diff --git a/content/docs/typography/in-proportion.mdx b/content/docs/typography/in-proportion.mdxindex 6b8a9925..de6380d5 100644--- a/content/docs/typography/in-proportion.mdx+++ b/content/docs/typography/in-proportion.mdx@@ -11,6 +11,13 @@ avoidWhen:- "There is only one question and one answer — use `answer-first`."- "A single hesitation should be met with one short reply — use `no-buts`."- "The reply is a testimonial rather than a rebuttal — use `overheard`."+askedAs:+ - "worries answered by bigger reply"+ - "I want a small dim objection and a larger accent answer"+ - "objection handling where each concern shrinks and gets answered"+ - "FAQ style copy that feels reassuring"+ - "small worry big reply"+ - "doubt then confident answer"---<ComponentPreview name="in-proportion" />diff --git a/content/docs/typography/indent-steps.mdx b/content/docs/typography/indent-steps.mdxindex e4f0df5a..a0138425 100644--- a/content/docs/typography/indent-steps.mdx+++ b/content/docs/typography/indent-steps.mdx@@ -11,6 +11,13 @@ avoidWhen:- "The lines should be typed out character by character — use `typewriter`."- "Lines should read as commented-out code being switched on — use `uncomment-line`."- "You want a numbered feature list with a moving highlight row — use `index-list`."+askedAs:+ - "lines stepping to the right"+ - "I want lines tabbing further in like indented code"+ - "write render ship sequence reading like editor steps"+ - "developer tagline with the last word lit"+ - "staircase text"+ - "code style indent lines"---<ComponentPreview name="indent-steps" />diff --git a/content/docs/typography/index-list.mdx b/content/docs/typography/index-list.mdxindex f6760555..ad94650f 100644--- a/content/docs/typography/index-list.mdx+++ b/content/docs/typography/index-list.mdx@@ -11,6 +11,13 @@ avoidWhen:- "The lines should step in like indented code rather than a ruled index — use `indent-steps`."- "You have three big numbered steps instead of a long list — use `three-steps`."- "The features should appear as streaming pills around a logo — use `feature-chips-flow`."+askedAs:+ - "numbered feature list"+ - "I want a numbered index drawing in with one row highlighted"+ - "whats inside beat listing release features landing on the key one"+ - "table of contents style list with a moving highlight band"+ - "numbered rows highlight"+ - "feature index list"---<ComponentPreview name="index-list" />diff --git a/content/docs/typography/infinite-marquee.mdx b/content/docs/typography/infinite-marquee.mdxindex cda5572e..46e43d19 100644--- a/content/docs/typography/infinite-marquee.mdx+++ b/content/docs/typography/infinite-marquee.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The text should enter, hold, then exit — that is a reveal animation, not a ticker; use `blur-out-up` or `mask-reveal-up` instead."- "You need 3D perspective depth on the scrolling strip — use `perspective-marquee` for a tilted, depth-of-field version."- "The marquee should stop or snap to a specific word — this component loops forever with no hold state; compose a `Sequence` with a static slide instead."+askedAs:+ - "scrolling text ticker"+ - "I want a looping band of words moving sideways"+ - "decorative strip between sections with brand words"+ - "ambient background motion with repeating text"+ - "news ticker text loop"+ - "endless horizontal scroll"---<ComponentPreview name="infinite-marquee" />diff --git a/content/docs/typography/ink-underline.mdx b/content/docs/typography/ink-underline.mdxindex e63f940d..700132f1 100644--- a/content/docs/typography/ink-underline.mdx+++ b/content/docs/typography/ink-underline.mdx@@ -10,6 +10,13 @@ useWhen:avoidWhen:- "You are painting a highlight behind a word inside a sentence — use `marker-highlight`."- "You want to circle or strike through something: neither is this component."+askedAs:+ - "hand drawn underline stroke"+ - "I want an ink line drawn under a headline"+ - "underline for a URL or stat in a handmade scene"+ - "stop motion pen stroke beneath text"+ - "scribble underline"+ - "ink stroke under word"---<ComponentPreview name="ink-underline" />diff --git a/content/docs/typography/inline-highlight.mdx b/content/docs/typography/inline-highlight.mdxindex c0198cfa..dd22fa28 100644--- a/content/docs/typography/inline-highlight.mdx+++ b/content/docs/typography/inline-highlight.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a physical drawn marker or filled background behind the word — use `marker-highlight` for a visible paint-stroke effect instead."- "The entire sentence is new and needs to enter — this component is for emphasis within existing text, not a reveal; use `mask-reveal-up` or `per-word-crossfade` for full entrances."- "Multiple words across the sentence need to highlight in sequence — this highlights one span; compose multiple `Sequence`-wrapped instances or use `kinetic-center-build` for a word-by-word build."+askedAs:+ - "one word changing color"+ - "I want a keyword in a sentence to shift to the brand color"+ - "draw attention to a single word without a background shape"+ - "color emphasis within a line"+ - "highlight word color shift"+ - "keyword turns brand color"---<ComponentPreview name="inline-highlight" />diff --git a/content/docs/typography/inline-pill-takeover.mdx b/content/docs/typography/inline-pill-takeover.mdxindex 35efe6ea..751ac26a 100644--- a/content/docs/typography/inline-pill-takeover.mdx+++ b/content/docs/typography/inline-pill-takeover.mdx@@ -12,6 +12,13 @@ avoidWhen:- "Only one phrase should change color without affecting layout — use `inline-highlight`."- "The inserted copy should replace text rather than displace it — use `caret-swap`."- "The camera should track a long growing line instead of one CTA — use `zoom-words`."+askedAs:+ - "pill growing inside a sentence"+ - "I want a placeholder in the sentence to expand and take over the frame"+ - "turn an inline chip into a call to action without a title card"+ - "a pill that pushes words apart and fills the screen"+ - "expanding button in text"+ - "inline chip takeover"---<ComponentPreview name="inline-pill-takeover" />diff --git a/content/docs/typography/inline-word-roll.mdx b/content/docs/typography/inline-word-roll.mdxindex 41b6f019..bcd36955 100644--- a/content/docs/typography/inline-word-roll.mdx+++ b/content/docs/typography/inline-word-roll.mdx@@ -10,6 +10,13 @@ useWhen:avoidWhen:- "Every new word should remain in the sentence — use `word-push`."- "Entire phrases should transform letter by letter — use `kinetic-morph-text`."+askedAs:+ - "changing word after a fixed prefix"+ - "I want the end of a headline to roll through different words"+ - "headline cycling audiences benefits or outcomes"+ - "vertical roll word swap keeping the opening phrase"+ - "rotating word headline"+ - "built for designers developers"---<ComponentPreview name="inline-word-roll" />diff --git a/content/docs/typography/intelligence-glow.mdx b/content/docs/typography/intelligence-glow.mdxindex 09fb4a3e..15702a6d 100644--- a/content/docs/typography/intelligence-glow.mdx+++ b/content/docs/typography/intelligence-glow.mdx@@ -11,6 +11,13 @@ avoidWhen:- "You want the answer typed out with a visible cursor and no glow — use `typewriter`."- "The question and answer are plain type with no light effects — use `answer-first`."- "You only need a soft blurred word reveal — use `soft-blur-in`."+askedAs:+ - "AI prompt and answer"+ - "I want a question under a breathing glow then a serif answer"+ - "AI feature beat showing a generated result"+ - "glowing edge light then answer resolves like Apple Intelligence"+ - "ai glow text"+ - "prompt response reveal"---<ComponentPreview name="intelligence-glow" />diff --git a/content/docs/typography/italic-speed.mdx b/content/docs/typography/italic-speed.mdxindex 7bd3d789..4d273639 100644--- a/content/docs/typography/italic-speed.mdx+++ b/content/docs/typography/italic-speed.mdx@@ -11,6 +11,13 @@ avoidWhen:- "The word is long or lowercase and needs a calm entrance - use `soft-blur-in`."- "You want a heavy slam instead of a ride-in - use `lights-out`."- "You want a smooth stretch of the text - use `stretch-in`."+askedAs:+ - "slanted fast text"+ - "I want a caps word riding in on speed lines"+ - "speed claim like Faster that feels like it is moving"+ - "punchy title with a serif italic subtitle under an underline"+ - "speed strips headline"+ - "fast moving italic title"---<ComponentPreview name="italic-speed" />diff --git a/content/docs/typography/keep-words.mdx b/content/docs/typography/keep-words.mdxindex 322a448d..3711ae34 100644--- a/content/docs/typography/keep-words.mdx+++ b/content/docs/typography/keep-words.mdx@@ -11,6 +11,13 @@ avoidWhen:- "You want every belief visible together as a full manifesto page — use `whole-page`."- "There is one statement or quote, not a series — use `changed-mind`."- "You want one big word with a full stop and a single supporting line — use `plain-license`."+askedAs:+ - "manifesto beliefs boiling down"+ - "I want belief statements where one word turns red and drops to a list"+ - "closing values moment with a column of mottos"+ - "principles beat with serif text building word by word"+ - "red keyword drops into column"+ - "values statement"---<ComponentPreview name="keep-words" />diff --git a/content/docs/typography/kerning-snap.mdx b/content/docs/typography/kerning-snap.mdxindex 64f2f3f8..5b14084e 100644--- a/content/docs/typography/kerning-snap.mdx+++ b/content/docs/typography/kerning-snap.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want letters to ease in with a spacing change rather than snapping — use `tracking-in`."- "The whole word should drop in at once, not assemble — use `squeeze-in`."- "You want the word to stretch or squash on entry — use `stretch-in`."+askedAs:+ - "letters snapping into spacing"+ - "I want loose letters locking into proper kerning"+ - "design craft beat about typesetting and polish"+ - "premium word assembling precisely in gradient serif"+ - "letter spacing animation"+ - "kerning tightening reveal"---<ComponentPreview name="kerning-snap" />diff --git a/content/docs/typography/kill-feed.mdx b/content/docs/typography/kill-feed.mdxindex ee79a441..eb13f991 100644--- a/content/docs/typography/kill-feed.mdx+++ b/content/docs/typography/kill-feed.mdx@@ -10,6 +10,13 @@ useWhen:avoidWhen:- "You want a single boss defeated by named hits — use `boss-bar`."- "You want a plain list of items — use `index-list`."+askedAs:+ - "game kill feed text"+ - "I want eliminations listed building to a big banner"+ - "playful recap where each shipped win is a kill"+ - "feature roundup ending in a multikill style PENTA banner"+ - "gaming eliminated feed"+ - "esports banner recap"---<ComponentPreview name="kill-feed" />diff --git a/content/docs/typography/kinetic-center-build.mdx b/content/docs/typography/kinetic-center-build.mdxindex 74e35961..758909aa 100644--- a/content/docs/typography/kinetic-center-build.mdx+++ b/content/docs/typography/kinetic-center-build.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The text is long (7+ words) — the centering re-balance on each word becomes distracting; use `line-by-line-slide` for multi-word or multi-line phrases."- "The entrance should feel calm and neutral rather than kinetic — use `micro-scale-fade` or `mask-reveal-up` for composed, quiet reveals."- "Words should fade in sequentially with a vertical drift rather than push from the right — use `per-word-crossfade` for that calm keynote rhythm."+askedAs:+ - "words pushing a line to center"+ - "I want words to enter from the right and shove the phrase into place"+ - "short headline built word by word with momentum"+ - "reveal that locks centered at the end"+ - "word by word build"+ - "sliding words lock in the middle"---<ComponentPreview name="kinetic-center-build" />diff --git a/content/docs/typography/kinetic-morph-text.mdx b/content/docs/typography/kinetic-morph-text.mdxindex bf2ce608..647e2aa0 100644--- a/content/docs/typography/kinetic-morph-text.mdx+++ b/content/docs/typography/kinetic-morph-text.mdx@@ -12,6 +12,13 @@ avoidWhen:- "Words should switch with minimal movement — use `per-word-crossfade`."- "The text should stay readable throughout a subtle entrance — use `per-character-rise`."- "A single word should deform as one continuous surface — use `kinetic-warp`."+askedAs:+ - "letters rearranging into next phrase"+ - "I want letters to lift and reshape into new words with outline trails"+ - "sequence of phrases that feels like the same letters moving"+ - "playful title where each letter has its own motion"+ - "text morph letters"+ - "rearranging letter animation"---<ComponentPreview name="kinetic-morph-text" />diff --git a/content/docs/typography/kinetic-warp.mdx b/content/docs/typography/kinetic-warp.mdxindex b4ccece7..39e0af82 100644--- a/content/docs/typography/kinetic-warp.mdx+++ b/content/docs/typography/kinetic-warp.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You need a text entrance — the word is fully visible from frame 0 and only distorts; use `tracking-in` or `soft-blur-in` for reveals."- "The text is long or small — the mesh bends quarters of the frame, so a paragraph turns to mush; use `per-character-rise` for body-size text motion."- "The vibe is corrupted or digital rather than elastic — use `rgb-glitch-text` for a glitch read."+askedAs:+ - "word bending and snapping"+ - "I want a heavy display word to warp in staccato beats"+ - "bold kinetic typography moment where the whole word bends"+ - "mesh distortion text"+ - "warped text pulses"+ - "stretchy word deform"---<ComponentPreview name="kinetic-warp" />diff --git a/content/docs/typography/known-terms.mdx b/content/docs/typography/known-terms.mdxindex bc782715..65c852ff 100644--- a/content/docs/typography/known-terms.mdx+++ b/content/docs/typography/known-terms.mdx@@ -11,6 +11,13 @@ avoidWhen:- "You need a dictionary-style definition of a single term — use `verbed`."- "Each line is a worry answered by a bigger reply, not an equivalence — use `in-proportion`."- "You only want a plain list of lines stepping in — use `indent-steps`."+askedAs:+ - "term equals definition pairs"+ - "I want familiar concepts mapped to my product"+ - "three to five equivalents like a scene is a component"+ - "pairs pushing each other into place ending in accent"+ - "glossary style lines"+ - "a is b mapping text"---<ComponentPreview name="known-terms" />diff --git a/content/docs/typography/ko-count.mdx b/content/docs/typography/ko-count.mdxindex aabb4ee4..b94f7ffa 100644--- a/content/docs/typography/ko-count.mdx+++ b/content/docs/typography/ko-count.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a smooth numeric count-up of a metric, not a dramatic count — use `number-wheel`."- "The countdown leads to a live date or URL rather than a verdict word — use `drop-timer`."- "The tone is calm and understated, not an impact slam — use `cool-down`."+askedAs:+ - "ten count to a big word"+ - "I want a quick count to ten then a verdict word slam"+ - "launch suspense with hard cut numbers before a gradient title"+ - "knockout count punchy opener"+ - "boxing ten count"+ - "numbers cut then word slam"---<ComponentPreview name="ko-count" />diff --git a/content/docs/typography/landing-confirmed.mdx b/content/docs/typography/landing-confirmed.mdxindex 619e2cc8..e95133aa 100644--- a/content/docs/typography/landing-confirmed.mdx+++ b/content/docs/typography/landing-confirmed.mdx@@ -11,6 +11,13 @@ avoidWhen:- "You want a countdown that ends on a live URL rather than a landing — use `drop-timer`."- "You only need one bold word with no telemetry or countdown — use `full-bleed-type`."- "The tone is a fighting-game knockout rather than a mission landing — use `ko-count`."+askedAs:+ - "altitude countdown landing"+ - "I want a descent readout stopping hard then a confirmation"+ - "ship day beat treated like a spacecraft landing"+ - "closing card with impact then a gradient title"+ - "touchdown confirmed"+ - "landing countdown text"---<ComponentPreview name="landing-confirmed" />diff --git a/content/docs/typography/layout-swap.mdx b/content/docs/typography/layout-swap.mdxindex 6da7c6f2..5ccd1287 100644--- a/content/docs/typography/layout-swap.mdx+++ b/content/docs/typography/layout-swap.mdx@@ -12,6 +12,13 @@ avoidWhen:- "Only one word changes inside a fixed sentence — use `pinned-word`."- "The words flip order and meaning — use `turnabout`."- "You want each swap triggered by an object crossing — use `pass-swap`."+askedAs:+ - "headline growing line by line"+ - "I want each version of a sentence to grow out of the last"+ - "feature headline building from one noun to a full promise"+ - "launch hook where each rewrite adds a word"+ - "text shifting layout"+ - "expanding headline versions"---<ComponentPreview name="layout-swap" />diff --git a/content/docs/typography/layover.mdx b/content/docs/typography/layover.mdxindex 6c64db71..37cae069 100644--- a/content/docs/typography/layover.mdx+++ b/content/docs/typography/layover.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a time phrase counting down to today — use `on-approach`, which is the close twin."- "The cycling slot should keep a fixed width — use `width-lock`."- "Words should pull into view from spaced-out places — use `pull-in`."+askedAs:+ - "word stepping through stops"+ - "I want a key word cycling through short stops before the final word"+ - "journey beat arriving at the destination word"+ - "tagline morphing through shorthand forms"+ - "word changes then lands"+ - "travel stops text"---<ComponentPreview name="layover" />diff --git a/content/docs/typography/less-more.mdx b/content/docs/typography/less-more.mdxindex 3d640d19..be0983bd 100644--- a/content/docs/typography/less-more.mdx+++ b/content/docs/typography/less-more.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You have a longer list of points to step through — use `what-sticks`."- "The contrast should show as an edit — use `diff-swap`."- "A word should flip rather than a full line — use `pinned-word`."+askedAs:+ - "dim line versus bright line"+ - "I want a faded line contrasted with a bright accent below"+ - "manifesto beat setting old effort against new payoff"+ - "two line contrast for pricing or positioning"+ - "less effort more result"+ - "faded then bright text"---<ComponentPreview name="less-more" />diff --git a/content/docs/typography/letter-relay.mdx b/content/docs/typography/letter-relay.mdxindex 6470bcbb..9d79d57f 100644--- a/content/docs/typography/letter-relay.mdx+++ b/content/docs/typography/letter-relay.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The name should type in like a command or prompt - use `typewriter`."- "You need a calm, quick reveal rather than a bouncing relay - use `per-character-rise`."- "The text is a full phrase, not a single short word - use `word-push` to build it word by word."+askedAs:+ - "letters hopping one by one"+ - "I want a wordmark where each letter jumps after the last"+ - "playful brand name reveal at the start of a launch video"+ - "product name letters bouncing then tightening"+ - "bouncing letters intro"+ - "hop letters wordmark"---<ComponentPreview name="letter-relay" />diff --git a/content/docs/typography/lights-out.mdx b/content/docs/typography/lights-out.mdxindex 533ca87c..79b005a9 100644--- a/content/docs/typography/lights-out.mdx+++ b/content/docs/typography/lights-out.mdx@@ -11,6 +11,13 @@ avoidWhen:- "You want a calm reveal - use `soft-blur-in`."- "You want a speedy ride-in with a subtitle - use `italic-speed`."- "The title is a long sentence - use `line-by-line-slide`."+askedAs:+ - "five lights going out"+ - "I want race start lights then a heavy italic headline"+ - "launch countdown where lights go out and the name hits"+ - "high energy title for racing or gaming"+ - "formula one start lights"+ - "lights out slam title"---<ComponentPreview name="lights-out" />diff --git a/content/docs/typography/line-by-line-slide.mdx b/content/docs/typography/line-by-line-slide.mdxindex 9a2a5d65..40924283 100644--- a/content/docs/typography/line-by-line-slide.mdx+++ b/content/docs/typography/line-by-line-slide.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The text is a single short phrase — the stagger has nothing to stage; use `mask-reveal-up` or `per-character-rise` for single-line reveals instead."- "The reveal should move upward rather than slide horizontally — use `mask-reveal-up` (upward, masked) or `blur-out-up` (upward, blurred exit)."- "The lines should not exit — this component slides lines out to the right; for a hold-in-place reveal, use `mask-reveal-up`."+askedAs:+ - "lines sliding in and out"+ - "I want each line to slide in from the left and exit right"+ - "multi-line headline with flowing staggered entrance and matching exit"+ - "directional paragraph slide"+ - "staggered line slide"+ - "slide left then out right"---<ComponentPreview name="line-by-line-slide" />diff --git a/content/docs/typography/line-relief.mdx b/content/docs/typography/line-relief.mdxindex a578edf4..aad5665e 100644--- a/content/docs/typography/line-relief.mdx+++ b/content/docs/typography/line-relief.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The word must be readable from the first frame — use `full-bleed-type`."- "You want each glyph contour drawn as a stroke, letter by letter — use `outline-trace`."- "The text is a phrase or sentence, not one short word — use `staggered-fade-up`."+askedAs:+ - "topographic lines word"+ - "I want a huge word ruled in horizontal lines that bulge"+ - "radar style relief title that resolves to solid"+ - "premium hero title card made of contour lines"+ - "scan line relief text"+ - "striped bulging word"---<ComponentPreview name="line-relief" />diff --git a/content/docs/typography/liquid-word.mdx b/content/docs/typography/liquid-word.mdxindex 65cbc186..a05f156f 100644--- a/content/docs/typography/liquid-word.mdx+++ b/content/docs/typography/liquid-word.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The swap should read as an edit, like a correction - use `strikethrough-replace`."- "You need a quick, tidy word change beside a fixed prefix - use `inline-word-roll`."- "The scene must stay calm and corporate - use `fade-through` for a clean replacement."+askedAs:+ - "word melting into a pool"+ - "I want one word to melt and a new word rise from the puddle"+ - "before and after where draft turns into shipped"+ - "playful transformation with a glowing gradient liquid"+ - "melting text"+ - "liquid transition between words"---<ComponentPreview name="liquid-word" />diff --git a/content/docs/typography/long-vowel.mdx b/content/docs/typography/long-vowel.mdxindex 182f5ab3..b33fd23a 100644--- a/content/docs/typography/long-vowel.mdx+++ b/content/docs/typography/long-vowel.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want letters to fly in and smear sideways - use `stretch-in`."- "The effect should be width and weight flexing on a whole word - use `axis-flex`."- "The line is serious or data-heavy and needs no comic stretch - use `tracking-in`."+askedAs:+ - "stretched vowel word"+ - "I want a word with one drawn out letter for comic effect"+ - "tagline with emphasis and a short punchline"+ - "casual human serif word in warm gradient with italic caption"+ - "drawl text"+ - "elongated letter"---<ComponentPreview name="long-vowel" />diff --git a/content/docs/typography/loop-break.mdx b/content/docs/typography/loop-break.mdxindex b4458739..26b022cd 100644--- a/content/docs/typography/loop-break.mdx+++ b/content/docs/typography/loop-break.mdx@@ -11,6 +11,13 @@ avoidWhen:- "You want the old line struck through and replaced in place — use `strikethrough-replace`."- "The change is a single edit that should be shown as a diff — use `diff-swap`."- "There is no repetition, just a short statement and a reply — use `answer-first`."+askedAs:+ - "repeating lines speeding up"+ - "I want a loop of lines faster each time until something breaks it"+ - "tedious repeated workflow versus one step fix"+ - "joke about doing the same chore again and again"+ - "groundhog day text"+ - "broken loop"---<ComponentPreview name="loop-break" />diff --git a/content/docs/typography/macro-letter-pan.mdx b/content/docs/typography/macro-letter-pan.mdxindex 039d3ca1..9d5561fd 100644--- a/content/docs/typography/macro-letter-pan.mdx+++ b/content/docs/typography/macro-letter-pan.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want the pan to end on a serif headline with a gradient fill - use `macro-pan`."- "The line should stay fully readable throughout - use `focus-pan-text` to keep earlier lines visible."- "A quick fade-in is enough for the line - use `soft-blur-in`."+askedAs:+ - "camera hopping across letters"+ - "I want a macro lens jumping letter to letter then pulling back"+ - "closing line where one word is the payoff before revealing the sentence"+ - "premium close up on a key word"+ - "macro camera on text"+ - "zoom out to full phrase"---<ComponentPreview name="macro-letter-pan" />diff --git a/content/docs/typography/macro-pan.mdx b/content/docs/typography/macro-pan.mdxindex e2417dd3..d392cef0 100644--- a/content/docs/typography/macro-pan.mdx+++ b/content/docs/typography/macro-pan.mdx@@ -11,6 +11,13 @@ avoidWhen:- "You want a quick, clean entrance - use `staggered-fade-up`."- "You want a blur reveal with no camera move - use `focus-blur-resolve`."- "You want the lens effect on a single word - use `glass-capsule`."+askedAs:+ - "close up pan over headline"+ - "I want a macro lens scanning across serif glyphs"+ - "title that pulls back to a full lockup"+ - "chapter opener with a running label"+ - "camera scan across letterforms"+ - "macro text reveal"---<ComponentPreview name="macro-pan" />diff --git a/content/docs/typography/magnet-letters.mdx b/content/docs/typography/magnet-letters.mdxindex 777280af..62147bcc 100644--- a/content/docs/typography/magnet-letters.mdx+++ b/content/docs/typography/magnet-letters.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The swap should be quick and quiet - use `strikethrough-replace`."- "You need several alternates cycling beside a prefix - use `inline-word-roll`."- "The change is a value or number, not a word - use `slot-machine-roll`."+askedAs:+ - "magnet pulling a word"+ - "I want a wrong word pulled in then pushed away for the right one"+ - "correction gag swapping a word physically"+ - "launch video word replacement with a magnet"+ - "fridge magnet text"+ - "magnetic word swap"---<ComponentPreview name="magnet-letters" />diff --git a/content/docs/typography/marker-highlight.mdx b/content/docs/typography/marker-highlight.mdxindex da0fe8c6..3d376df8 100644--- a/content/docs/typography/marker-highlight.mdx+++ b/content/docs/typography/marker-highlight.mdx@@ -13,6 +13,13 @@ avoidWhen:- "The entire sentence is new text that needs to enter the scene — both highlight components are emphasis tools, not entrances; use `mask-reveal-up` or `per-word-crossfade` for full reveals."- "The scene tone is minimal or premium and a bold painted marker would clash — use `inline-highlight` for a quieter callout."- "The emphasis should land the moment a speaker says the word — use `caption-marker`, which swipes keywords from a timed transcript."+askedAs:+ - "highlighter pen behind text"+ - "I want a marker stroke drawn behind a phrase"+ - "hand drawn highlight on a key phrase"+ - "playful emphasis that underscores a word"+ - "yellow marker highlight"+ - "highlighted phrase"---<ComponentPreview name="marker-highlight" />diff --git a/content/docs/typography/mask-reveal-up.mdx b/content/docs/typography/mask-reveal-up.mdxindex d7df97ab..45859762 100644--- a/content/docs/typography/mask-reveal-up.mdx+++ b/content/docs/typography/mask-reveal-up.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You need an exit animation too — `mask-reveal-up` holds in place after reveal; use `line-by-line-slide` for a reveal that also exits to the right."- "The reveal should be character-level rather than line-level — use `per-character-rise` (clean, sharp) or `bottom-up-letters` (staircase, dramatic) for letter-by-letter entrances."- "Blur or atmospheric softness should accompany the upward motion — use `blur-out-up` (blurred exit) or `focus-blur-resolve` (blurred entrance) instead."+askedAs:+ - "lines rising from a mask"+ - "I want multi line text revealed upward cleanly"+ - "stacked list entrance that holds on screen"+ - "compact stagger soft mask"+ - "reveal text upward"+ - "text rises from below mask"---<ComponentPreview name="mask-reveal-up" />diff --git a/content/docs/typography/matrix-decode.mdx b/content/docs/typography/matrix-decode.mdxindex 706edc01..95594829 100644--- a/content/docs/typography/matrix-decode.mdx+++ b/content/docs/typography/matrix-decode.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The content is a human sentence or marketing copy — the glitchy scramble reads as broken text to non-technical audiences; use `typewriter` for a clean character-by-character reveal with a more legible progression."- "The tone is premium or editorial — use `focus-blur-resolve` or `blur-out-up` for atmospheric reveals without the glitch aesthetic."- "The text is long — the left-to-right lock is designed for short labels and codes; long strings extend `revealDuration` to an uncomfortable length."+askedAs:+ - "scrambled text resolving"+ - "I want random characters settling into the message"+ - "hacker terminal cyberpunk aesthetic reveal"+ - "short code word decoding left to right"+ - "hacker text decode"+ - "matrix scramble"---<ComponentPreview name="matrix-decode" />diff --git a/content/docs/typography/micro-scale-fade.mdx b/content/docs/typography/micro-scale-fade.mdxindex c1680ef0..a5dd3ba9 100644--- a/content/docs/typography/micro-scale-fade.mdx+++ b/content/docs/typography/micro-scale-fade.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The reveal should be the hero moment with visible kinetic weight — use `kinetic-center-build` or `per-character-rise` for entrances that command attention."- "Text should enter per-character or per-word rather than as a unified block — use `bottom-up-letters`, `per-character-rise`, or `per-word-crossfade` for staged reveals."- "The text needs to also exit — `micro-scale-fade` is entrance-only; use `blur-out-up` or `fade-through` when an exit arc is required."+askedAs:+ - "subtle text entrance"+ - "I want a tiny calm pop for labels"+ - "polished entrance that does not draw attention"+ - "supporting text appear softly"+ - "small scale fade"+ - "quiet premium label in"---<ComponentPreview name="micro-scale-fade" />diff --git a/content/docs/typography/mono-settle.mdx b/content/docs/typography/mono-settle.mdxindex b4f7b2a4..e054a518 100644--- a/content/docs/typography/mono-settle.mdx+++ b/content/docs/typography/mono-settle.mdx@@ -11,6 +11,13 @@ avoidWhen:- "You want a plain two-line entrance - use `line-by-line-slide`."- "You want text typed out - use `typewriter`."- "You want three lines that shift voice mid-line - use `mono-voice`."+askedAs:+ - "monospace to proportional"+ - "I want code style text to become a normal font"+ - "developer message from code to finished result"+ - "two lines changing typeface with accent words"+ - "mono to sans text"+ - "code font transform"---<ComponentPreview name="mono-settle" />diff --git a/content/docs/typography/mono-voice.mdx b/content/docs/typography/mono-voice.mdxindex 0a5ce0ac..0ffd6daf 100644--- a/content/docs/typography/mono-voice.mdx+++ b/content/docs/typography/mono-voice.mdx@@ -11,6 +11,13 @@ avoidWhen:- "You only have two lines and want a quieter morph - use `mono-settle`."- "You want plain stacked lines - use `line-by-line-slide`."- "You want text typed out - use `typewriter`."+askedAs:+ - "stacked lines shifting font"+ - "I want lines to change from mono to proportional ending on a big word"+ - "script to delivery message with expressive final word"+ - "three line statement that changes tone"+ - "voice change typography"+ - "typeface shift mid line"---<ComponentPreview name="mono-voice" />diff --git a/content/docs/typography/moves-up.mdx b/content/docs/typography/moves-up.mdxindex fbbdc673..5c53cc5d 100644--- a/content/docs/typography/moves-up.mdx+++ b/content/docs/typography/moves-up.mdx@@ -11,6 +11,13 @@ avoidWhen:- "Items are unfinished verbs that fill in and carry dates — use `half-built`."- "You want a column of claims that dim until one is highlighted — use `what-sticks`."- "A scrolling list of changes with one enlarged entry is enough — use `changelog-scroll`."+askedAs:+ - "roadmap now next later"+ - "I want finished items to exit and the rest move up"+ - "changelog progress where shipped items leave the list"+ - "list shifting up as items complete"+ - "roadmap list advance"+ - "now next later columns"---<ComponentPreview name="moves-up" />diff --git a/content/docs/typography/name-gloss.mdx b/content/docs/typography/name-gloss.mdxindex 36f31bc9..7acc92b8 100644--- a/content/docs/typography/name-gloss.mdx+++ b/content/docs/typography/name-gloss.mdx@@ -11,6 +11,13 @@ avoidWhen:- "You are mapping familiar concepts to yours, not glossing words — use `known-terms`."- "You want a dictionary entry with senses and an example for one word — use `verbed`."- "You have three feature words with progress ticks and notes — use `feature-trio`."+askedAs:+ - "name broken into meanings"+ - "I want a two part name split into columns each with a definition"+ - "naming beat unpacking a product name word by word"+ - "short definition moment with a closing line"+ - "name explained"+ - "word meaning columns"---<ComponentPreview name="name-gloss" />diff --git a/content/docs/typography/ndot-resolve.mdx b/content/docs/typography/ndot-resolve.mdxindex 912c4622..0d5f2ef0 100644--- a/content/docs/typography/ndot-resolve.mdx+++ b/content/docs/typography/ndot-resolve.mdx@@ -11,6 +11,13 @@ avoidWhen:- "You want a decode effect with scrambled characters - use `matrix-decode`."- "You want a glitch treatment - use `rgb-glitch-text`."- "You want a calm blur resolve - use `focus-blur-resolve`."+askedAs:+ - "dot matrix to solid text"+ - "I want a headline in LED dot style refreshing to final type"+ - "tech or hardware title like a display updating"+ - "Nothing phone style dot font"+ - "dot display text"+ - "led board reveal"---<ComponentPreview name="ndot-resolve" />diff --git a/content/docs/typography/negation-drop.mdx b/content/docs/typography/negation-drop.mdxindex 686efffd..54b2a33c 100644--- a/content/docs/typography/negation-drop.mdx+++ b/content/docs/typography/negation-drop.mdx@@ -11,6 +11,13 @@ avoidWhen:- "The lines have no contractions to flip and should just stack in — use `hook-uncurl`."- "You have one denial with a sheepish reply tucked in the corner — use `coy-denial`."- "One claim should dim while another brightens rather than a word dropping out — use `less-more`."+askedAs:+ - "myth busting caps lines"+ - "I want negations to fall away leaving the positive word on lime"+ - "flip you cant into you can"+ - "punchy poster opener turning objections around"+ - "dont drop word"+ - "lime block word"---<ComponentPreview name="negation-drop" />diff --git a/content/docs/typography/no-buts.mdx b/content/docs/typography/no-buts.mdxindex 739fb028..a66934c1 100644--- a/content/docs/typography/no-buts.mdx+++ b/content/docs/typography/no-buts.mdx@@ -11,6 +11,13 @@ avoidWhen:- "The objection should shrink into a note and stay visible while the answer builds — use `in-proportion`."- "There is a single question and a single answer — use `answer-first`."- "The reply is a quoted line from a person rather than your voice — use `overheard`."+askedAs:+ - "objection and reply repeating"+ - "I want a muted worry in the corner and a larger reply"+ - "each hesitation gets a confident answer"+ - "friendly closing exchange ending in accent"+ - "muted objection bigger answer"+ - "reply to doubts"---<ComponentPreview name="no-buts" />diff --git a/content/docs/typography/nonstop.mdx b/content/docs/typography/nonstop.mdxindex 782952da..680d1215 100644--- a/content/docs/typography/nonstop.mdx+++ b/content/docs/typography/nonstop.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You need a time phrase leading to today — use `on-approach`."- "You want a general number animation — use `number-wheel`."- "You want a numbered rolling stat without a payoff phrase — use `rolling-number`."+askedAs:+ - "countdown to zero stops"+ - "I want a counter rolling down to zero and a no stops phrase"+ - "shorter path with fewer steps between idea and export"+ - "countdown joke where less steps wins"+ - "count down to nothing"+ - "zero steps counter"---<ComponentPreview name="nonstop" />diff --git a/content/docs/typography/not-yet.mdx b/content/docs/typography/not-yet.mdxindex 792abfbb..56c1e970 100644--- a/content/docs/typography/not-yet.mdx+++ b/content/docs/typography/not-yet.mdx@@ -11,6 +11,13 @@ avoidWhen:- "Only one line should flip from a negation to a positive — use `negation-drop`."- "Items need Summer or Later style tags and fill-in animation — use `half-built`."- "You want a now, next and later queue where items ship — use `moves-up`."+askedAs:+ - "limits ending with yet"+ - "I want lines of what it cannot do each ending in Yet"+ - "honest roadmap admitting current limits with hope"+ - "coming soon moment stacking upward"+ - "cant do yet"+ - "hopeful limitations list"---<ComponentPreview name="not-yet" />diff --git a/content/docs/typography/number-wheel.mdx b/content/docs/typography/number-wheel.mdxindex 5a38ef98..0a13c3c0 100644--- a/content/docs/typography/number-wheel.mdx+++ b/content/docs/typography/number-wheel.mdx@@ -13,6 +13,13 @@ avoidWhen:- "The number should appear all at once without rolling — use `micro-scale-fade` for a static entrance of a pre-formatted number string."- "The scene requires text alongside the number to animate together — compose `NumberWheel` with a static text node in a flex container rather than embedding units in the `to` value."- "The value carries a prefix or suffix like `$99` or `1.2M` — use `slot-machine-roll` (accepts arbitrary strings); for very large multi-digit metrics counting up, `rolling-number` is purpose-tuned."+askedAs:+ - "odometer number"+ - "I want a number rolling from one value to another"+ - "metric or stat animating to its final value"+ - "data scene with a satisfying rolling counter"+ - "rolling digits"+ - "odometer roll stat"---<ComponentPreview name="number-wheel" />diff --git a/content/docs/typography/on-approach.mdx b/content/docs/typography/on-approach.mdxindex cc469e0f..8545f3c6 100644--- a/content/docs/typography/on-approach.mdx+++ b/content/docs/typography/on-approach.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The cycling word should stop at several named stops — use `layover`, which plays almost the same."- "Place words should pull in with a slower hold — use `pull-in`."- "You want a counter that ticks to zero — use `nonstop`."+askedAs:+ - "launch date counting nearer"+ - "I want a fixed phrase with the time word changing to today"+ - "countdown beat like in June next week tomorrow today"+ - "a scene where the timeframe shrinks to now"+ - "coming today swap"+ - "time word swaps down to today"---<ComponentPreview name="on-approach" />diff --git a/content/docs/typography/out-of-context.mdx b/content/docs/typography/out-of-context.mdxindex 044f3f5b..3f00c3d2 100644--- a/content/docs/typography/out-of-context.mdx+++ b/content/docs/typography/out-of-context.mdx@@ -11,6 +11,13 @@ avoidWhen:- "The text is a single short word - use `spring-scale-in`."- "You want a calm blur entrance - use `soft-blur-in`."- "You want text to replace in place - use `strikethrough-replace`."+askedAs:+ - "slogan stacking line by line"+ - "punchline last phrase in accent color"+ - "I want a bold claim where the final words flip the meaning"+ - "stack a statement then highlight the twist at the end in color"+ - "opening hook that sets up a belief and then flips it on the viewer"+ - "a tagline moment where the last phrase lands in brand color as the payoff"---<ComponentPreview name="out-of-context" />diff --git a/content/docs/typography/outline-fill-track-text.mdx b/content/docs/typography/outline-fill-track-text.mdxindex 1a2a1c95..7240781f 100644--- a/content/docs/typography/outline-fill-track-text.mdx+++ b/content/docs/typography/outline-fill-track-text.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The two texts should swap in place — use `value-swap` for a compact replacement."- "The value needs to count numerically — use `rolling-number` or `number-wheel`."- "The background must remain transparent because the entrance field is part of this effect."+askedAs:+ - "hollow number fills with color"+ - "lead word then big outlined stat"+ - "I want a sentence that hands off to a huge outlined number sliding left"+ - "show a headline word leading into a large figure that fills in as it moves"+ - "stat reveal where the number starts as an outline and gets solid color"+ - "a metric moment in the video, the eye goes from a short word to one big value"---<ComponentPreview name="outline-fill-track-text" />diff --git a/content/docs/typography/outline-trace.mdx b/content/docs/typography/outline-trace.mdxindex 6bb0016d..99479055 100644--- a/content/docs/typography/outline-trace.mdx+++ b/content/docs/typography/outline-trace.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The text should look handwritten, stroke by stroke in a script face — use `handwrite`."- "The letters should fly in and deform rather than be drawn — use `stretch-in`."- "The build should show the construction points and handles of a font editor — use `glyph-anatomy`."+askedAs:+ - "letters drawn with a pen stroke"+ - "stroke draw then fill text"+ - "I want the title outlines to draw themselves, then fill in with color"+ - "handwritten feel where each letter contour traces before it becomes solid"+ - "a logo-like title that gets drawn on screen, line art turning into solid type"+ - "an opening title that feels crafted, as if someone is tracing every letter"---<ComponentPreview name="outline-trace" />diff --git a/content/docs/typography/oval-type.mdx b/content/docs/typography/oval-type.mdxindex 3b3dcbb5..4cfb12cf 100644--- a/content/docs/typography/oval-type.mdx+++ b/content/docs/typography/oval-type.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You only have one word to slam — use `full-bleed-type`."- "The words should cut in at a hard, fast rhythm rather than ride a conveyor — use `strobe-words`."- "The text is a full sentence that needs to read as a line — use `staggered-fade-up`."+askedAs:+ - "words on pill shaped capsules"+ - "gradient capsules text poster"+ - "playful feature list on stretchy pills ending in a three word tagline"+ - "I want words riding colorful rounded blobs that grow into a big poster"+ - "a fun beat cycling through verbs before settling on a short slogan"+ - "a lively mid-video moment where bubbly shapes carry the words then enlarge"---<ComponentPreview name="oval-type" />diff --git a/content/docs/typography/overheard.mdx b/content/docs/typography/overheard.mdxindex a64777fb..d5a8922b 100644--- a/content/docs/typography/overheard.mdx+++ b/content/docs/typography/overheard.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The message is one long testimonial from one person — use `quote-hero`."- "The answer should replace the question in place — use `answer-first`."- "You want a quote that rewrites itself over time — use `changed-mind`."+askedAs:+ - "question and answer quote"+ - "two person dialogue text"+ - "I want someone asking who made the video and another answering I did"+ - "show a casual chat exchange as a social proof line"+ - "a funny overheard conversation beat that sells how easy the tool is"+ - "a short back and forth between customer and teammate that lands the punchline"---<ComponentPreview name="overheard" />diff --git a/content/docs/typography/overnight.mdx b/content/docs/typography/overnight.mdxindex adf10af2..58a3be61 100644--- a/content/docs/typography/overnight.mdx+++ b/content/docs/typography/overnight.mdx@@ -11,6 +11,13 @@ avoidWhen:- "Each story line should drift across the frame on its own — use `story-dip`."- "You only need a single timestamped line on one ground — use `crunch`."- "The text is a person quote with an attribution — use `said-who`."+askedAs:+ - "evening to morning story timeline"+ - "night falls then sun rises text"+ - "I want a three step story with timestamps that spans one night"+ - "show a founder deadline story from evening through night to morning"+ - "a story about working late and shipping by sunrise, with times on each line"+ - "a mood shift from dusk to dawn that tells how fast something got done"---<ComponentPreview name="overnight" />diff --git a/content/docs/typography/parallax-lockup.mdx b/content/docs/typography/parallax-lockup.mdxindex 0973c369..61ae5bbf 100644--- a/content/docs/typography/parallax-lockup.mdx+++ b/content/docs/typography/parallax-lockup.mdx@@ -11,6 +11,13 @@ avoidWhen:- "The text is one short line - use `tracking-in`."- "You want lines to arrive one at a time without scroll - use `line-by-line-slide`."- "You want a per-word fade - use `staggered-fade-up`."+askedAs:+ - "stacked headline depth scroll"+ - "closing brand title lockup"+ - "I want a multi-line statement that scrolls in with layers moving at different speeds"+ - "headline lines settle into a tight block, last line in gradient"+ - "an end title where a brand message locks up into a neat typographic block"+ - "a polished sign-off statement with subtle depth between the lines"---<ComponentPreview name="parallax-lockup" />diff --git a/content/docs/typography/pass-swap.mdx b/content/docs/typography/pass-swap.mdxindex aca834e8..b8bf4858 100644--- a/content/docs/typography/pass-swap.mdx+++ b/content/docs/typography/pass-swap.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want focus pulls between lines, not a moving object — use `focus-front-swap`."- "Lines should shift layout without any object — use `layout-swap`."- "Only one word should change — use `pinned-word`."+askedAs:+ - "object sweeps swapping headlines"+ - "cutout flies across changing text"+ - "I want a moving object crossing the screen to change the line each time"+ - "three line pitch where something whizzes past and the words switch"+ - "a product reveal where an item zips by and hands over to the next message"+ - "rhythm of beats, each punctuated by a pass that brings in a new headline"---<ComponentPreview name="pass-swap" />diff --git a/content/docs/typography/path-ride.mdx b/content/docs/typography/path-ride.mdxindex 804d26f2..8c58e030 100644--- a/content/docs/typography/path-ride.mdx+++ b/content/docs/typography/path-ride.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The line should be an accent on its own, with no text riding it — use `squiggle`."- "The text should loop around a closed ring — use `ring-text`."- "The text should scroll in a straight strip — use `infinite-marquee`."+askedAs:+ - "text follows a drawn curve"+ - "line draws then text straightens"+ - "I want a swoosh line leading the words across the frame before they settle"+ - "tagline that travels along a curve and ends on a straight centered line"+ - "guide the viewer eye from one side of the screen to the centered message"+ - "a flowing intro moment where a curve pulls tight and the phrase lands level"---<ComponentPreview name="path-ride" />diff --git a/content/docs/typography/path-text.mdx b/content/docs/typography/path-text.mdxindex 262e0ae6..909ddc12 100644--- a/content/docs/typography/path-text.mdx+++ b/content/docs/typography/path-text.mdx@@ -11,6 +11,13 @@ avoidWhen:- "You want text typed out character by character - use `typewriter`."- "You want a signature-style draw-on - use `shimmer-sweep`."- "You want a simple clean entrance - use `staggered-fade-up`."+askedAs:+ - "hand drawn wavy text to clean line"+ - "messy to polished wording"+ - "I want words on a wobbly path that straighten into a neat line"+ - "show rough draft turning into refined copy with an italic ending"+ - "a before and after message about going from sketchy to finished"+ - "a title that feels handwritten first and then cleans itself up"---<ComponentPreview name="path-text" />diff --git a/content/docs/typography/peek-shut.mdx b/content/docs/typography/peek-shut.mdxindex bef04249..79637ce5 100644--- a/content/docs/typography/peek-shut.mdx+++ b/content/docs/typography/peek-shut.mdx@@ -11,6 +11,13 @@ avoidWhen:- "You want the full feature shown, not a glimpse — use `photo-fill-type`."- "The tease is a single quiet line with no image — use `riddle-clues`."- "A line should be cut off by a reply card instead of a shutter — use `cut-off`."+askedAs:+ - "slit opens on image then closes"+ - "teaser withholding the product"+ - "I want a thin line that opens to peek at a picture, snaps shut, and says no"+ - "show a sneak peek of the product then deny the rest until launch"+ - "a coming soon teaser that tantalizes with a glimpse and then refuses"+ - "tease the audience, glimpse then shut, building curiosity before release day"---<ComponentPreview name="peek-shut" />diff --git a/content/docs/typography/per-character-rise.mdx b/content/docs/typography/per-character-rise.mdxindex 00122e8b..ac36b3bc 100644--- a/content/docs/typography/per-character-rise.mdx+++ b/content/docs/typography/per-character-rise.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a dramatic staircase effect where each letter visibly lags the previous — use `bottom-up-letters` for the pronounced, wide-gap stagger instead."- "The text is multiple lines and should reveal line-by-line — use `mask-reveal-up` (upward, masked) or `line-by-line-slide` (directional) for line-level reveals."- "The reveal should include blur or atmospheric softness — use `focus-blur-resolve` (blurred entrance) or `blur-out-up` (blurred exit) when sharpness is not the goal."+askedAs:+ - "letters slide up crisp"+ - "sharp kinetic letter entrance"+ - "I want each letter to slide up from below cleanly with no blur"+ - "short word entering letter by letter with even snappy timing"+ - "a punchy title start where characters shoot up one after another"+ - "quick readable headline entrance that feels energetic but sharp"---<ComponentPreview name="per-character-rise" />diff --git a/content/docs/typography/per-word-crossfade.mdx b/content/docs/typography/per-word-crossfade.mdxindex 57a797f1..1099890f 100644--- a/content/docs/typography/per-word-crossfade.mdx+++ b/content/docs/typography/per-word-crossfade.mdx@@ -13,6 +13,13 @@ avoidWhen:- "You want the incoming words to build upward or slide in rather than drift-and-fade — use `line-by-line-slide` or `mask-reveal-up` for directional entrances."- "There is no outgoing text (first entrance only) — use `micro-scale-fade` or `per-character-rise` for a standalone reveal without a `fromText`."- "The phrases are spoken subtitles timed to audio — use `caption-subtitle` or another caption style, which pages a real transcript."+askedAs:+ - "swap phrase word by word fade"+ - "calm text change"+ - "I want one phrase to dissolve into another one word at a time"+ - "soft replacement of a short line with the next, gentle and composed"+ - "a quiet moment where the message changes without any movement"+ - "two lines trading places smoothly mid-video, relaxed mood"---<ComponentPreview name="per-word-crossfade" />diff --git a/content/docs/typography/period-drop.mdx b/content/docs/typography/period-drop.mdxindex 918e420a..fa8250f3 100644--- a/content/docs/typography/period-drop.mdx+++ b/content/docs/typography/period-drop.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The lockup is a row of brand marks rather than a word — use `logo-enter`."- "The word should only rise out of its line, with no accent — use `mask-reveal-up`."- "The ending should be quiet, without any bounce — use `soft-blur-in`."+askedAs:+ - "dot falls and bounces into period"+ - "bouncing full stop ending word"+ - "I want a colored ball dropping in to become the period after my brand word"+ - "end card where a dot squashes and stretches as it lands"+ - "a memorable final beat, the logo word finishes with a bouncing dot"+ - "a playful sign-off moment with one physical drop that lands the sentence"---<ComponentPreview name="period-drop" />diff --git a/content/docs/typography/perspective-marquee.mdx b/content/docs/typography/perspective-marquee.mdxindex efe13779..81e4cdda 100644--- a/content/docs/typography/perspective-marquee.mdx+++ b/content/docs/typography/perspective-marquee.mdx@@ -12,6 +12,13 @@ avoidWhen:- "A flat, 2D looping ticker is sufficient — use `infinite-marquee` for a simpler, lighter strip with no perspective transform."- "The marquee should stop or the words should land on a specific item — both marquee components loop indefinitely; compose a `Sequence` with a static component for a hold state."- "The background is light-colored — the default `fadeColor=\"#050505\"` creates edge fades tuned for dark scenes; adapt carefully or use `infinite-marquee` on light backgrounds."+askedAs:+ - "3D scrolling text wall into horizon"+ - "tilted endless ticker blur"+ - "I want rows of text racing into a vanishing point with blurred depth"+ - "cinematic dark background with feature names rolling away in perspective"+ - "a moody hero backdrop listing features in endless 3D scroll"+ - "a futuristic moment where words stream toward the horizon behind the product"---<ComponentPreview name="perspective-marquee" />diff --git a/content/docs/typography/perspective-squeeze.mdx b/content/docs/typography/perspective-squeeze.mdxindex c49dc1eb..984e77e2 100644--- a/content/docs/typography/perspective-squeeze.mdx+++ b/content/docs/typography/perspective-squeeze.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You need an entrance or a reveal — this is a sustained loop, the type is fully visible from frame 0; use `kinetic-warp` for a punchy display moment."- "The copy must stay easily readable throughout — lines spend most of the loop crushed to a third of their height."- "You only need the vertical stretch without the perspective bend — drop-in alternatives like `per-character-rise` keep the type flat."+askedAs:+ - "looping bending heavy type"+ - "warped stacked words hypnotic"+ - "I want two bold lines endlessly trading size with a perspective warp"+ - "a never-ending typographic loop for a stream or outro screen"+ - "background title that keeps morphing in 3D planes while viewers wait"+ - "hypnotic hold at the end of the video where huge letters keep breathing"---<ComponentPreview name="perspective-squeeze" />diff --git a/content/docs/typography/photo-caret.mdx b/content/docs/typography/photo-caret.mdxindex a355c4ec..b1f14b3f 100644--- a/content/docs/typography/photo-caret.mdx+++ b/content/docs/typography/photo-caret.mdx@@ -11,6 +11,13 @@ avoidWhen:- "You have no photos to place around the text - use `cooling-type`."- "You want a plain typed line - use `typewriter`."- "You want the photos to be the focus - use `cover-ring`."+askedAs:+ - "typing headline with floating photos"+ - "text typing with images around"+ - "I want a statement typed out live while pictures drift around it"+ - "personal brand line written word by word with a hopping cursor and photos"+ - "lifestyle moment where photos orbit a typed manifesto"+ - "a warm human beat, the message gets written as memories float by"---<ComponentPreview name="photo-caret" />diff --git a/content/docs/typography/photo-fill-type.mdx b/content/docs/typography/photo-fill-type.mdxindex c3dddf1c..48a02728 100644--- a/content/docs/typography/photo-fill-type.mdx+++ b/content/docs/typography/photo-fill-type.mdx@@ -11,6 +11,13 @@ avoidWhen:- "You have no image and want text only - use `tracking-in`."- "You want a masked text entrance without a photo - use `mask-reveal-up`."- "You want photos around the text - use `photo-caret`."+askedAs:+ - "photo inside big word cutout"+ - "title opens onto an image"+ - "I want a giant word that expands to reveal a photo filling the screen"+ - "one bold word as a window into a landscape or product shot, then a caption"+ - "an opener that goes from typography to a full-bleed picture"+ - "travel or product moment where the headline word becomes the picture"---<ComponentPreview name="photo-fill-type" />diff --git a/content/docs/typography/phrase-list-bridge.mdx b/content/docs/typography/phrase-list-bridge.mdxindex f32af13d..e4959597 100644--- a/content/docs/typography/phrase-list-bridge.mdx+++ b/content/docs/typography/phrase-list-bridge.mdx@@ -11,6 +11,13 @@ avoidWhen:- "You only want a pill to expand inside a sentence, with no list — use `inline-pill-takeover`."- "A video tile should slot into a gap in the sentence — use `word-gap-media`."- "You want rows of feature chips that cluster around a logo — use `feature-chips-flow`."+askedAs:+ - "list deals in and one is picked"+ - "choosing one option highlight"+ - "I want a menu of options to appear and a highlight to choose the winner"+ - "show browsing many scenes and picking a favorite inside a sentence"+ - "a beat that goes from lots of choices to the one the user wants"+ - "viewer sees options flip past, then the selection lands and the line closes"---<ComponentPreview name="phrase-list-bridge" />diff --git a/content/docs/typography/pinned-word.mdx b/content/docs/typography/pinned-word.mdxindex 27256d59..37dd4f3e 100644--- a/content/docs/typography/pinned-word.mdx+++ b/content/docs/typography/pinned-word.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The fixed part is a phrase and the changing part is a short list — use `width-lock`."- "Each line should reshuffle its layout — use `layout-swap`."- "You want the word inserted into a sentence — use `word-insert`."+askedAs:+ - "one word fixed others change"+ - "constant keyword changing claims"+ - "I want a serif italic word that stays while the rest of the sentence rotates"+ - "tagline family where one anchor word repeats across several claims"+ - "hammer one key word home while the surrounding words keep swapping"+ - "a rhythmic section where ship, write, build each pair with the same word"---<ComponentPreview name="pinned-word" />diff --git a/content/docs/typography/pitch-blanks.mdx b/content/docs/typography/pitch-blanks.mdxindex 240d29f2..97743749 100644--- a/content/docs/typography/pitch-blanks.mdx+++ b/content/docs/typography/pitch-blanks.mdx@@ -11,6 +11,13 @@ avoidWhen:- "You want one word edited inside a sentence, not several blanks — use `word-insert`."- "A single phrase should be emphasized with a marker stroke — use `marker-highlight`."- "The sentence needs no labels and should just build in — use `serif-rise`."+askedAs:+ - "fill in the blank pitch"+ - "underlined blanks get words"+ - "I want a mad-libs style sentence where blanks fill in with the product details"+ - "positioning line showing product, category and audience as empty slots then filled"+ - "explain what we are in one sentence by completing the blanks one at a time"+ - "an elevator pitch beat that builds the sentence piece by piece with small labels"---<ComponentPreview name="pitch-blanks" />diff --git a/content/docs/typography/plain-license.mdx b/content/docs/typography/plain-license.mdxindex 8149c401..3599ed4d 100644--- a/content/docs/typography/plain-license.mdx+++ b/content/docs/typography/plain-license.mdx@@ -11,6 +11,13 @@ avoidWhen:- "You want tiny fine print under a big claim instead of a translation — use `fine-print-up`."- "The line is a single bold statement with no legal text — use `embargo-lift`."- "You want a TL;DR sitting on top of a long body — use `tldr-on-top`."+askedAs:+ - "legalese translated to simple words"+ - "terms in plain english"+ - "I want dense legal text replaced by short friendly phrases"+ - "show our license in a few plain words like free and for anyone"+ - "a trust moment that says no catch, the fine print becomes simple"+ - "viewer should relax as complicated terms melt into one big easy line"---<ComponentPreview name="plain-license" />diff --git a/content/docs/typography/point-expand.mdx b/content/docs/typography/point-expand.mdxindex 75aca540..ad01a8df 100644--- a/content/docs/typography/point-expand.mdx+++ b/content/docs/typography/point-expand.mdx@@ -11,6 +11,13 @@ avoidWhen:- "The statements should arrive in a list with progress ticks and notes — use `feature-trio`."- "You need a single headline with a colored point after it, not a chain — use `point-intro`."- "Plain stacked lines with no scene changes are enough — use `line-by-line-slide`."+askedAs:+ - "punchy claims ending with expanding dot"+ - "dot grows into next scene"+ - "I want a few short claims in a row, then a round point that blows up into the next shot"+ - "fast statements building on each other with a circle that pulses and expands"+ - "a build-up of two to five bold lines that ends by wiping into the next scene"+ - "momentum beat where a dot swells to carry the video forward"---<ComponentPreview name="point-expand" />diff --git a/content/docs/typography/point-intro.mdx b/content/docs/typography/point-intro.mdxindex afd23d09..0fbae7eb 100644--- a/content/docs/typography/point-intro.mdx+++ b/content/docs/typography/point-intro.mdx@@ -10,6 +10,13 @@ useWhen:avoidWhen:- "You need several headlines swapping in sequence — use `rewrite-bars`."- "The headline should snap in with energy rather than being written calmly — use `staggered-fade-up`."+askedAs:+ - "product announcement headline with dot"+ - "introducing title written out"+ - "I want an introducing headline typed word by word ending in a colored dot"+ - "confident launch opener that announces version two with an accent period"+ - "first line of the video announcing a new release, calm and bold"+ - "a clean announcement moment where the headline is written and a dot punctuates it"---<ComponentPreview name="point-intro" />diff --git a/content/docs/typography/post-script.mdx b/content/docs/typography/post-script.mdxindex 1f722d30..67a3415d 100644--- a/content/docs/typography/post-script.mdx+++ b/content/docs/typography/post-script.mdx@@ -11,6 +11,13 @@ avoidWhen:- "You only need a logo and a short tagline to close — use `blink-cut`."- "The ending should be a big gradient title rather than a letter-style sign-off — use `landing-confirmed`."- "You want a quote-style close with an attribution — use `said-who`."+askedAs:+ - "p.s. closing card with install"+ - "thank you signoff then command"+ - "I want an end slate with a signature that gives way to a final p.s. call to action"+ - "close the video thanking viewers then drop an install command"+ - "a last-minute one more thing beat after the goodbye"+ - "final screen where the sign-off shrinks and a postscript line invites the viewer to try it"---<ComponentPreview name="post-script" />diff --git a/content/docs/typography/poster-crop.mdx b/content/docs/typography/poster-crop.mdxindex b748df90..51350407 100644--- a/content/docs/typography/poster-crop.mdx+++ b/content/docs/typography/poster-crop.mdx@@ -10,6 +10,13 @@ useWhen:avoidWhen:- "You only need a single plain headline with no poster furniture — use `scan-reveal`."- "The moment is a quick punchy statement, not a layout — use `two-hit`."+askedAs:+ - "launch poster headline crop"+ - "blue ruled poster title"+ - "I want a big poster headline cropped tight over a grid with kicker and date"+ - "event style launch announcement with date and tagline on blue"+ - "a graphic poster beat where huge type is framed edge to edge"+ - "viewer sees a designed poster feel announcing when something ships"---<ComponentPreview name="poster-crop" />diff --git a/content/docs/typography/prompt-restyle.mdx b/content/docs/typography/prompt-restyle.mdxindex 47cd5913..6d9a5ac2 100644--- a/content/docs/typography/prompt-restyle.mdx+++ b/content/docs/typography/prompt-restyle.mdx@@ -10,6 +10,13 @@ useWhen:avoidWhen:- "You want a plain typed headline without the instruction chrome — use `typewriter`."- "The headline should simply swap words, not be restyled — use `strikethrough-replace`."+askedAs:+ - "ai prompt changes the headline"+ - "typed instructions restyle text"+ - "I want to show a prompt making a headline bigger and tighter and then a serif result"+ - "demo of an AI editing copy style from typed commands"+ - "show how asking in plain words reshapes the title, ending in a gradient italic"+ - "a moment where the viewer understands they can direct the design just by typing"---<ComponentPreview name="prompt-restyle" />diff --git a/content/docs/typography/pull-in.mdx b/content/docs/typography/pull-in.mdxindex cdedcebf..2955a3dc 100644--- a/content/docs/typography/pull-in.mdx+++ b/content/docs/typography/pull-in.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a time-based countdown — use `on-approach`, which plays almost the same way."- "The slot should stay a fixed width — use `width-lock`."- "A word cycles through stops to a final word — use `layover`."+askedAs:+ - "fixed phrase with words pulling in"+ - "now in list platforms"+ - "I want a line like now in vertical, 4K and your codebase with items sliding in"+ - "where it works list that adds places one after another"+ - "platform coverage beat after a constant lead phrase"+ - "announce new supported formats, the viewer sees each new place appear in turn"---<ComponentPreview name="pull-in" />diff --git a/content/docs/typography/pulse-line.mdx b/content/docs/typography/pulse-line.mdxindex 807d9b68..adf58a51 100644--- a/content/docs/typography/pulse-line.mdx+++ b/content/docs/typography/pulse-line.mdx@@ -10,6 +10,13 @@ useWhen:avoidWhen:- "You want a calm sweep of light across the text — use `shimmer-sweep`."- "The line should be written out rather than pulsed — use `typewriter`."+askedAs:+ - "heartbeat through headline"+ - "pulsing text liveness"+ - "I want a heartbeat pulse running through a line of text, last word in teal"+ - "headline that feels alive, as if each word beats"+ - "a speed or aliveness message where the sentence throbs like a pulse monitor"+ - "viewer should feel energy and life in the product in one short tagline"---<ComponentPreview name="pulse-line" />diff --git a/content/docs/typography/quote-hero.mdx b/content/docs/typography/quote-hero.mdxindex a0ed767a..7483940b 100644--- a/content/docs/typography/quote-hero.mdx+++ b/content/docs/typography/quote-hero.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The quote is a joke with a punchline attribution — use `deadpan-box`."- "You want a social post card style testimonial — use `testimonial-stack`."- "The quote should change in place between versions — use `changed-mind`."+askedAs:+ - "customer testimonial pull quote"+ - "big quote with attribution"+ - "I want a large quote with an underlined key phrase and the founder name below"+ - "social proof testimonial for a case study video"+ - "viewer sees a trusted person praising the product, key words emphasized"+ - "a testimonial beat that can rotate between a couple of quotes"---<ComponentPreview name="quote-hero" />diff --git a/content/docs/typography/rep-stack.mdx b/content/docs/typography/rep-stack.mdxindex eb5852a4..cf742d69 100644--- a/content/docs/typography/rep-stack.mdx+++ b/content/docs/typography/rep-stack.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You have several different words, not one repeated word — use `word-stack`."- "You want a focused line with outlined copies that keep drifting above and below — use `echo-stack`."- "The word needs to arrive with an impact slam and shake — use `round-slam`."+askedAs:+ - "repeated word reel scrolls"+ - "AGAIN repeat typography"+ - "I want a caps word repeating as outlined copies scrolling past, then solid"+ - "one-word statement about iteration, copies stacking up"+ - "a bold beat about doing it again and again until it locks"+ - "loud typographic moment where repetition builds then one clean word lands"---<ComponentPreview name="rep-stack" />diff --git a/content/docs/typography/rewrite-bars.mdx b/content/docs/typography/rewrite-bars.mdxindex 7ee25e0f..434d8835 100644--- a/content/docs/typography/rewrite-bars.mdx+++ b/content/docs/typography/rewrite-bars.mdx@@ -10,6 +10,13 @@ useWhen:avoidWhen:- "You only have one line and no rewrite is needed — use `scan-reveal`."- "You want the words swapped by fading rather than bars — use `per-word-crossfade`."+askedAs:+ - "bars sweep rewrite headline"+ - "headline changes under wipe bars"+ - "I want colored bars to sweep over a title and replace it with a new one"+ - "feature walkthrough where each headline is rewritten by a sweeping bar"+ - "launch title that morphs into the next line through sliding bars"+ - "viewer sees copy being edited live, one claim wiped into another"---<ComponentPreview name="rewrite-bars" />diff --git a/content/docs/typography/rgb-glitch-text.mdx b/content/docs/typography/rgb-glitch-text.mdxindex 7781a6b7..050f92db 100644--- a/content/docs/typography/rgb-glitch-text.mdx+++ b/content/docs/typography/rgb-glitch-text.mdx@@ -13,6 +13,13 @@ avoidWhen:- "The brand aesthetic is clean or premium — RGB splits read as intentionally broken; use `shimmer-sweep` for a high-end shimmer moment instead."- "The text is long — offset copies of a full paragraph are illegible during the glitch window; keep it to a short word or phrase."- "The whole frame should break at a scene change rather than a headline mid-scene — use `glitch-cut`."+askedAs:+ - "chromatic aberration glitch title"+ - "cyberpunk glitch text"+ - "I want a few frames of red green blue split jitter on my title"+ - "hacker style digital corruption on a headline"+ - "a tech scene where the title briefly breaks up like a bad signal"+ - "short glitch burst to add edge to a hero text moment"---<ComponentPreview name="rgb-glitch-text" />diff --git a/content/docs/typography/riddle-clues.mdx b/content/docs/typography/riddle-clues.mdxindex 8ae59ef3..e723b156 100644--- a/content/docs/typography/riddle-clues.mdx+++ b/content/docs/typography/riddle-clues.mdx@@ -11,6 +11,13 @@ avoidWhen:- "You want a single hesitant line answered by a reply — use `no-buts`."- "The tease should reveal a sliver of the real product image — use `peek-shut`."- "There is one quiet line and no riddle structure — use `coy-denial`."+askedAs:+ - "numbered clue teaser"+ - "what it has what it lacks riddles"+ - "I want clue one, clue two style lines with a twist that completes each"+ - "teaser campaign hinting at the product through riddles"+ - "build curiosity with repeated clues before the big reveal"+ - "a mystery beat before launch, viewer guesses then gets the answer"---<ComponentPreview name="riddle-clues" />diff --git a/content/docs/typography/ring-text.mdx b/content/docs/typography/ring-text.mdxindex 082eaed9..622bda66 100644--- a/content/docs/typography/ring-text.mdx+++ b/content/docs/typography/ring-text.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The phrase should scroll flat across the frame — use `infinite-marquee`."- "The text should pop out of the plane as a solid extruded word — use `extrude-pop`."- "The motion should be ribbons bursting outward rather than a steady ring — use `radial-burst`."+askedAs:+ - "spinning 3D band with words"+ - "text around a rotating ring"+ - "I want a tilted ring that spins with a phrase wrapped around it"+ - "headline next to a 3D object that itself carries mirrored text"+ - "a dimensional prop moment, a bracelet-like loop turning with the tagline"+ - "viewer sees a slick rotating object that doubles as typography"---<ComponentPreview name="ring-text" />diff --git a/content/docs/typography/rolling-number.mdx b/content/docs/typography/rolling-number.mdxindex 486199bc..03fe4077 100644--- a/content/docs/typography/rolling-number.mdx+++ b/content/docs/typography/rolling-number.mdx@@ -13,6 +13,13 @@ avoidWhen:- "The number change is small or decorative and you want a playful reel feel rather than a data-serious odometer; `slot-machine-roll` reads friendlier."- "The counter is a secondary UI element that should feel lightweight — 150f is a long animation; shorten with `speed` or pick a simpler fade."- "The value is a small integer or needs to count DOWN — use `number-wheel` (direction inferred from `from`/`to`, lighter 112f); `rolling-number` is tuned for large multi-digit metrics counting up."+askedAs:+ - "counting up big number"+ - "odometer metric counter"+ - "I want a revenue or signups figure to roll up to the final value"+ - "stats slide with digits spinning at different speeds"+ - "milestone moment, showing a large number landing on its target"+ - "viewer should feel growth as a huge figure ticks up and settles"---<ComponentPreview name="rolling-number" />diff --git a/content/docs/typography/rolodex-flip.mdx b/content/docs/typography/rolodex-flip.mdxindex 6d2d67ab..9a21ba5d 100644--- a/content/docs/typography/rolodex-flip.mdx+++ b/content/docs/typography/rolodex-flip.mdx@@ -11,6 +11,13 @@ avoidWhen:- "The values are numbers with a counting narrative — use `number-wheel` or `rolling-number`."- "Only two values swap once — `value-swap`, `shared-axis-y`, or `per-word-crossfade` is lighter."- "The line reflows per value — the fixed sizer width shows a gap next to short values."+askedAs:+ - "flipping cards cycle values"+ - "3D card flip word swap"+ - "I want a word in a sentence to flip through options like a rolodex"+ - "cycle package names or integrations inside a fixed line"+ - "works with beat showing different tools flipping into the slot"+ - "viewer sees many choices rotate through one spot, install commands changing"---<ComponentPreview name="rolodex-flip" />diff --git a/content/docs/typography/round-slam.mdx b/content/docs/typography/round-slam.mdxindex d81847ce..76fecdba 100644--- a/content/docs/typography/round-slam.mdx+++ b/content/docs/typography/round-slam.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a count to ten before the verdict word — use `ko-count`."- "The tone is quiet and editorial rather than loud — use `cool-down`."- "You just need one big word to slam in without the game framing — use `full-bleed-type`."+askedAs:+ - "game round announcement"+ - "slam text red band"+ - "I want ROUND 1 slamming in twice then a one-word finisher over a red slash"+ - "fighting game style level call followed by a single word"+ - "high energy hype beat for a game-style reveal"+ - "a punchy moment that feels like a boss fight intro before the product ships"---<ComponentPreview name="round-slam" />diff --git a/content/docs/typography/rsvp.mdx b/content/docs/typography/rsvp.mdxindex aa64425e..c677ae35 100644--- a/content/docs/typography/rsvp.mdx+++ b/content/docs/typography/rsvp.mdx@@ -11,6 +11,13 @@ avoidWhen:- "You want a thank-you sign-off followed by a P.S. line — use `post-script`."- "You only need a bold release announcement line — use `embargo-lift`."- "The last beat is a countdown to going live — use `drop-timer`."+askedAs:+ - "event invitation what when where"+ - "launch invite details table"+ - "I want a big invite headline then a table with what, when and where"+ - "launch event invite ending on how to join with a command"+ - "closing call to action that spells out details of the event"+ - "viewer sees an invitation and exactly how and when to show up"---<ComponentPreview name="rsvp" />diff --git a/content/docs/typography/rubberband-word.mdx b/content/docs/typography/rubberband-word.mdxindex 4aac4741..5b62b3ac 100644--- a/content/docs/typography/rubberband-word.mdx+++ b/content/docs/typography/rubberband-word.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The word change should morph letters smoothly, with no cursor - use `kinetic-morph-text`."- "You just want an edit-style swap - use `strikethrough-replace`."- "A single word only needs to pop onto screen - use `spring-scale-in`."+askedAs:+ - "stretching word snaps"+ - "cursor pulls text like elastic"+ - "I want a cursor grabbing a word by its last letter and stretching it until it snaps"+ - "tension and release where one word turns into another"+ - "tagline whose first word is pulled tight then snaps to its resolution"+ - "viewer feels something tighten then pop into a new meaning"---<ComponentPreview name="rubberband-word" />diff --git a/content/docs/typography/ruby-press.mdx b/content/docs/typography/ruby-press.mdxindex 2c4f6dd6..c3d7b1c4 100644--- a/content/docs/typography/ruby-press.mdx+++ b/content/docs/typography/ruby-press.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The swapped words need a stable width — use `width-lock`."- "A word should be selected and retyped like an editor — use `select-replace`."- "The slot should be an inline roll — use `inline-word-roll`."+askedAs:+ - "swap word with small glosses above"+ - "subtitles for every market line"+ - "I want a word in a sentence pressed out and replaced from a list with tiny captions above"+ - "localization message where the language word keeps changing"+ - "time shrinking claim like minutes then seconds in a sentence"+ - "viewer sees one slot cycling through values with annotations on top"---<ComponentPreview name="ruby-press" />diff --git a/content/docs/typography/ruler-align.mdx b/content/docs/typography/ruler-align.mdxindex ae5ab646..749e6464 100644--- a/content/docs/typography/ruler-align.mdx+++ b/content/docs/typography/ruler-align.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You only need letter spacing to tighten, not baseline fixing - use `kerning-snap`."- "The line should simply appear, with no gag - use `staggered-fade-up`."- "The text should arrive as if being typed - use `typewriter`."+askedAs:+ - "ruler straightens messy text"+ - "snap letters into alignment"+ - "I want a ruler sliding under crooked letters to line them up"+ - "precision and polish message with messy text becoming neat"+ - "before and after of sloppy type fixed onto a baseline"+ - "viewer understands fine detail and order as chaos snaps into place"---<ComponentPreview name="ruler-align" />diff --git a/content/docs/typography/run-on.mdx b/content/docs/typography/run-on.mdxindex 4d477676..5cfb3387 100644--- a/content/docs/typography/run-on.mdx+++ b/content/docs/typography/run-on.mdx@@ -11,6 +11,13 @@ avoidWhen:- "The pain is a repeating loop of short steps rather than one sentence — use `loop-break`."- "You want the chore list to be crossed out, not scrolled away — use `filler-cut`."- "You only need the short answer with a highlighted phrase — use `answer-first`."+askedAs:+ - "long breathless sentence scrolls"+ - "exhausting workflow one sentence"+ - "I want a never-ending run-on line of chores that speeds off then a short promise"+ - "pain point beat listing tedious steps in one breath"+ - "before the fix, show how tiring the old process is, then a full stop"+ - "viewer feels overwhelmed then relieved when a short line drops in"---<ComponentPreview name="run-on" />diff --git a/content/docs/typography/rush-type.mdx b/content/docs/typography/rush-type.mdxindex e121e171..fb670374 100644--- a/content/docs/typography/rush-type.mdx+++ b/content/docs/typography/rush-type.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The text must remain readable throughout the motion — use `word-push` or `zoom-words`."- "You want a horizontal digital glitch — use `rgb-glitch-text`."- "The component must remain transparent — it always paints an opaque background."+askedAs:+ - "fast words with RGB shutter trails"+ - "vertical color streak text"+ - "I want one forceful word at a time blasting in with chromatic trails"+ - "hype cycling of short phrases with red green blue motion smear"+ - "a loud opener with words slamming and color fringes from the motion"+ - "viewer gets a rush of speed from rapid single words"---<ComponentPreview name="rush-type" />diff --git a/content/docs/typography/said-who.mdx b/content/docs/typography/said-who.mdxindex 3946a72f..8fe1aea5 100644--- a/content/docs/typography/said-who.mdx+++ b/content/docs/typography/said-who.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You have a longer testimonial with a role and company row — use `quote-hero`."- "The quote should be answered by a second voice — use `overheard`."- "The attribution is the joke, in a flat box — use `deadpan-box`."+askedAs:+ - "quote with job title credibility"+ - "engineer quote one evening"+ - "I want a big serif quote revealed bit by bit with the speaker role underneath"+ - "short testimonial where who said it matters, like a backend engineer"+ - "surprising claim made believable by the name tag below"+ - "viewer should trust a quick quote because the source is a practitioner"---<ComponentPreview name="said-who" />diff --git a/content/docs/typography/scale-down-fade.mdx b/content/docs/typography/scale-down-fade.mdxindex b89dad2d..28133ae0 100644--- a/content/docs/typography/scale-down-fade.mdx+++ b/content/docs/typography/scale-down-fade.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want energy or playfulness — the scale-down reads as composed, not exciting; use `spring-scale-in` for an overshoot bounce instead."- "The text should feel like it is being revealed rather than settling in — use `staggered-fade-up` or `soft-blur-in` for a character-by-character or word-by-word reveal."- "You need an exit animation — scale-down-fade is an entrance only; compose with a separate exit primitive inside a `<Sequence>`."+askedAs:+ - "subtle premium text settle"+ - "minimal fade entrance"+ - "I want a calm confident headline entrance with no kinetic tricks"+ - "restrained scale fade for an elegant line"+ - "quiet luxury title moment, the surrounding scene is already busy"+ - "viewer should feel polish and calm as the text barely moves in"---<ComponentPreview name="scale-down-fade" />diff --git a/content/docs/typography/scan-reveal.mdx b/content/docs/typography/scan-reveal.mdxindex 4f1f9b59..e803a49f 100644--- a/content/docs/typography/scan-reveal.mdx+++ b/content/docs/typography/scan-reveal.mdx@@ -10,6 +10,13 @@ useWhen:avoidWhen:- "You need several headlines in sequence — use `rewrite-bars`."- "You want a soft blurred entrance instead of a scan — use `focus-blur-resolve`."+askedAs:+ - "scan line reveals title"+ - "headline over underline subtitle"+ - "I want a thin bar sweeping down to uncover a section title"+ - "section opener with a scanner effect and small subtitle below"+ - "tech feel title reveal using a laser line"+ - "viewer sees a new chapter begin as a scanner exposes the heading"---<ComponentPreview name="scan-reveal" />diff --git a/content/docs/typography/scissors-cut.mdx b/content/docs/typography/scissors-cut.mdxindex 52318174..64fa0a79 100644--- a/content/docs/typography/scissors-cut.mdx+++ b/content/docs/typography/scissors-cut.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The swap should be quiet and fast - use `strikethrough-replace`."- "You want several words cycling beside a fixed prefix - use `inline-word-roll`."- "No gag is needed, just a clean replacement - use `fade-through`."+askedAs:+ - "scissors cut word out"+ - "cut and replace phrase"+ - "I want scissors snipping a word from a line and a new word sliding in"+ - "tagline swapping slow timeline for a fast one by cutting"+ - "a crafty edit beat where something old is clipped out of the sentence"+ - "viewer sees an obvious before and after through a tactile cut"---<ComponentPreview name="scissors-cut" />diff --git a/content/docs/typography/script-cut.mdx b/content/docs/typography/script-cut.mdxindex d4f0d942..b44eb9b8 100644--- a/content/docs/typography/script-cut.mdx+++ b/content/docs/typography/script-cut.mdx@@ -11,6 +11,13 @@ avoidWhen:- "A cut should remove filler words from a transcript — use `filler-cut`."- "You want a single word cut out of a line and replaced — use `scissors-cut`."- "The phrases should build on one centered line instead of flying up — use `word-stream`."+askedAs:+ - "line split into shots"+ - "script broken by ticks"+ - "I want one written line sliced by marks into separate pieces that fly up"+ - "how we made it beat turning a script into a sequence of shots"+ - "show a script being cut into scenes"+ - "viewer understands a sentence becomes a storyboard of clips"---<ComponentPreview name="script-cut" />diff --git a/content/docs/typography/scrub-reveal.mdx b/content/docs/typography/scrub-reveal.mdxindex 45aa84b8..15c7fd75 100644--- a/content/docs/typography/scrub-reveal.mdx+++ b/content/docs/typography/scrub-reveal.mdx@@ -11,6 +11,13 @@ avoidWhen:- "You want a light sheen sweeping across muted text instead of a reading scrub — use `shimmer-sweep`."- "The key phrase should get a marker block behind it — use `marker-highlight`."- "You want a soft blurred fade-in of the whole line — use `soft-blur-in`."+askedAs:+ - "paragraph lights up word by word"+ - "manifesto highlight as you read"+ - "I want dim text that brightens as a soft front passes over each word"+ - "value statement that reads like scrolling and lighting up"+ - "a long paragraph beat with one phrase in gradient italic at the end"+ - "viewer reads along as the copy illuminates, building conviction"---<ComponentPreview name="scrub-reveal" />diff --git a/content/docs/typography/select-replace.mdx b/content/docs/typography/select-replace.mdxindex 5a933e89..c1cf69ed 100644--- a/content/docs/typography/select-replace.mdx+++ b/content/docs/typography/select-replace.mdx@@ -12,6 +12,13 @@ avoidWhen:- "A single misspelling should be fixed in place — use `typo-fix`."- "The change should read as a code diff — use `diff-swap`."- "Words should be inserted into a sentence, not replaced — use `word-insert`."+askedAs:+ - "highlight text delete retype"+ - "editor style rewrite"+ - "I want a phrase selected like in a text editor, deleted, and replaced with new words"+ - "copy change demo turning a slow plan into a fast one"+ - "show a sentence being edited with a selection highlight"+ - "viewer sees two phrases swapped as if someone is editing live"---<ComponentPreview name="select-replace" />diff --git a/content/docs/typography/selection-snap.mdx b/content/docs/typography/selection-snap.mdxindex 5f15ed80..8aa34606 100644--- a/content/docs/typography/selection-snap.mdx+++ b/content/docs/typography/selection-snap.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The word should enter with physical motion rather than change in place — use `stretch-in`."- "A plain, quiet reveal is enough and the design-tool look would distract — use `soft-blur-in`."- "The text is a full sentence; the selection frames one short word and reads poorly around a line — use `kinetic-center-build`."+askedAs:+ - "design tool selection handles on word"+ - "font weight thin to black"+ - "I want a word selected with resize handles and a size badge counting up"+ - "Figma style type being designed, weight going from thin to heavy"+ - "a design system or type tool beat, a single word treated as an object"+ - "viewer sees a word get edited like a layer in a design app"---<ComponentPreview name="selection-snap" />diff --git a/content/docs/typography/serif-rise.mdx b/content/docs/typography/serif-rise.mdxindex 97bc2f79..e38de1f1 100644--- a/content/docs/typography/serif-rise.mdx+++ b/content/docs/typography/serif-rise.mdx@@ -10,6 +10,13 @@ useWhen:avoidWhen:- "The line is a bold sans statement that should slam in — use `full-bleed-type`."- "You want a soft blur-in instead of a rise — use `focus-blur-resolve`."+askedAs:+ - "elegant serif line rising"+ - "editorial before after line"+ - "I want a large serif sentence floating up with the end phrase in red"+ - "emotional line like rough cut to final cut, crafted and editorial"+ - "a refined statement for an about or story moment"+ - "viewer should feel thoughtfulness and craft from classic type"---<ComponentPreview name="serif-rise" />diff --git a/content/docs/typography/shader-text-reveal.mdx b/content/docs/typography/shader-text-reveal.mdxindex 9be8cd39..1a7df4cf 100644--- a/content/docs/typography/shader-text-reveal.mdx+++ b/content/docs/typography/shader-text-reveal.mdx@@ -10,6 +10,13 @@ useWhen:avoidWhen:- "A quiet text entrance is enough — use `soft-blur-in`."- "Words should physically morph into each other — use `kinetic-morph-text`."+askedAs:+ - "words revealed through shader material"+ - "animated gradient hero word"+ - "I want each word to appear through a swirling hero background material then turn white"+ - "short headline reveal using a shader effect one word at a time"+ - "hero moment where a fluid colorful texture fills the letters before settling"+ - "viewer sees abstract motion texture resolving into clean text"---<ComponentPreview name="shader-text-reveal" />diff --git a/content/docs/typography/shadow-sweep-text.mdx b/content/docs/typography/shadow-sweep-text.mdxindex 18fb8a9a..c3bec994 100644--- a/content/docs/typography/shadow-sweep-text.mdx+++ b/content/docs/typography/shadow-sweep-text.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The text should stay visible after entering — use `mask-reveal-up` for a one-way reveal."- "Each word needs its own entrance timing — use `per-word-crossfade` or `centered-word-build`."- "The background must remain transparent because this effect relies on a matched dark field and occluders."+askedAs:+ - "text appears through dark shadow"+ - "dense shadow sweeps headline"+ - "I want a headline uncovered and removed by dark sweeping shadows"+ - "short statement emerging from darkness rather than fading"+ - "moody dramatic line entering and leaving with heavy shadow passes"+ - "viewer feels suspense as the words come out of the shade"---<ComponentPreview name="shadow-sweep-text" />diff --git a/content/docs/typography/shared-axis-y.mdx b/content/docs/typography/shared-axis-y.mdxindex 1eea5545..97bfc042 100644--- a/content/docs/typography/shared-axis-y.mdx+++ b/content/docs/typography/shared-axis-y.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You only need to bring text in for the first time with no outgoing content — use `short-slide-down` or `staggered-fade-up` for a clean entrance instead."- "You want a depth or focus-shift feel between two contexts — use `shared-axis-z` which scales rather than slides for that spatial metaphor."- "The transition should feel playful or bouncy — the hard-cut staircase is intentionally sharp; use `spring-scale-in` for a springy swap."+askedAs:+ - "slide deck text swap hard cut"+ - "editorial phrase staircase transition"+ - "I want to swap A to B to C values word by word with a vertical step"+ - "sharp text change between two phrases in a slide style"+ - "chained headline updates that feel like a presentation moving on"+ - "viewer sees crisp vertical word replacement, no softness"---<ComponentPreview name="shared-axis-y" />diff --git a/content/docs/typography/shared-axis-z.mdx b/content/docs/typography/shared-axis-z.mdxindex 0751f575..ab812c0e 100644--- a/content/docs/typography/shared-axis-z.mdx+++ b/content/docs/typography/shared-axis-z.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The swap is a lateral topic change with no depth relationship — use `shared-axis-y` for a horizontal-edit-style cut instead."- "You only need to bring text in for the first time with no outgoing content — use `scale-down-fade` or `soft-blur-in` for a single-text entrance."- "The scene already has a lot of scale motion and you need variety — mix in `shared-axis-y` to alternate the spatial grammar."+askedAs:+ - "zoom depth text change"+ - "focus shift scale transition"+ - "I want text to scale as the context goes from broad to focused"+ - "zoom in narrative moving from big picture to a specific point"+ - "switching between related ideas with a sense of depth"+ - "viewer feels getting closer to the subject as the words scale"---<ComponentPreview name="shared-axis-z" />diff --git a/content/docs/typography/shed-weight.mdx b/content/docs/typography/shed-weight.mdxindex af467182..05c26e1d 100644--- a/content/docs/typography/shed-weight.mdx+++ b/content/docs/typography/shed-weight.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The point is a weight or width that animates on one word - use `axis-flex`."- "You want a single word to switch typefaces - use `font-cycle`."- "The line should simply be revealed once, with no repetition - use `tracking-in`."+askedAs:+ - "same line at growing sizes"+ - "type holds up tiny to huge"+ - "I want one sentence repeated bigger each time with size labels"+ - "typeface showcase showing optical weights from small to large"+ - "design tool or font beat proving the type works at any size"+ - "viewer sees a scale ladder with each cut drawn differently"---<ComponentPreview name="shed-weight" />diff --git a/content/docs/typography/sheen-slide-in.mdx b/content/docs/typography/sheen-slide-in.mdxindex 3e05cb2a..2ae37744 100644--- a/content/docs/typography/sheen-slide-in.mdx+++ b/content/docs/typography/sheen-slide-in.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a repeating metallic shimmer loop rather than a single arrival — use `shimmer-sweep`."- "The title should build word by word — use `word-push` or `word-stream`."- "The entrance should be soft and blurred rather than kinetic — use `soft-blur-in` or `focus-blur-resolve`."+askedAs:+ - "title slides in with shine"+ - "gradient gleam through letters"+ - "I want a headline gliding in from the right with a subtle highlight sweeping through"+ - "fast entrance and long settle for an intro title"+ - "a premium opening line with momentum and a quiet gleam"+ - "viewer notices motion first then a soft shimmer on the glyphs"---<ComponentPreview name="sheen-slide-in" />diff --git a/content/docs/typography/shimmer-sweep.mdx b/content/docs/typography/shimmer-sweep.mdxindex 587a95a0..3f5a060e 100644--- a/content/docs/typography/shimmer-sweep.mdx+++ b/content/docs/typography/shimmer-sweep.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You need the text to enter the scene — shimmer-sweep does not animate the text in; use `tracking-in` or `soft-blur-in` for the entrance, then layer a shimmer if needed."- "The brand aesthetic is casual or energetic — the metallic sweep reads as premium/luxury; use `spring-scale-in` or `staggered-fade-up` for a lighter feel."- "You want per-character color or gradient control — `shimmer-sweep` sweeps a single shine beam; use `rgb-glitch-text` for character-level color splitting."+askedAs:+ - "shine across muted text"+ - "metallic gleam product name"+ - "I want a bright glint to travel over dim text to draw the eye"+ - "highlight a pricing tier name with a refined shine"+ - "luxury SaaS moment where one word is spotlighted by a light pass"+ - "viewer attention should snap to a name as a glossy sweep crosses it"---<ComponentPreview name="shimmer-sweep" />diff --git a/content/docs/typography/short-slide-down.mdx b/content/docs/typography/short-slide-down.mdxindex 592a0ca5..13a09b6c 100644--- a/content/docs/typography/short-slide-down.mdx+++ b/content/docs/typography/short-slide-down.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You are swapping between two text values — use `shared-axis-y` which handles the outgoing text exit properly."- "The text is a single word or short phrase that doesn't benefit from a stacking effect — use `scale-down-fade` or `soft-blur-in` for a cleaner single-unit entrance."- "You want horizontal entry motion — use `short-slide-right` for a left-to-right glide instead."+askedAs:+ - "words drop in and stack"+ - "top down word build block"+ - "I want each word to fall from above and stack into a centered paragraph"+ - "multi-word headline that builds its layout visibly"+ - "composed block of text forming word by word as they land"+ - "viewer sees a title assembled like building blocks coming down"---<ComponentPreview name="short-slide-down" />diff --git a/content/docs/typography/short-slide-right.mdx b/content/docs/typography/short-slide-right.mdxindex ebb68ce3..88e7ab54 100644--- a/content/docs/typography/short-slide-right.mdx+++ b/content/docs/typography/short-slide-right.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You are transitioning between two texts — use `shared-axis-z` (depth) or `shared-axis-y` (vertical swap) which handle the outgoing content."- "You want vertical stacking motion — use `short-slide-down` where each word drops onto its own line to build a layout."- "The slide distance needs to be large or cinematic — `short-slide-right` is intentionally compact (default 24px); use a custom composition for a wide pan."+askedAs:+ - "phrase glides in from left"+ - "forward motion headline"+ - "I want the whole line sliding in horizontally with words fading in order"+ - "headline entering with momentum to suggest progress"+ - "a progress or next step message that moves left to right"+ - "viewer senses moving forward as the phrase slides across"---<ComponentPreview name="short-slide-right" />diff --git a/content/docs/typography/slash-wipe.mdx b/content/docs/typography/slash-wipe.mdxindex 2e1da097..a4df817a 100644--- a/content/docs/typography/slash-wipe.mdx+++ b/content/docs/typography/slash-wipe.mdx@@ -10,6 +10,13 @@ useWhen:avoidWhen:- "You need a single headline with no wipe between sections — use `scan-reveal`."- "The titles should scroll as a list — use `index-list`."+askedAs:+ - "bright slash reveals title"+ - "gradient diagonal wipe heading"+ - "I want a glowing slash sweeping across to reveal a big title with a subline"+ - "section title card for a docs or feature category"+ - "chapter heading that appears as a diagonal light cut crosses the screen"+ - "viewer sees a new section announced with a dramatic stroke"---<ComponentPreview name="slash-wipe" />diff --git a/content/docs/typography/slide-doors.mdx b/content/docs/typography/slide-doors.mdxindex 58a1ee54..ffe1ba55 100644--- a/content/docs/typography/slide-doors.mdx+++ b/content/docs/typography/slide-doors.mdx@@ -10,6 +10,13 @@ useWhen:avoidWhen:- "You need a single line, not a sequence — use `scan-reveal`."- "You want lines to rewrite in place — use `rewrite-bars`."+askedAs:+ - "panels part to reveal text"+ - "sliding doors headline"+ - "I want two panels sliding apart to show a line with an accent word"+ - "three line pitch where each line pushes out the previous one"+ - "arrival message like something landing in your repo, revealed through doors"+ - "viewer feels an opening or entry as panels part"---<ComponentPreview name="slide-doors" />diff --git a/content/docs/typography/slit-scan.mdx b/content/docs/typography/slit-scan.mdxindex 771f48fc..602d42d3 100644--- a/content/docs/typography/slit-scan.mdx+++ b/content/docs/typography/slit-scan.mdx@@ -10,6 +10,13 @@ useWhen:avoidWhen:- "You want the word to slow down on a key syllable — use `speed-ramp-word`."- "The word should resolve from a plain blur — use `focus-blur-resolve`."+askedAs:+ - "fluted glass word reveal"+ - "streaky blur resolves into word"+ - "I want a word to appear through sliced streaks like a slit-scan photo"+ - "speed or performance claim with a stat caption"+ - "benchmark moment where one word snaps out of a motion smear"+ - "viewer senses velocity as the blur sharpens into text"---<ComponentPreview name="slit-scan" />diff --git a/content/docs/typography/slot-machine-roll.mdx b/content/docs/typography/slot-machine-roll.mdxindex c6170a0a..b1608f29 100644--- a/content/docs/typography/slot-machine-roll.mdx+++ b/content/docs/typography/slot-machine-roll.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The value is a large pure integer like `1,240,000` — use `rolling-number` which animates each decimal place independently and reads as a serious data metric."- "The text is more than ~6 characters — long strings become hard to read while the reel spins; use `staggered-fade-up` to reveal a longer phrase."- "The brand tone is formal or data-driven — the slot machine metaphor is inherently playful; use `rolling-number` for a composed odometer feel."+askedAs:+ - "vertical reel swapping digits"+ - "price change digits roll"+ - "I want each character to scroll like a slot reel from old value to new"+ - "before and after price with dollar sign and numbers"+ - "plan upgrade moment where the string changes character by character"+ - "viewer sees a value update with casino-style spinning"---<ComponentPreview name="slot-machine-roll" />diff --git a/content/docs/typography/soft-blur-in.mdx b/content/docs/typography/soft-blur-in.mdxindex 57efff8a..48744e86 100644--- a/content/docs/typography/soft-blur-in.mdx+++ b/content/docs/typography/soft-blur-in.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a hard exit animation — `soft-blur-in` is an entrance only; pair with `blur-out-up` in a `<Sequence>` for a matching exit."- "The vibe is tech, gritty, or high-energy — the soft blur reads as refined and calm; use `rgb-glitch-text` or `tracking-in` for a sharper feel."- "You are swapping between two texts — use `shared-axis-z` or `shared-axis-y` which handle both the outgoing and incoming content."+askedAs:+ - "apple style soft letter reveal"+ - "airy blurry fade in"+ - "I want a hero headline where each character fades in from blur while drifting up"+ - "premium cinematic title entrance"+ - "opening line that feels light, dreamy and expensive"+ - "viewer should be calmed by gentle focusing text"---<ComponentPreview name="soft-blur-in" />diff --git a/content/docs/typography/sold-out.mdx b/content/docs/typography/sold-out.mdxindex 2df3815a..b981740d 100644--- a/content/docs/typography/sold-out.mdx+++ b/content/docs/typography/sold-out.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You count down to a live time rather than draining stock — use `drop-timer`."- "You just need a number to change smoothly to a target — use `number-wheel`."- "The number should climb up as a positive stat — use `rolling-number`."+askedAs:+ - "stock countdown to zero sold out"+ - "scarcity stamp"+ - "I want a stock counter draining fast and then a SOLD OUT band slamming across"+ - "limited drop launch moment with chrome stamp"+ - "create urgency that supply is running out"+ - "viewer should feel fear of missing out as the number hits zero"---<ComponentPreview name="sold-out" />diff --git a/content/docs/typography/speed-ramp-word.mdx b/content/docs/typography/speed-ramp-word.mdxindex bfbfda03..028788ab 100644--- a/content/docs/typography/speed-ramp-word.mdx+++ b/content/docs/typography/speed-ramp-word.mdx@@ -10,6 +10,13 @@ useWhen:avoidWhen:- "You want a streaked blur resolving into a word — use `slit-scan`."- "The line should just be typed in — use `typewriter`."+askedAs:+ - "slow motion on one word"+ - "timecode hud emphasis"+ - "I want the line to rush then drop into slow motion on the key word"+ - "performance message where one word warms to a gradient with a timecode overlay"+ - "emphasis beat that mimics a video speed ramp"+ - "viewer feels time stretch exactly on the important word"---<ComponentPreview name="speed-ramp-word" />diff --git a/content/docs/typography/spine-turn.mdx b/content/docs/typography/spine-turn.mdxindex 119364e6..91cc974f 100644--- a/content/docs/typography/spine-turn.mdx+++ b/content/docs/typography/spine-turn.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a numbered list that highlights row by row — use `index-list`."- "Each step needs its own full beat with a number — use `three-steps`."- "The titles should just replace each other with no history — use `fade-through`."+askedAs:+ - "titles turn into book spines"+ - "agenda chapters stacking"+ - "I want titles rising then rotating ninety degrees to line up like books on a shelf"+ - "chapter or agenda sequence where each heading hands off and stacks"+ - "clean table of contents beat that builds a shelf of spines"+ - "viewer sees a series pile up like a library as each title turns sideways"---<ComponentPreview name="spine-turn" />diff --git a/content/docs/typography/split-word.mdx b/content/docs/typography/split-word.mdxindex f80ba72e..805378df 100644--- a/content/docs/typography/split-word.mdx+++ b/content/docs/typography/split-word.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a gradient slash to wipe a large title in — use `slash-wipe`."- "The words should build up one after another into a phrase — use `kinetic-center-build`."- "The reveal is plain text appearing, not a physical split — use `typewriter`."+askedAs:+ - "word cut open by hairline"+ - "now available status reveal"+ - "I want a huge word split by a thin line with a second word sliding in the gap"+ - "premium announcement where the status word appears inside the headline"+ - "availability news like now live revealed within a title"+ - "viewer sees a headline open up to reveal the key message in the middle"---<ComponentPreview name="split-word" />diff --git a/content/docs/typography/spotlight-text.mdx b/content/docs/typography/spotlight-text.mdxindex b909b323..b8772cda 100644--- a/content/docs/typography/spotlight-text.mdx+++ b/content/docs/typography/spotlight-text.mdx@@ -10,6 +10,13 @@ useWhen:avoidWhen:- "You want a bright band of shine over visible text — use `shimmer-sweep`."- "The headline wraps over several lines — use `line-by-line-slide`."+askedAs:+ - "spotlight moves over dark title"+ - "developer tool headline light beam"+ - "I want a spotlight sweeping across dark text with a mono eyebrow label"+ - "tech opener revealing words as light passes"+ - "dramatic headline lit by a roaming beam on black"+ - "viewer is drawn along the line as the light reveals each word"---<ComponentPreview name="spotlight-text" />diff --git a/content/docs/typography/spring-scale-in.mdx b/content/docs/typography/spring-scale-in.mdxindex 4dc4e702..bc5bd32f 100644--- a/content/docs/typography/spring-scale-in.mdx+++ b/content/docs/typography/spring-scale-in.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The brand is serious, corporate, or premium — spring bounce reads as casual; use `scale-down-fade` or `soft-blur-in` for a composed entrance instead."- "The text is long — many words bouncing in rapid succession becomes visually noisy; use `staggered-fade-up` for a calmer word-by-word reveal."- "You need precise timing for a word to land on a beat — spring physics are frame-accurate but the overshoot makes the visual \"land\" slightly after the spring resolves."+askedAs:+ - "bouncy pop in words"+ - "overshoot scale text"+ - "I want words to pop in with a springy bounce"+ - "energetic launch or celebration text entrance"+ - "fun call to action that bounces into place"+ - "viewer feels excitement as words overshoot and settle"---<ComponentPreview name="spring-scale-in" />diff --git a/content/docs/typography/squeeze-in.mdx b/content/docs/typography/squeeze-in.mdxindex 55b16391..e9d5063e 100644--- a/content/docs/typography/squeeze-in.mdx+++ b/content/docs/typography/squeeze-in.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want the whole word to collapse from a wide tracked-out state with blur — use `tracking-in`."- "Characters should rise or drop into place — use `per-character-rise` or `top-down-letters`."- "You need a typing rhythm with a caret — use `typewriter`."+askedAs:+ - "letters appear then word squeezes"+ - "clean wipe uncover wordmark"+ - "I want characters showing one by one and the word tightening when the last arrives"+ - "short title uncovered as if a cover slid away"+ - "brand name entrance with a tidy squeeze at the end"+ - "viewer sees a word assemble and compress into its final shape"---<ComponentPreview name="squeeze-in" />diff --git a/content/docs/typography/squeeze-out.mdx b/content/docs/typography/squeeze-out.mdxindex 9d3e5cb3..1474bd1e 100644--- a/content/docs/typography/squeeze-out.mdx+++ b/content/docs/typography/squeeze-out.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want lines sliding up with a mask - use `mask-reveal-up`."- "Each line should slide in as a whole, not squeeze glyph by glyph - use `line-by-line-slide`."- "The text should appear as if typed - use `typewriter`."+askedAs:+ - "condensed text expands to full width"+ - "line by line press out"+ - "I want narrow text squeezed out row by row and relaxing wide"+ - "headline that feels like fresh print coming out of a press"+ - "short statement settling after being compressed"+ - "viewer sees tight type breathing out into place"---<ComponentPreview name="squeeze-out" />diff --git a/content/docs/typography/stack-letters.mdx b/content/docs/typography/stack-letters.mdxindex efad1213..c75f44d4 100644--- a/content/docs/typography/stack-letters.mdx+++ b/content/docs/typography/stack-letters.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The message is a full sentence or several words — use `word-stack` for a stacked poster."- "You want a calm, polished word reveal with no physics — use `bottom-up-letters`."- "You need the text to stay readable for a long hold while it animates — use `per-character-rise`."+askedAs:+ - "letters tumble and pile up"+ - "caps word on warm gradient"+ - "I want individual letters falling and stacking to spell one word"+ - "release or milestone title where letters physically land"+ - "playful one-word card with tumbling blocks of type"+ - "viewer smiles as letters drop in like toy blocks"---<ComponentPreview name="stack-letters" />diff --git a/content/docs/typography/staggered-fade-up.mdx b/content/docs/typography/staggered-fade-up.mdxindex ae9a12a2..46c56fdd 100644--- a/content/docs/typography/staggered-fade-up.mdx+++ b/content/docs/typography/staggered-fade-up.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The text is very short (1–2 words) and the stagger has nothing to reveal gradually — use `scale-down-fade` or `spring-scale-in` for a single-unit entrance with more impact."- "You want a per-character (not per-word) reveal — use `soft-blur-in` for character-level stagger with a premium blur feel."- "The scene needs an exit animation — staggered-fade-up is entrance only; compose with a separate exit primitive inside a `<Sequence>`."+askedAs:+ - "words rise and fade in wave"+ - "cascade sentence entrance"+ - "I want a long sentence appearing word by word floating up in a ripple"+ - "body copy entrance with a flowing sequential wave"+ - "headline that feels too long for a plain fade, so each word follows the last"+ - "viewer reads naturally as words arrive in a smooth cascade"---<ComponentPreview name="staggered-fade-up" />diff --git a/content/docs/typography/story-dip.mdx b/content/docs/typography/story-dip.mdxindex 2100361b..3719386d 100644--- a/content/docs/typography/story-dip.mdx+++ b/content/docs/typography/story-dip.mdx@@ -11,6 +11,13 @@ avoidWhen:- "The story is a night-to-morning arc told over changing grounds — use `overnight`."- "You only need one timestamped line — use `crunch`."- "The text is a spoken quote with attribution — use `said-who`."+askedAs:+ - "three timestamped columns anecdote"+ - "setup snag fix story"+ - "I want a short story in three columns, a problem drops and dims, then the fix lights up"+ - "anecdote with times on each part showing a bump in the road and recovery"+ - "customer story where trouble sinks and the resolution rises"+ - "viewer feels the dip and the comeback across three beats"---<ComponentPreview name="story-dip" />diff --git a/content/docs/typography/stretch-in.mdx b/content/docs/typography/stretch-in.mdxindex 741622e7..577edc06 100644--- a/content/docs/typography/stretch-in.mdx+++ b/content/docs/typography/stretch-in.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The type is small or body-size — the smear reads at display sizes; use `per-character-rise` for smaller text."- "You can't ship or reach a font file URL — the deformation needs real glyph outlines; use `short-slide-right` for a plain slide-in."- "The look should be soft or blurred rather than elastic — use `soft-blur-in`."+askedAs:+ - "letters smear in horizontally"+ - "elastic heavy word entrance"+ - "I want letters flying in from off screen and stretching sideways as they travel"+ - "fast physical entrance for a heavy display word"+ - "letterforms deform with speed like rubber before locking"+ - "viewer feels velocity from stretched type slamming in"---<ComponentPreview name="stretch-in" />diff --git a/content/docs/typography/strikethrough-replace.mdx b/content/docs/typography/strikethrough-replace.mdxindex 00a36626..ea3e69a9 100644--- a/content/docs/typography/strikethrough-replace.mdx+++ b/content/docs/typography/strikethrough-replace.mdx@@ -12,6 +12,13 @@ avoidWhen:- "There is no old text to cross out and you just need an entrance — use `staggered-fade-up` or `soft-blur-in`"- "The swap should feel smooth and spatial rather than editorial — use `shared-axis-y` or `shared-axis-z`"- "Both strings are long — the struck line gets hard to read and the full animation runs 120 frames"+askedAs:+ - "cross out old text new below"+ - "editorial correction line"+ - "I want a line struck through then a new phrase appearing under it"+ - "problem replaced by solution, crossing out the old way on purpose"+ - "before and after copy where the old version is deliberately deleted"+ - "viewer sees a correction being made, bad crossed off and better written"---<ComponentPreview name="strikethrough-replace" />diff --git a/content/docs/typography/stripe-mask.mdx b/content/docs/typography/stripe-mask.mdxindex 83424c0f..664044fb 100644--- a/content/docs/typography/stripe-mask.mdx+++ b/content/docs/typography/stripe-mask.mdx@@ -10,6 +10,13 @@ useWhen:avoidWhen:- "You want a single bold word slamming in — use `full-bleed-type`."- "You want a soft reveal, not stripes — use `mask-reveal-up`."+askedAs:+ - "slanted stripes reveal headline"+ - "diagonal bars uncover text"+ - "I want a two-sentence bold statement revealed through angled stripes"+ - "punchy mid-video claim appearing behind slanted blinds"+ - "graphic reveal with a striped mask opening onto text"+ - "viewer sees a statement slice into view in bold diagonal slats"---<ComponentPreview name="stripe-mask" />diff --git a/content/docs/typography/stripe-type.mdx b/content/docs/typography/stripe-type.mdxindex 2b67a8b2..978220e9 100644--- a/content/docs/typography/stripe-type.mdx+++ b/content/docs/typography/stripe-type.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The word should split along its letters rather than in horizontal bands — use `typed-split-wipe`."- "The whole frame should fill with moving rows of type — use `type-wall`."- "A soft, quiet entrance fits better — use `mask-reveal-up`."+askedAs:+ - "horizontal banded word like IBM"+ - "split lines slide together"+ - "I want a word cut into horizontal bands sliding in from alternating sides"+ - "engineered graphic entrance for a product name on a flat color"+ - "IBM logo style striped lettering locking together"+ - "viewer sees a precise machined title snap into alignment"---<ComponentPreview name="stripe-type" />diff --git a/content/docs/typography/strobe-words.mdx b/content/docs/typography/strobe-words.mdxindex a2fa7ce3..3d57d6a5 100644--- a/content/docs/typography/strobe-words.mdx+++ b/content/docs/typography/strobe-words.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The words should blink at a fixed rhythm and then cut to the logo with a one-line tagline — use `blink-cut`."- "Each word needs to slam in one at a time and stay on screen — use `full-bleed-type`."- "The pace should be gentle and readable, not flashing — use `staggered-fade-up`."+askedAs:+ - "flashing words fast cuts"+ - "strobe list of verbs with logo"+ - "I want big words flashing on colored fields getting faster, ending on a poster"+ - "hype opener cutting through plan, write, render, ship"+ - "rhythmic verb montage that lands on the brand logo"+ - "viewer feels an adrenaline build from flickering keywords"---<ComponentPreview name="strobe-words" />diff --git a/content/docs/typography/tagline-justify.mdx b/content/docs/typography/tagline-justify.mdxindex 53c2b15d..c61d4342 100644--- a/content/docs/typography/tagline-justify.mdx+++ b/content/docs/typography/tagline-justify.mdx@@ -11,6 +11,13 @@ avoidWhen:- "A paragraph should reflow its column width rather than set as a fixed block — use `column-reflow`."- "You want a three-line headline with parallax depth — use `parallax-lockup`."- "The text should crop in tight line by line over ruled lines — use `poster-crop`."+askedAs:+ - "tagline in justified block"+ - "words spring in forming poster"+ - "I want a tagline springing in word by word and setting as an aligned block with logo below"+ - "closing line that locks up neatly with one serif italic word in gradient"+ - "one-sentence slogan finishing as a tidy lockup"+ - "viewer sees the final message settle into a balanced poster"---<ComponentPreview name="tagline-justify" />diff --git a/content/docs/typography/tategaki-turn.mdx b/content/docs/typography/tategaki-turn.mdxindex 45f07a53..7ad05c0c 100644--- a/content/docs/typography/tategaki-turn.mdx+++ b/content/docs/typography/tategaki-turn.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The phrase is long and should type out naturally — use `typewriter`."- "Words should build into a phrase from the center — use `kinetic-center-build`."- "You want a simple staggered entrance with no rotation — use `staggered-fade-up`."+askedAs:+ - "vertical japanese style columns"+ - "columns rotate into horizontal"+ - "I want words dropping as vertical columns then swinging upright into one line"+ - "tagline that plays with reading direction"+ - "a culturally flavored beat that turns top to bottom text into normal text"+ - "viewer sees a stack of vertical writing rotate into a readable headline"---<ComponentPreview name="tategaki-turn" />diff --git a/content/docs/typography/they-are-you.mdx b/content/docs/typography/they-are-you.mdxindex 68a0bfd7..19ae4c33 100644--- a/content/docs/typography/they-are-you.mdx+++ b/content/docs/typography/they-are-you.mdx@@ -11,6 +11,13 @@ avoidWhen:- "You want a list of audiences ending in a big and you — use `and-you`."- "The list is credits pointing at one person — use `crew-of-one`."- "A single phrase should turn on its last word — use `turnabout`."+askedAs:+ - "they flips to you"+ - "audience recognition statements"+ - "I want lines describing someone in third person then the they becomes you"+ - "speak about a character then turn it on the viewer"+ - "a relatable beat where the viewer realizes the statements are about them"+ - "viewer feels addressed directly as each line pivots to second person"---<ComponentPreview name="they-are-you" />diff --git a/content/docs/typography/three-steps.mdx b/content/docs/typography/three-steps.mdxindex 58e229b7..47200687 100644--- a/content/docs/typography/three-steps.mdx+++ b/content/docs/typography/three-steps.mdx@@ -11,6 +11,13 @@ avoidWhen:- "You have a longer feature list that needs rows and a highlight — use `index-list`."- "You want three one-word features with notes and progress ticks — use `feature-trio`."- "The steps should read like indented code lines — use `indent-steps`."+askedAs:+ - "three numbered steps along a line"+ - "how it works steps"+ - "I want three big numerals lighting up as a dot travels between them"+ - "explain install, compose, render as a simple process"+ - "product walkthrough summary in three beats with titles and details"+ - "viewer understands how easy it is in three clear stages"---<ComponentPreview name="three-steps" />diff --git a/content/docs/typography/tittle-drop.mdx b/content/docs/typography/tittle-drop.mdxindex ad654777..0ea22fb3 100644--- a/content/docs/typography/tittle-drop.mdx+++ b/content/docs/typography/tittle-drop.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The headline has no i, j or trailing full stop, so nothing lands — use `per-word-crossfade`."- "You need a fast, high-energy opener rather than a slow playful build — use `staggered-fade-up`."- "The line is long or multi-line, where the dot queue would drag — use `line-by-line-slide`."+askedAs:+ - "i and j dots fall last"+ - "witty typographic detail headline"+ - "I want the dots of the letters i and j to drop in after the rest of the line"+ - "hero line where a small letter detail makes it memorable"+ - "light background launch title with a playful finishing touch"+ - "viewer smiles at a tiny detail landing after the sentence"---<ComponentPreview name="tittle-drop" />diff --git a/content/docs/typography/tldr-on-top.mdx b/content/docs/typography/tldr-on-top.mdxindex f49f9243..ecdece42 100644--- a/content/docs/typography/tldr-on-top.mdx+++ b/content/docs/typography/tldr-on-top.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You only have one short claim and no long body — use `less-more` for a two-line contrast."- "The points should be stepped through and dimmed in sequence — use `what-sticks`."- "You want the long copy to be the hero, filling the page — use `whole-page`."+askedAs:+ - "short summary above long paragraph"+ - "tl;dr first"+ - "I want a short version stacked above a dense wall of text that fades back"+ - "admit the full story is long and give the quick summary first"+ - "launch recap beat where details blur out and the gist stays"+ - "viewer gets the point instantly while the fine print recedes"---<ComponentPreview name="tldr-on-top" />diff --git a/content/docs/typography/top-down-letters.mdx b/content/docs/typography/top-down-letters.mdxindex a66ca913..409675b7 100644--- a/content/docs/typography/top-down-letters.mdx+++ b/content/docs/typography/top-down-letters.mdx@@ -13,6 +13,13 @@ avoidWhen:- "You want blur or softness on entry — `top-down-letters` is zero-blur by design; use `soft-blur-in` for the Apple-style per-character blur reveal."- "The stagger direction should be horizontal or spatial — use `short-slide-right` for a left-to-right group glide or `tracking-in` for a letter-spacing collapse instead."- "The letters should rise from below rather than drop from above — use `bottom-up-letters`, the identical-cadence upward mirror."+askedAs:+ - "letters descend staircase"+ - "uppercase acronym drop in"+ - "I want a single caps word with each letter landing from above in steps"+ - "short acronym entrance with structural weight"+ - "heavy blocky title where symbols fall one at a time"+ - "viewer feels solid weight as each character drops into place"---<ComponentPreview name="top-down-letters" />diff --git a/content/docs/typography/torn-edge.mdx b/content/docs/typography/torn-edge.mdxindex ed00f536..7b0a3e1f 100644--- a/content/docs/typography/torn-edge.mdx+++ b/content/docs/typography/torn-edge.mdx@@ -10,6 +10,13 @@ useWhen:avoidWhen:- "You want a clean wipe with no paper texture — use `slash-wipe`."- "You want a soft fade into the headline — use `fade-through`."+askedAs:+ - "paper rips away to reveal title"+ - "torn paper headline"+ - "I want a sheet of paper ripping off to show bold text beneath"+ - "tactile handmade reveal on a gradient background"+ - "scrapbook style moment where the cover is torn away"+ - "viewer feels something physical being opened to expose the message"---<ComponentPreview name="torn-edge" />diff --git a/content/docs/typography/tracking-in.mdx b/content/docs/typography/tracking-in.mdxindex 2f7539b7..e0c5823f 100644--- a/content/docs/typography/tracking-in.mdx+++ b/content/docs/typography/tracking-in.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want per-character stagger — `tracking-in` moves all letters as one unit; use `soft-blur-in` for a per-character blur-and-rise stagger instead."- "The text is a sentence rather than a single bold word — wide initial tracking on a long phrase is illegible until it collapses; use `staggered-fade-up` for multi-word body text."- "The scene is playful or casual — the typographic tracking motion reads as serious and editorial; use `spring-scale-in` for a bouncy entrance instead."+askedAs:+ - "letter spacing collapse focus"+ - "title focuses into place"+ - "I want a brand name whose spacing tightens and blur clears with a springy feel"+ - "title entrance like a camera pulling focus"+ - "wide-spaced letters pulling together to form the word"+ - "viewer feels the word sharpen and settle"---<ComponentPreview name="tracking-in" />diff --git a/content/docs/typography/turnabout.mdx b/content/docs/typography/turnabout.mdxindex bb4d2650..2f47d952 100644--- a/content/docs/typography/turnabout.mdx+++ b/content/docs/typography/turnabout.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The two lines share no words and just replace each other — use `layout-swap`."- "Only one word should change inside a fixed sentence — use `pinned-word`."- "You want an edit-style change with inserted words — use `word-insert`."+askedAs:+ - "sentence flips into mirror"+ - "words flip reversing meaning"+ - "I want a sentence whose words flip to say the opposite with an accent phrase at the end"+ - "positioning that reverses who does the work"+ - "reframe the message like effort for the tool becomes effort from the tool"+ - "viewer has an aha as the same words reorder into new meaning"---<ComponentPreview name="turnabout" />diff --git a/content/docs/typography/two-hit.mdx b/content/docs/typography/two-hit.mdxindex 1d8dd8d2..5d220b26 100644--- a/content/docs/typography/two-hit.mdx+++ b/content/docs/typography/two-hit.mdx@@ -10,6 +10,13 @@ useWhen:avoidWhen:- "You have more than two lines to cycle — use `rewrite-bars`."- "You want a single line with no replacement — use `staggered-fade-up`."+askedAs:+ - "two beat teaser right aligned"+ - "premiere card text"+ - "I want a first line in white replaced by a second in blue on black"+ - "streaming now style release announcement"+ - "short two-part teaser where the second hit lands harder"+ - "viewer sees a movie-trailer style card with a quick one-two"---<ComponentPreview name="two-hit" />diff --git a/content/docs/typography/type-fossil.mdx b/content/docs/typography/type-fossil.mdxindex d85c400d..a1bc6906 100644--- a/content/docs/typography/type-fossil.mdx+++ b/content/docs/typography/type-fossil.mdx@@ -10,6 +10,13 @@ useWhen:avoidWhen:- "Letters must morph individually between phrases — use kinetic-morph-text."- "Long paragraphs need to be read; this composition is built for words and short phrases."+askedAs:+ - "layered contours word imprint"+ - "sculptural typography process"+ - "I want a word with fine contour layers that revises itself then compresses"+ - "creative process moving from early draft wording to the final idea"+ - "title with a carved geological look"+ - "viewer sees ideas being revised and condensed into a finished mark"---<ComponentPreview name="type-fossil" />diff --git a/content/docs/typography/type-repeater.mdx b/content/docs/typography/type-repeater.mdxindex c3df652c..5606b13b 100644--- a/content/docs/typography/type-repeater.mdx+++ b/content/docs/typography/type-repeater.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The repeats should stack in a quiet vertical column above and below the word — use `echo-stack`."- "The whole frame should fill with scrolling rows of the word — use `type-wall`."- "The word should be carried by a spinning 3D band — use `ring-text`."+askedAs:+ - "after effects repeater word"+ - "copies fan tunnel spiral behind word"+ - "I want one word with echoing copies unfolding into a tunnel or spiral"+ - "single word hit with repetition adding depth and energy"+ - "title that breathes with duplicated layers then folds back"+ - "viewer feels depth and pulse around a still readable word"---<ComponentPreview name="type-repeater" />diff --git a/content/docs/typography/type-wall.mdx b/content/docs/typography/type-wall.mdxindex 8c2b8197..b2145242 100644--- a/content/docs/typography/type-wall.mdx+++ b/content/docs/typography/type-wall.mdx@@ -12,6 +12,13 @@ avoidWhen:- "One strip of scrolling text is enough, as a ticker or a separator — use `infinite-marquee`."- "The rows should recede in perspective rather than fill the frame flat — use `perspective-marquee`."- "A single word should stay readable at the center with quieter repeats — use `echo-stack`."+askedAs:+ - "full screen rows of one word"+ - "typographic wall moving opposite ways"+ - "I want the frame filled with one word in heavy and outline rows moving opposite ways"+ - "loud manifesto word or section transition card"+ - "a poster-like background of repeated text with an accent band in the middle"+ - "viewer is hit with sheer volume of one word"---<ComponentPreview name="type-wall" />diff --git a/content/docs/typography/typed-split-wipe.mdx b/content/docs/typography/typed-split-wipe.mdxindex c5fcdee2..0e0fd04c 100644--- a/content/docs/typography/typed-split-wipe.mdx+++ b/content/docs/typography/typed-split-wipe.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You need a conventional typewriter with a blinking caret and no exit — use `typewriter`."- "Every character should rise or move independently — use `per-character-rise`."- "One phrase should be consumed and replaced by another — use `caret-swap`."+askedAs:+ - "clean typing then split wipe exit"+ - "cursorless typed intro"+ - "I want a title typing itself without a cursor and leaving with opposing wipes"+ - "feature intro that builds cleanly then breaks apart directionally"+ - "controlled text exit where halves wipe away"+ - "viewer sees tidy typing followed by a sharp divided exit"---<ComponentPreview name="typed-split-wipe" />diff --git a/content/docs/typography/typewriter.mdx b/content/docs/typography/typewriter.mdxindex 0680ae1c..70a17c89 100644--- a/content/docs/typography/typewriter.mdx+++ b/content/docs/typography/typewriter.mdx@@ -13,6 +13,13 @@ avoidWhen:- "You want a designed, weighted entrance (springy, blurred, kinetic) — typing reads as plain/utilitarian; reach for `tracking-in` or `kinetic-center-build`."- "Multiple lines should reveal together — typing is inherently sequential and single-stream."- "The text is a transcript of someone speaking — use `caption-typewriter`, which types each word at the pace it was said."+askedAs:+ - "typing text with blinking cursor"+ - "terminal command typing"+ - "I want text typed out character by character with a cursor blinking"+ - "simulate someone entering a command or input"+ - "title that types itself like on a keyboard"+ - "viewer watches a command appear letter by letter, developer vibe"---<ComponentPreview name="typewriter" />diff --git a/content/docs/typography/typo-fix.mdx b/content/docs/typography/typo-fix.mdxindex 11aef1d3..41f6119e 100644--- a/content/docs/typography/typo-fix.mdx+++ b/content/docs/typography/typo-fix.mdx@@ -12,6 +12,13 @@ avoidWhen:- "Whole phrases should be selected and rewritten — use `select-replace`."- "You want to show a code-style change — use `diff-swap`."- "A new word should be added to the sentence — use `word-insert`."+askedAs:+ - "misspelled word corrected"+ - "typo caught and fixed"+ - "I want a typo in a sentence noticed and corrected in place"+ - "quick edit demo showing copy fix is easy"+ - "a humanizing joke about a mistake caught before shipping"+ - "viewer smiles as a wrong word is fixed on screen"---<ComponentPreview name="typo-fix" />diff --git a/content/docs/typography/uncomment-line.mdx b/content/docs/typography/uncomment-line.mdxindex db9961e6..2b2cc2d0 100644--- a/content/docs/typography/uncomment-line.mdx+++ b/content/docs/typography/uncomment-line.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The audience is not technical and comment syntax would be noise — use `what-sticks`."- "You want one line edited into another — use `diff-swap`."- "You want typed characters rather than a reveal — use `typewriter`."+askedAs:+ - "code comments switched on"+ - "uncomment lines become copy"+ - "I want lines starting as code comments to lose the slashes and light up"+ - "developer product beat where three promises get enabled like code"+ - "feature list shown as commented-out code coming alive"+ - "viewer sees dormant code turn live as each line is activated"---<ComponentPreview name="uncomment-line" />diff --git a/content/docs/typography/unmask-line.mdx b/content/docs/typography/unmask-line.mdxindex 7428af59..630319a5 100644--- a/content/docs/typography/unmask-line.mdx+++ b/content/docs/typography/unmask-line.mdx@@ -10,6 +10,13 @@ useWhen:avoidWhen:- "You want a classic typing cursor — use `typewriter`."- "You want the words to rise in softly — use `staggered-fade-up`."+askedAs:+ - "monospace letters revealed one by one"+ - "out of stealth announcement"+ - "I want a code-font line uncovered letter by letter with the last word in green"+ - "developer tool announcement with a hacker-like decode"+ - "status change like beta to live shown by decrypting text"+ - "viewer sees hidden text unveiled in a terminal-like style"---<ComponentPreview name="unmask-line" />diff --git a/content/docs/typography/value-swap.mdx b/content/docs/typography/value-swap.mdxindex 7567ce6b..94024d20 100644--- a/content/docs/typography/value-swap.mdx+++ b/content/docs/typography/value-swap.mdx@@ -10,6 +10,13 @@ useWhen:avoidWhen:- "Values should cycle continuously as a montage — use `rolodex-flip` with its own rhythm instead."- "The value is a large pure number counting up — `rolling-number` or `number-wheel` reads as data."+askedAs:+ - "in place value slide swap"+ - "before after price swap"+ - "I want a number or label to swap vertically without shifting the layout"+ - "status or token change at a specific story beat"+ - "hex color or version updating inside a fixed sentence"+ - "viewer sees a value change cleanly while everything around stays still"---<ComponentPreview name="value-swap" />diff --git a/content/docs/typography/verbed.mdx b/content/docs/typography/verbed.mdxindex 85906226..fb3a13e2 100644--- a/content/docs/typography/verbed.mdx+++ b/content/docs/typography/verbed.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a short punchy name reveal with no explanation — use `we-call-it`."- "The scene has a single definition line — use `which-means`."- "You want a multi-paragraph statement of beliefs — use `whole-page`."+askedAs:+ - "dictionary definition of product name"+ - "brand name as a verb"+ - "I want a dictionary entry defining our name as a noun and then a verb"+ - "show our product became an action people say"+ - "about the name scene with inflections and an example sentence"+ - "viewer sees the brand turn into everyday language"---<ComponentPreview name="verbed" />diff --git a/content/docs/typography/wake-wipe.mdx b/content/docs/typography/wake-wipe.mdxindex 0324398c..60406693 100644--- a/content/docs/typography/wake-wipe.mdx+++ b/content/docs/typography/wake-wipe.mdx@@ -10,6 +10,13 @@ useWhen:avoidWhen:- "You want lines to slide apart like doors — use `slide-doors`."- "You want the line rewritten in place — use `rewrite-bars`."+askedAs:+ - "wake trail text reveal"+ - "headline revealed by a sweeping trail with one gradient word"+ - "I want a tagline uncovered by a boat-wake style sweep with a colorful keyword"+ - "text that gets unveiled by a swooshing band of motion"+ - "opening line of a launch video that gets swept into view"+ - "a catchy slogan reveal where a smooth wave uncovers the words"---<ComponentPreview name="wake-wipe" />diff --git a/content/docs/typography/walkout-name.mdx b/content/docs/typography/walkout-name.mdxindex 5009ab88..22c45b0d 100644--- a/content/docs/typography/walkout-name.mdx+++ b/content/docs/typography/walkout-name.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The name should arrive quietly with a polished, understated feel — use `name-gloss`."- "The text is a sentence rather than three short name lines — use `line-by-line-slide`."- "You only need one punchy word to slam in, with no record or nickname — use `round-slam`."+askedAs:+ - "boxing walkout name"+ - "fighter intro name card"+ - "I want my name introduced like a UFC fighter before the bout"+ - "name slams in line by line, then a record and nickname appear"+ - "presenting a founder or speaker with a hype sports-announcer entrance"+ - "team member intro with big impact, stats line and a nickname"---<ComponentPreview name="walkout-name" />diff --git a/content/docs/typography/waveform-title.mdx b/content/docs/typography/waveform-title.mdxindex 614d80d1..7657ce93 100644--- a/content/docs/typography/waveform-title.mdx+++ b/content/docs/typography/waveform-title.mdx@@ -10,6 +10,13 @@ useWhen:avoidWhen:- "You want a pulse running through the text itself — use `pulse-line`."- "You need a plain headline without an audio motif — use `blur-out-up`."+askedAs:+ - "audio waveform headline"+ - "title over a glowing sound wave"+ - "I want a headline above a wavy audio line that becomes an underline"+ - "podcast or music launch title card with a sound wave underneath"+ - "intro for a voice product where the title feels tied to audio"+ - "headline that rises while a colorful aurora wave line calms into a rule"---<ComponentPreview name="waveform-title" />diff --git a/content/docs/typography/we-call-it.mdx b/content/docs/typography/we-call-it.mdxindex 5e8d70e2..cb7a57fd 100644--- a/content/docs/typography/we-call-it.mdx+++ b/content/docs/typography/we-call-it.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You need the name defined like a dictionary entry — use `verbed`."- "The payoff is a time phrase rather than a name — use `on-approach`."- "You want the name placed in a fill-in-the-blank frame — use `your-name-here`."+askedAs:+ - "introducing product name big"+ - "short lines building to a product name"+ - "I want a few descriptive lines and then say what we call it"+ - "lead-in phrases that lead up to the big brand reveal"+ - "moment where the viewer finally learns the name of the thing"+ - "naming reveal after teasing what the product does"---<ComponentPreview name="we-call-it" />diff --git a/content/docs/typography/week-shipped.mdx b/content/docs/typography/week-shipped.mdxindex 0706a685..d4fae353 100644--- a/content/docs/typography/week-shipped.mdx+++ b/content/docs/typography/week-shipped.mdx@@ -12,6 +12,13 @@ avoidWhen:- "Each item needs a longer description or screenshot — use `changelog-scroll`."- "The list is features, not days, and should show as chips — use `feature-chips-flow`."- "You want a counted-down series rather than a week — use `nonstop`."+askedAs:+ - "weekly recap list"+ - "what we shipped this week"+ - "I want Monday to Friday listed with the thing shipped each day"+ - "build-in-public weekly update in heavy bold type"+ - "end-of-week summary video that rolls through each day's release"+ - "show a sprint of daily launches stacked in a rolling list"---<ComponentPreview name="week-shipped" />diff --git a/content/docs/typography/weight-wave.mdx b/content/docs/typography/weight-wave.mdxindex 3235944b..92967f0b 100644--- a/content/docs/typography/weight-wave.mdx+++ b/content/docs/typography/weight-wave.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You need the headline to enter from off-screen or by letter — use `per-character-rise`."- "The line is long and wraps to several lines — use `line-by-line-slide`."- "You want a width and weight flex on a single big word — use `axis-flex`."+askedAs:+ - "font weight wave text"+ - "text getting bolder in a ripple"+ - "I want letters thickening and thinning across a line, ending on a highlighted word"+ - "a variable font ripple that lands on the key word"+ - "playful emphasis where boldness travels through the sentence"+ - "typographic intro that feels alive, with thickness flowing through the headline"---<ComponentPreview name="weight-wave" />diff --git a/content/docs/typography/what-sticks.mdx b/content/docs/typography/what-sticks.mdxindex c3c4016e..5d492db9 100644--- a/content/docs/typography/what-sticks.mdx+++ b/content/docs/typography/what-sticks.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a summary on top of the full copy — use `tldr-on-top`."- "Lines should stay all visible while one is edited — use `diff-swap`."- "You want a single contrast pair, not a list — use `less-more`."+askedAs:+ - "dim lines keep one"+ - "list fading until one remains"+ - "I want many claims fade away and leave only the one that matters"+ - "highlight the single takeaway among a column of statements"+ - "show that most ideas fade but one message stays in memory"+ - "focus moment narrowing a pile of points down to the winning line"---<ComponentPreview name="what-sticks" />diff --git a/content/docs/typography/which-means.mdx b/content/docs/typography/which-means.mdxindex e4f5fd09..0802f384 100644--- a/content/docs/typography/which-means.mdx+++ b/content/docs/typography/which-means.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You only need a short before-and-after contrast — use `less-more`."- "The explanation is a long paragraph, not a chain — use `tldr-on-top`."- "You want the name defined as a word — use `verbed`."+askedAs:+ - "feature leads to benefits chain"+ - "so that, which means text"+ - "I want a feature followed by cause-and-effect consequences step by step"+ - "explain how one capability turns into a bigger outcome"+ - "a logical chain showing why a small feature matters in the end"+ - "pitch beat where each line follows from the last with a connecting phrase"---<ComponentPreview name="which-means" />diff --git a/content/docs/typography/whole-page.mdx b/content/docs/typography/whole-page.mdxindex 3173ab67..cd61cb8f 100644--- a/content/docs/typography/whole-page.mdx+++ b/content/docs/typography/whole-page.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You only need a short summary above the details — use `tldr-on-top`."- "Each belief should appear and dim on its own — use `what-sticks`."- "The statement is one sentence — use `we-call-it`."+askedAs:+ - "manifesto text page"+ - "serif beliefs in columns"+ - "I want a full page of our principles in elegant serif paragraphs"+ - "editorial values statement filling the screen column by column"+ - "about-us or company beliefs moment with a long thoughtful read"+ - "brand philosophy section that feels like a printed essay"---<ComponentPreview name="whole-page" />diff --git a/content/docs/typography/width-lock.mdx b/content/docs/typography/width-lock.mdxindex 2db2569d..b0385566 100644--- a/content/docs/typography/width-lock.mdx+++ b/content/docs/typography/width-lock.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The swapped word should be pressed with annotations — use `ruby-press`."- "One word stays and the rest swap — use `pinned-word`."- "Words should arrive from a spread-out position — use `pull-in`."+askedAs:+ - "rotating word fixed width"+ - "cycling word in condensed line"+ - "I want one word in a headline to swap through a list without the line shifting"+ - "tagline where the last word changes and the layout stays put"+ - "showing many use cases by flipping a single word in a slogan"+ - "stable headline with a slot machine style changing word"---<ComponentPreview name="width-lock" />diff --git a/content/docs/typography/word-acts.mdx b/content/docs/typography/word-acts.mdxindex 5503c0bb..ef900ed4 100644--- a/content/docs/typography/word-acts.mdx+++ b/content/docs/typography/word-acts.mdx@@ -12,6 +12,13 @@ avoidWhen:- "Every word should share one consistent motion style — use `kinetic-morph-text`."- "The copy is a full sentence that needs to read as a line — use `word-push`."- "You need only one word to stretch in, not a sequence of acts — use `stretch-in`."+askedAs:+ - "words act out meaning"+ - "each word animates its meaning"+ - "I want every word to perform its own meaning, like fall for a falling word"+ - "kinetic typography where the motion matches each word then a poster word holds"+ - "playful short sentence where words play charades before a final big word"+ - "fun brand beat that ends on one held statement word"---<ComponentPreview name="word-acts" />diff --git a/content/docs/typography/word-gap-media.mdx b/content/docs/typography/word-gap-media.mdxindex 87d82dbb..3e1035a8 100644--- a/content/docs/typography/word-gap-media.mdx+++ b/content/docs/typography/word-gap-media.mdx@@ -10,6 +10,13 @@ useWhen:avoidWhen:- "You only need a headline with no imagery — use `staggered-fade-up`."- "You want one giant word with the camera pulling back — use `word-pullback`."+askedAs:+ - "video inside a sentence"+ - "footage placed between words"+ - "I want a clip sitting in the gap of a headline like a word replaced by a picture"+ - "text with a moving image tile slotted into the line"+ - "hero statement where visuals become part of the sentence"+ - "show product footage embedded mid-phrase in a bold tagline"---<ComponentPreview name="word-gap-media" />diff --git a/content/docs/typography/word-insert.mdx b/content/docs/typography/word-insert.mdxindex 08e74c16..c6e98cc9 100644--- a/content/docs/typography/word-insert.mdx+++ b/content/docs/typography/word-insert.mdx@@ -12,6 +12,13 @@ avoidWhen:- "Words should be replaced, not added — use `select-replace`."- "The sentence resets layout between versions — use `layout-swap`."- "Only one word should change in place — use `typo-fix`."+askedAs:+ - "sentence edits itself"+ - "insert new words into a line"+ - "I want a sentence that opens a gap and adds extra words in color"+ - "text edit where additions appear in a gradient"+ - "show a message being improved by adding a phrase live"+ - "before-after copy tweak where new words slide into an existing line"---<ComponentPreview name="word-insert" />diff --git a/content/docs/typography/word-ladder.mdx b/content/docs/typography/word-ladder.mdxindex 101dfa9b..3f6069ed 100644--- a/content/docs/typography/word-ladder.mdx+++ b/content/docs/typography/word-ladder.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The letters should be rearranged into one new word — use `anagram-shuffle`."- "The words are unrelated and should just swap — use `ruby-press`."- "You want a fixed-width list swap — use `width-lock`."+askedAs:+ - "word changes letter by letter"+ - "word ladder puzzle text"+ - "I want one word to turn into another by swapping a letter at a time"+ - "step by step word transformation climbing to the final word"+ - "clever wordplay beat showing small changes lead to a new meaning"+ - "puzzle-like intro where each rung of a ladder edits the word"---<ComponentPreview name="word-ladder" />diff --git a/content/docs/typography/word-pullback.mdx b/content/docs/typography/word-pullback.mdxindex 3272afbd..d1dd11c0 100644--- a/content/docs/typography/word-pullback.mdx+++ b/content/docs/typography/word-pullback.mdx@@ -10,6 +10,13 @@ useWhen:avoidWhen:- "You want media inside the sentence — use `word-gap-media`."- "You want a plain line without camera motion — use `staggered-fade-up`."+askedAs:+ - "camera pulls back from word"+ - "zoom out to reveal sentence"+ - "I want a giant word and the view retreating to show the full tagline"+ - "start on one huge word then reveal the whole statement"+ - "cinematic opener where the big word turns out to be part of a slogan"+ - "pull-out reveal that gives context to a single word"---<ComponentPreview name="word-pullback" />diff --git a/content/docs/typography/word-push.mdx b/content/docs/typography/word-push.mdxindex ffa62970..23dd595e 100644--- a/content/docs/typography/word-push.mdx+++ b/content/docs/typography/word-push.mdx@@ -12,6 +12,13 @@ avoidWhen:- "Several phrases must play in sequence with cuts between them — use `word-stream` for the multi-phrase flow."- "You want a calm, driftless word-by-word entrance — use `per-word-crossfade`."- "The reveal should happen per character rather than per word — use `per-character-rise` or `soft-blur-in`."+askedAs:+ - "words push line sideways"+ - "new word shoves the line left"+ - "I want each word to drive in from the right and shift the sentence over"+ - "sliding text that re-centers as words arrive one by one"+ - "simple sentence build where the line keeps recentering on new words"+ - "horizontal push typography for a punchy one-line statement"---<ComponentPreview name="word-push" />diff --git a/content/docs/typography/word-stack.mdx b/content/docs/typography/word-stack.mdxindex 6bf55c30..e72544d7 100644--- a/content/docs/typography/word-stack.mdx+++ b/content/docs/typography/word-stack.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The words should appear in place, one at a time, without a scrolling stack — use `zoom-words`."- "The line is a sentence that must stay on one line — use `line-by-line-slide`."- "You want a soft, low-energy entrance rather than hard pushes — use `staggered-fade-up`."+askedAs:+ - "caps words stacking poster"+ - "bold stacked words ending in italic"+ - "I want uppercase words piling up into a poster, last word in fancy serif"+ - "stacked typography that finishes with a gradient italic word"+ - "hero statement with strong stacking and a stylish final word"+ - "poster-style ending where the stack resolves to an elegant accent"---<ComponentPreview name="word-stack" />diff --git a/content/docs/typography/word-stream.mdx b/content/docs/typography/word-stream.mdxindex 98cd2332..881b777e 100644--- a/content/docs/typography/word-stream.mdx+++ b/content/docs/typography/word-stream.mdx@@ -13,6 +13,13 @@ avoidWhen:- "You need a two-state before/after text swap rather than a stream — use `value-swap` or `strikethrough-replace`."- "The text is a multi-line paragraph — use `line-by-line-slide` or `mask-reveal-up` for line-level reveals."- "The words follow a real voiceover — use `caption-karaoke` or another style from the Captions tab, which times every word from a transcript instead of inventing the pace."+askedAs:+ - "voiceover paced phrases"+ - "words appearing in sync with narration"+ - "I want phrases that build word by word while drifting left"+ - "text that follows a spoken script across multiple sentences"+ - "explainer segment where lines flow along as the narrator talks"+ - "continuous text stream moving sideways with cuts between phrases"---<ComponentPreview name="word-stream" />diff --git a/content/docs/typography/wrapped-squash.mdx b/content/docs/typography/wrapped-squash.mdxindex c134d93a..fa0f2d9e 100644--- a/content/docs/typography/wrapped-squash.mdx+++ b/content/docs/typography/wrapped-squash.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You have more than three lines or longer phrases — use `word-stack`."- "The tone should be calm, with text appearing gently — use `mask-reveal-up`."- "You only need one big word to hit the frame — use `round-slam`."+askedAs:+ - "lines squashed into color blocks"+ - "bold poster of colored text blocks"+ - "I want each caps line stretched to fill its own colored rectangle"+ - "Spotify wrapped style typographic poster"+ - "year-in-review title card made of stacked colorful slabs"+ - "loud full-frame typographic layout with squishing text"---<ComponentPreview name="wrapped-squash" />diff --git a/content/docs/typography/yes-run.mdx b/content/docs/typography/yes-run.mdxindex 0fe89cb2..de199525 100644--- a/content/docs/typography/yes-run.mdx+++ b/content/docs/typography/yes-run.mdx@@ -12,6 +12,13 @@ avoidWhen:- "Each answer is different and longer — use `which-means`."- "You want a two-line contrast rather than a list — use `less-more`."- "Items should be listed as chips — use `feature-chips-flow`."+askedAs:+ - "yes yes yes questions"+ - "questions answered with yes tag"+ - "I want a list of questions each answered with the same orange Yes"+ - "rapid-fire does it do X yes feature checklist"+ - "showing a product can do everything people ask, with repeated confirmation"+ - "punchy beat where a stream of short questions all get a yes badge"---<ComponentPreview name="yes-run" />diff --git a/content/docs/typography/your-name-here.mdx b/content/docs/typography/your-name-here.mdxindex d07dc54b..77645c43 100644--- a/content/docs/typography/your-name-here.mdx+++ b/content/docs/typography/your-name-here.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The change is a whole headline, not a name slot — use `layout-swap`."- "One word inside a sentence should cycle through options — use `width-lock`."- "You want the name revealed after build-up lines — use `we-call-it`."+askedAs:+ - "brand name placeholder caption"+ - "personalised caption with swapped name"+ - "I want a launch film caption where the viewer's own brand name drops into a slot"+ - "template line showing your company name goes here"+ - "moment inviting the viewer to imagine their own product in the video"+ - "white-label intro where the name can be replaced per customer"---<ComponentPreview name="your-name-here" />diff --git a/content/docs/typography/zoom-words.mdx b/content/docs/typography/zoom-words.mdxindex 71d23dcc..803eb9a7 100644--- a/content/docs/typography/zoom-words.mdx+++ b/content/docs/typography/zoom-words.mdx@@ -13,6 +13,13 @@ avoidWhen:- "You need character-by-character typing with a caret — use `typewriter`."- "The camera language should be a real 2.5D move over a scene rather than a text close-up — use `stage`."- "One spoken word at a time from a voiceover — use `caption-word-pop`, which follows the transcript timing."+askedAs:+ - "huge words camera follow"+ - "camera tracking text as it types"+ - "I want giant words fading into a long line while the view follows the end"+ - "zoomed in typing where the frame rides along the newest word"+ - "long sentence told large with a camera that scrolls with it"+ - "dramatic copy beat where only the latest word is in focus"---<ComponentPreview name="zoom-words" />diff --git a/content/docs/ui-blocks/achievement-pop.mdx b/content/docs/ui-blocks/achievement-pop.mdxindex d60920cc..5441bcfb 100644--- a/content/docs/ui-blocks/achievement-pop.mdx+++ b/content/docs/ui-blocks/achievement-pop.mdx@@ -12,6 +12,13 @@ avoidWhen:- "A single big milestone number is the point — use `milestone-roll`."- "You want a lightweight notification sliding in and out — use `toast`."- "The beat is about ranking people or items rather than unlocking — use `leaderboard-climb`."+askedAs:+ - "achievement unlocked toasts"+ - "game trophy notifications stack"+ - "I want badges unlocking one after another like Xbox or PlayStation trophies"+ - "gamified milestones popping up in a stack, rare card last"+ - "celebrate user progress with a series of rewards and a total score"+ - "end of video recap of unlocked achievements with a final wordmark"---<ComponentPreview name="achievement-pop" />diff --git a/content/docs/ui-blocks/animated-bar-chart.mdx b/content/docs/ui-blocks/animated-bar-chart.mdxindex 71464a99..a3ec0876 100644--- a/content/docs/ui-blocks/animated-bar-chart.mdx+++ b/content/docs/ui-blocks/animated-bar-chart.mdx@@ -11,6 +11,13 @@ useWhen:avoidWhen:- "The data represents change over time — continuous trends belong in `animated-line-chart`, not bars."- "You have a single data point; one bar springing up looks degenerate — embed a number counter or use a text animation."+askedAs:+ - "bar chart growing"+ - "bars rising from the baseline"+ - "I want a bar graph that animates in with staggered columns"+ - "compare categories visually with columns jumping up"+ - "show quarterly revenue or metrics as springing vertical bars"+ - "data slide where the viewer sees which category is tallest"---<ComponentPreview name="animated-bar-chart" />diff --git a/content/docs/ui-blocks/animated-line-chart.mdx b/content/docs/ui-blocks/animated-line-chart.mdxindex 45c9d5db..fc1cea56 100644--- a/content/docs/ui-blocks/animated-line-chart.mdx+++ b/content/docs/ui-blocks/animated-line-chart.mdx@@ -11,6 +11,13 @@ useWhen:avoidWhen:- "The data is categorical (not time-ordered) — use `animated-bar-chart` to compare discrete values side by side."- "You have only 2–3 data points; a near-straight line adds little; use a number counter or a headline stat instead."+askedAs:+ - "line graph drawing"+ - "growth curve drawing itself"+ - "I want a trend line that draws from left to right"+ - "show growth over time with a path tracing across the chart"+ - "investor-style moment where the upward line proves traction"+ - "data scene showing a metric climbing across months"---<ComponentPreview name="animated-line-chart" />diff --git a/content/docs/ui-blocks/border-beam.mdx b/content/docs/ui-blocks/border-beam.mdxindex d7eba45f..c909a425 100644--- a/content/docs/ui-blocks/border-beam.mdx+++ b/content/docs/ui-blocks/border-beam.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The beam should run as a shader on any frame rather than around a card — use `shader-pulsing-border`."- "The card is a settings form that fills with fields — use `rim-draw-card`."- "You want counted stats instead of a title and command — use `stat-sequence`."+askedAs:+ - "light running around card border"+ - "glowing beam circling a card"+ - "dark card with a light chasing its edge, then a logo and install command"+ - "glowing outline animation on a product card"+ - "developer tool launch card with an animated glowing edge and copy command"+ - "premium card entrance with a moving highlight along its rim"---<ComponentPreview name="border-beam" />diff --git a/content/docs/ui-blocks/card-fan.mdx b/content/docs/ui-blocks/card-fan.mdxindex 83e0ee91..d90648a2 100644--- a/content/docs/ui-blocks/card-fan.mdx+++ b/content/docs/ui-blocks/card-fan.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The options should swipe through one at a time like a deck — use `swipe-deck`."- "You need a dense grid of feature tiles rather than a fan — use `bento-build`."- "Three feature headings in a row are enough — use `feature-trio`."+askedAs:+ - "cards fanning out"+ - "hand of cards spreading"+ - "I want a stack of colored cards spreading like a poker hand with one lifted"+ - "show several formats or options as fanned cards then a caption"+ - "moment presenting supported file types or variants in a fan layout"+ - "deck of cards opening to showcase choices, one highlighted"---<ComponentPreview name="card-fan" />diff --git a/content/docs/ui-blocks/card-push-line.mdx b/content/docs/ui-blocks/card-push-line.mdxindex 48e2b4a3..5216e0a2 100644--- a/content/docs/ui-blocks/card-push-line.mdx+++ b/content/docs/ui-blocks/card-push-line.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want the camera to ride the caret and punch in on a phrase — use `caret-dolly`, the dolly twin of this scene."- "The prompt should continue into a full chat conversation — use `ai-prompt-flow`."- "Several files drop into the box — use `multi-file-drop`."+askedAs:+ - "camera push on prompt card"+ - "slash command typed in a card"+ - "I want a headline then a push-in on an input card typing a command and prompt"+ - "AI tool demo where a command is typed into a card"+ - "show how to invoke a feature with a slash command and a prompt"+ - "launch beat moving from a statement to a close-up of typed input"---<ComponentPreview name="card-push-line" />diff --git a/content/docs/ui-blocks/caret-dolly.mdx b/content/docs/ui-blocks/caret-dolly.mdxindex cee5692d..17f7e8e9 100644--- a/content/docs/ui-blocks/caret-dolly.mdx+++ b/content/docs/ui-blocks/caret-dolly.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The prompt box should sit still with a slash command and an attachment tile — use `card-push-line`, the same prompt card with a push-in instead of a caret dolly."- "The text lives in a terminal rather than a prompt card — use `terminal-cursor-zoom`."- "A plain headline should type with no UI around it — use `typewriter`."+askedAs:+ - "camera following the text cursor"+ - "typing prompt with camera tracking"+ - "I want the camera to slide along the cursor while a request is typed"+ - "zoom into one phrase of a prompt as it is written"+ - "focus the viewer on the exact words typed into a prompt box"+ - "cinematic prompt typing where the frame travels with the blinking line"---<ComponentPreview name="caret-dolly" />diff --git a/content/docs/ui-blocks/check-list.mdx b/content/docs/ui-blocks/check-list.mdxindex d9201266..226a3fa9 100644--- a/content/docs/ui-blocks/check-list.mdx+++ b/content/docs/ui-blocks/check-list.mdx@@ -11,6 +11,13 @@ useWhen:avoidWhen:- "Labels need to wrap across lines, or the list needs numbering or nesting. One label, one line."- "The list should sit at an angle or wobble — this component has no jitter and no positioning. Wrap it in `paper-wobble`."+askedAs:+ - "handwritten to-do list"+ - "todo items ticked and crossed off"+ - "I want a hand-drawn checklist that writes itself and checks every item"+ - "show tasks getting completed with scribbled strikethroughs"+ - "productivity or planning product video where everything gets done"+ - "a satisfying finish where all boxes on a notebook list get ticked"---<ComponentPreview name="check-list" />diff --git a/content/docs/ui-blocks/code-morph.mdx b/content/docs/ui-blocks/code-morph.mdxindex f665a029..e0ca9800 100644--- a/content/docs/ui-blocks/code-morph.mdx+++ b/content/docs/ui-blocks/code-morph.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The code should simply appear line by line, with no before and after — use `glass-code-block`."- "The code should be typed out character by character — use `terminal-simulator` or `typewriter`."- "The camera should scan a long file while it reveals — use `glass-code-walk`."+askedAs:+ - "code diff animation"+ - "code changing between versions"+ - "I want a code snippet to transform into the updated version with tokens sliding"+ - "show a refactor or before after change in a source file"+ - "developer launch showing how little code changes between two versions"+ - "migration demo where old lines dissolve and new ones appear"---<ComponentPreview name="code-morph" />diff --git a/content/docs/ui-blocks/drop-upload.mdx b/content/docs/ui-blocks/drop-upload.mdxindex 9f5bb75c..be33f74e 100644--- a/content/docs/ui-blocks/drop-upload.mdx+++ b/content/docs/ui-blocks/drop-upload.mdx@@ -12,6 +12,13 @@ avoidWhen:- "Several files go in at once and each resolves in turn — use `multi-file-drop`."- "You need a full dropzone UI with a list of results — use `file-dropzone`."- "Only a progress bar filling is needed with no file — use `progress`."+askedAs:+ - "file upload animation"+ - "file dropped with progress bar"+ - "I want a document dragged into a dropzone, showing upload progress and a check"+ - "show uploading one file succeeded"+ - "demo that importing a file is simple and quick"+ - "moment confirming the attachment went through with a green tick"---<ComponentPreview name="drop-upload" />diff --git a/content/docs/ui-blocks/ghost-complete.mdx b/content/docs/ui-blocks/ghost-complete.mdxindex 38a8106d..6c008748 100644--- a/content/docs/ui-blocks/ghost-complete.mdx+++ b/content/docs/ui-blocks/ghost-complete.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The prompt goes to a chat, not an inline editor — use `ai-prompt-flow`."- "Plain typing with no suggestions is enough — use `typewriter`."- "You want a caret that swaps one phrase for another — use `caret-swap`."+askedAs:+ - "autocomplete suggestion typing"+ - "grey suggestion text accepted"+ - "I want text typed in an editor with faded predictions that fill in"+ - "copilot style inline completion demo"+ - "show an AI that finishes your sentences as you write"+ - "writing assistant scene where the viewer sees predictions turn real"---<ComponentPreview name="ghost-complete" />diff --git a/content/docs/ui-blocks/glass-code-block.mdx b/content/docs/ui-blocks/glass-code-block.mdxindex 34a2a772..a1e2e3bc 100644--- a/content/docs/ui-blocks/glass-code-block.mdx+++ b/content/docs/ui-blocks/glass-code-block.mdx@@ -10,6 +10,13 @@ useWhen:- "The backdrop must stay transparent so the panel composites over a custom background."avoidWhen:- "The scene requires the code to be visibly typed out character by character — use `terminal-simulator` or `typewriter` instead."+askedAs:+ - "frosted code editor window"+ - "glassmorphism code snippet"+ - "I want a premium translucent code panel with syntax colors revealing line by line"+ - "show a code sample on a sleek glass card"+ - "API or SDK launch that needs a beautiful snippet on screen"+ - "developer hero moment presenting the install or usage code"---<ComponentPreview name="glass-code-block" />diff --git a/content/docs/ui-blocks/glass-code-walk.mdx b/content/docs/ui-blocks/glass-code-walk.mdxindex 2eae3f01..3a0c7613 100644--- a/content/docs/ui-blocks/glass-code-walk.mdx+++ b/content/docs/ui-blocks/glass-code-walk.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The code panel should sit still in frame with no camera move — use `glass-code-block`, which this component wraps and animates."- "The point is code producing live UI side by side — use `live-code-compilation`, which types styles and applies them to a rendered button."- "The content is shell commands and output rather than a source file — use `terminal-simulator`, or `terminal-cursor-zoom` for the same camera treatment on a single command."+askedAs:+ - "camera scanning code top to bottom"+ - "code panel with camera move"+ - "I want the camera to travel down a glass code block as it types then pull back"+ - "long code snippet explored with a moving viewpoint"+ - "cinematic code demo that guides eyes across lines before settling"+ - "walkthrough of a source file with a cinematic scan and a final centered hold"---<ComponentPreview name="glass-code-walk" />diff --git a/content/docs/ui-blocks/glow-born-card.mdx b/content/docs/ui-blocks/glow-born-card.mdxindex 9539b42b..1b21697c 100644--- a/content/docs/ui-blocks/glow-born-card.mdx+++ b/content/docs/ui-blocks/glow-born-card.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The dialog should simply appear inside a live UI flow — use `dialog`."- "You want a multi-step sign-up with several screens — use `signup-flow`."- "A file is the thing being added, not a text field — use `drop-upload`."+askedAs:+ - "glow becomes dialog card"+ - "import dialog appearing from light"+ - "I want a soft glow that condenses into a dialog with a typed field and confirm button"+ - "modal born from a light bloom beside a split headline"+ - "show a connect or import step with a magical entrance"+ - "feature beat where a card materializes and then a user fills it in"---<ComponentPreview name="glow-born-card" />diff --git a/content/docs/ui-blocks/keycap-press.mdx b/content/docs/ui-blocks/keycap-press.mdxindex 0889fa62..1c8d98fe 100644--- a/content/docs/ui-blocks/keycap-press.mdx+++ b/content/docs/ui-blocks/keycap-press.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You only need typed key labels appearing as text — use `keystroke`."- "The shortcut opens a palette you want to show in full — use `command-menu`."- "A button being clicked by a pointer is the story — use `button`."+askedAs:+ - "keyboard shortcut keys pressed"+ - "3D keycaps pressing"+ - "I want keys rising in 3D and pushing down for a shortcut like Cmd K"+ - "show a hotkey combination with physical keyboard buttons"+ - "teach viewers the shortcut that triggers a feature"+ - "productivity tool beat with a keyboard combo and a caption below"---<ComponentPreview name="keycap-press" />diff --git a/content/docs/ui-blocks/launch-days.mdx b/content/docs/ui-blocks/launch-days.mdxindex a859744f..63cbb6ac 100644--- a/content/docs/ui-blocks/launch-days.mdx+++ b/content/docs/ui-blocks/launch-days.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You are listing release notes as a scrolling feed — use `changelog-scroll`."- "The beat is about one date, not a week — use `launch-date`."- "You only need three feature headings side by side — use `feature-trio`."+askedAs:+ - "launch week day panels"+ - "day by day launch schedule"+ - "I want a strip of days and one expanding into a big numbered card"+ - "launch week announcement where Day 1 is spotlighted with its feature"+ - "countdown or calendar of releases, one day opened for details"+ - "tease a multi-day product release with each day as a panel"---<ComponentPreview name="launch-days" />diff --git a/content/docs/ui-blocks/macro-tab-name.mdx b/content/docs/ui-blocks/macro-tab-name.mdxindex afd78973..dc185cbf 100644--- a/content/docs/ui-blocks/macro-tab-name.mdx+++ b/content/docs/ui-blocks/macro-tab-name.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You need a full browser window with an address bar and page content — use `url-bar-cta`."- "The point is a big typed headline, not a UI chip — use `typewriter`."- "You only need a pointer gliding and clicking on your own UI — use `simulated-cursor`."+askedAs:+ - "close-up of browser tab typing"+ - "tab title typed in macro"+ - "I want an extreme close-up of a tab where a cursor clicks and the name appears"+ - "naming a document or project in a tab"+ - "tiny detail shot of creating a new page and titling it"+ - "macro UI beat showing the project name being entered in a tab"---<ComponentPreview name="macro-tab-name" />diff --git a/content/docs/ui-blocks/menu-pick.mdx b/content/docs/ui-blocks/menu-pick.mdxindex 361159f7..fa0c56ad 100644--- a/content/docs/ui-blocks/menu-pick.mdx+++ b/content/docs/ui-blocks/menu-pick.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a real dropdown opening from a button — use `dropdown-menu`."- "The menu is a searchable command palette — use `command-menu`."- "You only need a segmented switch between views — use `toggle-group`."+askedAs:+ - "video game menu selection"+ - "red selection bar hopping rows"+ - "I want a retro game style menu where a highlight jumps and lands on one option"+ - "choose between options in an arcade-like list"+ - "fun way to reveal the selected plan or choice among several"+ - "pick-your-character style moment ending on the chosen entry"---<ComponentPreview name="menu-pick" />diff --git a/content/docs/ui-blocks/multi-file-drop.mdx b/content/docs/ui-blocks/multi-file-drop.mdxindex e8fd0a3e..1b2d81ff 100644--- a/content/docs/ui-blocks/multi-file-drop.mdx+++ b/content/docs/ui-blocks/multi-file-drop.mdx@@ -12,6 +12,13 @@ avoidWhen:- "Only one file is involved and you want a progress bar and confirmation — use `drop-upload`."- "There are no attachments, just a prompt being typed — use `caret-dolly`."- "You are showing a generic upload area rather than a prompt box — use `file-dropzone`."+askedAs:+ - "many files dropped into prompt"+ - "attachments flying into chat box"+ - "I want a bunch of files flying into an AI prompt box then pressing send"+ - "drag several documents in and upload them all"+ - "show an assistant that accepts many attachments at once"+ - "demo of dropping a pile of files, each landing in a slot before sending"---<ComponentPreview name="multi-file-drop" />diff --git a/content/docs/ui-blocks/paper-sticker.mdx b/content/docs/ui-blocks/paper-sticker.mdxindex 37e78f56..2732f04f 100644--- a/content/docs/ui-blocks/paper-sticker.mdx+++ b/content/docs/ui-blocks/paper-sticker.mdx@@ -11,6 +11,13 @@ avoidWhen:- "The content is long text or looks like interactive UI — this is a paper prop, not a component sim."- "You need a media frame with a caption underneath — use `polaroid`."- "You were going to add `paper-wobble` on top: the wobble is already here."+askedAs:+ - "taped paper sticker slap"+ - "stop-motion paper label"+ - "I want a handmade paper tag slapped onto the screen with tape"+ - "craft style sticker note that pops over the scene"+ - "scrapbook feel callout stuck onto a shot"+ - "playful label added on top of a video with a stop-motion wobble"---<ComponentPreview name="paper-sticker" />diff --git a/content/docs/ui-blocks/pill-morph.mdx b/content/docs/ui-blocks/pill-morph.mdxindex 2d6f003c..c93a06d4 100644--- a/content/docs/ui-blocks/pill-morph.mdx+++ b/content/docs/ui-blocks/pill-morph.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You only need a brand mark revealing — use `logo-enter`."- "The transform should carry the video between two scenes — use `gooey-morph`."- "More than three features need showing as cards — use `bento-build`."+askedAs:+ - "logo pill expands into card"+ - "small pill transforms into app tile"+ - "I want a tiny brand pill growing into a product card then splitting into feature pills"+ - "shape morphing story from logo to features to app icon"+ - "Dynamic Island style expansion in a product intro"+ - "fluid shape-shift sequence showing a product unfolding into its parts"---<ComponentPreview name="pill-morph" />diff --git a/content/docs/ui-blocks/polaroid.mdx b/content/docs/ui-blocks/polaroid.mdxindex d3c1ccb7..98f57603 100644--- a/content/docs/ui-blocks/polaroid.mdx+++ b/content/docs/ui-blocks/polaroid.mdx@@ -11,6 +11,13 @@ useWhen:avoidWhen:- "You just need a plain rounded video frame with no paper story — use `backdrop` with padding."- "The card needs to wobble or sit at an angle: this component has no jitter and no positioning. Wrap it in `paper-wobble` and place it yourself."+askedAs:+ - "instant photo frame"+ - "polaroid picture with caption"+ - "I want a photo or clip inside a white instant camera frame with handwritten text"+ - "nostalgic snapshot look for a video clip"+ - "memory or team moment shown as a printed photo"+ - "scrapbook style image card with a handwritten note"---<ComponentPreview name="polaroid" />diff --git a/content/docs/ui-blocks/query-cascade.mdx b/content/docs/ui-blocks/query-cascade.mdxindex fc1975d9..f3070dd2 100644--- a/content/docs/ui-blocks/query-cascade.mdx+++ b/content/docs/ui-blocks/query-cascade.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The answer should come with cited sources — use `ai-answer-sources`."- "A search pill should type and reveal a graphic panel — use `search-reveal`."- "You want a smooth feed scroll on a phone — use `phone-scroll`."+askedAs:+ - "search queries blur past"+ - "many searches then one answer"+ - "I want a stream of questions flying by until one lands in a search box and gets answered"+ - "people ask everything and we answer it"+ - "show the huge variety of questions a search or AI tool handles"+ - "intro where a flood of queries narrows to a single result"---<ComponentPreview name="query-cascade" />diff --git a/content/docs/ui-blocks/reel.mdx b/content/docs/ui-blocks/reel.mdxindex 655f5f2b..1fccd25a 100644--- a/content/docs/ui-blocks/reel.mdx+++ b/content/docs/ui-blocks/reel.mdx@@ -11,6 +11,13 @@ useWhen:avoidWhen:- "You need a single framed photo rather than a sequence — use `polaroid` instead."- "You want a scrolling wall of items rather than a stacked reveal — use `infinite-marquee` or `perspective-marquee` instead."+askedAs:+ - "image stack blooming open"+ - "photos expanding over each other"+ - "I want pictures layering on top of one another, each opening over the last"+ - "centered card cycling through a series of screenshots or shots"+ - "showcase slideshow of visuals stacking in depth"+ - "gallery beat where each new image unfolds and covers the previous one"---<ComponentPreview name="reel" />diff --git a/content/docs/ui-blocks/rim-draw-card.mdx b/content/docs/ui-blocks/rim-draw-card.mdxindex 08d61fd1..d5d5cf84 100644--- a/content/docs/ui-blocks/rim-draw-card.mdx+++ b/content/docs/ui-blocks/rim-draw-card.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The card is already on screen and you only want a light orbiting its edge — use `border-beam`."- "You need a full multi-screen settings flow with toggles — use `settings-toggle-flow`."- "A plain modal opening is enough — use `dialog`."+askedAs:+ - "light tracing card outline"+ - "outline drawn then card filled"+ - "I want a glowing line drawing a card's edge before it shows a command and a save click"+ - "card appearing by having its border sketched in light"+ - "settings or config card entrance that feels crafted"+ - "show a quick setup step where a card is outlined, filled in and saved"---<ComponentPreview name="rim-draw-card" />diff --git a/content/docs/ui-blocks/rotary-dial.mdx b/content/docs/ui-blocks/rotary-dial.mdxindex 5fabaff6..dbe8b96b 100644--- a/content/docs/ui-blocks/rotary-dial.mdx+++ b/content/docs/ui-blocks/rotary-dial.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The number should just roll up without a control — use `rolling-number`."- "You want a flat UI slider rather than a physical knob — use `slider`."- "A boolean on and off is the point — use `toggle-on`."+askedAs:+ - "turning knob dial"+ - "physical knob value counting up"+ - "I want a metal knob that gets turned while a number rises and clicks into place"+ - "hardware style control adjusting a value"+ - "audio gear or precision tool vibe for a setting being dialed in"+ - "satisfying moment of cranking a dial to the final setting"---<ComponentPreview name="rotary-dial" />diff --git a/content/docs/ui-blocks/search-reveal.mdx b/content/docs/ui-blocks/search-reveal.mdxindex df883310..40f5503a 100644--- a/content/docs/ui-blocks/search-reveal.mdx+++ b/content/docs/ui-blocks/search-reveal.mdx@@ -12,6 +12,13 @@ avoidWhen:- "Words should fly and morph between phrases — use `kinetic-morph-text`."- "The opening should stay entirely abstract — use `radial-burst`."- "Typing should resemble a command-line session — use `terminal-simulator`."+askedAs:+ - "circles expand into search bar"+ - "search field typing product name"+ - "abstract circles growing into a search box that types our product name"+ - "opening that moves from shapes to a search query"+ - "brand discovery moment when someone googles your name"+ - "product intro starting abstract then landing on a typed search"---<ComponentPreview name="search-reveal" />diff --git a/content/docs/ui-blocks/terminal-cursor-zoom.mdx b/content/docs/ui-blocks/terminal-cursor-zoom.mdxindex bcb1628c..838f6ffc 100644--- a/content/docs/ui-blocks/terminal-cursor-zoom.mdx+++ b/content/docs/ui-blocks/terminal-cursor-zoom.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The session has multiple lines, logs, or success output — use `terminal-simulator`; this component types exactly one command line and the camera never leaves it."- "The terminal window should stay statically framed — use `terminal-simulator` on its own, since this is only a camera rig around it."- "The content is source code in an editor rather than a shell command — use `glass-code-walk` for the same tracking camera over a code panel."+askedAs:+ - "zoomed terminal typing one command"+ - "camera on the terminal cursor"+ - "I want a close-up on a command line typing a single install command"+ - "dolly along a typed shell command at high zoom"+ - "hero shot of npx or npm command being typed"+ - "developer CTA showing the one command to get started in tight focus"---<ComponentPreview name="terminal-cursor-zoom" />diff --git a/content/docs/ui-blocks/terminal-simulator.mdx b/content/docs/ui-blocks/terminal-simulator.mdxindex cf58ee22..abd9ebad 100644--- a/content/docs/ui-blocks/terminal-simulator.mdx+++ b/content/docs/ui-blocks/terminal-simulator.mdx@@ -11,6 +11,13 @@ useWhen:avoidWhen:- "You only need to type a single short string — use `typewriter` instead, which is lighter and pairs with any layout."- "The code should be displayed as a formatted, highlighted editor window — use `glass-code-block` instead."+askedAs:+ - "command line session"+ - "terminal typing commands with output"+ - "I want a console showing several commands and scrolling log output"+ - "fake shell window with lines rolling off the top"+ - "CLI tool demo showing a build, install and success messages"+ - "developer video moment that shows what running the tool looks like"---<ComponentPreview name="terminal-simulator" />diff --git a/content/docs/ui-blocks/toggle-on.mdx b/content/docs/ui-blocks/toggle-on.mdxindex 20ad8590..3e7965ca 100644--- a/content/docs/ui-blocks/toggle-on.mdx+++ b/content/docs/ui-blocks/toggle-on.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The toggle is part of a real settings screen with several rows — use `settings-toggle-flow`."- "You want a small switch inside a live UI rather than a hero object — use `switch`."- "The value is a number that turns up, not a boolean — use `rotary-dial`."+askedAs:+ - "big switch flipping on"+ - "light up stage with toggle"+ - "I want a large toggle that switches on and the scene lights up with the feature name"+ - "show a feature being enabled with a dramatic switch"+ - "simple one-click enable moment for a setting or mode"+ - "dark to lit transition triggered by turning something on"---<ComponentPreview name="toggle-on" />diff --git a/content/docs/ui-blocks/toolbar-unfurl.mdx b/content/docs/ui-blocks/toolbar-unfurl.mdxindex 0cccac82..29a88fc3 100644--- a/content/docs/ui-blocks/toolbar-unfurl.mdx+++ b/content/docs/ui-blocks/toolbar-unfurl.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You are presenting more than four features or want them as cards in a grid — use `bento-build`."- "Only one control flips state and you want the whole stage to react — use `toggle-on`."- "The beat is a typed prompt rather than a tool strip — use `caret-dolly`."+askedAs:+ - "round button unfolds into tools"+ - "tool strip expanding"+ - "I want a circular button that opens into four tools with captions for each"+ - "floating action menu expanding to show features"+ - "presenting a handful of tools one by one from a single tap"+ - "moment explaining a compact toolkit unfurling from a button"---<ComponentPreview name="toolbar-unfurl" />diff --git a/content/docs/ui-blocks/ui-callout.mdx b/content/docs/ui-blocks/ui-callout.mdxindex fd9e6be7..73550a0f 100644--- a/content/docs/ui-blocks/ui-callout.mdx+++ b/content/docs/ui-blocks/ui-callout.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The camera should travel into each region instead of annotating — use `screenshot-tour`."- "A single detail needs a framed highlight — use `bracket-focus`."- "You want a live tooltip inside a UI flow — use `tooltip`."+askedAs:+ - "annotated screenshot callouts"+ - "labels pointing at screenshot"+ - "I want note cards appearing beside a product screenshot with pulsing dots on features"+ - "explain parts of an interface with pins and captions"+ - "highlight key areas of the app one at a time"+ - "walkthrough slide labeling what each region of the UI does"---<ComponentPreview name="ui-callout" />diff --git a/content/docs/ui-blocks/url-bar-cta.mdx b/content/docs/ui-blocks/url-bar-cta.mdxindex fe014ebc..0de9fba5 100644--- a/content/docs/ui-blocks/url-bar-cta.mdx+++ b/content/docs/ui-blocks/url-bar-cta.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You only need an address-like search pill that types and reveals a panel — use `search-reveal`."- "The destination is a mobile app listing, not a web page — use `app-store-listing`."- "You want to tour inside an existing page screenshot — use `screenshot-tour`."+askedAs:+ - "browser address bar typing"+ - "type website then page loads"+ - "I want a URL typed into a browser, then the landing page loading in"+ - "closing call to action telling people the website address"+ - "show a visit this site moment with a browser window docking in"+ - "outro that sends viewers to the domain with a full browser mockup"---<ComponentPreview name="url-bar-cta" />diff --git a/content/docs/ui/blocks/ai-prompt-flow.mdx b/content/docs/ui/blocks/ai-prompt-flow.mdxindex aada86a5..0adb7d0a 100644--- a/content/docs/ui/blocks/ai-prompt-flow.mdx+++ b/content/docs/ui/blocks/ai-prompt-flow.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You only need a button press with a loading state — use `button` with `state=\"loading\"`"- "You only need a field that types — use `input` directly"- "You need custom orchestration or step control across scenes — compose the primitives manually"+askedAs:+ - "AI prompt to answer demo"+ - "type prompt and get response"+ - "I want a prompt typed, a run button loading, then the answer appearing"+ - "ChatGPT style generation scene with skeleton then result"+ - "show an AI tool turning a request into output from start to finish"+ - "full assistant interaction showing wait time and a crossfaded answer"---<BlockPreview name="ai-prompt-flow" />diff --git a/content/docs/ui/blocks/chat-flow.mdx b/content/docs/ui/blocks/chat-flow.mdxindex 2010154b..edd8d74a 100644--- a/content/docs/ui/blocks/chat-flow.mdx+++ b/content/docs/ui/blocks/chat-flow.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The video must read as Telegram — use `telegram-chat-flow`, which owns the tailed bubbles, in-bubble timestamps, and double-check marks."- "The video must read as iMessage — use `imessage-chat-flow`, which owns the gray/blue tailed bubbles, the Delivered label, and tapback badges."- "You only need one message landing on a beat you time yourself — use `message-bubble` with `useMessageBubbleTransition`."+askedAs:+ - "messaging conversation animation"+ - "chat bubbles with typing dots"+ - "I want a text conversation with replies popping in and reactions"+ - "WhatsApp style chat demo for a messaging app"+ - "show customers or teammates talking with a typing indicator"+ - "dialogue scene to illustrate a support or social conversation"---<BlockPreview name="chat-flow" />diff --git a/content/docs/ui/blocks/checkout-flow.mdx b/content/docs/ui/blocks/checkout-flow.mdxindex 083672eb..83a058d1 100644--- a/content/docs/ui/blocks/checkout-flow.mdx+++ b/content/docs/ui/blocks/checkout-flow.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You only need a payment form without cursor animation — compose `field`, `input`, `button` manually."- "The flow is a multi-step onboarding (not payment) — use `onboarding-stepper-flow` instead."- "You need custom timing control over individual steps — orchestrate the primitives directly."+askedAs:+ - "checkout payment animation"+ - "pay with card form demo"+ - "I want a cursor choosing a pricing plan, typing card details and confirming payment"+ - "Stripe style purchase flow"+ - "show how easy it is to buy or subscribe"+ - "payment success moment with terms checkbox and confirmation"---<BlockPreview name="checkout-flow" />diff --git a/content/docs/ui/blocks/imessage-chat-flow.mdx b/content/docs/ui/blocks/imessage-chat-flow.mdxindex 01b96238..0d461125 100644--- a/content/docs/ui/blocks/imessage-chat-flow.mdx+++ b/content/docs/ui/blocks/imessage-chat-flow.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The scene must read as Telegram — use `telegram-chat-flow` for in-bubble timestamps, double-check marks, and reaction chips."- "The thread has to follow your brand tokens — use `chat-flow`; this block's palette is a fixed iMessage skin apart from `accentColor`."- "You only need the bouncing dots on their own — use `typing-indicator`, which this block composes."+askedAs:+ - "iMessage conversation"+ - "blue bubble text messages"+ - "I want an Apple Messages thread with blue sent bubbles and a Delivered label"+ - "iPhone texting scene with tapback hearts"+ - "show a text exchange that looks like iOS Messages"+ - "messaging story for an Apple audience with typing dots and reactions"---<BlockPreview name="imessage-chat-flow" />diff --git a/content/docs/ui/blocks/onboarding-stepper-flow.mdx b/content/docs/ui/blocks/onboarding-stepper-flow.mdxindex ebb436a8..5d8ac46c 100644--- a/content/docs/ui/blocks/onboarding-stepper-flow.mdx+++ b/content/docs/ui/blocks/onboarding-stepper-flow.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The flow is a payment checkout — use `checkout-flow`, which is cursor-driven with card entry and a toast"- "It is a single account sign-up (email and password, then success) — use `signup-flow`"- "You need custom panel content like images or code blocks — the panels render fixed primitives, so orchestrate manually"+askedAs:+ - "multi-step onboarding wizard"+ - "setup steps with progress"+ - "I want a stepper moving through form panels to a success screen"+ - "show signing up and configuring an app in several steps"+ - "welcome flow for new users completing setup"+ - "guided first-run experience ending on a congratulations state"---<BlockPreview name="onboarding-stepper-flow" />diff --git a/content/docs/ui/blocks/settings-toggle-flow.mdx b/content/docs/ui/blocks/settings-toggle-flow.mdxindex 7dcecb52..08388ffa 100644--- a/content/docs/ui/blocks/settings-toggle-flow.mdx+++ b/content/docs/ui/blocks/settings-toggle-flow.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You need only one control type — use `switch`, `select`, or `slider` individually instead."- "Your settings layout differs from the default two-column card — compose primitives manually for full control."- "You need custom cursor timing or interaction order — wire `cursor` directly with individual primitives instead."+askedAs:+ - "settings panel with switches"+ - "preferences card cursor clicking"+ - "a settings screen where a cursor flips a switch, picks a value, moves a slider, saves"+ - "show customization options of an app"+ - "configuration scene proving the product is flexible"+ - "account preferences demo with save button at the end"---<BlockPreview name="settings-toggle-flow" />diff --git a/content/docs/ui/blocks/signup-flow.mdx b/content/docs/ui/blocks/signup-flow.mdxindex 3c070a09..d22b04c4 100644--- a/content/docs/ui/blocks/signup-flow.mdx+++ b/content/docs/ui/blocks/signup-flow.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You need a generic form with custom fields — compose `input` + `button` + `cursor` manually instead."- "You only need the success notification — use `toast` directly."- "You need a settings interaction walkthrough — use `settings-toggle-flow` instead."+askedAs:+ - "sign up form filling"+ - "registration card animation"+ - "I want fields filling top to bottom and the form submitting with success"+ - "create account demo with a cursor"+ - "show how quickly someone can join"+ - "new user registration with a confirmation at the end"---<BlockPreview name="signup-flow" />diff --git a/content/docs/ui/blocks/telegram-chat-flow.mdx b/content/docs/ui/blocks/telegram-chat-flow.mdxindex 95362242..d7077d4d 100644--- a/content/docs/ui/blocks/telegram-chat-flow.mdx+++ b/content/docs/ui/blocks/telegram-chat-flow.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The scene must read as iMessage — use `imessage-chat-flow` for gray incoming bubbles, the Delivered label, and tapback badges."- "The conversation has to follow your brand tokens — use `chat-flow`; this block's chrome is a fixed light Telegram skin and only `accentColor` is overridable."- "You only need a single bubble or the dots on their own — use `message-bubble` or `typing-indicator`."+askedAs:+ - "Telegram conversation"+ - "Telegram chat bubbles with checks"+ - "I want a Telegram style chat with tailed bubbles and double check marks"+ - "bot or channel demo in a Telegram look"+ - "show a messenger thread with delivery ticks and reaction chips"+ - "chat scene for a crypto or bot product that lives on Telegram"---<BlockPreview name="telegram-chat-flow" />diff --git a/content/docs/ui/components/accordion.mdx b/content/docs/ui/components/accordion.mdxindex a20b3ce9..b5a523ee 100644--- a/content/docs/ui/components/accordion.mdx+++ b/content/docs/ui/components/accordion.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The content is always visible — there is no collapse state; lay it out statically instead."- "You need a flyout triggered from a button — use `dropdown-menu` instead."- "The reveal wraps arbitrary JSX children rather than a string — use `blur-in` to wrap any node."+askedAs:+ - "accordion"+ - "expanding FAQ panel"+ - "collapsible section opening and closing"+ - "show an FAQ item expanding to reveal its answer"+ - "reveal hidden details in a collapse panel during a UI demo"+ - "expand and collapse content to explain a feature step"---<UiComponentPreview name="accordion" />diff --git a/content/docs/ui/components/alert-dialog.mdx b/content/docs/ui/components/alert-dialog.mdxindex 035293cf..c06a90aa 100644--- a/content/docs/ui/components/alert-dialog.mdx+++ b/content/docs/ui/components/alert-dialog.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The action is non-destructive or form-based — use `dialog` instead."- "You need a non-modal contextual overlay — use `dropdown-menu` or `context-menu` instead."- "The overlay should slide from the bottom edge — use `drawer` instead."+askedAs:+ - "alert dialog"+ - "confirm delete popup"+ - "I want a warning modal asking are you sure before a destructive action"+ - "show a confirmation prompt blocking the screen"+ - "demo of a safety check that prevents accidental data loss"+ - "modal that interrupts the user with cancel and confirm buttons"---<UiComponentPreview name="alert-dialog" />diff --git a/content/docs/ui/components/blur-in.mdx b/content/docs/ui/components/blur-in.mdxindex a77cf196..d186b8dd 100644--- a/content/docs/ui/components/blur-in.mdx+++ b/content/docs/ui/components/blur-in.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You're animating a text-only line — use a purpose-built text reveal (`soft-blur-in`, `staggered-fade-up`) instead of wrapping raw text."- "The child is a remocn-ui primitive that already exposes a `state` prop with its own entrance — animate via `state` directly."- "You need a full-opacity slide with no blur — use the component's own directional offset or a translation interpolation."+askedAs:+ - "blur in wrapper"+ - "fade from blur"+ - "I want any element to appear from blurry with a slight slide"+ - "soft focus entrance for an image or card"+ - "gentle reveal of a screenshot coming into focus"+ - "smooth entrance for a block that starts hazy and sharpens"---<UiComponentPreview name="blur-in" />diff --git a/content/docs/ui/components/button.mdx b/content/docs/ui/components/button.mdxindex f0e85379..9d1ad6d3 100644--- a/content/docs/ui/components/button.mdx+++ b/content/docs/ui/components/button.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You need a selectable row inside a menu — use `dropdown-menu-item` or `command-menu-item` instead."- "The button must open a searchable dropdown — use `combobox` (which uses an input trigger) instead."- "You only need a static label with no interactive state — render plain text in the composition."+askedAs:+ - "button"+ - "button click animation"+ - "I want a CTA button that shows hover, press and loading states"+ - "show a button being pressed and processing"+ - "UI beat highlighting the main call to action"+ - "submit button demo with loading spinner and done state"---<UiComponentPreview name="button" />diff --git a/content/docs/ui/components/caret.mdx b/content/docs/ui/components/caret.mdxindex 2a8dbb12..dea6741b 100644--- a/content/docs/ui/components/caret.mdx+++ b/content/docs/ui/components/caret.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You need the full input UX (focus ring, border, value reveal) — use `input` instead, which owns its own caret."- "The typewriter effect is needed — use `typewriter`, which composes `caret` internally."- "You need a text selection highlight rather than an insertion point."+askedAs:+ - "text caret"+ - "blinking cursor line"+ - "I want a flashing text insertion bar"+ - "typing cursor blink for text effects"+ - "small blinking bar placed after typed text"+ - "add the vertical line that blinks at the end of a typewriter line"---<ComponentPreview name="caret" />diff --git a/content/docs/ui/components/checkbox.mdx b/content/docs/ui/components/checkbox.mdxindex 08ed95ac..c9f2dce7 100644--- a/content/docs/ui/components/checkbox.mdx+++ b/content/docs/ui/components/checkbox.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The choice is mutually exclusive within a group — use `radio` instead."- "You need a toggle switch metaphor — use `switch` instead."- "The user picks one option from a long or searchable list — use `combobox` instead (a checkbox group already is the multi-select metaphor)."+askedAs:+ - "checkbox"+ - "tick box check animation"+ - "I want a checkbox getting checked in a form"+ - "show a terms agreement box being ticked"+ - "UI demo of selecting options with square boxes"+ - "checked and unchecked state transitions for a form item"---<UiComponentPreview name="checkbox" />diff --git a/content/docs/ui/components/combobox.mdx b/content/docs/ui/components/combobox.mdxindex 22d44c8d..1e1c7e5d 100644--- a/content/docs/ui/components/combobox.mdx+++ b/content/docs/ui/components/combobox.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The list is not filterable and selection is direct — use `select` (non-filterable dropdown) instead."- "The overlay is a command palette with icons and keyboard shortcuts — use `command-menu` instead."- "The input is free-form text entry with no list — use `input` instead."+askedAs:+ - "combobox"+ - "searchable dropdown"+ - "autocomplete select with typed filter"+ - "I want a dropdown where someone types to filter and picks a result"+ - "demo of finding an option in a long list by typing"+ - "show a type-ahead field narrowing choices then selecting one"---<UiComponentPreview name="combobox" />diff --git a/content/docs/ui/components/command-menu.mdx b/content/docs/ui/components/command-menu.mdxindex 5666b85c..cb332084 100644--- a/content/docs/ui/components/command-menu.mdx+++ b/content/docs/ui/components/command-menu.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The list has no icons or keyboard shortcuts and is triggered from a button — use `dropdown-menu` instead."- "The overlay is a right-click contextual menu — use `context-menu` instead."- "You only need a filterable input without a modal overlay — use `combobox` instead."+askedAs:+ - "command palette"+ - "Cmd K menu"+ - "spotlight style search launcher"+ - "I want a keyboard-driven palette opening, typing and picking an action"+ - "show power-user quick actions in Raycast or Linear style"+ - "productivity app demo of jumping anywhere using a shortcut menu"---<UiComponentPreview name="command-menu" />diff --git a/content/docs/ui/components/context-menu.mdx b/content/docs/ui/components/context-menu.mdxindex 2c249123..5fb5f1cb 100644--- a/content/docs/ui/components/context-menu.mdx+++ b/content/docs/ui/components/context-menu.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The menu is triggered from a button in the UI — use `dropdown-menu` instead."- "The overlay is a searchable command palette — use `command-menu` instead."- "The overlay is a modal that blocks the rest of the scene — use `dialog` or `alert-dialog` instead."+askedAs:+ - "context menu"+ - "right-click menu"+ - "menu opening at the pointer location"+ - "I want a right-click popup listing actions on an item"+ - "show hidden options revealed by right clicking"+ - "demo of secondary actions in a file or row menu"---<UiComponentPreview name="context-menu" />diff --git a/content/docs/ui/components/cursor.mdx b/content/docs/ui/components/cursor.mdxindex fd8fb370..13ac374d 100644--- a/content/docs/ui/components/cursor.mdx+++ b/content/docs/ui/components/cursor.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You need a blinking text insertion cursor — use `caret` instead."- "There is no interaction to demonstrate and the cursor would be visual noise."- "You need a crosshair or custom SVG cursor — the variant set is `arrow` / `pointer`; extend or render custom SVG directly."+askedAs:+ - "mouse cursor"+ - "animated pointer clicking"+ - "I want a pointer moving along a path and clicking with a ripple"+ - "show a user clicking through the interface"+ - "guide attention to a UI target with a moving arrow"+ - "click demo with press effect at the destination"---<UiComponentPreview name="cursor" />diff --git a/content/docs/ui/components/dialog.mdx b/content/docs/ui/components/dialog.mdxindex 98e65c1d..a92736c5 100644--- a/content/docs/ui/components/dialog.mdx+++ b/content/docs/ui/components/dialog.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The action is irreversible or destructive — use `alert-dialog` instead."- "The panel should slide from the bottom edge — use `drawer` instead."- "The overlay is non-modal and contextual — use `dropdown-menu` or `context-menu` instead."+askedAs:+ - "dialog"+ - "modal popup"+ - "I want a centered modal window opening over the page"+ - "show a popup with a form or message appearing and closing"+ - "UI scene with an overlay card that blocks the background"+ - "non-destructive modal for settings or invites"---<UiComponentPreview name="dialog" />diff --git a/content/docs/ui/components/drawer.mdx b/content/docs/ui/components/drawer.mdxindex 04596c62..614e371c 100644--- a/content/docs/ui/components/drawer.mdx+++ b/content/docs/ui/components/drawer.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The overlay should be a centered modal — use `dialog` instead."- "The action is destructive and needs an explicit confirmation — use `alert-dialog` instead."- "The overlay is non-modal and contextual — use `dropdown-menu` or `context-menu` instead."+askedAs:+ - "drawer"+ - "bottom sheet panel"+ - "mobile panel sliding up from the bottom"+ - "I want a tray rising from the bottom edge with options"+ - "show a mobile action sheet opening in an app demo"+ - "slide-up panel revealing details over the screen"---<UiComponentPreview name="drawer" />diff --git a/content/docs/ui/components/dropdown-menu.mdx b/content/docs/ui/components/dropdown-menu.mdxindex 1e2447f1..3da2a8b1 100644--- a/content/docs/ui/components/dropdown-menu.mdx+++ b/content/docs/ui/components/dropdown-menu.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The menu is invoked by right-click at a cursor position — use `context-menu` instead."- "The list is searchable or filterable — use `combobox` instead."- "The overlay is a modal that blocks the scene — use `dialog` or `alert-dialog` instead."+askedAs:+ - "dropdown menu"+ - "menu opening from button"+ - "I want a button that opens a list of actions below it"+ - "show a profile or more menu popping down"+ - "demo of choosing an action from a trigger menu"+ - "options list dropping from a toolbar button with rows"---<UiComponentPreview name="dropdown-menu" />diff --git a/content/docs/ui/components/field.mdx b/content/docs/ui/components/field.mdxindex db327226..91b18d11 100644--- a/content/docs/ui/components/field.mdx+++ b/content/docs/ui/components/field.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You need the control itself to animate — `field` is layout only; put `input` or `button` inside it"- "There is a single unlabeled control — use the primitive directly"- "The layout is horizontal or a grid — `FieldGroup` only stacks vertically"+askedAs:+ - "form field layout"+ - "label and input wrapper"+ - "I want a labeled form row with consistent spacing"+ - "stack several fields neatly in a form scene"+ - "layout container for labels, inputs and helper text"+ - "static arrangement for composing a form without animation"---A static layout family for composing labeled form controls, modeled on shadcn's Field. It reads nodiff --git a/content/docs/ui/components/input.mdx b/content/docs/ui/components/input.mdxindex 23eaed8f..3f7a6bdb 100644--- a/content/docs/ui/components/input.mdx+++ b/content/docs/ui/components/input.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The trigger needs to open a searchable list — use `combobox` instead (which wraps input internally)."- "You only need a blinking cursor with no field chrome — use `caret` instead."- "The control is a button-style CTA, not a text entry — use `button` instead."+askedAs:+ - "text input"+ - "input field typing"+ - "I want a text box showing focus and typed value"+ - "show a form field being filled in"+ - "UI demo of entering an email or name"+ - "input with focus ring, placeholder and typed content over time"---<UiComponentPreview name="input" />diff --git a/content/docs/ui/components/message-bubble.mdx b/content/docs/ui/components/message-bubble.mdxindex 5837f1a7..65eb30e5 100644--- a/content/docs/ui/components/message-bubble.mdx+++ b/content/docs/ui/components/message-bubble.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want a whole scripted conversation with a composer, typing beats, and reactions — use `chat-flow`, which schedules bubbles for you."- "The bubble must read as a specific messenger with a tail, timestamp, or tapback — use `telegram-chat-flow` or `imessage-chat-flow`, which own those bubble shapes."- "You need the bouncing dots themselves rather than the container around them — use `typing-indicator`."+askedAs:+ - "chat bubble"+ - "single speech bubble"+ - "I want one message balloon, sent or received, maybe with a reaction"+ - "standalone text message element"+ - "show a lone incoming or outgoing message in a layout"+ - "bubble component to build your own conversation layout"---<UiComponentPreview name="message-bubble" />diff --git a/content/docs/ui/components/popover.mdx b/content/docs/ui/components/popover.mdxindex c116de20..0a8c55dc 100644--- a/content/docs/ui/components/popover.mdx+++ b/content/docs/ui/components/popover.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You only need a single-line label — use `tooltip` instead (lighter, no title/description structure)."- "You need a persistent side panel with a close button and action — use `sheet` instead."- "The overlay needs full blocking modal behavior — use `alert-dialog` instead."+askedAs:+ - "popover"+ - "floating info card"+ - "I want a card popping up beside a button with a title and description"+ - "show a detail panel anchored to an element"+ - "hover or click revealing richer content near its target"+ - "contextual overlay with text and extra content next to an icon"---<UiComponentPreview name="popover" />diff --git a/content/docs/ui/components/progress.mdx b/content/docs/ui/components/progress.mdxindex bb3ddbc8..3f60e4db 100644--- a/content/docs/ui/components/progress.mdx+++ b/content/docs/ui/components/progress.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The state is binary (done/not done) — use `switch` instead."- "You need segmented, numbered step-by-step progress — use `stepper` instead (connectors + check marks)."- "You need a range input the user can drag — use `slider` instead (thumb + grab-ring interaction)."+askedAs:+ - "progress bar"+ - "loading bar filling"+ - "I want a bar that fills to a percentage"+ - "show upload or install completion progressing"+ - "indicate that something is almost done with a filling track"+ - "progress value animating from zero to full"---<UiComponentPreview name="progress" />diff --git a/content/docs/ui/components/radio.mdx b/content/docs/ui/components/radio.mdxindex 604a5132..de0a34e0 100644--- a/content/docs/ui/components/radio.mdx+++ b/content/docs/ui/components/radio.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The control is binary on/off — use `switch` instead (sliding thumb reads more naturally for toggles)."- "You need a multi-select where several options can be active — use `checkbox` instead."- "Options switch with a continuous sliding indicator between segments — use `toggle-group` instead."+askedAs:+ - "radio button"+ - "single choice option selected"+ - "I want a round option getting selected within a group"+ - "show choosing one plan among several choices"+ - "form demo of picking exactly one answer"+ - "radio dot filling when chosen"---<UiComponentPreview name="radio" />diff --git a/content/docs/ui/components/resizable.mdx b/content/docs/ui/components/resizable.mdxindex 86c654e7..725573d8 100644--- a/content/docs/ui/components/resizable.mdx+++ b/content/docs/ui/components/resizable.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You need fixed-width layout panels — plain CSS grid or flex avoids the drag-state overhead entirely."- "The split is purely decorative — `resizable` implies an interactive drag metaphor; use a plain container instead."- "You need more than two panels — `resizable` is two-panel only; compose multiple instances."+askedAs:+ - "resizable panels"+ - "draggable split divider"+ - "I want two panes with a divider being dragged"+ - "show an editor layout where panel widths change"+ - "demo of adjusting a sidebar or split view"+ - "handle grabbed and moved to change the ratio of two areas"---<UiComponentPreview name="resizable" />diff --git a/content/docs/ui/components/select-menu.mdx b/content/docs/ui/components/select-menu.mdxindex c2bb16d1..31fa07c1 100644--- a/content/docs/ui/components/select-menu.mdx+++ b/content/docs/ui/components/select-menu.mdx@@ -12,6 +12,13 @@ avoidWhen:- "Options must open a reveal panel — use `select` instead."- "You need grouped actions that open from a trigger button — use `dropdown-menu` instead."- "Options are sequential numbered steps — use `stepper` instead."+askedAs:+ - "option list highlight"+ - "highlight sliding between choices"+ - "I want a vertical list where the selected row indicator glides"+ - "menu rows with a moving highlight"+ - "show someone moving through choices in a list"+ - "selection bar easing from one entry to another"---<UiComponentPreview name="select-menu" />diff --git a/content/docs/ui/components/select.mdx b/content/docs/ui/components/select.mdxindex 37a71838..273978f9 100644--- a/content/docs/ui/components/select.mdx+++ b/content/docs/ui/components/select.mdx@@ -13,6 +13,13 @@ avoidWhen:- "The choice is binary — use `switch` instead (simpler, no dropdown)."- "You need a compact segmented control without a dropdown — use `toggle-group` instead."- "The items are actions or commands rather than a value being stored — use `dropdown-menu` (or `context-menu`); for a long, type-to-filter list use `combobox`."+askedAs:+ - "select"+ - "dropdown picker"+ - "I want a closed select that opens a panel of items"+ - "show choosing a value from a dropdown field"+ - "form demo selecting country or option from a list"+ - "select box opening and picking an item"---<UiComponentPreview name="select" />diff --git a/content/docs/ui/components/sheet.mdx b/content/docs/ui/components/sheet.mdxindex 4e564fa5..2fea2bc1 100644--- a/content/docs/ui/components/sheet.mdx+++ b/content/docs/ui/components/sheet.mdx@@ -13,6 +13,13 @@ avoidWhen:- "The overlay is a floating contextual card near a target element — use `popover` instead."- "You only need a brief notification — use `toast` instead (no backdrop, no action panel)."- "The panel should slide up from the bottom edge — use `drawer` instead; `sheet` enters from a side edge."+askedAs:+ - "side sheet"+ - "slide-in side panel"+ - "I want a panel sliding in from the right edge"+ - "show a details or settings pane opening beside the page"+ - "off-canvas sidebar with content appearing over the app"+ - "side drawer that slides in and out in a demo"---<UiComponentPreview name="sheet" />diff --git a/content/docs/ui/components/skeleton-block.mdx b/content/docs/ui/components/skeleton-block.mdxindex 580b0c75..470ca3a6 100644--- a/content/docs/ui/components/skeleton-block.mdx+++ b/content/docs/ui/components/skeleton-block.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You want shimmer and real content to crossfade automatically — use `skeleton`, which takes a loading/loaded state and children"- "You need a spinning arc loader rather than a rectangle — use `spinner`"- "The placeholder is a whole layout of card, avatar, and lines — use `skeleton` with its `layout` prop instead of assembling blocks by hand"+askedAs:+ - "shimmer block"+ - "single loading placeholder"+ - "I want one gray rectangle with a moving shimmer"+ - "loading rectangle for a custom skeleton layout"+ - "build placeholder shapes that sweep a highlight"+ - "manual shimmer box for text or image slots"---The motion atom underneath [`skeleton`](/docs/ui/components/skeleton). A directional highlightdiff --git a/content/docs/ui/components/skeleton.mdx b/content/docs/ui/components/skeleton.mdxindex 02c4d133..abb239f1 100644--- a/content/docs/ui/components/skeleton.mdx+++ b/content/docs/ui/components/skeleton.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You only need a single shimmer rectangle — use `skeleton-block` directly (no state API, no crossfade overhead)."- "Content has no loading state — render children directly without a wrapper."- "You need a spinner-style loading indicator — use `spinner` instead (arc, no placeholder layout)."+askedAs:+ - "skeleton loader"+ - "loading placeholder then content"+ - "I want shimmering gray shapes that crossfade into real content"+ - "show a loading state resolving into the loaded interface"+ - "demo of perceived performance as data arrives"+ - "placeholder-to-content swap for a card or list"---<UiComponentPreview name="skeleton" />diff --git a/content/docs/ui/components/slider.mdx b/content/docs/ui/components/slider.mdxindex a3fded37..53ad7354 100644--- a/content/docs/ui/components/slider.mdx+++ b/content/docs/ui/components/slider.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You need to show completion percentage with no thumb — use `progress` instead (fill-only, no interaction states)."- "The value is binary — use `switch` instead."- "You need step-by-step progress with connectors and check marks — use `stepper` instead."+askedAs:+ - "slider"+ - "range slider thumb dragging"+ - "I want a draggable handle moving along a track"+ - "show adjusting a value like volume or price"+ - "UI demo of tuning a setting by dragging"+ - "slider thumb with hover and drag states moving to a value"---<UiComponentPreview name="slider" />diff --git a/content/docs/ui/components/spinner.mdx b/content/docs/ui/components/spinner.mdxindex 2703eb85..2cc522b0 100644--- a/content/docs/ui/components/spinner.mdx+++ b/content/docs/ui/components/spinner.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You need a full-width loading bar with a track — use `progress` instead."- "You need a shimmer placeholder block — use `skeleton-block` instead."- "The loading state resolves to real content — use `skeleton` for the crossfade (spinner has no loaded state)."+askedAs:+ - "spinner"+ - "loading circle"+ - "I want a rotating arc to show something is loading"+ - "small spinning indicator for a waiting state"+ - "show processing with a circular loader"+ - "spinning ring used inside buttons or empty screens"---<ComponentPreview name="spinner" />diff --git a/content/docs/ui/components/stepper.mdx b/content/docs/ui/components/stepper.mdxindex d5e4ce8a..b037736c 100644--- a/content/docs/ui/components/stepper.mdx+++ b/content/docs/ui/components/stepper.mdx@@ -12,6 +12,13 @@ avoidWhen:- "Steps have no sequential order — use `tabs` instead (tab switching without numbered connectors)."- "You need a continuous fill bar without numbered steps — use `progress` instead."- "You need a compact segmented control that switches view modes — use `toggle-group` instead."+askedAs:+ - "stepper"+ - "numbered steps progress"+ - "I want connected step circles advancing with check marks"+ - "show a multi-step process moving from step one to three"+ - "checkout or wizard progress indicator"+ - "ordered steps indicator advancing across a timeline"---<UiComponentPreview name="stepper" />diff --git a/content/docs/ui/components/switch.mdx b/content/docs/ui/components/switch.mdxindex 8f5fc656..fbdfd959 100644--- a/content/docs/ui/components/switch.mdx+++ b/content/docs/ui/components/switch.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The choice is one of multiple mutually exclusive options — use `radio` or `select` instead."- "You need a compact segmented control — use `toggle-group` instead (continuous sliding indicator between segments)."- "The state is a range value — use `slider` instead."+askedAs:+ - "switch"+ - "toggle switch on off"+ - "I want a sliding toggle flipping from off to on"+ - "show a setting being enabled with a thumb sliding"+ - "dark mode or notifications toggle demo"+ - "binary toggle changing state with color shift"---<UiComponentPreview name="switch" />diff --git a/content/docs/ui/components/tabs.mdx b/content/docs/ui/components/tabs.mdxindex 2cec1c7f..d0757ba4 100644--- a/content/docs/ui/components/tabs.mdx+++ b/content/docs/ui/components/tabs.mdx@@ -12,6 +12,13 @@ avoidWhen:- "Steps are sequential and ordered — use `stepper` instead (numbered connectors + check marks)."- "You need a compact segmented control without content panels — use `toggle-group` instead (no panel area)."- "You need a sidebar or vertical navigation structure — compose a nav layout directly instead."+askedAs:+ - "tabs"+ - "tab bar switching"+ - "I want tab headers where the active one changes and content swaps"+ - "show navigating between sections of an app"+ - "UI demo of clicking through tab pages"+ - "tab list with a moving active indicator"---<UiComponentPreview name="tabs" />diff --git a/content/docs/ui/components/toast.mdx b/content/docs/ui/components/toast.mdxindex 4fee4b1a..75810460 100644--- a/content/docs/ui/components/toast.mdx+++ b/content/docs/ui/components/toast.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The feedback is persistent and must not auto-dismiss — use a banner or inline alert component instead."- "You need a blocking confirmation with actions — use `alert-dialog` instead."- "You need a persistent side panel — use `sheet` instead."+askedAs:+ - "toast"+ - "notification popup"+ - "I want a small notification sliding up and disappearing"+ - "show a success message after an action"+ - "snackbar style feedback appearing briefly"+ - "alert banner that slides in from below, holds and dismisses"---<UiComponentPreview name="toast" />diff --git a/content/docs/ui/components/toggle-group.mdx b/content/docs/ui/components/toggle-group.mdxindex 213d2bb7..edaccfa8 100644--- a/content/docs/ui/components/toggle-group.mdx+++ b/content/docs/ui/components/toggle-group.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You need content panels that crossfade below the control — use `tabs` instead (full panel area + indicator)."- "Options are sequential numbered steps — use `stepper` instead (connectors + check marks)."- "You need a full dropdown with a reveal panel — use `select` instead."+askedAs:+ - "toggle group"+ - "segmented control"+ - "I want pill-shaped options with a sliding highlight"+ - "show switching between monthly and yearly or view modes"+ - "segmented picker where the active choice slides"+ - "compact selector with a thumb moving between segments"---<UiComponentPreview name="toggle-group" />diff --git a/content/docs/ui/components/tooltip.mdx b/content/docs/ui/components/tooltip.mdxindex 16c41a23..b2ee509f 100644--- a/content/docs/ui/components/tooltip.mdx+++ b/content/docs/ui/components/tooltip.mdx@@ -12,6 +12,13 @@ avoidWhen:- "You need title + description in the overlay — use `popover` instead (richer two-field content with optional children)."- "You need a persistent side panel with actions — use `sheet` instead."- "You need a blocking confirmation — use `alert-dialog` instead."+askedAs:+ - "tooltip"+ - "hover hint label"+ - "I want a small label popping above an element on hover"+ - "show a hint explaining an icon button"+ - "tiny popup text that names what something does"+ - "hover helper appearing over a UI anchor"---<UiComponentPreview name="tooltip" />diff --git a/content/docs/ui/components/typing-indicator.mdx b/content/docs/ui/components/typing-indicator.mdxindex 71bea093..0131d054 100644--- a/content/docs/ui/components/typing-indicator.mdx+++ b/content/docs/ui/components/typing-indicator.mdx@@ -12,6 +12,13 @@ avoidWhen:- "The wait is an async operation rather than a conversation — use `spinner`, or `skeleton` when the placeholder resolves to content."- "The dots should appear and disappear on a scripted conversation timeline — `chat-flow` and `imessage-chat-flow` already sequence them."- "You want a caret blinking at the end of typed text in a composer — use `caret`."+askedAs:+ - "typing indicator"+ - "three bouncing dots"+ - "I want the dots that show someone is typing a reply"+ - "chat is waiting for a response animation"+ - "small bouncing dots before a message appears"+ - "the someone is typing bubble used in messaging scenes"---<UiComponentPreview name="typing-indicator" />diff --git a/evals/search/golden.json b/evals/search/golden.jsonnew file mode 100644index 00000000..b9845ae2--- /dev/null+++ b/evals/search/golden.json@@ -0,0 +1,312 @@+[+ {+ "query": "show someone asking OpenAI's assistant a question",+ "expect": ["chat-gpt"]+ },+ {+ "query": "unveil the product like pulling a cover off at a keynote",+ "expect": ["cloth-reveal"]+ },+ {+ "query": "subtitles that look like they're being decrypted as the speaker talks",+ "expect": ["caption-scramble"]+ },+ {+ "query": "add a little smiley over certain spoken words in my reel subtitles",+ "expect": ["caption-emoji"]+ },+ {+ "query": "slow drifting shot over lots of dashboard widgets to use behind my title",+ "expect": ["infinite-bento-pan"]+ },+ {+ "query": "party poppers when the user finishes onboarding",+ "expect": ["confetti"]+ },+ {+ "query": "make the scene look like a sci-fi projected image",+ "expect": ["hologram"]+ },+ { "query": "build my icon out of lego pieces", "expect": ["brick-mosaic"] },+ {+ "query": "tilt a website capture in 3D and scroll the camera down a long landing page",+ "expect": ["stage"]+ },+ {+ "query": "explode a sentence into a bunch of product pictures and finish on our brand mark",+ "expect": ["word-burst-cards"]+ },+ {+ "query": "two pieces of the brand mark join together with a satisfying mechanical feel",+ "expect": ["snap-click"]+ },+ {+ "query": "sign our name in glowing neon handwriting",+ "expect": ["light-trail-write"]+ },+ {+ "query": "scattered pictures floating around that organize themselves into a neat gallery",+ "expect": ["shards-to-grid"]+ },+ {+ "query": "tiny sparkle lines radiating out when a button gets pressed",+ "expect": ["trim-burst"]+ },+ {+ "query": "show where we sit versus rivals on a 2x2 matrix",+ "expect": ["quadrant-plot"]+ },+ {+ "query": "announce the release date by selecting it in a date picker",+ "expect": ["calendar-pick"]+ },+ {+ "query": "show that setup only takes five minutes",+ "expect": ["clock-sweep"]+ },+ {+ "query": "visualize that 1 out of 3 developers use it",+ "expect": ["unit-grid"]+ },+ {+ "query": "race our build time against the old way",+ "expect": ["timer-duel"]+ },+ {+ "query": "list everything included and show it all costs nothing",+ "expect": ["the-tab"]+ },+ {+ "query": "big metric ticking upward with a measuring scale underneath",+ "expect": ["pitch-over"]+ },+ {+ "query": "many workers each counting and adding into one enormous total",+ "expect": ["core-sum"]+ },+ {+ "query": "phone getting flooded with alerts and then everything is quiet",+ "expect": ["notification-avalanche"]+ },+ {+ "query": "walk through critiquing a UI mockup and then shipping the corrected version",+ "expect": ["design-audit"]+ },+ {+ "query": "demo an AI phone assistant making a restaurant reservation",+ "expect": ["voice-agent"]+ },+ {+ "query": "duolingo-style daily progress celebration on a mobile screen",+ "expect": ["streak-reward"]+ },+ {+ "query": "warm sunset-like band backdrop between dark blue and light sky",+ "expect": ["shader-grain-gradient-horizon"]+ },+ {+ "query": "underwater-feeling animated backdrop with slanted turquoise stripes",+ "expect": ["shader-warp-deep-sea"]+ },+ {+ "query": "80s retro purple and orange glowing backdrop",+ "expect": ["shader-mesh-gradient-synthwave"]+ },+ {+ "query": "pattern of circling points as a backdrop that suggests a network",+ "expect": ["shader-dot-orbit"]+ },+ {+ "query": "quiet setup line then slam into a giant number with camera shake",+ "expect": ["crash-zoom"]+ },+ {+ "query": "a full ready-made product video I can just edit the text of",+ "expect": ["launch-anything"]+ },+ {+ "query": "scene change that feels like fog clearing from the center",+ "expect": ["smoke-dissolve"]+ },+ {+ "query": "rapid flashing of many images between two scenes",+ "expect": ["strobe-montage"]+ },+ {+ "query": "fly the camera forward into the next scene",+ "expect": ["push-through"]+ },+ {+ "query": "scene change where the image turns into 3D tiles that ripple",+ "expect": ["grid-wave"]+ },+ {+ "query": "keep one keyword fixed while the rest of the sentence swaps",+ "expect": ["pinned-word"]+ },+ {+ "query": "split a sentence into chunks and show each chunk full-screen one after another",+ "expect": ["script-cut"]+ },+ {+ "query": "elegant closing sentence that slides upward with the last words colored",+ "expect": ["serif-rise"]+ },+ {+ "query": "title revealed by a dark band passing over it",+ "expect": ["shadow-sweep-text"]+ },+ {+ "query": "answer a series of customer objections with the same affirmative reply",+ "expect": ["yes-run"]+ },+ {+ "query": "extreme close-up moving letter to letter then zoom out to the whole sentence",+ "expect": ["macro-letter-pan", "macro-pan"]+ },+ {+ "query": "vaporwave title with rippling color-fringe distortion that loops",+ "expect": ["chromatic-wave"]+ },+ {+ "query": "blurry text coming into focus and getting bolder",+ "expect": ["enhance-count"]+ },+ {+ "query": "headline filmed up close sliding across the letter shapes, for a chapter opening",+ "expect": ["macro-pan", "macro-letter-pan"]+ },+ {+ "query": "funny statement followed by a small parenthetical that contradicts it",+ "expect": ["coy-denial"]+ },+ {+ "query": "sentence flies by then goes slow-mo on the important word",+ "expect": ["speed-ramp-word"]+ },+ {+ "query": "turn legal fine print into simple human words",+ "expect": ["plain-license"]+ },+ {+ "query": "tell a short founder story with a problem in the middle and a happy ending",+ "expect": ["story-dip"]+ },+ {+ "query": "characters rearrange themselves to spell the next phrase",+ "expect": ["kinetic-morph-text"]+ },+ {+ "query": "lots of small capability tags gathering around our brand mark",+ "expect": ["feature-chips-flow"]+ },+ {+ "query": "show a word being drawn with vector points and curve handles like in a type design app",+ "expect": ["glyph-anatomy"]+ },+ {+ "query": "list who the product is for and end by speaking to the viewer directly",+ "expect": ["and-you"]+ },+ {+ "query": "dragging a document in and watching it finish importing",+ "expect": ["drop-upload"]+ },+ {+ "query": "translucent editor window showing a snippet appearing line by line",+ "expect": ["glass-code-block"]+ },+ {+ "query": "switch between sections of a panel in an app demo",+ "expect": ["tabs"]+ },+ {+ "query": "small hint bubble that pops up when the cursor is over an icon",+ "expect": ["tooltip"]+ },+ {+ "query": "messenger conversation with blue bubbles and double check marks",+ "expect": ["telegram-chat-flow"]+ },+ {+ "query": "показать, что настройка занимает всего пять минут",+ "expect": ["clock-sweep"],+ "lang": "ru"+ },+ {+ "query": "собрать логотип из кубиков лего",+ "expect": ["brick-mosaic"],+ "lang": "ru"+ },+ {+ "query": "конфетти, когда пользователь завершил онбординг",+ "expect": ["confetti"],+ "lang": "ru"+ },+ {+ "query": "переход между сценами как рассеивающийся туман",+ "expect": ["smoke-dissolve"],+ "lang": "ru"+ },+ {+ "query": "субтитры, которые расшифровываются как в терминале",+ "expect": ["caption-scramble"],+ "lang": "ru"+ },+ {+ "query": "показать, где мы находимся относительно конкурентов на матрице 2x2",+ "expect": ["quadrant-plot"],+ "lang": "ru"+ },+ {+ "query": "перетащить файл и показать, как он загружается",+ "expect": ["drop-upload"],+ "lang": "ru"+ },+ {+ "query": "переписка в мессенджере с синими пузырями и двумя галочками",+ "expect": ["telegram-chat-flow"],+ "lang": "ru"+ },+ { "query": "typewriter", "expect": ["typewriter"], "kind": "keyword" },+ {+ "query": "typewriter headline",+ "expect": ["typewriter"],+ "kind": "keyword"+ },+ { "query": "confetti", "expect": ["confetti"], "kind": "keyword" },+ {+ "query": "rolling number",+ "expect": ["rolling-number"],+ "kind": "keyword"+ },+ { "query": "bar chart", "expect": ["animated-bar-chart"], "kind": "keyword" },+ {+ "query": "line chart",+ "expect": ["animated-line-chart"],+ "kind": "keyword"+ },+ {+ "query": "waterfall chart",+ "expect": ["waterfall-chart"],+ "kind": "keyword"+ },+ { "query": "github stars", "expect": ["github-stars"], "kind": "keyword" },+ { "query": "before after", "expect": ["before-after"], "kind": "keyword" },+ { "query": "terminal", "expect": ["terminal-simulator"], "kind": "keyword" },+ { "query": "tabs", "expect": ["tabs"], "kind": "keyword" },+ { "query": "tooltip", "expect": ["tooltip"], "kind": "keyword" },+ { "query": "accordion", "expect": ["accordion"], "kind": "keyword" },+ { "query": "command menu", "expect": ["command-menu"], "kind": "keyword" },+ { "query": "zoom blur", "expect": ["zoom-blur"], "kind": "keyword" },+ { "query": "neon sign", "expect": ["neon-sign"], "kind": "keyword" },+ { "query": "countdown", "expect": ["countdown"], "kind": "keyword" },+ { "query": "chatgpt", "expect": ["chat-gpt"], "kind": "keyword" },+ { "query": "claude chat", "expect": ["claude-chat"], "kind": "keyword" },+ { "query": "dropdown menu", "expect": ["dropdown-menu"], "kind": "keyword" },+ { "query": "progress bar", "expect": ["progress"], "kind": "keyword" },+ { "query": "whip pan", "expect": ["whip-pan"], "kind": "keyword" },+ { "query": "stepper", "expect": ["stepper"], "kind": "keyword" },+ { "query": "toggle switch", "expect": ["switch"], "kind": "keyword" },+ { "query": "button", "expect": ["button"], "kind": "keyword" }+]diff --git a/lib/docs-meta.test.ts b/lib/docs-meta.test.tsindex 293ad70c..88d94313 100644--- a/lib/docs-meta.test.ts+++ b/lib/docs-meta.test.ts@@ -182,6 +182,25 @@ describe("component pages carry selection metadata", () => {expect(offenders).toEqual([]);});+ it("carries five to eight distinct askedAs phrasings", () => {+ const offenders: string[] = [];+ for (const page of componentPages) {+ const value = page.frontmatter.askedAs;+ const ok =+ Array.isArray(value) &&+ value.length >= 5 &&+ value.length <= 8 &&+ value.every(+ (entry) => typeof entry === "string" && entry.trim().length > 0,+ ) &&+ new Set(value.map((entry) => String(entry).toLowerCase())).size ===+ value.length;+ if (!ok) offenders.push(page.file);+ }++ expect(offenders).toEqual([]);+ });+it("only cites components that exist", () => {const known = new Set(items.map((i) => i.name));const offenders: string[] = [];diff --git a/lib/docs-schema.ts b/lib/docs-schema.tsindex a2a95192..52332747 100644--- a/lib/docs-schema.ts+++ b/lib/docs-schema.ts@@ -25,4 +25,7 @@ export const componentMetaSchema = z.object({.optional(),useWhen: z.array(z.string()).optional(),avoidWhen: z.array(z.string()).optional(),+ // How people ask for the component in their own words. Search-only: these+ // feed the lexical scorer and the semantic index, and are never rendered.+ askedAs: z.array(z.string()).optional(),});diff --git a/lib/mcp/catalog.ts b/lib/mcp/catalog.tsindex 257983b0..beacf66b 100644--- a/lib/mcp/catalog.ts+++ b/lib/mcp/catalog.ts@@ -80,6 +80,7 @@ export function getCatalog(): Catalog {tier: registry.get(name)?.tier,useWhen: data.useWhen ?? [],avoidWhen: data.avoidWhen ?? [],+ askedAs: data.askedAs ?? [],install: installCommand(name),};records.push(record);diff --git a/lib/mcp/request-context.ts b/lib/mcp/request-context.tsnew file mode 100644index 00000000..46cc6131--- /dev/null+++ b/lib/mcp/request-context.ts@@ -0,0 +1,14 @@+import "server-only";++import { AsyncLocalStorage } from "node:async_hooks";++/**+ * Facts about the HTTP request behind an MCP tool call. The SDK builds the+ * server per request and hands tool handlers only the tool arguments, so the+ * route stores what analytics needs here and the handlers read it back.+ */+export interface McpRequestContext {+ userAgent: string;+}++export const mcpRequestContext = new AsyncLocalStorage<McpRequestContext>();diff --git a/lib/mcp/search.test.ts b/lib/mcp/search.test.tsindex 68886810..b76f329f 100644--- a/lib/mcp/search.test.ts+++ b/lib/mcp/search.test.ts@@ -24,6 +24,7 @@ function record(tier: "remocn",useWhen: [],avoidWhen: [],+ askedAs: [],install: `npx shadcn@latest add @remocn/${name}`,...overrides,};diff --git a/lib/mcp/search.ts b/lib/mcp/search.tsindex ba189d52..85fe02b4 100644--- a/lib/mcp/search.ts+++ b/lib/mcp/search.ts@@ -24,6 +24,8 @@ export interface ComponentRecord {tier?: string;useWhen: string[];avoidWhen: string[];+ /** Search phrasings from the docs frontmatter; matched, never displayed. */+ askedAs: string[];install: string;}@@ -112,6 +114,7 @@ const WEIGHTS = {description: 3,section: 2,useWhen: 2,+ askedAs: 2,vibe: 1,} as const;@@ -127,6 +130,7 @@ export function scoreComponent(description: tokenize(record.description),section: tokenize(record.section.replace(/-/g, " ")),useWhen: tokenize(record.useWhen.join(" ")),+ askedAs: tokenize(record.askedAs.join(" ")),vibe: record.vibe ? [record.vibe] : [],};@@ -157,7 +161,7 @@ export function scoreComponent(function passesFilters(record: ComponentRecord,- { vibe, maxLength }: SearchOptions,+ { vibe, maxLength }: Pick<SearchOptions, "vibe" | "maxLength">,): boolean {if (vibe && record.vibe !== vibe) return false;if (maxLength !== undefined) {@@ -169,32 +173,58 @@ function passesFilters(return true;}-export function searchComponents(+export interface ScoredComponent {+ record: ComponentRecord;+ score: number;+}++export function clampLimit(limit: number | undefined): number {+ return Math.min(Math.max(1, Math.floor(limit ?? DEFAULT_LIMIT)), MAX_LIMIT);+}++export function filterComponents(records: ComponentRecord[],- options: SearchOptions,+ options: Pick<SearchOptions, "vibe" | "maxLength">,): ComponentRecord[] {- const limit = Math.min(- Math.max(1, Math.floor(options.limit ?? DEFAULT_LIMIT)),- MAX_LIMIT,- );- const candidates = records.filter((r) => passesFilters(r, options));- const queryTokens = tokenize(options.query);-- if (queryTokens.length === 0) {- return [...candidates]- .sort((a, b) => a.name.localeCompare(b.name))- .slice(0, limit);- }+ return records.filter((r) => passesFilters(r, options));+}+/**+ * Every candidate the words of the query hit, best first, with no limit+ * applied. Empty when the query has no usable tokens (stopwords only, or a+ * language the tokenizer does not read).+ */+export function rankComponents(+ candidates: ComponentRecord[],+ query: string,+): ScoredComponent[] {+ const queryTokens = tokenize(query);+ if (queryTokens.length === 0) return [];return candidates.map((record) => ({record,- score: scoreComponent(record, queryTokens, options.query),+ score: scoreComponent(record, queryTokens, query),})).filter((r) => r.score > 0).sort((a, b) => b.score - a.score || a.record.name.localeCompare(b.record.name),- )+ );+}++export function searchComponents(+ records: ComponentRecord[],+ options: SearchOptions,+): ComponentRecord[] {+ const limit = clampLimit(options.limit);+ const candidates = filterComponents(records, options);++ if (tokenize(options.query).length === 0) {+ return [...candidates]+ .sort((a, b) => a.name.localeCompare(b.name))+ .slice(0, limit);+ }++ return rankComponents(candidates, options.query).slice(0, limit).map((r) => r.record);}diff --git a/lib/mcp/server.ts b/lib/mcp/server.tsindex 51a0d7cf..3d0f9e60 100644--- a/lib/mcp/server.ts+++ b/lib/mcp/server.ts@@ -20,20 +20,25 @@ import {MCP_APP_MIME_TYPE,PREVIEW_RESOURCE_URI,} from "@/lib/mcp/config";+import { mcpRequestContext } from "@/lib/mcp/request-context";import {type ComponentRecord,closestNames,installCommand,MAX_LIMIT,normalizeName,- searchComponents,} from "@/lib/mcp/search";import { PREVIEW_WIDGET_HTML } from "@/lib/mcp/widget";+import { searchCatalog } from "@/lib/search/components";+import {+ trackAgentComponentFetch,+ trackAgentSearch,+} from "@/lib/server/analytics";import { previewManifest } from "@/registry/__manifest__";const SERVER_INFO = { name: "remocn", version: "1.0.0" };-const INSTRUCTIONS = `Remocn is a shadcn registry of Remotion video components. Find components with search_components, read one with get_component before writing code against it, and use plan_video to turn a brief into a beat-by-beat storyboard. Install with \`npx shadcn@latest add @remocn/<name>\`. Full index: ${SITE_URL}/llms-components.txt`;+const INSTRUCTIONS = `Remocn is a shadcn registry of Remotion video components. Find components with search_components: describe what the scene should show or say (in any language), or pass a name or keywords. Read one with get_component before writing code against it, and use plan_video to turn a brief into a beat-by-beat storyboard. Install with \`npx shadcn@latest add @remocn/<name>\`. Full index: ${SITE_URL}/llms-components.txt`;const MAX_PROPS_JSON = 4000;// The endpoint is public and unauthenticated; every text input is bounded so@@ -81,6 +86,23 @@ function htmlDocsUrl(record: ComponentRecord): string {return record.docs.replace(/\.md$/, "");}+function callerUserAgent(): string {+ return mcpRequestContext.getStore()?.userAgent ?? "";+}++function trackFetch(+ tool: "get_component" | "preview_component",+ input: string,+ record: ComponentRecord | undefined,+): void {+ trackAgentComponentFetch({+ tool,+ userAgent: callerUserAgent(),+ component: record?.name ?? input,+ found: Boolean(record),+ });+}+/** Resolve user input (name, `@remocn/name`, docs path, or title) to a documented component. */function resolveComponent(input: string): ComponentRecord | undefined {const { byName, records } = getCatalog();@@ -202,12 +224,14 @@ export function createRemocnMcpServer(): McpServer {{title: "Search Remocn components",description:- "Search Remocn Remotion components by what they do. Returns name, docs .md URL, vibe, length (frames @30fps), use/avoid notes and install command.",+ "Search Remocn Remotion components by what they do or by the need they serve; matches by meaning as well as by words. Returns name, docs .md URL, vibe, length (frames @30fps), use/avoid notes and install command.",inputSchema: z.object({query: z.string().max(MAX_QUERY)- .describe("What the component should do, e.g. 'typewriter headline'"),+ .describe(+ "What the component should do or what the scene should say, in any language, e.g. 'typewriter headline' or 'show that setup takes five minutes'",+ ),vibe: z.enum(VIBES).optional().describe("Tonal tag to match the brand"),maxLength: z.number()@@ -220,12 +244,23 @@ export function createRemocnMcpServer(): McpServer {annotations: readOnly("Search Remocn components"),},async ({ query, vibe, maxLength, limit }) => {- const results = searchComponents(getCatalog().records, {+ const started = performance.now();+ const { results, mode } = await searchCatalog({query,vibe,maxLength,limit,});+ trackAgentSearch({+ surface: "mcp",+ userAgent: callerUserAgent(),+ query,+ results: results.map((r) => r.name),+ mode,+ latencyMs: performance.now() - started,+ vibe,+ maxLength,+ });const filters = [vibe && `vibe=${vibe}`,maxLength !== undefined && `maxLength=${maxLength}f`,@@ -261,6 +296,7 @@ export function createRemocnMcpServer(): McpServer {},async ({ name }) => {const record = resolveComponent(name);+ trackFetch("get_component", name, record);if (!record) return unknownComponent(name);const markdown = await getComponentMarkdown(record.name);if (!markdown) return unknownComponent(name);@@ -449,6 +485,7 @@ export function createRemocnMcpServer(): McpServer {},async ({ name, props }) => {const record = resolveComponent(name);+ trackFetch("preview_component", name, record);if (!record) return unknownComponent(name);if (props && JSON.stringify(props).length > MAX_PROPS_JSON) {return errorText(diff --git a/lib/openapi.ts b/lib/openapi.tsindex 737c69ec..9b9a35b0 100644--- a/lib/openapi.ts+++ b/lib/openapi.ts@@ -95,13 +95,14 @@ export const OPENAPI_SPEC = {tags: ["Docs"],summary: "Search the docs",description:- "Full-text search over every docs page, heading and paragraph. Returns an empty array when `query` is missing.",+ "Search the docs by words and components by need. Full-text matches over every docs page, heading and paragraph, with the components that fit the query by meaning placed among them (`show that setup takes five minutes` finds a clock scene; the query can be in any language). Returns an empty array when `query` is missing.",parameters: [{name: "query",in: "query",required: true,- description: "Search text, e.g. `blur transition`.",+ description:+ "Search text: a name, a keyword or a described need, e.g. `blur transition`.",schema: { type: "string", minLength: 1 },},{diff --git a/lib/search/analytics-shape.test.ts b/lib/search/analytics-shape.test.tsnew file mode 100644index 00000000..59c5a381--- /dev/null+++ b/lib/search/analytics-shape.test.ts@@ -0,0 +1,52 @@+import { describe, expect, it } from "bun:test";+import {+ browserActor,+ classifyAgentClient,+ describeQuery,+ loggedQuery,+} from "./analytics-shape";++describe("describeQuery", () => {+ it("describes a query without quoting it", () => {+ expect(describeQuery(" show revenue growing ")).toEqual({+ query_words: 3,+ query_chars: 20,+ query_script: "latin",+ });+ });++ it("tells writing systems apart", () => {+ expect(describeQuery("показать рост выручки").query_script).toBe(+ "cyrillic",+ );+ expect(describeQuery("ロゴのアニメーション").query_script).toBe("cjk");+ expect(describeQuery("переход для logo").query_script).toBe("mixed");+ expect(describeQuery("123").query_script).toBe("other");+ });+});++describe("loggedQuery", () => {+ it("cuts a pasted paragraph down", () => {+ expect(loggedQuery("a".repeat(500))).toHaveLength(200);+ });+});++describe("classifyAgentClient", () => {+ it("groups callers by product", () => {+ expect(classifyAgentClient("Claude-User/1.0")).toBe("claude");+ expect(classifyAgentClient("codex_cli_rs/0.40 (openai)")).toBe("codex");+ expect(classifyAgentClient("ChatGPT-User/1.0")).toBe("chatgpt");+ expect(classifyAgentClient("Cursor/1.4")).toBe("cursor");+ expect(classifyAgentClient("node")).toBe("script");+ expect(classifyAgentClient("")).toBe("unknown");+ expect(classifyAgentClient("SomethingNew/2")).toBe("other");+ });+});++describe("browserActor", () => {+ it("treats an automated browser as an agent", () => {+ expect(browserActor("Mozilla/5.0 Chrome/140", true)).toBe("agent");+ expect(browserActor("Mozilla/5.0 Claude-Agent/1.0", false)).toBe("agent");+ expect(browserActor("Mozilla/5.0 Chrome/140", false)).toBe("human");+ });+});diff --git a/lib/search/analytics-shape.ts b/lib/search/analytics-shape.tsnew file mode 100644index 00000000..517de0a7--- /dev/null+++ b/lib/search/analytics-shape.ts@@ -0,0 +1,92 @@+/**+ * What the search analytics may say about a query without quoting it, and who+ * is asking. Pure and shared: the docs search dialog (client) and the MCP and+ * API handlers (server) describe a search with the same fields, so one chart+ * can split any of them by `actor`.+ */++export type SearchActor = "human" | "agent";++/** Where the search came from: the ⌘K dialog, an MCP tool call, or a direct call to `/api/search`. */+export type SearchSurface = "docs_dialog" | "mcp" | "api";++export type QueryScript = "latin" | "cyrillic" | "cjk" | "other" | "mixed";++/** Longest query text an event carries; the rest of a pasted paragraph is noise. */+export const MAX_LOGGED_QUERY = 200;++export interface QueryShape {+ query_words: number;+ query_chars: number;+ /** Writing system, as a stand-in for language: tells how much non-English search there is. */+ query_script: QueryScript;+}++const SCRIPTS: [QueryScript, RegExp][] = [+ ["latin", /\p{Script=Latin}/u],+ ["cyrillic", /\p{Script=Cyrillic}/u],+ [+ "cjk",+ /[\p{Script=Han}\p{Script=Hiragana}\p{Script=Katakana}\p{Script=Hangul}]/u,+ ],+];++export function describeQuery(query: string): QueryShape {+ const text = query.trim();+ const found = SCRIPTS.filter(([, pattern]) => pattern.test(text)).map(+ ([script]) => script,+ );+ return {+ query_words: text ? text.split(/\s+/).length : 0,+ query_chars: text.length,+ query_script: found.length > 1 ? "mixed" : (found[0] ?? "other"),+ };+}++export function loggedQuery(query: string): string {+ return query.trim().slice(0, MAX_LOGGED_QUERY);+}++/**+ * Which program is calling, from its User-Agent. A best guess for grouping:+ * clients name themselves freely and most MCP hosts send whatever their HTTP+ * library sends, so `script` and `other` are large buckets by nature.+ */+const AGENT_CLIENTS: [string, RegExp][] = [+ ["codex", /codex/i],+ ["claude", /claude|anthropic/i],+ ["chatgpt", /chatgpt|openai|oai-/i],+ ["cursor", /cursor/i],+ ["vscode", /vscode|visual studio code|copilot/i],+ ["windsurf", /windsurf|codeium/i],+ ["gemini", /gemini|google/i],+ ["perplexity", /perplexity/i],+ ["mistral", /mistral/i],+ [+ "script",+ /node|undici|bun\/|deno|python|httpx|aiohttp|go-http|curl|wget|axios|okhttp/i,+ ],+ ["browser", /mozilla/i],+];++export function classifyAgentClient(userAgent: string): string {+ if (!userAgent.trim()) return "unknown";+ return (+ AGENT_CLIENTS.find(([, pattern]) => pattern.test(userAgent))?.[0] ?? "other"+ );+}++/**+ * Browsers an agent drives report themselves in one of two ways: the+ * automation flag (`navigator.webdriver`) or a product token in the+ * User-Agent. An agent that drives an ordinary browser with an ordinary+ * User-Agent leaves neither and is counted as a human.+ */+const AGENT_BROWSER = /Claude-Agent|Google-Agent|ChatGPT-Agent|HeadlessChrome/i;++export function browserActor(+ userAgent: string,+ webdriver: boolean,+): SearchActor {+ return webdriver || AGENT_BROWSER.test(userAgent) ? "agent" : "human";+}diff --git a/lib/search/components.ts b/lib/search/components.tsnew file mode 100644index 00000000..2780fc99--- /dev/null+++ b/lib/search/components.ts@@ -0,0 +1,42 @@+import "server-only";++import { getCatalog } from "@/lib/mcp/catalog";+import {+ type ComponentRecord,+ clampLimit,+ filterComponents,+ type SearchOptions,+} from "@/lib/mcp/search";+import { hybridSearch } from "@/lib/search/hybrid";+import { semanticRank } from "@/lib/search/semantic";++/** Callers are public endpoints; this bounds what one request can embed. */+const MAX_QUERY_CHARS = 500;++export interface CatalogSearch {+ results: ComponentRecord[];+ /** `keyword` when the semantic index or model was not available. */+ mode: "hybrid" | "keyword";+}++/**+ * Component search for everything that runs on the server: the MCP+ * `search_components` tool and the docs search endpoint share this one entry+ * point, so both rank the same way.+ */+export async function searchCatalog(+ options: SearchOptions,+): Promise<CatalogSearch> {+ const candidates = filterComponents(getCatalog().records, options);+ const query = options.query.trim().slice(0, MAX_QUERY_CHARS);+ const semantic = query ? await semanticRank(query) : null;+ return {+ results: hybridSearch(+ candidates,+ query,+ semantic,+ clampLimit(options.limit),+ ),+ mode: semantic ? "hybrid" : "keyword",+ };+}diff --git a/lib/search/dialog-session.test.ts b/lib/search/dialog-session.test.tsnew file mode 100644index 00000000..390a504b--- /dev/null+++ b/lib/search/dialog-session.test.ts@@ -0,0 +1,129 @@+import { afterEach, beforeEach, describe, expect, it, jest } from "bun:test";+import { SearchDialogSession, type SearchRow } from "./dialog-session";++const clock: SearchRow[] = [+ {+ id: "component:clock-sweep",+ url: "/docs/numbers/clock-sweep",+ type: "page",+ },+ {+ id: "component:clock-sweep:description",+ url: "/docs/numbers/clock-sweep",+ type: "text",+ },+ { id: "p1", url: "/docs/guides/timing", type: "page" },+ { id: "p1-text", url: "/docs/guides/timing#minutes", type: "text" },+];++function session() {+ const events: [string, Record<string, unknown>][] = [];+ const instance = new SearchDialogSession(+ (event, properties) => events.push([event, properties]),+ "human",+ 1000,+ );+ return { instance, events, names: () => events.map(([name]) => name) };+}++describe("SearchDialogSession", () => {+ beforeEach(() => {+ jest.useFakeTimers();+ });+ afterEach(() => {+ jest.useRealTimers();+ });++ it("counts a query once the visitor stopped on it, not every keystroke", () => {+ const { instance, events, names } = session();++ instance.results("se", clock);+ jest.advanceTimersByTime(300);+ instance.results("setup takes five minutes", clock);+ jest.advanceTimersByTime(1000);++ expect(names()).toEqual(["search_performed"]);+ expect(events[0][1]).toMatchObject({+ actor: "human",+ surface: "docs_dialog",+ query: "setup takes five minutes",+ query_words: 4,+ query_script: "latin",+ result_count: 2,+ component_count: 1,+ top_components: "clock-sweep",+ has_results: true,+ });+ });++ it("reports the search and the pick when a result is opened right away", () => {+ const { instance, events, names } = session();++ instance.results("timing", clock);+ instance.select(clock[3]);+ instance.close();++ expect(names()).toEqual(["search_performed", "search_result_selected"]);+ expect(events[1][1]).toMatchObject({+ query: "timing",+ url: "/docs/guides/timing",+ kind: "docs",+ row_type: "text",+ position: 2,+ });+ });++ it("names the component when a semantic result is picked", () => {+ const { instance, events } = session();++ instance.results("five minutes", clock);+ instance.select(clock[1]);++ expect(events[1][1]).toMatchObject({+ kind: "component",+ component: "clock-sweep",+ position: 1,+ });+ });++ it("reports an abandoned search when the dialog closes with no pick", () => {+ const { instance, events, names } = session();++ instance.results("revenue", []);+ jest.advanceTimersByTime(1000);+ instance.results("revenue growth", []);+ instance.close();++ expect(names()).toEqual([+ "search_performed",+ "search_performed",+ "search_abandoned",+ ]);+ expect(events[2][1]).toMatchObject({+ query: "revenue growth",+ has_results: false,+ searches: 2,+ });+ });++ it("does not count the same query twice in one opening", () => {+ const { instance, names } = session();++ instance.results("clock", clock);+ jest.advanceTimersByTime(1000);+ instance.results("clo", clock);+ instance.results("Clock ", clock);+ jest.advanceTimersByTime(1000);++ expect(names()).toEqual(["search_performed"]);+ });++ it("stays silent when the dialog closes on an empty field", () => {+ const { instance, names } = session();++ instance.results("", []);+ instance.close();++ expect(names()).toEqual([]);+ });+});diff --git a/lib/search/dialog-session.ts b/lib/search/dialog-session.tsnew file mode 100644index 00000000..819248a5--- /dev/null+++ b/lib/search/dialog-session.ts@@ -0,0 +1,145 @@+import {+ describeQuery,+ loggedQuery,+ type SearchActor,+} from "@/lib/search/analytics-shape";++/**+ * Turns what happens in one opening of the docs search dialog into analytics+ * events. No React and no analytics client in here, so the rules are testable:+ * the dialog feeds it results, selections and the close, and it calls `emit`.+ *+ * The dialog searches on every keystroke, so most result sets are for half a+ * word. A query counts as a search once the visitor stopped on it: it stayed+ * on screen for `settleMs`, or they picked a result, or they closed the+ * dialog on it.+ */++export interface SearchRow {+ id: string;+ url: string;+ type: string;+}++export type SearchDialogEvent =+ | "search_performed"+ | "search_result_selected"+ | "search_abandoned";++export type Emit = (+ event: SearchDialogEvent,+ properties: Record<string, string | number | boolean>,+) => void;++interface Shown {+ query: string;+ rows: SearchRow[];+}++const COMPONENT_ID = "component:";++function pageOf(url: string): string {+ return url.split("#")[0];+}++/** Rows the semantic component search put in, as opposed to full-text hits. */+function componentNames(rows: SearchRow[]): string[] {+ return rows+ .filter((row) => row.type === "page" && row.id.startsWith(COMPONENT_ID))+ .map((row) => row.id.slice(COMPONENT_ID.length));+}++function pages(rows: SearchRow[]): string[] {+ return [...new Set(rows.map((row) => pageOf(row.url)))];+}++export class SearchDialogSession {+ private shown: Shown | undefined;+ private timer: ReturnType<typeof setTimeout> | undefined;+ private reported = new Set<string>();+ private selected = false;++ constructor(+ private readonly emit: Emit,+ private readonly actor: SearchActor,+ private readonly settleMs = 1000,+ ) {}++ /** The dialog now shows `rows` for `query`. */+ results(query: string, rows: SearchRow[]): void {+ clearTimeout(this.timer);+ if (!query.trim()) {+ this.shown = undefined;+ return;+ }+ const shown = { query, rows };+ this.shown = shown;+ this.timer = setTimeout(() => this.report(shown), this.settleMs);+ }++ /** The visitor picked a row, by click or Enter. */+ select(row: SearchRow): void {+ clearTimeout(this.timer);+ this.selected = true;+ const shown = this.shown;+ if (!shown) return;+ this.report(shown);++ const component = row.id.startsWith(COMPONENT_ID)+ ? row.id.slice(COMPONENT_ID.length).split(":")[0]+ : undefined;+ this.emit("search_result_selected", {+ ...this.base(shown.query),+ url: pageOf(row.url),+ kind: component ? "component" : "docs",+ ...(component ? { component } : {}),+ row_type: row.type,+ position: pages(shown.rows).indexOf(pageOf(row.url)) + 1,+ });+ }++ /** The dialog closed. Without a selection, the last query went unanswered. */+ close(): void {+ clearTimeout(this.timer);+ const shown = this.shown;+ if (shown && !this.selected) {+ this.report(shown);+ this.emit("search_abandoned", {+ ...this.base(shown.query),+ ...this.counts(shown.rows),+ searches: this.reported.size,+ });+ }+ this.shown = undefined;+ this.selected = false;+ this.reported.clear();+ }++ private report(shown: Shown): void {+ const key = shown.query.trim().toLowerCase().replace(/\s+/g, " ");+ if (this.reported.has(key)) return;+ this.reported.add(key);+ this.emit("search_performed", {+ ...this.base(shown.query),+ ...describeQuery(shown.query),+ ...this.counts(shown.rows),+ top_components: componentNames(shown.rows).join(","),+ });+ }++ private base(query: string) {+ return {+ actor: this.actor,+ surface: "docs_dialog" as const,+ query: loggedQuery(query),+ };+ }++ private counts(rows: SearchRow[]) {+ return {+ result_count: pages(rows).length,+ component_count: componentNames(rows).length,+ has_results: rows.length > 0,+ };+ }+}diff --git a/lib/search/docs-merge.test.ts b/lib/search/docs-merge.test.tsnew file mode 100644index 00000000..0ac06ad2--- /dev/null+++ b/lib/search/docs-merge.test.ts@@ -0,0 +1,108 @@+import { describe, expect, it } from "bun:test";+import type { SortedResult } from "fumadocs-core/search";+import { type ComponentHit, mergeDocsResults } from "./docs-merge";++const clock: ComponentHit = {+ name: "clock-sweep",+ title: "Clock Sweep",+ description: "A clock hand sweeps a glowing wedge",+ url: "/docs/numbers/clock-sweep",+ section: "numbers",+};++const COMPONENT_URLS = new Set(["/docs/numbers/clock-sweep", "/docs/ui/tabs"]);++function page(url: string, content: string): SortedResult {+ return { id: url, url, type: "page", content };+}++function text(url: string, content: string): SortedResult {+ return { id: `${url}-text`, url, type: "text", content };+}++describe("mergeDocsResults", () => {+ it("keeps a guide whose title matched above the components", () => {+ const docs = [+ page("/docs/getting-started/installation", "<mark>Installation</mark>"),+ text("/docs/getting-started/installation#cli", "Run the CLI"),+ ];++ const merged = mergeDocsResults(+ "installation",+ docs,+ [clock],+ COMPONENT_URLS,+ );++ expect(merged.map((r) => r.url)).toEqual([+ "/docs/getting-started/installation",+ "/docs/getting-started/installation#cli",+ "/docs/numbers/clock-sweep",+ "/docs/numbers/clock-sweep",+ ]);+ });++ it("puts components above text matches that only mention the words", () => {+ const docs = [+ page("/docs/guides/timing", "Timing"),+ text("/docs/guides/timing#minutes", "takes five <mark>minutes</mark>"),+ ];++ const merged = mergeDocsResults(+ "setup takes five minutes",+ docs,+ [clock],+ COMPONENT_URLS,+ );++ expect(merged[0]).toMatchObject({+ id: "component:clock-sweep",+ type: "page",+ content: "Clock Sweep",+ breadcrumbs: ["Numbers"],+ });+ expect(merged[1].content).toBe(clock.description);+ expect(merged.at(-1)?.url).toBe("/docs/guides/timing#minutes");+ });++ it("shows a component once when the full-text search found its page too", () => {+ const docs = [+ {+ ...page(clock.url, "<mark>Clock</mark> Sweep"),+ breadcrumbs: ["Stats"],+ },+ text(`${clock.url}#usage`, "Usage"),+ ];++ const merged = mergeDocsResults("clock", docs, [clock], COMPONENT_URLS);++ expect(merged.map((r) => r.id)).toEqual([+ "component:clock-sweep",+ "component:clock-sweep:description",+ ]);+ expect(merged[0].breadcrumbs).toEqual(["Stats"]);+ });++ it("does not promote a component page as if it were a guide", () => {+ const docs = [page("/docs/ui/tabs", "<mark>Tabs</mark>")];++ const merged = mergeDocsResults("tabs", docs, [clock], COMPONENT_URLS);++ expect(merged[0].id).toBe("component:clock-sweep");+ expect(merged.at(-1)?.url).toBe("/docs/ui/tabs");+ });++ it("does not promote a guide that shares one word with a described need", () => {+ const docs = [page("/docs/guides/setup", "<mark>Setup</mark>")];++ const merged = mergeDocsResults(+ "show that setup only takes five minutes",+ docs,+ [clock],+ COMPONENT_URLS,+ );++ expect(merged[0].id).toBe("component:clock-sweep");+ expect(merged.at(-1)?.url).toBe("/docs/guides/setup");+ });+});diff --git a/lib/search/docs-merge.ts b/lib/search/docs-merge.tsnew file mode 100644index 00000000..bda24836--- /dev/null+++ b/lib/search/docs-merge.ts@@ -0,0 +1,115 @@+import type { SortedResult } from "fumadocs-core/search";+import { tokenize } from "@/lib/mcp/search";++/**+ * Puts component matches into the docs search results, which the search+ * dialog renders as a flat list of pages with their matched lines underneath.+ * Pure, so the ordering is testable without the search servers.+ */++export interface ComponentHit {+ name: string;+ title: string;+ description: string;+ /** Site-relative docs URL of the component page. */+ url: string;+ /** Docs section the page sits in, shown as its breadcrumb. */+ section: string;+}++function pageUrl(url: string): string {+ return url.split("#")[0];+}++/** Full-text results arrive as a page row followed by its matched lines. */+function groupByPage(results: SortedResult[]): Map<string, SortedResult[]> {+ const groups = new Map<string, SortedResult[]>();+ for (const result of results) {+ const key = pageUrl(result.url);+ const group = groups.get(key);+ if (group) group.push(result);+ else groups.set(key, [result]);+ }+ return groups;+}++function wordsOverlap(a: string, b: string): boolean {+ return a === b || (a.length >= 4 && b.startsWith(a)) || a.startsWith(b);+}++/**+ * Whether the visitor is asking for this page by its title: at least half of+ * the query's words appear in it. One shared word out of seven ("show that+ * setup only takes five minutes" against the Setup guide) is a description+ * that happens to touch the title, not a request for the guide.+ */+function namesTitle(group: SortedResult[], queryWords: string[]): boolean {+ const title = group.find((r) => r.type === "page")?.content;+ if (!title || queryWords.length === 0) return false;+ const titleWords = tokenize(title.replace(/<\/?mark>/g, ""));+ const shared = queryWords.filter((word) =>+ titleWords.some((titleWord) => wordsOverlap(word, titleWord)),+ );+ return shared.length * 2 >= queryWords.length;+}++function sectionLabel(slug: string): string {+ return slug.replace(/(^|-)([a-z])/g, (_, sep: string, c: string) =>+ (sep ? " " : "").concat(c.toUpperCase()),+ );+}++/**+ * Order: guides the query names by title, then the components that fit the+ * need, then every other full-text match.+ *+ * A guide the visitor named ("installation", "mcp") must not sink below+ * components, because the component search always returns its nearest+ * neighbours, relevant or not. Components come before the remaining text+ * matches because a need-style query ("show revenue growing") rarely shares+ * words with any page, and the text matches for it are incidental.+ */+export function mergeDocsResults(+ query: string,+ docs: SortedResult[],+ components: ComponentHit[],+ componentUrls: ReadonlySet<string>,+): SortedResult[] {+ const groups = groupByPage(docs);+ const queryWords = tokenize(query);+ const shown = new Set(components.map((c) => c.url));++ const guides: SortedResult[] = [];+ const rest: SortedResult[] = [];+ for (const [url, group] of groups) {+ if (shown.has(url)) continue;+ if (!componentUrls.has(url) && namesTitle(group, queryWords))+ guides.push(...group);+ else rest.push(...group);+ }++ const componentRows = components.flatMap((component): SortedResult[] => {+ const breadcrumbs = groups+ .get(component.url)+ ?.find((r) => r.type === "page")?.breadcrumbs ?? [+ sectionLabel(component.section),+ ];+ return [+ {+ id: `component:${component.name}`,+ url: component.url,+ type: "page",+ content: component.title,+ breadcrumbs,+ },+ {+ id: `component:${component.name}:description`,+ url: component.url,+ type: "text",+ content: component.description,+ },+ ];+ });++ return [...guides, ...componentRows, ...rest];+}diff --git a/lib/search/hybrid.test.ts b/lib/search/hybrid.test.tsnew file mode 100644index 00000000..65715e2d--- /dev/null+++ b/lib/search/hybrid.test.ts@@ -0,0 +1,157 @@+import { describe, expect, it } from "bun:test";+import type { ComponentRecord } from "@/lib/mcp/search";+import { fuseRankings, hybridSearch, rankByVectors } from "./hybrid";++function record(+ name: string,+ overrides: Partial<ComponentRecord> = {},+): ComponentRecord {+ return {+ name,+ title: name,+ description: "",+ section: "typography",+ docs: "",+ useWhen: [],+ avoidWhen: [],+ askedAs: [],+ install: "",+ ...overrides,+ };+}++describe("fuseRankings", () => {+ it("puts a name both lists agree on above each list's own top hit", () => {+ const fused = fuseRankings(["a", "shared", "b"], ["c", "shared", "d"]);++ expect(fused[0]).toBe("shared");+ });++ it("keeps the order of a single list", () => {+ expect(fuseRankings(["a", "b", "c"], [])).toEqual(["a", "b", "c"]);+ });+});++describe("rankByVectors", () => {+ it("scores a component by its closest row", () => {+ // Two rows for `clock` (description, phrasing), one for `chart`.+ const vectors = new Float32Array([0, 1, 1, 0, 0.6, 0.8]);+ const hits = rankByVectors(+ new Float32Array([1, 0]),+ vectors,+ ["clock", "clock", "chart"],+ 2,+ );++ expect(hits.map((h) => h.name)).toEqual(["clock", "chart"]);+ expect(hits[0].score).toBe(1);+ });+});++describe("hybridSearch", () => {+ const records = [+ record("clock-sweep", { description: "A clock hand sweeps a wedge" }),+ record("typewriter", { description: "Types text one character at a time" }),+ record("bar-chart", { description: "Bars grow to their values" }),+ ];++ it("finds a need the catalog shares no words with", () => {+ const semantic = [+ { name: "clock-sweep", score: 0.9 },+ { name: "bar-chart", score: 0.8 },+ { name: "typewriter", score: 0.7 },+ ];++ const results = hybridSearch(+ records,+ "setup takes five minutes",+ semantic,+ 2,+ );++ expect(results.map((r) => r.name)).toEqual(["clock-sweep", "bar-chart"]);+ });++ it("lets an exact name win over a semantic look-alike", () => {+ const semantic = [+ { name: "bar-chart", score: 0.9 },+ { name: "clock-sweep", score: 0.89 },+ { name: "typewriter", score: 0.88 },+ ];++ const results = hybridSearch(records, "typewriter", semantic, 3);++ expect(results[0].name).toBe("typewriter");+ });++ it("pins the named component above a sibling both rankings prefer", () => {+ const siblings = [+ record("typewriter", { title: "Typewriter" }),+ record("caption-typewriter", {+ title: "Typewriter",+ description: "typewriter typewriter captions",+ useWhen: ["typewriter subtitles"],+ }),+ ];+ const semantic = [+ { name: "caption-typewriter", score: 0.95 },+ { name: "typewriter", score: 0.7 },+ ];++ const results = hybridSearch(siblings, "Typewriter", semantic, 2);++ expect(results.map((r) => r.name)).toEqual([+ "typewriter",+ "caption-typewriter",+ ]);+ });++ it("pins a component named inside a short keyword query", () => {+ const semantic = [+ { name: "bar-chart", score: 0.9 },+ { name: "clock-sweep", score: 0.89 },+ ];++ const results = hybridSearch(records, "typewriter headline", semantic, 3);++ expect(results[0].name).toBe("typewriter");+ });++ it("does not pin a name that is one common word of a long description", () => {+ const withButton = [+ ...records,+ record("button", { description: "A button that presses" }),+ record("trim-burst", { description: "Strokes shoot out from a point" }),+ ];+ const semantic = [+ { name: "trim-burst", score: 0.9 },+ { name: "button", score: 0.8 },+ ];++ const results = hybridSearch(+ withButton,+ "tiny sparkle lines radiating out when a button gets pressed",+ semantic,+ 2,+ );++ expect(results[0].name).toBe("trim-burst");+ });++ it("drops semantic hits the filters already excluded", () => {+ const semantic = [+ { name: "filtered-out", score: 0.95 },+ { name: "clock-sweep", score: 0.9 },+ ];++ const results = hybridSearch(records, "elapsed time", semantic, 5);++ expect(results.map((r) => r.name)).not.toContain("filtered-out");+ });++ it("falls back to the keyword ranking when the index is unavailable", () => {+ const results = hybridSearch(records, "clock", null, 5);++ expect(results.map((r) => r.name)).toEqual(["clock-sweep"]);+ });+});diff --git a/lib/search/hybrid.ts b/lib/search/hybrid.tsnew file mode 100644index 00000000..2d374e94--- /dev/null+++ b/lib/search/hybrid.ts@@ -0,0 +1,143 @@+import {+ type ComponentRecord,+ normalizeName,+ rankComponents,+ searchComponents,+ tokenize,+} from "@/lib/mcp/search";++/**+ * Pure ranking math for the hybrid component search. No I/O and no model here,+ * so it is testable with plain arrays: `lib/search/semantic.ts` supplies the+ * vectors, `lib/mcp/search.ts` the lexical ranking.+ */++/**+ * Rank constant of reciprocal rank fusion. 60 is the value from the original+ * paper; it keeps one list's top hit from drowning out a component that both+ * lists agree on.+ */+const RRF_K = 60;++/**+ * How many semantic neighbours take part in the fusion. The model always+ * returns a nearest neighbour, however far away, so the tail is noise.+ */+export const SEMANTIC_CANDIDATES = 100;++/**+ * Reciprocal rank fusion of ranked name lists, best first. A name scores+ * `1 / (k + rank)` in each list it appears in; ties keep the order of the+ * first list.+ */+export function fuseRankings(...rankings: string[][]): string[] {+ const scores = new Map<string, number>();+ for (const ranking of rankings) {+ ranking.forEach((name, index) => {+ scores.set(name, (scores.get(name) ?? 0) + 1 / (RRF_K + index + 1));+ });+ }+ return [...scores.entries()]+ .sort((a, b) => b[1] - a[1])+ .map(([name]) => name);+}++export interface SemanticHit {+ name: string;+ /** Cosine similarity of the query to the component's closest vector. */+ score: number;+}++/**+ * Best row per component, best component first. `vectors` holds `rows.length`+ * unit vectors of `dim` floats back to back, so the dot product is the cosine.+ */+export function rankByVectors(+ query: Float32Array,+ vectors: Float32Array,+ rows: string[],+ dim: number,+): SemanticHit[] {+ const best = new Map<string, number>();+ for (let row = 0; row < rows.length; row++) {+ const offset = row * dim;+ let dot = 0;+ for (let i = 0; i < dim; i++) dot += query[i] * vectors[offset + i];+ const name = rows[row];+ const previous = best.get(name);+ if (previous === undefined || dot > previous) best.set(name, dot);+ }+ return [...best.entries()]+ .map(([name, score]) => ({ name, score }))+ .sort((a, b) => b.score - a.score || a.name.localeCompare(b.name));+}++/**+ * The component search: candidates ranked by meaning and by words, fused.+ *+ * `semantic` is `null` when the index or the model is not available; the+ * search then degrades to the keyword ranking instead of failing. The two+ * halves cover each other: words pin down an exact name (`typewriter`) that+ * the model may place below a look-alike, meaning finds a need phrased in+ * words the catalog never uses, in any language.+ */+export function hybridSearch(+ candidates: ComponentRecord[],+ query: string,+ semantic: SemanticHit[] | null,+ limit: number,+): ComponentRecord[] {+ if (!semantic || query.trim() === "") {+ return searchComponents(candidates, { query, limit });+ }+ const byName = new Map(candidates.map((record) => [record.name, record]));+ const byMeaning = semantic+ .filter((hit) => byName.has(hit.name))+ .slice(0, SEMANTIC_CANDIDATES)+ .map((hit) => hit.name);+ const byWords = rankComponents(candidates, query).map((r) => r.record.name);++ const named = namedComponents(candidates, query, byWords);+ const fused = fuseRankings(byMeaning, byWords).filter(+ (name) => !named.includes(name),+ );++ return [...named, ...fused]+ .slice(0, limit)+ .flatMap((name) => byName.get(name) ?? []);+}++/**+ * Components the query calls by name, in keyword order. A query like+ * `typewriter headline` is a lookup, not a description, and the model is at+ * its weakest on two bare words: without this rule the named component sinks+ * below look-alikes that both rankings happen to agree on.+ *+ * A name counts as called when every part of it is a word of the query and it+ * makes up at least half of the query. The share keeps a common noun in a+ * long description ("... when a button gets pressed") from pinning `button`.+ */+function namedComponents(+ candidates: ComponentRecord[],+ query: string,+ byWords: string[],+): string[] {+ const words = tokenize(query);+ const exact = normalizeName(query);+ const named = candidates+ .filter((record) => {+ if (record.name === exact) return true;+ const parts = record.name.split("-");+ return (+ parts.every((part) => words.includes(part)) &&+ parts.length * 2 >= words.length+ );+ })+ .map((record) => record.name);+ const order = (name: string) => {+ if (name === exact) return -1;+ const index = byWords.indexOf(name);+ return index === -1 ? Number.POSITIVE_INFINITY : index;+ };+ return named.sort((a, b) => order(a) - order(b));+}diff --git a/lib/search/model.ts b/lib/search/model.tsnew file mode 100644index 00000000..d031fff6--- /dev/null+++ b/lib/search/model.ts@@ -0,0 +1,38 @@+/**+ * What the build script and the server have to agree on: which embedding model+ * wrote the index and how its inputs are prefixed. A vector is only comparable+ * to another one from the same model, so the server refuses an index whose+ * `model` differs from `MODEL_ID`.+ *+ * `multilingual-e5-small` runs in-process on CPU (about 120 MB quantized, a few+ * milliseconds per query), so a search costs nothing and needs no API key. It+ * is multilingual: the catalog is English, queries need not be.+ */++export const MODEL_ID = "Xenova/multilingual-e5-small";+export const MODEL_DTYPE = "q8";+export const EMBEDDING_DIM = 384;++/** e5 models are trained with these prefixes; leaving them out costs recall. */+export const QUERY_PREFIX = "query: ";+export const PASSAGE_PREFIX = "passage: ";++/** Bump when the index layout or the embedded text changes. */+export const INDEX_VERSION = 1;++/** Git-ignored: written by `bun run search:build`, read by the server. */+export const SEARCH_DIR = ".search";+export const INDEX_META_FILE = "index.json";+export const INDEX_VECTORS_FILE = "index.bin";+export const MODEL_CACHE_DIR = "models";++export interface SearchIndexMeta {+ version: number;+ model: string;+ dim: number;+ /**+ * Component name per vector row. A component owns several rows: one for its+ * description and one per `askedAs` phrasing.+ */+ rows: string[];+}diff --git a/lib/search/semantic.ts b/lib/search/semantic.tsnew file mode 100644index 00000000..38fe6dea--- /dev/null+++ b/lib/search/semantic.ts@@ -0,0 +1,129 @@+import "server-only";++import { existsSync, readFileSync } from "node:fs";+import { join } from "node:path";+import { rankByVectors, type SemanticHit } from "@/lib/search/hybrid";+import {+ INDEX_META_FILE,+ INDEX_VECTORS_FILE,+ INDEX_VERSION,+ MODEL_CACHE_DIR,+ MODEL_DTYPE,+ MODEL_ID,+ QUERY_PREFIX,+ SEARCH_DIR,+ type SearchIndexMeta,+} from "@/lib/search/model";++/**+ * The semantic half of the component search: a query is embedded by a small+ * model running in this process and compared against vectors that+ * `bun run search:build` wrote ahead of time.+ *+ * Everything here is optional. With no index on disk (a fresh checkout that+ * never ran the build), a model that fails to load, or a model that is still+ * loading, `semanticRank` resolves to `null` and the caller ranks by words+ * alone.+ */++interface LoadedIndex {+ rows: string[];+ dim: number;+ vectors: Float32Array;+}++type Embed = (text: string) => Promise<Float32Array>;++/** A cold model takes seconds to load; a request should not wait for it. */+const EMBED_TIMEOUT_MS = 800;++let index: LoadedIndex | null | undefined;+let embedder: Promise<Embed | null> | undefined;++function searchDir(): string {+ return join(process.cwd(), SEARCH_DIR);+}++function loadIndex(): LoadedIndex | null {+ if (index !== undefined) return index;+ index = null;+ const metaPath = join(searchDir(), INDEX_META_FILE);+ const vectorsPath = join(searchDir(), INDEX_VECTORS_FILE);+ if (!existsSync(metaPath) || !existsSync(vectorsPath)) return index;+ try {+ const meta = JSON.parse(readFileSync(metaPath, "utf8")) as SearchIndexMeta;+ if (meta.version !== INDEX_VERSION || meta.model !== MODEL_ID) {+ console.warn(+ "[search] the index was built for another model or layout; run `bun run search:build`. Falling back to keyword search.",+ );+ return index;+ }+ const file = readFileSync(vectorsPath);+ // Copy into a fresh buffer: a Buffer may start at an offset that is not a+ // multiple of four, which a Float32Array view cannot sit on.+ const vectors = new Float32Array(+ file.buffer.slice(file.byteOffset, file.byteOffset + file.byteLength),+ );+ if (vectors.length !== meta.rows.length * meta.dim) {+ console.warn(+ "[search] the index is truncated; run `bun run search:build`.",+ );+ return index;+ }+ index = { rows: meta.rows, dim: meta.dim, vectors };+ } catch (error) {+ console.warn("[search] could not read the index:", error);+ }+ return index;+}++function loadEmbedder(): Promise<Embed | null> {+ embedder ??= (async () => {+ try {+ const { env, pipeline } = await import("@huggingface/transformers");+ // The build step downloads the model next to the index. The server only+ // ever reads it from there and never reaches out to the network.+ env.cacheDir = join(searchDir(), MODEL_CACHE_DIR);+ env.allowRemoteModels = false;+ const extractor = await pipeline("feature-extraction", MODEL_ID, {+ dtype: MODEL_DTYPE,+ });+ return async (text: string) => {+ const output = await extractor(QUERY_PREFIX + text, {+ pooling: "mean",+ normalize: true,+ });+ return output.data as Float32Array;+ };+ } catch (error) {+ console.warn(+ "[search] the embedding model did not load; using keyword search only:",+ error,+ );+ return null;+ }+ })();+ return embedder;+}++/**+ * Components ordered by how close they are to the query in meaning, or `null`+ * when the semantic index is not available for this request.+ */+export async function semanticRank(+ query: string,+): Promise<SemanticHit[] | null> {+ const loaded = loadIndex();+ if (!loaded) return null;++ const timeout = new Promise<null>((resolve) => {+ setTimeout(() => resolve(null), EMBED_TIMEOUT_MS).unref();+ });+ const vector = await Promise.race([+ loadEmbedder().then((embed) => (embed ? embed(query) : null)),+ timeout,+ ]).catch(() => null);+ if (!vector) return null;++ return rankByVectors(vector, loaded.vectors, loaded.rows, loaded.dim);+}diff --git a/lib/server/analytics.ts b/lib/server/analytics.tsindex 29a9048d..79ab41ce 100644--- a/lib/server/analytics.ts+++ b/lib/server/analytics.ts@@ -1,6 +1,12 @@import "server-only";import { OpenPanel } from "@openpanel/sdk";+import {+ classifyAgentClient,+ describeQuery,+ loggedQuery,+ type SearchSurface,+} from "@/lib/search/analytics-shape";const CRAWLER_UA =/bot\b|bot[/_-]|crawler|crawling|spider|slurp|facebookexternalhit|feedfetcher|mediapartners/i;@@ -44,3 +50,82 @@ export async function trackRegistryInstall(// A metrics outage must never surface to the caller — the payload already shipped.}}++/**+ * Whether agent searches are recorded with their text. Off: the privacy policy+ * (`app/(home)/legal/content.tsx`, "MCP server") promises that what an agent+ * sends is discarded, so an agent search is described by its shape (length,+ * script) and by the components it returned, never quoted. Turning this on+ * means rewriting that promise first.+ */+const LOG_AGENT_QUERY_TEXT = false;++function send(event: string, properties: Record<string, unknown>): void {+ // Never awaited: analytics must not add to a response time, and a metrics+ // outage must never reach the caller.+ void Promise.resolve()+ .then(() => openPanel()?.track(event, properties))+ .catch(() => {});+}++export interface AgentSearch {+ surface: Extract<SearchSurface, "mcp" | "api">;+ userAgent: string;+ query: string;+ /** Component names in the order they were returned. */+ results: string[];+ /** `keyword` when the semantic index or model was not available. */+ mode?: "hybrid" | "keyword";+ latencyMs: number;+ vibe?: string;+ maxLength?: number;+}++/**+ * A search made by a program: an MCP `search_components` call or a direct+ * call to `/api/search`. Same event name as the dialog's, told apart by+ * `actor` and `surface`.+ */+export function trackAgentSearch(search: AgentSearch): void {+ if (isCrawler(search.userAgent)) return;+ send("search_performed", {+ actor: "agent",+ surface: search.surface,+ client: classifyAgentClient(search.userAgent),+ user_agent: search.userAgent.slice(0, 200),+ ...(LOG_AGENT_QUERY_TEXT ? { query: loggedQuery(search.query) } : {}),+ ...describeQuery(search.query),+ result_count: search.results.length,+ component_count: search.results.length,+ has_results: search.results.length > 0,+ top_components: search.results.slice(0, 6).join(","),+ ...(search.mode ? { mode: search.mode } : {}),+ latency_ms: Math.round(search.latencyMs),+ ...(search.vibe ? { vibe: search.vibe } : {}),+ ...(search.maxLength !== undefined ? { max_length: search.maxLength } : {}),+ });+}++/**+ * An agent asked for one component by name (`get_component`,+ * `preview_component`). Set against the searches that returned that component,+ * it is the closest thing to a click: the agent went on to read or show it.+ * `found: false` is a name the agent made up or misread.+ */+export function trackAgentComponentFetch(fetch: {+ tool: "get_component" | "preview_component";+ userAgent: string;+ /** Resolved component name, or the raw input when nothing matched. */+ component: string;+ found: boolean;+}): void {+ if (isCrawler(fetch.userAgent)) return;+ send("component_fetched", {+ actor: "agent",+ surface: "mcp",+ client: classifyAgentClient(fetch.userAgent),+ tool: fetch.tool,+ component: fetch.found ? fetch.component : "",+ found: fetch.found,+ });+}diff --git a/package.json b/package.jsonindex 6c9406f4..d8999794 100644--- a/package.json+++ b/package.json@@ -30,6 +30,8 @@"format": "biome format --write","registry:build": "shadcn build --output registry-artifacts && bun scripts/build-elements.mts && biome format --write registry-artifacts","registry:check": "shadcn build --output registry-artifacts && bun scripts/build-elements.mts && biome format --write registry-artifacts && git diff --quiet -- registry-artifacts || (echo 'registry-artifacts is out of sync with registry/ sources. Run: bun run registry:build and commit the result.' && exit 1)",+ "search:build": "bun scripts/build-search-index.mts",+ "search:eval": "bun scripts/eval-search.mts","manifest:build": "bun scripts/build-preview-manifest.mts && biome format --write registry/__manifest__.ts","manifest:check": "bun run manifest:build && git diff --quiet -- registry/__manifest__.ts || (echo 'registry/__manifest__.ts is out of sync with registry config sources. Run: bun run manifest:build and commit the result.' && exit 1)","studio": "remotion studio",@@ -50,6 +52,7 @@"@fontsource/roboto-mono": "^5.3.0","@hugeicons/core-free-icons": "^4.3.0","@hugeicons/react": "^1.1.10",+ "@huggingface/transformers": "^4.3.2","@modelcontextprotocol/server": "^2.3.1","@openpanel/nextjs": "^1.0.13","@openpanel/sdk": "^1.3.1",diff --git a/scripts/build-search-index.mts b/scripts/build-search-index.mtsnew file mode 100644index 00000000..0d008af7--- /dev/null+++ b/scripts/build-search-index.mts@@ -0,0 +1,87 @@+import { mkdirSync, writeFileSync } from "node:fs";+import path from "node:path";+import { env, pipeline } from "@huggingface/transformers";+import {+ EMBEDDING_DIM,+ INDEX_META_FILE,+ INDEX_VECTORS_FILE,+ INDEX_VERSION,+ MODEL_CACHE_DIR,+ MODEL_DTYPE,+ MODEL_ID,+ PASSAGE_PREFIX,+ QUERY_PREFIX,+ SEARCH_DIR,+ type SearchIndexMeta,+} from "@/lib/search/model";+import { loadComponentRecords, ROOT } from "./search-records.mts";++/**+ * Embeds the component catalog for the semantic half of the search and writes+ * `.search/index.{json,bin}`. Also the step that downloads the model into+ * `.search/models`, which is where the server loads it from, so run it before+ * `next start` (the Dockerfile does). Without its output the site still+ * searches, by words only.+ *+ * A component gets one vector for what it is (title, description, `useWhen`)+ * and one per `askedAs` phrasing. The phrasings are embedded as queries: a+ * visitor's query is then compared to other queries, which the model matches+ * more tightly than a query to a long description.+ */++const BATCH = 32;++const outDir = path.join(ROOT, SEARCH_DIR);+mkdirSync(outDir, { recursive: true });+env.cacheDir = path.join(outDir, MODEL_CACHE_DIR);++const records = loadComponentRecords();+const rows: string[] = [];+const texts: string[] = [];+for (const record of records) {+ rows.push(record.name);+ texts.push(+ `${PASSAGE_PREFIX}${record.title}. ${record.description} ${record.useWhen.join(" ")}`,+ );+ for (const phrasing of record.askedAs) {+ rows.push(record.name);+ texts.push(QUERY_PREFIX + phrasing);+ }+}++const started = performance.now();+const extractor = await pipeline("feature-extraction", MODEL_ID, {+ dtype: MODEL_DTYPE,+});++const vectors = new Float32Array(texts.length * EMBEDDING_DIM);+for (let start = 0; start < texts.length; start += BATCH) {+ const output = await extractor(texts.slice(start, start + BATCH), {+ pooling: "mean",+ normalize: true,+ });+ if (output.dims.at(-1) !== EMBEDDING_DIM) {+ throw new Error(+ `${MODEL_ID} returned ${output.dims.at(-1)} dimensions, expected ${EMBEDDING_DIM}`,+ );+ }+ vectors.set(output.data as Float32Array, start * EMBEDDING_DIM);+}++const meta: SearchIndexMeta = {+ version: INDEX_VERSION,+ model: MODEL_ID,+ dim: EMBEDDING_DIM,+ rows,+};+writeFileSync(path.join(outDir, INDEX_META_FILE), JSON.stringify(meta));+writeFileSync(+ path.join(outDir, INDEX_VECTORS_FILE),+ Buffer.from(vectors.buffer, vectors.byteOffset, vectors.byteLength),+);++const seconds = ((performance.now() - started) / 1000).toFixed(1);+const megabytes = (vectors.byteLength / 1e6).toFixed(1);+console.log(+ `search index: ${records.length} components, ${rows.length} vectors, ${megabytes} MB, ${seconds}s`,+);diff --git a/scripts/eval-search.mts b/scripts/eval-search.mtsnew file mode 100644index 00000000..ddbb7bbb--- /dev/null+++ b/scripts/eval-search.mts@@ -0,0 +1,138 @@+import { existsSync, readFileSync } from "node:fs";+import path from "node:path";+import { env, pipeline } from "@huggingface/transformers";+import { searchComponents } from "@/lib/mcp/search";+import { hybridSearch, rankByVectors } from "@/lib/search/hybrid";+import {+ INDEX_META_FILE,+ INDEX_VECTORS_FILE,+ MODEL_CACHE_DIR,+ MODEL_DTYPE,+ MODEL_ID,+ QUERY_PREFIX,+ SEARCH_DIR,+ type SearchIndexMeta,+} from "@/lib/search/model";+import { loadComponentRecords, ROOT } from "./search-records.mts";++/**+ * Scores the component search against `evals/search/golden.json`: described+ * needs in English and Russian plus name and keyword lookups, each with the+ * component (or interchangeable components) it should surface. The two kinds+ * pull in opposite directions (meaning helps the first, exact words the+ * second), so a ranking change has to hold up on both. Prints how often the expected component lands in the top 1, 5 and+ * 10 for the keyword ranking alone and for the hybrid ranking, then lists the+ * hybrid misses. Run `bun run search:build` first.+ *+ * A golden query names one right answer in a catalog full of near siblings, so+ * a miss is sometimes a different component that fits just as well. Read the+ * numbers as a comparison between rankings, not as an absolute hit rate.+ */++interface GoldenQuery {+ query: string;+ expect: string[];+ /** `ru` for a non-English need; the catalog itself is English. */+ lang?: string;+ /** `keyword` for a name or two bare words rather than a described need. */+ kind?: string;+}++const TOP = 10;++const dir = path.join(ROOT, SEARCH_DIR);+const metaPath = path.join(dir, INDEX_META_FILE);+if (!existsSync(metaPath)) {+ console.error("No search index. Run `bun run search:build` first.");+ process.exit(1);+}+const meta = JSON.parse(readFileSync(metaPath, "utf8")) as SearchIndexMeta;+const file = readFileSync(path.join(dir, INDEX_VECTORS_FILE));+const vectors = new Float32Array(+ file.buffer.slice(file.byteOffset, file.byteOffset + file.byteLength),+);++env.cacheDir = path.join(dir, MODEL_CACHE_DIR);+env.allowRemoteModels = false;+const extractor = await pipeline("feature-extraction", MODEL_ID, {+ dtype: MODEL_DTYPE,+});++const records = loadComponentRecords();+const golden = JSON.parse(+ readFileSync(path.join(ROOT, "evals/search/golden.json"), "utf8"),+) as GoldenQuery[];++function rankOf(names: string[], expect: string[]): number {+ const index = names.findIndex((name) => expect.includes(name));+ return index === -1 ? Number.POSITIVE_INFINITY : index + 1;+}++const rows: {+ golden: GoldenQuery;+ keyword: number;+ hybrid: number;+ top: string[];+}[] = [];+for (const entry of golden) {+ const output = await extractor(QUERY_PREFIX + entry.query, {+ pooling: "mean",+ normalize: true,+ });+ const semantic = rankByVectors(+ output.data as Float32Array,+ vectors,+ meta.rows,+ meta.dim,+ );+ const keyword = searchComponents(records, { query: entry.query, limit: TOP });+ const hybrid = hybridSearch(records, entry.query, semantic, TOP);+ rows.push({+ golden: entry,+ keyword: rankOf(+ keyword.map((r) => r.name),+ entry.expect,+ ),+ hybrid: rankOf(+ hybrid.map((r) => r.name),+ entry.expect,+ ),+ top: hybrid.slice(0, 3).map((r) => r.name),+ });+}++function report(label: string, ranks: number[]) {+ const share = (k: number) =>+ `${Math.round((ranks.filter((r) => r <= k).length / ranks.length) * 100)}%`.padStart(+ 4,+ );+ console.log(+ `${label.padEnd(22)} top1 ${share(1)} top5 ${share(5)} top10 ${share(10)}`,+ );+}++const groupOf = (entry: GoldenQuery) =>+ entry.kind ?? `described need, ${entry.lang ?? "en"}`;+for (const group of new Set(golden.map(groupOf))) {+ const subset = rows.filter((r) => groupOf(r.golden) === group);+ console.log(`\n${group} (${subset.length} queries)`);+ report(+ " keyword only",+ subset.map((r) => r.keyword),+ );+ report(+ " hybrid",+ subset.map((r) => r.hybrid),+ );+}++const misses = rows.filter((r) => r.hybrid > 5);+console.log(`\nhybrid misses outside the top 5: ${misses.length}`);+for (const miss of misses) {+ const rank = Number.isFinite(miss.hybrid)+ ? `rank ${miss.hybrid}`+ : "not in top 10";+ console.log(+ ` "${miss.golden.query}"\n expected ${miss.golden.expect[0]} (${rank}), got ${miss.top.join(", ")}`,+ );+}diff --git a/scripts/search-records.mts b/scripts/search-records.mtsnew file mode 100644index 00000000..72f63e73--- /dev/null+++ b/scripts/search-records.mts@@ -0,0 +1,50 @@+import { readFileSync } from "node:fs";+import path from "node:path";+import { fileURLToPath } from "node:url";+import { Glob } from "bun";+import { type ComponentRecord, installCommand } from "@/lib/mcp/search";++const here = path.dirname(fileURLToPath(import.meta.url));+export const ROOT = path.resolve(here, "..");++/**+ * The component catalog straight from the docs frontmatter, for scripts that+ * run outside Next (the server builds the same records from the fumadocs+ * source in `lib/mcp/catalog.ts`). Files are read in sorted order and a+ * component belongs to the first page that declares it.+ */+export function loadComponentRecords(): ComponentRecord[] {+ const records: ComponentRecord[] = [];+ const seen = new Set<string>();+ const files = [...new Glob("content/docs/**/*.mdx").scanSync(ROOT)].sort();+ for (const file of files) {+ const src = readFileSync(path.join(ROOT, file), "utf8");+ const end = src.indexOf("\n---", 3);+ if (!src.startsWith("---") || end === -1) continue;+ const data = (Bun.YAML.parse(src.slice(4, end)) ?? {}) as Record<+ string,+ unknown+ >;+ const name = data.component;+ if (typeof name !== "string" || seen.has(name)) continue;+ seen.add(name);+ const strings = (value: unknown): string[] =>+ Array.isArray(value)+ ? value.filter((v): v is string => typeof v === "string")+ : [];+ records.push({+ name,+ title: typeof data.title === "string" ? data.title : name,+ description: typeof data.description === "string" ? data.description : "",+ section: file.split("/")[2] ?? "",+ docs: "",+ vibe: typeof data.vibe === "string" ? data.vibe : undefined,+ length: data.length as ComponentRecord["length"],+ useWhen: strings(data.useWhen),+ avoidWhen: strings(data.avoidWhen),+ askedAs: strings(data.askedAs),+ install: installCommand(name),+ });+ }+ return records;+}