@heroiclands/package-build 23.13.0 → 24.0.1

package/hugo-theme/layouts/partials/search.html

@@ -1,84 +0,0 @@
-{{- /*
-  The header search box, rendered only when a consumer sets `params.search`
-  (silent-disappear otherwise — see the README's "Search" section).
-
-  `@heroiclands/package-build`'s `package-build site-root` step writes a
-  Pagefind index beside the rendered pages, at `pagefind/` under the site's
-  own base URL, when a consumer leaves `site.search` at its default of `true`
-  (see that package's `docs/configuration.md`, `site.search`). Pagefind's own
-  UI — `pagefind-ui.js` and `pagefind-ui.css` — ships inside that generated
-  directory, so nothing here is bundled or pinned to a Pagefind version; the
-  index and the UI that reads it travel together.
-
-  Both files are referenced the same way every other theme-bundled asset is
-  — `relURL`, exactly as `"css/style.css" | relURL` resolves in
-  `baseof.html` — so a package served under a prefix (`/thalorna/`) finds
-  its own index rather than another package's.
-
-  A `/search/` results page would need a consumer content file at that
-  address, and a site is its homepage and its pages with nothing generated
-  between them (package-build's `docs/configuration.md`, "A site is its
-  homepage and its pages") — so a dedicated results page is not this
-  theme's to invent. Pagefind's own panel UI needs no page of its own, so
-  the header box opens that instead.
-
-  Context: the page (only .Site is read, so this partial can also be called
-  with just `.Site` in a dict).
-*/ -}}
-{{- if .Site.Params.search }}
-<div class="site-search" data-pagefind-ignore>
-  <button
-    type="button"
-    class="search-toggle"
-    aria-label="Search"
-    aria-expanded="false"
-    aria-controls="site-search-panel"
-  ><i class="fa-solid fa-magnifying-glass" aria-hidden="true"></i></button>
-  <div id="site-search-panel" class="search-panel" hidden>
-    <div class="search-panel-inner" id="search"></div>
-  </div>
-</div>
-<link rel="stylesheet" href="{{ "pagefind/pagefind-ui.css" | relURL }}">
-<script src="{{ "pagefind/pagefind-ui.js" | relURL }}" defer></script>
-<script>
-(function () {
-  var toggle = document.querySelector(".search-toggle");
-  var panel = document.getElementById("site-search-panel");
-  if (!toggle || !panel) return;
-  var ui = null;
-
-  function open() {
-    panel.hidden = false;
-    toggle.setAttribute("aria-expanded", "true");
-    if (!ui && typeof PagefindUI !== "undefined") {
-      ui = new PagefindUI({
-        element: "#search",
-        showSubResults: true,
-        showImages: false
-      });
-    }
-    var input = panel.querySelector("input");
-    if (input) input.focus();
-  }
-
-  function close() {
-    panel.hidden = true;
-    toggle.setAttribute("aria-expanded", "false");
-  }
-
-  toggle.addEventListener("click", function () {
-    if (panel.hidden) { open(); } else { close(); }
-  });
-
-  document.addEventListener("keydown", function (e) {
-    if (e.key === "Escape" && !panel.hidden) close();
-  });
-
-  document.addEventListener("click", function (e) {
-    if (panel.hidden) return;
-    if (panel.contains(e.target) || toggle.contains(e.target)) return;
-    close();
-  });
-})();
-</script>
-{{- end }}

package/hugo-theme/layouts/partials/site-url.html

