alinea 2.0.0-preview.3 → 2.0.0-preview.5

package/dist/bundled.d.ts

@@ -133,17 +133,26 @@ declare module 'alinea/adapter/next/previews.spec' {
   
 }
 
+declare module 'alinea/adapter/next/syncCheck' {
+
+  import type { Client } from 'alinea/core/Client';
+  import type { LocalDB } from 'alinea/core/db/LocalDB';
+  export const CONTENT_SHA_TAG = "alinea-content-sha";
+  export function revalidateContentSha(): Promise<void>;
+  /**
+   * Sync the isolate-local db only when it is behind the shared content sha.
+   * Returns true when the freshness question is settled here (synced, forced,
+   * or explicitly disabled) and the caller can skip its throttled sync.
+   * Returns false when the sha could not be determined, so the caller falls
+   * back to its existing throttle behavior.
+   */
+  export function syncIfStale(db: LocalDB, client: Client, syncInterval?: number): Promise<boolean>;
+  
+}
+
 declare module 'alinea/adapter/next/with-alinea' {
 
   import type { NextConfig } from 'next/dist/types.js';
-  export interface WithAlineaOptions {
-      /**
-       * Base path where the dashboard is mounted.
-       *
-       * @default '/admin'
-       */
-      adminPath?: string;
-  }
   export function createCMS(): void;
   export function withAlinea(config?: NextConfig): NextConfig;
   
@@ -187,7 +196,7 @@ declare module 'alinea/backend/api/BasicAuth' {
   export class BasicAuth implements AuthApi {
       #private;
       constructor(context: RequestContext, verify: Verifier);
-      authenticate(request: Request, options?: AuthOptions): Promise<Response>;
+      authenticate(request: Request, options: AuthOptions): Promise<Response>;
       verify(request: Request): Promise<AuthedContext>;
   }
   
@@ -331,20 +340,28 @@ declare module 'alinea/backend/api/OAuth2' {
        */
       revocationEndpoint?: string;
       /**
-       * Extra claims to validate, such as `iss` or `aud`,
+       * Validate provider-specific claims, including `iss` and `aud`.
        * If the claims are invalid, an error should be thrown.
        */
-      validateClaims?(claims: JWTPayload): void;
+      validateClaims(claims: JWTPayload): void | Promise<void>;
   }
   export class OAuth2 implements AuthApi {
       #private;
       constructor(context: RequestContext, config: Config, options: OAuth2Options);
-      authenticate(request: Request, options?: AuthOptions): Promise<Response>;
+      authenticate(request: Request, options: AuthOptions): Promise<Response>;
       verify(request: Request): Promise<AuthedContext>;
   }
   
 }
 
+declare module 'alinea/backend/api/ProxyMedia' {
+
+  import { type Request, Response } from '@alinea/iso';
+  export function proxyMediaUrl(request: Request, source: URL, isAllowed?: (url: URL) => boolean): Promise<Response>;
+  export function isRedirectStatus(status: number): boolean;
+  
+}
+
 declare module 'alinea/backend/api/S3Uploads' {
 
   import type { UploadMetadata, UploadResponse, UploadsApi } from 'alinea/core/Connection';
@@ -362,7 +379,7 @@ declare module 'alinea/backend/api/S3Uploads' {
       previewExpiresIn?: number;
   }
   interface S3PresignOptions {
-      method: 'GET' | 'PUT';
+      method: 'GET' | 'HEAD' | 'PUT';
       url: URL;
       region: string;
       accessKeyId: string;
@@ -957,7 +974,7 @@ declare module 'alinea/cli/serve/CreateLocalServer' {
   import type { Handler } from 'alinea/backend/Handler';
   import type { CMS } from 'alinea/core/CMS';
   import type { User } from 'alinea/core/User';
-  import { type Request, Response } from '@alinea/iso';
+  import { Request, Response } from '@alinea/iso';
   import type { ServeContext } from 'alinea/cli/serve/ServeContext';
   export function createLocalServer({ cmd, configLocation, rootDir, staticDir, alineaDev, buildOptions, production, liveReload, buildId, apiKey }: ServeContext, cms: CMS, handleApi: Handler, user: User): {
       close(): void;
@@ -1100,6 +1117,12 @@ declare module 'alinea/cli/util/CommitSha' {
   
 }
 
+declare module 'alinea/cli/util/ContentType' {
+
+  export function contentType(extension: string): string;
+  
+}
+
 declare module 'alinea/cli/util/Dirname' {
 
   export function dirname(url?: string): string;
@@ -1225,6 +1248,7 @@ declare module 'alinea/cli/util/Watcher' {
 
 declare module 'alinea/cloud/AuthResult' {
 
+  import type { BackendCapabilities } from 'alinea/core/Connection';
   import type { User } from 'alinea/core/User';
   export enum AuthResultType {
       Authenticated = 0,
@@ -1235,6 +1259,7 @@ declare module 'alinea/cloud/AuthResult' {
   export type AuthResult = {
       type: AuthResultType.Authenticated;
       user: User;
+      capabilities?: BackendCapabilities;
   } | {
       type: AuthResultType.UnAuthenticated;
       redirect: string;
@@ -1270,6 +1295,24 @@ declare module 'alinea/cloud/CloudConfig' {
   
 }
 
+declare module 'alinea/cloud/CloudHandshake' {
+
+  interface VerifyCloudHandshakeOptions {
+      clientId: string;
+      handshakeId: string;
+      origin: string;
+  }
+  export class CloudHandshakeError extends Error {
+      name: string;
+  }
+  export class CloudHandshakeServiceError extends Error {
+      name: string;
+  }
+  export function verifyCloudHandshake(token: string, options: VerifyCloudHandshakeOptions): Promise<void>;
+  export {};
+  
+}
+
 declare module 'alinea/cloud/CloudRemote' {
 
   import { OAuth2 } from 'alinea/backend/api/OAuth2';
@@ -1284,12 +1327,15 @@ declare module 'alinea/cloud/CloudRemote' {
   export class CloudRemote extends OAuth2 implements RemoteConnection {
       #private;
       constructor(context: RequestContext, config: Config);
+      capabilities(): Promise<{
+          users: boolean;
+      }>;
       getTreeIfDifferent(sha: string): Promise<ReadonlyTree | undefined>;
       getBlobs(shas: ReadonlyArray<string>, options?: GetBlobsOptions): AsyncGenerator<[sha: string, blob: Uint8Array]>;
       write(request: CommitRequest): Promise<{
           sha: string;
       }>;
-      authenticate(request: Request, options?: AuthOptions): Promise<globalThis.Response>;
+      authenticate(request: Request, options: AuthOptions): Promise<globalThis.Response>;
       prepareUpload(file: string, metadata?: UploadMetadata): Promise<{
           entryId: string;
           location: string;
@@ -1631,7 +1677,7 @@ declare module 'alinea/components/List' {
       description?: ReactNode;
       inline?: boolean;
   }
-  export function ListLabel({ children, expanded, hasRows, shared, showFold, className, description, inline, ...props }: ListLabelProps): import("react").JSX.Element;
+  export function ListLabel({ children, expanded, hasRows, shared, showFold, className, description, inline, ...props }: ListLabelProps): import("react").JSX.Element | null;
   export interface ListErrorProps extends ComponentPropsWithoutRef<'div'> {
   }
   export function ListError({ className, ...props }: ListErrorProps): import("react").JSX.Element;
@@ -1945,7 +1991,7 @@ declare module 'alinea/components/Toggle' {
 
   import { type ToggleButtonGroupProps as ToggleButtonGroupPrimitiveProps, type ToggleButtonProps as ToggleButtonPrimitiveProps } from 'react-aria-components';
   export interface ToggleButtonGroupProps extends ToggleButtonGroupPrimitiveProps {
-      variant?: 'compact' | 'enclosed';
+      variant?: 'compact' | 'enclosed' | 'icon-small';
   }
   export function ToggleButtonGroup({ variant, className, ...props }: ToggleButtonGroupProps): import("react").JSX.Element;
   export interface ToggleButtonProps extends ToggleButtonPrimitiveProps {
@@ -2155,7 +2201,7 @@ declare module 'alinea/core/Config' {
       preview?: Preview;
       /** Every edit will pass through a draft status before being published */
       enableDrafts?: boolean;
-      /** The interval in seconds at which the frontend will poll for updates */
+      /** Fallback interval in seconds for polling content updates (freshness is primarily sha-driven) */
       syncInterval?: number;
       /** Maximum file upload size in bytes */
       maxUploadSize?: number;
@@ -2166,9 +2212,14 @@ declare module 'alinea/core/Config' {
       };
       /** The url of the handler endpoint */
       handlerUrl?: string;
-      /** The folder where public assets are stored, defaults to /public */
+      /** The public path where Alinea is mounted, defaults to /admin */
+      adminPath?: string;
+      /** The folder where public assets are stored, defaults to /public. */
       publicDir?: string;
-      /** Filename of the generated dashboard, defaults to admin.html */
+      /**
+       * Filename of the generated dashboard, defaults to admin.html.
+       * @deprecated Use adminPath instead.
+       */
       dashboardFile?: string;
       /** Optional application-owned instrumentation for Alinea operations. */
       tracer?: Tracer;
@@ -2178,6 +2229,8 @@ declare module 'alinea/core/Config' {
       function baseUrl(config: Config, env?: string): string | undefined;
       function handlerUrl(config: Config): string;
       function adminPath(config: Config): string;
+      function filePathname(config: Config, file: string): string;
+      function dashboardFile(config: Config): string;
       function mainWorkspace(config: Config): WorkspaceInternal;
       function type(config: Config, name: string): Type | undefined;
       function rootContains(config: Config, root: Root, childType: Type): boolean;
@@ -2206,11 +2259,15 @@ declare module 'alinea/core/Connection' {
   import type { ReadonlyTree } from 'alinea/core/source/Tree';
   import type { User, UserInput } from 'alinea/core/User';
   export interface AuthApi {
-      authenticate(request: Request, options?: AuthOptions): Promise<Response>;
+      authenticate(request: Request, options: AuthOptions): Promise<Response>;
       verify(request: Request): Promise<AuthedContext>;
   }
   export interface AuthOptions {
-      enrichUser?(user: User): Promise<User>;
+      authenticated(user: User): Promise<AuthenticatedUser>;
+  }
+  export interface AuthenticatedUser {
+      user: User;
+      capabilities: BackendCapabilities;
   }
   export interface UserApi {
       enrichUser(user: User): Promise<User>;
@@ -2223,7 +2280,7 @@ declare module 'alinea/core/Connection' {
       users: boolean;
   }
   export interface CapabilitiesApi {
-      capabilities?(): Promise<BackendCapabilities>;
+      capabilities(): Promise<BackendCapabilities>;
   }
   export interface RemoteConnection extends Connection, AuthApi, CapabilitiesApi {
   }
@@ -2231,7 +2288,6 @@ declare module 'alinea/core/Connection' {
       logout?(): Promise<void>;
   }
   export interface LocalConnection extends Connection, CapabilitiesApi {
-      capabilities(): Promise<BackendCapabilities>;
       mutate(mutations: Array<Mutation>): Promise<{
           sha: string;
       }>;
@@ -2467,6 +2523,8 @@ declare module 'alinea/core/db/EntryIndex' {
       constructor(config: Config, versionData: Map<string, EntryVersionData>, seeds: Map<string, Seed>);
       byId(id: string): EntryNode | undefined;
       candidateNodes(query: EntryNodeQuery): Array<EntryNode> | undefined;
+      byUrl(url: string): Iterable<Entry>;
+      byAlias(alias: string): Iterable<Entry>;
       get config(): Config;
       byDir(dir: string): EntryNode | undefined;
       entryByFilePath(filePath: string): Entry | undefined;
@@ -2484,6 +2542,7 @@ declare module 'alinea/core/db/EntryIndex' {
       filter(filter: EntryCondition): Iterable<Entry>;
       findFirst<T extends Record<string, unknown>>(filter: (entry: Entry) => boolean): Entry<T> | undefined;
       findMany(filter: (entry: Entry) => boolean): Iterable<Entry>;
+      findByUrl(url: string, filter: (entry: Entry) => boolean): Entry | undefined;
       referencesTo(query: EntryReferenceQuery): Promise<EntryReferenceResult>;
       referencesFrom(sourceId: string): Promise<import("alinea/core/db/EntryReference").EntryReference[]>;
       get references(): Promise<EntryReferenceIndex>;
@@ -2734,13 +2793,19 @@ declare module 'alinea/core/db/LinkResolver' {
 
   import type { InferProjection, Projection } from 'alinea/core/Graph';
   import type { EntryResolver, ResolveContext } from 'alinea/core/db/EntryResolver';
+  export interface LinkTarget {
+      entryId: string;
+      locale?: string;
+  }
   export class LinkResolver {
       resolver: EntryResolver;
       private ctx;
       locale: string | null;
       constructor(resolver: EntryResolver, ctx: ResolveContext, locale: string | null);
-      includedAtBuild(filePath: string): boolean;
-      resolveLinks<P extends Projection>(projection: P, entryIds: ReadonlyArray<string>): Promise<Array<InferProjection<P>>>;
+      resolveLinks<P extends Projection>(projection: P, entryIds: ReadonlyArray<string>, locale?: string | null | undefined): Promise<Array<InferProjection<P>>>;
+      resolveTargets<P extends Projection & {
+          id: unknown;
+      }>(projection: P, targets: ReadonlyArray<LinkTarget>): Promise<Array<InferProjection<P> | undefined>>;
   }
   
 }
@@ -3135,6 +3200,10 @@ declare module 'alinea/core/Entry' {
   export interface EntryAlias {
       url: string;
   }
+  export interface EntryAuditUser {
+      email: string;
+      name: string;
+  }
   export const Entry: {
       id: Expr<string>;
       status: Expr<EntryStatus>;
@@ -3159,7 +3228,9 @@ declare module 'alinea/core/Entry' {
       url: Expr<string>;
       aliases: Expr<EntryAlias[]>;
       createdAt: Expr<number | null>;
+      createdBy: Expr<EntryAuditUser | null>;
       updatedAt: Expr<number | null>;
+      updatedBy: Expr<EntryAuditUser | null>;
       data: Expr<Record<string, any>>;
       searchableText: Expr<string>;
   };
@@ -3693,9 +3764,9 @@ declare module 'alinea/core/Graph' {
       filter?: Filter<EntryFields>;
       /** Filter by search terms */
       search?: string | Array<string>;
-      /** The time in seconds to poll for updates to content */
+      /** Fallback interval in seconds for polling content updates (freshness is primarily sha-driven) */
       syncInterval?: number;
-      /** Disable polling for updates to content */
+      /** Disable syncing content updates */
       disableSync?: boolean;
       /** Skip the first N results */
       skip?: number;
@@ -3785,6 +3856,7 @@ declare module 'alinea/core/HttpError' {
 declare module 'alinea/core/Id' {
 
   export function validateId(id: string): boolean;
+  export function timestampFromId(id: string): number | undefined;
   export function createId(): string;
   
 }
@@ -3950,35 +4022,25 @@ declare module 'alinea/core/media/MediaAltField' {
 
 declare module 'alinea/core/media/MediaLocation' {
 
-  import type { Config } from 'alinea/core/Config';
+  import { Config } from 'alinea/core/Config';
   export const MEDIA_LOCATION = "@alinea.location";
-  export interface MediaUrlMeta {
+  export interface MediaPublicUrlMeta {
       /** The media entry path without its extension. */
       path: string;
       /** The paths of parent media directories. */
       parentPaths: Array<string>;
       /** The file extension, including its leading dot. */
       extension: string;
-      /** The location stored in the media entry, excluding mediaDir. */
-      location: string;
+      /** The workspace holding the media entry. */
       workspace: string;
-      root: string;
-  }
-  export interface MediaUrlResolver {
-      (meta: MediaUrlMeta): string;
-  }
-  export interface MediaPublicUrlMeta extends Omit<MediaUrlMeta, 'parentPaths'> {
-      /** @deprecated Pass parentPaths directly when available. */
-      entryUrl?: string;
-      parentPaths?: Array<string>;
   }
   export interface MediaEntryUrlMeta {
       defaultUrl: string;
       parentPaths: Array<string>;
       path: string;
-      workspace: string;
-      root: string;
       data: Record<string, unknown>;
+      /** The workspace holding the media entry. */
+      workspace: string;
   }
   /** Maps media entry locations between storage and public URLs. */
   export namespace MediaLocation {
@@ -3988,8 +4050,12 @@ declare module 'alinea/core/media/MediaLocation' {
       function storagePath(config: Config, workspace: string, location: string): string;
       /** Remove the workspace storage directory from a prepared upload location. */
       function entryLocation(config: Config, workspace: string, location: string): string;
+      /** Resolve the deployed public location of a stored media file. */
+      function sourceUrl(config: Config, workspace: string, location: string): string | undefined;
       /** Resolve the public URL used to serve a media entry. */
       function publicUrl(config: Config, meta: MediaPublicUrlMeta): string;
+      /** Add an immutable media version without changing its canonical path. */
+      function versionedUrl(url: string, version: string | undefined): string;
       /** Resolve a media entry URL, falling back to its regular entry URL. */
       function entryUrl(config: Config, meta: MediaEntryUrlMeta): string;
   }
@@ -4997,6 +5063,7 @@ declare module 'alinea/core/TextDoc' {
       _id: string;
       _link: 'entry' | 'file' | 'url';
       _entry?: string;
+      _locale?: string;
       _anchor?: string;
       _suffix?: string;
   }
@@ -5004,6 +5071,7 @@ declare module 'alinea/core/TextDoc' {
       const id = "_id";
       const link = "_link";
       const entry = "_entry";
+      const locale = "_locale";
       const anchor = "_anchor";
       const suffix = "_suffix";
   }
@@ -5830,23 +5898,23 @@ declare module 'alinea/core/Workspace' {
 
   import type { Preview } from 'alinea/core/Preview';
   import type { ComponentType } from 'react';
-  import type { MediaUrlResolver } from 'alinea/core/media/MediaLocation';
   import { type HasWorkspace } from 'alinea/core/Internal';
   import { Root } from 'alinea/core/Root';
   import type { Schema } from 'alinea/core/Schema';
   export interface WorkspaceMeta {
       /** A directory which contains the json entry files */
       source: string;
-      /** The directory where media files are placed in case a file backend is used */
+      /**
+       * The directory where media files are placed
+       */
       mediaDir?: string;
-      /** Prepare the public URL used when querying media files */
-      mediaUrl?: string | MediaUrlResolver;
+      /** The public URL prefix used when querying media files */
+      mediaUrl?: string;
       /** The main theme color used in the dashboard */
       color?: string;
       icon?: ComponentType;
       preview?: Preview;
   }
-  export type { MediaUrlMeta, MediaUrlResolver } from 'alinea/core/media/MediaLocation';
   type Roots = Record<string, Root>;
   export interface RootsDefinition {
       [key: string]: Root;
@@ -5874,6 +5942,7 @@ declare module 'alinea/core/Workspace' {
   export function workspace<Roots extends RootsDefinition>(
   /** The name of the workspace */
   label: string, config: WorkspaceConfig<Roots>): Workspace<Roots>;
+  export {};
   
 }
 
@@ -5954,6 +6023,12 @@ declare module 'alinea/dashboard/app/AlineaLogo' {
   
 }
 
+declare module 'alinea/dashboard/app/AppearanceToggle' {
+
+  export function AppearanceToggle(): import("react").JSX.Element;
+  
+}
+
 declare module 'alinea/dashboard/app/AppShell' {
 
   import { HTMLProps } from 'react';
@@ -5972,7 +6047,7 @@ declare module 'alinea/dashboard/app/AuthView' {
           action?: DashboardAuthAction
       ], unknown>;
   }
-  export function AuthView({ auth: authState }: AuthViewProps): import("react").JSX.Element | null;
+  export function AuthView({ auth: authState }: AuthViewProps): import("react").JSX.Element;
   
 }
 
@@ -6044,20 +6119,20 @@ declare module 'alinea/dashboard/app/DashboardMeta' {
   export interface DashboardMetaProps {
       color: string;
       icon?: ComponentType;
+      plain?: boolean;
       title: string;
   }
-  export function DashboardMeta({ color, icon, title }: DashboardMetaProps): import("react").JSX.Element;
+  export function DashboardMeta({ color, icon, plain, title }: DashboardMetaProps): import("react").JSX.Element;
   
 }
 
 declare module 'alinea/dashboard/app/editor/FileEditor' {
 
-  import type { Entry } from 'alinea/core/Entry';
   export interface FileEditorProps {
-      entry: Pick<Entry, 'root' | 'url' | 'workspace'>;
       parentPaths: Array<string>;
+      workspace: string;
   }
-  export function FileEditor({ entry, parentPaths }: FileEditorProps): import("react").JSX.Element;
+  export function FileEditor({ parentPaths, workspace }: FileEditorProps): import("react").JSX.Element;
   
 }
 
@@ -6108,9 +6183,10 @@ declare module 'alinea/dashboard/app/EntryFields' {
   import type { EditorNode } from 'alinea/dashboard/atoms/editor';
   interface NodeEditorProps extends PropsWithChildren {
       node: EditorNode;
+      readOnly?: boolean;
       type: Type;
   }
-  export function NodeEditor({ children, node, type }: NodeEditorProps): import("react").JSX.Element;
+  export function NodeEditor({ children, node, readOnly, type }: NodeEditorProps): import("react").JSX.Element;
   export function FieldsEditor(): import("react").JSX.Element[];
   export function EntryFields(): import("react").JSX.Element[];
   export interface EditFieldsProps {
@@ -6121,6 +6197,7 @@ declare module 'alinea/dashboard/app/EntryFields' {
       field: Field;
   }
   export const EditField: import("react").MemoExoticComponent<({ field }: EditFieldProps) => import("react").JSX.Element | null>;
+  export function fieldWidth(width?: number): string;
   export {};
   
 }
@@ -6148,8 +6225,6 @@ declare module 'alinea/dashboard/app/EntryHeader' {
 declare module 'alinea/dashboard/app/EntryHeaderActions' {
 
   import type { EntryStatus } from 'alinea/core/Entry';
-  export type EntryHeaderActionId = 'remove-draft' | 'replace' | 'unpublish' | 'archive' | 'publish' | 'delete';
-  export type EntryHeaderPrimaryActionId = 'create-draft' | 'save-translation' | 'discard-changes' | 'publish-edits' | 'save-draft' | 'publish-draft';
   interface EntryHeaderAccess {
       archive: boolean;
       delete: boolean;
@@ -6181,8 +6256,27 @@ declare module 'alinea/dashboard/app/EntryHeaderActions' {
       parentNeedsTranslation: boolean;
       untranslated: boolean;
   }
-  export function entryHeaderPrimaryActionIds({ access, activeStatus, canPublishParents, canSaveDraft, isDirty, isRevision, parentNeedsTranslation, untranslated }: EntryHeaderPrimaryActionState): Array<EntryHeaderPrimaryActionId>;
-  export function entryHeaderActionIds({ access, activeStatus, canDelete, canPublishParents, draftsEnabled, isDirty, isMediaFile, isMediaLibrary, isParentUnpublished, isRevision, isUnpublished, untranslated }: EntryHeaderActionState): Array<EntryHeaderActionId>;
+  export interface EntryDirtyActions {
+      publish: boolean;
+      saveDraft: boolean;
+  }
+  export interface EntryHeaderPrimaryActions {
+      createDraft: boolean;
+      dirty: EntryDirtyActions | undefined;
+      publishDraft: boolean;
+      saveTranslation: boolean;
+  }
+  export interface EntryHeaderActions {
+      archive: boolean;
+      delete: boolean;
+      publish: boolean;
+      removeDraft: boolean;
+      replace: boolean;
+      unpublish: boolean;
+  }
+  export function entryDirtyActions(canPublish: boolean, canSaveDraft: boolean): EntryDirtyActions;
+  export function entryHeaderPrimaryActions({ access, activeStatus, canPublishParents, canSaveDraft, isDirty, isRevision, parentNeedsTranslation, untranslated }: EntryHeaderPrimaryActionState): EntryHeaderPrimaryActions;
+  export function entryHeaderActions({ access, activeStatus, canDelete, canPublishParents, draftsEnabled, isDirty, isMediaFile, isMediaLibrary, isParentUnpublished, isRevision, isUnpublished, untranslated }: EntryHeaderActionState): EntryHeaderActions;
   export {};
   
 }
@@ -6274,12 +6368,14 @@ declare module 'alinea/dashboard/app/EntrySidebarToggle' {
 declare module 'alinea/dashboard/app/EntryTranslationBanner' {
 
   export interface EntryTranslationBannerProps {
+      copyFromSource: boolean;
       parentNeedsTranslation: boolean;
       sourceLocale: string | null;
       sourceLocales: ReadonlyArray<string>;
+      onCopyFromSourceChange: (copyFromSource: boolean) => void;
       onSourceLocaleChange: (locale: string) => void;
   }
-  export const EntryTranslationBanner: import("react").MemoExoticComponent<({ parentNeedsTranslation, sourceLocale, sourceLocales, onSourceLocaleChange }: EntryTranslationBannerProps) => import("react").JSX.Element>;
+  export const EntryTranslationBanner: import("react").MemoExoticComponent<({ copyFromSource, parentNeedsTranslation, sourceLocale, sourceLocales, onCopyFromSourceChange, onSourceLocaleChange }: EntryTranslationBannerProps) => import("react").JSX.Element>;
   
 }
 
@@ -6293,6 +6389,7 @@ declare module 'alinea/dashboard/app/Explorer' {
       explorer: DashboardExplorer;
       headerEntry?: ExplorerHeaderEntry;
       page: ExplorerReadyPage;
+      readOnly?: boolean;
       titleControls?: ReactNode;
   }
   export interface ExplorerHeaderEntry {
@@ -6308,6 +6405,7 @@ declare module 'alinea/dashboard/app/Explorer' {
       headerEntry?: ExplorerHeaderEntry;
       navigate?: boolean;
       page: ExplorerReadyPage;
+      readOnly?: boolean;
       titleControls?: ReactNode;
   }
   export interface ExplorerBodyProps {
@@ -6323,9 +6421,9 @@ declare module 'alinea/dashboard/app/Explorer' {
       page: ExplorerReadyPage;
   }
   export function ExplorerSearch({ autoFocus, explorer, onEntryAction, page }: ExplorerSearchProps): import("react").JSX.Element;
-  export function ExplorerHeader({ canBrowse, autoFocusSearch, controls, explorer, headerEntry, navigate, page, titleControls }: ExplorerHeaderProps): import("react").JSX.Element;
+  export function ExplorerHeader({ canBrowse, autoFocusSearch, controls, explorer, headerEntry, navigate, page, readOnly, titleControls }: ExplorerHeaderProps): import("react").JSX.Element;
   export function ExplorerBody({ compactTable, explorer, onSelectionChange, page }: ExplorerBodyProps): import("react").JSX.Element;
-  export function Explorer({ controls, explorer, headerEntry, page: loadedPage, titleControls }: ExplorerProps): import("react").JSX.Element;
+  export function Explorer({ controls, explorer, headerEntry, page: loadedPage, readOnly, titleControls }: ExplorerProps): import("react").JSX.Element;
   export {};
   
 }
@@ -6484,7 +6582,14 @@ declare module 'alinea/dashboard/app/LocaleMenu' {
       locale: string | null;
       onLocaleChange(locale: string): void;
   }
+  export interface LocaleMenuSelectProps {
+      ariaLabel?: string;
+      locale: string | null;
+      locales: ReadonlyArray<string>;
+      onLocaleChange(locale: string): void;
+  }
   export function LocaleMenu({ root, locale, onLocaleChange }: LocaleMenuProps): import("react").JSX.Element | null;
+  export function LocaleMenuSelect({ ariaLabel, locale, locales, onLocaleChange }: LocaleMenuSelectProps): import("react").JSX.Element | null;
   export {};
   
 }
@@ -6538,6 +6643,14 @@ declare module 'alinea/dashboard/app/pages/RootPage' {
   
 }
 
+declare module 'alinea/dashboard/app/pages/SplashPage' {
+
+  import { type Getter } from 'jotai';
+  import type { ReactNode } from 'react';
+  export function splashPage(get: Getter): Promise<ReactNode>;
+  
+}
+
 declare module 'alinea/dashboard/app/pages/UsersPage' {
 
   import { Page } from 'alinea/dashboard/atoms/nav';
@@ -6550,6 +6663,15 @@ declare module 'alinea/dashboard/app/pages/UsersPage' {
   
 }
 
+declare module 'alinea/dashboard/app/ReadOnlyBadge' {
+
+  import type { ComponentPropsWithoutRef } from 'react';
+  export interface ReadOnlyBadgeProps extends ComponentPropsWithoutRef<'span'> {
+  }
+  export function ReadOnlyBadge(props: ReadOnlyBadgeProps): import("react").JSX.Element;
+  
+}
+
 declare module 'alinea/dashboard/app/SidebarLayout' {
 
   import { type ReactNode } from 'react';
@@ -6567,7 +6689,7 @@ declare module 'alinea/dashboard/app/SidebarTree' {
 
   import { type Page } from 'alinea/dashboard/atoms/nav';
   import type { RootAtoms, RootTreeItem, RootTreeNode, TreeAtoms } from 'alinea/dashboard/atoms/root';
-  import { type Atom, type WritableAtom } from 'jotai';
+  import { type WritableAtom } from 'jotai';
   import { type ReactNode } from 'react';
   import { type Selection } from 'react-aria-components';
   export interface SidebarTreeProps {
@@ -6586,16 +6708,13 @@ declare module 'alinea/dashboard/app/SidebarTree' {
   }
   interface SidebarTreeItemProps {
       children?: ReactNode;
+      data: RootTreeItem;
       entryLink?: (entry: RootTreeItem) => SidebarTreeLink;
       item: RootTreeNode;
       locale: string | null;
       selectedItem?: RootTreeItem;
-      tree: SidebarTreeItemSource;
-  }
-  interface SidebarTreeItemSource {
-      item(id: string): Atom<RootTreeItem>;
   }
-  export const SidebarTreeItem: import("react").MemoExoticComponent<({ children, entryLink, item, locale, selectedItem, tree }: SidebarTreeItemProps) => import("react").JSX.Element>;
+  export const SidebarTreeItem: import("react").MemoExoticComponent<({ children, data, entryLink, item, locale, selectedItem }: SidebarTreeItemProps) => import("react").JSX.Element>;
   interface SidebarTreeLink {
       href: string;
   }
@@ -6715,7 +6834,7 @@ declare module 'alinea/dashboard/app/WorkspaceMenu' {
   import type { WorkspaceInternal } from 'alinea/core/Workspace';
   import type { Page } from 'alinea/dashboard/atoms/nav';
   import type { RootAtoms } from 'alinea/dashboard/atoms/root';
-  import { type ComponentType } from 'react';
+  import { type ComponentType, type ReactNode } from 'react';
   interface WorkspaceMenuProps {
       canManageMembers: boolean;
       page: Page;
@@ -6727,14 +6846,21 @@ declare module 'alinea/dashboard/app/WorkspaceMenu' {
   interface WorkspaceAvatarProps {
       color: string;
       icon?: ComponentType;
-      size?: 'default' | 'small';
+      size?: 'default' | 'large' | 'small';
   }
   function WorkspaceAvatar({ color, icon, size }: WorkspaceAvatarProps): import("react").JSX.Element;
   export { WorkspaceAvatar };
   interface WorkspaceAvatarMenuProps {
       page: Page;
+      root: RootAtoms;
   }
-  export function WorkspaceAvatarMenu({ page }: WorkspaceAvatarMenuProps): import("react").JSX.Element;
+  export function WorkspaceAvatarMenu({ page, root }: WorkspaceAvatarMenuProps): import("react").JSX.Element;
+  interface GlobalSearchProps {
+      children: ReactNode;
+      initialSearchScope?: 'everything' | 'workspace';
+      root: RootAtoms;
+  }
+  export function GlobalSearch({ children, initialSearchScope, root }: GlobalSearchProps): import("react").JSX.Element;
   export function WorkspaceMenu({ canManageMembers, page, root, workspace }: WorkspaceMenuProps): import("react").JSX.Element;
   
 }
@@ -6748,6 +6874,8 @@ declare module 'alinea/dashboard/app/WorkspaceMenu.spec' {
 declare module 'alinea/dashboard/app/WorkspaceMenu.stories' {
 
   export function GlobalSearchStory(): import("react").JSX.Element;
+  export function SingleWorkspaceAvatarStory(): import("react").JSX.Element;
+  export function LocalizedGlobalSearchStory(): import("react").JSX.Element;
   const _default: {
       title: string;
   };
@@ -6758,11 +6886,13 @@ declare module 'alinea/dashboard/app/WorkspaceMenu.stories' {
 declare module 'alinea/dashboard/app/WorkspaceRoots' {
 
   import type { Page } from 'alinea/dashboard/atoms/nav';
+  import { type RootAtoms } from 'alinea/dashboard/atoms/root';
   export interface WorkspaceRootsProps {
       canManageMembers: boolean;
       page: Page;
+      root: RootAtoms;
   }
-  export function WorkspaceRoots({ canManageMembers, page }: WorkspaceRootsProps): import("react").JSX.Element;
+  export function WorkspaceRoots({ canManageMembers, page, root: currentRoot }: WorkspaceRootsProps): import("react").JSX.Element;
   
 }
 
@@ -6775,7 +6905,6 @@ declare module 'alinea/dashboard/atoms/activity' {
       isFetchingUpdates: boolean;
       isMutating: boolean;
       hasFailed: boolean;
-      hasFailedMutations: boolean;
       hasBlocked: boolean;
       canRetry: boolean;
       canDiscard: boolean;
@@ -6821,6 +6950,7 @@ declare module 'alinea/dashboard/atoms/activity' {
 
 declare module 'alinea/dashboard/atoms/auth' {
 
+  import type { BackendCapabilities } from 'alinea/core/Connection';
   import { User } from 'alinea/core/User';
   export const authRequiredAtom: import("jotai").Atom<boolean>;
   export interface DashboardAuthLoading {
@@ -6843,6 +6973,7 @@ declare module 'alinea/dashboard/atoms/auth' {
   export interface DashboardAuthAuthenticated {
       status: 'authenticated';
       user: User;
+      capabilities?: BackendCapabilities;
   }
   export type DashboardAuthState = DashboardAuthLoading | DashboardAuthMissingHandler | DashboardAuthMissingApiKey | DashboardAuthRedirecting | DashboardAuthError | DashboardAuthAuthenticated;
   interface DashboardAuthCheck {
@@ -7014,9 +7145,10 @@ declare module 'alinea/dashboard/atoms/editor' {
       policy?: Policy | undefined;
       resolvedImages: ReadonlyMap<string, ResolvedEditorImage>;
       anchors: Atom<Array<EntryAnchorTarget>>;
+      readonly readOnly: boolean;
       value: Atom<object>;
       sections: Array<EntryEditorSection>;
-      constructor(type: Type, node: EditorNode, parent?: EntryEditor | undefined, resource?: Resource | undefined, policy?: Policy | undefined, resolvedImages?: ReadonlyMap<string, ResolvedEditorImage>);
+      constructor(type: Type, node: EditorNode, parent?: EntryEditor | undefined, resource?: Resource | undefined, policy?: Policy | undefined, resolvedImages?: ReadonlyMap<string, ResolvedEditorImage>, readOnly?: boolean);
       field: (key: string) => EntryEditorField | undefined;
       get(field: Field): EntryEditorField | undefined;
   }
@@ -7111,6 +7243,7 @@ declare module 'alinea/dashboard/atoms/entry' {
           init: ReactiveNode<object> | undefined;
       };
       untranslated: Atom<boolean>;
+      copyTranslationSource: import("jotai").WritableAtom<boolean, [next: boolean], void>;
       translationSourceLocale: import("jotai").WritableAtom<string, [next: string], void>;
       parentNeedsTranslation: Atom<Promise<boolean>>;
       selectedVersion: import("jotai").PrimitiveAtom<SelectedVersion | null> & {
@@ -7118,6 +7251,7 @@ declare module 'alinea/dashboard/atoms/entry' {
       };
       versions: Atom<Map<EntryStatus, Entry<Record<string, unknown>>>>;
       availableStatuses: Atom<EntryStatus[]>;
+      preferredEntry: Atom<Entry<Record<string, unknown>>>;
       selectedEntry: Atom<Promise<Entry<Record<string, unknown>>>>;
       historyReady: Atom<Promise<import("alinea/core/Connection").Revision[]>>;
       history: Atom<import("alinea/core/Connection").Revision[]>;
@@ -7362,7 +7496,6 @@ declare module 'alinea/dashboard/atoms/explorer' {
       condition?: Filter<EntryFields>;
       defaultOrderBy?: Atom<OrderBy | Array<OrderBy> | undefined>;
       enableNavigation?: boolean;
-      hideResultsUntilSearch?: boolean;
       initialView?: ExplorerView;
       initialResultMode?: ExplorerResultMode;
       initialSearchScope?: 'workspace' | 'everything';
@@ -7384,7 +7517,7 @@ declare module 'alinea/dashboard/atoms/explorer' {
       initialSelection?: Array<string>;
       searchDepth?: 'current' | 'all';
       onAction?: (entry: ExplorerEntry) => void;
-      onConfirm?: (selection: Array<string>) => void;
+      onConfirm?: (selection: Array<string>, locale: string | null) => void;
       preselect?: boolean;
   }
   export interface ExplorerTreeItem {
@@ -7396,12 +7529,14 @@ declare module 'alinea/dashboard/atoms/explorer' {
   }
   export type ExplorerResultMode = 'browse' | 'matches';
   export interface ExplorerReadyPage {
+      canUpload: boolean;
       isMedia: boolean;
       items: Array<ExplorerEntry>;
       locale: string | null;
       location: ExplorerLocation;
       root: ExplorerRootData;
       resultMode: ExplorerResultMode;
+      search: string;
       searchScope: 'workspace' | 'everything';
       searchesEverything: boolean;
       view: ExplorerView;
@@ -7511,7 +7646,6 @@ declare module 'alinea/dashboard/atoms/explorer' {
       readonly hasRowAction: boolean;
       readonly mode: 'browse' | 'search';
       readonly hasSelection: boolean;
-      readonly hideResultsUntilSearch: boolean;
       readonly linkedKeys: ReadonlySet<Key>;
       readonly searchDepth: "all" | "current";
       readonly supportsInlineExpansion: boolean;
@@ -7543,7 +7677,6 @@ declare module 'alinea/dashboard/atoms/explorer' {
       constructor(location: WritableAtom<ExplorerLocation, [
           SetStateAction<ExplorerLocation>
       ], void>, options: ExplorerOptions, initialLocation: ExplorerLocation);
-      showResults: Atom<boolean>;
       isMedia: Atom<boolean>;
       view: WritableAtom<ExplorerView, [view: ExplorerView], void>;
       sort: WritableAtom<ExplorerSort, [sortBy: ExplorerSortBy], void>;
@@ -7551,7 +7684,7 @@ declare module 'alinea/dashboard/atoms/explorer' {
       get limitLocations(): ExplorerLimitLocation[] | undefined;
       canUpload: Atom<boolean>;
       uploadsInCurrentFolder: Atom<import("alinea/dashboard/boot/ActivityEvent").Activity[]>;
-      upload: WritableAtom<null, [files: ArrayLike<File> | Iterable<File>], void> & {
+      upload: WritableAtom<null, [files: ArrayLike<File> | Iterable<File>], Promise<void>> & {
           init: null;
       };
       getItems: WritableAtom<null, [keys: Set<Key>], DragItem[]> & {
@@ -7569,7 +7702,7 @@ declare module 'alinea/dashboard/atoms/explorer' {
       openLocation: WritableAtom<null, [entry: ExplorerEntry], void> & {
           init: null;
       };
-      onConfirm: WritableAtom<null, [], void> & {
+      onConfirm: WritableAtom<null, [locale?: string | null | undefined], void> & {
           init: null;
       };
       isExpanded: (entry: ExplorerEntry) => Atom<boolean>;
@@ -7592,6 +7725,7 @@ declare module 'alinea/dashboard/atoms/graph' {
   export const syncAtom: import("jotai").WritableAtom<null, [], Promise<string | undefined>> & {
       init: null;
   };
+  export const graphReadyAtom: import("jotai").Atom<Promise<void>>;
   
 }
 
@@ -7620,7 +7754,7 @@ declare module 'alinea/dashboard/atoms/link' {
       state: 'hasError';
       error: Error;
   };
-  export const linkEntryAtoms: (id: string) => import("jotai").Atom<LinkEntryState>;
+  export const linkEntryAtoms: (id: string, locale?: string | undefined) => import("jotai").Atom<LinkEntryState>;
   
 }
 
@@ -7639,7 +7773,7 @@ declare module 'alinea/dashboard/atoms/nav' {
       init: RouteBlock | null;
   };
   export interface DashboardRoute {
-      page?: 'entry' | 'users';
+      page?: 'splash' | 'entry' | 'users';
       workspace?: string;
       root?: string;
       entry?: string;
@@ -7647,9 +7781,10 @@ declare module 'alinea/dashboard/atoms/nav' {
       view?: EntryDefaultView;
   }
   interface ResolvedDashboardRoute extends DashboardRoute {
-      page: 'entry' | 'users';
+      page: 'splash' | 'entry' | 'users';
   }
   export const nav: {
+      splash(): string;
       users(): string;
       entry(workspace?: string, root?: string, entryId?: string, locale?: string | null, view?: EntryDefaultView): string;
   };
@@ -7662,7 +7797,7 @@ declare module 'alinea/dashboard/atoms/nav' {
       onMount(navigate: (request: NavigationRequest) => void): (() => void) | undefined;
   };
   export interface Page {
-      type: 'users' | 'entry';
+      type: 'splash' | 'users' | 'entry';
       workspace: string | undefined;
       root: string | undefined;
       requestedRoot?: string;
@@ -7743,7 +7878,7 @@ declare module 'alinea/dashboard/atoms/root' {
   import { type Atom, type PrimitiveAtom } from 'jotai';
   import type { ComponentType } from 'react';
   import type { DroppableCollectionInsertDropEvent, DroppableCollectionOnItemDropEvent, DroppableCollectionReorderEvent, Key } from 'react-aria-components';
-  import { LucideFile } from 'alinea/dashboard/icons';
+  import { IcOutlineDescription } from 'alinea/dashboard/icons';
   import { type TreeEntryAtoms } from 'alinea/dashboard/atoms/entry';
   export interface RootViewProps {
       root: RootData;
@@ -7769,6 +7904,10 @@ declare module 'alinea/dashboard/atoms/root' {
       items: Array<RootTreeNode>;
       selectedKeys: Set<string>;
   }
+  export interface TreeView {
+      entries: Map<string, RootTreeItem>;
+      snapshot: TreeSnapshot;
+  }
   interface TreeCollapseState {
       selectedId: string | undefined;
       keys: Set<string>;
@@ -7782,6 +7921,7 @@ declare module 'alinea/dashboard/atoms/root' {
       expandedKeys: PrimitiveAtom<Set<string>>;
       collapsedKeys: PrimitiveAtom<TreeCollapseState>;
       constructor(root: RootAtoms, locale: string | null, selectedKeys: Atom<Set<Key>>, viewState?: TreeViewState);
+      view: Atom<TreeView>;
       snapshot: Atom<TreeSnapshot>;
       items: Atom<RootTreeItem[]>;
       children: (id: string) => Atom<Promise<TreeEntryAtoms[]>>;
@@ -7805,7 +7945,7 @@ declare module 'alinea/dashboard/atoms/root' {
       treeEntries: (locale: string | null) => Atom<Promise<TreeEntryAtoms[]>>;
       children: (parentId: string | null) => ExplorerAtoms;
       label: Atom<string>;
-      icon: Atom<typeof LucideFile | ComponentType>;
+      icon: Atom<typeof IcOutlineDescription | ComponentType>;
       i18n: Atom<RootI18n | undefined>;
       isMedia: Atom<boolean>;
       canCreate: Atom<boolean>;
@@ -7837,6 +7977,7 @@ declare module 'alinea/dashboard/atoms/upload' {
       workspace: string;
       root: string;
       parentId?: string;
+      parents?: Array<string>;
   }
   export const uploadFilesAtom: import("jotai").WritableAtom<null, [request: UploadFilesRequest], Promise<void>> & {
       init: null;
@@ -7853,7 +7994,7 @@ declare module 'alinea/dashboard/atoms/user' {
   export const preloadUserPolicyAtom: import("jotai").WritableAtom<null, [user: User, policy: Policy], void> & {
       init: null;
   };
-  export const authReady: import("jotai").Atom<Promise<void>>;
+  export const userPolicyReadyAtom: import("jotai").Atom<Promise<void>>;
   export const canManageMembersAtom: import("jotai").Atom<Promise<boolean>>;
   
 }
@@ -8179,6 +8320,18 @@ declare module 'alinea/dashboard/fixture/cms' {
               pages: import("alinea").Root<import("alinea/core/Root").ChildrenDefinition>;
               media: import("alinea/core/media/MediaRoot").MediaRoot<import("alinea/core/Root").ChildrenDefinition>;
           }>;
+          manyRoots: import("alinea").Workspace<{
+              pages: import("alinea").Root<import("alinea/core/Root").ChildrenDefinition>;
+              articles: import("alinea").Root<import("alinea/core/Root").ChildrenDefinition>;
+              documentation: import("alinea").Root<import("alinea/core/Root").ChildrenDefinition>;
+              campaigns: import("alinea").Root<import("alinea/core/Root").ChildrenDefinition>;
+              translations: import("alinea").Root<import("alinea/core/Root").ChildrenDefinition>;
+              archive: import("alinea").Root<import("alinea/core/Root").ChildrenDefinition>;
+              settings: import("alinea").Root<import("alinea/core/Root").ChildrenDefinition>;
+              brandAssets: import("alinea").Root<import("alinea/core/Root").ChildrenDefinition>;
+              nestedContent: import("alinea").Root<import("alinea/core/Root").ChildrenDefinition>;
+              media: import("alinea/core/media/MediaRoot").MediaRoot<import("alinea/core/Root").ChildrenDefinition>;
+          }>;
       };
   }>;
   
@@ -8247,6 +8400,12 @@ declare module 'alinea/dashboard/hook/UseRoot' {
   
 }
 
+declare module 'alinea/dashboard/hook/UseSaveShortcut' {
+
+  export function useSaveShortcut(action: (() => void) | undefined, disabled: boolean): void;
+  
+}
+
 declare module 'alinea/dashboard/hook/UseWorkspace' {
 
   import type { WorkspaceInternal } from 'alinea/core/Workspace';
@@ -8362,7 +8521,7 @@ declare module 'alinea/dashboard/hooks' {
   /**
    * Creates an editor for a nested reactive node.
    */
-  export function useNodeEditor(node: EditorNode, type: Type): EntryEditor;
+  export function useNodeEditor(node: EditorNode, type: Type, readOnly?: boolean): EntryEditor;
   /**
    * Returns the reactive node backing a field in the active editor.
    */
@@ -9488,10 +9647,10 @@ declare module 'alinea/field/metadata/MetadataField' {
       updatedAt: number | null;
       updatedBy: MetadataAuditUser;
   }
-  export class MetadataField extends RecordField<Metadata, {
-      label: string;
+  export interface MetadataOptions extends FieldOptions<Metadata> {
       fields: Type<MetadataFields>;
-  }> {
+  }
+  export class MetadataField extends RecordField<Metadata, MetadataOptions> {
   }
   export interface MetadataField extends MetadataFields {
   }
@@ -9700,6 +9859,7 @@ declare module 'alinea/field/richtext/extensions/Link' {
   interface LinkAttributes {
       'data-id'?: string;
       'data-entry'?: string;
+      'data-locale'?: string;
       'data-anchor'?: string;
       'data-link'?: string;
       'data-suffix'?: string;
@@ -9813,9 +9973,11 @@ declare module 'alinea/field/richtext/ReferenceLink' {
   interface Anchor extends HTMLProps<HTMLAnchorElement> {
       _id?: string;
       _entry?: string;
+      _locale?: string;
       _link?: 'entry' | 'file' | 'image' | 'url';
       'data-id'?: string;
       'data-entry'?: string;
+      'data-locale'?: string;
       'data-anchor'?: string;
       'data-link'?: 'entry' | 'file' | 'image' | 'url';
       'data-suffix'?: string;
@@ -10519,8 +10681,6 @@ declare module 'alinea/field/time/TimeField' {
       minValue?: string;
       /** A maximum value */
       maxValue?: string;
-      /** Specifies the legal time intervals */
-      step?: number;
   }
   /** Internal representation of a date field */
   export class TimeField extends ScalarField<string, TimeOptions> {
@@ -10669,11 +10829,13 @@ declare module 'alinea/picker/entry/EntryReference' {
   export interface EntryReference extends Reference {
       _type: 'entry' | 'image' | 'file';
       _entry: string;
+      _locale?: string;
       _anchor?: string;
       _suffix?: string;
   }
   export namespace EntryReference {
       const entry = "_entry";
+      const locale = "_locale";
       const anchor = "_anchor";
       const suffix = "_suffix";
       function isEntryReference(value: any): value is EntryReference;
@@ -10782,7 +10944,11 @@ declare module 'alinea/preview/PreviewPayload' {
 declare module 'alinea/preview/react' {
 
   import { type PreviewApi } from 'alinea/preview/RegisterPreview';
-  export function usePreview(api: Omit<PreviewApi, 'setIsPreviewing'>): {
+  export interface UsePreviewOptions {
+      hostOrigin: string;
+      preview: PreviewApi['preview'];
+  }
+  export function usePreview(options: UsePreviewOptions): {
       isPreviewing: boolean;
   };
   
@@ -10795,7 +10961,7 @@ declare module 'alinea/preview/RegisterPreview' {
       preview(update: PreviewPayload): Promise<void>;
       setIsPreviewing(isPreviewing: boolean): void;
   }
-  export function registerPreview(api: PreviewApi): (() => void) | undefined;
+  export function registerPreview(api: PreviewApi, hostOrigin: string): (() => void) | undefined;
   
 }
 
@@ -11081,7 +11247,6 @@ declare module 'alinea/types' {
   export type { Schema } from 'alinea/core/Schema';
   export type { TextDoc } from 'alinea/core/TextDoc';
   export type { Type } from 'alinea/core/Type';
-  export type { MediaUrlMeta, MediaUrlResolver } from 'alinea/core/media/MediaLocation';
   export type { Workspace } from 'alinea/core/Workspace';
   export type { EntryLink } from 'alinea/field/link/EntryLink';
   export type { FileLink } from 'alinea/field/link/FileLink';