@ewanc26/svelte-standard-site 0.2.0

package/dist/components/document/blocks/UnorderedListBlock.svelte

@@ -0,0 +1,71 @@
+<script lang="ts">
+	import RichText from '../RichText.svelte';
+	import UnorderedListBlock from './UnorderedListBlock.svelte';
+
+	export interface ListItem {
+		content?: {
+			plaintext: string;
+			facets?: any[];
+		};
+		children?: ListItem[];
+	}
+
+	interface Props {
+		block: {
+			children: ListItem[];
+		};
+		hasTheme?: boolean;
+	}
+
+	const { block, hasTheme = false }: Props = $props();
+</script>
+
+<ul class="unordered-list pb-2">
+	{#each block.children as item}
+		<li class="flex flex-row gap-2 pb-0">
+			<div
+				class="listMarker z-1 mx-2 mt-3.5 h-1.25 w-1.25 shrink-0"
+				class:has-content={item.content}
+				class:themed={hasTheme}
+			></div>
+
+			<div class="flex w-full flex-col">
+				{#if item.content}
+					<div class="textBlock mt-1 mb-2">
+						<RichText plaintext={item.content.plaintext} facets={item.content.facets} {hasTheme} />
+					</div>
+				{/if}
+				{#if item.children && item.children.length > 0}
+					<UnorderedListBlock block={{ children: item.children }} {hasTheme} />
+				{/if}
+			</div>
+		</li>
+	{/each}
+</ul>
+
+<style>
+	.unordered-list {
+		list-style: none;
+		padding-left: 0;
+		margin-left: -1px;
+	}
+
+	@media (min-width: 640px) {
+		.unordered-list {
+			margin-left: 9px;
+		}
+	}
+
+	.listMarker {
+		background-color: transparent;
+	}
+
+	.listMarker.has-content {
+		border-radius: 9999px;
+		background-color: rgb(107 114 128); /* Default gray color */
+	}
+
+	.listMarker.has-content.themed {
+		background-color: var(--theme-accent);
+	}
+</style>

package/dist/components/document/blocks/UnorderedListBlock.svelte.d.ts

@@ -0,0 +1,9 @@
+import UnorderedListBlock from './UnorderedListBlock.svelte';
+declare const UnorderedListBlock: import("svelte").Component<{
+    block: {
+        children: ListItem[];
+    };
+    hasTheme?: boolean;
+}, {}, "">;
+type UnorderedListBlock = ReturnType<typeof UnorderedListBlock>;
+export default UnorderedListBlock;

package/dist/components/document/blocks/WebsiteBlock.svelte

@@ -0,0 +1,81 @@
+<script lang="ts">
+	function blobUrl(pds: string, did: string, cid: string): string {
+		return `${pds}/xrpc/com.atproto.sync.getBlob?did=${encodeURIComponent(did)}&cid=${encodeURIComponent(cid)}`;
+	}
+
+	interface BlobRef {
+		$type?: 'blob';
+		ref?: { $link: string };
+	}
+
+	interface Props {
+		block: {
+			/** Canonical field name per pub.leaflet.blocks.website lexicon */
+			src: string;
+			title?: string;
+			description?: string;
+			previewImage?: BlobRef;
+		};
+		did?: string;
+		pds?: string;
+		hasTheme?: boolean;
+	}
+
+	const { block, did = '', pds = '', hasTheme = false }: Props = $props();
+
+	const previewCid = $derived(block.previewImage?.ref?.$link ?? '');
+	const previewSrc = $derived(
+		previewCid && did && pds ? blobUrl(pds, did, previewCid) : ''
+	);
+</script>
+
+<div
+	class="group/linkBlock relative my-2 flex h-[104px] overflow-hidden rounded-md border bg-white transition-colors dark:bg-gray-900"
+	style:border-color={hasTheme ? 'var(--theme-accent)' : undefined}
+	class:border-gray-200={!hasTheme}
+	class:hover:border-gray-300={!hasTheme}
+	class:dark:border-gray-700={!hasTheme}
+	class:dark:hover:border-gray-600={!hasTheme}
+>
+	<a
+		href={block.src}
+		target="_blank"
+		rel="noopener noreferrer"
+		class="flex h-full w-full text-inherit no-underline hover:no-underline"
+	>
+		<div class="min-w-0 grow px-3 pt-2 pb-2">
+			<div class="flex h-full w-full min-w-0 flex-col">
+				{#if block.title}
+					<div
+						class="mb-0.5 line-clamp-1 text-base font-bold"
+						style="overflow: hidden; text-overflow: ellipsis; word-break: break-all;"
+					>
+						{block.title}
+					</div>
+				{/if}
+
+				{#if block.description}
+					<div class="line-clamp-2 grow text-sm text-gray-600 dark:text-gray-400">
+						{block.description}
+					</div>
+				{/if}
+
+				<div
+					class="line-clamp-1 w-full min-w-0 text-xs italic text-gray-500 group-hover/linkBlock:text-blue-600 dark:text-gray-500 dark:group-hover/linkBlock:text-blue-400"
+					style="word-break: break-word;"
+					style:color={hasTheme ? 'var(--theme-accent)' : undefined}
+				>
+					{block.src}
+				</div>
+			</div>
+		</div>
+
+		{#if previewSrc}
+			<div
+				class="m-2 -mb-2 w-[120px] shrink-0 origin-center rotate-[4deg] rounded-t-md border border-gray-200 bg-cover dark:border-gray-700"
+				style:background-image="url({previewSrc})"
+				style:background-position="center"
+			></div>
+		{/if}
+	</a>
+</div>

package/dist/components/document/blocks/WebsiteBlock.svelte.d.ts

@@ -0,0 +1,21 @@
+interface BlobRef {
+    $type?: 'blob';
+    ref?: {
+        $link: string;
+    };
+}
+interface Props {
+    block: {
+        /** Canonical field name per pub.leaflet.blocks.website lexicon */
+        src: string;
+        title?: string;
+        description?: string;
+        previewImage?: BlobRef;
+    };
+    did?: string;
+    pds?: string;
+    hasTheme?: boolean;
+}
+declare const WebsiteBlock: import("svelte").Component<Props, {}, "">;
+type WebsiteBlock = ReturnType<typeof WebsiteBlock>;
+export default WebsiteBlock;

package/dist/components/index.d.ts

@@ -0,0 +1,11 @@
+export { default as DocumentCard } from './DocumentCard.svelte';
+export { default as PublicationCard } from './PublicationCard.svelte';
+export { default as ThemeToggle } from './ThemeToggle.svelte';
+export { default as StandardSiteLayout } from './StandardSiteLayout.svelte';
+export { default as DateDisplay } from './common/DateDisplay.svelte';
+export { default as TagList } from './common/TagList.svelte';
+export { default as ThemedContainer } from './common/ThemedContainer.svelte';
+export { default as ThemedText } from './common/ThemedText.svelte';
+export { default as ThemedCard } from './common/ThemedCard.svelte';
+export { default as DocumentRenderer } from './document/DocumentRenderer.svelte';
+export { default as MarkdownRenderer } from './document/MarkdownRenderer.svelte';

package/dist/components/index.js

@@ -0,0 +1,13 @@
+export { default as DocumentCard } from './DocumentCard.svelte';
+export { default as PublicationCard } from './PublicationCard.svelte';
+export { default as ThemeToggle } from './ThemeToggle.svelte';
+export { default as StandardSiteLayout } from './StandardSiteLayout.svelte';
+// Common reusable components
+export { default as DateDisplay } from './common/DateDisplay.svelte';
+export { default as TagList } from './common/TagList.svelte';
+export { default as ThemedContainer } from './common/ThemedContainer.svelte';
+export { default as ThemedText } from './common/ThemedText.svelte';
+export { default as ThemedCard } from './common/ThemedCard.svelte';
+// Document rendering
+export { default as DocumentRenderer } from './document/DocumentRenderer.svelte';
+export { default as MarkdownRenderer } from './document/MarkdownRenderer.svelte';

package/dist/config/env.d.ts

@@ -0,0 +1,11 @@
+import type { SiteStandardConfig } from '../types.js';
+/**
+ * Get configuration from environment variables
+ * @returns Configuration object or null if required vars are missing
+ */
+export declare function getConfigFromEnv(): SiteStandardConfig | null;
+/**
+ * Validate that required environment variables are set
+ * @throws Error if required variables are missing
+ */
+export declare function validateEnv(): void;

package/dist/config/env.js

@@ -0,0 +1,26 @@
+import { env } from '$env/dynamic/public';
+/**
+ * Get configuration from environment variables
+ * @returns Configuration object or null if required vars are missing
+ */
+export function getConfigFromEnv() {
+    const did = env.PUBLIC_ATPROTO_DID;
+    if (!did) {
+        console.error('Missing required environment variable: PUBLIC_ATPROTO_DID');
+        return null;
+    }
+    return {
+        did,
+        pds: env.PUBLIC_ATPROTO_PDS || undefined,
+        cacheTTL: env.PUBLIC_CACHE_TTL ? parseInt(env.PUBLIC_CACHE_TTL) : undefined
+    };
+}
+/**
+ * Validate that required environment variables are set
+ * @throws Error if required variables are missing
+ */
+export function validateEnv() {
+    if (!env.PUBLIC_ATPROTO_DID) {
+        throw new Error('Missing required environment variable: PUBLIC_ATPROTO_DID');
+    }
+}

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+export { SiteStandardClient, createClient } from './client.js';
+export { StandardSitePublisher } from './publisher.js';
+export { DocumentCard, PublicationCard, ThemeToggle, StandardSiteLayout, DateDisplay, TagList, ThemedContainer, ThemedText, ThemedCard, DocumentRenderer, MarkdownRenderer } from './components/index.js';
+export { default as Comments } from './components/Comments.svelte';
+export { themeStore } from './stores/index.js';
+export type { AtProtoBlob, StrongRef, RGBColor, BasicTheme, PublicationPreferences, Publication, Document, AtProtoRecord, ResolvedIdentity, SiteStandardConfig } from './types.js';
+export type { PublisherConfig, ReaderConfig, LoaderConfig } from './schemas.js';
+export { COLLECTIONS } from './schemas.js';
+export { parseAtUri, atUriToHttps, buildAtUri, extractRkey, isAtUri } from './utils/at-uri.js';
+export { resolveIdentity, buildPdsBlobUrl } from './utils/agents.js';
+export { cache } from './utils/cache.js';
+export { rgbToCSS, rgbToHex, getThemeVars } from './utils/theme.js';
+export { mixThemeColor, getThemedTextColor, getThemedBackground, getThemedBorder, getThemedAccent, themeToCssVars } from './utils/theme-helpers.js';
+export { getDocumentSlug, getDocumentUrl, extractRkey as extractRkeyFromUri } from './utils/document.js';
+export { transformContent, convertSidenotes, convertComplexSidenotes, resolveRelativeLinks, stripToPlainText, countWords, calculateReadingTime } from './utils/content.js';
+export type { TransformOptions, TransformResult } from './utils/content.js';
+export { fetchComments, fetchMentionComments, formatRelativeTime } from './utils/comments.js';
+export type { Comment, CommentAuthor, FetchCommentsOptions } from './utils/comments.js';
+export { generatePublicationWellKnown, generateDocumentLinkTag, generatePublicationLinkTag, getDocumentAtUri, getPublicationAtUri, verifyPublicationWellKnown, extractDocumentLinkFromHtml, extractPublicationLinkFromHtml } from './utils/verification.js';
+export type { PublishDocumentInput, PublishPublicationInput, PublishResult } from './publisher.js';

package/dist/index.js

@@ -0,0 +1,23 @@
+// Main exports
+export { SiteStandardClient, createClient } from './client.js';
+export { StandardSitePublisher } from './publisher.js';
+// Component exports
+export { DocumentCard, PublicationCard, ThemeToggle, StandardSiteLayout, DateDisplay, TagList, ThemedContainer, ThemedText, ThemedCard, DocumentRenderer, MarkdownRenderer } from './components/index.js';
+// Comments component
+export { default as Comments } from './components/Comments.svelte';
+// Store exports
+export { themeStore } from './stores/index.js';
+export { COLLECTIONS } from './schemas.js';
+// Utility exports
+export { parseAtUri, atUriToHttps, buildAtUri, extractRkey, isAtUri } from './utils/at-uri.js';
+export { resolveIdentity, buildPdsBlobUrl } from './utils/agents.js';
+export { cache } from './utils/cache.js';
+export { rgbToCSS, rgbToHex, getThemeVars } from './utils/theme.js';
+export { mixThemeColor, getThemedTextColor, getThemedBackground, getThemedBorder, getThemedAccent, themeToCssVars } from './utils/theme-helpers.js';
+export { getDocumentSlug, getDocumentUrl, extractRkey as extractRkeyFromUri } from './utils/document.js';
+// Content transformation exports
+export { transformContent, convertSidenotes, convertComplexSidenotes, resolveRelativeLinks, stripToPlainText, countWords, calculateReadingTime } from './utils/content.js';
+// Comments exports
+export { fetchComments, fetchMentionComments, formatRelativeTime } from './utils/comments.js';
+// Verification exports
+export { generatePublicationWellKnown, generateDocumentLinkTag, generatePublicationLinkTag, getDocumentAtUri, getPublicationAtUri, verifyPublicationWellKnown, extractDocumentLinkFromHtml, extractPublicationLinkFromHtml } from './utils/verification.js';

package/dist/publisher.d.ts

@@ -0,0 +1,193 @@
+/**
+ * Publisher for standard.site documents
+ *
+ * Publishes documents to ATProto repositories using the standard.site lexicon,
+ * enabling your SvelteKit site to sync content to Leaflet, WhiteWind, or any
+ * compatible platform.
+ *
+ * The publisher automatically resolves the correct PDS from your DID document,
+ * so it works with any PDS (bsky.app, Blacksky, self-hosted, etc.).
+ *
+ * @example
+ * ```ts
+ * import { StandardSitePublisher } from 'svelte-standard-site/publisher';
+ *
+ * const publisher = new StandardSitePublisher({
+ *   identifier: 'your-handle.bsky.social',
+ *   password: process.env.ATPROTO_APP_PASSWORD!,
+ * });
+ *
+ * await publisher.login();
+ *
+ * await publisher.publishDocument({
+ *   site: 'https://myblog.com',
+ *   title: 'My Blog Post',
+ *   publishedAt: new Date().toISOString(),
+ * });
+ * ```
+ */
+import { AtpAgent } from '@atproto/api';
+import type { PublisherConfig, Document, Publication } from './schemas.js';
+export interface PublishDocumentInput {
+    /** Site/publication URI (https or at-uri) - REQUIRED */
+    site: string;
+    /** Document title - REQUIRED */
+    title: string;
+    /** When the document was published (ISO 8601) - REQUIRED */
+    publishedAt: string;
+    /** Path to combine with site URL */
+    path?: string;
+    /** Document description/excerpt */
+    description?: string;
+    /** When the document was last updated (ISO 8601) */
+    updatedAt?: string;
+    /** Tags/categories */
+    tags?: string[];
+    /** Plain text content for indexing */
+    textContent?: string;
+    /** Platform-specific content */
+    content?: unknown;
+    /** Reference to associated Bluesky post */
+    bskyPostRef?: {
+        uri: string;
+        cid: string;
+    };
+    /** Cover image blob */
+    coverImage?: {
+        $type: 'blob';
+        ref: {
+            $link: string;
+        };
+        mimeType: string;
+        size: number;
+    };
+    /** Document-level preferences (overrides publication defaults) */
+    preferences?: {
+        showInDiscover?: boolean;
+        showComments?: boolean;
+        showMentions?: boolean;
+        showPrevNext?: boolean;
+        showRecommends?: boolean;
+    };
+}
+export interface PublishPublicationInput {
+    /** Publication name */
+    name: string;
+    /** Base URL */
+    url: string;
+    /** Description */
+    description?: string;
+    /** Icon blob */
+    icon?: {
+        $type: 'blob';
+        ref: {
+            $link: string;
+        };
+        mimeType: string;
+        size: number;
+    };
+    /** Basic theme colors */
+    basicTheme?: {
+        background: {
+            r: number;
+            g: number;
+            b: number;
+        };
+        foreground: {
+            r: number;
+            g: number;
+            b: number;
+        };
+        accent: {
+            r: number;
+            g: number;
+            b: number;
+        };
+        accentForeground: {
+            r: number;
+            g: number;
+            b: number;
+        };
+    };
+    /** Publication preferences */
+    preferences?: {
+        showInDiscover?: boolean;
+        showComments?: boolean;
+        showMentions?: boolean;
+        showPrevNext?: boolean;
+        showRecommends?: boolean;
+    };
+}
+export interface PublishResult {
+    uri: string;
+    cid: string;
+}
+/**
+ * Publisher for standard.site documents on ATProto
+ */
+export declare class StandardSitePublisher {
+    private agent;
+    private config;
+    private did;
+    private pdsUrl;
+    constructor(config: Partial<PublisherConfig>);
+    /**
+     * Authenticate with the PDS
+     * Automatically resolves the correct PDS from the DID document
+     */
+    login(): Promise<void>;
+    /**
+     * Get the authenticated DID
+     */
+    getDid(): string;
+    /**
+     * Get the PDS URL being used
+     */
+    getPdsUrl(): string;
+    private getAgent;
+    /**
+     * Publish a document record
+     */
+    publishDocument(input: PublishDocumentInput): Promise<PublishResult>;
+    /**
+     * Update an existing document
+     */
+    updateDocument(rkey: string, input: PublishDocumentInput): Promise<PublishResult>;
+    /**
+     * Delete a document
+     */
+    deleteDocument(rkey: string): Promise<void>;
+    /**
+     * Publish a publication record
+     */
+    publishPublication(input: PublishPublicationInput): Promise<PublishResult>;
+    /**
+     * Update an existing publication
+     */
+    updatePublication(rkey: string, input: PublishPublicationInput): Promise<PublishResult>;
+    /**
+     * Delete a publication
+     */
+    deletePublication(rkey: string): Promise<void>;
+    /**
+     * Get all documents for the current account
+     */
+    listDocuments(limit?: number): Promise<Array<{
+        uri: string;
+        cid: string;
+        value: Document;
+    }>>;
+    /**
+     * Get all publications for the current account
+     */
+    listPublications(limit?: number): Promise<Array<{
+        uri: string;
+        cid: string;
+        value: Publication;
+    }>>;
+    /**
+     * Get the underlying ATP agent for advanced operations
+     */
+    getAtpAgent(): AtpAgent;
+}
+export type { PublisherConfig };