@andesine/pages 0.0.0-stage → 0.6.0

package/dist/runtime.d.ts

@@ -0,0 +1,81 @@
+import { t as FileTreeItem } from "./chunks/mdx-components-CUUDTapN.js";
+import { P as PagesConfig } from "./chunks/index-D8wL2B5s.js";
+import { a as renderRoute, i as getStaticPaths, r as getNotFoundContext } from "./chunks/index-vsu3hISM.js";
+import { z } from "zod";
+import { CustomRecord } from "pagefind";
+import { Element, ElementContent, Root, RootContent } from "hast";
+//#region src/content/elements.d.ts
+interface ContentElement {
+  name: ElementName;
+  props: Record<string, unknown>;
+}
+type ElementName = keyof typeof elementSchemas;
+/** Custom elements in Andesine content. Names and props match the MDX components. */
+declare const elementSchemas: {
+  Callout: z.ZodObject<{
+    type: z.ZodOptional<z.ZodEnum<{
+      note: "note";
+      tip: "tip";
+      warning: "warning";
+      danger: "danger";
+    }>>;
+    title: z.ZodOptional<z.ZodString>;
+  }, z.core.$strict>;
+  Card: z.ZodObject<{
+    title: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    icon: z.ZodOptional<z.ZodString>;
+    href: z.ZodOptional<z.ZodString>;
+  }, z.core.$strict>;
+  CardGrid: z.ZodObject<{}, z.core.$strict>;
+  CodeGroup: z.ZodObject<{}, z.core.$strict>;
+  Disclosure: z.ZodObject<{
+    title: z.ZodString;
+    open: z.ZodOptional<z.ZodBoolean>;
+  }, z.core.$strict>;
+  Figure: z.ZodObject<{
+    caption: z.ZodString;
+  }, z.core.$strict>;
+  FileTree: z.ZodObject<{}, z.core.$strict>;
+  Operation: z.ZodObject<{
+    source: z.ZodString;
+    id: z.ZodString;
+    anchor: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodBoolean>;
+    authentication: z.ZodOptional<z.ZodBoolean>;
+    parameters: z.ZodOptional<z.ZodBoolean>;
+    requestBody: z.ZodOptional<z.ZodBoolean>;
+    responses: z.ZodOptional<z.ZodBoolean>;
+    examples: z.ZodOptional<z.ZodBoolean>;
+  }, z.core.$strict>;
+  Steps: z.ZodObject<{}, z.core.$strict>;
+  Tab: z.ZodObject<{
+    label: z.ZodString;
+  }, z.core.$strict>;
+  Tabs: z.ZodObject<{
+    syncKey: z.ZodOptional<z.ZodString>;
+  }, z.core.$strict>;
+  Visibility: z.ZodObject<{
+    for: z.ZodEnum<{
+      agents: "agents";
+      humans: "humans";
+    }>;
+  }, z.core.$strict>;
+};
+/** Reads and validates a custom element from the converters' HTML output. */
+declare const readElement: (node: Element) => ContentElement | undefined;
+//#endregion
+//#region src/content/hast.d.ts
+declare const isElement: (node: RootContent | ElementContent) => node is Element;
+/** Reads a `<ul>` of files and folders. Items that end with `/`, or have nested lists, are folders. */
+declare const toFileTreeItems: (list: Element) => FileTreeItem[];
+//#endregion
+//#region src/search/records.d.ts
+/**
+ * Creates Pagefind records for local pages from their source text, for the development index.
+ * Built sites index the rendered pages instead.
+ */
+declare const getSearchRecords: (config: PagesConfig) => Promise<CustomRecord[]>;
+//#endregion
+export { getNotFoundContext, getSearchRecords, getStaticPaths, isElement, readElement, renderRoute, toFileTreeItems };
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.js

