minecraft-datapack-language 17.0.10__tar.gz → 17.0.12__tar.gz

{minecraft_datapack_language-17.0.10 → minecraft_datapack_language-17.0.12}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: minecraft-datapack-language
-Version: 17.0.10
+Version: 17.0.12
 Summary: Compile MDL language with explicit scoping into a Minecraft datapack (1.21+ ready). Features variables, control flow, error handling, and VS Code extension.
 Project-URL: Homepage, https://www.mcmdl.com
 Project-URL: Documentation, https://www.mcmdl.com/docs

minecraft_datapack_language-17.0.12/docs/_data/version.yml

@@ -0,0 +1,3 @@
+current: "17.0.11"
+tag: "v17.0.11"
+updated_at: "2025-09-11T00:02:50Z"

{minecraft_datapack_language-17.0.10 → minecraft_datapack_language-17.0.12}/docs/_docs/cli-reference.md

@@ -124,16 +124,24 @@ mdl new adventure_map
 mdl new projects/survival_plus
 ```
 
-**What it creates:**
-The new command generates a minimal project structure with:
+**What it creates (by default):**
+The new command generates a project structure with:
 - `README.md` - Quick start with build instructions
 - `main.mdl` - Hello world (pack, namespace, simple function, on_load)
+- `docs/` - A literal copy of the MDL documentation for offline/local browsing
+- `serve_docs.sh` and `serve_docs.ps1` - Convenience scripts to serve docs locally
 
-**Generated project structure:**
+**Generated project structure (default):**
 ```
 my_awesome_pack/
 ├── README.md
-└── main.mdl
+├── main.mdl
+├── docs/
+│   ├── index.md
+│   ├── _config.yml
+│   └── ...
+├── serve_docs.sh
+└── serve_docs.ps1
 ```
 
 **Template content includes:**
@@ -167,6 +175,46 @@ my_awesome_pack/
 | Option | Description | Example |
 |--------|-------------|---------|
 | `<project_name>` | Name of the new project to create | `mdl new my_pack` |
+| `--pack-name <name>` | Override datapack name used in `pack.mcmeta` | `--pack-name Adventure` |
+| `--pack-format <num>` | Pack format number (defaults to modern value) | `--pack-format 82` |
+| `--output <dir>` | Directory to create the project in | `--output ./projects` |
+| `--exclude-local-docs` | Do not copy the MDL docs into `docs/` | `--exclude-local-docs` |
+
+By default, `mdl new` includes a full `docs/` folder in your project so new users have local docs offline. Use `--exclude-local-docs` to skip this step.
+
+Serve the docs quickly with the generated scripts:
+
+```bash
+# Bash/Git Bash
+./serve_docs.sh
+
+# PowerShell
+./serve_docs.ps1
+```
+
+Both scripts prefer Jekyll (if `bundle` and a `Gemfile` are present), otherwise they fall back to a simple Python web server.
+
+You can also serve docs via the CLI:
+
+```bash
+mdl docs serve --dir docs --port 8000
+```
+
+This starts a local web server for the `docs/` directory.
+
+## Completion Command
+
+Install shell autocompletion so you can type `mdl bui<Tab>` and get `build`:
+
+```bash
+mdl completion install           # auto-detects your shell
+mdl completion install bash      # explicit shell
+mdl completion uninstall zsh     # remove
+mdl completion print fish        # print script for manual use/CI
+mdl completion doctor            # basic diagnostics
+```
+
+Supported shells: Bash (incl. Git Bash), Zsh, Fish, and PowerShell.
 
 ## Error Handling
 

minecraft_datapack_language-17.0.12/minecraft_datapack_language/_embedded/docs/404.html

@@ -0,0 +1,42 @@
+---
+layout: default
+title: Page Not Found
+---
+
+<div class="page-content">
+  <div class="wrapper">
+    <div class="error-page">
+      <h1>404 - Page Not Found</h1>
+      <p>The page you're looking for doesn't exist.</p>
+      <p><a href="{{ '/' | relative_url }}">Return to the homepage</a></p>
+    </div>
+  </div>
+</div>
+
+<style>
+.error-page {
+  text-align: center;
+  padding: 4rem 2rem;
+}
+
+.error-page h1 {
+  font-size: 3rem;
+  color: #24292e;
+  margin-bottom: 1rem;
+}
+
+.error-page p {
+  font-size: 1.2rem;
+  color: #586069;
+  margin-bottom: 2rem;
+}
+
+.error-page a {
+  color: #0366d6;
+  text-decoration: none;
+}
+
+.error-page a:hover {
+  text-decoration: underline;
+}
+</style>

minecraft_datapack_language-17.0.12/minecraft_datapack_language/_embedded/docs/Gemfile

@@ -0,0 +1,26 @@
+source "https://rubygems.org"
+
+gem "jekyll", "~> 4.3.0"
+gem "jekyll-theme-cayman", "~> 0.2.0"
+gem "jekyll-feed", "~> 0.17.0"
+gem "jekyll-seo-tag", "~> 2.8.0"
+gem "jekyll-sitemap", "~> 1.4.0"
+gem "jekyll-github-metadata", "~> 2.16.0"
+
+group :jekyll_plugins do
+  # Plugins are already specified above with version constraints
+end
+
+# Windows and JRuby does not include zoneinfo files, so bundle the tzinfo-data gem
+# and associated library.
+platforms :mingw, :x64_mingw, :mswin, :jruby do
+  gem "tzinfo", ">= 1", "< 3"
+  gem "tzinfo-data"
+end
+
+# Performance-booster for watching directories on Windows
+gem "wdm", "~> 0.1.1", :platforms => [:mingw, :x64_mingw, :mswin]
+
+# Lock `http_parser.rb` gem to `v0.6.x` on JRuby builds since newer versions of the gem
+# do not have a Java counterpart.
+gem "http_parser.rb", "~> 0.6.0", :platforms => [:jruby]

minecraft_datapack_language-17.0.12/minecraft_datapack_language/_embedded/docs/README.md

@@ -0,0 +1,84 @@
+# MDL Documentation
+
+This directory contains the documentation website for Minecraft Datapack Language (MDL).
+
+## Local Development
+
+### Prerequisites
+
+- Ruby 3.0 or higher
+- Bundler
+
+### Setup
+
+1. Install dependencies:
+   ```bash
+   bundle install
+   ```
+
+2. Start the development server:
+   ```bash
+   bundle exec jekyll serve
+   ```
+
+3. Open your browser to `http://localhost:4000`
+
+### Building for Production
+
+```bash
+bundle exec jekyll build
+```
+
+The built site will be in the `_site` directory.
+
+## Structure
+
+- `_config.yml` - Jekyll configuration
+- `_docs/` - Documentation pages
+- `_layouts/` - Page layouts
+- `_includes/` - Reusable components
+- `index.md` - Homepage
+- `404.html` - Error page
+
+## Adding Content
+
+### New Documentation Pages
+
+1. Create a new `.md` file in `_docs/`
+2. Add front matter with title and permalink
+3. Write your content in Markdown
+4. Add the page to navigation in `_config.yml`
+
+### Example
+
+```markdown
+---
+layout: page
+title: My New Page
+permalink: /docs/my-new-page/
+---
+
+# My New Page
+
+Content goes here...
+```
+
+## Deployment
+
+The site is automatically deployed to GitHub Pages when changes are pushed to the main branch. The deployment is handled by the GitHub Actions workflow in `.github/workflows/docs.yml`.
+
+## Customization
+
+### Styling
+
+Custom styles are in `_includes/head-custom.html`. The site uses the Cayman theme with custom modifications.
+
+### Navigation
+
+Navigation is configured in `_config.yml` under the `nav` section.
+
+### Layouts
+
+Custom layouts are in `_layouts/`. The main layouts are:
+- `default.html` - Base layout
+- `page.html` - Documentation page layout

