@qoretechnologies/reqraft 0.10.66-pr.145.gcb1e59d → 0.10.66

package/dist/components/form/fields/binary/Binary.js

@@ -28,6 +28,7 @@ var reqore_1 = require("@qoretechnologies/reqore");
 var react_1 = require("react");
 var react_use_1 = require("react-use");
 var emittedValues_1 = require("../emittedValues");
+var pendingEdit_1 = require("../pendingEdit");
 var File_1 = require("../file/File");
 /**
  * Strip a `data:<mime-type>;base64,` prefix so the emitted value carries raw base64, matching the
@@ -50,32 +51,51 @@ exports.ReqraftBinaryFormField = (0, react_1.memo)(function (_a) {
     // The parent's echo of an emit still in flight is not a change: copying it
     // over the local value lost what was typed since. See `EmittedValues`.
     var emitted = (0, emittedValues_1.useEmittedValues)();
+    /* What the parent holds, as the field shows it: no value is the empty text. Compared with `undefined`,
+       the empty text of a field opened without a value was a change, and the field reported '' 100 ms
+       after it opened - the form counted itself edited, and an unset field got '' (qorus#646). */
+    var held = value !== null && value !== void 0 ? value : '';
+    /* What is typed and not yet reported: the pause below dies with the field, and Done closes the field
+       inside it. See `usePendingEdit`. */
+    var pending = (0, pendingEdit_1.usePendingEdit)(function (next) {
+        if (next !== emitted.settled(held)) {
+            emitted.record(next);
+            onChange === null || onChange === void 0 ? void 0 : onChange(next);
+        }
+    });
     (0, react_1.useEffect)(function () {
         if (emitted.isEcho(value)) {
             return;
         }
+        // the parent has a value of its own: what was typed before it is no edit to send any more
+        pending.release();
         if (value !== localValue) {
             setLocalValue(value !== null && value !== void 0 ? value : '');
         }
     }, [value]);
     (0, react_use_1.useDebounce)(function () {
-        if (localValue !== value) {
+        pending.release();
+        if (localValue !== emitted.settled(held)) {
             emitted.record(localValue);
             onChange === null || onChange === void 0 ? void 0 : onChange(localValue);
         }
     }, 100, [localValue, onChange]);
     var handleChange = (0, react_1.useCallback)(function (event) {
         setLocalValue(event.target.value);
-    }, []);
+        pending.hold(event.target.value);
+    }, [pending]);
     var handleFileChange = (0, react_1.useCallback)(function (file) {
         var _a;
         var base64 = stripDataUrlPrefix((_a = file === null || file === void 0 ? void 0 : file.content) !== null && _a !== void 0 ? _a : '');
         setLocalValue(base64);
+        // reported at once, so nothing waits
+        pending.release();
         emitted.record(base64);
         onChange === null || onChange === void 0 ? void 0 : onChange(base64);
-    }, [onChange]);
+    }, [onChange, pending]);
     return ((0, jsx_runtime_1.jsxs)(reqore_1.ReqoreControlGroup, { vertical: true, fluid: true, children: [(0, jsx_runtime_1.jsx)(reqore_1.ReqoreTextarea, __assign({ scaleWithContent: true, fluid: true, value: localValue, onChange: handleChange, onClearClick: function () {
                     setLocalValue('');
+                    pending.release();
                     emitted.record('');
                     onChange === null || onChange === void 0 ? void 0 : onChange('');
                 }, placeholder: 'Base64-encoded binary value' }, rest)), (0, jsx_runtime_1.jsx)(File_1.ReqraftFileFormField, { disabled: rest.disabled, onChange: handleFileChange })] }));

package/dist/components/form/fields/binary/Binary.js.map

