@tsdoctor/pages 0.3.12 → 0.3.14

package/Blocks.js

@@ -1,7 +1,7 @@
 import { FlowContent, PhrasingContent } from "@effected/markdown";
 import { Schema } from "effect";
 
-//#region src/Blocks.ts
+// src/Blocks.ts
 /**
 * The block vocabulary — the things a generated API page is built from,
 * named once so every adapter emits the same page in its own dialect.
@@ -354,5 +354,4 @@ const Block = Schema.Union([
 	MemberIndex
 ]);
 
-//#endregion
 export { AvailableFrom, BaseClass, Block, CodeText, EnumMemberRow, EnumMemberTable, Example, ExampleGroup, Inline, Member, MemberGroup, MemberIndex, MemberIndexEntry, MemberRole, ParameterRow, ParameterTable, Prose, ProseBlock, ProseRole, ReleaseTag, SeeAlso, Signature, SourceLink, Title };

package/Build.js

@@ -7,7 +7,7 @@ import { Effect, Option, Result, Schema } from "effect";
 import { ApiItemKind } from "@microsoft/api-extractor-model";
 import { ApiItems, Routes, Signature, Tsdoc, TypeReferenceExtractor } from "@tsdoctor/model";
 
-//#region src/Build.ts
+// src/Build.ts
 /**
 * The description a page carries when its item has no summary.
 *
@@ -521,5 +521,4 @@ const buildPage = Effect.fn("Build.buildPage")(function* (input) {
 	}));
 });
 
-//#endregion
 export { INDEX_PAGE_TITLE, IndexPage, NO_DESCRIPTION, buildIndexPage, buildPage, isPageKind };

package/Examples.js

@@ -4,7 +4,7 @@ import { Effect, Schema } from "effect";
 import { TypeReferenceExtractor } from "@tsdoctor/model";
 import { format } from "prettier";
 
-//#region src/Examples.ts
+// src/Examples.ts
 /**
 * Prettier could not format an example.
 *
@@ -233,5 +233,4 @@ const buildExample = Effect.fn("Examples.buildExample")(function* (example, apiI
 	});
 });
 
-//#endregion
 export { ExampleFormatError, addLogicalBlankLines, buildExample, codeText, formatExampleCode, prepareExampleCode, prependHiddenImports, stripTwoslashDirectives };

package/Llms.js

@@ -1,4 +1,4 @@
-//#region src/Llms.ts
+// src/Llms.ts
 /** Pre-compiled regex for parsing llms.txt link lines. */
 const LLMS_TXT_LINE_RE = /^-\s+\[([^\]]+)\]\(([^)]+)\)(?::\s*(\S.*))?$/;
 /**
@@ -278,5 +278,4 @@ function generatePackageLlmsFullTxt(pages) {
 	return sections.join("\n\n\n");
 }
 
-//#endregion
 export { filterLlmsFullTxt, filterLlmsTxt, generatePackageLlmsFullTxt, generatePackageLlmsTxt, generateStructuredLlmsTxt, parseLlmsTxtLine };

package/Markdown.js

@@ -1,7 +1,7 @@
 import { Blockquote, Code, Heading, InlineCode, Link, List, ListItem, Markdown, Paragraph, Root, Strong, Table, TableCell, TableRow, Text } from "@effected/markdown";
 import { Effect, Result } from "effect";
 
-//#region src/Markdown.ts
+// src/Markdown.ts
 const text = (value) => Text.make({ value });
 const heading = (depth, value) => Heading.make({
 	depth,
@@ -151,5 +151,4 @@ function renderMarkdownResult(page) {
 */
 const renderMarkdown = Effect.fn("Markdown.renderMarkdown")((page) => Effect.fromResult(renderMarkdownResult(page)));
 
-//#endregion
 export { markdownBlockTree, markdownTree, renderMarkdown, renderMarkdownResult };

package/Nav.js

@@ -1,6 +1,6 @@
 import { Schema } from "effect";
 
