@crombolo/cli 0.0.0-stage → 0.9.1

package/templates/demo/harbourstone/files/schema/content-types/contact-page.toml

@@ -0,0 +1,75 @@
+# A page type of its own rather than another `contentPage`: the layout is a form
+# beside an address panel, which is a different thing from prose with a picture,
+# and branching one template on which properties happen to be filled is how a
+# view becomes unreadable.
+[content-type]
+key = "7100a925-a7e5-48a4-ad8e-120fc08cf987"
+alias = "contactPage"
+name = "Contact Page"
+description = "A form and the details beside it"
+icon = "icon-message"
+components = ["pages/contactPage"]
+default-component = "pages/contactPage"
+
+[[tab]]
+name = "Header"
+
+[[tab.property]]
+key = "753d8c52-4949-4e92-a76a-fa02da0fd199"
+alias = "eyebrow"
+name = "Eyebrow"
+type = "textstring"
+
+[[tab.property]]
+key = "1e8f3a9d-5bdf-4a01-a6c7-cc4a055fae22"
+alias = "title"
+name = "Title"
+type = "textstring"
+mandatory = true
+
+[[tab.property]]
+key = "cf4561c0-82bb-4ad5-9f88-bd3fbd210b7c"
+alias = "standfirst"
+name = "Standfirst"
+type = "textarea"
+
+[[tab]]
+name = "Form"
+
+# `formPicker` is seeded with the other built-in data types, so a property can
+# use it with no file of its own. The value is a form's UUID from
+# `schema/forms/`, and the value converter hands the view the definition rather
+# than the key — see `components/contactPage.tsx`.
+[[tab.property]]
+key = "9f2c71b5-5de4-4a6e-9c0a-1b7d84f3a2ce"
+alias = "enquiryForm"
+name = "Form"
+description = "Leave empty for a page that only gives the address."
+type = "formPicker"
+
+[[tab]]
+name = "Details"
+
+[[tab.property]]
+key = "74ad36ef-7bc9-44a5-833b-a5ebbc055198"
+alias = "asideEyebrow"
+name = "Eyebrow"
+type = "textstring"
+
+[[tab.property]]
+key = "f280c253-5a8e-4db2-8cd6-516066061242"
+alias = "asideHeading"
+name = "Heading"
+type = "textstring"
+
+[[tab.property]]
+key = "5611c2fa-720b-447a-9b01-c8e761e738ac"
+alias = "asideBody"
+name = "Address and contact"
+type = "richtext"
+
+[[tab.property]]
+key = "278a95aa-9a7d-47bc-ad09-545104a1a7cd"
+alias = "asideImage"
+name = "Image"
+type = "imageMediaPicker"

package/templates/demo/harbourstone/files/schema/content-types/content-page.toml

