inferred-types 0.18.0 → 0.18.4

package/src/Mutation/index.ts

@@ -1,39 +1,37 @@
 // #autoindex
 
 // #region autoindexed files
+// index last changed at: 1st Jan, 2022, 03:27 PM ( GMT-8 )
+// hash-code: f6badae2
 
-// index last changed at: 5th May, 2021, 05:45 PM ( GMT-7 )
-// export: named; exclusions: index, private.
-// files: MutationFunction, MutationIdentity.
-
-// local file exports
+// file exports
 export * from "./MutationFunction";
 export * from "./MutationIdentity";
 
-// Note:
-// -----
-// This file was created by running: "dd devops autoindex"; it assumes you have
-// the 'do-devops' pkg installed as a dev dep.
+// #endregion
+
+// This file was created by running: "dd autoindex"; it assumes you have
+// the 'do-devops' pkg (that's "dd" on npm) installed as a dev dep.
 //
 // By default it assumes that exports are named exports but this can be changed by
 // adding a modifier to the '// #autoindex' syntax:
 //
 //    - autoindex:named     same as default, exports "named symbols"
-//    - autoindex:default   assumes each file is exporting a default export
-//                          and converts the default export to the name of the
-//                          file
+//    - autoindex:default   assumes each file is exporting a default export and
+//                          converts the default export to the name of the file
 //    - autoindex:offset    assumes files export "named symbols" but that each
 //                          file's symbols should be offset by the file's name
-//                          (useful for files which might symbols which collide
-//                          or where the namespacing helps consumers)
 //
 // You may also exclude certain files or directories by adding it to the
 // autoindex command. As an example:
 //
 //    - autoindex:named, exclude: foo,bar,baz
 //
-// Also be aware that all of your content outside the defined region in this file
-// will be preserved in situations where you need to do something paricularly awesome.
+// Inversely, if you state a file to be an "orphan" then autoindex files
+// below this file will not reference this autoindex file:
+//
+//    - autoindex:named, orphan
+// 
+// All content outside the "// #region" section in this file will be
+// preserved in situations where you need to do something paricularly awesome.
 // Keep on being awesome.
-
-// #endregion

package/src/index.ts

@@ -1,43 +1,39 @@
 // #autoindex
 
 // #region autoindexed files
-
-// index last changed at: 6th Jun, 2021, 01:46 PM ( GMT-7 )
-// export: named; exclusions: index, private.
-// directories: Mutation, errors, types, utility.
+// index last changed at: 1st Jan, 2022, 03:27 PM ( GMT-8 )
+// hash-code: 3f75741a
 
 // directory exports
 export * from "./Mutation/index";
-export * from "./errors/index";
+export * from "./shared/index";
 export * from "./types/index";
 export * from "./utility/index";
 
-// there were directories orphaned: shared
+// #endregion
 
-// Note:
-// -----
-// This file was created by running: "dd devops autoindex"; it assumes you have
-// the 'do-devops' pkg installed as a dev dep.
+// This file was created by running: "dd autoindex"; it assumes you have
+// the 'do-devops' pkg (that's "dd" on npm) installed as a dev dep.
 //
 // By default it assumes that exports are named exports but this can be changed by
 // adding a modifier to the '// #autoindex' syntax:
 //
 //    - autoindex:named     same as default, exports "named symbols"
-//    - autoindex:default   assumes each file is exporting a default export
-//                          and converts the default export to the name of the
-//                          file
+//    - autoindex:default   assumes each file is exporting a default export and
+//                          converts the default export to the name of the file
 //    - autoindex:offset    assumes files export "named symbols" but that each
 //                          file's symbols should be offset by the file's name
-//                          (useful for files which might symbols which collide
-//                          or where the namespacing helps consumers)
 //
 // You may also exclude certain files or directories by adding it to the
 // autoindex command. As an example:
 //
 //    - autoindex:named, exclude: foo,bar,baz
 //