@@ -1,32 +0,0 @@
-{{- /*
-  Resolve a consumer-supplied link against the site it is rendered on.
-
-  The theme carries layout, not addresses, so every URL it renders comes from
-  a consuming site's configuration or front matter — and a package published
-  under a path prefix (`/sohl/`, `/thalorna/`) needs its own links to carry
-  that prefix without writing it down anywhere.
-
-  Resolution:
-    1. An already-absolute URL (http://, https://, //) is returned as-is, so a
-       consumer can point at another host.
-    2. A page fragment or query alone (#anchor, ?q=) is returned as-is.
-    3. Anything else is treated as a path within this site and resolved with
-       `relURL`. A leading slash is trimmed first: `relURL` reads a leading
-       slash as "from the origin" and leaves the base path off, so trimming it
-       means a consumer writing the obvious "/section/" still gets a link
-       inside its own site when that site is served under a prefix.
-
-  Usage:
-    {{ partial "site-url.html" (dict "site" .Site "url" "kb/rules/") }}
-
-  Params:
-    site — the site context (.Site). Accepted for symmetry with cdn-url.html
-           and so this partial can never be tempted to read a page.
-    url  — the address to resolve. An empty value resolves to the site root.
-*/ -}}
-{{- $url := .url | default "" -}}
-{{- $resolved := $url -}}
-{{- if not (or (hasPrefix $url "http://") (hasPrefix $url "https://") (hasPrefix $url "//") (hasPrefix $url "#") (hasPrefix $url "?")) -}}
-  {{- $resolved = strings.TrimPrefix "/" $url | relURL -}}
-{{- end -}}
-{{- return $resolved -}}

package/hugo-theme/layouts/partials/tags.html

@@ -1,30 +0,0 @@
-{{- /*
-  A page's own subject-tag chips, rendered from .Params.tags.
-
-  `draft` is suppressed here: it is a presentation fact about the writing,
-  not a fact about the subject (package-build/engine/note-vocabulary.mjs,
-  `DRAFT_TAG`) — a draft compiles, validates, publishes and resolves like any
-  other note. It does not belong beside subject tags in a reader-facing tag
-  list; `draft-notice.html` is where the state is stated,
-  and `draft-state.html` is the one place either partial spells the tag.
-
-  The taxonomy itself is untouched: a draft page still carries the tag, still
-  lists on its term page, and the term still appears in a site-wide taxonomy
-  listing. This partial decides only what a page's own chip row shows.
-
-  Silent-disappear: a page whose only tag is `draft` emits nothing here, the
-  same as a page with no tags at all.
-
-  Context: the page.
-*/ -}}
-{{- $tags := slice -}}
-{{- range .Params.tags -}}
-  {{- if ne (lower .) "draft" -}}
-    {{- $tags = $tags | append . -}}
-  {{- end -}}
-{{- end -}}
-{{- with $tags }}
-<div class="single-tags">
-  {{ range . }}<a href="{{ printf "tags/%s/" (. | urlize) | relURL }}" class="tag">{{ . }}</a>{{ end }}
-</div>
-{{ end -}}

package/hugo-theme/layouts/partials/toc.html

@@ -1,28 +0,0 @@
-{{- /*
-  Table of Contents partial.
-
-  Renders a sticky right-rail TOC on pages that have more than 3 H2
-  headings. We detect the threshold by grepping the raw content source
-  (`.RawContent`) for lines starting with "## " — this is faster and
-  more reliable than parsing the rendered HTML, and catches authored
-  headings regardless of markdown extensions that Hugo might apply.
-
-  The caller is responsible for:
-    - wrapping the page in a CSS grid when this partial renders
-      (see `.single.single-with-toc` in style.css)
-    - gating invocation with `partialCached` if desired
-
-  This partial prints nothing when the H2 count is 3 or less, so it's
-  safe to include unconditionally.
-*/ -}}
-
-{{- $raw := .RawContent | default "" -}}
-{{- $h2Count := len (findRE `(?m)^##\s+\S` $raw) -}}
-{{- if gt $h2Count 3 -}}
-<aside class="toc" aria-label="Table of contents" data-pagefind-ignore>
-  <div class="toc-inner">
-    <p class="toc-label">On this page</p>
-    {{ .TableOfContents }}
-  </div>
-</aside>
-{{- end -}}

package/hugo-theme/layouts/partials/warn-missing-banner.html

@@ -1,3 +0,0 @@
-{{- warnidf (printf "hero-banner-missing-%s" .name)
-    "hero-banner: no banner named %q in the shared artwork set; falling back to %s/%s. Draw it and add %q to data/banners.yaml, or name a hero image with `data.banner`. Write `data.banner: none` to decline a hero image. First seen on %s."
-    .name .dir .fallback .name .context -}}

package/hugo-theme/layouts/shortcodes/cartouche.html

