@jskit-ai/users-web 0.1.80 → 0.1.82

package/src/client/components/CrudListScreen.vue

@@ -0,0 +1,434 @@
+<script setup>
+import { computed, unref } from "vue";
+import { useRoute } from "vue-router";
+import CrudListBulkActionSurface from "./CrudListBulkActionSurface.vue";
+import CrudListFilterSurface from "./CrudListFilterSurface.vue";
+
+const props = defineProps({
+  screen: {
+    type: Object,
+    required: true
+  },
+  titleLabel: {
+    type: String,
+    default: "Records"
+  },
+  headingTitle: {
+    type: String,
+    default: ""
+  },
+  subtitle: {
+    type: String,
+    default: ""
+  },
+  createLabel: {
+    type: String,
+    default: "New record"
+  },
+  loadErrorTitle: {
+    type: String,
+    default: "Unable to load records"
+  },
+  loadErrorBody: {
+    type: String,
+    default: "Check the connection and try again."
+  },
+  emptyTitle: {
+    type: String,
+    default: "No records yet"
+  },
+  emptyBody: {
+    type: String,
+    default: "Create the first record to start using this workflow."
+  }
+});
+
+const route = useRoute();
+const records = computed(() => props.screen?.records || {});
+const bulkActions = computed(() => props.screen?.bulkActions || {});
+const listFilters = computed(() => props.screen?.listFilters || {});
+const filterRuntime = computed(() => props.screen?.filterRuntime || null);
+const listPrimaryAction = computed(() => unref(props.screen?.listPrimaryAction) || "");
+const hasBulkActions = computed(() => Boolean(unref(bulkActions.value?.hasActions)));
+const hasViewUrl = computed(() => Boolean(props.screen?.hasViewUrl));
+const hasEditUrl = computed(() => Boolean(props.screen?.hasEditUrl));
+const resolvedHeadingTitle = computed(() => String(props.headingTitle || props.titleLabel || "").trim());
+const resolvedSubtitle = computed(() =>
+  String(props.subtitle || `Search, review, and update ${props.titleLabel} from this screen.`).trim()
+);
+
+function resolveListRecordTitle(record) {
+  if (typeof props.screen?.resolveRecordTitle === "function") {
+    return props.screen.resolveRecordTitle(record);
+  }
+  return "Record";
+}
+
+function formatListCardValue(value) {
+  if (typeof props.screen?.formatListCardValue === "function") {
+    return props.screen.formatListCardValue(value);
+  }
+  return value;
+}
+
+function resolveViewLocation(record) {
+  const path = typeof records.value?.resolveViewUrl === "function"
+    ? records.value.resolveViewUrl(record)
+    : "";
+  return path ? { path, query: route.query } : null;
+}
+
+function resolveEditLocation(record) {
+  const path = typeof records.value?.resolveEditUrl === "function"
+    ? records.value.resolveEditUrl(record)
+    : "";
+  return path ? { path, query: route.query } : null;
+}
+</script>
+
+<template>
+  <section class="generated-ui-screen generated-ui-screen--operator ui-generator-list-element d-flex flex-column ga-4">
+    <header class="ui-generator-list-header">
+      <div class="ui-generator-list-header__copy">
+        <p class="text-overline text-medium-emphasis mb-1">{{ titleLabel }}</p>
+        <h1 class="ui-generator-list-header__title">{{ resolvedHeadingTitle }}</h1>
+        <p class="text-body-2 text-medium-emphasis mb-0">{{ resolvedSubtitle }}</p>
+      </div>
+      <div class="ui-generator-list-header__actions">
+        <v-btn color="primary" variant="tonal" :loading="records.isFetching" @click="records.reload">Refresh</v-btn>
+        <v-btn
+          v-if="listPrimaryAction"
+          class="ui-generator-list-header__primary-action"
+          color="primary"
+          variant="flat"
+          :to="listPrimaryAction"
+        >
+          {{ createLabel }}
+        </v-btn>
+      </div>
+    </header>
+
+    <v-sheet rounded="lg" border class="ui-generator-list-panel">
+      <div class="ui-generator-list-toolbar">
+        <v-text-field
+          v-if="records.searchEnabled"
+          v-model="records.searchQuery"
+          :label="records.searchLabel"
+          :placeholder="records.searchPlaceholder"
+          variant="outlined"
+          density="comfortable"
+          hide-details="auto"
+          clearable
+          class="ui-generator-list-search"
+          :loading="records.isSearchDebouncing"
+        />
+        <CrudListFilterSurface
+          :filters="listFilters"
+          :runtime="filterRuntime"
+        />
+      </div>
+      <CrudListBulkActionSurface :runtime="bulkActions" />
+
+      <template v-if="records.showListSkeleton">
+        <div class="pa-4">
+          <v-skeleton-loader type="text@2, list-item-two-line@5" />
+        </div>
+      </template>
+      <template v-else>
+        <v-progress-linear v-if="records.isRefetching" indeterminate />
+
+        <div v-if="records.loadError" class="ui-generator-list-state">
+          <h2 class="text-h6 mb-2">{{ loadErrorTitle }}</h2>
+          <p class="text-body-2 text-medium-emphasis mb-4">{{ loadErrorBody }}</p>
+          <v-btn color="primary" variant="tonal" :loading="records.isFetching" @click="records.reload">Retry</v-btn>
+        </div>
+
+        <div v-else-if="records.items.length < 1" class="ui-generator-list-state">
+          <h2 class="text-h6 mb-2">{{ emptyTitle }}</h2>
+          <p class="text-body-2 text-medium-emphasis mb-4">{{ emptyBody }}</p>
+          <v-btn v-if="listPrimaryAction" color="primary" variant="flat" :to="listPrimaryAction">
+            {{ createLabel }}
+          </v-btn>
+        </div>
+
+        <template v-else>
+          <div class="ui-generator-list-cards d-md-none">
+            <v-sheet
+              v-for="(record, index) in records.items"
+              :key="records.resolveRowKey(record, index)"
+              rounded="lg"
+              border
+              class="ui-generator-list-card"
+            >
+              <div class="ui-generator-list-card__header">
+                <v-checkbox-btn
+                  v-if="hasBulkActions"
+                  :model-value="bulkActions.isRecordSelected(record, index)"
+                  :aria-label="`Select ${resolveListRecordTitle(record)}`"
+                  class="ui-generator-list-card__select"
+                  @update:model-value="bulkActions.setRecordSelected(record, index, $event)"
+                />
+                <div class="min-w-0">
+                  <div class="ui-generator-list-card__title">{{ resolveListRecordTitle(record) }}</div>
+                  <div class="text-caption text-medium-emphasis">
+                    {{ records.resolveRowKey(record, index) }}
+                  </div>
+                </div>
+                <v-menu v-if="hasViewUrl || hasEditUrl" location="bottom end">
+                  <template #activator="{ props: menuProps }">
+                    <v-btn v-bind="menuProps" variant="text" size="small">Actions</v-btn>
+                  </template>
+                  <v-list density="compact" min-width="140">
+                    <v-list-item
+                      v-if="hasViewUrl"
+                      title="Open"
+                      :to="resolveViewLocation(record)"
+                      :disabled="!resolveViewLocation(record)"
+                    />
+                    <v-list-item
+                      v-if="hasEditUrl"
+                      title="Edit"
+                      :to="resolveEditLocation(record)"
+                      :disabled="!resolveEditLocation(record)"
+                    />
+                  </v-list>
+                </v-menu>
+              </div>
+              <div class="ui-generator-list-card__fields">
+                <slot
+                  name="card-fields"
+                  :record="record"
+                  :records="records"
+                  :index="index"
+                  :format-list-card-value="formatListCardValue"
+                />
+              </div>
+            </v-sheet>
+          </div>
+
+          <div class="ui-generator-list-table d-none d-md-block">
+            <v-table density="comfortable">
+              <thead>
+                <tr>
+                  <th v-if="hasBulkActions" class="ui-generator-list-table__select">
+                    <v-checkbox-btn
+                      :model-value="bulkActions.allVisibleSelected(records.items)"
+                      :indeterminate="
+                        bulkActions.someVisibleSelected(records.items) &&
+                          !bulkActions.allVisibleSelected(records.items)
+                      "
+                      aria-label="Select visible rows"
+                      @update:model-value="bulkActions.setVisibleSelected(records.items, $event)"
+                    />
+                  </th>
+                  <slot name="table-header" />
+                  <th v-if="hasViewUrl" class="text-right" />
+                  <th v-if="hasEditUrl" class="text-right" />
+                </tr>
+              </thead>
+              <tbody>
+                <tr v-for="(record, index) in records.items" :key="records.resolveRowKey(record, index)">
+                  <td v-if="hasBulkActions" class="ui-generator-list-table__select">
+                    <v-checkbox-btn
+                      :model-value="bulkActions.isRecordSelected(record, index)"
+                      :aria-label="`Select ${resolveListRecordTitle(record)}`"
+                      @update:model-value="bulkActions.setRecordSelected(record, index, $event)"
+                    />
+                  </td>
+                  <slot name="table-row" :record="record" :records="records" :index="index" />
+                  <td v-if="hasViewUrl" class="text-right">
+                    <v-btn
+                      size="small"
+                      color="primary"
+                      variant="outlined"
+                      :to="resolveViewLocation(record)"
+                      :disabled="!resolveViewLocation(record)"
+                    >
+                      Open
+                    </v-btn>
+                  </td>
+                  <td v-if="hasEditUrl" class="text-right">
+                    <v-btn
+                      size="small"
+                      color="primary"
+                      variant="tonal"
+                      :to="resolveEditLocation(record)"
+                      :disabled="!resolveEditLocation(record)"
+                    >
+                      Edit
+                    </v-btn>
+                  </td>
+                </tr>
+              </tbody>
+            </v-table>
+          </div>
+        </template>
+
+        <div v-if="records.hasMore" class="d-flex justify-center pa-4">
+          <v-btn color="primary" variant="outlined" :loading="records.isLoadingMore" @click="records.loadMore">
+            Load more
+          </v-btn>
+        </div>
+      </template>
+    </v-sheet>
+
+    <v-btn
+      v-if="listPrimaryAction"
+      class="ui-generator-list-fab d-md-none"
+      color="primary"
+      variant="flat"
+      :to="listPrimaryAction"
+    >
+      New
+    </v-btn>
+  </section>
+</template>
+
+<style scoped>
+.generated-ui-screen {
+  --generated-ui-screen-title-size: clamp(1.35rem, 2vw, 1.85rem);
+  --generated-ui-screen-state-padding: 2.5rem 1.25rem;
+}
+
+.generated-ui-screen--operator {
+  --generated-ui-screen-state-padding: 2rem 1rem;
+}
+
+.ui-generator-list-header {
+  align-items: flex-start;
+  display: flex;
+  gap: 1rem;
+  justify-content: space-between;
+}
+
+.ui-generator-list-header__copy {
+  min-width: 0;
+}
+
+.ui-generator-list-header__title {
+  font-size: var(--generated-ui-screen-title-size);
+  font-weight: 650;
+  letter-spacing: -0.02em;
+  line-height: 1.15;
+  margin: 0 0 0.35rem;
+}
+
+.ui-generator-list-header__actions {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 0.5rem;
+  justify-content: flex-end;
+}
+
+.ui-generator-list-panel {
+  overflow: hidden;
+}
+
+.ui-generator-list-toolbar {
+  padding: 1rem;
+}
+
+.ui-generator-list-search {
+  max-width: 26rem;
+}
+
+.ui-generator-list-state {
+  margin-inline: auto;
+  max-width: 30rem;
+  padding: var(--generated-ui-screen-state-padding);
+  text-align: center;
+}
+
+.ui-generator-list-cards {
+  display: flex;
+  flex-direction: column;
+  gap: 0.75rem;
+  padding: 0 1rem 1rem;
+}
+
+.ui-generator-list-card {
+  padding: 0.875rem;
+}
+
+.ui-generator-list-card__header {
+  align-items: flex-start;
+  display: flex;
+  gap: 0.75rem;
+  justify-content: space-between;
+}
+
+.ui-generator-list-card__select {
+  flex: 0 0 auto;
+  margin-inline-start: -0.35rem;
+  margin-top: -0.35rem;
+}
+
+.ui-generator-list-card__title {
+  font-size: 1rem;
+  font-weight: 650;
+  line-height: 1.25;
+  overflow-wrap: anywhere;
+}
+
+.ui-generator-list-card__fields {
+  display: grid;
+  gap: 0.65rem;
+  margin-top: 0.85rem;
+}
+
+.ui-generator-list-card__field {
+  display: grid;
+  gap: 0.15rem;
+}
+
+.ui-generator-list-card__field-label {
+  color: rgba(var(--v-theme-on-surface), var(--v-medium-emphasis-opacity));
+  font-size: 0.72rem;
+  letter-spacing: 0.04em;
+  line-height: 1.2;
+  text-transform: uppercase;
+}
+
+.ui-generator-list-card__field-value {
+  font-size: 0.95rem;
+  line-height: 1.35;
+  overflow-wrap: anywhere;
+}
+
+.ui-generator-list-table {
+  overflow-x: auto;
+}
+
+.ui-generator-list-table__select {
+  width: 3rem;
+}
+
+.ui-generator-list-fab {
+  bottom: calc(5rem + env(safe-area-inset-bottom, 0px));
+  position: fixed;
+  right: 1rem;
+  z-index: 6;
+}
+
+@media (max-width: 960px) {
+  .ui-generator-list-header {
+    flex-direction: column;
+  }
+
+  .ui-generator-list-header__actions {
+    width: 100%;
+  }
+
+  .ui-generator-list-header__actions :deep(.v-btn) {
+    min-height: 48px;
+  }
+
+  .ui-generator-list-header__primary-action {
+    display: none;
+  }
+
+  .ui-generator-list-search {
+    max-width: none;
+  }
+}
+</style>

