@steamfield/decks 0.0.0-stage → 1.0.0-rc.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +201 -0
- package/README.md +28 -2
- package/dist/cli.d.ts +1 -0
- package/dist/cli.js +5 -0
- package/dist/index-B2n69xrC.d.ts +75 -0
- package/dist/index-BURtH7IB.d.ts +182 -0
- package/dist/index-BV_-6L5L.d.ts +136 -0
- package/dist/index.d.ts +3 -0
- package/dist/index.js +6 -0
- package/dist/kit/chrome/od-byline.css +7 -0
- package/dist/kit/chrome/od-cover-head.css +10 -0
- package/dist/kit/chrome/od-eyebrow.css +13 -0
- package/dist/kit/chrome/od-logo.css +167 -0
- package/dist/kit/chrome/od-qr-card.css +30 -0
- package/dist/kit/ink/code-ink.css +83 -0
- package/dist/kit/ink/graph-3d.css +29 -0
- package/dist/kit/ink/ink-bars.css +7 -0
- package/dist/kit/ink/ink-card-rect.css +6 -0
- package/dist/kit/ink/ink-chip.css +62 -0
- package/dist/kit/ink/ink-line.css +7 -0
- package/dist/kit/ink/ink-number.css +22 -0
- package/dist/kit/ink/ink-ping.css +4 -0
- package/dist/kit/ink/ink-rule.css +4 -0
- package/dist/kit/ink/ink-timeline-cursor.css +3 -0
- package/dist/kit/ink/ink-timeline.css +9 -0
- package/dist/kit/ink/underline.css +12 -0
- package/dist/kit/ink/unit-grid.css +3 -0
- package/dist/kit/story/story-card.css +19 -0
- package/dist/kit/story/story-link.css +13 -0
- package/dist/kit/story/story-stage.css +59 -0
- package/dist/kit/styles/base.css +82 -0
- package/dist/kit/styles/compat.css +78 -0
- package/dist/kit/styles/components.css +224 -0
- package/dist/kit/styles/fonts/inter-cyrillic-ext-wght-normal.woff2 +0 -0
- package/dist/kit/styles/fonts/inter-cyrillic-wght-normal.woff2 +0 -0
- package/dist/kit/styles/fonts/inter-greek-ext-wght-normal.woff2 +0 -0
- package/dist/kit/styles/fonts/inter-greek-wght-normal.woff2 +0 -0
- package/dist/kit/styles/fonts/inter-latin-ext-wght-normal.woff2 +0 -0
- package/dist/kit/styles/fonts/inter-latin-wght-normal.woff2 +0 -0
- package/dist/kit/styles/fonts/inter-vietnamese-wght-normal.woff2 +0 -0
- package/dist/kit/styles/fonts.css +73 -0
- package/dist/kit/styles/index.css +36 -0
- package/dist/kit/styles/layout.css +181 -0
- package/dist/kit/styles/stats.css +92 -0
- package/dist/kit/styles/story-frame.css +179 -0
- package/dist/kit/styles/story-marks.css +115 -0
- package/dist/kit/styles/story-transition.css +182 -0
- package/dist/kit/styles.css +1 -0
- package/dist/kit.d.ts +880 -0
- package/dist/kit.js +3475 -0
- package/dist/layers.css +60 -0
- package/dist/layouts.css +58 -0
- package/dist/lint/ai-rhetoric-patterns.tsv +110 -0
- package/dist/lint/deck-writing-reminder.md +9 -0
- package/dist/motion.css +215 -0
- package/dist/motion.d.ts +2 -0
- package/dist/motion.js +1 -0
- package/dist/node.d.ts +63 -0
- package/dist/node.js +1 -0
- package/dist/overview-view.css +58 -0
- package/dist/play-view.css +29 -0
- package/dist/plugin/skills/building-a-deck/SKILL.md +22 -0
- package/dist/plugin/skills/building-a-deck/references/workflow.md +86 -0
- package/dist/plugin/skills/deck-data/SKILL.md +27 -0
- package/dist/plugin/skills/deck-data/references/fact-check.md +59 -0
- package/dist/plugin/skills/deck-data/references/provenance.md +61 -0
- package/dist/plugin/skills/deck-design/SKILL.md +31 -0
- package/dist/plugin/skills/deck-design/references/layout.md +55 -0
- package/dist/plugin/skills/deck-motion/SKILL.md +34 -0
- package/dist/plugin/skills/deck-motion/references/motion.md +66 -0
- package/dist/plugin/skills/visualization/SKILL.md +34 -0
- package/dist/plugin/skills/visualization/references/VENDORED.md +25 -0
- package/dist/plugin/skills/visualization/references/annotations.md +27 -0
- package/dist/plugin/skills/visualization/references/chart-selection.md +29 -0
- package/dist/plugin/skills/visualization/references/color-strategy.md +22 -0
- package/dist/plugin/skills/visualization/references/encoding-channels.md +44 -0
- package/dist/plugin/skills/visualization/references/ink.md +38 -0
- package/dist/plugin/skills/visualization/references/marks.md +33 -0
- package/dist/plugin/skills/visualization/references/presentation.md +43 -0
- package/dist/plugin/skills/working-with-decks/SKILL.md +34 -0
- package/dist/plugin/skills/working-with-decks/references/project.md +59 -0
- package/dist/plugin/skills/writing-slides/SKILL.md +45 -0
- package/dist/plugin/skills/writing-slides/references/lint.md +11 -0
- package/dist/plugin/skills/writing-slides/references/prose-patterns.md +48 -0
- package/dist/presenter-view.css +113 -0
- package/dist/print-view.module.css +32 -0
- package/dist/prose-patterns-DPqjGBFu.js +76 -0
- package/dist/prose-scan-BrWZ7gxZ.js +233 -0
- package/dist/src-C-OfT72W.js +396 -0
- package/dist/src-CmQgaG1b.js +2469 -0
- package/dist/src-DizFoqYt.js +1508 -0
- package/dist/templates/conventional/deck.config.ts +7 -0
- package/dist/templates/conventional/setup.ts +3 -0
- package/dist/templates/conventional/slides/01-cover.mdx +9 -0
- package/dist/templates/conventional/slides/02-first-point.mdx +12 -0
- package/dist/templates/conventional/styles/index.css +1 -0
- package/dist/templates/story/components/FirstStage.tsx +34 -0
- package/dist/templates/story/data/01-first.ts +8 -0
- package/dist/templates/story/data-sources.md +7 -0
- package/dist/templates/story/deck.config.ts +8 -0
- package/dist/templates/story/setup.ts +3 -0
- package/dist/templates/story/slides/01-cover.mdx +9 -0
- package/dist/templates/story/slides/02-first-point.mdx +6 -0
- package/dist/templates/story/styles/index.css +1 -0
- package/dist/transition.css +87 -0
- package/docs/README.md +28 -0
- package/docs/canvas.md +134 -0
- package/docs/cli.md +49 -0
- package/docs/code-blocks.md +132 -0
- package/docs/config.md +183 -0
- package/docs/getting-started.md +204 -0
- package/docs/kit.md +371 -0
- package/docs/migrating-from-slidev.md +45 -0
- package/docs/motion.md +396 -0
- package/docs/presenting.md +99 -0
- package/docs/slides.md +246 -0
- package/package.json +108 -4
package/dist/layers.css
ADDED
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
@layer react-decks {
|
|
2
|
+
[data-deck-slide] {
|
|
3
|
+
position: relative;
|
|
4
|
+
isolation: isolate;
|
|
5
|
+
}
|
|
6
|
+
[data-deck-layer] {
|
|
7
|
+
position: absolute;
|
|
8
|
+
inset: 0;
|
|
9
|
+
pointer-events: none;
|
|
10
|
+
}
|
|
11
|
+
[data-deck-layer="below"] {
|
|
12
|
+
z-index: -1;
|
|
13
|
+
}
|
|
14
|
+
/* In DOM order the credit comes before the above layer, so the above layer covers it. */
|
|
15
|
+
[data-deck-layer="above"],
|
|
16
|
+
[data-deck-layer="credit"] {
|
|
17
|
+
z-index: 1;
|
|
18
|
+
}
|
|
19
|
+
|
|
20
|
+
/* A slide with a credit keeps a band along its bottom edge free for it. The credit is centred
|
|
21
|
+
in the band; layouts and the kit's slides keep their content above it by reading
|
|
22
|
+
--deck-credit-space, which is 0px on a deck that turned the credit off. */
|
|
23
|
+
[data-deck-slide] {
|
|
24
|
+
--deck-credit-space: 0px;
|
|
25
|
+
}
|
|
26
|
+
|
|
27
|
+
[data-deck-slide][data-deck-credit] {
|
|
28
|
+
--deck-credit-space: 64px;
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
.rd-credit {
|
|
32
|
+
position: absolute;
|
|
33
|
+
right: 110px;
|
|
34
|
+
bottom: 0;
|
|
35
|
+
height: var(--deck-credit-space);
|
|
36
|
+
display: inline-flex;
|
|
37
|
+
align-items: center;
|
|
38
|
+
gap: 10px;
|
|
39
|
+
font-size: calc(22px * var(--deck-text-scale, 1));
|
|
40
|
+
line-height: 1;
|
|
41
|
+
color: inherit;
|
|
42
|
+
opacity: 0.6;
|
|
43
|
+
text-decoration: none;
|
|
44
|
+
pointer-events: auto;
|
|
45
|
+
}
|
|
46
|
+
|
|
47
|
+
.rd-credit:hover {
|
|
48
|
+
opacity: 1;
|
|
49
|
+
}
|
|
50
|
+
|
|
51
|
+
.rd-credit svg {
|
|
52
|
+
width: 30px;
|
|
53
|
+
height: 30px;
|
|
54
|
+
fill: currentColor;
|
|
55
|
+
}
|
|
56
|
+
|
|
57
|
+
.rd-credit strong {
|
|
58
|
+
font-weight: 600;
|
|
59
|
+
}
|
|
60
|
+
}
|
package/dist/layouts.css
ADDED
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
@layer react-decks {
|
|
2
|
+
.rd-frame {
|
|
3
|
+
--deck-pad-x: 120px;
|
|
4
|
+
--deck-pad-y: 96px;
|
|
5
|
+
--deck-gap: 80px;
|
|
6
|
+
}
|
|
7
|
+
.rd-layout {
|
|
8
|
+
position: absolute;
|
|
9
|
+
inset: 0;
|
|
10
|
+
box-sizing: border-box;
|
|
11
|
+
padding: var(--deck-pad-y) var(--deck-pad-x);
|
|
12
|
+
/* Never less than the credit's band. */
|
|
13
|
+
padding-bottom: max(var(--deck-pad-y), var(--deck-credit-space, 0px));
|
|
14
|
+
display: flex;
|
|
15
|
+
flex-direction: column;
|
|
16
|
+
gap: var(--deck-gap);
|
|
17
|
+
}
|
|
18
|
+
[data-deck-layout="center"] {
|
|
19
|
+
align-items: center;
|
|
20
|
+
justify-content: center;
|
|
21
|
+
}
|
|
22
|
+
[data-deck-layout="cover"] {
|
|
23
|
+
align-items: flex-start;
|
|
24
|
+
justify-content: center;
|
|
25
|
+
}
|
|
26
|
+
[data-deck-layout="section"] {
|
|
27
|
+
align-items: flex-start;
|
|
28
|
+
justify-content: flex-end;
|
|
29
|
+
}
|
|
30
|
+
[data-deck-layout="two-col"],
|
|
31
|
+
[data-deck-layout="image-side"] {
|
|
32
|
+
display: grid;
|
|
33
|
+
}
|
|
34
|
+
[data-deck-layout="two-col"] > * {
|
|
35
|
+
min-width: 0;
|
|
36
|
+
}
|
|
37
|
+
[data-deck-layout="image-side"] {
|
|
38
|
+
padding: 0;
|
|
39
|
+
grid-template-rows: minmax(0, 1fr);
|
|
40
|
+
}
|
|
41
|
+
[data-deck-layout="image-side"] > img {
|
|
42
|
+
grid-row: 1;
|
|
43
|
+
width: 100%;
|
|
44
|
+
height: 100%;
|
|
45
|
+
min-width: 0;
|
|
46
|
+
object-fit: cover;
|
|
47
|
+
}
|
|
48
|
+
.rd-image-content {
|
|
49
|
+
grid-row: 1;
|
|
50
|
+
min-width: 0;
|
|
51
|
+
padding: var(--deck-pad-y) var(--deck-pad-x);
|
|
52
|
+
padding-bottom: max(var(--deck-pad-y), var(--deck-credit-space, 0px));
|
|
53
|
+
display: flex;
|
|
54
|
+
flex-direction: column;
|
|
55
|
+
justify-content: center;
|
|
56
|
+
gap: var(--deck-gap);
|
|
57
|
+
}
|
|
58
|
+
}
|
|
@@ -0,0 +1,110 @@
|
|
|
1
|
+
# AI-rhetoric lint patterns for deck prose.
|
|
2
|
+
# Format: id<TAB>severity<TAB>ERE pattern<TAB>message
|
|
3
|
+
# Severities: error (the `decks hook lint` write hook denies, `decks lint` and
|
|
4
|
+
# `decks check` exit 1, beats.test.ts fails a story card), warn (report only).
|
|
5
|
+
# Project terminology rows (id prefix terminology-) go at the bottom; see
|
|
6
|
+
# .claude/rules/project-glossary.md.
|
|
7
|
+
# Apostrophes/quotes: match straight AND curly via ('|’) style groups, never
|
|
8
|
+
# bracket expressions — brackets split multibyte chars if the locale falls
|
|
9
|
+
# back to C.
|
|
10
|
+
# Sentence-start anchoring: prose lines reach grep as "NR<TAB>ALLOW<TAB>TEXT",
|
|
11
|
+
# so ^ anchors the line prefix, not the prose. Use (^|[[:space:]]|"|“) plus a
|
|
12
|
+
# required capital letter to approximate sentence start.
|
|
13
|
+
# Errors should be near-zero-false-positive (the hook denies writes on them).
|
|
14
|
+
# Structural/cadence patterns stay warn: they are sometimes legitimate craft,
|
|
15
|
+
# and the goal is guiding judgment, not banning devices humans also use.
|
|
16
|
+
#
|
|
17
|
+
# WHAT THIS FILE CANNOT DO (do not re-litigate; re-measure instead):
|
|
18
|
+
# These patterns were fitted to a corpus of published data-journalism articles.
|
|
19
|
+
# Measured 2026-07-24 on that corpus: 1 hit across 44 shipped articles. The counts drift
|
|
20
|
+
# as articles ship — re-run the command rather than trusting this number; the
|
|
21
|
+
# finding that survives is the ORDER OF MAGNITUDE, not the digits.
|
|
22
|
+
# On the education-data-for-state-agencies article the set produced ZERO hits,
|
|
23
|
+
# and that article then needed nine separate user corrections for AI slop.
|
|
24
|
+
# Examples that pass clean here: "That finding held at every level below it." /
|
|
25
|
+
# "Cleaned once, the same data comes back readable." / "So go find your own
|
|
26
|
+
# state's line."
|
|
27
|
+
#
|
|
28
|
+
# That is not a coverage bug to patch by adding patterns. Those defects are
|
|
29
|
+
# REFERENTIAL and SEMANTIC (a callback with no antecedent, a sentence carrying
|
|
30
|
+
# no new fact, a metaphor where a noun belongs). Detecting them requires
|
|
31
|
+
# resolving meaning across sentences, which regex cannot do. Every attempt to
|
|
32
|
+
# express one as a pattern lands on either "too broad, blocks correct writing"
|
|
33
|
+
# or "too narrow, evaded by the next paraphrase" — e.g. a chart-restatement
|
|
34
|
+
# rule cannot distinguish slop from the REQUIRED practice of stating a finding
|
|
35
|
+
# in prose next to its chart.
|
|
36
|
+
#
|
|
37
|
+
# So: this file is a lexical guard (banned words, em-dashes, terminology). It
|
|
38
|
+
# is NOT prose review. Empty sentences, chart restatement, and audience
|
|
39
|
+
# mismatch are caught by a reviewer's judgment, not here. Never
|
|
40
|
+
# report "lint clean" as evidence the prose is good; it measures a domain that
|
|
41
|
+
# barely overlaps with prose quality.
|
|
42
|
+
#
|
|
43
|
+
# Before adding a pattern, check it fires on the shipped corpus:
|
|
44
|
+
# decks lint (every registered deck; `bun run lint` in the Decks repo)
|
|
45
|
+
# A pattern that never fires is dead weight that manufactures false confidence.
|
|
46
|
+
#
|
|
47
|
+
# THE "SAY IT PLAINLY" SET (added 2026-08-31, the ten warns at the bottom).
|
|
48
|
+
# The user's single most-repeated correction is a claim arranged across two
|
|
49
|
+
# sentences instead of stated in one. Derived by mining 154 session transcripts
|
|
50
|
+
# for prose-style complaints that QUOTED the offending sentence, which yielded
|
|
51
|
+
# ~46 flagged sentences; patterns were fitted to those, then counted against the
|
|
52
|
+
# 49-article shipped corpus. Recall is flagged sentences matched, corpus is raw
|
|
53
|
+
# hits across all 49 articles:
|
|
54
|
+
# is-real recall 2 corpus 36
|
|
55
|
+
# matters-signal recall 3 corpus 19
|
|
56
|
+
# whole-answer recall 1 corpus 9
|
|
57
|
+
# cleft-reveal recall 1 corpus 9
|
|
58
|
+
# negation-assertion recall 3 corpus 8
|
|
59
|
+
# worth-signal recall 3 corpus 8
|
|
60
|
+
# hard-to-ignore recall 1 corpus 7
|
|
61
|
+
# real-question recall 0 corpus 4
|
|
62
|
+
# metaphor-line recall 1 corpus 0
|
|
63
|
+
# telling recall 1 corpus 0
|
|
64
|
+
#
|
|
65
|
+
# ALL WARN, DELIBERATELY. They fire on published prose at roughly 2 hits per
|
|
66
|
+
# article, because the good and bad uses share the surface form and differ only
|
|
67
|
+
# in whether the sentence states a fact or merely characterizes one. Regex cannot
|
|
68
|
+
# see that difference. These guide a reviewer; a hit is not itself a defect.
|
|
69
|
+
#
|
|
70
|
+
# Rejected as too noisy to be useful, do not re-add without new evidence:
|
|
71
|
+
# ", not (a|an|the|just|merely|simply) " 128 corpus hits
|
|
72
|
+
# "which is (why|the|what|where|how)" 32 corpus hits
|
|
73
|
+
# "genuinely" 26 corpus hits
|
|
74
|
+
#
|
|
75
|
+
# One promotion is on deck: `is-real`. The user calls "X is real" a confirmed
|
|
76
|
+
# tell, and all 36 corpus hits inspected were genuine ("The data is real", "The
|
|
77
|
+
# cost is real", "The by-major table is real. The sector split is real."). It
|
|
78
|
+
# stayed warn only because promoting it would have failed lint on 36 shipped
|
|
79
|
+
# articles in that corpus. Scrub your own decks first, then make it an error.
|
|
80
|
+
#
|
|
81
|
+
# The judgment-level guidance lives in .claude/rules/deck-writing.md and
|
|
82
|
+
# .claude/rules/prose-patterns.md. This file stays a lexical guard, not prose
|
|
83
|
+
# review.
|
|
84
|
+
em-dash error [a-zA-Z] —|— [a-zA-Z]|[a-zA-Z]—[a-zA-Z] Em-dash in prose. Use period, comma, colon, or parens.
|
|
85
|
+
banned-phrase error [Hh]ere('|’)?s the (thing|kicker)|[Ll]et that sink in|[Rr]ead that again|[Ww]here it gets (interesting|wild|weird)|[Aa]t its core|[Ii]t(('|’)| i)s worth noting|[Mm]ake no mistake|[Tt]he bottom line|[Ff]ull stop Banned AI-tell phrase. State the fact directly.
|
|
86
|
+
not-just-reveal error ([Ii]t|[Tt]hat|[Tt]his)(('|’)s| is) not (just|only|merely|simply|about)\b|isn('|’)?t (just|only|merely|simply) "Not just X, Y" escalation. Say what it IS, once.
|
|
87
|
+
ai-vocab error \b[Ss]eamless\b|\b[Cc]utting.edge\b|\bbest.in.class\b|\bgame.chang(er|ers|ing)\b|\brevolution(ary|ize)|\b[Dd]elv(e|es|ed|ing)\b|\bparadigm\b AI-marketing vocabulary. Plain words.
|
|
88
|
+
inflated-significance error mark(s|ed|ing) a (pivotal|significant|critical|watershed) (moment|shift|turning point) Inflated significance. Say the concrete change, or cut it.
|
|
89
|
+
significance-claim warn represent(s|ed|ing) a (significant|fundamental|major) shift|part of a broader (movement|shift) Significance claim. Fine if the article shows it; otherwise say the concrete change.
|
|
90
|
+
parallel-reveal warn [.!?]("|'|”|’|\))* +(That('|’)s|That is|It('|’)s|It is|This is) (not |exactly |precisely |why |how |where |when |what ) Setup-then-reveal cadence ("X happened. That's why/how/what...").
|
|
91
|
+
colon-reveal warn : (that('|’)?s|in other words|put simply|translation)|[Ii]n other words,|[Pp]ut (simply|another way)|[Ss]imply put|[Tt]o put (that|it) in(to)? perspective|Translation: Restatement filler.
|
|
92
|
+
folksy-restate warn [Tt]hat(('|’)s| is) (nearly |almost |about |roughly |more than |over )?(one|two|three|\$?[0-9])[^.]{0,40}\b(in|out of|of every|times)\b Number restated as a reveal. State the ratio directly instead of stacking it after the raw figure.
|
|
93
|
+
powerful warn \b[Pp]owerful\b Usually a tell; say what it does.
|
|
94
|
+
rhetorical-answer warn (^|[[:space:]]|"|“)The (result|answer|upshot|catch|takeaway|lesson|verdict|kicker|difference)\?|\? Because\b Rhetorical question answered immediately. State the point as a sentence.
|
|
95
|
+
transition-opener warn (^|[[:space:]]|"|“)(Importantly|Notably|Interestingly|Crucially), AI transition opener. Cut it; if the point matters, show why.
|
|
96
|
+
false-range warn [Ee]verything from [^.]{1,60} to False range ("everything from X to Y"). Name the actual examples.
|
|
97
|
+
unearned-profundity warn (^|[[:space:]]|"|“)(Something (shifted|changed)|Everything changed)[.,] Unearned profundity. State what actually happened.
|
|
98
|
+
copula-inflation warn \bserve(s|d)? as\b|\bstands? as\b Inflated copula. "Is" usually works.
|
|
99
|
+
participial-tic warn , (further )?(cementing|underscoring|highlighting|solidifying|signaling) (its|their|the|a) Trailing participial importance claim. End the sentence, or replace it with a fact.
|
|
100
|
+
literary-ai warn \btestament to\b|\btapestry\b|\ba landscape of\b|\bintricate\b|\binterplay\b Literary-AI decoration. Inform, don't decorate.
|
|
101
|
+
negation-assertion warn (is|are|was|were|do|does|did|will) not [^.]{1,45}\. (It|They|That|This|The) (is|are|was|were|changed|went) Negation then assertion ("X is not A. It is B."). Say what it IS, once.
|
|
102
|
+
matters-signal warn \b(that|this|it|which) matters\b|\bmatters (less|more) than\b|\bpart that matters\b Importance claim instead of a fact. Say what changes, not that it matters.
|
|
103
|
+
is-real warn \b(is|are|was|were) (a )?real\b "X is real" asserts significance without adding a fact. State the fact.
|
|
104
|
+
worth-signal warn \bworth (telling|naming|noting|stating|mentioning|flagging|calling out|paying attention) Announcing that something deserves attention. Name it and let the reader see why.
|
|
105
|
+
whole-answer warn [Tt]hat((’|')s| is) the (whole |real |actual )?(answer|point|finding|mechanism|story|reason|thing)\b Characterizing the finding instead of stating it. State the finding.
|
|
106
|
+
real-question warn [Tt]he (real|actual|interesting|important) (question|part|finding|point|story) (here )?(is|was) Ranking a fact above others instead of stating it.
|
|
107
|
+
hard-to-ignore warn \bhard to (ignore|miss|overstate|argue with)\b Importance signal. Give the number that makes it hard to ignore.
|
|
108
|
+
metaphor-line warn \bthe (dividing line|through.?line|common thread)\b|\bthe same one running\b Metaphor standing where a plain noun belongs.
|
|
109
|
+
cleft-reveal warn (^|[[:space:]]|"|“)What [a-z]+ (was|is|matters) Cleft sentence ("What worked was X"). Write "X worked".
|
|
110
|
+
telling warn \b(even more|more|especially|equally) telling\b|\bis telling\b "Telling" claims significance. Say what it tells you.
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
Deck writing reminder (see .claude/rules/deck-writing.md):
|
|
2
|
+
- Slides are NOT short articles. The audience gets one pass at reading speed while someone talks over it. The slide carries only what must be read; the speaker carries the rest.
|
|
3
|
+
- Word budget: ~70 visible words on a normal slide. A story card is eight words of lead, twenty of body. 150 means split the slide. Four figures means it is a bug.
|
|
4
|
+
- Headlines are CLAIMS, full sentences ending in a period ("Interview the agent like you'd interview a user."), not topic labels. This deliberately INVERTS the usual article section-title rule; do not carry article habits in. Same for chart titles: findings, not labels.
|
|
5
|
+
- Bullets: three per slide, one sentence each, parallel grammatical shape. A bullet that only makes sense next to its neighbor is one bullet.
|
|
6
|
+
- NO paragraphs. `od-lede` is for a single sentence. Three connected sentences go in speaker notes or across two slides.
|
|
7
|
+
- Anti-slop shapes carry over unchanged (`decks lint` covers each deck's `slides/*.mdx`, `components/*.tsx`, `layers/*.tsx` and story-card COPY in `.ts/.tsx`): never "X is real", never characterize a finding instead of stating it, never negation-then-assertion, never an em dash. Catalog: .claude/rules/prose-patterns.md.
|
|
8
|
+
- Article rules that do NOT apply here: paragraph construction, leading each paragraph with its point, prose density, and paragraph-level structural review.
|
|
9
|
+
- Every figure traces to a query in `<deck>/data-sources.md` and a `<deck>/data/*.ts` constant (.claude/rules/deck-data.md). Deck fact-check runs the `fact-checking-a-deck` skill.
|
package/dist/motion.css
ADDED
|
@@ -0,0 +1,215 @@
|
|
|
1
|
+
@layer react-decks {
|
|
2
|
+
.rd-visually-hidden {
|
|
3
|
+
position: absolute;
|
|
4
|
+
width: 1px;
|
|
5
|
+
height: 1px;
|
|
6
|
+
padding: 0;
|
|
7
|
+
margin: -1px;
|
|
8
|
+
overflow: hidden;
|
|
9
|
+
clip-path: inset(50%);
|
|
10
|
+
white-space: nowrap;
|
|
11
|
+
border: 0;
|
|
12
|
+
}
|
|
13
|
+
:root {
|
|
14
|
+
--deck-code-background: oklch(0.135 0.018 255);
|
|
15
|
+
--deck-code-foreground: oklch(0.9 0.018 255);
|
|
16
|
+
--deck-code-keyword: oklch(0.78 0.1 290);
|
|
17
|
+
--deck-code-string: oklch(0.83 0.1 165);
|
|
18
|
+
--deck-code-comment: oklch(0.6 0.025 255);
|
|
19
|
+
--deck-code-constant: oklch(0.85 0.1 75);
|
|
20
|
+
--deck-code-function: oklch(0.8 0.08 230);
|
|
21
|
+
--deck-code-punctuation: oklch(0.72 0.025 255);
|
|
22
|
+
--deck-code-caption: oklch(0.68 0.025 255);
|
|
23
|
+
--deck-code-dim: 0.35;
|
|
24
|
+
--deck-dur-quick: 140ms;
|
|
25
|
+
--deck-dur-base: 300ms;
|
|
26
|
+
--deck-dur-slow: 600ms;
|
|
27
|
+
--deck-stagger: 60ms;
|
|
28
|
+
--deck-ease-enter: cubic-bezier(0.16, 1, 0.3, 1);
|
|
29
|
+
--deck-ease-exit: cubic-bezier(0.7, 0, 0.84, 0);
|
|
30
|
+
--deck-ease-settle: cubic-bezier(0.32, 0.72, 0, 1);
|
|
31
|
+
--deck-ease-draw: cubic-bezier(0.65, 0, 0.35, 1);
|
|
32
|
+
}
|
|
33
|
+
|
|
34
|
+
html[data-deck-motion="instant"] {
|
|
35
|
+
--deck-dur-quick: 0ms;
|
|
36
|
+
--deck-dur-base: 0ms;
|
|
37
|
+
--deck-dur-slow: 0ms;
|
|
38
|
+
--deck-stagger: 0ms;
|
|
39
|
+
}
|
|
40
|
+
|
|
41
|
+
.rd-code {
|
|
42
|
+
--shiki-background: var(--deck-code-background);
|
|
43
|
+
--shiki-foreground: var(--deck-code-foreground);
|
|
44
|
+
--shiki-token-keyword: var(--deck-code-keyword);
|
|
45
|
+
--shiki-token-string: var(--deck-code-string);
|
|
46
|
+
--shiki-token-string-expression: var(--deck-code-string);
|
|
47
|
+
--shiki-token-comment: var(--deck-code-comment);
|
|
48
|
+
--shiki-token-constant: var(--deck-code-constant);
|
|
49
|
+
--shiki-token-function: var(--deck-code-function);
|
|
50
|
+
--shiki-token-parameter: var(--deck-code-foreground);
|
|
51
|
+
--shiki-token-punctuation: var(--deck-code-punctuation);
|
|
52
|
+
--shiki-token-link: var(--deck-code-string);
|
|
53
|
+
margin: 16px 0;
|
|
54
|
+
min-height: 0;
|
|
55
|
+
border-radius: 20px;
|
|
56
|
+
background: var(--deck-code-background);
|
|
57
|
+
overflow: hidden;
|
|
58
|
+
}
|
|
59
|
+
.rd-code figcaption {
|
|
60
|
+
padding: 20px 32px 0;
|
|
61
|
+
font:
|
|
62
|
+
calc(24px * var(--deck-text-scale, 1)) / 1.4 ui-monospace,
|
|
63
|
+
monospace;
|
|
64
|
+
color: var(--deck-code-caption);
|
|
65
|
+
}
|
|
66
|
+
.rd-code pre {
|
|
67
|
+
max-height: var(--deck-code-max-height);
|
|
68
|
+
box-sizing: border-box;
|
|
69
|
+
margin: 0;
|
|
70
|
+
padding: 28px 0;
|
|
71
|
+
overflow: auto;
|
|
72
|
+
overscroll-behavior: contain;
|
|
73
|
+
position: relative;
|
|
74
|
+
}
|
|
75
|
+
.rd-code pre code {
|
|
76
|
+
display: block;
|
|
77
|
+
width: max-content;
|
|
78
|
+
min-width: 100%;
|
|
79
|
+
color: var(--deck-code-foreground);
|
|
80
|
+
font:
|
|
81
|
+
calc(32px * var(--deck-text-scale, 1)) / 1.6 ui-monospace,
|
|
82
|
+
"SFMono-Regular",
|
|
83
|
+
Consolas,
|
|
84
|
+
monospace;
|
|
85
|
+
tab-size: 2;
|
|
86
|
+
}
|
|
87
|
+
.rd-code [data-line] {
|
|
88
|
+
display: inline-block;
|
|
89
|
+
box-sizing: border-box;
|
|
90
|
+
min-width: 100%;
|
|
91
|
+
padding: 0 32px;
|
|
92
|
+
opacity: 1;
|
|
93
|
+
transition: opacity var(--deck-dur-base) var(--deck-ease-settle);
|
|
94
|
+
}
|
|
95
|
+
.rd-code [data-line-state="dim"] {
|
|
96
|
+
opacity: var(--deck-code-dim);
|
|
97
|
+
}
|
|
98
|
+
.rd-code [data-line-number]::before {
|
|
99
|
+
content: attr(data-line-number);
|
|
100
|
+
display: inline-block;
|
|
101
|
+
width: 3ch;
|
|
102
|
+
margin-right: 2ch;
|
|
103
|
+
text-align: right;
|
|
104
|
+
color: var(--deck-code-caption);
|
|
105
|
+
user-select: none;
|
|
106
|
+
}
|
|
107
|
+
[data-deck-context="print"] .rd-code,
|
|
108
|
+
html[data-deck-view="print"] .rd-code,
|
|
109
|
+
[data-deck-context="print"] .rd-code pre,
|
|
110
|
+
html[data-deck-view="print"] .rd-code pre {
|
|
111
|
+
--deck-code-max-height: none;
|
|
112
|
+
overflow: visible;
|
|
113
|
+
}
|
|
114
|
+
[data-deck-context]:not([data-deck-context="slide"]) .rd-code [data-line] {
|
|
115
|
+
transition-duration: 0ms;
|
|
116
|
+
}
|
|
117
|
+
|
|
118
|
+
[data-step-state] {
|
|
119
|
+
opacity: 1;
|
|
120
|
+
transform: none;
|
|
121
|
+
filter: none;
|
|
122
|
+
clip-path: none;
|
|
123
|
+
visibility: visible;
|
|
124
|
+
transition-property: opacity, transform, filter, clip-path, visibility;
|
|
125
|
+
transition-duration: var(--deck-dur-base);
|
|
126
|
+
transition-timing-function: var(--deck-ease-enter);
|
|
127
|
+
transition-delay: calc(var(--step-index, 0) * var(--deck-stagger));
|
|
128
|
+
}
|
|
129
|
+
|
|
130
|
+
[data-step-state="before"],
|
|
131
|
+
[data-step-state="gone"] {
|
|
132
|
+
visibility: hidden;
|
|
133
|
+
transition-timing-function: var(--deck-ease-exit);
|
|
134
|
+
transition-delay: 0ms, 0ms, 0ms, 0ms, var(--deck-dur-base);
|
|
135
|
+
}
|
|
136
|
+
|
|
137
|
+
[data-step-enter="wipe"],
|
|
138
|
+
[data-step-exit="wipe"] {
|
|
139
|
+
clip-path: inset(0 0 0 0);
|
|
140
|
+
}
|
|
141
|
+
|
|
142
|
+
[data-step-state="before"][data-step-enter="fade"],
|
|
143
|
+
[data-step-state="gone"][data-step-exit="fade"] {
|
|
144
|
+
opacity: 0;
|
|
145
|
+
}
|
|
146
|
+
[data-step-state="before"][data-step-enter="rise"],
|
|
147
|
+
[data-step-state="gone"][data-step-exit="rise"] {
|
|
148
|
+
opacity: 0;
|
|
149
|
+
transform: translateY(24px);
|
|
150
|
+
}
|
|
151
|
+
[data-step-state="before"][data-step-enter="drop"],
|
|
152
|
+
[data-step-state="gone"][data-step-exit="drop"] {
|
|
153
|
+
opacity: 0;
|
|
154
|
+
transform: translateY(-24px);
|
|
155
|
+
}
|
|
156
|
+
[data-step-state="before"][data-step-enter="scale"],
|
|
157
|
+
[data-step-state="gone"][data-step-exit="scale"] {
|
|
158
|
+
opacity: 0;
|
|
159
|
+
transform: scale(0.92);
|
|
160
|
+
}
|
|
161
|
+
[data-step-state="before"][data-step-enter="blur"],
|
|
162
|
+
[data-step-state="gone"][data-step-exit="blur"] {
|
|
163
|
+
opacity: 0;
|
|
164
|
+
filter: blur(12px);
|
|
165
|
+
}
|
|
166
|
+
[data-step-state="before"][data-step-enter="wipe"],
|
|
167
|
+
[data-step-state="gone"][data-step-exit="wipe"] {
|
|
168
|
+
clip-path: inset(0 100% 0 0);
|
|
169
|
+
}
|
|
170
|
+
|
|
171
|
+
mark[data-step-state][data-step-enter] {
|
|
172
|
+
opacity: 1;
|
|
173
|
+
}
|
|
174
|
+
mark[data-step-state] {
|
|
175
|
+
visibility: visible;
|
|
176
|
+
color: inherit;
|
|
177
|
+
background:
|
|
178
|
+
linear-gradient(
|
|
179
|
+
var(--deck-highlight, color-mix(in srgb, currentColor 25%, transparent)),
|
|
180
|
+
var(--deck-highlight, color-mix(in srgb, currentColor 25%, transparent))
|
|
181
|
+
)
|
|
182
|
+
left / 0% 100% no-repeat;
|
|
183
|
+
transition: background-size var(--deck-dur-slow) var(--deck-ease-draw);
|
|
184
|
+
}
|
|
185
|
+
mark[data-step-state="current"],
|
|
186
|
+
mark[data-step-state="after"] {
|
|
187
|
+
background-size: 100% 100%;
|
|
188
|
+
}
|
|
189
|
+
|
|
190
|
+
.rd-draw[data-step-state] {
|
|
191
|
+
opacity: 1;
|
|
192
|
+
transition-duration: var(--deck-dur-slow);
|
|
193
|
+
}
|
|
194
|
+
.rd-draw[data-step-state="before"],
|
|
195
|
+
.rd-draw[data-step-state="gone"] {
|
|
196
|
+
transition-delay: 0ms, 0ms, 0ms, 0ms, var(--deck-dur-slow);
|
|
197
|
+
}
|
|
198
|
+
.rd-draw[data-step-state] > [pathLength="1"] {
|
|
199
|
+
stroke-dasharray: 1;
|
|
200
|
+
stroke-dashoffset: 0;
|
|
201
|
+
transition: stroke-dashoffset var(--deck-dur-slow) var(--deck-ease-draw);
|
|
202
|
+
}
|
|
203
|
+
.rd-draw[data-step-state="before"] > [pathLength="1"],
|
|
204
|
+
.rd-draw[data-step-state="gone"] > [pathLength="1"] {
|
|
205
|
+
stroke-dashoffset: 1;
|
|
206
|
+
}
|
|
207
|
+
|
|
208
|
+
[data-deck-context]:not([data-deck-context="slide"]) [data-step-state] {
|
|
209
|
+
transition-duration: 0ms;
|
|
210
|
+
transition-delay: 0ms;
|
|
211
|
+
}
|
|
212
|
+
[data-deck-context]:not([data-deck-context="slide"]) .rd-draw[data-step-state] > * {
|
|
213
|
+
transition-duration: 0ms;
|
|
214
|
+
}
|
|
215
|
+
}
|
package/dist/motion.d.ts
ADDED
|
@@ -0,0 +1,2 @@
|
|
|
1
|
+
import { _ as CountUp, a as gsap, c as Draw, d as Step, f as StepPreset, g as Morph, h as useStepState, i as ease, l as Highlight, m as TextReveal, n as useTimeline, o as motionMode, p as Steps, r as duration, s as stagger, t as useTween, u as Stagger, v as CodeBlock } from "./index-B2n69xrC.js";
|
|
2
|
+
export { CodeBlock, CountUp, Draw, Highlight, Morph, Stagger, Step, type StepPreset, Steps, TextReveal, duration, ease, gsap, motionMode, stagger, useStepState, useTimeline, useTween };
|
package/dist/motion.js
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export { _ as CodeBlock, r as CountUp, u as Draw, d as Highlight, n as Morph, f as Stagger, p as Step, m as Steps, h as TextReveal, a as duration, o as ease, s as gsap, c as motionMode, l as stagger, g as useStepState, t as useTimeline, i as useTween } from "./src-C-OfT72W.js";
|
package/dist/node.d.ts
ADDED
|
@@ -0,0 +1,63 @@
|
|
|
1
|
+
import { O as DeckManifest, k as SlideMeta } from "./index-BV_-6L5L.js";
|
|
2
|
+
import { PluggableList } from "unified";
|
|
3
|
+
import { Plugin, UserConfig } from "vite";
|
|
4
|
+
export declare function runCli(rawArgs?: string[]): Promise<void>;
|
|
5
|
+
interface DeckConfig {
|
|
6
|
+
readonly title: string;
|
|
7
|
+
readonly author?: string;
|
|
8
|
+
/** One line about the deck: the page description and the text of a shared link's preview. */
|
|
9
|
+
readonly info?: string;
|
|
10
|
+
/** Where the built deck is published. Share previews need it for absolute links. */
|
|
11
|
+
readonly url?: string;
|
|
12
|
+
readonly canvas?: {
|
|
13
|
+
readonly width: number;
|
|
14
|
+
readonly height: number;
|
|
15
|
+
};
|
|
16
|
+
readonly transition?: string;
|
|
17
|
+
readonly htmlAttrs?: Readonly<Record<string, string>>;
|
|
18
|
+
/**
|
|
19
|
+
* The "Created with Decks" credit in the lower right of every slide. On by default; `false`
|
|
20
|
+
* removes it. To replace it, add `layers/credit.tsx` to the deck.
|
|
21
|
+
*/
|
|
22
|
+
readonly credit?: boolean;
|
|
23
|
+
readonly vite?: UserConfig;
|
|
24
|
+
/** remark and rehype plugins added to the slide compiler. */
|
|
25
|
+
readonly mdx?: {
|
|
26
|
+
readonly remarkPlugins?: PluggableList;
|
|
27
|
+
readonly rehypePlugins?: PluggableList;
|
|
28
|
+
};
|
|
29
|
+
}
|
|
30
|
+
interface ResolvedDeck {
|
|
31
|
+
readonly name: string;
|
|
32
|
+
readonly dir: string;
|
|
33
|
+
readonly config: DeckConfig & {
|
|
34
|
+
readonly canvas: {
|
|
35
|
+
readonly width: number;
|
|
36
|
+
readonly height: number;
|
|
37
|
+
};
|
|
38
|
+
readonly credit: boolean;
|
|
39
|
+
};
|
|
40
|
+
}
|
|
41
|
+
export declare function defineDeck(config: DeckConfig): DeckConfig;
|
|
42
|
+
export declare function loadDeck(dir: string, name?: string): Promise<ResolvedDeck>;
|
|
43
|
+
export declare function reactDecks(deck: ResolvedDeck): Plugin[];
|
|
44
|
+
interface DevServer {
|
|
45
|
+
readonly url: string;
|
|
46
|
+
close(): Promise<void>;
|
|
47
|
+
}
|
|
48
|
+
export declare function dev(deck: ResolvedDeck, options?: {
|
|
49
|
+
port?: number;
|
|
50
|
+
open?: boolean;
|
|
51
|
+
}): Promise<DevServer>;
|
|
52
|
+
export declare function build(deck: ResolvedDeck, options: {
|
|
53
|
+
outDir: string;
|
|
54
|
+
base?: string;
|
|
55
|
+
ogImage?: boolean;
|
|
56
|
+
}): Promise<void>;
|
|
57
|
+
interface ScannedSlide {
|
|
58
|
+
readonly meta: SlideMeta;
|
|
59
|
+
readonly frontmatter: Readonly<Record<string, unknown>>;
|
|
60
|
+
}
|
|
61
|
+
export declare function scanSlides(deck: ResolvedDeck): Promise<readonly ScannedSlide[]>;
|
|
62
|
+
export declare function buildManifest(deck: ResolvedDeck, slides: readonly ScannedSlide[]): DeckManifest;
|
|
63
|
+
export type { DeckConfig, DevServer, ResolvedDeck, ScannedSlide };
|
package/dist/node.js
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export { n as build, s as buildManifest, a as defineDeck, r as dev, o as loadDeck, i as reactDecks, t as runCli, c as scanSlides } from "./src-CmQgaG1b.js";
|
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
@layer react-decks {
|
|
2
|
+
.rd-overview-view {
|
|
3
|
+
--rd-ui-line: color-mix(in oklab, currentColor 22%, transparent);
|
|
4
|
+
--rd-ui-dim: color-mix(in oklab, currentColor 62%, transparent);
|
|
5
|
+
--rd-ui-accent: oklch(0.8 0.13 200);
|
|
6
|
+
box-sizing: border-box;
|
|
7
|
+
position: fixed;
|
|
8
|
+
inset: 0;
|
|
9
|
+
overflow: auto;
|
|
10
|
+
display: grid;
|
|
11
|
+
grid-template-columns: repeat(auto-fill, minmax(20rem, 1fr));
|
|
12
|
+
align-content: start;
|
|
13
|
+
gap: 1.5rem;
|
|
14
|
+
padding: 2rem;
|
|
15
|
+
font:
|
|
16
|
+
0.9375rem / 1.4 system-ui,
|
|
17
|
+
sans-serif;
|
|
18
|
+
}
|
|
19
|
+
|
|
20
|
+
.rd-overview-tile {
|
|
21
|
+
min-width: 0;
|
|
22
|
+
padding: 0;
|
|
23
|
+
border: 0;
|
|
24
|
+
color: inherit;
|
|
25
|
+
background: transparent;
|
|
26
|
+
font: inherit;
|
|
27
|
+
text-align: start;
|
|
28
|
+
cursor: pointer;
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
.rd-overview-box {
|
|
32
|
+
overflow: hidden;
|
|
33
|
+
margin-bottom: 0.625rem;
|
|
34
|
+
border-radius: 0.5rem;
|
|
35
|
+
box-shadow: 0 0 0 1px var(--rd-ui-line);
|
|
36
|
+
pointer-events: none;
|
|
37
|
+
}
|
|
38
|
+
|
|
39
|
+
.rd-overview-tile:hover .rd-overview-box {
|
|
40
|
+
box-shadow: 0 0 0 1px var(--rd-ui-dim);
|
|
41
|
+
}
|
|
42
|
+
|
|
43
|
+
.rd-overview-tile:focus-visible {
|
|
44
|
+
outline: none;
|
|
45
|
+
}
|
|
46
|
+
|
|
47
|
+
.rd-overview-tile:focus-visible .rd-overview-box {
|
|
48
|
+
box-shadow: 0 0 0 3px var(--rd-ui-accent);
|
|
49
|
+
}
|
|
50
|
+
|
|
51
|
+
.rd-overview-tile > span {
|
|
52
|
+
color: var(--rd-ui-dim);
|
|
53
|
+
}
|
|
54
|
+
|
|
55
|
+
.rd-overview-tile[aria-current="true"] > span {
|
|
56
|
+
color: inherit;
|
|
57
|
+
}
|
|
58
|
+
}
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
@layer react-decks {
|
|
2
|
+
html[data-deck-idle],
|
|
3
|
+
html[data-deck-idle] * {
|
|
4
|
+
cursor: none;
|
|
5
|
+
}
|
|
6
|
+
.rd-play-view {
|
|
7
|
+
position: fixed;
|
|
8
|
+
inset: 0;
|
|
9
|
+
width: 100vw;
|
|
10
|
+
height: 100dvh;
|
|
11
|
+
overflow: hidden;
|
|
12
|
+
}
|
|
13
|
+
|
|
14
|
+
/* A slide fills its frame in every view: the play view, the presenter's two boxes and each
|
|
15
|
+
overview tile. A slide whose content is sized as a share of its parent (height: 100%)
|
|
16
|
+
would otherwise collapse to nothing outside the play view. */
|
|
17
|
+
.rd-frame {
|
|
18
|
+
position: relative;
|
|
19
|
+
}
|
|
20
|
+
|
|
21
|
+
.rd-frame > [data-deck-slide] {
|
|
22
|
+
position: absolute;
|
|
23
|
+
inset: 0;
|
|
24
|
+
}
|
|
25
|
+
|
|
26
|
+
.rd-frame > [data-deck-slide][hidden] {
|
|
27
|
+
display: none !important;
|
|
28
|
+
}
|
|
29
|
+
}
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: building-a-deck
|
|
3
|
+
description: Use when creating a conventional or story deck with @steamfield/decks, or revising a deck's structure, to scaffold, source, author, inspect and deliver it.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Building a deck
|
|
7
|
+
|
|
8
|
+
Load `decks:working-with-decks` first and read the installed guide. A conventional deck uses MDX for claims, lists, tables and charts. A story deck keeps one visualization pinned per slide, changes it on clicks, and puts visible prose in a React stage's `COPY` array.
|
|
9
|
+
|
|
10
|
+
Read [workflow and definition of done](references/workflow.md). Follow this order:
|
|
11
|
+
|
|
12
|
+
1. Establish audience, talk length, desired decision and available evidence. Honor the requested slide count. Write an arc of claim headlines before building layouts.
|
|
13
|
+
2. Load `decks:writing-slides` and `decks:deck-design`. For story decks or motion, load `decks:deck-motion`. For numbers, load `decks:deck-data`; for charts or Ink marks, load `decks:visualization` too. Do this before writing copy or figures.
|
|
14
|
+
3. Scaffold with `decks new <alias> [dir]`, adding `--story` for a story deck. Keep an existing deck's conventions when revising it.
|
|
15
|
+
4. Source the figures and record provenance. Build the cover and one representative slide to establish the visual direction; review their rendered appearance before repeating the design.
|
|
16
|
+
5. Author one MDX file per slide. A story slide names a stage component and explicitly sets `clicks: COPY.length - 1`. Keep motion paced by clicks and every beat reversible.
|
|
17
|
+
6. Verify throughout: `decks check`, `decks lint <deck>`, inspect changed slides and click states, then `decks build <deck>`. Fix problems and repeat the affected checks.
|
|
18
|
+
7. Before delivery, review all visible strings and notes for prose defects; run the fact-check in `decks:deck-data` on every data-driven deck. Finish with the checks, screenshots and PDF inspection in the definition of done.
|
|
19
|
+
|
|
20
|
+
Do not invent a fact because the outline needs it. Missing or contradictory evidence changes the claim, the visual or the outline. Tell the author what is unresolved.
|
|
21
|
+
|
|
22
|
+
A clean linter and a successful build do not establish presentation quality. Read the rendered slides at audience size, and walk the talk in both directions.
|