@nuasite/cms-marker 0.0.53 → 0.0.54

package/README.md

@@ -231,10 +231,6 @@ bun test
 
 See `src/tests/` for all test cases.
 
-## License
-
-MIT
-
 ## Contributing
 
 Contributions are welcome! Please feel free to submit issues and pull requests.

package/dist/types/astro-transform.d.ts

@@ -0,0 +1,21 @@
+import type { Plugin } from 'vite';
+export interface AstroTransformOptions {
+    markComponents?: boolean;
+    enabled?: boolean;
+}
+/**
+ * Vite plugin that transforms .astro files to inject source location metadata.
+ *
+ * NOTE: This plugin is currently DISABLED because Astro's native compiler already
+ * injects `data-astro-source-file` and `data-astro-source-loc` attributes in dev mode.
+ * Our html-processor now recognizes both Astro's native attributes and our custom ones.
+ *
+ * HISTORICAL CONTEXT: This plugin was created before we discovered Astro's native
+ * source tracking. It caused Vite's build-import-analysis to fail with parsing errors
+ * because modifying .astro source files confuses Vite's JavaScript parser.
+ *
+ * KEEPING FOR: Potential future use cases where custom source attribute injection
+ * might be needed, or for testing purposes.
+ */
+export declare function createAstroTransformPlugin(options?: AstroTransformOptions): Plugin;
+//# sourceMappingURL=astro-transform.d.ts.map

package/dist/types/astro-transform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"astro-transform.d.ts","sourceRoot":"","sources":["../../src/astro-transform.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAA;AAElC,MAAM,WAAW,qBAAqB;IACrC,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,OAAO,CAAC,EAAE,OAAO,CAAA;CACjB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,GAAE,qBAA0B,GAAG,MAAM,CAgDtF"}

package/dist/types/build-processor.d.ts

@@ -0,0 +1,10 @@
+import type { AstroIntegrationLogger } from 'astro';
+import type { ManifestWriter } from './manifest-writer';
+import type { CmsMarkerOptions } from './types';
+/**
+ * Process build output - processes all HTML files in parallel
+ */
+export declare function processBuildOutput(dir: URL, config: Required<CmsMarkerOptions>, manifestWriter: ManifestWriter, idCounter: {
+    value: number;
+}, logger?: AstroIntegrationLogger): Promise<void>;
+//# sourceMappingURL=build-processor.d.ts.map

package/dist/types/build-processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-processor.d.ts","sourceRoot":"","sources":["../../src/build-processor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,OAAO,CAAA;AAKnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAEvD,OAAO,KAAK,EAAE,gBAAgB,EAAmB,MAAM,SAAS,CAAA;AA0KhE;;GAEG;AACH,wBAAsB,kBAAkB,CACvC,GAAG,EAAE,GAAG,EACR,MAAM,EAAE,QAAQ,CAAC,gBAAgB,CAAC,EAClC,cAAc,EAAE,cAAc,EAC9B,SAAS,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,EAC5B,MAAM,CAAC,EAAE,sBAAsB,GAC7B,OAAO,CAAC,IAAI,CAAC,CA2Bf"}

package/dist/types/component-registry.d.ts

@@ -0,0 +1,63 @@
+import type { ComponentDefinition } from './types';
+/**
+ * Scans Astro component files and extracts their definitions including props
+ */
+export declare class ComponentRegistry {
+    private components;
+    private componentDirs;
+    constructor(componentDirs?: string[]);
+    /**
+     * Scan all component directories and build the registry
+     */
+    scan(): Promise<void>;
+    /**
+     * Get all registered components
+     */
+    getComponents(): Record<string, ComponentDefinition>;
+    /**
+     * Get a specific component by name
+     */
+    getComponent(name: string): ComponentDefinition | undefined;
+    /**
+     * Scan a directory recursively for .astro files
+     */
+    private scanDirectory;
+    /**
+     * Parse a single Astro component file
+     */
+    private parseComponent;
+    /**
+     * Parse Props content and extract individual property definitions
+     * Handles multi-line properties with nested types
+     */
+    private parsePropsContent;
+    /**
+     * Extract content between balanced braces after a pattern match
+     * Properly handles nested objects
+     */
+    private extractBalancedBraces;
+    /**
+     * Extract props from component frontmatter
+     */
+    private extractProps;
+    /**
+     * Parse a single prop line from interface/type
+     */
+    private parsePropLine;
+    /**
+     * Extract slot names from template
+     */
+    private extractSlots;
+    /**
+     * Extract component description from JSDoc comment
+     */
+    private extractDescription;
+}
+/**
+ * Parse component usage in an Astro file to extract prop values
+ */
+export declare function parseComponentUsage(content: string, componentName: string): Array<{
+    line: number;
+    props: Record<string, string>;
+}>;
+//# sourceMappingURL=component-registry.d.ts.map

