Release v0.4.0

Author: edwintantawi

.changeset/dull-mirrors-care.md

@@ -0,0 +1,5 @@
+---
+'@devsantara/head': minor
+---
+
+feat: remove unnecessary exported types

.changeset/famous-candles-relax.md

@@ -0,0 +1,5 @@
+---
+'@devsantara/head': minor
+---
+
+feat(meta): add http-equiv

.changeset/tender-eggs-go.md

@@ -0,0 +1,12 @@
+---
+'@devsantara/head': minor
+---
+
+feat(schema-org): add SchemaOrgBuilder for type-safe structured data
+
+Add SchemaOrgBuilder class for creating type-safe Schema.org structured data with JSON-LD output.
+
+- Type-safe Schema.org entities with schema-dts integration
+- Entity relationship management with references
+- URL resolution with configurable base URLs
+- JSON-LD compilation for search engines

.oxfmtrc.json

@@ -1,6 +1,6 @@
 {
   "$schema": "./node_modules/oxfmt/configuration_schema.json",
-  "ignorePatterns": ["pnpm-lock.yaml"],
+  "ignorePatterns": ["pnpm-lock.yaml", "CHANGELOG.md"],
   "printWidth": 80,
   "tabWidth": 2,
   "useTabs": false,

README.md

@@ -23,6 +23,7 @@ Build SEO-friendly metadata with a fluent API, full TypeScript support, and fram
 - **Social Media** – Open Graph and Twitter Card meta tags for rich previews.
 - **Mobile Optimization** – Viewport configuration, color schemes, PWA icons.
 - **Advanced Tags** – Alternates, manifests, stylesheets, scripts, and custom meta tags.
+- **Structured Data** – Schema.org JSON-LD support for rich snippets, knowledge graphs, and enhanced SEO.
 - **Simplified URL Management** – Most metadata (Open Graph, canonical, alternates) requires absolute URLs. Set `metadataBase` once and use convenient relative paths everywhere.
 - **Continuously Expanding** – Actively adding more metadata types based on community feedback.
 
@@ -326,6 +327,42 @@ export const Route = createRootRoute({
 ]
 ```
 
+## 🌐 Schema.org Structured Data
+
+Add rich structured data with [Schema.org](https://schema.org) JSON-LD support for enhanced search engine understanding and knowledge graphs.
+
+### Quick Start
+
+```typescript
+import { HeadBuilder } from '@devsantara/head';
+import { SchemaOrgBuilder } from '@devsantara/head/schema-org';
+import type { Organization } from 'schema-dts';
+
+const schema = new SchemaOrgBuilder<Organization>().addEntity('org', {
+  '@type': 'Organization',
+  name: 'My Company',
+  url: 'https://devsantara.com',
+});
+
+const head = new HeadBuilder()
+  .addTitle('Welcome')
+  .addDescription('Visit our site')
+  .addSchemaOrg(schema)
+  .build();
+```
+
+### Features
+
+- **Type-Safe Entities** – Full TypeScript support with `schema-dts` package
+- **Multiple Entities** – Build complex entity graphs with relationships
+- **Entity References** – Link entities together with `@id` cross-references
+- **URL Resolution** – Automatically resolve relative URLs with metadata base
+- **JSON-LD Output** – Standards-compliant format ready for search engines
+
+### Learn More
+
+For comprehensive documentation, examples, and best practices, see the [Schema.org Module Documentation](./src/schema-org/README.md).
+
 ## 📚 API Reference
 
 ### Core Methods
@@ -350,20 +387,22 @@ For advanced use cases not covered by the essential methods below, use these bas
 
 High-level convenience methods for common metadata patterns. These methods handle the complexity of creating properly structured head.
 
-| Method                                                                 | Description                                                 |
-| ---------------------------------------------------------------------- | ----------------------------------------------------------- |
-| `addDescription(description: string)`                                  | Adds a meta description tag                                 |
-| `addCanonical(valueOrFn: BuilderOption<string \| URL>)`                | Adds a canonical URL link                                   |
-| `addRobots(options: RobotsOptions)`                                    | Adds robots meta tag for search engine directives           |
-| `addCharSet(charset: CharSet)`                                         | Adds character encoding declaration                         |
-| `addViewport(options: ViewportOptions)`                                | Adds viewport configuration for responsive design           |
-| `addColorScheme(colorScheme: ColorScheme)`                             | Adds color scheme preference (light/dark mode)              |
-| `addOpenGraph(valueOrFn: BuilderOption<OpenGraphOptions>)`             | Adds Open Graph meta tags for social media previews         |
-| `addTwitter(valueOrFn: BuilderOption<TwitterOptions>)`                 | Adds Twitter Card meta tags                                 |
-| `addIcon(preset: IconPreset, valueOrFn: BuilderOption<IconOptions>)`   | Adds favicon or app icons (favicon, apple-touch-icon, etc.) |
-| `addStylesheet(href: string \| URL, options?: StylesheetOptions)`      | Adds an external stylesheet link                            |
-| `addManifest(valueOrFn: BuilderOption<string \| URL>)`                 | Adds a web app manifest link                                |
-| `addAlternateLocale(valueOrFn: BuilderOption<AlternateLocaleOptions>)` | Adds alternate language/locale links                        |
+| Method                                                                         | Description                                                 |
+| ------------------------------------------------------------------------------ | ----------------------------------------------------------- |
+| `addDescription(description: string)`                                          | Adds a meta description tag                                 |
+| `addCanonical(valueOrFn: BuilderOption<string \| URL>)`                        | Adds a canonical URL link                                   |
+| `addRobots(options: RobotsOptions)`                                            | Adds robots meta tag for search engine directives           |
+| `addCharSet(charset: CharSet)`                                                 | Adds character encoding declaration                         |
+| `addViewport(options: ViewportOptions)`                                        | Adds viewport configuration for responsive design           |
+| `addColorScheme(colorScheme: ColorScheme)`                                     | Adds color scheme preference (light/dark mode)              |
+| `addOpenGraph(valueOrFn: BuilderOption<OpenGraphOptions>)`                     | Adds Open Graph meta tags for social media previews         |
+| `addTwitter(valueOrFn: BuilderOption<TwitterOptions>)`                         | Adds Twitter Card meta tags                                 |
+| `addIcon(preset: IconPreset, valueOrFn: BuilderOption<IconOptions>)`           | Adds favicon or app icons (favicon, apple-touch-icon, etc.) |
+| `addStylesheet(href: string \| URL, options?: StylesheetOptions)`              | Adds an external stylesheet link                            |
+| `addManifest(valueOrFn: BuilderOption<string \| URL>)`                         | Adds a web app manifest link                                |
+| `addAlternateLocale(valueOrFn: BuilderOption<AlternateLocaleOptions>)`         | Adds alternate language/locale links                        |
+| `addHttpEquiv(httpEquiv: HttpEquivKey, content: string)`                       | Adds a pragma directive using the `http-equiv` attribute    |
+| `addSchemaOrg(valueOrFn: SchemaOrgBuilder \| BuilderOption<SchemaOrgBuilder>)` | Adds Schema.org structured data as JSON-LD                  |
 
 > **💡 Tip:** Most methods support either direct values or callback functions that receive a helper object with `resolveUrl()` for dynamic URL resolution.
 

package.json

@@ -1,10 +1,17 @@
 {
   "name": "@devsantara/head",
   "version": "0.3.0",
-  "description": "A type-safe HTML head builder",
+  "description": "A type-safe HTML head builder library for managing document head metadata with full TypeScript support",
   "keywords": [
     "devsantara",
-    "head"
+    "head",
+    "json-ld",
+    "meta",
+    "metadata",
+    "react",
+    "schema.org",
+    "seo",
+    "typescript"
   ],
   "homepage": "https://github.com/devsantara/head#readme",
   "bugs": {
@@ -27,6 +34,7 @@
   "types": "./dist/index.d.ts",
   "exports": {
     ".": "./dist/index.js",
+    "./schema-org": "./dist/schema-org/index.js",
     "./adapters": "./dist/adapters/index.js",
     "./package.json": "./package.json"
   },
@@ -56,6 +64,7 @@
     "oxfmt": "^0.27.0",
     "oxlint": "^1.42.0",
     "oxlint-tsgolint": "^0.11.4",
+    "schema-dts": "^1.1.5",
     "tsdown": "^0.20.1",
     "typescript": "^5.9.3",
     "vitest": "^4.0.18"

pnpm-lock.yaml

@@ -1,2 +1,2 @@
-export * from './react-adapter';
-export * from './tanstack-router-adapter';
+export { HeadReactAdapter } from './react-adapter';
+export { HeadTanstackRouterAdapter } from './tanstack-router-adapter';

src/adapters/index.ts

@@ -1,7 +1,7 @@
 import { createElement, type ReactNode } from 'react';
 import type { HeadAdapter, HeadElement } from '../types';
 
-export type HeadReactAdapterResult = ReactNode[];
+type HeadReactAdapterResult = ReactNode[];
 
 /**
  * Adapter that transforms head elements into React components for rendering in React applications.

src/adapters/react-adapter.ts

@@ -8,7 +8,7 @@ import type {
 } from '../types';
 import { isElementOfType } from '../utils';
 
-export interface HeadTanStackRouterAdapterResult {
+interface HeadTanStackRouterAdapterResult {
   links?: HeadLinkAttributes[];
   scripts?: HeadScriptAttributes[];
   meta?: HeadMetaAttributes[];