@character-foundry/character-foundry 0.1.3 → 0.1.5

package/dist/index.d.cts

@@ -0,0 +1,1119 @@
+import { z } from 'zod';
+
+/**
+ * Binary Data Utilities
+ *
+ * Universal binary data operations using Uint8Array.
+ * Works in both Node.js and browser environments.
+ */
+/**
+ * Universal binary data type (works in both environments)
+ */
+export type BinaryData = Uint8Array;
+declare const CCv3CharacterBookSchema: z.ZodObject<{
+	name: z.ZodOptional<z.ZodString>;
+	description: z.ZodOptional<z.ZodString>;
+	scan_depth: z.ZodOptional<z.ZodNumber>;
+	token_budget: z.ZodOptional<z.ZodNumber>;
+	recursive_scanning: z.ZodOptional<z.ZodBoolean>;
+	extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+	entries: z.ZodArray<z.ZodObject<{
+		keys: z.ZodArray<z.ZodString, "many">;
+		content: z.ZodString;
+		enabled: z.ZodBoolean;
+		insertion_order: z.ZodNumber;
+		case_sensitive: z.ZodOptional<z.ZodBoolean>;
+		name: z.ZodOptional<z.ZodString>;
+		priority: z.ZodOptional<z.ZodNumber>;
+		id: z.ZodOptional<z.ZodNumber>;
+		comment: z.ZodOptional<z.ZodString>;
+		selective: z.ZodOptional<z.ZodBoolean>;
+		secondary_keys: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+		constant: z.ZodOptional<z.ZodBoolean>;
+		position: z.ZodOptional<z.ZodEnum<[
+			"before_char",
+			"after_char"
+		]>>;
+		extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+		automation_id: z.ZodOptional<z.ZodString>;
+		role: z.ZodOptional<z.ZodEnum<[
+			"system",
+			"user",
+			"assistant"
+		]>>;
+		group: z.ZodOptional<z.ZodString>;
+		scan_frequency: z.ZodOptional<z.ZodNumber>;
+		probability: z.ZodOptional<z.ZodNumber>;
+		use_regex: z.ZodOptional<z.ZodBoolean>;
+		depth: z.ZodOptional<z.ZodNumber>;
+		selective_logic: z.ZodOptional<z.ZodEnum<[
+			"AND",
+			"NOT"
+		]>>;
+	}, "strip", z.ZodTypeAny, {
+		keys: string[];
+		content: string;
+		enabled: boolean;
+		insertion_order: number;
+		name?: string | undefined;
+		extensions?: Record<string, unknown> | undefined;
+		case_sensitive?: boolean | undefined;
+		priority?: number | undefined;
+		id?: number | undefined;
+		comment?: string | undefined;
+		selective?: boolean | undefined;
+		secondary_keys?: string[] | undefined;
+		constant?: boolean | undefined;
+		position?: "before_char" | "after_char" | undefined;
+		automation_id?: string | undefined;
+		role?: "system" | "user" | "assistant" | undefined;
+		group?: string | undefined;
+		scan_frequency?: number | undefined;
+		probability?: number | undefined;
+		use_regex?: boolean | undefined;
+		depth?: number | undefined;
+		selective_logic?: "AND" | "NOT" | undefined;
+	}, {
+		keys: string[];
+		content: string;
+		enabled: boolean;
+		insertion_order: number;
+		name?: string | undefined;
+		extensions?: Record<string, unknown> | undefined;
+		case_sensitive?: boolean | undefined;
+		priority?: number | undefined;
+		id?: number | undefined;
+		comment?: string | undefined;
+		selective?: boolean | undefined;
+		secondary_keys?: string[] | undefined;
+		constant?: boolean | undefined;
+		position?: "before_char" | "after_char" | undefined;
+		automation_id?: string | undefined;
+		role?: "system" | "user" | "assistant" | undefined;
+		group?: string | undefined;
+		scan_frequency?: number | undefined;
+		probability?: number | undefined;
+		use_regex?: boolean | undefined;
+		depth?: number | undefined;
+		selective_logic?: "AND" | "NOT" | undefined;
+	}>, "many">;
+}, "strip", z.ZodTypeAny, {
+	entries: {
+		keys: string[];
+		content: string;
+		enabled: boolean;
+		insertion_order: number;
+		name?: string | undefined;
+		extensions?: Record<string, unknown> | undefined;
+		case_sensitive?: boolean | undefined;
+		priority?: number | undefined;
+		id?: number | undefined;
+		comment?: string | undefined;
+		selective?: boolean | undefined;
+		secondary_keys?: string[] | undefined;
+		constant?: boolean | undefined;
+		position?: "before_char" | "after_char" | undefined;
+		automation_id?: string | undefined;
+		role?: "system" | "user" | "assistant" | undefined;
+		group?: string | undefined;
+		scan_frequency?: number | undefined;
+		probability?: number | undefined;
+		use_regex?: boolean | undefined;
+		depth?: number | undefined;
+		selective_logic?: "AND" | "NOT" | undefined;
+	}[];
+	name?: string | undefined;
+	description?: string | undefined;
+	scan_depth?: number | undefined;
+	token_budget?: number | undefined;
+	recursive_scanning?: boolean | undefined;
+	extensions?: Record<string, unknown> | undefined;
+}, {
+	entries: {
+		keys: string[];
+		content: string;
+		enabled: boolean;
+		insertion_order: number;
+		name?: string | undefined;
+		extensions?: Record<string, unknown> | undefined;
+		case_sensitive?: boolean | undefined;
+		priority?: number | undefined;
+		id?: number | undefined;
+		comment?: string | undefined;
+		selective?: boolean | undefined;
+		secondary_keys?: string[] | undefined;
+		constant?: boolean | undefined;
+		position?: "before_char" | "after_char" | undefined;
+		automation_id?: string | undefined;
+		role?: "system" | "user" | "assistant" | undefined;
+		group?: string | undefined;
+		scan_frequency?: number | undefined;
+		probability?: number | undefined;
+		use_regex?: boolean | undefined;
+		depth?: number | undefined;
+		selective_logic?: "AND" | "NOT" | undefined;
+	}[];
+	name?: string | undefined;
+	description?: string | undefined;
+	scan_depth?: number | undefined;
+	token_budget?: number | undefined;
+	recursive_scanning?: boolean | undefined;
+	extensions?: Record<string, unknown> | undefined;
+}>;
+declare const CCv3DataSchema: z.ZodObject<{
+	spec: z.ZodLiteral<"chara_card_v3">;
+	spec_version: z.ZodLiteral<"3.0">;
+	data: z.ZodObject<{
+		name: z.ZodDefault<z.ZodString>;
+		description: z.ZodDefault<z.ZodString>;
+		personality: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+		scenario: z.ZodDefault<z.ZodString>;
+		first_mes: z.ZodDefault<z.ZodString>;
+		mes_example: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+		creator: z.ZodDefault<z.ZodString>;
+		character_version: z.ZodDefault<z.ZodString>;
+		tags: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+		group_only_greetings: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+		creator_notes: z.ZodOptional<z.ZodString>;
+		system_prompt: z.ZodOptional<z.ZodString>;
+		post_history_instructions: z.ZodOptional<z.ZodString>;
+		alternate_greetings: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+		character_book: z.ZodNullable<z.ZodOptional<z.ZodObject<{
+			name: z.ZodOptional<z.ZodString>;
+			description: z.ZodOptional<z.ZodString>;
+			scan_depth: z.ZodOptional<z.ZodNumber>;
+			token_budget: z.ZodOptional<z.ZodNumber>;
+			recursive_scanning: z.ZodOptional<z.ZodBoolean>;
+			extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+			entries: z.ZodArray<z.ZodObject<{
+				keys: z.ZodArray<z.ZodString, "many">;
+				content: z.ZodString;
+				enabled: z.ZodBoolean;
+				insertion_order: z.ZodNumber;
+				case_sensitive: z.ZodOptional<z.ZodBoolean>;
+				name: z.ZodOptional<z.ZodString>;
+				priority: z.ZodOptional<z.ZodNumber>;
+				id: z.ZodOptional<z.ZodNumber>;
+				comment: z.ZodOptional<z.ZodString>;
+				selective: z.ZodOptional<z.ZodBoolean>;
+				secondary_keys: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+				constant: z.ZodOptional<z.ZodBoolean>;
+				position: z.ZodOptional<z.ZodEnum<[
+					"before_char",
+					"after_char"
+				]>>;
+				extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+				automation_id: z.ZodOptional<z.ZodString>;
+				role: z.ZodOptional<z.ZodEnum<[
+					"system",
+					"user",
+					"assistant"
+				]>>;
+				group: z.ZodOptional<z.ZodString>;
+				scan_frequency: z.ZodOptional<z.ZodNumber>;
+				probability: z.ZodOptional<z.ZodNumber>;
+				use_regex: z.ZodOptional<z.ZodBoolean>;
+				depth: z.ZodOptional<z.ZodNumber>;
+				selective_logic: z.ZodOptional<z.ZodEnum<[
+					"AND",
+					"NOT"
+				]>>;
+			}, "strip", z.ZodTypeAny, {
+				keys: string[];
+				content: string;
+				enabled: boolean;
+				insertion_order: number;
+				name?: string | undefined;
+				extensions?: Record<string, unknown> | undefined;
+				case_sensitive?: boolean | undefined;
+				priority?: number | undefined;
+				id?: number | undefined;
+				comment?: string | undefined;
+				selective?: boolean | undefined;
+				secondary_keys?: string[] | undefined;
+				constant?: boolean | undefined;
+				position?: "before_char" | "after_char" | undefined;
+				automation_id?: string | undefined;
+				role?: "system" | "user" | "assistant" | undefined;
+				group?: string | undefined;
+				scan_frequency?: number | undefined;
+				probability?: number | undefined;
+				use_regex?: boolean | undefined;
+				depth?: number | undefined;
+				selective_logic?: "AND" | "NOT" | undefined;
+			}, {
+				keys: string[];
+				content: string;
+				enabled: boolean;
+				insertion_order: number;
+				name?: string | undefined;
+				extensions?: Record<string, unknown> | undefined;
+				case_sensitive?: boolean | undefined;
+				priority?: number | undefined;
+				id?: number | undefined;
+				comment?: string | undefined;
+				selective?: boolean | undefined;
+				secondary_keys?: string[] | undefined;
+				constant?: boolean | undefined;
+				position?: "before_char" | "after_char" | undefined;
+				automation_id?: string | undefined;
+				role?: "system" | "user" | "assistant" | undefined;
+				group?: string | undefined;
+				scan_frequency?: number | undefined;
+				probability?: number | undefined;
+				use_regex?: boolean | undefined;
+				depth?: number | undefined;
+				selective_logic?: "AND" | "NOT" | undefined;
+			}>, "many">;
+		}, "strip", z.ZodTypeAny, {
+			entries: {
+				keys: string[];
+				content: string;
+				enabled: boolean;
+				insertion_order: number;
+				name?: string | undefined;
+				extensions?: Record<string, unknown> | undefined;
+				case_sensitive?: boolean | undefined;
+				priority?: number | undefined;
+				id?: number | undefined;
+				comment?: string | undefined;
+				selective?: boolean | undefined;
+				secondary_keys?: string[] | undefined;
+				constant?: boolean | undefined;
+				position?: "before_char" | "after_char" | undefined;
+				automation_id?: string | undefined;
+				role?: "system" | "user" | "assistant" | undefined;
+				group?: string | undefined;
+				scan_frequency?: number | undefined;
+				probability?: number | undefined;
+				use_regex?: boolean | undefined;
+				depth?: number | undefined;
+				selective_logic?: "AND" | "NOT" | undefined;
+			}[];
+			name?: string | undefined;
+			description?: string | undefined;
+			scan_depth?: number | undefined;
+			token_budget?: number | undefined;
+			recursive_scanning?: boolean | undefined;
+			extensions?: Record<string, unknown> | undefined;
+		}, {
+			entries: {
+				keys: string[];
+				content: string;
+				enabled: boolean;
+				insertion_order: number;
+				name?: string | undefined;
+				extensions?: Record<string, unknown> | undefined;
+				case_sensitive?: boolean | undefined;
+				priority?: number | undefined;
+				id?: number | undefined;
+				comment?: string | undefined;
+				selective?: boolean | undefined;
+				secondary_keys?: string[] | undefined;
+				constant?: boolean | undefined;
+				position?: "before_char" | "after_char" | undefined;
+				automation_id?: string | undefined;
+				role?: "system" | "user" | "assistant" | undefined;
+				group?: string | undefined;
+				scan_frequency?: number | undefined;
+				probability?: number | undefined;
+				use_regex?: boolean | undefined;
+				depth?: number | undefined;
+				selective_logic?: "AND" | "NOT" | undefined;
+			}[];
+			name?: string | undefined;
+			description?: string | undefined;
+			scan_depth?: number | undefined;
+			token_budget?: number | undefined;
+			recursive_scanning?: boolean | undefined;
+			extensions?: Record<string, unknown> | undefined;
+		}>>>;
+		extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+		assets: z.ZodOptional<z.ZodArray<z.ZodObject<{
+			type: z.ZodEnum<[
+				"icon",
+				"background",
+				"emotion",
+				"user_icon",
+				"sound",
+				"video",
+				"custom",
+				"x-risu-asset"
+			]>;
+			uri: z.ZodString;
+			name: z.ZodString;
+			ext: z.ZodString;
+		}, "strip", z.ZodTypeAny, {
+			name: string;
+			type: "custom" | "icon" | "background" | "emotion" | "user_icon" | "sound" | "video" | "x-risu-asset";
+			uri: string;
+			ext: string;
+		}, {
+			name: string;
+			type: "custom" | "icon" | "background" | "emotion" | "user_icon" | "sound" | "video" | "x-risu-asset";
+			uri: string;
+			ext: string;
+		}>, "many">>;
+		nickname: z.ZodOptional<z.ZodString>;
+		creator_notes_multilingual: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+		source: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+		creation_date: z.ZodOptional<z.ZodNumber>;
+		modification_date: z.ZodOptional<z.ZodNumber>;
+	}, "strip", z.ZodTypeAny, {
+		name: string;
+		description: string;
+		personality: string | null;
+		scenario: string;
+		first_mes: string;
+		mes_example: string | null;
+		tags: string[];
+		creator: string;
+		character_version: string;
+		group_only_greetings: string[];
+		extensions?: Record<string, unknown> | undefined;
+		creator_notes?: string | undefined;
+		system_prompt?: string | undefined;
+		post_history_instructions?: string | undefined;
+		alternate_greetings?: string[] | undefined;
+		character_book?: {
+			entries: {
+				keys: string[];
+				content: string;
+				enabled: boolean;
+				insertion_order: number;
+				name?: string | undefined;
+				extensions?: Record<string, unknown> | undefined;
+				case_sensitive?: boolean | undefined;
+				priority?: number | undefined;
+				id?: number | undefined;
+				comment?: string | undefined;
+				selective?: boolean | undefined;
+				secondary_keys?: string[] | undefined;
+				constant?: boolean | undefined;
+				position?: "before_char" | "after_char" | undefined;
+				automation_id?: string | undefined;
+				role?: "system" | "user" | "assistant" | undefined;
+				group?: string | undefined;
+				scan_frequency?: number | undefined;
+				probability?: number | undefined;
+				use_regex?: boolean | undefined;
+				depth?: number | undefined;
+				selective_logic?: "AND" | "NOT" | undefined;
+			}[];
+			name?: string | undefined;
+			description?: string | undefined;
+			scan_depth?: number | undefined;
+			token_budget?: number | undefined;
+			recursive_scanning?: boolean | undefined;
+			extensions?: Record<string, unknown> | undefined;
+		} | null | undefined;
+		assets?: {
+			name: string;
+			type: "custom" | "icon" | "background" | "emotion" | "user_icon" | "sound" | "video" | "x-risu-asset";
+			uri: string;
+			ext: string;
+		}[] | undefined;
+		nickname?: string | undefined;
+		creator_notes_multilingual?: Record<string, string> | undefined;
+		source?: string[] | undefined;
+		creation_date?: number | undefined;
+		modification_date?: number | undefined;
+	}, {
+		name?: string | undefined;
+		description?: string | undefined;
+		extensions?: Record<string, unknown> | undefined;
+		personality?: string | null | undefined;
+		scenario?: string | undefined;
+		first_mes?: string | undefined;
+		mes_example?: string | null | undefined;
+		creator_notes?: string | undefined;
+		system_prompt?: string | undefined;
+		post_history_instructions?: string | undefined;
+		alternate_greetings?: string[] | undefined;
+		character_book?: {
+			entries: {
+				keys: string[];
+				content: string;
+				enabled: boolean;
+				insertion_order: number;
+				name?: string | undefined;
+				extensions?: Record<string, unknown> | undefined;
+				case_sensitive?: boolean | undefined;
+				priority?: number | undefined;
+				id?: number | undefined;
+				comment?: string | undefined;
+				selective?: boolean | undefined;
+				secondary_keys?: string[] | undefined;
+				constant?: boolean | undefined;
+				position?: "before_char" | "after_char" | undefined;
+				automation_id?: string | undefined;
+				role?: "system" | "user" | "assistant" | undefined;
+				group?: string | undefined;
+				scan_frequency?: number | undefined;
+				probability?: number | undefined;
+				use_regex?: boolean | undefined;
+				depth?: number | undefined;
+				selective_logic?: "AND" | "NOT" | undefined;
+			}[];
+			name?: string | undefined;
+			description?: string | undefined;
+			scan_depth?: number | undefined;
+			token_budget?: number | undefined;
+			recursive_scanning?: boolean | undefined;
+			extensions?: Record<string, unknown> | undefined;
+		} | null | undefined;
+		tags?: string[] | undefined;
+		creator?: string | undefined;
+		character_version?: string | undefined;
+		group_only_greetings?: string[] | undefined;
+		assets?: {
+			name: string;
+			type: "custom" | "icon" | "background" | "emotion" | "user_icon" | "sound" | "video" | "x-risu-asset";
+			uri: string;
+			ext: string;
+		}[] | undefined;
+		nickname?: string | undefined;
+		creator_notes_multilingual?: Record<string, string> | undefined;
+		source?: string[] | undefined;
+		creation_date?: number | undefined;
+		modification_date?: number | undefined;
+	}>;
+}, "strip", z.ZodTypeAny, {
+	data: {
+		name: string;
+		description: string;
+		personality: string | null;
+		scenario: string;
+		first_mes: string;
+		mes_example: string | null;
+		tags: string[];
+		creator: string;
+		character_version: string;
+		group_only_greetings: string[];
+		extensions?: Record<string, unknown> | undefined;
+		creator_notes?: string | undefined;
+		system_prompt?: string | undefined;
+		post_history_instructions?: string | undefined;
+		alternate_greetings?: string[] | undefined;
+		character_book?: {
+			entries: {
+				keys: string[];
+				content: string;
+				enabled: boolean;
+				insertion_order: number;
+				name?: string | undefined;
+				extensions?: Record<string, unknown> | undefined;
+				case_sensitive?: boolean | undefined;
+				priority?: number | undefined;
+				id?: number | undefined;
+				comment?: string | undefined;
+				selective?: boolean | undefined;
+				secondary_keys?: string[] | undefined;
+				constant?: boolean | undefined;
+				position?: "before_char" | "after_char" | undefined;
+				automation_id?: string | undefined;
+				role?: "system" | "user" | "assistant" | undefined;
+				group?: string | undefined;
+				scan_frequency?: number | undefined;
+				probability?: number | undefined;
+				use_regex?: boolean | undefined;
+				depth?: number | undefined;
+				selective_logic?: "AND" | "NOT" | undefined;
+			}[];
+			name?: string | undefined;
+			description?: string | undefined;
+			scan_depth?: number | undefined;
+			token_budget?: number | undefined;
+			recursive_scanning?: boolean | undefined;
+			extensions?: Record<string, unknown> | undefined;
+		} | null | undefined;
+		assets?: {
+			name: string;
+			type: "custom" | "icon" | "background" | "emotion" | "user_icon" | "sound" | "video" | "x-risu-asset";
+			uri: string;
+			ext: string;
+		}[] | undefined;
+		nickname?: string | undefined;
+		creator_notes_multilingual?: Record<string, string> | undefined;
+		source?: string[] | undefined;
+		creation_date?: number | undefined;
+		modification_date?: number | undefined;
+	};
+	spec: "chara_card_v3";
+	spec_version: "3.0";
+}, {
+	data: {
+		name?: string | undefined;
+		description?: string | undefined;
+		extensions?: Record<string, unknown> | undefined;
+		personality?: string | null | undefined;
+		scenario?: string | undefined;
+		first_mes?: string | undefined;
+		mes_example?: string | null | undefined;
+		creator_notes?: string | undefined;
+		system_prompt?: string | undefined;
+		post_history_instructions?: string | undefined;
+		alternate_greetings?: string[] | undefined;
+		character_book?: {
+			entries: {
+				keys: string[];
+				content: string;
+				enabled: boolean;
+				insertion_order: number;
+				name?: string | undefined;
+				extensions?: Record<string, unknown> | undefined;
+				case_sensitive?: boolean | undefined;
+				priority?: number | undefined;
+				id?: number | undefined;
+				comment?: string | undefined;
+				selective?: boolean | undefined;
+				secondary_keys?: string[] | undefined;
+				constant?: boolean | undefined;
+				position?: "before_char" | "after_char" | undefined;
+				automation_id?: string | undefined;
+				role?: "system" | "user" | "assistant" | undefined;
+				group?: string | undefined;
+				scan_frequency?: number | undefined;
+				probability?: number | undefined;
+				use_regex?: boolean | undefined;
+				depth?: number | undefined;
+				selective_logic?: "AND" | "NOT" | undefined;
+			}[];
+			name?: string | undefined;
+			description?: string | undefined;
+			scan_depth?: number | undefined;
+			token_budget?: number | undefined;
+			recursive_scanning?: boolean | undefined;
+			extensions?: Record<string, unknown> | undefined;
+		} | null | undefined;
+		tags?: string[] | undefined;
+		creator?: string | undefined;
+		character_version?: string | undefined;
+		group_only_greetings?: string[] | undefined;
+		assets?: {
+			name: string;
+			type: "custom" | "icon" | "background" | "emotion" | "user_icon" | "sound" | "video" | "x-risu-asset";
+			uri: string;
+			ext: string;
+		}[] | undefined;
+		nickname?: string | undefined;
+		creator_notes_multilingual?: Record<string, string> | undefined;
+		source?: string[] | undefined;
+		creation_date?: number | undefined;
+		modification_date?: number | undefined;
+	};
+	spec: "chara_card_v3";
+	spec_version: "3.0";
+}>;
+/**
+ * Character book (lorebook) for v3 cards
+ */
+export type CCv3CharacterBook = z.infer<typeof CCv3CharacterBookSchema>;
+/**
+ * Character Card v3 full structure
+ */
+export type CCv3Data = z.infer<typeof CCv3DataSchema>;
+declare const SpecSchema: z.ZodEnum<[
+	"v2",
+	"v3"
+]>;
+declare const SourceFormatSchema: z.ZodEnum<[
+	"png_v2",
+	"png_v3",
+	"json_v2",
+	"json_v3",
+	"charx",
+	"charx_risu",
+	"charx_jpeg",
+	"voxta"
+]>;
+/**
+ * Card specification version
+ */
+export type Spec = z.infer<typeof SpecSchema>;
+/**
+ * Source format identifier
+ */
+export type SourceFormat = z.infer<typeof SourceFormatSchema>;
+declare const CCv2DataSchema: z.ZodObject<{
+	name: z.ZodDefault<z.ZodString>;
+	description: z.ZodDefault<z.ZodString>;
+	personality: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+	scenario: z.ZodDefault<z.ZodString>;
+	first_mes: z.ZodDefault<z.ZodString>;
+	mes_example: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+	creator_notes: z.ZodOptional<z.ZodString>;
+	system_prompt: z.ZodOptional<z.ZodString>;
+	post_history_instructions: z.ZodOptional<z.ZodString>;
+	alternate_greetings: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+	character_book: z.ZodNullable<z.ZodOptional<z.ZodObject<{
+		name: z.ZodOptional<z.ZodString>;
+		description: z.ZodOptional<z.ZodString>;
+		scan_depth: z.ZodOptional<z.ZodNumber>;
+		token_budget: z.ZodOptional<z.ZodNumber>;
+		recursive_scanning: z.ZodOptional<z.ZodBoolean>;
+		extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+		entries: z.ZodArray<z.ZodObject<{
+			keys: z.ZodArray<z.ZodString, "many">;
+			content: z.ZodString;
+			enabled: z.ZodBoolean;
+			insertion_order: z.ZodNumber;
+			extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+			case_sensitive: z.ZodOptional<z.ZodBoolean>;
+			name: z.ZodOptional<z.ZodString>;
+			priority: z.ZodOptional<z.ZodNumber>;
+			id: z.ZodOptional<z.ZodNumber>;
+			comment: z.ZodOptional<z.ZodString>;
+			selective: z.ZodOptional<z.ZodBoolean>;
+			secondary_keys: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+			constant: z.ZodOptional<z.ZodBoolean>;
+			position: z.ZodOptional<z.ZodEnum<[
+				"before_char",
+				"after_char"
+			]>>;
+		}, "strip", z.ZodTypeAny, {
+			keys: string[];
+			content: string;
+			enabled: boolean;
+			insertion_order: number;
+			name?: string | undefined;
+			extensions?: Record<string, unknown> | undefined;
+			case_sensitive?: boolean | undefined;
+			priority?: number | undefined;
+			id?: number | undefined;
+			comment?: string | undefined;
+			selective?: boolean | undefined;
+			secondary_keys?: string[] | undefined;
+			constant?: boolean | undefined;
+			position?: "before_char" | "after_char" | undefined;
+		}, {
+			keys: string[];
+			content: string;
+			enabled: boolean;
+			insertion_order: number;
+			name?: string | undefined;
+			extensions?: Record<string, unknown> | undefined;
+			case_sensitive?: boolean | undefined;
+			priority?: number | undefined;
+			id?: number | undefined;
+			comment?: string | undefined;
+			selective?: boolean | undefined;
+			secondary_keys?: string[] | undefined;
+			constant?: boolean | undefined;
+			position?: "before_char" | "after_char" | undefined;
+		}>, "many">;
+	}, "strip", z.ZodTypeAny, {
+		entries: {
+			keys: string[];
+			content: string;
+			enabled: boolean;
+			insertion_order: number;
+			name?: string | undefined;
+			extensions?: Record<string, unknown> | undefined;
+			case_sensitive?: boolean | undefined;
+			priority?: number | undefined;
+			id?: number | undefined;
+			comment?: string | undefined;
+			selective?: boolean | undefined;
+			secondary_keys?: string[] | undefined;
+			constant?: boolean | undefined;
+			position?: "before_char" | "after_char" | undefined;
+		}[];
+		name?: string | undefined;
+		description?: string | undefined;
+		scan_depth?: number | undefined;
+		token_budget?: number | undefined;
+		recursive_scanning?: boolean | undefined;
+		extensions?: Record<string, unknown> | undefined;
+	}, {
+		entries: {
+			keys: string[];
+			content: string;
+			enabled: boolean;
+			insertion_order: number;
+			name?: string | undefined;
+			extensions?: Record<string, unknown> | undefined;
+			case_sensitive?: boolean | undefined;
+			priority?: number | undefined;
+			id?: number | undefined;
+			comment?: string | undefined;
+			selective?: boolean | undefined;
+			secondary_keys?: string[] | undefined;
+			constant?: boolean | undefined;
+			position?: "before_char" | "after_char" | undefined;
+		}[];
+		name?: string | undefined;
+		description?: string | undefined;
+		scan_depth?: number | undefined;
+		token_budget?: number | undefined;
+		recursive_scanning?: boolean | undefined;
+		extensions?: Record<string, unknown> | undefined;
+	}>>>;
+	tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+	creator: z.ZodOptional<z.ZodString>;
+	character_version: z.ZodOptional<z.ZodString>;
+	extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+	name: string;
+	description: string;
+	personality: string | null;
+	scenario: string;
+	first_mes: string;
+	mes_example: string | null;
+	extensions?: Record<string, unknown> | undefined;
+	creator_notes?: string | undefined;
+	system_prompt?: string | undefined;
+	post_history_instructions?: string | undefined;
+	alternate_greetings?: string[] | undefined;
+	character_book?: {
+		entries: {
+			keys: string[];
+			content: string;
+			enabled: boolean;
+			insertion_order: number;
+			name?: string | undefined;
+			extensions?: Record<string, unknown> | undefined;
+			case_sensitive?: boolean | undefined;
+			priority?: number | undefined;
+			id?: number | undefined;
+			comment?: string | undefined;
+			selective?: boolean | undefined;
+			secondary_keys?: string[] | undefined;
+			constant?: boolean | undefined;
+			position?: "before_char" | "after_char" | undefined;
+		}[];
+		name?: string | undefined;
+		description?: string | undefined;
+		scan_depth?: number | undefined;
+		token_budget?: number | undefined;
+		recursive_scanning?: boolean | undefined;
+		extensions?: Record<string, unknown> | undefined;
+	} | null | undefined;
+	tags?: string[] | undefined;
+	creator?: string | undefined;
+	character_version?: string | undefined;
+}, {
+	name?: string | undefined;
+	description?: string | undefined;
+	extensions?: Record<string, unknown> | undefined;
+	personality?: string | null | undefined;
+	scenario?: string | undefined;
+	first_mes?: string | undefined;
+	mes_example?: string | null | undefined;
+	creator_notes?: string | undefined;
+	system_prompt?: string | undefined;
+	post_history_instructions?: string | undefined;
+	alternate_greetings?: string[] | undefined;
+	character_book?: {
+		entries: {
+			keys: string[];
+			content: string;
+			enabled: boolean;
+			insertion_order: number;
+			name?: string | undefined;
+			extensions?: Record<string, unknown> | undefined;
+			case_sensitive?: boolean | undefined;
+			priority?: number | undefined;
+			id?: number | undefined;
+			comment?: string | undefined;
+			selective?: boolean | undefined;
+			secondary_keys?: string[] | undefined;
+			constant?: boolean | undefined;
+			position?: "before_char" | "after_char" | undefined;
+		}[];
+		name?: string | undefined;
+		description?: string | undefined;
+		scan_depth?: number | undefined;
+		token_budget?: number | undefined;
+		recursive_scanning?: boolean | undefined;
+		extensions?: Record<string, unknown> | undefined;
+	} | null | undefined;
+	tags?: string[] | undefined;
+	creator?: string | undefined;
+	character_version?: string | undefined;
+}>;
+/**
+ * Character Card v2 data structure
+ */
+export type CCv2Data = z.infer<typeof CCv2DataSchema>;
+/**
+ * Format Detection
+ *
+ * Detect card specification version from JSON data.
+ */
+/**
+ * Result from detailed spec detection
+ */
+export interface SpecDetectionResult {
+	/** Detected spec version */
+	spec: Spec | null;
+	/** Confidence level of detection */
+	confidence: "high" | "medium" | "low";
+	/** What fields/values indicated this spec */
+	indicators: string[];
+	/** Anomalies or inconsistencies detected */
+	warnings: string[];
+}
+/**
+ * Detect card spec version from parsed JSON
+ * Returns 'v2', 'v3', or null if not recognized
+ */
+export declare function detectSpec(data: unknown): Spec | null;
+/**
+ * Loader Types
+ *
+ * Types for the universal card loader API.
+ */
+/**
+ * Detected container format (the file type)
+ */
+export type ContainerFormat = "png" | "charx" | "voxta" | "json" | "lorebook" | "unknown";
+/**
+ * Asset extracted from a card
+ */
+export interface ExtractedAsset {
+	/** Asset name/identifier */
+	name: string;
+	/** Asset type */
+	type: "icon" | "emotion" | "background" | "sound" | "data" | "unknown";
+	/** File extension */
+	ext: string;
+	/** Binary data */
+	data: BinaryData;
+	/** Asset path within archive (if applicable) */
+	path?: string;
+	/** Whether this is the main/primary asset */
+	isMain?: boolean;
+	/** Associated character ID (for multi-character packages) */
+	characterId?: string;
+	/** Additional tags */
+	tags?: string[];
+}
+/**
+ * Result of parsing a character card
+ */
+export interface ParseResult {
+	/** Normalized card data in CCv3 format */
+	card: CCv3Data;
+	/** Extracted assets */
+	assets: ExtractedAsset[];
+	/** Original container format */
+	containerFormat: ContainerFormat;
+	/** Detected spec version */
+	spec: Spec;
+	/** Original source format indicator */
+	sourceFormat: SourceFormat;
+	/** The raw JSON object before normalization */
+	originalShape: unknown;
+	/** Raw JSON string (if available) */
+	rawJson?: string;
+	/** Original file buffer */
+	rawBuffer: BinaryData;
+	/** Additional metadata from container */
+	metadata?: {
+		/** Character ID (for Voxta/CharX) */
+		characterId?: string;
+		/** Package ID (for Voxta) */
+		packageId?: string;
+		/** Creation date */
+		dateCreated?: string;
+		/** Modification date */
+		dateModified?: string;
+		/** Risu module.risum binary (opaque, preserved for round-trip) */
+		moduleRisum?: BinaryData;
+	};
+	/** Non-fatal warnings encountered during parsing */
+	warnings?: string[];
+}
+/**
+ * Options for the parseCard function
+ */
+export interface ParseOptions {
+	/** Maximum file size to process (default: 50MB) */
+	maxFileSize?: number;
+	/** Maximum individual asset size (default: 50MB) */
+	maxAssetSize?: number;
+	/** Maximum total size for archives (default: 500MB) */
+	maxTotalSize?: number;
+	/** Whether to extract assets (default: true) */
+	extractAssets?: boolean;
+}
+/**
+ * Detection result
+ */
+export interface DetectionResult {
+	/** Detected container format */
+	format: ContainerFormat;
+	/** Confidence level */
+	confidence: "high" | "medium" | "low";
+	/** Reason for detection */
+	reason: string;
+}
+/**
+ * Format Detector
+ *
+ * Detects the container format of character card data.
+ */
+/**
+ * Detect the container format of data
+ */
+export declare function detectFormat(data: BinaryData): DetectionResult;
+/**
+ * Universal Card Loader
+ *
+ * Loads character cards from any supported format.
+ */
+/**
+ * Parse a character card from any supported format
+ *
+ * @param data - Binary data of the card file
+ * @param options - Parsing options
+ * @returns ParseResult with normalized card and extracted assets
+ */
+export declare function parseCard(data: BinaryData, options?: ParseOptions): ParseResult;
+/**
+ * Async version of parseCard
+ */
+export declare function parseCardAsync(data: BinaryData, options?: ParseOptions): Promise<ParseResult>;
+/**
+ * Exporter Types
+ *
+ * Types for the universal card exporter API.
+ */
+/**
+ * Target export format
+ */
+export type ExportFormat = "png" | "charx" | "voxta";
+/**
+ * Asset to include in export
+ */
+export interface ExportAsset {
+	/** Asset name/identifier */
+	name: string;
+	/** Asset type */
+	type: "icon" | "emotion" | "background" | "sound" | "data" | "custom";
+	/** File extension */
+	ext: string;
+	/** Binary data */
+	data: BinaryData;
+	/** Whether this is the main/primary asset (used for PNG embedding) */
+	isMain?: boolean;
+	/** Original path or source identifier (e.g., pngchunk:0) */
+	path?: string;
+	/** Additional tags for categorization */
+	tags?: string[];
+}
+/**
+ * Loss report for export
+ */
+export interface ExportLossReport {
+	/** Fields that will be lost */
+	lostFields: string[];
+	/** Assets that cannot be exported */
+	lostAssets: string[];
+	/** Warnings about potential issues */
+	warnings: string[];
+	/** Target format */
+	targetFormat: ExportFormat;
+	/** Whether export is lossless */
+	isLossless: boolean;
+}
+/**
+ * Common export options
+ */
+export interface ExportOptionsBase {
+	/** Whether to check for loss before export (default: true) */
+	checkLoss?: boolean;
+	/** Compression level for ZIP-based formats (0-9, default: 6) */
+	compressionLevel?: 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9;
+}
+/**
+ * PNG export options
+ */
+export interface PngExportOptions extends ExportOptionsBase {
+	/** Chunk key to use (default: 'chara' for v2 compat, 'ccv3' for v3) */
+	chunkKey?: "chara" | "ccv3" | "chara_card_v3";
+	/** Whether to use zTXt (compressed) chunk (default: true for large cards) */
+	useCompression?: boolean;
+	/** Export as v2 format for maximum compatibility (default: false) */
+	exportAsV2?: boolean;
+}
+/**
+ * CharX export options
+ */
+export interface CharxExportOptions extends ExportOptionsBase {
+	/** Target spec: 'v3' = standard, 'risu' = include x_meta */
+	spec?: "v3" | "risu";
+	/** Include readme.txt (default: false) */
+	includeReadme?: boolean;
+	/** Emit x_meta for image assets (default: false, auto-enabled for risu spec) */
+	emitXMeta?: boolean;
+	/** Risu module.risum binary to include (opaque, preserved from read) */
+	moduleRisum?: BinaryData;
+}
+/**
+ * Voxta export options
+ */
+export interface VoxtaExportOptions extends ExportOptionsBase {
+	/** Character ID to use (auto-generated if not provided) */
+	characterId?: string;
+	/** Package ID to use (auto-generated if not provided) */
+	packageId?: string;
+	/** Include package.json metadata (default: false) */
+	includePackageJson?: boolean;
+}
+/**
+ * Result of exporting a card
+ */
+export interface ExportResult {
+	/** The exported binary data */
+	buffer: BinaryData;
+	/** Target format that was used */
+	format: ExportFormat;
+	/** Suggested filename */
+	filename: string;
+	/** MIME type for the export */
+	mimeType: string;
+	/** Number of assets included */
+	assetCount: number;
+	/** Total size in bytes */
+	totalSize: number;
+	/** Loss report (if checkLoss was enabled) */
+	lossReport?: ExportLossReport;
+}
+/**
+ * Universal Card Exporter
+ *
+ * Exports character cards to any supported format.
+ */
+/**
+ * Options for exportCard function
+ */
+export interface ExportCardOptions {
+	/** Target format */
+	format: ExportFormat;
+	/** Format-specific options */
+	png?: PngExportOptions;
+	charx?: CharxExportOptions;
+	voxta?: VoxtaExportOptions;
+}
+/**
+ * Export a character card to any supported format
+ *
+ * @param card - CCv3 card data to export
+ * @param assets - Assets to include in export
+ * @param options - Export options including target format
+ * @returns ExportResult with buffer and metadata
+ */
+export declare function exportCard(card: CCv3Data, assets: ExportAsset[], options: ExportCardOptions): ExportResult;
+/**
+ * Export Loss Checker
+ *
+ * Analyzes what data would be lost when exporting to different formats.
+ */
+/**
+ * Check what would be lost when exporting to a specific format
+ */
+export declare function checkExportLoss(card: CCv3Data, assets: ExportAsset[], targetFormat: ExportFormat): ExportLossReport;
+
+export {};