@echelon-foundry/design-system 0.2.0-main.16.1 → 0.2.0

package/patterns/aegis-faults.manifest.md

@@ -1,81 +0,0 @@
-# Feature Manifest — Aegis fault presentation
-
-## Purpose
-
-Provide the canonical Forma presentation vocabulary for user-facing Aegis faults without making Forma understand, store, classify, recover, or authorize a raw Aegis `Fault`.
-
-## Upstream contract
-
-The default integration input is the safe Aegis `Presentation.T` model:
-
-- `Title`
-- `Message`
-- `Severity`
-- `Intent`
-- `Actions`
-- `Reference`
-
-The full Aegis `Fault` record is not a Forma input contract.
-
-## Intent mapping
-
-- `Silent`: render no visible fault surface.
-- `Inline`: `.ef-fault--inline` / `<ef-fault-inline>`.
-- `Notification`: `.ef-fault-notification` / `<ef-fault-notification>`.
-- `Banner`: `.ef-fault-banner` / `<ef-fault-banner>`.
-- `Blocking`: `.ef-fault-blocking` / `<ef-fault-blocking>`.
-
-`<ef-fault>` is the common visual shell. The intent-specific patterns are preferred when the Aegis intent is already known.
-
-## Ownership
-
-- Aegis owns fault classification, presentation intent, severity, recovery policy, safe user message, reference, lifecycle, throttling, and recovery capability derivation.
-- Ordo/application state owns whether a recovery transition is currently legal.
-- Limen/application behavior maps Aegis data into DOM, handles clicks, focus, notification lifecycle, blocking-dialog policy, copy behavior, and revalidates capabilities before executing them.
-- Forma owns semantic markup, CSS, non-color cues, responsive composition, focus styling, reduced-motion behavior, and forced-colors behavior.
-
-## Security boundary
-
-Do not pass the raw Aegis `Fault`, `TechnicalDetails`, `ExceptionDetail`, stack trace, raw context values, breadcrumbs, snapshot locations, secrets, or unredacted diagnostics into these patterns.
-
-`fault-details` is not an escape hatch. It accepts only data that the application has explicitly approved and sanitized for the current audience.
-
-## Recovery action contract
-
-Buttons use `data-ef-aegis-capability` with the exact Aegis capability name. The attribute is descriptive, not authoritative. The consuming application must re-check current capability/state at activation time.
-
-Canonical labels mirror Aegis:
-
-- `CanRetry` → Try again
-- `CanReauthenticate` → Sign in
-- `CanReload` → Reload
-- `CanQuarantine` → Set aside
-- `CanReprocess` → Process again
-- `CanOpenReadOnly` → Open read-only
-- `CanRestoreSink` → Reconnect diagnostics
-
-Never synthesize `Continue anyway` or another action that Aegis/application state did not supply.
-
-## Notification policy
-
-Forma does not run timers. Fault notifications with recovery actions are persistent until the application dismisses/resolves them. An application that chooses timed dismissal for non-actionable information must preserve an accessible durable history or equivalent recovery path and pause/extend timing when required by accessibility policy.
-
-## Summary and repeat policy
-
-Forma does not fingerprint or deduplicate faults. Aegis/application code performs lifecycle/fingerprint logic and supplies already-grouped entries plus occurrence counts. The summary pattern only presents that result.
-
-## Blocking policy
-
-The blocking pattern uses native `dialog` as the semantic surface. Limen/application code is responsible for opening it modally, handling browser close/cancel requests according to current Aegis/Ordo state, keeping legal recovery actions reachable, and restoring focus after resolution.
-
-## Verification
-
-The feature is covered by:
-
-- zero-runtime package checks;
-- generated-site coverage and 320px mobile examples;
-- Axe WCAG A/AA checks;
-- accessible-name/role tests;
-- recovery capability attribute tests;
-- mobile overflow tests;
-- pull-request CI across the repository validation workflows.

package/patterns/diagnostic-status.html

