Repository navigation
v1.2.0
Added
- Shared conventions for components (
docs/conventions.md,docs/conventions.ja.md): presentation variants and the lesson seed (spec §8.4), box-and-line diagrams, chart attribute names, purpose declarations purposes.json: the purposes a slide may want to say, with default step patterns. Every README declarespurposes:(checked bytools/lint.mjs); CATALOG.md gains a purpose and variant column and a "by purpose" table;manifest.jsoncarriespurposesand each component'spurposesandvariants(the tarball is unchanged in layout)tools/variant.js, copied into components with variants bytools/variant-sync.mjs(checked bynpm test);tools/test-variant.mjs(the choice),tools/test-seed0.mjs(variant 0 is pixel-identical to the last release)m-kpi: variantscount(default, unchanged),rise,flip,underline, chosen byvariant,seedor the lesson'sdata-egatari-seed. A lesson without a seed draws the same pixels as before.count="false"turns a counting variant intorise(with aconsole.info)m-compare(series common, purposecompare): two or three things side by side in a table. A column per side with its heading, a row per criterion, and an optional difference per row (diffin a right-hand column,betterframing the better value). Steps: one side, then the other, then the differences. Variantsfade(default),slide,revealm-venn(series common, purposeoverlap): a Venn diagram of two or three sets (fixed symmetric layout, not area-proportional), with items placed inside each region (A,AB,ABC, …). Steps: one set at a time, then the overlaps highlighted with their items (overlaps="each": one overlap per step). Variantsfade(default),drawm-tree(series common, purposehierarchy): a hierarchy or classification tree laid out from the data (no coordinates; parents centred over their children, subtrees packed by their per-level contours).orientdown or right,linkelbow or straight, stepsby="level"(default) orby="node", optional dashededges; variantsfade,draw,growm-fishbone(series common, purposecause-effect): a cause-and-effect (Ishikawa) diagram laid out from the data: effect head on the right, main bones alternating above and below, causes and sub-causes as labelled ticks. Stepsorder="causes-first"(default; one main bone per step, the head last) ororder="effect-first"; optional dashededges; causes may carrytexand anote; variantsfade,draw,growm-scatter(seriescommon, purposecorrelation): a scatter plot. Groups of points (series) appear one step each, then a trend line ("linear": least squares over all points or chosen series, or two points written inpts). Axis attributesxr yr xt yt xf yf xl ylhave the names and meaning ofm-curves(ranges and ticks are chosen from the data when left out). Labelled points, a marker shape per series, series and trend names above the plot ({r}{a}{b}in a trend name become the correlation, slope and intercept). Variantsfade(default),sweep,growm-pie(seriescommon, purposepart-whole): pie and donut charts (donut). Labels inside large slices, outside with leader lines otherwise; values withunit/digitsand percentages that add up to 100 (show,pct-digits); text in the donut's hole (center,{total}). The whole pie in one step by default;per-stepreveals it slice by slice. Variantsfade(default),sweep,growm-bars:stack="true"draws each group's values stacked in one bar (stacked bars): the bar grows to the total while the series fill it from the bottom, the total is written at the end of the bar and each value inside its part when it fits; series names beside the last bar (vertical) or above the first (horizontal). Withoutstackthe drawing is unchanged (the demo's first three slides are pixel-identical to before)m-timeline(series common, purposetimeline): a timeline laid out from the data (no coordinates). Events (when: a number,"YYYY","YYYY-MM"or"YYYY-MM-DD") sit on the axis with their date and label in boxes alternating above and below (orient="v": left and right; two rows when crowded); periods (end) are bands in lanes under the axis, overlapping periods stack in separate lanes automatically, andlanegroups them into named lanes (alaneevent withoutendis a milestone ◆ in its lane); band and milestone labels may have several lines;whenLabelreplaces the computed date text (明治元年) whilewhenkeeps the position;endis exclusive.scaletime(default) oreven; ticks when there are periods. One event per step in time order (per-step, nodestep); the axis appears with the first event. Variantsfade(default),draw,growm-cycle(series common, purposecycle): stages in array order on a circle (an ellipse in a wide box) from 12 o'clock, clockwise, joined by arrows along the circle; the arrow from the last stage back to the first comes with the last stage. Optionalcenterlabel. 3 to 8 stages. One stage per step (per-step, nodestep). Variantsfade(default),draw,grow
Changed
m-flow: edge labels without atone, and the text ofmutedboxes, are drawn in--fginstead of--muted(the box border stays--muted). They read too pale on a projector. This changes how existing lessons look when rebuilt with v1.2.0 (owner-approved, issue #1). Edges themselves were already--fgand are unchangedm-cycle,m-timeline: anoteinside anemphbox is drawn in--fg(--mutedon--emph-tintis below 4.5:1)m-curves,m-quadandm-kpi: seriescommon(wereacademic,businessandbusiness). Only the catalogue and the AI pack's grouping change; tag names and drawing are unchanged
sha256 616976330eed369c9a69deb79863a5b6adb8a8074b385175cd4305ae3ea8297d egatari-components-v1.2.0.tar.gz