@@ -0,0 +1,89 @@
+[content-type]
+key = "086fc24d-2c96-4298-8678-145b38dcc14a"
+alias = "contentPage"
+name = "Content Page"
+description = "A page of prose with an image section and a band of highlights"
+icon = "icon-document"
+allow-children = ["contentPage"]
+components = ["pages/contentPage"]
+default-component = "pages/contentPage"
+
+[[tab]]
+name = "Header"
+
+[[tab.property]]
+key = "69bc242b-d03f-4b59-911f-98887d4e93d3"
+alias = "eyebrow"
+name = "Eyebrow"
+description = "The small line above the heading"
+type = "textstring"
+
+[[tab.property]]
+key = "4501d20d-3b78-40a4-97e4-dd25b2d8535a"
+alias = "title"
+name = "Title"
+type = "textstring"
+mandatory = true
+
+[[tab.property]]
+key = "33199ac7-8128-4dc4-bae1-554b2a622447"
+alias = "standfirst"
+name = "Standfirst"
+description = "A paragraph under the title"
+type = "textarea"
+
+[[tab]]
+name = "Section"
+
+[[tab.property]]
+key = "6e9917d3-0a7c-4568-9e43-7468c6181d9c"
+alias = "heroImage"
+name = "Image"
+type = "imageMediaPicker"
+
+[[tab.property]]
+key = "93877ded-cbb6-440a-8042-06508caec630"
+alias = "sectionEyebrow"
+name = "Eyebrow"
+type = "textstring"
+
+[[tab.property]]
+key = "317b652e-ceca-4e98-b89f-7a8cac855854"
+alias = "sectionHeading"
+name = "Heading"
+type = "textstring"
+
+[[tab.property]]
+key = "f3a8a9f6-f841-486b-be9e-038bd15df843"
+alias = "bodyText"
+name = "Body"
+type = "richtext"
+
+[[tab]]
+name = "Highlights"
+
+[[tab.property]]
+key = "986368b7-8b5e-4b0c-a5bb-7b9c0a789998"
+alias = "highlightsEyebrow"
+name = "Eyebrow"
+type = "textstring"
+
+[[tab.property]]
+key = "e0c93426-bf71-4ba9-a9a7-ebd97bce7a63"
+alias = "highlightsHeading"
+name = "Heading"
+type = "textstring"
+
+# The same element type the home page picks its figures from. Leave this empty
+# and the whole dark band disappears — see `components/contentPage.tsx`.
+[[tab.property]]
+key = "93a7b537-c3e7-4826-9ec8-ce8f150bce50"
+alias = "highlights"
+name = "Highlights"
+type = "highlightPicker"
+
+[[tab.property]]
+key = "d1b0e86e-65aa-497f-825b-b48fd301e52a"
+alias = "highlightsImage"
+name = "Image"
+type = "imageMediaPicker"

package/templates/demo/harbourstone/files/schema/content-types/expression.toml

@@ -0,0 +1,78 @@
+[content-type]
+key = "cf0bade1-5027-4f98-b7b3-0f7ae51f0a7f"
+alias = "expression"
+name = "Expression"
+description = "One bottling in the range"
+icon = "icon-wine-glass"
+components = ["pages/expression"]
+default-component = "pages/expression"
+
+[[tab]]
+name = "Content"
+
+[[tab.property]]
+key = "52a26147-233c-41f3-84f3-cf8921b696c5"
+alias = "title"
+name = "Title"
+type = "textstring"
+mandatory = true
+
+[[tab.property]]
+key = "25738367-ed14-4985-9843-04716417c88a"
+alias = "kind"
+name = "Kind"
+description = "House malt, Lightly peated, Sherry matured, Cask strength"
+type = "textstring"
+
+[[tab.property]]
+key = "f4238bf1-3d9d-4dbc-b6f4-9800e1dfdc79"
+alias = "summary"
+name = "Summary"
+description = "One line, shown wherever this bottling is listed"
+type = "textarea"
+
+[[tab.property]]
+key = "df466e38-c8c5-4b8f-b56b-fff051d724cc"
+alias = "bottleImage"
+name = "Bottle"
+type = "imageMediaPicker"
+
+[[tab.property]]
+key = "5b509286-46c1-4863-8b6d-d054a1501164"
+alias = "bodyText"
+name = "Body"
+type = "richtext"
+
+[[tab]]
+name = "Specification"
+
+[[tab.property]]
+key = "ff73013c-fdb2-4cd6-9afa-e117d8d223a9"
+alias = "abv"
+name = "ABV"
+description = "As it is printed on the label, e.g. 46%"
+type = "textstring"
+
+[[tab.property]]
+key = "f1053b53-6cbc-4b6b-85b3-9f5c5a73750f"
+alias = "age"
+name = "Age"
+description = "Years in cask. Leave empty for a batch release."
+type = "numeric"
+
+[[tab.property]]
+key = "4622644d-c3b4-44e3-abc1-318229680f1e"
+alias = "batch"
+name = "Batch"
+description = "Shown instead of an age, e.g. 07"
+type = "textstring"
+
+[[tab]]
+name = "Tasting"
+
+[[tab.property]]
+key = "ac279149-fa32-4ce0-91a8-d32b7160d36f"
+alias = "tastingNotes"
+name = "Tasting notes"
+description = "Nose, palate and finish, picked from the Library"
+type = "tastingNotePicker"