package/dist/types/component-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-registry.d.ts","sourceRoot":"","sources":["../../src/component-registry.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAiB,MAAM,SAAS,CAAA;AAEjE;;GAEG;AACH,qBAAa,iBAAiB;IAC7B,OAAO,CAAC,UAAU,CAA8C;IAChE,OAAO,CAAC,aAAa,CAAU;gBAEnB,aAAa,GAAE,MAAM,EAAuB;IAIxD;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAW3B;;OAEG;IACH,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC;IAIpD;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS;IAI3D;;OAEG;YACW,aAAa;IAe3B;;OAEG;YACW,cAAc;IAqB5B;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IA2FzB;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAyB7B;;OAEG;YACW,YAAY;IA2C1B;;OAEG;IACH,OAAO,CAAC,aAAa;IAoBrB;;OAEG;IACH,OAAO,CAAC,YAAY;IA2BpB;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAY1B;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAClC,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,MAAM,GACnB,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAAC,CA6BxD"}

package/dist/types/dev-middleware.d.ts

@@ -0,0 +1,7 @@
+import type { ViteDevServer } from 'vite';
+import type { ManifestWriter } from './manifest-writer';
+import type { CmsMarkerOptions, ComponentDefinition } from './types';
+export declare function createDevMiddleware(server: ViteDevServer, config: Required<CmsMarkerOptions>, manifestWriter: ManifestWriter, componentDefinitions: Record<string, ComponentDefinition>, idCounter: {
+    value: number;
+}): void;
+//# sourceMappingURL=dev-middleware.d.ts.map

package/dist/types/dev-middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-middleware.d.ts","sourceRoot":"","sources":["../../src/dev-middleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,MAAM,CAAA;AAEzC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAEvD,OAAO,KAAK,EAAE,gBAAgB,EAAmB,mBAAmB,EAAE,MAAM,SAAS,CAAA;AAkBrF,wBAAgB,mBAAmB,CAClC,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,QAAQ,CAAC,gBAAgB,CAAC,EAClC,cAAc,EAAE,cAAc,EAC9B,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,EACzD,SAAS,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,QA0H5B"}

package/dist/types/html-processor.d.ts

@@ -0,0 +1,51 @@
+import type { ComponentInstance, ManifestEntry } from './types';
+/**
+ * Inline text styling elements that should NOT be marked with CMS IDs.
+ * These elements are text formatting and should be part of their parent's content.
+ * They will be preserved as HTML when editing the parent element.
+ */
+export declare const INLINE_STYLE_TAGS: readonly ["strong", "b", "em", "i", "u", "s", "strike", "del", "ins", "mark", "small", "sub", "sup", "abbr", "cite", "code", "kbd", "samp", "var", "time", "dfn", "q"];
+export interface ProcessHtmlOptions {
+    attributeName: string;
+    includeTags: string[] | null;
+    excludeTags: string[];
+    includeEmptyText: boolean;
+    generateManifest: boolean;
+    markComponents?: boolean;
+    componentDirs?: string[];
+    excludeComponentDirs?: string[];
+    markStyledSpans?: boolean;
+    /** When true, only mark elements that have source file attributes (from Astro templates) */
+    skipMarkdownContent?: boolean;
+    /**
+     * When true, skip marking inline text styling elements (strong, b, em, i, etc.).
+     * These elements will be preserved as part of their parent's HTML content.
+     * Defaults to true.
+     */
+    skipInlineStyleTags?: boolean;
+    /** Collection info for marking the wrapper element containing markdown content */
+    collectionInfo?: {
+        name: string;
+        slug: string;
+        /** First line of the markdown body (used to find wrapper element in build mode) */
+        bodyFirstLine?: string;
+        /** Path to the markdown file (e.g., 'src/content/blog/my-post.md') */
+        contentPath?: string;
+    };
+}
+export interface ProcessHtmlResult {
+    html: string;
+    entries: Record<string, ManifestEntry>;
+    components: Record<string, ComponentInstance>;
+    /** ID of the element wrapping collection markdown content */
+    collectionWrapperId?: string;
+}
+/**
+ * Process HTML to inject CMS markers and extract manifest entries
+ */
+export declare function processHtml(html: string, fileId: string, options: ProcessHtmlOptions, getNextId: () => string, sourcePath?: string): Promise<ProcessHtmlResult>;
+/**
+ * Clean text for comparison (normalize whitespace)
+ */
+export declare function cleanText(text: string): string;
+//# sourceMappingURL=html-processor.d.ts.map

