@specglass/core 0.0.2

package/dist/virtual/modules.js

@@ -0,0 +1,37 @@
+/** Identifier for the specglass config virtual module */
+export const VIRTUAL_MODULE_ID = "virtual:specglass/config";
+/** Identifier for the specglass navigation virtual module */
+export const NAVIGATION_MODULE_ID = "virtual:specglass/navigation";
+/** Identifier for the specglass OpenAPI data virtual module */
+export const OPENAPI_DATA_MODULE_ID = "virtual:specglass/openapi-data";
+/**
+ * Generate the JavaScript module content for `virtual:specglass/config`.
+ * Serializes the resolved config object into an exportable module string.
+ *
+ * @param config - The fully resolved and validated SpecglassConfig
+ * @returns JavaScript module source code exporting `config`
+ */
+export function generateConfigModuleContent(config) {
+    return `export const config = ${JSON.stringify(config)};`;
+}
+/**
+ * Generate the JavaScript module content for `virtual:specglass/navigation`.
+ *
+ * @param tree - The computed navigation tree to serialize into the virtual module.
+ *              Defaults to an empty tree if not provided.
+ * @returns JavaScript module source code exporting `navigation`
+ */
+export function generateNavigationModuleContent(tree = { items: [] }) {
+    return `export const navigation = ${JSON.stringify(tree)};`;
+}
+/**
+ * Generate the JavaScript module content for `virtual:specglass/openapi-data`.
+ *
+ * @param data - Array of parsed OpenAPI specs to serialize.
+ *              Defaults to an empty array if not provided.
+ * @returns JavaScript module source code exporting `openApiData`
+ */
+export function generateOpenApiDataModuleContent(data = []) {
+    return `export const openApiData = ${JSON.stringify(data)};`;
+}
+//# sourceMappingURL=modules.js.map

package/dist/virtual/modules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"modules.js","sourceRoot":"","sources":["../../src/virtual/modules.ts"],"names":[],"mappings":"AAIA,yDAAyD;AACzD,MAAM,CAAC,MAAM,iBAAiB,GAAG,0BAA0B,CAAC;AAE5D,6DAA6D;AAC7D,MAAM,CAAC,MAAM,oBAAoB,GAAG,8BAA8B,CAAC;AAEnE,+DAA+D;AAC/D,MAAM,CAAC,MAAM,sBAAsB,GAAG,gCAAgC,CAAC;AAGvE;;;;;;GAMG;AACH,MAAM,UAAU,2BAA2B,CAAC,MAAuB;IACjE,OAAO,yBAAyB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC;AAC5D,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,+BAA+B,CAC7C,OAAuB,EAAE,KAAK,EAAE,EAAE,EAAE;IAEpC,OAAO,6BAA6B,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC;AAC9D,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gCAAgC,CAC9C,OAA4B,EAAE;IAE9B,OAAO,8BAA8B,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC;AAC/D,CAAC"}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@specglass/core",
+  "version": "0.0.2",
+  "description": "Astro integration, config system, content collections, and OpenAPI spec parsing for Specglass",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Not-Diamond/ndocs.git",
+    "directory": "packages/core"
+  },
+  "homepage": "https://github.com/Not-Diamond/ndocs#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./pages/*": "./src/pages/*"
+  },
+  "files": [
+    "dist",
+    "src/pages"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "lint": "eslint src/"
+  },
+  "peerDependencies": {
+    "@astrojs/mdx": "^4.0",
+    "astro": "^5.17"
+  },
+  "dependencies": {
+    "@redocly/openapi-core": "^2.18.1",
+    "@types/hast": "^3.0.4",
+    "acorn": "^8.14",
+    "astro-integration-kit": "^0.19.1",
+    "jiti": "^2.6",
+    "unist-util-visit": "^5.1.0",
+    "zod": "^3.23"
+  },
+  "devDependencies": {
+    "astro": "^5.17",
+    "pagefind": "^1.4.0",
+    "typescript": "^5.5",
+    "vitest": "^3.0"
+  }
+}

