notemend 0.1.1

package/src/store/comments.mjs

@@ -0,0 +1,3 @@
+import{readFileSync as E,writeFileSync as v,existsSync as x,mkdirSync as b,renameSync as J,rmSync as B}from"node:fs";import{dirname as M,join as p}from"node:path";import{categoryOf as T}from"./categories.mjs";import{CATEGORIES as Q,categoryOf as U}from"./categories.mjs";import{stateOf as W,STATE_LABEL as X}from"./status.mjs";const w=r=>{const t=String(r??"").split(/[/\\]/).pop();return/^[\w-][\w.-]*\.(png|jpe?g|webp|gif)$/i.test(t)?t:""},y=r=>Math.max(r.nextId||0,r.comments.reduce((t,s)=>Math.max(t,s.id),0)+1);function L(r,{route:t,selector:s,rx:i,ry:o,text:l,label:g,viewport:I,breakpoint:N,browser:$,device:D,tag:A,classes:n,nth:u,category:d}){const e={id:y(r),route:t,selector:s,rx:i,ry:o,text:l,tag:A||"",classes:n||[],nth:Number.isInteger(u)?u:null,label:g||"",viewport:I||null,breakpoint:N||"desktop",browser:$||"",device:D||"",category:T(d).id,status:"open",note:"",replies:[],doneBy:null,images:[],createdAt:new Date().toISOString(),updatedAt:null};return r.comments.push(e),e}function C(r,t,s,i){const o=r.comments.find(l=>l.id===Number(t));return o?((o.replies||=[]).push({author:s,text:i,at:new Date().toISOString()}),o.updatedAt=new Date().toISOString(),o):null}function G(r,t,s,i){const o=r.comments.find(g=>g.id===Number(t)),l=s?o?.replies?.find(g=>g.at===s&&g.author==="you"):o;return l?(l.text=i,o.updatedAt=new Date().toISOString(),o):null}function R(r,t,s){const i=r.comments.find(o=>o.id===Number(t));return i?(Object.assign(i,s,{updatedAt:new Date().toISOString()}),i):null}function H(r){const t=p(r,"feedback","comments.json"),s=p(r,"feedback","images"),i=p(r,"feedback","archive"),o=p(i,"images"),l=n=>`feedback/images/${n}`;return{root:r,file:t,imageDir:s,archiveDir:i,archiveImageDir:o,load:()=>x(t)?JSON.parse(E(t,"utf8")):{comments:[]},save:n=>{b(M(t),{recursive:!0}),v(`${t}.tmp`,JSON.stringify(n,null,2)+`
+`),J(`${t}.tmp`,t)},attach:(n,u,d)=>{const e=n.comments.find(O=>O.id===Number(u)),c=/^data:image\/(png|jpeg|webp|gif);base64,(.+)$/s.exec(d||"");if(!e||!c)return null;b(s,{recursive:!0});const f=c[1]==="jpeg"?"jpg":c[1];let a=Date.now();for(;x(p(s,`${e.id}-${a}.${f}`));)a++;const S=`${e.id}-${a}.${f}`;return v(p(s,S),Buffer.from(c[2],"base64")),(e.images||=[]).push(l(S)),e.updatedAt=new Date().toISOString(),l(S)},detach:(n,u,d)=>{const e=n.comments.find(a=>a.id===Number(u)),c=w(d),f=c&&e?.images?.find(a=>w(a)===c);return f?(B(p(s,c),{force:!0}),e.images=e.images.filter(a=>a!==f),e.updatedAt=new Date().toISOString(),!0):!1},remove:(n,u)=>{const d=n.comments.find(e=>e.id===Number(u));if(!d)return!1;for(const e of d.images||[])w(e)&&B(p(s,w(e)),{force:!0});return n.comments=n.comments.filter(e=>e.id!==Number(u)),!0},add:L,patch:R,reply:C,edit:G,nextId:y,prune:(n,{dry:u=!1,date:d=new Date().toISOString().slice(0,10)}={})=>{const e=n.comments.filter(m=>m.status==="done"),c=n.comments.filter(m=>m.status!=="done"),f=p(i,`comments-${d}.json`);if(u||!e.length)return{moving:e,keeping:c,archiveFile:f,images:e.flatMap(m=>m.images||[])};b(o,{recursive:!0});const a=[];for(const m of e)m.images=(m.images||[]).map(k=>{const h=w(k);if(!h)return k;const j=p(s,h),F=p(o,h);return x(j)&&J(j,F),a.push(h),`feedback/archive/images/${h}`});const S=x(f)?JSON.parse(E(f,"utf8")).comments||[]:[],O=new Set(S.map(m=>m.id));return v(f,JSON.stringify({comments:[...S,...e.filter(m=>!O.has(m.id))]},null,2)+`
+`),n.nextId=y(n),n.comments=c,{moving:e,keeping:c,archiveFile:f,images:a}}}}export{Q as CATEGORIES,X as STATE_LABEL,L as add,U as categoryOf,H as createStore,G as edit,y as nextId,R as patch,C as reply,w as shotName,W as stateOf};

