@archivist-gg/dnd5e 0.3.5 → 0.3.6

package/dist/{chunk-UMWIPLLM.js → chunk-2BI5NAXK.js}

@@ -1,6 +1,6 @@
 import {
   featureSchema
-} from "./chunk-W74BCA7V.js";
+} from "./chunk-JOVMV2X5.js";
 import {
   choiceSchema
 } from "./chunk-IWRVOCT5.js";

package/dist/{chunk-V2MJE6NC.js → chunk-3BMVVNCS.js}

@@ -1,7 +1,7 @@
 import {
   MONSTER_KNOWN_KEYS,
   monsterSchema
-} from "./chunk-UQ3ZFCWD.js";
+} from "./chunk-A6YL53NC.js";
 
 // src/monster/monster.parser.ts
 import { parseYaml } from "@archivist-gg/core";

package/dist/{chunk-UXPGW4TI.js → chunk-4ISR76DH.js}

@@ -42,6 +42,8 @@ function toResolvedResource(r, fallbackName, owner) {
     ...r.die ? { die: r.die } : {},
     ...r.scales_at ? { scalesAt: r.scales_at } : {},
     ...((_b = r.recovery) == null ? void 0 : _b.length) ? { recovery: r.recovery.map(resolveRecovery) } : {},
+    ...r.rendering_hint ? { renderingHint: r.rendering_hint } : {},
+    ...r.surface ? { surface: r.surface } : {},
     owner
   };
 }
@@ -72,11 +74,14 @@ function resolveResourceIndex(resolved) {
         warnOnce(`pool-uses:${entry.slug}`, `optional feature "${entry.slug}" has a prose uses.max (${JSON.stringify(uses.max)}); no tracker`);
         continue;
       }
+      const pres = entry.entity;
       out.set(entry.slug, {
         id: entry.slug,
         name: entry.entity.name,
         reset: uses.recharge,
         maxFormula,
+        ...pres.rendering_hint ? { renderingHint: pres.rendering_hint } : {},
+        ...pres.surface ? { surface: pres.surface } : {},
         owner: { kind: "pool", poolId: pool.id, poolLabel: pool.label, source: { kind: "class", slug: classSlug, level: pool.anchorLevel } }
       });
     }

package/dist/{chunk-N3A5ICBO.js → chunk-7MRW4RTH.js}

@@ -1,6 +1,6 @@
 import {
   raceEntitySchema
-} from "./chunk-UMWIPLLM.js";
+} from "./chunk-2BI5NAXK.js";
 import {
   aliasFeatureListActionCost
 } from "./chunk-4U55VNC7.js";

package/dist/{chunk-WHVLNFTG.js → chunk-7WNQJAZW.js}

@@ -5,7 +5,7 @@ import {
   actionCostEnum,
   resetTriggerEnum,
   resourceConsumptionSchema
-} from "./chunk-YLL2QXY2.js";
+} from "./chunk-UA3I2YSO.js";
 import {
   featureEffectSchema
 } from "./chunk-X3D6LXUU.js";
@@ -33,7 +33,18 @@ var prerequisiteSchema = z.discriminatedUnion("kind", [
 ]);
 var usesSchema = z.object({
   max: z.union([z.number(), z.string()]),
-  recharge: resetTriggerEnum
+  recharge: resetTriggerEnum,
+  /** Partial recovery, for a pool a rest does NOT fully refill (a sanity track that regains 1 per long
+   *  rest). Same shape a feature's `resources[].recovery` uses, so `ResolvedResource.recovery` — which
+   *  has carried the field since R4-G4 — is populated identically from either side. Optional: all 35
+   *  shipped `uses` carriers omit it and parse unchanged. */
+  recovery: z.array(z.object({
+    id: z.string().min(1),
+    name: z.string().min(1),
+    amount: z.union([z.number(), z.string()]),
+    reset: resetTriggerEnum,
+    restores: z.enum(["uses", "spell-slots"]).optional()
+  })).optional()
 });
 var optionalFeatureEntitySchema = z.object({
   slug: z.string().min(1),
@@ -55,6 +66,12 @@ var optionalFeatureEntitySchema = z.object({
   activatable: z.boolean().optional(),
   rendering_hint: z.string().optional(),
   // the ONE root with load-bearing VALUES (88 records, G4's)
+  /** WHERE this resource is drawn. `band` puts it in the header strip beside HP; anything else, and the
+   *  default, leaves it to the Resources tab. The tab ALWAYS lists every resource — it is the complete
+   *  inventory of what the character can spend, and a row missing from it would read as a bug — so this
+   *  key only ever ADDS a second, curated home. Opt-in on purpose: the band's whole value is being short,
+   *  which an opt-out flag would erode one new grant at a time. */
+  surface: z.enum(["band", "tab"]).optional(),
   additional_spells: z.array(additionalSpellsEntrySchema).optional(),
   // 54
   is_class_feature_variant: z.boolean().optional(),

package/dist/{chunk-UQ3ZFCWD.js → chunk-A6YL53NC.js}

@@ -1,6 +1,6 @@
 import {
   featureObjectSchema
-} from "./chunk-W74BCA7V.js";
+} from "./chunk-JOVMV2X5.js";
 import {
   imageField
 } from "./chunk-UA5KS2PL.js";

package/dist/{chunk-KK33PIDN.js → chunk-ABQ6ZWAF.js}

@@ -1,6 +1,6 @@
 import {
   subclassEntitySchema
-} from "./chunk-OAXWSVJB.js";
+} from "./chunk-MT4RWROQ.js";
 import {
   aliasFeaturesByLevelActionCost
 } from "./chunk-4U55VNC7.js";

package/dist/{chunk-CV5XDJKU.js → chunk-B4TQTJVC.js}

@@ -1,6 +1,6 @@
 import {
   parseSubclass
-} from "./chunk-KK33PIDN.js";
+} from "./chunk-ABQ6ZWAF.js";
 
 // src/subclass/subclass.codec.ts
 import yaml from "js-yaml";

package/dist/{chunk-RVXC6ZHY.js → chunk-BJFL4KYG.js}

@@ -1,7 +1,7 @@
 import {
   actionCostEnum,
   resourceSchema
-} from "./chunk-YLL2QXY2.js";
+} from "./chunk-UA3I2YSO.js";
 import {
   choiceSchema
 } from "./chunk-IWRVOCT5.js";