-//#region src/Nav.ts
+// src/Nav.ts
 /**
 * The per-API navigation tree — category groups of pages plus the index —
 * as data, so a sidebar that is files in one framework and config in another
@@ -144,5 +144,4 @@ function buildNav(input) {
 	});
 }
 
-//#endregion
 export { NAV_INDEX_LABEL, NavCategory, NavEntry, NavGroup, NavPage, NavTree, buildNav, sortNavPages };

package/Page.js

@@ -2,7 +2,7 @@ import { Block } from "./Blocks.js";
 import { NavEntry } from "./Nav.js";
 import { Schema } from "effect";
 
-//#region src/Page.ts
+// src/Page.ts
 /**
 * The neutral head tag, as a schema — the same shape as `@tsdoctor/seo`'s
 * `HeadTag` interface, so a value from `headTags` is accepted unchanged.
@@ -76,5 +76,4 @@ var Page = class extends Schema.Class("Page")({
 	}
 };
 
-//#endregion
 export { HeadTag, Page, PageKind };

package/Scope.js

@@ -1,4 +1,4 @@
-//#region src/Scope.ts
+// src/Scope.ts
 /**
 * API scope naming — the helpers that turn a package name and a base route
 * into the identifiers every adapter must agree on.
@@ -52,5 +52,4 @@ function apiScopeOf(baseRoute, packageName) {
 	return baseRoute.replace(/^\//, "").split("/")[0] || packageName;
 }
 
-//#endregion
 export { apiScopeOf, normalizeBaseRoute, unscopedName };

package/TwoslashDirectives.js

@@ -1,4 +1,4 @@
-//#region src/TwoslashDirectives.ts
+// src/TwoslashDirectives.ts
 /**
 * Twoslash directive detection — the regexes that decide which lines of a
 * code block are notation rather than code.
@@ -59,5 +59,4 @@ function classifyCutDirective(trimmedLine) {
 	return null;
 }
 
-//#endregion
 export { classifyCutDirective, isTwoslashDirective };

package/WorkItems.js

@@ -1,6 +1,6 @@
 import { ApiItems, EntryPoints, Routes, SyntheticBases } from "@tsdoctor/model";
 
-//#region src/WorkItems.ts
+// src/WorkItems.ts
 /**
 * Cross-link priority by API item kind (lower = higher priority). When a bare
 * name maps to multiple pages (the const+type companion pattern), the bare
@@ -158,5 +158,4 @@ function prepareWorkItems(input) {
 	};
 }
 
-//#endregion
 export { crossLinkKindPriority, prepareWorkItems };

package/index.d.ts

@@ -2,7 +2,6 @@ import { FlowContent, MarkdownStringifyError, PhrasingContent } from "@effected/
 import { Effect, Option, Result, Schema } from "effect";
 import { ApiItem, ApiItemKind, ApiPackage } from "@microsoft/api-extractor-model";
 import { ApiItems, CrossLinker, ImportStatement, Routes } from "@tsdoctor/model";
-//#region src/Blocks.d.ts
 /**
  * A run of block-level mdast — a summary paragraph, a remarks section.
  *
@@ -334,8 +333,6 @@ export type Block = typeof Block.Type;
  * @public
  */
 type BlockKind = Block["kind"];