minecraft_datapack_language-17.0.12/minecraft_datapack_language/_embedded/docs/_config.yml

@@ -0,0 +1,74 @@
+title: Minecraft Datapack Language (MDL) v12
+description: A powerful compiler that lets you write Minecraft datapacks in a modern JavaScript-style language (.mdl) or via clean Python bindings
+url: "https://www.mcmdl.com"
+github_username: aaron777collins
+github_repo: MinecraftDatapackLanguage
+
+# Build settings
+markdown: kramdown
+highlighter: rouge
+permalink: pretty
+
+# Collections
+collections:
+  docs:
+    output: true
+    permalink: /:collection/:name/
+
+# Defaults
+defaults:
+  - scope:
+      path: ""
+      type: "docs"
+    values:
+      layout: "page"
+  - scope:
+      path: ""
+      type: "posts"
+    values:
+      layout: "post"
+
+# Plugins
+plugins:
+  - jekyll-feed
+  - jekyll-seo-tag
+  - jekyll-sitemap
+  - jekyll-github-metadata
+
+# GitHub metadata
+github:
+  is_project_page: true
+  show_downloads: false
+
+# Exclude from processing
+exclude:
+  - Gemfile
+  - Gemfile.lock
+  - node_modules
+  - vendor/bundle/
+  - vendor/cache/
+  - vendor/gems/
+  - vendor/ruby/
+
+# Theme settings
+theme: jekyll-theme-cayman
+show_downloads: false
+
+# Navigation - Clean, organized structure
+nav:
+  - title: Downloads
+    url: /downloads/
+  - title: Getting Started
+    url: /docs/getting-started/
+  - title: Examples
+    url: /docs/examples/
+  - title: Language Reference
+    url: /docs/language-reference/
+  - title: Multi-file Projects
+    url: /docs/multi-file-projects/
+  - title: CLI Reference
+    url: /docs/cli-reference/
+  - title: Python Bindings
+    url: /docs/python-api/
+  - title: VS Code Extension
+    url: /docs/vscode-extension/

minecraft_datapack_language-17.0.12/minecraft_datapack_language/_embedded/docs/_data/version.yml

@@ -0,0 +1,3 @@
+current: "17.0.10"
+tag: "v17.0.10"
+updated_at: "2025-09-10T23:56:34Z"