package/dist/{chunk-EHDATXP7.js → chunk-BS355LND.js}

@@ -1,6 +1,6 @@
 import {
   parseClass
-} from "./chunk-5RKLL2AD.js";
+} from "./chunk-H4VEMVOO.js";
 
 // src/class/class.codec.ts
 import yaml from "js-yaml";

package/dist/{chunk-3JOTQW7A.js → chunk-CQAL67R3.js}

@@ -1,6 +1,6 @@
 import {
   parseRace
-} from "./chunk-N3A5ICBO.js";
+} from "./chunk-7MRW4RTH.js";
 
 // src/race/race.codec.ts
 import yaml from "js-yaml";

package/dist/{chunk-CGRLQ34U.js → chunk-DTCR4DBF.js}

@@ -8,10 +8,10 @@ import {
 } from "./chunk-CJYCVNW2.js";
 import {
   featureSchema
-} from "./chunk-W74BCA7V.js";
+} from "./chunk-JOVMV2X5.js";
 import {
   resourceSchema
-} from "./chunk-YLL2QXY2.js";
+} from "./chunk-UA3I2YSO.js";
 import {
   startingEquipmentEntrySchema,
   startingGoldSchema

package/dist/{chunk-I2NDWFDD.js → chunk-E4KG7HXO.js}

@@ -284,6 +284,15 @@ var characterSchema = z.object({
     gp: z.number().int().nonnegative(),
     pp: z.number().int().nonnegative()
   }).optional(),
+  /** Features granted directly to this character by the DM — a campaign boon, a sanity track, hero
+   *  points. Each entry names an `optional-feature` entity; the engine resolves it exactly the way a
+   *  pool pick resolves, but with no pool and no class choice behind it.
+   *
+   *  WHERE a grant is drawn is the declaring NOTE's business, not the character's: the note's
+   *  `surface: band` opts it into the header strip. A character-side opt-OUT flag lived here briefly
+   *  and was removed — two mechanisms for one job, and the opt-out eroded the band's shortness one
+   *  grant at a time. */
+  additional_features: z.array(z.string().min(1)).default([]),
   notes: z.string().optional(),
   defenses: z.object({
     resistances: z.array(z.string()).default([]),

package/dist/{chunk-2VDTW7QO.js → chunk-EYZCCWG2.js}

@@ -1,7 +1,7 @@
 import {
   resolveFeatureResources,
   resolveResourceIndex
-} from "./chunk-UXPGW4TI.js";
+} from "./chunk-4ISR76DH.js";
 import {
   attributeUnclassedSpell,
   effectiveSpellcastingAbility,
@@ -51,6 +51,9 @@ import {
   FEATURE_TYPE_FOR_CATEGORY,
   featProgressionCategory
 } from "./chunk-YBLDE5CG.js";
+import {
+  isValidMaxFormula
+} from "./chunk-EVMUJYUD.js";
 import {
   mirrorSpellShapes
 } from "./chunk-OZP6JFGT.js";
@@ -1089,6 +1092,7 @@ var PCResolver = class {
     const features = collectResolvedFeatures(race, classes, background, feats, featVia);
     const extraFeatures = collectChosenGrantedFeatures(character, classes, this.entities, race, background);
     features.push(...extraFeatures);
+    features.push(...collectAdditionalFeatures(character, this.entities, warnings));
     const casters = [];
     classes.forEach((c, i) => {
       const profile = c.entity ? resolveSpellcasting(c) : null;
@@ -1349,6 +1353,50 @@ function collectChosenGrantedFeatures(character, classes, registry, race = null,
   }
   return out;
 }
+function collectAdditionalFeatures(character, entities, warnings) {
+  var _a, _b, _c, _d, _e, _f, _g, _h;
+  const out = [];
+  for (const entry of (_a = character.additional_features) != null ? _a : []) {
+    const slug = (_b = stripSlug(entry)) != null ? _b : entry;
+    const reg = entities.getByTypeAndSlug("optional-feature", slug);
+    if (!reg) {
+      warnings.push(`Granted feature [[${slug}]] not found in compendium as optional-feature.`);
+      continue;
+    }
+    const d = reg.data;
+    const feature = {
+      id: (_c = d.slug) != null ? _c : slug,
+      name: (_d = d.name) != null ? _d : slug,
+      description: d.description,
+      ...((_e = d.effects) == null ? void 0 : _e.length) ? { effects: d.effects } : {},
+      ...d.action_cost ? { action: d.action_cost } : {},
+      ...d.passive !== void 0 ? { passive: d.passive } : {},
+      ...d.activatable !== void 0 ? { activatable: d.activatable } : {},
+      ...d.duration ? { duration: d.duration } : {},
+      ...d.consumes ? { consumes: d.consumes } : {}
+    };
+    const uses = d.uses;
+    if (uses) {
+      const maxFormula = String(uses.max);
+      if (isValidMaxFormula(maxFormula)) {
+        feature.resources = [{
+          id: (_f = d.slug) != null ? _f : slug,
+          name: (_g = d.name) != null ? _g : slug,
+          max_formula: maxFormula,
+          reset: uses.recharge,
+          ...((_h = uses.recovery) == null ? void 0 : _h.length) ? { recovery: uses.recovery } : {},
+          // Presentation rides the resource, so the band and the tab read one object.
+          ...d.rendering_hint ? { rendering_hint: d.rendering_hint } : {},
+          ...d.surface ? { surface: d.surface } : {}
+        }];
+      } else {
+        warnings.push(`Granted feature "${slug}" has a prose uses.max (${JSON.stringify(uses.max)}); no tracker.`);
+      }
+    }
+    out.push({ feature, source: { kind: "campaign", slug } });
+  }
+  return out;
+}
 function walkChoiceGrants(choices, atLevel, emit, registry) {
   var _a, _b, _c, _d, _e;
   for (const ch of choices != null ? choices : []) {
@@ -1570,6 +1618,7 @@ export {
   collectItemGrantedSpells,
   dedupeResolvedSpells,
   collectChosenGrantedFeatures,
+  collectAdditionalFeatures,
   collectResolvedFeatures,
   collectProficiencyGrants,
   __matchesFilterForTest,

package/dist/{chunk-5RKLL2AD.js → chunk-H4VEMVOO.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-4U55VNC7.js";
 import {
   classEntitySchema
-} from "./chunk-CGRLQ34U.js";
+} from "./chunk-DTCR4DBF.js";
 
 // src/class/class.parser.ts
 import { parseYaml } from "@archivist-gg/core";

package/dist/{chunk-Y4AGLCY6.js → chunk-JKLRBILX.js}

@@ -1,6 +1,6 @@
 import {
   parseFeat
-} from "./chunk-KADJZGZY.js";
+} from "./chunk-RWZTGMSN.js";
 
 // src/feat/feat.codec.ts
 import yaml from "js-yaml";

package/dist/{chunk-W74BCA7V.js → chunk-JOVMV2X5.js}

@@ -5,7 +5,7 @@ import {
   actionCostEnum,
   resourceConsumptionSchema,
   resourceSchema
-} from "./chunk-YLL2QXY2.js";
+} from "./chunk-UA3I2YSO.js";
 import {
   choiceSchema
 } from "./chunk-IWRVOCT5.js";

package/dist/{chunk-OAXWSVJB.js → chunk-MT4RWROQ.js}

@@ -8,10 +8,10 @@ import {
 } from "./chunk-CJYCVNW2.js";
 import {
   featureSchema
-} from "./chunk-W74BCA7V.js";
+} from "./chunk-JOVMV2X5.js";
 import {
   resourceSchema
-} from "./chunk-YLL2QXY2.js";
+} from "./chunk-UA3I2YSO.js";
 import {
   additionalSpellsEntrySchema,
   imageField,

package/dist/{chunk-RF4TYCA2.js → chunk-MYW7AOUE.js}

@@ -1,6 +1,6 @@
 import {
   parseOptionalFeature
-} from "./chunk-6BFWZW6T.js";
+} from "./chunk-NNAQ4KQF.js";
 
 // src/optional-feature/optional-feature.codec.ts
 import yaml from "js-yaml";

package/dist/{chunk-6BFWZW6T.js → chunk-NNAQ4KQF.js}

@@ -1,6 +1,6 @@
 import {
   optionalFeatureEntitySchema
-} from "./chunk-WHVLNFTG.js";
+} from "./chunk-7WNQJAZW.js";
 
 // src/optional-feature/optional-feature.parser.ts
 import { parseYaml } from "@archivist-gg/core";

package/dist/{chunk-KADJZGZY.js → chunk-RWZTGMSN.js}

@@ -1,6 +1,6 @@
 import {
   featEntitySchema
-} from "./chunk-RVXC6ZHY.js";
+} from "./chunk-BJFL4KYG.js";
 
 // src/feat/feat.parser.ts
 import { parseYaml } from "@archivist-gg/core";

package/dist/{chunk-YLL2QXY2.js → chunk-UA3I2YSO.js}

@@ -19,6 +19,10 @@ var resourceSchema = z.object({
     resource: z.string().min(1),
     amount: z.number().int().positive()
   }).optional(),
+  /** Presentation, carried and never interpreted by the engine: which control draws this resource, and
+   *  whether it also appears in the header band. The renderer owns the hint → component table. */
+  rendering_hint: z.string().optional(),
+  surface: z.enum(["band", "tab"]).optional(),
   recovery: z.array(z.object({
     id: z.string().min(1),
     name: z.string().min(1),

package/dist/class/class.codec.js

@@ -1,14 +1,14 @@
 import {
   classCodec
-} from "../chunk-EHDATXP7.js";
-import "../chunk-5RKLL2AD.js";
+} from "../chunk-BS355LND.js";
+import "../chunk-H4VEMVOO.js";
 import "../chunk-4U55VNC7.js";
-import "../chunk-CGRLQ34U.js";
+import "../chunk-DTCR4DBF.js";
 import "../chunk-23LZLBJK.js";
 import "../chunk-CJYCVNW2.js";
-import "../chunk-W74BCA7V.js";
+import "../chunk-JOVMV2X5.js";
 import "../chunk-WYGD2UGN.js";
-import "../chunk-YLL2QXY2.js";
+import "../chunk-UA3I2YSO.js";
 import "../chunk-IN4M4X7P.js";
 import "../chunk-IWRVOCT5.js";
 import "../chunk-X3D6LXUU.js";

package/dist/class/class.parser.js

@@ -1,13 +1,13 @@
 import {
   parseClass
-} from "../chunk-5RKLL2AD.js";
+} from "../chunk-H4VEMVOO.js";
 import "../chunk-4U55VNC7.js";
-import "../chunk-CGRLQ34U.js";
+import "../chunk-DTCR4DBF.js";
 import "../chunk-23LZLBJK.js";
 import "../chunk-CJYCVNW2.js";
-import "../chunk-W74BCA7V.js";
+import "../chunk-JOVMV2X5.js";
 import "../chunk-WYGD2UGN.js";
-import "../chunk-YLL2QXY2.js";
+import "../chunk-UA3I2YSO.js";
 import "../chunk-IN4M4X7P.js";
 import "../chunk-IWRVOCT5.js";
 import "../chunk-X3D6LXUU.js";

package/dist/class/class.schema.d.ts

@@ -146,6 +146,11 @@ export declare const classEntitySchema: z.ZodObject<{
             resource: z.ZodString;
             amount: z.ZodNumber;
         }, z.core.$strip>>;
+        rendering_hint: z.ZodOptional<z.ZodString>;
+        surface: z.ZodOptional<z.ZodEnum<{
+            band: "band";
+            tab: "tab";
+        }>>;
         recovery: z.ZodOptional<z.ZodArray<z.ZodObject<{
             id: z.ZodString;
             name: z.ZodString;

package/dist/class/class.schema.js

@@ -1,11 +1,11 @@
 import {
   classEntitySchema
-} from "../chunk-CGRLQ34U.js";
+} from "../chunk-DTCR4DBF.js";
 import "../chunk-23LZLBJK.js";
 import "../chunk-CJYCVNW2.js";
-import "../chunk-W74BCA7V.js";
+import "../chunk-JOVMV2X5.js";
 import "../chunk-WYGD2UGN.js";
-import "../chunk-YLL2QXY2.js";
+import "../chunk-UA3I2YSO.js";
 import "../chunk-IN4M4X7P.js";
 import "../chunk-IWRVOCT5.js";
 import "../chunk-X3D6LXUU.js";

package/dist/feat/feat.codec.js

@@ -1,9 +1,9 @@
 import {
   featCodec
-} from "../chunk-Y4AGLCY6.js";
-import "../chunk-KADJZGZY.js";
-import "../chunk-RVXC6ZHY.js";
-import "../chunk-YLL2QXY2.js";
+} from "../chunk-JKLRBILX.js";
+import "../chunk-RWZTGMSN.js";
+import "../chunk-BJFL4KYG.js";
+import "../chunk-UA3I2YSO.js";
 import "../chunk-IWRVOCT5.js";
 import "../chunk-X3D6LXUU.js";
 import "../chunk-UA5KS2PL.js";

package/dist/feat/feat.parser.js

@@ -1,8 +1,8 @@
 import {
   parseFeat
-} from "../chunk-KADJZGZY.js";
-import "../chunk-RVXC6ZHY.js";
-import "../chunk-YLL2QXY2.js";
+} from "../chunk-RWZTGMSN.js";
+import "../chunk-BJFL4KYG.js";
+import "../chunk-UA3I2YSO.js";
 import "../chunk-IWRVOCT5.js";
 import "../chunk-X3D6LXUU.js";
 import "../chunk-UA5KS2PL.js";

package/dist/feat/feat.schema.d.ts

@@ -394,6 +394,11 @@ export declare const featEntitySchema: z.ZodObject<{
             resource: z.ZodString;
             amount: z.ZodNumber;
         }, z.core.$strip>>;
+        rendering_hint: z.ZodOptional<z.ZodString>;
+        surface: z.ZodOptional<z.ZodEnum<{
+            band: "band";
+            tab: "tab";
+        }>>;
         recovery: z.ZodOptional<z.ZodArray<z.ZodObject<{
             id: z.ZodString;
             name: z.ZodString;

package/dist/feat/feat.schema.js

@@ -1,7 +1,7 @@
 import {
   featEntitySchema
-} from "../chunk-RVXC6ZHY.js";
-import "../chunk-YLL2QXY2.js";
+} from "../chunk-BJFL4KYG.js";
+import "../chunk-UA3I2YSO.js";
 import "../chunk-IWRVOCT5.js";
 import "../chunk-X3D6LXUU.js";
 import "../chunk-UA5KS2PL.js";

package/dist/index.js

@@ -5,9 +5,9 @@ import "./chunk-HZA7OE7N.js";
 import "./chunk-2DFENQIJ.js";
 import {
   subclassCodec
-} from "./chunk-CV5XDJKU.js";
-import "./chunk-KK33PIDN.js";
-import "./chunk-OAXWSVJB.js";
+} from "./chunk-B4TQTJVC.js";
+import "./chunk-ABQ6ZWAF.js";
+import "./chunk-MT4RWROQ.js";
 import {
   spellInputSchema
 } from "./chunk-656QCX4U.js";
