polen 0.11.0-next.10 → 0.11.0-next.11

package/build/template/server/ssg/get-route-paths.js

@@ -19,43 +19,75 @@ export const getRoutesPaths = async () => {
     const paths = new Set();
     const routeExpressions = ReactRouterAid.getRouteExpressions(routes);
     // Helper function to load schema from filesystem and add type paths
-    const addTypePathsForVersion = async (version, pathPrefix, includeFields = false) => {
+    const addTypePathsForVersion = async (version, includeFields = false) => {
         try {
             const schemaFilePath = NodePath.join(PROJECT_DATA.paths.project.absolute.build.assets.schemas, `${version}.json`);
             const schemaContent = await NodeFs.readFile(schemaFilePath, 'utf-8');
             const schemaAst = JSON.parse(schemaContent);
             visit(schemaAst, {
                 ObjectTypeDefinition(node) {
-                    const typePath = `${pathPrefix}/${node.name.value}`;
+                    const typePath = Api.Schema.Routing.createReferencePath({
+                        version: version === Api.Schema.VERSION_LATEST ? undefined : version,
+                        type: node.name.value,
+                    });
                     paths.add(typePath);
                     // Add field paths if requested
                     if (includeFields && node.fields) {
                         for (const field of node.fields) {
-                            paths.add(`${typePath}/${field.name.value}`);
+                            const fieldPath = Api.Schema.Routing.createReferencePath({
+                                version: version === Api.Schema.VERSION_LATEST ? undefined : version,
+                                type: node.name.value,
+                                field: field.name.value,
+                            });
+                            paths.add(fieldPath);
                         }
                     }
                 },
                 InterfaceTypeDefinition(node) {
-                    const typePath = `${pathPrefix}/${node.name.value}`;
+                    const typePath = Api.Schema.Routing.createReferencePath({
+                        version: version === Api.Schema.VERSION_LATEST ? undefined : version,
+                        type: node.name.value,
+                    });
                     paths.add(typePath);
                     // Add field paths if requested
                     if (includeFields && node.fields) {
                         for (const field of node.fields) {
-                            paths.add(`${typePath}/${field.name.value}`);
+                            const fieldPath = Api.Schema.Routing.createReferencePath({
+                                version: version === Api.Schema.VERSION_LATEST ? undefined : version,
+                                type: node.name.value,
+                                field: field.name.value,
+                            });
+                            paths.add(fieldPath);
                         }
                     }
                 },
                 EnumTypeDefinition(node) {
-                    paths.add(`${pathPrefix}/${node.name.value}`);
+                    const typePath = Api.Schema.Routing.createReferencePath({
+                        version: version === Api.Schema.VERSION_LATEST ? undefined : version,
+                        type: node.name.value,
+                    });
+                    paths.add(typePath);
                 },
                 InputObjectTypeDefinition(node) {
-                    paths.add(`${pathPrefix}/${node.name.value}`);
+                    const typePath = Api.Schema.Routing.createReferencePath({
+                        version: version === Api.Schema.VERSION_LATEST ? undefined : version,
+                        type: node.name.value,
+                    });
+                    paths.add(typePath);
                 },
                 UnionTypeDefinition(node) {
-                    paths.add(`${pathPrefix}/${node.name.value}`);
+                    const typePath = Api.Schema.Routing.createReferencePath({
+                        version: version === Api.Schema.VERSION_LATEST ? undefined : version,
+                        type: node.name.value,
+                    });
+                    paths.add(typePath);
                 },
                 ScalarTypeDefinition(node) {
-                    paths.add(`${pathPrefix}/${node.name.value}`);
+                    const typePath = Api.Schema.Routing.createReferencePath({
+                        version: version === Api.Schema.VERSION_LATEST ? undefined : version,
+                        type: node.name.value,
+                    });
+                    paths.add(typePath);
                 },
             });
         }
@@ -70,28 +102,29 @@ export const getRoutesPaths = async () => {
         if (exp === knownParameterizedRouteExpressions.reference_type) {
             if (hasSchema) {
                 // Add paths for latest version (no version in URL)
-                await addTypePathsForVersion(Api.Schema.VERSION_LATEST, `/reference`);
+                await addTypePathsForVersion(Api.Schema.VERSION_LATEST);
             }
         }
         else if (exp === knownParameterizedRouteExpressions.reference_version) {
             if (hasSchema) {
                 // Add paths for version pages themselves (without type)
                 for (const version of availableVersions) {
-                    paths.add(`/reference/version/${version}`);
+                    const versionPath = Api.Schema.Routing.createReferenceBasePath(version);
+                    paths.add(versionPath);
                 }
             }
         }
         else if (exp === knownParameterizedRouteExpressions.reference_type_field) {
             if (hasSchema) {
                 // Add paths for latest version fields
-                await addTypePathsForVersion(Api.Schema.VERSION_LATEST, `/reference`, true);
+                await addTypePathsForVersion(Api.Schema.VERSION_LATEST, true);
             }
         }
         else if (exp === knownParameterizedRouteExpressions.reference_versioned_type) {
             if (hasSchema) {
                 // Add paths for all versions using new route structure
                 for (const version of availableVersions) {
-                    await addTypePathsForVersion(version, `/reference/version/${version}`);
+                    await addTypePathsForVersion(version);
                 }
             }
         }
@@ -99,7 +132,7 @@ export const getRoutesPaths = async () => {
             if (hasSchema) {
                 // Add paths for all versions with fields
                 for (const version of availableVersions) {
-                    await addTypePathsForVersion(version, `/reference/version/${version}`, true);
+                    await addTypePathsForVersion(version, true);
                 }
             }
         }

package/build/template/server/ssg/get-route-paths.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-route-paths.js","sourceRoot":"","sources":["../../../../src/template/server/ssg/get-route-paths.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"get-route-paths.js","sourceRoot":"","sources":["../../../../src/template/server/ssg/get-route-paths.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "polen",
-  "version": "0.11.0-next.10",
+  "version": "0.11.0-next.11",
   "type": "module",
   "description": "A framework for delightful GraphQL developer portals",
   "author": {
@@ -35,6 +35,9 @@
     "#*": {
       "default": "./build/*.js"
     },
+    "#api/iso": {
+      "default": "./build/api/iso/$.js"
+    },
     "#lib/mask": {
       "default": "./build/lib/mask/$.js"
     },

package/src/api/api.ts

@@ -1,6 +1,12 @@
+// Re-export everything from isomorphic layer
+export * from './iso/$$.js'
+
+// Server-only exports
 export * from './builder/index.js'
 export * from './config-resolver/index.js'
 export * from './config/index.js'
 export * as Project from './project/index.js'
-export * from './schema/index.js'
 export * from './static/index.js'
+
+// Re-export schema with server-only extensions
+export { Schema } from './schema/index.js'

package/src/api/iso/$$.ts

@@ -0,0 +1 @@
+export * from './schema/$.js'

package/src/api/iso/$.ts

@@ -0,0 +1 @@
+export * as Api from './$$.js'

package/src/api/iso/schema/$$.ts

@@ -0,0 +1,5 @@
+export * from './constants.js'
+export * as Routing from './routing.js'
+
+// Re-export types from server layer that are needed in template
+export type { ChangelogData, ChangeSets, NonEmptyChangeSets } from '../../schema/schema.js'

package/src/api/iso/schema/$.ts

@@ -0,0 +1 @@
+export * as Schema from './$$.js'

package/src/api/iso/schema/constants.ts

@@ -0,0 +1,49 @@
+/**
+ * Constants for schema versioning
+ */
+
+/**
+ * The version identifier for the latest schema
+ */
+export const VERSION_LATEST = `latest`
+
+/**
+ * Fallback version name when date parsing fails
+ */
+export const VERSION_UNKNOWN_FALLBACK = `unknown`
+
+/**
+ * Convert a date to a version string in YYYY-MM-DD format
+ */
+export const dateToVersionString = (date: Date): string => {
+  return date.toLocaleDateString('en-CA')
+}
+
+/**
+ * Convert a version string back to a Date
+ */
+export const versionStringToDate = (version: string): Date => {
+  if (version === VERSION_LATEST) {
+    return new Date()
+  }
+
+  // Use modern date parsing - the version string should be in YYYY-MM-DD format
+  // which is ISO 8601 compatible
+  const parsedDate = new Date(version + 'T00:00:00Z')
+
+  // Check if the date is valid
+  if (!isNaN(parsedDate.getTime())) {
+    return parsedDate
+  }
+
+  // Throw error for invalid dates instead of silently defaulting
+  throw new Error(`Invalid version string: ${version}`)
+}
+
+/**
+ * Determine if a version at the given index should have a changelog file.
+ * Only non-oldest versions get changelog files.
+ */
+export const shouldVersionHaveChangelog = (versionIndex: number, totalVersions: number): boolean => {
+  return versionIndex < totalVersions - 1
+}

package/src/api/iso/schema/routing.ts

@@ -0,0 +1,53 @@
+import { VERSION_LATEST } from './constants.js'
+
+export interface ReferencePathParts {
+  version?: string
+  type?: string
+  field?: string
+}
+
+export const createReferencePath = (parts: ReferencePathParts): string => {
+  const basePath = createReferenceBasePath(parts.version)
+  return joinSegmentsAndPaths(basePath, parts.type, parts.field)
+}
+
+/**
+ * Create a base path for reference pages based on the current version
+ * Used for sidebar navigation and other UI components that need version-aware paths
+ */
+export const createReferenceBasePath = (version?: string): string => {
+  return joinSegmentsAndPaths(segmentLiterals.reference, createReferenceVersionPath(version))
+}
+
+export const segmentLiterals = {
+  reference: 'reference',
+  version: 'version',
+}
+
+/**
+ * Create a base path for reference pages based on the current version
+ * Used for sidebar navigation and other UI components that need version-aware paths
+ */
+export const createReferenceVersionPath = (version?: string): string => {
+  if (version === undefined) return ''
+  return version === VERSION_LATEST
+    ? ``
+    : `/${segmentLiterals.version}/${version}`
+}
+
+export const joinSegmentsAndPaths = (
+  ...segmentsOrPaths: (string | undefined | null | (string | null | undefined)[])[]
+): string => {
+  const path = '/' + segmentsOrPaths
+    .flat()
+    .filter((_): _ is string => _ !== undefined && _ !== null)
+    .map(chunkUnformatted =>
+      chunkUnformatted
+        .replace(/^\//, '')
+        .replace(/\/$/, '')
+    )
+    .filter(Boolean)
+    .join('/')
+
+  return path
+}

package/src/api/iso.ts

@@ -0,0 +1 @@
+export * from './iso/$.js'

package/src/api/schema/schema.ts

@@ -1,10 +1,13 @@
 import type { GraphqlChangeset } from '#lib/graphql-changeset/index'
 
-export * as DataSources from './data-sources/data-sources.js'
-
-export * from './read.js'
+// Re-export everything from isomorphic layer
+export * from '../iso/schema/constants.js'
+export * as Routing from '../iso/schema/routing.js'
 
+// Server-only exports
+export * as DataSources from './data-sources/data-sources.js'
 export * from './metadata.js'
+export * from './read.js'
 
 export type ChangeSets = GraphqlChangeset.ChangeSet[]
 
@@ -17,53 +20,3 @@ export interface ChangelogData {
   changes: GraphqlChangeset.ChangeSet['changes']
   date: string
 }
-
-/**
- * Constants for schema versioning
- */
-
-/**
- * The version identifier for the latest schema
- */
-export const VERSION_LATEST = `latest`
-
-/**
- * Fallback version name when date parsing fails
- */
-export const VERSION_UNKNOWN_FALLBACK = `unknown`
-
-/**
- * Convert a date to a version string in YYYY-MM-DD format
- */
-export const dateToVersionString = (date: Date): string => {
-  return date.toLocaleDateString('en-CA')
-}
-
-/**
- * Determine if a version at the given index should have a changelog file.
- * Only non-oldest versions get changelog files.
- */
-export const shouldVersionHaveChangelog = (versionIndex: number, totalVersions: number): boolean => {
-  return versionIndex < totalVersions - 1
-}
-
-/**
- * Convert a version string back to a Date
- */
-export const versionStringToDate = (version: string): Date => {
-  if (version === VERSION_LATEST) {
-    return new Date()
-  }
-
-  // Use modern date parsing - the version string should be in YYYY-MM-DD format
-  // which is ISO 8601 compatible
-  const parsedDate = new Date(version + 'T00:00:00Z')
-
-  // Check if the date is valid
-  if (!isNaN(parsedDate.getTime())) {
-    return parsedDate
-  }
-
-  // Throw error for invalid dates instead of silently defaulting
-  throw new Error(`Invalid version string: ${version}`)
-}

package/src/api/vite/plugins/core.ts

@@ -1,22 +1,18 @@
 import type { Config } from '#api/config/index'
 import { Content } from '#api/content/$'
 import { createNavbar } from '#api/content/navbar'
+import { Api } from '#api/index'
 import { VitePluginSelfContainedMode } from '#cli/_/self-contained-mode'
-import { Hono } from '#dep/hono/index'
 import type { ReactRouter } from '#dep/react-router/index'
 import type { Vite } from '#dep/vite/index'
 import { VitePluginJson } from '#lib/vite-plugin-json/index'
 import { ViteVirtual } from '#lib/vite-virtual/index'
 import { debugPolen } from '#singletons/debug'
 import { superjson } from '#singletons/superjson'
-import * as HonoNodeServer from '@hono/node-server'
-import { serveStatic } from '@hono/node-server/serve-static'
 import { Json, Str } from '@wollybeard/kit'
-import * as NodePath from 'node:path'
 import type { ProjectData } from '../../../project-data.js'
 import { SchemaAugmentation } from '../../schema-augmentation/index.js'
 import { Schema } from '../../schema/index.js'
-import { createLogger } from '../logger.js'
 import { polenVirtual } from '../vi.js'
 import { Pages } from './pages.js'
 import { SchemaAssets } from './schema-assets.js'
@@ -201,7 +197,8 @@ export const Core = (config: Config.Config): Vite.PluginOption[] => {
               // Without the leading slash, React Router treats paths as relative, which causes
               // hydration mismatches between SSR (where base path is prepended) and client
               // (where basename is configured). This ensures consistent behavior.
-              navbar.push({ pathExp: `/reference`, title: `Reference` })
+              const referencePath = Api.Schema.Routing.createReferenceBasePath()
+              navbar.push({ pathExp: referencePath, title: `Reference` })
               if (schemaResult.data.length > 1) {
                 navbar.push({ pathExp: `/changelog`, title: `Changelog` })
               }

package/src/template/components/GraphQLInteractive/lib/parser.ts

@@ -5,6 +5,7 @@
  * analysis to create unified tokens for interactive code blocks.
  */
 
+import { Api } from '#api/iso'
 import type { CodeAnnotation } from 'codehike/code'
 import {
   getNamedType,
@@ -14,7 +15,6 @@ import {
   GraphQLInputObjectType,
   GraphQLInterfaceType,
   GraphQLObjectType,
-  type GraphQLOutputType,
   GraphQLScalarType,
   type GraphQLSchema,
   GraphQLUnionType,
@@ -24,12 +24,7 @@ import {
 import graphqlWasmUrl from 'tree-sitter-graphql-grammar-wasm/grammar.wasm?url'
 import * as WebTreeSitter from 'web-tree-sitter'
 import treeSitterWasmUrl from 'web-tree-sitter/tree-sitter.wasm?url'
-import {
-  isKeywordNodeType,
-  isLiteralNodeType,
-  isPunctuationNodeType,
-  type TreeSitterGraphQLNodeType,
-} from './graphql-node-types.js'
+import { isKeywordNodeType, isPunctuationNodeType, type TreeSitterGraphQLNodeType } from './graphql-node-types.js'
 import type { SemanticNode } from './semantic-nodes.js'
 import {
   isArgument,
@@ -263,42 +258,63 @@ class UnifiedToken implements GraphQLToken {
 
     // Arguments - use #<field>__<argument> pattern
     if (isArgument(this.semantic)) {
-      return `/reference/${this.semantic.parentType.name}#${this.semantic.parentField.name}__${this.semantic.argumentDef.name}`
+      const basePath = Api.Schema.Routing.createReferencePath({
+        type: this.semantic.parentType.name,
+      })
+      return `${basePath}#${this.semantic.parentField.name}__${this.semantic.argumentDef.name}`
     }
 
     // Output fields - use hash links since field routes aren't connected yet
     if (isOutputField(this.semantic)) {
-      return `/reference/${this.semantic.parentType.name}#${this.semantic.fieldDef.name}`
+      const basePath = Api.Schema.Routing.createReferencePath({
+        type: this.semantic.parentType.name,
+      })
+      return `${basePath}#${this.semantic.fieldDef.name}`
     }
 
     // Input fields - use hash links since field routes aren't connected yet
     if (isInputField(this.semantic)) {
-      return `/reference/${this.semantic.parentType.name}#${this.semantic.fieldDef.name}`
+      const basePath = Api.Schema.Routing.createReferencePath({
+        type: this.semantic.parentType.name,
+      })
+      return `${basePath}#${this.semantic.fieldDef.name}`
     }
 
     // Type references - use :type pattern
     if (this.semantic instanceof GraphQLObjectType) {
-      return `/reference/${this.semantic.name}`
+      return Api.Schema.Routing.createReferencePath({
+        type: this.semantic.name,
+      })
     }
 
     if (this.semantic instanceof GraphQLScalarType) {
-      return `/reference/${this.semantic.name}`
+      return Api.Schema.Routing.createReferencePath({
+        type: this.semantic.name,
+      })
     }
 
     if (this.semantic instanceof GraphQLInterfaceType) {
-      return `/reference/${this.semantic.name}`
+      return Api.Schema.Routing.createReferencePath({
+        type: this.semantic.name,
+      })
     }
 
     if (this.semantic instanceof GraphQLUnionType) {
-      return `/reference/${this.semantic.name}`
+      return Api.Schema.Routing.createReferencePath({
+        type: this.semantic.name,
+      })
     }
 
     if (this.semantic instanceof GraphQLEnumType) {
-      return `/reference/${this.semantic.name}`
+      return Api.Schema.Routing.createReferencePath({
+        type: this.semantic.name,
+      })
     }
 
     if (this.semantic instanceof GraphQLInputObjectType) {
-      return `/reference/${this.semantic.name}`
+      return Api.Schema.Routing.createReferencePath({
+        type: this.semantic.name,
+      })
     }
 
     return null

package/src/template/components/HamburgerMenu.tsx

@@ -9,6 +9,7 @@ export interface HamburgerMenuProps {
   onToggle: () => void
   onClose: () => void
   sidebarData: Content.Item[]
+  basePath?: string
 }
 
 export const HamburgerMenu: React.FC<HamburgerMenuProps> = ({
@@ -16,6 +17,7 @@ export const HamburgerMenu: React.FC<HamburgerMenuProps> = ({
   onToggle,
   onClose,
   sidebarData,
+  basePath,
 }) => {
   // Prevent body scroll when mobile menu is open
   useEffect(() => {
@@ -87,7 +89,7 @@ export const HamburgerMenu: React.FC<HamburgerMenuProps> = ({
                 <Cross2Icon width='18' height='18' />
               </IconButton>
             </Flex>
-            <Sidebar data={sidebarData} />
+            <Sidebar data={sidebarData} basePath={basePath} />
           </Box>
         </>
       )}

package/src/template/components/ReferenceLink.tsx

@@ -1,3 +1,4 @@
+import { Api } from '#api/iso'
 import type { ReactNode } from 'react'
 import { useVersionPath } from '../hooks/useVersionPath.js'
 import { Link } from './Link.js'
@@ -21,10 +22,12 @@ interface Props {
 export const ReferenceLink = ({ type, field, children }: Props) => {
   const versionPath = useVersionPath()
 
-  let path = `/reference/${versionPath}${type}`
-  if (field) {
-    path += `/${field}`
-  }
+  const path = Api.Schema.Routing.joinSegmentsAndPaths(
+    Api.Schema.Routing.segmentLiterals.reference,
+    versionPath,
+    type,
+    field,
+  )
 
   return (
     <Link to={path}>

package/src/template/components/VersionSelector.tsx

@@ -1,13 +1,14 @@
+import { Api } from '#api/iso'
+import type { React } from '#dep/react/index'
 import { Select } from '@radix-ui/themes'
 import { useNavigate, useParams } from 'react-router'
-import { VERSION_LATEST } from '../lib/schema-utils/constants.js'
 
-interface VersionSelectorProps {
+interface Props {
   availableVersions: string[]
   currentVersion: string
 }
 
-export const VersionSelector = ({ availableVersions, currentVersion }: VersionSelectorProps) => {
+export const VersionSelector: React.FC<Props> = ({ availableVersions, currentVersion }) => {
   const navigate = useNavigate()
   const params = useParams()
 
@@ -17,20 +18,11 @@ export const VersionSelector = ({ availableVersions, currentVersion }: VersionSe
   }
 
   const handleVersionChange = (newVersion: string) => {
-    // Build new path preserving the current type/field if any
-    const currentType = params[`type`]
-    const currentField = params[`field`]
-
-    let newPath = `/reference`
-    if (newVersion !== VERSION_LATEST) {
-      newPath += `/version/${newVersion}`
-    }
-    if (currentType) {
-      newPath += `/${currentType}`
-      if (currentField) {
-        newPath += `/${currentField}`
-      }
-    }
+    const newPath = Api.Schema.Routing.createReferencePath({
+      version: newVersion,
+      type: params[`type`],
+      field: params[`field`],
+    })
 
     navigate(newPath)
   }
@@ -41,7 +33,7 @@ export const VersionSelector = ({ availableVersions, currentVersion }: VersionSe
       <Select.Content>
         {availableVersions.map(version => (
           <Select.Item key={version} value={version}>
-            {version === VERSION_LATEST ? `Latest` : version}
+            {version === Api.Schema.VERSION_LATEST ? `Latest` : version}
           </Select.Item>
         ))}
       </Select.Content>