ofs-object 0.1.4 → 0.1.6

package/README.md

@@ -302,6 +302,10 @@ initMap();
 </script>
 ```
 
+> `mount()` ตกแต่งหน้าตาของ console อย่างเดียว **ไม่จัดตำแหน่งให้** — วาง element `console-mount` ตาม layout
+> ของหน้าเอง หรือใส่ class `ofs-console-floating` ให้ลอยชิดล่างของ parent ที่ `position: relative`
+> (ก่อน 0.1.6 ไลบรารีบังคับ `position: absolute; left: 80px; right: 420px` ซึ่งเป็นขนาดของ playground)
+
 ---
 
 ### React

package/dist/index.d.ts

@@ -364,6 +364,19 @@ 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;
+    /**
+     * Font for text when the basemap names none - a satellite or OSM raster basemap has no labels to
+     * read one from. It must exist on the style's glyph server. null leaves the engine default
+     * ("Open Sans Regular"), which many glyph servers do not have.
+     */
+    private fallbackFont;
+    /** Set before `init()` / `attach()` to apply everywhere; set later, labels already drawn are redone */
+    setFallbackFont(font: string[] | null): void;
+    /** The basemap's own label font; else the fallback font; else null */
+    getStyleFont(): string[] | null;
+    private readStyleFont;
     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 +419,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;
     /**
@@ -599,6 +603,8 @@ export declare interface CategoricalFieldStats {
 export declare interface CategoricalThemeOptions {
     reverse?: boolean;
     baseSymbol?: SymbolStyleInput;
+    /** Keep categories that no feature has any more when reclassifying (see ThematicDefinition) */
+    keepEmptyCategories?: boolean;
 }
 
 /**
@@ -1248,8 +1254,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 +1789,14 @@ 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; when the style names none (a raster basemap), the fallback font; else null.
+     * Optional: an adapter without it gets the engine default font.
+     */
+    getStyleFont?(): string[] | null;
+    /** Font to use when the basemap names none; it must exist on the style's glyph server */
+    setFallbackFont?(font: string[] | null): void;
     /** Cleanup */
     destroy(): void;
 }
@@ -2900,7 +2917,7 @@ export declare class OFSDataSource extends TypedEventEmitter<OFSDataSourceEvents
     setLayerGroupVisibility(groupId: string, visible: boolean): void;
     /** Move a layer into a group (null = top level) */
     moveLayerToGroup(layerId: string, groupId: string | null): void;
-    /** True when the layer is inside the group, directly or through sub-groups */
+    /** True when the layer (of either kind) is inside the group, directly or through sub-groups */
     isLayerInGroup(layerId: string, groupId: string): boolean;
     /** A layer of either kind is drawn when it and all of its parent groups are visible */
     isLayerRendered(layerId: string): boolean;
@@ -2975,6 +2992,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 +3527,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 +3608,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;
     /**
@@ -3948,8 +3968,14 @@ export declare class OFSLegendTools extends TypedEventEmitter<LegendEvents> {
      * Notify subscribers of a state change
      */
     notifyUpdate(): void;
+    /** A legend row of either kind: a feature layer or a tile layer */
+    private findRow;
     toggleLayerVisibility(layerId: string): void;
     setLayerOpacity(layerId: string, opacity: number): void;
+    /**
+     * Make a layer the one new features go into. A tile layer cannot hold features, so choosing one -
+     * clicking a basemap row in the legend, say - is ignored rather than an error.
+     */
     setActiveLayer(layerId: string): void;
     toggleLayerPinned(layerId: string): void;
     /** Move a layer one place up among its siblings in the legend tree (above a sibling group as a whole) */
@@ -4105,6 +4131,12 @@ export declare interface OFSObjectConfig {
      * with `consoleWidget.submit(text)` and render the `console:line` / `console:prompt` events.
      */
     console?: IOFSConsole;
+    /**
+     * Font for labels and drawing guides when the basemap has no labels to take one from - satellite
+     * imagery, OSM raster tiles. It must exist on the style's glyph server, e.g. `['Noto Sans Regular']`
+     * for OpenFreeMap. A basemap that has labels still wins: its font is known to exist.
+     */
+    fallbackFont?: string[];
 }
 
 export declare interface OFSProjectFile {
@@ -4172,6 +4204,8 @@ export declare class OFSSymbologyPanel {
     private options;
     /** Renderer settings chosen in the form but not yet applied with "Classify" */
     private draft;
+    /** Last real color of each color control, so switching "no color" off restores it */
+    private colorMemory;
     constructor(legendTools: OFSLegendTools, options?: SymbologyPanelOptions);
     mount(target: HTMLElement | string): void;
     unmount(): void;
@@ -4183,6 +4217,9 @@ export declare class OFSSymbologyPanel {
     private render;
     /** Labels tab: field or expression, size, colour, halo and zoom range */
     private renderLabels;
+    private colorKey;
+    /** Color picker plus a "no color" (transparent) toggle */
+    private colorControl;
     private renderClassification;
     private renderClassTable;
     private dashSelect;
@@ -4190,6 +4227,8 @@ export declare class OFSSymbologyPanel {
     private classify;
     private handleClick;
     private handleChange;
+    /** Apply a form control's value (or an override, e.g. "no color") to the layer */
+    private apply;
 }
 
 export declare class OFSThematicEngine extends TypedEventEmitter<ThematicEvents> {
@@ -4235,6 +4274,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 +4303,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)
@@ -5424,6 +5475,12 @@ export declare interface ThematicDefinition {
     enableSelectionHighlight?: boolean;
     /** Labels drawn for this layer */
     label?: LabelSettings;
+    /**
+     * Categorised: keep categories no feature has when the theme is reclassified, instead of dropping
+     * them. For a fixed colour table - crop types, land-use codes - that should read the same whether or
+     * not this season's data has every value yet.
+     */
+    keepEmptyCategories?: boolean;
 }
 
 export declare interface ThematicEngineOptions {