-// Also be aware that all of your content outside the defined region in this file
-// will be preserved in situations where you need to do something paricularly awesome.
+// Inversely, if you state a file to be an "orphan" then autoindex files
+// below this file will not reference this autoindex file:
+//
+//    - autoindex:named, orphan
+// 
+// All content outside the "// #region" section in this file will be
+// preserved in situations where you need to do something paricularly awesome.
 // Keep on being awesome.
-
-// #endregion

package/src/shared/index.ts

@@ -1,40 +1,38 @@
 // #autoindex: orphan
 
 // #region autoindexed files
+// index last changed at: 1st Jan, 2022, 03:27 PM ( GMT-8 )
+// hash-code: 58ead14b
 
-// index last changed at: 6th Jun, 2021, 06:35 PM ( GMT-7 )
-// export: named; exclusions: index, private.
-// files: randomString, uuid, valueTypes.
-
-// local file exports
+// file exports
 export * from "./randomString";
 export * from "./uuid";
 export * from "./valueTypes";
 
-// Note:
-// -----
-// This file was created by running: "dd devops autoindex"; it assumes you have
-// the 'do-devops' pkg installed as a dev dep.
+// #endregion
+
+// This file was created by running: "dd autoindex"; it assumes you have
+// the 'do-devops' pkg (that's "dd" on npm) installed as a dev dep.
 //
 // By default it assumes that exports are named exports but this can be changed by
 // adding a modifier to the '// #autoindex' syntax:
 //
 //    - autoindex:named     same as default, exports "named symbols"
-//    - autoindex:default   assumes each file is exporting a default export
-//                          and converts the default export to the name of the
-//                          file
+//    - autoindex:default   assumes each file is exporting a default export and
+//                          converts the default export to the name of the file
 //    - autoindex:offset    assumes files export "named symbols" but that each
 //                          file's symbols should be offset by the file's name
-//                          (useful for files which might symbols which collide
-//                          or where the namespacing helps consumers)
 //
 // You may also exclude certain files or directories by adding it to the
 // autoindex command. As an example:
 //
 //    - autoindex:named, exclude: foo,bar,baz
 //
-// Also be aware that all of your content outside the defined region in this file
-// will be preserved in situations where you need to do something paricularly awesome.
+// Inversely, if you state a file to be an "orphan" then autoindex files
+// below this file will not reference this autoindex file:
+//
+//    - autoindex:named, orphan
+// 
+// All content outside the "// #region" section in this file will be
+// preserved in situations where you need to do something paricularly awesome.
 // Keep on being awesome.
-
-// #endregion

package/src/types/Where.ts

@@ -1,8 +1,7 @@
-import { Include } from "native-dash";
-
+import { Include } from "./Include";
 /**
  * Allows filtering down `T` to those which extend a given type `U`.
- * 
+ *
  * - `T` is either a dictionary (where keys will be used to compare) or
  * a readonly sting array.
  * ```ts
@@ -11,16 +10,18 @@ import { Include } from "native-dash";
  * type BA = Where<typeof arr, `ba${string}`>;
  * ```
  */
- export type Where<T extends Record<string, any> | readonly string[], U> = T extends readonly string[]
- ? Include<T[number], U>
- : {
-  [K in keyof T]: K extends U ? K : never;
-}[keyof T];
-
+export type Where<
+  T extends Record<string, any> | readonly string[],
+  U
+> = T extends readonly string[]
+  ? Include<T[number], U>
+  : {
+      [K in keyof T]: K extends U ? K : never;
+    }[keyof T];
 
 /**
  * Allows filtering down `T` to those which extend a given type `U`.
- * 
+ *
  * - `T` is either a dictionary (where keys will be used to compare) or
  * a readonly sting array.
  * ```ts
@@ -29,8 +30,11 @@ import { Include } from "native-dash";
  * type F = WhereNot<typeof arr, `ba${string}`>;
  * ```
  */
