@jskit-ai/agent-docs 0.1.148 → 0.1.150

package/skills/jskit/references/patterns/workspaces/workspace-surfaces/example/src/pages/admin/workspace/settings.vue

@@ -0,0 +1,95 @@
+<script setup>
+import ShellOutlet from "@jskit-ai/shell-web/client/components/ShellOutlet";
+import { RouterView } from "vue-router";
+</script>
+
+<template>
+  <section class="settings-shell d-flex flex-column ga-4">
+    <header>
+      <p class="text-overline text-medium-emphasis mb-1">Settings</p>
+      <h1 class="settings-shell__title">Workspace settings</h1>
+      <p class="text-body-2 text-medium-emphasis mb-0">Configure the current workspace and its members.</p>
+    </header>
+
+    <v-sheet rounded="lg" border class="settings-shell__panel">
+      <nav class="settings-shell__nav" aria-label="Workspace settings sections">
+        <v-list nav density="compact" class="settings-shell__nav-list">
+          <ShellOutlet target="admin-settings:primary-menu" />
+        </v-list>
+      </nav>
+      <main class="settings-shell__content">
+        <RouterView />
+      </main>
+    </v-sheet>
+  </section>
+</template>
+
+<style scoped>
+.settings-shell__title {
+  font-size: clamp(1.35rem, 2vw, 1.85rem);
+  font-weight: 650;
+  letter-spacing: -0.02em;
+  line-height: 1.15;
+  margin: 0 0 0.35rem;
+}
+
+.settings-shell__panel {
+  display: grid;
+  gap: 1rem;
+  grid-template-columns: minmax(12rem, 16rem) minmax(0, 1fr);
+  padding: 1rem;
+}
+
+.settings-shell__nav-list {
+  padding: 0.35rem;
+}
+
+.settings-shell__nav-list :deep(.v-list-item) {
+  min-height: 48px;
+  padding-inline: 0.6rem 0.7rem;
+}
+
+.settings-shell__nav-list :deep(.v-list-item__prepend) {
+  margin-inline-end: 0;
+}
+
+.settings-shell__nav-list :deep(.v-list-item__spacer) {
+  min-width: 0.5rem;
+  width: 0.5rem;
+}
+
+.settings-shell__nav-list :deep(.v-list-item-title) {
+  line-height: 1.2;
+}
+
+.settings-shell__content {
+  border-left: 1px solid rgba(var(--v-theme-on-surface), 0.18);
+  min-width: 0;
+  padding-left: 1rem;
+}
+
+@media (max-width: 960px) {
+  .settings-shell__panel {
+    grid-template-columns: 1fr;
+  }
+
+  .settings-shell__nav {
+    overflow-x: auto;
+  }
+
+  .settings-shell__nav-list {
+    display: flex;
+    gap: 0.25rem;
+    min-width: max-content;
+  }
+
+  .settings-shell__nav-list :deep(.v-list-item) {
+    min-height: 48px;
+  }
+
+  .settings-shell__content {
+    border-left: 0;
+    padding-left: 0;
+  }
+}
+</style>

package/skills/jskit/references/patterns/workspaces/workspace-surfaces/example/src/pages/invite/[token].vue

@@ -0,0 +1,7 @@
+<template>
+  <WorkspaceInviteLanding />
+</template>
+
+<script setup>
+import WorkspaceInviteLanding from "@jskit-ai/workspaces-web/client/components/WorkspaceInviteLanding";
+</script>

package/skills/jskit/references/patterns/workspaces/workspace-surfaces/example/src/surfaces/admin/index.vue

