ByoungSooPark/modeling-app
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Change to use doc comments (#7596)

Browse Source
This commit is contained in:
Jonathan Tran
2025-06-24 15:56:55 -04:00
committed by GitHub
parent 8d876a806e
commit 0ad619e1d2
1 changed files with 25 additions and 23 deletions
Download Patch File Download Diff File Expand all files Collapse all files

48
src/lib/rustContext.ts
View File

@ -30,7 +30,7 @@ export default class RustContext {
private _defaultPlanes: DefaultPlanes | null = null
private engineCommandManager: EngineCommandManager
// Initialize the WASM module
/** Initialize the WASM module */
async ensureWasmInit() {
try {
await initPromise
@ -53,7 +53,7 @@ export default class RustContext {
.catch(reportRejection)
}
// Create a new context instance
/** Create a new context instance */
async create(): Promise<Context> {
this.rustInstance = getModule()
@ -68,7 +68,7 @@ export default class RustContext {
return ctxInstance
}
// Execute a program.
/** Execute a program. */
async execute(
node: Node<Program>,
settings: DeepPartial<Configuration>,
@ -82,7 +82,7 @@ export default class RustContext {
path,
JSON.stringify(settings)
)
/* Set the default planes, safe to call after execute. */
// Set the default planes, safe to call after execute.
const outcome = execStateFromRust(result)
this._defaultPlanes = outcome.defaultPlanes
@ -96,7 +96,7 @@ export default class RustContext {
}
}
// Execute a program with in mock mode.
/** Execute a program with in mock mode. */
async executeMock(
node: Node<Program>,
settings: DeepPartial<Configuration>,
@ -122,7 +122,7 @@ export default class RustContext {
}
}
// Export a scene to a file.
/** Export a scene to a file. */
async export(
format: DeepPartial<OutputFormat3d>,
settings: DeepPartial<Configuration>,
@ -150,20 +150,22 @@ export default class RustContext {
return this._defaultPlanes
}
// Clear/reset the scene and bust the cache.
// Do not use this function unless you absolutely need to. In most cases,
// we should just fix the cache for whatever bug you are seeing.
// The only time it makes sense to run this is if the engine disconnects and
// reconnects. The rust side has no idea that happened and will think the
// cache is still valid.
// Caching on the rust side accounts for changes to files outside of the
// scope of the current file the user is on. It collects all the dependencies
// and checks if any of them have changed. If they have, it will bust the
// cache and recompile the scene.
// The typescript side should never raw dog clear the scene since that would
// fuck with the cache as well. So if you _really_ want to just clear the scene
// AND NOT re-execute, you can use this for that. But in 99.999999% of cases just
// re-execute.
/**
* Clear/reset the scene and bust the cache.
* Do not use this function unless you absolutely need to. In most cases,
* we should just fix the cache for whatever bug you are seeing.
* The only time it makes sense to run this is if the engine disconnects and
* reconnects. The rust side has no idea that happened and will think the
* cache is still valid.
* Caching on the rust side accounts for changes to files outside of the
* scope of the current file the user is on. It collects all the dependencies
* and checks if any of them have changed. If they have, it will bust the
* cache and recompile the scene.
* The typescript side should never raw dog clear the scene since that would
* fuck with the cache as well. So if you _really_ want to just clear the scene
* AND NOT re-execute, you can use this for that. But in 99.999999% of cases just
* re-execute.
*/
async clearSceneAndBustCache(
settings: DeepPartial<Configuration>,
path?: string
@ -199,7 +201,7 @@ export default class RustContext {
return this.defaultPlanes[key]
}
// Send a response back to the rust side, that we got back from the engine.
/** Send a response back to the rust side, that we got back from the engine. */
async sendResponse(
response: Models['WebSocketResponse_type']
): Promise<void> {
@ -214,7 +216,7 @@ export default class RustContext {
}
}
// Helper to check if context instance exists
/** Helper to check if context instance exists */
private async _checkInstance(): Promise<Context> {
if (!this.ctxInstance) {
// Create the context instance.
@ -224,7 +226,7 @@ export default class RustContext {
return this.ctxInstance
}
// Clean up resources
/** Clean up resources */
destroy() {
if (this.ctxInstance) {
// In a real implementation, you might need to manually free resources