@jant/core 0.3.24 → 0.3.26

package/src/styles/ui.css

@@ -0,0 +1,475 @@
+/**
+ * UI Component Styles
+ *
+ * All styles reference design tokens from tokens.css.
+ * Class names are the stable public API — DO NOT rename without a major version bump.
+ */
+
+/* Tell Tailwind to scan ui/ source files for class usage */
+@source "../ui/";
+
+@layer components {
+  /* =========================================================================
+   * Page Layout
+   * ========================================================================= */
+
+  .site-page {
+    min-height: 100vh;
+    min-height: 100dvh;
+    background-color: var(--site-page-bg);
+  }
+
+  /* --- Top header --------------------------------------------------------- */
+
+  .site-header {
+    max-width: var(--site-width);
+    margin: 0 auto;
+    padding: 20px var(--site-padding) 0;
+  }
+
+  @media (min-width: 700px) {
+    .site-header {
+      padding: 24px var(--site-padding) 0;
+    }
+  }
+
+  .site-header-inner {
+    display: flex;
+    flex-direction: column;
+    align-items: flex-start;
+    gap: 10px;
+  }
+
+  .site-header-top {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    width: 100%;
+  }
+
+  .site-header-top-bordered {
+    padding-bottom: 12px;
+    border-bottom: 0.5px solid var(--site-divider);
+  }
+
+  .site-header-right {
+    display: flex;
+    align-items: center;
+    gap: 12px;
+  }
+
+  .site-header-search {
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    width: 32px;
+    height: 32px;
+    border-radius: 999px;
+    color: var(--site-text-secondary);
+    transition:
+      color 0.15s,
+      background-color 0.15s;
+  }
+
+  .site-header-search:hover {
+    color: var(--site-text-primary);
+    background-color: var(--site-nav-hover-bg);
+  }
+
+  .site-header-search-active {
+    color: var(--site-text-primary);
+    background-color: var(--site-nav-hover-bg);
+  }
+
+  .site-logo {
+    display: flex;
+    align-items: center;
+    gap: 8px;
+    font-size: 1.125rem;
+    font-weight: 800;
+    font-family: var(--font-heading);
+    color: var(--site-text-primary);
+    text-decoration: none;
+    line-height: 1;
+  }
+
+  .site-logo-avatar {
+    width: var(--avatar-size);
+    height: var(--avatar-size);
+    border-radius: var(--avatar-radius);
+    object-fit: cover;
+  }
+
+  .site-header-nav {
+    display: flex;
+    align-items: center;
+    gap: 12px;
+  }
+
+  .site-header-link {
+    font-size: 0.875rem;
+    color: var(--site-text-secondary);
+    text-decoration: underline transparent;
+    text-underline-offset: 3px;
+    text-decoration-thickness: 0.5px;
+    transition:
+      color 0.15s,
+      text-decoration-color 0.15s;
+  }
+
+  .site-header-link:hover {
+    color: var(--site-text-primary);
+    text-decoration-color: var(--site-text-secondary);
+  }
+
+  .site-header-link-active {
+    color: var(--site-text-primary);
+  }
+
+  .site-description {
+    font-size: var(--text-sm);
+    color: var(--site-text-secondary);
+    margin: 2px 0 0;
+    line-height: var(--leading);
+  }
+
+  /* --- Browse filter tabs ------------------------------------------------- */
+
+  .site-browse-nav {
+    display: flex;
+    align-items: center;
+    gap: 8px;
+    padding: 16px 0 var(--space-xl);
+  }
+
+  .site-browse-sep {
+    color: var(--site-divider);
+    font-size: var(--text-sm);
+  }
+
+  .site-browse-link {
+    font-size: var(--text-base);
+    color: var(--site-text-secondary);
+    text-decoration: none;
+    font-weight: 500;
+    transition: color 0.15s;
+  }
+
+  .site-browse-link:hover {
+    color: var(--site-text-primary);
+  }
+
+  .site-browse-link-active {
+    color: var(--site-text-primary);
+    font-weight: 700;
+  }
+
+  /* --- Main content area -------------------------------------------------- */
+
+  .site-container {
+    max-width: var(--site-width);
+    margin: 0 auto;
+  }
+
+  .site-content {
+    background-color: var(--site-elevated-bg);
+    padding: 0 var(--site-padding);
+  }
+
+  /* =========================================================================
+   * Timeline & Post Components
+   * ========================================================================= */
+
+  /* Post divider */
+  .site-content hr.feed-divider {
+    border: none;
+    height: 10px;
+    width: 32px;
+    margin: 2.5rem auto;
+    background-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 45 13'%3E%3Cpath fill='%23ccc' transform='translate(0,0) rotate(90 6 6.5)' d='M6.765.5.177 6.093l2.61 5.966 8.39-3.17L6.765.5Z'/%3E%3Cpath fill='%23ccc' transform='translate(16,0) rotate(100 6 6.5)' d='M6.765.5.177 6.093l2.61 5.966 8.39-3.17L6.765.5Z'/%3E%3Cpath fill='%23ccc' transform='translate(32,0) rotate(80 6 6.5)' d='M6.765.5.177 6.093l2.61 5.966 8.39-3.17L6.765.5Z'/%3E%3C/svg%3E");
+    background-repeat: no-repeat;
+    background-position: center;
+  }
+
+  /* Thread reply container with vertical connector line */
+  .feed-replies {
+    position: relative;
+    margin-left: 16px;
+    padding-left: 16px;
+    margin-top: 8px;
+  }
+
+  .feed-replies::before {
+    content: "";
+    position: absolute;
+    left: 0;
+    top: 0;
+    bottom: 0;
+    width: 2px;
+    background-color: var(--site-threadline);
+  }
+
+  /* Individual reply in thread */
+  .feed-reply {
+    padding: 12px 0;
+  }
+
+  .feed-reply + .feed-reply {
+    border-top: var(--card-border-width) solid var(--site-divider);
+  }
+
+  /* Compact text for thread replies */
+  .feed-compact {
+    @apply text-sm;
+  }
+
+  /* Quote block styling */
+  .feed-quote {
+    padding-left: 12px;
+    border-left: 2px solid var(--site-text-secondary);
+  }
+
+  /* =========================================================================
+   * Compose Prompt Bar ("What's new?" at top of content)
+   * ========================================================================= */
+
+  .compose-prompt {
+    display: flex;
+    align-items: center;
+    gap: 12px;
+    padding: 16px 0;
+    margin: -20px 0 12px;
+  }
+
+  .compose-prompt-trigger {
+    display: flex;
+    align-items: center;
+    gap: 10px;
+    flex: 1;
+    min-width: 0;
+    padding: 0;
+    border: none;
+    background: none;
+    cursor: pointer;
+    text-align: left;
+  }
+
+  .compose-prompt-avatar {
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    width: var(--avatar-size);
+    height: var(--avatar-size);
+    flex-shrink: 0;
+    border-radius: var(--avatar-radius);
+    border: 1.5px solid var(--site-column-outline);
+    color: var(--site-text-secondary);
+  }
+
+  .compose-prompt-text {
+    font-size: var(--text-base);
+    color: var(--site-text-secondary);
+  }
+
+  .compose-prompt-post-btn {
+    flex-shrink: 0;
+    padding: 6px 16px;
+    border-radius: 10px;
+    border: 1px solid var(--site-column-outline);
+    background: none;
+    color: var(--site-text-secondary);
+    font-size: 0.875rem;
+    font-weight: 600;
+    cursor: pointer;
+    transition:
+      border-color 0.15s,
+      color 0.15s;
+  }
+
+  .compose-prompt-post-btn:hover {
+    color: var(--site-text-primary);
+    border-color: var(--site-text-secondary);
+  }
+
+  /* =========================================================================
+   * Compose Dialog
+   * ========================================================================= */
+
+  /* Dialog — positioned near top of viewport */
+  .compose-dialog {
+    padding: 0;
+    border: none;
+    border-radius: 16px;
+    max-width: 560px;
+    width: calc(100% - 32px);
+    max-height: calc(100dvh - 64px);
+    margin: max(80px, 10vh) auto auto;
+    background-color: var(--site-elevated-bg);
+    color: var(--site-text-primary);
+    box-shadow:
+      0 25px 50px -12px rgba(0, 0, 0, 0.25),
+      0 0 0 1px var(--site-column-outline);
+  }
+
+  .compose-dialog::backdrop {
+    background-color: rgba(0, 0, 0, 0.5);
+  }
+
+  .compose-dialog-inner {
+    display: flex;
+    flex-direction: column;
+    max-height: calc(100dvh - 64px);
+  }
+
+  .compose-dialog-header {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    padding: 16px 20px;
+    border-bottom: var(--card-border-width) solid var(--site-divider);
+  }
+
+  .compose-dialog-title {
+    font-size: 1rem;
+    font-weight: 600;
+    margin: 0;
+  }
+
+  .compose-dialog-close {
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    width: 28px;
+    height: 28px;
+    border-radius: 50%;
+    border: none;
+    background: none;
+    color: var(--site-text-secondary);
+    cursor: pointer;
+    transition: background-color 0.15s;
+  }
+
+  .compose-dialog-close:hover {
+    background-color: var(--site-nav-hover-bg);
+  }
+
+  .compose-dialog-body {
+    padding: 16px 20px;
+    overflow-y: auto;
+    flex: 1;
+  }
+
+  .compose-dialog-footer {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    padding-top: 12px;
+    border-top: var(--card-border-width) solid var(--site-divider);
+  }
+
+  /* Format tabs — inline pill buttons */
+  .compose-format-tabs {
+    display: flex;
+    gap: 4px;
+    padding-bottom: 8px;
+  }
+
+  .compose-format-tab {
+    padding: 4px 12px;
+    border-radius: 999px;
+    border: 1px solid var(--site-column-outline);
+    background: none;
+    color: var(--site-text-secondary);
+    font-size: var(--text-sm);
+    cursor: pointer;
+    transition:
+      background-color 0.15s,
+      color 0.15s,
+      border-color 0.15s;
+  }
+
+  .compose-format-tab:hover {
+    color: var(--site-text-primary);
+    border-color: var(--site-text-secondary);
+  }
+
+  .compose-format-tab-active {
+    color: var(--site-text-primary);
+    background-color: var(--site-nav-hover-bg);
+    border-color: var(--site-text-primary);
+    font-weight: 500;
+  }
+
+  /* Borderless title input */
+  .compose-title-input {
+    width: 100%;
+    padding: 4px 0;
+    border: none;
+    outline: none;
+    background: transparent;
+    color: var(--site-text-primary);
+    font-size: var(--text-lg);
+    font-weight: 600;
+  }
+
+  .compose-title-input::placeholder {
+    color: var(--site-text-secondary);
+    font-weight: 400;
+  }
+
+  /* Borderless body textarea */
+  .compose-body-input {
+    width: 100%;
+    padding: 4px 0;
+    border: none;
+    outline: none;
+    background: transparent;
+    color: var(--site-text-primary);
+    font-size: var(--text-base);
+    line-height: var(--leading);
+    resize: vertical;
+  }
+
+  .compose-body-input::placeholder {
+    color: var(--site-text-secondary);
+  }
+
+  /* Bottom toolbar */
+  .compose-toolbar {
+    padding: 8px 0;
+  }
+
+  .compose-toolbar-btn {
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    width: 32px;
+    height: 32px;
+    border-radius: 8px;
+    border: none;
+    background: none;
+    color: var(--site-text-secondary);
+    cursor: pointer;
+    transition:
+      background-color 0.15s,
+      color 0.15s;
+  }
+
+  .compose-toolbar-btn:hover {
+    color: var(--site-text-primary);
+    background-color: var(--site-nav-hover-bg);
+  }
+
+  /* =========================================================================
+   * Site Footer
+   * ========================================================================= */
+
+  .site-footer {
+    max-width: var(--site-width);
+    margin: var(--space-xl) auto 0;
+    padding: var(--content-gap) var(--site-padding) var(--space-xl);
+    border-top: 0.5px solid var(--site-divider);
+    color: var(--site-text-secondary);
+    font-size: var(--text-sm);
+  }
+}

