@priscilla-ai/vue 1.0.0

package/.editorconfig

@@ -0,0 +1,8 @@
+[*.{js,jsx,mjs,cjs,ts,tsx,mts,cts,vue,css,scss,sass,less,styl}]
+charset = utf-8
+indent_size = 2
+indent_style = space
+insert_final_newline = true
+trim_trailing_whitespace = true
+end_of_line = lf
+max_line_length = 100

package/.gitattributes

@@ -0,0 +1 @@
+* text=auto eol=lf

package/.prettierrc.json

@@ -0,0 +1,6 @@
+{
+  "$schema": "https://json.schemastore.org/prettierrc",
+  "semi": false,
+  "singleQuote": true,
+  "printWidth": 100
+}

package/.vscode/extensions.json

@@ -0,0 +1,8 @@
+{
+  "recommendations": [
+    "Vue.volar",
+    "dbaeumer.vscode-eslint",
+    "EditorConfig.EditorConfig",
+    "esbenp.prettier-vscode"
+  ]
+}

package/CHANGELOG.md

@@ -0,0 +1,7 @@
+# Changelog
+
+## [1.0.0] - 18-03-2026
+- First Release
+- Vue 3 plugin for AI-powered code
+
+

package/LICENSE

@@ -0,0 +1,7 @@
+Copyright <2025> <Dominik Takáč>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,202 @@
+# Priscilla AI — Vue 3 Code Hint Assistant Plugin
+
+A Vue 3 plugin that provides AI-powered code hints by extracting code from the DOM via XPath and sending it to an API for analysis. Built with TypeScript and Axios.
+
+## Plugin Figma Design 
+<img width="1956" height="1078" alt="image" src="https://github.com/user-attachments/assets/e1cee0bb-345b-4b77-a8cc-59ef428fcb6c" />
+
+
+[Figma Link](https://www.figma.com/design/laysuH8lJanr37ZCR2HUpm/Bakalarka-komponent?node-id=0-1&t=GMB5zaetauqlHPvO-1)
+
+
+## Features
+
+✨ **XPath-based Code Extraction** — Extract code from any element using XPath expressions  
+🤖 **AI-Powered Hints** — Get intelligent hints about your code from an LLM API  
+📦 **Type-Safe** — Full TypeScript support with type definitions  
+♿ **Accessible** — Built with ARIA labels and semantic HTML  
+🎨 **Styled UI** — Clean, minimal assistant interface with loading states  
+⚡ **Cancellable Requests** — Abort in-flight requests when unmounting or requesting new hints  
+
+## Installation
+
+### npm
+```bash
+npm install @priscilla/vue-ai-assistant
+```
+
+### pnpm
+```bash
+pnpm add @priscilla/vue-ai-assistant
+```
+
+## Setup
+
+**1. Register the plugin in your Vue app:**
+
+```typescript
+// src/main.ts
+import { createApp } from 'vue'
+import App from './App.vue'
+import { createPriscillaAI } from '@priscilla/vue-ai-assistant'
+
+const app = createApp(App)
+
+// Initialize with your API endpoint
+app.use(createPriscillaAI('https://api.example.com/api/predict/hint'))
+
+app.mount('#app')
+```
+
+**2. The `PriscillaAI` component will be globally available.**
+
+## Usage
+
+### Basic Example
+
+```vue
+<template>
+  <div>
+    <textarea id="code-block">
+function fibonacci(n) {
+  if (n <= 1) return n
+  return fibonacci(n - 1) + fibonacci(n - 2)
+}
+    </textarea>
+
+    <!-- Add the AI assistant -->
+    <PriscillaAI
+      xpath="//textarea[@id='code-block']"
+      :chapterId="12"
+      :programId="589"
+    />
+  </div>
+</template>
+```
+
+## Props
+
+| Prop | Type | Required | Description |
+|------|------|----------|-------------|
+| `xpath` | `string` | ✅ Yes | XPath expression to extract code from the DOM (must be valid and non-empty) |
+| `chapterId` | `number` | ✅ Yes | Chapter identifier for the code context (must be positive integer) |
+| `programId` | `number` | ✅ Yes | Program identifier for the code context (must be positive integer) |
+
+### Props Example
+
+```vue
+<PriscillaAI
+  xpath="//textarea[@id='user-code']"
+  :chapterId="5"
+  :programId="102"
+/>
+```
+
+## Component Features
+
+- 🎯 **Toggle Button** — Click the 🤖 icon to open/close the assistant
+- 📝 **Code Display** — Shows extracted code for verification
+- 💡 **Hint Display** — Displays AI-generated hints
+- ⚠️ **Error Handling** — Shows clear error messages
+- ⏳ **Loading States** — Visual feedback while fetching
+- 🧹 **Clear Button** — Reset and clear all outputs
+
+## API Response Format
+
+The API endpoint should return a response matching this interface:
+
+```typescript
+interface PriscillaAIResponse {
+  hint?: string
+}
+```
+
+### Example API Payload
+
+**Request:**
+```json
+{
+  "content": "function fibonacci(n) { if (n <= 1) return n; return fibonacci(n - 1) + fibonacci(n - 2); }",
+  "chapterId": 12,
+  "programId": 589
+}
+```
+
+**Response:**
+```json
+{
+  "hint": "Consider using memoization to avoid recalculating fibonacci numbers. The current implementation has exponential time complexity.",
+}
+```
+
+## TypeScript Support
+
+Full TypeScript support is included. Import types as needed:
+
+```typescript
+import type { PriscillaAIResponse } from '@priscilla/vue-ai-assistant'
+
+// Use in your own code
+const response: PriscillaAIResponse = await fetchHint()
+```
+
+## Styling
+
+The component uses CSS classes that can be customized:
+
+```css
+.priscilla-ai { /* Main container */ }
+.assistant-button { /* Toggle button */ }
+.assistant-window { /* Modal window */ }
+.assistant-header { /* Header */ }
+.assistant-body { /* Content area */ }
+.assistant-footer { /* Footer with buttons */ }
+.code-block { /* Code display */ }
+.hint-text { /* Hint text */ }
+.error-message { /* Error messages */ }
+.loading-spinner { /* Loading indicator */ }
+.primary-button { /* "Get Hint" button */ }
+.secondary-button { /* "Clear" button */ }
+```
+
+## Error Handling
+
+The component handles various error scenarios gracefully:
+
+- **Invalid XPath** — Shows "Invalid XPath expression" error
+- **No matching element** — Shows "No element matched the provided XPath" error
+- **Empty content** — Shows "Matched element contains no extractable text" error
+- **API errors** — Displays API status and error message
+- **Network cancellation** — Silently handles request cancellation on unmount
+
+## Browser Support
+
+- Chrome/Edge 90+
+- Firefox 88+
+- Safari 14+
+- Any browser supporting Vue 3 and XPath
+
+## Project Structure
+
+```
+src/
+├── components/
+│   └── PriscillaAI.vue       # Main component
+├── plugins/
+│   └── priscillaAI.ts        # Plugin setup
+├── types/
+│   └── priscillaAI.ts        # TypeScript interfaces
+├── styles/
+│   └── index.css             # Component styles
+├── App.vue                   # Example usage
+└── main.ts                   # Plugin initialization
+```
+
+## License
+
+MIT © 2026 Dominik Takáč
+
+## Author
+
+Dominik Takáč  
+Bachelor Thesis Project

package/dist/index.cjs

@@ -0,0 +1 @@
+(function(r,t){typeof exports=="object"&&typeof module<"u"?t(exports,require("vue"),require("axios")):typeof define=="function"&&define.amd?define(["exports","vue","axios"],t):(r=typeof globalThis<"u"?globalThis:r||self,t(r.PriscillaAI={},r.Vue,r.axios))})(this,(function(r,t,s){"use strict";const p=t.defineComponent({name:"PriscillaAI",props:{xpath:{type:String,required:!0,validator:e=>e.trim().length>0},chapterId:{type:Number,required:!0,validator:e=>Number.isInteger(e)&&e>0},programId:{type:Number,required:!0,validator:e=>Number.isInteger(e)&&e>0}},data(){return{isOpen:!1,loading:!1,hint:"",error:"",extractedContent:"",cancelSource:null}},computed:{hasResult(){return!!(this.hint||this.extractedContent)},buttonLabel(){return this.loading?"Fetching…":"Get Hint"}},beforeUnmount(){this.cancelSource?.cancel("Component unmounted")},methods:{toggle(){this.isOpen=!this.isOpen},extractCodeFromXPath(){let e;try{e=document.evaluate(this.xpath,document,null,XPathResult.FIRST_ORDERED_NODE_TYPE,null).singleNodeValue}catch{throw new Error(`Invalid XPath expression: "${this.xpath}"`)}if(!e)throw new Error("No element matched the provided XPath.");const n=e instanceof HTMLTextAreaElement?e.value:e.textContent;if(!n?.trim())throw new Error("Matched element contains no extractable text.");return n.trim()},async fetchHint(){this.cancelSource?.cancel("Superseded by newer request"),this.loading=!0,this.error="",this.hint="",this.extractedContent="";try{const e=this.extractCodeFromXPath();this.extractedContent=e;const n=l();if(!n)throw new Error("API endpoint not configured. Please initialise the plugin.");this.cancelSource=s.CancelToken.source();const{data:o}=await s.post(n,{content:e,chapterId:this.chapterId,programId:this.programId},{cancelToken:this.cancelSource.token});this.hint=o.hint?.trim()||"No hint available for this submission."}catch(e){if(s.isCancel(e))return;e instanceof Error?this.error=e.message:s.isAxiosError(e)?this.error=`API ${e.response?.status??"Error"}: ${e.message}`:this.error="An unexpected error occurred."}finally{this.loading=!1}},clearHint(){this.hint="",this.extractedContent="",this.error="",this.cancelSource?.cancel("Cleared by user")}}}),h=(e,n)=>{const o=e.__vccOpts||e;for(const[c,d]of n)o[c]=d;return o},m={class:"priscilla-ai"},g=["aria-expanded","aria-label"],u={"aria-hidden":"true"},f={key:0,class:"assistant-window",role:"dialog","aria-label":"Priscilla AI – Code Hint Assistant"},E={class:"assistant-body"},y={class:"code-block"},C={class:"hint-text"},b={key:2,class:"error-message",role:"alert"},k={key:3,class:"loading-spinner","aria-live":"polite"},N={class:"metadata"},I={class:"assistant-footer"},P=["disabled"];function V(e,n,o,c,d,B){return t.openBlock(),t.createElementBlock("div",m,[t.createElementVNode("button",{class:"assistant-button","aria-expanded":e.isOpen,"aria-label":e.isOpen?"Close hint assistant":"Open hint assistant",onClick:n[0]||(n[0]=(...i)=>e.toggle&&e.toggle(...i))},[t.createElementVNode("span",u,t.toDisplayString(e.isOpen?"✖️":"🤖"),1)],8,g),e.isOpen?(t.openBlock(),t.createElementBlock("div",f,[n[5]||(n[5]=t.createElementVNode("header",{class:"assistant-header"},"Priscilla AI — Code Hint Assistant",-1)),t.createElementVNode("div",E,[e.extractedContent?(t.openBlock(),t.createElementBlock(t.Fragment,{key:0},[n[3]||(n[3]=t.createElementVNode("p",null,[t.createElementVNode("strong",null,"Extracted Code:")],-1)),t.createElementVNode("pre",y,t.toDisplayString(e.extractedContent),1)],64)):t.createCommentVNode("",!0),e.hint?(t.openBlock(),t.createElementBlock(t.Fragment,{key:1},[n[4]||(n[4]=t.createElementVNode("p",null,[t.createElementVNode("strong",null,"💡 Hint:")],-1)),t.createElementVNode("p",C,t.toDisplayString(e.hint),1)],64)):t.createCommentVNode("",!0),e.error?(t.openBlock(),t.createElementBlock("p",b,"❌ "+t.toDisplayString(e.error),1)):t.createCommentVNode("",!0),e.loading?(t.openBlock(),t.createElementBlock("p",k,"⏳ Fetching hint…")):t.createCommentVNode("",!0),t.createElementVNode("p",N,[t.createElementVNode("small",null,"Chapter "+t.toDisplayString(e.chapterId)+" · Program "+t.toDisplayString(e.programId),1)])]),t.createElementVNode("footer",I,[t.createElementVNode("button",{class:"primary-button",disabled:e.loading,onClick:n[1]||(n[1]=(...i)=>e.fetchHint&&e.fetchHint(...i))},t.toDisplayString(e.buttonLabel),9,P),e.hasResult?(t.openBlock(),t.createElementBlock("button",{key:0,class:"secondary-button",onClick:n[2]||(n[2]=(...i)=>e.clearHint&&e.clearHint(...i))},"Clear")):t.createCommentVNode("",!0)])])):t.createCommentVNode("",!0)])}const A=h(p,[["render",V]]);let a="";function S(e){return{install(n){a=e,n.config.globalProperties.$priscillaAIEndpoint=a,n.component("PriscillaAI",A)}}}function l(){return a}r.createPriscillaAI=S,r.getPriscillaAIEndpoint=l,Object.defineProperty(r,Symbol.toStringTag,{value:"Module"})}));

package/dist/index.js

@@ -0,0 +1,177 @@
+import { defineComponent as m, createElementBlock as r, openBlock as s, createElementVNode as n, createCommentVNode as a, toDisplayString as i, Fragment as p } from "vue";
+import d from "axios";
+const g = m({
+  name: "PriscillaAI",
+  props: {
+    xpath: {
+      type: String,
+      required: !0,
+      validator: (t) => t.trim().length > 0
+    },
+    chapterId: {
+      type: Number,
+      required: !0,
+      validator: (t) => Number.isInteger(t) && t > 0
+    },
+    programId: {
+      type: Number,
+      required: !0,
+      validator: (t) => Number.isInteger(t) && t > 0
+    }
+  },
+  data() {
+    return {
+      isOpen: !1,
+      loading: !1,
+      hint: "",
+      error: "",
+      extractedContent: "",
+      cancelSource: null
+    };
+  },
+  computed: {
+    hasResult() {
+      return !!(this.hint || this.extractedContent);
+    },
+    buttonLabel() {
+      return this.loading ? "Fetching…" : "Get Hint";
+    }
+  },
+  beforeUnmount() {
+    this.cancelSource?.cancel("Component unmounted");
+  },
+  methods: {
+    toggle() {
+      this.isOpen = !this.isOpen;
+    },
+    extractCodeFromXPath() {
+      let t;
+      try {
+        t = document.evaluate(
+          this.xpath,
+          document,
+          null,
+          XPathResult.FIRST_ORDERED_NODE_TYPE,
+          null
+        ).singleNodeValue;
+      } catch {
+        throw new Error(`Invalid XPath expression: "${this.xpath}"`);
+      }
+      if (!t)
+        throw new Error("No element matched the provided XPath.");
+      const e = t instanceof HTMLTextAreaElement ? t.value : t.textContent;
+      if (!e?.trim())
+        throw new Error("Matched element contains no extractable text.");
+      return e.trim();
+    },
+    async fetchHint() {
+      this.cancelSource?.cancel("Superseded by newer request"), this.loading = !0, this.error = "", this.hint = "", this.extractedContent = "";
+      try {
+        const t = this.extractCodeFromXPath();
+        this.extractedContent = t;
+        const e = $();
+        if (!e)
+          throw new Error("API endpoint not configured. Please initialise the plugin.");
+        this.cancelSource = d.CancelToken.source();
+        const { data: o } = await d.post(
+          e,
+          {
+            content: t,
+            chapterId: this.chapterId,
+            programId: this.programId
+          },
+          { cancelToken: this.cancelSource.token }
+        );
+        this.hint = o.hint?.trim() || "No hint available for this submission.";
+      } catch (t) {
+        if (d.isCancel(t)) return;
+        t instanceof Error ? this.error = t.message : d.isAxiosError(t) ? this.error = `API ${t.response?.status ?? "Error"}: ${t.message}` : this.error = "An unexpected error occurred.";
+      } finally {
+        this.loading = !1;
+      }
+    },
+    clearHint() {
+      this.hint = "", this.extractedContent = "", this.error = "", this.cancelSource?.cancel("Cleared by user");
+    }
+  }
+}), f = (t, e) => {
+  const o = t.__vccOpts || t;
+  for (const [h, u] of e)
+    o[h] = u;
+  return o;
+}, b = { class: "priscilla-ai" }, C = ["aria-expanded", "aria-label"], I = { "aria-hidden": "true" }, y = {
+  key: 0,
+  class: "assistant-window",
+  role: "dialog",
+  "aria-label": "Priscilla AI – Code Hint Assistant"
+}, E = { class: "assistant-body" }, P = { class: "code-block" }, k = { class: "hint-text" }, A = {
+  key: 2,
+  class: "error-message",
+  role: "alert"
+}, v = {
+  key: 3,
+  class: "loading-spinner",
+  "aria-live": "polite"
+}, w = { class: "metadata" }, H = { class: "assistant-footer" }, O = ["disabled"];
+function N(t, e, o, h, u, F) {
+  return s(), r("div", b, [
+    n("button", {
+      class: "assistant-button",
+      "aria-expanded": t.isOpen,
+      "aria-label": t.isOpen ? "Close hint assistant" : "Open hint assistant",
+      onClick: e[0] || (e[0] = (...l) => t.toggle && t.toggle(...l))
+    }, [
+      n("span", I, i(t.isOpen ? "✖️" : "🤖"), 1)
+    ], 8, C),
+    t.isOpen ? (s(), r("div", y, [
+      e[5] || (e[5] = n("header", { class: "assistant-header" }, "Priscilla AI — Code Hint Assistant", -1)),
+      n("div", E, [
+        t.extractedContent ? (s(), r(p, { key: 0 }, [
+          e[3] || (e[3] = n("p", null, [
+            n("strong", null, "Extracted Code:")
+          ], -1)),
+          n("pre", P, i(t.extractedContent), 1)
+        ], 64)) : a("", !0),
+        t.hint ? (s(), r(p, { key: 1 }, [
+          e[4] || (e[4] = n("p", null, [
+            n("strong", null, "💡 Hint:")
+          ], -1)),
+          n("p", k, i(t.hint), 1)
+        ], 64)) : a("", !0),
+        t.error ? (s(), r("p", A, "❌ " + i(t.error), 1)) : a("", !0),
+        t.loading ? (s(), r("p", v, "⏳ Fetching hint…")) : a("", !0),
+        n("p", w, [
+          n("small", null, "Chapter " + i(t.chapterId) + " · Program " + i(t.programId), 1)
+        ])
+      ]),
+      n("footer", H, [
+        n("button", {
+          class: "primary-button",
+          disabled: t.loading,
+          onClick: e[1] || (e[1] = (...l) => t.fetchHint && t.fetchHint(...l))
+        }, i(t.buttonLabel), 9, O),
+        t.hasResult ? (s(), r("button", {
+          key: 0,
+          class: "secondary-button",
+          onClick: e[2] || (e[2] = (...l) => t.clearHint && t.clearHint(...l))
+        }, "Clear")) : a("", !0)
+      ])
+    ])) : a("", !0)
+  ]);
+}
+const S = /* @__PURE__ */ f(g, [["render", N]]);
+let c = "";
+function x(t) {
+  return {
+    install(e) {
+      c = t, e.config.globalProperties.$priscillaAIEndpoint = c, e.component("PriscillaAI", S);
+    }
+  };
+}
+function $() {
+  return c;
+}
+export {
+  x as createPriscillaAI,
+  $ as getPriscillaAIEndpoint
+};

package/dist/vue.css

@@ -0,0 +1 @@
+@font-face{font-family:Roboto;font-style:normal;font-weight:100;font-stretch:100%;src:url(https://fonts.gstatic.com/s/roboto/v51/KFO7CnqEu92Fr1ME7kSn66aGLdTylUAMa3GUBGEe.woff2) format("woff2");unicode-range:U+0460-052F,U+1C80-1C8A,U+20B4,U+2DE0-2DFF,U+A640-A69F,U+FE2E-FE2F}.app-container{display:flex;flex-direction:column;height:100vh}.navbar{display:flex;align-items:center;justify-content:center;background:#fff;border-bottom:1px solid #ddd;padding:10px 0;gap:20px}.nav-items{display:flex;gap:16px}.nav-item{background:#e5e5e5;width:40px;height:40px;border-radius:6px;display:flex;align-items:center;justify-content:center;cursor:pointer;position:relative}.main-content{flex:1;display:flex;flex-direction:column;justify-content:center;align-items:center;padding:40px}.code-section{background:#f5f5f5;padding:20px;border-radius:8px;max-width:600px;margin-top:30px}.code-section pre{background:#2d2d2d;color:#f8f8f2;padding:15px;border-radius:6px;overflow-x:auto;font-family:Courier New,monospace;font-size:14px;line-height:1.5}.priscilla-ai{position:relative;font-family:Roboto,sans-serif}.assistant-button{background:#e5e5e5;border:none;width:40px;height:40px;border-radius:6px;font-size:18px;cursor:pointer;transition:background-color .2s}.assistant-button:hover{background:#d0d0d0}.assistant-button:disabled{opacity:.6;cursor:not-allowed}.assistant-window{position:absolute;top:50px;right:0;width:350px;height:auto;max-height:500px;background:#f8f8f8;box-shadow:0 4px 12px #00000026;border-radius:8px;display:flex;flex-direction:column;z-index:1000}.assistant-header{background:#464767;color:#fff;padding:12px;font-weight:700;text-align:center;border-radius:8px 8px 0 0}.assistant-body{flex:1;padding:12px;overflow-y:auto;max-height:350px}.extracted-content{margin-bottom:12px}.code-block{background:#2d2d2d;color:#f8f8f2;padding:8px;border-radius:4px;font-family:Courier New,monospace;font-size:12px;overflow-x:auto;margin:8px 0;max-height:150px;overflow-y:auto}.hint-section{background:#e8f5e9;padding:10px;border-left:3px solid #4caf50;border-radius:4px;margin:10px 0}.hint-text{color:#2e7d32;margin:5px 0;font-size:14px}.error-message{background:#ffebee;color:#c62828;padding:10px;border-radius:4px;margin:10px 0;border-left:3px solid #f44336}.loading-spinner{text-align:center;padding:10px;color:#666}.metadata{font-size:12px;color:#999;margin-top:10px;padding-top:10px;border-top:1px solid #ddd}.assistant-footer{border-top:1px solid #ccc;padding:8px;display:flex;gap:8px;background:#fafafa;border-radius:0 0 8px 8px}.primary-button{flex:1;padding:8px 12px;border:none;background:#464767;color:#fff;border-radius:4px;cursor:pointer;white-space:nowrap;font-weight:500;transition:background-color .2s}.primary-button:hover:not(:disabled){background:#323549}.primary-button:disabled{opacity:.6;cursor:not-allowed}.secondary-button{padding:8px 12px;border:1px solid #ddd;background:#fff;color:#464767;border-radius:4px;cursor:pointer;white-space:nowrap;font-weight:500;transition:all .2s}.secondary-button:hover{background:#f5f5f5;border-color:#464767}.code-assistant{position:relative}.source-block{background:#efefef;padding:6px;margin-top:10px;font-family:monospace;font-size:12px}.mock-response{background:#e8f4f8;padding:8px;border-radius:4px;color:#333}.code-editor{width:100%;min-height:200px;font-family:monospace;font-size:14px;padding:12px;border-radius:6px;border:1px solid #ccc;background:#1e1e1e;color:#eaeaea;resize:vertical}

package/env.d.ts

@@ -0,0 +1 @@
+/// <reference types="vite/client" />

package/eslint.config.ts

@@ -0,0 +1,22 @@
+import { globalIgnores } from 'eslint/config'
+import { defineConfigWithVueTs, vueTsConfigs } from '@vue/eslint-config-typescript'
+import pluginVue from 'eslint-plugin-vue'
+import skipFormatting from '@vue/eslint-config-prettier/skip-formatting'
+
+// To allow more languages other than `ts` in `.vue` files, uncomment the following lines:
+// import { configureVueProject } from '@vue/eslint-config-typescript'
+// configureVueProject({ scriptLangs: ['ts', 'tsx'] })
+// More info at https://github.com/vuejs/eslint-config-typescript/#advanced-setup
+
+export default defineConfigWithVueTs(
+  {
+    name: 'app/files-to-lint',
+    files: ['**/*.{ts,mts,tsx,vue}'],
+  },
+
+  globalIgnores(['**/dist/**', '**/dist-ssr/**', '**/coverage/**']),
+
+  pluginVue.configs['flat/essential'],
+  vueTsConfigs.recommended,
+  skipFormatting,
+)

package/index.html

@@ -0,0 +1,13 @@
+<!DOCTYPE html>
+<html lang="">
+  <head>
+    <meta charset="UTF-8">
+    <link rel="icon" href="/favicon.ico">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Vite App</title>
+  </head>
+  <body>
+    <div id="app"></div>
+    <script type="module" src="/src/main.ts"></script>
+  </body>
+</html>

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@priscilla-ai/vue",
+  "version": "1.0.0",
+  "description": "Vue 3 Plugin in Options Api for Priscilla learning portal",
+  "private": false,
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": false,
+  "keywords": ["vue", "vue3", "plugin", "priscilla", "ai", "learning", "portal", "hints", "code-assistant"],
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/imtaki/VueJs-Bachelor-Thesis"
+  },
+  "engines": {
+    "node": "^20.19.0 || >=22.12.0"
+  },
+  "scripts": {
+    "dev": "vite",
+    "build": "run-p type-check \"build-only {@}\" --",
+    "preview": "vite preview",
+    "build-only": "vite build",
+    "type-check": "vue-tsc --build",
+    "lint": "eslint . --fix --cache",
+    "format": "prettier --write --experimental-cli src/"
+  },
+  "dependencies": {
+    "axios": "^1.13.2",
+    "pinia": "^3.0.4",
+    "vue": "^3.5.25"
+  },
+  "devDependencies": {
+    "@tsconfig/node24": "^24.0.3",
+    "@types/node": "^24.10.1",
+    "@vitejs/plugin-vue": "^6.0.2",
+    "@vue/eslint-config-prettier": "^10.2.0",
+    "@vue/eslint-config-typescript": "^14.6.0",
+    "@vue/tsconfig": "^0.8.1",
+    "eslint": "^9.39.1",
+    "eslint-plugin-vue": "~10.5.1",
+    "jiti": "^2.6.1",
+    "npm-run-all2": "^8.0.4",
+    "prettier": "3.6.2",
+    "typescript": "~5.9.0",
+    "vite": "^7.2.4",
+    "vite-plugin-vue-devtools": "^8.0.5",
+    "vue-tsc": "^3.1.5"
+  }
+}

package/src/App.vue

@@ -0,0 +1,44 @@
+<script lang="ts">
+import { defineComponent } from 'vue'
+import './styles/index.css'
+
+export default defineComponent({
+  name: 'App',
+  data() {
+    return {
+      sourceCode: `function fibonacci(n) {
+  if (n <= 1) return n
+  return fibonacci(n - 1) + fibonacci(n - 2)
+}`,
+    }
+  },
+})
+</script>
+
+<template>
+  <div class="app-container">
+    <nav class="navbar">
+      <div class="nav-items">
+        <div class="nav-item">
+          <PriscillaAI xpath="//textarea[@id='code-block']" :chapterId="12" :programId="589" />
+        </div>
+      </div>
+    </nav>
+
+    <main class="main-content">
+      <h1>Welcome to Priscilla LLM</h1>
+      <p>This is a mock navbar + AI assistant example with code hint capability.</p>
+
+      <section class="code-section">
+        <h2>Code Example</h2>
+        <textarea
+          id="code-block"
+          v-model="sourceCode"
+          class="code-editor"
+          spellcheck="false"
+        ></textarea>
+        <p><small>Click the 🤖 icon in the navbar to get a hint about this code!</small></p>
+      </section>
+    </main>
+  </div>
+</template>

package/src/components/PriscillaAI.vue

@@ -0,0 +1,192 @@
+<script lang="ts">
+import { defineComponent } from 'vue'
+import axios, { type CancelTokenSource } from 'axios'
+import { getPriscillaAIEndpoint } from '@/plugins/priscillaAI'
+import '../styles/index.css'
+import type { PriscillaAIResponse } from '@/types/priscillaAI'
+
+export default defineComponent({
+  name: 'PriscillaAI',
+
+  props: {
+    xpath: {
+      type: String,
+      required: true,
+      validator: (value: string) => value.trim().length > 0,
+    },
+    chapterId: {
+      type: Number,
+      required: true,
+      validator: (value: number) => Number.isInteger(value) && value > 0,
+    },
+    programId: {
+      type: Number,
+      required: true,
+      validator: (value: number) => Number.isInteger(value) && value > 0,
+    },
+  },
+
+  data() {
+    return {
+      isOpen: false,
+      loading: false,
+      hint: '',
+      error: '',
+      extractedContent: '',
+      cancelSource: null as CancelTokenSource | null,
+    }
+  },
+
+  computed: {
+    hasResult(): boolean {
+      return !!(this.hint || this.extractedContent)
+    },
+    buttonLabel(): string {
+      return this.loading ? 'Fetching…' : 'Get Hint'
+    },
+  },
+
+  beforeUnmount() {
+    this.cancelSource?.cancel('Component unmounted')
+  },
+
+  methods: {
+    toggle() {
+      this.isOpen = !this.isOpen
+    },
+
+    extractCodeFromXPath(): string {
+      let node: Node | null
+
+      try {
+        const result = document.evaluate(
+          this.xpath,
+          document,
+          null,
+          XPathResult.FIRST_ORDERED_NODE_TYPE,
+          null,
+        )
+        node = result.singleNodeValue
+      } catch {
+        throw new Error(`Invalid XPath expression: "${this.xpath}"`)
+      }
+
+      if (!node) {
+        throw new Error('No element matched the provided XPath.')
+      }
+
+      const content =
+        node instanceof HTMLTextAreaElement
+          ? node.value
+          : (node as HTMLElement).textContent
+
+      if (!content?.trim()) {
+        throw new Error('Matched element contains no extractable text.')
+      }
+
+      return content.trim()
+    },
+
+    async fetchHint() {
+      this.cancelSource?.cancel('Superseded by newer request')
+
+      this.loading = true
+      this.error = ''
+      this.hint = ''
+      this.extractedContent = ''
+
+      try {
+        const content = this.extractCodeFromXPath()
+        this.extractedContent = content
+
+        const endpoint = getPriscillaAIEndpoint()
+        if (!endpoint) {
+          throw new Error('API endpoint not configured. Please initialise the plugin.')
+        }
+
+        this.cancelSource = axios.CancelToken.source()
+
+        const { data } = await axios.post<PriscillaAIResponse>(
+          endpoint,
+          {
+            content,
+            chapterId: this.chapterId,
+            programId: this.programId,
+          },
+          { cancelToken: this.cancelSource.token },
+        )
+
+        this.hint = data.hint?.trim() || 'No hint available for this submission.'
+      } catch (err) {
+        if (axios.isCancel(err)) return 
+
+        if (err instanceof Error) {
+          this.error = err.message
+        } else if (axios.isAxiosError(err)) {
+          this.error = `API ${err.response?.status ?? 'Error'}: ${err.message}`
+        } else {
+          this.error = 'An unexpected error occurred.'
+        }
+      } finally {
+        this.loading = false
+      }
+    },
+
+    clearHint() {
+      this.hint = ''
+      this.extractedContent = ''
+      this.error = ''
+      this.cancelSource?.cancel('Cleared by user')
+    },
+  },
+})
+</script>
+
+<template>
+  <div class="priscilla-ai">
+    <button
+      class="assistant-button"
+      :aria-expanded="isOpen"
+      :aria-label="isOpen ? 'Close hint assistant' : 'Open hint assistant'"
+      @click="toggle"
+    >
+      <span aria-hidden="true">{{ isOpen ? '✖️' : '🤖' }}</span>
+    </button>
+
+    <div
+      v-if="isOpen"
+      class="assistant-window"
+      role="dialog"
+      aria-label="Priscilla AI – Code Hint Assistant"
+    >
+      <header class="assistant-header">Priscilla AI — Code Hint Assistant</header>
+
+      <div class="assistant-body">
+        <template v-if="extractedContent">
+          <p><strong>Extracted Code:</strong></p>
+          <pre class="code-block">{{ extractedContent }}</pre>
+        </template>
+
+        <template v-if="hint">
+          <p><strong>💡 Hint:</strong></p>
+          <p class="hint-text">{{ hint }}</p>
+        </template>
+
+        <p v-if="error" class="error-message" role="alert">❌ {{ error }}</p>
+
+        <p v-if="loading" class="loading-spinner" aria-live="polite">⏳ Fetching hint…</p>
+
+        <p class="metadata">
+          <small>Chapter {{ chapterId }} · Program {{ programId }}</small>
+        </p>
+      </div>
+
+      <footer class="assistant-footer">
+        <button class="primary-button" :disabled="loading" @click="fetchHint">
+          {{ buttonLabel }}
+        </button>
+        <button v-if="hasResult" class="secondary-button" @click="clearHint">Clear</button>
+      </footer>
+    </div>
+  </div>
+</template>

package/src/main.ts

@@ -0,0 +1,11 @@
+import { createApp } from 'vue'
+import { createPinia } from 'pinia'
+import App from './App.vue'
+import { createPriscillaAI } from './plugins/priscillaAI'
+
+const app = createApp(App)
+
+app.use(createPriscillaAI('https://api.example.com/api/predict/hint'))
+app.use(createPinia())
+
+app.mount('#app')

package/src/plugins/priscillaAI.ts

@@ -0,0 +1,21 @@
+import type { App } from 'vue'
+import PriscillaAI from '@/components/PriscillaAI.vue'
+
+let apiEndpoint: string = ''
+
+export function createPriscillaAI(endpoint: string) {
+  return {
+    install(app: App) {
+      apiEndpoint = endpoint
+
+      app.config.globalProperties.$priscillaAIEndpoint = apiEndpoint
+
+      app.component('PriscillaAI', PriscillaAI)
+    },
+  }
+}
+
+export function getPriscillaAIEndpoint(): string {
+  return apiEndpoint
+}
+

package/src/styles/index.css

@@ -0,0 +1,261 @@
+@font-face {
+  font-family: 'Roboto';
+  font-style: normal;
+  font-weight: 100;
+  font-stretch: 100%;
+  src: url(https://fonts.gstatic.com/s/roboto/v51/KFO7CnqEu92Fr1ME7kSn66aGLdTylUAMa3GUBGEe.woff2)
+    format('woff2');
+  unicode-range: U+0460-052F, U+1C80-1C8A, U+20B4, U+2DE0-2DFF, U+A640-A69F, U+FE2E-FE2F;
+}
+
+.app-container {
+  display: flex;
+  flex-direction: column;
+  height: 100vh;
+}
+
+.navbar {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  background: #ffffff;
+  border-bottom: 1px solid #ddd;
+  padding: 10px 0;
+  gap: 20px;
+}
+
+.nav-items {
+  display: flex;
+  gap: 16px;
+}
+
+.nav-item {
+  background: #e5e5e5;
+  width: 40px;
+  height: 40px;
+  border-radius: 6px;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  cursor: pointer;
+  position: relative;
+}
+
+.main-content {
+  flex: 1;
+  display: flex;
+  flex-direction: column;
+  justify-content: center;
+  align-items: center;
+  padding: 40px;
+}
+
+.code-section {
+  background: #f5f5f5;
+  padding: 20px;
+  border-radius: 8px;
+  max-width: 600px;
+  margin-top: 30px;
+}
+
+.code-section pre {
+  background: #2d2d2d;
+  color: #f8f8f2;
+  padding: 15px;
+  border-radius: 6px;
+  overflow-x: auto;
+  font-family: 'Courier New', monospace;
+  font-size: 14px;
+  line-height: 1.5;
+}
+
+/* PriscillaAI Component Styles */
+.priscilla-ai {
+  position: relative;
+  font-family: 'Roboto', sans-serif;
+}
+
+.assistant-button {
+  background: #e5e5e5;
+  border: none;
+  width: 40px;
+  height: 40px;
+  border-radius: 6px;
+  font-size: 18px;
+  cursor: pointer;
+  transition: background-color 0.2s;
+}
+
+.assistant-button:hover {
+  background: #d0d0d0;
+}
+
+.assistant-button:disabled {
+  opacity: 0.6;
+  cursor: not-allowed;
+}
+
+.assistant-window {
+  position: absolute;
+  top: 50px;
+  right: 0;
+  width: 350px;
+  height: auto;
+  max-height: 500px;
+  background: #f8f8f8;
+  box-shadow: 0 4px 12px rgba(0, 0, 0, 0.15);
+  border-radius: 8px;
+  display: flex;
+  flex-direction: column;
+  z-index: 1000;
+}
+
+.assistant-header {
+  background: #464767;
+  color: white;
+  padding: 12px;
+  font-weight: bold;
+  text-align: center;
+  border-radius: 8px 8px 0 0;
+}
+
+.assistant-body {
+  flex: 1;
+  padding: 12px;
+  overflow-y: auto;
+  max-height: 350px;
+}
+
+.extracted-content {
+  margin-bottom: 12px;
+}
+
+.code-block {
+  background: #2d2d2d;
+  color: #f8f8f2;
+  padding: 8px;
+  border-radius: 4px;
+  font-family: 'Courier New', monospace;
+  font-size: 12px;
+  overflow-x: auto;
+  margin: 8px 0;
+  max-height: 150px;
+  overflow-y: auto;
+}
+
+.hint-section {
+  background: #e8f5e9;
+  padding: 10px;
+  border-left: 3px solid #4caf50;
+  border-radius: 4px;
+  margin: 10px 0;
+}
+
+.hint-text {
+  color: #2e7d32;
+  margin: 5px 0;
+  font-size: 14px;
+}
+
+.error-message {
+  background: #ffebee;
+  color: #c62828;
+  padding: 10px;
+  border-radius: 4px;
+  margin: 10px 0;
+  border-left: 3px solid #f44336;
+}
+
+.loading-spinner {
+  text-align: center;
+  padding: 10px;
+  color: #666;
+}
+
+.metadata {
+  font-size: 12px;
+  color: #999;
+  margin-top: 10px;
+  padding-top: 10px;
+  border-top: 1px solid #ddd;
+}
+
+.assistant-footer {
+  border-top: 1px solid #ccc;
+  padding: 8px;
+  display: flex;
+  gap: 8px;
+  background: #fafafa;
+  border-radius: 0 0 8px 8px;
+}
+
+.primary-button {
+  flex: 1;
+  padding: 8px 12px;
+  border: none;
+  background: #464767;
+  color: white;
+  border-radius: 4px;
+  cursor: pointer;
+  white-space: nowrap;
+  font-weight: 500;
+  transition: background-color 0.2s;
+}
+
+.primary-button:hover:not(:disabled) {
+  background: #323549;
+}
+
+.primary-button:disabled {
+  opacity: 0.6;
+  cursor: not-allowed;
+}
+
+.secondary-button {
+  padding: 8px 12px;
+  border: 1px solid #ddd;
+  background: white;
+  color: #464767;
+  border-radius: 4px;
+  cursor: pointer;
+  white-space: nowrap;
+  font-weight: 500;
+  transition: all 0.2s;
+}
+
+.secondary-button:hover {
+  background: #f5f5f5;
+  border-color: #464767;
+}
+
+.code-assistant {
+  position: relative;
+}
+
+.source-block {
+  background: #efefef;
+  padding: 6px;
+  margin-top: 10px;
+  font-family: monospace;
+  font-size: 12px;
+}
+
+.mock-response {
+  background: #e8f4f8;
+  padding: 8px;
+  border-radius: 4px;
+  color: #333;
+}
+
+.code-editor {
+  width: 100%;
+  min-height: 200px;
+  font-family: monospace;
+  font-size: 14px;
+  padding: 12px;
+  border-radius: 6px;
+  border: 1px solid #ccc;
+  background: #1e1e1e;
+  color: #eaeaea;
+  resize: vertical;
+}

package/src/types/priscillaAI.ts

@@ -0,0 +1,4 @@
+export interface PriscillaAIResponse {
+  hint?: string
+}
+

package/tsconfig.app.json

@@ -0,0 +1,12 @@
+{
+  "extends": "@vue/tsconfig/tsconfig.dom.json",
+  "include": ["env.d.ts", "src/**/*", "src/**/*.vue"],
+  "exclude": ["src/**/__tests__/*"],
+  "compilerOptions": {
+    "tsBuildInfoFile": "./node_modules/.tmp/tsconfig.app.tsbuildinfo",
+
+    "paths": {
+      "@/*": ["./src/*"]
+    }
+  }
+}

package/tsconfig.json

@@ -0,0 +1,11 @@
+{
+  "files": [],
+  "references": [
+    {
+      "path": "./tsconfig.node.json"
+    },
+    {
+      "path": "./tsconfig.app.json"
+    }
+  ]
+}

package/tsconfig.node.json

@@ -0,0 +1,19 @@
+{
+  "extends": "@tsconfig/node24/tsconfig.json",
+  "include": [
+    "vite.config.*",
+    "vitest.config.*",
+    "cypress.config.*",
+    "nightwatch.conf.*",
+    "playwright.config.*",
+    "eslint.config.*"
+  ],
+  "compilerOptions": {
+    "noEmit": true,
+    "tsBuildInfoFile": "./node_modules/.tmp/tsconfig.node.tsbuildinfo",
+
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "types": ["node"]
+  }
+}

package/vite.config.ts

@@ -0,0 +1,29 @@
+import { defineConfig } from 'vite'
+import { fileURLToPath, URL } from 'node:url'
+import vue from '@vitejs/plugin-vue'
+
+export default defineConfig({
+  plugins: [vue()],
+  resolve: {
+    alias: {
+      '@': fileURLToPath(new URL('./src', import.meta.url))
+    }
+  },
+  build: {
+    lib: {
+      entry: fileURLToPath(new URL('./src/plugins/priscillaAI.ts', import.meta.url)),
+      name: 'PriscillaAI',
+      formats: ['es', 'umd'],
+      fileName: (format) => `index.${format === 'es' ? 'js' : 'cjs'}`
+    },
+    rollupOptions: {
+      external: ['vue', 'axios'],
+      output: {
+        globals: {
+          vue: 'Vue',
+          axios: 'axios'
+        }
+      }
+    }
+  }
+})