@evolu/common 8.8.0 → 8.10.0

package/src/intl/ur.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,44 @@ export const formatInt64StringError: TypeErrorFormatter<Int64StringError> = (
   error,
 ) =>
   `قدر ${safelyStringifyUnknownValue(error.value)} درست Int64 string نہیں ہے۔`;
+
+/** Formats an IdentifierError in Urdu. */
+export const formatIdentifierError: TypeErrorFormatter<IdentifierError> = (
+  error,
+) =>
+  `قدر ${safelyStringifyUnknownValue(error.value)} ${error.casing} شناخت کنندہ نہیں ہے۔`;
+
 /** CapitalizedError کو اردو میں فارمیٹ کرتا ہے۔ */
 export const formatCapitalizedError: TypeErrorFormatter<CapitalizedError> = (
   error,
 ) =>
   `قدر ${safelyStringifyUnknownValue(error.value)} کا پہلا حرف بڑا ہونا چاہیے۔`;
+
+/** Formats an UncapitalizedError in Urdu. */
+export const formatUncapitalizedError: TypeErrorFormatter<
+  UncapitalizedError
+> = (error) =>
+  `قدر ${safelyStringifyUnknownValue(error.value)} بڑے حرف سے شروع نہیں ہونی چاہیے۔`;
+
+/** Formats an UppercasedError in Urdu. */
+export const formatUppercasedError: TypeErrorFormatter<UppercasedError> = (
+  error,
+) => `قدر ${safelyStringifyUnknownValue(error.value)} بڑے حروف میں ہونی چاہیے۔`;
+
+/** Formats a LowercasedError in Urdu. */
+export const formatLowercasedError: TypeErrorFormatter<LowercasedError> = (
+  error,
+) =>
+  `قدر ${safelyStringifyUnknownValue(error.value)} چھوٹے حروف میں ہونی چاہیے۔`;
 /** TrimmedError کو اردو میں فارمیٹ کرتا ہے۔ */
 export const formatTrimmedError: TypeErrorFormatter<TrimmedError> = (error) =>
   `قدر ${safelyStringifyUnknownValue(error.value)} کے شروع یا آخر میں خالی جگہ نہیں ہونی چاہیے۔`;