package/src/types/bindings.ts

@@ -0,0 +1,30 @@
+/**
+ * Cloudflare Worker Bindings
+ */
+
+export interface Bindings {
+  DB: D1Database;
+  R2?: R2Bucket;
+  SITE_URL: string;
+  AUTH_SECRET?: string;
+  R2_PUBLIC_URL?: string;
+  IMAGE_TRANSFORM_URL?: string;
+  DEMO_EMAIL?: string;
+  DEMO_PASSWORD?: string;
+  // Timeline
+  PAGE_SIZE?: string;
+  // Site configuration (optional - can be overridden in DB)
+  SITE_NAME?: string;
+  SITE_DESCRIPTION?: string;
+  SITE_LANGUAGE?: string;
+  // S3-compatible storage (alternative to R2)
+  STORAGE_DRIVER?: string;
+  S3_ENDPOINT?: string;
+  S3_BUCKET?: string;
+  S3_ACCESS_KEY_ID?: string;
+  S3_SECRET_ACCESS_KEY?: string;
+  S3_REGION?: string;
+  S3_PUBLIC_URL?: string;
+  // RSS feed
+  RSS_FEED_LIMIT?: string;
+}

package/src/types/config.ts

@@ -0,0 +1,183 @@
+/**
+ * Configuration System
+ *
+ * Single Source of Truth for all configuration fields.
+ */
+
+import type { ColorTheme } from "../ui/color-themes.js";
+import type { FeedData, SitemapData } from "./views.js";
+
+/**
+ * Configuration Registry - Single Source of Truth
+ *
+ * All available configuration fields with their metadata.
+ * Add new fields here, and they'll automatically work everywhere.
+ *
+ * Priority logic:
+ * - envOnly: false -> User-configurable (DB > ENV > Default)
+ * - envOnly: true -> Environment-only (ENV > Default)
+ */
+export const CONFIG_FIELDS = {
+  // User-configurable (can be modified in dashboard)
+  SITE_NAME: {
+    defaultValue: "Jant",
+    envOnly: false,
+  },
+  SITE_DESCRIPTION: {
+    defaultValue: "A microblog powered by Jant",
+    envOnly: false,
+  },
+  SITE_LANGUAGE: {
+    defaultValue: "en",
+    envOnly: false,
+  },
+  HOME_DEFAULT_VIEW: {
+    defaultValue: "latest",
+    envOnly: false,
+  },
+
+  // Environment-only (deployment/infrastructure config)
+  SITE_URL: {
+    defaultValue: "",
+    envOnly: true,
+  },
+  AUTH_SECRET: {
+    defaultValue: "",
+    envOnly: true,
+  },
+  R2_PUBLIC_URL: {
+    defaultValue: "",
+    envOnly: true,
+  },
+  IMAGE_TRANSFORM_URL: {
+    defaultValue: "",
+    envOnly: true,
+  },
+  DEMO_EMAIL: {
+    defaultValue: "",
+    envOnly: true,
+  },
+  DEMO_PASSWORD: {
+    defaultValue: "",
+    envOnly: true,
+  },
+  PAGE_SIZE: {
+    defaultValue: "20",
+    envOnly: true,
+  },
+  STORAGE_DRIVER: {
+    defaultValue: "r2",
+    envOnly: true,
+  },
+  S3_ENDPOINT: {
+    defaultValue: "",
+    envOnly: true,
+  },
+  S3_BUCKET: {
+    defaultValue: "",
+    envOnly: true,
+  },
+  S3_ACCESS_KEY_ID: {
+    defaultValue: "",
+    envOnly: true,
+  },
+  S3_SECRET_ACCESS_KEY: {
+    defaultValue: "",
+    envOnly: true,
+  },
+  S3_REGION: {
+    defaultValue: "auto",
+    envOnly: true,
+  },
+  S3_PUBLIC_URL: {
+    defaultValue: "",
+    envOnly: true,
+  },
+
+  // Internal settings (DB-only, not configurable via env or dashboard)
+  THEME: {
+    defaultValue: "",
+    envOnly: false,
+    internal: true,
+  },
+  CUSTOM_CSS: {
+    defaultValue: "",
+    envOnly: false,
+    internal: true,
+  },
+  SITE_AVATAR: {
+    defaultValue: "",
+    envOnly: false,
+    internal: true,
+  },
+  SHOW_HEADER_AVATAR: {
+    defaultValue: "",
+    envOnly: false,
+    internal: true,
+  },
+  SITE_FAVICON_ICO: {
+    defaultValue: "",
+    envOnly: false,
+    internal: true,
+  },
+  SITE_FAVICON_APPLE_TOUCH: {
+    defaultValue: "",
+    envOnly: false,
+    internal: true,
+  },
+  FONT_THEME: {
+    defaultValue: "",
+    envOnly: false,
+    internal: true,
+  },
+  TIME_ZONE: {
+    defaultValue: "UTC",
+    envOnly: false,
+  },
+  SITE_FOOTER: {
+    defaultValue: "",
+    envOnly: false,
+  },
+  NOINDEX: {
+    defaultValue: "",
+    envOnly: false,
+  },
+  ONBOARDING_STATUS: {
+    defaultValue: "pending",
+    envOnly: false,
+    internal: true,
+  },
+  PASSWORD_RESET_TOKEN: {
+    defaultValue: "",
+    envOnly: false,
+    internal: true,
+  },
+} as const;
+
+export type ConfigKey = keyof typeof CONFIG_FIELDS;
+
+/**
+ * Main Jant configuration
+ *
+ * Configuration Philosophy:
+ * - Use environment variables for runtime config (API keys, feature flags, site settings)
+ * - Use code config (this object) for CSS customization and feed overrides
+ *
+ * Site-level settings (name, description, language) are configured via
+ * environment variables, not here. See lib/config.ts for details.
+ */
+export interface JantConfig {
+  /** CSS variable overrides (highest priority after custom CSS) */
+  cssVariables?: Record<string, string>;
+  /** Replace built-in color themes with custom list */
+  colorThemes?: ColorTheme[];
+  /** Custom feed renderers */
+  feed?: {
+    /** Custom RSS 2.0 renderer -- returns XML string */
+    rss?: (data: FeedData) => string;
+    /** Custom Atom renderer -- returns XML string */
+    atom?: (data: FeedData) => string;
+    /** Custom Sitemap renderer -- returns XML string */
+    sitemap?: (data: SitemapData) => string;
+  };
+}

package/src/types/constants.ts

@@ -0,0 +1,26 @@
+/**
+ * Content Type Constants
+ */
+
+export const FORMATS = ["note", "link", "quote"] as const;
+export type Format = (typeof FORMATS)[number];
+
+export const STATUSES = ["draft", "published"] as const;
+export type Status = (typeof STATUSES)[number];
+
+export const SORT_ORDERS = [
+  "newest",
+  "oldest",
+  "rating_desc",
+  "rating_asc",
+] as const;
+export type SortOrder = (typeof SORT_ORDERS)[number];
+
+export const NAV_ITEM_TYPES = ["page", "link"] as const;
+export type NavItemType = (typeof NAV_ITEM_TYPES)[number];
+
+export const MAX_MEDIA_ATTACHMENTS = 20;
+export const MAX_PINNED_POSTS = 3;
+
+export const STORAGE_DRIVERS = ["r2", "s3"] as const;
+export type StorageDriver = (typeof STORAGE_DRIVERS)[number];