@lepid-labs/weft-core 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Wil Asche
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/anchors/__tests__/markdown.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=markdown.test.d.ts.map

package/dist/anchors/__tests__/markdown.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.test.d.ts","sourceRoot":"","sources":["../../../src/anchors/__tests__/markdown.test.ts"],"names":[],"mappings":""}

package/dist/anchors/__tests__/markdown.test.js

@@ -0,0 +1,130 @@
+import { describe, expect, it } from "vitest";
+import { extractMarkdownAnchors, extractMarkdownDescription, extractMarkdownTitle, } from "../markdown.js";
+/**
+ * Build CRLF content explicitly rather than reading a fixture — a fixture's line
+ * endings depend on how the repo was checked out, so it would not reliably
+ * exercise this path.
+ */
+function crlf(content) {
+    return content.replace(/\n/g, "\r\n");
+}
+/** Slugs alone, for the cases that are only about slugification. */
+function slugs(content) {
+    return extractMarkdownAnchors(content).map((a) => a.slug);
+}
+describe("extractMarkdownAnchors", () => {
+    it("extracts heading slugs", () => {
+        const content = "# Title\n\n## Getting Started\n\n### API Reference\n";
+        expect(slugs(content)).toEqual(["#title", "#getting-started", "#api-reference"]);
+    });
+    it("handles duplicate headings with suffix", () => {
+        const content = "## Overview\n\n## Details\n\n## Overview\n";
+        expect(slugs(content)).toEqual(["#overview", "#details", "#overview-1"]);
+    });
+    it("strips special characters", () => {
+        expect(slugs("## What is `weft`?\n")).toEqual(["#what-is-weft"]);
+    });
+    it("returns empty array for no headings", () => {
+        expect(extractMarkdownAnchors("Just a paragraph.\n")).toEqual([]);
+    });
+    it("extracts headings from CRLF content", () => {
+        const content = crlf("# Title\n\n## Getting Started\n\n### API Reference\n");
+        expect(slugs(content)).toEqual(["#title", "#getting-started", "#api-reference"]);
+    });
+    it("slugs CRLF headings identically to LF", () => {
+        const content = "## What is `weft`?\n\n## Overview\n\n## Overview\n";
+        expect(extractMarkdownAnchors(crlf(content))).toEqual(extractMarkdownAnchors(content));
+    });
+    it("carries the line, level and raw text of each heading", () => {
+        const content = "# Title\n\nprose\n\n### Data Flow\n";
+        expect(extractMarkdownAnchors(content)).toEqual([
+            { slug: "#title", text: "Title", line: 1, level: 1 },
+            { slug: "#data-flow", text: "Data Flow", line: 5, level: 3 },
+        ]);
+    });
+    it("numbers lines from 1, and counts CRLF lines the same as LF", () => {
+        const content = "intro\n\n## Later\n";
+        expect(extractMarkdownAnchors(content)[0].line).toBe(3);
+        expect(extractMarkdownAnchors(crlf(content))[0].line).toBe(3);
+    });
+    it("keeps the heading's text as rendered, before slugification", () => {
+        const anchors = extractMarkdownAnchors("## What is `weft`?\n");
+        // The text a reader sees, not the source line — which is also what the
+        // slug is derived from, so the two cannot drift apart.
+        expect(anchors[0].text).toBe("What is weft?");
+        expect(anchors[0].slug).toBe("#what-is-weft");
+    });
+    it("resolves inline markup in the text rather than carrying its syntax", () => {
+        const anchors = extractMarkdownAnchors("## See [the docs](guide.md) first\n");
+        expect(anchors[0].text).toBe("See the docs first");
+        expect(anchors[0].slug).toBe("#see-the-docs-first");
+    });
+    it("finds setext headings, which the renderer also gives ids", () => {
+        const anchors = extractMarkdownAnchors("Setext Title\n============\n\nBody.\n");
+        expect(anchors).toEqual([{ slug: "#setext-title", text: "Setext Title", line: 1, level: 1 }]);
+    });
+});
+// Slugs are authored against how the document renders on GitHub (DD-2), so
+// github-slugger's output is the correct answer, not an approximation of it.
+describe("extractMarkdownAnchors (GitHub slug parity)", () => {
+    it("gives each space its own hyphen rather than collapsing runs", () => {
+        expect(slugs("## Layout — Presenting Mode\n")).toEqual(["#layout--presenting-mode"]);
+        expect(slugs("## React + Vite\n")).toEqual(["#react--vite"]);
+        expect(slugs("## Fastify / Express\n")).toEqual(["#fastify--express"]);
+    });
+    it("keeps accented letters instead of stripping them", () => {
+        expect(slugs("## Café Setup\n")).toEqual(["#café-setup"]);
+        expect(slugs("## Naïve Approach\n")).toEqual(["#naïve-approach"]);
+    });
+    it("keeps non-Latin headings rather than slugging them to nothing", () => {
+        expect(slugs("## 日本語の見出し\n")).toEqual(["#日本語の見出し"]);
+    });
+    it("does not collapse a heading of only punctuation into a colliding empty slug", () => {
+        // Previously every such heading became "#", then "#-1", "#-2".
+        const result = slugs("## 日本語\n\n## 中文\n");
+        expect(new Set(result).size).toBe(2);
+    });
+});
+describe("extractMarkdownAnchors (fenced code)", () => {
+    it("ignores a # comment inside a fenced block", () => {
+        const content = "# Usage\n\n```sh\n# Install globally\nnpm i -g weft\n```\n";
+        expect(slugs(content)).toEqual(["#usage"]);
+    });
+    it("resumes finding headings after the fence closes", () => {
+        const content = "```\n# not a heading\n```\n\n## Real Heading\n";
+        expect(slugs(content)).toEqual(["#real-heading"]);
+    });
+    it("handles tilde fences and a longer closing marker", () => {
+        const content = "~~~\n# nope\n~~~\n\n## Yes\n";
+        expect(slugs(content)).toEqual(["#yes"]);
+    });
+    it("does not let a tilde fence close a backtick fence", () => {
+        const content = "```\n~~~\n# still code\n```\n\n## After\n";
+        expect(slugs(content)).toEqual(["#after"]);
+    });
+});
+describe("extractMarkdownTitle", () => {
+    it("extracts the first H1", () => {
+        expect(extractMarkdownTitle("# My Doc\n\n## Section")).toBe("My Doc");
+    });
+    it("returns undefined when no H1", () => {
+        expect(extractMarkdownTitle("## Not a title\n")).toBeUndefined();
+    });
+    it("extracts the H1 from CRLF content", () => {
+        expect(extractMarkdownTitle(crlf("# My Doc\n\n## Section\n"))).toBe("My Doc");
+    });
+    it("does not leave a trailing carriage return on the title", () => {
+        expect(extractMarkdownTitle(crlf("# My Doc\n"))).not.toMatch(/\r/);
+    });
+});
+describe("extractMarkdownDescription", () => {
+    it("extracts the first prose paragraph", () => {
+        const content = "# Title\n\nThis is the opening paragraph of the document.\n";
+        expect(extractMarkdownDescription(content)).toBe("This is the opening paragraph of the document.");
+    });
+    it("extracts the same paragraph from CRLF content", () => {
+        const content = "# Title\n\nThis is the opening paragraph of the document.\n";
+        expect(extractMarkdownDescription(crlf(content))).toBe(extractMarkdownDescription(content));
+    });
+});
+//# sourceMappingURL=markdown.test.js.map

