@nuasite/cms 0.1.0

package/dist/src/source-finder/element-finder.d.ts

@@ -0,0 +1,42 @@
+import type { Node as AstroNode } from '@astrojs/compiler/types';
+import type { ComponentPropMatch, ExpressionPropMatch, FindElementResult, ImportInfo, SpreadPropMatch, VariableDefinition } from './types';
+/**
+ * Get text content from an AST node recursively.
+ * Treats <br> elements as whitespace to match rendered HTML behavior.
+ */
+export declare function getTextContent(node: AstroNode): string;
+/**
+ * Check for expression children and extract variable names
+ */
+export declare function hasExpressionChild(node: AstroNode): {
+    found: boolean;
+    varNames: string[];
+};
+/**
+ * Walk the Astro AST to find elements matching a tag with specific text content.
+ * Returns the best match (local variables or static content) AND all prop/import candidates
+ * that need cross-file verification for multiple same-tag elements.
+ * @param propAliases - Map of local variable names to prop names from Astro.props (for cross-file tracking)
+ * @param imports - Import information from frontmatter (for cross-file tracking)
+ */
+export declare function findElementWithText(ast: AstroNode, tag: string, searchText: string, variableDefinitions: VariableDefinition[], propAliases?: Map<string, string>, imports?: ImportInfo[]): FindElementResult;
+/**
+ * Walk the Astro AST to find component props with specific text value
+ */
+export declare function findComponentProp(ast: AstroNode, searchText: string): ComponentPropMatch | null;
+/**
+ * Walk the Astro AST to find component usages with expression props.
+ * Looks for patterns like: <Nav items={navItems} />
+ * @param ast - The Astro AST
+ * @param componentName - The component name to search for (e.g., 'Nav')
+ * @param propName - The prop name to find (e.g., 'items')
+ */
+export declare function findExpressionProp(ast: AstroNode, componentName: string, propName: string): ExpressionPropMatch | null;
+/**
+ * Walk the Astro AST to find component usages with spread props.
+ * Looks for patterns like: <Card {...cardProps} />
+ * @param ast - The Astro AST
+ * @param componentName - The component name to search for (e.g., 'Card')
+ */
+export declare function findSpreadProp(ast: AstroNode, componentName: string): SpreadPropMatch | null;
+//# sourceMappingURL=element-finder.d.ts.map

package/dist/src/source-finder/element-finder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"element-finder.d.ts","sourceRoot":"","sources":["../../../src/source-finder/element-finder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAA8B,IAAI,IAAI,SAAS,EAAY,MAAM,yBAAyB,CAAA;AAItG,OAAO,KAAK,EACX,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,UAAU,EACV,eAAe,EAEf,kBAAkB,EAClB,MAAM,SAAS,CAAA;AAMhB;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAgBtD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,SAAS,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAsB1F;AAMD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAClC,GAAG,EAAE,SAAS,EACd,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,EAClB,mBAAmB,EAAE,kBAAkB,EAAE,EACzC,WAAW,GAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAa,EAC5C,OAAO,GAAE,UAAU,EAAO,GACxB,iBAAiB,CAoKnB;AAMD;;GAEG;AACH,wBAAgB,iBAAiB,CAChC,GAAG,EAAE,SAAS,EACd,UAAU,EAAE,MAAM,GAChB,kBAAkB,GAAG,IAAI,CAiC3B;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CACjC,GAAG,EAAE,SAAS,EACd,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,GACd,mBAAmB,GAAG,IAAI,CAoC5B;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC7B,GAAG,EAAE,SAAS,EACd,aAAa,EAAE,MAAM,GACnB,eAAe,GAAG,IAAI,CAgCxB"}

package/dist/src/source-finder/image-finder.d.ts

