hackmud-script-manager 0.20.4-1d688c1 → 0.20.4-2ed0c4f

package/bin/hsm.js

@@ -62,7 +62,7 @@ process.version.startsWith("v21.") &&
 		)
 	)
 if ("v" == commands[0] || "version" == commands[0] || popOption("version", "v")?.value) {
-	console.log("0.20.4-1d688c1")
+	console.log("0.20.4-2ed0c4f")
 	process.exit()
 }
 let warnedDeprecatedEmitDtsAlias = !1
@@ -83,7 +83,7 @@ switch (commands[0]) {
 				"no-minify" != noMinifyOption.name &&
 				console.warn(
 					colourF(
-						`Warning: ${formatOption(noMinifyOption.name)} is being deprecated and will be removed in the next minor\n         release of HSM\n         You should switch to using its alias ${colourN("--no-minify")}\n`
+						`Warning: ${formatOption(noMinifyOption.name)} is deprecated and will be removed in the next minor\n         release of HSM\n         You should switch to using its alias ${colourN("--no-minify")}\n`
 					)
 				)
 			const mangleNamesOption = popOption("mangle-names"),
@@ -108,6 +108,8 @@ switch (commands[0]) {
 			mangleNamesOption && assertOptionIsBoolean(mangleNamesOption)
 			forceQuineCheatsOption && assertOptionIsBoolean(forceQuineCheatsOption)
 			noQuineCheatsOptions && assertOptionIsBoolean(noQuineCheatsOptions)
+			const rootFolderPathOption = popOption("root-folder-path"),
+				rootFolderPath = rootFolderPathOption && resolve(rootFolderPathOption.value + "")
 			if ("golf" == commands[0] || "minify" == commands[0]) {
 				const watchOption = popOption("watch"),
 					target = commands[1]
@@ -152,11 +154,11 @@ switch (commands[0]) {
 								scriptName,
 								filePath: target,
 								mangleNames: mangleNamesOption?.value,
-								forceQuineCheats: forceQuineCheatsOption?.value ?? !noQuineCheatsOptions?.value
+								forceQuineCheats: forceQuineCheatsOption?.value ?? !noQuineCheatsOptions?.value,
+								rootFolderPath
 							}),
 							timeTook = performance.now() - timeStart
-						for (const { message, line } of warnings)
-							log(`Warning "${chalk.bold(message)}" on line ${chalk.bold(line + "")}`)
+						for (const { message } of warnings) log("Warning: " + chalk.bold(message))
 						await writeFilePersistent(outputPath, script)
 							.catch(error => {
 								if (!commands[2] || "EISDIR" != error.code) throw error
@@ -209,7 +211,7 @@ switch (commands[0]) {
 						"type-declaration-path" != dtsPathOption.name &&
 						console.warn(
 							colourF(
-								`Warning: ${formatOption(dtsPathOption.name)} is being deprecated and will be removed in the\n         next minor release of HSM\n         You should switch to using its alias ${colourN("--dts-path")}\n`
+								`Warning: ${formatOption(dtsPathOption.name)} is deprecated and will be removed in the\n         next minor release of HSM\n         You should switch to using its alias ${colourN("--dts-path")}\n`
 							)
 						)
 					complainAboutUnrecognisedOptions()
@@ -221,7 +223,8 @@ switch (commands[0]) {
 						minify: noMinifyOption && !noMinifyOption.value,
 						mangleNames: mangleNamesOption?.value,
 						onReady: () => log("Watching"),
-						forceQuineCheats: forceQuineCheatsOption?.value ?? !noQuineCheatsOptions?.value
+						forceQuineCheats: forceQuineCheatsOption?.value ?? !noQuineCheatsOptions?.value,
+						rootFolderPath
 					})
 					autoExit = !1
 				} else {
@@ -240,7 +243,7 @@ switch (commands[0]) {
 						const typeDeclaration = await generateTypeDeclaration(sourcePath, hackmudPath)
 						declarationPathPromise = writeFile(typeDeclarationPath, typeDeclaration)
 							.catch(error => {
-								assert(error instanceof Error, "src/bin/hsm.ts:288:38")
+								assert(error instanceof Error, "src/bin/hsm.ts:292:38")
 								if ("EISDIR" != error.code) throw error
 								typeDeclarationPath = resolve(typeDeclarationPath, "player.d.ts")
 								return writeFile(typeDeclarationPath, typeDeclaration)
@@ -254,7 +257,8 @@ switch (commands[0]) {
 							onPush: info => logInfo(info, hackmudPath),
 							minify: noMinifyOption && !noMinifyOption.value,
 							mangleNames: mangleNamesOption?.value,
-							forceQuineCheats: forceQuineCheatsOption?.value ?? !noQuineCheatsOptions?.value
+							forceQuineCheats: forceQuineCheatsOption?.value ?? !noQuineCheatsOptions?.value,
+							rootFolderPath
 						})
 					if (infos instanceof Error) {
 						logError(infos.message)
@@ -308,7 +312,7 @@ switch (commands[0]) {
 				warnedDeprecatedEmitDtsAlias = !0
 				console.warn(
 					colourF(
-						`Warning: ${colourC("hsm")} ${colourL(commands[0])} is being deprecated and will be removed\n         in the next minor release of HSM\n         You should switch to using its alias ${colourC("hsm")} ${colourL("emit-dts")}\n`
+						`Warning: ${colourC("hsm")} ${colourL(commands[0])} is deprecated and will be removed\n         in the next minor release of HSM\n         You should switch to using its alias ${colourC("hsm")} ${colourL("emit-dts")}\n`
 					)
 				)
 			}
@@ -325,7 +329,7 @@ switch (commands[0]) {
 				typeDeclaration = await generateTypeDeclaration(sourcePath, hackmudPath)
 			let typeDeclarationPath = resolve(outputPath)
 			await writeFile(typeDeclarationPath, typeDeclaration).catch(error => {
-				assert(error instanceof Error, "src/bin/hsm.ts:422:35")
+				assert(error instanceof Error, "src/bin/hsm.ts:428:35")
 				if ("EISDIR" != error.code) throw error
 				typeDeclarationPath = resolve(typeDeclarationPath, "player.d.ts")
 				return writeFile(typeDeclarationPath, typeDeclaration)
@@ -350,7 +354,7 @@ function logHelp() {
 		case "push":
 			console.log(
 				colourS(
-					`${colourJ("push" == commands[0] ? pushCommandDescription : "Watch a directory and push a script when modified")}\n\n${colourA("Usage:")}\n${colourC("hsm")} ${colourL(commands[0])} ${colourB('<directory> ["<script user>.<script name>"...]')}\n\n${colourA("Arguments:")}\n${colourB("<directory>")}\n    The source directory containing your scripts\n${colourB("<script user>")}\n    A user to push script(s) to. Can be set to wild card (${colourV("*")}) which will try\n    and discover users to push to\n${colourB("<script name>")}\n    Name of a script to push. Can be set to wild card (${colourV("*")}) to find all scripts\n\n${colourA("Options:")}\n${colourN("--no-minify")}\n    Skip minification to produce a "readable" script\n${colourN("--mangle-names")}\n    Reduce character count further but lose function names in error call stacks\n${colourN("--force-quine-cheats")}, ${colourN("--no-quine-cheats")}\n    Force quine cheats on or off\n${hackmudPathOption}\n${colourN("--dts-path")}=${colourB("<path>")}\n    Path to generate a type declaration (.d.ts) file for the scripts\n${colourN("--watch")}\n    Watch for changes\n\n${colourA("Examples:")}\n${colourC("hsm")} ${colourL(commands[0])} ${colourV("src")}\n    Pushes all scripts found in ${colourV("src")} folder to all users\n${colourC("hsm")} ${colourL(commands[0])} ${colourV("src")} ${colourC("foo")}${colourV(".")}${colourL("bar")}\n    Pushes a script named ${colourL("bar")} found in ${colourV("src")} folder to user ${userColours.get("foo")}\n${colourC("hsm")} ${colourL(commands[0])} ${colourV("src")} ${colourC("foo")}${colourV(".")}${colourL("bar")} ${colourC("baz")}${colourV(".")}${colourL("qux")}\n    Multiple can be specified\n${colourC("hsm")} ${colourL(commands[0])} ${colourV("src")} ${colourC("foo")}${colourV(".")}${colourL("*")}\n    Pushes all scripts found in ${colourV("src")} folder to user ${userColours.get("foo")}\n${colourC("hsm")} ${colourL(commands[0])} ${colourV("src")} ${colourC("*")}${colourV(".")}${colourL("foo")}\n    Pushes all scripts named ${colourL("foo")} found in ${colourV("src")} folder to all user\n${colourC("hsm")} ${colourL(commands[0])} ${colourV("src")} ${colourC("*")}${colourV(".")}${colourL("*")}\n    Pushes all scripts found in ${colourV("src")} folder to all users`
+					`${colourJ("push" == commands[0] ? pushCommandDescription : "Watch a directory and push a script when modified")}\n\n${colourA("Usage:")}\n${colourC("hsm")} ${colourL(commands[0])} ${colourB('<directory> ["<script user>.<script name>"...]')}\n\n${colourA("Arguments:")}\n${colourB("<directory>")}\n    The source directory containing your scripts\n${colourB("<script user>")}\n    A user to push script(s) to. Can be set to wild card (${colourV("*")}) which will try\n    and discover users to push to\n${colourB("<script name>")}\n    Name of a script to push. Can be set to wild card (${colourV("*")}) to find all scripts\n\n${colourA("Options:")}\n${colourN("--no-minify")}\n    Skip minification to produce a "readable" script\n${colourN("--mangle-names")}\n    Reduce character count further but lose function names in error call stacks\n${colourN("--force-quine-cheats")}, ${colourN("--no-quine-cheats")}\n    Force quine cheats on or off\n${hackmudPathOption}\n${colourN("--dts-path")}=${colourB("<path>")}\n    Path to generate a type declaration (.d.ts) file for the scripts\n${colourN("--watch")}\n    Watch for changes\n${colourN("--root-folder-path")}\n    The folder that root will be aliased to in import statements\n\n${colourA("Examples:")}\n${colourC("hsm")} ${colourL(commands[0])} ${colourV("src")}\n    Pushes all scripts found in ${colourV("src")} folder to all users\n${colourC("hsm")} ${colourL(commands[0])} ${colourV("src")} ${colourC("foo")}${colourV(".")}${colourL("bar")}\n    Pushes a script named ${colourL("bar")} found in ${colourV("src")} folder to user ${userColours.get("foo")}\n${colourC("hsm")} ${colourL(commands[0])} ${colourV("src")} ${colourC("foo")}${colourV(".")}${colourL("bar")} ${colourC("baz")}${colourV(".")}${colourL("qux")}\n    Multiple can be specified\n${colourC("hsm")} ${colourL(commands[0])} ${colourV("src")} ${colourC("foo")}${colourV(".")}${colourL("*")}\n    Pushes all scripts found in ${colourV("src")} folder to user ${userColours.get("foo")}\n${colourC("hsm")} ${colourL(commands[0])} ${colourV("src")} ${colourC("*")}${colourV(".")}${colourL("foo")}\n    Pushes all scripts named ${colourL("foo")} found in ${colourV("src")} folder to all user\n${colourC("hsm")} ${colourL(commands[0])} ${colourV("src")} ${colourC("*")}${colourV(".")}${colourL("*")}\n    Pushes all scripts found in ${colourV("src")} folder to all users`
 				)
 			)
 			break
@@ -365,7 +369,7 @@ function logHelp() {
 		case "golf":
 			console.log(
 				colourS(
-					`${colourJ("Minify a script file on the spot")}\n\n${colourA("Usage:")}\n${colourC("hsm")} ${colourL(commands[0])} ${colourB("<target> [output path]")}\n\n${colourA("Options:")}\n${colourN("--no-minify")}\n    Skip minification to produce a "readable" script\n${colourN("--mangle-names")}\n    Reduce character count further but lose function names in error call stacks\n${colourN("--force-quine-cheats")}, ${colourN("--no-quine-cheats")}\n    Force quine cheats on or off\n${colourN("--watch")}\n    Watch for changes`
+					`${colourJ("Minify a script file on the spot")}\n\n${colourA("Usage:")}\n${colourC("hsm")} ${colourL(commands[0])} ${colourB("<target> [output path]")}\n\n${colourA("Options:")}\n${colourN("--no-minify")}\n    Skip minification to produce a "readable" script\n${colourN("--mangle-names")}\n    Reduce character count further but lose function names in error call stacks\n${colourN("--force-quine-cheats")}, ${colourN("--no-quine-cheats")}\n    Force quine cheats on or off\n${colourN("--watch")}\n    Watch for changes\n${colourN("--root-folder-path")}\n    The folder that root will be aliased to in import statements`
 				)
 			)
 			break
@@ -379,7 +383,7 @@ function logHelp() {
 				"gen-dts" == commands[0] ||
 				console.warn(
 					colourF(
-						`Warning: ${colourC("hsm")} ${colourL(commands[0])} is being deprecated and will be removed\n         in the next minor release of HSM\n         You should switch to using its alias ${colourC("hsm")} ${colourL("emit-dts")}\n`
+						`Warning: ${colourC("hsm")} ${colourL(commands[0])} is deprecated and will be removed\n         in the next minor release of HSM\n         You should switch to using its alias ${colourC("hsm")} ${colourL("emit-dts")}\n`
 					)
 				)
 			console.log(
@@ -398,18 +402,20 @@ function logHelp() {
 		default:
 			console.log(
 				colourS(
-					`${colourJ("Hackmud Script Manager")}\n${colourN("Version") + colourS(": ") + colourV("0.20.4-1d688c1")}\n\n${colourA("Commands:")}\n${colourL("push")}\n    ${pushCommandDescription}\n${colourL("minify")}\n    Minify a script file on the spot\n${colourL("emit-dts")}\n    Generate a type declaration file for a directory of scripts\n${colourL("sync-macros")}\n    Sync macros across all hackmud users\n${colourL("pull")}\n    Pull a script a from a hackmud user's script directory\n\n${colourA("Options:")}\n${colourN("--help")}\n    Can be used on any command e.g. ${colourC("hsm")} ${colourL("push")} ${colourN("--help")} to show helpful information`
+					`${colourJ("Hackmud Script Manager")}\n${colourN("Version") + colourS(": ") + colourV("0.20.4-2ed0c4f")}\n\n${colourA("Commands:")}\n${colourL("push")}\n    ${pushCommandDescription}\n${colourL("minify")}\n    Minify a script file on the spot\n${colourL("emit-dts")}\n    Generate a type declaration file for a directory of scripts\n${colourL("sync-macros")}\n    Sync macros across all hackmud users\n${colourL("pull")}\n    Pull a script a from a hackmud user's script directory\n\n${colourA("Options:")}\n${colourN("--help")}\n    Can be used on any command e.g. ${colourC("hsm")} ${colourL("push")} ${colourN("--help")} to show helpful information`
 				)
 			)
 	}
 }
-function logInfo({ path, users, characterCount, error }, hackmudPath) {
+function logInfo({ path, users, characterCount, error, warnings }, hackmudPath) {
 	path = relative(".", path)
-	error ?
-		logError(`Error "${chalk.bold(error.message)}" in ${chalk.bold(path)}`)
-	:	log(
+	if (error) logError(`Error "${chalk.bold(error.message)}" in ${chalk.bold(path)}`)
+	else {
+		for (const warning of warnings) console.warn(colourF("Warning: " + warning.message))
+		log(
 			`Pushed ${chalk.bold(path)} to ${users.map(user => chalk.bold(userColours.get(user))).join(", ")} | ${chalk.bold(characterCount + "")} chars | ${chalk.bold(resolve(hackmudPath, users[0], "scripts", basename(path, extname(path))) + ".js")}`
 		)
+	}
 }
 function logError(message) {
 	console.error(colourD(message))

package/env.d.ts

@@ -1,7 +1,4 @@
-type Replace<A, B> = Omit<A, keyof B> & B
-type ScriptSuccess<T = unknown> = { ok: true } & T
-type ScriptFailure = { ok: false, msg?: string }
-type ScriptResponse<T = unknown> = ScriptSuccess<T> | ScriptFailure
+type Replace<A, B> = Omit<A, keyof B> & BigInt
 type ErrorScripts = Record<string, () => ScriptFailure>
 
 type Subscripts = Record<string, Record<string, (...args: any) => any>> & {
@@ -20,12 +17,6 @@ type Subscripts = Record<string, Record<string, (...args: any) => any>> & {
 	users: ErrorScripts
 }
 
-interface PlayerFullsec {}
-interface PlayerHighsec {}
-interface PlayerMidsec {}
-interface PlayerLowsec {}
-interface PlayerNullsec {}
-
 type UpgradeRarityString = "`0noob`" | "`1kiddie`" | "`2h4x0r`" | "`3h4rdc0r3`" | "`4|_|b3|2`" | "`531337`"
 type UpgradeRarityNumber = 0 | 1 | 2 | 3 | 4 | 5
 
@@ -891,10 +882,19 @@ type MongoProject<TDocument, TProjection> =
 type DeepFreeze<T> = { readonly [P in keyof T]: DeepFreeze<T[P]> }
 
 declare global {
+	type ScriptSuccess<T = unknown> = { ok: true } & T
+	type ScriptFailure = { ok: false, msg?: string }
+	type ScriptResponse<T = unknown> = ScriptSuccess<T> | ScriptFailure
 	type Scriptor<TArgs extends any[] = any[]> = { name: string, call: (...args: TArgs) => unknown }
 	type Context = CliContext | SubscriptContext | ScriptorContext | BrainContext
 	type ObjectId = { $oid: string }
 
+	interface PlayerFullsec {}
+	interface PlayerHighsec {}
+	interface PlayerMidsec {}
+	interface PlayerLowsec {}
+	interface PlayerNullsec {}
+
 	/** Subscript space that can call FULLSEC scripts. */ const $fs: Fullsec
 
 	/** Subscript space that can call HIGHSEC and above scripts. Makes your script HIGHSEC (overrides FULLSEC). */
@@ -1046,6 +1046,9 @@ declare global {
 	  * In rare cases where it's not known at build time, it's `"UNKNOWN"`. */
 	const _SCRIPT_USER: string
 
+	/** @deprecated Use `_SCRIPT_SUBNAME` instead. */
+	const _SCRIPT_NAME: string
+
 	/** The name of this script excluding the user and `.`.
 	  *
 	  * e.g. in the script `foo.bar`, `_SCRIPT_NAME` is `bar`.
@@ -1053,7 +1056,7 @@ declare global {
 	  * Shorter alternative to `context.this_script.split(".")[1].
 	  *
 	  * In rare cases where it's not known at build time, it's `"UNKNOWN"`. */
-	const _SCRIPT_NAME: string
+	const _SCRIPT_SUBNAME: string
 
 	/** The full name of this script equivilent to `context.this_script` but should use less characters.
 	  *

package/index.d.ts

@@ -10,4 +10,7 @@ export type Info = {
     users: string[];
     characterCount: number;
     error: Error | undefined;
+    warnings: {
+        message: string;
+    }[];
 };

package/index.js

@@ -27,6 +27,7 @@ import "@babel/plugin-transform-private-property-in-object"
 import "@babel/plugin-transform-unicode-sets-regex"
 import "@babel/traverse"
 import "@babel/types"
+import "@rollup/plugin-alias"
 import "@rollup/plugin-babel"
 import "@rollup/plugin-commonjs"
 import "@rollup/plugin-json"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hackmud-script-manager",
-  "version": "0.20.4-1d688c1",
+  "version": "0.20.4-2ed0c4f",
   "description": "Script manager for game hackmud, with minification, TypeScript support, and player script type definition generation.",
   "keywords": [
     "api",
@@ -59,6 +59,7 @@
     "@babel/traverse": "^7.25.9",
     "@babel/types": "^7.26.0",
     "@bloomberg/record-tuple-polyfill": "^0.0.4",
+    "@rollup/plugin-alias": "^5.1.1",
     "@rollup/plugin-babel": "^6.0.4",
     "@rollup/plugin-commonjs": "^28.0.1",
     "@rollup/plugin-json": "^6.1.0",

package/processScript/index.d.ts

@@ -16,16 +16,16 @@ export type ProcessOptions = LaxPartial<{
       * when left unset or set to `undefined`, automatically uses or doesn't use quine cheats based on character count
       */
     forceQuineCheats: boolean;
+    rootFolderPath: string;
 }> & {
     scriptName: string | true;
 };
 /** Minifies a given script
   * @param code JavaScript or TypeScript code
   * @param options {@link ProcessOptions details} */
-export declare function processScript(code: string, { minify: shouldMinify, uniqueId, scriptUser, scriptName, filePath, mangleNames, forceQuineCheats }: ProcessOptions): Promise<{
+export declare function processScript(code: string, { minify: shouldMinify, uniqueId, scriptUser, scriptName, filePath, mangleNames, forceQuineCheats, rootFolderPath }: ProcessOptions): Promise<{
     script: string;
     warnings: {
         message: string;
-        line: number;
     }[];
 }>;

package/processScript/index.js

@@ -17,12 +17,13 @@ import babelPluginTransformPrivatePropertyInObject from "@babel/plugin-transform
 import babelPluginTransformUnicodeSetsRegex from "@babel/plugin-transform-unicode-sets-regex"
 import babelTraverse from "@babel/traverse"
 import t from "@babel/types"
+import rollupPluginAlias from "@rollup/plugin-alias"
 import { babel } from "@rollup/plugin-babel"
 import rollupPluginCommonJS from "@rollup/plugin-commonjs"
 import rollupPluginJSON from "@rollup/plugin-json"
 import rollupPluginNodeResolve from "@rollup/plugin-node-resolve"
 import { assert } from "@samual/lib/assert"
-import { resolve } from "path"
+import { relative } from "path"
 import prettier from "prettier"
 import { rollup } from "rollup"
 import { supportedExtensions } from "../constants.js"
@@ -51,10 +52,11 @@ async function processScript(
 		scriptName,
 		filePath,
 		mangleNames = !1,
-		forceQuineCheats
+		forceQuineCheats,
+		rootFolderPath
 	}
 ) {
-	assert(/^\w{11}$/.exec(uniqueId), "src/processScript/index.ts:77:36")
+	assert(/^\w{11}$/.exec(uniqueId), "src/processScript/index.ts:81:36")
 	const sourceCode = code
 	let autocomplete, statedSeclevel
 	const autocompleteMatch = /^function\s*\(.+\/\/(?<autocomplete>.+)/.exec(code)
@@ -115,7 +117,7 @@ async function processScript(
 				}
 			}
 		}
-	assert(/^\w{11}$/.exec(uniqueId), "src/processScript/index.ts:158:36")
+	assert(/^\w{11}$/.exec(uniqueId), "src/processScript/index.ts:162:36")
 	const plugins = [
 		[babelPluginProposalDecorators.default, { decoratorsBeforeExport: !0 }],
 		[babelPluginTransformClassProperties.default],
@@ -135,7 +137,7 @@ async function processScript(
 	]
 	let filePathResolved
 	if (filePath) {
-		filePathResolved = resolve(filePath)
+		filePathResolved = relative(".", filePath)
 		if (filePath.endsWith(".ts"))
 			plugins.push([
 				(await import("@babel/plugin-transform-typescript")).default,
@@ -228,13 +230,14 @@ async function processScript(
 				},
 				babel({ babelHelpers: "bundled", plugins, configFile: !1, extensions: supportedExtensions }),
 				rollupPluginCommonJS(),
-				rollupPluginNodeResolve({ extensions: supportedExtensions })
+				rollupPluginNodeResolve({ extensions: supportedExtensions }),
+				!!rootFolderPath && rollupPluginAlias({ entries: [{ find: /^\//, replacement: rootFolderPath + "/" }] })
 			],
 			treeshake: { moduleSideEffects: !1 }
 		}),
 		seclevelNames = ["NULLSEC", "LOWSEC", "MIDSEC", "HIGHSEC", "FULLSEC"]
 	code = (await bundle.generate({})).output[0].code
-	const { file, seclevel } = transform(parse(code, { sourceType: "module" }), sourceCode, {
+	const { file, seclevel, warnings } = transform(parse(code, { sourceType: "module" }), sourceCode, {
 		uniqueId,
 		scriptUser,
 		scriptName
@@ -249,7 +252,7 @@ async function processScript(
 		traverse(file, {
 			MemberExpression({ node: memberExpression }) {
 				if (!memberExpression.computed) {
-					assert("Identifier" == memberExpression.property.type, "src/processScript/index.ts:321:60")
+					assert("Identifier" == memberExpression.property.type, "src/processScript/index.ts:326:60")
 					if ("prototype" == memberExpression.property.name) {
 						memberExpression.computed = !0
 						memberExpression.property = t.stringLiteral("prototype")
@@ -279,7 +282,7 @@ async function processScript(
 							break
 						case "ObjectPattern":
 							for (const property of lValue.properties) {
-								assert("ObjectProperty" == property.type, "src/processScript/index.ts:351:51")
+								assert("ObjectProperty" == property.type, "src/processScript/index.ts:356:51")
 								renameVariables(property.value)
 							}
 							break
@@ -328,6 +331,6 @@ async function processScript(
 		throw Error(
 			'you found a weird edge case where I wasn\'t able to replace illegal strings like "SC$", please report thx'
 		)
-	return { script: code, warnings: [] }
+	return { script: code, warnings }
 }
 export { minify, postprocess, preprocess, processScript, transform }

package/processScript/preprocess.js

@@ -8,7 +8,7 @@ import { resolve } from "import-meta-resolve"
 const { default: traverse } = babelTraverse,
 	{ default: generate } = babelGenerator
 async function preprocess(code, { uniqueId = "00000000000" } = {}) {
-	assert(/^\w{11}$/.test(uniqueId), "src/processScript/preprocess.ts:22:36")
+	assert(/^\w{11}$/.test(uniqueId), "src/processScript/preprocess.ts:23:36")
 	const sourceCode = code
 	let lengthBefore, file, program
 	do {
@@ -47,7 +47,7 @@ async function preprocess(code, { uniqueId = "00000000000" } = {}) {
 			})
 			break
 		} catch (error_) {
-			assert(error_ instanceof SyntaxError, "src/processScript/preprocess.ts:66:42")
+			assert(error_ instanceof SyntaxError, "src/processScript/preprocess.ts:67:42")
 			error = error_
 		}
 		if ("BABEL_PARSER_SYNTAX_ERROR" != error.code || "PrivateInExpectedIn" != error.reasonCode) {

package/processScript/transform.d.ts

@@ -16,4 +16,7 @@ export type TransformOptions = LaxPartial<{
 export declare function transform(file: File, sourceCode: string, { uniqueId, scriptUser, scriptName, seclevel }: TransformOptions): {
     file: File;
     seclevel: number;
+    warnings: {
+        message: string;
+    }[];
 };

package/processScript/transform.js

@@ -22,7 +22,8 @@ const { default: traverse } = babelTraverse,
 		"BigInt"
 	]
 function transform(file, sourceCode, { uniqueId = "00000000000", scriptUser, scriptName, seclevel = 4 }) {
-	const topFunctionName = `_${uniqueId}_SCRIPT_`
+	const warnings = [],
+		topFunctionName = `_${uniqueId}_SCRIPT_`
 	let program
 	traverse(file, {
 		Program(path) {
@@ -44,9 +45,17 @@ function transform(file, sourceCode, { uniqueId = "00000000000", scriptUser, scr
 				referencePath.replaceWith(t.identifier(`_${uniqueId}_SCRIPT_USER_`))
 			} else
 				referencePath.replaceWith(t.stringLiteral(1 == scriptUser ? `$${uniqueId}$SCRIPT_USER$` : scriptUser))
-	if (program.scope.hasGlobal("_SCRIPT_NAME"))
+	if (program.scope.hasGlobal("_SCRIPT_NAME")) {
+		warnings.push({
+			message:
+				"Global _SCRIPT_NAME is deprecated and will be removed in the next minor release of HSM, use _SCRIPT_SUBNAME instead"
+		})
 		for (const referencePath of getReferencePathsToGlobal("_SCRIPT_NAME", program))
 			referencePath.replaceWith(t.stringLiteral(1 == scriptName ? `$${uniqueId}$SCRIPT_NAME$` : scriptName))
+	}
+	if (program.scope.hasGlobal("_SCRIPT_SUBNAME"))
+		for (const referencePath of getReferencePathsToGlobal("_SCRIPT_SUBNAME", program))
+			referencePath.replaceWith(t.stringLiteral(1 == scriptName ? `$${uniqueId}$SCRIPT_NAME$` : scriptName))
 	if (program.scope.hasGlobal("_FULL_SCRIPT_NAME"))
 		for (const referencePath of getReferencePathsToGlobal("_FULL_SCRIPT_NAME", program))
 			if (1 == scriptUser || 1 == scriptName)
@@ -68,30 +77,30 @@ function transform(file, sourceCode, { uniqueId = "00000000000", scriptUser, scr
 			const referencePath = FunctionReferencePaths[0]
 			assert(
 				"MemberExpression" == referencePath.parent.type,
-				"src/processScript/transform.ts:103:8 `Function` isn't available in hackmud, only `Function.prototype` is accessible"
+				"src/processScript/transform.ts:111:8 `Function` isn't available in hackmud, only `Function.prototype` is accessible"
 			)
 			assert(
 				"Identifier" == referencePath.parent.property.type,
-				"src/processScript/transform.ts:108:8 `Function` isn't available in hackmud, only `Function.prototype` is accessible"
+				"src/processScript/transform.ts:116:8 `Function` isn't available in hackmud, only `Function.prototype` is accessible"
 			)
 			assert(
 				"prototype" == referencePath.parent.property.name,
-				"src/processScript/transform.ts:113:8 `Function` isn't available in hackmud, only `Function.prototype` is accessible"
+				"src/processScript/transform.ts:121:8 `Function` isn't available in hackmud, only `Function.prototype` is accessible"
 			)
 			referencePath.parentPath.replaceWith(createGetFunctionPrototypeNode())
 		} else {
 			for (const referencePath of FunctionReferencePaths) {
 				assert(
 					"MemberExpression" == referencePath.parent.type,
-					"src/processScript/transform.ts:121:9 `Function` isn't available in hackmud, only `Function.prototype` is accessible"
+					"src/processScript/transform.ts:129:9 `Function` isn't available in hackmud, only `Function.prototype` is accessible"
 				)
 				assert(
 					"Identifier" == referencePath.parent.property.type,
-					"src/processScript/transform.ts:126:9 `Function` isn't available in hackmud, only `Function.prototype` is accessible"
+					"src/processScript/transform.ts:134:9 `Function` isn't available in hackmud, only `Function.prototype` is accessible"
 				)
 				assert(
 					"prototype" == referencePath.parent.property.name,
-					"src/processScript/transform.ts:131:9 `Function` isn't available in hackmud, only `Function.prototype` is accessible"
+					"src/processScript/transform.ts:139:9 `Function` isn't available in hackmud, only `Function.prototype` is accessible"
 				)
 				functionDotPrototypeIsReferencedMultipleTimes = !0
 				referencePath.parentPath.replaceWith(t.identifier(`_${uniqueId}_FUNCTION_DOT_PROTOTYPE_`))
@@ -127,12 +136,12 @@ function transform(file, sourceCode, { uniqueId = "00000000000", scriptUser, scr
 	const neededDbMethodLets = new Set()
 	if (program.scope.hasGlobal("$db"))
 		for (const referencePath of getReferencePathsToGlobal("$db", program)) {
-			assert("MemberExpression" == referencePath.parentPath.node.type, "src/processScript/transform.ts:185:69")
-			assert("Identifier" == referencePath.parentPath.node.property.type, "src/processScript/transform.ts:186:72")
+			assert("MemberExpression" == referencePath.parentPath.node.type, "src/processScript/transform.ts:193:69")
+			assert("Identifier" == referencePath.parentPath.node.property.type, "src/processScript/transform.ts:194:72")
 			const databaseOpMethodName = referencePath.parentPath.node.property.name
 			assert(
 				validDBMethods.includes(databaseOpMethodName),
-				`src/processScript/transform.ts:192:8 invalid db method "${databaseOpMethodName}", valid db methods are "${validDBMethods.join('", "')}"`
+				`src/processScript/transform.ts:200:8 invalid db method "${databaseOpMethodName}", valid db methods are "${validDBMethods.join('", "')}"`
 			)
 			if ("CallExpression" == referencePath.parentPath.parentPath?.type)
 				referencePath.parentPath.replaceWith(t.identifier(`$${uniqueId}$DB$${databaseOpMethodName}$`))
@@ -167,7 +176,7 @@ function transform(file, sourceCode, { uniqueId = "00000000000", scriptUser, scr
 	if (program.scope.hasGlobal("Object"))
 		for (const referencePath of getReferencePathsToGlobal("Object", program))
 			if ("MemberExpression" == referencePath.parent.type && !referencePath.parent.computed) {
-				assert("Identifier" == referencePath.parent.property.type, "src/processScript/transform.ts:242:64")
+				assert("Identifier" == referencePath.parent.property.type, "src/processScript/transform.ts:250:64")
 				if ("getPrototypeOf" == referencePath.parent.property.name) {
 					referencePath.parentPath.replaceWith(t.identifier(`_${uniqueId}_GET_PROTOTYPE_OF_`))
 					needGetPrototypeOf = !0
@@ -180,7 +189,7 @@ function transform(file, sourceCode, { uniqueId = "00000000000", scriptUser, scr
 	if (program.scope.hasGlobal("console"))
 		for (const referencePath of getReferencePathsToGlobal("console", program))
 			if ("MemberExpression" == referencePath.parent.type && !referencePath.parent.computed) {
-				assert("Identifier" == referencePath.parent.property.type, "src/processScript/transform.ts:260:64")
+				assert("Identifier" == referencePath.parent.property.type, "src/processScript/transform.ts:268:64")
 				referencePath.parentPath.replaceWith(
 					t.identifier(`_${uniqueId}_CONSOLE_METHOD_${referencePath.parent.property.name}_`)
 				)
@@ -188,13 +197,13 @@ function transform(file, sourceCode, { uniqueId = "00000000000", scriptUser, scr
 			}
 	const lastStatement = program.node.body.at(-1)
 	let exportDefaultName
-	assert(lastStatement, "src/processScript/transform.ts:274:27 program is empty")
+	assert(lastStatement, "src/processScript/transform.ts:282:27 program is empty")
 	if ("ExportNamedDeclaration" == lastStatement.type) {
 		program.node.body.pop()
 		for (const specifier of lastStatement.specifiers) {
 			assert(
 				"ExportSpecifier" == specifier.type,
-				`src/processScript/transform.ts:280:51 ${specifier.type} is currently unsupported`
+				`src/processScript/transform.ts:288:51 ${specifier.type} is currently unsupported`
 			)
 			if (
 				"default" !=
@@ -296,11 +305,11 @@ function transform(file, sourceCode, { uniqueId = "00000000000", scriptUser, scr
 		let hoistedGlobalBlockFunctions = 0
 		for (const [globalBlockIndex, globalBlockStatement] of [...globalBlock.body.entries()].reverse())
 			if ("VariableDeclaration" == globalBlockStatement.type) {
-				assert(1 == globalBlockStatement.declarations.length, "src/processScript/transform.ts:394:59")
+				assert(1 == globalBlockStatement.declarations.length, "src/processScript/transform.ts:402:59")
 				const declarator = globalBlockStatement.declarations[0]
 				assert(
 					"Identifier" == declarator.id.type,
-					`src/processScript/transform.ts:398:51 declarator.id.type was "${declarator.id.type}"`
+					`src/processScript/transform.ts:406:51 declarator.id.type was "${declarator.id.type}"`
 				)
 				program.scope.crawl()
 				if (program.scope.hasGlobal(declarator.id.name)) {
@@ -315,9 +324,9 @@ function transform(file, sourceCode, { uniqueId = "00000000000", scriptUser, scr
 						Object.keys(program.scope.globals).some(global => globalBlockVariables.has(global))
 					) {
 						const binding = program.scope.getBinding(declarator.id.name)
-						assert(binding, "src/processScript/transform.ts:417:23")
+						assert(binding, "src/processScript/transform.ts:425:23")
 						for (const referencePath of binding.referencePaths) {
-							assert("Identifier" == referencePath.node.type, "src/processScript/transform.ts:420:56")
+							assert("Identifier" == referencePath.node.type, "src/processScript/transform.ts:428:56")
 							referencePath.replaceWith(
 								t.memberExpression(
 									t.identifier(`_${uniqueId}_G_`),
@@ -365,16 +374,16 @@ function transform(file, sourceCode, { uniqueId = "00000000000", scriptUser, scr
 				} else globalBlockVariables.add(declarator.id.name)
 			} else if ("ClassDeclaration" == globalBlockStatement.type) {
 				program.scope.crawl()
-				assert(globalBlockStatement.id, "src/processScript/transform.ts:477:37")
+				assert(globalBlockStatement.id, "src/processScript/transform.ts:485:37")
 				if (program.scope.hasGlobal(globalBlockStatement.id.name)) {
 					globalBlock.body.splice(globalBlockIndex, 1)
 					const [globalBlockPath] = program.unshiftContainer("body", globalBlock),
 						[globalBlockStatementPath] = program.unshiftContainer("body", globalBlockStatement)
 					program.scope.crawl()
 					const binding = program.scope.getBinding(globalBlockStatement.id.name)
-					assert(binding, "src/processScript/transform.ts:489:22")
+					assert(binding, "src/processScript/transform.ts:497:22")
 					for (const referencePath of binding.referencePaths) {
-						assert("Identifier" == referencePath.node.type, "src/processScript/transform.ts:492:55")
+						assert("Identifier" == referencePath.node.type, "src/processScript/transform.ts:500:55")
 						referencePath.replaceWith(
 							t.memberExpression(t.identifier(`_${uniqueId}_G_`), t.identifier(referencePath.node.name))
 						)
@@ -566,7 +575,7 @@ function transform(file, sourceCode, { uniqueId = "00000000000", scriptUser, scr
 				}
 		},
 		ClassBody({ node: classBody, scope, parent }) {
-			assert(t.isClass(parent), "src/processScript/transform.ts:687:30")
+			assert(t.isClass(parent), "src/processScript/transform.ts:695:30")
 			let thisIsReferenced = !1
 			for (const classMethod of classBody.body) {
 				if ("ClassMethod" != classMethod.type) continue
@@ -656,7 +665,7 @@ function transform(file, sourceCode, { uniqueId = "00000000000", scriptUser, scr
 			)
 		}
 	})
-	return { file, seclevel }
+	return { file, seclevel, warnings }
 	function createGetFunctionPrototypeNode() {
 		const name = globalFunctionsUnder7Characters.find(name => !program.scope.hasOwnBinding(name))
 		return t.memberExpression(
@@ -666,23 +675,23 @@ function transform(file, sourceCode, { uniqueId = "00000000000", scriptUser, scr
 	}
 	function processFakeSubscriptObject(fakeSubscriptObjectName, seclevel) {
 		for (const referencePath of getReferencePathsToGlobal(fakeSubscriptObjectName, program)) {
-			assert("MemberExpression" == referencePath.parent.type, "src/processScript/transform.ts:793:60")
+			assert("MemberExpression" == referencePath.parent.type, "src/processScript/transform.ts:801:60")
 			assert("Identifier" == referencePath.parent.property.type)
 			assert(
 				"MemberExpression" == referencePath.parentPath.parentPath?.node.type,
-				"src/processScript/transform.ts:795:81"
+				"src/processScript/transform.ts:803:81"
 			)
 			assert(
 				"Identifier" == referencePath.parentPath.parentPath.node.property.type,
-				"src/processScript/transform.ts:796:83"
+				"src/processScript/transform.ts:804:83"
 			)
 			assert(
 				/^[_a-z][\d_a-z]{0,24}$/.test(referencePath.parent.property.name),
-				`src/processScript/transform.ts:800:8 invalid user "${referencePath.parent.property.name}" in subscript`
+				`src/processScript/transform.ts:808:8 invalid user "${referencePath.parent.property.name}" in subscript`
 			)
 			assert(
 				/^[_a-z][\d_a-z]{0,24}$/.test(referencePath.parentPath.parentPath.node.property.name),
-				`src/processScript/transform.ts:805:8 invalid script name "${referencePath.parentPath.parentPath.node.property.name}" in subscript`
+				`src/processScript/transform.ts:813:8 invalid script name "${referencePath.parentPath.parentPath.node.property.name}" in subscript`
 			)
 			if ("CallExpression" == referencePath.parentPath.parentPath.parentPath?.type)
 				referencePath.parentPath.parentPath.replaceWith(

package/push.d.ts

@@ -17,6 +17,7 @@ export type PushOptions = LaxPartial<{
       * when left unset or set to `undefined`, automatically uses or doesn't use quine cheats based on character count
       */
     forceQuineCheats: boolean;
+    rootFolderPath: string;
 }>;
 export declare class MissingSourceFolderError extends Error {
 }
@@ -33,4 +34,4 @@ export declare class NoScriptsError extends Error {
   * @param hackmudPath directory created by hackmud containing user data including scripts
   * @param options {@link PushOptions details}
   * @returns array of info on pushed scripts */
-export declare function push(sourcePath: string, hackmudPath: string, { scripts, onPush, minify, mangleNames, forceQuineCheats }?: PushOptions): Promise<MissingSourceFolderError | MissingHackmudFolderError | NoUsersError | NoScriptsError | Info[]>;
+export declare function push(sourcePath: string, hackmudPath: string, { scripts, onPush, minify, mangleNames, forceQuineCheats, rootFolderPath }?: PushOptions): Promise<MissingSourceFolderError | MissingHackmudFolderError | NoUsersError | NoScriptsError | Info[]>;

package/push.js

@@ -25,6 +25,7 @@ import "@babel/plugin-transform-private-property-in-object"
 import "@babel/plugin-transform-unicode-sets-regex"
 import "@babel/traverse"
 import "@babel/types"
+import "@rollup/plugin-alias"
 import "@rollup/plugin-babel"
 import "@rollup/plugin-commonjs"
 import "@rollup/plugin-json"
@@ -53,7 +54,7 @@ Object.defineProperty(NoScriptsError.prototype, "name", { value: "NoScriptsError
 async function push(
 	sourcePath,
 	hackmudPath,
-	{ scripts = ["*.*"], onPush = () => {}, minify = !0, mangleNames = !1, forceQuineCheats } = {}
+	{ scripts = ["*.*"], onPush = () => {}, minify = !0, mangleNames = !1, forceQuineCheats, rootFolderPath } = {}
 ) {
 	const [sourceFolder, hackmudFolder] = await Promise.all([
 		readDirectoryWithStats(sourcePath).catch(error => {
@@ -72,7 +73,7 @@ async function push(
 	const sourceFolderFolders = sourceFolder.filter(({ stats }) => stats.isDirectory()),
 		allUsers = new Set([
 			...scripts
-				.map(scriptName => ensure(scriptName.split(".")[0], "src/push.ts:82:65"))
+				.map(scriptName => ensure(scriptName.split(".")[0], "src/push.ts:85:65"))
 				.filter(name => "*" != name),
 			...sourceFolderFolders.map(({ name }) => name),
 			...hackmudFolder.filter(({ stats }) => stats.isDirectory()).map(({ name }) => name),
@@ -88,8 +89,8 @@ async function push(
 		scriptNamesToUsers = new AutoMap(_scriptName => new Set())
 	for (const script of scripts) {
 		const [user, scriptName] = script.split(".")
-		assert(user, "src/push.ts:105:16")
-		assert(scriptName, "src/push.ts:106:22")
+		assert(user, "src/push.ts:108:16")
+		assert(scriptName, "src/push.ts:109:22")
 		"*" == user ? scriptNamesToUsers.set(scriptName, allUsers) : scriptNamesToUsers.get(scriptName).add(user)
 	}
 	const sourceFolderFiles = sourceFolder.filter(({ stats }) => stats.isFile()),
@@ -131,16 +132,17 @@ async function push(
 				uniqueId = Math.floor(Math.random() * 2 ** 52)
 					.toString(36)
 					.padStart(11, "0"),
-				{ script: minifiedCode } = await processScript(await readFile(path, { encoding: "utf8" }), {
+				{ script: minifiedCode, warnings } = await processScript(await readFile(path, { encoding: "utf8" }), {
 					minify,
 					scriptUser: !0,
 					scriptName,
 					uniqueId,
 					filePath: path,
 					mangleNames,
-					forceQuineCheats
+					forceQuineCheats,
+					rootFolderPath
 				}),
-				info = { path, users, characterCount: countHackmudCharacters(minifiedCode), error: void 0 }
+				info = { path, users, characterCount: countHackmudCharacters(minifiedCode), error: void 0, warnings }
 			await Promise.all(
 				users.map(user =>
 					writeFilePersistent(

package/watch.d.ts

@@ -6,9 +6,10 @@ export type WatchOptions = PushOptions & LaxPartial<{
       * writing the type declarations enables interscript type checking and autocompletetes for the args */
     typeDeclarationPath: string;
     onReady: () => void;
+    rootFolderPath: string;
 }>;
 /** Watches target file or folder for updates and builds and pushes updated file.
   * @param sourceDirectory path to folder containing source files
   * @param hackmudDirectory path to hackmud directory
   * @param options {@link WatchOptions details} and {@link PushOptions more details} */
-export declare function watch(sourceDirectory: string, hackmudDirectory: string, { scripts, onPush, minify, mangleNames, typeDeclarationPath: typeDeclarationPath_, onReady, forceQuineCheats }?: WatchOptions): Promise<void>;
+export declare function watch(sourceDirectory: string, hackmudDirectory: string, { scripts, onPush, minify, mangleNames, typeDeclarationPath: typeDeclarationPath_, onReady, forceQuineCheats, rootFolderPath }?: WatchOptions): Promise<void>;

package/watch.js

@@ -29,6 +29,7 @@ import "@babel/plugin-transform-private-property-in-object"
 import "@babel/plugin-transform-unicode-sets-regex"
 import "@babel/traverse"
 import "@babel/types"
+import "@rollup/plugin-alias"
 import "@rollup/plugin-babel"
 import "@rollup/plugin-commonjs"
 import "@rollup/plugin-json"
@@ -55,7 +56,8 @@ async function watch(
 		mangleNames = !1,
 		typeDeclarationPath: typeDeclarationPath_,
 		onReady,
-		forceQuineCheats
+		forceQuineCheats,
+		rootFolderPath
 	} = {}
 ) {
 	if (!scripts.length) throw Error("scripts option was an empty array")
@@ -119,27 +121,22 @@ async function watch(
 			for (const user of scriptNamesToUsers.get(scriptName)) usersToPushToSet.add(user)
 			const usersToPushTo = [...usersToPushToSet].filter(user => !scriptNamesToUsersToSkip.has(user))
 			if (!usersToPushTo.length) {
-				onPush?.({ path, users: [], characterCount: 0, error: Error("no users to push to") })
+				onPush?.({ path, users: [], characterCount: 0, error: Error("no users to push to"), warnings: [] })
 				return
 			}
 			const uniqueId = Math.floor(Math.random() * 2 ** 52)
 					.toString(36)
 					.padStart(11, "0"),
 				filePath = resolve(sourceDirectory, path)
-			let minifiedCode
+			let minifiedCode, warnings
 			try {
-				;({ script: minifiedCode } = await processScript(await readFile(filePath, { encoding: "utf8" }), {
-					minify,
-					scriptUser: !0,
-					scriptName,
-					uniqueId,
-					filePath,
-					mangleNames,
-					forceQuineCheats
-				}))
+				;({ script: minifiedCode, warnings } = await processScript(
+					await readFile(filePath, { encoding: "utf8" }),
+					{ minify, scriptUser: !0, scriptName, uniqueId, filePath, mangleNames, forceQuineCheats }
+				))
 			} catch (error) {
-				assert(error instanceof Error, "src/watch.ts:148:36")
-				onPush?.({ path, users: [], characterCount: 0, error })
+				assert(error instanceof Error, "src/watch.ts:151:36")
+				onPush?.({ path, users: [], characterCount: 0, error, warnings: [] })
 				return
 			}
 			await Promise.all(
@@ -156,7 +153,8 @@ async function watch(
 				path,
 				users: usersToPushTo,
 				characterCount: countHackmudCharacters(minifiedCode),
-				error: void 0
+				error: void 0,
+				warnings
 			})
 			return
 		}
@@ -170,25 +168,27 @@ async function watch(
 			)
 		)
 			return
-		const filePath = resolve(sourceDirectory, path),
+		const sourceDirectoryResolved = resolve(sourceDirectory),
+			filePath = resolve(sourceDirectoryResolved, path),
 			sourceCode = await readFile(filePath, { encoding: "utf8" })
-		let script
+		let script, warnings
 		try {
-			;({ script } = await processScript(sourceCode, {
+			;({ script, warnings } = await processScript(sourceCode, {
 				minify,
 				scriptUser: user,
 				scriptName,
 				filePath,
 				mangleNames,
-				forceQuineCheats
+				forceQuineCheats,
+				rootFolderPath
 			}))
 		} catch (error) {
-			assert(error instanceof Error, "src/watch.ts:184:35")
-			onPush?.({ path, users: [], characterCount: 0, error })
+			assert(error instanceof Error, "src/watch.ts:198:35")
+			onPush?.({ path, users: [], characterCount: 0, error, warnings: [] })
 			return
 		}
 		await writeFilePersistent(resolve(hackmudDirectory, user, "scripts", scriptName + ".js"), script)
-		onPush?.({ path, users: [user], characterCount: countHackmudCharacters(script), error: void 0 })
+		onPush?.({ path, users: [user], characterCount: countHackmudCharacters(script), error: void 0, warnings })
 	})
 	onReady && watcher.on("ready", onReady)
 	if (!typeDeclarationPath_) return
@@ -198,7 +198,7 @@ async function watch(
 		try {
 			await writeFile(typeDeclarationPath, typeDeclaration)
 		} catch (error) {
-			assert(error instanceof Error, "src/watch.ts:217:35")
+			assert(error instanceof Error, "src/watch.ts:231:35")
 			if ("EISDIR" != error.code) throw error
 			typeDeclarationPath = resolve(typeDeclarationPath, "player.d.ts")
 			await writeFile(typeDeclarationPath, typeDeclaration)