@imjp/writenex-astro 0.1.0

package/dist/chunk-CYLDJ3HZ.js

@@ -0,0 +1,310 @@
+import {
+  detectFilePattern,
+  getCollectionCount,
+  readCollection
+} from "./chunk-AAOQHQPU.js";
+import {
+  DEFAULT_FILE_PATTERN
+} from "./chunk-CRPZUUDU.js";
+
+// src/discovery/schema.ts
+var MAX_SAMPLE_FILES = 20;
+var REQUIRED_THRESHOLD = 0.9;
+var ENUM_MAX_VALUES = 10;
+var ENUM_RATIO_THRESHOLD = 0.3;
+var IMAGE_EXTENSIONS = [
+  ".jpg",
+  ".jpeg",
+  ".png",
+  ".gif",
+  ".webp",
+  ".avif",
+  ".svg"
+];
+function isImagePath(value) {
+  if (typeof value !== "string") return false;
+  const lowered = value.toLowerCase();
+  return IMAGE_EXTENSIONS.some((ext) => lowered.endsWith(ext));
+}
+function isDateValue(value) {
+  if (value instanceof Date) return true;
+  if (typeof value === "string") {
+    if (/^\d{4}-\d{2}-\d{2}(T|\s)/.test(value)) return true;
+    if (/^\d{4}-\d{2}-\d{2}$/.test(value)) return true;
+  }
+  return false;
+}
+function detectValueType(value) {
+  if (value === null || value === void 0) return "null";
+  if (typeof value === "boolean") return "boolean";
+  if (typeof value === "number") return "number";
+  if (typeof value === "string") return "string";
+  if (Array.isArray(value)) return "array";
+  if (value instanceof Date) return "date";
+  if (typeof value === "object") return "object";
+  return "unknown";
+}
+function inferFieldType(analysis) {
+  if (analysis.hasImagePaths) return "image";
+  if (analysis.hasDateValues) return "date";
+  const nonNullTypes = new Set([...analysis.types].filter((t) => t !== "null"));
+  if (nonNullTypes.size === 1) {
+    const type = [...nonNullTypes][0];
+    switch (type) {
+      case "boolean":
+        return "boolean";
+      case "number":
+        return "number";
+      case "array":
+        return "array";
+      case "object":
+        return "object";
+      case "date":
+        return "date";
+      default:
+        return "string";
+    }
+  }
+  return "string";
+}
+function detectEnum(values, totalSamples) {
+  const stringValues = values.filter(
+    (v) => typeof v === "string" && v.length > 0
+  );
+  if (stringValues.length === 0) return void 0;
+  const uniqueValues = [...new Set(stringValues)];
+  if (uniqueValues.length > ENUM_MAX_VALUES) return void 0;
+  const ratio = uniqueValues.length / totalSamples;
+  if (ratio > ENUM_RATIO_THRESHOLD) return void 0;
+  if (uniqueValues.length < 2) return void 0;
+  if (stringValues.length < totalSamples * 0.5) return void 0;
+  return uniqueValues.sort();
+}
+function detectArrayItemType(analysis) {
+  if (analysis.arrayItemTypes.size === 0) return void 0;
+  const types = [...analysis.arrayItemTypes].filter((t) => t !== "null");
+  if (types.length === 0) return void 0;
+  if (types.length === 1) return types[0];
+  return "string";
+}
+async function detectSchema(collectionPath) {
+  const warnings = [];
+  const items = await readCollection(collectionPath, {
+    includeDrafts: true
+  });
+  const samples = items.slice(0, MAX_SAMPLE_FILES);
+  if (samples.length === 0) {
+    return {
+      schema: {},
+      samplesAnalyzed: 0,
+      confidence: 0,
+      warnings: ["No content files found in collection"]
+    };
+  }
+  const fieldAnalyses = /* @__PURE__ */ new Map();
+  for (const item of samples) {
+    for (const [fieldName, value] of Object.entries(item.frontmatter)) {
+      let analysis = fieldAnalyses.get(fieldName);
+      if (!analysis) {
+        analysis = {
+          presentCount: 0,
+          types: /* @__PURE__ */ new Set(),
+          values: [],
+          hasImagePaths: false,
+          hasDateValues: false,
+          arrayItemTypes: /* @__PURE__ */ new Set()
+        };
+        fieldAnalyses.set(fieldName, analysis);
+      }
+      analysis.presentCount++;
+      analysis.types.add(detectValueType(value));
+      analysis.values.push(value);
+      if (isImagePath(value)) {
+        analysis.hasImagePaths = true;
+      }
+      if (isDateValue(value)) {
+        analysis.hasDateValues = true;
+      }
+      if (Array.isArray(value)) {
+        for (const item2 of value) {
+          analysis.arrayItemTypes.add(detectValueType(item2));
+        }
+      }
+    }
+  }
+  const schema = {};
+  const totalSamples = samples.length;
+  for (const [fieldName, analysis] of fieldAnalyses) {
+    const fieldType = inferFieldType(analysis);
+    const isRequired = analysis.presentCount / totalSamples >= REQUIRED_THRESHOLD;
+    const field = {
+      type: fieldType,
+      required: isRequired
+    };
+    if (fieldType === "array") {
+      const itemType = detectArrayItemType(analysis);
+      if (itemType) {
+        field.items = itemType;
+      }
+    }
+    if (fieldType === "string") {
+      const enumValues = detectEnum(analysis.values, totalSamples);
+      if (enumValues) {
+        field.description = `Options: ${enumValues.join(", ")}`;
+      }
+    }
+    if (fieldType === "boolean") {
+      const boolValues = analysis.values.filter(
+        (v) => typeof v === "boolean"
+      );
+      if (boolValues.length > 0) {
+        const trueCount = boolValues.filter((v) => v === true).length;
+        const falseCount = boolValues.filter((v) => v === false).length;
+        field.default = trueCount > falseCount ? true : false;
+      }
+    }
+    const nonNullTypes = [...analysis.types].filter((t) => t !== "null");
+    if (nonNullTypes.length > 1) {
+      warnings.push(
+        `Field "${fieldName}" has inconsistent types: ${nonNullTypes.join(", ")}`
+      );
+    }
+    schema[fieldName] = field;
+  }
+  const inconsistentFields = warnings.filter(
+    (w) => w.includes("inconsistent")
+  ).length;
+  const confidence = Math.max(
+    0,
+    1 - inconsistentFields / Math.max(1, fieldAnalyses.size)
+  );
+  return {
+    schema,
+    samplesAnalyzed: totalSamples,
+    confidence,
+    warnings
+  };
+}
+function mergeSchema(detected, userSchema) {
+  if (!userSchema) return detected;
+  const merged = { ...detected };
+  for (const [fieldName, userField] of Object.entries(userSchema)) {
+    merged[fieldName] = {
+      ...detected[fieldName],
+      ...userField
+    };
+  }
+  return merged;
+}
+function describeSchema(schema) {
+  const lines = [];
+  for (const [fieldName, field] of Object.entries(schema)) {
+    let desc = `- ${fieldName}: ${field.type}`;
+    if (field.required) {
+      desc += " (required)";
+    }
+    if (field.items) {
+      desc += ` of ${field.items}`;
+    }
+    if (field.default !== void 0) {
+      desc += ` [default: ${JSON.stringify(field.default)}]`;
+    }
+    if (field.description) {
+      desc += ` - ${field.description}`;
+    }
+    lines.push(desc);
+  }
+  return lines.join("\n");
+}
+
+// src/discovery/collections.ts
+import { readdir, stat } from "fs/promises";
+import { existsSync } from "fs";
+import { join } from "path";
+var DEFAULT_CONTENT_DIR = "src/content";
+var IGNORED_DIRECTORIES = /* @__PURE__ */ new Set(["node_modules", ".git", "_", "."]);
+function shouldIgnore(name) {
+  return IGNORED_DIRECTORIES.has(name) || name.startsWith("_") || name.startsWith(".");
+}
+async function discoverCollections(projectRoot, contentDir = DEFAULT_CONTENT_DIR) {
+  const contentPath = join(projectRoot, contentDir);
+  if (!existsSync(contentPath)) {
+    return [];
+  }
+  const collections = [];
+  try {
+    const entries = await readdir(contentPath, { withFileTypes: true });
+    for (const entry of entries) {
+      if (!entry.isDirectory() || shouldIgnore(entry.name)) {
+        continue;
+      }
+      const collectionPath = join(contentPath, entry.name);
+      const relativePath = join(contentDir, entry.name);
+      const count = await getCollectionCount(collectionPath);
+      const patternResult = await detectFilePattern(collectionPath);
+      const filePattern = patternResult.pattern;
+      const schemaResult = await detectSchema(collectionPath);
+      const schema = Object.keys(schemaResult.schema).length > 0 ? schemaResult.schema : void 0;
+      const previewUrl = `/${entry.name}/{slug}`;
+      collections.push({
+        name: entry.name,
+        path: relativePath,
+        filePattern,
+        count,
+        schema,
+        previewUrl
+      });
+    }
+  } catch (error) {
+    console.error(`[writenex] Failed to discover collections: ${error}`);
+  }
+  return collections;
+}
+function mergeCollections(discovered, configured) {
+  const configuredNames = new Set(configured.map((c) => c.name));
+  const result = [];
+  for (const config of configured) {
+    const discoveredMatch = discovered.find((d) => d.name === config.name);
+    result.push({
+      name: config.name,
+      path: config.path,
+      filePattern: config.filePattern ?? discoveredMatch?.filePattern ?? DEFAULT_FILE_PATTERN,
+      count: discoveredMatch?.count ?? 0,
+      schema: config.schema ?? discoveredMatch?.schema,
+      previewUrl: config.previewUrl ?? discoveredMatch?.previewUrl ?? `/${config.name}/{slug}`
+    });
+  }
+  for (const disc of discovered) {
+    if (!configuredNames.has(disc.name)) {
+      result.push(disc);
+    }
+  }
+  return result;
+}
+async function getCollection(projectRoot, collectionName, contentDir = DEFAULT_CONTENT_DIR) {
+  const collections = await discoverCollections(projectRoot, contentDir);
+  return collections.find((c) => c.name === collectionName);
+}
+async function collectionExists(projectRoot, collectionName, contentDir = DEFAULT_CONTENT_DIR) {
+  const collectionPath = join(projectRoot, contentDir, collectionName);
+  if (!existsSync(collectionPath)) {
+    return false;
+  }
+  try {
+    const stats = await stat(collectionPath);
+    return stats.isDirectory();
+  } catch {
+    return false;
+  }
+}
+
+export {
+  detectSchema,
+  mergeSchema,
+  describeSchema,
+  discoverCollections,
+  mergeCollections,
+  getCollection,
+  collectionExists
+};
+//# sourceMappingURL=chunk-CYLDJ3HZ.js.map