@@ -0,0 +1,24 @@
+import type { Node as AstroNode } from '@astrojs/compiler/types';
+import type { ImageMatch, SourceLocation } from './types';
+/**
+ * Walk the Astro AST to find img elements or Image component usages with specific src
+ */
+export declare function findImageElement(ast: AstroNode, imageSrc: string, lines: string[]): ImageMatch | null;
+/**
+ * Walk the Astro AST to find img elements near a given source line.
+ * Used as a fallback when the src value can't be matched (expression attributes).
+ * Returns the img element closest to the expected line.
+ */
+export declare function findImageElementNearLine(ast: AstroNode, expectedLine: number, lines: string[]): ImageMatch | null;
+/**
+ * Find source file and line number for an image by its src attribute.
+ * Also checks srcset URLs as fallback when src doesn't match (e.g., when src
+ * is a local upload path but srcset contains CDN-transformed original URLs).
+ * Uses pre-built search index for fast lookups.
+ */
+export declare function findImageSourceLocation(imageSrc: string, imageSrcSet?: string): Promise<SourceLocation | undefined>;
+/**
+ * Recursively search directory for image with matching src
+ */
+export declare function searchDirectoryForImage(dir: string, imageSrc: string): Promise<SourceLocation | undefined>;
+//# sourceMappingURL=image-finder.d.ts.map

package/dist/src/source-finder/image-finder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-finder.d.ts","sourceRoot":"","sources":["../../../src/source-finder/image-finder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAA8B,IAAI,IAAI,SAAS,EAAE,MAAM,yBAAyB,CAAA;AAS5F,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAMzD;;GAEG;AACH,wBAAgB,gBAAgB,CAC/B,GAAG,EAAE,SAAS,EACd,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EAAE,GACb,UAAU,GAAG,IAAI,CAgDnB;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACvC,GAAG,EAAE,SAAS,EACd,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,MAAM,EAAE,GACb,UAAU,GAAG,IAAI,CAwCnB;AAiBD;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAC5C,QAAQ,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CA2CrC;AAMD;;GAEG;AACH,wBAAsB,uBAAuB,CAC5C,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,GACd,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAoBrC"}

package/dist/src/source-finder/index.d.ts

@@ -0,0 +1,9 @@
+export type { CollectionInfo, MarkdownContent, SourceLocation, VariableReference } from './types';
+export { clearSourceFinderCache } from './cache';
+export { initializeSearchIndex } from './search-index';
+export { findSourceLocation } from './source-lookup';
+export { findAttributeSourceLocation } from './cross-file-tracker';
+export { findImageSourceLocation } from './image-finder';
+export { findCollectionSource, findMarkdownSourceLocation, parseMarkdownContent } from './collection-finder';
+export { enhanceManifestWithSourceSnippets, extractCompleteTagSnippet, extractInnerHtmlFromSnippet, extractOpeningTagWithLine, extractSourceSnippet, updateAttributeSources, updateColorClassSources, } from './snippet-utils';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/source-finder/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/source-finder/index.ts"],"names":[],"mappings":"AAOA,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAGjG,OAAO,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAA;AAGhD,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAA;AAGtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAGpD,OAAO,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAA;AAGlE,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAA;AAGxD,OAAO,EAAE,oBAAoB,EAAE,0BAA0B,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA;AAG5G,OAAO,EACN,iCAAiC,EACjC,yBAAyB,EACzB,2BAA2B,EAC3B,yBAAyB,EACzB,oBAAoB,EACpB,sBAAsB,EACtB,uBAAuB,GACvB,MAAM,iBAAiB,CAAA"}

package/dist/src/source-finder/search-index.d.ts

@@ -0,0 +1,27 @@
+import type { CachedParsedFile, SourceLocation } from './types';
+/**
+ * Collect all .astro files in a directory recursively
+ */
+export declare function collectAstroFiles(dir: string): Promise<string[]>;
+/**
+ * Initialize search index by pre-scanning all source files.
+ * This is much faster than searching per-entry.
+ */
+export declare function initializeSearchIndex(): Promise<void>;
+/**
+ * Index all searchable text content from a parsed file
+ */
+export declare function indexFileContent(cached: CachedParsedFile, relFile: string): void;
+/**
+ * Index all images from a parsed file
+ */
+export declare function indexFileImages(cached: CachedParsedFile, relFile: string): void;
+/**
+ * Fast text lookup using pre-built index
+ */
+export declare function findInTextIndex(textContent: string, tag: string): SourceLocation | undefined;
+/**
+ * Fast image lookup using pre-built index
+ */
+export declare function findInImageIndex(imageSrc: string): SourceLocation | undefined;
+//# sourceMappingURL=search-index.d.ts.map