@@ -1,64 +0,0 @@
-{{- /*
-  Cartouche shortcode — renders a named cartouche SVG as an ornamental
-  accent on culture-flavored pages. The canonical use is Kheperi
-  cartouches on Ta'Kheperu and Kemetian-pantheon pages, but the same
-  pipeline works for any "named seal" SVG.
-
-  Usage (shown with plain angle brackets so the Go template parser
-  doesn't try to close this comment). Hugo forbids MIXING positional
-  and named parameters in one call, so pick a form per call:
-
-    { {< cartouche "takheperu" >} }                               positional
-    { {< cartouche slug="takheperu" >} }                          named, centered
-    { {< cartouche slug="takheperu" align="right" >} }            floated right
-    { {< cartouche slug="ra" size="inline" >} }                   inline
-    { {< cartouche slug="anubis" caption="Anpu" >} }              figure + caption
-
-  Parameters (all optional except slug):
-    slug    - The cartouche SVG basename. May also be passed positionally
-              (as the first positional argument) when no other params
-              are needed — Hugo disallows mixing the two styles.
-    size    - "inline" to flow with text. Otherwise block-level.
-    align   - "left" or "right" to float so prose wraps. Default centered.
-    height  - CSS length override for the cartouche's height, e.g.
-              "10rem" or "160px". Default comes from .cartouche CSS
-              (13rem block, 9rem floated). Width scales from aspect ratio.
-    alt     - Override screen-reader text. Defaults to humanized slug.
-    caption - Optional figcaption (block mode only).
-
-  SVG is expected at /static/img/cartouches/<slug>.svg. Design note:
-  cartouche SVGs should draw with stroke="currentColor" and fill="none"
-  (or a hard-coded brand color) so they tint cleanly against any
-  background.
-*/ -}}
-{{- /* Accept slug as either the first positional arg or the named
-       "slug" parameter, so a caller can pick the style that fits the
-       rest of their arguments. */ -}}
-{{- $slug := .Get "slug" -}}
-{{- if not $slug }}{{ $slug = .Get 0 }}{{ end -}}
-{{- if not $slug -}}
-  {{- errorf "cartouche shortcode at %s needs a slug (positional arg 0 or slug=\"…\")" .Position -}}
-{{- end -}}
-{{- $altDefault := humanize (replace $slug "-" " ") | title -}}
-{{- $alt    := .Get "alt"     | default $altDefault -}}
-{{- $size   := .Get "size"    | default "" -}}
-{{- $align  := .Get "align"   | default "" -}}
-{{- $cap    := .Get "caption" | default "" -}}
-{{- $height := .Get "height"  | default "" -}}
-{{- $src    := printf "img/cartouches/%s.svg" $slug | relURL -}}
-{{- $classes := slice "cartouche" -}}
-{{- with $size  }}{{ $classes = $classes | append (printf "cartouche-%s" .) }}{{ end -}}
-{{- with $align }}{{ $classes = $classes | append (printf "cartouche-%s" .) }}{{ end -}}
-{{- $class := delimit $classes " " -}}
-{{- /* When `height` is given, apply it as an inline style directly on
-       the <img>. Inline styles on the target element are unambiguous —
-       they trump any .cartouche img CSS rule on specificity and don't
-       depend on custom-property inheritance. */ -}}
-{{- if eq $size "inline" -}}
-<span class="{{ $class }}"><img src="{{ $src }}" alt="{{ $alt }}" loading="lazy"{{ with $height }} style="height: {{ . }}; width: auto; max-width: none;"{{ end }} /></span>
-{{- else -}}
-<figure class="{{ $class }}">
-  <img src="{{ $src }}" alt="{{ $alt }}" loading="lazy"{{ with $height }} style="height: {{ . }}; width: auto; max-width: none;"{{ end }} />
-  {{- with $cap }}<figcaption>{{ . }}</figcaption>{{ end }}
-</figure>
-{{- end -}}

package/hugo-theme/layouts/shortcodes/exturl.html

