@domorium/validator 1.2.0 → 1.4.0

package/dist/types/errors.d.ts

@@ -1,4 +1,38 @@
 import { Range } from "./position";
+/**
+ * Every code this package emits. A consumer filters, suppresses or offers a
+ * fix by code, so each kind of problem needs one of its own.
+ */
+export declare enum GedcomErrorCode {
+    /** A tag the schema does not define in this position. */
+    UnknownTag = "VAL001",
+    /** A structure the schema requires is absent. */
+    MissingTag = "VAL002",
+    /** The payload is absent where one is required. */
+    MissingValue = "VAL003",
+    /** The payload is present and does not match its data type. */
+    IncorrectValue = "VAL004",
+    /** The payload is not one of the values the schema permits here. */
+    ShouldBeSetValue = "VAL005",
+    /** A pointer payload that is not written as a pointer. */
+    MissingRef = "VAL006",
+    /** More occurrences than the cardinality allows. */
+    ManyOccurrences = "VAL007",
+    /** A GEDCOM 7 extension tag used without a HEAD.SCHMA declaration. */
+    UndocumentedTag = "VAL008",
+    /** A tag declared more than once in HEAD.SCHMA. */
+    DuplicateDeclaration = "VAL009",
+    /** An event with neither a payload nor substructures asserts nothing. */
+    EmptyEvent = "VAL010",
+    /** A pointer whose xref names no record of the required type. */
+    UnresolvedXref = "unresolved-xref",
+    /** A line whose level cannot follow the line above it. */
+    InvalidLevel = "invalid-level",
+    /** The text could not be tokenized. */
+    Lexer = "LEXER",
+    /** The tokens could not be assembled into a tree. */
+    Parser = "PARSER"
+}
 export interface GedcomError {
     code: string;
     message: string;

package/dist/validator/date-v7.d.ts

@@ -0,0 +1,9 @@
+import { GedcomScheme } from "../schemes/schema-types";
+import { ExtensionContext } from "./extensions";
+export declare function isValidDateValue(value: string, scheme: GedcomScheme, extensions?: ExtensionContext): boolean;
+export declare function isValidDatePeriod(value: string, scheme: GedcomScheme, extensions?: ExtensionContext): boolean;
+/**
+ * `DateExact` names no calendar and takes no epoch: it is day, month and year in
+ * the Gregorian calendar, and all three are required.
+ */
+export declare function isValidDateExact(value: string, scheme: GedcomScheme, extensions?: ExtensionContext): boolean;

package/dist/validator/extensions.d.ts

@@ -1,21 +1,22 @@
 import { ASTNode } from "../parser";
-import { GedcomTag } from "../schemes/schema-types";
+import { GedcomScheme, GedcomTag } from "../schemes/schema-types";
 import { GedcomError } from "../types/errors";
-export declare enum ExtensionErrorCode {
-    UndocumentedTag = "VAL008",
-    DuplicateDeclaration = "VAL009"
-}
+import { Range } from "../types/position";
 export declare function isExtensionTag(tag: string): boolean;
 export interface ExtensionContext {
     tags: Map<GedcomTag, string>;
+    aliases: Map<GedcomTag, GedcomTag>;
     requireDeclaration: boolean;
 }
 export declare function emptyExtensions(): ExtensionContext;
+/** The standard tag `tag` abbreviates, or `tag` itself. */
+export declare function resolveTag(extensions: ExtensionContext, tag: string): GedcomTag;
+export declare function undocumentedTag(tag: GedcomTag, range: Range): GedcomError;
 export declare function parseTagDef(value: string): {
     tag: GedcomTag;
     uri: string;
 } | null;
-export declare function collectExtensions(nodes: ASTNode[], requireDeclaration: boolean): {
+export declare function collectExtensions(nodes: ASTNode[], requireDeclaration: boolean, scheme: GedcomScheme): {
     context: ExtensionContext;
     errors: GedcomError[];
 };

package/dist/validator/index.d.ts

@@ -1 +1 @@
-export { GedcomValidator } from "./validate";
+export { GedcomValidator, schemeFor } from "./validate";

package/dist/validator/rule-node.d.ts

@@ -1,19 +1,21 @@
 import { GedcomScheme, GedcomType } from "../schemes/schema-types";
 import { ASTNode } from "../parser";
 import { GedcomError } from "../types/errors";
-type FieldType = "boolean" | "string" | "nonNegativeInteger" | "select" | "multiselect" | "date" | "date-period" | "date-exact" | "time" | "pointer" | "age" | "personal-name" | "media-type" | "language-tag" | "tag-def" | null;
+import { ExtensionContext } from "./extensions";
+type FieldType = "boolean" | "string" | "nonNegativeInteger" | "select" | "multiselect" | "date" | "date-v7" | "date-period" | "date-period-v7" | "date-exact" | "date-exact-v7" | "time" | "time-v7" | "pointer" | "age" | "personal-name" | "media-type" | "language-tag" | "tag-def" | null;
 export declare class RuleNode {
     private readonly scheme;
-    pointers: ASTNode[];
     private readonly pointerMap;
-    constructor(scheme: GedcomScheme, pointers: Map<string, ASTNode[]>);
+    private readonly extensions;
+    constructor(scheme: GedcomScheme, pointerMap: Map<string, ASTNode[]>, extensions?: ExtensionContext);
     /** Whether `xref` names a record of the kind this pointer type expects. */
     private isPointerTarget;
     getFieldType(tagType: GedcomType): {
         type: FieldType;
-        isList: boolean;
         to: GedcomType | undefined;
     };
+    private mayOmitPayload;
+    private validateEnumeration;
     getAvailableValues(tagType: GedcomType): string[] | null;
     /**
      * CONT/CONC are universal line-continuation tags: they are deliberately

package/dist/validator/validate.d.ts

@@ -2,6 +2,7 @@ import { GedcomType, GedcomScheme } from "../schemes/schema-types";
 import { ASTNode } from "../parser";
 import { GedcomError } from "../types/errors";
 import { ExtensionContext } from "./extensions";
+export declare function schemeFor(nodes: ASTNode[]): GedcomScheme;
 export declare class GedcomValidator {
     private readonly pointers;
     private readonly extensions;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@domorium/validator",
-  "version": "1.2.0",
+  "version": "1.4.0",
   "description": "GEDCOM 5.5.1 and 7.0 parser and validator",
   "keywords": [
     "gedcom",