src/svgtiny_css.c: change lwc_string_destroy -> lwc_string_unref

In the node_is_lang() callback, we're interning "lang" and later
destroying it. But "lang" is already interned at that point (in
libcss), so we are destroying a copy that doesn't belong to us. It
should be unref'd instead. Valgrind detected the error. Thanks to
Michael Drake for the pointer.

src/svgtiny_css.c: initialize an attr_val pointer to NULL

We later compare it to NULL, and valgrind says that it's potentially
uninitialized at that point, so let's initialize it.

src/svgtiny_css.c: add prototype for svgtiny_resolve_url()

This fixes a warning with -Wmissing-prototypes.

src/svgtiny_css.c: add a missing break statement

Otherwise, we fall through to an assert(false) in the default
case. Thanks to Michael Drake for the suggestion.

src/svgtiny_css.c: fix lwc/dom string comparison in node_has_name()

The node_has_name() function was calling lwc_string_isequal() to test
the universal selector (a dom_string) against the given node name (an
lwc_string). Instead, it should be using dom_string_lwc_isequal(),
which is designed to do exactly that. Thanks to Michael Drake for the
suggestion.

src/svgtiny.c: drop unused fill_ and stroke_opacity_type variables

This eliminates two -Wunused-but-set-variable warnings. Thanks to
Michael Drake for the suggestion.

src/svgtiny.c: whitespace cleanup (spaces to tabs)

src/svgtiny_css.c: clean trailing newlines

test/css: add some visually-verified test cases for our new features

It's helpful to have some test cases for our CSS handling, but
unfortunately, it's not all that easy to write them. How should we
compare the actual output to the expected output?

For now we settle for a visual comparison. You can render the test
diagrams using the example program examples/svgtiny_display_x11, and
also open them in another SVG viewer. Do they look the same? Great.
The test cases should be simple enough that _subtle_ visual mismatches
are not possible.

Automating this is not an impossible problem: for example, we could
render the parsed diagram to a bitmap image using cairo and then
compare it to what we get using librsvg which is also cairo-based. But
that has downsides too (like the portability of librsvg) that we don't
want to address right now.

src/svgtiny.c: use case-sensitive comparisons for SVG element names

SVG is XML and its element names are therefore case-sensitive. We
switch to case-sensitive comparisons to avoid rendering elements
(e.g. <RECT />) that other SVG clients (e.g. Firefox) will not.

examples/.gitignore: ignore the compiled example program

examples/svgtiny_display_x11.c: update build instructions

First, tell people to run "make" instead of giving them the full "gcc"
command-line. Then elaborate on how one can modify the build process
to use a development copy of libsvgtiny.

examples/GNUmakefile: add a GNUmakefile for the example program

This should simplify building it a bit, both against the system copy
and against a development repo. We use the name GNUmakefile (as
opposed to Makefile) to avoid interacting with the netsurf build
system.

src/svgtiny.c: remove parent == NULL hack

Now that we're providing some (unused!) default user-agent properties,
this code path is apparently no longer reached. Never look a gift
horse in the mouth, is an insane saying. But everything works great
without the NULL check, so let's remove it.

src/svgtiny_css.c: add some default user-agent properties after all

We tried to avoid populating ua_default_for_property() with any
default properties, but it looks like some are "required." Without
them, the style-composition process gets crashy while trying to set
initial values. Thanks to the libcss example program for the idea.

src/svgtiny.c: implement composition of parent styles

src/svgtiny*.{c,h}: move the libcss unit context into the parser state

This will make it easier to use the same unit context for style
composition that we do for style computation.

src/svgtiny_internal.h: add parent style to the parser state

This will come in handy when we want to compose the current (child)
node's styles with its parent's styles.

src/svgtiny.c: use separate function for style application

We've been doing CSS in svgtiny_parse_paint_attributes(), because we
only support CSS paint attributes at the moment. But ultimately that
won't be right. Let's separate it out now into its own function,
svgtiny_parse_styles().