@@ -19,9 +19,9 @@ import {
 } from "./chunk-WSVMLNTO.js";
 import {
   raceCodec
-} from "./chunk-3JOTQW7A.js";
-import "./chunk-N3A5ICBO.js";
-import "./chunk-UMWIPLLM.js";
+} from "./chunk-CQAL67R3.js";
+import "./chunk-7MRW4RTH.js";
+import "./chunk-2BI5NAXK.js";
 import "./chunk-OZP6JFGT.js";
 import "./chunk-VQAXTIBW.js";
 import {
@@ -34,14 +34,14 @@ import {
 } from "./chunk-6PXTNCBP.js";
 import {
   parseMonster
-} from "./chunk-V2MJE6NC.js";
-import "./chunk-UQ3ZFCWD.js";
+} from "./chunk-3BMVVNCS.js";
+import "./chunk-A6YL53NC.js";
 import "./chunk-IKSMX4TN.js";
 import {
   optionalFeatureCodec
-} from "./chunk-RF4TYCA2.js";
-import "./chunk-6BFWZW6T.js";
-import "./chunk-WHVLNFTG.js";
+} from "./chunk-MYW7AOUE.js";
+import "./chunk-NNAQ4KQF.js";
+import "./chunk-7WNQJAZW.js";
 import {
   itemCodec
 } from "./chunk-4XTNPNQB.js";
