@hraness/design-kit 0.35.0 → 0.35.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENT_SETUP.md +4 -0
- package/ARTICLE_COPY.md +19 -7
- package/README.md +8 -2
- package/dist/{chunk-c9mhn3yb.js → chunk-4tgt8egt.js} +18 -13
- package/dist/{chunk-fjf81bww.js → chunk-6ts4955n.js} +8 -34
- package/dist/{chunk-c80g58j1.js → chunk-fmeg5cxf.js} +14 -6
- package/dist/{chunk-8xfssb9c.js → chunk-tzd7177a.js} +138 -81
- package/dist/index.js +1 -1
- package/dist/react/index.js +38 -96
- package/dist/react/platform-install.js +2 -2
- package/dist/react/server.js +2 -2
- package/dist/stylex-manifest.json +1 -1
- package/dist/stylex.css +28 -28
- package/package.json +3 -1
- package/portfolio-inventory.json +1 -1
- package/src/article-html.ts +41 -19
- package/src/react/agent-setup-prompt.stylex.ts +5 -25
- package/src/react/agent-setup-prompt.tsx +9 -18
- package/src/react/article.tsx +32 -14
- package/src/react/design-gallery.tsx +3 -0
- package/src/react/platform-install.stylex.ts +7 -36
- package/src/react/platform-install.tsx +15 -23
- package/src/react/setup-copy-button.stylex.ts +39 -0
- package/src/react/setup-copy-button.tsx +20 -0
package/AGENT_SETUP.md
CHANGED
|
@@ -13,6 +13,7 @@ import { AgentCommandTabs, AgentSetupPrompt } from "@hraness/design-kit/react";
|
|
|
13
13
|
label="Set up Relay with your agent"
|
|
14
14
|
prompt={setupPrompt}
|
|
15
15
|
targets={agentSetupTargets(setupPrompt)}
|
|
16
|
+
targetsPlacement="below"
|
|
16
17
|
/>
|
|
17
18
|
<AgentCommandTabs commands={[
|
|
18
19
|
{ id: "terminal", label: "Codex", mark: "codex", command: "relay init" },
|
|
@@ -24,6 +25,9 @@ The prompt preview clips long text with a bottom fade. Copy sits at the
|
|
|
24
25
|
bottom right and copies the complete source. A native disclosure reveals
|
|
25
26
|
the complete prompt without JavaScript. Provider actions move beside the
|
|
26
27
|
preview when the containing block is wide enough; narrower blocks stack.
|
|
28
|
+
Set `targetsPlacement="below"` to keep actions under the prompt in a compact
|
|
29
|
+
grid with up to three columns. Prompt, command-tab, and platform-install copy
|
|
30
|
+
buttons share the same 44-pixel minimum height and visual treatment.
|
|
27
31
|
The optional `onCopied` callback runs after a successful copy. Its errors
|
|
28
32
|
cannot change clipboard feedback.
|
|
29
33
|
|
package/ARTICLE_COPY.md
CHANGED
|
@@ -17,10 +17,16 @@ Limits are maximums. Count characters in the rendered text.
|
|
|
17
17
|
| `provenance` | The drafting kind and the review on record. | | Omitting it on an AI-drafted post. |
|
|
18
18
|
| `toc` | One entry per `h2`, only when the article has four or more. | Eight entries | Entries for `h3` headings. |
|
|
19
19
|
| Body headings | Sentence case, each naming what the section shows. | 70 characters | Signpost headings such as "Overview", "Conclusion", or "Key takeaways". |
|
|
20
|
-
| `ArticleSources` | Primary sources a reader can open,
|
|
20
|
+
| `ArticleSources` | Primary sources a reader can open, retaining the date someone last checked the cited claim in each record. | | Secondary summaries when the primary source is public. |
|
|
21
21
|
| `ArticleRelatedProducts` | Siblings from the registered relations for this article, each shown with its mark, name, and one-line description. | Three items | Every product in the portfolio. |
|
|
22
22
|
| `ArticleCallout` | A limit or warning the reader must see before acting. | One short paragraph | Decorative asides and restated body text. |
|
|
23
23
|
|
|
24
|
+
### Date presentation
|
|
25
|
+
|
|
26
|
+
For evergreen explanations, pass `showDates: false` to `MarketingArticle`, `ArticleIndex`, and `ArticleSources`, or their static equivalents `renderArticleHtml`, `renderArticleIndexHtml`, and `renderArticleSourcesHtml`. Each composition controls its own date presentation. Dates remain visible by default for release notes and other chronological writing.
|
|
27
|
+
|
|
28
|
+
This option hides publication, update, or source-check dates from the rendered text. It keeps authors, review credits, source links, and publishers visible, and removes rows that would otherwise be empty. The `published`, `updated`, and `checkedOn` fields retain their existing types and validation. Keep their true values in article records and use them for feeds and structured metadata; hiding a date never changes it.
|
|
29
|
+
|
|
24
30
|
## Post shapes
|
|
25
31
|
|
|
26
32
|
### Introducing a product
|
|
@@ -118,13 +124,18 @@ Title: "How <consumer> uses <provider>". It lives on the consumer's host.
|
|
|
118
124
|
|
|
119
125
|
A provider may keep one page, such as "Built on <provider>", that lists the products using it. Each entry is the registered relation's own sentence and a link to the consumer's "How <consumer> uses <provider>" post when one exists. The hub is an index. It does not restate each post.
|
|
120
126
|
|
|
121
|
-
### Technique posts
|
|
127
|
+
### Technique posts
|
|
122
128
|
|
|
123
129
|
A technique post teaches one method, such as property tests, model checking, or proofs. It lives on hraness.com, and a product host may carry a product-specific version that shows the technique inside that product.
|
|
124
130
|
|
|
125
|
-
-
|
|
126
|
-
-
|
|
127
|
-
-
|
|
131
|
+
- Answer one useful question. Explain the reasoning with a concrete example the reader can follow, using code or notation where it helps.
|
|
132
|
+
- Use public references when they clarify the method or support a claim. A product example belongs only when it helps answer the question; neither Hraness code nor a product recommendation is required.
|
|
133
|
+
- Keep internal build diaries, verification logs, and implementation chronology out of the article. Teach the method in the order the reader needs it.
|
|
134
|
+
- End on the last supported fact. State a material limitation where it changes the reader’s decision; do not append a generic disclaimer.
|
|
135
|
+
|
|
136
|
+
### Illustrations
|
|
137
|
+
|
|
138
|
+
Follow the [shared illustration guidance](https://github.com/hraness/.github/blob/main/STYLE.md). Use SlopCamera to create an illustration when it helps explain the article, with a limited brand palette and a reference that establishes the intended visual style. Record the tools, model, references, and actual asset source used; do not substitute a generic provenance claim. Keep captions useful and optional.
|
|
128
139
|
|
|
129
140
|
## Titles and formulas
|
|
130
141
|
|
|
@@ -152,10 +163,10 @@ Some products can be pointed at other people's accounts or data: authenticated b
|
|
|
152
163
|
|
|
153
164
|
## Drafting and review note
|
|
154
165
|
|
|
155
|
-
Every article states who drafted it and who reviewed it, visibly, on every host.
|
|
166
|
+
Every article states who drafted it and who reviewed it, visibly, on every host. This applies to articles only; other pages follow `STYLE.md`.
|
|
156
167
|
|
|
157
168
|
- Render `ArticleProvenance`, or the `provenance` prop of `MarketingArticle`, from the admission record with `articleProvenanceFromAdmission()`. Do not type the sentence by hand.
|
|
158
|
-
-
|
|
169
|
+
- The default AI drafting kind is `ai`: "Drafted with AI and reviewed by <reviewer>." Use `ai-from-source` and its "from the source code" wording only when the article was drafted from source code.
|
|
159
170
|
- Name the reviewer as it is. An AI reviewer has `reviewerType: "ai"` and a name that says it is AI, for example "Claude Opus 5.5 (claude-opus-5-5) editorial review". The sentence says "human" only when `reviewerType` is `human-editor`.
|
|
160
171
|
- Keep `humanReview` null unless a person reviewed the article. Never describe AI review as human review.
|
|
161
172
|
- The byline is "Hraness" on every host. Do not credit a person, including the owner, for an AI-drafted post. A person who later adopts a post may switch the byline to their own name; the drafting and review note stays.
|
|
@@ -172,6 +183,7 @@ Every article URL has an `ArticleAdmission` record in its host's registry, check
|
|
|
172
183
|
|
|
173
184
|
## Freshness
|
|
174
185
|
|
|
186
|
+
- Keep review, publication, and update metadata truthful. Educational bodies do not need repeated "as of" dates, build identifiers, or freshness labels; include a date or version in the prose only when the explanation depends on it.
|
|
175
187
|
- Every record has `reassessOn`, 28 to 56 days after `review.reviewedOn`. `articleAdmissionsDue(registry, today)` lists the records to look at again.
|
|
176
188
|
- Render versions, release dates, and status labels from release data (`package.json`, a published release file, or the portfolio facts). Never type a version into an article body.
|
|
177
189
|
- Each record names its refresh triggers: a release tag bump, a change to a relation's `detail`, a rename, or a change to the feature the post describes.
|
package/README.md
CHANGED
|
@@ -11,7 +11,7 @@ Pin a GitHub release tag:
|
|
|
11
11
|
```json
|
|
12
12
|
{
|
|
13
13
|
"dependencies": {
|
|
14
|
-
"@hraness/design-kit": "github:hraness/design-kit#v0.35.
|
|
14
|
+
"@hraness/design-kit": "github:hraness/design-kit#v0.35.2",
|
|
15
15
|
"@hraness/ui": "github:hraness/ui#v0.5.17"
|
|
16
16
|
}
|
|
17
17
|
}
|
|
@@ -23,6 +23,12 @@ Pin a GitHub release tag:
|
|
|
23
23
|
installation so the framework-neutral root and syntax highlighter can be used
|
|
24
24
|
on their own. React 18 or 19 and React DOM 18 or 19 are also peer dependencies.
|
|
25
25
|
|
|
26
|
+
### Compact agent setup and consistent copying
|
|
27
|
+
|
|
28
|
+
Version 0.35.2 lets evergreen articles, article indexes, and source lists hide visible dates with `showDates: false`. React and static renderers keep authors, review credits, and source publishers, remove empty date rows, and still require valid publication, update, and source-check metadata. Dates remain visible by default.
|
|
29
|
+
|
|
30
|
+
Version 0.35.1 adds `AgentSetupPrompt.targetsPlacement="below"` for a compact provider grid beneath the prompt. Prompt, agent-command, and platform-install copy actions share a 44-pixel control. Platform requirements appear in the terminal footer. Clipboard fallbacks, copy-before-open handoffs, keyboard controls, and no-script access remain available. The article guide also centers technique posts on the reader’s question, with accurate drafting notes and focused illustration guidance.
|
|
31
|
+
|
|
26
32
|
### Clearer marketing controls and agent setup
|
|
27
33
|
|
|
28
34
|
Version 0.35.0 aligns related tools with the studio's portfolio categories and compact product cards. It adds account sections and matching actions, a compact comparison table, shared SVG diagram conventions, open benefit grids, and an install-first hero slot. Walkthroughs use folder tabs and a stable stage with accessible chevron controls. Install commands use shell syntax colors and a quiet primary border; ordinary links use dotted underlines.
|
|
@@ -749,7 +755,7 @@ bun run browser:install
|
|
|
749
755
|
bun run check
|
|
750
756
|
```
|
|
751
757
|
|
|
752
|
-
The stable dependency pair for this release is `@hraness/ui` `v0.5.17` with `@hraness/design-kit` `v0.35.0`. Version 0.31.0 keeps the `limits` beat and beats marked `social: false` out of the social kit and adds `socialPost` for social wording that stands without a caveat. Version 0.30.3 refreshes the portfolio snapshot so related-product cards use each product's own spelling, such as GhostGet and TextButler. Version 0.30.2 keeps the narrow and stacked install-tab layout when another package compiles the same atoms into a later cascade layer. Version 0.30.1 keeps every PlatformInstall tab name whole in columns down to 200px by stacking each mark above its name, using a container query on the component. Version 0.30.0 adds `site-shell.css`, which keeps short-page footers at the viewport bottom. Version 0.29.3 preserves readable selected install tabs in forced colors. Version 0.29.2 keeps all three PlatformInstall tabs visible at 320 to 360px and draws each platform mark once per component. Version 0.29.1 keeps marketing action labels readable in forced colors. Version 0.29.0 adds `PlatformInstall`, one install block for every CLI site: a tab per operating system with its mark, the install command with a Copy button that announces the result, optional alternative commands such as npm or Homebrew, and a note for platforms without a native build. After hydration it selects the visitor's operating system; without JavaScript every command shows. It also adds `PlatformIcon` (Apple, Tux, and Windows marks in `currentColor`) and a `PlatformBadges` "Runs on" row, plus `platformLabel`, `platformMark`, `detectPlatform`, and `matchDetectedPlatform` at the package root. See [Install commands for each platform](#install-commands-for-each-platform). No existing export changes. Version 0.28.0 adds the launch kit. `@hraness/design-kit/mockups` draws labelled illustrations of chat, feeds, inboxes, articles, terminals, browsers, desktop windows, menu bars, and phones in server-safe plain React with no StyleX or React Aria, styled by `@hraness/design-kit/mockups.css`; each renders as one image with a text description and no headings. `@hraness/design-kit/mockups/client` adds `ModeShowcase`, `FitToWidth`, and `StepThrough`. `@hraness/design-kit/launch`, with no React, holds the `LaunchBeat`, `LaunchFacts`, and `SocialKit` shapes with `resolveLaunchBeats`, `buildSocialKit`, and `assertLaunchKit`. `@hraness/design-kit/testing` gives product repositories `blogConformance`, `renderMatrix`, `assertNoHeadings`, `assertRoleImgWithLabel`, and `assertFakeHandles`. The React entries add `ArticleFigure`, `ArticleVideo` with `articleVideoJsonLd`, `ArticleTable`, `ArticleBarChart`, `ComparisonTable`, `LaunchBeats`, and `SocialKitPanel`, and `MarketingProofFrame` takes `chrome` (`window`, `browser` with `url`, or `terminal`). [ARTICLE_COPY.md](ARTICLE_COPY.md) now writes "Introducing a product" as beats; the admission rules are unchanged. No existing export changes. Version 0.27.0 adds explicit Rust, TOML, YAML, Lean, and TLA+ code highlighting, including nested comments and multiline strings. The existing highlighter API and stylesheet remain the shared entry points; unsupported languages still render as escaped text. Version 0.26.0 adds `MarketingNotice` and the raw `.hraness-marketing-notice` class: one status or alert line (`info`, `success`, or `error`) that sits on the content edge of the page column instead of spanning the window. Errors are announced as alerts and other tones as status. Signed-in account pages that render inside `MarketingSiteHeader` should compose `MarketingMain`, `MarketingNotice`, `MarketingStatStrip`, and `MarketingSection` so every block shares the header's measure and gutter, rather than hand-rolled full-bleed banners and nested cards. Version 0.25.0 moves bordered foil surfaces off the spectrum: `.hraness-foil` and `[data-emphasis="primary"]` actions keep their flat surface fill under one theme-aware monochrome edge — black on light, white on dark, overridable through the new `--hraness-foil-edge` token — while the metallic spectrum stays on wordmarks and marks. The foil material contract advances to version 3: `surfaceImage` and `surfaceBackgroundClip` are replaced by `surfaceFill`, `edge`, `edgeDark`, and `edgeColor`. Reinstall any vendored marketing snapshot from the 0.25.0 commit. Version 0.24.0 joins a marketing footer directly followed by the shared `@hraness/site-footer` network footer into one band: the product row's bottom space collapses to a compact gap and the network row's content follows the marketing measure and gutter through `--hraness-site-footer-measure`, so product links and the organization row share one column instead of reading as two stacked bars. Mount the network footer directly after `MarketingSiteFooter`; no prop or markup change is needed inside either landmark. Version 0.23.0 moves marketing pages to the Quiet direction described in [DESIGN.md](DESIGN.md). `ProductHero` no longer renders a backdrop, `HeroBackdrop` renders nothing, and `attachHeroLight` is an inert disposer; their names and props stay so existing code compiles and are marked deprecated. The `cells`, `weave`, `contour`, and `mesh` patterns render as `none`, and marketing fields and Lantern walls paint the flat palette background. Both marketing presets use Nebula Sans for display headings (editorial at weight 550); Instrument Serif stays vendored for explicit opt-in only. Hero eyebrows are plain labels, the accent band loses its grid, and cards and header chrome use hairline edges instead of lifted shadows. On phones `MarketingSiteHeader` keeps the brand, primary action, and appearance menu on one row and moves the links to a second row that scrolls sideways, with 44px targets. To migrate, delete `backdrop` artwork, `HeroBackdrop`, `attachHeroLight`, pattern values, and product CSS that recreated textures or serif headings, then reinstall any vendored marketing snapshot from the 0.23.0 commit. Version 0.22.2 restores the canonical roughday mark — the rain-cloud artwork pinned by the portfolio registry — after the mark slot briefly carried a stray illustration. Version 0.22.1 completes the icon library with the roughday inline chip family (65 admitted assets, no pending members). Version 0.22.0 adds the `./icons` surface: 62 vetted single-ink assets across ten sets — a shared illustration family, product illustration families, and the product marks, each admitted through a measured gate (single ink, bounded aspect, coverage, stroke, paths, bytes) and per-set family coherence, distributed as a typed registry module (`hranessIcons`, `hranessIcon`, `hranessIconMarkup`, `hranessIconsForSet`) and as canonical `./icons/<set>/<slug>.svg` files for image consumers. See [ICONS.md](ICONS.md). Version 0.21.1 accepts status-page `routes` straight from a sitemap: long titles are shortened for the "Did you mean" line and unusable entries are dropped instead of failing the render. Version 0.21.0 replaces the 404 and route-error pages with one shared status page: the product's main action, a "Did you mean" link to the closest known page, at most three next links with one-line descriptions, an optional line for AI agents, and a glyph drawn as dots that gather, move away from the pointer, and settle. `RouteNotFoundPage`, `RouteErrorPage`, and `GlobalErrorDocument` render it; `renderStatusPageHtml` and `attachStatusPage` bring the same page to static sites; `status-page.css` ships in `styles.css` and `compiler-foundation.css`. The default copy changes to "We can’t find that page". See [STATUS_PAGES.md](STATUS_PAGES.md). Version 0.20.0 gives `ThemeMenuButton` the Lantern material: under `data-hraness-material="lantern"` its trigger is raised at rest and inset while pressed, and its menu uses the material plane, lift and warm selection, with no new props. Sites can delete their local Lantern CSS for the appearance menu. It also adds `formatRelativeTime` at the package root and a hydration-safe `RelativeTime` component in `@hraness/design-kit/react`. Version 0.19.0 redraws related-product cards as the hraness.com project cards: each shows the product's mark, its name, and its one-line `role` at reading size, and no longer renders the `relationship` sentence (the prop stays accepted and is deprecated). `MarketingRelatedProduct` and the static `ArticleRelatedLink` take a `mark`, and every `@hraness/design-kit/portfolio` product and `relatedFor()` item now carries its portfolio mark as an inert `data:image/svg+xml` URL. Related-tier and proof headings move to the new `--hraness-marketing-h3-size` token, so the editorial display face never renders below 1.75rem. `typography.css` gains per-level heading tokens (`--hraness-type-h1-font` through `--hraness-type-h4-font`, the matching `-weight` tokens, `--hraness-type-subheading-font`, and `--hraness-type-display-min`). h3 and h4 in `.hraness-prose` and publication articles now use the text face, and the h2 floor rises to 1.75rem. Version 0.18.3 adds the Sponge and Wordcell runtime relations to Oh to the `@hraness/design-kit/portfolio` snapshot, so related-product cards on all three sites can link them. Version 0.18.2 refreshes the `@hraness/design-kit/portfolio` snapshot from the registry: the public ghostget.com entry, updated Gobstopper and xcb naming and descriptions, and the current sibling-product relations for related-product cards. Version 0.18.1 adds the Perplexity mark and a dependency-free `@hraness/design-kit/provider-marks` leaf entry (`providerMark`, `providerMarks`, `providerMarkFallback`, `providerMarkGlyphDataUri`, `providerMarkArtDataUri`, `providerMarkOnAccent`, `providerMarkMonogram`) so packages such as `@hraness/ui` can consume the registry without pulling the marketing surface. Version 0.18.0 adds the shared provider-mark registry: `providerMarks`, `providerMark()` alias resolution, `ProviderMark`/`ProviderMarkChip` accent-tinted tile components on both React entry points, vendored agent and vendor artwork from LobeHub icons 1.95.1 plus documented Crush and Aider marks, monogram fallbacks for uncovered names, and data-URI helpers for CSS-mask consumers. See `vendor/provider-marks/UPSTREAM.md` for asset provenance. Version 0.17.2 carries the canonical portfolio messaging record per product (`names`, `category`, `tagline`, `short`, `meta`, `medium`, `long`, and hero copy) in the `/portfolio` snapshot. Version 0.17.1 lets Next.js apps that compile dependencies with Babel build the article layer: its link check no longer uses a Unicode property escape that Babel cannot rewrite, and it rejects the same control characters and whitespace as before. Version 0.17.0 adds the article layer: server-safe `MarketingArticle`, byline, provenance, sources, callout, related-product, and index components, a matching static HTML renderer for sites without React, long-form article styles in `plain-publication.css`, and the `ArticleAdmission` rubric with `assertArticleAdmissions()`. It also adds `@hraness/design-kit/portfolio`, a snapshot of public product names, one-liners, links, and relations for related-product cards and "How X uses Y" posts. See [ARTICLE_COPY.md](ARTICLE_COPY.md). Version 0.16.4 keeps native appearance-menu labels usable inside keyboard-focusable page landmarks, including mouse and touch selection. Version 0.16.3 keeps decorative hero backgrounds hidden in forced colors and reduced transparency when other packages load their styles afterward. Version 0.16.2 preserves palette hues in translucent headers, material surfaces, and decorative highlights. Version 0.16.1 keeps plain reading pages and nested compiled surfaces in their selected palette, including system appearance without JavaScript. Version 0.16.0 adds a shared bounded hero light, product-owned backdrop slots, five Lantern patterns, palette-derived soft surfaces, and responsive typography across marketing and reading layouts. Static sites can use the palette bridge for system appearance before JavaScript. See [HERO_FIELDS.md](HERO_FIELDS.md), [LANTERN_MATERIAL.md](LANTERN_MATERIAL.md), and [MARKETING_PRESET.md](MARKETING_PRESET.md). Version 0.15.0 lets `MarketingRelated` present labeled tiers of sibling products: a `groups` collection renders each tier under its own heading with an accessible card-row label, while the flat `items` shape stays available for a single group. Version 0.14.0 adds `MarketingRelated`, a collection section that presents sibling products as linked cards, each framed by its relationship to the featured product. Version 0.13.0 publishes `--hraness-sticky-offset` from sticky marketing chrome, gives `MarketingMain` and the next sticky sibling a clearance contract, stretches marketing card rows to the tallest item with a reserved two-line meta block, and clips per-card art wells so a logo surface cannot paint through the gutter. Version 0.12.0 replaces pointer-driven gradient rotation with a steady material and a moving light: the spectrum and its 115deg direction stay fixed while `--hraness-foil-x`/`--hraness-foil-y` highlights travel across each lockup, and marketing footers can opt into the same icon-plus-wordmark foil as the site header with `brandMark`. Version 0.11.1 preserves visible metallic marks when another package repeats a generic hidden atom in a later CSS layer. React consumers load `components.css` or `styles.css`; the raw marketing entry supports authored HTML hooks. Version 0.11 adds server-rendered `FoilMark` artwork and metallic text with subtle rainbow reflections, including a shared header mark seam and original-artwork fallbacks. Version 0.10.1 adds conservative server syntax defaults, includes their styles in the narrow marketing entry, and pins the icon dependency to preserve fresh Linux installs. Version 0.10 adds the shared foil contract: `.hraness-foil` surfaces and `.hraness-foil-text` wordmarks render a pointer-following metallic spectrum from the `--hraness-foil-*` custom properties, applied by default to marketing header brands and primary actions. The `attachFoil` browser export drives the bounded `x`/`y`/`angle` inputs with damped easing, reduced-motion and forced-color fallbacks, and no style injection; the same spectrum feeds `@hraness/site-footer` signup controls. Dark appearances use a deeper palette so the sheen stays visible. Version 0.8 removes Jelly's optional API, stylesheet, vendor runtime and theme-provider side effect. Migrate direct Jelly surfaces to native shared primitives before upgrading. Lantern now uses softer directional depth and shaded faces; the marketing preset adds individually shaded static cells, theme-aware terminal colors and window chrome. Code blocks retain source lines and follow the active palette. Paper preferences, semantic palettes, and compiler identity stay stable. Compiler adopters must regenerate their finalized stylesheet with the new package manifest.
|
|
758
|
+
The stable dependency pair for this release is `@hraness/ui` `v0.5.17` with `@hraness/design-kit` `v0.35.2`. Version 0.31.0 keeps the `limits` beat and beats marked `social: false` out of the social kit and adds `socialPost` for social wording that stands without a caveat. Version 0.30.3 refreshes the portfolio snapshot so related-product cards use each product's own spelling, such as GhostGet and TextButler. Version 0.30.2 keeps the narrow and stacked install-tab layout when another package compiles the same atoms into a later cascade layer. Version 0.30.1 keeps every PlatformInstall tab name whole in columns down to 200px by stacking each mark above its name, using a container query on the component. Version 0.30.0 adds `site-shell.css`, which keeps short-page footers at the viewport bottom. Version 0.29.3 preserves readable selected install tabs in forced colors. Version 0.29.2 keeps all three PlatformInstall tabs visible at 320 to 360px and draws each platform mark once per component. Version 0.29.1 keeps marketing action labels readable in forced colors. Version 0.29.0 adds `PlatformInstall`, one install block for every CLI site: a tab per operating system with its mark, the install command with a Copy button that announces the result, optional alternative commands such as npm or Homebrew, and a note for platforms without a native build. After hydration it selects the visitor's operating system; without JavaScript every command shows. It also adds `PlatformIcon` (Apple, Tux, and Windows marks in `currentColor`) and a `PlatformBadges` "Runs on" row, plus `platformLabel`, `platformMark`, `detectPlatform`, and `matchDetectedPlatform` at the package root. See [Install commands for each platform](#install-commands-for-each-platform). No existing export changes. Version 0.28.0 adds the launch kit. `@hraness/design-kit/mockups` draws labelled illustrations of chat, feeds, inboxes, articles, terminals, browsers, desktop windows, menu bars, and phones in server-safe plain React with no StyleX or React Aria, styled by `@hraness/design-kit/mockups.css`; each renders as one image with a text description and no headings. `@hraness/design-kit/mockups/client` adds `ModeShowcase`, `FitToWidth`, and `StepThrough`. `@hraness/design-kit/launch`, with no React, holds the `LaunchBeat`, `LaunchFacts`, and `SocialKit` shapes with `resolveLaunchBeats`, `buildSocialKit`, and `assertLaunchKit`. `@hraness/design-kit/testing` gives product repositories `blogConformance`, `renderMatrix`, `assertNoHeadings`, `assertRoleImgWithLabel`, and `assertFakeHandles`. The React entries add `ArticleFigure`, `ArticleVideo` with `articleVideoJsonLd`, `ArticleTable`, `ArticleBarChart`, `ComparisonTable`, `LaunchBeats`, and `SocialKitPanel`, and `MarketingProofFrame` takes `chrome` (`window`, `browser` with `url`, or `terminal`). [ARTICLE_COPY.md](ARTICLE_COPY.md) now writes "Introducing a product" as beats; the admission rules are unchanged. No existing export changes. Version 0.27.0 adds explicit Rust, TOML, YAML, Lean, and TLA+ code highlighting, including nested comments and multiline strings. The existing highlighter API and stylesheet remain the shared entry points; unsupported languages still render as escaped text. Version 0.26.0 adds `MarketingNotice` and the raw `.hraness-marketing-notice` class: one status or alert line (`info`, `success`, or `error`) that sits on the content edge of the page column instead of spanning the window. Errors are announced as alerts and other tones as status. Signed-in account pages that render inside `MarketingSiteHeader` should compose `MarketingMain`, `MarketingNotice`, `MarketingStatStrip`, and `MarketingSection` so every block shares the header's measure and gutter, rather than hand-rolled full-bleed banners and nested cards. Version 0.25.0 moves bordered foil surfaces off the spectrum: `.hraness-foil` and `[data-emphasis="primary"]` actions keep their flat surface fill under one theme-aware monochrome edge — black on light, white on dark, overridable through the new `--hraness-foil-edge` token — while the metallic spectrum stays on wordmarks and marks. The foil material contract advances to version 3: `surfaceImage` and `surfaceBackgroundClip` are replaced by `surfaceFill`, `edge`, `edgeDark`, and `edgeColor`. Reinstall any vendored marketing snapshot from the 0.25.0 commit. Version 0.24.0 joins a marketing footer directly followed by the shared `@hraness/site-footer` network footer into one band: the product row's bottom space collapses to a compact gap and the network row's content follows the marketing measure and gutter through `--hraness-site-footer-measure`, so product links and the organization row share one column instead of reading as two stacked bars. Mount the network footer directly after `MarketingSiteFooter`; no prop or markup change is needed inside either landmark. Version 0.23.0 moves marketing pages to the Quiet direction described in [DESIGN.md](DESIGN.md). `ProductHero` no longer renders a backdrop, `HeroBackdrop` renders nothing, and `attachHeroLight` is an inert disposer; their names and props stay so existing code compiles and are marked deprecated. The `cells`, `weave`, `contour`, and `mesh` patterns render as `none`, and marketing fields and Lantern walls paint the flat palette background. Both marketing presets use Nebula Sans for display headings (editorial at weight 550); Instrument Serif stays vendored for explicit opt-in only. Hero eyebrows are plain labels, the accent band loses its grid, and cards and header chrome use hairline edges instead of lifted shadows. On phones `MarketingSiteHeader` keeps the brand, primary action, and appearance menu on one row and moves the links to a second row that scrolls sideways, with 44px targets. To migrate, delete `backdrop` artwork, `HeroBackdrop`, `attachHeroLight`, pattern values, and product CSS that recreated textures or serif headings, then reinstall any vendored marketing snapshot from the 0.23.0 commit. Version 0.22.2 restores the canonical roughday mark — the rain-cloud artwork pinned by the portfolio registry — after the mark slot briefly carried a stray illustration. Version 0.22.1 completes the icon library with the roughday inline chip family (65 admitted assets, no pending members). Version 0.22.0 adds the `./icons` surface: 62 vetted single-ink assets across ten sets — a shared illustration family, product illustration families, and the product marks, each admitted through a measured gate (single ink, bounded aspect, coverage, stroke, paths, bytes) and per-set family coherence, distributed as a typed registry module (`hranessIcons`, `hranessIcon`, `hranessIconMarkup`, `hranessIconsForSet`) and as canonical `./icons/<set>/<slug>.svg` files for image consumers. See [ICONS.md](ICONS.md). Version 0.21.1 accepts status-page `routes` straight from a sitemap: long titles are shortened for the "Did you mean" line and unusable entries are dropped instead of failing the render. Version 0.21.0 replaces the 404 and route-error pages with one shared status page: the product's main action, a "Did you mean" link to the closest known page, at most three next links with one-line descriptions, an optional line for AI agents, and a glyph drawn as dots that gather, move away from the pointer, and settle. `RouteNotFoundPage`, `RouteErrorPage`, and `GlobalErrorDocument` render it; `renderStatusPageHtml` and `attachStatusPage` bring the same page to static sites; `status-page.css` ships in `styles.css` and `compiler-foundation.css`. The default copy changes to "We can’t find that page". See [STATUS_PAGES.md](STATUS_PAGES.md). Version 0.20.0 gives `ThemeMenuButton` the Lantern material: under `data-hraness-material="lantern"` its trigger is raised at rest and inset while pressed, and its menu uses the material plane, lift and warm selection, with no new props. Sites can delete their local Lantern CSS for the appearance menu. It also adds `formatRelativeTime` at the package root and a hydration-safe `RelativeTime` component in `@hraness/design-kit/react`. Version 0.19.0 redraws related-product cards as the hraness.com project cards: each shows the product's mark, its name, and its one-line `role` at reading size, and no longer renders the `relationship` sentence (the prop stays accepted and is deprecated). `MarketingRelatedProduct` and the static `ArticleRelatedLink` take a `mark`, and every `@hraness/design-kit/portfolio` product and `relatedFor()` item now carries its portfolio mark as an inert `data:image/svg+xml` URL. Related-tier and proof headings move to the new `--hraness-marketing-h3-size` token, so the editorial display face never renders below 1.75rem. `typography.css` gains per-level heading tokens (`--hraness-type-h1-font` through `--hraness-type-h4-font`, the matching `-weight` tokens, `--hraness-type-subheading-font`, and `--hraness-type-display-min`). h3 and h4 in `.hraness-prose` and publication articles now use the text face, and the h2 floor rises to 1.75rem. Version 0.18.3 adds the Sponge and Wordcell runtime relations to Oh to the `@hraness/design-kit/portfolio` snapshot, so related-product cards on all three sites can link them. Version 0.18.2 refreshes the `@hraness/design-kit/portfolio` snapshot from the registry: the public ghostget.com entry, updated Gobstopper and xcb naming and descriptions, and the current sibling-product relations for related-product cards. Version 0.18.1 adds the Perplexity mark and a dependency-free `@hraness/design-kit/provider-marks` leaf entry (`providerMark`, `providerMarks`, `providerMarkFallback`, `providerMarkGlyphDataUri`, `providerMarkArtDataUri`, `providerMarkOnAccent`, `providerMarkMonogram`) so packages such as `@hraness/ui` can consume the registry without pulling the marketing surface. Version 0.18.0 adds the shared provider-mark registry: `providerMarks`, `providerMark()` alias resolution, `ProviderMark`/`ProviderMarkChip` accent-tinted tile components on both React entry points, vendored agent and vendor artwork from LobeHub icons 1.95.1 plus documented Crush and Aider marks, monogram fallbacks for uncovered names, and data-URI helpers for CSS-mask consumers. See `vendor/provider-marks/UPSTREAM.md` for asset provenance. Version 0.17.2 carries the canonical portfolio messaging record per product (`names`, `category`, `tagline`, `short`, `meta`, `medium`, `long`, and hero copy) in the `/portfolio` snapshot. Version 0.17.1 lets Next.js apps that compile dependencies with Babel build the article layer: its link check no longer uses a Unicode property escape that Babel cannot rewrite, and it rejects the same control characters and whitespace as before. Version 0.17.0 adds the article layer: server-safe `MarketingArticle`, byline, provenance, sources, callout, related-product, and index components, a matching static HTML renderer for sites without React, long-form article styles in `plain-publication.css`, and the `ArticleAdmission` rubric with `assertArticleAdmissions()`. It also adds `@hraness/design-kit/portfolio`, a snapshot of public product names, one-liners, links, and relations for related-product cards and "How X uses Y" posts. See [ARTICLE_COPY.md](ARTICLE_COPY.md). Version 0.16.4 keeps native appearance-menu labels usable inside keyboard-focusable page landmarks, including mouse and touch selection. Version 0.16.3 keeps decorative hero backgrounds hidden in forced colors and reduced transparency when other packages load their styles afterward. Version 0.16.2 preserves palette hues in translucent headers, material surfaces, and decorative highlights. Version 0.16.1 keeps plain reading pages and nested compiled surfaces in their selected palette, including system appearance without JavaScript. Version 0.16.0 adds a shared bounded hero light, product-owned backdrop slots, five Lantern patterns, palette-derived soft surfaces, and responsive typography across marketing and reading layouts. Static sites can use the palette bridge for system appearance before JavaScript. See [HERO_FIELDS.md](HERO_FIELDS.md), [LANTERN_MATERIAL.md](LANTERN_MATERIAL.md), and [MARKETING_PRESET.md](MARKETING_PRESET.md). Version 0.15.0 lets `MarketingRelated` present labeled tiers of sibling products: a `groups` collection renders each tier under its own heading with an accessible card-row label, while the flat `items` shape stays available for a single group. Version 0.14.0 adds `MarketingRelated`, a collection section that presents sibling products as linked cards, each framed by its relationship to the featured product. Version 0.13.0 publishes `--hraness-sticky-offset` from sticky marketing chrome, gives `MarketingMain` and the next sticky sibling a clearance contract, stretches marketing card rows to the tallest item with a reserved two-line meta block, and clips per-card art wells so a logo surface cannot paint through the gutter. Version 0.12.0 replaces pointer-driven gradient rotation with a steady material and a moving light: the spectrum and its 115deg direction stay fixed while `--hraness-foil-x`/`--hraness-foil-y` highlights travel across each lockup, and marketing footers can opt into the same icon-plus-wordmark foil as the site header with `brandMark`. Version 0.11.1 preserves visible metallic marks when another package repeats a generic hidden atom in a later CSS layer. React consumers load `components.css` or `styles.css`; the raw marketing entry supports authored HTML hooks. Version 0.11 adds server-rendered `FoilMark` artwork and metallic text with subtle rainbow reflections, including a shared header mark seam and original-artwork fallbacks. Version 0.10.1 adds conservative server syntax defaults, includes their styles in the narrow marketing entry, and pins the icon dependency to preserve fresh Linux installs. Version 0.10 adds the shared foil contract: `.hraness-foil` surfaces and `.hraness-foil-text` wordmarks render a pointer-following metallic spectrum from the `--hraness-foil-*` custom properties, applied by default to marketing header brands and primary actions. The `attachFoil` browser export drives the bounded `x`/`y`/`angle` inputs with damped easing, reduced-motion and forced-color fallbacks, and no style injection; the same spectrum feeds `@hraness/site-footer` signup controls. Dark appearances use a deeper palette so the sheen stays visible. Version 0.8 removes Jelly's optional API, stylesheet, vendor runtime and theme-provider side effect. Migrate direct Jelly surfaces to native shared primitives before upgrading. Lantern now uses softer directional depth and shaded faces; the marketing preset adds individually shaded static cells, theme-aware terminal colors and window chrome. Code blocks retain source lines and follow the active palette. Paper preferences, semantic palettes, and compiler identity stay stable. Compiler adopters must regenerate their finalized stylesheet with the new package manifest.
|
|
753
759
|
|
|
754
760
|
The complete check runs linting, typechecking, production builds, an installed-package smoke test, deterministic examples, property tests, server rendering, vendor-integrity checks, and headless Chromium regressions. The browser gate verifies responsive shell ownership, extracted AnimatedRailStage, Fader, layout-surface, and playback-transport delivery, reduced-motion stage fallback, Fader keyboard and focus behavior, forced-color behavior, keyboard-operable appearance, browser-chrome synchronization across opposing device and saved preferences, global-error static metadata and runtime lifecycle, accessible title and copy, deterministic procedural layers, viewport containment, and the absence of the excluded canvas effect. Provision the pinned Chromium with `bun run browser:install`. An explicit `CHROMIUM_EXECUTABLE_PATH` must resolve to a provisioned Chrome for Testing; the browser gate rejects installed auto-updating Chrome.
|
|
755
761
|
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import {
|
|
2
2
|
SyntaxCode,
|
|
3
3
|
platformInstallClassName
|
|
4
|
-
} from "./chunk-
|
|
4
|
+
} from "./chunk-6ts4955n.js";
|
|
5
5
|
import {
|
|
6
6
|
diagramMetrics
|
|
7
7
|
} from "./chunk-gmea6p0d.js";
|
|
@@ -5318,6 +5318,7 @@ function MarketingArticle({
|
|
|
5318
5318
|
id,
|
|
5319
5319
|
provenance,
|
|
5320
5320
|
published,
|
|
5321
|
+
showDates = true,
|
|
5321
5322
|
toc,
|
|
5322
5323
|
tocLabel = ARTICLE_TOC_LABEL,
|
|
5323
5324
|
updated
|
|
@@ -5356,7 +5357,7 @@ function MarketingArticle({
|
|
|
5356
5357
|
className: "plain-publication__article-dek",
|
|
5357
5358
|
children: dek
|
|
5358
5359
|
}),
|
|
5359
|
-
/* @__PURE__ */ jsxs4("p", {
|
|
5360
|
+
author === undefined && !showDates ? null : /* @__PURE__ */ jsxs4("p", {
|
|
5360
5361
|
className: "plain-publication__article-meta",
|
|
5361
5362
|
children: [
|
|
5362
5363
|
author === undefined ? null : /* @__PURE__ */ jsxs4(Fragment3, {
|
|
@@ -5364,14 +5365,14 @@ function MarketingArticle({
|
|
|
5364
5365
|
/* @__PURE__ */ jsx4(ArticleByline, {
|
|
5365
5366
|
author
|
|
5366
5367
|
}),
|
|
5367
|
-
/* @__PURE__ */ jsx4(Separator, {})
|
|
5368
|
+
showDates ? /* @__PURE__ */ jsx4(Separator, {}) : null
|
|
5368
5369
|
]
|
|
5369
5370
|
}),
|
|
5370
|
-
/* @__PURE__ */ jsx4(ArticleDate, {
|
|
5371
|
+
showDates ? /* @__PURE__ */ jsx4(ArticleDate, {
|
|
5371
5372
|
label: "Published",
|
|
5372
5373
|
value: published
|
|
5373
|
-
}),
|
|
5374
|
-
updated === undefined ? null : /* @__PURE__ */ jsxs4(Fragment3, {
|
|
5374
|
+
}) : null,
|
|
5375
|
+
!showDates || updated === undefined ? null : /* @__PURE__ */ jsxs4(Fragment3, {
|
|
5375
5376
|
children: [
|
|
5376
5377
|
/* @__PURE__ */ jsx4(Separator, {}),
|
|
5377
5378
|
/* @__PURE__ */ jsx4(ArticleDate, {
|
|
@@ -5424,12 +5425,15 @@ function MarketingArticle({
|
|
|
5424
5425
|
function ArticleSources({
|
|
5425
5426
|
heading = ARTICLE_SOURCES_HEADING,
|
|
5426
5427
|
headingId = "article-sources",
|
|
5428
|
+
showDates = true,
|
|
5427
5429
|
sources
|
|
5428
5430
|
}) {
|
|
5429
5431
|
if (sources.length === 0)
|
|
5430
5432
|
return null;
|
|
5431
|
-
for (const source of sources)
|
|
5433
|
+
for (const source of sources) {
|
|
5432
5434
|
assertArticleHref(source.href);
|
|
5435
|
+
formatArticleDate(source.checkedOn);
|
|
5436
|
+
}
|
|
5433
5437
|
return /* @__PURE__ */ jsxs4("section", {
|
|
5434
5438
|
"aria-labelledby": headingId,
|
|
5435
5439
|
className: "plain-publication__sources",
|
|
@@ -5445,18 +5449,18 @@ function ArticleSources({
|
|
|
5445
5449
|
href: source.href,
|
|
5446
5450
|
children: source.title
|
|
5447
5451
|
}),
|
|
5448
|
-
/* @__PURE__ */ jsxs4("span", {
|
|
5452
|
+
!showDates && (source.publisher === undefined || source.publisher === "") ? null : /* @__PURE__ */ jsxs4("span", {
|
|
5449
5453
|
children: [
|
|
5450
5454
|
source.publisher === undefined || source.publisher === "" ? null : /* @__PURE__ */ jsxs4(Fragment3, {
|
|
5451
5455
|
children: [
|
|
5452
5456
|
source.publisher,
|
|
5453
|
-
/* @__PURE__ */ jsx4(Separator, {})
|
|
5457
|
+
showDates ? /* @__PURE__ */ jsx4(Separator, {}) : null
|
|
5454
5458
|
]
|
|
5455
5459
|
}),
|
|
5456
|
-
/* @__PURE__ */ jsx4(ArticleDate, {
|
|
5460
|
+
showDates ? /* @__PURE__ */ jsx4(ArticleDate, {
|
|
5457
5461
|
label: "Checked",
|
|
5458
5462
|
value: source.checkedOn
|
|
5459
|
-
})
|
|
5463
|
+
}) : null
|
|
5460
5464
|
]
|
|
5461
5465
|
})
|
|
5462
5466
|
]
|
|
@@ -5525,6 +5529,7 @@ function ArticleIndex({
|
|
|
5525
5529
|
headingLevel = 2,
|
|
5526
5530
|
id,
|
|
5527
5531
|
items,
|
|
5532
|
+
showDates = true,
|
|
5528
5533
|
summary
|
|
5529
5534
|
}) {
|
|
5530
5535
|
if (![1, 2, 3, 4, 5].includes(headingLevel))
|
|
@@ -5582,7 +5587,7 @@ function ArticleIndex({
|
|
|
5582
5587
|
className: "plain-publication__entry-dek",
|
|
5583
5588
|
children: item.dek
|
|
5584
5589
|
}),
|
|
5585
|
-
/* @__PURE__ */ jsxs4("p", {
|
|
5590
|
+
showDates ? /* @__PURE__ */ jsxs4("p", {
|
|
5586
5591
|
className: "plain-publication__entry-meta",
|
|
5587
5592
|
children: [
|
|
5588
5593
|
/* @__PURE__ */ jsx4(ArticleDate, {
|
|
@@ -5599,7 +5604,7 @@ function ArticleIndex({
|
|
|
5599
5604
|
]
|
|
5600
5605
|
})
|
|
5601
5606
|
]
|
|
5602
|
-
})
|
|
5607
|
+
}) : null
|
|
5603
5608
|
]
|
|
5604
5609
|
}, item.href))
|
|
5605
5610
|
})
|
|
@@ -214,38 +214,6 @@ var platformInstallStyles = {
|
|
|
214
214
|
kmVPX3: "x1717udv",
|
|
215
215
|
$$css: true
|
|
216
216
|
},
|
|
217
|
-
copy: {
|
|
218
|
-
kGNEyG: "x6s0dn4",
|
|
219
|
-
kysU6D: "xjyslct",
|
|
220
|
-
kWkggS: "xf7cb96 x3oli7v xnwy5bs",
|
|
221
|
-
kVAM5u: "x1ls9zlr x1ylmb6m",
|
|
222
|
-
kaIpWk: "x116uinm",
|
|
223
|
-
ksu8eU: "x1y0btm7",
|
|
224
|
-
kMzoRj: "xmkeg23",
|
|
225
|
-
kB7OPa: "x9f619",
|
|
226
|
-
kMwMTN: "x1p5laik x1ggml12",
|
|
227
|
-
kkrTdU: "x1ypdohk",
|
|
228
|
-
k1xSpc: "x3nfvp2 x1cfwndu",
|
|
229
|
-
kmuXW: "x2lah0s",
|
|
230
|
-
kMv6JI: "x1vnz01h",
|
|
231
|
-
kGuDYH: "x1dcheo9",
|
|
232
|
-
k63SB2: "xk50ysn",
|
|
233
|
-
kOIVth: "x73f2yu",
|
|
234
|
-
kLWn49: "xo5v014",
|
|
235
|
-
kogj98: "x1ghz6dp",
|
|
236
|
-
kAzted: "x1in32aq x1rewkhn",
|
|
237
|
-
kI3sdo: "x1a2a7pz x11dsm9b",
|
|
238
|
-
kInvED: "x1y3gkto",
|
|
239
|
-
k8WAf4: "x1267ecw",
|
|
240
|
-
kg3NbH: "x1f6otoe",
|
|
241
|
-
$$css: true
|
|
242
|
-
},
|
|
243
|
-
copyIcon: {
|
|
244
|
-
kZKoxP: "x1at03k5",
|
|
245
|
-
kmuXW: "x2lah0s",
|
|
246
|
-
kzqmXN: "x2tfi8i",
|
|
247
|
-
$$css: true
|
|
248
|
-
},
|
|
249
217
|
alternatives: {
|
|
250
218
|
k1xSpc: "xrvj5dj",
|
|
251
219
|
kOIVth: "x1uma3xh",
|
|
@@ -262,6 +230,14 @@ var platformInstallStyles = {
|
|
|
262
230
|
kogj98: "x1ghz6dp",
|
|
263
231
|
$$css: true
|
|
264
232
|
},
|
|
233
|
+
commandNote: {
|
|
234
|
+
kLZC3w: "x1h3am7x x19dwuzr",
|
|
235
|
+
kPef9Z: "x13fuv20",
|
|
236
|
+
kEafiO: "x178xt8z",
|
|
237
|
+
k8WAf4: "x8fiyw4",
|
|
238
|
+
kg3NbH: "x1fi0nvg",
|
|
239
|
+
$$css: true
|
|
240
|
+
},
|
|
265
241
|
unavailable: {
|
|
266
242
|
kVAM5u: "x1ls9zlr x1w1tqly",
|
|
267
243
|
kaIpWk: "x1yt6v20",
|
|
@@ -367,8 +343,6 @@ var hooks = {
|
|
|
367
343
|
code: "hraness-platform-install__code",
|
|
368
344
|
command: "hraness-platform-install__command",
|
|
369
345
|
commandBar: "hraness-platform-install__command-bar",
|
|
370
|
-
copy: "hraness-platform-install__copy",
|
|
371
|
-
copyIcon: "hraness-platform-install__copy-icon",
|
|
372
346
|
icon: "hraness-platform-icon",
|
|
373
347
|
markSymbols: "hraness-platform-install__marks",
|
|
374
348
|
note: "hraness-platform-install__note",
|
|
@@ -460,7 +460,8 @@ function renderArticleHtml(input) {
|
|
|
460
460
|
const headingId = input.headingId ?? "article-title";
|
|
461
461
|
const {
|
|
462
462
|
published,
|
|
463
|
-
updated
|
|
463
|
+
updated,
|
|
464
|
+
showDates = true
|
|
464
465
|
} = input;
|
|
465
466
|
assertArticleDates(updated === undefined ? {
|
|
466
467
|
published
|
|
@@ -474,21 +475,27 @@ function renderArticleHtml(input) {
|
|
|
474
475
|
throw new RangeError("Contents links must point to a heading in this article.");
|
|
475
476
|
}
|
|
476
477
|
const tocId = `${headingId}-contents`;
|
|
477
|
-
const meta = [input.author === undefined ? "" : renderArticleBylineHtml(input.author)
|
|
478
|
-
const header = ['<header class="plain-publication__article-header">', present(input.eyebrow) ? `<p class="plain-publication__eyebrow">${escapeArticleHtml(input.eyebrow)}</p>` : "", `<h1 id="${escapeArticleHtml(headingId)}">${escapeArticleHtml(input.heading)}</h1>`, present(input.dek) ? `<p class="plain-publication__article-dek">${escapeArticleHtml(input.dek)}</p>` : "", `<p class="plain-publication__article-meta">${meta}</p>`, input.provenance === null ? "" : renderArticleProvenanceHtml(input.provenance), "</header>"].join("");
|
|
478
|
+
const meta = [input.author === undefined ? "" : renderArticleBylineHtml(input.author), showDates ? dateHtml("Published", published) : "", showDates && updated !== undefined ? dateHtml("Updated", updated) : ""].filter(Boolean).join(SEPARATOR);
|
|
479
|
+
const header = ['<header class="plain-publication__article-header">', present(input.eyebrow) ? `<p class="plain-publication__eyebrow">${escapeArticleHtml(input.eyebrow)}</p>` : "", `<h1 id="${escapeArticleHtml(headingId)}">${escapeArticleHtml(input.heading)}</h1>`, present(input.dek) ? `<p class="plain-publication__article-dek">${escapeArticleHtml(input.dek)}</p>` : "", meta === "" ? "" : `<p class="plain-publication__article-meta">${meta}</p>`, input.provenance === null ? "" : renderArticleProvenanceHtml(input.provenance), "</header>"].join("");
|
|
479
480
|
const nav = toc.length === 0 ? "" : [`<nav aria-labelledby="${escapeArticleHtml(tocId)}" class="plain-publication__toc">`, `<p id="${escapeArticleHtml(tocId)}">${escapeArticleHtml(input.tocLabel ?? ARTICLE_TOC_LABEL)}</p>`, "<ol>", ...toc.map((item) => `<li><a href="${escapeArticleHtml(item.href)}">${escapeArticleHtml(item.label)}</a></li>`), "</ol></nav>"].join("");
|
|
480
481
|
return [`<article aria-labelledby="${escapeArticleHtml(headingId)}" class="${escapeArticleHtml(classes2(ROOT_CLASS, "plain-publication__article", input.className))}" data-hraness-article="" data-toc="${toc.length > 0 ? "aside" : "none"}"${input.id === undefined ? "" : ` id="${escapeArticleHtml(input.id)}"`}>`, header, '<div class="plain-publication__article-layout">', nav, `<div class="plain-publication__article-body">${input.bodyHtml}</div>`, "</div>", present(input.afterHtml) ? `<footer class="plain-publication__article-footer">${input.afterHtml}</footer>` : "", "</article>"].join("");
|
|
481
482
|
}
|
|
482
483
|
function renderArticleSourcesHtml({
|
|
483
484
|
heading = ARTICLE_SOURCES_HEADING,
|
|
484
485
|
headingId = "article-sources",
|
|
486
|
+
showDates = true,
|
|
485
487
|
sources
|
|
486
488
|
}) {
|
|
487
489
|
if (sources.length === 0)
|
|
488
490
|
return "";
|
|
489
|
-
for (const source of sources)
|
|
491
|
+
for (const source of sources) {
|
|
490
492
|
assertArticleHref(source.href);
|
|
491
|
-
|
|
493
|
+
formatArticleDate(source.checkedOn);
|
|
494
|
+
}
|
|
495
|
+
return [`<section aria-labelledby="${escapeArticleHtml(headingId)}" class="plain-publication__sources">`, `<h2 id="${escapeArticleHtml(headingId)}">${escapeArticleHtml(heading)}</h2>`, "<ol>", ...sources.map((source) => {
|
|
496
|
+
const meta = [present(source.publisher) ? escapeArticleHtml(source.publisher) : "", showDates ? dateHtml("Checked", source.checkedOn) : ""].filter(Boolean).join(SEPARATOR);
|
|
497
|
+
return [`<li><a href="${escapeArticleHtml(source.href)}">${escapeArticleHtml(source.title)}</a>`, meta === "" ? "" : `<span>${meta}</span>`, "</li>"].join("");
|
|
498
|
+
}), "</ol></section>"].join("");
|
|
492
499
|
}
|
|
493
500
|
function renderArticleCalloutHtml(input) {
|
|
494
501
|
const tone = input.tone ?? "note";
|
|
@@ -521,6 +528,7 @@ function renderArticleIndexHtml({
|
|
|
521
528
|
headingLevel = 2,
|
|
522
529
|
id,
|
|
523
530
|
items,
|
|
531
|
+
showDates = true,
|
|
524
532
|
summary
|
|
525
533
|
}) {
|
|
526
534
|
if (![1, 2, 3, 4, 5].includes(headingLevel))
|
|
@@ -540,7 +548,7 @@ function renderArticleIndexHtml({
|
|
|
540
548
|
}
|
|
541
549
|
const heading1 = `h${headingLevel}`;
|
|
542
550
|
const entry = `h${headingLevel + 1}`;
|
|
543
|
-
return [`<section aria-labelledby="${escapeArticleHtml(headingId)}" class="${escapeArticleHtml(classes2(ROOT_CLASS, "plain-publication__list", className))}" data-hraness-article-index=""${id === undefined ? "" : ` id="${escapeArticleHtml(id)}"`}>`, `<div class="plain-publication__section-heading"><${heading1} id="${escapeArticleHtml(headingId)}">${escapeArticleHtml(heading)}</${heading1}>`, present(summary) ? `<p>${escapeArticleHtml(summary)}</p>` : "", "</div>", '<div class="plain-publication__article-list">', ...items.map((item) => ['<article class="plain-publication__entry">', present(item.eyebrow) ? `<p class="plain-publication__entry-label">${escapeArticleHtml(item.eyebrow)}</p>` : "", `<${entry} class="plain-publication__entry-title"><a href="${escapeArticleHtml(item.href)}">${escapeArticleHtml(item.title)}</a></${entry}>`, `<p class="plain-publication__entry-dek">${escapeArticleHtml(item.dek)}</p>`, '<p class="plain-publication__entry-meta">', dateHtml("Published", item.published), item.updated === undefined ? "" : SEPARATOR + dateHtml("Updated", item.updated), "</p
|
|
551
|
+
return [`<section aria-labelledby="${escapeArticleHtml(headingId)}" class="${escapeArticleHtml(classes2(ROOT_CLASS, "plain-publication__list", className))}" data-hraness-article-index=""${id === undefined ? "" : ` id="${escapeArticleHtml(id)}"`}>`, `<div class="plain-publication__section-heading"><${heading1} id="${escapeArticleHtml(headingId)}">${escapeArticleHtml(heading)}</${heading1}>`, present(summary) ? `<p>${escapeArticleHtml(summary)}</p>` : "", "</div>", '<div class="plain-publication__article-list">', ...items.map((item) => ['<article class="plain-publication__entry">', present(item.eyebrow) ? `<p class="plain-publication__entry-label">${escapeArticleHtml(item.eyebrow)}</p>` : "", `<${entry} class="plain-publication__entry-title"><a href="${escapeArticleHtml(item.href)}">${escapeArticleHtml(item.title)}</a></${entry}>`, `<p class="plain-publication__entry-dek">${escapeArticleHtml(item.dek)}</p>`, showDates ? ['<p class="plain-publication__entry-meta">', dateHtml("Published", item.published), item.updated === undefined ? "" : SEPARATOR + dateHtml("Updated", item.updated), "</p>"].join("") : "", "</article>"].join("")), "</div></section>"].join("");
|
|
544
552
|
}
|
|
545
553
|
// src/status-page.ts
|
|
546
554
|
var STATUS_PAGE_MAX_NEXT = 3;
|