@@ -1,12 +0,0 @@
-<span class="exturl">
-  <code class="exturl-text">{{ .Get 0 }}</code>
-  <button class="exturl-copy" onclick="navigator.clipboard.writeText('{{ .Get 0 }}').then(()=>{const b=this;b.classList.add('copied');setTimeout(()=>b.classList.remove('copied'),1500)})" title="Copy URL to clipboard" aria-label="Copy URL to clipboard">
-    <svg class="exturl-icon" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
-      <rect x="9" y="9" width="13" height="13" rx="2" ry="2"/>
-      <path d="M5 15H4a2 2 0 01-2-2V4a2 2 0 012-2h9a2 2 0 012 2v1"/>
-    </svg>
-    <svg class="exturl-check" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round">
-      <polyline points="20 6 9 17 4 12"/>
-    </svg>
-  </button>
-</span>

package/hugo-theme/layouts/shortcodes/glyph.html

@@ -1,43 +0,0 @@
-{{- /*
-  Glyph shortcode — renders a hieroglyphic deity-name cluster (or any
-  "icon-scale" SVG) from the project CDN. Parallel to cartouche.html
-  but for smaller, non-royal glyph groups: Kemetían deity names,
-  category icons, ornamental marks, etc.
-
-  Usage (Hugo disallows mixing positional and named params in one
-  call; pick a form per call):
-
-    { {< glyph "anubis" >} }                             inline, plain
-    { {< glyph slug="anubis" >} }                        same, named form
-    { {< glyph slug="anubis" frame="tablet" >} }         inside stone tablet
-    { {< glyph slug="ra" size="inline" >} }              scales with text
-    { {< glyph slug="ra" size="block" >} }               centered block
-    { {< glyph slug="ra" alt="Sun god Ra" >} }           override alt text
-
-  Parameters (all optional except slug):
-    slug    - Filename (without .svg). Passed positionally or as slug=.
-    frame   - "tablet" wraps in a limestone rectangular frame (good for
-              catalog layouts like the pantheon table where visual
-              parallelism across rows matters more than intrinsic width).
-    size    - "inline" (small, flows with text), "block" (centered
-              standalone). Default sits at 1.8em height.
-    alt     - Screen-reader text. Defaults to humanized slug.
-
-  SVG source: icons/<slug>.svg, resolved against the consuming site's
-  `params.cdnBaseURL` — the theme names no host of its own.
-*/ -}}
-{{- $slug := .Get "slug" -}}
-{{- if not $slug }}{{ $slug = .Get 0 }}{{ end -}}
-{{- if not $slug -}}
-  {{- errorf "glyph shortcode at %s needs a slug (positional arg 0 or slug=\"…\")" .Position -}}
-{{- end -}}
-{{- $altDefault := humanize (replace $slug "-" " ") | title -}}
-{{- $alt   := .Get "alt"   | default $altDefault -}}
-{{- $frame := .Get "frame" | default "" -}}
-{{- $size  := .Get "size"  | default "" -}}
-{{- $src   := partial "cdn-url.html" (dict "site" .Site "path" (printf "icons/%s.svg" $slug)) -}}
-{{- $classes := slice "glyph" -}}
-{{- with $frame }}{{ $classes = $classes | append (printf "glyph-%s" .) }}{{ end -}}
-{{- with $size  }}{{ $classes = $classes | append (printf "glyph-%s" .) }}{{ end -}}
-{{- $class := delimit $classes " " -}}
-<span class="{{ $class }}"><img src="{{ $src }}" alt="{{ $alt }}" loading="lazy" /></span>

package/hugo-theme/layouts/shortcodes/pagelist.html

