pattapatta 0.2.0 → 0.3.0

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## 0.3.0
+
+### Minor Changes
+
+- 1c203c2: Add contour skeletons and fields: medialAxis (with pruning), chordalAxis, straightSkeleton, centerLine, distanceField, contrastField, distanceTree, and isoline helpers.
+
+## 0.2.2
+
+### Patch Changes
+
+- Add docs site favicon, OG/Twitter preview image, and social meta tags.
+
+## 0.2.1
+
+### Patch Changes
+
+- d7fa7dc: Point the npm package homepage at the docs site.
+
 ## 0.2.0
 
 ### Minor Changes

package/README.md

@@ -58,41 +58,6 @@ pnpm docs:examples   # regenerate SVG figures
 | `pattapatta/voronoi` | Voronoi cells |
 | … | See `website/` API pages |
 
-## Releasing
-
-This repo uses [Changesets](https://github.com/changesets/changesets). Only the root `pattapatta` package is published; `website` is ignored. CI publishes via [npm trusted publishing (OIDC)](https://docs.npmjs.com/trusted-publishers) — no long-lived `NPM_TOKEN` (2FA-bypass tokens are being deprecated for direct publish; see [npm changelog](https://github.blog/changelog/2026-07-08-npm-install-time-security-and-gat-bypass2fa-deprecation/)).
-
-### One-time npm setup
-
-1. If the package is not on npm yet, publish once locally (trusted publishers can only be configured on an existing package):
-   ```bash
-   pnpm build && npm publish --access public --otp=<code>
-   ```
-2. On [npmjs.com](https://www.npmjs.com/) → **pattapatta** → **Settings** → **Trusted Publisher** → **GitHub Actions**:
-   - **Organization or user:** `MadOrkestra`
-   - **Repository:** `pattapatta`
-   - **Workflow filename:** `release.yml` (filename only)
-   - **Allowed actions:** include **`npm publish`** (not stage-only — Changesets publishes directly)
-3. Optionally under **Publishing access**, require 2FA and disallow tokens once OIDC works.
-4. Remove any repo `NPM_TOKEN` secret if it was only used for publish.
-
-### Routine releases
-
-1. In a PR that changes the library, run `pnpm changeset`, commit the file under `.changeset/`, and merge to `main`.
-2. The **Release** workflow opens or updates a **Version Packages** PR (bumps version, updates `CHANGELOG.md`).
-3. Merging that PR publishes to npm (OIDC + provenance) and creates a GitHub Release.
-
-Current package version is in `package.json` (e.g. `0.2.0`). If publish failed after a version bump, fix the trusted-publisher config (workflow name must be exactly `release.yml`) and re-run **Release** — Changesets will publish any version not yet on npm.
-
-Local checks used by CI:
-
-```bash
-pnpm install --frozen-lockfile
-pnpm test
-pnpm typecheck
-pnpm build
-```
-
 ## License
 
 MIT — clean-room implementation (not a GPL line-port of PGS). See `docs/decisions/`.

package/dist/contour/index.d.ts

@@ -1,6 +1,80 @@
+import { V as Vec2 } from '../vec2-CWyXN1Wj.js';
 import { P as Path } from '../path-0RjhYjJs.js';
 import { G as Group } from '../group-BNjVVYSQ.js';
-import '../vec2-CWyXN1Wj.js';
+import { S as Segment } from '../segment-BKuIFMKD.js';
+
+/**
+ * Chordal Axis Transform: join midpoints of interior chords / centroids of
+ * terminal & junction triangles from a densified Delaunay triangulation.
+ */
+declare function chordalAxis(shape: Path): Group;
+
+/**
+ * Approximate medial axis via Voronoi edges of densified boundary samples.
+ * Returns pruned dissolved polylines.
+ *
+ * Thresholds in [0,1]: 0 = no pruning, 1 = maximum pruning.
+ */
+declare function medialAxis(shape: Path, axialThreshold?: number, distanceThreshold?: number, areaThreshold?: number): Group;
+/**
+ * Longest center line through the medial axis, smoothed.
+ */
+declare function centerLine(shape: Path, straightnessWeighting?: number, smoothing?: number): Path;
+
+type StraightSkeletonParts = {
+    faces: Group;
+    branches: Group;
+    bones: Group;
+};
+/**
+ * Straight skeleton approximation via successive inward miter offsets.
+ *
+ * Returns a flat GROUP: closed face paths, then branch polylines, then bone
+ * polylines. Prefer {@link straightSkeletonParts} for structured access.
+ *
+ * Exact kinetic straight skeletons are deferred; this offset-trace method is
+ * robust, terminates, and yields plotter-useful bones/branches/faces.
+ */
+declare function straightSkeleton(shape: Path): Group;
+declare function straightSkeletonParts(shape: Path): StraightSkeletonParts;
+
+/**
+ * Interior isolines of field `d_boundary − d_pole`.
+ * Default pole is the maximum inscribed circle center.
+ */
+declare function distanceField(shape: Path, spacing: number, pole?: Vec2): Group;
+/**
+ * Contrast field isolines: `|d_boundary − d_reference|`.
+ */
+declare function contrastField(shape: Path, intervals: number, reference: Vec2): Group;
+/**
+ * Isolines from a high point inside a shape (topographic style).
+ * Height ≈ distance from highPoint (negated outside).
+ */
+declare function isolines(shape: Path, highPoint: Vec2, intervalSpacing: number): Group;
+
+/**
+ * BFS shortest-path tree on a mesh (GROUP of polygonal faces).
+ * `flatten`: unique tree edges as polylines; else one path per target vertex.
+ */
+declare function distanceTree(mesh: Group, source: Vec2, flatten: boolean): Group;
+
+type ScalarField = (x: number, y: number) => number;
+/**
+ * Extract isolines of `fn` over an axis-aligned box via marching squares.
+ * Contours are generated at multiples of `contourInterval` between
+ * `isolineMin`/`isolineMax` (auto-scanned when omitted).
+ */
+declare function isolinesFromFunction(bounds: [number, number, number, number], sampleSpacing: number, contourInterval: number, fn: ScalarField, isolineMin?: number, isolineMax?: number): Group;
+/** Isolines where `fn(x,y) === 0`. */
+declare function isolineZeroFromFunction(bounds: [number, number, number, number], sampleSpacing: number, fn: ScalarField): Group;
+/** Point-set isolines: each point carries z in `.z` via a parallel array. */
+declare function isolinesFromPoints(points: Vec2[], values: number[], intervals: number, _smoothing?: number): Group;
+
+/**
+ * Chain connected segments into maximal-length open polylines.
+ */
+declare function dissolveSegments(segments: Segment[]): Group;
 
 /**
  * Offset the path outward by `distance` (positive buffer).
@@ -15,6 +89,19 @@ declare function offsetCurvesInward(p: Path, distance: number): Group;
 declare const contour: {
     offsetCurvesOutward: typeof offsetCurvesOutward;
     offsetCurvesInward: typeof offsetCurvesInward;
+    medialAxis: typeof medialAxis;
+    chordalAxis: typeof chordalAxis;
+    straightSkeleton: typeof straightSkeleton;
+    straightSkeletonParts: typeof straightSkeletonParts;
+    centerLine: typeof centerLine;
+    distanceField: typeof distanceField;
+    contrastField: typeof contrastField;
+    distanceTree: typeof distanceTree;
+    isolines: typeof isolines;
+    isolinesFromFunction: typeof isolinesFromFunction;
+    isolineZeroFromFunction: typeof isolineZeroFromFunction;
+    isolinesFromPoints: typeof isolinesFromPoints;
+    dissolveSegments: typeof dissolveSegments;
 };
 
-export { contour, offsetCurvesInward, offsetCurvesOutward };
+export { type ScalarField, type StraightSkeletonParts, Vec2, centerLine, chordalAxis, contour, contrastField, dissolveSegments, distanceField, distanceTree, isolineZeroFromFunction, isolines, isolinesFromFunction, isolinesFromPoints, medialAxis, offsetCurvesInward, offsetCurvesOutward, straightSkeleton, straightSkeletonParts };