@style-capture/core 0.0.1

package/LICENSE.md

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2026 Matthew Blode
+
+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,100 @@
+<h3 align="center">@style-capture/core</h3>
+<p align="center">Tailwind mapping, capture contracts, and Claude-ready serializers extracted from Style Capture.</p>
+
+## Highlights
+
+- Shared capture types and message contracts for Style Capture tooling
+- Tailwind utility mapping with confidence, unsupported-property, and review metadata
+- Compact Claude-friendly HTML and CSS serializers for captured DOM snapshots
+
+## Quick Start
+
+```bash
+npm install @style-capture/core
+```
+
+```tsx
+import {
+  createDefaultSettings,
+  formatCaptureForClaudeMarkdown,
+  mapCaptureToTailwind,
+  type CaptureResult,
+} from "@style-capture/core";
+
+const capture: CaptureResult = {
+  elements: {
+    "node-0": {
+      attributes: {},
+      boundingBox: {
+        bottom: 48,
+        height: 48,
+        left: 0,
+        right: 160,
+        top: 0,
+        width: 160,
+        x: 0,
+        y: 0,
+      },
+      children: [],
+      classList: [],
+      id: "node-0",
+      parentId: null,
+      pseudo: {},
+      selector: ".hero-card",
+      styles: {
+        "background-color": "rgb(255, 255, 255)",
+        display: "flex",
+        "justify-content": "space-between",
+        padding: "16px",
+      },
+      tagName: "div",
+    },
+  },
+  metadata: {
+    url: "https://example.com/card",
+  },
+  order: ["node-0"],
+  rootElementId: "node-0",
+  rootOuterHtml: '<div class="hero-card">Hello</div>',
+  settings: createDefaultSettings(),
+  summary: {
+    elementCount: 1,
+    pseudoElementCount: 0,
+  },
+  version: 1,
+};
+
+const mapping = mapCaptureToTailwind(capture);
+const prompt = formatCaptureForClaudeMarkdown(capture, mapping);
+
+console.log(mapping.elements["node-0"]?.suggestedClassName);
+console.log(prompt);
+```
+
+## Usage
+
+```tsx
+import {
+  buildClaudeCapturePrompt,
+  createDefaultSettings,
+  mapCaptureToTailwind,
+} from "@style-capture/core";
+
+const settings = createDefaultSettings();
+const mapping = mapCaptureToTailwind(capture);
+const prompt = buildClaudeCapturePrompt(capture, mapping);
+```
+
+Public exports:
+
+- `createDefaultSettings`
+- `mapCaptureToTailwind`
+- `buildClaudeCapturePrompt`
+- `formatCaptureForClaudeMarkdown`
+- Capture result, mapping, and message types from the package root
+
+Requires a runtime with standard DOM globals if you want annotated HTML output. When `DOMParser` is unavailable, the serializer falls back to compact raw HTML and selector-based CSS output.
+
+## License
+
+[MIT](LICENSE.md)

package/dist/claude-export.d.ts

@@ -0,0 +1,25 @@
+import type { TailwindMappingResult } from "./tailwind-mapper.ts";
+import type { CaptureResult } from "./types.ts";
+interface ClaudePromptEntry {
+    key: string;
+    value: string;
+}
+interface ClaudePromptMetadata {
+    elementCount: number;
+    mode: CaptureResult["settings"]["captureMode"];
+    pseudoCount: number;
+    rootRef: string;
+    rootSelector: string;
+    url: string;
+}
+export interface ClaudeCapturePrompt {
+    cssCapture: string;
+    htmlCapture: string;
+    instruction: string;
+    metadata: ClaudePromptMetadata;
+    openQuestions: ClaudePromptEntry[];
+    tailwindHints: ClaudePromptEntry[];
+}
+export declare const buildClaudeCapturePrompt: (capture: CaptureResult, mapping: TailwindMappingResult | null) => ClaudeCapturePrompt;
+export declare const formatCaptureForClaudeMarkdown: (capture: CaptureResult, mapping: TailwindMappingResult | null) => string;
+export {};

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { buildClaudeCapturePrompt, type ClaudeCapturePrompt, formatCaptureForClaudeMarkdown, } from "./claude-export.ts";
+export type { CaptureCancelledMessage, CaptureCompletedMessage, CaptureFailedMessage, ExtensionMessage, } from "./messages.ts";
+export { createDefaultSettings, MESSAGE_TYPE_CAPTURE_CANCELLED, MESSAGE_TYPE_CAPTURE_COMPLETED, MESSAGE_TYPE_CAPTURE_FAILED, } from "./messages.ts";
+export { mapCaptureToTailwind, type TailwindElementMapping, type TailwindMappingResult, type TailwindMappingSummary, type TailwindReviewItem, } from "./tailwind-mapper.ts";
+export type { BoundingBox, CaptureMetadata, CaptureMode, CaptureResult, CaptureSettings, CaptureSummary, ElementSnapshot, PseudoElementKind, PseudoElementSnapshot, } from "./types.ts";