From 506491eed9c4670f060f58959dc75663da51bbe4 Mon Sep 17 00:00:00 2001 From: Kyle Geib Date: Tue, 11 Jan 2022 17:12:05 -0500 Subject: [PATCH 1/9] ISSUE-017 - Initial work on the Overlay Tool. Have basic state management in place and a number of simple prototypes in place to practice floating a div above the interface. --- src/App.tsx | 23 ++++-- src/components/Broadcast/BroadcastRoute.tsx | 4 +- .../OverlayControl/OverlayControl.tsx | 82 +++++++++++++++++++ .../OverlayDisplay/OverlayDisplay.tsx | 17 ++++ .../OverlayTool/OverlayDisplay/styles.ts | 20 +++++ src/components/OverlayTool/index.ts | 2 + .../Workspace/WorkspaceControls.tsx | 2 + src/components/Workspaces/WorkspacesRoute.tsx | 6 +- .../overlayTool/overlayToolSelector.ts | 3 + src/features/overlayTool/overlayToolSlice.ts | 79 ++++++++++++++++++ .../pageDimensions/pageDimensionsSelector.ts | 5 +- .../pageDimensions/pageDimensionsSlice.ts | 11 ++- src/store.ts | 2 + src/types/state.d.ts | 23 ++++++ 14 files changed, 265 insertions(+), 14 deletions(-) create mode 100644 src/components/OverlayTool/OverlayControl/OverlayControl.tsx create mode 100644 src/components/OverlayTool/OverlayDisplay/OverlayDisplay.tsx create mode 100644 src/components/OverlayTool/OverlayDisplay/styles.ts create mode 100644 src/components/OverlayTool/index.ts create mode 100644 src/features/overlayTool/overlayToolSelector.ts create mode 100644 src/features/overlayTool/overlayToolSlice.ts diff --git a/src/App.tsx b/src/App.tsx index 3b1e5de..839640c 100644 --- a/src/App.tsx +++ b/src/App.tsx @@ -1,7 +1,10 @@ import { Outlet } from "react-router-dom"; import { useDimensions } from "./utils/hooks"; -import { setMenuDimensions } from "./features/pageDimensions/pageDimensionsSlice"; +import { + setMenuDimensions, + setAppDimensions, +} from "./features/pageDimensions/pageDimensionsSlice"; import { MainMenu } from "./components/Menu"; import { useDispatch } from "react-redux"; @@ -9,16 +12,22 @@ import { useEffect } from "react"; function App() { const dispatch = useDispatch(); - const [ref, { height }] = useDimensions(); + const [appRef, { height: appHeight, width: appWidth }] = useDimensions(); + const [mainMenuRef, { height: mainMenuHeight }] = useDimensions(); + // Set App height and width. useEffect(() => { - // Make sure to not dispatch during a render. - dispatch(setMenuDimensions({ height })); - }, [height]); + dispatch(setAppDimensions({ height: appHeight, width: appWidth })); + }, [appHeight, appWidth]); + + // Set MainMenu height. + useEffect(() => { + dispatch(setMenuDimensions({ height: mainMenuHeight })); + }, [mainMenuHeight]); return ( -
- +
+
); diff --git a/src/components/Broadcast/BroadcastRoute.tsx b/src/components/Broadcast/BroadcastRoute.tsx index 1040288..cf1e7ba 100644 --- a/src/components/Broadcast/BroadcastRoute.tsx +++ b/src/components/Broadcast/BroadcastRoute.tsx @@ -2,10 +2,10 @@ import { useSelector } from "react-redux"; import { FullScreenContainer } from "../Common/FullScreenContainer.styled"; import { Layout } from "./Layout"; -import { menuSelector } from "../../features/pageDimensions/pageDimensionsSelector"; +import { menuDimensionsSelector } from "../../features/pageDimensions/pageDimensionsSelector"; export default function Broadcast() { - const { height } = useSelector(menuSelector); + const { height } = useSelector(menuDimensionsSelector); return ( diff --git a/src/components/OverlayTool/OverlayControl/OverlayControl.tsx b/src/components/OverlayTool/OverlayControl/OverlayControl.tsx new file mode 100644 index 0000000..5d6d684 --- /dev/null +++ b/src/components/OverlayTool/OverlayControl/OverlayControl.tsx @@ -0,0 +1,82 @@ +import { useState } from "react"; +import { useSelector, useDispatch } from "react-redux"; +import { PadBox } from "@bedrock-layout/padbox"; + +import { appDimensionsSelector } from "../../../features/pageDimensions/pageDimensionsSelector"; +import { overlayToolSelector } from "../../../features/overlayTool/overlayToolSelector"; +import { + initNewOverlayItem, + setCurrentOverlayId, + setPosition, + setVisibility, +} from "../../../features/overlayTool/overlayToolSlice"; + +import { Toggle } from "../../Common/Inputs/Toggle"; + + +export function OverlayControl() { + const dispatch = useDispatch(); + const { visible, currentOverlayItem } = useSelector(overlayToolSelector); + + + + + /* For prototyping use only */ + const { width: appWidth, height: appHeight } = useSelector(appDimensionsSelector); + const [overlayId, setOverlayId] = useState("foo_1.00000"); + const { width, height } = useSelector(appDimensionsSelector); + + const getRandomArbitrary = (min: number, max: number) => + Math.random() * (max - min) + min; + + const posRandomizer = () => { + dispatch(setPosition({ + x: Math.floor(getRandomArbitrary(50, width - 50)), + y: Math.floor(getRandomArbitrary(50, height - 50)), + })); + }; + const idRandomizer = () => { + const newId = `id_${getRandomArbitrary(1, 10)}`.slice(0, 10); + setOverlayId(newId); + dispatch(setCurrentOverlayId(newId)); + }; + /* For prototyping use only */ + + + + const onToggle = (value: boolean) => { + if (currentOverlayItem == null) { + dispatch(initNewOverlayItem({ + overlayId, + appDimensions: { height: appHeight, width: appWidth }, + })); + } + dispatch(setVisibility(value)); + }; + + return ( + + + + {/* For prototyping use only */} +
+ + Random Location + +
+ + Id: {overlayId} + + {/* For prototyping use only */} + +
+ ); +} diff --git a/src/components/OverlayTool/OverlayDisplay/OverlayDisplay.tsx b/src/components/OverlayTool/OverlayDisplay/OverlayDisplay.tsx new file mode 100644 index 0000000..2b0610d --- /dev/null +++ b/src/components/OverlayTool/OverlayDisplay/OverlayDisplay.tsx @@ -0,0 +1,17 @@ +import { useSelector } from "react-redux"; +import { overlayToolSelector } from "../../../features/overlayTool/overlayToolSelector"; + +import { OverlayItemContainer } from "./styles"; + +export function OverlayDisplay() { + const { currentOverlayItem } = useSelector(overlayToolSelector); + if (currentOverlayItem == null) return null; + const { id, position } = currentOverlayItem; + return ( + + {id} +
+ ({position.x}px {position.y}px) +
+ ); +} diff --git a/src/components/OverlayTool/OverlayDisplay/styles.ts b/src/components/OverlayTool/OverlayDisplay/styles.ts new file mode 100644 index 0000000..e843298 --- /dev/null +++ b/src/components/OverlayTool/OverlayDisplay/styles.ts @@ -0,0 +1,20 @@ +import styled from "styled-components"; +import { OverlayPosition } from "../../../types/state"; + +export type OverlayItemContainerProps = { + position: OverlayPosition, +}; +export const OverlayItemContainer = styled.div.attrs(({ + position: { x, y }, +}) => ({ + style: { + top: y, + left: x, + }, +}))` + position: absolute; + width: 150px; + height: 150px; + background-color: white; + box-shadow: 0px 7px 11px 1px black; +`; diff --git a/src/components/OverlayTool/index.ts b/src/components/OverlayTool/index.ts new file mode 100644 index 0000000..7f14705 --- /dev/null +++ b/src/components/OverlayTool/index.ts @@ -0,0 +1,2 @@ +export { OverlayDisplay } from "./OverlayDisplay/OverlayDisplay"; +export { OverlayControl } from "./OverlayControl/OverlayControl"; diff --git a/src/components/Workspaces/Workspace/WorkspaceControls.tsx b/src/components/Workspaces/Workspace/WorkspaceControls.tsx index a88c1f9..06ec061 100644 --- a/src/components/Workspaces/Workspace/WorkspaceControls.tsx +++ b/src/components/Workspaces/Workspace/WorkspaceControls.tsx @@ -6,6 +6,7 @@ import { setAnimatedBG } from "../../../features/workspace/workspaceSlice"; import { AnimatedBG } from "../../../types/state"; import { Toggle } from "../../Common/Inputs/Toggle"; +import { OverlayControl } from "../../OverlayTool"; export const WorkspaceControls = () => { const dispatch = useDispatch(); @@ -19,6 +20,7 @@ export const WorkspaceControls = () => { onToggle={(value: AnimatedBG) => { dispatch(setAnimatedBG(value)); }} /> + ); }; diff --git a/src/components/Workspaces/WorkspacesRoute.tsx b/src/components/Workspaces/WorkspacesRoute.tsx index 0a5de85..2d0c105 100644 --- a/src/components/Workspaces/WorkspacesRoute.tsx +++ b/src/components/Workspaces/WorkspacesRoute.tsx @@ -1,14 +1,15 @@ import { useSelector } from "react-redux"; import { Outlet } from "react-router-dom"; -import { menuSelector } from "../../features/pageDimensions/pageDimensionsSelector"; +import { menuDimensionsSelector } from "../../features/pageDimensions/pageDimensionsSelector"; import { FullScreenContainer } from "../Common/FullScreenContainer.styled"; import { WorkspaceList } from "./WorkspaceList"; import { LayoutGrid, LayoutGridItem } from "../Common/LayoutGrid.styled"; +import { OverlayDisplay } from "../OverlayTool"; export default function Workspaces() { - const { height } = useSelector(menuSelector); + const { height } = useSelector(menuDimensionsSelector); return ( @@ -18,6 +19,7 @@ export default function Workspaces() { + diff --git a/src/features/overlayTool/overlayToolSelector.ts b/src/features/overlayTool/overlayToolSelector.ts new file mode 100644 index 0000000..8c3523d --- /dev/null +++ b/src/features/overlayTool/overlayToolSelector.ts @@ -0,0 +1,3 @@ +import { RootState } from "../../types/state"; + +export const overlayToolSelector = (state: RootState) => state.overlayTool; diff --git a/src/features/overlayTool/overlayToolSlice.ts b/src/features/overlayTool/overlayToolSlice.ts new file mode 100644 index 0000000..dba96ad --- /dev/null +++ b/src/features/overlayTool/overlayToolSlice.ts @@ -0,0 +1,79 @@ +import { createSlice, PayloadAction } from "@reduxjs/toolkit"; + +import { + RootState, + OverlayPosition, + OverlayId, + AppDimensions, +} from "../../types/state"; + +const initialState: RootState["overlayTool"] = { + overlayIds: [], + currentOverlayId: null, + currentOverlayItem: null, + visible: false, +}; + +const makeNewOverlayItem = ( + overlayId: OverlayId, + appDimensions: AppDimensions, +) => ({ + id: overlayId, + position: { + x: appDimensions.width / 2, + y: appDimensions.height / 2, + }, + opacity: 1, + scale: 1, +}); + + +type InitNewOverlayItemAction = { + overlayId: OverlayId, + appDimensions: AppDimensions, +}; + +export const overlayToolSlice = createSlice({ + name: "overlayTool", + initialState, + reducers: { + initNewOverlayItem: (state, action: PayloadAction) => { + if (state.currentOverlayItem == null) { + state.currentOverlayItem = makeNewOverlayItem( + action.payload.overlayId, + action.payload.appDimensions, + ); + state.currentOverlayId = action.payload.overlayId; + } + }, + setVisibility: (state, action: PayloadAction) => { + state.visible = action.payload; + }, + setOverlayIds: (state, action: PayloadAction>) => { + state.overlayIds = action.payload; + }, + setCurrentOverlayId: (state, action: PayloadAction) => { + if ( + action.payload !== state.currentOverlayId && + state.currentOverlayItem != null + ) { + state.currentOverlayId = action.payload; + state.currentOverlayItem.id = action.payload; + } + }, + setPosition: (state, action: PayloadAction) => { + if (state.currentOverlayItem != null) { + state.currentOverlayItem.position = action.payload; + } + }, + }, +}); + +export const { + initNewOverlayItem, + setVisibility, + setOverlayIds, + setCurrentOverlayId, + setPosition, +} = overlayToolSlice.actions; +export default overlayToolSlice.reducer; diff --git a/src/features/pageDimensions/pageDimensionsSelector.ts b/src/features/pageDimensions/pageDimensionsSelector.ts index 413d347..f9db815 100644 --- a/src/features/pageDimensions/pageDimensionsSelector.ts +++ b/src/features/pageDimensions/pageDimensionsSelector.ts @@ -1,3 +1,6 @@ import { RootState } from "../../types/state"; -export const menuSelector = (state: RootState) => state.pageDimensions.menu; +export const menuDimensionsSelector = (state: RootState) => + state.pageDimensions.menu; +export const appDimensionsSelector = (state: RootState) => + state.pageDimensions.app; diff --git a/src/features/pageDimensions/pageDimensionsSlice.ts b/src/features/pageDimensions/pageDimensionsSlice.ts index fd1c5f2..9c2128a 100644 --- a/src/features/pageDimensions/pageDimensionsSlice.ts +++ b/src/features/pageDimensions/pageDimensionsSlice.ts @@ -1,11 +1,15 @@ import { createSlice, PayloadAction } from "@reduxjs/toolkit"; -import { RootState, MenuDimensions } from "../../types/state"; +import { RootState, MenuDimensions, AppDimensions } from "../../types/state"; const initialState: RootState["pageDimensions"] = { menu: { height: 0, }, + app: { + height: 0, + width: 0, + }, }; export const pageDimensionsSlice = createSlice({ @@ -15,8 +19,11 @@ export const pageDimensionsSlice = createSlice({ setMenuDimensions: (state, action: PayloadAction) => { state.menu = action.payload; }, + setAppDimensions: (state, action: PayloadAction) => { + state.app = action.payload; + }, }, }); -export const { setMenuDimensions } = pageDimensionsSlice.actions; +export const { setMenuDimensions, setAppDimensions } = pageDimensionsSlice.actions; export default pageDimensionsSlice.reducer; diff --git a/src/store.ts b/src/store.ts index ff421a5..5cc2731 100644 --- a/src/store.ts +++ b/src/store.ts @@ -2,10 +2,12 @@ import { configureStore, combineReducers } from "@reduxjs/toolkit"; import pageDimensions from "./features/pageDimensions/pageDimensionsSlice"; import workspace from "./features/workspace/workspaceSlice"; +import overlayTool from "./features/overlayTool/overlayToolSlice"; export const store = configureStore({ reducer: combineReducers({ pageDimensions, workspace, + overlayTool, }), }); diff --git a/src/types/state.d.ts b/src/types/state.d.ts index 07edffe..2591d87 100644 --- a/src/types/state.d.ts +++ b/src/types/state.d.ts @@ -1,16 +1,22 @@ export type RootState = { pageDimensions: PageDimensions, workspace: Workspace, + overlayTool: OverlayTool, }; // Page Dimensions export type PageDimensions = { menu: MenuDimensions, + app: AppDimensions, }; export type MenuDimensions = { height: number, }; +export type AppDimensions = { + height: number, + width: number, +}; // Workspace export type Workspace = { @@ -20,3 +26,20 @@ export type Workspace = { export type WorkspaceId = string; export type AnimatedBG = boolean; + +// Overlay Tool +export type OverlayTool = { + // workspaceId: WorkspaceId, + overlayIds: Array, + currentOverlayId: OverlayId | null, + currentOverlayItem: OverlayItem | null, + visible: boolean, +}; +export type OverlayId = string; +export type OverlayPosition = { x: number, y: number }; +export type OverlayItem = { + id: OverlayId, + position: OverlayPosition, + opacity: number, + scale: number, +}; From 61b60b98199fb53b65173508f7038a953ef67dc2 Mon Sep 17 00:00:00 2001 From: Kyle Geib Date: Tue, 11 Jan 2022 19:12:21 -0500 Subject: [PATCH 2/9] ISSUE-017 - Improvements to a number of things. * Moved FullScreenContainer in WorkspacesRoute to make scrolling much better. Seriously, 100% works better. * Simplified dimensions state actions to a shared one. * Abandoned the noisy and useless "AnimatedBG" type. * Added workspace dimensions state (I'll need this later to prevent off-screen dragging). * Placed OverlayDisplay component in PreviewWindow, where it makes more sense. I'll still allow it to roam around outside of it, though. * Renamed "menu" dimensions to "mainMenu". * Improved initNewOverlayItem action to support setting visible. * Correct handling of showing the OverlayItemContainer. * Simplified the initial position of a new OverlayItem to a simple initial value instead of setting it in the middle of provided dimensions. * Made PreviewWindow `position: relative` to allow absolute positioning of OverlayItem from it. * Added importHelpers to tsconfig because VSCode was complaining about it. --- src/App.tsx | 29 +++++++---- src/components/Broadcast/BroadcastRoute.tsx | 4 +- .../Common/Inputs/Toggle/Toggle.tsx | 4 +- .../OverlayControl/OverlayControl.tsx | 13 +++-- .../OverlayDisplay/OverlayDisplay.tsx | 10 +++- .../OverlayTool/OverlayDisplay/styles.ts | 5 ++ .../Workspaces/Workspace/Workspace.tsx | 2 + .../Workspace/WorkspaceControls.tsx | 3 +- src/components/Workspaces/Workspace/styles.ts | 1 + src/components/Workspaces/WorkspacesRoute.tsx | 50 +++++++++++++------ src/features/overlayTool/overlayToolSlice.ts | 14 +++--- .../pageDimensions/pageDimensionsSelector.ts | 6 ++- .../pageDimensions/pageDimensionsSlice.ts | 26 +++++----- src/features/workspace/workspaceSlice.ts | 4 +- src/types/state.d.ts | 17 ++----- tsconfig.json | 1 + 16 files changed, 113 insertions(+), 76 deletions(-) diff --git a/src/App.tsx b/src/App.tsx index 839640c..a6f7128 100644 --- a/src/App.tsx +++ b/src/App.tsx @@ -2,8 +2,7 @@ import { Outlet } from "react-router-dom"; import { useDimensions } from "./utils/hooks"; import { - setMenuDimensions, - setAppDimensions, + setDimensions, } from "./features/pageDimensions/pageDimensionsSlice"; import { MainMenu } from "./components/Menu"; @@ -12,18 +11,30 @@ import { useEffect } from "react"; function App() { const dispatch = useDispatch(); - const [appRef, { height: appHeight, width: appWidth }] = useDimensions(); - const [mainMenuRef, { height: mainMenuHeight }] = useDimensions(); + const [appRef, { + height: appHeight, + width: appWidth, + }] = useDimensions(); + const [mainMenuRef, { + height: mainMenuHeight, + width: mainMenuWidth, + }] = useDimensions(); - // Set App height and width. + // Set App dimensions. useEffect(() => { - dispatch(setAppDimensions({ height: appHeight, width: appWidth })); + dispatch(setDimensions({ + name: "app", + dimensions: { height: appHeight, width: appWidth }, + })); }, [appHeight, appWidth]); - // Set MainMenu height. + // Set MainMenu dimensions. useEffect(() => { - dispatch(setMenuDimensions({ height: mainMenuHeight })); - }, [mainMenuHeight]); + dispatch(setDimensions({ + name: "mainMenu", + dimensions: { height: mainMenuHeight, width: mainMenuWidth }, + })); + }, [mainMenuHeight, mainMenuWidth]); return (
diff --git a/src/components/Broadcast/BroadcastRoute.tsx b/src/components/Broadcast/BroadcastRoute.tsx index cf1e7ba..fbff5da 100644 --- a/src/components/Broadcast/BroadcastRoute.tsx +++ b/src/components/Broadcast/BroadcastRoute.tsx @@ -2,10 +2,10 @@ import { useSelector } from "react-redux"; import { FullScreenContainer } from "../Common/FullScreenContainer.styled"; import { Layout } from "./Layout"; -import { menuDimensionsSelector } from "../../features/pageDimensions/pageDimensionsSelector"; +import { mainMenuDimensionsSelector } from "../../features/pageDimensions/pageDimensionsSelector"; export default function Broadcast() { - const { height } = useSelector(menuDimensionsSelector); + const { height } = useSelector(mainMenuDimensionsSelector); return ( diff --git a/src/components/Common/Inputs/Toggle/Toggle.tsx b/src/components/Common/Inputs/Toggle/Toggle.tsx index 8273ede..43b7876 100644 --- a/src/components/Common/Inputs/Toggle/Toggle.tsx +++ b/src/components/Common/Inputs/Toggle/Toggle.tsx @@ -1,5 +1,5 @@ import { useState } from "react"; -import { AnimatedBG } from "../../../../types/state"; + import { ToggleContainer, ToggleBody, @@ -12,7 +12,7 @@ import { export type ToggleProps = { label: string, toggled: boolean, - onToggle: (value: AnimatedBG) => void, + onToggle: (value: boolean) => void, // eslint-disable-line no-unused-vars showIndicators?: boolean, }; /** diff --git a/src/components/OverlayTool/OverlayControl/OverlayControl.tsx b/src/components/OverlayTool/OverlayControl/OverlayControl.tsx index 5d6d684..b6c76f1 100644 --- a/src/components/OverlayTool/OverlayControl/OverlayControl.tsx +++ b/src/components/OverlayTool/OverlayControl/OverlayControl.tsx @@ -2,7 +2,6 @@ import { useState } from "react"; import { useSelector, useDispatch } from "react-redux"; import { PadBox } from "@bedrock-layout/padbox"; -import { appDimensionsSelector } from "../../../features/pageDimensions/pageDimensionsSelector"; import { overlayToolSelector } from "../../../features/overlayTool/overlayToolSelector"; import { initNewOverlayItem, @@ -22,17 +21,15 @@ export function OverlayControl() { /* For prototyping use only */ - const { width: appWidth, height: appHeight } = useSelector(appDimensionsSelector); const [overlayId, setOverlayId] = useState("foo_1.00000"); - const { width, height } = useSelector(appDimensionsSelector); const getRandomArbitrary = (min: number, max: number) => Math.random() * (max - min) + min; const posRandomizer = () => { dispatch(setPosition({ - x: Math.floor(getRandomArbitrary(50, width - 50)), - y: Math.floor(getRandomArbitrary(50, height - 50)), + x: Math.floor(getRandomArbitrary(-50, 850)), + y: Math.floor(getRandomArbitrary(-50, 650)), })); }; const idRandomizer = () => { @@ -48,10 +45,12 @@ export function OverlayControl() { if (currentOverlayItem == null) { dispatch(initNewOverlayItem({ overlayId, - appDimensions: { height: appHeight, width: appWidth }, + initialPosition: { x: 400, y: 300 }, + setVisible: true, })); + } else { + dispatch(setVisibility(value)); } - dispatch(setVisibility(value)); }; return ( diff --git a/src/components/OverlayTool/OverlayDisplay/OverlayDisplay.tsx b/src/components/OverlayTool/OverlayDisplay/OverlayDisplay.tsx index 2b0610d..be3d70d 100644 --- a/src/components/OverlayTool/OverlayDisplay/OverlayDisplay.tsx +++ b/src/components/OverlayTool/OverlayDisplay/OverlayDisplay.tsx @@ -4,11 +4,17 @@ import { overlayToolSelector } from "../../../features/overlayTool/overlayToolSe import { OverlayItemContainer } from "./styles"; export function OverlayDisplay() { - const { currentOverlayItem } = useSelector(overlayToolSelector); + const { currentOverlayItem, visible } = useSelector(overlayToolSelector); + if (currentOverlayItem == null) return null; + const { id, position } = currentOverlayItem; + return ( - + {id}
({position.x}px {position.y}px) diff --git a/src/components/OverlayTool/OverlayDisplay/styles.ts b/src/components/OverlayTool/OverlayDisplay/styles.ts index e843298..6ff1885 100644 --- a/src/components/OverlayTool/OverlayDisplay/styles.ts +++ b/src/components/OverlayTool/OverlayDisplay/styles.ts @@ -3,16 +3,21 @@ import { OverlayPosition } from "../../../types/state"; export type OverlayItemContainerProps = { position: OverlayPosition, + visible: boolean, }; export const OverlayItemContainer = styled.div.attrs(({ position: { x, y }, + visible, }) => ({ style: { top: y, left: x, + display: visible ? undefined : "none", }, }))` position: absolute; + + /* Temporary. Overlay will be transparent and based on an image. */ width: 150px; height: 150px; background-color: white; diff --git a/src/components/Workspaces/Workspace/Workspace.tsx b/src/components/Workspaces/Workspace/Workspace.tsx index 398c8d7..2f8a764 100644 --- a/src/components/Workspaces/Workspace/Workspace.tsx +++ b/src/components/Workspaces/Workspace/Workspace.tsx @@ -8,6 +8,7 @@ import { workspaceSelector } from "../../../features/workspace/workspaceSelector import { PreviewWindow, H2, ControlsContainer } from "./styles"; import { WorkspaceControls } from "./WorkspaceControls"; import { MockupBlock } from "../../Common/MockupBlock.styled"; +import { OverlayDisplay } from "../../OverlayTool"; import { workspaceObject } from "../workspaces"; @@ -28,6 +29,7 @@ export const Workspace = () => { height="300px" width="400px" >Preview Item + diff --git a/src/components/Workspaces/Workspace/WorkspaceControls.tsx b/src/components/Workspaces/Workspace/WorkspaceControls.tsx index 06ec061..900a21d 100644 --- a/src/components/Workspaces/Workspace/WorkspaceControls.tsx +++ b/src/components/Workspaces/Workspace/WorkspaceControls.tsx @@ -3,7 +3,6 @@ import { useDispatch, useSelector } from "react-redux"; import { workspaceSelector } from "../../../features/workspace/workspaceSelector"; import { setAnimatedBG } from "../../../features/workspace/workspaceSlice"; -import { AnimatedBG } from "../../../types/state"; import { Toggle } from "../../Common/Inputs/Toggle"; import { OverlayControl } from "../../OverlayTool"; @@ -17,7 +16,7 @@ export const WorkspaceControls = () => { { + onToggle={(value: boolean) => { dispatch(setAnimatedBG(value)); }} /> diff --git a/src/components/Workspaces/Workspace/styles.ts b/src/components/Workspaces/Workspace/styles.ts index 17de027..a756a75 100644 --- a/src/components/Workspaces/Workspace/styles.ts +++ b/src/components/Workspaces/Workspace/styles.ts @@ -16,6 +16,7 @@ export type PreviewWindowProps = { export const PreviewWindow = styled(PadBox).attrs(() => ({ padding: "lg", }))` + position: relative; display: flex; justify-content: center; align-items: center; diff --git a/src/components/Workspaces/WorkspacesRoute.tsx b/src/components/Workspaces/WorkspacesRoute.tsx index 2d0c105..a563750 100644 --- a/src/components/Workspaces/WorkspacesRoute.tsx +++ b/src/components/Workspaces/WorkspacesRoute.tsx @@ -1,27 +1,49 @@ -import { useSelector } from "react-redux"; +import { useEffect } from "react"; +import { useDispatch, useSelector } from "react-redux"; import { Outlet } from "react-router-dom"; -import { menuDimensionsSelector } from "../../features/pageDimensions/pageDimensionsSelector"; +import { mainMenuDimensionsSelector } from "../../features/pageDimensions/pageDimensionsSelector"; +import { useDimensions } from "../../utils/hooks"; +import { setDimensions } from "../../features/pageDimensions/pageDimensionsSlice"; import { FullScreenContainer } from "../Common/FullScreenContainer.styled"; import { WorkspaceList } from "./WorkspaceList"; import { LayoutGrid, LayoutGridItem } from "../Common/LayoutGrid.styled"; -import { OverlayDisplay } from "../OverlayTool"; + +const WORKSPACE_LIST_WIDTH = 180; export default function Workspaces() { - const { height } = useSelector(menuDimensionsSelector); + const { height } = useSelector(mainMenuDimensionsSelector); + const dispatch = useDispatch(); + const [workspaceRef, { + height: workspaceHeight, + width: workspaceWidth, + }] = useDimensions(); + + // Set Workspace dimensions. + useEffect(() => { + dispatch(setDimensions({ + name: "workspace", + dimensions: { height: workspaceHeight, width: workspaceWidth }, + })); + }, [workspaceHeight, workspaceWidth]); return ( - - - - - - + + + + + + - - - - +
+ + ); } diff --git a/src/features/overlayTool/overlayToolSlice.ts b/src/features/overlayTool/overlayToolSlice.ts index dba96ad..36bb4e6 100644 --- a/src/features/overlayTool/overlayToolSlice.ts +++ b/src/features/overlayTool/overlayToolSlice.ts @@ -4,7 +4,6 @@ import { RootState, OverlayPosition, OverlayId, - AppDimensions, } from "../../types/state"; const initialState: RootState["overlayTool"] = { @@ -16,13 +15,10 @@ const initialState: RootState["overlayTool"] = { const makeNewOverlayItem = ( overlayId: OverlayId, - appDimensions: AppDimensions, + initialPosition: OverlayPosition, ) => ({ id: overlayId, - position: { - x: appDimensions.width / 2, - y: appDimensions.height / 2, - }, + position: initialPosition, opacity: 1, scale: 1, }); @@ -30,7 +26,8 @@ const makeNewOverlayItem = ( type InitNewOverlayItemAction = { overlayId: OverlayId, - appDimensions: AppDimensions, + initialPosition: OverlayPosition, + setVisible: boolean, }; export const overlayToolSlice = createSlice({ @@ -41,9 +38,10 @@ export const overlayToolSlice = createSlice({ if (state.currentOverlayItem == null) { state.currentOverlayItem = makeNewOverlayItem( action.payload.overlayId, - action.payload.appDimensions, + action.payload.initialPosition, ); state.currentOverlayId = action.payload.overlayId; + state.visible = action.payload.setVisible; } }, setVisibility: (state, action: PayloadAction) => { diff --git a/src/features/pageDimensions/pageDimensionsSelector.ts b/src/features/pageDimensions/pageDimensionsSelector.ts index f9db815..37f9f33 100644 --- a/src/features/pageDimensions/pageDimensionsSelector.ts +++ b/src/features/pageDimensions/pageDimensionsSelector.ts @@ -1,6 +1,8 @@ import { RootState } from "../../types/state"; -export const menuDimensionsSelector = (state: RootState) => - state.pageDimensions.menu; +export const mainMenuDimensionsSelector = (state: RootState) => + state.pageDimensions.mainMenu; export const appDimensionsSelector = (state: RootState) => state.pageDimensions.app; +export const workspaceDimensionsSelector = (state: RootState) => + state.pageDimensions.workspace; diff --git a/src/features/pageDimensions/pageDimensionsSlice.ts b/src/features/pageDimensions/pageDimensionsSlice.ts index 9c2128a..30776e0 100644 --- a/src/features/pageDimensions/pageDimensionsSlice.ts +++ b/src/features/pageDimensions/pageDimensionsSlice.ts @@ -1,29 +1,27 @@ import { createSlice, PayloadAction } from "@reduxjs/toolkit"; -import { RootState, MenuDimensions, AppDimensions } from "../../types/state"; +import { RootState, Dimensions } from "../../types/state"; const initialState: RootState["pageDimensions"] = { - menu: { - height: 0, - }, - app: { - height: 0, - width: 0, - }, + mainMenu: { height: 0, width: 0 }, + app: { height: 0, width: 0 }, + workspace: { height: 0, width: 0 }, +}; + +type SetDimensionsAction = { + name: "mainMenu" | "app" | "workspace", + dimensions: Dimensions, }; export const pageDimensionsSlice = createSlice({ name: "pageDimensions", initialState, reducers: { - setMenuDimensions: (state, action: PayloadAction) => { - state.menu = action.payload; - }, - setAppDimensions: (state, action: PayloadAction) => { - state.app = action.payload; + setDimensions: (state, action: PayloadAction) => { + state[action.payload.name] = action.payload.dimensions; }, }, }); -export const { setMenuDimensions, setAppDimensions } = pageDimensionsSlice.actions; +export const { setDimensions } = pageDimensionsSlice.actions; export default pageDimensionsSlice.reducer; diff --git a/src/features/workspace/workspaceSlice.ts b/src/features/workspace/workspaceSlice.ts index eeb9e13..4abc2e0 100644 --- a/src/features/workspace/workspaceSlice.ts +++ b/src/features/workspace/workspaceSlice.ts @@ -1,5 +1,5 @@ import { createSlice, PayloadAction } from "@reduxjs/toolkit"; -import { RootState, WorkspaceId, AnimatedBG } from "../../types/state"; +import { RootState, WorkspaceId } from "../../types/state"; const initialState: RootState["workspace"] = { workspaceId: "", @@ -13,7 +13,7 @@ export const workspaceSlice = createSlice({ setWorkspaceId: (state, action: PayloadAction) => { state.workspaceId = action.payload; }, - setAnimatedBG: (state, action: PayloadAction) => { + setAnimatedBG: (state, action: PayloadAction) => { state.animatedBG = action.payload; }, }, diff --git a/src/types/state.d.ts b/src/types/state.d.ts index 2591d87..f0bffdb 100644 --- a/src/types/state.d.ts +++ b/src/types/state.d.ts @@ -6,26 +6,19 @@ export type RootState = { // Page Dimensions export type PageDimensions = { - menu: MenuDimensions, - app: AppDimensions, -}; - -export type MenuDimensions = { - height: number, -}; -export type AppDimensions = { - height: number, - width: number, + mainMenu: Dimensions, + app: Dimensions, + workspace: Dimensions, }; +export type Dimensions = { width: number, height: number }; // Workspace export type Workspace = { workspaceId: WorkspaceId, - animatedBG: AnimatedBG, + animatedBG: boolean, }; export type WorkspaceId = string; -export type AnimatedBG = boolean; // Overlay Tool export type OverlayTool = { diff --git a/tsconfig.json b/tsconfig.json index f356c58..06df788 100644 --- a/tsconfig.json +++ b/tsconfig.json @@ -1,5 +1,6 @@ { "compilerOptions": { + "importHelpers": true, "target": "es5", "lib": [ "dom", From 1ba5e99532b70506b920f8f7f5a9fd9ae8091b93 Mon Sep 17 00:00:00 2001 From: Kyle Geib Date: Wed, 12 Jan 2022 13:07:33 -0500 Subject: [PATCH 3/9] ISSUE-017 - Basic animated mounting added. --- .vscode/settings.json | 3 +- package.json | 1 + .../OverlayDisplay/OverlayDisplay.tsx | 39 ++++++++++++---- .../OverlayTool/OverlayDisplay/styles.ts | 5 +- .../Workspace/WorkspaceControls.tsx | 2 +- src/components/Workspaces/Workspace/styles.ts | 2 + yarn.lock | 46 +++++++++++++++++++ 7 files changed, 85 insertions(+), 13 deletions(-) diff --git a/.vscode/settings.json b/.vscode/settings.json index 52c3366..e2568a2 100644 --- a/.vscode/settings.json +++ b/.vscode/settings.json @@ -1,3 +1,4 @@ { - "jest.jestCommandLine": "node_modules/.bin/react-scripts test --run-in-band --no-cache --watchAll=false" + "jest.jestCommandLine": "node_modules/.bin/react-scripts test --run-in-band --no-cache --watchAll=false", + "typescript.tsdk": "node_modules/typescript/lib" } \ No newline at end of file diff --git a/package.json b/package.json index df8943c..ca44273 100644 --- a/package.json +++ b/package.json @@ -15,6 +15,7 @@ "@bedrock-layout/split": "^2.3.5", "@bedrock-layout/stack": "^2.3.4", "@bedrock-layout/use-forwarded-ref": "^1.1.11", + "@react-spring/web": "^9.4.1", "@reduxjs/toolkit": "^1.7.1", "@testing-library/jest-dom": "^5.14.1", "@testing-library/react": "^12.0.0", diff --git a/src/components/OverlayTool/OverlayDisplay/OverlayDisplay.tsx b/src/components/OverlayTool/OverlayDisplay/OverlayDisplay.tsx index be3d70d..54bb124 100644 --- a/src/components/OverlayTool/OverlayDisplay/OverlayDisplay.tsx +++ b/src/components/OverlayTool/OverlayDisplay/OverlayDisplay.tsx @@ -1,4 +1,6 @@ import { useSelector } from "react-redux"; +import { useTransition, animated } from "@react-spring/web"; + import { overlayToolSelector } from "../../../features/overlayTool/overlayToolSelector"; import { OverlayItemContainer } from "./styles"; @@ -6,18 +8,37 @@ import { OverlayItemContainer } from "./styles"; export function OverlayDisplay() { const { currentOverlayItem, visible } = useSelector(overlayToolSelector); - if (currentOverlayItem == null) return null; + const xPos = currentOverlayItem?.position.x ?? 0; + const yPos = currentOverlayItem?.position.y ?? 0; + const transition = useTransition(visible, { + from: { left: xPos, top: yPos + 50, opacity: 0 }, + enter: { + left: xPos, + top: yPos, + opacity: currentOverlayItem?.opacity ?? 1, + }, + leave: { left: xPos, top: yPos + 50, opacity: 0 }, + }); + + if (currentOverlayItem == null) { + return null; // Exit - There is no overlay item yet! + } const { id, position } = currentOverlayItem; return ( - - {id} -
- ({position.x}px {position.y}px) -
+ transition((style, visible) => + visible ? ( + + + {id} +
+ (x:{position.x}px, y:{position.y}px) +
+
+ ) : null, + ) ); } diff --git a/src/components/OverlayTool/OverlayDisplay/styles.ts b/src/components/OverlayTool/OverlayDisplay/styles.ts index 6ff1885..6093c9b 100644 --- a/src/components/OverlayTool/OverlayDisplay/styles.ts +++ b/src/components/OverlayTool/OverlayDisplay/styles.ts @@ -1,4 +1,5 @@ import styled from "styled-components"; + import { OverlayPosition } from "../../../types/state"; export type OverlayItemContainerProps = { @@ -15,11 +16,11 @@ export const OverlayItemContainer = styled.div.attrs( display: visible ? undefined : "none", }, }))` - position: absolute; - /* Temporary. Overlay will be transparent and based on an image. */ width: 150px; height: 150px; background-color: white; box-shadow: 0px 7px 11px 1px black; `; +OverlayItemContainer.displayName = "OverlayItemContainer"; + diff --git a/src/components/Workspaces/Workspace/WorkspaceControls.tsx b/src/components/Workspaces/Workspace/WorkspaceControls.tsx index 900a21d..c0b53f3 100644 --- a/src/components/Workspaces/Workspace/WorkspaceControls.tsx +++ b/src/components/Workspaces/Workspace/WorkspaceControls.tsx @@ -12,7 +12,7 @@ export const WorkspaceControls = () => { const { animatedBG } = useSelector(workspaceSelector); return( - + ({ }))` background-color: ${p => p.theme.colors.faintGrey}; border-radius: 1em; + width: 800px; + margin-bottom: 1em; `; ControlsContainer.displayName = "ControlsContainer"; diff --git a/yarn.lock b/yarn.lock index a72fe20..3b7a858 100644 --- a/yarn.lock +++ b/yarn.lock @@ -1466,6 +1466,52 @@ schema-utils "^3.0.0" source-map "^0.7.3" +"@react-spring/animated@~9.4.0": + version "9.4.1" + resolved "https://registry.yarnpkg.com/@react-spring/animated/-/animated-9.4.1.tgz#6b5e57725408ba8347f098a5111a9fb4de74a81b" + integrity sha512-uAJkcrSlpg8uSe8zy7eJcDdNpI5QvRXrZUKhn5dlGAPk3psgY5qj6pahzB0k5NZZQ27ls8Z5Nt4VKhGaXPJNDQ== + dependencies: + "@react-spring/shared" "~9.4.0" + "@react-spring/types" "~9.4.0" + +"@react-spring/core@~9.4.0": + version "9.4.1" + resolved "https://registry.yarnpkg.com/@react-spring/core/-/core-9.4.1.tgz#0658611dd961d745ac9cfc9dde5e86f2895e182a" + integrity sha512-sXQmGg4wNeyoVZ/LdEF01xtzQKZtLIyFDX03hoa0oa9VTgLNTVSbVXD9q2xsH8HtWpY4OFPTi/9Noi93gjnYyg== + dependencies: + "@react-spring/animated" "~9.4.0" + "@react-spring/rafz" "~9.4.0" + "@react-spring/shared" "~9.4.0" + "@react-spring/types" "~9.4.0" + +"@react-spring/rafz@~9.4.0": + version "9.4.1" + resolved "https://registry.yarnpkg.com/@react-spring/rafz/-/rafz-9.4.1.tgz#66ed8eadf5c1784d89b210f443fd2ec9fdb59fb6" + integrity sha512-R/mNOQ4axraWsL/jwzoaqfeX6RwUODg3WOGweL8zYbHHheRqQV+QwnhGmDATepBZ1H3UUulhXvOqkzWzjnpuQQ== + +"@react-spring/shared@~9.4.0": + version "9.4.1" + resolved "https://registry.yarnpkg.com/@react-spring/shared/-/shared-9.4.1.tgz#6c688cbe093ada7f6cd8ed2b9d28a807b6665ede" + integrity sha512-7atTQOhEQmw5UEYbb5yk7YEaf11AcRF7UISfAmr9FJ2FJD4VUVCn1R4V78omiFiRvnU6qI3GRhkRnIvYM8aAZw== + dependencies: + "@react-spring/rafz" "~9.4.0" + "@react-spring/types" "~9.4.0" + +"@react-spring/types@~9.4.0": + version "9.4.1" + resolved "https://registry.yarnpkg.com/@react-spring/types/-/types-9.4.1.tgz#93a203e5b922362e6643b95aff0989dd1a33b77b" + integrity sha512-eZmlFRc+XkY/HJi4RswLkIHH0nKQkqKRHPUqnseffcBuZ5FNXKDUmNnLUpqkrCpl746QCFVQtI5QptLklDATfQ== + +"@react-spring/web@^9.4.1": + version "9.4.1" + resolved "https://registry.yarnpkg.com/@react-spring/web/-/web-9.4.1.tgz#dd8560af6834a9c41cd7061bc98721e9f64a8557" + integrity sha512-ajlGJl0Zqa3idhZw0KL5chP8AIn4wPHpDY7WjtWaWjVZSZRSBAeHmfqNLtAGCjazeO/Q6zmt6wdGs8bX8q42rQ== + dependencies: + "@react-spring/animated" "~9.4.0" + "@react-spring/core" "~9.4.0" + "@react-spring/shared" "~9.4.0" + "@react-spring/types" "~9.4.0" + "@reduxjs/toolkit@^1.7.1": version "1.7.1" resolved "https://registry.yarnpkg.com/@reduxjs/toolkit/-/toolkit-1.7.1.tgz#994962aeb7df3c77be343dd2ad1aa48221dbaa0c" From 95413068944cb21ad17f94d277aa269f4959d859 Mon Sep 17 00:00:00 2001 From: Kyle Geib Date: Wed, 12 Jan 2022 14:43:04 -0500 Subject: [PATCH 4/9] ISSUE-017 - Basic drag functionality added. I cannot combine it with transition handling any top/left transitions. --- package.json | 1 + .../OverlayDisplay/OverlayDisplay.tsx | 27 ++++++++++++++----- .../OverlayTool/OverlayDisplay/styles.ts | 4 +-- yarn.lock | 12 +++++++++ 4 files changed, 36 insertions(+), 8 deletions(-) diff --git a/package.json b/package.json index ca44273..c2ecee1 100644 --- a/package.json +++ b/package.json @@ -27,6 +27,7 @@ "@types/react-dom": "^17.0.9", "@types/react-redux": "^7.1.21", "@types/styled-components": "^5.1.18", + "@use-gesture/react": "^10.2.4", "d3": "^7.2.1", "history": "5", "react": "^17.0.2", diff --git a/src/components/OverlayTool/OverlayDisplay/OverlayDisplay.tsx b/src/components/OverlayTool/OverlayDisplay/OverlayDisplay.tsx index 54bb124..aa0c38a 100644 --- a/src/components/OverlayTool/OverlayDisplay/OverlayDisplay.tsx +++ b/src/components/OverlayTool/OverlayDisplay/OverlayDisplay.tsx @@ -1,23 +1,31 @@ -import { useSelector } from "react-redux"; +import { useSelector, useDispatch } from "react-redux"; import { useTransition, animated } from "@react-spring/web"; +import { useDrag } from "@use-gesture/react"; import { overlayToolSelector } from "../../../features/overlayTool/overlayToolSelector"; +import { setPosition } from "../../../features/overlayTool/overlayToolSlice"; import { OverlayItemContainer } from "./styles"; export function OverlayDisplay() { const { currentOverlayItem, visible } = useSelector(overlayToolSelector); + const dispatch = useDispatch(); + const bindOverlayItem = useDrag((state) => { + dispatch(setPosition({ + x: state.args[0].xPos + state.delta[0], + y: state.args[0].yPos + state.delta[1], + })); + }); const xPos = currentOverlayItem?.position.x ?? 0; const yPos = currentOverlayItem?.position.y ?? 0; const transition = useTransition(visible, { - from: { left: xPos, top: yPos + 50, opacity: 0 }, + from: { top: 50, opacity: 0 }, enter: { - left: xPos, - top: yPos, + top: 0, opacity: currentOverlayItem?.opacity ?? 1, }, - leave: { left: xPos, top: yPos + 50, opacity: 0 }, + leave: { top: 50, opacity: 0 }, }); if (currentOverlayItem == null) { @@ -30,7 +38,14 @@ export function OverlayDisplay() { transition((style, visible) => visible ? ( {id} diff --git a/src/components/OverlayTool/OverlayDisplay/styles.ts b/src/components/OverlayTool/OverlayDisplay/styles.ts index 6093c9b..de78e35 100644 --- a/src/components/OverlayTool/OverlayDisplay/styles.ts +++ b/src/components/OverlayTool/OverlayDisplay/styles.ts @@ -11,8 +11,8 @@ export const OverlayItemContainer = styled.div.attrs( visible, }) => ({ style: { - top: y, - left: x, + // top: y, + // left: x, display: visible ? undefined : "none", }, }))` diff --git a/yarn.lock b/yarn.lock index 3b7a858..515fd36 100644 --- a/yarn.lock +++ b/yarn.lock @@ -2284,6 +2284,18 @@ "@typescript-eslint/types" "5.7.0" eslint-visitor-keys "^3.0.0" +"@use-gesture/core@10.2.4": + version "10.2.4" + resolved "https://registry.yarnpkg.com/@use-gesture/core/-/core-10.2.4.tgz#139370223174b0589bd4b4f8ac7c0beb6ba64ba2" + integrity sha512-fk1LjCBj43BKb8NE05qkdtPOR0ngA7PwgvEqfFap/h+s7QHi+JTv4/mtDQ4wI9zzem+Ry5EKrHS/cVdBehI4wA== + +"@use-gesture/react@^10.2.4": + version "10.2.4" + resolved "https://registry.yarnpkg.com/@use-gesture/react/-/react-10.2.4.tgz#b333e91b00670785ee32e8f4f1530ac6b8894bbc" + integrity sha512-CbqyRj+qNbRBOGmS8OWtaOa29fxEr7bKTYHvPuMQ1wsgQDh2/DqQxbp7cFxAg6WZ8oZjppDj/EkWnw22WpIIWQ== + dependencies: + "@use-gesture/core" "10.2.4" + "@webassemblyjs/ast@1.11.1": version "1.11.1" resolved "https://registry.npmjs.org/@webassemblyjs/ast/-/ast-1.11.1.tgz" From a6a5eb775164ceef883b8874a88058c7ea9935e3 Mon Sep 17 00:00:00 2001 From: Kyle Geib Date: Wed, 12 Jan 2022 14:52:38 -0500 Subject: [PATCH 5/9] ISSUE-017 - Figured out how to allow for Transition and Dragging on the same element. The secret? Don't! Use another throw-away div and put it around the draggable div. Also adopted animated.div into the Styled-Component. Really cool how it just works. --- .../OverlayDisplay/OverlayDisplay.tsx | 25 +++++++++---------- .../OverlayTool/OverlayDisplay/styles.ts | 25 +++++++++++++++++-- 2 files changed, 35 insertions(+), 15 deletions(-) diff --git a/src/components/OverlayTool/OverlayDisplay/OverlayDisplay.tsx b/src/components/OverlayTool/OverlayDisplay/OverlayDisplay.tsx index aa0c38a..cf1ccfb 100644 --- a/src/components/OverlayTool/OverlayDisplay/OverlayDisplay.tsx +++ b/src/components/OverlayTool/OverlayDisplay/OverlayDisplay.tsx @@ -5,7 +5,7 @@ import { useDrag } from "@use-gesture/react"; import { overlayToolSelector } from "../../../features/overlayTool/overlayToolSelector"; import { setPosition } from "../../../features/overlayTool/overlayToolSlice"; -import { OverlayItemContainer } from "./styles"; +import { AnimatedOverlayItemContainer } from "./styles"; export function OverlayDisplay() { const { currentOverlayItem, visible } = useSelector(overlayToolSelector); @@ -37,21 +37,20 @@ export function OverlayDisplay() { return ( transition((style, visible) => visible ? ( - - + + {id}
(x:{position.x}px, y:{position.y}px) -
+
) : null, ) diff --git a/src/components/OverlayTool/OverlayDisplay/styles.ts b/src/components/OverlayTool/OverlayDisplay/styles.ts index de78e35..50e9c68 100644 --- a/src/components/OverlayTool/OverlayDisplay/styles.ts +++ b/src/components/OverlayTool/OverlayDisplay/styles.ts @@ -1,3 +1,4 @@ +import { animated } from "@react-spring/web"; import styled from "styled-components"; import { OverlayPosition } from "../../../types/state"; @@ -11,8 +12,8 @@ export const OverlayItemContainer = styled.div.attrs( visible, }) => ({ style: { - // top: y, - // left: x, + top: y, + left: x, display: visible ? undefined : "none", }, }))` @@ -24,3 +25,23 @@ export const OverlayItemContainer = styled.div.attrs( `; OverlayItemContainer.displayName = "OverlayItemContainer"; +type AnimatedOverlayItemContainerProps = { + visible: boolean, +} +export const AnimatedOverlayItemContainer = styled(animated.div).attrs(({ + visible, +}) => ({ + style: { + display: visible ? undefined : "none", + }, +}))` + position: absolute; + z-index: 1; + + /* Temporary. Overlay will be transparent and based on an image. */ + width: 150px; + height: 150px; + background-color: white; + box-shadow: 0px 7px 11px 1px black; +`; + From 861d702a2702552a8d3b2be80be216e49d79191b Mon Sep 17 00:00:00 2001 From: Kyle Geib Date: Thu, 13 Jan 2022 14:16:09 -0500 Subject: [PATCH 6/9] ISSUE-017 - Overlay state is streamlined. Total change to workspaces. Now an object instead of a list. Utilizing workspace overlays list - prototype currently colors the mock item. Reset overlay on workspace change. Improved combined dragging/transition element behavior. --- package.json | 2 + .../OverlayControl/OverlayControl.tsx | 20 ++-- .../OverlayDisplay/OverlayDisplay.tsx | 58 ++++++----- .../OverlayTool/OverlayDisplay/styles.ts | 30 +----- .../Workspaces/Workspace/Workspace.tsx | 26 ++++- .../WorkspaceList/WorkspaceList.tsx | 32 ++++--- src/components/Workspaces/WorkspacesRoute.tsx | 6 +- src/components/Workspaces/workspaces.ts | 95 ++++++++++--------- src/features/overlayTool/overlayToolSlice.ts | 39 ++++---- src/types/state.d.ts | 7 +- yarn.lock | 12 ++- 11 files changed, 177 insertions(+), 150 deletions(-) diff --git a/package.json b/package.json index c2ecee1..60d4e41 100644 --- a/package.json +++ b/package.json @@ -22,6 +22,7 @@ "@testing-library/user-event": "^13.2.1", "@types/d3": "^7.1.0", "@types/jest": "^27.0.1", + "@types/lodash": "^4.14.178", "@types/node": "^16.7.13", "@types/react": "^17.0.20", "@types/react-dom": "^17.0.9", @@ -30,6 +31,7 @@ "@use-gesture/react": "^10.2.4", "d3": "^7.2.1", "history": "5", + "lodash": "^4.17.21", "react": "^17.0.2", "react-dom": "^17.0.2", "react-redux": "^7.2.6", diff --git a/src/components/OverlayTool/OverlayControl/OverlayControl.tsx b/src/components/OverlayTool/OverlayControl/OverlayControl.tsx index b6c76f1..6cc4af5 100644 --- a/src/components/OverlayTool/OverlayControl/OverlayControl.tsx +++ b/src/components/OverlayTool/OverlayControl/OverlayControl.tsx @@ -15,13 +15,13 @@ import { Toggle } from "../../Common/Inputs/Toggle"; export function OverlayControl() { const dispatch = useDispatch(); - const { visible, currentOverlayItem } = useSelector(overlayToolSelector); + const { overlayIds, visible, currentOverlayItem } = useSelector(overlayToolSelector); /* For prototyping use only */ - const [overlayId, setOverlayId] = useState("foo_1.00000"); + const [idNum, setIdNum] = useState(0); const getRandomArbitrary = (min: number, max: number) => Math.random() * (max - min) + min; @@ -32,10 +32,10 @@ export function OverlayControl() { y: Math.floor(getRandomArbitrary(-50, 650)), })); }; - const idRandomizer = () => { - const newId = `id_${getRandomArbitrary(1, 10)}`.slice(0, 10); - setOverlayId(newId); - dispatch(setCurrentOverlayId(newId)); + const nextIdNum = () => { + const nextIdNum = (idNum + 1) % overlayIds.length; + setIdNum(nextIdNum); + dispatch(setCurrentOverlayId(overlayIds[nextIdNum])); }; /* For prototyping use only */ @@ -44,8 +44,8 @@ export function OverlayControl() { const onToggle = (value: boolean) => { if (currentOverlayItem == null) { dispatch(initNewOverlayItem({ - overlayId, - initialPosition: { x: 400, y: 300 }, + overlayId: overlayIds[idNum], + initialPosition: { x: 0, y: 300 }, setVisible: true, })); } else { @@ -70,9 +70,9 @@ export function OverlayControl() {
- Id: {overlayId} + Id #{idNum}: "{overlayIds[idNum]}" {/* For prototyping use only */} diff --git a/src/components/OverlayTool/OverlayDisplay/OverlayDisplay.tsx b/src/components/OverlayTool/OverlayDisplay/OverlayDisplay.tsx index cf1ccfb..16392a1 100644 --- a/src/components/OverlayTool/OverlayDisplay/OverlayDisplay.tsx +++ b/src/components/OverlayTool/OverlayDisplay/OverlayDisplay.tsx @@ -5,15 +5,21 @@ import { useDrag } from "@use-gesture/react"; import { overlayToolSelector } from "../../../features/overlayTool/overlayToolSelector"; import { setPosition } from "../../../features/overlayTool/overlayToolSlice"; -import { AnimatedOverlayItemContainer } from "./styles"; +import { OverlayItemContainer } from "./styles"; export function OverlayDisplay() { - const { currentOverlayItem, visible } = useSelector(overlayToolSelector); + const { + currentOverlayId, + currentOverlayItem, + visible, + } = useSelector(overlayToolSelector); + const dispatch = useDispatch(); - const bindOverlayItem = useDrag((state) => { + + const bindOverlayItem = useDrag(({ args, delta }) => { dispatch(setPosition({ - x: state.args[0].xPos + state.delta[0], - y: state.args[0].yPos + state.delta[1], + x: args[0].xPos + delta[0], + y: args[0].yPos + delta[1], })); }); @@ -28,31 +34,33 @@ export function OverlayDisplay() { leave: { top: 50, opacity: 0 }, }); - if (currentOverlayItem == null) { - return null; // Exit - There is no overlay item yet! + // Cannot make an earlier return because all hooks must run or React gets mad. + if (currentOverlayId == null || currentOverlayItem == null) { + return null; } - const { id, position } = currentOverlayItem; + const { position } = currentOverlayItem; - return ( - transition((style, visible) => - visible ? ( + return transition((style, visible) => + visible ? ( + - - {id} + + {currentOverlayId}
- (x:{position.x}px, y:{position.y}px) -
+ (x:{Math.floor(position.x)}px, y:{Math.floor(position.y)}px) +
- ) : null, - ) + + ) : null, ); } diff --git a/src/components/OverlayTool/OverlayDisplay/styles.ts b/src/components/OverlayTool/OverlayDisplay/styles.ts index 50e9c68..66deb2d 100644 --- a/src/components/OverlayTool/OverlayDisplay/styles.ts +++ b/src/components/OverlayTool/OverlayDisplay/styles.ts @@ -1,47 +1,21 @@ -import { animated } from "@react-spring/web"; import styled from "styled-components"; -import { OverlayPosition } from "../../../types/state"; - export type OverlayItemContainerProps = { - position: OverlayPosition, visible: boolean, + tempColor: string, }; export const OverlayItemContainer = styled.div.attrs(({ - position: { x, y }, visible, }) => ({ style: { - top: y, - left: x, display: visible ? undefined : "none", }, }))` /* Temporary. Overlay will be transparent and based on an image. */ width: 150px; height: 150px; - background-color: white; + background-color: ${({ tempColor }) => tempColor}; box-shadow: 0px 7px 11px 1px black; `; OverlayItemContainer.displayName = "OverlayItemContainer"; -type AnimatedOverlayItemContainerProps = { - visible: boolean, -} -export const AnimatedOverlayItemContainer = styled(animated.div).attrs(({ - visible, -}) => ({ - style: { - display: visible ? undefined : "none", - }, -}))` - position: absolute; - z-index: 1; - - /* Temporary. Overlay will be transparent and based on an image. */ - width: 150px; - height: 150px; - background-color: white; - box-shadow: 0px 7px 11px 1px black; -`; - diff --git a/src/components/Workspaces/Workspace/Workspace.tsx b/src/components/Workspaces/Workspace/Workspace.tsx index 2f8a764..be39521 100644 --- a/src/components/Workspaces/Workspace/Workspace.tsx +++ b/src/components/Workspaces/Workspace/Workspace.tsx @@ -1,9 +1,13 @@ +import { useEffect } from "react"; import { useParams } from "react-router-dom"; -import { useSelector } from "react-redux"; +import { useDispatch, useSelector } from "react-redux"; import { Center } from "@bedrock-layout/center"; import { Stack } from "@bedrock-layout/stack"; import { workspaceSelector } from "../../../features/workspace/workspaceSelector"; +import { setWorkspaceId } from "../../../features/workspace/workspaceSlice"; +import { overlayToolSelector } from "../../../features/overlayTool/overlayToolSelector"; +import { newWorkspace } from "../../../features/overlayTool/overlayToolSlice"; import { PreviewWindow, H2, ControlsContainer } from "./styles"; import { WorkspaceControls } from "./WorkspaceControls"; @@ -15,6 +19,24 @@ import { workspaceObject } from "../workspaces"; export const Workspace = () => { const { workspaceId } = useParams(); const { animatedBG } = useSelector(workspaceSelector); + const { currentWorkspaceId: overlayWorkspaceId } = useSelector(overlayToolSelector); + const dispatch = useDispatch(); + + useEffect(() => { + if (workspaceId == null) return; + + // Update workspace store for ID. + dispatch(setWorkspaceId(workspaceId)); + + // Switching Workspace means we need to init a newWorkspace for Overlay tool. + if (overlayWorkspaceId !== workspaceId) { + dispatch(newWorkspace({ + overlayIds: workspaceObject[workspaceId].overlayIds, + workspaceId: workspaceId, + })); + } + }, [workspaceId]); + return ( { maxWidth="80%" centerChildren > -

{workspaceId ? workspaceObject[workspaceId] : "Unknown"}

+

{workspaceId ? workspaceObject[workspaceId].name : "Unknown"}

( - - - {workspaceList.map((workspace, i) => ( - - ))} - - -); +export const WorkspaceList = ({ headerOffset }: WorkspaceListProps) => { + const workspaceList = _.keys(workspaceObject); + return ( + + + {workspaceList.map((id, i) => ( + + ))} + + + ); +}; type WorkspaceListNavLinkProps = { to: string, diff --git a/src/components/Workspaces/WorkspacesRoute.tsx b/src/components/Workspaces/WorkspacesRoute.tsx index a563750..c1da8ee 100644 --- a/src/components/Workspaces/WorkspacesRoute.tsx +++ b/src/components/Workspaces/WorkspacesRoute.tsx @@ -13,7 +13,7 @@ import { LayoutGrid, LayoutGridItem } from "../Common/LayoutGrid.styled"; const WORKSPACE_LIST_WIDTH = 180; export default function Workspaces() { - const { height } = useSelector(mainMenuDimensionsSelector); + const { height: mainMenuHeight } = useSelector(mainMenuDimensionsSelector); const dispatch = useDispatch(); const [workspaceRef, { height: workspaceHeight, @@ -31,14 +31,14 @@ export default function Workspaces() { return ( - + diff --git a/src/components/Workspaces/workspaces.ts b/src/components/Workspaces/workspaces.ts index d10fb05..fa2c6b6 100644 --- a/src/components/Workspaces/workspaces.ts +++ b/src/components/Workspaces/workspaces.ts @@ -1,56 +1,57 @@ -export const workspaceList = [ - { +import { OverlayIds } from "../../types/state"; + +export type WorkspaceObject = { + [id: string]: { + name: string, + overlayIds: OverlayIds, + }, +}; +export const workspaceObject: WorkspaceObject = { + workspace1: { name: "Workspace 1", - id: "workspace1", + overlayIds: ["red", "blue", "white"], }, - { + workspace2: { name: "Workspace 2", - id: "workspace2", + overlayIds: ["green"], }, - { + workspace3: { name: "Workspace 3", - id: "workspace3", + overlayIds: ["green"], }, - { + workspace4: { name: "Workspace 4 has a longer name than the rest", - id: "workspace4", + overlayIds: ["green"], }, - { name: "blah", id: "blah0" }, - { name: "blah", id: "blah1" }, - { name: "blah", id: "blah2" }, - { name: "blah", id: "blah3" }, - { name: "blah", id: "blah4" }, - { name: "blah", id: "blah5" }, - { name: "blah", id: "blah6" }, - { name: "blah", id: "blah7" }, - { name: "blah", id: "blah8" }, - { name: "blah", id: "blah9" }, - { name: "blah", id: "blah10" }, - { name: "blah", id: "blah11" }, - { name: "blah", id: "blah12" }, - { name: "blah", id: "blah13" }, - { name: "blah", id: "blah14" }, - { name: "blah", id: "blah15" }, - { name: "blah", id: "blah16" }, - { name: "blah", id: "blah17" }, - { name: "blah", id: "blah18" }, - { name: "blah", id: "blah19" }, - { name: "blah", id: "blah20" }, - { name: "blah", id: "blah21" }, - { name: "blah", id: "blah22" }, - { name: "blah", id: "blah23" }, - { name: "blah", id: "blah24" }, - { name: "blah", id: "blah25" }, - { name: "blah", id: "blah26" }, - { name: "blah", id: "blah27" }, - { name: "blah", id: "blah28" }, - { name: "blah", id: "blah29" }, -]; + blah0: { name: "blah", overlayIds: ["green"] }, + blah1: { name: "blah", overlayIds: ["green"] }, + blah2: { name: "blah", overlayIds: ["green"] }, + blah3: { name: "blah", overlayIds: ["green"] }, + blah4: { name: "blah", overlayIds: ["green"] }, + blah5: { name: "blah", overlayIds: ["green"] }, + blah6: { name: "blah", overlayIds: ["green"] }, + blah7: { name: "blah", overlayIds: ["green"] }, + blah8: { name: "blah", overlayIds: ["green"] }, + blah9: { name: "blah", overlayIds: ["green"] }, + blah10: { name: "blah", overlayIds: ["green"] }, + blah11: { name: "blah", overlayIds: ["green"] }, + blah12: { name: "blah", overlayIds: ["green"] }, + blah13: { name: "blah", overlayIds: ["green"] }, + blah14: { name: "blah", overlayIds: ["green"] }, + blah15: { name: "blah", overlayIds: ["green"] }, + blah16: { name: "blah", overlayIds: ["green"] }, + blah17: { name: "blah", overlayIds: ["green"] }, + blah18: { name: "blah", overlayIds: ["green"] }, + blah19: { name: "blah", overlayIds: ["green"] }, + blah20: { name: "blah", overlayIds: ["green"] }, + blah21: { name: "blah", overlayIds: ["green"] }, + blah22: { name: "blah", overlayIds: ["green"] }, + blah23: { name: "blah", overlayIds: ["green"] }, + blah24: { name: "blah", overlayIds: ["green"] }, + blah25: { name: "blah", overlayIds: ["green"] }, + blah26: { name: "blah", overlayIds: ["green"] }, + blah27: { name: "blah", overlayIds: ["green"] }, + blah28: { name: "blah", overlayIds: ["green"] }, + blah29: { name: "blah", overlayIds: ["green"] }, +}; -export const workspaceObject = ((list: typeof workspaceList) => { - const obj: {[key: string]: string} = {}; - list.forEach(item => { - obj[item.id] = item.name; - }); - return obj; -})(workspaceList); diff --git a/src/features/overlayTool/overlayToolSlice.ts b/src/features/overlayTool/overlayToolSlice.ts index 36bb4e6..966dafc 100644 --- a/src/features/overlayTool/overlayToolSlice.ts +++ b/src/features/overlayTool/overlayToolSlice.ts @@ -2,27 +2,20 @@ import { createSlice, PayloadAction } from "@reduxjs/toolkit"; import { RootState, + WorkspaceId, OverlayPosition, OverlayId, + OverlayIds, } from "../../types/state"; const initialState: RootState["overlayTool"] = { + currentWorkspaceId: "", overlayIds: [], currentOverlayId: null, currentOverlayItem: null, visible: false, }; -const makeNewOverlayItem = ( - overlayId: OverlayId, - initialPosition: OverlayPosition, -) => ({ - id: overlayId, - position: initialPosition, - opacity: 1, - scale: 1, -}); - type InitNewOverlayItemAction = { overlayId: OverlayId, @@ -30,16 +23,21 @@ type InitNewOverlayItemAction = { setVisible: boolean, }; +type NewWorkspaceAction = { + overlayIds: OverlayIds, + workspaceId: WorkspaceId, +} + export const overlayToolSlice = createSlice({ name: "overlayTool", initialState, reducers: { initNewOverlayItem: (state, action: PayloadAction) => { if (state.currentOverlayItem == null) { - state.currentOverlayItem = makeNewOverlayItem( - action.payload.overlayId, - action.payload.initialPosition, - ); + state.currentOverlayItem = { + position: action.payload.initialPosition, + opacity: 1, + }; state.currentOverlayId = action.payload.overlayId; state.visible = action.payload.setVisible; } @@ -47,16 +45,12 @@ export const overlayToolSlice = createSlice({ setVisibility: (state, action: PayloadAction) => { state.visible = action.payload; }, - setOverlayIds: (state, action: PayloadAction>) => { - state.overlayIds = action.payload; - }, setCurrentOverlayId: (state, action: PayloadAction) => { if ( action.payload !== state.currentOverlayId && state.currentOverlayItem != null ) { state.currentOverlayId = action.payload; - state.currentOverlayItem.id = action.payload; } }, setPosition: (state, action: PayloadAction) => { @@ -64,14 +58,21 @@ export const overlayToolSlice = createSlice({ state.currentOverlayItem.position = action.payload; } }, + newWorkspace: (state, action: PayloadAction) => { + state.currentOverlayId = null; + state.currentOverlayItem = null; + state.visible = false; + state.currentWorkspaceId = action.payload.workspaceId; + state.overlayIds = action.payload.overlayIds; + }, }, }); export const { initNewOverlayItem, setVisibility, - setOverlayIds, setCurrentOverlayId, setPosition, + newWorkspace, } = overlayToolSlice.actions; export default overlayToolSlice.reducer; diff --git a/src/types/state.d.ts b/src/types/state.d.ts index f0bffdb..0d7d47f 100644 --- a/src/types/state.d.ts +++ b/src/types/state.d.ts @@ -22,17 +22,16 @@ export type WorkspaceId = string; // Overlay Tool export type OverlayTool = { - // workspaceId: WorkspaceId, - overlayIds: Array, + currentWorkspaceId: WorkspaceId, + overlayIds: OverlayIds, currentOverlayId: OverlayId | null, currentOverlayItem: OverlayItem | null, visible: boolean, }; export type OverlayId = string; +export type OverlayIds = Array; export type OverlayPosition = { x: number, y: number }; export type OverlayItem = { - id: OverlayId, position: OverlayPosition, opacity: number, - scale: number, }; diff --git a/yarn.lock b/yarn.lock index 515fd36..c36c32a 100644 --- a/yarn.lock +++ b/yarn.lock @@ -2103,6 +2103,11 @@ resolved "https://registry.npmjs.org/@types/json5/-/json5-0.0.29.tgz" integrity sha1-7ihweulOEdK4J7y+UnC86n8+ce4= +"@types/lodash@^4.14.178": + version "4.14.178" + resolved "https://registry.yarnpkg.com/@types/lodash/-/lodash-4.14.178.tgz#341f6d2247db528d4a13ddbb374bcdc80406f4f8" + integrity sha512-0d5Wd09ItQWH1qFbEyQ7oTQ3GZrMfth5JkbN3EvTKLXcHLRDSXeLnlvlOn0wvxVIwK5o2M8JzP/OWz7T3NRsbw== + "@types/node@*": version "17.0.0" resolved "https://registry.npmjs.org/@types/node/-/node-17.0.0.tgz" @@ -6334,11 +6339,16 @@ lodash.uniq@^4.5.0: resolved "https://registry.npmjs.org/lodash.uniq/-/lodash.uniq-4.5.0.tgz" integrity sha1-0CJTc662Uq3BvILklFM5qEJ1R3M= -lodash@^4.17.11, lodash@^4.17.14, lodash@^4.17.15, lodash@^4.17.20, lodash@^4.17.21, lodash@^4.7.0: +lodash@^4.17.11, lodash@^4.17.14, lodash@^4.17.15, lodash@^4.17.20, lodash@^4.7.0: version "4.17.21" resolved "https://registry.npmjs.org/lodash/-/lodash-4.17.21.tgz" integrity sha512-v2kDEe57lecTulaDIuNTPy3Ry4gLGJ6Z1O3vE1krgXZNrsQ+LFTGHVxVjcXPs17LhbZVGedAJv8XZ1tvj5FvSg== +lodash@^4.17.21: + version "4.17.21" + resolved "https://registry.yarnpkg.com/lodash/-/lodash-4.17.21.tgz#679591c564c3bffaae8454cf0b3df370c3d6911c" + integrity sha512-v2kDEe57lecTulaDIuNTPy3Ry4gLGJ6Z1O3vE1krgXZNrsQ+LFTGHVxVjcXPs17LhbZVGedAJv8XZ1tvj5FvSg== + loose-envify@^1.1.0, loose-envify@^1.4.0: version "1.4.0" resolved "https://registry.npmjs.org/loose-envify/-/loose-envify-1.4.0.tgz" From aba5cc20be286dc8fa848dabb3e705a42cd041b8 Mon Sep 17 00:00:00 2001 From: Kyle Geib Date: Thu, 13 Jan 2022 15:00:21 -0500 Subject: [PATCH 7/9] ISSUE-017 - Implemented drag bounds that consider the dimensions of dragged element. This is bugged as the resize observer I'm using doesn't update itself when I reveal the OverlayItem from hiding. --- .../OverlayControl/OverlayControl.tsx | 17 +-------- .../OverlayDisplay/OverlayDisplay.tsx | 37 ++++++++++++++++--- .../OverlayTool/OverlayDisplay/styles.ts | 1 + .../Workspaces/Workspace/Workspace.tsx | 19 ++++++++-- .../WorkspaceList/WorkspaceList.tsx | 2 +- 5 files changed, 51 insertions(+), 25 deletions(-) diff --git a/src/components/OverlayTool/OverlayControl/OverlayControl.tsx b/src/components/OverlayTool/OverlayControl/OverlayControl.tsx index 6cc4af5..35c17bc 100644 --- a/src/components/OverlayTool/OverlayControl/OverlayControl.tsx +++ b/src/components/OverlayTool/OverlayControl/OverlayControl.tsx @@ -23,15 +23,6 @@ export function OverlayControl() { /* For prototyping use only */ const [idNum, setIdNum] = useState(0); - const getRandomArbitrary = (min: number, max: number) => - Math.random() * (max - min) + min; - - const posRandomizer = () => { - dispatch(setPosition({ - x: Math.floor(getRandomArbitrary(-50, 850)), - y: Math.floor(getRandomArbitrary(-50, 650)), - })); - }; const nextIdNum = () => { const nextIdNum = (idNum + 1) % overlayIds.length; setIdNum(nextIdNum); @@ -45,7 +36,7 @@ export function OverlayControl() { if (currentOverlayItem == null) { dispatch(initNewOverlayItem({ overlayId: overlayIds[idNum], - initialPosition: { x: 0, y: 300 }, + initialPosition: { x: 400, y: 300 }, setVisible: true, })); } else { @@ -63,12 +54,6 @@ export function OverlayControl() { {/* For prototyping use only */}
- - Random Location - -
diff --git a/src/components/OverlayTool/OverlayDisplay/OverlayDisplay.tsx b/src/components/OverlayTool/OverlayDisplay/OverlayDisplay.tsx index 16392a1..6f19e0f 100644 --- a/src/components/OverlayTool/OverlayDisplay/OverlayDisplay.tsx +++ b/src/components/OverlayTool/OverlayDisplay/OverlayDisplay.tsx @@ -2,24 +2,47 @@ import { useSelector, useDispatch } from "react-redux"; import { useTransition, animated } from "@react-spring/web"; import { useDrag } from "@use-gesture/react"; +import { useDimensions } from "../../../utils/hooks"; import { overlayToolSelector } from "../../../features/overlayTool/overlayToolSelector"; import { setPosition } from "../../../features/overlayTool/overlayToolSlice"; import { OverlayItemContainer } from "./styles"; -export function OverlayDisplay() { +type OverlayDisplayProps = { + containerDimensions: { + width: number, + height: number, + }, + bleedover?: number, +}; +export function OverlayDisplay({ + containerDimensions: { width: containerWidth, height: containerHeight }, + bleedover = 0, +}: OverlayDisplayProps) { + const dispatch = useDispatch(); const { currentOverlayId, currentOverlayItem, visible, } = useSelector(overlayToolSelector); - const dispatch = useDispatch(); + // Monitor element dimensions to calculate min/max drag coordinates. + const [overlayItemRef, { + width: overlayItemWidth, + height: overlayItemHeight, + }] = useDimensions(); + const + minX = -bleedover, + minY = -bleedover, + maxX = containerWidth - overlayItemWidth + bleedover, + maxY = containerHeight - overlayItemHeight + bleedover; const bindOverlayItem = useDrag(({ args, delta }) => { + const newX = args[0].xPos + delta[0]; + const newY = args[0].yPos + delta[1]; dispatch(setPosition({ - x: args[0].xPos + delta[0], - y: args[0].yPos + delta[1], + x: newX >= minX && newX <= maxX ? newX : args[0].xPos, + y: newY >= minY && newY <= maxY ? newY : args[0].yPos, })); }); @@ -54,7 +77,11 @@ export function OverlayDisplay() { }} > - + {currentOverlayId}
(x:{Math.floor(position.x)}px, y:{Math.floor(position.y)}px) diff --git a/src/components/OverlayTool/OverlayDisplay/styles.ts b/src/components/OverlayTool/OverlayDisplay/styles.ts index 66deb2d..39eae1d 100644 --- a/src/components/OverlayTool/OverlayDisplay/styles.ts +++ b/src/components/OverlayTool/OverlayDisplay/styles.ts @@ -12,6 +12,7 @@ export const OverlayItemContainer = styled.div.attrs( }, }))` /* Temporary. Overlay will be transparent and based on an image. */ + /* width: ${({ tempColor }) => tempColor == "red" ? "150px" : "100px"}; */ width: 150px; height: 150px; background-color: ${({ tempColor }) => tempColor}; diff --git a/src/components/Workspaces/Workspace/Workspace.tsx b/src/components/Workspaces/Workspace/Workspace.tsx index be39521..e42f9f6 100644 --- a/src/components/Workspaces/Workspace/Workspace.tsx +++ b/src/components/Workspaces/Workspace/Workspace.tsx @@ -16,11 +16,14 @@ import { OverlayDisplay } from "../../OverlayTool"; import { workspaceObject } from "../workspaces"; +const PREVIEW_WINDOW_HEIGHT = 600; +const PREVIEW_WINDOW_WIDTH = 800; + export const Workspace = () => { + const dispatch = useDispatch(); const { workspaceId } = useParams(); const { animatedBG } = useSelector(workspaceSelector); const { currentWorkspaceId: overlayWorkspaceId } = useSelector(overlayToolSelector); - const dispatch = useDispatch(); useEffect(() => { if (workspaceId == null) return; @@ -45,13 +48,23 @@ export const Workspace = () => { centerChildren >

{workspaceId ? workspaceObject[workspaceId].name : "Unknown"}

- + Preview Item - + diff --git a/src/components/Workspaces/WorkspaceList/WorkspaceList.tsx b/src/components/Workspaces/WorkspaceList/WorkspaceList.tsx index 064b680..bc5c27d 100644 --- a/src/components/Workspaces/WorkspaceList/WorkspaceList.tsx +++ b/src/components/Workspaces/WorkspaceList/WorkspaceList.tsx @@ -15,7 +15,7 @@ export const WorkspaceList = ({ headerOffset }: WorkspaceListProps) => { return ( - {workspaceList.map((id, i) => ( + {workspaceList.map((id) => ( Date: Thu, 13 Jan 2022 16:21:23 -0500 Subject: [PATCH 8/9] ISSUE-009 - Alternative useDimensions added. Turns out... they're not as reliable. In testing I had the menu's height regularly fail to provide its height data. --- package.json | 1 + src/utils/hooks.ts | 46 +++++++++++++++++++++++++++++++++++++++++++++- yarn.lock | 43 +++++++++++++++++++++++++++++++++++++------ 3 files changed, 83 insertions(+), 7 deletions(-) diff --git a/package.json b/package.json index 60d4e41..2006d4d 100644 --- a/package.json +++ b/package.json @@ -15,6 +15,7 @@ "@bedrock-layout/split": "^2.3.5", "@bedrock-layout/stack": "^2.3.4", "@bedrock-layout/use-forwarded-ref": "^1.1.11", + "@react-hook/resize-observer": "^1.2.5", "@react-spring/web": "^9.4.1", "@reduxjs/toolkit": "^1.7.1", "@testing-library/jest-dom": "^5.14.1", diff --git a/src/utils/hooks.ts b/src/utils/hooks.ts index 2c5652a..d4ab622 100644 --- a/src/utils/hooks.ts +++ b/src/utils/hooks.ts @@ -1,4 +1,5 @@ -import React, { useEffect, useRef, useState } from "react"; +import useResizeObserver from "@react-hook/resize-observer"; +import React, { useEffect, useLayoutEffect, useRef, useState } from "react"; import ResizeObserver from "resize-observer-polyfill"; export const useDimensions = () => { @@ -32,3 +33,46 @@ export const useDimensions = () => { { height: number, width: number }, ]; }; + +/** + * Proven to be less reliable than using resizeObserver directly. + * @returns + */ +export const useDimensionsAlt1 = () => { + const ref = useRef(null); + const [size, setSize] = useState(); + + useLayoutEffect(() => { + const element = ref.current; + if (element == null) return; + setSize(element.getBoundingClientRect()); + }, [ref]); + + useResizeObserver(ref, (entry) => setSize(entry.contentRect)); + + // Returning correctly with generics apparently requires type def here. + return [ + ref, + size ?? { width: 0, height: 0 }, + ] as [ + React.RefObject, + DOMRect, + ]; +}; + +/** + * Based off the code demo for useResizeObserver. + * https://github.com/jaredLunde/react-hook/tree/master/packages/resize-observer + * @param target React Ref + * @returns + */ +export const useDimensionsAlt2 = (target: React.RefObject) => { + const [size, setSize] = useState(); + + useLayoutEffect(() => { + setSize(target.current?.getBoundingClientRect()); + }, [target]); + + useResizeObserver(target, entry => setSize(entry.contentRect)); + return size ?? { width: 0, height: 0, x: 0, y: 0 }; +}; diff --git a/yarn.lock b/yarn.lock index c36c32a..3b5d83c 100644 --- a/yarn.lock +++ b/yarn.lock @@ -1430,6 +1430,11 @@ "@types/yargs" "^16.0.0" chalk "^4.0.0" +"@juggle/resize-observer@^3.3.1": + version "3.3.1" + resolved "https://registry.yarnpkg.com/@juggle/resize-observer/-/resize-observer-3.3.1.tgz#b50a781709c81e10701004214340f25475a171a0" + integrity sha512-zMM9Ds+SawiUkakS7y94Ymqx+S0ORzpG3frZirN3l+UlXUmSUR7hF4wxCVqW+ei94JzV5kt0uXBcoOEAuiydrw== + "@nodelib/fs.scandir@2.1.5": version "2.1.5" resolved "https://registry.npmjs.org/@nodelib/fs.scandir/-/fs.scandir-2.1.5.tgz" @@ -1466,6 +1471,27 @@ schema-utils "^3.0.0" source-map "^0.7.3" +"@react-hook/latest@^1.0.2": + version "1.0.3" + resolved "https://registry.yarnpkg.com/@react-hook/latest/-/latest-1.0.3.tgz#c2d1d0b0af8b69ec6e2b3a2412ba0768ac82db80" + integrity sha512-dy6duzl+JnAZcDbNTfmaP3xHiKtbXYOaz3G51MGVljh548Y8MWzTr+PHLOfvpypEVW9zwvl+VyKjbWKEVbV1Rg== + +"@react-hook/passive-layout-effect@^1.2.0": + version "1.2.1" + resolved "https://registry.yarnpkg.com/@react-hook/passive-layout-effect/-/passive-layout-effect-1.2.1.tgz#c06dac2d011f36d61259aa1c6df4f0d5e28bc55e" + integrity sha512-IwEphTD75liO8g+6taS+4oqz+nnroocNfWVHWz7j+N+ZO2vYrc6PV1q7GQhuahL0IOR7JccFTsFKQ/mb6iZWAg== + +"@react-hook/resize-observer@^1.2.5": + version "1.2.5" + resolved "https://registry.yarnpkg.com/@react-hook/resize-observer/-/resize-observer-1.2.5.tgz#b59e2300de98bc6ddc6946942f21243cde10f984" + integrity sha512-qa0pPvRxq5VbdI8mMK2apPFsZOckhQ6D3Jc9yLuyHMNhui8yEih4qyFCZBDzzK3ymZS6LAltVSVg3l1Dg9vA0w== + dependencies: + "@juggle/resize-observer" "^3.3.1" + "@react-hook/latest" "^1.0.2" + "@react-hook/passive-layout-effect" "^1.2.0" + "@types/raf-schd" "^4.0.0" + raf-schd "^4.0.2" + "@react-spring/animated@~9.4.0": version "9.4.1" resolved "https://registry.yarnpkg.com/@react-spring/animated/-/animated-9.4.1.tgz#6b5e57725408ba8347f098a5111a9fb4de74a81b" @@ -2138,6 +2164,11 @@ resolved "https://registry.npmjs.org/@types/q/-/q-1.5.5.tgz" integrity sha512-L28j2FcJfSZOnL1WBjDYp2vUHCeIFlyYI/53EwD/rKUBQ7MtUUfbQWiyKJGpcnv4/WgrhWsFKrcPstcAt/J0tQ== +"@types/raf-schd@^4.0.0": + version "4.0.1" + resolved "https://registry.yarnpkg.com/@types/raf-schd/-/raf-schd-4.0.1.tgz#1f9e03736f277fe9c7b82102bf18570a6ee19f82" + integrity sha512-Ha+EnKHFIh9EKW0/XZJPUd3EGDFisEvauaBd4VVCRPKeOqUxNEc9TodiY2Zhk33XCgzJucoFEcaoNcBAPHTQ2A== + "@types/react-dom@^17.0.9": version "17.0.11" resolved "https://registry.npmjs.org/@types/react-dom/-/react-dom-17.0.11.tgz" @@ -6339,16 +6370,11 @@ lodash.uniq@^4.5.0: resolved "https://registry.npmjs.org/lodash.uniq/-/lodash.uniq-4.5.0.tgz" integrity sha1-0CJTc662Uq3BvILklFM5qEJ1R3M= -lodash@^4.17.11, lodash@^4.17.14, lodash@^4.17.15, lodash@^4.17.20, lodash@^4.7.0: +lodash@^4.17.11, lodash@^4.17.14, lodash@^4.17.15, lodash@^4.17.20, lodash@^4.17.21, lodash@^4.7.0: version "4.17.21" resolved "https://registry.npmjs.org/lodash/-/lodash-4.17.21.tgz" integrity sha512-v2kDEe57lecTulaDIuNTPy3Ry4gLGJ6Z1O3vE1krgXZNrsQ+LFTGHVxVjcXPs17LhbZVGedAJv8XZ1tvj5FvSg== -lodash@^4.17.21: - version "4.17.21" - resolved "https://registry.yarnpkg.com/lodash/-/lodash-4.17.21.tgz#679591c564c3bffaae8454cf0b3df370c3d6911c" - integrity sha512-v2kDEe57lecTulaDIuNTPy3Ry4gLGJ6Z1O3vE1krgXZNrsQ+LFTGHVxVjcXPs17LhbZVGedAJv8XZ1tvj5FvSg== - loose-envify@^1.1.0, loose-envify@^1.4.0: version "1.4.0" resolved "https://registry.npmjs.org/loose-envify/-/loose-envify-1.4.0.tgz" @@ -7600,6 +7626,11 @@ quick-lru@^5.1.1: resolved "https://registry.npmjs.org/quick-lru/-/quick-lru-5.1.1.tgz" integrity sha512-WuyALRjWPDGtt/wzJiadO5AXY+8hZ80hVpe6MyivgraREW751X3SbhRvG3eLKOYN+8VEvqLcf3wdnt44Z4S4SA== +raf-schd@^4.0.2: + version "4.0.3" + resolved "https://registry.yarnpkg.com/raf-schd/-/raf-schd-4.0.3.tgz#5d6c34ef46f8b2a0e880a8fcdb743efc5bfdbc1a" + integrity sha512-tQkJl2GRWh83ui2DiPTJz9wEiMN20syf+5oKfB03yYP7ioZcJwsIK8FjrtLwH1m7C7e+Tt2yYBlrOpdT+dyeIQ== + raf@^3.4.1: version "3.4.1" resolved "https://registry.npmjs.org/raf/-/raf-3.4.1.tgz" From f51df58d17ff77f242523ed3ad273f977179295b Mon Sep 17 00:00:00 2001 From: Kyle Geib Date: Fri, 14 Jan 2022 14:03:56 -0500 Subject: [PATCH 9/9] ISSUE-017 - Implemented image overlay solution that I'm happy with. Shout-out to Blair Wadman for revealing a method to display an image at 1:1 pixel scale and having the div that houses it automatically match that size without any fuss. (Here: https://befused.com/css/flexbox-prevent-image-shrinking/). --- package.json | 1 + .../OverlayControl/OverlayControl.tsx | 3 +- .../OverlayDisplay/OverlayDisplay.tsx | 26 ++++---- .../OverlayTool/OverlayDisplay/styles.ts | 38 ++++++----- .../Workspaces/Workspace/Workspace.tsx | 21 +++---- src/components/Workspaces/Workspace/styles.ts | 8 +-- src/components/Workspaces/workspaces.ts | 59 ++++-------------- .../images/overlays/chyron-simple-full.png | Bin 0 -> 34529 bytes .../overlays/chyron-simple-opening-1.png | Bin 0 -> 24208 bytes .../overlays/chyron-simple-opening-2.png | Bin 0 -> 34934 bytes tsconfig.json | 3 + yarn.lock | 5 ++ 12 files changed, 70 insertions(+), 94 deletions(-) create mode 100644 src/public/images/overlays/chyron-simple-full.png create mode 100644 src/public/images/overlays/chyron-simple-opening-1.png create mode 100644 src/public/images/overlays/chyron-simple-opening-2.png diff --git a/package.json b/package.json index 2006d4d..42e370b 100644 --- a/package.json +++ b/package.json @@ -29,6 +29,7 @@ "@types/react-dom": "^17.0.9", "@types/react-redux": "^7.1.21", "@types/styled-components": "^5.1.18", + "@types/webpack-env": "^1.16.3", "@use-gesture/react": "^10.2.4", "d3": "^7.2.1", "history": "5", diff --git a/src/components/OverlayTool/OverlayControl/OverlayControl.tsx b/src/components/OverlayTool/OverlayControl/OverlayControl.tsx index 35c17bc..72df498 100644 --- a/src/components/OverlayTool/OverlayControl/OverlayControl.tsx +++ b/src/components/OverlayTool/OverlayControl/OverlayControl.tsx @@ -6,7 +6,6 @@ import { overlayToolSelector } from "../../../features/overlayTool/overlayToolSe import { initNewOverlayItem, setCurrentOverlayId, - setPosition, setVisibility, } from "../../../features/overlayTool/overlayToolSlice"; @@ -36,7 +35,7 @@ export function OverlayControl() { if (currentOverlayItem == null) { dispatch(initNewOverlayItem({ overlayId: overlayIds[idNum], - initialPosition: { x: 400, y: 300 }, + initialPosition: { x: 0, y: 0 }, setVisible: true, })); } else { diff --git a/src/components/OverlayTool/OverlayDisplay/OverlayDisplay.tsx b/src/components/OverlayTool/OverlayDisplay/OverlayDisplay.tsx index 6f19e0f..5c2cb46 100644 --- a/src/components/OverlayTool/OverlayDisplay/OverlayDisplay.tsx +++ b/src/components/OverlayTool/OverlayDisplay/OverlayDisplay.tsx @@ -5,8 +5,9 @@ import { useDrag } from "@use-gesture/react"; import { useDimensions } from "../../../utils/hooks"; import { overlayToolSelector } from "../../../features/overlayTool/overlayToolSelector"; import { setPosition } from "../../../features/overlayTool/overlayToolSlice"; +import { OverlayImage, OverlayImageContainer, OverlayImageSubContainer } from "./styles"; -import { OverlayItemContainer } from "./styles"; +const overlayImages = require.context("../../../public/images/overlays", true); type OverlayDisplayProps = { containerDimensions: { @@ -27,10 +28,11 @@ export function OverlayDisplay({ } = useSelector(overlayToolSelector); // Monitor element dimensions to calculate min/max drag coordinates. - const [overlayItemRef, { + const [overlayItemImageRef, { width: overlayItemWidth, height: overlayItemHeight, - }] = useDimensions(); + }] = useDimensions(); + console.log(overlayItemWidth, overlayItemHeight); const minX = -bleedover, minY = -bleedover, @@ -62,7 +64,6 @@ export function OverlayDisplay({ return null; } - const { position } = currentOverlayItem; return transition((style, visible) => visible ? ( @@ -77,15 +78,14 @@ export function OverlayDisplay({ }} > - - {currentOverlayId} -
- (x:{Math.floor(position.x)}px, y:{Math.floor(position.y)}px) -
+ + + + +
) : null, diff --git a/src/components/OverlayTool/OverlayDisplay/styles.ts b/src/components/OverlayTool/OverlayDisplay/styles.ts index 39eae1d..999f0ff 100644 --- a/src/components/OverlayTool/OverlayDisplay/styles.ts +++ b/src/components/OverlayTool/OverlayDisplay/styles.ts @@ -1,22 +1,28 @@ import styled from "styled-components"; -export type OverlayItemContainerProps = { - visible: boolean, - tempColor: string, +/** + * scale is a percentage (0-100%) + * */ +type OverlayImageProps = { + src: string, + scale?: number, }; -export const OverlayItemContainer = styled.div.attrs(({ - visible, +export const OverlayImage = styled.img.attrs(({ + src, }) => ({ - style: { - display: visible ? undefined : "none", - }, -}))` - /* Temporary. Overlay will be transparent and based on an image. */ - /* width: ${({ tempColor }) => tempColor == "red" ? "150px" : "100px"}; */ - width: 150px; - height: 150px; - background-color: ${({ tempColor }) => tempColor}; - box-shadow: 0px 7px 11px 1px black; + draggable: false, + src, +}))` + width: ${({ scale = 100 }) => `${scale}%`}; `; -OverlayItemContainer.displayName = "OverlayItemContainer"; +OverlayImage.displayName = "OverlayImage"; +export const OverlayImageContainer = styled.div` + display: flex; +`; +OverlayImageContainer.displayName = "OverlayImageContainer"; + +export const OverlayImageSubContainer = styled.div` + flex-shrink: 0; +`; +OverlayImageSubContainer.displayName = "OverlayImageSubContainer"; diff --git a/src/components/Workspaces/Workspace/Workspace.tsx b/src/components/Workspaces/Workspace/Workspace.tsx index e42f9f6..7a79ae0 100644 --- a/src/components/Workspaces/Workspace/Workspace.tsx +++ b/src/components/Workspaces/Workspace/Workspace.tsx @@ -16,9 +16,6 @@ import { OverlayDisplay } from "../../OverlayTool"; import { workspaceObject } from "../workspaces"; -const PREVIEW_WINDOW_HEIGHT = 600; -const PREVIEW_WINDOW_WIDTH = 800; - export const Workspace = () => { const dispatch = useDispatch(); const { workspaceId } = useParams(); @@ -40,6 +37,9 @@ export const Workspace = () => { } }, [workspaceId]); + if (workspaceId == null) return null; + const workspace = workspaceObject[workspaceId]; + return ( { maxWidth="80%" centerChildren > -

{workspaceId ? workspaceObject[workspaceId].name : "Unknown"}

+

{workspaceId ? workspace.name : "Unknown"}

Preview Item diff --git a/src/components/Workspaces/Workspace/styles.ts b/src/components/Workspaces/Workspace/styles.ts index 9544e0a..8d689ed 100644 --- a/src/components/Workspaces/Workspace/styles.ts +++ b/src/components/Workspaces/Workspace/styles.ts @@ -2,6 +2,7 @@ import styled, { css, keyframes } from "styled-components"; import { PadBox } from "@bedrock-layout/padbox"; import bg from "../../../public/images/misc/checker-40x40.png"; +import { Dimensions } from "../../../types/state"; const scrollAnimation = keyframes` from { background-position: 0 0; } @@ -9,8 +10,7 @@ const scrollAnimation = keyframes` `; export type PreviewWindowProps = { - height: number, - width: number, + dimensions: Dimensions, animatedBG?: boolean, }; export const PreviewWindow = styled(PadBox).attrs(() => ({ @@ -21,8 +21,8 @@ export const PreviewWindow = styled(PadBox).attrs(() => ({ justify-content: center; align-items: center; - height: ${({ height }) => height}px; - width: ${({ width }) => width}px; + height: ${({ dimensions }) => dimensions.height}px; + width: ${({ dimensions }) => dimensions.width}px; border-radius: 1em; diff --git a/src/components/Workspaces/workspaces.ts b/src/components/Workspaces/workspaces.ts index fa2c6b6..db93ab1 100644 --- a/src/components/Workspaces/workspaces.ts +++ b/src/components/Workspaces/workspaces.ts @@ -1,57 +1,24 @@ -import { OverlayIds } from "../../types/state"; +import { Dimensions, OverlayIds } from "../../types/state"; export type WorkspaceObject = { [id: string]: { name: string, overlayIds: OverlayIds, + previewWindowDimensions: Dimensions, }, }; export const workspaceObject: WorkspaceObject = { - workspace1: { - name: "Workspace 1", - overlayIds: ["red", "blue", "white"], + chyronSimple: { + name: "Chyron Simple", + overlayIds: [ + "chyron-simple-full.png", + "chyron-simple-opening-1.png", + "chyron-simple-opening-2.png", + ], + previewWindowDimensions: { + width: 650, + height: 200, + }, }, - workspace2: { - name: "Workspace 2", - overlayIds: ["green"], - }, - workspace3: { - name: "Workspace 3", - overlayIds: ["green"], - }, - workspace4: { - name: "Workspace 4 has a longer name than the rest", - overlayIds: ["green"], - }, - blah0: { name: "blah", overlayIds: ["green"] }, - blah1: { name: "blah", overlayIds: ["green"] }, - blah2: { name: "blah", overlayIds: ["green"] }, - blah3: { name: "blah", overlayIds: ["green"] }, - blah4: { name: "blah", overlayIds: ["green"] }, - blah5: { name: "blah", overlayIds: ["green"] }, - blah6: { name: "blah", overlayIds: ["green"] }, - blah7: { name: "blah", overlayIds: ["green"] }, - blah8: { name: "blah", overlayIds: ["green"] }, - blah9: { name: "blah", overlayIds: ["green"] }, - blah10: { name: "blah", overlayIds: ["green"] }, - blah11: { name: "blah", overlayIds: ["green"] }, - blah12: { name: "blah", overlayIds: ["green"] }, - blah13: { name: "blah", overlayIds: ["green"] }, - blah14: { name: "blah", overlayIds: ["green"] }, - blah15: { name: "blah", overlayIds: ["green"] }, - blah16: { name: "blah", overlayIds: ["green"] }, - blah17: { name: "blah", overlayIds: ["green"] }, - blah18: { name: "blah", overlayIds: ["green"] }, - blah19: { name: "blah", overlayIds: ["green"] }, - blah20: { name: "blah", overlayIds: ["green"] }, - blah21: { name: "blah", overlayIds: ["green"] }, - blah22: { name: "blah", overlayIds: ["green"] }, - blah23: { name: "blah", overlayIds: ["green"] }, - blah24: { name: "blah", overlayIds: ["green"] }, - blah25: { name: "blah", overlayIds: ["green"] }, - blah26: { name: "blah", overlayIds: ["green"] }, - blah27: { name: "blah", overlayIds: ["green"] }, - blah28: { name: "blah", overlayIds: ["green"] }, - blah29: { name: "blah", overlayIds: ["green"] }, }; diff --git a/src/public/images/overlays/chyron-simple-full.png b/src/public/images/overlays/chyron-simple-full.png new file mode 100644 index 0000000000000000000000000000000000000000..2e28040d8606364b0feb99e6d817a8d55e4d3049 GIT binary patch literal 34529 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 QLjV8(07*qoM6N<$f-&Gq8vp;z+wqt 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