@nuasite/cms 0.1.0

package/dist/src/types.d.ts

@@ -0,0 +1,367 @@
+/** SEO tracking options */
+export interface SeoOptions {
+    /** Whether to track SEO elements (default: true) */
+    trackSeo?: boolean;
+    /** Whether to mark the page title with a CMS ID (default: true) */
+    markTitle?: boolean;
+    /** Whether to parse JSON-LD structured data (default: true) */
+    parseJsonLd?: boolean;
+}
+export interface CmsMarkerOptions {
+    attributeName?: string;
+    includeTags?: string[] | null;
+    excludeTags?: string[];
+    includeEmptyText?: boolean;
+    generateManifest?: boolean;
+    manifestFile?: string;
+    markComponents?: boolean;
+    componentDirs?: string[];
+    /** Directory containing content collections (default: 'src/content') */
+    contentDir?: string;
+    /** SEO tracking options */
+    seo?: SeoOptions;
+}
+export interface ComponentProp {
+    name: string;
+    type: string;
+    required: boolean;
+    defaultValue?: string;
+    description?: string;
+}
+export interface ComponentDefinition {
+    name: string;
+    file: string;
+    props: ComponentProp[];
+    description?: string;
+    slots?: string[];
+    previewUrl?: string;
+    /** Viewport width (in px) used to render the preview iframe (default: 1280) */
+    previewWidth?: number;
+}
+/** Image metadata for better tracking and integrity */
+export interface ImageMetadata {
+    /** Image source URL */
+    src: string;
+    /** Alt text */
+    alt: string;
+    /** SHA256 hash of image content (for integrity checking) */
+    hash?: string;
+    /** Image dimensions */
+    dimensions?: {
+        width: number;
+        height: number;
+    };
+    /** Responsive image srcset */
+    srcSet?: string;
+    /** Image sizes attribute */
+    sizes?: string;
+}
+/** Content constraints for validation */
+export interface ContentConstraints {
+    /** Maximum content length */
+    maxLength?: number;
+    /** Minimum content length */
+    minLength?: number;
+    /** Regex pattern for validation */
+    pattern?: string;
+    /** Allowed HTML tags for rich text content */
+    allowedTags?: string[];
+}
+/** Represents a single Tailwind color with its shades and values */
+export interface TailwindColor {
+    /** Color name (e.g., 'red', 'blue', 'primary') */
+    name: string;
+    /** Map of shade to CSS color value (e.g., { '500': '#ef4444', '600': '#dc2626' }) */
+    values: Record<string, string>;
+    /** Whether this is a custom/theme color vs default Tailwind */
+    isCustom?: boolean;
+}
+/** Attribute with source information for git diff tracking */
+export interface Attribute {
+    /** The resolved attribute value (from rendered HTML) */
+    value: string;
+    /** The expression text if dynamic (e.g., "component.githubUrl") */
+    sourceExpression?: string;
+    /** Path to the source file where the value is defined */
+    sourcePath?: string;
+    /** Line number where the value is defined in source (1-indexed) */
+    sourceLine?: number;
+    /** The exact source snippet that can be replaced for git diff */
+    sourceSnippet?: string;
+}
+/** Available colors palette from Tailwind config */
+export interface AvailableColors {
+    /** All available colors with their shades */
+    colors: TailwindColor[];
+    /** Default Tailwind color names */
+    defaultColors: string[];
+    /** Custom/theme color names */
+    customColors: string[];
+}
+/** Text style value with class name and CSS properties */
+export interface TextStyleValue {
+    /** Tailwind class name (e.g., 'font-bold', 'text-xl') */
+    class: string;
+    /** Display label for UI */
+    label: string;
+    /** CSS properties to apply (e.g., { fontWeight: '700' }) */
+    css: Record<string, string>;
+}
+/** Available text styles from Tailwind config */
+export interface AvailableTextStyles {
+    /** Font weight options (font-normal, font-bold, etc.) */
+    fontWeight: TextStyleValue[];
+    /** Font size options (text-xs, text-sm, text-base, etc.) */
+    fontSize: TextStyleValue[];
+    /** Text decoration options (underline, line-through, etc.) */
+    textDecoration: TextStyleValue[];
+    /** Font style options (italic, not-italic) */
+    fontStyle: TextStyleValue[];
+}
+export interface ManifestEntry {
+    id: string;
+    tag: string;
+    /** Plain text content (for display/search) */
+    text: string;
+    /** HTML content when element contains inline styling (strong, em, etc.) */
+    html?: string;
+    sourcePath?: string;
+    sourceLine?: number;
+    /** Full element snippet from opening to closing tag (for text content updates) */
+    sourceSnippet?: string;
+    variableName?: string;
+    childCmsIds?: string[];
+    parentComponentId?: string;
+    /** Collection name for collection entries (e.g., 'services', 'blog') */
+    collectionName?: string;
+    /** Entry slug for collection entries (e.g., '3d-tisk') */
+    collectionSlug?: string;
+    /** Path to the markdown content file (e.g., 'src/content/blog/my-post.md') */
+    contentPath?: string;
+    /** Stable ID derived from content + context hash, survives rebuilds */
+    stableId?: string;
+    /** SHA256 hash of sourceSnippet at generation time for conflict detection */
+    sourceHash?: string;
+    /** Image metadata for img elements (replaces imageSrc/imageAlt) */
+    imageMetadata?: ImageMetadata;
+    /** Content validation constraints */
+    constraints?: ContentConstraints;
+    /** Color classes applied to this element (for buttons, etc.) */
+    colorClasses?: Record<string, Attribute>;
+    /** All HTML attributes with source information */
+    attributes?: Record<string, Attribute>;
+}
+export interface ComponentInstance {
+    id: string;
+    componentName: string;
+    file: string;
+    sourcePath: string;
+    sourceLine: number;
+    props: Record<string, any>;
+    slots?: Record<string, string>;
+    parentId?: string;
+    /** File where this component is invoked (parent page/layout) */
+    invocationSourcePath?: string;
+    /** 0-based index among same-name component invocations in the parent file */
+    invocationIndex?: number;
+}
+/** Represents a content collection entry (markdown file) */
+export interface CollectionEntry {
+    /** Collection name (e.g., 'services', 'blog') */
+    collectionName: string;
+    /** Entry slug (e.g., '3d-tisk') */
+    collectionSlug: string;
+    /** Path to the markdown file relative to project root */
+    sourcePath: string;
+    /** Frontmatter fields with their values and line numbers */
+    frontmatter: Record<string, {
+        value: string;
+        line: number;
+    }>;
+    /** Full markdown body content */
+    body: string;
+    /** Line number where body starts (1-indexed) */
+    bodyStartLine: number;
+    /** ID of the wrapper element containing the rendered markdown */
+    wrapperId?: string;
+}
+/** Field types for collection schema inference */
+export type FieldType = 'text' | 'textarea' | 'date' | 'boolean' | 'number' | 'image' | 'url' | 'select' | 'array' | 'object' | 'reference';
+/** Definition of a single field in a collection's schema */
+export interface FieldDefinition {
+    /** Field name as it appears in frontmatter */
+    name: string;
+    /** Inferred or specified field type */
+    type: FieldType;
+    /** Whether the field is required (present in all entries) */
+    required: boolean;
+    /** Default value for the field */
+    defaultValue?: unknown;
+    /** Options for 'select' type fields */
+    options?: string[];
+    /** Item type for 'array' fields */
+    itemType?: FieldType;
+    /** Nested fields for 'object' type */
+    fields?: FieldDefinition[];
+    /** Sample values seen across entries */
+    examples?: unknown[];
+}
+/** Per-entry metadata for collection browsing */
+export interface CollectionEntryInfo {
+    slug: string;
+    title?: string;
+    sourcePath: string;
+    draft?: boolean;
+    /** URL pathname of the rendered page for this entry */
+    pathname?: string;
+}
+/** Definition of a content collection with inferred schema */
+export interface CollectionDefinition {
+    /** Collection identifier (directory name) */
+    name: string;
+    /** Human-readable label for the collection */
+    label: string;
+    /** Path to the collection directory */
+    path: string;
+    /** Number of entries in the collection */
+    entryCount: number;
+    /** Inferred field definitions */
+    fields: FieldDefinition[];
+    /** Whether the collection has draft support */
+    supportsDraft?: boolean;
+    /** File extension used by entries */
+    fileExtension: 'md' | 'mdx';
+    /** Per-entry metadata for browsing */
+    entries?: CollectionEntryInfo[];
+}
+/** Manifest metadata for versioning and conflict detection */
+export interface ManifestMetadata {
+    /** Manifest schema version */
+    version: string;
+    /** ISO timestamp when manifest was generated */
+    generatedAt: string;
+    /** Build system that generated the manifest (e.g., 'astro', 'vite') */
+    generatedBy?: string;
+    /** Build ID for correlation */
+    buildId?: string;
+    /** SHA256 hash of all entry content for quick drift detection */
+    contentHash?: string;
+    /** Per-source-file hashes for granular conflict detection */
+    sourceFileHashes?: Record<string, string>;
+}
+/** Page entry for the global manifest */
+export interface PageEntry {
+    /** Page URL pathname (e.g., '/', '/about') */
+    pathname: string;
+    /** Page title from SEO data */
+    title?: string;
+}
+export interface CmsManifest {
+    /** Manifest metadata for versioning and conflict detection */
+    metadata?: ManifestMetadata;
+    entries: Record<string, ManifestEntry>;
+    components: Record<string, ComponentInstance>;
+    componentDefinitions: Record<string, ComponentDefinition>;
+    /** Content collection entries indexed by "collectionName/slug" */
+    collections?: Record<string, CollectionEntry>;
+    /** Collection definitions with inferred schemas */
+    collectionDefinitions?: Record<string, CollectionDefinition>;
+    /** Available Tailwind colors from the project's config */
+    availableColors?: AvailableColors;
+    /** Available text styles from the project's Tailwind config */
+    availableTextStyles?: AvailableTextStyles;
+    /** All pages in the site with pathname and title */
+    pages?: PageEntry[];
+}
+/** Source tracking information for SEO elements */
+export interface SeoSourceInfo {
+    /** CMS ID if element was marked for editing */
+    id?: string;
+    /** Path to source file */
+    sourcePath: string;
+    /** Line number in source file (1-indexed) */
+    sourceLine: number;
+    /** Exact source code snippet for matching/replacement */
+    sourceSnippet: string;
+}
+/** SEO meta tag with source tracking */
+export interface SeoMetaTag extends SeoSourceInfo {
+    /** Meta tag name attribute (for name-based meta tags) */
+    name?: string;
+    /** Meta tag property attribute (for Open Graph/Twitter tags) */
+    property?: string;
+    /** Meta tag content value */
+    content: string;
+}
+/** Open Graph metadata */
+export interface OpenGraphData {
+    title?: SeoMetaTag;
+    description?: SeoMetaTag;
+    image?: SeoMetaTag;
+    url?: SeoMetaTag;
+    type?: SeoMetaTag;
+    siteName?: SeoMetaTag;
+}
+/** Twitter Card metadata */
+export interface TwitterCardData {
+    card?: SeoMetaTag;
+    title?: SeoMetaTag;
+    description?: SeoMetaTag;
+    image?: SeoMetaTag;
+    site?: SeoMetaTag;
+}
+/** JSON-LD structured data entry */
+export interface JsonLdEntry extends SeoSourceInfo {
+    /** Schema.org @type value */
+    type: string;
+    /** Parsed JSON-LD data */
+    data: Record<string, unknown>;
+}
+/** Canonical URL link element */
+export interface CanonicalUrl extends SeoSourceInfo {
+    /** The canonical URL href value */
+    href: string;
+}
+/** Favicon link element */
+export interface SeoFavicon extends SeoSourceInfo {
+    /** The favicon href value */
+    href: string;
+    /** The type attribute (e.g. "image/png", "image/svg+xml") */
+    type?: string;
+    /** The sizes attribute (e.g. "32x32", "16x16") */
+    sizes?: string;
+    /** The rel value (e.g. "icon", "apple-touch-icon") */
+    rel: string;
+}
+/** Page title element with optional CMS ID */
+export interface SeoTitle extends SeoSourceInfo {
+    /** Title text content */
+    content: string;
+}
+/** Meta keywords with parsed array */
+export interface SeoKeywords extends SeoSourceInfo {
+    /** Raw keywords string */
+    content: string;
+    /** Parsed array of individual keywords */
+    keywords: string[];
+}
+/** Complete SEO data for a page */
+export interface PageSeoData {
+    /** Page title */
+    title?: SeoTitle;
+    /** Meta description */
+    description?: SeoMetaTag;
+    /** Meta keywords */
+    keywords?: SeoKeywords;
+    /** Canonical URL */
+    canonical?: CanonicalUrl;
+    /** Favicons */
+    favicons?: SeoFavicon[];
+    /** Open Graph metadata */
+    openGraph?: OpenGraphData;
+    /** Twitter Card metadata */
+    twitterCard?: TwitterCardData;
+    /** JSON-LD structured data blocks */
+    jsonLd?: JsonLdEntry[];
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/src/utils.d.ts

@@ -0,0 +1,61 @@
+import type { ManifestEntry } from './types';
+/**
+ * Normalize a page path by removing query strings, hashes, and trailing slashes.
+ * Handles both full URLs and plain pathnames.
+ * Examples: '/about/' -> '/about', 'http://localhost/about?x=1' -> '/about'
+ */
+export declare function normalizePagePath(url: string): string;
+/**
+ * Generate a SHA256 hash of the given content
+ */
+export declare function sha256(content: string): string;
+/**
+ * Generate a short hash (first 12 characters of SHA256)
+ * Used for stableId to keep it reasonably short but still unique
+ */
+export declare function shortHash(content: string): string;
+/**
+ * Generate a stable ID for an element based on its content and context.
+ * This ID survives rebuilds as long as the content and structure remain similar.
+ *
+ * Components:
+ * - tag name
+ * - first 50 chars of text content
+ * - source path (if available)
+ */
+export declare function generateStableId(tag: string, text: string, sourcePath?: string): string;
+/**
+ * Generate a hash of the source snippet for conflict detection.
+ * If the source file changes, this hash will differ from what's stored in manifest.
+ */
+export declare function generateSourceHash(sourceSnippet: string): string;
+/**
+ * Generate a content hash for the entire manifest (all entries).
+ * Used for quick drift detection without comparing individual entries.
+ */
+export declare function generateManifestContentHash(entries: Record<string, ManifestEntry>): string;
+/**
+ * Generate per-source-file hashes for granular conflict detection.
+ * Maps source file path -> hash of all entries from that file.
+ */
+export declare function generateSourceFileHashes(entries: Record<string, ManifestEntry>): Record<string, string>;
+/**
+ * Escape special regex characters in a string for use in `new RegExp()`.
+ */
+export declare function escapeRegex(str: string): string;
+/**
+ * Escape a string for safe use as a replacement in `String.prototype.replace()`.
+ * Prevents `$1`, `$$`, `$&` etc. from being interpreted as backreferences.
+ */
+export declare function escapeReplacement(str: string): string;
+/**
+ * Resolve a user-provided file path and ensure it stays within the project root.
+ * Throws if the resolved path escapes the project boundary.
+ */
+export declare function resolveAndValidatePath(filePath: string): string;
+/**
+ * Acquire a per-file lock for safe read-modify-write operations.
+ * Returns a release function to call when done.
+ */
+export declare function acquireFileLock(filePath: string): Promise<() => void>;
+//# sourceMappingURL=utils.d.ts.map

package/dist/src/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/utils.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAE5C;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAYrD;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC/B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,MAAM,GACjB,MAAM,CAQR;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,MAAM,CAU1F;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAwBvG;AAMD;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAErD;AAMD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAY/D;AAQD;;;GAGG;AACH,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,CAkB3E"}

package/dist/src/vite-plugin.d.ts

@@ -0,0 +1,14 @@
+import type { Plugin } from 'vite';
+import type { ManifestWriter } from './manifest-writer';
+import type { CmsMarkerOptions, ComponentDefinition } from './types';
+export interface VitePluginContext {
+    manifestWriter: ManifestWriter;
+    componentDefinitions: Record<string, ComponentDefinition>;
+    config: Required<CmsMarkerOptions>;
+    idCounter: {
+        value: number;
+    };
+    command: 'dev' | 'build' | 'preview' | 'sync';
+}
+export declare function createVitePlugin(context: VitePluginContext): Plugin[];
+//# sourceMappingURL=vite-plugin.d.ts.map

package/dist/src/vite-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite-plugin.d.ts","sourceRoot":"","sources":["../../src/vite-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAA;AAClC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAA;AAEpE,MAAM,WAAW,iBAAiB;IACjC,cAAc,EAAE,cAAc,CAAA;IAC9B,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAA;IACzD,MAAM,EAAE,QAAQ,CAAC,gBAAgB,CAAC,CAAA;IAClC,SAAS,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;IAC5B,OAAO,EAAE,KAAK,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAA;CAC7C;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,EAAE,CA6BrE"}