@@ -64,23 +64,23 @@ import {
 } from "./chunk-LSLSG67V.js";
 import {
   featCodec
-} from "./chunk-Y4AGLCY6.js";
-import "./chunk-KADJZGZY.js";
-import "./chunk-RVXC6ZHY.js";
+} from "./chunk-JKLRBILX.js";
+import "./chunk-RWZTGMSN.js";
+import "./chunk-BJFL4KYG.js";
 import "./chunk-DEEHHLAP.js";
 import "./chunk-PDJSUH24.js";
 import "./chunk-WELIKLZF.js";
 import {
   classCodec
-} from "./chunk-EHDATXP7.js";
-import "./chunk-5RKLL2AD.js";
+} from "./chunk-BS355LND.js";
+import "./chunk-H4VEMVOO.js";
 import "./chunk-4U55VNC7.js";
-import "./chunk-CGRLQ34U.js";
+import "./chunk-DTCR4DBF.js";
 import "./chunk-23LZLBJK.js";
 import "./chunk-CJYCVNW2.js";
-import "./chunk-W74BCA7V.js";
+import "./chunk-JOVMV2X5.js";
 import "./chunk-WYGD2UGN.js";
-import "./chunk-YLL2QXY2.js";
+import "./chunk-UA3I2YSO.js";
 import {
   parseCondition
 } from "./chunk-6X2NV665.js";

