nimbus-docs 0.1.12 → 0.1.14

package/dist/markdown.d.ts

@@ -0,0 +1,37 @@
+import { HastPluginDefinition } from "satteri";
+
+//#region src/markdown/external-links.d.ts
+/** Default arrow affordance (space + U+2197). Exported so a consumer's
+ * heading-slug plugin can strip it before computing ids. */
+declare const EXTERNAL_LINK_ARROW = " \u2197";
+interface ExternalLinksOptions {
+  /** `target` attribute set on external links. Default `"_blank"`. */
+  target?: string;
+  /** `rel` tokens set on external links. Default `["noopener"]`. */
+  rel?: string[];
+  /**
+   * Arrow affordance appended after the link text (inside the anchor), unless
+   * the link wraps an image. `null` disables it. Default `" ↗"`.
+   */
+  arrow?: string | null;
+  /** Class on the arrow `<span>`. Default `"external-link"`. */
+  arrowClass?: string;
+  /**
+   * Hosts considered internal (left undecorated). Default: none — any absolute
+   * `http(s)`/protocol-relative link is external (rehype-external-links default).
+   */
+  internalHosts?: string[];
+}
+declare function externalLinks(options?: ExternalLinksOptions): HastPluginDefinition;
+//#endregion
+//#region src/markdown/title-figure.d.ts
+interface TitleFigureOptions {
+  /** Class on the generated `<figure>`. Default: none. */
+  figureClass?: string;
+  /** Class on the generated `<figcaption>`. Default: none. */
+  figcaptionClass?: string;
+}
+declare function titleFigure(options?: TitleFigureOptions): HastPluginDefinition;
+//#endregion
+export { EXTERNAL_LINK_ARROW, type ExternalLinksOptions, type TitleFigureOptions, externalLinks, titleFigure };
+//# sourceMappingURL=markdown.d.ts.map

package/dist/markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","names":[],"sources":["../src/markdown/external-links.ts","../src/markdown/title-figure.ts"],"mappings":";;;;;cAkBa,mBAAA;AAAA,UAEI,oBAAA;EAgBF;EAdb,MAAA;EAgC2B;EA9B3B,GAAA;EAgCqB;;;;EA3BrB,KAAA;EA2BqB;EAzBrB,UAAA;;;ACfF;;EDoBE,aAAA;AAAA;AAAA,iBAkBc,aAAA,CACd,OAAA,GAAS,oBAAA,GACR,oBAAA;;;UCxCc,kBAAA;EDef;ECbA,WAAA;EDkBa;EChBb,eAAA;AAAA;AAAA,iBAqBc,WAAA,CACd,OAAA,GAAS,kBAAA,GACR,oBAAA"}

package/dist/markdown.js

