From af07cfa67b867607912376fbcda842fe7373ebf3 Mon Sep 17 00:00:00 2001
From: Runxi Yu
Date: Sat, 21 Feb 2026 02:04:15 +0800
Subject: ref: Add Ref, Detached, Symbolic

---
 ref/ref.go | 41 +++++++++++++++++++++++++++++++++++++++++
 1 file changed, 41 insertions(+)
 create mode 100644 ref/ref.go

(limited to 'ref')

diff --git a/ref/ref.go b/ref/ref.go
new file mode 100644
index 00000000..9d1fbfc2
--- /dev/null
+++ b/ref/ref.go
@@ -0,0 +1,41 @@
+// Package ref provides Git reference models.
+package ref
+
+import "codeberg.org/lindenii/furgit/objectid"
+
+// Ref is a Git reference.
+//
+// Implementations must be in this package.
+type Ref interface {
+	isRef()
+	Name() string
+}
+
+// Detached points directly to an object ID.
+type Detached struct {
+	RefName string
+	ID      objectid.ObjectID
+
+	// Peeled is the peeled target when available (for annotated tags).
+	Peeled *objectid.ObjectID
+}
+
+// Name returns the fully-qualified reference name.
+func (ref Detached) Name() string {
+	return ref.RefName
+}
+
+func (Detached) isRef() {}
+
+// Symbolic points to another reference name.
+type Symbolic struct {
+	RefName string
+	Target  string
+}
+
+// Name returns the fully-qualified reference name.
+func (ref Symbolic) Name() string {
+	return ref.RefName
+}
+
+func (Symbolic) isRef() {}
-- 
cgit v1.3.1-10-gc9f91