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

{minecraft_datapack_language-17.0.12 → minecraft_datapack_language-17.0.14}/MANIFEST.in

@@ -1,3 +1,4 @@
 recursive-include minecraft_datapack_language/_embedded/docs *
+recursive-include minecraft_datapack_language/_embedded/docs_site *
 recursive-include minecraft_datapack_language/completions *
 

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: minecraft-datapack-language
-Version: 17.0.12
+Version: 17.0.14
 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.14/docs/_data/version.yml

@@ -0,0 +1,3 @@
+current: "17.0.13"
+tag: "v17.0.13"
+updated_at: "2025-09-11T00:09:19Z"

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

@@ -194,13 +194,25 @@ Serve the docs quickly with the generated scripts:
 
 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:
+You can open the docs site in your browser via the CLI:
 
 ```bash
-mdl docs serve --dir docs --port 8000
+mdl docs            # opens Getting Started in your default browser
+mdl docs open       # same as above
+mdl docs serve --dir docs --port 8000   # optional: serve local docs (if you prefer)
 ```
 
-This starts a local web server for the `docs/` directory.
+When running `mdl new`, the output will list all generated files:
+
+```
+my_awesome_pack/
+├── README.md
+├── main.mdl
+├── docs/
+├── docs_site/          # present when packaged HTML is available
+├── serve_docs.sh
+└── serve_docs.ps1
+```
 
 ## Completion Command
 

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

@@ -0,0 +1,3 @@
+current: "17.0.12"
+tag: "v17.0.12"
+updated_at: "2025-09-11T00:04:18Z"

{minecraft_datapack_language-17.0.12 → minecraft_datapack_language-17.0.14}/minecraft_datapack_language/_version.py

@@ -28,7 +28,7 @@ version_tuple: VERSION_TUPLE
 commit_id: COMMIT_ID
 __commit_id__: COMMIT_ID
 
-__version__ = version = '17.0.12'
-__version_tuple__ = version_tuple = (17, 0, 12)
+__version__ = version = '17.0.14'
+__version_tuple__ = version_tuple = (17, 0, 14)
 
-__commit_id__ = commit_id = 'g2489ac9e3'
+__commit_id__ = commit_id = 'g0fcb14187'

{minecraft_datapack_language-17.0.12 → minecraft_datapack_language-17.0.14}/minecraft_datapack_language/cli.py

@@ -74,8 +74,9 @@ Examples:
     completion_sub.add_parser('doctor', help='Diagnose completion install status')
 
     # Docs command
-    docs_parser = subparsers.add_parser('docs', help='Docs utilities')
+    docs_parser = subparsers.add_parser('docs', help='Open or serve docs')
     docs_sub = docs_parser.add_subparsers(dest='docs_cmd', help='Docs subcommands')
+    docs_sub.add_parser('open', help='Open the MDL Getting Started docs in your browser')
     docs_serve = docs_sub.add_parser('serve', help='Serve project docs locally')
     docs_serve.add_argument('--port', type=int, default=8000, help='Port to serve on (default: 8000)')
     docs_serve.add_argument('--dir', default='docs', help='Docs directory to serve (default: docs)')
@@ -92,11 +93,11 @@ Examples:
         return 0
 
     if not args.command:
+        parser.print_help()
+        print("")
         print("Tip: Create a new project with: mdl new <project_name>")
         print("     After creating a project, you can serve local docs with: mdl docs serve --dir docs")
         print("     Or run the generated scripts: ./serve_docs.sh (bash) or ./serve_docs.ps1 (PowerShell)")
-        print("")
-        parser.print_help()
         return 0
     
     try:
@@ -352,6 +353,11 @@ A Minecraft datapack created with MDL (Minecraft Datapack Language).
     print(f"Created new MDL project: {project_dir}/")
     print(f"  - {mdl_file}")
     print(f"  - {readme_file}")
