Changelog of @hackage/wumpus-basic 0.22.0

0.20.0 to 0.21.0:

• The code from the @Kernel.Base.UserState@ module has been moved to the module @Kernel.Drawing.Basis@.

• Moved @Image@ and @Query@ from @Objects.Basis@ to new module @Objects.Image@. Moved @Chain@, @CtxPicture@ and @TraceDrawing@ into the new @Drawing@ folder.

• Added @Wumpus.Basic.Kernel.Drawing.LocDrawing@ module.

• Rationalized the combinators exported by the drawing objects @Image@, @LocImage@, @LocThetaImage@ and @Connector@.

0.18.0 to 0.20.0 (no release numbered v0.19.0):

• Added text advance-vector calculations to @QueryDC@ - previously they were in Wumpus-Drawing.

• Changed argument order of @run@ functions to follow the usual style - monadic action first and then dependent parameters (initial state, reader environment etc.).

• Changed representation of Chains to a monadic type with an explicit operation for next position.

• Removed @PrimW@ type - pairs are now used instead.

• Removed transformer version of @TraceDrawing@. All operations in TraceDrawing are now specialized to work only on the @TraceDrawing@ type. Added @UserState@ to TraceDrawing and other drawing monads to compensate for the loss of expressiveness.

• Changed the internals of @AdvObject@ and @PosObject@ so they are more idiomatic - both are now essentially reader-writer monads. Added PosObject functions for text primitives (moved from Wumpus-Drawing).

• Changed the @obliterate@ method of the @Decorate@ class.

• Removed the Semigroup (OPlus) and Bifunctor classes. They are no longer so pertinent now that Image, LocImage etc. are newtypes rather than /ContextFuns/.

• Changed internals of LocImage, LocThetaImage and Connector types so the internal points always have Double (PostScript point) as the unit. This fixes a bug where otherwise changing the font size for drawings with Em or En units would break the layout.

• Added @ORIGIN@ to the @RectAddress@ enumeration. I had overlooked that @BLC /= ORIGIN@.

• Added underline-position and underline-thickness to the font metrics read by the font loader.

0.17.0 to 0.18.0:

• Major change - removed @ContextFun@ from @Kernel.Base@. Now the drawing objects (Image, LocImage, Connector...) are newtype wrapped Reader-Writer monads rather than aliases to one of the arity family of ContextFuns. Being newtypes gives a lot better opportunities for overloading.

• Changed Displacement API - it is smaller, and the function naming is more uniform.

• Changed @DrawingPimitives@ to use @DrawStyle@.

• Moved vertices generating functions from @Geometry.Path@ to @Geometry.Vertices@.

0.16.0 to 0.17.0:

• Changed representation of ContextFuns - context funs are no longer an arity family of newtypes. The new representation is simpler, but some of the opportunities for overloading have been lost.

• Substantial round of renaming for the @DrawingContext@ types an query and update functions.

• Re-worked the font metrics and font loader modules. The new names should be more systematic. Removed the need for the GhostScript font modules to match PostScript names to GhostScript font files.

• Superceded the PointSupplyM class by adding snapping grid scaling to the DrawingContext.

• Removed @ScalingContext@ module.

• Made text colour a distinct property in the DrawingContext. Text is now drawn with the text colour rather than the stroke colour.

• Added FontLoadLog to the DrawingContext - this allows access to the errors recorded during font loading.

0.15.0 to 0.16.0:

• Moved the Geometry modules from Wumpus-Drawing into Wumpus-Basic.

• Re-worked the @CtxPicture@ API, although the current naming scheme is not satisfactory.

• Added extra Anchor classes.

• Added @PosImage@ object - this is a rectangle-framed object that can be drawn from any of its corners or its center.

• Added @CF3@, an arity three /ContextFunction/.

• Added @Displacement@ module. This defines the @PointDisplace@ type and provides a library of @PointDisplace@ functions. Note - some of the new functions have taken names previously used for anchor projection functions (@northwards@, @southwards@, etc.), anchor projections are now build with the function @projectAnchor@.

• Added the property @descender@ to the font metrics.

• Split drawing primitives from type in @Objects.Graphic@, drawing primitives are now in the module @Objects.DrawingPrimitives@.

0.14.0 to 0.15.0:

• Split previous @Wumpus-Basic@ package into two packages: @Wumpus-Basic@ and @Wumpus-Drawing@. This is a pratical move to separate the developed (although not yet polished) @Kernel@ and @FontLoader@ code from the prototypical @Drawing@ code.

• Renamed the @Drawing@ object to @CtxPicture@. Although @CtxPicture@ is a less pleasant name, it should be less confusing. A @CtxPicture@ is the essentially the @Picture@ type from Wumpus-Core with an implicit context - @ContextPicture@ is simply too long and @CtxPicture@ is almost jibberish but the previous unrelated name @Drawing@ was not helpful.

• @Kernel.Base.ScalingContext@ has been simplified. ScalingContexts are no longer manipulated via a custom Reader monad or transformer as the type signatures were too unwieldy.

