Add Repeatable

src/helpers/isFilled.ts

@@ -10,14 +10,15 @@ import type { KeyTextField } from "../types/value/keyText"
 import type { LinkField } from "../types/value/link"
 import type { LinkToMediaField } from "../types/value/linkToMedia"
 import type { NumberField } from "../types/value/number"
+import type { Repeatable } from "../types/value/repeatable"
 import type { RichTextField } from "../types/value/richText"
 import type { SelectField } from "../types/value/select"
 import type { SharedSlice } from "../types/value/sharedSlice"
 import type { Slice } from "../types/value/slice"
 import type { SliceZone } from "../types/value/sliceZone"
 import type { TimestampField } from "../types/value/timestamp"
 import type { TitleField } from "../types/value/title"
-import type { AnyRegularField } from "../types/value/types"
+import type { AnyRegularField, AnyRepeatableField } from "../types/value/types"
 
 /**
  * Determines if a value is not nullish (i.e. not `null` or `undefined`). This
@@ -266,6 +267,21 @@ export const integrationField = isNonNullish as <
 // TODO: Remove when we remove support for deprecated `integrationFields` export.
 export const integrationFields = integrationField
 
+/**
+ * Determines if a Repeatable has at least one item.
+ *
+ * @param repeatable - Repeatable to check.
+ *
+ * @returns `true` if `repeatable` contains at least one item, `false`
+ *   otherwise.
+ */
+
+export const repeatable = (
+	repeatable: Repeatable | null | undefined,
+): repeatable is Repeatable<Array<AnyRepeatableField>, "filled"> => {
+	return isNonNullish(repeatable) && isNonEmptyArray(repeatable)
+}
+
 /**
  * Determines if a Group has at least one item.
  *

src/types/value/repeatable.ts

@@ -0,0 +1,9 @@
+import type { AnyRepeatableField, FieldState } from "./types"
+
+/**
+ * A list of repeatable fields.
+ */
+export type Repeatable<
+	Fields extends Array<AnyRepeatableField> = Array<AnyRepeatableField>,
+	State extends FieldState = FieldState,
+> = State extends "empty" ? [] : [Fields, ...Fields[]]

src/types/value/types.ts

@@ -11,6 +11,7 @@ import type { KeyTextField } from "./keyText"
 import type { LinkField } from "./link"
 import type { LinkToMediaField } from "./linkToMedia"
 import type { NumberField } from "./number"
+import { Repeatable } from "./repeatable"
 import type { RichTextField } from "./richText"
 import type { SelectField } from "./select"
 import type { TimestampField } from "./timestamp"
@@ -26,6 +27,11 @@ export type EmptyObjectField = Record<string, never>
  */
 export type FieldState = "empty" | "filled"
 
+/**
+ * Any field that can be repeated.
+ */
+export type AnyRepeatableField = LinkField
+
 /**
  * Any regular field that can be nested in a group-like field.
  */
@@ -46,6 +52,7 @@ export type AnyRegularField =
 	| BooleanField
 	| GeoPointField
 	| IntegrationField
+	| Repeatable
 
 /**
  * Any field that can be used in a slice's primary section.