@unicode-utils/parser 0.12.0-beta.19 → 0.12.0-beta.20

package/dist/{chunk-DgIJwGJC.mjs → chunk-DQk6qfdC.mjs}

@@ -1,6 +1,6 @@
-//#region rolldown:runtime
+//#region \0rolldown/runtime.js
 var __defProp = Object.defineProperty;
-var __exportAll = (all, symbols) => {
+var __exportAll = (all, no_symbols) => {
 	let target = {};
 	for (var name in all) {
 		__defProp(target, name, {
@@ -8,7 +8,7 @@ var __exportAll = (all, symbols) => {
 			enumerable: true
 		});
 	}
-	if (symbols) {
+	if (!no_symbols) {
 		__defProp(target, Symbol.toStringTag, { value: "Module" });
 	}
 	return target;

package/dist/{datafile-C8Gow2D5.mjs → datafile-BwUQI7Vy.mjs}

@@ -1,5 +1,5 @@
-import { t as __exportAll } from "./chunk-DgIJwGJC.mjs";
-import { _ as trimCommentLine, a as isBoundaryLine, c as isEOFMarker, f as isLineWithData, i as inferVersion, l as isEmptyLine, m as isPropertyLine, n as getPropertyValue, o as isCommentLine, r as inferFileName, t as getBoundaryLineStyle } from "./line-helpers-C2zYZ-C-.mjs";
+import { t as __exportAll } from "./chunk-DQk6qfdC.mjs";
+import { getBoundaryLineStyle, getPropertyValue, inferFileName, inferVersion, isBoundaryLine, isCommentLine, isEOFMarker, isEmptyLine, isLineWithData, isPropertyLine, trimCommentLine } from "./line-helpers.mjs";
 import { invariant } from "@luxass/utils";
 import defu from "defu";
 

package/dist/{datafile-BcAce1H5.d.mts → datafile-FYBnmeYg.d.mts}

@@ -1,4 +1,4 @@
-import { t as BoundaryStyle } from "./line-helpers-DEQe0sT8.mjs";
+import { t as BoundaryStyle } from "./line-helpers-Cx9GykB0.mjs";
 
 //#region src/datafile/ast.d.ts
 declare const NodeTypes: {

package/dist/datafile.d.mts

@@ -1,2 +1,2 @@
-import { C as EmptyNode, D as PropertyNode, E as NodeTypes, O as RootNode, S as EmptyCommentNode, T as NodeType, _ as BoundaryNode, a as isEmptyCommentNode, b as DataNode, c as isPropertyNode, d as RawDataFile, f as UCDSectionWithLines, g as BaseNode, h as ast_utils_d_exports, i as isEOFNode, k as UnknownNode, l as isRootNode, m as parseSections, n as isCommentNode, o as isEmptyNode, p as hasSections, r as isDataNode, s as isNode, t as isBoundaryNode, u as isUnknownNode, v as ChildNode, w as Node, x as EOFNode, y as CommentNode } from "./datafile-BcAce1H5.mjs";
+import { C as EmptyNode, D as PropertyNode, E as NodeTypes, O as RootNode, S as EmptyCommentNode, T as NodeType, _ as BoundaryNode, a as isEmptyCommentNode, b as DataNode, c as isPropertyNode, d as RawDataFile, f as UCDSectionWithLines, g as BaseNode, h as ast_utils_d_exports, i as isEOFNode, k as UnknownNode, l as isRootNode, m as parseSections, n as isCommentNode, o as isEmptyNode, p as hasSections, r as isDataNode, s as isNode, t as isBoundaryNode, u as isUnknownNode, v as ChildNode, w as Node, x as EOFNode, y as CommentNode } from "./datafile-FYBnmeYg.mjs";
 export { BaseNode, BoundaryNode, ChildNode, CommentNode, DataNode, EOFNode, EmptyCommentNode, EmptyNode, Node, NodeType, NodeTypes, PropertyNode, RawDataFile, RootNode, UCDSectionWithLines, UnknownNode, ast_utils_d_exports as astUtils, hasSections, isBoundaryNode, isCommentNode, isDataNode, isEOFNode, isEmptyCommentNode, isEmptyNode, isNode, isPropertyNode, isRootNode, isUnknownNode, parseSections };

package/dist/datafile.mjs

@@ -1,3 +1,3 @@
-import { _ as isUnknownNode, c as isBoundaryNode, d as isEOFNode, f as isEmptyCommentNode, g as isRootNode, h as isPropertyNode, l as isCommentNode, m as isNode, n as hasSections, p as isEmptyNode, r as parseSections, s as ast_utils_exports, t as RawDataFile, u as isDataNode, v as NodeTypes } from "./datafile-C8Gow2D5.mjs";
+import { _ as isUnknownNode, c as isBoundaryNode, d as isEOFNode, f as isEmptyCommentNode, g as isRootNode, h as isPropertyNode, l as isCommentNode, m as isNode, n as hasSections, p as isEmptyNode, r as parseSections, s as ast_utils_exports, t as RawDataFile, u as isDataNode, v as NodeTypes } from "./datafile-BwUQI7Vy.mjs";
 
 export { NodeTypes, RawDataFile, ast_utils_exports as astUtils, hasSections, isBoundaryNode, isCommentNode, isDataNode, isEOFNode, isEmptyCommentNode, isEmptyNode, isNode, isPropertyNode, isRootNode, isUnknownNode, parseSections };

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { _ as isMissingAnnotation, a as getBoundaryLineStyle, b as parseMissingAnnotation, c as inferVersion, d as isDashBoundary, f as isEOFMarker, g as isLineWithData, h as isHashBoundary, i as SpecialTag, l as isBoundaryLine, m as isEqualsBoundary, n as MissingAnnotation, o as getPropertyValue, p as isEmptyLine, r as ParsedFileName, s as inferFileName, t as BoundaryStyle, u as isCommentLine, v as isPropertyLine, x as trimCommentLine, y as parseFileNameLine } from "./line-helpers-DEQe0sT8.mjs";
-import { C as EmptyNode, D as PropertyNode, E as NodeTypes, O as RootNode, S as EmptyCommentNode, T as NodeType, _ as BoundaryNode, a as isEmptyCommentNode, b as DataNode, c as isPropertyNode, d as RawDataFile, f as UCDSectionWithLines, g as BaseNode, h as ast_utils_d_exports, i as isEOFNode, k as UnknownNode, l as isRootNode, m as parseSections, n as isCommentNode, o as isEmptyNode, p as hasSections, r as isDataNode, s as isNode, t as isBoundaryNode, u as isUnknownNode, v as ChildNode, w as Node, x as EOFNode, y as CommentNode } from "./datafile-BcAce1H5.mjs";
+import { _ as isMissingAnnotation, a as getBoundaryLineStyle, b as parseMissingAnnotation, c as inferVersion, d as isDashBoundary, f as isEOFMarker, g as isLineWithData, h as isHashBoundary, i as SpecialTag, l as isBoundaryLine, m as isEqualsBoundary, n as MissingAnnotation, o as getPropertyValue, p as isEmptyLine, r as ParsedFileName, s as inferFileName, t as BoundaryStyle, u as isCommentLine, v as isPropertyLine, x as trimCommentLine, y as parseFileNameLine } from "./line-helpers-Cx9GykB0.mjs";
+import { C as EmptyNode, D as PropertyNode, E as NodeTypes, O as RootNode, S as EmptyCommentNode, T as NodeType, _ as BoundaryNode, a as isEmptyCommentNode, b as DataNode, c as isPropertyNode, d as RawDataFile, f as UCDSectionWithLines, g as BaseNode, h as ast_utils_d_exports, i as isEOFNode, k as UnknownNode, l as isRootNode, m as parseSections, n as isCommentNode, o as isEmptyNode, p as hasSections, r as isDataNode, s as isNode, t as isBoundaryNode, u as isUnknownNode, v as ChildNode, w as Node, x as EOFNode, y as CommentNode } from "./datafile-FYBnmeYg.mjs";
 
 //#region src/inference/heading.d.ts
 interface InferHeadingSettings {

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { _ as isUnknownNode, a as HEADING_SETTINGS_CONFIG, c as isBoundaryNode, d as isEOFNode, f as isEmptyCommentNode, g as isRootNode, h as isPropertyNode, i as inferHeadingFromAST, l as isCommentNode, m as isNode, n as hasSections, o as getHeadingSettings, p as isEmptyNode, r as parseSections, s as ast_utils_exports, t as RawDataFile, u as isDataNode, v as NodeTypes } from "./datafile-C8Gow2D5.mjs";
-import { _ as trimCommentLine, a as isBoundaryLine, c as isEOFMarker, d as isHashBoundary, f as isLineWithData, g as parseMissingAnnotation, h as parseFileNameLine, i as inferVersion, l as isEmptyLine, m as isPropertyLine, n as getPropertyValue, o as isCommentLine, p as isMissingAnnotation, r as inferFileName, s as isDashBoundary, t as getBoundaryLineStyle, u as isEqualsBoundary } from "./line-helpers-C2zYZ-C-.mjs";
+import { _ as isUnknownNode, a as HEADING_SETTINGS_CONFIG, c as isBoundaryNode, d as isEOFNode, f as isEmptyCommentNode, g as isRootNode, h as isPropertyNode, i as inferHeadingFromAST, l as isCommentNode, m as isNode, n as hasSections, o as getHeadingSettings, p as isEmptyNode, r as parseSections, s as ast_utils_exports, t as RawDataFile, u as isDataNode, v as NodeTypes } from "./datafile-BwUQI7Vy.mjs";
+import { getBoundaryLineStyle, getPropertyValue, inferFileName, inferVersion, isBoundaryLine, isCommentLine, isDashBoundary, isEOFMarker, isEmptyLine, isEqualsBoundary, isHashBoundary, isLineWithData, isMissingAnnotation, isPropertyLine, parseFileNameLine, parseMissingAnnotation, trimCommentLine } from "./line-helpers.mjs";
 
 export { HEADING_SETTINGS_CONFIG, NodeTypes, RawDataFile, ast_utils_exports as astUtils, getBoundaryLineStyle, getHeadingSettings, getPropertyValue, hasSections, inferFileName, inferHeadingFromAST, inferVersion, isBoundaryLine, isBoundaryNode, isCommentLine, isCommentNode, isDashBoundary, isDataNode, isEOFMarker, isEOFNode, isEmptyCommentNode, isEmptyLine, isEmptyNode, isEqualsBoundary, isHashBoundary, isLineWithData, isMissingAnnotation, isNode, isPropertyLine, isPropertyNode, isRootNode, isUnknownNode, parseFileNameLine, parseMissingAnnotation, parseSections, trimCommentLine };

package/dist/line-helpers.d.mts

@@ -1,2 +1,2 @@
-import { _ as isMissingAnnotation, a as getBoundaryLineStyle, b as parseMissingAnnotation, c as inferVersion, d as isDashBoundary, f as isEOFMarker, g as isLineWithData, h as isHashBoundary, i as SpecialTag, l as isBoundaryLine, m as isEqualsBoundary, n as MissingAnnotation, o as getPropertyValue, p as isEmptyLine, r as ParsedFileName, s as inferFileName, t as BoundaryStyle, u as isCommentLine, v as isPropertyLine, x as trimCommentLine, y as parseFileNameLine } from "./line-helpers-DEQe0sT8.mjs";
+import { _ as isMissingAnnotation, a as getBoundaryLineStyle, b as parseMissingAnnotation, c as inferVersion, d as isDashBoundary, f as isEOFMarker, g as isLineWithData, h as isHashBoundary, i as SpecialTag, l as isBoundaryLine, m as isEqualsBoundary, n as MissingAnnotation, o as getPropertyValue, p as isEmptyLine, r as ParsedFileName, s as inferFileName, t as BoundaryStyle, u as isCommentLine, v as isPropertyLine, x as trimCommentLine, y as parseFileNameLine } from "./line-helpers-Cx9GykB0.mjs";
 export { BoundaryStyle, MissingAnnotation, ParsedFileName, SpecialTag, getBoundaryLineStyle, getPropertyValue, inferFileName, inferVersion, isBoundaryLine, isCommentLine, isDashBoundary, isEOFMarker, isEmptyLine, isEqualsBoundary, isHashBoundary, isLineWithData, isMissingAnnotation, isPropertyLine, parseFileNameLine, parseMissingAnnotation, trimCommentLine };

package/dist/line-helpers.mjs

@@ -1,3 +1,374 @@
-import { _ as trimCommentLine, a as isBoundaryLine, c as isEOFMarker, d as isHashBoundary, f as isLineWithData, g as parseMissingAnnotation, h as parseFileNameLine, i as inferVersion, l as isEmptyLine, m as isPropertyLine, n as getPropertyValue, o as isCommentLine, p as isMissingAnnotation, r as inferFileName, s as isDashBoundary, t as getBoundaryLineStyle, u as isEqualsBoundary } from "./line-helpers-C2zYZ-C-.mjs";
+//#region src/line-helpers.ts
+const HASH_BOUNDARY_REGEX = /^\s*#\s*#{2,}\s*$/;
+const EQUALS_BOUNDARY_REGEX = /^\s*#\s*={2,}\s*$/;
+const DASH_BOUNDARY_REGEX = /^\s*#\s*-{2,}\s*$/;
+/**
+* Determines if a line is an End-of-File (EOF) marker.
+*
+* In Unicode data files, the EOF marker is typically represented
+* as a line containing only "# EOF".
+*
+* @param {string} [line] - The line to check
+* @returns {boolean} True if the line is an EOF marker, false otherwise
+*
+* @example
+* ```ts
+* isEOFMarker("# EOF"); // true
+* isEOFMarker("Some text"); // false
+* isEOFMarker(); // false
+* ```
+*/
+function isEOFMarker(line) {
+	if (!line) return false;
+	return line.trim() === "# EOF";
+}
+/**
+* Determines if a line contains a hash boundary pattern.
+*
+* A hash boundary is a line containing a pattern like "# ###" (# followed by multiple #).
+* These patterns are used in Unicode data files to separate different sections of content.
+*
+* @param {string} line - The line to check
+* @returns {boolean} True if the line contains a hash boundary pattern, false otherwise
+*
+* @example
+* ```ts
+* isHashBoundary("# #####"); // true
+* isHashBoundary("# Some text"); // false
+* isHashBoundary(""); // false
+* ```
+*/
+function isHashBoundary(line) {
+	if (!line) return false;
+	return HASH_BOUNDARY_REGEX.test(line);
+}
+/**
+* Determines if a line contains an equals boundary pattern.
+*
+* An equals boundary is a line containing a pattern like "# ===" (# followed by multiple =).
+* These patterns are used in Unicode data files to separate different sections of content.
+*
+* @param {string} line - The line to check
+* @returns {boolean} True if the line contains an equals boundary pattern, false otherwise
+*
+* @example
+* ```ts
+* isEqualsBoundary("# ====="); // true
+* isEqualsBoundary("# Some text"); // false
+* isEqualsBoundary(""); // false
+* ```
+*/
+function isEqualsBoundary(line) {
+	if (!line) return false;
+	return EQUALS_BOUNDARY_REGEX.test(line);
+}
+/**
+* Determines if a line contains a dash boundary pattern.
+*
+* A dash boundary is a line containing a pattern like "# ---" (# followed by multiple -).
+* These patterns are used in Unicode data files to separate different sections of content.
+*
+* @param {string} line - The line to check
+* @returns {boolean} True if the line contains a dash boundary pattern, false otherwise
+*
+* @example
+* ```ts
+* isDashBoundary("# -----"); // true
+* isDashBoundary("# Some text"); // false
+* isDashBoundary(""); // false
+* ```
+*/
+function isDashBoundary(line) {
+	if (!line) return false;
+	return DASH_BOUNDARY_REGEX.test(line);
+}
+/**
+* Determines if a line is any type of boundary line.
+*
+* A boundary line is any line that matches one of the boundary patterns:
+* hash boundary, equals boundary, or dash boundary. These patterns are used
+* in Unicode data files to separate different sections of content.
+*
+* @param {string} line - The line to check
+* @returns {boolean} True if the line is a boundary line, false otherwise
+*
+* @example
+* ```ts
+* isBoundaryLine("# #####"); // true (hash boundary)
+* isBoundaryLine("# ====="); // true (equals boundary)
+* isBoundaryLine("# -----"); // true (dash boundary)
+* isBoundaryLine("# Some text"); // false
+* isBoundaryLine(""); // false
+* ```
+*/
+function isBoundaryLine(line) {
+	if (!line) return false;
+	return isHashBoundary(line) || isEqualsBoundary(line) || isDashBoundary(line);
+}
+/**
+* Extracts the style character from a boundary line.
+*
+* This function determines which type of boundary character is used in the line:
+* '#', '=', or '-'. It checks the line against each boundary pattern and returns
+* the corresponding character.
+*
+* @param {string} line - The boundary line to analyze
+* @returns {BoundaryStyle} The boundary style character ('#', '=', or '-')
+* @throws {Error} If the line is not a valid boundary line
+*
+* @example
+* ```ts
+* getBoundaryLineStyle("# #####"); // returns "#"
+* getBoundaryLineStyle("# ====="); // returns "="
+* getBoundaryLineStyle("# -----"); // returns "-"
+* ```
+*/
+function getBoundaryLineStyle(line) {
+	if (isHashBoundary(line)) return "#";
+	if (isEqualsBoundary(line)) return "=";
+	if (isDashBoundary(line)) return "-";
+	throw new Error(`invalid boundary style for line: ${line}`);
+}
+/**
+* Determines if a line is a comment line.
+*
+* A comment line is either a line that starts with "# " or
+* a line that only contains "#" (possibly with whitespace).
+*
+* @param {string} line - The line to check
+* @returns {boolean} True if the line is a comment line, false otherwise
+*/
+function isCommentLine(line) {
+	if (!line) return false;
+	const trimmed = line.trimStart();
+	return trimmed.startsWith("#") && trimmed.length > 0;
+}
+/**
+* Removes the comment marker ('#') and any following whitespace from a line.
+*
+* This function is designed to extract the actual content from comment lines
+* in Unicode data files by removing the leading '#' character and any whitespace
+* that follows it.
+*
+* @param {string} line - The comment line to trim
+* @returns {string} The content of the comment line without the comment marker
+*
+* @example
+* ```ts
+* trimCommentLine("# Some comment"); // returns "Some comment"
+* trimCommentLine("#\tTabbed comment"); // returns "Tabbed comment"
+* trimCommentLine(""); // returns ""
+* ```
+*/
+function trimCommentLine(line) {
+	if (!line) return "";
+	return line.trim().replace(/^#\s*/, "");
+}
+/**
+* Checks if a string line is empty after trimming whitespace.
+*
+* @param {string} line - The string to check for emptiness
+* @returns {boolean} A boolean indicating whether the trimmed line is empty
+*/
+function isEmptyLine(line) {
+	if (!line) return true;
+	return line.trim() === "";
+}
+/**
+* Determines if a line contains data in a Unicode data file.
+*
+* A line is considered to contain data if it is neither a comment line
+* (starting with '#') nor an empty line.
+*
+* @param {string} line - The line to check
+* @returns {boolean} True if the line contains data, false otherwise
+*
+* @example
+* ```ts
+* isLineWithData("U+0020;SPACE"); // true
+* isLineWithData("# Comment line"); // false
+* isLineWithData(""); // false
+* ```
+*/
+function isLineWithData(line) {
+	return !isCommentLine(line) && !isEmptyLine(line);
+}
+/**
+* Check if a given line from a Unicode data file is a 'missing' annotation.
+*
+* In Unicode data files, lines starting with '# @missing:' indicate
+* a range of code points that are not assigned.
+*
+* @param {string} line - The line to check
+* @returns {boolean} True if the line is a missing annotation, false otherwise
+*/
+function isMissingAnnotation(line) {
+	return line.startsWith("# @missing:");
+}
+const MISSING_ANNOTATION_SPECIAL_TAGS = {
+	"<none>": "none",
+	"<script>": "script",
+	"<code-point>": "code-point"
+};
+/**
+* Parses a line into a MissingAnnotation object.
+*
+* This function attempts to extract information from a line that follows the
+* format of a missing annotation in Unicode data files.
+*
+* The format being parsed is:
+* `# @missing: START..END; DEFAULT_PROP_VALUE_OR_PROPERTY_NAME[; DEFAULT_PROPERTY_VALUE]`
+*
+* @param {string} line - The line to parse
+* @returns {MissingAnnotation | null} A MissingAnnotation object if the line is a valid missing annotation, null otherwise
+*
+* @example
+* ```ts
+* parseMissingAnnotation("# @missing: 0000..007F; NA")
+* // -> { start: "0000", end: "007F", defaultPropertyValue: "NA" }
+*
+* parseMissingAnnotation("# @missing: 0000..007F; Script; Unknown")
+* // -> { start: "0000", end: "007F", propertyName: "Script", defaultPropertyValue: "Unknown" }
+* ```
+*/
+function parseMissingAnnotation(line) {
+	if (!isMissingAnnotation(line)) return null;
+	const match = line.match(/^# @missing: ([0-9A-F]+)\.\.([0-9A-F]+); ([^;\n]+)(?:; ([^\n]+))?$/m);
+	if (match == null) return null;
+	const [_, start, end, defaultPropValueOrPropertyName, defaultPropertyValue] = match;
+	const defaultProperty = defaultPropertyValue == null ? defaultPropValueOrPropertyName : defaultPropertyValue;
+	const specialTag = defaultProperty && defaultProperty in MISSING_ANNOTATION_SPECIAL_TAGS ? MISSING_ANNOTATION_SPECIAL_TAGS[defaultProperty] : void 0;
+	if (start == null || end == null || defaultPropValueOrPropertyName == null) return null;
+	return {
+		start,
+		end,
+		propertyName: defaultPropertyValue == null ? void 0 : defaultPropValueOrPropertyName,
+		defaultPropertyValue: defaultProperty || "",
+		specialTag
+	};
+}
+/**
+* Attempts to infer the file name from the first line of a Unicode data file.
+*
+* This function extracts the file name from the first line of the content,
+* assuming it's a comment line. It removes any leading '#' characters and whitespace.
+*
+* For example:
+* - From a file with first line "# ArabicShaping-5.0.0.txt", it returns "ArabicShaping"
+* - From a file with first line "# UnicodeData-5.0.0.txt", it returns "UnicodeData"
+*
+* @param {string} line - The first line of the file
+* @returns {string | undefined} The inferred file name, or undefined if it can't be determined
+*/
+function inferFileName(line) {
+	return parseFileNameLine(line)?.fileName;
+}
+/**
+* Attempts to infer the version from the first line of a Unicode data file.
+*
+* This function extracts the version number from the first line of the content,
+* assuming it's a comment line. It looks for a pattern like "Name-X.Y.Z.txt"
+* and extracts the X.Y.Z part as the version.
+*
+* For example:
+* - From a file with first line "# ArabicShaping-5.0.0.txt", it returns "5.0.0"
+* - From a file with first line "# UnicodeData-14.0.0.txt", it returns "14.0.0"
+*
+* @param {string} line - The first line of the file
+* @returns {string | undefined} The inferred version number, or undefined if it can't be determined
+*/
+function inferVersion(line) {
+	return parseFileNameLine(line)?.version;
+}
+/**
+* Parses a line from a Unicode data file to extract the file name and version information.
+*
+* This function tries to extract file name and version information from a line that
+* typically appears at the beginning of Unicode data files. It handles various formats:
+* - "FileName-1.2.3.txt"
+* - "FileName-1.2.3"
+* - "FileName.txt"
+*
+* The function also properly handles comment markers at the beginning of the line.
+*
+* @param {string} line - The line to parse, typically the first line of a Unicode data file
+* @returns {ParsedFileName | undefined} An object containing the file name and version if
+*                                      successfully parsed, or undefined if parsing fails
+*
+* @example
+* ```ts
+* parseFileNameLine("# UnicodeData-14.0.0.txt");
+* // Returns { fileName: "UnicodeData", version: "14.0.0" }
+*
+* parseFileNameLine("# ArabicShaping.txt");
+* // Returns { fileName: "ArabicShaping", version: undefined }
+* ```
+*/
+function parseFileNameLine(line) {
+	if (!line) return;
+	line = line.split("\n")[0].trim();
+	if (!isCommentLine(line)) return;
+	line = line.trim().replace(/^#\s*/, "");
+	if (line === "") return;
+	let match = line.match(/^(.*?)(?:-([0-9.]+))?\.txt$/);
+	if (match == null) {
+		match = line.match(/^(.*?)(?:-([0-9.]+))?$/);
+		/* v8 ignore next 3 */
+		if (match == null) return;
+	}
+	const [_, fileName, version] = match;
+	if (!fileName || fileName.trim() === "") return;
+	return {
+		fileName,
+		version
+	};
+}
+/**
+* Determines if a line represents a property definition in Unicode data files.
+*
+* In Unicode data files, properties are typically defined in comment lines that
+* start with "# Property:" followed by the property name.
+*
+* @param {string} line - The line to check
+* @returns {boolean} True if the line is a property definition, false otherwise
+*
+* @example
+* ```ts
+* isPropertyLine("# Property: Age"); // true
+* isPropertyLine("# Some other comment"); // false
+* isPropertyLine(""); // false
+* ```
+*/
+function isPropertyLine(line) {
+	if (!line) return false;
+	if (!isCommentLine(line)) return false;
+	const val = getPropertyValue(line);
+	return val !== void 0 && val.trim() !== "";
+}
+/**
+* Extracts the property value from a property definition line in Unicode data files.
+*
+* This function parses a line that follows the format '# Property: [PropertyValue]'
+* and returns the PropertyValue part. It is used internally by isPropertyLine
+* to parse property definitions in Unicode data files.
+*
+* @param {string} line - The line to extract the property value from
+* @returns {string | undefined} The extracted property value, or undefined if
+*                              the line is not a valid property definition
+*
+* @example
+* ```ts
+* getPropertyValue("# Property: Age"); // returns "Age"
+* getPropertyValue("# Property: "); // returns undefined
+* getPropertyValue("# Not a property line"); // returns undefined
+* ```
+*/
+function getPropertyValue(line) {
+	const trimmedComment = trimCommentLine(line).trim();
+	if (trimmedComment === "") return;
+	if (!trimmedComment.startsWith("Property:")) return;
+	return trimmedComment.slice(9).trim();
+}
 
+//#endregion
 export { getBoundaryLineStyle, getPropertyValue, inferFileName, inferVersion, isBoundaryLine, isCommentLine, isDashBoundary, isEOFMarker, isEmptyLine, isEqualsBoundary, isHashBoundary, isLineWithData, isMissingAnnotation, isPropertyLine, parseFileNameLine, parseMissingAnnotation, trimCommentLine };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unicode-utils/parser",
-  "version": "0.12.0-beta.19",
+  "version": "0.12.0-beta.20",
   "description": "Unicode data file parser with AST support",
   "type": "module",
   "author": {
@@ -28,8 +28,6 @@
     "./line-helpers": "./dist/line-helpers.mjs",
     "./package.json": "./package.json"
   },
-  "main": "./dist/index.mjs",
-  "module": "./dist/index.mjs",
   "types": "./dist/index.d.mts",
   "publishConfig": {
     "access": "public"
@@ -38,19 +36,19 @@
     "dist"
   ],
   "dependencies": {
-    "@luxass/utils": "2.7.2",
+    "@luxass/utils": "2.7.3",
     "defu": "6.1.4"
   },
   "devDependencies": {
-    "@luxass/eslint-config": "6.0.3",
+    "@luxass/eslint-config": "7.2.0",
     "@types/node": "24.9.1",
-    "eslint": "9.39.2",
-    "eslint-plugin-format": "1.1.0",
-    "publint": "0.3.16",
-    "tsdown": "0.18.3",
+    "eslint": "10.0.0",
+    "eslint-plugin-format": "1.4.0",
+    "publint": "0.3.17",
+    "tsdown": "0.20.3",
     "typescript": "5.9.3",
-    "@unicode-utils-tooling/tsconfig": "0.12.0-beta.19",
-    "@unicode-utils-tooling/tsdown-config": "0.12.0-beta.19"
+    "@unicode-utils-tooling/tsdown-config": "0.12.0-beta.20",
+    "@unicode-utils-tooling/tsconfig": "0.12.0-beta.20"
   },
   "scripts": {
     "build": "tsdown --tsconfig=./tsconfig.build.json",

package/dist/line-helpers-C2zYZ-C-.mjs

@@ -1,374 +0,0 @@
-//#region src/line-helpers.ts
-const HASH_BOUNDARY_REGEX = /^\s*#\s*#{2,}\s*$/;
-const EQUALS_BOUNDARY_REGEX = /^\s*#\s*={2,}\s*$/;
-const DASH_BOUNDARY_REGEX = /^\s*#\s*-{2,}\s*$/;
-/**
-* Determines if a line is an End-of-File (EOF) marker.
-*
-* In Unicode data files, the EOF marker is typically represented
-* as a line containing only "# EOF".
-*
-* @param {string} [line] - The line to check
-* @returns {boolean} True if the line is an EOF marker, false otherwise
-*
-* @example
-* ```ts
-* isEOFMarker("# EOF"); // true
-* isEOFMarker("Some text"); // false
-* isEOFMarker(); // false
-* ```
-*/
-function isEOFMarker(line) {
-	if (!line) return false;
-	return line.trim() === "# EOF";
-}
-/**
-* Determines if a line contains a hash boundary pattern.
-*
-* A hash boundary is a line containing a pattern like "# ###" (# followed by multiple #).
-* These patterns are used in Unicode data files to separate different sections of content.
-*
-* @param {string} line - The line to check
-* @returns {boolean} True if the line contains a hash boundary pattern, false otherwise
-*
-* @example
-* ```ts
-* isHashBoundary("# #####"); // true
-* isHashBoundary("# Some text"); // false
-* isHashBoundary(""); // false
-* ```
-*/
-function isHashBoundary(line) {
-	if (!line) return false;
-	return HASH_BOUNDARY_REGEX.test(line);
-}
-/**
-* Determines if a line contains an equals boundary pattern.
-*
-* An equals boundary is a line containing a pattern like "# ===" (# followed by multiple =).
-* These patterns are used in Unicode data files to separate different sections of content.
-*
-* @param {string} line - The line to check
-* @returns {boolean} True if the line contains an equals boundary pattern, false otherwise
-*
-* @example
-* ```ts
-* isEqualsBoundary("# ====="); // true
-* isEqualsBoundary("# Some text"); // false
-* isEqualsBoundary(""); // false
-* ```
-*/
-function isEqualsBoundary(line) {
-	if (!line) return false;
-	return EQUALS_BOUNDARY_REGEX.test(line);
-}
-/**
-* Determines if a line contains a dash boundary pattern.
-*
-* A dash boundary is a line containing a pattern like "# ---" (# followed by multiple -).
-* These patterns are used in Unicode data files to separate different sections of content.
-*
-* @param {string} line - The line to check
-* @returns {boolean} True if the line contains a dash boundary pattern, false otherwise
-*
-* @example
-* ```ts
-* isDashBoundary("# -----"); // true
-* isDashBoundary("# Some text"); // false
-* isDashBoundary(""); // false
-* ```
-*/
-function isDashBoundary(line) {
-	if (!line) return false;
-	return DASH_BOUNDARY_REGEX.test(line);
-}
-/**
-* Determines if a line is any type of boundary line.
-*
-* A boundary line is any line that matches one of the boundary patterns:
-* hash boundary, equals boundary, or dash boundary. These patterns are used
-* in Unicode data files to separate different sections of content.
-*
-* @param {string} line - The line to check
-* @returns {boolean} True if the line is a boundary line, false otherwise
-*
-* @example
-* ```ts
-* isBoundaryLine("# #####"); // true (hash boundary)
-* isBoundaryLine("# ====="); // true (equals boundary)
-* isBoundaryLine("# -----"); // true (dash boundary)
-* isBoundaryLine("# Some text"); // false
-* isBoundaryLine(""); // false
-* ```
-*/
-function isBoundaryLine(line) {
-	if (!line) return false;
-	return isHashBoundary(line) || isEqualsBoundary(line) || isDashBoundary(line);
-}
-/**
-* Extracts the style character from a boundary line.
-*
-* This function determines which type of boundary character is used in the line:
-* '#', '=', or '-'. It checks the line against each boundary pattern and returns
-* the corresponding character.
-*
-* @param {string} line - The boundary line to analyze
-* @returns {BoundaryStyle} The boundary style character ('#', '=', or '-')
-* @throws {Error} If the line is not a valid boundary line
-*
-* @example
-* ```ts
-* getBoundaryLineStyle("# #####"); // returns "#"
-* getBoundaryLineStyle("# ====="); // returns "="
-* getBoundaryLineStyle("# -----"); // returns "-"
-* ```
-*/
-function getBoundaryLineStyle(line) {
-	if (isHashBoundary(line)) return "#";
-	if (isEqualsBoundary(line)) return "=";
-	if (isDashBoundary(line)) return "-";
-	throw new Error(`invalid boundary style for line: ${line}`);
-}
-/**
-* Determines if a line is a comment line.
-*
-* A comment line is either a line that starts with "# " or
-* a line that only contains "#" (possibly with whitespace).
-*
-* @param {string} line - The line to check
-* @returns {boolean} True if the line is a comment line, false otherwise
-*/
-function isCommentLine(line) {
-	if (!line) return false;
-	const trimmed = line.trimStart();
-	return trimmed.startsWith("#") && trimmed.length > 0;
-}
-/**
-* Removes the comment marker ('#') and any following whitespace from a line.
-*
-* This function is designed to extract the actual content from comment lines
-* in Unicode data files by removing the leading '#' character and any whitespace
-* that follows it.
-*
-* @param {string} line - The comment line to trim
-* @returns {string} The content of the comment line without the comment marker
-*
-* @example
-* ```ts
-* trimCommentLine("# Some comment"); // returns "Some comment"
-* trimCommentLine("#\tTabbed comment"); // returns "Tabbed comment"
-* trimCommentLine(""); // returns ""
-* ```
-*/
-function trimCommentLine(line) {
-	if (!line) return "";
-	return line.trim().replace(/^#\s*/, "");
-}
-/**
-* Checks if a string line is empty after trimming whitespace.
-*
-* @param {string} line - The string to check for emptiness
-* @returns {boolean} A boolean indicating whether the trimmed line is empty
-*/
-function isEmptyLine(line) {
-	if (!line) return true;
-	return line.trim() === "";
-}
-/**
-* Determines if a line contains data in a Unicode data file.
-*
-* A line is considered to contain data if it is neither a comment line
-* (starting with '#') nor an empty line.
-*
-* @param {string} line - The line to check
-* @returns {boolean} True if the line contains data, false otherwise
-*
-* @example
-* ```ts
-* isLineWithData("U+0020;SPACE"); // true
-* isLineWithData("# Comment line"); // false
-* isLineWithData(""); // false
-* ```
-*/
-function isLineWithData(line) {
-	return !isCommentLine(line) && !isEmptyLine(line);
-}
-/**
-* Check if a given line from a Unicode data file is a 'missing' annotation.
-*
-* In Unicode data files, lines starting with '# @missing:' indicate
-* a range of code points that are not assigned.
-*
-* @param {string} line - The line to check
-* @returns {boolean} True if the line is a missing annotation, false otherwise
-*/
-function isMissingAnnotation(line) {
-	return line.startsWith("# @missing:");
-}
-const MISSING_ANNOTATION_SPECIAL_TAGS = {
-	"<none>": "none",
-	"<script>": "script",
-	"<code-point>": "code-point"
-};
-/**
-* Parses a line into a MissingAnnotation object.
-*
-* This function attempts to extract information from a line that follows the
-* format of a missing annotation in Unicode data files.
-*
-* The format being parsed is:
-* `# @missing: START..END; DEFAULT_PROP_VALUE_OR_PROPERTY_NAME[; DEFAULT_PROPERTY_VALUE]`
-*
-* @param {string} line - The line to parse
-* @returns {MissingAnnotation | null} A MissingAnnotation object if the line is a valid missing annotation, null otherwise
-*
-* @example
-* ```ts
-* parseMissingAnnotation("# @missing: 0000..007F; NA")
-* // -> { start: "0000", end: "007F", defaultPropertyValue: "NA" }
-*
-* parseMissingAnnotation("# @missing: 0000..007F; Script; Unknown")
-* // -> { start: "0000", end: "007F", propertyName: "Script", defaultPropertyValue: "Unknown" }
-* ```
-*/
-function parseMissingAnnotation(line) {
-	if (!isMissingAnnotation(line)) return null;
-	const match = line.match(/^# @missing: ([0-9A-F]+)\.\.([0-9A-F]+); ([^;\n]+)(?:; ([^\n]+))?$/m);
-	if (match == null) return null;
-	const [_, start, end, defaultPropValueOrPropertyName, defaultPropertyValue] = match;
-	const defaultProperty = defaultPropertyValue == null ? defaultPropValueOrPropertyName : defaultPropertyValue;
-	const specialTag = defaultProperty && defaultProperty in MISSING_ANNOTATION_SPECIAL_TAGS ? MISSING_ANNOTATION_SPECIAL_TAGS[defaultProperty] : void 0;
-	if (start == null || end == null || defaultPropValueOrPropertyName == null) return null;
-	return {
-		start,
-		end,
-		propertyName: defaultPropertyValue == null ? void 0 : defaultPropValueOrPropertyName,
-		defaultPropertyValue: defaultProperty || "",
-		specialTag
-	};
-}
-/**
-* Attempts to infer the file name from the first line of a Unicode data file.
-*
-* This function extracts the file name from the first line of the content,
-* assuming it's a comment line. It removes any leading '#' characters and whitespace.
-*
-* For example:
-* - From a file with first line "# ArabicShaping-5.0.0.txt", it returns "ArabicShaping"
-* - From a file with first line "# UnicodeData-5.0.0.txt", it returns "UnicodeData"
-*
-* @param {string} line - The first line of the file
-* @returns {string | undefined} The inferred file name, or undefined if it can't be determined
-*/
-function inferFileName(line) {
-	return parseFileNameLine(line)?.fileName;
-}
-/**
-* Attempts to infer the version from the first line of a Unicode data file.
-*
-* This function extracts the version number from the first line of the content,
-* assuming it's a comment line. It looks for a pattern like "Name-X.Y.Z.txt"
-* and extracts the X.Y.Z part as the version.
-*
-* For example:
-* - From a file with first line "# ArabicShaping-5.0.0.txt", it returns "5.0.0"
-* - From a file with first line "# UnicodeData-14.0.0.txt", it returns "14.0.0"
-*
-* @param {string} line - The first line of the file
-* @returns {string | undefined} The inferred version number, or undefined if it can't be determined
-*/
-function inferVersion(line) {
-	return parseFileNameLine(line)?.version;
-}
-/**
-* Parses a line from a Unicode data file to extract the file name and version information.
-*
-* This function tries to extract file name and version information from a line that
-* typically appears at the beginning of Unicode data files. It handles various formats:
-* - "FileName-1.2.3.txt"
-* - "FileName-1.2.3"
-* - "FileName.txt"
-*
-* The function also properly handles comment markers at the beginning of the line.
-*
-* @param {string} line - The line to parse, typically the first line of a Unicode data file
-* @returns {ParsedFileName | undefined} An object containing the file name and version if
-*                                      successfully parsed, or undefined if parsing fails
-*
-* @example
-* ```ts
-* parseFileNameLine("# UnicodeData-14.0.0.txt");
-* // Returns { fileName: "UnicodeData", version: "14.0.0" }
-*
-* parseFileNameLine("# ArabicShaping.txt");
-* // Returns { fileName: "ArabicShaping", version: undefined }
-* ```
-*/
-function parseFileNameLine(line) {
-	if (!line) return;
-	line = line.split("\n")[0].trim();
-	if (!isCommentLine(line)) return;
-	line = line.trim().replace(/^#\s*/, "");
-	if (line === "") return;
-	let match = line.match(/^(.*?)(?:-([0-9.]+))?\.txt$/);
-	if (match == null) {
-		match = line.match(/^(.*?)(?:-([0-9.]+))?$/);
-		/* v8 ignore next 3 */
-		if (match == null) return;
-	}
-	const [_, fileName, version] = match;
-	if (!fileName || fileName.trim() === "") return;
-	return {
-		fileName,
-		version
-	};
-}
-/**
-* Determines if a line represents a property definition in Unicode data files.
-*
-* In Unicode data files, properties are typically defined in comment lines that
-* start with "# Property:" followed by the property name.
-*
-* @param {string} line - The line to check
-* @returns {boolean} True if the line is a property definition, false otherwise
-*
-* @example
-* ```ts
-* isPropertyLine("# Property: Age"); // true
-* isPropertyLine("# Some other comment"); // false
-* isPropertyLine(""); // false
-* ```
-*/
-function isPropertyLine(line) {
-	if (!line) return false;
-	if (!isCommentLine(line)) return false;
-	const val = getPropertyValue(line);
-	return val !== void 0 && val.trim() !== "";
-}
-/**
-* Extracts the property value from a property definition line in Unicode data files.
-*
-* This function parses a line that follows the format '# Property: [PropertyValue]'
-* and returns the PropertyValue part. It is used internally by isPropertyLine
-* to parse property definitions in Unicode data files.
-*
-* @param {string} line - The line to extract the property value from
-* @returns {string | undefined} The extracted property value, or undefined if
-*                              the line is not a valid property definition
-*
-* @example
-* ```ts
-* getPropertyValue("# Property: Age"); // returns "Age"
-* getPropertyValue("# Property: "); // returns undefined
-* getPropertyValue("# Not a property line"); // returns undefined
-* ```
-*/
-function getPropertyValue(line) {
-	const trimmedComment = trimCommentLine(line).trim();
-	if (trimmedComment === "") return;
-	if (!trimmedComment.startsWith("Property:")) return;
-	return trimmedComment.slice(9).trim();
-}
-
-//#endregion
-export { trimCommentLine as _, isBoundaryLine as a, isEOFMarker as c, isHashBoundary as d, isLineWithData as f, parseMissingAnnotation as g, parseFileNameLine as h, inferVersion as i, isEmptyLine as l, isPropertyLine as m, getPropertyValue as n, isCommentLine as o, isMissingAnnotation as p, inferFileName as r, isDashBoundary as s, getBoundaryLineStyle as t, isEqualsBoundary as u };