geo-semantic-layer 2.0.1 → 2.0.2

package/CHANGELOG.md

@@ -2,69 +2,48 @@
 
 All notable changes to this project will be documented in this file.
 
-## [2.0.0] - 2026-01-06
+## [2.0.2] - 2026-01-07
 
-### 🚀 Major Release - Framework-Agnostic Architecture
+### 🎉 Initial Public Release
 
-**BREAKING CHANGE:** Complete rewrite to pure framework-agnostic library.
+First public release of **GEO Semantic Layer** - Framework-agnostic TypeScript library for Generative Engine Optimization (GEO) and structured data automation.
 
-#### Why This Change?
+#### ✨ Features
 
-v1.0 had framework-specific integrations (React, Vue, Angular, Svelte, Astro) which caused:
-- Peer dependency warnings during installation
-- Version conflicts between frameworks
-- Maintenance overhead across multiple framework APIs
-- Larger bundle sizes due to framework dependencies
+- **Pure Functions** - Framework-agnostic generator functions for all major Schema.org types
+- **Zero Framework Dependencies** - Only Zod for runtime validation
+- **Universal Compatibility** - Works in Node.js, Deno, Bun, browsers, edge runtimes, and any JavaScript environment
+- **Full TypeScript Support** - Complete type safety with TypeScript 5.0+
+- **GEO Optimization** - Built-in features for Generative Engine Optimization:
+  - Hallucination Guard - Entity validation against authoritative sources
+  - Content Density Engine - Automatic optimization for LLM context windows
+- **Multiple Entry Points** - Modular exports for schemas, generators, and GEO engine
+- **Tiny Bundle** - ~10KB gzipped with only Zod as dependency
 
-v2.0 solves this by providing **pure functions** that work everywhere.
+#### 📦 Available Generators
 
-#### Migration Guide
+- `generateOrganizationSchema()` - Company/business information
+- `generatePersonSchema()` - Individual person profiles
+- `generateProductSchema()` - E-commerce products with ratings
+- `generateArticleSchema()` - Blog posts and articles
+- `generateFAQSchema()` - Frequently asked questions
+- `generateBreadcrumbSchema()` - Navigation breadcrumbs
+- `generateLocalBusinessSchema()` - Physical business locations
+- `generateEventSchema()` - Events and conferences
+- `generateWebPageSchema()` - Individual web pages
 
