@blqke/vgentation 0.1.0

package/README.md

@@ -0,0 +1 @@
+Documentation: [./DOCS.md](./DOCS.md)

package/dist/components/AnnotationPopup.vue.d.ts

@@ -0,0 +1,52 @@
+import { CSSProperties, DefineComponent, ComponentOptionsMixin, PublicProps, ComponentProvideOptions } from 'vue';
+import { ComponentTreeNode } from '../types';
+export interface AnnotationPopupProps {
+    /** Element name to display in header */
+    element: string;
+    /** Optional timestamp display (e.g., "@ 1.23s" for animation feedback) */
+    timestamp?: string;
+    /** Optional selected/highlighted text */
+    selectedText?: string;
+    /** Placeholder text for the textarea */
+    placeholder?: string;
+    /** Initial value for textarea (for edit mode) */
+    initialValue?: string;
+    /** Label for submit button (default: "Add") */
+    submitLabel?: string;
+    /** Position styles (left, top) */
+    popupStyle?: CSSProperties;
+    /** Custom color for submit button and textarea focus (hex) */
+    accentColor?: string;
+    /** External exit state (parent controls exit animation) */
+    isExiting?: boolean;
+    /** Light mode styling */
+    lightMode?: boolean;
+    /** Vue component tree (closest component first) */
+    componentTree?: ComponentTreeNode[];
+}
+export interface AnnotationPopupExpose {
+    /** Shake the popup (e.g., when user clicks outside) */
+    shake: () => void;
+}
+declare const _default: DefineComponent<AnnotationPopupProps, {
+    /** Shake the popup (e.g., when user clicks outside) */
+    shake: () => void;
+}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+    submit: (text: string) => any;
+    cancel: () => any;
+    selectComponent: (index: number, component: ComponentTreeNode) => any;
+}, string, PublicProps, Readonly<AnnotationPopupProps> & Readonly<{
+    onSubmit?: ((text: string) => any) | undefined;
+    onCancel?: (() => any) | undefined;
+    onSelectComponent?: ((index: number, component: ComponentTreeNode) => any) | undefined;
+}>, {
+    placeholder: string;
+    initialValue: string;
+    submitLabel: string;
+    accentColor: string;
+    isExiting: boolean;
+    lightMode: boolean;
+}, {}, {}, {}, string, ComponentProvideOptions, false, {
+    textareaRef: HTMLTextAreaElement;
+}, HTMLDivElement>;
+export default _default;

package/dist/components/Vgentation.vue.d.ts

