alinea 2.0.0-preview.13 → 2.0.0-preview.14

package/dist/index.css

@@ -794,6 +794,9 @@
     color: var(--alinea-fg-disabled);
   }
 }
+.alinea-ComboBoxTrigger-spinner {
+  color: var(--alinea-fg-muted);
+}
 .alinea-ComboBoxTrigger-action {
   z-index: 0;
   width: 24px;
@@ -1394,6 +1397,9 @@
     min-height: 0;
   }
 }
+.alinea-DialogContent-form {
+  display: contents;
+}
 .alinea-DialogContent-close {
   position: absolute;
   top: 12px;
@@ -1659,6 +1665,11 @@
   rotate: 90deg;
 }
 
+/* src/components/Form.module.css */
+.alinea-Form {
+  display: block;
+}
+
 /* src/components/Heading.module.css */
 .alinea-Heading {
   color: var(--alinea-fg);
@@ -1795,6 +1806,17 @@
   outline: none;
 }
 
+/* src/components/internal/ListBoxGroup.module.css */
+.alinea-ListBoxGroup {
+  display: block;
+}
+.alinea-ListBoxGroup-label {
+  color: var(--alinea-fg-muted);
+  padding: 4px 6px;
+  font-size: .8rem;
+  font-weight: 500;
+}
+
 /* src/components/internal/ListBoxOption.module.css */
 .alinea-ListBoxOption {
   border-radius: var(--alinea-radius-sm);
@@ -3349,15 +3371,6 @@
 .alinea-SelectContent-list {
   outline: none;
 }
-.alinea-SelectGroup {
-  display: block;
-}
-.alinea-SelectGroup-label {
-  color: var(--alinea-fg-muted);
-  padding: 4px 6px;
-  font-size: .8rem;
-  font-weight: 500;
-}
 .alinea-SelectSeparator {
   background: var(--alinea-border);
   border: none;
@@ -3786,12 +3799,57 @@
     animation: 1s cubic-bezier(.4, 0, .2, 1) infinite alinea-Spinner-spin;
   }
 }
+@media (prefers-reduced-motion: reduce) {
+  .alinea-Spinner-indicator {
+    transition: none;
+  }
+}
 @keyframes alinea-Spinner-spin {
   to {
     transform: rotate(270deg);
   }
 }
 
+/* src/components/Stack.module.css */
+.alinea-Stack {
+  flex-direction: column;
+  min-width: 0;
+  display: flex;
+  &[data-direction=row] {
+    flex-direction: row;
+  }
+  &[data-align=start] {
+    align-items: flex-start;
+  }
+  &[data-align=center] {
+    align-items: center;
+  }
+  &[data-align=end] {
+    align-items: flex-end;
+  }
+  &[data-align=stretch] {
+    align-items: stretch;
+  }
+  &[data-align=baseline] {
+    align-items: baseline;
+  }
+  &[data-justify=start] {
+    justify-content: flex-start;
+  }
+  &[data-justify=center] {
+    justify-content: center;
+  }
+  &[data-justify=end] {
+    justify-content: flex-end;
+  }
+  &[data-justify=between] {
+    justify-content: space-between;
+  }
+  &[data-wrap] {
+    flex-wrap: wrap;
+  }
+}
+
 /* src/components/Surface.module.css */
 .alinea-Surface {
   background: var(--alinea-bg);
@@ -3966,13 +4024,19 @@
   }
 }
 .alinea-Table-empty {
+  height: 100%;
+  min-height: calc(var(--alinea-table-row-height) * 2);
+  color: var(--alinea-fg-muted);
+  justify-content: center;
+  align-items: center;
+  display: flex;
+}
+.alinea-Table-loader {
+  height: var(--alinea-table-row-height);
   color: var(--alinea-fg-muted);
-  pointer-events: none;
   justify-content: center;
   align-items: center;
   display: flex;
-  position: absolute;
-  inset: 0;
 }
 .alinea-Table-dropIndicator {
   pointer-events: none;
@@ -4022,8 +4086,14 @@
     padding-inline-start: calc(34px + var(--alinea-table-indent));
   }
 }
+.alinea-TableHeader-label {
+  text-overflow: ellipsis;
+  min-width: 0;
+  overflow: hidden;
+}
 .alinea-TableHeader-sort {
   border-radius: var(--alinea-radius-sm);
+  min-width: 0;
   color: inherit;
   font: inherit;
   cursor: pointer;
@@ -4043,6 +4113,7 @@
   }
 }
 .alinea-TableHeader-sortIcon {
+  flex: none;
   font-size: 14px;
 }
 .alinea-TableRow {
@@ -4603,6 +4674,9 @@
     grid-area: 1 / 1 / 2 / 2;
     overflow: hidden;
   }
