{"name":"catalog","entry":"component","title":"Catalog","description":"Catalogue sheet whose interface pieces arrive and get checked off, then unfolds a second row of design-token glyphs.","category":"Motion","capabilities":["replay","player"],"needsRemotion":true,"registryDependencies":["@jbm/tokens","@jbm/motion-hooks","@jbm/pop","@jbm/paper","@jbm/ui-bits","@jbm/rebuild-screens"],"install":"npx shadcn@latest add @jbm/catalog","installName":"catalog","page":"https://jbm-ui.bns.studio/c/catalog","registryItem":"https://jbm-ui.bns.studio/r/catalog.json","sourcePath":"registry/jbm/motion/catalog.tsx","files":[{"source":"registry/jbm/motion/catalog.tsx","target":"src/jbm/motion/catalog.tsx","import":"@/jbm/motion/catalog","type":"registry:component"}],"endpoints":{"markdown":"https://jbm-ui.bns.studio/catalog/catalog.md","json":"https://jbm-ui.bns.studio/catalog/catalog.json"},"snippet":"import { Catalog } from \"@/jbm/motion/catalog\"\n\n<Catalog w={936} at={3.2} title=\"catálogo\"\n  items={[{ kind: \"button\", label: \"botón\", at: 7.4 }]}\n  tokens={[{ kind: \"color\", label: \"color\", at: 18.2 }]} />","api":[{"export":"Catalog","kind":"component","summary":"Paper sheet that springs up into place at `at`, with one dashed slot per column. Each item's Piece pops into its slot on its cue and a check badge pops on `checkDelay` seconds later. At `tokensAt` the sheet grows downward over 0.55 s behind a dashed divider to reveal a row of TokenGlyphs that pop in on their own cues. An optional ink title sticker sits over the top edge and a stamp lands across the bottom edge, below the rows; it overlaps only the sheet's bottom padding and extends about half its height below the sheet, so leave room under the component.","props":[{"name":"w","type":"number","required":true,"default":null,"description":"Sheet width in stage pixels; padding, gaps, slot size, pieces, captions, and badges all scale from it."},{"name":"at","type":"number","required":true,"default":null,"description":"Sheet entrance in seconds relative to the enclosing Sequence."},{"name":"title","type":"string","required":false,"default":null,"description":"Optional ink sticker label over the top-left edge; adds 30px of top padding inside the sheet."},{"name":"items","type":"CatalogItem[]","required":true,"default":null,"description":"Top-row slots: `kind` (button, card, or input), a caption `label`, and the `at` second its piece pops in."},{"name":"tokens","type":"CatalogToken[]","required":false,"default":"[]","description":"Optional second-row slots: `kind` (color, type, or space), a caption `label`, and the `at` second its glyph pops in. Empty means no token row."},{"name":"tokensAt","type":"number","required":false,"default":null,"description":"Second at which the token row unfolds. Defaults to 0.6 s before the first token's cue."},{"name":"stamp","type":"{ text: string; at: number }","required":false,"default":null,"description":"Optional loud word: `text` and the `at` second it stamps across the sheet's bottom edge, below the rows, never over a slot or caption."},{"name":"checkDelay","type":"number","required":false,"default":"0.5","description":"Seconds between an item's arrival and its check badge."}],"passthrough":[]}],"stage":{"mode":"declared","landscape":{"width":1200,"height":882},"vertical":{"width":936,"height":699},"basis":"Width is `w` (required); scene specs pass min(usable width, 1200) in landscape and 936 in vertical. Height is computed from w with three items, three tokens, and a title, fully unfolded: top padding (0.038 w + 30) + slot row (card height 0.8 × 0.78 slot width + caption + margin) + bottom padding + 4px border, plus the token block (two gaps of 0.031 w, a 3px divider, and a 0.9 × slot-width glyph row) once unfolded. Before unfolding it is 492 (landscape) / 393 (vertical). The title sticker extends 30px above the top edge. More columns shrink every slot."},"examples":[{"title":"Pieces, then tokens","code":"import { Catalog } from \"@/jbm/motion/catalog\"\n\n<Catalog w={936} at={3.2} title=\"catálogo\"\n  items={[{ kind: \"button\", label: \"botón\", at: 7.4 }]}\n  tokens={[{ kind: \"color\", label: \"color\", at: 18.2 }]} />"},{"title":"Full sheet with a stamp","code":"import { Catalog } from \"@/jbm/motion/catalog\"\n\n<Catalog w={936} at={0.2} title=\"catálogo\"\n  items={[\n    { kind: \"button\", label: \"botón\", at: 0.8 },\n    { kind: \"card\", label: \"tarjeta\", at: 1.2 },\n    { kind: \"input\", label: \"input\", at: 1.6 },\n  ]}\n  tokensAt={2.6}\n  tokens={[\n    { kind: \"color\", label: \"color\", at: 3.0 },\n    { kind: \"type\", label: \"tipografía\", at: 3.4 },\n    { kind: \"space\", label: \"espaciado\", at: 3.8 },\n  ]}\n  stamp={{ text: \"design tokens\", at: 4.4 }} />"}],"qa":["Step to the sheet entrance, each item arrival and its check badge, the middle of the unfold (token row partially revealed and clipped), and the end (all glyphs in, stamp settled across the bottom edge without covering any caption, including tipografía).","Check the fully unfolded sheet plus the title sticker above it fits the safe area in both orientations; the height grows by the token block when it unfolds.","Without tokens, confirm no divider or empty row appears and the stamp straddles the bottom edge just below the item row.","Check long captions at the scaled caption size stay inside their slots; captions are not truncated by the component."],"related":[{"name":"tokens","relation":"installs"},{"name":"motion-hooks","relation":"installs"},{"name":"pop","relation":"installs"},{"name":"paper","relation":"installs"},{"name":"ui-bits","relation":"installs"},{"name":"rebuild-screens","relation":"installs"},{"name":"scene-spec","relation":"installed-by"}],"galleryPreview":{"about":"Cue times are seconds on the gallery preview's timeline, which renders the demo below; the Usage examples may use other timings. Map a cue to your own props by its place in the demo.","fps":30,"durationInFrames":159,"lastFrame":158,"strip":"https://jbm-ui.bns.studio/c/catalog?view=strip","frames":[{"label":"Empty stage","frame":0,"at":0},{"label":"Pieces tested","frame":78,"at":2.6,"note":"Button, card, and input sit in their slots with checks; the token row is still folded."},{"label":"Tokens arriving","frame":105,"at":3.5,"note":"The sheet has unfolded and the colour glyph is in; type and spacing are still arriving."},{"label":"Tokens in","frame":129,"at":4.3,"note":"All three token glyphs have landed, just before the stamp."},{"label":"End","frame":158,"at":5.267}],"demo":[{"component":"Catalog","props":{"w":936,"at":0.2,"title":"catálogo","items":[{"kind":"button","label":"botón","at":0.8},{"kind":"card","label":"tarjeta","at":1.2},{"kind":"input","label":"input","at":1.6}],"tokensAt":2.6,"tokens":[{"kind":"color","label":"color","at":3},{"kind":"type","label":"tipografía","at":3.4},{"kind":"space","label":"espaciado","at":3.8}],"stamp":{"text":"design tokens","at":4.4}}}],"code":"<Catalog w={936} at={0.2} title=\"catálogo\" items={[{ kind: \"button\", label: \"botón\", at: 0.8 }, { kind: \"card\", label: \"tarjeta\", at: 1.2 }, { kind: \"input\", label: \"input\", at: 1.6 }]} tokensAt={2.6} tokens={[{ kind: \"color\", label: \"color\", at: 3 }, { kind: \"type\", label: \"tipografía\", at: 3.4 }, { kind: \"space\", label: \"espaciado\", at: 3.8 }]} stamp={{ text: \"design tokens\", at: 4.4 }} />"},"setup":{"namespace":"@jbm","componentsJson":{"registries":{"@jbm":"https://jbm-ui.bns.studio/r/{name}.json"}},"command":"npx shadcn@latest add @jbm/<name>","target":"src/jbm/","importAlias":"@/jbm/…","tsconfigPaths":{"@/*":["./src/*"]}},"rules":["Install through the @jbm namespace: each registry item JSON (/r/<name>.json) carries its files' contents and each guide is served at /docs/<slug>.md, so agents never need the source repository (it is public on GitHub for people browsing the code).","Files install to src/jbm/ and import as @/jbm/…, which needs the @/* → ./src/* path alias in tsconfig.json.","Items marked needsRemotion require the remotion package and must render inside a Remotion composition or Player; every other item works in any React page.","Use one vermilion accent per composition; accent2 is for annotations only and soft is for dark surfaces only.","Stages are 1920×1080 landscape and 1080×1920 vertical with declared safe areas; each item's stage field declares its size in stage pixels, and scenes compose from YAML-shaped specs with @jbm/scene-spec."],"links":{"catalog":"https://jbm-ui.bns.studio/catalog.json","llms":"https://jbm-ui.bns.studio/llms.txt"}}