package/dist/src/source-finder/search-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-index.d.ts","sourceRoot":"","sources":["../../../src/source-finder/search-index.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAM/D;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAyBtE;AAMD;;;GAGG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC,CAwC3D;AAmJD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAuFhF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAqE/E;AAMD;;GAEG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAsD5F;AAaD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAgC7E"}

package/dist/src/source-finder/snippet-utils.d.ts

@@ -0,0 +1,90 @@
+import type { Attribute, ManifestEntry } from '../types';
+/**
+ * Normalize text for comparison (handles escaping and entities)
+ */
+export declare function normalizeText(text: string): string;
+/**
+ * Strip markdown syntax for text comparison
+ */
+export declare function stripMarkdownSyntax(text: string): string;
+/**
+ * Extract complete tag snippet including content and indentation.
+ * Exported for use in html-processor to populate sourceSnippet.
+ *
+ * When startLine points to a line inside the element (e.g., the text content line),
+ * this function searches backwards to find the opening tag first.
+ */
+export declare function extractCompleteTagSnippet(lines: string[], startLine: number, tag: string): string;
+/**
+ * Extract just the opening tag from source lines (e.g., `<a href="/foo" class="btn">`)
+ * Handles multi-line opening tags.
+ *
+ * @param lines - Source file lines
+ * @param startLine - 0-indexed line number where element starts
+ * @param tag - The tag name
+ * @returns The opening tag string, or undefined if can't extract
+ */
+export declare function extractOpeningTagSnippet(lines: string[], startLine: number, tag: string): string | undefined;
+/**
+ * Extract the opening tag from source lines along with its starting line number.
+ * Handles multi-line opening tags.
+ *
+ * @param lines - Source file lines
+ * @param startLine - 0-indexed line number where element starts
+ * @param tag - The tag name
+ * @returns Object with the opening tag snippet and 0-indexed startLine, or undefined if can't extract
+ */
+export declare function extractOpeningTagWithLine(lines: string[], startLine: number, tag: string): {
+    snippet: string;
+    startLine: number;
+} | undefined;
+/**
+ * Update attribute source information from an opening tag snippet.
+ * Determines whether each attribute is static (quoted value) or dynamic (expression).
+ * - For static attributes: sourcePath/Line/Snippet point to the template file
+ * - For dynamic attributes: sourcePath/Line/Snippet point to where the VALUE is defined
+ *
+ * @param openingTagSnippet - The opening tag string (e.g., `<a href={url} class="btn">`)
+ * @param attributes - Existing attributes with resolved values (isStatic will be updated)
+ * @param sourceFilePath - The source file path (used for static attrs and as starting point for dynamic attr tracing)
+ * @param openingTagStartLine - 1-indexed line number where the opening tag starts in the source file
+ * @returns Updated attributes with sourcePath, sourceLine, and sourceSnippet
+ */
+export declare function updateAttributeSources(openingTagSnippet: string, attributes: Record<string, Attribute>, sourceFilePath?: string, openingTagStartLine?: number, sourceLines?: string[]): Promise<Record<string, Attribute>>;
+/**
+ * Update colorClasses entries with source info from the class attribute in the opening tag.
+ * All color classes come from the same `class="..."` attribute, so they share the same source location.
+ */
+export declare function updateColorClassSources(openingTagSnippet: string, colorClasses: Record<string, Attribute>, sourceFilePath?: string, openingTagStartLine?: number, sourceLines?: string[]): Record<string, Attribute>;
+/**
+ * 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;
+/**
+ * Extract the full <img> tag snippet from source lines
+ */
+export declare function extractImageSnippet(lines: string[], startLine: number): string;
+/**
+ * Read source file and extract the complete element 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 complete element from source, or undefined if can't extract
+ */
+export declare function extractSourceSnippet(sourceFile: string, sourceLine: number, tag: string): Promise<string | undefined>;
+/**
+ * Enhance manifest entries with actual source snippets from source files.
+ * This reads the source files and extracts the innerHTML at the specified locations.
+ * For images, it finds the correct line containing the src attribute.
+ *
+ * @param entries - Manifest entries to enhance
+ * @returns Enhanced entries with sourceSnippet and openingTagSnippet populated
+ */
+export declare function enhanceManifestWithSourceSnippets(entries: Record<string, ManifestEntry>): Promise<Record<string, ManifestEntry>>;
+//# sourceMappingURL=snippet-utils.d.ts.map

