@zpress/core 0.3.0 → 0.4.0

package/dist/index.d.ts

@@ -98,21 +98,15 @@ export declare type ConfigResult<T> = readonly [ConfigError, null] | readonly [n
 export declare function createPaths(dir: string): Paths;
 
 /**
- * Type-safe config helper with validation.
+ * Type-safe config helper for user config files.
  *
- * Validates the config structure and exits with a clear error message
- * if any issues are found. This is the primary entry point for user-
- * provided config — validation happens at the boundary.
- *
- * `defineConfig` is called in user config files (e.g. `zpress.config.ts`)
- * where the return value is consumed by the c12 config loader, which
- * expects a plain `ZpressConfig` object — not a `Result` tuple.
- * Because this is the outermost user-facing boundary (not a library
- * function), `process.exit(1)` is acceptable here: the user must fix
- * their config before any downstream code can run.
+ * This is a passthrough that provides type safety and editor
+ * autocompletion in `zpress.config.ts`. Validation is deferred to
+ * `loadConfig` at CLI runtime, so errors surface with structured
+ * feedback rather than a raw `process.exit`.
  *
  * @param config - Raw zpress config object
- * @returns The validated config (unchanged)
+ * @returns The config (unchanged)
  */
 export declare function defineConfig(config: ZpressConfig): ZpressConfig;
 
@@ -251,6 +245,11 @@ export declare interface Entry {
      * @default "overview"
      */
     readonly indexFile?: string;
+    /**
+     * Iconify icon identifier (e.g. `"pixelarticons:speed-fast"`).
+     * Used on home page feature cards when auto-generated from sections.
+     */
+    readonly icon?: string;
     /**
      * Card display metadata for the parent section's auto-generated landing page.
      *
@@ -395,10 +394,14 @@ declare type GlobPattern = string;
 export declare function hasGlobChars(s: string): boolean;
 
 /**
- * Load zpress config at runtime via c12.
+ * Load and validate zpress config at runtime via c12.
  *
- * Returns a `ConfigResult` tuple instead of calling `process.exit` — the
- * CLI boundary is responsible for surfacing the error and exiting.
+ * Returns a `ConfigResult` tuple — the CLI boundary is responsible for
+ * surfacing any error and exiting. Validation runs here (not in
+ * `defineConfig`) so every consumer gets structured error feedback.
+ *
+ * @param dir - Repository root directory to search for `zpress.config.*`
+ * @returns A `ConfigResult` tuple — `[null, config]` on success or `[ConfigError, null]` on failure
  */
 export declare function loadConfig(dir: string): Promise<ConfigResult<ZpressConfig>>;
 
@@ -752,6 +755,14 @@ export declare interface SyncResult {
  */
 declare type UrlPath = string;
 
+/**
+ * Validate the entire config, returning the first error found.
+ *
+ * @param config - Raw zpress config object to validate
+ * @returns A `ConfigResult` tuple — `[null, config]` on success or `[ConfigError, null]` on failure
+ */
+export declare function validateConfig(config: ZpressConfig): ConfigResult<ZpressConfig>;
+
 /**
  * A named group of workspace items for custom workspace categories.
  *

package/dist/index.mjs

@@ -48,11 +48,6 @@ function collectResults(results) {
     ]);
 }
 function defineConfig(config) {
-    const [err] = validateConfig(config);
-    if (err) {
-        process.stderr.write(`[zpress] ${err.message}\n`);
-        process.exit(1);
-    }
     return config;
 }
 function validateConfig(config) {
@@ -235,10 +230,7 @@ async function config_loadConfig(dir) {
         configError('empty_sections', 'Failed to load zpress.config — no sections found'),
         null
     ];
-    return [
-        null,
-        config
-    ];
+    return validateConfig(config);
 }
 const FIGLET_CHARS = Object.freeze({
     A: [
@@ -1429,7 +1421,7 @@ function buildFeatures(sections, repoRoot) {
     return Promise.all(sections.slice(0, 3).map(async (section, index)=>{
         const link = section.link ?? findFirstChildLink(section);
         const details = await extractSectionDescription(section, repoRoot);
-        const iconId = null;
+        const iconId = section.icon ?? null;
         const iconColor = ICON_COLORS[index % ICON_COLORS.length];
         return {
             title: section.text,
@@ -2839,4 +2831,4 @@ function createPaths(dir) {
         cacheDir: node_path.resolve(outputRoot, 'cache')
     };
 }
-export { configError, config_loadConfig as loadConfig, createPaths, defineConfig, generateAssets, generateBannerSvg, generateIconSvg, generateLogoSvg, hasGlobChars, loadManifest, resolveEntries, sync, syncError };
+export { configError, config_loadConfig as loadConfig, createPaths, defineConfig, generateAssets, generateBannerSvg, generateIconSvg, generateLogoSvg, hasGlobChars, loadManifest, resolveEntries, sync, syncError, validateConfig };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zpress/core",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Config loading, sync engine, and asset utilities for zpress",
   "keywords": [
     "config",