@zpress/config 0.1.0

package/dist/index.mjs

@@ -0,0 +1,287 @@
+import { loadConfig } from "c12";
+import { z } from "zod/v3";
+function defineConfig(config) {
+    return config;
+}
+function configError(type, message) {
+    return {
+        _tag: 'ConfigError',
+        type,
+        message
+    };
+}
+function configErrorFromZod(zodError) {
+    return {
+        _tag: 'ConfigError',
+        type: 'validation_failed',
+        message: 'Configuration validation failed',
+        errors: zodError.issues.map((err)=>({
+                path: err.path.filter((p)=>'string' == typeof p || 'number' == typeof p),
+                message: err.message
+            }))
+    };
+}
+const frontmatterSchema = z.object({
+    title: z.string().optional(),
+    titleTemplate: z.union([
+        z.string(),
+        z.boolean()
+    ]).optional(),
+    description: z.string().optional(),
+    layout: z.string().optional(),
+    sidebar: z.boolean().optional(),
+    aside: z.union([
+        z.boolean(),
+        z.literal('left')
+    ]).optional(),
+    outline: z.union([
+        z.literal(false),
+        z.number(),
+        z.tuple([
+            z.number(),
+            z.number()
+        ]),
+        z.literal('deep')
+    ]).optional(),
+    navbar: z.boolean().optional(),
+    editLink: z.boolean().optional(),
+    lastUpdated: z.boolean().optional(),
+    footer: z.boolean().optional(),
+    pageClass: z.string().optional(),
+    head: z.array(z.tuple([
+        z.string(),
+        z.record(z.string(), z.string())
+    ])).optional()
+}).passthrough();
+const navItemSchema = z.lazy(()=>z.object({
+        text: z.string(),
+        link: z.string().optional(),
+        items: z.array(navItemSchema).optional(),
+        activeMatch: z.string().optional()
+    }).strict());
+const titleConfigSchema = z.union([
+    z.string(),
+    z.object({
+        from: z["enum"]([
+            'auto',
+            'filename',
+            'heading',
+            'frontmatter'
+        ]),
+        transform: z["function"]().optional()
+    }).strict()
+]);
+const discoverySchema = z.object({
+    from: z.string().optional(),
+    title: titleConfigSchema.optional(),
+    sort: z.union([
+        z["enum"]([
+            'alpha',
+            'filename'
+        ]),
+        z["function"]()
+    ]).optional(),
+    exclude: z.array(z.string()).optional(),
+    frontmatter: frontmatterSchema.optional(),
+    recursive: z.boolean().optional(),
+    indexFile: z.string().optional()
+}).strict();
+const cardConfigSchema = z.object({
+    icon: z.string().optional(),
+    iconColor: z.string().optional(),
+    scope: z.string().optional(),
+    description: z.string().optional(),
+    tags: z.array(z.string()).optional(),
+    badge: z.object({
+        src: z.string(),
+        alt: z.string()
+    }).strict().optional()
+}).strict();
+const entrySchema = z.lazy(()=>z.object({
+        title: titleConfigSchema,
+        link: z.string().optional(),
+        from: z.string().optional(),
+        prefix: z.string().optional(),
+        content: z.union([
+            z.string(),
+            z["function"]()
+        ]).optional(),
+        items: z.array(entrySchema).optional(),
+        landing: z.union([
+            z["enum"]([
+                'auto',
+                'cards',
+                'overview'
+            ]),
+            z.literal(false)
+        ]).optional(),
+        collapsible: z.boolean().optional(),
+        exclude: z.array(z.string()).optional(),
+        hidden: z.boolean().optional(),
+        frontmatter: frontmatterSchema.optional(),
+        sort: z.union([
+            z["enum"]([
+                'alpha',
+                'filename'
+            ]),
+            z["function"]()
+        ]).optional(),
+        recursive: z.boolean().optional(),
+        indexFile: z.string().optional(),
+        icon: z.string().optional(),
+        iconColor: z.string().optional(),
+        card: cardConfigSchema.optional(),
+        isolated: z.boolean().optional(),
+        titleFrom: z["enum"]([
+            'filename',
+            'heading',
+            'frontmatter',
+            'auto'
+        ]).optional(),
+        titleTransform: z["function"]().optional()
+    }).strict());
+const workspaceItemSchema = z.object({
+    title: titleConfigSchema,
+    icon: z.string().optional(),
+    iconColor: z.string().optional(),
+    description: z.string(),
+    tags: z.array(z.string()).optional(),
+    badge: z.object({
+        src: z.string(),
+        alt: z.string()
+    }).strict().optional(),
+    prefix: z.string(),
+    discovery: discoverySchema.optional(),
+    items: z.array(entrySchema).optional()
+}).strict();
+const workspaceGroupSchema = z.object({
+    title: titleConfigSchema,
+    description: z.string(),
+    icon: z.string(),
+    items: z.array(workspaceItemSchema).min(1),
+    link: z.string().optional()
+}).strict();
+const featureSchema = z.object({
+    title: titleConfigSchema,
+    description: z.string(),
+    link: z.string().optional(),
+    icon: z.string().optional()
+}).strict();
+const openapiConfigSchema = z.object({
+    spec: z.string(),
+    prefix: z.string(),
+    title: z.string().optional()
+}).strict();
+const themeColorsSchema = z.object({
+    brand: z.string().optional(),
+    brandLight: z.string().optional(),
+    brandDark: z.string().optional(),
+    brandSoft: z.string().optional(),
+    bg: z.string().optional(),
+    bgAlt: z.string().optional(),
+    bgElv: z.string().optional(),
+    bgSoft: z.string().optional(),
+    text1: z.string().optional(),
+    text2: z.string().optional(),
+    text3: z.string().optional(),
+    divider: z.string().optional(),
+    border: z.string().optional(),
+    homeBg: z.string().optional()
+}).strict();
+const themeConfigSchema = z.object({
+    name: z.string().default('base'),
+    colorMode: z["enum"]([
+        'dark',
+        'light',
+        'toggle'
+    ]).optional(),
+    switcher: z.boolean().optional(),
+    colors: themeColorsSchema.optional(),
+    darkColors: themeColorsSchema.optional()
+}).strict();
+const zpressConfigSchema = z.object({
+    title: z.string().optional(),
+    description: z.string().optional(),
+    theme: themeConfigSchema.optional(),
+    icon: z.string().optional(),
+    tagline: z.string().optional(),
+    apps: z.array(workspaceItemSchema).optional(),
+    packages: z.array(workspaceItemSchema).optional(),
+    workspaces: z.array(workspaceGroupSchema).optional(),
+    features: z.array(featureSchema).optional(),
+    sections: z.array(entrySchema).min(1, 'config.sections must have at least one entry'),
+    nav: z.union([
+        z.literal('auto'),
+        z.array(navItemSchema)
+    ]).optional(),
+    exclude: z.array(z.string()).optional(),
+    openapi: openapiConfigSchema.optional()
+}).strict();
+const pathsSchema = z.object({
+    repoRoot: z.string(),
+    outputRoot: z.string(),
+    contentDir: z.string(),
+    publicDir: z.string(),
+    distDir: z.string(),
+    cacheDir: z.string()
+}).strict();
+function validateConfig(config) {
+    const result = zpressConfigSchema.safeParse(config);
+    if (result.success) return [
+        null,
+        result.data
+    ];
+    return [
+        configErrorFromZod(result.error),
+        null
+    ];
+}
+async function loader_loadConfig(dirOrOptions = {}) {
+    const options = resolveOptions(dirOrOptions);
+    const { cwd, configFile } = options;
+    return await loadAndValidateConfig({
+        cwd,
+        configFile
+    });
+}
+async function loadAndValidateConfig(options) {
+    const { cwd, configFile } = options;
+    try {
+        const result = await loadConfig({
+            cwd,
+            configFile,
+            name: 'zpress',
+            rcFile: false,
+            packageJson: false,
+            globalRc: false,
+            dotenv: false
+        });
+        const { config } = result;
+        if (!config) return [
+            configError('not_found', 'Failed to load zpress.config — no config file found'),
+            null
+        ];
+        if (!config.sections || Array.isArray(config.sections) && 0 === config.sections.length) return [
+            configError('empty_sections', 'Failed to load zpress.config — no sections found'),
+            null
+        ];
+        return validateConfig(config);
+    } catch (error) {
+        return [
+            configError('parse_error', `Failed to parse config file: ${getErrorMessage(error)}`),
+            null
+        ];
+    }
+}
+function resolveOptions(dirOrOptions) {
+    if ('string' == typeof dirOrOptions) return {
+        cwd: dirOrOptions
+    };
+    return dirOrOptions;
+}
+function getErrorMessage(error) {
+    if (error instanceof Error) return error.message;
+    return String(error);
+}
+export { COLOR_MODES, ICON_COLORS, THEME_NAMES, isBuiltInIconColor, isBuiltInTheme, resolveDefaultColorMode } from "@zpress/theme";
+export { configError, configErrorFromZod, defineConfig, loader_loadConfig as loadConfig, pathsSchema, validateConfig, zpressConfigSchema };

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@zpress/config",
+  "version": "0.1.0",
+  "description": "Configuration loading and validation for zpress",
+  "keywords": [
+    "config",
+    "schema",
+    "validation",
+    "zpress"
+  ],
+  "homepage": "https://github.com/joggrdocs/zpress/tree/main/packages/config#readme",
+  "bugs": "https://github.com/joggrdocs/zpress/issues",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/joggrdocs/zpress.git",
+    "directory": "packages/config"
+  },
+  "files": [
+    "dist",
+    "schemas"
+  ],
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs"
+    },
+    "./schema": {
+      "default": "./schemas/schema.json"
+    }
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "scripts": {
+    "build": "tsx scripts/generate-schema.ts && rslib build",
+    "dev": "rslib build --watch --no-clean",
+    "typecheck": "tsc --noEmit",
+    "generate:schema": "tsx scripts/generate-schema.ts"
+  },
+  "dependencies": {
+    "@zpress/theme": "workspace:*",
+    "c12": "4.0.0-beta.3",
+    "es-toolkit": "catalog:",
+    "ts-pattern": "catalog:",
+    "type-fest": "catalog:",
+    "zod": "catalog:"
+  },
+  "devDependencies": {
+    "@rslib/core": "catalog:",
+    "@types/node": "^25.5.0",
+    "tsx": "^4.21.0",
+    "typescript": "catalog:",
+    "zod-to-json-schema": "^3.25.1"
+  },
+  "engines": {
+    "node": ">=24.0.0"
+  }
+}