@sevenfold/setto-client 0.2.9 → 0.3.3

package/dist/SettoIcon.d.ts

@@ -0,0 +1,20 @@
+import { type ComponentType, type CSSProperties } from 'react';
+export interface SettoIconProps {
+    /** i18n key storing the Lucide icon name, e.g. `problem.cards.complicated.icon`. */
+    k: string;
+    /** Map of icon name → Lucide component (provided by the host site). */
+    icons: Record<string, ComponentType<SettoIconRenderProps>>;
+    size?: number;
+    className?: string;
+    style?: CSSProperties;
+}
+export interface SettoIconRenderProps {
+    size?: number;
+    className?: string;
+    style?: CSSProperties;
+}
+/**
+ * Renders an icon whose identity is stored in i18n. In edit mode, click to open
+ * an icon browser and pick a replacement.
+ */
+export declare function SettoIcon({ k, icons, size, className, style }: SettoIconProps): import("react/jsx-runtime").JSX.Element | null;

package/dist/SettoImage.d.ts

@@ -0,0 +1,10 @@
+import { type ImgHTMLAttributes } from 'react';
+export interface SettoImageProps extends Omit<ImgHTMLAttributes<HTMLImageElement>, 'src'> {
+    /** i18n key for the public URL path, e.g. `hero.illustrationSrc`. */
+    srcKey: string;
+}
+/**
+ * Renders an image whose src is stored in i18n. In edit mode, hover to upload
+ * a replacement — saved under `public/images/setto/` on publish.
+ */
+export declare function SettoImage({ srcKey, alt, className, style, ...rest }: SettoImageProps): import("react/jsx-runtime").JSX.Element;

package/dist/SettoRepeater.d.ts

@@ -0,0 +1,15 @@
+import { type ReactNode } from 'react';
+export interface SettoRepeaterProps {
+    /** List prefix in i18n, e.g. `faq.items`. */
+    itemsKey: string;
+    /** Default field values for a newly added item. */
+    defaultItem: Record<string, string>;
+    /** Label shown on add/remove controls. */
+    itemLabel?: string;
+    children: (itemKey: string, index: number) => ReactNode;
+    className?: string;
+}
+/**
+ * Renders a dynamic list from i18n. In edit mode, editors can add and remove items.
+ */
+export declare function SettoRepeater({ itemsKey, defaultItem, itemLabel, children, className, }: SettoRepeaterProps): import("react/jsx-runtime").JSX.Element;

package/dist/edit-mode/floating-popover.d.ts

@@ -0,0 +1,17 @@
+import { type CSSProperties, type ReactNode } from 'react';
+export interface PopoverPosition {
+    top: number;
+    left: number;
+}
+interface FloatingPopoverProps {
+    open: boolean;
+    anchorRef: React.RefObject<HTMLElement | null>;
+    onClose: () => void;
+    ariaLabel: string;
+    children: ReactNode;
+    style?: CSSProperties;
+    minWidth?: number;
+}
+/** Anchored popover portal used by icon picker and similar edit UI. */
+export declare function FloatingPopover({ open, anchorRef, onClose, ariaLabel, children, style, minWidth, }: FloatingPopoverProps): import("react").ReactPortal | null;
+export {};

package/dist/index.d.ts

@@ -2,8 +2,14 @@ export { SettoProvider, useSetto } from './provider';
 export { T } from './T';
 export { SettoSection } from './SettoSection';
 export { SettoBlock } from './SettoBlock';
+export { SettoIcon } from './SettoIcon';
+export type { SettoIconProps, SettoIconRenderProps } from './SettoIcon';
+export { SettoImage } from './SettoImage';
+export type { SettoImageProps } from './SettoImage';
+export { SettoRepeater } from './SettoRepeater';
+export type { SettoRepeaterProps } from './SettoRepeater';
 export { useSectionTheme } from './use-section-theme';
 export { SettoAdminApp } from './admin/App';
 export { AuthGate } from './edit-mode/auth-gate';
-export type { SettoConfig, BrandColor, DeploymentRow, SiteRow, ContentFile, PublishResult, } from './types';
+export type { SettoConfig, BrandColor, DeploymentRow, SiteRow, ContentFile, PublishFile, PublishResult, } from './types';
 export type { SectionSchema, SectionColorField } from './section-schema';

package/dist/lib/api.d.ts

@@ -1,5 +1,6 @@
 import type { SupabaseClient } from '@supabase/supabase-js';
