@amazon/vinyl-util 1.0.0

package/dist/types/current/util/string/string.d.ts

@@ -0,0 +1,130 @@
+import type { Maybe } from '../../util/type';
+import type { ReadonlyRecord } from '../../util/object/readonlyType';
+/**
+ * Substitutes named variable references in a string.
+ *
+ * Example:
+ * ```
+ * substitute('{fruit}, {veg}', { fruit: 'apples', veg: 'carrots' }) // 'apples, carrots'
+ * ```
+ *
+ * @param str The template string.
+ * @param variables A record of variable names to values.
+ * @param pattern A regex whose first capture group is the variable name. Defaults to `{name}`.
+ * @throws IllegalArgumentError if a referenced variable is not defined.
+ */
+export declare function substitute(str: string, variables: Readonly<Record<string, any>>, pattern?: RegExp): string;
+/**
+ * Replaces substitution tokens.
+ *
+ * Each identifier may be suffixed, within the enclosing '$' characters, with an additional format tag for number
+ * padding following the prototype: `%0[width]d`
+ * For example:
+ * 'Segment_$Time%04d$' Where the `Time` property is `42` will have a replacement value of: `Segment_0042`
+ */
+export declare function substituteIdentifiers(str: string, props: ReadonlyRecord<string, string | number>): string;
+/**
+ * Returns true if the character is one of: ' ', '\t', '\n', '\r'
+ *
+ * @param charCode The character code to test
+ */
+export declare function isWhitespaceChar(charCode: number): boolean;
+/**
+ * Predefined general xml entities
+ * https://www.w3.org/TR/2008/REC-xml-20081126/#sec-predefined-ent
+ */
+export declare const predefinedDecodeEntities: ReadonlyMap<string, string>;
+/**
+ * Replaces all specified entities with their mapped representations.
+ * For example (using {@link predefinedDecodeEntities}):
+ * ```
+ * `&lt;Hello to y&apos;all&#33;&gt;` becomes `<Hello to y'all!>`
+ * ```
+ *
+ * @param str
+ * @param namedEntities
+ */
+export declare function decodeEntities(str: string, namedEntities?: ReadonlyMap<string, string>): string;
+/**
+ * Encodes the predefined xml standard entities into their entity names.
+ *
+ * & to &amp;
+ * ' to &apos;
+ * > to &gt;
+ * < to &lt;
+ * " to &quot;
+ *
+ * @param str
+ */
+export declare function encodeEntities(str: string): string;
+/**
+ * Returns true if the two strings are equal, optionally ignoring case.
+ *
+ * @param a
+ * @param b
+ * @param ignoreCase
+ */
+export declare function eqStr(a: string | null, b: string | null, ignoreCase?: boolean): boolean;
+/**
+ * Given a single character string, returns the char code of the first character.
+ *
+ * @param str A single character string from which to get the first code point.
+ */
+export declare function char(str: string): number;
+/**
+ * Returns the substring of string after the last instance of searchString, excluding searchString.
+ * If searchString is not found, the whole string will be returned.
+ *
+ * @param string
+ * @param searchString
+ * @param caseSensitive If true (default) the search will be case-sensitive.
+ */
+export declare function substringAfterLast(string: string, searchString: string, caseSensitive?: boolean): string;
+/**
+ * Returns the substring of string before the first occurrence of searchString, excluding
+ * searchString.
+ * If searchString is not found, the whole string will be returned.
+ *
+ * @param string
+ * @param searchString
+ * @param caseSensitive If true (default) the search will be case-sensitive.
+ */
+export declare function substringBefore(string: string, searchString: string, caseSensitive?: boolean): string;
+/**
+ * Tokenizes a string into lowercase alphanumeric words.
+ *
+ * E.g. `'Amazon Music x86_64'` becomes `['amazon', 'music', 'x86', '64']`
+ *
+ * @param str
+ */
+export declare function tokenizeWords(str: string): string[];
+export declare function toLowerCase<T extends string>(str: T): Lowercase<T>;
+export declare function toUpperCase<T extends string>(str: T): Uppercase<T>;
+/**
+ * If the given string is greater than a max length, truncate the string with an indicator.
+ * Example:
+ * truncate('a very long string', 10) // 'a very ...'
+ *
+ * @param str A nullable string.
+ * @param maxLength
+ * @param indicator The string to indicate there was truncation, default is an ellipses … (U+2026)
+ * @return Returns the truncated string, or the nullish value if str is nullish.
+ */
+export declare function truncate<T extends Maybe<string>>(str: T, maxLength: number, indicator?: string): T | string;
+/**
+ * Converts a string to kebab-case.
+ *
+ * This function transforms camelCase, PascalCase, snake_case, and space-separated
+ * strings into a normalized kebab-case format. It removes non-alphanumeric characters
+ * (excluding hyphens), collapses multiple delimiters, and trims leading/trailing hyphens.
+ *
+ * @example
+ * toKebabCase("HelloWorld")         // "hello-world"
+ * toKebabCase("hello_world test")   // "hello-world-test"
+ * toKebabCase("SomeText123")        // "some-text123"
+ *
+ * @param str - The input string to convert.
+ * @returns The kebab-case version of the input.
+ */
+export declare function toKebabCase(str: string): string;
+//# sourceMappingURL=string.d.ts.map

