polen 0.11.0-next.10 → 0.11.0-next.12

package/src/template/server/ssg/get-route-paths.ts

@@ -22,7 +22,7 @@ export const getRoutesPaths = async (): Promise<string[]> => {
   const routeExpressions = ReactRouterAid.getRouteExpressions(routes)
 
   // Helper function to load schema from filesystem and add type paths
-  const addTypePathsForVersion = async (version: string, pathPrefix: string, includeFields = false) => {
+  const addTypePathsForVersion = async (version: string, 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')
@@ -30,38 +30,70 @@ export const getRoutesPaths = async (): Promise<string[]> => {
 
       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)
         },
       })
     } catch (error) {
@@ -78,32 +110,33 @@ export const getRoutesPaths = async (): Promise<string[]> => {
     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)
         }
       }
     } else if (exp === knownParameterizedRouteExpressions.reference_versioned_type_field) {
       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)
         }
       }
     } else if (ReactRouterAid.isParameterizedPath(exp)) {

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

@@ -0,0 +1,15 @@
+export * as Schema from './schema.js'
+export { store as schema } from './schema.js'
+
+export * as Toast from './toast.js'
+export { store as toast } from './toast.js'
+
+export interface Store {
+  reset: () => void
+  set: (data?: unknown) => void
+}
+
+export interface StoreModule {
+  store: Store
+  initialState: unknown
+}

package/src/template/stores/$.ts

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

package/src/template/stores/schema.ts

@@ -0,0 +1,52 @@
+import type { GraphQLSchema } from 'graphql'
+import { proxy, ref } from 'valtio'
+
+/**
+ * Schema store state interface
+ */
+export interface State {
+  /** Currently selected schema version */
+  currentVersion: string
+  /** All available schema versions */
+  availableVersions: string[]
+  /** Currently loaded GraphQL schema instance */
+  currentSchema: GraphQLSchema | null
+}
+
+/**
+ * Initial state for the schema store
+ */
+export const initialState: State = {
+  currentVersion: 'latest',
+  availableVersions: [],
+  currentSchema: null,
+}
+
+/**
+ * Schema store
+ *
+ * Manages GraphQL schema state including version selection and schema instances.
+ * Used for version switching and schema-aware navigation.
+ */
+export const store = proxy({
+  ...initialState,
+
+  /**
+   * Reset store to initial state
+   */
+  reset() {
+    Object.assign(store, initialState)
+  },
+
+  /**
+   * Set store state
+   * @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
+    store.currentSchema = data.currentSchema ? ref(data.currentSchema) : null
+  },
+})

package/src/template/stores/toast.ts

@@ -0,0 +1,153 @@
+import { proxy } from 'valtio'
+
+/**
+ * Toast notification types
+ */
+export const Type = {
+  info: 'info',
+  success: 'success',
+  warning: 'warning',
+  error: 'error',
+} as const
+
+export type Type = typeof Type[keyof typeof Type]
+
+/**
+ * Toast notification interface
+ */
+export interface Toast {
+  /** Unique identifier for the toast */
+  id: string
+  /** Primary message text */
+  message: string
+  /** Optional secondary description text */
+  description?: string
+  /** Visual type/variant of the toast */
+  type?: Type
+  /** Duration in milliseconds before auto-dismiss. Set to 0 to disable auto-dismiss */
+  duration?: number
+  /** Optional action buttons configuration */
+  actions: {
+    /** Action button label */
+    label: string
+    /** Action button click handler */
+    onClick: () => void
+  }[]
+}
+
+/**
+ * Toast store state interface
+ */
+export interface State {
+  /** Array of active toast notifications */
+  toasts: Toast[]
+}
+
+/**
+ * Initial state for the toast store
+ */
+export const initialState: State = {
+  toasts: [],
+}
+
+/**
+ * Default values for toast properties
+ */
+const toastDefaults = {
+  duration: 5000,
+  actions: [],
+} satisfies Partial<Toast>
+
+/**
+ * Toast notification store
+ *
+ * Manages toast notifications with auto-dismiss functionality and type-specific convenience methods.
+ */
+export const store = proxy({
+  ...initialState,
+
+  /**
+   * Add a new toast notification
+   * @param toast - Toast configuration (id will be auto-generated)
+   * @returns Generated toast ID
+   */
+  add(toast: Omit<Toast, 'id'>): string {
+    const id = `${Date.now()}-${Math.random().toString(36).substring(2, 11)}`
+    store.toasts.push({ ...toast, id })
+
+    // Auto-remove after duration (default 5 seconds). Set duration to 0 to disable auto-dismiss
+    if (toast.duration !== 0) {
+      setTimeout(() => store.remove(id), toast.duration || toastDefaults.duration)
+    }
+
+    return id
+  },
+
+  /**
+   * Remove a toast by ID
+   * @param id - Toast ID to remove
+   */
+  remove(id: string): void {
+    const index = store.toasts.findIndex(t => t.id === id)
+    if (index > -1) {
+      store.toasts.splice(index, 1)
+    }
+  },
+
+  /**
+   * Reset store to initial state
+   */
+  reset() {
+    Object.assign(store, initialState)
+  },
+
+  /**
+   * Set store state
+   * @param data - New state data
+   */
+  set(data: State) {
+    Object.assign(store, data)
+  },
+
+  /**
+   * Show an info toast
+   * @param message - Toast message
+   * @param options - Additional toast options
+   * @returns Generated toast ID
+   */
+  info(message: string, options?: InputOptions) {
+    return store.add({ ...toastDefaults, ...options, message, type: Type.info })
+  },
+
+  /**
+   * Show a success toast
+   * @param message - Toast message
+   * @param options - Additional toast options
+   * @returns Generated toast ID
+   */
+  success(message: string, options?: InputOptions) {
+    return store.add({ ...toastDefaults, ...options, message, type: Type.success })
+  },
+
+  /**
+   * Show a warning toast
+   * @param message - Toast message
+   * @param options - Additional toast options
+   * @returns Generated toast ID
+   */
+  warning(message: string, options?: InputOptions) {
+    return store.add({ ...toastDefaults, ...options, message, type: Type.warning })
+  },
+
+  /**
+   * Show an error toast
+   * @param message - Toast message
+   * @param options - Additional toast options
+   * @returns Generated toast ID
+   */
+  error(message: string, options?: InputOptions) {
+    return store.add({ ...toastDefaults, ...options, message, type: Type.error })
+  },
+})
+
+type InputOptions = Partial<Omit<Toast, 'id' | 'message' | 'type'>>

package/src/template/utils/try-with-toast.ts

@@ -0,0 +1,41 @@
+import { Stores } from '../stores/$.js'
+
+/**
+ * Execute an async function with automatic error handling and toast notifications
+ *
+ * @param fn - Async function to execute
+ * @param errorMessage - Optional custom error message for the toast (defaults to error message)
+ * @returns Promise that resolves to null on success or Error on failure
+ */
+export const tryWithToast = async <T>(
+  fn: () => Promise<T>,
+  errorMessage?: string,
+): Promise<Error | null> => {
+  try {
+    await fn()
+    return null
+  } catch (error) {
+    // Log to console in all environments
+    console.error('Error in tryWithToast:', error)
+
+    // Determine the error message
+    const baseMessage = error instanceof Error ? error.message : String(error)
+    const toastMessage = errorMessage || baseMessage
+
+    // In development, show detailed error info
+    if (import.meta.env.DEV) {
+      Stores.Toast.store.error(toastMessage, {
+        description: error instanceof Error
+          ? `${error.name}: ${error.message}${error.stack ? '\n\nStack trace available in console.' : ''}`
+          : `Error details: ${String(error)}`,
+        duration: 10000, // Longer duration in dev for debugging
+      })
+    } else {
+      // In production, show simplified message
+      Stores.Toast.store.error(toastMessage)
+    }
+
+    // Return the error for downstream fallback logic
+    return error instanceof Error ? error : new Error(baseMessage)
+  }
+}

package/build/template/components/VersionSelector.d.ts

@@ -1,7 +0,0 @@
-interface VersionSelectorProps {
-    availableVersions: string[];
-    currentVersion: string;
-}
-export declare const VersionSelector: ({ availableVersions, currentVersion }: VersionSelectorProps) => import("react/jsx-runtime").JSX.Element | null;
-export {};
-//# sourceMappingURL=VersionSelector.d.ts.map

package/build/template/components/VersionSelector.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"VersionSelector.d.ts","sourceRoot":"","sources":["../../../src/template/components/VersionSelector.tsx"],"names":[],"mappings":"AAIA,UAAU,oBAAoB;IAC5B,iBAAiB,EAAE,MAAM,EAAE,CAAA;IAC3B,cAAc,EAAE,MAAM,CAAA;CACvB;AAED,eAAO,MAAM,eAAe,GAAI,uCAAuC,oBAAoB,mDAwC1F,CAAA"}

package/build/template/components/VersionSelector.js

@@ -1,30 +0,0 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { Select } from '@radix-ui/themes';
-import { useNavigate, useParams } from 'react-router';
-import { VERSION_LATEST } from '../lib/schema-utils/constants.js';
-export const VersionSelector = ({ availableVersions, currentVersion }) => {
-    const navigate = useNavigate();
-    const params = useParams();
-    // Don't show selector if only one version
-    if (availableVersions.length <= 1) {
-        return null;
-    }
-    const handleVersionChange = (newVersion) => {
-        // 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}`;
-            }
-        }
-        navigate(newPath);
-    };
-    return (_jsxs(Select.Root, { value: currentVersion, onValueChange: handleVersionChange, children: [_jsx(Select.Trigger, {}), _jsx(Select.Content, { children: availableVersions.map(version => (_jsx(Select.Item, { value: version, children: version === VERSION_LATEST ? `Latest` : version }, version))) })] }));
-};
-//# sourceMappingURL=VersionSelector.js.map

