@geenius/seo 0.1.0 → 0.3.0

package/packages/shared/src/index.ts

@@ -1,207 +0,0 @@
-// ─── SEO Metadata Interfaces ─────────────────────────────────────
-
-export interface OGMeta {
-  title: string
-  description: string
-  image?: string
-  imageAlt?: string
-  type: 'website' | 'article' | 'product'
-  url: string
-  siteName?: string
-}
-
-export interface TwitterMeta {
-  card: 'summary' | 'summary_large_image'
-  title: string
-  description: string
-  image?: string
-  creator?: string
-}
-
-export interface SEOMeta {
-  title: string
-  description: string
-  keywords: string[]
-  canonical?: string
-  og: OGMeta
-  twitter: TwitterMeta
-  robots?: string
-  alternates?: Record<string, string>
-  jsonLd?: Record<string, unknown>[]
-}
-
-export interface SitemapEntry {
-  url: string
-  lastmod?: string
-  changefreq?: string
-  priority?: number
-}
-
-export interface RobotsTxt {
-  allow: string[]
-  disallow: string[]
-  sitemap?: string
-}
-
-export interface SEOConfig {
-  siteName: string
-  siteUrl: string
-  defaultImage?: string
-  twitterHandle?: string
-  locale?: string
-  googleAnalyticsId?: string
-  googleTagManagerId?: string
-}
-
-// ─── Utility Functions ──────────────────────────────────────────
-
-export function buildTitle(pageTitle: string, siteName: string, sep = ' | '): string {
-  return `${pageTitle}${sep}${siteName}`
-}
-
-export function truncateDescription(desc: string, max = 160): string {
-  if (desc.length <= max) return desc
-  return desc.slice(0, max - 3) + '...'
-}
-
-// ─── JSON-LD Schema Builders ────────────────────────────────────
-
-export function articleSchema(data: {
-  title: string
-  description: string
-  author: string
-  datePublished: string
-  url: string
-  image?: string
-}): Record<string, unknown> {
-  return {
-    '@context': 'https://schema.org',
-    '@type': 'Article',
-    ...data,
-  }
-}
-
-export function productSchema(data: {
-  name: string
-  description: string
-  price: number
-  currency: string
-  url: string
-  image?: string
-}): Record<string, unknown> {
-  return {
-    '@context': 'https://schema.org',
-    '@type': 'Product',
-    name: data.name,
-    description: data.description,
-    url: data.url,
-    image: data.image,
-    offers: {
-      '@type': 'Offer',
-      price: data.price,
-      priceCurrency: data.currency,
-    },
-  }
-}
-
-export function orgSchema(data: {
-  name: string
-  url: string
-  logo?: string
-  sameAs?: string[]
-}): Record<string, unknown> {
-  return {
-    '@context': 'https://schema.org',
-    '@type': 'Organization',
-    ...data,
-  }
-}
-
-export function breadcrumbSchema(items: {
-  name: string
-  url: string
-}[]): Record<string, unknown> {
-  return {
-    '@context': 'https://schema.org',
-    '@type': 'BreadcrumbList',
-    itemListElement: items.map((item, i) => ({
-      '@type': 'ListItem',
-      position: i + 1,
-      name: item.name,
-      item: item.url,
-    })),
-  }
-}
-
-export function faqSchema(items: {
-  question: string
-  answer: string
-}[]): Record<string, unknown> {
-  return {
-    '@context': 'https://schema.org',
-    '@type': 'FAQPage',
-    mainEntity: items.map((q) => ({
-      '@type': 'Question',
-      name: q.question,
-      acceptedAnswer: {
-        '@type': 'Answer',
-        text: q.answer,
-      },
-    })),
-  }
-}
-
-export function buildCanonical(path: string, baseUrl: string): string {
-  return `${baseUrl.replace(/\/$/, '')}/${path.replace(/^\//, '')}`
-}
-
-export function buildAlternates(
-  locales: string[],
-  baseUrl: string,
-  path: string,
-): Record<string, string> {
-  return Object.fromEntries(locales.map((l) => [l, `${baseUrl}/${l}${path}`]))
-}
-
-export function generateRobotsTxt(config: RobotsTxt): string {
-  const lines = ['User-agent: *']
-  config.allow.forEach((p) => lines.push(`Allow: ${p}`))
-  config.disallow.forEach((p) => lines.push(`Disallow: ${p}`))
-  if (config.sitemap) lines.push(`Sitemap: ${config.sitemap}`)
-  return lines.join('\n')
-}
-
-export function generateSitemapXml(entries: SitemapEntry[]): string {
-  const urls = entries
-    .map(
-      (e) =>
-        `  <url>\n    <loc>${e.url}</loc>${e.lastmod ? `\n    <lastmod>${e.lastmod}</lastmod>` : ''}${e.changefreq ? `\n    <changefreq>${e.changefreq}</changefreq>` : ''}${e.priority !== undefined ? `\n    <priority>${e.priority}</priority>` : ''}\n  </url>`,
-    )
-    .join('\n')
-  return `<?xml version="1.0" encoding="UTF-8"?>\n<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">\n${urls}\n</urlset>`
-}
-
-export function estimateReadingTime(content: string): number {
-  return Math.ceil(content.split(/\s+/).length / 200)
-}
-
-export function calcSEOScore(meta: SEOMeta): {
-  score: number
-  issues: string[]
-} {
-  const issues: string[] = []
-
-  if (!meta.title || meta.title.length < 10) issues.push('Title too short (< 10 chars)')
-  if (meta.title && meta.title.length > 60) issues.push('Title too long (> 60 chars)')
-  if (!meta.description || meta.description.length < 50)
-    issues.push('Description too short (< 50 chars)')
-  if (meta.description && meta.description.length > 160)
-    issues.push('Description too long (> 160 chars)')
-  if (!meta.keywords || meta.keywords.length === 0) issues.push('No keywords specified')
-  if (!meta.canonical) issues.push('No canonical URL')
-  if (!meta.og.image) issues.push('No OG image')
-  if (!meta.twitter.image) issues.push('No Twitter image')
-
-  const score = Math.max(0, 100 - issues.length * 12)
-  return { score, issues }
-}

