Repo Update

- Setting up repo

Author: jarroddavis68

.github/workflows/changelog.yml

@@ -0,0 +1,218 @@
+name: Update Changelog
+
+on:
+  push:
+    branches:
+      - main
+      - master
+  workflow_dispatch:
+
+jobs:
+  update-changelog:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout Repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Setup Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: '3.x'
+
+      - name: Generate Changelog
+        run: |
+          python3 << 'EOF'
+          import subprocess
+          import sys
+          from datetime import datetime
+          from collections import defaultdict
+
+          def run_git_log(args):
+              try:
+                  result = subprocess.run(['git'] + args, capture_output=True, text=True, check=True)
+                  # FIX #1: Split by a null character instead of a newline to handle multi-line bodies.
+                  return result.stdout.strip().split('\x00') if result.stdout.strip() else []
+              except subprocess.CalledProcessError as e:
+                  print(f"Error running git: {e}")
+                  sys.exit(1)
+
+          def get_commits_by_tag():
+              try:
+                  latest_tag = subprocess.run(
+                      ['git', 'describe', '--tags', '--abbrev=0'],
+                      capture_output=True, text=True, check=True
+                  ).stdout.strip()
+
+                  tag_date = subprocess.run(
+                      ['git', 'log', '-1', '--format=%ad', '--date=short', latest_tag],
+                      capture_output=True, text=True, check=True
+                  ).stdout.strip()
+
+                  tagged = run_git_log([
+                      'log', latest_tag,
+                      # FIX #2: Add the %x00 null character as a safe delimiter for commits.
+                      '--pretty=format:%s|||%b|||%an|||%ad|||%H%x00',
+                      '--date=short',
+                      '--invert-grep',
+                      '--grep=docs: update changelog',
+                      '--grep=changelog.yml',
+                      '--grep=\\[skip ci\\]'
+                  ])
+
+                  unreleased = run_git_log([
+                      'log', f'{latest_tag}..HEAD',
+                      # FIX #3: Add the delimiter here as well.
+                      '--pretty=format:%s|||%b|||%an|||%ad|||%H%x00',
+                      '--date=short',
+                      '--invert-grep',
+                      '--grep=docs: update changelog',
+                      '--grep=changelog.yml',
+                      '--grep=\\[skip ci\\]'
+                  ])
+
+                  return {
+                      'tagged': {latest_tag: {'commits': tagged, 'date': tag_date}},
+                      'unreleased': unreleased
+                  }
+
+              except subprocess.CalledProcessError:
+                  all_commits = run_git_log([
+                      'log',
+                      # FIX #4: And add the delimiter here for the fallback case.
+                      '--pretty=format:%s|||%b|||%an|||%ad|||%H%x00',
+                      '--date=short',
+                      '--invert-grep',
+                      '--grep=docs: update changelog',
+                      '--grep=changelog.yml',
+                      '--grep=\\[skip ci\\]'
+                  ])
+                  return {
+                      'tagged': {},
+                      'unreleased': all_commits
+                  }
+
+          def categorize_commit(subject, body):
+              text = (subject + ' ' + body).lower()
+              if any(x in text for x in ['security', 'vulnerability', 'cve', 'exploit']):
+                  return 'security'
+              if any(x in text for x in ['breaking change', 'breaking:', 'break:']):
+                  return 'breaking'
+              if any(x in text for x in ['deprecat', 'obsolete', 'phase out']):
+                  return 'deprecated'
+              if any(x in text for x in ['remove', 'delete', 'drop', 'eliminate']):
+                  return 'removed'
+              # Correction: Check for 'added' keywords before 'fixed' keywords.
+              if any(x in text for x in ['add', 'new', 'create', 'implement', 'feat', 'feature']):
+                  return 'added'
+              if any(x in text for x in ['fix', 'resolve', 'correct', 'patch', 'bug', 'issue']):
+                  return 'fixed'
+              return 'changed'
+
+          def format_commit_entry(commit):
+              entry = f"- **{commit['subject']}** ({commit['date']} – {commit['author']})"
+              body = commit['body'].replace('\\n', '\n')
+              if body.strip():
+                  lines = [line.strip() for line in body.splitlines() if line.strip()]
+                  for line in lines:
+                      entry += f"\n  {line}"
+              return entry + "\n"
+
+          def parse_commits(lines):
+              commits = []
+              for line in lines:
+                  if not line: continue
+                  parts = line.split('|||')
+                  if len(parts) >= 5:
+                      subject, body, author, date, hash_id = map(str.strip, parts)
+                      commits.append({
+                          'subject': subject,
+                          'body': body,
+                          'author': author,
+                          'date': date,
+                          'hash': hash_id[:7]
+                      })
+              return commits
+
+          def build_changelog(commits_by_version):
+              sections = [
+                  ('security', 'Security'),
+                  ('breaking', 'Breaking Changes'),
+                  ('deprecated', 'Deprecated'),
+                  ('added', 'Added'),
+                  ('changed', 'Changed'),
+                  ('fixed', 'Fixed'),
+                  ('removed', 'Removed')
+              ]
+
+              lines = [
+                  "# Changelog",
+                  "",
+                  "All notable changes to this project will be documented in this file.",
+                  "",
+                  "The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),",
+                  "and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).",
+                  ""
+              ]
+
+              unreleased = parse_commits(commits_by_version['unreleased'])
+              if unreleased:
+                  lines.append("## [Unreleased]")
+                  lines.append("")
+                  categorized = defaultdict(list)
+                  for commit in unreleased:
+                      cat = categorize_commit(commit['subject'], commit['body'])
+                      categorized[cat].append(commit)
+
+                  for key, label in sections:
+                      if categorized[key]:
+                          lines.append(f"### {label}")
+                          for commit in categorized[key]:
+                              lines.append(format_commit_entry(commit))
+                          lines.append("")
+              else:
+                  lines.append("## [Unreleased]\n")
+                  lines.append("_No unreleased changes._\n")
+
+              for tag, info in commits_by_version['tagged'].items():
+                  commits = parse_commits(info['commits'])
+                  lines.append(f"## [{tag}] - {info['date']}\n")
+                  categorized = defaultdict(list)
+                  for commit in commits:
+                      cat = categorize_commit(commit['subject'], commit['body'])
+                      categorized[cat].append(commit)
+
+                  for key, label in sections:
+                      if categorized[key]:
+                          lines.append(f"### {label}")
+                          for commit in categorized[key]:
+                              lines.append(format_commit_entry(commit))
+                          lines.append("")
+
+              return "\n".join(lines)
+
+          try:
+              commit_data = get_commits_by_tag()
+              changelog = build_changelog(commit_data)
+              with open("CHANGELOG.md", "w", encoding="utf-8") as f:
+                  f.write(changelog)
+              print("Changelog generated.")
+          except Exception as e:
+              print(f"Error generating changelog: {e}")
+              sys.exit(1)
+          EOF
+
+      - name: Commit Updated Changelog
+        run: |
+          git config --local user.email "[email protected]"
+          git config --local user.name "GitHub Action"
+          git add CHANGELOG.md
+          if git diff --staged --quiet; then
+            echo "No changes to commit"
+          else
+            git commit -m "docs: update changelog [skip ci]"
+            git push
+          fi