@@ -0,0 +1,103 @@
+import { ComponentTreeNode } from '../types';
+import { DefineComponent, ComponentOptionsMixin, PublicProps, ComponentProvideOptions, CreateComponentPublicInstanceWithMixins, GlobalComponents, GlobalDirectives } from 'vue';
+import { AnnotationPopupProps } from './AnnotationPopup.vue';
+export type DemoAnnotation = {
+    selector: string;
+    comment: string;
+    selectedText?: string;
+};
+type __VLS_Props = {
+    demoAnnotations?: DemoAnnotation[];
+    demoDelay?: number;
+    enableDemoMode?: boolean;
+    showToggleButton?: boolean;
+};
+declare const _default: DefineComponent<__VLS_Props, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    demoDelay: number;
+    enableDemoMode: boolean;
+    showToggleButton: boolean;
+}, {}, {}, {}, string, ComponentProvideOptions, false, {
+    popupRef: CreateComponentPublicInstanceWithMixins<Readonly< AnnotationPopupProps> & Readonly<{
+        onSubmit?: ((text: string) => any) | undefined;
+        onCancel?: (() => any) | undefined;
+        onSelectComponent?: ((index: number, component: ComponentTreeNode) => any) | undefined;
+    }>, {
+        shake: () => void;
+    }, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+        submit: (text: string) => any;
+        cancel: () => any;
+        selectComponent: (index: number, component: ComponentTreeNode) => any;
+    }, PublicProps, {
+        placeholder: string;
+        initialValue: string;
+        submitLabel: string;
+        accentColor: string;
+        isExiting: boolean;
+        lightMode: boolean;
+    }, false, {}, {}, GlobalComponents, GlobalDirectives, string, {
+        textareaRef: HTMLTextAreaElement;
+    }, HTMLDivElement, ComponentProvideOptions, {
+        P: {};
+        B: {};
+        D: {};
+        C: {};
+        M: {};
+        Defaults: {};
+    }, Readonly< AnnotationPopupProps> & Readonly<{
+        onSubmit?: ((text: string) => any) | undefined;
+        onCancel?: (() => any) | undefined;
+        onSelectComponent?: ((index: number, component: ComponentTreeNode) => any) | undefined;
+    }>, {
+        shake: () => void;
+    }, {}, {}, {}, {
+        placeholder: string;
+        initialValue: string;
+        submitLabel: string;
+        accentColor: string;
+        isExiting: boolean;
+        lightMode: boolean;
+    }> | null;
+    editPopupRef: CreateComponentPublicInstanceWithMixins<Readonly< AnnotationPopupProps> & Readonly<{
+        onSubmit?: ((text: string) => any) | undefined;
+        onCancel?: (() => any) | undefined;
+        onSelectComponent?: ((index: number, component: ComponentTreeNode) => any) | undefined;
+    }>, {
+        shake: () => void;
+    }, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+        submit: (text: string) => any;
+        cancel: () => any;
+        selectComponent: (index: number, component: ComponentTreeNode) => any;
+    }, PublicProps, {
+        placeholder: string;
+        initialValue: string;
+        submitLabel: string;
+        accentColor: string;
+        isExiting: boolean;
+        lightMode: boolean;
+    }, false, {}, {}, GlobalComponents, GlobalDirectives, string, {
+        textareaRef: HTMLTextAreaElement;
+    }, HTMLDivElement, ComponentProvideOptions, {
+        P: {};
+        B: {};
+        D: {};
+        C: {};
+        M: {};
+        Defaults: {};
+    }, Readonly< AnnotationPopupProps> & Readonly<{
+        onSubmit?: ((text: string) => any) | undefined;
+        onCancel?: (() => any) | undefined;
+        onSelectComponent?: ((index: number, component: ComponentTreeNode) => any) | undefined;
+    }>, {
+        shake: () => void;
+    }, {}, {}, {}, {
+        placeholder: string;
+        initialValue: string;
+        submitLabel: string;
+        accentColor: string;
+        isExiting: boolean;
+        lightMode: boolean;
+    }> | null;
+    dragRectRef: HTMLDivElement;
+    highlightsContainerRef: HTMLDivElement;
+}, any>;
+export default _default;

package/dist/components/icons/AnimatedBunny.vue.d.ts

@@ -0,0 +1,7 @@
+import { DefineComponent, ComponentOptionsMixin, PublicProps, ComponentProvideOptions } from 'vue';
+type __VLS_Props = {
+    size?: number;
+    color?: string;
+};
+declare const _default: DefineComponent<__VLS_Props, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, SVGSVGElement>;
+export default _default;

package/dist/components/icons/IconCheckSmallAnimated.vue.d.ts

@@ -0,0 +1,6 @@
+import { DefineComponent, ComponentOptionsMixin, PublicProps, ComponentProvideOptions } from 'vue';
+type __VLS_Props = {
+    size?: number;
+};
+declare const _default: DefineComponent<__VLS_Props, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, SVGSVGElement>;
+export default _default;

package/dist/components/icons/IconCopyAnimated.vue.d.ts

@@ -0,0 +1,7 @@
+import { DefineComponent, ComponentOptionsMixin, PublicProps, ComponentProvideOptions } from 'vue';
+type __VLS_Props = {
+    size?: number;
+    copied?: boolean;
+};
+declare const _default: DefineComponent<__VLS_Props, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, SVGSVGElement>;
+export default _default;

package/dist/components/icons/IconEyeAnimated.vue.d.ts

@@ -0,0 +1,7 @@
+import { DefineComponent, ComponentOptionsMixin, PublicProps, ComponentProvideOptions } from 'vue';
+type __VLS_Props = {
+    size?: number;
+    isOpen?: boolean;
+};
+declare const _default: DefineComponent<__VLS_Props, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, SVGSVGElement>;
+export default _default;

package/dist/components/icons/IconPausePlayAnimated.vue.d.ts

@@ -0,0 +1,7 @@
+import { DefineComponent, ComponentOptionsMixin, PublicProps, ComponentProvideOptions } from 'vue';
+type __VLS_Props = {
+    size?: number;
+    isPaused?: boolean;
+};
+declare const _default: DefineComponent<__VLS_Props, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, SVGSVGElement>;
+export default _default;

package/dist/components/icons/index.d.ts

