valtech-components 2.0.691 → 2.0.692

package/src/lib/services/content/index.ts

@@ -1,71 +0,0 @@
-/**
- * Content Types Module
- *
- * Provides a flexible content abstraction layer that transforms
- * structured content documents into ArticleMetadata for rendering
- * with the val-article component.
- *
- * @example
- * ```typescript
- * // Using BlogPostBuilder
- * import { blogPost } from 'valtech-components';
- *
- * const post = blogPost()
- *   .title('My First Post')
- *   .author('John Doe')
- *   .heading('Introduction')
- *   .paragraph('Welcome to my blog...')
- *   .toArticle();
- *
- * // Using DocsBuilder
- * import { docs } from 'valtech-components';
- *
- * const page = docs()
- *   .title('Installation')
- *   .section('Getting Started')
- *   .code('npm install valtech-components', 'bash')
- *   .toArticle();
- *
- * // Using NewsBuilder
- * import { news } from 'valtech-components';
- *
- * const article = news()
- *   .headline('Breaking News')
- *   .summary('Important announcement...')
- *   .breaking()
- *   .toArticle();
- *
- * // From JSON/API response
- * import { ContentTransformer, BlogPost } from 'valtech-components';
- *
- * const json: BlogPost = await fetch('/api/posts/1').then(r => r.json());
- * const article = ContentTransformer.toArticle(json);
- * ```
- */
-
-// Base types
-export {
-  ContentAuthor,
-  ContentMeta,
-  ContentConfig,
-  ContentDocument,
-  ContentBlock,
-  HeadingBlock,
-  ParagraphBlock,
-  QuoteBlock,
-  CodeBlock,
-  ListBlock,
-  ImageBlock,
-  CalloutBlock,
-  DividerBlock,
-  ButtonBlock,
-  CommandBlock,
-} from './types';
-
-// Transformer
-export { ContentTransformer, toArticle } from './transformer';
-
-// Content types
-export { BlogPost, BlogPostBuilder, blogPost } from './content-types/blog';
-export { Documentation, DocNavLink, DocsBuilder, docs } from './content-types/documentation';
-export { NewsArticle, NewsBuilder, news } from './content-types/news';

package/src/lib/services/content/transformer.ts