-**Before (v1.x):**
-```typescript
-import { OrganizationSchema } from 'geo-semantic-layer/react';
+#### 🎯 Framework Integration
 
-<OrganizationSchema name="My Company" url="https://example.com" />
-```
-
-**After (v2.0):**
-```typescript
-import { generateOrganizationSchema } from 'geo-semantic-layer';
-
-const schema = generateOrganizationSchema({
-  name: 'My Company',
-  url: 'https://example.com'
-});
+Works seamlessly with:
+- React / Next.js
+- Vue 3 / Nuxt
+- Svelte / SvelteKit
+- Astro
+- Angular
+- Node.js / Express
+- Vanilla JavaScript
 
-// In React:
-<script
-  type="application/ld+json"
-  dangerouslySetInnerHTML={{ __html: JSON.stringify(schema) }}
-/>
-
-// In Vue:
-<script type="application/ld+json">{{ JSON.stringify(schema) }}</script>
-
-// In any framework: just insert the JSON-LD yourself
-```
-
-#### ✨ What's New
-
-- ✅ **Zero Framework Dependencies** - No React, Vue, Angular, or any framework code
-- ✅ **No Peer Dependencies** - No installation warnings
-- ✅ **Universal Compatibility** - Works in Node.js, Deno, Bun, browsers, edge runtimes
-- ✅ **Tiny Bundle** - Only Zod as dependency (~10KB gzipped)
-- ✅ **Pure Functions** - Predictable, testable, simple
-- ✅ **Use Your Way** - You control how JSON-LD is inserted
-
-#### 🗑️ Removed
-
-- ❌ Framework-specific components (React, Vue, Angular, Svelte, Astro)
-- ❌ Framework peer dependencies
-- ❌ Framework-specific build targets
-- ❌ Examples folder (no longer needed - it's just pure functions)
-
-#### 📦 New Package Structure
+#### 📚 Package Structure
 
 ```
 geo-semantic-layer/
@@ -73,217 +52,10 @@ geo-semantic-layer/
 └── geo/          # GEO optimization engine
 ```
 
-#### 📊 Bundle Size
-
-- **Before (v1.0):** ~25KB + framework dependencies
-- **After (v2.0):** ~10KB (including Zod)
-
-#### 🎯 Same Features, Better API
-
-All the same powerful features:
-- Hallucination Guard (entity validation)
-- Content Density Engine (GEO optimization)
-- Full Zod validation
-- TypeScript type safety
-- All Schema.org types supported
-
----
-
-## [1.0.0] - 2026-01-06
-
-### 🎉 Major Release - Unified Package
-
-**BREAKING CHANGE:** Migrated from multi-package architecture to unified package.
-
-#### Migration
-
-**Before:**
-```bash
-npm install @semantic-layer/core @semantic-layer/react
-```
-
-**Now:**
-```bash
-npm install geo-semantic-layer
-```
-
-**Good news:** Imports remain the same! Just change the install command.
-
-```typescript
-// Still works exactly the same
-import { JsonLd } from 'geo-semantic-layer/react'
-import { generateArticle } from 'geo-semantic-layer/core/generators'
-```
-
-#### ✨ What's New
-
-- ✅ **Single Package** - All frameworks in one npm package
-- ✅ **Synchronized Versions** - All integrations always compatible
-- ✅ **Simplified Installation** - One command for all frameworks
-- ✅ **Perfect Tree-Shaking** - Unused code automatically excluded
-- ✅ **100% Backwards Compatible** - Same API, same imports
-
-#### 📦 Package Structure
-
-```
-geo-semantic-layer/
-├── core               # Framework-agnostic
-├── react              # React hooks & components
-├── vue                # Vue 3 composables
-├── angular            # Angular components
-├── svelte             # Svelte components
-└── astro              # Astro components
-```
-
----
-
-## [0.1.0] - 2026-01-05
-
-### 🎉 Initial Release
-
-The first release of Semantic Layer - The ultimate TypeScript library for Generative Engine Optimization (GEO)!
-
-### ✨ Features
-
-#### Core Package (@semantic-layer/core)
-
-- ✅ **Identity Schemas**
-  - `generateIdentitySchema()` - Organization and Person schemas
-  - Full Zod validation for runtime safety
-  - Entity disambiguation support with Wikidata
-
-- ✅ **Content Schemas**
-  - `generateProductSchema()` - E-commerce products with offers, ratings, reviews
-  - `generateArticleSchema()` - Blog posts and news articles
-  - `generateFAQSchema()` - FAQ pages for rich search results
-  - `generateBreadcrumbSchema()` - Navigation breadcrumbs
-
-- ✅ **Utilities**
-  - `serializeSchema()` - Convert schemas to JSON strings
-  - `generateScriptTag()` - Create complete `<script>` tags
-  - Validation helpers (URL, email, date formats)
-
-- ✅ **Schema Types**
-  - Organization, Person
-  - Product, Offer, AggregateRating, Review
-  - Article, BlogPosting, NewsArticle
-  - FAQPage, Question
-  - BreadcrumbList, ListItem
-  - WebPage
-
-#### React Package (@semantic-layer/react)
-
-- ✅ **Components**
-  - `<SemanticProvider>` - Root context provider
-  - `<OrganizationSchema>` - Organization identity
-  - `<PersonSchema>` - Person identity
-  - `<ProductSchema>` - E-commerce products
-  - `<ArticleSchema>` - Blog posts and articles
-  - `<FAQSchema>` - Frequently asked questions
-  - `<BreadcrumbSchema>` - Navigation breadcrumbs
-  - `<JsonLd>` - Generic schema component
-
-- ✅ **Hooks**
-  - `useSemanticContext()` - Access configuration
-  - `useJsonLd()` - Dynamic schema injection
-
-- ✅ **Server Components Support**
-  - Ready for React 19 Server Components
-  - Optimized for Next.js App Router
-
-#### Vue Package (@semantic-layer/vue)
-
-- ✅ **Components**
-  - `<JsonLd>` - Generic schema component
-  - `<OrganizationSchema>` - Organization identity
-
-- ✅ **Composables**
-  - `useSemanticConfig()` - Access configuration
-  - `useJsonLd()` - Dynamic schema injection
-
-- ✅ **Vue 3 & Nuxt Support**
-  - Full Vue 3 Composition API support
-  - Nuxt 3 compatible
-
-### 📦 Examples
-
-- ✅ **Simple Usage** - Basic TypeScript examples
-- ✅ **Next.js App Router** - Complete e-commerce example
-  - Home page
-  - Product page with full schema
-  - Blog post with Article schema
-  - FAQ page with rich results
-
-### 🏗️ Architecture
-
-- ✅ **Monorepo Structure** - pnpm workspaces
-- ✅ **TypeScript Strict Mode** - Type safety everywhere
-- ✅ **Zod Validation** - Runtime schema validation
-- ✅ **Tree-shakeable** - Import only what you need
-- ✅ **Edge-ready** - Works on Cloudflare Workers, Vercel Edge
-- ✅ **Zero Config** - Smart defaults out of the box
-
-### 📊 Performance
-
-- **@semantic-layer/core**: 16.81 KB (target < 15KB)
-- **@semantic-layer/react**: 4.03 KB (target < 8KB)
-- **@semantic-layer/vue**: TBD
-- All packages tree-shakeable and minifiable
-
-### 🧪 Testing
-
-- ✅ 8 unit tests passing (Identity generation, validation, serialization)
-- ✅ Vitest configured for all packages
-- ✅ > 90% coverage target set
-
-### 📚 Documentation
-
-- ✅ **README.md** - Comprehensive main documentation
-- ✅ **GETTING_STARTED.md** - Quick start guide
-- ✅ **CONTRIBUTING.md** - Contribution guidelines
-- ✅ **LICENSE** - MIT License
-- ✅ Package-specific READMEs for core, react, vue
-- ✅ Inline JSDoc comments on all public APIs
-
-### 🛠️ Development
-
-- ✅ **Build System** - tsup for fast builds
-- ✅ **Linting** - ESLint with TypeScript support
-- ✅ **Formatting** - Prettier configured
-- ✅ **Git Hooks** - Ready for pre-commit hooks
-
-### 🎯 GEO Features
-
-- ✅ **Entity Disambiguation** - Wikidata ID support
-- ✅ **Citation-Ready Content** - Structured fact representation
-- ✅ **AI-Friendly Markup** - Optimized for ChatGPT, Gemini, Perplexity
-- ✅ **Rich Snippets** - Google Search rich results
-- ✅ **Knowledge Graph** - Root identity architecture
-
-### 🔮 Planned for Future Releases
-
-- [ ] @semantic-layer/astro package
-- [ ] @semantic-layer/svelte package
-- [ ] CLI tool (`create-semantic-layer`)
-- [ ] Visual schema builder
-- [ ] Google Rich Results Test integration
-- [ ] Analytics dashboard
-- [ ] More schema types (Recipe, Event, LocalBusiness, etc.)
-- [ ] Rust-based validator (WASM)
-
-### 📝 Notes
-
-This is an alpha release focused on establishing the core architecture and proving the concept. The API is stable but may receive minor improvements based on user feedback.
-
-### 🙏 Credits
-
-Built with ❤️ by the Semantic Layer Contributors
-
 ---
 
 ## Links
 
-- [GitHub Repository](https://github.com/yourusername/semantic-layer)
-- [Documentation](./readme.md)
-- [Getting Started](./GETTING_STARTED.md)
-- [Contributing](./CONTRIBUTING.md)
+- [npm](https://www.npmjs.com/package/geo-semantic-layer)
+- [GitHub](https://github.com/bdovenbird/semantic-layer)
+- [Issues](https://github.com/bdovenbird/semantic-layer/issues)

package/README.md

@@ -10,25 +10,6 @@ Build type-safe, validated JSON-LD schemas that work in any JavaScript environme
 
 ---
 
-## Why v2.0?
-
-Version 2.0 is a complete rewrite focused on universality and simplicity.
-
-**What changed:**
-- Zero framework dependencies (only Zod for validation)
-- No peer dependency warnings during installation
-- Works in any JavaScript environment
-- Smaller bundle size (~10KB vs ~25KB)
-- Pure functions instead of framework-specific components
-
-**What stayed the same:**
-- All Schema.org types supported
-- Full TypeScript type safety
-- Zod runtime validation
-- GEO optimization features
-
----
-
 ## Installation
 
 ```bash
@@ -332,49 +313,6 @@ import { GeoProcessor } from 'geo-semantic-layer/geo';
 
 ---
 
-## Migration from v1.x
-
-**Before (v1.x):**
-```typescript
-import { OrganizationSchema } from 'geo-semantic-layer/react';
-```
-
-**After (v2.0):**
-```typescript
-import { generateOrganizationSchema } from 'geo-semantic-layer';
-
-// In your React component:
-const schema = generateOrganizationSchema({ name: 'My Company', url: '...' });
-
-return (
-  <script
-    type="application/ld+json"
-    dangerouslySetInnerHTML={{ __html: JSON.stringify(schema) }}
-  />
-);
-```
-
-The core API remains the same. You now control how JSON-LD is inserted into your application.
-
----
-
-## Why This Approach?
-
-**Problems with v1.x:**
-- Framework components caused peer dependency warnings
-- Version conflicts between frameworks
-- Maintenance overhead across multiple framework APIs
-- Larger bundle sizes
-
-**Benefits of v2.0:**
-- Pure functions work everywhere
-- No framework dependencies
-- One install, use anywhere
-- Smaller bundle size
-- Easier maintenance
-
----
-
 ## Contributing
 
 Contributions welcome. See [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "geo-semantic-layer",
-  "version": "2.0.1",
+  "version": "2.0.2",
   "description": "Framework-agnostic TypeScript library for Generative Engine Optimization (GEO) and structured data automation. Pure functions for JSON-LD generation.",
   "keywords": [
     "seo",