package/templates/demo/harbourstone/files/schema/content-types/highlight.toml

@@ -0,0 +1,27 @@
+# A second element type, and the point of it is reuse: the home page picks four
+# of these as the figures beside the house style, and the About page picks four
+# more as the decisions that set it. Same type, two content types, no second
+# shape to maintain.
+[content-type]
+key = "2e4e319f-2627-43da-8200-27d6197aced7"
+alias = "highlight"
+name = "Highlight"
+description = "A short heading and a line under it, reusable across pages"
+icon = "icon-list"
+is-element = true
+allow-in-library = true
+
+[[property]]
+key = "f441928a-273d-4a6a-94d9-f363d448107e"
+alias = "heading"
+name = "Heading"
+description = "A year, a number, or a single word"
+type = "textstring"
+mandatory = true
+
+[[property]]
+key = "b5e05c31-681a-473a-9597-777eb27517c5"
+alias = "detail"
+name = "Detail"
+type = "textarea"
+mandatory = true

package/templates/demo/harbourstone/files/schema/content-types/home-page.toml

@@ -0,0 +1,104 @@
+[content-type]
+key = "e7fa436b-a7bc-4413-8d12-7eb535b61cb2"
+alias = "homePage"
+name = "Home Page"
+description = "The site's landing page"
+icon = "icon-home"
+allow-at-root = true
+allow-children = ["contentPage", "whiskyList", "contactPage"]
+components = ["pages/homePage"]
+default-component = "pages/homePage"
+
+[[tab]]
+name = "Hero"
+
+[[tab.property]]
+key = "4beadbaf-51d7-40bc-bb3e-3560413b42dc"
+alias = "eyebrow"
+name = "Eyebrow"
+description = "The small line above the heading"
+type = "textstring"
+
+[[tab.property]]
+key = "be74a0df-3e9d-47f3-b60e-778a89682a80"
+alias = "title"
+name = "Title"
+description = "Shown as the page heading"
+type = "textstring"
+mandatory = true
+
+[[tab.property]]
+key = "a540c93a-228b-49f6-931a-be1b986bedd1"
+alias = "strapline"
+name = "Strapline"
+description = "One line under the heading"
+type = "textarea"
+
+[[tab.property]]
+key = "ad73357a-4beb-497d-9b55-9fe5222f781e"
+alias = "heroImage"
+name = "Hero image"
+type = "imageMediaPicker"
+
+[[tab.property]]
+key = "768f61dc-4808-40d4-a9cd-515516848640"
+alias = "heroCtaLabel"
+name = "Hero button"
+description = "Links to the range. Leave empty for no button."
+type = "textstring"
+
+[[tab]]
+name = "House style"
+
+[[tab.property]]
+key = "5f5aab62-b28d-4a2e-9f0b-6d6f888f9de0"
+alias = "styleEyebrow"
+name = "Eyebrow"
+type = "textstring"
+
+[[tab.property]]
+key = "2c0f6d01-068a-444a-9f74-bb8d5642574c"
+alias = "styleHeading"
+name = "Heading"
+type = "textstring"
+
+[[tab.property]]
+key = "0aad18a5-a627-42f5-a95f-311fdaed30ae"
+alias = "styleIntro"
+name = "Introduction"
+type = "richtext"
+
+[[tab.property]]
+key = "2d297b00-721d-462c-939c-c462467b40d3"
+alias = "stats"
+name = "Figures"
+description = "Picked from the Library; shown as a grid under the introduction"
+type = "highlightPicker"
+
+[[tab.property]]
+key = "3de44366-c05d-4036-aa92-481d4763c6e2"
+alias = "styleImage"
+name = "Image"
+type = "imageMediaPicker"
+
+[[tab]]
+name = "Range"
+
+[[tab.property]]
+key = "827433bb-9a7c-47d7-84e5-9d386bcc9e73"
+alias = "rangeEyebrow"
+name = "Eyebrow"
+type = "textstring"
+
+[[tab.property]]
+key = "74c2e4dd-34b7-4905-baeb-c6c100602bd8"
+alias = "rangeHeading"
+name = "Heading"
+type = "textstring"
+
+[[tab.property]]
+key = "af8b51ac-208e-40ad-a311-80495dced2a7"
+alias = "rangeCtaLabel"
+name = "Button"
+description = "Links to the range. Leave empty for no button."
+type = "textstring"

