esp-js-react 8.0.3-next.0 → 8.0.4-next.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.dist/esp-react.js +39 -47
- package/.dist/esp-react.js.map +1 -1
- package/.dist/esp-react.min.js +1 -1
- package/.dist/esp-react.min.js.map +1 -1
- package/.dist/typings/espModelContextProvider.d.ts +3 -5
- package/.dist/typings/index.d.ts +2 -2
- package/.dist/typings/{useModelSelector.d.ts → useSyncModelWithSelector.d.ts} +9 -10
- package/package.json +4 -4
- package/src/connectableComponent.tsx +3 -3
- package/src/espModelContextProvider.tsx +7 -40
- package/src/index.ts +6 -9
- package/src/{useModelSelector.ts → useSyncModelWithSelector.ts} +27 -20
- package/tests/indexTests.ts +2 -2
- package/tests/{useModelSelectorTests.tsx → useSyncModelWithSelectorTests.tsx} +46 -14
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"esp-react.min.js","mappings":"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","sources":["webpack://esp-js-react/webpack/universalModuleDefinition","webpack://esp-js-react/../../node_modules/use-sync-external-store/cjs/use-sync-external-store-with-selector.production.min.js","webpack://esp-js-react/../../node_modules/use-sync-external-store/with-selector.js","webpack://esp-js-react/./src/connect.tsx","webpack://esp-js-react/./src/connectableComponent.tsx","webpack://esp-js-react/./src/espModelContextProvider.tsx","webpack://esp-js-react/./src/espRouterContextProvider.tsx","webpack://esp-js-react/./src/polimer/getEspPolimerImmutableModel.ts","webpack://esp-js-react/./src/polimer/polimerModelBuilderExtentsions.ts","webpack://esp-js-react/./src/useModelSelector.ts","webpack://esp-js-react/./src/viewBinder.tsx","webpack://esp-js-react/./src/viewBindingDecorator.ts","webpack://esp-js-react/external umd \"esp-js\"","webpack://esp-js-react/external umd \"esp-js-polimer\"","webpack://esp-js-react/external umd \"react\"","webpack://esp-js-react/webpack/bootstrap","webpack://esp-js-react/./src/index.ts"],"sourcesContent":["(function webpackUniversalModuleDefinition(root, factory) {\n\tif(typeof exports === 'object' && typeof module === 'object')\n\t\tmodule.exports = factory(require(\"esp-js\"), require(\"esp-js-polimer\"), require(\"react\"));\n\telse if(typeof define === 'function' && define.amd)\n\t\tdefine([\"esp-js\", \"esp-js-polimer\", \"react\"], factory);\n\telse if(typeof exports === 'object')\n\t\texports[\"esp-js-react\"] = factory(require(\"esp-js\"), require(\"esp-js-polimer\"), require(\"react\"));\n\telse\n\t\troot[\"esp-js-react\"] = factory(root[\"esp-js\"], root[\"esp-js-polimer\"], root[\"react\"]);\n})(self, (__WEBPACK_EXTERNAL_MODULE__152__, __WEBPACK_EXTERNAL_MODULE__43__, __WEBPACK_EXTERNAL_MODULE__155__) => {\nreturn ","/**\n * @license React\n * use-sync-external-store-with-selector.production.min.js\n *\n * Copyright (c) Facebook, Inc. and its affiliates.\n *\n * This source code is licensed under the MIT license found in the\n * LICENSE file in the root directory of this source tree.\n */\n'use strict';var g=require(\"react\");function n(a,b){return a===b&&(0!==a||1/a===1/b)||a!==a&&b!==b}var p=\"function\"===typeof Object.is?Object.is:n,q=g.useSyncExternalStore,r=g.useRef,t=g.useEffect,u=g.useMemo,v=g.useDebugValue;\nexports.useSyncExternalStoreWithSelector=function(a,b,e,l,h){var c=r(null);if(null===c.current){var f={hasValue:!1,value:null};c.current=f}else f=c.current;c=u(function(){function a(a){if(!c){c=!0;d=a;a=l(a);if(void 0!==h&&f.hasValue){var b=f.value;if(h(b,a))return k=b}return k=a}b=k;if(p(d,a))return b;var e=l(a);if(void 0!==h&&h(b,e))return b;d=a;return k=e}var c=!1,d,k,m=void 0===e?null:e;return[function(){return a(b())},null===m?void 0:function(){return a(m())}]},[b,e,l,h]);var d=q(a,c[0],c[1]);\nt(function(){f.hasValue=!0;f.value=d},[d]);v(d);return d};\n","'use strict';\n\nif (process.env.NODE_ENV === 'production') {\n module.exports = require('./cjs/use-sync-external-store-with-selector.production.min.js');\n} else {\n module.exports = require('./cjs/use-sync-external-store-with-selector.development.js');\n}\n","import * as React from 'react';\nimport {ConnectableComponent, ConnectableComponentProps, CreatePublishEventProps, MapModelToProps} from './connectableComponent';\n\nexport type ConnectableComponentFactory<TModel, TPublishEventProps, TModelMappedToProps = {}> = (view: React.ComponentType) => (props: ConnectableComponentProps<TModel, TPublishEventProps, TModelMappedToProps>) => React.JSX.Element;\n\n/**\n * @param mapModelToProps - maps the model to a different structure, that structure is sent as props to the view.\n * @param createPublishEventProps - creates functions to publish events, the structure is sent as props to the view.\n */\nexport const connect = function <TModel, TPublishEventProps, TModelMappedToProps = {}>(\n mapModelToProps?: MapModelToProps<TModel, TModelMappedToProps, TPublishEventProps>,\n createPublishEventProps?: CreatePublishEventProps<TPublishEventProps>\n): ConnectableComponentFactory<TModel, TPublishEventProps, TModelMappedToProps> {\n return function (view: React.ComponentType) {\n return function (props: ConnectableComponentProps<TModel, TPublishEventProps, TModelMappedToProps>) {\n const {modelId, viewContext, ...rest} = props;\n return <ConnectableComponent\n modelId={modelId}\n view={view}\n viewContext={viewContext}\n createPublishEventProps={createPublishEventProps}\n mapModelToProps={mapModelToProps}\n {...rest}\n />;\n };\n };\n};","import * as React from 'react';\nimport {useRouter} from './espRouterContextProvider';\nimport {useMemo} from 'react';\nimport {Router, utils} from 'esp-js';\nimport {EspModelContextProvider, useGetModelId} from './espModelContextProvider';\nimport {createViewForModel} from './viewBindingDecorator';\nimport {tryGetPolimerImmutableModel} from './polimer/getEspPolimerImmutableModel';\nimport {modelSelectorOptions, useModelSelector} from './useModelSelector';\n\nexport type CreatePublishEventProps<TPublishEventProps> = (publishModelEvent: (eventType: string, event: any) => void) => TPublishEventProps;\n\nexport type MapModelToProps<TModel, TModelMappedToProps, TPublishEventProps = {}> = (model: TModel, publishEventProps: TPublishEventProps) => TModelMappedToProps;\n\nexport interface ConnectableComponentProps<TModel = {}, TPublishEventProps = {}, TModelMappedToProps = {}> {\n modelId?: string;\n viewContext?: string;\n view?: React.ComponentType;\n createPublishEventProps?: CreatePublishEventProps<TPublishEventProps>;\n mapModelToProps?: MapModelToProps<TModel, TModelMappedToProps, TPublishEventProps>;\n [key: string]: any; // ...rest props, including the result of mapPublish and mapPublish if 'connect' was used\n}\n\nexport interface ConnectableComponentChildProps<TModel = object> {\n modelId: string;\n model: TModel;\n router: Router;\n [key: string]: any; // ...rest props\n}\n\nconst getChildProps = <TModel, TModelMappedToProps, TPublishEventProps>(\n router: Router,\n modelId: string,\n restProps: object,\n initialModel: TModel,\n mapModelToProps: MapModelToProps<TModel, TModelMappedToProps, TPublishEventProps>,\n publishEventProps: TPublishEventProps\n): ConnectableComponentChildProps<TModel> => {\n const model = tryGetPolimerImmutableModel<TModel>(initialModel);\n let childProps = {\n modelId,\n router: router,\n ...restProps,\n ...publishEventProps,\n model\n };\n if (mapModelToProps) {\n childProps = {\n ...childProps,\n ...(mapModelToProps(model, publishEventProps) as TModelMappedToProps)\n };\n }\n return childProps;\n};\n\nexport const ConnectableComponent = <TModel = {}, TPublishEventProps = {}, TModelMappedToProps = {}>(\n {\n modelId,\n mapModelToProps,\n createPublishEventProps,\n view,\n viewContext,\n ...rest\n }: ConnectableComponentProps<TModel, TPublishEventProps, TModelMappedToProps>\n) => {\n const router = useRouter();\n modelId = modelId || useGetModelId();\n if (utils.stringIsEmpty(modelId) || !router) {\n return null;\n }\n const publishEventProps: TPublishEventProps = useMemo(\n () => {\n if (createPublishEventProps) {\n const publishModelEvent = (eventType: string, event: any) => {\n router.publishEvent(modelId, eventType, event);\n };\n return createPublishEventProps(publishModelEvent);\n }\n return {} as TPublishEventProps;\n },\n [router, modelId]\n );\n const model = useModelSelector<TModel, TModel>(\n m => m,\n modelSelectorOptions()\n .setModelId(modelId)\n .setTryPreSelectPolimerImmutableModel(false)\n );\n if (model == null) {\n return null;\n }\n let childProps = getChildProps(router, modelId, rest, model, mapModelToProps, publishEventProps);\n let viewElement = createViewForModel(model, childProps, viewContext, view);\n return (\n <EspModelContextProvider modelId={modelId} model={model} router={router} {...childProps}>\n {viewElement}\n </EspModelContextProvider>\n );\n};","import * as React from 'react';\nimport {DefaultModelAddress, Router, Status, Logger, utils} from 'esp-js';\nimport {useContext, useCallback, createContext, PropsWithChildren} from 'react';\nimport {useRouter} from './espRouterContextProvider';\n\nconst _log = Logger.create('EspModelContextProvider');\n\nexport type GetModelIdDelegate = () => string;\nexport const GetModelIdContext = createContext<GetModelIdDelegate>(null);\n/**\n * Returns a function to get the ID of the model connected at a higher point in the V-DOM.\n *\n * To use this, please ensure your V-DOM has the EspModelContextProvider at a higher node.\n */\nexport const useGetModelId = () => useContext(GetModelIdContext)();\n\nexport type GetModelDelegate = <TModel = any, >() => TModel;\nexport const GetModelContext = createContext<GetModelDelegate>(null);\n/**\n * Returns a function which will return the model connected at a higher point in the V-DOM.\n *\n * To use this, please ensure your V-DOM has the EspModelContextProvider at a higher node.\n */\nexport const useGetModel = <TModel,>() => useContext(GetModelContext)() as TModel;\n\nexport type PublishModelEventDelegate = (eventType: string, event: any) => void;\nexport const PublishModelEventContext = createContext<PublishModelEventDelegate>(null);\n/**\n * Returns a function which can be used to publish an event to the model connected at a higher point in the V-DOM.\n *\n * Effectively, this is a version of usePublishEvent() which closes over the relevant modelId.\n *\n * To use this, please ensure your V-DOM has the EspModelContextProvider at a higher node.\n */\nexport const usePublishModelEvent = () => useContext(PublishModelEventContext);\n\nexport type PublishModelEventWithEntityKeyDelegate = (entityKey: string, eventType: string, event: any) => void;\nexport const PublishModelEventWithEntityKeyContext = createContext<PublishModelEventWithEntityKeyDelegate>(null);\n/**\n * Returns a function which can be used to publish an event to the model connected at a higher point in the V-DOM, allows an entityKey to be specified.\n *\n * Effectively, this is a version of usePublishEvent() which closes over the modelId.\n *\n * To use this, please ensure your V-DOM has the EspModelContextProvider at a higher node.\n */\nexport const usePublishModelEventWithEntityKey = () => useContext(PublishModelEventWithEntityKeyContext);\n\nexport interface EspModelContextProviderProps {\n modelId: string;\n model?: unknown;\n}\n\n/**\n * Sets up various ESP context so ESP hooks are available below this point in the V-DOM\n *\n * To use this, please ensure your V-DOM has the EspRouterContextProvider at a higher node.\n * @param modelId\n * @param children\n * @param model\n * @constructor\n */\nexport const EspModelContextProvider = ({modelId, children, model}: PropsWithChildren<EspModelContextProviderProps>) => {\n const router = useRouter();\n const getModelId: () => string = useCallback(() => {\n return modelId;\n }, [router, modelId]);\n const getModel: () => any = useCallback(() => {\n warnIfModelAccessedOutSideDispatchLoop(router, modelId);\n return model;\n }, [model, router, modelId]);\n const publishModelEvent: PublishModelEventDelegate = useCallback((eventType: string, event: any) => {\n router.publishEvent(modelId, eventType, event);\n }, [router, modelId]);\n const publishModelEventWithEntityKey: PublishModelEventWithEntityKeyDelegate = useCallback((entityKey: string, eventType: string, event: any) => {\n router.publishEvent(new DefaultModelAddress(modelId, entityKey), eventType, event);\n }, [router, modelId]);\n return (\n <GetModelIdContext.Provider value={getModelId}>\n <PublishModelEventContext.Provider value={publishModelEvent}>\n <PublishModelEventWithEntityKeyContext.Provider value={publishModelEventWithEntityKey}>\n <GetModelContext.Provider value={getModel}>\n {children}\n </GetModelContext.Provider>\n </PublishModelEventWithEntityKeyContext.Provider>\n </PublishModelEventContext.Provider>\n </GetModelIdContext.Provider>\n );\n};\n\nconst warnIfModelAccessedOutSideDispatchLoop = (router: Router, modelId: string) => {\n if (process.env.NODE_ENV === 'production') {\n return;\n }\n if (utils.stringIsEmpty(modelId)) {\n return;\n }\n let isDispatchModelUpdateStatus = router.isModelDispatchStatus(modelId, Status.DispatchModelUpdates);\n if (!isDispatchModelUpdateStatus) {\n let stack: string | undefined = undefined;\n try {\n // noinspection ExceptionCaughtLocallyJS\n throw new Error();\n } catch (e) {\n stack = (e as Error).stack;\n }\n _log.warn(\n `EspModelContextProvider useGetModelId has been invoked outside of the models (${modelId}) dispatch loop. ` +\n `This may have unknown state issues.` +\n stack\n );\n }\n};","// notice_start\n/*\n * Copyright 2015 Dev Shop Limited\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n// notice_end\n\nimport * as React from 'react';\nimport {ModelAddress, Router} from 'esp-js';\nimport {PropsWithChildren, createContext, useContext, useCallback} from 'react';\n\nexport const RouterContext = createContext<Router>(null);\n\n/**\n * Get the esp Router from context.\n *\n * To use this, please ensure your V-DOM has the EspRouterContextProvider at a higher node:\n *\n * <EspRouterContextProvider router={router}>\n * <YourComponents />\n * </EspRouterContextProvider>\n */\nexport const useRouter = () => {\n const context: Router = useContext(RouterContext);\n if (context === undefined) {\n throw new Error('useRouter must be used within a RouterContext.Provider');\n }\n return context;\n};\n\nexport type PublishEventDelegate = (modelIdOrModelAddress: string | ModelAddress, eventType: string, event: any) => void;\nexport const PublishEventContext = createContext<PublishEventDelegate>(null);\n\n/**\n * Returns a function which can be used to publish an event.\n *\n * To use this, please ensure your V-DOM has the EspRouterContextProvider at a higher node:\n *\n * <EspRouterContextProvider router={router}>\n * <YourComponents />\n * </EspRouterContextProvider>\n */\nexport const usePublishEvent = () => useContext(PublishEventContext);\n\nexport type EspRouterContextProviderProps = PropsWithChildren<{ router: Router; }>;\n\n/**\n * Used to set the router on the RouterContext making it available to components down the tree via the useRouter() hook.\n *\n * Also sets up the usePublishEvent() hook so nested components can publish to the router.\n */\nexport const EspRouterContextProvider = ({children, router}: EspRouterContextProviderProps) => {\n const publishEvent: PublishEventDelegate = useCallback((modelIdOrModelAddress: string, eventType: string, event: any) => {\n router.publishEvent(modelIdOrModelAddress, eventType, event);\n }, [router]);\n return (\n <RouterContext.Provider value={router}>\n <PublishEventContext.Provider value={publishEvent}>\n {children}\n </PublishEventContext.Provider>\n </RouterContext.Provider>\n );\n};\n\n/**\n * Used to set the router on the RouterContext making it available to components down the tree (via useRouter()).\n *\n * @deprecated use EspRouterContextProvider\n */\nexport const RouterProvider = EspRouterContextProvider;\n\n/**\n * Props for RouterProvider\n *\n * @deprecated use EspRouterContextProviderProps\n */\nexport type RouterProviderProps = EspRouterContextProviderProps;\n","import {EspMetadata, EspDecoratorUtil, utils} from 'esp-js';\n\nexport interface GetEspPolimerImmutableModelMetadata {\n functionName: string;\n}\n\nexport namespace GetEspPolimerImmutableModelConsts {\n export const CustomDataKey = 'GetEspReactImmutableModelCustomDataKey';\n /**\n * If there is no @getEspPolimerImmutableModel decorator and a function by this name exists on a model, then it will be invoked to identify the sub model which will replaced the `model` prop passed to the child view of a ConnectableComponent\n */\n export const HandlerFunctionName = 'getEspPolimerImmutableModel';\n}\n\n/**\n * A decorator which can be used to identify the render model which will replaced the `model` prop passed to the child view of a ConnectableComponent\n */\nexport function getEspPolimerImmutableModel() {\n return function (target, name, descriptor) {\n let metadata: EspMetadata = EspDecoratorUtil.getOrCreateMetaData(target.constructor);\n metadata.addCustomData(\n GetEspPolimerImmutableModelConsts.CustomDataKey,\n <GetEspPolimerImmutableModelMetadata>{ functionName: name }\n );\n return descriptor;\n };\n}\n\n/**\n * Returns the model which will be used to pluck state/props for the current view.\n *\n * This is basically a hook (not a React 'hook') to call a function on `model` and get a new subgraph to use as state.\n *\n */\nexport const tryGetPolimerImmutableModel = <TImmutableModel>(model: any): TImmutableModel => {\n // does the given model have a decorated function we can invoke to get a different model to render?\n if (EspDecoratorUtil.hasMetadata(model)) {\n let metadata: GetEspPolimerImmutableModelMetadata = EspDecoratorUtil.getCustomData(model, GetEspPolimerImmutableModelConsts.CustomDataKey);\n if (metadata) {\n return model[metadata.functionName]();\n }\n }\n // else see if there is a function with name GetEspPolimerImmutableModelConsts.HandlerFunctionName we can invoke to get a different model to render?\n let immutableModel = model[GetEspPolimerImmutableModelConsts.HandlerFunctionName];\n if (immutableModel && utils.isFunction(immutableModel)) {\n return immutableModel.call(model);\n }\n // else return the initial model passed in\n return model;\n};","import {PolimerModelBuilder, PolimerModel} from 'esp-js-polimer';\nimport {DEFAULT_VIEW_KEY, viewBinding} from '../viewBindingDecorator';\n\ndeclare module 'esp-js-polimer/.dist/typings/modelBuilderUpdater' {\n export interface PolimerModelBuilder<TModel> {\n withViewBindings?(view: any, displayContext?: string): PolimerModelBuilder<TModel>;\n }\n}\n\ninterface ViewMappings {\n [displayContext: string]: any;\n}\n\nPolimerModelBuilder.prototype.withViewBindings = function (view: any, displayContext: string = DEFAULT_VIEW_KEY): PolimerModelBuilder<any> {\n let builder = this;\n // store some metadata on the builder which we'll use later to tack onto the model\n let viewMappings: ViewMappings = builder._viewMappings || { };\n viewMappings[displayContext] = view;\n builder._viewMappings = viewMappings;\n return this;\n};\n\n// we need to replace the registerWithRouter in order to dynamically add the\n// @viewBinding decorator to it\nlet registerWithRouter = PolimerModelBuilder.prototype.registerWithRouter;\nPolimerModelBuilder.prototype.registerWithRouter = function (): PolimerModel<any> {\n let builder = this;\n let model = registerWithRouter.call(builder);\n let viewMappings: ViewMappings = builder._viewMappings;\n if (viewMappings) {\n Object.keys(viewMappings).forEach(displayContext => {\n viewBinding(viewMappings[displayContext], displayContext)(model.constructor);\n });\n }\n return model;\n};\n","import {useMemo} from 'react';\nimport {useSyncExternalStoreWithSelector} from 'use-sync-external-store/with-selector';\nimport {Guard, utils} from 'esp-js';\nimport {useRouter} from './espRouterContextProvider';\nimport {useGetModelId} from './espModelContextProvider';\nimport {tryGetPolimerImmutableModel} from './polimer/getEspPolimerImmutableModel';\n\nexport type ModelSelectorEqualityFn<T> = (last: T, next: T) => boolean;\n\n/**\n * Options affecting the subscription of the model to the Router.\n *\n * Use modelSelectorOptions() to create an instance of this type with sensible defaults.\n *\n * @param modelId - the modelId of the model to be observed via the esp Router.\n * @param tryPreSelectPolimerImmutableModel - if true, and the esp model is an esp-js-polimer model, the immutable model will be used when calling the selector.\n * @param equalityFn - Equality function which will be applied against TSelected, defaults to instance equality (a === b).\n */\nexport type ModelSelectorOptions<TSelected> = {\n modelId?: string,\n tryPreSelectPolimerImmutableModel: boolean,\n equalityFn: ModelSelectorEqualityFn<TSelected>\n};\n\n/**\n * Convenience API to build ModelSelectorOptions<TSelected>, has sensible defaulting.\n */\nexport interface EditableModelSelectorOptions<TSelected> extends ModelSelectorOptions<TSelected> {\n /**\n * Sets the model ID\n * @param modelId - default if unset: undefined\n */\n setModelId(modelId: string): this;\n\n /**\n * If the model is a PolimerModel and this set true, PolimerModel.getImmutableModel() will be selected by default.\n * @param value - default if unset: true\n */\n setTryPreSelectPolimerImmutableModel(value: boolean): this;\n\n /**\n * Equality function used when comparing the last TSelected with the next.\n * @param fn - default if unset: obj instance equality (e.g. a===b)\n */\n setEqualityFn(fn: (a: TSelected, b: TSelected) => boolean): this;\n}\n\n/**\n * Convenience API to create ModelSelectorOptions\n */\nexport const modelSelectorOptions = <TSelected>() => {\n let modelId = undefined;\n let equalityFn: ModelSelectorEqualityFn<TSelected> = (a: TSelected, b: TSelected) => a === b;\n let tryPreSelectPolimerImmutableModel = true;\n return {\n get modelId() {\n return modelId;\n },\n setModelId(value: string) {\n modelId = value;\n return this;\n },\n get equalityFn() {\n return equalityFn;\n },\n setEqualityFn(value: ModelSelectorEqualityFn<TSelected>) {\n equalityFn = value;\n return this;\n },\n get tryPreSelectPolimerImmutableModel() {\n return tryPreSelectPolimerImmutableModel;\n },\n setTryPreSelectPolimerImmutableModel(value: boolean) {\n tryPreSelectPolimerImmutableModel = value;\n return this;\n }\n } as EditableModelSelectorOptions<TSelected>;\n};\n\n/**\n * A hook which returns model state from the esp Router.\n *\n * This hooks wih observe updates and re-render the component if the model changes.\n *\n * To use this, please ensure your V-DOM has the EspRouterContextProvider at a higher node, and optionally EspModelContextProvider.\n *\n * @param selector - a function to select a selection of the model - the selector does not need to be memoized, this selector will be cached against the modelId.\n * @param options\n */\nexport type UseModelSelector = <TModel, TSelected>(\n selector: (model: TModel) => TSelected,\n options?: ModelSelectorOptions<TSelected>\n) => TSelected;\n\nexport const useModelSelector: UseModelSelector = <TModel, TSelected>(\n selector: (model: TModel) => TSelected,\n options: ModelSelectorOptions<TSelected> = modelSelectorOptions<TSelected>()\n) => {\n Guard.isFunction(selector, 'You must pass a selector function to connectSelector');\n const router = useRouter();\n const modelId = options?.modelId || useGetModelId();\n const tryPreSelectPolimerImmutableModel = options?.tryPreSelectPolimerImmutableModel;\n const equalityFn = options?.equalityFn;\n const dependencies = useMemo(\n () => {\n // Because of how useSyncExternalStore works, there is an implicit dependency between the subscribe and getSnapshot functions.\n // When the subscription receives the new state from the Router, it can't pass this directly onto getSnapshot, React calls that when it deems it needs to.\n // Given that, we need to cache the state which getSnapshot will return.\n //\n // It's not ideal but shouldn't be a problem as here we've wrapped all these dependent functions inside a single useMemo()\n let model: TModel = null;\n return {\n subscribe: (stateChanged: () => void) => {\n const modelSubscriptionDisposable = router\n .getModelObservable(modelId)\n .subscribe(\n (m: any) => {\n // try and get a submodel to render\n const nextModel = tryPreSelectPolimerImmutableModel\n ? tryGetPolimerImmutableModel(m)\n : m;\n // if the above didn't manage to get a submodel,\n // we need to mutate to force useSyncExternalStoreWithSelector to pick up the change\n model = nextModel === m\n ? Object.create(nextModel)\n : nextModel;\n stateChanged();\n }\n );\n return () => {\n model = null;\n modelSubscriptionDisposable.dispose();\n };\n },\n // React expects getSnapshot to be immutable, it'll only re-render if the instance changes\n getSnapshot: () => {\n return model;\n },\n // While getSnapshot needs to model to be immutable,\n // useSyncExternalStoreWithSelector builds on top of this, so the TSelected can defer to an equality check to determine if the change is propagated.\n // The selector here just maps the TSelected, useSyncExternalStoreWithSelector internally does the equality check.\n wrappedSelector: (snapshot: TModel) => {\n // The first time this renders, react calls getSnapshot and the selector before the router has pushed a change.\n // In that case, there is no state for any component to process, therefore, we return null;\n return snapshot\n ? selector(snapshot)\n : null;\n }\n };\n },\n // Don't cache check against 'selector' argument as that will likely change unless the caller memoizes it.\n [router, modelId]\n );\n\n // If we don't have a modelId, we still need to return a hook so React doesn't complain.\n // Additionally, we need to let the above expiration (dependencies) run to unsubscribe from any previous subscription.\n if (utils.stringIsEmpty(modelId)) {\n return useSyncExternalStoreWithSelector(\n noopSubscription.subscribe,\n noopSubscription.getSnapshot,\n undefined,\n noopSubscription.wrappedSelector,\n equalityFn\n );\n }\n\n // Docs on useSyncExternalStore https://github.com/reactwg/react-18/discussions/86\n // Redux's usage of this: https://github.com/reduxjs/react-redux/blob/master/src/hooks/useSelector.ts\n // Code: https://github.com/facebook/react/blob/main/packages/use-sync-external-store/src/useSyncExternalStoreWithSelector.js\n return useSyncExternalStoreWithSelector(\n dependencies.subscribe,\n dependencies.getSnapshot,\n undefined,\n dependencies.wrappedSelector,\n equalityFn,\n );\n};\n\nconst noopSubscription = {\n subscribe: () => { },\n getSnapshot: () => null,\n wrappedSelector: () => true\n};","// notice_start\n/*\n * Copyright 2015 Dev Shop Limited\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n// notice_end\n\nimport * as React from 'react';\nimport {createViewForModel} from './viewBindingDecorator';\nimport {useRouter} from './espRouterContextProvider';\n\nexport interface ViewBinderProps {\n model: any;\n viewContext?: string;\n /**\n * ...rest props, these will be passed to the child\n */\n [key: string]: any;\n}\n\n/**\n * Takes a model with a @viewBinding decorator and dynamically crates the view specified by the decorator\n */\nexport const ViewBinder: React.FC<ViewBinderProps> = ({model, viewContext, ...rest}) => {\n if (model) {\n const router = useRouter();\n const newProps = {\n model,\n router,\n ...rest\n };\n return createViewForModel(\n model,\n newProps,\n viewContext,\n null\n );\n }\n return null;\n};","// notice_start\n/*\n * Copyright 2015 Dev Shop Limited\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n// notice_end\n\nimport * as React from 'react';\nimport {Guard} from 'esp-js';\n\nexport const DEFAULT_VIEW_KEY = 'default-view-key';\n\nfunction getMetadata(target) {\n if (!target._viewMetadata) {\n target._viewMetadata = new ViewMetadata();\n }\n return target._viewMetadata;\n}\n\n/**\n * Tries to get a view for the given model.\n *\n * It does this using the following order:\n * 1) If a @viewBinding decorator was used and a display context was given, try get a view for that\n * 2) Else if a view was explicitly provided use that\n * 3) Else if a @viewBinding decorator was used and there is a view associated with the default display context, use that view\n * @param model\n * @param props\n * @param displayContext\n * @param view\n */\nexport function createViewForModel(model: any, props: object, displayContext: string, view: React.ComponentType) {\n let finalView: React.ComponentType = view; // default to that passed in, if any.\n\n // displayContext = displayContext || DEFAULT_VIEW_KEY;\n // the view decorator isn't on the instance, it's on the constructor function that created that instance\n if (model) {\n let constructorFunction = model.constructor;\n if (constructorFunction._viewMetadata) {\n let viewMetadata = constructorFunction._viewMetadata;\n if (displayContext && viewMetadata.hasRegisteredViewContext(displayContext)) {\n let viewMetadataRegistration = viewMetadata.viewRegistrations[displayContext];\n // we've found a view for the display context, use that\n finalView = viewMetadataRegistration.view;\n }\n\n // if we've not found a view yet, and one wasn't provided, is there a default one?\n if (!finalView && viewMetadata.hasRegisteredViewContext(DEFAULT_VIEW_KEY)) {\n let viewMetadataRegistration = viewMetadata.viewRegistrations[DEFAULT_VIEW_KEY];\n finalView = viewMetadataRegistration.view;\n }\n }\n }\n if (!finalView) {\n throw new Error(`No suitable view found for model id '${model.modelId}' using context '${displayContext}'`);\n }\n return React.createElement(finalView, props);\n}\n\n/**\n * An ES7 style decorator that associates a model with a view\n * @param view the react component that will be used to display this model\n * @param displayContext an optional context allowing for different views to display the same model\n * @returns {Function}\n */\nexport function viewBinding(view: any, displayContext: string = DEFAULT_VIEW_KEY) {\n Guard.isDefined(view, 'view must be defined');\n Guard.isString(displayContext, 'displayContext must be a string');\n return function (target: any) {\n let viewMetadata = getMetadata(target);\n if (viewMetadata.hasRegisteredViewContext(displayContext)) {\n throw new Error(`Context ${displayContext} already registered for view`);\n }\n viewMetadata.viewRegistrations[displayContext] = new ViewMetadataRegistration(view, displayContext);\n };\n}\n\nexport class ViewMetadata {\n private _viewRegistrations = {};\n\n get viewRegistrations() {\n return this._viewRegistrations;\n }\n\n hasRegisteredViewContext(displayContext) {\n return typeof this._viewRegistrations[displayContext] !== 'undefined';\n }\n}\n\nexport class ViewMetadataRegistration {\n\n constructor(private _view, private _displayContext) {\n }\n\n get view() {\n return this._view;\n }\n\n get displayContext() {\n return this._displayContext;\n }\n}","module.exports = __WEBPACK_EXTERNAL_MODULE__152__;","module.exports = __WEBPACK_EXTERNAL_MODULE__43__;","module.exports = __WEBPACK_EXTERNAL_MODULE__155__;","// The module cache\nvar __webpack_module_cache__ = {};\n\n// The require function\nfunction __webpack_require__(moduleId) {\n\t// Check if module is in cache\n\tvar cachedModule = __webpack_module_cache__[moduleId];\n\tif (cachedModule !== undefined) {\n\t\treturn cachedModule.exports;\n\t}\n\t// Create a new module (and put it into the cache)\n\tvar module = __webpack_module_cache__[moduleId] = {\n\t\t// no module.id needed\n\t\t// no module.loaded needed\n\t\texports: {}\n\t};\n\n\t// Execute the module function\n\t__webpack_modules__[moduleId].call(module.exports, module, module.exports, __webpack_require__);\n\n\t// Return the exports of the module\n\treturn module.exports;\n}\n\n","// notice_start\n/*\n * Copyright 2015 Dev Shop Limited\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n// notice_end\n//\n\n// import for side effects\nimport './polimer/polimerModelBuilderExtentsions';\n\nexport {ViewBinder} from './viewBinder';\nexport {viewBinding, DEFAULT_VIEW_KEY} from './viewBindingDecorator';\nexport {\n GetEspPolimerImmutableModelMetadata,\n GetEspPolimerImmutableModelConsts,\n getEspPolimerImmutableModel\n} from './polimer/getEspPolimerImmutableModel';\nexport {createViewForModel} from './viewBindingDecorator';\nexport {\n connect,\n ConnectableComponentFactory\n} from './connect';\nexport {\n CreatePublishEventProps,\n MapModelToProps,\n ConnectableComponentProps,\n ConnectableComponentChildProps,\n ConnectableComponent,\n} from './connectableComponent';\nexport {\n UseModelSelector,\n useModelSelector,\n EditableModelSelectorOptions,\n modelSelectorOptions,\n ModelSelectorOptions,\n ModelSelectorEqualityFn,\n} from './useModelSelector';\nexport {\n RouterProvider,\n RouterProviderProps,\n EspRouterContextProvider,\n EspRouterContextProviderProps,\n RouterContext,\n useRouter,\n PublishEventDelegate,\n PublishEventContext,\n usePublishEvent,\n} from './espRouterContextProvider';\nexport {\n useGetModelId,\n GetModelIdDelegate,\n GetModelIdContext,\n useGetModel,\n GetModelDelegate,\n GetModelContext,\n PublishModelEventDelegate,\n PublishModelEventContext,\n usePublishModelEvent,\n PublishModelEventWithEntityKeyDelegate,\n PublishModelEventWithEntityKeyContext,\n usePublishModelEventWithEntityKey,\n EspModelContextProvider,\n EspModelContextProviderProps,\n} from './espModelContextProvider';\n"],"names":["root","factory","exports","module","require","define","amd","self","__WEBPACK_EXTERNAL_MODULE__152__","__WEBPACK_EXTERNAL_MODULE__43__","__WEBPACK_EXTERNAL_MODULE__155__","g","p","Object","is","a","b","q","useSyncExternalStore","r","useRef","t","useEffect","u","useMemo","v","useDebugValue","useSyncExternalStoreWithSelector","e","l","h","c","current","f","hasValue","value","d","k","m","connect","mapModelToProps","createPublishEventProps","view","props","modelId","viewContext","rest","ConnectableComponent","router","useRouter","useGetModelId","utils","stringIsEmpty","publishEventProps","eventType","event","publishEvent","model","useModelSelector","modelSelectorOptions","setModelId","setTryPreSelectPolimerImmutableModel","childProps","restProps","initialModel","tryGetPolimerImmutableModel","getChildProps","viewElement","createViewForModel","EspModelContextProvider","Logger","create","GetModelIdContext","createContext","useContext","GetModelContext","useGetModel","PublishModelEventContext","usePublishModelEvent","PublishModelEventWithEntityKeyContext","usePublishModelEventWithEntityKey","children","getModelId","useCallback","getModel","warnIfModelAccessedOutSideDispatchLoop","publishModelEvent","publishModelEventWithEntityKey","entityKey","DefaultModelAddress","Provider","RouterContext","context","undefined","Error","PublishEventContext","usePublishEvent","EspRouterContextProvider","modelIdOrModelAddress","RouterProvider","target","name","descriptor","EspDecoratorUtil","getOrCreateMetaData","constructor","addCustomData","GetEspPolimerImmutableModelConsts","CustomDataKey","functionName","HandlerFunctionName","hasMetadata","metadata","getCustomData","immutableModel","isFunction","call","PolimerModelBuilder","prototype","withViewBindings","displayContext","DEFAULT_VIEW_KEY","viewMappings","this","_viewMappings","registerWithRouter","keys","forEach","viewBinding","equalityFn","tryPreSelectPolimerImmutableModel","setEqualityFn","selector","options","Guard","dependencies","subscribe","stateChanged","modelSubscriptionDisposable","getModelObservable","nextModel","dispose","getSnapshot","wrappedSelector","snapshot","noopSubscription","ViewBinder","newProps","finalView","constructorFunction","_viewMetadata","viewMetadata","hasRegisteredViewContext","viewRegistrations","React","createElement","isDefined","isString","ViewMetadata","getMetadata","ViewMetadataRegistration","_viewRegistrations","_view","_displayContext","__webpack_module_cache__","__webpack_require__","moduleId","cachedModule","__webpack_modules__","get","getEspPolimerImmutableModel"],"sourceRoot":""}
|
|
1
|
+
{"version":3,"file":"esp-react.min.js","mappings":"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","sources":["webpack://esp-js-react/webpack/universalModuleDefinition","webpack://esp-js-react/../../node_modules/use-sync-external-store/cjs/use-sync-external-store-with-selector.production.min.js","webpack://esp-js-react/../../node_modules/use-sync-external-store/with-selector.js","webpack://esp-js-react/./src/connect.tsx","webpack://esp-js-react/./src/connectableComponent.tsx","webpack://esp-js-react/./src/espModelContextProvider.tsx","webpack://esp-js-react/./src/espRouterContextProvider.tsx","webpack://esp-js-react/./src/polimer/getEspPolimerImmutableModel.ts","webpack://esp-js-react/./src/polimer/polimerModelBuilderExtentsions.ts","webpack://esp-js-react/./src/useSyncModelWithSelector.ts","webpack://esp-js-react/./src/viewBinder.tsx","webpack://esp-js-react/./src/viewBindingDecorator.ts","webpack://esp-js-react/external umd \"esp-js\"","webpack://esp-js-react/external umd \"esp-js-polimer\"","webpack://esp-js-react/external umd \"react\"","webpack://esp-js-react/webpack/bootstrap","webpack://esp-js-react/./src/index.ts"],"sourcesContent":["(function webpackUniversalModuleDefinition(root, factory) {\n\tif(typeof exports === 'object' && typeof module === 'object')\n\t\tmodule.exports = factory(require(\"esp-js\"), require(\"esp-js-polimer\"), require(\"react\"));\n\telse if(typeof define === 'function' && define.amd)\n\t\tdefine([\"esp-js\", \"esp-js-polimer\", \"react\"], factory);\n\telse if(typeof exports === 'object')\n\t\texports[\"esp-js-react\"] = factory(require(\"esp-js\"), require(\"esp-js-polimer\"), require(\"react\"));\n\telse\n\t\troot[\"esp-js-react\"] = factory(root[\"esp-js\"], root[\"esp-js-polimer\"], root[\"react\"]);\n})(self, (__WEBPACK_EXTERNAL_MODULE__152__, __WEBPACK_EXTERNAL_MODULE__43__, __WEBPACK_EXTERNAL_MODULE__155__) => {\nreturn ","/**\n * @license React\n * use-sync-external-store-with-selector.production.min.js\n *\n * Copyright (c) Facebook, Inc. and its affiliates.\n *\n * This source code is licensed under the MIT license found in the\n * LICENSE file in the root directory of this source tree.\n */\n'use strict';var g=require(\"react\");function n(a,b){return a===b&&(0!==a||1/a===1/b)||a!==a&&b!==b}var p=\"function\"===typeof Object.is?Object.is:n,q=g.useSyncExternalStore,r=g.useRef,t=g.useEffect,u=g.useMemo,v=g.useDebugValue;\nexports.useSyncExternalStoreWithSelector=function(a,b,e,l,h){var c=r(null);if(null===c.current){var f={hasValue:!1,value:null};c.current=f}else f=c.current;c=u(function(){function a(a){if(!c){c=!0;d=a;a=l(a);if(void 0!==h&&f.hasValue){var b=f.value;if(h(b,a))return k=b}return k=a}b=k;if(p(d,a))return b;var e=l(a);if(void 0!==h&&h(b,e))return b;d=a;return k=e}var c=!1,d,k,m=void 0===e?null:e;return[function(){return a(b())},null===m?void 0:function(){return a(m())}]},[b,e,l,h]);var d=q(a,c[0],c[1]);\nt(function(){f.hasValue=!0;f.value=d},[d]);v(d);return d};\n","'use strict';\n\nif (process.env.NODE_ENV === 'production') {\n module.exports = require('./cjs/use-sync-external-store-with-selector.production.min.js');\n} else {\n module.exports = require('./cjs/use-sync-external-store-with-selector.development.js');\n}\n","import * as React from 'react';\nimport {ConnectableComponent, ConnectableComponentProps, CreatePublishEventProps, MapModelToProps} from './connectableComponent';\n\nexport type ConnectableComponentFactory<TModel, TPublishEventProps, TModelMappedToProps = {}> = (view: React.ComponentType) => (props: ConnectableComponentProps<TModel, TPublishEventProps, TModelMappedToProps>) => React.JSX.Element;\n\n/**\n * @param mapModelToProps - maps the model to a different structure, that structure is sent as props to the view.\n * @param createPublishEventProps - creates functions to publish events, the structure is sent as props to the view.\n */\nexport const connect = function <TModel, TPublishEventProps, TModelMappedToProps = {}>(\n mapModelToProps?: MapModelToProps<TModel, TModelMappedToProps, TPublishEventProps>,\n createPublishEventProps?: CreatePublishEventProps<TPublishEventProps>\n): ConnectableComponentFactory<TModel, TPublishEventProps, TModelMappedToProps> {\n return function (view: React.ComponentType) {\n return function (props: ConnectableComponentProps<TModel, TPublishEventProps, TModelMappedToProps>) {\n const {modelId, viewContext, ...rest} = props;\n return <ConnectableComponent\n modelId={modelId}\n view={view}\n viewContext={viewContext}\n createPublishEventProps={createPublishEventProps}\n mapModelToProps={mapModelToProps}\n {...rest}\n />;\n };\n };\n};","import * as React from 'react';\nimport {useRouter} from './espRouterContextProvider';\nimport {useMemo} from 'react';\nimport {Router, utils} from 'esp-js';\nimport {EspModelContextProvider, useGetModelId} from './espModelContextProvider';\nimport {createViewForModel} from './viewBindingDecorator';\nimport {tryGetPolimerImmutableModel} from './polimer/getEspPolimerImmutableModel';\nimport {syncModelWithSelectorOptions, useSyncModelWithSelector} from './useSyncModelWithSelector';\n\nexport type CreatePublishEventProps<TPublishEventProps> = (publishModelEvent: (eventType: string, event: any) => void) => TPublishEventProps;\n\nexport type MapModelToProps<TModel, TModelMappedToProps, TPublishEventProps = {}> = (model: TModel, publishEventProps: TPublishEventProps) => TModelMappedToProps;\n\nexport interface ConnectableComponentProps<TModel = {}, TPublishEventProps = {}, TModelMappedToProps = {}> {\n modelId?: string;\n viewContext?: string;\n view?: React.ComponentType;\n createPublishEventProps?: CreatePublishEventProps<TPublishEventProps>;\n mapModelToProps?: MapModelToProps<TModel, TModelMappedToProps, TPublishEventProps>;\n [key: string]: any; // ...rest props, including the result of mapPublish and mapPublish if 'connect' was used\n}\n\nexport interface ConnectableComponentChildProps<TModel = object> {\n modelId: string;\n model: TModel;\n router: Router;\n [key: string]: any; // ...rest props\n}\n\nconst getChildProps = <TModel, TModelMappedToProps, TPublishEventProps>(\n router: Router,\n modelId: string,\n restProps: object,\n initialModel: TModel,\n mapModelToProps: MapModelToProps<TModel, TModelMappedToProps, TPublishEventProps>,\n publishEventProps: TPublishEventProps\n): ConnectableComponentChildProps<TModel> => {\n const model = tryGetPolimerImmutableModel<TModel>(initialModel);\n let childProps = {\n modelId,\n router: router,\n ...restProps,\n ...publishEventProps,\n model\n };\n if (mapModelToProps) {\n childProps = {\n ...childProps,\n ...(mapModelToProps(model, publishEventProps) as TModelMappedToProps)\n };\n }\n return childProps;\n};\n\nexport const ConnectableComponent = <TModel = {}, TPublishEventProps = {}, TModelMappedToProps = {}>(\n {\n modelId,\n mapModelToProps,\n createPublishEventProps,\n view,\n viewContext,\n ...rest\n }: ConnectableComponentProps<TModel, TPublishEventProps, TModelMappedToProps>\n) => {\n const router = useRouter();\n modelId = modelId || useGetModelId();\n if (utils.stringIsEmpty(modelId) || !router) {\n return null;\n }\n const publishEventProps: TPublishEventProps = useMemo(\n () => {\n if (createPublishEventProps) {\n const publishModelEvent = (eventType: string, event: any) => {\n router.publishEvent(modelId, eventType, event);\n };\n return createPublishEventProps(publishModelEvent);\n }\n return {} as TPublishEventProps;\n },\n [router, modelId]\n );\n const model = useSyncModelWithSelector<TModel, TModel>(\n m => m,\n syncModelWithSelectorOptions()\n .setModelId(modelId)\n .setTryPreSelectPolimerImmutableModel(false)\n );\n if (model == null) {\n return null;\n }\n let childProps = getChildProps(router, modelId, rest, model, mapModelToProps, publishEventProps);\n let viewElement = createViewForModel(model, childProps, viewContext, view);\n return (\n <EspModelContextProvider modelId={modelId} model={model} router={router} {...childProps}>\n {viewElement}\n </EspModelContextProvider>\n );\n};","import * as React from 'react';\nimport {DefaultModelAddress, Router, Status, Logger, utils} from 'esp-js';\nimport {useContext, useCallback, createContext, PropsWithChildren} from 'react';\nimport {useRouter} from './espRouterContextProvider';\n\nconst _log = Logger.create('EspModelContextProvider');\n\nexport const GetModelIdContext = createContext<string>(null);\n/**\n * Returns a function to get the ID of the model connected at a higher point in the V-DOM.\n *\n * To use this, please ensure your V-DOM has the EspModelContextProvider at a higher node.\n */\nexport const useGetModelId = () => useContext(GetModelIdContext);\n\nexport const GetModelContext = createContext<object>(null);\n/**\n * Returns a function which will return the model connected at a higher point in the V-DOM.\n *\n * To use this, please ensure your V-DOM has the EspModelContextProvider at a higher node.\n */\nexport const useGetModel = <TModel,>() => useContext(GetModelContext) as TModel;\n\nexport type PublishModelEventDelegate = (eventType: string, event: any) => void;\nexport const PublishModelEventContext = createContext<PublishModelEventDelegate>(null);\n/**\n * Returns a function which can be used to publish an event to the model connected at a higher point in the V-DOM.\n *\n * Effectively, this is a version of usePublishEvent() which closes over the relevant modelId.\n *\n * To use this, please ensure your V-DOM has the EspModelContextProvider at a higher node.\n */\nexport const usePublishModelEvent = () => useContext(PublishModelEventContext);\n\nexport type PublishModelEventWithEntityKeyDelegate = (entityKey: string, eventType: string, event: any) => void;\nexport const PublishModelEventWithEntityKeyContext = createContext<PublishModelEventWithEntityKeyDelegate>(null);\n/**\n * Returns a function which can be used to publish an event to the model connected at a higher point in the V-DOM, allows an entityKey to be specified.\n *\n * Effectively, this is a version of usePublishEvent() which closes over the modelId.\n *\n * To use this, please ensure your V-DOM has the EspModelContextProvider at a higher node.\n */\nexport const usePublishModelEventWithEntityKey = () => useContext(PublishModelEventWithEntityKeyContext);\n\nexport interface EspModelContextProviderProps {\n modelId: string;\n model?: any;\n}\n\n/**\n * Sets up various ESP context so ESP hooks are available below this point in the V-DOM\n *\n * To use this, please ensure your V-DOM has the EspRouterContextProvider at a higher node.\n * @param modelId\n * @param children\n * @param model\n * @constructor\n */\nexport const EspModelContextProvider = ({modelId, children, model}: PropsWithChildren<EspModelContextProviderProps>) => {\n const router = useRouter();\n const publishModelEvent: PublishModelEventDelegate = useCallback((eventType: string, event: any) => {\n router.publishEvent(modelId, eventType, event);\n }, [router, modelId]);\n const publishModelEventWithEntityKey: PublishModelEventWithEntityKeyDelegate = useCallback((entityKey: string, eventType: string, event: any) => {\n router.publishEvent(new DefaultModelAddress(modelId, entityKey), eventType, event);\n }, [router, modelId]);\n return (\n <GetModelIdContext.Provider value={modelId}>\n <PublishModelEventContext.Provider value={publishModelEvent}>\n <PublishModelEventWithEntityKeyContext.Provider value={publishModelEventWithEntityKey}>\n <GetModelContext.Provider value={model}>\n {children}\n </GetModelContext.Provider>\n </PublishModelEventWithEntityKeyContext.Provider>\n </PublishModelEventContext.Provider>\n </GetModelIdContext.Provider>\n );\n};","// notice_start\n/*\n * Copyright 2015 Dev Shop Limited\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n// notice_end\n\nimport * as React from 'react';\nimport {ModelAddress, Router} from 'esp-js';\nimport {PropsWithChildren, createContext, useContext, useCallback} from 'react';\n\nexport const RouterContext = createContext<Router>(null);\n\n/**\n * Get the esp Router from context.\n *\n * To use this, please ensure your V-DOM has the EspRouterContextProvider at a higher node:\n *\n * <EspRouterContextProvider router={router}>\n * <YourComponents />\n * </EspRouterContextProvider>\n */\nexport const useRouter = () => {\n const context: Router = useContext(RouterContext);\n if (context === undefined) {\n throw new Error('useRouter must be used within a RouterContext.Provider');\n }\n return context;\n};\n\nexport type PublishEventDelegate = (modelIdOrModelAddress: string | ModelAddress, eventType: string, event: any) => void;\nexport const PublishEventContext = createContext<PublishEventDelegate>(null);\n\n/**\n * Returns a function which can be used to publish an event.\n *\n * To use this, please ensure your V-DOM has the EspRouterContextProvider at a higher node:\n *\n * <EspRouterContextProvider router={router}>\n * <YourComponents />\n * </EspRouterContextProvider>\n */\nexport const usePublishEvent = () => useContext(PublishEventContext);\n\nexport type EspRouterContextProviderProps = PropsWithChildren<{ router: Router; }>;\n\n/**\n * Used to set the router on the RouterContext making it available to components down the tree via the useRouter() hook.\n *\n * Also sets up the usePublishEvent() hook so nested components can publish to the router.\n */\nexport const EspRouterContextProvider = ({children, router}: EspRouterContextProviderProps) => {\n const publishEvent: PublishEventDelegate = useCallback((modelIdOrModelAddress: string, eventType: string, event: any) => {\n router.publishEvent(modelIdOrModelAddress, eventType, event);\n }, [router]);\n return (\n <RouterContext.Provider value={router}>\n <PublishEventContext.Provider value={publishEvent}>\n {children}\n </PublishEventContext.Provider>\n </RouterContext.Provider>\n );\n};\n\n/**\n * Used to set the router on the RouterContext making it available to components down the tree (via useRouter()).\n *\n * @deprecated use EspRouterContextProvider\n */\nexport const RouterProvider = EspRouterContextProvider;\n\n/**\n * Props for RouterProvider\n *\n * @deprecated use EspRouterContextProviderProps\n */\nexport type RouterProviderProps = EspRouterContextProviderProps;\n","import {EspMetadata, EspDecoratorUtil, utils} from 'esp-js';\n\nexport interface GetEspPolimerImmutableModelMetadata {\n functionName: string;\n}\n\nexport namespace GetEspPolimerImmutableModelConsts {\n export const CustomDataKey = 'GetEspReactImmutableModelCustomDataKey';\n /**\n * If there is no @getEspPolimerImmutableModel decorator and a function by this name exists on a model, then it will be invoked to identify the sub model which will replaced the `model` prop passed to the child view of a ConnectableComponent\n */\n export const HandlerFunctionName = 'getEspPolimerImmutableModel';\n}\n\n/**\n * A decorator which can be used to identify the render model which will replaced the `model` prop passed to the child view of a ConnectableComponent\n */\nexport function getEspPolimerImmutableModel() {\n return function (target, name, descriptor) {\n let metadata: EspMetadata = EspDecoratorUtil.getOrCreateMetaData(target.constructor);\n metadata.addCustomData(\n GetEspPolimerImmutableModelConsts.CustomDataKey,\n <GetEspPolimerImmutableModelMetadata>{ functionName: name }\n );\n return descriptor;\n };\n}\n\n/**\n * Returns the model which will be used to pluck state/props for the current view.\n *\n * This is basically a hook (not a React 'hook') to call a function on `model` and get a new subgraph to use as state.\n *\n */\nexport const tryGetPolimerImmutableModel = <TImmutableModel>(model: any): TImmutableModel => {\n // does the given model have a decorated function we can invoke to get a different model to render?\n if (EspDecoratorUtil.hasMetadata(model)) {\n let metadata: GetEspPolimerImmutableModelMetadata = EspDecoratorUtil.getCustomData(model, GetEspPolimerImmutableModelConsts.CustomDataKey);\n if (metadata) {\n return model[metadata.functionName]();\n }\n }\n // else see if there is a function with name GetEspPolimerImmutableModelConsts.HandlerFunctionName we can invoke to get a different model to render?\n let immutableModel = model[GetEspPolimerImmutableModelConsts.HandlerFunctionName];\n if (immutableModel && utils.isFunction(immutableModel)) {\n return immutableModel.call(model);\n }\n // else return the initial model passed in\n return model;\n};","import {PolimerModelBuilder, PolimerModel} from 'esp-js-polimer';\nimport {DEFAULT_VIEW_KEY, viewBinding} from '../viewBindingDecorator';\n\ndeclare module 'esp-js-polimer/.dist/typings/modelBuilderUpdater' {\n export interface PolimerModelBuilder<TModel> {\n withViewBindings?(view: any, displayContext?: string): PolimerModelBuilder<TModel>;\n }\n}\n\ninterface ViewMappings {\n [displayContext: string]: any;\n}\n\nPolimerModelBuilder.prototype.withViewBindings = function (view: any, displayContext: string = DEFAULT_VIEW_KEY): PolimerModelBuilder<any> {\n let builder = this;\n // store some metadata on the builder which we'll use later to tack onto the model\n let viewMappings: ViewMappings = builder._viewMappings || { };\n viewMappings[displayContext] = view;\n builder._viewMappings = viewMappings;\n return this;\n};\n\n// we need to replace the registerWithRouter in order to dynamically add the\n// @viewBinding decorator to it\nlet registerWithRouter = PolimerModelBuilder.prototype.registerWithRouter;\nPolimerModelBuilder.prototype.registerWithRouter = function (): PolimerModel<any> {\n let builder = this;\n let model = registerWithRouter.call(builder);\n let viewMappings: ViewMappings = builder._viewMappings;\n if (viewMappings) {\n Object.keys(viewMappings).forEach(displayContext => {\n viewBinding(viewMappings[displayContext], displayContext)(model.constructor);\n });\n }\n return model;\n};\n","import {useMemo} from 'react';\nimport {useSyncExternalStoreWithSelector} from 'use-sync-external-store/with-selector';\nimport {Guard, utils} from 'esp-js';\nimport {useRouter} from './espRouterContextProvider';\nimport {useGetModelId} from './espModelContextProvider';\nimport {tryGetPolimerImmutableModel} from './polimer/getEspPolimerImmutableModel';\n\nexport type SyncModelWithSelectorEqualityFn<T> = (last: T, next: T) => boolean;\n\n/**\n * Options affecting the subscription of the model to the Router.\n *\n * Use syncModelWithSelectorOptions() to create an instance of this type with sensible defaults.\n *\n * @param modelId - the modelId of the model to be observed via the esp Router.\n * @param tryPreSelectPolimerImmutableModel - if true, and the esp model is an esp-js-polimer model, the immutable model will be used when calling the selector.\n * @param equalityFn - Equality function which will be applied against TSelected, defaults to instance equality (a === b).\n */\nexport type SyncModelWithSelectorOptions<TSelected> = {\n modelId?: string,\n tryPreSelectPolimerImmutableModel: boolean,\n equalityFn: SyncModelWithSelectorEqualityFn<TSelected>\n};\n\n/**\n * Convenience API to build SyncModelWithSelectorOptions<TSelected>, has sensible defaulting.\n */\nexport interface SyncModelWithSelectorOptionsBuilder<TSelected> extends SyncModelWithSelectorOptions<TSelected> {\n /**\n * Sets the model ID\n * @param modelId - default if unset: undefined\n */\n setModelId(modelId: string): this;\n\n /**\n * If the model is a PolimerModel and this set true, PolimerModel.getImmutableModel() will be selected by default.\n * @param value - default if unset: true\n */\n setTryPreSelectPolimerImmutableModel(value: boolean): this;\n\n /**\n * Equality function used when comparing the last TSelected with the next.\n * @param fn - default if unset: obj instance equality (e.g. a===b)\n */\n setEqualityFn(fn: (a: TSelected, b: TSelected) => boolean): this;\n}\n\n/**\n * Convenience API to create SyncModelWithSelectorOptions\n */\nexport const syncModelWithSelectorOptions = <TSelected>() => {\n let modelId = undefined;\n let equalityFn: SyncModelWithSelectorEqualityFn<TSelected> = (a: TSelected, b: TSelected) => a === b;\n let tryPreSelectPolimerImmutableModel = true;\n return {\n get modelId() {\n return modelId;\n },\n setModelId(value: string) {\n modelId = value;\n return this;\n },\n get equalityFn() {\n return equalityFn;\n },\n setEqualityFn(value: SyncModelWithSelectorEqualityFn<TSelected>) {\n equalityFn = value;\n return this;\n },\n get tryPreSelectPolimerImmutableModel() {\n return tryPreSelectPolimerImmutableModel;\n },\n setTryPreSelectPolimerImmutableModel(value: boolean) {\n tryPreSelectPolimerImmutableModel = value;\n return this;\n }\n } as SyncModelWithSelectorOptionsBuilder<TSelected>;\n};\n\nconst checkArguments = (selector: (model: any) => any, options: SyncModelWithSelectorOptions<any> ) => {\n if (!utils.isFunction(selector)) {\n throw new Error('You must pass a selector function to useSyncModelWithSelector');\n }\n if (!utils.isObject(options)) {\n throw new Error('You must provide options when using useSyncModelWithSelector');\n }\n if (!utils.isFunction(options.equalityFn)) {\n throw new Error('You must provide an equalityFn when using useSyncModelWithSelector');\n }\n};\n\n/**\n * A hook which returns model state from the esp Router.\n *\n * This hooks wih observe updates and re-render the component if the model changes.\n *\n * To use this, please ensure your V-DOM has the EspRouterContextProvider at a higher node, and optionally EspModelContextProvider.\n *\n * @param selector - a function to select a selection of the model - the selector does not need to be memoized, this selector will be cached against the modelId.\n * @param options\n */\nexport const useSyncModelWithSelector = <TModel, TSelected>(\n selector: (model: TModel) => TSelected,\n options: SyncModelWithSelectorOptions<TSelected> = syncModelWithSelectorOptions<TSelected>()\n): TSelected => {\n checkArguments(selector, options);\n const router = useRouter();\n const modelId = options?.modelId || useGetModelId();\n const tryPreSelectPolimerImmutableModel = options?.tryPreSelectPolimerImmutableModel;\n const equalityFn = options?.equalityFn;\n const dependencies = useMemo(\n () => {\n // Because of how useSyncExternalStore works, there is an implicit dependency between the subscribe and getSnapshot functions.\n // When the subscription receives the new state from the Router, it can't pass this directly onto getSnapshot, React calls that when it deems it needs to.\n // Given that, we need to cache the state which getSnapshot will return.\n //\n // It's not ideal but shouldn't be a problem as here we've wrapped all these dependent functions inside a single useMemo()\n let model: TModel = null;\n return {\n subscribe: (stateChanged: () => void) => {\n const modelSubscriptionDisposable = router\n .getModelObservable(modelId)\n .subscribe(\n (m: any) => {\n // try and get a submodel to render\n const nextModel = tryPreSelectPolimerImmutableModel\n ? tryGetPolimerImmutableModel(m)\n : m;\n // if the above didn't manage to get a submodel,\n // we need to mutate to force useSyncExternalStoreWithSelector to pick up the change\n model = nextModel === m\n ? Object.create(nextModel)\n : nextModel;\n stateChanged();\n }\n );\n return () => {\n model = null;\n modelSubscriptionDisposable.dispose();\n };\n },\n // React expects getSnapshot to be immutable, it'll only re-render if the instance changes\n getSnapshot: () => {\n return model;\n },\n // While getSnapshot needs to model to be immutable,\n // useSyncExternalStoreWithSelector builds on top of this, so the TSelected can defer to an equality check to determine if the change is propagated.\n // The selector here just maps the TSelected, useSyncExternalStoreWithSelector internally does the equality check.\n wrappedSelector: (snapshot: TModel) => {\n // The first time this renders, react calls getSnapshot and the selector before the router has pushed a change.\n // In that case, there is no state for any component to process, therefore, we return null;\n return snapshot\n ? selector(snapshot)\n : null;\n }\n };\n },\n // Don't cache check against 'selector' argument as that will likely change unless the caller memoizes it.\n [router, modelId]\n );\n\n // If we don't have a modelId, we still need to return a hook so React doesn't complain.\n // Additionally, we need to let the above expiration (dependencies) run to unsubscribe from any previous subscription.\n if (utils.stringIsEmpty(modelId)) {\n return useSyncExternalStoreWithSelector(\n noopSubscription.subscribe,\n noopSubscription.getSnapshot,\n undefined,\n noopSubscription.wrappedSelector,\n equalityFn\n );\n }\n\n // Docs on useSyncExternalStore https://github.com/reactwg/react-18/discussions/86\n // Redux's usage of this: https://github.com/reduxjs/react-redux/blob/master/src/hooks/useSelector.ts\n // Code: https://github.com/facebook/react/blob/main/packages/use-sync-external-store/src/useSyncExternalStoreWithSelector.js\n return useSyncExternalStoreWithSelector(\n dependencies.subscribe,\n dependencies.getSnapshot,\n undefined,\n dependencies.wrappedSelector,\n equalityFn,\n );\n};\n\nconst noopSubscription = {\n subscribe: () => { },\n getSnapshot: () => null,\n wrappedSelector: () => true\n};","// notice_start\n/*\n * Copyright 2015 Dev Shop Limited\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n// notice_end\n\nimport * as React from 'react';\nimport {createViewForModel} from './viewBindingDecorator';\nimport {useRouter} from './espRouterContextProvider';\n\nexport interface ViewBinderProps {\n model: any;\n viewContext?: string;\n /**\n * ...rest props, these will be passed to the child\n */\n [key: string]: any;\n}\n\n/**\n * Takes a model with a @viewBinding decorator and dynamically crates the view specified by the decorator\n */\nexport const ViewBinder: React.FC<ViewBinderProps> = ({model, viewContext, ...rest}) => {\n if (model) {\n const router = useRouter();\n const newProps = {\n model,\n router,\n ...rest\n };\n return createViewForModel(\n model,\n newProps,\n viewContext,\n null\n );\n }\n return null;\n};","// notice_start\n/*\n * Copyright 2015 Dev Shop Limited\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n// notice_end\n\nimport * as React from 'react';\nimport {Guard} from 'esp-js';\n\nexport const DEFAULT_VIEW_KEY = 'default-view-key';\n\nfunction getMetadata(target) {\n if (!target._viewMetadata) {\n target._viewMetadata = new ViewMetadata();\n }\n return target._viewMetadata;\n}\n\n/**\n * Tries to get a view for the given model.\n *\n * It does this using the following order:\n * 1) If a @viewBinding decorator was used and a display context was given, try get a view for that\n * 2) Else if a view was explicitly provided use that\n * 3) Else if a @viewBinding decorator was used and there is a view associated with the default display context, use that view\n * @param model\n * @param props\n * @param displayContext\n * @param view\n */\nexport function createViewForModel(model: any, props: object, displayContext: string, view: React.ComponentType) {\n let finalView: React.ComponentType = view; // default to that passed in, if any.\n\n // displayContext = displayContext || DEFAULT_VIEW_KEY;\n // the view decorator isn't on the instance, it's on the constructor function that created that instance\n if (model) {\n let constructorFunction = model.constructor;\n if (constructorFunction._viewMetadata) {\n let viewMetadata = constructorFunction._viewMetadata;\n if (displayContext && viewMetadata.hasRegisteredViewContext(displayContext)) {\n let viewMetadataRegistration = viewMetadata.viewRegistrations[displayContext];\n // we've found a view for the display context, use that\n finalView = viewMetadataRegistration.view;\n }\n\n // if we've not found a view yet, and one wasn't provided, is there a default one?\n if (!finalView && viewMetadata.hasRegisteredViewContext(DEFAULT_VIEW_KEY)) {\n let viewMetadataRegistration = viewMetadata.viewRegistrations[DEFAULT_VIEW_KEY];\n finalView = viewMetadataRegistration.view;\n }\n }\n }\n if (!finalView) {\n throw new Error(`No suitable view found for model id '${model.modelId}' using context '${displayContext}'`);\n }\n return React.createElement(finalView, props);\n}\n\n/**\n * An ES7 style decorator that associates a model with a view\n * @param view the react component that will be used to display this model\n * @param displayContext an optional context allowing for different views to display the same model\n * @returns {Function}\n */\nexport function viewBinding(view: any, displayContext: string = DEFAULT_VIEW_KEY) {\n Guard.isDefined(view, 'view must be defined');\n Guard.isString(displayContext, 'displayContext must be a string');\n return function (target: any) {\n let viewMetadata = getMetadata(target);\n if (viewMetadata.hasRegisteredViewContext(displayContext)) {\n throw new Error(`Context ${displayContext} already registered for view`);\n }\n viewMetadata.viewRegistrations[displayContext] = new ViewMetadataRegistration(view, displayContext);\n };\n}\n\nexport class ViewMetadata {\n private _viewRegistrations = {};\n\n get viewRegistrations() {\n return this._viewRegistrations;\n }\n\n hasRegisteredViewContext(displayContext) {\n return typeof this._viewRegistrations[displayContext] !== 'undefined';\n }\n}\n\nexport class ViewMetadataRegistration {\n\n constructor(private _view, private _displayContext) {\n }\n\n get view() {\n return this._view;\n }\n\n get displayContext() {\n return this._displayContext;\n }\n}","module.exports = __WEBPACK_EXTERNAL_MODULE__152__;","module.exports = __WEBPACK_EXTERNAL_MODULE__43__;","module.exports = __WEBPACK_EXTERNAL_MODULE__155__;","// The module cache\nvar __webpack_module_cache__ = {};\n\n// The require function\nfunction __webpack_require__(moduleId) {\n\t// Check if module is in cache\n\tvar cachedModule = __webpack_module_cache__[moduleId];\n\tif (cachedModule !== undefined) {\n\t\treturn cachedModule.exports;\n\t}\n\t// Create a new module (and put it into the cache)\n\tvar module = __webpack_module_cache__[moduleId] = {\n\t\t// no module.id needed\n\t\t// no module.loaded needed\n\t\texports: {}\n\t};\n\n\t// Execute the module function\n\t__webpack_modules__[moduleId].call(module.exports, module, module.exports, __webpack_require__);\n\n\t// Return the exports of the module\n\treturn module.exports;\n}\n\n","// notice_start\n/*\n * Copyright 2015 Dev Shop Limited\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n// notice_end\n//\n\n// import for side effects\nimport './polimer/polimerModelBuilderExtentsions';\n\nexport {ViewBinder} from './viewBinder';\nexport {viewBinding, DEFAULT_VIEW_KEY} from './viewBindingDecorator';\nexport {\n GetEspPolimerImmutableModelMetadata,\n GetEspPolimerImmutableModelConsts,\n getEspPolimerImmutableModel\n} from './polimer/getEspPolimerImmutableModel';\nexport {createViewForModel} from './viewBindingDecorator';\nexport {\n connect,\n ConnectableComponentFactory\n} from './connect';\nexport {\n CreatePublishEventProps,\n MapModelToProps,\n ConnectableComponentProps,\n ConnectableComponentChildProps,\n ConnectableComponent,\n} from './connectableComponent';\nexport {\n useSyncModelWithSelector,\n SyncModelWithSelectorOptionsBuilder,\n syncModelWithSelectorOptions,\n SyncModelWithSelectorOptions,\n SyncModelWithSelectorEqualityFn,\n} from './useSyncModelWithSelector';\nexport {\n RouterProvider,\n RouterProviderProps,\n EspRouterContextProvider,\n EspRouterContextProviderProps,\n RouterContext,\n useRouter,\n PublishEventDelegate,\n PublishEventContext,\n usePublishEvent,\n} from './espRouterContextProvider';\nexport {\n useGetModelId,\n GetModelIdContext,\n useGetModel,\n GetModelContext,\n PublishModelEventDelegate,\n PublishModelEventContext,\n usePublishModelEvent,\n PublishModelEventWithEntityKeyDelegate,\n PublishModelEventWithEntityKeyContext,\n usePublishModelEventWithEntityKey,\n EspModelContextProvider,\n EspModelContextProviderProps,\n} from './espModelContextProvider';\n"],"names":["root","factory","exports","module","require","define","amd","self","__WEBPACK_EXTERNAL_MODULE__152__","__WEBPACK_EXTERNAL_MODULE__43__","__WEBPACK_EXTERNAL_MODULE__155__","g","p","Object","is","a","b","q","useSyncExternalStore","r","useRef","t","useEffect","u","useMemo","v","useDebugValue","useSyncExternalStoreWithSelector","e","l","h","c","current","f","hasValue","value","d","k","m","connect","mapModelToProps","createPublishEventProps","view","props","modelId","viewContext","rest","ConnectableComponent","router","useRouter","useGetModelId","utils","stringIsEmpty","publishEventProps","eventType","event","publishEvent","model","useSyncModelWithSelector","syncModelWithSelectorOptions","setModelId","setTryPreSelectPolimerImmutableModel","childProps","restProps","initialModel","tryGetPolimerImmutableModel","getChildProps","viewElement","createViewForModel","EspModelContextProvider","Logger","create","GetModelIdContext","createContext","useContext","GetModelContext","useGetModel","PublishModelEventContext","usePublishModelEvent","PublishModelEventWithEntityKeyContext","usePublishModelEventWithEntityKey","children","publishModelEvent","useCallback","publishModelEventWithEntityKey","entityKey","DefaultModelAddress","Provider","RouterContext","context","undefined","Error","PublishEventContext","usePublishEvent","EspRouterContextProvider","modelIdOrModelAddress","RouterProvider","target","name","descriptor","EspDecoratorUtil","getOrCreateMetaData","constructor","addCustomData","GetEspPolimerImmutableModelConsts","CustomDataKey","functionName","HandlerFunctionName","hasMetadata","metadata","getCustomData","immutableModel","isFunction","call","PolimerModelBuilder","prototype","withViewBindings","displayContext","DEFAULT_VIEW_KEY","viewMappings","this","_viewMappings","registerWithRouter","keys","forEach","viewBinding","equalityFn","tryPreSelectPolimerImmutableModel","setEqualityFn","selector","options","isObject","checkArguments","dependencies","subscribe","stateChanged","modelSubscriptionDisposable","getModelObservable","nextModel","dispose","getSnapshot","wrappedSelector","snapshot","noopSubscription","ViewBinder","newProps","finalView","constructorFunction","_viewMetadata","viewMetadata","hasRegisteredViewContext","viewRegistrations","React","createElement","Guard","isDefined","isString","ViewMetadata","getMetadata","ViewMetadataRegistration","_viewRegistrations","_view","_displayContext","__webpack_module_cache__","__webpack_require__","moduleId","cachedModule","__webpack_modules__","get","getEspPolimerImmutableModel"],"sourceRoot":""}
|
|
@@ -1,15 +1,13 @@
|
|
|
1
1
|
import * as React from 'react';
|
|
2
2
|
import { PropsWithChildren } from 'react';
|
|
3
|
-
export
|
|
4
|
-
export declare const GetModelIdContext: React.Context<GetModelIdDelegate>;
|
|
3
|
+
export declare const GetModelIdContext: React.Context<string>;
|
|
5
4
|
/**
|
|
6
5
|
* Returns a function to get the ID of the model connected at a higher point in the V-DOM.
|
|
7
6
|
*
|
|
8
7
|
* To use this, please ensure your V-DOM has the EspModelContextProvider at a higher node.
|
|
9
8
|
*/
|
|
10
9
|
export declare const useGetModelId: () => string;
|
|
11
|
-
export
|
|
12
|
-
export declare const GetModelContext: React.Context<GetModelDelegate>;
|
|
10
|
+
export declare const GetModelContext: React.Context<object>;
|
|
13
11
|
/**
|
|
14
12
|
* Returns a function which will return the model connected at a higher point in the V-DOM.
|
|
15
13
|
*
|
|
@@ -38,7 +36,7 @@ export declare const PublishModelEventWithEntityKeyContext: React.Context<Publis
|
|
|
38
36
|
export declare const usePublishModelEventWithEntityKey: () => PublishModelEventWithEntityKeyDelegate;
|
|
39
37
|
export interface EspModelContextProviderProps {
|
|
40
38
|
modelId: string;
|
|
41
|
-
model?:
|
|
39
|
+
model?: any;
|
|
42
40
|
}
|
|
43
41
|
/**
|
|
44
42
|
* Sets up various ESP context so ESP hooks are available below this point in the V-DOM
|
package/.dist/typings/index.d.ts
CHANGED
|
@@ -5,6 +5,6 @@ export { GetEspPolimerImmutableModelMetadata, GetEspPolimerImmutableModelConsts,
|
|
|
5
5
|
export { createViewForModel } from './viewBindingDecorator';
|
|
6
6
|
export { connect, ConnectableComponentFactory } from './connect';
|
|
7
7
|
export { CreatePublishEventProps, MapModelToProps, ConnectableComponentProps, ConnectableComponentChildProps, ConnectableComponent, } from './connectableComponent';
|
|
8
|
-
export {
|
|
8
|
+
export { useSyncModelWithSelector, SyncModelWithSelectorOptionsBuilder, syncModelWithSelectorOptions, SyncModelWithSelectorOptions, SyncModelWithSelectorEqualityFn, } from './useSyncModelWithSelector';
|
|
9
9
|
export { RouterProvider, RouterProviderProps, EspRouterContextProvider, EspRouterContextProviderProps, RouterContext, useRouter, PublishEventDelegate, PublishEventContext, usePublishEvent, } from './espRouterContextProvider';
|
|
10
|
-
export { useGetModelId,
|
|
10
|
+
export { useGetModelId, GetModelIdContext, useGetModel, GetModelContext, PublishModelEventDelegate, PublishModelEventContext, usePublishModelEvent, PublishModelEventWithEntityKeyDelegate, PublishModelEventWithEntityKeyContext, usePublishModelEventWithEntityKey, EspModelContextProvider, EspModelContextProviderProps, } from './espModelContextProvider';
|
|
@@ -1,22 +1,22 @@
|
|
|
1
|
-
export type
|
|
1
|
+
export type SyncModelWithSelectorEqualityFn<T> = (last: T, next: T) => boolean;
|
|
2
2
|
/**
|
|
3
3
|
* Options affecting the subscription of the model to the Router.
|
|
4
4
|
*
|
|
5
|
-
* Use
|
|
5
|
+
* Use syncModelWithSelectorOptions() to create an instance of this type with sensible defaults.
|
|
6
6
|
*
|
|
7
7
|
* @param modelId - the modelId of the model to be observed via the esp Router.
|
|
8
8
|
* @param tryPreSelectPolimerImmutableModel - if true, and the esp model is an esp-js-polimer model, the immutable model will be used when calling the selector.
|
|
9
9
|
* @param equalityFn - Equality function which will be applied against TSelected, defaults to instance equality (a === b).
|
|
10
10
|
*/
|
|
11
|
-
export type
|
|
11
|
+
export type SyncModelWithSelectorOptions<TSelected> = {
|
|
12
12
|
modelId?: string;
|
|
13
13
|
tryPreSelectPolimerImmutableModel: boolean;
|
|
14
|
-
equalityFn:
|
|
14
|
+
equalityFn: SyncModelWithSelectorEqualityFn<TSelected>;
|
|
15
15
|
};
|
|
16
16
|
/**
|
|
17
|
-
* Convenience API to build
|
|
17
|
+
* Convenience API to build SyncModelWithSelectorOptions<TSelected>, has sensible defaulting.
|
|
18
18
|
*/
|
|
19
|
-
export interface
|
|
19
|
+
export interface SyncModelWithSelectorOptionsBuilder<TSelected> extends SyncModelWithSelectorOptions<TSelected> {
|
|
20
20
|
/**
|
|
21
21
|
* Sets the model ID
|
|
22
22
|
* @param modelId - default if unset: undefined
|
|
@@ -34,9 +34,9 @@ export interface EditableModelSelectorOptions<TSelected> extends ModelSelectorOp
|
|
|
34
34
|
setEqualityFn(fn: (a: TSelected, b: TSelected) => boolean): this;
|
|
35
35
|
}
|
|
36
36
|
/**
|
|
37
|
-
* Convenience API to create
|
|
37
|
+
* Convenience API to create SyncModelWithSelectorOptions
|
|
38
38
|
*/
|
|
39
|
-
export declare const
|
|
39
|
+
export declare const syncModelWithSelectorOptions: <TSelected>() => SyncModelWithSelectorOptionsBuilder<TSelected>;
|
|
40
40
|
/**
|
|
41
41
|
* A hook which returns model state from the esp Router.
|
|
42
42
|
*
|
|
@@ -47,5 +47,4 @@ export declare const modelSelectorOptions: <TSelected>() => EditableModelSelecto
|
|
|
47
47
|
* @param selector - a function to select a selection of the model - the selector does not need to be memoized, this selector will be cached against the modelId.
|
|
48
48
|
* @param options
|
|
49
49
|
*/
|
|
50
|
-
export
|
|
51
|
-
export declare const useModelSelector: UseModelSelector;
|
|
50
|
+
export declare const useSyncModelWithSelector: <TModel, TSelected>(selector: (model: TModel) => TSelected, options?: SyncModelWithSelectorOptions<TSelected>) => TSelected;
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "esp-js-react",
|
|
3
|
-
"version": "8.0.
|
|
3
|
+
"version": "8.0.4-next.0",
|
|
4
4
|
"description": "Evented State Processor (ESP) React Components",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"esp",
|
|
@@ -24,8 +24,8 @@
|
|
|
24
24
|
"dev": "nps dev"
|
|
25
25
|
},
|
|
26
26
|
"dependencies": {
|
|
27
|
-
"esp-js": "^8.0.
|
|
28
|
-
"esp-js-polimer": "^8.0.
|
|
27
|
+
"esp-js": "^8.0.4-next.0",
|
|
28
|
+
"esp-js-polimer": "^8.0.4-next.0",
|
|
29
29
|
"prop-types": "^15.7.2",
|
|
30
30
|
"react": "^18.3.1",
|
|
31
31
|
"use-sync-external-store": "^1.2.2"
|
|
@@ -43,5 +43,5 @@
|
|
|
43
43
|
"prop-types": "^15.0.0",
|
|
44
44
|
"react": "^18.0.0"
|
|
45
45
|
},
|
|
46
|
-
"gitHead": "
|
|
46
|
+
"gitHead": "9685330192bf6c83ca1864e2d812e07d3cc98b64"
|
|
47
47
|
}
|
|
@@ -5,7 +5,7 @@ import {Router, utils} from 'esp-js';
|
|
|
5
5
|
import {EspModelContextProvider, useGetModelId} from './espModelContextProvider';
|
|
6
6
|
import {createViewForModel} from './viewBindingDecorator';
|
|
7
7
|
import {tryGetPolimerImmutableModel} from './polimer/getEspPolimerImmutableModel';
|
|
8
|
-
import {
|
|
8
|
+
import {syncModelWithSelectorOptions, useSyncModelWithSelector} from './useSyncModelWithSelector';
|
|
9
9
|
|
|
10
10
|
export type CreatePublishEventProps<TPublishEventProps> = (publishModelEvent: (eventType: string, event: any) => void) => TPublishEventProps;
|
|
11
11
|
|
|
@@ -79,9 +79,9 @@ export const ConnectableComponent = <TModel = {}, TPublishEventProps = {}, TMode
|
|
|
79
79
|
},
|
|
80
80
|
[router, modelId]
|
|
81
81
|
);
|
|
82
|
-
const model =
|
|
82
|
+
const model = useSyncModelWithSelector<TModel, TModel>(
|
|
83
83
|
m => m,
|
|
84
|
-
|
|
84
|
+
syncModelWithSelectorOptions()
|
|
85
85
|
.setModelId(modelId)
|
|
86
86
|
.setTryPreSelectPolimerImmutableModel(false)
|
|
87
87
|
);
|
|
@@ -5,23 +5,21 @@ import {useRouter} from './espRouterContextProvider';
|
|
|
5
5
|
|
|
6
6
|
const _log = Logger.create('EspModelContextProvider');
|
|
7
7
|
|
|
8
|
-
export
|
|
9
|
-
export const GetModelIdContext = createContext<GetModelIdDelegate>(null);
|
|
8
|
+
export const GetModelIdContext = createContext<string>(null);
|
|
10
9
|
/**
|
|
11
10
|
* Returns a function to get the ID of the model connected at a higher point in the V-DOM.
|
|
12
11
|
*
|
|
13
12
|
* To use this, please ensure your V-DOM has the EspModelContextProvider at a higher node.
|
|
14
13
|
*/
|
|
15
|
-
export const useGetModelId = () => useContext(GetModelIdContext)
|
|
14
|
+
export const useGetModelId = () => useContext(GetModelIdContext);
|
|
16
15
|
|
|
17
|
-
export
|
|
18
|
-
export const GetModelContext = createContext<GetModelDelegate>(null);
|
|
16
|
+
export const GetModelContext = createContext<object>(null);
|
|
19
17
|
/**
|
|
20
18
|
* Returns a function which will return the model connected at a higher point in the V-DOM.
|
|
21
19
|
*
|
|
22
20
|
* To use this, please ensure your V-DOM has the EspModelContextProvider at a higher node.
|
|
23
21
|
*/
|
|
24
|
-
export const useGetModel = <TModel,>() => useContext(GetModelContext)
|
|
22
|
+
export const useGetModel = <TModel,>() => useContext(GetModelContext) as TModel;
|
|
25
23
|
|
|
26
24
|
export type PublishModelEventDelegate = (eventType: string, event: any) => void;
|
|
27
25
|
export const PublishModelEventContext = createContext<PublishModelEventDelegate>(null);
|
|
@@ -47,7 +45,7 @@ export const usePublishModelEventWithEntityKey = () => useContext(PublishModelEv
|
|
|
47
45
|
|
|
48
46
|
export interface EspModelContextProviderProps {
|
|
49
47
|
modelId: string;
|
|
50
|
-
model?:
|
|
48
|
+
model?: any;
|
|
51
49
|
}
|
|
52
50
|
|
|
53
51
|
/**
|
|
@@ -61,13 +59,6 @@ export interface EspModelContextProviderProps {
|
|
|
61
59
|
*/
|
|
62
60
|
export const EspModelContextProvider = ({modelId, children, model}: PropsWithChildren<EspModelContextProviderProps>) => {
|
|
63
61
|
const router = useRouter();
|
|
64
|
-
const getModelId: () => string = useCallback(() => {
|
|
65
|
-
return modelId;
|
|
66
|
-
}, [router, modelId]);
|
|
67
|
-
const getModel: () => any = useCallback(() => {
|
|
68
|
-
warnIfModelAccessedOutSideDispatchLoop(router, modelId);
|
|
69
|
-
return model;
|
|
70
|
-
}, [model, router, modelId]);
|
|
71
62
|
const publishModelEvent: PublishModelEventDelegate = useCallback((eventType: string, event: any) => {
|
|
72
63
|
router.publishEvent(modelId, eventType, event);
|
|
73
64
|
}, [router, modelId]);
|
|
@@ -75,38 +66,14 @@ export const EspModelContextProvider = ({modelId, children, model}: PropsWithChi
|
|
|
75
66
|
router.publishEvent(new DefaultModelAddress(modelId, entityKey), eventType, event);
|
|
76
67
|
}, [router, modelId]);
|
|
77
68
|
return (
|
|
78
|
-
<GetModelIdContext.Provider value={
|
|
69
|
+
<GetModelIdContext.Provider value={modelId}>
|
|
79
70
|
<PublishModelEventContext.Provider value={publishModelEvent}>
|
|
80
71
|
<PublishModelEventWithEntityKeyContext.Provider value={publishModelEventWithEntityKey}>
|
|
81
|
-
<GetModelContext.Provider value={
|
|
72
|
+
<GetModelContext.Provider value={model}>
|
|
82
73
|
{children}
|
|
83
74
|
</GetModelContext.Provider>
|
|
84
75
|
</PublishModelEventWithEntityKeyContext.Provider>
|
|
85
76
|
</PublishModelEventContext.Provider>
|
|
86
77
|
</GetModelIdContext.Provider>
|
|
87
78
|
);
|
|
88
|
-
};
|
|
89
|
-
|
|
90
|
-
const warnIfModelAccessedOutSideDispatchLoop = (router: Router, modelId: string) => {
|
|
91
|
-
if (process.env.NODE_ENV === 'production') {
|
|
92
|
-
return;
|
|
93
|
-
}
|
|
94
|
-
if (utils.stringIsEmpty(modelId)) {
|
|
95
|
-
return;
|
|
96
|
-
}
|
|
97
|
-
let isDispatchModelUpdateStatus = router.isModelDispatchStatus(modelId, Status.DispatchModelUpdates);
|
|
98
|
-
if (!isDispatchModelUpdateStatus) {
|
|
99
|
-
let stack: string | undefined = undefined;
|
|
100
|
-
try {
|
|
101
|
-
// noinspection ExceptionCaughtLocallyJS
|
|
102
|
-
throw new Error();
|
|
103
|
-
} catch (e) {
|
|
104
|
-
stack = (e as Error).stack;
|
|
105
|
-
}
|
|
106
|
-
_log.warn(
|
|
107
|
-
`EspModelContextProvider useGetModelId has been invoked outside of the models (${modelId}) dispatch loop. ` +
|
|
108
|
-
`This may have unknown state issues.` +
|
|
109
|
-
stack
|
|
110
|
-
);
|
|
111
|
-
}
|
|
112
79
|
};
|
package/src/index.ts
CHANGED
|
@@ -40,13 +40,12 @@ export {
|
|
|
40
40
|
ConnectableComponent,
|
|
41
41
|
} from './connectableComponent';
|
|
42
42
|
export {
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
} from './useModelSelector';
|
|
43
|
+
useSyncModelWithSelector,
|
|
44
|
+
SyncModelWithSelectorOptionsBuilder,
|
|
45
|
+
syncModelWithSelectorOptions,
|
|
46
|
+
SyncModelWithSelectorOptions,
|
|
47
|
+
SyncModelWithSelectorEqualityFn,
|
|
48
|
+
} from './useSyncModelWithSelector';
|
|
50
49
|
export {
|
|
51
50
|
RouterProvider,
|
|
52
51
|
RouterProviderProps,
|
|
@@ -60,10 +59,8 @@ export {
|
|
|
60
59
|
} from './espRouterContextProvider';
|
|
61
60
|
export {
|
|
62
61
|
useGetModelId,
|
|
63
|
-
GetModelIdDelegate,
|
|
64
62
|
GetModelIdContext,
|
|
65
63
|
useGetModel,
|
|
66
|
-
GetModelDelegate,
|
|
67
64
|
GetModelContext,
|
|
68
65
|
PublishModelEventDelegate,
|
|
69
66
|
PublishModelEventContext,
|
|
@@ -5,27 +5,27 @@ import {useRouter} from './espRouterContextProvider';
|
|
|
5
5
|
import {useGetModelId} from './espModelContextProvider';
|
|
6
6
|
import {tryGetPolimerImmutableModel} from './polimer/getEspPolimerImmutableModel';
|
|
7
7
|
|
|
8
|
-
export type
|
|
8
|
+
export type SyncModelWithSelectorEqualityFn<T> = (last: T, next: T) => boolean;
|
|
9
9
|
|
|
10
10
|
/**
|
|
11
11
|
* Options affecting the subscription of the model to the Router.
|
|
12
12
|
*
|
|
13
|
-
* Use
|
|
13
|
+
* Use syncModelWithSelectorOptions() to create an instance of this type with sensible defaults.
|
|
14
14
|
*
|
|
15
15
|
* @param modelId - the modelId of the model to be observed via the esp Router.
|
|
16
16
|
* @param tryPreSelectPolimerImmutableModel - if true, and the esp model is an esp-js-polimer model, the immutable model will be used when calling the selector.
|
|
17
17
|
* @param equalityFn - Equality function which will be applied against TSelected, defaults to instance equality (a === b).
|
|
18
18
|
*/
|
|
19
|
-
export type
|
|
19
|
+
export type SyncModelWithSelectorOptions<TSelected> = {
|
|
20
20
|
modelId?: string,
|
|
21
21
|
tryPreSelectPolimerImmutableModel: boolean,
|
|
22
|
-
equalityFn:
|
|
22
|
+
equalityFn: SyncModelWithSelectorEqualityFn<TSelected>
|
|
23
23
|
};
|
|
24
24
|
|
|
25
25
|
/**
|
|
26
|
-
* Convenience API to build
|
|
26
|
+
* Convenience API to build SyncModelWithSelectorOptions<TSelected>, has sensible defaulting.
|
|
27
27
|
*/
|
|
28
|
-
export interface
|
|
28
|
+
export interface SyncModelWithSelectorOptionsBuilder<TSelected> extends SyncModelWithSelectorOptions<TSelected> {
|
|
29
29
|
/**
|
|
30
30
|
* Sets the model ID
|
|
31
31
|
* @param modelId - default if unset: undefined
|
|
@@ -46,11 +46,11 @@ export interface EditableModelSelectorOptions<TSelected> extends ModelSelectorOp
|
|
|
46
46
|
}
|
|
47
47
|
|
|
48
48
|
/**
|
|
49
|
-
* Convenience API to create
|
|
49
|
+
* Convenience API to create SyncModelWithSelectorOptions
|
|
50
50
|
*/
|
|
51
|
-
export const
|
|
51
|
+
export const syncModelWithSelectorOptions = <TSelected>() => {
|
|
52
52
|
let modelId = undefined;
|
|
53
|
-
let equalityFn:
|
|
53
|
+
let equalityFn: SyncModelWithSelectorEqualityFn<TSelected> = (a: TSelected, b: TSelected) => a === b;
|
|
54
54
|
let tryPreSelectPolimerImmutableModel = true;
|
|
55
55
|
return {
|
|
56
56
|
get modelId() {
|
|
@@ -63,7 +63,7 @@ export const modelSelectorOptions = <TSelected>() => {
|
|
|
63
63
|
get equalityFn() {
|
|
64
64
|
return equalityFn;
|
|
65
65
|
},
|
|
66
|
-
setEqualityFn(value:
|
|
66
|
+
setEqualityFn(value: SyncModelWithSelectorEqualityFn<TSelected>) {
|
|
67
67
|
equalityFn = value;
|
|
68
68
|
return this;
|
|
69
69
|
},
|
|
@@ -74,7 +74,19 @@ export const modelSelectorOptions = <TSelected>() => {
|
|
|
74
74
|
tryPreSelectPolimerImmutableModel = value;
|
|
75
75
|
return this;
|
|
76
76
|
}
|
|
77
|
-
} as
|
|
77
|
+
} as SyncModelWithSelectorOptionsBuilder<TSelected>;
|
|
78
|
+
};
|
|
79
|
+
|
|
80
|
+
const checkArguments = (selector: (model: any) => any, options: SyncModelWithSelectorOptions<any> ) => {
|
|
81
|
+
if (!utils.isFunction(selector)) {
|
|
82
|
+
throw new Error('You must pass a selector function to useSyncModelWithSelector');
|
|
83
|
+
}
|
|
84
|
+
if (!utils.isObject(options)) {
|
|
85
|
+
throw new Error('You must provide options when using useSyncModelWithSelector');
|
|
86
|
+
}
|
|
87
|
+
if (!utils.isFunction(options.equalityFn)) {
|
|
88
|
+
throw new Error('You must provide an equalityFn when using useSyncModelWithSelector');
|
|
89
|
+
}
|
|
78
90
|
};
|
|
79
91
|
|
|
80
92
|
/**
|
|
@@ -87,16 +99,11 @@ export const modelSelectorOptions = <TSelected>() => {
|
|
|
87
99
|
* @param selector - a function to select a selection of the model - the selector does not need to be memoized, this selector will be cached against the modelId.
|
|
88
100
|
* @param options
|
|
89
101
|
*/
|
|
90
|
-
export
|
|
91
|
-
selector: (model: TModel) => TSelected,
|
|
92
|
-
options?: ModelSelectorOptions<TSelected>
|
|
93
|
-
) => TSelected;
|
|
94
|
-
|
|
95
|
-
export const useModelSelector: UseModelSelector = <TModel, TSelected>(
|
|
102
|
+
export const useSyncModelWithSelector = <TModel, TSelected>(
|
|
96
103
|
selector: (model: TModel) => TSelected,
|
|
97
|
-
options:
|
|
98
|
-
) => {
|
|
99
|
-
|
|
104
|
+
options: SyncModelWithSelectorOptions<TSelected> = syncModelWithSelectorOptions<TSelected>()
|
|
105
|
+
): TSelected => {
|
|
106
|
+
checkArguments(selector, options);
|
|
100
107
|
const router = useRouter();
|
|
101
108
|
const modelId = options?.modelId || useGetModelId();
|
|
102
109
|
const tryPreSelectPolimerImmutableModel = options?.tryPreSelectPolimerImmutableModel;
|
package/tests/indexTests.ts
CHANGED
|
@@ -28,8 +28,8 @@ describe('index exports', () => {
|
|
|
28
28
|
expect(espReact.createViewForModel).toBeDefined();
|
|
29
29
|
expect(espReact.connect).toBeDefined();
|
|
30
30
|
expect(espReact.ConnectableComponent).toBeDefined();
|
|
31
|
-
expect(espReact.
|
|
32
|
-
expect(espReact.
|
|
31
|
+
expect(espReact.useSyncModelWithSelector).toBeDefined();
|
|
32
|
+
expect(espReact.syncModelWithSelectorOptions).toBeDefined();
|
|
33
33
|
expect(espReact.RouterProvider).toBeDefined();
|
|
34
34
|
expect(espReact.EspRouterContextProvider).toBeDefined();
|
|
35
35
|
expect(espReact.RouterContext).toBeDefined();
|