keystone-design-bootstrap 1.0.3

package/src/styles/typography.css

@@ -0,0 +1,430 @@
+.prose:not(:where([class~="not-prose"], [class~="not-prose"] *)) {
+    --tw-prose-body: var(--color-text-tertiary);
+    --tw-prose-headings: var(--color-text-primary);
+    --tw-prose-lead: var(--color-text-tertiary);
+    --tw-prose-links: var(--color-text-tertiary);
+    --tw-prose-bold: var(--color-text-primary);
+    --tw-prose-counters: var(--color-text-tertiary);
+    --tw-prose-bullets: var(--color-text-tertiary);
+    --tw-prose-hr: var(--color-border-secondary);
+    --tw-prose-quotes: var(--color-text-primary);
+    --tw-prose-quote-borders: var(--color-fg-brand-primary_alt);
+    --tw-prose-captions: var(--color-text-tertiary);
+    --tw-prose-code: var(--color-text-tertiary);
+    --tw-prose-pre-code: var(--color-text-tertiary);
+    --tw-prose-pre-bg: var(--color-bg-primary);
+    --tw-prose-th-borders: var(--color-border-primary);
+    --tw-prose-td-borders: var(--color-border-secondary);
+
+    /* Base */
+    color: var(--tw-prose-body);
+    font-size: var(--text-md);
+    line-height: var(--text-md--line-height);
+}
+
+.prose :not(:where([class~="not-prose"], [class~="not-prose"] *)) {
+    /* Text */
+    &:where(p) {
+        margin-top: calc(var(--spacing) * 4);
+        margin-bottom: calc(var(--spacing) * 4);
+    }
+
+    &:where([class~="lead"]) {
+        font-size: var(--text-md);
+        line-height: var(--text-md--line-height);
+        margin-top: 1.2em;
+        margin-bottom: 1.2em;
+    }
+
+    /* Lists */
+    &:where(ol) {
+        list-style-type: decimal;
+
+        margin-top: calc(var(--spacing) * 4);
+        margin-bottom: calc(var(--spacing) * 4);
+        padding-inline-start: calc(var(--spacing) * 5.75);
+    }
+    &:where(ul) {
+        list-style-type: disc;
+
+        margin-top: calc(var(--spacing) * 4);
+        margin-bottom: calc(var(--spacing) * 4);
+        padding-inline-start: calc(var(--spacing) * 5.75);
+    }
+    &:where(li) {
+        margin-top: calc(var(--spacing) * 2);
+        margin-bottom: calc(var(--spacing) * 2);
+    }
+    &:where(ol > li) {
+        padding-inline-start: 1px;
+        margin-top: 0;
+        margin-bottom: 0;
+    }
+    &:where(ul > li) {
+        padding-inline-start: 1px;
+        margin-top: 0;
+        margin-bottom: 0;
+    }
+
+    /* Horizontal rules */
+    &:where(hr) {
+        margin-top: calc(var(--spacing) * 8);
+        margin-bottom: calc(var(--spacing) * 8);
+    }
+
+    /* Quotes */
+    &:where(blockquote) {
+        color: var(--tw-prose-quotes);
+
+        border-left-width: 2px;
+        border-left-color: var(--tw-prose-quote-borders);
+
+        padding-inline-start: 0;
+        margin-top: calc(var(--spacing) * 10);
+        margin-bottom: calc(var(--spacing) * 10);
+    }
+    &:where(blockquote p) {
+        margin: 0;
+        font-weight: 500;
+        font-style: italic;
+
+        font-size: var(--text-xl);
+        line-height: var(--text-xl--line-height);
+    }
+    &:where(blockquote p:first-of-type::before) {
+        content: open-quote;
+    }
+    &:where(blockquote p:last-of-type::after) {
+        content: close-quote;
+    }
+
+    /* Headings */
+    &:where(h1) {
+        color: var(--tw-prose-headings);
+        font-weight: 600;
+
+        font-size: var(--text-display-sm);
+        line-height: var(--text-display-sm--line-height);
+        margin-bottom: calc(var(--spacing) * 5);
+        margin-top: calc(var(--spacing) * 10);
+    }
+    &:where(h2) {
+        color: var(--tw-prose-headings);
+        font-weight: 600;
+
+        font-size: var(--text-display-xs);
+        line-height: var(--text-display-xs--line-height);
+        margin-bottom: calc(var(--spacing) * 4);
+        margin-top: calc(var(--spacing) * 8);
+    }
+    &:where(h3) {
+        color: var(--tw-prose-headings);
+        font-weight: 600;
+
+        font-size: var(--text-xl);
+        line-height: var(--text-xl--line-height);
+        margin-bottom: calc(var(--spacing) * 3);
+        margin-top: calc(var(--spacing) * 8);
+    }
+    &:where(h4) {
+        color: var(--tw-prose-headings);
+        font-weight: 600;
+
+        font-size: var(--text-lg);
+        line-height: var(--text-lg--line-height);
+        margin-bottom: calc(var(--spacing) * 2);
+        margin-top: calc(var(--spacing) * 5);
+    }
+
+    &:where(h2 + *) {
+        margin-top: 0;
+    }
+    &:where(h3 + *) {
+        margin-top: 0;
+    }
+    &:where(h4 + *) {
+        margin-top: 0;
+    }
+
+    &:where(h1 strong) {
+        font-weight: 900;
+        color: inherit;
+    }
+    &:where(h2 strong) {
+        font-weight: 800;
+        color: inherit;
+    }
+    &:where(h3 strong) {
+        font-weight: 700;
+        color: inherit;
+    }
+    &:where(h4 strong) {
+        font-weight: 700;
+        color: inherit;
+    }
+
+    /* Media */
+
+    &:where(img) {
+        border-radius: var(--radius-xl);
+        width: 100%;
+        object-fit: cover;
+
+        margin-top: calc(var(--spacing) * 8);
+        margin-bottom: calc(var(--spacing) * 8);
+    }
+    &:where(video) {
+        margin-top: calc(var(--spacing) * 8);
+        margin-bottom: calc(var(--spacing) * 8);
+    }
+    &:where(figure) {
+        margin-top: calc(var(--spacing) * 10);
+        margin-bottom: calc(var(--spacing) * 10);
+    }
+    &:where(figure > *) {
+        margin-top: 0;
+        margin-bottom: 0;
+    }
+    &:where(figure:has(> blockquote)) {
+        border-left-width: 2px;
+        border-left-color: var(--tw-prose-quote-borders);
+        padding-top: calc(var(--spacing) * 2);
+        padding-bottom: calc(var(--spacing) * 2);
+
+        padding-inline-start: calc(var(--spacing) * 4);
+    }
+    &:where(figure:has(> blockquote) blockquote) {
+        padding-inline-start: 0;
+        border: none;
+    }
+    &:where(img + figcaption) {
+        display: flex;
+        align-items: center;
+        gap: calc(var(--spacing) * 1.5);
+    }
+    &:where(figcaption) {
+        color: var(--tw-prose-captions);
+
+        font-size: var(--text-sm);
+        line-height: var(--text-sm--line-height);
+        margin-top: calc(var(--spacing) * 3);
+    }
+    &:where(cite) {
+        font-style: normal;
+    }
+
+    /* Inline elements */
+    &:where(a:not(h1 a, h2 a, h3 a, h4 a, h5 a, h6 a)) {
+        font-weight: 400;
+        text-decoration: underline;
+        text-underline-offset: 3px;
+    }
+
+    &:where(a:focus-visible) {
+        border-radius: var(--radius-sm);
+        outline: 2px solid var(--color-focus-ring);
+        outline-offset: 2px;
+    }
+    &:where(:is(h1, h2, h3) a) {
+        color: var(--tw-prose-headings);
+        font-weight: inherit;
+        text-decoration: none;
+    }
+
+    /* Inline code element */
+    &:where(code:not(pre code)) {
+        font-size: 0.875rem;
+        line-height: 1.25rem;
+        font-weight: 700;
+        border-radius: 6px;
+        padding: calc(var(--spacing) * 0.5) calc(var(--spacing) * 1.5);
+        margin: calc(var(--spacing) * -0.5) 0px;
+        background: var(--color-bg-secondary);
+        box-shadow: 0 0 0 1px var(--color-border-secondary);
+
+        &::before,
+        &::after {
+            content: "";
+        }
+    }
+}
+
+.prose.prose-centered-quote :not(:where([class~="not-prose"], [class~="not-prose"] *)) {
+    &:where(blockquote) {
+        padding-inline-start: 0px !important;
+        border-left: none;
+        text-align: center;
+    }
+    &:where(figure:has(> blockquote)) {
+        border-left: none;
+        padding-inline-start: 0px !important;
+        padding-top: 0px !important;
+        padding-bottom: 0px !important;
+        text-align: center;
+    }
+}
+
+.prose.prose-minimal-quote :not(:where([class~="not-prose"], [class~="not-prose"] *)) {
+    &:where(blockquote) {
+        border-left: none;
+        padding-inline-start: 0px !important;
+    }
+    &:where(figure:has(> blockquote)) {
+        border-left: none;
+        padding-inline-start: 0px !important;
+    }
+}
+
+.prose.md\:prose-lg:not(:where([class~="not-prose"], [class~="not-prose"] *)) {
+    @media (width >= 48rem /* 768px */) {
+        /* Base */
+        font-size: var(--text-lg);
+        line-height: var(--text-lg--line-height);
+    }
+}
+
+.prose.md\:prose-lg :not(:where([class~="not-prose"], [class~="not-prose"] *)) {
+    @media (width >= 48rem /* 768px */) {
+        /* Text */
+        &:where(p) {
+            margin-top: calc(var(--spacing) * 4.5);
+            margin-bottom: calc(var(--spacing) * 4.5);
+        }
+
+        &:where([class~="lead"]) {
+            font-size: var(--text-xl);
+            line-height: var(--text-xl--line-height);
+            margin-top: 1.09em;
+            margin-bottom: 1.09em;
+        }
+
+        /* Lists */
+        &:where(ol) {
+            margin-top: calc(var(--spacing) * 4.5);
+            margin-bottom: calc(var(--spacing) * 4.5);
+            padding-inline-start: calc(var(--spacing) * 6.5);
+        }
+        &:where(ul) {
+            margin-top: calc(var(--spacing) * 4.5);
+            margin-bottom: calc(var(--spacing) * 4.5);
+            padding-inline-start: calc(var(--spacing) * 6.5);
+        }
+
+        &:where(ol > li) {
+            padding-inline-start: 1px;
+            margin-top: 0;
+            margin-bottom: 0;
+        }
+        &:where(ul > li) {
+            padding-inline-start: 1px;
+            margin-top: 0;
+            margin-bottom: 0;
+        }
+
+        /* Horizontal rules */
+        &:where(hr) {
+            margin-top: calc(var(--spacing) * 8);
+            margin-bottom: calc(var(--spacing) * 8);
+        }
+
+        /* Quotes */
+        &:where(blockquote) {
+            padding-inline-start: 0;
+            margin-top: calc(var(--spacing) * 12);
+            margin-bottom: calc(var(--spacing) * 12);
+        }
+        &:where(blockquote p) {
+            margin: 0;
+
+            font-size: var(--text-display-xs);
+            line-height: var(--text-display-xs--line-height);
+        }
+
+        /* Headings */
+        &:where(h1) {
+            font-size: var(--text-display-md);
+            line-height: var(--text-display-md--line-height);
+            margin-bottom: calc(var(--spacing) * 6);
+            margin-top: calc(var(--spacing) * 12);
+        }
+        &:where(h2) {
+            font-size: var(--text-display-sm);
+            line-height: var(--text-display-sm--line-height);
+            margin-bottom: calc(var(--spacing) * 5);
+            margin-top: calc(var(--spacing) * 10);
+        }
+        &:where(h3) {
+            font-size: var(--text-display-xs);
+            line-height: var(--text-display-xs--line-height);
+            margin-bottom: calc(var(--spacing) * 4);
+            margin-top: calc(var(--spacing) * 8);
+        }
+        &:where(h4) {
+            font-size: var(--text-xl);
+            line-height: var(--text-xl--line-height);
+            margin-bottom: calc(var(--spacing) * 3);
+            margin-top: calc(var(--spacing) * 8);
+        }
+        &:where(h2 + *) {
+            margin-top: 0;
+        }
+        &:where(h3 + *) {
+            margin-top: 0;
+        }
+        &:where(h4 + *) {
+            margin-top: 0;
+        }
+
+        &:where(figure) {
+            margin-top: calc(var(--spacing) * 12);
+            margin-bottom: calc(var(--spacing) * 12);
+        }
+        &:where(figure > *) {
+            margin-top: 0;
+            margin-bottom: 0;
+        }
+        &:where(figure:has(> blockquote)) {
+            padding-inline-start: calc(var(--spacing) * 5);
+        }
+        &:where(figure > blockquote + figcaption) {
+            font-size: var(--text-md);
+            line-height: var(--text-md--line-height);
+        }
+
+        &:where(figcaption) {
+            margin-top: calc(var(--spacing) * 4);
+        }
+
+        /* Inline elements */
+        &:where(a:not(h1 a, h2 a, h3 a, h4 a, h5 a, h6 a)) {
+            font-weight: 400;
+            text-decoration: underline;
+            text-underline-offset: 3px;
+        }
+        &:where(:is(h1, h2, h3) a) {
+            color: var(--tw-prose-headings);
+            font-weight: inherit;
+            text-decoration: none;
+        }
+
+        /* Inline code element */
+        &:where(code:not(pre code)) {
+            font-size: 0.875rem;
+            line-height: 1.25rem;
+            font-weight: 700;
+            border-radius: 6px;
+            padding: calc(var(--spacing) * 0.5) calc(var(--spacing) * 1.5);
+            margin: calc(var(--spacing) * -0.5) 0px;
+            background: var(--color-bg-secondary);
+            box-shadow: 0 0 0 1px var(--color-border-secondary);
+        }
+    }
+}
+
+/* Remove top margin from first element */
+.prose > :first-child:not(:where([class~="not-prose"], [class~="not-prose"] *)) {
+    margin-top: 0;
+}
+.prose > :last-child:not(:where([class~="not-prose"], [class~="not-prose"] *)) {
+    margin-bottom: 0;
+}

