@hraness/design-kit 0.31.1

package/src/testing.ts

@@ -0,0 +1,307 @@
+/**
+ * Test helpers for product sites that use the article layer and the mockups.
+ *
+ * Framework-neutral: nothing here imports a test runner, React, or the DOM.
+ * `blogConformance` returns named checks that throw on failure, so any runner
+ * can wire them:
+ *
+ * ```ts
+ * for (const check of blogConformance(config)) test(check.name, check.run);
+ * ```
+ *
+ * The markup helpers take rendered HTML strings, such as the output of
+ * `renderToStaticMarkup`.
+ */
+import { articleAdmissionScore, assertArticleAdmissions, isArticleIndexable, type ArticleAdmission } from "./article.js";
+import { LAUNCH_INTERNAL_WORDS, launchCopyProblems } from "./launch.js";
+
+export class ConformanceError extends Error {
+  constructor(message: string) {
+    super(message);
+    this.name = "ConformanceError";
+  }
+}
+
+function fail(message: string): never {
+  throw new ConformanceError(message);
+}
+
+export type ConformanceCheck = Readonly<{ name: string; run: () => void | Promise<void> }>;
+
+/** Visible text of an HTML string: scripts, styles, and tags dropped, common entities decoded, whitespace collapsed. */
+export function htmlText(html: string): string {
+  return html
+    .replace(/<(script|style)\b[\s\S]*?<\/\1>/giu, " ")
+    .replace(/<[^>]+>/gu, " ")
+    .replace(/&#x27;|&#39;|&apos;/gu, "'")
+    .replace(/&quot;/gu, '"')
+    .replace(/&lt;/gu, "<")
+    .replace(/&gt;/gu, ">")
+    .replace(/&nbsp;/gu, " ")
+    .replace(/&amp;/gu, "&")
+    .replace(/\s+/gu, " ")
+    .trim();
+}
+
+/**
+ * Drop invented sample text from mockup markup before checking article prose.
+ * Mockups wrap sample text in `.hkm-sample` leaves; products may pass their
+ * own marker attributes too, such as a filter's skip marker.
+ */
+export function stripMockupSamples(html: string, attributes: readonly string[] = []): string {
+  let result = html.replace(/<span\b[^>]*\sclass="[^"]*\bhkm-sample\b[^"]*"[^>]*>[^<]*<\/span>/gu, " ");
+  for (const attribute of attributes) {
+    const escaped = attribute.replace(/[.*+?^${}()|[\]\\]/gu, "\\$&");
+    result = result.replace(new RegExp(`<(span|p|div)\\b[^>]*\\s${escaped}(=("[^"]*"|'[^']*'))?[^>]*>[^<]*</\\1>`, "gu"), " ");
+  }
+  return result;
+}
+
+export type BlogConformancePost = Readonly<{
+  slug: string;
+  /** `/blog/<slug>` or the product's own base path. */
+  path: string;
+  heading: string;
+  description: string;
+  dek: string;
+  imageAlt?: string;
+}>;
+
+export type BlogConformanceLimits = Readonly<{
+  heading: number;
+  descriptionMin: number;
+  descriptionMax: number;
+  dek: number;
+}>;
+
+export const BLOG_CONFORMANCE_LIMITS: BlogConformanceLimits = Object.freeze({
+  heading: 70,
+  descriptionMin: 70,
+  descriptionMax: 160,
+  dek: 200,
+});
+
+export type BlogConformanceConfig<Post extends BlogConformancePost> = Readonly<{
+  /** Absolute site origin without a trailing slash, such as `https://example.com`. */
+  siteUrl: string;
+  posts: readonly Post[];
+  admissions: readonly ArticleAdmission[];
+  /** Rendered post page HTML. */
+  renderPost: (post: Post) => string | Promise<string>;
+  /** Rendered blog index HTML. */
+  renderIndex?: () => string | Promise<string>;
+  /** Absolute sitemap URLs. */
+  sitemapUrls?: () => readonly string[] | Promise<readonly string[]>;
+  /** RSS or Atom feed XML. */
+  feedXml?: () => string | Promise<string>;
+  /** The robots metadata a post page emits. */
+  robots?: (post: Post) => Readonly<{ index: boolean; follow: boolean }> | Promise<Readonly<{ index: boolean; follow: boolean }>>;
+  /** Published dates of the listed posts, in listing order. */
+  listedDates?: () => readonly string[];
+  limits?: BlogConformanceLimits;
+  /** Extra attributes that mark invented sample text inside figures. */
+  sampleAttributes?: readonly string[];
+}>;
+
+function admissionFor(admissions: readonly ArticleAdmission[], post: BlogConformancePost, siteUrl: string): ArticleAdmission {
+  const found = admissions.find((admission) => admission.href === post.path || admission.href === `${siteUrl}${post.path}`);
+  return found ?? fail(`No admission record for ${post.path}.`);
+}
+
+/**
+ * The shared blog checks: records pass the validator, indexable posts meet the
+ * bar, copy follows the article style rules, each page has one h1 and JSON-LD,
+ * robots follow the lifecycle, and the index, sitemap, and feed list exactly
+ * the indexable posts. Optional checks run when their config field is given.
+ */
+export function blogConformance<Post extends BlogConformancePost>(config: BlogConformanceConfig<Post>): readonly ConformanceCheck[] {
+  const limits = config.limits ?? BLOG_CONFORMANCE_LIMITS;
+  const sampleAttributes = config.sampleAttributes ?? [];
+  const indexable = (post: Post): boolean => isArticleIndexable(admissionFor(config.admissions, post, config.siteUrl));
+  const checks: ConformanceCheck[] = [
+    {
+      name: "every post has one admission record that passes the validator",
+      run: () => {
+        assertArticleAdmissions(config.admissions);
+        const paths = config.posts.map((post) => post.path);
+        if (new Set(paths).size !== paths.length) fail("Two posts share a path.");
+        if (config.admissions.length !== config.posts.length) fail(`${config.admissions.length} admission records for ${config.posts.length} posts.`);
+        for (const post of config.posts) admissionFor(config.admissions, post, config.siteUrl);
+      },
+    },
+    {
+      name: "an indexable post has a real assessment, sources, and a review",
+      run: () => {
+        for (const post of config.posts.filter(indexable)) {
+          const admission = admissionFor(config.admissions, post, config.siteUrl);
+          if (articleAdmissionScore(admission.scores) < 9) fail(`${post.path} scores below 9.`);
+          if (Object.values(admission.scores).includes(0)) fail(`${post.path} has a zero score.`);
+          if (admission.review === null) fail(`${post.path} is indexable without a review.`);
+          if (admission.sources.length === 0) fail(`${post.path} is indexable without sources.`);
+          if (admission.observations.length < 2) fail(`${post.path} needs two observations.`);
+        }
+      },
+    },
+    {
+      name: "headings, descriptions, and deks are unique and within limits",
+      run: () => {
+        for (const key of ["heading", "description", "dek"] as const) {
+          const values = config.posts.map((post) => post[key]);
+          if (new Set(values).size !== values.length) fail(`Two posts share a ${key}.`);
+        }
+        for (const post of config.posts) {
+          if (post.heading.length > limits.heading) fail(`${post.path} heading is longer than ${limits.heading}.`);
+          if (/\.$/u.test(post.heading)) fail(`${post.path} heading ends with a period.`);
+          if (post.description.length < limits.descriptionMin || post.description.length > limits.descriptionMax) {
+            fail(`${post.path} description is outside ${limits.descriptionMin} to ${limits.descriptionMax} characters.`);
+          }
+          if (post.dek.length > limits.dek) fail(`${post.path} dek is longer than ${limits.dek}.`);
+        }
+      },
+    },
+    {
+      name: "every post renders with one h1, the article root, and JSON-LD",
+      run: async () => {
+        for (const post of config.posts) {
+          const html = await config.renderPost(post);
+          const h1 = html.match(/<h1\b/gu)?.length ?? 0;
+          if (h1 !== 1) fail(`${post.path} renders ${h1} h1 elements.`);
+          if (!html.includes("data-hraness-article")) fail(`${post.path} is missing the article root.`);
+          if (!html.includes("application/ld+json")) fail(`${post.path} is missing JSON-LD.`);
+          for (const match of html.matchAll(/href="#([^"]+)"/gu)) {
+            if (!html.includes(`id="${match[1] ?? ""}"`)) fail(`${post.path} links to #${match[1] ?? ""}, which does not exist.`);
+          }
+        }
+      },
+    },
+    {
+      name: "public copy follows the article style rules",
+      run: async () => {
+        for (const post of config.posts) {
+          const html = await config.renderPost(post);
+          const fields = [post.heading, post.dek, post.description, post.imageAlt ?? ""].join(" ");
+          const prose = `${fields} ${htmlText(stripMockupSamples(html, sampleAttributes))}`;
+          // Launch rules cover posts too, minus the internal-word check on body text, which may quote records.
+          const problems = launchCopyProblems(prose, post.path).filter(
+            (problem) => !problem.includes("internal word") && !problem.includes("ends with a question mark") && !problem.includes("thread marker"),
+          );
+          if (problems.length > 0) fail(problems.join("\n"));
+          const internal = new RegExp(`\\b(${LAUNCH_INTERNAL_WORDS.join("|")})s?\\b`, "iu").exec(fields);
+          if (internal !== null) fail(`${post.path} uses the internal word "${internal[0]}" in its heading, dek, or description.`);
+        }
+      },
+    },
+  ];
+  if (config.robots !== undefined) {
+    const robots = config.robots;
+    checks.push({
+      name: "only indexable posts ask to be indexed",
+      run: async () => {
+        for (const post of config.posts) {
+          const value = await robots(post);
+          if (value.index !== indexable(post)) fail(`${post.path} robots index=${String(value.index)} disagrees with its lifecycle.`);
+          if (!value.follow) fail(`${post.path} asks crawlers not to follow links.`);
+        }
+      },
+    });
+  }
+  if (config.renderIndex !== undefined || config.sitemapUrls !== undefined || config.feedXml !== undefined) {
+    checks.push({
+      name: "the index, sitemap, and feed list exactly the indexable posts",
+      run: async () => {
+        const index = config.renderIndex === undefined ? null : await config.renderIndex();
+        const urls = config.sitemapUrls === undefined ? null : new Set(await config.sitemapUrls());
+        const feed = config.feedXml === undefined ? null : await config.feedXml();
+        for (const post of config.posts) {
+          const shown = indexable(post);
+          const absolute = `${config.siteUrl}${post.path}`;
+          if (index !== null && index.includes(`href="${post.path}"`) !== shown) fail(`The index ${shown ? "omits" : "lists"} ${post.path}.`);
+          if (urls !== null && urls.has(absolute) !== shown) fail(`The sitemap ${shown ? "omits" : "lists"} ${post.path}.`);
+          if (feed !== null && feed.includes(absolute) !== shown) fail(`The feed ${shown ? "omits" : "lists"} ${post.path}.`);
+        }
+        if (feed !== null && /&(?!amp;|lt;|gt;|quot;|apos;|#\d+;|#x[0-9a-f]+;)/iu.test(feed)) fail("The feed has an unescaped ampersand.");
+      },
+    });
+  }
+  if (config.listedDates !== undefined) {
+    const listedDates = config.listedDates;
+    checks.push({
+      name: "listed posts are newest first",
+      run: () => {
+        const dates = listedDates();
+        const sorted = dates.toSorted().toReversed();
+        if (dates.some((date, index) => date !== sorted[index])) fail("Listed posts are not newest first.");
+      },
+    });
+  }
+  return Object.freeze(checks);
+}
+
+export type RenderMatrixEntry<Props> = Readonly<{ name: string; props: Props; html: string }>;
+
+/**
+ * Render one component across named prop sets (themes, states, sizes) with
+ * the caller's renderer, such as `(props) => renderToStaticMarkup(<Frame {...props} />)`.
+ * Throws when two cases render the same markup, which usually means a prop is ignored.
+ */
+export function renderMatrix<Props>(
+  render: (props: Props) => string,
+  cases: Readonly<Record<string, Props>>,
+  options: Readonly<{ allowIdentical?: boolean }> = {},
+): readonly RenderMatrixEntry<Props>[] {
+  const entries = Object.entries(cases).map(([name, props]) => Object.freeze({ name, props, html: render(props) }));
+  if (options.allowIdentical !== true) {
+    const seen = new Map<string, string>();
+    for (const entry of entries) {
+      const previous = seen.get(entry.html);
+      if (previous !== undefined) fail(`Cases "${previous}" and "${entry.name}" render the same markup.`);
+      seen.set(entry.html, entry.name);
+    }
+  }
+  return Object.freeze(entries);
+}
+
+/** Mockups sit inside articles and must not add to the page outline. */
+export function assertNoHeadings(html: string, label = "markup"): void {
+  const match = /<h[1-6]\b|role="heading"/iu.exec(html);
+  if (match !== null) fail(`${label} contains a heading (${match[0]}); mockups must not add to the page outline.`);
+}
+
+/**
+ * The root element is one image with a non-empty label, marked out of
+ * snippets, and every descendant is hidden from assistive technology by it.
+ */
+export function assertRoleImgWithLabel(html: string, label = "markup"): void {
+  const root = /^\s*<([a-z][a-z0-9-]*)\b([^>]*)>/iu.exec(html);
+  if (root === null) fail(`${label} has no root element.`);
+  const attributes = root[2] ?? "";
+  if (!/\srole="img"/u.test(attributes)) fail(`${label} root is not role="img".`);
+  const aria = /\saria-label="([^"]*)"/u.exec(attributes);
+  if (aria === null || (aria[1] ?? "").trim().length === 0) fail(`${label} root has no aria-label.`);
+  if (!/\sdata-nosnippet(=|\s|>|$)/u.test(attributes) && !attributes.includes("data-nosnippet")) fail(`${label} root is missing data-nosnippet.`);
+  const inner = html.slice(root[0].length);
+  if (/<(a|button|input|select|textarea)\b/iu.test(inner)) fail(`${label} contains an interactive element inside an image.`);
+  if (/\stabindex="(?!-1")/iu.test(inner)) fail(`${label} contains a focusable element inside an image.`);
+}
+
+/** Domains reserved for documentation (RFC 2606 and RFC 6761). */
+const RESERVED_HOST = /^([a-z0-9-]+\.)*(example\.(com|net|org)|[a-z0-9-]+\.(example|test|invalid|localhost))$/iu;
+
+/**
+ * Handles, emails, and links in mockup markup must be invented: handles from
+ * the allow list, emails and links on reserved example domains only.
+ */
+export function assertFakeHandles(html: string, allowedHandles: readonly string[], label = "markup"): void {
+  const text = htmlText(html);
+  const allowed = new Set(allowedHandles.map((handle) => handle.replace(/^@/u, "").toLowerCase()));
+  for (const match of text.matchAll(/(^|[\s(])@([a-z0-9_.]{2,30})\b/giu)) {
+    const handle = (match[2] ?? "").toLowerCase();
+    if (!allowed.has(handle)) fail(`${label} shows the handle @${handle}, which is not in the invented list.`);
+  }
+  for (const match of text.matchAll(/\b[a-z0-9._%+-]+@([a-z0-9.-]+\.[a-z]{2,})\b/giu)) {
+    if (!RESERVED_HOST.test(match[1] ?? "")) fail(`${label} shows the email ${match[0]}, which is not on a reserved example domain.`);
+  }
+  for (const match of html.matchAll(/\bhref="https?:\/\/([^/"]+)/giu)) {
+    if (!RESERVED_HOST.test(match[1] ?? "")) fail(`${label} links to ${match[1] ?? ""}, which is not a reserved example domain.`);
+  }
+}

