@markuplint/shared 5.0.0-alpha.2 → 5.0.0-dev.5

package/CHANGELOG.md

@@ -3,6 +3,12 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [5.0.0-alpha.3](https://github.com/markuplint/markuplint/compare/v5.0.0-alpha.2...v5.0.0-alpha.3) (2026-02-26)
+
+### Features
+
+- **shared:** add getPosition utility for offset-to-line/column conversion ([1cfab8b](https://github.com/markuplint/markuplint/commit/1cfab8b69614e9f9e8da87cfce5a96b2865b9a0e))
+
 # [5.0.0-alpha.2](https://github.com/markuplint/markuplint/compare/v5.0.0-alpha.1...v5.0.0-alpha.2) (2026-02-23)
 
 **Note:** Version bump only for package @markuplint/shared

package/lib/functions.d.ts

@@ -86,4 +86,15 @@ export declare function branchesToPatterns<T>(branches: ReadonlyArray<Nullable<T
  * @param regexpLikeString - The regular expression pattern to parse.
  * @returns - The parsed regular expression or null if the pattern is invalid.
  */
+/**
+ * Computes the line and column of a position within a code fragment.
+ *
+ * @param rawCodeFragment - The full raw source text
+ * @param startOffset - The zero-based byte offset to compute the position of
+ * @returns An object containing one-based `line` and `column`
+ */
+export declare function getPosition(rawCodeFragment: string, startOffset: number): {
+    readonly line: number;
+    readonly column: number;
+};
 export declare function regexParser(regexpLikeString: string): RegExp | null;

package/lib/functions.js

@@ -120,6 +120,19 @@ export function branchesToPatterns(branches) {
  * @param regexpLikeString - The regular expression pattern to parse.
  * @returns - The parsed regular expression or null if the pattern is invalid.
  */
+/**
+ * Computes the line and column of a position within a code fragment.
+ *
+ * @param rawCodeFragment - The full raw source text
+ * @param startOffset - The zero-based byte offset to compute the position of
+ * @returns An object containing one-based `line` and `column`
+ */
+export function getPosition(rawCodeFragment, startOffset) {
+    const lines = rawCodeFragment.slice(0, startOffset).split('\n');
+    const line = lines.length;
+    const column = (lines.at(-1) ?? '').length + 1;
+    return { line, column };
+}
 export function regexParser(regexpLikeString) {
     if (!regexpLikeString.startsWith('/')) {
         // Early return if the string does not start with a slash.

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@markuplint/shared",
-	"version": "5.0.0-alpha.2",
+	"version": "5.0.0-dev.5+e96392f56",
 	"description": "Shared functions for Markuplint",
 	"repository": "git@github.com:markuplint/markuplint.git",
 	"author": "Yusuke Hirao <yusukehirao@me.com>",
@@ -29,5 +29,5 @@
 	"dependencies": {
 		"html-entities": "2.6.0"
 	},
-	"gitHead": "31ccf1e81443ea3f93597d287595211f1823ddcf"
+	"gitHead": "e96392f56e4bc8165ba59622b41c822703a96372"
 }