@nimtech/nimpress 2.3.9 → 2.4.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nimtech/nimpress",
-  "version": "2.3.9",
+  "version": "2.4.0",
   "description": "Svelte 5 docs framework that supports it all.",
   "author": "nimling",
   "license": "Apache-2.0",
@@ -78,12 +78,18 @@
     "@xyflow/svelte": "^1.6.3",
     "codemirror": "^6.0.2",
     "gray-matter": "^4.0.3",
+    "katex": "0.18.5",
+    "lucide-static": "1.40.0",
     "markdown-it": "^14.1.0",
     "markdown-it-anchor": "^9.2.0",
     "markdown-it-attrs": "^4.3.1",
     "markdown-it-container": "^4.0.0",
     "markdown-it-deflist": "^3.0.0",
+    "markdown-it-emoji": "3.1.0",
     "markdown-it-footnote": "^4.0.0",
+    "markdown-it-mark": "4.0.0",
+    "markdown-it-sub": "2.0.0",
+    "markdown-it-sup": "2.0.0",
     "markdown-it-task-lists": "^2.1.1",
     "mermaid": "^11.4.1",
     "minisearch": "^7.1.2",
@@ -96,13 +102,16 @@
     "zod": "^3.23.8"
   },
   "devDependencies": {
+    "@playwright/cli": "0.1.19",
+    "@playwright/test": "1.62.1",
     "@tsconfig/svelte": "^5.0.4",
+    "@types/katex": "^0.16.8",
     "@types/markdown-it": "^14.1.2",
     "@types/markdown-it-container": "^2.0.10",
     "@types/markdown-it-footnote": "^3.0.4",
     "@types/node": "^22.10.0",
     "autoprefixer": "^10.4.21",
-    "playwright": "^1.60.0",
+    "playwright": "^1.62.1",
     "postcss": "^8.5.6",
     "svelte": "^5.34.7",
     "svelte-check": "^4.2.2",

package/src/styles/preflight.css

@@ -274,7 +274,8 @@
 .np-callout {
   border-radius: var(--np-radius-md);
   padding: 12px 16px;
-  border-left: 4px solid;
+  border-left: 4px solid var(--np-callout-color);
+  background-color: color-mix(in srgb, var(--np-callout-color) 10%, transparent);
   margin: 16px 0;
   display: flex;
   gap: 12px;
@@ -295,7 +296,9 @@
   margin: 0 0 8px;
   padding: 3px 10px;
   border-radius: var(--np-radius-pill);
-  border: 1px solid;
+  border: 1px solid color-mix(in srgb, var(--np-callout-color) 40%, transparent);
+  color: var(--np-callout-color);
+  background-color: color-mix(in srgb, var(--np-callout-color) 14%, transparent);
   line-height: 1.2;
 }
 
@@ -304,60 +307,104 @@
   line-height: 1;
 }
 
