@brillout/docpress 0.16.2 → 0.16.4

package/AGENTS.md

@@ -0,0 +1,30 @@
+🚨 STOP: Before responding to ANY message, you MUST complete STEP 1 below. No exceptions - even for simple questions like "1+1".
+
+@AI: Read and always respect all instructions in all AGENTS.md files. Treat this context as always up-to-date — it's never out of scope, no matter how much other context you have.
+
+List of `AGENTS.md` files:
+1. This file (project preferences)
+2. `~/.config/AGENTS.md` (user preferences)
+
+# CRITICAL AGENT INSTRUCTIONS - MUST FOLLOW
+
+## What is "ANY agentic session"?
+- User asks a question (even "1+1" or simple queries)
+- User requests a code change
+- User asks for information
+- Session resumes after idle time
+- First interaction in a conversation
+- EVERYTHING counts - no exceptions
+
+## STEP 1: ALWAYS START HERE (BEFORE ANY TASK)
+**MANDATORY:** When starting ANY agentic session, you MUST:
+1. Read both AGENTS.md files (this file + ~/.config/AGENTS.md)
+2. Say "I've successfully read [list-of-AGENTS.md-files]"
+3. List ALL instructions from both files
+4. Confirm: "✅ AGENTS.md check complete, proceeding with: [brief task description]"
+5. Then proceed with the task
+
+## STEP 2: AFTER MAKING CHANGES
+**MANDATORY:** After completing a task and if you made changes:
+1. Run `$ pnpm run -w format`
+2. Follow user preferences from ~/.config/AGENTS.md for commits and notifications

package/Layout.tsx

@@ -7,6 +7,7 @@ export { navLeftWidthMax }
 export { bodyMaxWidth }
 export { unexpandNav }
 export { blockMargin }
+export { scrollFadeMask }
 
 // - @media VS @container
 //   - Using `@container container-viewport` instead of @media would be interesting because @media doesn't consider the scrollbar width.
@@ -48,6 +49,12 @@ const viewDesktop = (mainViewWidthMax + navLeftWidthMin + blockMargin) as 1144 /
 const viewDesktopLarge = (mainViewWidthMax + navLeftWidthMax + blockMargin) as 1214 // 1214 = 840 + 370 + 4
 const bodyMaxWidth = 1300
 
+// Scroll fade effect at top/bottom edges
+const scrollFadeMask: React.CSSProperties = {
+  maskImage:
+    'linear-gradient(to bottom, rgba(0,0,0,0.3) 0px, black 20px, black calc(100% - 20px), rgba(0,0,0,0.3) 100%)',
+}
+
 // Avoid whitespace at the bottom of pages with almost no content
 const whitespaceBuster1: React.CSSProperties = {
   minHeight: '100vh',
@@ -230,6 +237,7 @@ function NavLeft() {
                 paddingBottom: 40,
                 minWidth: navLeftWidthMin,
                 width: '100%',
+                ...scrollFadeMask,
               }}
             >
               {navItemsDetached ? (
@@ -282,6 +290,7 @@ function isNavLeftAlwaysHidden() {
 const menuLinkStyle: React.CSSProperties = {
   height: '100%',
   padding: '0 var(--padding-side)',
+  paddingTop: 2,
   justifyContent: 'center',
 }
 
@@ -743,15 +752,25 @@ function DocsIcon() {
 }
 function MenuIcon() {
   return (
-    <svg
-      style={{ marginRight: 'calc(var(--icon-text-padding) + 2px)', verticalAlign: 'top', width: '1.3em' }}
-      className="decolorize-6"
-      viewBox="0 0 448 512"
-    >
-      <path
-        fill="currentColor"
-        d="M436 124H12c-6.627 0-12-5.373-12-12V80c0-6.627 5.373-12 12-12h424c6.627 0 12 5.373 12 12v32c0 6.627-5.373 12-12 12zm0 160H12c-6.627 0-12-5.373-12-12v-32c0-6.627 5.373-12 12-12h424c6.627 0 12 5.373 12 12v32c0 6.627-5.373 12-12 12zm0 160H12c-6.627 0-12-5.373-12-12v-32c0-6.627 5.373-12 12-12h424c6.627 0 12 5.373 12 12v32c0 6.627-5.373 12-12 12z"
-      ></path>
-    </svg>
+    <div style={{ display: 'inline-block', position: 'relative', top: 2, marginRight: 3, direction: 'rtl' }}>
+      {Array(3)
+        .fill(0)
+        .map((_, i) => (
+          <div
+            key={i}
+            style={{
+              background: 'currentColor',
+              width: (() => {
+                if (i === 0) return 18
+                if (i === 1) return 11
+                return 14
+              })(),
+              height: 2,
+              opacity: '0.8',
+              marginTop: i === 0 ? 0 : 4,
+            }}
+          />
+        ))}
+    </div>
   )
 }

package/MenuModal.tsx

@@ -3,7 +3,7 @@ export { MenuModal }
 import React from 'react'
 import { usePageContext } from './renderer/usePageContext'
 import { css } from './utils/css'
-import { bodyMaxWidth, viewDesktop, viewTablet } from './Layout'
+import { bodyMaxWidth, viewDesktop, viewTablet, scrollFadeMask } from './Layout'
 import { ExternalLinks } from './ExternalLinks'
 import { Style } from './utils/Style'
 import { NavigationWithColumnLayout } from './MenuModal/NavigationWithColumnLayout'
@@ -41,6 +41,7 @@ function MenuModal({ isTopNav, isNavLeftAlwaysHidden_ }: { isTopNav: boolean; is
             overflowY: 'scroll',
             // We don't set `container` to the parent #menu-modal-wrapper beacuse of a Chrome bug (showing a blank <MenuModal>). Edit: IIRC because #menu-modal-wrapper has `position: fixed`.
             container: 'container-viewport / inline-size',
+            ...scrollFadeMask,
           }}
         >
           <Nav />

package/dist/vite.config.js

@@ -39,5 +39,4 @@ const config = {
     // ▲ [WARNING] Transforming this CSS nesting syntax is not supported in the configured target environment ("chrome87", "edge88", "es2020", "firefox78", "safari14") [unsupported-css-nesting]
     // ```
     build: { target: 'es2022' },
-    clearScreen: false,
 };

package/docsearch/SearchLink.tsx

@@ -35,8 +35,6 @@ function SearchIcon() {
       width={18}
       style={{
         marginRight: 'var(--icon-text-padding)',
-        position: 'relative',
-        top: 1,
       }}
       className="decolorize-7"
     />

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@brillout/docpress",
-  "version": "0.16.2",
+  "version": "0.16.4",
   "type": "module",
   "dependencies": {
     "@brillout/picocolors": "^1.0.10",

package/vite.config.ts

@@ -43,5 +43,4 @@ const config: UserConfig = {
   // ▲ [WARNING] Transforming this CSS nesting syntax is not supported in the configured target environment ("chrome87", "edge88", "es2020", "firefox78", "safari14") [unsupported-css-nesting]
   // ```
   build: { target: 'es2022' },
-  clearScreen: false,
 }