package/dist/anchors/__tests__/markdown.test.js.map

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

package/dist/anchors/__tests__/openapi.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=openapi.test.d.ts.map

package/dist/anchors/__tests__/openapi.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi.test.d.ts","sourceRoot":"","sources":["../../../src/anchors/__tests__/openapi.test.ts"],"names":[],"mappings":""}

package/dist/anchors/__tests__/openapi.test.js

@@ -0,0 +1,115 @@
+import { describe, expect, it } from "vitest";
+import { extractOpenApiAnchors, extractOpenApiTitle, openApiOperationAnchor, openApiSchemaAnchor, } from "../openapi.js";
+describe("extractOpenApiAnchors", () => {
+    it("extracts operation IDs", () => {
+        const spec = `
+openapi: "3.0.0"
+info:
+  title: Test API
+paths:
+  /users:
+    get:
+      operationId: listUsers
+    post:
+      operationId: createUser
+`;
+        expect(extractOpenApiAnchors(spec)).toEqual([
+            { slug: "#listUsers", text: "listUsers" },
+            { slug: "#createUser", text: "createUser" },
+        ]);
+    });
+    it("extracts schema names from components", () => {
+        const spec = `
+openapi: "3.0.0"
+info:
+  title: Test API
+components:
+  schemas:
+    User:
+      type: object
+    Order:
+      type: object
+`;
+        expect(extractOpenApiAnchors(spec)).toEqual([
+            { slug: "#/components/schemas/User", text: "User" },
+            { slug: "#/components/schemas/Order", text: "Order" },
+        ]);
+    });
+    it("carries no line or level, having no source position", () => {
+        const spec = `
+openapi: "3.0.0"
+info:
+  title: Test API
+paths:
+  /users:
+    get:
+      operationId: listUsers
+`;
+        const [anchor] = extractOpenApiAnchors(spec);
+        expect(anchor.line).toBeUndefined();
+        expect(anchor.level).toBeUndefined();
+    });
+    it("falls back to path encoding when no operationId", () => {
+        const spec = `
+openapi: "3.0.0"
+info:
+  title: Test API
+paths:
+  /users/{id}:
+    get:
+      summary: Get user
+`;
+        const anchors = extractOpenApiAnchors(spec);
+        expect(anchors[0].slug).toMatch(/^#\/paths/);
+        expect(anchors[0].text).toBe("GET /users/{id}");
+    });
+});
+// The renderer stamps these same ids onto the elements it draws, by calling
+// these same functions. If it computed them separately the two would agree only
+// by coincidence, and an anchor would stop resolving the moment either changed.
+describe("anchor ids shared with the renderer", () => {
+    it("uses the operation id when there is one", () => {
+        expect(openApiOperationAnchor("/users", "get", "listUsers")).toBe("listUsers");
+    });
+    it("falls back to an escaped path and method", () => {
+        expect(openApiOperationAnchor("/users/{id}", "get")).toBe("/paths~1users~1{id}/get");
+    });
+    it("builds a schema id from the name", () => {
+        expect(openApiSchemaAnchor("User")).toBe("/components/schemas/User");
+    });
+    it("produces exactly the anchors the extractor records, minus the leading #", () => {
+        const spec = `
+openapi: "3.0.0"
+info:
+  title: Test API
+paths:
+  /users:
+    get:
+      operationId: listUsers
+  /users/{id}:
+    delete:
+      summary: No operation id here
+components:
+  schemas:
+    User:
+      type: object
+`;
+        const extracted = extractOpenApiAnchors(spec).map((a) => a.slug);
+        expect(extracted).toEqual([
+            `#${openApiOperationAnchor("/users", "get", "listUsers")}`,
+            `#${openApiOperationAnchor("/users/{id}", "delete")}`,
+            `#${openApiSchemaAnchor("User")}`,
+        ]);
+    });
+});
+describe("extractOpenApiTitle", () => {
+    it("extracts spec title", () => {
+        const spec = `
+openapi: "3.0.0"
+info:
+  title: My Cool API
+`;
+        expect(extractOpenApiTitle(spec)).toBe("My Cool API");
+    });
+});
+//# sourceMappingURL=openapi.test.js.map

package/dist/anchors/__tests__/openapi.test.js.map

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

package/dist/anchors/index.d.ts

@@ -0,0 +1,35 @@
+import type { Anchor, WeftConfig } from "../types.js";
+export type DocType = "markdown" | "openapi";
+/** Built-in extension-to-doc-type mapping. Answers "how do I parse this if handed it" — see `INDEXED_EXTENSIONS` below for "which files do I go looking for," a narrower, separate question. */
+export declare const EXTENSION_MAP: Record<string, DocType>;
+/**
+ * Merge the built-in map with a project's `extensions` config. Takes the
+ * config's extensions as plain data rather than a `WeftConfig`, so this module
+ * stays free of any config-loading dependency; callers resolve `config.extensions`
+ * themselves.
+ */
+export declare function resolveExtensionMap(extensions?: Record<string, DocType>): Record<string, DocType>;
+export declare function getDocType(filePath: string, extensionMap?: Record<string, DocType>): DocType | undefined;
+/**
+ * File extensions the indexer turns into nodes.
+ *
+ * Shared with validation and freshness so none of them can drift: a check
+ * that an edge resolves has to know which link targets were ever eligible to
+ * become nodes, and the freshness baseline has to glob the same set the
+ * indexer does. Note this is narrower than `getDocType`, which also maps
+ * `.json`. A project can extend this set at runtime via `extensions` (see
+ * `resolveIndexedExtensions`), but the defaults here are deliberate and are
+ * never derived from `EXTENSION_MAP` — indexing `.json` by default, say,
+ * would turn today's correctly-ignored links to a missing `./schema.json`
+ * into `edge-target-missing` errors.
+ */
+export declare const INDEXED_EXTENSIONS: readonly ["md", "markdown", "yaml", "yml"];
+/** The extensions (no leading dot) the indexer scans for: the defaults plus anything `config.extensions` added. */
+export declare function resolveIndexedExtensions(config: WeftConfig): string[];
+/** True when a node id names a file the indexer would have turned into a node. */
+export declare function isIndexedPath(path: string, indexedExtensions?: readonly string[]): boolean;
+export declare function extractAnchors(content: string, docType: DocType): Anchor[];
+export declare function extractTitle(content: string, docType: DocType): string | undefined;
+export { extractMarkdownAnchors, extractMarkdownTitle } from "./markdown.js";
+export { extractOpenApiAnchors, extractOpenApiTitle } from "./openapi.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/anchors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/anchors/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAItD,MAAM,MAAM,OAAO,GAAG,UAAU,GAAG,SAAS,CAAC;AAE7C,gMAAgM;AAChM,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAMjD,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEjG;AAED,wBAAgB,UAAU,CACzB,QAAQ,EAAE,MAAM,EAChB,YAAY,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAiB,GACnD,OAAO,GAAG,SAAS,CAGrB;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,kBAAkB,4CAA6C,CAAC;AAE7E,mHAAmH;AACnH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,EAAE,CAKrE;AAED,kFAAkF;AAClF,wBAAgB,aAAa,CAC5B,IAAI,EAAE,MAAM,EACZ,iBAAiB,GAAE,SAAS,MAAM,EAAuB,GACvD,OAAO,CAGT;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,EAAE,CAO1E;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAOlF;AAED,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAC7E,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC"}