+    if (project_dir / 'docs').exists():
+        print("  - docs/ (local docs)")
+    if (project_dir / 'docs_site').exists():
+        print("  - docs_site/ (prebuilt HTML docs)")
+    print("  - serve_docs.sh, serve_docs.ps1")
     print(f"\nNext steps:")
     print(f"  1. cd {project_name}")
     print(f"  2. mdl build --mdl {project_name}.mdl -o dist")
@@ -366,6 +372,7 @@ def copy_packaged_docs_into(project_dir: Path) -> bool:
     Raises FileExistsError if destination exists.
     """
     embedded_root = importlib_resources_files("minecraft_datapack_language").joinpath("_embedded", "docs")
+    embedded_site = importlib_resources_files("minecraft_datapack_language").joinpath("_embedded", "docs_site")
     try:
         # Some importlib.resources implementations require as_file for files; for dirs, check existence
         if not Path(str(embedded_root)).exists():
@@ -373,10 +380,19 @@ def copy_packaged_docs_into(project_dir: Path) -> bool:
     except Exception:
         return False
 
+    # Copy raw docs
     dest = project_dir / "docs"
     if dest.exists():
         raise FileExistsError("docs directory already exists")
     shutil.copytree(str(embedded_root), str(dest))
+    # Copy prebuilt HTML site if available
+    try:
+        if Path(str(embedded_site)).exists():
+            site_dest = project_dir / "docs_site"
+            if not site_dest.exists():
+                shutil.copytree(str(embedded_site), str(site_dest))
+    except Exception:
+        pass
     return True
 
 
@@ -386,7 +402,10 @@ def create_docs_serve_scripts(project_dir: Path) -> None:
     bash_script.write_text("""#!/usr/bin/env bash
 set -e
 PORT=${PORT:-8000}
-DIR=${1:-docs}
+DIR=${1:-}
+if [ -z "$DIR" ]; then
+  if [ -d docs_site ]; then DIR=docs_site; else DIR=docs; fi
+fi
 if [ ! -d "$DIR" ]; then
   echo "Error: docs directory '$DIR' not found"; exit 1
 fi
