note

This rune is part of @refrakt-md/plan. Install with npm install @refrakt-md/plan and add "@refrakt-md/plan" to the packages array in your refrakt.config.json.

Bug

Bug report with structured reproduction steps. Separate from work items because bugs have different required sections (reproduction steps, expected/actual behaviour) and different status values. H2 headings create named sections.

Confirmed bug

A bug confirmed with reproduction steps and environment details.

{% bug id="RF-201" status="confirmed" severity="major" %}
# Showcase bleed breaks with overflow:hidden parent

## Steps to Reproduce
1. Create a feature section with a parent that has `overflow: hidden`
2. Add a showcase with `bleed="top"` inside the feature
3. Observe the rendered output

## Expected
Showcase extends above the section boundary with visible displacement.

## Actual
Showcase is clipped at the section edge.

## Environment
- Browser: Chrome 122, Firefox 124
- Theme: default
- refrakt.md: v0.4.2
{% /bug %}
<article data-rune="bug">
  <meta content="RF-201" data-field="id">
  <meta content="confirmed" data-field="status">
  <meta content="major" data-field="severity">
  <meta content="" data-field="assignee">
  <meta content="" data-field="milestone">
  <meta content="" data-field="tags">
  <meta content="2026-04-10" data-field="created">
  <meta content="2026-04-10" data-field="modified">
  <header data-name="title">
    <h1 id="showcase-bleed-breaks-with-overflow:hidden-parent">Showcase bleed breaks with overflow:hidden parent</h1>
  </header>
  <div data-name="body">
    <section data-name="steps-to-reproduce">
      <h2 id="steps-to-reproduce">Steps to Reproduce</h2>
      <ol>
        <li>
          Create a feature section with a parent that has
          <code>overflow: hidden</code>
        </li>
        <li>
          Add a showcase with
          <code>bleed=&quot;top&quot;</code>
          inside the feature
        </li>
        <li>Observe the rendered output</li>
      </ol>
    </section>
    <section data-name="expected">
      <h2 id="expected">Expected</h2>
      <p>Showcase extends above the section boundary with visible displacement.</p>
    </section>
    <section data-name="actual">
      <h2 id="actual">Actual</h2>
      <p>Showcase is clipped at the section edge.</p>
    </section>
    <section data-name="environment">
      <h2 id="environment">Environment</h2>
      <ul>
        <li>Browser: Chrome 122, Firefox 124</li>
        <li>Theme: default</li>
        <li>refrakt.md: v0.4.2</li>
      </ul>
    </section>
  </div>
</article>
ID:RF-201Status:confirmedSeverity:major

Showcase bleed breaks with overflow:hidden parent

Steps to Reproduce

  1. Create a feature section with a parent that has overflow: hidden
  2. Add a showcase with bleed="top" inside the feature
  3. Observe the rendered output

Expected

Showcase extends above the section boundary with visible displacement.

Actual

Showcase is clipped at the section edge.

Environment

  • Browser: Chrome 122, Firefox 124
  • Theme: default
  • refrakt.md: v0.4.2
