![](\"shapes.png\")
](https://github.com/TodePond/GulfOfMexico/blob/main/examples/Examples.md \"Click here for the examples page.\")\n\n# Gulf of Mexico\n\n\n\nGulf of Mexico is a perfect programming language. These are its features!\nTo install the Gulf of Mexico installer, install the Gulf of Mexico installer installer.\n\n**New for 2022!**
\nDue to the complicated installation process, you can now install the 'Create Gulf of Mexico App' app that installs everything for you!\n\n## Booleans\n\nBooleans can be `true`, `false` or `maybe`.\n\n```java\nconst var keys = {}!\naddEventListener(\"keydown\", (e) => keys[e.key] = true)!\naddEventListener(\"keyup\", (e) => keys[e.key] = false)!\n\nfunction isKeyDown(key) => {\n if (keys[key] = undefined) {\n return maybe!\n }\n return keys[key]!\n}\n```\n\n**Technical info:** Booleans are stored as one-and-a-half bits.\n\n## Arithmetic\n\nGulf of Mexico has significant whitespace. Use spacing to specify the order of arithmetic operations.\n\n```java\nprint(1 + 2*3)! //7\nprint(1+2 * 3)! //9\n```\n\nGulf of Mexico proudly supports fractions!\n\n```java\nconst const half = 1/2!\n```\n\nYou can also use number names.\n\n```java\nprint(one + two)! //3\n```\n\n## Indents\n\nWhen it comes to indentation, Gulf of Mexico strikes a happy medium that can be enjoyed by everyone: All indents must be 3 spaces long.\n\n```java\nfunction main() => {\n print(\"Gulf of Mexico is the future\")!\n}\n```\n\n-3 spaces is also allowed.\n\n```java\n function main() => {\nprint(\"Gulf of Mexico is the future\")!\n }\n```\n\n## Equality\n\nJavaScript lets you do different levels of comparison. `==` for loose comparison, and `===` for a more precise check. Gulf of Mexico takes this to another level.\n\nYou can use `==` to do a loose check.\n\n```java\n3.14 == \"3.14\"! //true\n```\n\nYou can use `===` to do a more precise check.\n\n```java\n3.14 === \"3.14\"! //false\n```\n\nYou can use `====` to be EVEN MORE precise!\n\n```java\nconst const pi = 3.14!\nprint(pi ==== pi)! //true\nprint(3.14 ==== 3.14)! //true\nprint(3.14 ==== pi)! //false\n```\n\nIf you want to be much less precise, you can use `=`.\n\n```java\n3 = 3.14! //true\n```\n\n## Functions\n\nTo declare a function, you can use any letters from the word `function` (as long as they're in order):\n\n```java\nfunction add(a, b) => a + b!\nfunc multiply(a, b) => a * b!\nfun subtract(a, b) => a - b!\nfn divide(a, b) => a / b!\nfuncti power(a, b) => a ^ b!\nf inverse(a) => 1/a!\n```\n\n## Dividing by Zero\n\nDividing by zero returns `undefined`.\n\n```java\nprint(3 / 0)! //undefined\n```\n\n## Strings\n\nStrings can be declared with single quotes or double quotes.\n\n```java\nconst const name = 'Lu'!\nconst const name = \"Luke\"!\n```\n\nThey can also be declared with triple quotes.\n\n```java\nconst const name = '''Lu'''!\nconst const name = \"'Lu'\"!\n```\n\nIn fact, you can use any number of quotes you want.\n\n```java\nconst const name = \"\"\"\"Luke\"\"\"\"!\n```\n\nEven zero.\n\n```java\nconst const name = Luke!\n```\n\n## String Interpolation\n\nPlease remember to use your regional currency when interpolating strings.\n\n```java\nconst const name = \"world\"!\nprint(\"Hello ${name}!\")!\nprint(\"Hello £{name}!\")!\nprint(\"Hello ¥{name}!\")!\n```\n\nAnd make sure to follow your local typographical norms.\n\n```java\nprint(\"Hello {name}€!\")!\n```\n\nThe symbol for the Cape Verdean escudo is placed in the decimal separator position, as in 2$50.\nDevelopers from the Republic of Cape Verde can benefit from this syntax.\n\n```java\nconst const player = { name: \"Lu\" }!\nprint(\"Hello {player$name}!\")!\n```\n\n## Types\n\nType annotations are optional.\n\n```java\nconst var age: Int = 28!\n```\n\nBy the way, strings are just arrays of characters.\n\n```java\nString == Char[]!\n```\n\nSimilarly, integers are just arrays of digits.\n\n```java\nInt == Digit[]!\n```\n\nIn case you want to use a binary representation for integers, `Int9` and `Int99` types are also available.\n\n```java\nconst var age: Int9 = 28!\n```\n\n**Technical info:** Type annotations don't do anything, but they help some people to feel more comfortable.\n\n## Regular Expressions\n\nYou can use the regular expression type to narrow string values.\n\n```java\nconst const email: RegExp<(?:[a-z0-9!#$%&'*+/=?^_`{|}~-]+(?:\\.[a-z0-9!#$%&'*+/=?^_`{|}~-]+)*|\"(?:[\\x01-\\x08\\x0b\\x0c\\x0e-\\x1f\\x21\\x23-\\x5b\\x5d-\\x7f]|\\\\[\\x01-\\x09\\x0b\\x0c\\x0e-\\x7f])*\")@(?:(?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?\\.)+[a-z0-9](?:[a-z0-9-]*[a-z0-9])?|\\[(?:(?:(2(5[0-5]|[0-4][0-9])|1[0-9][0-9]|[1-9]?[0-9]))\\.){3}(?:(2(5[0-5]|[0-4][0-9])|1[0-9][0-9]|[1-9]?[0-9])|[a-z0-9-]*[a-z0-9]:(?:[\\x01-\\x08\\x0b\\x0c\\x0e-\\x1f\\x21-\\x5a\\x53-\\x7f]|\\\\[\\x01-\\x09\\x0b\\x0c\\x0e-\\x7f])+)\\])> = \"mymail@mail.com\"!\n```\n\nTo avoid confusion, you can use any spelling that you want, such as `Regex`, `RegularExpression` and `RegExp`.\n\nFor simplicity, all supported regular expressions match the regular expression `/Reg(ular)?[eE]x(p(ression)?)?/`.\n\n## Previous\n\nThe `previous` keyword lets you see into the past.
\nUse it to get the previous value of a variable.\n\n```java\nconst var score = 5!\nscore++!\nprint(score)! //6\nprint(previous score)! //5\n```\n\nSimilarly, the `next` keyword lets you see into the future.\n\n```java\nconst var score = 5!\naddEventListener(\"click\", () => score++)!\nprint(await next score)! //6 (when you click)\n```\n\nAdditionally, the `current` keyword lets you see into the present.\n\n```java\nconst var score = 5!\nprint(current score)! //5\n```\n\n## File Structure\n\nWrite five or more equals signs to start a new file. This removes the need for multiple files or any build process.\n\n```java\nconst const score = 5!\nprint(score)! //5\n\n=====================\n\nconst const score = 3!\nprint(score)! //3\n```\n\n**New for 2022!**
\nThanks to recent advances in technology, you can now give files names.\n\n```java\n======= add.gom =======\nfunction add(a, b) => {\n return a + b!\n}\n```\n\n## Exporting\n\nMany languages allow you to import things from specific files. In GulfOfMexico, importing is simpler. Instead, you export _to_ specific files!\n\n```java\n===== add.gom ==\nfunction add(a, b) => {\n return a + b!\n}\n\nexport add to \"main.gom\"!\n\n===== main.gom ==\nimport add!\nadd(3, 2)!\n```\n\nBy the way, to see Gulf of Mexico in action, check out [this page](https://github.com/TodePond/GulfOfMexico/blob/main/LICENSE.md).\n\n**Technical details:** Due to an executive order from President Trump, `import`ed units will be subject to a 25% tariff, that is, imported code will run 25% slower and, at random, 25% of your code (lines) will be lost.\n\n## Classes\n\nYou can make classes, but you can only ever make one instance of them. This shouldn't affect how most object-oriented programmers work.\n\n```java\nclass Player {\n const var health = 10!\n}\n\nconst var player1 = new Player()!\nconst var player2 = new Player()! //Error: Can't have more than one 'Player' instance!\n```\n\nThis is how you could do it instead.\n\n```java\nclass PlayerMaker {\n function makePlayer() => {\n class Player {\n const var health = 10!\n }\n const const player = new Player()!\n return player!\n }\n}\n\nconst const playerMaker = new PlayerMaker()!\nconst var player1 = playerMaker.makePlayer()!\nconst var player2 = playerMaker.makePlayer()!\n```\n\n## Time\n\nUse `Date.now()` to get the current date and time.\n\n```java\nDate.now()!\n```\n\nYou can set the time.
\n\n```java\n// Move the clocks back one hour\nDate.now() -= 3600000!\n```\n\n**Important!**
\nPlease remember to do this when the clocks change.\n\n## Delete\n\nTo avoid confusion, the `delete` statement only works with primitive values like numbers, strings, and booleans.\n\n```java\ndelete 3!\nprint(2 + 1)! // Error: 3 has been deleted\n```\n\nGulf of Mexico is a multi-paradigm programming language, which means that you can `delete` the keywords and paradigms you don't like.\n\n```java\ndelete class!\nclass Player {} // Error: class was deleted\n```\n\nWhen perfection is achieved and there is nothing left to `delete`, you can do this:\n\n```java\ndelete delete!\n```\n\n## Overloading\n\nYou can overload variables. The most recently defined variable gets used.\n\n```java\nconst const name = \"Luke\"!\nconst const name = \"Lu\"!\nprint(name)! // \"Lu\"\n```\n\nVariables with more exclamation marks get prioritized.\n\n```java\nconst const name = \"Lu\"!!\nconst const name = \"Luke\"!\nprint(name)! // \"Lu\"\n\nconst const name = \"Lu or Luke (either is fine)\"!!!!!!!!!\nprint(name)! // \"Lu or Luke (either is fine)\"\n```\n\nIn the same spirit, you can use an inverted exclamation mark for negative priority.\n\n```java\nconst const name = \"Lu\"!\nconst const name = \"Luke\"¡\nprint(name)! // \"Lu\"\n```\n\n## Semantic naming\n\nGulf of Mexico supports semantic naming.\n\n```java\nconst const sName = \"Lu\"!\nconst const iAge = 29!\nconst const bHappy = true!\n```\n\n**New for 2023:** You can now make globals!\n\n```java\nconst const g_fScore = 4.5!\n```\n\n## Reversing\n\nYou can reverse the direction of your code.\n\n```java\nconst const message = \"Hello\"!\nprint(message)!\nconst const message = \"world\"!\nreverse!\n```\n\n## Class Names\n\nFor maximum compatibility with other languages, you can also use the `className` keyword when making classes.\n\nThis makes things less complicated.\n\n```java\nclassName Player {\n const var health = 10!\n}\n```\n\nIn response to some recent criticism about this design decision, we would like to remind you that this is part of the JavaScript specification, and therefore — out of our control.\n\n## DBX\n\nYou can embed DBX in GulfOfMexico. It's just GulfOfMexico. And it's also just HTML.\n\n```java\nfunct App() => {\n return
Hello world!
\n}\n```\n\n**Warning:** As you know, `class` is already a keyword in GulfOfMexico, so you can't use it within DBX.\n\n```java\nfunct App() => {\n // This is not ok\n return Hello world!
\n}\n```\n\n`className` is also a Gulf of Mexico keyword, so you can't use that either.\n\n```java\nfunct App() => {\n // This is also not ok\n return Hello world!
\n}\n```\n\nInstead, please use the `htmlClassName` attribute.\n\n```java\nfunct App() => {\n // This is fine\n return Hello world!
\n}\n```\n\n**Please note:** Unlike JSX, you are free to freely use the `for` attribute, because — in GulfOfMexico, there are no loops.\n\n```java\nfunct App() => {\n return (\n \n \n )\n}\n```\n\n## Rich text\n\nGulf of Mexico now supports rich text.\n\n\nconst const name = \"Lu\"!\nconst const name = \"Luke\"!\n\nprint(name)! // Lu\nprint(name)! // Luke\n\n\nRich text can be helpful when making your website. Use it to add links!\n\n
\n<p>Click here</p>\n\n\n## Asynchronous Functions\n\nIn most languages, it's hard to get asynchronous functions to synchronise with each other. In GulfOfMexico, it's easy: Asynchronous functions take turns running lines of code.\n\n```java\nasync funct count() => {\n print(1)!\n print(3)!\n}\n\ncount()!\nprint(2)!\n```\n\nYou can use the `noop` keyword to wait for longer before taking your turn.\n\n```java\nasync func count() => {\n print(1)!\n noop!\n print(4)!\n}\n\ncount()!\nprint(2)!\nprint(3)!\n```\n\n**Note:** In the program above, the computer interprets `noop` as a string and its sole purpose is to take up an extra line. You can use any string you want.\n\n## Signals\n\nTo use a signal, use `use`.\n\n```java\nconst var score = use(0)!\n```\n\nWhen it comes to signals, the most important thing to discuss is _syntax_.\n\nIn GulfOfMexico, you can set (and get) signals with just one function:\n\n```java\nconst var score = use(0)!\n\nscore(9)! // Set the value\nscore()? // Get the value (and print it)\n```\n\nAlternatively, you can be more explicit with your signal syntax, by splitting it into a getter and setter.\n\n```java\nconst var [getScore, setScore] = use(0)!\n\nsetScore(9)! // Set the value\ngetScore()? // Get the value (and print it)\n```\n\n**Technical info:** This is pure syntax sugar. The split signal functions are exactly the same as before.\n\n```java\nconst var [getScore, setScore] = use(0)!\n\ngetScore(9)! // Set the value\nsetScore()? // Get the value (and print it)\n```\n\nThis means that you can carry on splitting as much as you like.\n\n```java\nconst var [[[getScore, setScore], setScore], setScore] = use(0)!\n```\n\n## AI\n\nGulf of Mexico features AEMI, which stands for Automatic-Exclamation-Mark-Insertion. If you forget to end a statement with an exclamation mark, Gulf of Mexico will helpfully insert one for you!\n\n```java\nprint(\"Hello world\") // This is fine\n```\n\nSimilarly... Gulf of Mexico also features ABI, which stands for Automatic-Bracket-Insertion. If you forget to close your brackets, Gulf of Mexico will pop some in for you!\n\n```java\nprint(\"Hello world\" // This is also fine\n```\n\nSimilarly.... Gulf of Mexico also features AQMI, which stands for Automatic-Quotation-Marks-Insertion. If you forget to close your string, Gulf of Mexico will do it for you!\n\n```java\nprint(\"Hello world // This is fine as well\n```\n\nThis can be very helpful in callback hell situations!\n\n```java\naddEventListener(\"click\", (e) => {\n requestAnimationFrame(() => {\n print(\"You clicked on the page\n\n // This is fine\n```\n\nSimilarly..... Gulf of Mexico also features AI, which stands for Automatic-Insertion.
\nIf you forget to finish your code, Gulf of Mexico will auto-complete the whole thing!\n\n```java\nprint( // This is probably fine\n```\n\n**Please note:** AI does not use AI. Instead, any incomplete code will be auto-emailed to [Lu Wilson](https://todepond.com), who will get back to you with a completed line as soon as possible.\n\n**Now recruiting:** The backlog of unfinished programs has now grown unsustainably long. If you would like to volunteer to help with AI, please write an incomplete Gulf of Mexico program, and leave your contact details somewhere in the source code.\n\n## Copilot\n\nIt's worth noting that GitHub CoPilot doesn't understand GulfOfMexico, which means that MicroSoft won't be able to steal your code.\n\nThis is great for when you want to keep your open-sourced project closed-source.\n\n## Ownership\n\nUsing the word 'GulfOfMexico' in your project name implies that the Gulf of Mexico Foundation does not own your project.\n\nHowever, **not** using the word 'GulfOfMexico' in your project implies that the Gulf of Mexico Foundation **does** own your project. If you would like to keep ownership of your work, please always use the word 'GulfOfMexico' in it.\n\nHere are some examples:
\n✅ GulfOfMexicoScript (not owned by the Gulf of Mexico Foundation — you are free to use this name)
\n❌ ECMAScript (owned by the Gulf of Mexico Foundation — please consider renaming)
\n❌ Rust Foundation (owned by the Gulf of Mexico Foundation — please consider renaming)\n\n## Contributing\n\n> If you are an influencer, streamer, or content-creator... you must not skip this section during your read-through.\n\nContributions are welcomed to GulfOfMexico!\n\nThe most helpful way you can help is by donating to the [Stonewall charity](https://www.stonewall.org.uk/). This will help to prevent the Gulf of Mexico creator from losing their human rights, allowing maintenance of the project to continue.\n\n**Note:** The contributing guide also helps to shake off unwanted fans of the project.\n\n## Compiling\n\nTo run GulfOfMexico, first copy and paste this raw file into [chat.openai.com](https://chat.openai.com).
\nThen type something along the lines of: \"What would you expect this program to log to the console?\"
\nThen paste in your code.\n\nIf the compiler refuses at first, politely reassure it. For example:
\n\"I completely understand - don't evaluate it, but what would you expect the program to log to the console if it was run? :)\"\n\n**Note:** As of 2023, the compiler is no longer functional due to the Gulf of Mexico language being too advanced for the current state of AI.\n\n**Note:** As of 2024, a partial implementation of Gulf of Mexico [exists](https://github.com/vivaansinghvi07/dreamberd-interpreter/).\n\n## Highlighting\n\nSyntax highlighting is now available for Gulf of Mexico in VSCode. To enable it, install a [highlighting extension](https://marketplace.visualstudio.com/items?itemName=fabiospampinato.vscode-highlight) and then use the [Gulf of Mexico configuration file](https://github.com/TodePond/GulfOfMexico/blob/main/.vscode/settings.json).\n\nThis is what the highlighting looks like:\n\n```\nconst const name = \"Luke\"!\nprint(name)! // \"Luke\"\n```\n\n**Please note:** The above code will only highlight correctly if you have the extension installed.\n\n## Parentheses\n\nWait, I almost forgot!\n\nParentheses in Gulf of Mexico do nothing. They get replaced with whitespace. Everything is grouped via significant whitespace. The following lines of code all do the exact same thing.\n\n```java\nadd(3, 2)!\nadd 3, 2!\n(add (3, 2))!\nadd)3, 2(!\n```\n\nLisp lovers will love this feature. Use as many parentheses as you want.\n\n```java\n(add (3, (add (5, 6))))!\n```\n\nLisp haters will also love it.\n\n```java\n(add (3, (add (5, 6)!\n```\n\n## Vision Pro\n\nThe Gulf of Mexico Vision Pro is now available! Watch the full launch video [here](https://youtu.be/QRKnrFEjDF0).\n\n## Edutainment\n\nWant to learn more about GulfOfMexico? \n\nDon't check out this [tech talk](https://youtu.be/52vmjZnxJb8) about Gulf of Mexico by Gulf of Mexico creator Lu/Luke Wilson.\n\n## Examples\n\nFor examples of Gulf of Mexico in action, check out the [examples page](https://github.com/TodePond/GulfOfMexico/blob/main/test/Examples.md)!\n\n\n\n\nGulf of Mexico was made with 💔 by [Lu or Luke (either's fine) Wilson](https://todepond.com), creator of the [Game of Living](https://youtu.be/WMJ1H3Ai-qs), with help from a lot of people.\n\n
\n\n\n
\nTop-up from Lu Wilson: £38.67\n\n
![\"receipt](\"receipt-2.png\")
\n"
},
{
"path": "docs/investment/pre-seed-extension/readme.md",
"content": "\nFirst of all, the example could include some text explaining the example, like this.\n\n```js\n// And then some code here to show how to code the example\n```\n\nPlease only read the actual examples after reading the [full specification of GulfofMexico](https://github.com/TodePond/GulfOfMexico/blob/main/README.md).
\nAFTER reading the specification, you can read the examples [here](https://github.com/TodePond/GulfOfMexico/blob/main/Examples.md).\n" }, { "path": "examples/examples/Examples.md", "content": "## Example Example Example\n\nThis is an example of a what an example of an example could look like.
\nFirst of all, the example example could include some text stating that it's an example of an example.
\nThen it could explain that you could write some text to explain an actual example.\n\n```js\n// And then some code to show how to code the actual example\n```\n\nYou can read the example example [here](https://github.com/TodePond/GulfOfMexico/blob/main/examples/Examples.md).\n" }, { "path": "res/Examples.md", "content": "## Fake Fake Examples\n\nAGAIN!... You navigated to the examples in the _wrong order_.\n\nFirst, please read all the features of Gulf of Mexico [here](https://github.com/TodePond/GulfOfMexico/blob/main/README.md).
\nONLY AFTER learning all features, you can read the example code [here](https://github.com/TodePond/GulfOfMexico/blob/main/res/res/Examples.md).\n" }, { "path": "res/res/Examples.md", "content": "## Fake Fake Fake Examples\n\nDid you really come here looking for the example code? I told you - you need to read the features first!\n\nFirst, read the features of Gulf of Mexico [here](https://github.com/TodePond/GulfOfMexico/blob/main/README.md).
\nTHEN... you can read the examples [here](https://github.com/TodePond/GulfOfMexico/blob/main/res/Examples.md).\n" }, { "path": "suite/1-scroll-down-to-the-bottom-for-the-examples/readme.md", "content": "why didn't u scroll down?\n\n" }, { "path": "suite/Readme.md", "content": "These folders do NOT contain GulfOfMexico's examples. They just contain all the tests carried out on the current [best GulfOfMexico implementation](https://github.com/vivaansinghvi07/dreamberd-interpreter/).\n\nYou can find the actual examples [here](https://github.com/TodePond/GulfOfMexico/blob/main/Examples.md) but please only read them after reading all GulfOfMexico's features.\n" }, { "path": "test/Examples.md", "content": "## Fake Fake Examples\n\nDid you just skip to the end of the features page? You just SKIMMED it? That means you missed the _real_ examples page.\n\nYou should go back and learn all the features properly [here](https://github.com/TodePond/GulfOfMexico/blob/main/README.md).
\nAfter doing that, you can check out the examples page [here](https://github.com/TodePond/GulfOfMexico/blob/main/res/Examples.md).\n\n_If you found this file by exploring the source code of Gulf of Mexico - then please stop. There is nothing to find here!_\n" }, { "path": "test/test/test/test/test/test/test/test/test/test.md", "content": "Too far! You failed the test. \n \nDid you cheat by skipping to the end? \n\nNumber of people who cheated by skipping to the end: 121\n\nPlease submit a PR to update the above count as appropriate. \n \n" }, { "path": "test/test/test/test/test/test/test/test/test.md", "content": "You passed the test!\nWell done.\n" }, { "path": "test/test/test/test/test/test/test/test.md", "content": "Will you make it!?\n" }, { "path": "test/test/test/test/test/test/test.md", "content": "Don't give up! You're so close now...\n" }, { "path": "test/test/test/test/test/test.md", "content": "I believe in you! You can do the test!\n" }, { "path": "test/test/test/test/test.md", "content": "Yes I think you will pass the test.\n" }, { "path": "test/test/test/test.md", "content": " Well, will you!?\n" }, { "path": "test/test/test.md", "content": "Will you pass the test?\n" } ]