package/packages/shared/tsconfig.json

@@ -1,18 +0,0 @@
-{
-  "extends": "../../tsconfig.json",
-  "compilerOptions": {
-    "outDir": "dist",
-    "rootDir": "src",
-    "strict": true,
-    "skipLibCheck": true,
-    "forceConsistentCasingInFileNames": true,
-    "resolveJsonModule": true,
-    "isolatedModules": true,
-    "target": "ES2022",
-    "module": "ESNext",
-    "moduleResolution": "bundler"
-  },
-  "include": [
-    "src"
-  ]
-}

package/packages/shared/tsup.config.ts

@@ -1,11 +0,0 @@
-import { defineConfig } from 'tsup'
-
-export default defineConfig({
-    entry: { index: 'src/index.ts' },
-    outDir: 'dist',
-    format: ['esm'],
-    dts: true,
-    sourcemap: true,
-    clean: true,
-    treeshake: true,
-})

package/packages/shared/vitest.config.ts

@@ -1,4 +0,0 @@
-import { defineConfig } from 'vitest/config'
-export default defineConfig({
-  test: { globals: true, environment: 'node' },
-})

package/packages/solidjs/package.json

@@ -1,45 +0,0 @@
-{
-  "name": "@geenius-seo/solidjs",
-  "version": "0.1.0",
-  "private": false,
-  "type": "module",
-  "description": "Geenius Seo — SolidJS components & primitives",
-  "author": "Antigravity HQ",
-  "license": "MIT",
-  "publishConfig": {
-    "access": "public"
-  },
-  "main": "./dist/index.js",
-  "module": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
-    }
-  },
-  "files": [
-    "dist",
-    "src"
-  ],
-  "scripts": {
-    "build": "tsup",
-    "clean": "rm -rf dist",
-    "type-check": "tsc --noEmit",
-    "prepublishOnly": "pnpm clean && pnpm build"
-  },
-  "dependencies": {
-    "@geenius-seo/shared": "workspace:*"
-  },
-  "devDependencies": {
-    "solid-js": "^1.9.0",
-    "tsup": "^8.5.1",
-    "typescript": "~6.0.2"
-  },
-  "peerDependencies": {
-    "solid-js": "^1.8.0 || ^1.9.0"
-  },
-  "engines": {
-    "node": ">=20.0.0"
-  }
-}