package/dist/anchors/index.js

@@ -0,0 +1,68 @@
+import { extractMarkdownAnchors, extractMarkdownTitle } from "./markdown.js";
+import { extractOpenApiAnchors, extractOpenApiTitle } from "./openapi.js";
+/** Built-in extension-to-doc-type mapping. Answers "how do I parse this if handed it" — see `INDEXED_EXTENSIONS` below for "which files do I go looking for," a narrower, separate question. */
+export const EXTENSION_MAP = {
+    ".md": "markdown",
+    ".markdown": "markdown",
+    ".yaml": "openapi",
+    ".yml": "openapi",
+    ".json": "openapi",
+};
+/**
+ * Merge the built-in map with a project's `extensions` config. Takes the
+ * config's extensions as plain data rather than a `WeftConfig`, so this module
+ * stays free of any config-loading dependency; callers resolve `config.extensions`
+ * themselves.
+ */
+export function resolveExtensionMap(extensions) {
+    return { ...EXTENSION_MAP, ...extensions };
+}
+export function getDocType(filePath, extensionMap = EXTENSION_MAP) {
+    const ext = filePath.slice(filePath.lastIndexOf(".")).toLowerCase();
+    return extensionMap[ext];
+}
+/**
+ * File extensions the indexer turns into nodes.
+ *
+ * Shared with validation and freshness so none of them can drift: a check
+ * that an edge resolves has to know which link targets were ever eligible to
+ * become nodes, and the freshness baseline has to glob the same set the
+ * indexer does. Note this is narrower than `getDocType`, which also maps
+ * `.json`. A project can extend this set at runtime via `extensions` (see
+ * `resolveIndexedExtensions`), but the defaults here are deliberate and are
+ * never derived from `EXTENSION_MAP` — indexing `.json` by default, say,
+ * would turn today's correctly-ignored links to a missing `./schema.json`
+ * into `edge-target-missing` errors.
+ */
+export const INDEXED_EXTENSIONS = ["md", "markdown", "yaml", "yml"];
+/** The extensions (no leading dot) the indexer scans for: the defaults plus anything `config.extensions` added. */
+export function resolveIndexedExtensions(config) {
+    const configured = config.extensions
+        ? Object.keys(config.extensions).map((ext) => ext.slice(1).toLowerCase())
+        : [];
+    return [...INDEXED_EXTENSIONS, ...configured];
+}
+/** True when a node id names a file the indexer would have turned into a node. */
+export function isIndexedPath(path, indexedExtensions = INDEXED_EXTENSIONS) {
+    const ext = path.slice(path.lastIndexOf(".") + 1).toLowerCase();
+    return indexedExtensions.includes(ext);
+}
+export function extractAnchors(content, docType) {
+    switch (docType) {
+        case "markdown":
+            return extractMarkdownAnchors(content);
+        case "openapi":
+            return extractOpenApiAnchors(content);
+    }
+}
+export function extractTitle(content, docType) {
+    switch (docType) {
+        case "markdown":
+            return extractMarkdownTitle(content);
+        case "openapi":
+            return extractOpenApiTitle(content);
+    }
+}
+export { extractMarkdownAnchors, extractMarkdownTitle } from "./markdown.js";
+export { extractOpenApiAnchors, extractOpenApiTitle } from "./openapi.js";
+//# sourceMappingURL=index.js.map