package/dist/types/html-processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-processor.d.ts","sourceRoot":"","sources":["../../src/html-processor.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAiB,MAAM,SAAS,CAAA;AAG9E;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,wKAuBpB,CAAA;AAEV,MAAM,WAAW,kBAAkB;IAClC,aAAa,EAAE,MAAM,CAAA;IACrB,WAAW,EAAE,MAAM,EAAE,GAAG,IAAI,CAAA;IAC5B,WAAW,EAAE,MAAM,EAAE,CAAA;IACrB,gBAAgB,EAAE,OAAO,CAAA;IACzB,gBAAgB,EAAE,OAAO,CAAA;IACzB,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;IACxB,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAA;IAC/B,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,4FAA4F;IAC5F,mBAAmB,CAAC,EAAE,OAAO,CAAA;IAC7B;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAA;IAC7B,kFAAkF;IAClF,cAAc,CAAC,EAAE;QAChB,IAAI,EAAE,MAAM,CAAA;QACZ,IAAI,EAAE,MAAM,CAAA;QACZ,mFAAmF;QACnF,aAAa,CAAC,EAAE,MAAM,CAAA;QACtB,sEAAsE;QACtE,WAAW,CAAC,EAAE,MAAM,CAAA;KACpB,CAAA;CACD;AAED,MAAM,WAAW,iBAAiB;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAA;IACtC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAA;IAC7C,6DAA6D;IAC7D,mBAAmB,CAAC,EAAE,MAAM,CAAA;CAC5B;AA+ED;;GAEG;AACH,wBAAsB,WAAW,CAChC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,kBAAkB,EAC3B,SAAS,EAAE,MAAM,MAAM,EACvB,UAAU,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,iBAAiB,CAAC,CAyb5B;AAaD;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9C"}

package/dist/types/index.d.ts

@@ -0,0 +1,7 @@
+import type { AstroIntegration } from 'astro';
+import type { CmsMarkerOptions } from './types';
+export default function cmsMarker(options?: CmsMarkerOptions): AstroIntegration;
+export { findCollectionSource, parseMarkdownContent } from './source-finder';
+export type { CollectionInfo, MarkdownContent } from './source-finder';
+export type { CmsManifest, CmsMarkerOptions, CollectionEntry, ComponentDefinition, ComponentInstance, ManifestEntry } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,OAAO,CAAA;AAK7C,OAAO,KAAK,EAAE,gBAAgB,EAAuB,MAAM,SAAS,CAAA;AAGpE,MAAM,CAAC,OAAO,UAAU,SAAS,CAAC,OAAO,GAAE,gBAAqB,GAAG,gBAAgB,CAkFlF;AAGD,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAA;AAC5E,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AACtE,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,eAAe,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA"}

package/dist/types/manifest-writer.d.ts