@@ -1,7 +0,0 @@
-<div class="ef-diagnostic-status" data-ef-state="queued" role="status">
-  <span class="ef-diagnostic-status__marker" aria-hidden="true">↥</span>
-  <span class="ef-diagnostic-status__body">
-    <strong>Diagnostics queued</strong>
-    <span>3 reports are waiting to synchronize.</span>
-  </span>
-</div>

package/patterns/fault-banner.html

@@ -1,19 +0,0 @@
-<aside
-  class="ef-alert ef-fault-banner"
-  role="status"
-  data-ef-intent="banner"
-  data-ef-severity="critical"
-  data-ef-motion-weight="standard"
-  data-ef-motion-entry
-  aria-labelledby="fault-banner-title">
-  <div class="ef-alert__icon ef-fault-banner__marker" aria-hidden="true">!!</div>
-  <div class="ef-fault-banner__body">
-    <p class="ef-fault__severity">Critical</p>
-    <h2 class="ef-alert__title" id="fault-banner-title">Diagnostics storage is unavailable</h2>
-    <p>The application is running in a degraded state. New diagnostics are queued locally.</p>
-    <p class="ef-fault-reference">Reference <code>AG-22K8M</code></p>
-  </div>
-  <div class="ef-recovery-actions" role="group" aria-label="Recovery actions">
-    <button type="button" data-ef-aegis-capability="CanRestoreSink">Reconnect diagnostics</button>
-  </div>
-</aside>

package/patterns/fault-blocking.html

@@ -1,25 +0,0 @@
-<button type="button" commandfor="blocking-fault-dialog" command="show-modal">Preview blocking fault</button>
-<dialog
-  class="ef-dialog ef-fault-blocking"
-  id="blocking-fault-dialog"
-  data-ef-intent="blocking"
-  data-ef-severity="critical"
-  data-ef-motion-weight="heavy"
-  aria-labelledby="blocking-fault-title"
-  aria-describedby="blocking-fault-message">
-  <div class="ef-dialog__body">
-    <div class="ef-fault-blocking__heading">
-      <div class="ef-fault-blocking__marker" aria-hidden="true">!!</div>
-      <div>
-        <p class="ef-fault__severity">Critical</p>
-        <h2 id="blocking-fault-title">This application cannot continue safely</h2>
-      </div>
-    </div>
-    <p id="blocking-fault-message">The current state cannot be verified. Use one of the recovery actions below before continuing.</p>
-    <p class="ef-fault-reference">Reference <code>AG-7P2DX</code></p>
-  </div>
-  <div class="ef-dialog__actions ef-recovery-actions" role="group" aria-label="Recovery actions">
-    <button type="button" data-ef-aegis-capability="CanOpenReadOnly">Open read-only</button>
-    <button type="button" data-ef-aegis-capability="CanReload">Reload</button>
-  </div>
-</dialog>

package/patterns/fault-details.html

@@ -1,11 +0,0 @@
-<details class="ef-fault-details">
-  <summary>Safe diagnostic details</summary>
-  <div class="ef-fault-details__content">
-    <dl class="ef-fault-details__list">
-      <div><dt>Reference</dt><dd><code>AG-4F82C</code></dd></div>
-      <div><dt>Application</dt><dd>Chrona</dd></div>
-      <div><dt>Recovery state</dt><dd>Retry available</dd></div>
-    </dl>
-    <p class="ef-fault-details__boundary">Only explicitly approved, already-sanitized diagnostic values belong in this surface.</p>
-  </div>
-</details>

package/patterns/fault-inline.html

@@ -1,17 +0,0 @@
-<div
-  class="ef-fault ef-fault--inline"
-  id="profile-save-fault"
-  data-ef-intent="inline"
-  data-ef-severity="error"
-  aria-labelledby="profile-save-fault-title">
-  <div class="ef-fault__marker" aria-hidden="true">!</div>
-  <div class="ef-fault__body">
-    <p class="ef-fault__severity">Error</p>
-    <p class="ef-fault__title" id="profile-save-fault-title"><strong>Profile was not saved.</strong></p>
-    <p class="ef-fault__message">Check your connection and try again.</p>
-    <p class="ef-fault-reference">Reference <code>AG-4F82C</code></p>
-  </div>
-  <div class="ef-recovery-actions" role="group" aria-label="Recovery actions">
-    <button type="button" data-ef-aegis-capability="CanRetry">Try again</button>
-  </div>
-</div>