<article class="rf-bug rf-bug--RF-201 rf-bug--confirmed rf-bug--major" data-id="RF-201" data-status="confirmed" data-severity="major" data-created="2026-04-10" data-modified="2026-04-10" data-rune="bug" data-density="full">
  <div data-name="header" class="rf-bug__header" data-section="header">
    <span data-name="id-badge" data-meta-type="id" data-meta-rank="primary" class="rf-bug__id-badge">
      <span data-meta-label="" data-meta-label-hidden="">ID:</span>
      <span data-meta-value="">RF-201</span>
    </span>
    <span data-name="status-badge" data-meta-type="status" data-meta-rank="primary" data-meta-sentiment="caution" class="rf-bug__status-badge">
      <span data-meta-label="" data-meta-label-hidden="">Status:</span>
      <span data-meta-value="">confirmed</span>
    </span>
    <span data-name="severity-badge" data-meta-type="category" data-meta-rank="primary" data-meta-sentiment="caution" class="rf-bug__severity-badge">
      <span data-meta-label="">Severity:</span>
      <span data-meta-value="">major</span>
    </span>
    <time data-name="created-badge" data-meta-type="temporal" data-meta-rank="secondary" class="rf-bug__created-badge">
      <span data-meta-label="">Created:</span>
      <span data-meta-value="">2026-04-10</span>
    </time>
    <time data-name="modified-badge" data-meta-type="temporal" data-meta-rank="secondary" class="rf-bug__modified-badge">
      <span data-meta-label="">Modified:</span>
      <span data-meta-value="">2026-04-10</span>
    </time>
  </div>
  <div data-name="body" class="rf-bug__body" data-section="body">
    <meta content="RF-201" data-field="id" />
    <meta content="confirmed" data-field="status" />
    <meta content="major" data-field="severity" />
    <meta content="" data-field="assignee" />
    <meta content="" data-field="milestone" />
    <meta content="" data-field="tags" />
    <meta content="2026-04-10" data-field="created" />
    <meta content="2026-04-10" data-field="modified" />
    <header data-name="title" class="rf-bug__title">
      <h1 id="showcase-bleed-breaks-with-overflow:hidden-parent">Showcase bleed breaks with overflow:hidden parent</h1>
    </header>
    <div data-name="body" class="rf-bug__body" data-section="body">
      <section data-name="steps-to-reproduce" class="rf-bug__steps-to-reproduce">
        <h2 id="steps-to-reproduce">Steps to Reproduce</h2>
        <ol>
          <li>
            Create a feature section with a parent that has 
            <code>overflow: hidden</code>
          </li>
          <li>
            Add a showcase with 
            <code>bleed=&quot;top&quot;</code>
             inside the feature
          </li>
          <li>Observe the rendered output</li>
        </ol>
      </section>
      <section data-name="expected" class="rf-bug__expected">
        <h2 id="expected">Expected</h2>
        <p>Showcase extends above the section boundary with visible displacement.</p>
      </section>
      <section data-name="actual" class="rf-bug__actual">
        <h2 id="actual">Actual</h2>
        <p>Showcase is clipped at the section edge.</p>
      </section>
      <section data-name="environment" class="rf-bug__environment">
        <h2 id="environment">Environment</h2>
        <ul>
          <li>Browser: Chrome 122, Firefox 124</li>
          <li>Theme: default</li>
          <li>refrakt.md: v0.4.2</li>
        </ul>
      </section>
    </div>
  </div>
</article>

Critical bug

A critical severity bug requiring immediate attention.

{% bug id="RF-305" status="reported" severity="critical" %}
# Build fails when no rune packages configured

## Steps to Reproduce
1. Create a new refrakt project
2. Remove all entries from packages array
3. Run `npm run build`

## Expected
Build succeeds with only core runes.

## Actual
Build crashes with undefined reference error.
{% /bug %}
<article data-rune="bug">
  <meta content="RF-305" data-field="id">
  <meta content="reported" data-field="status">
  <meta content="critical" data-field="severity">
  <meta content="" data-field="assignee">
  <meta content="" data-field="milestone">
  <meta content="" data-field="tags">
  <meta content="2026-04-10" data-field="created">
  <meta content="2026-04-10" data-field="modified">
  <header data-name="title">
    <h1 id="build-fails-when-no-rune-packages-configured">Build fails when no rune packages configured</h1>
  </header>
  <div data-name="body">
    <section data-name="steps-to-reproduce">
      <h2 id="steps-to-reproduce">Steps to Reproduce</h2>
      <ol>
        <li>Create a new refrakt project</li>
        <li>Remove all entries from packages array</li>
        <li>
          Run
          <code>npm run build</code>
        </li>
      </ol>
    </section>
    <section data-name="expected">
      <h2 id="expected">Expected</h2>
      <p>Build succeeds with only core runes.</p>
    </section>
    <section data-name="actual">
      <h2 id="actual">Actual</h2>
      <p>Build crashes with undefined reference error.</p>
    </section>
  </div>
</article>
ID:RF-305Status:reportedSeverity:critical

Build fails when no rune packages configured

Steps to Reproduce

  1. Create a new refrakt project
  2. Remove all entries from packages array
  3. Run npm run build