@@ -406,8 +425,9 @@ fi
     ps1_script.write_text("""
 param(
   [int]$Port = 8000,
-  [string]$Dir = "docs"
+  [string]$Dir = ""
 )
+if (-not $Dir) { if (Test-Path 'docs_site') { $Dir = 'docs_site' } else { $Dir = 'docs' } }
 if (-not (Test-Path $Dir)) { Write-Host "Error: docs directory '$Dir' not found"; exit 1 }
 # Prefer Jekyll if available and Gemfile exists
 $gemfile = (Test-Path (Join-Path $Dir 'Gemfile')) -or (Test-Path 'Gemfile')
@@ -591,6 +611,16 @@ def _remove_line_from_file(path: Path, line: str) -> None:
 
 def docs_command(args) -> int:
     cmd = args.docs_cmd
+    # Default action: open website getting started page
+    if cmd is None or cmd == 'open':
+        try:
+            import webbrowser
+            webbrowser.open('https://www.mcmdl.com/docs/getting-started/')
+            print("Opened MDL Getting Started in your default browser.")
+            return 0
+        except Exception as e:
+            print(f"Failed to open browser: {e}")
+            return 1
     if cmd == 'serve':
         port = getattr(args, 'port', 8000)
         directory = getattr(args, 'dir', 'docs')

{minecraft_datapack_language-17.0.12 → minecraft_datapack_language-17.0.14}/minecraft_datapack_language/completions/mdl.bash

@@ -27,7 +27,7 @@ _mdl_complete() {
       COMPREPLY=( $(compgen -W "print install uninstall doctor" -- "$cur") )
       ;;
     docs)
-      COMPREPLY=( $(compgen -W "serve" -- "$cur") )
+      COMPREPLY=( $(compgen -W "open serve" -- "$cur") )
       ;;
   esac
 }

{minecraft_datapack_language-17.0.12 → minecraft_datapack_language-17.0.14}/minecraft_datapack_language/completions/mdl.fish

@@ -27,5 +27,6 @@ complete -c mdl -n "__fish_seen_subcommand_from completion" -a "uninstall" -d "U
 complete -c mdl -n "__fish_seen_subcommand_from completion" -a "doctor" -d "Diagnose setup"
 
 # docs subcommands
+complete -c mdl -n "__fish_seen_subcommand_from docs" -a "open" -d "Open docs website"
 complete -c mdl -n "__fish_seen_subcommand_from docs" -a "serve" -d "Serve docs locally"
 

{minecraft_datapack_language-17.0.12 → minecraft_datapack_language-17.0.14}/minecraft_datapack_language/completions/mdl.ps1

@@ -20,7 +20,7 @@ Register-ArgumentCompleter -Native -CommandName mdl -ScriptBlock {
             'print','install','uninstall','doctor' | Where-Object { $_ -like "$wordToComplete*" } | ForEach-Object { [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_) }
         }
         'docs' {
-            'serve' | Where-Object { $_ -like "$wordToComplete*" } | ForEach-Object { [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_) }
+            'open','serve' | Where-Object { $_ -like "$wordToComplete*" } | ForEach-Object { [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_) }
         }
     }
 }

{minecraft_datapack_language-17.0.12 → minecraft_datapack_language-17.0.14}/minecraft_datapack_language/completions/mdl.zsh

@@ -20,7 +20,7 @@ _mdl() {
       _values 'subcommands' 'print' 'install' 'uninstall' 'doctor'
       ;;
     docs)
-      _values 'subcommands' 'serve'
+      _values 'subcommands' 'open' 'serve'
       ;;
   esac
 }

{minecraft_datapack_language-17.0.12 → minecraft_datapack_language-17.0.14}/minecraft_datapack_language.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: minecraft-datapack-language
-Version: 17.0.12
+Version: 17.0.14
 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 → minecraft_datapack_language-17.0.14}/pyproject.toml

@@ -47,6 +47,7 @@ exclude = ["dist*", "build*", "scripts*", "tools*", "vscode-extension*", "tests*
 [tool.setuptools.package-data]
 "minecraft_datapack_language" = [
     "_embedded/docs/**/*",
+    "_embedded/docs_site/**/*",
     "completions/*",
 ]
 

{minecraft_datapack_language-17.0.12 → minecraft_datapack_language-17.0.14}/scripts/release.sh

@@ -68,6 +68,17 @@ rm -rf "$PKG_DOCS_DIR"
 mkdir -p "$PKG_DOCS_DIR"
 cp -R docs/* "$PKG_DOCS_DIR" || true
 
+# Build static HTML docs (if bundler/jekyll available)
+PKG_SITE_DIR="minecraft_datapack_language/_embedded/docs_site"
+rm -rf "$PKG_SITE_DIR"
+if command -v bundle >/dev/null 2>&1; then
+  echo "[+] Building static docs site with Jekyll"
+  (cd docs && bundle install >/dev/null 2>&1 || true)
+  bundle exec jekyll build -s docs -d "$PKG_SITE_DIR" || echo "[!] Jekyll build failed; shipping raw docs only"
+else
+  echo "[!] 'bundle' not found; skipping static docs site build"
+fi
+
 # [CLEAN] Clean old local artifacts so we never upload stale files
 rm -rf dist
 
@@ -75,6 +86,8 @@ rm -rf dist
 if command -v python >/dev/null 2>&1; then
   python -m pip install --upgrade pip >/dev/null 2>&1 || true
   python -m pip install build >/dev/null 2>&1 || true
+  # Avoid .post0 when building after tagging but with a dirty tree due to sync steps
+  export SETUPTOOLS_SCM_PRETEND_VERSION="${NEW_TAG#v}"
   python -m build || true
 fi
 

minecraft_datapack_language-17.0.12/docs/_data/version.yml

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

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

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