src/svgtiny.c: update the docstring for svgtiny_parse_svg()

The svgtiny_parse_svg() function not only parses <svg> and <g>
elements; it also parses <a> elements.

examples/svgtiny_display_x11.c: use opacity information

src/svgtiny.c: set shape opacities from the parser state

Record the "active" fill and stroke opacity from the parser state
in each shape that we create.

include/svgtiny.h: add fill_opacity and stroke_opacity to svgtiny_shape

We already have fields for the fill and stroke opacity in the parser
state, but we have no way to record those values in the shapes we're
creating as we parse. Here we make room to do that.

src/svgtiny.c: parse styles in svgtiny_parse_paint_attributes()

Now that the scaffolding is in place, we do the work to parse our two
supported CSS paint attributes, fill-opacity and stroke-opacity. This
amounts to,

  * Calling svgtiny_select_style(), which is just a wrapper around
    css_select_style()
  * Passing the result to css_computed_foo_opacity() to get the
    computed styles
  * Populating fill_opacity and stroke_opacity in the parser state
    if the corresponding styles exist

There's also a temporary hack to avoid crashing on the root node that
later goes away when we implement parent/child style composition.

test/decode_svg.c: handle svgtiny_LIBCSS_ERROR

This test program has a switch statement to handle errors, with one
case for each svgtiny_code. Now that svgtiny_LIBCSS_ERROR belongs to
that enum, we add it to the list of cases.

examples/svgtiny_display_x11.c: handle svgtiny_LIBCSS_ERROR

This example program has a switch statement to handle errors, with one
case for each svgtiny_code. Now that svgtiny_LIBCSS_ERROR belongs to
that enum, we add it to the list of cases.

src/svgtiny.c: eliminate pointless NULL check

We initialize the entire struct to zero a few lines earlier.

src/svgtiny_internal.h: add fill/stroke_opacity to the parse state struct

src/svgtiny_internal.h: add svgtiny_select_style() to the header

We'll need a prototype in order to use that function in svgtiny.c.

src/svgtiny_css.c: add svgtiny_select_style() wrapper

Some boilerplate will be needed when we call css_select_style() during
parsing. In preparation for (avoiding) that, we factor it out into a
convenience function called svgtiny_select_style().

src/svgtiny_css.c: use our userdata handler in set_libcss_node_data()

This was a missing part of the implementation that had to wait until
our css_select_handler vtable was defined.

src/svgtiny_css.c: add user handler function

This function needs to be passed to dom_node_set_user_data() in
set_libcss_node_data(), but we couldn't implement it before our
css_select_handler was defined, because it passes the address of
that select handler to css_libcss_node_data_handler().

src/svgtiny_css.c: define a css_select_handler

We define a css_select_handler structure full of all of the select
handlers we've just implemented. This is the big piece of the puzzle
that we need before we can call css_select_style().

src/svgtiny_css.c: implement named_ancestor_node() select handler

src/svgtiny_css.c: implement node_presentational_hint() select handler

src/svgtiny_css.c: implement get_libcss_node_data() select handler

src/svgtiny_css.c: implement set_libcss_node_data() select handler

src/svgtiny_strings.h: intern a "userdata" key string

To implement libcss's select handler API, we need to implement two
functions that get/set "userdata" on a node. The corresponding libdom
API allows you to set arbitrary data in the form of key->value pairs;
so to identify THIS particular data, we need to use the same string
each time. For that reason we intern "_libcss_user_data" and call it
the "userdata_key".

src/svgtiny_css.c: implement node_is_visited() select handler

src/svgtiny_css.c: implement ua_default_for_property() select handler

src/svgtiny_css.c: implement node_is_lang() select handler

src/svgtiny_css.c: case-insensitivity for node_has_attribute_substring()

All of the CSS attribute selectors take a flag to make the comparison
case-insensitive. Libcss doesn't support that yet, but in the case of
node_has_attribute_substring(), factoring out the implementation and
letting it take an "insensitive" flag will be of use to us when we
implement the node_is_lang() select handler.

