@aglyn/aglyn 1.0.0-beta.290 → 1.0.0-beta.292

package/src/lib/app-utils/docs-index.generated.js

@@ -4650,7 +4650,14 @@ export const DOCS_SECTION_INDEX = [
         title: 'Product catalog',
         heading: 'Products, options, and variants',
         anchor: '#products-options-and-variants',
-        text: 'A product is what you manage; a variant is what a customer actually buys. Products define up to 3 options (like Size or Color, each with up to 25 values), and the products hub expands them into a variants matrix — up to 100 variants per product, each with its own SKU, barcode, price, compare-at price, weight, image, and inventory count.\n- Types: physical (shippable), digital (delivered as downloads), or service.\n- Status: draft (invisible to visitors), active, or archived. Draft and archived products can\'t be bought online, from the cart or with Buy now. A product created for you rather than added in the editor — a proposed product, for one — starts as a draft with no photo, at the price it was given (an AI proposal\'s suggested price) or else a default price, for you to change. It counts toward your plan\'s product allowance like any other product.\n- Pricing: a variant with a compare-at price above its price shows a sale badge on storefront blocks.\n- Inventory: leave blank for untracked, 0 means sold out — the same semantics the original product block used. Stock is not tracked on a digital or service subscription-only product: nothing decrements it, on the first charge or on any renewal, so the field is disabled there. A physical subscription tracks normally — every paid cycle decrements one unit per box shipped — and Both — buyer chooses keeps tracking on the one-time sales.\nProducts created with the earlier single-price product block are lifted into this model automatically as a single default variant — nothing breaks and no migration step is needed.'
+        text: 'A product is what you manage; a variant is what a customer actually buys. Products define up to 3 options (like Size or Color, each with up to 25 values), and the products hub expands them into a variants matrix — up to 100 variants per product, each with its own SKU, barcode, price, compare-at price, weight, image, and inventory count. Choices that don\'t need their own stock, like walls or printing on a canopy, are add-ons instead, and they don\'t count toward the 100.\n- Types: physical (shippable), digital (delivered as downloads), or service.\n- Status: draft (invisible to visitors), active, or archived. Draft and archived products can\'t be bought online, from the cart or with Buy now. A product created for you rather than added in the editor — a proposed product, for one — starts as a draft with no photo, at the price it was given (an AI proposal\'s suggested price) or else a default price, for you to change. It counts toward your plan\'s product allowance like any other product.\n- Pricing: a variant with a compare-at price above its price shows a sale badge on storefront blocks.\n- Inventory: leave blank for untracked, 0 means sold out — the same semantics the original product block used. Stock is not tracked on a digital or service subscription-only product: nothing decrements it, on the first charge or on any renewal, so the field is disabled there. A physical subscription tracks normally — every paid cycle decrements one unit per box shipped — and Both — buyer chooses keeps tracking on the one-time sales.\nProducts created with the earlier single-price product block are lifted into this model automatically as a single default variant — nothing breaks and no migration step is needed.\nMore than 100 combinations {#more-than-100-combinations}\nEvery value of every option m'
+    },
+    {
+        path: '/commerce-and-bookings/commerce/catalog',
+        title: 'Product catalog',
+        heading: 'Add-ons',
+        anchor: '#add-ons',
+        text: 'Add-ons are choices added to an item that aren\'t stocked variants: the frame, walls and printing on a canopy, gift wrap on a box, or a milk in a latte. Each can be free or add to the price. They\'re under Add-ons in the product editor on every plan, and editing them takes the same access as editing the product.\n1. Click New add-on group and name it (for example "Walls").\n2. Set At least: 0 makes the group optional, and 1 or more makes it required. Set At most to the number of choices a customer can pick (1 for "pick one").\n3. Click Add choice for each choice, with what it Adds to the price. Leave it blank for a free choice.\n4. Leave Show on the website on to offer the group on the product\'s page. Turn it off to offer the group at the register only.\nA group you add is shown on the website. A group made before add-ons came to the website (October 2026) stays at the register until you turn Show on the website on, so nothing changes on your live store by itself.\nPrice an add-on by size {#price-by-size}\nA choice can cost more on one variant than another. A back wall for a 10×20 canopy takes more fabric than one for a 10×10, so it costs more. On a product with options, click Price by size beside the choice. The button is named after your option, and it says Price by variant when the product has several options. Then enter what the choice adds on each size. A size you leave blank uses the choice\'s own price.\nOn the product\'s page {#add-ons-on-the-product-page}\nThe product\'s page shows each group that\'s shown on the website, under the product\'s options:\n- A group that takes one choice is a drop-down. A group that takes several is a set of checkboxes. Each choice shows what it adds on the size picked, like Aluminum frame (+$200.00).\n- A required group is marked with an asterisk, '
     },
     {
         path: '/commerce-and-bookings/commerce/catalog',
@@ -5140,7 +5147,7 @@ export const DOCS_SECTION_INDEX = [
         title: 'Order emails & status page',
         heading: 'Related',
         anchor: '#related',
-        text: '- Commerce overview\n- POS & reservations'
+        text: '- Commerce overview\n- POS & reservations\n- The quote email, which you send yourself'
     },
     {
         path: '/commerce-and-bookings/commerce/orders-and-returns',
@@ -5161,7 +5168,7 @@ export const DOCS_SECTION_INDEX = [
         title: 'Fulfillment, returns and webhooks',
         heading: 'Invoices and packing slips',
         anchor: '#invoices',
-        text: 'Invoice in the order\'s dialog has two choices:\n- Print invoice opens the order as a bill, ready to print: your business name, the date, who it is billed and shipped to, each line with its unit price, the subtotal, discount, shipping, tax and total, and anything refunded. Your store\'s receipt footer and terms address print at the foot.\n- Download PDF saves the same invoice as a PDF file in your site\'s look: your logo and contact details at the top, a band in your site\'s primary color, the invoice number, the order date and whether it is paid, then the lines and totals. A paid quote\'s invoice works the same way, with Included beside anything included at no charge.\nThe PDF takes your logo and contact details from your site\'s settings, and its colors from your site\'s theme. Downloading it takes the Manage orders permission.\nPacking slip prints what goes in the box — the shipping address and each line\'s quantity, name, option and SKU — with no prices.'
+        text: 'Invoice in the order\'s dialog has three choices:\n- Print invoice opens the order as a bill, ready to print: your business name, the date, who it is billed and shipped to, each line with its unit price, the subtotal, discount, shipping, tax and total, and anything refunded. Your store\'s receipt footer and terms address print at the foot.\n- Download PDF saves the same invoice as a PDF file in your site\'s look: your logo and contact details at the top, a band in your site\'s primary color, the invoice number, the order date and whether it is paid, then the lines and totals. A paid quote\'s invoice works the same way, with Included beside anything included at no charge.\n- Send invoice emails the invoice to your customer, with the PDF attached. See Send an invoice.\nThe PDF takes your logo and contact details from your site\'s settings, and its colors from your site\'s theme. Downloading it takes the Manage orders permission.\nSend an invoice {#send-invoice}\nSend invoice opens a short form: To (your customer\'s email, filled in from the order), Subject and Message. Your message is shown at the top of the email, in your words. The email goes out in your site\'s look, from your site, with the invoice attached as a PDF. Replies go to your site\'s contact email, or to you when the site has none.\nWhat the email says depends on whether the order is paid:\n- Unpaid: "Invoice #1042 from" your business, the invoice number, its date, the total and what is due, and a Pay button. The button opens the invoice on your own site, where your customer pays it by card. The same link is printed on the PDF.\n- Paid: the same invoice, marked paid on the day it was paid, for your customer\'s records. It has no button.\nOnce it\'s sent, the order\'s dialog says when and to whom: "Invoice sent Oct 29, 2026, 3:04 P'
     },
     {
         path: '/commerce-and-bookings/commerce/orders-and-returns',
@@ -5196,7 +5203,7 @@ export const DOCS_SECTION_INDEX = [
         title: 'Commerce',
         heading: 'Products hub',
         anchor: '#products-hub',
-        text: 'The Products page is the catalog manager:\n- Products with up to 3 options and 100 variants each — per-variant SKU, barcode, price, compare-at (sale badge), weight, and stock. See Product catalog.\n- Categories & collections — a category tree plus manual and smart (rule-based) collections with a live match preview.\n- Import and export: a Shopify product export uploads as it is, a product a file matches by handle or SKU is updated, and every step shows its choices and a dry run first. Gift cards move over by issuing each card. Products, categories, orders, discounts, coupons and gift cards export with the fields you pick. See Import and export store data.\n- Payments — Stripe Connect onboarding status and your plan\'s fee ladder.\nThe store\'s settings sit under Settings at the foot of the Products rail, a page each:\n- Payments — your Stripe account and the payment methods shoppers may use.\n- Checkout — the Store settings card (templates, currency, guest checkout, terms, receipt footer) and online returns.\n- Taxes — your tax rates, and a tax service where one is set up.\n- Shipping & delivery — shipping rates, inventory locations and pickup, local delivery, dropship suppliers, and shipping and fulfillment services.\n- Notifications — which emails customers get, and order webhooks.\n- Point of sale — registers, staff PINs, register hardware and POS devices.\n- Sales channels and Integrations — the shopping channels, marketplaces and other services you connect. Each appears only once there is something on it for your store.\nAn old link to the single Settings page opens Payments.\nThe product list filters through its own toolbar, and every filter and the search reach the whole catalog, not only the rows on screen. The list is in name order and pages through whatever matches.\n- Search '
+        text: 'The Products page is the catalog manager:\n- Products with up to 3 options and 100 variants each — per-variant SKU, barcode, price, compare-at (sale badge), weight, and stock — and add-ons priced on the product\'s page. See Product catalog.\n- Categories & collections — a category tree plus manual and smart (rule-based) collections with a live match preview.\n- Import and export: a Shopify product export uploads as it is, a product a file matches by handle or SKU is updated, and every step shows its choices and a dry run first. Gift cards move over by issuing each card. Products, categories, orders, discounts, coupons and gift cards export with the fields you pick. See Import and export store data.\n- Payments — Stripe Connect onboarding status and your plan\'s fee ladder.\nThe store\'s settings sit under Settings at the foot of the Products rail, a page each:\n- Payments — your Stripe account and the payment methods shoppers may use.\n- Checkout — the Store settings card (templates, currency, guest checkout, terms, receipt footer) and online returns.\n- Taxes — your tax rates, and a tax service where one is set up.\n- Shipping & delivery — shipping rates, inventory locations and pickup, local delivery, dropship suppliers, and shipping and fulfillment services.\n- Notifications — which emails customers get, and order webhooks.\n- Point of sale — registers, staff PINs, register hardware and POS devices.\n- Sales channels and Integrations — the shopping channels, marketplaces and other services you connect. Each appears only once there is something on it for your store.\nAn old link to the single Settings page opens Payments.\nThe product list filters through its own toolbar, and every filter and the search reach the whole catalog, not only the rows on screen. The list is in name order an'
     },
     {
         path: '/commerce-and-bookings/commerce/overview',
@@ -5646,6 +5653,27 @@ export const DOCS_SECTION_INDEX = [
         anchor: '#make-a-quote',
         text: '1. On the Orders tab, choose New quote in the Quotes card.\n2. Find the customer in your contacts, or type their details.\n3. Choose Add product or Add custom item for each line, and set its quantity.\n4. Add a discount, shipping, the addresses, notes and terms as you need them.\n5. Choose Create quote.\nThe quote gets the next number from your store\'s order numbers and is listed as Quote #1042, for example. Choose a quote in the list to open it again; change anything and choose Save. A draft quote you no longer need can be deleted.\nThe list shows each quote\'s customer, total, status and when it last changed, and sorts by any column.'
     },
+    {
+        path: '/commerce-and-bookings/commerce/quotes-and-proofs',
+        title: 'Quotes',
+        heading: 'A Request a quote form',
+        anchor: '#a-request-a-quote-form',
+        text: 'Let customers ask for a quote on your site, with the product they want and their artwork:\n1. On the Forms page, make a form (or open one) and open it in the Besigner.\n2. Add the fields you need: a name, an email, a message, a Product and options field from the element picker\'s Forms group, and a File upload field for logos or artwork.\n3. On the form\'s page, under After someone sends it, turn on This form asks for a quote. Email the person a confirmation turns on with it.\n4. Publish the form and place it on a page.\nThe Product and options field lists your store\'s products for the customer to pick from, then the product\'s options (size, color and so on). To quote one product only, pick it in the field\'s Product setting; the customer then picks just its options. The field sends the product and options in words, which is what your Inbox and your alert show, and keeps the exact product and option beside them for the quote.\nThe customer gets a confirmation email with a copy of their request, and their request lands in your Inbox marked Quote request.'
+    },
+    {
+        path: '/commerce-and-bookings/commerce/quotes-and-proofs',
+        title: 'Quotes',
+        heading: 'Start a quote from a request',
+        anchor: '#start-a-quote-from-a-request',
+        text: 'Open a quote request in the Inbox and choose Start a quote. The quote editor opens with:\n- the customer: their name, email, phone and company, as the form gave them;\n- a line for the product they picked, with its options, priced from your catalog;\n- their message as the quote\'s notes, ready to edit;\n- their files, listed under From the request.\nSet the prices and anything else, and choose Create quote. The quote keeps the request\'s files as the customer\'s files, which you can download from the quote, and remembers which request it came from.\nWhen you email the quote, it is sent as a reply to the confirmation your customer got for their request, so the request, the quote and every revision after it are one conversation in their inbox. Keep the subject the same so every inbox keeps them together.'
+    },
+    {
+        path: '/commerce-and-bookings/commerce/quotes-and-proofs',
+        title: 'Quotes',
+        heading: 'Start a quote from a contact',
+        anchor: '#start-a-quote-from-a-contact',
+        text: 'On a contact\'s page in the CRM, choose Start a quote. The quote editor opens with the contact as the customer: their name, email, phone and company. Add the lines and choose Create quote.\nBoth need Create and edit quotes, and starting one from a request also needs a role that can read the site\'s Inbox.'
+    },
     {
         path: '/commerce-and-bookings/commerce/quotes-and-proofs',
         title: 'Quotes',
@@ -5653,12 +5681,40 @@ export const DOCS_SECTION_INDEX = [
         anchor: '#totals-and-tax',
         text: 'The totals add up the items (included items count nothing), take off the discount, then add shipping and tax. Tax follows your store\'s tax settings:\n- Manual rates: the rate for the quote\'s ship-to state and country, or for your store\'s address when the quote has no ship-to country. The discount comes off before tax, and shipping is not taxed. A product marked tax-exempt is left out.\n- A connected tax service (Tax services) prices the quote when you save it, and the quote shows its figure.\n- Stripe Tax: the quote says Tax is added at payment, because Stripe works out the tax when the customer pays.\n- No sales tax: no tax is added.\nIf your store hasn\'t chosen how it handles sales tax, the quote shows no tax and says so, with a link to Taxes.'
     },
+    {
+        path: '/commerce-and-bookings/commerce/quotes-and-proofs',
+        title: 'Quotes',
+        heading: 'Email the quote',
+        anchor: '#send',
+        text: 'Send the quote to your customer by email, from your site, with your own message:\n1. Open a saved quote and choose Send quote under Email to customer.\n2. Check To. It starts with the customer\'s email from the quote; type another address to send it somewhere else.\n3. Check Subject. It starts as Quote #1042 from your business name.\n4. Type a Message: a few words to your customer, shown at the top of the email.\n5. Choose Send.\nThe quote then shows Sent with the date and the address, and moves to Sent in the list (unless your customer has already approved it or asked for changes, which it keeps showing). The email shows the quote as it was last saved, so save your changes first.'
+    },
+    {
+        path: '/commerce-and-bookings/commerce/quotes-and-proofs',
+        title: 'Quotes',
+        heading: 'What your customer gets',
+        anchor: '#quote-email',
+        text: 'One email in your site\'s look, from your site\'s name, with:\n- Your quote from your business name as its heading, or Your updated quote when it\'s a new revision of a quote you already emailed (the first email you send for a quote, and sending the same revision again, keep Your quote from);\n- your message;\n- the quote number, its revision and its total;\n- the first three proof images, each opening the quote page, and the other proof files by name, to see on the quote page (a WebP image is named rather than shown, because some inboxes can\'t show one);\n- what to do next, and one button:\n- Review and approve while the proof must be approved before paying and isn\'t yet;\n- otherwise View and pay with the total;\n- the quote attached as a PDF, the same one as Download PDF, with the pay link on it.\nThe button opens the quote\'s pay link. Replies go to your site\'s contact email, the one your business listing shows or else your support email, and to your own email when your site has neither. The email ends with a line saying so.\nThe email is the Quote email under Emails, where you can change its wording and colors like your other site emails. It can use these tokens:\n| Token | Value |\n| -- | -- |\n| {{quote.number}}, {{quote.revision}}, {{quote.total}} | The quote number, like #1042, its revision, and its total (with "before tax" when Stripe Tax adds the tax at payment) |\n| {{quote.heading}}, {{quote.intro}} | The heading, and one sentence on whether this is a new quote or an updated revision |\n| {{quote.message}} | The message you typed; empty when you typed none |\n| {{quote.proofImages}}, {{quote.proofFiles}} | Up to three proof images, and the other proof files by name |\n| {{quote.nextStep}}, {{quote.buttonLabel}}, {{quote.url}} | What to do next, the button\'s words, and the pay l'
+    },
+    {
+        path: '/commerce-and-bookings/commerce/quotes-and-proofs',
+        title: 'Quotes',
+        heading: 'One conversation in your customer\'s inbox',
+        anchor: '#conversation',
+        text: 'Every email about a quote goes into the same conversation: the first one, sending it again and sending a new revision. Each one is sent as a reply to the one before, and the subject starts as the conversation\'s. Keep the subject the same when you send again: many inboxes group a conversation by its subject, so a new subject can start a new one.'
+    },
+    {
+        path: '/commerce-and-bookings/commerce/quotes-and-proofs',
+        title: 'Quotes',
+        heading: 'Send it again, or send a revision',
+        anchor: '#send-again',
+        text: 'After the first email, the button reads:\n- Send again, for the revision you already sent. The pay link stays the same.\n- Send revision 2 (or whichever is current), once you\'ve started a new revision. Sending it gives your customer a new pay link, and the link in your earlier email opens a page saying the quote was updated, with nothing of the old revision. If you already replaced the link yourself, it isn\'t replaced again.\nA paid quote isn\'t sent again.'
+    },
     {
         path: '/commerce-and-bookings/commerce/quotes-and-proofs',
         title: 'Quotes',
         heading: 'Send the pay link',
         anchor: '#pay-link',
-        text: 'Every quote has a pay link: an address on your own site, at /pay-quote, that opens the quote for your customer with a Pay button. Open the quote and, under Pay link, choose Copy pay link. The link is copied and shown, ready to paste into an email or a text. It opens the quote as it was last saved, so save your changes before you copy it.\nThe link doesn\'t expire. It keeps working until the customer pays or you replace it.\nReplace link makes a new link and retires the old one. Use it when a link went to the wrong person, or when you want only your latest message to work. The old link then opens a page saying the quote was updated and that you sent a newer link, and shows nothing of the quote. Send your customer the new one. A paid quote\'s link can\'t be replaced.'
+        text: 'Every quote has a pay link: an address on your own site, at /pay-quote, that opens the quote for your customer with a Pay button. The quote email carries it for you. To send it some other way, open the quote and, under Pay link, choose Copy pay link. The link is copied and shown, ready to paste into an email or a text. It opens the quote as it was last saved, so save your changes before you copy it.\nThe link doesn\'t expire. It keeps working until the customer pays or you replace it.\nReplace link makes a new link and retires the old one. Use it when a link went to the wrong person, or when you want only your latest message to work. The old link then opens a page saying the quote was updated and that you sent a newer link, and shows nothing of the quote. Send your customer the new one. A paid quote\'s link can\'t be replaced.'
     },
     {
         path: '/commerce-and-bookings/commerce/quotes-and-proofs',
@@ -5716,6 +5772,13 @@ export const DOCS_SECTION_INDEX = [
         anchor: '#paid',
         text: 'A paid quote becomes an order, with the same number:\n- it joins the Orders list on the day it was paid, and the Channel filter finds it as Quote;\n- your customer gets a receipt, and their quote page shows Paid with a link to their order;\n- the customer becomes a contact, and you\'re notified;\n- stock goes down for your catalog products on the quote, included ones too. Custom items never change your stock.\nThe quote then can no longer be changed. If a second payment arrives for a quote that was already paid, or a payment comes through a link you had replaced, it isn\'t counted as a sale: the quote\'s timeline records it and you\'re notified, so you can refund it in Stripe.'
     },
+    {
+        path: '/commerce-and-bookings/commerce/quotes-and-proofs',
+        title: 'Quotes',
+        heading: 'Send an invoice for a quote',
+        anchor: '#invoice',
+        text: 'Send invoice sits beside Send quote in the quote\'s Email to customer section:\n- For a paid quote, it sends the invoice as your customer\'s record: marked paid, with the date, and the invoice attached as a PDF.\n- For an unpaid quote, it sends an invoice for a customer who needs one to pay, with a Pay button. The button is the quote\'s own pay link, so it opens the quote, and replacing the link retires it too.\nThe invoice is sent in the same conversation as the quote\'s emails, under the conversation\'s subject. Once it\'s sent, the section says when and to whom. An invoice for an unpaid quote that asks your customer to approve the proof can\'t be sent until they approve it: send the quote so they can.\nSee Send an invoice for everything the email says.'
+    },
     {
         path: '/commerce-and-bookings/commerce/quotes-and-proofs',
         title: 'Quotes',
@@ -5728,7 +5791,7 @@ export const DOCS_SECTION_INDEX = [
         title: 'Quotes',
         heading: 'Who can make and send quotes',
         anchor: '#permissions',
-        text: 'Making, editing and deleting quotes, adding and removing proofs, starting a revision, seeing earlier revisions and your customer\'s files, and downloading a quote\'s PDF, takes the Create and edit quotes permission. Copying and replacing a quote\'s pay link takes Send quotes and invoices to customers, and so does a PDF that carries the pay link. Everyone who can manage orders on the site has both to start with; a custom role or a per-member override can grant or deny each one. See Order permissions.'
+        text: 'Making, editing and deleting quotes, adding and removing proofs, starting a revision, seeing earlier revisions and your customer\'s files, and downloading a quote\'s PDF, takes the Create and edit quotes permission. Emailing a quote or its invoice, and copying and replacing its pay link, takes Send quotes and invoices to customers, and so does a PDF that carries the pay link. Everyone who can manage orders on the site has both to start with; a custom role or a per-member override can grant or deny each one. See Order permissions.'
     },
     {
         path: '/commerce-and-bookings/commerce/review-platforms',