• Added @TextMargin@ to the @DrawingContext@ - Wumpus-Drawing can now calculate more appealing bounding boxes for text.

0.13.0 to 0.14.0:

• Re-organised module hierarchy, Wumpus-Basic is now divided into two layers - Basic (Font loader, utils, kernel drawing) and Drawing - /constructed/ graphic objects like arrows, dots, etc.

• Re-designed the /ContextFunction/ function types. Context functions with different numbers of /static arguments/ are now separate newtypes. This has allowed a major cull of the combinators operating on context functions (@prepro@, @postpro@, @situ@, etc.) and now only a handful of special combinators are needed. As the newtypes are instances of Monad and Applicative the usual Applicative and Monad combinators are now more readily useful.

• Work on the font loader code to improve its robustness, and improved error signalling on load failure. Loading glyph metrics now returns both the metrics (possibly fallback metrics if parsing failed) and a log.

0.12.0 to 0.13.0:

• Major changes to @Basic.Graphic@ modules. @DrawingR@ is renamed @Drawing@ and is substantially re-worked. Graphic /functional/ types are now encapulated in the Drawing constructor @Drawing (ctx -> pt -> prim)@ rather than partially outside it @pt -> Drawing (ctx -> prim)@. @Drawing@ monad renamed @TraceDrawing@ and @DrawingT@ transformer renamed @TraceDrawingT@.

• Rudimentary font loading added, only AFM files are supported.

• @Basic.Shapes.Coordinate@ re-worked. The Coordinate type is now more like the Shapes types (excepting the intentional difference in drawing style).

• @Basic.Shapes.Plaintext@ removed.

• @Basic.Text.LRText@ completely redesigned.

0.11.0 to 0.12.0:

• Changes Base types in @Basic.Graphic@. The @Graphic@ and @Image@ types now produce (wrapped) @Primitives@, rather than Hughes lists of @Primitives@. This means they can now be transformed with the affine transformations. Removed the function @ati@, it is replaced by @at@.

• Added @Basic.Utils.Combinators@.

• Arrowheads and Connectors reworked - Arrowheads are now a functional type, Connectors use new Image combining operations from @Basic.Graphic.Base@.

• Path connectors re-worked and renamed.

• Dot hierarchy changed - @Basic.Dots@ becomes @Basic.Dots.AnchorDots@; @Basic.Dots.Primitive@ becomes @Basic.Dots.Marks@.

• @Basic.Shapes@ - internals reworked.

0.10.0 to 0.11.0:

• Reworked arrowheads and connectors - connectors are now configurable: there are functions to make connectors with a left arrowhead, right arrowhead, none or both.

• Reworked shapes - internally shapes now create a @Path@ rather than a @Graphic@ this means the path can be manipulated (e.g. round cornered rectangles, diamonds... can be constructed). @Coordinate@ is no longer a @Shape@ - it is now similar object but of a different type. Likewise, @FreeLabel@ has been replaced by @Plaintext@ which is not a @Shape@, but has some similar properties.

• @Basic.Paths.Base@ - @Path@ type changed, @PathEmpty@ constructor removed so empty paths cannot be created. This allows a better API for taking points on a path. It also means @Path@ is no longer an instance of Monoid. Type changes to various functions (e.g. @tipR@, @tipL@) reflecting that as paths cannot now be empty, functions on them can generally be total. @toPrimPathU@ removed as converting to a PrimPath as now always /safe/. @tracePoints@ renamed @traceLinePoints@, @tracePointsCurve@ renamed @traceCurvePoints@, @midpoint@ renamed @midway@.

• @Basic.Graphic@ - the types @ConnDrawingR@, @ConnGraphic@ etc. have had their names expanded to @ConnectorDrawingR@, @ConnectorGraphic@...

• @Basic.SafeFont@ - font names changed to use underscore separators rather than camelCase. Wumpus generally uses underscored names for /constants/.

• Removed @conn@ from @Basic.Graphic.Drawing@. Connectors should be used instead.

• The class @DrawingCtxM@ now has @Applicative@ as a superclass.

• @lineSpacing@ renamed @baselineSpacing@.

0.9.0 to 0.10.0:

• @Basic.Graphic.BaseClasses@ and @Basic.Graphic.BaseTypes@ merged into same module so they can depend on each other without orphans instances.

• @DrawingF@ renamed to @DrawingR@, the related type synonyms have also been changed, e.g. @LocDrawingF@ is now @LocDrawingR@.

• Method names in the @DrawingCtxM@ class changed - @askCtx@ is now @askDC@, @localCtx@ is now @localize@. Removed the functions @askDF@, @asksDF@, @pureDF@ that worked for @DrawingF@ (now @DrawingR@), @DrawingR@ now uses the Applicative's @pure@ and the @DrawingCtxM@ class for these functionalities.

• @Basic.Graphic.DrawingContext@ - renamed @primary_colour@ to @stroke_colour@ and @secondary_colour@ to @fill_colour@. The setter functions has been similarly renamed.

