polen 0.11.0-next.14 → 0.11.0-next.16

package/src/template/server/main.ts

@@ -1,30 +1,30 @@
 import { serve } from '@hono/node-server' // TODO: support non-node platforms.
+import { Path } from '@wollybeard/kit'
 import { neverCase } from '@wollybeard/kit/language'
-import PROJECT_DATA from 'virtual:polen/project/data.jsonsuper'
+import { templateConfig } from 'virtual:polen/project/config'
 import { createApp } from './app.js'
-import { generate } from './ssg/generate.js'
-import { view } from './view.js'
 
 if (__BUILDING__) {
   switch (__BUILD_ARCHITECTURE__) {
     case `ssg`:
-      await generate(view)
-      break
     case `ssr`:
-      const port = process.env[`PORT`] ? parseInt(process.env[`PORT`]) : PROJECT_DATA.server.port
+      const port = process.env[`PORT`] ? parseInt(process.env[`PORT`]) : templateConfig.server.port
       const app = createApp({
         paths: {
           assets: {
-            directory: PROJECT_DATA.paths.project.relative.build.relative.assets.root,
-            route: PROJECT_DATA.server.routes.assets,
+            directory: Path.join(
+              templateConfig.paths.project.relative.build.root,
+              templateConfig.paths.project.relative.build.relative.assets.root,
+            ),
+            route: templateConfig.server.routes.assets,
           },
-          base: PROJECT_DATA.basePath,
+          base: templateConfig.build.base,
         },
       })
       serve({ fetch: app.fetch, port })
       break
     case `spa`:
-      throw new Error(`Sorry, SPA build type not supported`)
+      throw new Error(`SPA build type not yet supported.`)
     default:
       neverCase(__BUILD_ARCHITECTURE__)
   }

package/src/template/server/view.ts

@@ -1,7 +1,9 @@
 import { createStaticHandler } from 'react-router'
-import PROJECT_DATA from 'virtual:polen/project/data.jsonsuper'
+import { templateConfig } from 'virtual:polen/project/config'
 import { routes } from '../routes.js'
 
 export const view = createStaticHandler(routes, {
-  basename: PROJECT_DATA.basePath === `/` ? undefined : PROJECT_DATA.basePath.slice(0, -1), // Remove trailing slash for React Router
+  ...(templateConfig.build.base !== '/' && {
+    basename: templateConfig.build.base.slice(0, -1), // Remove trailing slash for React Router
+  }),
 })

package/src/template/stores/$$.ts

@@ -4,6 +4,9 @@ export { store as schema } from './schema.js'
 export * as Toast from './toast.js'
 export { store as toast } from './toast.js'
 
+export * as Changelog from './changelog.js'
+export { store as changelog } from './changelog.js'
+
 export interface Store {
   reset: () => void
   set: (data?: unknown) => void

package/src/template/stores/changelog.ts

@@ -0,0 +1,87 @@
+import { Revision } from '#lib/revision/$'
+import { Schema as SchemaLib } from '#lib/schema/$'
+import { Version } from '#lib/version/$'
+import { Schema as S } from 'effect'
+import { proxy } from 'valtio'
+
+// ============================================================================
+// Schema Definitions
+// ============================================================================
+
+/**
+ * State for each version - what revision is currently selected
+ */
+export const VersionState = S.Struct({
+  currentRevision: S.NullOr(Revision.Revision),
+})
+
+export type VersionState = S.Schema.Type<typeof VersionState>
+
+/**
+ * The changelog page state schema
+ */
+export const State = S.Struct({
+  // Using a plain object instead of HashMap for valtio compatibility
+  // Keys are Version.encodeSync() results
+  versionMemory: S.Record({
+    key: S.String,
+    value: VersionState,
+  }),
+})
+
+export type State = S.Schema.Type<typeof State>
+
+// ============================================================================
+// Initial State
+// ============================================================================
+
+export const initialState: State = {
+  versionMemory: {},
+}
+
+// ============================================================================
+// Store
+// ============================================================================
+
+/**
+ * Changelog store
+ *
+ * Manages navigation state for the changelog page, remembering
+ * which revision was selected for each version during the session.
+ */
+export const store = proxy({
+  ...initialState,
+
+  /**
+   * Remember the current revision for a version
+   */
+  rememberRevision(schema: SchemaLib.Versioned.Versioned, revision: Revision.Revision | null) {
+    const versionKey = Version.encodeSync(schema.version)
+    store.versionMemory = {
+      ...store.versionMemory,
+      [versionKey]: { currentRevision: revision },
+    }
+  },
+
+  /**
+   * Get the remembered revision for a version
+   */
+  getRememberedRevision(schema: SchemaLib.Versioned.Versioned): Revision.Revision | null {
+    const versionKey = Version.encodeSync(schema.version)
+    return store.versionMemory[versionKey]?.currentRevision ?? null
+  },
+
+  /**
+   * Reset store to initial state
+   */
+  reset() {
+    Object.assign(store, initialState)
+  },
+
+  /**
+   * Set store state
+   */
+  set(data: State) {
+    Object.assign(store, data)
+  },
+})

package/src/template/stores/schema.ts

@@ -1,27 +1,39 @@
+import { Schema as S } from 'effect'
 import type { GraphQLSchema } from 'graphql'
 import { proxy, ref } from 'valtio'
 
+// ============================================================================
+// Schema Definitions
+// ============================================================================
+
 /**
- * Schema store state interface
+ * Schema store state
  */
-export interface State {
+export const State = S.Struct({
   /** Currently selected schema version */
-  currentVersion: string
+  currentVersion: S.String,
   /** All available schema versions */
-  availableVersions: string[]
+  availableVersions: S.mutable(S.Array(S.String)),
   /** Currently loaded GraphQL schema instance */
-  currentSchema: GraphQLSchema | null
-}
+  currentSchema: S.NullOr(S.Any), // GraphQL schema is too complex to model
+})
+
+export type State = S.Schema.Type<typeof State>
+
+// ============================================================================
+// Initial State
+// ============================================================================
 
-/**
- * Initial state for the schema store
- */
 export const initialState: State = {
   currentVersion: 'latest',
   availableVersions: [],
   currentSchema: null,
 }
 
+// ============================================================================
+// Store
+// ============================================================================
+
 /**
  * Schema store
  *
@@ -43,7 +55,6 @@ export const store = proxy({
    * @param data - New state data
    */
   set(data: State) {
-    // Set each property individually to avoid issues with complex objects
     store.currentVersion = data.currentVersion
     store.availableVersions = data.availableVersions
     // Use ref() to prevent Valtio from deeply proxying the GraphQL schema

package/src/template/stores/toast.ts

@@ -1,63 +1,82 @@
+import { Schema as S } from 'effect'
 import { proxy } from 'valtio'
 
+// ============================================================================
+// Schema Definitions
+// ============================================================================
+
 /**
- * Toast notification types
+ * Toast notification types schema
  */
-export const Type = {
-  info: 'info',
-  success: 'success',
-  warning: 'warning',
-  error: 'error',
-} as const
+export const Type = S.Enums(
+  {
+    Info: 'info',
+    Success: 'success',
+    Warning: 'warning',
+    Error: 'error',
+  } as const,
+)
+export type Type = S.Schema.Type<typeof Type>
+
+/**
+ * Toast action schema
+ */
+export const ToastAction = S.Struct({
+  /** Action button label */
+  label: S.String,
+  /** Action button click handler */
+  onClick: S.Any, // Functions can't be validated
+})
 
-export type Type = typeof Type[keyof typeof Type]
+export type ToastAction = S.Schema.Type<typeof ToastAction>
 
 /**
- * Toast notification interface
+ * Toast notification schema
  */
-export interface Toast {
+export const Toast = S.Struct({
   /** Unique identifier for the toast */
-  id: string
+  id: S.String,
   /** Primary message text */
-  message: string
+  message: S.String,
   /** Optional secondary description text */
-  description?: string
+  description: S.optional(S.String),
   /** Visual type/variant of the toast */
-  type?: Type
+  type: S.optional(Type),
   /** Duration in milliseconds before auto-dismiss. Set to 0 to disable auto-dismiss */
-  duration?: number
+  duration: S.optional(S.Number),
   /** Optional action buttons configuration */
-  actions: {
-    /** Action button label */
-    label: string
-    /** Action button click handler */
-    onClick: () => void
-  }[]
-}
+  actions: S.Array(ToastAction),
+})
+
+export type Toast = S.Schema.Type<typeof Toast>
 
 /**
- * Toast store state interface
+ * Toast store state
  */
-export interface State {
+export const State = S.Struct({
   /** Array of active toast notifications */
-  toasts: Toast[]
-}
+  toasts: S.mutable(S.Array(Toast)),
+})
+
+export type State = S.Schema.Type<typeof State>
+
+// ============================================================================
+// Initial State & Defaults
+// ============================================================================
 
-/**
- * Initial state for the toast store
- */
 export const initialState: State = {
   toasts: [],
 }
 
-/**
- * Default values for toast properties
- */
 const toastDefaults = {
   duration: 5000,
   actions: [],
 } satisfies Partial<Toast>
 
+// ============================================================================
+// Store
+// ============================================================================
+
 /**
  * Toast notification store
  *
@@ -89,7 +108,7 @@ export const store = proxy({
    */
   remove(id: string): void {
     const index = store.toasts.findIndex(t => t.id === id)
-    if (index > -1) {
+    if (index !== -1) {
       store.toasts.splice(index, 1)
     }
   },
@@ -116,7 +135,7 @@ export const store = proxy({
    * @returns Generated toast ID
    */
   info(message: string, options?: InputOptions) {
-    return store.add({ ...toastDefaults, ...options, message, type: Type.info })
+    return store.add({ ...toastDefaults, ...options, message, type: Type.enums.Info })
   },
 
   /**
@@ -126,7 +145,7 @@ export const store = proxy({
    * @returns Generated toast ID
    */
   success(message: string, options?: InputOptions) {
-    return store.add({ ...toastDefaults, ...options, message, type: Type.success })
+    return store.add({ ...toastDefaults, ...options, message, type: Type.enums.Success })
   },
 
   /**
@@ -136,7 +155,7 @@ export const store = proxy({
    * @returns Generated toast ID
    */
   warning(message: string, options?: InputOptions) {
-    return store.add({ ...toastDefaults, ...options, message, type: Type.warning })
+    return store.add({ ...toastDefaults, ...options, message, type: Type.enums.Warning })
   },
 
   /**
@@ -146,7 +165,7 @@ export const store = proxy({
    * @returns Generated toast ID
    */
   error(message: string, options?: InputOptions) {
-    return store.add({ ...toastDefaults, ...options, message, type: Type.error })
+    return store.add({ ...toastDefaults, ...options, message, type: Type.enums.Error })
   },
 })
 

package/src/template/theme/swiss-sharp.css

@@ -0,0 +1,117 @@
+/**
+ * Swiss Sharp Theme - CSS Variable Overrides
+ *
+ * Implements a sharp, minimal design system inspired by Swiss International Style.
+ * Features: extreme typography contrast, sharp corners, mathematical spacing.
+ *
+ * This theme respects Radix UI's light/dark mode switching by NOT overriding color variables.
+ * Only structural and typographic properties are customized.
+ */
+
+/* Ensure body background matches theme background */
+:root,
+body {
+    background-color: var(--color-background, white);
+    padding: 0;
+    margin: 0;
+}
+
+/* Dark mode body background */
+:is(.dark, .dark-theme) body {
+    background-color: var(--color-background, #111111);
+}
+
+/* Apply to both light and dark theme modes */
+.radix-themes,
+.light,
+.light-theme,
+.dark,
+.dark-theme {
+    /* ============================================================================
+   * Typography - Sharp & Extreme Contrast
+   * ============================================================================ */
+
+    /* Font families - clean sans-serif */
+    --default-font-family:
+        "Inter", -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
+    --heading-font-family:
+        "Inter", -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
+    --code-font-family:
+        "SF Mono", "Monaco", "Inconsolata", "Fira Code", monospace;
+
+    /* Font adjustments for impact */
+    --heading-font-size-adjust: 1.05;
+    --heading-letter-spacing: -0.04em;
+    --heading-line-height: 0.9;
+
+    /* Weight system - extreme contrast */
+    --font-weight-light: 200;
+    --font-weight-regular: 400;
+    --font-weight-medium: 500;
+    --font-weight-bold: 900;
+
+    /* Letter spacing - tighter for sharpness */
+    --letter-spacing-1: 0.04em;
+    --letter-spacing-2: 0.02em;
+    --letter-spacing-3: 0em;
+    --letter-spacing-4: -0.01em;
+    --letter-spacing-5: -0.02em;
+    --letter-spacing-6: -0.025em;
+    --letter-spacing-7: -0.03em;
+    --letter-spacing-8: -0.035em;
+    --letter-spacing-9: -0.04em;
+
+    /* ============================================================================
+   * Accent Color - Sharp Blue
+   * ============================================================================ */
+
+    /* Override accent with a sharp blue - works in both light and dark */
+    --accent-9: #0055ff;
+    --accent-10: #0044dd;
+    --accent-11: #0033bb;
+
+    /* ============================================================================
+   * Spacing - Using Radix defaults to avoid breaking components
+   * ============================================================================ */
+
+    /* Removed custom spacing - was breaking dropdown and other component layouts */
+
+    /* ============================================================================
+   * Radius - All Sharp (Zero Radius)
+   * ============================================================================ */
+
+    --radius-1: 0px;
+    --radius-2: 0px;
+    --radius-3: 0px;
+    --radius-4: 0px;
+    --radius-5: 0px;
+    --radius-6: 0px;
+    --radius-full: 0px;
+    --radius-thumb: 0px;
+
+    /* ============================================================================
+   * Shadows - Minimal & Sharp
+   * ============================================================================ */
+
+    /* Minimal shadows - using semi-transparent blacks for theme compatibility */
+    --shadow-1: 0 1px 0 0 rgba(0, 0, 0, 0.05);
+    --shadow-2: 0 2px 0 0 rgba(0, 0, 0, 0.1);
+    --shadow-3: 0 4px 0 0 rgba(0, 0, 0, 0.15);
+    --shadow-4: 0 8px 0 0 rgba(0, 0, 0, 0.2);
+    --shadow-5: 0 12px 0 0 rgba(0, 0, 0, 0.25);
+    --shadow-6: 0 16px 0 0 rgba(0, 0, 0, 0.3);
+
+    /* ============================================================================
+   * Cursors - Minimal
+   * ============================================================================ */
+
+    --cursor-button: pointer;
+    --cursor-checkbox: pointer;
+    --cursor-disabled: not-allowed;
+    --cursor-link: pointer;
+    --cursor-menu-item: pointer;
+    --cursor-radio: pointer;
+    --cursor-slider-thumb: grab;
+    --cursor-slider-thumb-active: grabbing;
+    --cursor-switch: pointer;
+}

package/src/template/theme/swiss-sharp.ts

@@ -0,0 +1,14 @@
+import type { ThemeProps } from '@radix-ui/themes'
+
+/**
+ * Swiss Sharp Theme Configuration
+ *
+ * A minimal, sharp design system inspired by Swiss International Style.
+ * Features mathematical grids, extreme typography contrast, and monochromatic palette.
+ */
+export const swissSharpTheme: Partial<ThemeProps> = {
+  accentColor: 'blue',
+  grayColor: 'gray',
+  radius: 'none',
+  panelBackground: 'solid',
+}

package/src/types/global-constants.d.ts

@@ -0,0 +1,36 @@
+// Global build-time constants injected by Vite
+
+/**
+ * Indicates whether the code is running during a production build.
+ * - `true` when running `polen build` command
+ * - `false` when running `polen dev` command
+ */
+declare const __BUILDING__: boolean
+
+/**
+ * Convenience boolean for checking if using Static Site Generation (SSG) architecture.
+ * - `true` when `__BUILD_ARCHITECTURE__ === 'ssg'`
+ * - `false` otherwise
+ */
+declare const __BUILD_ARCHITECTURE_SSG__: boolean
+
+/**
+ * The build architecture configured for the project.
+ * - `'ssg'` for Static Site Generation (default)
+ * - `'ssr'` for Server-Side Rendering (future support)
+ */
+declare const __BUILD_ARCHITECTURE__: import('#api/config/input').BuildArchitecture
+
+/**
+ * Indicates whether the code is running in development server mode.
+ * - `true` when running `polen dev` command
+ * - `false` when running `polen build` command
+ */
+declare const __SERVING__: boolean
+
+/**
+ * The raw Vite command being executed.
+ * - `'build'` for production builds
+ * - `'serve'` for development server
+ */
+declare const __COMMAND__: import('#dep/vite/index').Vite.ConfigEnv[`command`]

package/src/types/global.d.ts

@@ -0,0 +1,17 @@
+// Global window properties
+import type { GraphQLSchema } from 'graphql'
+import type { RouterState } from 'react-router'
+import type { PolenGlobalData } from '../template/constants'
+
+declare global {
+  var __POLEN__: PolenGlobalData
+
+  interface Window {
+    __polenCacheSchema?: GraphQLSchema | undefined
+    __staticRouterHydrationData?:
+      | Partial<
+        Pick<RouterState, `loaderData` | `actionData` | `errors`>
+      >
+      | undefined
+  }
+}

package/src/types/virtual-modules.d.ts

@@ -0,0 +1,48 @@
+declare module 'virtual:polen/vite/client/manifest' {
+  const manifest: import('vite').Manifest
+  export default manifest
+}
+
+declare module 'virtual:polen/project/routes.jsx' {
+  export const routes: import('#vite/plugins/core').ProjectRoutesModule['routes']
+}
+
+declare module 'virtual:polen/project/assets/logo.svg' {
+  const logo: {
+    light: string
+    dark: string
+    mode: 'single' | 'dual'
+    designedFor: 'light' | 'dark'
+  }
+  export default logo
+}
+
+declare module 'virtual:polen/project/assets/hero' {
+  const src: string | null
+  export default src
+}
+
+declare module 'virtual:polen/project/schemas' {
+  export const schemasCatalog: import('#lib/catalog/$').Catalog.Catalog | null
+}
+
+declare module 'virtual:polen/project/pages' {
+  export const pagesCatalog: import('#vite/plugins/pages').ProjectPagesCatalog
+}
+
+declare module 'virtual:polen/project/examples' {
+  export const examplesCatalog: import('#api/examples/$').Examples.Catalog.Catalog
+  export const IndexComponent: React.ComponentType | null
+}
+
+declare module 'virtual:polen/project/config' {
+  export const templateConfig: import('#api/config-template/template').TemplateConfig
+}
+
+declare module 'virtual:polen/project/navbar' {
+  export const navbar: import('#api/content/navbar').NavbarItem[]
+}
+
+declare module 'virtual:polen/project/hooks' {
+  export const navbar: ((props: import('#api/hooks/types').NavbarProps) => React.ReactNode) | null
+}

package/src/vite/config.ts

@@ -0,0 +1,27 @@
+import type { Api } from '#api/$'
+import { Vite } from '#dep/vite/index'
+import { Main } from './plugins/main.js'
+
+/**
+ * Transform Polen config into a Vite configuration.
+ */
+export const toViteUserConfig = (
+  config: Api.Config.Config,
+): ViteUserConfigWithPolen => {
+  const viteUserConfigFromPolen: Vite.UserConfig = {
+    base: config.build.base,
+    plugins: [Main(config)],
+  }
+
+  const viteUserConfigMerged = (config.advanced.vite
+    ? Vite.mergeConfig(viteUserConfigFromPolen, config.advanced.vite)
+    : viteUserConfigFromPolen) as ViteUserConfigWithPolen
+
+  viteUserConfigMerged._polen = config
+
+  return viteUserConfigMerged
+}
+
+export interface ViteUserConfigWithPolen extends Vite.UserConfig {
+  _polen: Api.Config.Config
+}

package/src/vite/index.ts

@@ -0,0 +1,5 @@
+export * from './config.js'
+export * from './log-filters.js'
+export * from './logger.js'
+export * from './plugins/index.js'
+export * from './vi.js'