package/src/themes/index.ts

@@ -0,0 +1,23 @@
+/**
+ * Theme Configuration
+ * Single source of truth for all themes
+ */
+
+export const THEME_CONFIG = {
+  classic: '',           // Base files with no suffix (hero-home.tsx)
+  aman: '.aman',         // Aman Hotels variant files (hero-home.aman.tsx)
+} as const;
+
+export type Theme = keyof typeof THEME_CONFIG;
+
+export function getAvailableThemes(): Theme[] {
+  return Object.keys(THEME_CONFIG) as Theme[];
+}
+
+export function getThemeSuffix(theme: Theme): string {
+  return THEME_CONFIG[theme] || '';
+}
+
+export function isValidTheme(theme: string): theme is Theme {
+  return theme in THEME_CONFIG;
+}

package/src/types/api/blog-post.ts

@@ -0,0 +1,53 @@
+import { Photo, PhotoAttachment } from './photos';
+
+// Blog post type definitions (aligned with Rails BlogPostSerializer)
+export interface BlogPost {
+  id: number;
+  title: string;
+  slug: string;
+  status: string;
+  published_at?: string;
+  excerpt_markdown?: string;
+  content_markdown: string;
+  featured: boolean;
+  seo_title?: string;
+  seo_description?: string;
+  seo_keywords?: string;
+  created_at: string;
+  updated_at: string;
+  photo_attachments?: PhotoAttachment[];
+  blog_post_authors?: BlogPostAuthor[];
+  blog_post_tags?: BlogPostTag[];
+}
+
+export interface BlogPostParams {
+  status?: string;
+  author_id?: number;
+  tag_id?: number;
+  q?: string;
+  page?: number;
+  per_page?: number;
+  featured?: boolean;
+}
+
+export type BlogPostResponse = BlogPost[];
+
+export interface BlogPostAuthor {
+  id: number;
+  name: string;
+  slug: string;
+  bio_markdown?: string;
+  active: boolean;
+  created_at: string;
+  updated_at: string;
+  photo_attachments?: PhotoAttachment[];
+}
+
+export interface BlogPostTag {
+  id: number;
+  name: string;
+  slug: string;
+  description?: string;
+  created_at: string;
+  updated_at: string;
+}