package/templates/demo/harbourstone/files/schema/content-types/tasting-note.toml

@@ -0,0 +1,26 @@
+# An element type: content with no URL of its own, created in the Library and
+# pointed at from a page. `is-element` makes it one; `allow-in-library` is what
+# puts it in the Library's Create dialog, and Umbraco requires both.
+[content-type]
+key = "55138391-faf2-4795-9ed6-43d581d350a4"
+alias = "tastingNote"
+name = "Tasting Note"
+description = "Nose, palate or finish, reusable across bottlings"
+icon = "icon-coffee"
+is-element = true
+allow-in-library = true
+
+[[property]]
+key = "b182753f-d1a1-4c2c-9bd5-1252d0eb7f60"
+alias = "aspect"
+name = "Aspect"
+description = "Nose, Palate or Finish"
+type = "textstring"
+mandatory = true
+
+[[property]]
+key = "c9b32002-2aa3-4218-a0ae-6185c066161d"
+alias = "note"
+name = "Note"
+type = "textarea"
+mandatory = true

package/templates/demo/harbourstone/files/schema/content-types/whisky-list.toml

@@ -0,0 +1,35 @@
+# `collection` gives the backoffice a list view of the children instead of a
+# tree branch, which is what a range of bottlings wants.
+[content-type]
+key = "57a5b3bd-c465-4509-9833-e20a06f28717"
+alias = "whiskyList"
+name = "Whisky List"
+description = "The range: a parent for the bottlings"
+icon = "icon-bulleted-list"
+allow-children = ["expression"]
+collection = "listViewContent"
+components = ["pages/whiskyList"]
+default-component = "pages/whiskyList"
+
+[[tab]]
+name = "Content"
+
+[[tab.property]]
+key = "13785a42-6d0a-4152-89ec-c765db766547"
+alias = "eyebrow"
+name = "Eyebrow"
+type = "textstring"
+
+[[tab.property]]
+key = "727804c0-7d4a-43d9-a473-71c9e27397c0"
+alias = "title"
+name = "Title"
+type = "textstring"
+mandatory = true
+
+[[tab.property]]
+key = "9c83bcea-a70e-4a3f-8185-ad04ddec55f1"
+alias = "standfirst"
+name = "Standfirst"
+description = "A paragraph under the title"
+type = "textarea"

package/templates/demo/harbourstone/files/schema/data-types/highlight-picker.toml

@@ -0,0 +1,10 @@
+# The same Element Picker schema as the tasting notes beside it, narrowed to a
+# different element type. Two data types over one editor is how a picker is kept
+# from offering everything in the Library.
+[data-type]
+key = "0a46b720-4f6c-4f8f-9c80-d3b018389006"
+alias = "highlightPicker"
+name = "Highlight Picker"
+editor = "Umbraco.ElementPicker"
+editor-ui = "Umb.PropertyEditorUi.ElementPicker"
+config = { allowedContentTypes = "2e4e319f-2627-43da-8200-27d6197aced7" }

package/templates/demo/harbourstone/files/schema/data-types/tasting-note-picker.toml

