@dogsbay/format-dita 0.2.0-beta.123 → 0.2.0-beta.124

package/README.md

@@ -27,7 +27,7 @@ dogsbay import-dita   docs/            -o content    --report topics.md
 ```
 
 Tasks become native `:::steps`, notes become callouts, CALS and
-simpletables become tables, `<xref href="x.dita">` becomes `[…](x.md)`,
+simpletables (and a reference topic's `<properties>`) become tables, `<xref href="x.dita">` becomes `[…](x.md)`,
 and `keyref` links become `key:` links. Nested or sibling topics in
 multi-topic files are emitted inline as anchored sections.
 
@@ -38,6 +38,18 @@ emit `{% include %}` so one canonical copy of reused text survives. Use
 `dogsbay import-dita --no-conref-includes` to keep conrefs on the ledger
 instead.
 
+**Specializations in raw source:** a file as authored has no `@class`, so
+an element is known only by its name, and a specialization the converter
+does not know by name (a `<troubleshooting>` topic, a hazard statement's
+items) loses its markup. `{ classDefaults: true }` fills in each missing
+`@class` from the DITA 1.3 DTD defaults first (612 elements, the table
+`DITA_CLASS_DEFAULTS`, generated by `scripts/generate-class-defaults.mjs`
+from DITA-OT's `.mod` files), as parsing against the DTDs would; the
+element then converts as what it specializes. An existing `@class` is kept;
+a name the DTDs do not declare (custom or DITA 2.0) stays unclassed, with
+one note per topic. It is off by default for now because it changes the
+output for such elements.
+
 Everything that cannot map cleanly lands in the conversion ledger instead
 of disappearing: filter attributes, table spans, semantic-inline downgrades,
 `conkeyref`, conref ranges/pushes, whole-topic conrefs, unresolved targets,

package/dist/blocks.js

@@ -210,8 +210,14 @@ const definingItemNode = (el, ctx, type) => {
     ctx.note("@conref", `<${el.name.toLowerCase()} id="${el.attribs.id}"> is reused elsewhere via "${snippet.file}" but its content is multi-line — replace it with the include manually to keep one copy`);
     return null;
 };
+/**
+ * Whether an element is a `tag` by name or, with @class, by what it
+ * specializes: a hazard statement's <typeofhazard> is an <li>. Matching the
+ * name alone dropped such items, and their text, without a note.
+ */
+const isPart = (el, ctx, tag) => isElement(el) && elementName(el, ctx, (n) => n === tag) === tag;
 const convertListItems = (el, ctx, itemTag) => el.children
-    .filter((c) => isElement(c) && c.name.toLowerCase() === itemTag)
+    .filter((c) => isPart(c, ctx, itemTag))
     .map((li) => {
     const viaConref = itemConref(li, ctx, "list-item") ?? definingItemNode(li, ctx, "list-item");
     if (viaConref)
@@ -529,7 +535,7 @@ const inlineLabel = (inline) => (inline ?? [])
 const dlComponentEntries = (el, ctx, component, keepEmpty = false, anchorsOut) => {
     const out = [];
     let pending = [];
-    const entries = el.children.filter((c) => isElement(c) && c.name.toLowerCase() === "dlentry");
+    const entries = el.children.filter((c) => isPart(c, ctx, "dlentry"));
     for (const entry of entries) {
         const items = convertDefList({ ...el, children: [entry] }, ctx).children ?? [];
         const terms = items.filter((n) => n.type === "dt");
@@ -637,7 +643,7 @@ const dlToCards = (el, ctx, anchors) => {
 const convertDefList = (el, ctx, tags = { entry: "dlentry", term: "dt", def: "dd" }) => {
     const children = [];
     for (const entry of el.children.filter(isElement)) {
-        if (entry.name.toLowerCase() !== tags.entry)
+        if (!isPart(entry, ctx, tags.entry))
             continue;
         // Entry-level conref (<dlentry conref>): a term/definition pair can't
         // splice as an include — ledger it so the loss is never silent
@@ -647,8 +653,7 @@ const convertDefList = (el, ctx, tags = { entry: "dlentry", term: "dt", def: "dd
         }
         let entryAnchored = false;
         for (const part of entry.children.filter(isElement)) {
-            const name = part.name.toLowerCase();
-            if (name === tags.term) {
+            if (isPart(part, ctx, tags.term)) {
                 // Term-level conref (<dt conref>/<pt conref>): single-line
                 // include or ledger — never a silent empty term
                 const viaConref = constrainedConrefInline(part, ctx);
@@ -659,7 +664,7 @@ const convertDefList = (el, ctx, tags = { entry: "dlentry", term: "dt", def: "dd
                 });
                 entryAnchored = true;
             }
-            else if (name === tags.def) {
+            else if (isPart(part, ctx, tags.def)) {
                 const viaConref = constrainedConrefInline(part, ctx);
                 if (viaConref) {
                     children.push({ type: "dd", inline: viaConref });
@@ -719,12 +724,23 @@ const TABLE_PARTS = new Set([
 const hasClassToken = (el, token) => ` ${el.attribs?.class ?? ""} `.includes(` ${token} `);
 const elementChildren = (el) => el.children.filter(isElement);
 const PROPERTY_KINDS = ["proptype", "propvalue", "propdesc"];
+/**
+ * Whether an element is the reference domain's `local` (`properties`, `property`, …):
+ * by @class when DITA-OT has filled it in, else by name, as authored source has none.
+ */
+const isReference = (el, local) => hasClassToken(el, `reference/${local}`) || el.name.toLowerCase() === local;
 /** A properties table cell's column: `proptype`, or with suffix "hd" a header cell (`proptypehd`). */
-const propertyKind = (cell, suffix = "") => PROPERTY_KINDS.find((k) => hasClassToken(cell, `reference/${k}${suffix}`));
+const propertyKind = (cell, suffix = "") => PROPERTY_KINDS.find((k) => isReference(cell, `${k}${suffix}`));
+/**
+ * A properties table's cells. Exactly the cells `propertyKind` recognizes (a
+ * published cell's @class names its kind before the stentry it specializes),
+ * so a row's converted cells and its cell elements line up index for index.
+ */
+const PROPERTY_CELLS = new Set([...PROPERTY_KINDS, ...PROPERTY_KINDS.map((k) => `${k}hd`)]);
 /** A properties table's columns in use, its properties that have cells, and its header row. */
 const propertiesColumns = (el) => {
-    const header = elementChildren(el).find((c) => hasClassToken(c, "reference/prophead"));
-    const propertyRows = elementChildren(el).filter((c) => hasClassToken(c, "reference/property") && elementChildren(c).some((cell) => !!propertyKind(cell)));
+    const header = elementChildren(el).find((c) => isReference(c, "prophead"));
+    const propertyRows = elementChildren(el).filter((c) => isReference(c, "property") && elementChildren(c).some((cell) => !!propertyKind(cell)));
     const used = PROPERTY_KINDS.filter((k) => propertyRows.some((r) => elementChildren(r).some((c) => propertyKind(c) === k)) ||
         (header ? elementChildren(header).some((c) => propertyKind(c, "hd") === k) : false));
     return { used, propertyRows, ...(header ? { header } : {}) };
@@ -829,15 +845,24 @@ const convertTable = (el, ctx) => {
         }
     };
     walk(el);
-    // Publishing: a properties table's columns are the type, value and description columns
+    // A properties table's columns are the type, value and description columns
     // its header or any property uses (DITA-OT's hasType, hasValue, hasDesc); each row
     // aligns its cells to them, a property with no cells is dropped, and a header cell
-    // missing for a column in use is DITA-OT's generated label ("Type", "Value", "Description")
-    if (ctx.publish && hasClassToken(el, "reference/properties")) {
+    // missing for a column in use is DITA-OT's generated label ("Type", "Value",
+    // "Description"; localized when publishing). Authored source has no @class, so
+    // the parts are matched by name too (the walk above sees no sthead/strow then).
+    if (isReference(el, "properties")) {
         const { used, propertyRows, header } = propertiesColumns(el);
+        // A property with no cells has no row; one that reuses a row by conref is noted, not lost
+        for (const row of elementChildren(el)) {
+            if (isReference(row, "property") && !propertyRows.includes(row) && (row.attribs?.conref || row.attribs?.conkeyref)) {
+                const ref = row.attribs.conref ?? row.attribs.conkeyref;
+                ctx.note(row.attribs.conref ? "@conref" : "@conkeyref", `<property> pulls content from "${ref}" — ${conrefLedgerDetail(row.attribs, undefined, ctx.conref !== undefined)}`);
+            }
+        }
         rows.length = 0;
         for (const row of propertyRows) {
-            const converted = convertRow(row, SIMPLE_CELLS);
+            const converted = convertRow(row, PROPERTY_CELLS);
             const cellEls = elementChildren(row).filter((c) => !!propertyKind(c));
             rows.push({
                 type: "tr",
@@ -847,13 +872,10 @@ const convertTable = (el, ctx) => {
                 }),
             });
         }
-        const lang = publishLanguage(el, ctx.publish);
-        const label = {
-            proptype: publishString(ctx.publish, lang, "Type"),
-            propvalue: publishString(ctx.publish, lang, "Value"),
-            propdesc: publishString(ctx.publish, lang, "Description"),
-        };
-        const authored = header ? convertRow(header, SIMPLE_CELLS, true) : undefined;
+        const lang = ctx.publish ? publishLanguage(el, ctx.publish) : undefined;
+        const word = (w) => (ctx.publish ? publishString(ctx.publish, lang, w) : w);
+        const label = { proptype: word("Type"), propvalue: word("Value"), propdesc: word("Description") };
+        const authored = header ? convertRow(header, PROPERTY_CELLS, true) : undefined;
         const headerCells = header ? elementChildren(header).filter((c) => !!propertyKind(c, "hd")) : [];
         headRows.length = 0;
         headRows.push({
@@ -940,7 +962,7 @@ export const convertStepContent = (stepEl, ctx) => {
 const convertSteps = (el, ctx, type) => {
     const stepTag = type === "steps" ? "step" : "substep";
     const children = el.children
-        .filter((c) => isElement(c) && c.name.toLowerCase() === stepTag)
+        .filter((c) => isPart(c, ctx, stepTag))
         .map((stepEl) => {
         const viaConref = itemConref(stepEl, ctx, "step") ?? definingItemNode(stepEl, ctx, "step");
         if (viaConref)
@@ -1012,7 +1034,7 @@ const publishTaskLabel = (name, ctx, el) => ctx.publish?.taskLabels && TASK_LABE
 /** Block-level DITA elements (used to split mixed content). */
 const BLOCK_ELEMENTS = new Set([
     "p", "shortdesc", "note", "codeblock", "pre", "screen", "msgblock", "ul", "ol", "sl", "dl", "parml", "table", "simpletable",
-    "fig", "image", "section", "example", "steps", "steps-unordered", "substeps", "lq", "object",
+    "properties", "fig", "image", "section", "example", "steps", "steps-unordered", "substeps", "lq", "object",
     "prereq", "context", "result", "postreq", "tasktroubleshooting", "choices", "choicetable", "syntaxdiagram",
 ]);
 const SYNTAX_GROUPS = new Set(["groupseq", "groupchoice", "groupcomp"]);
@@ -1364,7 +1386,7 @@ function convertBlockContent(el, ctx) {
             // as <li>: referencing items include or ledger, defining items
             // hand their text to the snippet)
             const items = el.children
-                .filter((c) => isElement(c) && c.name.toLowerCase() === "sli")
+                .filter((c) => isPart(c, ctx, "sli"))
                 .map((sli) => {
                 const viaConref = itemConref(sli, ctx, "list-item") ?? definingItemNode(sli, ctx, "list-item");
                 if (viaConref)
@@ -1400,9 +1422,17 @@ function convertBlockContent(el, ctx) {
             return [withProvenance(convertDefList(el, ctx, { entry: "plentry", term: "pt", def: "pd" }), el)];
         case "table":
         case "simpletable":
-            // Publishing: DITA-OT drops a properties table none of whose properties has a cell
-            if (ctx.publish && hasClassToken(el, "reference/properties") && propertiesColumns(el).propertyRows.length === 0)
+        case "properties":
+            // A properties table none of whose properties has a cell has no columns: DITA-OT drops it
+            if (isReference(el, "properties") && propertiesColumns(el).propertyRows.length === 0) {
+                if (!ctx.publish) {
+                    for (const row of elementChildren(el).filter((r) => r.attribs?.conref || r.attribs?.conkeyref)) {
+                        const ref = row.attribs.conref ?? row.attribs.conkeyref;
+                        ctx.note(row.attribs.conref ? "@conref" : "@conkeyref", `<${row.name.toLowerCase()}> pulls content from "${ref}" — ${conrefLedgerDetail(row.attribs, undefined, ctx.conref !== undefined)}`);
+                    }
+                }
                 return [];
+            }
             return [withProvenance(convertTable(el, ctx), el)];
         case "syntaxdiagram":
             if (ctx.publish)

package/dist/class-defaults-apply.d.ts

@@ -0,0 +1,15 @@
+import type { AnyNode } from "domhandler";
+/** An element's DITA 1.3 default @class (`inMap`: inside a map document), or undefined for a name the DTDs do not declare. */
+export declare const classDefault: (name: string, inMap?: boolean) => string | undefined;
+/**
+ * Fill in the @class a DTD would have defaulted, on every element that has
+ * none, as parsing against the DTDs (or DITA-OT preprocessing) does. An
+ * existing @class is kept. Returns the element names the DITA 1.3 DTDs do not
+ * declare (custom specializations, DITA 2.0), in document order, each once;
+ * those stay unclassed. Not reported: the `<dita>` wrapper of a composite
+ * topic, which has no @class by design, and foreign vocabularies (a
+ * namespace prefix, or an undeclared name inside a `<foreign>`
+ * specialization: MathML, SVG), which are not DITA elements and are left
+ * untouched. A DITA element inside one (`<mathmlref>`, `<svgref>`) is classed.
+ */
+export declare function applyClassDefaults(nodes: AnyNode[]): string[];

package/dist/class-defaults-apply.js

@@ -0,0 +1,40 @@
+import { isTag } from "domhandler";
+import { DITA_CLASS_DEFAULTS, DITA_MAP_CLASS_DEFAULTS } from "./class-defaults.js";
+const own = (table, name) => Object.prototype.hasOwnProperty.call(table, name) ? table[name] : undefined;
+/** An element's DITA 1.3 default @class (`inMap`: inside a map document), or undefined for a name the DTDs do not declare. */
+export const classDefault = (name, inMap = false) => (inMap ? own(DITA_MAP_CLASS_DEFAULTS, name) : undefined) ?? own(DITA_CLASS_DEFAULTS, name);
+/**
+ * Fill in the @class a DTD would have defaulted, on every element that has
+ * none, as parsing against the DTDs (or DITA-OT preprocessing) does. An
+ * existing @class is kept. Returns the element names the DITA 1.3 DTDs do not
+ * declare (custom specializations, DITA 2.0), in document order, each once;
+ * those stay unclassed. Not reported: the `<dita>` wrapper of a composite
+ * topic, which has no @class by design, and foreign vocabularies (a
+ * namespace prefix, or an undeclared name inside a `<foreign>`
+ * specialization: MathML, SVG), which are not DITA elements and are left
+ * untouched. A DITA element inside one (`<mathmlref>`, `<svgref>`) is classed.
+ */
+export function applyClassDefaults(nodes) {
+    const root = nodes.find(isTag);
+    const inMap = !!root && (["map", "bookmap", "subjectScheme"].includes(root.name) || ` ${root.attribs?.class ?? ""} `.includes(" map/map "));
+    const unknown = new Set();
+    const visit = (el, inForeign) => {
+        if (el.name.includes(":"))
+            return;
+        if (!el.attribs?.class?.trim()) {
+            const value = classDefault(el.name, inMap);
+            if (value)
+                el.attribs = { ...el.attribs, class: value };
+            else if (el.name !== "dita" && !inForeign)
+                unknown.add(el.name);
+        }
+        const foreign = inForeign || ` ${el.attribs?.class ?? ""} `.includes(" topic/foreign ");
+        for (const child of el.children)
+            if (isTag(child))
+                visit(child, foreign);
+    };
+    for (const node of nodes)
+        if (isTag(node))
+            visit(node, false);
+    return [...unknown];
+}

package/dist/class-defaults.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Each DITA 1.3 element's default @class, as its DTD declares it. GENERATED by
+ * scripts/generate-class-defaults.mjs from the .mod files under dita-ot-4.3.5's
+ * plugins/org.oasis-open.dita.v1_3/dtd/ (612 elements); do not edit.
+ */
+export declare const DITA_CLASS_DEFAULTS: Readonly<Record<string, string>>;
+/** Elements whose class differs inside a map (map.mod declares them too). */
+export declare const DITA_MAP_CLASS_DEFAULTS: Readonly<Record<string, string>>;

package/dist/class-defaults.js

@@ -0,0 +1,625 @@
+/**
+ * Each DITA 1.3 element's default @class, as its DTD declares it. GENERATED by
+ * scripts/generate-class-defaults.mjs from the .mod files under dita-ot-4.3.5's
+ * plugins/org.oasis-open.dita.v1_3/dtd/ (612 elements); do not edit.
+ */
+export const DITA_CLASS_DEFAULTS = Object.freeze({
+    "abbreviated-form": "+ topic/term abbrev-d/abbreviated-form ",
+    "abbrevlist": "- map/topicref bookmap/abbrevlist ",
+    "abstract": "- topic/abstract ",
+    "addressdetails": "+ topic/ph xnal-d/addressdetails ",
+    "administrativearea": "+ topic/ph xnal-d/administrativearea ",
+    "alt": "- topic/alt ",
+    "amendments": "- map/topicref bookmap/amendments ",
+    "anchor": "- map/anchor ",
+    "anchorid": "+ topic/keyword delay-d/anchorid ",
+    "anchorkey": "+ topic/keyword delay-d/anchorkey ",
+    "anchorref": "+ map/topicref mapgroup-d/anchorref ",
+    "apiname": "+ topic/keyword pr-d/apiname ",
+    "appendices": "- map/topicref bookmap/appendices ",
+    "appendix": "- map/topicref bookmap/appendix ",
+    "approved": "- topic/data bookmap/approved ",
+    "area": "+ topic/figgroup ut-d/area ",
+    "attributedef": "- topic/data subjectScheme/attributedef ",
+    "audience": "- topic/audience ",
+    "author": "- topic/author ",
+    "authorinformation": "+ topic/author xnal-d/authorinformation ",
+    "b": "+ topic/ph hi-d/b ",
+    "backmatter": "- map/topicref bookmap/backmatter ",
+    "bibliolist": "- map/topicref bookmap/bibliolist ",
+    "body": "- topic/body ",
+    "bodydiv": "- topic/bodydiv ",
+    "bookabstract": "- map/topicref bookmap/bookabstract ",
+    "bookchangehistory": "- topic/data bookmap/bookchangehistory ",
+    "bookevent": "- topic/data bookmap/bookevent ",
+    "bookeventtype": "- topic/data bookmap/bookeventtype ",
+    "bookid": "- topic/data bookmap/bookid ",
+    "booklibrary": "- topic/ph bookmap/booklibrary ",
+    "booklist": "- map/topicref bookmap/booklist ",
+    "booklists": "- map/topicref bookmap/booklists ",
+    "bookmap": "- map/map bookmap/bookmap ",
+    "bookmeta": "- map/topicmeta bookmap/bookmeta ",
+    "booknumber": "- topic/data bookmap/booknumber ",
+    "bookowner": "- topic/data bookmap/bookowner ",
+    "bookpartno": "- topic/data bookmap/bookpartno ",
+    "bookrestriction": "- topic/data bookmap/bookrestriction ",
+    "bookrights": "- topic/data bookmap/bookrights ",
+    "booktitle": "- topic/title bookmap/booktitle ",
+    "booktitlealt": "- topic/ph bookmap/booktitlealt ",
+    "boolean": "- topic/boolean ",
+    "brand": "- topic/brand ",
+    "category": "- topic/category ",
+    "cause": "- topic/section troubleshooting/cause ",
+    "change-completed": "+ topic/data relmgmt-d/change-completed ",
+    "change-historylist": "+ topic/metadata relmgmt-d/change-historylist ",
+    "change-item": "+ topic/data relmgmt-d/change-item ",
+    "change-organization": "+ topic/data relmgmt-d/change-organization ",
+    "change-person": "+ topic/data relmgmt-d/change-person ",
+    "change-request-id": "+ topic/data relmgmt-d/change-request-id ",
+    "change-request-reference": "+ topic/data relmgmt-d/change-request-reference ",
+    "change-request-system": "+ topic/data relmgmt-d/change-request-system ",
+    "change-revisionid": "+ topic/data relmgmt-d/change-revisionid ",
+    "change-started": "+ topic/data relmgmt-d/change-started ",
+    "change-summary": "+ topic/data relmgmt-d/change-summary ",
+    "chapter": "- map/topicref bookmap/chapter ",
+    "chdesc": "- topic/stentry task/chdesc ",
+    "chdeschd": "- topic/stentry task/chdeschd ",
+    "chhead": "- topic/sthead task/chhead ",
+    "choice": "- topic/li task/choice ",
+    "choices": "- topic/ul task/choices ",
+    "choicetable": "- topic/simpletable task/choicetable ",
+    "choption": "- topic/stentry task/choption ",
+    "choptionhd": "- topic/stentry task/choptionhd ",
+    "chrow": "- topic/strow task/chrow ",
+    "cite": "- topic/cite ",
+    "closereqs": "+ topic/section task/postreq taskreq-d/closereqs ",
+    "cmd": "- topic/ph task/cmd ",
+    "cmdname": "+ topic/keyword sw-d/cmdname ",
+    "codeblock": "+ topic/pre pr-d/codeblock ",
+    "codeph": "+ topic/ph pr-d/codeph ",
+    "coderef": "+ topic/xref pr-d/coderef ",
+    "colophon": "- map/topicref bookmap/colophon ",
+    "colspec": "- topic/colspec ",
+    "completed": "- topic/ph bookmap/completed ",
+    "component": "- topic/component ",
+    "conbody": "- topic/body  concept/conbody ",
+    "conbodydiv": "- topic/bodydiv concept/conbodydiv ",
+    "concept": "- topic/topic concept/concept ",
+    "condition": "- topic/section troubleshooting/condition ",
+    "consequence": "+ topic/li hazard-d/consequence ",
+    "contactnumber": "+ topic/data xnal-d/contactnumber ",
+    "contactnumbers": "+ topic/data xnal-d/contactnumbers ",
+    "context": "- topic/section task/context ",
+    "coords": "+ topic/ph ut-d/coords ",
+    "copyrfirst": "- topic/data bookmap/copyrfirst ",
+    "copyrholder": "- topic/copyrholder ",
+    "copyright": "- topic/copyright ",
+    "copyrlast": "- topic/data bookmap/copyrlast ",
+    "copyryear": "- topic/copyryear ",
+    "country": "+ topic/ph xnal-d/country ",
+    "created": "- topic/created ",
+    "critdates": "- topic/critdates ",
+    "data": "- topic/data ",
+    "data-about": "- topic/data-about ",
+    "day": "- topic/ph bookmap/day ",
+    "dd": "- topic/dd ",
+    "ddhd": "- topic/ddhd ",
+    "dedication": "- map/topicref bookmap/dedication ",
+    "defaultSubject": "- map/topicref subjectScheme/defaultSubject ",
+    "delim": "+ topic/ph pr-d/delim ",
+    "desc": "- topic/desc ",
+    "ditavalmeta": "+ map/topicmeta ditavalref-d/ditavalmeta ",
+    "ditavalref": "+ map/topicref ditavalref-d/ditavalref ",
+    "div": "- topic/div ",
+    "dl": "- topic/dl ",
+    "dlentry": "- topic/dlentry ",
+    "dlhead": "- topic/dlhead ",
+    "draft-comment": "- topic/draft-comment ",
+    "draftintro": "- map/topicref bookmap/draftintro ",
+    "dt": "- topic/dt ",
+    "dthd": "- topic/dthd ",
+    "dvrKeyscopePrefix": "+ topic/data ditavalref-d/dvrKeyscopePrefix ",
+    "dvrKeyscopeSuffix": "+ topic/data ditavalref-d/dvrKeyscopeSuffix ",
+    "dvrResourcePrefix": "+ topic/data ditavalref-d/dvrResourcePrefix ",
+    "dvrResourceSuffix": "+ topic/data ditavalref-d/dvrResourceSuffix ",
+    "edited": "- topic/data bookmap/edited ",
+    "edition": "- topic/data bookmap/edition ",
+    "elementdef": "- topic/data subjectScheme/elementdef ",
+    "emailaddress": "+ topic/data xnal-d/emailaddress ",
+    "emailaddresses": "+ topic/data xnal-d/emailaddresses ",
+    "entry": "- topic/entry ",
+    "enumerationdef": "- map/topicref subjectScheme/enumerationdef ",
+    "equation-block": "+ topic/div equation-d/equation-block ",
+    "equation-figure": "+ topic/fig equation-d/equation-figure ",
+    "equation-inline": "+ topic/ph equation-d/equation-inline ",
+    "equation-number": "+ topic/ph equation-d/equation-number ",
+    "esttime": "+ topic/li task/li taskreq-d/esttime ",
+    "example": "- topic/example ",
+    "exportanchors": "+ topic/keywords delay-d/exportanchors ",
+    "featnum": "- topic/featnum ",
+    "fig": "- topic/fig ",
+    "figgroup": "- topic/figgroup ",
+    "figurelist": "- map/topicref bookmap/figurelist ",
+    "filepath": "+ topic/ph sw-d/filepath ",
+    "firstname": "+ topic/data xnal-d/firstname ",
+    "fn": "- topic/fn ",
+    "foreign": "- topic/foreign ",
+    "fragment": "+ topic/figgroup pr-d/fragment ",
+    "fragref": "+ topic/xref pr-d/fragref ",
+    "frontmatter": "- map/topicref bookmap/frontmatter ",
+    "generationidentifier": "+ topic/data xnal-d/generationidentifier ",
+    "glossAbbreviation": "- topic/title concept/title glossentry/glossAbbreviation ",
+    "glossAcronym": "- topic/title concept/title glossentry/glossAcronym ",
+    "glossAlt": "- topic/section concept/section glossentry/glossAlt ",
+    "glossAlternateFor": "- topic/xref concept/xref glossentry/glossAlternateFor ",
+    "glossBody": "- topic/body concept/conbody glossentry/glossBody ",
+    "glossPartOfSpeech": "- topic/data concept/data glossentry/glossPartOfSpeech ",
+    "glossProperty": "- topic/data concept/data glossentry/glossProperty ",
+    "glossScopeNote": "- topic/note concept/note glossentry/glossScopeNote ",
+    "glossShortForm": "- topic/title concept/title glossentry/glossShortForm ",
+    "glossStatus": "- topic/data concept/data glossentry/glossStatus ",
+    "glossSurfaceForm": "- topic/p concept/p glossentry/glossSurfaceForm ",
+    "glossSymbol": "- topic/image concept/image glossentry/glossSymbol ",
+    "glossSynonym": "- topic/title concept/title glossentry/glossSynonym ",
+    "glossUsage": "- topic/note concept/note glossentry/glossUsage ",
+    "glossarylist": "- map/topicref bookmap/glossarylist ",
+    "glossdef": "- topic/abstract concept/abstract glossentry/glossdef ",
+    "glossentry": "- topic/topic concept/concept glossentry/glossentry ",
+    "glossgroup": "- topic/topic concept/concept glossgroup/glossgroup ",
+    "glossref": "+ map/topicref glossref-d/glossref ",
+    "glossterm": "- topic/title concept/title glossentry/glossterm ",
+    "groupchoice": "+ topic/figgroup pr-d/groupchoice ",
+    "groupcomp": "+ topic/figgroup pr-d/groupcomp ",
+    "groupseq": "+ topic/figgroup pr-d/groupseq ",
+    "hasInstance": "- map/topicref subjectScheme/hasInstance ",
+    "hasKind": "- map/topicref subjectScheme/hasKind ",
+    "hasNarrower": "- map/topicref subjectScheme/hasNarrower ",
+    "hasPart": "- map/topicref subjectScheme/hasPart ",
+    "hasRelated": "- map/topicref subjectScheme/hasRelated ",
+    "hazardstatement": "+ topic/note hazard-d/hazardstatement ",
+    "hazardsymbol": "+ topic/image hazard-d/hazardsymbol ",
+    "honorific": "+ topic/data xnal-d/honorific ",
+    "howtoavoid": "+ topic/li hazard-d/howtoavoid ",
+    "i": "+ topic/ph hi-d/i ",
+    "image": "- topic/image ",
+    "imagemap": "+ topic/fig ut-d/imagemap ",
+    "index-base": "- topic/index-base ",
+    "index-see": "+ topic/index-base indexing-d/index-see ",
+    "index-see-also": "+ topic/index-base indexing-d/index-see-also ",
+    "index-sort-as": "+ topic/index-base indexing-d/index-sort-as ",
+    "indexlist": "- map/topicref bookmap/indexlist ",
+    "indexterm": "- topic/indexterm ",
+    "indextermref": "- topic/indextermref ",
+    "info": "- topic/itemgroup task/info ",
+    "isbn": "- topic/data bookmap/isbn ",
+    "itemgroup": "- topic/itemgroup ",
+    "keydef": "+ map/topicref mapgroup-d/keydef ",
+    "keyword": "- topic/keyword ",
+    "keywords": "- topic/keywords ",
+    "kwd": "+ topic/keyword pr-d/kwd ",
+    "lastname": "+ topic/data xnal-d/lastname ",
+    "lcAge": "- topic/p  learningBase/p learningPlan/lcAge ",
+    "lcAnswerContent": "+ topic/p learningInteractionBase-d/p learning-d/lcAnswerContent ",
+    "lcAnswerContent2": "+ topic/div learningInteractionBase2-d/div learning2-d/lcAnswerContent2 ",
+    "lcAnswerOption": "+ topic/li learningInteractionBase-d/li learning-d/lcAnswerOption ",
+    "lcAnswerOption2": "+ topic/li learningInteractionBase2-d/li learning2-d/lcAnswerOption2 ",
+    "lcAnswerOptionGroup": "+ topic/ul learningInteractionBase-d/ul learning-d/lcAnswerOptionGroup ",
+    "lcAnswerOptionGroup2": "+ topic/ul learningInteractionBase2-d/ul learning2-d/lcAnswerOptionGroup2 ",
+    "lcArea": "+ topic/figgroup learningInteractionBase-d/figgroup learning-d/lcArea ",
+    "lcArea2": "+ topic/figgroup learningInteractionBase2-d/figgroup learning2-d/lcArea2 ",
+    "lcAreaCoords": "+ topic/ph learningInteractionBase-d/ph learning-d/lcAreaCoords ",
+    "lcAreaCoords2": "+ topic/ph learningInteractionBase2-d/ph learning2-d/lcAreaCoords2 ",
+    "lcAreaShape": "+ topic/keyword learningInteractionBase-d/keyword learning-d/lcAreaShape ",
+    "lcAreaShape2": "+ topic/keyword learningInteractionBase2-d/keyword learning2-d/lcAreaShape2 ",
+    "lcAssessment": "- topic/p  learningBase/p learningPlan/lcAssessment ",
+    "lcAsset": "+ topic/p learningInteractionBase-d/p learning-d/lcAsset ",
+    "lcAsset2": "+ topic/div learningInteractionBase2-d/div learning2-d/lcAsset2 ",
+    "lcAttitude": "- topic/p  learningBase/p learningPlan/lcAttitude ",
+    "lcAudience": "- topic/section learningBase/lcAudience ",
+    "lcBackground": "- topic/p  learningBase/p learningPlan/lcBackground ",
+    "lcCIN": "- topic/fig  learningBase/fig learningPlan/lcCIN ",
+    "lcChallenge": "- topic/section learningBase/lcChallenge ",
+    "lcClassroom": "- topic/fig  learningBase/fig learningPlan/lcClassroom ",
+    "lcClient": "- topic/fig  learningBase/fig learningPlan/lcClient ",
+    "lcConstraints": "- topic/fig  learningBase/fig learningPlan/lcConstraints ",
+    "lcCorrectResponse": "+ topic/data learningInteractionBase-d/data learning-d/lcCorrectResponse ",
+    "lcCorrectResponse2": "+ topic/data learningInteractionBase2-d/data learning2-d/lcCorrectResponse2 ",
+    "lcDelivDate": "- topic/fig  learningBase/fig learningPlan/lcDelivDate ",
+    "lcDelivery": "- topic/p  learningBase/p learningPlan/lcDelivery ",
+    "lcDownloadTime": "- topic/fig  learningBase/fig learningPlan/lcDownloadTime ",
+    "lcDuration": "- topic/section learningBase/lcDuration ",
+    "lcEdLevel": "- topic/p  learningBase/p learningPlan/lcEdLevel ",
+    "lcFeedback": "+ topic/p learningInteractionBase-d/p learning-d/lcFeedback ",
+    "lcFeedback2": "+ topic/div learningInteractionBase2-d/div learning2-d/lcFeedback2 ",
+    "lcFeedbackCorrect": "+ topic/p learningInteractionBase-d/p learning-d/lcFeedbackCorrect ",
+    "lcFeedbackCorrect2": "+ topic/div learningInteractionBase2-d/div learning2-d/lcFeedbackCorrect2 ",
+    "lcFeedbackIncorrect": "+ topic/p learningInteractionBase-d/p learning-d/lcFeedbackIncorrect ",
+    "lcFeedbackIncorrect2": "+ topic/div learningInteractionBase2-d/div learning2-d/lcFeedbackIncorrect2 ",
+    "lcFileSizeLimitations": "- topic/fig  learningBase/fig learningPlan/lcFileSizeLimitations ",
+    "lcGapAnalysis": "- topic/section  learningBase/section learningPlan/lcGapAnalysis ",
+    "lcGapItem": "- topic/fig  learningBase/fig learningPlan/lcGapItem ",
+    "lcGapItemDelta": "- topic/p  learningBase/p learningPlan/lcGapItemDelta ",
+    "lcGeneralDescription": "- topic/p  learningBase/p learningPlan/lcGeneralDescription ",
+    "lcGoals": "- topic/p  learningBase/p learningPlan/lcGoals ",
+    "lcGraphics": "- topic/fig  learningBase/fig learningPlan/lcGraphics ",
+    "lcHandouts": "- topic/fig  learningBase/fig learningPlan/lcHandouts ",
+    "lcHotspot": "+ topic/fig learningInteractionBase-d/lcInteractionBase learning-d/lcHotspot ",
+    "lcHotspot2": "+ topic/div learningInteractionBase2-d/lcInteractionBase2 learning2-d/lcHotspot2 ",
+    "lcHotspotMap": "+ topic/fig learningInteractionBase-d/figgroup learning-d/lcHotspotMap ",
+    "lcHotspotMap2": "+ topic/fig learningInteractionBase2-d/figgroup learning2-d/lcHotspotMap2 ",
+    "lcInstruction": "- topic/section learningBase/lcInstruction ",
+    "lcInstructornote": "+ topic/note learningInteractionBase-d/note learning-d/lcInstructornote ",
+    "lcInstructornote2": "+ topic/note learningInteractionBase2-d/note learning2-d/lcInstructornote2 ",
+    "lcInteraction": "- topic/section learningBase/lcInteraction ",
+    "lcInteractionBase": "+ topic/fig learningInteractionBase-d/lcInteractionBase ",
+    "lcInteractionBase2": "+ topic/div learningInteractionBase2-d/lcInteractionBase2 ",
+    "lcInteractionLabel2": "+ topic/p   learningInteractionBase2-d/lcInteractionLabel2 ",
+    "lcIntervention": "- topic/section  learningBase/section learningPlan/lcIntervention ",
+    "lcInterventionItem": "- topic/fig  learningBase/fig learningPlan/lcInterventionItem ",
+    "lcIntro": "- topic/section learningBase/lcIntro ",
+    "lcItem": "+ topic/stentry learningInteractionBase-d/stentry learning-d/lcItem ",
+    "lcItem2": "+ topic/stentry learningInteractionBase2-d/stentry learning2-d/lcItem2 ",
+    "lcJtaItem": "- topic/p  learningBase/p learningPlan/lcJtaItem ",
+    "lcKnowledge": "- topic/p  learningBase/p learningPlan/lcKnowledge ",
+    "lcLMS": "- topic/fig  learningBase/fig learningPlan/lcLMS ",
+    "lcLearnStrat": "- topic/p  learningBase/p learningPlan/lcLearnStrat ",
+    "lcLom": "+ topic/metadata learningmeta-d/lcLom ",
+    "lcMatchTable": "+ topic/simpletable learningInteractionBase-d/simpletable learning-d/lcMatchTable ",
+    "lcMatchTable2": "+ topic/simpletable learningInteractionBase2-d/simpletable learning2-d/lcMatchTable2 ",
+    "lcMatching": "+ topic/fig learningInteractionBase-d/lcInteractionBase learning-d/lcMatching ",
+    "lcMatching2": "+ topic/div learningInteractionBase2-d/lcInteractionBase2 learning2-d/lcMatching2 ",
+    "lcMatchingHeader": "+ topic/sthead learningInteractionBase-d/sthead learning-d/lcMatchingHeader ",
+    "lcMatchingHeader2": "+ topic/sthead learningInteractionBase2-d/sthead learning2-d/lcMatchingHeader2 ",
+    "lcMatchingItem": "+ topic/stentry learningInteractionBase-d/stentry learning-d/lcMatchingItem ",
+    "lcMatchingItem2": "+ topic/stentry learningInteractionBase2-d/stentry learning2-d/lcMatchingItem2 ",
+    "lcMatchingItemFeedback": "+ topic/stentry learningInteractionBase-d/stentry learning-d/lcMatchingItemFeedback ",
+    "lcMatchingItemFeedback2": "+ topic/stentry learningInteractionBase2-d/stentry learning2-d/lcMatchingItemFeedback2 ",
+    "lcMatchingPair": "+ topic/strow learningInteractionBase-d/strow learning-d/lcMatchingPair ",
+    "lcMatchingPair2": "+ topic/strow learningInteractionBase2-d/strow learning2-d/lcMatchingPair2 ",
+    "lcModDate": "- topic/fig  learningBase/fig learningPlan/lcModDate ",
+    "lcMotivation": "- topic/p  learningBase/p learningPlan/lcMotivation ",
+    "lcMultipleSelect": "+ topic/fig learningInteractionBase-d/lcInteractionBase learning-d/lcMultipleSelect ",
+    "lcMultipleSelect2": "+ topic/div learningInteractionBase2-d/lcInteractionBase2 learning2-d/lcMultipleSelect2 ",
+    "lcNeeds": "- topic/p  learningBase/p learningPlan/lcNeeds ",
+    "lcNeedsAnalysis": "- topic/section  learningBase/section learningPlan/lcNeedsAnalysis ",
+    "lcNextSteps": "- topic/section learningBase/lcNextSteps ",
+    "lcNoLMS": "- topic/fig  learningBase/fig learningPlan/lcNoLMS ",
+    "lcOJT": "- topic/fig  learningBase/fig learningPlan/lcOJT ",
+    "lcObjective": "- topic/li learningBase/lcObjective ",
+    "lcObjectives": "- topic/section learningBase/lcObjectives ",
+    "lcObjectivesGroup": "- topic/ul learningBase/lcObjectivesGroup ",
+    "lcObjectivesStem": "- topic/ph learningBase/lcObjectivesStem ",
+    "lcOpenAnswer": "+ topic/p learningInteractionBase-d/p learning-d/lcOpenAnswer ",
+    "lcOpenAnswer2": "+ topic/div learningInteractionBase2-d/div learning2-d/lcOpenAnswer2 ",
+    "lcOpenQuestion": "+ topic/fig learningInteractionBase-d/lcInteractionBase learning-d/lcOpenQuestion ",
+    "lcOpenQuestion2": "+ topic/div learningInteractionBase2-d/lcInteractionBase2 learning2-d/lcOpenQuestion2 ",
+    "lcOrgConstraints": "- topic/p  learningBase/p learningPlan/lcOrgConstraints ",
+    "lcOrganizational": "- topic/fig  learningBase/fig learningPlan/lcOrganizational ",
+    "lcPlanAudience": "- topic/fig  learningBase/fig learningPlan/lcPlanAudience ",
+    "lcPlanDescrip": "- topic/fig  learningBase/fig learningPlan/lcPlanDescrip ",
+    "lcPlanObjective": "- topic/p  learningBase/p learningPlan/lcPlanObjective ",
+    "lcPlanPrereqs": "- topic/fig  learningBase/fig learningPlan/lcPlanPrereqs ",
+    "lcPlanResources": "- topic/p  learningBase/p learningPlan/lcPlanResources ",
+    "lcPlanSubject": "- topic/fig  learningBase/fig learningPlan/lcPlanSubject ",
+    "lcPlanTitle": "- topic/fig  learningBase/fig learningPlan/lcPlanTitle ",
+    "lcPlayers": "- topic/fig  learningBase/fig learningPlan/lcPlayers ",
+    "lcPrereqs": "- topic/section learningBase/lcPrereqs ",
+    "lcProcesses": "- topic/p  learningBase/p learningPlan/lcProcesses ",
+    "lcProject": "- topic/section  learningBase/section learningPlan/lcProject ",
+    "lcQuestion": "+ topic/p learningInteractionBase-d/lcQuestionBase learning-d/lcQuestion ",
+    "lcQuestion2": "+ topic/div learningInteractionBase2-d/lcQuestionBase2 learning2-d/lcQuestion2 ",
+    "lcQuestionBase": "+ topic/p   learningInteractionBase-d/lcQuestionBase ",
+    "lcQuestionBase2": "+ topic/div   learningInteractionBase2-d/lcQuestionBase2 ",
+    "lcResolution": "- topic/fig  learningBase/fig learningPlan/lcResolution ",
+    "lcResources": "- topic/section learningBase/lcResources ",
+    "lcReview": "- topic/section learningBase/lcReview ",
+    "lcSecurity": "- topic/fig  learningBase/fig learningPlan/lcSecurity ",
+    "lcSequence": "+ topic/data learningInteractionBase-d/data learning-d/lcSequence ",
+    "lcSequence2": "+ topic/data learningInteractionBase2-d/data learning2-d/lcSequence2 ",
+    "lcSequenceOption": "+ topic/li learningInteractionBase-d/li learning-d/lcSequenceOption ",
+    "lcSequenceOption2": "+ topic/li learningInteractionBase2-d/li learning2-d/lcSequenceOption2 ",
+    "lcSequenceOptionGroup": "+ topic/ol learningInteractionBase-d/ol learning-d/lcSequenceOptionGroup ",
+    "lcSequenceOptionGroup2": "+ topic/ol learningInteractionBase2-d/ol learning2-d/lcSequenceOptionGroup2 ",
+    "lcSequencing": "+ topic/fig learningInteractionBase-d/lcInteractionBase learning-d/lcSequencing ",
+    "lcSequencing2": "+ topic/div learningInteractionBase2-d/lcInteractionBase2 learning2-d/lcSequencing2 ",
+    "lcSingleSelect": "+ topic/fig learningInteractionBase-d/lcInteractionBase learning-d/lcSingleSelect ",
+    "lcSingleSelect2": "+ topic/div learningInteractionBase2-d/lcInteractionBase2 learning2-d/lcSingleSelect2 ",
+    "lcSkills": "- topic/p  learningBase/p learningPlan/lcSkills ",
+    "lcSpecChars": "- topic/p  learningBase/p learningPlan/lcSpecChars ",
+    "lcSummary": "- topic/section learningBase/lcSummary ",
+    "lcTask": "- topic/fig  learningBase/fig learningPlan/lcTask ",
+    "lcTaskItem": "- topic/p  learningBase/p learningPlan/lcTaskItem ",
+    "lcTechnical": "- topic/section  learningBase/section learningPlan/lcTechnical ",
+    "lcTime": "- topic/data learningBase/lcTime ",
+    "lcTrueFalse": "+ topic/fig learningInteractionBase-d/lcInteractionBase learning-d/lcTrueFalse ",
+    "lcTrueFalse2": "+ topic/div learningInteractionBase2-d/lcInteractionBase2 learning2-d/lcTrueFalse2 ",
+    "lcValues": "- topic/p  learningBase/p learningPlan/lcValues ",
+    "lcViewers": "- topic/fig  learningBase/fig learningPlan/lcViewers ",
+    "lcW3C": "- topic/fig  learningBase/fig learningPlan/lcW3C ",
+    "lcWorkEnv": "- topic/fig  learningBase/fig learningPlan/lcWorkEnv ",
+    "lcWorkEnvDescription": "- topic/p  learningBase/p learningPlan/lcWorkEnvDescription ",
+    "learningAssessment": "- topic/topic learningBase/learningBase     learningAssessment/learningAssessment ",
+    "learningAssessmentbody": "- topic/body  learningBase/learningBasebody learningAssessment/learningAssessmentbody ",
+    "learningBase": "- topic/topic learningBase/learningBase ",
+    "learningBasebody": "- topic/body learningBase/learningBasebody ",
+    "learningContent": "- topic/topic learningBase/learningBase learningContent/learningContent ",
+    "learningContentComponentRef": "+ map/topicref learningmap-d/learningContentComponentRef ",
+    "learningContentRef": "+ map/topicref learningmap-d/learningContentRef ",
+    "learningContentbody": "- topic/body  learningBase/learningBasebody learningContent/learningContentbody ",
+    "learningGroup": "+ map/topicref learningmap-d/learningGroup ",
+    "learningGroupMap": "- map/map learningGroupMap/learningGroupMap ",
+    "learningGroupMapRef": "+ map/topicref learningmap-d/learningGroupMapRef ",
+    "learningObject": "+ map/topicref learningmap-d/learningObject ",
+    "learningObjectMap": "- map/map learningObjectMap/learningObjectMap ",
+    "learningObjectMapRef": "+ map/topicref learningmap-d/learningObjectMapRef ",
+    "learningOverview": "- topic/topic learningBase/learningBase     learningOverview/learningOverview ",
+    "learningOverviewRef": "+ map/topicref learningmap-d/learningOverviewRef ",
+    "learningOverviewbody": "- topic/body  learningBase/learningBasebody learningOverview/learningOverviewbody ",
+    "learningPlan": "- topic/topic learningBase/learningBase learningPlan/learningPlan ",
+    "learningPlanRef": "+ map/topicref learningmap-d/learningPlanRef ",
+    "learningPlanbody": "- topic/body  learningBase/learningBasebody learningPlan/learningPlanbody ",
+    "learningPostAssessmentRef": "+ map/topicref learningmap-d/learningPostAssessmentRef ",
+    "learningPreAssessmentRef": "+ map/topicref learningmap-d/learningPreAssessmentRef ",
+    "learningSummary": "- topic/topic learningBase/learningBase     learningSummary/learningSummary ",
+    "learningSummaryRef": "+ map/topicref learningmap-d/learningSummaryRef ",
+    "learningSummarybody": "- topic/body  learningBase/learningBasebody learningSummary/learningSummarybody ",
+    "li": "- topic/li ",
+    "line-through": "+ topic/ph hi-d/line-through ",
+    "lines": "- topic/lines ",
+    "link": "- topic/link ",
+    "linkinfo": "- topic/linkinfo ",
+    "linklist": "- topic/linklist ",
+    "linkpool": "- topic/linkpool ",
+    "linktext": "- topic/linktext ",
+    "locality": "+ topic/ph xnal-d/locality ",
+    "localityname": "+ topic/ph xnal-d/localityname ",
+    "lomAggregationLevel": "+ topic/data learningmeta-d/lomAggregationLevel ",
+    "lomContext": "+ topic/data learningmeta-d/lomContext ",
+    "lomCoverage": "+ topic/data learningmeta-d/lomCoverage ",
+    "lomDifficulty": "+ topic/data learningmeta-d/lomDifficulty ",
+    "lomInstallationRemarks": "+ topic/data learningmeta-d/lomInstallationRemarks ",
+    "lomIntendedUserRole": "+ topic/data learningmeta-d/lomIntendedUserRole ",
+    "lomInteractivityLevel": "+ topic/data learningmeta-d/lomInteractivityLevel ",
+    "lomInteractivityType": "+ topic/data learningmeta-d/lomInteractivityType ",
+    "lomLearningResourceType": "+ topic/data learningmeta-d/lomLearningResourceType ",
+    "lomOtherPlatformRequirements": "+ topic/data learningmeta-d/lomOtherPlatformRequirements ",
+    "lomSemanticDensity": "+ topic/data learningmeta-d/lomSemanticDensity ",
+    "lomStructure": "+ topic/data learningmeta-d/lomStructure ",
+    "lomTechRequirement": "+ topic/data learningmeta-d/lomTechRequirement ",
+    "lomTypicalAgeRange": "+ topic/data learningmeta-d/lomTypicalAgeRange ",
+    "lomTypicalLearningTime": "+ topic/data learningmeta-d/lomTypicalLearningTime ",
+    "longdescref": "- topic/longdescref ",
+    "longquoteref": "- topic/longquoteref ",
+    "lq": "- topic/lq ",
+    "mainbooktitle": "- topic/ph bookmap/mainbooktitle ",
+    "maintainer": "- topic/data bookmap/maintainer ",
+    "map": "- map/map ",
+    "mapref": "+ map/topicref mapgroup-d/mapref ",
+    "markupname": "+ topic/keyword markup-d/markupname ",
+    "mathml": "+ topic/foreign mathml-d/mathml ",
+    "mathmlref": "+ topic/xref mathml-d/mathmlref ",
+    "menucascade": "+ topic/ph ui-d/menucascade ",
+    "messagepanel": "+ topic/ul hazard-d/messagepanel ",
+    "metadata": "- topic/metadata ",
+    "middlename": "+ topic/data xnal-d/middlename ",
+    "month": "- topic/ph bookmap/month ",
+    "msgblock": "+ topic/pre sw-d/msgblock ",
+    "msgnum": "+ topic/keyword sw-d/msgnum ",
+    "msgph": "+ topic/ph sw-d/msgph ",
+    "namedetails": "+ topic/data xnal-d/namedetails ",
+    "navref": "- map/navref ",
+    "navtitle": "- topic/navtitle ",
+    "no-topic-nesting": "- topic/no-topic-nesting ",
+    "noconds": "+ topic/li task/li taskreq-d/noconds ",
+    "nosafety": "+ topic/li task/li taskreq-d/nosafety ",
+    "nospares": "+ topic/data task/data taskreq-d/nospares ",
+    "nosupeq": "+ topic/data task/data taskreq-d/nosupeq ",
+    "nosupply": "+ topic/data task/data taskreq-d/nosupply ",
+    "note": "- topic/note ",
+    "notices": "- map/topicref bookmap/notices ",
+    "numcharref": "+ topic/keyword markup-d/markupname xml-d/numcharref ",
+    "object": "- topic/object ",
+    "ol": "- topic/ol ",
+    "oper": "+ topic/ph pr-d/oper ",
+    "option": "+ topic/keyword pr-d/option ",
+    "organization": "- topic/data bookmap/organization ",
+    "organizationinfo": "+ topic/data xnal-d/organizationinfo ",
+    "organizationname": "+ topic/ph xnal-d/organizationname ",
+    "organizationnamedetails": "+ topic/ph xnal-d/organizationnamedetails ",
+    "otherinfo": "+ topic/data xnal-d/otherinfo ",
+    "othermeta": "- topic/othermeta ",
+    "overline": "+ topic/ph hi-d/overline ",
+    "p": "- topic/p ",
+    "param": "- topic/param ",
+    "parameterentity": "+ topic/keyword markup-d/markupname xml-d/parameterentity ",
+    "parml": "+ topic/dl pr-d/parml ",
+    "parmname": "+ topic/keyword pr-d/parmname ",
+    "part": "- map/topicref bookmap/part ",
+    "pd": "+ topic/dd pr-d/pd ",
+    "permissions": "- topic/permissions ",
+    "perscat": "+ topic/li task/li taskreq-d/perscat ",
+    "perskill": "+ topic/li task/li taskreq-d/perskill ",
+    "person": "- topic/data bookmap/person ",
+    "personinfo": "+ topic/data xnal-d/personinfo ",
+    "personname": "+ topic/data xnal-d/personname ",
+    "personnel": "+ topic/li task/li taskreq-d/personnel ",
+    "ph": "- topic/ph ",
+    "platform": "- topic/platform ",
+    "plentry": "+ topic/dlentry pr-d/plentry ",
+    "postalcode": "+ topic/ph xnal-d/postalcode ",
+    "postreq": "- topic/section task/postreq ",
+    "pre": "- topic/pre ",
+    "preface": "- map/topicref bookmap/preface ",
+    "prelreqs": "+ topic/section task/prereq taskreq-d/prelreqs ",
+    "prereq": "- topic/section task/prereq ",
+    "printlocation": "- topic/data bookmap/printlocation ",
+    "prodinfo": "- topic/prodinfo ",
+    "prodname": "- topic/prodname ",
+    "prognum": "- topic/prognum ",
+    "prolog": "- topic/prolog ",
+    "propdesc": "- topic/stentry     reference/propdesc ",
+    "propdeschd": "- topic/stentry     reference/propdeschd ",
+    "properties": "- topic/simpletable reference/properties ",
+    "property": "- topic/strow       reference/property ",
+    "prophead": "- topic/sthead      reference/prophead ",
+    "proptype": "- topic/stentry     reference/proptype ",
+    "proptypehd": "- topic/stentry     reference/proptypehd ",
+    "propvalue": "- topic/stentry     reference/propvalue ",
+    "propvaluehd": "- topic/stentry     reference/propvaluehd ",
+    "pt": "+ topic/dt pr-d/pt ",
+    "published": "- topic/data bookmap/published ",
+    "publisher": "- topic/publisher ",
+    "publisherinformation": "- topic/publisher bookmap/publisherinformation ",
+    "publishtype": "- topic/data bookmap/publishtype ",
+    "q": "- topic/q ",
+    "refbody": "- topic/body        reference/refbody ",
+    "refbodydiv": "- topic/bodydiv     reference/refbodydiv ",
+    "reference": "- topic/topic       reference/reference ",
+    "refsyn": "- topic/section     reference/refsyn ",
+    "related-links": "- topic/related-links ",
+    "relatedSubjects": "- map/topicref subjectScheme/relatedSubjects ",
+    "relcell": "- map/relcell ",
+    "relcolspec": "- map/relcolspec ",
+    "relheader": "- map/relheader ",
+    "relrow": "- map/relrow ",
+    "reltable": "- map/reltable ",
+    "remedy": "- topic/section troubleshooting/remedy ",
+    "repsep": "+ topic/ph pr-d/repsep ",
+    "reqcond": "+ topic/li task/li taskreq-d/reqcond ",
+    "reqconds": "+ topic/ul task/ul taskreq-d/reqconds ",
+    "reqcontp": "+ topic/li task/li taskreq-d/reqcontp ",
+    "reqpers": "+ topic/ul task/ul taskreq-d/reqpers ",
+    "required-cleanup": "- topic/required-cleanup ",
+    "resourceid": "- topic/resourceid ",
+    "responsibleParty": "- topic/p troubleshooting/responsibleParty ",
+    "result": "- topic/section task/result ",
+    "reviewed": "- topic/data bookmap/reviewed ",
+    "revised": "- topic/revised ",
+    "revisionid": "- topic/ph bookmap/revisionid ",
+    "row": "- topic/row ",
+    "safecond": "+ topic/li task/li taskreq-d/safecond ",
+    "safety": "+ topic/ol task/ol taskreq-d/safety ",
+    "schemeref": "- map/topicref subjectScheme/schemeref ",
+    "screen": "+ topic/pre ui-d/screen ",
+    "searchtitle": "- topic/searchtitle ",
+    "section": "- topic/section ",
+    "sectiondiv": "- topic/sectiondiv ",
+    "sep": "+ topic/ph pr-d/sep ",
+    "series": "- topic/series ",
+    "shape": "+ topic/keyword ut-d/shape ",
+    "shortcut": "+ topic/keyword ui-d/shortcut ",
+    "shortdesc": "- topic/shortdesc ",
+    "simpletable": "- topic/simpletable ",
+    "sl": "- topic/sl ",
+    "sli": "- topic/sli ",
+    "sort-as": "+ topic/data ut-d/sort-as ",
+    "source": "- topic/source ",
+    "spare": "+ topic/li task/li taskreq-d/spare ",
+    "spares": "+ topic/p task/p taskreq-d/spares ",
+    "sparesli": "+ topic/ul task/ul taskreq-d/sparesli ",
+    "started": "- topic/ph bookmap/started ",
+    "state": "- topic/state ",
+    "stentry": "- topic/stentry ",
+    "step": "- topic/li task/step ",
+    "stepresult": "- topic/itemgroup task/stepresult ",
+    "steps": "- topic/ol task/steps ",
+    "steps-informal": "- topic/section task/steps-informal ",
+    "steps-unordered": "- topic/ul task/steps-unordered ",
+    "stepsection": "- topic/li task/stepsection ",
+    "steptroubleshooting": "- topic/itemgroup task/steptroubleshooting ",
+    "stepxmp": "- topic/itemgroup task/stepxmp ",
+    "sthead": "- topic/sthead ",
+    "strow": "- topic/strow ",
+    "sub": "+ topic/ph hi-d/sub ",
+    "subjectCell": "+ map/relcell classify-d/subjectCell ",
+    "subjectHead": "- map/topicref subjectScheme/subjectHead ",
+    "subjectHeadMeta": "- map/topicmeta subjectScheme/subjectHeadMeta ",
+    "subjectRel": "- map/relrow subjectScheme/subjectRel ",
+    "subjectRelHeader": "- map/relrow subjectScheme/subjectRelHeader ",
+    "subjectRelTable": "- map/reltable subjectScheme/subjectRelTable ",
+    "subjectRole": "- map/relcell subjectScheme/subjectRole ",
+    "subjectScheme": "- map/map subjectScheme/subjectScheme ",
+    "subjectdef": "- map/topicref subjectScheme/subjectdef ",
+    "subjectref": "+ map/topicref classify-d/subjectref ",
+    "substep": "- topic/li task/substep ",
+    "substeps": "- topic/ol task/substeps ",
+    "summary": "- topic/ph bookmap/summary ",
+    "sup": "+ topic/ph hi-d/sup ",
+    "supeqli": "+ topic/ul task/ul taskreq-d/supeqli ",
+    "supequi": "+ topic/li task/li taskreq-d/supequi ",
+    "supequip": "+ topic/p task/p taskreq-d/supequip ",
+    "supplies": "+ topic/p task/p taskreq-d/supplies ",
+    "supply": "+ topic/li task/li taskreq-d/supply ",
+    "supplyli": "+ topic/ul task/ul taskreq-d/supplyli ",
+    "svg-container": "+ topic/foreign svg-d/svg-container ",
+    "svgref": "+ topic/xref svg-d/svgref ",
+    "synblk": "+ topic/figgroup pr-d/synblk ",
+    "synnote": "+ topic/fn pr-d/synnote ",
+    "synnoteref": "+ topic/xref pr-d/synnoteref ",
+    "synph": "+ topic/ph pr-d/synph ",
+    "syntaxdiagram": "+ topic/fig pr-d/syntaxdiagram ",
+    "systemoutput": "+ topic/ph sw-d/systemoutput ",
+    "table": "- topic/table ",
+    "tablelist": "- map/topicref bookmap/tablelist ",
+    "task": "- topic/topic task/task ",
+    "taskbody": "- topic/body task/taskbody ",
+    "tasktroubleshooting": "- topic/section task/tasktroubleshooting ",
+    "tbody": "- topic/tbody ",
+    "term": "- topic/term ",
+    "tested": "- topic/data bookmap/tested ",
+    "text": "- topic/text ",
+    "textentity": "+ topic/keyword markup-d/markupname xml-d/textentity ",
+    "tgroup": "- topic/tgroup ",
+    "thead": "- topic/thead ",
+    "thoroughfare": "+ topic/ph xnal-d/thoroughfare ",
+    "title": "- topic/title ",
+    "titlealts": "- topic/titlealts ",
+    "tm": "- topic/tm ",
+    "toc": "- map/topicref bookmap/toc ",
+    "topic": "- topic/topic ",
+    "topicCell": "+ map/relcell classify-d/topicCell ",
+    "topicSubjectHeader": "+ map/relrow classify-d/topicSubjectHeader ",
+    "topicSubjectRow": "+ map/relrow classify-d/topicSubjectRow ",
+    "topicSubjectTable": "+ map/reltable classify-d/topicSubjectTable ",
+    "topicapply": "+ map/topicref classify-d/topicapply ",
+    "topicgroup": "+ map/topicref mapgroup-d/topicgroup ",
+    "topichead": "+ map/topicref mapgroup-d/topichead ",
+    "topicmeta": "- map/topicmeta ",
+    "topicref": "- map/topicref ",
+    "topicset": "+ map/topicref mapgroup-d/topicset ",
+    "topicsetref": "+ map/topicref mapgroup-d/topicsetref ",
+    "topicsubject": "+ map/topicref classify-d/topicsubject ",
+    "trademarklist": "- map/topicref bookmap/trademarklist ",
+    "troubleSolution": "- topic/bodydiv troubleshooting/troubleSolution ",
+    "troublebody": "- topic/body troubleshooting/troublebody ",
+    "troubleshooting": "- topic/topic troubleshooting/troubleshooting ",
+    "tt": "+ topic/ph hi-d/tt ",
+    "tutorialinfo": "- topic/itemgroup task/tutorialinfo ",
+    "typeofhazard": "+ topic/li hazard-d/typeofhazard ",
+    "u": "+ topic/ph hi-d/u ",
+    "uicontrol": "+ topic/ph ui-d/uicontrol ",
+    "ul": "- topic/ul ",
+    "unknown": "- topic/unknown ",
+    "url": "+ topic/data xnal-d/url ",
+    "urls": "+ topic/data xnal-d/urls ",
+    "userinput": "+ topic/ph sw-d/userinput ",
+    "ux-window": "- map/ux-window ",
+    "var": "+ topic/ph pr-d/var ",
+    "varname": "+ topic/keyword sw-d/varname ",
+    "volume": "- topic/data bookmap/volume ",
+    "vrm": "- topic/vrm ",
+    "vrmlist": "- topic/vrmlist ",
+    "wintitle": "+ topic/keyword ui-d/wintitle ",
+    "xmlatt": "+ topic/keyword markup-d/markupname xml-d/xmlatt ",
+    "xmlelement": "+ topic/keyword markup-d/markupname xml-d/xmlelement ",
+    "xmlnsname": "+ topic/keyword markup-d/markupname xml-d/xmlnsname ",
+    "xmlpi": "+ topic/keyword markup-d/markupname xml-d/xmlpi ",
+    "xref": "- topic/xref ",
+    "year": "- topic/ph bookmap/year ",
+});
+/** Elements whose class differs inside a map (map.mod declares them too). */
+export const DITA_MAP_CLASS_DEFAULTS = Object.freeze({
+    "linktext": "- map/linktext ",
+    "searchtitle": "- map/searchtitle ",
+    "shortdesc": "- map/shortdesc ",
+});

package/dist/index.d.ts

@@ -18,3 +18,5 @@ export { ditaTopicToDogsbayMd, type DitaMarkdownResult } from "./markdown.js";
 export { planConrefs, type ConrefCorpusFile, type ConrefPlan, type ConrefSnippet, } from "./conref.js";
 export { DB_QUALIFIERS } from "./blocks.js";
 export { checkWellFormed, type WellFormedProblem } from "./well-formed.js";
+export { DITA_CLASS_DEFAULTS, DITA_MAP_CLASS_DEFAULTS } from "./class-defaults.js";
+export { applyClassDefaults, classDefault } from "./class-defaults-apply.js";

package/dist/index.js

@@ -19,3 +19,5 @@ export { planConrefs, } from "./conref.js";
 // The closed db- qualifier vocabulary (tones, tab variants, scoped themes)
 export { DB_QUALIFIERS } from "./blocks.js";
 export { checkWellFormed } from "./well-formed.js";
+export { DITA_CLASS_DEFAULTS, DITA_MAP_CLASS_DEFAULTS } from "./class-defaults.js";
+export { applyClassDefaults, classDefault } from "./class-defaults-apply.js";

package/dist/inline.d.ts

@@ -9,6 +9,8 @@ export interface InlineContext {
     conref?: ConrefSiteContext;
     /** Publishing mode: DITA-OT preprocessed input (absent for migration). */
     publish?: PublishContext;
+    /** Every element carries @class (DTD defaults filled in): resolve unknown names by it, as publishing does. */
+    classes?: boolean;
     /** Publishing: trademarks already marked in this topic (DITA-OT marks only the first). */
     trademarks?: Set<string>;
     /** Publishing: the number label of each titled table and figure ("Table 1. "). */

package/dist/inline.js

@@ -83,7 +83,7 @@ const BOLD_LIKE = new Set(["b", "strong", "uicontrol", "wintitle", "menucascade"
  */
 export const elementName = (el, ctx, known) => {
     const raw = el.name.toLowerCase();
-    if (!ctx.publish || known(raw))
+    if (!(ctx.publish || ctx.classes) || known(raw))
         return raw;
     const tokens = (el.attribs?.class ?? "").trim().split(/\s+/).slice(1).reverse();
     for (const token of tokens) {

package/dist/parse.js

@@ -1,4 +1,5 @@
 import { checkWellFormed } from "./well-formed.js";
+import { applyClassDefaults } from "./class-defaults-apply.js";
 import { parseDocument } from "htmlparser2";
 import { convertChildren, convertItemContent } from "./blocks.js";
 import { textOf, convertInline, trimInline, collapseWhitespace } from "./inline.js";
@@ -104,7 +105,7 @@ const convertSecondaryTopic = (el, ctx, level, bindConrefSite) => {
         }
         if (name === "titlealts")
             continue;
-        if (isTopicElement(child, !!ctx.publish)) {
+        if (isTopicElement(child, !!ctx.publish || !!ctx.classes)) {
             out.push(...convertSecondaryTopic(child, ctx, bodyLevel, bindConrefSite));
             continue;
         }
@@ -225,7 +226,15 @@ export function ditaTopicToTree(xml, options = {}) {
     if (malformed)
         note("<xml>", `not well-formed XML, line ${malformed.line}: ${malformed.message} — the converted content may be incomplete`);
     const doc = parseDocument(xml, { xmlMode: true });
-    const roots = findTopicRoots(doc.children, !!options.publish);
+    // Raw source: fill in the @class the DTDs default, so specializations convert as their base
+    if (options.classDefaults) {
+        const undeclared = applyClassDefaults(doc.children);
+        if (undeclared.length) {
+            note("@class", `no DITA 1.3 class default for ${undeclared.map((n) => `<${n}>`).join(", ")} — converted by name only`);
+        }
+    }
+    const byClass = !!options.publish || !!options.classDefaults;
+    const roots = findTopicRoots(doc.children, byClass);
     const root = roots[0] ?? null;
     if (!root) {
         note("<topic>", "no DITA topic root element found (concept/task/reference/topic/glossentry)");
@@ -274,6 +283,7 @@ export function ditaTopicToTree(xml, options = {}) {
         note,
         seenConstructs: new Set(),
         headingLevel: 2,
+        ...(options.classDefaults ? { classes: true } : {}),
         ...(bindConrefSite ? { conref: bindConrefSite(root.attribs?.id) } : {}),
         ...(options.publish
             ? { publish: options.publish, trademarks: new Set(), footnotes: [], topicId: root.attribs?.id, anchorIds: renamedElementIds(doc.children) }
@@ -332,7 +342,7 @@ export function ditaTopicToTree(xml, options = {}) {
             extractProlog(child, meta, ctx);
             continue;
         }
-        if (isTopicElement(child, !!options.publish)) {
+        if (isTopicElement(child, byClass)) {
             // Nested topic: convert inline as a section (chunked authoring)
             tree.push(...convertSecondaryTopic(child, ctx, 2, bindConrefSite));
             continue;

package/dist/types.d.ts

@@ -152,6 +152,16 @@ export interface DitaParseOptions {
      * its behavior unchanged.
      */
     publish?: PublishContext;
+    /**
+     * Fill in each missing @class from the DITA 1.3 DTD defaults (612 elements,
+     * see class-defaults.ts) before converting, as parsing against the DTDs
+     * would. Raw source has no @class, so without it an element is known only by
+     * its name, and a specialization the converter does not know by name loses
+     * its markup; with it, it converts as what it specializes. An existing
+     * @class is kept; a name the DTDs do not declare stays unclassed and is
+     * noted once. Off by default (it changes the output for such elements).
+     */
+    classDefaults?: boolean;
 }
 /** DITA topic root elements this importer understands. */
 export declare const DITA_TOPIC_TYPES: readonly ["concept", "task", "reference", "topic", "glossentry"];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dogsbay/format-dita",
-  "version": "0.2.0-beta.123",
+  "version": "0.2.0-beta.124",
   "description": "DITA topic XML → TreeNode importer with conversion-note ledger; composes with format-dogsbay-md for .dita → .md migration. Browser-safe: no Node built-ins",
   "type": "module",
   "main": "dist/index.js",
@@ -28,8 +28,8 @@
   "dependencies": {
     "domhandler": "^5.0.3",
     "htmlparser2": "^10.1.0",
-    "@dogsbay/format-dogsbay-md": "0.2.0-beta.123",
-    "@dogsbay/types": "0.2.0-beta.123"
+    "@dogsbay/format-dogsbay-md": "0.2.0-beta.124",
+    "@dogsbay/types": "0.2.0-beta.124"
   },
   "license": "MIT",
   "repository": {