package/src/types/api/company-information.ts

@@ -0,0 +1,44 @@
+import { Photo, PhotoAttachment } from './photos';
+
+// Company information type definitions (aligned with Rails CompanyInformationSerializer)
+export interface CompanyInformation {
+  id: number;
+  company_name: string;
+  tagline: string;
+  mission_statement_markdown?: string;
+  about_text_markdown?: string;
+  description_markdown?: string;
+  values_markdown?: string;
+  stats_markdown?: string;
+  founded_year?: number;
+  logo_photo?: Photo; // Direct logo_photo association
+  favicon_url?: string;
+  facebook_url?: string;
+  instagram_url?: string;
+  tiktok_url?: string;
+  linkedin_url?: string;
+  twitter_url?: string;
+  youtube_url?: string;
+  pinterest_url?: string;
+  google_my_business_url?: string;
+  yelp_url?: string;
+  tripadvisor_url?: string;
+  google_reviews_url?: string;
+  primary_phone?: string;
+  primary_email?: string;
+  primary_address_line_1?: string;
+  primary_address_line_2?: string;
+  primary_city?: string;
+  primary_state?: string;
+  primary_zip_code?: string;
+  primary_country?: string;
+  support_email?: string;
+  sales_email?: string;
+  business_hours?: string;
+  created_at: string;
+  updated_at: string;
+  photo_attachments?: PhotoAttachment[];
+  account_status?: string; // 'active', 'stub', etc. - for stub mode detection
+}
+
+export type CompanyInformationResponse = CompanyInformation | null;