package/dist/monster/monster.parser.js

@@ -1,11 +1,11 @@
 import {
   migrateLegacy,
   parseMonster
-} from "../chunk-V2MJE6NC.js";
-import "../chunk-UQ3ZFCWD.js";
-import "../chunk-W74BCA7V.js";
+} from "../chunk-3BMVVNCS.js";
+import "../chunk-A6YL53NC.js";
+import "../chunk-JOVMV2X5.js";
 import "../chunk-WYGD2UGN.js";
-import "../chunk-YLL2QXY2.js";
+import "../chunk-UA3I2YSO.js";
 import "../chunk-IWRVOCT5.js";
 import "../chunk-X3D6LXUU.js";
 import "../chunk-UA5KS2PL.js";

package/dist/monster/monster.schema.js

@@ -11,10 +11,10 @@ import {
   monsterSpeedSchema,
   monsterSpellcastingSchema,
   monsterTypeSchema
-} from "../chunk-UQ3ZFCWD.js";
-import "../chunk-W74BCA7V.js";
+} from "../chunk-A6YL53NC.js";
+import "../chunk-JOVMV2X5.js";
 import "../chunk-WYGD2UGN.js";
-import "../chunk-YLL2QXY2.js";
+import "../chunk-UA3I2YSO.js";
 import "../chunk-IWRVOCT5.js";
 import "../chunk-X3D6LXUU.js";
 import "../chunk-UA5KS2PL.js";

package/dist/optional-feature/optional-feature.codec.js

@@ -1,10 +1,10 @@
 import {
   optionalFeatureCodec
-} from "../chunk-RF4TYCA2.js";
-import "../chunk-6BFWZW6T.js";
-import "../chunk-WHVLNFTG.js";
+} from "../chunk-MYW7AOUE.js";
+import "../chunk-NNAQ4KQF.js";
+import "../chunk-7WNQJAZW.js";
 import "../chunk-WYGD2UGN.js";
-import "../chunk-YLL2QXY2.js";
+import "../chunk-UA3I2YSO.js";
 import "../chunk-X3D6LXUU.js";
 import "../chunk-UA5KS2PL.js";
 export {

package/dist/optional-feature/optional-feature.parser.js

@@ -1,9 +1,9 @@
 import {
   parseOptionalFeature
-} from "../chunk-6BFWZW6T.js";
-import "../chunk-WHVLNFTG.js";
+} from "../chunk-NNAQ4KQF.js";
+import "../chunk-7WNQJAZW.js";
 import "../chunk-WYGD2UGN.js";
