@protobase/schema 0.23.7 → 0.23.8

package/dist/app-address.d.ts

@@ -19,6 +19,8 @@ export declare const addressWords: {
   readonly map: "map";
   /** The month or week a list's calendar display shows: `month,YYYY-MM-DD` or `week,YYYY-MM-DD`. */
   readonly calendar: "calendar";
+  /** The period a list's timeline display shows: `week,YYYY-MM-DD`, `month,YYYY-MM-DD` or `quarter,YYYY-MM-DD`. */
+  readonly timeline: "timeline";
   /** The saved search a list was opened from, by its key. */
   readonly savedSearch: "saved_search";
   /** The second path segment that opens a resource's create form instead of a record. */

package/dist/app-address.js

@@ -19,6 +19,8 @@ const addressWords = {
 	map: "map",
 	/** The month or week a list's calendar display shows: `month,YYYY-MM-DD` or `week,YYYY-MM-DD`. */
 	calendar: "calendar",
+	/** The period a list's timeline display shows: `week,YYYY-MM-DD`, `month,YYYY-MM-DD` or `quarter,YYYY-MM-DD`. */
+	timeline: "timeline",
 	/** The saved search a list was opened from, by its key. */
 	savedSearch: "saved_search",
 	/** The second path segment that opens a resource's create form instead of a record. */
@@ -50,7 +52,7 @@ const readMap = (text) => {
 		zoom
 	} : void 0;
 };
-const calendarText = (view) => `${view.scale},${view.day}`;
+const periodText = (view) => `${view.scale},${view.day}`;
 const isDay = (text) => {
 	const match = /^(\d{4})-(\d{2})-(\d{2})$/.exec(text);
 	if (!match) return false;
@@ -58,11 +60,11 @@ const isDay = (text) => {
 	const date = new Date(Date.UTC(year, month - 1, day));
 	return date.getUTCFullYear() === year && date.getUTCMonth() === month - 1 && date.getUTCDate() === day;
 };
-const readCalendar = (text) => {
+const readPeriod = (text, scales) => {
 	const parts = text?.split(",");
 	if (parts?.length !== 2) return void 0;
 	const [scale, day] = parts;
-	return (scale === "month" || scale === "week") && isDay(day) ? {
+	return scales.includes(scale) && isDay(day) ? {
 		scale,
 		day
 	} : void 0;
@@ -75,7 +77,8 @@ const listQuery = (address) => {
 		query.set(addressWords[name], value);
 	}
 	if (address.map) query.set(addressWords.map, mapText(address.map));
-	if (address.calendar) query.set(addressWords.calendar, calendarText(address.calendar));
+	if (address.calendar) query.set(addressWords.calendar, periodText(address.calendar));
+	if (address.timeline) query.set(addressWords.timeline, periodText(address.timeline));
 	const text = query.toString();
 	return text ? `?${text}` : "";
 };
@@ -150,7 +153,12 @@ const readAppPath = (pathAndQuery, pages) => {
 	const orderBy = params.get(addressWords.orderBy) || void 0;
 	const layout = filterLayout(params.get(addressWords.filterLayout));
 	const map = readMap(params.get(addressWords.map));
-	const calendar = readCalendar(params.get(addressWords.calendar));
+	const calendar = readPeriod(params.get(addressWords.calendar), ["month", "week"]);
+	const timeline = readPeriod(params.get(addressWords.timeline), [
+		"week",
+		"month",
+		"quarter"
+	]);
 	const savedSearch = params.get(addressWords.savedSearch) || void 0;
 	return {
 		kind: "list",
@@ -162,6 +170,7 @@ const readAppPath = (pathAndQuery, pages) => {
 		...layout && { filterLayout: layout },
 		...map && { map },
 		...calendar && { calendar },
+		...timeline && { timeline },
 		...savedSearch && { savedSearch }
 	};
 };

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { Rollup, RollupCount, RollupFn, RollupSource, RollupValue } from "./computed/rollup.js";
 import { FileOptions, FileProcessor, FileProcessorInput, ImageFormat, ImageVariant, ImageVariantOptions, imageFormats } from "./files/file-options.js";
-import { ActionInputKind, ActionInputModel, ActionModel, ActionRun, AppAddress, BadgeShape, BottomBarItemModel, BottomBarModel, CalendarView, CardFavoriteModel, CardPhotosModel, ChartGranularity, ChartModel, ChartRange, CheckedFilter, CommentsSectionModel, CompareOp, CreateModel, CustomSectionModel, DatePreset, DurationLiteral, DurationUnit, EventModel, EventOperation, ExportModel, FieldFormat, FieldModel, FieldPath, FieldType, FieldViewModel, FieldWidgetModel, FileFieldModel, FilterError, FilterErrorCode, FilterExpr, FilterLayout, FilterOf, FilterValue, FilterWidgetModel, FormModel, GalleryModel, GroupChartModel, GroupItemModel, GroupModel, HelpWhen, HistorySectionModel, JsonValue, KeyValue, LayoutItemModel, ListDisplayModel, ListModel, ListQuery, Literal, MapSectionModel, MapView, NamedListModel, NavModel, NavRecentModel, NowValue, OrderByItem, PeriodChartModel, RecordMode, RecordWhen, RelatedColumnModel, RelatedModel, ResourceModel, SaveFeedback, SaveSearchModel, SearchMatch, SearchResultModel, SearchesOfModel, SectionModel, SectionPresentation, ShowWhen, SignInPromptModel, SignInViewModel, SortSpec, Span, StatusTone, TabItemModel, TabModel, UserMenuItemModel, UserMenuModel, ViewModel } from "./model.js";
+import { ActionInputKind, ActionInputModel, ActionModel, ActionRun, AppAddress, BadgeShape, BottomBarItemModel, BottomBarModel, CalendarView, CardFavoriteModel, CardPhotosModel, ChartGranularity, ChartModel, ChartRange, CheckedFilter, CommentsSectionModel, CompareOp, CreateModel, CustomSectionModel, DatePreset, DurationLiteral, DurationUnit, EventModel, EventOperation, ExportModel, FieldFormat, FieldModel, FieldPath, FieldType, FieldViewModel, FieldWidgetModel, FileFieldModel, FilterError, FilterErrorCode, FilterExpr, FilterLayout, FilterOf, FilterValue, FilterWidgetModel, FormModel, GalleryModel, GroupChartModel, GroupItemModel, GroupModel, HelpWhen, HistorySectionModel, JsonValue, KeyValue, LayoutItemModel, ListDisplayModel, ListModel, ListQuery, Literal, MapSectionModel, MapView, NamedListModel, NavModel, NavRecentModel, NowValue, OrderByItem, PeriodChartModel, RecordMode, RecordWhen, RelatedColumnModel, RelatedModel, ResourceModel, SaveFeedback, SaveSearchModel, SearchMatch, SearchResultModel, SearchesOfModel, SectionModel, SectionPresentation, ShowWhen, SignInPromptModel, SignInViewModel, SortSpec, Span, StatusTone, TabItemModel, TabModel, TimelineView, UserMenuItemModel, UserMenuModel, ViewModel } from "./model.js";
 import { AccessAction, AccessContext, AccessFn, AccessResult, AccessUser, FieldAccess, FieldRule } from "./access/types.js";
 import { AnyField, Constraint, Field, FieldMeta, FieldTypeDef } from "./field.js";
 import { RelationField } from "./relation-field.js";
@@ -43,4 +43,4 @@ import { AccessSource, ResolveOptions, ResolvedAccess, RowFilterOperation, acces
 import { restrictModel } from "./access/restrict.js";
 import "./access/index.js";
 import { AssistantAction, AssistantActionRequest, AssistantCardPart, AssistantDiff, AssistantEvent, AssistantMessage, AssistantMessageRequest, AssistantPart, AssistantState, AssistantStep, AssistantStepState, AssistantTablePart, AssistantTextPart, AssistantTone, AssistantWidgetPart } from "./assistant/protocol.js";
-export { type Access, type AccessAction, type AccessContext, type AccessFn, type AccessResult, type AccessSource, type AccessUser, type ActionInputKind, type ActionInputModel, type ActionModel, type ActionRun, type AnyField, type AppAddress, type AssistantAction, type AssistantActionRequest, type AssistantCardPart, type AssistantDiff, type AssistantEvent, type AssistantMessage, type AssistantMessageRequest, type AssistantPart, type AssistantState, type AssistantStep, type AssistantStepState, type AssistantTablePart, type AssistantTextPart, type AssistantTone, type AssistantWidgetPart, type BadgeShape, type BottomBarItemModel, type BottomBarModel, type BottomBarNames, type BottomBarSource, type CalendarView, type Capability, type CapabilityAction, type CapabilityLimit, type CapabilityScope, type CardFavoriteModel, type CardPhotosModel, type ChartGranularity, type ChartInput, type ChartModel, type ChartRange, type CheckResult, type CheckedFilter, type CommentsSectionModel, type CompareOp, type ComponentRef, type Constraint, type CreateModel, type CreatedOptions, type CustomSectionModel, type DatePreset, type DeletedOptions, type DurationLiteral, type DurationUnit, type EvaluateOptions, type EventActor, type EventContext, type EventHelpers, type EventMatch, type EventModel, type EventOperation, type EventSpec, type ExportModel, type Field, type FieldAccess, type FieldFormat, type FieldMeta, type FieldModel, type FieldPath, type FieldRefValue, type FieldRefs, type FieldRule, type FieldType, type FieldTypeDef, type FieldView, type FieldViewModel, type FieldViews, type FieldWidgetModel, type FieldsInput, type FileField, type FileFieldModel, type FileOptions, type FileProcessor, type FileProcessorInput, type FilterError, type FilterErrorCode, type FilterExpr, type FilterLayout, type FilterLimits, type FilterOf, type FilterParse, type FilterValue, type FilterWidgetModel, type FormAddress, type FormInput, type FormModel, type GalleryModel, type Grant, type GroupChartInput, type GroupChartModel, type GroupItemModel, type GroupModel, type HeldCapability, type HelpWhen, type HistorySectionModel, type ImageFormat, type ImageVariant, type ImageVariantOptions, type InferRecord, type Issue, type JsonValue, type KeyOf, type KeyRefs, type KeyType, type KeyValue, type LayoutItemModel, type ListColumn, type ListDisplayModel, type ListModel, type ListQuery, type Literal, type MapSectionModel, type MapView, type NamedListModel, type NavModel, type NavRecentModel, type NowValue, type OrderByCheck, type OrderByItem, type OrderByParse, type PeriodChartInput, type PeriodChartModel, type RecordKey, type RecordMode, type RecordOf, type RecordWhen, type Ref, type Refs, type RelatedColumnModel, type RelatedModel, type RelationField, type ResolveOptions, type ResolvedAccess, type ResourceBuilder, type ResourceModel, type RoleEntry, type RoleLimit, type Roles, type RolesOptions, type Rollup, type RollupCount, type RollupFn, type RollupSource, type RollupValue, type RowFilterOperation, type Rule, type SaveFeedback, type SaveSearchModel, type SearchMatch, type SearchRef, type SearchRefs, type SearchResultModel, type SearchesOfModel, type SectionModel, type SectionPresentation, type ShowWhen, type SignInAddress, type SignInPromptModel, type SignInStep, type SignInViewModel, type SortSpec, type Span, type StatusTone, type TabItemModel, type TabModel, type UndeletedOptions, type UpdatedOptions, type UserMenuItemModel, type UserMenuModel, type UserMenuSource, type Validator, type ViewBuilder, type ViewModel, type ViewProps, accessWarnings, addressWords, anonymousRole, appPath, bottomBar, bottomBarErrors, checkFilter, checkOrderBy, checkRecord, createWhere, defineRoles, enumLabel, evaluateFilter, f, fieldRef, fieldsUsedBy, fitsKeyType, formPath, formRoute, imageFormats, isRecordCondition, keyTypes, layout as l, maxBottomBarItems, parseFilter, parseOrderBy, pickView, printFilter, printOrderBy, readAppPath, readFormAddress, readSignInAddress, resolveAccess, resource, restrictModel, rule, signInParams, signInPath, signInRoute, signInSteps, userMenu, view, where };
+export { type Access, type AccessAction, type AccessContext, type AccessFn, type AccessResult, type AccessSource, type AccessUser, type ActionInputKind, type ActionInputModel, type ActionModel, type ActionRun, type AnyField, type AppAddress, type AssistantAction, type AssistantActionRequest, type AssistantCardPart, type AssistantDiff, type AssistantEvent, type AssistantMessage, type AssistantMessageRequest, type AssistantPart, type AssistantState, type AssistantStep, type AssistantStepState, type AssistantTablePart, type AssistantTextPart, type AssistantTone, type AssistantWidgetPart, type BadgeShape, type BottomBarItemModel, type BottomBarModel, type BottomBarNames, type BottomBarSource, type CalendarView, type Capability, type CapabilityAction, type CapabilityLimit, type CapabilityScope, type CardFavoriteModel, type CardPhotosModel, type ChartGranularity, type ChartInput, type ChartModel, type ChartRange, type CheckResult, type CheckedFilter, type CommentsSectionModel, type CompareOp, type ComponentRef, type Constraint, type CreateModel, type CreatedOptions, type CustomSectionModel, type DatePreset, type DeletedOptions, type DurationLiteral, type DurationUnit, type EvaluateOptions, type EventActor, type EventContext, type EventHelpers, type EventMatch, type EventModel, type EventOperation, type EventSpec, type ExportModel, type Field, type FieldAccess, type FieldFormat, type FieldMeta, type FieldModel, type FieldPath, type FieldRefValue, type FieldRefs, type FieldRule, type FieldType, type FieldTypeDef, type FieldView, type FieldViewModel, type FieldViews, type FieldWidgetModel, type FieldsInput, type FileField, type FileFieldModel, type FileOptions, type FileProcessor, type FileProcessorInput, type FilterError, type FilterErrorCode, type FilterExpr, type FilterLayout, type FilterLimits, type FilterOf, type FilterParse, type FilterValue, type FilterWidgetModel, type FormAddress, type FormInput, type FormModel, type GalleryModel, type Grant, type GroupChartInput, type GroupChartModel, type GroupItemModel, type GroupModel, type HeldCapability, type HelpWhen, type HistorySectionModel, type ImageFormat, type ImageVariant, type ImageVariantOptions, type InferRecord, type Issue, type JsonValue, type KeyOf, type KeyRefs, type KeyType, type KeyValue, type LayoutItemModel, type ListColumn, type ListDisplayModel, type ListModel, type ListQuery, type Literal, type MapSectionModel, type MapView, type NamedListModel, type NavModel, type NavRecentModel, type NowValue, type OrderByCheck, type OrderByItem, type OrderByParse, type PeriodChartInput, type PeriodChartModel, type RecordKey, type RecordMode, type RecordOf, type RecordWhen, type Ref, type Refs, type RelatedColumnModel, type RelatedModel, type RelationField, type ResolveOptions, type ResolvedAccess, type ResourceBuilder, type ResourceModel, type RoleEntry, type RoleLimit, type Roles, type RolesOptions, type Rollup, type RollupCount, type RollupFn, type RollupSource, type RollupValue, type RowFilterOperation, type Rule, type SaveFeedback, type SaveSearchModel, type SearchMatch, type SearchRef, type SearchRefs, type SearchResultModel, type SearchesOfModel, type SectionModel, type SectionPresentation, type ShowWhen, type SignInAddress, type SignInPromptModel, type SignInStep, type SignInViewModel, type SortSpec, type Span, type StatusTone, type TabItemModel, type TabModel, type TimelineView, type UndeletedOptions, type UpdatedOptions, type UserMenuItemModel, type UserMenuModel, type UserMenuSource, type Validator, type ViewBuilder, type ViewModel, type ViewProps, accessWarnings, addressWords, anonymousRole, appPath, bottomBar, bottomBarErrors, checkFilter, checkOrderBy, checkRecord, createWhere, defineRoles, enumLabel, evaluateFilter, f, fieldRef, fieldsUsedBy, fitsKeyType, formPath, formRoute, imageFormats, isRecordCondition, keyTypes, layout as l, maxBottomBarItems, parseFilter, parseOrderBy, pickView, printFilter, printOrderBy, readAppPath, readFormAddress, readSignInAddress, resolveAccess, resource, restrictModel, rule, signInParams, signInPath, signInRoute, signInSteps, userMenu, view, where };

package/dist/internal.d.ts

@@ -1,7 +1,7 @@
 import { checkedAccept, checkedProvider, parseSize } from "./files/file-options.js";
 import { actionInputErrors, shownInputs } from "./action-inputs.js";
 import { chartFields, isGroupChart } from "./view-chart.js";
-import { boardErrors, calendarErrors, cardPhotoLimit, displayFields, tableDisplay } from "./view-displays.js";
+import { boardErrors, cardPhotoLimit, datesErrors, displayFields, tableDisplay } from "./view-displays.js";
 import { fieldRefsIn, isFieldRef, markFieldRefs, unmarkFieldRefs } from "./field-ref.js";
 import { bottomBarFor } from "./bottom-bar.js";
 import { decodeKey, encodeKey } from "./keys.js";
@@ -22,4 +22,4 @@ import { readEventStream } from "./assistant/event-stream.js";
 import { layoutItems } from "./layout-items.js";
 import { viewOfList } from "./named-list.js";
 import { Locale, isLocale, locales, pickLocale } from "./locale.js";
-export { type AddressCheck, type FormulaNode, type Locale, type PluginHost, type PluginRequirement, type PropShapes, type RefShape, type SearchTerm, actionInputErrors, addressErrors, addressPlaceholders, appHrefError, applyAssistantEvent, boardErrors, bottomBarFor, calendarErrors, cardPhotoLimit, chartFields, checkEventFilter, checkedAccept, checkedProvider, decodeKey, defaultRecentLimit, displayFields, emptyAssistantState, encodeKey, fieldRefsIn, fillAddress, hrefField, hrefPlaceholders, inRange, isFieldRef, isGroupChart, isLocale, layoutItems, leavesApp, linkActionError, locales, markFieldRefs, matchedSearchField, matchesSearch, navRecentErrors, parseFormula, parseSize, pickLocale, pluginProblem, promptError, promptFields, pruneByShape, readEventStream, redactSecrets, renderPrompt, searchTerms, shapes, shownInputs, statusTones, tableDisplay, termMatches, unmarkFieldRefs, updateSetErrors, updateValues, viewOfList, webhookResources };
+export { type AddressCheck, type FormulaNode, type Locale, type PluginHost, type PluginRequirement, type PropShapes, type RefShape, type SearchTerm, actionInputErrors, addressErrors, addressPlaceholders, appHrefError, applyAssistantEvent, boardErrors, bottomBarFor, cardPhotoLimit, chartFields, checkEventFilter, checkedAccept, checkedProvider, datesErrors, decodeKey, defaultRecentLimit, displayFields, emptyAssistantState, encodeKey, fieldRefsIn, fillAddress, hrefField, hrefPlaceholders, inRange, isFieldRef, isGroupChart, isLocale, layoutItems, leavesApp, linkActionError, locales, markFieldRefs, matchedSearchField, matchesSearch, navRecentErrors, parseFormula, parseSize, pickLocale, pluginProblem, promptError, promptFields, pruneByShape, readEventStream, redactSecrets, renderPrompt, searchTerms, shapes, shownInputs, statusTones, tableDisplay, termMatches, unmarkFieldRefs, updateSetErrors, updateValues, viewOfList, webhookResources };

package/dist/internal.js

@@ -11,7 +11,7 @@ import { actionInputErrors, shownInputs } from "./action-inputs.js";
 import { updateSetErrors, updateValues } from "./update-set.js";
 import { chartFields, isGroupChart } from "./view-chart.js";
 import { fieldRefsIn, isFieldRef, markFieldRefs, unmarkFieldRefs } from "./field-ref.js";
-import { boardErrors, calendarErrors, cardPhotoLimit, displayFields, tableDisplay } from "./view-displays.js";
+import { boardErrors, cardPhotoLimit, datesErrors, displayFields, tableDisplay } from "./view-displays.js";
 import { bottomBarFor } from "./bottom-bar.js";
 import { decodeKey, encodeKey } from "./keys.js";
 import { webhookResources } from "./webhooks/webhook-resources.js";
@@ -22,4 +22,4 @@ import { addressErrors } from "./address-errors.js";
 import { applyAssistantEvent, emptyAssistantState } from "./assistant/apply-event.js";
 import { readEventStream } from "./assistant/event-stream.js";
 import { isLocale, locales, pickLocale } from "./locale.js";
-export { actionInputErrors, addressErrors, addressPlaceholders, appHrefError, applyAssistantEvent, boardErrors, bottomBarFor, calendarErrors, cardPhotoLimit, chartFields, checkEventFilter, checkedAccept, checkedProvider, decodeKey, defaultRecentLimit, displayFields, emptyAssistantState, encodeKey, fieldRefsIn, fillAddress, hrefField, hrefPlaceholders, inRange, isFieldRef, isGroupChart, isLocale, layoutItems, leavesApp, linkActionError, locales, markFieldRefs, matchedSearchField, matchesSearch, navRecentErrors, parseFormula, parseSize, pickLocale, pluginProblem, promptError, promptFields, pruneByShape, readEventStream, redactSecrets, renderPrompt, searchTerms, shapes, shownInputs, statusTones, tableDisplay, termMatches, unmarkFieldRefs, updateSetErrors, updateValues, viewOfList, webhookResources };
+export { actionInputErrors, addressErrors, addressPlaceholders, appHrefError, applyAssistantEvent, boardErrors, bottomBarFor, cardPhotoLimit, chartFields, checkEventFilter, checkedAccept, checkedProvider, datesErrors, decodeKey, defaultRecentLimit, displayFields, emptyAssistantState, encodeKey, fieldRefsIn, fillAddress, hrefField, hrefPlaceholders, inRange, isFieldRef, isGroupChart, isLocale, layoutItems, leavesApp, linkActionError, locales, markFieldRefs, matchedSearchField, matchesSearch, navRecentErrors, parseFormula, parseSize, pickLocale, pluginProblem, promptError, promptFields, pruneByShape, readEventStream, redactSecrets, renderPrompt, searchTerms, shapes, shownInputs, statusTones, tableDisplay, termMatches, unmarkFieldRefs, updateSetErrors, updateValues, viewOfList, webhookResources };

package/dist/model.d.ts

@@ -192,11 +192,18 @@ export type CalendarView = {
   /** A day in the month or week, as `YYYY-MM-DD`. */
   day: string;
 };
+/** Which week, month or quarter a list's timeline display shows: its `scale`, and a day (`YYYY-MM-DD`) in it. */
+export type TimelineView = {
+  /** A week from Monday, a month, or a quarter from January, April, July or October. */
+  scale: 'week' | 'month' | 'quarter';
+  /** A day in the week, month or quarter, as `YYYY-MM-DD`. */
+  day: string;
+};
 /**
  * A place in the app: a resource's list, one of its records, its create form, or a composed page. A record's `key` is
  * its one value or its parts, as the record API takes them; `readAppPath` gives it back as the API's text form. A create
  * form's `values` fill in fields of the new record by name, as text (`{ listing_id: '42' }`). A list's `map` is where its
- * map display looks, and its `calendar` the month or week its calendar display shows. See [Addresses](website/src/content/docs/reference/layouts.md#addresses).
+ * map display looks, its `calendar` the month or week its calendar display shows, and its `timeline` the period its timeline display shows. See [Addresses](website/src/content/docs/reference/layouts.md#addresses).
  */
 export type AppAddress = {
   /** A resource's list. */
@@ -217,6 +224,8 @@ export type AppAddress = {
   map?: MapView;
   /** The month or week its calendar display shows. */
   calendar?: CalendarView;
+  /** The week, month or quarter its timeline display shows. */
+  timeline?: TimelineView;
   /**
    * The saved search the list was opened from, by its key in the text form the record API takes: while the list's
    * filter differs from the search's, the list offers to update the search.
@@ -419,6 +428,23 @@ export type ListDisplayModel = {
   end?: string;
   /** The event's text; the view's title when omitted. */
   title?: string;
+} | {
+  /** The records as bars from their start day to their end day over a week, month or quarter, in lanes by a field, moved by dragging. */
+  kind: 'timeline';
+  /** What the address names (`?display=timeline`). */
+  name: string;
+  /** The display's name in the switch. */
+  label?: string;
+  /** The display's icon in the switch. */
+  icon?: string;
+  /** The filterable date or timestamp field a record starts on. */
+  start: string;
+  /** The filterable field of `start`'s type a record ends on; a record's bar is its start day alone when omitted. */
+  end?: string;
+  /** The field whose values are the lanes; one lane when omitted. */
+  group?: string;
+  /** The bar's text; the view's title when omitted. */
+  title?: string;
 } | {
   /** The rows drawn by a project component. */
   kind: 'custom';

package/dist/view-displays.d.ts

@@ -107,6 +107,22 @@ export declare const displays: {
     end?: Ref;
     title?: Ref;
   }, o?: Naming) => ListDisplayModel;
+  /**
+   * The records as bars from the day of `start` to the day of `end` (or their start day alone), one row each, over a
+   * week, a month or a quarter, in lanes by the values of `group`, with weeks from Monday. It loads only the days shown
+   * through the list API, with the list's filter and search, in start order, as a calendar does. A bar shows `title`
+   * (default: the view's title) and opens the record. Dragging a bar along its row, or picking it up with Space and
+   * moving it with the arrow keys, saves the record with `start` and `end` moved by the same days, as one update with
+   * its ETag, so the resource's access rules and `validate` decide, and a refusal puts the bar back and says why.
+   * `start` must be a filterable date or timestamp field and `end` a filterable field of the same type. Named
+   * `timeline` unless `name` says otherwise. See [Timelines](website/src/content/docs/reference/ui-config.mdx#timelines).
+   */
+  timeline: (fields: {
+    start: Ref;
+    end?: Ref;
+    group?: Ref;
+    title?: Ref;
+  }, o?: Naming) => ListDisplayModel;
   /**
    * The list drawn by a component of the project, registered in `protobase.ui.tsx` under its name. It gets `props` and
    * reads the rows with `useListDisplay()`; `fields` are the fields it shows, fetched with relation names.
@@ -122,10 +138,10 @@ export declare const displays: {
 export declare const boardErrors: (display: Extract<ListDisplayModel, {
   kind: "board";
 }>, model: ResourceModel) => string[];
-/** What makes a calendar unable to place the records on days: a `start` that is no filterable date or timestamp, or an `end` that is no filterable field of its type. */
-export declare const calendarErrors: (display: Extract<ListDisplayModel, {
-  kind: "calendar";
+/** What makes a calendar or a timeline unable to place the records on days: a `start` that is no filterable date or timestamp, or an `end` that is no filterable field of its type. */
+export declare const datesErrors: (display: Extract<ListDisplayModel, {
+  kind: "calendar" | "timeline";
 }>, model: ResourceModel) => string[];
-/** Every field a display names: what it shows, a map's position and the fields saying how exact it is, a board's columns, a calendar's dates, and the field references in a custom display's props. */
+/** Every field a display names: what it shows, a map's position and the fields saying how exact it is, a board's columns, a calendar's dates, a timeline's dates and lanes, and the field references in a custom display's props. */
 export declare const displayFields: (display: ListDisplayModel) => string[];
 //#endregion

package/dist/view-displays.js

@@ -110,6 +110,25 @@ const displays = {
 		...fields.title && { title: fields.title.name }
 	}),
 	/**
+	* The records as bars from the day of `start` to the day of `end` (or their start day alone), one row each, over a
+	* week, a month or a quarter, in lanes by the values of `group`, with weeks from Monday. It loads only the days shown
+	* through the list API, with the list's filter and search, in start order, as a calendar does. A bar shows `title`
+	* (default: the view's title) and opens the record. Dragging a bar along its row, or picking it up with Space and
+	* moving it with the arrow keys, saves the record with `start` and `end` moved by the same days, as one update with
+	* its ETag, so the resource's access rules and `validate` decide, and a refusal puts the bar back and says why.
+	* `start` must be a filterable date or timestamp field and `end` a filterable field of the same type. Named
+	* `timeline` unless `name` says otherwise. See [Timelines](website/src/content/docs/reference/ui-config.mdx#timelines).
+	*/
+	timeline: (fields, o = {}) => ({
+		kind: "timeline",
+		name: o.name ?? "timeline",
+		...naming(o),
+		start: fields.start.name,
+		...fields.end && { end: fields.end.name },
+		...fields.group && { group: fields.group.name },
+		...fields.title && { title: fields.title.name }
+	}),
+	/**
 	* The list drawn by a component of the project, registered in `protobase.ui.tsx` under its name. It gets `props` and
 	* reads the rows with `useListDisplay()`; `fields` are the fields it shows, fetched with relation names.
 	*/
@@ -149,21 +168,21 @@ const boardErrors = (display, model) => {
 	if (field.type !== "enum") return [`"${display.by}" on ${model.name} is ${field.type}, not an enum, whose values are the board's columns`];
 	return field.filterable ? [] : [`"${display.by}" on ${model.name} is not filterable, and each column of the board filters by its value`];
 };
-/** What makes a calendar unable to place the records on days: a `start` that is no filterable date or timestamp, or an `end` that is no filterable field of its type. */
-const calendarErrors = (display, model) => {
+/** What makes a calendar or a timeline unable to place the records on days: a `start` that is no filterable date or timestamp, or an `end` that is no filterable field of its type. */
+const datesErrors = (display, model) => {
 	const known = (name) => Object.hasOwn(model.fields, name) ? model.fields[name] : void 0;
 	const start = known(display.start);
 	const end = display.end === void 0 ? void 0 : known(display.end);
 	if (!start) return [];
 	if (start.type !== "date" && start.type !== "timestamp") return [`start "${display.start}" on ${model.name} is ${start.type}, not a date or timestamp`];
-	const unfilterable = (name) => `${name === display.start ? "start" : "end"} "${name}" on ${model.name} is not filterable, and the calendar filters by it for the days it shows`;
+	const unfilterable = (name) => `${name === display.start ? "start" : "end"} "${name}" on ${model.name} is not filterable, and the ${display.kind} filters by it for the days it shows`;
 	return [
 		...start.filterable ? [] : [unfilterable(display.start)],
 		...end && end.type !== start.type ? [`end "${display.end}" on ${model.name} is ${end.type}, not ${start.type} like start "${display.start}"`] : [],
 		...end && end.type === start.type && !end.filterable ? [unfilterable(display.end)] : []
 	];
 };
-/** Every field a display names: what it shows, a map's position and the fields saying how exact it is, a board's columns, a calendar's dates, and the field references in a custom display's props. */
+/** Every field a display names: what it shows, a map's position and the fields saying how exact it is, a board's columns, a calendar's dates, a timeline's dates and lanes, and the field references in a custom display's props. */
 const displayFields = (display) => {
 	if (display.kind === "map") return [
 		display.latitude,
@@ -186,6 +205,12 @@ const displayFields = (display) => {
 		display.end,
 		display.title
 	].filter((name) => name !== void 0);
+	if (display.kind === "timeline") return [
+		display.start,
+		display.end,
+		display.group,
+		display.title
+	].filter((name) => name !== void 0);
 	return [
 		display.image,
 		display.title,
@@ -198,4 +223,4 @@ const displayFields = (display) => {
 	].filter((name) => name !== void 0);
 };
 //#endregion
-export { boardErrors, calendarErrors, cardPhotoLimit, customComponent, displayErrors, displayFields, displays, tableDisplay };
+export { boardErrors, cardPhotoLimit, customComponent, datesErrors, displayErrors, displayFields, displays, tableDisplay };

package/dist/view.d.ts

@@ -69,7 +69,7 @@ export declare class ViewBuilder<R extends {
   fields(build: (r: FieldViews<R>) => Record<string, FieldView>): ViewBuilder<R>;
   /**
    * The list: its table's `columns`, fields or columns of related records (`c.related`), `sort`, `search` and a `filter` it opens with, the
-   * columns that are `editable` in their cell, and other `displays` to switch to (`d.cards`, `d.map`, `d.board`, `d.calendar`, `d.custom`), one of which
+   * columns that are `editable` in their cell, and other `displays` to switch to (`d.cards`, `d.map`, `d.board`, `d.calendar`, `d.timeline`, `d.custom`), one of which
    * may be the `default` the list opens in. Throws when display or column names collide, `default` names none or an
    * editable field is not among the columns. See
    * [Editing in the list](website/src/content/docs/reference/ui-config.mdx#editing-in-the-list).

package/dist/view.js

@@ -8,7 +8,7 @@ import { actions } from "./view-actions.js";
 import { chartModel } from "./view-chart.js";
 import { formModel } from "./view-form.js";
 import { columns, isListColumn } from "./view-columns.js";
-import { boardErrors, calendarErrors, displayErrors, displayFields, displays } from "./view-displays.js";
+import { boardErrors, datesErrors, displayErrors, displayFields, displays } from "./view-displays.js";
 import { FieldView } from "./view-field.js";
 import { widgets } from "./view-widgets.js";
 //#region src/view.ts
@@ -88,7 +88,7 @@ var ViewBuilder = class ViewBuilder {
 	}
 	/**
 	* The list: its table's `columns`, fields or columns of related records (`c.related`), `sort`, `search` and a `filter` it opens with, the
-	* columns that are `editable` in their cell, and other `displays` to switch to (`d.cards`, `d.map`, `d.board`, `d.calendar`, `d.custom`), one of which
+	* columns that are `editable` in their cell, and other `displays` to switch to (`d.cards`, `d.map`, `d.board`, `d.calendar`, `d.timeline`, `d.custom`), one of which
 	* may be the `default` the list opens in. Throws when display or column names collide, `default` names none or an
 	* editable field is not among the columns. See
 	* [Editing in the list](website/src/content/docs/reference/ui-config.mdx#editing-in-the-list).
@@ -296,8 +296,8 @@ var ViewBuilder = class ViewBuilder {
 			if (flag !== void 0) throw new Error(`View "${this.state.resource}": display "${display.name}" shows "${flag}" as a flag, which is not a boolean field`);
 			const board = display.kind === "board" ? boardErrors(display, resource) : [];
 			if (board.length > 0) throw new Error(`View "${this.state.resource}": display "${display.name}": ${board.join("; ")}`);
-			const calendar = display.kind === "calendar" ? calendarErrors(display, resource) : [];
-			if (calendar.length > 0) throw new Error(`View "${this.state.resource}": display "${display.name}": ${calendar.join("; ")}`);
+			const dates = display.kind === "calendar" || display.kind === "timeline" ? datesErrors(display, resource) : [];
+			if (dates.length > 0) throw new Error(`View "${this.state.resource}": display "${display.name}": ${dates.join("; ")}`);
 		}
 		const clash = resource ? list?.relatedColumns?.find((column) => Object.hasOwn(resource.fields, column.name)) : void 0;
 		if (clash) throw new Error(`View "${this.state.resource}": related column "${clash.name}" has the name of a field of the resource`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@protobase/schema",
-  "version": "0.23.7",
+  "version": "0.23.8",
   "description": "Resource, field, view and access definitions for Protobase configs.",
   "license": "Apache-2.0",
   "repository": {