@yaakdoc/config 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 József Sallai
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,32 @@
-# Temporary Holding Version
+# @yaakdoc/config
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+The configuration schema for [yaakdoc](https://github.com/jozsefsallai/yaakdoc#readme).
+
+```ts
+// yaakdoc.config.ts
+import { defineConfig } from "@yaakdoc/config"; // also re-exported from "yaakdoc"
+
+export default defineConfig({
+  branding: {
+    title: "Acme API",
+
+    colors: {
+      primary: "#0f766e"
+    }
+  },
+
+  pages: "per-request",
+});
+```
+
+Most projects use `yaakdoc.config.json` with `"$schema": "./node_modules/yaakdoc/config.schema.json"` for editor autocomplete. Every field is optional. See the [configuration reference](https://github.com/jozsefsallai/yaakdoc#configuration).
+
+## API
+
+- `configSchema`: the Zod schema. `YaakdocConfig` is the input type and `ResolvedConfig` is the type with defaults applied.
+- `parseConfig(input)` validates input and applies defaults. Errors are readable `ConfigError`s.
+- `getConfigJsonSchema()` returns the JSON schema used by `$schema`.
+- `loadConfig({ cwd, configFile, overrides })` from `@yaakdoc/config/node` loads the config:
+  - It finds `yaakdoc.config.{json,jsonc,ts,js,...}` with [c12](https://github.com/unjs/c12).
+  - It applies overrides such as CLI flags. Arrays are replaced, not merged.
+  - It resolves local paths relative to the config file.

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+import { a as YaakdocConfig, c as headTagSchema, i as ResolvedConfig, l as logoSchema, n as HeadTag, o as brandingSchema, r as Logo, s as configSchema, t as Branding } from "./schema-_OwQdVfh.js";
+//#region src/index.d.ts
+/** Identity helper that provides type checking/autocomplete for `yaakdoc.config.ts`. */
+export declare function defineConfig(config: YaakdocConfig): YaakdocConfig;
+export declare class ConfigError extends Error {
+  name: string;
+}
+/** Validates a user config and applies defaults. */
+export declare function parseConfig(input: unknown, source?: string): ResolvedConfig;
+/** JSON Schema for `yaakdoc.config.json` (editor autocomplete via `$schema`). */
+export declare function getConfigJsonSchema(): Record<string, unknown>;
+/** Deep merge where `override` wins and arrays are replaced rather than concatenated. */
+export declare function mergeConfig<T extends Record<string, unknown>>(base: T, override: Partial<T>): T;
+//#endregion
+export { Branding, HeadTag, Logo, ResolvedConfig, YaakdocConfig, brandingSchema, configSchema, headTagSchema, logoSchema };

package/dist/index.js

@@ -0,0 +1,153 @@
+import { z } from "zod";
+//#region src/schema.ts
+const color = z.string().meta({ description: "Any CSS color, e.g. `#7c3aed`, `oklch(0.6 0.2 290)` or `rebeccapurple`." });
+const modeColors = z.object({
+	primary: color.optional(),
+	accent: color.optional(),
+	background: color.optional(),
+	foreground: color.optional()
+}).meta({ description: "Color overrides that apply to a single color mode." });
+const logoSchema = z.union([z.string().meta({ description: "Path or URL of the logo (used in both color modes)." }), z.object({
+	light: z.string().optional().meta({ description: "Logo used in light mode." }),
+	dark: z.string().optional().meta({ description: "Logo used in dark mode." }),
+	alt: z.string().optional(),
+	href: z.string().optional().meta({ description: "Where clicking the logo leads. Defaults to the docs home." }),
+	width: z.number().optional(),
+	height: z.number().optional()
+})]);
+const brandingSchema = z.object({
+	title: z.string().optional().meta({ description: "Site title. Defaults to the workspace name." }),
+	description: z.string().optional().meta({ description: "Short site description (meta tags, llms.txt). Defaults to the workspace description's first paragraph." }),
+	url: z.url().optional().meta({ description: "Public URL of the deployed docs. Enables absolute links, canonical URLs and sitemap.xml." }),
+	logo: logoSchema.optional(),
+	favicon: z.string().optional().meta({ description: "Path or URL of the favicon." }),
+	colors: z.object({
+		primary: color.optional(),
+		accent: color.optional(),
+		light: modeColors.optional(),
+		dark: modeColors.optional()
+	}).optional(),
+	fonts: z.object({
+		sans: z.string().optional().meta({ description: "CSS font-family for text, e.g. `\"Inter\", sans-serif`." }),
+		mono: z.string().optional().meta({ description: "CSS font-family for code." }),
+		stylesheet: z.string().optional().meta({ description: "Stylesheet URL that loads the fonts, e.g. a Google Fonts CSS URL." })
+	}).optional(),
+	links: z.array(z.object({
+		label: z.string(),
+		href: z.string(),
+		icon: z.string().optional().meta({ description: "Icon hint for themes, e.g. `github`, `discord`, `x`, `website`." })
+	})).default([]).meta({ description: "Links shown in the header." }),
+	footer: z.string().optional().meta({ description: "Footer text (Markdown)." }),
+	defaultColorMode: z.enum([
+		"system",
+		"light",
+		"dark"
+	]).default("system"),
+	colorModeToggle: z.boolean().default(true).meta({ description: "Show the light/dark mode toggle." }),
+	customCss: z.string().optional().meta({ description: "Path to a CSS file loaded after the theme's styles." })
+}).prefault({});
+const headTagSchema = z.object({
+	tag: z.enum([
+		"script",
+		"link",
+		"meta",
+		"style"
+	]),
+	attrs: z.record(z.string(), z.union([z.string(), z.boolean()])).default({}),
+	content: z.string().optional()
+});
+const configSchema = z.object({
+	$schema: z.string().optional(),
+	export: z.string().optional().meta({ description: "Path to the Yaak export. Defaults to yaakdoc.json, then yaak.json." }),
+	theme: z.string().default("kiseki").meta({ description: "Theme to use: a short name (`kiseki` → @yaakdoc/theme-kiseki or yaakdoc-theme-kiseki), an npm package name, or a local path (e.g. an ejected theme)." }),
+	themeOptions: z.record(z.string(), z.unknown()).default({}).meta({ description: "Theme-specific options, validated by the theme." }),
+	workspace: z.string().optional().meta({ description: "Workspace id or name to document, when the export contains several." }),
+	environment: z.union([z.string(), z.literal(false)]).optional().meta({ description: "Environment (id or name) used to resolve variables in examples. Defaults to the first shared environment; `false` disables sub environments." }),
+	environments: z.union([z.literal("public"), z.array(z.string())]).optional().meta({ description: "Environments readers can switch between: `\"public\"` (all shared environments) or a list of ids/names. Adds an environment switcher; `environment` is the default selection." }),
+	pages: z.enum(["single", "per-request"]).default("single").meta({ description: "`single`: one page with anchors. `per-request`: a page per request and folder." }),
+	base: z.string().default("/").transform((value) => `/${value.replace(/^\/+|\/+$/g, "")}/`.replace(/^\/\/$/, "/")).meta({ description: "Base path the site is served from, e.g. `/docs/`." }),
+	outDir: z.string().default("dist").meta({ description: "Output directory for `yaakdoc build`." }),
+	server: z.object({
+		port: z.number().int().min(0).max(65535).default(4e3),
+		host: z.union([z.boolean(), z.string()]).default(false),
+		open: z.boolean().default(false)
+	}).prefault({}),
+	branding: brandingSchema,
+	snippets: z.array(z.string()).default([
+		"curl",
+		"javascript",
+		"python",
+		"go",
+		"grpcurl",
+		"wscat"
+	]).meta({ description: "Code example generators: built-in ids (curl, javascript, python, go, grpcurl, wscat) or module paths. Each snippet only applies to the request kinds it supports." }),
+	llms: z.object({
+		enabled: z.boolean().default(true).meta({ description: "Generate llms.txt and Markdown versions of pages." }),
+		full: z.boolean().default(true).meta({ description: "Also generate llms-full.txt with the complete docs." }),
+		copyButton: z.boolean().default(true).meta({ description: "Show \"Copy page\" actions." }),
+		openIn: z.array(z.enum([
+			"chatgpt",
+			"claude",
+			"perplexity"
+		])).default(["chatgpt", "claude"]).meta({ description: "\"Open in ...\" assistant links." })
+	}).prefault({}),
+	variables: z.object({
+		resolve: z.boolean().default(true).meta({ description: "Inline variable values in examples." }),
+		hide: z.array(z.string()).default([
+			"token",
+			"secret",
+			"password",
+			"passwd",
+			"apikey",
+			"api_key",
+			"private",
+			"credential",
+			"auth"
+		]).meta({ description: "Variable name patterns that are never inlined (case- and separator-insensitive substring match)." }),
+		show: z.boolean().default(true).meta({ description: "Show the environment variables table." })
+	}).prefault({}),
+	filter: z.object({
+		include: z.array(z.string()).default([]),
+		exclude: z.array(z.string()).default([])
+	}).prefault({}).meta({ description: "Glob patterns over request/folder slugs (e.g. `internal/**`)." }),
+	runInYaak: z.union([z.boolean(), z.object({
+		name: z.string().optional().meta({ description: "Name shown in Yaak when importing. Defaults to the site title." }),
+		url: z.string().optional().meta({ description: "URL of an export/spec hosted elsewhere. When omitted, yaakdoc publishes a sanitized export at `<base>yaak.json`." })
+	})]).default(false).meta({ description: "Show a \"Run in Yaak\" button that imports the API into Yaak. Publishes a sanitized copy of the export (only documented requests, no private environments, secrets blanked)." }),
+	head: z.array(headTagSchema).default([]).meta({ description: "Extra tags injected into <head> (analytics, verification meta tags...)." })
+}).meta({ title: "yaakdoc configuration" });
+//#endregion
+//#region src/index.ts
+/** Identity helper that provides type checking/autocomplete for `yaakdoc.config.ts`. */
+function defineConfig(config) {
+	return config;
+}
+var ConfigError = class extends Error {
+	name = "ConfigError";
+};
+/** Validates a user config and applies defaults. */
+function parseConfig(input, source = "configuration") {
+	const result = configSchema.safeParse(input ?? {});
+	if (!result.success) throw new ConfigError(`Invalid ${source}:\n${z.prettifyError(result.error)}`);
+	return result.data;
+}
+/** JSON Schema for `yaakdoc.config.json` (editor autocomplete via `$schema`). */
+function getConfigJsonSchema() {
+	return z.toJSONSchema(configSchema, {
+		io: "input",
+		unrepresentable: "any"
+	});
+}
+/** Deep merge where `override` wins and arrays are replaced rather than concatenated. */
+function mergeConfig(base, override) {
+	const out = { ...base };
+	for (const [key, value] of Object.entries(override)) {
+		if (value === void 0) continue;
+		const current = out[key];
+		out[key] = isPlainObject(current) && isPlainObject(value) ? mergeConfig(current, value) : value;
+	}
+	return out;
+}
+const isPlainObject = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+//#endregion
+export { ConfigError, brandingSchema, configSchema, defineConfig, getConfigJsonSchema, headTagSchema, logoSchema, mergeConfig, parseConfig };

package/dist/node.d.ts

@@ -0,0 +1,28 @@
+import { a as YaakdocConfig, i as ResolvedConfig } from "./schema-_OwQdVfh.js";
+//#region src/node.d.ts
+export type LoadConfigOptions = {
+  /** Directory to look for `yaakdoc.config.*` in. Defaults to `process.cwd()`. */
+  cwd?: string;
+  /** Explicit config file path (relative to `cwd`). */
+  configFile?: string;
+  /** Values that take precedence over the config file (e.g. CLI flags). */
+  overrides?: YaakdocConfig;
+};
+export type LoadedConfig = {
+  config: ResolvedConfig;
+  /** Absolute path of the config file, if one was found. */
+  configFile: string | null;
+  /** Directory relative paths in the config are resolved against. */
+  root: string;
+};
+/**
+ * Loads `yaakdoc.config.{json,jsonc,ts,js,mjs,...}` (optional), applies CLI overrides and defaults,
+ * validates it and resolves local paths to absolute paths.
+ */
+export declare function loadConfig(options?: LoadConfigOptions): Promise<LoadedConfig>;
+/**
+ * Resolves local paths in the config to absolute paths. Paths from the config file are relative to
+ * the config file; paths passed as CLI overrides are relative to the current directory.
+ */
+export declare function resolveConfigPaths(config: ResolvedConfig, root: string, overrides?: YaakdocConfig, cwd?: string): ResolvedConfig;
+//#endregion

package/dist/node.js

@@ -0,0 +1,67 @@
+import { ConfigError, mergeConfig, parseConfig } from "./index.js";
+import { dirname, isAbsolute, resolve } from "node:path";
+import { isUrl } from "@yaakdoc/core";
+import { loadConfig as loadConfig$1 } from "c12";
+//#region src/node.ts
+/**
+* Loads `yaakdoc.config.{json,jsonc,ts,js,mjs,...}` (optional), applies CLI overrides and defaults,
+* validates it and resolves local paths to absolute paths.
+*/
+async function loadConfig(options = {}) {
+	const cwd = resolve(options.cwd ?? process.cwd());
+	let loaded;
+	try {
+		loaded = await loadConfig$1({
+			cwd,
+			name: "yaakdoc",
+			configFile: options.configFile?.replace(/\.(json|jsonc|json5|ts|js|mjs|cjs|mts|cts)$/, ""),
+			rcFile: false,
+			globalRc: false,
+			dotenv: false,
+			packageJson: false,
+			configFileRequired: Boolean(options.configFile),
+			merger: (...configs) => configs.filter(Boolean).reverse().reduce((acc, config) => mergeConfig(acc, config), {})
+		});
+	} catch (error) {
+		throw new ConfigError(`Could not load config: ${error.message}`);
+	}
+	const configFile = loaded._configFile ?? null;
+	const merged = mergeConfig(loaded.config ?? {}, options.overrides ?? {});
+	const config = parseConfig(merged, configFile ? `config ${configFile}` : "configuration");
+	const root = configFile ? dirname(configFile) : cwd;
+	return {
+		config: resolveConfigPaths(config, root, options.overrides ?? {}, cwd),
+		configFile,
+		root
+	};
+}
+const isLocalPath = (value) => value.startsWith(".") || value.startsWith("/") || isAbsolute(value);
+/**
+* Resolves local paths in the config to absolute paths. Paths from the config file are relative to
+* the config file; paths passed as CLI overrides are relative to the current directory.
+*/
+function resolveConfigPaths(config, root, overrides = {}, cwd = root) {
+	const from = (value, overridden) => resolve(overridden ? cwd : root, value);
+	const asset = (value) => value && !isUrl(value) ? resolve(root, value) : value;
+	const { branding } = config;
+	const logo = typeof branding.logo === "string" ? asset(branding.logo) : branding.logo && {
+		...branding.logo,
+		...branding.logo.light ? { light: asset(branding.logo.light) } : {},
+		...branding.logo.dark ? { dark: asset(branding.logo.dark) } : {}
+	};
+	return {
+		...config,
+		...config.export ? { export: from(config.export, overrides.export !== void 0) } : {},
+		outDir: from(config.outDir, overrides.outDir !== void 0),
+		theme: isLocalPath(config.theme) ? from(config.theme, overrides.theme !== void 0) : config.theme,
+		snippets: config.snippets.map((snippet) => isLocalPath(snippet) ? resolve(root, snippet) : snippet),
+		branding: {
+			...branding,
+			...logo ? { logo } : {},
+			...branding.favicon ? { favicon: asset(branding.favicon) } : {},
+			...branding.customCss ? { customCss: resolve(root, branding.customCss) } : {}
+		}
+	};
+}
+//#endregion
+export { loadConfig, resolveConfigPaths };

package/dist/schema-_OwQdVfh.d.ts

@@ -0,0 +1,179 @@
+import { z } from "zod";
+//#region src/schema.d.ts
+declare const logoSchema: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+  light: z.ZodOptional<z.ZodString>;
+  dark: z.ZodOptional<z.ZodString>;
+  alt: z.ZodOptional<z.ZodString>;
+  href: z.ZodOptional<z.ZodString>;
+  width: z.ZodOptional<z.ZodNumber>;
+  height: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>]>;
+declare const brandingSchema: z.ZodPrefault<z.ZodObject<{
+  title: z.ZodOptional<z.ZodString>;
+  description: z.ZodOptional<z.ZodString>;
+  url: z.ZodOptional<z.ZodURL>;
+  logo: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+    light: z.ZodOptional<z.ZodString>;
+    dark: z.ZodOptional<z.ZodString>;
+    alt: z.ZodOptional<z.ZodString>;
+    href: z.ZodOptional<z.ZodString>;
+    width: z.ZodOptional<z.ZodNumber>;
+    height: z.ZodOptional<z.ZodNumber>;
+  }, z.core.$strip>]>>;
+  favicon: z.ZodOptional<z.ZodString>;
+  colors: z.ZodOptional<z.ZodObject<{
+    primary: z.ZodOptional<z.ZodString>;
+    accent: z.ZodOptional<z.ZodString>;
+    light: z.ZodOptional<z.ZodObject<{
+      primary: z.ZodOptional<z.ZodString>;
+      accent: z.ZodOptional<z.ZodString>;
+      background: z.ZodOptional<z.ZodString>;
+      foreground: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    dark: z.ZodOptional<z.ZodObject<{
+      primary: z.ZodOptional<z.ZodString>;
+      accent: z.ZodOptional<z.ZodString>;
+      background: z.ZodOptional<z.ZodString>;
+      foreground: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+  }, z.core.$strip>>;
+  fonts: z.ZodOptional<z.ZodObject<{
+    sans: z.ZodOptional<z.ZodString>;
+    mono: z.ZodOptional<z.ZodString>;
+    stylesheet: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>>;
+  links: z.ZodDefault<z.ZodArray<z.ZodObject<{
+    label: z.ZodString;
+    href: z.ZodString;
+    icon: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>>>;
+  footer: z.ZodOptional<z.ZodString>;
+  defaultColorMode: z.ZodDefault<z.ZodEnum<{
+    dark: "dark";
+    light: "light";
+    system: "system";
+  }>>;
+  colorModeToggle: z.ZodDefault<z.ZodBoolean>;
+  customCss: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+declare const headTagSchema: z.ZodObject<{
+  tag: z.ZodEnum<{
+    link: "link";
+    meta: "meta";
+    script: "script";
+    style: "style";
+  }>;
+  attrs: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodBoolean]>>>;
+  content: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+declare const configSchema: z.ZodObject<{
+  $schema: z.ZodOptional<z.ZodString>;
+  export: z.ZodOptional<z.ZodString>;
+  theme: z.ZodDefault<z.ZodString>;
+  themeOptions: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+  workspace: z.ZodOptional<z.ZodString>;
+  environment: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodLiteral<false>]>>;
+  environments: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"public">, z.ZodArray<z.ZodString>]>>;
+  pages: z.ZodDefault<z.ZodEnum<{
+    "per-request": "per-request";
+    single: "single";
+  }>>;
+  base: z.ZodPipe<z.ZodDefault<z.ZodString>, z.ZodTransform<string, string>>;
+  outDir: z.ZodDefault<z.ZodString>;
+  server: z.ZodPrefault<z.ZodObject<{
+    port: z.ZodDefault<z.ZodNumber>;
+    host: z.ZodDefault<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
+    open: z.ZodDefault<z.ZodBoolean>;
+  }, z.core.$strip>>;
+  branding: z.ZodPrefault<z.ZodObject<{
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodURL>;
+    logo: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+      light: z.ZodOptional<z.ZodString>;
+      dark: z.ZodOptional<z.ZodString>;
+      alt: z.ZodOptional<z.ZodString>;
+      href: z.ZodOptional<z.ZodString>;
+      width: z.ZodOptional<z.ZodNumber>;
+      height: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>]>>;
+    favicon: z.ZodOptional<z.ZodString>;
+    colors: z.ZodOptional<z.ZodObject<{
+      primary: z.ZodOptional<z.ZodString>;
+      accent: z.ZodOptional<z.ZodString>;
+      light: z.ZodOptional<z.ZodObject<{
+        primary: z.ZodOptional<z.ZodString>;
+        accent: z.ZodOptional<z.ZodString>;
+        background: z.ZodOptional<z.ZodString>;
+        foreground: z.ZodOptional<z.ZodString>;
+      }, z.core.$strip>>;
+      dark: z.ZodOptional<z.ZodObject<{
+        primary: z.ZodOptional<z.ZodString>;
+        accent: z.ZodOptional<z.ZodString>;
+        background: z.ZodOptional<z.ZodString>;
+        foreground: z.ZodOptional<z.ZodString>;
+      }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    fonts: z.ZodOptional<z.ZodObject<{
+      sans: z.ZodOptional<z.ZodString>;
+      mono: z.ZodOptional<z.ZodString>;
+      stylesheet: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    links: z.ZodDefault<z.ZodArray<z.ZodObject<{
+      label: z.ZodString;
+      href: z.ZodString;
+      icon: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    footer: z.ZodOptional<z.ZodString>;
+    defaultColorMode: z.ZodDefault<z.ZodEnum<{
+      dark: "dark";
+      light: "light";
+      system: "system";
+    }>>;
+    colorModeToggle: z.ZodDefault<z.ZodBoolean>;
+    customCss: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>>;
+  snippets: z.ZodDefault<z.ZodArray<z.ZodString>>;
+  llms: z.ZodPrefault<z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    full: z.ZodDefault<z.ZodBoolean>;
+    copyButton: z.ZodDefault<z.ZodBoolean>;
+    openIn: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+      chatgpt: "chatgpt";
+      claude: "claude";
+      perplexity: "perplexity";
+    }>>>;
+  }, z.core.$strip>>;
+  variables: z.ZodPrefault<z.ZodObject<{
+    resolve: z.ZodDefault<z.ZodBoolean>;
+    hide: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    show: z.ZodDefault<z.ZodBoolean>;
+  }, z.core.$strip>>;
+  filter: z.ZodPrefault<z.ZodObject<{
+    include: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    exclude: z.ZodDefault<z.ZodArray<z.ZodString>>;
+  }, z.core.$strip>>;
+  runInYaak: z.ZodDefault<z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>]>>;
+  head: z.ZodDefault<z.ZodArray<z.ZodObject<{
+    tag: z.ZodEnum<{
+      link: "link";
+      meta: "meta";
+      script: "script";
+      style: "style";
+    }>;
+    attrs: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodBoolean]>>>;
+    content: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>>>;
+}, z.core.$strip>;
+/** Configuration as written by users – every field is optional. */
+type YaakdocConfig = z.input<typeof configSchema>;
+/** Configuration with defaults applied. */
+type ResolvedConfig = z.output<typeof configSchema>;
+type Branding = ResolvedConfig["branding"];
+type HeadTag = z.output<typeof headTagSchema>;
+type Logo = z.output<typeof logoSchema>;
+//#endregion
+export { YaakdocConfig as a, headTagSchema as c, ResolvedConfig as i, logoSchema as l, HeadTag as n, brandingSchema as o, Logo as r, configSchema as s, Branding as t };

package/package.json

@@ -1,6 +1,64 @@
 {
   "name": "@yaakdoc/config",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "Configuration schema and loader for yaakdoc.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "@yaakdoc/source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./node": {
+      "@yaakdoc/source": "./src/node.ts",
+      "types": "./dist/node.d.ts",
+      "default": "./dist/node.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "sideEffects": false,
+  "keywords": [
+    "yaak",
+    "yaakdoc",
+    "config",
+    "schema"
+  ],
+  "author": "József Sallai @jozsefsallai",
+  "license": "MIT",
+  "files": [
+    "/dist",
+    "/README.md",
+    "/LICENSE"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jozsefsallai/yaakdoc.git",
+    "directory": "packages/config"
+  },
+  "bugs": {
+    "url": "https://github.com/jozsefsallai/yaakdoc/issues"
+  },
+  "homepage": "https://github.com/jozsefsallai/yaakdoc#readme",
+  "engines": {
+    "node": ">=20.19"
+  },
+  "devDependencies": {
+    "@repo/tsconfig": "0.0.0"
+  },
+  "dependencies": {
+    "@yaakdoc/core": "^0.1.0",
+    "c12": "^3.3.4",
+    "zod": "^4.6.7"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch --no-clean",
+    "test": "vitest run",
+    "check-types": "tsc",
+    "lint": "biome lint .",
+    "lint:fix": "biome lint . --write",
+    "format": "biome format . --write"
+  }
 }