camox 0.43.0 → 0.45.0

package/dist/core/createApp.d.ts

@@ -1,40 +1,50 @@
-import { EmbedURL, FileValue, ImageValue, LinkValue } from "./lib/contentType.js";
+import { IconProps } from "./lib/icons.js";
+import { CamoxDocument } from "./defineDocument.js";
+import { ArtifactRenderProps } from "./lib/artifact.js";
 import { InlineTextStyles } from "./lib/textStyles.js";
+import { ReferenceContent, ReferenceScope } from "./lib/reference.js";
+import { Layout, RecordPages } from "./createLayout.js";
+import { Collection } from "./createCollection.js";
+import { IconValue } from "./lib/iconTypes.js";
+import { ArtifactSource, EmbedURL, FileValue, ImageValue, LinkValue } from "./lib/contentType.js";
+import { LayoutItemProps } from "./editing/BlockEditingRuntime.js";
 import { BlockComponentProps, PeekItem, RepeatableItemSeed } from "./editing/createEditableBlock.js";
 import { Block } from "./createBlock.js";
-import { Layout, LayoutBlockData, OgImageParams } from "./createLayout.js";
-import * as _$_sinclair_typebox0 from "@sinclair/typebox";
-import * as _$react from "react";
-import * as _$react_jsx_runtime0 from "react/jsx-runtime";
-
 //#region src/core/createApp.d.ts
 interface CreateAppOptions {
   blocks: Block[];
+  /**
+   * Blocks loaded on demand, keyed by their file name, which is their id by convention. A
+   * block id without a matching key is found by loading every block.
+   */
+  lazyBlocks?: Record<string, () => Promise<Block | undefined>>;
   layouts?: Layout[];
+  collections?: Collection[];
+  /** The project's document definition (`src/document.ts`). */
+  document?: CamoxDocument;
 }