package/dist/types/current/util/string/string.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string.d.ts","sourceRoot":"","sources":["../../../../../src/util/string/string.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAA;AAchE;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CACtB,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,EACxC,OAAO,GAAE,MAAmC,GAC7C,MAAM,CASR;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACjC,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GAC/C,MAAM,CAYR;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAO1D;AAID;;;GAGG;AACH,eAAO,MAAM,wBAAwB,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAM/D,CAAA;AAEF;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAC1B,GAAG,EAAE,MAAM,EACX,aAAa,GAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAA4B,GACtE,MAAM,CAeR;AAKD;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CASlD;AAED;;;;;;GAMG;AACH,wBAAgB,KAAK,CACjB,CAAC,EAAE,MAAM,GAAG,IAAI,EAChB,CAAC,EAAE,MAAM,GAAG,IAAI,EAChB,UAAU,UAAQ,GACnB,OAAO,CAOT;AAED;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAExC;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAC9B,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,aAAa,UAAO,GACrB,MAAM,CAMR;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC3B,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,aAAa,UAAO,GACrB,MAAM,CAMR;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAQnD;AAED,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAElE;AAED,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAElE;AAED;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,KAAK,CAAC,MAAM,CAAC,EAC5C,GAAG,EAAE,CAAC,EACN,SAAS,EAAE,MAAM,EACjB,SAAS,SAAM,GAChB,CAAC,GAAG,MAAM,CAKZ;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAQ/C"}

package/dist/types/current/util/string/string.js

