add workspace seed option

Author: softmarshmallow

editor/core/states/workspace-initial-state.ts

@@ -1,5 +1,5 @@
 import { EditorSnapshot } from "./editor-state";
-import { WorkspaceState } from "./workspace-state";
+import { WorkspaceState, EssentialWorkspaceInfo } from "./workspace-state";
 import {
   createInitialHistoryState,
   createPendingHistoryState,
@@ -23,7 +23,7 @@ export function merge_initial_workspace_state_with_editor_snapshot(
   };
 }
 
-export function create_initial_pending_workspace_state(): WorkspaceState {
+export function create_initial_pending_workspace_state({}: EssentialWorkspaceInfo): WorkspaceState {
   return {
     taskQueue: {
       isBusy: false,

editor/core/states/workspace-state.ts

@@ -1,7 +1,11 @@
 import { config } from "@grida/builder-config";
 import { HistoryState } from "core/states/history-state";
 
-export interface WorkspaceState {
+export interface EssentialWorkspaceInfo {
+  // Add workspace seed data here, which cannot be automatically filled on initial state.
+}
+
+export interface WorkspaceState extends EssentialWorkspaceInfo {
   history: HistoryState;
   /**
    * hovered layer; single or none.

editor/scaffolds/workspace/warmup.ts

@@ -3,23 +3,29 @@ import {
   EditorSnapshot,
   WorkspaceState,
 } from "core/states";
-import { merge_initial_workspace_state_with_editor_snapshot } from "core/states";
+import {
+  merge_initial_workspace_state_with_editor_snapshot,
+  EssentialWorkspaceInfo,
+} from "core/states";
 import { workspaceWarmupReducer, workspaceReducer } from "core/reducers";
 import { PendingState, PendingState_Pending } from "core/utility-types";
 import { WorkspaceAction, WorkspaceWarmupAction } from "core/actions";
 
-const initial_pending_workspace_state =
-  create_initial_pending_workspace_state();
 //
 export type InitializationAction =
   | { type: "warmup"; value: WorkspaceWarmupAction }
   | { type: "setup-with-editor-snapshot"; value: EditorSnapshot }
   | { type: "update"; value: WorkspaceAction };
 
+type TState = PendingState<WorkspaceState> & EssentialWorkspaceInfo;
+
 export function initialReducer(
-  state: PendingState<WorkspaceState>,
+  state: TState,
   action: InitializationAction
 ): PendingState<WorkspaceState> {
+  const initial_pending_workspace_state =
+    create_initial_pending_workspace_state({});
+
   switch (action.type) {
     case "setup-with-editor-snapshot":
       return {
@@ -63,13 +69,16 @@ export function initialReducer(
   }
 }
 
-export function safestate(initialState) {
+export function safestate(initialState: TState): WorkspaceState {
+  const initial_pending_workspace_state =
+    create_initial_pending_workspace_state({});
+
   switch (initialState.type) {
     case "success":
       return initialState.value;
     case "pending": {
       if (initialState.value) {
-        return initialState.value;
+        return initialState.value as WorkspaceState;
       } else {
         return initial_pending_workspace_state;
       }

editor/scaffolds/workspace/workspace.tsx

@@ -5,7 +5,7 @@ import React, {
   createContext,
 } from "react";
 import { useRouter } from "next/router";
-import { StateProvider } from "core/states";
+import { EssentialWorkspaceInfo, StateProvider } from "core/states";
 import { SetupWorkspace } from "./setup";
 import { WorkspaceDefaultProviders } from "./_providers";
 import * as warmup from "./warmup";
@@ -21,7 +21,10 @@ export function useWorkspaceInitializerContext() {
   return useContext(WorkspaceInitializerContext);
 }
 
-export function Workspace({ children }: React.PropsWithChildren<{}>) {
+export function Workspace({
+  children,
+  ...seed
+}: React.PropsWithChildren<EssentialWorkspaceInfo>) {
   const router = useRouter();
 
   const handleDispatch = useCallback((action: WorkspaceAction) => {
@@ -46,7 +49,10 @@ export function Workspace({ children }: React.PropsWithChildren<{}>) {
     type: "pending",
   });
 
-  const safe_value = warmup.safestate(initialState);
+  const safe_value = warmup.safestate({
+    ...initialState,
+    ...seed,
+  });
 
   return (
     <>