@ucptools/validator 1.0.0 → 1.1.0

package/docs/BRAND-STYLE-GUIDE.md

@@ -1,356 +0,0 @@
-# UCP.tools Brand Style Guide
-
-Comprehensive brand guidelines based on the official logo.
-
----
-
-## 1. LOGO
-
-### Primary Logo
-- File: `public/logo.jpeg`
-- Usage: App icons, favicons, social media avatars
-- Concept: Shopping bag with checkmark = "validated commerce"
-
-### Logo Variations
-| Variant | Use Case |
-|---------|----------|
-| Full color | Primary use, light backgrounds |
-| White | Dark backgrounds, overlays |
-| Monochrome | Print, low-color contexts |
-
-### Clear Space
-Maintain padding equal to the height of the bag handle on all sides.
-
-### Minimum Size
-- Digital: 32x32px minimum
-- Print: 0.5 inch minimum
-
----
-
-## 2. COLOR PALETTE
-
-### Primary Colors (from logo gradient)
-
-| Name | Hex | RGB | Usage |
-|------|-----|-----|-------|
-| **Blue** | `#2E86AB` | rgb(46, 134, 171) | Primary actions, links |
-| **Teal** | `#36B5A2` | rgb(54, 181, 162) | Gradient midpoint, accents |
-| **Green** | `#47C97A` | rgb(71, 201, 122) | Success states, validation |
-
-### Brand Gradient
-```css
-background: linear-gradient(135deg, #2E86AB 0%, #36B5A2 50%, #47C97A 100%);
-```
-
-### Secondary Colors
-
-| Name | Hex | Usage |
-|------|-----|-------|
-| **Dark** | `#1A2B3C` | Text, headings |
-| **Medium** | `#5A6978` | Secondary text |
-| **Light** | `#94A3B8` | Muted text, placeholders |
-| **Border** | `#E2E8F0` | Dividers, borders |
-| **Background** | `#F8FAFC` | Page background |
-| **Card** | `#FFFFFF` | Card backgrounds |
-
-### Semantic Colors
-
-| Name | Hex | Usage |
-|------|-----|-------|
-| **Success** | `#47C97A` | Valid, success states |
-| **Warning** | `#F59E0B` | Warnings, caution |
-| **Error** | `#EF4444` | Errors, invalid states |
-| **Info** | `#2E86AB` | Information, tips |
-
-### Grade Colors
-
-| Grade | Background | Text |
-|-------|------------|------|
-| A | `#DCFCE7` | `#16A34A` |
-| B | `#DBEAFE` | `#2563EB` |
-| C | `#FEF9C3` | `#CA8A04` |
-| D | `#FED7AA` | `#EA580C` |
-| F | `#FEE2E2` | `#DC2626` |
-
----
-
-## 3. TYPOGRAPHY
-
-### Font Stack
-```css
-font-family: 'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
-```
-
-### Type Scale
-
-| Element | Size | Weight | Line Height |
-|---------|------|--------|-------------|
-| H1 | 48px / 3rem | 700 | 1.2 |
-| H2 | 36px / 2.25rem | 700 | 1.25 |
-| H3 | 24px / 1.5rem | 600 | 1.3 |
-| H4 | 20px / 1.25rem | 600 | 1.4 |
-| Body | 16px / 1rem | 400 | 1.6 |
-| Small | 14px / 0.875rem | 400 | 1.5 |
-| Caption | 12px / 0.75rem | 500 | 1.4 |
-
-### Logo Typography
-```css
-.logo {
-  font-size: 24px;
-  font-weight: 700;
-  background: linear-gradient(135deg, #2E86AB, #47C97A);
-  -webkit-background-clip: text;
-  -webkit-text-fill-color: transparent;
-}
-.logo .suffix {
-  font-weight: 400;
-  color: #5A6978;
-}
-```
-
----
-
-## 4. SPACING
-
-### Base Unit
-8px grid system
-
-| Token | Value | Usage |
-|-------|-------|-------|
-| `--space-1` | 4px | Tight spacing |
-| `--space-2` | 8px | Default gap |
-| `--space-3` | 12px | Small padding |
-| `--space-4` | 16px | Medium padding |
-| `--space-5` | 20px | Form groups |
-| `--space-6` | 24px | Section gaps |
-| `--space-8` | 32px | Card padding |
-| `--space-10` | 40px | Section padding |
-| `--space-12` | 48px | Large sections |
-| `--space-16` | 64px | Hero sections |
-
----
-
-## 5. BORDER RADIUS
-
-| Token | Value | Usage |
-|-------|-------|-------|
-| `--radius-sm` | 4px | Small elements, badges |
-| `--radius-md` | 8px | Buttons, inputs |
-| `--radius-lg` | 12px | Cards |
-| `--radius-xl` | 16px | Modals |
-| `--radius-full` | 9999px | Pills, avatars |
-
----
-
-## 6. SHADOWS
-
-```css
---shadow-sm: 0 1px 2px rgba(0, 0, 0, 0.05);
---shadow-md: 0 4px 6px -1px rgba(0, 0, 0, 0.1), 0 2px 4px -2px rgba(0, 0, 0, 0.1);
---shadow-lg: 0 10px 15px -3px rgba(0, 0, 0, 0.1), 0 4px 6px -4px rgba(0, 0, 0, 0.1);
---shadow-xl: 0 20px 25px -5px rgba(0, 0, 0, 0.1), 0 8px 10px -6px rgba(0, 0, 0, 0.1);
-```
-
----
-
-## 7. COMPONENTS
-
-### Buttons
-
-#### Primary Button
-```css
-.btn-primary {
-  background: linear-gradient(135deg, #2E86AB, #36B5A2);
-  color: white;
-  padding: 12px 24px;
-  border-radius: 8px;
-  font-weight: 600;
-  border: none;
-  cursor: pointer;
-  transition: transform 0.2s, box-shadow 0.2s;
-}
-.btn-primary:hover {
-  transform: translateY(-1px);
-  box-shadow: 0 4px 12px rgba(46, 134, 171, 0.4);
-}
-```
-
-#### Secondary Button
-```css
-.btn-secondary {
-  background: white;
-  color: #1A2B3C;
-  padding: 12px 24px;
-  border-radius: 8px;
-  font-weight: 600;
-  border: 2px solid #E2E8F0;
-  cursor: pointer;
-}
-.btn-secondary:hover {
-  border-color: #2E86AB;
-  color: #2E86AB;
-}
-```
-
-### Cards
-```css
-.card {
-  background: white;
-  border-radius: 12px;
-  padding: 32px;
-  box-shadow: 0 1px 3px rgba(0, 0, 0, 0.1);
-  border: 1px solid #E2E8F0;
-}
-```
-
-### Input Fields
-```css
-input, select, textarea {
-  width: 100%;
-  padding: 12px 16px;
-  border: 2px solid #E2E8F0;
-  border-radius: 8px;
-  font-size: 16px;
-  transition: border-color 0.2s, box-shadow 0.2s;
-}
-input:focus {
-  outline: none;
-  border-color: #2E86AB;
-  box-shadow: 0 0 0 3px rgba(46, 134, 171, 0.1);
-}
-```
-
-### Grade Badges
-```css
-.grade-badge {
-  display: inline-flex;
-  align-items: center;
-  gap: 8px;
-  padding: 8px 16px;
-  border-radius: 20px;
-  font-weight: 700;
-  font-size: 18px;
-}
-```
-
----
-
-## 8. ICONOGRAPHY
-
-### Style Guidelines
-- Line weight: 2px stroke
-- Corner radius: Rounded caps and joins
-- Size: 24x24px default, 20x20px small, 32x32px large
-
-### Common Icons
-| Icon | Usage |
-|------|-------|
-| Checkmark | Success, valid, complete |
-| X/Cross | Error, invalid, close |
-| Warning triangle | Warnings, caution |
-| Info circle | Information, tips |
-| Shopping bag | Commerce, UCP |
-| Shield | Security, validation |
-
----
-
-## 9. MOTION
-
-### Transitions
-```css
---transition-fast: 150ms ease;
---transition-base: 200ms ease;
---transition-slow: 300ms ease;
-```
-
-### Hover Effects
-- Buttons: `translateY(-1px)` + shadow increase
-- Cards: `translateY(-2px)` + shadow increase
-- Links: Color change only
-
----
-
-## 10. RESPONSIVE BREAKPOINTS
-
-| Name | Width | Usage |
-|------|-------|-------|
-| Mobile | < 640px | Single column |
-| Tablet | 640-1024px | Two columns |
-| Desktop | > 1024px | Full layout |
-
----
-
-## 11. VOICE & TONE
-
-### Brand Voice
-- **Developer-first**: Technical but accessible
-- **Direct**: Clear, no fluff
-- **Helpful**: Solution-oriented
-- **Independent**: Not affiliated with Google/Shopify
-
-### Writing Guidelines
-- Use active voice
-- Lead with benefits
-- Include code examples
-- Avoid jargon unless necessary
-
-### Example Copy
-
-**Headlines:**
-- "Get ready for AI commerce"
-- "Validate your UCP profile"
-- "Check your AI commerce readiness"
-
-**CTAs:**
-- "Validate Now"
-- "Generate Profile"
-- "Get Started"
-
----
-
-## 12. FILE ASSETS
-
-### Required Files
-```
-public/
-├── logo.jpeg           # Primary logo (square)
-├── logo-white.png      # White version for dark bg
-├── favicon.ico         # Browser favicon
-├── favicon-32x32.png   # 32px favicon
-├── favicon-16x16.png   # 16px favicon
-├── apple-touch-icon.png # 180x180 iOS icon
-├── og-image.png        # 1200x630 social share
-└── brand.css           # CSS design tokens
-```
-
----
-
-## 13. CSS DESIGN TOKENS
-
-See `public/brand.css` for the complete implementation of all design tokens as CSS custom properties.
-
----
-
-## 14. USAGE EXAMPLES
-
-### Hero Section
-```html
-<section class="hero">
-  <h1>UCP Profile <span class="gradient-text">Validator</span></h1>
-  <p>Check if your store is ready for AI shopping agents</p>
-  <button class="btn-primary">Validate Now</button>
-</section>
-```
-
-### Gradient Text
-```css
-.gradient-text {
-  background: linear-gradient(135deg, #2E86AB, #47C97A);
-  -webkit-background-clip: text;
-  -webkit-text-fill-color: transparent;
-}
-```
-
----
-
-*Last updated: January 2026*