-//#endregion
-//#region src/Examples.d.ts
 declare const ExampleFormatError_base: Schema.Class<ExampleFormatError, Schema.TaggedStruct<"ExampleFormatError", {
   /** The fence language the parser was chosen for. */
   readonly language: Schema.String;
@@ -462,8 +459,6 @@ export declare const formatExampleCode: (code: string, language: string) => Effe
  * @public
  */
 export declare const buildExample: (example: RawExample, apiItemName: string, packageName: string, suppressErrors?: boolean) => Effect.Effect<Example, ExampleFormatError>;
-//#endregion
-//#region src/Nav.d.ts
 declare const NavEntry_base: Schema.Class<NavEntry, Schema.Struct<{
   /** The category key the page was categorized under. */
   readonly categoryKey: Schema.String;
@@ -577,8 +572,6 @@ export declare function sortNavPages(pages: ReadonlyArray<NavPage>): ReadonlyArr
  * @public
  */
 export declare function buildNav(input: BuildNavInput): NavTree;
-//#endregion
-//#region src/Page.d.ts
 /**
  * The neutral head tag, as a schema — the same shape as `@tsdoctor/seo`'s
  * `HeadTag` interface, so a value from `headTags` is accepted unchanged.
@@ -651,8 +644,6 @@ export declare class Page extends Page_base {
    */
   get title(): string;
 }
-//#endregion
-//#region src/Build.d.ts
 /**
  * The description a page carries when its item has no summary.
  *
@@ -768,8 +759,6 @@ export declare function isPageKind(kind: ApiItemKind): boolean;
  * @public
  */
 export declare const buildPage: (input: BuildPageInput) => Effect.Effect<Option.Option<Page>>;
-//#endregion
-//#region src/Llms.d.ts
 /**
  * A parsed link entry from llms.txt format.
  *
@@ -950,8 +939,6 @@ export declare function generatePackageLlmsTxt(input: PackageLlmsTxtInput): stri
  * @public
  */
 export declare function generatePackageLlmsFullTxt(pages: PageContent[]): string;
-//#endregion
-//#region src/Markdown.d.ts
 /**
  * Render one block to flow nodes.
  *
@@ -984,8 +971,6 @@ export declare function renderMarkdownResult(page: Page): Result.Result<string,
  * @public
  */
 export declare const renderMarkdown: (page: Page) => Effect.Effect<string, MarkdownStringifyError>;
-//#endregion
-//#region src/Scope.d.ts
 /**
  * API scope naming — the helpers that turn a package name and a base route
  * into the identifiers every adapter must agree on.
@@ -1030,8 +1015,6 @@ export declare function normalizeBaseRoute(route: string): string;
  * @public
  */
 export declare function apiScopeOf(baseRoute: string, packageName: string): string;
-//#endregion
-//#region src/TwoslashDirectives.d.ts
 /**
  * Twoslash directive detection — the regexes that decide which lines of a
  * code block are notation rather than code.
@@ -1069,8 +1052,6 @@ export declare function isTwoslashDirective(trimmedLine: string): boolean;
  * @public
  */
 export declare function classifyCutDirective(trimmedLine: string): CutDirective | null;
-//#endregion
-//#region src/WorkItems.d.ts
 /**
  * Lower number = higher priority for which page a bare cross-link name
  * resolves to.
@@ -1188,6 +1169,5 @@ interface PrepareWorkItemsResult<C extends WorkItemCategory = WorkItemCategory>
  * @public
  */
 export declare function prepareWorkItems<C extends WorkItemCategory>(input: PrepareWorkItemsInput<C>): PrepareWorkItemsResult<C>;
-//#endregion
 export type { BlockKind, BuildIndexPageInput, BuildNavInput, BuildPageInput, CrossLinkData, CutDirective, HeadTag, LlmsTxtEntry, NamespaceMemberFacts, PackageLlmsTxtInput, PackagePointer, PackageScopeInfo, PageContent, PrepareWorkItemsInput, PrepareWorkItemsResult, PreparedExample, RawExample, WorkItem, WorkItemCategory };
 //# sourceMappingURL=index.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@tsdoctor/pages",
-	"version": "0.3.12",
+	"version": "0.3.14",
 	"private": false,
 	"description": "Framework-neutral documentation page IR for static TypeScript API sites: typed doc blocks over an API Extractor model, per-API navigation trees, display/source code preparation, a plain-markdown emitter and the llms.txt text transforms.",
 	"keywords": [
@@ -40,16 +40,16 @@
 	},
 	"dependencies": {
 		"@microsoft/api-extractor-model": "7.33.12",
-		"@tsdoctor/model": "0.8.11",
-		"@tsdoctor/seo": "0.4.9",
+		"@tsdoctor/model": "0.8.13",
+		"@tsdoctor/seo": "0.4.11",
 		"prettier": "^3.9.10"
 	},
 	"peerDependencies": {
-		"@effected/markdown": "^0.19.0",
-		"@effected/package-json": "^0.23.0",
-		"@effected/schema-org": "^0.10.0",
-		"@effected/tsconfig-json": "^0.16.0",
-		"effect": "^4.0.5"
+		"@effected/markdown": "^0.22.0",
+		"@effected/package-json": "^0.25.0",
+		"@effected/schema-org": "^0.11.0",
+		"@effected/tsconfig-json": "^0.17.0",
+		"effect": "^4.0.6"
 	},
 	"engines": {
 		"node": ">=24.11.0"