@@ -1,63 +0,0 @@
-{{- /*
-  pagelist — the pages carrying a tag, as a plain list.
-
-  Curated landings are the right front door, but hand-enumerated link lists
-  drift: a page gets added and nobody updates the index. This expresses a group
-  by INTENT instead. Tag a page and it files itself; untag it and it leaves.
-
-  Usage:
-
-    { {< pagelist tag="key-concept" >} }                  every tagged page
-    { {< pagelist tag="key-concept" section="rules" >} }  restricted to a section
-    { {< pagelist tag="key-concept" sort="weight" >} }    title (default) | weight | date
-    { {< pagelist tag="key-concept" desc="true" >} }      include page descriptions
-
-  Parameters:
-    tag      - (required) taxonomy term. Matched case-insensitively.
-    section  - (optional) restrict to one top-level section, e.g. "rules".
-    sort     - (optional) "title" (default), "weight", or "date" (newest first).
-    desc     - (optional) "true" to show each page's description beneath it.
-
-  An unknown or empty tag warns at build time rather than rendering nothing
-  silently — a typo in a tag is exactly the drift this is meant to prevent.
-*/ -}}
-{{- $tag := .Get "tag" -}}
-{{- if not $tag }}{{ $tag = .Get 0 }}{{ end -}}
-{{- if not $tag -}}
-  {{- errorf "pagelist shortcode at %s needs a tag (tag=\"…\" or positional arg 0)" .Position -}}
-{{- end -}}
-
-{{- $term := $tag | urlize -}}
-{{- $pages := slice -}}
-{{- with index .Site.Taxonomies.tags $term -}}
-  {{- $pages = .Pages -}}
-{{- end -}}
-
-{{- with $.Get "section" -}}
-  {{- $sec := . -}}
-  {{- $pages = where $pages "Section" $sec -}}
-{{- end -}}
-
-{{- $sort := $.Get "sort" | default "title" -}}
-{{- if eq $sort "weight" -}}
-  {{- $pages = sort $pages "Weight" -}}
-{{- else if eq $sort "date" -}}
-  {{- $pages = sort $pages "Date" "desc" -}}
-{{- else -}}
-  {{- $pages = sort $pages "Title" -}}
-{{- end -}}
-
-{{- if not $pages -}}
-  {{- warnf "pagelist at %s: no pages carry the tag %q — check the spelling, or tag some pages." $.Position $tag -}}
-{{- else -}}
-<ul class="page-list pagelist">
-  {{- range $pages }}
-  <li class="page-list-item">
-    <a class="page-list-title" href="{{ .RelPermalink }}">{{ .Title }}</a>
-    {{- if and (eq ($.Get "desc") "true") .Description }}
-    <span class="page-list-desc">{{ .Description }}</span>
-    {{- end }}
-  </li>
-  {{- end }}
-</ul>
-{{- end -}}

package/hugo-theme/theme.toml

@@ -1,11 +0,0 @@
-name = "Heroic Lands"
-license = "GPL-3.0-or-later"
-licenselink = "https://github.com/HeroicLands/package-build/blob/main/LICENSE.md"
-description = "Shared Hugo theme for the Heroic Lands projects — brand chrome (header/footer, Cinzel/Lora, dark palette) and the SoHL info-block partials, so every site built on it reads as one coherent whole. Carries layout, not addresses: each consuming repository supplies its own URLs."
-homepage = "https://github.com/HeroicLands/package-build"
-min_version = "0.156.0"
-tags = ["heroic-lands", "sohl", "brand"]
-
-[author]
-  name = "Tom Rodriguez"
-  homepage = "https://github.com/HeroicLands"

package/types/engine/web-wikilinks.d.mts