package/src/tokens.css

@@ -0,0 +1,3 @@
+/* Portable primitives come from @hraness/ui. */
+@import "@hraness/ui/tokens.css";
+@import "./compiler-tokens.css";

package/src/typography.css

@@ -0,0 +1,86 @@
+/* Shared semantic rhythm. The reading scale (sizes, spacing) is consumed by
+ * `.hraness-prose` and the plain-publication article grammar. Site headings
+ * outside those grammars read the same per-level tokens: a heading at level N
+ * takes `--hraness-type-hN-size`, `--hraness-type-hN-font`, and
+ * `--hraness-type-hN-weight` instead of a site-local size and face.
+ *
+ * Legibility rule: the display face (often a condensed serif such as
+ * Instrument Serif) is only used at `--hraness-type-display-min` (1.75rem) or
+ * larger. h1 and h2 are display headings and never scale below that floor;
+ * h3 and h4 use the text face, so a small heading is never set in the display
+ * face. */
+@layer base {
+  :root {
+    --hraness-type-reading-size: clamp(1rem, .95rem + .25vw, 1.0625rem);
+    --hraness-type-reading-leading: 1.7;
+    --hraness-type-reading-measure: 70ch;
+    --hraness-type-caption-size: .9375rem;
+    --hraness-type-code-size: .9rem;
+    --hraness-type-heading-leading: 1.2;
+    --hraness-type-display-min: 1.75rem;
+    --hraness-type-h1-size: clamp(2.25rem, 1.8rem + 1.6vw, 3rem);
+    --hraness-type-h2-size: clamp(1.75rem, 1.45rem + .9vw, 2.125rem);
+    --hraness-type-h3-size: clamp(1.25rem, 1.15rem + .4vw, 1.4375rem);
+    --hraness-type-h4-size: 1.0625rem;
+    /* The display face, for h1 and h2 only. */
+    --hraness-type-heading-font: var(--hraness-marketing-display-font, var(--font-heading, var(--font-text, inherit)));
+    --hraness-type-heading-weight: var(--hraness-marketing-display-weight, 600);
+    /* The text face, for h3 and below. */
+    --hraness-type-subheading-font: var(--font-text, inherit);
+    --hraness-type-subheading-weight: 650;
+    --hraness-type-h1-font: var(--hraness-type-heading-font);
+    --hraness-type-h1-weight: var(--hraness-type-heading-weight);
+    --hraness-type-h2-font: var(--hraness-type-heading-font);
+    --hraness-type-h2-weight: var(--hraness-type-heading-weight);
+    --hraness-type-h3-font: var(--hraness-type-subheading-font);
+    --hraness-type-h3-weight: var(--hraness-type-subheading-weight);
+    --hraness-type-h4-font: var(--hraness-type-subheading-font);
+    --hraness-type-h4-weight: var(--hraness-type-subheading-weight);
+    --hraness-type-section-space: clamp(2.75rem, 2rem + 2vw, 4rem);
+    --hraness-type-subsection-space: 2rem;
+  }
+
+  /* Custom properties resolve where they are declared, so a face token set
+   * on :root would keep :root's face inside a scope that changes the display
+   * or text face (the marketing preset, the Paper theme, the serif reading
+   * face). Re-derive the face and weight tokens in those scopes. */
+  :where([data-hraness-marketing-preset], [data-hraness-theme], [data-hraness-reading-face]) {
+    --hraness-type-heading-font: var(--hraness-marketing-display-font, var(--font-heading, var(--font-text, inherit)));
+    --hraness-type-heading-weight: var(--hraness-marketing-display-weight, 600);
+    --hraness-type-subheading-font: var(--font-text, inherit);
+    --hraness-type-h1-font: var(--hraness-type-heading-font);
+    --hraness-type-h1-weight: var(--hraness-type-heading-weight);
+    --hraness-type-h2-font: var(--hraness-type-heading-font);
+    --hraness-type-h2-weight: var(--hraness-type-heading-weight);
+    --hraness-type-h3-font: var(--hraness-type-subheading-font);
+    --hraness-type-h3-weight: var(--hraness-type-subheading-weight);
+    --hraness-type-h4-font: var(--hraness-type-subheading-font);
+    --hraness-type-h4-weight: var(--hraness-type-subheading-weight);
+  }
+}
+
+.hraness-design-text-chrome {
+  background: var(--chrome-text-gradient);
+  background-clip: text;
+  color: var(--chrome-deep);
+  text-shadow: var(--chrome-text-shadow);
+  -webkit-background-clip: text;
+  -webkit-text-fill-color: transparent;
+}
+
+@supports not ((background-clip: text) or (-webkit-background-clip: text)) {
+  .hraness-design-text-chrome {
+    background: none;
+    color: var(--chrome-deep);
+    -webkit-text-fill-color: currentColor;
+  }
+}
+
+@media (forced-colors: active) {
+  .hraness-design-text-chrome {
+    background: none;
+    color: CanvasText;
+    text-shadow: none;
+    -webkit-text-fill-color: currentColor;
+  }
+}