package/packages/solidjs/src/components/ArticleJsonLd.tsx

@@ -1,35 +0,0 @@
-import { createEffect } from 'solid-js'
-import { articleSchema } from '@geenius-seo/shared'
-
-interface ArticleJsonLdProps {
-  title: string
-  description: string
-  author: string
-  datePublished: string
-  url: string
-  image?: string
-}
-
-export function ArticleJsonLd(props: ArticleJsonLdProps) {
-  createEffect(() => {
-    const script = document.createElement('script')
-    script.type = 'application/ld+json'
-    script.textContent = JSON.stringify(
-      articleSchema({
-        title: props.title,
-        description: props.description,
-        author: props.author,
-        datePublished: props.datePublished,
-        url: props.url,
-        image: props.image,
-      }),
-    )
-    document.head.appendChild(script)
-
-    return () => {
-      document.head.removeChild(script)
-    }
-  })
-
-  return null
-}

package/packages/solidjs/src/components/BreadcrumbsJsonLd.tsx

@@ -1,24 +0,0 @@
-import { createEffect } from 'solid-js'
-import { breadcrumbSchema } from '@geenius-seo/shared'
-
-interface BreadcrumbsJsonLdProps {
-  items: {
-    name: string
-    url: string
-  }[]
-}
-
-export function BreadcrumbsJsonLd(props: BreadcrumbsJsonLdProps) {
-  createEffect(() => {
-    const script = document.createElement('script')
-    script.type = 'application/ld+json'
-    script.textContent = JSON.stringify(breadcrumbSchema(props.items))
-    document.head.appendChild(script)
-
-    return () => {
-      document.head.removeChild(script)
-    }
-  })
-
-  return null
-}

package/packages/solidjs/src/components/MetaEditor.tsx

