inferred-types 0.18.1 → 0.18.2

package/src/utility/dictionary/index.ts

@@ -1,12 +1,9 @@
 // #autoindex
 // #region autoindexed files
+// index last changed at: 12th Dec, 2021, 09:28 AM ( GMT-8 )
+// hash-code: 1609486729
 
-// index last changed at: 7th Jul, 2021, 08:06 AM ( GMT-7 )
-// export: named; exclusions: index, private.
-// files: arrayToKeyLookup, dictFilter, dictionaryTransform, entries, mapValues, strArrayToDict, valuesOfProp.
-// directories: kv.
-
-// local file exports
+// file exports
 export * from "./arrayToKeyLookup";
 export * from "./dictFilter";
 export * from "./dictionaryTransform";
@@ -14,34 +11,33 @@ export * from "./entries";
 export * from "./mapValues";
 export * from "./strArrayToDict";
 export * from "./valuesOfProp";
-
 // directory exports
 export * from "./kv/index";
 
-// 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/utility/dictionary/kv/index.ts

@@ -1,40 +1,38 @@
 // #autoindex
 // #region autoindexed files
+// index last changed at: 12th Dec, 2021, 09:28 AM ( GMT-8 )
+// hash-code: 3790237505
 
-// index last changed at: 8th Aug, 2021, 05:39 PM ( GMT-7 )
-// export: named; exclusions: index, private.
-// files: dictToKv, filterDictArray, kv, kvToDict.
-
-// local file exports
+// file exports
 export * from "./dictToKv";
 export * from "./filterDictArray";
 export * from "./kv";
 export * from "./kvToDict";
 
-// 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/utility/index.ts

@@ -1,17 +1,13 @@
 // #autoindex
 
 // #region autoindexed files
+// index last changed at: 12th Dec, 2021, 09:28 AM ( GMT-8 )
+// hash-code: 1753666426
 
-// index last changed at: 8th Aug, 2021, 10:32 AM ( GMT-7 )
-// export: named; exclusions: index, private.
-// files: createFnWithProps, keys, ruleset.
-// directories: api, dictionary, lists, literals, map-reduce, modelling, runtime, state.
-
-// local file exports
+// file exports
 export * from "./createFnWithProps";
 export * from "./keys";
 export * from "./ruleset";
-
 // directory exports
 export * from "./api/index";
 export * from "./dictionary/index";
@@ -22,30 +18,30 @@ export * from "./modelling/index";
 export * from "./runtime/index";
 export * from "./state/index";
 
-// 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/utility/lists/index.ts

@@ -1,38 +1,36 @@
 // #autoindex
 
 // #region autoindexed files
+// index last changed at: 12th Dec, 2021, 09:28 AM ( GMT-8 )
+// hash-code: 22070035
 
-// index last changed at: 8th Aug, 2021, 10:32 AM ( GMT-7 )
-// export: named; exclusions: index, private.
-// files: groupBy.
-
-// local file exports
+// file exports
 export * from "./groupBy";
 
-// 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/utility/literals/index.ts

@@ -1,41 +1,39 @@
 // #autoindex
 // #region autoindexed files
+// index last changed at: 12th Dec, 2021, 09:28 AM ( GMT-8 )
+// hash-code: 192569155
 
-// index last changed at: 6th Jun, 2021, 11:21 PM ( GMT-7 )
-// export: named; exclusions: index, private.
-// files: ExplicitFunction, arrayToObject, defineType, identity, literal.
-
-// local file exports
+// file exports
 export * from "./ExplicitFunction";
 export * from "./arrayToObject";
 export * from "./defineType";
 export * from "./identity";
 export * from "./literal";
 
-// 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/utility/map-reduce/index.ts

@@ -1,37 +1,35 @@
 // #autoindex
 // #region autoindexed files
+// index last changed at: 12th Dec, 2021, 09:28 AM ( GMT-8 )
+// hash-code: 1933921503
 
-// index last changed at: 6th Jun, 2021, 04:31 PM ( GMT-7 )
-// export: named; exclusions: index, private.
-// files: filter.
-
-// local file exports
+// file exports
 export * from "./filter";
 
-// 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/utility/modelling/index.ts

@@ -1,37 +1,35 @@
 // #autoindex, exclude: IoModel
 // #region autoindexed files
+// index last changed at: 12th Dec, 2021, 09:28 AM ( GMT-8 )
+// hash-code: 886488599
 
-// index last changed at: 7th Jul, 2021, 02:32 PM ( GMT-7 )
-// export: named; exclusions: IoModel, index, private.
-// files: Model.
-
-// local file exports
+// file exports
 export * from "./Model";
 
-// 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/utility/runtime/conditions/index.ts

@@ -1,12 +1,10 @@
 // #autoindex
 
 // #region autoindexed files
+// index last changed at: 12th Dec, 2021, 09:28 AM ( GMT-8 )
+// hash-code: 2742585618
 
-// index last changed at: 8th Aug, 2021, 08:15 PM ( GMT-7 )
-// export: named; exclusions: index, private.
-// files: isArray, isBoolean, isFalse, isFunction, isLiteral, isNull, isNumber, isObject, isString, isSymbol, isTrue, isUndefined.
-
-// local file exports
+// file exports
 export * from "./isArray";
 export * from "./isBoolean";
 export * from "./isFalse";
@@ -20,30 +18,30 @@ export * from "./isSymbol";
 export * from "./isTrue";
 export * from "./isUndefined";
 
-// 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/utility/runtime/ifTypeOf.ts

@@ -1,4 +1,3 @@
-import { InferenceError } from "~/errors";
 import { Narrowable } from "~/types/Narrowable";
 import { keys } from "../keys";
 
@@ -24,10 +23,7 @@ function runtimeExtendsCheck<TValue extends any, TBase extends any>(
       return true as TValue extends TBase ? true : false;
     case "function":
       if (narrow) {
-        throw new InferenceError(
-          `Use of narrowlyExtends with a function is not possible!`,
-          "ifTypeOf/not-allowed"
-        );
+        throw new Error(`Use of narrowlyExtends with a function is not possible!`);
       }
       return true as TValue extends TBase ? true : false;
     case "object":

package/src/utility/runtime/index.ts

@@ -1,44 +1,40 @@
 // #autoindex
 // #region autoindexed files
+// index last changed at: 12th Dec, 2021, 09:28 AM ( GMT-8 )
+// hash-code: 152540854
 
-// index last changed at: 8th Aug, 2021, 01:19 PM ( GMT-7 )
-// export: named; exclusions: index, private.
-// files: condition, ifTypeOf, type, withValue.
-// directories: conditions.
-
-// local file exports
+// file exports
 export * from "./condition";
 export * from "./ifTypeOf";
 export * from "./type";
 export * from "./withValue";
-
 // directory exports
 export * from "./conditions/index";
 
-// 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/utility/state/index.ts

@@ -1,39 +1,37 @@
 // #autoindex
 // #region autoindexed files
+// index last changed at: 12th Dec, 2021, 09:28 AM ( GMT-8 )
+// hash-code: 4250795496
 
-// index last changed at: 6th Jun, 2021, 04:31 PM ( GMT-7 )
-// export: named; exclusions: index, private.
-// files: Configurator, FluentConfigurator, KeyStorage.
-
-// local file exports
+// file exports
 export * from "./Configurator";
 export * from "./FluentConfigurator";
 export * from "./KeyStorage";
 
-// 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