alinea 2.0.0-preview.0 → 2.0.0-preview.1

package/dist/bundled.d.ts

@@ -688,6 +688,7 @@ declare module 'alinea/backend/router/Router' {
       function cookie(...cookies: Array<Cookie>): string;
       function compress(...routes: Array<Next<Request, Response | undefined>>): Route<Request, Response | undefined>;
   }
+  export function compressResponse(request: Request, response: Response): Response;
   export {};
   
 }
@@ -1109,13 +1110,6 @@ declare module 'alinea/cli/util/EnsureNode' {
   
 }
 
-declare module 'alinea/cli/util/ExternalPlugin' {
-
-  import type { Plugin } from 'esbuild';
-  export function externalPlugin(cwd: string): Plugin;
-  
-}
-
 declare module 'alinea/cli/util/FindConfigFile' {
 
   export function findConfigFile(cwd: string): string | undefined;
@@ -1255,12 +1249,13 @@ declare module 'alinea/cloud/CloudRemote' {
   import { type Draft, type DraftKey } from 'alinea/core/Draft';
   import type { EntryRecord } from 'alinea/core/EntryRecord';
   import { ReadonlyTree } from 'alinea/core/source/Tree';
+  import type { GetBlobsOptions } from 'alinea/core/source/Source';
   import type { User, UserInput } from 'alinea/core/User';
   export class CloudRemote extends OAuth2 implements RemoteConnection {
       #private;
       constructor(context: RequestContext, config: Config);
       getTreeIfDifferent(sha: string): Promise<ReadonlyTree | undefined>;
-      getBlobs(shas: Array<string>): AsyncGenerator<[sha: string, blob: Uint8Array]>;
+      getBlobs(shas: ReadonlyArray<string>, options?: GetBlobsOptions): AsyncGenerator<[sha: string, blob: Uint8Array]>;
       write(request: CommitRequest): Promise<{
           sha: string;
       }>;
@@ -2024,6 +2019,16 @@ declare module 'alinea/core/Auth' {
   
 }
 
+declare module 'alinea/core/BlobTransport' {
+
+  import { ReadableStream } from '@alinea/iso';
+  import type { GetBlobsOptions } from 'alinea/core/source/Source';
+  export const BLOB_SEQUENCE_CONTENT_TYPE = "application/cbor-seq";
+  export function encodeBlobSequence(blobs: AsyncIterable<[sha: string, blob: Uint8Array]>): ReadableStream<Uint8Array>;
+  export function decodeBlobSequence(stream: ReadableStream<Uint8Array>, options?: GetBlobsOptions): AsyncGenerator<[sha: string, blob: Uint8Array]>;
+  
+}
+
 declare module 'alinea/core/Client' {
 
   import { type AuthResult } from 'alinea/cloud/AuthResult';
@@ -2035,6 +2040,7 @@ declare module 'alinea/core/Client' {
   import type { EntryRecord } from 'alinea/core/EntryRecord';
   import type { AnyQueryResult, GraphQuery } from 'alinea/core/Graph';
   import { ReadonlyTree } from 'alinea/core/source/Tree';
+  import type { GetBlobsOptions } from 'alinea/core/source/Source';
   import type { User, UserInput } from 'alinea/core/User';
   export type AuthenticateRequest = (request?: RequestInit) => RequestInit | undefined;
   export interface ClientOptions {
@@ -2065,7 +2071,7 @@ declare module 'alinea/core/Client' {
       revisions(file: string): Promise<Array<Revision>>;
       revisionData(file: string, revisionId: string): Promise<EntryRecord | undefined>;
       getTreeIfDifferent(sha: string): Promise<ReadonlyTree | undefined>;
-      getBlobs(shas: Array<string>): AsyncGenerator<[sha: string, blob: Uint8Array]>;
+      getBlobs(shas: ReadonlyArray<string>, options?: GetBlobsOptions): AsyncGenerator<[sha: string, blob: Uint8Array]>;
       write(request: CommitRequest): Promise<{
           sha: string;
       }>;
@@ -2159,6 +2165,7 @@ declare module 'alinea/core/Connection' {
   import type { Draft, DraftKey } from 'alinea/core/Draft';
   import type { EntryRecord } from 'alinea/core/EntryRecord';
   import type { AnyQueryResult, GraphQuery } from 'alinea/core/Graph';
+  import type { GetBlobsOptions } from 'alinea/core/source/Source';
   import type { ReadonlyTree } from 'alinea/core/source/Tree';
   import type { User, UserInput } from 'alinea/core/User';
   export interface AuthApi {
@@ -2197,7 +2204,7 @@ declare module 'alinea/core/Connection' {
   }
   export interface SyncApi {
       getTreeIfDifferent(sha: string): Promise<ReadonlyTree | undefined>;
-      getBlobs(shas: Array<string>): AsyncGenerator<[sha: string, blob: Uint8Array]>;
+      getBlobs(shas: ReadonlyArray<string>, options?: GetBlobsOptions): AsyncIterable<[sha: string, blob: Uint8Array]>;
   }
   export interface CommitApi {
       write(request: CommitRequest): Promise<{
@@ -2349,7 +2356,7 @@ declare module 'alinea/core/db/EntryIndex' {
       id: string;
       type: string;
       index: string;
-      searchableText: string;
+      searchableText?: string;
       title: string;
       data: Record<string, unknown>;
       seeded: string | null;
@@ -2438,7 +2445,7 @@ declare module 'alinea/core/db/EntryIndex' {
       get references(): Promise<EntryReferenceIndex>;
       sync(source: Source): Promise<string>;
       syncWith(source: Source): Promise<string>;
-      indexChanges(batch: ChangesBatch): Promise<string>;
+      indexChanges(batch: ChangesBatch, targetTree?: ReadonlyTree): Promise<string>;
       seed(source: Source): Promise<void>;
       byId(id: string): EntryNode | undefined;
       fix(source: Source): Promise<void>;
@@ -2702,7 +2709,8 @@ declare module 'alinea/core/db/LocalDB' {
   import type { AnyQueryResult, GraphQuery } from 'alinea/core/Graph';
   import type { Policy } from 'alinea/core/Role';
   import type { ChangesBatch } from 'alinea/core/source/Change';
-  import type { Source } from 'alinea/core/source/Source';
+  import type { GetBlobsOptions } from 'alinea/core/source/Source';
+  import { type Source } from 'alinea/core/source/Source';
   import { type CommitRequest } from 'alinea/core/db/CommitRequest';
   import { EntryIndex } from 'alinea/core/db/EntryIndex';
   import type { EntryReferenceQuery, EntryReferenceResult } from 'alinea/core/db/EntryReference';
@@ -2720,7 +2728,7 @@ declare module 'alinea/core/db/LocalDB' {
       indexChanges(batch: ChangesBatch): Promise<string>;
       applyChanges(batch: ChangesBatch): Promise<void>;
       getTreeIfDifferent(sha: string): Promise<import("alinea/core/source/Tree").ReadonlyTree | undefined>;
-      getBlobs(shas: Array<string>): AsyncGenerator<[sha: string, blob: Uint8Array<ArrayBufferLike>], any, any>;
+      getBlobs(shas: ReadonlyArray<string>, options?: GetBlobsOptions): AsyncIterable<[sha: string, blob: Uint8Array<ArrayBufferLike>]>;
       sync(): Promise<string>;
       syncWith(remote: SyncApi): Promise<string>;
       logEntries(): Promise<void>;
@@ -3882,10 +3890,13 @@ declare module 'alinea/core/media/MediaLocation' {
       (meta: MediaUrlMeta): string;
   }
   export interface MediaPublicUrlMeta extends Omit<MediaUrlMeta, 'parentPaths'> {
-      entryUrl: string;
+      /** @deprecated Pass parentPaths directly when available. */
+      entryUrl?: string;
+      parentPaths?: Array<string>;
   }
   export interface MediaEntryUrlMeta {
-      entryUrl: string;
+      defaultUrl: string;
+      parentPaths: Array<string>;
       path: string;
       workspace: string;
       root: string;
@@ -4525,14 +4536,14 @@ declare module 'alinea/core/source/Change' {
 declare module 'alinea/core/source/CombinedSource' {
 
   import type { ChangesBatch } from 'alinea/core/source/Change';
-  import type { Source } from 'alinea/core/source/Source';
+  import type { GetBlobsOptions, Source } from 'alinea/core/source/Source';
   import { ReadonlyTree } from 'alinea/core/source/Tree';
   export class CombinedSource implements Source {
       #private;
       constructor(sources: Record<string, Source>);
       getTree(): Promise<ReadonlyTree>;
       getTreeIfDifferent(sha: string): Promise<ReadonlyTree | undefined>;
-      getBlobs(shas: Array<string>): AsyncGenerator<[sha: string, blob: Uint8Array]>;
+      getBlobs(shas: ReadonlyArray<string>, options?: GetBlobsOptions): AsyncGenerator<[sha: string, blob: Uint8Array]>;
       applyChanges(batch: ChangesBatch): Promise<void>;
   }
   
@@ -4558,7 +4569,7 @@ declare module 'alinea/core/source/FilePatch' {
 declare module 'alinea/core/source/FSSource' {
 
   import type { ChangesBatch } from 'alinea/core/source/Change';
-  import type { Source } from 'alinea/core/source/Source';
+  import type { GetBlobsOptions, Source } from 'alinea/core/source/Source';
   import { ReadonlyTree, WriteableTree } from 'alinea/core/source/Tree';
   export class FSSource implements Source {
       #private;
@@ -4566,7 +4577,8 @@ declare module 'alinea/core/source/FSSource' {
       getTree(): Promise<ReadonlyTree>;
       getFile(current: ReadonlyTree, builder: WriteableTree, file: string): Promise<readonly [string, Uint8Array<ArrayBufferLike>] | undefined>;
       getTreeIfDifferent(sha: string): Promise<ReadonlyTree | undefined>;
-      getBlobs(shas: Array<string>): AsyncGenerator<[sha: string, blob: Uint8Array]>;
+      getBlobs(shas: ReadonlyArray<string>, options?: GetBlobsOptions): AsyncGenerator<[sha: string, blob: Uint8Array]>;
+      readBlob(sha: string, file: string, signal?: AbortSignal): Promise<[sha: string, blob: Uint8Array]>;
       applyChanges(batch: ChangesBatch): Promise<void>;
   }
   export class CachedFSSource extends FSSource {
@@ -4576,7 +4588,7 @@ declare module 'alinea/core/source/FSSource' {
       getTree(): Promise<ReadonlyTree>;
       applyChanges(batch: ChangesBatch): Promise<void>;
       getFile(current: ReadonlyTree, builder: WriteableTree, file: string): Promise<readonly [string, Uint8Array<ArrayBufferLike>] | undefined>;
-      getBlobs(shas: Array<string>): AsyncGenerator<[sha: string, blob: Uint8Array]>;
+      getBlobs(shas: ReadonlyArray<string>, options?: GetBlobsOptions): AsyncGenerator<[sha: string, blob: Uint8Array]>;
   }
   
 }
@@ -4599,7 +4611,7 @@ declare module 'alinea/core/source/GitDelta' {
 declare module 'alinea/core/source/GithubSource' {
 
   import type { ChangesBatch } from 'alinea/core/source/Change';
-  import type { Source } from 'alinea/core/source/Source';
+  import type { GetBlobsOptions, Source } from 'alinea/core/source/Source';
   import { ReadonlyTree } from 'alinea/core/source/Tree';
   export interface GithubSourceOptions {
       authToken: string;
@@ -4617,7 +4629,7 @@ declare module 'alinea/core/source/GithubSource' {
       getTree(): Promise<ReadonlyTree>;
       shaAt(ref: string): Promise<string>;
       getTreeIfDifferent(sha: string): Promise<ReadonlyTree | undefined>;
-      getBlobs(shas: Array<string>): AsyncGenerator<[sha: string, blob: Uint8Array]>;
+      getBlobs(shas: ReadonlyArray<string>, options?: GetBlobsOptions): AsyncGenerator<[sha: string, blob: Uint8Array]>;
       applyChanges(batch: ChangesBatch): Promise<void>;
   }
   
@@ -4652,14 +4664,14 @@ declare module 'alinea/core/source/GitUtils' {
 declare module 'alinea/core/source/IndexedDBSource' {
 
   import type { ChangesBatch } from 'alinea/core/source/Change';
-  import type { Source } from 'alinea/core/source/Source';
+  import type { GetBlobsOptions, Source } from 'alinea/core/source/Source';
   import { ReadonlyTree } from 'alinea/core/source/Tree';
   export class IndexedDBSource implements Source {
       #private;
       constructor(indexedDB: IDBFactory, name: string);
       getTree(): Promise<ReadonlyTree>;
       getTreeIfDifferent(sha: string): Promise<ReadonlyTree | undefined>;
-      getBlobs(shas: Array<string>): AsyncGenerator<[sha: string, blob: Uint8Array]>;
+      getBlobs(shas: ReadonlyArray<string>, options?: GetBlobsOptions): AsyncGenerator<[sha: string, blob: Uint8Array]>;
       applyChanges(batch: ChangesBatch): Promise<void>;
   }
   
@@ -4668,14 +4680,14 @@ declare module 'alinea/core/source/IndexedDBSource' {
 declare module 'alinea/core/source/MemorySource' {
 
   import type { ChangesBatch } from 'alinea/core/source/Change';
-  import type { Source } from 'alinea/core/source/Source';
+  import type { GetBlobsOptions, Source } from 'alinea/core/source/Source';
   import { ReadonlyTree } from 'alinea/core/source/Tree';
   export class MemorySource implements Source {
       #private;
       constructor(tree?: ReadonlyTree, blobs?: Map<string, Uint8Array>);
       getTree(): Promise<ReadonlyTree>;
       getTreeIfDifferent(sha: string): Promise<ReadonlyTree | undefined>;
-      getBlobs(shas: Array<string>): AsyncGenerator<[sha: string, blob: Uint8Array]>;
+      getBlobs(shas: ReadonlyArray<string>, options?: GetBlobsOptions): AsyncGenerator<[sha: string, blob: Uint8Array]>;
       addBlob(contents: Uint8Array): Promise<string>;
       applyChanges(batch: ChangesBatch): Promise<void>;
   }
@@ -4697,9 +4709,12 @@ declare module 'alinea/core/source/Source' {
 
   import type { ChangesBatch } from 'alinea/core/source/Change';
   import type { ReadonlyTree } from 'alinea/core/source/Tree';
+  export interface GetBlobsOptions {
+      signal?: AbortSignal;
+  }
   export interface RemoteSource {
       getTreeIfDifferent(sha: string): Promise<ReadonlyTree | undefined>;
-      getBlobs(shas: Array<string>): AsyncGenerator<[sha: string, blob: Uint8Array]>;
+      getBlobs(shas: ReadonlyArray<string>, options?: GetBlobsOptions): AsyncIterable<[sha: string, blob: Uint8Array]>;
   }
   export interface Source extends RemoteSource {
       getTree(): Promise<ReadonlyTree>;
@@ -4949,6 +4964,7 @@ declare module 'alinea/core/Trigger' {
 declare module 'alinea/core/Type' {
 
   import type { ComponentType } from 'react';
+  import type { Config } from 'alinea/core/Config';
   import type { EntryStatus } from 'alinea/core/Entry';
   import type { Expr } from 'alinea/core/Expr';
   import { Field, type EntryAnchorTarget, type FieldAnchorContext, type FieldBeforeSaveContext } from 'alinea/core/Field';
@@ -4961,7 +4977,9 @@ declare module 'alinea/core/Type' {
   import type { EntryReferenceTarget } from 'alinea/core/db/EntryReference';
   import type { SummaryProps } from 'alinea/core/media/Summary';
   import type { Expand } from 'alinea/core/util/Types';
-  export interface EntryUrlMeta {
+  export interface EntryUrlInput {
+      config: Config;
+      data: Record<string, unknown>;
       status: EntryStatus;
       path: string;
       parentPaths: Array<string>;
@@ -4969,6 +4987,9 @@ declare module 'alinea/core/Type' {
       workspace: string;
       root: string;
   }
+  export interface EntryUrlMeta extends EntryUrlInput {
+      defaultUrl: string;
+  }
   export type EntryDefaultView = 'edit' | 'overview';
   export type Type<Definition = object> = Definition & HasType;
   type TypeRow<Definition> = Expand<{
@@ -5101,9 +5122,15 @@ declare module 'alinea/core/util/Assert' {
 
 declare module 'alinea/core/util/Async' {
 
-  /** Accumulate all entries of an AsyncGenerator into an array */
-  export function accumulate<T>(gen: AsyncGenerator<T>): Promise<Array<T>>;
+  /** Accumulate all entries of an AsyncIterable into an array */
+  export function accumulate<T>(gen: AsyncIterable<T>): Promise<Array<T>>;
   export function toGenerator<T>(iterable: Iterable<T>): AsyncGenerator<T>;
+  export interface MapConcurrentOptions {
+      concurrency: number;
+      signal?: AbortSignal;
+  }
+  /** Map concurrently while yielding results as they complete. */
+  export function mapConcurrent<T, TResult>(iterable: Iterable<T>, mapper: (item: T, signal?: AbortSignal) => Promise<TResult>, options: MapConcurrentOptions): AsyncGenerator<TResult>;
   export function genEffect<T, TReturn>(gen: AsyncIterable<T, TReturn>, effect: (result: T) => void): AsyncIterable<T>;
   
 }
@@ -5266,7 +5293,7 @@ declare module 'alinea/core/util/EntryFilenames' {
 
   import type { Config } from 'alinea/core/Config';
   import { type Entry, type EntryStatus } from 'alinea/core/Entry';
-  import type { EntryUrlMeta, Type } from 'alinea/core/Type';
+  import type { EntryUrlInput, Type } from 'alinea/core/Type';
   export function entryInfo(fileName: string): [name: string, status: EntryStatus];
   export function entryChildrenDir(config: Config, entry: {
       workspace: string;
@@ -5290,7 +5317,7 @@ declare module 'alinea/core/util/EntryFilenames' {
       status: EntryStatus;
   }, parentPaths: Array<string>): string;
   export function entryFile(config: Config, entry: Entry): string;
-  export function entryUrl(type: Type, meta: EntryUrlMeta): string;
+  export function entryUrl(type: Type, meta: EntryUrlInput): string;
   export function pathSuffix(path: string, conflictingPaths: Array<string>): number | undefined;
   export function applySuffix(path: string, suffix: number): string;
   export function fileVersions(file: string): string[];
@@ -5890,8 +5917,9 @@ 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>;
   }
-  export function FileEditor({ entry }: FileEditorProps): import("react").JSX.Element;
+  export function FileEditor({ entry, parentPaths }: FileEditorProps): import("react").JSX.Element;
   
 }
 
@@ -6853,8 +6881,9 @@ declare module 'alinea/dashboard/atoms/entry' {
 
   import type { EntryReference, EntryReferenceScan } from 'alinea/core/db/EntryReference';
   import { Entry, EntryStatus } from 'alinea/core/Entry';
+  import type { Order } from 'alinea/core/Graph';
   import { type EntryDefaultView } from 'alinea/core/Type';
-  import { Atom } from 'jotai';
+  import { Atom, Getter } from 'jotai';
   import { ReactiveNode } from 'alinea/dashboard/atoms/ReactiveNode';
   interface EntryData {
       id: string;
@@ -7059,6 +7088,7 @@ declare module 'alinea/dashboard/atoms/entry' {
       parentId: Atom<string | null>;
       workspace: Atom<string>;
       root: Atom<string>;
+      parentPaths: Atom<string[]>;
       hasChildren: Atom<boolean>;
       canPublishParents: Atom<boolean>;
       parentUnpublished: Atom<boolean>;
@@ -7073,6 +7103,48 @@ declare module 'alinea/dashboard/atoms/entry' {
       id: string;
       constructor(id: string);
   }
+  export interface TreeEntrySummary {
+      id: string;
+      title: string;
+      type: string;
+      status: EntryStatus;
+      main: boolean;
+      locale: string | null;
+      parentId: string | null;
+      parents: Array<string>;
+      workspace: string;
+      root: string;
+      hasChildren: boolean;
+  }
+  interface TreeChildrenLocation {
+      workspace: string;
+      root: string;
+      parentId: string | null;
+  }
+  export function loadTreeChildren(get: Getter, location: TreeChildrenLocation, locale: string | null, orderBy?: Order | Array<Order>): Promise<Array<TreeEntryAtoms>>;
+  export class TreeEntryAtoms {
+      #private;
+      readonly id: string;
+      constructor(id: string);
+      ready: Atom<Promise<this>>;
+      raw: (locale: string | null) => Atom<Promise<Omit<TreeEntrySummary, "hasChildren">>>;
+      summary: (locale: string | null) => Atom<Promise<{
+          id: string;
+          title: string;
+          type: string;
+          status: EntryStatus;
+          main: boolean;
+          locale: string | null;
+          parentId: string | null;
+          parents: Array<string>;
+          workspace: string;
+          root: string;
+          hasChildren: boolean;
+      }>>;
+      parents: Atom<Promise<TreeEntryAtoms[]>>;
+      children: (locale: string | null) => Atom<Promise<TreeEntryAtoms[]>>;
+  }
+  export const treeEntryAtoms: (id: string) => TreeEntryAtoms;
   export {};
   
 }
@@ -7487,7 +7559,7 @@ declare module 'alinea/dashboard/atoms/ReactiveNode' {
 
 declare module 'alinea/dashboard/atoms/root' {
 
-  import { type EntryStatus } from 'alinea/core/Entry';
+  import type { EntryStatus } from 'alinea/core/Entry';
   import type { RootData, RootI18n } from 'alinea/core/Root';
   import type { DragItem, DragTypes, DropOperation, DropTarget } from '@react-types/shared';
   import { type ExplorerAtoms } from 'alinea/dashboard/atoms/explorer';
@@ -7495,6 +7567,7 @@ declare module 'alinea/dashboard/atoms/root' {
   import type { ComponentType } from 'react';
   import type { DroppableCollectionInsertDropEvent, DroppableCollectionOnItemDropEvent, DroppableCollectionReorderEvent, Key } from 'react-aria-components';
   import { LucideFile } from 'alinea/dashboard/icons';
+  import { type TreeEntryAtoms } from 'alinea/dashboard/atoms/entry';
   export interface RootViewProps {
       root: RootData;
   }
@@ -7534,6 +7607,7 @@ declare module 'alinea/dashboard/atoms/root' {
       constructor(root: RootAtoms, locale: string | null, selectedKeys: Atom<Set<Key>>, viewState?: TreeViewState);
       snapshot: Atom<TreeSnapshot>;
       items: Atom<RootTreeItem[]>;
+      children: (id: string) => Atom<Promise<TreeEntryAtoms[]>>;
       item: (id: string) => Atom<RootTreeItem>;
       selectedItem: Atom<RootTreeItem | undefined>;
       ready: Atom<Promise<{
@@ -7551,6 +7625,7 @@ declare module 'alinea/dashboard/atoms/root' {
       explorer: ExplorerAtoms;
       constructor(workspace: string, key: string);
       createTree(locale: string | null, selectedKeys: Atom<Set<Key>>, expandedKeys?: PrimitiveAtom<Set<string>>): TreeAtoms;
+      treeEntries: (locale: string | null) => Atom<Promise<TreeEntryAtoms[]>>;
       children: (parentId: string | null) => ExplorerAtoms;
       label: Atom<string>;
       icon: Atom<typeof LucideFile | ComponentType>;
@@ -8766,8 +8841,8 @@ declare module 'alinea/field/link/FileLink' {
   }
   export namespace FileLink {
       const title: import("alinea/core/Expr").Expr<string>;
-      const url: import("alinea/field/hidden").HiddenField<string>;
-      const href: import("alinea/field/hidden").HiddenField<string>;
+      const url: import("alinea/core/Expr").Expr<string>;
+      const href: import("alinea/core/Expr").Expr<string>;
       const extension: import("alinea/field/hidden").HiddenField<string>;
       const size: import("alinea/field/hidden").HiddenField<number>;
   }
@@ -8814,7 +8889,7 @@ declare module 'alinea/field/link/ImageLink' {
   export namespace ImageLink {
       const title: import("alinea/core/Expr").Expr<string>;
       const alt: import("alinea/core/media/MediaAltField").MediaAltField;
-      const src: import("alinea/field/hidden").HiddenField<string>;
+      const src: import("alinea/core/Expr").Expr<string>;
       const extension: import("alinea/field/hidden").HiddenField<string>;
       const size: import("alinea/field/hidden").HiddenField<number>;
       const hash: import("alinea/field/hidden").HiddenField<string>;