@commentray/core 0.0.1 → 0.0.4

package/dist/source-markers.js

@@ -0,0 +1,241 @@
+import { assertValidMarkerId, MARKER_ID_BODY } from "./marker-ids.js";
+/**
+ * Source delimiters for block anchors:
+ *
+ * 1. **Region convention** — where editors commonly fold `//#region` /
+ *    `//#endregion`, `#region` / `#endregion`, `#pragma region`, etc. (aligned
+ *    with [Region Marker](https://marketplace.visualstudio.com/items?itemName=txava.region-marker)),
+ *    Commentray uses the region **name** `commentray:<id>`.
+ *
+ * 2. **Generic comments** — for languages without a shared region idiom, we
+ *    use ordinary line or block comments and our own `commentray:start id=<id>` /
+ *    `commentray:end id=<id>` tokens (still parsed by {@link parseCommentrayRegionBoundary}).
+ *
+ * Legacy pairs that only use (2) remain valid everywhere.
+ */
+const COMMENTRAY_TAG = (id) => `commentray:${id.trim().toLowerCase()}`;
+/** `//#region commentray:<id>` — JS/TS ecosystem & CSS preprocessors that use `//`. */
+const SLASH_REGION_LANGUAGES = new Set([
+    "javascript",
+    "javascriptreact",
+    "typescript",
+    "typescriptreact",
+    "js",
+    "jsx",
+    "tsx",
+    "mjs",
+    "cjs",
+    "vue",
+    "svelte",
+    "astro",
+    "scss",
+    "less",
+    "stylus",
+]);
+/** `#region commentray:<id>` — same shape as Region Marker for these ids. */
+const HASH_REGION_LANGUAGES = new Set([
+    "ruby",
+    "csharp",
+    "coffeescript",
+    "powershell",
+    "perl",
+    "raku",
+    "crystal",
+]);
+const PRAGMA_REGION = new Set(["c", "cpp", "cuda-cpp", "objective-c", "objective-cpp"]);
+const VB_REGION = new Set(["vb"]);
+const LUA_REGION = new Set(["lua"]);
+const HTML_FAMILY = new Set(["html", "xml", "handlebars", "vue-html"]);
+const PYTHONIC = new Set(["python", "jupyter"]);
+/** `# …` line comments for generic markers (no `#region` folding convention). */
+const GENERIC_HASH_LANGUAGES = new Set([
+    "dockerfile",
+    "makefile",
+    "cmake",
+    "yaml",
+    "yml",
+    "toml",
+    "ini",
+    "properties",
+    "git-commit",
+    "sql",
+    "r",
+    "shellscript",
+    "bash",
+    "sh",
+    "zsh",
+    "fish",
+]);
+function regionConvention(languageId) {
+    const id = languageId.toLowerCase();
+    if (id === "css")
+        return "generic-block-css";
+    if (PYTHONIC.has(id))
+        return "python";
+    if (PRAGMA_REGION.has(id))
+        return "pragma";
+    if (VB_REGION.has(id))
+        return "vb";
+    if (HTML_FAMILY.has(id))
+        return "html";
+    if (LUA_REGION.has(id))
+        return "lua";
+    if (HASH_REGION_LANGUAGES.has(id))
+        return "hash-region";
+    if (SLASH_REGION_LANGUAGES.has(id))
+        return "slash-region";
+    if (GENERIC_HASH_LANGUAGES.has(id))
+        return "generic-hash";
+    return "generic-line";
+}
+/**
+ * Line comment leader for **generic** `commentray:start` / `end` markers
+ * (`// …`, `# …`, etc.). Not used for `#region` family languages.
+ */
+export function lineCommentLeaderForLanguage(languageId) {
+    const id = languageId.toLowerCase();
+    if (GENERIC_HASH_LANGUAGES.has(id))
+        return "# ";
+    if (id === "lua")
+        return "-- ";
+    if (id === "vb")
+        return "' ";
+    return "// ";
+}
+/**
+ * Insertion fragments for wrapping the selection (apply **end** first, then
+ * **start**, so stable offsets). Pass the same indentation string Region Marker
+ * uses (leading whitespace of the first selected line).
+ */
+export function commentrayRegionInsertions(languageId, markerId, indent = "") {
+    const id = assertValidMarkerId(markerId);
+    const tag = COMMENTRAY_TAG(id);
+    const ind = indent;
+    const conv = regionConvention(languageId);
+    switch (conv) {
+        case "slash-region":
+            return {
+                start: `${ind}//#region ${tag}\n`,
+                end: `\n${ind}//#endregion ${tag}`,
+            };
+        case "hash-region":
+            return {
+                start: `${ind}#region ${tag}\n`,
+                end: `\n${ind}#endregion ${tag}`,
+            };
+        case "pragma":
+            return {
+                start: `${ind}#pragma region ${tag}\n`,
+                end: `\n${ind}#pragma endregion ${tag}`,
+            };
+        case "vb":
+            return {
+                start: `${ind}#Region ${tag}\n`,
+                end: `\n${ind}#End Region ${tag}`,
+            };
+        case "html":
+            return {
+                start: `${ind}<!-- #region ${tag} -->\n`,
+                end: `\n${ind}<!-- #endregion ${tag} -->`,
+            };
+        case "python":
+            return {
+                start: `${ind}# region ${tag}\n`,
+                end: `\n${ind}# endregion ${tag}`,
+            };
+        case "lua":
+            return {
+                start: `${ind}--#region ${tag}\n`,
+                end: `\n${ind}--#endregion ${tag}`,
+            };
+        case "generic-block-css":
+            return {
+                start: `${ind}/* commentray:start id=${id} */\n`,
+                end: `\n${ind}/* commentray:end id=${id} */`,
+            };
+        case "generic-hash":
+        case "generic-line": {
+            const leader = lineCommentLeaderForLanguage(languageId);
+            return {
+                start: `${ind}${leader}commentray:start id=${id}\n`,
+                end: `\n${ind}${leader}commentray:end id=${id}`,
+            };
+        }
+    }
+}
+/** Detect a Commentray region, generic marker, or legacy marker line; id is lower-case. */
+export function parseCommentrayRegionBoundary(line) {
+    const probe = line.trim();
+    const mid = MARKER_ID_BODY;
+    const startPatterns = [
+        new RegExp(`^//#region\\s+commentray:(${mid})\\s*$`, "i"),
+        new RegExp(`^#region\\s+commentray:(${mid})\\s*$`, "i"),
+        new RegExp(`^#pragma\\s+region\\s+commentray:(${mid})\\s*$`, "i"),
+        new RegExp(`^#Region\\s+commentray:(${mid})\\s*$`, "i"),
+        new RegExp(`^#\\s*region\\s+commentray:(${mid})\\s*$`, "i"),
+        new RegExp(`^<!--\\s*#region\\s+commentray:(${mid})\\s*-->\\s*$`, "i"),
+        new RegExp(`^--#region\\s+commentray:(${mid})\\s*$`, "i"),
+        new RegExp(`^/\\*\\s*commentray:start\\s+id=(${mid})\\s*\\*/\\s*$`, "i"),
+        new RegExp(`commentray:start\\s+id=(${mid})\\b`, "i"),
+    ];
+    const endPatterns = [
+        new RegExp(`^//#endregion\\s+commentray:(${mid})\\s*$`, "i"),
+        new RegExp(`^#endregion\\s+commentray:(${mid})\\s*$`, "i"),
+        new RegExp(`^#pragma\\s+endregion\\s+commentray:(${mid})\\s*$`, "i"),
+        new RegExp(`^#End\\s+Region\\s+commentray:(${mid})\\s*$`, "i"),
+        new RegExp(`^#\\s*endregion\\s+commentray:(${mid})\\s*$`, "i"),
+        new RegExp(`^<!--\\s*#endregion\\s+commentray:(${mid})\\s*-->\\s*$`, "i"),
+        new RegExp(`^--#endregion\\s+commentray:(${mid})\\s*$`, "i"),
+        new RegExp(`^/\\*\\s*commentray:end\\s+id=(${mid})\\s*\\*/\\s*$`, "i"),
+        new RegExp(`commentray:end\\s+id=(${mid})\\b`, "i"),
+    ];
+    for (const re of startPatterns) {
+        const m = re.exec(probe);
+        if (m) {
+            try {
+                return { kind: "start", id: assertValidMarkerId(m[1]) };
+            }
+            catch {
+                continue;
+            }
+        }
+    }
+    for (const re of endPatterns) {
+        const m = re.exec(probe);
+        if (m) {
+            try {
+                return { kind: "end", id: assertValidMarkerId(m[1]) };
+            }
+            catch {
+                continue;
+            }
+        }
+    }
+    return null;
+}
+/**
+ * 1-based inclusive source lines **between** paired region / generic / legacy marker lines.
+ */
+export function sourceLineRangeForMarkerId(sourceText, markerId) {
+    const id = assertValidMarkerId(markerId);
+    const lines = sourceText.split("\n");
+    let startIdx = -1;
+    let endIdx = -1;
+    for (let i = 0; i < lines.length; i++) {
+        const hit = parseCommentrayRegionBoundary(lines[i]);
+        if (hit?.id !== id)
+            continue;
+        if (hit.kind === "start" && startIdx < 0)
+            startIdx = i;
+        else if (hit.kind === "end" && startIdx >= 0 && endIdx < 0)
+            endIdx = i;
+    }
+    if (startIdx < 0 || endIdx < 0 || endIdx < startIdx + 2)
+        return null;
+    const start = startIdx + 2;
+    const end = endIdx;
+    if (end < start)
+        return null;
+    return { start, end };
+}
+//# sourceMappingURL=source-markers.js.map

