markform 0.1.3 → 0.1.4

package/examples/movie-research/movie-research-basic.form.md

@@ -36,7 +36,7 @@ Standard research form for gathering ratings and key statistics for any film. Pu
 
 {% field-group id="movie_input" title="Movie Identification" %}
 
-{% string-field id="movie" label="Movie" role="user" required=true minLength=1 maxLength=300 %}{% /string-field %}
+{% field kind="string" id="movie" label="Movie" role="user" required=true minLength=1 maxLength=300 %}{% /field %}
 
 {% instructions ref="movie" %}
 Enter the movie title (add any details to help identify, like "Barbie 2023" or "the Batman movie with Robert Pattinson")
@@ -46,7 +46,7 @@ Enter the movie title (add any details to help identify, like "Barbie 2023" or "
 
 {% field-group id="title_identification" title="Title Identification" %}
 
-{% string-field id="full_title" label="Full Title" role="agent" required=true %}{% /string-field %}
+{% field kind="string" id="full_title" label="Full Title" role="agent" required=true %}{% /field %}
 
 {% instructions ref="full_title" %}
 Look up what film the user had in mind and fill in the official title including subtitle if any (e.g., "The Lord of the Rings: The Fellowship of the Ring").
@@ -56,19 +56,19 @@ Look up what film the user had in mind and fill in the official title including
 
 {% field-group id="sources" title="Sources" %}
 
-{% url-field id="imdb_url" label="IMDB URL" role="agent" required=true %}{% /url-field %}
+{% field kind="url" id="imdb_url" label="IMDB URL" role="agent" required=true %}{% /field %}
 
 {% instructions ref="imdb_url" %}
 Direct link to the movie's IMDB page (e.g., https://www.imdb.com/title/tt0111161/).
 {% /instructions %}
 
-{% url-field id="rt_url" label="Rotten Tomatoes URL" role="agent" %}{% /url-field %}
+{% field kind="url" id="rt_url" label="Rotten Tomatoes URL" role="agent" %}{% /field %}
 
 {% instructions ref="rt_url" %}
 Direct link to the movie's Rotten Tomatoes page.
 {% /instructions %}
 
-{% url-field id="metacritic_url" label="Metacritic URL" role="agent" %}{% /url-field %}
+{% field kind="url" id="metacritic_url" label="Metacritic URL" role="agent" %}{% /field %}
 
 {% instructions ref="metacritic_url" %}
 Direct link to the movie's Metacritic page.
@@ -78,36 +78,36 @@ Direct link to the movie's Metacritic page.
 
 {% field-group id="basic_details" title="Basic Details" %}
 
-{% number-field id="year" label="Release Year" role="agent" required=true min=1888 max=2030 %}{% /number-field %}
+{% field kind="number" id="year" label="Release Year" role="agent" required=true min=1888 max=2030 %}{% /field %}
 
-{% string-list id="directors" label="Director(s)" role="agent" required=true %}{% /string-list %}
+{% field kind="string_list" id="directors" label="Director(s)" role="agent" required=true %}{% /field %}
 
 {% instructions ref="directors" %}
 One director per line. Most films have one; some have two or more co-directors.
 {% /instructions %}
 
-{% number-field id="runtime_minutes" label="Runtime (minutes)" role="agent" min=1 max=1000 %}{% /number-field %}
+{% field kind="number" id="runtime_minutes" label="Runtime (minutes)" role="agent" min=1 max=1000 %}{% /field %}
 
-{% single-select id="mpaa_rating" label="MPAA Rating" role="agent" %}
+{% field kind="single_select" id="mpaa_rating" label="MPAA Rating" role="agent" %}
 - [ ] G {% #g %}
 - [ ] PG {% #pg %}
 - [ ] PG-13 {% #pg_13 %}
 - [ ] R {% #r %}
 - [ ] NC-17 {% #nc_17 %}
 - [ ] NR/Unrated {% #nr %}
-{% /single-select %}
+{% /field %}
 
 {% /field-group %}
 
 {% field-group id="imdb_ratings" title="IMDB Ratings" %}
 
-{% number-field id="imdb_rating" label="IMDB Rating" role="agent" min=1.0 max=10.0 %}{% /number-field %}
+{% field kind="number" id="imdb_rating" label="IMDB Rating" role="agent" min=1.0 max=10.0 %}{% /field %}
 
 {% instructions ref="imdb_rating" %}
 IMDB user rating (1.0-10.0 scale).
 {% /instructions %}
 
-{% number-field id="imdb_votes" label="IMDB Vote Count" role="agent" min=0 %}{% /number-field %}
+{% field kind="number" id="imdb_votes" label="IMDB Vote Count" role="agent" min=0 %}{% /field %}
 
 {% instructions ref="imdb_votes" %}
 Number of IMDB user votes (e.g., 2800000 for a popular film).
@@ -117,15 +117,15 @@ Number of IMDB user votes (e.g., 2800000 for a popular film).
 
 {% field-group id="rotten_tomatoes_ratings" title="Rotten Tomatoes Ratings" %}
 
-{% number-field id="rt_critics_score" label="Tomatometer (Critics)" role="agent" min=0 max=100 %}{% /number-field %}
+{% field kind="number" id="rt_critics_score" label="Tomatometer (Critics)" role="agent" min=0 max=100 %}{% /field %}
 
 {% instructions ref="rt_critics_score" %}
 Tomatometer percentage (0-100).
 {% /instructions %}
 
-{% number-field id="rt_critics_count" label="Critics Review Count" role="agent" min=0 %}{% /number-field %}
+{% field kind="number" id="rt_critics_count" label="Critics Review Count" role="agent" min=0 %}{% /field %}
 
-{% number-field id="rt_audience_score" label="Audience Score" role="agent" min=0 max=100 %}{% /number-field %}
+{% field kind="number" id="rt_audience_score" label="Audience Score" role="agent" min=0 max=100 %}{% /field %}
 
 {% instructions ref="rt_audience_score" %}
 Audience Score percentage (0-100).
@@ -135,7 +135,7 @@ Audience Score percentage (0-100).
 
 {% field-group id="metacritic_ratings" title="Metacritic Ratings" %}
 
-{% number-field id="metacritic_score" label="Metacritic Score" role="agent" min=0 max=100 %}{% /number-field %}
+{% field kind="number" id="metacritic_score" label="Metacritic Score" role="agent" min=0 max=100 %}{% /field %}
 
 {% instructions ref="metacritic_score" %}
 Metascore (0-100 scale). Leave empty if not available.
@@ -145,18 +145,22 @@ Metascore (0-100 scale). Leave empty if not available.
 
 {% field-group id="summary" title="Summary" %}
 
-{% string-field id="logline" label="One-Line Summary" role="agent" maxLength=300 %}{% /string-field %}
+{% field kind="string" id="logline" label="One-Line Summary" role="agent" maxLength=300 %}{% /field %}
 
 {% instructions ref="logline" %}
 Brief plot summary in 1-2 sentences, no spoilers.
 {% /instructions %}
 
-{% string-list id="notable_awards" label="Notable Awards" role="agent" %}{% /string-list %}
+{% field kind="table" id="notable_awards" label="Notable Awards" role="agent"
+   columnIds=["award", "category", "year"]
+   columnTypes=["string", "string", "year"] %}
+| Award | Category | Year |
+|-------|----------|------|
+{% /field %}
 
 {% instructions ref="notable_awards" %}
-Major awards won. One per line.
-Format: Award | Category | Year
-Example: "Oscar | Best Picture | 1995"
+Major awards won.
+Example: Oscar | Best Picture | 1995
 {% /instructions %}
 
 {% /field-group %}

package/examples/movie-research/movie-research-deep.form.md

@@ -47,7 +47,7 @@ Comprehensive movie research covering ratings from multiple sources, box office
 
 {% field-group id="movie_input" title="Movie Identification" %}
 
-{% string-field id="movie" label="Movie" role="user" required=true minLength=1 maxLength=300 %}{% /string-field %}
+{% field kind="string" id="movie" label="Movie" role="user" required=true minLength=1 maxLength=300 %}{% /field %}
 
 {% instructions ref="movie" %}
 Enter the movie title (add any details to help identify, like "Barbie 2023" or "the Batman movie with Robert Pattinson").
@@ -59,13 +59,13 @@ Enter the movie title (add any details to help identify, like "Barbie 2023" or "
 
 {% field-group id="title_identification" title="Title Identification" %}
 
-{% string-field id="full_title" label="Full Title" role="agent" required=true %}{% /string-field %}
+{% field kind="string" id="full_title" label="Full Title" role="agent" required=true %}{% /field %}
 
 {% instructions ref="full_title" %}
 Official title including subtitle if any (e.g., "The Lord of the Rings: The Fellowship of the Ring").
 {% /instructions %}
 
-{% number-field id="year" label="Release Year" role="agent" required=true min=1888 max=2030 %}{% /number-field %}
+{% field kind="number" id="year" label="Release Year" role="agent" required=true min=1888 max=2030 %}{% /field %}
 
 {% /field-group %}
 
@@ -73,20 +73,20 @@ Official title including subtitle if any (e.g., "The Lord of the Rings: The Fell
 
 {% field-group id="primary_sources" title="Primary Sources" %}
 
-{% url-field id="imdb_url" label="IMDB URL" role="agent" required=true %}{% /url-field %}
+{% field kind="url" id="imdb_url" label="IMDB URL" role="agent" required=true %}{% /field %}
 
 {% instructions ref="imdb_url" %}
 Required. Primary source for ratings, cast, crew, technical details.
 Format: https://www.imdb.com/title/tt0111161/
 {% /instructions %}
 
-{% url-field id="rt_url" label="Rotten Tomatoes URL" role="agent" %}{% /url-field %}
+{% field kind="url" id="rt_url" label="Rotten Tomatoes URL" role="agent" %}{% /field %}
 
 {% instructions ref="rt_url" %}
 Direct link to the movie's Rotten Tomatoes page.
 {% /instructions %}
 
-{% url-field id="metacritic_url" label="Metacritic URL" role="agent" %}{% /url-field %}
+{% field kind="url" id="metacritic_url" label="Metacritic URL" role="agent" %}{% /field %}
 
 {% instructions ref="metacritic_url" %}
 Direct link to the movie's Metacritic page.
@@ -96,14 +96,14 @@ Direct link to the movie's Metacritic page.
 
 {% field-group id="box_office_sources" title="Box Office Sources" %}
 
-{% url-field id="boxofficemojo_url" label="Box Office Mojo URL" role="agent" %}{% /url-field %}
+{% field kind="url" id="boxofficemojo_url" label="Box Office Mojo URL" role="agent" %}{% /field %}
 
 {% instructions ref="boxofficemojo_url" %}
 Best source for budget, domestic/worldwide gross, opening weekend.
 Format: https://www.boxofficemojo.com/title/tt0111161/
 {% /instructions %}
 
-{% url-field id="the_numbers_url" label="The Numbers URL" role="agent" %}{% /url-field %}
+{% field kind="url" id="the_numbers_url" label="The Numbers URL" role="agent" %}{% /field %}
 
 {% instructions ref="the_numbers_url" %}
 Alternative/supplementary box office data and profitability analysis.
@@ -113,7 +113,7 @@ Alternative/supplementary box office data and profitability analysis.
 
 {% field-group id="availability_sources" title="Availability Sources" %}
 
-{% url-field id="justwatch_url" label="JustWatch URL" role="agent" %}{% /url-field %}
+{% field kind="url" id="justwatch_url" label="JustWatch URL" role="agent" %}{% /field %}
 
 {% instructions ref="justwatch_url" %}
 Best source for current streaming availability. Use US region.
@@ -124,19 +124,19 @@ Format: https://www.justwatch.com/us/movie/the-shawshank-redemption
 
 {% field-group id="additional_sources" title="Additional Sources" %}
 
-{% url-field id="letterboxd_url" label="Letterboxd URL" role="agent" %}{% /url-field %}
+{% field kind="url" id="letterboxd_url" label="Letterboxd URL" role="agent" %}{% /field %}
 
 {% instructions ref="letterboxd_url" %}
 Cinephile community ratings. Especially useful for art/indie/cult films.
 {% /instructions %}
 
-{% url-field id="wikipedia_url" label="Wikipedia URL" role="agent" %}{% /url-field %}
+{% field kind="url" id="wikipedia_url" label="Wikipedia URL" role="agent" %}{% /field %}
 
 {% instructions ref="wikipedia_url" %}
 For production history, cultural impact, comprehensive awards list.
 {% /instructions %}
 
-{% url-field id="official_site_url" label="Official Website" role="agent" %}{% /url-field %}
+{% field kind="url" id="official_site_url" label="Official Website" role="agent" %}{% /field %}
 
 {% instructions ref="official_site_url" %}
 Studio or film's official website, if still active.
@@ -148,24 +148,24 @@ Studio or film's official website, if still active.
 
 {% field-group id="basic_details" title="Basic Details" %}
 
-{% string-list id="directors" label="Director(s)" role="agent" required=true %}{% /string-list %}
+{% field kind="string_list" id="directors" label="Director(s)" role="agent" required=true %}{% /field %}
 
 {% instructions ref="directors" %}
 One director per line. Most films have one; some have two or more co-directors.
 {% /instructions %}
 
-{% number-field id="runtime_minutes" label="Runtime (minutes)" role="agent" min=1 max=1000 %}{% /number-field %}
+{% field kind="number" id="runtime_minutes" label="Runtime (minutes)" role="agent" min=1 max=1000 %}{% /field %}
 
-{% single-select id="mpaa_rating" label="MPAA Rating" role="agent" %}
+{% field kind="single_select" id="mpaa_rating" label="MPAA Rating" role="agent" %}
 - [ ] G {% #g %}
 - [ ] PG {% #pg %}
 - [ ] PG-13 {% #pg_13 %}
 - [ ] R {% #r %}
 - [ ] NC-17 {% #nc_17 %}
 - [ ] NR/Unrated {% #nr %}
-{% /single-select %}
+{% /field %}
 
-{% multi-select id="genres" label="Genres" role="agent" minSelections=1 maxSelections=5 %}
+{% field kind="multi_select" id="genres" label="Genres" role="agent" minSelections=1 maxSelections=5 %}
 - [ ] Action {% #action %}
 - [ ] Adventure {% #adventure %}
 - [ ] Animation {% #animation %}
@@ -188,15 +188,15 @@ One director per line. Most films have one; some have two or more co-directors.
 - [ ] Thriller {% #thriller %}
 - [ ] War {% #war %}
 - [ ] Western {% #western %}
-{% /multi-select %}
+{% /field %}
 
 {% instructions ref="genres" %}
 Select all applicable genres from IMDB (up to 5).
 {% /instructions %}
 
-{% string-field id="original_language" label="Original Language" role="agent" %}{% /string-field %}
+{% field kind="string" id="original_language" label="Original Language" role="agent" %}{% /field %}
 
-{% string-list id="countries" label="Countries" role="agent" %}{% /string-list %}
+{% field kind="string_list" id="countries" label="Countries" role="agent" %}{% /field %}
 
 {% instructions ref="countries" %}
 Production countries, one per line.
@@ -208,15 +208,19 @@ Production countries, one per line.
 
 {% field-group id="cast_crew" title="Cast & Crew" %}
 
-{% string-list id="lead_cast" label="Lead Cast" role="agent" minItems=1 maxItems=10 %}{% /string-list %}
+{% field kind="table" id="lead_cast" label="Lead Cast" role="agent" minRows=1 maxRows=10
+   columnIds=["actor_name", "character_name"]
+   columnTypes=["string", "string"] %}
+| Actor Name | Character Name |
+|------------|----------------|
+{% /field %}
 
 {% instructions ref="lead_cast" %}
 Top-billed cast members with their character names.
-Format: Actor Name | Character Name
-Example: "Leonardo DiCaprio | Dom Cobb"
+Example: Leonardo DiCaprio | Dom Cobb
 {% /instructions %}
 
-{% string-list id="writers" label="Writers" role="agent" %}{% /string-list %}
+{% field kind="string_list" id="writers" label="Writers" role="agent" %}{% /field %}
 
 {% instructions ref="writers" %}
 Screenplay and story credits.
@@ -224,15 +228,15 @@ Format: Name (credit type)
 Example: "Christopher Nolan (written by)"
 {% /instructions %}
 
-{% string-field id="cinematographer" label="Cinematographer" role="agent" %}{% /string-field %}
+{% field kind="string" id="cinematographer" label="Cinematographer" role="agent" %}{% /field %}
 
-{% string-field id="composer" label="Composer" role="agent" %}{% /string-field %}
+{% field kind="string" id="composer" label="Composer" role="agent" %}{% /field %}
 
 {% instructions ref="composer" %}
 Film score composer (not soundtrack songs).
 {% /instructions %}
 
-{% string-list id="producers" label="Producers" role="agent" maxItems=5 %}{% /string-list %}
+{% field kind="string_list" id="producers" label="Producers" role="agent" maxItems=5 %}{% /field %}
 
 {% instructions ref="producers" %}
 Key producers (limit to main credited producers).
@@ -246,13 +250,13 @@ Example: "Emma Thomas (producer)"
 
 {% field-group id="imdb_ratings" title="IMDB Ratings" %}
 
-{% number-field id="imdb_rating" label="IMDB Rating" role="agent" min=1.0 max=10.0 %}{% /number-field %}
+{% field kind="number" id="imdb_rating" label="IMDB Rating" role="agent" min=1.0 max=10.0 %}{% /field %}
 
 {% instructions ref="imdb_rating" %}
 IMDB user rating (1.0-10.0 scale).
 {% /instructions %}
 
-{% number-field id="imdb_votes" label="IMDB Vote Count" role="agent" min=0 %}{% /number-field %}
+{% field kind="number" id="imdb_votes" label="IMDB Vote Count" role="agent" min=0 %}{% /field %}
 
 {% instructions ref="imdb_votes" %}
 Number of IMDB user votes (e.g., 2800000 for a popular film).
@@ -262,21 +266,21 @@ Number of IMDB user votes (e.g., 2800000 for a popular film).
 
 {% field-group id="rotten_tomatoes_ratings" title="Rotten Tomatoes Ratings" %}
 
-{% number-field id="rt_critics_score" label="Tomatometer (Critics)" role="agent" min=0 max=100 %}{% /number-field %}
+{% field kind="number" id="rt_critics_score" label="Tomatometer (Critics)" role="agent" min=0 max=100 %}{% /field %}
 
 {% instructions ref="rt_critics_score" %}
 Tomatometer percentage (0-100).
 {% /instructions %}
 
-{% number-field id="rt_critics_count" label="Critics Review Count" role="agent" min=0 %}{% /number-field %}
+{% field kind="number" id="rt_critics_count" label="Critics Review Count" role="agent" min=0 %}{% /field %}
 
-{% number-field id="rt_audience_score" label="Audience Score" role="agent" min=0 max=100 %}{% /number-field %}
+{% field kind="number" id="rt_audience_score" label="Audience Score" role="agent" min=0 max=100 %}{% /field %}
 
 {% instructions ref="rt_audience_score" %}
 Audience Score percentage (0-100).
 {% /instructions %}
 
-{% string-field id="rt_consensus" label="Critics Consensus" role="agent" maxLength=500 %}{% /string-field %}
+{% field kind="string" id="rt_consensus" label="Critics Consensus" role="agent" maxLength=500 %}{% /field %}
 
 {% instructions ref="rt_consensus" %}
 The official Rotten Tomatoes critics consensus statement, if available.
@@ -286,7 +290,7 @@ The official Rotten Tomatoes critics consensus statement, if available.
 
 {% field-group id="metacritic_ratings" title="Metacritic Ratings" %}
 
-{% number-field id="metacritic_score" label="Metacritic Score" role="agent" min=0 max=100 %}{% /number-field %}
+{% field kind="number" id="metacritic_score" label="Metacritic Score" role="agent" min=0 max=100 %}{% /field %}
 
 {% instructions ref="metacritic_score" %}
 Metascore (0-100 scale). Leave empty if not available.
@@ -296,13 +300,13 @@ Metascore (0-100 scale). Leave empty if not available.
 
 {% field-group id="additional_ratings" title="Additional Ratings" %}
 
-{% number-field id="letterboxd_rating" label="Letterboxd Rating" role="agent" min=0.5 max=5.0 %}{% /number-field %}
+{% field kind="number" id="letterboxd_rating" label="Letterboxd Rating" role="agent" min=0.5 max=5.0 %}{% /field %}
 
 {% instructions ref="letterboxd_rating" %}
 Letterboxd average rating (0.5-5.0 scale, in 0.1 increments).
 {% /instructions %}
 
-{% string-field id="cinemascore" label="CinemaScore Grade" role="agent" pattern="^[A-F][+-]?$" %}{% /string-field %}
+{% field kind="string" id="cinemascore" label="CinemaScore Grade" role="agent" pattern="^[A-F][+-]?$" %}{% /field %}
 
 {% instructions ref="cinemascore" %}
 Opening weekend audience grade (A+ to F). Only available for theatrical releases.
@@ -314,25 +318,25 @@ Opening weekend audience grade (A+ to F). Only available for theatrical releases
 
 {% field-group id="box_office" title="Box Office" %}
 
-{% number-field id="budget_millions" label="Budget ($M)" role="agent" min=0 %}{% /number-field %}
+{% field kind="number" id="budget_millions" label="Budget ($M)" role="agent" min=0 %}{% /field %}
 
 {% instructions ref="budget_millions" %}
 Production budget in millions USD. Example: 200 for $200M.
 {% /instructions %}
 
-{% number-field id="box_office_domestic_millions" label="Domestic Gross ($M)" role="agent" min=0 %}{% /number-field %}
+{% field kind="number" id="box_office_domestic_millions" label="Domestic Gross ($M)" role="agent" min=0 %}{% /field %}
 
 {% instructions ref="box_office_domestic_millions" %}
 US/Canada theatrical gross in millions USD.
 {% /instructions %}
 
-{% number-field id="box_office_worldwide_millions" label="Worldwide Gross ($M)" role="agent" min=0 %}{% /number-field %}
+{% field kind="number" id="box_office_worldwide_millions" label="Worldwide Gross ($M)" role="agent" min=0 %}{% /field %}
 
 {% instructions ref="box_office_worldwide_millions" %}
 Global theatrical gross in millions USD.
 {% /instructions %}
 
-{% number-field id="opening_weekend_millions" label="Opening Weekend ($M)" role="agent" min=0 %}{% /number-field %}
+{% field kind="number" id="opening_weekend_millions" label="Opening Weekend ($M)" role="agent" min=0 %}{% /field %}
 
 {% instructions ref="opening_weekend_millions" %}
 US opening weekend gross in millions USD.
@@ -344,7 +348,7 @@ US opening weekend gross in millions USD.
 
 {% field-group id="technical_specs" title="Technical Specifications" %}
 
-{% single-select id="aspect_ratio" label="Aspect Ratio" role="agent" %}
+{% field kind="single_select" id="aspect_ratio" label="Aspect Ratio" role="agent" %}
 - [ ] 1.33:1 (Academy) {% #ratio_133 %}
 - [ ] 1.66:1 {% #ratio_166 %}
 - [ ] 1.78:1 (16:9) {% #ratio_178 %}
@@ -357,21 +361,21 @@ US opening weekend gross in millions USD.
 - [ ] 1.43:1 (IMAX) {% #ratio_143 %}
 - [ ] 1.90:1 (IMAX Digital) {% #ratio_190 %}
 - [ ] Variable {% #ratio_variable %}
-{% /single-select %}
+{% /field %}
 
-{% single-select id="color_format" label="Color" role="agent" %}
+{% field kind="single_select" id="color_format" label="Color" role="agent" %}
 - [ ] Color {% #color %}
 - [ ] Black & White {% #bw %}
 - [ ] Mixed/Partial Color {% #mixed %}
-{% /single-select %}
+{% /field %}
 
-{% string-field id="sound_mix" label="Sound Mix" role="agent" %}{% /string-field %}
+{% field kind="string" id="sound_mix" label="Sound Mix" role="agent" %}{% /field %}
 
 {% instructions ref="sound_mix" %}
 Primary sound format (e.g., "Dolby Atmos", "DTS", "Dolby Digital").
 {% /instructions %}
 
-{% string-field id="camera" label="Camera" role="agent" %}{% /string-field %}
+{% field kind="string" id="camera" label="Camera" role="agent" %}{% /field %}
 
 {% instructions ref="camera" %}
 Primary camera system used (e.g., "Arri Alexa 65", "IMAX 15-perf", "Panavision Panaflex").
@@ -383,7 +387,7 @@ Primary camera system used (e.g., "Arri Alexa 65", "IMAX 15-perf", "Panavision P
 
 {% field-group id="streaming_availability" title="Streaming Availability (US)" %}
 
-{% multi-select id="streaming_subscription" label="Streaming (Subscription)" role="agent" %}
+{% field kind="multi_select" id="streaming_subscription" label="Streaming (Subscription)" role="agent" %}
 - [ ] Netflix {% #netflix %}
 - [ ] Amazon Prime Video {% #prime %}
 - [ ] Disney+ {% #disney %}
@@ -397,18 +401,18 @@ Primary camera system used (e.g., "Arri Alexa 65", "IMAX 15-perf", "Panavision P
 - [ ] MUBI {% #mubi %}
 - [ ] Tubi (Free) {% #tubi %}
 - [ ] Pluto TV (Free) {% #pluto %}
-{% /multi-select %}
+{% /field %}
 
 {% instructions ref="streaming_subscription" %}
 Select all platforms where this film is currently available to stream (subscription or free). Check JustWatch for current availability.
 {% /instructions %}
 
-{% checkboxes id="availability_flags" label="Other Availability" role="agent" checkboxMode="simple" %}
+{% field kind="checkboxes" id="availability_flags" label="Other Availability" role="agent" checkboxMode="simple" %}
 - [ ] Available for digital rental {% #rental %}
 - [ ] Available for digital purchase {% #purchase %}
 - [ ] Physical media (Blu-ray/DVD) {% #physical %}
 - [ ] 4K UHD available {% #uhd_4k %}
-{% /checkboxes %}
+{% /field %}
 
 {% /field-group %}
 
@@ -416,7 +420,7 @@ Select all platforms where this film is currently available to stream (subscript
 
 {% field-group id="content_themes" title="Content & Themes" %}
 
-{% checkboxes id="content_warnings" label="Content Warnings" role="agent" checkboxMode="simple" %}
+{% field kind="checkboxes" id="content_warnings" label="Content Warnings" role="agent" checkboxMode="simple" %}
 - [ ] Intense violence {% #violence %}
 - [ ] Gore/disturbing imagery {% #gore %}
 - [ ] Sexual content {% #sexual %}
@@ -425,13 +429,13 @@ Select all platforms where this film is currently available to stream (subscript
 - [ ] Drug/alcohol use {% #drugs %}
 - [ ] Frightening scenes {% #frightening %}
 - [ ] Flashing/strobe effects {% #flashing %}
-{% /checkboxes %}
+{% /field %}
 
 {% instructions ref="content_warnings" %}
 Check any content warnings that apply. Use IMDB Parents Guide as reference.
 {% /instructions %}
 
-{% string-list id="themes" label="Key Themes" role="agent" maxItems=5 %}{% /string-list %}
+{% field kind="string_list" id="themes" label="Key Themes" role="agent" maxItems=5 %}{% /field %}
 
 {% instructions ref="themes" %}
 Major themes explored in the film (e.g., "redemption", "family", "identity", "war").
@@ -443,39 +447,47 @@ Major themes explored in the film (e.g., "redemption", "family", "identity", "wa
 
 {% field-group id="summary" title="Summary" %}
 
-{% string-field id="logline" label="One-Line Summary" role="agent" maxLength=300 %}{% /string-field %}
+{% field kind="string" id="logline" label="One-Line Summary" role="agent" maxLength=300 %}{% /field %}
 
 {% instructions ref="logline" %}
 Brief plot summary in 1-2 sentences, no spoilers.
 {% /instructions %}
 
-{% string-list id="notable_awards" label="Notable Awards" role="agent" %}{% /string-list %}
+{% field kind="table" id="notable_awards" label="Notable Awards" role="agent"
+   columnIds=["award", "category", "year"]
+   columnTypes=["string", "string", "year"] %}
+| Award | Category | Year |
+|-------|----------|------|
+{% /field %}
 
 {% instructions ref="notable_awards" %}
-Major awards won. One per line.
-Format: Award | Category | Year
-Example: "Oscar | Best Picture | 1995"
+Major awards won.
+Example: Oscar | Best Picture | 1995
 {% /instructions %}
 
-{% string-list id="notable_quotes" label="Notable Critic Quotes" role="agent" maxItems=3 %}{% /string-list %}
+{% field kind="table" id="notable_quotes" label="Notable Critic Quotes" role="agent" maxRows=3
+   columnIds=["quote", "critic", "publication"]
+   columnTypes=["string", "string", "string"] %}
+| Quote | Critic | Publication |
+|-------|--------|-------------|
+{% /field %}
 
 {% instructions ref="notable_quotes" %}
 2-3 memorable critic quotes that capture reception.
-Format: "Quote" - Critic, Publication
 {% /instructions %}
 
 {% /field-group %}
 
 {% field-group id="cultural_legacy" title="Cultural Legacy" %}
 
-{% string-field id="cultural_impact" label="Cultural Impact" role="agent" maxLength=500 %}{% /string-field %}
+{% field kind="string" id="cultural_impact" label="Cultural Impact" role="agent" maxLength=500 %}{% /field %}
 
 {% instructions ref="cultural_impact" %}
 Brief description of the film's cultural significance, influence, or legacy (1-3 sentences).
 Leave empty for recent releases without established legacy.
 {% /instructions %}
 
-{% string-list id="similar_films" label="Similar Films" role="agent" maxItems=5 %}{% /string-list %}
+{% field kind="string_list" id="similar_films" label="Similar Films" role="agent" maxItems=5 %}{% /field %}
 
 {% instructions ref="similar_films" %}
 Films with similar themes, style, or appeal. One per line.

package/examples/movie-research/movie-research-minimal.form.md

@@ -14,39 +14,53 @@ markform:
 ---
 {% form id="movie_research_minimal" title="Movie Research (Minimal)" %}
 
-<!-- The first field group is filled in by the user (role="user"): -->
+## Movie Research Example
 
 {% field-group id="movie_input" title="Movie Identification" %}
 
-{% string-field id="movie" label="Movie" role="user" required=true minLength=1 maxLength=300 %}{% /string-field %}
+What movie do you want to research? \[*This field is filled in by the user (`role="user"`).*\]
+
+{% field kind="string" id="movie" label="Movie" role="user" required=true minLength=1 maxLength=300 %}{% /field %}
 {% instructions ref="movie" %}Enter the movie title (add year or details for disambiguation).{% /instructions %}
 
 {% /field-group %}
 
-<!-- Everything else is filled in by the agent (role="agent"): -->
+## About the Movie
 
 {% field-group id="about_the_movie" title="About the Movie" %}
 
-{% string-field id="full_title" label="Full Title" role="agent" required=true %}{% /string-field %}
-{% instructions ref="full_title" %}Official title including subtitle if any.{% /instructions %}
+**Title:**
+
+{% field kind="string" id="full_title" label="Full Title" role="agent" required=true %}{% /field %}
+{% instructions ref="full_title" %}Official title, including subtitle if any.{% /instructions %}
+
+**Release year:**
+
+{% field kind="number" id="year" label="Release Year" role="agent" required=true min=1888 max=2030 %}{% /field %}
 
-{% number-field id="year" label="Release Year" role="agent" required=true min=1888 max=2030 %}{% /number-field %}
+**IMDB:**
 
-{% url-field id="imdb_url" label="IMDB URL" role="agent" required=true %}{% /url-field %}
+{% field kind="url" id="imdb_url" label="IMDB URL" role="agent" required=true %}{% /field %}
 
-{% single-select id="mpaa_rating" label="MPAA Rating" role="agent" %}
+**MPAA rating:**
+
+{% field kind="single_select" id="mpaa_rating" label="MPAA Rating" role="agent" %}
 - [ ] G {% #g %}
 - [ ] PG {% #pg %}
 - [ ] PG-13 {% #pg_13 %}
 - [ ] R {% #r %}
 - [ ] NC-17 {% #nc_17 %}
 - [ ] NR/Unrated {% #nr %}
-{% /single-select %}
+{% /field %}
+
+**IMDB rating:**
 
-{% number-field id="imdb_rating" label="IMDB Rating" role="agent" min=1.0 max=10.0 %}{% /number-field %}
+{% field kind="number" id="imdb_rating" label="IMDB Rating" role="agent" min=1.0 max=10.0 %}{% /field %}
 {% instructions ref="imdb_rating" %}IMDB user rating (1.0-10.0 scale).{% /instructions %}
 
-{% string-field id="logline" label="One-Line Summary" role="agent" maxLength=300 %}{% /string-field %}
+**Summary:**
+
+{% field kind="string" id="logline" label="One-Line Summary" role="agent" maxLength=300 %}{% /field %}
 {% instructions ref="logline" %}Brief plot summary in 1-2 sentences, no spoilers.{% /instructions %}
 
 {% /field-group %}