@@ -0,0 +1,75 @@
+import type { AvailableColors, CmsManifest, CollectionEntry, ComponentDefinition, ComponentInstance, ManifestEntry } from './types';
+/**
+ * Manages streaming manifest writes during build.
+ * Accumulates entries and writes per-page manifests as pages are processed.
+ */
+export declare class ManifestWriter {
+    private globalManifest;
+    private pageManifests;
+    private outDir;
+    private manifestFile;
+    private componentDefinitions;
+    private availableColors;
+    private writeQueue;
+    constructor(manifestFile: string, componentDefinitions?: Record<string, ComponentDefinition>);
+    /**
+     * Set the output directory for manifest files
+     */
+    setOutDir(dir: string): void;
+    /**
+     * Update component definitions (called after initial scan)
+     */
+    setComponentDefinitions(definitions: Record<string, ComponentDefinition>): void;
+    /**
+     * Load available Tailwind colors from the project's CSS config
+     */
+    loadAvailableColors(projectRoot?: string): Promise<void>;
+    /**
+     * Set available colors directly (for testing or custom colors)
+     */
+    setAvailableColors(colors: AvailableColors): void;
+    /**
+     * Get the manifest path for a given page
+     * Places manifest next to the page: /about -> /about.json, / -> /index.json
+     */
+    private getPageManifestPath;
+    /**
+     * Add a page's entries to the manifest (called after each page is processed)
+     * This is non-blocking - writes are queued
+     */
+    addPage(pagePath: string, entries: Record<string, ManifestEntry>, components: Record<string, ComponentInstance>, collection?: CollectionEntry): void;
+    /**
+     * Write a single page manifest to disk
+     */
+    private writePageManifest;
+    /**
+     * Finalize manifest writes
+     * Call this in astro:build:done to ensure all writes complete
+     */
+    finalize(): Promise<{
+        totalEntries: number;
+        totalPages: number;
+        totalComponents: number;
+    }>;
+    /**
+     * Get the global manifest (for virtual module support)
+     */
+    getGlobalManifest(): CmsManifest;
+    /**
+     * Get a page's manifest data (for dev mode)
+     */
+    getPageManifest(pagePath: string): {
+        entries: Record<string, ManifestEntry>;
+        components: Record<string, ComponentInstance>;
+        collection?: CollectionEntry;
+    } | undefined;
+    /**
+     * Reset state (for dev mode reloads)
+     */
+    reset(): void;
+    /**
+     * Get available colors (for use in dev middleware)
+     */
+    getAvailableColors(): AvailableColors | undefined;
+}
+//# sourceMappingURL=manifest-writer.d.ts.map

package/dist/types/manifest-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-writer.d.ts","sourceRoot":"","sources":["../../src/manifest-writer.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,eAAe,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,aAAa,EAAoB,MAAM,SAAS,CAAA;AAMrJ;;;GAGG;AACH,qBAAa,cAAc;IAC1B,OAAO,CAAC,cAAc,CAAa;IACnC,OAAO,CAAC,aAAa,CAIP;IACd,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,YAAY,CAAQ;IAC5B,OAAO,CAAC,oBAAoB,CAAqC;IACjE,OAAO,CAAC,eAAe,CAA6B;IACpD,OAAO,CAAC,UAAU,CAAmC;gBAEzC,YAAY,EAAE,MAAM,EAAE,oBAAoB,GAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAM;IAWhG;;OAEG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAI5B;;OAEG;IACH,uBAAuB,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,GAAG,IAAI;IAK/E;;OAEG;IACG,mBAAmB,CAAC,WAAW,GAAE,MAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IAK7E;;OAEG;IACH,kBAAkB,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI;IAKjD;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAQ3B;;;OAGG;IACH,OAAO,CACN,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,EACtC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,EAC7C,UAAU,CAAC,EAAE,eAAe,GAC1B,IAAI;IAqBP;;OAEG;YACW,iBAAiB;IA+C/B;;;OAGG;IACG,QAAQ,IAAI,OAAO,CAAC;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAA;KAAE,CAAC;IAwBhG;;OAEG;IACH,iBAAiB,IAAI,WAAW;IAIhC;;OAEG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG;QAClC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAA;QACtC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAA;QAC7C,UAAU,CAAC,EAAE,eAAe,CAAA;KAC5B,GAAG,SAAS;IAIb;;OAEG;IACH,KAAK,IAAI,IAAI;IAYb;;OAEG;IACH,kBAAkB,IAAI,eAAe,GAAG,SAAS;CAGjD"}

package/dist/types/source-finder.d.ts

