@stxt-lang/core 0.5.1 → 0.5.3

package/out/schema/SchemaProviderMeta.js

@@ -6,7 +6,16 @@ const Parser_1 = require("../core/Parser");
 const ValidationException_1 = require("../exceptions/ValidationException");
 const RuntimeException_1 = require("../exceptions/RuntimeException");
 const SchemaParser_1 = require("./SchemaParser");
+/**
+ * {@link SchemaProvider} that defines in code the meta-schema of the schema language itself
+ * (`@stxt.schema`), so that a loaded schema can validate itself.
+ */
 class SchemaProviderMeta {
+    /**
+     * Parses the meta-schema and keeps it ready to be served.
+     *
+     * @throws ValidationException with code `META_SCHEMA_INVALID` if the meta-schema does not produce exactly one document.
+     */
     constructor() {
         const parser = new Parser_1.Parser();
         const nodes = parser.parse(SchemaProviderMeta.META_TEXT);
@@ -15,6 +24,13 @@ class SchemaProviderMeta {
         }
         this.meta = (0, SchemaParser_1.transformNodeToSchema)(nodes[0]);
     }
+    /**
+     * Serves the meta-schema of the schema language.
+     *
+     * @param namespace namespace whose schema is wanted; only `@stxt.schema` is served.
+     * @returns the meta-schema of the schema language.
+     * @throws RuntimeException with code `RESOURCE_NOT_FOUND` if any other namespace is asked for.
+     */
     getSchema(namespace) {
         if (namespace !== Schema_1.Schema.SCHEMA_NAMESPACE) {
             throw new RuntimeException_1.RuntimeException("RESOURCE_NOT_FOUND", `Not found '${namespace}' in namespace: ${Schema_1.Schema.SCHEMA_NAMESPACE}`);
@@ -26,67 +42,67 @@ class SchemaProviderMeta {
     }
 }
 exports.SchemaProviderMeta = SchemaProviderMeta;
-SchemaProviderMeta.META_TEXT = `Schema (@stxt.schema): @stxt.schema
-    Node: Schema
-        Children:
-            Child: Description
-                Max: 1
-            Child: Node
-                Min: 1
-    Node: Node
-        Children:
-            Child: Type
-                Max: 1
-            Child: Children
-                Max: 1
-            Child: Description
-                Max: 1
-            Child: Values
-                Max: 1
-    Node: Children
-        Type: GROUP
-        Children:
-            Child: Child
-                Min: 1
-    Node: Description
-        Type: TEXT
-    Node: Child
-        Children:
-            Child: Min
-                Max: 1
-            Child: Max
-                Max: 1
-    Node: Min
-        Type: NATURAL
-    Node: Max
-        Type: NATURAL
-    Node: Type
-        Type: ENUM
-        Values:
-            Value: INLINE
-            Value: BLOCK
-            Value: TEXT
-            Value: BOOLEAN
-            Value: URL
-            Value: INTEGER
-            Value: NATURAL
-            Value: NUMBER
-            Value: DATE
-            Value: TIME
-            Value: TIMESTAMP
-            Value: UUID
-            Value: EMAIL
-            Value: HEXADECIMAL
-            Value: BINARY
-            Value: BASE64
-            Value: GROUP
-            Value: ENUM
-            Value: MARKDOWN
-    Node: Values
-        Type: GROUP
-        Children:
-            Child: Value
-                Min: 1
-    Node: Value
+SchemaProviderMeta.META_TEXT = `Schema (@stxt.schema): @stxt.schema
+    Node: Schema
+        Children:
+            Child: Description
+                Max: 1
+            Child: Node
+                Min: 1
+    Node: Node
+        Children:
+            Child: Type
+                Max: 1
+            Child: Children
+                Max: 1
+            Child: Description
+                Max: 1
+            Child: Values
+                Max: 1
+    Node: Children
+        Type: GROUP
+        Children:
+            Child: Child
+                Min: 1
+    Node: Description
+        Type: TEXT
+    Node: Child
+        Children:
+            Child: Min
+                Max: 1
+            Child: Max
+                Max: 1
+    Node: Min
+        Type: NATURAL
+    Node: Max
+        Type: NATURAL
+    Node: Type
+        Type: ENUM
+        Values:
+            Value: INLINE
+            Value: BLOCK
+            Value: TEXT
+            Value: BOOLEAN
+            Value: URL
+            Value: INTEGER
+            Value: NATURAL
+            Value: NUMBER
+            Value: DATE
+            Value: TIME
+            Value: TIMESTAMP
+            Value: UUID
+            Value: EMAIL
+            Value: HEXADECIMAL
+            Value: BINARY
+            Value: BASE64
+            Value: GROUP
+            Value: ENUM
+            Value: MARKDOWN
+    Node: Values
+        Type: GROUP
+        Children:
+            Child: Value
+                Min: 1
+    Node: Value
 `;
 //# sourceMappingURL=SchemaProviderMeta.js.map

package/out/schema/SchemaValidator.d.ts

@@ -3,11 +3,31 @@ import { ValidationException } from "../exceptions/ValidationException";
 import { Validator } from "../processors/Validator";
 import { SchemaProvider } from "./SchemaProvider";
 import { Schema } from "./Schema";
+/** {@link Validator} that, for each node, resolves its {@link Schema} through a {@link SchemaProvider} and validates type and cardinality. */
 export declare class SchemaValidator implements Validator {
     private readonly schemaProvider;
     private readonly recursiveValidation;
+    /**
+     * Creates a validator that resolves schemas through the given provider.
+     *
+     * @param schemaProvider where to resolve the schema of each namespace from.
+     * @param recursive whether the children of each node are validated recursively too.
+     */
     constructor(schemaProvider: SchemaProvider, recursive?: boolean);
+    /**
+     * Validates a node against the schema of its namespace.
+     *
+     * @param node already closed node to validate.
+     * @returns the validation errors found, or an empty array if the node is valid.
+     */
     validate(node: Node): ValidationException[];
+    /**
+     * Validates a node against an already resolved schema: existence, value type and cardinalities of its children.
+     *
+     * @param node node to validate.
+     * @param schema schema to validate against.
+     * @returns the validation errors found, empty if the node is valid.
+     */
     validateAgainstSchema(node: Node, schema: Schema): ValidationException[];
     private static validateChildrenDeclared;
     private static validateValue;

package/out/schema/SchemaValidator.js

@@ -3,23 +3,36 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.SchemaValidator = void 0;
 const ValidationException_1 = require("../exceptions/ValidationException");
 const TypeRegistry_1 = require("./TypeRegistry");
+/** {@link Validator} that, for each node, resolves its {@link Schema} through a {@link SchemaProvider} and validates type and cardinality. */
 class SchemaValidator {
+    /**
+     * Creates a validator that resolves schemas through the given provider.
+     *
+     * @param schemaProvider where to resolve the schema of each namespace from.
+     * @param recursive whether the children of each node are validated recursively too.
+     */
     constructor(schemaProvider, recursive = false) {
         this.schemaProvider = schemaProvider;
         this.recursiveValidation = recursive;
     }
+    /**
+     * Validates a node against the schema of its namespace.
+     *
+     * @param node already closed node to validate.
+     * @returns the validation errors found, or an empty array if the node is valid.
+     */
     validate(node) {
         const errors = [];
-        // Obtenemos namespace
+        // Get the namespace
         const namespace = node.getNamespace();
         const schema = this.schemaProvider.getSchema(namespace);
         if (!schema) {
             errors.push(new ValidationException_1.ValidationException(node.getLine(), "SCHEMA_NOT_FOUND", `Not found schema: ${namespace}`));
             return errors;
         }
-        // Validamos nodo
+        // Validate the node
         errors.push(...this.validateAgainstSchema(node, schema));
-        // Validamos children
+        // Validate the children
         if (this.recursiveValidation) {
             for (const childNode of node.getChildren()) {
                 errors.push(...this.validate(childNode));
@@ -27,6 +40,13 @@ class SchemaValidator {
         }
         return errors;
     }
+    /**
+     * Validates a node against an already resolved schema: existence, value type and cardinalities of its children.
+     *
+     * @param node node to validate.
+     * @param schema schema to validate against.
+     * @returns the validation errors found, empty if the node is valid.
+     */
     validateAgainstSchema(node, schema) {
         const errors = [];
         const schemaNode = schema.getNodeDefinition(node.getNormalizedName());
@@ -40,8 +60,8 @@ class SchemaValidator {
         errors.push(...SchemaValidator.validateCount(schemaNode, node));
         return errors;
     }
-    // Modelo de contenido cerrado (STXT-SCHEMA-SPEC, sección 6): solo se permiten
-    // los hijos directos declarados en la definición del padre; sin Children, cierre total
+    // Closed content model (STXT-SCHEMA-SPEC, section 6): only the direct children declared
+    // in the definition of the parent are allowed; with no Children, nothing is
     static validateChildrenDeclared(nodeDef, node) {
         const errors = [];
         for (const child of node.getChildren()) {
@@ -101,9 +121,9 @@ class SchemaValidator {
             errors.push(new ValidationException_1.ValidationException(node.getLine(), "INVALID_NUMBER", `${childCount} nodes of '${childDef.getQualifiedName()}' and min is ${min}`));
         }
         if (max !== null && childCount > max) {
-            // Error en el parent
+            // Error on the parent
             errors.push(new ValidationException_1.ValidationException(node.getLine(), "INVALID_NUMBER", `${childCount} nodes of '${childDef.getQualifiedName()}' and max is ${max}`));
-            // Error en cada nodo hijo que excede el máximo permitido
+            // Error on each child node beyond the allowed maximum
             for (const child of children) {
                 errors.push(new ValidationException_1.ValidationException(child.getLine(), "INVALID_NUMBER", `Too many '${childDef.getQualifiedName()}' nodes: found ${childCount}, max is ${max}`));
             }

package/out/schema/Type.d.ts

@@ -1,6 +1,15 @@
 import { Node } from "../core/Node";
 import { NodeDefinition } from "./NodeDefinition";
+/** Value type of a node (TEXT, INTEGER, URL...). Each type lives in `src/schema/type` as a singleton. */
 export interface Type {
+    /**
+     * Validates the value of a node against this type.
+     *
+     * @param nodeDef definition of the node in the schema.
+     * @param node node to validate.
+     * @throws ValidationException if the value of the node does not match the type.
+     */
     validate(nodeDef: NodeDefinition, node: Node): void;
+    /** @returns the name of the type, as used in the schemas (e.g. `"TEXT"`). */
     getName(): string;
 }

package/out/schema/TypeRegistry.d.ts

@@ -1,8 +1,21 @@
 import { Type } from "./Type";
+/** Static registry of the STXT value types, indexed by name. Adding a new type: a new {@link Type} + `register(...)` here. */
 export declare class TypeRegistry {
     private static readonly REGISTRY;
     private static readonly _init;
+    /**
+     * Tells whether nodes of a type may have children.
+     *
+     * @param nodeType name of the type.
+     * @returns true if nodes of this type may have children (only INLINE and GROUP).
+     */
     static admitsChildren(nodeType: string): boolean;
+    /**
+     * Looks up a registered type by name.
+     *
+     * @param nodeType name of the type to look for.
+     * @returns the {@link Type} registered under that name, or undefined if it does not exist.
+     */
     static get(nodeType: string): Type | undefined;
     private static register;
 }

package/out/schema/TypeRegistry.js

@@ -21,13 +21,26 @@ const BASE64_1 = require("./type/BASE64");
 const GROUP_1 = require("./type/GROUP");
 const ENUM_1 = require("./type/ENUM");
 const MARKDOWN_1 = require("./type/MARKDOWN");
+/** Static registry of the STXT value types, indexed by name. Adding a new type: a new {@link Type} + `register(...)` here. */
 class TypeRegistry {
-    // STXT-SCHEMA-SPEC 9 / STXT-TEMPLATE-SPEC 15: sólo INLINE y GROUP admiten hijos
+    // STXT-SCHEMA-SPEC 9 / STXT-TEMPLATE-SPEC 15: only INLINE and GROUP admit children
+    /**
+     * Tells whether nodes of a type may have children.
+     *
+     * @param nodeType name of the type.
+     * @returns true if nodes of this type may have children (only INLINE and GROUP).
+     */
     static admitsChildren(nodeType) {
         return nodeType === "INLINE" || nodeType === "GROUP";
     }
+    /**
+     * Looks up a registered type by name.
+     *
+     * @param nodeType name of the type to look for.
+     * @returns the {@link Type} registered under that name, or undefined if it does not exist.
+     */
     static get(nodeType) {
-        // fuerza que se ejecute _init al cargar la clase (por si el bundler hiciera cosas raras)
+        // force _init to run when the class is loaded (in case a bundler does something odd)
         void this._init;
         return this.REGISTRY.get(nodeType);
     }
@@ -41,12 +54,12 @@ class TypeRegistry {
 }
 exports.TypeRegistry = TypeRegistry;
 TypeRegistry.REGISTRY = new Map();
-// Inicialización estática (sin INSTANCE)
+// Static initialization (no INSTANCE)
 TypeRegistry._init = (() => {
-    // Tipos principales
+    // Main types
     TypeRegistry.register(INLINE_1.INLINE);
     TypeRegistry.register(BLOCK_1.BLOCK);
-    // Subtipos
+    // Subtypes
     TypeRegistry.register(TEXT_1.TEXT);
     TypeRegistry.register(BOOLEAN_1.BOOLEAN);
     TypeRegistry.register(URL_1.URL);

package/out/schema/type/BASE64.d.ts

@@ -1,2 +1,3 @@
 import { Type } from "../Type";
+/** `BASE64` type: checks that the content is valid Base64. */
 export declare const BASE64: Type;

package/out/schema/type/BASE64.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.BASE64 = void 0;
 const ValidationException_1 = require("../../exceptions/ValidationException");
 const binaryValue_1 = require("./binaryValue");
+/** `BASE64` type: checks that the content is valid Base64. */
 exports.BASE64 = {
     getName() {
         return "BASE64";
@@ -10,12 +11,12 @@ exports.BASE64 = {
     validate(ndef, n) {
         const raw = (0, binaryValue_1.binaryValue)(n);
         try {
-            // Intentamos decodificar
+            // Try to decode it
             const buf = Buffer.from(raw, "base64");
-            // Re-encode para verificar consistencia
-            // (evita aceptar cadenas parcialmente válidas)
+            // Re-encode to check consistency
+            // (this keeps partially valid strings out)
             const reencoded = buf.toString("base64");
-            // Normalizamos padding para comparar
+            // Normalize the padding before comparing
             const normalizedInput = raw.replace(/=+$/, "");
             const normalizedReencoded = reencoded.replace(/=+$/, "");
             if (normalizedInput !== normalizedReencoded) {

package/out/schema/type/BINARY.d.ts

@@ -1,2 +1,3 @@
 import { Type } from "../Type";
+/** `BINARY` type: checks that the content is a string of zeros and ones (`[01]+`). */
 export declare const BINARY: Type;

package/out/schema/type/BINARY.js

@@ -3,11 +3,12 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.BINARY = void 0;
 const ValidationException_1 = require("../../exceptions/ValidationException");
 const binaryValue_1 = require("./binaryValue");
+/** `BINARY` type: checks that the content is a string of zeros and ones (`[01]+`). */
 exports.BINARY = {
     getName() {
         return "BINARY";
     },
-    // STXT-SCHEMA-SPEC 9.5: cadena [01]+
+    // STXT-SCHEMA-SPEC 9.5: [01]+ string
     validate(ndef, n) {
         const value = (0, binaryValue_1.binaryValue)(n);
         if (!/^[01]+$/.test(value)) {

package/out/schema/type/BLOCK.d.ts

@@ -1,2 +1,3 @@
 import { Type } from "../Type";
+/** `BLOCK` type: text block node (`>>`), with no further restriction on the content. */
 export declare const BLOCK: Type;

package/out/schema/type/BLOCK.js

@@ -2,12 +2,13 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BLOCK = void 0;
 const ValidationException_1 = require("../../exceptions/ValidationException");
+/** `BLOCK` type: text block node (`>>`), with no further restriction on the content. */
 exports.BLOCK = {
     getName() {
         return "BLOCK";
     },
     validate(nodeDef, node) {
-        // Forma del valor BLOCK (STXT-SCHEMA-SPEC 9.2): sólo bloque '>>', no forma inline
+        // BLOCK value form (STXT-SCHEMA-SPEC 9.2): block '>>' only, no inline form
         if (!node.isTextNode()) {
             throw new ValidationException_1.ValidationException(node.getLine(), "BLOCK_FORM_REQUIRED", `Node ${node.getQualifiedName()} requires block form '>>'`);
         }

package/out/schema/type/BOOLEAN.d.ts

@@ -1 +1,2 @@
+/** `BOOLEAN` type: checks that the value is `true` or `false`. */
 export declare const BOOLEAN: import("../Type").Type;

package/out/schema/type/BOOLEAN.js

@@ -2,5 +2,6 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BOOLEAN = void 0;
 const regexType_1 = require("./regexType");
+/** `BOOLEAN` type: checks that the value is `true` or `false`. */
 exports.BOOLEAN = (0, regexType_1.regexType)("BOOLEAN", /^(true|false)$/, "Invalid boolean");
 //# sourceMappingURL=BOOLEAN.js.map

package/out/schema/type/DATE.d.ts

@@ -1 +1,2 @@
+/** `DATE` type: checks the `YYYY-MM-DD` format. */
 export declare const DATE: import("../Type").Type;

package/out/schema/type/DATE.js

@@ -2,5 +2,6 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DATE = void 0;
 const regexType_1 = require("./regexType");
+/** `DATE` type: checks the `YYYY-MM-DD` format. */
 exports.DATE = (0, regexType_1.regexType)("DATE", /^\d{4}-\d{2}-\d{2}$/, "Invalid date");
 //# sourceMappingURL=DATE.js.map

package/out/schema/type/EMAIL.d.ts

@@ -1 +1,2 @@
+/** `EMAIL` type: checks that the value looks like an e-mail address. */
 export declare const EMAIL: import("../Type").Type;

package/out/schema/type/EMAIL.js

@@ -2,5 +2,6 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.EMAIL = void 0;
 const regexType_1 = require("./regexType");
+/** `EMAIL` type: checks that the value looks like an e-mail address. */
 exports.EMAIL = (0, regexType_1.regexType)("EMAIL", /^(?=.{1,256}$)(?=.{1,64}@.{1,255}$)(?=.{1,64}@.{1,63}\..{1,63}$)[A-Za-z0-9!#$%&'*+/=?^_`{|}~.-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}$/, "Invalid email");
 //# sourceMappingURL=EMAIL.js.map

