factoriomod-debug 2.1.4 → 2.1.5

package/doc/internal/calls.dot

@@ -1,29 +0,0 @@
-digraph calls {
-pad=1
-# 0 getinfo, 1 stackTrace, 2 callThread, 3 stackTrace, 4 debug command, 5 debug.debug,
-# in normal stepping:                       6 sethook callback, 7 at breakpoint
-# in exception (instrument only)            6 on_error callback, 7 pCallWithStackTraceMessageHandler, 8 at exception
-# in remote-redirected call:                2 unhook, 3 at stack
-
-"??" -> "@code" -> api_breakpoint -> debugprompt;
-
-pcall -> rawxpcall -> "???" -> "@error" -> caught -> debugprompt
-xpcall -> rawxpcall
-caught -> user_handler [dir=both; arrowtail=crow;]
-
-event -> "??"
-"??" -> "@unhandled" -> pCallWithStackTraceMessageHandler -> caught;
-"??" -> "@step" -> hook;
-"??" -> "@breakpoint" -> hook;
-hook -> debugprompt;
-
-debugprompt -> "debug command" -> dap_outer -> dispatch -> dap_inner;
-{ rank=same; dispatch -> unhook }
-"@remote" -> unhook -> dap_inner
-
-dap_inner -> "0 getinfo";
-
-{ rank=same; "@code" "@step" "@breakpoint" "@error" }
-{ rank=same; hook api_breakpoint caught }
-
-}

package/doc/internal/noncharacters.md

@@ -1,76 +0,0 @@
-U+FFFE/U+FFFF?
-
-U+FDD0-U+FDEF to signal message types?
-
-## stdout prefix:
-
-### events w/ prompt
-
-| bytes    | code |                       |
-|----------|------|-----------------------|
-| EF B7 90 | FDD0 | simple message        |
-| EF B7 91 | FDD1 | json event w/prompt   |
-
-### events w/o prompt
-
-| bytes    | code |                       |
-|----------|------|-----------------------|
-| EF B7 94 | FDD4 | translation result    |
-| EF B7 95 | FDD5 | json event            |
-| EF B7 96 | FDD6 | json response         |
-| EF B7 97 | FDD7 | raw buffer            |
-| EF B7 98 | FDD8 | invalidated event     |
-
-### profile events
-| bytes    | code |                       |
-|----------|------|-----------------------|
-| EF B7 A0 | FDE0 | profile line          |
-| EF B7 A1 | FDE1 | profile call          |
-| EF B7 A2 | FDE2 | profile tailcall      |
-| EF B7 A3 | FDE3 | profile return        |
-| EF B7 AD | FDED | legacy profile dump   |
-
-### blocks
-| bytes    | code |                       |
-|----------|------|-----------------------|
-| EF B7 AE | FDEE |  block start          |
-| EF B7 AF | FDEF |  block end            |
-
-## json reviver:
-| bytes    | code |                       |
-|----------|------|-----------------------|
-| EF B7 90 | FDD0 | DA Basename?          |
-| EF B7 91 | FDD1 | DA Path               |
-| EF B7 92 | FDD2 | DA Line               |
-| EF B7 93 | FDD3 | (reserved for DA Column?) |
-| EF B7 94 | FDD4 | translation result    |
-| EF B7 95 | FDD5 | raw buffer id         |
-
-PUA U+E000-U+F8FF also available for use?
-
-## after FDD0 as ID:
-| bytes    | code | message                 | data    |
-|----------|------|-------------------------|---------|
-| EE 80 80 | E000 | on_instrument_settings  |         |
-| EE 80 81 | E001 | on_instrument_data      |         |
-| EE 80 82 | E002 | on_instrument_control   | modname |
-| EE 80 83 | E003 | on_da_control           |         |
-| EE 80 84 | E004 | object_info             |         |
-| EE 80 85 | E005 | getref                  |         |
-| EE 80 86 | E006 | on_tick                 |         |
-| EE 80 87 | E007 | on_data                 |         |
-| EE 80 88 | E008 | on_parse                |         |
-| EE 80 89 | E009 | ~~on_init~~             |         |
-| EE 80 8A | E00A | ~~on_load~~             |         |
-| EE 80 8B | E00B | ~~leaving/running~~     |         |
-| EE 80 8C | E00C | terminate               |         |
-| EE 80 8D | E00D | ~~step~~                |         |
-| EE 80 8E | E00E | ~~breakpoint~~          |         |
-| EE 80 8F | E00F | ~~exception~~           |         |
-| EE 80 90 | E010 | restart                 |         |
-
-## after FDD7 in buffer:
-
-U+F800-F8FF as escaped bytes
-
-currently on `\n` for windows console and 0xEF to catch accidentally containing an end or an escape

package/doc/internal/requires.dot