@@ -0,0 +1,126 @@
+//#region src/markdown/types.ts
+/** Narrow a node to an element, optionally of a given tagName. */
+function isElement(node, tagName) {
+	return !!node && node.type === "element" && (tagName === void 0 || node.tagName === tagName);
+}
+
+//#endregion
+//#region src/markdown/external-links.ts
+/** Default arrow affordance (space + U+2197). Exported so a consumer's
+* heading-slug plugin can strip it before computing ids. */
+const EXTERNAL_LINK_ARROW = " ↗";
+const EXTERNAL = /^(?:https?:)?\/\//i;
+function hasImgChild(node) {
+	return (node.children ?? []).some((c) => isElement(c, "img"));
+}
+function hostOf(href) {
+	try {
+		return new URL(href.startsWith("//") ? `https:${href}` : href).host;
+	} catch {
+		return null;
+	}
+}
+function externalLinks(options = {}) {
+	const target = options.target ?? "_blank";
+	const rel = options.rel ?? ["noopener"];
+	const arrow = options.arrow === void 0 ? EXTERNAL_LINK_ARROW : options.arrow;
+	const arrowClass = options.arrowClass ?? "external-link";
+	const internalHosts = options.internalHosts;
+	return {
+		name: "nimbus:external-links",
+		element: {
+			filter: ["a"],
+			visit(node) {
+				const href = node.properties?.href;
+				if (typeof href !== "string" || !EXTERNAL.test(href)) return;
+				if (internalHosts && internalHosts.length > 0) {
+					const host = hostOf(href);
+					if (host && internalHosts.includes(host)) return;
+				}
+				const children = [...node.children ?? []];
+				if (arrow !== null && !hasImgChild(node)) children.push({
+					type: "element",
+					tagName: "span",
+					properties: { className: [arrowClass] },
+					children: [{
+						type: "text",
+						value: arrow
+					}]
+				});
+				return {
+					type: "element",
+					tagName: "a",
+					properties: {
+						...node.properties,
+						target,
+						rel
+					},
+					children
+				};
+			}
+		}
+	};
+}
+
+//#endregion
+//#region src/markdown/title-figure.ts
+const WHITESPACE_ONLY = /^\s*$/;
+function isStandaloneImageParagraph(node) {
+	let sawImage = false;
+	for (const child of node.children ?? []) {
+		if (child.type === "text") {
+			if (!WHITESPACE_ONLY.test(child.value)) return false;
+			continue;
+		}
+		if (isElement(child, "img")) {
+			sawImage = true;
+			continue;
+		}
+		return false;
+	}
+	return sawImage;
+}
+function titleFigure(options = {}) {
+	const figureProps = options.figureClass ? { className: [options.figureClass] } : {};
+	const figcaptionProps = options.figcaptionClass ? { className: [options.figcaptionClass] } : {};
+	function build(img) {
+		const title = `${img.properties?.title ?? ""}`;
+		if (!title) return img;
+		return {
+			type: "element",
+			tagName: "figure",
+			properties: { ...figureProps },
+			children: [{
+				type: "element",
+				tagName: "img",
+				properties: { ...img.properties },
+				children: []
+			}, {
+				type: "element",
+				tagName: "figcaption",
+				properties: { ...figcaptionProps },
+				children: [{
+					type: "text",
+					value: title
+				}]
+			}]
+		};
+	}
+	return {
+		name: "nimbus:title-figure",
+		element: {
+			filter: ["p"],
+			visit(node, ctx) {
+				if (!isStandaloneImageParagraph(node)) return;
+				const figures = (node.children ?? []).filter((c) => isElement(c, "img")).map(build);
+				if (figures.length === 0) return;
+				for (const fig of figures) ctx.insertBefore(node, fig);
+				ctx.removeNode(node);
+			}
+		}
+	};
+}
+
+//#endregion
+export { EXTERNAL_LINK_ARROW, externalLinks, titleFigure };
+//# sourceMappingURL=markdown.js.map

