@nimtech/nimpress 2.3.5 → 2.3.7

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.
@@ -224,6 +224,6 @@ The reader cares that the docs Try-It and the response panels show meaningful bo
224
224
 
225
225
  2. Each entry is a row of `[version pill] [data.title] [chevron]`. Clicking the row expands the body.
226
226
 
227
- 3. The first entry expands by default. A direct hash like `/path#v1.4.2` expands that entry and scrolls to it.
227
+ 3. Every entry starts collapsed. A direct hash like `/path#v1.4.2` expands that entry and scrolls to it.
228
228
 
229
229
  4. The right rail TOC lists every version as a level 2 heading. The left sidebar adds one child entry per version under the collection page, each pointing at the hash anchor.
@@ -16,6 +16,8 @@ Every markdown page declares YAML frontmatter at the top. Parsed with `gray-matt
16
16
 
17
17
  3.1. `sidebar` inserts the page under a named sidebar group without changing its URL: required `name` as the verbatim label, optional `icon` and `style` decorating the group row, optional `path` overriding the group route. On a folder `index.md` the block changes and styles the folder's own sidebar entry instead of nesting a group; this works on every page type. On the root `index.md` the block inserts the page into the sidebar as the entry for the directory named by `path`, making the root page a clickable top level item. A `.story.ts` file carries the same block on its definition, `sidebar: { name, icon, style }`, to decorate its own story row; see the component modules rule.
18
18
 
19
+ 3.1.1. `link: <absolute url>` turns the file into a sidebar entry that opens that url in a new tab instead of routing to a page. The file carries frontmatter and no body, produces no route, no search entry, and nothing in the build, and takes its sidebar position from where the file sits. `title` or `slug` is the label, `order` places it, `sidebar.icon` and `sidebar.style` decorate it. A relative value, or a body, is a lint error. `redirect` remains the internal counterpart.
20
+
19
21
  3.2. `sidebar.icon` accepts literal text or ascii art rendered verbatim in the mono font, inline `<svg>` markup rendered as markup, or a path ending in `.svg` resolved against the declaring file, or against `contentDir` when it starts with `/`, read at build time and inlined. An unreadable path warns and drops the icon. The sidebar renders icons only from `sidebar` blocks and story definitions.
20
22
 
21
23
  4. `description` gets used as a meta description and a search excerpt. Add it for any page expected to land via search.
package/dist/cli.es.js CHANGED
@@ -1,4 +1,4 @@
1
- import { d as R, c as he, r as ge, s as Ue, p as Ve, a as Fe, b as Q, e as qe, f as Ke, g as le, h as De, i as Qe, j as Ce, k as Xe, l as Ye, m as et, n as Se, w as X, o as Oe, q as tt, t as st, u as nt, v as ot, x as rt } from "./plugin-BLpql0xC.js";
1
+ import { d as R, c as he, r as ge, s as Ue, p as Ve, a as Fe, b as Q, e as qe, f as Ke, g as le, h as De, i as Qe, j as Ce, k as Xe, l as Ye, m as et, n as Se, w as X, o as Oe, q as tt, t as st, u as nt, v as ot, x as rt } from "./plugin-BeM5N1us.js";
2
2
  import { join as h, dirname as z, relative as D, sep as U, extname as Y, resolve as T, basename as F } from "node:path";
3
3
  import { readdirSync as q, existsSync as b, writeFileSync as L, mkdirSync as ye, rmSync as ne, readFileSync as J, statSync as Ee } from "node:fs";
4
4
  import it from "gray-matter";