-export type WhereNot<T extends Record<string, any> | readonly string[], U> = T extends readonly string[]
-? Exclude<T[number], U>
-: {
- [K in keyof T]: K extends U ? never : K;
-}[keyof T];
+export type WhereNot<
+  T extends Record<string, any> | readonly string[],
+  U
+> = T extends readonly string[]
+  ? Exclude<T[number], U>
+  : {
+      [K in keyof T]: K extends U ? never : K;
+    }[keyof T];

package/src/types/alphabetic/index.ts

@@ -1,14 +1,11 @@
 // #autoindex, exclude: Alpha
 // #region autoindexed files
+// index last changed at: 1st Jan, 2022, 03:27 PM ( GMT-8 )
+// hash-code: fcf9c4b
 
-// index last changed at: 12th Dec, 2021, 12:24 PM ( GMT-8 )
-// export: named; exclusions: Alpha, index, private.
-// files: AllCaps, CamelCase, CapFirstAlpha, CapitalizeWords, DashToSnake, DashUppercase, Dasherize, HasUppercase, IsCapitalized, KebabCase, LowerAllCaps, PascalCase, Pluralize, SnakeCase, alpha-characters.
-
-// local file exports
+// file exports
 export * from "./AllCaps";
 export * from "./CamelCase";
-export * from "./CapFirstAlpha";
 export * from "./CapitalizeWords";
 export * from "./DashToSnake";
 export * from "./DashUppercase";
@@ -22,22 +19,19 @@ export * from "./Pluralize";
 export * from "./SnakeCase";
 export * from "./alpha-characters";
 
-// Note:
-// -----
-// This file was created by running: "dd devops autoindex"; it assumes you have
+// #endregion
+
+// This file was created by running: "dd autoindex"; it assumes you have
 // the 'do-devops' pkg (that's "dd" on npm) installed as a dev dep.
 //
 // By default it assumes that exports are named exports but this can be changed by
 // adding a modifier to the '// #autoindex' syntax:
 //
 //    - autoindex:named     same as default, exports "named symbols"
-//    - autoindex:default   assumes each file is exporting a default export
-//                          and converts the default export to the name of the
-//                          file
+//    - autoindex:default   assumes each file is exporting a default export and
+//                          converts the default export to the name of the file
 //    - autoindex:offset    assumes files export "named symbols" but that each
 //                          file's symbols should be offset by the file's name
-//                          (useful for files which might symbols which collide
-//                          or where the namespacing helps consumers)
 //
 // You may also exclude certain files or directories by adding it to the
 // autoindex command. As an example:
@@ -49,8 +43,6 @@ export * from "./alpha-characters";
 //
 //    - autoindex:named, orphan
 // 
-// Also be aware that all of your content outside the "// #region" section in this file
-// will be preserved in situations where you need to do something paricularly awesome.
+// All content outside the "// #region" section in this file will be
+// preserved in situations where you need to do something paricularly awesome.
 // Keep on being awesome.
-
-// #endregion

package/src/types/dictionary/index.ts

@@ -1,37 +1,35 @@
 // #autoindex
 // #region autoindexed files
+// index last changed at: 1st Jan, 2022, 03:27 PM ( GMT-8 )
+// hash-code: 47804a72
 
-// index last changed at: 7th Jul, 2021, 10:23 PM ( GMT-7 )
-// export: named; exclusions: index, private.
-// files: Get.
-
-// local file exports
+// file exports
 export * from "./Get";
 
-// Note:
-// -----
-// This file was created by running: "dd devops autoindex"; it assumes you have
-// the 'do-devops' pkg installed as a dev dep.
+// #endregion
+
+// This file was created by running: "dd autoindex"; it assumes you have
+// the 'do-devops' pkg (that's "dd" on npm) installed as a dev dep.
 //
 // By default it assumes that exports are named exports but this can be changed by
 // adding a modifier to the '// #autoindex' syntax:
 //
 //    - autoindex:named     same as default, exports "named symbols"
-//    - autoindex:default   assumes each file is exporting a default export
-//                          and converts the default export to the name of the
-//                          file
+//    - autoindex:default   assumes each file is exporting a default export and
+//                          converts the default export to the name of the file
 //    - autoindex:offset    assumes files export "named symbols" but that each
 //                          file's symbols should be offset by the file's name
