@hua-labs/hua-ux 0.1.0-alpha.0.1

package/dist/framework/plugins/registry.js

@@ -0,0 +1,160 @@
+/**
+ * @hua-labs/hua-ux/framework - Plugin Registry
+ *
+ * 플러그인 등록 및 관리 시스템
+ */
+import { hasLicense } from '../license';
+/**
+ * 플러그인 레지스트리 / Plugin registry
+ *
+ * 모든 플러그인을 등록하고 관리하는 싱글톤 클래스
+ * Singleton class that registers and manages all plugins
+ */
+class PluginRegistry {
+    constructor() {
+        this.plugins = new Map();
+        this.initialized = new Set();
+    }
+    /**
+     * 플러그인 등록 / Register plugin
+     *
+     * @param plugin - 등록할 플러그인
+     * @throws 라이선스가 없을 경우 에러
+     *
+     * @example
+     * ```ts
+     * import { registerPlugin } from '@hua-labs/hua-ux/framework';
+     * import { motionProPlugin } from '@hua-labs/motion-core/pro';
+     *
+     * registerPlugin(motionProPlugin);
+     * ```
+     */
+    register(plugin) {
+        // 중복 등록 확인
+        if (this.plugins.has(plugin.name)) {
+            console.warn(`[hua-ux] Plugin "${plugin.name}" is already registered. Overwriting...`);
+        }
+        // 라이선스 검증
+        if (plugin.license !== 'free') {
+            // 플러그인의 checkLicense 함수가 있으면 사용
+            if (plugin.checkLicense) {
+                if (!plugin.checkLicense()) {
+                    throw new Error(`[hua-ux] ❌ Plugin "${plugin.name}" requires a valid ${plugin.license} license.\n` +
+                        `[hua-ux] ❌ Please purchase a ${plugin.license} license.\n\n` +
+                        `💡 Purchase link: https://hua-labs.com/pricing`);
+                }
+            }
+            else {
+                // 기본 라이선스 검증 (license feature 기반)
+                const feature = `plugin-${plugin.name}`;
+                if (!hasLicense(feature)) {
+                    // 라이선스가 없어도 경고만 표시 (개발 환경)
+                    if (process.env.NODE_ENV === 'development') {
+                        console.warn(`[hua-ux] ⚠️ Plugin "${plugin.name}" may require a ${plugin.license} license.\n` +
+                            `[hua-ux] ⚠️ Some features may not work without a valid license.`);
+                    }
+                }
+            }
+        }
+        // 플러그인 등록
+        this.plugins.set(plugin.name, plugin);
+        if (process.env.NODE_ENV === 'development') {
+            console.log(`[hua-ux] ✅ Plugin "${plugin.name}" v${plugin.version} registered successfully`);
+        }
+    }
+    /**
+     * 플러그인 초기화 / Initialize plugin
+     *
+     * 등록된 플러그인의 init 함수를 호출합니다.
+     * Calls the init function of registered plugins.
+     *
+     * @param pluginName - 플러그인 이름
+     * @param config - 프레임워크 설정
+     */
+    async initialize(pluginName, config) {
+        const plugin = this.plugins.get(pluginName);
+        if (!plugin) {
+            throw new Error(`[hua-ux] Plugin "${pluginName}" not found`);
+        }
+        // 이미 초기화된 경우 스킵
+        if (this.initialized.has(pluginName)) {
+            return;
+        }
+        // init 함수 호출
+        if (plugin.init) {
+            await plugin.init(config);
+            this.initialized.add(pluginName);
+        }
+    }
+    /**
+     * 모든 플러그인 초기화 / Initialize all plugins
+     *
+     * @param config - 프레임워크 설정
+     */
+    async initializeAll(config) {
+        const promises = Array.from(this.plugins.keys()).map(name => this.initialize(name, config));
+        await Promise.all(promises);
+    }
+    /**
+     * 플러그인 가져오기 / Get plugin
+     *
+     * @param name - 플러그인 이름
+     * @returns 플러그인 또는 undefined
+     */
+    get(name) {
+        return this.plugins.get(name);
+    }
+    /**
+     * 모든 플러그인 가져오기 / Get all plugins
+     *
+     * @returns 플러그인 배열
+     */
+    getAll() {
+        return Array.from(this.plugins.values());
+    }
+    /**
+     * 플러그인 등록 해제 / Unregister plugin
+     *
+     * @param name - 플러그인 이름
+     */
+    unregister(name) {
+        this.plugins.delete(name);
+        this.initialized.delete(name);
+    }
+    /**
+     * 레지스트리 초기화 (테스트용) / Reset registry (for testing)
+     */
+    reset() {
+        this.plugins.clear();
+        this.initialized.clear();
+    }
+}
+/**
+ * 전역 플러그인 레지스트리 인스턴스 / Global plugin registry instance
+ */
+export const pluginRegistry = new PluginRegistry();
+/**
+ * 플러그인 등록 (편의 함수) / Register plugin (convenience function)
+ *
+ * @param plugin - 등록할 플러그인
+ */
+export function registerPlugin(plugin) {
+    pluginRegistry.register(plugin);
+}
+/**
+ * 플러그인 가져오기 (편의 함수) / Get plugin (convenience function)
+ *
+ * @param name - 플러그인 이름
+ * @returns 플러그인 또는 undefined
+ */
+export function getPlugin(name) {
+    return pluginRegistry.get(name);
+}
+/**
+ * 모든 플러그인 가져오기 (편의 함수) / Get all plugins (convenience function)
+ *
+ * @returns 플러그인 배열
+ */
+export function getAllPlugins() {
+    return pluginRegistry.getAll();
+}

