Add ObjectPrefixKey wildcard matching for JBFL patterns

JBFL_DOCS.md

@@ -37,11 +37,13 @@ Typical use cases include:
 
 | Pattern  | Description                                                                      |
 |----------|----------------------------------------------------------------------------------|
-| `.*`     | Matches **any key** at the current object level, regardless of name.             |
-| `[*]`    | Matches **all elements** in a list (1D array).                                   |
-| `[*][*]` | Matches **all elements in the innermost lists** of 2D arrays (arrays of arrays). |
-| `.test`  | Matches the value with key `test` in an object.                                  |
-| `[4]`    | Matches the value at index 4 in an array.                                        |
+| `.*`      | Matches **any key** at the current object level, regardless of name.             |
+| `[*]`     | Matches **all elements** in a list (1D array).                                   |
+| `[*][*]`  | Matches **all elements in the innermost lists** of 2D arrays (arrays of arrays). |
+| `.test`   | Matches the value with key `test` in an object.                                  |
+| `.test*`  | Matches any key that **starts with** `test` (prefix match).                      |
+| `.0`      | Matches the object child at positional index 0 (by order, ignoring key name).    |
+| `[4]`     | Matches the value at index 4 in an array.                                        |
 
 ## Properties Overview
 
@@ -53,12 +55,14 @@ Typical use cases include:
 | `AlignObjectKeys`     | Pads object keys so that `:` separators align vertically across all entries in the same object.                                                                          | Objects                         |
 | `AutoPadSubObjects`   | Aligns values within sibling inline objects by treating matching sub-keys as columns. Useful for `glowMap`-style structures.                                             | Objects with inline sub-objects |
 | `ComplexNewLine`      | Controls multiline formatting for complex structures. `None` disables it (inline output). `Force` always enables it. Replaces the deprecated `NoComplexNewLine` and `ForceComplexNewLine` properties. | Any complex data structure      |
+| `PreserveNumberFormat` | Outputs numbers exactly as written in the source file instead of normalizing them. Useful for preserving intentional formatting like `+1` or `0.002` vs `2.0e-3`.       | Numeric values                  |
 | `Indent`              | Controls the amount of indentation. Defaults to 4 spaces.                                                                                                               | Any complex data structure      |
 
 ## How Matching Works
 
 - Patterns traverse nested objects and arrays.
 - `.*` matches all keys at the current level.
+- `.foo*` matches any key starting with `foo` (e.g. `.deformGroups_oilPan*` matches `deformGroups_oilPanFront`, `deformGroups_oilPanRear`, etc.).
 - `[*]` matches all elements of an array.
 - Combinations like `.*.nodes[*][*]` match all elements inside inner lists under `nodes` keys.
 - Properties apply **to each matched value individually**.

src/JbeamEdit/Core/NodeCursor.hs

@@ -10,6 +10,7 @@ module JbeamEdit.Core.NodeCursor (
 import Data.Sequence (Seq (..))
 import Data.Sequence qualified as Seq (empty, null)
 import Data.Text (Text)
+import Data.Text qualified as T (isPrefixOf)
 import JbeamEdit.Core.Node (Node (..), maybeObjectKey)
 import JbeamEdit.Core.NodePath qualified as NP
 
@@ -56,6 +57,7 @@ Validate whether all the selectors match the corresponding breadcrumb, returning
 -}
 compareSB :: SelCrumbCompFun
 compareSB (NP.ObjectKey s) (ObjectIndexAndKey _ k) = s == k
+compareSB (NP.ObjectPrefixKey s) (ObjectIndexAndKey _ k) = s `T.isPrefixOf` k
 compareSB (NP.ObjectIndex s) (ObjectIndexAndKey i _) = s == i
 compareSB (NP.ArrayIndex s) (ArrayIndex i) = s == i
 compareSB _ _ = False

src/JbeamEdit/Core/NodePath.hs

@@ -25,6 +25,7 @@ import JbeamEdit.Core.Node qualified as N (
 data NodeSelector
   = ArrayIndex Int
   | ObjectKey Text
+  | ObjectPrefixKey Text
   | ObjectIndex Int
   deriving (Eq, Ord, Read, Show)
 

src/JbeamEdit/Parsing/DSL.hs

@@ -21,7 +21,7 @@ import Data.Map qualified as M (fromList, fromListWith, union)
 import Data.Sequence qualified as Seq (fromList)
 import Data.Set qualified as S (fromList)
 import Data.Text (Text)
-import Data.Text qualified as T (unpack)
+import Data.Text qualified as T (init, isSuffixOf, unpack)
 import Data.Text.Encoding (decodeUtf8')
 import Data.Word (Word8)
 import JbeamEdit.Core.NodePath
@@ -41,7 +41,8 @@ type JbflParser a = Parser Identity a
 objectKeyParser :: JbflParser NodePatternSelector
 objectKeyParser = byteChar '.' *> key
   where
-    key = parseWord8s (Selector . ObjectKey) (MP.some . MP.satisfy $ p)
+    key = parseWord8s (Selector . t) (MP.some . MP.satisfy $ p)
+    t k = if T.isSuffixOf "*" k then ObjectPrefixKey (T.init k) else ObjectKey k
     p = charBoth (not . isSpace) (`notElem` [',', '[', '.']) . toChar
 
 objectIndexParser :: JbflParser NodePatternSelector

test/Core/NodeCursorSpec.hs

@@ -23,6 +23,14 @@ spec = do
       compareSB (NP.ArrayIndex 3) (ArrayIndex 3) `shouldBe` True
       compareSB (NP.ArrayIndex 4) (ArrayIndex 3) `shouldBe` False
 
+    it "matches ObjectPrefixKey correctly" $ do
+      compareSB (NP.ObjectPrefixKey "deform") (ObjectIndexAndKey 0 "deformGroups")
+        `shouldBe` True
+      compareSB (NP.ObjectPrefixKey "deform") (ObjectIndexAndKey 0 "deform")
+        `shouldBe` True
+      compareSB (NP.ObjectPrefixKey "deform") (ObjectIndexAndKey 0 "other")
+        `shouldBe` False
+
     it "does not match mismatched cases" $
       compareSB (NP.ArrayIndex 1) (ObjectIndexAndKey 1 "x") `shouldBe` False
 

test/Parsing/DSLSpec.hs

@@ -23,6 +23,8 @@ patternSelectorSpecs =
     [ (".*", AnyObjectKey)
     , ("[*]", AnyArrayIndex)
     , (".test", Selector (NP.ObjectKey "test"))
+    , (".test*", Selector (NP.ObjectPrefixKey "test"))
+    , (".deformGroups_oilPan*", Selector (NP.ObjectPrefixKey "deformGroups_oilPan"))
     , (".3", Selector (NP.ObjectIndex 3))
     , ("[3]", Selector (NP.ArrayIndex 3))
     ]