-import "../chunk-YLL2QXY2.js";
+import "../chunk-UA3I2YSO.js";
 import "../chunk-X3D6LXUU.js";
 import "../chunk-UA5KS2PL.js";
 export {

package/dist/optional-feature/optional-feature.schema.d.ts

@@ -342,6 +342,25 @@ export declare const optionalFeatureEntitySchema: z.ZodObject<{
             round: "round";
             custom: "custom";
         }>;
+        recovery: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            amount: z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>;
+            reset: z.ZodEnum<{
+                "short-rest": "short-rest";
+                "long-rest": "long-rest";
+                either: "either";
+                dawn: "dawn";
+                dusk: "dusk";
+                turn: "turn";
+                round: "round";
+                custom: "custom";
+            }>;
+            restores: z.ZodOptional<z.ZodEnum<{
+                uses: "uses";
+                "spell-slots": "spell-slots";
+            }>>;
+        }, z.core.$strip>>>;
     }, z.core.$strip>>>;
     consumes: z.ZodOptional<z.ZodNullable<z.ZodObject<{
         source: z.ZodOptional<z.ZodEnum<{
@@ -386,6 +405,10 @@ export declare const optionalFeatureEntitySchema: z.ZodObject<{
     passive: z.ZodOptional<z.ZodBoolean>;
     activatable: z.ZodOptional<z.ZodBoolean>;
     rendering_hint: z.ZodOptional<z.ZodString>;
+    surface: z.ZodOptional<z.ZodEnum<{
+        band: "band";
+        tab: "tab";
+    }>>;
     additional_spells: z.ZodOptional<z.ZodArray<z.ZodObject<{
         name: z.ZodOptional<z.ZodString>;
         ability: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{

package/dist/optional-feature/optional-feature.schema.js

@@ -1,8 +1,8 @@
 import {
   optionalFeatureEntitySchema
-} from "../chunk-WHVLNFTG.js";
+} from "../chunk-7WNQJAZW.js";
 import "../chunk-WYGD2UGN.js";
-import "../chunk-YLL2QXY2.js";
+import "../chunk-UA3I2YSO.js";
 import "../chunk-X3D6LXUU.js";
 import "../chunk-UA5KS2PL.js";
 export {

package/dist/pc/pc.decision-engine.js

@@ -4,8 +4,8 @@ import {
   collectChosenAbilityPoints,
   collectChosenProficiencies,
   computeEffectiveProficiencies
-} from "../chunk-2VDTW7QO.js";
-import "../chunk-UXPGW4TI.js";
+} from "../chunk-EYZCCWG2.js";
+import "../chunk-4ISR76DH.js";
 import "../chunk-DPUJDOKV.js";
 import "../chunk-O4SRD3J5.js";
 import "../chunk-PP2UHLBA.js";

package/dist/pc/pc.parser.js

@@ -1,6 +1,6 @@
 import {
   characterSchema
-} from "../chunk-I2NDWFDD.js";
+} from "../chunk-E4KG7HXO.js";
 import "../chunk-S7REMWW4.js";
 
 // src/pc/pc.parser.ts

package/dist/pc/pc.proficiencies.js

@@ -2,8 +2,8 @@ import {
   collectChosenProficiencies,
   collectProficiencyGrants,
   computeEffectiveProficiencies
-} from "../chunk-2VDTW7QO.js";
-import "../chunk-UXPGW4TI.js";
+} from "../chunk-EYZCCWG2.js";
+import "../chunk-4ISR76DH.js";
 import "../chunk-DPUJDOKV.js";
 import "../chunk-O4SRD3J5.js";
 import "../chunk-PP2UHLBA.js";

package/dist/pc/pc.recalc.js

@@ -4,10 +4,10 @@ import {
 import {
   collectChosenAbilityPoints,
   collectChosenProficiencies
-} from "../chunk-2VDTW7QO.js";
+} from "../chunk-EYZCCWG2.js";
 import {
   resourceLevelFor
-} from "../chunk-UXPGW4TI.js";
+} from "../chunk-4ISR76DH.js";
 import {
   computeSpellLimits,
   deriveSpellSlots,

package/dist/pc/pc.resolver.d.ts

@@ -127,4 +127,18 @@ export declare function collectChosenGrantedFeatures(character: Character, class
         data: Record<string, unknown>;
     } | undefined;
 }, race?: RaceEntity | null, background?: BackgroundEntity | null): ResolvedFeature[];
+/**
+ * `character.additional_features` → ResolvedFeatures (the DM-grant path).
+ *
+ * Deliberately NOT routed through `walkChoiceGrants`: that converter emits
+ * `{id, name, description, effects, action}` and DROPS `uses`, which is correct there because a pool
+ * pick's tracker is built separately by `resolveResourceIndex`'s pools loop. A campaign grant has no
+ * pool, so nothing would ever build its tracker — the feature would render as a card with no counter.
+ * This walk therefore converts `uses` into the feature's own `resources[]`, which
+ * `resolveFeatureResources` already indexes, and the grant gets a tracker with no pool involved.
+ *
+ * A prose `uses.max` (the 4 shipped carriers that have one) yields no resource rather than a broken
+ * tracker, matching the pools loop's rule; the feature still renders.
+ */
+export declare function collectAdditionalFeatures(character: Character, entities: EntityRegistry, warnings: string[]): ResolvedFeature[];
 export declare function collectResolvedFeatures(race: RaceEntity | null, classes: ResolvedClass[], background: BackgroundEntity | null, feats: FeatEntity[], featVia?: ReadonlyMap<string, FeatVia>): ResolvedFeature[];

package/dist/pc/pc.resolver.js

@@ -1,5 +1,6 @@
 import {
   PCResolver,
+  collectAdditionalFeatures,
   collectChosenGrantedFeatures,
   collectChosenWeaponMasteries,
   collectFeatGrantedSpells,
@@ -9,8 +10,8 @@ import {
   dedupeResolvedSpells,
   resolveOriginFeat,
   stripSlug
-} from "../chunk-2VDTW7QO.js";
-import "../chunk-UXPGW4TI.js";
+} from "../chunk-EYZCCWG2.js";
+import "../chunk-4ISR76DH.js";
 import "../chunk-DPUJDOKV.js";
 import "../chunk-O4SRD3J5.js";
 import "../chunk-PP2UHLBA.js";
