diff --git a/packages/json_script_example/README.md b/packages/json_script_example/README.md
index e1b824fe0..cd3e6c63d 100644
--- a/packages/json_script_example/README.md
+++ b/packages/json_script_example/README.md
@@ -13,10 +13,19 @@ All functions in this package are defined in `seed/script.json` and executed via
 ```
 json_script_example/
 ├── README.md                    # This file
+├── MODULES.md                   # Import/export guide
 ├── seed/
 │   ├── metadata.json            # Package configuration
-│   ├── script.json              # All functions defined in JSON
+│   ├── script.json              # Main example functions
+│   ├── math_utils.json          # Math utility module
+│   ├── validation.json          # Validation module
+│   ├── combined_example.json    # Multi-module example
+│   ├── types.json               # TypeScript-style type definitions
 │   └── styles.json              # Design tokens
+├── tests/
+│   ├── README.md                # Testing guide
+│   ├── math.test.logic.json     # Test assertion functions
+│   └── math.test.parameters.json # Test data by category
 └── static_content/
     └── icon.svg                 # Package icon
 ```
diff --git a/packages/json_script_example/seed/metadata.json b/packages/json_script_example/seed/metadata.json
index 04856c2ab..a35490bda 100644
--- a/packages/json_script_example/seed/metadata.json
+++ b/packages/json_script_example/seed/metadata.json
@@ -47,7 +47,8 @@
     }
   },
   "seed": {
-    "styles": "seed/styles.json"
+    "styles": "seed/styles.json",
+    "types": "seed/types.json"
   },
   "storybook": {
     "stories": [