add proposal

2026-03-18 21:28:06 +01:00
parent 42594951f3
commit 2a39d594c7
15 changed files with 2585 additions and 1 deletions
--- a/src/app.ts
+++ b/src/app.ts
@@ -0,0 +1,107 @@
+import { getUserId } from "./identity";
+import { renderApp } from "./render";
+import { addOption, castVote, createViewModel } from "./state";
+import { initSync } from "./sync";
+
+const ROOM_PARAM = "room";
+
+function createRoomId() {
+  const seed = typeof crypto.randomUUID === "function"
+    ? crypto.randomUUID().slice(0, 8)
+    : Math.random().toString(36).slice(2, 10);
+
+  return `poll-${seed}`;
+}
+
+function ensureRoomId() {
+  const url = new URL(window.location.href);
+  let roomId = url.searchParams.get(ROOM_PARAM)?.trim();
+
+  if (!roomId) {
+    roomId = createRoomId();
+    url.searchParams.set(ROOM_PARAM, roomId);
+    window.history.replaceState({}, "", url);
+  }
+
+  return roomId;
+}
+
+export function initApp(container: HTMLElement) {
+  const roomId = ensureRoomId();
+  const userId = getUserId();
+  const sync = initSync(roomId);
+  let feedbackMessage = "Ready to collaborate.";
+  let feedbackTimer: number | undefined;
+
+  const setFeedbackMessage = (message: string) => {
+    feedbackMessage = message;
+    render();
+
+    if (feedbackTimer) {
+      window.clearTimeout(feedbackTimer);
+    }
+
+    feedbackTimer = window.setTimeout(() => {
+      feedbackMessage = "Ready to collaborate.";
+      render();
+    }, 2400);
+  };
+
+  const render = () => {
+    const viewModel = createViewModel({
+      meta: sync.meta,
+      options: sync.options,
+      votes: sync.votes,
+      roomId,
+      shareUrl: window.location.href,
+      connectionStatus: sync.getConnectionStatus(),
+      userId,
+    });
+
+    renderApp(container, viewModel, feedbackMessage, {
+      onSubmitOption: (label) => {
+        const result = addOption(sync.options, label, userId);
+        if (!result.ok) {
+          setFeedbackMessage(result.error);
+          return;
+        }
+
+        setFeedbackMessage("Option added and syncing.");
+      },
+      onVote: (optionId) => {
+        castVote(sync.votes, userId, optionId);
+        setFeedbackMessage("Vote updated.");
+      },
+      onCopyLink: async () => {
+        try {
+          await navigator.clipboard.writeText(window.location.href);
+          setFeedbackMessage("Room link copied.");
+        } catch {
+          setFeedbackMessage("Could not copy the link in this browser.");
+        }
+      },
+    });
+  };
+
+  const rerender = () => render();
+  const observe = () => rerender();
+
+  sync.doc.on("update", observe);
+  sync.persistence.once("synced", rerender);
+  sync.provider.on("status", rerender);
+  window.addEventListener("online", rerender);
+  window.addEventListener("offline", rerender);
+
+  render();
+
+  return () => {
+    if (feedbackTimer) {
+      window.clearTimeout(feedbackTimer);
+    }
+    sync.doc.off("update", observe);
+    sync.provider.off("status", rerender);
+    window.removeEventListener("online", rerender);
+    window.removeEventListener("offline", rerender);
+    sync.destroy();
+  };
+}
--- a/src/identity.ts
+++ b/src/identity.ts
@@ -0,0 +1,20 @@
+const USER_ID_KEY = "p2p-poll:user-id";
+
+function createUserId() {
+  if (typeof crypto.randomUUID === "function") {
+    return crypto.randomUUID();
+  }
+
+  return `user-${Math.random().toString(36).slice(2, 10)}`;
+}
+
+export function getUserId() {
+  const existing = localStorage.getItem(USER_ID_KEY);
+  if (existing) {
+    return existing;
+  }
+
+  const next = createUserId();
+  localStorage.setItem(USER_ID_KEY, next);
+  return next;
+}
--- a/src/main.ts
+++ b/src/main.ts
@@ -0,0 +1,11 @@
+import "./styles.css";
+
+import { initApp } from "./app";
+
+const container = document.querySelector<HTMLElement>("#app");
+
+if (!container) {
+  throw new Error("App container not found.");
+}
+
+initApp(container);
--- a/src/render.ts
+++ b/src/render.ts
@@ -0,0 +1,131 @@
+import type { PollViewModel } from "./state";
+
+interface RenderActions {
+  onSubmitOption: (label: string) => void;
+  onVote: (optionId: string) => void;
+  onCopyLink: () => void;
+}
+
+function escapeHtml(value: string) {
+  return value
+    .replaceAll("&", "&amp;")
+    .replaceAll("<", "&lt;")
+    .replaceAll(">", "&gt;")
+    .replaceAll('"', "&quot;")
+    .replaceAll("'", "&#39;");
+}
+
+export function renderApp(
+  container: HTMLElement,
+  viewModel: PollViewModel,
+  feedbackMessage: string,
+  actions: RenderActions,
+) {
+  const optionMarkup = viewModel.options.length
+    ? viewModel.options
+        .map((option) => {
+          const buttonLabel = option.isSelectedByMe ? "Selected" : "Vote";
+          const selectedClass = option.isSelectedByMe ? "option-card selected" : "option-card";
+
+          return `
+            <li class="${selectedClass}">
+              <div class="option-main">
+                <div>
+                  <p class="option-label">${escapeHtml(option.label)}</p>
+                  <p class="option-meta">${option.voteCount} vote${option.voteCount === 1 ? "" : "s"}</p>
+                </div>
+                <button class="vote-button" data-option-id="${option.id}">
+                  ${buttonLabel}
+                </button>
+              </div>
+            </li>
+          `;
+        })
+        .join("")
+    : `
+      <li class="empty-state">
+        No options yet. Add the first one and it will sync to everyone in this room.
+      </li>
+    `;
+
+  const statusClass = `status-pill ${viewModel.connectionStatus}`;
+  const myVoteLabel = viewModel.myVoteOptionId
+    ? "Your vote is currently synced."
+    : "You have not voted yet.";
+
+  container.innerHTML = `
+    <main class="shell">
+      <section class="hero">
+        <div class="hero-copy">
+          <p class="eyebrow">Peer-to-peer room</p>
+          <h1>${escapeHtml(viewModel.title)}</h1>
+          <p class="hero-text">
+            Share the room link, add options, and vote live without a central app server storing poll state.
+          </p>
+        </div>
+        <div class="hero-meta">
+          <span class="${statusClass}">${viewModel.connectionStatus}</span>
+          <p class="room-label">Room: <code>${escapeHtml(viewModel.roomId)}</code></p>
+        </div>
+      </section>
+
+      <section class="panel share-panel">
+        <label class="field-label" for="share-url">Share this room</label>
+        <div class="share-row">
+          <input id="share-url" class="share-input" type="text" readonly value="${escapeHtml(viewModel.shareUrl)}" />
+          <button id="copy-link-button" class="secondary-button" type="button">Copy link</button>
+        </div>
+      </section>
+
+      <section class="panel">
+        <div class="section-header">
+          <div>
+            <h2>Options</h2>
+            <p>${myVoteLabel}</p>
+          </div>
+        </div>
+        <ul class="options-list">${optionMarkup}</ul>
+      </section>
+
+      <section class="panel">
+        <h2>Add an option</h2>
+        <form id="add-option-form" class="option-form">
+          <input
+            id="option-input"
+            name="option"
+            type="text"
+            maxlength="80"
+            placeholder="Add an option"
+            autocomplete="off"
+            required
+          />
+          <button class="primary-button" type="submit">Add option</button>
+        </form>
+        <p class="feedback" aria-live="polite">${escapeHtml(feedbackMessage)}</p>
+      </section>
+    </main>
+  `;
+
+  const addOptionForm = container.querySelector<HTMLFormElement>("#add-option-form");
+  const optionInput = container.querySelector<HTMLInputElement>("#option-input");
+  const copyLinkButton = container.querySelector<HTMLButtonElement>("#copy-link-button");
+
+  addOptionForm?.addEventListener("submit", (event) => {
+    event.preventDefault();
+    const label = optionInput?.value ?? "";
+    actions.onSubmitOption(label);
+  });
+
+  copyLinkButton?.addEventListener("click", () => {
+    actions.onCopyLink();
+  });
+
+  container.querySelectorAll<HTMLButtonElement>("[data-option-id]").forEach((button) => {
+    button.addEventListener("click", () => {
+      const optionId = button.dataset.optionId;
+      if (optionId) {
+        actions.onVote(optionId);
+      }
+    });
+  });
+}
--- a/src/state.ts
+++ b/src/state.ts
@@ -0,0 +1,124 @@
+import * as Y from "yjs";
+
+export const DEFAULT_POLL_TITLE = "Shared Poll";
+
+export type ConnectionStatus = "connecting" | "connected" | "offline";
+
+export interface OptionRecord {
+  id: string;
+  label: string;
+  createdAt: number;
+  createdBy: string;
+}
+
+export interface PollOptionViewModel extends OptionRecord {
+  voteCount: number;
+  isSelectedByMe: boolean;
+}
+
+export interface PollViewModel {
+  title: string;
+  roomId: string;
+  shareUrl: string;
+  connectionStatus: ConnectionStatus;
+  options: PollOptionViewModel[];
+  myVoteOptionId: string | null;
+}
+
+const META_KEY_TITLE = "title";
+
+function createOptionId() {
+  if (typeof crypto.randomUUID === "function") {
+    return crypto.randomUUID();
+  }
+
+  return `option-${Math.random().toString(36).slice(2, 10)}`;
+}
+
+function normalizeLabel(label: string) {
+  return label.trim().replace(/\s+/g, " ");
+}
+
+function getPollTitle(meta: Y.Map<string>) {
+  return meta.get(META_KEY_TITLE) ?? DEFAULT_POLL_TITLE;
+}
+
+export function ensurePollInitialized(meta: Y.Map<string>) {
+  if (!meta.has(META_KEY_TITLE)) {
+    meta.set(META_KEY_TITLE, DEFAULT_POLL_TITLE);
+  }
+}
+
+export function addOption(
+  options: Y.Map<OptionRecord>,
+  rawLabel: string,
+  userId: string,
+) {
+  const label = normalizeLabel(rawLabel);
+  if (!label) {
+    return { ok: false as const, error: "Option label cannot be empty." };
+  }
+
+  const normalizedTarget = label.toLocaleLowerCase();
+  const duplicate = Array.from(options.values()).some(
+    (option) => option.label.trim().toLocaleLowerCase() === normalizedTarget,
+  );
+
+  if (duplicate) {
+    return { ok: false as const, error: "That option already exists." };
+  }
+
+  const option: OptionRecord = {
+    id: createOptionId(),
+    label,
+    createdAt: Date.now(),
+    createdBy: userId,
+  };
+
+  options.set(option.id, option);
+  return { ok: true as const, optionId: option.id };
+}
+
+export function castVote(votes: Y.Map<string>, userId: string, optionId: string) {
+  votes.set(userId, optionId);
+}
+
+export function createViewModel(params: {
+  meta: Y.Map<string>;
+  options: Y.Map<OptionRecord>;
+  votes: Y.Map<string>;
+  roomId: string;
+  shareUrl: string;
+  connectionStatus: ConnectionStatus;
+  userId: string;
+}): PollViewModel {
+  const { meta, options, votes, roomId, shareUrl, connectionStatus, userId } =
+    params;
+
+  const tally = new Map<string, number>();
+  for (const optionId of votes.values()) {
+    tally.set(optionId, (tally.get(optionId) ?? 0) + 1);
+  }
+
+  const myVoteOptionId = votes.get(userId) ?? null;
+  const sortedOptions = Array.from(options.values()).sort((left, right) => {
+    if (left.createdAt !== right.createdAt) {
+      return left.createdAt - right.createdAt;
+    }
+
+    return left.label.localeCompare(right.label);
+  });
+
+  return {
+    title: getPollTitle(meta),
+    roomId,
+    shareUrl,
+    connectionStatus,
+    myVoteOptionId,
+    options: sortedOptions.map((option) => ({
+      ...option,
+      voteCount: tally.get(option.id) ?? 0,
+      isSelectedByMe: myVoteOptionId === option.id,
+    })),
+  };
+}
--- a/src/styles.css
+++ b/src/styles.css
@@ -0,0 +1,256 @@
+:root {
+  font-family: "IBM Plex Sans", "Segoe UI", sans-serif;
+  color: #132238;
+  background:
+    radial-gradient(circle at top left, rgba(255, 190, 120, 0.55), transparent 28%),
+    radial-gradient(circle at top right, rgba(86, 201, 166, 0.3), transparent 24%),
+    linear-gradient(180deg, #f9f4e8 0%, #f4efe6 48%, #ece5d8 100%);
+  line-height: 1.5;
+  font-weight: 400;
+  color-scheme: light;
+}
+
+* {
+  box-sizing: border-box;
+}
+
+body {
+  margin: 0;
+  min-height: 100vh;
+}
+
+button,
+input {
+  font: inherit;
+}
+
+button {
+  cursor: pointer;
+}
+
+#app {
+  min-height: 100vh;
+}
+
+.shell {
+  width: min(920px, calc(100% - 2rem));
+  margin: 0 auto;
+  padding: 2rem 0 3rem;
+}
+
+.hero {
+  display: flex;
+  justify-content: space-between;
+  gap: 1.5rem;
+  align-items: flex-start;
+  margin-bottom: 1.5rem;
+}
+
+.hero-copy h1 {
+  margin: 0.15rem 0 0.5rem;
+  font-size: clamp(2.4rem, 6vw, 4rem);
+  line-height: 0.95;
+  letter-spacing: -0.05em;
+}
+
+.hero-text,
+.section-header p,
+.feedback,
+.option-meta,
+.room-label {
+  color: #4a5a6a;
+}
+
+.eyebrow {
+  margin: 0;
+  text-transform: uppercase;
+  letter-spacing: 0.16em;
+  font-size: 0.8rem;
+  color: #915f00;
+}
+
+.hero-meta {
+  min-width: 15rem;
+  padding: 1rem 1.1rem;
+  border-radius: 1.2rem;
+  background: rgba(255, 255, 255, 0.68);
+  border: 1px solid rgba(19, 34, 56, 0.08);
+  backdrop-filter: blur(10px);
+}
+
+.status-pill {
+  display: inline-flex;
+  align-items: center;
+  padding: 0.35rem 0.75rem;
+  border-radius: 999px;
+  font-weight: 700;
+  text-transform: capitalize;
+  font-size: 0.9rem;
+}
+
+.status-pill.connected {
+  background: rgba(86, 201, 166, 0.18);
+  color: #135d43;
+}
+
+.status-pill.connecting {
+  background: rgba(255, 190, 120, 0.22);
+  color: #8c5300;
+}
+
+.status-pill.offline {
+  background: rgba(219, 82, 82, 0.16);
+  color: #8f1f1f;
+}
+
+.panel {
+  margin-bottom: 1.25rem;
+  padding: 1.25rem;
+  border-radius: 1.3rem;
+  background: rgba(255, 255, 255, 0.78);
+  border: 1px solid rgba(19, 34, 56, 0.08);
+  box-shadow: 0 14px 40px rgba(19, 34, 56, 0.08);
+  backdrop-filter: blur(10px);
+}
+
+.panel h2 {
+  margin: 0 0 0.45rem;
+  font-size: 1.1rem;
+}
+
+.share-row,
+.option-form,
+.option-main {
+  display: flex;
+  gap: 0.75rem;
+}
+
+.field-label {
+  display: block;
+  margin-bottom: 0.6rem;
+  font-weight: 700;
+}
+
+.share-input,
+.option-form input {
+  width: 100%;
+  min-width: 0;
+  border-radius: 0.95rem;
+  border: 1px solid rgba(19, 34, 56, 0.14);
+  background: rgba(255, 255, 255, 0.94);
+  padding: 0.85rem 1rem;
+  color: #132238;
+}
+
+.share-input:focus,
+.option-form input:focus {
+  outline: 2px solid rgba(255, 190, 120, 0.65);
+  outline-offset: 1px;
+}
+
+.primary-button,
+.secondary-button,
+.vote-button {
+  border: none;
+  border-radius: 0.95rem;
+  padding: 0.85rem 1rem;
+  font-weight: 700;
+  transition: transform 150ms ease, box-shadow 150ms ease, background-color 150ms ease;
+}
+
+.primary-button,
+.vote-button {
+  background: #132238;
+  color: #f9f4e8;
+  box-shadow: 0 10px 20px rgba(19, 34, 56, 0.14);
+}
+
+.secondary-button {
+  background: rgba(19, 34, 56, 0.08);
+  color: #132238;
+}
+
+.primary-button:hover,
+.secondary-button:hover,
+.vote-button:hover {
+  transform: translateY(-1px);
+}
+
+.options-list {
+  list-style: none;
+  margin: 1rem 0 0;
+  padding: 0;
+  display: grid;
+  gap: 0.75rem;
+}
+
+.option-card,
+.empty-state {
+  border-radius: 1.1rem;
+  padding: 1rem;
+  background: rgba(247, 244, 236, 0.95);
+  border: 1px solid rgba(19, 34, 56, 0.08);
+}
+
+.option-card.selected {
+  border-color: rgba(86, 201, 166, 0.85);
+  background: rgba(232, 249, 242, 0.95);
+}
+
+.option-main {
+  align-items: center;
+  justify-content: space-between;
+}
+
+.option-label {
+  margin: 0;
+  font-size: 1.05rem;
+  font-weight: 700;
+}
+
+.option-meta,
+.feedback,
+.room-label {
+  margin: 0.35rem 0 0;
+}
+
+.section-header {
+  display: flex;
+  justify-content: space-between;
+  align-items: baseline;
+  gap: 1rem;
+}
+
+.feedback {
+  min-height: 1.5rem;
+}
+
+code {
+  font-family: "IBM Plex Mono", "SFMono-Regular", monospace;
+}
+
+@media (max-width: 720px) {
+  .shell {
+    width: min(100% - 1rem, 920px);
+    padding-top: 1rem;
+  }
+
+  .hero,
+  .share-row,
+  .option-form,
+  .option-main,
+  .section-header {
+    flex-direction: column;
+  }
+
+  .hero-meta {
+    width: 100%;
+    min-width: 0;
+  }
+
+  .primary-button,
+  .secondary-button,
+  .vote-button {
+    width: 100%;
+  }
+}
--- a/src/sync.ts
+++ b/src/sync.ts
@@ -0,0 +1,64 @@
+import { IndexeddbPersistence } from "y-indexeddb";
+import { WebrtcProvider } from "y-webrtc";
+import * as Y from "yjs";
+
+import { type ConnectionStatus, ensurePollInitialized, type OptionRecord } from "./state";
+
+export interface AppSync {
+  doc: Y.Doc;
+  meta: Y.Map<string>;
+  options: Y.Map<OptionRecord>;
+  votes: Y.Map<string>;
+  provider: WebrtcProvider;
+  persistence: IndexeddbPersistence;
+  getConnectionStatus: () => ConnectionStatus;
+  destroy: () => void;
+}
+
+export function initSync(roomId: string): AppSync {
+  const doc = new Y.Doc();
+  const meta = doc.getMap<string>("poll-meta");
+  const options = doc.getMap<OptionRecord>("poll-options");
+  const votes = doc.getMap<string>("poll-votes");
+
+  ensurePollInitialized(meta);
+
+  let connectionStatus: ConnectionStatus = navigator.onLine ? "connecting" : "offline";
+  const provider = new WebrtcProvider(roomId, doc);
+  const persistence = new IndexeddbPersistence(roomId, doc);
+
+  const syncConnectionStatus = (status: ConnectionStatus) => {
+    connectionStatus = navigator.onLine ? status : "offline";
+  };
+
+  const handleOnline = () => {
+    syncConnectionStatus(provider.connected ? "connected" : "connecting");
+  };
+  const handleOffline = () => {
+    connectionStatus = "offline";
+  };
+
+  provider.on("status", (event: { connected: boolean }) => {
+    syncConnectionStatus(event.connected ? "connected" : "connecting");
+  });
+
+  window.addEventListener("online", handleOnline);
+  window.addEventListener("offline", handleOffline);
+
+  return {
+    doc,
+    meta,
+    options,
+    votes,
+    provider,
+    persistence,
+    getConnectionStatus: () => connectionStatus,
+    destroy: () => {
+      window.removeEventListener("online", handleOnline);
+      window.removeEventListener("offline", handleOffline);
+      persistence.destroy();
+      provider.destroy();
+      doc.destroy();
+    },
+  };
+}