package/dist/chunk-CYLDJ3HZ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/discovery/schema.ts","../src/discovery/collections.ts"],"sourcesContent":["/**\n * @fileoverview Schema auto-detection for content collections\n *\n * This module analyzes frontmatter from sample content files to automatically\n * infer the schema (field types, required status, enums, etc.).\n *\n * ## Detection Process:\n * 1. Read sample files from the collection (up to 20)\n * 2. Parse frontmatter from each file\n * 3. Analyze field patterns across all samples\n * 4. Infer field types and constraints\n * 5. Generate schema definition\n *\n * ## Detected Types:\n * - string: Plain text values\n * - number: Numeric values\n * - boolean: True/false values\n * - date: ISO date strings or Date objects\n * - array: Arrays (with item type detection)\n * - image: Paths ending with image extensions\n *\n * @module @writenex/astro/discovery/schema\n */\n\nimport type { CollectionSchema, FieldType, SchemaField } from \"@/types\";\nimport { readCollection } from \"@/filesystem/reader\";\n\n/**\n * Maximum number of files to sample for schema detection\n */\nconst MAX_SAMPLE_FILES = 20;\n\n/**\n * Minimum presence ratio to consider a field required\n * (field must appear in at least 90% of files)\n */\nconst REQUIRED_THRESHOLD = 0.9;\n\n/**\n * Maximum unique values to consider a field as enum\n */\nconst ENUM_MAX_VALUES = 10;\n\n/**\n * Minimum ratio of unique values to total to NOT be an enum\n * (if uniqueValues / total < 0.3, it's likely an enum)\n */\nconst ENUM_RATIO_THRESHOLD = 0.3;\n\n/**\n * Image file extensions for detection\n */\nconst IMAGE_EXTENSIONS = [\n  \".jpg\",\n  \".jpeg\",\n  \".png\",\n  \".gif\",\n  \".webp\",\n  \".avif\",\n  \".svg\",\n];\n\n/**\n * Field analysis data collected from samples\n */\ninterface FieldAnalysis {\n  /** Number of files where this field appears */\n  presentCount: number;\n  /** Detected types for this field across samples */\n  types: Set<string>;\n  /** Sample values for enum detection */\n  values: unknown[];\n  /** Whether values look like image paths */\n  hasImagePaths: boolean;\n  /** Whether values look like dates */\n  hasDateValues: boolean;\n  /** For arrays, analysis of item types */\n  arrayItemTypes: Set<string>;\n}\n\n/**\n * Result of schema detection\n */\nexport interface SchemaDetectionResult {\n  /** The detected schema */\n  schema: CollectionSchema;\n  /** Number of files analyzed */\n  samplesAnalyzed: number;\n  /** Confidence score (0-1) based on sample consistency */\n  confidence: number;\n  /** Fields that had inconsistent types across samples */\n  warnings: string[];\n}\n\n/**\n * Check if a string looks like an image path\n *\n * @param value - Value to check\n * @returns True if it looks like an image path\n */\nfunction isImagePath(value: unknown): boolean {\n  if (typeof value !== \"string\") return false;\n\n  const lowered = value.toLowerCase();\n  return IMAGE_EXTENSIONS.some((ext) => lowered.endsWith(ext));\n}\n\n/**\n * Check if a value looks like a date\n *\n * @param value - Value to check\n * @returns True if it looks like a date\n */\nfunction isDateValue(value: unknown): boolean {\n  // Already a Date object\n  if (value instanceof Date) return true;\n\n  // ISO date string (YYYY-MM-DD or full ISO)\n  if (typeof value === \"string\") {\n    // Full ISO format\n    if (/^\\d{4}-\\d{2}-\\d{2}(T|\\s)/.test(value)) return true;\n    // Simple date format\n    if (/^\\d{4}-\\d{2}-\\d{2}$/.test(value)) return true;\n  }\n\n  return false;\n}\n\n/**\n * Detect the JavaScript type of a value\n *\n * @param value - Value to analyze\n * @returns Detected type string\n */\nfunction detectValueType(value: unknown): string {\n  if (value === null || value === undefined) return \"null\";\n  if (typeof value === \"boolean\") return \"boolean\";\n  if (typeof value === \"number\") return \"number\";\n  if (typeof value === \"string\") return \"string\";\n  if (Array.isArray(value)) return \"array\";\n  if (value instanceof Date) return \"date\";\n  if (typeof value === \"object\") return \"object\";\n  return \"unknown\";\n}\n\n/**\n * Convert detected type to schema field type\n *\n * @param analysis - Field analysis data\n * @returns The appropriate FieldType\n */\nfunction inferFieldType(analysis: FieldAnalysis): FieldType {\n  // If it has image paths, it's an image field\n  if (analysis.hasImagePaths) return \"image\";\n\n  // If it has date values, it's a date field\n  if (analysis.hasDateValues) return \"date\";\n\n  // Check detected types (excluding null)\n  const nonNullTypes = new Set([...analysis.types].filter((t) => t !== \"null\"));\n\n  // Single type is easy\n  if (nonNullTypes.size === 1) {\n    const type = [...nonNullTypes][0];\n    switch (type) {\n      case \"boolean\":\n        return \"boolean\";\n      case \"number\":\n        return \"number\";\n      case \"array\":\n        return \"array\";\n      case \"object\":\n        return \"object\";\n      case \"date\":\n        return \"date\";\n      default:\n        return \"string\";\n    }\n  }\n\n  // Mixed types - default to string (most flexible)\n  return \"string\";\n}\n\n/**\n * Detect if a field should be treated as an enum\n *\n * @param values - All values seen for this field\n * @param totalSamples - Total number of samples\n * @returns Array of enum values, or undefined if not an enum\n */\nfunction detectEnum(\n  values: unknown[],\n  totalSamples: number\n): string[] | undefined {\n  // Filter to string values only\n  const stringValues = values.filter(\n    (v): v is string => typeof v === \"string\" && v.length > 0\n  );\n\n  if (stringValues.length === 0) return undefined;\n\n  // Get unique values\n  const uniqueValues = [...new Set(stringValues)];\n\n  // Check if it's a good candidate for enum\n  if (uniqueValues.length > ENUM_MAX_VALUES) return undefined;\n\n  // Check ratio of unique to total\n  const ratio = uniqueValues.length / totalSamples;\n  if (ratio > ENUM_RATIO_THRESHOLD) return undefined;\n\n  // Must have at least 2 unique values and appear multiple times\n  if (uniqueValues.length < 2) return undefined;\n  if (stringValues.length < totalSamples * 0.5) return undefined;\n\n  return uniqueValues.sort();\n}\n\n/**\n * Detect item type for array fields\n *\n * @param analysis - Field analysis data\n * @returns The detected item type, or undefined\n */\nfunction detectArrayItemType(analysis: FieldAnalysis): string | undefined {\n  if (analysis.arrayItemTypes.size === 0) return undefined;\n\n  // Filter out null\n  const types = [...analysis.arrayItemTypes].filter((t) => t !== \"null\");\n\n  if (types.length === 0) return undefined;\n  if (types.length === 1) return types[0];\n\n  // Mixed types - default to string\n  return \"string\";\n}\n\n/**\n * Analyze frontmatter from content items to detect schema\n *\n * @param collectionPath - Absolute path to the collection directory\n * @returns Schema detection result\n *\n * @example\n * ```typescript\n * const result = await detectSchema('/project/src/content/blog');\n * console.log(result.schema);\n * // {\n * //   title: { type: 'string', required: true },\n * //   pubDate: { type: 'date', required: true },\n * //   draft: { type: 'boolean', required: false, default: false },\n * //   tags: { type: 'array', required: false, items: 'string' },\n * // }\n * ```\n */\nexport async function detectSchema(\n  collectionPath: string\n): Promise<SchemaDetectionResult> {\n  const warnings: string[] = [];\n\n  // Read sample content files\n  const items = await readCollection(collectionPath, {\n    includeDrafts: true,\n  });\n\n  // Limit to max samples\n  const samples = items.slice(0, MAX_SAMPLE_FILES);\n\n  if (samples.length === 0) {\n    return {\n      schema: {},\n      samplesAnalyzed: 0,\n      confidence: 0,\n      warnings: [\"No content files found in collection\"],\n    };\n  }\n\n  // Analyze each field across all samples\n  const fieldAnalyses = new Map<string, FieldAnalysis>();\n\n  for (const item of samples) {\n    for (const [fieldName, value] of Object.entries(item.frontmatter)) {\n      // Get or create field analysis\n      let analysis = fieldAnalyses.get(fieldName);\n      if (!analysis) {\n        analysis = {\n          presentCount: 0,\n          types: new Set(),\n          values: [],\n          hasImagePaths: false,\n          hasDateValues: false,\n          arrayItemTypes: new Set(),\n        };\n        fieldAnalyses.set(fieldName, analysis);\n      }\n\n      // Update analysis\n      analysis.presentCount++;\n      analysis.types.add(detectValueType(value));\n      analysis.values.push(value);\n\n      // Check for special types\n      if (isImagePath(value)) {\n        analysis.hasImagePaths = true;\n      }\n      if (isDateValue(value)) {\n        analysis.hasDateValues = true;\n      }\n\n      // Analyze array items\n      if (Array.isArray(value)) {\n        for (const item of value) {\n          analysis.arrayItemTypes.add(detectValueType(item));\n        }\n      }\n    }\n  }\n\n  // Generate schema from analysis\n  const schema: CollectionSchema = {};\n  const totalSamples = samples.length;\n\n  for (const [fieldName, analysis] of fieldAnalyses) {\n    const fieldType = inferFieldType(analysis);\n    const isRequired =\n      analysis.presentCount / totalSamples >= REQUIRED_THRESHOLD;\n\n    const field: SchemaField = {\n      type: fieldType,\n      required: isRequired,\n    };\n\n    // Add array item type if applicable\n    if (fieldType === \"array\") {\n      const itemType = detectArrayItemType(analysis);\n      if (itemType) {\n        field.items = itemType;\n      }\n    }\n\n    // Detect enum for string fields\n    if (fieldType === \"string\") {\n      const enumValues = detectEnum(analysis.values, totalSamples);\n      if (enumValues) {\n        // Store enum values in the field\n        // Note: We use 'default' to store enum options since SchemaField\n        // doesn't have an 'enum' property - this can be enhanced later\n        field.description = `Options: ${enumValues.join(\", \")}`;\n      }\n    }\n\n    // Detect default value for boolean fields\n    if (fieldType === \"boolean\") {\n      const boolValues = analysis.values.filter(\n        (v): v is boolean => typeof v === \"boolean\"\n      );\n      if (boolValues.length > 0) {\n        // Use most common value as default\n        const trueCount = boolValues.filter((v) => v === true).length;\n        const falseCount = boolValues.filter((v) => v === false).length;\n        field.default = trueCount > falseCount ? true : false;\n      }\n    }\n\n    // Check for type inconsistencies\n    const nonNullTypes = [...analysis.types].filter((t) => t !== \"null\");\n    if (nonNullTypes.length > 1) {\n      warnings.push(\n        `Field \"${fieldName}\" has inconsistent types: ${nonNullTypes.join(\", \")}`\n      );\n    }\n\n    schema[fieldName] = field;\n  }\n\n  // Calculate confidence based on consistency\n  const inconsistentFields = warnings.filter((w) =>\n    w.includes(\"inconsistent\")\n  ).length;\n  const confidence = Math.max(\n    0,\n    1 - inconsistentFields / Math.max(1, fieldAnalyses.size)\n  );\n\n  return {\n    schema,\n    samplesAnalyzed: totalSamples,\n    confidence,\n    warnings,\n  };\n}\n\n/**\n * Merge detected schema with user-provided schema\n *\n * User schema takes precedence over detected schema.\n *\n * @param detected - Auto-detected schema\n * @param userSchema - User-provided schema overrides\n * @returns Merged schema\n */\nexport function mergeSchema(\n  detected: CollectionSchema,\n  userSchema?: CollectionSchema\n): CollectionSchema {\n  if (!userSchema) return detected;\n\n  const merged: CollectionSchema = { ...detected };\n\n  for (const [fieldName, userField] of Object.entries(userSchema)) {\n    merged[fieldName] = {\n      ...detected[fieldName],\n      ...userField,\n    };\n  }\n\n  return merged;\n}\n\n/**\n * Convert schema to a human-readable description\n *\n * @param schema - The schema to describe\n * @returns Human-readable description\n */\nexport function describeSchema(schema: CollectionSchema): string {\n  const lines: string[] = [];\n\n  for (const [fieldName, field] of Object.entries(schema)) {\n    let desc = `- ${fieldName}: ${field.type}`;\n\n    if (field.required) {\n      desc += \" (required)\";\n    }\n\n    if (field.items) {\n      desc += ` of ${field.items}`;\n    }\n\n    if (field.default !== undefined) {\n      desc += ` [default: ${JSON.stringify(field.default)}]`;\n    }\n\n    if (field.description) {\n      desc += ` - ${field.description}`;\n    }\n\n    lines.push(desc);\n  }\n\n  return lines.join(\"\\n\");\n}\n","/**\n * @fileoverview Collection discovery for Astro content collections\n *\n * This module provides functions to auto-discover content collections\n * from an Astro project's src/content directory.\n *\n * ## Discovery Process:\n * 1. Scan src/content/ for subdirectories\n * 2. Each subdirectory is treated as a collection\n * 3. Count content files in each collection\n * 4. Detect file patterns from existing files\n * 5. Auto-detect frontmatter schema from sample files\n *\n * @module @writenex/astro/discovery/collections\n */\n\nimport { readdir, stat } from \"node:fs/promises\";\nimport { existsSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport type { DiscoveredCollection, CollectionConfig } from \"@/types\";\nimport { getCollectionCount } from \"@/filesystem/reader\";\nimport { DEFAULT_FILE_PATTERN } from \"@/config/defaults\";\nimport { detectFilePattern as detectPattern } from \"./patterns\";\nimport { detectSchema } from \"./schema\";\n\n/**\n * Default content directory path relative to project root\n */\nconst DEFAULT_CONTENT_DIR = \"src/content\";\n\n/**\n * Directories to ignore during discovery\n */\nconst IGNORED_DIRECTORIES = new Set([\"node_modules\", \".git\", \"_\", \".\"]);\n\n/**\n * Check if a directory should be ignored\n *\n * @param name - Directory name\n * @returns True if should be ignored\n */\nfunction shouldIgnore(name: string): boolean {\n  return (\n    IGNORED_DIRECTORIES.has(name) ||\n    name.startsWith(\"_\") ||\n    name.startsWith(\".\")\n  );\n}\n\n/**\n * Discover all content collections in a project\n *\n * Scans the src/content directory for subdirectories and treats\n * each as a content collection.\n *\n * @param projectRoot - Absolute path to the project root\n * @param contentDir - Relative path to content directory (default: src/content)\n * @returns Array of discovered collections\n *\n * @example\n * ```typescript\n * const collections = await discoverCollections('/path/to/project');\n * // Returns: [\n * //   { name: 'blog', path: 'src/content/blog', count: 10, ... },\n * //   { name: 'docs', path: 'src/content/docs', count: 5, ... },\n * // ]\n * ```\n */\nexport async function discoverCollections(\n  projectRoot: string,\n  contentDir: string = DEFAULT_CONTENT_DIR\n): Promise<DiscoveredCollection[]> {\n  const contentPath = join(projectRoot, contentDir);\n\n  // Check if content directory exists\n  if (!existsSync(contentPath)) {\n    return [];\n  }\n\n  const collections: DiscoveredCollection[] = [];\n\n  try {\n    const entries = await readdir(contentPath, { withFileTypes: true });\n\n    for (const entry of entries) {\n      // Skip non-directories and ignored directories\n      if (!entry.isDirectory() || shouldIgnore(entry.name)) {\n        continue;\n      }\n\n      const collectionPath = join(contentPath, entry.name);\n      const relativePath = join(contentDir, entry.name);\n\n      // Count content files in this collection\n      const count = await getCollectionCount(collectionPath);\n\n      // Detect file pattern using pattern detection module\n      const patternResult = await detectPattern(collectionPath);\n      const filePattern = patternResult.pattern;\n\n      // Auto-detect schema from sample files\n      const schemaResult = await detectSchema(collectionPath);\n      const schema =\n        Object.keys(schemaResult.schema).length > 0\n          ? schemaResult.schema\n          : undefined;\n\n      // Generate default preview URL pattern\n      const previewUrl = `/${entry.name}/{slug}`;\n\n      collections.push({\n        name: entry.name,\n        path: relativePath,\n        filePattern,\n        count,\n        schema,\n        previewUrl,\n      });\n    }\n  } catch (error) {\n    console.error(`[writenex] Failed to discover collections: ${error}`);\n  }\n\n  return collections;\n}\n\n/**\n * Merge discovered collections with configured collections\n *\n * Configured collections take precedence over discovered ones.\n * This allows users to override auto-discovered settings.\n *\n * @param discovered - Auto-discovered collections\n * @param configured - User-configured collections\n * @returns Merged collection list\n */\nexport function mergeCollections(\n  discovered: DiscoveredCollection[],\n  configured: CollectionConfig[]\n): DiscoveredCollection[] {\n  const configuredNames = new Set(configured.map((c) => c.name));\n  const result: DiscoveredCollection[] = [];\n\n  // Add configured collections first (they take precedence)\n  for (const config of configured) {\n    const discoveredMatch = discovered.find((d) => d.name === config.name);\n\n    result.push({\n      name: config.name,\n      path: config.path,\n      filePattern:\n        config.filePattern ??\n        discoveredMatch?.filePattern ??\n        DEFAULT_FILE_PATTERN,\n      count: discoveredMatch?.count ?? 0,\n      schema: config.schema ?? discoveredMatch?.schema,\n      previewUrl:\n        config.previewUrl ??\n        discoveredMatch?.previewUrl ??\n        `/${config.name}/{slug}`,\n    });\n  }\n\n  // Add discovered collections that weren't configured\n  for (const disc of discovered) {\n    if (!configuredNames.has(disc.name)) {\n      result.push(disc);\n    }\n  }\n\n  return result;\n}\n\n/**\n * Get a single collection by name\n *\n * @param projectRoot - Absolute path to the project root\n * @param collectionName - Name of the collection\n * @param contentDir - Relative path to content directory\n * @returns The collection if found, undefined otherwise\n */\nexport async function getCollection(\n  projectRoot: string,\n  collectionName: string,\n  contentDir: string = DEFAULT_CONTENT_DIR\n): Promise<DiscoveredCollection | undefined> {\n  const collections = await discoverCollections(projectRoot, contentDir);\n  return collections.find((c) => c.name === collectionName);\n}\n\n/**\n * Check if a collection exists\n *\n * @param projectRoot - Absolute path to the project root\n * @param collectionName - Name of the collection\n * @param contentDir - Relative path to content directory\n * @returns True if the collection exists\n */\nexport async function collectionExists(\n  projectRoot: string,\n  collectionName: string,\n  contentDir: string = DEFAULT_CONTENT_DIR\n): Promise<boolean> {\n  const collectionPath = join(projectRoot, contentDir, collectionName);\n\n  if (!existsSync(collectionPath)) {\n    return false;\n  }\n\n  try {\n    const stats = await stat(collectionPath);\n    return stats.isDirectory();\n  } catch {\n    return false;\n  }\n}\n"],"mappings":"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","names":["item"]}