@@ -0,0 +1,11 @@
+# Umbraco ships the Element Picker's schema but seeds no data type for it, so a
+# site declares its own. `allowedContentTypes` is a comma-separated list of element
+# type keys; it narrows the picker, and `crombolo generate` reads it to type the
+# value as `Array<TypedElement<TastingNote>>` rather than `Array<PublishedElement>`.
+[data-type]
+key = "3f99cab4-4712-4514-a4be-dbb45c73ce80"
+alias = "tastingNotePicker"
+name = "Tasting Note Picker"
+editor = "Umbraco.ElementPicker"
+editor-ui = "Umb.PropertyEditorUi.ElementPicker"
+config = { allowedContentTypes = "55138391-faf2-4795-9ed6-43d581d350a4" }

package/templates/demo/harbourstone/files/schema/forms/contact.toml

@@ -0,0 +1,119 @@
+# A form is structure, so it is a file like the content types beside it and a
+# change to it shows up in a diff (`docs/18-forms.md`). The Contact page points
+# at this one through its `enquiryForm` property, and `components/contactPage.tsx`
+# renders it with `<Form>`.
+#
+# Submissions land in the Forms section under Entries. `phone` is marked
+# sensitive, so it is redacted for anyone without the sensitive-data permission
+# — in the API response and in the CSV export, not merely in the screen.
+[form]
+key = "7b1f4c20-9a63-4e18-8d25-3c6f5a1e9b04"
+alias = "contactEnquiry"
+name = "Write to the cove"
+store-entries = true
+requires-approval = false
+submit-label = "Send message"
+message-on-submit = "Received. We answer from the stillhouse office within two working days."
+# A field no visitor ever fills, and a floor on how fast the form can come back:
+# between them they stop the bulk of automated submissions without a captcha.
+honeypot = true
+minimum-submit-seconds = 3
+
+[[page]]
+
+  [[page.group]]
+  columns = 1
+
+    [[page.group.field]]
+    key = "7b1f4c20-0001-4e18-8d25-3c6f5a1e9b04"
+    alias = "visitorName"
+    type = "shortAnswer"
+    caption = "Name"
+    mandatory = true
+    mandatory-message = "We need a name to reply to"
+    autocomplete = "name"
+
+    [[page.group.field]]
+    key = "7b1f4c20-0002-4e18-8d25-3c6f5a1e9b04"
+    alias = "visitorEmail"
+    type = "email"
+    caption = "Email"
+    mandatory = true
+    mandatory-message = "We need an email address to reply to"
+    autocomplete = "email"
+
+    [[page.group.field]]
+    key = "7b1f4c20-0003-4e18-8d25-3c6f5a1e9b04"
+    alias = "topic"
+    type = "dropdown"
+    caption = "Subject"
+    mandatory = true
+    default-value = "Book a distillery visit"
+    values = [
+      "Book a distillery visit",
+      "Trade and allocation",
+      "Press",
+      "Something else",
+    ]
+
+    [[page.group.field]]
+    key = "7b1f4c20-0004-4e18-8d25-3c6f5a1e9b04"
+    alias = "company"
+    type = "shortAnswer"
+    caption = "Company"
+    help-text = "Who you buy for, and where"
+    mandatory = true
+    mandatory-message = "We need the company name for a trade enquiry"
+
+      # A condition may only look backwards, at a field already answered above —
+      # so this one names `topic` and not something further down the form. It is
+      # evaluated on the server as well as in the browser, and the server's
+      # answer is the one that counts: a mandatory field the condition hides is
+      # not demanded, and a hidden field's value is discarded.
+      [page.group.field.condition]
+      action = "show"
+      match = "all"
+      rule = [{ field = "topic", operator = "is", value = "Trade and allocation" }]
+
+    [[page.group.field]]
+    key = "7b1f4c20-0005-4e18-8d25-3c6f5a1e9b04"
+    alias = "phone"
+    type = "shortAnswer"
+    caption = "Phone"
+    help-text = "Only if you would rather we rang"
+    sensitive = true
+    autocomplete = "tel"
+
+    [[page.group.field]]
+    key = "7b1f4c20-0006-4e18-8d25-3c6f5a1e9b04"
+    alias = "message"
+    type = "longAnswer"
+    caption = "Message"
+    placeholder = "Preferred dates, party size, or the bottling you are after."
+    mandatory = true
+    mandatory-message = "Tell us what you are after"
+    rows = 5
+
+    [[page.group.field]]
+    key = "7b1f4c20-0007-4e18-8d25-3c6f5a1e9b04"
+    alias = "consent"
+    type = "dataConsent"
+    caption = "I am happy for Harbourstone to hold these details in order to answer my message."
+    mandatory = true
+    mandatory-message = "We cannot store your message without this"
+
+# Telling somebody about a submission takes an e-mail provider, which this
+# template does not configure — see `docs/14-configuration.md`. With
+# CROMBOLO_EMAIL_* set, uncomment this and the message is mailed on submit; the
+# queue retries, so a provider that is briefly down loses nothing.
+#
+# [[workflow]]
+# key = "7b1f4c20-0008-4e18-8d25-3c6f5a1e9b04"
+# type = "sendEmail"
+# name = "Tell the stillhouse office"
+# on = "submit"
+#
+#   [workflow.settings]
+#   to = "visitors@harbourstone.scot"
+#   reply-to = "{visitorEmail}"
+#   subject = "Website: {topic}"