@@ -1,312 +0,0 @@
-/**
- * Content Transformer
- *
- * Transforms ContentDocument instances into ArticleMetadata
- * for rendering with the val-article component.
- */
-
-import { Color } from '@ionic/core';
-import { ArticleBuilder, ArticleMetadata } from '../../components/organisms/article/types';
-import { ComponentStates } from '../../components/types';
-import {
-  ContentDocument,
-  ContentBlock,
-  ContentMeta,
-  ContentAuthor,
-  HeadingBlock,
-  ParagraphBlock,
-  QuoteBlock,
-  CodeBlock,
-  ListBlock,
-  ImageBlock,
-  CalloutBlock,
-  DividerBlock,
-  ButtonBlock,
-  CommandBlock,
-} from './types';
-
-/**
- * Maps callout variants to Ionic colors
- */
-const CALLOUT_COLOR_MAP: Record<string, Color> = {
-  info: 'primary',
-  warning: 'warning',
-  success: 'success',
-  error: 'danger',
-};
-
-/**
- * Maps callout variants to prefix text
- */
-const CALLOUT_PREFIX_MAP: Record<string, string> = {
-  info: 'Info:',
-  warning: 'Aviso:',
-  success: 'Listo:',
-  error: 'Error:',
-};
-
-/**
- * ContentTransformer converts ContentDocument objects into ArticleMetadata
- * that can be rendered by the val-article component.
- *
- * @example
- * ```typescript
- * const doc: BlogPost = { ... };
- * const article = ContentTransformer.toArticle(doc);
- * // Use article with <val-article [props]="article">
- * ```
- */
-export class ContentTransformer {
-  /**
-   * Transforms a ContentDocument into ArticleMetadata
-   *
-   * @param doc - The content document to transform
-   * @returns ArticleMetadata ready for val-article component
-   */
-  static toArticle(doc: ContentDocument): ArticleMetadata {
-    const builder = new ArticleBuilder();
-
-    // Add header based on document type and meta
-    this.addHeader(builder, doc);
-
-    // Transform each content block
-    for (const block of doc.content) {
-      this.addBlock(builder, block);
-    }
-
-    // Add footer based on document type
-    this.addFooter(builder, doc);
-
-    return builder.build({
-      theme: doc.config?.theme ?? 'auto',
-      maxWidth: doc.config?.maxWidth ?? '800px',
-      centered: doc.config?.centered ?? true,
-    });
-  }
-
-  /**
-   * Adds header elements based on document type and metadata
-   */
-  private static addHeader(builder: ArticleBuilder, doc: ContentDocument): void {
-    // Add author/date info if showMeta is enabled
-    if (doc.config?.showMeta && doc.meta.author) {
-      this.addAuthorBlock(builder, doc.meta.author, doc.meta.publishedAt);
-      builder.separator('space', { spacing: { top: 'small', bottom: 'medium' } });
-    }
-  }
-
-  /**
-   * Adds footer elements based on document type
-   */
-  private static addFooter(builder: ArticleBuilder, doc: ContentDocument): void {
-    // Add tags if present
-    if (doc.meta.tags && doc.meta.tags.length > 0) {
-      builder.separator('line', { spacing: { top: 'large', bottom: 'medium' } });
-      builder.paragraph({
-        content: `Tags: ${doc.meta.tags.join(', ')}`,
-        size: 'small',
-        color: 'medium',
-        bold: false,
-      });
-    }
-  }
-
-  /**
-   * Adds author information block
-   */
-  private static addAuthorBlock(
-    builder: ArticleBuilder,
-    author: ContentAuthor,
-    publishedAt?: Date | string
-  ): void {
-    let authorText = author.name;
-    if (author.role) {
-      authorText += ` - ${author.role}`;
-    }
-    if (publishedAt) {
-      const date = typeof publishedAt === 'string' ? new Date(publishedAt) : publishedAt;
-      authorText += ` | ${date.toLocaleDateString()}`;
-    }
-
-    builder.paragraph({
-      content: authorText,
-      size: 'small',
-      color: 'medium',
-      bold: false,
-    });
-  }
-
-  /**
-   * Transforms a single content block and adds it to the builder
-   */
-  private static addBlock(builder: ArticleBuilder, block: ContentBlock): void {
-    switch (block.type) {
-      case 'heading':
-        this.addHeading(builder, block);
-        break;
-      case 'paragraph':
-        this.addParagraph(builder, block);
-        break;
-      case 'quote':
-        this.addQuote(builder, block);
-        break;
-      case 'code':
-        this.addCode(builder, block);
-        break;
-      case 'list':
-        this.addList(builder, block);
-        break;
-      case 'image':
-        this.addImage(builder, block);
-        break;
-      case 'callout':
-        this.addCallout(builder, block);
-        break;
-      case 'divider':
-        this.addDivider(builder, block);
-        break;
-      case 'button':
-        this.addButton(builder, block);
-        break;
-      case 'command':
-        this.addCommand(builder, block);
-        break;
-    }
-  }
-
-  /**
-   * Adds a heading block
-   */
-  private static addHeading(builder: ArticleBuilder, block: HeadingBlock): void {
-    if (block.level === 1) {
-      builder.title({
-        content: block.text,
-        size: 'large',
-        color: 'dark',
-        bold: true,
-      });
-    } else {
-      builder.subtitle({
-        content: block.text,
-        size: block.level === 2 ? 'medium' : 'small',
-        color: 'dark',
-        bold: true,
-      });
-    }
-  }
-
-  /**
-   * Adds a paragraph block
-   */
-  private static addParagraph(builder: ArticleBuilder, block: ParagraphBlock): void {
-    builder.paragraph({
-      content: block.text,
-      size: 'medium',
-      color: 'dark',
-      bold: block.emphasis ?? false,
-    });
-  }
-
-  /**
-   * Adds a quote block
-   */
-  private static addQuote(builder: ArticleBuilder, block: QuoteBlock): void {
-    builder.quote({
-      content: block.text,
-      size: 'medium',
-      color: 'dark',
-      bold: false,
-      author: block.author,
-      source: block.source,
-    });
-  }
-
-  /**
-   * Adds a code block
-   */
-  private static addCode(builder: ArticleBuilder, block: CodeBlock): void {
-    builder.code(block.code, block.language);
-  }
-
-  /**
-   * Adds a list block
-   */
-  private static addList(builder: ArticleBuilder, block: ListBlock): void {
-    const items = block.items.map((text) => ({ text }));
-    const listType = block.checklist ? 'checklist' : block.ordered ? 'ordered' : 'unordered';
-    builder.list(items, listType);
-  }
-
-  /**
-   * Adds an image block
-   */
-  private static addImage(builder: ArticleBuilder, block: ImageBlock): void {
-    builder.image(block.src, block.alt, block.caption, {
-      // Note: alignment is handled differently in ArticleBuilder
-    });
-  }
-
-  /**
-   * Adds a callout/note block
-   */
-  private static addCallout(builder: ArticleBuilder, block: CalloutBlock): void {
-    const color = CALLOUT_COLOR_MAP[block.variant] ?? 'primary';
-    const prefix = block.title ?? CALLOUT_PREFIX_MAP[block.variant] ?? 'Nota:';
-    builder.note(block.text, prefix, color);
-  }
-
-  /**
-   * Adds a divider/separator block
-   */
-  private static addDivider(builder: ArticleBuilder, block: DividerBlock): void {
-    builder.separator(block.style ?? 'line');
-  }
-
-  /**
-   * Adds a button block
-   */
-  private static addButton(builder: ArticleBuilder, block: ButtonBlock): void {
-    const colorMap: Record<string, Color> = {
-      primary: 'primary',
-      secondary: 'secondary',
-      success: 'success',
-      warning: 'warning',
-      danger: 'danger',
-    };
-
-    builder.button(
-      {
-        text: block.text,
-        color: colorMap[block.color ?? 'primary'] ?? 'primary',
-        fill: 'solid',
-        type: 'button',
-        state: ComponentStates.ENABLED,
-        href: block.href,
-        token: block.action,
-      },
-      block.alignment ?? 'center'
-    );
-  }
-
-  /**
-   * Adds a command/terminal block
-   */
-  private static addCommand(builder: ArticleBuilder, block: CommandBlock): void {
-    builder.command(block.command);
-  }
-}
-
-/**
- * Convenience function to transform a ContentDocument to ArticleMetadata
- *
- * @param doc - The content document to transform
- * @returns ArticleMetadata ready for val-article component
- *
- * @example
- * ```typescript
- * const article = toArticle(myBlogPost);
- * ```
- */
-export function toArticle(doc: ContentDocument): ArticleMetadata {
-  return ContentTransformer.toArticle(doc);
-}

