pro-editor-schema 0.2.0 → 0.2.2

package/README.md

@@ -7,41 +7,64 @@ TypeScript library that defines XML/HTML schema rules used by the editor and pro
 - Schema definitions for supported tags and schema codes.
 - Shared schema constants and attribute helpers.
 - Runtime schema lookup utilities.
-- XML validation utilities (`validateXml`, attribute/child validators, footnote and link validators).
+- XML validation utilities (`validateXml` and related validators).
 - Type-safe element factory (`createElement`) based on schema definitions.
 
-## Install and build
+## Install
 
 ```bash
 npm install
-npm run typecheck
-npm run test
-npm run build
 ```
 
+## Scripts
+
+| Command | Description |
+| --- | --- |
+| `npm run dev` | Build in watch mode |
+| `npm run build` | Build CJS, ESM, and type declarations |
+| `npm run typecheck` | Run TypeScript without emitting files |
+| `npm run lint` | Run ESLint on `src/` |
+| `npm run test` | Run tests once with Vitest |
+| `npm run test:watch` | Run tests in watch mode |
+| `npm run check` | Run the full verification pipeline (`npm ci`, `typecheck`, `lint`, `test`, `build`) |
+
+For local development, `npm run check` is the fastest way to verify everything before pushing.
+
+## CI
+
+GitHub Actions runs on push and pull requests to `main` / `master`:
+
+- **Typecheck** — `npm run typecheck`
+- **Lint** — `npm run lint`
+- **Test** — `npm test`
+
+Workflow file: `.github/workflows/ci.yml`
+
 ## Project structure
 
-- `src/index.ts`: public exports for schemas, types, shared constants, and validation.
-- `src/schema/schema.types.ts`: core schema and validation-related types.
-- `src/schema/schemas.ts`: central `SCHEMAS` map (`code -> schema`).
-- `src/schema/elementSchemas/elements`: element schema definitions and `ELEMENT_SCHEMAS`.
-- `src/schema/elementSchemas/atoms`: atom schema definitions and `ATOM_SCHEMAS`.
-- `src/schema/elementSchemas/inlineElements`: inline schema definitions and `INLINE_ELEMENT_SCHEMAS`.
-- `src/schema/shared`: shared attribute and ignored-node constants.
-- `src/schema/utils`: schema lookup and element creation helpers.
-- `src/validation`: document validation entrypoint and validation modules.
+- `src/index.ts` — public exports for schemas, types, shared constants, and validation.
+- `src/schema/schema.types.ts` — core schema and validation-related types.
+- `src/schema/schemas.ts` — central `SCHEMAS` map (`code -> schema`).
+- `src/schema/elementSchemas/elements` — element schema definitions and `ELEMENT_SCHEMAS`.
+- `src/schema/elementSchemas/atoms` — atom schema definitions and `ATOM_SCHEMAS`.
+- `src/schema/elementSchemas/inlineElements` — inline schema definitions and `INLINE_ELEMENT_SCHEMAS`.
+- `src/schema/shared` — shared attribute and ignored-node constants.
+- `src/schema/utils` — schema lookup, element creation, and label helpers.
+- `src/validation` — document validation entrypoint and validation modules.
+- `src/**/*.test.ts` — Vitest test files (run with `happy-dom`).
 
 ## Schema model
 
 Each schema defines:
 
-- `code`: internal schema identifier.
-- `kind`: schema category (`element`, `atom`, `inline`).
-- `tag`: uppercase XML tag name used in documents.
-- `requiredAttributes`: required attributes (free or restricted values).
-- `optionalAttributes`: optional attributes (free or restricted values).
-- `defaultChildCode`: preferred child tag (optional, used by some block-like schemas).
-- `allowedChildrenCodes`: allowed child tags and whether each child is required.
+- `code` — internal schema identifier.
+- `kind` — schema category (`element`, `atom`, `inline`).
+- `tag` — uppercase XML tag name used in documents.
+- `requiredAttributes` — required attributes (free or restricted values).
+- `optionalAttributes` — optional attributes (free or restricted values).
+- `defaultChildCode` — preferred child tag (optional, used by some block-like schemas).
+- `allowedChildrenCodes` — allowed child tags and whether each child is required.
+- `matchesElement` — optional predicate to resolve elements that share the same tag (for example `SPAN`, `SECTION1`).
 
 Schemas are combined in `SCHEMAS` from:
 
@@ -49,15 +72,29 @@ Schemas are combined in `SCHEMAS` from:
 - `ATOM_SCHEMAS`
 - `INLINE_ELEMENT_SCHEMAS`
 
+### Resolving schemas from DOM elements
+
+`findSchemaByElement` matches by tag name. When multiple schemas share a tag, the first schema with a matching `matchesElement` predicate wins.
+
+Examples:
+
+- `SPAN` with class `ins` → `insertion`
+- `SPAN` with class `del` → `deletion`
+- `SPAN` with class `cmtQurySection` → `commentQuerySection`
+- `SECTION1` with `role="H1"` → `heading`
+- `SECTION1` with `role="ch"` or a `FOOTNOTE` child → `footnoteSection`
+
+When adding a new schema that reuses an existing tag, define `matchesElement` on every schema that shares that tag.
+
 ## Public API highlights
 
 From `src/index.ts`, consumers can import:
 
-- Types: `Schema`, `SchemaCode`, `ElementSchemaCode`, `AtomSchemaCode`, `InlineSchemaCode`
-- Maps: `SCHEMAS`, `ELEMENT_SCHEMAS`, `ATOM_SCHEMAS`, `INLINE_ELEMENT_SCHEMAS`
-- Utilities: `findSchemaByCode`, `findSchemaByElement`, `createElement`
-- Validators: `validateXml`, `validateFootnotes`, `validateLinkend`, `validateAttributes`, `validateChildren`
-- Shared constants: ignored elements/attributes and global attribute constants
+- **Types:** `Schema`, `SchemaCode`, `ElementSchemaCode`, `AtomSchemaCode`, `InlineSchemaCode`, `ValidationError`
+- **Maps:** `SCHEMAS`, `ELEMENT_SCHEMAS`, `ATOM_SCHEMAS`, `INLINE_ELEMENT_SCHEMAS`
+- **Utilities:** `findSchemaByCode`, `findSchemaByElement`, `createElement`, `ElementLabel`
+- **Validation:** `validateXml`
+- **Shared constants:** ignored elements/attributes, global attribute constants, dependents forbidden elements
 
 ## Usage examples
 
@@ -79,7 +116,6 @@ const para = createElement({
   attributes: {
     store: "body",
     "ele-id": "p-1",
-    role: "body",
   },
 });
 ```
@@ -89,23 +125,41 @@ const para = createElement({
 ```ts
 import { validateXml } from "pro-editor-schema";
 