package/vendor/evilcharts/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Gurbinder
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/vendor/evilcharts/UPSTREAM.md

@@ -0,0 +1,14 @@
+# EvilCharts provenance
+
+- Source: https://github.com/legions-developer/evilcharts
+- Documentation: https://evilcharts.com/docs
+- Upstream commit: `fee646d585602a1c957df94697b35d9e94e16ac8`
+- Retrieved: 2026-07-26
+- License: MIT; see `LICENSE`
+- License SHA-256: `7b6baf25f6caa0de061a2c99a47205d6651cdefc6e636910bc51bb3853ed056e`
+
+`src/react/charts.tsx` and `src/charts.css` adapt EvilCharts' Recharts-first,
+themeable chart-container, gradient, tooltip, and reveal principles to
+framework-neutral tokens and accessibility contracts. These public recipes
+are intentionally data-shape-oriented rather than copies of the
+upstream shadcn/Tailwind file layout.

package/vendor/platform-marks/LICENSE

@@ -0,0 +1,30 @@
+# CC0 1.0 Universal
+
+## Statement of Purpose
+
+The laws of most jurisdictions throughout the world automatically confer exclusive Copyright and Related Rights (defined below) upon the creator and subsequent owner(s) (each and all, an “owner”) of an original work of authorship and/or a database (each, a “Work”).
+
+Certain owners wish to permanently relinquish those rights to a Work for the purpose of contributing to a commons of creative, cultural and scientific works (“Commons”) that the public can reliably and without fear of later claims of infringement build upon, modify, incorporate in other works, reuse and redistribute as freely as possible in any form whatsoever and for any purposes, including without limitation commercial purposes. These owners may contribute to the Commons to promote the ideal of a free culture and the further production of creative, cultural and scientific works, or to gain reputation or greater distribution for their Work in part through the use and efforts of others.
+
+For these and/or other purposes and motivations, and without any expectation of additional consideration or compensation, the person associating CC0 with a Work (the “Affirmer”), to the extent that he or she is an owner of Copyright and Related Rights in the Work, voluntarily elects to apply CC0 to the Work and publicly distribute the Work under its terms, with knowledge of his or her Copyright and Related Rights in the Work and the meaning and intended legal effect of CC0 on those rights.
+
+1. Copyright and Related Rights. A Work made available under CC0 may be protected by copyright and related or neighboring rights (“Copyright and Related Rights”). Copyright and Related Rights include, but are not limited to, the following:
+    1. the right to reproduce, adapt, distribute, perform, display, communicate, and translate a Work;
+    2. moral rights retained by the original author(s) and/or performer(s);
+    3. publicity and privacy rights pertaining to a person’s image or likeness depicted in a Work;
+    4. rights protecting against unfair competition in regards to a Work, subject to the limitations in paragraph 4(i), below;
+    5. rights protecting the extraction, dissemination, use and reuse of data in a Work;
+    6. database rights (such as those arising under Directive 96/9/EC of the European Parliament and of the Council of 11 March 1996 on the legal protection of databases, and under any national implementation thereof, including any amended or successor version of such directive); and
+    7. other similar, equivalent or corresponding rights throughout the world based on applicable law or treaty, and any national implementations thereof.
+
+2. Waiver. To the greatest extent permitted by, but not in contravention of, applicable law, Affirmer hereby overtly, fully, permanently, irrevocably and unconditionally waives, abandons, and surrenders all of Affirmer’s Copyright and Related Rights and associated claims and causes of action, whether now known or unknown (including existing as well as future claims and causes of action), in the Work (i) in all territories worldwide, (ii) for the maximum duration provided by applicable law or treaty (including future time extensions), (iii) in any current or future medium and for any number of copies, and (iv) for any purpose whatsoever, including without limitation commercial, advertising or promotional purposes (the “Waiver”). Affirmer makes the Waiver for the benefit of each member of the public at large and to the detriment of Affirmer’s heirs and successors, fully intending that such Waiver shall not be subject to revocation, rescission, cancellation, termination, or any other legal or equitable action to disrupt the quiet enjoyment of the Work by the public as contemplated by Affirmer’s express Statement of Purpose.
+
+3. Public License Fallback. Should any part of the Waiver for any reason be judged legally invalid or ineffective under applicable law, then the Waiver shall be preserved to the maximum extent permitted taking into account Affirmer’s express Statement of Purpose. In addition, to the extent the Waiver is so judged Affirmer hereby grants to each affected person a royalty-free, non transferable, non sublicensable, non exclusive, irrevocable and unconditional license to exercise Affirmer’s Copyright and Related Rights in the Work (i) in all territories worldwide, (ii) for the maximum duration provided by applicable law or treaty (including future time extensions), (iii) in any current or future medium and for any number of copies, and (iv) for any purpose whatsoever, including without limitation commercial, advertising or promotional purposes (the “License”). The License shall be deemed effective as of the date CC0 was applied by Affirmer to the Work. Should any part of the License for any reason be judged legally invalid or ineffective under applicable law, such partial invalidity or ineffectiveness shall not invalidate the remainder of the License, and in such case Affirmer hereby affirms that he or she will not (i) exercise any of his or her remaining Copyright and Related Rights in the Work or (ii) assert any associated claims and causes of action with respect to the Work, in either case contrary to Affirmer’s express Statement of Purpose.
+
+4. Limitations and Disclaimers.
+    1. No trademark or patent rights held by Affirmer are waived, abandoned, surrendered, licensed or otherwise affected by this document.
+    2. Affirmer offers the Work as-is and makes no representations or warranties of any kind concerning the Work, express, implied, statutory or otherwise, including without limitation warranties of title, merchantability, fitness for a particular purpose, non infringement, or the absence of latent or other defects, accuracy, or the present or absence of errors, whether or not discoverable, all to the greatest extent permissible under applicable law.
+    3. Affirmer disclaims responsibility for clearing rights of other persons that may apply to the Work or any use thereof, including without limitation any person’s Copyright and Related Rights in the Work. Further, Affirmer disclaims responsibility for obtaining any necessary consents, permissions or other rights required for any use of the Work.
+    4. Affirmer understands and acknowledges that Creative Commons is not a party to this document and has no duty or obligation with respect to this CC0 or use of the Work.
+
+For more information, please see <https://creativecommons.org/publicdomain/zero/1.0>.

