@devinilabs/reelstack 1.2.0

package/docs/family-galleries/paper.md

@@ -0,0 +1,82 @@
+# Cream Paper — Family Reference
+
+> Editorial print mood. Warm, document-like, with depth in the dark-green card stack.
+
+The contrast move to Glass. Where Glass feels like premium product packaging, Paper feels like the product's launch announcement on quality paper stock.
+
+## Palette
+
+```
+bg              #f0ede8   Warm cream paper.
+bgWarm          #e8e4de
+bgLight         #edeae4
+paperGrid       #e5e2dd   Grid stroke (faint, paper-tone).
+
+heading         #1a1a1a   Light-mode text.
+body            #2d2d2d
+muted           #6b6b6b
+
+cardForest      #1e3a27   Dark-green card surface.
+cardForestLift  #2d4433
+cardForestDeep  #142318
+
+accent          #D4663A   Claude terracotta.
+accentDark      #1e3a27
+danger          #c0392b
+success         #1e7a45
+
+terminalGreen   #5be8a0   For embedded terminal/code blocks.
+terminalCaret   #9B6B4F
+```
+
+## Primitives (inline in template — extracted in v1.1)
+
+| Component | Purpose |
+|---|---|
+| `PaperGrid` | Cream-tone grid background with radial mask. |
+| `ScaleBlurText` | Hero text with power4Out scale + blur entrance. |
+| `GreenCard` | The family's depth move. Spring config damping 20 / stiffness 200. |
+| (in v1.1) `CardSpring`, `GreenAccentCard`, `PaperShadow` | Standalone primitives extracted from inline. |
+
+## Presets
+
+| Preset | Source | Frames | Use when |
+|---|---|---|---|
+| `justdrop` | JustDropReel | 1760 (58.5s) | Skill / SaaS launch. Card-stack heavy. |
+| `opus` | OpusReel | 3330 (111s) | Thesis-driven long-form. Embedded screenshot fades. |
+| `designreel` | DesignReel | 300 (10s) | Ultra-short teaser. Compressed beats. |
+| `devini3d` | Devini3DReel | 1170 (39s) | Showcase reel with hero clip + closing motion graphics. |
+
+## House rules (Paper-specific)
+
+1. **Light text on cream is `#1a1a1a` heading / `#2d2d2d` body / `#6b6b6b` muted.** Never `#000` — black is too harsh on the cream tone.
+2. **Card springs use `damping: 20, stiffness: 200`.** The family's signature motion. Don't override without a deliberate reason.
+3. **Cream paper bg is non-negotiable.** If you need a dark variant, switch families to Dark Cinematic.
+4. **PaperShadow stack is multi-layer.** `0 1px 2px rgba(26,26,26,0.04), 0 4px 12px rgba(26,26,26,0.06)` for soft. Never single-shadow flat overlays.
+5. **Dark green cards are the depth move.** Use them for embedded UI, terminal blocks, "before/after" comparisons. Card stacks of 2-3 read better than singletons.
+
+## Motion vocabulary
+
+- **Card entrance:** spring with `springConfig` (damping 20, stiffness 200). Translate from below + scale 0.96 → 1.0.
+- **Text reveal:** `ScaleBlurText` — power4Out over 30 frames, blur 10px → 0, scale 0.94 → 1.0.
+- **Page transitions:** Crossfade with 12-frame overlap. No hard cuts.
+
+## Variant overlay (v1.1+)
+
+Cream Paper inherits from **leonxlnx/taste-skill-minimalist** + **leonxlnx/taste-skill-soft** + **leonxlnx/taste-skill (master)**. The Minimalist + Soft overlay adds:
+
+- **`<EditorialSerifText />`** — hero text with serif fallback chain `Lyon Text → Newsreader → Playfair Display → Georgia → serif`. Subtle 24-frame `power3Out` entrance. Use for editorial-magazine headlines.
+- **`reduceMotion` prop** on `CardSpring`, `ScaleBlurText` motion components.
+- **`ALLOWED_ACCENTS`** export — lint flags any color outside the cream-paper palette (heading, body, muted, cardForest stack, terracotta accent, terminal-green, semantic success/danger).
+- **WCAG AA+ contrast** documented inline in `palette.ts` (heading: 15.6:1, body: 11.6:1, muted: 4.8:1).
+- **4-px grid constants** re-exported from the family entrypoint: `import { palette, GRID, GRID_2, GRID_4, … } from "@devinilabs/reelstack/families/paper"`.
+
+## Reference reels (v1.1.1+)
+
+3 reference reels ship for this family at `~/.reelstack/reference/paper/<preset>.tsx`:
+
+- **justdrop** — Skill-ecosystem reveal with the family's signature dark-green card stack.
+- **opus** — Thesis-driven 111s long-form. Embedded benchmark screenshots + agents.md cards.
+- **designreel** — 10s teaser. Compressed-beat structure for promo clips.
+
+These are the actual Devini Labs reels (asset-stripped). Read them when iterating on your scaffolded reel. Pattern adaptation is encouraged; verbatim re-publication is not.