src/svgtiny_css.c: implement node_is_target() select handler

src/svgtiny_css.c: implement node_is_checked() select handler

src/svgtiny_css.c: implement node_is_disabled() select handler

src/svgtiny_css.c: implement node_is_enabled() select handler

src/svgtiny_css.c: implement node_is_focus() select handler

src/svgtiny_css.c: implement node_is_active() select handler

src/svgtiny_css.c: implement node_is_hover() select handler

src/svgtiny_css.c: implement node_is_link() select handler

src/svgtiny_css.c: implement node_is_empty() select handler

src/svgtiny_css.c: implement node_count_siblings() select handler

src/svgtiny_css.c: implement node_is_root() select handler

src/svgtiny_css.c: implement node_has_attribute_substring() select handler

src/svgtiny_css.c: implement node_has_attribute_suffix() select handler

src/svgtiny_css.c: implement node_has_attribute_prefix() select handler

src/svgtiny_css.c: implement node_has_attribute_includes() select handler

src/svgtiny_css.c: implement node_has_attribute_dashmatch() select handler

src/svgtiny_css.c: implement node_has_attribute_equal() select handler

src/svgtiny_css.c: implement node_has_attribute() select handler

src/svgtiny_css.c: implement node_has_id() select handler

src/svgtiny_css.c: implement node_has_class() select handler

src/svgtiny_css.c: implement node_has_name() select handler

src/svgtiny_strings.h: intern the universal selector string "*"

This is a prerequisite for implementing the node_has_name() select
handler.

src/svgtiny_css.c: implement sibling_node() select handler

src/svgtiny_css.c: implement parent_node() select handler

src/svgtiny_css.c: implement named_generic_sibling_node() select handler

src/svgtiny_css.c: implement named_sibling_node() select handler

src/svgtiny_css.c: implement named_parent_node() select handler

src/svgtiny_css.c: implement node_id() select handler

src/svgtiny_strings.h: intern "id" for libcss

As a prerequisite for implementing a libcss node_id() select handler,
we intern the string "id" that it will need access to.

src/svgtiny_css.c: implement node_classes() select handler

src/svgtiny_css.c: implement node_name() select handler

src/svgtiny{.c,_internal.h}: intern SVG's XML namespace URI

Intern the string "http://www.w3.org/2000/svg" in the parser state for
later use in libcss's node_name() select handler.

src/svgtiny.c: parse inline stylesheet in svgtiny_parse_paint_attributes()

...and do nothing with it, for the moment. We are able to parse the
inline style="..." attributes right now but more scaffolding is needed
before we can utilize css_select_style().

src/svgtiny.c: add svgtiny_parse_style_inline() function

This function parses the contents of an inline style="..." attribute
into a libcss stylesheet, or NULL if anything went wrong.

src/svgtiny_internal.h: drop svgtiny_resolve_url() prototype

This is no longer needed now that svgtiny_resolve_url() lives in the
same file as its sole consumer, svgtiny_create_stylesheet().

src/svgtiny.c: use svgtiny_create_stylesheet() to parse <style>

The new function handles all of the boilerplate parameter creation
that was originally done in svgtiny_parse_style_element().

src/svgtiny_internal.h: add svgtiny_create_stylesheet() prototype

Needed to let src/svgtiny.c know about the new function.

src/svgtiny_css.c: new function svgtiny_create_stylesheet()

We add a function to handle the creation of a new stylesheet with the
default set of parameters. This is in preparation for parsing the
inline styles, which a priori would involve copy/pasting a lot of

  params.foo = bar;

lines from svgtiny_parse_style_element(). The goal is to factor the
common bits out of both the <style> and style= implementations.

src/svgtiny.c: add svgtiny_parse_style_element() function and use it

The new function parses the contents of a <style> element. We add a
call to it in svgtiny_preparse_styles() where previously a placeholder
was left.