package/dist/src/source-finder/snippet-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snippet-utils.d.ts","sourceRoot":"","sources":["../../../src/source-finder/snippet-utils.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAWxD;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAclD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAYxD;AAMD;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CA0DjG;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG5G;AAED;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CACxC,KAAK,EAAE,MAAM,EAAE,EACf,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,GACT;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CA2CpD;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,sBAAsB,CAC3C,iBAAiB,EAAE,MAAM,EACzB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,EACrC,cAAc,CAAC,EAAE,MAAM,EACvB,mBAAmB,CAAC,EAAE,MAAM,EAC5B,WAAW,CAAC,EAAE,MAAM,EAAE,GACpB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CA8EpC;AAoBD;;;GAGG;AACH,wBAAgB,uBAAuB,CACtC,iBAAiB,EAAE,MAAM,EACzB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,EACvC,cAAc,CAAC,EAAE,MAAM,EACvB,mBAAmB,CAAC,EAAE,MAAM,EAC5B,WAAW,CAAC,EAAE,MAAM,EAAE,GACpB,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAe3B;AAED;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAsB5F;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAuB9E;AAED;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CACzC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,GACT,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAc7B;AAMD;;;;;;;GAOG;AACH,wBAAsB,iCAAiC,CACtD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,GACpC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAoMxC"}

package/dist/src/source-finder/source-lookup.d.ts

@@ -0,0 +1,16 @@
+import type { SourceLocation } from './types';
+/**
+ * Find source file and line number for text content.
+ * Uses pre-built search index for fast lookups.
+ */
+export declare function findSourceLocation(textContent: string, tag: string): Promise<SourceLocation | undefined>;
+/**
+ * Recursively search directory for matching content
+ */
+export declare function searchDirectory(dir: string, textContent: string, tag: string): Promise<SourceLocation | undefined>;
+/**
+ * Search a single Astro file for matching content using AST parsing.
+ * Uses caching for better performance.
+ */
+export declare function searchAstroFile(filePath: string, textContent: string, tag: string): Promise<SourceLocation | undefined>;
+//# sourceMappingURL=source-lookup.d.ts.map

package/dist/src/source-finder/source-lookup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-lookup.d.ts","sourceRoot":"","sources":["../../../src/source-finder/source-lookup.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAM7C;;;GAGG;AACH,wBAAsB,kBAAkB,CACvC,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,MAAM,GACT,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CA2CrC;AAMD;;GAEG;AACH,wBAAsB,eAAe,CACpC,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,MAAM,GACT,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAoBrC;AAMD;;;GAGG;AACH,wBAAsB,eAAe,CACpC,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,MAAM,GACT,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAsFrC"}

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