package/dist/source-markers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-markers.js","sourceRoot":"","sources":["../src/source-markers.ts"],"names":[],"mappings":"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"}

package/dist/validate-project.d.ts

@@ -1,4 +1,4 @@
-import type { CommentrayIndex } from "./model.js";
+import { type CommentrayIndex } from "./model.js";
 export type ValidationIssue = {
     level: "error" | "warn";
     message: string;
@@ -7,5 +7,19 @@ export type ValidationResult = {
     issues: ValidationIssue[];
 };
 export declare function validateProject(repoRoot: string): Promise<ValidationResult>;
+/**
+ * Reads `index.json`, applies schema migration and snippet/fingerprint normalization,
+ * and persists when anything changed. Throws if the file is missing or not valid JSON.
+ */
+export declare function refreshIndexMigrationsOnDisk(repoRoot: string): Promise<{
+    index: CommentrayIndex;
+    changed: boolean;
+}>;
 export declare function readIndex(repoRoot: string): Promise<CommentrayIndex | null>;
+/**
+ * Write the metadata index to the default location under `repoRoot`, creating
+ * the `.commentray/metadata/` directory if missing. The file is written with
+ * two-space indentation and a trailing newline so diffs are easy to read.
+ */
+export declare function writeIndex(repoRoot: string, index: CommentrayIndex): Promise<void>;
 //# sourceMappingURL=validate-project.d.ts.map

package/dist/validate-project.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validate-project.d.ts","sourceRoot":"","sources":["../src/validate-project.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,MAAM,MAAM,eAAe,GAAG;IAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3E,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B,CAAC;AAEF,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA2CjF;AAED,wBAAsB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAUjF"}
+{"version":3,"file":"validate-project.d.ts","sourceRoot":"","sources":["../src/validate-project.ts"],"names":[],"mappings":"AAOA,OAAO,EAAoD,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAOpG,MAAM,MAAM,eAAe,GAAG;IAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3E,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B,CAAC;AAEF,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAiEjF;AAiBD;;;GAGG;AACH,wBAAsB,4BAA4B,CAChD,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;IAAE,KAAK,EAAE,eAAe,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAqBvD;AAED,wBAAsB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CASjF;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAKxF"}

package/dist/validate-project.js

@@ -1,8 +1,13 @@
 import fs from "node:fs/promises";
 import path from "node:path";
 import { loadCommentrayConfig } from "./config.js";
+import { parseGithubRepoWebUrl } from "./github-url.js";
+import { normalizeCommentrayIndex } from "./index-normalize.js";
 import { assertValidIndex } from "./metadata.js";
+import { migrateIndex } from "./migrate.js";
+import { coerceIndexSchemaVersion, CURRENT_SCHEMA_VERSION } from "./model.js";
 import { defaultMetadataIndexPath } from "./paths.js";
+import { validateIndexMarkerSemantics, validateMarkerBoundariesInSource, } from "./marker-validation.js";
 export async function validateProject(repoRoot) {
     const issues = [];
     let config;
@@ -29,30 +34,87 @@ export async function validateProject(repoRoot) {
             });
         }
     }
