com.elestrago.unity.package-tools 2.0.10 → 2.1.0

package/CAHNGELOG.md

@@ -2,6 +2,22 @@
 
 ---
 
+## [2.1.0](https://gitlab.com/elestrago-pkg/package-tool/-/tags/2.1.0)
+
+### Added
+
+- Added `copyEntries` on `PackageManifestConfig` for staging external content into the project before export. See `Documentation~/manual.md`.
+
+---
+
+## [2.0.11](https://gitlab.com/elestrago-pkg/package-tool/-/tags/2.0.11)
+
+### Fixed
+
+- Test publish package using NPM trusted publisher
+
+---
+
 ## [2.0.10](https://gitlab.com/elestrago-pkg/package-tool/-/tags/2.0.10)
 
 ### Fixed

package/Documentation~/api.md

@@ -0,0 +1,502 @@
+<!-- generated by unity-package-docs; safe to regenerate -->
+
+# Package Tool — API Reference
+
+Comprehensive reference for every public/internal type and member. Generated from source; do not edit by hand.
+
+## Contents
+
+- [`PackageTool`](#packagetool) — Root namespace. Hosts the `PackageManifestConfig` ScriptableObject, the editor constants, the CI entry point, and the package-source `MenuItems` class.
+- [`PackageTool.Drawers`](#packagetooldrawers) — `PropertyDrawer` implementations for the nested `[Serializable]` types on `PackageManifestConfig` (`Author`, `Dependency`, `Sample`, `CopyEntry`).
+- [`PackageTool.Inspectors`](#packagetoolinspectors) — `UnityEditor.Editor` for `PackageManifestConfig` — renders the tab-aware IMGUI inspector that drives all export buttons.
+- [`PackageTool.Tools`](#packagetooltools) — Stateless helpers used during export and code generation: file copy, git probing, command-line parsing, code emission, GUI layout primitives, and the `PackageJsonModel` DTO.
+- [`PackageTool.Utils.PackageInitialize`](#packagetoolutilspackageinitialize) — The `Init Package` flow — `EditorWindow`, scaffold logic, and template strings for new packages.
+
+## `PackageTool`
+
+Root namespace. Hosts the `PackageManifestConfig` ScriptableObject, the editor constants, the CI entry point, and the package-source `MenuItems` class.
+
+### CIUtils
+
+```csharp
+public static class CIUtils
+```
+
+**Source:** `Assets/Package/PackageTool/Editor/CIUtils.cs:14`
+
+Continuous-integration API for package tools.
+
+**Members:**
+
+| Kind | Name | Signature | Summary |
+|------|------|-----------|---------|
+| method | `Generate` | `public static void Generate()` | Attempts to use zero or more `PackageManifestConfig` assets to generate legacy Unity packages and Unity source. |
+| method | `PrepareDll` | `public static void PrepareDll()` |  |
+
+### EditorConstants
+
+```csharp
+internal static class EditorConstants
+```
+
+**Source:** `Assets/Package/PackageTool/Editor/EditorConstants.cs:32`
+
+Internal constants and readonly fields for package tools usage.
+
+**Members:**
+
+| Kind | Name | Signature | Summary |
+|------|------|-----------|---------|
+| field | `DEFAULT_PACKAGE_VERSION` | `public const string DEFAULT_PACKAGE_VERSION` |  |
+| field | `DEFAULT_UNITY_VERSION` | `public const string DEFAULT_UNITY_VERSION` |  |
+| field | `PACKAGE_JSON_FILENAME` | `public const string PACKAGE_JSON_FILENAME` |  |
+| field | `WILDCARD_FILTER` | `public const string WILDCARD_FILTER` |  |
+| field | `ASSET_EXTENSION` | `public const string ASSET_EXTENSION` |  |
+| field | `META_EXTENSION` | `public const string META_EXTENSION` |  |
+| field | `META_FORMAT` | `public const string META_FORMAT` |  |
+| field | `GENERATED_FOLDER_NAME` | `public const string GENERATED_FOLDER_NAME` |  |
+| field | `UNITY_PACKAGE_NAME_FORMAT` | `public const string UNITY_PACKAGE_NAME_FORMAT` |  |
+| field | `EMPTY_SPACE` | `public const char EMPTY_SPACE` |  |
+| field | `UNDERSCORE` | `public const char UNDERSCORE` |  |
+| field | `GROUP_BOX` | `public const string GROUP_BOX` |  |
+| field | `EDITOR_FOLDER_ICON` | `public const string EDITOR_FOLDER_ICON` |  |
+| field | `EDITOR_FILE_ICON` | `public const string EDITOR_FILE_ICON` |  |
+| field | `PACKAGE_JSON_HEADER` | `public const string PACKAGE_JSON_HEADER` |  |
+| field | `PACKAGE_CONTENT_HEADER` | `public const string PACKAGE_CONTENT_HEADER` |  |
+| field | `PACKAGE_ACTIONS_HEADER` | `public const string PACKAGE_ACTIONS_HEADER` |  |
+| field | `SOURCE_PATHS_HEADER_LABEL` | `public const string SOURCE_PATHS_HEADER_LABEL` |  |
+| field | `SOURCE_PATH_ELEMENT_LABEL_FORMAT` | `public const string SOURCE_PATH_ELEMENT_LABEL_FORMAT` |  |
+| field | `IGNORE_PATHS_HEADER_LABEL` | `public const string IGNORE_PATHS_HEADER_LABEL` |  |
+| field | `KEYWORDS_HEADER_LABEL` | `public const string KEYWORDS_HEADER_LABEL` |  |
+| field | `KEYWORD_ELEMENT_LABEL_FORMAT` | `public const string KEYWORD_ELEMENT_LABEL_FORMAT` |  |
+| field | `DEPENDENCY_HEADER_LABEL` | `public const string DEPENDENCY_HEADER_LABEL` |  |
+| field | `DEPENDENCY_ELEMENT_LABEL_FORMAT` | `public const string DEPENDENCY_ELEMENT_LABEL_FORMAT` |  |
+| field | `GENERATE_VERSION_CONSTANTS_BUTTON_TEXT` | `public const string GENERATE_VERSION_CONSTANTS_BUTTON_TEXT` |  |
+| field | `UPDATE_PACKAGE_BUTTON_TEXT` | `public const string UPDATE_PACKAGE_BUTTON_TEXT` |  |
+| field | `EXPORT_LEGACY_PACKAGE_BUTTON_TEXT` | `public const string EXPORT_LEGACY_PACKAGE_BUTTON_TEXT` |  |
+| field | `SELECT_SOURCE_PATH_FILE_PICKER_TITLE` | `public const string SELECT_SOURCE_PATH_FILE_PICKER_TITLE` |  |
+| field | `SELECT_SOURCE_PATH_PICKER_FOLDER_TITLE` | `public const string SELECT_SOURCE_PATH_PICKER_FOLDER_TITLE` |  |
+| field | `SELECT_PACKAGE_EXPORT_PATH_PICKER_TITLE` | `public const string SELECT_PACKAGE_EXPORT_PATH_PICKER_TITLE` |  |
+| field | `SELECT_VERSION_CONSTANTS_PATH_PICKER_TITLE` | `public const string SELECT_VERSION_CONSTANTS_PATH_PICKER_TITLE` |  |
+| field | `SELECT_SAMPLES_PATH_FOLDER_TITLE` | `public const string SELECT_SAMPLES_PATH_FOLDER_TITLE` |  |
+| field | `PROGRESS_BAR_TITLE` | `public const string PROGRESS_BAR_TITLE` |  |
+| field | `PROGRESS_BAR_TITLE_LEGACY` | `public const string PROGRESS_BAR_TITLE_LEGACY` |  |
+| field | `COMPILING_PROGRESS_MESSAGE` | `public const string COMPILING_PROGRESS_MESSAGE` |  |
+| field | `FOLDER_PATH_PICKER_HEIGHT` | `public const float FOLDER_PATH_PICKER_HEIGHT` |  |
+| field | `FOLDER_PATH_PICKER_BUFFER` | `public const float FOLDER_PATH_PICKER_BUFFER` |  |
+| field | `SAMPLES_FOLDER_NAME` | `public const string SAMPLES_FOLDER_NAME` |  |
+| field | `SAMPLES_HEADER_LABEL` | `public const string SAMPLES_HEADER_LABEL` |  |
+| field | `SAMPLES_ELEMENT_LABEL_FORMAT` | `public const string SAMPLES_ELEMENT_LABEL_FORMAT` |  |
+| field | `COPY_ENTRIES_HEADER_LABEL` | `public const string COPY_ENTRIES_HEADER_LABEL` |  |
+| field | `COPY_ENTRY_ELEMENT_LABEL_FORMAT` | `public const string COPY_ENTRY_ELEMENT_LABEL_FORMAT` |  |
+| field | `COPY_ENTRY_SOURCE_LABEL` | `public const string COPY_ENTRY_SOURCE_LABEL` |  |
+| field | `COPY_ENTRY_DESTINATION_LABEL` | `public const string COPY_ENTRY_DESTINATION_LABEL` |  |
+| field | `SELECT_COPY_DESTINATION_FOLDER_PICKER_TITLE` | `public const string SELECT_COPY_DESTINATION_FOLDER_PICKER_TITLE` |  |
+
+### MenuItems
+
+```csharp
+internal static class MenuItems
+```
+
+**Source:** `Assets/Package/PackageTool/Editor/MenuItems.cs:6`
+
+### PackageManifestConfig
+
+```csharp
+public sealed class PackageManifestConfig : ScriptableObject
+```
+
+**Source:** `Assets/Package/PackageTool/Editor/PackageManifestConfig.cs:37`
+**Attributes:** `[CreateAssetMenu(fileName = "PackageManifestConfig", menuName = "JCMG/PackageTools/PackageManifestConfig")]`
+**Base:** `ScriptableObject`
+
+`PackageManifestConfig` is an asset config representing a Unity Package. It allows for defining the data used on the package json file, the locations of source files/assets that make up the package, and a destination for th package source to be distributed at.
+
+**Members:**
+
+| Kind | Name | Signature | Summary |
+|------|------|-----------|---------|
+| property | `Id` | `public string Id` | A unique id for this `PackageManifestConfig` instance. |
+| field | `homepage` | `public string homepage` |  |
+| field | `sourcePath` | `public string sourcePath` | A collection of paths to folders and files for the source for the package. |
+| field | `documentationPath` | `public string documentationPath` |  |
+| field | `readmePath` | `public string readmePath` |  |
+| field | `changelogPath` | `public string changelogPath` |  |
+| field | `licensePath` | `public string licensePath` |  |
+| field | `license` | `public string license` |  |
+| field | `packageIgnorePaths` | `public string[] packageIgnorePaths` | A collection of file/folder paths to exclude from the package. |
+| field | `packageDestinationPath` | `public string packageDestinationPath` | A path to the package source distribution contents. |
+| field | `legacyPackageDestinationPath` | `public string legacyPackageDestinationPath` | The relative path to the folder where the legacy package will be exported to. |
+| field | `packageName` | `public string packageName` | The fully-qualified package name. |
+| field | `displayName` | `public string displayName` | The package name as it appears in the Package Manager window. |
+| field | `packageVersion` | `public string packageVersion` | The semantic version of the package in MAJOR.MINOR.PATCH format. |
+| field | `unityVersion` | `public string unityVersion` | The version of Unity in semantic version format like 2018.1. |
+| field | `description` | `public string description` | A description of the package. |
+| field | `category` | `public string category` | The category the package belongs in. |
+| field | `author` | `public Author author` | The author of this package. |
+| field | `keywords` | `public string[] keywords` | A collection of keywords that describe the package. |
+| field | `dependencies` | `public Dependency[] dependencies` | A collection of packages that this package depends on. |
+| field | `samples` | `public Sample[] samples` |  |
+| field | `copyEntries` | `public CopyEntry[] copyEntries` | A collection of additional source-to-destination copy operations performed during export. |
+| field | `versionConstantsPath` | `public string versionConstantsPath` | A path to the where the VersionConstants.cs file should be created/updated |
+| field | `versionConstantsNamespace` | `public string versionConstantsNamespace` | The namespace the generated VersionConstants class will be in. If left blank, this will be the global namespace. |
+| method | `GenerateJson` | `public string GenerateJson()` | Returns a Json `string` representation. |
+
+### PackageManifestConfig.Author
+
+```csharp
+public sealed class Author
+```
+
+**Source:** `Assets/Package/PackageTool/Editor/PackageManifestConfig.cs:62`
+**Attributes:** `[Serializable]`
+
+Describes the author of this package.
+
+**Members:**
+
+| Kind | Name | Signature | Summary |
+|------|------|-----------|---------|
+| field | `name` | `public string name` |  |
+| field | `email` | `public string email` |  |
+| field | `url` | `public string url` |  |
+
+### PackageManifestConfig.CopyEntry
+
+```csharp
+public sealed class CopyEntry
+```
+
+**Source:** `Assets/Package/PackageTool/Editor/PackageManifestConfig.cs:92`
+**Attributes:** `[Serializable]`
+
+Describes a copy operation that mirrors a source file or folder into a destination folder inside the project. When the source is a folder, the same-named subfolder of the destination is replaced with the source folder's content. When the source is a file, the same-named file inside the destination folder is replaced. An empty or non-existent destination path falls back to the project root.
+
+**Members:**
+
+| Kind | Name | Signature | Summary |
+|------|------|-----------|---------|
+| field | `sourcePath` | `public string sourcePath` |  |
+| field | `destinationPath` | `public string destinationPath` |  |
+
+### PackageManifestConfig.Dependency
+
+```csharp
+public sealed class Dependency
+```
+
+**Source:** `Assets/Package/PackageTool/Editor/PackageManifestConfig.cs:43`
+**Attributes:** `[Serializable]`
+
+Describes a dependency that this package requires.
+
+**Members:**
+
+| Kind | Name | Signature | Summary |
+|------|------|-----------|---------|
+| field | `packageName` | `public string packageName` | The name of the dependent package. |
+| field | `packageVersion` | `public string packageVersion` | The semantic version of the dependent package in MAJOR.MINOR.PATCH format. |
+
+### PackageManifestConfig.Sample
+
+```csharp
+public sealed class Sample
+```
+
+**Source:** `Assets/Package/PackageTool/Editor/PackageManifestConfig.cs:73`
+**Attributes:** `[Serializable]`
+
+Describes the samples of this package.
+
+**Members:**
+
+| Kind | Name | Signature | Summary |
+|------|------|-----------|---------|
+| field | `sourcePath` | `public string sourcePath` |  |
+| field | `displayName` | `public string displayName` |  |
+| field | `description` | `public string description` |  |
+| field | `folderName` | `public string folderName` |  |
+
+## `PackageTool.Drawers`
+
+`PropertyDrawer` implementations for the nested `[Serializable]` types on `PackageManifestConfig` (`Author`, `Dependency`, `Sample`, `CopyEntry`).
+
+### AuthorPropertyDrawer
+
+```csharp
+internal sealed class AuthorPropertyDrawer : PropertyDrawer
+```
+
+**Source:** `Assets/Package/PackageTool/Editor/Drawers/AuthorPropertyDrawer.cs:34`
+**Attributes:** `[CustomPropertyDrawer(typeof(PackageManifestConfig.Author))]`
+**Base:** `PropertyDrawer`
+
+A property drawer for drawing `Author`
+
+**Members:**
+
+| Kind | Name | Signature | Summary |
+|------|------|-----------|---------|
+| method | `OnGUI` | `public override void OnGUI(Rect position, SerializedProperty property, GUIContent label)` |  |
+| method | `GetPropertyHeight` | `public override float GetPropertyHeight(SerializedProperty property, GUIContent label)` |  |
+
+### CopyEntryPropertyDrawer
+
+```csharp
+internal sealed class CopyEntryPropertyDrawer : PropertyDrawer
+```
+
+**Source:** `Assets/Package/PackageTool/Editor/Drawers/CopyEntryPropertyDrawer.cs:8`
+**Attributes:** `[CustomPropertyDrawer(typeof(PackageManifestConfig.CopyEntry))]`
+**Base:** `PropertyDrawer`
+
+**Members:**
+
+| Kind | Name | Signature | Summary |
+|------|------|-----------|---------|
+| method | `OnGUI` | `public override void OnGUI(Rect position, SerializedProperty property, GUIContent label)` |  |
+| method | `GetPropertyHeight` | `public override float GetPropertyHeight(SerializedProperty property, GUIContent label)` |  |
+
+### DependencyPropertyDrawer
+
+```csharp
+internal sealed class DependencyPropertyDrawer : PropertyDrawer
+```
+
+**Source:** `Assets/Package/PackageTool/Editor/Drawers/DependencyPropertyDrawer.cs:34`
+**Attributes:** `[CustomPropertyDrawer(typeof(PackageManifestConfig.Dependency))]`
+**Base:** `PropertyDrawer`
+
+A property drawer for drawing `Dependency`
+
+**Members:**
+
+| Kind | Name | Signature | Summary |
+|------|------|-----------|---------|
+| method | `OnGUI` | `public override void OnGUI(Rect position, SerializedProperty property, GUIContent label)` |  |
+| method | `GetPropertyHeight` | `public override float GetPropertyHeight(SerializedProperty property, GUIContent label)` |  |
+
+### SamplePropertyDrawer
+
+```csharp
+public class SamplePropertyDrawer : PropertyDrawer
+```
+
+**Source:** `Assets/Package/PackageTool/Editor/Drawers/SamplePropertyDrawer.cs:8`
+**Attributes:** `[CustomPropertyDrawer(typeof(PackageManifestConfig.Sample))]`
+**Base:** `PropertyDrawer`
+
+**Members:**
+
+| Kind | Name | Signature | Summary |
+|------|------|-----------|---------|
+| method | `OnGUI` | `public override void OnGUI(Rect position, SerializedProperty property, GUIContent label)` |  |
+| method | `GetPropertyHeight` | `public override float GetPropertyHeight(SerializedProperty property, GUIContent label)` |  |
+
+## `PackageTool.Inspectors`
+
+`UnityEditor.Editor` for `PackageManifestConfig` — renders the tab-aware IMGUI inspector that drives all export buttons.
+
+### PackageManifestConfigInspector
+
+```csharp
+internal sealed class PackageManifestConfigInspector : UnityEditor.Editor
+```
+
+**Source:** `Assets/Package/PackageTool/Editor/Inspectors/PackageManifestConfigInspector.cs:33`
+**Attributes:** `[CustomEditor(typeof(PackageManifestConfig))]`
+**Base:** `UnityEditor.Editor`
+
+**Members:**
+
+| Kind | Name | Signature | Summary |
+|------|------|-----------|---------|
+| method | `OnInspectorGUI` | `public override void OnInspectorGUI()` |  |
+
+## `PackageTool.Tools`
+
+Stateless helpers used during export and code generation: file copy, git probing, command-line parsing, code emission, GUI layout primitives, and the `PackageJsonModel` DTO.
+
+### CodeGenTools
+
+```csharp
+internal static class CodeGenTools
+```
+
+**Source:** `Assets/Package/PackageTool/Editor/Tools/CodeGenTools.cs:36`
+
+Helper methods for code-gen.
+
+**Members:**
+
+| Kind | Name | Signature | Summary |
+|------|------|-----------|---------|
+| method | `GenerateVersionConstants` | `public static void GenerateVersionConstants(PackageManifestConfig config)` |  |
+
+### CommandLineTools
+
+```csharp
+public static class CommandLineTools
+```
+
+**Source:** `Assets/Package/PackageTool/Editor/Tools/CommandLineTools.cs:33`
+
+Helper methods for command-line usage
+
+**Members:**
+
+| Kind | Name | Signature | Summary |
+|------|------|-----------|---------|
+| method | `GetKVPCommandLineArguments` | `public static Dictionary<string, object> GetKVPCommandLineArguments()` | Returns a more easily-searchable `Dictionary{TKey,TValue}` of command-line arguments. |
+
+### FileTools
+
+```csharp
+internal static class FileTools
+```
+
+**Source:** `Assets/Package/PackageTool/Editor/Tools/FileTools.cs:38`
+
+Helper methods for dealing with files/directories
+
+**Members:**
+
+| Kind | Name | Signature | Summary |
+|------|------|-----------|---------|
+| method | `ConvertToRelativePath` | `public static string ConvertToRelativePath(string fullFilePath, string referencePath)` | Converts `fullFilePath` into a relative file path from `referencePath`. |
+| method | `CreateOrUpdatePackageSource` | `public static void CreateOrUpdatePackageSource(PackageManifestConfig packageManifest)` | Creates or updates the existing package contents of `PackageManifestConfig` `packageManifest`. |
+| method | `CopyDocumentationToDirectory` | `public static void CopyDocumentationToDirectory(PackageManifestConfig packageManifest)` |  |
+| method | `CopyEntriesToProject` | `public static void CopyEntriesToProject(PackageManifestConfig packageManifest)` | Stages each configured `CopyEntry` into the project before the rest of the export runs. A folder source's content is merged directly into `destinationPath` (same-named files are overwritten, unrelated files in the destination are left alone). A file source overwrites destination/{filename}. A blank destination resolves to the project root; a non-blank destination that does not yet exist is created. Missing sources log a warning and are skipped. |
+| method | `IsFile` | `public static bool IsFile(string path)` | Returns true if the `path` is for a file, otherwise false. |
+| method | `GetAllFilesRecursively` | `internal static IEnumerable<string> GetAllFilesRecursively(string folderPath)` | Recursive find all files starting at root folder at path `folderPath` and return a list of absolute paths to those files. |
+
+### GUILayoutTools
+
+```csharp
+internal static class GUILayoutTools
+```
+
+**Source:** `Assets/Package/PackageTool/Editor/Tools/GUILayoutTools.cs:34`
+
+Helper methods for Unity Editor GUI.
+
+**Members:**
+
+| Kind | Name | Signature | Summary |
+|------|------|-----------|---------|
+| method | `DrawFolderPicker` | `public static void DrawFolderPicker(Rect rect, SerializedProperty property, string title)` | Draw a folder picker button in `Rect` `rect` that allows setting a relative folder path value on `SerializedProperty` `property`. |
+| method | `DrawSourceFolderPicker` | `public static void DrawSourceFolderPicker(Rect rect, SerializedProperty property, string title)` |  |
+| method | `DrawFilePicker` | `public static void DrawFilePicker(Rect rect, SerializedProperty property, string title)` | Draw a file picker button in `Rect` `rect` that allows setting a relative file path value on `SerializedProperty` `property`. |
+| method | `DrawFolderPickerLayout` | `public static void DrawFolderPickerLayout(SerializedProperty property, string title)` | Draw a folder picker button using `GUILayout` that allows setting a relative folder path value on `SerializedProperty` `property`. |
+| method | `DrawFilePickerLayout` | `public static void DrawFilePickerLayout(SerializedProperty property, string title)` |  |
+
+### GitTools
+
+```csharp
+public static class GitTools
+```
+
+**Source:** `Assets/Package/PackageTool/Editor/Tools/GitTools.cs:33`
+
+Helper methods for retrieving git information
+
+**Members:**
+
+| Kind | Name | Signature | Summary |
+|------|------|-----------|---------|
+| method | `Run` | `public static string Run(string cmd)` |  |
+| method | `GetBranch` | `public static string GetBranch()` |  |
+| method | `GetLongHeadHash` | `public static string GetLongHeadHash()` |  |
+
+### PackageJsonModel
+
+```csharp
+public class PackageJsonModel
+```
+
+**Source:** `Assets/Package/PackageTool/Editor/Tools/PackageJsonModel.cs:7`
+
+**Members:**
+
+| Kind | Name | Signature | Summary |
+|------|------|-----------|---------|
+| method | `CreateFromManifest` | `public static PackageJsonModel CreateFromManifest(PackageManifestConfig manifest)` |  |
+
+### PackageManifestTools
+
+```csharp
+internal static class PackageManifestTools
+```
+
+**Source:** `Assets/Package/PackageTool/Editor/Tools/PackageManifestTools.cs:34`
+
+Helper methods for the Package Manifest Tools
+
+**Members:**
+
+| Kind | Name | Signature | Summary |
+|------|------|-----------|---------|
+| method | `GenerateJson` | `public static string GenerateJson(PackageManifestConfig manifest)` | Returns a Json `string` representation of the `PackageManifestConfig` `manifest`. |
+| method | `GetAllConfigs` | `public static PackageManifestConfig[] GetAllConfigs()` | Retrieves all `PackageManifestConfig` instances in the project. |
+
+### UnityFileTools
+
+```csharp
+internal static class UnityFileTools
+```
+
+**Source:** `Assets/Package/PackageTool/Editor/Tools/UnityFileTools.cs:36`
+
+Helper methods for dealing with files/directories in the Unity Assets folder.
+
+**Members:**
+
+| Kind | Name | Signature | Summary |
+|------|------|-----------|---------|
+| method | `CompileLegacyPackage` | `public static void CompileLegacyPackage(PackageManifestConfig config)` | Gather all of the files/folders for the package and export them to the pre-defined location at `legacyPackageDestinationPath`. |
+
+## `PackageTool.Utils.PackageInitialize`
+
+The `Init Package` flow — `EditorWindow`, scaffold logic, and template strings for new packages.
+
+### PackageInitializeTemplates
+
+```csharp
+public static class PackageInitializeTemplates
+```
+
+**Source:** `Assets/Package/PackageTool/Editor/Utils/PackageInitialize/PackageInitializeTemplates.cs:5`
+
+### PackageInitializeUtil
+
+```csharp
+public static class PackageInitializeUtil
+```
+
+**Source:** `Assets/Package/PackageTool/Editor/Utils/PackageInitialize/PackageInitializeUtil.cs:7`
+
+**Members:**
+
+| Kind | Name | Signature | Summary |
+|------|------|-----------|---------|
+| field | `ASSETS_FOLDER_NAME` | `public const string ASSETS_FOLDER_NAME` |  |
+| field | `RELEASE_FOLDER_NAME` | `public const string RELEASE_FOLDER_NAME` |  |
+| method | `Init` | `public static void Init(string scope, PackageManifestConfig config)` |  |
+| method | `CreateFolderInProject` | `public static void CreateFolderInProject(string directoryPath)` |  |
+| method | `CreateFolderInAssets` | `public static void CreateFolderInAssets(string directoryPath)` |  |
+
+### PackageInitializeWindow
+
+```csharp
+public class PackageInitializeWindow : EditorWindow
+```
+
+**Source:** `Assets/Package/PackageTool/Editor/Utils/PackageInitialize/PackageInitializeWindow.cs:7`
+**Base:** `EditorWindow`
+
+**Members:**
+
+| Kind | Name | Signature | Summary |
+|------|------|-----------|---------|
+| method | `Open` | `public static void Open()` |  |

package/Documentation~/manual.md

@@ -0,0 +1,140 @@
+<!-- generated by unity-package-docs; safe to regenerate -->
+
+# Package Tool — Manual
+
+## Overview
+
+The Package Tool is an Editor-only utility for authoring and publishing Unity packages from inside a Unity project. The package's source files, samples, documentation, README, CHANGELOG, and `package.json` are all described by a single `PackageManifestConfig` ScriptableObject; invoking **Export Package Source** assembles the package layout under `packageDestinationPath` ready for publication.
+
+The same `PackageManifestConfig` drives an interactive Editor inspector and a CI batch-mode entry point. The editor inspector exposes per-section tabs (package metadata, content/export, actions) and reorderable lists for keywords, dependencies, samples, and copy entries; the CI side reads command-line key/value pairs and runs the same export pipeline without UI.
+
+Beyond export, the tool ships an **Init Package** scaffolder (`Tools/PackageTools/Init Package`) that lays down a `PackageManifestConfig.asset`, README/CHANGELOG/LICENSE, `Documentation~/`, `Samples~/`, and an Editor folder using the names you supply; a **VersionConstants.cs** generator that emits a `public const string VERSION = "…";` style file at a configurable path; a **PrepareDll** menu item that flips DLL plugin platform flags before export; and a `copyEntries` mechanism for staging external content (Claude skills, generated assets, vendored data) into project paths before the rest of the export runs.
+
+Package name: `com.elestrago.unity.package-tools`
+Package source: `Assets/Package/PackageTool`
+
+## Architecture
+
+```
+PackageTool
+├── Drawers
+├── Inspectors
+├── Tools
+└── Utils
+    └── PackageInitialize
+```
+
+`PackageTool` (root) holds the configuration ScriptableObject [`PackageManifestConfig`](api.md#packagemanifestconfig) at `Assets/Package/PackageTool/Editor/PackageManifestConfig.cs:37`, the user-facing string table [`EditorConstants`](api.md#editorconstants) at `Assets/Package/PackageTool/Editor/EditorConstants.cs:32`, the CI batch entry point [`CIUtils`](api.md#ciutils) at `Assets/Package/PackageTool/Editor/CIUtils.cs:14`, and [`MenuItems`](api.md#menuitems) at `Assets/Package/PackageTool/Editor/MenuItems.cs:6`.
+
+`PackageTool.Drawers` contains `PropertyDrawer` subclasses for the nested data types on `PackageManifestConfig`: [`AuthorPropertyDrawer`](api.md#authorpropertydrawer) (`Assets/Package/PackageTool/Editor/Drawers/AuthorPropertyDrawer.cs:34`), [`DependencyPropertyDrawer`](api.md#dependencypropertydrawer), [`SamplePropertyDrawer`](api.md#samplepropertydrawer), and [`CopyEntryPropertyDrawer`](api.md#copyentrypropertydrawer). All four are IMGUI drawers with manual `Rect` math.
+
+`PackageTool.Inspectors` has a single class, [`PackageManifestConfigInspector`](api.md#packagemanifestconfiginspector) at `Assets/Package/PackageTool/Editor/Inspectors/PackageManifestConfigInspector.cs:33` — a tab-based `UnityEditor.Editor` that drives every export button and renders the reorderable lists (keywords, dependencies, samples, copy entries).
+
+`PackageTool.Tools` is the helpers layer. [`FileTools`](api.md#filetools) owns the export pipeline (`CreateOrUpdatePackageSource`); [`CodeGenTools`](api.md#codegentools) emits `VersionConstants.cs`; [`PackageManifestTools`](api.md#packagemanifesttools) discovers configs and serializes `package.json`; [`GitTools`](api.md#gittools) probes branch/HEAD for the version token chain; [`CommandLineTools`](api.md#commandlinetools) parses CI key/value args; [`GUILayoutTools`](api.md#guilayouttools) provides reusable file/folder picker drawers; [`UnityFileTools`](api.md#unityfiletools) handles legacy `.unitypackage` compilation; and [`PackageJsonModel`](api.md#packagejsonmodel) is the JSON DTO with its `Author`/`Repository`/`Bugs`/`Sample` sub-models.
+
+`PackageTool.Utils.PackageInitialize` is the Init Package flow: [`PackageInitializeWindow`](api.md#packageinitializewindow) is the `EditorWindow`, [`PackageInitializeUtil`](api.md#packageinitializeutil) creates folders and the config asset, and [`PackageInitializeTemplates`](api.md#packageinitializetemplates) holds the README/CHANGELOG/LICENSE string templates.
+
+## Assemblies
+
+| Assembly | Root Namespace | Platforms | References |
+|----------|----------------|-----------|------------|
+| `Playdarium.PackageTool.Editor` | `—` | Editor | — |
+
+## Entry Points
+
+- `[MenuItem("Tools/PackageTools/PrepareDll")]` → `CIUtils.PrepareDll` at `Assets/Package/PackageTool/Editor/CIUtils.cs:197`. Maps to the **Tools/PackageTools/PrepareDll** entry in the Unity menu bar.
+- `[MenuItem("Tools/PackageTools/Init Package")]` → `PackageInitializeWindow.Open` (declared inline in `Assets/Package/PackageTool/Editor/MenuItems.cs`); opens the scaffolder window.
+- `[CreateAssetMenu(menuName = "JCMG/PackageTools/PackageManifestConfig")]` → `PackageManifestConfig` at `Assets/Package/PackageTool/Editor/PackageManifestConfig.cs:37`. Available under **Assets > Create > JCMG/PackageTools/PackageManifestConfig**.
+- `CIUtils.Generate` at `Assets/Package/PackageTool/Editor/CIUtils.cs:65` — batch-mode entry point invoked via `unity -batchmode -executeMethod PackageTool.CIUtils.Generate <key>=<value>`. Reads keys parsed by [`CommandLineTools.GetKVPCommandLineArguments`](api.md#commandlinetools); see the **CI command-line keys** section in `extension-points` for the supported keys.
+- `CIUtils.PrepareDll` at `Assets/Package/PackageTool/Editor/CIUtils.cs:197` — exits the Editor when run under CI (`CI` env var set); fixes DLL plugin platform flags first. Also available as `Tools/PackageTools/PrepareDll` for interactive use.
+- `PackageInitializeWindow.Open` at `Assets/Package/PackageTool/Editor/Utils/PackageInitialize/PackageInitializeWindow.cs:7` — opens the scaffolder via `Tools/PackageTools/Init Package`.
+
+Inspector buttons on `PackageManifestConfig` assets (drawn by `PackageManifestConfigInspector.OnInspectorGUI`):
+
+- **Generate VersionConstants.cs** → `CodeGenTools.GenerateVersionConstants(config)` at `Assets/Package/PackageTool/Editor/Tools/CodeGenTools.cs:36`.
+- **Export Package Source** → `FileTools.CreateOrUpdatePackageSource(config)` at `Assets/Package/PackageTool/Editor/Tools/FileTools.cs:59`.
+- **Export as Legacy Package** → `UnityFileTools.CompileLegacyPackage(config)` at `Assets/Package/PackageTool/Editor/Tools/UnityFileTools.cs:36`.
+
+## Data Model
+
+### [`PackageManifestConfig`](api.md#packagemanifestconfig) — `ScriptableObject`
+
+Defined at `Assets/Package/PackageTool/Editor/PackageManifestConfig.cs:37`. Created via **Assets > Create > JCMG/PackageTools/PackageManifestConfig**. Public fields, by section:
+
+- **Package json metadata:** `homepage`, `packageName`, `displayName`, `packageVersion`, `unityVersion`, `description`, `category`, `license`, `keywords` (`string[]`), `author` (`Author`), `dependencies` (`Dependency[]`).
+- **Package content paths:** `sourcePath`, `documentationPath` (default `Documentation~`), `readmePath` (default `README.md`), `changelogPath` (default `CHANGELOG.md`), `licensePath` (default `LICENSE`), `packageIgnorePaths` (`string[]`).
+- **Export targets:** `packageDestinationPath`, `legacyPackageDestinationPath`.
+- **Staging:** `samples` ([`Sample[]`](api.md#packagemanifestconfigsample)), `copyEntries` ([`CopyEntry[]`](api.md#packagemanifestconfigcopyentry)).
+- **Code generation:** `versionConstantsPath`, `versionConstantsNamespace`.
+- **Hidden:** `_id` (Guid; surfaced via `Id` property; used by `CIUtils.Generate id=<guid>` filtering).
+
+Nested `[Serializable]` types, each with a `PropertyDrawer` in `PackageTool.Drawers`:
+
+- [`Author`](api.md#packagemanifestconfigauthor) — `name`, `email`, `url` (`string`).
+- [`Dependency`](api.md#packagemanifestconfigdependency) — `packageName`, `packageVersion` (`string`); `IsEmpty()` is true when either is blank.
+- [`Sample`](api.md#packagemanifestconfigsample) — `sourcePath`, `displayName`, `description`, `folderName` (`string`); `IsEmpty()` is true when any of `displayName`/`sourcePath`/`folderName` is blank. Resulting on-disk path is `{packageDestinationPath}/Samples~/{folderName}`.
+- [`CopyEntry`](api.md#packagemanifestconfigcopyentry) — `sourcePath`, `destinationPath` (`string`); `IsEmpty()` is true when `sourcePath` is blank. See **Copy Entries staging** in the next section.
+
+### Export pipeline
+
+`FileTools.CreateOrUpdatePackageSource(config)` at `Assets/Package/PackageTool/Editor/Tools/FileTools.cs:59` runs the steps below in order:
+
+1. Write `package.json` to `Assets/PackageManifest/Generated/<id>/package.json` (Unity needs a meta file to copy the meta downstream).
+2. Wipe and recreate `packageDestinationPath` (e.g. `Release/`).
+3. Copy `package.json` and its meta into `packageDestinationPath`.
+4. **`CopyEntriesToProject(config)`** — stage external content into the project; see below.
+5. **`CopyDocumentationToDirectory(config)`** — copy `readmePath`, `changelogPath`, `licensePath` into `sourcePath`; rebuild `sourcePath/Documentation~/` from `documentationPath`.
+6. **`RecursivelyCopyDirectoriesAndFiles(config, sourcePath, packageDestinationPath)`** — copy the package source tree, honoring `packageIgnorePaths`.
+7. **`CopySamplesToDirectory(config)`** — wipe `packageDestinationPath/Samples~/` and copy each [`Sample`](api.md#packagemanifestconfigsample)'s `sourcePath` to `Samples~/{folderName}`, skipping `.meta` files.
+
+### Copy Entries staging
+
+`copyEntries` is a `PackageManifestConfig` field added in 2.0.12. Each [`CopyEntry`](api.md#packagemanifestconfigcopyentry) names a source path and a destination folder; entries run **first** in the export pipeline (step 4 above) so downstream steps — including the recursive source copy and the `CopySamplesToDirectory` step — can pick up the staged content and ship it into `packageDestinationPath`.
+
+**Folder source.** The folder's *content* is merged directly into `destinationPath` (no `destinationPath/{sourceName}` wrapper). Same-named files are overwritten via `File.Copy(..., overwrite: true)`; unrelated files already in the destination are left in place. This is the merge semantics needed to chain into a `Sample` whose `sourcePath` is the same folder.
+
+**File source.** `destinationPath/{filename}` is overwritten.
+
+**Destination path resolution.**
+
+- Blank `destinationPath` → `EditorConstants.ProjectPath` (the repo root).
+- Non-blank `destinationPath` is resolved via `Path.GetFullPath` (so relative paths are cwd-relative — Unity Editor cwd is the project root) and **created on demand** if it doesn't yet exist.
+- A missing **source** path logs `[Package Tools] Copy entry source [...] does not exist, skipping.` and continues with the next entry.
+
+**Chained-with-Sample workflow.** A common shape: define a `Sample` whose `sourcePath` is `Assets/Samples~/<Name>` and a `CopyEntry` whose `destinationPath` is the same folder. The CopyEntry stages external content into `Assets/Samples~/<Name>`, then `CopySamplesToDirectory` ships that content into `<packageDestinationPath>/Samples~/<folderName>`. Because `~`-suffixed folders are ignored by Unity's asset importer, the staged Assets-side copy does not pollute the project import.
+
+## Editor UI Approach
+
+IMGUI throughout — no UI Toolkit. There are no `.uxml` or `.uss` files in the package. UI is split into:
+
+- An `EditorWindow` with `OnGUI`: [`PackageInitializeWindow`](api.md#packageinitializewindow) at `Assets/Package/PackageTool/Editor/Utils/PackageInitialize/PackageInitializeWindow.cs:7`.
+- A `UnityEditor.Editor` with `OnInspectorGUI`: [`PackageManifestConfigInspector`](api.md#packagemanifestconfiginspector) at `Assets/Package/PackageTool/Editor/Inspectors/PackageManifestConfigInspector.cs:33` — uses `EditorGUILayout`, `EditorGUI.ChangeCheckScope`, and `ReorderableList` for keywords, dependencies, samples, copy entries.
+- Four `PropertyDrawer`s with `OnGUI(Rect, ...)` and manual rect math in `PackageTool.Drawers` (one per `[Serializable]` nested type on `PackageManifestConfig`).
+- Reusable IMGUI primitives in [`GUILayoutTools`](api.md#guilayouttools) — `DrawFilePicker`, `DrawFolderPicker`, plus `*Layout` variants. Reach for these for any path-input UI instead of rolling your own picker.
+
+## Extension Points
+
+### CI command-line keys
+
+`CIUtils.Generate` reads keys parsed by [`CommandLineTools.GetKVPCommandLineArguments`](api.md#commandlinetools). Keys are case-insensitive (lowercased on parse) and values are passed as `<key>=<value>` pairs after `-executeMethod PackageTool.CIUtils.Generate`:
+
+- `id=<guid>[,<guid>...]` — restrict to specific `PackageManifestConfig._id`s. Omit to process all configs found by `PackageManifestTools.GetAllConfigs`.
+- `version=<semver>` — overrides `packageVersion` on every processed config (and marks the asset dirty).
+- `preview=<bool>` — parsed but not currently applied.
+- `generateversionconstants=<bool>` — when true, runs `CodeGenTools.GenerateVersionConstants` before export.
+
+To add a new key, edit `Assets/Package/PackageTool/Editor/CIUtils.cs` (constants block at lines 17–20, parsing pattern in `Generate()` lines 91–113); do **not** touch `CommandLineTools.cs` — its parsing already handles arbitrary keys.
+
+### VersionConstants template tokens
+
+`CodeGenTools.GenerateVersionConstants(config)` substitutes a `${token}` set into the embedded `TEMPLATE` / `GLOBAL_TEMPLATE` strings (chain at `Assets/Package/PackageTool/Editor/Tools/CodeGenTools.cs:131`) using values from the config, `DateTime`, and [`GitTools`](api.md#gittools). Adding a new token is a two-edit change: append the template line and add a `.Replace("${token}", value)` call.
+
+### Init Package fields
+
+`PackageInitializeWindow` lays down a `PackageManifestConfig.asset`, README, CHANGELOG, LICENSE, and `Documentation~/` / `Samples~/` folders from a flat set of `DrawTextField` inputs at `Assets/Package/PackageTool/Editor/Utils/PackageInitialize/PackageInitializeWindow.cs:32`. The scaffold logic and string templates live in [`PackageInitializeUtil`](api.md#packageinitializeutil) and [`PackageInitializeTemplates`](api.md#packageinitializetemplates); changes that affect generated content must thread through both.
+
+### Custom drawers, menu items, helpers
+
+- New `PropertyDrawer`: add `Assets/Package/PackageTool/Editor/Drawers/{Type}PropertyDrawer.cs`, mark `internal sealed class : PropertyDrawer`, override `OnGUI(Rect, ...)` + `GetPropertyHeight`.
+- New `MenuItem`: add to `Editor/MenuItems.cs` (or alongside the class that owns the action, as `CIUtils.PrepareDll` does).
+- New helper: add `Editor/Tools/{Name}.cs`, mark `internal static class`, namespace `PackageTool.Tools`. Mirror [`FileTools`](api.md#filetools) or [`GitTools`](api.md#gittools) for shape.