• Added the type synonym @DrawingContextF@ to @Basic.Graphic.DrawingContext@. Changed relevant function signatures to use it.

• Re-worked the Path modules - base types entirely different, connectors entirely different, monadic path construction largely the same.

• Initial work on round cornered paths.

• Removed the type class @TextAnchor@ from @Basic.Anchors@. This was a left-over from a previous implementation of Shapes and is not relevant to the current implementation.

• Added @DirectionContext@ to @Basic.Graphic@.

• @localLG@ removed it can be acheived with composition - @localize upd . loc_graphic_function@. @lgappend@ is also removed - it can be recreated applicatively.

0.8.0 to 0.9.0:

• Re-worked @Basic.Text.LRSymbol@ changed the type name and the types of the run functions. Added more symbols and a new demo @Symbols.hs@.

• @ScalingContext@ added to @Basic.Graphic@. Changed @monoTextWidth@ to take a character count, the old behaviour is recreated by the new function @monoTextLength@.

• @Basic.Graphic.Chain@ removed. It is now superseded by @Basic.Chains@.

• Added new property to @DrawingContext@ for line spacing scaling factor, and added a new drawing primitive @textlineMulti@ for multi-line, left justified labels.

• Synthezied attribute /getters/ such as @textDimensions@ moved from @Basic.Graphic.DrawingContext@ to the new module @Basic.Graphic.Query@. The type of all the functions has changed to DrawingF. @lowerxHeight@ is renamed @monoLowerxHeight@ emphasizing that the metrics pertain to monospaced Courier font.

• Added Shapes modules.

• TurtleMonad module - the TurtleDrawing type and run functions have been removed and the internals have been reworked. Turtle is now run solely as a /local effect/ within the Drawing monad.

0.7.0 to 0.8.0:

• Re-introduced LRText and LRSymbol - they now work with Wumpus-Core's kerning support.

• Changes to @Graphic.Basic.BaseTypes@ - @DrawingObject@ renamed to @DrawingF@. @HPrim@ wrapped as a newtype to support a Monoid instance. Removed @appendGraphic@ and @gcat@ as they can be achieved with @mappend@ and @mconcat@. @appendAt@ renamed to @lgappend@. @PointT@ remaned to @PointF@.

• Changes to @Graphic.Basic.Drawing@ - @drawAt@, @drawAtImg@, @drawConn@, @drawConnImg@ all removed. They are replaced by @draw@ and @drawi@ together with then new @at@ and @conn@ combinators.

• Changes to @Basic.Graphic.PrimGraphic@ - @localDrawingContext@ renamed to @localLG@ and moved to @Basic.Graphic.BaseTypes@.

• Updates to @Basic.SafeFonts@ to work with changes to @Wumpus.Core@.

0.6.0 to 0.7.0:

• Major rework of Graphic types, the old types (AGraphic, GraphicF etc.) and the old drawing monads have been removed. The new types are based on the AGraphic and related types but their implementation is different. The new types track the /graphics state/ within the type (the DrawingContext) plus how to draw themselves. For real drawings, graphics are collected with a Writer-like monad the @Basic.Graphic.Drawing@ monad which replaces the DrawingCtx and Trace monads. The Turtle monad remains and has been updated to work with the new drawing monads.

• LRText and LRSymbol modules temporarily removed as they contradict the new, optimized kerning functionality in @Wumpus.Core@.

0.5.0 to 0.6.0:

• Updates to work with wumpus-core-0.30.0.

• The code from @Basic.Graphic@ has been moved in to @Basic.Graphic.Primitive@ - this module is due a major overhaul. @Basic.Graphic@ is now an /import/ shim for @Basic.Graphic.Primitive@.

0.4.0 to 0.5.0:

• Re-worked the PictureLanguage module.

• SVGColours and X11Colours moved into @Wumpus.Basic.Colour@. Naming scheme for colours changed to use underscore between words rather than camelCase.

• Updates to work with wumpus-core-0.30.0.

0.3.0 to 0.4.0:

• Reworked the monads. Monads.DrawingMonad replaces Monads.Trace, Monads.DrawingCtx, Monads.ConsDrawing. The SnocDrawing monads have been removed as they were a design mistake.

• Removed MGraphicF type, added AGraphic.

• Initial work on arrow drawing and extended text drawing.

0.2.0 to 0.3.0 :

• Added the anchors, monads, drawingAttrs...

• Added the module @PictureLanguage@ from Wumpus-Core. It is located with the path prefix @Wumpus.Deprecated@. At some point it will be replaced...

• Basic.Graphic - rectangles and lines now take the supplied point to be the center rather than the bottom-left corner. Name changes - @circle@ changed to @disk@, @text@ changed to @textline@.

0.1.1 to 0.2.0:

• Added the module @Wumpus.Basic.Graphic@.

• SafeFonts changed to be size neutral. PostScript's @scalefont@ command (which wumpus-core uses in the generated output) should be able to scale to any integer size.

• New demo @ColourCharts.hs@.

0.1.0 to 0.1.1:

• Added missing LICENSE file to the Cabal file.

• Added this CHANGES file.