pesanle-theme 0.1.0 → 0.1.1

package/README.md

@@ -20,9 +20,9 @@ Liquid-shaped language and **compiled** to a JavaScript render function:
 there is no interpreter at request time, and an unknown filter, a typo'd drop
 property or a missing snippet fails the push, not a shopper's page.
 
-- CLI reference: <https://github.com/ridhotamma/pesanle/blob/main/docs/THEME-CLI.md>
-- Language reference: <https://github.com/ridhotamma/pesanle/blob/main/docs/TEMPLATE-LANGUAGE.md>
-- How the engine works: <https://github.com/ridhotamma/pesanle/blob/main/docs/TEMPLATE_ENGINE.md>
+The same theme can be browsed and edited in the dashboard — **Online store →
+Themes → Code theme** — with a file tree, an editor and a live preview of the
+draft. The CLI and the dashboard write the same draft.
 
 ## Commands
 
@@ -59,14 +59,54 @@ my-theme/
   templates/index.tpl         home
   templates/product.tpl       a product page
   templates/catalog.tpl       the catalogue
+  templates/page.tpl          a seller's custom page
+  templates/pages/about.tpl   a page of the theme's own, at /about
   snippets/product-card.tpl   a partial
+  sections/featured.tpl       an editor-visible section with a schema
   assets/theme.css            scoped under .theme
 ```
 
 A route the theme does not define is drawn by the platform's default theme,
-so a project can start with one page and grow. Interactive pieces — the buy
-box, reviews, the order-tracking form — arrive as host slots
-(`{% slot 'productPurchase' %}`); a theme never ships its own JavaScript.
+so a project can start with one page and grow. Pages are addressed by file
+name: `templates/pages/about.tpl` answers `/about`. A seller's page built in
+the dashboard answers `/<slug>` (and `/pages/<slug>`) and is drawn by
+`templates/page.tpl` with its sections in the `pageBody` slot. Interactive
+pieces — the buy box, reviews, the cart drawer, the order-tracking form —
+arrive as host slots; a theme never ships its own JavaScript.
+
+## The language in one screen
+
+Output and text:
+
+```liquid
+<h1>{{ product.title }}</h1>
+<p>{{ product.price | money }}</p>
+```
+
+Tags: `{% if %} / {% elsif %} / {% else %}` (with `and`, `or`, `==`, `!=`,
+`<`, `>`, `contains`), `{% unless %}`, `{% for x in list %}…{% else %}…{% endfor %}`,
+`{% render 'snippet', key: value %}` (a partial, with its own scope),
+`{% slot 'productPurchase' %}` (a host island), `{% schema %}` (a section's
+settings, in JSON), `{% comment %}…{% endcomment %}`.
+
+Filters: `default`, `upcase`, `downcase`, `capitalize`, `strip`,
+`strip_newlines`, `handleize`, `url_encode`, `json`, `truncate`, `replace`,
+`append`, `prepend`, `split`, `join`, `size`, `first`, `last`, `slice`,
+`reverse`, `uniq`, `compact`, `map`, `where`, `sort`, `sum`, `date`, `plus`,
+`minus`, `times`, `divided_by`, `modulo`, `abs`, `floor`, `ceil`, `round`,
+`money`, `link_url`, `image_url`, `video_url`, `page_url`.
+
+Drops: `shop`, `page`, `settings`, `section`, `product`, `collection`,
+`category`, `article`, `blog`, `articles`, `search`, `listing`, `collections`,
+`categories`, `latest`, `products`, `vouchers`, `branches`, `cart`,
+`customer`, and `routes` (`home`, `products`, `search`, `cart`, `account`,
+`order_tracking`).
+
+A wrong filter, an unknown drop property or a missing snippet is a **compile
+error**: `push` reports the file and line and writes nothing. The language
+deliberately has no `assign`, no `include` with arbitrary scope, no `{% raw %}`
+and no way to emit `<script>`, `style="…"`, `on*` handlers or `javascript:`
+URLs — a theme is markup, and interactivity is the host's.
 
 ## Requirements
 

package/dist/cli.js

@@ -381,18 +381,36 @@ ${u(`[${F}]`)} ${T($)}`)}function V($){console.log(`  ${z0("OK")}   ${$}`)}funct
 }
 `,L0=`# Theme project
 
