# Susegad UI
> A front-end library for interfaces and documents that are beautiful and comfortable at the same time. Every component has three registers (quiet, warm, playful); each one ships with the prompt that could make it, and components copy into your project so you own the code, the way shadcn/ui works.
## Start here
For an AI agent making a page for someone. The files below are served from https://susegad.asymmetrica.ai with cross-origin headers, so a draft can load them straight from the site. For a page that will go live, copy the files into the project and serve them from there (step 6, or download each one), so the page does not depend on this site.
1. **Choose a register** and put it on the root element: ``. Warm is the default and suits most small businesses (homestays, cafés, studios). Choose quiet when money, compliance or a serious buyer is on the page; choose playful only when the person asks for joy (a festival, a children's page).
2. **Load the fonts and tokens** in the head, and use the tokens' colours and type rather than raw values:
` `
` `
These load from this site; for a live page, copy them and the fonts folder (`packages/tokens/fonts/`) next to your page.
3. **Add a scene** (a drawing made in code) where a picture helps: `` and ` `. The scenes are listed under "Scenes" below; each scene's page on the site has the exact lines under "Use this scene". A scene rests when it is off screen and shows a still under reduced motion by itself.
4. **For a whole page, start from a recipe** (a booking, an enquiry, a menu with WhatsApp orders, an event's programme, speakers and venue, a proposal). Read the recipe's docs below: they name its files and markup. The showcase, https://susegad.asymmetrica.ai/showcase, shows each one running.
5. **For a control** (a form field, a dialog, a badge, a ticket, a consent notice), read the component's docs below. Each one is a native HTML element first, with its behaviour and skin added on top, so it still works with JavaScript off (the tooltip's Escape key is the one known gap).
6. **With a terminal**, `npx @susegad/cli add ` copies a piece and everything it depends on into the project, and `npx @susegad/cli create my-site` makes a whole site from a template (`create` reaches npm with version 0.2.0 of the CLI; until then, run it from a clone of the repository). `SKILL.md` in the repository (https://github.com/sarat-asymmetrica/susegad-ui/blob/main/SKILL.md) is the full guide for an agent working in code.
Keep the words plain, warm and specific, in sentence case. Give every scene a label that says what it shows. Keep the page usable by keyboard and screen reader: the pieces do their part, so do not take away their labels or native elements. Tell the person, in plain words, how to put the page online, and ask for any detail you need (names, photographs, prices) instead of inventing it.
## Components
- [Accordion (accordion, experimental)](packages/components/accordion/accordion.docs.md): Frequently asked questions on the browser's own details and summary: the summary is a real toggle that takes Tab and turns on Enter and Space, and questions sharing a name form an exclusive group, only one open at a time. The element adopts its own name attribute for the children that have none, keeps an account of what is open, and says so once per turn. Quiet is hairline rules and a thin chevron; warm draws the marker in the hand face and opens with a soft slide; playful sets the questions in the hand and flips a drawn, seeded glyph with a spring.
- [Action menu (action-menu, experimental)](packages/components/action-menu/action-menu.docs.md): A button with popovertarget and a popover list of real links and buttons: a click already opens, closes and activates items with no script. With JavaScript this adds the ARIA APG menu button keyboard model (roving tabindex, arrow keys, Home/End, typeahead) and a teental-staggered entrance. Quiet is a ruled list; warm is ink-ruled; playful is stamped.
- [Badge (badge, experimental)](packages/components/badge/badge.docs.md): A word or two of status. The text is the meaning, a distinct shape per tone backs it up, colour comes last. Quiet is text with a hairline rule; warm is a hand-inked outline in the tone's ink; playful is a chip of colour with a kolam flower on the corner. Busy badges breathe or turn, never in quiet or under reduced motion.
- [Banner (banner, experimental)](packages/components/banner/banner.docs.md): An announcement across the top of a page: 'Closed for the monsoon, back 1 October'. The words are the site's own and sit in the element, so the page reads without script. A cross dismisses it, and the dismissal is remembered for that visitor in localStorage with a try/catch around every read and write, so it still renders and dismisses with no storage. Said once through announce(), never for a banner that arrives dismissed or out of date. An optional until date is read in IST (a date alone is through the end of that day) and after it the banner shows nothing; an empty is filled with the date in words in the page's language, in English or in Konkani through core-intl. Quiet is a strip with one hairline, warm a sheet with a seeded pencil rule, playful bunting strung along the bottom.
- [Bloom (bloom, experimental)](packages/components/bloom/bloom.docs.md): A flower head laid out by Vogel's model, drawn face-on as SVG: a marigold (zendu) first. Floret i sits at i times the golden angle and a radius of root i, so the head is evenly dense with no grid and no overlap, and adding a floret never moves the ones already placed. That lets a count be drawn honestly (37 people, 37 florets, and the number in text beside it), a head grow one floret at a time, and every name have its own flower (seed-from). Quiet is single-ink dots, still. Warm is the zendu palette, ruffled petals lit from the upper left, still. Playful grows from the heart outward in CSS (sibling-index() with a --i fallback) and shivers its outer ring when pressed. Reduced motion and Save-Data show the finished head. Draws at most 400 florets. Works under a strict Content-Security-Policy.
- [Bubble (bubble, experimental)](packages/components/bubble/bubble.docs.md): A speech, thought or shout bubble around the page's own paragraph. Quiet is a hairline callout with a small tail in plain CSS text. Warm draws a hand-inked bubble and lays the words into its real shape, line by line, through the type tier; playful adds a bolder pen, a shadow, a tilt, a torn edge on a shout and a pop out of the tail. The words stay real text (one span per line inside the paragraph, or CSS shape-outside for the still), the speaker is named for screen readers, and a bubble that cannot hold the words at a legible size grows, then falls back to plain flow, and never clips.
- [Button (button, experimental)](packages/components/button/button.docs.md): A native or , unchanged, with the register's drawing laid over it: quiet is a hairline outline; warm is a hand-inked outline that boils gently on hover or focus; playful is a stamped chip that presses in and blooms an ink ring on release. Forced colours bring back the browser's own control.
- [Chat thread (chat-thread, experimental)](packages/components/chat-thread/chat-thread.docs.md): A conversation as a list of messages a screen reader can read, instead of a screenshot. Phone numbers, emails and names are taken out at build time and replaced by a marker that says what was removed. Quiet is a ruled transcript like a court record; warm puts each message in a hand-inked bubble on paper; playful uses bright bubbles that bounce in as they scroll into view. Replies quote the earlier message ("Replying to:" for screen readers) and reactions are read once, as words.
- [Checkbox (check, experimental)](packages/components/check/check.docs.md): A native checkbox that submits, validates and takes Space with or without JavaScript. Quiet is a hairline box with a crisp tick drawn by CSS; warm sketches the box in four pencil strokes whose corners cross and draws a heavy tick in by hand; playful is a little rubber-stamp block, and stamps a bold tick over its edge, printed through the stamp's ink texture. Indeterminate, and a "select all" box that goes checked, mixed or clear with its children. Forced colours bring back the system checkbox.
- [Combobox (combobox, experimental)](packages/components/combobox/combobox.docs.md): An input with suggestions. Without JavaScript it is the browser's own input list and datalist; with it, the ARIA APG editable combobox with a listbox popover, full keyboard support, and matching that finds places however people type them: without accents, by an older name, in another script, or spelled as heard. Warm writes it on the paper over the field's pencil rule, with a list ruled in pencil; playful is a stamped box with stamped chips.
- [Connecting (FireflySync) (connecting, experimental)](packages/components/connecting/connecting.docs.md): A connection's state in words, read out as it changes. Quiet shows a static dot; warm and playful show fireflies that blink on their own while connecting and fall into step (Kuramoto coupling) only once connected. Offline, they dim.
- [Consent notice (consent, experimental)](packages/components/consent/consent.docs.md): A draft, not yet reviewed by a lawyer: the plain notice a form shows before it keeps someone's details, written for India's DPDP Act in words a visitor can follow: what is collected, why, for how long, whom to ask, how to withdraw, and a line where the site says where to complain, ending in a native required checkbox that is never pre-ticked. The site gives its own values; one it leaves out shows as a visible, highlighted [placeholder] and the console says so once, so a sample is never published by mistake. The same markup is a pure function (renderConsent) for a build script, so the notice can be plain HTML and read with no script. English, and Konkani in both scripts. Sending without the tick marks the box, moves focus to it and says why. Quiet is a hairline block, warm boxes it in seeded pencil strokes, playful makes it a ticket with a perforated tear line. A starting point, not legal advice: a legal read is the site's to get before it goes live.
- [Data table (data-table, experimental)](packages/components/data-table/data-table.docs.md): A native table that sorts and scrolls. A caption names it; columns marked data-sort sort by a real button with aria-sort, ascending then descending then the written order; money cells marked data-money are rewritten in the Indian grouping (125000 as ₹1,25,000, crore aware) on tabular figures; at phone width the table scrolls inside its own region and the page never scrolls sideways. Quiet is hairline rules and generous space; warm adds a hand-drawn header rule; playful adds colour and a tinted zebra.
- [Date range (date-range, experimental)](packages/components/date-range/date-range.docs.md): Arrival and departure over two native date inputs that submit without JavaScript. With it, a two-month calendar that knows taken nights and turnover mornings from the booking kernels, moves like the APG date grid, feeds the kernels' reasons into native validation, and in warm and playful inks your stay under a season ribbon.
- [Depth photo (depth-photo, experimental)](packages/stage3d/depth-photo/depth-photo.docs.md): : a photograph (or a drawing) with a depth map, seen through a camera. The inside is the picture and its alt is what a screen reader hears. Live (three.js): the focus racks by depth with a circle-of-confusion gather, the camera dollies with true parallax, and the water moves inside a mask. 2D (quiet, reduced motion, lite devices, no WebGL, three blocked): the same frame at rest, the focus still racking, nothing moving on its own. Implements the frame contract for exact-frame export.
- [Dialog (dialog, experimental)](packages/components/dialog/dialog.docs.md): A modal on the native : showModal() traps focus and blocks the page, Escape closes it, focus returns to the opener. Any element with data-sg-dialog opens it; without JavaScript that element is a real link to a real page. Quiet is a plain dimmed backdrop; warm and playful are full-bleed with the Carepa surface behind a floating card, mounted only while open.
- [Doodle (doodle, experimental)](packages/components/doodle/doodle.docs.md): Single-line food drawings, as if done with a marker, in whatever colour the text around them is: a fork lifting a twirl of spaghetti, ravioli, gnocchi, a lemon, a tomato, basil, a whisk, a rolling pin, wheat and a steaming bowl. Inline SVG, one or two unfilled strokes each, with a band mode that lays a seeded row of them edge to edge as a section divider. Quiet is a still hairline; warm draws itself once as it scrolls into view and then boils a little; playful adds a bolder line and a wiggle when touched. Works under a strict Content-Security-Policy.
- [Drawer (drawer, experimental)](packages/components/drawer/drawer.docs.md): A panel sliding in from an edge (start, end, top or bottom), on the same native contract as Dialog: showModal() traps focus, Escape closes, focus returns to the opener. Quiet is a hairline panel; warm is a paper panel with a deckled edge over the Carepa surface; playful is the same, brighter, with the slide timed to the Teental cycle's first beat.
- [Empty state (empty, experimental)](packages/components/empty/empty.docs.md): What a place shows before there is anything in it: your heading, sentence and action, named as a region. Quiet adds a hairline drawing; warm sets a scene (Paus, rain on a Goan window) beside the words, drifting slowly; playful lets you play with it. The scene loads only when a warm or playful page needs it.
- [Event card (event-card, experimental)](packages/components/event-card/event-card.docs.md): One workshop, class, supper club or pop-up: the kind, the title, the date and time, the venue, what you'll do and eat, the price per person and a booking link. It reads the clock in the venue's own time zone and says whether the event is coming up, today, on now or over; a seats line shows only when seats-left is given, sold out only when it is 0, and a finished event stops offering its booking link and says why. Quiet is a ruled card; warm is a ticket with a stub on a perforated line; playful is the same ticket, and the stub tears away a little when you point at it.
- [Event list (event-list, experimental)](packages/components/event-list/event-list.docs.md): A calendar of event cards that keeps itself honest: what is coming up is on top, soonest first; what has happened is put away in a closed "Before" drawer (a native details element); and when nothing is coming it says so in words, with your call to action beside it. When the clock passes an event while the page is open the card moves by itself, from a single timer that runs only while the list is on screen. Quiet is a plain ruled list; warm draws the empty state as a ticket with nothing printed on it yet; playful lets the hand show.
- [Field (TextField, TextArea, Select) (field, experimental)](packages/components/field/field.docs.md): A label over a ruled line, for a line of text, a longer message or a choice from a list, wrapping a native input, textarea or select that types, autofills, validates and submits without JavaScript. Quiet is the hairline rule under a writing well; warm writes on the paper itself, over a seeded pencil rule that inks from left to right on focus and under your words as you type, with a laterite exercise-book margin down a textarea; playful draws the same in accent ink with a thicker nib and wobbles on twos while you type. Counts characters near a maxlength, aloud only at 20, 10 and 0.
- [Field note (field-note, experimental)](packages/components/field-note/field-note.docs.md): The note under a form field that says what is wrong and how to fix it. Follows constraint validation with its own wording (or shows a server message), never nags on the first try, wires aria-describedby and aria-invalid, focuses the first problem on submit. Quiet is small danger text with a mark; warm a margin note in the hand with a pencil arrow; playful inks it on and underlines it.
- [File drop (file-drop, experimental)](packages/components/file-drop/file-drop.docs.md): A native file input you can also drop files onto. Without JavaScript it is the browser's own input; with it, the real input covers a drop zone, and the element checks accept, size and count, lists each file with a Remove button, and says every change in words. Quiet is a ruled zone; warm posts a letter into a pillar box; playful drops it in with a thunk.
- [Diagram (folio-diagram, experimental)](packages/folio/diagram/diagram.docs.md): A diagram from a few lines of text (Guest -> Portal: books): boxes, arrows, flows with things moving along them, groups, and step-through. Drawn at build time as a static SVG with its text alternative from the same source, so it reads and prints without JavaScript. Loops back go round the side that meets no other box, each label sits beside its own line, and where one cannot, every connection carries its step number instead. adds the draw-in, the moving flows, step-through by buttons and keys, register changes, and turns a wide diagram downward on a narrow screen before its words would shrink below about 12 px. Quiet is a plain pen; warm and playful ink it by hand.
- [Form (form, experimental)](packages/components/form/form.docs.md): A native form the browser validates, which says what happens when you send it. Adds a field note to every field, summarises problems and focuses the first, and follows an sg-submit promise (or posts itself with fetch): Sending only while work is pending, then Sent or why it could not send, in one polite voice. Quiet is words only; warm and playful draw a Loader and a Stamp, and a failure is also a Toast. Without JavaScript it validates and submits natively.
- [Gallery (gallery, experimental)](packages/components/gallery/gallery.docs.md): Photographs, consent first: a grid of slots the author writes, where a slot with consent="pending" shows a drawn frame with photo corners, its caption and the count ("2 photos, coming soon"), and never the image; a granted photograph opens larger in the native dialog. Quiet is hairline frames with ruled corners; warm draws hand-drawn photo corners, seeded; playful leans each slot its own seeded half-degree like photos laid on a table.
- [Language switcher (lang, experimental)](packages/components/lang/lang.docs.md): A language switcher that is a row of links. Each link is a real page in its own language (decision 0025), named in its own script (English, कोंकणी, Konknni), with hreflang and lang on it and aria-current on the page you are on, so it works with no JavaScript, for search and for a screen reader. With JavaScript it fills in what the markup leaves out and can remember the last choice, never redirecting. The core also builds the hreflang links for a page's head and the address of a page in each language. Quiet is plain names with a hairline between; warm writes them in the hand with a pencil line under the current one; playful makes them stamped tabs. Devanagari and Romi are both finished: leading follows the script, tracking and capitals are switched off for Indic scripts.
- [Link (link, experimental)](packages/components/link/link.docs.md): A native , unchanged, with the register's underline drawn beneath it: quiet is a plain hairline underline; warm draws an ink line in on hover or focus and back out on leave; playful is the underline as a kolam line, one continuous wave with a small knotted loop. Forced colours bring back the browser's own underline.
- [Loader (loader, experimental)](packages/components/loader/loader.docs.md): A polite status region that says in words what is loading, with a small drawing beside it: three pulsing dots in quiet, a light travelling round a kolam and lighting each dot in warm, a spinning bambaram in playful. It never claims how far along the work is.
- [Menu (menu, experimental)](packages/components/menu/menu.docs.md): A menu and price list a small food business can run on a phone. The page's own semantic list (sections of dishes, each with a name, price in rupees, unit, sauce line, tags as words and an available, sold-out or ask-first status) reads fine with no script; with it, `orderable` adds a quantity stepper per dish (native buttons, one polite live total) and an sg-change event with the lines and the total. Quiet is a typeset price list with leader dots and tabular figures; warm a menu card with a hand-ruled double frame and script section heads; playful price pills and chips where the count settles once when a dish is added.
- [Now note (now-note, experimental)](packages/components/now-note/now-note.docs.md): A short, dated note of what someone is up to right now, with the availability as a badge in words. It adds how long ago it was updated and, past a stale-after limit, says plainly that it may be out of date. Quiet is a dated line; warm is a sticky note in the hand; playful is a café chalkboard in a wooden frame.
- [One-time code (otp, experimental)](packages/components/otp/otp.docs.md): A one-time code entry. The native path is one input with autocomplete="one-time-code" and the number pad, which submits, takes SMS autofill and works without JavaScript. With JavaScript the same input lies transparently over a row of aria-hidden boxes: typing over a box replaces it, backspace works back across them, and a paste keeps just the digits. Quiet is plain boxes; warm stamp boxes that ink each digit; playful a stamp per digit.
- [Person card (person-card, experimental)](packages/components/person-card/person-card.docs.md): One person and what they are building: the name, the role, one line of work and one link. The card shows the person's initials, cut from their name by a pure core, instead of a photo; a photo belongs there only when the author writes it and the person's consent is recorded. Quiet is a hairline card with a plain disc; warm is a soft card with the initials in the hand; playful colours the disc from a seed and tilts the card a little when the pointer or the focus arrives.
- [Player (player, experimental)](packages/player/player.docs.md): The Susegad player: enhances a native video or audio element with a drawn scrubber, captions in our type, a poster that is a scene's still, WebGL video treatments (ink, halftone, duotone, riso) and timed ink annotations on the moving frame. Content sound plays only on its own play press.
- [Popover (popover, experimental)](packages/components/popover/popover.docs.md): A trigger and a native [popover], unchanged: popovertarget opens, closes, focuses and light-dismisses it with or without JavaScript. Quiet is a hairline card; warm is an inland-letter card with a folded corner; playful adds a dashed postmark. Placement uses CSS anchor positioning where supported, and a pure, tested fallback elsewhere.
- [Postcard (postcard, experimental)](packages/components/postcard/postcard.docs.md): A card for a piece of work: title, where and when with a status badge beside them, the problem in a line, what was built and the outcome. The heading's link is stretched over the card, so each card is one tab stop with nothing nested. A rubber stamp for the status is opt-in (status-style="stamp"). Quiet is an index card; warm is the back of a picture postcard on deckled card stock with a printed postage square (a postmark on the stamp when there is one); playful is set down crooked and turns over on hover or focus, and lies flat on touch screens and under reduced motion.
- [Progress (progress, experimental)](packages/components/progress/progress.docs.md): Enhances a native progress element. Quiet is the native bar as a pencil hairline; warm is a small kolam drawn exactly as far as the value, closing at 100%; playful is a cutting-chai glass that fills with tea. It moves only when the value moves, and without a value it says in words what is happening.
- [QR code (qr, experimental)](packages/components/qr/qr.docs.md): A QR code as a picture with its words beside it: a UPI link, a ticket number, a Wi-Fi password. The encoder is in the component (numeric, alphanumeric and UTF-8 byte modes, versions 1 to 40, levels L to H, all eight masks) with no dependency, tested against the standard's example, a reference encoder and a decoder. The words are the builder's own text, selectable and wrapping; the code is one SVG path on a plate that stays light in dark mode and in forced colours. Quiet is a white plate; warm a paper plate with a hand-ruled frame; playful adds block-print studs and draws the frame on once. The modules never change.
- [Quote (quote, experimental)](packages/components/quote/quote.docs.md): A pull-quote or testimonial in a native figure: the words, who said them, their role and business, and an optional link to the source. Quiet sets the words beside a hairline with the name in small capitals; warm writes them in the hand as a margin note with a pencil bracket; playful sets them large under a hand-drawn quotation mark that inks in once.
- [Radio group (radio, experimental)](packages/components/radio/radio.docs.md): A real fieldset of native radios: arrow keys, one choice per name, required and submitting all stay the browser's, with or without JavaScript. Quiet is hairline circles drawn by CSS; warm draws pencil circles and circles the choice in ink, a leaning oval that runs past its start; playful turns the choice into a four-petalled kolam flower. Forced colours bring back the system radios.
- [Reach (reach, experimental)](packages/components/reach/reach.docs.md): A contact block in an address: email and WhatsApp as real links (built by waLink and mailtoLink), a copy-the-number button that appears only where the clipboard works and says in words that it copied, and a line on reply times. Quiet is plain lines; warm is an inland letter that stays pale blue at night; playful is a rubber-stamped card with the stamp's own ink starvation on its frame.
- [Scroll section (scroll-section, experimental)](packages/components/scroll-section/scroll-section.docs.md): A section whose content -- most often a child 's progress -- advances as it travels through the viewport, following the Ghat plate's scroll arithmetic. An IntersectionObserver plus a scroll-event safety net (for a fast jump that could skip the observer's near zone) drive the numeric progress a scene needs, since only JavaScript can set an attribute; a genuinely CSS-only reveal layer (.sg-scroll-reveal) uses native animation-timeline: view() where the browser has it, with no JavaScript at all. Quiet and reduced motion never scrub: the section hands its scene straight back to the scene's own still.
- [Select (select, experimental)](packages/components/select/select.docs.md): The browser's own select, kept native: its keyboard, its screen-reader role and its place in the form are untouched. Where customizable select is supported, CSS draws the button, the caret and the picker: a hairline box and list in quiet; in warm the select is written on the paper, over the field's pencil rule, with a caret of two pencil strokes and ink over the rule under a chosen value; in playful a stamped box with an accent caret, and stamped chips.
- [Signature (signature, experimental)](packages/components/signature/signature.docs.md): Sign by hand or by typing your name. The native path is a typed-name input that submits and works without JavaScript; with it, a pad takes a finger, pen or mouse, inks the stroke from the pen's pressure and speed, and submits the ink as SVG path data in a hidden input. Undo and start again are real buttons. Quiet is a plain line and a plain pen; warm a broad nib whose fresh ink dries into the paper; playful adds a flourish.
- [Site footer (site-footer, experimental)](packages/components/site-footer/site-footer.docs.md): The closing block every site needs: a sign-off line in the site's own voice, the links a reader may still want, and the small print. It enhances a native footer, so without JavaScript the markup you wrote is the whole footer. The small print's copyright year moves forward to the clock's year, once, and never back, and the page hears when it did. Quiet is a ruled footer in the display face; warm writes the sign-off in the hand with a fitted pencil rule under it; playful sets the links down like stamped chips with a short hop.
- [Site nav (site-nav, experimental)](packages/components/site-nav/site-nav.docs.md): A site header that works with no JavaScript: the page links sit in a native details, a Menu button on narrow screens and a row on wide ones, with the current page in aria-current. No dialog or drawer. Quiet is plain links over a hairline rule; warm writes them in the hand with a pencil line under the current page; playful makes them stamped tabs.
- [Skeleton (skeleton, experimental)](packages/components/skeleton/skeleton.docs.md): A placeholder for a region whose content is on its way. The region is aria-busy and says what is loading, then announces the arrival once. Quiet is flat sunk blocks; warm is a pencil sketch whose outlines ink in when the content arrives; playful adds colour washes and a wobble on twos while waiting.
- [Sound switch (sound-switch, experimental)](packages/components/sound-switch/sound-switch.docs.md): The one control that turns Susegad's sound switch on or off, site-wide, over a native checkbox with role=switch. Checking it is the user's own gesture, so switch.js can resume the audio context right there and play the switch's own confirmation. Without JavaScript the checkbox still works as a switch but has no effect, and a note says so. Quiet is the plain switch; warm draws a small speaker with a slash when off and two arcs when on; playful breathes those arcs gently while on.
- [Stamp (stamp, experimental)](packages/components/stamp/stamp.docs.md): A mark that something real has happened: held, received, paid. The words are text in a role="status" region, announced once when it lands. Quiet is a ruled rectangle; warm is a tilted block print with seeded ink starvation and an off-register ghost; playful presses down and the ink spreads.
- [Stepper (stepper, experimental)](packages/components/stepper/stepper.docs.md): A long form walked one step at a time. Without JavaScript every step is a visible fieldset with one submit. With it, Back and Next, focus on each step's legend, progress in words, and nothing typed ever lost. Quiet is numbered stations; warm is a walk on a survey map, the road found round the hills with A*; playful adds footprints.
- [Tabs (tabs, experimental)](packages/components/tabs/tabs.docs.md): A row of headed sections, read one at a time. Without JavaScript it is a table of contents: every section shows and each link jumps to its heading. With JavaScript it is the ARIA APG tabs pattern, automatic activation, and the selected tab is marked by an ink underline that travels to it: a static hairline in quiet, an eased line in warm, the same line with a bead in playful. Panel swaps use a same-document View Transition where the browser has one, else an instant swap.
- [Ticket (ticket, experimental)](packages/components/ticket/ticket.docs.md): A registration's ticket: the name, the event, the time in IST (in words, in English or in Konkani), an id made on the visitor's own device (no 0, O, 1, I or L, because it is read aloud at a door), and the id as a QR code with its text beside it; the code holds the id and nothing else, and a test decodes it to prove the picture and the text agree. It can be saved as a PNG through packages/export/png.js, in the page's language and on paper whatever the theme, and the saved picture decodes to the same id. It is kept only on the visitor's device (localStorage, every read and write wrapped; no email address is kept) so it opens again later, offline too. A new ticket ends in one finishing moment kept in its own small file so a shared success moment can take it over: a settle, one sentence said aloud with the id a character at a time, and focus on the heading. Quiet is a hairline card, warm a paper ticket ruled in pencil and torn along a pencil line, playful a ticket with bites and a perforated tear.
- [Tile band (tile-band, experimental)](packages/components/tile-band/tile-band.docs.md): A band of hand-painted tiles for a border or a section divider: Goan azulejo, the blue-and-white tiles of the Portuguese-era houses and churches, with a majolica sister in cobalt, lemon yellow and leaf green. Four geometric and floral motifs (a rosette, a quatrefoil, quarter-circle corners, a vine) laid from a seed, painted once on a canvas and kept, crisp at any pixel ratio, running along the page or down it. Quiet is a cobalt hairline, flat; warm is a hand-painted glaze with brush variation and crackle; playful turns a tile a quarter when you touch it, and settles.
- [Toast (toast, experimental)](packages/components/toast/toast.docs.md): Short messages that never take focus. A region holds two live regions (polite, and alert for errors) and a pile of letters: the newest in front, the rest peeking above, fanning out when pointed at or focused. Timing follows WCAG 2.2.1: reading time, no timeout for errors or actions, pause on hover, focus and hidden tab. Quiet is a ruled note; warm an inland letter that unfolds; playful adds a postmark that lands.
- [Toggle (toggle, experimental)](packages/components/toggle/toggle.docs.md): A native switch (a checkbox with role="switch") that submits and takes Space with or without JavaScript. Quiet is a plain track and thumb drawn by CSS; warm is the brass tower bolt from a Goan door, sliding into its keeper; playful is a clay diya that lights, its flame flickering only while lit and on screen. Forced colours bring back the system control.
- [Tooltip (tooltip, experimental)](packages/components/tooltip/tooltip.docs.md): A trigger and its accessible description, always linked by aria-describedby so the text reaches assistive technology whether or not it is shown. Quiet is a plain small label; warm hand-letters it; playful adds a pencil leader line. Without JavaScript, CSS alone reveals it by opacity on hover and focus. With JavaScript it becomes a popover (hint where understood, else manual), positioned above the trigger and flipped below when there is little room, by a pure, tested placement().
- [Tumble (tumble, experimental)](packages/components/tumble/tumble.docs.md): A headline that arrives. It wraps a real heading and leaves it alone: the text stays one string in the page, read once, selectable and translatable, while an aria-hidden copy of its letters, laid exactly over it, moves for about a second. Quiet is still. Warm slides the lines in from alternate sides and settles them. Playful drops each letter from above with a little spin, bounces it once and settles it, one after another. It plays once, the first time it is seen, or when the page calls play() (manual), and it waits for the web fonts before it measures. The heading is never left hidden: not without JavaScript, not before it runs, not if anything throws. Works under a strict Content-Security-Policy.
- [Veranda stage (veranda-stage, experimental)](packages/scenes/veranda/veranda-stage.docs.md): : the drawn veranda staged in 3D through , with the page's words on a frosted pane inside it. The words stay real text; drag the grip (core's movable) to move the pane across the picture, PageUp and PageDown or the wheel to bring it forward or send it back, and things in front of it, read from the exact depth map, hide it. Focus follows the pane's depth, and the pane keeps itself readable and clear of every other set of words (the notes, the pot's pane) on release and whenever the camera, the lens or a note changes what is in front. Three.js loads only when the picture will move, from the smaller vendored build. In playful the pane becomes a lens on the veranda in the monsoon or at dusk. Notes stick to places (the door, the seat, the lamp), follow the camera and are found by the depth map under a drop; scrolling can walk the camera down the veranda, stopping at each note. A paragraph marked data-flow sits on its own glass pane at a clay pot that three.js turns on the balcao, the lines set round the pot's silhouette, painted as textured quads beside the pot with the DOM spans staying the real words (spans alone on the 2D tier; a CSS shape-outside hug, nothing measured, in quiet and under reduced motion). Quiet and narrow screens keep the words flat.
- [Voice note (voice-note, experimental)](packages/components/voice-note/voice-note.docs.md): A voice message the way a phone shows it: a play button, a waveform you can seek along, the length, and the transcript always on show. It enhances a native audio element and plays only when its own button is pressed. The waveform comes from real loudness measured at build time, or is a seeded stand-in marked as one. Quiet is a hairline row with square bars; warm has pencil bars and an inked ring; playful is a bright pill whose button springs.
- [WhatsApp order (wa-order, experimental)](packages/components/wa-order/wa-order.docs.md): The order composer for a small food business: it turns a menu selection into a pre-written WhatsApp message. It asks for the day (respecting a notice in hours), a time of day, delivery or pickup, the area, a name and any notes, shows the exact message ("This is what we'll send") and keeps the Send link's wa.me address equal to it. The plain wa.me link stays in the markup, so with no script it still opens WhatsApp. It never says an order is placed: the person sends the message themselves. Quiet is ruled fields, a plain bordered message and one ink-filled button; warm sets the message on ruled paper in the hand; playful is a speech bubble and a button that presses.
## Recipes
- [Agenda (agenda, experimental)](packages/recipes/agenda/README.md): A conference agenda across one or two days, with rooms and tracks, that knows what is on stage now. The page is plain HTML with every time written out in IST; with JavaScript each session may say 'Now on stage, until 11:15 am' or 'Next, at 2 pm' in words (never colour alone), finished ones go quiet but stay readable, and one calm status line follows the Indian clock once a minute. It never moves focus, never announces, and counts in Panjim's days whatever zone the visitor's machine is in.
- [Booking (booking, experimental)](packages/recipes/booking/README.md): Book the whole house, or a room, in four steps built from every Wave 2 part: dates with the season ribbon, guests and room, your details with the phone confirmed by a code, and a signature to confirm and hold, with breakfast as a switch. A live quote from the booking kernels shows every band's nights, GST on its own line and the deposit, calls provisional figures provisional, and shows no figure for a single room the card does not price. The hold is stamped Held. A prototype that sends, holds and charges nothing, and says so; without JavaScript every step shows and the form validates and submits.
- [Ask the house (enquiry) (enquiry, experimental)](packages/recipes/enquiry/README.md): The Casa Exemplo enquiry form rebuilt from library parts: a native form the browser validates, ruled fields that ink as you type, notes in the house's own words, a still line drawing of the house's front elevation in warm and playful, and a send that says plainly it is a prototype and sends nothing. Without JavaScript it validates natively and posts to a page that keeps nothing.
- [File upload (file-upload, experimental)](packages/recipes/file-upload/README.md): Choose photos and PDFs and watch each one arrive. Files too large are refused in plain words beside the field, a dropped file keeps its bar where it stopped and offers Try again, and a Received stamp lands once every file is safe. Each bar reads 99% until the server confirms, so the warm kolam closes only when the file has really arrived. Driven by a pure, seeded fake transport you swap for your own.
- [Food order (food-order, experimental)](packages/recipes/food-order/README.md): A menu and the way to order from it, for a small food business that takes orders on WhatsApp: a short note on how ordering works, a menu with a stepper on every dish you can order, and a composer that writes the order as a plain message (day with notice, time of day, delivery or pickup, area, name, notes), shows the exact words, and opens WhatsApp with them already in the box. With no JavaScript the menu is a readable list and the page keeps one plain wa.me link. It never says an order is placed: the person sends the message and the shop confirms.
- [Greeting card (greeting-card, experimental)](packages/recipes/greeting-card/README.md): A card with a flower of its own: a bloom grown from a person's name, the name, and a line of text, drawn on one canvas and exported as a picture. PNG to keep, JPG to share, and every export says what it really made: the type is read from the bytes and the file is named after them. The same name always draws the same card, byte for byte in one browser, and no two names draw the same one. Cards are drawn in the browser; with no JavaScript the page says so.
- [Member directory (member-directory, experimental)](packages/recipes/member-directory/README.md): A list of person-cards, filtered live by a text field (the library's field) and by track checkboxes, with the filter state in the URL's query so a filtered view is shareable, a count read once by a status region, and a kind empty state that names the two fixes. Without JavaScript the full list shows, unfiltered, and the filters say they do nothing.
- [Offline (offline, experimental)](packages/recipes/offline/README.md): A small service worker for a static site and the page that registers it, so after one visit the site's pages open again with no connection and a page never opened shows a kind 'no connection' page in the visitor's language. It keeps only the site's own pages and the files they need (styles, scripts, fonts, pictures), fetched with GET from its own address, and never a response marked no-store or private; no response to a form, nothing from another address, and no personal data: a ticket is made on the device and drawn from the device's own storage, never cached (decision 0028). The worker is one classic script made from a pure, tested file of rules; the first visit is enough because the page tells the worker what it used. English and Konkani in both scripts.
- [Picture postcard (picture-postcard, experimental)](packages/recipes/picture-postcard/README.md): A postcard of Goa with a typed name on it: a 3:2 card with a picture drawn by one of the library's scenes, the name set under it in any script, a perforated stamp and a postmark with an event's words, and a line saying where to make your own. Saved as a PNG, or as a three-second looping GIF of 30 frames under 5 MB, or handed to the share sheet with the file where the browser has one. Everything is drawn in the browser: nothing is sent anywhere, the same name makes the same card, and the GIF is made a frame at a time, shows its progress, can be cancelled and never freezes the page. The event's words are one config file.
- [Proposal (proposal, experimental)](packages/recipes/proposal/proposal.docs.md): A proposal written in Markdown and built into one sealed Folio file: a cover with the Paus scene, who it is for and from, its date and how long it holds, and a stamped status while it is a draft; one section per heading; a rate card and stay prices worked out by the booking kernels, with other dates to try; a plan you can walk through with a native range; scope and cost tables that stack into labelled cards on a phone; terms; and a signing block with the options as native radios and . It reads, prints and can be signed on paper without JavaScript. The page builder (proposal.page.js, build.mjs) runs in Node beside Folio and is not copied.
- [Room details (room-details, experimental)](packages/recipes/room-details/README.md): A guest-facing room card for a homestay. A skeleton stands in until the room's details really arrive, then inks them in: a painted view, name, beds, the rate in rupees with Indian digit grouping, what is included, and availability as a badge. If the details cannot be loaded it says so plainly, with Try again. Driven by a pure, seeded fake source you swap for your own.
- [Saving footer (saving-footer, experimental)](packages/recipes/saving-footer/README.md): A form that saves itself when the person pauses typing, with a footer that says Saving, Saved at 14:32, or why it could not save. Offline, it shows the connection with fireflies and saves by itself once the connection is back. Driven by a pure, seeded fake transport you swap for your own.
- [Site shell (site-shell, experimental)](packages/recipes/site-shell/README.md): Proves Wave 5's pieces work together on one page for a fictional homestay, Casa Aldona: a header with Tabs (Overview, Rooms, Book) and a Menu (Account), a Dialog ("Ask the house"), a Drawer (the rooms), a scroll section driving the Paus scene by real scroll, and a Kantar interlude between two steps of a small booking flow. Every piece is a plain library part; this recipe adds no new theatre of its own, only the composition and a tiny two-step flow state (site-shell.core.js). Without JavaScript every section shows and Dialog/Drawer's openers are real links to a real page.
- [Speakers (speakers, experimental)](packages/recipes/speakers/README.md): A grid of person-cards for an event's speakers: name, role and organisation, one line on the talk, and the talk's title as a link to its slot in the agenda. No photo: each speaker gets a small marigold grown from their name, as decoration, in the card's round disc (an `avatar` option swaps it). An optional row of track checkboxes narrows the grid, with the choice kept in the address so a filtered view can be shared. Without JavaScript every speaker shows and the links work.
- [The first rain (storybook spread) (storybook-spread, experimental)](packages/recipes/storybook-spread/README.md): One bilingual (English and Marathi), narrated spread of a Goan children's storybook: text beside the paus scene, word-by-word highlighting, always-present captions, and rain intensity driven by which words are playing, not the clock. Works without JavaScript: the story text and native audio controls and captions are always there.
- [Studio home (a mock) (studio-home, experimental)](packages/recipes/studio-home/README.md): A one-person studio's home page from the studio-site pieces: a site nav, a now note, postcards for the work, a client's quote beside the redacted conversation it came from with a voice note in it, and a contact block. All copy is placeholder and says so. Reads in full without JavaScript, in any register.
- [Venue (venue, experimental)](packages/recipes/venue/README.md): Where the event is, in words first: the name and address, landmark directions in plain speech, links out to a maps app (a geo: link on Android, Apple Maps on iPhones, and a plain web link everywhere, the only one on a desktop), how to get there by bus, ferry and car, and a short list of access notes that shows only the rows the author filled (white space counts as empty). A small drawn locator sits beside the words. No embedded map, no iframe, no third-party script. Reads in full without JavaScript.
## Scenes
- [Abri (scene-abri, experimental)](packages/scenes/abri/abri.prompt.md): Deccani cloud paper being made: drops of indigo, ochre, madder and grey-green land on a tray of size and push each other into rings by the area-preserving marbling map, a stylus combs them, a curl drift billows them, and a sheet is laid, lifted and turned to show its print. Quiet is the print as a still; warm makes sheet after sheet; playful takes a hand in the size (pointer, or arrow keys and Enter to drop a colour).
- [Chai (scene-chai, experimental)](packages/scenes/chai/chai.prompt.md): Three small ink drawings on one sheet, meant as a loader, a toggle and a divider: a cutting-chai glass whose steam follows a curl-noise field, a clay diya whose flame leans from the pointer and goes out with a curl of smoke, and a tulsi creeper that grows along a rule. Set lit to put the lamp out or light it. Quiet is the plate's still; warm steams and flickers; playful takes a tap on the flame and a hover on the creeper.
- [Chiro (scene-chiro, experimental)](packages/scenes/chiro/chiro.prompt.md): A Goan laterite compound wall up close through a year: the pits in each cut block grow as a Gray-Scott reaction-diffusion, the monsoon darkens the stone from the top, moss creeps out of the joints and the sun bleaches it back. Quiet is the monsoon-green still; warm an easier year; playful takes a hand (pointer, or arrow keys and Enter) that leaves a damp print, and a brush that rubs red dust loose.
- [Dar (scene-dar, experimental)](packages/scenes/dar/dar.prompt.md): Yours to keep: a Goan house front in elevation, with a laterite wall under lime plaster, a painted door in a lime-white surround, a window of oyster-shell panes and bougainvillea. A key on a ring with a wooden tag swings in, catches on the brass hook by the door and sways to rest, and the tower bolt slides home. Quiet is a hairline elevation; playful swings the key and slides the bolt.
- [Ferry (scene-ferry, experimental)](packages/scenes/ferry/ferry.prompt.md): Four stops across the Mandovi: a river ferry in ballpoint hatching, with a small jetty on the far side, two channel posts and a big jetty on the near bank, each with a lamp. The step attribute sails it to a stop; absent, it idles at the first and never moves on by itself. Quiet is a hairline still; playful advances a stop on a click and a kite circles.
- [Ghat (scene-ghat, experimental)](packages/scenes/ghat/ghat.prompt.md): A survey sheet of the Western Ghats above Goa: contours traced out of a noise height field with marching squares, rivers that find their own way to the sea, a ghat road that switchbacks up the escarpment, hand lettering, and monsoon clouds catching on the ridge. progress inks it from sea level up (a page can tie it to its own scroll); the pointer, or the keyboard hand in playful, reads the height of the ground as text.
- [Kairi (scene-kairi, experimental)](packages/scenes/kairi/kairi.prompt.md): A printed sari border drawn by a machine of spinning circles: each paisley's outline is a Fourier series, the chain grows one circle at a time until the pencil sketch sharpens, then the pen inks it and madder, indigo and turmeric fill it. Set progress from real work and the border is drawn exactly that far ("40% done"). Quiet is the finished border, warm draws it once and rests, playful draws border after border and slows near the pointer; Enter goes on to the next paisley.
- [Kantar (scene-kantar, experimental)](packages/scenes/kantar/kantar.prompt.md): The tiatr stage and curtain: painted proscenium with gold-fringed pelmet, footlights, orchestra pit, and three backdrops (church square, dusk beach, balcão night) behind a heavy red velvet curtain. Quiet is a lit still; warm rises once and rests; playful cycles through scenes, curtain drops, and kantars sung in the spotlight.
- [Khazan (scene-khazan, experimental)](packages/scenes/khazan/khazan.prompt.md): Fireflies over a Goan tidal wetland at night: some four hundred phase oscillators with Kuramoto coupling fall into step in slow waves, with additive glows and rippling reflections. Quiet is a still of a wave passing through the bank; warm lets them find each other; playful lets a hand scatter them. Set progress and the bank is exactly that far in step: a calm loader for syncs and uploads.
- [Kolam (scene-kolam, experimental)](packages/scenes/kolam/kolam.prompt.md): One unbroken line of rice flour around a grid of dots, found with the mirror-curve method. Hairline ink in quiet, drawn once at a hand's pace in warm, poured by your hand with rangoli colour and ants in playful. The progress attribute draws it exactly that far.
- [Mankurad (scene-mankurad, experimental)](packages/scenes/mankurad/mankurad.prompt.md): A short story about a mango in coloured pencil: it ripens in the May heat while a koel calls, clouds come in, the first monsoon rain falls, and it drops into a puddle on red laterite. Hatched tone, boiling outlines, a noise-driven pendulum. Quiet is the plate's still; warm tells the story at an easy pace; playful tells it again on Enter. Set progress and the story holds at that beat, a gentle order or delivery tracker.
- [Maun (scene-maun, experimental)](packages/scenes/maun/maun.prompt.md): A colour field that paints itself in thin veils, rolled on and scraped back so a warm ground glows through, then rests with only a slow breath of light. Four palettes (turmeric, monsoon, kokum, indigo on lime); the same seed is always the same painting. A quiet background for words and a document cover; in playful, a click scrapes a band back. After V. S. Gaitonde's method, not his pictures.
- [Mithagar (scene-mithagar, experimental)](packages/scenes/mithagar/mithagar.prompt.md): The Ribandar salt pans at dawn: a geometric grid of clay bunds, shallow brine reflecting the Goan sky, wooden sluice gates, crystalline white salt crusts, and pyramidal salt heaps. Evaporation recedes the brine and grows the harvest. Quiet is a crisp architectural grid; warm ripples the water; playful lets sandpipers scurry and clicks rake salt pyramids.
- [Mosaico (scene-mosaico, experimental)](packages/scenes/mosaico/mosaico.prompt.md): The cement-tile floor of an old Goan balcão, seen from above: one Truchet tile laid in two turns, so the oxide-red bands join into long winding ribbons, worn and chipped under late window light. Now and then a tile lifts and turns and the ribbons re-route, and a small ant walks the pale line down one ribbon, following the new way. In playful, hover or Enter turns a tile and a click re-lays a patch. Dark pages get the same floor at night.
- [Neel (scene-neel, experimental)](packages/scenes/neel/neel.prompt.md): Hand block printing on khadi cotton: a carved buti block generated from the seed is pressed one impression at a time, indigo outlines first, then a second colour off register, every impression a little starved and turned. Quiet is the finished length; warm prints it at an unhurried pace and rests; playful prints faster and presses where you click or press Enter. Set progress and exactly that share is printed: a loader that shows real work.
- [Nod (scene-nod, experimental)](packages/scenes/nod/nod.prompt.md): The helper that asks first: a cutting chai steams beside a phone on a marble café table; a message arrives, a helper drafts a reply in a dashed card with an empty tick, and it goes out only when a person nods. Warm plays one exchange with a finger's tap; playful waits for your click or Enter; quiet is the draft, waiting.
- [Pahat (scene-pahat, experimental)](packages/scenes/pahat/pahat.prompt.md): The desk at dawn: a barred window at half past four over a laptop and a steel tumbler. The sky goes from indigo to first light, the stars fade, the morning star holds on, the room comes out of the dark and a few birds cross; then it rests. Quiet is a hairline still; in playful your hand moves the dawn.
- [Paus (scene-paus, experimental)](packages/scenes/paus/paus.prompt.md): The monsoon through a Goan window: rain beads, merges and runs down fogged glass. Hosts text in calm zones, clears from the sill up with progress, and wipes under a finger or the arrow keys.
- [Posta (scene-posta, experimental)](packages/scenes/posta/posta.prompt.md): The Old Post Office in Fontainhas: a vintage rosewood sorting desk beneath an oyster shell carepa window with sunbeams, wooden cubbies holding jute-tied letter bundles, a crimson postbox with brass flap, and a brass balance scale.
- [Prahar (scene-prahar, experimental)](packages/scenes/prahar/prahar.prompt.md): A day over a Goan river village in the eight watches of raga time: the sky blended in OKLab, every land layer tinted to the light, the sun and moon on their arcs, lamps after dusk, and a ruler of the eight prahars with each raga in English and Devanagari. Set hour from the page's own clock for a theme that follows the viewer's day; in playful, drag the ruler. The raga-to-hour mapping is one common reckoning; traditions differ.
- [Rampon (scene-rampon, experimental)](packages/scenes/rampon/rampon.prompt.md): Dusk on the Goan shore: a ballpoint sea of short hatching strokes that boils like hand-drawn animation, a sun sinking into haze, palms swaying in seeded wind, a ramponkar's canoe with its net heaped inside, and a few distant birds. Quiet is a single still; warm boils gently; playful boils in full, a click draws a new evening, and a koel calls.
- [Saanj (scene-saanj, experimental)](packages/scenes/saanj/saanj.prompt.md): Dusk over flooded paddy: a sky mixed in OKLCH from apricot through rose to indigo, a line of ink palms, and a murmuration of six hundred rosy starlings flown by boids, which pours into the palms to roost and leaves at dawn. Quiet is one finished frame of the murmuration; warm an easier dusk with a smaller flock; playful makes the pointer, or the arrow keys, a hawk the flock parts around. The flock flies round slotted text.
- [Shet (scene-shet, experimental)](packages/scenes/shet/shet.prompt.md): One year of a Goan paddy field seen from a low rise: cracked April mud, the first rain darkening it drop by drop, flooded plots, green rice combed by wind, ripe gold, the harvest, and the mud cracking again, with two cattle egrets that come with the water. Quiet is the ripening gold as a finished still, warm turns the year at an easier pace, playful gives the wind to the hand. Set progress and the field holds at that point of the year. A scape: the still loads first, the turning year after.
- [Taverna (scene-taverna, experimental)](packages/scenes/taverna/taverna.prompt.md): Rain on bottle glass: a village taverna window on a rainy monsoon night with dark wooden bars, dark green wine bottles, a ceramic jug, and a slate blackboard. Outside, rain sweeps down a cobblestone alley under a glowing streetlamp; on the glass, warm indoor air condenses and raindrops trickle in delicate rivulets. Quiet is a crisp ink elevation; warm settles gracefully; playful chimes the bottles and wipes the misted glass.
- [Themb (scene-themb, experimental)](packages/scenes/themb/themb.prompt.md): Rain on a taro leaf seen from above: a WebGL shader draws the velvet leaf, its inked veins and the beads as signed distance fields joined by a smooth minimum, each a lens over the leaf; a full 2D painting takes over when WebGL is missing, lost or too slow. Beads roll, merge keeping their area, gather in the cup, and the leaf pours them off its tip. Quiet is the still after a shower; warm an easier rain; playful tilts under the pointer or arrow keys, and Enter pours.
- [Tinto (scene-tinto, experimental)](packages/scenes/tinto/tinto.prompt.md): A crowded Goan village square at half past ten, where every figure has a line: the poder on his round, a fish seller and her cat, a card game under the tree, the bus to Mapusa. Point at anyone to read their line; every line is also real text for screen readers. Quiet is a still, warm an easy morning with a slow round of captions, playful the full square with a keyboard hand. For empty states and 404s (focus pins one line). With words="world", the page’s words are chalked on a board outside the Taverna and each shop hangs its hours on a plaque that opens its detail; quiet and small screens keep them flat.
- [Tollem (scene-tollem, experimental)](packages/scenes/tollem/tollem.prompt.md): Looking down into a Goan pool at noon: a WebGL net of light over pale tiles, a frangipani that drops a flower now and then, and a full 2D painting when WebGL is missing, lost or too slow. Quiets under text, shows progress as a flower's place across the pool, and ripples under a finger or the arrow keys.
- [Toran (scene-toran, experimental)](packages/scenes/toran/toran.prompt.md): A Goan doorway on the morning of Chovoth, with a garland of marigolds and mango leaves strung across it from three nails: a Verlet rope that sags, swings in a noise breeze and settles. Quiet is the garland at rest with petals on the step; warm a gentle breeze; playful the full breeze, and the hand (pointer or arrow keys) brushes it, knocking petals loose that drift down and stay. Night with a lantern on dark pages.
- [Vaati (scene-vaati, experimental)](packages/scenes/vaati/vaati.prompt.md): The bowl fills: seen from above, fresh pasta (ravioli, tortellini, gnocchi or farfalle) flies in from the edges along spinning arcs and settles, nudging the pieces already there; sauce is poured and spreads in a swirl, grated cheese falls and catches, basil lands, and the bowl rests. Quiet is a hairline still; warm is ink and wash; playful is flat poster colour with a bold outline, and a click tosses the pasta so it lands again. The progress attribute fills the bowl exactly that much, and sg-scene-settled says once that the meal is made.
- [Vad (scene-vad, experimental)](packages/scenes/vad/vad.prompt.md): A banyan grows in pen and ink by space colonisation: branch tips reach for the nearest points of an umbrella canopy, limbs thicken by the pipe model, leaf masses are hatched over a green wash, and aerial roots drop and thicken into pillar trunks round a stone platform. Quiet is the grown tree; warm grows it slowly and lets the ink boil; playful grows a new one on Enter. Set progress and the tree grows exactly as far as the work has. With words="world", the page’s words are written in the sky beside the tree, each line ending where the canopy begins, and make room for it four times as it grows.
- [Vahi (scene-vahi, experimental)](packages/scenes/vahi/vahi.prompt.md): The pile becomes a ledger: loose receipts, invoices, a bill book and a scrawled chit lift one at a time from a teak table, drift over an open account book while their line is written, and settle on a neat stack; then the book closes and its string is wound. Quiet is a hairline plan of the closed book and the stack; playful scatters the pile at a click. The progress attribute sorts exactly that much.
- [Vel (scene-vel, experimental)](packages/scenes/vel/vel.prompt.md): A magenta bougainvillea grows from behind a laterite compound wall by a seeded L-system, arches up and spills down the lime-washed cap, drawn as inline SVG. Quiet is the grown vine as a still, warm grows it and lets a breeze move a few tips while a bract lets go now and then, playful stirs the branch under the hand and shakes bracts loose. For heroes and seasonal sections over a wall of text.
- [Veranda (scene-veranda, experimental)](packages/scenes/veranda/veranda.prompt.md): A Goan veranda drawn in ink and wash, seen from a seat on it: laterite pillars with a balcão between them, a teak door and a shuttered window in a lime-washed wall, a brass lamp under the rafters, and the garden and paddy beyond. The pillars' shadows are traced from the same solids as the drawing, and so is an exact depth map (white near, sky 0) that lets rack focus and walk the camera in. Quiet is a hairline still, warm sways the lamp, playful lets your hand move the sun, and the dark theme is dusk with the lamp lit. A scape: the still loads first.
## Templates
- [Event page (template-event, experimental)](packages/templates/event/README.md): A starter site for a one-day event in Panjim: a header with a language switcher, a hero scene behind its poster, the agenda that knows what is on stage now, the speakers, the venue and a footer, in English and in Konkani in both scripts. Static files with no build step; `susegad create` writes it and copies the pieces it uses.
## Packages
- [Core (core, beta)](packages/core/README.md): The register (quiet, warm, playful) and its cascade, the scene contract as defineScene, and the sg-scene element that runs any scene with its still, scrim, calm rects, toggle and status text.
- [Core: announce (core-announce, experimental)](packages/core/announce.docs.md): announce('3 people, ₹4,500') says one sentence to a screen reader. It uses document.ariaNotify() (or the sender's own element.ariaNotify()) where the engine has it, and otherwise one shared, visually hidden live region that is made once and reused: polite by default, an alert region only when asked. A burst of calls is read once as the last sentence, so a stepper pressed three times in a second does not queue a backlog. Inside an open modal dialog the fallback region lives inside the dialog, where the rest of the page is inert.
- Core: arrivals (core-arrive, experimental): The JavaScript half of the tala stagger for lists that arrive (menu, event-list, gallery, data-table rows). The stagger itself is CSS in each component; this marks an item seen once its arrival has played so a sort or a re-append never replays it, starts a later batch again from the first beat, switches arrivals off in quiet and under reduced motion, and where sibling-index() is missing hands each item its delay from talaDelay(). Items that would wait past the 600 ms cap arrive with the first beat.
- Core: components (core-component, experimental): SgElement and defineComponent: the light-DOM base every sg-* component extends. It enhances a native child, follows the register, loads one skin per register lazily, batches updates, pauses off screen and survives moves.
- Core: input modality (core-input, experimental): One attribute on the root, data-sg-input, that says whether a moving key (an arrow, Home, End, Page Up or Down) is held or the last input was a pointer, so CSS can drop motion from repeated keyboard actions. Installed on import; core-component imports it. The touch contract's keyboard rule (docs/contributing/touch-contract.md).
- [Core: rupees and the Indian clock (core-intl, experimental)](packages/core/intl.docs.md): Money and time the way Goa writes them, as pure functions that give the same answer on any machine. rupees(125000) is ₹1,25,000 (lakh and crore grouping done by hand, so no engine or ICU build can change it), with paise when asked and a clean minus sign; formatMoney() does other currencies too. Times and dates read in Asia/Kolkata whatever zone the visitor's phone or the build server is in: istDay() is the IST calendar day of an instant, clock() says 11 pm, clock24() 23:00, formatWhen() 'Sun 4 Oct, 11 am to 1 pm', relativeDay() 'today' or 'tomorrow' counted in IST calendar days. Nothing reads the clock; the caller passes now, so tests can fake it. No Temporal yet.
- [Core: Konkani dates and hours (core-intl-kok, experimental)](packages/core/intl.kok.docs.md): Days, months and the hours of the day in Konkani, in Devanagari and in Romi, the same in every engine. formatKonkani(at, { locale: 'gom-Deva', time: true }) reads 'शेनवार 21 नोव्हेंबर, सांजे 7:00' and 'gom-Latn' reads 'Sonvar 21 Novembr, sanje 7:00', in IST whatever the visitor's zone. The tag is mapped gom to kok with its script kept, the engine's own words are probed (Chromium has only a root pattern for Devanagari Konkani and WebKit has no gom alias) and a table of ICU's forms answers when the probe fails. The parts of the day (सकाळीं, दनपारां, सांजे, राती) always come from the table. Draft words, for a native reader. Pure; the formatter can be swapped, so tests fake the engine.
- [Core: poster-first scenes (core-lazy, experimental)](packages/core/lazy.docs.md): sg-lazy wraps a poster (a picture in AVIF, WebP and JPG) and a hidden sg-scene. The poster is the first paint and reads with no JavaScript; the scene's engine and module are fetched only when the element is near the screen, and never by itself under reduced motion, Save-Data, the quiet register or a low-memory device, where the poster stays as the finished still. start() runs it for a viewer who asks. The decision is a pure function (lazy.core.js), and the styles are a constructable sheet, so a strict Content-Security-Policy has nothing to block.
- Core: movable words (core-movable, experimental): : a grip on the reading panel that moves the words by drag or by arrow keys, clamped inside the stage, on frosted glass in warm and playful. The scene makes room live. Off in quiet and when the words sit below the picture. The page remembers the place: sg-words-moved out, words-at in.
- [Core: words in the world (core-orient, experimental)](packages/core/orient.docs.md): Words on a plane that turns a little toward the reader and settles. The register sets the model, not the colour: quiet leaves the words flat and still, warm allows 6 degrees of tilt with a 0.9 s settle, playful 16 degrees with 0.45 s, and a touch screen or Save-Data steps one register down. The turn is one composited transform on the layer, so the text stays real and the layout never moves; quat.core.js is the maths (unit quaternions, shortest-path slerp, a frame-rate-independent damp), orient.core.js is the policy (the readability cone the plane is projected back onto, the seeded sway, the polite status line), orient.js is the only part that touches the DOM. unproject() hands a rect measured through the turn back to the flat plane, so a scene can keep judging occlusion in the plane's own space.
- Core: constructable stylesheets (core-sheet, experimental): adopt(root, css): a piece's styles as one shared constructable stylesheet, so a strict Content-Security-Policy (style-src 'self') has nothing to block. A shadow root adopts it; an element root adopts onto its document, once; a