rebly-sections 1.0.0

package/assets/data/schema-library.csv

@@ -0,0 +1,46 @@
+No,Type,Category,Returns,Keywords,Required Props,Optional Props,Default Behavior,JSON Example,Constraints,Notes
+1,checkbox,basic,boolean,"checkbox, boolean, toggle, true, false, on, off","type, id, label","default","Defaults to false if not set","{""type"":""checkbox"",""id"":""show_title"",""label"":""Show title"",""default"":true}","default must be boolean","Simple true/false toggle"
+2,number,basic,number,"number, integer, numeric, count, quantity","type, id, label","default, min, max, step, placeholder","No default if omitted","{""type"":""number"",""id"":""columns"",""label"":""Columns"",""default"":3,""min"":1,""max"":6}","Must be a finite number; min/max/step are optional","Use for numeric inputs like column counts or sizes"
+3,range,basic,number,"range, slider, min, max, step, unit, numeric","type, id, label, min, max, step","default, unit","Returns numeric value within min-max bounds","{""type"":""range"",""id"":""opacity"",""label"":""Opacity"",""min"":0,""max"":100,""step"":1,""default"":80,""unit"":""%""}","min/max/step are required; unit is display-only","Renders as a range slider in theme editor"
+4,select,basic,string,"select, dropdown, options, choice, enum, list","type, id, label, options","default","Returns value of selected option","{""type"":""select"",""id"":""layout"",""label"":""Layout"",""options"":[{""value"":""grid"",""label"":""Grid""},{""value"":""list"",""label"":""List""}],""default"":""grid""}","options array required; each option needs value and label","Renders as dropdown select"
+5,text,basic,string,"text, string, input, single line, short text, label","type, id, label","default, placeholder, info","Returns empty string if blank","{""type"":""text"",""id"":""heading"",""label"":""Heading"",""default"":""Welcome"",""placeholder"":""Enter heading""}","Single-line text; no HTML allowed","Use for short string inputs like headings or labels"
+6,textarea,basic,string,"textarea, multiline, long text, paragraph, string","type, id, label","default, placeholder, info","Returns empty string if blank","{""type"":""textarea"",""id"":""description"",""label"":""Description"",""default"":""Enter your text here""}","Multi-line plain text; no HTML rendered","Use for longer text content without formatting"
+7,radio,basic,string,"radio, radio button, choice, options, visual select","type, id, label, options","default","Returns value of selected radio option","{""type"":""radio"",""id"":""alignment"",""label"":""Alignment"",""options"":[{""value"":""left"",""label"":""Left""},{""value"":""right"",""label"":""Right""}],""default"":""left""}","options array required; each option needs value and label","Renders as visual radio buttons; similar to select"
+8,text_alignment,basic,string,"text alignment, align, left, center, right, justify","type, id, label","default","Returns left/center/right/justify string","{""type"":""text_alignment"",""id"":""text_align"",""label"":""Text alignment"",""default"":""left""}","Returns one of: left, center, right, justify","Renders as alignment picker with visual icons"
+9,color,color,string,"color, colour, hex, picker, rgba, background, foreground","type, id, label","default","Returns hex string or empty if not set","{""type"":""color"",""id"":""button_color"",""label"":""Button color"",""default"":""#1a1a1a""}","Stored as hex; supports rgba via color_to_rgb filter","Renders color picker; use color filters for manipulation"
+10,color_background,color,string,"color background, gradient, solid, linear, radial, color","type, id, label","default","Returns CSS-compatible color or gradient string","{""type"":""color_background"",""id"":""bg_color"",""label"":""Background color"",""default"":""#ffffff""}","Supports solid colors and CSS gradients","Use for background colors that may need gradient support"
+11,color_scheme,color,string,"color scheme, scheme, palette, theme colors, global","type, id, label","default","Returns reference to a color scheme object","{""type"":""color_scheme"",""id"":""color_scheme"",""label"":""Color scheme"",""default"":""scheme-1""}","Requires color_scheme_group defined in theme settings","References globally defined color schemes"
+12,color_scheme_group,color,object,"color scheme group, palette group, schemes, global colors","type, id, label","definition","Returns group containing multiple color scheme definitions","{""type"":""color_scheme_group"",""id"":""color_scheme_group"",""label"":""Color scheme group""}","Used in theme settings to define available schemes","Top-level definition; referenced by color_scheme type"
+13,image_picker,media,object,"image, photo, picture, media, upload, asset","type, id, label","default, info","Returns image object or null","{""type"":""image_picker"",""id"":""hero_image"",""label"":""Hero image"",""info"":""Recommended 1920x600px""}","Returns Shopify image object; use image_url filter","Access image via settings.image_picker_id | image_url"
+14,video,media,object,"video, shopify video, hosted video, media, mp4","type, id, label","info","Returns Shopify-hosted video object or null","{""type"":""video"",""id"":""background_video"",""label"":""Background video""}","Only supports Shopify-hosted videos; use video_tag filter","Use video_tag filter to render; different from video_url"
+15,video_url,media,string,"video url, youtube, vimeo, external video, embed, url","type, id, label","accept, placeholder, info","Returns URL string for YouTube or Vimeo","{""type"":""video_url"",""id"":""video_link"",""label"":""Video URL"",""accept"":[""youtube"",""vimeo""],""placeholder"":""Enter YouTube or Vimeo URL""}","accept array specifies allowed providers: youtube/vimeo","Use external_video_tag or external_video_url filter"
+16,richtext,content,string,"richtext, rich text, html, formatted, wysiwyg, content","type, id, label","default, info","Returns HTML string with block-level elements","{""type"":""richtext"",""id"":""content"",""label"":""Content"",""default"":""<p>Add your content here</p>""}","Default must be valid HTML with block elements (p/ul/ol/h1-h6)","Supports p/ul/ol/h1-h6/br/strong/em/a tags"
+17,inline_richtext,content,string,"inline richtext, inline, rich text, formatted, inline html","type, id, label","default, info","Returns HTML string without block-level elements","{""type"":""inline_richtext"",""id"":""subtitle"",""label"":""Subtitle"",""default"":""<strong>Bold text</strong> and normal text""}","No block-level elements allowed (no p/ul/h1 etc)","Use for inline formatted text within headings or captions"
+18,html,content,string,"html, raw html, markup, code, custom html, embed","type, id, label","default, placeholder, info","Returns raw HTML string","{""type"":""html"",""id"":""custom_html"",""label"":""Custom HTML"",""placeholder"":""<div>Your HTML</div>""}","No sanitization; raw output; XSS risk if user-generated","Renders raw HTML; use with caution for security"
+19,liquid,content,string,"liquid, liquid code, template, dynamic, code, markup","type, id, label","default, info","Returns Liquid code string to be rendered","{""type"":""liquid"",""id"":""custom_liquid"",""label"":""Custom Liquid"",""default"":""{{ shop.name }}""}","Must be valid Liquid; executed in section context","Powerful but risky; allows full Liquid template access"
+20,font_picker,content,object,"font, typography, typeface, google fonts, system font, font family","type, id, label","default, info","Returns font object with family/fallback/weight/style","{""type"":""font_picker"",""id"":""body_font"",""label"":""Body font"",""default"":""sans-serif""}","Returns font object; use font_face/font_url/font_modify filters","Access via settings.body_font.family for CSS font-family"
+21,url,resource-single,string,"url, link, href, external link, internal link, path","type, id, label","default, info","Returns URL string or null","{""type"":""url"",""id"":""button_link"",""label"":""Button link"",""default"":""/collections/all""}","Returns relative or absolute URL string","Supports internal Shopify paths and external URLs"
+22,collection,resource-single,object,"collection, product collection, catalog, group","type, id, label","info","Returns collection object or null","{""type"":""collection"",""id"":""featured_collection"",""label"":""Collection""}","Returns full Shopify collection object","Access products via collection.products array"
+23,product,resource-single,object,"product, item, variant, merchandise, single product","type, id, label","info","Returns product object or null","{""type"":""product"",""id"":""featured_product"",""label"":""Product""}","Returns full Shopify product object with variants","Access via settings.product_id with product properties"
+24,blog,resource-single,object,"blog, posts, articles, journal, news","type, id, label","info","Returns blog object or null","{""type"":""blog"",""id"":""featured_blog"",""label"":""Blog""}","Returns Shopify blog object; access articles via blog.articles","Use for blog section featuring latest posts"
+25,page,resource-single,object,"page, static page, content page, about","type, id, label","info","Returns page object or null","{""type"":""page"",""id"":""info_page"",""label"":""Page""}","Returns Shopify page object with content property","Access page.content for rendered HTML content"
+26,article,resource-single,object,"article, blog post, post, news item","type, id, label","info","Returns article object or null","{""type"":""article"",""id"":""featured_article"",""label"":""Article""}","Returns single Shopify article object","Access article.title/content/image/author etc"
+27,link_list,resource-single,object,"link list, menu, navigation, linklist, nav, links","type, id, label","default, info","Returns linklist object with links array","{""type"":""link_list"",""id"":""menu"",""label"":""Menu"",""default"":""main-menu""}","Returns Shopify linklist/menu object; access via links array","Iterate links array: for link in linklists[settings.menu].links"
+28,metaobject,resource-single,object,"metaobject, custom data, structured data, reference","type, id, label","info","Returns metaobject instance or null","{""type"":""metaobject"",""id"":""featured_meta"",""label"":""Featured metaobject""}","Requires metaobject definition to exist in store","Access fields via metaobject.field_key.value"
+29,collection_list,resource-list,array,"collection list, multiple collections, array, group, catalog","type, id, label","limit","Returns array of collection objects (max 20)","{""type"":""collection_list"",""id"":""collections"",""label"":""Collections"",""limit"":6}","Max 20 items by default; limit prop caps selection","Iterate with for collection in settings.collections"
+30,product_list,resource-list,array,"product list, multiple products, array, items, selection","type, id, label","limit","Returns array of product objects (max 20)","{""type"":""product_list"",""id"":""products"",""label"":""Products"",""limit"":4}","Max 20 items; limit prop caps selection","Iterate with for product in settings.products"
+31,article_list,resource-list,array,"article list, multiple articles, posts, blog posts, array","type, id, label","limit","Returns array of article objects (max 20)","{""type"":""article_list"",""id"":""articles"",""label"":""Articles"",""limit"":3}","Max 20 items; limit prop caps selection","Iterate with for article in settings.articles"
+32,metaobject_list,resource-list,array,"metaobject list, multiple metaobjects, array, custom data","type, id, label","limit","Returns array of metaobject instances (max 20)","{""type"":""metaobject_list"",""id"":""items"",""label"":""Items"",""limit"":10}","Max 20 items; limit prop caps selection","Requires metaobject definition in store"
+33,name,schema-property,string,"name, section name, display name, label, title","name","","Section name shown in theme editor","{""name"":""Hero Banner""}","Required string; shown as section label in editor","Displayed in Shopify theme editor section list"
+34,tag,schema-property,string,"tag, html tag, wrapper, element, section tag, div","tag","","Defaults to div if not specified","{""tag"":""section""}","Valid HTML5 element tags: div/section/article/aside/header/footer","Sets the HTML wrapper element for the section"
+35,class,schema-property,string,"class, css class, html class, wrapper class, styling","class","","No class added if not specified","{""class"":""featured-section spaced-section""}","Space-separated CSS class names string","Added to the section wrapper element's class attribute"
+36,limit,schema-property,number,"limit, max instances, section limit, count","limit","","No limit by default","{""limit"":1}","Integer; restricts how many times section can be added to template","Use limit: 1 for sections that should appear only once"
+37,max_blocks,schema-property,number,"max blocks, blocks limit, maximum, block count","max_blocks","","Default is 50 blocks","{""max_blocks"":16}","Integer; limits how many blocks can be added to section","Controls maximum number of blocks in section"
+38,presets,schema-property,array,"presets, defaults, initial, theme editor preset, add section","presets","","No presets means section cannot be added via theme editor","{""presets"":[{""name"":""Featured Product""}]}","Array of preset objects with name property; enables Add section","Without presets section only usable if in template JSON"
+39,blocks,schema-property,array,"blocks, block types, repeatable, dynamic blocks, content blocks","blocks","","No blocks if omitted","{""blocks"":[{""type"":""text"",""name"":""Text"",""settings"":[{""type"":""richtext"",""id"":""text"",""label"":""Text""}]}]}","Array of block type objects with type/name/settings","Define repeatable content units within a section"
+40,enabled_on,schema-property,object,"enabled on, template restriction, allow, whitelist, templates","enabled_on","","Available everywhere if not specified","{""enabled_on"":{""templates"":[""index"",""product""]}}","Object with templates array listing allowed template types","Restricts section to specific page template types"
+41,disabled_on,schema-property,object,"disabled on, template restriction, deny, blacklist, exclude","disabled_on","","No restrictions if not specified","{""disabled_on"":{""templates"":[""password""]}}","Object with templates array listing disallowed template types","Prevents section from appearing on specific template types"
+42,settings,schema-property,array,"settings, configuration, inputs, section settings, options","settings","","Empty settings array if omitted","{""settings"":[{""type"":""text"",""id"":""heading"",""label"":""Heading""}]}","Array of setting type objects; each requires type/id/label","Main container for all section-level input settings"
+43,default,schema-property,object,"default, initial values, preset defaults, starting configuration","default","","No default configuration if omitted","{""default"":{""settings"":{""heading"":""Welcome""},""blocks"":[{""type"":""text"",""settings"":{""text"":""Hello""}}]}}","Object with settings and blocks keys for initial values","Sets initial values when section is added via presets"
+44,locales,schema-property,object,"locales, translations, i18n, internationalization, language","locales","","No translations if omitted","{""locales"":{""en"":{""title"":""Title""},""fr"":{""title"":""Titre""}}}","Nested object by locale code then translation key","Provides translated strings for section labels"
+45,templates,schema-property,array,"templates, restrict, page types, template types, whitelist","templates","","Available on all templates if omitted","{""templates"":[""index"",""product"",""collection""]}","Array of template type strings","Restricts which templates the section appears on"

