ofs-object 0.1.5 → 0.1.7

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

@@ -366,7 +366,17 @@ export declare abstract class BaseGLAdapter implements IMapAdapter {
     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
@@ -593,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;
 }
 
 /**
@@ -1779,10 +1791,12 @@ export declare interface IMapAdapter {
     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.
+     * 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;
 }
@@ -2903,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;
@@ -3633,6 +3647,11 @@ export declare class OFSDrawTools extends TypedEventEmitter<DrawEvents> {
      * Render real-time preview of drag box marquee selection
      */
     private updateDragBoxPreview;
+    /**
+     * Features under the pointer that select / modify may pick - only the target layer's when
+     * `setMode('select', layerId)` named one (the same rule as box / polygon selection)
+     */
+    private pickable;
     /**
      * Query all features within or intersecting the given geometry across visible layers
      */
@@ -3954,8 +3973,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) */
@@ -4111,6 +4136,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 {
@@ -4178,6 +4209,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;
@@ -4189,6 +4222,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;
@@ -4196,6 +4232,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> {
@@ -5442,6 +5480,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 {