docs: add image collection reference pages

Fill in reference pages for the new image collection feature:
CREATE/DROP IMAGE COLLECTION, SHOW/DESCRIBE IMAGE COLLECTION.

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

Author: ako

docs-site/src/reference/image-collection/README.md

@@ -0,0 +1,9 @@
+# Image Collection Statements
+
+Statements for creating, inspecting, and dropping image collections within modules.
+
+| Statement | Description |
+|-----------|-------------|
+| [CREATE IMAGE COLLECTION](create-image-collection.md) | Create a new image collection with optional images |
+| [DROP IMAGE COLLECTION](drop-image-collection.md) | Remove an image collection |
+| [SHOW / DESCRIBE IMAGE COLLECTION](show-describe-image-collection.md) | List or inspect image collections |

docs-site/src/reference/image-collection/create-image-collection.md

@@ -0,0 +1,70 @@
+# CREATE IMAGE COLLECTION
+
+## Synopsis
+
+    CREATE IMAGE COLLECTION module.name
+        [EXPORT LEVEL 'Hidden' | 'Public']
+        [COMMENT 'description']
+        [(
+            IMAGE 'image_name' FROM FILE 'path',
+            ...
+        )];
+
+## Description
+
+Creates a new image collection in the specified module. Image collections bundle images (icons, logos, graphics) within a module. Images can be loaded from the filesystem during creation, with the format detected automatically from the file extension.
+
+## Parameters
+
+**module.name**
+: The qualified name of the collection (e.g., `MyModule.AppIcons`).
+
+**EXPORT LEVEL**
+: Controls visibility from other modules. `'Hidden'` (default) restricts access to the owning module. `'Public'` makes images available to other modules.
+
+**COMMENT**
+: Documentation text for the collection.
+
+**IMAGE 'name' FROM FILE 'path'**
+: Loads an image from a file on disk. The path is relative to the current working directory. Supported formats: PNG, SVG, GIF, JPEG, BMP, WebP.
+
+## Examples
+
+### Empty collection
+
+```sql
+CREATE IMAGE COLLECTION MyModule.AppIcons;
+```
+
+### Public collection with description
+
+```sql
+CREATE IMAGE COLLECTION MyModule.SharedIcons
+    EXPORT LEVEL 'Public'
+    COMMENT 'Shared icons for all modules';
+```
+
+### Collection with images
+
+```sql
+CREATE IMAGE COLLECTION MyModule.NavigationIcons (
+    IMAGE 'home' FROM FILE 'assets/home.png',
+    IMAGE 'settings' FROM FILE 'assets/settings.svg',
+    IMAGE 'profile' FROM FILE 'assets/profile.png'
+);
+```
+
+### All options combined
+
+```sql
+CREATE IMAGE COLLECTION MyModule.BrandAssets
+    EXPORT LEVEL 'Public'
+    COMMENT 'Company branding assets' (
+    IMAGE 'logo-dark' FROM FILE 'assets/logo-dark.png',
+    IMAGE 'logo-light' FROM FILE 'assets/logo-light.png'
+);
+```
+
+## See Also
+
+[DROP IMAGE COLLECTION](drop-image-collection.md), [SHOW / DESCRIBE IMAGE COLLECTION](show-describe-image-collection.md)

docs-site/src/reference/image-collection/drop-image-collection.md

@@ -0,0 +1,31 @@
+# DROP IMAGE COLLECTION
+
+## Synopsis
+
+    DROP IMAGE COLLECTION module.name;
+
+## Description
+
+Removes an image collection and all its embedded images from the module.
+
+## Parameters
+
+**module.name**
+: The qualified name of the collection to drop (e.g., `MyModule.AppIcons`).
+
+## Examples
+
+```sql
+DROP IMAGE COLLECTION MyModule.StatusIcons;
+```
+
+### Check references before dropping
+
+```sql
+SHOW REFERENCES TO MyModule.AppIcons;
+DROP IMAGE COLLECTION MyModule.AppIcons;
+```
+
+## See Also
+
+[CREATE IMAGE COLLECTION](create-image-collection.md), [SHOW / DESCRIBE IMAGE COLLECTION](show-describe-image-collection.md)

docs-site/src/reference/image-collection/show-describe-image-collection.md

@@ -0,0 +1,47 @@
+# SHOW / DESCRIBE IMAGE COLLECTION
+
+## Synopsis
+
+    SHOW IMAGE COLLECTION;
+    SHOW IMAGE COLLECTION IN module;
+    DESCRIBE IMAGE COLLECTION module.name;
+
+## Description
+
+`SHOW IMAGE COLLECTION` lists all image collections in the project, optionally filtered by module. `DESCRIBE IMAGE COLLECTION` shows the full definition of a specific collection, including its images as a re-executable `CREATE` statement.
+
+In the TUI, images are rendered inline when the terminal supports it (Kitty, iTerm2, Sixel).
+
+## Parameters
+
+**IN module**
+: Filters the listing to a single module.
+
+**module.name**
+: The qualified name of the collection to describe (e.g., `MyModule.AppIcons`).
+
+## Examples
+
+### List all image collections
+
+```sql
+SHOW IMAGE COLLECTION;
+```
+
+### Filter by module
+
+```sql
+SHOW IMAGE COLLECTION IN MyModule;
+```
+
+### View full definition
+
+```sql
+DESCRIBE IMAGE COLLECTION MyModule.AppIcons;
+```
+
+The output includes the complete `CREATE` statement with all `IMAGE ... FROM FILE` entries, which can be copied and re-executed.
+
+## See Also
+
+[CREATE IMAGE COLLECTION](create-image-collection.md), [DROP IMAGE COLLECTION](drop-image-collection.md)

docs-site/src/reference/query/show-image-collection.md

@@ -0,0 +1,39 @@
+# SHOW IMAGE COLLECTION
+
+## Synopsis
+
+    SHOW IMAGE COLLECTION;
+    SHOW IMAGE COLLECTION IN module;
+
+## Description
+
+Lists all image collections in the project. Use `IN module` to filter to a specific module. For full details including embedded images, use `DESCRIBE IMAGE COLLECTION`.
+
+## Parameters
+
+**IN module**
+: Optional. Restricts the listing to collections in the specified module.
+
+## Examples
+
+### List all collections
+
+```sql
+SHOW IMAGE COLLECTION;
+```
+
+### Filter by module
+
+```sql
+SHOW IMAGE COLLECTION IN MyModule;
+```
+
+### Describe a specific collection
+
+```sql
+DESCRIBE IMAGE COLLECTION MyModule.AppIcons;
+```
+
+## See Also
+
+[DESCRIBE IMAGE COLLECTION](../image-collection/show-describe-image-collection.md), [CREATE IMAGE COLLECTION](../image-collection/create-image-collection.md), [SHOW MODULES](show-modules.md)