@@ -1,155 +0,0 @@
-import { createSignal } from 'solid-js'
-import type { SEOMeta } from '@geenius-seo/shared'
-
-interface MetaEditorProps {
-  meta: SEOMeta
-  onChange: (meta: SEOMeta) => void
-}
-
-export function MetaEditor(props: MetaEditorProps) {
-  const [localMeta, setLocalMeta] = createSignal(props.meta)
-
-  const handleChange = (updates: Partial<SEOMeta>) => {
-    const updated = { ...localMeta(), ...updates }
-    setLocalMeta(updated)
-    props.onChange(updated)
-  }
-
-  return (
-    <div class="space-y-6 p-4 border border-gray-200 rounded">
-      {/* Title */}
-      <div>
-        <label class="block text-sm font-semibold text-gray-900 mb-1">
-          Title {localMeta().title.length}/60
-        </label>
-        <input
-          type="text"
-          value={localMeta().title}
-          onInput={(e) =>
-            handleChange({
-              title: e.currentTarget.value.slice(0, 60),
-            })
-          }
-          class="w-full px-3 py-2 border border-gray-300 rounded text-sm"
-          placeholder="Page title"
-        />
-        <p class="text-xs text-gray-500 mt-1">
-          {localMeta().title.length < 30
-            ? 'Too short'
-            : localMeta().title.length > 60
-              ? 'Too long'
-              : 'Good length'}
-        </p>
-      </div>
-
-      {/* Description */}
-      <div>
-        <label class="block text-sm font-semibold text-gray-900 mb-1">
-          Description {localMeta().description.length}/160
-        </label>
-        <textarea
-          value={localMeta().description}
-          onInput={(e) =>
-            handleChange({
-              description: e.currentTarget.value.slice(0, 160),
-            })
-          }
-          class="w-full px-3 py-2 border border-gray-300 rounded text-sm"
-          rows={3}
-          placeholder="Page description"
-        />
-        <p class="text-xs text-gray-500 mt-1">
-          {localMeta().description.length < 50
-            ? 'Too short'
-            : localMeta().description.length > 160
-              ? 'Too long'
-              : 'Good length'}
-        </p>
-      </div>
-
-      {/* Keywords */}
-      <div>
-        <label class="block text-sm font-semibold text-gray-900 mb-1">Keywords</label>
-        <input
-          type="text"
-          value={localMeta().keywords.join(', ')}
-          onInput={(e) =>
-            handleChange({
-              keywords: e.currentTarget.value.split(',').map((k) => k.trim()),
-            })
-          }
-          class="w-full px-3 py-2 border border-gray-300 rounded text-sm"
-          placeholder="keyword1, keyword2, keyword3"
-        />
-      </div>
-
-      {/* Canonical */}
-      <div>
-        <label class="block text-sm font-semibold text-gray-900 mb-1">Canonical URL</label>
-        <input
-          type="url"
-          value={localMeta().canonical || ''}
-          onInput={(e) =>
-            handleChange({
-              canonical: e.currentTarget.value,
-            })
-          }
-          class="w-full px-3 py-2 border border-gray-300 rounded text-sm"
-          placeholder="https://example.com/page"
-        />
-      </div>
-
-      {/* OG Image */}
-      <div>
-        <label class="block text-sm font-semibold text-gray-900 mb-1">OG Image URL</label>
-        <input
-          type="url"
-          value={localMeta().og.image || ''}
-          onInput={(e) =>
-            handleChange({
-              og: { ...localMeta().og, image: e.currentTarget.value },
-            })
-          }
-          class="w-full px-3 py-2 border border-gray-300 rounded text-sm"
-          placeholder="https://example.com/image.jpg"
-        />
-      </div>
-
-      {/* Twitter Card */}
-      <div>
-        <label class="block text-sm font-semibold text-gray-900 mb-1">Twitter Card Type</label>
-        <select
-          value={localMeta().twitter.card}
-          onChange={(e) =>
-            handleChange({
-              twitter: {
-                ...localMeta().twitter,
-                card: e.currentTarget.value as 'summary' | 'summary_large_image',
-              },
-            })
-          }
-          class="w-full px-3 py-2 border border-gray-300 rounded text-sm"
-        >
-          <option value="summary">Summary</option>
-          <option value="summary_large_image">Summary Large Image</option>
-        </select>
-      </div>
-
-      {/* Robots */}
-      <div>
-        <label class="block text-sm font-semibold text-gray-900 mb-1">Robots Directive</label>
-        <input
-          type="text"
-          value={localMeta().robots || ''}
-          onInput={(e) =>
-            handleChange({
-              robots: e.currentTarget.value,
-            })
-          }
-          class="w-full px-3 py-2 border border-gray-300 rounded text-sm"
-          placeholder="index, follow"
-        />
-      </div>
-    </div>
-  )
-}

package/packages/solidjs/src/components/SEOHead.tsx