@@ -37,6 +38,7 @@ import "../chunk-4U55VNC7.js";
 import "../chunk-UA5KS2PL.js";
 export {
   PCResolver,
+  collectAdditionalFeatures,
   collectChosenGrantedFeatures,
   collectChosenWeaponMasteries,
   collectFeatGrantedSpells,

package/dist/pc/pc.resource-seed.js

@@ -1,6 +1,6 @@
 import {
   resourceLevelFor
-} from "../chunk-UXPGW4TI.js";
+} from "../chunk-4ISR76DH.js";
 import "../chunk-DPUJDOKV.js";
 import {
   numericColumnsAt

package/dist/pc/pc.resources.d.ts

@@ -50,6 +50,12 @@ export interface ResolvedResource {
     scalesAt?: ResourceScaleStep[];
     recovery?: ResolvedRecovery[];
     owner: ResourceOwner;
+    /** Which control draws this resource — the declaring note's `rendering_hint`, carried verbatim and
+     *  never interpreted here. The renderer owns the hint → component table; the engine only delivers the
+     *  string, so adding a component is a change in ONE table and adding a resource is no code at all. */
+    renderingHint?: string;
+    /** `band` = also drawn in the header strip. Absent = the Resources tab alone. */
+    surface?: "band" | "tab";
 }
 export type ResourceIndex = ReadonlyMap<string, ResolvedResource>;
 /** KIND first (the schema key; absent = `uses`, UR2), FLAVOUR second (`action` / `reset`): a

package/dist/pc/pc.resources.js

@@ -4,7 +4,7 @@ import {
   resolveRecovery,
   resolveResourceIndex,
   resourceLevelFor
-} from "../chunk-UXPGW4TI.js";
+} from "../chunk-4ISR76DH.js";
 import "../chunk-DPUJDOKV.js";
 import "../chunk-IUAAXXNO.js";
 import "../chunk-LVQLWRCU.js";

package/dist/pc/pc.rest.js

@@ -1,6 +1,6 @@
 import {
   resolveResourceIndex
-} from "../chunk-UXPGW4TI.js";
+} from "../chunk-4ISR76DH.js";
 import "../chunk-DPUJDOKV.js";
 import "../chunk-IUAAXXNO.js";
 import "../chunk-LVQLWRCU.js";

package/dist/pc/pc.schema.d.ts

@@ -389,6 +389,7 @@ export declare const characterSchema: z.ZodObject<{
         gp: z.ZodNumber;
         pp: z.ZodNumber;
     }, z.core.$strip>>;
+    additional_features: z.ZodDefault<z.ZodArray<z.ZodString>>;
     notes: z.ZodOptional<z.ZodString>;
     defenses: z.ZodOptional<z.ZodObject<{
         resistances: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString>>>;

package/dist/pc/pc.schema.js

@@ -1,7 +1,7 @@
 import {
   characterOverridesShape,
   characterSchema
-} from "../chunk-I2NDWFDD.js";
+} from "../chunk-E4KG7HXO.js";
 import "../chunk-S7REMWW4.js";
 export {
   characterOverridesShape,

package/dist/pc/pc.types.d.ts

@@ -279,6 +279,9 @@ export interface Character {
         gp: number;
         pp: number;
     };
+    /** DM grants: optional-feature slugs resolved onto the character with no class, level or pool behind
+     *  them. Placement is the declaring note's `surface`, never a flag here. */
+    additional_features?: string[];
     notes?: string;
     defenses?: {
         resistances?: string[];
@@ -317,6 +320,11 @@ export type FeatureSource = {
     kind: "feat";
     slug: string;
     via?: FeatVia;
+}
+/** A DM grant listed in `character.additional_features`. No class, no level, no pool behind it. */
+ | {
+    kind: "campaign";
+    slug: string;
 };
 export interface ResolvedFeature {
     feature: Feature;

package/dist/race/race.codec.js

@@ -1,12 +1,12 @@
 import {
   raceCodec
-} from "../chunk-3JOTQW7A.js";
-import "../chunk-N3A5ICBO.js";
-import "../chunk-UMWIPLLM.js";
+} from "../chunk-CQAL67R3.js";
+import "../chunk-7MRW4RTH.js";
+import "../chunk-2BI5NAXK.js";
 import "../chunk-4U55VNC7.js";
-import "../chunk-W74BCA7V.js";
+import "../chunk-JOVMV2X5.js";
 import "../chunk-WYGD2UGN.js";
-import "../chunk-YLL2QXY2.js";
+import "../chunk-UA3I2YSO.js";
 import "../chunk-IWRVOCT5.js";
 import "../chunk-X3D6LXUU.js";
 import "../chunk-UA5KS2PL.js";

package/dist/race/race.parser.js

@@ -1,11 +1,11 @@
 import {
   parseRace
-} from "../chunk-N3A5ICBO.js";
-import "../chunk-UMWIPLLM.js";
+} from "../chunk-7MRW4RTH.js";
+import "../chunk-2BI5NAXK.js";
 import "../chunk-4U55VNC7.js";
-import "../chunk-W74BCA7V.js";
+import "../chunk-JOVMV2X5.js";
 import "../chunk-WYGD2UGN.js";
-import "../chunk-YLL2QXY2.js";
+import "../chunk-UA3I2YSO.js";
 import "../chunk-IWRVOCT5.js";
 import "../chunk-X3D6LXUU.js";
 import "../chunk-UA5KS2PL.js";

package/dist/race/race.schema.js

@@ -1,10 +1,10 @@
 import {
   fixedAsiSchema,
   raceEntitySchema
-} from "../chunk-UMWIPLLM.js";
-import "../chunk-W74BCA7V.js";
+} from "../chunk-2BI5NAXK.js";
+import "../chunk-JOVMV2X5.js";
 import "../chunk-WYGD2UGN.js";
-import "../chunk-YLL2QXY2.js";
+import "../chunk-UA3I2YSO.js";
 import "../chunk-IWRVOCT5.js";
 import "../chunk-X3D6LXUU.js";
 import "../chunk-UA5KS2PL.js";

package/dist/schemas/feature-schema.js

@@ -1,9 +1,9 @@
 import {
   featureObjectSchema,
   featureSchema
-} from "../chunk-W74BCA7V.js";
+} from "../chunk-JOVMV2X5.js";
 import "../chunk-WYGD2UGN.js";
