@jamwidgets/solid 0.1.0

package/README.md

@@ -0,0 +1,292 @@
+# @jamwidgets/solid
+
+> **Note:** This repo is a read-only mirror. Source lives in a private monorepo.
+> For issues/PRs, please open them here and we'll sync changes back.
+
+SolidJS primitives for [JamWidgets](https://jamwidgets.com) widgets - comments, reactions, forms, subscriptions, and more.
+
+## Installation
+
+```bash
+npm install @jamwidgets/solid
+```
+
+Works with SolidJS 1.8+. Compatible with SolidStart, Astro, and standalone apps.
+
+## Primitives
+
+### createSubscribe
+
+Email subscription form:
+
+```tsx
+import { createSubscribe } from "@jamwidgets/solid";
+
+function SubscribeForm() {
+  const [email, setEmail] = createSignal("");
+  const { submit, status, message, error } = createSubscribe({
+    siteKey: "your-key",
+  });
+
+  const handleSubmit = async (e) => {
+    e.preventDefault();
+    await submit(email());
+  };
+
+  return (
+    <form onSubmit={handleSubmit}>
+      <input
+        type="email"
+        value={email()}
+        onInput={(e) => setEmail(e.target.value)}
+        placeholder="your@email.com"
+      />
+      <button disabled={status() === "loading"}>
+        {status() === "loading" ? "Subscribing..." : "Subscribe"}
+      </button>
+      <Show when={status() === "success"}>
+        <p>{message()}</p>
+      </Show>
+      <Show when={status() === "error"}>
+        <p>{error()?.message}</p>
+      </Show>
+    </form>
+  );
+}
+```
+
+### createReactions
+
+Reaction buttons (like, love, clap, etc.):
+
+```tsx
+import { createReactions } from "@jamwidgets/solid";
+
+function LikeButton() {
+  const { counts, userReactions, add, remove, status } = createReactions({
+    siteKey: "your-key",
+    pageId: "my-page",
+  });
+
+  const hasLiked = () => userReactions().includes("like");
+
+  return (
+    <button onClick={() => (hasLiked() ? remove("like") : add("like"))}>
+      {hasLiked() ? "Unlike" : "Like"} ({counts().like || 0})
+    </button>
+  );
+}
+```
+
+### createComments
+
+Threaded comments:
+
+```tsx
+import { createComments } from "@jamwidgets/solid";
+
+function Comments() {
+  const { comments, post, status, error } = createComments({
+    siteKey: "your-key",
+    pageId: "my-page",
+  });
+
+  return (
+    <div>
+      <For each={comments()}>
+        {(comment) => (
+          <div>
+            <strong>{comment.authorName}</strong>
+            <p>{comment.content}</p>
+          </div>
+        )}
+      </For>
+    </div>
+  );
+}
+```
+
+### createForm
+
+Contact forms with spam protection:
+
+```tsx
+import { createForm } from "@jamwidgets/solid";
+
+function ContactForm() {
+  const { submit, status, message } = createForm({
+    siteKey: "your-key",
+    formSlug: "contact",
+  });
+
+  const handleSubmit = async (e) => {
+    e.preventDefault();
+    const data = Object.fromEntries(new FormData(e.target));
+    await submit(data);
+  };
+
+  return (
+    <form onSubmit={handleSubmit}>
+      <input name="email" type="email" required />
+      <textarea name="message" required />
+      <button type="submit">Send</button>
+      <Show when={status() === "success"}>
+        <p>{message()}</p>
+      </Show>
+    </form>
+  );
+}
+```
+
+### createWaitlist
+
+Waitlist signups:
+
+```tsx
+import { createWaitlist } from "@jamwidgets/solid";
+
+function WaitlistForm() {
+  const { join, status, message, position } = createWaitlist({
+    siteKey: "your-key",
+  });
+
+  const handleSubmit = async (e) => {
+    e.preventDefault();
+    await join(email(), { name: name(), source: "homepage" });
+  };
+
+  return (
+    <form onSubmit={handleSubmit}>
+      <input name="email" type="email" required />
+      <button type="submit">Join Waitlist</button>
+      <Show when={status() === "success"}>
+        <p>{message()}</p>
+      </Show>
+    </form>
+  );
+}
+```
+
+### createFeedback
+
+Feedback forms:
+
+```tsx
+import { createFeedback } from "@jamwidgets/solid";
+
+function FeedbackWidget() {
+  const { submit, status, message } = createFeedback({
+    siteKey: "your-key",
+  });
+
+  const handleSubmit = async (type, content) => {
+    await submit(type, content, { email: email(), pageUrl: window.location.href });
+  };
+
+  // ...
+}
+```
+
+### createPoll
+
+Polls and voting:
+
+```tsx
+import { createPoll } from "@jamwidgets/solid";
+
+function Poll() {
+  const { poll, vote, hasVoted, status } = createPoll({
+    siteKey: "your-key",
+    pollId: 123,
+  });
+
+  return (
+    <Show when={poll()} fallback={<div>Loading...</div>}>
+      <div>
+        <h3>{poll().question}</h3>
+        <For each={poll().options}>
+          {(option) => (
+            <button onClick={() => vote([option.id])} disabled={hasVoted()}>
+              {option.text} ({poll().results?.[option.id] || 0})
+            </button>
+          )}
+        </For>
+      </div>
+    </Show>
+  );
+}
+```
+
+### createAnnouncements
+
+Site announcements:
+
+```tsx
+import { createAnnouncements } from "@jamwidgets/solid";
+
+function AnnouncementBanner() {
+  const { announcements, dismiss, status } = createAnnouncements({
+    siteKey: "your-key",
+  });
+
+  const visible = () => announcements().filter((a) => !a.dismissed);
+
+  return (
+    <For each={visible()}>
+      {(announcement) => (
+        <div>
+          <p>{announcement.content}</p>
+          <Show when={announcement.isDismissible}>
+            <button onClick={() => dismiss(announcement.id)}>Dismiss</button>
+          </Show>
+        </div>
+      )}
+    </For>
+  );
+}
+```
+
+### createViewCounts
+
+Page view tracking:
+
+```tsx
+import { createViewCounts } from "@jamwidgets/solid";
+import { onMount } from "solid-js";
+
+function PageViews() {
+  const { views, uniqueVisitors, record, status } = createViewCounts({
+    siteKey: "your-key",
+    pageId: "my-page",
+  });
+
+  // Record view on mount
+  onMount(() => {
+    record();
+  });
+
+  return (
+    <span>
+      {views()} views ({uniqueVisitors()} unique)
+    </span>
+  );
+}
+```
+
+## All Primitives
+
+| Primitive | Purpose |
+|-----------|---------|
+| `createSubscribe` | Email subscriptions |
+| `createReactions` | Page reactions |
+| `createComments` | Threaded comments |
+| `createForm` | Form submissions |
+| `createWaitlist` | Waitlist signups |
+| `createFeedback` | Feedback forms |
+| `createPoll` | Polls and voting |
+| `createAnnouncements` | Site announcements |
+| `createViewCounts` | Page view tracking |
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,310 @@
+/**
+ * @jamwidgets/solid - SolidJS primitives for Jamwidgets
+ *
+ * @example Subscribe form
+ * ```tsx
+ * import { createSubscribe } from '@jamwidgets/solid';
+ *
+ * function Newsletter() {
+ *   const { subscribe, status, error } = createSubscribe({
+ *     siteKey: 'your-site-key',
+ *   });
+ *
+ *   const handleSubmit = (e: SubmitEvent) => {
+ *     e.preventDefault();
+ *     const email = new FormData(e.currentTarget as HTMLFormElement).get('email') as string;
+ *     subscribe(email);
+ *   };
+ *
+ *   return (
+ *     <form onSubmit={handleSubmit}>
+ *       <input type="email" name="email" required />
+ *       <button disabled={status() === 'loading'}>
+ *         {status() === 'loading' ? 'Subscribing...' : 'Subscribe'}
+ *       </button>
+ *       {status() === 'success' && <p>Thanks for subscribing!</p>}
+ *       {status() === 'error' && <p>Error: {error()?.message}</p>}
+ *     </form>
+ *   );
+ * }
+ * ```
+ */
+import { type Accessor } from "solid-js";
+import { type JamWidgetsConfig, type Comment, type Announcement, type PollWithResults, type FeedbackType, type ControllerStatus } from "@jamwidgets/core";
+export type { JamWidgetsConfig, SubscribeState, FormState, ReactionsState, CommentsState, WaitlistState, ViewCountsState, FeedbackState, PollState, AnnouncementsState, Comment, Announcement, PollWithResults, FeedbackType, ReactionCounts, JamwidgetsPost, SeriphPost, // deprecated alias
+FetchPostsOptions, FetchPostOptions, ControllerStatus, } from "@jamwidgets/core";
+export { fetchPosts, fetchPost, getConfigFromMeta, resolveConfig, DEFAULT_ENDPOINT, API_PATH, } from "@jamwidgets/core";
+type OptionalSiteKey<T extends JamWidgetsConfig> = Omit<T, "siteKey"> & {
+    /** Site key - optional if <meta name="jamwidgets-site-key"> is set */
+    siteKey?: string;
+};
+export interface CreateSubscribeOptions extends OptionalSiteKey<JamWidgetsConfig> {
+}
+export interface CreateSubscribeReturn {
+    status: Accessor<ControllerStatus>;
+    message: Accessor<string | null>;
+    error: Accessor<Error | null>;
+    subscribe: (email: string) => Promise<void>;
+    reset: () => void;
+}
+/**
+ * Primitive for handling email subscriptions.
+ *
+ * @example
+ * ```tsx
+ * // With explicit siteKey:
+ * const { subscribe, status } = createSubscribe({ siteKey: 'your-key' });
+ *
+ * // Or with meta tag (add to document head):
+ * // <meta name="jamwidgets-site-key" content="your-key" />
+ * const { subscribe, status } = createSubscribe({});
+ * ```
+ */
+export declare function createSubscribe(options: CreateSubscribeOptions): CreateSubscribeReturn;
+export interface CreateFormOptions extends OptionalSiteKey<JamWidgetsConfig> {
+    /** Form slug/identifier */
+    formSlug: string;
+}
+export interface CreateFormReturn {
+    status: Accessor<ControllerStatus>;
+    message: Accessor<string | null>;
+    error: Accessor<Error | null>;
+    submit: (data: Record<string, unknown>) => Promise<void>;
+    reset: () => void;
+}
+/**
+ * Primitive for handling form submissions.
+ *
+ * @example
+ * ```tsx
+ * const { submit, status, error } = createForm({
+ *   siteKey: 'your-site-key', // optional with meta tag
+ *   formSlug: 'contact',
+ * });
+ *
+ * const handleSubmit = (e: SubmitEvent) => {
+ *   e.preventDefault();
+ *   const formData = new FormData(e.currentTarget as HTMLFormElement);
+ *   submit(Object.fromEntries(formData));
+ * };
+ * ```
+ */
+export declare function createForm(options: CreateFormOptions): CreateFormReturn;
+export interface CreateReactionsOptions extends OptionalSiteKey<JamWidgetsConfig> {
+    /** Content identifier (e.g., post slug) */
+    contentId: string;
+    /** Auto-fetch reactions on mount (default: true) */
+    autoFetch?: boolean;
+}
+export interface CreateReactionsReturn {
+    counts: Accessor<Record<string, number>>;
+    userReactions: Accessor<string[]>;
+    status: Accessor<ControllerStatus>;
+    error: Accessor<Error | null>;
+    addReaction: (type: string) => Promise<void>;
+    removeReaction: (type: string) => Promise<void>;
+    refresh: () => Promise<void>;
+}
+/**
+ * Primitive for handling reactions (likes, claps, etc.).
+ *
+ * @example
+ * ```tsx
+ * const { counts, userReactions, addReaction, removeReaction } = createReactions({
+ *   contentId: 'my-post-slug',
+ * });
+ *
+ * <button onClick={() => addReaction('like')}>
+ *   Like ({counts().like || 0})
+ * </button>
+ * ```
+ */
+export declare function createReactions(options: CreateReactionsOptions): CreateReactionsReturn;
+export interface CreateCommentsOptions extends OptionalSiteKey<JamWidgetsConfig> {
+    /** Content identifier (e.g., post slug) */
+    contentId: string;
+    /** Auto-fetch comments on mount (default: true) */
+    autoFetch?: boolean;
+}
+export interface CreateCommentsReturn {
+    comments: Accessor<Comment[]>;
+    status: Accessor<ControllerStatus>;
+    error: Accessor<Error | null>;
+    postComment: (author: string, content: string, options?: {
+        authorEmail?: string;
+        parentId?: string;
+    }) => Promise<void>;
+    refresh: () => Promise<void>;
+}
+/**
+ * Primitive for handling comments.
+ *
+ * @example
+ * ```tsx
+ * const { comments, status, postComment } = createComments({
+ *   contentId: 'my-post-slug',
+ * });
+ *
+ * <For each={comments()}>
+ *   {(comment) => (
+ *     <div>
+ *       <strong>{comment.authorName}</strong>: {comment.content}
+ *     </div>
+ *   )}
+ * </For>
+ *
+ * <button onClick={() => postComment('Anonymous', 'Great post!')}>
+ *   Add Comment
+ * </button>
+ * ```
+ */
+export declare function createComments(options: CreateCommentsOptions): CreateCommentsReturn;
+export interface CreateWaitlistOptions extends OptionalSiteKey<JamWidgetsConfig> {
+}
+export interface CreateWaitlistReturn {
+    status: Accessor<ControllerStatus>;
+    message: Accessor<string | null>;
+    position: Accessor<number | null>;
+    error: Accessor<Error | null>;
+    join: (email: string, options?: {
+        name?: string;
+        source?: string;
+    }) => Promise<void>;
+    reset: () => void;
+}
+/**
+ * Primitive for handling waitlist signups.
+ *
+ * @example
+ * ```tsx
+ * const { join, status, position } = createWaitlist({});
+ *
+ * <button onClick={() => join('user@example.com')}>Join Waitlist</button>
+ * {status() === 'success' && <p>You're #{position()} on the list!</p>}
+ * ```
+ */
+export declare function createWaitlist(options: CreateWaitlistOptions): CreateWaitlistReturn;
+export interface CreateViewsOptions extends OptionalSiteKey<JamWidgetsConfig> {
+    /** Page identifier (e.g., slug or URL path) */
+    pageId: string;
+    /** Auto-record view on mount (default: true) */
+    autoRecord?: boolean;
+}
+export interface CreateViewsReturn {
+    views: Accessor<number>;
+    uniqueVisitors: Accessor<number>;
+    status: Accessor<ControllerStatus>;
+    error: Accessor<Error | null>;
+    record: () => Promise<void>;
+    refresh: () => Promise<void>;
+}
+/**
+ * Primitive for tracking and displaying page views.
+ *
+ * @example
+ * ```tsx
+ * const { views, uniqueVisitors } = createViews({
+ *   pageId: '/blog/my-post',
+ * });
+ *
+ * <span>{views()} views ({uniqueVisitors()} unique)</span>
+ * ```
+ */
+export declare function createViews(options: CreateViewsOptions): CreateViewsReturn;
+export interface CreateFeedbackOptions extends OptionalSiteKey<JamWidgetsConfig> {
+}
+export interface CreateFeedbackReturn {
+    status: Accessor<ControllerStatus>;
+    message: Accessor<string | null>;
+    error: Accessor<Error | null>;
+    submit: (type: FeedbackType, content: string, options?: {
+        email?: string;
+        pageUrl?: string;
+    }) => Promise<void>;
+    reset: () => void;
+}
+/**
+ * Primitive for handling feedback submissions.
+ *
+ * @example
+ * ```tsx
+ * const { submit, status } = createFeedback({});
+ *
+ * <button onClick={() => submit('feature', 'Add dark mode!')}>
+ *   Submit Feedback
+ * </button>
+ * ```
+ */
+export declare function createFeedback(options: CreateFeedbackOptions): CreateFeedbackReturn;
+export interface CreatePollOptions extends OptionalSiteKey<JamWidgetsConfig> {
+    /** Poll slug */
+    slug: string;
+    /** Auto-fetch poll on mount (default: true) */
+    autoFetch?: boolean;
+}
+export interface CreatePollReturn {
+    poll: Accessor<PollWithResults | null>;
+    status: Accessor<ControllerStatus>;
+    error: Accessor<Error | null>;
+    vote: (selectedOptions: string[]) => Promise<void>;
+    hasVoted: Accessor<boolean>;
+    refresh: () => Promise<void>;
+}
+/**
+ * Primitive for displaying and voting on polls.
+ *
+ * @example
+ * ```tsx
+ * // With meta tag: <meta name="jamwidgets-site-key" content="your-key" />
+ * const { poll, vote, hasVoted } = createPoll({ slug: 'favorite-framework' });
+ *
+ * <Show when={poll()}>
+ *   {(p) => (
+ *     <div>
+ *       <h3>{p().question}</h3>
+ *       <For each={p().options}>
+ *         {(opt) => (
+ *           <button onClick={() => vote([opt.id])} disabled={hasVoted()}>
+ *             {opt.text} ({p().results[opt.id] || 0} votes)
+ *           </button>
+ *         )}
+ *       </For>
+ *     </div>
+ *   )}
+ * </Show>
+ * ```
+ */
+export declare function createPoll(options: CreatePollOptions): CreatePollReturn;
+export interface CreateAnnouncementsOptions extends OptionalSiteKey<JamWidgetsConfig> {
+    /** Auto-fetch announcements on mount (default: true) */
+    autoFetch?: boolean;
+}
+export interface CreateAnnouncementsReturn {
+    announcements: Accessor<Announcement[]>;
+    status: Accessor<ControllerStatus>;
+    error: Accessor<Error | null>;
+    dismiss: (announcementId: number) => Promise<void>;
+    refresh: () => Promise<void>;
+}
+/**
+ * Primitive for displaying site announcements.
+ *
+ * @example
+ * ```tsx
+ * // With meta tag: <meta name="jamwidgets-site-key" content="your-key" />
+ * const { announcements, dismiss } = createAnnouncements({});
+ *
+ * <For each={announcements()}>
+ *   {(ann) => (
+ *     <div class={`announcement-${ann.announcementType}`}>
+ *       {ann.content}
+ *       {ann.isDismissible && (
+ *         <button onClick={() => dismiss(ann.id)}>Dismiss</button>
+ *       )}
+ *     </div>
+ *   )}
+ * </For>
+ * ```
+ */
+export declare function createAnnouncements(options: CreateAnnouncementsOptions): CreateAnnouncementsReturn;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -0,0 +1,409 @@
+/**
+ * @jamwidgets/solid - SolidJS primitives for Jamwidgets
+ *
+ * @example Subscribe form
+ * ```tsx
+ * import { createSubscribe } from '@jamwidgets/solid';
+ *
+ * function Newsletter() {
+ *   const { subscribe, status, error } = createSubscribe({
+ *     siteKey: 'your-site-key',
+ *   });
+ *
+ *   const handleSubmit = (e: SubmitEvent) => {
+ *     e.preventDefault();
+ *     const email = new FormData(e.currentTarget as HTMLFormElement).get('email') as string;
+ *     subscribe(email);
+ *   };
+ *
+ *   return (
+ *     <form onSubmit={handleSubmit}>
+ *       <input type="email" name="email" required />
+ *       <button disabled={status() === 'loading'}>
+ *         {status() === 'loading' ? 'Subscribing...' : 'Subscribe'}
+ *       </button>
+ *       {status() === 'success' && <p>Thanks for subscribing!</p>}
+ *       {status() === 'error' && <p>Error: {error()?.message}</p>}
+ *     </form>
+ *   );
+ * }
+ * ```
+ */
+import { createSignal, createEffect, onCleanup } from "solid-js";
+import { SubscribeController, FormController, ReactionsController, CommentsController, WaitlistController, ViewCountsController, FeedbackController, PollController, AnnouncementsController, resolveConfig, } from "@jamwidgets/core";
+// Re-export API functions and helpers from core
+export { fetchPosts, fetchPost, getConfigFromMeta, resolveConfig, DEFAULT_ENDPOINT, API_PATH, } from "@jamwidgets/core";
+/**
+ * Primitive for handling email subscriptions.
+ *
+ * @example
+ * ```tsx
+ * // With explicit siteKey:
+ * const { subscribe, status } = createSubscribe({ siteKey: 'your-key' });
+ *
+ * // Or with meta tag (add to document head):
+ * // <meta name="jamwidgets-site-key" content="your-key" />
+ * const { subscribe, status } = createSubscribe({});
+ * ```
+ */
+export function createSubscribe(options) {
+    const [status, setStatus] = createSignal("idle");
+    const [message, setMessage] = createSignal(null);
+    const [error, setError] = createSignal(null);
+    const config = resolveConfig(options);
+    const controller = new SubscribeController(config);
+    createEffect(() => {
+        const unsubscribe = controller.subscribe((state) => {
+            setStatus(state.status);
+            setMessage(state.message);
+            setError(state.error);
+        });
+        onCleanup(unsubscribe);
+    });
+    const subscribe = async (email) => {
+        await controller.submit(email);
+    };
+    const reset = () => {
+        controller.reset();
+    };
+    return { status, message, error, subscribe, reset };
+}
+/**
+ * Primitive for handling form submissions.
+ *
+ * @example
+ * ```tsx
+ * const { submit, status, error } = createForm({
+ *   siteKey: 'your-site-key', // optional with meta tag
+ *   formSlug: 'contact',
+ * });
+ *
+ * const handleSubmit = (e: SubmitEvent) => {
+ *   e.preventDefault();
+ *   const formData = new FormData(e.currentTarget as HTMLFormElement);
+ *   submit(Object.fromEntries(formData));
+ * };
+ * ```
+ */
+export function createForm(options) {
+    const [status, setStatus] = createSignal("idle");
+    const [message, setMessage] = createSignal(null);
+    const [error, setError] = createSignal(null);
+    const config = resolveConfig(options);
+    const controller = new FormController(config, options.formSlug);
+    createEffect(() => {
+        const unsubscribe = controller.subscribe((state) => {
+            setStatus(state.status);
+            setMessage(state.message);
+            setError(state.error);
+        });
+        onCleanup(unsubscribe);
+    });
+    const submit = async (data) => {
+        await controller.submit(data);
+    };
+    const reset = () => {
+        controller.reset();
+    };
+    return { status, message, error, submit, reset };
+}
+/**
+ * Primitive for handling reactions (likes, claps, etc.).
+ *
+ * @example
+ * ```tsx
+ * const { counts, userReactions, addReaction, removeReaction } = createReactions({
+ *   contentId: 'my-post-slug',
+ * });
+ *
+ * <button onClick={() => addReaction('like')}>
+ *   Like ({counts().like || 0})
+ * </button>
+ * ```
+ */
+export function createReactions(options) {
+    const [counts, setCounts] = createSignal({});
+    const [userReactions, setUserReactions] = createSignal([]);
+    const [status, setStatus] = createSignal("idle");
+    const [error, setError] = createSignal(null);
+    const config = resolveConfig(options);
+    const controller = new ReactionsController(config, options.contentId);
+    createEffect(() => {
+        const unsubscribe = controller.subscribe((state) => {
+            setCounts(state.counts);
+            setUserReactions(state.userReactions);
+            setStatus(state.status);
+            setError(state.error);
+        });
+        // Auto-fetch on mount (default: true)
+        if (options.autoFetch !== false) {
+            controller.fetch();
+        }
+        onCleanup(unsubscribe);
+    });
+    const addReaction = async (type) => {
+        await controller.add(type);
+    };
+    const removeReaction = async (type) => {
+        await controller.remove(type);
+    };
+    const refresh = async () => {
+        await controller.fetch();
+    };
+    return { counts, userReactions, status, error, addReaction, removeReaction, refresh };
+}
+/**
+ * Primitive for handling comments.
+ *
+ * @example
+ * ```tsx
+ * const { comments, status, postComment } = createComments({
+ *   contentId: 'my-post-slug',
+ * });
+ *
+ * <For each={comments()}>
+ *   {(comment) => (
+ *     <div>
+ *       <strong>{comment.authorName}</strong>: {comment.content}
+ *     </div>
+ *   )}
+ * </For>
+ *
+ * <button onClick={() => postComment('Anonymous', 'Great post!')}>
+ *   Add Comment
+ * </button>
+ * ```
+ */
+export function createComments(options) {
+    const [comments, setComments] = createSignal([]);
+    const [status, setStatus] = createSignal("idle");
+    const [error, setError] = createSignal(null);
+    const config = resolveConfig(options);
+    const controller = new CommentsController(config, options.contentId);
+    createEffect(() => {
+        const unsubscribe = controller.subscribe((state) => {
+            setComments(state.comments);
+            setStatus(state.status);
+            setError(state.error);
+        });
+        // Auto-fetch on mount (default: true)
+        if (options.autoFetch !== false) {
+            controller.fetch();
+        }
+        onCleanup(unsubscribe);
+    });
+    const postComment = async (author, content, options) => {
+        await controller.post(author, content, options);
+    };
+    const refresh = async () => {
+        await controller.fetch();
+    };
+    return { comments, status, error, postComment, refresh };
+}
+/**
+ * Primitive for handling waitlist signups.
+ *
+ * @example
+ * ```tsx
+ * const { join, status, position } = createWaitlist({});
+ *
+ * <button onClick={() => join('user@example.com')}>Join Waitlist</button>
+ * {status() === 'success' && <p>You're #{position()} on the list!</p>}
+ * ```
+ */
+export function createWaitlist(options) {
+    const [status, setStatus] = createSignal("idle");
+    const [message, setMessage] = createSignal(null);
+    const [position, setPosition] = createSignal(null);
+    const [error, setError] = createSignal(null);
+    const config = resolveConfig(options);
+    const controller = new WaitlistController(config);
+    createEffect(() => {
+        const unsubscribe = controller.subscribe((state) => {
+            setStatus(state.status);
+            setMessage(state.message);
+            setPosition(state.position);
+            setError(state.error);
+        });
+        onCleanup(unsubscribe);
+    });
+    const join = async (email, opts) => {
+        await controller.join(email, opts);
+    };
+    const reset = () => {
+        controller.reset();
+    };
+    return { status, message, position, error, join, reset };
+}
+/**
+ * Primitive for tracking and displaying page views.
+ *
+ * @example
+ * ```tsx
+ * const { views, uniqueVisitors } = createViews({
+ *   pageId: '/blog/my-post',
+ * });
+ *
+ * <span>{views()} views ({uniqueVisitors()} unique)</span>
+ * ```
+ */
+export function createViews(options) {
+    const [views, setViews] = createSignal(0);
+    const [uniqueVisitors, setUniqueVisitors] = createSignal(0);
+    const [status, setStatus] = createSignal("idle");
+    const [error, setError] = createSignal(null);
+    const config = resolveConfig(options);
+    const controller = new ViewCountsController(config, options.pageId);
+    createEffect(() => {
+        const unsubscribe = controller.subscribe((state) => {
+            setViews(state.views);
+            setUniqueVisitors(state.uniqueVisitors);
+            setStatus(state.status);
+            setError(state.error);
+        });
+        // Auto-record view on mount (default: true)
+        if (options.autoRecord !== false) {
+            controller.record();
+        }
+        onCleanup(unsubscribe);
+    });
+    const record = async () => {
+        await controller.record();
+    };
+    const refresh = async () => {
+        await controller.fetch();
+    };
+    return { views, uniqueVisitors, status, error, record, refresh };
+}
+/**
+ * Primitive for handling feedback submissions.
+ *
+ * @example
+ * ```tsx
+ * const { submit, status } = createFeedback({});
+ *
+ * <button onClick={() => submit('feature', 'Add dark mode!')}>
+ *   Submit Feedback
+ * </button>
+ * ```
+ */
+export function createFeedback(options) {
+    const [status, setStatus] = createSignal("idle");
+    const [message, setMessage] = createSignal(null);
+    const [error, setError] = createSignal(null);
+    const config = resolveConfig(options);
+    const controller = new FeedbackController(config);
+    createEffect(() => {
+        const unsubscribe = controller.subscribe((state) => {
+            setStatus(state.status);
+            setMessage(state.message);
+            setError(state.error);
+        });
+        onCleanup(unsubscribe);
+    });
+    const submit = async (type, content, opts) => {
+        await controller.submit(type, content, opts);
+    };
+    const reset = () => {
+        controller.reset();
+    };
+    return { status, message, error, submit, reset };
+}
+/**
+ * Primitive for displaying and voting on polls.
+ *
+ * @example
+ * ```tsx
+ * // With meta tag: <meta name="jamwidgets-site-key" content="your-key" />
+ * const { poll, vote, hasVoted } = createPoll({ slug: 'favorite-framework' });
+ *
+ * <Show when={poll()}>
+ *   {(p) => (
+ *     <div>
+ *       <h3>{p().question}</h3>
+ *       <For each={p().options}>
+ *         {(opt) => (
+ *           <button onClick={() => vote([opt.id])} disabled={hasVoted()}>
+ *             {opt.text} ({p().results[opt.id] || 0} votes)
+ *           </button>
+ *         )}
+ *       </For>
+ *     </div>
+ *   )}
+ * </Show>
+ * ```
+ */
+export function createPoll(options) {
+    const [poll, setPoll] = createSignal(null);
+    const [status, setStatus] = createSignal("idle");
+    const [error, setError] = createSignal(null);
+    const config = resolveConfig(options);
+    const controller = new PollController(config, options.slug);
+    createEffect(() => {
+        const unsubscribe = controller.subscribe((state) => {
+            setPoll(state.poll);
+            setStatus(state.status);
+            setError(state.error);
+        });
+        // Auto-fetch on mount (default: true)
+        if (options.autoFetch !== false) {
+            controller.fetch();
+        }
+        onCleanup(unsubscribe);
+    });
+    const vote = async (selectedOptions) => {
+        await controller.vote(selectedOptions);
+    };
+    const refresh = async () => {
+        await controller.fetch();
+    };
+    const hasVoted = () => controller.hasVoted();
+    return { poll, status, error, vote, hasVoted, refresh };
+}
+/**
+ * Primitive for displaying site announcements.
+ *
+ * @example
+ * ```tsx
+ * // With meta tag: <meta name="jamwidgets-site-key" content="your-key" />
+ * const { announcements, dismiss } = createAnnouncements({});
+ *
+ * <For each={announcements()}>
+ *   {(ann) => (
+ *     <div class={`announcement-${ann.announcementType}`}>
+ *       {ann.content}
+ *       {ann.isDismissible && (
+ *         <button onClick={() => dismiss(ann.id)}>Dismiss</button>
+ *       )}
+ *     </div>
+ *   )}
+ * </For>
+ * ```
+ */
+export function createAnnouncements(options) {
+    const [announcements, setAnnouncements] = createSignal([]);
+    const [status, setStatus] = createSignal("idle");
+    const [error, setError] = createSignal(null);
+    const config = resolveConfig(options);
+    const controller = new AnnouncementsController(config);
+    createEffect(() => {
+        const unsubscribe = controller.subscribe((state) => {
+            // Only show non-dismissed announcements
+            setAnnouncements(controller.getVisibleAnnouncements());
+            setStatus(state.status);
+            setError(state.error);
+        });
+        // Auto-fetch on mount (default: true)
+        if (options.autoFetch !== false) {
+            controller.fetch();
+        }
+        onCleanup(unsubscribe);
+    });
+    const dismiss = async (announcementId) => {
+        await controller.dismiss(announcementId);
+    };
+    const refresh = async () => {
+        await controller.fetch();
+    };
+    return { announcements, status, error, dismiss, refresh };
+}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@jamwidgets/solid",
+  "version": "0.1.0",
+  "description": "SolidJS primitives for Jamwidgets (forms, comments, reactions, subscriptions)",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jamwidgets/solid.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "homepage": "https://jamwidgets.com",
+  "author": "Tim Marks <tim@imothee.xyz>",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "solid",
+    "solidjs",
+    "jamwidgets",
+    "forms",
+    "comments",
+    "reactions",
+    "subscribe",
+    "primitives"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@jamwidgets/core": "0.1.0"
+  },
+  "peerDependencies": {
+    "solid-js": "^1.8.0"
+  },
+  "devDependencies": {
+    "solid-js": "^1.9.0",
+    "typescript": "^5.7.3"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch"
+  }
+}