package/build/template/components/VersionSelector.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"VersionSelector.js","sourceRoot":"","sources":["../../../src/template/components/VersionSelector.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACzC,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAA;AAOjE,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,EAAE,iBAAiB,EAAE,cAAc,EAAwB,EAAE,EAAE;IAC7F,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAA;IAC9B,MAAM,MAAM,GAAG,SAAS,EAAE,CAAA;IAE1B,0CAA0C;IAC1C,IAAI,iBAAiB,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QAClC,OAAO,IAAI,CAAA;IACb,CAAC;IAED,MAAM,mBAAmB,GAAG,CAAC,UAAkB,EAAE,EAAE;QACjD,0DAA0D;QAC1D,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,CAAA;QAClC,MAAM,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,CAAA;QAEpC,IAAI,OAAO,GAAG,YAAY,CAAA;QAC1B,IAAI,UAAU,KAAK,cAAc,EAAE,CAAC;YAClC,OAAO,IAAI,YAAY,UAAU,EAAE,CAAA;QACrC,CAAC;QACD,IAAI,WAAW,EAAE,CAAC;YAChB,OAAO,IAAI,IAAI,WAAW,EAAE,CAAA;YAC5B,IAAI,YAAY,EAAE,CAAC;gBACjB,OAAO,IAAI,IAAI,YAAY,EAAE,CAAA;YAC/B,CAAC;QACH,CAAC;QAED,QAAQ,CAAC,OAAO,CAAC,CAAA;IACnB,CAAC,CAAA;IAED,OAAO,CACL,MAAC,MAAM,CAAC,IAAI,IAAC,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,mBAAmB,aACpE,KAAC,MAAM,CAAC,OAAO,KAAG,EAClB,KAAC,MAAM,CAAC,OAAO,cACZ,iBAAiB,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAChC,KAAC,MAAM,CAAC,IAAI,IAAe,KAAK,EAAE,OAAO,YACtC,OAAO,KAAK,cAAc,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,IADhC,OAAO,CAEX,CACf,CAAC,GACa,IACL,CACf,CAAA;AACH,CAAC,CAAA"}

