Added a common definition of a Scope.

README.md

@@ -28,7 +28,7 @@ To get started, add this Maven dependency:
 
 ## Scopes
 
-[Service Locators](docs/Frequently_Asked_Questions.md#not-your-mothers-service-locator) are registries
+[Service Locators](docs/frequently_asked_questions.md#not-your-mothers-service-locator) are registries
 that contain one or more *values*.
 Values can be bound to one or more *scopes*.
 A scope is the context within which a value is defined.

core/src/main/java/com/github/cowwoc/pouch/core/Scope.java

@@ -0,0 +1,33 @@
+package com.github.cowwoc.pouch.core;
+
+/**
+ * The lifespan of one or more variables.
+ * <p>
+ * Child scopes must call {@link #addChild(Scope)} at the end of their constructor and
+ * {@link #removeChild(Scope)} at the end of their {@link #close()} method.
+ */
+public interface Scope extends AutoCloseable
+{
+	/**
+	 * Adds a child scope.
+	 *
+	 * @param child the child scope
+	 * @throws IllegalStateException if the scope is closed
+	 */
+	void addChild(Scope child);
+
+	/**
+	 * Removes a child scope.
+	 *
+	 * @param child the child scope
+	 */
+	void removeChild(Scope child);
+
+	/**
+	 * @return {@code true} if the scope is closed
+	 */
+	boolean isClosed();
+
+	@Override
+	void close();
+}

docs/Changelog.md → docs/changelog.md

@@ -1,6 +1,10 @@
 Minor updates involving cosmetic changes have been omitted from this list. See [commits](../../commits/master)
 for a full list.
 
+## Version 5.3 - 2024/12/29
+
+* Added a common definition of a `Scope`.
+
 ## Version 5.2 - 2024/12/12
 
 * Bugfix: [Fail on WrappedCheckedException validation before calling super](https://github.com/cowwoc/pouch/pull/9) by [Berk Koprucu](https://github.com/bkoprucu)