package/src/pages/[...slug].astro

@@ -0,0 +1,55 @@
+---
+import { getCollection, render } from "astro:content";
+import { getSlugFromFilePath } from "@specglass/core";
+import { config } from "virtual:specglass/config";
+import { navigation } from "virtual:specglass/navigation";
+import DocPage from "@specglass/theme-default/layouts/DocPage.astro";
+import LandingPage from "@specglass/theme-default/layouts/LandingPage.astro";
+
+export async function getStaticPaths() {
+  const docs = await getCollection("docs");
+  return docs.map((entry) => {
+    const slug = getSlugFromFilePath(entry.id);
+    return {
+      params: { slug: slug || undefined },
+      props: { entry },
+    };
+  });
+}
+
+const { entry } = Astro.props;
+
+if (!entry) {
+  return Astro.redirect("/404");
+}
+
+const { Content, headings } = await render(entry);
+const title = entry.data.title ?? config.site?.title ?? "specglass";
+const description = entry.data.description ?? config.site?.description ?? "";
+const currentSlug = getSlugFromFilePath(entry.id) || "";
+const layout = (entry.data as Record<string, unknown>).layout as string | undefined;
+---
+
+{
+  layout === "landing" ? (
+    <LandingPage
+      title={title}
+      description={description}
+      frontmatter={entry.data}
+      navigation={navigation}
+    >
+      <Content />
+    </LandingPage>
+  ) : (
+    <DocPage
+      title={title}
+      description={description}
+      frontmatter={entry.data}
+      navigation={navigation}
+      headings={headings}
+      currentSlug={currentSlug}
+    >
+      <Content />
+    </DocPage>
+  )
+}

package/src/pages/api-reference/[...slug].astro

@@ -0,0 +1,67 @@
+---
+/**
+ * API Reference route page.
+ * Generates one page per endpoint from the virtual:specglass/openapi-data module.
+ * Maps parsed OpenAPI data into ApiReferencePage layout props.
+ */
+import type { ParsedOpenApiSpec, ApiEndpoint } from "@specglass/core";
+import { buildEndpointSlug } from "@specglass/core";
+import { config } from "virtual:specglass/config";
+import { navigation } from "virtual:specglass/navigation";
+import { openApiData } from "virtual:specglass/openapi-data";
+import ApiReferencePage from "@specglass/theme-default/layouts/ApiReferencePage.astro";
+
+export async function getStaticPaths() {
+  const allSpecs = openApiData as ParsedOpenApiSpec[];
+  const paths: Array<{
+    params: { slug: string | undefined };
+    props: {
+      endpoint: ApiEndpoint;
+      allEndpoints: ApiEndpoint[];
+      specInfo: ParsedOpenApiSpec["info"];
+      securitySchemes: ParsedOpenApiSpec["securitySchemes"];
+    };
+  }> = [];
+
+  for (const spec of allSpecs) {
+    for (const endpoint of spec.endpoints) {
+      const slug = buildEndpointSlug(endpoint);
+      paths.push({
+        params: { slug },
+        props: {
+          endpoint,
+          allEndpoints: spec.endpoints,
+          specInfo: spec.info,
+          securitySchemes: spec.securitySchemes,
+        },
+      });
+    }
+
+    // Index page: render the first endpoint at /api-reference
+    if (spec.endpoints.length > 0) {
+      paths.push({
+        params: { slug: undefined },
+        props: {
+          endpoint: spec.endpoints[0],
+          allEndpoints: spec.endpoints,
+          specInfo: spec.info,
+          securitySchemes: spec.securitySchemes,
+        },
+      });
+    }
+  }
+
+  return paths;
+}
+
+const { endpoint, allEndpoints, specInfo, securitySchemes } = Astro.props;
+---
+
+<ApiReferencePage
+  endpoint={endpoint}
+  navigation={navigation}
+  config={config}
+  allEndpoints={allEndpoints}
+  specInfo={specInfo}
+  securitySchemes={securitySchemes}
+/>