package/dist/anchors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/anchors/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAC7E,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAI1E,gMAAgM;AAChM,MAAM,CAAC,MAAM,aAAa,GAA4B;IACrD,KAAK,EAAE,UAAU;IACjB,WAAW,EAAE,UAAU;IACvB,OAAO,EAAE,SAAS;IAClB,MAAM,EAAE,SAAS;IACjB,OAAO,EAAE,SAAS;CAClB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,UAAoC;IACvE,OAAO,EAAE,GAAG,aAAa,EAAE,GAAG,UAAU,EAAE,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,UAAU,CACzB,QAAgB,EAChB,eAAwC,aAAa;IAErD,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IACpE,OAAO,YAAY,CAAC,GAAG,CAAC,CAAC;AAC1B,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,CAAU,CAAC;AAE7E,mHAAmH;AACnH,MAAM,UAAU,wBAAwB,CAAC,MAAkB;IAC1D,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU;QACnC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;QACzE,CAAC,CAAC,EAAE,CAAC;IACN,OAAO,CAAC,GAAG,kBAAkB,EAAE,GAAG,UAAU,CAAC,CAAC;AAC/C,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,aAAa,CAC5B,IAAY,EACZ,oBAAuC,kBAAkB;IAEzD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IAChE,OAAO,iBAAiB,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAe,EAAE,OAAgB;IAC/D,QAAQ,OAAO,EAAE,CAAC;QACjB,KAAK,UAAU;YACd,OAAO,sBAAsB,CAAC,OAAO,CAAC,CAAC;QACxC,KAAK,SAAS;YACb,OAAO,qBAAqB,CAAC,OAAO,CAAC,CAAC;IACxC,CAAC;AACF,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAe,EAAE,OAAgB;IAC7D,QAAQ,OAAO,EAAE,CAAC;QACjB,KAAK,UAAU;YACd,OAAO,oBAAoB,CAAC,OAAO,CAAC,CAAC;QACtC,KAAK,SAAS;YACb,OAAO,mBAAmB,CAAC,OAAO,CAAC,CAAC;IACtC,CAAC;AACF,CAAC;AAED,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAC7E,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC"}