Expected

Build succeeds with only core runes.

Actual

Build crashes with undefined reference error.

<article class="rf-bug rf-bug--RF-305 rf-bug--reported rf-bug--critical" data-id="RF-305" data-status="reported" data-severity="critical" data-created="2026-04-10" data-modified="2026-04-10" data-rune="bug" data-density="full">
  <div data-name="header" class="rf-bug__header" data-section="header">
    <span data-name="id-badge" data-meta-type="id" data-meta-rank="primary" class="rf-bug__id-badge">
      <span data-meta-label="" data-meta-label-hidden="">ID:</span>
      <span data-meta-value="">RF-305</span>
    </span>
    <span data-name="status-badge" data-meta-type="status" data-meta-rank="primary" data-meta-sentiment="neutral" class="rf-bug__status-badge">
      <span data-meta-label="" data-meta-label-hidden="">Status:</span>
      <span data-meta-value="">reported</span>
    </span>
    <span data-name="severity-badge" data-meta-type="category" data-meta-rank="primary" data-meta-sentiment="negative" class="rf-bug__severity-badge">
      <span data-meta-label="">Severity:</span>
      <span data-meta-value="">critical</span>
    </span>
    <time data-name="created-badge" data-meta-type="temporal" data-meta-rank="secondary" class="rf-bug__created-badge">
      <span data-meta-label="">Created:</span>
      <span data-meta-value="">2026-04-10</span>
    </time>
    <time data-name="modified-badge" data-meta-type="temporal" data-meta-rank="secondary" class="rf-bug__modified-badge">
      <span data-meta-label="">Modified:</span>
      <span data-meta-value="">2026-04-10</span>
    </time>
  </div>
  <div data-name="body" class="rf-bug__body" data-section="body">
    <meta content="RF-305" data-field="id" />
    <meta content="reported" data-field="status" />
    <meta content="critical" data-field="severity" />
    <meta content="" data-field="assignee" />
    <meta content="" data-field="milestone" />
    <meta content="" data-field="tags" />
    <meta content="2026-04-10" data-field="created" />
    <meta content="2026-04-10" data-field="modified" />
    <header data-name="title" class="rf-bug__title">
      <h1 id="build-fails-when-no-rune-packages-configured">Build fails when no rune packages configured</h1>
    </header>
    <div data-name="body" class="rf-bug__body" data-section="body">
      <section data-name="steps-to-reproduce" class="rf-bug__steps-to-reproduce">
        <h2 id="steps-to-reproduce">Steps to Reproduce</h2>
        <ol>
          <li>Create a new refrakt project</li>
          <li>Remove all entries from packages array</li>
          <li>
            Run 
            <code>npm run build</code>
          </li>
        </ol>
      </section>
      <section data-name="expected" class="rf-bug__expected">
        <h2 id="expected">Expected</h2>
        <p>Build succeeds with only core runes.</p>
      </section>
      <section data-name="actual" class="rf-bug__actual">
        <h2 id="actual">Actual</h2>
        <p>Build crashes with undefined reference error.</p>
      </section>
    </div>
  </div>
</article>

Attributes

AttributeTypeDefaultDescription
idstringUnique identifier (required)
statusstringreportedCurrent status: reported, confirmed, in-progress, fixed, wontfix, duplicate
severitystringmajorImpact level: critical, major, minor, cosmetic
assigneestringPerson or agent working on this
milestonestringMilestone for the fix
tagsstringComma-separated labels
createdstring$file.createdCreation date (ISO 8601). Auto-populated from git history
modifiedstring$file.modifiedLast modified date (ISO 8601). Auto-populated from git history

Common attributes

All block runes share these attributes for layout and theming.

AttributeTypeDefaultDescription
widthstringcontentPage grid width: content, wide, or full
spacingstringVertical spacing: flush, tight, default, loose, or breathe
insetstringHorizontal padding: flush, tight, default, loose, or breathe
tintstringNamed colour tint from theme configuration
tint-modestringautoColour scheme override: auto, dark, or light
bgstringNamed background preset from theme configuration