@stacksjs/stx 0.2.445 → 0.2.446

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -43,6 +43,12 @@ export interface OfflineAppConfig {
43
43
  enabled: boolean;
44
44
  /** Screens fetched when the worker installs, so they open offline before they were visited. */
45
45
  pages?: string[];
46
+ /**
47
+ * Listed pages whose HTML is an account-independent shell. These may be
48
+ * retained despite the server's default no-store header. Never list pages
49
+ * containing server-rendered personal data; API no-store remains enforced.
50
+ */
51
+ staticPages?: string[];
46
52
  /** Path prefix of the app's API, whose GET answers are kept for offline. Default '/api/'. */
47
53
  apiPrefix?: string;
48
54
  /**
package/dist/cli.js CHANGED
@@ -1,6 +1,6 @@
1
1
  #!/usr/bin/env bun
2
2
  // @bun
3
- import"./chunk-56hvemdx.js";import"./chunk-73h7qjgq.js";import"./chunk-b5emjcf1.js";import"./chunk-2xnwsavq.js";import"./chunk-axydabse.js";import{U}from"./chunk-b3e0hcw0.js";import"./chunk-cs15xqf0.js";import"./chunk-aa7w63xc.js";import"./chunk-jwpcck1b.js";import"./chunk-7v163hb5.js";import"./chunk-dqr5n49p.js";import"./chunk-5zpt78j4.js";import"./chunk-0xntpjmp.js";import"./chunk-fmj4xvqm.js";import"./chunk-dn9thd0h.js";import"./chunk-7mbx7dzg.js";import"./chunk-bh432b7n.js";import"./chunk-mcgpeyy8.js";import"./chunk-3wdarmh7.js";import"./chunk-0vbpcef6.js";import"./chunk-xgwempyb.js";import"./chunk-ca24g1fa.js";import"./chunk-rvbcnahe.js";import"./chunk-n9jn3qzw.js";import"./chunk-4mppjen3.js";import"./chunk-8nsmx2w4.js";import"./chunk-gmzaknjp.js";import"./chunk-nw8p8eg9.js";import"./chunk-vyw0csez.js";import"./chunk-w9ebf2rb.js";import"./chunk-b7x7099z.js";import"./chunk-mnz6bdp3.js";import"./chunk-dwp3knc4.js";import"./chunk-hqywyyez.js";import{ft,gt}from"./chunk-3yws0k28.js";import"./chunk-97tb2m44.js";import"./chunk-9tbevvm3.js";import"./chunk-qa7j3j71.js";import"./chunk-s5drjm2j.js";import"./chunk-hkx8pggg.js";import"./chunk-m4q2e418.js";import"./chunk-9f0srtmg.js";import"./chunk-12mzd0gf.js";import"./chunk-cmctzee2.js";import{zs,Hs,Vs,Us,pr,Ws,qs,Ks,fr,gr,yn,bn,wn}from"./chunk-egaknprm.js";import"./chunk-39726w03.js";import"./chunk-r3f9jcf7.js";import{uo}from"./chunk-7676qzab.js";import{u}from"./chunk-cg8hg6cs.js";import{spawn as R}from"child_process";import S from"fs";import M from"os";import f from"path";import n from"process";import{CLI as V}from"@stacksjs/clapp";var j="0.2.445";var __dirname="/home/runner/work/stx/stx/packages/stx/bin",y=new V("stx");function B(h){let p=typeof h==="string"?Number.parseInt(h,10):h;if(Number.isNaN(p))return{isValid:!1,error:"Port must be a valid number",suggestion:"Try using a number between 1024 and 65535"};if(p<1024||p>65535)return{isValid:!1,error:"Port must be between 1024 and 65535",suggestion:"Try using a port between 1024 and 65535"};return{isValid:!0}}function A(h){try{if(!S.existsSync(h)){let x=f.dirname(h),t=f.basename(h);if(S.existsSync(x)){let o=S.readdirSync(x).filter((s)=>s.toLowerCase().includes(t.toLowerCase().substring(0,3))||s.endsWith(".stx")||s.endsWith(".md")),i=o.length>0?`File not found. Similar files in ${x}: ${o.slice(0,3).join(", ")}`:`File not found. Directory ${x} exists but doesn't contain the specified file.`;return{isValid:!1,error:`File does not exist: ${h}`,suggestion:i}}return{isValid:!1,error:`File does not exist: ${h}`,suggestion:"Check the file path and try again"}}if(S.statSync(h).isDirectory())return{isValid:!1,error:`Expected file but got directory: ${h}`,suggestion:"Specify a .stx or .md file path"};return{isValid:!0}}catch(p){return{isValid:!1,error:`Cannot access file: ${h}`,suggestion:"Check file permissions and path"}}}function z(h){let p=typeof h==="string"?Number.parseInt(h,10):h;if(Number.isNaN(p))return{isValid:!1,error:"Timeout must be a valid number",suggestion:"Specify timeout in milliseconds (e.g., 5000 for 5 seconds)"};if(p<100)return{isValid:!1,error:"Timeout too short (minimum 100ms)",suggestion:"Use a timeout of at least 100ms"};if(p>300000)return{isValid:!1,error:"Timeout too long (maximum 5 minutes)",suggestion:"Use a timeout of less than 300000ms (5 minutes)"};return{isValid:!0}}var O=(h)=>h.includes("*")||h.includes("?")||h.includes("{")||h.includes("["),H=(h)=>h.endsWith(".stx")||h.endsWith(".md");function F(h,p=1){if(console.error(`\u274C ${h.error}`),h.suggestion)console.error(`\uD83D\uDCA1 suggestion: ${h.suggestion}`);n.exit(p)}function L(h){if(!h)return;let p;try{p=JSON.parse(h)}catch(x){console.error(`\u274C --info-plist is not valid JSON: ${x.message}`),n.exit(1)}if(typeof p!=="object"||p===null||Array.isArray(p))console.error(`\u274C --info-plist must be a JSON object, e.g. '{"NSFocusStatusUsageDescription":"\u2026"}'`),n.exit(1);for(let[x,t]of Object.entries(p))if(typeof t!=="string"&&typeof t!=="number"&&typeof t!=="boolean")console.error(`\u274C --info-plist value for "${x}" must be a string, number or boolean`),n.exit(1);return p}async function G(h,p){try{let x=["test"],t=[];if(h&&h.length>0)for(let c of h)if(O(c))try{let r=await Array.fromAsync(new Bun.Glob(c).scan({onlyFiles:!0,absolute:!0}));if(r.length===0)console.warn(`Warning: No files found matching pattern: ${c}`);else if(t.push(...r),p.verbose)console.log(`Found ${r.length} file(s) matching pattern: ${c}`)}catch(r){return console.error(`Error expanding glob pattern ${c}:`,r),!1}else t.push(c);if(t.length===0)return console.error("Error: No test files found matching the provided patterns."),!1;if(x.push(...t),p.filter)x.push("--pattern",p.filter);if(p.timeout)x.push("--timeout",p.timeout.toString());if(p.reporter&&p.reporter!=="default")if(p.reporter==="junit"){let c=f.join(M.tmpdir(),`stx-test-report-${Date.now()}.xml`);x.push("--reporter",p.reporter),x.push("--reporter-outfile",c)}else console.warn(`Warning: Reporter '${p.reporter}' is not supported. Using default reporter.`);if(p.coverage)x.push("--coverage");if(p.watch)x.push("--watch");x.push("--preload",f.join(__dirname,"../../../test-utils/happy-dom.ts"));let e={...n.env,STX_TEST_MODE:"true",STX_TEST_UI:p.ui?"true":"false",STX_TEST_VERBOSE:p.verbose?"true":"false"},o="bun";if(p.verbose)console.log(`Running: ${o} ${x.join(" ")}`);let i=performance.now(),s=R(o,x,{stdio:"inherit",shell:!1,env:e});return new Promise((c)=>{s.on("close",(r)=>{let d=((performance.now()-i)/1000).toFixed(2);if(r===0)c(!0);else c(!1)}),n.on("SIGINT",()=>{console.log(`
3
+ import"./chunk-56hvemdx.js";import"./chunk-73h7qjgq.js";import"./chunk-b5emjcf1.js";import"./chunk-2xnwsavq.js";import"./chunk-axydabse.js";import{U}from"./chunk-b3e0hcw0.js";import"./chunk-cs15xqf0.js";import"./chunk-aa7w63xc.js";import"./chunk-jwpcck1b.js";import"./chunk-7v163hb5.js";import"./chunk-dqr5n49p.js";import"./chunk-5zpt78j4.js";import"./chunk-0xntpjmp.js";import"./chunk-fmj4xvqm.js";import"./chunk-dn9thd0h.js";import"./chunk-7mbx7dzg.js";import"./chunk-bh432b7n.js";import"./chunk-mcgpeyy8.js";import"./chunk-3wdarmh7.js";import"./chunk-0vbpcef6.js";import"./chunk-xgwempyb.js";import"./chunk-ca24g1fa.js";import"./chunk-rvbcnahe.js";import"./chunk-n9jn3qzw.js";import"./chunk-4mppjen3.js";import"./chunk-8nsmx2w4.js";import"./chunk-gmzaknjp.js";import"./chunk-nw8p8eg9.js";import"./chunk-vyw0csez.js";import"./chunk-w9ebf2rb.js";import"./chunk-b7x7099z.js";import"./chunk-mnz6bdp3.js";import"./chunk-dwp3knc4.js";import"./chunk-hqywyyez.js";import{ft,gt}from"./chunk-3yws0k28.js";import"./chunk-97tb2m44.js";import"./chunk-9tbevvm3.js";import"./chunk-qa7j3j71.js";import"./chunk-s5drjm2j.js";import"./chunk-hkx8pggg.js";import"./chunk-m4q2e418.js";import"./chunk-9f0srtmg.js";import"./chunk-12mzd0gf.js";import"./chunk-cmctzee2.js";import{zs,Hs,Vs,Us,pr,Ws,qs,Ks,fr,gr,yn,bn,wn}from"./chunk-egaknprm.js";import"./chunk-39726w03.js";import"./chunk-r3f9jcf7.js";import{uo}from"./chunk-7676qzab.js";import{u}from"./chunk-cg8hg6cs.js";import{spawn as R}from"child_process";import S from"fs";import M from"os";import f from"path";import n from"process";import{CLI as V}from"@stacksjs/clapp";var j="0.2.446";var __dirname="/home/runner/work/stx/stx/packages/stx/bin",y=new V("stx");function B(h){let p=typeof h==="string"?Number.parseInt(h,10):h;if(Number.isNaN(p))return{isValid:!1,error:"Port must be a valid number",suggestion:"Try using a number between 1024 and 65535"};if(p<1024||p>65535)return{isValid:!1,error:"Port must be between 1024 and 65535",suggestion:"Try using a port between 1024 and 65535"};return{isValid:!0}}function A(h){try{if(!S.existsSync(h)){let x=f.dirname(h),t=f.basename(h);if(S.existsSync(x)){let o=S.readdirSync(x).filter((s)=>s.toLowerCase().includes(t.toLowerCase().substring(0,3))||s.endsWith(".stx")||s.endsWith(".md")),i=o.length>0?`File not found. Similar files in ${x}: ${o.slice(0,3).join(", ")}`:`File not found. Directory ${x} exists but doesn't contain the specified file.`;return{isValid:!1,error:`File does not exist: ${h}`,suggestion:i}}return{isValid:!1,error:`File does not exist: ${h}`,suggestion:"Check the file path and try again"}}if(S.statSync(h).isDirectory())return{isValid:!1,error:`Expected file but got directory: ${h}`,suggestion:"Specify a .stx or .md file path"};return{isValid:!0}}catch(p){return{isValid:!1,error:`Cannot access file: ${h}`,suggestion:"Check file permissions and path"}}}function z(h){let p=typeof h==="string"?Number.parseInt(h,10):h;if(Number.isNaN(p))return{isValid:!1,error:"Timeout must be a valid number",suggestion:"Specify timeout in milliseconds (e.g., 5000 for 5 seconds)"};if(p<100)return{isValid:!1,error:"Timeout too short (minimum 100ms)",suggestion:"Use a timeout of at least 100ms"};if(p>300000)return{isValid:!1,error:"Timeout too long (maximum 5 minutes)",suggestion:"Use a timeout of less than 300000ms (5 minutes)"};return{isValid:!0}}var O=(h)=>h.includes("*")||h.includes("?")||h.includes("{")||h.includes("["),H=(h)=>h.endsWith(".stx")||h.endsWith(".md");function F(h,p=1){if(console.error(`\u274C ${h.error}`),h.suggestion)console.error(`\uD83D\uDCA1 suggestion: ${h.suggestion}`);n.exit(p)}function L(h){if(!h)return;let p;try{p=JSON.parse(h)}catch(x){console.error(`\u274C --info-plist is not valid JSON: ${x.message}`),n.exit(1)}if(typeof p!=="object"||p===null||Array.isArray(p))console.error(`\u274C --info-plist must be a JSON object, e.g. '{"NSFocusStatusUsageDescription":"\u2026"}'`),n.exit(1);for(let[x,t]of Object.entries(p))if(typeof t!=="string"&&typeof t!=="number"&&typeof t!=="boolean")console.error(`\u274C --info-plist value for "${x}" must be a string, number or boolean`),n.exit(1);return p}async function G(h,p){try{let x=["test"],t=[];if(h&&h.length>0)for(let c of h)if(O(c))try{let r=await Array.fromAsync(new Bun.Glob(c).scan({onlyFiles:!0,absolute:!0}));if(r.length===0)console.warn(`Warning: No files found matching pattern: ${c}`);else if(t.push(...r),p.verbose)console.log(`Found ${r.length} file(s) matching pattern: ${c}`)}catch(r){return console.error(`Error expanding glob pattern ${c}:`,r),!1}else t.push(c);if(t.length===0)return console.error("Error: No test files found matching the provided patterns."),!1;if(x.push(...t),p.filter)x.push("--pattern",p.filter);if(p.timeout)x.push("--timeout",p.timeout.toString());if(p.reporter&&p.reporter!=="default")if(p.reporter==="junit"){let c=f.join(M.tmpdir(),`stx-test-report-${Date.now()}.xml`);x.push("--reporter",p.reporter),x.push("--reporter-outfile",c)}else console.warn(`Warning: Reporter '${p.reporter}' is not supported. Using default reporter.`);if(p.coverage)x.push("--coverage");if(p.watch)x.push("--watch");x.push("--preload",f.join(__dirname,"../../../test-utils/happy-dom.ts"));let e={...n.env,STX_TEST_MODE:"true",STX_TEST_UI:p.ui?"true":"false",STX_TEST_VERBOSE:p.verbose?"true":"false"},o="bun";if(p.verbose)console.log(`Running: ${o} ${x.join(" ")}`);let i=performance.now(),s=R(o,x,{stdio:"inherit",shell:!1,env:e});return new Promise((c)=>{s.on("close",(r)=>{let d=((performance.now()-i)/1000).toFixed(2);if(r===0)c(!0);else c(!1)}),n.on("SIGINT",()=>{console.log(`
4
4
  Test run interrupted`),s.kill("SIGINT"),n.exit(1)})})}catch(x){return console.error("Error running tests:",x instanceof Error?x.message:String(x)),!1}}var J=n.argv.length>=3&&(H(n.argv[2])&&S.existsSync(n.argv[2])||O(n.argv[2]));if(J){let h=n.argv[2],p={port:3000,watch:!0,cache:!0,markdown:{syntaxHighlighting:{enabled:!0,serverSide:!0,defaultTheme:"github-dark",highlightUnknownLanguages:!0}}};for(let x=3;x<n.argv.length;x++){let t=n.argv[x];if(t==="--port"&&x+1<n.argv.length){let e=B(n.argv[++x]);if(!e.isValid)F(e);p.port=Number.parseInt(n.argv[x],10)}else if(t==="--no-watch")p.watch=!1;else if(t==="--highlight-theme"&&x+1<n.argv.length){if(!p.markdown)p.markdown={};if(!p.markdown.syntaxHighlighting)p.markdown.syntaxHighlighting={};p.markdown.syntaxHighlighting.defaultTheme=n.argv[++x]}else if(t==="--no-highlight"){if(!p.markdown)p.markdown={};if(!p.markdown.syntaxHighlighting)p.markdown.syntaxHighlighting={};p.markdown.syntaxHighlighting.enabled=!1}else if(t==="--no-highlight-unknown"){if(!p.markdown)p.markdown={};if(!p.markdown.syntaxHighlighting)p.markdown.syntaxHighlighting={};p.markdown.syntaxHighlighting.highlightUnknownLanguages=!1}else if(t==="--no-cache")p.cache=!1;else if(t==="--native")p.native=!0}if(O(h))try{let x=await Array.fromAsync(new Bun.Glob(h).scan({onlyFiles:!0,absolute:!0})),t=h.endsWith(".stx")?x.filter((s)=>s.endsWith(".stx")):h.endsWith(".md")?x.filter((s)=>s.endsWith(".md")):x.filter((s)=>s.endsWith(".stx")||s.endsWith(".md")),e=h.split("*")[0].replace(/\/$/,"")||".",o=f.resolve(e);try{let s=new Bun.Glob("**/*.stx"),r=(await Array.fromAsync(s.scan({cwd:o,onlyFiles:!0,absolute:!0}))).filter((l)=>/\[.+\]/.test(f.basename(l)));for(let l of r)if(!t.includes(l))t.push(l)}catch{}if(t.length===0)console.error(`Error: No STX or Markdown files found matching pattern: ${h}`),n.exit(1);if(!await bn(t,p))n.exit(1)}catch(x){console.error("Failed to process files:",x),n.exit(1)}else yn(h,p).catch((x)=>{console.error("Failed to start dev server:",x),n.exit(1)})}else{let h=function(t,e){let o=[];for(let i=0;i<=e.length;i++)o[i]=[i];for(let i=0;i<=t.length;i++)o[0][i]=i;for(let i=1;i<=e.length;i++)for(let s=1;s<=t.length;s++)if(e.charAt(i-1)===t.charAt(s-1))o[i][s]=o[i-1][s-1];else o[i][s]=Math.min(o[i-1][s-1]+1,o[i][s-1]+1,o[i-1][s]+1);return o[e.length][t.length]};y.command("docs","Generate documentation for components, templates, and directives").option("--output <dir>","Output directory for documentation",{default:"docs"}).option("--format <format>","Documentation format (markdown, html, json)",{default:"markdown"}).option("--components-dir <dir>","Components directory",{default:"components"}).option("--templates-dir <dir>","Templates directory",{default:"."}).option("--no-components","Disable components documentation").option("--no-templates","Disable templates documentation").option("--no-directives","Disable directives documentation").option("--extra-content <content>","Extra content to include in documentation").example("stx docs --output docs --format html").action(async(t)=>{try{if(await Us(t))console.log("Documentation generated successfully."),n.exit(0);else console.error("Documentation generation failed."),n.exit(1)}catch(e){console.error("Error generating documentation:",e),n.exit(1)}}),y.command("iconify <command>","Generate Iconify icon packages").option("--output <dir>","Output directory for generated packages",{default:"packages"}).option("--icons <icons>","Comma-separated list of specific icons to generate").example("stx iconify list").example("stx iconify generate mdi").example("stx iconify generate lucide --icons home,settings,user").action(async(t,e)=>{try{let{fetchCollections:o,generatePackage:i}=await import("./chunk-t61vdbje.js");if(t==="list"){console.log(`
5
5
  \uD83D\uDCDA Fetching available icon collections...
6
6
  `);let s=await o(),c=Object.entries(s).sort((r,l)=>l[1].total-r[1].total);console.log(`Available collections:
@@ -43,6 +43,12 @@ export interface OfflineAppConfig {
43
43
  enabled: boolean;
44
44
  /** Screens fetched when the worker installs, so they open offline before they were visited. */
45
45
  pages?: string[];
46
+ /**
47
+ * Listed pages whose HTML is an account-independent shell. These may be
48
+ * retained despite the server's default no-store header. Never list pages
49
+ * containing server-rendered personal data; API no-store remains enforced.
50
+ */
51
+ staticPages?: string[];
46
52
  /** Path prefix of the app's API, whose GET answers are kept for offline. Default '/api/'. */
47
53
  apiPrefix?: string;
48
54
  /**
@@ -128,6 +128,7 @@ export function generateOfflineWorker(config, buildId) {
128
128
  const settings = {
129
129
  build: String(buildId || "dev"),
130
130
  pages: Array.from(new Set((config.pages || []).filter((page) => typeof page === "string" && page.startsWith("/")))),
131
+ staticPages: (config.staticPages || []).filter((page) => typeof page === "string" && (config.pages || []).includes(page)),
131
132
  api: config.apiPrefix || "/api/",
132
133
  timeout: Math.max(500, Number(config.networkTimeoutMs) || 1500),
133
134
  networkFirst: (config.networkFirst || []).filter((path) => typeof path === "string" && path.startsWith("/")),
@@ -274,8 +275,9 @@ function announce(message) {
274
275
  // when it was kept.
275
276
  function revalidate(request, cache, keys, hit, kind) {
276
277
  return fetch(request).then(function (response) {
277
- if (noStore(response)) return Promise.all(keys.map(function (key) { return cache.delete(key); }));
278
- if (!keepable(response)) return;
278
+ var staticPage = kind === 'page' && keepStaticPage(request, response);
279
+ if (noStore(response) && !staticPage) return Promise.all(keys.map(function (key) { return cache.delete(key); }));
280
+ if (!keepable(response) && !staticPage) return;
279
281
  return store(cache, keys, response).then(function (print) {
280
282
  return unchanged(hit, response, print.hash).then(function (same) {
281
283
  if (same) return;
@@ -287,6 +289,11 @@ function revalidate(request, cache, keys, hit, kind) {
287
289
  });
288
290
  }
289
291
 
292
+ function keepStaticPage(request, response) {
293
+ return response.status === 200 && !response.redirected && response.type === 'basic'
294
+ && S.staticPages.indexOf(new URL(request.url).pathname) !== -1;
295
+ }
296
+
290
297
  // A dynamic route's kept page, under a key no real path has.
291
298
  function routeKey(route, fragment) {
292
299
  return variantUrl('/__stx_route__' + route.path, fragment);
@@ -595,7 +602,7 @@ function pageResponse(request, event) {
595
602
  return hit;
596
603
  }
597
604
  var network = fetch(request).then(function (response) {
598
- if (keepable(response)) keepAlive(event, store(cache, keys, response.clone()));
605
+ if (keepable(response) || keepStaticPage(request, response)) keepAlive(event, store(cache, keys, response.clone()));
599
606
  return response;
600
607
  });
601
608
  // What stands in when the network is not there, or slow: the kept copy,
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@stacksjs/stx",
3
3
  "type": "module",
4
- "version": "0.2.445",
4
+ "version": "0.2.446",
5
5
  "description": "A performant UI Framework. Powered by Bun.",
6
6
  "author": "Chris Breuer <chris@stacksjs.org>",
7
7
  "license": "MIT",
@@ -125,7 +125,7 @@
125
125
  "@stacksjs/desktop": "0.2.445",
126
126
  "@stacksjs/sanitizer": "0.2.445",
127
127
  "@stacksjs/ts-i18n": "^0.1.11",
128
- "bun-plugin-stx": "0.2.445",
128
+ "bun-plugin-stx": "0.2.446",
129
129
  "bunfig": "^0.15.19",
130
130
  "stx-router": "0.2.445",
131
131
  "ts-broadcasting": "^0.0.11",