package/src/types/api/contact.ts

@@ -0,0 +1,63 @@
+import { Photo, PhotoAttachment } from './photos';
+
+// Contact type definitions
+export interface ContactInfo {
+  id?: number;
+  about_text_markdown?: string;
+  business_hours?: Record<string, { open: string; close: string }>;
+  company_name?: string;
+  description_markdown?: string;
+  facebook_url?: string;
+  favicon_url?: string;
+  founded_year?: string;
+  google_my_business_url?: string;
+  google_reviews_url?: string;
+  instagram_url?: string;
+  linkedin_url?: string;
+  mission_statement_markdown?: string;
+  pinterest_url?: string;
+  primary_address_line_1?: string;
+  primary_address_line_2?: string;
+  primary_city?: string;
+  primary_country?: string;
+  primary_email?: string;
+  primary_phone?: string;
+  primary_state?: string;
+  primary_zip_code?: string;
+  sales_email?: string;
+  stats_markdown?: string;
+  support_email?: string;
+  tagline?: string;
+  tiktok_url?: string;
+  tripadvisor_url?: string;
+  twitter_url?: string;
+  values_markdown?: string;
+  yelp_url?: string;
+  youtube_url?: string;
+  photo_attachments?: PhotoAttachment[];
+}
+
+export interface ContactFormSubmission {
+  id: number;
+  name: string;
+  email: string;
+  phone?: string;
+  message: string;
+  source: string;
+  created_at: string;
+}
+
+export interface ContactFormData {
+  name: string;
+  email: string;
+  phone?: string;
+  message: string;
+  source?: string;
+}
+
+export type ContactResponse = ContactInfo | null;
+
+export interface ContactFormResponse {
+  message: string;
+  data: ContactFormSubmission;
+}

