url-safe-bitpacking 0.1.12 → 0.1.14

package/README.md

@@ -11,16 +11,14 @@ Package for creating definitions of parametric models that can be stored as comp
 | updating model entries                               | ✓  | ✓  |          |
 | re-using data from old model on change in definition | ½ | ¼ |          |
 | flattening and reading of the objects                | ✓  | ✓  | ¿ |
+| arrays (both bit-level as arrays of objects)         | ½ | ½ |          |
+| utility to create StateValueType                     |          |          |          |
 
 ## concept
 
-The goal of this library is to offer a flexible, minimal and, variable object definition that can be stored in the browser URL. The main imagined use-case is parametric models that have nested and variable sub-object definitions.
+The goal of this library is to offer a flexible, minimal and, variable object definition that can be stored in the browser URL. The main imagined use-case is parametric models that have nested and variable sub-object definitions. The library heavily relies on the bitpacking of custom bitwidth numeric values. Because of that, the biggest trade-off for this library is legibility. Without the related object definition, it would be impossible to reconstruct the state. The big advantage though is the ability to store rather many variables in a very condensed URL, allowing to store all information in rather short urls which then can be used for qr code generation.
 
-The library heavily relies on the bitpacking of custom bitwidth numeric values. Because of that, the biggest trade-off for this library is legibility. Without the related object definition, it would be impossible to reconstruct the state.
-
-The big advantage though is the ability to store rather many variables in a very condensed URL, allowing to store all information in rather short urls which then can be used for qr code generation.
-
-## data types
+## bit-level data types
 
 Currently, there are 4 data types implemented (+1 special case for safety). All data entries have a name that will behave as an attribute name in the object.
 
@@ -64,11 +62,11 @@ There is also a Version object which is a special case of the enum data type and
 DataEntryFactory.createVersion(0, 8, 'version');
 ```
 
-## attribute map
+## nested attribute definitions
 
-On a macro level there are two types of data. Either Single Level array objects or Double Nested array objects.
+More often than not in parametric models, certain data belongs together. It can also happen that the specific state of some values will have an impact on other ones being present (or which ranges are allowed). To be able to deal with this there is the option to nest data. I tried to come with an as concise yet versatile way of defining the object definitions.
 
-Single-level nested objects are arrays in which the entries it contains describe themselves. The Double Nested arrays describe objects that will have a variable size, that depends on the linked data entry that is selected is set in state.
+### single nes
 
 For the Double Nested arrays there are currently two variations: either an Optional type, which only accepts two values of which is an empty array and will be toggle on/off in relation to a certain boolean data entry.
 

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 export { DataType } from './enums';
 export { DataEntryFactory } from './factory';
-export { SingleLevelContentType, NestedContentDataType, NestedContentType, DoubleLevelContentType, NonEmptyValidEntryArrayType, OptionalEntryDataType, EnumEntryDataType, PrecisionRangeType, SignificandMaxBits, FloatData, IntegerMaxBits, IntData, VersionRangeType, VersionData, BooleanData, DataEntry, DataEntryArray, } from './types';
-export { createParserObject, getStateValue, getBase64String } from './objectmap';
+export { SingleLevelContentType, NestedContentDataType, NestedContentType, DoubleLevelContentType, NonEmptyValidEntryArrayType, OptionalEntryDataType, EnumEntryDataType, PrecisionRangeType, SignificandMaxBits, FloatData, IntegerMaxBits, IntData, VersionRangeType, VersionData, BooleanData, DataEntry, DataEntryArray, StateDataType, StateValueType, EnumSemantics, DerivativeStateDataType, } from './types';
+export { createParserObject, getStateValue, getBase64String, getDataEntryArray } from './objectmap';
 export { parseBase64ToBits } from './parsers';
 export { interpolateEntryAt, getRelativeValue } from './utils';

package/dist/index.js

@@ -459,7 +459,7 @@ var getStateDataFromSingleLevelContentType = (slct, prefix) => {
   if (singleLevelContentTypeIsDataEntry(slct))
     return (additionalData) => internalGetDataEntry(slct, prefix, additionalData);
   else if (singleLevelContentTypeIsNestedContentDataType(slct))
-    return getStateDataFromNestedContentType(slct[1], prefix, slct[0]);
+    return getStateDataFromNestedContentType(slct[1], `${prefix}_${slct[0]}`, slct[0]);
   throw new Error("this is an invalid output value, wonder why?");
 };
 var getGenerationMethodForSingleLevelContentTypeArray = (slct) => {
@@ -488,7 +488,7 @@ var getParserMethodForVersionDefinition = (vadt, versionBits, defaultVersion) =>
   const versionEntry = DataEntryFactory.createVersion(versionIndex, versionBits, "version");
   return getGenerationMethodForSingleLevelContentTypeArray([versionEntry, ...versionDefinition])(additionalData);
 };
-var getUpdaterMethodForVersionDefinition = (parser) => (state, entryToUpdate) => parser([entryToUpdate, ...getDataEntryArray(state)]);
+var getUpdaterMethodForVersionDefinition = (parser) => (state, entryToUpdate) => parser([...Array.isArray(entryToUpdate) ? entryToUpdate : [entryToUpdate], ...getDataEntryArray(state)]);
 var getStringifyMethodForVersionDefinition = (parser) => (data) => getBase64String(parser(data));
 var createParserObject = (versionContent, maximumExpectedVersions, defaultVersion, enumSemanticsMapping, attributeSemanticsMapping, exposedVersions) => {
   const versionBitCount = getVersionValueRangeValueForNumber(maximumExpectedVersions);
@@ -547,6 +547,7 @@ export {
   interpolateEntryAt,
   getStateValue,
   getRelativeValue,
+  getDataEntryArray,
   getBase64String,
   createParserObject,
   SignificandMaxBits,

package/dist/types/stateValueModel.d.ts

@@ -19,7 +19,7 @@ export type StateDataGenerationMethod = (additionalData?: DataEntryArray | strin
 export type DataEntryParsingReturnType = [DataEntryArray | string | undefined, [string, DataEntry]];
 export type InternalStateDataGenerationMethod = (additionalData?: DataEntryArray | string) => [DataEntryArray | string | undefined, [string, DataEntry | StateDataType | DerivativeStateDataType]];
 export type ExposedParserStateDataMethod = (additionalData?: StateDataType | DataEntryArray | string) => StateDataType;
-export type UpdateStateDataMethod = (state: StateDataType, entryToUpdate: DataEntry) => StateDataType;
+export type UpdateStateDataMethod = (state: StateDataType, entryToUpdate: DataEntry | DataEntry[]) => StateDataType;
 export type StringifyStateDataMethod = (data: StateDataType | DataEntryArray) => string;
 export type VersionContentDefinition = SingleLevelContentType[][];
 export type VersionHandler = {

package/package.json

@@ -6,7 +6,7 @@
     "dist/*"
   ],
   "type": "module",
-  "version": "0.1.12",
+  "version": "0.1.14",
   "author": "Jonas Ward",
   "description": "Library for creating web safe base64 objects with custom bith widths and dynamic values.",
   "scripts": {