@sevenfold/setto-client 0.15.0 → 0.17.0

package/dist/LanguageSwitcher.d.ts

@@ -0,0 +1,40 @@
+/**
+ * The control a visitor uses to read the site in their own language.
+ *
+ * Mounted by `SettoProvider` rather than placed by the agent, and only when
+ * the site actually speaks more than one language — so it costs a Norwegian
+ * plumber's site nothing, and a site that gains a second language grows the
+ * control without anybody editing a header.
+ *
+ * That decision is worth stating because it is a trade. Auto-mounting means
+ * the switcher cannot sit inside a design it knows nothing about, so it sits
+ * in a corner instead: quiet, small, and out of the way of whatever the agent
+ * built. A site that wants it in its own header can render `<SettoLanguages>`
+ * anywhere and pass `inline`, and the floating one stands down.
+ *
+ * Styling is inline for the same reason the editing chrome's is: this renders
+ * inside a page whose stylesheet Setto did not write, and most of these sites
+ * ship Tailwind's Preflight, which would otherwise strip a bare `<button>`
+ * back to nothing.
+ */
+export interface SettoLanguagesProps {
+    /** Every language the site speaks, primary first. */
+    languages: readonly string[];
+    /**
+     * Rendered in the flow of the page rather than fixed in a corner.
+     *
+     * Also tells the auto-mounted copy to stand down, so a site that places its
+     * own switcher does not end up with two.
+     */
+    inline?: boolean;
+}
+export declare function SettoLanguages({ languages, inline }: SettoLanguagesProps): import("react/jsx-runtime").JSX.Element | null;
+/**
+ * The floating copy, mounted by the provider.
+ *
+ * Renders nothing when the site places its own, and nothing when there is only
+ * one language to be in.
+ */
+export declare function AutoLanguageSwitcher({ languages }: {
+    languages: readonly string[];
+}): import("react/jsx-runtime").JSX.Element | null;

package/dist/chrome.d.ts