package/src/types/api/faq.ts

@@ -0,0 +1,37 @@
+import { PhotoAttachment } from './photos';
+
+// FAQ type definitions
+export interface FaqQuestion {
+  id: number;
+  question: string;
+  answer: string;
+  answer_markdown?: string;
+  category_slug?: string;
+  featured: boolean;
+  sort_order: number;
+  created_at: string;
+  updated_at: string;
+  photo_attachments?: PhotoAttachment[];
+}
+
+export interface FaqCategory {
+  id: number;
+  name: string;
+  slug: string;
+  description?: string;
+  active: boolean;
+  sort_order: number;
+  questions_count: number;
+}
+
+export interface FaqParams {
+  category_slug?: string;
+  featured?: boolean;
+  q?: string;
+  page?: number;
+  per_page?: number;
+}
+
+export type FaqResponse = FaqQuestion[];
+
+export type FaqCategoryResponse = FaqCategory[];

package/src/types/api/job-posting.ts

@@ -0,0 +1,34 @@
+import { PhotoAttachment } from './photos';
+
+// Job posting type definitions
+export interface JobPosting {
+  id: number;
+  title: string;
+  slug: string;
+  description_markdown: string;
+  requirements_markdown?: string;
+  benefits_markdown?: string;
+  employment_type: string;
+  location: string;
+  experience_level?: string;
+  remote_ok?: boolean;
+  salary_range?: string;
+  posted_at: string;
+  expires_at?: string;
+  status: 'active' | 'inactive' | 'expired';
+  featured: boolean;
+  created_at: string;
+  updated_at: string;
+  photo_attachments?: PhotoAttachment[];
+}
+
+export interface JobPostingParams {
+  featured?: boolean;
+  employment_type?: string;
+  location?: string;
+  q?: string;
+  page?: number;
+  per_page?: number;
+}
+
+export type JobPostingResponse = JobPosting[];