@@ -0,0 +1,56 @@
+import { n as loadFilesSource } from "./chunks/sources-Cm6NdIen.js";
+import { a as renderRoute, i as getStaticPaths, n as getNotFoundContext } from "./chunks/site-DY-uZ0PP.js";
+import { a as filterVisibility } from "./chunks/stored-CabomV-C.js";
+import { a as toFileTreeItems, i as isElement, o as readElement } from "./chunks/prepare-lnuw_ycM.js";
+import { n as loadOpenAPISource } from "./chunks/stored-CcEfvCQH.js";
+//#region src/search/text.ts
+const textProps = /\b(?:title|description|label|caption)=(["'])(.*?)\1/g;
+/** Keeps the text of a JSX tag's visible props, and drops the tag. */
+const replaceTag = (tag) => {
+	return [...tag.matchAll(textProps)].map((match) => ` ${match[2]} `).join("");
+};
+/**
+* Turns MDX source into plain text for the development search index, like the text of the
+* rendered page: no ESM statements, JSX tags, or Markdown syntax.
+*/
+const toSearchText = (source) => {
+	return source.replace(/^(?:import|export)\s.*$/gm, "").replace(/<\/?[A-Za-z][\w.:-]*(?:\s(?:[^<>"']|"[^"]*"|'[^']*')*)?\/?>/g, replaceTag).replace(/^\s*(?:`{3,}|~{3,}).*$/gm, "").replace(/!\[([^\]]*)\]\([^)]*\)/g, "$1").replace(/\[([^\]]*)\]\([^)]*\)/g, "$1").replace(/^\s{0,3}(?:#{1,6}\s+|>\s?|[-*+]\s+|\d+\.\s+)/gm, "").replace(/(\*\*|__|\*|_|`)(\S(?:.*?\S)?)\1/g, "$2").replace(/[ \t]+/g, " ").replace(/\n{3,}/g, "\n\n").trim();
+};
+//#endregion
+//#region src/search/records.ts
+/**
+* Creates Pagefind records for local pages from their source text, for the development index.
+* Built sites index the rendered pages instead.
+*/
+const getSearchRecords = async (config) => {
+	const options = {
+		base: config.base,
+		site: config.site
+	};
+	return (await Promise.all(config.sources.flatMap((source) => {
+		if (source.type === "files") return [loadFilesSource(source, options)];
+		if (source.type === "openapi") return [loadOpenAPISource(source, options)];
+		return [];
+	}))).flatMap((source) => {
+		return source.pages.flatMap((page) => {
+			const text = page.content.type === "file" ? page.content.entry.body ?? "" : page.markdown;
+			const body = toSearchText(filterVisibility(text, "humans"));
+			if (page.searchHidden) return [];
+			return [{
+				url: page.href.slice(config.base.length - 1),
+				content: [
+					page.title,
+					page.description,
+					body
+				].filter(Boolean).join("\n"),
+				language: config.language,
+				meta: { title: page.title },
+				filters: { source: [source.id] }
+			}];
+		});
+	});
+};
+//#endregion
+export { getNotFoundContext, getSearchRecords, getStaticPaths, isElement, readElement, renderRoute, toFileTreeItems };
+
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","names":[],"sources":["../src/search/text.ts","../src/search/records.ts"],"sourcesContent":["// Props whose values show on the page, e.g. a card or callout title.\nconst textProps = /\\b(?:title|description|label|caption)=([\"'])(.*?)\\1/g;\n\n/** Keeps the text of a JSX tag's visible props, and drops the tag. */\nconst replaceTag = (tag: string): string => {\n  return [...tag.matchAll(textProps)].map((match) => ` ${match[2]} `).join(\"\");\n};\n/**\n * Turns MDX source into plain text for the development search index, like the text of the\n * rendered page: no ESM statements, JSX tags, or Markdown syntax.\n */\nconst toSearchText = (source: string): string => {\n  return source\n    .replace(/^(?:import|export)\\s.*$/gm, \"\")\n    .replace(/<\\/?[A-Za-z][\\w.:-]*(?:\\s(?:[^<>\"']|\"[^\"]*\"|'[^']*')*)?\\/?>/g, replaceTag)\n    .replace(/^\\s*(?:`{3,}|~{3,}).*$/gm, \"\")\n    .replace(/!\\[([^\\]]*)\\]\\([^)]*\\)/g, \"$1\")\n    .replace(/\\[([^\\]]*)\\]\\([^)]*\\)/g, \"$1\")\n    .replace(/^\\s{0,3}(?:#{1,6}\\s+|>\\s?|[-*+]\\s+|\\d+\\.\\s+)/gm, \"\")\n    .replace(/(\\*\\*|__|\\*|_|`)(\\S(?:.*?\\S)?)\\1/g, \"$2\")\n    .replace(/[ \\t]+/g, \" \")\n    .replace(/\\n{3,}/g, \"\\n\\n\")\n    .trim();\n};\n\nexport { toSearchText };\n","import type { CustomRecord } from \"pagefind\";\nimport type { PagesConfig } from \"../config\";\nimport { filterVisibility } from \"../content/visibility\";\nimport { loadFilesSource } from \"../sources/files/load\";\nimport { loadOpenAPISource } from \"../sources/openapi/stored\";\nimport { toSearchText } from \"./text\";\n\n/**\n * Creates Pagefind records for local pages from their source text, for the development index.\n * Built sites index the rendered pages instead.\n */\nconst getSearchRecords = async (config: PagesConfig): Promise<CustomRecord[]> => {\n  const options = { base: config.base, site: config.site };\n  const sources = await Promise.all(\n    config.sources.flatMap((source) => {\n      if (source.type === \"files\") return [loadFilesSource(source, options)];\n      if (source.type === \"openapi\") return [loadOpenAPISource(source, options)];\n\n      return [];\n    })\n  );\n\n  return sources.flatMap((source) => {\n    return source.pages.flatMap((page): CustomRecord[] => {\n      // OpenAPI pages use their Markdown alternative, which has their fields.\n      const text = page.content.type === \"file\" ? (page.content.entry.body ?? \"\") : page.markdown;\n      // Like the built index, which reads the rendered page.\n      const body = toSearchText(filterVisibility(text, \"humans\"));\n\n      if (page.searchHidden) return [];\n\n      return [\n        {\n          // Relative to the base, which the client sets as the Pagefind base URL.\n          url: page.href.slice(config.base.length - 1),\n          content: [page.title, page.description, body].filter(Boolean).join(\"\\n\"),\n          language: config.language,\n          meta: { title: page.title },\n          filters: { source: [source.id] }\n        }\n      ];\n    });\n  });\n};\n\nexport { getSearchRecords };\n"],"mappings":";;;;;;AACA,MAAM,YAAY;;AAGlB,MAAM,cAAc,QAAwB;CAC1C,OAAO,CAAC,GAAG,IAAI,SAAS,SAAS,CAAC,CAAC,CAAC,KAAK,UAAU,IAAI,MAAM,GAAG,EAAE,CAAC,CAAC,KAAK,EAAE;AAC7E;;;;;AAKA,MAAM,gBAAgB,WAA2B;CAC/C,OAAO,OACJ,QAAQ,6BAA6B,EAAE,CAAC,CACxC,QAAQ,gEAAgE,UAAU,CAAC,CACnF,QAAQ,4BAA4B,EAAE,CAAC,CACvC,QAAQ,2BAA2B,IAAI,CAAC,CACxC,QAAQ,0BAA0B,IAAI,CAAC,CACvC,QAAQ,kDAAkD,EAAE,CAAC,CAC7D,QAAQ,qCAAqC,IAAI,CAAC,CAClD,QAAQ,WAAW,GAAG,CAAC,CACvB,QAAQ,WAAW,MAAM,CAAC,CAC1B,KAAK;AACV;;;;;;;ACZA,MAAM,mBAAmB,OAAO,WAAiD;CAC/E,MAAM,UAAU;EAAE,MAAM,OAAO;EAAM,MAAM,OAAO;CAAK;CAUvD,QAAO,MATe,QAAQ,IAC5B,OAAO,QAAQ,SAAS,WAAW;EACjC,IAAI,OAAO,SAAS,SAAS,OAAO,CAAC,gBAAgB,QAAQ,OAAO,CAAC;EACrE,IAAI,OAAO,SAAS,WAAW,OAAO,CAAC,kBAAkB,QAAQ,OAAO,CAAC;EAEzE,OAAO,CAAC;CACV,CAAC,CACH,EAAA,CAEe,SAAS,WAAW;EACjC,OAAO,OAAO,MAAM,SAAS,SAAyB;GAEpD,MAAM,OAAO,KAAK,QAAQ,SAAS,SAAU,KAAK,QAAQ,MAAM,QAAQ,KAAM,KAAK;GAEnF,MAAM,OAAO,aAAa,iBAAiB,MAAM,QAAQ,CAAC;GAE1D,IAAI,KAAK,cAAc,OAAO,CAAC;GAE/B,OAAO,CACL;IAEE,KAAK,KAAK,KAAK,MAAM,OAAO,KAAK,SAAS,CAAC;IAC3C,SAAS;KAAC,KAAK;KAAO,KAAK;KAAa;IAAI,CAAC,CAAC,OAAO,OAAO,CAAC,CAAC,KAAK,IAAI;IACvE,UAAU,OAAO;IACjB,MAAM,EAAE,OAAO,KAAK,MAAM;IAC1B,SAAS,EAAE,QAAQ,CAAC,OAAO,EAAE,EAAE;GACjC,CACF;EACF,CAAC;CACH,CAAC;AACH"}

package/dist/scripts/restore-navigation.js

@@ -0,0 +1 @@
+(function(){let e=new Map,t=new Set,n=e=>{try{return JSON.parse(sessionStorage.getItem(e)??`null`)}catch{return}},r=t=>{if(!e.has(t)){let r=n(t);e.set(t,Array.isArray(r)?new Set(r.map(String)):void 0)}return e.get(t)},i=e=>{let t=e.closest(`[data-scope="navigation-tree"][data-part="item"]`),n=e.closest(`[data-storage-key]`)?.dataset.storageKey,i=n?r(n):void 0;if(!t||!i)return;let a=i.has(t.dataset.id??``)||t.hasAttribute(`data-active`)?`open`:`closed`,o=document.querySelector(`[aria-controls="${e.id}"]`);t.dataset.state=a,e.dataset.state=a,e.hidden=a===`closed`,o?.setAttribute(`data-state`,a),o?.setAttribute(`aria-expanded`,String(a===`open`))},a=e=>{let t=e.querySelector(`[aria-current="page"]`);if(e.scrollTop=Number(n(e.dataset.scrollKey??``))||0,t){let n=e.getBoundingClientRect(),r=t.getBoundingClientRect();r.top<n.top+8&&(e.scrollTop+=r.top-n.top-8),r.bottom>n.bottom-8&&(e.scrollTop+=r.bottom-n.bottom+8)}let{scrollTop:r,scrollHeight:i,clientHeight:a}=e;e.toggleAttribute(`data-overflow-y`,i>a),e.toggleAttribute(`data-at-top`,r<=0),e.toggleAttribute(`data-at-bottom`,r+a>=i-1)},o=new MutationObserver(e=>{let n=new Set;for(let r of e){t.forEach(e=>{e.contains(r.target)&&n.add(e)});for(let e of r.addedNodes){if(!(e instanceof HTMLElement))continue;let r=e.matches(`[data-part="group-content"]`)?[e]:e.querySelectorAll(`[data-scope="navigation-tree"][data-part="group-content"]`),a=e.matches(`[data-scroll-key]`)?[e]:e.querySelectorAll(`[data-scroll-key]`);r.forEach(i),a.forEach(e=>{t.add(e),n.add(e)})}}n.forEach(a)});o.observe(document.documentElement,{childList:!0,subtree:!0}),document.addEventListener(`DOMContentLoaded`,()=>{o.disconnect(),t.forEach(a)},{once:!0})})();

package/dist/search.d.ts

@@ -0,0 +1,6 @@
+import { APIRoute } from "astro";
+//#region src/astro/routes/search.d.ts
+export declare const prerender = false;
+export declare const POST: APIRoute;
+//#endregion
+//# sourceMappingURL=search.d.ts.map

package/dist/sitemap.d.ts

@@ -0,0 +1,5 @@
+import { APIRoute } from "astro";
+//#region src/astro/routes/sitemap.d.ts
+export declare const GET: APIRoute;
+//#endregion
+//# sourceMappingURL=sitemap.d.ts.map

package/dist/skill.d.ts

@@ -0,0 +1,5 @@
+import { APIRoute } from "astro";
+//#region src/astro/routes/skill.d.ts
+export declare const GET: APIRoute;
+//#endregion
+//# sourceMappingURL=skill.d.ts.map

package/dist/skills.d.ts

@@ -0,0 +1,10 @@
+import { APIRoute } from "astro";
+//#region src/astro/routes/skills.d.ts
+export declare const getStaticPaths: () => {
+  params: {
+    path: string;
+  };
+}[];
+export declare const GET: APIRoute;
+//#endregion
+//# sourceMappingURL=skills.d.ts.map

package/dist/social.d.ts

@@ -0,0 +1,7 @@
+import { n as SocialPath } from "./chunks/index-vsu3hISM.js";
+import { APIRoute } from "astro";
+//#region src/astro/routes/social.d.ts
+export declare const getStaticPaths: () => Promise<SocialPath[]>;
+export declare const GET: APIRoute;
+//#endregion
+//# sourceMappingURL=social.d.ts.map

package/dist/well-known-llms.d.ts

@@ -0,0 +1,2 @@
+import { GET } from "./llms.js";
+export { GET };

package/package.json

@@ -1,6 +1,106 @@
 {
   "name": "@andesine/pages",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.6.0",
+  "description": "Astro documentation framework for Andesine and local content",
+  "type": "module",
+  "license": "MIT",
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./integration": {
+      "types": "./dist/integration.d.ts",
+      "import": "./dist/integration.js"
+    },
+    "./collections": {
+      "types": "./dist/collections.d.ts",
+      "import": "./dist/collections.js"
+    },
+    "./astro": {
+      "types": "./dist/astro.d.ts",
+      "import": "./dist/astro.js"
+    },
+    "./client": {
+      "types": "./dist/client.d.ts",
+      "import": "./dist/client.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "engines": {
+    "node": ">=24"
+  },
+  "peerDependencies": {
+    "@resvg/resvg-js": "^2.6.2",
+    "astro": "^7.3.1",
+    "satori": "^0.33.5",
+    "vite": "^8.0.13"
+  },
+  "dependencies": {
+    "@iconify/json": "^2.2.509",
+    "@iconify/utils": "^3.1.4",
+    "@scalar/json-magic": "0.15.2",
+    "@scalar/openapi-parser": "0.29.7",
+    "hast-util-to-html": "9.0.5",
+    "marked": "15.0.12",
+    "pagefind": "1.5.2",
+    "satori-html": "^0.3.2",
+    "shiki": "^4.4.3",
+    "yaml": "2.9.0",
+    "zod": "^4.5.4",
+    "@andesine/converters": "0.6.0",
+    "@andesine/sdk": "0.6.0"
+  },
+  "devDependencies": {
+    "@resvg/resvg-js": "^2.6.2",
+    "@types/hast": "^3.0.4",
+    "@types/node": "^26.1.2",
+    "astro": "7.3.1",
+    "publint": "0.3.24",
+    "rolldown": "^1.2.2",
+    "rolldown-plugin-dts": "^0.28.6",
+    "satori": "^0.33.5",
+    "typescript": "6.0.3",
+    "vite": "8.2.0"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/vriteio/andesine.git",
+    "directory": "packages/public/pages"
+  },
+  "homepage": "https://github.com/vriteio/andesine/tree/andesine/packages/public/pages#readme",
+  "bugs": {
+    "url": "https://github.com/vriteio/andesine/issues"
+  },
+  "keywords": [
+    "andesine",
+    "astro",
+    "astro-integration",
+    "documentation"
+  ],
+  "peerDependenciesMeta": {
+    "@resvg/resvg-js": {
+      "optional": true
+    },
+    "satori": {
+      "optional": true
+    }
+  },
+  "scripts": {
+    "build": "rolldown -c rolldown.config.ts",
+    "typecheck": "tsc --noEmit",
+    "lint:package": "publint --strict"
+  }
 }