package/assets/data/shopify-best-practices.csv

@@ -0,0 +1,36 @@
+No,Rule,Category,Severity,Keywords,Description,Do,Dont,Code Example
+1,Use JSON templates,os2-architecture,critical,"json templates os2 sections theme editor","OS2.0 themes must use JSON templates for section-based customization","Use .json template files in /templates/","Use .liquid template files for page templates",""
+2,Presets required,os2-architecture,critical,"presets theme editor add section visibility","Every section must have non-empty presets array for Theme Editor visibility","Include presets: [{name: 'Section Name'}]","Omit presets array from schema",""
+3,Use render not include,performance,critical,"render include snippet partial performance deprecated","render tag is isolated and faster; include is deprecated and shares scope","{% render 'snippet' %}","{% include 'snippet' %}",""
+4,block.shopify_attributes required,schema,critical,"block attributes theme editor interaction click targeting","All block wrapper elements must include block.shopify_attributes for Theme Editor click targeting","<div {{ block.shopify_attributes }}>","<div class='block'>",""
+5,App blocks support,os2-architecture,high,"app blocks third-party extension type app","Include @app block type to allow third-party app integrations","blocks: [{ type: '@app' }]","Omit @app from blocks array",""
+6,Scope CSS to section ID,css,critical,"css scope section id specificity conflict leakage","CSS must be scoped to section ID to prevent style leakage across sections","#shopify-section-{{ section.id }} .title {}",".title { color: red; }",""
+7,Lazy load images,images,high,"lazy load image performance lcp loading attribute","Use loading=lazy on all images except hero/above-fold to improve performance","<img loading='lazy' src='...' alt='...'>","<img src='...' alt='...'>",""
+8,Always include alt text,accessibility,critical,"alt text image accessibility screen reader a11y","All images must have descriptive alt text for screen reader accessibility","<img src='...' alt='{{ block.settings.image_alt | escape }}'>","<img src='...'>",""
+9,Use semantic HTML,accessibility,high,"semantic html heading landmark section article a11y","Use proper semantic HTML elements for accessibility and SEO","<section>, <article>, <h2>, <nav>","<div class='section'>, <div class='heading'>",""
+10,ARIA labels for interactive elements,accessibility,high,"aria label button link interactive element a11y wcag","Interactive elements without visible text must have aria-label","<button aria-label='Close menu'>X</button>","<button>X</button>",""
+11,Limit section settings,schema,high,"settings count performance theme editor limit","Sections should have 20 or fewer settings to keep Theme Editor manageable","Group related settings into blocks","Add every possible setting to section-level schema",""
+12,Use image_picker with width/height,images,high,"image_picker width height aspect ratio responsive","Always pair image_picker with width and height settings for responsive images","Add image_width and image_height number settings","Use fixed pixel dimensions in CSS only",""
+13,Responsive images with image_url,images,high,"image_url responsive srcset width filter shopify cdn","Use Shopify image_url filter with width parameter for responsive images","{{ image | image_url: width: 800 }}","{{ image.src }}",""
+14,No hardcoded colors,css,high,"hardcoded color hex rgb css variable token design system","Use CSS variables or design tokens instead of hardcoded color values","color: var(--color-foreground)","color: #333333",""
+15,Mobile-first CSS,css,high,"mobile first responsive breakpoint media query min-width","Write base styles for mobile, use min-width media queries for larger screens","@media (min-width: 750px) { ... }","@media (max-width: 750px) { ... }",""
+16,Defer non-critical JavaScript,javascript,high,"defer javascript performance async non-critical load","Non-critical JS should use defer or async attribute to avoid render blocking","<script src='...' defer>","<script src='...'>",""
+17,Use section.settings not hardcoded text,schema,critical,"section settings hardcoded text content customizable","All user-facing text must come from schema settings, not hardcoded in Liquid","{{ section.settings.heading }}","<h2>Our Products</h2>",""
+18,Unique section IDs,schema,high,"section id unique namespace conflict css js","Use section.id to namespace CSS and JS to avoid conflicts between section instances","section-{{ section.id }}","my-section",""
+19,Color scheme support,os2-architecture,high,"color scheme picker background foreground os2 theme editor","Sections should support color_scheme setting for theme-wide color customization","Include color_scheme setting with type: color_scheme","Hardcode background and text colors",""
+20,Keyboard navigation support,accessibility,high,"keyboard navigation focus tab order interactive a11y wcag","All interactive elements must be keyboard accessible with visible focus states","button:focus-visible { outline: 2px solid; }","button:focus { outline: none; }",""
+21,Use aspect-ratio CSS,images,high,"aspect ratio css image video embed responsive layout shift","Use CSS aspect-ratio to prevent layout shift while images load","aspect-ratio: 16 / 9","Use padding-top hack for aspect ratio",""
+22,Limit block types to 16,schema,high,"block types limit maximum theme editor performance","Sections should have no more than 16 block types defined in schema","Keep block types focused and minimal","Add many redundant block type variations",""
+23,Enable section everywhere,os2-architecture,high,"enabled on templates json section groups everywhere","Sections should work in section groups to appear on any page template","Add section to section groups in JSON templates","Hardcode section to specific template only",""
+24,Preload hero images,performance,high,"preload hero image lcp performance above-fold critical resource","Hero/above-fold images should use fetchpriority=high and preload link","<img fetchpriority='high' loading='eager' ...>","<img loading='lazy' ...> for hero images",""
+25,Minify inline JavaScript,javascript,high,"minify javascript inline performance whitespace","Inline JS in sections should be minimal and deferred to external files when possible","Use external JS files loaded via defer","Write large inline <script> blocks in section files",""
+26,Use content_for_index,os2-architecture,high,"content_for_index homepage sections index json template","Homepage template must use content_for_index tag instead of hardcoded sections","{% content_for_index %}","{% section 'featured-products' %}",""
+27,Valid JSON schema,schema,critical,"json schema valid syntax parse error theme editor crash","Section schema must be valid JSON or the Theme Editor will fail to load","Validate JSON with a linter before deploying","Write schema JSON without validation",""
+28,Translatable strings,seo,high,"t translation i18n locale string shopify translate","User-facing strings should use Shopify translation filters for multi-language support","{{ 'sections.hero.title' | t }}","{{ 'Welcome to our store' }}",""
+29,Structured data for SEO,seo,high,"structured data json-ld schema org seo rich snippets","Add JSON-LD structured data to relevant sections like product and article","<script type='application/ld+json'>...</script>","Skip structured data markup",""
+30,forloop.index for unique IDs,schema,high,"forloop index unique id accessibility aria html attribute","Use forloop.index to generate unique IDs when rendering blocks in loops","id='tab-{{ forloop.index }}'","id='tab-1' hardcoded",""
+31,Avoid liquid in CSS files,css,high,"liquid css performance dynamic styles inline style attribute","Avoid using Liquid variables in .css files; use CSS variables set via inline styles","style='--color: {{ settings.color }}'","Liquid in .css asset files",""
+32,Use paginate for long lists,performance,high,"paginate pagination collection loop performance limit","Use Shopify paginate tag for collection loops to avoid loading all products","{% paginate collection.products by 12 %}","{% for product in collection.products %}",""
+33,section.blocks loop order,schema,high,"blocks loop order theme editor drag drop sortable","Always loop blocks via section.blocks to respect Theme Editor sort order","{% for block in section.blocks %}","Hardcode block rendering order",""
+34,Lazy-load videos,performance,high,"video lazy load autoplay performance bandwidth","Videos should be lazy-loaded and not autoplay with sound by default","<video loading='lazy' muted autoplay playsinline>","<video autoplay>",""
+35,Remove unused assets,performance,high,"unused assets css javascript dead code performance bundle size","Remove unused CSS and JS assets to reduce page weight and improve load time","Audit and remove unused snippet files and assets","Leave unused Liquid snippets and JS files in theme",""