-.np-callout-tip {
-  border-color: var(--np-tip);
-  background-color: color-mix(in srgb, var(--np-tip) 10%, transparent);
-}
-.np-callout-tip .np-callout-title {
-  color: var(--np-tip);
-  background-color: color-mix(in srgb, var(--np-tip) 14%, transparent);
-  border-color: color-mix(in srgb, var(--np-tip) 40%, transparent);
-}
-.np-callout-tip .np-callout-title::before { content: '✦'; }
+.np-callout-tip { --np-callout-color: var(--np-tip); }
+.np-callout-tip > .np-callout-body > .np-callout-title::before,
+.np-callout-tip > .np-callout-title::before { content: '✦'; }
+
+.np-callout-note { --np-callout-color: var(--np-note); }
+.np-callout-note > .np-callout-body > .np-callout-title::before,
+.np-callout-note > .np-callout-title::before { content: 'ℹ'; }
+
+.np-callout-warning { --np-callout-color: var(--np-warning); }
+.np-callout-warning > .np-callout-body > .np-callout-title::before,
+.np-callout-warning > .np-callout-title::before { content: '⚠'; }
+
+.np-callout-info { --np-callout-color: var(--np-info); }
+.np-callout-info > .np-callout-body > .np-callout-title::before,
+.np-callout-info > .np-callout-title::before { content: 'ℹ'; }
+
+.np-callout-check { --np-callout-color: var(--np-check); }
+.np-callout-check > .np-callout-body > .np-callout-title::before,
+.np-callout-check > .np-callout-title::before { content: '✓'; }
+
+.np-callout-abstract { --np-callout-color: var(--np-abstract); }
+.np-callout-abstract > .np-callout-body > .np-callout-title::before,
+.np-callout-abstract > .np-callout-title::before { content: '≡'; }
+
+.np-callout-success { --np-callout-color: var(--np-success); }
+.np-callout-success > .np-callout-body > .np-callout-title::before,
+.np-callout-success > .np-callout-title::before { content: '✔'; }
+
+.np-callout-question { --np-callout-color: var(--np-question); }
+.np-callout-question > .np-callout-body > .np-callout-title::before,
+.np-callout-question > .np-callout-title::before { content: '?'; }
+
+.np-callout-failure { --np-callout-color: var(--np-failure); }
+.np-callout-failure > .np-callout-body > .np-callout-title::before,
+.np-callout-failure > .np-callout-title::before { content: '✕'; }
+
+.np-callout-danger { --np-callout-color: var(--np-danger); }
+.np-callout-danger > .np-callout-body > .np-callout-title::before,
+.np-callout-danger > .np-callout-title::before { content: '⚡'; }
+
+.np-callout-bug { --np-callout-color: var(--np-bug); }
+.np-callout-bug > .np-callout-body > .np-callout-title::before,
+.np-callout-bug > .np-callout-title::before { content: '✱'; }
+
+.np-callout-example { --np-callout-color: var(--np-example); }
+.np-callout-example > .np-callout-body > .np-callout-title::before,
+.np-callout-example > .np-callout-title::before { content: '❯'; }
+
+.np-callout-quote { --np-callout-color: var(--np-quote); }
+.np-callout-quote > .np-callout-body > .np-callout-title::before,
+.np-callout-quote > .np-callout-title::before { content: '❝'; }
 