package/dist/framework/plugins/types.d.ts

@@ -0,0 +1,97 @@
+/**
+ * @hua-labs/hua-ux/framework - Plugin Types
+ *
+ * 플러그인 타입 정의
+ */
+import type { ComponentType } from 'react';
+import type { HuaUxConfig } from '../types';
+import type { LicenseType } from '../license/types';
+/**
+ * 플러그인 인터페이스 / Plugin interface
+ */
+export interface HuaUxPlugin {
+    /**
+     * 플러그인 이름 / Plugin name
+     *
+     * 고유한 식별자로 사용됩니다.
+     * Used as a unique identifier.
+     */
+    name: string;
+    /**
+     * 플러그인 버전 / Plugin version
+     *
+     * Semantic versioning 형식 (예: '1.0.0')
+     * Semantic versioning format (e.g., '1.0.0')
+     */
+    version: string;
+    /**
+     * 라이선스 타입 / License type
+     *
+     * 이 플러그인이 필요한 라이선스 타입
+     * Required license type for this plugin
+     */
+    license: LicenseType;
+    /**
+     * 플러그인 초기화 / Plugin initialization
+     *
+     * 플러그인이 등록될 때 호출됩니다.
+     * Called when the plugin is registered.
+     *
+     * @param config - 프레임워크 설정
+     */
+    init?(config: HuaUxConfig): void | Promise<void>;
+    /**
+     * 컴포넌트 확장 / Component extensions
+     *
+     * 플러그인이 제공하는 컴포넌트들
+     * Components provided by the plugin
+     *
+     * @example
+     * ```ts
+     * components: {
+     *   ParallaxScroll: ParallaxScrollComponent,
+     *   Motion3D: Motion3DComponent,
+     * }
+     * ```
+     */
+    components?: Record<string, ComponentType<any>>;
+    /**
+     * 훅 확장 / Hook extensions
+     *
+     * 플러그인이 제공하는 커스텀 훅들
+     * Custom hooks provided by the plugin
+     *
+     * @example
+     * ```ts
+     * hooks: {
+     *   useParallax: useParallaxHook,
+     *   useMotion3D: useMotion3DHook,
+     * }
+     * ```
+     */
+    hooks?: Record<string, Function>;
+    /**
+     * 설정 스키마 확장 / Config schema extension
+     *
+     * 플러그인이 추가하는 설정 스키마 (향후 Zod 스키마 지원)
+     * Additional config schema added by the plugin (future Zod schema support)
+     */
+    configSchema?: any;
+    /**
+     * 라이선스 검증 / License validation
+     *
+     * 플러그인 등록 시 라이선스를 검증하는 함수
+     * Function to validate license when plugin is registered
+     *
+     * @returns 라이선스 유효 여부
+     */
+    checkLicense?(): boolean;
+    /**
+     * 플러그인 설명 / Plugin description
+     *
+     * 플러그인의 기능 설명
+     * Description of plugin features
+     */
+    description?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/framework/plugins/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/framework/plugins/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;;OAKG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;;;OAKG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;;;;OAKG;IACH,OAAO,EAAE,WAAW,CAAC;IAErB;;;;;;;OAOG;IACH,IAAI,CAAC,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjD;;;;;;;;;;;;;OAaG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC;IAEhD;;;;;;;;;;;;;OAaG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAEjC;;;;;OAKG;IACH,YAAY,CAAC,EAAE,GAAG,CAAC;IAEnB;;;;;;;OAOG;IACH,YAAY,CAAC,IAAI,OAAO,CAAC;IAEzB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB"}

package/dist/framework/plugins/types.js

@@ -0,0 +1,6 @@
+/**
+ * @hua-labs/hua-ux/framework - Plugin Types
+ *
+ * 플러그인 타입 정의
+ */
+export {};

package/dist/framework/seo/geo/examples.d.ts

@@ -0,0 +1,87 @@
+/**
+ * @hua-labs/hua-ux/framework - GEO Usage Examples
+ *
+ * Examples of using GEO (Generative Engine Optimization) to make your
+ * application discoverable by AI search engines
+ *
+ * AI 검색 엔진이 애플리케이션을 잘 찾고 추천하도록 GEO 사용 예시
+ *
+ * These examples demonstrate various use cases including:
+ * - Basic GEO configuration
+ * - Using presets
+ * - Error handling
+ * - Dynamic content
+ * - Minimal configuration
+ */
+/**
+ * Example 1: Basic GEO for a software project
+ *
+ * AI 검색 엔진이 소프트웨어 프로젝트를 정확하게 이해하도록 기본 GEO 메타데이터 생성
+ */
+export declare function Example1_BasicGEO(): import("react/jsx-runtime").JSX.Element;
+/**
+ * Example 2: Next.js App Router metadata
+ *
+ * Next.js App Router의 generateMetadata()와 함께 사용
+ */
+export declare function Example2_NextjsMetadata(): Promise<{
+    title: string;
+    description: string | undefined;
+    keywords: string | undefined;
+    openGraph: {
+        title: string | undefined;
+        description: string | undefined;
+    };
+    other: {
+        'script:ld+json': string;
+    };
+}>;
+/**
+ * Example 3: FAQ Page with structured data
+ *
+ * AI가 자주 묻는 질문에 답변할 수 있도록 FAQ 구조화된 데이터 추가
+ */
+export declare function Example3_FAQPage(): import("react/jsx-runtime").JSX.Element;
+/**
+ * Example 4: HowTo Guide with structured data
+ *
+ * AI가 튜토리얼을 이해하고 추천할 수 있도록 HowTo 구조화된 데이터 추가
+ */
+export declare function Example4_HowToGuide(): import("react/jsx-runtime").JSX.Element;
+/**
+ * Example 5: AI Context for Chatbots
+ *
+ * ChatGPT, Claude 같은 AI 챗봇이 맥락을 이해하기 쉬운 설명 생성
+ */
+export declare function Example5_AIContext(): import("react/jsx-runtime").JSX.Element;
+/**
+ * Example 6: Complete landing page with full GEO
+ *
+ * 모든 GEO 기능을 사용한 완전한 랜딩 페이지 예시
+ */
+export declare function Example6_CompleteLandingPage(): import("react/jsx-runtime").JSX.Element;
+/**
+ * Example 7: Minimal Configuration
+ *
+ * 최소한의 설정으로 GEO 메타데이터 생성
+ * Shows minimum required fields
+ */
+export declare function Example7_MinimalConfig(): import("react/jsx-runtime").JSX.Element;
+/**
+ * Example 8: Error Handling
+ *
+ * 에러 처리 예제
+ * Shows how to handle validation errors
+ */
+export declare function Example8_ErrorHandling(): import("react/jsx-runtime").JSX.Element;
+/**
+ * Example 9: Dynamic Content
+ *
+ * 동적 콘텐츠를 사용한 GEO 메타데이터 생성
+ * Shows how to use dynamic data
+ */
+export declare function Example9_DynamicContent({ title, features, }: {
+    title: string;
+    features: string[];
+}): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=examples.d.ts.map

package/dist/framework/seo/geo/examples.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"examples.d.ts","sourceRoot":"","sources":["../../../../src/framework/seo/geo/examples.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAMH;;;;GAIG;AACH,wBAAgB,iBAAiB,4CAmFhC;AAED;;;;GAIG;AACH,wBAAsB,uBAAuB;;;;;;;;;;;GAuB5C;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,4CAkC/B;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,4CAmClC;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,4CAgCjC;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,4CAkE3C;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,4CAerC;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,4CAgBrC;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,EACtC,KAAK,EACL,QAAQ,GACT,EAAE;IACD,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,2CAoBA"}

package/dist/framework/seo/geo/examples.js

@@ -0,0 +1,295 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+/**
+ * @hua-labs/hua-ux/framework - GEO Usage Examples
+ *
+ * Examples of using GEO (Generative Engine Optimization) to make your
+ * application discoverable by AI search engines
+ *
+ * AI 검색 엔진이 애플리케이션을 잘 찾고 추천하도록 GEO 사용 예시
+ *
+ * These examples demonstrate various use cases including:
+ * - Basic GEO configuration
+ * - Using presets
+ * - Error handling
+ * - Dynamic content
+ * - Minimal configuration
+ */
+import Script from 'next/script';
+import { generateGEOMetadata, renderJSONLD, createAIContext } from './generateGEOMetadata';
+import { generateFAQPageLD, generateHowToLD } from './structuredData';
+/**
+ * Example 1: Basic GEO for a software project
+ *
+ * AI 검색 엔진이 소프트웨어 프로젝트를 정확하게 이해하도록 기본 GEO 메타데이터 생성
+ */
+export function Example1_BasicGEO() {
+    const geoMetadata = generateGEOMetadata({
+        name: 'hua-ux',
+        alternateName: ['@hua-labs/hua-ux', 'hua UX framework'],
+        description: 'Privacy-first UX framework for Next.js with built-in i18n, motion, and accessibility',
+        version: '1.0.0',
+        applicationCategory: ['UX Framework', 'Developer Tool'],
+        programmingLanguage: ['TypeScript', 'React', 'Next.js'],
+        applicationType: 'DeveloperApplication',
+        url: 'https://hua-labs.dev',
+        documentationUrl: 'https://hua-labs.dev/docs/hua-ux',
+        codeRepository: 'https://github.com/hua-labs/hua',
+        license: 'MIT',
+        author: {
+            name: 'hua-labs',
+            url: 'https://hua-labs.dev',
+        },
+        features: [
+            'Privacy-first architecture (no tracking, no analytics by default)',
+            'Built-in internationalization (i18n) with hua-i18n',
+            'Smooth motion animations with hua-motion',
+            'WCAG 2.1 compliant accessibility features',
+            'Automatic error handling with ErrorBoundary',
+            'Loading state optimization (300ms flicker prevention)',
+            'AI-friendly documentation (Korean/English bilingual)',
+        ],
+        useCases: [
+            'Building multilingual Next.js applications',
+            'Creating accessible web applications',
+            'Rapid prototyping with privacy-first defaults',
+            'Enterprise applications requiring WCAG compliance',
+        ],
+        keywords: [
+            'nextjs',
+            'react',
+            'ux framework',
+            'i18n',
+            'internationalization',
+            'accessibility',
+            'a11y',
+            'wcag',
+            'motion',
+            'animation',
+            'privacy',
+            'gdpr',
+            'typescript',
+        ],
+        softwareRequirements: ['Next.js 14+', 'React 18+', 'TypeScript 5+'],
+        operatingSystem: ['Windows', 'macOS', 'Linux'],
+        relatedTo: [
+            'Next.js',
+            'React',
+            'hua-i18n',
+            'hua-motion',
+            'hua-state',
+            'Tailwind CSS',
+        ],
+    });
+    return (_jsxs("head", { children: [geoMetadata.meta.map((meta) => (_jsx("meta", { name: meta.name, content: meta.content }, meta.name))), geoMetadata.openGraph?.map((og) => (_jsx("meta", { property: og.property, content: og.content }, og.property))), geoMetadata.twitter?.map((tw) => (_jsx("meta", { name: tw.name, content: tw.content }, tw.name))), geoMetadata.jsonLd.map((ld, index) => (_jsx(Script, { ...renderJSONLD(ld) }, index)))] }));
+}
+/**
+ * Example 2: Next.js App Router metadata
+ *
+ * Next.js App Router의 generateMetadata()와 함께 사용
+ */
+export async function Example2_NextjsMetadata() {
+    const geoMeta = generateGEOMetadata({
+        name: 'My App',
+        description: 'Built with hua-ux for privacy-first UX',
+        features: ['i18n', 'Dark mode', 'Responsive design'],
+        keywords: ['nextjs', 'react', 'privacy', 'accessibility'],
+    });
+    // Next.js Metadata 객체로 변환
+    return {
+        title: 'My App',
+        description: geoMeta.meta.find((m) => m.name === 'description')?.content,
+        keywords: geoMeta.meta.find((m) => m.name === 'keywords')?.content,
+        openGraph: {
+            title: geoMeta.openGraph?.find((og) => og.property === 'og:title')?.content,
+            description: geoMeta.openGraph?.find((og) => og.property === 'og:description')
+                ?.content,
+        },
+        // JSON-LD는 layout.tsx나 page.tsx에서 Script 컴포넌트로 추가
+        other: {
+            'script:ld+json': JSON.stringify(geoMeta.jsonLd),
+        },
+    };
+}
+/**
+ * Example 3: FAQ Page with structured data
+ *
+ * AI가 자주 묻는 질문에 답변할 수 있도록 FAQ 구조화된 데이터 추가
+ */
+export function Example3_FAQPage() {
+    const faqLd = generateFAQPageLD([
+        {
+            question: 'What is hua-ux?',
+            answer: 'hua-ux is a privacy-first UX framework for Next.js applications. It provides built-in internationalization (i18n), motion animations, accessibility features (WCAG 2.1 compliant), automatic error handling, and loading state optimization.',
+        },
+        {
+            question: 'How do I install hua-ux?',
+            answer: 'You can create a new hua-ux project using the CLI: npx create-hua-ux my-app. Or install it in an existing Next.js project: pnpm add @hua-labs/hua-ux',
+        },
+        {
+            question: 'Is hua-ux free to use?',
+            answer: 'Yes, hua-ux is open-source and available under the MIT license. You can use it freely in both personal and commercial projects.',
+        },
+        {
+            question: 'What makes hua-ux privacy-first?',
+            answer: 'hua-ux has no tracking, no analytics, and no data collection by default. It respects user privacy and follows GDPR/CCPA principles. You have full control over what data your application collects.',
+        },
+        {
+            question: 'Does hua-ux support TypeScript?',
+            answer: 'Yes, hua-ux is written in TypeScript and provides full type safety. All components, hooks, and utilities come with TypeScript definitions.',
+        },
+    ]);
+    return (_jsx("head", { children: _jsx(Script, { ...renderJSONLD(faqLd) }) }));
+}
+/**
+ * Example 4: HowTo Guide with structured data
+ *
+ * AI가 튜토리얼을 이해하고 추천할 수 있도록 HowTo 구조화된 데이터 추가
+ */
+export function Example4_HowToGuide() {
+    const howToLd = generateHowToLD({
+        name: 'How to add internationalization (i18n) to your Next.js app with hua-ux',
+        description: 'Step-by-step guide to implementing multilingual support in your Next.js application using hua-ux',
+        totalTime: 'PT10M', // 10 minutes
+        steps: [
+            {
+                name: 'Create a new hua-ux project',
+                text: 'Run the CLI command: npx create-hua-ux my-app. This creates a new Next.js project with hua-ux pre-configured.',
+            },
+            {
+                name: 'Configure supported locales',
+                text: 'Edit hua.config.ts and add your locales to the i18n.locales array. For example: locales: ["en", "ko", "ja"]',
+            },
+            {
+                name: 'Create translation files',
+                text: 'Add JSON translation files in the messages/ directory. Create one file per locale: messages/en.json, messages/ko.json, etc.',
+            },
+            {
+                name: 'Use translations in components',
+                text: 'Import useI18n hook and use the t() function to translate text: const { t } = useI18n(); return <h1>{t("welcome")}</h1>',
+            },
+            {
+                name: 'Add language switcher',
+                text: 'Use the LocaleSwitcher component to let users change languages: <LocaleSwitcher />',
+            },
+        ],
+    });
+    return (_jsx("head", { children: _jsx(Script, { ...renderJSONLD(howToLd) }) }));
+}
+/**
+ * Example 5: AI Context for Chatbots
+ *
+ * ChatGPT, Claude 같은 AI 챗봇이 맥락을 이해하기 쉬운 설명 생성
+ */
+export function Example5_AIContext() {
+    const context = createAIContext({
+        name: 'hua-ux',
+        description: 'Privacy-first UX framework for Next.js',
+        features: [
+            'Internationalization (i18n)',
+            'Motion animations',
+            'WCAG 2.1 accessibility',
+            'Error boundaries',
+            'Loading state optimization',
+        ],
+        useCases: [
+            'Multilingual web applications',
+            'Accessible enterprise applications',
+            'Privacy-compliant consumer apps',
+        ],
+        programmingLanguage: ['TypeScript', 'React', 'Next.js'],
+        softwareRequirements: ['Next.js 14+', 'React 18+'],
+    });
+    // Returns:
+    // "hua-ux is a Privacy-first UX framework for Next.js. Key features include:
+    // Internationalization (i18n), Motion animations, WCAG 2.1 accessibility, Error
+    // boundaries, Loading state optimization. Common use cases: Multilingual web
+    // applications, Accessible enterprise applications, Privacy-compliant consumer
+    // apps. Built with: TypeScript, React, Next.js. Requires: Next.js 14+, React 18+."
+    return (_jsx("head", { children: _jsx("meta", { name: "ai:context", content: context }) }));
+}
+/**
+ * Example 6: Complete landing page with full GEO
+ *
+ * 모든 GEO 기능을 사용한 완전한 랜딩 페이지 예시
+ */
+export function Example6_CompleteLandingPage() {
+    // Software metadata
+    const geoMeta = generateGEOMetadata({
+        name: 'hua-ux',
+        description: 'Privacy-first UX framework for Next.js',
+        version: '1.0.0',
+        applicationCategory: 'UX Framework',
+        programmingLanguage: 'TypeScript',
+        features: ['i18n', 'Motion', 'Accessibility', 'Error handling', 'Loading optimization'],
+        keywords: ['nextjs', 'react', 'ux', 'i18n', 'accessibility', 'privacy'],
+        codeRepository: 'https://github.com/hua-labs/hua',
+        license: 'MIT',
+    });
+    // FAQ structured data
+    const faqLd = generateFAQPageLD([
+        { question: 'What is hua-ux?', answer: 'Privacy-first UX framework for Next.js' },
+        { question: 'How to install?', answer: 'npx create-hua-ux my-app' },
+    ]);
+    // HowTo guide
+    const howToLd = generateHowToLD({
+        name: 'Getting started with hua-ux',
+        steps: [
+            { name: 'Install', text: 'npx create-hua-ux my-app' },
+            { name: 'Configure', text: 'Edit hua.config.ts' },
+            { name: 'Build', text: 'pnpm dev' },
+        ],
+    });
+    // AI context
+    const aiContext = createAIContext({
+        name: 'hua-ux',
+        description: 'Privacy-first UX framework',
+        features: ['i18n', 'Motion', 'Accessibility'],
+    });
+    return (_jsxs("html", { children: [_jsxs("head", { children: [geoMeta.meta.map((meta) => (_jsx("meta", { name: meta.name, content: meta.content }, meta.name))), geoMeta.openGraph?.map((og) => (_jsx("meta", { property: og.property, content: og.content }, og.property))), geoMeta.twitter?.map((tw) => (_jsx("meta", { name: tw.name, content: tw.content }, tw.name))), _jsx("meta", { name: "ai:context", content: aiContext }), _jsx(Script, { ...renderJSONLD(geoMeta.jsonLd[0]) }), _jsx(Script, { ...renderJSONLD(faqLd) }), _jsx(Script, { ...renderJSONLD(howToLd) })] }), _jsx("body", {})] }));
+}
+/**
+ * Example 7: Minimal Configuration
+ *
+ * 최소한의 설정으로 GEO 메타데이터 생성
+ * Shows minimum required fields
+ */
+export function Example7_MinimalConfig() {
+    const geoMeta = generateGEOMetadata({
+        name: 'My App',
+        description: 'A simple app',
+    });
+    return (_jsxs(_Fragment, { children: [_jsx(Script, { ...renderJSONLD(geoMeta.jsonLd[0]) }), _jsxs("main", { children: [_jsx("h1", { children: "Minimal GEO Configuration" }), _jsx("p", { children: "Only name and description are required." })] })] }));
+}
+/**
+ * Example 8: Error Handling
+ *
+ * 에러 처리 예제
+ * Shows how to handle validation errors
+ */
+export function Example8_ErrorHandling() {
+    try {
+        const geoMeta = generateGEOMetadata({
+            name: '', // Invalid!
+            description: 'Test',
+        });
+        return _jsx("div", { children: "Success" });
+    }
+    catch (error) {
+        console.error('GEO metadata generation failed:', error);
+        return (_jsxs("div", { children: [_jsx("h1", { children: "Error" }), _jsx("p", { children: error.message })] }));
+    }
+}
+/**
+ * Example 9: Dynamic Content
+ *
+ * 동적 콘텐츠를 사용한 GEO 메타데이터 생성
+ * Shows how to use dynamic data
+ */
+export function Example9_DynamicContent({ title, features, }) {
+    const geoMeta = generateGEOMetadata({
+        name: title,
+        description: `App with ${features.length} features`,
+        features,
+    });
+    return (_jsxs(_Fragment, { children: [_jsx(Script, { ...renderJSONLD(geoMeta.jsonLd[0]) }), _jsxs("main", { children: [_jsx("h1", { children: title }), _jsx("ul", { children: features.map((feature, i) => (_jsx("li", { children: feature }, i))) })] })] }));
+}