@@ -0,0 +1,34 @@
+import { FunctionalComponent, CSSProperties } from 'vue';
+export { default as IconCopyAnimated } from './IconCopyAnimated.vue';
+export { default as IconEyeAnimated } from './IconEyeAnimated.vue';
+export { default as IconPausePlayAnimated } from './IconPausePlayAnimated.vue';
+export { default as IconCheckSmallAnimated } from './IconCheckSmallAnimated.vue';
+export { default as AnimatedBunny } from './AnimatedBunny.vue';
+interface IconProps {
+    size?: number;
+    style?: CSSProperties;
+}
+export declare const IconClose: FunctionalComponent<IconProps>;
+export declare const IconPlus: FunctionalComponent<IconProps>;
+export declare const IconCheck: FunctionalComponent<IconProps>;
+export declare const IconCheckSmall: FunctionalComponent<IconProps>;
+export declare const IconListSparkle: FunctionalComponent<IconProps>;
+export declare const IconHelp: FunctionalComponent<IconProps>;
+export declare const IconCopyAlt: FunctionalComponent<IconProps>;
+export declare const IconEye: FunctionalComponent<IconProps>;
+export declare const IconEyeAlt: FunctionalComponent<IconProps>;
+export declare const IconEyeClosed: FunctionalComponent<IconProps>;
+export declare const IconEyeMinus: FunctionalComponent<IconProps>;
+export declare const IconGear: FunctionalComponent<IconProps>;
+export declare const IconPauseAlt: FunctionalComponent<IconProps>;
+export declare const IconPause: FunctionalComponent<IconProps>;
+export declare const IconPlayAlt: FunctionalComponent<IconProps>;
+export declare const IconTrashAlt: FunctionalComponent<IconProps>;
+export declare const IconChatEllipsis: FunctionalComponent<IconProps>;
+export declare const IconCheckmark: FunctionalComponent<IconProps>;
+export declare const IconCheckmarkLarge: FunctionalComponent<IconProps>;
+export declare const IconCheckmarkCircle: FunctionalComponent<IconProps>;
+export declare const IconXmark: FunctionalComponent<IconProps>;
+export declare const IconXmarkLarge: FunctionalComponent<IconProps>;
+export declare const IconSun: FunctionalComponent<IconProps>;
+export declare const IconMoon: FunctionalComponent<IconProps>;

package/dist/composables/useVgentation.d.ts

@@ -0,0 +1,63 @@
+import { InjectionKey, Ref, ComputedRef } from 'vue';
+import { Annotation } from '../types';
+/** Full context returned by useVgentation() */
+export interface VgentationContext {
+    /** Whether the annotation tool is currently active */
+    readonly isActive: ComputedRef<boolean>;
+    /** Current list of annotations */
+    readonly annotations: ComputedRef<readonly Annotation[]>;
+    /** Current markdown output */
+    readonly output: ComputedRef<string>;
+    /** Activate the annotation tool */
+    activate: () => void;
+    /** Deactivate the annotation tool */
+    deactivate: () => void;
+    /** Toggle the annotation tool active state */
+    toggle: () => void;
+    /** Clear all annotations */
+    clearAll: () => void;
+    /** Copy output to clipboard */
+    copyOutput: () => void;
+    /** Get a copy of current annotations array */
+    getAnnotations: () => Annotation[];
+    /** Get the current markdown output string */
+    getOutput: () => string;
+    /** @internal Register the Vgentation component instance */
+    _register: (instance: RegisteredInstance) => void;
+    /** @internal Unregister the Vgentation component instance */
+    _unregister: () => void;
+    /** @internal Check if a component is registered */
+    _isRegistered: ComputedRef<boolean>;
+}
+/** @internal Interface for the registered Vgentation component */
+export interface RegisteredInstance {
+    isActive: Ref<boolean>;
+    annotations: Ref<Annotation[]>;
+    getOutput: () => string;
+    clearAll: () => void;
+    copyOutput: () => void;
+}
+export declare const VgentationKey: InjectionKey<VgentationContext>;
+export declare function createVgentationContext(): VgentationContext;
+/**
+ * Use the Vgentation context from anywhere in your app.
+ *
+ * @example
+ * ```vue
+ * <script setup>
+ * import { useVgentation } from 'vgentation'
+ *
+ * const { toggle, isActive } = useVgentation()
+ * </script>
+ *
+ * <template>
+ *   <button @click="toggle">{{ isActive ? 'Active' : 'Inactive' }}</button>
+ * </template>
+ * ```
+ */
+export declare function useVgentation(): VgentationContext;
+/**
+ * @internal Provide Vgentation context. Used by Vgentation.vue component.
+ * Should not be called directly by users.
+ */
+export declare function provideVgentation(): VgentationContext;