@directededges/specs-from-figma 0.11.0

package/LICENSE

@@ -0,0 +1,96 @@
+# PolyForm Internal Use License 1.0.0
+
+<https://polyformproject.org/licenses/internal-use/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 make changes or
+new works based on the software according to [Changes and New
+Works License](#changes-and-new-works-license), and you may
+not distribute the software.
+
+## 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.
+
+## Fair Use
+
+You may have "fair use" rights for the software under the
+law. These terms do not limit them.
+
+## Internal Business Use
+
+Use of the software for the internal business operations of
+you and your company is use for a permitted purpose.
+
+## 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.
+
+**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
+organizations that have control over, are under the control of,
+or are under common control with that organization.  **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

@@ -0,0 +1,140 @@
+# @directededges/anova-transformer
+
+Core data transformation model for Anova design specification tools. This package extracts the Model and Runtime layers from anova-plugin, enabling independent development and reusability across CLI, MCP, and plugin environments.
+
+## Overview
+
+`@directededges/anova-transformer` provides:
+- **Component Processing**: Transform Figma design components into structured specifications
+- **Runtime Abstractions**: Platform-agnostic data loading and node resolution
+- **Cross-Platform Support**: Works in both Node.js (CLI/MCP) and Browser (Figma Plugin) environments
+
+## Installation
+
+### From GitHub Packages
+
+```bash
+# Configure npm to use GitHub Packages for @directededges scope
+npm config set @directededges:registry https://npm.pkg.github.com
+
+# Install the package
+npm install @directededges/anova-transformer
+```
+
+**Authentication Required**: You must configure a GitHub Personal Access Token with `read:packages` scope:
+
+```bash
+# Add to ~/.npmrc
+//npm.pkg.github.com/:_authToken=YOUR_GITHUB_TOKEN
+```
+
+## Usage
+
+### Plugin environment
+
+```typescript
+import { Component } from '@directededges/anova-transformer';
+
+const component = await Component.fromPlugin(figmaNode, config);
+console.log(component.yaml());
+```
+
+An optional `coordinator` and `author` can be passed as a third argument.
+
+### CLI / REST API environment
+
+```typescript
+import { Component } from '@directededges/anova-transformer';
+import type { StylesMap, VariablesMap, CollectionsMap } from '@directededges/anova-transformer';
+
+const component = await Component.fromRestApi(
+  libraryJson,   // raw REST API JSON
+  componentId,   // component name or ID
+  config,
+  { styles, variables, collections }
+);
+console.log(component.yaml());
+```
+
+Both factory methods return a fully-processed `Component`. Call `.yaml()` for a YAML string or `.json()` for a plain object.
+
+## Public API
+
+The public surface is intentionally minimal. All internal runtime and processing code is bundled and not re-exported.
+
+### `Component`
+
+Main transformation class. Use the static factory methods — do not call `new Component()` directly.
+
+| Method | Description |
+|--------|-------------|
+| `Component.fromPlugin(node, config, options?)` | Process a Figma Plugin API node |
+| `Component.fromRestApi(json, id, config, options)` | Process a component from REST API JSON |
+| `component.yaml()` | Returns a YAML string of the component specification |
+| `component.json()` | Returns a plain JavaScript object |
+
+### Foundations map types
+
+Used as the `options` payload for `fromRestApi`:
+
+- `StylesMap` — map of style IDs to style data
+- `VariablesMap` — map of variable IDs to variable data
+- `CollectionsMap` — map of collection IDs to collection data
+
+Output schema types (e.g. `Component` from `@directededges/anova`) are provided by the `anova` package.
+
+## Development
+
+### Building
+
+```bash
+# Install dependencies
+npm install
+
+# Build the package
+npm run build
+
+# Build types only
+npm run build:types
+
+# Build JavaScript only
+npm run build:js
+```
+
+### Testing
+
+```bash
+# Run tests
+npm test
+
+# Run tests in watch mode
+npm run test:watch
+```
+
+### Publishing
+
+```bash
+# Publish to GitHub Packages (runs build + test automatically)
+npm publish
+```
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for contribution guidelines.
+
+## Architecture
+
+See [ARCHITECTURE.md](ARCHITECTURE.md) for a system diagram, component hierarchy, runtime model, and design principles.
+
+## Version & Compatibility
+
+- **Version**: 0.6.0 (Pre-1.0 — breaking changes may occur in minor versions)
+- **Node.js**: 20+ required
+- **Target**: ES2020
+- **Module Format**: ESM only
+
+## License
+
+[PolyForm Internal Use License 1.0.0](LICENSE)
+
+## Repository
+
+https://github.com/directededges/anova-transformer

package/dist/index.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @directededges/specs-from-figma
+ *
+ * Core data transformation model for Anova design specification tools.
+ *
+ * PUBLIC API
+ * - Components class — sole entry point for REST/CLI runtime
+ * - ComponentsData type — return type for fromRestApi()
+ * - StylesMap, VariablesMap, CollectionsMap types — foundations data contracts
+ * - ProgressEvent type — callback event shape for fromRestApi()
+ * - RestLicenseInput type — license parameter shape for fromRestApi()
+ *
+ * Deep imports are restricted via package.json exports field.
+ * Output type definitions (Component schema) are provided by @directededges/specs-schema package.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Components — entry point for REST/CLI runtime
+ *
+ * Factory method:
+ * - Components.fromRestApi(ids, json, config, foundations, onProgress, license?)
+ *
+ * Returns `ComponentsData[]`. Callers discriminate results inline:
+ * - `'component' in result` → success
+ * - `'error' in result` → error
+ */
+export { Components } from './Components/Components.js';
+export type { ComponentsData } from './Components/Components.js';
+/**
+ * Map types for external foundations data
+ *
+ * These types define the contract for passing styles, variables, and collections
+ * data from CLI/external environments to Components.fromRestApi().
+ */
+export type { StylesMap, VariablesMap, CollectionsMap } from './Runtime/Foundations/FigmaRESTMaps.js';
+/** Progress event shape received by the `onProgress` callback in `fromRestApi()` */
+export type { ProgressEvent } from './Components/Components.js';
+/** License input shape for `fromRestApi()` — callers pass `{ key: string }` */
+export type { RestLicenseInput } from './License/types.js';