Feat/table manager2

.github/copilot-instructions.md

@@ -1,7 +1,7 @@
 # ModulesOnRails Copilot Instructions
 
 ## Goal
-This repository contains multiple Roblox Wally modules. Favor consistency inside the package you are editing over consistency with the rest of the repository.
+This repository contains multiple Roblox Wally modules. Favor consistency inside the package you are editing over consistency with the rest of the repository. We use Luau, not Lua.
 
 ## Priority Order
 1. Follow the local style of the current package first.
@@ -21,30 +21,30 @@ If a package is pure Luau and has multiple modules, do not use `init.luau` as th
 
 Publishing will generate an `init.luau` re-export automatically. Non-pure-Luau packages may use `init.luau` directly.
 
-## Setup For Development
-Use `npm run setup <package-name>` when deeper local package context is needed. This installs dependencies and arranges them similarly to live usage, improving autocomplete, linting, and diagnostics in VS Code.
-
 ## Luau Style Rules
 - Use PascalCase for class names, table fields, and method names.
 - Use camelCase for variable names.
 - Use SCREAMING_SNAKE_CASE for constants.
-- Prefix private fields and methods with `_`.
+- Prefix private fields and methods of class objects with `_`.
 - Add explicit types for non-inferred parameters and function signatures.
 - For Luau classes, define both a public type and an internal type.
 - Internal type should extend public type with private fields and methods.
 - Declare class methods with dot syntax and explicit `self: InternalType`.
 - Call those methods with colon syntax.
 - Keep existing comments and debug logic unless removal is explicitly requested or the content is now outdated.
 - Methods/functions that yield or could potentially yield should be either suffixed with `Async` or return as a Promise to prevent unexpected behavior.
-- Avoid magic numbers. That is, numbers with no obvious underlying meaning. You can attribute meaning to a number by assigning it to a variable or constant with a descriptive name, or by writing a comment explaining what the number's purpose is.
-- Packages should always have relative paths for their requires. Never require another module with an absolute path.
+- Avoid magic numbers. That is, numbers or valueswith no obvious underlying meaning. You can attribute meaning to a number by assigning it to a variable or constant with a descriptive name, or by writing a comment explaining what the number's purpose is.
+- Packages should always have relative paths for their requires. Never require another module with an absolute path. Prefer string requires.
+- Avoid forward declaration whenever possible.
 
 ## Documentation Style
 - Public single-line docs: `---`
 - Public multi-line docs: `--[=[]=]`
 - Private single-line comments: `--`
 - Private multi-line comments: `--[[]]`
 
+Documentation is in moonwave format.
+
 ## Constant Policy
 Use `const` whenever a variable binding is never reassigned.
 
@@ -53,7 +53,7 @@ Important notes:
 - Base-scope constants should use SCREAMING_SNAKE_CASE unless they are mutable-content tables.
 - If a variable is declared and immediately assigned later, treat it as non-const for policy purposes.
 - Exceptions to the constant naming policy may be made when justified by readability, practicality, or consistency with existing code. Ex: Roblox services and required modules should be consts at the base scope, but they should be PascalCase even though they are never reassigned.
-- local functions should almost always be const.
+- Functions should almost always be const. `const function` is preferred over `local function` for functions that are never reassigned. This is because it makes it clear that the function is not intended to be reassigned, and it can help prevent accidental reassignment.
 
 Declaration matrix:
 
@@ -70,11 +70,13 @@ Declaration matrix:
 | any | Inner | Assigned programmatically | local with camelCase |
 
 ## Testing Rules
-- Use tiniest for tests. Analyze the examples under `/test/tiniest` for reference.
-- TestEZ is deprecated in this codebase. NEVER use TestEZ or its syntax. They do not exist.
+- `tiniest` is the testing framework we use for running tests. If needed, analyze the examples under `/test/tiniest` for reference.
+- Utilize `tiniest`'s `describe`, `test`, `expect`, and `context` functions for structuring tests and assertions. Context is useful for debugging test cases by providing custom additional info. Attach context to failing tests to surface that info in the test output.
 - Create tests in `.spec.luau` files.
-- For pure Luau packages, run tests through `tests.luau` in VS Code.
+- Do not attempt to run tests through command line or anything else yourself unless you are explicitly instructed to.
+- For pure Luau packages, you can run tests through `tests.luau` in VS Code.
 - For non-pure-Luau packages, rely on developer-run manual testing and provided output.