package/vendor/platform-marks/UPSTREAM.md

@@ -0,0 +1,15 @@
+# Platform mark sources
+
+`apple.svg` and `linux.svg` are vendored unmodified from the
+[`simple-icons`](https://github.com/simple-icons/simple-icons) npm package
+**16.33.0** (`icons/apple.svg`, `icons/linux.svg`), released under CC0-1.0
+(see `LICENSE`). `src/platforms.ts` carries their single `<path d>` values
+verbatim for the macOS and Linux marks; `src/platforms-vendor.test.ts` pins the
+file SHA-256 digests and checks that the module paths still match them.
+
+The Windows four-pane window and the neutral terminal glyph in
+`src/platforms.ts` are original geometry drawn for this package and are
+covered by the package MIT license. They are not vendor artwork.
+
+The marks identify the operating system a command targets (nominative use).
+They are drawn in `currentColor` so surfaces keep one ink.

package/vendor/platform-marks/apple.svg

@@ -0,0 +1 @@
+<svg role="img" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><title>Apple</title><path d="M12.152 6.896c-.948 0-2.415-1.078-3.96-1.04-2.04.027-3.91 1.183-4.961 3.014-2.117 3.675-.546 9.103 1.519 12.09 1.013 1.454 2.208 3.09 3.792 3.039 1.52-.065 2.09-.987 3.935-.987 1.831 0 2.35.987 3.96.948 1.637-.026 2.676-1.48 3.676-2.948 1.156-1.688 1.636-3.325 1.662-3.415-.039-.013-3.182-1.221-3.22-4.857-.026-3.04 2.48-4.494 2.597-4.559-1.429-2.09-3.623-2.324-4.39-2.376-2-.156-3.675 1.09-4.61 1.09zM15.53 3.83c.843-1.012 1.4-2.427 1.245-3.83-1.207.052-2.662.805-3.532 1.818-.78.896-1.454 2.338-1.273 3.714 1.338.104 2.715-.688 3.559-1.701"/></svg>

package/vendor/platform-marks/linux.svg

@@ -0,0 +1 @@
+<svg role="img" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><title>Linux</title><path d="M12.504 0c-.155 0-.315.008-.48.021-4.226.333-3.105 4.807-3.17 6.298-.076 1.092-.3 1.953-1.05 3.02-.885 1.051-2.127 2.75-2.716 4.521-.278.832-.41 1.684-.287 2.489a.424.424 0 00-.11.135c-.26.268-.45.6-.663.839-.199.199-.485.267-.797.4-.313.136-.658.269-.864.68-.09.189-.136.394-.132.602 0 .199.027.4.055.536.058.399.116.728.04.97-.249.68-.28 1.145-.106 1.484.174.334.535.47.94.601.81.2 1.91.135 2.774.6.926.466 1.866.67 2.616.47.526-.116.97-.464 1.208-.946.587-.003 1.23-.269 2.26-.334.699-.058 1.574.267 2.577.2.025.134.063.198.114.333l.003.003c.391.778 1.113 1.132 1.884 1.071.771-.06 1.592-.536 2.257-1.306.631-.765 1.683-1.084 2.378-1.503.348-.199.629-.469.649-.853.023-.4-.2-.811-.714-1.376v-.097l-.003-.003c-.17-.2-.25-.535-.338-.926-.085-.401-.182-.786-.492-1.046h-.003c-.059-.054-.123-.067-.188-.135a.357.357 0 00-.19-.064c.431-1.278.264-2.55-.173-3.694-.533-1.41-1.465-2.638-2.175-3.483-.796-1.005-1.576-1.957-1.56-3.368.026-2.152.236-6.133-3.544-6.139zm.529 3.405h.013c.213 0 .396.062.584.198.19.135.33.332.438.533.105.259.158.459.166.724 0-.02.006-.04.006-.06v.105a.086.086 0 01-.004-.021l-.004-.024a1.807 1.807 0 01-.15.706.953.953 0 01-.213.335.71.71 0 00-.088-.042c-.104-.045-.198-.064-.284-.133a1.312 1.312 0 00-.22-.066c.05-.06.146-.133.183-.198.053-.128.082-.264.088-.402v-.02a1.21 1.21 0 00-.061-.4c-.045-.134-.101-.2-.183-.333-.084-.066-.167-.132-.267-.132h-.016c-.093 0-.176.03-.262.132a.8.8 0 00-.205.334 1.18 1.18 0 00-.09.4v.019c.002.089.008.179.02.267-.193-.067-.438-.135-.607-.202a1.635 1.635 0 01-.018-.2v-.02a1.772 1.772 0 01.15-.768c.082-.22.232-.406.43-.533a.985.985 0 01.594-.2zm-2.962.059h.036c.142 0 .27.048.399.135.146.129.264.288.344.465.09.199.14.4.153.667v.004c.007.134.006.2-.002.266v.08c-.03.007-.056.018-.083.024-.152.055-.274.135-.393.2.012-.09.013-.18.003-.267v-.015c-.012-.133-.04-.2-.082-.333a.613.613 0 00-.166-.267.248.248 0 00-.183-.064h-.021c-.071.006-.13.04-.186.132a.552.552 0 00-.12.27.944.944 0 00-.023.33v.015c.012.135.037.2.08.334.046.134.098.2.166.268.01.009.02.018.034.024-.07.057-.117.07-.176.136a.304.304 0 01-.131.068 2.62 2.62 0 01-.275-.402 1.772 1.772 0 01-.155-.667 1.759 1.759 0 01.08-.668 1.43 1.43 0 01.283-.535c.128-.133.26-.2.418-.2zm1.37 1.706c.332 0 .733.065 1.216.399.293.2.523.269 1.052.468h.003c.255.136.405.266.478.399v-.131a.571.571 0 01.016.47c-.123.31-.516.643-1.063.842v.002c-.268.135-.501.333-.775.465-.276.135-.588.292-1.012.267a1.139 1.139 0 01-.448-.067 3.566 3.566 0 01-.322-.198c-.195-.135-.363-.332-.612-.465v-.005h-.005c-.4-.246-.616-.512-.686-.71-.07-.268-.005-.47.193-.6.224-.135.38-.271.483-.336.104-.074.143-.102.176-.131h.002v-.003c.169-.202.436-.47.839-.601.139-.036.294-.065.466-.065zm2.8 2.142c.358 1.417 1.196 3.475 1.735 4.473.286.534.855 1.659 1.102 3.024.156-.005.33.018.513.064.646-1.671-.546-3.467-1.089-3.966-.22-.2-.232-.335-.123-.335.59.534 1.365 1.572 1.646 2.757.13.535.16 1.104.021 1.67.067.028.135.06.205.067 1.032.534 1.413.938 1.23 1.537v-.043c-.06-.003-.12 0-.18 0h-.016c.151-.467-.182-.825-1.065-1.224-.915-.4-1.646-.336-1.77.465-.008.043-.013.066-.018.135-.068.023-.139.053-.209.064-.43.268-.662.669-.793 1.187-.13.533-.17 1.156-.205 1.869v.003c-.02.334-.17.838-.319 1.35-1.5 1.072-3.58 1.538-5.348.334a2.645 2.645 0 00-.402-.533 1.45 1.45 0 00-.275-.333c.182 0 .338-.03.465-.067a.615.615 0 00.314-.334c.108-.267 0-.697-.345-1.163-.345-.467-.931-.995-1.788-1.521-.63-.4-.986-.87-1.15-1.396-.165-.534-.143-1.085-.015-1.645.245-1.07.873-2.11 1.274-2.763.107-.065.037.135-.408.974-.396.751-1.14 2.497-.122 3.854a8.123 8.123 0 01.647-2.876c.564-1.278 1.743-3.504 1.836-5.268.048.036.217.135.289.202.218.133.38.333.59.465.21.201.477.335.876.335.039.003.075.006.11.006.412 0 .73-.134.997-.268.29-.134.52-.334.74-.4h.005c.467-.135.835-.402 1.044-.7zm2.185 8.958c.037.6.343 1.245.882 1.377.588.134 1.434-.333 1.791-.765l.211-.01c.315-.007.577.01.847.268l.003.003c.208.199.305.53.391.876.085.4.154.78.409 1.066.486.527.645.906.636 1.14l.003-.007v.018l-.003-.012c-.015.262-.185.396-.498.595-.63.401-1.746.712-2.457 1.57-.618.737-1.37 1.14-2.036 1.191-.664.053-1.237-.2-1.574-.898l-.005-.003c-.21-.4-.12-1.025.056-1.69.176-.668.428-1.344.463-1.897.037-.714.076-1.335.195-1.814.12-.465.308-.797.641-.984l.045-.022zm-10.814.049h.01c.053 0 .105.005.157.014.376.055.706.333 1.023.752l.91 1.664.003.003c.243.533.754 1.064 1.189 1.637.434.598.77 1.131.729 1.57v.006c-.057.744-.48 1.148-1.125 1.294-.645.135-1.52.002-2.395-.464-.968-.536-2.118-.469-2.857-.602-.369-.066-.61-.2-.723-.4-.11-.2-.113-.602.123-1.23v-.004l.002-.003c.117-.334.03-.752-.027-1.118-.055-.401-.083-.71.043-.94.16-.334.396-.4.69-.533.294-.135.64-.202.915-.47h.002v-.002c.256-.268.445-.601.668-.838.19-.201.38-.336.663-.336zm7.159-9.074c-.435.201-.945.535-1.488.535-.542 0-.97-.267-1.28-.466-.154-.134-.28-.268-.373-.335-.164-.134-.144-.333-.074-.333.109.016.129.134.199.2.096.066.215.2.36.333.292.2.68.467 1.167.467.485 0 1.053-.267 1.398-.466.195-.135.445-.334.648-.467.156-.136.149-.267.279-.267.128.016.034.134-.147.332a8.097 8.097 0 01-.69.468zm-1.082-1.583V5.64c-.006-.02.013-.042.029-.05.074-.043.18-.027.26.004.063 0 .16.067.15.135-.006.049-.085.066-.135.066-.055 0-.092-.043-.141-.068-.052-.018-.146-.008-.163-.065zm-.551 0c-.02.058-.113.049-.166.066-.047.025-.086.068-.14.068-.05 0-.13-.02-.136-.068-.01-.066.088-.133.15-.133.08-.031.184-.047.259-.005.019.009.036.03.03.05v.02h.003z"/></svg>

package/vendor/provider-marks/CRUSH-LICENSE.md

@@ -0,0 +1,134 @@
+# Functional Source License, Version 1.1, MIT Future License
+
+## Abbreviation
+
+FSL-1.1-MIT
+
+## Notice
+
+Copyright 2025 Charmbracelet, Inc
+
+## Terms and Conditions
+
+### Licensor ("We")
+
+The party offering the Software under these Terms and Conditions.
+
+### The Software
+
+The "Software" is each version of the software that we make available under
+these Terms and Conditions, as indicated by our inclusion of these Terms and
+Conditions with the Software.
+
+### License Grant
+
+Subject to your compliance with this License Grant and the Patents,
+Redistribution and Trademark clauses below, we hereby grant you the right to
+use, copy, modify, create derivative works, publicly perform, publicly display
+and redistribute the Software for any Permitted Purpose identified below.
+
+### Permitted Purpose
+
+A Permitted Purpose is any purpose other than a Competing Use. A Competing Use
+means making the Software available to others in a commercial product or
+service that:
+
+1. substitutes for the Software;
+
+2. substitutes for any other product or service we offer using the Software
+   that exists as of the date we make the Software available; or
+
+3. offers the same or substantially similar functionality as the Software.
+
+Permitted Purposes specifically include using the Software:
+
+1. for your internal use and access;
+
+2. for non-commercial education;
+
+3. for non-commercial research; and
+
+4. in connection with professional services that you provide to a licensee
+   using the Software in accordance with these Terms and Conditions.
+
+### Patents
+
+To the extent your use for a Permitted Purpose would necessarily infringe our
+patents, the license grant above includes a license under our patents. If you
+make a claim against any party that the Software infringes or contributes to
+the infringement of any patent, then your patent license to the Software ends
+immediately.
+
+### Redistribution
+
+The Terms and Conditions apply to all copies, modifications and derivatives of
+the Software.
+
+If you redistribute any copies, modifications or derivatives of the Software,
+you must include a copy of or a link to these Terms and Conditions and not
+remove any copyright notices provided in or with the Software.
+
+### Disclaimer
+
+THE SOFTWARE IS PROVIDED "AS IS" AND WITHOUT WARRANTIES OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING WITHOUT LIMITATION WARRANTIES OF FITNESS FOR A PARTICULAR
+PURPOSE, MERCHANTABILITY, TITLE OR NON-INFRINGEMENT.
+
+IN NO EVENT WILL WE HAVE ANY LIABILITY TO YOU ARISING OUT OF OR RELATED TO THE
+SOFTWARE, INCLUDING INDIRECT, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES,
+EVEN IF WE HAVE BEEN INFORMED OF THEIR POSSIBILITY IN ADVANCE.
+
+### Trademarks
+
+Except for displaying the License Details and identifying us as the origin of
+the Software, you have no right under these Terms and Conditions to use our
+trademarks, trade names, service marks or product names.
+
+## Grant of Future License
+
+We hereby irrevocably grant you an additional license to use the Software under
+the MIT license that is effective on the second anniversary of the date we make
+the Software available. On or after that date, you may use the Software under
+the MIT license, in which case the following will apply:
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
+of the Software, and to permit persons to whom the Software is furnished to do
+so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---
+
+MIT License
+
+Copyright (c) 2025-03-21 - 2025-05-30 Kujtim Hoxha
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.