package/build/template/lib/schema-utils/constants.d.ts

@@ -1,5 +0,0 @@
-/**
- * Re-exports of schema constants for template usage
- */
-export { dateToVersionString, VERSION_LATEST } from '#api/schema/schema';
-//# sourceMappingURL=constants.d.ts.map

package/build/template/lib/schema-utils/constants.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/template/lib/schema-utils/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA"}

package/build/template/lib/schema-utils/constants.js

@@ -1,5 +0,0 @@
-/**
- * Re-exports of schema constants for template usage
- */
-export { dateToVersionString, VERSION_LATEST } from '#api/schema/schema';
-//# sourceMappingURL=constants.js.map

package/build/template/lib/schema-utils/constants.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../src/template/lib/schema-utils/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA"}

package/src/template/components/VersionSelector.tsx

@@ -1,50 +0,0 @@
-import { Select } from '@radix-ui/themes'
-import { useNavigate, useParams } from 'react-router'
-import { VERSION_LATEST } from '../lib/schema-utils/constants.js'
-
-interface VersionSelectorProps {
-  availableVersions: string[]
-  currentVersion: string
-}
-
-export const VersionSelector = ({ availableVersions, currentVersion }: VersionSelectorProps) => {
-  const navigate = useNavigate()
-  const params = useParams()
-
-  // Don't show selector if only one version
-  if (availableVersions.length <= 1) {
-    return null
-  }
-
-  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}`
-      }
-    }
-
-    navigate(newPath)
-  }
-
-  return (
-    <Select.Root value={currentVersion} onValueChange={handleVersionChange}>
-      <Select.Trigger />
-      <Select.Content>
-        {availableVersions.map(version => (
-          <Select.Item key={version} value={version}>
-            {version === VERSION_LATEST ? `Latest` : version}
-          </Select.Item>
-        ))}
-      </Select.Content>
-    </Select.Root>
-  )
-}

package/src/template/lib/schema-utils/constants.ts

@@ -1,4 +0,0 @@
-/**
- * Re-exports of schema constants for template usage
- */
-export { dateToVersionString, VERSION_LATEST } from '#api/schema/schema'