-import "../chunk-YLL2QXY2.js";
+import "../chunk-UA3I2YSO.js";
 import "../chunk-IWRVOCT5.js";
 import "../chunk-X3D6LXUU.js";
 export {

package/dist/schemas/resource-schema.d.ts

@@ -42,6 +42,11 @@ export declare const resourceSchema: z.ZodObject<{
         resource: z.ZodString;
         amount: z.ZodNumber;
     }, z.core.$strip>>;
+    rendering_hint: z.ZodOptional<z.ZodString>;
+    surface: z.ZodOptional<z.ZodEnum<{
+        band: "band";
+        tab: "tab";
+    }>>;
     recovery: z.ZodOptional<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         name: z.ZodString;

package/dist/schemas/resource-schema.js

@@ -3,7 +3,7 @@ import {
   resetTriggerEnum,
   resourceConsumptionSchema,
   resourceSchema
-} from "../chunk-YLL2QXY2.js";
+} from "../chunk-UA3I2YSO.js";
 export {
   actionCostEnum,
   resetTriggerEnum,

package/dist/subclass/subclass.codec.js

@@ -1,14 +1,14 @@
 import {
   subclassCodec
-} from "../chunk-CV5XDJKU.js";
-import "../chunk-KK33PIDN.js";
-import "../chunk-OAXWSVJB.js";
+} from "../chunk-B4TQTJVC.js";
+import "../chunk-ABQ6ZWAF.js";
+import "../chunk-MT4RWROQ.js";
 import "../chunk-4U55VNC7.js";
 import "../chunk-23LZLBJK.js";
 import "../chunk-CJYCVNW2.js";
-import "../chunk-W74BCA7V.js";
+import "../chunk-JOVMV2X5.js";
 import "../chunk-WYGD2UGN.js";
-import "../chunk-YLL2QXY2.js";
+import "../chunk-UA3I2YSO.js";
 import "../chunk-IWRVOCT5.js";
 import "../chunk-X3D6LXUU.js";
 import "../chunk-UA5KS2PL.js";

package/dist/subclass/subclass.parser.js

@@ -1,13 +1,13 @@
 import {
   parseSubclass
-} from "../chunk-KK33PIDN.js";
-import "../chunk-OAXWSVJB.js";
+} from "../chunk-ABQ6ZWAF.js";
+import "../chunk-MT4RWROQ.js";
 import "../chunk-4U55VNC7.js";
 import "../chunk-23LZLBJK.js";
 import "../chunk-CJYCVNW2.js";
-import "../chunk-W74BCA7V.js";
+import "../chunk-JOVMV2X5.js";
 import "../chunk-WYGD2UGN.js";
-import "../chunk-YLL2QXY2.js";
+import "../chunk-UA3I2YSO.js";
 import "../chunk-IWRVOCT5.js";
 import "../chunk-X3D6LXUU.js";
 import "../chunk-UA5KS2PL.js";

package/dist/subclass/subclass.schema.d.ts

@@ -61,6 +61,11 @@ export declare const subclassEntitySchema: z.ZodObject<{
             resource: z.ZodString;
             amount: z.ZodNumber;
         }, z.core.$strip>>;
+        rendering_hint: z.ZodOptional<z.ZodString>;
+        surface: z.ZodOptional<z.ZodEnum<{
+            band: "band";
+            tab: "tab";
+        }>>;
         recovery: z.ZodOptional<z.ZodArray<z.ZodObject<{
             id: z.ZodString;
             name: z.ZodString;

package/dist/subclass/subclass.schema.js

@@ -1,11 +1,11 @@
 import {
   subclassEntitySchema
-} from "../chunk-OAXWSVJB.js";
+} from "../chunk-MT4RWROQ.js";
 import "../chunk-23LZLBJK.js";
 import "../chunk-CJYCVNW2.js";
-import "../chunk-W74BCA7V.js";
+import "../chunk-JOVMV2X5.js";
 import "../chunk-WYGD2UGN.js";
-import "../chunk-YLL2QXY2.js";
+import "../chunk-UA3I2YSO.js";
 import "../chunk-IWRVOCT5.js";
 import "../chunk-X3D6LXUU.js";
 import "../chunk-UA5KS2PL.js";

package/dist/types/optional-feature.types.d.ts

@@ -78,6 +78,8 @@ export interface OptionalFeatureEntity {
      *  `rendering_hint` is the ONE of these whose VALUES are load-bearing (88 records carry a
      *  real marker such as `dice-pool`); reading it is G4's row, declaring it is this one's. */
     rendering_hint?: string;
+    /** `band` = also drawn in the header strip. Absent/`tab` = the Resources tab only. */
+    surface?: "band" | "tab";
     additional_spells?: AdditionalSpellsEntry[];
     is_class_feature_variant?: boolean;
     has_fluff_images?: boolean;

package/dist/types/resource.d.ts

@@ -41,6 +41,11 @@ export interface Resource {
     scales_at?: ResourceScaleStep[];
     die?: ResourceDie;
     reset: ResetTrigger;
+    /** Presentation, carried and never interpreted by the engine: which control draws this resource.
+     *  The renderer owns the hint → component table. */
+    rendering_hint?: string;
+    /** `band` = also drawn in the header strip; absent = the Resources tab alone. */
+    surface?: "band" | "tab";
     consumes?: ResourceConsumesLink;
     recovery?: ResourceRecovery[];
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@archivist-gg/dnd5e",
-  "version": "0.3.5",
+  "version": "0.3.6",
   "license": "MIT AND CC-BY-4.0",
   "type": "module",
   "publishConfig": {