@orieljs/support 0.1.0-alpha.5 → 0.1.0-alpha.6

package/NOTICE

@@ -7,3 +7,6 @@ This product includes software developed by the Oriel project
 Oriel is licensed under the Apache License, Version 2.0 (see LICENSE).
 The Oriel name and logo are not covered by that license; see TRADEMARKS.md
 (https://github.com/orieljs/framework/blob/main/TRADEMARKS.md).
+
+@orieljs/support (and @orieljs/framework, which bundles it) includes transliteration data from
+voku/portable-ascii (https://github.com/voku/portable-ascii), Copyright (C) 2019 Lars Moelleken, MIT License.

package/dist/index.d.ts

@@ -1,7 +1,72 @@
-import { ServiceProvider as ServiceProvider$1, Application, Abstract, ClassRegistry as ClassRegistry$1, Class, ConfigRepository } from '@orieljs/contracts';
+import { Collection } from '@orieljs/collections';
 export { collect } from '@orieljs/collections';
+import { ServiceProvider as ServiceProvider$1, Application, Abstract, ClassRegistry as ClassRegistry$1, Class, ConfigRepository } from '@orieljs/contracts';
+
+/**
+ * Laravel's Stringable: a string with Str's helpers as chainable methods, each returning a new Stringable.
+ * `Str.of(' Café ').trim().slug().toString()` is 'cafe'; `request().string('q')` returns one. It prints as its string.
+ */
+declare class Stringable {
+    #private;
+    constructor(value?: string);
+    after(search: string): Stringable;
+    afterLast(search: string): Stringable;
+    append(...values: string[]): Stringable;
+    ascii(): Stringable;
+    before(search: string): Stringable;
+    beforeLast(search: string): Stringable;
+    between(from: string, to: string): Stringable;
+    camel(): Stringable;
+    contains(needles: string | string[]): boolean;
+    endsWith(needles: string | string[]): boolean;
+    /** The same string as `value` (a string or another Stringable). */
+    exactly(value: string | Stringable): boolean;
+    /** The parts between the delimiters, as a Collection (PHP's explode()). */
+    explode(delimiter: string): Collection<string>;
+    finish(cap: string): Stringable;
+    /** Wildcard match, as Str.is(): `*` matches anything. */
+    is(pattern: string): boolean;
+    isEmpty(): boolean;
+    isNotEmpty(): boolean;
+    kebab(): Stringable;
+    lcfirst(): Stringable;
+    /** The number of characters (code points, as PHP's mb_strlen()). */
+    length(): number;
+    limit(limit?: number, end?: string): Stringable;
+    lower(): Stringable;
+    /** Strips whitespace and invisible characters from the start, or the characters given. */
+    ltrim(characters?: string): Stringable;
+    plural(count?: number): Stringable;
+    prepend(...values: string[]): Stringable;
+    /** Replaces every occurrence of the search string (or of each of several) with `replace`. */
+    replace(search: string | string[], replace: string): Stringable;
+    /** Strips whitespace and invisible characters from the end, or the characters given. */
+    rtrim(characters?: string): Stringable;
+    singular(): Stringable;
+    slug(separator?: string): Stringable;
+    snake(delimiter?: string): Stringable;
+    start(prefix: string): Stringable;
+    startsWith(needles: string | string[]): boolean;
+    studly(): Stringable;
+    title(): Stringable;
+    /** PHP's filter_var(FILTER_VALIDATE_BOOLEAN): '1', 'true', 'on' and 'yes' (any case, trimmed) are true. */
+    toBoolean(): boolean;
+    /** PHP's floatval(): the leading number, else 0. */
+    toFloat(): number;
+    /** PHP's intval(): the leading digits, else 0. */
+    toInteger(): number;
+    toJSON(): string;
+    toString(): string;
+    /** Strips whitespace and invisible characters from both ends (Laravel's Str::trim()), or the characters given. */
+    trim(characters?: string): Stringable;
+    ucfirst(): Stringable;
+    upper(): Stringable;
+    value(): string;
+}
 
 declare const Str: {
+    /** Laravel's Str::of(): the value as a Stringable, for chaining: Str.of(title).trim().slug(). */
+    of: (value?: unknown) => Stringable;
     ucfirst: (v: string) => string;
     lcfirst: (v: string) => string;
     studly: (v: string) => string;
@@ -9,11 +74,31 @@ declare const Str: {
     snake: (v: string, delimiter?: string) => string;
     kebab: (v: string) => string;
     title: (v: string) => string;
-    slug: (v: string, separator?: string) => string;
+    /** Laravel's Str::ascii(): the value in plain ASCII ('Café' → 'Cafe', 'Ελληνικά' → 'Ellinika'), as for English. */
+    ascii: (v: string) => string;
+    /**
+     * Laravel's Str::slug(): transliterated to ASCII first (unless `language` is null), '@' read as 'at', then lower-cased
+     * letters and digits joined by the separator: 'Café crème' → 'cafe-creme'. What has no ASCII form is dropped.
+     */
+    slug: (title: string, separator?: string, language?: "en" | null, dictionary?: Readonly<Record<string, string>>) => string;
     plural: (v: string, count?: number) => string;
     singular: (v: string) => string;
     random: (length?: number) => string;
     uuid: () => `${string}-${string}-${string}-${string}-${string}`;
+    /**
+     * A version 7 UUID (RFC 9562): the time in milliseconds first, so ids from later milliseconds sort after earlier ones
+     * (within one millisecond the order is random). Throws a TypeError for a time before 1970, after 10889 or invalid.
+     */
+    uuid7: (time?: Date) => string;
+    /**
+     * A ULID: 26 upper-case Crockford characters, ten for the time in milliseconds and sixteen random, so ids from later
+     * milliseconds sort after earlier ones. Throws a TypeError for a time before 1970, after 10889 or invalid.
+     */
+    ulid: (time?: Date) => string;
+    /** Laravel's Str::isUuid(): five groups of hex digits, any version. */
+    isUuid: (value: unknown) => value is string;
+    /** Laravel's Str::isUlid(): 26 Crockford characters in either case, the first at most 7. */
+    isUlid: (value: unknown) => value is string;
     /** Wildcard match: `*` matches anything; everything else is literal. */
     is: (pattern: string, value: string) => boolean;
     startsWith: (v: string, needles: string | string[]) => boolean;
@@ -149,4 +234,4 @@ declare namespace fileType {
   export { fileType_AVIF as AVIF, fileType_BINARY_AND_MARKUP_TYPES as BINARY_AND_MARKUP_TYPES, fileType_BMP as BMP, type fileType_DetectedType as DetectedType, fileType_EMPTY as EMPTY, fileType_GIF as GIF, fileType_HTML as HTML, fileType_JPEG as JPEG, fileType_PDF as PDF, fileType_PNG as PNG, fileType_RASTER_IMAGES as RASTER_IMAGES, fileType_SNIFF_BYTES as SNIFF_BYTES, fileType_SVG as SVG, fileType_TEXT as TEXT, fileType_UNKNOWN as UNKNOWN, fileType_WEBP as WEBP, fileType_XML as XML, fileType_detectFileType as detectFileType };
 }
 
-export { Arr, ClassRegistry, type Facade, type FacadeStatics, fileType as FileType, ServiceProvider, Str, __, app, config, facade, now, retry, tap, value };
+export { Arr, ClassRegistry, type Facade, type FacadeStatics, fileType as FileType, ServiceProvider, Str, Stringable, __, app, config, facade, now, retry, tap, value };