@@ -0,0 +1,97 @@
+import type { ManifestEntry } from './types';
+export interface SourceLocation {
+    file: string;
+    line: number;
+    snippet?: string;
+    type?: 'static' | 'variable' | 'prop' | 'computed' | 'collection';
+    variableName?: string;
+    definitionLine?: number;
+    /** Collection name for collection entries */
+    collectionName?: string;
+    /** Entry slug for collection entries */
+    collectionSlug?: string;
+}
+export interface VariableReference {
+    name: string;
+    pattern: string;
+    definitionLine: number;
+}
+export interface CollectionInfo {
+    name: string;
+    slug: string;
+    file: string;
+}
+export interface MarkdownContent {
+    /** Frontmatter fields as key-value pairs with line numbers */
+    frontmatter: Record<string, {
+        value: string;
+        line: number;
+    }>;
+    /** The full markdown body content */
+    body: string;
+    /** Line number where body starts */
+    bodyStartLine: number;
+    /** File path relative to cwd */
+    file: string;
+    /** Collection name */
+    collectionName: string;
+    /** Collection slug */
+    collectionSlug: string;
+}
+/**
+ * Find source file and line number for text content
+ */
+export declare function findSourceLocation(textContent: string, tag: string): Promise<SourceLocation | undefined>;
+/**
+ * Extract complete tag snippet including content and indentation.
+ * Exported for use in html-processor to populate sourceSnippet.
+ */
+export declare function extractCompleteTagSnippet(lines: string[], startLine: number, tag: string): string;
+/**
+ * Extract innerHTML from a complete tag snippet.
+ * Given `<p class="foo">content here</p>`, returns `content here`.
+ *
+ * @param snippet - The complete tag snippet from source
+ * @param tag - The tag name (e.g., 'p', 'h1')
+ * @returns The innerHTML portion, or undefined if can't extract
+ */
+export declare function extractInnerHtmlFromSnippet(snippet: string, tag: string): string | undefined;
+/**
+ * Read source file and extract the innerHTML at the specified line.
+ *
+ * @param sourceFile - Path to source file (relative to cwd)
+ * @param sourceLine - 1-indexed line number
+ * @param tag - The tag name
+ * @returns The innerHTML from source, or undefined if can't extract
+ */
+export declare function extractSourceInnerHtml(sourceFile: string, sourceLine: number, tag: string): Promise<string | undefined>;
+/**
+ * Find markdown collection file for a given page path
+ * @param pagePath - The URL path of the page (e.g., '/services/3d-tisk')
+ * @param contentDir - The content directory (default: 'src/content')
+ * @returns Collection info if found, undefined otherwise
+ */
+export declare function findCollectionSource(pagePath: string, contentDir?: string): Promise<CollectionInfo | undefined>;
+/**
+ * Find text content in a markdown file and return source location
+ * Only matches frontmatter fields, not body content (body is handled separately as a whole)
+ * @param textContent - The text content to search for
+ * @param collectionInfo - Collection information (name, slug, file path)
+ * @returns Source location if found in frontmatter
+ */
+export declare function findMarkdownSourceLocation(textContent: string, collectionInfo: CollectionInfo): Promise<SourceLocation | undefined>;
+/**
+ * Parse markdown file and extract frontmatter fields and full body content
+ * @param collectionInfo - Collection information (name, slug, file path)
+ * @returns Parsed markdown content with frontmatter and body
+ */
+export declare function parseMarkdownContent(collectionInfo: CollectionInfo): Promise<MarkdownContent | undefined>;
+/**
+ * Enhance manifest entries with actual source snippets from source files.
+ * This reads the source files and extracts the innerHTML at the specified locations.
+ *
+ * @param entries - Manifest entries to enhance
+ * @returns Enhanced entries with sourceSnippet populated
+ */
+export declare function enhanceManifestWithSourceSnippets(entries: Record<string, ManifestEntry>): Promise<Record<string, ManifestEntry>>;
+//# sourceMappingURL=source-finder.d.ts.map

package/dist/types/source-finder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-finder.d.ts","sourceRoot":"","sources":["../../src/source-finder.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAG5C,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,QAAQ,GAAG,UAAU,GAAG,MAAM,GAAG,UAAU,GAAG,YAAY,CAAA;IACjE,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,6CAA6C;IAC7C,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,wCAAwC;IACxC,cAAc,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,iBAAiB;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,cAAc,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;CACZ;AAED,MAAM,WAAW,eAAe;IAC/B,8DAA8D;IAC9D,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAC5D,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAA;IACZ,oCAAoC;IACpC,aAAa,EAAE,MAAM,CAAA;IACrB,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,sBAAsB;IACtB,cAAc,EAAE,MAAM,CAAA;IACtB,sBAAsB;IACtB,cAAc,EAAE,MAAM,CAAA;CACtB;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACvC,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,MAAM,GACT,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAqCrC;AA0QD;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAmCjG;AAED;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAqB5F;AAED;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAC3C,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,GACT,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAiB7B;AAoHD;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACzC,QAAQ,EAAE,MAAM,EAChB,UAAU,GAAE,MAAsB,GAChC,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAoDrC;AA0DD;;;;;;GAMG;AACH,wBAAsB,0BAA0B,CAC/C,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,cAAc,GAC5B,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAiErC;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CACzC,cAAc,EAAE,cAAc,GAC5B,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC,CAqEtC;AAmBD;;;;;;GAMG;AACH,wBAAsB,iCAAiC,CACtD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,GACpC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAgCxC"}