package/drizzle/0000_black_king_cobra.sql

@@ -1,39 +0,0 @@
-CREATE TABLE "benchmark_stats" (
-	"id" integer PRIMARY KEY GENERATED ALWAYS AS IDENTITY (sequence name "benchmark_stats_id_seq" INCREMENT BY 1 MINVALUE 1 MAXVALUE 2147483647 START WITH 1 CACHE 1),
-	"score_bucket" integer NOT NULL,
-	"count" integer DEFAULT 0 NOT NULL,
-	CONSTRAINT "benchmark_stats_score_bucket_unique" UNIQUE("score_bucket")
-);
---> statement-breakpoint
-CREATE TABLE "benchmark_summary" (
-	"id" integer PRIMARY KEY DEFAULT 1 NOT NULL,
-	"total_validations" integer DEFAULT 0 NOT NULL,
-	"avg_score" numeric(5, 2) DEFAULT '0',
-	"updated_at" timestamp DEFAULT now() NOT NULL
-);
---> statement-breakpoint
-CREATE TABLE "merchants" (
-	"id" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,
-	"domain" varchar(255) NOT NULL,
-	"display_name" varchar(255) NOT NULL,
-	"description" text,
-	"logo_url" varchar(512),
-	"website_url" varchar(512),
-	"category" varchar(100),
-	"country_code" varchar(2),
-	"ucp_score" integer,
-	"ucp_grade" varchar(2),
-	"transports" varchar(255),
-	"is_public" boolean DEFAULT true NOT NULL,
-	"is_verified" boolean DEFAULT false NOT NULL,
-	"last_validated_at" timestamp,
-	"created_at" timestamp DEFAULT now() NOT NULL,
-	"updated_at" timestamp DEFAULT now() NOT NULL,
-	CONSTRAINT "merchants_domain_unique" UNIQUE("domain")
-);
---> statement-breakpoint
-CREATE INDEX "idx_merchants_domain" ON "merchants" USING btree ("domain");--> statement-breakpoint
-CREATE INDEX "idx_merchants_category" ON "merchants" USING btree ("category");--> statement-breakpoint
-CREATE INDEX "idx_merchants_country" ON "merchants" USING btree ("country_code");--> statement-breakpoint
-CREATE INDEX "idx_merchants_score" ON "merchants" USING btree ("ucp_score");--> statement-breakpoint
-CREATE INDEX "idx_merchants_public" ON "merchants" USING btree ("is_public");