@@ -0,0 +1,85 @@
+<script setup>
+import { useRoute } from "vue-router";
+import WorkspaceNotFoundCard from "@/components/WorkspaceNotFoundCard.vue";
+import { useWorkspaceNotFoundState } from "@/composables/useWorkspaceNotFoundState";
+
+const route = useRoute();
+const { workspaceUnavailable, workspaceUnavailableMessage } = useWorkspaceNotFoundState();
+
+function adminChildPath(suffix = "") {
+  const basePath = String(route.path || "").replace(/\/+$/u, "");
+  const childPath = String(suffix || "").replace(/^\/+|\/+$/gu, "");
+  return childPath ? `${basePath}/${childPath}` : basePath;
+}
+</script>
+
+<template>
+  <WorkspaceNotFoundCard
+    v-if="workspaceUnavailable"
+    :message="workspaceUnavailableMessage"
+    surface-label="Admin"
+  />
+  <section v-else class="workspace-admin-screen d-flex flex-column ga-4">
+    <header class="workspace-admin-screen__header">
+      <div>
+        <p class="text-overline text-medium-emphasis mb-1">Admin</p>
+        <h1 class="workspace-admin-screen__title">Workspace Admin</h1>
+        <p class="text-body-2 text-medium-emphasis mb-0">Manage members and workspace settings.</p>
+      </div>
+      <div class="workspace-admin-screen__actions">
+        <v-btn color="primary" variant="flat" :to="adminChildPath('members')">Members</v-btn>
+        <v-btn color="primary" variant="tonal" :to="adminChildPath('workspace/settings')">Settings</v-btn>
+      </div>
+    </header>
+
+    <v-sheet rounded="lg" border class="workspace-admin-screen__panel">
+      <h2 class="text-h6 mb-2">Admin tasks</h2>
+      <p class="text-body-2 text-medium-emphasis mb-0">
+        Review workspace access, members, and operational settings from this surface.
+      </p>
+    </v-sheet>
+  </section>
+</template>
+
+<style scoped>
+.workspace-admin-screen__header {
+  align-items: flex-start;
+  display: flex;
+  gap: 1rem;
+  justify-content: space-between;
+}
+
+.workspace-admin-screen__title {
+  font-size: clamp(1.5rem, 2.5vw, 2.25rem);
+  font-weight: 700;
+  letter-spacing: -0.03em;
+  line-height: 1.1;
+  margin: 0 0 0.4rem;
+}
+
+.workspace-admin-screen__actions {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 0.5rem;
+  justify-content: flex-end;
+}
+
+.workspace-admin-screen__panel {
+  padding: 1rem;
+}
+
+@media (max-width: 640px) {
+  .workspace-admin-screen__header {
+    flex-direction: column;
+  }
+
+  .workspace-admin-screen__actions {
+    width: 100%;
+  }
+
+  .workspace-admin-screen__actions :deep(.v-btn) {
+    min-height: 48px;
+    flex: 1 1 10rem;
+  }
+}
+</style>

package/skills/jskit/references/patterns/workspaces/workspace-surfaces/example/src/surfaces/admin/root.vue

@@ -0,0 +1,20 @@
+<route lang="json">
+{
+  "meta": {
+    "jskit": {
+      "surface": "admin"
+    }
+  }
+}
+</route>
+
+<script setup>
+import ShellLayout from "@/components/ShellLayout.vue";
+import { RouterView } from "vue-router";
+</script>
+
+<template>
+  <ShellLayout title="" subtitle="">
+    <RouterView />
+  </ShellLayout>
+</template>

package/skills/jskit/references/patterns/workspaces/workspace-surfaces/example/src/surfaces/app/index.vue