@@ -0,0 +1,167 @@
+import type { Node as AstroNode } from '@astrojs/compiler/types';
+/** Import information from frontmatter */
+export interface ImportInfo {
+    /** Local name of the imported binding */
+    localName: string;
+    /** Original exported name (or 'default' for default imports) */
+    importedName: string;
+    /** The import source path (e.g., './config', '../data/nav') */
+    source: string;
+}
+export interface VariableDefinition {
+    name: string;
+    value: string;
+    line: number;
+    /** For object properties, the parent variable name */
+    parentName?: string;
+}
+export interface CachedParsedFile {
+    content: string;
+    lines: string[];
+    ast: AstroNode;
+    frontmatterContent: string | null;
+    frontmatterStartLine: number;
+    variableDefinitions: VariableDefinition[];
+    /** Mapping of local variable names to prop names from Astro.props destructuring
+     *  e.g., { navItems: 'items' } for `const { items: navItems } = Astro.props` */
+    propAliases: Map<string, string>;
+    /** Import information from frontmatter */
+    imports: ImportInfo[];
+}
+/** Pre-built search index for fast lookups */
+export interface SearchIndexEntry {
+    file: string;
+    line: number;
+    snippet: string;
+    /** Just the opening tag with attributes (for attribute/class updates) */
+    openingTagSnippet?: string;
+    type: 'static' | 'variable' | 'prop' | 'computed';
+    variableName?: string;
+    definitionLine?: number;
+    normalizedText: string;
+    tag: string;
+}
+export interface ImageIndexEntry {
+    file: string;
+    line: number;
+    snippet: string;
+    src: string;
+}
+export interface SourceLocation {
+    file: string;
+    line: number;
+    snippet?: string;
+    /** Just the opening tag with attributes (for attribute/class updates) */
+    openingTagSnippet?: 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;
+}
+export interface ParsedAstroFile {
+    ast: AstroNode;
+    frontmatterContent: string | null;
+    frontmatterStartLine: number;
+}
+/** Minimal Babel AST node type for our usage */
+export interface BabelNode {
+    type: string;
+    [key: string]: unknown;
+}
+/** Minimal Babel File type */
+export interface BabelFile {
+    type: 'File';
+    program: BabelNode & {
+        body: BabelNode[];
+    };
+}
+export interface TemplateMatch {
+    line: number;
+    type: 'static' | 'variable' | 'computed';
+    variableName?: string;
+    /** For variables, the definition line in frontmatter */
+    definitionLine?: number;
+    /** If true, the expression uses a variable from props that needs cross-file tracking */
+    usesProp?: boolean;
+    /** The prop name if usesProp is true */
+    propName?: string;
+    /** The full expression path if usesProp is true (e.g., 'items[0]') */
+    expressionPath?: string;
+    /** If true, the expression uses a variable from an import */
+    usesImport?: boolean;
+    /** The import info if usesImport is true */
+    importInfo?: ImportInfo;
+}
+/** Result type for findElementWithText - returns best match and all prop/import candidates */
+export interface FindElementResult {
+    /** The best match found (local variables or static content) */
+    bestMatch: TemplateMatch | null;
+    /** All prop-based matches for the tag (need cross-file verification) */
+    propCandidates: TemplateMatch[];
+    /** All import-based matches for the tag (need cross-file verification) */
+    importCandidates: TemplateMatch[];
+}
+export interface ComponentPropMatch {
+    line: number;
+    propName: string;
+    propValue: string;
+}
+export interface ExpressionPropMatch {
+    componentName: string;
+    propName: string;
+    /** The expression text (e.g., 'navItems' from items={navItems}) */
+    expressionText: string;
+    line: number;
+}
+export interface SpreadPropMatch {
+    componentName: string;
+    /** The variable name being spread (e.g., 'cardProps' from {...cardProps}) */
+    spreadVarName: string;
+    line: number;
+}
+export interface ImageMatch {
+    line: number;
+    src: string;
+    snippet: string;
+}
+/**
+ * Transforms Babel line numbers to actual file line numbers.
+ * Babel parses content starting at line 1, but frontmatter content
+ * may start at a different line in the actual file.
+ */
+export type LineTransformer = (babelLine: number) => number;
+/** Identity transformer - use for standalone files where Babel line = file line */
+export declare const identityLine: LineTransformer;
+/** Create a transformer for frontmatter content that starts at a specific line */
+export declare const createFrontmatterLineTransformer: (startLine: number) => LineTransformer;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/source-finder/types.ts"],"names":[],"mappings":"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"}

package/dist/src/source-finder/variable-extraction.d.ts

@@ -0,0 +1,37 @@
+import type { BabelFile, ImportInfo, VariableDefinition } from './types';
+/**
+ * Extract variable definitions from Babel AST
+ * Finds const/let/var declarations with string literal values
+ *
+ * Note: Babel parses the frontmatter content (without --- delimiters) starting at line 1.
+ * frontmatterStartLine is the actual file line where the content begins (after first ---).
+ * So we convert: file_line = (babel_line - 1) + frontmatterStartLine
+ */
+export declare function extractVariableDefinitions(ast: BabelFile, frontmatterStartLine: number): VariableDefinition[];
+/**
+ * Extract prop aliases from Astro.props destructuring patterns.
+ * Returns a Map of local variable name -> prop name.
+ * Examples:
+ *   const { title } = Astro.props         -> Map { 'title' => 'title' }
+ *   const { items: navItems } = Astro.props -> Map { 'navItems' => 'items' }
+ */
+export declare function extractPropAliases(ast: BabelFile): Map<string, string>;
+/**
+ * Extract import information from Babel AST.
+ * Handles:
+ *   import { foo } from './file'           -> { localName: 'foo', importedName: 'foo', source: './file' }
+ *   import { foo as bar } from './file'    -> { localName: 'bar', importedName: 'foo', source: './file' }
+ *   import foo from './file'               -> { localName: 'foo', importedName: 'default', source: './file' }
+ *   import * as foo from './file'          -> { localName: 'foo', importedName: '*', source: './file' }
+ */
+export declare function extractImports(ast: BabelFile): ImportInfo[];
+/**
+ * Resolve an import source path to an absolute file path.
+ * Handles relative paths and tries common extensions.
+ */
+export declare function resolveImportPath(source: string, fromFile: string): Promise<string | null>;
+/**
+ * Parse a TypeScript/JavaScript file and extract exported variable definitions.
+ */
+export declare function getExportedDefinitions(filePath: string): Promise<VariableDefinition[]>;
+//# sourceMappingURL=variable-extraction.d.ts.map

