Add SHOW IMAGE COLLECTION command and example script

New command: SHOW IMAGE COLLECTION [IN Module] lists all image
collections with their export level and image count.

New example script: 17-image-collection-examples.mdl demonstrates
CREATE, SHOW, DESCRIBE, and DROP IMAGE COLLECTION.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: ako

mdl-examples/doctype-tests/17-image-collection-examples.mdl

@@ -0,0 +1,117 @@
+-- ============================================================================
+-- Image Collection Examples
+-- ============================================================================
+--
+-- This file demonstrates the MDL syntax for managing image collections.
+-- Image collections are Mendix's way of bundling images (icons, logos)
+-- within a module.
+--
+-- Features demonstrated:
+--   - CREATE IMAGE COLLECTION (empty)
+--   - CREATE IMAGE COLLECTION with EXPORT LEVEL and COMMENT
+--   - SHOW IMAGE COLLECTION [IN Module]
+--   - DESCRIBE IMAGE COLLECTION
+--   - DROP IMAGE COLLECTION
+--
+-- ============================================================================
+
+CREATE MODULE ImgTest;
+
+-- MARK: Create
+
+-- ============================================================================
+-- LEVEL 1: Basic Image Collection
+-- ============================================================================
+
+/**
+ * Level 1.1: Create an empty image collection
+ *
+ * The simplest image collection — just a name.
+ * Images can be added later via Studio Pro.
+ */
+CREATE IMAGE COLLECTION ImgTest.AppIcons;
+/
+
+/**
+ * Level 1.2: Create with export level
+ *
+ * EXPORT LEVEL controls visibility:
+ *   'Hidden' (default) - internal to the module
+ *   'Public'           - accessible from other modules
+ */
+CREATE IMAGE COLLECTION ImgTest.SharedIcons EXPORT LEVEL 'Public';
+/
+
+/**
+ * Level 1.3: Create with comment
+ *
+ * COMMENT documents the purpose of the collection.
+ */
+CREATE IMAGE COLLECTION ImgTest.StatusIcons COMMENT 'Icons for order and task status indicators';
+/
+
+/**
+ * Level 1.4: Create with both export level and comment
+ */
+CREATE IMAGE COLLECTION ImgTest.BrandAssets
+  EXPORT LEVEL 'Public'
+  COMMENT 'Company branding assets: logos, favicons, and splash screens';
+/
+
+-- MARK: Show
+
+-- ============================================================================
+-- LEVEL 2: List Image Collections
+-- ============================================================================
+
+-- Show all image collections across all modules
+SHOW IMAGE COLLECTION;
+/
+
+-- Show image collections in a specific module
+SHOW IMAGE COLLECTION IN ImgTest;
+/
+
+-- MARK: Describe
+
+-- ============================================================================
+-- LEVEL 3: Describe Image Collection
+-- ============================================================================
+
+-- Describe shows the full MDL definition including any embedded images
+DESCRIBE IMAGE COLLECTION ImgTest.AppIcons;
+DESCRIBE IMAGE COLLECTION ImgTest.SharedIcons;
+DESCRIBE IMAGE COLLECTION ImgTest.BrandAssets;
+
+-- MARK: Drop
+
+-- ============================================================================
+-- LEVEL 4: Drop Image Collection
+-- ============================================================================
+
+/**
+ * Level 4.1: Drop an image collection
+ *
+ * Removes the collection and all its embedded images.
+ */
+DROP IMAGE COLLECTION ImgTest.StatusIcons;
+/
+
+-- Verify it's gone
+SHOW IMAGE COLLECTION IN ImgTest;
+/
+
+-- ============================================================================
+-- Summary
+-- ============================================================================
+--
+-- This file demonstrates:
+--
+-- ✅ CREATE IMAGE COLLECTION Module.Name
+-- ✅ CREATE IMAGE COLLECTION with EXPORT LEVEL 'Public'|'Hidden'
+-- ✅ CREATE IMAGE COLLECTION with COMMENT 'description'
+-- ✅ SHOW IMAGE COLLECTION [IN Module] — list all collections
+-- ✅ DESCRIBE IMAGE COLLECTION Module.Name — show full definition
+-- ✅ DROP IMAGE COLLECTION Module.Name — remove collection
+--
+-- ============================================================================