package/src/client/components/CrudViewScreen.vue

@@ -0,0 +1,186 @@
+<script setup>
+import { computed, unref } from "vue";
+
+const props = defineProps({
+  screen: {
+    type: Object,
+    required: true
+  },
+  resourceSingularTitle: {
+    type: String,
+    default: "Record"
+  },
+  resourcePluralTitle: {
+    type: String,
+    default: "Records"
+  },
+  description: {
+    type: String,
+    default: ""
+  },
+  unavailableTitle: {
+    type: String,
+    default: "Record unavailable"
+  }
+});
+
+const view = computed(() => props.screen?.view || {});
+const recordTitle = computed(() => unref(props.screen?.recordTitle) || props.resourceSingularTitle);
+const listLocation = computed(() => unref(props.screen?.listLocation) || null);
+const editLocation = computed(() => unref(props.screen?.editLocation) || null);
+const resolvedDescription = computed(() =>
+  String(props.description || `Review this ${props.resourceSingularTitle} record.`).trim()
+);
+</script>
+
+<template>
+  <section class="generated-ui-screen generated-ui-screen--operator ui-generator-view-element d-flex flex-column ga-4">
+    <header class="ui-generator-view-header">
+      <div class="ui-generator-view-header__copy">
+        <p class="text-overline text-medium-emphasis mb-1">{{ resourceSingularTitle }}</p>
+        <h1 class="ui-generator-view-header__title">{{ recordTitle }}</h1>
+        <p class="text-body-2 text-medium-emphasis mb-0">{{ resolvedDescription }}</p>
+      </div>
+      <div class="ui-generator-view-header__actions">
+        <v-btn
+          v-if="listLocation"
+          color="primary"
+          variant="outlined"
+          :to="listLocation"
+        >
+          Back to {{ resourcePluralTitle }}
+        </v-btn>
+        <v-btn
+          v-if="editLocation"
+          color="primary"
+          variant="flat"
+          :to="editLocation"
+        >
+          Edit
+        </v-btn>
+      </div>
+    </header>
+
+    <v-sheet rounded="lg" border class="ui-generator-view-panel">
+      <div v-if="view.loadError || view.isNotFound" class="ui-generator-view-state">
+        <h2 class="text-h6 mb-2">{{ unavailableTitle }}</h2>
+        <p class="text-body-2 text-medium-emphasis mb-4">
+          {{ view.loadError || `This ${resourceSingularTitle} could not be found.` }}
+        </p>
+        <div class="ui-generator-view-state__actions">
+          <v-btn
+            v-if="view.loadError"
+            color="primary"
+            variant="tonal"
+            :loading="view.isFetching"
+            @click="view.refresh"
+          >
+            Retry
+          </v-btn>
+          <v-btn
+            v-else-if="listLocation"
+            color="primary"
+            variant="tonal"
+            :to="listLocation"
+          >
+            Back to {{ resourcePluralTitle }}
+          </v-btn>
+        </div>
+      </div>
+
+      <template v-else-if="view.isLoading">
+        <div class="pa-4">
+          <v-skeleton-loader type="text@2, list-item-two-line@5" />
+        </div>
+      </template>
+
+      <template v-else>
+        <v-progress-linear v-if="view.isRefetching" indeterminate />
+        <div class="pa-4">
+          <v-row class="ui-generator-view-fields">
+            <slot name="fields" :view="view" />
+          </v-row>
+        </div>
+      </template>
+    </v-sheet>
+  </section>
+</template>
+
+<style scoped>
+.generated-ui-screen {
+  --generated-ui-screen-title-size: clamp(1.35rem, 2vw, 1.85rem);
+  --generated-ui-screen-state-padding: 2.5rem 1.25rem;
+}
+
+.generated-ui-screen--operator {
+  --generated-ui-screen-state-padding: 2rem 1rem;
+}
+
+.ui-generator-view-header {
+  align-items: flex-start;
+  display: flex;
+  gap: 1rem;
+  justify-content: space-between;
+}
+
+.ui-generator-view-header__copy {
+  min-width: 0;
+}
+
+.ui-generator-view-header__title {
+  font-size: var(--generated-ui-screen-title-size);
+  font-weight: 650;
+  letter-spacing: -0.02em;
+  line-height: 1.15;
+  margin: 0 0 0.35rem;
+  overflow-wrap: anywhere;
+}
+
+.ui-generator-view-header__actions {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 0.5rem;
+  justify-content: flex-end;
+}
+
+.ui-generator-view-panel {
+  overflow: hidden;
+}
+
+.ui-generator-view-state {
+  margin-inline: auto;
+  max-width: 30rem;
+  padding: var(--generated-ui-screen-state-padding);
+  text-align: center;
+}
+
+.ui-generator-view-state__actions {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 0.5rem;
+  justify-content: center;
+}
+
+.ui-generator-view-fields :deep(.v-col) {
+  min-width: 0;
+}
+
+@media (max-width: 960px) {
+  .ui-generator-view-header {
+    flex-direction: column;
+  }
+
+  .ui-generator-view-header__actions {
+    width: 100%;
+  }
+
+  .ui-generator-view-header__actions :deep(.v-btn) {
+    min-height: 48px;
+    flex: 1 1 10rem;
+  }
+
+  .ui-generator-view-state__actions :deep(.v-btn) {
+    min-height: 48px;
+  }
+}
+</style>