package/dist/types/tailwind-colors.d.ts

@@ -0,0 +1,66 @@
+import type { AvailableColors, ColorClasses } from './types';
+/**
+ * Default Tailwind CSS v4 color names.
+ * These are available by default in Tailwind v4.
+ */
+export declare const DEFAULT_TAILWIND_COLORS: readonly ["slate", "gray", "zinc", "neutral", "stone", "red", "orange", "amber", "yellow", "lime", "green", "emerald", "teal", "cyan", "sky", "blue", "indigo", "violet", "purple", "fuchsia", "pink", "rose"];
+/**
+ * Standard Tailwind color shades.
+ */
+export declare const STANDARD_SHADES: readonly ["50", "100", "200", "300", "400", "500", "600", "700", "800", "900", "950"];
+/**
+ * Special color values that don't have shades.
+ */
+export declare const SPECIAL_COLORS: readonly ["transparent", "current", "inherit", "white", "black"];
+/**
+ * Parse Tailwind v4 CSS config to extract available colors.
+ * Tailwind v4 uses CSS-based configuration with @theme directive.
+ *
+ * Example CSS:
+ * ```css
+ * @theme {
+ *   --color-primary-50: #eff6ff;
+ *   --color-primary-500: #3b82f6;
+ *   --color-accent: #f59e0b;
+ * }
+ * ```
+ */
+export declare function parseTailwindConfig(projectRoot?: string): Promise<AvailableColors>;
+/**
+ * Extract color classes from an element's class attribute.
+ */
+export declare function extractColorClasses(classAttr: string | null | undefined): ColorClasses | undefined;
+/**
+ * Check if a class is a color class.
+ */
+export declare function isColorClass(className: string): boolean;
+/**
+ * Generate a new class string with a color class replaced.
+ * @param currentClasses - Current class attribute value
+ * @param oldColorClass - The color class to replace (e.g., 'bg-blue-500')
+ * @param newColorClass - The new color class (e.g., 'bg-red-500')
+ * @returns New class string with the replacement
+ */
+export declare function replaceColorClass(currentClasses: string, oldColorClass: string, newColorClass: string): string;
+/**
+ * Get the color type from a color class.
+ * @param colorClass - e.g., 'bg-blue-500', 'text-white', 'hover:bg-red-600'
+ * @returns The type: 'bg', 'text', 'border', 'hoverBg', 'hoverText', or undefined
+ */
+export declare function getColorType(colorClass: string): keyof ColorClasses | undefined;
+/**
+ * Parse a color class into its components.
+ * @param colorClass - e.g., 'bg-blue-500', 'text-white', 'hover:bg-red-600'
+ * @returns Object with prefix, colorName, and shade (if any)
+ */
+export declare function parseColorClass(colorClass: string): {
+    prefix: string;
+    colorName: string;
+    shade?: string;
+    isHover: boolean;
+} | undefined;
+/**
+ * Build a color class from components.
+ */
+export declare function buildColorClass(prefix: string, colorName: string, shade?: string): string;
+//# sourceMappingURL=tailwind-colors.d.ts.map

package/dist/types/tailwind-colors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tailwind-colors.d.ts","sourceRoot":"","sources":["../../src/tailwind-colors.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAiB,MAAM,SAAS,CAAA;AAE3E;;;GAGG;AACH,eAAO,MAAM,uBAAuB,gNAuB1B,CAAA;AAEV;;GAEG;AACH,eAAO,MAAM,eAAe,uFAAwF,CAAA;AAEpH;;GAEG;AACH,eAAO,MAAM,cAAc,kEAAmE,CAAA;AAgC9F;;;;;;;;;;;;GAYG;AACH,wBAAsB,mBAAmB,CAAC,WAAW,GAAE,MAAsB,GAAG,OAAO,CAAC,eAAe,CAAC,CA+CvG;AA6FD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,YAAY,GAAG,SAAS,CA4BlG;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAChC,cAAc,EAAE,MAAM,EACtB,aAAa,EAAE,MAAM,EACrB,aAAa,EAAE,MAAM,GACnB,MAAM,CAIR;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,YAAY,GAAG,SAAS,CAO/E;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG;IACpD,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,OAAO,CAAA;CAChB,GAAG,SAAS,CAgBZ;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC9B,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,KAAK,CAAC,EAAE,MAAM,GACZ,MAAM,CAKR"}