jak-project/common
Tyler Wilding d1ece445d4
Dependency graph work - Part 1 - Preliminary work (#3505)
Relates to #1353 

This adds no new functionality or overhead to the compiler, yet. This is
the preliminary work that has:
- added code to the compiler in several spots to flag when something is
used without being properly required/imported/whatever (disabled by
default)
- that was used to generate project wide file dependencies (some
circulars were manually fixed)
- then that graph underwent a transitive reduction and the result was
written to all `jak1` source files.

The next step will be making this actually produce and use a dependency
graph. Some of the reasons why I'm working on this:
- eliminates more `game.gp` boilerplate. This includes the `.gd` files
to some extent (`*-ag` files and `tpage` files will still need to be
handled) this is the point of the new `bundles` form. This should make
it even easier to add a new file into the source tree.
- a build order that is actually informed from something real and
compiler warnings that tell you when you are using something that won't
be available at build time.
- narrows the search space for doing LSP actions -- like searching for
references. Since it would be way too much work to store in the compiler
every location where every symbol/function/etc is used, I have to do
ad-hoc searches. By having a dependency graph i can significantly reduce
that search space.
- opens the doors for common shared code with a legitimate pattern.
Right now jak 2 shares code from the jak 1 folder. This is basically a
hack -- but by having an explicit require syntax, it would be possible
to reference arbitrary file paths, such as a `common` folder.

Some stats:
- Jak 1 has about 2500 edges between files, including transitives
- With transitives reduced at the source code level, each file seems to
have a modest amount of explicit requirements.

Known issues:
- Tracking the location for where `defmacro`s and virtual state
definitions were defined (and therefore the file) is still problematic.
Because those forms are in a macro environment, the reader does not
track them. I'm wondering if a workaround could be to search the
reader's text_db by not just the `goos::Object` but by the text
position. But for the purposes of finishing this work, I just statically
analyzed and searched the code with throwaway python code.
2024-05-12 12:37:59 -04:00
..
audio deps: update fmt to latest version (#3403) 2024-03-05 22:11:52 -05:00
cross_os_debug deps: update fmt to latest version (#3403) 2024-03-05 22:11:52 -05:00
cross_sockets deps: update fmt to latest version (#3403) 2024-03-05 22:11:52 -05:00
custom_data Add hfrag, clean up some background renderer stuff (#3509) 2024-05-09 20:11:43 -04:00
dma deps: update fmt to latest version (#3403) 2024-03-05 22:11:52 -05:00
formatter decomp3: spawn target, add merc and particle buckets and some temporary hacks (#3445) 2024-04-05 00:07:39 -04:00
global_profiler deps: update fmt to latest version (#3403) 2024-03-05 22:11:52 -05:00
goos [goalc] speed up jak3 compilation (#3454) 2024-04-06 16:01:17 -04:00
log deps: update fmt to latest version (#3403) 2024-03-05 22:11:52 -05:00
math deps: update fmt to latest version (#3403) 2024-03-05 22:11:52 -05:00
repl Dependency graph work - Part 1 - Preliminary work (#3505) 2024-05-12 12:37:59 -04:00
serialization deps: update fmt to latest version (#3403) 2024-03-05 22:11:52 -05:00
sqlite [jak2] Work-in-progress texture animations (#2819) 2023-07-14 18:17:54 -04:00
texture decompiler: allow jak 3 texture and model extraction (#3080) 2023-10-11 19:32:12 -04:00
type_system Dependency graph work - Part 1 - Preliminary work (#3505) 2024-05-12 12:37:59 -04:00
util Dependency graph work - Part 1 - Preliminary work (#3505) 2024-05-12 12:37:59 -04:00
versions deps: update fmt to latest version (#3403) 2024-03-05 22:11:52 -05:00
CMakeLists.txt goalc: Fix new symbol trie's performance inefficiencies (#3443) 2024-04-01 18:56:55 -04:00
common_types.h support c++ tools on macos (#2063) 2022-12-22 17:12:05 -05:00
goal_constants.h [jak3] Set up ckernel (#3308) 2024-01-16 19:24:02 -05:00
link_types.h [jak3] Set up ckernel (#3308) 2024-01-16 19:24:02 -05:00
listener_common.h Typo fix LTT_MSG_INSEPCT (#2778) 2023-06-29 16:45:53 -04:00
symbols.h [jak3] Set up ckernel (#3308) 2024-01-16 19:24:02 -05:00