package/dist/src/source-finder/variable-extraction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"variable-extraction.d.ts","sourceRoot":"","sources":["../../../src/source-finder/variable-extraction.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAa,UAAU,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAA;AAOnF;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,GAAG,kBAAkB,EAAE,CAwG7G;AAMD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,SAAS,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAgFtE;AAMD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,SAAS,GAAG,UAAU,EAAE,CA+C3D;AAMD;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAiChG;AAMD;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CA2E5F"}

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

@@ -0,0 +1,54 @@
+import type { Attribute, AvailableColors, AvailableTextStyles } from './types';
+/**
+ * Default Tailwind CSS v4 color names.
+ */
+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 with their values.
+ */
+export declare function parseTailwindConfig(projectRoot?: string): Promise<AvailableColors>;
+/**
+ * Parse Tailwind v4 CSS config to extract available text styles.
+ */
+export declare function parseTextStyles(projectRoot?: string): Promise<AvailableTextStyles>;
+/**
+ * Extract color classes from an element's class attribute.
+ * Returns a flat Record<string, Attribute> with keys like bg, text, gradientFrom, bgOpacity, etc.
+ */
+export declare function extractColorClasses(classAttr: string | null | undefined): Record<string, Attribute> | undefined;
+/**
+ * Check if a class is a color class (including gradient colors).
+ */
+export declare function isColorClass(className: string): boolean;
+/**
+ * Generate a new class string with a color class replaced.
+ */
+export declare function replaceColorClass(currentClasses: string, oldColorClass: string, newColorClass: string): string;
+/**
+ * Get the color type from a color class.
+ * Returns the flat key name (e.g., 'bg', 'gradientFrom', 'bgOpacity').
+ */
+export declare function getColorType(colorClass: string): string | undefined;
+/**
+ * Parse a color class into its components.
+ */
+export declare function parseColorClass(colorClass: string): {
+    prefix: string;
+    colorName: string;
+    shade?: string;
+    isHover: boolean;
+    isArbitrary?: 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/src/tailwind-colors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tailwind-colors.d.ts","sourceRoot":"","sources":["../../src/tailwind-colors.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,mBAAmB,EAAiC,MAAM,SAAS,CAAA;AAE7G;;GAEG;AACH,eAAO,MAAM,uBAAuB,gNAuB1B,CAAA;AAEV;;GAEG;AACH,eAAO,MAAM,eAAe,uFAAwF,CAAA;AAEpH;;GAEG;AACH,eAAO,MAAM,cAAc,kEAAmE,CAAA;AAsa9F;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,WAAW,GAAE,MAAyB,GAAG,OAAO,CAAC,eAAe,CAAC,CA+C1G;AAuDD;;GAEG;AACH,wBAAsB,eAAe,CAAC,WAAW,GAAE,MAAyB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAoC1G;AAoHD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,SAAS,CAiD/G;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAGvD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAChC,cAAc,EAAE,MAAM,EACtB,aAAa,EAAE,MAAM,EACrB,aAAa,EAAE,MAAM,GACnB,MAAM,CAIR;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAiBnE;AAED;;GAEG;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;IAChB,WAAW,CAAC,EAAE,OAAO,CAAA;CACrB,GAAG,SAAS,CA4BZ;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC9B,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,KAAK,CAAC,EAAE,MAAM,GACZ,MAAM,CAKR"}