@@ -0,0 +1,46 @@
+<script setup>
+import WorkspaceNotFoundCard from "@/components/WorkspaceNotFoundCard.vue";
+import { useWorkspaceNotFoundState } from "@/composables/useWorkspaceNotFoundState";
+
+const { workspaceUnavailable, workspaceUnavailableMessage } = useWorkspaceNotFoundState();
+</script>
+
+<template>
+  <WorkspaceNotFoundCard
+    v-if="workspaceUnavailable"
+    :message="workspaceUnavailableMessage"
+    surface-label="App"
+  />
+  <section v-else class="workspace-home-screen d-flex flex-column ga-4">
+    <header>
+      <p class="text-overline text-medium-emphasis mb-1">Workspace</p>
+      <h1 class="workspace-home-screen__title">Workspace Home</h1>
+      <p class="text-body-2 text-medium-emphasis mb-0">The current workspace is active.</p>
+    </header>
+
+    <v-sheet rounded="lg" border class="workspace-home-screen__panel">
+      <h2 class="text-h6 mb-2">No workspace activity yet</h2>
+      <p class="text-body-2 text-medium-emphasis mb-0">
+        Activity from workspace workflows will appear here.
+      </p>
+    </v-sheet>
+  </section>
+</template>
+
+<style scoped>
+.workspace-home-screen__title {
+  font-size: clamp(1.5rem, 2.5vw, 2.25rem);
+  font-weight: 700;
+  letter-spacing: -0.03em;
+  line-height: 1.1;
+  margin: 0 0 0.4rem;
+}
+
+.workspace-home-screen__panel {
+  margin-inline: auto;
+  max-width: 34rem;
+  padding: 2rem 1.25rem;
+  text-align: center;
+  width: 100%;
+}
+</style>

package/skills/jskit/references/patterns/workspaces/workspace-surfaces/example/src/surfaces/app/root.vue

@@ -0,0 +1,20 @@
+<route lang="json">
+{
+  "meta": {
+    "jskit": {
+      "surface": "app"
+    }
+  }
+}
+</route>
+
+<script setup>
+import ShellLayout from "@/components/ShellLayout.vue";
+import { RouterView } from "vue-router";
+</script>
+
+<template>
+  <ShellLayout title="" subtitle="">
+    <RouterView />
+  </ShellLayout>
+</template>

package/skills/jskit/references/ui-operations.md

@@ -1,14 +1,16 @@
+<!-- Generated from `packages/agent-docs/site/guide/framework/ui-operations.md` by `npm run agent-docs:build`. -->
+
 # UI operations
 
 Read this for routes, pages, surfaces, placements, responsive UI, and browser
-verification.
+verification. Also read the complete [Material 3 contract](material-3.md).
 
 ## Pages, surfaces, and placements
 
 Take the surface and navigation role from the request, product context, and
 current app. They control routes, access, placement visibility, and often
-ownership. Inspect `app/shell-foundation` plus the narrow UI pattern that
-matches the requested outcome before authoring source.
+ownership. Inspect `app/shell-foundation` plus the narrow matching entry in
+the [bundled source pattern index](pattern-index.md) before authoring source.
 
 Create route files and placement declarations as normal application code.
 Use semantic placement ids and shell public helpers; use concrete outlet ids

package/templates/app/AGENTS.md

@@ -1,16 +1,16 @@
 # App Agent Instructions
 
-Use current project context, JSKIT public APIs, and the installed JSKIT pattern
-index as the source of truth for application work.
+Use current project context, JSKIT public APIs, and the official framework
+documentation as the source of truth for application work.
 
-Recommended references:
+Framework references:
 
-- `node_modules/@jskit-ai/agent-docs/guide/agent/index.md`
-- `node_modules/@jskit-ai/agent-docs/patterns/INDEX.md`
+- `https://mobily-enterprises.github.io/jskit-ai/guide/`
+- `https://mobily-enterprises.github.io/jskit-ai/patterns/`
 
-Before database, schema, CRUD, repository, or persistence work, read and follow
-the relevant package-owned pattern listed in
-`node_modules/@jskit-ai/agent-docs/reference/autogen/PATTERN_INDEX.md`.
+Before implementation, read the narrow relevant source pattern completely. If
+its owner package is installed, prefer that version-matched package-owned copy.
+Do not install an unrelated runtime package only to read documentation.
 
 Copied pattern source is ordinary application source. Do not add generator
 provenance, receipts, completion ledgers, or tooling-operation history. Keep