inferred-types 0.16.1 → 0.18.2

package/src/types/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: 1638858978
 
-// 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/ruleset-types.ts

@@ -1,6 +1,6 @@
 import type { TypeCondition } from "~/utility/runtime/ifTypeOf";
 import { OptionalKeys } from "./props";
-import { SameKeys } from "./SameKeys";
+import { SameKeys } from "./type-conversion/SameKeys";
 
 /**
  * **RuleDefinition**

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

@@ -1,11 +1,9 @@
 // #autoindex
 // #region autoindexed files
+// index last changed at: 12th Dec, 2021, 09:28 AM ( GMT-8 )
+// hash-code: 2819423703
 
-// 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

package/src/types/tuples/index.ts

@@ -1,11 +1,9 @@
 // #autoindex
 // #region autoindexed files
+// index last changed at: 12th Dec, 2021, 09:28 AM ( GMT-8 )
+// hash-code: 934853479
 
-// index last changed at: 8th Aug, 2021, 04:22 PM ( GMT-7 )
-// export: named; exclusions: index, private.
-// files: DictArray, FirstKey, FirstKeyValue, FirstOfEach, FromDictArray, SecondOfEach.
-
-// local file exports
+// file exports
 export * from "./DictArray";
 export * from "./FirstKey";
 export * from "./FirstKeyValue";
@@ -13,30 +11,30 @@ export * from "./FirstOfEach";
 export * from "./FromDictArray";
 export * from "./SecondOfEach";
 
-// 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/type-conversion/WrapValue.ts

@@ -0,0 +1,15 @@
+type ValueFunction<T extends any> = <R extends any>(v: T) => R;
+
+/**
+ * **SameKeys**
+ *
+ * Given a dictionary `T` and a type-strong wrapper function `F`, returns a dictionary with the
+ * same keys but 
+ * 
+ * Note: meant to be used as part of an _extends_ clause in most cases.
+ */
+export type WrapValue<T extends {}, F extends ValueFunction<T>> = {
+  [P in keyof T]: ReturnType<F>;
+};
+
+

package/src/types/type-conversion/index.ts

@@ -1,40 +1,40 @@
 // #autoindex
 
 // #region autoindexed files
+// index last changed at: 12th Dec, 2021, 09:28 AM ( GMT-8 )
+// hash-code: 1015918361
 
-// index last changed at: 8th Aug, 2021, 04:13 PM ( GMT-7 )
-// export: named; exclusions: index, private.
-// files: TupleToUnion, UnionToIntersection, UnionToTuple.
-
-// local file exports
+// file exports
+export * from "./SameKeys";
 export * from "./TupleToUnion";
 export * from "./UnionToIntersection";
 export * from "./UnionToTuple";
+export * from "./WrapValue";
+
+// #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/utility/api/index.ts

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