webc.site 0.1.18 → 0.1.19

package/README.md

@@ -0,0 +1,45 @@
+# 人工智能驱动的界面开发流程笔记
+
+## 纯 web 组件，支持无样式
+
+纯 web 组件，可适配全部前端框架。
+
+组件样式和组件逻辑完全拆分。
+
+可只引用组件的逻辑，然后自己写样式。
+
+同时支持无打包直接引用的使用方式，及配合 vite 等构建器打包的构建。
+
+## 初衷
+
+人工智能开发前端，比较大的问题是调试。
+
+虽然[谷歌反重力](https://antigravity.google) 之类的开发工具，有打开浏览器调试能力，但因为交互流程比较深、需要登录才能访问、需要后台准备数据等等，人工智能全自动浏览器调试流程经常被阻塞，无法继续。
+
+为了加速开发，我建议的方案是:
+
+不在组件中直接调用后端接口读取数据，而是用异步回调的函数的方式，暴露给上层。
+
+这样，就可以在 `Demo.svelte` 用假数据来展示组件的不同状态.
+
+不再对后端数据状态有依赖。不需要登录，不需要在调试的之前，去后端准备数据。
+
+也方便调整样式之后，查看在不同状态下，组件是否呈现有问题。
+
+具体方案，可以参考我的演示前端库 [webc-zh](https://github.com/webc-zh/webc-zh.github.io)。
+
+组件库在线浏览 [GitHub Page](https://webc-zh.github.io)
+
+这里我把前端组件，都拆分为独立的组件文件夹，每个文件夹包含了所有需要的资源（比如 svg 等）。
+
+如此做的好处是，可以类似[shadcn](https://ui.shadcn.com) 一样，实现按需添加。
+
+比如， `./comDev.sh com/scroll`，就可以对滚动条进行单独的开发，调试。
+
+调试默认会打开文件下的 `Demo.svelte` 作为调试入口。
+
+完整的开发提示词，可以参考 [.agents/skills/com/SKILL.md](.agents/skills/com/SKILL.md)
+
+谷歌反重力中 `/com ` 即可使用。
+
+![](https://i-01.eu.org/1779351273.avif)

package/importmap/genDoc.md

@@ -0,0 +1,9 @@
+给x目录下每个 js 在同级目录，写同名的 .md 介绍用途
+
+第一行是标题，以#号开头，标题不要包含 js 的名字，主要写起用途
+
+内容依次介绍每个导出的函数、参数.
+
+函数参数如果是回调函数，请写明回调函数的参数，返回值
+
+文风要简洁，不写形容词

package/importmap/x/On.js

@@ -0,0 +1,13 @@
+export const On = (elem, dict) => {
+  let event, func;
+  for (event in dict) {
+    func = dict[event];
+    elem.addEventListener(event, func);
+  }
+  return () => {
+    for (event in dict) {
+      func = dict[event];
+      elem.removeEventListener(event, func);
+    }
+  };
+};

package/importmap/x/On.md

@@ -0,0 +1,8 @@
+# 绑定与解绑事件监听
+
+- `On(elem, dict)`
+  - `elem`: DOM 元素。
+  - `dict`: 事件与回调对象。键为事件名，值为回调函数。回调函数格式：
+    - 参数：`e`（事件对象）。
+    - 返回值：无。
+  - 返回值：解绑函数。格式为 `() => void`。

package/importmap/x/a.js

@@ -0,0 +1,23 @@
+import { goto, selfA, B } from "../../x.js";
+B.addEventListener("click", (e) => {
+  var href, name, p;
+  p = e.target;
+  while (p) {
+    ({ nodeName: name } = p);
+    if (name === "A") {
+      ({ href } = p);
+      if (href) {
+        href = selfA(p, e);
+        if (href !== void 0) {
+          goto(href);
+        } else if (!p.target) {
+          p.target = "_blank";
+        }
+      }
+      break;
+    } else if (name === "BODY") {
+      break;
+    }
+    p = p.parentNode;
+  }
+});

package/importmap/x/a.md

@@ -0,0 +1,3 @@
+# 拦截链接点击实现无刷新跳转
+
+无导出函数。导入时自动在 `document.body` 监听点击事件。点击同站链接时阻止默认行为并调用 `goto` 跳转，点击外链且无 `target` 属性时将其设为 `_blank`。

package/importmap/x/delayRoute.js

@@ -0,0 +1,17 @@
+import { route } from "./route.js";
+
+// 避免 onMount 之前，route 被触发，导致重复加载数据
+export const delayRoute = (loadUrl) => {
+  let t;
+  const unbind = route((url, preUrl) => {
+    t = setTimeout(() => {
+      loadUrl(url, preUrl);
+    });
+  });
+  return () => {
+    unbind();
+    clearTimeout(t);
+  };
+};
+
+export default delayRoute;

package/importmap/x/delayRoute.md

@@ -0,0 +1,11 @@
+# 延迟路由触发避免重复加载数据
+
+用于 Svelte，避免组件被卸载前触发路由导致重复加载数据。
+
+- `delayRoute(loadUrl)`
+  - `loadUrl`: 路由变化时的回调函数。格式：
+    - 参数：
+      - `url`: 字符串，新 URL 路径。
+      - `preUrl`: 字符串（可选），旧 URL 路径。
+    - 返回值：无。
+  - 返回值：取消路由订阅并清除定时器的函数，格式为 `() => void`。

package/importmap/x/dom.js

@@ -0,0 +1,3 @@
+export const D = document,
+  B = D.body,
+  newEl = D.createElement.bind(D);

package/importmap/x/dom.md

@@ -0,0 +1,7 @@
+# DOM 属性与方法简写
+
+- `D`: `document` 实例。
+- `B`: `document.body` 元素。
+- `newEl(tagName)`
+  - `tagName`: 字符串，HTML 标签名。
+  - 返回值：新创建的 DOM 元素。

package/importmap/x/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "@3-/x",
+  "version": "0.2.0",
+  "description": "",
+  "keywords": [],
+  "homepage": "https://webc-zh.github.io",
+  "license": "MulanPSL-2.0",
+  "author": "i18n.site@gmail.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/webc-zh/webc-zh.github.io.git"
+  },
+  "files": [
+    "./*"
+  ],
+  "type": "module",
+  "exports": {
+    "./*": "./*"
+  },
+  "scripts": {},
+  "devDependencies": {}
+}

package/importmap/x/rmWait.js

@@ -0,0 +1,2 @@
+import { D } from "./dom.js";
+D.getElementById("W").remove();

package/importmap/x/rmWait.md

@@ -0,0 +1,3 @@
+# 移除加载等待元素
+
+无导出函数。导入时自动从 DOM 中移除 ID 为 `W` 的元素。

package/importmap/x/route.js

@@ -0,0 +1,59 @@
+import { On } from "../../x.js";
+export const nowUrl = () => location.pathname.slice(1),
+  [route, setPre, preUrl, refresh, removeSlash, split, setUrl, goto] = (() => {
+    let PRE = nowUrl(),
+      HOOK = [];
+    if (location.hash) PRE += location.hash;
+
+    const HASH = "#",
+      route = (hook) => {
+        HOOK.push(hook);
+        hook(nowUrl());
+        return () => {
+          HOOK = HOOK.filter((f) => f !== hook);
+        };
+      },
+      setPre = (url) => {
+        PRE = url;
+      },
+      preUrl = () => PRE,
+      refresh = (url) => {
+        url = url || nowUrl();
+        for (const f of HOOK) f(url, PRE);
+        setPre(url);
+      },
+      removeSlash = (url) => (url[0] === "/" ? url.slice(1) : url),
+      split = (str, s) => {
+        const p = str.indexOf(s);
+        return p >= 0 ? [str.slice(0, p), str.slice(p + 1)] : [str, ""];
+      },
+      setUrl = (url) => {
+        url = removeSlash(url);
+        if (url !== PRE) {
+          const [path, hash] = split(url, HASH),
+            [p] = split(PRE, HASH);
+          setPre(url);
+          if (path !== p) {
+            history.pushState(null, "", "/" + url);
+            return 1;
+          }
+          if (location.hash.slice(1) !== hash) {
+            location.hash = hash;
+            return;
+          }
+        }
+        window.dispatchEvent(new HashChangeEvent("hashchange"));
+      },
+      goto = (url) => {
+        if (setUrl(url)) refresh(url);
+      };
+
+    On(window, {
+      popstate: () => {
+        const url = nowUrl();
+        if (url !== split(PRE, HASH)[0]) refresh(url);
+      },
+    });
+
+    return [route, setPre, preUrl, refresh, removeSlash, split, setUrl, goto];
+  })();

package/importmap/x/route.md

@@ -0,0 +1,37 @@
+# 路由管理与跳转
+
+- `nowUrl()`
+  - 返回值：当前 URL 路径（不含首部斜杠）。
+
+- `route(hook)`
+  - `hook`: 路由变化时执行的回调函数。格式：
+    - 参数：
+      - `url`: 字符串，新 URL 路径。
+      - `preUrl`: 字符串（可选），旧 URL 路径。
+    - 返回值：无。
+  - 返回值：取消订阅的函数，格式为 `() => void`。
+
+- `setPre(url)`
+  - `url`: 字符串，新的前一次 URL 路径。
+
+- `preUrl()`
+  - 返回值：前一次的 URL 路径。
+
+- `refresh(url)`
+  - `url`: 字符串（可选），要触发回调的 URL 路径，默认是当前 URL。
+
+- `removeSlash(url)`
+  - `url`: 字符串。
+  - 返回值：移除首部斜杠后的字符串。
+
+- `split(str, s)`
+  - `str`: 待拆分字符串。
+  - `s`: 分隔符。
+  - 返回值：包含两个元素的数组 `[前部, 后部]`。
+
+- `setUrl(url)`
+  - `url`: 目标 URL 路径。
+  - 返回值：若路径改变返回 `1`，若仅 hash 改变不返回值。
+
+- `goto(url)`
+  - `url`: 目标 URL 路径。

package/importmap/x/selfA.js

@@ -0,0 +1,13 @@
+// 判断A标签的href是否为当前网站的, 如果是, 返回url, 以实现不刷新跳转
+export const selfA = (p, e) => {
+  var hash, url;
+  if (p.host === location.host) {
+    ({ hash } = p);
+    url = p.pathname.slice(1) + p.search;
+    if (hash) {
+      url += hash;
+    }
+    e.preventDefault();
+    return url;
+  }
+};

package/importmap/x/selfA.md

@@ -0,0 +1,6 @@
+# 同站链接点击校验与处理
+
+- `selfA(p, e)`
+  - `p`: `<a>` 元素。
+  - `e`: 点击事件对象。
+  - 返回值：若是同站链接，阻止默认行为并返回包含 search/hash 的相对路径，否则返回 `undefined`。

package/package.json

@@ -1 +1 @@
-{"name":"webc.site","version":"0.1.18","description":"","keywords":[],"homepage":"https://webc-zh.github.io","license":"MulanPSL-2.0","author":"i18n.site@gmail.com","repository":{"type":"git","url":"git+https://github.com/webc-zh/webc-zh.github.io.git"},"files":["./*"],"type":"module","exports":{"./*":"./*"},"scripts":{},"devDependencies":{}}
+{"name":"webc.site","version":"0.1.19","description":"","keywords":[],"homepage":"https://webc-zh.github.io","license":"MulanPSL-2.0","author":"i18n.site@gmail.com","repository":{"type":"git","url":"git+https://github.com/webc-zh/webc-zh.github.io.git"},"files":["./*"],"type":"module","exports":{"./*":"./*"},"scripts":{},"devDependencies":{}}

package/x.js

@@ -1 +1 @@
-const e=(e,t)=>{let n,r;for(n in t)r=t[n],e.addEventListener(n,r);return()=>{for(n in t)r=t[n],e.removeEventListener(n,r)}},t=document,n=t.body,r=t.createElement.bind(t);export{n as B,t as D,e as On,r as newEl};
+const e=(e,t)=>{let n,r;for(n in t)r=t[n],e.addEventListener(n,r);return()=>{for(n in t)r=t[n],e.removeEventListener(n,r)}},t=()=>location.pathname.slice(1),[n,r,i,a,o,s,c,l]=(()=>{let n=t(),r=[];location.hash&&(n+=location.hash);let i=e=>(r.push(e),e(t()),()=>{r=r.filter(t=>t!==e)}),a=e=>{n=e},o=()=>n,s=e=>{e||=t();for(let t of r)t(e,n);a(e)},c=e=>e[0]===`/`?e.slice(1):e,l=(e,t)=>{let n=e.indexOf(t);return n>=0?[e.slice(0,n),e.slice(n+1)]:[e,``]},u=e=>{if(e=c(e),e!==n){let[t,r]=l(e,`#`),[i]=l(n,`#`);if(a(e),t!==i)return history.pushState(null,``,`/`+e),1;if(location.hash.slice(1)!==r){location.hash=r;return}}window.dispatchEvent(new HashChangeEvent(`hashchange`))};return e(window,{popstate:()=>{let e=t();e!==l(n,`#`)[0]&&s(e)}}),[i,a,o,s,c,l,u,e=>{u(e)&&s(e)}]})(),u=(e,t)=>{var n,r;if(e.host===location.host)return{hash:n}=e,r=e.pathname.slice(1)+e.search,n&&(r+=n),t.preventDefault(),r},d=document,f=d.body,p=d.createElement.bind(d);export{f as B,d as D,e as On,l as goto,p as newEl,t as nowUrl,i as preUrl,a as refresh,o as removeSlash,n as route,u as selfA,r as setPre,c as setUrl,s as split};

package/x.js.map

@@ -1 +1 @@
-{"version":3,"file":"x.js","names":[],"sources":["../../importmap/x/On.js","../../importmap/x/dom.js"],"sourcesContent":["export const On = (elem, dict) => {\n  let event, func;\n  for (event in dict) {\n    func = dict[event];\n    elem.addEventListener(event, func);\n  }\n  return () => {\n    for (event in dict) {\n      func = dict[event];\n      elem.removeEventListener(event, func);\n    }\n  };\n};\n","export const D = document,\n  B = D.body,\n  newEl = D.createElement.bind(D);\n"],"mappings":"AAAA,MAAa,GAAM,EAAM,IAAS,CAChC,IAAI,EAAO,EACX,IAAK,KAAS,EACZ,EAAO,EAAK,GACZ,EAAK,iBAAiB,EAAO,CAAI,EAEnC,UAAa,CACX,IAAK,KAAS,EACZ,EAAO,EAAK,GACZ,EAAK,oBAAoB,EAAO,CAAI,CAExC,CACF,ECZa,EAAI,SACf,EAAI,EAAE,KACN,EAAQ,EAAE,cAAc,KAAK,CAAC"}
+{"version":3,"file":"x.js","names":[],"sources":["../../importmap/x/On.js","../../importmap/x/route.js","../../importmap/x/selfA.js","../../importmap/x/dom.js"],"sourcesContent":["export const On = (elem, dict) => {\n  let event, func;\n  for (event in dict) {\n    func = dict[event];\n    elem.addEventListener(event, func);\n  }\n  return () => {\n    for (event in dict) {\n      func = dict[event];\n      elem.removeEventListener(event, func);\n    }\n  };\n};\n","import { On } from \"x/On.js\";\n\nexport const nowUrl = () => location.pathname.slice(1),\n  [route, setPre, preUrl, refresh, removeSlash, split, setUrl, goto] = (() => {\n    let PRE = nowUrl(),\n      HOOK = [];\n    if (location.hash) PRE += location.hash;\n\n    const HASH = \"#\",\n      route = (hook) => {\n        HOOK.push(hook);\n        hook(nowUrl());\n        return () => {\n          HOOK = HOOK.filter((f) => f !== hook);\n        };\n      },\n      setPre = (url) => {\n        PRE = url;\n      },\n      preUrl = () => PRE,\n      refresh = (url) => {\n        url = url || nowUrl();\n        for (const f of HOOK) f(url, PRE);\n        setPre(url);\n      },\n      removeSlash = (url) => (url[0] === \"/\" ? url.slice(1) : url),\n      split = (str, s) => {\n        const p = str.indexOf(s);\n        return p >= 0 ? [str.slice(0, p), str.slice(p + 1)] : [str, \"\"];\n      },\n      setUrl = (url) => {\n        url = removeSlash(url);\n        if (url !== PRE) {\n          const [path, hash] = split(url, HASH),\n            [p] = split(PRE, HASH);\n          setPre(url);\n          if (path !== p) {\n            history.pushState(null, \"\", \"/\" + url);\n            return 1;\n          }\n          if (location.hash.slice(1) !== hash) {\n            location.hash = hash;\n            return;\n          }\n        }\n        window.dispatchEvent(new HashChangeEvent(\"hashchange\"));\n      },\n      goto = (url) => {\n        if (setUrl(url)) refresh(url);\n      };\n\n    On(window, {\n      popstate: () => {\n        const url = nowUrl();\n        if (url !== split(PRE, HASH)[0]) refresh(url);\n      },\n    });\n\n    return [route, setPre, preUrl, refresh, removeSlash, split, setUrl, goto];\n  })();\n","// 判断A标签的href是否为当前网站的, 如果是, 返回url, 以实现不刷新跳转\nexport const selfA = (p, e) => {\n  var hash, url;\n  if (p.host === location.host) {\n    ({ hash } = p);\n    url = p.pathname.slice(1) + p.search;\n    if (hash) {\n      url += hash;\n    }\n    e.preventDefault();\n    return url;\n  }\n};\n","export const D = document,\n  B = D.body,\n  newEl = D.createElement.bind(D);\n"],"mappings":"AAAA,MAAa,GAAM,EAAM,IAAS,CAChC,IAAI,EAAO,EACX,IAAK,KAAS,EACZ,EAAO,EAAK,GACZ,EAAK,iBAAiB,EAAO,CAAI,EAEnC,UAAa,CACX,IAAK,KAAS,EACZ,EAAO,EAAK,GACZ,EAAK,oBAAoB,EAAO,CAAI,CAExC,CACF,ECVa,MAAe,SAAS,SAAS,MAAM,CAAC,EACnD,CAAC,EAAO,EAAQ,EAAQ,EAAS,EAAa,EAAO,EAAQ,QAAe,CAC1E,IAAI,EAAM,EAAO,EACf,EAAO,CAAC,EACN,SAAS,OAAM,GAAO,SAAS,MAEnC,IACE,EAAS,IACP,EAAK,KAAK,CAAI,EACd,EAAK,EAAO,CAAC,MACA,CACX,EAAO,EAAK,OAAQ,GAAM,IAAM,CAAI,CACtC,GAEF,EAAU,GAAQ,CAChB,EAAM,CACR,EACA,MAAe,EACf,EAAW,GAAQ,CACjB,IAAa,EAAO,EACpB,IAAK,IAAM,KAAK,EAAM,EAAE,EAAK,CAAG,EAChC,EAAO,CAAG,CACZ,EACA,EAAe,GAAS,EAAI,KAAO,IAAM,EAAI,MAAM,CAAC,EAAI,EACxD,GAAS,EAAK,IAAM,CAClB,IAAM,EAAI,EAAI,QAAQ,CAAC,EACvB,OAAO,GAAK,EAAI,CAAC,EAAI,MAAM,EAAG,CAAC,EAAG,EAAI,MAAM,EAAI,CAAC,CAAC,EAAI,CAAC,EAAK,EAAE,CAChE,EACA,EAAU,GAAQ,CAEhB,GADA,EAAM,EAAY,CAAG,EACjB,IAAQ,EAAK,CACf,GAAM,CAAC,EAAM,GAAQ,EAAM,EAAK,GAAI,EAClC,CAAC,GAAK,EAAM,EAAK,GAAI,EAEvB,GADA,EAAO,CAAG,EACN,IAAS,EAEX,OADA,QAAQ,UAAU,KAAM,GAAI,IAAM,CAAG,EAC9B,EAET,GAAI,SAAS,KAAK,MAAM,CAAC,IAAM,EAAM,CACnC,SAAS,KAAO,EAChB,MACF,CACF,CACA,OAAO,cAAc,IAAI,gBAAgB,YAAY,CAAC,CACxD,EAYF,OAPA,EAAG,OAAQ,CACT,aAAgB,CACd,IAAM,EAAM,EAAO,EACf,IAAQ,EAAM,EAAK,GAAI,EAAE,IAAI,EAAQ,CAAG,CAC9C,CACF,CAAC,EAEM,CAAC,EAAO,EAAQ,EAAQ,EAAS,EAAa,EAAO,EAXlD,GAAQ,CACV,EAAO,CAAG,GAAG,EAAQ,CAAG,CAC9B,CASsE,CAC1E,GAAG,EC1DQ,GAAS,EAAG,IAAM,CAC7B,IAAI,EAAM,EACV,GAAI,EAAE,OAAS,SAAS,KAOtB,MANC,SAAW,EACZ,EAAM,EAAE,SAAS,MAAM,CAAC,EAAI,EAAE,OAC1B,IACF,GAAO,GAET,EAAE,eAAe,EACV,CAEX,ECZa,EAAI,SACf,EAAI,EAAE,KACN,EAAQ,EAAE,cAAc,KAAK,CAAC"}