package/dist/anchors/markdown.d.ts

@@ -0,0 +1,15 @@
+import type { Anchor } from "../types.js";
+/**
+ * Extract heading anchors from Markdown content.
+ *
+ * Slugs come from `github-slugger`, the implementation GitHub's own rendering
+ * uses, rather than an approximation of it: links are authored against how the
+ * document renders on GitHub (DD-2), so GitHub's slugs are the correct ones.
+ * The slugger also owns the `-1`, `-2` suffixes it appends to repeated slugs.
+ */
+export declare function extractMarkdownAnchors(content: string): Anchor[];
+/** Extract the first prose paragraph as a plain-text description. */
+export declare function extractMarkdownDescription(content: string): string | undefined;
+/** Extract the title (first H1) from Markdown content. */
+export declare function extractMarkdownTitle(content: string): string | undefined;
+//# sourceMappingURL=markdown.d.ts.map

package/dist/anchors/markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/anchors/markdown.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAa1C;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAwBhE;AAED,qEAAqE;AACrE,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAe9E;AAED,0DAA0D;AAC1D,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAMxE"}

package/dist/anchors/markdown.js

@@ -0,0 +1,71 @@
+import GithubSlugger from "github-slugger";
+import { toString as mdastToString } from "mdast-util-to-string";
+import remarkParse from "remark-parse";
+import { unified } from "unified";
+import { visit } from "unist-util-visit";
+/**
+ * Split content into lines, tolerating CRLF.
+ *
+ * A trailing `\r` would otherwise survive into every line: `.` does not match
+ * `\r` and `$` (no `m` flag) only matches at end of input, so the line patterns
+ * below silently fail on any file checked out with Windows line endings.
+ */
+function toLines(content) {
+    return content.split(/\r?\n/);
+}
+/**
+ * Extract heading anchors from Markdown content.
+ *
+ * Slugs come from `github-slugger`, the implementation GitHub's own rendering
+ * uses, rather than an approximation of it: links are authored against how the
+ * document renders on GitHub (DD-2), so GitHub's slugs are the correct ones.
+ * The slugger also owns the `-1`, `-2` suffixes it appends to repeated slugs.
+ */
+export function extractMarkdownAnchors(content) {
+    const tree = unified().use(remarkParse).parse(content);
+    const slugger = new GithubSlugger();
+    const anchors = [];
+    visit(tree, "heading", (node) => {
+        // Slug the heading's *rendered* text, not its source line. GitHub slugs
+        // what it rendered, so `## See [docs](x.md)` is `#see-docs` — slugging the
+        // raw line would produce `#see-docsxmd` and the id in the page would never
+        // match the anchor in the graph.
+        //
+        // Image alt text and raw HTML are excluded to match `hast-util-to-string`,
+        // which is what the renderer's slug plugin sees.
+        const text = mdastToString(node, { includeImageAlt: false, includeHtml: false });
+        anchors.push({
+            slug: `#${slugger.slug(text)}`,
+            text,
+            line: node.position?.start.line ?? 0,
+            level: node.depth,
+        });
+    });
+    return anchors;
+}
+/** Extract the first prose paragraph as a plain-text description. */
+export function extractMarkdownDescription(content) {
+    for (const line of toLines(content)) {
+        const trimmed = line.trim();
+        if (!trimmed ||
+            trimmed.startsWith("#") ||
+            trimmed.startsWith(">") ||
+            trimmed.startsWith("-") ||
+            trimmed.startsWith("|"))
+            continue;
+        const plain = trimmed.replace(/\[([^\]]+)\]\([^)]+\)/g, "$1").replace(/[*_`]/g, "");
+        if (plain.length > 20)
+            return plain.slice(0, 200);
+    }
+    return undefined;
+}
+/** Extract the title (first H1) from Markdown content. */
+export function extractMarkdownTitle(content) {
+    for (const line of toLines(content)) {
+        const match = line.match(/^#\s+(.+)$/);
+        if (match)
+            return match[1].trim();
+    }
+    return undefined;
+}
+//# sourceMappingURL=markdown.js.map

package/dist/anchors/markdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.js","sourceRoot":"","sources":["../../src/anchors/markdown.ts"],"names":[],"mappings":"AAAA,OAAO,aAAa,MAAM,gBAAgB,CAAC;AAE3C,OAAO,EAAE,QAAQ,IAAI,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,WAAW,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAGzC;;;;;;GAMG;AACH,SAAS,OAAO,CAAC,OAAe;IAC/B,OAAO,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;AAC/B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAe;IACrD,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACvD,MAAM,OAAO,GAAG,IAAI,aAAa,EAAE,CAAC;IACpC,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC,IAAa,EAAE,EAAE;QACxC,wEAAwE;QACxE,2EAA2E;QAC3E,2EAA2E;QAC3E,iCAAiC;QACjC,EAAE;QACF,2EAA2E;QAC3E,iDAAiD;QACjD,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,EAAE,EAAE,eAAe,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC;QAEjF,OAAO,CAAC,IAAI,CAAC;YACZ,IAAI,EAAE,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;YAC9B,IAAI;YACJ,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC;YACpC,KAAK,EAAE,IAAI,CAAC,KAAK;SACjB,CAAC,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,OAAO,OAAO,CAAC;AAChB,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,0BAA0B,CAAC,OAAe;IACzD,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACrC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,IACC,CAAC,OAAO;YACR,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;YACvB,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;YACvB,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;YACvB,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;YAEvB,SAAS;QACV,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,wBAAwB,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QACpF,IAAI,KAAK,CAAC,MAAM,GAAG,EAAE;YAAE,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,SAAS,CAAC;AAClB,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,oBAAoB,CAAC,OAAe;IACnD,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACrC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QACvC,IAAI,KAAK;YAAE,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACnC,CAAC;IACD,OAAO,SAAS,CAAC;AAClB,CAAC"}

package/dist/anchors/openapi.d.ts

@@ -0,0 +1,24 @@
+import type { Anchor } from "../types.js";
+/** Parse an OpenAPI YAML/JSON spec and return the raw object, or undefined if invalid. */
+export declare function parseOpenApiSpec(content: string): Record<string, unknown> | undefined;
+/**
+ * Anchor slug for one operation, without the leading `#`.
+ *
+ * Exported because the renderer stamps this onto the element it draws: if the
+ * two computed it separately they would only agree by coincidence, and an
+ * anchor in the graph would stop resolving the moment either changed.
+ */
+export declare function openApiOperationAnchor(path: string, method: string, operationId?: string): string;
+/** Anchor slug for one schema, without the leading `#`. */
+export declare function openApiSchemaAnchor(name: string): string;
+/**
+ * Extract anchors from an OpenAPI YAML/JSON spec: operation IDs and schema names.
+ *
+ * These carry no `line` or `level`: they are positions in a parsed object, not
+ * headings in a source file, and the parser discards source offsets. `text` is
+ * the operation id or schema name the slug was built from.
+ */
+export declare function extractOpenApiAnchors(content: string): Anchor[];
+/** Extract the title from an OpenAPI spec. */
+export declare function extractOpenApiTitle(content: string): string | undefined;
+//# sourceMappingURL=openapi.d.ts.map

package/dist/anchors/openapi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi.d.ts","sourceRoot":"","sources":["../../src/anchors/openapi.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,0FAA0F;AAC1F,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAQrF;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAEjG;AAED,2DAA2D;AAC3D,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CA+B/D;AAED,8CAA8C;AAC9C,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGvE"}

package/dist/anchors/openapi.js

@@ -0,0 +1,75 @@
+import { parse } from "yaml";
+/** Parse an OpenAPI YAML/JSON spec and return the raw object, or undefined if invalid. */
+export function parseOpenApiSpec(content) {
+    try {
+        const spec = parse(content);
+        if (!spec || typeof spec !== "object")
+            return undefined;
+        return spec;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Anchor slug for one operation, without the leading `#`.
+ *
+ * Exported because the renderer stamps this onto the element it draws: if the
+ * two computed it separately they would only agree by coincidence, and an
+ * anchor in the graph would stop resolving the moment either changed.
+ */
+export function openApiOperationAnchor(path, method, operationId) {
+    return operationId ?? `/paths${path.replace(/\//g, "~1")}/${method}`;
+}
+/** Anchor slug for one schema, without the leading `#`. */
+export function openApiSchemaAnchor(name) {
+    return `/components/schemas/${name}`;
+}
+/**
+ * Extract anchors from an OpenAPI YAML/JSON spec: operation IDs and schema names.
+ *
+ * These carry no `line` or `level`: they are positions in a parsed object, not
+ * headings in a source file, and the parser discards source offsets. `text` is
+ * the operation id or schema name the slug was built from.
+ */
+export function extractOpenApiAnchors(content) {
+    const spec = parse(content);
+    if (!spec || typeof spec !== "object")
+        return [];
+    const anchors = [];
+    // Extract from paths — operation IDs or method+path combos
+    if (spec.paths && typeof spec.paths === "object") {
+        for (const [path, methods] of Object.entries(spec.paths)) {
+            if (!methods || typeof methods !== "object")
+                continue;
+            for (const [method, operation] of Object.entries(methods)) {
+                if (!operation || typeof operation !== "object" || !isHttpMethod(method))
+                    continue;
+                const op = operation;
+                const operationId = typeof op.operationId === "string" ? op.operationId : undefined;
+                anchors.push({
+                    slug: `#${openApiOperationAnchor(path, method, operationId)}`,
+                    text: operationId ?? `${method.toUpperCase()} ${path}`,
+                });
+            }
+        }
+    }
+    // Extract from components/schemas
+    const schemas = spec.components?.schemas ?? spec.definitions; // OpenAPI 2.x
+    if (schemas && typeof schemas === "object") {
+        for (const name of Object.keys(schemas)) {
+            anchors.push({ slug: `#${openApiSchemaAnchor(name)}`, text: name });
+        }
+    }
+    return anchors;
+}
+/** Extract the title from an OpenAPI spec. */
+export function extractOpenApiTitle(content) {
+    const spec = parse(content);
+    return spec?.info?.title;
+}
+const HTTP_METHODS = new Set(["get", "post", "put", "patch", "delete", "head", "options", "trace"]);
+function isHttpMethod(method) {
+    return HTTP_METHODS.has(method.toLowerCase());
+}
+//# sourceMappingURL=openapi.js.map

package/dist/anchors/openapi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi.js","sourceRoot":"","sources":["../../src/anchors/openapi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AAG7B,0FAA0F;AAC1F,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC/C,IAAI,CAAC;QACJ,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;QAC5B,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,OAAO,SAAS,CAAC;QACxD,OAAO,IAA+B,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,SAAS,CAAC;IAClB,CAAC;AACF,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAY,EAAE,MAAc,EAAE,WAAoB;IACxF,OAAO,WAAW,IAAI,SAAS,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,MAAM,EAAE,CAAC;AACtE,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC/C,OAAO,uBAAuB,IAAI,EAAE,CAAC;AACtC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAe;IACpD,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;IAC5B,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC;IAEjD,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,2DAA2D;IAC3D,IAAI,IAAI,CAAC,KAAK,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QAClD,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1D,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ;gBAAE,SAAS;YACtD,KAAK,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAkC,CAAC,EAAE,CAAC;gBACtF,IAAI,CAAC,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC;oBAAE,SAAS;gBACnF,MAAM,EAAE,GAAG,SAAoC,CAAC;gBAChD,MAAM,WAAW,GAAG,OAAO,EAAE,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;gBACpF,OAAO,CAAC,IAAI,CAAC;oBACZ,IAAI,EAAE,IAAI,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE;oBAC7D,IAAI,EAAE,WAAW,IAAI,GAAG,MAAM,CAAC,WAAW,EAAE,IAAI,IAAI,EAAE;iBACtD,CAAC,CAAC;YACJ,CAAC;QACF,CAAC;IACF,CAAC;IAED,kCAAkC;IAClC,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,EAAE,OAAO,IAAI,IAAI,CAAC,WAAW,CAAC,CAAC,cAAc;IAC5E,IAAI,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC5C,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YACzC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,mBAAmB,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACrE,CAAC;IACF,CAAC;IAED,OAAO,OAAO,CAAC;AAChB,CAAC;AAED,8CAA8C;AAC9C,MAAM,UAAU,mBAAmB,CAAC,OAAe;IAClD,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;IAC5B,OAAO,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC;AAC1B,CAAC;AAED,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;AACpG,SAAS,YAAY,CAAC,MAAc;IACnC,OAAO,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;AAC/C,CAAC"}

package/dist/browser.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Browser-safe exports from @lepid-labs/weft-core — no Node.js built-ins.
+ * Use this entry point in browser/embed builds.
+ */
+export { openApiOperationAnchor, openApiSchemaAnchor, parseOpenApiSpec, } from "./anchors/openapi.js";
+export { nodeIdToDocPath } from "./node-path.js";
+export { INCLUDES, INCLUDE_DEFAULTS, extractSection } from "./includes.js";
+export type { SectionRange } from "./includes.js";
+export type { Anchor, Assertions, IncludeContributes, IncludeDefaults, IncludeHeadingShift, Manifest, ProjectManifest, ProjectsIndex, WeftNode, WeftEdge, WeftProject, WeftProjectRef, LinkRef, SearchResult, SiteConfig, StyleConfig, WeftConfig, } from "./types.js";
+//# sourceMappingURL=browser.d.ts.map