package/src/store/status.mjs

@@ -0,0 +1 @@
+const o=e=>e.status!=="done"?"open":e.doneBy==="claude"?"claude":"done",d={open:"Open",done:"Resolved",claude:"Resolved by Claude"};export{d as STATE_LABEL,o as stateOf};

package/src/store/thread.mjs

@@ -0,0 +1 @@
+const m=e=>{const r=[{author:"you",text:e.text,at:e.createdAt,by:e.by,byName:e.byName,images:[]},...e.note?[{author:"claude",text:e.note,at:e.updatedAt,images:[]}]:[],...(e.replies||[]).map(t=>({...t,images:[]}))];for(const t of e.images||[]){const a=Number(/-(\d+)\.\w+$/.exec(t)?.[1]);let n=0;r.forEach((o,s)=>{Date.parse(o.at)<=a&&(n=s)}),r[n].images.push(t)}return r},i=e=>e.nickname||e.name||e.email,u=(e,r)=>{const t=String(e||"").toLowerCase();return t.includes("@")?[...new Set(r.filter(a=>[a.name,a.nickname,a.email].some(n=>{if(!n)return!1;const o=t.indexOf("@"+n.toLowerCase());return o!==-1&&!/[\p{L}\p{N}_.-]/u.test(t[o+n.length+1]??"")})).map(a=>a.email))]:[]};export{i as handleOf,u as mentionsIn,m as threadOf};

package/thread.d.ts

@@ -0,0 +1,5 @@
+export type Mentionable = { email: string; name?: string | null; nickname?: string | null };
+/** What a pick from the @ list writes: the nickname, else the name, else the email */
+export function handleOf(p: Mentionable): string;
+/** Everyone a text @mentions, by email */
+export function mentionsIn(text: string, people: Mentionable[]): string[];

package/types.d.ts

@@ -0,0 +1,60 @@
+export interface Breakpoint {
+  id: string;
+  label: string;
+  /** the band, in CSS px; `max: Infinity` for the widest, which has no canvas — it is your own window */
+  min: number;
+  max: number;
+  /** the width the canvas opens at */
+  ideal: number;
+  /** SVG paths for the switcher glyph (viewBox 0 0 20 20, stroked); defaults by id */
+  icon?: string;
+}
+
+/** The body drawn around the screen */
+export type Shell = 'island' | 'home' | 'punch' | 'tablet' | 'macbook' | 'laptop' | 'monitor';
+/** The browser chrome drawn on the screen — it decides the height the page gets */
+export type Browser = 'safari-ios' | 'chrome-android' | 'safari-ipad' | 'safari-mac' | 'chrome-windows';
+
+export interface Device {
+  id: string;
+  label: string;
+  /** menu section: 'Phone' | 'Tablet' | 'Laptop' | 'Desktop' | anything */
+  group: string;
+  /** the device's CSS screen size; the page gets what the browser chrome leaves of it */
+  w: number;
+  h: number;
+  shell: Shell;
+  browser: Browser;
+  /** the row's tooltip in the menu */
+  note?: string;
+}
+
+export interface NotemendOptions {
+  /** `false` keeps the bar out entirely — the switch Playwright flips */
+  enabled?: boolean;
+  /** bands of the breakpoint switcher; defaults to desktop ≥992 / tablet / landscape / portrait */
+  breakpoints?: Breakpoint[];
+  /** the preview shelf; defaults to the eight screens most visitors use */
+  devices?: Device[];
+  /** route -> [menu name, group]; unlisted pages fall back to their <title>. Also how an
+   *  address a dynamic route serves (/blog/some-post) gets into the menu */
+  pages?: Record<string, [name: string, group?: string]>;
+  /** group order in the page menu; unlisted pages land in the last one. Without it the
+   *  menu groups pages by folder */
+  groups?: string[];
+  /** show the toggle that hides Sanity's visual-editing overlay */
+  sanity?: boolean;
+  /** single-key shortcuts (C, G, 1–5…) and their list in the bar; `false` turns both off */
+  shortcuts?: boolean;
+  /** extra selectors the inspectors and comment picker must ignore */
+  ignore?: string[];
+  /** class names the grid overlay borrows from the project's own layout */
+  grid?: { container?: string; grid?: string; columns?: number };
+  /** base z-index of the bar; overlays stack around it */
+  zIndex?: number;
+}
+
+/** Everything but `enabled` can also live in `notemend.config.mjs` at the project root
+ *  (named exports or a default object), re-read on every page load. Options passed
+ *  here win over the file. */
+export default function notemend(options?: NotemendOptions): any;