package/assets/data/theme-dna.csv

@@ -0,0 +1,20 @@
+No,Theme,Version,Publisher,Keywords,CSS Variable Prefix,Section Naming,Block Conventions,Color Scheme Pattern,Typography Pattern,Spacing Pattern,File Structure Signature,Settings Schema Pattern,Snippet Patterns,Notes
+1,Dawn,15.x,Shopify,"dawn, shopify, free, os2, popular, latest",--color-,kebab-case with main-* prefix for templates,"@app blocks, type blocks, @theme blocks","color_scheme setting, color_scheme_group in schema","--font-heading-family, --font-body-family","--page-width, section padding vars","sections/main-*.liquid + sections/*.liquid, assets/base.css","color_scheme_group with schemes array, presets in schema","snippets/icon-*.liquid, snippets/price.liquid","Most popular free Shopify theme, OS2.0 reference implementation"
+2,Dawn,12.x,Shopify,"dawn, shopify, free, os2, v12",--color-,kebab-case with main-* prefix,"@app blocks, type blocks","color_scheme setting, 4 preset schemes","--font-heading-family, --font-body-family","--page-width, section-vertical-padding","sections/main-*.liquid + sections/*.liquid, assets/base.css","color_scheme_group, no dynamic color_scheme","snippets/icon-*.liquid, snippets/price.liquid","OS2.0 older iteration, fewer color scheme options"
+3,Dawn,8.x,Shopify,"dawn, shopify, free, os2, v8, early",--color-,kebab-case with main-* prefix,"@app blocks limited","Simple color_scheme setting","--font-heading-family, --font-body-family","--page-width basic","sections/main-*.liquid, assets/base.css","Basic OS2.0 schema, limited presets","snippets/icon-*.liquid","Early OS2.0 adoption, limited block types"
+4,Craft,Latest,Shopify,"craft, shopify, free, artisan, handmade, minimal",--color-,kebab-case,"@app blocks, custom craft blocks","color_scheme with craft palettes","--font-heading-family, --font-body-family","Generous whitespace, --section-padding","sections/*.liquid, assets/craft.css","color_scheme_group, craft-specific presets","snippets/craft-*.liquid","Focused on artisan/handmade stores, editorial layout"
+5,Sense,Latest,Shopify,"sense, shopify, free, health, beauty, clean",--color-,kebab-case,"@app blocks, standard blocks","color_scheme with clean palettes","--font-heading-family serif options, --font-body-family","Tight spacing, --spacing-sections","sections/*.liquid, assets/sense.css","color_scheme_group, sense presets","snippets/sense-*.liquid","Health/beauty focus, clean minimal aesthetic"
+6,Refresh,Latest,Shopify,"refresh, shopify, free, modern, bold",--color-,kebab-case,"@app blocks, standard blocks","color_scheme with bold palettes","--font-heading-family bold, --font-body-family","Balanced spacing, --page-width","sections/*.liquid, assets/refresh.css","color_scheme_group, refresh presets","snippets/refresh-*.liquid","Modern design, bold typography choices"
+7,Ride,Latest,Shopify,"ride, shopify, free, sports, outdoor, adventure",--color-,kebab-case,"@app blocks, video blocks","color_scheme with high contrast options","--font-heading-family bold/extended, --font-body-family","Compact spacing, full-width sections","sections/*.liquid, assets/ride.css","color_scheme_group, ride presets","snippets/ride-*.liquid","Sports/outdoor stores, full-bleed imagery"
+8,Taste,Latest,Shopify,"taste, shopify, free, food, restaurant, beverage",--color-,kebab-case,"@app blocks, menu blocks","color_scheme with warm palettes","--font-heading-family elegant, --font-body-family","Relaxed spacing, restaurant-style","sections/*.liquid, assets/taste.css","color_scheme_group, taste presets","snippets/taste-*.liquid","Food/restaurant focus, menu-style layouts"
+9,Studio,Latest,Shopify,"studio, shopify, free, creative, portfolio, artist",--color-,kebab-case,"@app blocks, media blocks","color_scheme with neutral palettes","--font-heading-family display, --font-body-family","Grid-based spacing, portfolio layout","sections/*.liquid, assets/studio.css","color_scheme_group, studio presets","snippets/studio-*.liquid","Creative/portfolio stores, gallery-first design"
+10,Colorblock,Latest,Shopify,"colorblock, shopify, free, colorful, bold, vibrant",--color-,kebab-case,"@app blocks, color blocks","color_scheme with vivid multicolor palettes","--font-heading-family bold, --font-body-family","Block-based spacing, color sections","sections/*.liquid, assets/colorblock.css","color_scheme_group, colorblock presets","snippets/colorblock-*.liquid","Bold colorful aesthetic, block-based layout"
+11,Impulse,Latest,Archetype Themes,"impulse, archetype, paid, fashion, apparel, premium",--imp- or --color-,kebab-case with feature-* pattern,"Custom blocks, promotion blocks, announcement","Multiple color schemes with accent colors","Custom font vars, --heading-font, --body-font","Variable spacing, promotional padding","sections/*.liquid, snippets/imp-*.liquid, assets/impulse.css","Custom color_scheme with accent, promotion settings","snippets/imp-*.liquid, snippets/announcement-*.liquid","Feature-rich paid theme, popular for fashion brands"
+12,Impact,Latest,Maestrooo,"impact, maestrooo, paid, bold, high-conversion, fashion",--impact- or --color-,kebab-case,"Custom blocks, video blocks, countdown","Bold color scheme with accent","--heading-font large/bold, --body-font","Tight promotional spacing, hero-first","sections/*.liquid, assets/impact.css, snippets/impact-*.liquid","Custom schema with conversion-focused settings","snippets/impact-*.liquid, snippets/countdown.liquid","High-conversion focus, bold visual hierarchy"
+13,Prestige,Latest,Maestrooo,"prestige, maestrooo, paid, luxury, premium, editorial",--prestige- or --color-,kebab-case with editorial patterns,"Custom blocks, media blocks, editorial","Minimal refined color scheme","--heading-font serif/display, --body-font","Generous whitespace, editorial spacing","sections/*.liquid, assets/prestige.css, snippets/prestige-*.liquid","Luxury-focused schema, editorial settings","snippets/prestige-*.liquid, snippets/media-*.liquid","Luxury/editorial brands, white space first"
+14,Symmetry,Latest,Clean Canvas,"symmetry, clean canvas, paid, versatile, multipurpose",--sym- or --color-,kebab-case,"Standard blocks, custom symmetry blocks","Multiple balanced color schemes","--heading-font, --body-font balanced","Symmetric spacing, grid-based","sections/*.liquid, assets/symmetry.css","Multipurpose schema with many layout options","snippets/sym-*.liquid","Multipurpose paid theme, highly configurable"
+15,Warehouse,Latest,Maestrooo,"warehouse, maestrooo, paid, large-catalog, b2b, wholesale",--wh- or --color-,kebab-case with catalog patterns,"Product blocks, filter blocks, collection","Functional color scheme","--heading-font, --body-font utility","Dense spacing, catalog-optimized","sections/*.liquid, assets/warehouse.css, snippets/wh-*.liquid","Catalog-focused schema, mega menu settings","snippets/wh-*.liquid, snippets/filter-*.liquid","Large catalog B2B focus, product-first layout"
+16,Pipeline,Latest,Groupthought,"pipeline, groupthought, paid, minimalist, clean, modern",--pl- or --color-,kebab-case,"Standard blocks, pipeline blocks","Clean minimal color scheme","--heading-font geometric, --body-font","Minimal clean spacing, content-first","sections/*.liquid, assets/pipeline.css","Minimal schema, clean settings structure","snippets/pl-*.liquid","Minimalist design, content-focused layout"
+17,Generic OS2.0,2.0+,Various,"os2, online store 2, generic, standard, modern",--color-,kebab-case,"@app blocks, type blocks, @theme blocks","color_scheme setting basic","--font-heading-family, --font-body-family","--page-width standard, section padding","sections/*.liquid, assets/*.css","Standard OS2.0 schema with presets","snippets/*.liquid","Baseline OS2.0 defaults for unrecognized modern themes"
+18,Generic Legacy,1.x,Various,"legacy, os1, vintage, pre-os2, old, classic",--,kebab-case or underscores,No @app blocks,"Basic color settings, no color_scheme","Custom font vars or inline styles","Fixed widths, basic padding","sections/*.liquid basic, assets/*.css","Simple settings without presets","snippets/*.liquid basic","Pre-OS2.0 patterns, limited customization API"
+19,Unknown,0.0.0,Unknown,"unknown, unrecognized, custom, bespoke",--,kebab-case preferred,Standard blocks assumed,"Neutral defaults","System fonts fallback","Standard spacing","sections/*.liquid","Minimal schema assumed","Standard snippets","Fallback for completely unrecognized themes"

