Add public facade value wrappers

internal/facade/path.go

@@ -0,0 +1,33 @@
+package configkit
+
+import (
+	"gitea.maximumdirect.net/eric/ConfigKit/internal/engine"
+)
+
+// Path identifies a configuration value using YAML field names. Its textual form
+// is a JSON Pointer. Paths are immutable; the zero value is the root path.
+type Path struct {
+	value engine.Path
+}
+
+// Keys constructs a path of mapping keys. Keys with no arguments returns the root path.
+func Keys(keys ...string) Path { return Path{value: engine.Keys(keys...)} }
+
+// ParsePath parses a JSON Pointer while preserving context-dependent numeric tokens.
+func ParsePath(pointer string) (Path, error) {
+	value, err := engine.ParsePath(pointer)
+	return Path{value: value}, err
+}
+
+// Key returns a new path with key appended as a mapping-key segment.
+func (p Path) Key(key string) Path { return Path{value: p.value.Key(key)} }
+
+// Index returns a new path with index appended as a sequence-index segment.
+func (p Path) Index(index int) Path { return Path{value: p.value.Index(index)} }
+
+// String returns the path's canonical JSON Pointer spelling.
+func (p Path) String() string { return p.value.String() }
+
+func (p Path) clone() Path                 { return Path{value: p.value} }
+func toEnginePath(path Path) engine.Path   { return path.value }
+func fromEnginePath(path engine.Path) Path { return Path{value: path} }