+/** Formats a StartsWithError in Urdu. */
+export const formatStartsWithError: TypeErrorFormatter<StartsWithError> = (
+  error,
+) =>
+  `قدر ${safelyStringifyUnknownValue(error.value)} کی ابتدا ${safelyStringifyUnknownValue(error.prefix)} سے ہونی چاہیے۔`;
+
 /** MinLengthError کو اردو میں فارمیٹ کرتا ہے۔ */
 export const formatMinLengthError: TypeErrorFormatter<MinLengthError> = (
   error,
@@ -265,6 +305,18 @@ export const formatMultipleOfError: TypeErrorFormatter<MultipleOfError> = (
 export const formatBetweenError: TypeErrorFormatter<BetweenError> = (error) =>
   `قدر ${safelyStringifyUnknownValue(error.value)} ${error.min} اور ${error.max} کے درمیان، دونوں شامل، ہونی چاہیے۔`;
 
+/** BooleanFromStringError کو اردو میں فارمیٹ کرتا ہے۔ */
+export const formatBooleanFromStringError: TypeErrorFormatter<
+  BooleanFromStringError
+> = (error) =>
+  `قدر ${safelyStringifyUnknownValue(error.value)} بولین نہیں ہے۔ true یا false استعمال کریں۔`;
+
+/** IntFromStringError کو اردو میں فارمیٹ کرتا ہے۔ */
+export const formatIntFromStringError: TypeErrorFormatter<
+  IntFromStringError
+> = (error) =>
+  `قدر ${safelyStringifyUnknownValue(error.value)} اعشاری عددِ صحیح نہیں ہے۔`;
+
 /** ArrayError کو اردو میں فارمیٹ کرتا ہے۔ */
 export const formatArrayError: TypeErrorFormatter<ArrayError> = (error) => {
   if (error.reason.kind === "NotArray")
@@ -423,3 +475,21 @@ export const formatJsonValueError: TypeErrorFormatter<JsonValueError> = (
 /** JsonError کو اردو میں فارمیٹ کرتا ہے۔ */
 export const formatJsonError: TypeErrorFormatter<JsonError> = (error) =>
   `قدر ${safelyStringifyUnknownValue(error.value)} کو JsonValue میں parse نہیں کیا جا سکتا۔`;
+
+/** 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%" جیسی قدر استعمال کریں۔`;

package/src/intl/vi.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,
@@ -153,14 +163,44 @@ export const formatInt64StringError: TypeErrorFormatter<Int64StringError> = (
   error,
 ) =>
   `Giá trị ${safelyStringifyUnknownValue(error.value)} không phải là chuỗi Int64 hợp lệ.`;
+
+/** Formats an IdentifierError in Vietnamese. */
+export const formatIdentifierError: TypeErrorFormatter<IdentifierError> = (
+  error,
+) =>
+  `Giá trị ${safelyStringifyUnknownValue(error.value)} không phải là định danh ${error.casing}.`;
+
 /** Định dạng CapitalizedError bằng tiếng Việt. */
 export const formatCapitalizedError: TypeErrorFormatter<CapitalizedError> = (
   error,
 ) =>
   `Giá trị ${safelyStringifyUnknownValue(error.value)} phải viết hoa chữ cái đầu.`;
+
+/** Formats an UncapitalizedError in Vietnamese. */
+export const formatUncapitalizedError: TypeErrorFormatter<
+  UncapitalizedError
+> = (error) =>
+  `Giá trị ${safelyStringifyUnknownValue(error.value)} không được bắt đầu bằng chữ hoa.`;
+
+/** Formats an UppercasedError in Vietnamese. */
+export const formatUppercasedError: TypeErrorFormatter<UppercasedError> = (
+  error,
+) => `Giá trị ${safelyStringifyUnknownValue(error.value)} phải được viết hoa.`;
+
+/** Formats a LowercasedError in Vietnamese. */
+export const formatLowercasedError: TypeErrorFormatter<LowercasedError> = (
+  error,
+) =>
+  `Giá trị ${safelyStringifyUnknownValue(error.value)} phải được viết thường.`;
 /** Định dạng TrimmedError bằng tiếng Việt. */
 export const formatTrimmedError: TypeErrorFormatter<TrimmedError> = (error) =>
   `Giá trị ${safelyStringifyUnknownValue(error.value)} phải được cắt khoảng trắng đầu và cuối.`;
+/** Formats a StartsWithError in Vietnamese. */
+export const formatStartsWithError: TypeErrorFormatter<StartsWithError> = (
+  error,
+) =>
+  `Giá trị ${safelyStringifyUnknownValue(error.value)} phải bắt đầu bằng ${safelyStringifyUnknownValue(error.prefix)}.`;
+
 /** Định dạng MinLengthError bằng tiếng Việt. */
 export const formatMinLengthError: TypeErrorFormatter<MinLengthError> = (
   error,
@@ -266,6 +306,18 @@ export const formatMultipleOfError: TypeErrorFormatter<MultipleOfError> = (
 export const formatBetweenError: TypeErrorFormatter<BetweenError> = (error) =>
   `Giá trị ${safelyStringifyUnknownValue(error.value)} phải nằm trong khoảng từ ${error.min} đến ${error.max}, kể cả hai đầu.`;
 
+/** Định dạng BooleanFromStringError bằng tiếng Việt. */
+export const formatBooleanFromStringError: TypeErrorFormatter<
+  BooleanFromStringError
+> = (error) =>
+  `Giá trị ${safelyStringifyUnknownValue(error.value)} không phải là giá trị boolean. Hãy dùng true hoặc false.`;
+
+/** Định dạng IntFromStringError bằng tiếng Việt. */
+export const formatIntFromStringError: TypeErrorFormatter<
+  IntFromStringError
+> = (error) =>
+  `Giá trị ${safelyStringifyUnknownValue(error.value)} không phải là số nguyên thập phân.`;
+
 /** Định dạng ArrayError bằng tiếng Việt. */
 export const formatArrayError: TypeErrorFormatter<ArrayError> = (error) => {
   if (error.reason.kind === "NotArray") {
@@ -449,3 +501,21 @@ export const formatJsonValueError: TypeErrorFormatter<JsonValueError> = (
 /** Định dạng JsonError bằng tiếng Việt. */
 export const formatJsonError: TypeErrorFormatter<JsonError> = (error) =>
   `Giá trị ${safelyStringifyUnknownValue(error.value)} không thể được phân tích thành JsonValue.`;
+
+/** Formats a {@link ByteSizeLiteralError}. */
+export const formatByteSizeLiteralError: TypeErrorFormatter<
+  ByteSizeLiteralError
+> = (error) =>
+  `Giá trị ${safelyStringifyUnknownValue(error.value)} không phải là hằng kích thước byte. Hãy dùng giá trị như "512KiB" hoặc "1MiB".`;
+
+/** Formats a {@link DurationLiteralError}. */
+export const formatDurationLiteralError: TypeErrorFormatter<
+  DurationLiteralError
+> = (error) =>
+  `Giá trị ${safelyStringifyUnknownValue(error.value)} không phải là hằng khoảng thời gian. Hãy dùng giá trị như "500ms" hoặc "1.5s".`;
+
+/** Formats a {@link PercentageLiteralError}. */
+export const formatPercentageLiteralError: TypeErrorFormatter<
+  PercentageLiteralError
+> = (error) =>
+  `Giá trị ${safelyStringifyUnknownValue(error.value)} không phải là hằng phần trăm. Hãy dùng giá trị như "50%" hoặc "12.5%".`;

package/src/intl/zh-CN.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,
@@ -110,6 +120,12 @@ export const formatBigIntError: TypeErrorFormatter<TypeOfError<"BigInt">> =
 export const formatBooleanError: TypeErrorFormatter<TypeOfError<"Boolean">> =
   formatTypeOfError;
 
+/** Formats a BooleanFromStringError。 */
+export const formatBooleanFromStringError: TypeErrorFormatter<
+  BooleanFromStringError
+> = (error) =>
+  `值 ${safelyStringifyUnknownValue(error.value)} 不是布尔值。请使用 true 或 false。`;
+
 /** 以简体中文格式化 Symbol TypeOfError。 */
 export const formatSymbolError: TypeErrorFormatter<TypeOfError<"Symbol">> =
   formatTypeOfError;
@@ -171,15 +187,43 @@ export const formatInt64StringError: TypeErrorFormatter<Int64StringError> = (
   error,
 ) => `值 ${safelyStringifyUnknownValue(error.value)} 不是有效的 Int64 字符串。`;
 
+/** Formats an IdentifierError in Simplified Chinese. */
+export const formatIdentifierError: TypeErrorFormatter<IdentifierError> = (
+  error,
+) =>
+  `值 ${safelyStringifyUnknownValue(error.value)} 不是 ${error.casing} 标识符。`;
+
 /** 以简体中文格式化 CapitalizedError。 */
 export const formatCapitalizedError: TypeErrorFormatter<CapitalizedError> = (
   error,
 ) => `值 ${safelyStringifyUnknownValue(error.value)} 必须以大写字母开头。`;
 
+/** Formats an UncapitalizedError in Simplified Chinese. */
+export const formatUncapitalizedError: TypeErrorFormatter<
+  UncapitalizedError
+> = (error) =>
+  `值 ${safelyStringifyUnknownValue(error.value)} 不得以大写字母开头。`;
+
+/** Formats an UppercasedError in Simplified Chinese. */
+export const formatUppercasedError: TypeErrorFormatter<UppercasedError> = (
+  error,
+) => `值 ${safelyStringifyUnknownValue(error.value)} 必须为大写。`;
+
+/** Formats a LowercasedError in Simplified Chinese. */
+export const formatLowercasedError: TypeErrorFormatter<LowercasedError> = (
+  error,
+) => `值 ${safelyStringifyUnknownValue(error.value)} 必须为小写。`;
+
 /** 以简体中文格式化 TrimmedError。 */
 export const formatTrimmedError: TypeErrorFormatter<TrimmedError> = (error) =>
   `值 ${safelyStringifyUnknownValue(error.value)} 必须去除首尾空白。`;
 
+/** Formats a StartsWithError in Simplified Chinese. */
+export const formatStartsWithError: TypeErrorFormatter<StartsWithError> = (
+  error,
+) =>
+  `值 ${safelyStringifyUnknownValue(error.value)} 必须以 ${safelyStringifyUnknownValue(error.prefix)} 开头。`;
+
 /** 以简体中文格式化 MinLengthError。 */
 export const formatMinLengthError: TypeErrorFormatter<MinLengthError> = (
   error,
@@ -268,6 +312,12 @@ export const formatNegativeDecimalStringError: TypeErrorFormatter<
 export const formatIntError: TypeErrorFormatter<IntError> = (error) =>
   `值 ${safelyStringifyUnknownValue(error.value)} 必须是安全整数。`;
 
+/** Formats an IntFromStringError。 */
+export const formatIntFromStringError: TypeErrorFormatter<
+  IntFromStringError
+> = (error) =>
+  `值 ${safelyStringifyUnknownValue(error.value)} 不是十进制整数。`;
+
 /** 以简体中文格式化 GreaterThanError。 */
 export const formatGreaterThanError: TypeErrorFormatter<GreaterThanError> = (
   error,
@@ -495,3 +545,21 @@ export const formatJsonValueError: TypeErrorFormatter<JsonValueError> = (
 /** 以简体中文格式化 JsonError。 */
 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%" 这样的值。`;

package/src/intl/zh-TW.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,
@@ -110,6 +120,12 @@ export const formatBigIntError: TypeErrorFormatter<TypeOfError<"BigInt">> =
 export const formatBooleanError: TypeErrorFormatter<TypeOfError<"Boolean">> =
   formatTypeOfError;
 
+/** 以繁體中文格式化 BooleanFromStringError。 */
+export const formatBooleanFromStringError: TypeErrorFormatter<
+  BooleanFromStringError
+> = (error) =>
+  `值 ${safelyStringifyUnknownValue(error.value)} 不是布林值。請使用 true 或 false。`;
+
 /** 以繁體中文格式化 Symbol TypeOfError。 */
 export const formatSymbolError: TypeErrorFormatter<TypeOfError<"Symbol">> =
   formatTypeOfError;
@@ -171,15 +187,43 @@ export const formatInt64StringError: TypeErrorFormatter<Int64StringError> = (
   error,
 ) => `值 ${safelyStringifyUnknownValue(error.value)} 不是有效的 Int64 字串。`;
 
+/** Formats an IdentifierError in Traditional Chinese. */
+export const formatIdentifierError: TypeErrorFormatter<IdentifierError> = (
+  error,
+) =>
+  `值 ${safelyStringifyUnknownValue(error.value)} 不是 ${error.casing} 識別字。`;
+
 /** 以繁體中文格式化 CapitalizedError。 */
 export const formatCapitalizedError: TypeErrorFormatter<CapitalizedError> = (
   error,
 ) => `值 ${safelyStringifyUnknownValue(error.value)} 必須以大寫字母開頭。`;
 
+/** Formats an UncapitalizedError in Traditional Chinese. */
+export const formatUncapitalizedError: TypeErrorFormatter<
+  UncapitalizedError
+> = (error) =>
+  `值 ${safelyStringifyUnknownValue(error.value)} 不得以大寫字母開頭。`;
+
+/** Formats an UppercasedError in Traditional Chinese. */
+export const formatUppercasedError: TypeErrorFormatter<UppercasedError> = (
+  error,
+) => `值 ${safelyStringifyUnknownValue(error.value)} 必須為大寫。`;
+
+/** Formats a LowercasedError in Traditional Chinese. */
+export const formatLowercasedError: TypeErrorFormatter<LowercasedError> = (
+  error,
+) => `值 ${safelyStringifyUnknownValue(error.value)} 必須為小寫。`;
+
 /** 以繁體中文格式化 TrimmedError。 */
 export const formatTrimmedError: TypeErrorFormatter<TrimmedError> = (error) =>
   `值 ${safelyStringifyUnknownValue(error.value)} 不得有前後空白。`;
 
+/** Formats a StartsWithError in Traditional Chinese. */
+export const formatStartsWithError: TypeErrorFormatter<StartsWithError> = (
+  error,
+) =>
+  `值 ${safelyStringifyUnknownValue(error.value)} 必須以 ${safelyStringifyUnknownValue(error.prefix)} 開頭。`;
+
 /** 以繁體中文格式化 MinLengthError。 */
 export const formatMinLengthError: TypeErrorFormatter<MinLengthError> = (
   error,
@@ -268,6 +312,12 @@ export const formatNegativeDecimalStringError: TypeErrorFormatter<
 export const formatIntError: TypeErrorFormatter<IntError> = (error) =>
   `值 ${safelyStringifyUnknownValue(error.value)} 必須是安全整數。`;
 
+/** 以繁體中文格式化 IntFromStringError。 */
+export const formatIntFromStringError: TypeErrorFormatter<
+  IntFromStringError
+> = (error) =>
+  `值 ${safelyStringifyUnknownValue(error.value)} 不是十進位整數。`;
+
 /** 以繁體中文格式化 GreaterThanError。 */
 export const formatGreaterThanError: TypeErrorFormatter<GreaterThanError> = (
   error,
@@ -495,3 +545,21 @@ export const formatJsonValueError: TypeErrorFormatter<JsonValueError> = (
 /** 以繁體中文格式化 JsonError。 */
 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%" 這樣的值。`;

package/src/local-first/Protocol.test.ts

@@ -12,7 +12,7 @@ import {
   assertThrowsInstanceOf,
   assertTrue,
 } from "../Assert.ts";
-import { createBuffer, encodeNonNegativeInt } from "../Binary.ts";
+import { createBuffer, encodeNonNegativeInt } from "../Bytes.ts";
 import { EncryptionKey } from "../Crypto.ts";
 import { constFalse, constTrue } from "../Function.ts";
 import { SqliteValue } from "../Sqlite.ts";

package/src/local-first/Protocol.ts

@@ -204,7 +204,7 @@ import {
   encodeNonNegativeInt,
   encodeNumber,
   encodeString,
-} from "../Binary.ts";
+} from "../Bytes.ts";
 import type { ConsoleDep } from "../Console.ts";
 import {
   createPadmePadding,

package/src/local-first/Schema.ts

@@ -35,6 +35,7 @@ import {
   object,
   type ObjectType,
   type UnionType,
+  type withDefault,
 } from "../Type.ts";
 import type { CompileTimeError, Simplify } from "../Types.ts";
 import type { AppOwner } from "./Owner.ts";
@@ -65,6 +66,16 @@ export type AnyStandardSchemaV1 = StandardSchemaV1<any, any>;
  * Table schema defines columns that are required for table rows. For optional
  * columns, use a schema whose output type includes `null`.
  *
+ * Prefer applying defaults when reading or displaying data. A nullable column
+ * can preserve the distinction between "not specified" and an explicitly chosen
+ * value. For example, `null` can mean no notification preference, while an
+ * explicit false value means notifications were disabled.
+ *
+ * Use {@link withDefault} only when replacing absence is intentional. Storing
+ * defaulted values can add unnecessary data to database rows and erase that
+ * distinction. Store a value when it represents a user's decision or another
+ * fact your application needs to retain.
+ *
  * ### Example
  *
  * ```ts

package/src/local-first/Storage.ts

@@ -9,7 +9,7 @@ import type { NonEmptyReadonlyArray } from "../Array.ts";
 import { firstInArray, isNonEmptyArray } from "../Array.ts";
 import { assert, assertNonNullable } from "../Assert.ts";
 import type { Brand } from "../Brand.ts";
-import { concatBytes } from "../Binary.ts";
+import { concatBytes } from "../Bytes.ts";
 import { decrement } from "../Number.ts";
 import type { RandomDep } from "../Random.ts";
 import { err, ok } from "../Result.ts";

package/src/local-first/Timestamp.ts

@@ -4,7 +4,7 @@
  * @module
  */
 
-import { bytesToHex, hexToBytes } from "../Binary.ts";
+import { bytesToHex, hexToBytes } from "../Bytes.ts";
 import type { RandomBytesDep } from "../Crypto.ts";
 import { createEqObject, eqNumber, eqString } from "../Eq.ts";
 import { increment } from "../Number.ts";