package/assets/scripts/core.py

@@ -0,0 +1,194 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""Rebly Sections Core - BM25 search engine for Shopify section development"""
+
+import csv
+import re
+from pathlib import Path
+from math import log
+from collections import defaultdict
+
+DATA_DIR = Path(__file__).parent.parent / "data"
+MAX_RESULTS = 3
+
+CSV_CONFIG = {
+    "schema": {
+        "file": "schema-library.csv",
+        "search_cols": ["Type", "Category", "Keywords", "Notes"],
+        "output_cols": ["Type", "Category", "Returns", "Required Props", "Optional Props", "JSON Example", "Constraints"]
+    },
+    "liquid": {
+        "file": "liquid-stdlib.csv",
+        "search_cols": ["Name", "Kind", "Category", "Keywords"],
+        "output_cols": ["Name", "Kind", "Syntax", "Example", "Output", "Notes"]
+    },
+    "tokens": {
+        "file": "design-tokens.csv",
+        "search_cols": ["Token Name", "Category", "Keywords"],
+        "output_cols": ["Token Name", "Category", "Value", "CSS Variable", "Usage"]
+    },
+    "components": {
+        "file": "component-library/_index.csv",
+        "search_cols": ["Name", "Category", "Keywords", "Description"],
+        "output_cols": ["Name", "Slug", "Category", "Difficulty", "Blocks Used", "Settings Count", "ui_style_keywords", "File", "Description"]
+    },
+    "themes": {
+        "file": "theme-dna.csv",
+        "search_cols": ["Theme", "Keywords", "CSS Variable Prefix"],
+        "output_cols": ["Theme", "Version", "CSS Variable Prefix", "Section Naming", "Block Conventions", "Color Scheme Pattern"]
+    },
+    "practices": {
+        "file": "shopify-best-practices.csv",
+        "search_cols": ["Rule", "Category", "Keywords", "Description"],
+        "output_cols": ["Rule", "Category", "Severity", "Description", "Do", "Dont", "Code Example"]
+    }
+}
+
+# ============ BM25 IMPLEMENTATION ============
+class BM25:
+    """BM25 ranking algorithm for text search"""
+
+    def __init__(self, k1=1.5, b=0.75):
+        self.k1 = k1
+        self.b = b
+        self.corpus = []
+        self.doc_lengths = []
+        self.avgdl = 0
+        self.idf = {}
+        self.doc_freqs = defaultdict(int)
+        self.N = 0
+
+    def tokenize(self, text):
+        """Lowercase, split, remove punctuation, filter short words"""
+        text = re.sub(r'[^\w\s]', ' ', str(text).lower())
+        return [w for w in text.split() if len(w) > 2]
+
+    def fit(self, documents):
+        """Build BM25 index from documents"""
+        self.corpus = [self.tokenize(doc) for doc in documents]
+        self.N = len(self.corpus)
+        if self.N == 0:
+            return
+        self.doc_lengths = [len(doc) for doc in self.corpus]
+        self.avgdl = sum(self.doc_lengths) / self.N
+
+        for doc in self.corpus:
+            seen = set()
+            for word in doc:
+                if word not in seen:
+                    self.doc_freqs[word] += 1
+                    seen.add(word)
+
+        for word, freq in self.doc_freqs.items():
+            self.idf[word] = log((self.N - freq + 0.5) / (freq + 0.5) + 1)
+
+    def score(self, query):
+        """Score all documents against query"""
+        query_tokens = self.tokenize(query)
+        scores = []
+
+        for idx, doc in enumerate(self.corpus):
+            score = 0
+            doc_len = self.doc_lengths[idx]
+            term_freqs = defaultdict(int)
+            for word in doc:
+                term_freqs[word] += 1
+
+            for token in query_tokens:
+                if token in self.idf:
+                    tf = term_freqs[token]
+                    idf = self.idf[token]
+                    numerator = tf * (self.k1 + 1)
+                    denominator = tf + self.k1 * (1 - self.b + self.b * doc_len / self.avgdl)
+                    score += idf * numerator / denominator
+
+            scores.append((idx, score))
+
+        return sorted(scores, key=lambda x: x[1], reverse=True)
+
+
+# ============ SEARCH FUNCTIONS ============
+def _load_csv(filepath):
+    """Load CSV and return list of dicts"""
+    with open(filepath, 'r', encoding='utf-8') as f:
+        return list(csv.DictReader(f))
+
+
+def _search_csv(filepath, search_cols, output_cols, query, max_results):
+    """Core search function using BM25"""
+    if not filepath.exists():
+        return []
+
+    data = _load_csv(filepath)
+    documents = [" ".join(str(row.get(col, "")) for col in search_cols) for row in data]
+
+    bm25 = BM25()
+    bm25.fit(documents)
+    ranked = bm25.score(query)
+
+    results = []
+    for idx, score in ranked[:max_results]:
+        if score > 0:
+            row = data[idx]
+            results.append({col: row.get(col, "") for col in output_cols if col in row})
+
+    return results
+
+
+# ============ DOMAIN DETECTION ============
+domain_keywords = {
+    "schema": ["schema", "setting", "type", "input", "picker", "range", "checkbox", "select", "block type"],
+    "liquid": ["liquid", "tag", "filter", "object", "render", "assign", "capture", "for loop", "if condition"],
+    "tokens": ["token", "spacing", "color", "font", "breakpoint", "shadow", "variable", "css var", "design token"],
+    "components": ["section", "hero", "testimonial", "faq", "product grid", "cta", "newsletter", "gallery", "feature", "component", "pattern"],
+    "themes": ["theme", "dawn", "impulse", "impact", "craft", "detect", "dna", "theme profile"],
+    "practices": ["best practice", "performance", "accessibility", "seo", "os2", "lazy load", "responsive", "a11y"]
+}
+
+
+def detect_domain(query):
+    """Auto-detect domain from query keywords"""
+    query_lower = query.lower()
+    scores = {domain: sum(1 for kw in keywords if kw in query_lower) for domain, keywords in domain_keywords.items()}
+    best = max(scores, key=scores.get)
+    return best if scores[best] > 0 else "components"
+
+
+def search(query, domain=None, max_results=MAX_RESULTS):
+    """Main search function with auto-domain detection"""
+    if domain is None:
+        domain = detect_domain(query)
+
+    config = CSV_CONFIG.get(domain, CSV_CONFIG["components"])
+    filepath = DATA_DIR / config["file"]
+
+    if not filepath.exists():
+        return {"error": f"File not found: {filepath}", "domain": domain}
+
+    results = _search_csv(filepath, config["search_cols"], config["output_cols"], query, max_results)
+
+    return {
+        "domain": domain,
+        "query": query,
+        "file": config["file"],
+        "count": len(results),
+        "results": results
+    }
+
+
+def search_component(query, max_results=MAX_RESULTS):
+    """Enhanced component search - returns _index.csv match + .liquid file content"""
+    results = search(query, domain="components", max_results=max_results)
+    if "error" in results or not results.get("results"):
+        return results
+
+    component_dir = (DATA_DIR / "component-library").resolve()
+    for result in results["results"]:
+        liquid_file = result.get("File", "")
+        if liquid_file:
+            liquid_path = (component_dir / liquid_file).resolve()
+            # Path traversal guard: ensure resolved path stays within component dir
+            if str(liquid_path).startswith(str(component_dir)) and liquid_path.exists():
+                result["liquid_content"] = liquid_path.read_text(encoding="utf-8")
+
+    return results

package/assets/scripts/quality-gate.py

@@ -0,0 +1,179 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+Rebly Sections Quality Gate - Validate OS2.0 compliance
+Usage: python3 quality-gate.py path/to/section.liquid [--json]
+"""
+
+import argparse
+import json
+import re
+import sys
+from pathlib import Path
+
+
+QUALITY_CHECKS = [
+    ("schema_valid_json", "Schema block contains valid JSON"),
+    ("has_presets", "Schema has non-empty presets array"),
+    ("has_app_block", "Blocks array includes @app type"),
+    ("block_attributes", "Block wrappers have block.shopify_attributes"),
+    ("no_include_tag", "No {% include %} usage"),
+    ("css_scoped", "CSS uses section-scoped selector"),
+    ("no_liquid_in_style", "No complex Liquid inside <style>"),
+    ("has_section_tag", "Uses <section> HTML element"),
+    ("images_lazy_load", "Non-hero images use loading='lazy'"),
+    ("settings_have_labels", "All settings have label property"),
+]
+
+
+def extract_schema_json(content):
+    """Extract JSON from {% schema %} block"""
+    match = re.search(r'\{%[-\s]*schema\s*[-\s]*%\}(.*?)\{%[-\s]*endschema\s*[-\s]*%\}', content, re.DOTALL)
+    if not match:
+        return None
+    try:
+        return json.loads(match.group(1).strip())
+    except json.JSONDecodeError:
+        return None
+
+
+def check_schema_valid_json(content):
+    return extract_schema_json(content) is not None
+
+
+def check_has_presets(content):
+    schema = extract_schema_json(content)
+    if not schema:
+        return False
+    presets = schema.get("presets", [])
+    return isinstance(presets, list) and len(presets) > 0
+
+
+def check_has_app_block(content):
+    schema = extract_schema_json(content)
+    if not schema:
+        return False
+    blocks = schema.get("blocks", [])
+    return any(b.get("type") == "@app" for b in blocks)
+
+
+def check_block_attributes(content):
+    # If no blocks iteration, pass
+    if "section.blocks" not in content and "block.type" not in content:
+        return True
+    return "block.shopify_attributes" in content
+
+
+def check_no_include_tag(content):
+    return not re.search(r'\{%[-\s]*include\s', content)
+
+
+def check_css_scoped(content):
+    style_match = re.search(r'<style[^>]*>(.*?)</style>', content, re.DOTALL)
+    if not style_match:
+        return True  # No styles, pass
+    return "section.id" in content or "section_id" in content
+
+
+def check_no_liquid_in_style(content):
+    style_match = re.search(r'<style[^>]*>(.*?)</style>', content, re.DOTALL)
+    if not style_match:
+        return True
+    style_content = style_match.group(1)
+    # Allow simple output tags {{ }} but flag complex logic {% %}
+    complex_tags = re.findall(r'\{%[-\s]*(if|for|case|unless|elsif)\s', style_content)
+    return len(complex_tags) == 0
+
+
+def check_has_section_tag(content):
+    return bool(re.search(r'<section[\s>]', content))
+
+
+def check_images_lazy_load(content):
+    img_tags = re.findall(r'<img\s[^>]+>', content)
+    if not img_tags:
+        return True
+    # Skip first image (likely hero/eager); check subsequent ones
+    for img in img_tags[1:]:
+        if 'loading=' not in img:
+            return False
+    return True
+
+
+def check_settings_have_labels(content):
+    schema = extract_schema_json(content)
+    if not schema:
+        return True  # Can't check without valid schema
+    settings = schema.get("settings", [])
+    for s in settings:
+        if s.get("type") not in ("header", "paragraph") and "label" not in s:
+            return False
+    for block in schema.get("blocks", []):
+        for s in block.get("settings", []):
+            if s.get("type") not in ("header", "paragraph") and "label" not in s:
+                return False
+    return True
+
+
+CHECK_FUNCTIONS = {
+    "schema_valid_json": check_schema_valid_json,
+    "has_presets": check_has_presets,
+    "has_app_block": check_has_app_block,
+    "block_attributes": check_block_attributes,
+    "no_include_tag": check_no_include_tag,
+    "css_scoped": check_css_scoped,
+    "no_liquid_in_style": check_no_liquid_in_style,
+    "has_section_tag": check_has_section_tag,
+    "images_lazy_load": check_images_lazy_load,
+    "settings_have_labels": check_settings_have_labels,
+}
+
+
+def run_quality_gate(filepath):
+    """Run all quality checks on a .liquid file, return markdown report string"""
+    path = Path(filepath)
+    if not path.exists():
+        return f"Error: File not found: {filepath}"
+
+    content = path.read_text(encoding="utf-8")
+    results = []
+    passed = 0
+    failed = 0
+
+    for check_id, description in QUALITY_CHECKS:
+        check_fn = CHECK_FUNCTIONS[check_id]
+        try:
+            result = check_fn(content)
+            status = "PASS" if result else "FAIL"
+            if result:
+                passed += 1
+            else:
+                failed += 1
+            results.append(f"{'✓' if result else '✗'} {description}: {status}")
+        except Exception as e:
+            failed += 1
+            results.append(f"✗ {description}: ERROR ({e})")
+
+    summary = f"\n## Quality Gate: {path.name}\n"
+    summary += f"**Score:** {passed}/{passed + failed} checks passed\n\n"
+    summary += "\n".join(results)
+
+    if failed == 0:
+        summary += "\n\n**Result: PASS** ✓"
+    else:
+        summary += f"\n\n**Result: FAIL** — {failed} issue(s) found"
+
+    return summary
+
+
+def main():
+    parser = argparse.ArgumentParser(description="Rebly Sections Quality Gate")
+    parser.add_argument("filepath", help="Path to .liquid section file")
+    args = parser.parse_args()
+
+    result = run_quality_gate(args.filepath)
+    print(result)
+
+
+if __name__ == "__main__":
+    main()