+  .alinea-TextFieldGrow &.alinea-is-limited {
+    overflow-y: auto;
+  }
   &.alinea-is-start {
     padding-left: calc(20px + 1em);
   }
@@ -5037,6 +5111,17 @@
 }
 .alinea-AppLoading-progress {
   animation: .25s ease-out both alinea-AppLoading-progress-fade-in;
+  display: flex;
+  position: relative;
+}
+.alinea-AppLoading-status {
+  white-space: nowrap;
+  font-variant-numeric: tabular-nums;
+  margin-top: .75rem;
+  position: absolute;
+  top: 100%;
+  left: 50%;
+  transform: translateX(-50%);
 }
 @keyframes alinea-AppLoading-progress-fade-in {
   from {
@@ -5514,6 +5599,9 @@
 }
 
 /* src/dashboard/app/EntryHeader.module.css */
+.alinea-EntryHeader {
+  min-height: var(--alinea-header-height, 48px);
+}
 @media (width <= 768px) {
   .alinea-EntryHeader {
     gap: 4px;
@@ -6070,6 +6158,18 @@
   display: flex;
 }
 
+/* src/dashboard/app/ExplorerOverviewHeader.module.css */
+.alinea-ExplorerOverviewHeader {
+  border-bottom: 1px solid var(--alinea-border);
+  flex-shrink: 0;
+  padding: 12px 16px;
+}
+@media (width <= 768px) {
+  .alinea-ExplorerOverviewHeader {
+    padding: 8px;
+  }
+}
+
 /* src/dashboard/app/ExplorerTable.module.css */
 .alinea-ExplorerTable-viewport {
   box-sizing: border-box;
@@ -6116,6 +6216,34 @@
   }
 }
 
+/* src/dashboard/app/ExplorerTabs.module.css */
+.alinea-ExplorerTabs {
+  flex: 1;
+  min-height: 0;
+}
+.alinea-ExplorerTabs-bar {
+  border-bottom: 1px solid var(--alinea-border);
+  background: var(--alinea-bg);
+  flex-shrink: 0;
+  height: 40px;
+  padding: 0 16px;
+}
+.alinea-ExplorerTabs-panel {
+  border-radius: 0;
+  flex-direction: column;
+  flex: 1;
+  min-height: 0;
+  display: flex;
+  &:focus-visible {
+    outline-offset: -2px;
+  }
+}
+@media (width <= 768px) {
+  .alinea-ExplorerTabs-bar {
+    padding: 0 8px;
+  }
+}
+
 /* src/dashboard/app/ImageEditor.module.css */
 .alinea-ImageEditor {
   --alinea-image-editor-height: min(56vh, 520px);
@@ -6418,10 +6546,17 @@
 }
 .alinea-OverviewCell-link {
   flex: 0 auto;
+  gap: 0;
   &:not(:last-child):after {
     content: ",";
   }
 }
+.alinea-OverviewCell-link-text {
+  text-overflow: ellipsis;
+  white-space: nowrap;
+  min-width: 0;
+  overflow: hidden;
+}
 .alinea-OverviewCell-thumbnail {
   border-radius: var(--alinea-radius-sm);
   background: var(--alinea-bg-muted);
@@ -6438,6 +6573,9 @@
 }
 
 /* src/dashboard/app/pages/EntryPage.module.css */
+.alinea-EntryEditor {
+  --alinea-header-height: 48px;
+}
 .alinea-EntryEditor-body {
   background: var(--alinea-bg-muted);
   min-width: 0;
@@ -6452,6 +6590,14 @@
 .alinea-EntryEditor-banner {
   background: var(--alinea-bg-muted);
 }
+.alinea-EntryEditor-viewBanner {
+  flex-shrink: 0;
+  padding: 16px 16px 0;
+}
+.alinea-EntryEditor-view {
+  min-width: 0;
+  min-height: 0;
+}
 .alinea-EntryEditor-toolbar {
   z-index: 1;
   border-top: 1px solid var(--alinea-border);
@@ -6487,6 +6633,9 @@
   .alinea-EntryEditor-body {
     padding: 8px;
   }
+  .alinea-EntryEditor-viewBanner {
+    padding: 8px 8px 0;
+  }
   .alinea-MissingEntry {
     padding: 12px;
   }
@@ -7521,14 +7670,14 @@
 }
 
 /* src/dashboard/global.css */
-html,
-body,
-#root {
+:where(html[data-alinea-theme]),
+:where(html[data-alinea-theme]) body,
+:where(html[data-alinea-theme]) #root {
   height: 100%;
   margin: 0;
   font-family: var(--alinea-font);
 }
-* {
+:where([data-alinea-theme], [data-alinea-theme] *) {
   box-sizing: border-box;
   padding: 0;
   margin: 0;
@@ -7540,12 +7689,12 @@ body[data-disable-transition=true] {
     transition: none !important;
   }
 }
-a {
+:where([data-alinea-theme] a) {
   color: inherit;
   font: inherit;
   text-decoration: none;
 }
-button {
+:where([data-alinea-theme] button) {
   background: none;
   border: none;
   color: inherit;
@@ -8341,8 +8490,10 @@ button {
 }
 
 /* src/theme.css */
-:root {
+:root[data-alinea-theme] {
   color-scheme: light dark;
+}
+:where([data-alinea-theme]:not([data-alinea-theme] *)) {
   --alinea-gray-0: #ffffff;
   --alinea-gray-50: #f9fafb;
   --alinea-gray-100: #f3f4f7;
@@ -8390,7 +8541,7 @@ button {
   --alinea-green-700: #007a55;
   --alinea-green-800: #006045;
 }
-:root {
+:where([data-alinea-theme]:not([data-alinea-theme] *)) {
   --alinea-font: "Inter", sans-serif;
   --alinea-mono-font: "JetBrains Mono", monospace;
   --alinea-font-size-base: 0.8125rem;
@@ -8407,8 +8558,8 @@ button {
   --alinea-warning-fg: var(--alinea-gray-900);
   --alinea-success: light-dark(var(--alinea-green-600), var(--alinea-green-500));
   --alinea-ring: var(--alinea-blue-500);
+  --alinea-workspace-color: var(--alinea-primary);
 }
-:root,
 [data-alinea-theme] {
   --alinea-transition: 0.2s ease-out;
   --alinea-radius-sm: calc(var(--alinea-radius) / 2);
@@ -8449,10 +8600,10 @@ button {
   --alinea-shadow-tooltip: 0 8px 20px rgb(0 0 0 / 10%);
   --alinea-shadow-modal: 0 2px 13px rgb(0 0 0 / 11%);
 }
-:root[data-theme=light] {
+[data-alinea-theme][data-theme=light] {
   color-scheme: light;
 }
-:root[data-theme=dark] {
+[data-alinea-theme][data-theme=dark] {
   color-scheme: dark;
 }
 

package/dist/index.d.ts

@@ -2,4 +2,5 @@ export * as Config from './config.js';
 export * as Edit from './edit.js';
 export * as Field from './field.js';
 export * as Query from './query.js';
+export { href } from './dashboard/Href.js';
 export type * from './types.js';

package/dist/index.js

@@ -5,9 +5,11 @@ import * as Config from "./config.js";
 import * as Edit from "./edit.js";
 import * as Field from "./field.js";
 import * as Query from "./query.js";
+import { href } from "./dashboard/Href.js";
 export {
   Config,
   Edit,
   Field,
-  Query
+  Query,
+  href
 };

package/dist/next.d.ts

@@ -2,4 +2,6 @@ export type { SyncStatus } from 'alinea/adapter/next/cms';
 export type { NextHandlerOptions } from 'alinea/adapter/next/handler';
 export { createCMS, createHandler } from 'alinea/adapter/next/node';
 export { withAlinea } from 'alinea/adapter/next/with-alinea';
+export type { RemovedEntry } from 'alinea/backend/CommitEntries';
 export type { AfterCommitContext, BeforeCommitContext } from 'alinea/backend/Handler';
+export type { DashboardEntry } from 'alinea/core/DashboardEntry';

package/dist/next.edge.d.ts

@@ -1,3 +1,5 @@
 export { createCMS, type SyncStatus } from 'alinea/adapter/next/cms';
 export { createHandler, type NextHandlerOptions } from 'alinea/adapter/next/handler';
+export type { RemovedEntry } from 'alinea/backend/CommitEntries';
 export type { AfterCommitContext, BeforeCommitContext } from 'alinea/backend/Handler';
+export type { DashboardEntry } from 'alinea/core/DashboardEntry';

package/dist/picker/entry/EntryPicker.d.ts

@@ -1,5 +1,5 @@
 import type { EntryFields } from 'alinea/core/EntryFields';
-import type { OpenFilter } from 'alinea/core/Filter';
+import { type OpenFilter } from 'alinea/core/Filter';
 import type { Graph, Projection } from 'alinea/core/Graph';
 import type { Label } from 'alinea/core/Label';
 import type { Picker } from 'alinea/core/Picker';
@@ -52,4 +52,6 @@ export interface EntryPickerOptions<Definition = {}> extends EntryPickerConditio
     fields?: Definition | Type<Definition>;
 }
 export declare function entryPicker<Ref extends EntryReference, Fields>(options: EntryPickerOptions<Fields>): Picker<Ref, EntryPickerOptions<Fields>>;
+/** @internal Throws for conditions an entry picker can't check, eg. relation filters */
+export declare function assertPickerCondition(condition: OpenFilter<EntryFields>): void;
 export {};

package/dist/picker/entry/EntryPicker.js

@@ -1,6 +1,7 @@
 import "../../chunks/chunk-CQ52GEHY.js";
 
 // src/picker/entry/EntryPicker.ts
+import { filterChecker } from "alinea/core/Filter";
 import { Reference } from "alinea/core/Reference";
 import { Root } from "alinea/core/Root";
 import { Type, type } from "alinea/core/Type";
@@ -12,6 +13,8 @@ import { selectLocalisedValue } from "alinea/field/localiser";
 import { EntryReference } from "./EntryReference.js";
 var unresolvedEntryMarker = /* @__PURE__ */ Symbol("unresolvedEntryMarker");
 function entryPicker(options) {
+  if (options.condition && typeof options.condition !== "function")
+    assertPickerCondition(options.condition);
   const fieldType = Type.isType(options.fields) ? options.fields : options.fields && type("Entry fields", { fields: options.fields });
   return {
     fields: fieldType,
@@ -71,7 +74,7 @@ function entryPicker(options) {
       });
       const version = typeof rest.hash === "string" ? rest.hash : void 0;
       const versionedSrc = typeof src === "string" ? MediaLocation.versionedUrl(src, version) : src;
-      assign(row, rest, { extension, src: versionedSrc, url: versionedSrc });
+      assign(row, rest, { extension, src: versionedSrc });
       if (typeof selectedAlt === "string") row.alt = selectedAlt;
     }
   };
@@ -104,7 +107,18 @@ function linkedLocalisation(loader, { workspace, root }) {
   const rootData = Root.data(rootConfig);
   return Root.mediaI18n(rootData) ?? rootData.i18n;
 }
+function assertPickerCondition(condition) {
+  try {
+    filterChecker(condition);
+  } catch (error) {
+    throw new Error(
+      `Invalid entry picker condition: ${error.message}`,
+      { cause: error }
+    );
+  }
+}
 export {
+  assertPickerCondition,
   entryPicker,
   unresolvedEntryMarker
 };

package/dist/preview/react.js

@@ -7,10 +7,13 @@ function usePreview(options) {
   const [isPreviewing, setIsPreviewing] = useState(false);
   const previewRef = useRef(options.preview);
   previewRef.current = options.preview;
+  const applied = useRef();
   useEffect(() => {
     return registerPreview(
       {
         preview(update) {
+          if (update?.payload === applied.current) return Promise.resolve();
+          applied.current = update?.payload;
           return previewRef.current(update);
         },
         setIsPreviewing

package/dist/query.d.ts

@@ -1,18 +1,20 @@
+import type { Expr } from 'alinea/core/Expr';
 import type { GraphQuery, IncludeGuard, PickModifiers, QueryModifiers, SelectionGuard, TypeGuard } from 'alinea/core/Graph';
-export declare const id: import("./core/Expr").Expr<string>;
-export declare const title: import("./core/Expr").Expr<string>;
-export declare const type: import("./core/Expr").Expr<string>;
-export declare const index: import("./core/Expr").Expr<string>;
-export declare const workspace: import("./core/Expr").Expr<string>;
-export declare const root: import("./core/Expr").Expr<string>;
-export declare const status: import("./core/Expr").Expr<import("alinea/core/Entry").EntryStatus>;
-export declare const parentId: import("./core/Expr").Expr<string | null>;
-export declare const locale: import("./core/Expr").Expr<string | null>;
-export declare const path: import("./core/Expr").Expr<string>;
-export declare const url: import("./core/Expr").Expr<string>;
-export declare const aliases: import("./core/Expr").Expr<import("alinea/core/Entry").EntryAlias[]>;
-export declare const createdAt: import("./core/Expr").Expr<number | null>;
-export declare const updatedAt: import("./core/Expr").Expr<number | null>;
+import type { HasField } from 'alinea/core/Internal';
+export declare const id: Expr<string>;
+export declare const title: Expr<string>;
+export declare const type: Expr<string>;
+export declare const index: Expr<string>;
+export declare const workspace: Expr<string>;
+export declare const root: Expr<string>;
+export declare const status: Expr<import("alinea/core/Entry").EntryStatus>;
+export declare const parentId: Expr<string | null>;
+export declare const locale: Expr<string | null>;
+export declare const path: Expr<string>;
+export declare const url: Expr<string>;
+export declare const aliases: Expr<import("alinea/core/Entry").EntryAlias[]>;
+export declare const createdAt: Expr<number | null>;
+export declare const updatedAt: Expr<number | null>;
 export { snippet } from 'alinea/core/pages/Snippet';
 /** A relation query, see PickModifiers */
 type RelationQuery<Edge extends string, Selection, Type, Include, Modifiers> = {
@@ -41,3 +43,13 @@ export declare function siblings<Selection extends SelectionGuard = undefined, T
 export declare function parent<Selection extends SelectionGuard = undefined, Type extends TypeGuard = undefined, Include extends IncludeGuard = undefined, Modifiers extends QueryModifiers = {}>(query: GraphQuery<Selection, Type, Include> & Modifiers): RelationQuery<'parent', Selection, Type, Include, Modifiers>;
 export declare function next<Selection extends SelectionGuard = undefined, Type extends TypeGuard = undefined, Include extends IncludeGuard = undefined, Modifiers extends QueryModifiers = {}>(query: GraphQuery<Selection, Type, Include> & Modifiers): RelationQuery<'next', Selection, Type, Include, Modifiers>;
 export declare function previous<Selection extends SelectionGuard = undefined, Type extends TypeGuard = undefined, Include extends IncludeGuard = undefined, Modifiers extends QueryModifiers = {}>(query: GraphQuery<Selection, Type, Include> & Modifiers): RelationQuery<'previous', Selection, Type, Include, Modifiers>;
+/**
+ * The entries that link to the entry, eg. the products of a brand:
+ * `Query.referencedBy({type: Product})`. Set `field` to only follow one
+ * link field, eg. `{type: Product, field: Product.brand}`.
+ */
+export declare function referencedBy<Selection extends SelectionGuard = undefined, Type extends TypeGuard = undefined, Include extends IncludeGuard = undefined, Modifiers extends QueryModifiers = {}>(query: GraphQuery<Selection, Type, Include> & Modifiers & {
+    field?: HasField & Expr;
+}): RelationQuery<'referencedBy', Selection, Type, Include, Modifiers> & {
+    field?: HasField & Expr;
+};

package/dist/query.js

@@ -38,6 +38,9 @@ function next(query) {
 function previous(query) {
   return { edge: "previous", ...query };
 }
+function referencedBy(query) {
+  return { edge: "referencedBy", ...query };
+}
 export {
   aliases,
   children,
@@ -51,6 +54,7 @@ export {
   parents,
   path,
   previous,
+  referencedBy,
   root,
   siblings,
   snippet,

package/dist/types.d.ts

@@ -1,16 +1,19 @@
+export type { DashboardEntry, EntryActionProps } from 'alinea/core/DashboardEntry';
+export type { FieldOptions, WithoutLabel } from 'alinea/core/Field';
 export type { Filter } from 'alinea/core/Filter';
-export type { Graph, GraphQuery } from 'alinea/core/Graph';
+export type { Graph, GraphQuery, QuerySettings } from 'alinea/core/Graph';
 export type { Infer } from 'alinea/core/Infer';
 export type { ListRow } from 'alinea/core/ListRow';
-export type { OverviewActionProps, OverviewBuiltins, OverviewCellProps, OverviewColumn, OverviewEntry, OverviewFilter, OverviewFilterOption, OverviewFormatContext, OverviewOptions, OverviewSort, OverviewSortBy, OverviewSortDirection, OverviewSortOption } from 'alinea/core/Overview';
+export type { OverviewActionProps, OverviewBuiltins, OverviewCellProps, OverviewColumn, OverviewEntry, OverviewFilter, OverviewFilterContext, OverviewFilterOption, OverviewFilterOptions, OverviewFormatContext, OverviewHeaderProps, OverviewOptions, OverviewSort, OverviewSortBy, OverviewSortDirection, OverviewSortOption, OverviewTab } from 'alinea/core/Overview';
 export type { Root } from 'alinea/core/Root';
 export type { Schema } from 'alinea/core/Schema';
 export type { BlockNode, ElementNode, ImageNode, LinkMark, Mark, TextDoc, TextNode } from 'alinea/core/TextDoc';
 export type { EntryUrlMeta, Type } from 'alinea/core/Type';
 export type { Workspace } from 'alinea/core/Workspace';
-export type { EntryLink } from 'alinea/field/link/EntryLink';
-export type { FileLink } from 'alinea/field/link/FileLink';
-export type { ImageLink } from 'alinea/field/link/ImageLink';
+export type { DashboardLocation } from 'alinea/dashboard/Href';
+export type { EntriesOptions, EntryLink, EntryOptions } from 'alinea/field/link/EntryLink';
+export type { FileLink, FileOptions, FilesOptions } from 'alinea/field/link/FileLink';
+export type { ImageLink, ImageOptions, ImagesOptions } from 'alinea/field/link/ImageLink';
 export type { Link } from 'alinea/field/link/Link';
 export type { UrlLink } from 'alinea/field/link/UrlLink';
 export type { EntryReference } from 'alinea/picker/entry/EntryReference';

package/dist/ui/Stack.d.ts

@@ -12,10 +12,12 @@ export interface StackProps extends PropsWithChildren<Omit<HTMLAttributes<HTMLEl
     autoWidth?: boolean;
 }
 /**
- * @deprecated Compatibility component for legacy dashboard extensions.
+ * @deprecated Compatibility component for legacy dashboard extensions, use
+ * `Stack` from `alinea/components`.
  */
 export declare const VStack: import("react").ForwardRefExoticComponent<StackProps & import("react").RefAttributes<HTMLElement>>;
 /**
- * @deprecated Compatibility component for legacy dashboard extensions.
+ * @deprecated Compatibility component for legacy dashboard extensions, use
+ * `<Stack direction="row">` from `alinea/components`.
  */
 export declare const HStack: import("react").ForwardRefExoticComponent<StackProps & import("react").RefAttributes<HTMLElement>>;

package/docs/ai-setup.md

@@ -19,15 +19,15 @@ The rest of this page is written for the agent. You are adding Alinea, a git-bas
 Install the package in the project root.
 
 ```shellscript
-npm install alinea@preview
+npm install alinea@rc
 ```
 
-With other package managers: `pnpm add alinea@preview`, `yarn add alinea@preview` or `bun add alinea@preview`.
+With other package managers: `pnpm add alinea@rc`, `yarn add alinea@rc` or `bun add alinea@rc`.
 
 ## 3. Run alinea init
 
 ```shellscript
-npx alinea@preview init
+npx alinea@rc init
 ```
 
 In a Next.js project `alinea init` creates:

package/docs/cli.md

@@ -85,9 +85,11 @@ Options
   --fix           Any missing or incorrect properties will be overwritten by their default
 ```
 
-`--config` and `--dir` work as for `alinea dev`. `--fix` rewrites content files whose data doesn't match the schema, filling missing or invalid properties with their defaults, and exits without running the command after `--`. Commit the result.
+`--config` and `--dir` work as for `alinea dev`. `--fix` rewrites content files whose data doesn't match the schema, filling missing or invalid properties with their defaults, and points media files whose `location` is a url at the file of the same name in the `mediaDir`. It exits without running the command after `--`. Commit the result.
 
-The build stops with an error when the config can't be loaded, when `handlerUrl` is missing or when `baseUrl` has no production URL, see [Configuration](configuration.md).
+The build stops with an error when the config can't be loaded, when `handlerUrl` is missing or when `baseUrl` has no production URL while `handlerUrl` is relative, see [Configuration](configuration.md).
+
+`alinea dev` and `alinea build` warn about media files whose `location` is a url, which can't be served (some 1.x saves wrote the upload url there). The warning names the file and, when the `mediaDir` holds a file of the same name, suggests `alinea build --fix` to point the location at it.
 
 ## Deploying