# Changelog Notable changes to the `deukpack` npm package by release. **한국어:** [CHANGELOG.ko.md](CHANGELOG.ko.md) ## [1.9.0] — 2026-04-04 ### Official Python Support - **Python Binary Engine Added**: Officially supports Python 3.6+ environments. The new engine integrates optimization strategies modeled after robust C-API architectures (like `ORJSON`) to minimize serialization bottlenecks. ### Benchmark Industry Standardization - **BMT-Level Framework Integration**: To avoid microbenchmark fallacies such as cache spikes and warmup noise associated with legacy custom timers, the benchmarking pipelines have been completely overhauled using industry-standard tools including `BenchmarkDotNet`, `mitata`, and `pytest-benchmark`. - **Complex Real-World Test Models**: Scaled the measurement baselines by discarding simple 1D models in favor of the **ComplexRoundtripModel**—a comprehensive test suite invoking multi-dimensional hash maps and deep nested trees to ensure transparent, enterprise-level performance metrics. ## [1.8.1] — 2026-04-03 ### CI/CD & Pipeline Hotfix - **Legacy Dependency Cleanup**: Resolved build failures caused by missing `sample.thrift` references in CI scripts `ci.yml` and testing examples. Fully migrated all validation suites to use native `sample.deuk`. - **Elixir Dialyzer Types**: Suppressed specific `Jason` compiler references using `apply` reflection, resolving "module not available" warnings in missing dependency matrices. - **C# Non-nullable Warnings**: Enforced explicit null-forgiving operators (`!`) during collection iteration in generated code to resolve `CS8603` warnings in strict projects. ## [1.8.0] — 2026-04-03 ### Core: Unified Serialization API & Static Overloads - **API Purity (C# / Java)**: Resolved `CS0111` compiler collisions by fully standardizing the `Pack` / `Unpack` API across all languages using Static Overloads. Removed legacy instance-level serialization methods to enforce universal API parity. - **Zero-Allocation Architecture Hardening**: Standardized the `Unpack(obj, bin)` in-place update interface across C# and C++ to explicitly support memory-pooling optimization in high-frequency network Hotpaths (Unity / Unreal), completely eliminating GC spikes and OS Native Heap lock contention. - **JavaScript V8 Optimization**: Formally documented and recommended the Factory `unpack(bin)` pattern specifically for Node.js / V8 environments to preserve Hidden Classes/Inline Caching (IC) and exploit the nursery GC for short-lived packet objects. ### Security & Static Analysis - **Elixir Dialyzer Compliance**: Injected robust `@spec` typespec annotations across all generated Elixir `pack` and `unpack` serialization functions. Enforces strict static typing (`@type t()`, `binary()`) to guarantee zero "no_return" or type-mismatch warnings during CI/CD `mix dialyzer` runs. - **Dialyzer Automation**: Scaffolded an automated Dialyzer verification test script (`scripts/test_elixir_dialyzer.js`) in the DeukPack pipeline to continually assert Elixir type-safety. ## [1.7.6] — 2026-04-03 ### Documentation - **C# Snippet Syntax**: Corrected the "At a glance" Quick Start snippet across all READMEs to natively compile with actual out-of-the-box `DeukPackCodec` methods, removing the pseudo-code ambiguity. ## [1.7.5] — 2026-04-03 ### Hotfix - **README Formatting**: Fixed empty markdown table headers (`| | |`) which caused the NPM registry markdown-it parser to crash and drop the entire README. ## [1.7.4] — 2026-04-03 ### Hotfix - **README Formatting**: Completely removed blockquote markdown syntax from CAUTION/TIP sections to ensure 100% compatibility with NPM registry renderer. ## [1.7.3] — 2026-04-03 ### Hotfix - **README Formatting**: Fixed broken rendering of GitHub Alerts (`> [!TIP]`, `> [!CAUTION]`) in npm registry. ## [1.7.2] — 2026-04-03 ### Hotfix & Documentation - **Elixir CI Fix**: Resolved a runtime `CompileError` occurring during `ElixirBridge.exs` execution by replacing compile-time macros (`%Struct{}`) with dynamic `struct()` bindings, ensuring resilience over multi-version tests. - **Markdown Rendering Fix**: Addressed a formatting ambiguity between the `~` subscript tag and bold (`**`) syntax in MkDocs environments, correctly rendering benchmark matrices on `deukpack.app`. - **Support Matrix Synchronization**: Updated the Protobuf compatibility indicator to "supported" (`✅`) for C#, C++, and TypeScript across all capability matrices to align with the core status. - **Security Posture Documentation**: Officially appended the robust OOM Defense methodology and DDoS Fuzzer strategies under a new "Security & Trust" segment across all READMEs. ## [1.7.1] — 2026-04-03 ### Documentation & Benchmarks - **Elixir Official Benchmark Report**: Added the official speed (~31ms) and memory efficiency (0 MB / Native Pattern Match) results for 10,000-row stress decoding into the main README benchmark matrix. - **Support Matrix Update**: Promoted Elixir capabilities (IDL Core, protocols, inheritance) from pilot (`🚧`) to fully supported (`✅`) reflecting the v1.7.0 delivery. ## [1.7.0] — 2026-04-03 ### Core: Elixir Support & Unified Protocol Security Shield - **Elixir (Erlang BEAM) Runtime Engine**: Delivered complete native protocol support for Elixir, utilizing Erlang's high-performance binary pattern matching (`<>`). Fully verified through the cross-language matrix test pipeline. - **Universal OOM Defense (Protocol Security)**: Hardened all five backend engines (JS, C#, C++, Java, Elixir) against network-layer malicious payloads (DDoS / Memory Bombs). Enforced strict fail-fast `MAX_SAFE_LENGTH` (10MB) and `MAX_ELEMENT_COUNT` (1,000,000) bounds directly within stream decoders to discard invalid allocations instantaneously. - **JSON Buffer Flood Protection**: Refactored JSON streaming layers across Java, C++ and C# protocols to incrementally evaluate payload limits, permanently neutralizing unbounded chunk accumulation vulnerabilities. - **DDoS Fuzzer Automation**: Deployed `test-fuzz-oom.js` to continuously simulate giant lists, infinite maps, and >2GB string payloads against all language parsers, asserting complete operational defense during CI roundtrips. --- ## [1.6.0] — 2026-04-01 ### Core: Data Parser Architecture Shift (Zero-Allocation & V8 JIT Codegen) - **JavaScript JIT-Friendly Codegen**: Deprecated the dynamic AST reflection parser across Node.js/Web environments. Now fully generates pre-compiled, statically injected inline parsing functions (`_readPack`, `_readBin`). This quantum leap improves JSON parsing equivalence speeds by 250% while resolving severe Heap Allocation GC blockings. - **C# / Unity Zero-GC Architecture**: Upgraded the Unity client serialization pipeline to operate exclusively via strictly-sized Value Types (`[StructLayout]`) and static lambda generators, achieving a literal 0-byte memory allocation during million-iteration load tests. - **Cross-Language Master Benchmark Matrix**: Consolidated GC overhead testing across C#, C++, Java, JS, and JSON/CSV/Protobuf standards. The comprehensive benchmark analysis ensures DeukPack performs on par (or faster) with standard codecs without inducing the traditional mobile frame drops from memory bloating. ### Core: C++ Optimization & DDL Generator - **C++ Zero-Alloc Optimization**: Introduced arena allocator (`ArenaAllocator`, `StackAllocator`) in [native/cpp/include/memory_pool.h](native/cpp/include/memory_pool.h) to eliminate heap fragmentation during wire serialization. Wire roundtrip benchmarks show improved memory efficiency across binary and compact protocols. Arena is automatically initialized per writer and reset between roundtrips. - **C++ DDL Generator**: Added `CppDdlGenerator` ([src/codegen/cpp/CppDdlGenerator.ts](src/codegen/cpp/CppDdlGenerator.ts)) to convert Deuk structs (marked with `@table` annotation) into SQL DDL CREATE TABLE statements. Supports **MySQL**, **PostgreSQL**, and **SQLite** dialects with type mapping, constraints, and field exclusions (`@editorOnly`, `@transient`). - **Arena Allocator Integration**: Updated `BinaryWriter` and `CompactWriter` to optionally use arena allocators via `SetArenaAllocator()` API. Default arena size: 64KB per writer, recyclable on `Reset()`. ### Added - **native/cpp/include/memory_pool.h**: Arena and stack allocators for zero-allocation wire operations. - **src/codegen/cpp/CppDdlGenerator.ts**: DDL code generator with support for multiple SQL dialects. - **src/codegen/cpp/__tests__/CppDdlGenerator.test.ts**: Unit tests for C++ DDL generation (type mapping, constraint handling, field filtering). ### Changed - **native/cpp/include/binary_writer.h**: Added `SetArenaAllocator()` method and arena member. - **native/cpp/src/binary_writer.cpp**: Constructor now initializes default arena allocator (64KB). `Reset()` calls `arena_->reset()`. - **native/cpp/include/compact_writer.h**: Added arena allocator support (identical pattern to binary writer). - **native/cpp/src/compact_writer.cpp**: Arena initialization and reset integrated. - **CMakeLists.txt** (native/cpp): memory_pool.h included implicitly via binary_writer.h. ### Fixed - [Windows C++ build] MSVC UTF-8 flag (`/utf-8`) already applied in v1.2.10; maintained for compatibility. ### Performance - **C++ wire_micro_bench**: 100,000 roundtrips LE binary in **~198ms** (0.00198ms/iter avg) — comparable to isomorphic-wire-native baseline (libprotobuf ParseFromArray). - **Memory allocation reduction**: Arena allocator path eliminates per-roundtrip allocations for small messages (<4KB). - **Binary compatibility**: No changes to wire protocol; all existing roundtrip tests pass. ### Scope notes - **C++ DDL**: Currently opt-in via `@table` annotation on structs. Future versions may expand to auto-detection. - **Multi-threaded support**: Arena pools are not currently thread-safe; use one instance per thread or external synchronization. --- ## [1.5.0] — 2026-03-30 ### Core: Java Parity Completion & MCP Decoupling (Architecture Optimization) - **Java Runtime Parity**: Added structural inheritance (`extends`) in the Java generator, along with high-performance **Compact** (`TCompactProtocol`) and **TJSON** (`TJSONProtocol`) protocols, ensuring full Thrift compatibility for the Java ecosystem. - **Protocol Security Guards**: Universally enforced security policies across all supported languages (TS/JS, C#, C++, Java), including `MAX_SAFE_LENGTH` (10MB) and `MAX_RECURSION_DEPTH` (64) to neutralize malicious payloads. - **MCP Decoupling**: Streamlined the core repository by moving the MCP server generation logic to a dedicated module (`DeukPackMcp`). The core now focuses purely on AI knowledge extraction (`AiContextGenerator`). - **Feature Matrix Refinement**: Granularized the protocol support matrix into **Native Pack**, **Protobuf**, **Thrift (T-Series)**, **JSON**, and **YAML/CSV** across all major documentation files. ### Fixed - **CLI Guidance**: Improved the `deukpack --mcp` CLI command to provide clear guidance regarding the decouple plugin policy introduced in v1.5.0. - **Dependency Optimization**: Removed `@modelcontextprotocol/sdk` from the core `package.json` to reduce installation footprint. ## [1.4.0] — 2026-03-29 ### Core: MCP Protobuf Expansion & Server Generation Support - **Protobuf IDL Advancement**: Significantly expanded the Protobuf parser to support complex structures including nested messages, services, and RPC definitions. - **MCP Server Generator**: Added an end-to-end round-trip feature to generate Model Context Protocol (MCP) server code directly from Protobuf or Deuk IDLs. - **Documentation Restructuring & Sanitization**: Isolated internal design and business documents into `docs/internal/` and sanitized public technical documents of internal project references (`project_dp`, `DEUKPACK`). ### Fixed - **OpenSource Sync Filter**: Strengthened filtering rules in the `mirror-to-oss.js` script to ensure the `docs/internal/` directory is not exposed in the OSS mirror repository (`DeukPackOSS`). ## [1.3.0] — 2026-03-28 ### Core: Official Transition to AI-Ready Interface Hub - **Mixed-IDL Hybrid Serializer**: Established a system that simultaneously parses **`.deuk`**, **`.thrift`**, **`.proto`**, and **OpenAPI** definitions through a single DeukPack core entry and unifies them into a single binary spec. - **IDL-to-AI Semantic Mapping**: Added a feature to extract **Semantic Context (Markdown/JSON)** from the DeukPack AST using **`AiContextGenerator`**, enabling AI agents (LLMs) to understand architecture and data structures with 100% clarity. (**`npm run export:ai-context`**) - **Website (`deukpack.app`) Overhaul**: Completely restructured and synchronized the main landing page and product introductions (Core, Protocol, Excel, Pipeline) with the 'AI-Ready Interface Hub' concept. ### Added - **Benchmark `comparisonSet.compareContract`**: isomorphic wire drivers (`isomorphic-wire-io`, `isomorphic-wire-io-dotnet`, `isomorphic-wire-native` wrapper) attach **`axes`** describing logical-row equivalence, distinct wire encodings, and **JSON bulk parse vs per-row binary decode**. Documented in **`docs/DEUKPACK_BENCHMARKING*.md`** with **Pack decode** improvement candidates (profile-first). **`benchmarks/reports/BENCHMARK_TABLE.md`** / **`BENCHMARK_CURRENT_STATE*.md`** point readers at the same contract. - **Optional C++ isomorphic wire bench**: CMake **`DEUKPACK_ISO_WIRE_NATIVE_BENCH`** builds **`isomorphic_wire_native_bench`** (same **PBW1/TBW1** slices as Node: **libprotobuf** + **Thrift C++**). **`npm run bench:isomorphic-wire-native`** writes **`benchmarks/out/isomorphic-wire-native-last.json`** (`skipped` without deps). **`bench:plan-phase1`** and Docker **`run-all-benches.sh`** invoke it; Docker image includes **CMake**, **protobuf**, **Thrift C++**, **Boost** headers. - **`benchmarks/reports/BENCHMARK_CURRENT_STATE.md`** / **`.ko.md`**: narrative benchmark snapshot aligned with committed `benchmarks/out/*.json`; **§12** post-bench steps to refresh **`BENCHMARK_TABLE.md`** from `*-last.json`. **`docs/DEUKPACK_BENCHMARKING*.md`**: short pointer for the same refresh flow. Methodology: **`docs/DEUKPACK_BENCHMARKING.md`**. - **`npm run bench:plan-phase1`**: runs `build`, isomorphic corpus generation, wire augmentation, **`bench:wire-gzip`** (writes **`wire-bytes-gzip-last.json`**), **`bench:isomorphic-data`**, and **`bench:isomorphic-wire-io`**. Optional env **`ISOMORPHIC_BENCH_ROWS`** / **`ISOMORPHIC_BENCH_COLUMNS`** / **`ISOMORPHIC_BENCH_SEED`**; **`--skip-build`** when `dist/` is already built. - **`npm run bench:wire-gzip`**, **`bench:idl-codegen-wall`**, **`bench:cross-lang-isomorphic`**, **`bench:cpp-wire-micro`**: JSON benchmark outputs with **`benchContext`** (platform, measure kind, optional median/p95). Isomorphic generator supports **`--payload-profile small|medium|large`** and records **`fixtureId`** in **`corpus-meta.json`**. See **`docs/DEUKPACK_BENCHMARKING.md`**. - **Native `wire_micro_bench`**: optional C++ micro-benchmark binary (LE binary roundtrip) built with **`native/cpp`** CMake; used by **`bench:cpp-wire-micro`** when present. - **`npm run bench:plan-phase2`**: isomorphic corpus + augment, then **`bench:isomorphic-e2e`**, **`bench:meta-packed-vs-wire`**, **`bench:stream-throughput`**, **`bench:large-idl`** → `benchmarks/out/isomorphic-e2e-last.json`, `meta-packed-vs-wire-last.json`, `stream-throughput-last.json`, `large-idl-parse-last.json`. - **`npm run bench:e2e-roundtrip`**, **`bench:isomorphic-e2e`**, **`bench:meta-packed-vs-wire`**, **`bench:stream-throughput`**, **`bench:large-idl`**: Phase 2 JSON benchmarks (see **`docs/DEUKPACK_BENCHMARKING.md`**). - **`bench:export-define`**: optional **`--full-tree`** (per-`.deuk` outputs under `define-export/tree/`) and **`export.openapi.json`** for single-entry export. ### Changed - **Isomorphic wire (.NET / C++):** **`IsoWireIoBench`** now times **TBW1** with **ApacheThrift** NuGet **`TBinaryProtocol`** (async API bridged in-process; package version in **`benchmarks/cross-lang/IsoWireIoBench/IsoWireIoBench.csproj`**). **`isomorphic_wire_native_bench`** takes **`payload.pack`** as a third file and times **DPK1** tagged-object row decode (same walk as Node/.NET). Rebuild the native binary after pull. **`docs/DEUKPACK_BENCHMARKING*.md`** / **`BENCHMARK_TABLE.md`**: README marketing table traceability section. - **Benchmarks (isomorphic wire):** **`payload.pb`** / **`payload.thriftwire`** use **protoc-generated `google-protobuf`** and **Apache Thrift npm** (`TBinaryProtocol` + `thrift --gen js:node` stubs under **`benchmarks/gen/isomorphic-wire-codecs/`**). **`npm run bench:codegen-isomorphic-wire-codecs`** runs **grpc-tools `protoc`** and **`thrift`** on `PATH` or **Docker `apache/thrift:latest`**. **`bench:augment-isomorphic-wire`** invokes codegen first. Isomorphic CSV benches use **`csv-parse`**. **`bench:isomorphic-wire-io`**, **`bench:meta-packed-vs-wire`**, **`bench:isomorphic-e2e`**, and **`bench:isomorphic-data`** updated; **`docs/DEUKPACK_BENCHMARKING*`**, **`benchmarks/reports/BENCHMARK_*`**, and committed **`benchmarks/out/*-last.json`** aligned after **`bench:plan-phase1`** / **`bench:plan-phase2`**. **devDependencies:** **`thrift`**, **`google-protobuf`**, **`csv-parse`**, **`grpc-tools`**. - **`npm run build`**: TypeScript compile uses **`node ./node_modules/typescript/lib/tsc.js`** so `build` succeeds when `tsc` is not on `PATH` (e.g. some Windows setups). - **DevDependencies**: **`jest`** pinned to **^29.7.0`** (with **`@types/jest`** ^29.5.14) so **`npm test`** works with **`ts-jest`** on Windows; Jest **30** rejected the `ts-jest` preset/transform path in this environment. - **C++ wire tests on Windows**: **`npm run test:cpp`** and **`verify-build.js`** use **`scripts/run-cpp-native-tests.js`**, which configures CMake with **Visual Studio** (`-G "Visual Studio 17 2022" -A x64` by default) so the default **NMake** generator is not required. Override with **`DEUKPACK_CPP_CMAKE_GENERATOR`** / **`DEUKPACK_CPP_CMAKE_ARCH`** if needed. --- ## [1.2.10] — 2026-03-26 ### Fixed - **C++ native source encoding**: removed non-ASCII UTF-8 em-dash from `wire_engine.h` comment — eliminated MSVC **C4819** warning on Korean-locale Windows (`CP949`). - **MSVC compile flags**: added **`/utf-8`** to `binding.gyp` (`msvs_settings`) and `native/cpp/CMakeLists.txt` — ensures source and execution charset are UTF-8 regardless of system locale. ### Changed - **Benchmarks**: added **`npm run bench:generate-isomorphic-corpus`** and **`npm run bench:isomorphic-data`** — synthetic same-row JSON/CSV plus `.deuk` schema read/write timings; Docker **`bench`** runs the generator with optional **`ISOMORPHIC_BENCH_ROWS`** (etc.). See **`docs/DEUKPACK_BENCHMARKING.md`**. - **`npm run sync:oss:apply` / `version:sync` / `bundle:vscode`**: internal `npm install`/`npm ci` calls now use **`--loglevel=silent`** — suppresses EBADENGINE (Jest 30 ↔ Node 23 engine-range mismatch) and deprecated-package noise from console output during automation. - **`package.json`**: added `npm` engine floor (`>=9.0.0`); added `.npmrc` to `files` so consumers inherit `fund=false` / `audit=false` defaults. - **`.npmrc`** (repo root): `fund=false`, `audit=false` — no fund/audit noise on `npm install` in this repo. --- ## [1.2.9] — 2026-03-26 **Workspace modes** (`.deukpack/workspace.json`): **Package install** sets `installKind: "package"` — Unity `Packages/manifest.json` is updated from the published npm version (git UPM URLs); no local DeukPack checkout. **Source / dev mode** sets `installKind: "src"` and `deukPackRoot` — `deukpack sync` and postinstall **`npm install`** rebuild **netstandard2.0** **`DeukPack.Core`**, **`DeukPack.Protocol`**, **`DeukPack.ExcelProtocol`** (each **`.dll`** + **`.pdb`**) and copy them into the UPM runtime **Plugins** folder; package mode skips that DLL path. ### Added - **`deukpack add`**: new CLI command installs family packages (`app.deukpack.navigation`, `app.deukpack.runtime`, etc.) into the workspace and updates Unity **`Packages/manifest.json`** for listed projects (both modes). - **UPM package layout**: build script and pipeline profile schema for Unity Package Manager output; `package.json` template and directory structure generated on **`deukpack init`** (normal init flow). - **`DeukPack.Core` assembly** (generated C#): split from `DeukPack.Protocol` — metadata and shared interfaces in a separate DLL. **Source / dev mode**: **`deukpack sync`** / Unity plugin build copies **`DeukPack.Core.dll`** (and **`.pdb`**) into **`app.deukpack.runtime`** **Plugins** together with **Protocol** and **ExcelProtocol**; codegen/game projects should reference **Core** where they only need shared meta, not the full protocol stack. ### Changed - **`deukpack sync`** (alias `sync-runtime`): renamed for clarity. **Source / dev mode only** — runs when `installKind` is `"src"`; rebuilds **Core**, **Protocol**, and **ExcelProtocol** netstandard2.0 plugins and copies them to Unity **Plugins**. **Package install**: command exits after an informational skip (no local build). - **`deukpack init` / `deukpack add`**: Unity manifest dependency sync restored; serverkit shares `app.deukpack.runtime` alongside navigation. - **`deukpack init` end-of-run and `npm install` postinstall**: **Source / dev mode** — **Core** + **Protocol** + **ExcelProtocol** DLL build/copy, then manifest update; **package install** — manifest update only. ### Fixed - **Security**: `picomatch` bumped to **2.3.2** (GHSA-c2c7-rcm5-vvqj, GHSA-3v7f-55p6-f55p). --- ## [1.2.8] — 2026-03-25 ### Changed - **Wire protocol naming**: Renamed **`tproto`** to **`protv2`** / **`protv3`** across types, serialization, tests, and docs. The `t-` prefix is now exclusively Thrift (`tbinary` / `tcompact` / `tjson`); the `proto-` prefix identifies Protobuf edition (proto2 / proto3). --- ## [1.2.7] — 2026-03-25 ### Changed - **C# (`DeukPack.Protocol`)**: **`DpFormat`** enum consolidated in **`DpProtocolCore`** — `Binary`, `Json`, `DeukJson`, `DeukYaml` (alias `Yaml`). New **`DpDeukYamlProtocol`** for Deuk YAML output. - **C++**: **`DpProtocol.h`** template added; primitive codegen types mapped to `deuk::*` aliases. --- ## [1.2.6] — 2026-03-28 ### Changed - **Schema / embedded metadata**: Field and root schema `type` strings use **DeukPack spelling** (`struct`, `enum`, `int16` / `int32` / `int64`, etc.). **C#** `DpSchemaType` uses **`Int16` / `Int32` / `Int64`** with **`SchemaTypeToStandardString`** for string forms. **JSON compatibility wire** object keys (`int32`, `tf`, `str`, `lst`, …) are unchanged. - **C# codegen**: Generated types initialize **`string`** / struct references so **`nullable` enable** builds stay clean; optional struct **`Clone()`** uses a null-forgiving path when codegen nullable mode is off. - **CI**: **C++** native wire library **build + `ctest`** on **Ubuntu** and **Windows** runners. - **Tooling**: **`npm run verify`** runs the same checks as the **GitHub Actions** workflow locally. --- ## [1.2.5] — 2026-03-27 ### Changed - **Package exports (`index`)**: The published npm API (`serialize` / `deserialize`, interop helpers, `packStructWire`, etc.) matches the public **GitHub** TypeScript entry; Excel-only protocol remains outside the open-source tree. - **C# (`DeukPack.Protocol`)**: **`WriteString` / `WriteBinary`** use **`string?` / `byte[]?`** to match **`DpProtocol`** (CS8767). **`DpMetaInfosWrapper.TryGetValue`** uses **`[MaybeNullWhen(false)]`** for **`IReadOnlyDictionary<,>`** consistency. --- ## [1.2.4] — 2026-03-26 ### Changed - **README (GitHub)**: English and Korean README copies used on **GitHub** rewrite documentation links to **[deukpack.app](https://deukpack.app/)** so readers land on the hosted docs. - **Dependencies / toolchain**: **`nan`**, **`node-addon-api` ^8**, **`yaml`**; dev — **Jest 30**, **`protobufjs` ^8**, **`rimraf` ^6**, **`cmake-js` ^8**, **`node-gyp` ^12**, **`@vscode/vsce`**, **`@types/jest` ^30**, **`typescript` ^5.9**, **`@types/node` ^20.19**; **`engines.node` ≥18**; **`scripts/setup.js`** minimum **Node 18**. - **Security**: **`npm audit fix`** — transitive **`minimatch`** high-severity ReDoS advisories addressed. --- ## [1.2.3] — 2026-03-25 ### Changed - **`deukpack init`**: Interactive flow trims prompts (directory-wide IDL only; no exclude/include-strategy questions); **bootstrap** (`.deukpack/workspace.json`) always runs; **`--skip-workspace` removed**. - **VSIX**: Runs **after** workspace bootstrap; auto-install tries **`code`**, then **`cursor`**, then **`antigravity`** (`--install-extension`). - **Docs**: README **`npx`** vs **`npm deukpack`** clarification; init order and postinstall wording aligned. --- ## [1.2.2] — 2026-03-24 ### Added - **Pipeline**: **`defineScope: "all"`** when **`thriftFile`** is omitted — collects every **`*.deuk`** under **`defineRoot`**, applies merged **`exclude`** (config + job), writes a short-lived bundle entry, then builds; bundle file removed after the job. - **`outputLangSubdirs`**: optional per-job map **`{ csharp?, cpp?, ts?, js? }`** — each value is a **single** directory name under **`outputDir`** (for legacy layout use e.g. **`typescript`** / **`javascript`**). ### Changed - **Breaking (codegen paths)**: **`--ts`** / **`--js`** (and pipeline **`ts`** / **`js`**) emit under **`/ts/`** and **`/js/`** instead of **`typescript/`** and **`javascript/`**. - **Pipeline**: **`jobs[].outputDir`** may be **omitted** — defaults to the same relative path as **`defineRoot`** (default **`idls`**), so outputs are **`idls/csharp`**, **`…/cpp`**, **`…/ts`**, **`…/js`** when those generators run. - **`deukpack init`**: default generated pipeline uses **`defineScope: "all"`** and **`outputDir`** aligned with **`defineRoot`**; interactive defaults updated. - **Docs / examples / kits**: paths updated for **`ts`** / **`js`** outputs. --- ## [1.2.1] — 2026-03-24 ### Changed - **Docs**: **README** / **README.ko** — installation steps in **code blocks**; **project-local** `npm install deukpack` → `npx deukpack init` → `npx deukpack run`; **global `npm install -g`** removed from this guide; kits link label **DeukPack Tale** / **득팩 테일** (URL unchanged). - **CLI**: One-shot `deukpack …` **warns** when **`./deukpack.pipeline.json`** is missing; suggests **`npx deukpack init`** (build still runs). - **`deukpack init` / bootstrap / bundled VSIX**: When **`.deukpack/deuk-idl-vsix.json`** records a different **npm `deukpack` version**, **attempt bundled VSIX install without prompting**; **Unity-near** detection strengthens install/skip messaging; **`--non-interactive` `init`** calls version-bump VSIX **ensure** when **`--skip-vsix`** is not set; **bootstrap** passes Unity hint into VSIX prompts and runs bump **ensure** when not TTY. --- ## [1.2.0] — 2026-03-23 ### Added - **Bundled VS Code extension**: npm tarball includes **`bundled/deuk-idl.vsix`**. **postinstall** re-attempts install when **`deukpack` npm version** changes vs **`.deukpack/deuk-idl-vsix.json`**. **Interactive `deukpack bootstrap`** prompts to install/update the VSIX. Details: **`bundled/README.md`**. - **Unity**: **[deukpack.app](https://deukpack.app/)** documents embedding **DeukPack.Protocol** (and related) with UPM-style layout; native plugins are built by your game/project pipeline, not shipped inside the npm **`deukpack`** package. - **npm wire entry (single shape)**: **`serialize(value, protocol?, extras?)`** / **`deserialize(data, protocol?, extras?)`** with exported **`WireExtras`** / **`WireDeserializeExtras`** (`pretty`, `interopRootStruct`, `interopStructDefs`, `targetType`, …). Full control remains via **`WireSerializer`** / **`WireDeserializer`** + **`SerializationOptions`**. ### Changed - **Breaking (JS package entry)**: `serialize(_, protocol, prettyBoolean, wireFamily)` is removed — use **`serialize(_, protocol, { pretty: true, wireFamily?, … })`**. **`deserialize`** accepts **`string` | `Uint8Array` | `Buffer`** and takes the same **`WireExtras`**-shaped third argument (plus optional **`targetType`** for class-shaped output). - **Wire (TypeScript)**: **`BinaryReader`**, **`wireTags`**, **`SerializationWarnings`**; **`WireSerializer` / `WireDeserializer`** expanded so **Deuk native** (`pack`, `json`, `yaml`) and **interop** (`tbinary`, `tcompact`, `tjson` + schema) stay paired. **C# `DeukPack.Protocol`**: csproj / **SharedCompile** props adjusted alongside. - **CI**: GitHub Actions use **setup-dotnet** so `DeukPack.Protocol` builds reliably in workflows; YAML step-name quoting fixes for `:` / `&`. - **Codegen**: C++ / TypeScript / JavaScript emit paths further **template-driven**; JS/schema output **DeukPack-oriented labeling** aligned with templates. - **Docs**: DeukNavigation **game integration** (baking / runtime) expanded; **deukpack.app** updates. - **Repo hygiene**: ExcelProtocol and example **build artifacts** moved under **gitignore** / removed from tracking. --- ## [1.1.0] — 2026-03-20 ### Added - **C++ codegen (`--cpp`)**: map `uint8` / `uint16` / `uint32` / `uint64` to `uint8_t` / `uint16_t` / `uint32_t` / `uint64_t` from ``; generated headers now `#include `. - **IDL parser**: Thrift-style **legacy `message` blocks** without parenthesized numeric IDs (`message Name { ... }`) — better compatibility for existing `.thrift` / mixed workflows (`declarationKind` remains `message`). ### Fixed - **C# runtime (DeukPack.Protocol)**: Binary-related enum and `IDisposable` handling; generated/runtime alignment. - **CLI**: `bin/deukpack.js` forwarding to `scripts/build_deukpack.js` (cwd-independent resolution). ### Changed - **Docs / site**: README one-liners; [deukpack.app](https://deukpack.app/) reference layout (tracks submodule commits). ### Verification — DeukPackKits StarterKit (local CLI `1.1.0`) Checked **2026-03-23** with `npm run build` in this repo, then `node scripts/build_deukpack.js`: | Kit path | Command | Result | |----------|---------|--------| | `DeukPackKits/StarterKit/csharp/prologue` | `idls/csharp.deuk` → `out` with `-I idls --csharp` | Success; `csharp.cs`, `MetaTableRegistry.g.cs`, `DeukDefine.csproj` emitted | | `DeukPackKits/StarterKit/cpp/prologue` | `idls/cpp.deuk` → `out` with `-I idls --cpp` | Success; `cpp_deuk.h` / `cpp_deuk.cpp` emitted (suffix avoids hand-written header clashes); header includes `` | *(Other StarterKit rooms were not all re-run in this check; use each room’s README command as needed.)* --- ## [1.0.x] — ~Mar 2026 (patch line) ### Summary - Early **1.0.x** patches focused on **bugfixes, packaging, C# multi-targeting, and documentation paths** without expanding the core feature set. --- For commits before this file existed, see `git log` and GitHub **Releases**.