package/src/client/components/ProfileClientElement.vue

@@ -1,19 +1,18 @@
 <template>
   <section :class="rootClasses" :data-testid="uiTestIds.root">
-    <v-card
-      class="profile-client-card"
+    <v-sheet
+      class="profile-client-panel"
       :class="uiClasses.card"
       :rounded="resolvedVariant.surface === 'plain' ? '0' : 'lg'"
       :elevation="0"
       :border="resolvedVariant.surface !== 'plain'"
-      :variant="resolvedVariant.surface === 'plain' ? 'text' : undefined"
       :data-testid="uiTestIds.card"
     >
-      <v-card-item v-if="resolvedFeatures.header">
-        <v-card-title class="text-subtitle-1">{{ copyText.title }}</v-card-title>
-      </v-card-item>
+      <div v-if="resolvedFeatures.header" class="profile-client-panel__header">
+        <h2 class="text-subtitle-1 mb-0">{{ copyText.title }}</h2>
+      </div>
       <v-divider v-if="resolvedFeatures.header" />
-      <v-card-text>
+      <div class="profile-client-panel__body">
         <slot name="form-before" :state="state" :actions="actions" />
 
         <v-form @submit.prevent="onSubmitProfile" novalidate>
@@ -81,8 +80,8 @@
         </v-form>
 
         <slot name="footer-extra" :state="state" :actions="actions" />