-//                          (useful for files which might symbols which collide
-//                          or where the namespacing helps consumers)
 //
 // You may also exclude certain files or directories by adding it to the
 // autoindex command. As an example:
 //
 //    - autoindex:named, exclude: foo,bar,baz
 //
-// Also be aware that all of your content outside the defined region in this file
-// will be preserved in situations where you need to do something paricularly awesome.
+// Inversely, if you state a file to be an "orphan" then autoindex files
+// below this file will not reference this autoindex file:
+//
+//    - autoindex:named, orphan
+// 
+// All content outside the "// #region" section in this file will be
+// preserved in situations where you need to do something paricularly awesome.
 // Keep on being awesome.
-
-// #endregion

package/src/types/fluent/index.ts

@@ -1,29 +1,24 @@
 // #autoindex
 // #region autoindexed files
+// index last changed at: 1st Jan, 2022, 03:27 PM ( GMT-8 )
+// hash-code: c5fbce38
 
-// index last changed at: 12th Dec, 2021, 12:28 PM ( GMT-8 )
-// export: named; exclusions: index, private.
-// files: fluent.
-
-// local file exports
+// file exports
 export * from "./fluent";
 
-// Note:
-// -----
-// This file was created by running: "dd devops autoindex"; it assumes you have
+// #endregion
+
+// This file was created by running: "dd autoindex"; it assumes you have
 // the 'do-devops' pkg (that's "dd" on npm) installed as a dev dep.
 //
 // By default it assumes that exports are named exports but this can be changed by
 // adding a modifier to the '// #autoindex' syntax:
 //
 //    - autoindex:named     same as default, exports "named symbols"
-//    - autoindex:default   assumes each file is exporting a default export
-//                          and converts the default export to the name of the
-//                          file
+//    - autoindex:default   assumes each file is exporting a default export and
+//                          converts the default export to the name of the file
 //    - autoindex:offset    assumes files export "named symbols" but that each
 //                          file's symbols should be offset by the file's name
-//                          (useful for files which might symbols which collide
-//                          or where the namespacing helps consumers)
 //
 // You may also exclude certain files or directories by adding it to the
 // autoindex command. As an example:
@@ -35,8 +30,6 @@ export * from "./fluent";
 //
 //    - autoindex:named, orphan
 // 
-// Also be aware that all of your content outside the "// #region" section in this file
-// will be preserved in situations where you need to do something paricularly awesome.
+// All content outside the "// #region" section in this file will be
+// preserved in situations where you need to do something paricularly awesome.
 // Keep on being awesome.
-
-// #endregion

package/src/types/index.ts

@@ -1,12 +1,9 @@
 // #autoindex
 // #region autoindexed files
+// index last changed at: 1st Jan, 2022, 03:27 PM ( GMT-8 )
+// hash-code: 7e6e29a0
 
-// index last changed at: 10th Oct, 2021, 08:32 PM ( GMT-7 )
-// export: named; exclusions: index, private.
-// files: Api, Constructor, EnumValues, ExpandRecursively, First, FunctionType, If, Include, Includes, KeyedRecord, Keys, Length, Mutable, Narrowable, Not, Numeric, Opaque, Retain, Transformer, TypeGuard, Where, append-types, maybe, props, ruleset-types, runtime, type-testing.
-// directories: alphabetic, dictionary, fluent, kv, lists, string-literals, tuples, type-conversion.
-
-// local file exports
+// file exports
 export * from "./Api";
 export * from "./Constructor";
 export * from "./EnumValues";
@@ -34,7 +31,6 @@ export * from "./props";
 export * from "./ruleset-types";
 export * from "./runtime";
 export * from "./type-testing";
-
 // directory exports
 export * from "./alphabetic/index";
 export * from "./dictionary/index";
@@ -45,22 +41,19 @@ export * from "./string-literals/index";
 export * from "./tuples/index";
 export * from "./type-conversion/index";
 
