@ansiversa/components 0.0.140 → 0.0.142

package/index.ts

@@ -40,6 +40,7 @@ export { default as PortfolioCreatorSummary } from './src/Summary/PortfolioCreat
 export { default as AvImageUploader } from "./src/components/media/AvImageUploader.astro";
 export { default as AvAiAssist } from "./src/components/Ai/AvAiAssist.astro";
 export { default as FaqManager } from "./src/components/Admin/FaqManager.astro";
+export { AvBookmarkButton, AvBookmarksEmpty, AvBookmarksList } from "./src/components/Bookmarks";
 export { AppLogo } from "./src/Logo";
 export type { AppLogoProps } from "./src/Logo";
 export { default as ResumeBuilderShell } from './src/resume-templates/ResumeBuilderShell.astro';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ansiversa/components",
-  "version": "0.0.140",
+  "version": "0.0.142",
   "description": "Shared UI components and layouts for the Ansiversa ecosystem",
   "type": "module",
   "exports": {

package/src/components/Admin/FaqManager.astro

@@ -118,22 +118,26 @@ const initialAudience = defaultAudience === "admin" ? "admin" : "user";
             <tr>
               <td>
                 <div class="av-faq-manager__order-cell">
-                  <input
-                    class="av-input av-faq-manager__order-input"
-                    type="number"
-                    min="1"
-                    x-model.number="faq.sort_order"
-                    :disabled="loading || saving"
-                    aria-label="Sort order"
-                  />
+                  <span class="av-faq-manager__order-pill" x-text="faq.sort_order"></span>
                   <AvButton
                     size="sm"
                     variant="ghost"
                     type="button"
-                    @click.prevent="saveSort(faq)"
-                    :disabled="loading || saving || !faq.id"
+                    @click.prevent="moveFaq(index, -1)"
+                    :disabled="loading || saving || index === 0 || !faq.id || !faqs[index - 1]?.id"
+                    aria-label="Move up"
                   >
-                    Save
+                    ↑
+                  </AvButton>
+                  <AvButton
+                    size="sm"
+                    variant="ghost"
+                    type="button"
+                    @click.prevent="moveFaq(index, 1)"
+                    :disabled="loading || saving || index === faqs.length - 1 || !faq.id || !faqs[index + 1]?.id"
+                    aria-label="Move down"
+                  >
+                    ↓
                   </AvButton>
                 </div>
               </td>
@@ -658,41 +662,70 @@ const initialAudience = defaultAudience === "admin" ? "admin" : "user";
         }
       },
 