@@ -0,0 +1,249 @@
+/*
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { IllegalArgumentError } from '../../error/IllegalArgumentError';
+import { flipMap } from '../../util/map/map';
+/**
+ * @private
+ */
+const locale = {
+    variableNotDefined: "Variable '{name}' is not defined",
+};
+/**
+ * The default substitution pattern, matching `{name}`.
+ */
+const DEFAULT_SUBSTITUTE_PATTERN = /\{(\w+)}/g;
+/**
+ * Substitutes named variable references in a string.
+ *
+ * Example:
+ * ```
+ * substitute('{fruit}, {veg}', { fruit: 'apples', veg: 'carrots' }) // 'apples, carrots'
+ * ```
+ *
+ * @param str The template string.
+ * @param variables A record of variable names to values.
+ * @param pattern A regex whose first capture group is the variable name. Defaults to `{name}`.
+ * @throws IllegalArgumentError if a referenced variable is not defined.
+ */
+export function substitute(str, variables, pattern = DEFAULT_SUBSTITUTE_PATTERN) {
+    return str.replace(pattern, (_, name) => {
+        if (!(name in variables)) {
+            throw new IllegalArgumentError(locale.variableNotDefined.replace('{name}', String(name)));
+        }
+        return String(variables[name]);
+    });
+}
+/**
+ * Replaces substitution tokens.
+ *
+ * Each identifier may be suffixed, within the enclosing '$' characters, with an additional format tag for number
+ * padding following the prototype: `%0[width]d`
+ * For example:
+ * 'Segment_$Time%04d$' Where the `Time` property is `42` will have a replacement value of: `Segment_0042`
+ */
+export function substituteIdentifiers(str, props) {
+    return str.replace(/\$(\w*)(?:%0(\d+)d)?\$/g, (_, match, maxLength) => {
+        if (!match)
+            return '$';
+        if (!(match in props)) {
+            throw new IllegalArgumentError(`Template substitution token '${match}' was not understood`);
+        }
+        let prop = String(props[match]);
+        if (maxLength)
+            prop = prop.padStart(maxLength, '0');
+        return prop;
+    });
+}
+/**
+ * Returns true if the character is one of: ' ', '\t', '\n', '\r'
+ *
+ * @param charCode The character code to test
+ */
+export function isWhitespaceChar(charCode) {
+    return (charCode === 0x20 || // ' ' (space)
+        charCode === 0x09 || // '\t' (tab)
+        charCode === 0x0d || // '\r' (carriage return)
+        charCode === 0x0a //    '\n' (line feed)
+    );
+}
+const encodedEntitiesRegex = /&(#(\d+)|\w+);/gi;
+/**
+ * Predefined general xml entities
+ * https://www.w3.org/TR/2008/REC-xml-20081126/#sec-predefined-ent
+ */
+export const predefinedDecodeEntities = new Map([
+    ['apos', "'"],
+    ['amp', '&'],
+    ['lt', '<'],
+    ['gt', '>'],
+    ['quot', '"'],
+]);
+/**
+ * Replaces all specified entities with their mapped representations.
+ * For example (using {@link predefinedDecodeEntities}):
+ * ```
+ * `&lt;Hello to y&apos;all&#33;&gt;` becomes `<Hello to y'all!>`
+ * ```
+ *
+ * @param str
+ * @param namedEntities
+ */
+export function decodeEntities(str, namedEntities = predefinedDecodeEntities) {
+    if (encodedEntitiesRegex.test(str)) {
+        return str.replace(encodedEntitiesRegex, (substring, entityName, codePoint) => {
+            if (codePoint !== undefined)
+                return String.fromCharCode(parseInt(codePoint));
+            const entityValue = namedEntities.get(entityName.toLowerCase());
+            if (!entityValue)
+                return substring;
+            return entityValue;
+        });
+    }
+    else {
+        return str;
+    }
+}
+const standardEntityValueToNames = flipMap(predefinedDecodeEntities);
+const entitiesRegex = /['&<>"]/g;
+/**
+ * Encodes the predefined xml standard entities into their entity names.
+ *
+ * & to &amp;
+ * ' to &apos;
+ * > to &gt;
+ * < to &lt;
+ * " to &quot;
+ *
+ * @param str
+ */
+export function encodeEntities(str) {
+    if (entitiesRegex.test(str)) {
+        return str.replace(entitiesRegex, (entityValue) => {
+            const entityName = standardEntityValueToNames.get(entityValue);
+            return `&${entityName};`;
+        });
+    }
+    else {
+        return str;
+    }
+}
+/**
+ * Returns true if the two strings are equal, optionally ignoring case.
+ *
+ * @param a
+ * @param b
+ * @param ignoreCase
+ */
+export function eqStr(a, b, ignoreCase = false) {
+    if (a == null && b == null)
+        return true;
+    if (a == null || b == null)
+        return false;
+    if (a === b)
+        return true;
+    if (ignoreCase)
+        return a.length === b.length && a.toLowerCase() === b.toLowerCase();
+    return false;
+}
+/**
+ * Given a single character string, returns the char code of the first character.
+ *
+ * @param str A single character string from which to get the first code point.
+ */
+export function char(str) {
+    return str.charCodeAt(0);
+}
+/**
+ * Returns the substring of string after the last instance of searchString, excluding searchString.
+ * If searchString is not found, the whole string will be returned.
+ *
+ * @param string
+ * @param searchString
+ * @param caseSensitive If true (default) the search will be case-sensitive.
+ */
+export function substringAfterLast(string, searchString, caseSensitive = true) {
+    const i = (caseSensitive ? string : string.toLowerCase()).lastIndexOf(caseSensitive ? searchString : searchString.toLowerCase());
+    if (i === -1)
+        return string;
+    return string.substring(i + searchString.length);
+}
+/**
+ * Returns the substring of string before the first occurrence of searchString, excluding
+ * searchString.
+ * If searchString is not found, the whole string will be returned.
+ *
+ * @param string
+ * @param searchString
+ * @param caseSensitive If true (default) the search will be case-sensitive.
+ */
+export function substringBefore(string, searchString, caseSensitive = true) {
+    const i = (caseSensitive ? string : string.toLowerCase()).indexOf(caseSensitive ? searchString : searchString.toLowerCase());
+    if (i === -1)
+        return string;
+    return string.substring(0, i);
+}
+/**
+ * Tokenizes a string into lowercase alphanumeric words.
+ *
+ * E.g. `'Amazon Music x86_64'` becomes `['amazon', 'music', 'x86', '64']`
+ *
+ * @param str
+ */
+export function tokenizeWords(str) {
+    const words = [];
+    const regex = /[a-z\d]+/gi;
+    let match;
+    while ((match = regex.exec(str))) {
+        words.push(match[0].toLowerCase());
+    }
+    return words;
+}
+export function toLowerCase(str) {
+    return str.toLowerCase();
+}
+export function toUpperCase(str) {
+    return str.toUpperCase();
+}
+/**
+ * If the given string is greater than a max length, truncate the string with an indicator.
+ * Example:
+ * truncate('a very long string', 10) // 'a very ...'
+ *
+ * @param str A nullable string.
+ * @param maxLength
+ * @param indicator The string to indicate there was truncation, default is an ellipses … (U+2026)
+ * @return Returns the truncated string, or the nullish value if str is nullish.
+ */
+export function truncate(str, maxLength, indicator = '…') {
+    if (str == null)
+        return str;
+    if (str.length > maxLength)
+        return str.substring(0, maxLength - indicator.length) + indicator;
+    return str;
+}
+/**
+ * Converts a string to kebab-case.
+ *
+ * This function transforms camelCase, PascalCase, snake_case, and space-separated
+ * strings into a normalized kebab-case format. It removes non-alphanumeric characters
+ * (excluding hyphens), collapses multiple delimiters, and trims leading/trailing hyphens.
+ *
+ * @example
+ * toKebabCase("HelloWorld")         // "hello-world"
+ * toKebabCase("hello_world test")   // "hello-world-test"
+ * toKebabCase("SomeText123")        // "some-text123"
+ *
+ * @param str - The input string to convert.
+ * @returns The kebab-case version of the input.
+ */
+export function toKebabCase(str) {
+    return str
+        .replace(/([a-z0-9])([A-Z])/g, '$1-$2')
+        .replace(/[\s_]+/g, '-')
+        .replace(/[^a-zA-Z0-9-]/g, '')
+        .replace(/-+/g, '-')
+        .replace(/^-|-$/g, '')
+        .toLowerCase();
+}

package/dist/types/current/util/string/uid.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Returns a short unique id.
+ * Optimized for performance. (2.1M ops/s ± 0.71%)
+ * The returned value is 7-22 A-Za-z0-9 characters.
+ *
+ * The uniqueness of the returned string is the current timestamp to ms precision plus 2^53-1
+ * possible values.
+ *
+ * The odds of a collision where n is the number of UIDs created within the same millisecond:
+ * 1-((2^53-2)/(2^53-1))^C(n, 2)
+ *
+ * For 1000 UIDs created within the same millisecond the odds of a collision are:
+ * 00.0000000055%, or 1 in 550 billion.
+ */
+export declare function createShortUid(): string;
+/**
+ * @deprecated use createShortUid
+ */
+export declare const createUid: typeof createShortUid;
+//# sourceMappingURL=uid.d.ts.map

package/dist/types/current/util/string/uid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uid.d.ts","sourceRoot":"","sources":["../../../../../src/util/string/uid.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAGvC;AAED;;GAEG;AACH,eAAO,MAAM,SAAS,uBAAiB,CAAA"}

package/dist/types/current/util/string/uid.js

@@ -0,0 +1,26 @@
+/*
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Returns a short unique id.
+ * Optimized for performance. (2.1M ops/s ± 0.71%)
+ * The returned value is 7-22 A-Za-z0-9 characters.
+ *
+ * The uniqueness of the returned string is the current timestamp to ms precision plus 2^53-1
+ * possible values.
+ *
+ * The odds of a collision where n is the number of UIDs created within the same millisecond:
+ * 1-((2^53-2)/(2^53-1))^C(n, 2)
+ *
+ * For 1000 UIDs created within the same millisecond the odds of a collision are:
+ * 00.0000000055%, or 1 in 550 billion.
+ */
+export function createShortUid() {
+    // Date.now 7-8 chars, Math.random: 0-13
+    return Date.now().toString(36) + Math.random().toString(36).substring(2);
+}
+/**
+ * @deprecated use createShortUid
+ */
+export const createUid = createShortUid;

package/dist/types/current/util/type.d.ts

@@ -0,0 +1,166 @@
+/**
+ * Distributes the value types of an array into a union.
+ */
+export type Flatten<T> = T extends readonly any[] ? T[number] : T;
+/**
+ * Property keys of an object that do not map to functions.
+ */
+export type NonFunctionPropertyNames<T> = {
+    [K in keyof T]: T[K] extends (...args: any) => any ? never : K;
+}[keyof T];
+/**
+ * All primitive types.
+ */
+export type Primitive = bigint | boolean | number | string | symbol | null | undefined;
+/**
+ * An empty object, safer than using `object` type.
+ */
+export type AnyRecord = Record<never, any>;
+/**
+ * never, with a message to help explain the problem.
+ * https://github.com/microsoft/TypeScript/issues/33098
+ */
+export type Never<Message extends string> = [never, Message];
+/**
+ * A type representing any type of function.
+ */
+export type Fun = (...args: any[]) => any;
+/**
+ * Enforces that the type represents data that can be serialized via JSON.stringify.
+ */
+export type JsonCompatible<T> = unknown extends T ? never : T extends bigint | symbol | Fun ? never : T extends boolean | number | string | null | undefined | {
+    toJSON(): any;
+} ? T : T extends readonly any[] ? readonly JsonCompatible<T[number]>[] : {
+    [P in keyof T]: JsonCompatible<T[P]>;
+};
+/**
+ * A compile-time check that the given value/array/object is serializable via JSON.stringify.
+ *
+ * A value is serializable if any of these are true:
+ * - It is an object with a toJSON() function
+ * - It is an object with only serializable members.
+ * - It is an array with only serializable elements.
+ * - It is type boolean, string, number, null, or undefined.
+ */
+export declare function jsonCompatible<T>(value: JsonCompatible<T>): T;
+/**
+ * An object whose properties are all optional, and all sub-properties are optional.
+ * Note: does not convert array or tuple elements to Partial.
+ */
+export type PartialDeep<T> = T extends Fun | Primitive ? T : T extends object ? {
+    [P in keyof T]?: PartialDeep<T[P]>;
+} : T;
+/**
+ * Defines specific properties of T that are not required.
+ */
+export type PickPartial<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>;
+/**
+ * Possible values `typeof` operator may return.
+ */
+export type Typeof = 'bigint' | 'boolean' | 'function' | 'number' | 'object' | 'string' | 'symbol' | 'undefined';
+/**
+ * Given a possible result from `typeof`, provides the type to the matched value.
+ */
+export type FromTypeof<T extends Typeof> = T extends 'bigint' ? bigint : T extends 'boolean' ? boolean : T extends 'function' ? Fun : T extends 'number' ? number : T extends 'object' ? object | null : T extends 'string' ? string : T extends 'symbol' ? symbol : T extends 'undefined' ? undefined : any;
+/**
+ * Extracts values from T which extends type U.
+ */
+export type ExtractValues<T, U> = Pick<T, {
+    [P in keyof T]: T[P] extends U ? P : never;
+}[keyof T]>;
+/**
+ * Excludes values from T which extends type U.
+ */
+export type ExcludeValues<T, U> = Pick<T, {
+    [P in keyof T]: T[P] extends U ? never : P;
+}[keyof T]>;
+export type Maybe<T> = T | undefined | null;
+/**
+ * Infers the element type from an Array type.
+ */
+export type ElementType<T extends readonly any[]> = T extends ReadonlyArray<infer E> ? E : never;
+/**
+ * Infers the element type from a Set type.
+ */
+export type SetElementType<T extends ReadonlySet<any>> = T extends ReadonlySet<infer E> ? E : never;
+/**
+ * Enforces type T to be in an invariant position.
+ * For example `Invariant<Square>` cannot be assigned to type `Invariant<Polygon>` or vice versa.
+ *
+ * This should be used when an interface with type parameter T needs strict invariance in addition to what the
+ * compiler can infer from use.
+ *
+ * {@link https://en.wikipedia.org/wiki/Covariance_and_contravariance_(computer_science)}
+ */
+export type Invariant<T> = T & Required<T> & ((input: T & Required<T>) => T & Required<T>);
+export declare function invariant<T>(): Invariant<T>;
+/**
+ * Enforces type T to be in a covariant position.
+ * For example `Invariant<Square>` can be assigned to type `Invariant<Polygon>` but not vice versa.
+ *
+ * This should be used when an interface with type parameter T does not explicitly use T in an
+ * output position, but the interface implies `out T`.
+ */
+export type Covariant<T> = () => T;
+export declare function covariant<T>(): Covariant<T>;
+/**
+ * Enforces type T to be in a covariant position.
+ * For example `Invariant<Polygon>` can be assigned to type `Invariant<Square>` but not vice versa.
+ *
+ * This should be used when an interface with type parameter T does not explicitly use T in an
+ * input position, but the interface implies `in T`.
+ */
+export type Contravariant<T> = (input: T) => void;
+export declare function contravariant<T>(): Contravariant<T>;
+/**
+ * A type which may either be a direct instance of T or a promise that resolves to T.
+ */
+export type MaybePromise<T> = PromiseLike<T> | T;
+/**
+ * Deeply excludes all keys from T extending K.
+ */
+export type OmitDeep<T, K extends keyof any> = Omit<{
+    [P in keyof T]: T[P] extends Primitive ? T[P] : OmitDeep<T[P], K>;
+}, K>;
+/**
+ * Make properties of T extending K optional.
+ */
+export type Optional<T, K extends keyof T> = Partial<Pick<T, K>> & Omit<T, K>;
+/**
+ * Make properties of T extending K optional, recursively.
+ */
+export type OptionalDeep<T, K extends keyof any> = Optional<{
+    [P in keyof T]: T[P] extends Primitive ? T[P] : OptionalDeep<T[P], K>;
+}, K & keyof T>;
+/**
+ * true if T extends never, otherwise false
+ */
+export type IsNever<T> = [T] extends [never] ? true : false;
+/**
+ * true if T extends any, otherwise false
+ */
+export type IsAny<T> = 0 extends 1 & T ? true : false;
+/**
+ * Determines whether a property `P` of object type `U` is declared as optional.
+ *
+ * This checks whether the `{}` type (an empty object) is assignable to
+ * `Pick<U, P>`. In TypeScript, this is true only when `P` is marked optional
+ * using the `?` modifier in the type definition.
+ *
+ * Importantly, this detects *actual optionality* rather than checking whether
+ * the property's type includes `undefined`. For example:
+ *
+ * ```ts
+ * type A = { x?: string };               // optional
+ * type B = { x: string | undefined };    // required but allows undefined
+ *
+ * IsPropertyOptional<A, "x"> // true
+ * IsPropertyOptional<B, "x"> // false
+ * ```
+ *
+ * @template U - The object type containing the property.
+ * @template P - The key of the property to test.
+ * @returns `true` if `P` is an optional property, otherwise `false`.
+ */
+export type IsPropertyOptional<U, P extends keyof U> = AnyRecord extends Pick<U, P> ? true : false;
+//# sourceMappingURL=type.d.ts.map

package/dist/types/current/util/type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type.d.ts","sourceRoot":"","sources":["../../../../src/util/type.ts"],"names":[],"mappings":"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"}

package/dist/types/current/util/type.js

@@ -0,0 +1,25 @@
+/*
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * A compile-time check that the given value/array/object is serializable via JSON.stringify.
+ *
+ * A value is serializable if any of these are true:
+ * - It is an object with a toJSON() function
+ * - It is an object with only serializable members.
+ * - It is an array with only serializable elements.
+ * - It is type boolean, string, number, null, or undefined.
+ */
+export function jsonCompatible(value) {
+    return value;
+}
+export function invariant() {
+    return undefined;
+}
+export function covariant() {
+    return undefined;
+}
+export function contravariant() {
+    return undefined;
+}

package/dist/types/current/util/url/resolveUrl.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Resolves a relative URI against a base URL using string manipulation,
+ * avoiding the overhead of constructing `URL` objects.
+ *
+ * Handles the same cases as `new URL(relative, base)`:
+ * - Absolute URIs (with scheme) are returned as-is.
+ * - Protocol-relative URIs (`//host/path`) inherit the base scheme.
+ * - Absolute paths (`/path`) replace the base path.
+ * - Relative paths are resolved against the base directory.
+ *
+ * @param relative The relative (or absolute) URI to resolve.
+ * @param base The base URL string to resolve against.
+ * @returns A resolved absolute URL string.
+ */
+export declare function resolveUrl(relative: string, base: string): string;
+/**
+ * Extracts the hostname from an absolute URL string.
+ *
+ * @param url An absolute URL string (e.g. `https://example.com:8080/path`).
+ * @returns The hostname (e.g. `example.com`).
+ */
+export declare function getHostname(url: string): string;
+//# sourceMappingURL=resolveUrl.d.ts.map

package/dist/types/current/util/url/resolveUrl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveUrl.d.ts","sourceRoot":"","sources":["../../../../../src/util/url/resolveUrl.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;GAaG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CA0BjE;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAO/C"}