package/src/lib/services/content/types.ts

@@ -1,276 +0,0 @@
-/**
- * Content Types System
- *
- * This module provides a content abstraction layer that transforms
- * structured content documents (blog posts, documentation, news articles)
- * into ArticleMetadata for rendering with val-article component.
- */
-
-// =============================================================================
-// AUTHOR & META
-// =============================================================================
-
-/**
- * Author information for content documents
- */
-export interface ContentAuthor {
-  /** Author's display name */
-  name: string;
-  /** URL to author's avatar image */
-  avatar?: string;
-  /** Author's role or title */
-  role?: string;
-  /** Link to author's profile */
-  profileUrl?: string;
-}
-
-/**
- * Common metadata for all content documents
- */
-export interface ContentMeta {
-  /** Unique identifier */
-  id?: string;
-  /** URL-friendly slug */
-  slug?: string;
-  /** Creation date */
-  createdAt?: Date | string;
-  /** Last update date */
-  updatedAt?: Date | string;
-  /** Publication date */
-  publishedAt?: Date | string;
-  /** Content author */
-  author?: ContentAuthor;
-  /** Tags for categorization */
-  tags?: string[];
-  /** Primary category */
-  category?: string;
-  /** Content locale (e.g., 'es', 'en') */
-  locale?: string;
-}
-
-// =============================================================================
-// CONTENT BLOCKS
-// =============================================================================
-
-/**
- * Heading block - renders as title or subtitle
- */
-export interface HeadingBlock {
-  type: 'heading';
-  /** Heading level: 1 = title, 2-3 = subtitle */
-  level: 1 | 2 | 3;
-  /** Heading text */
-  text: string;
-}
-
-/**
- * Paragraph block - renders as text
- */
-export interface ParagraphBlock {
-  type: 'paragraph';
-  /** Paragraph text content */
-  text: string;
-  /** Apply emphasis styling */
-  emphasis?: boolean;
-}
-
-/**
- * Quote block - renders as blockquote
- */
-export interface QuoteBlock {
-  type: 'quote';
-  /** Quote text */
-  text: string;
-  /** Quote author name */
-  author?: string;
-  /** Quote source */
-  source?: string;
-}
-
-/**
- * Code block - renders as syntax-highlighted code
- */
-export interface CodeBlock {
-  type: 'code';
-  /** Code content */
-  code: string;
-  /** Programming language for syntax highlighting */
-  language?: string;
-  /** Code block title/filename */
-  title?: string;
-}
-
-/**
- * List block - renders as ordered, unordered, or checklist
- */
-export interface ListBlock {
-  type: 'list';
-  /** List items (simple strings) */
-  items: string[];
-  /** Render as numbered list */
-  ordered?: boolean;
-  /** Render as checklist with checkmarks */
-  checklist?: boolean;
-}
-
-/**
- * Image block - renders as image with optional caption
- */
-export interface ImageBlock {
-  type: 'image';
-  /** Image source URL */
-  src: string;
-  /** Alt text for accessibility */
-  alt: string;
-  /** Image caption */
-  caption?: string;
-  /** Image alignment */
-  alignment?: 'left' | 'center' | 'right';
-}
-
-/**
- * Callout block - renders as highlighted note/warning
- */
-export interface CalloutBlock {
-  type: 'callout';
-  /** Callout text content */
-  text: string;
-  /** Callout variant determines styling */
-  variant: 'info' | 'warning' | 'success' | 'error';
-  /** Optional title/prefix */
-  title?: string;
-}
-
-/**
- * Divider block - renders as separator line
- */
-export interface DividerBlock {
-  type: 'divider';
-  /** Divider style */
-  style?: 'line' | 'dots' | 'space';
-}
-
-/**
- * Button block - renders as call-to-action button
- */
-export interface ButtonBlock {
-  type: 'button';
-  /** Button text */
-  text: string;
-  /** Link URL (for navigation) */
-  href?: string;
-  /** Action identifier (for event handling) */
-  action?: string;
-  /** Button color */
-  color?: 'primary' | 'secondary' | 'success' | 'warning' | 'danger';
-  /** Button alignment */
-  alignment?: 'left' | 'center' | 'right';
-}
-
-/**
- * Command block - renders as terminal/CLI command
- */
-export interface CommandBlock {
-  type: 'command';
-  /** Command to display */
-  command: string;
-  /** Show copy button */
-  copyable?: boolean;
-}
-
-/**
- * Union type of all content blocks
- */
-export type ContentBlock =
-  | HeadingBlock
-  | ParagraphBlock
-  | QuoteBlock
-  | CodeBlock
-  | ListBlock
-  | ImageBlock
-  | CalloutBlock
-  | DividerBlock
-  | ButtonBlock
-  | CommandBlock;
-
-// =============================================================================
-// CONTENT DOCUMENT
-// =============================================================================
-
-/**
- * Configuration options for content rendering
- */
-export interface ContentConfig {
-  /** Article theme */
-  theme?: 'light' | 'dark' | 'auto';
-  /** Maximum width of the content container */
-  maxWidth?: string;
-  /** Show metadata (author, date, etc.) */
-  showMeta?: boolean;
-  /** Show table of contents */
-  showTableOfContents?: boolean;
-  /** Center the content container */
-  centered?: boolean;
-}
-
-/**
- * Base interface for all content documents.
- * Generic type T represents the document type discriminator.
- *
- * @example
- * ```typescript
- * interface BlogPost extends ContentDocument<'blog'> {
- *   title: string;
- *   excerpt: string;
- * }
- * ```
- */
-export interface ContentDocument<T extends string = string> {
-  /** Document type discriminator */
-  type: T;
-  /** Document metadata */
-  meta: ContentMeta;
-  /** Array of content blocks */
-  content: ContentBlock[];
-  /** Rendering configuration */
-  config?: ContentConfig;
-}
-
-// =============================================================================
-// TYPE GUARDS
-// =============================================================================
-
-/**
- * Type guard to check if a block is a heading
- */
-export function isHeadingBlock(block: ContentBlock): block is HeadingBlock {
-  return block.type === 'heading';
-}
-
-/**
- * Type guard to check if a block is a paragraph
- */
-export function isParagraphBlock(block: ContentBlock): block is ParagraphBlock {
-  return block.type === 'paragraph';
-}
-
-/**
- * Type guard to check if a block is a code block
- */
-export function isCodeBlock(block: ContentBlock): block is CodeBlock {
-  return block.type === 'code';
-}
-
-/**
- * Type guard to check if a block is a list
- */
-export function isListBlock(block: ContentBlock): block is ListBlock {
-  return block.type === 'list';
-}
-
-/**
- * Type guard to check if a block is a callout
- */
-export function isCalloutBlock(block: ContentBlock): block is CalloutBlock {
-  return block.type === 'callout';
-}