@xaui/native 0.9.1-alpha.93 → 0.9.1-beta.95

package/dist/utils/time-mask.d.cts

@@ -1,68 +0,0 @@
-/** How far down a time is written. Hours and minutes, or seconds as well. */
-export type TimeGranularity = 'minute' | 'second';
-/** Twenty-four hours, or twelve and a period beside them. */
-export type HourCycle = 12 | 24;
-/** Which half of a twelve-hour day. */
-export type DayPeriod = 'am' | 'pm';
-/** The parts of a time, in the units a clock names them. */
-export type TimeParts = {
-    hours: number;
-    minutes: number;
-    seconds: number;
-};
-/**
- * Whether that locale writes twelve hours or twenty-four.
- *
- * Out of `Intl`, for the reason `dateOrderFor` gives: the platform ships the answer and a
- * table here would be a second one, shorter and out of date. `hour12` is what
- * `resolvedOptions` calls it, and it is absent on a locale with no hour in its default
- * format — twenty-four is the fallback, being what most of the world writes.
- */
-export declare function hourCycleFor(locale: string): HourCycle;
-/** How many characters a finished time is, so a field can stop the caret at the end. */
-export declare function timeLength(granularity: TimeGranularity): number;
-/** What a placeholder calls each part. The letters are a language's, so they are given. */
-export type TimeLabels = {
-    hours: string;
-    minutes: string;
-    seconds: string;
-};
-/** The shape a reader is being asked for — `HH:mm`, `hh:mm:ss`. */
-export declare function timePlaceholder(granularity: TimeGranularity, labels: TimeLabels): string;
-/**
- * What the reader typed, as a time is written.
- *
- * Digits only, and the colons are **put back** rather than kept — the `maskDate` argument,
- * for the same four reasons: a paste, a keyboard with its own punctuation, a backspace over
- * a separator, and a caret dropped into the middle.
- *
- * **The period is not typed.** A twelve-hour field caps its hours at 12 and takes AM or PM
- * from `TimeField.Period` beside it. The legacy field asked for the letters to be typed into
- * a number pad, which is a keyboard that cannot produce them.
- *
- * Each part is clamped as it completes and never raised, exactly as a date's is: `9` on its
- * way to `09` is left alone, `75` minutes becomes `59`, and `00` stays `00`.
- */
-export declare function maskTime(input: string, granularity: TimeGranularity, hourCycle?: HourCycle): string;
-/**
- * The time those digits are, or `null` while they are not one yet.
- *
- * On a twelve-hour clock the `period` is what says which half of the day it is, so a time
- * with no period given is read as the morning — twelve o'clock included, which is why the
- * arithmetic below is a remainder rather than a subtraction: 12 AM is midnight and 12 PM is
- * noon, and the naive `hours + 12` gets exactly those two wrong.
- */
-export declare function parseTime(text: string, granularity: TimeGranularity, hourCycle?: HourCycle, period?: DayPeriod): TimeParts | null;
-/** A date's time as this cycle writes it — the inverse of `parseTime`. */
-export declare function formatTime(date: Date, granularity: TimeGranularity, hourCycle?: HourCycle): string;
-/** Which half of the day that date falls in, for a field that shows a period. */
-export declare function periodOf(date: Date): DayPeriod;
-/**
- * Those parts, on that day.
- *
- * A time on its own is still a `Date` in this library — the same type the `DateField`
- * reports and the one a `DateTimeField` composes from both halves. The day it lands on is
- * given rather than assumed, so a caller merging a time into a date they already hold gets
- * that date back and not today's.
- */
-export declare function withTime(day: Date, parts: TimeParts): Date;

package/dist/utils/time-mask.d.ts

@@ -1,68 +0,0 @@
-/** How far down a time is written. Hours and minutes, or seconds as well. */
-export type TimeGranularity = 'minute' | 'second';
-/** Twenty-four hours, or twelve and a period beside them. */
-export type HourCycle = 12 | 24;
-/** Which half of a twelve-hour day. */
-export type DayPeriod = 'am' | 'pm';
-/** The parts of a time, in the units a clock names them. */
-export type TimeParts = {
-    hours: number;
-    minutes: number;
-    seconds: number;
-};
-/**
- * Whether that locale writes twelve hours or twenty-four.
- *
- * Out of `Intl`, for the reason `dateOrderFor` gives: the platform ships the answer and a
- * table here would be a second one, shorter and out of date. `hour12` is what
- * `resolvedOptions` calls it, and it is absent on a locale with no hour in its default
- * format — twenty-four is the fallback, being what most of the world writes.
- */
-export declare function hourCycleFor(locale: string): HourCycle;
-/** How many characters a finished time is, so a field can stop the caret at the end. */
-export declare function timeLength(granularity: TimeGranularity): number;
-/** What a placeholder calls each part. The letters are a language's, so they are given. */
-export type TimeLabels = {
-    hours: string;
-    minutes: string;
-    seconds: string;
-};
-/** The shape a reader is being asked for — `HH:mm`, `hh:mm:ss`. */
-export declare function timePlaceholder(granularity: TimeGranularity, labels: TimeLabels): string;
-/**
- * What the reader typed, as a time is written.
- *
- * Digits only, and the colons are **put back** rather than kept — the `maskDate` argument,
- * for the same four reasons: a paste, a keyboard with its own punctuation, a backspace over
- * a separator, and a caret dropped into the middle.
- *
- * **The period is not typed.** A twelve-hour field caps its hours at 12 and takes AM or PM
- * from `TimeField.Period` beside it. The legacy field asked for the letters to be typed into
- * a number pad, which is a keyboard that cannot produce them.
- *
- * Each part is clamped as it completes and never raised, exactly as a date's is: `9` on its
- * way to `09` is left alone, `75` minutes becomes `59`, and `00` stays `00`.
- */
-export declare function maskTime(input: string, granularity: TimeGranularity, hourCycle?: HourCycle): string;
-/**
- * The time those digits are, or `null` while they are not one yet.
- *
- * On a twelve-hour clock the `period` is what says which half of the day it is, so a time
- * with no period given is read as the morning — twelve o'clock included, which is why the
- * arithmetic below is a remainder rather than a subtraction: 12 AM is midnight and 12 PM is
- * noon, and the naive `hours + 12` gets exactly those two wrong.
- */
-export declare function parseTime(text: string, granularity: TimeGranularity, hourCycle?: HourCycle, period?: DayPeriod): TimeParts | null;
-/** A date's time as this cycle writes it — the inverse of `parseTime`. */
-export declare function formatTime(date: Date, granularity: TimeGranularity, hourCycle?: HourCycle): string;
-/** Which half of the day that date falls in, for a field that shows a period. */
-export declare function periodOf(date: Date): DayPeriod;
-/**
- * Those parts, on that day.
- *
- * A time on its own is still a `Date` in this library — the same type the `DateField`
- * reports and the one a `DateTimeField` composes from both halves. The day it lands on is
- * given rather than assumed, so a caller merging a time into a date they already hold gets
- * that date back and not today's.
- */
-export declare function withTime(day: Date, parts: TimeParts): Date;