fix #15, add support for @@meta('doc:ignore', true) in includeInternalModels

Author: lsmith77

README.md

@@ -155,7 +155,7 @@ plugin documentation {
 | `cleanOutput` | `boolean` | `false` | When `true`, the output directory is removed before generation to ensure a clean build (use with caution) |
 | `title` | `string` | `"Schema Documentation"` | Heading on the index page |
 | `fieldOrder` | `"declaration"` or `"alphabetical"` | `"declaration"` | How fields are ordered in tables |
-| `includeInternalModels` | `boolean` | `false` | Include models marked `@@ignore` in output |
+| `includeInternalModels` | `boolean` | `false` | Include models marked `@@ignore` or annotated with `@@meta('doc:ignore', true)` in output |
 | `includeRelationships` | `boolean` | `true` | Generate relationship sections and `relationships.md` |
 | `includePolicies` | `boolean` | `true` | Generate access policy tables |
 | `includeValidation` | `boolean` | `true` | Generate validation rule tables |

src/extractors.ts

@@ -306,7 +306,24 @@ export function isFieldRequired(field: DataField): boolean {
  * Returns `true` if the model has the `@@ignore` attribute.
  */
 export function isIgnoredModel(model: DataModel): boolean {
-  return model.attributes.some((a) => a.decl.ref?.name === '@@ignore');
+  if (model.attributes.some((a) => a.decl.ref?.name === '@@ignore')) {
+    return true;
+  }
+
+  // Support @@meta('doc:ignore', true)
+  for (const attribute of model.attributes) {
+    if (attribute.decl.ref?.name !== '@@meta') {
+      continue;
+    }
+
+    const key = stripQuotes(attribute.args[0]?.$cstNode?.text ?? '');
+    const value = stripQuotes(attribute.args[1]?.$cstNode?.text ?? '');
+    if (key === 'doc:ignore' && value === 'true') {
+      return true;
+    }
+  }
+
+  return false;
 }
 
 /**