@domorium/validator 1.5.0 → 1.6.0

package/CHANGELOG.md

@@ -2,6 +2,20 @@
 
 All notable changes to `@domorium/validator` are documented here.
 
+## 1.6.0 - 2026-08-12
+
+- **A fragment can be checked without being told it is not a file.** Text that is
+  part of a document rather than one of its own — a block pasted into a note, an
+  example in documentation, a selection — was judged as a whole file, so the one
+  thing certainly not the author's mistake was the first thing reported, and
+  nothing after it was read at all. `createDocument(text, { fragment: true,
+dialect })` reads the lines and goes quiet only about what the boundary caused:
+  the missing header and trailer, a pointer leaving the text, an extension tag
+  with no `HEAD.SCHMA` to declare it in. An unknown tag, a payload of the wrong
+  type and a level that cannot follow the line above are still reported.
+- `dialect` is named by the caller because a fragment carries no
+  `HEAD.GEDC.VERS`; without one there are still no rules to read it by.
+
 ## 1.5.0 - 2026-08-10
 
 - **The GEDCOM version is resolved against a table by longest match, and a

package/README.md

@@ -25,6 +25,23 @@ const document = new GedcomDocument().createDocument(gedcomString);
 const errors = document.getErrors();
 ```
 
+## Fragments
+
+A fenced block in a note, an example in documentation, a selection: text that is
+part of a document rather than one of its own.
+
+```typescript
+const block = new GedcomDocument().createDocument(text, {
+  fragment: true,
+  dialect: "7.0",
+});
+```
+
+What goes quiet is what the boundary caused — the header and trailer, a pointer
+leaving the text, an extension tag with no `HEAD.SCHMA` to declare it in.
+Everything else is still read. `dialect` is needed because a fragment carries no
+`HEAD.GEDC.VERS`.
+
 ## Diagnostics
 
 `getErrors()` returns `GedcomError[]`:

package/dist/document/gedcomDocument.d.ts

@@ -3,6 +3,12 @@ import { ASTNode, ASTToken } from "../parser";
 import { type GedcomDialect, type VersionResolution } from "../validator/versionRegistry";
 import { type GedcomCompletion } from "../completion/completion";
 import type { Position } from "../types/position";
+export interface CreateDocumentOptions {
+    /** Text that is part of a document rather than one of its own. */
+    fragment?: boolean;
+    /** A fragment carries no header, so the rules are named rather than read. */
+    dialect?: GedcomDialect;
+}
 export declare class GedcomDocument {
     private nodes;
     pointers: Map<string, ASTNode[]>;
@@ -13,7 +19,8 @@ export declare class GedcomDocument {
     private requiresSchmaDeclaration;
     private extensions;
     private parseGedcom;
-    createDocument(text: string): GedcomDocument;
+    createDocument(text: string, options?: CreateDocumentOptions): GedcomDocument;
+    private applyScheme;
     private validateLevels;
     getLabel(node: ASTNode): string | undefined;
     getPointerTargetTag(node: ASTNode): string | undefined;