-import type { ContentFile, PublishResult } from '../types';
+import type { ContentFile, PublishFile, PublishResult } from '../types';
+import type { AssetDraft } from './asset-store';
 export declare function createApi(args: {
     apiUrl: string;
     supabase: SupabaseClient;
@@ -7,10 +8,10 @@ export declare function createApi(args: {
     getContent(siteId: string): Promise<{
         files: ContentFile[];
     }>;
-    publish(siteId: string, files: Array<{
-        path: string;
-        content: string;
-    }>, message?: string): Promise<PublishResult>;
+    publish(siteId: string, files: PublishFile[], options?: {
+        message?: string;
+        assets?: AssetDraft[];
+    }): Promise<PublishResult>;
     expireStaleDeployments(siteId: string): Promise<{
         expired: number;
     }>;

package/dist/lib/asset-store.d.ts

@@ -0,0 +1,45 @@
+export interface AssetDraft {
+    /** i18n key for the image src, e.g. `hero.illustrationSrc`. */
+    srcKey: string;
+    /** GitHub repo path, e.g. `public/images/setto/hero-illustration-123.jpg`. */
+    repoPath: string;
+    /** Public URL path, e.g. `/images/setto/hero-illustration-123.jpg`. */
+    publicPath: string;
+    /** Src path before this upload (for revert). */
+    originalPublicPath: string;
+    /** Raw file bytes — published as binary via multipart, not base64 JSON. */
+    file: File;
+    /** Object URL for in-session preview. */
+    previewUrl: string;
+}
+export interface AssetStoreSnapshot {
+    drafts: Map<string, AssetDraft>;
+    version: number;
+}
+export declare const EMPTY_ASSET_STORE_SNAPSHOT: AssetStoreSnapshot;
+type Listener = (snap: AssetStoreSnapshot) => void;
+export declare class AssetStore {
+    private drafts;
+    private version;
+    private listeners;
+    private cachedSnapshot;
+    snapshot(): AssetStoreSnapshot;
+    subscribe(listener: Listener): () => void;
+    /** Returns a preview URL if a draft exists for this src key. */
+    getPreviewUrl(srcKey: string): string | null;
+    set(args: {
+        srcKey: string;
+        originalPublicPath: string;
+        repoPath: string;
+        publicPath: string;
+        file: File;
+    }): Promise<void>;
+    revert(srcKey: string): string | null;
+    revertAll(): void;
+    commit(): void;
+    size(): number;
+    pendingAssets(): AssetDraft[];
+    static isValidRepoPath(path: string): boolean;
+    private bump;
+}
+export {};

package/dist/lib/i18n-store.d.ts

@@ -63,6 +63,17 @@ export declare class I18nStore {
     commit(): void;
     /** Number of pending draft entries across all languages. */
     size(): number;
+    /** Returns sorted item keys under a list prefix, e.g. `faq.items` → ['1','2',…]. */
+    getListKeys(prefix: string, lng: string): string[];
+    /**
+     * Adds a new list item under `prefix` with the given field defaults.
+     * Adds the same key across all loaded languages.
+     */
+    addListItem(prefix: string, _lng: string, template: Record<string, string>): string;
+    /** Removes a list item and all nested keys under `prefix.itemKey` in every language. */
+    removeListItem(prefix: string, itemKey: string, _lng: string): void;
+    /** Re-sorts list keys after removal (optional compaction — not used by default). */
+    sortListKeys(prefix: string, lng: string): string[];
     /**
      * Serialises the full resource bundle per language as it currently looks in
      * i18next (with drafts applied). Used as the payload for /publish.

package/dist/lib/image-paths.d.ts

@@ -0,0 +1,12 @@
+/** GitHub repo directory for editor-uploaded images. */
+export declare const SETTO_IMAGE_REPO_DIR = "public/images/setto";
+/** Public URL prefix served by the host site. */
+export declare const SETTO_IMAGE_URL_PREFIX = "/images/setto";
+export declare function extensionFromMime(mime: string): string;
+/** Builds repo + public paths for a newly uploaded Setto image. */
+export declare function generateSettoImagePaths(srcKey: string, file: File): {
+    repoPath: string;
+    publicPath: string;
+};
+/** Returns true when `path` matches an exact entry or a directory prefix entry. */
+export declare function isContentPathAllowed(path: string, allowed: string[]): boolean;

package/dist/lib/nested-resource.d.ts

@@ -0,0 +1,9 @@
+/** Reads a dotted key path from a nested object. */
+export declare function getNested(obj: unknown, key: string): unknown;
+/** Sets a dotted key path on a nested object (mutates in place). */
+export declare function setNested(obj: Record<string, unknown>, key: string, value: unknown): void;
+/** Deletes a dotted key path from a nested object (mutates in place). */
+export declare function deleteNested(obj: Record<string, unknown>, key: string): void;
+/** Collects all dotted keys under a prefix from a nested object. */
+export declare function collectKeysUnder(obj: unknown, prefix: string): string[];
+export declare function compareListKeys(a: string, b: string): number;

package/dist/provider.d.ts

@@ -2,6 +2,7 @@ import { type ReactNode } from 'react';
 import type { SupabaseClient, Session } from '@supabase/supabase-js';
 import { type SettoApi } from './lib/api';
 import { I18nStore } from './lib/i18n-store';
+import { AssetStore } from './lib/asset-store';
 import { ThemeStore } from './lib/theme-store';
 import type { SettoConfig } from './types';
 interface SettoContextValue {
@@ -19,6 +20,7 @@ interface SettoContextValue {
      */
     store: I18nStore | null;
     themeStore: ThemeStore | null;
+    assetStore: AssetStore | null;
 }
 export interface SettoProviderProps {
     config: SettoConfig;