alinea 2.0.0-preview.4 → 2.0.0-preview.6

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;
   
@@ -345,6 +354,14 @@ declare module 'alinea/backend/api/OAuth2' {
   
 }
 
+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;
@@ -887,7 +904,7 @@ declare module 'alinea/cli/generate/FillCache' {
 
   import { type Emitter } from 'alinea/cli/util/Emitter';
   import type { DevDB } from 'alinea/cli/generate/DevDB';
-  export function fillCache(db: DevDB, fix?: boolean): Emitter<DevDB>;
+  export function fillCache(db: DevDB, fix?: boolean, watch?: boolean): Emitter<DevDB>;
   
 }
 
@@ -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;
@@ -1279,6 +1302,12 @@ declare module 'alinea/cloud/CloudHandshake' {
       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 {};
   
@@ -1648,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;
@@ -2172,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;
@@ -2183,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;
@@ -2195,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;
@@ -2487,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;
@@ -2504,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>;
@@ -2754,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>>;
   }
   
 }
@@ -3719,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;
@@ -3977,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 {
@@ -4015,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;
   }
@@ -5024,6 +5063,7 @@ declare module 'alinea/core/TextDoc' {
       _id: string;
       _link: 'entry' | 'file' | 'url';
       _entry?: string;
+      _locale?: string;
       _anchor?: string;
       _suffix?: string;
   }
@@ -5031,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";
   }
@@ -5857,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;
@@ -5901,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 {};
   
 }
 
@@ -6086,12 +6128,11 @@ declare module 'alinea/dashboard/app/DashboardMeta' {
 
 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;
   
 }
 
@@ -6142,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 {
@@ -6155,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 {};
   
 }
@@ -6182,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;
@@ -6215,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 {};
   
 }
@@ -6308,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>;
   
 }
 
@@ -6327,6 +6389,7 @@ declare module 'alinea/dashboard/app/Explorer' {
       explorer: DashboardExplorer;
       headerEntry?: ExplorerHeaderEntry;
       page: ExplorerReadyPage;
+      readOnly?: boolean;
       titleControls?: ReactNode;
   }
   export interface ExplorerHeaderEntry {
@@ -6342,6 +6405,7 @@ declare module 'alinea/dashboard/app/Explorer' {
       headerEntry?: ExplorerHeaderEntry;
       navigate?: boolean;
       page: ExplorerReadyPage;
+      readOnly?: boolean;
       titleControls?: ReactNode;
   }
   export interface ExplorerBodyProps {
@@ -6357,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 {};
   
 }
@@ -6518,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 {};
   
 }
@@ -6592,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';
@@ -6609,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 {
@@ -6628,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;
   }
@@ -6825,10 +6902,8 @@ declare module 'alinea/dashboard/atoms/activity' {
   import { type Activity } from 'alinea/dashboard/boot/ActivityEvent';
   export interface DashboardActivity {
       items: Array<Activity>;
-      isFetchingUpdates: boolean;
       isMutating: boolean;
       hasFailed: boolean;
-      hasFailedMutations: boolean;
       hasBlocked: boolean;
       canRetry: boolean;
       canDiscard: boolean;
@@ -7069,9 +7144,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;
   }
@@ -7166,6 +7242,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> & {
@@ -7173,6 +7250,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[]>;
@@ -7438,7 +7516,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 {
@@ -7450,6 +7528,7 @@ declare module 'alinea/dashboard/atoms/explorer' {
   }
   export type ExplorerResultMode = 'browse' | 'matches';
   export interface ExplorerReadyPage {
+      canUpload: boolean;
       isMedia: boolean;
       items: Array<ExplorerEntry>;
       locale: string | null;
@@ -7604,7 +7683,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[]> & {
@@ -7622,7 +7701,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>;
@@ -7674,7 +7753,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>;
   
 }
 
@@ -7798,7 +7877,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;
@@ -7824,6 +7903,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>;
@@ -7837,6 +7920,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[]>>;
@@ -7860,7 +7944,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>;
@@ -7892,6 +7976,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;
@@ -7937,7 +8022,7 @@ declare module 'alinea/dashboard/atoms/utils' {
 
 declare module 'alinea/dashboard/boot/ActivityEvent' {
 
-  export type ActivityType = 'mutation' | 'fetch' | 'upload';
+  export type ActivityType = 'mutation' | 'upload';
   export type ActivityStatus = 'pending' | 'running' | 'succeeded' | 'failed' | 'blocked' | 'discarded' | 'cancelled';
   export interface Activity {
       id: string;
@@ -8314,6 +8399,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';
@@ -8429,7 +8520,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.
    */
@@ -9555,10 +9646,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 {
   }
@@ -9767,6 +9858,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;
@@ -9880,9 +9972,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;
@@ -10586,8 +10680,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> {
@@ -10736,11 +10828,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;
@@ -11152,7 +11246,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';