package/assets/scripts/search.py

@@ -0,0 +1,72 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""Rebly Sections Search CLI
+Usage: python3 search.py "<query>" [--domain <domain>] [-n 3] [--component] [--json]
+Domains: schema, liquid, tokens, components, themes, practices
+"""
+
+import argparse
+import sys
+import io
+from core import CSV_CONFIG, MAX_RESULTS, search, search_component
+
+# UTF-8 stdout wrapper
+if sys.stdout.encoding and sys.stdout.encoding.lower() != 'utf-8':
+    sys.stdout = io.TextIOWrapper(sys.stdout.buffer, encoding='utf-8')
+if sys.stderr.encoding and sys.stderr.encoding.lower() != 'utf-8':
+    sys.stderr = io.TextIOWrapper(sys.stderr.buffer, encoding='utf-8')
+
+
+def format_output(result):
+    """Format results as Claude-optimized markdown"""
+    if "error" in result:
+        return f"Error: {result['error']}"
+    output = []
+    output.append(f"## Rebly Sections Search")
+    output.append(f"**Domain:** {result['domain']} | **Query:** {result['query']}")
+    output.append(f"**Source:** {result['file']} | **Found:** {result['count']} results\n")
+    for i, row in enumerate(result['results'], 1):
+        output.append(f"### Result {i}")
+        for key, value in row.items():
+            if key == "liquid_content":
+                continue
+            value_str = str(value)
+            if len(value_str) > 300:
+                value_str = value_str[:300] + "..."
+            output.append(f"- **{key}:** {value_str}")
+        output.append("")
+    return "\n".join(output)
+
+
+def format_component_output(result):
+    """Format component results including .liquid content"""
+    base = format_output(result)
+    for row in result.get('results', []):
+        if 'liquid_content' in row:
+            base += f"\n---\n### Pattern: {row.get('Name', 'Unknown')}\n```liquid\n{row['liquid_content']}\n```\n"
+    return base
+
+
+if __name__ == "__main__":
+    parser = argparse.ArgumentParser(description="Rebly Sections Search")
+    parser.add_argument("query", help="Search query")
+    parser.add_argument("--domain", "-d", choices=list(CSV_CONFIG.keys()), help="Search domain")
+    parser.add_argument("--max-results", "-n", type=int, default=MAX_RESULTS)
+    parser.add_argument("--component", "-c", action="store_true", help="Component search with .liquid content")
+    parser.add_argument("--json", action="store_true", help="JSON output")
+    args = parser.parse_args()
+
+    if args.component:
+        result = search_component(args.query, args.max_results)
+        if args.json:
+            import json
+            print(json.dumps(result, indent=2, ensure_ascii=False))
+        else:
+            print(format_component_output(result))
+    else:
+        result = search(args.query, args.domain, args.max_results)
+        if args.json:
+            import json
+            print(json.dumps(result, indent=2, ensure_ascii=False))
+        else:
+            print(format_output(result))