package/patterns/fault-notification.html

@@ -1,20 +0,0 @@
-<aside
-  class="ef-toast ef-fault-notification"
-  role="status"
-  data-ef-intent="notification"
-  data-ef-severity="warning"
-  data-ef-motion-weight="standard"
-  data-ef-motion-entry
-  aria-labelledby="fault-notification-title">
-  <div class="ef-fault-notification__marker" aria-hidden="true">!</div>
-  <div class="ef-fault-notification__body">
-    <p class="ef-fault__severity">Warning</p>
-    <h3 class="ef-toast__title" id="fault-notification-title">GitHub is temporarily unavailable</h3>
-    <p>Your work is still local. You can retry the synchronization.</p>
-    <p class="ef-fault-reference">Reference <code>AG-91B7Q</code></p>
-    <div class="ef-recovery-actions" role="group" aria-label="Recovery actions">
-      <button type="button" data-ef-aegis-capability="CanRetry">Try again</button>
-    </div>
-  </div>
-  <button type="button" class="ef-fault-notification__dismiss" data-ef-action="dismiss" aria-label="Dismiss notification">Close</button>
-</aside>

package/patterns/fault-reference.html

@@ -1,5 +0,0 @@
-<p class="ef-fault-reference">
-  <span>Reference</span>
-  <code>AG-4F82C</code>
-  <button type="button" data-ef-action="copy-reference" aria-label="Copy fault reference AG-4F82C">Copy</button>
-</p>

package/patterns/fault-summary.html

@@ -1,20 +0,0 @@
-<section class="ef-fault-summary" tabindex="-1" aria-labelledby="fault-summary-title">
-  <div class="ef-fault-summary__heading">
-    <div class="ef-fault-summary__marker" aria-hidden="true">!</div>
-    <div>
-      <p class="ef-fault__severity">2 unresolved faults</p>
-      <h2 id="fault-summary-title">Some work needs your attention</h2>
-      <p>Repeated occurrences are grouped by the application before rendering.</p>
-    </div>
-  </div>
-  <ol class="ef-fault-summary__list">
-    <li data-ef-severity="error">
-      <a href="#customer-name">Customer name could not be saved</a>
-      <span class="ef-fault-summary__meta">Error · AG-4F82C · occurred 3 times</span>
-    </li>
-    <li data-ef-severity="warning">
-      <a href="#sync-status">Synchronization is waiting for GitHub</a>
-      <span class="ef-fault-summary__meta">Warning · AG-91B7Q</span>
-    </li>
-  </ol>
-</section>

package/patterns/fault.html

@@ -1,17 +0,0 @@
-<section
-  class="ef-fault"
-  data-ef-intent="inline"
-  data-ef-severity="error"
-  aria-labelledby="fault-title"
-  aria-describedby="fault-message">
-  <div class="ef-fault__marker" aria-hidden="true">!</div>
-  <div class="ef-fault__body">
-    <p class="ef-fault__severity">Error</p>
-    <h3 class="ef-fault__title" id="fault-title">Could not save changes</h3>
-    <p class="ef-fault__message" id="fault-message">The update did not complete. Your current values are still available.</p>
-    <p class="ef-fault-reference">Reference <code>AG-4F82C</code></p>
-  </div>
-  <div class="ef-recovery-actions" role="group" aria-label="Recovery actions">
-    <button type="button" data-ef-aegis-capability="CanRetry">Try again</button>
-  </div>
-</section>

package/patterns/recovery-actions.html

@@ -1,5 +0,0 @@
-<div class="ef-recovery-actions" role="group" aria-label="Recovery actions">
-  <button type="button" data-ef-aegis-capability="CanRetry">Try again</button>
-  <button type="button" data-ef-aegis-capability="CanReauthenticate">Sign in</button>
-  <button type="button" data-ef-aegis-capability="CanOpenReadOnly">Open read-only</button>
-</div>