package/drizzle/meta/0000_snapshot.json

@@ -1,309 +0,0 @@
-{
-  "id": "f7439a2c-cb5b-4649-b69f-738b854831e5",
-  "prevId": "00000000-0000-0000-0000-000000000000",
-  "version": "7",
-  "dialect": "postgresql",
-  "tables": {
-    "public.benchmark_stats": {
-      "name": "benchmark_stats",
-      "schema": "",
-      "columns": {
-        "id": {
-          "name": "id",
-          "type": "integer",
-          "primaryKey": true,
-          "notNull": true,
-          "identity": {
-            "type": "always",
-            "name": "benchmark_stats_id_seq",
-            "schema": "public",
-            "increment": "1",
-            "startWith": "1",
-            "minValue": "1",
-            "maxValue": "2147483647",
-            "cache": "1",
-            "cycle": false
-          }
-        },
-        "score_bucket": {
-          "name": "score_bucket",
-          "type": "integer",
-          "primaryKey": false,
-          "notNull": true
-        },
-        "count": {
-          "name": "count",
-          "type": "integer",
-          "primaryKey": false,
-          "notNull": true,
-          "default": 0
-        }
-      },
-      "indexes": {},
-      "foreignKeys": {},
-      "compositePrimaryKeys": {},
-      "uniqueConstraints": {
-        "benchmark_stats_score_bucket_unique": {
-          "name": "benchmark_stats_score_bucket_unique",
-          "nullsNotDistinct": false,
-          "columns": [
-            "score_bucket"
-          ]
-        }
-      },
-      "policies": {},
-      "checkConstraints": {},
-      "isRLSEnabled": false
-    },
-    "public.benchmark_summary": {
-      "name": "benchmark_summary",
-      "schema": "",
-      "columns": {
-        "id": {
-          "name": "id",
-          "type": "integer",
-          "primaryKey": true,
-          "notNull": true,
-          "default": 1
-        },
-        "total_validations": {
-          "name": "total_validations",
-          "type": "integer",
-          "primaryKey": false,
-          "notNull": true,
-          "default": 0
-        },
-        "avg_score": {
-          "name": "avg_score",
-          "type": "numeric(5, 2)",
-          "primaryKey": false,
-          "notNull": false,
-          "default": "'0'"
-        },
-        "updated_at": {
-          "name": "updated_at",
-          "type": "timestamp",
-          "primaryKey": false,
-          "notNull": true,
-          "default": "now()"
-        }
-      },
-      "indexes": {},
-      "foreignKeys": {},
-      "compositePrimaryKeys": {},
-      "uniqueConstraints": {},
-      "policies": {},
-      "checkConstraints": {},
-      "isRLSEnabled": false
-    },
-    "public.merchants": {
-      "name": "merchants",
-      "schema": "",
-      "columns": {
-        "id": {
-          "name": "id",
-          "type": "uuid",
-          "primaryKey": true,
-          "notNull": true,
-          "default": "gen_random_uuid()"
-        },
-        "domain": {
-          "name": "domain",
-          "type": "varchar(255)",
-          "primaryKey": false,
-          "notNull": true
-        },
-        "display_name": {
-          "name": "display_name",
-          "type": "varchar(255)",
-          "primaryKey": false,
-          "notNull": true
-        },
-        "description": {
-          "name": "description",
-          "type": "text",
-          "primaryKey": false,
-          "notNull": false
-        },
-        "logo_url": {
-          "name": "logo_url",
-          "type": "varchar(512)",
-          "primaryKey": false,
-          "notNull": false
-        },
-        "website_url": {
-          "name": "website_url",
-          "type": "varchar(512)",
-          "primaryKey": false,
-          "notNull": false
-        },
-        "category": {
-          "name": "category",
-          "type": "varchar(100)",
-          "primaryKey": false,
-          "notNull": false
-        },
-        "country_code": {
-          "name": "country_code",
-          "type": "varchar(2)",
-          "primaryKey": false,
-          "notNull": false
-        },
-        "ucp_score": {
-          "name": "ucp_score",
-          "type": "integer",
-          "primaryKey": false,
-          "notNull": false
-        },
-        "ucp_grade": {
-          "name": "ucp_grade",
-          "type": "varchar(2)",
-          "primaryKey": false,
-          "notNull": false
-        },
-        "transports": {
-          "name": "transports",
-          "type": "varchar(255)",
-          "primaryKey": false,
-          "notNull": false
-        },
-        "is_public": {
-          "name": "is_public",
-          "type": "boolean",
-          "primaryKey": false,
-          "notNull": true,
-          "default": true
-        },
-        "is_verified": {
-          "name": "is_verified",
-          "type": "boolean",
-          "primaryKey": false,
-          "notNull": true,
-          "default": false
-        },
-        "last_validated_at": {
-          "name": "last_validated_at",
-          "type": "timestamp",
-          "primaryKey": false,
-          "notNull": false
-        },
-        "created_at": {
-          "name": "created_at",
-          "type": "timestamp",
-          "primaryKey": false,
-          "notNull": true,
-          "default": "now()"
-        },
-        "updated_at": {
-          "name": "updated_at",
-          "type": "timestamp",
-          "primaryKey": false,
-          "notNull": true,
-          "default": "now()"
-        }
-      },
-      "indexes": {
-        "idx_merchants_domain": {
-          "name": "idx_merchants_domain",
-          "columns": [
-            {
-              "expression": "domain",
-              "isExpression": false,
-              "asc": true,
-              "nulls": "last"
-            }
-          ],
-          "isUnique": false,
-          "concurrently": false,
-          "method": "btree",
-          "with": {}
-        },
-        "idx_merchants_category": {
-          "name": "idx_merchants_category",
-          "columns": [
-            {
-              "expression": "category",
-              "isExpression": false,
-              "asc": true,
-              "nulls": "last"
-            }
-          ],
-          "isUnique": false,
-          "concurrently": false,
-          "method": "btree",
-          "with": {}
-        },
-        "idx_merchants_country": {
-          "name": "idx_merchants_country",
-          "columns": [
-            {
-              "expression": "country_code",
-              "isExpression": false,
-              "asc": true,
-              "nulls": "last"
-            }
-          ],
-          "isUnique": false,
-          "concurrently": false,
-          "method": "btree",
-          "with": {}
-        },
-        "idx_merchants_score": {
-          "name": "idx_merchants_score",
-          "columns": [
-            {
-              "expression": "ucp_score",
-              "isExpression": false,
-              "asc": true,
-              "nulls": "last"
-            }
-          ],
-          "isUnique": false,
-          "concurrently": false,
-          "method": "btree",
-          "with": {}
-        },
-        "idx_merchants_public": {
-          "name": "idx_merchants_public",
-          "columns": [
-            {
-              "expression": "is_public",
-              "isExpression": false,
-              "asc": true,
-              "nulls": "last"
-            }
-          ],
-          "isUnique": false,
-          "concurrently": false,
-          "method": "btree",
-          "with": {}
-        }
-      },
-      "foreignKeys": {},
-      "compositePrimaryKeys": {},
-      "uniqueConstraints": {
-        "merchants_domain_unique": {
-          "name": "merchants_domain_unique",
-          "nullsNotDistinct": false,
-          "columns": [
-            "domain"
-          ]
-        }
-      },
-      "policies": {},
-      "checkConstraints": {},
-      "isRLSEnabled": false
-    }
-  },
-  "enums": {},
-  "schemas": {},
-  "sequences": {},
-  "roles": {},
-  "policies": {},
-  "views": {},
-  "_meta": {
-    "columns": {},
-    "schemas": {},
-    "tables": {}
-  }
-}

package/drizzle/meta/_journal.json

@@ -1,13 +0,0 @@
-{
-  "version": "7",
-  "dialect": "postgresql",
-  "entries": [
-    {
-      "idx": 0,
-      "version": "7",
-      "when": 1768464233041,
-      "tag": "0000_black_king_cobra",
-      "breakpoints": true
-    }
-  ]
-}