noktiq 0.0.0-stage → 0.1.0

package/CONTRIBUTING.md

@@ -0,0 +1,37 @@
+# Contributing to Noktiq
+
+Noktiq helps people give coding agents clear visual change requests in React and Vue projects. Bug fixes, reproducible compatibility reports and focused improvements are welcome.
+
+## Before starting
+
+Open an issue first for a substantial feature, framework integration or UI change. Explain the problem and a concrete example. Keep the existing mascot and interaction design unless a design change has been agreed.
+
+For bugs, include the Noktiq/framework/build-tool/browser versions, reproduction steps and expected versus actual behavior. A small repository or code sample is especially useful. Remove credentials, private project code and personal paths from shared examples. Follow [SECURITY.md](SECURITY.md) for vulnerabilities.
+
+## Run locally
+
+Use a Node version supported by the installed Vite toolchain. From the repository root:
+
+```sh
+npm ci
+npm run build
+npm run dev:react
+```
+
+Use `npm run dev:vue` in another terminal for the Vue demo. Examples consume `dist`; rebuild after library changes. The [developer guide](docs/guide.tr.md) covers Next, Nuxt, Webpack and browser fixtures.
+
+## Before a pull request
+
+Keep the change focused and follow the surrounding code. Add a small meaningful test for changed logic. For normal SDK changes run:
+
+```sh
+npm run build
+npm run typecheck
+npm test
+```
+
+For selection, targeting or UI changes, also build the examples and run the relevant browser tests. Use `npm run verify:package` for package changes and the compatibility/ecosystem suites for affected integrations. Report the exact commands run and any checks skipped; documentation-only edits do not require the entire browser matrix.
+
+Run `npm run check:release` before sharing new report files. Published report excerpts replace the local project root with `[project]`; raw test outputs stay under ignored local directories. Do not include `.env`, installed dependencies, generated packages or raw recordings.
+
+By submitting a contribution, offer your original changes under the project's [PolyForm Shield 1.0.0 license](LICENSE). Only contribute material you have the right to share, and preserve applicable third-party notices. This does not transfer your copyright to the maintainer.

package/LICENSE