package/out/schema/type/ENUM.d.ts

@@ -1,2 +1,3 @@
 import { Type } from "../Type";
+/** `ENUM` type: checks that the value is one of those declared in {@link NodeDefinition.getValues}. */
 export declare const ENUM: Type;

package/out/schema/type/ENUM.js

@@ -2,12 +2,13 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ENUM = void 0;
 const ValidationException_1 = require("../../exceptions/ValidationException");
+/** `ENUM` type: checks that the value is one of those declared in {@link NodeDefinition.getValues}. */
 exports.ENUM = {
     getName() {
         return "ENUM";
     },
     validate(nodeDef, node) {
-        // Forma del valor INLINE (STXT-SCHEMA-SPEC 9.3): no admite bloque '>>'
+        // INLINE value form (STXT-SCHEMA-SPEC 9.3): the block '>>' form is not allowed
         if (node.isTextNode()) {
             throw new ValidationException_1.ValidationException(node.getLine(), "NOT_ALLOWED_TEXT", `Not allowed text in node ${node.getQualifiedName()}`);
         }

package/out/schema/type/GROUP.d.ts

@@ -1,2 +1,3 @@
 import { Type } from "../Type";
+/** `GROUP` type: container node with no value of its own, accepting children just like INLINE. */
 export declare const GROUP: Type;

package/out/schema/type/GROUP.js

@@ -2,12 +2,13 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.GROUP = void 0;
 const ValidationException_1 = require("../../exceptions/ValidationException");
+/** `GROUP` type: container node with no value of its own, accepting children just like INLINE. */
 exports.GROUP = {
     getName() {
         return "GROUP";
     },
     validate(nodeDef, node) {
-        // Forma del valor NONE (STXT-SCHEMA-SPEC 9.2): ni valor inline ni bloque '>>'
+        // NONE value form (STXT-SCHEMA-SPEC 9.2): neither an inline value nor a '>>' block
         if (node.getValue().length > 0 || node.isTextNode()) {
             throw new ValidationException_1.ValidationException(node.getLine(), "INVALID_VALUE", `Node '${node.getName()}' has to be empty`);
         }

package/out/schema/type/HEXADECIMAL.d.ts

@@ -1,2 +1,3 @@
 import { Type } from "../Type";
+/** `HEXADECIMAL` type: checks a hexadecimal string (`[0-9A-Fa-f]+`), with no prefix and no mandatory even length. */
 export declare const HEXADECIMAL: Type;

package/out/schema/type/HEXADECIMAL.js

@@ -3,11 +3,12 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.HEXADECIMAL = void 0;
 const ValidationException_1 = require("../../exceptions/ValidationException");
 const binaryValue_1 = require("./binaryValue");
+/** `HEXADECIMAL` type: checks a hexadecimal string (`[0-9A-Fa-f]+`), with no prefix and no mandatory even length. */
 exports.HEXADECIMAL = {
     getName() {
         return "HEXADECIMAL";
     },
-    // STXT-SCHEMA-SPEC 9.5: cadena [0-9A-Fa-f]+ (sin prefijo '#' ni longitud par)
+    // STXT-SCHEMA-SPEC 9.5: [0-9A-Fa-f]+ string, with no '#' prefix and no even-length requirement
     validate(ndef, n) {
         const value = (0, binaryValue_1.binaryValue)(n);
         if (!/^[0-9A-Fa-f]+$/.test(value)) {

package/out/schema/type/INLINE.d.ts

@@ -1,2 +1,3 @@
 import { Type } from "../Type";
+/** `INLINE` type: node with an inline value (after `:`), accepting children. */
 export declare const INLINE: Type;

package/out/schema/type/INLINE.js

@@ -2,12 +2,13 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.INLINE = void 0;
 const ValidationException_1 = require("../../exceptions/ValidationException");
+/** `INLINE` type: node with an inline value (after `:`), accepting children. */
 exports.INLINE = {
     getName() {
         return "INLINE";
     },
     validate(nodeDef, node) {
-        // Forma del valor INLINE (STXT-SCHEMA-SPEC 9.2): no admite bloque '>>'
+        // INLINE value form (STXT-SCHEMA-SPEC 9.2): the block '>>' form is not allowed
         if (node.isTextNode()) {
             throw new ValidationException_1.ValidationException(node.getLine(), "NOT_ALLOWED_TEXT", `Not allowed text in node ${node.getQualifiedName()}`);
         }

package/out/schema/type/INTEGER.d.ts

@@ -1 +1,2 @@
+/** `INTEGER` type: checks an integer with an optional sign. */
 export declare const INTEGER: import("../Type").Type;

package/out/schema/type/INTEGER.js

@@ -2,5 +2,6 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.INTEGER = void 0;
 const regexType_1 = require("./regexType");
+/** `INTEGER` type: checks an integer with an optional sign. */
 exports.INTEGER = (0, regexType_1.regexType)("INTEGER", /^[-+]?\d+$/, "Invalid integer");
 //# sourceMappingURL=INTEGER.js.map

package/out/schema/type/MARKDOWN.d.ts

@@ -1,2 +1,6 @@
 import { Type } from "../Type";
+/**
+ * `MARKDOWN` type. STXT-SCHEMA-SPEC 9.7: for validation purposes it is equivalent to TEXT
+ * (any content is valid Markdown); only children are forbidden.
+ */
 export declare const MARKDOWN: Type;

package/out/schema/type/MARKDOWN.js

@@ -2,8 +2,10 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MARKDOWN = void 0;
 const ValidationException_1 = require("../../exceptions/ValidationException");
-// STXT-SCHEMA-SPEC 9.7: a efectos de validación equivale a TEXT
-// (cualquier contenido es válido; solo se prohíben hijos)
+/**
+ * `MARKDOWN` type. STXT-SCHEMA-SPEC 9.7: for validation purposes it is equivalent to TEXT
+ * (any content is valid Markdown); only children are forbidden.
+ */
 exports.MARKDOWN = {
     getName() {
         return "MARKDOWN";

package/out/schema/type/NATURAL.d.ts

@@ -1 +1,2 @@
+/** `NATURAL` type: checks an unsigned integer. */
 export declare const NATURAL: import("../Type").Type;

package/out/schema/type/NATURAL.js

@@ -2,5 +2,6 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.NATURAL = void 0;
 const regexType_1 = require("./regexType");
+/** `NATURAL` type: checks an unsigned integer. */
 exports.NATURAL = (0, regexType_1.regexType)("NATURAL", /^\d+$/, "Invalid natural");
 //# sourceMappingURL=NATURAL.js.map

package/out/schema/type/NUMBER.d.ts

@@ -1 +1,2 @@
+/** `NUMBER` type: checks a decimal number, with optional sign and exponent notation. */
 export declare const NUMBER: import("../Type").Type;

package/out/schema/type/NUMBER.js

@@ -2,5 +2,6 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.NUMBER = void 0;
 const regexType_1 = require("./regexType");
+/** `NUMBER` type: checks a decimal number, with optional sign and exponent notation. */
 exports.NUMBER = (0, regexType_1.regexType)("NUMBER", /^[+-]?(?:\d+(?:\.\d*)?|\.\d+)(?:[eE][+-]?\d+)?$/, "Invalid number");
 //# sourceMappingURL=NUMBER.js.map

package/out/schema/type/TEXT.d.ts

@@ -1,2 +1,3 @@
 import { Type } from "../Type";
+/** `TEXT` type: free text node, with no children allowed. */
 export declare const TEXT: Type;

package/out/schema/type/TEXT.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TEXT = void 0;
 const ValidationException_1 = require("../../exceptions/ValidationException");
+/** `TEXT` type: free text node, with no children allowed. */
 exports.TEXT = {
     getName() {
         return "TEXT";

package/out/schema/type/TIME.d.ts

@@ -1 +1,2 @@
+/** `TIME` type: checks the `HH:MM:SS` format. */
 export declare const TIME: import("../Type").Type;

package/out/schema/type/TIME.js

@@ -2,5 +2,6 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TIME = void 0;
 const regexType_1 = require("./regexType");
+/** `TIME` type: checks the `HH:MM:SS` format. */
 exports.TIME = (0, regexType_1.regexType)("TIME", /^\d{2}:\d{2}:\d{2}$/, "Invalid time");
 //# sourceMappingURL=TIME.js.map

package/out/schema/type/TIMESTAMP.d.ts

@@ -1 +1,2 @@
+/** `TIMESTAMP` type: checks an ISO-8601 timestamp. */
 export declare const TIMESTAMP: import("../Type").Type;