@heroiclands/package-build 22.17.2 → 22.18.0

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # @heroiclands/package-build
 
+## 22.18.0
+
+### Minor Changes
+
+- Beings use their subtype to choose default art.
+
+### Patch Changes
+
+Being profiles identify each subject as Character, NPC, or Creature from its top-level subtype.
+
 ## 22.17.2
 
 ### Patch Changes

package/docs/authoring/frontmatter.md

@@ -21,7 +21,7 @@ data: {}
 ---
 ```
 
-`name.full` is the displayed name; `name.aliases` helps search. `description` is the short page summary. `tags` hold draft state and classification. `data` holds facts about the subject shared by systems. A YAML comment is the place for an author-only note: commented values remain valid YAML but do not enter the content index or generated documents.
+`name.full` is the displayed name; `name.aliases` helps search. `description` is the short page summary. `tags` hold draft state and descriptive labels. The note type's classification belongs in `subType` where it is declared. `data` holds facts about the subject shared by systems. A YAML comment is the place for an author-only note: commented values remain valid YAML but do not enter the content index or generated documents.
 
 Use `tags: [gm]` for a note intended only for the GM. It is absent from the public website and book. Foundry includes it only when its document routes to a pack with `private: true`. A note with `gm` that also creates a prose JournalEntry needs a private JournalEntry pack. Links from untagged notes to GM notes are errors; GM notes may link to one another.
 
@@ -37,4 +37,4 @@ One body describes the subject for both systems. A being's `{#appearance}` and `
 
 ## Publication and summaries
 
-A note infobox draws from shared `data`. A system infobox draws from the system's fields, and a mapped system with no document says “Not available.” The same authored body appears in Foundry, on the website, and in the book; presentation adapts to each medium. [Infobox details](../reference/format-details.md#the-infobox) describe field order and empty values.
+A note infobox draws from shared `data`. A being profile shows its top-level `subType` as `Type: Character`, `Type: NPC`, or `Type: Creature`. A system infobox draws from the system's fields, and a mapped system with no document says “Not available.” The same authored body appears in Foundry, on the website, and in the book; presentation adapts to each medium. [Infobox details](../reference/format-details.md#the-infobox) describe field order and empty values.

package/docs/guides/icons.md

@@ -58,6 +58,9 @@ it does not set a document's profile art. The
 [art-slot reference](../reference/format-details.md#the-four-art-slots) gives each
 slot's type and document destination.
 
+A being's `subType` selects its compiled default art: `character` and `npc`
+use person art, and `creature` uses creature art.
+
 ## Write an inline icon in prose
 
 Declare the glyph vocabulary in `package-build.config.yaml` or a separate YAML

package/docs/reference/format-details.md

@@ -101,6 +101,10 @@ column regardless.
 6. **Order is the toolchain's.** A medium renders boxes, sections and rows in
    the order given.
 
+A note profile begins with `Name`. For a being with a top-level `subType`, it
+follows with `Type: Character`, `Type: NPC`, or `Type: Creature`. A being with
+no subtype has no `Type` row.
+
 **Embedded models link to documentation in an infobox.** The model Address
 continues to identify the native Item used for compilation. Its displayed link
 uses that same package, type and Shortcode under `note`, which names the

package/engine/actor-compiler.mjs

@@ -448,9 +448,8 @@ export class SystemActorCompiler extends BasePackCompiler {
      * The actor's two pieces of art, resolved, with the being default beneath
      * them.
      *
-     * **The default follows the note's `subType`**, with tags as a compatibility
-     * fallback for content trees that have not migrated. Both addresses belong
-     * to the package that ships them. A tree whose index cannot answer an
+     * **The default follows the note's `subType`**. Both addresses belong to
+     * the package that ships them. A tree whose index cannot answer an
      * address — a dependency not yet fetched — falls through to the document
      * subtype's own default, so the document is never left with no art.
      *

package/engine/art-fields.mjs

@@ -45,7 +45,6 @@
  */
 
 import { encodeAddresses } from "./address-values.mjs";
-import { hasTag } from "./note-vocabulary.mjs";
 import { ASSET_SYSTEM, isAssetType } from "./asset-types.mjs";
 import { ASSETS_SEGMENT } from "./pathnames.mjs";
 import { isAssetRecord } from "./index-records.mjs";
@@ -231,7 +230,7 @@ export function artPathname(index, value, defaultType, accepts) {
 }
 
 /**
- * The art a being falls back to, by the kind it is tagged.
+ * The art a being falls back to, by its subtype.
  *
  * Both files ship in `sohl`, under `assets/icons/other/`, and both are named
  * here as addresses rather than as paths for the reason every art reference is:
@@ -239,8 +238,8 @@ export function artPathname(index, value, defaultType, accepts) {
  * package borrowing the default gets the same file the system ships.
  *
  * **Only the compiler can choose between them**, because only the compiler
- * reads the note's tags. A schema default is the last resort beneath this one,
- * and covers a world document created by hand, which no note describes.
+ * reads the note's subtype. A schema default is the last resort beneath this
+ * one, and covers a world document created by hand, which no note describes.
  *
  * @type {Readonly<Record<string, string>>}
  */
@@ -252,20 +251,16 @@ export const BEING_DEFAULT_ART = Object.freeze({
 /**
  * The default art address a being's subtype chooses, or `null`.
  *
- * An NPC and a character use person art; a creature uses creature art. The
- * tag lookup preserves defaults for package trees that have not migrated.
+ * An NPC and a character use person art; a creature uses creature art.
  *
  * @param {object} fm - The note's frontmatter.
- * @returns {string|null} The address, or `null` when no subtype or legacy tag applies.
+ * @returns {string|null} The address, or `null` when no subtype selects one.
  */
 export function beingDefaultArt(fm) {
     if (fm?.subType === "npc" || fm?.subType === "character") {
         return BEING_DEFAULT_ART.character;
     }
     if (fm?.subType === "creature") return BEING_DEFAULT_ART.creature;
-    for (const [tag, address] of Object.entries(BEING_DEFAULT_ART)) {
-        if (hasTag(fm, tag)) return address;
-    }
     return null;
 }
 

package/engine/infobox.mjs

@@ -187,6 +187,13 @@ export const NOTE_BOX_TITLE = "Profile";
 /** The note infobox's single section id. @type {string} */
 export const NOTE_SECTION_ID = "profile";
 
+/** @type {Readonly<Record<string, string>>} */
+const BEING_SUBTYPE_LABELS = Object.freeze({
+    npc: "NPC",
+    character: "Character",
+    creature: "Creature",
+});
+
 /**
  * What a **duration pair** is called.
  *
@@ -659,8 +666,9 @@ export function linkValue(ref, resolve, hint) {
  *
  * The rows are {@link NOTE_VOCABULARY}'s declaration for the type, in its
  * order, minus what {@link NOTE_FIELD_PRESENTATION} withholds and minus every
- * field the note left empty. A type that declares no `data:` fields still gets
- * the box, because `Name` is a fact about every note.
+ * field the note left empty. A being's top-level `subType` adds its profile
+ * type. A type that declares no `data:` fields still gets the box, because
+ * `Name` is a fact about every note.
  *
  * @param {object} fm - The note's frontmatter.
  * @param {object} [options] - Options.
@@ -698,6 +706,9 @@ function noteBox(
     const shown = new Set();
     const name = fm?.name?.full ?? fm?.title;
     if (hasValue(name)) rows.push({ label: "Name", kind: "text", value: String(name) });
+    if (fm?.type === "being" && Object.hasOwn(BEING_SUBTYPE_LABELS, fm.subType)) {
+        rows.push({ label: "Type", kind: "text", value: BEING_SUBTYPE_LABELS[fm.subType] });
+    }
 
     const data = isMapping(fm?.data) ? fm.data : {};
     /** @type {Map<string, {label: string, entries: string[]}>} */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@heroiclands/package-build",
-    "version": "22.17.2",
+    "version": "22.18.0",
     "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",

package/types/engine/actor-compiler.d.mts

@@ -230,9 +230,8 @@ export class SystemActorCompiler extends BasePackCompiler {
      * The actor's two pieces of art, resolved, with the being default beneath
      * them.
      *
-     * **The default follows the note's `subType`**, with tags as a compatibility
-     * fallback for content trees that have not migrated. Both addresses belong
-     * to the package that ships them. A tree whose index cannot answer an
+     * **The default follows the note's `subType`**. Both addresses belong to
+     * the package that ships them. A tree whose index cannot answer an
      * address — a dependency not yet fetched — falls through to the document
      * subtype's own default, so the document is never left with no art.
      *

package/types/engine/art-fields.d.mts

@@ -144,11 +144,10 @@ export function artPathname(index: object, value: unknown, defaultType: string,
 /**
  * The default art address a being's subtype chooses, or `null`.
  *
- * An NPC and a character use person art; a creature uses creature art. The
- * tag lookup preserves defaults for package trees that have not migrated.
+ * An NPC and a character use person art; a creature uses creature art.
  *
  * @param {object} fm - The note's frontmatter.
- * @returns {string|null} The address, or `null` when no subtype or legacy tag applies.
+ * @returns {string|null} The address, or `null` when no subtype selects one.
  */
 export function beingDefaultArt(fm: object): string | null;
 /**
@@ -180,7 +179,7 @@ export function unresolvedArtMessage(key: string, value: unknown): string;
 export function unacceptedArtMessage(key: string, value: unknown, type: string, accepts: Iterable<string>): string;
 export { ART_SLOTS } from "./art-slots.mjs";
 /**
- * The art a being falls back to, by the kind it is tagged.
+ * The art a being falls back to, by its subtype.
  *
  * Both files ship in `sohl`, under `assets/icons/other/`, and both are named
  * here as addresses rather than as paths for the reason every art reference is:
@@ -188,8 +187,8 @@ export { ART_SLOTS } from "./art-slots.mjs";
  * package borrowing the default gets the same file the system ships.
  *
  * **Only the compiler can choose between them**, because only the compiler
- * reads the note's tags. A schema default is the last resort beneath this one,
- * and covers a world document created by hand, which no note describes.
+ * reads the note's subtype. A schema default is the last resort beneath this
+ * one, and covers a world document created by hand, which no note describes.
  *
  * @type {Readonly<Record<string, string>>}
  */

package/types/engine/infobox.d.mts

@@ -146,8 +146,9 @@ export function linkValue(ref: unknown, resolve: (ref: unknown, hint?: object) =
  *
  * The rows are {@link NOTE_VOCABULARY}'s declaration for the type, in its
  * order, minus what {@link NOTE_FIELD_PRESENTATION} withholds and minus every
- * field the note left empty. A type that declares no `data:` fields still gets
- * the box, because `Name` is a fact about every note.
+ * field the note left empty. A being's top-level `subType` adds its profile
+ * type. A type that declares no `data:` fields still gets the box, because
+ * `Name` is a fact about every note.
  *
  * @param {object} fm - The note's frontmatter.
  * @param {object} [options] - Options.