Kwark. Design System
Open Kwark

Provenance label

Says where a proposal came from, in words, and stays with it until a person makes it their own.

ComponentsAI and authorshipReady for Kwark
* Suggested · from your outline, Act 2 * The script mentions · Scene 12 * Converted · Tamil Edited by Mira · from a suggestion Imported image · storyboard pack
* Suggested · from your outline, Act 2 * The script mentions · Scene 12 * Converted · Tamil Edited by Mira · from a suggestion Imported image · storyboard pack
<span class="kw-rev-label">* Suggested · from your outline, Act 2</span>
<span class="kw-rev-label">* The script mentions · Scene 12</span>
<span class="kw-rev-label">* Converted · Tamil</span>
<span class="kw-prov"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M21.2 6.8a1 1 0 0 0-4-4L3.8 16.2a2 2 0 0 0-.5.8l-1.3 4.4a.5.5 0 0 0 .6.6l4.4-1.3a2 2 0 0 0 .8-.5z"/></svg>Edited by Mira · from a suggestion</span>
<span class="kw-prov"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><rect x="8" y="8" width="14" height="14" rx="2"/><path d="M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2"/></svg>Imported image · storyboard pack</span>

What it is

The words that travel with a proposal and name its source, in the same order every time: what happened (Suggested, The script mentions, Converted), then from where (your outline, Act 2; Scene 12; Tamil). After a person accepts or edits it, the label leaves the page and a quiet history line keeps the origin.

Form Look When
On the page dashed pill in --k-rev, leading asterisk while the proposal is still the machine’s
In history quiet text with a glyph after a person accepted or edited it

When to use

  • On every proposal, found item, conversion or imported machine-made image (the storyboard pack’s Imported image), until a person makes it theirs.

When not to use

  • On the writer’s own words, ever. Kwark never labels human writing as human, and never shows AI-written on text a person has changed.
  • As confidence. No percentages, no high confidence: a guess is labelled a guess.

Writing

  • Use Kwark’s names: your outline, Act 2, Scene 12, Casting photos. Never AI-generated or Magic.
  • The breakdown’s own words are the model: The script mentions, Read off the page, never assumed.

Anatomy

  1. Pill: 22px tall, 0 8px, 999px corners, --k-rev-bg, --k-rev text, 1px dashed --k-rev-line, 12px Poppins 600, a leading asterisk (the margin mark of a revised script).
  2. History line: 12px Poppins, --k-text-2, 14px glyph, no fill.

Tokens

Token Light Dark
--k-rev #346a58 #9fd4bf
--k-rev-bg #e4f1eb #1b2b25
--k-rev-line #8cc3ae #4f8a74
--k-text-2 #5b6779 #9ca3af
--k-line #e2e8f0 rgba(255, 255, 255, .1)
--k-radius-pill 999px
--k-fs-meta 12px

React

Use the HTML below with kwark.css. The example shows the markup and styling. Supply any application behavior described on this page.

HTML and CSS

Works anywhere with kwark.css.

<span class="kw-rev-label">* Suggested · from your outline, Act 2</span>
<span class="kw-rev-label">* The script mentions · Scene 12</span>
<span class="kw-rev-label">* Converted · Tamil</span>
<span class="kw-prov"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M21.2 6.8a1 1 0 0 0-4-4L3.8 16.2a2 2 0 0 0-.5.8l-1.3 4.4a.5.5 0 0 0 .6.6l4.4-1.3a2 2 0 0 0 .8-.5z"/></svg>Edited by Mira · from a suggestion</span>
<span class="kw-prov"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><rect x="8" y="8" width="14" height="14" rx="2"/><path d="M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2"/></svg>Imported image · storyboard pack</span>

Keyboard

Not interactive. If it opens details (when, from which file), make it a button named Where this came from.

ARIA

  • Link it to the proposal with aria-describedby. The asterisk is decoration; the words say Suggested.

Rules

  • Must label every machine proposal with what happened and where from, until a person accepts or edits it.
  • Never label a person’s writing, and never show confidence scores.
  • Never use sparkles or the word AI as the label; name the source.
  • Always keep the origin in history after acceptance.

AI readiness test

Task. Label locations Kwark found in the screenplay for the Locations list.

Give the agent. This page, Revision mark, Foundations › AI and authorship.

Constraint. Two locations were inferred from action lines, not headings.

A reliable answer

  • Shows “* The script mentions · Scene 4” on items read from headings
  • Says “inferred from the action” plainly on the two guesses
  • Drops the pill once the location manager edits an item
  • No percentages

Give this Markdown to your coding agent or share its URL.

Open .mdllms.txt
Loading…