-// Note:
-// -----
-// This file was created by running: "dd devops autoindex"; it assumes you have
+// #endregion
+
+// This file was created by running: "dd autoindex"; it assumes you have
 // the 'do-devops' pkg (that's "dd" on npm) installed as a dev dep.
 //
 // By default it assumes that exports are named exports but this can be changed by
 // adding a modifier to the '// #autoindex' syntax:
 //
 //    - autoindex:named     same as default, exports "named symbols"
-//    - autoindex:default   assumes each file is exporting a default export
-//                          and converts the default export to the name of the
-//                          file
+//    - autoindex:default   assumes each file is exporting a default export and
+//                          converts the default export to the name of the file
 //    - autoindex:offset    assumes files export "named symbols" but that each
 //                          file's symbols should be offset by the file's name
-//                          (useful for files which might symbols which collide
-//                          or where the namespacing helps consumers)
 //
 // You may also exclude certain files or directories by adding it to the
 // autoindex command. As an example:
@@ -72,8 +65,6 @@ export * from "./type-conversion/index";
 //
 //    - autoindex:named, orphan
 // 
-// Also be aware that all of your content outside the "// #region" section in this file
-// will be preserved in situations where you need to do something paricularly awesome.
+// All content outside the "// #region" section in this file will be
+// preserved in situations where you need to do something paricularly awesome.
 // Keep on being awesome.
-
-// #endregion

package/src/types/kv/index.ts

@@ -1,40 +1,38 @@
 // #autoindex
 // #region autoindexed files
+// index last changed at: 1st Jan, 2022, 03:27 PM ( GMT-8 )
+// hash-code: abd196de
 
-// index last changed at: 7th Jul, 2021, 01:41 PM ( GMT-7 )
-// export: named; exclusions: index, private.
-// files: DictFromKv, KeyValue, KvFrom, KvTuple.
-
-// local file exports
+// file exports
 export * from "./DictFromKv";
 export * from "./KeyValue";
 export * from "./KvFrom";
 export * from "./KvTuple";
 
-// Note:
-// -----
-// This file was created by running: "dd devops autoindex"; it assumes you have
-// the 'do-devops' pkg installed as a dev dep.
+// #endregion
+
+// This file was created by running: "dd autoindex"; it assumes you have
+// the 'do-devops' pkg (that's "dd" on npm) installed as a dev dep.
 //
 // By default it assumes that exports are named exports but this can be changed by
 // adding a modifier to the '// #autoindex' syntax:
 //
 //    - autoindex:named     same as default, exports "named symbols"
-//    - autoindex:default   assumes each file is exporting a default export
-//                          and converts the default export to the name of the
-//                          file
+//    - autoindex:default   assumes each file is exporting a default export and
+//                          converts the default export to the name of the file
 //    - autoindex:offset    assumes files export "named symbols" but that each
 //                          file's symbols should be offset by the file's name
-//                          (useful for files which might symbols which collide
-//                          or where the namespacing helps consumers)
 //
 // You may also exclude certain files or directories by adding it to the
 // autoindex command. As an example:
 //
 //    - autoindex:named, exclude: foo,bar,baz
 //
-// Also be aware that all of your content outside the defined region in this file
-// will be preserved in situations where you need to do something paricularly awesome.
+// Inversely, if you state a file to be an "orphan" then autoindex files
+// below this file will not reference this autoindex file:
+//
+//    - autoindex:named, orphan
+// 
+// All content outside the "// #region" section in this file will be
+// preserved in situations where you need to do something paricularly awesome.
 // Keep on being awesome.
-
-// #endregion

package/src/types/lists/index.ts

@@ -1,38 +1,36 @@
 // #autoindex
 
 // #region autoindexed files
+// index last changed at: 1st Jan, 2022, 03:27 PM ( GMT-8 )
+// hash-code: 61af00e2
 
-// index last changed at: 8th Aug, 2021, 05:44 PM ( GMT-7 )
-// export: named; exclusions: index, private.
-// files: UniqueForProp.
-
-// local file exports
+// file exports
 export * from "./UniqueForProp";
 