@@ -1 +1 @@
-{"version":3,"file":"Binary.js","sourceRoot":"","sources":["../../../../../src/components/form/fields/binary/Binary.tsx"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,mDAA8E;AAE9E,+BAA4E;AAC5E,uCAAwC;AACxC,kDAAoD;AACpD,qCAAyE;AAOzE;;;;GAIG;AACH,IAAM,kBAAkB,GAAG,UAAC,OAAe;IACzC,IAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACxC,OAAO,UAAU,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;AACrE,CAAC,CAAC;AAEF;;;;;GAKG;AACU,QAAA,sBAAsB,GAAG,IAAA,YAAI,EACxC,UAAC,EAA0D;IAAxD,IAAA,KAAK,WAAA,EAAE,QAAQ,cAAA,EAAK,IAAI,cAA1B,qBAA4B,CAAF;IACnB,IAAA,KAA8B,IAAA,gBAAQ,EAAS,KAAK,aAAL,KAAK,cAAL,KAAK,GAAI,EAAE,CAAC,EAA1D,UAAU,QAAA,EAAE,aAAa,QAAiC,CAAC;IAClE,2EAA2E;IAC3E,uEAAuE;IACvE,IAAM,OAAO,GAAG,IAAA,gCAAgB,GAAsB,CAAC;IAEvD,IAAA,iBAAS,EAAC;QACR,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO;QACT,CAAC;QACD,IAAI,KAAK,KAAK,UAAU,EAAE,CAAC;YACzB,aAAa,CAAC,KAAK,aAAL,KAAK,cAAL,KAAK,GAAI,EAAE,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;IAEZ,IAAA,uBAAW,EACT;QACE,IAAI,UAAU,KAAK,KAAK,EAAE,CAAC;YACzB,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YAC3B,QAAQ,aAAR,QAAQ,uBAAR,QAAQ,CAAG,UAAU,CAAC,CAAC;QACzB,CAAC;IACH,CAAC,EACD,GAAG,EACH,CAAC,UAAU,EAAE,QAAQ,CAAC,CACvB,CAAC;IAEF,IAAM,YAAY,GAAG,IAAA,mBAAW,EAAC,UAAC,KAAuC;QACvE,aAAa,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,IAAM,gBAAgB,GAAG,IAAA,mBAAW,EAClC,UAAC,IAA0B;;QACzB,IAAM,MAAM,GAAG,kBAAkB,CAAC,MAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,OAAO,mCAAI,EAAE,CAAC,CAAC;QACvD,aAAa,CAAC,MAAM,CAAC,CAAC;QACtB,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACvB,QAAQ,aAAR,QAAQ,uBAAR,QAAQ,CAAG,MAAM,CAAC,CAAC;IACrB,CAAC,EACD,CAAC,QAAQ,CAAC,CACX,CAAC;IAEF,OAAO,CACL,wBAAC,2BAAkB,IAAC,QAAQ,QAAC,KAAK,mBAChC,uBAAC,uBAAc,aACb,gBAAgB,QAChB,KAAK,QACL,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,YAAY,EACtB,YAAY,EAAE;oBACZ,aAAa,CAAC,EAAE,CAAC,CAAC;oBAClB,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;oBACnB,QAAQ,aAAR,QAAQ,uBAAR,QAAQ,CAAG,EAAE,CAAC,CAAC;gBACjB,CAAC,EACD,WAAW,EAAC,6BAA6B,IACrC,IAAI,EACR,EACF,uBAAC,2BAAoB,IAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,gBAAgB,GAAI,IAC1D,CACtB,CAAC;AACJ,CAAC,CACF,CAAC;AAEF,kBAAe,8BAAsB,CAAC"}
+{"version":3,"file":"Binary.js","sourceRoot":"","sources":["../../../../../src/components/form/fields/binary/Binary.tsx"],"names":[],"mappings":"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"}

package/dist/components/form/fields/boolean/Boolean.d.ts

@@ -2,6 +2,11 @@ import { IReqoreCheckboxProps } from '@qoretechnologies/reqore/dist/components/C
 export interface IBooleanFormFieldProps extends Omit<IReqoreCheckboxProps, 'onChange'> {
     onChange?(checked: boolean): void;
 }
+/**
+ * What a yes / no shows for the value it holds: No for false, Yes for true, and no answer for no value - the
+ * switch's unset state, not No (qorus#646, David: an empty yes / no read No while the form asked for a value).
+ */
+export declare const yesNoShown: (value: unknown) => boolean | undefined;
 export declare const BooleanFormField: ({ checked, onChange, onClick, ...rest }: IBooleanFormFieldProps) => import("react/jsx-runtime").JSX.Element;
 export default BooleanFormField;
 //# sourceMappingURL=Boolean.d.ts.map

package/dist/components/form/fields/boolean/Boolean.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Boolean.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/fields/boolean/Boolean.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,mDAAmD,CAAC;AAEzF,MAAM,WAAW,sBAAuB,SAAQ,IAAI,CAAC,oBAAoB,EAAE,UAAU,CAAC;IACpF,QAAQ,CAAC,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;CACnC;AAED,eAAO,MAAM,gBAAgB,4CAK1B,sBAAsB,4CAmBxB,CAAC;AAEF,eAAe,gBAAgB,CAAC"}
+{"version":3,"file":"Boolean.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/fields/boolean/Boolean.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,mDAAmD,CAAC;AAEzF,MAAM,WAAW,sBAAuB,SAAQ,IAAI,CAAC,oBAAoB,EAAE,UAAU,CAAC;IACpF,QAAQ,CAAC,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;CACnC;AAED;;;GAGG;AACH,eAAO,MAAM,UAAU,UAAW,OAAO,KAAG,OAAO,GAAG,SACO,CAAC;AAE9D,eAAO,MAAM,gBAAgB,4CAK1B,sBAAsB,4CAmBxB,CAAC;AAEF,eAAe,gBAAgB,CAAC"}

package/dist/components/form/fields/boolean/Boolean.js

@@ -22,9 +22,17 @@ var __rest = (this && this.__rest) || function (s, e) {
     return t;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.BooleanFormField = void 0;
+exports.BooleanFormField = exports.yesNoShown = void 0;
 var jsx_runtime_1 = require("react/jsx-runtime");
 var reqore_1 = require("@qoretechnologies/reqore");
+/**
+ * What a yes / no shows for the value it holds: No for false, Yes for true, and no answer for no value - the
+ * switch's unset state, not No (qorus#646, David: an empty yes / no read No while the form asked for a value).
+ */
+var yesNoShown = function (value) {
+    return value === undefined || value === null ? undefined : !!value;
+};
+exports.yesNoShown = yesNoShown;
 var BooleanFormField = function (_a) {
     var checked = _a.checked, onChange = _a.onChange, onClick = _a.onClick, rest = __rest(_a, ["checked", "onChange", "onClick"]);
     var toggle = function (event) {

package/dist/components/form/fields/boolean/Boolean.js.map

@@ -1 +1 @@
-{"version":3,"file":"Boolean.js","sourceRoot":"","sources":["../../../../../src/components/form/fields/boolean/Boolean.tsx"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,mDAA0D;AAOnD,IAAM,gBAAgB,GAAG,UAAC,EAKR;IAJvB,IAAA,OAAO,aAAA,EACP,QAAQ,cAAA,EACR,OAAO,aAAA,EACJ,IAAI,cAJwB,kCAKhC,CADQ;IAEP,IAAM,MAAM,GAAoC,UAAC,KAAK;QACpD,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC;QACnB,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAG,KAAK,CAAC,CAAC;IACnB,CAAC,CAAC;IAEF,OAAO,CACL,uBAAC,uBAAc,aACb,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,MAAM,EACf,QAAQ,QACR,MAAM,EAAC,KAAK,EACZ,OAAO,EAAC,IAAI,EACZ,WAAW,EAAC,WAAW,EACvB,aAAa,EAAC,WAAW,EACzB,MAAM,EAAC,MAAM,IACT,IAAI,EACR,CACH,CAAC;AACJ,CAAC,CAAC;AAxBW,QAAA,gBAAgB,oBAwB3B;AAEF,kBAAe,wBAAgB,CAAC"}
+{"version":3,"file":"Boolean.js","sourceRoot":"","sources":["../../../../../src/components/form/fields/boolean/Boolean.tsx"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,mDAA0D;AAO1D;;;GAGG;AACI,IAAM,UAAU,GAAG,UAAC,KAAc;IACvC,OAAA,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK;AAA3D,CAA2D,CAAC;AADjD,QAAA,UAAU,cACuC;AAEvD,IAAM,gBAAgB,GAAG,UAAC,EAKR;IAJvB,IAAA,OAAO,aAAA,EACP,QAAQ,cAAA,EACR,OAAO,aAAA,EACJ,IAAI,cAJwB,kCAKhC,CADQ;IAEP,IAAM,MAAM,GAAoC,UAAC,KAAK;QACpD,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC;QACnB,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAG,KAAK,CAAC,CAAC;IACnB,CAAC,CAAC;IAEF,OAAO,CACL,uBAAC,uBAAc,aACb,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,MAAM,EACf,QAAQ,QACR,MAAM,EAAC,KAAK,EACZ,OAAO,EAAC,IAAI,EACZ,WAAW,EAAC,WAAW,EACvB,aAAa,EAAC,WAAW,EACzB,MAAM,EAAC,MAAM,IACT,IAAI,EACR,CACH,CAAC;AACJ,CAAC,CAAC;AAxBW,QAAA,gBAAgB,oBAwB3B;AAEF,kBAAe,wBAAgB,CAAC"}

package/dist/components/form/fields/color/Color.d.ts

@@ -1,21 +1,108 @@
-import { SketchPickerProps } from 'react-color';
-export interface IColorFormFieldProps extends Omit<SketchPickerProps, 'onChange' | 'onChangeComplete'> {
-    value?: {
-        r: number;
-        g: number;
-        b: number;
-        a?: number;
-    };
-    onChange?: (value: {
-        r: number;
-        g: number;
-        b: number;
-        a: number;
-    }) => void;
+import { RgbaColor } from '@uiw/color-convert';
+/** The color an `rgbcolor` field stores: red, green and blue from 0 to 255, alpha from 0 to 1. */
+export interface IColorFormFieldValue {
+    r: number;
+    g: number;
+    b: number;
+    a?: number;
+}
+/**
+ * What the color field reads as a color (qorus#646): a stored color, `{ r, g, b, a? }`, or a value stored the wrong
+ * way, which it still reads so it can show it and store it right - a hex code (3, 4, 6 or 8 digits, with or without
+ * its `#`), `{ hex }` (with an opacity beside it), or a color with fields beside its own (react-color stored a
+ * `hex`). Only the first is a stored color (`isStoredColor`); the field stores that shape whenever it edits any of
+ * them, even when the edit leaves the color as it was. A host passes the value as it is stored, not converted.
+ */
+export type TColorFormFieldInput = IColorFormFieldValue | (IColorFormFieldValue & Record<string, unknown>) | {
+    hex: string;
+    a?: number;
+} | string;
+/** A color offered as a swatch: a hex color, or one with a name to read it by. */
+export type TColorPreset = string | {
+    color: string;
+    title?: string;
+};
+/**
+ * The words of the color field. A host that translates its interface passes its own; English where it
+ * does not. A text that holds a value is a function of it, so a host keeps its language's word order.
+ */
+export interface IColorFormFieldLabels {
+    hex: string;
+    red: string;
+    green: string;
+    blue: string;
+    opacity: string;
+    /** The square in which the color's strength and brightness are chosen. */
+    area: string;
+    hue: string;
+    /** What the preview says of the color, for a screen reader. */
+    preview: (hex: string, opacityPercent: number) => string;
+    /** What the preview says when the field holds no color yet. */
+    noColor: string;
+    /** The button that shows and hides what the controls mean. */
+    help: string;
+    helpArea: string;
+    helpHex: string;
+    helpChannels: string;
+    helpOpacity: string;
+    /** A swatch's name, for a screen reader: the color it picks. */
+    swatch: (title: string) => string;
+    /** Characters typed into a hex code that cannot be in one. */
+    notHex: (characters: string) => string;
+    /** Characters typed into a number that cannot be in one. */
+    notDigits: (characters: string, field: string) => string;
+    /** A hex code too long to be one. */
+    hexTooLong: string;
+    /** A hex code of the wrong length. */
+    hexLength: (text: string) => string;
+    /** A hex code left empty. */
+    hexEmpty: string;
+    /** A number past its field's range. */
+    outOfRange: (field: string, max: number) => string;
+    /** A number field left empty. */
+    empty: (field: string, max: number) => string;
+}
+export declare const DEFAULT_COLOR_FORM_FIELD_LABELS: IColorFormFieldLabels;
+/** The colors offered as swatches when a host offers none of its own. */
+export declare const DEFAULT_COLOR_PRESETS: TColorPreset[];
+export interface IColorFormFieldProps {
+    /** The value as it is stored: see `TColorFormFieldInput`. */
+    value?: TColorFormFieldInput;
+    onChange?: (value: Required<IColorFormFieldValue>) => void;
     disabled?: boolean;
     readOnly?: boolean;
+    /** Leave out the transparency slider and keep the stored transparency (the default). */
+    disableAlpha?: boolean;
+    /** The swatches offered, or `false` for none. */
+    presetColors?: false | TColorPreset[];
+    className?: string;
+    /** The field's words, for a host that translates them. */
+    labels?: Partial<IColorFormFieldLabels>;
 }
-export declare const StyledSketchPicker: any;
-export declare const ColorFormField: ({ value, onChange, disabled, readOnly, ...rest }: IColorFormFieldProps) => import("react/jsx-runtime").JSX.Element;
+/**
+ * A stored color as red, green, blue and alpha: `{ r, g, b, a? }` as the field stores it, or a hex color,
+ * bare or as `{ hex }`, as a value written by hand or by another client can be. Undefined when it is none
+ * of these. A channel past its range is brought into it, so what is shown, and stored from it, is a color.
+ * Only `{ r, g, b, a? }` is a stored color (`isStoredColor`); the others are read so they can be seen and fixed.
+ */
+export declare const colorToRgba: (value: unknown) => RgbaColor | undefined;
+/** A finger's target: the smallest a control should be on a touch screen. */
+export declare const TAP_TARGET_PX = 44;
+export declare const StyledColorField: any;
+/**
+ * The `rgbcolor` field: a color picker that stores `{ r, g, b, a }`.
+ *
+ * It is drawn from the `@uiw` picker's parts - the color square, the hue bar and the opacity bar - and
+ * around them the field's own: a preview of the color, its hex code and its red, green, blue (and
+ * opacity) as labelled inputs that take only what a color can be, a "What do these mean?" help, and
+ * swatches. On a touch screen every target is a finger's size.
+ *
+ * The picker works in hue, saturation and value, and a stored color is red, green and blue. A color the
+ * picker sent comes back as the field's value, and turned back into hue it can lose what the picker had:
+ * a grey has no hue, so moving the saturation to a grey would throw the hue bar back to red. So the color
+ * the picker last showed is kept with the color it sent, and only a value that changed somewhere else is
+ * converted.
+ */
+export declare const ColorFormField: ({ value, onChange, disabled, readOnly, disableAlpha, presetColors, className, labels, }: IColorFormFieldProps) => import("react/jsx-runtime").JSX.Element;
 export default ColorFormField;
 //# sourceMappingURL=Color.d.ts.map

package/dist/components/form/fields/color/Color.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Color.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/fields/color/Color.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAgB,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAG9D,MAAM,WAAW,oBAAqB,SAAQ,IAAI,CAAC,iBAAiB,EAAE,UAAU,GAAG,kBAAkB,CAAC;IACpG,KAAK,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACxD,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IAC3E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,eAAO,MAAM,kBAAkB,KAqB9B,CAAC;AAEF,eAAO,MAAM,cAAc,qDAAsD,oBAAoB,4CAUpG,CAAC;AAEF,eAAe,cAAc,CAAC"}
+{"version":3,"file":"Color.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/fields/color/Color.tsx"],"names":[],"mappings":"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"}