package/templates/demo/harbourstone/files/schema/schema.toml

@@ -0,0 +1,2 @@
+[schema]
+version = "1.0.0"

package/templates/demo/harbourstone/template.json

@@ -0,0 +1,10 @@
+{
+  "name": "Harbourstone Distillery",
+  "description": "a coastal distillery: a range with tasting-note elements, reusable highlights, a contact form, photographs and a stylesheet",
+  "bundles": [
+    {
+      "package": "@crombolo/simple-redirects",
+      "import": "redirects"
+    }
+  ]
+}

package/templates/starter/bundle/bundle.json

@@ -0,0 +1,49 @@
+{
+  "formatVersion": 1,
+  "id": "da9fd74e-b964-44b4-8d61-afa7f65a28d2",
+  "createdAt": "2026-10-01T00:00:00.000Z",
+  "createdBy": "bun run build:template",
+  "integrity": "sha256-3ef21d4b047d85bfef8aeaac90255348bf636ba6ff3c0d0e155a06a2225269de",
+  "snapshot": "published",
+  "provenance": {
+    "siteName": "Starter",
+    "schemaVersion": "1.0.0",
+    "schemaRevision": "0",
+    "schemaHash": "81d3ebeb2c46ec1a17f0bf253e1bf711c47390ac49eb3f32a60b23e3ace89b16"
+  },
+  "selector": {
+    "roots": [
+      "64d95359-d91a-4050-b440-3e5124a74999",
+      "634dd948-cf83-4cad-9b7b-7c938b33da76",
+      "d2997ebb-36ca-47cb-bbc8-31fefca787c0"
+    ],
+    "descendants": true,
+    "asGiven": [
+      "starter"
+    ]
+  },
+  "counts": {
+    "document": 3
+  },
+  "dependencies": {
+    "carried": [
+      "634dd948-cf83-4cad-9b7b-7c938b33da76",
+      "64d95359-d91a-4050-b440-3e5124a74999",
+      "d2997ebb-36ca-47cb-bbc8-31fefca787c0"
+    ],
+    "expected": [],
+    "schema": {
+      "contentTypes": [
+        {
+          "key": "8491ffa4-9b2f-48b0-a3c0-f40c1034216e",
+          "alias": "contentPage"
+        }
+      ],
+      "components": [
+        "pages/contentPage"
+      ],
+      "languages": []
+    }
+  },
+  "blobs": []
+}