+- TestEZ is deprecated in this codebase. NEVER use TestEZ or its syntax. They do not exist.
 
 ## Debugging Rules
 - Never assume root cause without validating with test output.
@@ -83,5 +85,8 @@ Declaration matrix:
 - Prefer extra context over minimal logs so follow-up decisions can be made from one run.
 
 ## Planning
-- While planning, you must should come up with a flowchart to explain the current way things work and a separate flowchart to explain the new proposal. If a plan includes multiple separate changes, you need multiple separate before and after flowcharts.
-- You must always include a list of to-dos in the final plan and they should be broken into discrete tasks that an agent can be tasked with.
+- Plans should be broken up into phases that can be executed independently without breaking a system. Each phase should have a clear goal and a defined-ordered set of tasks.
+- Phases should note touched files and the expected impact on those files. This helps with code review and ensures that changes are intentional and well-understood.
+
+## Reference Links
+- If creating a type function, view the following: https://luau.org/types-library/

.gitignore

@@ -1,6 +1,7 @@
 
 *.rbxl
 *.rbxl.lock
+*.pyc
 
 src/baseobject/*
 !src/baseobject/baseobject
@@ -23,4 +24,5 @@ last_tested_package.txt
 
 !**/wally.toml
 !**/default.project.json
+!**/README.md
 node_modules

CLAUDE.md

@@ -0,0 +1 @@
+See .github/copilot-instructions.md for a guide on this repository.

default.project.json

@@ -3,35 +3,6 @@
     "emitLegacyScripts": false,
     "tree": {
         "$className": "DataModel",
-
-        "Workspace": {
-            "$className": "Workspace",
-            "BasePlate":{
-                "$className": "Part",
-                "$properties": {
-                    "Size": [1024, 4, 1024],
-                    "Position": [0, -2, 0],
-                    "Color": {
-                        "Color3uint8": [91, 91, 91] 
-                    },
-                    "Anchored": true,
-                    "Locked": true,
-                    "TopSurface": "Smooth"
-                },
-
-                "GridTexture": {
-                    "$className": "Texture",
-                    "$properties": {
-                        "Texture": "rbxassetid://6372755229",
-                        "StudsPerTileU": 8,
-                        "StudsPerTileV": 8,
-                        "Color3": [0, 0, 0],
-                        "Transparency": 0.8,
-                        "Face": "Top"
-                    }
-                }
-            }
-        },
 
         "ReplicatedStorage": {
             "$className": "ReplicatedStorage",
@@ -43,60 +14,6 @@
             }
         },
 
-        "Lighting": {
-            "$className": "Lighting",
-            "$properties": {
-                "Ambient": {
-                    "Color3uint8": [70, 70, 70] 
-                },
-                "OutdoorAmbient": {
-                    "Color3uint8": [70, 70, 70] 
-                },
-                "GlobalShadows": true,
-                "Brightness": 3,
-                "ShadowSoftness": 0.2,
-                "EnvironmentSpecularScale": 1,
-                "EnvironmentDiffuseScale": 1,
-                "GeographicLatitude": 0,
-                "ClockTime": 14.5,
-                "Technology": "Future"
-            },
-
-            "Sky": {
-                "$className": "Sky",
-                "$properties": {
-                    "MoonTextureId": "rbxassetid://6444320592",
-                    "SkyboxBk": "rbxassetid://6444884337",
-                    "SkyboxDn": "rbxassetid://6444884785",
-                    "SkyboxFt": "rbxassetid://6444884337",
-                    "SkyboxLf": "rbxassetid://6444884337",
-                    "SkyboxRt": "rbxassetid://6444884337",
-                    "SkyboxUp": "rbxassetid://6412503613",
-                    "CelestialBodiesShown": false,
-                    "StarCount": 3000,
-                    "MoonAngularSize": 11,
-                    "SunAngularSize": 11,
-                    "SunTextureId": "rbxassetid://6196665106"
-                }
-            },
-
-            "Atmopshere": {
-                "$className": "Atmosphere",
-                "$properties": {
-                    "Density": 0.3,
-                    "Offset": 0.25,
-                    "Color": {
-                        "Color3uint8": [199, 199, 199] 
-                    },
-                    "Decay": {
-                        "Color3uint8": [106, 112, 125] 
-                    },
-                    "Glare": 0,
-                    "Haze": 0
-                }
-            }
-        },
-
         "HttpService": {
             "$className": "HttpService",
             "$properties": {