-    const indexPath = path.join(repoRoot, defaultMetadataIndexPath());
+    let index = null;
     try {
-        const raw = await fs.readFile(indexPath, "utf8");
-        assertValidIndex(JSON.parse(raw));
+        index = await readIndex(repoRoot);
+        if (index === null) {
+            issues.push({ level: "warn", message: `No metadata index at ${defaultMetadataIndexPath()}` });
+        }
     }
     catch (err) {
-        const code = err.code;
-        if (code === "ENOENT") {
-            issues.push({ level: "warn", message: `No metadata index at ${defaultMetadataIndexPath()}` });
+        issues.push({
+            level: "error",
+            message: `Invalid metadata index: ${err instanceof Error ? err.message : String(err)}`,
+        });
+    }
+    if (index) {
+        for (const issue of validateIndexMarkerSemantics(index)) {
+            issues.push({ level: issue.level, message: issue.message });
         }
-        else {
-            issues.push({
-                level: "error",
-                message: `Invalid metadata index: ${err instanceof Error ? err.message : String(err)}`,
-            });
+        const seenSources = new Set();
+        for (const entry of Object.values(index.byCommentrayPath)) {
+            if (seenSources.has(entry.sourcePath))
+                continue;
+            seenSources.add(entry.sourcePath);
+            const abs = path.join(repoRoot, ...entry.sourcePath.split("/"));
+            try {
+                const text = await fs.readFile(abs, "utf8");
+                for (const issue of validateMarkerBoundariesInSource(text, entry.sourcePath)) {
+                    issues.push({ level: issue.level, message: issue.message });
+                }
+            }
+            catch {
+                issues.push({
+                    level: "warn",
+                    message: `Could not read "${entry.sourcePath}" to validate Commentray source markers.`,
+                });
+            }
         }
     }
+    pushRelativeGithubLinkConfigWarnings(config, issues);
     return { issues };
 }
-export async function readIndex(repoRoot) {
+function pushRelativeGithubLinkConfigWarnings(config, issues) {
+    if (!config.render.relativeGithubBlobLinks)
+        return;
+    const gh = config.staticSite.githubUrl;
+    if (gh && parseGithubRepoWebUrl(gh))
+        return;
+    issues.push({
+        level: "warn",
+        message: "render.relative_github_blob_links is true but static_site.github_url is missing or " +
+            "not a repository home URL (expected https://github.com/owner/repo). Link rewriting is skipped at build time.",
+    });
+}
+/**
+ * Reads `index.json`, applies schema migration and snippet/fingerprint normalization,
+ * and persists when anything changed. Throws if the file is missing or not valid JSON.
+ */
+export async function refreshIndexMigrationsOnDisk(repoRoot) {
     const indexPath = path.join(repoRoot, defaultMetadataIndexPath());
+    const raw = await fs.readFile(indexPath, "utf8");
+    const parsed = JSON.parse(raw);
+    const priorSchema = typeof parsed === "object" && parsed !== null
+        ? coerceIndexSchemaVersion(parsed.schemaVersion)
+        : null;
+    if (typeof priorSchema === "number" && priorSchema > CURRENT_SCHEMA_VERSION) {
+        const metaDir = path.dirname(indexPath);
+        const backupName = `index.schema-${String(priorSchema)}-backup-${String(Date.now())}.json`;
+        await fs.writeFile(path.join(metaDir, backupName), raw, "utf8");
+    }
+    const { index: migrated, changed: schemaChanged } = migrateIndex(parsed);
+    const { index: normalized, changed: snippetChanged } = normalizeCommentrayIndex(migrated);
+    const index = assertValidIndex(normalized);
+    const changed = schemaChanged || snippetChanged;
+    if (changed) {
+        await writeIndex(repoRoot, index);
+    }
+    return { index, changed };
+}
+export async function readIndex(repoRoot) {
     try {
-        const raw = await fs.readFile(indexPath, "utf8");
-        return assertValidIndex(JSON.parse(raw));
+        const { index } = await refreshIndexMigrationsOnDisk(repoRoot);
+        return index;
     }
     catch (err) {
         const code = err.code;
@@ -61,4 +123,15 @@ export async function readIndex(repoRoot) {
         throw err;
     }
 }
+/**
+ * Write the metadata index to the default location under `repoRoot`, creating
+ * the `.commentray/metadata/` directory if missing. The file is written with
+ * two-space indentation and a trailing newline so diffs are easy to read.
+ */
+export async function writeIndex(repoRoot, index) {
+    const indexPath = path.join(repoRoot, defaultMetadataIndexPath());
+    await fs.mkdir(path.dirname(indexPath), { recursive: true });
+    const serialized = `${JSON.stringify(index, null, 2)}\n`;
+    await fs.writeFile(indexPath, serialized, "utf8");
+}
 //# sourceMappingURL=validate-project.js.map

package/dist/validate-project.js.map

@@ -1 +1 @@
-{"version":3,"file":"validate-project.js","sourceRoot":"","sources":["../src/validate-project.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"validate-project.js","sourceRoot":"","sources":["../src/validate-project.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@commentray/core",
-  "version": "0.0.1",
+  "version": "0.0.4",
   "publishConfig": {
     "access": "public"
   },
@@ -14,6 +14,10 @@
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
+    },
+    "./block-scroll-pickers": {
+      "types": "./dist/block-scroll-pickers.d.ts",
+      "import": "./dist/block-scroll-pickers.js"
     }
   },
   "files": [
@@ -28,6 +32,6 @@
     "@iarna/toml": "^2.2.5"
   },
   "devDependencies": {
-    "@types/node": "^22.14.1"
+    "@types/node": "^25.6.0"
   }
 }