@gmb/bitmark-parser-generator 5.39.0 → 5.40.0

package/dist/index.cjs

@@ -81,6 +81,8 @@ var BitType = {
   // Used to indicate a bit is commented out
   _standard: "_standard",
   // Not to be used as a bit, but as a base for other bit types
+  _standardLight: "_standard-light",
+  // PLAN-021: lightweight base (minimal tag set), not to be used as a bit
   advertising: "advertising",
   advertisingAdvertorial: "advertising-advertorial",
   advertisingAdvertorialPage: "advertising-advertorial-page",
@@ -368,6 +370,7 @@ var BitType = {
   handInSystemMedia: "hand-in-system-media",
   handInVideo: "hand-in-video",
   handInVoice: "hand-in-voice",
+  h: "h",
   help: "help",
   helpAlt: "help-alt",
   highlightText: "highlight-text",
@@ -453,6 +456,7 @@ var BitType = {
   leWatchVideoEmbed: "le-watch-video-embed",
   lifeSkillSticker: "life-skill-sticker",
   list: "list",
+  listAlt: "list-alt",
   listItem: "list-item",
   mark: "mark",
   match: "match",
@@ -483,6 +487,8 @@ var BitType = {
   notebookArticle: "notebook-article",
   noteCollapsible: "note-collapsible",
   output: "output",
+  p: "p",
+  pAlt: "p-alt",
   page: "page",
   pageAcademy: "page-academy",
   pageArticle: "page-article",
@@ -605,6 +611,7 @@ var BitType = {
   smartStandardNoteNonNormativeCollapsible: "smart-standard-note-non-normative-collapsible",
   smartStandardNoteNormative: "smart-standard-note-normative",
   smartStandardNoteNormativeCollapsible: "smart-standard-note-normative-collapsible",
+  smartStandardP: "smart-standard-p",
   smartStandardRemarkLegend: "smart-standard-remark-legend",
   smartStandardRemarkLegendNonNormative: "smart-standard-remark-legend-non-normative",
   smartStandardRemarkLegendNormative: "smart-standard-remark-legend-normative",
@@ -1574,6 +1581,8 @@ var import_superenum12 = require("@ncoderz/superenum");
 var groupKeys = {
   group_accessibilityDecorative: "group_accessibilityDecorative",
   group_standardAllBits: "group_standardAllBits",
+  group_standardExample: "group_standardExample",
+  group_standardItem: "group_standardItem",
   group_standardItemLead: "group_standardItemLead",
   group_standardItemLeadInstructionHint: "group_standardItemLeadInstructionHint",
   group_standardInstructionHint: "group_standardInstructionHint",
@@ -5073,6 +5082,31 @@ var GROUPS = {
       }
     ]
   },
+  [ConfigKey.group_standardExample]: {
+    type: GroupConfigType.standard,
+    description: "PLAN-021: Standard group for the bit-level example property only. Mirror of the group_standardTags property_example entry, used by the lightweight bits (_standardLight).",
+    tags: [
+      {
+        key: ConfigKey.property_example,
+        exportJsonKey: [{ "@keyonly": {} }, { "@absent": { isExample: true } }, { example: "$" }],
+        description: "The example(s) for the bit",
+        format: TagFormat.bitmarkText,
+        nullable: true
+      }
+    ]
+  },
+  [ConfigKey.group_standardItem]: {
+    type: GroupConfigType.standard,
+    description: "PLAN-021: Standard group for the item tag ONLY (no lead/pageNumber/marginNumber chain). Used by the lightweight bits (_standardLight).",
+    tags: [
+      {
+        key: ConfigKey.tag_item,
+        jsonKey: "item",
+        exportJsonKey: { item: "$" },
+        description: "The item for the bit"
+      }
+    ]
+  },
   [ConfigKey.group_standardItemLead]: {
     type: GroupConfigType.standard,
     description: "Standard group for item, lead, page number, and margin number tags",
@@ -7876,6 +7910,25 @@ var BITS = {
       }
     ]
   },
+  [BitType._standardLight]: {
+    since: "5.40.0",
+    description: "PLAN-021: Lightweight standard base bit with a minimal tag set (item + example only \u2014 no instruction/hint/lead, no resource attachments), used as a base for other bits, should not be used directly",
+    resourceAttachmentAllowed: false,
+    tags: [
+      {
+        key: ConfigKey.group_standardAllBits,
+        description: "Standard tags for all bits"
+      },
+      {
+        key: ConfigKey.group_standardItem,
+        description: "The item tag (no lead/pageNumber/marginNumber chain)"
+      },
+      {
+        key: ConfigKey.group_standardExample,
+        description: "The bit-level example property"
+      }
+    ]
+  },
   [BitType.appFlashcards]: {
     since: "1.3.0",
     title: "Flashcards",
@@ -10703,6 +10756,23 @@ var BITS = {
     baseBitType: BitType.article,
     description: "Glossary term bit, used to define glossary terms in articles or books"
   },
+  [BitType.h]: {
+    since: "5.40.0",
+    title: "Heading",
+    bitGroups: [BitGroup.static],
+    baseBitType: BitType._standardLight,
+    description: "Lightweight heading bit with chapter-style title levels 1-7; title/level + item only \u2014 no body, no footer",
+    bodyAllowed: false,
+    footerAllowed: false,
+    tags: [
+      {
+        key: ConfigKey.tag_title,
+        description: "The title of the heading",
+        jsonKey: "title|setMulti(level)",
+        exportJsonKey: { title: "$", level: "$level" }
+      }
+    ]
+  },
   [BitType.help]: {
     since: "1.3.0",
     title: "Help",
@@ -10889,13 +10959,22 @@ var BITS = {
     since: "1.22.0",
     title: "List",
     bitGroups: [BitGroup.static],
-    baseBitType: BitType.article,
+    // PLAN-021: rebased from article onto the lightweight base
+    baseBitType: BitType._standardLight,
     description: "List bit, used to create lists in articles or books"
   },
+  [BitType.listAlt]: {
+    since: "5.40.0",
+    title: "List Alt",
+    bitGroups: [BitGroup.static],
+    baseBitType: BitType.list,
+    description: "Lightweight list bit (alternative), based on list"
+  },
   [BitType.standardList]: {
     since: "1.22.0",
     bitGroups: [BitGroup.static],
-    baseBitType: BitType.article,
+    // PLAN-021: re-rooted from article onto the lightweight list
+    baseBitType: BitType.list,
     description: "Standard list bit, used to create standard lists in articles or books"
   },
   [BitType.smartStandardList]: {
@@ -10911,6 +10990,13 @@ var BITS = {
       "xml-niso-iec": { "@el": "ref-list", "@attr": { id: "$customerId" }, "\u25BC": "$anchor" }
     }
   },
+  [BitType.smartStandardP]: {
+    since: "5.40.0",
+    title: "Smart Standard Paragraph",
+    bitGroups: [BitGroup.static],
+    baseBitType: BitType.p,
+    description: "Smart standard paragraph bit, based on p"
+  },
   [BitType.smartStandardListCollapsible]: {
     since: "1.28.0",
     deprecated: "5.37.0",
@@ -13492,7 +13578,8 @@ var BITS = {
   [BitType.listItem]: {
     since: "1.22.0",
     bitGroups: [BitGroup.static],
-    baseBitType: BitType.article,
+    // PLAN-021: rebased from article onto the lightweight base
+    baseBitType: BitType._standardLight,
     description: "List item bit, used to create list items in articles or books",
     tags: [
       {
@@ -13897,6 +13984,20 @@ var BITS = {
     baseBitType: BitType.multipleResponse,
     description: "Coach self-reflection multiple response bit, used for self-reflection in coaching"
   },
+  [BitType.p]: {
+    since: "5.40.0",
+    title: "Paragraph",
+    bitGroups: [BitGroup.static],
+    baseBitType: BitType._standardLight,
+    description: "Lightweight paragraph bit with a minimal tag set"
+  },
+  [BitType.pAlt]: {
+    since: "5.40.0",
+    title: "Paragraph Alt",
+    bitGroups: [BitGroup.static],
+    baseBitType: BitType.p,
+    description: "Lightweight paragraph bit (alternative), based on p"
+  },
   [BitType.page]: {
     since: "1.3.0",
     title: "Page",
@@ -16627,7 +16728,7 @@ var instance2 = new Config();
 // src/generated/package_info.ts
 var PACKAGE_INFO = {
   "name": "@gmb/bitmark-parser-generator",
-  "version": "5.39.0",
+  "version": "5.40.0",
   "author": "Get More Brain Ltd",
   "license": "ISC",
   "description": "A bitmark parser and generator using Peggy.js"
@@ -35548,7 +35649,7 @@ var BitmarkGenerator = class extends AstWalkerGenerator {
   leaf_level(node, route) {
     const parent = this.getParentNode(route);
     if (parent?.key !== NodeType.bitsValue) return true;
-    if (!instance2.isOfBitType(this.bitType, [BitType.chapter])) return true;
+    if (!instance2.isOfBitType(this.bitType, [BitType.chapter, BitType.h])) return true;
     const level = node.value;
     const bit = parent?.value;
     if (level > 0 && bit.title == null) {
@@ -42091,15 +42192,23 @@ function titleTagContentProcessor(context, _contentDepth, _tagsConfig, content,
     titleString: titleText ?? ""
   };
 }
-function buildTitles(_context, bitType, title) {
+var H_TITLE_LEVEL_MAX = 7;
+function buildTitles(context, bitType, title) {
   title = title ?? [];
-  if (instance2.isOfBitType(bitType, BitType.chapter)) {
+  if (instance2.isOfBitType(bitType, [BitType.chapter, BitType.h])) {
     let t;
     if (title.length > 0) t = title[title.length - 1];
+    let level = title.length > 0 ? title.length - 1 : void 0;
+    if (level != null && level > H_TITLE_LEVEL_MAX && instance2.isOfBitType(bitType, BitType.h)) {
+      context.addWarning(
+        `Title level of ${level} too high, setting to max value of ${H_TITLE_LEVEL_MAX}`
+      );
+      level = H_TITLE_LEVEL_MAX;
+    }
     return {
       title: t?.titleAst ?? [],
       titleString: t?.titleString ?? "",
-      level: title.length > 0 ? title.length - 1 : void 0
+      level
     };
   } else {
     if (Array.isArray(title)) {