@@ -1,109 +0,0 @@
-import { createEffect } from 'solid-js'
-import type { SEOMeta } from '@geenius-seo/shared'
-
-interface SEOHeadProps {
-  meta: SEOMeta
-}
-
-export function SEOHead(props: SEOHeadProps) {
-  createEffect(() => {
-    const meta = props.meta
-
-    // Set title
-    document.title = meta.title
-
-    // Set meta tags
-    const setMetaTag = (name: string, content: string, isProperty = false) => {
-      let tag = document.querySelector(
-        `meta[${isProperty ? 'property' : 'name'}="${name}"]`,
-      ) as HTMLMetaElement
-      if (!tag) {
-        tag = document.createElement('meta')
-        isProperty ? tag.setAttribute('property', name) : tag.setAttribute('name', name)
-        document.head.appendChild(tag)
-      }
-      tag.content = content
-    }
-
-    // Description
-    setMetaTag('description', meta.description)
-
-    // Keywords
-    if (meta.keywords.length > 0) {
-      setMetaTag('keywords', meta.keywords.join(', '))
-    }
-
-    // Robots
-    if (meta.robots) {
-      setMetaTag('robots', meta.robots)
-    }
-
-    // OG tags
-    setMetaTag('og:title', meta.og.title, true)
-    setMetaTag('og:description', meta.og.description, true)
-    if (meta.og.image) {
-      setMetaTag('og:image', meta.og.image, true)
-      if (meta.og.imageAlt) {
-        setMetaTag('og:image:alt', meta.og.imageAlt, true)
-      }
-    }
-    setMetaTag('og:type', meta.og.type, true)
-    setMetaTag('og:url', meta.og.url, true)
-    if (meta.og.siteName) {
-      setMetaTag('og:site_name', meta.og.siteName, true)
-    }
-
-    // Twitter tags
-    setMetaTag('twitter:card', meta.twitter.card)
-    setMetaTag('twitter:title', meta.twitter.title)
-    setMetaTag('twitter:description', meta.twitter.description)
-    if (meta.twitter.image) {
-      setMetaTag('twitter:image', meta.twitter.image)
-    }
-    if (meta.twitter.creator) {
-      setMetaTag('twitter:creator', meta.twitter.creator)
-    }
-
-    // Canonical
-    if (meta.canonical) {
-      let canonicalLink = document.querySelector('link[rel="canonical"]') as HTMLLinkElement
-      if (!canonicalLink) {
-        canonicalLink = document.createElement('link')
-        canonicalLink.rel = 'canonical'
-        document.head.appendChild(canonicalLink)
-      }
-      canonicalLink.href = meta.canonical
-    }
-
-    // Alternates
-    if (meta.alternates) {
-      Object.entries(meta.alternates).forEach(([lang, url]) => {
-        let altLink = document.querySelector(
-          `link[rel="alternate"][hreflang="${lang}"]`,
-        ) as HTMLLinkElement
-        if (!altLink) {
-          altLink = document.createElement('link')
-          altLink.rel = 'alternate'
-          altLink.hrefLang = lang
-          document.head.appendChild(altLink)
-        }
-        altLink.href = url
-      })
-    }
-
-    // JSON-LD
-    if (meta.jsonLd && meta.jsonLd.length > 0) {
-      meta.jsonLd.forEach((schema) => {
-        let script = document.querySelector('script[type="application/ld+json"]') as HTMLScriptElement
-        if (!script) {
-          script = document.createElement('script')
-          script.type = 'application/ld+json'
-          document.head.appendChild(script)
-        }
-        script.textContent = JSON.stringify(schema)
-      })
-    }
-  })
-
-  return null
-}

package/packages/solidjs/src/components/SEOPreview.tsx

@@ -1,42 +0,0 @@
-import type { SEOMeta } from '@geenius-seo/shared'
-
-interface SEOPreviewProps {
-  meta: SEOMeta
-}
-
-export function SEOPreview(props: SEOPreviewProps) {
-  return (
-    <div class="space-y-6">
-      {/* Google SERP Preview */}
-      <div class="space-y-2">
-        <h3 class="text-sm font-semibold text-gray-700">Google Search Preview</h3>
-        <div class="bg-white p-4 rounded border border-gray-200">
-          <div class="text-xs text-green-700">{new URL(props.meta.og.url).hostname}</div>
-          <div class="text-lg text-blue-600 hover:underline cursor-pointer truncate">
-            {props.meta.title}
-          </div>
-          <div class="text-sm text-gray-600 line-clamp-2">{props.meta.description}</div>
-        </div>
-      </div>
-
-      {/* Social Media Preview */}
-      <div class="space-y-2">
-        <h3 class="text-sm font-semibold text-gray-700">Social Media Preview</h3>
-        <div class="bg-gray-900 rounded overflow-hidden max-w-sm">
-          {props.meta.og.image && (
-            <img
-              src={props.meta.og.image}
-              alt={props.meta.og.imageAlt || props.meta.og.title}
-              class="w-full h-48 object-cover"
-            />
-          )}
-          <div class="p-3 text-white">
-            <div class="font-semibold text-sm truncate">{props.meta.og.title}</div>
-            <div class="text-xs text-gray-400 line-clamp-2">{props.meta.og.description}</div>
-            <div class="text-xs text-gray-500 mt-1 truncate">{props.meta.og.url}</div>
-          </div>
-        </div>
-      </div>
-    </div>
-  )
-}