@character-foundry/character-foundry 0.1.3 → 0.1.6

package/dist/schemas.js

@@ -1,2 +1,856 @@
-export * from '@character-foundry/schemas';
+// ../schemas/dist/index.js
+import { z } from "zod";
+import { z as z2 } from "zod";
+import { z as z3 } from "zod";
+import "zod";
+var ISO8601Schema = z.string().datetime();
+var UUIDSchema = z.string().uuid();
+var SpecSchema = z.enum(["v2", "v3"]);
+var SourceFormatSchema = z.enum([
+  "png_v2",
+  // PNG with 'chara' chunk (v2)
+  "png_v3",
+  // PNG with 'ccv3' chunk (v3)
+  "json_v2",
+  // Raw JSON v2
+  "json_v3",
+  // Raw JSON v3
+  "charx",
+  // ZIP with card.json (v3 spec)
+  "charx_risu",
+  // ZIP with card.json + module.risum
+  "charx_jpeg",
+  // JPEG with appended ZIP (read-only)
+  "voxta"
+  // VoxPkg format
+]);
+var OriginalShapeSchema = z.enum(["wrapped", "unwrapped", "legacy"]);
+var AssetTypeSchema = z.enum([
+  "icon",
+  "background",
+  "emotion",
+  "user_icon",
+  "sound",
+  "video",
+  "custom",
+  "x-risu-asset"
+]);
+var AssetDescriptorSchema = z.object({
+  type: AssetTypeSchema,
+  uri: z.string(),
+  name: z.string(),
+  ext: z.string()
+});
+var ExtractedAssetSchema = z.object({
+  descriptor: AssetDescriptorSchema,
+  data: z.instanceof(Uint8Array),
+  mimeType: z.string()
+});
+var CCv2LorebookEntrySchema = z2.object({
+  keys: z2.array(z2.string()),
+  content: z2.string(),
+  enabled: z2.boolean(),
+  insertion_order: z2.number().int(),
+  // Optional fields
+  extensions: z2.record(z2.unknown()).optional(),
+  case_sensitive: z2.boolean().optional(),
+  name: z2.string().optional(),
+  priority: z2.number().int().optional(),
+  id: z2.number().int().optional(),
+  comment: z2.string().optional(),
+  selective: z2.boolean().optional(),
+  secondary_keys: z2.array(z2.string()).optional(),
+  constant: z2.boolean().optional(),
+  position: z2.enum(["before_char", "after_char"]).optional()
+});
+var CCv2CharacterBookSchema = z2.object({
+  name: z2.string().optional(),
+  description: z2.string().optional(),
+  scan_depth: z2.number().int().nonnegative().optional(),
+  token_budget: z2.number().int().nonnegative().optional(),
+  recursive_scanning: z2.boolean().optional(),
+  extensions: z2.record(z2.unknown()).optional(),
+  entries: z2.array(CCv2LorebookEntrySchema)
+});
+var CCv2DataSchema = z2.object({
+  // Core fields - use .default('') to handle missing fields in malformed cards
+  name: z2.string().default(""),
+  description: z2.string().default(""),
+  personality: z2.string().nullable().default(""),
+  // Can be null in wild (141 cards)
+  scenario: z2.string().default(""),
+  first_mes: z2.string().default(""),
+  mes_example: z2.string().nullable().default(""),
+  // Can be null in wild (186 cards)
+  // Optional fields
+  creator_notes: z2.string().optional(),
+  system_prompt: z2.string().optional(),
+  post_history_instructions: z2.string().optional(),
+  alternate_greetings: z2.array(z2.string()).optional(),
+  character_book: CCv2CharacterBookSchema.optional().nullable(),
+  tags: z2.array(z2.string()).optional(),
+  creator: z2.string().optional(),
+  character_version: z2.string().optional(),
+  extensions: z2.record(z2.unknown()).optional()
+});
+var CCv2WrappedSchema = z2.object({
+  spec: z2.literal("chara_card_v2"),
+  spec_version: z2.literal("2.0"),
+  data: CCv2DataSchema
+});
+function isWrappedV2(data) {
+  return CCv2WrappedSchema.safeParse(data).success;
+}
+function isV2CardData(data) {
+  return CCv2WrappedSchema.safeParse(data).success || CCv2DataSchema.safeParse(data).success;
+}
+function parseWrappedV2(data) {
+  return CCv2WrappedSchema.parse(data);
+}
+function parseV2Data(data) {
+  return CCv2DataSchema.parse(data);
+}
+function looksLikeWrappedV2(data) {
+  if (!data || typeof data !== "object") return false;
+  const obj = data;
+  return obj.spec === "chara_card_v2" && obj.data !== null && typeof obj.data === "object";
+}
+function getV2Data(card) {
+  if (looksLikeWrappedV2(card)) {
+    return card.data;
+  }
+  return card;
+}
+var CCv3LorebookEntrySchema = z3.object({
+  keys: z3.array(z3.string()),
+  content: z3.string(),
+  enabled: z3.boolean(),
+  insertion_order: z3.number().int(),
+  // Optional fields
+  case_sensitive: z3.boolean().optional(),
+  name: z3.string().optional(),
+  priority: z3.number().int().optional(),
+  id: z3.number().int().optional(),
+  comment: z3.string().optional(),
+  selective: z3.boolean().optional(),
+  secondary_keys: z3.array(z3.string()).optional(),
+  constant: z3.boolean().optional(),
+  position: z3.enum(["before_char", "after_char"]).optional(),
+  extensions: z3.record(z3.unknown()).optional(),
+  // v3 specific
+  automation_id: z3.string().optional(),
+  role: z3.enum(["system", "user", "assistant"]).optional(),
+  group: z3.string().optional(),
+  scan_frequency: z3.number().int().nonnegative().optional(),
+  probability: z3.number().min(0).max(1).optional(),
+  use_regex: z3.boolean().optional(),
+  depth: z3.number().int().nonnegative().optional(),
+  selective_logic: z3.enum(["AND", "NOT"]).optional()
+});
+var CCv3CharacterBookSchema = z3.object({
+  name: z3.string().optional(),
+  description: z3.string().optional(),
+  scan_depth: z3.number().int().nonnegative().optional(),
+  token_budget: z3.number().int().nonnegative().optional(),
+  recursive_scanning: z3.boolean().optional(),
+  extensions: z3.record(z3.unknown()).optional(),
+  entries: z3.array(CCv3LorebookEntrySchema)
+});
+var CCv3DataInnerSchema = z3.object({
+  // Core fields - use .default('') to handle missing fields in malformed cards
+  name: z3.string().default(""),
+  description: z3.string().default(""),
+  personality: z3.string().nullable().default(""),
+  // Can be null in wild (141 cards)
+  scenario: z3.string().default(""),
+  first_mes: z3.string().default(""),
+  mes_example: z3.string().nullable().default(""),
+  // Can be null in wild (186 cards)
+  // "Required" per spec but often missing in wild - use defaults for leniency
+  creator: z3.string().default(""),
+  character_version: z3.string().default(""),
+  tags: z3.array(z3.string()).default([]),
+  group_only_greetings: z3.array(z3.string()).default([]),
+  // Optional fields
+  creator_notes: z3.string().optional(),
+  system_prompt: z3.string().optional(),
+  post_history_instructions: z3.string().optional(),
+  alternate_greetings: z3.array(z3.string()).optional(),
+  character_book: CCv3CharacterBookSchema.optional().nullable(),
+  extensions: z3.record(z3.unknown()).optional(),
+  // v3 specific
+  assets: z3.array(AssetDescriptorSchema).optional(),
+  nickname: z3.string().optional(),
+  creator_notes_multilingual: z3.record(z3.string()).optional(),
+  source: z3.array(z3.string()).optional(),
+  creation_date: z3.number().int().nonnegative().optional(),
+  // Unix timestamp in seconds
+  modification_date: z3.number().int().nonnegative().optional()
+  // Unix timestamp in seconds
+});
+var CCv3DataSchema = z3.object({
+  spec: z3.literal("chara_card_v3"),
+  spec_version: z3.literal("3.0"),
+  data: CCv3DataInnerSchema
+});
+function isV3Card(data) {
+  return CCv3DataSchema.safeParse(data).success;
+}
+function parseV3Card(data) {
+  return CCv3DataSchema.parse(data);
+}
+function parseV3DataInner(data) {
+  return CCv3DataInnerSchema.parse(data);
+}
+function getV3Data(card) {
+  return card.data;
+}
+function looksLikeV3Card(data) {
+  if (!data || typeof data !== "object") return false;
+  const obj = data;
+  return obj.spec === "chara_card_v3" && obj.data !== null && typeof obj.data === "object";
+}
+function hasRisuExtensions(extensions) {
+  if (!extensions) return false;
+  return "risuai" in extensions || "risu" in extensions;
+}
+function hasRisuScripts(extensions) {
+  if (!extensions) return false;
+  const risu = extensions.risuai;
+  if (!risu) return false;
+  return !!risu.triggerscript || !!risu.customScripts;
+}
+function hasDepthPrompt(extensions) {
+  if (!extensions) return false;
+  if ("depth_prompt" in extensions && extensions.depth_prompt) return true;
+  const risu = extensions.risuai;
+  return !!risu?.depth_prompt;
+}
+function createEmptyNormalizedCard() {
+  return {
+    name: "",
+    description: "",
+    personality: "",
+    scenario: "",
+    firstMes: "",
+    mesExample: "",
+    alternateGreetings: [],
+    groupOnlyGreetings: [],
+    tags: [],
+    extensions: {}
+  };
+}
+function createEmptyFeatures() {
+  return {
+    hasAlternateGreetings: false,
+    alternateGreetingsCount: 0,
+    totalGreetingsCount: 1,
+    // first_mes always counts as 1
+    hasLorebook: false,
+    lorebookEntriesCount: 0,
+    hasEmbeddedImages: false,
+    embeddedImagesCount: 0,
+    hasGallery: false,
+    hasRisuExtensions: false,
+    hasRisuScripts: false,
+    hasDepthPrompt: false,
+    hasVoxtaAppearance: false,
+    tokens: {
+      description: 0,
+      personality: 0,
+      scenario: 0,
+      firstMes: 0,
+      mesExample: 0,
+      systemPrompt: 0,
+      total: 0
+    }
+  };
+}
+function deriveFeatures(card) {
+  const isV3 = "assets" in card;
+  const altGreetings = card.alternate_greetings ?? [];
+  const hasAlternateGreetings = altGreetings.length > 0;
+  const alternateGreetingsCount = altGreetings.length;
+  const totalGreetingsCount = 1 + alternateGreetingsCount;
+  const characterBook = card.character_book;
+  const hasLorebook2 = !!characterBook && characterBook.entries.length > 0;
+  const lorebookEntriesCount = characterBook?.entries.length ?? 0;
+  const assets = isV3 ? card.assets ?? [] : [];
+  const imageAssetTypes = ["icon", "background", "emotion", "custom"];
+  const imageAssets = assets.filter(
+    (a) => imageAssetTypes.includes(a.type) || ["png", "jpg", "jpeg", "webp", "gif"].includes(a.ext.toLowerCase())
+  );
+  const hasGallery = imageAssets.length > 0;
+  const embeddedImageCount = countEmbeddedImages(card);
+  const hasEmbeddedImages = embeddedImageCount > 0;
+  const extensions = card.extensions ?? {};
+  const hasRisu = hasRisuExtensions(extensions);
+  const hasScripts = hasRisuScripts(extensions);
+  const hasDepth = hasDepthPrompt(extensions);
+  const hasVoxta = checkVoxtaAppearance(extensions);
+  const tokens = {
+    description: 0,
+    personality: 0,
+    scenario: 0,
+    firstMes: 0,
+    mesExample: 0,
+    systemPrompt: 0,
+    total: 0
+  };
+  return {
+    hasAlternateGreetings,
+    alternateGreetingsCount,
+    totalGreetingsCount,
+    hasLorebook: hasLorebook2,
+    lorebookEntriesCount,
+    hasEmbeddedImages,
+    embeddedImagesCount: embeddedImageCount,
+    hasGallery,
+    hasRisuExtensions: hasRisu,
+    hasRisuScripts: hasScripts,
+    hasDepthPrompt: hasDepth,
+    hasVoxtaAppearance: hasVoxta,
+    tokens
+  };
+}
+function countEmbeddedImages(card) {
+  const textFields = [
+    card.description,
+    card.personality,
+    card.scenario,
+    card.first_mes,
+    card.mes_example,
+    card.creator_notes,
+    card.system_prompt,
+    card.post_history_instructions,
+    ...card.alternate_greetings ?? []
+  ].filter((field) => typeof field === "string");
+  if ("group_only_greetings" in card) {
+    textFields.push(...card.group_only_greetings ?? []);
+  }
+  let count = 0;
+  const dataUrlPattern = /data:image\/[^;]+;base64,/g;
+  for (const text of textFields) {
+    const matches = text.match(dataUrlPattern);
+    if (matches) {
+      count += matches.length;
+    }
+  }
+  return count;
+}
+function checkVoxtaAppearance(extensions) {
+  if (!extensions.voxta) return false;
+  const voxta = extensions.voxta;
+  return !!voxta.appearance;
+}
+var V3_ONLY_FIELDS = ["group_only_greetings", "creation_date", "modification_date", "assets"];
+function detectSpec(data) {
+  return detectSpecDetailed(data).spec;
+}
+function detectSpecDetailed(data) {
+  const result = {
+    spec: null,
+    confidence: "low",
+    indicators: [],
+    warnings: []
+  };
+  if (!data || typeof data !== "object") {
+    result.indicators.push("Input is not an object");
+    return result;
+  }
+  const obj = data;
+  const dataObj = obj.data && typeof obj.data === "object" ? obj.data : null;
+  if (obj.spec === "chara_card_v3") {
+    result.spec = "v3";
+    result.confidence = "high";
+    result.indicators.push('spec field is "chara_card_v3"');
+    if (obj.spec_version && obj.spec_version !== "3.0") {
+      result.warnings.push(`spec_version "${obj.spec_version}" inconsistent with v3 spec`);
+    }
+    return result;
+  }
+  if (obj.spec === "chara_card_v2") {
+    result.spec = "v2";
+    result.confidence = "high";
+    result.indicators.push('spec field is "chara_card_v2"');
+    if (dataObj) {
+      for (const field of V3_ONLY_FIELDS) {
+        if (field in dataObj) {
+          result.warnings.push(`V3-only field "${field}" found in V2 card`);
+        }
+      }
+    }
+    if (obj.spec_version && obj.spec_version !== "2.0") {
+      result.warnings.push(`spec_version "${obj.spec_version}" inconsistent with v2 spec`);
+    }
+    return result;
+  }
+  if (typeof obj.spec_version === "string") {
+    if (obj.spec_version.startsWith("3")) {
+      result.spec = "v3";
+      result.confidence = "high";
+      result.indicators.push(`spec_version "${obj.spec_version}" starts with "3"`);
+      return result;
+    }
+    if (obj.spec_version.startsWith("2")) {
+      result.spec = "v2";
+      result.confidence = "high";
+      result.indicators.push(`spec_version "${obj.spec_version}" starts with "2"`);
+      return result;
+    }
+  }
+  if (obj.spec_version === 2 || obj.spec_version === 2) {
+    result.spec = "v2";
+    result.confidence = "high";
+    result.indicators.push(`spec_version is numeric ${obj.spec_version}`);
+    return result;
+  }
+  if (dataObj) {
+    const v3Fields = [];
+    for (const field of V3_ONLY_FIELDS) {
+      if (field in dataObj) {
+        v3Fields.push(field);
+      }
+    }
+    if (v3Fields.length > 0) {
+      result.spec = "v3";
+      result.confidence = "medium";
+      result.indicators.push(`Has V3-only fields: ${v3Fields.join(", ")}`);
+      return result;
+    }
+  }
+  const rootV3Fields = [];
+  for (const field of V3_ONLY_FIELDS) {
+    if (field in obj) {
+      rootV3Fields.push(field);
+    }
+  }
+  if (rootV3Fields.length > 0) {
+    result.spec = "v3";
+    result.confidence = "medium";
+    result.indicators.push(`Has V3-only fields at root: ${rootV3Fields.join(", ")}`);
+    result.warnings.push("V3 fields found at root level instead of data object");
+    return result;
+  }
+  if (obj.spec && dataObj) {
+    const dataName = dataObj.name;
+    if (dataName && typeof dataName === "string") {
+      if (typeof obj.spec === "string") {
+        if (obj.spec.includes("v3") || obj.spec.includes("3")) {
+          result.spec = "v3";
+          result.confidence = "medium";
+          result.indicators.push(`spec field "${obj.spec}" contains "v3" or "3"`);
+          return result;
+        }
+        if (obj.spec.includes("v2") || obj.spec.includes("2")) {
+          result.spec = "v2";
+          result.confidence = "medium";
+          result.indicators.push(`spec field "${obj.spec}" contains "v2" or "2"`);
+          return result;
+        }
+      }
+      result.spec = "v3";
+      result.confidence = "medium";
+      result.indicators.push("Has wrapped format with spec and data.name");
+      return result;
+    }
+  }
+  if (obj.name && typeof obj.name === "string") {
+    if ("description" in obj || "personality" in obj || "scenario" in obj) {
+      result.spec = "v2";
+      result.confidence = "medium";
+      result.indicators.push("Unwrapped format with name, description/personality/scenario");
+      return result;
+    }
+  }
+  if (dataObj && typeof dataObj.name === "string") {
+    if ("description" in dataObj || "personality" in dataObj) {
+      result.spec = "v2";
+      result.confidence = "low";
+      result.indicators.push("Has data object with name and card fields, but no spec");
+      result.warnings.push("Missing spec field");
+      return result;
+    }
+  }
+  result.indicators.push("No card structure detected");
+  return result;
+}
+function hasLorebook(data) {
+  if (!data || typeof data !== "object") return false;
+  const obj = data;
+  const wrapped = obj.data;
+  if (wrapped?.character_book) {
+    const book = wrapped.character_book;
+    if (Array.isArray(book.entries) && book.entries.length > 0) return true;
+  }
+  if (obj.character_book) {
+    const book = obj.character_book;
+    if (Array.isArray(book.entries) && book.entries.length > 0) return true;
+  }
+  return false;
+}
+function looksLikeCard(data) {
+  if (!data || typeof data !== "object") return false;
+  const obj = data;
+  if (obj.spec === "chara_card_v2" || obj.spec === "chara_card_v3") {
+    return true;
+  }
+  if (obj.data && typeof obj.data === "object") {
+    const dataObj = obj.data;
+    if (typeof dataObj.name === "string" && dataObj.name.length > 0) {
+      return true;
+    }
+  }
+  if (typeof obj.name === "string" && obj.name.length > 0) {
+    if ("description" in obj || "personality" in obj || "first_mes" in obj) {
+      return true;
+    }
+  }
+  return false;
+}
+var POSITION_MAP = {
+  0: "before_char",
+  1: "after_char"
+};
+var V3_ONLY_ENTRY_FIELDS = [
+  "probability",
+  "depth",
+  "group",
+  "scan_frequency",
+  "use_regex",
+  "selective_logic",
+  "role",
+  "automation_id"
+];
+var V2_REQUIRED_DEFAULTS = {
+  name: "",
+  description: "",
+  personality: "",
+  scenario: "",
+  first_mes: "",
+  mes_example: ""
+};
+var V3_REQUIRED_DEFAULTS = {
+  name: "",
+  description: "",
+  personality: "",
+  scenario: "",
+  first_mes: "",
+  mes_example: "",
+  creator: "",
+  character_version: "1.0",
+  tags: [],
+  group_only_greetings: []
+};
+var DATA_FIELDS = [
+  "name",
+  "description",
+  "personality",
+  "scenario",
+  "first_mes",
+  "mes_example",
+  "creator_notes",
+  "system_prompt",
+  "post_history_instructions",
+  "alternate_greetings",
+  "character_book",
+  "tags",
+  "creator",
+  "character_version",
+  "extensions",
+  "assets",
+  "nickname",
+  "creator_notes_multilingual",
+  "source",
+  "creation_date",
+  "modification_date",
+  "group_only_greetings"
+];
+function deepClone(obj) {
+  if (obj === null || obj === void 0) {
+    return obj;
+  }
+  if (Array.isArray(obj)) {
+    return obj.map((item) => deepClone(item));
+  }
+  if (typeof obj === "object") {
+    const result = {};
+    for (const [key, value] of Object.entries(obj)) {
+      result[key] = deepClone(value);
+    }
+    return result;
+  }
+  return obj;
+}
+function isMilliseconds(timestamp) {
+  return timestamp > 1e10;
+}
+var CardNormalizer = {
+  /**
+   * Normalize card data to valid schema format.
+   *
+   * Handles:
+   * - Fixing spec/spec_version values
+   * - Moving misplaced fields to correct locations
+   * - Adding missing required fields with defaults
+   * - Handling hybrid formats (fields at root AND in data object)
+   *
+   * @param data - Raw card data (potentially malformed)
+   * @param spec - Target spec version
+   * @returns Normalized card data (does not mutate input)
+   */
+  normalize(data, spec) {
+    if (!data || typeof data !== "object") {
+      if (spec === "v3") {
+        return {
+          spec: "chara_card_v3",
+          spec_version: "3.0",
+          data: { ...V3_REQUIRED_DEFAULTS }
+        };
+      }
+      return {
+        spec: "chara_card_v2",
+        spec_version: "2.0",
+        data: { ...V2_REQUIRED_DEFAULTS }
+      };
+    }
+    const obj = data;
+    const result = {};
+    const existingData = obj.data && typeof obj.data === "object" ? obj.data : {};
+    const mergedData = {};
+    for (const [key, value] of Object.entries(existingData)) {
+      mergedData[key] = deepClone(value);
+    }
+    for (const field of DATA_FIELDS) {
+      if (field in obj && !(field in mergedData)) {
+        mergedData[field] = deepClone(obj[field]);
+      }
+    }
+    if (mergedData.character_book === null) {
+      delete mergedData.character_book;
+    }
+    if (mergedData.character_book && typeof mergedData.character_book === "object") {
+      mergedData.character_book = this.normalizeCharacterBook(
+        mergedData.character_book,
+        spec
+      );
+    }
+    const defaults = spec === "v3" ? V3_REQUIRED_DEFAULTS : V2_REQUIRED_DEFAULTS;
+    for (const [key, defaultValue] of Object.entries(defaults)) {
+      if (!(key in mergedData) || mergedData[key] === void 0) {
+        mergedData[key] = Array.isArray(defaultValue) ? [...defaultValue] : defaultValue;
+      }
+    }
+    if (mergedData.tags && !Array.isArray(mergedData.tags)) {
+      mergedData.tags = [];
+    }
+    if (mergedData.alternate_greetings && !Array.isArray(mergedData.alternate_greetings)) {
+      mergedData.alternate_greetings = [];
+    }
+    if (spec === "v3") {
+      if (mergedData.group_only_greetings && !Array.isArray(mergedData.group_only_greetings)) {
+        mergedData.group_only_greetings = [];
+      }
+    }
+    if (spec === "v3") {
+      result.spec = "chara_card_v3";
+      result.spec_version = "3.0";
+      result.data = this.fixTimestampsInner(mergedData);
+    } else {
+      result.spec = "chara_card_v2";
+      result.spec_version = "2.0";
+      result.data = mergedData;
+    }
+    return result;
+  },
+  /**
+   * Normalize a character book (lorebook).
+   *
+   * Handles:
+   * - Ensuring required fields exist
+   * - Converting numeric position values to string enums
+   * - Moving V3-only fields to extensions for V2 compatibility
+   *
+   * @param book - Raw character book data
+   * @param spec - Target spec version
+   * @returns Normalized character book
+   */
+  normalizeCharacterBook(book, spec) {
+    const result = {};
+    if (book.name !== void 0) result.name = book.name;
+    if (book.description !== void 0) result.description = book.description;
+    if (book.scan_depth !== void 0) result.scan_depth = book.scan_depth;
+    if (book.token_budget !== void 0) result.token_budget = book.token_budget;
+    if (book.recursive_scanning !== void 0)
+      result.recursive_scanning = book.recursive_scanning;
+    if (book.extensions !== void 0) result.extensions = deepClone(book.extensions);
+    const entries = Array.isArray(book.entries) ? book.entries : [];
+    result.entries = entries.map(
+      (entry) => this.normalizeEntry(entry, spec)
+    );
+    return result;
+  },
+  /**
+   * Normalize a single lorebook entry.
+   *
+   * Handles:
+   * - Converting numeric position to string enum
+   * - Moving V3-only fields to extensions for V2
+   * - Ensuring required fields exist
+   *
+   * @param entry - Raw entry data
+   * @param spec - Target spec version
+   * @returns Normalized entry
+   */
+  normalizeEntry(entry, spec) {
+    const result = {};
+    result.keys = Array.isArray(entry.keys) ? [...entry.keys] : [];
+    result.content = typeof entry.content === "string" ? entry.content : "";
+    result.enabled = entry.enabled !== false;
+    result.insertion_order = typeof entry.insertion_order === "number" ? entry.insertion_order : 0;
+    if (spec === "v2") {
+      result.extensions = entry.extensions && typeof entry.extensions === "object" ? deepClone(entry.extensions) : {};
+    }
+    if (entry.case_sensitive !== void 0) result.case_sensitive = entry.case_sensitive;
+    if (entry.name !== void 0) result.name = entry.name;
+    if (entry.priority !== void 0) result.priority = entry.priority;
+    if (entry.id !== void 0) result.id = entry.id;
+    if (entry.comment !== void 0) result.comment = entry.comment;
+    if (entry.selective !== void 0) result.selective = entry.selective;
+    if (entry.secondary_keys !== void 0) {
+      result.secondary_keys = Array.isArray(entry.secondary_keys) ? [...entry.secondary_keys] : [];
+    }
+    if (entry.constant !== void 0) result.constant = entry.constant;
+    if (entry.position !== void 0) {
+      if (typeof entry.position === "number") {
+        result.position = POSITION_MAP[entry.position] || "before_char";
+      } else if (entry.position === "before_char" || entry.position === "after_char") {
+        result.position = entry.position;
+      }
+    }
+    if (spec === "v3") {
+      if (entry.extensions !== void 0) result.extensions = deepClone(entry.extensions);
+      for (const field of V3_ONLY_ENTRY_FIELDS) {
+        if (entry[field] !== void 0) {
+          result[field] = entry[field];
+        }
+      }
+    } else {
+      const ext = result.extensions || {};
+      for (const field of V3_ONLY_ENTRY_FIELDS) {
+        if (entry[field] !== void 0) {
+          ext[field] = entry[field];
+        }
+      }
+      result.extensions = ext;
+    }
+    return result;
+  },
+  /**
+   * Fix CharacterTavern timestamp format (milliseconds -> seconds).
+   *
+   * CCv3 spec requires timestamps in seconds (Unix epoch).
+   * CharacterTavern exports timestamps in milliseconds.
+   *
+   * @param data - V3 card data
+   * @returns Card data with fixed timestamps (does not mutate input)
+   */
+  fixTimestamps(data) {
+    const result = deepClone(data);
+    result.data = this.fixTimestampsInner(
+      result.data
+    );
+    return result;
+  },
+  /**
+   * Internal: fix timestamps in data object
+   */
+  fixTimestampsInner(data) {
+    const result = { ...data };
+    if (typeof result.creation_date === "number" && isMilliseconds(result.creation_date)) {
+      result.creation_date = Math.floor(result.creation_date / 1e3);
+    }
+    if (typeof result.modification_date === "number" && isMilliseconds(result.modification_date)) {
+      result.modification_date = Math.floor(result.modification_date / 1e3);
+    }
+    return result;
+  },
+  /**
+   * Auto-detect spec and normalize.
+   *
+   * @param data - Raw card data
+   * @returns Normalized card data, or null if not a valid card
+   */
+  autoNormalize(data) {
+    const spec = detectSpec(data);
+    if (!spec) return null;
+    const targetSpec = spec === "v3" ? "v3" : "v2";
+    return this.normalize(data, targetSpec);
+  }
+};
+function zodErrorToMessage(zodError, context) {
+  const messages = zodError.errors.map((err) => {
+    const path = err.path.length > 0 ? `${err.path.join(".")}: ` : "";
+    return `${path}${err.message}`;
+  });
+  const message = messages.join("; ");
+  return context ? `${context} - ${message}` : message;
+}
+function getFirstErrorField(zodError) {
+  return zodError.errors[0]?.path[0]?.toString();
+}
+function safeParse(schema, data) {
+  const result = schema.safeParse(data);
+  if (result.success) {
+    return { success: true, data: result.data };
+  }
+  return {
+    success: false,
+    error: zodErrorToMessage(result.error),
+    field: getFirstErrorField(result.error)
+  };
+}
+export {
+  AssetDescriptorSchema,
+  AssetTypeSchema,
+  CCv2CharacterBookSchema,
+  CCv2DataSchema,
+  CCv2LorebookEntrySchema,
+  CCv2WrappedSchema,
+  CCv3CharacterBookSchema,
+  CCv3DataInnerSchema,
+  CCv3DataSchema,
+  CCv3LorebookEntrySchema,
+  CardNormalizer,
+  ExtractedAssetSchema,
+  ISO8601Schema,
+  OriginalShapeSchema,
+  SourceFormatSchema,
+  SpecSchema,
+  UUIDSchema,
+  createEmptyFeatures,
+  createEmptyNormalizedCard,
+  deriveFeatures,
+  detectSpec,
+  detectSpecDetailed,
+  getFirstErrorField,
+  getV2Data,
+  getV3Data,
+  hasDepthPrompt,
+  hasLorebook,
+  hasRisuExtensions,
+  hasRisuScripts,
+  isV2CardData,
+  isV3Card,
+  isWrappedV2,
+  looksLikeCard,
+  looksLikeV3Card,
+  looksLikeWrappedV2,
+  parseV2Data,
+  parseV3Card,
+  parseV3DataInner,
+  parseWrappedV2,
+  safeParse,
+  zodErrorToMessage
+};
 //# sourceMappingURL=schemas.js.map