-declare function createApp({
-  blocks,
-  layouts
-}: CreateAppOptions): {
+export declare function createApp({ blocks, lazyBlocks, layouts, collections, document }: CreateAppOptions): {
+  /** The document's font links as HTML, for artifacts to load before their source. */
+  getArtifactFontLinks(): string;
+  getCollections(): Collection[];
+  getCollectionById(id: string): Collection | undefined;
+  /** The loaded blocks: every block after `loadAllBlocks`. */
   getBlocks(): {
-    Detached: ({
-      children
-    }: {
+    Detached: ({ children }: {
       children: (props: {
-        "data-camox-comment-block-id"?: number;
-        ref: (element: HTMLElement | null) => void;
-        style: React.CSSProperties;
+        "data-camox-block-id"?: string;
+        "data-camox-hovered"?: boolean;
+        "data-camox-focused"?: boolean;
+        "data-camox-overlay-mode"?: "synced";
         onClickCapture: (e: React.MouseEvent) => void;
         onMouseEnter: () => void;
         onMouseLeave: () => void;
       }) => React.ReactNode;
     }) => React.JSX.Element;
-    Field: <K extends never>({
-      name,
-      textStyle,
-      linkStyle,
-      children
-    }: InlineTextStyles & {
+    Icon: ({ name, ...props }: IconProps & {
+      name: never;
+    }) => import("react").JSX.Element;
+    Field: <K extends never>({ name, textStyle, linkStyle, children }: InlineTextStyles & {
       name: K;
       children: (props: {
         children: React.ReactNode;
@@ -51,10 +61,7 @@ declare function createApp({
         text: string;
       }) => React.ReactNode;
     }) => React.ReactNode;
-    Embed: <K extends never>({
-      name,
-      children
-    }: {
+    Embed: <K extends never>({ name, children }: {
       name: K;
       children: (props: {
         src: string;
@@ -62,10 +69,11 @@ declare function createApp({
         url: string;
       }) => React.ReactNode;
     }) => React.ReactNode;
-    Link: <K extends never>({
-      name,
-      children
-    }: {
+    Artifact: <K extends never>({ name, children }: {
+      name: K;
+      children: (props: ArtifactRenderProps) => React.ReactNode;
+    }) => React.ReactNode;
+    Link: <K extends never>({ name, children }: {
       name: K;
       children: (props: {
         to: string;
@@ -95,10 +103,7 @@ declare function createApp({
         newTab: boolean;
       }) => React.ReactNode;
     }) => React.ReactNode;
-    Image: <K extends never>({
-      name,
-      children
-    }: {
+    Image: <K extends never>({ name, children }: {
       name: K;
       children: (props: {
         src: string;
@@ -107,14 +112,13 @@ declare function createApp({
         sizes?: string;
       }, data: ImageValue) => React.ReactNode;
     }) => React.ReactNode;
-    File: <K extends never>({
-      name,
-      children
-    }: {
+    File: <K extends never>({ name, children }: {
       name: K;
       children: (props: {
         href: string;
         download: string;
+      } & Partial<Pick<import("react").AnchorHTMLAttributes<HTMLAnchorElement>, "onClick" | "onClickCapture" | "onMouseEnter" | "onMouseLeave">> & {
+        [attribute: `data-camox-${string}`]: string | boolean | undefined;
       }, data: FileValue) => React.ReactNode;
     }) => React.ReactNode;
     ImageList: <K extends never>(props: {
@@ -131,15 +135,14 @@ declare function createApp({
       children: (props: {
         href: string;
         download: string;
+      } & Partial<Pick<import("react").AnchorHTMLAttributes<HTMLAnchorElement>, "onClick" | "onClickCapture" | "onMouseEnter" | "onMouseLeave">> & {
+        [attribute: `data-camox-${string}`]: string | boolean | undefined;
       }, data: FileValue) => React.ReactNode;
     }) => React.ReactNode;
-    Repeater: <K extends never>({
-      name,
-      children
-    }: {
+    Repeater: <K extends never>({ name, children }: {
       name: K;
       children: (item: {
-        Field: <F extends keyof { [F_1 in keyof ({}[K] extends (infer U)[] ? U : never) as ({}[K] extends (infer U)[] ? U : never)[F_1] extends string ? F_1 : never]: ({}[K] extends (infer U)[] ? U : never)[F_1] }>(props: InlineTextStyles & {
+        Field: <F extends keyof { [F_1 in keyof ({}[K] extends (infer U)[] ? U : never) as ({}[K] extends (infer U)[] ? U : never)[F_1] extends IconValue | ArtifactSource ? never : ({}[K] extends (infer U)[] ? U : never)[F_1] extends string ? F_1 : never]: ({}[K] extends (infer U)[] ? U : never)[F_1]; }>(props: InlineTextStyles & {
           name: F;
           children: (props: {
             children: React.ReactNode;
@@ -156,7 +159,7 @@ declare function createApp({
             text: string;
           }) => React.ReactNode;
         }) => React.ReactNode;
-        Link: <F extends keyof { [F_1 in keyof ({}[K] extends (infer U)[] ? U : never) as ({}[K] extends (infer U)[] ? U : never)[F_1] extends LinkValue ? F_1 : never]: ({}[K] extends (infer U)[] ? U : never)[F_1] }>(props: {
+        Link: <F extends keyof { [F_1 in keyof ({}[K] extends (infer U)[] ? U : never) as ({}[K] extends (infer U)[] ? U : never)[F_1] extends LinkValue ? F_1 : never]: ({}[K] extends (infer U)[] ? U : never)[F_1]; }>(props: {
           name: F;
           children: (props: {
             to: string;
@@ -186,7 +189,10 @@ declare function createApp({
             newTab: boolean;
           }) => React.ReactNode;
         }) => React.ReactNode;
-        Embed: <F extends keyof { [F_1 in keyof ({}[K] extends (infer U)[] ? U : never) as ({}[K] extends (infer U)[] ? U : never)[F_1] extends EmbedURL ? F_1 : never]: ({}[K] extends (infer U)[] ? U : never)[F_1] }>(props: {
+        Icon: (props: IconProps & {
+          name: keyof { [F in keyof ({}[K] extends (infer U)[] ? U : never) as ({}[K] extends (infer U)[] ? U : never)[F] extends IconValue ? F : never]: ({}[K] extends (infer U)[] ? U : never)[F]; };
+        }) => React.ReactNode;
+        Embed: <F extends keyof { [F_1 in keyof ({}[K] extends (infer U)[] ? U : never) as ({}[K] extends (infer U)[] ? U : never)[F_1] extends EmbedURL ? F_1 : never]: ({}[K] extends (infer U)[] ? U : never)[F_1]; }>(props: {
           name: F;
           children: (props: {
             src: string;
@@ -194,6 +200,10 @@ declare function createApp({
             url: string;
           }) => React.ReactNode;
         }) => React.ReactNode;
+        Artifact: <F extends keyof { [F_1 in keyof ({}[K] extends (infer U)[] ? U : never) as ({}[K] extends (infer U)[] ? U : never)[F_1] extends ArtifactSource ? F_1 : never]: ({}[K] extends (infer U)[] ? U : never)[F_1]; }>(props: {
+          name: F;
+          children: (props: ArtifactRenderProps) => React.ReactNode;
+        }) => React.ReactNode;
         Image: <F extends keyof { [F_1 in keyof ({}[K] extends (infer U)[] ? U : never) as ImageValue extends ({}[K] extends (infer U)[] ? U : never)[F_1] ? ({}[K] extends (infer U)[] ? U : never)[F_1] extends ({}[K] extends (infer U)[] ? U : never)[F_1] & {
           url: string;
           alt: string;
@@ -203,7 +213,7 @@ declare function createApp({
           _fileId?: string;
         } & {
           readonly __brand: "ImageValue";
-        } ? F_1 : never : never]: ({}[K] extends (infer U)[] ? U : never)[F_1] }>(props: {
+        } ? F_1 : never : never]: ({}[K] extends (infer U)[] ? U : never)[F_1]; }>(props: {
           name: F;
           children: (props: {
             src: string;
@@ -221,11 +231,13 @@ declare function createApp({
           _fileId?: string;
         } & {
           readonly __brand: "FileValue";
-        } ? F_1 : never : never]: ({}[K] extends (infer U)[] ? U : never)[F_1] }>(props: {
+        } ? F_1 : never : never]: ({}[K] extends (infer U)[] ? U : never)[F_1]; }>(props: {
           name: F;
           children: (props: {
             href: string;
             download: string;
+          } & Partial<Pick<import("react").AnchorHTMLAttributes<HTMLAnchorElement>, "onClick" | "onClickCapture" | "onMouseEnter" | "onMouseLeave">> & {
+            [attribute: `data-camox-${string}`]: string | boolean | undefined;
           }, data: FileValue) => React.ReactNode;
         }) => React.ReactNode;
         ImageList: <F extends keyof { [F_1 in keyof ({}[K] extends (infer U)[] ? U : never) as ({}[K] extends (infer U)[] ? U : never)[F_1] extends (infer U_1)[] ? ImageValue extends U_1 ? U_1 extends U_1 & {
@@ -237,7 +249,7 @@ declare function createApp({
           _fileId?: string;
         } & {
           readonly __brand: "ImageValue";
-        } ? F_1 : never : never : never]: ({}[K] extends (infer U)[] ? U : never)[F_1] }>(props: {
+        } ? F_1 : never : never : never]: ({}[K] extends (infer U)[] ? U : never)[F_1]; }>(props: {
           name: F;
           children: (props: {
             src: string;
@@ -255,14 +267,24 @@ declare function createApp({
           _fileId?: string;
         } & {
           readonly __brand: "FileValue";
-        } ? F_1 : never : never : never]: ({}[K] extends (infer U)[] ? U : never)[F_1] }>(props: {
+        } ? F_1 : never : never : never]: ({}[K] extends (infer U)[] ? U : never)[F_1]; }>(props: {
           name: F;
           children: (props: {
             href: string;
             download: string;
+          } & Partial<Pick<import("react").AnchorHTMLAttributes<HTMLAnchorElement>, "onClick" | "onClickCapture" | "onMouseEnter" | "onMouseLeave">> & {
+            [attribute: `data-camox-${string}`]: string | boolean | undefined;
           }, data: FileValue) => React.ReactNode;
         }) => React.ReactNode;
-        Repeater: <F extends keyof { [F_1 in keyof ({}[K] extends (infer U)[] ? U : never) as ({}[K] extends (infer U)[] ? U : never)[F_1] extends (infer U_1)[] ? ImageValue extends U_1 ? never : FileValue extends U_1 ? never : F_1 : never]: ({}[K] extends (infer U)[] ? U : never)[F_1] }>(props: {
+        Reference: <F extends string>(props: {
+          name: F;
+          children: (scope: ReferenceScope<ReferenceContent<never[F]>>) => React.ReactNode;
+        }) => React.ReactNode;
+        ReferenceList: <F extends string>(props: {
+          name: F;
+          children: (scope: ReferenceScope<ReferenceContent<never[F]>>) => React.ReactNode;
+        }) => React.ReactNode;
+        Repeater: <F extends keyof { [F_1 in keyof ({}[K] extends (infer U)[] ? U : never) as ({}[K] extends (infer U)[] ? U : never)[F_1] extends (infer U_1)[] ? ImageValue extends U_1 ? never : FileValue extends U_1 ? never : U_1 extends string ? never : F_1 : never]: ({}[K] extends (infer U)[] ? U : never)[F_1]; }>(props: {
           name: F;
           children: (item: {
             Field: (props: InlineTextStyles & {
@@ -312,6 +334,9 @@ declare function createApp({
                 newTab: boolean;
               }) => React.ReactNode;
             }) => React.ReactNode;
+            Icon: (props: IconProps & {
+              name: string;
+            }) => React.ReactNode;
             Embed: (props: {
               name: string;
               children: (props: {
@@ -320,6 +345,10 @@ declare function createApp({
                 url: string;
               }) => React.ReactNode;
             }) => React.ReactNode;
+            Artifact: (props: {
+              name: string;
+              children: (props: ArtifactRenderProps) => React.ReactNode;
+            }) => React.ReactNode;
             Image: (props: {
               name: string;
               children: (props: {
@@ -334,6 +363,8 @@ declare function createApp({
               children: (props: {
                 href: string;
                 download: string;
+              } & Partial<Pick<import("react").AnchorHTMLAttributes<HTMLAnchorElement>, "onClick" | "onClickCapture" | "onMouseEnter" | "onMouseLeave">> & {
+                [attribute: `data-camox-${string}`]: string | boolean | undefined;
               }, data: FileValue) => React.ReactNode;
             }) => React.ReactNode;
             ImageList: (props: {
@@ -350,30 +381,42 @@ declare function createApp({
               children: (props: {
                 href: string;
                 download: string;
+              } & Partial<Pick<import("react").AnchorHTMLAttributes<HTMLAnchorElement>, "onClick" | "onClickCapture" | "onMouseEnter" | "onMouseLeave">> & {
+                [attribute: `data-camox-${string}`]: string | boolean | undefined;
               }, data: FileValue) => React.ReactNode;
             }) => React.ReactNode;
             Repeater: (props: {
               name: string;
               children: (item: any, index: number) => React.ReactNode;
             }) => React.ReactNode;
+            Reference: (props: {
+              name: string;
+              children: (scope: ReferenceScope<any>) => React.ReactNode;
+            }) => React.ReactNode;
+            ReferenceList: (props: {
+              name: string;
+              children: (scope: ReferenceScope<any>) => React.ReactNode;
+            }) => React.ReactNode;
             useSetting: (name: string) => unknown;
           }, index: number) => React.ReactNode;
         }) => React.ReactNode;
         useSetting: <F extends string>(name: F) => never;
       }, index: number) => React.ReactNode;
-    }) => _$react_jsx_runtime0.JSX.Element;
+    }) => import("react").JSX.Element;
+    Reference: <K extends never>({ name, children }: {
+      name: K;
+      children: (scope: ReferenceScope<never>) => React.ReactNode;
+    }) => React.ReactNode;
+    ReferenceList: <K extends never>({ name, children }: {
+      name: K;
+      children: (scope: ReferenceScope<never>) => React.ReactNode;
+    }) => React.ReactNode;
     useSetting: <K extends string>(name: K) => unknown;
     _internal: {
-      Component: ({
-        blockData,
-        mode,
-        isFirstBlock,
-        showAddBlockTop,
-        showAddBlockBottom,
-        addBlockAfterPosition
-      }: BlockComponentProps<{
+      Component: ({ blockData, mode, isFirstBlock, showAddBlockTop, showAddBlockBottom, addBlockAfterPosition }: BlockComponentProps<{
         [x: string]: unknown;
-      }>) => _$react_jsx_runtime0.JSX.Element;
+      }>) => import("react").JSX.Element;
+      LayoutItem: ({ collectionId, labelField, properties, record, children, fallback }: LayoutItemProps) => string | number | bigint | boolean | Iterable<import("react").ReactNode> | Promise<string | number | bigint | boolean | import("react").ReactPortal | import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | Iterable<import("react").ReactNode> | null | undefined> | import("react").JSX.Element | null | undefined;
       id: string;
       title: string;
       description: string;
@@ -381,13 +424,13 @@ declare function createApp({
         type: "object";
         title: string;
         description: string;
-        properties: Record<string, _$_sinclair_typebox0.TSchema>;
+        properties: Record<string, import("@sinclair/typebox").TSchema>;
         required: string[];
         toMarkdown: string[];
       };
       settingsSchema: {
         type: "object";
-        properties: Record<string, _$_sinclair_typebox0.TSchema>;
+        properties: Record<string, import("@sinclair/typebox").TSchema>;
         required: string[];
       } | undefined;
       layoutOnly: boolean;
@@ -407,13 +450,13 @@ declare function createApp({
       };
       getPeekBundle: () => {
         block: {
-          id: number;
+          id: string;
           pageId: null;
           layoutId: null;
           type: string;
           content: Record<string, unknown>;
           settings: Record<string, unknown>;
-          placement: null;
+          slot: null;
           summary: string;
           position: string;
           createdAt: number;
@@ -424,25 +467,23 @@ declare function createApp({
       };
     };
   }[];
+  /** A loaded block. Call `loadBlock` first for a block that may be lazy. */
   getBlockById(id: string): {
-    Detached: ({
-      children
-    }: {
+    Detached: ({ children }: {
       children: (props: {
-        "data-camox-comment-block-id"?: number;
-        ref: (element: HTMLElement | null) => void;
-        style: React.CSSProperties;
+        "data-camox-block-id"?: string;
+        "data-camox-hovered"?: boolean;
+        "data-camox-focused"?: boolean;
+        "data-camox-overlay-mode"?: "synced";
         onClickCapture: (e: React.MouseEvent) => void;
         onMouseEnter: () => void;
         onMouseLeave: () => void;
       }) => React.ReactNode;
     }) => React.JSX.Element;
-    Field: <K extends never>({
-      name,
-      textStyle,
-      linkStyle,
-      children
-    }: InlineTextStyles & {
+    Icon: ({ name, ...props }: IconProps & {
+      name: never;
+    }) => import("react").JSX.Element;
+    Field: <K extends never>({ name, textStyle, linkStyle, children }: InlineTextStyles & {
       name: K;
       children: (props: {
         children: React.ReactNode;
@@ -459,10 +500,7 @@ declare function createApp({
         text: string;
       }) => React.ReactNode;
     }) => React.ReactNode;
-    Embed: <K extends never>({
-      name,
-      children
-    }: {
+    Embed: <K extends never>({ name, children }: {
       name: K;
       children: (props: {
         src: string;
@@ -470,10 +508,11 @@ declare function createApp({
         url: string;
       }) => React.ReactNode;
     }) => React.ReactNode;
-    Link: <K extends never>({
-      name,
-      children
-    }: {
+    Artifact: <K extends never>({ name, children }: {
+      name: K;
+      children: (props: ArtifactRenderProps) => React.ReactNode;
+    }) => React.ReactNode;
+    Link: <K extends never>({ name, children }: {
       name: K;
       children: (props: {
         to: string;
@@ -503,10 +542,7 @@ declare function createApp({
         newTab: boolean;
       }) => React.ReactNode;
     }) => React.ReactNode;
-    Image: <K extends never>({
-      name,
-      children
-    }: {
+    Image: <K extends never>({ name, children }: {
       name: K;
       children: (props: {
         src: string;
@@ -515,14 +551,13 @@ declare function createApp({
         sizes?: string;
       }, data: ImageValue) => React.ReactNode;
     }) => React.ReactNode;
-    File: <K extends never>({
-      name,
-      children
-    }: {
+    File: <K extends never>({ name, children }: {
       name: K;
       children: (props: {
         href: string;
         download: string;
+      } & Partial<Pick<import("react").AnchorHTMLAttributes<HTMLAnchorElement>, "onClick" | "onClickCapture" | "onMouseEnter" | "onMouseLeave">> & {
+        [attribute: `data-camox-${string}`]: string | boolean | undefined;
       }, data: FileValue) => React.ReactNode;
     }) => React.ReactNode;
     ImageList: <K extends never>(props: {
@@ -539,15 +574,14 @@ declare function createApp({
       children: (props: {
         href: string;
         download: string;
+      } & Partial<Pick<import("react").AnchorHTMLAttributes<HTMLAnchorElement>, "onClick" | "onClickCapture" | "onMouseEnter" | "onMouseLeave">> & {
+        [attribute: `data-camox-${string}`]: string | boolean | undefined;
       }, data: FileValue) => React.ReactNode;
     }) => React.ReactNode;
-    Repeater: <K extends never>({
-      name,
-      children
-    }: {
+    Repeater: <K extends never>({ name, children }: {
       name: K;
       children: (item: {
-        Field: <F extends keyof { [F_1 in keyof ({}[K] extends (infer U)[] ? U : never) as ({}[K] extends (infer U)[] ? U : never)[F_1] extends string ? F_1 : never]: ({}[K] extends (infer U)[] ? U : never)[F_1] }>(props: InlineTextStyles & {
+        Field: <F extends keyof { [F_1 in keyof ({}[K] extends (infer U)[] ? U : never) as ({}[K] extends (infer U)[] ? U : never)[F_1] extends IconValue | ArtifactSource ? never : ({}[K] extends (infer U)[] ? U : never)[F_1] extends string ? F_1 : never]: ({}[K] extends (infer U)[] ? U : never)[F_1]; }>(props: InlineTextStyles & {
           name: F;
           children: (props: {
             children: React.ReactNode;
@@ -564,7 +598,7 @@ declare function createApp({
             text: string;
           }) => React.ReactNode;
         }) => React.ReactNode;
-        Link: <F extends keyof { [F_1 in keyof ({}[K] extends (infer U)[] ? U : never) as ({}[K] extends (infer U)[] ? U : never)[F_1] extends LinkValue ? F_1 : never]: ({}[K] extends (infer U)[] ? U : never)[F_1] }>(props: {
+        Link: <F extends keyof { [F_1 in keyof ({}[K] extends (infer U)[] ? U : never) as ({}[K] extends (infer U)[] ? U : never)[F_1] extends LinkValue ? F_1 : never]: ({}[K] extends (infer U)[] ? U : never)[F_1]; }>(props: {
           name: F;
           children: (props: {
             to: string;
@@ -594,7 +628,10 @@ declare function createApp({
             newTab: boolean;
           }) => React.ReactNode;
         }) => React.ReactNode;
-        Embed: <F extends keyof { [F_1 in keyof ({}[K] extends (infer U)[] ? U : never) as ({}[K] extends (infer U)[] ? U : never)[F_1] extends EmbedURL ? F_1 : never]: ({}[K] extends (infer U)[] ? U : never)[F_1] }>(props: {
+        Icon: (props: IconProps & {
+          name: keyof { [F in keyof ({}[K] extends (infer U)[] ? U : never) as ({}[K] extends (infer U)[] ? U : never)[F] extends IconValue ? F : never]: ({}[K] extends (infer U)[] ? U : never)[F]; };
+        }) => React.ReactNode;
+        Embed: <F extends keyof { [F_1 in keyof ({}[K] extends (infer U)[] ? U : never) as ({}[K] extends (infer U)[] ? U : never)[F_1] extends EmbedURL ? F_1 : never]: ({}[K] extends (infer U)[] ? U : never)[F_1]; }>(props: {
           name: F;
           children: (props: {
             src: string;
@@ -602,6 +639,10 @@ declare function createApp({
             url: string;
           }) => React.ReactNode;
         }) => React.ReactNode;
+        Artifact: <F extends keyof { [F_1 in keyof ({}[K] extends (infer U)[] ? U : never) as ({}[K] extends (infer U)[] ? U : never)[F_1] extends ArtifactSource ? F_1 : never]: ({}[K] extends (infer U)[] ? U : never)[F_1]; }>(props: {
+          name: F;
+          children: (props: ArtifactRenderProps) => React.ReactNode;
+        }) => React.ReactNode;
         Image: <F extends keyof { [F_1 in keyof ({}[K] extends (infer U)[] ? U : never) as ImageValue extends ({}[K] extends (infer U)[] ? U : never)[F_1] ? ({}[K] extends (infer U)[] ? U : never)[F_1] extends ({}[K] extends (infer U)[] ? U : never)[F_1] & {
           url: string;
           alt: string;
@@ -611,7 +652,7 @@ declare function createApp({
           _fileId?: string;
         } & {
           readonly __brand: "ImageValue";
-        } ? F_1 : never : never]: ({}[K] extends (infer U)[] ? U : never)[F_1] }>(props: {
+        } ? F_1 : never : never]: ({}[K] extends (infer U)[] ? U : never)[F_1]; }>(props: {
           name: F;
           children: (props: {
             src: string;
@@ -629,11 +670,13 @@ declare function createApp({
           _fileId?: string;
         } & {
           readonly __brand: "FileValue";
-        } ? F_1 : never : never]: ({}[K] extends (infer U)[] ? U : never)[F_1] }>(props: {
+        } ? F_1 : never : never]: ({}[K] extends (infer U)[] ? U : never)[F_1]; }>(props: {
           name: F;
           children: (props: {
             href: string;
             download: string;
+          } & Partial<Pick<import("react").AnchorHTMLAttributes<HTMLAnchorElement>, "onClick" | "onClickCapture" | "onMouseEnter" | "onMouseLeave">> & {
+            [attribute: `data-camox-${string}`]: string | boolean | undefined;
           }, data: FileValue) => React.ReactNode;
         }) => React.ReactNode;
         ImageList: <F extends keyof { [F_1 in keyof ({}[K] extends (infer U)[] ? U : never) as ({}[K] extends (infer U)[] ? U : never)[F_1] extends (infer U_1)[] ? ImageValue extends U_1 ? U_1 extends U_1 & {
@@ -645,7 +688,7 @@ declare function createApp({
           _fileId?: string;
         } & {
           readonly __brand: "ImageValue";
-        } ? F_1 : never : never : never]: ({}[K] extends (infer U)[] ? U : never)[F_1] }>(props: {
+        } ? F_1 : never : never : never]: ({}[K] extends (infer U)[] ? U : never)[F_1]; }>(props: {
           name: F;
           children: (props: {
             src: string;
@@ -663,14 +706,24 @@ declare function createApp({
           _fileId?: string;
         } & {
           readonly __brand: "FileValue";
-        } ? F_1 : never : never : never]: ({}[K] extends (infer U)[] ? U : never)[F_1] }>(props: {
+        } ? F_1 : never : never : never]: ({}[K] extends (infer U)[] ? U : never)[F_1]; }>(props: {
           name: F;
           children: (props: {
             href: string;
             download: string;
+          } & Partial<Pick<import("react").AnchorHTMLAttributes<HTMLAnchorElement>, "onClick" | "onClickCapture" | "onMouseEnter" | "onMouseLeave">> & {
+            [attribute: `data-camox-${string}`]: string | boolean | undefined;
           }, data: FileValue) => React.ReactNode;
         }) => React.ReactNode;
-        Repeater: <F extends keyof { [F_1 in keyof ({}[K] extends (infer U)[] ? U : never) as ({}[K] extends (infer U)[] ? U : never)[F_1] extends (infer U_1)[] ? ImageValue extends U_1 ? never : FileValue extends U_1 ? never : F_1 : never]: ({}[K] extends (infer U)[] ? U : never)[F_1] }>(props: {
+        Reference: <F extends string>(props: {
+          name: F;
+          children: (scope: ReferenceScope<ReferenceContent<never[F]>>) => React.ReactNode;
+        }) => React.ReactNode;
+        ReferenceList: <F extends string>(props: {
+          name: F;
+          children: (scope: ReferenceScope<ReferenceContent<never[F]>>) => React.ReactNode;
+        }) => React.ReactNode;
+        Repeater: <F extends keyof { [F_1 in keyof ({}[K] extends (infer U)[] ? U : never) as ({}[K] extends (infer U)[] ? U : never)[F_1] extends (infer U_1)[] ? ImageValue extends U_1 ? never : FileValue extends U_1 ? never : U_1 extends string ? never : F_1 : never]: ({}[K] extends (infer U)[] ? U : never)[F_1]; }>(props: {
           name: F;
           children: (item: {
             Field: (props: InlineTextStyles & {
@@ -720,6 +773,9 @@ declare function createApp({
                 newTab: boolean;
               }) => React.ReactNode;
             }) => React.ReactNode;
+            Icon: (props: IconProps & {
+              name: string;
+            }) => React.ReactNode;
             Embed: (props: {
               name: string;
               children: (props: {
@@ -728,6 +784,10 @@ declare function createApp({
                 url: string;
               }) => React.ReactNode;
             }) => React.ReactNode;
+            Artifact: (props: {
+              name: string;
+              children: (props: ArtifactRenderProps) => React.ReactNode;
+            }) => React.ReactNode;
             Image: (props: {
               name: string;
               children: (props: {
@@ -742,6 +802,8 @@ declare function createApp({
               children: (props: {
                 href: string;
                 download: string;
+              } & Partial<Pick<import("react").AnchorHTMLAttributes<HTMLAnchorElement>, "onClick" | "onClickCapture" | "onMouseEnter" | "onMouseLeave">> & {
+                [attribute: `data-camox-${string}`]: string | boolean | undefined;
               }, data: FileValue) => React.ReactNode;
             }) => React.ReactNode;
             ImageList: (props: {
@@ -758,30 +820,42 @@ declare function createApp({
               children: (props: {
                 href: string;
                 download: string;
+              } & Partial<Pick<import("react").AnchorHTMLAttributes<HTMLAnchorElement>, "onClick" | "onClickCapture" | "onMouseEnter" | "onMouseLeave">> & {
+                [attribute: `data-camox-${string}`]: string | boolean | undefined;
               }, data: FileValue) => React.ReactNode;
             }) => React.ReactNode;
             Repeater: (props: {
               name: string;
               children: (item: any, index: number) => React.ReactNode;
             }) => React.ReactNode;
+            Reference: (props: {
+              name: string;
+              children: (scope: ReferenceScope<any>) => React.ReactNode;
+            }) => React.ReactNode;
+            ReferenceList: (props: {
+              name: string;
+              children: (scope: ReferenceScope<any>) => React.ReactNode;
+            }) => React.ReactNode;
             useSetting: (name: string) => unknown;
           }, index: number) => React.ReactNode;
         }) => React.ReactNode;
         useSetting: <F extends string>(name: F) => never;
       }, index: number) => React.ReactNode;
-    }) => _$react_jsx_runtime0.JSX.Element;
+    }) => import("react").JSX.Element;
+    Reference: <K extends never>({ name, children }: {
+      name: K;
+      children: (scope: ReferenceScope<never>) => React.ReactNode;
+    }) => React.ReactNode;
+    ReferenceList: <K extends never>({ name, children }: {
+      name: K;
+      children: (scope: ReferenceScope<never>) => React.ReactNode;
+    }) => React.ReactNode;
     useSetting: <K extends string>(name: K) => unknown;
     _internal: {
-      Component: ({
-        blockData,
-        mode,
-        isFirstBlock,
-        showAddBlockTop,
-        showAddBlockBottom,
-        addBlockAfterPosition
-      }: BlockComponentProps<{
+      Component: ({ blockData, mode, isFirstBlock, showAddBlockTop, showAddBlockBottom, addBlockAfterPosition }: BlockComponentProps<{
         [x: string]: unknown;
-      }>) => _$react_jsx_runtime0.JSX.Element;
+      }>) => import("react").JSX.Element;
+      LayoutItem: ({ collectionId, labelField, properties, record, children, fallback }: LayoutItemProps) => string | number | bigint | boolean | Iterable<import("react").ReactNode> | Promise<string | number | bigint | boolean | import("react").ReactPortal | import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | Iterable<import("react").ReactNode> | null | undefined> | import("react").JSX.Element | null | undefined;
       id: string;
       title: string;
       description: string;
@@ -789,13 +863,13 @@ declare function createApp({
         type: "object";
         title: string;
         description: string;
-        properties: Record<string, _$_sinclair_typebox0.TSchema>;
+        properties: Record<string, import("@sinclair/typebox").TSchema>;
         required: string[];
         toMarkdown: string[];
       };
       settingsSchema: {
         type: "object";
-        properties: Record<string, _$_sinclair_typebox0.TSchema>;
+        properties: Record<string, import("@sinclair/typebox").TSchema>;
         required: string[];
       } | undefined;
       layoutOnly: boolean;
@@ -815,13 +889,13 @@ declare function createApp({
       };
       getPeekBundle: () => {
         block: {
-          id: number;
+          id: string;
           pageId: null;
           layoutId: null;
           type: string;
           content: Record<string, unknown>;
           settings: Record<string, unknown>;
-          placement: null;
+          slot: null;
           summary: string;
           position: string;
           createdAt: number;
@@ -832,106 +906,52 @@ declare function createApp({
       };
     };
   } | undefined;
-  getLayouts(): {
-    BeforeBlocks: {
-      (): _$react_jsx_runtime0.JSX.Element;
-      displayName: string;
-    };
-    AfterBlocks: {
-      (): _$react_jsx_runtime0.JSX.Element;
-      displayName: string;
-    };
-    useData(): unknown;
-    _internal: {
-      id: string;
-      kind: "curated" | "derived" | "singleton";
-      loader: ((context: {
-        params: Record<string, string>;
-      }) => unknown) | undefined;
+  loadBlock: (id: string) => Promise<Block | undefined>;
+  /** Whether a block not loaded yet could still load, rather than not exist. */
+  canLoadMoreBlocks(): boolean;
+  loadBlocks(ids: Iterable<string>): Promise<void>;
+  /** Every block definition, which editing needs, rather than only a page's. */
+  loadAllBlocks: () => Promise<void>;
+  getLayouts(): Layout[];
+  getLayoutById(id: string): Layout | undefined;
+  /**
+   * The website's Definition Set: every block (lazy ones included, layout-only ones only when a
+   * layout declares them), layout and collection definition, and the homepage they declare.
+   * Never calls the network; the API computes schema hashes on write.
+   */
+  getDefinitionSet(): Promise<{
+    blocks: {
+      blockId: string;
       title: string;
       description: string;
-      buildMetaTitle: (params: {
-        pageMetaTitle: string;
-        projectName: string;
-        pageFullPath: string;
-      }) => string;
-      buildOgImage: ((params: OgImageParams) => Promise<Response>) | undefined;
-      blockDefinitions: ({
-        type: string;
-        content: Record<string, unknown>;
-        settings: Record<string, unknown>;
-        repeatableItems: {
-          tempId: string;
-          parentTempId: string | null;
-          fieldName: string;
-          content: Record<string, unknown>;
-          position: string;
-        }[];
-        placement: "before";
-      } | {
-        type: string;
-        content: Record<string, unknown>;
-        settings: Record<string, unknown>;
-        repeatableItems: {
-          tempId: string;
-          parentTempId: string | null;
-          fieldName: string;
-          content: Record<string, unknown>;
-          position: string;
-        }[];
-        placement: "after";
-      })[];
-      initialBlockBundles: {
-        type: string;
-        content: Record<string, unknown>;
-        settings: Record<string, unknown>;
-        repeatableItems: {
-          tempId: string;
-          parentTempId: string | null;
-          fieldName: string;
-          content: Record<string, unknown>;
-          position: string;
-        }[];
-      }[] | undefined;
-      component: _$react.ComponentType<{
-        children: React.ReactNode;
-      }>;
-      Provider: ({
-        layoutBlocks,
-        children,
-        data
-      }: {
-        layoutBlocks: Record<string, LayoutBlockData>;
-        children: React.ReactNode;
-        data?: unknown;
-      }) => _$react_jsx_runtime0.JSX.Element;
-    };
-  }[];
-  getLayoutById(id: string): {
-    BeforeBlocks: {
-      (): _$react_jsx_runtime0.JSX.Element;
-      displayName: string;
-    };
-    AfterBlocks: {
-      (): _$react_jsx_runtime0.JSX.Element;
-      displayName: string;
-    };
-    useData(): unknown;
-    _internal: {
-      id: string;
+      contentSchema: {
+        type: "object";
+        title: string;
+        description: string;
+        properties: Record<string, import("@sinclair/typebox").TSchema>;
+        required: string[];
+        toMarkdown: string[];
+      };
+      settingsSchema: {
+        type: "object";
+        properties: Record<string, import("@sinclair/typebox").TSchema>;
+        required: string[];
+      } | undefined;
+      defaultContent: {
+        [x: string]: unknown;
+      };
+      defaultSettings: {
+        [x: string]: unknown;
+      };
+      layoutOnly: true | undefined;
+      synced: boolean;
+    }[];
+    layouts: {
+      recordPages?: RecordPages | undefined;
+      layoutId: string;
       kind: "curated" | "derived" | "singleton";
-      loader: ((context: {
-        params: Record<string, string>;
-      }) => unknown) | undefined;
-      title: string;
       description: string;
-      buildMetaTitle: (params: {
-        pageMetaTitle: string;
-        projectName: string;
-        pageFullPath: string;
-      }) => string;
-      buildOgImage: ((params: OgImageParams) => Promise<Response>) | undefined;
-      blockDefinitions: ({
+      blocks: ({
         type: string;
         content: Record<string, unknown>;
         settings: Record<string, unknown>;
@@ -942,7 +962,7 @@ declare function createApp({
           content: Record<string, unknown>;
           position: string;
         }[];
-        placement: "before";
+        slot: "before";
       } | {
         type: string;
         content: Record<string, unknown>;
@@ -954,9 +974,19 @@ declare function createApp({
           content: Record<string, unknown>;
           position: string;
         }[];
-        placement: "after";
+        slot: "after";
       })[];
-      initialBlockBundles: {
+    }[];
+    collections: {
+      collectionId: string;
+      title: string;
+      description: string;
+      label: string;
+      contentSchema: any;
+    }[];
+    homepage: {
+      layoutId: string;
+      blocks: {
         type: string;
         content: Record<string, unknown>;
         settings: Record<string, unknown>;
@@ -967,88 +997,13 @@ declare function createApp({
           content: Record<string, unknown>;
           position: string;
         }[];
-      }[] | undefined;
-      component: _$react.ComponentType<{
-        children: React.ReactNode;
-      }>;
-      Provider: ({
-        layoutBlocks,
-        children,
-        data
-      }: {
-        layoutBlocks: Record<string, LayoutBlockData>;
-        children: React.ReactNode;
-        data?: unknown;
-      }) => _$react_jsx_runtime0.JSX.Element;
-    };
-  } | undefined;
-  getSerializableDefinitions(): {
-    blockId: string;
-    title: string;
-    description: string;
-    contentSchema: {
-      type: "object";
-      title: string;
-      description: string;
-      properties: Record<string, _$_sinclair_typebox0.TSchema>;
-      required: string[];
-      toMarkdown: string[];
-    };
-    settingsSchema: {
-      type: "object";
-      properties: Record<string, _$_sinclair_typebox0.TSchema>;
-      required: string[];
-    } | undefined;
-    layoutOnly: true | undefined;
-    synced: boolean;
-  }[];
-  getSerializableLayoutDefinitions(): {
-    layoutId: string;
-    kind: "curated" | "derived" | "singleton";
-    description: string;
-    blocks: ({
-      type: string;
-      content: Record<string, unknown>;
-      settings: Record<string, unknown>;
-      repeatableItems: {
-        tempId: string;
-        parentTempId: string | null;
-        fieldName: string;
-        content: Record<string, unknown>;
-        position: string;
-      }[];
-      placement: "before";
-    } | {
-      type: string;
-      content: Record<string, unknown>;
-      settings: Record<string, unknown>;
-      repeatableItems: {
-        tempId: string;
-        parentTempId: string | null;
-        fieldName: string;
-        content: Record<string, unknown>;
-        position: string;
-      }[];
-      placement: "after";
-    })[];
-  }[];
-  getInitialPageBundles(): {
-    layoutId: string;
-    blocks: {
-      type: string;
-      content: Record<string, unknown>;
-      settings: Record<string, unknown>;
-      repeatableItems: {
-        tempId: string;
-        parentTempId: string | null;
-        fieldName: string;
-        content: Record<string, unknown>;
-        position: string;
       }[];
-    }[];
-    hasInitialBlocks: boolean;
-  } | null;
+      hasInitialBlocks: boolean;
+    } | null;
+  }>;
 };
-type CamoxApp = ReturnType<typeof createApp>;
+export type CamoxApp = ReturnType<typeof createApp>;
+/** All of a website's definitions taken together, with the content they declare. */
+export type DefinitionSet = Awaited<ReturnType<CamoxApp["getDefinitionSet"]>>;
 //#endregion
-export { CamoxApp, createApp };
+export {};