package/dist/chunk-KIKIPIFA.js

@@ -0,0 +1 @@
+//# sourceMappingURL=chunk-KIKIPIFA.js.map

package/dist/chunk-KIKIPIFA.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/chunk-XNTQTTJU.js

@@ -0,0 +1,145 @@
+// src/filesystem/watcher.ts
+import { watch } from "chokidar";
+import { stat } from "fs/promises";
+import { join } from "path";
+var ContentWatcher = class {
+  watcher = null;
+  projectRoot;
+  contentDir;
+  options;
+  debounceTimers = /* @__PURE__ */ new Map();
+  constructor(projectRoot, contentDir = "src/content", options = {}) {
+    this.projectRoot = projectRoot;
+    this.contentDir = contentDir;
+    this.options = {
+      debounceMs: 100,
+      ignored: ["**/node_modules/**", "**/.git/**"],
+      ...options
+    };
+  }
+  /**
+   * Start watching for file changes
+   */
+  start() {
+    if (this.watcher) {
+      return;
+    }
+    const watchPath = join(this.projectRoot, this.contentDir);
+    this.watcher = watch(watchPath, {
+      ignored: this.options.ignored,
+      persistent: true,
+      ignoreInitial: true,
+      awaitWriteFinish: {
+        stabilityThreshold: 100,
+        pollInterval: 50
+      }
+    });
+    this.watcher.on("add", (path) => this.handleChange("add", path)).on("change", (path) => this.handleChange("change", path)).on("unlink", (path) => this.handleChange("unlink", path)).on("error", (error) => {
+      console.error("[writenex] Watcher error:", error);
+    });
+  }
+  /**
+   * Stop watching for file changes
+   */
+  async stop() {
+    if (this.watcher) {
+      await this.watcher.close();
+      this.watcher = null;
+    }
+    for (const timer of this.debounceTimers.values()) {
+      clearTimeout(timer);
+    }
+    this.debounceTimers.clear();
+  }
+  /**
+   * Handle a file change event
+   */
+  handleChange(type, filePath) {
+    if (!filePath.endsWith(".md") && !filePath.endsWith(".mdx")) {
+      return;
+    }
+    const existingTimer = this.debounceTimers.get(filePath);
+    if (existingTimer) {
+      clearTimeout(existingTimer);
+    }
+    const timer = setTimeout(() => {
+      this.debounceTimers.delete(filePath);
+      this.emitChange(type, filePath);
+    }, this.options.debounceMs);
+    this.debounceTimers.set(filePath, timer);
+  }
+  /**
+   * Emit a file change event
+   */
+  emitChange(type, filePath) {
+    if (!this.options.onChange) {
+      return;
+    }
+    const contentPath = join(this.projectRoot, this.contentDir);
+    const relativePath = filePath.replace(contentPath, "").replace(/^[/\\]/, "");
+    const parts = relativePath.split(/[/\\]/);
+    const collection = parts[0] ?? "";
+    this.options.onChange({
+      type,
+      path: filePath,
+      collection
+    });
+  }
+  /**
+   * Check if the watcher is running
+   */
+  isWatching() {
+    return this.watcher !== null;
+  }
+};
+var FileModificationTracker = class {
+  mtimes = /* @__PURE__ */ new Map();
+  /**
+   * Record the current modification time of a file
+   */
+  async track(filePath) {
+    try {
+      const stats = await stat(filePath);
+      this.mtimes.set(filePath, stats.mtimeMs);
+    } catch {
+      this.mtimes.delete(filePath);
+    }
+  }
+  /**
+   * Check if a file has been modified externally
+   */
+  async hasExternalChanges(filePath) {
+    const lastKnown = this.mtimes.get(filePath);
+    if (lastKnown === void 0) {
+      return false;
+    }
+    try {
+      const stats = await stat(filePath);
+      return stats.mtimeMs > lastKnown;
+    } catch {
+      return true;
+    }
+  }
+  /**
+   * Clear tracking for a file
+   */
+  untrack(filePath) {
+    this.mtimes.delete(filePath);
+  }
+  /**
+   * Clear all tracking
+   */
+  clear() {
+    this.mtimes.clear();
+  }
+};
+function createContentWatcher(projectRoot, options) {
+  return new ContentWatcher(projectRoot, "src/content", options);
+}
+
+export {
+  ContentWatcher,
+  FileModificationTracker,
+  createContentWatcher
+};
+//# sourceMappingURL=chunk-XNTQTTJU.js.map