-      async saveSort(faq) {
-        if (!faq?.id) return;
+      normalizeSortOrder(value, fallbackOrder) {
+        const parsed = Number.parseInt(String(value ?? ""), 10);
+        if (Number.isInteger(parsed) && parsed >= 1) return parsed;
+        return Math.max(1, Number.parseInt(String(fallbackOrder ?? 1), 10) || 1);
+      },
+
+      async patchSortOrder(id, sortOrder) {
+        const response = await fetch(
+          this.endpoint(`/api/admin/faqs/${encodeURIComponent(String(id))}.json`),
+          {
+            method: "PATCH",
+            credentials: "include",
+            headers: {
+              "Content-Type": "application/json",
+            },
+            body: JSON.stringify({ sort_order: sortOrder }),
+          },
+        );
+
+        const responsePayload = await this.parseJson(response);
+
+        if (!response.ok) {
+          throw new Error(this.mapError(response.status, responsePayload, "Failed to update sort order."));
+        }
+      },
+
+      async moveFaq(index, direction) {
+        const currentIndex = Number(index);
+        const nextIndex = currentIndex + Number(direction);
+        if (!Number.isInteger(currentIndex) || !Number.isInteger(nextIndex)) return;
+        if (nextIndex < 0 || nextIndex >= this.faqs.length) return;
+
+        const currentFaq = this.faqs[currentIndex];
+        const nextFaq = this.faqs[nextIndex];
+        if (!currentFaq?.id || !nextFaq?.id) return;
 
-        const nextSortOrder = Number(faq.sort_order);
-        if (!Number.isInteger(nextSortOrder) || nextSortOrder < 1) {
+        const currentOrder = this.normalizeSortOrder(currentFaq.sort_order, currentIndex + 1);
+        const nextOrder = this.normalizeSortOrder(nextFaq.sort_order, nextIndex + 1);
+        if (currentOrder < 1 || nextOrder < 1) {
           this.error = "Sort order must be 1 or greater.";
           return;
         }
 
+        const snapshot = this.faqs.map((item) => ({ ...item }));
+        const reordered = this.faqs.map((item) => ({ ...item }));
+        [reordered[currentIndex], reordered[nextIndex]] = [reordered[nextIndex], reordered[currentIndex]];
+        reordered[nextIndex].sort_order = currentOrder;
+        reordered[currentIndex].sort_order = nextOrder;
+
+        this.faqs = reordered;
+
         this.saving = true;
         this.error = "";
         this.notice = "";
 
         try {
-          const response = await fetch(
-            this.endpoint(`/api/admin/faqs/${encodeURIComponent(String(faq.id))}.json`),
-            {
-              method: "PATCH",
-              credentials: "include",
-              headers: {
-                "Content-Type": "application/json",
-              },
-              body: JSON.stringify({ sort_order: nextSortOrder }),
-            },
-          );
-
-          const responsePayload = await this.parseJson(response);
-
-          if (!response.ok) {
-            throw new Error(this.mapError(response.status, responsePayload, "Failed to update sort order."));
-          }
+          await Promise.all([
+            this.patchSortOrder(reordered[currentIndex].id, reordered[currentIndex].sort_order),
+            this.patchSortOrder(reordered[nextIndex].id, reordered[nextIndex].sort_order),
+          ]);
 
-          this.notice = "Sort order updated.";
-          await this.fetchFaqs();
+          this.notice = "Order updated.";
         } catch (sortError) {
+          this.faqs = snapshot;
           this.error = sortError?.message || "Failed to update sort order.";
         } finally {
           this.saving = false;
@@ -709,9 +742,18 @@ const initialAudience = defaultAudience === "admin" ? "admin" : "user";
     align-items: center;
   }
 
-  .av-faq-manager__order-input {
-    width: 88px;
-    min-height: 2.25rem;
+  .av-faq-manager__order-pill {
+    min-width: 2rem;
+    height: 2rem;
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    border-radius: 9999px;
+    border: 1px solid rgba(148, 163, 184, 0.35);
+    color: rgba(226, 232, 240, 0.95);
+    font-size: 0.78rem;
+    line-height: 1;
+    padding: 0 0.5rem;
   }
 
   .av-faq-manager__publish-toggle {

package/src/components/Bookmarks/AvBookmarkButton.astro

@@ -0,0 +1,93 @@
+---
+type Size = "sm" | "md";
+
+interface Props {
+  active: boolean;
+  activeExpr?: string;
+  title?: string;
+  activeTitle?: string;
+  size?: Size;
+  onClick?: string;
+}
+
+const {
+  active,
+  activeExpr,
+  title = "Save bookmark",
+  activeTitle = "Remove bookmark",
+  size = "md",
+  onClick,
+} = Astro.props as Props;
+
+const iconPx = size === "sm" ? 16 : 20;
+const checkPx = size === "sm" ? 10 : 12;
+const resolvedActiveExpr = activeExpr ?? (active ? "true" : "false");
+const escapeSingleQuotes = (value: string) => value.replace(/\\/g, "\\\\").replace(/'/g, "\\'");
+const tooltipExpr = `(${resolvedActiveExpr}) ? '${escapeSingleQuotes(activeTitle)}' : '${escapeSingleQuotes(title)}'`;
+---
+
+<button
+  type="button"
+  class="av-bookmark-btn"
+  :class={`(${resolvedActiveExpr}) ? 'is-active' : ''`}
+  x-on:click.stop.prevent={onClick}
+  title={active ? activeTitle : title}
+  :title={tooltipExpr}
+  aria-label={title}
+  :aria-label={`(${resolvedActiveExpr}) ? ${JSON.stringify(activeTitle)} : ${JSON.stringify(title)}`}
+  :aria-pressed={resolvedActiveExpr}
+>
+  <span class="av-bookmark-btn__icon" :class={`(${resolvedActiveExpr}) ? 'is-hidden' : ''`} aria-hidden="true">
+    <svg width={iconPx} height={iconPx} viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+      <path d="M19 21 12 16 5 21V5a2 2 0 0 1 2-2h10a2 2 0 0 1 2 2z" />
+    </svg>
+  </span>
+  <span class="av-bookmark-btn__icon" :class={`(${resolvedActiveExpr}) ? '' : 'is-hidden'`} aria-hidden="true">
+    <svg width={iconPx} height={iconPx} viewBox="0 0 24 24" fill="currentColor" stroke="none">
+      <path d="M19 21 12 16 5 21V5a2 2 0 0 1 2-2h10a2 2 0 0 1 2 2z" />
+    </svg>
+    <svg class="av-bookmark-btn__check" width={checkPx} height={checkPx} viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round">
+      <path d="m5 13 4 4L19 7" />
+    </svg>
+  </span>
+</button>
+
+<style>
+  .av-bookmark-btn {
+    position: relative;
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    width: 2rem;
+    height: 2rem;
+    border: 1px solid rgba(148, 163, 184, 0.35);
+    border-radius: 999px;
+    background: rgba(15, 23, 42, 0.65);
+    color: #94a3b8;
+    transition: all 0.2s ease;
+  }
+  .av-bookmark-btn:hover {
+    border-color: rgba(14, 165, 233, 0.6);
+    color: #7dd3fc;
+  }
+  .av-bookmark-btn.is-active {
+    border-color: rgba(14, 165, 233, 0.8);
+    color: #38bdf8;
+    background: rgba(14, 116, 144, 0.25);
+  }
+  .av-bookmark-btn__icon {
+    position: absolute;
+    inset: 0;
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    transition: opacity 0.15s ease;
+  }
+  .av-bookmark-btn__icon.is-hidden {
+    opacity: 0;
+  }
+  .av-bookmark-btn__check {
+    position: absolute;
+    color: #0f172a;
+  }
+</style>

package/src/components/Bookmarks/AvBookmarksEmpty.astro

@@ -0,0 +1,5 @@
+---
+import AvEmptyState from "../../AvEmptyState.astro";
+---
+
+<AvEmptyState headline="No bookmarks yet" description="Save items to find them quickly here." />

package/src/components/Bookmarks/AvBookmarksList.astro

@@ -0,0 +1,83 @@
+---
+import AvCard from "../../AvCard.astro";
+import AvBookmarkButton from "./AvBookmarkButton.astro";
+
+type RightSlot = {
+  active: boolean;
+  activeExpr?: string;
+  title?: string;
+  activeTitle?: string;
+  size?: "sm" | "md";
+  onClick?: string;
+};
+
+type Item = {
+  title: string;
+  subtitle?: string;
+  description?: string;
+  href?: string;
+  rightSlot?: RightSlot;
+};
+
+interface Props {
+  items: Item[];
+}
+
+const { items } = Astro.props as Props;
+---
+
+<div class="av-bookmarks-list">
+  {items.map((item) => (
+    <AvCard className="av-bookmarks-list__card">
+      <div class="av-bookmarks-list__row">
+        <div>
+          {item.href ? (
+            <a class="av-bookmarks-list__title" href={item.href}>{item.title}</a>
+          ) : (
+            <p class="av-bookmarks-list__title">{item.title}</p>
+          )}
+          {item.subtitle ? <p class="av-bookmarks-list__meta">{item.subtitle}</p> : null}
+          {item.description ? <p class="av-bookmarks-list__desc">{item.description}</p> : null}
+        </div>
+        {item.rightSlot ? (
+          <AvBookmarkButton
+            active={item.rightSlot.active}
+            activeExpr={item.rightSlot.activeExpr}
+            title={item.rightSlot.title}
+            activeTitle={item.rightSlot.activeTitle}
+            size={item.rightSlot.size ?? "sm"}
+            onClick={item.rightSlot.onClick}
+          />
+        ) : null}
+      </div>
+    </AvCard>
+  ))}
+</div>
+
+<style>
+  .av-bookmarks-list {
+    display: grid;
+    gap: 0.85rem;
+  }
+  .av-bookmarks-list__row {
+    display: flex;
+    justify-content: space-between;
+    align-items: flex-start;
+    gap: 0.75rem;
+  }
+  .av-bookmarks-list__title {
+    color: #e2e8f0;
+    font-weight: 600;
+    text-decoration: none;
+  }
+  .av-bookmarks-list__meta {
+    font-size: 0.75rem;
+    color: #7dd3fc;
+    margin-top: 0.35rem;
+  }
+  .av-bookmarks-list__desc {
+    margin-top: 0.4rem;
+    color: #94a3b8;
+    font-size: 0.82rem;
+  }
+</style>

package/src/components/Bookmarks/index.ts

@@ -0,0 +1,3 @@
+export { default as AvBookmarkButton } from "./AvBookmarkButton.astro";
+export { default as AvBookmarksEmpty } from "./AvBookmarksEmpty.astro";
+export { default as AvBookmarksList } from "./AvBookmarksList.astro";

package/src/layouts/AvMiniAppBar.astro

@@ -6,9 +6,10 @@ import { MINI_APP_REGISTRY } from "./miniAppRegistry";
 interface Props {
   appKey: string;
   links?: MiniAppLink[];
+  bookmarksHref?: string;
 }
 
-const { appKey, links } = Astro.props as Props;
+const { appKey, links, bookmarksHref } = Astro.props as Props;
 
 const normalizedAppKey = typeof appKey === "string" ? appKey.trim() : "";
 const meta = normalizedAppKey ? MINI_APP_REGISTRY[normalizedAppKey] : undefined;
@@ -19,6 +20,16 @@ let menuLinks = links ?? meta?.links ?? [];
 if (!menuLinks.length) {
   menuLinks = [{ label: "Home", href: "/" }];
 }
+
+const normalizedBookmarksHref = typeof bookmarksHref === "string" ? bookmarksHref.trim() : "";
+if (normalizedBookmarksHref.length > 0) {
+  const hasBookmarksItem = menuLinks.some(
+    (item) => item.href === normalizedBookmarksHref || item.label.toLowerCase() === "bookmarks",
+  );
+  if (!hasBookmarksItem) {
+    menuLinks = [...menuLinks, { label: "Bookmarks", href: normalizedBookmarksHref }];
+  }
+}
 ---
 
 <div class="av-mini-app-bar">

package/src/layouts/WebLayout.astro

@@ -11,6 +11,7 @@ interface Props {
   notificationUnreadCount?: number;
   miniAppKey?: string;
   links?: { label: string; href: string }[];
+  bookmarksHref?: string;
 }
 
 const {
@@ -19,6 +20,7 @@ const {
   notificationUnreadCount = 0,
   miniAppKey,
   links,
+  bookmarksHref,
 } = Astro.props;
 
 const user = (Astro.locals as { user?: {
@@ -87,7 +89,7 @@ const ROOT_URL = rawDomain.match(/^https?:\/\//i)
       <AvNavbarActions user={user} notificationUnreadCount={notificationUnreadCount} />
     </AvNavbar>
 
-    {miniAppKey && <AvMiniAppBar appKey={miniAppKey} links={links} />}
+    {miniAppKey && <AvMiniAppBar appKey={miniAppKey} links={links} bookmarksHref={bookmarksHref} />}
 
     <!-- Main content -->
     <main class="av-main">