@@ -0,0 +1,91 @@
+Required Notice: Copyright (c) 2026 Duran Gezer
+
+# PolyForm Shield License 1.0.0
+
+<https://polyformproject.org/licenses/shield/1.0.0>
+
+## Acceptance
+
+In order to get any license under these terms, you must agree to them as both strict obligations and conditions to all your licenses.
+
+## Copyright License
+
+The licensor grants you a copyright license for the software to do everything you might do with the software that would otherwise infringe the licensor's copyright in it for any permitted purpose.  However, you may only distribute the software according to [Distribution License](#distribution-license) and make changes or new works based on the software according to [Changes and New Works License](#changes-and-new-works-license).
+
+## Distribution License
+
+The licensor grants you an additional copyright license to distribute copies of the software.  Your license to distribute covers distributing the software with changes and new works permitted by [Changes and New Works License](#changes-and-new-works-license).
+
+## Notices
+
+You must ensure that anyone who gets a copy of any part of the software from you also gets a copy of these terms or the URL for them above, as well as copies of any plain-text lines beginning with `Required Notice:` that the licensor provided with the software.  For example:
+
+> Required Notice: Copyright Yoyodyne, Inc. (http://example.com)
+
+## Changes and New Works License
+
+The licensor grants you an additional copyright license to make changes and new works based on the software for any permitted purpose.
+
+## Patent License
+
+The licensor grants you a patent license for the software that covers patent claims the licensor can license, or becomes able to license, that you would infringe by using the software.
+
+## Noncompete
+
+Any purpose is a permitted purpose, except for providing any product that competes with the software or any product the licensor or any of its affiliates provides using the software.
+
+## Competition
+
+Goods and services compete even when they provide functionality through different kinds of interfaces or for different technical platforms.  Applications can compete with services, libraries with plugins, frameworks with development tools, and so on, even if they're written in different programming languages or for different computer architectures.  Goods and services compete even when provided free of charge.  If you market a product as a practical substitute for the software or another product, it definitely competes.
+
+## New Products
+
+If you are using the software to provide a product that does not compete, but the licensor or any of its affiliates brings your product into competition by providing a new version of the software or another product using the software, you may continue using versions of the software available under these terms beforehand to provide your competing product, but not any later versions.
+
+## Discontinued Products
+
+You may begin using the software to compete with a product or service that the licensor or any of its affiliates has stopped providing, unless the licensor includes a plain-text line beginning with `Licensor Line of Business:` with the software that mentions that line of business.  For example:
+
+> Licensor Line of Business: YoyodyneCMS Content Management System (http://example.com/cms)
+
+## Sales of Business
+
+If the licensor or any of its affiliates sells a line of business developing the software or using the software to provide a product, the buyer can also enforce [Noncompete](#noncompete) for that product.
+
+## Fair Use
+
+You may have "fair use" rights for the software under the law. These terms do not limit them.
+
+## No Other Rights
+
+These terms do not allow you to sublicense or transfer any of your licenses to anyone else, or prevent the licensor from granting licenses to anyone else.  These terms do not imply any other licenses.
+
+## Patent Defense
+
+If you make any written claim that the software infringes or contributes to infringement of any patent, your patent license for the software granted under these terms ends immediately. If your company makes such a claim, your patent license ends immediately for work on behalf of your company.
+
+## Violations
+
+The first time you are notified in writing that you have violated any of these terms, or done anything with the software not covered by your licenses, your licenses can nonetheless continue if you come into full compliance with these terms, and take practical steps to correct past violations, within 32 days of receiving notice.  Otherwise, all your licenses end immediately.
+
+## No Liability
+
+***As far as the law allows, the software comes as is, without any warranty or condition, and the licensor will not be liable to you for any damages arising out of these terms or the use or nature of the software, under any kind of legal claim.***
+
+## Definitions
+
+The **licensor** is the individual or entity offering these terms, and the **software** is the software the licensor makes available under these terms.
+
+A **product** can be a good or service, or a combination of them.
+
+**You** refers to the individual or entity agreeing to these terms.
+
+**Your company** is any legal entity, sole proprietorship, or other kind of organization that you work for, plus all its affiliates.
+
+**Affiliates** means the other organizations than an organization has control over, is under the control of, or is under common control with.
+
+**Control** means ownership of substantially all the assets of an entity, or the power to direct its management and policies by vote, contract, or otherwise.  Control can be direct or indirect.
+
+**Your licenses** are all the licenses granted to you for the software under these terms.
+
+**Use** means anything you do with the software requiring one of your licenses.

package/README.md

@@ -1,3 +1,73 @@
-# Temporary Holding Version
+# Noktiq
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+**Point. Note. Paste. Visual change requests for React and Vue.**
+
+Select an element on your development website, describe the change and copy a request into your coding agent. Noktiq includes the source file, line and column when available, plus selectors and page context. No AI account or API key is required.
+
+```sh
+npm install -D noktiq
+```
+
+## React + Vite
+
+```tsx
+import { Noktiq } from 'noktiq/react';
+
+export default function App() {
+  return <>{/* Your application */}<Noktiq enabled={import.meta.env.DEV} /></>;
+}
+```
+
+```ts
+// vite.config.ts
+import { defineConfig } from 'vite';
+import react from '@vitejs/plugin-react';
+import { noktiq } from 'noktiq/vite';
+
+export default defineConfig({ plugins: [noktiq(), react()] });
+```
+
+## Vue + Vite
+
+```vue
+<script setup>
+import { Noktiq } from 'noktiq/vue';
+const isDev = import.meta.env.DEV;
+</script>
+
+<template>
+  <!-- Your application -->
+  <Noktiq :enabled="isDev" />
+</template>
+```
+
+```ts
+// vite.config.ts
+import { defineConfig } from 'vite';
+import vue from '@vitejs/plugin-vue';
+import { noktiq } from 'noktiq/vite';
+
+export default defineConfig({ plugins: [noktiq(), vue()] });
+```
+
+The component is disabled by default. Keep the development guard in your application; the source plugin also runs only in development.
+
+## Workflow
+
+1. Click Nok to enter selection mode.
+2. Select an element, enter your request and save the note.
+3. Copy one note or all notes into your existing coding agent.
+
+Drag Nok to reposition it. Notes support text, multiple elements and area selection; parent navigation; source links; live target status; rebinding; computed styles; and configurable output detail. Notes stay in your browser and are synchronized between tabs on the same origin.
+
+## Compatibility
+
+Tested examples cover React 18/19, Vue 3.4/3.5, Next.js 14/15/16, Nuxt 3/4, Vite 6/7/8 and Webpack 5. These tests do not guarantee every version or component combination. Closed Shadow DOM, cross-origin iframes and individual canvas/3D objects are outside the supported selection scope.
+
+For Next.js, Nuxt, Webpack, editor configuration and all options, see the packaged [developer guide](docs/guide.tr.md). The [captured request](docs/walkthrough-request.md) shows a real output example. Demo recordings and repository-only validation reports are intentionally excluded from the npm archive.
+
+## Privacy and license
+
+Noktiq does not send notes to an AI service. Inspect copied context before sharing it, and mark sensitive regions with `data-noktiq-private`. Browser storage failures are reported; memory-only notes are lost on a full reload.
+
+Source-available under [PolyForm Shield 1.0.0](LICENSE). Copyright (c) 2026 Duran Gezer. See [contributing](CONTRIBUTING.md) and [security reporting](SECURITY.md).

package/SECURITY.md

@@ -0,0 +1,19 @@
+# Security policy
+
+Noktiq is a development tool. Its UI requires DOM access and the source integration runs in a local development server. Keep the documented development guards in place and avoid exposing your development server to untrusted networks.
+
+## Report privately
+
+Use the repository's **Security → Advisories → Report a vulnerability** action when available. Include affected versions, a minimal reproduction, impact and suggested mitigation. Remove real credentials and personal data.
+
+If the private-report button is unavailable, open an issue asking the maintainer for a private reporting channel **without describing the vulnerability or posting exploit details**. Wait for a private channel before sharing the report. No public email address or response-time guarantee has been established for this preview.
+
+Do not test against other people's projects without permission. Do not publish credentials, private source code or vulnerability details in ordinary issues or pull requests.
+
+## Supported versions
+
+The current development-preview version is the maintenance target. Updates are made on the current development line; historical-version backports are not promised.
+
+## Maintainer setup
+
+Before public release, enable GitHub private vulnerability reporting in the repository settings and verify that the report button is available. This is an account/repository setting; adding this document alone does not enable it. See [GitHub's setup instructions](https://docs.github.com/en/code-security/how-tos/report-and-fix-vulnerabilities/configure-vulnerability-reporting/configure-for-a-repository).

package/dist/context.d.ts

@@ -0,0 +1,50 @@
+import { type ElementDetails } from './identity.js';
+import { type Boundary } from './dom.js';
+export interface Annotation extends ElementDetails {
+    id: string;
+    page: string;
+    selector: string;
+    tag: string;
+    text: string;
+    selectorStrategy?: 'identity' | 'structure';
+    boundaries?: Boundary[];
+    kind?: 'element' | 'text' | 'group' | 'area';
+    selectedText?: string;
+    textRange?: {
+        start: number;
+        end: number;
+        text?: string;
+    };
+    bounds?: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    targets?: AnnotationTarget[];
+    anchor?: {
+        x: number;
+        y: number;
+    };
+    viewport: {
+        width: number;
+        height: number;
+    };
+    note: string;
+}
+export type AnnotationTarget = Omit<Annotation, 'id' | 'note' | 'targets'>;
+export { exportNotes } from './output.js';
+export declare function selectorFor(element: Element): string;
+export declare function pageKey(location: Location, useHashLocation?: boolean): string;
+export declare function contextFor(element: Element, useHashLocation?: boolean): Omit<Annotation, 'id' | 'note'>;
+export declare function readNotes(storage: Pick<Storage, 'getItem'>, key: string, page: string): Annotation[];
+export declare function writeNotes(storage: Storage, key: string, notes: Annotation[]): void;
+export declare function matchesAnnotation(element: Element, item: Annotation): boolean;
+/** Reattach only when captured evidence identifies one element; never choose the first match. */
+export declare function findAnnotatedElement(document: Document, item: Annotation): Element | undefined;
+export interface LocationResult {
+    status: 'found' | 'ambiguous' | 'changed' | 'missing' | 'boundary-unavailable' | 'invalid' | 'too-many';
+    element?: Element;
+    count?: number;
+}
+export declare function locateAnnotation(document: Document, item: Annotation): LocationResult;

package/dist/dom.d.ts

@@ -0,0 +1,36 @@
+export type QueryRoot = Document | ShadowRoot;
+export interface Boundary {
+    kind: 'shadow' | 'frame';
+    selector: string;
+    page?: string;
+}
+export declare function isElement(value: unknown): value is Element;
+export declare function parentAcross(element: Element): Element | null;
+export declare function closestAcross(element: Element, selector: string): Element | null;
+export declare function routeKey(location: Location | URL, hash?: boolean): string;
+export declare function boundariesFor(element: Element, selectorFor: (element: Element) => string): Boundary[];
+export declare function rootFor(document: Document, path?: Boundary[]): QueryRoot | undefined;
+export declare function hostPoint(document: Document, x: number, y: number): {
+    x: number;
+    y: number;
+    scaleX: number;
+    scaleY: number;
+    visible: boolean;
+};
+export declare function hostRect(element: Element): {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+    right: number;
+    bottom: number;
+    visible: boolean;
+    clip: {
+        left: number;
+        top: number;
+        right: number;
+        bottom: number;
+    };
+};
+/** Observe only accessible roots. No patching of application prototypes or timers. */
+export declare function watchContexts(host: HTMLElement, attach: (document: Document) => () => void, changed: (roots: QueryRoot[]) => void): () => void;

package/dist/editor.d.ts

@@ -0,0 +1,19 @@
+export interface EditorTarget {
+    kind: 'vite' | 'next';
+    file: string;
+    base?: string;
+}
+export interface SourceLocation {
+    file: string;
+    line: number;
+    column: number;
+    source: string;
+    page: string;
+}
+export declare function parseSource(source?: string): {
+    file: string;
+    line: number;
+    column: number;
+} | undefined;
+export declare function validEditor(value: unknown): value is EditorTarget;
+export declare function editorURL(editor: EditorTarget, source: string, page: string): URL | undefined;

package/dist/identity.d.ts

@@ -0,0 +1,36 @@
+export declare const identifyingAttributes: readonly ["data-testid", "data-test", "data-test-id", "data-qa", "data-cy", "data-component", "data-row-id", "data-row-key", "data-item-id", "data-item-key", "row-id", "col-id"];
+export declare const styleProperties: readonly ["color", "background-color", "font-family", "font-size", "font-weight", "line-height", "letter-spacing", "display", "position", "width", "height", "gap", "padding-top", "padding-right", "padding-bottom", "padding-left", "margin-top", "margin-right", "margin-bottom", "margin-left", "border-radius"];
+import { type EditorTarget } from './editor.js';
+export interface ElementDetails {
+    editor?: EditorTarget;
+    identifiers?: Record<string, string>;
+    ancestors?: Array<{
+        tag: string;
+        identifiers: Record<string, string>;
+    }>;
+    classes?: string[];
+    role?: string;
+    label?: string;
+    components?: {
+        framework: 'react' | 'vue';
+        names: string[];
+    };
+    source?: string;
+    sourceScope?: string;
+    sourceKind?: 'element' | 'ancestor' | 'component-usage' | 'component';
+    sourceProvider?: 'vue-vnode';
+    componentFile?: {
+        file: string;
+        name?: string;
+    };
+    computedStyles?: Record<string, string>;
+}
+export declare function stableId(id: string): boolean;
+export declare function identifiersFor(element: Element): Record<string, string>;
+export declare function attributeSelector(name: string, value: string): string;
+/** A selector must resolve to this exact element, including with duplicate IDs. */
+export declare function locatorFor(element: Element): {
+    selector: string;
+    selectorStrategy: 'identity' | 'structure';
+};
+export declare function detailsFor(element: Element, sensitive?: boolean): ElementDetails;

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+import type { NoktiqOptions } from './options.js';
+export type { SourceLocation } from './editor.js';
+export { exportNotes, type Annotation } from './context.js';
+export type { NoktiqOptions } from './options.js';
+export type { CopyFormat, OutputDetail, OutputOptions } from './output.js';
+export type { AnnotationTarget } from './context.js';
+/** Mount after the page is ready, only in development. Returns an idempotent cleanup. */
+export declare function mountNoktiq(options?: NoktiqOptions): () => void;

package/dist/index.js

@@ -0,0 +1,9 @@
+import {
+  exportNotes,
+  mountNoktiq
+} from "./shared-chunk.js";
+export {
+  exportNotes,
+  mountNoktiq
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/mascot.d.ts

@@ -0,0 +1,12 @@
+/** Original Nok artwork; only static, trusted markup enters the SVG. */
+export declare const nok = "\n<svg class=\"nok\" viewBox=\"0 0 100 108\" fill=\"none\" aria-hidden=\"true\">\n  <defs>\n    <radialGradient id=\"nok-body\" cx=\".29\" cy=\".16\" r=\".92\"><stop stop-color=\"#575754\"/><stop offset=\".47\" stop-color=\"#393A38\"/><stop offset=\"1\" stop-color=\"#242624\"/></radialGradient>\n    <linearGradient id=\"nok-rim\" x1=\"19\" y1=\"10\" x2=\"83\" y2=\"92\" gradientUnits=\"userSpaceOnUse\"><stop stop-color=\"#FFFFFF\" stop-opacity=\".24\"/><stop offset=\"1\" stop-color=\"#FFFFFF\" stop-opacity=\"0\"/></linearGradient>\n    <filter id=\"nok-shadow\" x=\"-30%\" y=\"-150%\" width=\"160%\" height=\"400%\"><feGaussianBlur stdDeviation=\"3.4\"/></filter>\n    <filter id=\"nok-grain\" x=\"0\" y=\"0\" width=\"100%\" height=\"100%\"><feTurbulence type=\"fractalNoise\" baseFrequency=\".78\" numOctaves=\"3\" stitchTiles=\"stitch\"/><feColorMatrix type=\"saturate\" values=\"0\"/><feComposite in2=\"SourceGraphic\" operator=\"in\"/><feBlend in=\"SourceGraphic\" mode=\"soft-light\"/></filter>\n  </defs>\n  <ellipse class=\"nok-shadow\" cx=\"49\" cy=\"98\" rx=\"28\" ry=\"3.1\" fill=\"#252722\" opacity=\".18\" filter=\"url(#nok-shadow)\"/>\n  <g class=\"nok-body\">\n    <path d=\"M49 8C25 7 9 23 8 46C6 70 19 85 43 87C52 88 60 85 65 87L83 96C87 98 91 96 89 90L83 70C89 61 92 52 89 39C85 20 69 9 49 8Z\" fill=\"url(#nok-body)\"/>\n    <path d=\"M49 8C25 7 9 23 8 46C6 70 19 85 43 87C52 88 60 85 65 87L83 96C87 98 91 96 89 90L83 70C89 61 92 52 89 39C85 20 69 9 49 8Z\" fill=\"url(#nok-body)\" filter=\"url(#nok-grain)\" opacity=\".16\"/>\n    <path d=\"M49 8C25 7 9 23 8 46C6 70 19 85 43 87C52 88 60 85 65 87L83 96C87 98 91 96 89 90L83 70C89 61 92 52 89 39C85 20 69 9 49 8Z\" stroke=\"url(#nok-rim)\" stroke-width=\"1.1\"/>\n    <g class=\"nok-gaze\">\n      <g class=\"nok-blink\"><ellipse class=\"eye eye-left\" cx=\"34\" cy=\"46\" rx=\"4.5\" ry=\"9\" fill=\"#FFF8E9\"/><ellipse class=\"eye eye-right\" cx=\"57\" cy=\"43\" rx=\"4.5\" ry=\"9\" fill=\"#FFF8E9\"/></g>\n      <g class=\"nok-happy\" stroke=\"#FFF8E9\" stroke-width=\"4.5\" stroke-linecap=\"round\"><path d=\"M29 47Q34 37 39 47\"/><path d=\"M52 44Q57 34 62 44\"/></g>\n    </g>\n    <rect class=\"nok-cheek\" x=\"69\" y=\"50\" width=\"12\" height=\"5.8\" rx=\"2.9\" transform=\"rotate(-29 69 50)\" fill=\"#FF977C\"/>\n  </g>\n</svg>";
+declare const paths: {
+    select: string;
+    notes: string;
+    copy: string;
+    edit: string;
+    trash: string;
+    close: string;
+};
+export declare function icon(name: keyof typeof paths): SVGElement;
+export {};

package/dist/motion.d.ts

@@ -0,0 +1,6 @@
+export declare function pageMotion(host: Element): {
+    readonly paused: boolean;
+    refresh: (roots: Array<Document | ShadowRoot>) => void;
+    toggle(roots: Array<Document | ShadowRoot>): void;
+    dispose: () => void;
+};

package/dist/next.d.ts

@@ -0,0 +1,3 @@
+import type { NextConfig } from 'next';
+/** Adds development-only source locations while preserving the application's config. */
+export declare function withNoktiq(config?: NextConfig): NextConfig;

package/dist/next.js

@@ -0,0 +1,51 @@
+// src/next.ts
+import { fileURLToPath } from "node:url";
+import { createRequire } from "node:module";
+import { resolve } from "node:path";
+function withNoktiq(config = {}) {
+  const loader = fileURLToPath(new URL("./webpack-loader.cjs", import.meta.url));
+  const [major, minor] = createRequire(resolve(process.cwd(), "package.json"))("next/package.json").version.split(".").map(Number);
+  const modern = major >= 16;
+  const pattern = modern ? "*.{js,jsx,ts,tsx}" : "*.{js,jsx,tsx}";
+  const legacy = major < 15 || major === 15 && minor < 3;
+  const experimental = config.experimental;
+  const turbo = (legacy ? experimental?.turbo : config.turbopack ?? experimental?.turbo) || {};
+  const root = turbo.root || process.cwd();
+  const { [pattern]: previous, ...otherRules } = turbo.rules || {};
+  const sourceLoader = { loader, options: { root, editor: { kind: "next", base: config.basePath || "/" }, ...!modern ? { transpileTypescript: true } : {} } };
+  const previousLoaders = Array.isArray(previous) ? previous : previous?.loaders || [];
+  const rules = modern ? {
+    [pattern]: [
+      { condition: { all: ["development", { not: "foreign" }] }, loaders: [sourceLoader] },
+      ...previous ? Array.isArray(previous) ? previous : [previous] : []
+    ],
+    ...otherRules
+  } : process.env.NODE_ENV === "production" ? turbo.rules : {
+    [pattern]: { ...!Array.isArray(previous) ? previous : {}, loaders: [sourceLoader, ...previousLoaders] },
+    ...otherRules
+  };
+  const integration = legacy ? { experimental: { ...experimental, turbo: { ...turbo, rules } } } : { turbopack: { ...turbo, rules } };
+  return {
+    ...config,
+    // Next 14/15 use rule shapes absent from the current Next type declarations.
+    ...integration,
+    webpack(webpackConfig, context) {
+      const result = config.webpack?.(webpackConfig, context) || webpackConfig;
+      if (context.dev) {
+        result.module ||= {};
+        result.module.rules ||= [];
+        result.module.rules.unshift({
+          test: /\.[jt]sx?$/,
+          exclude: /node_modules/,
+          enforce: "pre",
+          use: [{ loader, options: { root, editor: { kind: "next", base: config.basePath || "/" } } }]
+        });
+      }
+      return result;
+    }
+  };
+}
+export {
+  withNoktiq
+};
+//# sourceMappingURL=next.js.map

package/dist/next.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/next.ts"],
+  "sourcesContent": ["import { fileURLToPath } from 'node:url';\r\nimport { createRequire } from 'node:module';\r\nimport { resolve } from 'node:path';\r\nimport type { NextConfig } from 'next';\r\n\r\n/** Adds development-only source locations while preserving the application's config. */\r\nexport function withNoktiq(config: NextConfig = {}): NextConfig {\r\n  const loader = fileURLToPath(new URL('./webpack-loader.cjs', import.meta.url));\r\n  const [major, minor] = createRequire(resolve(process.cwd(), 'package.json'))('next/package.json').version.split('.').map(Number);\r\n  const modern = major >= 16;\r\n  // Old Turbopack applies .ts loaders to virtual HMR modules before our loader can filter them.\r\n  const pattern = modern ? '*.{js,jsx,ts,tsx}' : '*.{js,jsx,tsx}';\r\n  const legacy = major < 15 || (major === 15 && minor < 3);\r\n  const experimental = config.experimental as typeof config.experimental & { turbo?: NonNullable<NextConfig['turbopack']> };\r\n  const turbo = (legacy ? experimental?.turbo : config.turbopack ?? experimental?.turbo) || {};\r\n  const root = turbo.root || process.cwd();\r\n  const { [pattern]: previous, ...otherRules } = turbo.rules || {};\r\n  const sourceLoader = { loader, options: { root, editor: { kind: 'next', base: config.basePath || '/' }, ...(!modern ? { transpileTypescript: true } : {}) } };\r\n  const previousLoaders = Array.isArray(previous) ? previous : previous?.loaders || [];\r\n  const rules = modern ? {\r\n    [pattern]: [\r\n      { condition: { all: ['development', { not: 'foreign' }] }, loaders: [sourceLoader] },\r\n      ...(previous ? Array.isArray(previous) ? previous : [previous] : []),\r\n    ], ...otherRules,\r\n  } : process.env.NODE_ENV === 'production' ? turbo.rules : {\r\n    [pattern]: { ...(!Array.isArray(previous) ? previous : {}), loaders: [sourceLoader, ...previousLoaders] }, ...otherRules,\r\n  };\r\n  const integration = legacy\r\n    ? { experimental: { ...experimental, turbo: { ...turbo, rules } } }\r\n    : { turbopack: { ...turbo, rules } };\r\n  return {\r\n    ...config,\r\n    // Next 14/15 use rule shapes absent from the current Next type declarations.\r\n    ...(integration as NextConfig),\r\n    webpack(webpackConfig, context) {\r\n      const result = config.webpack?.(webpackConfig, context) || webpackConfig;\r\n      if (context.dev) { result.module ||= {}; result.module.rules ||= []; result.module.rules.unshift({\r\n        test: /\\.[jt]sx?$/, exclude: /node_modules/, enforce: 'pre',\r\n        use: [{ loader, options: { root, editor: { kind: 'next', base: config.basePath || '/' } } }],\r\n      }); }\r\n      return result;\r\n    },\r\n  };\r\n}\r\n"],
+  "mappings": ";AAAA,SAAS,qBAAqB;AAC9B,SAAS,qBAAqB;AAC9B,SAAS,eAAe;AAIjB,SAAS,WAAW,SAAqB,CAAC,GAAe;AAC9D,QAAM,SAAS,cAAc,IAAI,IAAI,wBAAwB,YAAY,GAAG,CAAC;AAC7E,QAAM,CAAC,OAAO,KAAK,IAAI,cAAc,QAAQ,QAAQ,IAAI,GAAG,cAAc,CAAC,EAAE,mBAAmB,EAAE,QAAQ,MAAM,GAAG,EAAE,IAAI,MAAM;AAC/H,QAAM,SAAS,SAAS;AAExB,QAAM,UAAU,SAAS,sBAAsB;AAC/C,QAAM,SAAS,QAAQ,MAAO,UAAU,MAAM,QAAQ;AACtD,QAAM,eAAe,OAAO;AAC5B,QAAM,SAAS,SAAS,cAAc,QAAQ,OAAO,aAAa,cAAc,UAAU,CAAC;AAC3F,QAAM,OAAO,MAAM,QAAQ,QAAQ,IAAI;AACvC,QAAM,EAAE,CAAC,OAAO,GAAG,UAAU,GAAG,WAAW,IAAI,MAAM,SAAS,CAAC;AAC/D,QAAM,eAAe,EAAE,QAAQ,SAAS,EAAE,MAAM,QAAQ,EAAE,MAAM,QAAQ,MAAM,OAAO,YAAY,IAAI,GAAG,GAAI,CAAC,SAAS,EAAE,qBAAqB,KAAK,IAAI,CAAC,EAAG,EAAE;AAC5J,QAAM,kBAAkB,MAAM,QAAQ,QAAQ,IAAI,WAAW,UAAU,WAAW,CAAC;AACnF,QAAM,QAAQ,SAAS;AAAA,IACrB,CAAC,OAAO,GAAG;AAAA,MACT,EAAE,WAAW,EAAE,KAAK,CAAC,eAAe,EAAE,KAAK,UAAU,CAAC,EAAE,GAAG,SAAS,CAAC,YAAY,EAAE;AAAA,MACnF,GAAI,WAAW,MAAM,QAAQ,QAAQ,IAAI,WAAW,CAAC,QAAQ,IAAI,CAAC;AAAA,IACpE;AAAA,IAAG,GAAG;AAAA,EACR,IAAI,QAAQ,IAAI,aAAa,eAAe,MAAM,QAAQ;AAAA,IACxD,CAAC,OAAO,GAAG,EAAE,GAAI,CAAC,MAAM,QAAQ,QAAQ,IAAI,WAAW,CAAC,GAAI,SAAS,CAAC,cAAc,GAAG,eAAe,EAAE;AAAA,IAAG,GAAG;AAAA,EAChH;AACA,QAAM,cAAc,SAChB,EAAE,cAAc,EAAE,GAAG,cAAc,OAAO,EAAE,GAAG,OAAO,MAAM,EAAE,EAAE,IAChE,EAAE,WAAW,EAAE,GAAG,OAAO,MAAM,EAAE;AACrC,SAAO;AAAA,IACL,GAAG;AAAA;AAAA,IAEH,GAAI;AAAA,IACJ,QAAQ,eAAe,SAAS;AAC9B,YAAM,SAAS,OAAO,UAAU,eAAe,OAAO,KAAK;AAC3D,UAAI,QAAQ,KAAK;AAAE,eAAO,WAAW,CAAC;AAAG,eAAO,OAAO,UAAU,CAAC;AAAG,eAAO,OAAO,MAAM,QAAQ;AAAA,UAC/F,MAAM;AAAA,UAAc,SAAS;AAAA,UAAgB,SAAS;AAAA,UACtD,KAAK,CAAC,EAAE,QAAQ,SAAS,EAAE,MAAM,QAAQ,EAAE,MAAM,QAAQ,MAAM,OAAO,YAAY,IAAI,EAAE,EAAE,CAAC;AAAA,QAC7F,CAAC;AAAA,MAAG;AACJ,aAAO;AAAA,IACT;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/options.d.ts

@@ -0,0 +1,8 @@
+export interface NoktiqOptions {
+    portalContainer?: HTMLElement | ShadowRoot | null | (() => HTMLElement | ShadowRoot | null);
+    useHashLocation?: boolean;
+    enableKeyboardShortcuts?: boolean;
+    outputDetail?: import('./output.js').OutputDetail;
+    copyFormat?: import('./output.js').CopyFormat;
+    openInEditor?: (location: import('./editor.js').SourceLocation) => void | Promise<void>;
+}

package/dist/output.d.ts

@@ -0,0 +1,8 @@
+import type { Annotation } from './context.js';
+export type OutputDetail = 'compact' | 'standard' | 'detailed';
+export type CopyFormat = 'markdown' | 'source' | 'classes';
+export interface OutputOptions {
+    detail?: OutputDetail;
+    format?: CopyFormat;
+}
+export declare function exportNotes(notes: Annotation[], options?: OutputOptions): string;

package/dist/react.d.ts

@@ -0,0 +1,4 @@
+import type { NoktiqOptions } from './options.js';
+export declare function Noktiq({ enabled, ...options }: NoktiqOptions & {
+    enabled?: boolean;
+}): null;

package/dist/react.js

@@ -0,0 +1,20 @@
+"use client";
+import {
+  mountNoktiq
+} from "./shared-chunk.js";
+
+// src/react.ts
+import { useEffect, useRef } from "react";
+function Noktiq({ enabled = false, ...options }) {
+  const current = useRef(options);
+  current.current = options;
+  useEffect(() => enabled ? mountNoktiq({ ...options, portalContainer: () => {
+    const target = current.current.portalContainer;
+    return typeof target === "function" ? target() : target ?? null;
+  }, openInEditor: options.openInEditor ? (location) => current.current.openInEditor?.(location) : void 0 }) : void 0, [enabled, options.useHashLocation, options.enableKeyboardShortcuts, options.outputDetail, options.copyFormat, !!options.openInEditor]);
+  return null;
+}
+export {
+  Noktiq
+};
+//# sourceMappingURL=react.js.map

package/dist/react.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/react.ts"],
+  "sourcesContent": ["'use client';\nimport { useEffect, useRef } from 'react';\nimport { mountNoktiq } from './index.js';\nimport type { NoktiqOptions } from './options.js';\n\nexport function Noktiq({ enabled = false, ...options }: NoktiqOptions & { enabled?: boolean }) {\n  const current = useRef(options); current.current = options;\n  useEffect(() => enabled ? mountNoktiq({ ...options, portalContainer: () => {\n    const target = current.current.portalContainer;\n    return typeof target === 'function' ? target() : target ?? null;\n  }, openInEditor: options.openInEditor ? location => current.current.openInEditor?.(location) : undefined }) : undefined, [enabled, options.useHashLocation, options.enableKeyboardShortcuts, options.outputDetail, options.copyFormat, !!options.openInEditor]);\n  return null;\n}\n"],
+  "mappings": ";;;;;;AACA,SAAS,WAAW,cAAc;AAI3B,SAAS,OAAO,EAAE,UAAU,OAAO,GAAG,QAAQ,GAA0C;AAC7F,QAAM,UAAU,OAAO,OAAO;AAAG,UAAQ,UAAU;AACnD,YAAU,MAAM,UAAU,YAAY,EAAE,GAAG,SAAS,iBAAiB,MAAM;AACzE,UAAM,SAAS,QAAQ,QAAQ;AAC/B,WAAO,OAAO,WAAW,aAAa,OAAO,IAAI,UAAU;AAAA,EAC7D,GAAG,cAAc,QAAQ,eAAe,cAAY,QAAQ,QAAQ,eAAe,QAAQ,IAAI,OAAU,CAAC,IAAI,QAAW,CAAC,SAAS,QAAQ,iBAAiB,QAAQ,yBAAyB,QAAQ,cAAc,QAAQ,YAAY,CAAC,CAAC,QAAQ,YAAY,CAAC;AAC9P,SAAO;AACT;",
+  "names": []
+}

package/dist/selection.d.ts

@@ -0,0 +1,21 @@
+export declare function selectedText(document: Document): {
+    element: Element;
+    range: Range;
+    selectedText: string;
+    textRange: {
+        text?: string | undefined;
+        start: number;
+        end: number;
+    };
+} | undefined;
+export declare function textRangeFor(element: Element, offsets: {
+    start: number;
+    end: number;
+    text?: string;
+}, text: string): Range | undefined;
+export declare function elementsInArea(roots: Array<Document | ShadowRoot>, area: {
+    left: number;
+    top: number;
+    right: number;
+    bottom: number;
+}, host: Element): Element[];