-// Note:
-// -----
-// This file was created by running: "dd devops autoindex"; it assumes you have
-// the 'do-devops' pkg installed as a dev dep.
+// #endregion
+
+// This file was created by running: "dd autoindex"; it assumes you have
+// the 'do-devops' pkg (that's "dd" on npm) installed as a dev dep.
 //
 // By default it assumes that exports are named exports but this can be changed by
 // adding a modifier to the '// #autoindex' syntax:
 //
 //    - autoindex:named     same as default, exports "named symbols"
-//    - autoindex:default   assumes each file is exporting a default export
-//                          and converts the default export to the name of the
-//                          file
+//    - autoindex:default   assumes each file is exporting a default export and
+//                          converts the default export to the name of the file
 //    - autoindex:offset    assumes files export "named symbols" but that each
 //                          file's symbols should be offset by the file's name
-//                          (useful for files which might symbols which collide
-//                          or where the namespacing helps consumers)
 //
 // You may also exclude certain files or directories by adding it to the
 // autoindex command. As an example:
 //
 //    - autoindex:named, exclude: foo,bar,baz
 //
-// Also be aware that all of your content outside the defined region in this file
-// will be preserved in situations where you need to do something paricularly awesome.
+// Inversely, if you state a file to be an "orphan" then autoindex files
+// below this file will not reference this autoindex file:
+//
+//    - autoindex:named, orphan
+// 
+// All content outside the "// #region" section in this file will be
+// preserved in situations where you need to do something paricularly awesome.
 // Keep on being awesome.
-
-// #endregion

package/src/types/string-literals/index.ts

@@ -1,11 +1,9 @@
 // #autoindex
 // #region autoindexed files
+// index last changed at: 1st Jan, 2022, 03:27 PM ( GMT-8 )
+// hash-code: a80cfdd7
 
-// index last changed at: 7th Jul, 2021, 02:55 PM ( GMT-7 )
-// export: named; exclusions: index, private.
-// files: Break, Concat, LeftWhitespace, Replace, RightWhitespace, StringLength, Trim, TrimLeft, TrimRight, form-fields.
-
-// local file exports
+// file exports
 export * from "./Break";
 export * from "./Concat";
 export * from "./LeftWhitespace";
@@ -17,30 +15,30 @@ export * from "./TrimLeft";
 export * from "./TrimRight";
 export * from "./form-fields";
 
-// Note:
-// -----
-// This file was created by running: "dd devops autoindex"; it assumes you have
-// the 'do-devops' pkg installed as a dev dep.
+// #endregion
+
+// This file was created by running: "dd autoindex"; it assumes you have
+// the 'do-devops' pkg (that's "dd" on npm) installed as a dev dep.
 //
 // By default it assumes that exports are named exports but this can be changed by
 // adding a modifier to the '// #autoindex' syntax:
 //
 //    - autoindex:named     same as default, exports "named symbols"
-//    - autoindex:default   assumes each file is exporting a default export
-//                          and converts the default export to the name of the
-//                          file
+//    - autoindex:default   assumes each file is exporting a default export and
+//                          converts the default export to the name of the file
 //    - autoindex:offset    assumes files export "named symbols" but that each
 //                          file's symbols should be offset by the file's name
-//                          (useful for files which might symbols which collide
-//                          or where the namespacing helps consumers)
 //
 // You may also exclude certain files or directories by adding it to the
 // autoindex command. As an example:
 //
 //    - autoindex:named, exclude: foo,bar,baz
 //
-// Also be aware that all of your content outside the defined region in this file
-// will be preserved in situations where you need to do something paricularly awesome.
+// Inversely, if you state a file to be an "orphan" then autoindex files
+// below this file will not reference this autoindex file:
+//
+//    - autoindex:named, orphan
+// 
+// All content outside the "// #region" section in this file will be
+// preserved in situations where you need to do something paricularly awesome.
 // Keep on being awesome.
-
-// #endregion