-      </v-card-text>
-    </v-card>
+      </div>
+    </v-sheet>
   </section>
 </template>
 
@@ -222,12 +221,20 @@ async function onAvatarRemove() {
 </script>
 
 <style scoped>
-.profile-client-element--layout-compact :deep(.v-card-item),
-.profile-client-element--layout-compact :deep(.v-card-text) {
+.profile-client-panel__header {
+  padding: 1rem 1rem 0.75rem;
+}
+
+.profile-client-panel__body {
+  padding: 1rem;
+}
+
+.profile-client-element--layout-compact .profile-client-panel__header,
+.profile-client-element--layout-compact .profile-client-panel__body {
   padding-block: 0.72rem;
 }
 
-.profile-client-element--surface-plain .profile-client-card {
+.profile-client-element--surface-plain .profile-client-panel {
   box-shadow: none;
   border-width: 0;
 }

package/src/client/components/UsersHomeToolsWidget.vue

@@ -6,7 +6,6 @@ import { HOME_COG_OUTLET } from "../../shared/toolsOutletContracts.js";
 <template>
   <ShellOutletMenuWidget
     :target="HOME_COG_OUTLET.target"
-    :default-link-component-token="HOME_COG_OUTLET.defaultLinkComponentToken"
     :aria-label="HOME_COG_OUTLET.ariaLabel"
   />
 </template>