feat(generator): add map helpers and nested item helpers for array fields

[thisisibrahimd]

Summary

Adds two new function types for every array field in generated Jsonnet libraries:

mapXyz(f) — generic element transform

Transforms each element in an array using std.map:

deployment + mapContainers(function(c)
  c + { image: c.image + '-patched' }
)

mapXyzByName(name, transformFunc) — targeted element transform

Transforms only the element where item.name matches:

deployment + mapContainersByName('app', function(c)
  c + { image: 'myapp:v2' }
)

Only generated when array items have a "name" property (containers, env vars, volumes, etc).

Additional changes

• Nested helpers for array items — arrays of objects now produce per-property helpers (e.g. containers: { withName(), withImage() }), matching the existing OpenAPI path behavior and now also in the JSON Schema path
• New builder types — ArrayComprehensionType for the [if/then/else for] pattern and CallArg for positional function call arguments
• Hyphenated field support — super['field-name'] bracket notation used for fields with special characters
• Test schema — map-test-schema.json covering both named and unnamed array items
• Documentation — README updated with array support examples, AGENTS.md added with key commands and gotchas

Generated output example

{
  mapContainers(f): { containers: std.map(f, super.containers) },
  mapContainersByName(name, transformFunc): {
    containers: [if c.name == name then transformFunc(c) else c for c in super.containers],
  },
  mapTags(f): { tags: std.map(f, super.tags) },
  containers: {
    withName(name): { containers+: { name: name } },
    withImage(image): { containers+: { image: image } },
  },
}

Files changed

File	Change
pkg/builder/collections.go	Add ArrayComprehensionType
pkg/builder/funcs.go	Add CallArg type
pkg/model/modifiers.go	Add ItemHasName field to Modifier
pkg/render/modifiers.go	Add mapFnResult, mapByNameFnResult, superRefString
pkg/complier/jsonschemacomplier/jsonschemacomplier.go	Add superRef, map functions, nested helpers
pkg/complier/jsonschemacomplier/jsonschemacomplier_test.go	Add map-test-schema test case
testdata/*.json + *.golden.libsonnet	New schema + updated golden fixtures
README.md	Document array map functions with examples
AGENTS.md	New file with key commands and gotchas