@kwiz/fluentui 1.0.202 → 1.0.203

package/README.md

@@ -1,53 +1,228 @@
-# fluentui
+# About @kwiz/fluentui
 
-For local debugging, if you plan to use `npm link` - there is a known issue with react that will potentially break your application.
+@kwiz/fluentui is a set of enhanced controls built for and on top of `@fluentui/react-components` (https://storybooks.fluentui.dev/react)
 
-To fix that, you must mark react and fluentui imports as external.
-The best way of doing it is using webpack to build your app, and adding this:
-```json
-resolve: {
-    ...
-    modules: [path.resolve(__dirname, 'node_modules'), 'node_modules']//important! needed for @kwiz/fluentui to work correctly when linked
-}
+It adds a few key components, some very powerful and some simple wrappers to make the library easier to render in rapid dev.
+
+
+
+# Key components
+
+### Containers
+
+#### Section
+
+Renders a simple div with ease.
+
+Properties:
+
+1. **main**: make this grow to fill space in a stackable component
+2. **css**: pass a string array of a makeStyles/useStyles classes
+
+#### Vertical
+
+A simple vertical flex box stackable
+
+#### Horizontal
+
+A simple horizontal flex box stackable
+
+#### Stack
+
+A simple vertical/horizontal flex box stackable
+
+### Data viewers
+
+#### Table
+
+A powerful strongly typed table control with sort, filter, sticky headers and sticker left 1/2 columns.
+
+Provide an item level menu, and easy selection controls.
+
+#### ListEx
+
+Display items using a list control
+
+#### AccordionEX
+
+Display data in a collapsible accordion
+
+### QRCodeEX
+
+Render a QR code for a specific string value (usually, a URL)
+
+### KWIZOverflowV2
+
+A much better, more stable implementation of the overflow concept in the original library.
+
+Render items horizontally or vertically in an overflow hidden zone to automatically collapse overflow items in a menu.
+
+### Inputs
+
+#### InputEx
+
+enhanced input control
+
+#### InputNumberEx
+
+enhanced input number control with built in validations
+
+#### TextAreaEx
+
+enhanced text area input control
+
+#### FileUpload
+
+Render a file upload button with a drop file option
+
+#### DatePickerEx
+
+A date picker wrapped nicely
+
+#### CodeEditor
+
+An implementation wrapper of `monaco-editor`
+
+### FileTypeIcon
+
+Render an icon for a file type
+
+### DropdownEX
+
+Strongly typed dropdown control
+
+### Buttons
+
+A collection of `ButtonEX` controls and `CompoundButtonEX` controls wrapping and enhancing the original button control.
+
+ButtonEX, ButtonEXSecondary, ButtonEXMessageBarAction, ButtonEXPrimary, ButtonEXDanger, ButtonEXSuccess, ButtonEXPrimarySubtle, ButtonEXDangerSubtle
+
+CompoundButtonEX, CompoundButtonEXSecondary, CompoundButtonEXPrimary, CompoundButtonEXDanger
+
+#### DrawPad
+
+A canvas control
+
+
+
+# Key hooks
+
+## useDraggable
+
+create a drag / drop context on an element, provide the element ref via dragDropRef like this:
+
+```jsx
+const dropContext = useDragDropContext<..., ...>({...});
+...
+<Vertical main ref={(v) => {
+    dropContext.dragDropRef(v);
+}}>
 ```
 
-Otherwise during dev, you'll have to link the react package in this project to load the react from node_modules in your caller application. For example:
+Next, you can show "drop here" UI using markers like this:
 
+```tsx
+{dropContext.drop.isOver && <div>drop here!</div>}
 ```
-npm link ..\\test-project\\node_modules\\react\\  ..\\..test-project\\node_modules\\@types\\react\\
+
+a useDragDropContext must be added to all draggable items (or files), and to all droppable zones, explaining what they allow to drag / drop.
+
+## useTrackFocus
+
+## useWindowSize
+
+## useElementSize
+
+## useIsInPrint
+
+## useKeyDown
+
+## useStateEX
+
+set state on steroids. provide promise callback after render, onChange transformer and automatic skip-set when value not change
+
+## useRefWithState
+
+use a ref, that can be tracked as useEffect dependency
+
+## useClickableDiv
+
+return props to make div appear as clickable, and accept enter key as click
+
+## useAlerts
+
+Easily prompt, confirm or alert the user. To use this you must render the alertPrompt in your element.
+## useAutoFocusEX
+
+better auto-focus that actually works. use the ref on the element you wish to focus.
+
+focus set initially, and then again on a timeout - default is 200ms timeout. send 0 to skip the timeout
+
+## **useControlledStateTracker**
+
+track an input control if it was changed from a managed to unmanaged (controlled / uncontrolled) state between renders.
+
+for example, if you pass a value on first render, but a defaultValue on a following render.
+
+## **useHighlight**
+
+returns a function you can call to make an element glow momentarily
+
+## useIsConcurrent
+
+ Call at the beginning of a useEffect, check after all your promises finished before applying results to state.
+ You must keep the same name for each useEffect
+
+```jsx
+const {getConcurrency} = useIsConcurrent();
+useEffect(()=>{
+     const c = getConcurrency('loading data');
+     const result = await someSlowPromise();
+     if( c.isCurrent() ) setData(result);
+},[]);
 ```
 
-To successfully use these controls you should create a context, and wrapt it in a drag/drop provider.
+## useReloadTracker
+
+A simple reload marker, can be used as a dependency, and called as a function
+
+Powerful load/reload/progress management with multiple scopes
+
+## useShowOnHover
+
+Easily show content only on hover
+
+## useToast
+
+## useTrackChanges
+
+Provides useful helpers for tracking if control has changes, and handling the save changes with progress bar and on success/fail messages.
+
+# Usage details
+
+## Debugging
+
+For local debugging, use `yalc-link` to register the project, and `watch` to build and push.
+
+Caller projects should use `yalc add @kwiz/fluentui` to link up your local project.
+
+This will make sure both projects use the same instance of react.
+
+## Using the project controls
+
+To successfully use these controls you should create a context, and wrap it in a drag/drop provider.
 
 We recommend using the provider control:
 
-```ts
+```tsx
 <KWIZFluentProvider ctx={{ buttonShape: "rounded" }}>
+    <IdPrefixProvider value="my-project">
     <FluentProvider theme={webLightTheme}>
       {content}
     </FluentProvider>
+    </IdPrefixProvider>
 </KWIZFluentProvider>
 
 ```
 
-Or you can use the following code:
-
-```ts
-// it is no longer needed to send in a root node const root = React.useRef<HTMLDivElement>(null);
-const { KWIZFluentContext, value: kwizFluentContext } =
-  useKWIZFluentContextProvider({
-    ctx: {
-      buttonShape: "rounded",
-    },
-    //root,
-  });
-
-//...
-<KWIZFluentContext.Provider value={kwizFluentContext}>
-  <DragDropContextProvider>
-    <FluentProvider theme={webLightTheme} /*ref={root}*/>
-      {content}
-    </FluentProvider>
-  </DragDropContextProvider>
-</KWIZFluentContext.Provider>;
-```
+

package/dist/helpers/drag-drop/drag-drop-context.d.ts

@@ -1,5 +1,6 @@
 import React from "react";
 import { iDragDropContext, iDraggableProps, iDraggedItemType, iDroppableProps } from "./drag-drop.types";
+/** */
 export declare function useDragDropContext<DragItemType extends iDraggedItemType<string> = never, DropInfoType extends iDroppableProps<string, any> = never>(info: {
     dragInfo?: iDraggableProps<DragItemType>;
     dropInfo?: DropInfoType;

package/dist/helpers/drag-drop/drag-drop-context.js

@@ -6,6 +6,7 @@ import { useStateEX } from "../hooks";
 import { DragDropContext, useDragDropContextInternal } from "./drag-drop-context-internal";
 import { useDraggable } from "./use-draggable";
 import { useDroppable } from "./use-droppable";
+/** */
 export function useDragDropContext(info) {
     const dragDropContext = useDragDropContextInternal();
     const isDraggable = !isNullOrUndefined(info.dragInfo);

package/dist/helpers/drag-drop/drag-drop-context.js.map

@@ -1 +1 @@
-{"version":3,"file":"drag-drop-context.js","sourceRoot":"","sources":["../../../src/helpers/drag-drop/drag-drop-context.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,eAAe,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAE3F,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,MAAM,UAAU,kBAAkB,CAGhC,IAGD;IACG,MAAM,eAAe,GAAG,0BAA0B,EAAE,CAAC;IACrD,MAAM,WAAW,GAAG,CAAC,iBAAiB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACtD,MAAM,WAAW,GAAG,CAAC,iBAAiB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACtD,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,QAAQ,CAAC,CAAC;IAC1C,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,QAAQ,CAAC,CAAC;IAC1C,MAAM,aAAa,GAAG,WAAW,IAAI,CAAC,IAAI,CAAC,UAAU,IAAI,eAAe,CAAC,UAAU;QAC/E,2DAA2D;WACxD,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,OAAO,CAAC,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAE7E,OAAO;QACH,eAAe;QACf,IAAI;QACJ,IAAI;QACJ,6DAA6D;QAC7D,aAAa;QACb,WAAW,EAAE,WAAW,IAAI,CAAC,WAAW;YACpC,CAAC,CAAC,IAAI,CAAC,OAAO;YACd,CAAC,CAAC,CAAC,WAAW,IAAI,WAAW;gBACzB,CAAC,CAAC,IAAI,CAAC,OAAO;gBACd,4BAA4B;gBAC5B,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO;KACxD,CAAC;AACN,CAAC;AACD,MAAM,UAAU,0BAA0B;IACtC,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,UAAU,CAA2B,IAAI,CAAC,CAAC;IAE3E,eAAe;IACf,MAAM,GAAG,GAAqB;QAC1B,UAAU,EAAE,CAAC,iBAAiB,CAAC,QAAQ,CAAC;QACxC,QAAQ,EAAE,WAAW;KACxB,CAAC;IAEF,OAAO,GAAG,CAAC;AACf,CAAC;AAID,MAAM,CAAC,MAAM,uBAAuB,GAA6D,CAAC,KAAK,EAAE,EAAE;IACvG,MAAM,QAAQ,GAAG,0BAA0B,EAAE,CAAC;IAC9C,OAAO,KAAC,eAAe,CAAC,QAAQ,IAAC,KAAK,EAAE,QAAQ,YAC5C,KAAC,WAAW,IAAC,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,YAC9C,KAAK,CAAC,QAAQ,GACL,GACS,CAAC;AAChC,CAAC,CAAA"}
+{"version":3,"file":"drag-drop-context.js","sourceRoot":"","sources":["../../../src/helpers/drag-drop/drag-drop-context.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,eAAe,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAE3F,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,MAAM;AACN,MAAM,UAAU,kBAAkB,CAGhC,IAGD;IACG,MAAM,eAAe,GAAG,0BAA0B,EAAE,CAAC;IACrD,MAAM,WAAW,GAAG,CAAC,iBAAiB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACtD,MAAM,WAAW,GAAG,CAAC,iBAAiB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACtD,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,QAAQ,CAAC,CAAC;IAC1C,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,QAAQ,CAAC,CAAC;IAC1C,MAAM,aAAa,GAAG,WAAW,IAAI,CAAC,IAAI,CAAC,UAAU,IAAI,eAAe,CAAC,UAAU;QAC/E,2DAA2D;WACxD,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,OAAO,CAAC,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAE7E,OAAO;QACH,eAAe;QACf,IAAI;QACJ,IAAI;QACJ,6DAA6D;QAC7D,aAAa;QACb,WAAW,EAAE,WAAW,IAAI,CAAC,WAAW;YACpC,CAAC,CAAC,IAAI,CAAC,OAAO;YACd,CAAC,CAAC,CAAC,WAAW,IAAI,WAAW;gBACzB,CAAC,CAAC,IAAI,CAAC,OAAO;gBACd,4BAA4B;gBAC5B,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO;KACxD,CAAC;AACN,CAAC;AACD,MAAM,UAAU,0BAA0B;IACtC,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,UAAU,CAA2B,IAAI,CAAC,CAAC;IAE3E,eAAe;IACf,MAAM,GAAG,GAAqB;QAC1B,UAAU,EAAE,CAAC,iBAAiB,CAAC,QAAQ,CAAC;QACxC,QAAQ,EAAE,WAAW;KACxB,CAAC;IAEF,OAAO,GAAG,CAAC;AACf,CAAC;AAID,MAAM,CAAC,MAAM,uBAAuB,GAA6D,CAAC,KAAK,EAAE,EAAE;IACvG,MAAM,QAAQ,GAAG,0BAA0B,EAAE,CAAC;IAC9C,OAAO,KAAC,eAAe,CAAC,QAAQ,IAAC,KAAK,EAAE,QAAQ,YAC5C,KAAC,WAAW,IAAC,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,YAC9C,KAAK,CAAC,QAAQ,GACL,GACS,CAAC;AAChC,CAAC,CAAA"}

package/dist/helpers/use-alerts.d.ts

@@ -21,10 +21,6 @@ export interface iAlerts {
     alertPrompt?: JSX.Element;
     close: () => void;
 }
-/** set block message if you want to block nav.
- * - call setMessage to  add a blocker message
- * - call onNav when you have internal navigation (open / close popups)
- * - render the navPrompt control to your page
- * FYI for page unload, most modern browsers won't show your message but a generic one instead. */
+/** Easily prompt, confirm or alert the user. To use this you must render the alertPrompt in your element. */
 export declare function useAlerts(): iAlerts;
 export {};

package/dist/helpers/use-alerts.js

@@ -16,11 +16,7 @@ import { useEffectOnlyOnMount, useStateEX } from "./hooks";
 function isConfirmOptions(param) {
     return isFunction(param) ? false : true;
 }
-/** set block message if you want to block nav.
- * - call setMessage to  add a blocker message
- * - call onNav when you have internal navigation (open / close popups)
- * - render the navPrompt control to your page
- * FYI for page unload, most modern browsers won't show your message but a generic one instead. */
+/** Easily prompt, confirm or alert the user. To use this you must render the alertPrompt in your element. */
 export function useAlerts() {
     const [_prompt, _setPrompt] = useStateEX(null);
     const promptEX = useCallback((info) => {

package/dist/helpers/use-alerts.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-alerts.js","sourceRoot":"","sources":["../../src/helpers/use-alerts.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"use-alerts.js","sourceRoot":"","sources":["../../src/helpers/use-alerts.tsx"],"names":[],"mappings":"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"}

package/dist/helpers/use-controlled-state-tracker.d.ts

@@ -1,3 +1,5 @@
+/** track an input control if it was changed from a managed to unmanaged (controlled / uncontrolled) state between renders.
+for example, if you pass a value on first render, but a defaultValue on a following render. */
 export declare function useControlledStateTracker<ValueType>(props: {
     name: string;
     value?: ValueType;

package/dist/helpers/use-controlled-state-tracker.js

@@ -1,6 +1,8 @@
 import { CommonLogger, isUndefined } from "@kwiz/common";
 import { useEffect, useState } from "react";
 const logger = new CommonLogger("useControlledStateTracker");
+/** track an input control if it was changed from a managed to unmanaged (controlled / uncontrolled) state between renders.
+for example, if you pass a value on first render, but a defaultValue on a following render. */
 export function useControlledStateTracker(props) {
     const [isUnControlled, setIsUnControlled] = useState(!isUndefined(props.defaultValue));
     const __isUnControlled = !isUndefined(props.defaultValue);

package/dist/helpers/use-controlled-state-tracker.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-controlled-state-tracker.js","sourceRoot":"","sources":["../../src/helpers/use-controlled-state-tracker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAE5C,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,2BAA2B,CAAC,CAAC;AAE7D,MAAM,UAAU,yBAAyB,CAAY,KAAoE;IACrH,MAAM,CAAC,cAAc,EAAE,iBAAiB,CAAC,GAAG,QAAQ,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC;IAEvF,MAAM,gBAAgB,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IAC1D,SAAS,CAAC,GAAG,EAAE;QACX,IAAI,gBAAgB,KAAK,cAAc,EAAE,CAAC;YACtC,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,IAAI,oFAAoF,CAAC,CAAC;YAChH,iBAAiB,CAAC,gBAAgB,CAAC,CAAC;YACpC,IAAI,CAAC,gBAAgB,EAAE,CAAC;gBACpB,uBAAuB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACzC,CAAC;QACL,CAAC;IACL,CAAC,EAAE,CAAC,gBAAgB,EAAE,cAAc,CAAC,CAAC,CAAC;IAEvC,MAAM,CAAC,oBAAoB,EAAE,uBAAuB,CAAC,GAAG,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAEpH,MAAM,UAAU,GAAG,cAAc,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC;IACvE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,uBAAuB,EAAE,CAAC;AAC7D,CAAC"}
+{"version":3,"file":"use-controlled-state-tracker.js","sourceRoot":"","sources":["../../src/helpers/use-controlled-state-tracker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAE5C,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,2BAA2B,CAAC,CAAC;AAE7D;8FAC8F;AAC9F,MAAM,UAAU,yBAAyB,CAAY,KAAoE;IACrH,MAAM,CAAC,cAAc,EAAE,iBAAiB,CAAC,GAAG,QAAQ,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC;IAEvF,MAAM,gBAAgB,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IAC1D,SAAS,CAAC,GAAG,EAAE;QACX,IAAI,gBAAgB,KAAK,cAAc,EAAE,CAAC;YACtC,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,IAAI,oFAAoF,CAAC,CAAC;YAChH,iBAAiB,CAAC,gBAAgB,CAAC,CAAC;YACpC,IAAI,CAAC,gBAAgB,EAAE,CAAC;gBACpB,uBAAuB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACzC,CAAC;QACL,CAAC;IACL,CAAC,EAAE,CAAC,gBAAgB,EAAE,cAAc,CAAC,CAAC,CAAC;IAEvC,MAAM,CAAC,oBAAoB,EAAE,uBAAuB,CAAC,GAAG,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAEpH,MAAM,UAAU,GAAG,cAAc,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC;IACvE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,uBAAuB,EAAE,CAAC;AAC7D,CAAC"}

package/dist/helpers/use-highlight.d.ts

@@ -1,3 +1,4 @@
+/** returns a function you can call to make an element glow momentarily */
 export declare function useHighlight(): {
     highlight: (e: HTMLElement, options?: {
         /** highlight text or the box */

package/dist/helpers/use-highlight.js

@@ -27,6 +27,7 @@ const useStyles = makeStyles({
             0 0 40px ${tokens.colorStatusWarningBorderActive}`
     }
 });
+/** returns a function you can call to make an element glow momentarily */
 export function useHighlight() {
     const css = useStyles();
     return {

package/dist/helpers/use-highlight.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-highlight.js","sourceRoot":"","sources":["../../src/helpers/use-highlight.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAEhE,MAAM,SAAS,GAAG,UAAU,CAAC;IACzB,WAAW,EAAE;QACT,UAAU,EAAE,8BAA8B;KAC7C;IACD,SAAS,EAAE;QACP,UAAU,EACN,YAAY,MAAM,CAAC,8BAA8B;uBACtC,MAAM,CAAC,8BAA8B;uBACrC,MAAM,CAAC,8BAA8B;uBACrC,MAAM,CAAC,8BAA8B,EAAE;KACzD;IACD,aAAa,EAAE;QACX,UAAU,EACN,YAAY,MAAM,CAAC,8BAA8B;uBACtC,MAAM,CAAC,8BAA8B;uBACrC,MAAM,CAAC,8BAA8B;uBACrC,MAAM,CAAC,8BAA8B,EAAE;KACzD;IACD,cAAc,EAAE;QACZ,UAAU,EAAE,6BAA6B;KAC5C;IACD,YAAY,EAAE;QACV,SAAS,EACL,YAAY,MAAM,CAAC,8BAA8B;uBACtC,MAAM,CAAC,8BAA8B,EAAE;KACzD;IACD,gBAAgB,EAAE;QACd,SAAS,EACL,YAAY,MAAM,CAAC,8BAA8B;uBACtC,MAAM,CAAC,8BAA8B,EAAE;KACzD;CACJ,CAAC,CAAC;AACH,MAAM,UAAU,YAAY;IAYxB,MAAM,GAAG,GAAG,SAAS,EAAE,CAAC;IAExB,OAAO;QACH,SAAS,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;YAClB,IAAI,GAAG,IAAI,GAAG,CAAC,SAAS,EAAE,CAAC;gBACvB,MAAM,SAAS,GAAG,CAAC,CAAA,CAAC,aAAD,CAAC,uBAAD,CAAC,CAAE,IAAI,MAAK,KAAK;oBAChC,CAAC,CAAC,CAAA,CAAC,aAAD,CAAC,uBAAD,CAAC,CAAE,MAAM,MAAK,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC,GAAG,CAAC,YAAY;oBAChE,CAAC,CAAC,CAAA,CAAC,aAAD,CAAC,uBAAD,CAAC,CAAE,MAAM,MAAK,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;gBAC3E,MAAM,SAAS,GAAG,CAAC,CAAA,CAAC,aAAD,CAAC,uBAAD,CAAC,CAAE,IAAI,MAAK,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;gBAExF,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,CAAC,CAAA,mBAAmB;gBAEnD,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE;oBACnB,GAAG,aAAH,GAAG,uBAAH,GAAG,CAAE,SAAS,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,CAAA;gBACpC,CAAC,EAAE,CAAA,CAAC,aAAD,CAAC,uBAAD,CAAC,CAAE,OAAO,IAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;gBAC7C,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE;oBACnB,GAAG,aAAH,GAAG,uBAAH,GAAG,CAAE,SAAS,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC,CAAA;gBACvC,CAAC,EAAE,CAAA,CAAC,aAAD,CAAC,uBAAD,CAAC,CAAE,QAAQ,IAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YACnD,CAAC;QACL,CAAC;KACJ,CAAA;AACL,CAAC"}
+{"version":3,"file":"use-highlight.js","sourceRoot":"","sources":["../../src/helpers/use-highlight.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAEhE,MAAM,SAAS,GAAG,UAAU,CAAC;IACzB,WAAW,EAAE;QACT,UAAU,EAAE,8BAA8B;KAC7C;IACD,SAAS,EAAE;QACP,UAAU,EACN,YAAY,MAAM,CAAC,8BAA8B;uBACtC,MAAM,CAAC,8BAA8B;uBACrC,MAAM,CAAC,8BAA8B;uBACrC,MAAM,CAAC,8BAA8B,EAAE;KACzD;IACD,aAAa,EAAE;QACX,UAAU,EACN,YAAY,MAAM,CAAC,8BAA8B;uBACtC,MAAM,CAAC,8BAA8B;uBACrC,MAAM,CAAC,8BAA8B;uBACrC,MAAM,CAAC,8BAA8B,EAAE;KACzD;IACD,cAAc,EAAE;QACZ,UAAU,EAAE,6BAA6B;KAC5C;IACD,YAAY,EAAE;QACV,SAAS,EACL,YAAY,MAAM,CAAC,8BAA8B;uBACtC,MAAM,CAAC,8BAA8B,EAAE;KACzD;IACD,gBAAgB,EAAE;QACd,SAAS,EACL,YAAY,MAAM,CAAC,8BAA8B;uBACtC,MAAM,CAAC,8BAA8B,EAAE;KACzD;CACJ,CAAC,CAAC;AACH,0EAA0E;AAC1E,MAAM,UAAU,YAAY;IAYxB,MAAM,GAAG,GAAG,SAAS,EAAE,CAAC;IAExB,OAAO;QACH,SAAS,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;YAClB,IAAI,GAAG,IAAI,GAAG,CAAC,SAAS,EAAE,CAAC;gBACvB,MAAM,SAAS,GAAG,CAAC,CAAA,CAAC,aAAD,CAAC,uBAAD,CAAC,CAAE,IAAI,MAAK,KAAK;oBAChC,CAAC,CAAC,CAAA,CAAC,aAAD,CAAC,uBAAD,CAAC,CAAE,MAAM,MAAK,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC,GAAG,CAAC,YAAY;oBAChE,CAAC,CAAC,CAAA,CAAC,aAAD,CAAC,uBAAD,CAAC,CAAE,MAAM,MAAK,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;gBAC3E,MAAM,SAAS,GAAG,CAAC,CAAA,CAAC,aAAD,CAAC,uBAAD,CAAC,CAAE,IAAI,MAAK,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;gBAExF,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,CAAC,CAAA,mBAAmB;gBAEnD,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE;oBACnB,GAAG,aAAH,GAAG,uBAAH,GAAG,CAAE,SAAS,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,CAAA;gBACpC,CAAC,EAAE,CAAA,CAAC,aAAD,CAAC,uBAAD,CAAC,CAAE,OAAO,IAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;gBAC7C,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE;oBACnB,GAAG,aAAH,GAAG,uBAAH,GAAG,CAAE,SAAS,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC,CAAA;gBACvC,CAAC,EAAE,CAAA,CAAC,aAAD,CAAC,uBAAD,CAAC,CAAE,QAAQ,IAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YACnD,CAAC;QACL,CAAC;KACJ,CAAA;AACL,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@kwiz/fluentui",
-    "version": "1.0.202",
+    "version": "1.0.203",
     "description": "KWIZ common controls for FluentUI",
     "module": "dist/index.js",
     "types": "dist/index.d.ts",