@hraness/design-kit 0.31.1
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/ARTICLE_COPY.md +208 -0
- package/HERO_FIELDS.md +55 -0
- package/ICONS.md +56 -0
- package/LANTERN_MATERIAL.md +60 -0
- package/LICENSE +21 -0
- package/MARKETING_COPY.md +49 -0
- package/MARKETING_PRESET.md +108 -0
- package/PALETTES.md +90 -0
- package/PAPER_THEME.md +128 -0
- package/README.md +745 -0
- package/STATUS_PAGES.md +67 -0
- package/STYLE.md +245 -0
- package/WRITING.md +72 -0
- package/dist/browser/index.js +2345 -0
- package/dist/chunk-44djxk16.js +6872 -0
- package/dist/chunk-5gtx3pza.js +9 -0
- package/dist/chunk-77391vmq.js +454 -0
- package/dist/chunk-7b1586eb.js +1209 -0
- package/dist/chunk-8834fh4n.js +6 -0
- package/dist/chunk-9t8xyqte.js +870 -0
- package/dist/chunk-cejpzyfh.js +446 -0
- package/dist/chunk-eh71jz57.js +429 -0
- package/dist/chunk-evb02bc1.js +516 -0
- package/dist/chunk-h4k7yv6x.js +368 -0
- package/dist/chunk-he8eznb1.js +760 -0
- package/dist/chunk-mr1vdcjq.js +404 -0
- package/dist/chunk-wzvdn8ey.js +116 -0
- package/dist/fonts/nebula-sans/social-fonts.generated.js +53 -0
- package/dist/icons.js +48 -0
- package/dist/index.js +237 -0
- package/dist/launch.js +41 -0
- package/dist/mockups/client.js +422 -0
- package/dist/mockups/index.js +1850 -0
- package/dist/portfolio.js +1549 -0
- package/dist/provider-marks.js +19 -0
- package/dist/react/charts.js +11 -0
- package/dist/react/hero-backdrop.js +8 -0
- package/dist/react/index.js +7252 -0
- package/dist/react/platform-install.js +10 -0
- package/dist/react/server.js +137 -0
- package/dist/stylex-manifest.json +1 -0
- package/dist/stylex.css +5392 -0
- package/dist/syntax-highlighting.js +15 -0
- package/dist/testing.js +250 -0
- package/package.json +377 -0
- package/portfolio-inventory.json +31 -0
- package/scripts/check-lantern-material-snapshot.d.mts +26 -0
- package/scripts/check-lantern-material-snapshot.mjs +126 -0
- package/scripts/check-marketing-snapshot.d.mts +12 -0
- package/scripts/check-marketing-snapshot.mjs +58 -0
- package/scripts/lantern-material-snapshot.ts +101 -0
- package/scripts/marketing-textures.ts +48 -0
- package/scripts/paper-theme-snapshot.ts +97 -0
- package/scripts/product-marketing-snapshot.ts +149 -0
- package/src/appearance-menu.css +266 -0
- package/src/appearance.ts +32 -0
- package/src/article-html.ts +269 -0
- package/src/article.ts +686 -0
- package/src/browser/appearance-menu.ts +604 -0
- package/src/browser/artifact-share.ts +164 -0
- package/src/browser/design-palette.ts +197 -0
- package/src/browser/foil.ts +124 -0
- package/src/browser/hero-light.ts +11 -0
- package/src/browser/index.ts +29 -0
- package/src/browser/status-field.ts +432 -0
- package/src/browser/status-page.ts +100 -0
- package/src/browser/sticky-offset.ts +82 -0
- package/src/browser/theme-color-sync.ts +213 -0
- package/src/charts.css +7 -0
- package/src/compiler-components.css +34 -0
- package/src/compiler-foundation.css +18 -0
- package/src/compiler-palettes.css +7 -0
- package/src/compiler-tokens.css +342 -0
- package/src/components.css +3 -0
- package/src/design-gallery.css +431 -0
- package/src/effects.css +14 -0
- package/src/fonts/geist-mono/GeistMono[wght].woff2 +0 -0
- package/src/fonts/geist-mono/OFL.txt +93 -0
- package/src/fonts/geist-mono/PROVENANCE.md +12 -0
- package/src/fonts/instrument-serif/OFL.txt +93 -0
- package/src/fonts/instrument-serif/UPSTREAM.md +14 -0
- package/src/fonts/instrument-serif/instrument-serif-latin-400.woff2 +0 -0
- package/src/fonts/nebula-sans/LICENSE.txt +96 -0
- package/src/fonts/nebula-sans/NebulaSans-Black.woff2 +0 -0
- package/src/fonts/nebula-sans/NebulaSans-BlackItalic.woff2 +0 -0
- package/src/fonts/nebula-sans/NebulaSans-Bold.otf +0 -0
- package/src/fonts/nebula-sans/NebulaSans-Bold.woff2 +0 -0
- package/src/fonts/nebula-sans/NebulaSans-BoldItalic.woff2 +0 -0
- package/src/fonts/nebula-sans/NebulaSans-Book.otf +0 -0
- package/src/fonts/nebula-sans/NebulaSans-Book.woff2 +0 -0
- package/src/fonts/nebula-sans/NebulaSans-BookItalic.woff2 +0 -0
- package/src/fonts/nebula-sans/NebulaSans-Light.woff2 +0 -0
- package/src/fonts/nebula-sans/NebulaSans-LightItalic.woff2 +0 -0
- package/src/fonts/nebula-sans/NebulaSans-Medium.woff2 +0 -0
- package/src/fonts/nebula-sans/NebulaSans-MediumItalic.woff2 +0 -0
- package/src/fonts/nebula-sans/NebulaSans-Semibold.woff2 +0 -0
- package/src/fonts/nebula-sans/NebulaSans-SemiboldItalic.woff2 +0 -0
- package/src/fonts/nebula-sans/PROVENANCE.md +14 -0
- package/src/fonts/nebula-sans/social-fonts.generated.ts +3873 -0
- package/src/fonts.css +106 -0
- package/src/icons/act60/act60.svg +5 -0
- package/src/icons/act60/application.svg +9 -0
- package/src/icons/act60/chapter-compare.svg +3 -0
- package/src/icons/act60/decree-residence.svg +6 -0
- package/src/icons/act60/estimate.svg +7 -0
- package/src/icons/act60/export-services.svg +4 -0
- package/src/icons/act60/investor.svg +13 -0
- package/src/icons/act60/presence.svg +7 -0
- package/src/icons/aicharts/aicharts.svg +6 -0
- package/src/icons/aicharts/cost-compare.svg +4 -0
- package/src/icons/aicharts/task-audio.svg +7 -0
- package/src/icons/aicharts/task-coding.svg +6 -0
- package/src/icons/aicharts/task-images.svg +3 -0
- package/src/icons/aicharts/task-reasoning.svg +9 -0
- package/src/icons/aicharts/task-research.svg +5 -0
- package/src/icons/aicharts/task-video.svg +4 -0
- package/src/icons/manifest.json +1371 -0
- package/src/icons/platonik/conversation.svg +3 -0
- package/src/icons/platonik/creature.svg +7 -0
- package/src/icons/platonik/economy.svg +4 -0
- package/src/icons/platonik/keep-light.svg +6 -0
- package/src/icons/platonik/platonik.svg +7 -0
- package/src/icons/platonik/spark-route.svg +15 -0
- package/src/icons/receipts/act60-retry.receipt.json +888 -0
- package/src/icons/receipts/act60.receipt.json +1366 -0
- package/src/icons/receipts/aicharts.receipt.json +1546 -0
- package/src/icons/receipts/platonik.receipt.json +1011 -0
- package/src/icons/receipts/roughday.receipt.json +770 -0
- package/src/icons/receipts/shared.receipt.json +1296 -0
- package/src/icons/receipts/slopcamera.receipt.json +1495 -0
- package/src/icons/receipts/soundfish-retry.receipt.json +460 -0
- package/src/icons/receipts/soundfish.receipt.json +1709 -0
- package/src/icons/receipts/sponge.receipt.json +1743 -0
- package/src/icons/receipts/stripe-history-retry.receipt.json +145 -0
- package/src/icons/receipts/stripe-history.receipt.json +1202 -0
- package/src/icons/receipts/wordcell.receipt.json +1924 -0
- package/src/icons/roughday/finance.svg +7 -0
- package/src/icons/roughday/roughday.svg +6 -0
- package/src/icons/roughday/technology.svg +4 -0
- package/src/icons/roughday/world.svg +4 -0
- package/src/icons/sets/act60.json +63 -0
- package/src/icons/sets/aicharts.json +63 -0
- package/src/icons/sets/platonik.json +39 -0
- package/src/icons/sets/roughday.json +25 -0
- package/src/icons/sets/shared.json +12 -0
- package/src/icons/sets/slopcamera.json +47 -0
- package/src/icons/sets/soundfish.json +43 -0
- package/src/icons/sets/sponge.json +51 -0
- package/src/icons/sets/stripe-history.json +39 -0
- package/src/icons/sets/wordcell.json +51 -0
- package/src/icons/shared/agent-skill.svg +4 -0
- package/src/icons/shared/cli.svg +5 -0
- package/src/icons/shared/privacy.svg +3 -0
- package/src/icons/shared/research.svg +7 -0
- package/src/icons/shared/sdk.svg +3 -0
- package/src/icons/slopcamera/diagram.svg +3 -0
- package/src/icons/slopcamera/direct-scene.svg +5 -0
- package/src/icons/slopcamera/edit-video.svg +17 -0
- package/src/icons/slopcamera/mcp.svg +3 -0
- package/src/icons/slopcamera/native-world.svg +3 -0
- package/src/icons/slopcamera/slopcamera.svg +11 -0
- package/src/icons/soundfish/agent-ui.svg +7 -0
- package/src/icons/soundfish/collaborate.svg +5 -0
- package/src/icons/soundfish/compose.svg +3 -0
- package/src/icons/soundfish/hear.svg +6 -0
- package/src/icons/soundfish/human-ui.svg +6 -0
- package/src/icons/soundfish/share.svg +3 -0
- package/src/icons/soundfish/soundfish.svg +6 -0
- package/src/icons/sponge/api.svg +3 -0
- package/src/icons/sponge/documents.svg +3 -0
- package/src/icons/sponge/library.svg +3 -0
- package/src/icons/sponge/one-question.svg +5 -0
- package/src/icons/sponge/people-direct.svg +5 -0
- package/src/icons/sponge/read.svg +3 -0
- package/src/icons/sponge/save.svg +4 -0
- package/src/icons/sponge/sponge.svg +7 -0
- package/src/icons/stripe-history/company-history.svg +3 -0
- package/src/icons/stripe-history/evidence.svg +4 -0
- package/src/icons/stripe-history/independence.svg +7 -0
- package/src/icons/stripe-history/publications.svg +11 -0
- package/src/icons/stripe-history/sources.svg +6 -0
- package/src/icons/stripe-history/stripe-history.svg +3 -0
- package/src/icons/wordcell/backlinks.svg +6 -0
- package/src/icons/wordcell/capture.svg +6 -0
- package/src/icons/wordcell/git-provenance.svg +4 -0
- package/src/icons/wordcell/kb.svg +4 -0
- package/src/icons/wordcell/markdown.svg +4 -0
- package/src/icons/wordcell/scopes.svg +3 -0
- package/src/icons/wordcell/search.svg +7 -0
- package/src/icons.generated.ts +734 -0
- package/src/icons.ts +51 -0
- package/src/index.ts +275 -0
- package/src/lantern-material.css +213 -0
- package/src/launch.ts +624 -0
- package/src/marketing-assets/UPSTREAM.md +18 -0
- package/src/marketing-assets/cells.svg +1 -0
- package/src/marketing-assets/grain.svg +1 -0
- package/src/marketing-forced-colors.css +12 -0
- package/src/mockups/client.tsx +415 -0
- package/src/mockups/core.tsx +318 -0
- package/src/mockups/frames.tsx +368 -0
- package/src/mockups/index.ts +14 -0
- package/src/mockups/surfaces.tsx +681 -0
- package/src/mockups.css +2607 -0
- package/src/palette-appearance.ts +45 -0
- package/src/palette-bridge.css +124 -0
- package/src/palette-color.ts +41 -0
- package/src/palette-system.css +721 -0
- package/src/palette-themes.ts +23 -0
- package/src/palette-tokens.stylex.ts +519 -0
- package/src/palettes.css +3 -0
- package/src/palettes.ts +161 -0
- package/src/paper-theme.css +244 -0
- package/src/plain-publication.css +1241 -0
- package/src/plain-site.css +397 -0
- package/src/platforms.ts +151 -0
- package/src/portfolio.generated.json +1595 -0
- package/src/portfolio.generated.ts +1596 -0
- package/src/portfolio.ts +226 -0
- package/src/product-marketing-foundation.css +433 -0
- package/src/product-marketing-preset.css +261 -0
- package/src/product-marketing.css +2186 -0
- package/src/provider-marks.generated.ts +112 -0
- package/src/provider-marks.ts +143 -0
- package/src/react/animated-rail-stage.stylex.ts +15 -0
- package/src/react/animated-rail-stage.tsx +51 -0
- package/src/react/app-shell.stylex.ts +104 -0
- package/src/react/app-shell.tsx +121 -0
- package/src/react/article.tsx +602 -0
- package/src/react/aurora-dots-background.tsx +34 -0
- package/src/react/charts.stylex.ts +563 -0
- package/src/react/charts.tsx +610 -0
- package/src/react/chat.stylex.ts +34 -0
- package/src/react/chat.tsx +155 -0
- package/src/react/design-gallery.tsx +943 -0
- package/src/react/design-palette.stylex.ts +124 -0
- package/src/react/design-palette.tsx +196 -0
- package/src/react/design-theme-context.tsx +41 -0
- package/src/react/effects.stylex.ts +325 -0
- package/src/react/fader.stylex.ts +71 -0
- package/src/react/fader.tsx +151 -0
- package/src/react/foil-card-math.ts +100 -0
- package/src/react/foil-card-surface.stylex.ts +326 -0
- package/src/react/foil-card-surface.tsx +742 -0
- package/src/react/foil-mark.tsx +35 -0
- package/src/react/foil.stylex.ts +163 -0
- package/src/react/haptics.ts +228 -0
- package/src/react/hero-backdrop.tsx +22 -0
- package/src/react/index.ts +38 -0
- package/src/react/keyboard-shortcuts.ts +228 -0
- package/src/react/lantern-material-gallery.tsx +166 -0
- package/src/react/lantern-material.stylex.ts +39 -0
- package/src/react/launch-beats.tsx +73 -0
- package/src/react/navigation-rail.stylex.ts +130 -0
- package/src/react/navigation-rail.tsx +228 -0
- package/src/react/particle-halo.tsx +115 -0
- package/src/react/phaser-dots.tsx +501 -0
- package/src/react/platform-icons.tsx +94 -0
- package/src/react/platform-install.stylex.ts +385 -0
- package/src/react/platform-install.tsx +389 -0
- package/src/react/playback-transport.stylex.ts +14 -0
- package/src/react/playback-transport.tsx +112 -0
- package/src/react/procedural-backdrop.tsx +192 -0
- package/src/react/procedural-recipe.ts +323 -0
- package/src/react/product-marketing.stylex.ts +4469 -0
- package/src/react/product-marketing.tsx +1611 -0
- package/src/react/production-data-preview-notice.stylex.ts +40 -0
- package/src/react/production-data-preview-notice.tsx +34 -0
- package/src/react/provider-mark.stylex.ts +132 -0
- package/src/react/provider-mark.tsx +120 -0
- package/src/react/relative-time.tsx +117 -0
- package/src/react/route-state.stylex.ts +39 -0
- package/src/react/route-state.tsx +350 -0
- package/src/react/server.ts +11 -0
- package/src/react/social-kit-panel.tsx +103 -0
- package/src/react/sticky-offset.tsx +33 -0
- package/src/react/surfaces.stylex.ts +179 -0
- package/src/react/surfaces.tsx +330 -0
- package/src/react/syntax-code.tsx +33 -0
- package/src/react/theme-color-sync.ts +1 -0
- package/src/react/theme-resolution.ts +11 -0
- package/src/react/theme.stylex.ts +276 -0
- package/src/react/theme.tsx +402 -0
- package/src/reading.css +72 -0
- package/src/relative-time.ts +185 -0
- package/src/reset.css +2 -0
- package/src/site-shell.css +16 -0
- package/src/status-page-html.ts +63 -0
- package/src/status-page.css +276 -0
- package/src/status-page.ts +323 -0
- package/src/styles.css +21 -0
- package/src/syntax-code-lexers.ts +303 -0
- package/src/syntax-highlighting.css +78 -0
- package/src/syntax-highlighting.ts +477 -0
- package/src/syntax-tokens.ts +33 -0
- package/src/testing.ts +307 -0
- package/src/tokens.css +3 -0
- package/src/typography.css +86 -0
- package/vendor/evilcharts/LICENSE +21 -0
- package/vendor/evilcharts/UPSTREAM.md +14 -0
- package/vendor/platform-marks/LICENSE +30 -0
- package/vendor/platform-marks/UPSTREAM.md +15 -0
- package/vendor/platform-marks/apple.svg +1 -0
- package/vendor/platform-marks/linux.svg +1 -0
- package/vendor/provider-marks/CRUSH-LICENSE.md +134 -0
- package/vendor/provider-marks/LICENSE +21 -0
- package/vendor/provider-marks/UPSTREAM.md +27 -0
- package/vendor/provider-marks/aider.svg +3 -0
- package/vendor/provider-marks/crush-heartbit.svg +8 -0
- package/vendor/provider-marks/lobehub/alibabacloud-color.svg +1 -0
- package/vendor/provider-marks/lobehub/alibabacloud.svg +1 -0
- package/vendor/provider-marks/lobehub/amp-color.svg +1 -0
- package/vendor/provider-marks/lobehub/amp.svg +1 -0
- package/vendor/provider-marks/lobehub/anthropic.svg +1 -0
- package/vendor/provider-marks/lobehub/claude-color.svg +1 -0
- package/vendor/provider-marks/lobehub/claude.svg +1 -0
- package/vendor/provider-marks/lobehub/claudecode-color.svg +1 -0
- package/vendor/provider-marks/lobehub/claudecode.svg +1 -0
- package/vendor/provider-marks/lobehub/codex-color.svg +1 -0
- package/vendor/provider-marks/lobehub/codex.svg +1 -0
- package/vendor/provider-marks/lobehub/cursor.svg +1 -0
- package/vendor/provider-marks/lobehub/deepseek-color.svg +1 -0
- package/vendor/provider-marks/lobehub/deepseek.svg +1 -0
- package/vendor/provider-marks/lobehub/devin-color.svg +1 -0
- package/vendor/provider-marks/lobehub/devin.svg +1 -0
- package/vendor/provider-marks/lobehub/gemini-color.svg +1 -0
- package/vendor/provider-marks/lobehub/gemini.svg +1 -0
- package/vendor/provider-marks/lobehub/geminicli-color.svg +1 -0
- package/vendor/provider-marks/lobehub/geminicli.svg +1 -0
- package/vendor/provider-marks/lobehub/goose.svg +1 -0
- package/vendor/provider-marks/lobehub/meta-color.svg +1 -0
- package/vendor/provider-marks/lobehub/meta.svg +1 -0
- package/vendor/provider-marks/lobehub/mistral-color.svg +1 -0
- package/vendor/provider-marks/lobehub/mistral.svg +1 -0
- package/vendor/provider-marks/lobehub/moonshot.svg +1 -0
- package/vendor/provider-marks/lobehub/nvidia-color.svg +1 -0
- package/vendor/provider-marks/lobehub/nvidia.svg +1 -0
- package/vendor/provider-marks/lobehub/openai.svg +1 -0
- package/vendor/provider-marks/lobehub/opencode.svg +1 -0
- package/vendor/provider-marks/lobehub/perplexity-color.svg +1 -0
- package/vendor/provider-marks/lobehub/perplexity.svg +1 -0
- package/vendor/provider-marks/lobehub/qwen-color.svg +1 -0
- package/vendor/provider-marks/lobehub/qwen.svg +1 -0
- package/vendor/provider-marks/lobehub/xai.svg +1 -0
- package/vendor/provider-marks/lobehub/zai.svg +1 -0
|
@@ -0,0 +1,266 @@
|
|
|
1
|
+
@layer components.hraness-design-kit.legacy {
|
|
2
|
+
/*
|
|
3
|
+
* Framework-neutral fallback for the standards-only browser controller.
|
|
4
|
+
* React ThemeToggle marks its root and owns the same presentation with StyleX,
|
|
5
|
+
* including its portalled popover. Lantern tokens exist only inside a
|
|
6
|
+
* data-hraness-material="lantern" island, so each chain falls through to the
|
|
7
|
+
* palette outside one.
|
|
8
|
+
*/
|
|
9
|
+
.hraness-design-theme-toggle[data-hraness-appearance-menu][data-presentation="menu"]:not([data-hraness-theme-toggle-stylex]) {
|
|
10
|
+
--hraness-appearance-control-background:
|
|
11
|
+
var(--hraness-material-plane, var(--ui-background, Canvas));
|
|
12
|
+
--hraness-appearance-control-foreground:
|
|
13
|
+
var(--hraness-material-ink, var(--ui-foreground, CanvasText));
|
|
14
|
+
--hraness-appearance-control-border:
|
|
15
|
+
var(--hraness-material-seam, var(--ui-input, GrayText));
|
|
16
|
+
--hraness-appearance-popover-background:
|
|
17
|
+
var(--hraness-material-plane, var(--ui-popover, Canvas));
|
|
18
|
+
--hraness-appearance-popover-foreground:
|
|
19
|
+
var(--hraness-material-ink, var(--ui-popover-foreground, CanvasText));
|
|
20
|
+
--hraness-appearance-accent:
|
|
21
|
+
var(--hraness-material-warm-plane, var(--ui-accent, ButtonFace));
|
|
22
|
+
--hraness-appearance-accent-foreground:
|
|
23
|
+
var(--hraness-material-ink, var(--ui-accent-foreground, ButtonText));
|
|
24
|
+
--hraness-appearance-focus:
|
|
25
|
+
var(--hraness-material-focus, var(--ui-ring, Highlight));
|
|
26
|
+
position: relative;
|
|
27
|
+
display: inline-flex;
|
|
28
|
+
min-inline-size: 0;
|
|
29
|
+
color: var(--hraness-appearance-control-foreground);
|
|
30
|
+
}
|
|
31
|
+
|
|
32
|
+
.hraness-design-theme-toggle[data-hraness-appearance-menu]:not([data-hraness-theme-toggle-stylex])[data-ready="false"] {
|
|
33
|
+
opacity: 0.64;
|
|
34
|
+
}
|
|
35
|
+
|
|
36
|
+
.hraness-design-theme-toggle[data-hraness-appearance-menu]:not([data-hraness-theme-toggle-stylex])
|
|
37
|
+
.hraness-design-theme-toggle__trigger {
|
|
38
|
+
display: inline-grid;
|
|
39
|
+
inline-size: 2rem;
|
|
40
|
+
min-inline-size: 2rem;
|
|
41
|
+
min-block-size: 2rem;
|
|
42
|
+
padding: 0;
|
|
43
|
+
border: 1px solid var(
|
|
44
|
+
--hraness-appearance-control-border,
|
|
45
|
+
var(--ui-input, GrayText)
|
|
46
|
+
);
|
|
47
|
+
border-radius: var(--radius-md, 0.5rem);
|
|
48
|
+
outline: none;
|
|
49
|
+
background: var(
|
|
50
|
+
--hraness-appearance-control-background,
|
|
51
|
+
var(--ui-background, Canvas)
|
|
52
|
+
);
|
|
53
|
+
color: var(
|
|
54
|
+
--hraness-appearance-control-foreground,
|
|
55
|
+
var(--ui-foreground, CanvasText)
|
|
56
|
+
);
|
|
57
|
+
box-shadow: var(--hraness-material-raised, none);
|
|
58
|
+
font: inherit;
|
|
59
|
+
place-items: center;
|
|
60
|
+
touch-action: manipulation;
|
|
61
|
+
transition:
|
|
62
|
+
background-color 120ms cubic-bezier(0.2, 0, 0, 1),
|
|
63
|
+
border-color 120ms cubic-bezier(0.2, 0, 0, 1),
|
|
64
|
+
box-shadow 120ms cubic-bezier(0.2, 0, 0, 1),
|
|
65
|
+
color 120ms cubic-bezier(0.2, 0, 0, 1),
|
|
66
|
+
transform 120ms cubic-bezier(0.2, 0, 0, 1);
|
|
67
|
+
}
|
|
68
|
+
|
|
69
|
+
.hraness-design-theme-toggle[data-hraness-appearance-menu]:not([data-hraness-theme-toggle-stylex])
|
|
70
|
+
.hraness-design-theme-toggle__trigger:not(:disabled) {
|
|
71
|
+
cursor: pointer;
|
|
72
|
+
}
|
|
73
|
+
|
|
74
|
+
.hraness-design-theme-toggle[data-hraness-appearance-menu]:not([data-hraness-theme-toggle-stylex])
|
|
75
|
+
.hraness-design-theme-toggle__trigger:where([data-hovered], :hover) {
|
|
76
|
+
background: var(--hraness-appearance-accent, var(--ui-accent, ButtonFace));
|
|
77
|
+
color: var(
|
|
78
|
+
--hraness-appearance-accent-foreground,
|
|
79
|
+
var(--ui-accent-foreground, ButtonText)
|
|
80
|
+
);
|
|
81
|
+
}
|
|
82
|
+
|
|
83
|
+
.hraness-design-theme-toggle[data-hraness-appearance-menu]:not([data-hraness-theme-toggle-stylex])
|
|
84
|
+
.hraness-design-theme-toggle__trigger:where([data-pressed], :active) {
|
|
85
|
+
box-shadow: var(--hraness-material-inset, none);
|
|
86
|
+
transform: translateY(1px);
|
|
87
|
+
}
|
|
88
|
+
|
|
89
|
+
.hraness-design-theme-toggle[data-hraness-appearance-menu]:not([data-hraness-theme-toggle-stylex])
|
|
90
|
+
.hraness-design-theme-toggle__trigger:where([data-focus-visible], :focus-visible) {
|
|
91
|
+
outline: 2px solid var(--hraness-appearance-focus, var(--ui-ring, Highlight));
|
|
92
|
+
outline-offset: 2px;
|
|
93
|
+
box-shadow: 0 0 0 4px color-mix(
|
|
94
|
+
in srgb,
|
|
95
|
+
var(--hraness-appearance-focus, var(--ui-ring, Highlight)) 24%,
|
|
96
|
+
transparent
|
|
97
|
+
);
|
|
98
|
+
}
|
|
99
|
+
|
|
100
|
+
.hraness-design-theme-toggle[data-hraness-appearance-menu]:not([data-hraness-theme-toggle-stylex])
|
|
101
|
+
.hraness-design-theme-toggle__trigger:disabled {
|
|
102
|
+
cursor: not-allowed;
|
|
103
|
+
opacity: 0.5;
|
|
104
|
+
}
|
|
105
|
+
|
|
106
|
+
.hraness-design-theme-toggle[data-hraness-appearance-menu]:not([data-hraness-theme-toggle-stylex])
|
|
107
|
+
.hraness-appearance-icon,
|
|
108
|
+
.hraness-design-theme-toggle[data-hraness-appearance-menu]:not([data-hraness-theme-toggle-stylex])
|
|
109
|
+
.hraness-icon,
|
|
110
|
+
.hraness-design-theme-toggle[data-hraness-appearance-menu]:not([data-hraness-theme-toggle-stylex])
|
|
111
|
+
.hraness-design-theme-toggle__item .hraness-appearance-icon,
|
|
112
|
+
.hraness-design-theme-toggle[data-hraness-appearance-menu]:not([data-hraness-theme-toggle-stylex])
|
|
113
|
+
.hraness-design-theme-toggle__item .hraness-icon {
|
|
114
|
+
display: inline-flex;
|
|
115
|
+
flex: 0 0 auto;
|
|
116
|
+
align-items: center;
|
|
117
|
+
justify-content: center;
|
|
118
|
+
}
|
|
119
|
+
|
|
120
|
+
.hraness-design-theme-toggle[data-hraness-appearance-menu]:not([data-hraness-theme-toggle-stylex])
|
|
121
|
+
.hraness-design-theme-toggle__popover {
|
|
122
|
+
z-index: var(--z-tooltip, 3000);
|
|
123
|
+
inline-size: min(12rem, calc(100vw - 2rem));
|
|
124
|
+
max-inline-size: calc(100vw - 2rem);
|
|
125
|
+
overflow: hidden;
|
|
126
|
+
border: 1px solid var(
|
|
127
|
+
--hraness-appearance-control-border,
|
|
128
|
+
var(--ui-input, GrayText)
|
|
129
|
+
);
|
|
130
|
+
border-radius: var(--radius-lg, 0.75rem);
|
|
131
|
+
outline: none;
|
|
132
|
+
background: var(
|
|
133
|
+
--hraness-appearance-popover-background,
|
|
134
|
+
var(--ui-popover, Canvas)
|
|
135
|
+
);
|
|
136
|
+
color: var(
|
|
137
|
+
--hraness-appearance-popover-foreground,
|
|
138
|
+
var(--ui-popover-foreground, CanvasText)
|
|
139
|
+
);
|
|
140
|
+
box-shadow: var(
|
|
141
|
+
--hraness-material-lift,
|
|
142
|
+
var(--elevation-overlay, 0 18px 48px -18px rgb(0 0 0 / 32%))
|
|
143
|
+
);
|
|
144
|
+
}
|
|
145
|
+
|
|
146
|
+
.hraness-design-theme-toggle[data-hraness-appearance-menu]:not([data-hraness-theme-toggle-stylex])
|
|
147
|
+
> .hraness-design-theme-toggle__popover {
|
|
148
|
+
position: absolute;
|
|
149
|
+
inset-block-start: calc(100% + 0.375rem);
|
|
150
|
+
inset-inline-end: 0;
|
|
151
|
+
}
|
|
152
|
+
|
|
153
|
+
.hraness-design-theme-toggle[data-hraness-appearance-menu]:not([data-hraness-theme-toggle-stylex])
|
|
154
|
+
.hraness-design-theme-toggle__popover[hidden] {
|
|
155
|
+
display: none;
|
|
156
|
+
}
|
|
157
|
+
|
|
158
|
+
.hraness-design-theme-toggle[data-hraness-appearance-menu]:not([data-hraness-theme-toggle-stylex])
|
|
159
|
+
.hraness-design-theme-toggle__menu {
|
|
160
|
+
display: grid;
|
|
161
|
+
max-block-size: min(24rem, 70vh);
|
|
162
|
+
padding: 0.25rem;
|
|
163
|
+
overflow: auto;
|
|
164
|
+
outline: none;
|
|
165
|
+
}
|
|
166
|
+
|
|
167
|
+
.hraness-design-theme-toggle[data-hraness-appearance-menu]:not([data-hraness-theme-toggle-stylex])
|
|
168
|
+
.hraness-design-theme-toggle__item {
|
|
169
|
+
display: grid;
|
|
170
|
+
min-block-size: 2.5rem;
|
|
171
|
+
grid-template-columns: auto minmax(0, 1fr);
|
|
172
|
+
align-items: center;
|
|
173
|
+
gap: 0.75rem;
|
|
174
|
+
padding: 0.5rem 0.75rem;
|
|
175
|
+
border-radius: var(--radius-md, 0.5rem);
|
|
176
|
+
outline: none;
|
|
177
|
+
color: var(
|
|
178
|
+
--hraness-appearance-popover-foreground,
|
|
179
|
+
var(--ui-popover-foreground, CanvasText)
|
|
180
|
+
);
|
|
181
|
+
cursor: default;
|
|
182
|
+
font-size: var(--text-label, 0.875rem);
|
|
183
|
+
line-height: 1.25;
|
|
184
|
+
user-select: none;
|
|
185
|
+
}
|
|
186
|
+
|
|
187
|
+
.hraness-design-theme-toggle[data-hraness-appearance-menu]:not([data-hraness-theme-toggle-stylex])
|
|
188
|
+
.hraness-design-theme-toggle__item:where(
|
|
189
|
+
[data-focused],
|
|
190
|
+
[data-hovered],
|
|
191
|
+
:focus-visible,
|
|
192
|
+
:hover
|
|
193
|
+
) {
|
|
194
|
+
background: var(--hraness-appearance-accent, var(--ui-accent, ButtonFace));
|
|
195
|
+
color: var(
|
|
196
|
+
--hraness-appearance-accent-foreground,
|
|
197
|
+
var(--ui-accent-foreground, ButtonText)
|
|
198
|
+
);
|
|
199
|
+
}
|
|
200
|
+
|
|
201
|
+
.hraness-design-theme-toggle[data-hraness-appearance-menu]:not([data-hraness-theme-toggle-stylex])
|
|
202
|
+
.hraness-design-theme-toggle__item[data-selected] {
|
|
203
|
+
font-weight: var(--font-weight-medium, 550);
|
|
204
|
+
}
|
|
205
|
+
|
|
206
|
+
.hraness-design-theme-toggle[data-hraness-appearance-menu]:not([data-hraness-theme-toggle-stylex])
|
|
207
|
+
.hraness-design-theme-toggle__item[data-selected]:not(:where(
|
|
208
|
+
[data-focused],
|
|
209
|
+
[data-hovered],
|
|
210
|
+
:focus-visible,
|
|
211
|
+
:hover
|
|
212
|
+
)) {
|
|
213
|
+
background: var(--hraness-material-warm-plane, transparent);
|
|
214
|
+
color: var(
|
|
215
|
+
--hraness-material-ink,
|
|
216
|
+
var(--hraness-appearance-popover-foreground, var(--ui-popover-foreground, CanvasText))
|
|
217
|
+
);
|
|
218
|
+
}
|
|
219
|
+
|
|
220
|
+
@media (pointer: coarse) {
|
|
221
|
+
.hraness-design-theme-toggle[data-hraness-appearance-menu][data-presentation="menu"]:not([data-hraness-theme-toggle-stylex])
|
|
222
|
+
.hraness-design-theme-toggle__trigger {
|
|
223
|
+
inline-size: 3rem;
|
|
224
|
+
min-inline-size: 3rem;
|
|
225
|
+
min-block-size: 3rem;
|
|
226
|
+
}
|
|
227
|
+
|
|
228
|
+
.hraness-design-theme-toggle[data-hraness-appearance-menu]:not([data-hraness-theme-toggle-stylex])
|
|
229
|
+
.hraness-design-theme-toggle__item {
|
|
230
|
+
min-block-size: 3rem;
|
|
231
|
+
}
|
|
232
|
+
}
|
|
233
|
+
|
|
234
|
+
@media (prefers-reduced-motion: reduce) {
|
|
235
|
+
.hraness-design-theme-toggle[data-hraness-appearance-menu]:not([data-hraness-theme-toggle-stylex])
|
|
236
|
+
.hraness-design-theme-toggle__trigger {
|
|
237
|
+
transition-duration: 0.01ms;
|
|
238
|
+
}
|
|
239
|
+
}
|
|
240
|
+
|
|
241
|
+
@media (forced-colors: active) {
|
|
242
|
+
.hraness-design-theme-toggle[data-hraness-appearance-menu]:not([data-hraness-theme-toggle-stylex])
|
|
243
|
+
.hraness-design-theme-toggle__trigger,
|
|
244
|
+
.hraness-design-theme-toggle[data-hraness-appearance-menu]:not([data-hraness-theme-toggle-stylex])
|
|
245
|
+
.hraness-design-theme-toggle__popover {
|
|
246
|
+
border-color: CanvasText;
|
|
247
|
+
box-shadow: none;
|
|
248
|
+
forced-color-adjust: auto;
|
|
249
|
+
}
|
|
250
|
+
|
|
251
|
+
.hraness-design-theme-toggle[data-hraness-appearance-menu]:not([data-hraness-theme-toggle-stylex])
|
|
252
|
+
.hraness-design-theme-toggle__trigger:where(
|
|
253
|
+
[data-focus-visible],
|
|
254
|
+
:focus-visible
|
|
255
|
+
) {
|
|
256
|
+
outline-color: Highlight;
|
|
257
|
+
box-shadow: none;
|
|
258
|
+
}
|
|
259
|
+
|
|
260
|
+
.hraness-design-theme-toggle[data-hraness-appearance-menu]:not([data-hraness-theme-toggle-stylex])
|
|
261
|
+
.hraness-design-theme-toggle__item[data-selected] {
|
|
262
|
+
background: Highlight;
|
|
263
|
+
color: HighlightText;
|
|
264
|
+
}
|
|
265
|
+
}
|
|
266
|
+
}
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
export const designThemes = ["light", "dark", "system"] as const;
|
|
2
|
+
|
|
3
|
+
export type DesignTheme = (typeof designThemes)[number];
|
|
4
|
+
export type ConcreteDesignTheme = Exclude<DesignTheme, "system">;
|
|
5
|
+
|
|
6
|
+
export const defaultDesignTheme: DesignTheme = "system";
|
|
7
|
+
export const designThemeStorageKey = "hraness-design-theme-v1";
|
|
8
|
+
|
|
9
|
+
export type DesignThemeLabels = Readonly<Partial<Record<DesignTheme, string>>>;
|
|
10
|
+
|
|
11
|
+
export function isDesignTheme(value: unknown): value is DesignTheme {
|
|
12
|
+
return typeof value === "string" && designThemes.some((theme) => theme === value);
|
|
13
|
+
}
|
|
14
|
+
|
|
15
|
+
/** Missing and invalid foreign values resolve to the shared first-visit preference. */
|
|
16
|
+
export function normalizeDesignTheme(value: unknown): DesignTheme {
|
|
17
|
+
return isDesignTheme(value) ? value : defaultDesignTheme;
|
|
18
|
+
}
|
|
19
|
+
|
|
20
|
+
export function designThemeLabel(
|
|
21
|
+
theme: DesignTheme,
|
|
22
|
+
labels?: DesignThemeLabels,
|
|
23
|
+
): string {
|
|
24
|
+
return labels?.[theme] ?? `${theme.charAt(0).toUpperCase()}${theme.slice(1)}`;
|
|
25
|
+
}
|
|
26
|
+
|
|
27
|
+
export function resolveDesignTheme(
|
|
28
|
+
theme: DesignTheme,
|
|
29
|
+
systemPrefersDark: boolean,
|
|
30
|
+
): ConcreteDesignTheme {
|
|
31
|
+
return theme === "system" ? (systemPrefersDark ? "dark" : "light") : theme;
|
|
32
|
+
}
|
|
@@ -0,0 +1,269 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Framework-neutral static HTML for the article layer. Static-site builders
|
|
3
|
+
* that do not run React call these functions and load plain-publication.css
|
|
4
|
+
* (or styles.css). The markup matches the React components in
|
|
5
|
+
* `@hraness/design-kit/react/server` element for element; tests bind the two.
|
|
6
|
+
*
|
|
7
|
+
* Text arguments are escaped. Fields named `*Html` take trusted HTML the site
|
|
8
|
+
* already rendered, such as the output of its Markdown pipeline. Never pass
|
|
9
|
+
* reader input through them.
|
|
10
|
+
*/
|
|
11
|
+
import {
|
|
12
|
+
ARTICLE_BYLINE_PREFIX,
|
|
13
|
+
ARTICLE_SOURCES_HEADING,
|
|
14
|
+
ARTICLE_TOC_LABEL,
|
|
15
|
+
articleProvenanceSentence,
|
|
16
|
+
assertArticleAuthor,
|
|
17
|
+
assertArticleCalloutTone,
|
|
18
|
+
assertArticleDates,
|
|
19
|
+
assertArticleHref,
|
|
20
|
+
formatArticleDate,
|
|
21
|
+
type ArticleAuthor,
|
|
22
|
+
type ArticleCalloutTone,
|
|
23
|
+
type ArticleIndexItem,
|
|
24
|
+
type ArticleIsoDate,
|
|
25
|
+
type ArticleProvenanceRecord,
|
|
26
|
+
type ArticleSourceItem,
|
|
27
|
+
type ArticleTocItem,
|
|
28
|
+
} from "./article.js";
|
|
29
|
+
|
|
30
|
+
const ROOT_CLASS = "plain-site plain-publication plain-publication--embedded";
|
|
31
|
+
const SEPARATOR = '<span aria-hidden="true"> · </span>';
|
|
32
|
+
|
|
33
|
+
const ESCAPES: Readonly<Record<string, string>> = {
|
|
34
|
+
'"': """,
|
|
35
|
+
"&": "&",
|
|
36
|
+
"'": "'",
|
|
37
|
+
"<": "<",
|
|
38
|
+
">": ">",
|
|
39
|
+
};
|
|
40
|
+
|
|
41
|
+
/** Escape text for an HTML text node or a double-quoted attribute. */
|
|
42
|
+
export function escapeArticleHtml(value: string): string {
|
|
43
|
+
return value.replace(/["&'<>]/gu, (character) => ESCAPES[character] ?? character);
|
|
44
|
+
}
|
|
45
|
+
|
|
46
|
+
function classes(...values: readonly (string | undefined)[]): string {
|
|
47
|
+
return values.filter((value) => value !== undefined && value !== "").join(" ");
|
|
48
|
+
}
|
|
49
|
+
|
|
50
|
+
function dateHtml(label: string, value: ArticleIsoDate): string {
|
|
51
|
+
return `${label} <time dateTime="${escapeArticleHtml(value)}">${escapeArticleHtml(formatArticleDate(value))}</time>`;
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
function present(value: string | undefined): value is string {
|
|
55
|
+
return value !== undefined && value !== "";
|
|
56
|
+
}
|
|
57
|
+
|
|
58
|
+
export function renderArticleBylineHtml(author: ArticleAuthor): string {
|
|
59
|
+
assertArticleAuthor(author);
|
|
60
|
+
const name = escapeArticleHtml(author.name);
|
|
61
|
+
const linked = author.href === undefined
|
|
62
|
+
? name
|
|
63
|
+
: `<a href="${escapeArticleHtml(author.href)}" rel="author">${name}</a>`;
|
|
64
|
+
return `<span class="plain-publication__byline" data-author-kind="${author.kind}">${ARTICLE_BYLINE_PREFIX} ${linked}</span>`;
|
|
65
|
+
}
|
|
66
|
+
|
|
67
|
+
export function renderArticleProvenanceHtml(provenance: ArticleProvenanceRecord): string {
|
|
68
|
+
const sentence = articleProvenanceSentence(provenance);
|
|
69
|
+
return `<p class="plain-publication__provenance" data-drafting="${escapeArticleHtml(provenance.drafting)}" data-reviewer-type="${escapeArticleHtml(provenance.review?.reviewerType ?? "none")}">${escapeArticleHtml(sentence)}</p>`;
|
|
70
|
+
}
|
|
71
|
+
|
|
72
|
+
export interface ArticleHtmlInput {
|
|
73
|
+
/** Trusted HTML placed after the body, such as sources and related links. */
|
|
74
|
+
readonly afterHtml?: string;
|
|
75
|
+
readonly author?: ArticleAuthor;
|
|
76
|
+
/** Trusted HTML for the article body. */
|
|
77
|
+
readonly bodyHtml: string;
|
|
78
|
+
readonly className?: string;
|
|
79
|
+
readonly dek?: string;
|
|
80
|
+
readonly eyebrow?: string;
|
|
81
|
+
readonly heading: string;
|
|
82
|
+
readonly headingId?: string;
|
|
83
|
+
readonly id?: string;
|
|
84
|
+
readonly provenance: ArticleProvenanceRecord | null;
|
|
85
|
+
readonly published: ArticleIsoDate;
|
|
86
|
+
readonly toc?: readonly ArticleTocItem[];
|
|
87
|
+
readonly tocLabel?: string;
|
|
88
|
+
readonly updated?: ArticleIsoDate;
|
|
89
|
+
}
|
|
90
|
+
|
|
91
|
+
/** The static equivalent of `MarketingArticle`. */
|
|
92
|
+
export function renderArticleHtml(input: ArticleHtmlInput): string {
|
|
93
|
+
const headingId = input.headingId ?? "article-title";
|
|
94
|
+
const { published, updated } = input;
|
|
95
|
+
assertArticleDates(updated === undefined ? { published } : { published, updated });
|
|
96
|
+
const toc = input.toc ?? [];
|
|
97
|
+
for (const item of toc) {
|
|
98
|
+
if (!item.href.startsWith("#") || item.href.length < 2) throw new RangeError("Contents links must point to a heading in this article.");
|
|
99
|
+
}
|
|
100
|
+
const tocId = `${headingId}-contents`;
|
|
101
|
+
const meta = [
|
|
102
|
+
input.author === undefined ? "" : renderArticleBylineHtml(input.author) + SEPARATOR,
|
|
103
|
+
dateHtml("Published", published),
|
|
104
|
+
updated === undefined ? "" : SEPARATOR + dateHtml("Updated", updated),
|
|
105
|
+
].join("");
|
|
106
|
+
const header = [
|
|
107
|
+
'<header class="plain-publication__article-header">',
|
|
108
|
+
present(input.eyebrow) ? `<p class="plain-publication__eyebrow">${escapeArticleHtml(input.eyebrow)}</p>` : "",
|
|
109
|
+
`<h1 id="${escapeArticleHtml(headingId)}">${escapeArticleHtml(input.heading)}</h1>`,
|
|
110
|
+
present(input.dek) ? `<p class="plain-publication__article-dek">${escapeArticleHtml(input.dek)}</p>` : "",
|
|
111
|
+
`<p class="plain-publication__article-meta">${meta}</p>`,
|
|
112
|
+
input.provenance === null ? "" : renderArticleProvenanceHtml(input.provenance),
|
|
113
|
+
"</header>",
|
|
114
|
+
].join("");
|
|
115
|
+
const nav = toc.length === 0 ? "" : [
|
|
116
|
+
`<nav aria-labelledby="${escapeArticleHtml(tocId)}" class="plain-publication__toc">`,
|
|
117
|
+
`<p id="${escapeArticleHtml(tocId)}">${escapeArticleHtml(input.tocLabel ?? ARTICLE_TOC_LABEL)}</p>`,
|
|
118
|
+
"<ol>",
|
|
119
|
+
...toc.map((item) => `<li><a href="${escapeArticleHtml(item.href)}">${escapeArticleHtml(item.label)}</a></li>`),
|
|
120
|
+
"</ol></nav>",
|
|
121
|
+
].join("");
|
|
122
|
+
return [
|
|
123
|
+
`<article aria-labelledby="${escapeArticleHtml(headingId)}" class="${escapeArticleHtml(classes(ROOT_CLASS, "plain-publication__article", input.className))}" data-hraness-article="" data-toc="${toc.length > 0 ? "aside" : "none"}"${input.id === undefined ? "" : ` id="${escapeArticleHtml(input.id)}"`}>`,
|
|
124
|
+
header,
|
|
125
|
+
'<div class="plain-publication__article-layout">',
|
|
126
|
+
nav,
|
|
127
|
+
`<div class="plain-publication__article-body">${input.bodyHtml}</div>`,
|
|
128
|
+
"</div>",
|
|
129
|
+
present(input.afterHtml) ? `<footer class="plain-publication__article-footer">${input.afterHtml}</footer>` : "",
|
|
130
|
+
"</article>",
|
|
131
|
+
].join("");
|
|
132
|
+
}
|
|
133
|
+
|
|
134
|
+
/** The static equivalent of `ArticleSources`. Returns an empty string for no sources. */
|
|
135
|
+
export function renderArticleSourcesHtml({
|
|
136
|
+
heading = ARTICLE_SOURCES_HEADING,
|
|
137
|
+
headingId = "article-sources",
|
|
138
|
+
sources,
|
|
139
|
+
}: Readonly<{ heading?: string; headingId?: string; sources: readonly ArticleSourceItem[] }>): string {
|
|
140
|
+
if (sources.length === 0) return "";
|
|
141
|
+
for (const source of sources) assertArticleHref(source.href);
|
|
142
|
+
return [
|
|
143
|
+
`<section aria-labelledby="${escapeArticleHtml(headingId)}" class="plain-publication__sources">`,
|
|
144
|
+
`<h2 id="${escapeArticleHtml(headingId)}">${escapeArticleHtml(heading)}</h2>`,
|
|
145
|
+
"<ol>",
|
|
146
|
+
...sources.map((source) => [
|
|
147
|
+
`<li><a href="${escapeArticleHtml(source.href)}">${escapeArticleHtml(source.title)}</a>`,
|
|
148
|
+
"<span>",
|
|
149
|
+
present(source.publisher) ? escapeArticleHtml(source.publisher) + SEPARATOR : "",
|
|
150
|
+
dateHtml("Checked", source.checkedOn),
|
|
151
|
+
"</span></li>",
|
|
152
|
+
].join("")),
|
|
153
|
+
"</ol></section>",
|
|
154
|
+
].join("");
|
|
155
|
+
}
|
|
156
|
+
|
|
157
|
+
/** The static equivalent of `ArticleCallout`. `bodyHtml` is trusted; pass `text` for escaped plain text. */
|
|
158
|
+
export function renderArticleCalloutHtml(input: Readonly<{
|
|
159
|
+
label?: string;
|
|
160
|
+
tone?: ArticleCalloutTone;
|
|
161
|
+
} & ({ bodyHtml: string; text?: undefined } | { bodyHtml?: undefined; text: string })>): string {
|
|
162
|
+
const tone = input.tone ?? "note";
|
|
163
|
+
assertArticleCalloutTone(tone);
|
|
164
|
+
const body = input.text === undefined ? input.bodyHtml : `<p>${escapeArticleHtml(input.text)}</p>`;
|
|
165
|
+
return `<div class="plain-publication__callout" data-tone="${tone}" role="note">${present(input.label) ? `<strong>${escapeArticleHtml(input.label)}</strong>` : ""}${body}</div>`;
|
|
166
|
+
}
|
|
167
|
+
|
|
168
|
+
export type ArticleRelatedLink = Readonly<{
|
|
169
|
+
href: string;
|
|
170
|
+
name: string;
|
|
171
|
+
/** Transparent product mark, such as a portfolio item's `mark` data URL, drawn before the name. */
|
|
172
|
+
mark?: string;
|
|
173
|
+
}> & (
|
|
174
|
+
| Readonly<{
|
|
175
|
+
/** The product's one-line description, shown under its name. */
|
|
176
|
+
role: string;
|
|
177
|
+
/** Not rendered when `role` is present. */
|
|
178
|
+
relationship?: string;
|
|
179
|
+
}>
|
|
180
|
+
| Readonly<{
|
|
181
|
+
role?: undefined;
|
|
182
|
+
/** Shown under the name for items that predate `role`. */
|
|
183
|
+
relationship: string;
|
|
184
|
+
}>
|
|
185
|
+
);
|
|
186
|
+
|
|
187
|
+
function assertArticleMark(mark: string): void {
|
|
188
|
+
if (!mark.startsWith("data:image/svg+xml,")) assertArticleHref(mark);
|
|
189
|
+
}
|
|
190
|
+
|
|
191
|
+
/**
|
|
192
|
+
* Related products for static pages, using the plain-publication related
|
|
193
|
+
* grid: each row shows the product's mark, name, and one-line description.
|
|
194
|
+
* React hosts use `ArticleRelatedProducts`, which renders the marketing card
|
|
195
|
+
* row instead.
|
|
196
|
+
*/
|
|
197
|
+
export function renderArticleRelatedHtml({
|
|
198
|
+
heading = "Related products",
|
|
199
|
+
headingId = "article-related-products",
|
|
200
|
+
items,
|
|
201
|
+
}: Readonly<{ heading?: string; headingId?: string; items: readonly ArticleRelatedLink[] }>): string {
|
|
202
|
+
if (items.length === 0) return "";
|
|
203
|
+
for (const item of items) {
|
|
204
|
+
assertArticleHref(item.href);
|
|
205
|
+
if (present(item.mark)) assertArticleMark(item.mark);
|
|
206
|
+
}
|
|
207
|
+
return [
|
|
208
|
+
`<section aria-labelledby="${escapeArticleHtml(headingId)}" class="plain-publication__related">`,
|
|
209
|
+
`<div class="plain-publication__section-heading"><h2 id="${escapeArticleHtml(headingId)}">${escapeArticleHtml(heading)}</h2></div>`,
|
|
210
|
+
'<div class="plain-publication__related-grid">',
|
|
211
|
+
...items.map((item) => [
|
|
212
|
+
`<a href="${escapeArticleHtml(item.href)}">`,
|
|
213
|
+
present(item.mark)
|
|
214
|
+
? `<img alt="" class="plain-publication__related-mark" decoding="async" height="44" src="${escapeArticleHtml(item.mark)}" width="44">`
|
|
215
|
+
: "",
|
|
216
|
+
`<span class="plain-publication__related-text"><strong>${escapeArticleHtml(item.name)}</strong>`,
|
|
217
|
+
`<span>${escapeArticleHtml(item.role ?? item.relationship)}</span></span></a>`,
|
|
218
|
+
].join("")),
|
|
219
|
+
"</div></section>",
|
|
220
|
+
].join("");
|
|
221
|
+
}
|
|
222
|
+
|
|
223
|
+
/** The static equivalent of `ArticleIndex`. */
|
|
224
|
+
export function renderArticleIndexHtml({
|
|
225
|
+
className,
|
|
226
|
+
heading,
|
|
227
|
+
headingId,
|
|
228
|
+
headingLevel = 2,
|
|
229
|
+
id,
|
|
230
|
+
items,
|
|
231
|
+
summary,
|
|
232
|
+
}: Readonly<{
|
|
233
|
+
className?: string;
|
|
234
|
+
heading: string;
|
|
235
|
+
headingId: string;
|
|
236
|
+
headingLevel?: 1 | 2 | 3 | 4 | 5;
|
|
237
|
+
id?: string;
|
|
238
|
+
items: readonly ArticleIndexItem[];
|
|
239
|
+
summary?: string;
|
|
240
|
+
}>): string {
|
|
241
|
+
if (![1, 2, 3, 4, 5].includes(headingLevel)) throw new RangeError("Article index heading level must be 1 to 5.");
|
|
242
|
+
const hrefs = new Set<string>();
|
|
243
|
+
for (const item of items) {
|
|
244
|
+
assertArticleHref(item.href);
|
|
245
|
+
assertArticleDates(item.updated === undefined ? { published: item.published } : { published: item.published, updated: item.updated });
|
|
246
|
+
if (hrefs.has(item.href)) throw new RangeError(`Article index lists ${item.href} more than once.`);
|
|
247
|
+
hrefs.add(item.href);
|
|
248
|
+
}
|
|
249
|
+
const heading1 = `h${headingLevel}`;
|
|
250
|
+
const entry = `h${headingLevel + 1}`;
|
|
251
|
+
return [
|
|
252
|
+
`<section aria-labelledby="${escapeArticleHtml(headingId)}" class="${escapeArticleHtml(classes(ROOT_CLASS, "plain-publication__list", className))}" data-hraness-article-index=""${id === undefined ? "" : ` id="${escapeArticleHtml(id)}"`}>`,
|
|
253
|
+
`<div class="plain-publication__section-heading"><${heading1} id="${escapeArticleHtml(headingId)}">${escapeArticleHtml(heading)}</${heading1}>`,
|
|
254
|
+
present(summary) ? `<p>${escapeArticleHtml(summary)}</p>` : "",
|
|
255
|
+
"</div>",
|
|
256
|
+
'<div class="plain-publication__article-list">',
|
|
257
|
+
...items.map((item) => [
|
|
258
|
+
'<article class="plain-publication__entry">',
|
|
259
|
+
present(item.eyebrow) ? `<p class="plain-publication__entry-label">${escapeArticleHtml(item.eyebrow)}</p>` : "",
|
|
260
|
+
`<${entry} class="plain-publication__entry-title"><a href="${escapeArticleHtml(item.href)}">${escapeArticleHtml(item.title)}</a></${entry}>`,
|
|
261
|
+
`<p class="plain-publication__entry-dek">${escapeArticleHtml(item.dek)}</p>`,
|
|
262
|
+
'<p class="plain-publication__entry-meta">',
|
|
263
|
+
dateHtml("Published", item.published),
|
|
264
|
+
item.updated === undefined ? "" : SEPARATOR + dateHtml("Updated", item.updated),
|
|
265
|
+
"</p></article>",
|
|
266
|
+
].join("")),
|
|
267
|
+
"</div></section>",
|
|
268
|
+
].join("");
|
|
269
|
+
}
|