package/dist/chunk-XNTQTTJU.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/filesystem/watcher.ts"],"sourcesContent":["/**\n * @fileoverview File watcher for detecting external changes\n *\n * This module provides file watching capabilities to detect when\n * content files are modified outside of the Writenex editor\n * (e.g., in VS Code or another editor).\n *\n * @module @writenex/astro/filesystem/watcher\n */\n\nimport { watch, type FSWatcher } from \"chokidar\";\nimport { stat } from \"node:fs/promises\";\nimport { join } from \"node:path\";\n\n/**\n * File change event types\n */\nexport type FileChangeType = \"add\" | \"change\" | \"unlink\";\n\n/**\n * File change event\n */\nexport interface FileChangeEvent {\n  type: FileChangeType;\n  path: string;\n  collection: string;\n}\n\n/**\n * Watcher options\n */\nexport interface WatcherOptions {\n  /** Callback when a file changes */\n  onChange?: (event: FileChangeEvent) => void;\n  /** Debounce delay in milliseconds */\n  debounceMs?: number;\n  /** Patterns to ignore */\n  ignored?: string[];\n}\n\n/**\n * Content file watcher\n *\n * Watches the src/content directory for changes and emits events\n * when files are added, modified, or deleted.\n */\nexport class ContentWatcher {\n  private watcher: FSWatcher | null = null;\n  private projectRoot: string;\n  private contentDir: string;\n  private options: WatcherOptions;\n  private debounceTimers: Map<string, NodeJS.Timeout> = new Map();\n\n  constructor(\n    projectRoot: string,\n    contentDir: string = \"src/content\",\n    options: WatcherOptions = {}\n  ) {\n    this.projectRoot = projectRoot;\n    this.contentDir = contentDir;\n    this.options = {\n      debounceMs: 100,\n      ignored: [\"**/node_modules/**\", \"**/.git/**\"],\n      ...options,\n    };\n  }\n\n  /**\n   * Start watching for file changes\n   */\n  start(): void {\n    if (this.watcher) {\n      return; // Already watching\n    }\n\n    const watchPath = join(this.projectRoot, this.contentDir);\n\n    this.watcher = watch(watchPath, {\n      ignored: this.options.ignored,\n      persistent: true,\n      ignoreInitial: true,\n      awaitWriteFinish: {\n        stabilityThreshold: 100,\n        pollInterval: 50,\n      },\n    });\n\n    this.watcher\n      .on(\"add\", (path) => this.handleChange(\"add\", path))\n      .on(\"change\", (path) => this.handleChange(\"change\", path))\n      .on(\"unlink\", (path) => this.handleChange(\"unlink\", path))\n      .on(\"error\", (error) => {\n        console.error(\"[writenex] Watcher error:\", error);\n      });\n  }\n\n  /**\n   * Stop watching for file changes\n   */\n  async stop(): Promise<void> {\n    if (this.watcher) {\n      await this.watcher.close();\n      this.watcher = null;\n    }\n\n    // Clear all debounce timers\n    for (const timer of this.debounceTimers.values()) {\n      clearTimeout(timer);\n    }\n    this.debounceTimers.clear();\n  }\n\n  /**\n   * Handle a file change event\n   */\n  private handleChange(type: FileChangeType, filePath: string): void {\n    // Only handle markdown files\n    if (!filePath.endsWith(\".md\") && !filePath.endsWith(\".mdx\")) {\n      return;\n    }\n\n    // Debounce rapid changes\n    const existingTimer = this.debounceTimers.get(filePath);\n    if (existingTimer) {\n      clearTimeout(existingTimer);\n    }\n\n    const timer = setTimeout(() => {\n      this.debounceTimers.delete(filePath);\n      this.emitChange(type, filePath);\n    }, this.options.debounceMs);\n\n    this.debounceTimers.set(filePath, timer);\n  }\n\n  /**\n   * Emit a file change event\n   */\n  private emitChange(type: FileChangeType, filePath: string): void {\n    if (!this.options.onChange) {\n      return;\n    }\n\n    // Extract collection name from path\n    const contentPath = join(this.projectRoot, this.contentDir);\n    const relativePath = filePath\n      .replace(contentPath, \"\")\n      .replace(/^[/\\\\]/, \"\");\n    const parts = relativePath.split(/[/\\\\]/);\n    const collection = parts[0] ?? \"\";\n\n    this.options.onChange({\n      type,\n      path: filePath,\n      collection,\n    });\n  }\n\n  /**\n   * Check if the watcher is running\n   */\n  isWatching(): boolean {\n    return this.watcher !== null;\n  }\n}\n\n/**\n * Track file modification times for conflict detection\n */\nexport class FileModificationTracker {\n  private mtimes: Map<string, number> = new Map();\n\n  /**\n   * Record the current modification time of a file\n   */\n  async track(filePath: string): Promise<void> {\n    try {\n      const stats = await stat(filePath);\n      this.mtimes.set(filePath, stats.mtimeMs);\n    } catch {\n      // File might not exist yet\n      this.mtimes.delete(filePath);\n    }\n  }\n\n  /**\n   * Check if a file has been modified externally\n   */\n  async hasExternalChanges(filePath: string): Promise<boolean> {\n    const lastKnown = this.mtimes.get(filePath);\n    if (lastKnown === undefined) {\n      return false; // Not tracked, assume no changes\n    }\n\n    try {\n      const stats = await stat(filePath);\n      return stats.mtimeMs > lastKnown;\n    } catch {\n      return true; // File might have been deleted\n    }\n  }\n\n  /**\n   * Clear tracking for a file\n   */\n  untrack(filePath: string): void {\n    this.mtimes.delete(filePath);\n  }\n\n  /**\n   * Clear all tracking\n   */\n  clear(): void {\n    this.mtimes.clear();\n  }\n}\n\n/**\n * Create a content watcher instance\n */\nexport function createContentWatcher(\n  projectRoot: string,\n  options?: WatcherOptions\n): ContentWatcher {\n  return new ContentWatcher(projectRoot, \"src/content\", options);\n}\n"],"mappings":"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","names":[]}