ofs-object 0.1.4 → 0.1.5

package/dist/index.d.ts

@@ -364,6 +364,9 @@ export declare abstract class BaseGLAdapter implements IMapAdapter {
      */
     protected listen(event: string, handler: (e: any) => void): void;
     protected setupMapEventListeners(): void;
+    /** undefined = not worked out yet for the current style */
+    private styleFontCache;
+    getStyleFont(): string[] | null;
     getRawMap<T = any>(): T;
     /**
      * Take every source and layer this adapter added off a map it does not own, so the host is
@@ -406,27 +409,18 @@ export declare function bulgePoints(p1: Position, p2: Position, bulge: number, m
 export declare function bulgeThroughPoint(start: Coordinate, through: Coordinate, end: Coordinate, projection?: PlanarProjection): number;
 
 export declare class CADOperations {
-    /**
-     * Split a Polygon using a LineString.
-     * Creates a hairline buffer "blade" to perform difference, then flattens into pieces.
-     */
-    /**
-     * Extend a ray from startPt through endPt until safely outside the polygon's bounding box.
-     * Uses Cartesian unit vector in coordinate space to avoid spherical bearing drift.
-     */
-    private static extendRayOutside;
-    /**
-     * Prepare cutting line: ensures head and tail pierce outside the polygon if they stop inside.
-     * The cutting line is ALWAYS kept as a single continuous LineString (never decomposed into separate rays).
-     */
-    private static prepareCuttingLine;
     /**
      * Split a single Polygon by a single LineString using planar graph noded polygonization.
      */
     private static splitSinglePolygonByLine;
     /**
-     * Split a Polygon using a LineString.
-     * Ensures cutting lines pierce completely through boundaries without leaving unsevered edges or dead-end slits.
+     * Split a Polygon using a LineString. Returns null when the line does not cut it.
+     *
+     * The line has to cross the polygon from one side to the other, as in QGIS. An end that stops
+     * inside used to be carried on in a straight line - 1.5 times the polygon's diagonal, worked out in
+     * degrees - so a line that only poked in still cut, along a path nobody drew. Now it does not cut.
+     * An end on the boundary is fine, snapped or computed onto an edge: that is a crossing, and the
+     * noding below finds it without any extension.
      */
     static splitPolygonByLine(polygon: Feature<Polygon | MultiPolygon>, cuttingLine: Feature<LineString>): Feature<Polygon>[] | null;
     /**
@@ -1248,8 +1242,11 @@ export declare interface DrawGuideSettings {
     angles: boolean;
     /** How far off the segment the dimension line sits, in screen pixels */
     dimensionOffsetPixels: number;
-    /** Glyph names for the labels; the map style must provide them */
-    font: string[];
+    /**
+     * Glyph font stack for the labels; the map style's glyph server must have it. null (the default)
+     * uses the font the basemap's own labels use - see `IMapAdapter.getStyleFont`.
+     */
+    font: string[] | null;
 }
 
 /** Minimal 2D context surface used by the drawing helpers (so they can be tested without a DOM) */
@@ -1780,6 +1777,12 @@ export declare interface IMapAdapter {
     setDoubleClickZoom(enabled: boolean): void;
     /** Raw map engine access */
     getRawMap<T = any>(): T;
+    /**
+     * The glyph font stack the basemap's own labels use, so text added on top is drawn in a font its
+     * glyph server has. Null when the style names none. Optional: an adapter without it gets the
+     * engine default font.
+     */
+    getStyleFont?(): string[] | null;
     /** Cleanup */
     destroy(): void;
 }
@@ -2975,6 +2978,8 @@ export declare class OFSDataSource extends TypedEventEmitter<OFSDataSourceEvents
      * Create buffer around feature and add as new feature or replace
      */
     buffer(layerId: string, featureId: string | number, distance: number, units?: turf.Units, targetLayerId?: string): Feature<Polygon | MultiPolygon>;
+    /** The polygon layer that buffers of a line or point layer go into, created on first use */
+    private bufferLayerFor;
     /**
      * Calculate polygon area in square meters or hectares
      */
@@ -3508,7 +3513,6 @@ export declare class OFSDrawTools extends TypedEventEmitter<DrawEvents> {
         result: Feature<Geometry>;
     };
     private replaceLineWithPieces;
-    private safeRawMap;
     /** Segments of all visible features except `exclude` (used as cutting edges / boundaries) */
     private boundarySegments;
     /**
@@ -3590,6 +3594,8 @@ export declare class OFSDrawTools extends TypedEventEmitter<DrawEvents> {
      * in any mode), then the active drawing mode, and nothing at all when no tool is running.
      */
     private applyCursor;
+    /** The font the guide labels are drawn in: the one set, else the basemap's, else the engine default */
+    private guideFont;
     /** Current guide settings (a copy: change them through `setGuides`) */
     getGuides(): DrawGuideSettings;
     /**
@@ -4235,6 +4241,13 @@ export declare class OFSThematicEngine extends TypedEventEmitter<ThematicEvents>
     exportThemes(): ThematicDefinition[];
     /** Restore themes saved with exportThemes */
     importThemes(themes: ThematicDefinition[]): void;
+    /**
+     * Settings that belong to the layer rather than to the way it is classified, carried over when the
+     * renderer changes. In QGIS labels are a tab of their own and switching Single / Categorized /
+     * Graduated never touches them; here switching used to drop them, along with the selection
+     * highlight colour.
+     */
+    private carriedLayerSettings;
     private carriedSymbol;
     /**
      * Create a simple uniform color theme
@@ -4257,6 +4270,11 @@ export declare class OFSThematicEngine extends TypedEventEmitter<ThematicEvents>
      * symbol overrides are kept where the same category value / class position still exists.
      */
     reclassify(layer: OFSLayerData): ThematicDefinition | undefined;
+    /**
+     * The first colour of `palette` that is clearly different from every colour in `inUse`; when the
+     * palette has none left, the colour furthest from them all.
+     */
+    private unusedClassColor;
     private createCategoricalThemeData;
     /**
      * Merge changes into the base symbol (creates a simple theme when the layer has none)