@bytesbrains/weblocks 0.6.2 → 0.7.0

package/lib/verticals.js

@@ -0,0 +1,117 @@
+/**
+ * Business **verticals** (§ AiToolK.it#154 / weblocks#30) — a small, stable
+ * taxonomy that gives generation a sense of what KIND of site it's making.
+ *
+ * Each vertical maps to its recommended section set (in order), a design-token
+ * preset that fits the mood, a copy-tone hint, and whether it's booking-driven.
+ * Hosts should read `verticalNames()` rather than hardcode their own list, and
+ * generation can seed a brief's default sections + preset from the chosen one.
+ *
+ * Additive + stable: add verticals freely, but do NOT rename or repurpose an
+ * existing `id` — hosts persist it (e.g. as `businessType`). Every `blocks`
+ * entry must be a real catalog block type (see `verticals.test.ts`).
+ */
+const VERTICAL_DEFS = {
+    restaurant: {
+        id: 'restaurant', label: 'Restaurant & Café', icon: 'restaurant', preset: 'sand',
+        tone: 'warm, appetising, inviting',
+        blocks: ['nav', 'hero', 'services-catalogue', 'gallery', 'testimonials', 'contact-details', 'cta', 'footer'],
+    },
+    retail: {
+        id: 'retail', label: 'Retail Shop', icon: 'storefront', preset: 'sand',
+        tone: 'friendly, local, trustworthy',
+        blocks: ['nav', 'hero', 'gallery', 'services-catalogue', 'testimonials', 'contact-details', 'footer'],
+    },
+    salon: {
+        id: 'salon', label: 'Salon & Spa', icon: 'spa', preset: 'candy', booking: true,
+        tone: 'calm, pampering, premium',
+        blocks: ['nav', 'hero', 'services-catalogue', 'gallery', 'testimonials', 'contact-details', 'cta', 'footer'],
+    },
+    fitness: {
+        id: 'fitness', label: 'Gym & Fitness', icon: 'fitness_center', preset: 'midnight', booking: true,
+        tone: 'energetic, motivating, bold',
+        blocks: ['nav', 'hero', 'features', 'pricing', 'team', 'testimonials', 'cta', 'contact-details', 'footer'],
+    },
+    education: {
+        id: 'education', label: 'Education & Coaching', icon: 'school', preset: 'ocean',
+        tone: 'credible, encouraging, clear',
+        blocks: ['nav', 'hero', 'features', 'steps', 'pricing', 'faq', 'testimonials', 'cta', 'contact-details', 'footer'],
+    },
+    healthcare: {
+        id: 'healthcare', label: 'Healthcare & Clinic', icon: 'medical_services', preset: 'ocean', booking: true,
+        tone: 'reassuring, professional, calm',
+        blocks: ['nav', 'hero', 'services-catalogue', 'team', 'faq', 'cta', 'contact-details', 'footer'],
+    },
+    manufacturing: {
+        id: 'manufacturing', label: 'Manufacturing', icon: 'precision_manufacturing', preset: 'ocean',
+        tone: 'industrial, capable, precise',
+        blocks: ['nav', 'hero', 'features', 'stats', 'logos', 'services-catalogue', 'contact-details', 'footer'],
+    },
+    ecommerce: {
+        id: 'ecommerce', label: 'E-commerce', icon: 'shopping_bag', preset: 'midnight',
+        tone: 'punchy, product-first, converting',
+        blocks: ['nav', 'hero', 'gallery', 'features', 'pricing', 'testimonials', 'faq', 'cta', 'footer'],
+    },
+    service: {
+        id: 'service', label: 'Service Business', icon: 'handyman', preset: 'forest',
+        tone: 'dependable, straightforward, local',
+        blocks: ['nav', 'hero', 'features', 'steps', 'testimonials', 'faq', 'cta', 'contact-details', 'footer'],
+    },
+    franchise: {
+        id: 'franchise', label: 'Franchise', icon: 'hub', preset: 'ocean',
+        tone: 'proven, opportunity-led, confident',
+        blocks: ['nav', 'hero', 'stats', 'features', 'steps', 'testimonials', 'cta', 'contact-details', 'footer'],
+    },
+    hospitality: {
+        id: 'hospitality', label: 'Hotel & Hospitality', icon: 'hotel', preset: 'forest', booking: true,
+        tone: 'welcoming, restful, refined',
+        blocks: ['nav', 'hero', 'gallery', 'features', 'services-catalogue', 'testimonials', 'contact-details', 'cta', 'footer'],
+    },
+    realestate: {
+        id: 'realestate', label: 'Real Estate', icon: 'real_estate_agent', preset: 'ocean',
+        tone: 'aspirational, trustworthy, local',
+        blocks: ['nav', 'hero', 'gallery', 'features', 'stats', 'team', 'testimonials', 'contact-details', 'cta', 'footer'],
+    },
+    personal: {
+        id: 'personal', label: 'Personal / Portfolio', icon: 'person', preset: 'mono',
+        tone: 'personal, confident, uncluttered',
+        blocks: ['nav', 'profile-header', 'experience', 'skills', 'timeline', 'gallery', 'testimonials', 'contact-details', 'footer'],
+    },
+    tech: {
+        id: 'tech', label: 'Technology / SaaS', icon: 'rocket_launch', preset: 'midnight',
+        tone: 'sharp, modern, benefit-led',
+        blocks: ['nav', 'hero-app', 'features', 'stats', 'pricing', 'logos', 'faq', 'cta', 'footer'],
+    },
+    events: {
+        id: 'events', label: 'Events & Weddings', icon: 'celebration', preset: 'candy', booking: true,
+        tone: 'joyful, elegant, memorable',
+        blocks: ['nav', 'hero', 'timeline', 'gallery', 'faq', 'contact-details', 'cta', 'footer'],
+    },
+    nonprofit: {
+        id: 'nonprofit', label: 'Nonprofit / Community', icon: 'volunteer_activism', preset: 'forest',
+        tone: 'heartfelt, purposeful, mobilising',
+        blocks: ['nav', 'hero', 'about', 'stats', 'steps', 'team', 'testimonials', 'cta', 'footer'],
+    },
+    other: {
+        id: 'other', label: 'Other', icon: 'category', preset: 'sand',
+        tone: 'clear, neutral, professional',
+        blocks: ['nav', 'hero', 'features', 'contact-details', 'footer'],
+    },
+};
+/**
+ * Deep-frozen so a vertical (which is interpolated into the AI system prompt)
+ * cannot be mutated at runtime — `getVertical` hands out an immutable snapshot,
+ * keeping the prompt's integrity even if a dependency tries to tamper with it.
+ */
+export const VERTICALS = Object.freeze(Object.fromEntries(Object.entries(VERTICAL_DEFS).map(([id, v]) => {
+    Object.freeze(v.blocks);
+    return [id, Object.freeze(v)];
+})));
+/** Vertical ids the AI / a host picker may choose from. */
+export function verticalNames() {
+    return Object.keys(VERTICALS);
+}
+/** A vertical by id, or `undefined` if unknown (host should fall back to `other`). */
+export function getVertical(id) {
+    return VERTICALS[id];
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bytesbrains/weblocks",
-  "version": "0.6.2",
+  "version": "0.7.0",
   "description": "Block engine for AI-composable web apps — the AI composes a SiteManifest from a fixed block catalog; the engine validates and renders it to static HTML. Snap-together \"Lego\" web building blocks, shareable across repos.",
   "keywords": [
     "ai",
@@ -62,6 +62,7 @@
     "test": "npm run build && node --test lib/*.test.js test/*.mjs",
     "example": "tsc -p tsconfig.json && node lib/example.js",
     "example:resume": "tsc -p tsconfig.json && node lib/example-resume.js",
+    "example:templates": "tsc -p tsconfig.json && node lib/example-templates.js",
     "ai": "tsc -p tsconfig.json && node scripts/ai-run.mjs",
     "prepare": "npm run build",
     "prepublishOnly": "npm run build && npm run emit:catalog && npm test"