adornment-core 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 9f458840898b3e988db4d7dc782b341c2cccacb1b4d5a80632d8dab3f948f586
+  data.tar.gz: f598bf3f4d8845a5396f58dbfc5e4a2f25c7e4318897a6ee20353eaa1a1193e5
+SHA512:
+  metadata.gz: 0a96f3c797b9625c967ffe52e7077daadc524a9f92bef0784569616e9c76ce146b85e831f6f25aa0393c0cdcefeadf81c72e70e9c1747e14e9b4ddf549d197bb
+  data.tar.gz: bb8039fa461fa4dc9f1f1d1f6fe2c0916aae2106061bbd22773ba90da01907711b831f084adecfd9c3726da9b9448a0c95af0401de4b91d12d08d37427c5df23

data/CHANGELOG.md

@@ -0,0 +1,34 @@
+# Changelog
+
+## 0.1.0 (2026-10-20)
+
+First release of `adornment-core`, the annotation engine behind Adornment.
+
+- **Annotation types** are named plain classes that include `Adornment::Annotation[...]`, with
+  the policies `repeatable:` (default `false`) and `targets:` (default
+  `[:instance, :singleton]`). Fields are instance variables set by an ordinary `initialize`, so
+  Ruby's own rules decide positional, keyword, required and default arguments. `new` deep-freezes
+  copies of Array, Hash, Set and String fields and freezes the instance. Instances compare, hash,
+  convert (`to_h`), inspect and pattern-match by class and fields.
+- **Declarations** above `def`: `include Adornment[Traced, Cache: Cached]` defines declaration
+  methods (`Traced(...)`) on the owner, `adorn instance` declares without them, and
+  `extend Adornment::Core::Target` + `use_annotations` is the explicit form. Pending
+  declarations attach to the owner's next method definition from the same fiber: `def`,
+  `define_method`, `def self.x`, `attr_*` (first name), aliases, `module_function` copies and
+  visibility changes of inherited methods.
+- **Attachment-time validation**: `Annotation#validate(site)` with `Adornment::Core::Site`; a
+  failure raises `Adornment::DefinitionError` (the validator's error as `cause`) and attaches
+  nothing.
+- **Reflection** along Ruby's method resolution, strict as in Java: `annotations_for`,
+  `annotation`, `find_annotation` (walks overridden methods), `annotated_with`,
+  `own_annotations_for`, `own_annotated_methods`, `declarations_for`, `pending_adornments`.
+  Includers, prependers and extenders of activated modules get the read-only API.
+- **Discovery and verification**: `Adornment.annotated_with`, `registered_owners` (weak registry),
+  `unregister`, `verify_all!`, `Owner.verify_adornments!`. Leftover declarations raise
+  `Adornment::LeftoverAnnotations` on a declaration for another owner, on a constant added to the
+  owner, or at verification. Nothing is traced.
+- **Lint** for bare annotation constants (`Traced` instead of `Traced()`), parsed with Prism and
+  loaded only on first use.
+- `Adornment.immutable_copy` and `Type.short_name` for extension gems.
+- Never wraps or replaces methods: a call to an annotated method runs no Adornment code and
+  allocates nothing extra. Pure Ruby, no runtime dependencies, CRuby >= 3.3.

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Yaroslav Zahoruiko
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.