mdl/ast/ast_query.go

@@ -74,6 +74,7 @@ const (
 	ShowSettings              // SHOW SETTINGS
 	ShowFragments             // SHOW FRAGMENTS
 	ShowDatabaseConnections   // SHOW DATABASE CONNECTIONS [IN module]
+	ShowImageCollections      // SHOW IMAGE COLLECTIONS [IN module]
 )
 
 // String returns the human-readable name of the show object type.
@@ -169,6 +170,8 @@ func (t ShowObjectType) String() string {
 		return "FRAGMENTS"
 	case ShowDatabaseConnections:
 		return "DATABASE CONNECTIONS"
+	case ShowImageCollections:
+		return "IMAGE COLLECTIONS"
 	default:
 		return "UNKNOWN"
 	}

mdl/executor/cmd_imagecollections.go

@@ -7,6 +7,7 @@ import (
 	"fmt"
 	"os"
 	"path/filepath"
+	"strings"
 
 	"github.com/mendixlabs/mxcli/mdl/ast"
 	"github.com/mendixlabs/mxcli/sdk/mpr"
@@ -154,6 +155,42 @@ func imageFormatToExt(format string) string {
 	}
 }
 
+// showImageCollections handles SHOW IMAGE COLLECTION [IN module].
+func (e *Executor) showImageCollections(moduleName string) error {
+	collections, err := e.reader.ListImageCollections()
+	if err != nil {
+		return fmt.Errorf("failed to list image collections: %w", err)
+	}
+
+	h, err := e.getHierarchy()
+	if err != nil {
+		return err
+	}
+
+	fmt.Fprintf(e.output, "| %-40s | %-12s | %-6s |\n", "Image Collection", "Export Level", "Images")
+	fmt.Fprintf(e.output, "|%-42s|%-14s|%-8s|\n", strings.Repeat("-", 42), strings.Repeat("-", 14), strings.Repeat("-", 8))
+
+	count := 0
+	for _, ic := range collections {
+		modID := h.FindModuleID(ic.ContainerID)
+		modName := h.GetModuleName(modID)
+		if moduleName != "" && modName != moduleName {
+			continue
+		}
+
+		qualifiedName := fmt.Sprintf("%s.%s", modName, ic.Name)
+		exportLevel := ic.ExportLevel
+		if exportLevel == "" {
+			exportLevel = "Hidden"
+		}
+		fmt.Fprintf(e.output, "| %-40s | %-12s | %6d |\n", qualifiedName, exportLevel, len(ic.Images))
+		count++
+	}
+
+	fmt.Fprintf(e.output, "\n(%d image collection(s))\n", count)
+	return nil
+}
+
 // findImageCollection finds an image collection by module and name.
 func (e *Executor) findImageCollection(moduleName, collectionName string) *mpr.ImageCollection {
 	collections, err := e.reader.ListImageCollections()

mdl/executor/executor.go

@@ -752,6 +752,8 @@ func (e *Executor) execShow(s *ast.ShowStmt) error {
 		return e.showFragments()
 	case ast.ShowDatabaseConnections:
 		return e.showDatabaseConnections(s.InModule)
+	case ast.ShowImageCollections:
+		return e.showImageCollections(s.InModule)
 	default:
 		return fmt.Errorf("unknown show object type")
 	}

mdl/grammar/MDLParser.g4

@@ -2408,6 +2408,7 @@ showStatement
     | SHOW LAYOUTS (IN (qualifiedName | IDENTIFIER))?
     | SHOW NOTEBOOKS (IN (qualifiedName | IDENTIFIER))?
     | SHOW JAVA ACTIONS (IN (qualifiedName | IDENTIFIER))?
+    | SHOW IMAGE COLLECTION (IN (qualifiedName | IDENTIFIER))?   // SHOW IMAGE COLLECTION [IN Module]
     | SHOW ENTITY qualifiedName
     | SHOW ASSOCIATION qualifiedName
     | SHOW PAGE qualifiedName