package/dist/markdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.js","names":[],"sources":["../src/markdown/types.ts","../src/markdown/external-links.ts","../src/markdown/title-figure.ts"],"sourcesContent":["// Shared types for `nimbus-docs/markdown`. Sourced from `satteri` (a direct\n// dependency); `@types/hast` is not available here, so the node shapes these\n// plugins build are declared as minimal structural interfaces.\n\nimport type {\n  HastPluginDefinition,\n  HastVisitorContext,\n} from \"satteri\";\n\nexport type { HastPluginDefinition, HastVisitorContext };\n\nexport interface HastElement {\n  type: \"element\";\n  tagName: string;\n  properties?: Record<string, unknown> | null;\n  children?: HastChild[];\n}\n\nexport interface HastText {\n  type: \"text\";\n  value: string;\n}\n\nexport type HastChild = HastElement | HastText | { type: string; value?: string };\n\n/** Narrow a node to an element, optionally of a given tagName. */\nexport function isElement(\n  node: { type: string; tagName?: string } | null | undefined,\n  tagName?: string,\n): node is HastElement {\n  return (\n    !!node &&\n    node.type === \"element\" &&\n    (tagName === undefined || node.tagName === tagName)\n  );\n}\n\n/** Normalise a hast `className` property to a string[]. */\nexport function classNames(node: HastElement): string[] {\n  const cn = node.properties?.className;\n  if (Array.isArray(cn)) return cn.map(String);\n  if (typeof cn === \"string\") return cn.split(/\\s+/).filter(Boolean);\n  return [];\n}\n","/**\n * Decorates external links (absolute `http(s)`/protocol-relative): sets\n * `target`/`rel` and appends an arrow affordance after the link text, unless\n * the link wraps an image. Defaults mirror the common `rehype-external-links`\n * setup, so `externalLinks()` is a drop-in.\n *\n *   nimbus(config, { markdown: { hastPlugins: [externalLinks()] } })\n *\n * This runs before Sätteri's built-in heading-ids, whose text collection\n * re-includes the arrow and cannot be told to strip it. So an external link\n * inside a heading would pollute that heading's slug unless the consumer owns\n * heading slugging and strips `EXTERNAL_LINK_ARROW` before slugging.\n */\nimport type { HastChild, HastElement, HastPluginDefinition } from \"./types\";\nimport { isElement } from \"./types\";\n\n/** Default arrow affordance (space + U+2197). Exported so a consumer's\n * heading-slug plugin can strip it before computing ids. */\nexport const EXTERNAL_LINK_ARROW = \" ↗\";\n\nexport interface ExternalLinksOptions {\n  /** `target` attribute set on external links. Default `\"_blank\"`. */\n  target?: string;\n  /** `rel` tokens set on external links. Default `[\"noopener\"]`. */\n  rel?: string[];\n  /**\n   * Arrow affordance appended after the link text (inside the anchor), unless\n   * the link wraps an image. `null` disables it. Default `\" ↗\"`.\n   */\n  arrow?: string | null;\n  /** Class on the arrow `<span>`. Default `\"external-link\"`. */\n  arrowClass?: string;\n  /**\n   * Hosts considered internal (left undecorated). Default: none — any absolute\n   * `http(s)`/protocol-relative link is external (rehype-external-links default).\n   */\n  internalHosts?: string[];\n}\n\n// Absolute http(s) or protocol-relative `//host`.\nconst EXTERNAL = /^(?:https?:)?\\/\\//i;\n\nfunction hasImgChild(node: HastElement): boolean {\n  return (node.children ?? []).some((c) => isElement(c, \"img\"));\n}\n\nfunction hostOf(href: string): string | null {\n  try {\n    return new URL(href.startsWith(\"//\") ? `https:${href}` : href).host;\n  } catch {\n    return null;\n  }\n}\n\nexport function externalLinks(\n  options: ExternalLinksOptions = {},\n): HastPluginDefinition {\n  const target = options.target ?? \"_blank\";\n  const rel = options.rel ?? [\"noopener\"];\n  const arrow = options.arrow === undefined ? EXTERNAL_LINK_ARROW : options.arrow;\n  const arrowClass = options.arrowClass ?? \"external-link\";\n  const internalHosts = options.internalHosts;\n\n  const plugin = {\n    name: \"nimbus:external-links\",\n    element: {\n      filter: [\"a\"],\n      visit(node: HastElement) {\n        const href = node.properties?.href;\n        if (typeof href !== \"string\" || !EXTERNAL.test(href)) return;\n        if (internalHosts && internalHosts.length > 0) {\n          const host = hostOf(href);\n          if (host && internalHosts.includes(host)) return;\n        }\n\n        const children: HastChild[] = [...(node.children ?? [])];\n        if (arrow !== null && !hasImgChild(node)) {\n          children.push({\n            type: \"element\",\n            tagName: \"span\",\n            properties: { className: [arrowClass] },\n            children: [{ type: \"text\", value: arrow }],\n          });\n        }\n\n        return {\n          type: \"element\",\n          tagName: \"a\",\n          properties: { ...node.properties, target, rel },\n          children,\n        } as HastElement;\n      },\n    },\n  };\n\n  return plugin as unknown as HastPluginDefinition;\n}\n","/**\n * Turns a titled standalone image into a captioned figure:\n *   <p><img title=\"cap\"></p>  ->  <figure><img …><figcaption>cap</figcaption></figure>\n * Untitled standalone images are unwrapped without a caption.\n *\n *   nimbus(config, { markdown: { hastPlugins: [titleFigure()] } })\n *\n * `rehype-title-figure` only acts on root-level paragraphs; Sätteri's filtered\n * visitors expose no ancestors, so we instead require the paragraph to contain\n * only image(s) plus whitespace. A standalone-image paragraph nested in a\n * list/aside/blockquote is therefore also transformed; mixed text+image\n * paragraphs are left untouched.\n */\nimport type { HastChild, HastElement, HastPluginDefinition } from \"./types\";\nimport { isElement } from \"./types\";\n\nexport interface TitleFigureOptions {\n  /** Class on the generated `<figure>`. Default: none. */\n  figureClass?: string;\n  /** Class on the generated `<figcaption>`. Default: none. */\n  figcaptionClass?: string;\n}\n\nconst WHITESPACE_ONLY = /^\\s*$/;\n\nfunction isStandaloneImageParagraph(node: HastElement): boolean {\n  let sawImage = false;\n  for (const child of node.children ?? []) {\n    if (child.type === \"text\") {\n      if (!WHITESPACE_ONLY.test((child as { value: string }).value)) return false;\n      continue;\n    }\n    if (isElement(child, \"img\")) {\n      sawImage = true;\n      continue;\n    }\n    return false;\n  }\n  return sawImage;\n}\n\nexport function titleFigure(\n  options: TitleFigureOptions = {},\n): HastPluginDefinition {\n  const figureProps = options.figureClass\n    ? { className: [options.figureClass] }\n    : {};\n  const figcaptionProps = options.figcaptionClass\n    ? { className: [options.figcaptionClass] }\n    : {};\n\n  function build(img: HastElement): HastElement {\n    const title = `${img.properties?.title ?? \"\"}`;\n    if (!title) return img;\n    return {\n      type: \"element\",\n      tagName: \"figure\",\n      properties: { ...figureProps },\n      children: [\n        { type: \"element\", tagName: \"img\", properties: { ...img.properties }, children: [] },\n        {\n          type: \"element\",\n          tagName: \"figcaption\",\n          properties: { ...figcaptionProps },\n          children: [{ type: \"text\", value: title }],\n        },\n      ],\n    };\n  }\n\n  const plugin = {\n    name: \"nimbus:title-figure\",\n    element: {\n      filter: [\"p\"],\n      visit(node: HastElement, ctx: { insertBefore(n: unknown, x: unknown): void; removeNode(n: unknown): void }) {\n        if (!isStandaloneImageParagraph(node)) return;\n        const figures = (node.children ?? [])\n          .filter((c): c is HastElement => isElement(c, \"img\"))\n          .map(build);\n        if (figures.length === 0) return;\n        for (const fig of figures as HastChild[]) ctx.insertBefore(node, fig);\n        ctx.removeNode(node);\n      },\n    },\n  };\n\n  return plugin as unknown as HastPluginDefinition;\n}\n"],"mappings":"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"}