@@ -42,7 +42,7 @@ export interface SettoChromeHandshake {
      * keeps a chrome bundle that fails to load, or throws while rendering, from
      * taking the editor down with it.
      */
-    mountSlot: (name: string, Component: React.ComponentType) => void;
+    mountSlot: (name: string, Component: React.ComponentType<any>) => void;
     /**
      * The host's own `useSetto`, callable from the chrome.
      *
@@ -89,7 +89,7 @@ declare global {
  * offered nothing — including after it offered something that threw. Callers
  * render their own version when this is null; every one of them must have one.
  */
-export declare function useSettoChromeSlot(name: string): React.ComponentType | null;
+export declare function useSettoChromeSlot<P extends object = Record<string, never>>(name: string): React.ComponentType<P> | null;
 /** @deprecated Use `useSettoChromeSlot('admin')`. */
-export declare function useSettoAdminChrome(): React.ComponentType | null;
+export declare function useSettoAdminChrome(): React.ComponentType<Record<string, never>> | null;
 export declare function SettoChrome(): import("react/jsx-runtime").JSX.Element | null;

package/dist/index.d.ts

@@ -1,6 +1,7 @@
+export { SettoLanguages } from './LanguageSwitcher';
+export { DEFAULT_LANGUAGE, languageName, pickInitialLanguage, siteLanguages, } from './lib/languages';
 export { SettoProvider, useSetto } from './provider';
 export { GuestEditProvider, useGuestEdit } from './guest-edit';
-export { SettoPreviewBar, isPreviewHost, previewBarState } from './preview-bar';
 export { SettoChrome, useSettoChromeSlot } from './chrome';
 export type { SettoChromeHandshake } from './chrome';
 export { T } from './T';
@@ -12,7 +13,7 @@ export { SettoImage } from './SettoImage';
 export type { SettoImageProps } from './SettoImage';
 export { SettoRepeater } from './SettoRepeater';
 export type { SettoRepeaterProps } from './SettoRepeater';
-export { SettoForm, FORM_FIELD_TYPES, FORM_FIELD_TYPE_LABELS, formFieldsPrefix, isFormFieldType, readLocaleFields, settoSubmissionUrl, } from './modules/forms';
+export { SettoForm, FORM_FIELD_TYPES, FORM_FIELD_TYPE_LABELS, fieldTypeHasOptions, fieldTypeHasPlaceholder, formFieldsPrefix, isFormFieldType, readLocaleFields, settoSubmissionUrl, } from './modules/forms';
 export type { SettoFormProps, SettoFormClassNames, FormFieldProp, FormSettings, FormSubmissionRow, FormValue, FormValues, ResolvedFormField, SubmissionEnvelope, } from './modules/forms';
 export { SETTO_MODULES } from './modules';
 export type { SettoModule } from './modules';
@@ -36,9 +37,10 @@ export { BLOCK_REGISTRY, BLOCK_TYPES, nodeChildren } from './block-tree/registry
 export type { BlockTypeMeta } from './block-tree/registry';
 export { SETTO_BASE, siteHomeUrl, isAdminRoute, isAdminDeploymentView, adminViewUrl, currentAdminView, isAdminPanelView, adminRedirectUrl, CHECKOUT_INTENT, checkoutIntentUrl, wantsCheckout, withoutCheckoutIntent, } from './lib/urls';
 export { SettoMark } from './edit-mode/setto-mark';
+export { FloatingPopover } from './edit-mode/floating-popover';
+export type { FieldPatch, FormFieldToolsProps, FormFieldToolsComponent, } from './modules/forms/field-tools';
 export { isLinkContext } from './lib/link-context';
 export { useCoarsePointer } from './lib/use-coarse-pointer';
 export { FAB_SIZE, FAB_INSET } from './edit-mode/constants';
 export { EMPTY_I18N_STORE_SNAPSHOT } from './lib/i18n-store';
 export type { I18nStoreSnapshot } from './lib/i18n-store';
-export { IN_PROGRESS_STATUSES, isDeploymentInProgress, isDeploymentStale, STALE_PENDING_MS, STALE_BUILDING_MS, fetchInProgressDeploymentId, waitForDeploymentByCommit, useDeploymentStatus, PublishProgressBar, PublishProgressSteps, } from './edit-mode/deployment-status';

package/dist/lib/languages.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Which languages a site speaks, and which one a visitor is reading.
+ *
+ * Every Setto site has been Norwegian-only, not because the machinery could
+ * not hold more — `I18nStore` has taken a language argument since the
+ * beginning and the publish path already serialises one bundle per language —
+ * but because nothing ever told a site it had a second one, and nothing gave a
+ * visitor a way to ask for it.
+ *
+ * The choice is deliberately per browser and not per URL. A path prefix
+ * (`/en/…`) is the better answer for search engines and the wrong answer for
+ * this pipeline today: every site is a single-page app whose routes the agent
+ * writes, and quietly doubling every route is not a thing to do to thirteen
+ * live sites in one release. Recorded here rather than hidden: when these
+ * sites want to be found in two languages, this is the decision to revisit.
+ */
+/** Norwegian is the floor: every site has it, and it is what the agent writes. */
+export declare const DEFAULT_LANGUAGE = "no";
+/** «Norsk», or the tag itself when we have no name for it. */
+export declare function languageName(tag: string): string;
+/**
+ * The languages this site actually speaks, primary first, no duplicates.
+ *
+ * A configured list that forgets to include the primary language is a site
+ * whose own copy is unreachable, so the primary is inserted rather than
+ * trusted.
+ */
+export declare function siteLanguages(configured: readonly string[] | undefined, primary?: string): string[];
+/** What this browser last chose here, if anything. */
+export declare function readStoredLanguage(): string | null;
+export declare function storeLanguage(tag: string): void;
+/**
+ * The language to open in.
+ *
+ * Their own previous choice first — it is the only signal that is definitely
+ * about this site. Then what the browser asks for, matched on the base tag so
+ * `en-GB` finds `en`. Then the site's primary, which is always present.
+ *
+ * Note what is *not* here: no geolocation, and no guessing from a domain. A
+ * Norwegian abroad is still Norwegian, and a site that decides it knows better
+ * than `Accept-Language` is a site people fight with.
+ */
+export declare function pickInitialLanguage(available: readonly string[], browserLanguages?: readonly string[], stored?: string | null): string;

package/dist/modules/forms/field-tools.d.ts

@@ -0,0 +1,35 @@
+import type { ComponentType } from 'react';
+import type { FormFieldType, ResolvedFormField } from './fields';
+/**
+ * The contract between a form on the customer's page and the editing tools
+ * Setto serves for it.
+ *
+ * The tools themselves — the popover, the type picker, the reordering — live
+ * in setto-server and arrive at runtime, so changing them is a deploy. What
+ * has to stay here is the shape of the conversation between the two, because
+ * `SettoForm` applies the patch and it is compiled into the customer's bundle.
+ *
+ * That makes this the pinned part, and it is deliberately data: adding a field
+ * kind means widening `FormFieldType`, but rearranging the panel that sets one
+ * costs nothing on this side.
+ */
+export interface FieldPatch {
+    name?: string;
+    type?: FormFieldType;
+    required?: boolean;
+    label?: string;
+    placeholder?: string;
+    options?: string;
+}
+export interface FormFieldToolsProps {
+    field: ResolvedFormField;
+    index: number;
+    count: number;
+    /** Open the settings popover as soon as the tools mount (a field just added). */
+    autoOpen?: boolean;
+    onMove: (direction: -1 | 1) => void;
+    onRemove: () => void;
+    onChange: (patch: FieldPatch) => void;
+}
+/** What the chrome registers under `mountSlot('form-field-tools', …)`. */
+export type FormFieldToolsComponent = ComponentType<FormFieldToolsProps>;

package/dist/modules/forms/index.d.ts

@@ -8,5 +8,5 @@ export declare const formsModule: SettoModule;
 export { SettoForm } from './SettoForm';
 export type { SettoFormProps, SettoFormClassNames } from './SettoForm';
 export type { FormSettings, FormSubmissionRow, FormsApi } from './api';
-export { FORM_FIELD_TYPES, FORM_FIELD_TYPE_LABELS, formFieldsPrefix, isFormFieldType, readLocaleFields, settoSubmissionUrl, } from './fields';
+export { FORM_FIELD_TYPES, FORM_FIELD_TYPE_LABELS, fieldTypeHasOptions, fieldTypeHasPlaceholder, formFieldsPrefix, isFormFieldType, readLocaleFields, settoSubmissionUrl, } from './fields';
 export type { FormFieldProp, FormFieldType, FormValue, FormValues, ResolvedFormField, SubmissionEnvelope, } from './fields';