-.np-callout-note {
-  border-color: var(--np-note);
-  background-color: color-mix(in srgb, var(--np-note) 10%, transparent);
+.np-callout-collapsible {
+  display: block;
+  padding: 0;
 }
-.np-callout-note .np-callout-title {
-  color: var(--np-note);
-  background-color: color-mix(in srgb, var(--np-note) 14%, transparent);
-  border-color: color-mix(in srgb, var(--np-note) 40%, transparent);
+.np-callout-collapsible > .np-callout-title {
+  display: flex;
+  width: auto;
+  margin: 8px 12px;
+  cursor: pointer;
+  list-style: none;
+  user-select: none;
 }
-.np-callout-note .np-callout-title::before { content: 'ℹ'; }
-
-.np-callout-warning {
-  border-color: var(--np-warning);
-  background-color: color-mix(in srgb, var(--np-warning) 10%, transparent);
+.np-callout-collapsible > .np-callout-title::-webkit-details-marker { display: none; }
+.np-callout-collapsible > .np-callout-title::after {
+  content: '›';
+  margin-left: auto;
+  font-size: 14px;
+  line-height: 1;
+  transition: transform 150ms ease;
 }
-.np-callout-warning .np-callout-title {
-  color: var(--np-warning);
-  background-color: color-mix(in srgb, var(--np-warning) 14%, transparent);
-  border-color: color-mix(in srgb, var(--np-warning) 40%, transparent);
+.np-callout-collapsible[open] > .np-callout-title::after { transform: rotate(90deg); }
+.np-callout-collapsible > .np-callout-body {
+  padding: 0 16px 12px;
 }
-.np-callout-warning .np-callout-title::before { content: '⚠'; }
 
-.np-callout-info {
-  border-color: var(--np-info);
-  background-color: color-mix(in srgb, var(--np-info) 10%, transparent);
+.np-callout-inline {
+  width: 40%;
+  margin-top: 0;
 }
-.np-callout-info .np-callout-title {
-  color: var(--np-info);
-  background-color: color-mix(in srgb, var(--np-info) 14%, transparent);
-  border-color: color-mix(in srgb, var(--np-info) 40%, transparent);
+.np-callout-inline-start {
+  float: left;
+  margin-right: 16px;
 }
-.np-callout-info .np-callout-title::before { content: 'ℹ'; }
-
-.np-callout-check {
-  border-color: var(--np-check);
-  background-color: color-mix(in srgb, var(--np-check) 10%, transparent);
+.np-callout-inline-end {
+  float: right;
+  margin-left: 16px;
 }
-.np-callout-check .np-callout-title {
-  color: var(--np-check);
-  background-color: color-mix(in srgb, var(--np-check) 14%, transparent);
-  border-color: color-mix(in srgb, var(--np-check) 40%, transparent);
+.np-prose h2, .np-prose h3 { clear: both; }
+
+@media (max-width: 800px) {
+  .np-callout-inline {
+    float: none;
+    width: auto;
+    margin: 16px 0;
+  }
 }
-.np-callout-check .np-callout-title::before { content: '✓'; }
 
 .np-details {
   padding: 0;
@@ -538,3 +585,157 @@
   border-radius: var(--np-radius-md);
   margin: 24px;
 }
+
+.np-prose mark {
+  background-color: var(--np-mark-bg);
+  color: inherit;
+  padding: 0 3px;
+  border-radius: var(--np-radius-sm);
+}
+
+.np-prose ins {
+  text-decoration: underline;
+  text-decoration-color: var(--np-success);
+  text-decoration-thickness: 2px;
+}
+
+.np-prose del {
+  text-decoration-color: var(--np-danger);
+}
+
+.np-prose sub,
+.np-prose sup {
+  font-size: 0.75em;
+  line-height: 0;
+}
+
+.np-keys {
+  display: inline-flex;
+  align-items: center;
+  gap: 3px;
+  white-space: nowrap;
+}
+
+.np-key-join {
+  color: var(--np-text-faint);
+  font-size: 12px;
+}
+
+.np-prose img.np-img-left {
+  float: left;
+  margin: 4px 24px 12px 0;
+  max-width: 45%;
+}
+
+.np-prose img.np-img-right {
+  float: right;
+  margin: 4px 0 12px 24px;
+  max-width: 45%;
+}
+
+.np-prose h2,
+.np-prose h3 {
+  clear: both;
+}
+
+.np-prose figure.np-figure {
+  margin: 24px 0;
+  text-align: center;
+}
+
+.np-prose figure.np-figure img {
+  margin: 0 auto;
+}
+
+.np-prose .np-figcaption {
+  margin-top: 8px;
+  color: var(--np-text-faint);
+  font-size: 13px;
+}
+
+html.dark .np-prose img.np-img-light,
+html:not(.dark) .np-prose img.np-img-dark {
+  display: none;
+}
+
+.np-prose img.zoom,
+.np-prose-lightbox img {
+  cursor: zoom-in;
+}
+
+.np-icon {
+  display: inline-block;
+  vertical-align: -0.15em;
+  width: 1em;
+  height: 1em;
+  line-height: 1;
+}
+
+.np-icon svg {
+  width: 100%;
+  height: 100%;
+  stroke: currentColor;
+  fill: none;
+}
+
+.np-icon.lg {
+  width: 1.5em;
+  height: 1.5em;
+  vertical-align: -0.35em;
+}
+
+.np-prose .np-math-display {
+  margin: 16px 0;
+  overflow-x: auto;
+  text-align: center;
+}
+
+.np-tags {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 8px;
+  margin-top: 40px;
+}
+
+.np-tag {
+  display: inline-flex;
+  align-items: center;
+  gap: 6px;
+  padding: 3px 10px;
+  border: 1px solid var(--np-border);
+  border-radius: var(--np-radius-pill);
+  background-color: var(--np-bg-surface);
+  color: var(--np-text-muted);
+  font-size: 12px;
+  text-decoration: none;
+  transition: border-color 0.15s ease, color 0.15s ease;
+}
+
+a.np-tag:hover {
+  border-color: var(--np-brand);
+  color: var(--np-brand);
+}
+
+.np-tag-icon {
+  display: inline-flex;
+  width: 14px;
+  height: 14px;
+}
+
+.np-tag-icon svg {
+  width: 100%;
+  height: 100%;
+  stroke: currentColor;
+  fill: none;
+}
+
+.np-abbr {
+  text-decoration: underline dotted;
+  text-underline-offset: 2px;
+  text-decoration-color: var(--np-text-faint);
+  cursor: help;
+}
+
+.np-prose .np-glossary-term {
+  scroll-margin-top: calc(var(--np-header-height) + 16px);
+}

package/src/styles/theme.css

@@ -38,15 +38,16 @@
  *     .np-prose details / summary
  *     .header-anchor   The anchor link wrapping each heading text
  *
- *   Callouts (from :::tip / :::note / :::warning / :::info / :::check)
+ *   Callouts (from :::tip through :::quote, thirteen types)
  *     .np-callout
  *     .np-callout-body
  *     .np-callout-title
- *     .np-callout-tip
- *     .np-callout-note
- *     .np-callout-warning
- *     .np-callout-info
- *     .np-callout-check
+ *     .np-callout-<type>      tip, note, warning, info, check, abstract, success,
+ *                             question, failure, danger, bug, example, quote
+ *     .np-callout-collapsible
+ *     .np-callout-inline
+ *     .np-callout-inline-start
+ *     .np-callout-inline-end
  *
  *   Cards directive (from :::cards / :::card)
  *     .np-cards-grid

package/src/styles/tokens.css

@@ -10,6 +10,9 @@
   --np-bg-card: #FFFFFF;
   --np-bg-code-inline: #ECECEE;
   --np-bg-code-block: #0B1020;
+  --np-code-line-highlight: rgba(204, 120, 92, 0.18);
+  --np-code-annotation: #CC785C;
+  --np-code-annotation-text: #FFFFFF;
 
   --np-text-primary: #09090B;
   --np-text-secondary: #3F3F46;
@@ -32,6 +35,15 @@
   --np-info: #6366F1;
   --np-check: #10B981;
   --np-danger: #EF4444;
+  --np-abstract: #0EA5E9;
+  --np-success: #22C55E;
+  --np-mark-bg: #FDE68A;
+  --np-lightbox-backdrop: rgb(9 9 11 / 0.82);
+  --np-question: #84CC16;
+  --np-failure: #F43F5E;
+  --np-bug: #EC4899;
+  --np-example: #8B5CF6;
+  --np-quote: #6B7280;
 
   --np-method-get: #10B981;
   --np-method-post: #3B82F6;
@@ -68,6 +80,9 @@ html.dark {
   --np-bg-card: #1C1C1F;
   --np-bg-code-inline: #1F1F22;
   --np-bg-code-block: #0B0B0D;
+  --np-code-line-highlight: rgba(204, 120, 92, 0.22);
+  --np-code-annotation: #E8A48E;
+  --np-code-annotation-text: #0F0F10;
 
   --np-text-primary: #FAFAFA;
   --np-text-secondary: #A1A1AA;
@@ -83,6 +98,16 @@ html.dark {
   --np-table-row-alt: #16161A;
   --np-table-row-hover: #1F1F22;
   --np-table-header-bg: #1A1A1E;
+
+  --np-abstract: #38BDF8;
+  --np-success: #4ADE80;
+  --np-mark-bg: #713F12;
+  --np-lightbox-backdrop: rgb(0 0 0 / 0.86);
+  --np-question: #A3E635;
+  --np-failure: #FB7185;
+  --np-bug: #F472B6;
+  --np-example: #A78BFA;
+  --np-quote: #9CA3AF;
 }
 
 html, body {