@@ -1,92 +0,0 @@
-digraph G {
-pad=1
-
-json;
-threads;
-dispatch;
-
-normalizeLuaSource
-enumutil;
-luaobjectinfo;
-iterutil;
-
-variables;
-evaluate;
-
-print;
-log;
-
-datastring;
-stepping;
-stacks;
-
-debugadapter;
-
-
-edge [color=blue];
-debugadapter -> threads;
-threads -> json;
-
-edge [color=red];
-debugadapter -> dispatch;
-dispatch -> threads;
-
-edge [color=green];
-debugadapter -> variables;
-variables -> dispatch [dir=both arrowtail=odiamond];
-variables -> luaobjectinfo;
-variables -> normalizeLuaSource;
-variables -> json;
-variables -> iterutil;
-
-edge [color=orange];
-debugadapter -> evaluate;
-evaluate -> json;
-evaluate -> dispatch [dir=both arrowtail=dot];
-evaluate -> variables ;# describe, error, create, translate, pindex
-
-edge [color=darkorchid];
-debugadapter -> print;
-print -> json;
-print -> normalizeLuaSource;
-print -> variables; # create, translate, sourceRef
-print -> evaluate;
-
-edge [color=steelblue];
-debugadapter -> stepping;
-stepping -> iterutil;
-stepping -> normalizeLuaSource;
-stepping -> json;
-stepping -> datastring;
-stepping -> threads;
-stepping -> dispatch;
-stepping -> variables; # create, translate, buffer, sourceRef
-stepping -> evaluate ; # stringInterp, evaluateInternal
-stepping -> print ; # outputEvent, print
-
-edge [color=blue];
-debugadapter -> log;
-log -> normalizeLuaSource;
-log -> variables; # describe, translate
-log -> print;
-
-edge [color=purple];
-debugadapter -> stacks;
-stacks -> json;
-stacks -> threads;
-stacks -> dispatch;
-stacks -> normalizeLuaSource;
-stacks -> variables; # describe, sourceRef, scopeRef, tableRef
-stacks -> stepping ;# on_exception, getEntryLabel
-
-edge [color=deeppink];
-luaobjectinfo -> enumutil;
-luaobjectinfo -> dispatch [dir=both arrowtail=odiamond];
-
-# late bindings via dispatch
-edge [constraint=false color=orangered arrowhead=odot];
-variables -> evaluate ;# stringInterp, evaluateInternal
-luaobjectinfo -> evaluate ;# stringInterp
-
-
-}

package/eslint.config.ts

@@ -1,102 +0,0 @@
-import { globalIgnores, defineConfig } from "eslint/config";
-import globals from "globals";
-import tseslint from 'typescript-eslint';
-import stylisticTs from '@stylistic/eslint-plugin';
-
-export default defineConfig([
-	globalIgnores(["dist", "coverage", "test/factorio"]),
-	...tseslint.configs.recommendedTypeChecked,
-	{
-		plugins: {
-			"@stylistic/ts": stylisticTs,
-		},
-
-		languageOptions: {
-			globals: {
-				...globals.browser,
-				...globals.node,
-			},
-
-			ecmaVersion: 2022,
-			sourceType: "module",
-
-			parserOptions: {
-				project: "./tsconfig.json",
-			},
-		},
-
-		rules: {
-			"@stylistic/ts/member-delimiter-style": ["error", {
-				multiline: {
-					delimiter: "none",
-					requireLast: true,
-				},
-
-				singleline: {
-					delimiter: "semi",
-					requireLast: false,
-				},
-			}],
-
-
-			"@stylistic/ts/semi": ["error"],
-			"brace-style": ["error", "1tbs", {
-				allowSingleLine: true,
-			}],
-
-			"block-spacing": "error",
-			"space-before-blocks": "error",
-			"keyword-spacing": "error",
-
-			"arrow-spacing": ["error", {
-				before: false,
-				after: false,
-			}],
-
-			"switch-colon-spacing": "error",
-			"comma-spacing": "error",
-			"comma-style": "error",
-
-			"comma-dangle": ["error", {
-				arrays: "always-multiline",
-				objects: "always-multiline",
-				imports: "always-multiline",
-				exports: "always-multiline",
-				functions: "only-multiline",
-			}],
-
-			"key-spacing": "error",
-
-			indent: ["error", "tab", {
-				SwitchCase: 1,
-				flatTernaryExpressions: true,
-			}],
-
-			curly: "error",
-			eqeqeq: ["error", "always"],
-			"no-bitwise": "error",
-			"no-redeclare": "off",
-			"@typescript-eslint/no-redeclare": "error",
-
-			"@typescript-eslint/no-unused-vars": "off",
-			"@typescript-eslint/no-explicit-any": "off",
-			"@typescript-eslint/no-unsafe-assignment": "off",
-			"@typescript-eslint/no-unsafe-member-access": "off",
-			"@typescript-eslint/no-unsafe-call": "off",
-			"@typescript-eslint/no-unsafe-return": "off",
-			"@typescript-eslint/no-unsafe-argument": "off",
-			"@typescript-eslint/restrict-template-expressions": "off",
-
-			"no-var": "error",
-
-			"@typescript-eslint/consistent-type-imports": ["error", {
-				disallowTypeAnnotations: true,
-				fixStyle: 'separate-type-imports',
-				prefer: 'type-imports',
-			}],
-			"@typescript-eslint/consistent-type-exports": "error",
-
-			"@typescript-eslint/no-deprecated": "error",
-			"@typescript-eslint/no-extraneous-class": "error",
-		},
-	}]);