src/Makefile: add the new svgtiny_css.c to the list of sources

src/svgtiny_internal.h: add svgtiny_resolve_url() prototype

src/svgtiny_css.c: new file with new svgtiny_resolve_url() function

Define a stub relative-URL resolver that assumes all URLs are absolute
and returns them unmodified. Some method of doing this is required by
libcss. At the moment, libcss does not support any SVG properties that
take url() values, so not much is lost.

src/svgtiny.c: add impotent svgtiny_preparse_styles() function

We declare and add the svgtiny_preparse_styles() function that will be
used to make a first pass through the SVG document and parse all of
the <style> elements. At the moment it is only half implemented:
once we find a <style> element, we do nothing with it. A separate
function will be used to parse a <style> once we have it.

src/svgtiny.c: initialize the libcss context in svgtiny_parse()

Before we begin parsing, we have to initialize our new css_select_ctx
by calling css_select_ctx_create(). Later, when parsing is complete,
we css_select_ctx_destroy() it.

README: document the new svgtiny_LIBCSS_ERROR code

include/svgtiny.h: add new error constant svgtiny_LIBCSS_ERROR

Analogous to svgtiny_LIBDOM_ERROR, we add svgtiny_LIBCSS_ERROR to
indicate an error related to CSS.

src/svgtiny_strings.h: add "media" to the list of strings

The "media" attribute is arguably the only meaningful attribute a
<style> element has within an SVG document. Here we intern the string
"media" in preparation for parsing <style>. Libcss can at least store
the media information even if we decide not to use it.

src/svgtiny_internal.h: add CSS context to parser state

Add a css_select_ctx pointer to the svgtiny_parse_state that is
threaded through each phase of SVG parsing. This will allow us to
populate the context with any <style> sheets we find; later, we can
consult those stylesheets while constructing our svgtiny_diagram (the
abstract representation into which we parse an SVG).

README: mention that libcss is required

Makefile: build against libcss

The first step towards adding libcss support is to build against
libcss. For now that means getting its "cflags" and "libs" from
pkg-config and putting them into CFLAGS and LDFLAGS.

src/svgtiny.c: remove old misleading libcss comments

There were a few comments in this file suggesting some future libcss
integration. However, now that we are beginning that integration (much
later), it is probably best to start with a clean slate. So, we remove
those comments.

src/svgtiny_internal.h: removed commented libcss stub

This files once thought about declaring,

  /*struct css_style style;*/

as a member of the svgtiny_parse_state struct. We delete that comment
now so that we can begin libcss integration with a clean slate.

examples/svgtiny_display_x11.c: include the system copy of svgtiny.h

The header of this file includes instructions for how to build it:

  Compile using:
    gcc -g -W -Wall -o svgtiny_display_x11 svgtiny_display_x11.c \
            `pkg-config --cflags --libs libsvgtiny cairo` -lX11

That pkg-config command will generate the flags to link against the
installed copy of libsvgtiny. The line,

  #include "svgtiny.h"

on the other hand, attempts to use a local header. This commit changes
that line to,

  #include <svgtiny.h>

which will use the corresponding system header from whatever include
directory pkg-config hands us for libsvgtiny.

examples/svgtiny_display_x11.c: add missing stdlib.h include

This file uses malloc(), free(), and exit() -- all of which are
defined in stdlib.h. GCC seems unhappy about the situation, so we now
include it. This allows the file to be compiled once again.

examples/svgtiny_display_x11.c: update LIBXML -> LIBDOM

The svgtiny_LIBXML_ERROR constant was changed to throughout the
codebase to svgtiny_LIBDOM_ERROR a long time ago, in 9275ab308, but
this example was missed, probably because it isn't built by default.

README: update LIBXML -> LIBDOM

This constant svgtiny_LIBXML_ERROR was changed throughout the codebase
to svgtiny_LIBDOM_ERROR a long time ago, in 9275ab308, but the README
was missed because nobody reads the documentation :)

implement svg path arc correctly

Update component version for release