@evolu/common 8.9.0 → 8.11.0

package/src/Worker.ts

@@ -12,6 +12,7 @@ import { disposable } from "./Function.ts";
 /**
  * Typed, disposable Worker.
  *
+ * @group Core
  * @see https://developer.mozilla.org/en-US/docs/Web/API/Worker
  */
 export interface Worker<Input, Output = never> extends MessagePort<
@@ -25,6 +26,7 @@ export interface Worker<Input, Output = never> extends MessagePort<
  * A shared worker is shared across multiple clients (tabs, windows, iframes)
  * and provides a port for bidirectional communication with each client.
  *
+ * @group Core
  * @see https://developer.mozilla.org/en-US/docs/Web/API/SharedWorker
  */
 export interface SharedWorker<Input, Output = never> extends Disposable {
@@ -41,6 +43,7 @@ export interface SharedWorker<Input, Output = never> extends Disposable {
  * end periodically sends "alive" messages and stale ports are pruned after a
  * timeout.
  *
+ * @group Core
  * @see https://developer.mozilla.org/en-US/docs/Web/API/MessagePort
  */
 export interface MessagePort<Input, Output = never> extends Disposable {
@@ -92,6 +95,8 @@ export interface MessagePort<Input, Output = never> extends Disposable {
  * Intentionally scoped to types Evolu uses. The web platform defines additional
  * transferable types (`ImageBitmap`, `OffscreenCanvas`, `ReadableStream`, etc.)
  * that can be added here if needed.
+ *
+ * @group Core
  */
 export type Transferable = NativeMessagePort<any, any> | ArrayBuffer;
 
@@ -101,6 +106,8 @@ export type Transferable = NativeMessagePort<any, any> | ArrayBuffer;
  * Exists because `postMessage` transfer requires the native object itself, not
  * a wrapper. Ensures type-safe wiring between {@link MessagePort.native} and
  * {@link CreateMessagePort} without exposing platform details.
+ *
+ * @group Core
  */
 export type NativeMessagePort<
   Input = unknown,
@@ -113,16 +120,29 @@ export type NativeMessagePort<
 declare const nativeMessagePortInput: unique symbol;
 declare const nativeMessagePortOutput: unique symbol;
 
-/** Factory function to create a {@link MessagePort} from a native port. */
+/**
+ * Factory function to create a {@link MessagePort} from a native port.
+ *
+ * @group Construction
+ */
 export type CreateMessagePort = <Input, Output = never>(
   nativePort: NativeMessagePort<Input, Output>,
 ) => MessagePort<Input, Output>;
 
+/**
+ * Dependency wrapper for {@link CreateMessagePort}.
+ *
+ * @group Construction
+ */
 export interface CreateMessagePortDep {
   readonly createMessagePort: CreateMessagePort;
 }
 
-/** Common dependencies for worker entry points. */
+/**
+ * Common dependencies for worker entry points.
+ *
+ * @group Core
+ */
 export type WorkerDeps = ConsoleDep &
   ConsoleStoreOutputEntryDep &
   CreateMessagePortDep;
@@ -221,6 +241,7 @@ export type WorkerDeps = ConsoleDep &
  * ]);
  * ```
  *
+ * @group Core
  * @see https://developer.mozilla.org/en-US/docs/Web/API/MessageChannel
  */
 export interface MessageChannel<Input, Output = never> extends Disposable {
@@ -231,12 +252,21 @@ export interface MessageChannel<Input, Output = never> extends Disposable {
   readonly port2: MessagePort<Output, Input>;
 }
 
-/** Factory function to create a {@link MessageChannel}. */
+/**
+ * Factory function to create a {@link MessageChannel}.
+ *
+ * @group Construction
+ */
 export type CreateMessageChannel = <Input, Output = never>() => MessageChannel<
   Input,
   Output
 >;
 
+/**
+ * Dependency wrapper for {@link CreateMessageChannel}.
+ *
+ * @group Construction
+ */
 export interface CreateMessageChannelDep {
   readonly createMessageChannel: CreateMessageChannel;
 }
@@ -247,6 +277,7 @@ export interface CreateMessageChannelDep {
  * Broadcast channels deliver messages to other channels opened with the same
  * name. The sending channel does not receive its own messages.
  *
+ * @group Core
  * @see https://developer.mozilla.org/en-US/docs/Web/API/BroadcastChannel
  */
 export interface BroadcastChannel<Input, Output = Input> extends Disposable {
@@ -257,11 +288,20 @@ export interface BroadcastChannel<Input, Output = Input> extends Disposable {
   onMessage: ((message: Output) => void) | null;
 }
 
-/** Factory function to create a {@link BroadcastChannel}. */
+/**
+ * Factory function to create a {@link BroadcastChannel}.
+ *
+ * @group Construction
+ */
 export type CreateBroadcastChannel = <Input, Output = Input>(
   name: string,
 ) => BroadcastChannel<Input, Output>;
 
+/**
+ * Dependency wrapper for {@link CreateBroadcastChannel}.
+ *
+ * @group Construction
+ */
 export interface CreateBroadcastChannelDep {
   readonly createBroadcastChannel: CreateBroadcastChannel;
 }
@@ -271,6 +311,8 @@ export interface CreateBroadcastChannelDep {
  *
  * This is the worker-side counterpart to {@link Worker} — a typed
  * {@link MessagePort} that wraps `self` inside the worker.
+ *
+ * @group Core
  */
 export interface WorkerSelf<Input, Output = never> extends MessagePort<
   Output,
@@ -282,6 +324,8 @@ export interface WorkerSelf<Input, Output = never> extends MessagePort<
  *
  * This is the worker-side counterpart to {@link SharedWorker}. It wraps `self`
  * inside the shared worker, providing typed `onConnect` callbacks.
+ *
+ * @group Core
  */
 export interface SharedWorkerSelf<Input, Output = never> extends Disposable {
   onConnect: ((port: MessagePort<Output, Input>) => void) | null;
@@ -292,6 +336,8 @@ export interface SharedWorkerSelf<Input, Output = never> extends Disposable {
  *
  * This is a memory-only fallback for platforms without native worker support.
  * Message delivery is asynchronous in-process.
+ *
+ * @group Construction
  */
 export const createWorker = <Input, Output = never>(
   initWorker: (self: WorkerSelf<Input, Output>) => void,
@@ -309,6 +355,8 @@ export const createWorker = <Input, Output = never>(
  * in-process.
  *
  * Intended usage is one shared worker instance per process/app runtime.
+ *
+ * @group Construction
  */
 export const createSharedWorker = <Input, Output = never>(
   initWorker: (self: SharedWorkerSelf<Input, Output>) => void,
@@ -329,6 +377,8 @@ export const createSharedWorker = <Input, Output = never>(
  *
  * This is a memory-only fallback for platforms without native MessageChannel
  * support. Message delivery is asynchronous in-process.
+ *
+ * @group Construction
  */
 export const createMessageChannel: CreateMessageChannel = <
   Input,
@@ -386,6 +436,8 @@ export const createMessageChannel: CreateMessageChannel = <
  *
  * This is a memory-only fallback for platforms without native MessagePort
  * support. Message delivery through returned ports is asynchronous in-process.
+ *
+ * @group Construction
  */
 export const createMessagePort: CreateMessagePort = <Input, Output = never>(
   nativePort: NativeMessagePort<Input, Output>,
@@ -400,6 +452,8 @@ export const createMessagePort: CreateMessagePort = <Input, Output = never>(
  *
  * This is a memory-only fallback for platforms without native BroadcastChannel
  * support. Message delivery is asynchronous in-process.
+ *
+ * @group Construction
  */
 export const createBroadcastChannel: CreateBroadcastChannel = <
   Input,
@@ -468,6 +522,8 @@ const broadcastChannelDispatchesByName = new Map<
  * Test {@link Worker} with access to its paired worker-side `self`.
  *
  * Use `self` to simulate messages and behavior from inside the worker.
+ *
+ * @group Testing
  */
 export interface TestWorker<Input, Output = never> extends Worker<
   Input,
@@ -482,6 +538,8 @@ export interface TestWorker<Input, Output = never> extends Worker<
  *
  * Call `connect()` to simulate a client connection and trigger
  * `self.onConnect`.
+ *
+ * @group Testing
  */
 export interface TestSharedWorker<Input, Output = never> extends SharedWorker<
   Input,
@@ -491,7 +549,11 @@ export interface TestSharedWorker<Input, Output = never> extends SharedWorker<
   readonly connect: () => void;
 }
 
-/** {@link MessageChannel} with disposal tracking for testing. */
+/**
+ * {@link MessageChannel} with disposal tracking for testing.
+ *
+ * @group Testing
+ */
 export interface TestMessageChannel<
   Input,
   Output = never,
@@ -499,7 +561,11 @@ export interface TestMessageChannel<
   readonly isDisposed: () => boolean;
 }
 
-/** {@link BroadcastChannel} with disposal tracking for testing. */
+/**
+ * {@link BroadcastChannel} with disposal tracking for testing.
+ *
+ * @group Testing
+ */
 export interface TestBroadcastChannel<
   Input,
   Output = Input,
@@ -512,6 +578,8 @@ export interface TestBroadcastChannel<
  *
  * The returned worker includes its typed {@link TestWorker.self} counterpart, so
  * tests can exercise dedicated worker communication without a real thread.
+ *
+ * @group Testing
  */
 export const testCreateWorker = <Input, Output = never>(): TestWorker<
   Input,
@@ -531,6 +599,8 @@ export const testCreateWorker = <Input, Output = never>(): TestWorker<
  *
  * The returned worker includes `self` and `connect` so tests can exercise the
  * full worker ↔ client pipeline without a real worker thread.
+ *
+ * @group Testing
  */
 export const testCreateSharedWorker = <
   Input,
@@ -554,6 +624,8 @@ export const testCreateSharedWorker = <
  *
  * Both ports are registered in the native port registry so
  * {@link testCreateMessagePort} can look them up by their native token.
+ *
+ * @group Testing
  */
 export const testCreateMessageChannel = <
   Input,
@@ -572,12 +644,20 @@ export const testCreateMessageChannel = <
   };
 };
 
-/** Creates an in-memory {@link CreateMessagePort} for testing. */
+/**
+ * Creates an in-memory {@link CreateMessagePort} for testing.
+ *
+ * @group Testing
+ */
 export const testCreateMessagePort: CreateMessagePort = <Input, Output = never>(
   nativePort: NativeMessagePort<Input, Output>,
 ): MessagePort<Input, Output> => createMessagePort(nativePort);
 
-/** Creates an in-memory {@link BroadcastChannel} for testing. */
+/**
+ * Creates an in-memory {@link BroadcastChannel} for testing.
+ *
+ * @group Testing
+ */
 export const testCreateBroadcastChannel = <Input, Output = Input>(
   name: string,
 ): TestBroadcastChannel<Input, Output> => {
@@ -605,6 +685,8 @@ export const testCreateBroadcastChannel = <Input, Output = Input>(
  * This observes actual transport tasks instead of waiting for an arbitrary
  * duration. It also waits through message handlers that schedule more worker
  * tasks before the current microtask checkpoint completes.
+ *
+ * @group Testing
  */
 export const testWaitForWorkerMessage = (): Promise<void> =>
   new Promise((resolve) => {

package/src/index.ts

@@ -8,13 +8,15 @@ export * from "./Array.ts";
 export * from "./Assert.ts";
 export * from "./BigInt.ts";
 export * from "./Brand.ts";
-export * from "./Binary.ts";
+export * from "./Bytes.ts";
 export * from "./Cache.ts";
 export * from "./Callbacks.ts";
+export * from "./Config.ts";
 export * from "./Console.ts";
 export * from "./Crypto.ts";
 export * from "./Eq.ts";
 export * from "./Error.ts";
+export * from "./Fs.ts";
 export * from "./Function.ts";
 export * from "./Http.ts";
 export * from "./Identicon.ts";
@@ -49,16 +51,16 @@ export * from "./WebSocket.ts";
 export * from "./Worker.ts";
 
 // Local-first essentials.
-export type { EvoluError } from "./local-first/Error.ts";
-export { AppName, createEvolu } from "./local-first/Evolu.ts";
+export type { UnsupportedDbVersionError } from "./local-first/Db.ts";
+export { AppName, createEvolu, testAppName } from "./local-first/Evolu.ts";
 export type {
   AppNameError,
   Evolu,
   EvoluConfig,
   EvoluDeps,
+  EvoluError,
   UnuseOwner,
 } from "./local-first/Evolu.ts";
-export * from "./local-first/LocalAuth.ts";
 export * from "./local-first/Owner.ts";
 export type { SyncOwner } from "./local-first/Owner.ts";
 export {
@@ -73,7 +75,17 @@ export {
   type QueryRows,
   type Row,
 } from "./local-first/Query.ts";
-export { createQueryBuilder } from "./local-first/Schema.ts";
+export {
+  createQueryBuilder,
+  QuarantineOrigin,
+  QuarantineReason,
+  testEvoluSchema,
+  testLocalOnlyEvoluSchema,
+  TestProjectId,
+  testProjectId,
+  TestTodoId,
+  testTodoId,
+} from "./local-first/Schema.ts";
 export type {
   AnyStandardSchemaV1,
   EvoluSchema,
@@ -86,6 +98,7 @@ export type {
   OptionalColumnKeys,
   RequiredColumnKeys,
   TableSchema,
+  TestEvoluSchema,
   UpdateValues,
   UpsertValues,
 } from "./local-first/Schema.ts";
@@ -102,8 +115,6 @@ export {
 } from "./local-first/Timestamp.ts";
 export type {
   TimestampBytes,
-  TimestampCounterOverflowError,
   TimestampDriftError,
   TimestampError,
-  TimestampTimeOutOfRangeError,
 } from "./local-first/Timestamp.ts";

package/src/intl/_en.ts

@@ -13,13 +13,21 @@
  * @module
  */
 
+import type { DurationLiteralError } from "../Time.ts";
+import type { PercentageLiteralError } from "../Number.ts";
+import type { ByteSizeLiteralError } from "../Bytes.ts";
 import { assertNonNullable } from "../Assert.ts";
 import { safelyStringifyUnknownValue } from "../String.ts";
 import type {
   ArrayError,
   Base64UrlError,
+  BooleanFromStringError,
   BetweenError,
+  IdentifierError,
   CapitalizedError,
+  UncapitalizedError,
+  UppercasedError,
+  LowercasedError,
   DateIsoError,
   DateIsoFromDateError,
   DecimalStringError,
@@ -32,6 +40,7 @@ import type {
   Int64Error,
   Int64StringError,
   IntError,
+  IntFromStringError,
   IdError,
   JsonError,
   JsonValueError,
@@ -63,6 +72,7 @@ import type {
   RecordError,
   RegexError,
   SetError,
+  StartsWithError,
   TableIdError,
   TemplateLiteralError,
   TrimmedError,
@@ -119,6 +129,12 @@ export const formatBigIntError: TypeErrorFormatter<TypeOfError<"BigInt">> =
 export const formatBooleanError: TypeErrorFormatter<TypeOfError<"Boolean">> =
   formatTypeOfError;
 
+/** Formats a BooleanFromStringError in English. */
+export const formatBooleanFromStringError: TypeErrorFormatter<
+  BooleanFromStringError
+> = (error) =>
+  `The value ${safelyStringifyUnknownValue(error.value)} is not a boolean. Use true or false.`;
+
 /** Formats a Symbol TypeOfError in English. */
 export const formatSymbolError: TypeErrorFormatter<TypeOfError<"Symbol">> =
   formatTypeOfError;
@@ -182,16 +198,46 @@ export const formatInt64StringError: TypeErrorFormatter<Int64StringError> = (
 ) =>
   `The value ${safelyStringifyUnknownValue(error.value)} is not a valid Int64 string.`;
 
+/** Formats an IdentifierError in English. */
+export const formatIdentifierError: TypeErrorFormatter<IdentifierError> = (
+  error,
+) =>
+  `The value ${safelyStringifyUnknownValue(error.value)} is not a ${error.casing} identifier.`;
+
 /** Formats a CapitalizedError in English. */
 export const formatCapitalizedError: TypeErrorFormatter<CapitalizedError> = (
   error,
 ) =>
   `The value ${safelyStringifyUnknownValue(error.value)} must be capitalized.`;
 
+/** Formats an UncapitalizedError in English. */
+export const formatUncapitalizedError: TypeErrorFormatter<
+  UncapitalizedError
+> = (error) =>
+  `The value ${safelyStringifyUnknownValue(error.value)} must not start with an uppercase letter.`;
+
+/** Formats an UppercasedError in English. */
+export const formatUppercasedError: TypeErrorFormatter<UppercasedError> = (
+  error,
+) =>
+  `The value ${safelyStringifyUnknownValue(error.value)} must be uppercased.`;
+
+/** Formats a LowercasedError in English. */
+export const formatLowercasedError: TypeErrorFormatter<LowercasedError> = (
+  error,
+) =>
+  `The value ${safelyStringifyUnknownValue(error.value)} must be lowercased.`;
+
 /** Formats a TrimmedError in English. */
 export const formatTrimmedError: TypeErrorFormatter<TrimmedError> = (error) =>
   `The value ${safelyStringifyUnknownValue(error.value)} must be trimmed.`;
 
+/** Formats a StartsWithError in English. */
+export const formatStartsWithError: TypeErrorFormatter<StartsWithError> = (
+  error,
+) =>
+  `The value ${safelyStringifyUnknownValue(error.value)} must start with ${safelyStringifyUnknownValue(error.prefix)}.`;
+
 /** Formats a MinLengthError in English. */
 export const formatMinLengthError: TypeErrorFormatter<MinLengthError> = (
   error,
@@ -282,6 +328,12 @@ export const formatNegativeDecimalStringError: TypeErrorFormatter<
 export const formatIntError: TypeErrorFormatter<IntError> = (error) =>
   `The value ${safelyStringifyUnknownValue(error.value)} must be a safe integer.`;
 
+/** Formats an IntFromStringError in English. */
+export const formatIntFromStringError: TypeErrorFormatter<
+  IntFromStringError
+> = (error) =>
+  `The value ${safelyStringifyUnknownValue(error.value)} is not a decimal integer.`;
+
 /** Formats a GreaterThanError in English. */
 export const formatGreaterThanError: TypeErrorFormatter<GreaterThanError> = (
   error,
@@ -511,3 +563,21 @@ export const formatJsonValueError: TypeErrorFormatter<JsonValueError> = (
 /** Formats a JsonError in English. */
 export const formatJsonError: TypeErrorFormatter<JsonError> = (error) =>
   `The value ${safelyStringifyUnknownValue(error.value)} cannot be parsed into a JsonValue.`;
+
+/** Formats a {@link ByteSizeLiteralError}. */
+export const formatByteSizeLiteralError: TypeErrorFormatter<
+  ByteSizeLiteralError
+> = (error) =>
+  `The value ${safelyStringifyUnknownValue(error.value)} is not a byte-size literal. Use a value such as "512KiB" or "1MiB".`;
+
+/** Formats a {@link DurationLiteralError}. */
+export const formatDurationLiteralError: TypeErrorFormatter<
+  DurationLiteralError
+> = (error) =>
+  `The value ${safelyStringifyUnknownValue(error.value)} is not a duration literal. Use a value such as "500ms" or "1.5s".`;
+
+/** Formats a {@link PercentageLiteralError}. */
+export const formatPercentageLiteralError: TypeErrorFormatter<
+  PercentageLiteralError
+> = (error) =>
+  `The value ${safelyStringifyUnknownValue(error.value)} is not a percentage literal. Use a value such as "50%" or "12.5%".`;

package/src/intl/ar.ts

@@ -4,13 +4,21 @@
  * @module
  */
 
+import type { DurationLiteralError } from "../Time.ts";
+import type { PercentageLiteralError } from "../Number.ts";
+import type { ByteSizeLiteralError } from "../Bytes.ts";
 import { assertNonNullable } from "../Assert.ts";
 import { safelyStringifyUnknownValue } from "../String.ts";
 import type {
   ArrayError,
   Base64UrlError,
+  BooleanFromStringError,
   BetweenError,
+  IdentifierError,
   CapitalizedError,
+  UncapitalizedError,
+  UppercasedError,
+  LowercasedError,
   DateIsoError,
   DateIsoFromDateError,
   DecimalStringError,
@@ -23,6 +31,7 @@ import type {
   Int64Error,
   Int64StringError,
   IntError,
+  IntFromStringError,
   IdError,
   JsonError,
   JsonValueError,
@@ -56,6 +65,7 @@ import type {
   SetError,
   TableIdError,
   TemplateLiteralError,
+  StartsWithError,
   TrimmedError,
   TupleElementsError,
   TupleError,
@@ -152,14 +162,45 @@ export const formatInt64StringError: TypeErrorFormatter<Int64StringError> = (
   error,
 ) =>
   `القيمة ${safelyStringifyUnknownValue(error.value)} ليست سلسلة Int64 صالحة.`;
+
+/** Formats an IdentifierError in Arabic. */
+export const formatIdentifierError: TypeErrorFormatter<IdentifierError> = (
+  error,
+) =>
+  `القيمة ${safelyStringifyUnknownValue(error.value)} ليست معرّفًا بصيغة ${error.casing}.`;
+
 /** Formats a CapitalizedError in Arabic. */
 export const formatCapitalizedError: TypeErrorFormatter<CapitalizedError> = (
   error,
 ) =>
   `يجب أن تبدأ القيمة ${safelyStringifyUnknownValue(error.value)} بحرف كبير.`;
+
+/** Formats an UncapitalizedError in Arabic. */
+export const formatUncapitalizedError: TypeErrorFormatter<
+  UncapitalizedError
+> = (error) =>
+  `يجب ألا تبدأ القيمة ${safelyStringifyUnknownValue(error.value)} بحرف كبير.`;
+
+/** Formats an UppercasedError in Arabic. */
+export const formatUppercasedError: TypeErrorFormatter<UppercasedError> = (
+  error,
+) =>
+  `يجب أن تكون القيمة ${safelyStringifyUnknownValue(error.value)} بأحرف كبيرة.`;
+
+/** Formats a LowercasedError in Arabic. */
+export const formatLowercasedError: TypeErrorFormatter<LowercasedError> = (
+  error,
+) =>
+  `يجب أن تكون القيمة ${safelyStringifyUnknownValue(error.value)} بأحرف صغيرة.`;
 /** Formats a TrimmedError in Arabic. */
 export const formatTrimmedError: TypeErrorFormatter<TrimmedError> = (error) =>
   `يجب إزالة المسافات من بداية القيمة ${safelyStringifyUnknownValue(error.value)} ونهايتها.`;
+/** Formats a StartsWithError in Arabic. */
+export const formatStartsWithError: TypeErrorFormatter<StartsWithError> = (
+  error,
+) =>
+  `يجب أن تبدأ القيمة ${safelyStringifyUnknownValue(error.value)} بـ ${safelyStringifyUnknownValue(error.prefix)}.`;
+
 /** Formats a MinLengthError in Arabic. */
 export const formatMinLengthError: TypeErrorFormatter<MinLengthError> = (
   error,
@@ -265,6 +306,18 @@ export const formatMultipleOfError: TypeErrorFormatter<MultipleOfError> = (
 export const formatBetweenError: TypeErrorFormatter<BetweenError> = (error) =>
   `يجب أن تكون القيمة ${safelyStringifyUnknownValue(error.value)} بين ${error.min} و${error.max}، شاملةً.`;
 
+/** Formats a BooleanFromStringError in Arabic. */
+export const formatBooleanFromStringError: TypeErrorFormatter<
+  BooleanFromStringError
+> = (error) =>
+  `القيمة ${safelyStringifyUnknownValue(error.value)} ليست قيمة منطقية. استخدم true أو false.`;
+
+/** Formats an IntFromStringError in Arabic. */
+export const formatIntFromStringError: TypeErrorFormatter<
+  IntFromStringError
+> = (error) =>
+  `القيمة ${safelyStringifyUnknownValue(error.value)} ليست عددًا صحيحًا عشريًا.`;
+
 /** Formats an ArrayError in Arabic. */
 export const formatArrayError: TypeErrorFormatter<ArrayError> = (error) => {
   if (error.reason.kind === "NotArray")
@@ -430,3 +483,21 @@ export const formatJsonValueError: TypeErrorFormatter<JsonValueError> = (
 /** Formats a JsonError in Arabic. */
 export const formatJsonError: TypeErrorFormatter<JsonError> = (error) =>
   `لا يمكن تحليل القيمة ${safelyStringifyUnknownValue(error.value)} إلى JsonValue.`;
+
+/** Formats a {@link ByteSizeLiteralError}. */
+export const formatByteSizeLiteralError: TypeErrorFormatter<
+  ByteSizeLiteralError
+> = (error) =>
+  `القيمة ${safelyStringifyUnknownValue(error.value)} ليست قيمة حرفية لحجم بالبايت. استخدم قيمة مثل "512KiB" أو "1MiB".`;
+
+/** Formats a {@link DurationLiteralError}. */
+export const formatDurationLiteralError: TypeErrorFormatter<
+  DurationLiteralError
+> = (error) =>
+  `القيمة ${safelyStringifyUnknownValue(error.value)} ليست قيمة حرفية لمدة زمنية. استخدم قيمة مثل "500ms" أو "1.5s".`;
+
+/** Formats a {@link PercentageLiteralError}. */
+export const formatPercentageLiteralError: TypeErrorFormatter<
+  PercentageLiteralError
+> = (error) =>
+  `القيمة ${safelyStringifyUnknownValue(error.value)} ليست قيمة حرفية لنسبة مئوية. استخدم قيمة مثل "50%" أو "12.5%".`;