-const errors = validateXml(rootElement, linkedIds, true);
+const errors = validateXml(
+  rootElement,
+  elementsToLink,
+  linkElements,
+  ["para", "heading"],
+);
 ```
 
-`validateXml` performs:
+`validateXml` parameters:
+
+- `xml` — root element to validate.
+- `elementsToLink` — IDs available as `linkend` targets.
+- `linkElements` — IDs cited by links (used for reference validation).
+- `schemasToValidateAgainst` — schema codes to run attribute/child validation against.
+
+`validateXml` always runs:
+
+- Consecutive footnote number checks
+- Consecutive footnote cue checks
+
+It also runs per-element checks for:
+
+- Link targets (`linkend`) on linkable elements
+- Uncited bibliographic references
+- Unreferenced footnotes
 
-- Footnote sequence checks
-- Footnote cue sequence checks
-- Link target checks (`linkend`)
-- Optional schema-based attribute and child validation when enabled
+Schema-based attribute and child validation only runs for codes listed in `schemasToValidateAgainst`.
 
 ## How validation works
 
 - `validateXml` traverses the XML tree and delegates checks per element.
-- `findSchemaByElement` resolves schema from classes, role, and tag fallback.
-- `validateAttributes` ensures required attributes exist and restricted values are valid.
+- `findSchemaByElement` resolves schema from tag and optional `matchesElement`.
+- `validateAttributes` validates restricted attribute values.
 - `validateChildren` ensures child tags are allowed and required children exist.
-- `validateFootnotes` and `validateLinkend` provide cross-reference integrity checks.
+- `validateFootnotes`, `validateLinkend`, and `validateReferenceCited` provide cross-reference integrity checks.
 
 Validation results use `ValidationError`:
 
@@ -118,23 +172,23 @@ Validation results use `ValidationError`:
 
 ## Adding or updating a schema
 
-1. Create or update schema file in one of:
+1. Create or update a schema file in one of:
    - `src/schema/elementSchemas/elements`
    - `src/schema/elementSchemas/atoms`
    - `src/schema/elementSchemas/inlineElements`
-2. Define schema with `createSchema(...)`.
-3. Add it to the corresponding registry:
+2. Define the schema with `createSchema(...)`.
+3. If the tag is already used by another schema, add a `matchesElement` predicate.
+4. Register it in the corresponding map:
    - `ELEMENT_SCHEMAS`
    - `ATOM_SCHEMAS`
    - `INLINE_ELEMENT_SCHEMAS`
-4. Ensure the schema code exists in the matching union type in `schema.types.ts`.
-5. If needed, export constants/types from folder `index.ts` and `src/index.ts`.
-6. Run:
-   - `npm run typecheck`
-   - `npm run test`
+5. Ensure the schema code exists in the matching union type in `schema.types.ts`.
+6. Add or update tests for any new validation or utility behavior.
+7. Run `npm run check`.
 
 ## Notes
 
 - Tag matching is done in uppercase in schema definitions and validation.
 - Some schema codes represent block/group-like structures while still being typed as `kind: "element"` in the current model.
 - Ignored attributes and ignored UI helper elements are excluded from strict validation by design.
+- Track-changes atoms (`insertion`, `deletion`) are unwrapped when validating required children.

package/dist/index.d.mts

@@ -1,24 +1,23 @@
 type SchemaKind = "element" | "atom" | "inline";
 type FreeAttribute = string;
-type RestrictedAttribute<T = readonly string[]> = {
+type RestrictedAttribute = {
     name: string;
-    values: T;
+    values: string[];
     defaultValue: string;
 };
-type AttributeDefinition<T = readonly string[]> = FreeAttribute | RestrictedAttribute<T>;
+type AttributeDefinition = FreeAttribute | RestrictedAttribute;
 type AllowedChildren = {
     code: SchemaCode;
     required: boolean;
 };
-type Schema<TRequiredAttributes = readonly AttributeDefinition[], TOptionalAttributes = readonly AttributeDefinition[]> = {
+type Schema = {
     code: SchemaCode;
     kind: SchemaKind;
     tag: string;
-    requiredAttributes: TRequiredAttributes;
-    optionalAttributes: TOptionalAttributes;
+    requiredAttributes: AttributeDefinition[];
+    optionalAttributes: AttributeDefinition[];
     defaultChildCode?: SchemaCode;
     allowedChildrenCodes: AllowedChildren[];
-    matchesElement?: (element: Element) => boolean;
 };
 type SchemaCode = ElementSchemaCode | InlineSchemaCode | AtomSchemaCode;
 type ElementSchemaCode = "referenceBibliomixed" | "referenceBibliography" | "bibliodiv" | "degrees" | "email" | "equation" | "fignote" | "figsource" | "firstname" | "footnote" | "footnoteno" | "honorific" | "img" | "informalfigure" | "keyword" | "label1" | "li" | "line" | "lrh" | "math" | "mathphrase" | "merror" | "mfrac" | "mi" | "mmultiscripts" | "mn" | "mo" | "mover" | "mpadded" | "mphantom" | "mprescripts" | "mroot" | "mrow" | "ms" | "mspace" | "msqrt" | "mstyle" | "msub" | "msubsup" | "msup" | "mtable" | "mtd" | "mtext" | "mtr" | "munder" | "munderover" | "olink" | "org" | "orgname" | "para" | "punc" | "rrh" | "source1" | "speaker" | "subtitle1" | "surname" | "tag" | "tblfn" | "tblsource" | "thead" | "title1" | "token" | "tp" | "abstract1" | "affiliation" | "alttext" | "appendix" | "author" | "authorgroup" | "blockquote" | "caption1" | "chapter" | "dialogue" | "epigraph" | "figure1" | "footnoteSection" | "heading" | "imageobject" | "info1" | "keywordset" | "mediaobject" | "ol" | "personname" | "poem" | "sidebar" | "table" | "table1" | "tbody" | "td" | "tgroup" | "tr" | "ul";
@@ -31,25 +30,18 @@ declare const isTrackChangesSchema: (schema: Schema) => boolean;
 declare const isIgnoredAttribute: (attribute: string) => boolean;
 declare const isIgnoredElement: (element: Element) => boolean;
 declare const isIgnoredValidation: (code: SchemaCode) => boolean;
-declare const findSchemaByCode: (code: SchemaCode) => Schema;
+declare const findSchemaByCode: (code: SchemaCode) => Schema | undefined;
+declare const findSchemaByTagName: (tagName: string) => Schema[];
 declare const findSchemaByElement: (element: Element) => Schema | undefined;
 declare const isAttributeRestricted: (attr: AttributeDefinition) => attr is RestrictedAttribute;
 declare const getAttributeName: (attribute: AttributeDefinition) => string;
-declare const findAttributeDefinitionByName: (definitions: readonly AttributeDefinition[], name: string) => AttributeDefinition | undefined;
+declare const findAttributeDefinitionByName: (definitions: AttributeDefinition[], name: string) => AttributeDefinition | undefined;
 
-type AttributeValue<TAttribute extends AttributeDefinition> = TAttribute extends string ? string : TAttribute extends RestrictedAttribute<infer TValues> ? TValues extends readonly string[] ? TValues[number] : string : never;
-type SchemaAttributes<TSchema extends Schema> = TSchema extends Schema<infer TRequired extends readonly AttributeDefinition[], infer TOptional extends readonly AttributeDefinition[]> ? {
-    [TAttribute in TRequired[number] as TAttribute extends string ? TAttribute : TAttribute extends RestrictedAttribute ? TAttribute["name"] : never]: AttributeValue<TAttribute>;
-} & {
-    [TAttribute in TOptional[number] as TAttribute extends string ? TAttribute : TAttribute extends RestrictedAttribute ? TAttribute["name"] : never]?: AttributeValue<TAttribute>;
-} : never;
-type CreateElementParams<TSchema extends Schema> = {
+type CreateElementParams = {
     schemaCode: SchemaCode;
-    attributes: SchemaAttributes<TSchema>;
+    attributes: Record<string, string>;
 };
-declare const createElement: <TSchema extends Schema>({ schemaCode, attributes, }: CreateElementParams<TSchema>) => HTMLElement;
-
-declare const ElementLabel: Record<SchemaCode, string>;
+declare const createElement: ({ schemaCode, attributes, }: CreateElementParams) => HTMLElement;
 
 declare const IGNORED_ELEMENT_SELECTORS: string[];
 declare const IGNORED_VALIDATION_ELEMENT_SELECTORS: SchemaCode[];
@@ -76,15 +68,15 @@ declare const FIGURE_PLACEMENT_ATTRIBUTE = "data-figure-placement";
 declare const LAYOUT_CELL_WIDTH_ATTRIBUTE = "data-cell-width";
 declare const LAYOUT_TABLE_ORIENTATION_ATTRIBUTE = "data-table-orientation";
 declare const LAYOUT_TABLE_PLACEMENT_ATTRIBUTE = "data-table-placement";
-declare const LAYOUT_ATTRIBUTES: readonly ["data-alignment", "data-left-indent", "data-right-indent", "data-special-indent", "data-space-above", "data-space-below", "data-indent-type", "data-layout-user", "data-paragraph-style"];
+declare const LAYOUT_ATTRIBUTES: string[];
 declare const TRACK_CHANGES_ATTR_DATA_USERNAME = "data-username";
 declare const TRACK_CHANGES_ATTR_DATA_USERID = "data-userid";
 declare const TRACK_CHANGES_ATTR_DATA_TIME = "data-time";
 declare const TRACK_CHANGES_ATTR_DATA_DATE = "data-date";
-declare const TRACK_CHANGES_ATTRS: readonly ["data-username", "data-userid", "data-time", "data-date"];
+declare const TRACK_CHANGES_ATTRS: string[];
 declare const ELE_ID_ATTRIBUTE = "ele-id";
 declare const STORE_ATTRIBUTE = "store";
-declare const ID_ATTRS: readonly ["store", "ele-id"];
+declare const ID_ATTRS: string[];
 
 declare const ELEMENT_SCHEMAS: Record<ElementSchemaCode, Schema>;
 
@@ -115,4 +107,4 @@ type ValidationError = {
  */
 declare const validateXml: (xml: Element, elementsToLink: string[], linkElements: string[], schemasToValidateAgainst: SchemaCode[]) => ValidationError[];
 
-export { ALIGNMENT_ATTRIBUTE, ATOM_SCHEMAS, type AllowedChildren, type AtomSchemaCode, type AttributeDefinition, DEPENDENT_FORBIDDEN_ELEMENTS, ELEMENT_SCHEMAS, ELE_ID_ATTRIBUTE, ElementLabel, type ElementSchemaCode, FIGURE_PLACEMENT_ATTRIBUTE, type FreeAttribute, ID_ATTRS, IGNORED_ATTRIBUTES, IGNORED_ATTRIBUTES_STARTS_WITH, IGNORED_ELEMENT_SELECTORS, IGNORED_VALIDATION_ELEMENT_SELECTORS, INDENT_TYPE_ATTRIBUTE, INLINE_ELEMENT_SCHEMAS, type InlineSchemaCode, LAYOUT_ATTRIBUTES, LAYOUT_CELL_WIDTH_ATTRIBUTE, LAYOUT_TABLE_ORIENTATION_ATTRIBUTE, LAYOUT_TABLE_PLACEMENT_ATTRIBUTE, LAYOUT_USER_ATTRIBUTE, LEFT_INDENT_ATTRIBUTE, RIGHT_INDENT_ATTRIBUTE, type RestrictedAttribute, SCHEMAS, SPACE_ABOVE_ATTRIBUTE, SPACE_BELOW_ATTRIBUTE, SPECIAL_INDENT_ATTRIBUTE, STORE_ATTRIBUTE, STYLE_NAME_ATTRIBUTE, type Schema, type SchemaCode, type SchemaKind, TRACK_CHANGES_ATTRS, TRACK_CHANGES_ATTR_DATA_DATE, TRACK_CHANGES_ATTR_DATA_TIME, TRACK_CHANGES_ATTR_DATA_USERID, TRACK_CHANGES_ATTR_DATA_USERNAME, type ValidationError, type ValidationErrorKind, type ValidationErrorLevel, createElement, findAttributeDefinitionByName, findSchemaByCode, findSchemaByElement, getAttributeName, isAttributeRestricted, isIgnoredAttribute, isIgnoredElement, isIgnoredValidation, isTrackChangesSchema, validateXml };
+export { ALIGNMENT_ATTRIBUTE, ATOM_SCHEMAS, type AllowedChildren, type AtomSchemaCode, type AttributeDefinition, DEPENDENT_FORBIDDEN_ELEMENTS, ELEMENT_SCHEMAS, ELE_ID_ATTRIBUTE, type ElementSchemaCode, FIGURE_PLACEMENT_ATTRIBUTE, type FreeAttribute, ID_ATTRS, IGNORED_ATTRIBUTES, IGNORED_ATTRIBUTES_STARTS_WITH, IGNORED_ELEMENT_SELECTORS, IGNORED_VALIDATION_ELEMENT_SELECTORS, INDENT_TYPE_ATTRIBUTE, INLINE_ELEMENT_SCHEMAS, type InlineSchemaCode, LAYOUT_ATTRIBUTES, LAYOUT_CELL_WIDTH_ATTRIBUTE, LAYOUT_TABLE_ORIENTATION_ATTRIBUTE, LAYOUT_TABLE_PLACEMENT_ATTRIBUTE, LAYOUT_USER_ATTRIBUTE, LEFT_INDENT_ATTRIBUTE, RIGHT_INDENT_ATTRIBUTE, type RestrictedAttribute, SCHEMAS, SPACE_ABOVE_ATTRIBUTE, SPACE_BELOW_ATTRIBUTE, SPECIAL_INDENT_ATTRIBUTE, STORE_ATTRIBUTE, STYLE_NAME_ATTRIBUTE, type Schema, type SchemaCode, type SchemaKind, TRACK_CHANGES_ATTRS, TRACK_CHANGES_ATTR_DATA_DATE, TRACK_CHANGES_ATTR_DATA_TIME, TRACK_CHANGES_ATTR_DATA_USERID, TRACK_CHANGES_ATTR_DATA_USERNAME, type ValidationError, type ValidationErrorKind, type ValidationErrorLevel, createElement, findAttributeDefinitionByName, findSchemaByCode, findSchemaByElement, findSchemaByTagName, getAttributeName, isAttributeRestricted, isIgnoredAttribute, isIgnoredElement, isIgnoredValidation, isTrackChangesSchema, validateXml };

package/dist/index.d.ts

@@ -1,24 +1,23 @@
 type SchemaKind = "element" | "atom" | "inline";
 type FreeAttribute = string;
-type RestrictedAttribute<T = readonly string[]> = {
+type RestrictedAttribute = {
     name: string;
-    values: T;
+    values: string[];
     defaultValue: string;
 };
-type AttributeDefinition<T = readonly string[]> = FreeAttribute | RestrictedAttribute<T>;
+type AttributeDefinition = FreeAttribute | RestrictedAttribute;
 type AllowedChildren = {
     code: SchemaCode;
     required: boolean;
 };
-type Schema<TRequiredAttributes = readonly AttributeDefinition[], TOptionalAttributes = readonly AttributeDefinition[]> = {
+type Schema = {
     code: SchemaCode;
     kind: SchemaKind;
     tag: string;
-    requiredAttributes: TRequiredAttributes;
-    optionalAttributes: TOptionalAttributes;
+    requiredAttributes: AttributeDefinition[];
+    optionalAttributes: AttributeDefinition[];
     defaultChildCode?: SchemaCode;
     allowedChildrenCodes: AllowedChildren[];
-    matchesElement?: (element: Element) => boolean;
 };
 type SchemaCode = ElementSchemaCode | InlineSchemaCode | AtomSchemaCode;
 type ElementSchemaCode = "referenceBibliomixed" | "referenceBibliography" | "bibliodiv" | "degrees" | "email" | "equation" | "fignote" | "figsource" | "firstname" | "footnote" | "footnoteno" | "honorific" | "img" | "informalfigure" | "keyword" | "label1" | "li" | "line" | "lrh" | "math" | "mathphrase" | "merror" | "mfrac" | "mi" | "mmultiscripts" | "mn" | "mo" | "mover" | "mpadded" | "mphantom" | "mprescripts" | "mroot" | "mrow" | "ms" | "mspace" | "msqrt" | "mstyle" | "msub" | "msubsup" | "msup" | "mtable" | "mtd" | "mtext" | "mtr" | "munder" | "munderover" | "olink" | "org" | "orgname" | "para" | "punc" | "rrh" | "source1" | "speaker" | "subtitle1" | "surname" | "tag" | "tblfn" | "tblsource" | "thead" | "title1" | "token" | "tp" | "abstract1" | "affiliation" | "alttext" | "appendix" | "author" | "authorgroup" | "blockquote" | "caption1" | "chapter" | "dialogue" | "epigraph" | "figure1" | "footnoteSection" | "heading" | "imageobject" | "info1" | "keywordset" | "mediaobject" | "ol" | "personname" | "poem" | "sidebar" | "table" | "table1" | "tbody" | "td" | "tgroup" | "tr" | "ul";
@@ -31,25 +30,18 @@ declare const isTrackChangesSchema: (schema: Schema) => boolean;
 declare const isIgnoredAttribute: (attribute: string) => boolean;
 declare const isIgnoredElement: (element: Element) => boolean;
 declare const isIgnoredValidation: (code: SchemaCode) => boolean;
-declare const findSchemaByCode: (code: SchemaCode) => Schema;
+declare const findSchemaByCode: (code: SchemaCode) => Schema | undefined;
+declare const findSchemaByTagName: (tagName: string) => Schema[];
 declare const findSchemaByElement: (element: Element) => Schema | undefined;
 declare const isAttributeRestricted: (attr: AttributeDefinition) => attr is RestrictedAttribute;
 declare const getAttributeName: (attribute: AttributeDefinition) => string;
-declare const findAttributeDefinitionByName: (definitions: readonly AttributeDefinition[], name: string) => AttributeDefinition | undefined;
+declare const findAttributeDefinitionByName: (definitions: AttributeDefinition[], name: string) => AttributeDefinition | undefined;
 
-type AttributeValue<TAttribute extends AttributeDefinition> = TAttribute extends string ? string : TAttribute extends RestrictedAttribute<infer TValues> ? TValues extends readonly string[] ? TValues[number] : string : never;
-type SchemaAttributes<TSchema extends Schema> = TSchema extends Schema<infer TRequired extends readonly AttributeDefinition[], infer TOptional extends readonly AttributeDefinition[]> ? {
-    [TAttribute in TRequired[number] as TAttribute extends string ? TAttribute : TAttribute extends RestrictedAttribute ? TAttribute["name"] : never]: AttributeValue<TAttribute>;
-} & {
-    [TAttribute in TOptional[number] as TAttribute extends string ? TAttribute : TAttribute extends RestrictedAttribute ? TAttribute["name"] : never]?: AttributeValue<TAttribute>;
-} : never;
-type CreateElementParams<TSchema extends Schema> = {
+type CreateElementParams = {
     schemaCode: SchemaCode;
-    attributes: SchemaAttributes<TSchema>;
+    attributes: Record<string, string>;
 };
-declare const createElement: <TSchema extends Schema>({ schemaCode, attributes, }: CreateElementParams<TSchema>) => HTMLElement;
-
-declare const ElementLabel: Record<SchemaCode, string>;
+declare const createElement: ({ schemaCode, attributes, }: CreateElementParams) => HTMLElement;
 
 declare const IGNORED_ELEMENT_SELECTORS: string[];
 declare const IGNORED_VALIDATION_ELEMENT_SELECTORS: SchemaCode[];
@@ -76,15 +68,15 @@ declare const FIGURE_PLACEMENT_ATTRIBUTE = "data-figure-placement";
 declare const LAYOUT_CELL_WIDTH_ATTRIBUTE = "data-cell-width";
 declare const LAYOUT_TABLE_ORIENTATION_ATTRIBUTE = "data-table-orientation";
 declare const LAYOUT_TABLE_PLACEMENT_ATTRIBUTE = "data-table-placement";
-declare const LAYOUT_ATTRIBUTES: readonly ["data-alignment", "data-left-indent", "data-right-indent", "data-special-indent", "data-space-above", "data-space-below", "data-indent-type", "data-layout-user", "data-paragraph-style"];
+declare const LAYOUT_ATTRIBUTES: string[];
 declare const TRACK_CHANGES_ATTR_DATA_USERNAME = "data-username";
 declare const TRACK_CHANGES_ATTR_DATA_USERID = "data-userid";
 declare const TRACK_CHANGES_ATTR_DATA_TIME = "data-time";
 declare const TRACK_CHANGES_ATTR_DATA_DATE = "data-date";
-declare const TRACK_CHANGES_ATTRS: readonly ["data-username", "data-userid", "data-time", "data-date"];
+declare const TRACK_CHANGES_ATTRS: string[];
 declare const ELE_ID_ATTRIBUTE = "ele-id";
 declare const STORE_ATTRIBUTE = "store";
-declare const ID_ATTRS: readonly ["store", "ele-id"];
+declare const ID_ATTRS: string[];
 
 declare const ELEMENT_SCHEMAS: Record<ElementSchemaCode, Schema>;
 
@@ -115,4 +107,4 @@ type ValidationError = {
  */
 declare const validateXml: (xml: Element, elementsToLink: string[], linkElements: string[], schemasToValidateAgainst: SchemaCode[]) => ValidationError[];
 
-export { ALIGNMENT_ATTRIBUTE, ATOM_SCHEMAS, type AllowedChildren, type AtomSchemaCode, type AttributeDefinition, DEPENDENT_FORBIDDEN_ELEMENTS, ELEMENT_SCHEMAS, ELE_ID_ATTRIBUTE, ElementLabel, type ElementSchemaCode, FIGURE_PLACEMENT_ATTRIBUTE, type FreeAttribute, ID_ATTRS, IGNORED_ATTRIBUTES, IGNORED_ATTRIBUTES_STARTS_WITH, IGNORED_ELEMENT_SELECTORS, IGNORED_VALIDATION_ELEMENT_SELECTORS, INDENT_TYPE_ATTRIBUTE, INLINE_ELEMENT_SCHEMAS, type InlineSchemaCode, LAYOUT_ATTRIBUTES, LAYOUT_CELL_WIDTH_ATTRIBUTE, LAYOUT_TABLE_ORIENTATION_ATTRIBUTE, LAYOUT_TABLE_PLACEMENT_ATTRIBUTE, LAYOUT_USER_ATTRIBUTE, LEFT_INDENT_ATTRIBUTE, RIGHT_INDENT_ATTRIBUTE, type RestrictedAttribute, SCHEMAS, SPACE_ABOVE_ATTRIBUTE, SPACE_BELOW_ATTRIBUTE, SPECIAL_INDENT_ATTRIBUTE, STORE_ATTRIBUTE, STYLE_NAME_ATTRIBUTE, type Schema, type SchemaCode, type SchemaKind, TRACK_CHANGES_ATTRS, TRACK_CHANGES_ATTR_DATA_DATE, TRACK_CHANGES_ATTR_DATA_TIME, TRACK_CHANGES_ATTR_DATA_USERID, TRACK_CHANGES_ATTR_DATA_USERNAME, type ValidationError, type ValidationErrorKind, type ValidationErrorLevel, createElement, findAttributeDefinitionByName, findSchemaByCode, findSchemaByElement, getAttributeName, isAttributeRestricted, isIgnoredAttribute, isIgnoredElement, isIgnoredValidation, isTrackChangesSchema, validateXml };
+export { ALIGNMENT_ATTRIBUTE, ATOM_SCHEMAS, type AllowedChildren, type AtomSchemaCode, type AttributeDefinition, DEPENDENT_FORBIDDEN_ELEMENTS, ELEMENT_SCHEMAS, ELE_ID_ATTRIBUTE, type ElementSchemaCode, FIGURE_PLACEMENT_ATTRIBUTE, type FreeAttribute, ID_ATTRS, IGNORED_ATTRIBUTES, IGNORED_ATTRIBUTES_STARTS_WITH, IGNORED_ELEMENT_SELECTORS, IGNORED_VALIDATION_ELEMENT_SELECTORS, INDENT_TYPE_ATTRIBUTE, INLINE_ELEMENT_SCHEMAS, type InlineSchemaCode, LAYOUT_ATTRIBUTES, LAYOUT_CELL_WIDTH_ATTRIBUTE, LAYOUT_TABLE_ORIENTATION_ATTRIBUTE, LAYOUT_TABLE_PLACEMENT_ATTRIBUTE, LAYOUT_USER_ATTRIBUTE, LEFT_INDENT_ATTRIBUTE, RIGHT_INDENT_ATTRIBUTE, type RestrictedAttribute, SCHEMAS, SPACE_ABOVE_ATTRIBUTE, SPACE_BELOW_ATTRIBUTE, SPECIAL_INDENT_ATTRIBUTE, STORE_ATTRIBUTE, STYLE_NAME_ATTRIBUTE, type Schema, type SchemaCode, type SchemaKind, TRACK_CHANGES_ATTRS, TRACK_CHANGES_ATTR_DATA_DATE, TRACK_CHANGES_ATTR_DATA_TIME, TRACK_CHANGES_ATTR_DATA_USERID, TRACK_CHANGES_ATTR_DATA_USERNAME, type ValidationError, type ValidationErrorKind, type ValidationErrorLevel, createElement, findAttributeDefinitionByName, findSchemaByCode, findSchemaByElement, findSchemaByTagName, getAttributeName, isAttributeRestricted, isIgnoredAttribute, isIgnoredElement, isIgnoredValidation, isTrackChangesSchema, validateXml };

package/dist/index.js

@@ -25,7 +25,6 @@ __export(index_exports, {
   DEPENDENT_FORBIDDEN_ELEMENTS: () => DEPENDENT_FORBIDDEN_ELEMENTS,
   ELEMENT_SCHEMAS: () => ELEMENT_SCHEMAS,
   ELE_ID_ATTRIBUTE: () => ELE_ID_ATTRIBUTE,
-  ElementLabel: () => ElementLabel,
   FIGURE_PLACEMENT_ATTRIBUTE: () => FIGURE_PLACEMENT_ATTRIBUTE,
   ID_ATTRS: () => ID_ATTRS,
   IGNORED_ATTRIBUTES: () => IGNORED_ATTRIBUTES,
@@ -56,6 +55,7 @@ __export(index_exports, {
   findAttributeDefinitionByName: () => findAttributeDefinitionByName,
   findSchemaByCode: () => findSchemaByCode,
   findSchemaByElement: () => findSchemaByElement,
+  findSchemaByTagName: () => findSchemaByTagName,
   getAttributeName: () => getAttributeName,
   isAttributeRestricted: () => isAttributeRestricted,
   isIgnoredAttribute: () => isIgnoredAttribute,
@@ -67,8 +67,24 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 
 // src/schema/utils/createSchema.ts
-var createSchema = (params) => {
-  return params;
+var createSchema = ({
+  code,
+  kind,
+  tag,
+  requiredAttributes,
+  optionalAttributes,
+  defaultChildCode,
+  allowedChildrenCodes
+}) => {
+  return {
+    code,
+    kind,
+    tag,
+    requiredAttributes,
+    optionalAttributes,
+    defaultChildCode,
+    allowedChildrenCodes
+  };
 };
 
 // src/schema/shared/globalAttributes.ts
@@ -169,7 +185,6 @@ var COMMENT_QUERY_SECTION_SCHEMA = createSchema({
   kind: "atom",
   tag: SPAN_TAG,
   code: "commentQuerySection",
-  matchesElement: (element) => element.classList.contains("cmtQurySection"),
   requiredAttributes: [...ID_ATTRS, "id"],
   optionalAttributes: [...TRACK_CHANGES_ATTRS, "title"],
   allowedChildrenCodes: [...ATOM_CODES_ALLOWED_CHILDREN]
@@ -189,7 +204,6 @@ var DELETION_SCHEMA = createSchema({
   code: "deletion",
   kind: "atom",
   tag: SPAN_TAG,
-  matchesElement: (element) => element.classList.contains("del"),
   requiredAttributes: [...TRACK_CHANGES_ATTRS, ...ID_ATTRS],
   optionalAttributes: [],
   allowedChildrenCodes: [
@@ -240,7 +254,6 @@ var INSERTION_SCHEMA = createSchema({
   code: "insertion",
   kind: "atom",
   tag: SPAN_TAG,
-  matchesElement: (element) => element.classList.contains("ins"),
   requiredAttributes: [...TRACK_CHANGES_ATTRS, ...ID_ATTRS],
   optionalAttributes: [],
   allowedChildrenCodes: [
@@ -1962,21 +1975,15 @@ var EPIGRAPH_SCHEMA = createSchema({
 });
 
 // src/schema/elementSchemas/elements/footnoteSection.ts
-var FOOTNOTE_SECTION_ROLES = ["ch", "bk"];
 var FOOTNOTE_SECTION_SCHEMA = createSchema({
   code: "footnoteSection",
   kind: "element",
   tag: SECTION_TAG,
-  matchesElement: (element) => {
-    const role = element.getAttribute("role");
-    if (role && FOOTNOTE_SECTION_ROLES.includes(role)) return true;
-    return element.querySelector(FOOTNOTE_TAG) !== null;
-  },
   requiredAttributes: [
     ...ID_ATTRS,
     {
       name: "role",
-      values: FOOTNOTE_SECTION_ROLES,
+      values: ["ch", "bk"],
       defaultValue: "ch"
     }
   ],
@@ -1989,22 +1996,16 @@ var FOOTNOTE_SECTION_SCHEMA = createSchema({
 });
 
 // src/schema/elementSchemas/elements/heading.ts
-var HEADING_ROLES = ["H1", "H2", "H3", "H4", "H5", "H6", "vignette_group"];
 var HEADING_SCHEMA = createSchema({
   code: "heading",
   kind: "element",
   tag: SECTION_TAG,
-  matchesElement: (element) => {
-    const role = element.getAttribute("role");
-    if (!role) return false;
-    return HEADING_ROLES.includes(role);
-  },
   requiredAttributes: [
     ...ID_ATTRS,
     "xmlid",
     {
       name: "role",
-      values: HEADING_ROLES,
+      values: ["H1", "H2", "H3", "H4", "H5", "H6", "vignette_group"],
       defaultValue: "H1"
     }
   ],
@@ -2072,6 +2073,7 @@ var MATHPHRASE_SCHEMA = createSchema({
   requiredAttributes: [ELE_ID_ATTRIBUTE],
   optionalAttributes: [],
   allowedChildrenCodes: [{ code: MATH_SCHEMA.code, required: true }]
+  // TODO: Should have flag for insertion and deletion
 });
 
 // src/schema/elementSchemas/elements/reference/bibliodiv.ts
@@ -2369,11 +2371,42 @@ var isIgnoredAttribute = (attribute) => IGNORED_ATTRIBUTES.includes(attribute) |
 var isIgnoredElement = (element) => IGNORED_ELEMENT_SELECTORS.some((selector) => element.matches(selector));
 var isIgnoredValidation = (code) => IGNORED_VALIDATION_ELEMENT_SELECTORS.includes(code);
 var findSchemaByCode = (code) => SCHEMAS[code];
+var findSchemaByTagName = (tagName) => Object.values(SCHEMAS).filter(
+  (schema) => schema.tag === tagName.toUpperCase()
+);
 var findSchemaByElement = (element) => {
-  const schema = Object.values(SCHEMAS).find(
-    (schema2) => schema2.tag == element.tagName && schema2.matchesElement?.(element)
-  );
-  return schema;
+  const tagName = element.tagName.toUpperCase();
+  const isInsertion = element.classList.contains("ins");
+  const isDeletion = element.classList.contains("del");
+  const isQueryComment = element.classList.contains("cmtQurySection");
+  const role = element.getAttribute("role");
+  if (tagName === SPAN_TAG) {
+    if (isQueryComment) {
+      return findSchemaByCode("commentQuerySection");
+    }
+    if (isInsertion) {
+      return findSchemaByCode("insertion");
+    }
+    if (isDeletion) {
+      return findSchemaByCode("deletion");
+    }
+  }
+  if (tagName === SECTION_TAG) {
+    if (role) {
+      if (role.startsWith("H")) {
+        return findSchemaByCode("heading");
+      }
+      if (role === "ch" || role === "bk") {
+        return findSchemaByCode("footnoteSection");
+      }
+    }
+    const isFootnoteSectionWithoutRole = element.querySelector(FOOTNOTE_TAG);
+    if (isFootnoteSectionWithoutRole) {
+      return findSchemaByCode("footnoteSection");
+    }
+  }
+  const candidates = findSchemaByTagName(tagName);
+  return candidates[0];
 };
 var isAttributeRestricted = (attr) => typeof attr !== "string";
 var getAttributeName = (attribute) => typeof attribute === "string" ? attribute.toLowerCase() : attribute.name.toLowerCase();
@@ -2387,144 +2420,50 @@ var findAttributeDefinitionByName = (definitions, name) => {
 };
 
 // src/schema/utils/createElement.ts
+var validateAttributes = (attributes, schema) => {
+  const definitions = [
+    ...schema.requiredAttributes,
+    ...schema.optionalAttributes
+  ];
+  for (const [name, value] of Object.entries(attributes)) {
+    if (value === void 0) {
+      continue;
+    }
+    const definition = findAttributeDefinitionByName(definitions, name);
+    if (!definition) {
+      throw new Error(
+        `Invalid attribute "${name}" for schema "${schema.code}".`
+      );
+    }
+    if (!isAttributeRestricted(definition)) {
+      continue;
+    }
+    if (!definition.values.includes(value)) {
+      throw new Error(
+        `Invalid value "${value}" for attribute "${name}" on schema "${schema.code}". Allowed values: ${definition.values.join(", ")}.`
+      );
+    }
+  }
+};
 var createElement = ({
   schemaCode,
   attributes
 }) => {
   const schema = findSchemaByCode(schemaCode);
+  if (!schema) {
+    throw new Error(`Schema not found for code: ${schemaCode}`);
+  }
+  validateAttributes(attributes, schema);
   const element = document.createElement(schema.tag.toLowerCase());
   for (const [name, value] of Object.entries(attributes)) {
-    if (!value) continue;
+    if (value === void 0) {
+      continue;
+    }
     element.setAttribute(name, String(value));
   }
   return element;
 };
 
-// src/schema/utils/labelElements.ts
-var ElementLabel = {
-  referenceBibliomixed: "Reference Bibliomixed",
-  referenceBibliography: "Reference Bibliography",
-  bibliodiv: "Bibliodiv",
-  indexterm: "Indexterm",
-  primary: "Primary",
-  secondary: "Secondary",
-  tertiary: "Tertiary",
-  quaternary: "Quaternary",
-  bookmark: "Bookmark",
-  see: "Cross Reference",
-  commentQuerySection: "Comment/Query",
-  comment: "Comment",
-  content: "Content",
-  query: "Query",
-  reply: "Reply",
-  deletion: "Deletion",
-  emphasis: "Emphasis",
-  highlightmark: "Highlightmark",
-  i: "Italic",
-  insertion: "Insertion",
-  sc: "Small Caps",
-  strike: "Strike",
-  sub: "Subscript",
-  sup: "Superscript",
-  u: "Underline",
-  b: "Bold",
-  referenceMark: "Reference Mark",
-  degrees: "Degrees",
-  email: "Email",
-  equation: "Equation",
-  fignote: "Fignote",
-  figsource: "Figsource",
-  firstname: "Firstname",
-  footnote: "Footnote Marker",
-  footnoteno: "Footnote Number",
-  honorific: "Honorific",
-  img: "Image",
-  informalfigure: "Floating Figure",
-  keyword: "Keyword",
-  label1: "Label",
-  li: "List Item",
-  line: "Line",
-  lrh: "Running Head Left",
-  math: "Math",
-  mathphrase: "Math Phrase",
-  merror: "Math Error",
-  mfrac: "Math  Fraction",
-  mi: "Math Identifier",
-  mmultiscripts: "Math Multiscripts",
-  mn: "Math Number",
-  mo: "Math Operator",
-  mover: "Math Over",
-  mpadded: "Math Padded",
-  mphantom: "Math Phantom",
-  mprescripts: "Math Prescripts",
-  mroot: "Math Root",
-  mrow: "Math Row",
-  ms: "Math Space",
-  mspace: "Math Space",
-  msqrt: "Math Square Root",
-  mstyle: "Math Style",
-  msub: "Math Subscript",
-  msubsup: "Math Subscript Superscript",
-  msup: "Math Superscript",
-  mtable: "Math Table",
-  mtd: "Math Table Data",
-  mtext: "Math Text",
-  mtr: "Math Table Row",
-  munder: "Math Under",
-  munderover: "Math Under Over",
-  olink: "Online Link",
-  org: "Org",
-  orgname: "Orgname",
-  para: "Paragraph",
-  punc: "Punctuation",
-  rrh: "Running Head Right",
-  source1: "Source",
-  speaker: "Speaker",
-  subtitle1: "Subtitle",
-  surname: "Surname",
-  tag: "Tag",
-  tblfn: "Table Footnote",
-  tblsource: "Table Source",
-  thead: "Thead",
-  title1: "Title",
-  token: "Token",
-  tp: "Table Paragraph",
-  abstract1: "Abstract",
-  affiliation: "Affiliation",
-  alttext: "Alttext",
-  appendix: "Appendix",
-  author: "Author",
-  authorgroup: "Authorgroup",
-  blockquote: "Blockquote",
-  caption1: "Caption",
-  chapter: "Chapter",
-  dialogue: "Dialogue",
-  epigraph: "Epigraph",
-  figure1: "Figure",
-  footnoteSection: "Footnote Section",
-  heading: "Heading",
-  imageobject: "Image Object",
-  info1: "Info",
-  keywordset: "Keyword FGroup",
-  mediaobject: "Mediaobject",
-  ol: "Ordered List",
-  personname: "Person Name",
-  poem: "Poem",
-  sidebar: "Box",
-  table: "Table",
-  table1: "Table",
-  tbody: "Table Body",
-  td: "Table Data",
-  tgroup: "Table Group",
-  tr: "Table Row",
-  ul: "Unordered List",
-  footnote1: "Footnote",
-  inlineequation: "Inline Equation",
-  link: "Link",
-  uri: "URI",
-  phrase: "Phrase"
-};
-
 // src/schema/shared/dependentsForbiddenElements.ts
 var DEPENDENT_FORBIDDEN_ELEMENTS = [
   {
@@ -2699,7 +2638,7 @@ var validateLinkend = (linkElement, elementsToLink) => {
 };
 
 // src/validation/validateAttributes.ts
-var validateAttributes = (element, schema) => {
+var validateAttributes2 = (element, schema) => {
   const errors = [];
   const definitions = [
     ...schema.requiredAttributes,
@@ -2750,7 +2689,7 @@ var validateElementAgainstSchema = (element, schema) => {
       description: `The element is not allowed in this context.`
     });
   }
-  errors.push(...validateAttributes(element, schema));
+  errors.push(...validateAttributes2(element, schema));
   errors.push(...validateChildren(element, schema));
   return errors;
 };
@@ -2765,7 +2704,7 @@ var validateRequiredChildren = (element, schema, childElements) => {
       return childSchema?.code === allowedChild.code;
     });
     if (!hasChild) {
-      const requiredChildrenTag = findSchemaByCode(allowedChild.code).tag;
+      const requiredChildrenTag = findSchemaByCode(allowedChild.code)?.tag || allowedChild.code;
       addValidationIssue(errors, {
         store: getStore(element),
         title: `Missing required child element ${requiredChildrenTag}`,
@@ -2930,7 +2869,6 @@ var validateXml = (xml, elementsToLink, linkElements, schemasToValidateAgainst)
   DEPENDENT_FORBIDDEN_ELEMENTS,
   ELEMENT_SCHEMAS,
   ELE_ID_ATTRIBUTE,
-  ElementLabel,
   FIGURE_PLACEMENT_ATTRIBUTE,
   ID_ATTRS,
   IGNORED_ATTRIBUTES,
@@ -2961,6 +2899,7 @@ var validateXml = (xml, elementsToLink, linkElements, schemasToValidateAgainst)
   findAttributeDefinitionByName,
   findSchemaByCode,
   findSchemaByElement,
+  findSchemaByTagName,
   getAttributeName,
   isAttributeRestricted,
   isIgnoredAttribute,

package/dist/index.mjs

@@ -1,6 +1,22 @@
 // src/schema/utils/createSchema.ts
-var createSchema = (params) => {
-  return params;
+var createSchema = ({
+  code,
+  kind,
+  tag,
+  requiredAttributes,
+  optionalAttributes,
+  defaultChildCode,
+  allowedChildrenCodes
+}) => {
+  return {
+    code,
+    kind,
+    tag,
+    requiredAttributes,
+    optionalAttributes,
+    defaultChildCode,
+    allowedChildrenCodes
+  };
 };
 
 // src/schema/shared/globalAttributes.ts
@@ -101,7 +117,6 @@ var COMMENT_QUERY_SECTION_SCHEMA = createSchema({
   kind: "atom",
   tag: SPAN_TAG,
   code: "commentQuerySection",
-  matchesElement: (element) => element.classList.contains("cmtQurySection"),
   requiredAttributes: [...ID_ATTRS, "id"],
   optionalAttributes: [...TRACK_CHANGES_ATTRS, "title"],
   allowedChildrenCodes: [...ATOM_CODES_ALLOWED_CHILDREN]
@@ -121,7 +136,6 @@ var DELETION_SCHEMA = createSchema({
   code: "deletion",
   kind: "atom",
   tag: SPAN_TAG,
-  matchesElement: (element) => element.classList.contains("del"),
   requiredAttributes: [...TRACK_CHANGES_ATTRS, ...ID_ATTRS],
   optionalAttributes: [],
   allowedChildrenCodes: [
@@ -172,7 +186,6 @@ var INSERTION_SCHEMA = createSchema({
   code: "insertion",
   kind: "atom",
   tag: SPAN_TAG,
-  matchesElement: (element) => element.classList.contains("ins"),
   requiredAttributes: [...TRACK_CHANGES_ATTRS, ...ID_ATTRS],
   optionalAttributes: [],
   allowedChildrenCodes: [
@@ -1894,21 +1907,15 @@ var EPIGRAPH_SCHEMA = createSchema({
 });
 
 // src/schema/elementSchemas/elements/footnoteSection.ts
-var FOOTNOTE_SECTION_ROLES = ["ch", "bk"];
 var FOOTNOTE_SECTION_SCHEMA = createSchema({
   code: "footnoteSection",
   kind: "element",
   tag: SECTION_TAG,
-  matchesElement: (element) => {
-    const role = element.getAttribute("role");
-    if (role && FOOTNOTE_SECTION_ROLES.includes(role)) return true;
-    return element.querySelector(FOOTNOTE_TAG) !== null;
-  },
   requiredAttributes: [
     ...ID_ATTRS,
     {
       name: "role",
-      values: FOOTNOTE_SECTION_ROLES,
+      values: ["ch", "bk"],
       defaultValue: "ch"
     }
   ],
@@ -1921,22 +1928,16 @@ var FOOTNOTE_SECTION_SCHEMA = createSchema({
 });
 
 // src/schema/elementSchemas/elements/heading.ts
-var HEADING_ROLES = ["H1", "H2", "H3", "H4", "H5", "H6", "vignette_group"];
 var HEADING_SCHEMA = createSchema({
   code: "heading",
   kind: "element",
   tag: SECTION_TAG,
-  matchesElement: (element) => {
-    const role = element.getAttribute("role");
-    if (!role) return false;
-    return HEADING_ROLES.includes(role);
-  },
   requiredAttributes: [
     ...ID_ATTRS,
     "xmlid",
     {
       name: "role",
-      values: HEADING_ROLES,
+      values: ["H1", "H2", "H3", "H4", "H5", "H6", "vignette_group"],
       defaultValue: "H1"
     }
   ],
@@ -2004,6 +2005,7 @@ var MATHPHRASE_SCHEMA = createSchema({
   requiredAttributes: [ELE_ID_ATTRIBUTE],
   optionalAttributes: [],
   allowedChildrenCodes: [{ code: MATH_SCHEMA.code, required: true }]
+  // TODO: Should have flag for insertion and deletion
 });
 
 // src/schema/elementSchemas/elements/reference/bibliodiv.ts
@@ -2301,11 +2303,42 @@ var isIgnoredAttribute = (attribute) => IGNORED_ATTRIBUTES.includes(attribute) |
 var isIgnoredElement = (element) => IGNORED_ELEMENT_SELECTORS.some((selector) => element.matches(selector));
 var isIgnoredValidation = (code) => IGNORED_VALIDATION_ELEMENT_SELECTORS.includes(code);
 var findSchemaByCode = (code) => SCHEMAS[code];
+var findSchemaByTagName = (tagName) => Object.values(SCHEMAS).filter(
+  (schema) => schema.tag === tagName.toUpperCase()
+);
 var findSchemaByElement = (element) => {
-  const schema = Object.values(SCHEMAS).find(
-    (schema2) => schema2.tag == element.tagName && schema2.matchesElement?.(element)
-  );
-  return schema;
+  const tagName = element.tagName.toUpperCase();
+  const isInsertion = element.classList.contains("ins");
+  const isDeletion = element.classList.contains("del");
+  const isQueryComment = element.classList.contains("cmtQurySection");
+  const role = element.getAttribute("role");
+  if (tagName === SPAN_TAG) {
+    if (isQueryComment) {
+      return findSchemaByCode("commentQuerySection");
+    }
+    if (isInsertion) {
+      return findSchemaByCode("insertion");
+    }
+    if (isDeletion) {
+      return findSchemaByCode("deletion");
+    }
+  }
+  if (tagName === SECTION_TAG) {
+    if (role) {
+      if (role.startsWith("H")) {
+        return findSchemaByCode("heading");
+      }
+      if (role === "ch" || role === "bk") {
+        return findSchemaByCode("footnoteSection");
+      }
+    }
+    const isFootnoteSectionWithoutRole = element.querySelector(FOOTNOTE_TAG);
+    if (isFootnoteSectionWithoutRole) {
+      return findSchemaByCode("footnoteSection");
+    }
+  }
+  const candidates = findSchemaByTagName(tagName);
+  return candidates[0];
 };
 var isAttributeRestricted = (attr) => typeof attr !== "string";
 var getAttributeName = (attribute) => typeof attribute === "string" ? attribute.toLowerCase() : attribute.name.toLowerCase();
@@ -2319,144 +2352,50 @@ var findAttributeDefinitionByName = (definitions, name) => {
 };
 
 // src/schema/utils/createElement.ts
+var validateAttributes = (attributes, schema) => {
+  const definitions = [
+    ...schema.requiredAttributes,
+    ...schema.optionalAttributes
+  ];
+  for (const [name, value] of Object.entries(attributes)) {
+    if (value === void 0) {
+      continue;
+    }
+    const definition = findAttributeDefinitionByName(definitions, name);
+    if (!definition) {
+      throw new Error(
+        `Invalid attribute "${name}" for schema "${schema.code}".`
+      );
+    }
+    if (!isAttributeRestricted(definition)) {
+      continue;
+    }
+    if (!definition.values.includes(value)) {
+      throw new Error(
+        `Invalid value "${value}" for attribute "${name}" on schema "${schema.code}". Allowed values: ${definition.values.join(", ")}.`
+      );
+    }
+  }
+};
 var createElement = ({
   schemaCode,
   attributes
 }) => {
   const schema = findSchemaByCode(schemaCode);
+  if (!schema) {
+    throw new Error(`Schema not found for code: ${schemaCode}`);
+  }
+  validateAttributes(attributes, schema);
   const element = document.createElement(schema.tag.toLowerCase());
   for (const [name, value] of Object.entries(attributes)) {
-    if (!value) continue;
+    if (value === void 0) {
+      continue;
+    }
     element.setAttribute(name, String(value));
   }
   return element;
 };
 
-// src/schema/utils/labelElements.ts
-var ElementLabel = {
-  referenceBibliomixed: "Reference Bibliomixed",
-  referenceBibliography: "Reference Bibliography",
-  bibliodiv: "Bibliodiv",
-  indexterm: "Indexterm",
-  primary: "Primary",
-  secondary: "Secondary",
-  tertiary: "Tertiary",
-  quaternary: "Quaternary",
-  bookmark: "Bookmark",
-  see: "Cross Reference",
-  commentQuerySection: "Comment/Query",
-  comment: "Comment",
-  content: "Content",
-  query: "Query",
-  reply: "Reply",
-  deletion: "Deletion",
-  emphasis: "Emphasis",
-  highlightmark: "Highlightmark",
-  i: "Italic",
-  insertion: "Insertion",
-  sc: "Small Caps",
-  strike: "Strike",
-  sub: "Subscript",
-  sup: "Superscript",
-  u: "Underline",
-  b: "Bold",
-  referenceMark: "Reference Mark",
-  degrees: "Degrees",
-  email: "Email",
-  equation: "Equation",
-  fignote: "Fignote",
-  figsource: "Figsource",
-  firstname: "Firstname",
-  footnote: "Footnote Marker",
-  footnoteno: "Footnote Number",
-  honorific: "Honorific",
-  img: "Image",
-  informalfigure: "Floating Figure",
-  keyword: "Keyword",
-  label1: "Label",
-  li: "List Item",
-  line: "Line",
-  lrh: "Running Head Left",
-  math: "Math",
-  mathphrase: "Math Phrase",
-  merror: "Math Error",
-  mfrac: "Math  Fraction",
-  mi: "Math Identifier",
-  mmultiscripts: "Math Multiscripts",
-  mn: "Math Number",
-  mo: "Math Operator",
-  mover: "Math Over",
-  mpadded: "Math Padded",
-  mphantom: "Math Phantom",
-  mprescripts: "Math Prescripts",
-  mroot: "Math Root",
-  mrow: "Math Row",
-  ms: "Math Space",
-  mspace: "Math Space",
-  msqrt: "Math Square Root",
-  mstyle: "Math Style",
-  msub: "Math Subscript",
-  msubsup: "Math Subscript Superscript",
-  msup: "Math Superscript",
-  mtable: "Math Table",
-  mtd: "Math Table Data",
-  mtext: "Math Text",
-  mtr: "Math Table Row",
-  munder: "Math Under",
-  munderover: "Math Under Over",
-  olink: "Online Link",
-  org: "Org",
-  orgname: "Orgname",
-  para: "Paragraph",
-  punc: "Punctuation",
-  rrh: "Running Head Right",
-  source1: "Source",
-  speaker: "Speaker",
-  subtitle1: "Subtitle",
-  surname: "Surname",
-  tag: "Tag",
-  tblfn: "Table Footnote",
-  tblsource: "Table Source",
-  thead: "Thead",
-  title1: "Title",
-  token: "Token",
-  tp: "Table Paragraph",
-  abstract1: "Abstract",
-  affiliation: "Affiliation",
-  alttext: "Alttext",
-  appendix: "Appendix",
-  author: "Author",
-  authorgroup: "Authorgroup",
-  blockquote: "Blockquote",
-  caption1: "Caption",
-  chapter: "Chapter",
-  dialogue: "Dialogue",
-  epigraph: "Epigraph",
-  figure1: "Figure",
-  footnoteSection: "Footnote Section",
-  heading: "Heading",
-  imageobject: "Image Object",
-  info1: "Info",
-  keywordset: "Keyword FGroup",
-  mediaobject: "Mediaobject",
-  ol: "Ordered List",
-  personname: "Person Name",
-  poem: "Poem",
-  sidebar: "Box",
-  table: "Table",
-  table1: "Table",
-  tbody: "Table Body",
-  td: "Table Data",
-  tgroup: "Table Group",
-  tr: "Table Row",
-  ul: "Unordered List",
-  footnote1: "Footnote",
-  inlineequation: "Inline Equation",
-  link: "Link",
-  uri: "URI",
-  phrase: "Phrase"
-};
-
 // src/schema/shared/dependentsForbiddenElements.ts
 var DEPENDENT_FORBIDDEN_ELEMENTS = [
   {
@@ -2631,7 +2570,7 @@ var validateLinkend = (linkElement, elementsToLink) => {
 };
 
 // src/validation/validateAttributes.ts
-var validateAttributes = (element, schema) => {
+var validateAttributes2 = (element, schema) => {
   const errors = [];
   const definitions = [
     ...schema.requiredAttributes,
@@ -2682,7 +2621,7 @@ var validateElementAgainstSchema = (element, schema) => {
       description: `The element is not allowed in this context.`
     });
   }
-  errors.push(...validateAttributes(element, schema));
+  errors.push(...validateAttributes2(element, schema));
   errors.push(...validateChildren(element, schema));
   return errors;
 };
@@ -2697,7 +2636,7 @@ var validateRequiredChildren = (element, schema, childElements) => {
       return childSchema?.code === allowedChild.code;
     });
     if (!hasChild) {
-      const requiredChildrenTag = findSchemaByCode(allowedChild.code).tag;
+      const requiredChildrenTag = findSchemaByCode(allowedChild.code)?.tag || allowedChild.code;
       addValidationIssue(errors, {
         store: getStore(element),
         title: `Missing required child element ${requiredChildrenTag}`,
@@ -2861,7 +2800,6 @@ export {
   DEPENDENT_FORBIDDEN_ELEMENTS,
   ELEMENT_SCHEMAS,
   ELE_ID_ATTRIBUTE,
-  ElementLabel,
   FIGURE_PLACEMENT_ATTRIBUTE,
   ID_ATTRS,
   IGNORED_ATTRIBUTES,
@@ -2892,6 +2830,7 @@ export {
   findAttributeDefinitionByName,
   findSchemaByCode,
   findSchemaByElement,
+  findSchemaByTagName,
   getAttributeName,
   isAttributeRestricted,
   isIgnoredAttribute,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pro-editor-schema",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "Pro Editor XML schemas",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -19,13 +19,18 @@
     "build": "tsup src/index.ts --format cjs,esm --dts",
     "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
     "typecheck": "tsc --noEmit",
+    "lint": "eslint src",
     "test": "vitest run",
-    "test:watch": "vitest"
+    "test:watch": "vitest",
+    "check": "npm ci && npm run typecheck && npm run lint && npm run test && npm run build"
   },
   "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "eslint": "^10.6.0",
     "happy-dom": "^20.0.10",
     "tsup": "^8.0.0",
     "typescript": "^5.0.0",
+    "typescript-eslint": "^8.62.1",
     "vitest": "^3.2.4"
   }
 }