@heroiclands/package-build 23.12.0 → 23.12.1

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @heroiclands/package-build
 
+## 23.12.1
+
+### Patch Changes
+
+A wikilink now introduces its note under whatever label reads naturally, such as `[[place-vedyara|Vedyara]]` for _Vedyara Region_, so lint no longer asks for the note's full name in prose. A `.name` span still introduces the full name first.
+
 ## 23.12.0
 
 ### Minor Changes

package/docs/authoring/links-and-markup.md

@@ -91,9 +91,12 @@ the attribute adds no book presentation.
 
 `package-build lint` warns when an indexed name or alias uses `.name`
 instead of a link, when the same name is marked or linked again, or when a
-short form appears before its full name. Only marked names and authored link
-labels count toward these rules. Introduce the full name before an alias such
-as `Arden`, then use plain text for later mentions. Full names and their
+`.name` span or Markdown link uses a short form before its full name. Only
+marked names and authored link labels count toward these rules. A wikilink
+introduces its note under whatever label reads naturally, so
+`[[place-arden|Arden]]` needs no earlier `Arden Vale`, and an article
+mid-sentence stays lowercase. A `.name` span introduces the full name before
+an alias such as `Arden`. Later mentions are plain text. Full names and their
 declared aliases count as the same name, including in links to different
 headings. Different labels do not become the same name just because they link
 to the same page.

package/docs/reference/format-details.md

@@ -1851,9 +1851,13 @@ infoboxes, code, comments and embeds are outside this check.
 
 A name is explicit: a `[Name]{.name}` bracket span or an authored link label.
 Use typed `.name` spans for unwritten subjects and ordinary wikilinks for
-indexed subjects, including private ones. Introduce another subject with its
-full canonical name at its first prose use; use plain text for the note's own
-subject and for later mentions and aliases.
+indexed subjects, including private ones. Mark or link another subject at its
+first prose use, and use plain text for the note's own subject and for later
+mentions and aliases. A wikilink identifies its note, so its label is whatever
+reads naturally in the sentence: `[[place-vedyara|Vedyara]]` for a note whose
+full name is _Vedyara Region_, and a lowercase article mid-sentence
+(`[[place-southwall|the Southern Wall]]`). A `.name` span has no note behind
+it, so it carries the full name.
 Plain prose is not searched for names. Wikilinks, ordinary Markdown links and
 reference links all supply names; a resolved empty wikilink label uses the
 note's full name. Images, code, footnote markers and bare autolinks without
@@ -1867,9 +1871,10 @@ authored labels supply none.
    anchors. Other labels use their whole text as their identity: different
    labels linking to one page are separate names, and a label is not
    automatically an alias of its destination.
-3. Introduce the full name before a short form or declared alias.
-   Possessives and regular plurals count as uses; other indexed forms can be
-   declared aliases.
+3. A `.name` span or an ordinary Markdown link introduces the full name
+   before a short form or declared alias. A resolved wikilink introduces its
+   note under any label. Possessives and regular plurals count as uses; other
+   indexed forms can be declared aliases.
 
 Bold is emphasis. A whole bold span exactly matching an indexed full name or
 alias receives one advisory to mark or link the name. It supplies no name

package/engine/first-use.mjs

@@ -327,14 +327,16 @@ export function createFirstUseChecker({
                     "repeated-name",
                     `“${entry.full}” is linked or marked more than once`,
                 );
-            if (!entry.fullUse && !fullUsed.has(entry.key))
+            // A resolved wikilink identifies its note, so its label may be any natural form.
+            const introduces = entry.fullUse || entry.key === event.preferred?.key;
+            if (!introduces && !fullUsed.has(entry.key))
                 add(
                     event.start,
                     "short-before-full",
                     `“${event.label}” appears before the full name “${entry.full}”`,
                 );
             used.add(entry.key);
-            if (entry.fullUse) fullUsed.add(entry.key);
+            if (introduces) fullUsed.add(entry.key);
         }
         for (const span of bold) {
             if (typeof span.label !== "string") continue;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@heroiclands/package-build",
-    "version": "23.12.0",
+    "version": "23.12.1",
     "description": "Shared toolchain for building and shipping a HeroicLands Foundry VTT package — content compilation, manifest, localization, staging, bundle, release and deployment.",
     "license": "GPL-3.0-or-later",
     "type": "module",