README.md

@@ -1,2 +1,116 @@
+![TinyPascal](media/tinypascal.png)  
+[![Chat on Discord](https://img.shields.io/discord/754884471324672040?style=for-the-badge)](https://discord.gg/tPWjMwK)
+[![Follow on Bluesky](https://img.shields.io/badge/Bluesky-tinyBigGAMES-blue?style=for-the-badge&logo=bluesky)](https://bsky.app/profile/tinybiggames.com)
+
+> 🚧 **This repository is currently under construction.**
+>
+> TinyPascal is actively being developed and rapidly evolving. Some features mentioned in this documentation may not yet be fully implemented, and both APIs and internal structure are subject to change as we continue to improve and expand the library.
+>
+> Your contributions, feedback, and issue reports are highly valued and will help shape TinyPascal into the ultimate 2D game framework for Delphi!
+    
 # TinyPascal
-TinyPascal is a lightweight, embeddable Win64 Pascal compiler.
+  
+**TinyPascal** is a lightweight, embeddable Pascal compiler designed to compile Pascal source code directly into Win64 PE format in memory, with immediate execution support. It is built in Delphi, follows a modular architecture, and uses a case-sensitive, Unicode-aware variant of Pascal with UTF-8 strings and clean interop with the Windows API and C ABI.
+
+TinyPascal generates x64 machine code without external dependencies, making it ideal for embedding and runtime code generation. It supports writing to memory and will also support .exe, .dll, and .lib output using the same backend.  
+
+Inspired by the design philosophy of TinyCC, TinyPascal is written in Delphi and designed to be small, fast, and modular. It generates x64 machine code directly, with no external dependencies, making it ideal for embedding in other applications or for use in runtime code generation scenarios.
+
+## ✅ Key Features
+
+- **Memory-first Compilation**  
+  Compiles Pascal source directly to memory as a valid Win64 PE executable.
+
+- **Direct Execution**  
+  Supports executing compiled code in memory without writing to disk.
+
+- **Delphi-Compatible Core**  
+  Uses a modern, case-sensitive Pascal syntax with strong compatibility for Delphi features.
+
+- **Unicode by Design**  
+  All strings are UTF-8 internally, with runtime UTF-8 → UTF-16 conversion for Windows API compatibility.
+
+- **C ABI Interop**  
+  Clean interoperation with C libraries via well-defined basic types.
+
+- **Self-contained Runtime**  
+  Built-in x64 codegen and PE generation with no external toolchain required.
+
+## 🔧 Type System
+
+TinyPascal supports the following core types:
+
+- `Int` → signed 64-bit integer
+- `UInt` → unsigned 64-bit integer
+- `Float` → IEEE 754 double
+- `String` → UTF-8 encoded, ref-counted string
+- `PString` → null-terminated `PUTF8Char` for C interop
+
+## 🧱 Modular Architecture
+
+TinyPascal is built using a clean modular design. Units follow a consistent naming convention:
+
+- `TinyPascal.Lexer` — Lexical analyzer
+- `TinyPascal.Parser` — Syntax parsing and AST generation
+- `TinyPascal.CodeGen` — x64 code generation
+- `TinyPascal.PE` — Win64 PE format emitter
+- `TinyPascal.Runtime` — Core runtime helpers (e.g., UTF-8 to UTF-16 conversion)
+- `TinyPascal.Compiler` — Entry point and orchestration
+
+## 📜 Example
+
+```pascal
+program HelloWorld;
+begin
+  WriteLn('Hello, World! 🚀');
+end.
+```  
+  
+
+## 💬 Support & Resources
+
+- 🐞 **Report Issues:** [GitHub Issue Tracker](https://github.com/tinyBigGAMES/TinyPascal/issues)  
+- 💬 **Join the Community:** [Forum](https://github.com/tinyBigGAMES/TinyPascal/discussions) | [Discord](https://discord.gg/tPWjMwK)  
+- 📚 **Learn Delphi:** [Learn Delphi](https://learndelphi.org)  
+
+## 🤝 Contributing
+
+We welcome contributions to **TinyPascal**! 🚀  
+
+### 💡 Ways to Contribute:
+- 🐛 **Report Bugs** – Help improve `TinyPascal` by submitting issues.  
+- ✨ **Suggest Features** – Share ideas to enhance its functionality.  
+- 🔧 **Submit Pull Requests** – Improve the codebase and add features.  
+
+### 🏆 Contributors
+
+<a href="https://github.com/tinyBigGAMES/TinyPascal/graphs/contributors">
+  <img src="https://contrib.rocks/image?repo=tinyBigGAMES/TinyPascal&max=500&columns=20&anon=1" />
+</a>
+
+## 📜 License
+
+**TinyPascal** is distributed under the **BSD-3-Clause License**, allowing redistribution and modification in both source and binary forms. 
+See the [LICENSE](https://github.com/tinyBigGAMES/TinyPascal?tab=BSD-3-Clause-1-ov-file#BSD-3-Clause-1-ov-file) for details.
+
+## 💖 Support & Sponsorship
+
+Your support keeps **TinyPascal** evolving! If you find this library useful, please consider [sponsoring the project](https://github.com/sponsors/tinyBigGAMES). Every contribution helps drive future enhancements and innovations.
+
+### Other ways to support:
+- ⭐ **Star the repo** – Show your appreciation.  
+- 📢 **Share with your network** – Spread the word.  
+- 🐛 **Report bugs** – Help improve `TinyPascal`.  
+- 🔧 **Submit fixes** – Contribute by fixing issues.  
+- 💡 **Suggest features** – Help shape its future.  
+
+🚀 Every contribution makes a difference – thank you for being part of the journey!  
+  
+---
+
+**TinyPascal** — Pascal reborn for systems ⚙️, memory 🧠, and modern interop 🔗.
+
+<p align="center">
+  <img src="media/delphi.png" alt="Delphi">
+</p>
+<h5 align="center">Made with ❤️ in Delphi</h5>

examples/testbed/Testbed.dpr

@@ -0,0 +1,17 @@
+program Testbed;
+
+{$APPTYPE CONSOLE}
+
+{$R *.res}
+
+uses
+  System.SysUtils;
+
+begin
+  try
+    { TODO -oUser -cConsole Main : Insert code here }
+  except
+    on E: Exception do
+      Writeln(E.ClassName, ': ', E.Message);
+  end;
+end.