package/docs/family-galleries/warm.md

@@ -0,0 +1,86 @@
+# Warm Signature — Family Reference
+
+> Confident product launch. Strict single-accent rule. Bento grids for feature matrices.
+
+The family's contract is its discipline: amber primary, emerald payoff, red wall. **No other accents.** The lint command flags any other color used in a Warm Signature reel.
+
+## Palette
+
+```
+bg              #09090b   Warm zinc base.
+bgLift          #111114
+surface         #15151c
+surfaceWarm     #1a1610   The family's signature warm surface.
+
+fg              #fafafa
+fgSoft          #d4d4d8
+fgMuted         #9f9fa9
+fgDim           #71717b
+
+amber           #f99c00   THE primary accent. Use everywhere brand expression matters.
+amberSoft       #fcbb00
+amberDeep       #9a5e00
+amberGlow       rgba(249, 156, 0, 0.20)
+
+emerald         #00d294   Payoff — used ONLY for "ship" / launch / success moments.
+emeraldSoft     #5ee9b5
+emeraldDeep     #00875a
+
+red             #ef4444   Wall — used ONLY for "limit" / "blocked" / "broken" moments.
+redSoft         #fca5a5
+redDeep         #7f1d1d
+
+claudeWarm      #d4663a   Allowed when product is Claude-adjacent.
+```
+
+## Primitives
+
+| Component | Purpose |
+|---|---|
+| `AccentGlow` | Amber radial glow that breathes (sine on opacity). Background. |
+| `FilmGrain` | SVG turbulence noise overlay at 6% opacity, multiply blend. |
+| `BentoCell` (template-inline) | Single grid cell with spring entrance + amber border. |
+| (in v1.1) `BentoGrid`, `WarmSurface`, `ScaleBlurCounter` | Standalone primitives extracted from inline. |
+
+## Presets
+
+| Preset | Source | Frames | Use when |
+|---|---|---|---|
+| `huashu` | HuashuReel | 2984 (99.4s) | Product launch. Reference build. |
+| `mempalace` | MemPalaceReel | 2520 (84s) | Memory / learning narrative. Parchment-gold variant. |
+
+## House rules (Warm-specific)
+
+1. **ONE primary accent only.** Amber. Period.
+2. **Emerald is the payoff.** Use it for "ship" / "launch" / "success" / final-frame moments only. Never for body text.
+3. **Red is the wall.** Use for "limit" / "blocked" / "before" moments only. Never decorative.
+4. **No blues. No purples. No pinks.** Lint flags them. If your story needs another hue, you're in the wrong family — use Dark Cinematic.
+5. **Bento grids for feature matrices.** When showing 4+ capabilities, use a 2-column bento. Cells stagger-reveal at 6-frame offsets.
+6. **Surface warm vs. surface cold.** `surfaceWarm` (#1a1610) for amber-adjacent content; `surface` (#15151c) for neutral cards.
+
+## Motion vocabulary
+
+- **AccentGlow breath:** sine wave on opacity, period ~5s. Provides ambient life without distracting.
+- **Bento staggers:** 6 frames between cells. Spring snappy.
+- **FilmGrain stays on.** Don't toggle per scene.
+- **Counter for stats:** scale-blur entrance, power4Out, 36 frames.
+- **Audio lock:** BEAT constants from `/reelstack-beats` — anchor to rhythm phrases, not numeric beats.
+
+## Variant overlay (v1.1+)
+
+Warm Signature inherits from **leonxlnx/taste-skill-minimalist** + **leonxlnx/taste-skill-soft** + **leonxlnx/taste-skill (master)**. The Minimalist + Soft overlay adds:
+
+- **Editorial-serif Warm hero option** — import `<EditorialSerifText />` from `@devinilabs/reelstack/families/paper/components` for an editorial-magazine variant of the amber name reveal. Cross-family import is intentional; the component honors the Warm palette via the `color` prop.
+- **`reduceMotion` prop** on `AccentGlow`, `BentoCell`, `ScaleBlurCounter`, `FilmGrain` (dampens grain opacity).
+- **`ALLOWED_ACCENTS`** already enforced (single-accent rule is the family's foundational contract — amber primary, emerald payoff, red wall, claudeWarm). Lint flags any other hue.
+- **WCAG AA+ contrast** documented inline in `palette.ts` (fg: 19.6:1, fgSoft: 13.9:1, fgMuted: 7.7:1).
+- **Diffused warm shadow stack** — Soft variant's multi-layer `paperShadow`-style stacks adapted to warm-zinc backgrounds for premium card depth.
+
+## Reference reels (v1.1.1+)
+
+2 reference reels ship for this family at `~/.reelstack/reference/warm/<preset>.tsx`:
+
+- **huashu** — Confident product launch with strict single-accent rule. Bento grid feature matrix.
+- **mempalace** — Memory palace narrative. Parchment-gold variant on dark zinc.
+
+These are the actual Devini Labs reels (asset-stripped). Read them when iterating on your scaffolded reel. Pattern adaptation is encouraged; verbatim re-publication is not.