package/dist/schemas.d.ts

@@ -234,9 +234,9 @@ interface DefineSchemaOptions {
  *     }),
  *   };
  */
-declare function defineSchema(factory: (ctx: astro_content0.SchemaContext) => DefineSchemaOptions): (ctx: astro_content0.SchemaContext) => z.ZodObject<Readonly<{
+declare function defineSchema(factory: (ctx: astro_content0.SchemaContext) => DefineSchemaOptions): (ctx: astro_content0.SchemaContext) => z.ZodIntersection<z.ZodObject<any, z.core.$strip>, z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>> | z.ZodObject<Readonly<{
   [k: string]: z.core.$ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
-}>, z.core.$loose> | z.ZodIntersection<z.ZodObject<any, z.core.$strip>, z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>;
+}>, z.core.$loose>;
 /** Default docs schema. Equivalent to `defineDocSchema()`. */
 declare const docsSchema: z.ZodObject<{
   [x: string]: never;

package/dist/schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schemas.d.ts","names":[],"sources":["../src/schemas.ts"],"mappings":";;;;UAkBiB,eAAA,iBACC,MAAA,SAAe,CAAA,CAAE,UAAA,IAAc,MAAA;EAAhB;;;;;EAO/B,MAAA,GAAS,OAAA;AAAA;AA0RX;;;;;;;;AAAA,iBAAgB,eAAA,iBACE,MAAA,SAAe,CAAA,CAAE,UAAA,IAAc,MAAA,gBAAA,CAC/C,MAAA,GAAQ,eAAA,CAAgB,OAAA,IAAa,CAAA,CAAA,SAAA,4OAAA,OAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAyBtB,mBAAA;EACf,MAAA,GAAS,CAAA,CAAE,UAAA;EACX,MAAA,GAAS,MAAA,SAAe,CAAA,CAAE,UAAA;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA6BZ,YAAA,CACd,OAAA,GAAU,GAAA,EADgB,cAAA,CACa,aAAA,KAAkB,mBAAA,IAEjD,GAAA,EAFoE,cAAA,CAEvC,aAAA,KAAa,CAAA,CAAA,SAAA,CAAA,QAAA;EAAA;;;cA8BvC,UAAA,EAAU,CAAA,CAAA,SAAA;EAAA;GAAoB,CAAA,CAAA,IAAA,CAAA,MAAA;;cAW9B,cAAA,EAAc,CAAA,CAAA,UAAA,CAAA,CAAA,CAAA,SAAA;;;;;;;;;;;;;;;;iBAeX,oBAAA,iBACE,MAAA,SAAe,CAAA,CAAE,UAAA,IAAc,MAAA,gBAAA,CAC/C,MAAA;EAAU,MAAA,GAAS,OAAA;AAAA,IAAc,CAAA,CAAA,SAAA,mBAAA,OAAA;;;;;;cAmBtB,iBAAA,EAAiB,CAAA,CAAA,SAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAGjB,qBAAA,EAAqB,CAAA,CAAA,SAAA;;;;cAU5B,mBAAA,EAAmB,CAAA,CAAA,SAAA;;;;;;;KAQb,aAAA,GAAgB,CAAA,CAAE,KAAA,QAAa,mBAAA;;cAG9B,gBAAA,EAAgB,CAAA,CAAA,SAAA"}
+{"version":3,"file":"schemas.d.ts","names":[],"sources":["../src/schemas.ts"],"mappings":";;;;UAkBiB,eAAA,iBACC,MAAA,SAAe,CAAA,CAAE,UAAA,IAAc,MAAA;EAAhB;;;;;EAO/B,MAAA,GAAS,OAAA;AAAA;AA0RX;;;;;;;;AAAA,iBAAgB,eAAA,iBACE,MAAA,SAAe,CAAA,CAAE,UAAA,IAAc,MAAA,gBAAA,CAC/C,MAAA,GAAQ,eAAA,CAAgB,OAAA,IAAa,CAAA,CAAA,SAAA,4OAAA,OAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAyBtB,mBAAA;EACf,MAAA,GAAS,CAAA,CAAE,UAAA;EACX,MAAA,GAAS,MAAA,SAAe,CAAA,CAAE,UAAA;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA6BZ,YAAA,CACd,OAAA,GAAU,GAAA,EADgB,cAAA,CACa,aAAA,KAAkB,mBAAA,IAEjD,GAAA,EAFoE,cAAA,CAEvC,aAAA,KAAa,CAAA,CAAA,eAAA,CAAA,CAAA,CAAA,SAAA,MAAA,CAAA,CAAA,IAAA,CAAA,MAAA,GAAA,CAAA,CAAA,OAAA,mBAAA,CAAA,CAAA,IAAA,CAAA,iBAAA,uBAAA,CAAA,CAAA,SAAA,CAAA,QAAA;EAAA;;;cA8BvC,UAAA,EAAU,CAAA,CAAA,SAAA;EAAA;GAAoB,CAAA,CAAA,IAAA,CAAA,MAAA;;cAW9B,cAAA,EAAc,CAAA,CAAA,UAAA,CAAA,CAAA,CAAA,SAAA;;;;;;;;;;;;;;;;iBAeX,oBAAA,iBACE,MAAA,SAAe,CAAA,CAAE,UAAA,IAAc,MAAA,gBAAA,CAC/C,MAAA;EAAU,MAAA,GAAS,OAAA;AAAA,IAAc,CAAA,CAAA,SAAA,mBAAA,OAAA;;;;;;cAmBtB,iBAAA,EAAiB,CAAA,CAAA,SAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAGjB,qBAAA,EAAqB,CAAA,CAAA,SAAA;;;;cAU5B,mBAAA,EAAmB,CAAA,CAAA,SAAA;;;;;;;KAQb,aAAA,GAAgB,CAAA,CAAE,KAAA,QAAa,mBAAA;;cAG9B,gBAAA,EAAgB,CAAA,CAAA,SAAA"}

package/dist/types.d.ts

@@ -1,4 +1,5 @@
 import { a as Severity, i as RuleCode, n as Diagnostic, o as SeverityConfig, r as DiagnosticFix, t as AuthoringRuleCode } from "./diagnostic-CnxJwVpT.js";
+import { HastPluginInput, MdastPluginInput } from "satteri";
 
 //#region src/types.d.ts
 /**
@@ -537,5 +538,5 @@ interface DocsPageProps extends BasePageProps {
   prevNext: PrevNext;
 }
 //#endregion
-export { type AuthoringRuleCode, BadgeVariant, BannerProps, BasePageProps, Breadcrumb, type Diagnostic, type DiagnosticFix, DocsPageProps, FeaturesConfig, HeadElement, NimbusConfig, PrevNext, PrevNextLink, PrevNextOverrides, ResolvedVersions, type RuleCode, SearchConfig, SearchProvider, SearchResult, type Severity, type SeverityConfig, SidebarBadge, SidebarConfig, SidebarConfigItem, SidebarExternalLinkItem, SidebarGroupItem, SidebarItem, SidebarLinkItem, SidebarSection, SidebarTransform, TOCItem, VersionAlternateRecord, VersionAlternatesTable, VersionPageRef, VersionStatus, VersionsConfig };
+export { type AuthoringRuleCode, BadgeVariant, BannerProps, BasePageProps, Breadcrumb, type Diagnostic, type DiagnosticFix, DocsPageProps, FeaturesConfig, type HastPluginInput, HeadElement, type MdastPluginInput, NimbusConfig, PrevNext, PrevNextLink, PrevNextOverrides, ResolvedVersions, type RuleCode, SearchConfig, SearchProvider, SearchResult, type Severity, type SeverityConfig, SidebarBadge, SidebarConfig, SidebarConfigItem, SidebarExternalLinkItem, SidebarGroupItem, SidebarItem, SidebarLinkItem, SidebarSection, SidebarTransform, TOCItem, VersionAlternateRecord, VersionAlternatesTable, VersionPageRef, VersionStatus, VersionsConfig };
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nimbus-docs",
-  "version": "0.1.12",
+  "version": "0.1.14",
   "private": false,
   "type": "module",
   "description": "Docs, for humans and agents",
@@ -46,6 +46,10 @@
       "types": "./dist/client.d.ts",
       "import": "./dist/client.js"
     },
+    "./markdown": {
+      "types": "./dist/markdown.d.ts",
+      "import": "./dist/markdown.js"
+    },
     "./react": {
       "types": "./dist/react.d.ts",
       "import": "./dist/react.js"
@@ -60,6 +64,12 @@
     "dist",
     "src/components"
   ],
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "node --import tsx --test \"test/**/*.test.ts\""
+  },
   "peerDependencies": {
     "astro": ">=6.4.0",
     "react": ">=19.0.0",
@@ -108,11 +118,5 @@
     "tsdown": "^0.20.3",
     "tsx": "^4.22.3",
     "typescript": "^5.8.3"
-  },
-  "scripts": {
-    "build": "tsdown",
-    "dev": "tsdown --watch",
-    "typecheck": "tsc --noEmit",
-    "test": "node --import tsx --test \"test/**/*.test.ts\""
   }
-}
+}