@@ -1,107 +0,0 @@
-/**
- * Every wikilink authored inside a frontmatter value.
- *
- * Wikilinks are resolved in a note's **body** — by {@link resolveWebWikilinks}
- * here, and by the pack compilers' `convertWikilinks` for Foundry. Frontmatter
- * is not markdown and is never walked by either, so a link written in one is
- * copied through verbatim and reaches the reader as literal `[[…]]` text, in
- * whatever the theme renders that field as (an infobox row, a description, a
- * card subtitle). Nothing downstream notices: the value is a valid string, the
- * page builds, and the defect is visible only to someone who looks at it.
- *
- * So the form is refused rather than resolved. Resolving it would mean choosing
- * an output syntax for a field whose renderer is unknown to this build — a
- * markdown link is inert in a Hugo template that prints the value as text, and
- * an `<a>` is unusable in one that escapes it — and would quietly bless an
- * authoring habit that the pack build has no way to honour at all. Frontmatter
- * carries data; a link belongs in prose.
- *
- * Values are read from the *parsed* frontmatter, so a `[[` inside a YAML comment
- * is not a hit, and every hit can be named by the path a reader would look at.
- *
- * @param {unknown} fm - Parsed frontmatter, as `readMatter` returns it.
- * @returns {Array<{path: string, link: string}>} In reading order; `path` is the
- *   dotted key path of the offending value (`government.summary`, `aliases.1`).
- */
-export function frontmatterWikilinks(fm: unknown): Array<{
-    path: string;
-    link: string;
-}>;
-/**
- * Rewrites the wikilinks in a markdown body as KB-local markdown links.
- *
- * **Every target is an address**, parsed by {@link readQualifier} and looked up
- * case-insensitively in the KB-wide `ctx.index` (the canonical
- * `package-system-type-shortcode`, `type/shortcode`, and the site's own
- * `section/slug`), then in the vendored `ctx.foreign` manifests. A target is a
- * *partial* address: an omitted package means this package, an omitted system
- * is a wildcard, and exactly one match resolves — two are `ambiguous`. A link written
- * without a label addresses nothing at all and is reported as such —
- * there is no second namespace left for it to name.
- *
- * Only a slash-qualified target reaches the raw key, which is what keeps
- * `section/slug` addressable without a page's own slug answering for it.
- *
- * **Every target that resolves nowhere fails the build**, and is
- * classified into the vocabulary all three resolvers share — `unlabelled`,
- * `not-an-address`, `unknown-type`, `ambiguous`, `unresolved`,
- * `no-content-index`. Failures are collected in `ctx.errors`, each carrying
- * the authored `link` and its `occurrence` so a caller can report the line and
- * column it sits on.
- *
- * There is deliberately no exception letting a hyphen-form address through while
- * any linkable package had no vendored manifest, since a real cross-package
- * reference and a typo look identical from here. The pack compilers and the
- * link checker never made that allowance, so its only surviving effect was to
- * give one authored link two verdicts. The advice moved into the message
- * instead.
- *
- * A target that resolves nowhere still renders through {@link unresolvedLink}
- * rather than as bare prose: the author's text is kept, marked so a
- * reader can see a link was intended. The marking and the failure are separate
- * jobs and always were — the mark is for whoever reads the page a *previous*
- * build emitted, the failure is for the author of this one.
- *
- * A target that **resolved** to an entry with no page is not this case and is
- * not marked: a pack-only package publishes Foundry addresses and no
- * web pages, so the author wrote a real address and there is simply nothing to
- * link to.
- *
- * ## Embeds first, and they are not links
- *
- * `![[address|label]]` names a file rather than a note, so it is resolved into
- * an ordinary markdown image before anything looks for a link — which is what
- * stops the link pass reading an embed's interior as a link to a note nobody
- * wrote. The image the rewrite leaves behind is what
- * {@link module:engine/content-images.renderImageFigures} turns into a figure
- * for the website, and what the book reads its staging list out of.
- *
- * ## Every hit is recorded, so the page's edges come out of one pass
- *
- * A caller that hands in `ctx.resolved` is given every index entry a link on
- * the page resolved to, in body order, repeats included. That is the link
- * graph, read at the one point where it exists: the build never has to walk a
- * page a second time to learn what it links to. Nothing is recorded for a
- * same-page anchor or for a target that resolved nowhere.
- *
- * @param {string} body - The markdown body.
- * @param {object} ctx - `{ index, assets, collide, contentTypes,
- *   packages, noIndexPackages, foreign, type, errors, src, file, resolved,
- *   output }`. `output` is `"book"` for PDF Markdown and defaults to HTML.
- *   `packages` is every package an address may name, without which the leading
- *   package segment of a canonical address reads as an unknown type;
- *   `noIndexPackages` is every package declared `contentIndex: false`, so a
- *   qualified address naming one fails with `no-content-index` rather than
- *   `not-an-address`; `foreign`
- *   is the cross-package manifest index; `assets` is the address space an embed
- *   resolves against. `src` is the page's display
- *   path and `file` the source file a diagnostic should name — absent, `src`
- *   stands in. `resolved`, when supplied, is the array every resolved
- *   target's index entry is appended to. `anchors` is the `{#slug}` set
- *   *this* page declares, which a `[[#slug]]` self-link is checked against;
- *   absent, a self-link is not checked, exactly as before this existed.
- * @returns {string} The body with embeds and wikilinks rewritten.
- */
-export function resolveWebWikilinks(body: string, ctx: object): string;
-export { slugify };
-import { slugify } from "./content-slug.mjs";