-A storefront theme for Pesanle, authored in the compiled template language.
-The reference is \`docs/TEMPLATE-LANGUAGE.md\` in the Pesanle repository.
+A storefront theme for Pesanle, authored in the compiled template language —
+HTML-first and Liquid-shaped. Every page is a file:
+
+  layout/theme.tpl            the shell around every page of the shop
+  templates/index.tpl         home
+  templates/product.tpl       a product page
+  templates/catalog.tpl       the catalogue
+  templates/pages/about.tpl   a page of the theme's own, at /about
+  snippets/product-card.tpl   a partial
+  assets/theme.css            styles, scoped under .theme
+
+Host slots draw the interactive pieces the platform owns, so a theme ships no
+JavaScript: {% slot 'productPurchase' %}, {% slot 'productReviews' %},
+{% slot 'pageBody' %}, {% slot 'cartTrigger' %}, {% slot 'cartDrawer' %} and
+{% slot 'orderTracking' %}. A wrong filter, an unknown drop property or a
+missing snippet fails \`push\` with the file and line — never a shopper's page.
+
+The same theme can be edited in the dashboard: Online store → Themes → Code
+theme, with a file tree, an editor and a live preview of the draft.
 
 \`\`\`bash
 pesanle-theme push       # compile and write the shop's draft
 pesanle-theme publish    # make the draft live
+pesanle-theme preview    # a signed link that draws the draft
 pesanle-theme pull       # write the live theme back into this folder
 pesanle-theme status     # the shop, its engine, and both versions
 \`\`\`
 
-The API key comes from \`PESANLE_API_KEY\`; the shop and project live in
-\`.pesanle.json\`. The key is never written to the file.
+The shop and theme name live in \`.pesanle.json\`; \`pesanle-theme login\`
+stores the token for this machine in \`~/.pesanle/credentials.json\`.
 `;function _0(){return{"layout/theme.tpl":G0,"templates/index.tpl":M0,"templates/product.tpl":q0,"templates/catalog.tpl":I0,"snippets/product-card.tpl":R0,"templates/pages/about.tpl":O0,"assets/theme.css":D0,"README.md":L0}}function c($){let K=[],N=[];for(let[W,b]of Object.entries(_0())){let Q=J0($.dir,W);if(B0(Q)&&!$.force){N.push(W);continue}X0(H0(Q),{recursive:!0}),Y0(Q,b),K.push(W)}return{written:K,skipped:N}}function U0($){let K={command:$[0]??"",dir:"",shop:"",name:"",api:"",email:"",engine:"",force:!1,draft:!1,push:!1,noEngine:!1},N=$.slice(1);for(let W=0;W<N.length;W+=1){let b=N[W],[Q,B]=b.startsWith("--")?b.split("=",2):["",""],Z=()=>B??N[++W]??"";switch(Q){case"--dir":K.dir=Z();break;case"--shop":K.shop=Z();break;case"--name":K.name=Z();break;case"--api":K.api=Z();break;case"--email":K.email=Z();break;case"--force":K.force=!0;break;case"--draft":K.draft=!0;break;case"--push":K.push=!0;break;case"--no-engine":K.noEngine=!0;break;case"":if(!K.dir)K.dir=b;else if(!K.engine&&P(b))K.engine=b;break;default:throw Error(`Unknown flag "${b}".`)}}if(K.command==="engine"&&!K.engine&&P(K.dir))K.engine=K.dir,K.dir="";return K}function P($){return $==="template"||$==="page-builder"}function j0($){let K=M();if(!K)throw Error('Not signed in. Run "pesanle-theme login" first.');return new H({api:O($)||K.api,token:K.token})}function J($){let K=d($.dir||"."),N=D(K),W=$.shop||N?.shop||"";if(!W)throw Error('No shop given: pass --shop <slug>, or run "pesanle-theme init --shop <slug>" to write .pesanle.json.');return{dir:K,shop:W,name:$.name||N?.name||w(K),api:j0($.api)}}function P0($){for(let K of $.diagnostics){let N=K.file?`${K.file}${K.loc?.start?.line?`:${K.loc.start.line}:${K.loc.start.column??1}`:""} `:"";console.error(`       ${N}${K.code?`${K.code}: `:""}${K.message}`)}}async function w0($){let K=O($.api),N=$.email||process.env.PESANLE_EMAIL||await h("Email");if(!N)throw Error("An email is required.");let W=await p("Password (hidden)","PESANLE_PASSWORD"),b=$.name||`pesanle-theme on ${w(process.env.HOME??"this machine")}`;X("Sign in");let B=await new H({api:K}).login(N,W,b);v({api:K,token:B.token,email:B.user.email,name:b}),V(`Signed in as ${B.user.name} <${B.user.email}>`),z(`API: ${K}`),z("Next: pesanle-theme init ./my-theme --shop <shop>")}async function A0(){let $=M();if(X("Sign out"),!$){z("Not signed in.");return}try{await new H({api:$.api,token:$.token}).logout(),V("Token revoked")}catch(K){R(K.message)}k(),V("Signed out on this machine")}async function C0($){let K=M();if(!K)throw Error('Not signed in. Run "pesanle-theme login" first.');let W=await new H({api:O($.api)||K.api,token:K.token}).me();V(`${W.name} <${W.email}>`),z(`API: ${K.api}`)}async function S0($){let K=d($.dir||".");j(K,{recursive:!0});let N=$.name||w(K);X("Scaffold");let W=c({dir:K,name:N,force:$.force});V(`${W.written.length} files written${W.skipped.length?`, ${W.skipped.length} kept`:""}`);for(let b of W.skipped)z(`kept ${b}`);if($.shop)L(K,{shop:$.shop,name:N}),V(`.pesanle.json points at "${$.shop}"`);else R("No --shop given: add .pesanle.json (or pass --shop) before pushing.");console.log(`
   ${N} is ready.`),z(`cd ${$.dir||"."} && pesanle-theme push`)}async function o($){let K=J($);X("Compile & push");let N=m(K.dir);if(Object.keys(N).length===0)throw Error(`No theme files under ${K.dir}. A theme needs at least templates/index.tpl \u2014 run "pesanle-theme init" first.`);let W=await K.api.push(K.shop,N,K.name);if(V(`${Object.keys(N).length} files \u2192 version ${W.version}`),W.warnings.length>0){R(`${W.warnings.length} warning(s)`);for(let b of W.warnings)z(`${b.file??""}${b.file?": ":""}${b.message}`)}if(!$.noEngine)V("Shop is on the template engine");z("Make it live with: pesanle-theme publish")}async function E0($){if($.push)await o($);let K=J($);X("Publish");let N=await K.api.publish(K.shop);V(`Live \u2014 version ${N.version}`),z(N.url)}async function y0($){let K=J($);X("Preview");let N=await K.api.preview(K.shop);V(`Draft version ${N.version}`),console.log(`
   ${T("Open:")} ${N.url}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pesanle-theme",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Compile and push a storefront theme to a Pesanle shop: scaffold, draft, publish, preview.",
   "license": "MIT",
   "type": "module",
@@ -23,15 +23,7 @@
     "cli",
     "template"
   ],
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/ridhotamma/pesanle.git",
-    "directory": "packages/theme-cli"
-  },
-  "homepage": "https://github.com/ridhotamma/pesanle/blob/main/docs/THEME-CLI.md",
-  "bugs": {
-    "url": "https://github.com/ridhotamma/pesanle/issues"
-  },
+  "homepage": "https://pesanle.id",
   "publishConfig": {
     "access": "public"
   },